CODEC-POINTER es un Reference de designación y declaración que señala una versión de un documento de Codec publicado por un Issuer. El documento de Codec no tiene ID de documento y se señala a sí mismo y su versión con CODEC-POINTER.

ElementoValor
NombreCODEC-POINTER (BIND CODEC-POINTER del documento de especificación)
TAG ID0x042L
Codec ID0x00000420
Documento de especificación0x00000000/codecs/0x00000420/ (destino de DECLARE 0420)
Sección2 0010 (Reference otros), desplazamiento dentro de la sección C = 2
KindReference · clasificación: designación y declaración
TAG WORD0000 0100 0010 LLLL (000K KKKC CCCC LLLL)
Descripción del índiceUna versión de un Codec del Issuer. Issuer + Codec ID de 2 WORD + ID de versión de 2 WORD, sin ID de destino
Lado Hugoreference/codec-pointer.md

Campos (documento de especificación)

El orden de los FIELD dentro del documento es el orden de los campos del Payload (Documento de especificación de Codec).

OrdenCampo (BIND)FIELDAnchoFormato aceptado (CODEC)ENUM
1issuer#2resto en valor en bruto (0xFFFF)
2codec#3valor en bruto de 2 WORD
3version#4valor en bruto de 2 WORD

Layout

TAG WORD          0000 0100 0010 LLLL      Codec 0x042L
[TAG de extensión de Length]
Issuer            2/4/16 WORD
Codec ID          2 WORD
ID de versión     2 WORD

Interpretación y validez

  • El ancho del Issuer es el resto del Payload tras restar los 4 WORD del Codec ID y el ID de versión. El Payload es de 6, 8 o 20 WORD y cualquier otra longitud es invalid. Es invalid si el valor del Issuer cabe en un ancho más estrecho (forma canónica del Issuer).
  • Si el Issuer es de 16 WORD, son 21 WORD en total y se añade 1 WORD de extensión de Length.
  • El Codec ID es de 32 bits. El Codec ID de un código directo de GEUL es el valor de su TAG WORD (L=0) escrito en 32 bits (TRIPLE 0x0AAL → 0x00000AA0). El Codec ID de un Codec de Issuer es el número de Codec del registro, y el Issuer lo fija sin solaparse dentro de su codecs/, con independencia del Kind (Direcciones de publicación y lista de versiones).
  • El ID de versión 0 es la versión más reciente. Cualquier otro valor queda fijado a esa versión.
  • Es una sola casilla, el Codec 0x042L. No hay cuantificación (Identified). Al ser la sección 2, no se lee como cuantificación ni como sistema.
  • Dónde se usa: el Meta DOC-ID del documento de Codec, PUBLICATION, DEPRECATION y TOMBSTONE de la lista de versiones de Codec, e IMPORT-DOC que importa un documento de Codec. En estas posiciones sustituye a DOC-POINTER.
  • La dirección de publicación es /.well-known/geul/<Issuer>/codecs/<Codec ID>/<ID de versión>.geul (Direcciones de publicación y lista de versiones).

Ejemplo

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

VersiónWORD sequence
10426 0000 0000 0000 0AA0 0000 0001
Más reciente (0)0426 0000 0000 0000 0AA0 0000 0000
  • TAG 1 + Issuer 2 + Codec ID 2 + ID de versión 2 = 7 WORD, LLLL=0110. El TAG es 0000 0100 0010 0110 = 0426.

Páginas relacionadas

Texto original del documento de especificación

Así se ve el documento de especificación 0x00000000/codecs/0x00000420/latest.geul leído con geul show (hexadecimal en mayú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"