CODEC-POINTER は、Issuer が公表した Codec ドキュメントの 1 つのバージョンを指す指示宣言 Reference だ。Codec ドキュメントにはドキュメント 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 Codec の 1 つのバージョン。Issuer + Codec ID 2 WORD + バージョン ID 2 WORD、対象 ID はない
Hugo 側reference/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
[Length 拡張 TAG]
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 になるため、Length 拡張 1 WORD が付く。
  • Codec ID は 32 ビットだ。GEUL 直接コードの Codec ID は、その TAG WORD(L=0)を 32 ビットで書いた値だ(TRIPLE 0x0AAL → 0x00000AA0)。Issuer Codec の Codec ID はレコードの Codec 番号で、Issuer が Kind と無関係に自分の codecs/ の中で重ならないように定める(公表アドレスとバージョン一覧)。
  • バージョン ID 0 は最新バージョンだ。それ以外の値はそのバージョンに固定される。
  • Codec 0x042L 1 つだけだ。量化はない(Identified)。セクション 2 なので、量化・体系としては読まない。
  • 使われる場所: Codec ドキュメントの Meta DOC-ID、Codec バージョン一覧の PUBLICATION・DEPRECATION・TOMBSTONE、Codec ドキュメントを取り込む IMPORT-DOC。これらの位置で DOC-POINTER の代わりをする。
  • 公表アドレスは /.well-known/geul/<Issuer>/codecs/<Codec ID>/<バージョン ID>.geul だ(公表アドレスとバージョン一覧)。

例

GEUL Issuer 0x00000000 の TRIPLE Codec(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 + バージョン ID 2 = 7 WORD、LLLL=0110 だ。TAG は 0000 0100 0010 0110 = 0426 だ。

関連ページ

規格ドキュメント原文

規格ドキュメント 0x00000000/codecs/0x00000420/latest.geul を geul show で読んだ様子だ(16進は大文字)。

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"