ElementoValor
NombreDOC-POINTER (BIND DOC-POINTER del documento de especificación)
TAG ID0x041L
Codec ID0x00000410
Documento de especificación0x00000000/codecs/0x00000410/ (destino de DECLARE 0410)
Sección2 0010 (Reference otros), desplazamiento dentro de la sección C = 1
KindReference · clasificación: designación y declaración
TAG WORD0000 0100 0001 LLLL (000K KKKC CCCC LLLL)
Lado Hugoreference/doc-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)
2doc#3valor en bruto de 4 WORD
3version#4valor en bruto de 2 WORD

DOC-POINTER es un Reference de designación y declaración que señala una versión de un documento publicado por un Issuer. Es objeto de la publicación, deprecate y eliminación de documentos, de la edición citada y de los enunciados sobre el documento.

Layout

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

Interpretación y validez

  • El ancho del Issuer es el resto del Payload tras restar los 6 WORD del ID de documento y el ID de versión. El Codec no divide el ancho. Es invalid si el ancho no es 2, 4 o 16 WORD, o si el valor del Issuer cabe en un ancho más estrecho (forma canónica del Issuer).
  • El ID de versión no se omite. Si se permitiera omitirlo, la longitud del Payload por sí sola no determinaría el ancho del Issuer (Issuer de 4 WORD sin versión e Issuer de 2 WORD con versión darían los mismos 8 WORD).
  • El ID de versión 0 es la versión más reciente. Queda atado a la versión vigente en el momento de interpretar. Cualquier otro valor queda fijado a esa versión (PUBLICATION).
  • El ID de documento 0 es el documento índice de definición de términos del Issuer. El propio Issuer se señala con ISSUER-POINTER.
  • Todo Issuer reserva los ID de documento 0x0000000000000000 y 0xFFFFFFFFFFFFFFFF (Issuer y publicación). 0xFFFFFFFFFFFFFFFF se usa en la lista de Issuer issuers/ del Issuer 0x00000000 y los demás Issuer no lo usan. PUBLICATION, DEPRECATION y TOMBSTONE de issuers/versions.geul señalan con este valor las versiones de la lista (Direcciones de publicación y lista de versiones).
  • Es una sola casilla, el Codec 0x041L. No hay cuantificación (Identified).
  • La forma de señalar un documento de un Issuer es únicamente DOC-POINTER. Señalar un documento con EXTERNAL-ISSUER-* (Issuer, ID de documento, ID de destino 0) o con EXTERNAL-POINTER-* (IMPORT ID, ID de destino 0) es invalid.
  • Dónde se usa: Meta DOC-ID e IMPORT-DOC, y PUBLICATION, DEPRECATION y TOMBSTONE de la lista de versiones.
  • El documento de Codec no tiene ID de documento. El documento de Codec y su versión se señalan con CODEC-POINTER.

Ejemplo

Documento 0xFFFF000000000001 del Issuer GEUL 0x00000000.

VersiónWORD sequence
10418 0000 0000 FFFF 0000 0000 0001 0000 0001
Más reciente (0)0418 0000 0000 FFFF 0000 0000 0001 0000 0000
  • TAG 1 + Issuer 2 + ID de documento 4 + ID de versión 2 = 9 WORD, LLLL=1000. El TAG es 0000 0100 0001 1000 = 0418.

Páginas relacionadas

Texto original del documento de especificación

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