EXTERNAL-ISSUER ist ein zeigend-deklarierendes Reference, das eine LOCAL ID eines vom Issuer veröffentlichten Dokuments ohne IMPORT mit einem einzigen Record zitiert.

EintragWert
NameEXTERNAL-ISSUER-2WORD (5Q-Gruppe. Namen der einzelnen Codes in der Mitgliedertabelle unten)
TAG ID0x02FL~0x033L
Abschnitt1 0001 (Reference EXTERNAL), Offset im Abschnitt C = 15~19
KindReference · Klasse: Zeigen-und-Deklarieren
Hugo-Seitereference/external-issuer.md (diese Seite behandelt auch EXTERNAL-ISSUER-4WORD und EXTERNAL-ISSUER-16WORD)

Mitglieder

Diese Seite behandelt ein vollständiges 5Q-System, also fünf Codes zusammen. Die Quantifizierung ist der Offset im Abschnitt C % 5 (Reference). Es gibt ein Codec-Dokument pro Code. Die Felder der fünf Codec-Dokumente sind gleich, nur DECLARE-Ziel und Name (BIND) unterscheiden sich.

TAG IDNameQuantifizierungCodec IDSpezifikationsdokumentTAG WORD
0x02FLEXTERNAL-ISSUER-2WORD-IDENTIFIEDIdentified0x000002F00x00000000/codecs/0x000002F0/0000 0010 1111 LLLL
0x030LEXTERNAL-ISSUER-2WORD-GENERICGeneric0x000003000x00000000/codecs/0x00000300/0000 0011 0000 LLLL
0x031LEXTERNAL-ISSUER-2WORD-FREE-CHOICEFree-choice0x000003100x00000000/codecs/0x00000310/0000 0011 0001 LLLL
0x032LEXTERNAL-ISSUER-2WORD-UNIVERSALUniversal0x000003200x00000000/codecs/0x00000320/0000 0011 0010 LLLL
0x033LEXTERNAL-ISSUER-2WORD-VARIABLEVariable0x000003300x00000000/codecs/0x00000330/0000 0011 0011 LLLL

Felder (Spezifikationsdokument)

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

ReihenfolgeFeld (BIND)FIELDBreiteAkzeptiertes Format (CODEC)ENUM
1issuer#2Rohwert 2 WORD
2doc#3Rohwert 4 WORD
3target-id#4restlicher Rohwert (0xFFFF)

EXTERNAL-ISSUER ist ein zeigend-deklarierendes Reference, das eine LOCAL ID eines vom Issuer veröffentlichten Dokuments ohne IMPORT zitiert. Ein einziger Record ist in seiner Bedeutung vollständig, und es folgt der neuesten Version.

Layout

TAG WORD          0000 001C CCCC LLLL      Codec 0x02FL~0x03DL (Abschnitt 1)
[Length-Erweiterungs-TAG]
Issuer            vom Codec bestimmte Breite (2/4/16 WORD)
Dokument-ID       4 WORD
Ziel-ID           der gesamte Rest. LOCAL ID dieses Dokuments, kürzeste Breite
Codec (Identified, Generic, Free-choice, Universal, Variable)NameBreite des Issuer
0x02FL~0x033LEXTERNAL-ISSUER-2WORD2 WORD (bei geul.org registriert, Domainnachweis)
0x034L~0x038LEXTERNAL-ISSUER-4WORD4 WORD (bei geul.org registriert, ohne Nachweis)
0x039L~0x03DLEXTERNAL-ISSUER-16WORD16 WORD (aus dem öffentlichen Schlüssel berechnet)
  • Die Breite wird durch die Systemnummer bestimmt: Ist Systemnummer − 9 (C / 5 − 3 des Offsets im Abschnitt C) gleich 0, 1 oder 2, beträgt sie 2, 4 bzw. 16 WORD. Die Quantifizierung ist C % 5.
  • Die Issuer-ID ist ein ganzzahliger Wert. Gleicher Wert heißt gleicher Issuer. Der Issuer wird in der kürzesten Breite geschrieben, in die der Wert passt, und der Codec dieser Breite wird gewählt (4 WORD nur ab 2^32, 16 WORD nur ab 2^64). Eine breitere Schreibweise ist invalid (Issuer).
  • Registrierung und Verwaltung der Issuer übernimmt geul.org.
  • Eine Version wird nicht angegeben; es gilt die neueste Version. Um die Version festzulegen, verwendet man IMPORT-DOC und EXTERNAL-POINTER.
  • Der Ort wird über die Regeln der Veröffentlichungsadresse gefunden (Veröffentlichungsadresse und Versionsliste).
  • Ist es dieselbe LOCAL ID dieses Dokuments, bezeichnet sie dasselbe Objekt, ob sie in diesem Dokument als LOCAL, in einem anderen Dokument als EXTERNAL-ISSUER oder (nach IMPORT) als EXTERNAL-POINTER geschrieben wird.
  • Es verweist nur auf LOCAL eines Dokuments. Auf das Dokument selbst verweist man mit DOC-POINTER, auf den Issuer selbst mit ISSUER-POINTER. Daher ist die Ziel-ID nicht 0. Die Dokument-ID 0 ist das Indexdokument für die Begriffsdefinitionen des Issuers.

Gültigkeit

  • Passt die Breite des Issuer nicht zum Codec oder passt der Wert in eine schmalere Breite, ist es invalid.
  • Ist die Ziel-ID 0, ist es invalid. Die Ziel-ID 0 (das Dokument selbst) übernimmt DOC-POINTER.
  • Führende WORD 0x0000 in der Ziel-ID sind verboten.

Beispiel

ZielWORD sequence
Issuer 0x00000002, Dokument 0x…0002, LOCAL 702F7 0000 0002 0000 0000 0000 0002 0007
Issuer 0x00012345, Dokument 0x…0002, LOCAL 702F7 0001 2345 0000 0000 0000 0002 0007

Verwandte Seiten

Originaltext des Spezifikationsdokuments

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

SPEC-VERSION 0x0001
DOC-ID 0x042600000000000002F000000000
BODY
#1 DECLARE 0x02F0
#2 FIELD #1 0x0002
#3 FIELD #1 0x0004
#4 FIELD #1 rest
#5 BIND #1 "EXTERNAL-ISSUER-2WORD-IDENTIFIED"
#6 BIND #2 "issuer"
#7 BIND #3 "doc"
#8 BIND #4 "target-id"

Oben steht das Codec-Dokument von EXTERNAL-ISSUER-2WORD-IDENTIFIED (0x02FL). Die Codec-Dokumente der anderen Mitglieder (EXTERNAL-ISSUER-2WORD-GENERIC, EXTERNAL-ISSUER-2WORD-FREE-CHOICE, EXTERNAL-ISSUER-2WORD-UNIVERSAL, EXTERNAL-ISSUER-2WORD-VARIABLE) unterscheiden sich nur in der Codec ID der DOC-ID, im DECLARE-Ziel und im in #1 gebundenen Namen (BIND).