CODEC-POINTER ist ein zeigend-deklarierendes Reference, das eine Version eines vom Issuer veröffentlichten Codec-Dokuments bezeichnet. Ein Codec-Dokument hat keine Dokument-ID und bezeichnet sich selbst und seine Version mit CODEC-POINTER.

EintragWert
NameCODEC-POINTER (Spezifikationsdokument BIND CODEC-POINTER)
TAG ID0x042L
Codec ID0x00000420
Spezifikationsdokument0x00000000/codecs/0x00000420/ (DECLARE-Ziel 0420)
Abschnitt2 0010 (Reference Sonstige), Offset im Abschnitt C = 2
KindReference · Klasse: Zeigen-und-Deklarieren
TAG WORD0000 0100 0010 LLLL (000K KKKC CCCC LLLL)
IndexbeschreibungEine Version eines Issuer-Codecs. Issuer + Codec ID 2 WORD + Versions-ID 2 WORD, keine Ziel-ID
Hugo-Seitereference/codec-pointer.md

Felder (Spezifikationsdokument)

Die Reihenfolge der FIELD im Dokument ist die Reihenfolge der Payload-Felder (Codec-Spezifikationsdokument).

ReihenfolgeFeld (BIND)FIELDBreiteAkzeptiertes Format (CODEC)ENUM
1issuer#2restlicher Rohwert (0xFFFF)
2codec#3Rohwert 2 WORD
3version#4Rohwert 2 WORD

Layout

TAG WORD          0000 0100 0010 LLLL      Codec 0x042L
[Length-Erweiterungs-TAG]
Issuer            2/4/16 WORD
Codec ID          2 WORD
Versions-ID       2 WORD

Interpretation und Gültigkeit

  • Die Breite des Issuer ist der Rest des Payloads nach Abzug der 4 WORD für Codec ID und Versions-ID. Der Payload hat 6, 8 oder 20 WORD; jede andere Länge ist invalid. Passt der Issuer-Wert in eine schmalere Breite, ist es invalid (Issuer-Normalform).
  • Bei einem Issuer von 16 WORD sind es insgesamt 21 WORD, daher kommt 1 WORD Length-Erweiterung hinzu.
  • Die Codec ID hat 32 Bit. Die Codec ID eines GEUL-Direktcodes ist dessen TAG WORD (L=0) als 32-Bit-Wert geschrieben (TRIPLE 0x0AAL → 0x00000AA0). Die Codec ID eines Issuer-Codecs ist die Codec-Nummer des Records, die der Issuer unabhängig vom Kind so in seinem codecs/ festlegt, dass sie sich nicht überschneidet (Veröffentlichungsadresse und Versionsliste).
  • Die Versions-ID 0 ist die neueste Version. Alle anderen Werte sind fest an die jeweilige Version gebunden.
  • Es ist ein einziger Codec-Platz 0x042L. Es gibt keine Quantifizierung (Identified). Da es Abschnitt 2 ist, wird es nicht als Quantifizierung oder System gelesen.
  • Verwendet wird es im Meta DOC-ID eines Codec-Dokuments, in PUBLICATION, DEPRECATION und TOMBSTONE der Codec-Versionsliste und in IMPORT-DOC, das ein Codec-Dokument importiert. An diesen Stellen ersetzt es DOC-POINTER.
  • Die Veröffentlichungsadresse ist /.well-known/geul/<Issuer>/codecs/<Codec ID>/<Versions-ID>.geul (Veröffentlichungsadresse und Versionsliste).

Beispiel

TRIPLE-Codec (Codec ID 0x00000AA0) des GEUL-Issuer 0x00000000.

VersionWORD sequence
10426 0000 0000 0000 0AA0 0000 0001
neueste (0)0426 0000 0000 0000 0AA0 0000 0000
  • TAG 1 + Issuer 2 + Codec ID 2 + Versions-ID 2 = 7 WORD, LLLL=0110. Das TAG ist 0000 0100 0010 0110 = 0426.

Verwandte Seiten

Originaltext des Spezifikationsdokuments

So sieht das Spezifikationsdokument 0x00000000/codecs/0x00000420/latest.geul aus, gelesen mit geul show (Hexadezimalwerte in Großbuchstaben).

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"