CODEC-POINTER — указывающе-объявляющий Reference, указывающий на одну версию документа кодека, опубликованного Issuer. У документа кодека нет ID документа, и на себя и свою версию он указывает через 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)
Описание в индексеОдна версия кодека Issuer. Issuer + Codec ID 2 WORD + ID версии 2 WORD, ID цели нет
Сторона 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
ID версии         2 WORD

Интерпретация и действительность

  • Ширина Issuer — остаток Payload после вычитания Codec ID и ID версии (4 WORD). Payload равен одному из 6, 8, 20 WORD, любая другая длина invalid. Если значение Issuer помещается в более узкую ширину, это invalid (каноническая форма Issuer).
  • Если Issuer занимает 16 WORD, всего получается 21 WORD, поэтому добавляется 1 WORD расширения Length.
  • Codec ID — 32 бита. Codec ID прямого кода GEUL — это его TAG WORD (L=0), записанный в 32 битах (TRIPLE 0x0AAL → 0x00000AA0). Codec ID кодека Issuer — это номер Codec в записи, и Issuer назначает его так, чтобы он не повторялся внутри его codecs/, независимо от Kind (адреса публикации и список версий).
  • ID версии 0 — последняя версия. Остальные значения фиксируются на этой версии.
  • Это одна ячейка Codec 0x042L. Квантификации нет (Identified). Раздел 2, поэтому как квантификацию или систему его не читают.
  • Где используется: Meta DOC-ID документа кодека, PUBLICATION, DEPRECATION и TOMBSTONE в списке версий кодека, IMPORT-DOC, подключающий документ кодека. На этих местах он заменяет DOC-POINTER.
  • Адрес публикации — /.well-known/geul/<Issuer>/codecs/<Codec ID>/<ID версии>.geul (адреса публикации и список версий).

Пример

Кодек TRIPLE (Codec ID 0x00000AA0) Issuer GEUL 0x00000000.

ВерсияWORD sequence
10426 0000 0000 0000 0AA0 0000 0001
последняя (0)0426 0000 0000 0000 0AA0 0000 0000
  • TAG 1 + Issuer 2 + Codec ID 2 + ID версии 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"