항목값
이름DOC-POINTER (규격 문서 BIND DOC-POINTER)
TAG ID0x041L
코덱 ID0x00000410
규격 문서0x00000000/codecs/0x00000410/ (DECLARE 대상 0410)
섹션2 0010 (Reference 기타), 섹션 안 오프셋 C = 1
KindReference · 분류: 지시선언
TAG WORD0000 0100 0001 LLLL (000K KKKC CCCC LLLL)
Hugo 쪽reference/doc-pointer.md

필드 (규격 문서)

FIELD의 문서 안 순서가 Payload 필드 순서다(Codec 규격 문서).

순서필드(BIND)FIELD폭받는 형식(CODEC)ENUM
1issuer#2나머지 날값(0xFFFF)
2doc#3날값 4 WORD
3version#4날값 2 WORD

DOC-POINTER는 Issuer가 공표한 문서의 한 버전을 가리키는 지시선언 Reference다. 문서 공표·deprecate·삭제, 인용 판본, 문서에 대한 서술의 대상이 된다.

레이아웃

TAG WORD          0000 0100 0001 LLLL      Codec 0x041L
[Length 확장 TAG]
Issuer            2/4/16 WORD
문서 ID           4 WORD
버전 ID           2 WORD

해석과 유효성

  • Issuer 폭은 Payload에서 문서 ID와 버전 ID 6 WORD를 뺀 나머지다. Codec이 폭을 나누지 않는다. 폭이 2, 4, 16 WORD가 아니거나, Issuer 값이 더 좁은 폭에 들어가면 invalid다(Issuer 정규형).
  • 버전 ID는 생략하지 않는다. 생략을 허용하면 Payload 길이만으로 Issuer 폭을 정할 수 없다(Issuer 4 WORD·버전 없음과 Issuer 2 WORD·버전 있음이 같은 8 WORD).
  • 버전 ID 0은 최신 버전이다. 해석하는 시점의 현행 버전에 묶인다. 그 밖의 값은 그 버전에 고정된다(PUBLICATION).
  • 문서 ID 0은 Issuer의 용어 정의 색인 문서다. Issuer 자신은 ISSUER-POINTER로 가리킨다.
  • 모든 Issuer는 문서 ID 0x0000000000000000과 0xFFFFFFFFFFFFFFFF를 예약한다(Issuer와 공표). 0xFFFFFFFFFFFFFFFF는 Issuer 0x00000000의 Issuer 목록 issuers/에 쓰고, 다른 Issuer는 쓰지 않는다. issuers/versions.geul의 PUBLICATION·DEPRECATION·TOMBSTONE이 이 값으로 목록 버전을 가리킨다(공표 주소와 버전 목록).
  • Codec 0x041L 한 칸이다. 양화가 없다(Identified).
  • Issuer의 문서를 가리키는 형식은 DOC-POINTER 하나다. EXTERNAL-ISSUER-*(Issuer, 문서 ID, 대상 ID 0)나 EXTERNAL-POINTER-*(IMPORT ID, 대상 ID 0)로 문서를 가리키는 것은 invalid다.
  • 쓰는 곳: Meta DOC-ID·IMPORT-DOC, 버전 목록의 PUBLICATION·DEPRECATION·TOMBSTONE.
  • 코덱 문서는 문서 ID가 없다. 코덱 문서와 그 버전은 CODEC-POINTER로 가리킨다.

예시

GEUL Issuer 0x00000000의 문서 0xFFFF000000000001.

버전WORD sequence
10418 0000 0000 FFFF 0000 0000 0001 0000 0001
최신 (0)0418 0000 0000 FFFF 0000 0000 0001 0000 0000
  • TAG 1 + Issuer 2 + 문서 ID 4 + 버전 ID 2 = 9 WORD, LLLL=1000이다. TAG는 0000 0100 0001 1000 = 0418이다.

관련 페이지

규격 문서 원문

규격 문서 0x00000000/codecs/0x00000410/latest.geul을 geul show로 읽은 모습이다(16진은 대문자).

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"