| פריט | ערך |
|---|---|
| שם | DELTA-BASE (BIND של מסמך מפרט: DELTA-BASE) |
| TAG ID | 0x1DBL |
| Codec ID | 0x00001DB0 |
| מסמך מפרט | 0x00000000/codecs/0x00001DB0/ (יעד DECLARE: 1DB0) |
| קטע | 14 1110 (Meta), היסט C בתוך הקטע = 27 |
| Kind | Meta · מחלקה: שושלת |
| TAG WORD | 0001 1101 1011 LLLL (000K KKKC CCCC LLLL) |
| תיאור באינדקס | קובץ הגרסה הזה הוא diff ביחס לגרסת בסיס של אותו מסמך (מזהה גרסה של 2 WORD) (git packfile delta) |
| בצד Hugo | meta/lineage/delta-base.md |
שדות (מסמך מפרט)
סדר ה-FIELD בתוך המסמך הוא סדר שדות ה-Payload (מסמך מפרט של Codec).
| סדר | שדה (BIND) | FIELD | רוחב | פורמט מקבל (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | version | #2 | ערך גולמי, 2 WORD | 0620 UNSIGNED-INTEGER |
זהו סימן לכך שקובץ הגרסה הזה אינו תצלום מצב (snapshot) אלא diff ביחס לגרסת בסיס של אותו מסמך (delta של git packfile). הגרסה עצמה עדיין מוגדרת כ-snapshot. hash התוכן, רשימת הגרסאות והחתימות כולם מתייחסים ל-snapshot ששוחזר בהחלת ה-diff (אחסון diff).
פריסה
TAG WORD 0001 1101 1011 LLLL Codec 0x1DBL
מזהה גרסה unsigned של 2 WORD (גרסת הבסיס של אותו מסמך)
- Codec: Meta
0x1DBL, מחלקת שושלת - Payload: מזהה גרסה של 2 WORD (ערך גולמי)
- מספר: לכל היותר אחד
פירוש ותוקף
- משתמשים רק במסמך שיש בו DOC-ID. רשימת הגרסאות
versions.geul, שאין בהDOC-ID, מסמכי רשימה (גרסאות שלissuers/) ומסמכים בלי שם אינם מכילים diff. - גרסת הבסיס היא גרסה שפורסמה של אותו
DOC-IDוהיא קודמת לגרסה הזו.0(בלי גרסה) הוא invalid. - hash התוכן של ה-snapshot ששוחזר חייב להיות שווה ל-hash של הגרסה הזו ברשימת הגרסאות (PUBLICATION). אם לא, ה-diff הזה הוא invalid. לכן אין רושמים בתוך ה-diff hash תוצאה נפרד.
- רק מסמך שכל הרשומות ב-BODY שלו הן Edge (רשומות שיש להן Edge Id) יכול להיות diff. הסיבה: יחידת ה-diff היא LOCAL ID (Edge Id).
- כללי שחזור ה-snapshot הם לפי אחסון diff. המחיקה היא תפקידו של DELTA-REMOVE.
- אין סימן נפרד להוספה או לתיקון. אם ה-Edge Id ב-BODY של ה-diff קיים בבסיס, זה תיקון; אם לא, זו הוספה. הוספה מקבלת מספר החל מ-NEXT-LOCAL-ID ברשימת הגרסאות. שימוש חוזר ב-LOCAL ID שנמחק הוא invalid (תיקון).
דוגמה
diff ביחס לגרסת בסיס 3:
1DB2 0000 0003
- TAG
1DB2(Meta0x1DBL,LLLL=0010, 3 WORD), מזהה גרסה0000 0003.
בעיות פתוחות
- מרווח ה-snapshot: כל כמה גרסאות לשים snapshot מלא (אורך שרשרת ה-diff מול עלות השחזור).
- האם להגביל את גרסת הבסיס לגרסה הקודמת.
- מקום האחסון של קובץ ה-diff: האם לשים אותו במקום קובץ הגרסה (
<מזהה גרסה>.geul), ומה הקשר שלו לכתובת hash התוכן<Issuer>/hashes/(hashes/נמצא לפי hash התוכן של ה-snapshot).
הנוסח המקורי של מסמך המפרט
כך נראה מסמך המפרט 0x00000000/codecs/0x00001DB0/latest.geul כשקוראים אותו ב-geul show (ספרות הקסדצימליות באותיות גדולות).
SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001DB000000000
BODY
#1 DECLARE 0x1DB0
#2 FIELD #1 0x0002
#3 BIND #1 "DELTA-BASE"
#4 BIND #2 "version"
#5 CODEC #2 0x0620