ItemValor
NomeDOC-POINTER (BIND DOC-POINTER do documento de especificação)
TAG ID0x041L
Codec ID0x00000410
Documento de especificação0x00000000/codecs/0x00000410/ (alvo do DECLARE 0410)
Seção2 0010 (Reference diversas), deslocamento C na seção = 1
KindReference · classificação: indicação e declaração
TAG WORD0000 0100 0001 LLLL (000K KKKC CCCC LLLL)
Lado Hugoreference/doc-pointer.md

Campos (documento de especificação)

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

OrdemCampo (BIND)FIELDLarguraFormato aceito (CODEC)ENUM
1issuer#2valor bruto restante (0xFFFF)
2doc#3valor bruto de 4 WORD
3version#4valor bruto de 2 WORD

DOC-POINTER é a Reference de indicação e declaração que aponta uma versão de um documento publicado por um Issuer. Torna-se alvo da publicação, da depreciação (deprecate) e da exclusão de documentos, da edição citada e de enunciados sobre o documento.

Layout

TAG WORD          0000 0100 0001 LLLL      Codec 0x041L
[TAG estendida de Length]
Issuer            2/4/16 WORD
ID do documento   4 WORD
ID da versão      2 WORD

Interpretação e validade

  • A largura do Issuer é o que resta do Payload depois de subtrair 6 WORD do ID do documento e do ID da versão. O Codec não divide a largura. É invalid se a largura não for 2, 4 ou 16 WORD, ou se o valor do Issuer couber numa largura mais estreita (forma canônica do Issuer).
  • O ID da versão não se omite. Se a omissão fosse permitida, o comprimento do Payload sozinho não bastaria para definir a largura do Issuer (Issuer de 4 WORD sem versão e Issuer de 2 WORD com versão dariam os mesmos 8 WORD).
  • O ID de versão 0 é a versão mais recente. Fica atrelado à versão vigente no momento da interpretação. Os demais valores ficam fixados nessa versão (PUBLICATION).
  • O ID de documento 0 é o documento de índice das definições de termos do Issuer. O próprio Issuer é apontado por ISSUER-POINTER.
  • Todo Issuer reserva os IDs de documento 0x0000000000000000 e 0xFFFFFFFFFFFFFFFF (Issuer e publicação). 0xFFFFFFFFFFFFFFFF é usado na lista de Issuer issuers/ do Issuer 0x00000000 e os outros Issuer não o usam. PUBLICATION, DEPRECATION e TOMBSTONE de issuers/versions.geul apontam as versões da lista com esse valor (endereço de publicação e lista de versões).
  • É uma única posição do Codec 0x041L. Não há quantificação (Identified).
  • A forma de apontar um documento de um Issuer é apenas DOC-POINTER. É invalid apontar um documento com EXTERNAL-ISSUER-* (Issuer, ID de documento, ID de alvo 0) ou EXTERNAL-POINTER-* (IMPORT ID, ID de alvo 0).
  • Onde se usa: Meta DOC-ID e IMPORT-DOC; PUBLICATION, DEPRECATION e TOMBSTONE da lista de versões.
  • O documento de codec não tem ID de documento. O documento de codec e sua versão são apontados por CODEC-POINTER.

Exemplo

Documento 0xFFFF000000000001 do Issuer GEUL 0x00000000.

VersãoWORD sequence
10418 0000 0000 FFFF 0000 0000 0001 0000 0001
mais recente (0)0418 0000 0000 FFFF 0000 0000 0001 0000 0000
  • TAG 1 + Issuer 2 + ID do documento 4 + ID da versão 2 = 9 WORD, LLLL=1000. O TAG é 0000 0100 0001 1000 = 0418.

Páginas relacionadas

Texto original do documento de especificação

Como o documento de especificação 0x00000000/codecs/0x00000410/latest.geul aparece ao ser lido com geul show (hexadecimal em maiúsculas).

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000041000000000
BODY
#1 DECLARE 0x0410
#2 FIELD #1 rest
#3 FIELD #1 0x0004
#4 FIELD #1 0x0002
#5 BIND #1 "DOC-POINTER"
#6 BIND #2 "issuer"
#7 BIND #3 "doc"
#8 BIND #4 "version"