EXTERNAL-ISSUER הוא Reference מכוון-מצהיר המצטט LOCAL ID של מסמך שפרסם Issuer, ברשומה אחת וללא IMPORT.

פריטערך
שםEXTERNAL-ISSUER-2WORD (קבוצת 5Q. שמות הקודים בטבלת החברים להלן)
TAG ID0x02FL~0x033L
קטע1 0001 (Reference EXTERNAL), היסט C בתוך הקטע = 15~19
KindReference · סיווג: מכוון-מצהיר
צד Hugoreference/external-issuer.md (הדף שם עוסק גם ב-EXTERNAL-ISSUER-4WORD ו-EXTERNAL-ISSUER-16WORD)

חברים

דף זה עוסק בערכת 5Q שלמה, חמישה קודים יחד. הכימות הוא ההיסט בתוך הקטע C % 5 (Reference). לכל קוד יש מסמך Codec אחד. השדות בחמשת מסמכי ה-Codec זהים, ורק יעד ה-DECLARE והשם (BIND) שונים.

TAG IDשםכימותCodec IDמסמך מפרטTAG 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

שדות (מסמך מפרט)

סדר ה-FIELD במסמך הוא סדר שדות ה-Payload (מסמך מפרט של Codec).

סדרשדה (BIND)FIELDרוחבפורמט מתקבל (CODEC)ENUM
1issuer#2ערך גולמי 2 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/0x000002F0/latest.geul כשקוראים אותו ב-geul show (ספרות הקסדצימליות באותיות גדולות).

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"

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