EintragWert
NameDOC-POINTER (Spezifikationsdokument BIND DOC-POINTER)
TAG ID0x041L
Codec ID0x00000410
Spezifikationsdokument0x00000000/codecs/0x00000410/ (DECLARE-Ziel 0410)
Abschnitt2 0010 (Reference Sonstige), Offset im Abschnitt C = 1
KindReference · Klasse: Zeigen-und-Deklarieren
TAG WORD0000 0100 0001 LLLL (000K KKKC CCCC LLLL)
Hugo-Seitereference/doc-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)
2doc#3Rohwert 4 WORD
3version#4Rohwert 2 WORD

DOC-POINTER ist ein zeigend-deklarierendes Reference, das eine Version eines vom Issuer veröffentlichten Dokuments bezeichnet. Es wird zum Ziel von Veröffentlichung, Deprecate und Löschung eines Dokuments, von zitierten Ausgaben und von Aussagen über das Dokument.

Layout

TAG WORD          0000 0100 0001 LLLL      Codec 0x041L
[Length-Erweiterungs-TAG]
Issuer            2/4/16 WORD
Dokument-ID       4 WORD
Versions-ID       2 WORD

Interpretation und Gültigkeit

  • Die Breite des Issuer ist der Rest des Payloads nach Abzug der 6 WORD für Dokument-ID und Versions-ID. Der Codec teilt die Breite nicht auf. Ist die Breite nicht 2, 4 oder 16 WORD oder passt der Issuer-Wert in eine schmalere Breite, ist es invalid (Issuer-Normalform).
  • Die Versions-ID wird nicht ausgelassen. Erlaubte man das Auslassen, ließe sich die Breite des Issuer nicht allein aus der Payload-Länge bestimmen (Issuer 4 WORD ohne Version und Issuer 2 WORD mit Version wären beide 8 WORD).
  • Die Versions-ID 0 ist die neueste Version. Sie ist an die zum Zeitpunkt der Interpretation aktuelle Version gebunden. Alle anderen Werte sind an diese Version fest gebunden (PUBLICATION).
  • Die Dokument-ID 0 ist das Indexdokument für die Begriffsdefinitionen des Issuer. Auf den Issuer selbst verweist man mit ISSUER-POINTER.
  • Jeder Issuer reserviert die Dokument-IDs 0x0000000000000000 und 0xFFFFFFFFFFFFFFFF (Issuer und Veröffentlichung). 0xFFFFFFFFFFFFFFFF wird für die Issuer-Liste issuers/ des Issuer 0x00000000 verwendet, andere Issuer verwenden es nicht. PUBLICATION, DEPRECATION und TOMBSTONE in issuers/versions.geul bezeichnen mit diesem Wert die Version der Liste (Veröffentlichungsadresse und Versionsliste).
  • Es ist ein einziger Codec-Platz 0x041L. Es gibt keine Quantifizierung (Identified).
  • Die Form, die ein Dokument eines Issuer bezeichnet, ist allein DOC-POINTER. Ein Dokument mit EXTERNAL-ISSUER-* (Issuer, Dokument-ID, Ziel-ID 0) oder EXTERNAL-POINTER-* (IMPORT ID, Ziel-ID 0) zu bezeichnen, ist invalid.
  • Verwendet wird es bei den Meta DOC-ID und IMPORT-DOC sowie bei PUBLICATION, DEPRECATION und TOMBSTONE der Versionsliste.
  • Codec-Dokumente haben keine Dokument-ID. Ein Codec-Dokument und seine Version werden mit CODEC-POINTER bezeichnet.

Beispiel

Dokument 0xFFFF000000000001 des GEUL-Issuer 0x00000000.

VersionWORD sequence
10418 0000 0000 FFFF 0000 0000 0001 0000 0001
neueste (0)0418 0000 0000 FFFF 0000 0000 0001 0000 0000
  • TAG 1 + Issuer 2 + Dokument-ID 4 + Versions-ID 2 = 9 WORD, LLLL=1000. Das TAG ist 0000 0100 0001 1000 = 0418.

Verwandte Seiten

Originaltext des Spezifikationsdokuments

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

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000041000000000
BODY
#1 DECLARE 0x0410
#2 FIELD #1 rest
#3 FIELD #1 0x0004
#4 FIELD #1 0x0002
#5 BIND #1 "DOC-POINTER"
#6 BIND #2 "issuer"
#7 BIND #3 "doc"
#8 BIND #4 "version"