| Eintrag | Wert |
|---|---|
| Name | DOC-ID (Spezifikationsdokument BIND DOC-ID) |
| TAG ID | 0x1C7L |
| Codec ID | 0x00001C70 |
| Spezifikationsdokument | 0x00000000/codecs/0x00001C70/ (DECLARE-Ziel 1C70) |
| Abschnitt | 14 1110 (Meta), Offset im Abschnitt C = 7 |
| Kind | Meta · Klasse: Definition |
| TAG WORD | 0001 1100 0111 LLLL (000K KKKC CCCC LLLL) |
| Beschreibung im Index | Kennung dieses Dokuments. Eingebettete Reference DOC-POINTER (Issuer, Dokument-ID, Version 0). Bei einem Codec-Dokument CODEC-POINTER (Issuer, Codec-ID, Version 0) |
| Hugo-Seite | meta/declaration/doc-id.md |
Felder (Spezifikationsdokument)
Die Reihenfolge der FIELD im Dokument ist die Reihenfolge der Payload-Felder (Codec-Spezifikationsdokument).
| Reihenfolge | Feld (BIND) | FIELD | Breite | Akzeptiertes Format (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | doc | #2 | Record | 0410 DOC-POINTER, 0420 CODEC-POINTER |
Deklariert die Kennung dieses Dokuments. Sie ist nötig, damit andere Dokumente dieses Dokument und die Objekte darin referenzieren können.
Layout
TAG WORD 0001 1100 0111 LLLL Codec 0x1C7L
[Length-Erweiterungs-TAG]
Dokument DOC-POINTER-Reference-Record. (Issuer, Dokument-ID, Version 0). Bei einem Codec-Dokument CODEC-POINTER
- Codec: Meta
0x1C7L, Definitionsklasse - Payload: genau eine eingebettete Reference DOC-POINTER (Issuer, Dokument-ID, Version 0)
- Anzahl: höchstens eines. Für Versionsdokumente unter
docs/<Dokument-ID>/·codecs/<Codec-ID>/ist er Pflicht
Interpretation und Gültigkeit
- Der Payload ist genau ein Reference-Record
DOC-POINTER(Issuer, Dokument-ID, Version0). Als Versions-ID wird nur0verwendet. Die Version vergibt nicht das Dokument, sondern die Versionsliste. Ein Codec-Dokument verwendetCODEC-POINTER(Issuer, Codec-ID, Version0) (CODEC-POINTER). - Deshalb ist die Schreibweise, die „dieses Dokument“ bezeichnet, in DOC-ID, im PUBLICATION-Record der Versionsliste und in Zitaten anderer Dokumente dieselbe.
- Dasselbe Dokument hat unabhängig von der Version dieselbe
DOC-ID. Versions-ID und Inhaltshash werden nicht im Dokument vermerkt (Version). - Es gibt keine Dokumentnamen-Adresse (Veröffentlichungsadressen und Versionsliste). Den für Menschen lesbaren Titel übernimmt die Aussage LABEL.
- Fehlt er, ist das Dokument namenlos und nur über den Inhaltshash adressierbar. Er ist nötig, damit andere Dokumente ein LOCAL dieses Dokuments über eine zeigende Reference referenzieren können.
- Wer ein Dokument holt, prüft, ob die
DOC-IDdes erhaltenen Dokuments mit dem angeforderten Issuer und der Dokument-ID übereinstimmt. - Die Dokument-ID
0x0000000000000000ist das Index-Dokument der Begriffsdefinitionen eines Issuers (Issuer). Auch dieses Dokument ist ein Versionsdokument unterdocs/<Dokument-ID>/und erhält daher eine DOC-ID (DOC-POINTER(Issuer,0,0)). Der Issuer selbst wird durch ISSUER-POINTER vertreten. - Für die Versionsdokumente
<Versions-ID>.geul(einschließlich Spezifikationsdokumenten) unter<Issuer>/docs/<Dokument-ID>/und<Issuer>/codecs/<Codec-ID>/in.well-known/geul/istDOC-IDPflicht. - Listendokumente sind die Ausnahme und haben keine
DOC-ID: die Versionslisteversions.geul(PUBLICATION) und die Version<Versions-ID>.geulder Issuer-Listeissuers/(Veröffentlichungsadressen und Versionsliste). Wessen Liste es ist, sagt der DOC-POINTER im Record. Die Version eines Listendokuments referenziert die PUBLICATION in dessenversions.geulmit einem DOC-POINTER (0x00000000, reservierte Dokument-ID, Versions-ID). Die Inhaltshash-Adresse<Issuer>/hashes/ist eine Kopie der obigen Dokumente und folgt dem Original. - Die Dokument-ID
0xFFFFFFFFFFFFFFFFist bei allen Issuern reserviert (ebenso0x0000000000000000) und wird für die Issuer-Liste des Issuers0x00000000verwendet. Andere Issuer verwenden sie nicht. Da Listendokumente keineDOC-IDhaben, erscheint dieser Wert nur im DOC-POINTER der Records vonissuers/versions.geul. - Das Codec-Spezifikationsdokument ist ein Codec-Dokument des GEUL-Issuers
0x00000000. Es hat keine Dokument-ID und legt alsDOC-IDeinen CODEC-POINTER (0x00000000, Codec-ID,0) ab. Die Codec-ID ist das TAG WORD aus Kind und Codec in 32 Bit geschrieben (0x0B80→0x00000B80) (Spezifikationsdokument).
Beispiel
- Issuer
0x00000002, Dokument0x…0005:1C79 0418 0000 0002 0000 0000 0000 0005 0000 0000(Meta-TAG 1 + Reference-TAG 1 + Issuer 2 + Dokument-ID 4 + Version 2 = 10 WORD)
Wortlaut des Spezifikationsdokuments
So sieht das Spezifikationsdokument 0x00000000/codecs/0x00001C70/latest.geul aus, gelesen mit geul show (Hexadezimalwerte in Großbuchstaben).
SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001C7000000000
BODY
#1 DECLARE 0x1C70
#2 FIELD #1 record
#5 CODEC #2 0x0410
#3 BIND #1 "DOC-ID"
#4 BIND #2 "doc"
#6 CODEC #2 0x0420