EXTERNAL-ISSUER — указывающе-объявляющий Reference, цитирующий LOCAL ID документа, опубликованного Issuer, одной записью без IMPORT.

ПунктЗначение
ИмяEXTERNAL-ISSUER-16WORD (группа 5Q; имена по кодам — в таблице членов ниже)
TAG ID0x039L~0x03DL
Раздел1 0001 (Reference EXTERNAL), смещение внутри раздела C = 25~29
KindReference · классификация: указание-объявление
Сторона Hugoreference/external-issuer.md (эта страница охватывает также EXTERNAL-ISSUER-2WORD и EXTERNAL-ISSUER-4WORD)

Члены

Эта страница охватывает один комплект системы 5Q — пять кодов. Квантификация определяется смещением внутри раздела C % 5 (Reference). Документ кодека — по одному на код. Поля у пяти документов кодека одинаковы, различаются только цель DECLARE и имя (BIND).

TAG IDИмяКвантификацияCodec IDДокумент спецификацииTAG WORD
0x039LEXTERNAL-ISSUER-16WORD-IDENTIFIEDIdentified0x000003900x00000000/codecs/0x00000390/0000 0011 1001 LLLL
0x03ALEXTERNAL-ISSUER-16WORD-GENERICGeneric0x000003A00x00000000/codecs/0x000003A0/0000 0011 1010 LLLL
0x03BLEXTERNAL-ISSUER-16WORD-FREE-CHOICEFree-choice0x000003B00x00000000/codecs/0x000003B0/0000 0011 1011 LLLL
0x03CLEXTERNAL-ISSUER-16WORD-UNIVERSALUniversal0x000003C00x00000000/codecs/0x000003C0/0000 0011 1100 LLLL
0x03DLEXTERNAL-ISSUER-16WORD-VARIABLEVariable0x000003D00x00000000/codecs/0x000003D0/0000 0011 1101 LLLL

Поля (документ спецификации)

Порядок FIELD в документе — это порядок полей Payload (документ спецификации Codec).

ПорядокПоле (BIND)FIELDШиринаПринимаемая форма (CODEC)ENUM
1issuer#2простое значение 16 WORD
2doc#3простое значение 4 WORD
3target-id#4остаток, простое значение (0xFFFF)

EXTERNAL-ISSUER — указывающе-объявляющий Reference, цитирующий LOCAL ID документа, опубликованного Issuer, без IMPORT. Смысл завершён одной записью, и он следует последней версии.

Раскладка

TAG WORD          0000 001C CCCC LLLL      Codec 0x02FL~0x03DL (раздел 1)
[расширяющий TAG Length]
Issuer            ширина, заданная Codec (2/4/16 WORD)
ID документа      4 WORD
ID цели           всё остальное. LOCAL ID этого документа, наименьшей ширины
Codec (Identified, Generic, Free-choice, Universal, Variable)ИмяШирина Issuer
0x02FL~0x033LEXTERNAL-ISSUER-2WORD2 WORD (регистрация в geul.org, подтверждение домена)
0x034L~0x038LEXTERNAL-ISSUER-4WORD4 WORD (регистрация в geul.org, без подтверждения)
0x039L~0x03DLEXTERNAL-ISSUER-16WORD16 WORD (вычисляется из открытого ключа)
  • Ширина определяется номером системы: если система − 9 (то есть C / 5 − 3 от смещения внутри раздела C) равна 0, 1, 2, то ширина 2, 4, 16 WORD. Квантификация — C % 5.
  • Issuer ID — целое значение. Равные значения — один и тот же Issuer. Issuer записывают наименьшей шириной, в которую помещается значение, и выбирают Codec этой ширины (4 WORD — только при 2^32 и выше, 16 WORD — только при 2^64 и выше). Запись более широкой формой — invalid (Issuer).
  • Регистрацию и управление Issuer ведёт geul.org.
  • Версию не записывают, следуют последней версии. Чтобы зафиксировать версию, используют IMPORT-DOC и EXTERNAL-POINTER.
  • Местоположение находят по правилу адресов публикации (адреса публикации и список версий).
  • Один и тот же LOCAL ID этого документа — одна и та же цель, независимо от того, записан ли он как LOCAL внутри документа, как EXTERNAL-ISSUER в другом документе (или как EXTERNAL-POINTER после IMPORT).
  • Указывает только на LOCAL документа. На сам документ указывают через DOC-POINTER, на сам Issuer — через ISSUER-POINTER. Поэтому ID цели не равен 0. Документ с ID 0 — индексный документ определений терминов Issuer.

Действительность

  • Если ширина Issuer не соответствует Codec или значение помещается в более узкую ширину, это invalid.
  • Если ID цели равен 0, это invalid. ID цели 0 (сам документ) обслуживает DOC-POINTER.
  • Ведущий WORD 0x0000 в ID цели запрещён.

Пример

ЦельWORD sequence
Issuer 0x00000002, документ 0x…0002, LOCAL 702F7 0000 0002 0000 0000 0000 0002 0007
Issuer 0x00012345, документ 0x…0002, LOCAL 702F7 0001 2345 0000 0000 0000 0002 0007

Связанные страницы

Исходный текст документа спецификации

Документ спецификации 0x00000000/codecs/0x00000390/latest.geul, прочитанный командой geul show (шестнадцатеричные значения в верхнем регистре).

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

Выше — документ кодека EXTERNAL-ISSUER-16WORD-IDENTIFIED (0x039L). У остальных членов (EXTERNAL-ISSUER-16WORD-GENERIC, EXTERNAL-ISSUER-16WORD-FREE-CHOICE, EXTERNAL-ISSUER-16WORD-UNIVERSAL, EXTERNAL-ISSUER-16WORD-VARIABLE) в документе кодека различаются только Codec ID в DOC-ID, цель DECLARE и имя, привязанное в #1 (BIND).