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). לכל קוד יש מסמך Codec אחד. השדות בחמשת מסמכי ה-Codec זהים, ורק יעד ה-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)
[Length TAG הרחבה]
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"

למעלה מסמך ה-Codec של EXTERNAL-ISSUER-16WORD-IDENTIFIED (0x039L). במסמכי ה-Codec של שאר החברים (EXTERNAL-ISSUER-16WORD-GENERIC, EXTERNAL-ISSUER-16WORD-FREE-CHOICE, EXTERNAL-ISSUER-16WORD-UNIVERSAL, EXTERNAL-ISSUER-16WORD-VARIABLE) שונים רק ה-Codec ID שב-DOC-ID, יעד ה-DECLARE והשם שנקשר ב-#1 (BIND).