EintragWert
NameDELTA-BASE (Spezifikationsdokument BIND DELTA-BASE)
TAG ID0x1DBL
Codec ID0x00001DB0
Spezifikationsdokument0x00000000/codecs/0x00001DB0/ (DECLARE-Ziel 1DB0)
Abschnitt14 1110 (Meta), Offset im Abschnitt C = 27
KindMeta · Klasse: Abstammung
TAG WORD0001 1101 1011 LLLL (000K KKKC CCCC LLLL)
Beschreibung im IndexDiese Versionsdatei ist ein Diff gegen eine Basisversion (2-WORD-Versions-ID) desselben Dokuments (git packfile delta)
Hugo-Seitemeta/lineage/delta-base.md

Felder (Spezifikationsdokument)

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

ReihenfolgeFeld (BIND)FIELDBreiteAkzeptiertes Format (CODEC)ENUM
1version#2Rohwert 2 WORD0620 UNSIGNED-INTEGER

Marker dafür, dass diese Versionsdatei kein Snapshot, sondern ein Diff gegen eine Basisversion desselben Dokuments ist (Delta eines git packfile). Die Version selbst wird weiterhin als Snapshot definiert. Inhaltshash, Versionsliste und Signatur beziehen sich alle auf den Snapshot, der durch Anwenden des Diffs wiederhergestellt wird (Diff-Speicherung).

Layout

TAG WORD          0001 1101 1011 LLLL      Codec 0x1DBL
Versions-ID       2 WORD unsigned (Basisversion desselben Dokuments)
  • Codec: Meta 0x1DBL, Abstammungsklasse
  • Payload: 2-WORD-Versions-ID (Rohwert)
  • Anzahl: höchstens eines

Interpretation und Gültigkeit

  • Wird nur bei Dokumenten mit DOC-ID verwendet. Die Versionsliste versions.geul, Listendokumente (Versionen von issuers/) und namenlose Dokumente, die keine DOC-ID haben, bekommen keinen Diff.
  • Die Basisversion ist eine veröffentlichte Version derselben DOC-ID und liegt vor dieser Version. 0 (keine Version) ist invalid.
  • Der Inhaltshash des wiederhergestellten Snapshots muss mit dem Hash dieser Version in der Versionsliste (PUBLICATION) übereinstimmen. Andernfalls ist dieser Diff invalid. Deshalb wird der Ergebnishash nicht gesondert im Diff vermerkt.
  • Nur Dokumente, in denen alle Records des BODY Edges sind (Records mit Edge Id), können als Diff abgelegt werden. Denn die Diff-Einheit ist die LOCAL ID (Edge Id).
  • Die Regeln zur Wiederherstellung des Snapshots folgen Diff-Speicherung. Das Löschen übernimmt DELTA-REMOVE.
  • Marker für Hinzufügung oder Revision gibt es nicht. Ist die Edge Id im Diff-BODY in der Basis vorhanden, ist es eine Revision, andernfalls eine Hinzufügung. Hinzufügungen erhalten ihre Nummer ab NEXT-LOCAL-ID der Versionsliste. Die Wiederverwendung einer gelöschten LOCAL ID ist invalid (Revision).

Beispiel

Diff gegen Basisversion 3:

1DB2 0000 0003
  • TAG 1DB2 (Meta 0x1DBL, LLLL=0010, 3 WORD), Versions-ID 0000 0003.

Offene Probleme

  1. Snapshot-Abstand: nach wie vielen Versionen ein vollständiger Snapshot angelegt wird (Länge der Diff-Kette und Wiederherstellungskosten).
  2. Ob die Basisversion auf die unmittelbar vorangehende Version beschränkt wird.
  3. Speicherort der Diff-Datei: ob am Platz der Versionsdatei (<Versions-ID>.geul), und das Verhältnis zur Inhaltshash-Adresse <Issuer>/hashes/ (hashes/ wird über den Inhaltshash des Snapshots gefunden).

Wortlaut des Spezifikationsdokuments

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

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