CODEC-POINTER é a Reference de indicação e declaração que aponta uma versão de um documento de codec publicado por um Issuer. O documento de codec não tem ID de documento; ele aponta a si mesmo e à sua versão por CODEC-POINTER.

ItemValor
NomeCODEC-POINTER (BIND CODEC-POINTER do documento de especificação)
TAG ID0x042L
Codec ID0x00000420
Documento de especificação0x00000000/codecs/0x00000420/ (alvo do DECLARE 0420)
Seção2 0010 (Reference diversas), deslocamento C na seção = 2
KindReference · classificação: indicação e declaração
TAG WORD0000 0100 0010 LLLL (000K KKKC CCCC LLLL)
Descrição no índiceUma versão de um codec de Issuer. Issuer + Codec ID de 2 WORD + ID de versão de 2 WORD, sem ID de alvo
Lado Hugoreference/codec-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)
2codec#3valor bruto de 2 WORD
3version#4valor bruto de 2 WORD

Layout

TAG WORD          0000 0100 0010 LLLL      Codec 0x042L
[TAG estendida de Length]
Issuer            2/4/16 WORD
Codec ID          2 WORD
ID da versão      2 WORD

Interpretação e validade

  • A largura do Issuer é o que resta do Payload depois de subtrair 4 WORD do Codec ID e do ID da versão. O Payload tem 6, 8 ou 20 WORD; qualquer outro comprimento é invalid. É invalid se o valor do Issuer couber numa largura mais estreita (forma canônica do Issuer).
  • Se o Issuer tiver 16 WORD, o total é de 21 WORD, e é anexado 1 WORD de TAG estendida de Length.
  • O Codec ID tem 32 bits. O Codec ID de um código direto de GEUL é o valor do seu TAG WORD (L=0) escrito em 32 bits (TRIPLE 0x0AAL → 0x00000AA0). O Codec ID de um codec de Issuer é o número de Codec do registro, e o Issuer o define sem repetição dentro do seu codecs/, independentemente do Kind (endereço de publicação e lista de versões).
  • O ID de versão 0 é a versão mais recente. Os demais valores ficam fixados nessa versão.
  • É uma única posição do Codec 0x042L. Não há quantificação (Identified). Por ser a seção 2, não se lê como quantificação nem como sistema.
  • Onde se usa: Meta DOC-ID do documento de codec; PUBLICATION, DEPRECATION e TOMBSTONE da lista de versões do codec; IMPORT-DOC que importa um documento de codec. Nessas posições substitui o DOC-POINTER.
  • O endereço de publicação é /.well-known/geul/<Issuer>/codecs/<Codec ID>/<ID da versão>.geul (endereço de publicação e lista de versões).

Exemplo

Codec TRIPLE do Issuer GEUL 0x00000000 (Codec ID 0x00000AA0).

VersãoWORD sequence
10426 0000 0000 0000 0AA0 0000 0001
mais recente (0)0426 0000 0000 0000 0AA0 0000 0000
  • TAG 1 + Issuer 2 + Codec ID 2 + ID da versão 2 = 7 WORD, LLLL=0110. O TAG é 0000 0100 0010 0110 = 0426.

Páginas relacionadas

Texto original do documento de especificação

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

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000042000000000
BODY
#1 DECLARE 0x0420
#2 FIELD #1 rest
#3 FIELD #1 0x0002
#4 FIELD #1 0x0002
#5 BIND #1 "CODEC-POINTER"
#6 BIND #2 "issuer"
#7 BIND #3 "codec"
#8 BIND #4 "version"