CODEC-POINTER هو Reference إشاري تصريحي يشير إلى إصدار واحد من مستند Codec نشره Issuer. مستند Codec لا معرّف مستند له، ويشير إلى نفسه وإلى إصداره بـCODEC-POINTER.

البندالقيمة
الاسمCODEC-POINTER (BIND CODEC-POINTER في مستند المواصفة)
TAG ID0x042L
Codec ID0x00000420
مستند المواصفة0x00000000/codecs/0x00000420/ (هدف DECLARE 0420)
القسم2 0010 (Reference أخرى)، الإزاحة داخل القسم C = 2
KindReference · التصنيف: إشاري تصريحي
TAG WORD0000 0100 0010 LLLL (000K KKKC CCCC LLLL)
وصف الفهرسإصدار واحد من Codec خاصة بـIssuer. Issuer + Codec ID بـ2 WORD + معرّف الإصدار بـ2 WORD، ولا معرّف هدف
جهة Hugoreference/codec-pointer.md

الحقول (مستند المواصفة)

ترتيب FIELD داخل المستند هو ترتيب حقول Payload (مستند Codec).

الترتيبالحقل (BIND)FIELDالعرضالصيغة المقبولة (CODEC)ENUM
1issuer#2قيمة خام متبقية (0xFFFF)
2codec#3قيمة خام 2 WORD
3version#4قيمة خام 2 WORD

التخطيط

TAG WORD          0000 0100 0010 LLLL      Codec 0x042L
[TAG الامتداد Length]
Issuer            2/4/16 WORD
Codec ID          2 WORD
معرّف الإصدار     2 WORD

التفسير والصلاحية

  • عرض Issuer هو ما يتبقى من Payload بعد طرح 4 WORD لـCodec ID ومعرّف الإصدار. يكون Payload واحدًا من 6 أو 8 أو 20 WORD، وأي طول آخر invalid. ويكون invalid إذا كانت قيمة Issuer تتسع في عرض أضيق (الصيغة المعيارية للـIssuer).
  • إذا كان Issuer 16 WORD فالإجمالي 21 WORD فيُضاف WORD واحد من امتداد Length.
  • Codec ID بطول 32 بتًا. وCodec ID لرمز GEUL المباشر هو TAG WORD ذلك الرمز (L=0) مكتوبًا في 32 بتًا (TRIPLE 0x0AAL → 0x00000AA0). أما Codec ID لـCodec خاصة بـIssuer فهو رقم Codec في السجل، ويحدده الـIssuer دون تداخل داخل codecs/ الخاص به بصرف النظر عن Kind (عنوان النشر وقائمة الإصدارات).
  • معرّف الإصدار 0 هو الإصدار الأحدث. وسائر القيم تثبّت على ذلك الإصدار.
  • هو خانة واحدة في Codec 0x042L. لا يوجد تكميم (Identified). ولأنه في القسم 2 فلا يُقرأ على أنه تكميم أو منظومة.
  • مواضع الاستخدام: DOC-ID من Meta في مستند Codec، وPUBLICATION وDEPRECATION وTOMBSTONE في قائمة إصدارات Codec، وIMPORT-DOC الذي يستورد مستند Codec. يحل في هذه المواضع محل DOC-POINTER.
  • عنوان النشر هو /.well-known/geul/<Issuer>/codecs/<Codec ID>/<معرّف الإصدار>.geul (عنوان النشر وقائمة الإصدارات).

مثال

Codec TRIPLE للـIssuer GEUL 0x00000000 (Codec ID 0x00000AA0).

الإصدارWORD sequence
10426 0000 0000 0000 0AA0 0000 0001
الأحدث (0)0426 0000 0000 0000 0AA0 0000 0000
  • TAG 1 + Issuer 2 + Codec ID 2 + معرّف الإصدار 2 = 7 WORD، وLLLL=0110. وTAG هو 0000 0100 0010 0110 = 0426.

صفحات ذات صلة

نص مستند المواصفة

هذا مستند المواصفة 0x00000000/codecs/0x00000420/latest.geul مقروءًا بـgeul show (الأرقام السداسية عشرية بأحرف كبيرة).

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000042000000000
BODY
#1 DECLARE 0x0420
#2 FIELD #1 rest
#3 FIELD #1 0x0002
#4 FIELD #1 0x0002
#5 BIND #1 "CODEC-POINTER"
#6 BIND #2 "issuer"
#7 BIND #3 "codec"
#8 BIND #4 "version"