ItemValor
NomeDELTA-BASE (BIND DELTA-BASE do documento de especificação)
TAG ID0x1DBL
Codec ID0x00001DB0
Documento de especificação0x00000000/codecs/0x00001DB0/ (alvo do DECLARE 1DB0)
Seção14 1110 (Meta), deslocamento C = 27 na seção
KindMeta · classe: linhagem
TAG WORD0001 1101 1011 LLLL (000K KKKC CCCC LLLL)
Descrição do índiceEste arquivo de versão é um diff em relação a uma versão-base do mesmo documento (ID de versão de 2 WORDs) (git packfile delta)
Lado Hugometa/lineage/delta-base.md

Campos (documento de especificação)

A ordem dos FIELD no documento é a ordem dos campos do Payload (documento de especificação do Codec).

OrdemCampo (BIND)FIELDLarguraFormato de entrada (CODEC)ENUM
1version#2valor bruto 2 WORD0620 UNSIGNED-INTEGER

Marca de que este arquivo de versão não é um snapshot, e sim um diff em relação a uma versão-base do mesmo documento (delta do git packfile). A versão em si continua a ser definida como snapshot. O hash de conteúdo, a lista de versões e as assinaturas referem-se todos ao snapshot restaurado pela aplicação do diff (armazenamento por diff).

Layout

TAG WORD          0001 1101 1011 LLLL      Codec 0x1DBL
ID de versão      2 WORDs sem sinal (versão-base do mesmo documento)
  • Codec: Meta 0x1DBL, classe de linhagem
  • Payload: ID de versão de 2 WORDs (valor bruto)
  • Quantidade: no máximo um

Interpretação e validade

  • Só se usa em documentos que têm DOC-ID. A lista de versões versions.geul, os documentos de lista (versões de issuers/) e os documentos sem nome, que não têm DOC-ID, não usam diff.
  • A versão-base é uma versão publicada do mesmo DOC-ID e é anterior a esta versão. 0 (sem versão) é inválido.
  • O hash de conteúdo do snapshot restaurado deve ser igual ao hash desta versão na lista de versões (PUBLICATION). Se diferir, este diff é inválido. Por isso não se escreve à parte, dentro do diff, o hash do resultado.
  • Só pode ser mantido como diff um documento em que todos os registros do BODY sejam Edge (registros com Edge Id), pois a unidade do diff é o LOCAL ID (Edge Id).
  • As regras de restauração do snapshot seguem o armazenamento por diff. A exclusão cabe a DELTA-REMOVE.
  • Não há marca separada de adição ou revisão. Se o Edge Id do BODY do diff existe na base, é revisão; se não, é adição. As adições recebem numeração a partir de NEXT-LOCAL-ID da lista de versões. Reutilizar um LOCAL ID excluído é inválido (revisão).

Exemplo

Diff em relação à versão-base 3:

1DB2 0000 0003
  • TAG 1DB2 (Meta 0x1DBL, LLLL=0010, 3 WORDs), ID de versão 0000 0003.

Problemas em aberto

  1. Intervalo de snapshots: a cada quantas versões se mantém um snapshot completo (comprimento da cadeia de diffs e custo de restauração).
  2. Se a versão-base deve ser limitada à versão imediatamente anterior.
  3. Local de armazenamento do arquivo de diff: se no lugar do arquivo de versão (<ID de versão>.geul), e a relação com o endereço por hash de conteúdo <Issuer>/hashes/ (hashes/ é localizado pelo hash de conteúdo do snapshot).

Texto do documento de especificação

É o documento de especificação 0x00000000/codecs/0x00001DB0/latest.geul lido com geul show (hexadecimal em maiúsculas).

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