| 项目 | 值 |
|---|---|
| 名称 | DOC-ID(规格文档 BIND DOC-ID) |
| TAG ID | 0x1C7L |
| Codec ID | 0x00001C70 |
| 规格文档 | 0x00000000/codecs/0x00001C70/(DECLARE 对象 1C70) |
| 章节 | 14 1110(Meta),章节内偏移 C = 7 |
| Kind | Meta · 类:定义 |
| TAG WORD | 0001 1100 0111 LLLL(000K KKKC CCCC LLLL) |
| 索引说明 | 本文档的标识符。内置 Reference DOC-POINTER(Issuer、文档 ID、版本 0)。Codec 文档用 CODEC-POINTER(Issuer、Codec ID、版本 0) |
| Hugo 侧 | meta/declaration/doc-id.md |
字段(规格文档)
FIELD 在文档中的顺序就是 Payload 字段的顺序(Codec 规格文档)。
| 顺序 | 字段(BIND) | FIELD | 宽度 | 接收格式(CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | doc | #2 | 记录 | 0410 DOC-POINTER, 0420 CODEC-POINTER |
声明本文档的标识符。其他文档要指向本文档及其中的对象,就需要它。
布局
TAG WORD 0001 1100 0111 LLLL Codec 0x1C7L
[Length 扩展 TAG]
文档 DOC-POINTER Reference 记录。(Issuer, 文档 ID, 版本 0)。Codec 文档为 CODEC-POINTER
- Codec:Meta
0x1C7L,定义类 - Payload:一个内置 Reference DOC-POINTER(Issuer、文档 ID、版本 0)
- 数量:至多一个。
docs/<文档 ID>/、codecs/<Codec ID>/下的版本文档必须有
解释与有效性
- Payload 恰好是一个
DOC-POINTER(Issuer、文档 ID、版本0)Reference 记录。版本 ID 只用0。版本不由文档分配,而由版本列表分配。Codec 文档使用CODEC-POINTER(Issuer、Codec ID、版本0)(CODEC-POINTER)。 - 因此指向“本文档”的写法,在 DOC-ID、版本列表的 PUBLICATION 记录、其他文档的引用中都相同。
- 无论版本如何,同一文档的
DOC-ID相同。版本 ID 和内容哈希不写入文档(版本)。 - 不存在文档名称地址(公布地址与版本列表)。供人阅读的标题由陈述 LABEL 负责。
- 若没有,则是无名文档,只能通过内容哈希指向。其他文档要用指示 Reference 指向本文档的 LOCAL,就需要它。
- 获取文档的一方要验证所收文档的
DOC-ID与所请求的 Issuer、文档 ID 一致。 - 文档 ID
0x0000000000000000是 Issuer 的术语定义索引文档(Issuer)。该文档同样是docs/<文档 ID>/下的版本文档,因此要放置 DOC-ID(DOC-POINTER(Issuer、0、0))。Issuer 自身由 ISSUER-POINTER 代表。 .well-known/geul/下<Issuer>/docs/<文档 ID>/与<Issuer>/codecs/<Codec ID>/的版本文档<版本 ID>.geul(含规格文档)必须有DOC-ID。- 列表文档是例外,不放置
DOC-ID:版本列表versions.geul(PUBLICATION)和 Issuer 列表issuers/的版本<版本 ID>.geul(公布地址与版本列表)。这是什么的列表,由记录的 DOC-POINTER 说明。列表文档的版本由其versions.geul的 PUBLICATION 以 DOC-POINTER(0x00000000、保留文档 ID、版本 ID)指向。内容哈希地址<Issuer>/hashes/是上述文档的副本,因此遵循原件。 - 文档 ID
0xFFFFFFFFFFFFFFFF在所有 Issuer 中保留(0x0000000000000000亦然),用于 Issuer0x00000000的 Issuer 列表。其他 Issuer 不使用。列表文档没有DOC-ID,因此该值只出现在issuers/versions.geul记录的 DOC-POINTER 中。 - Codec 规格文档是 GEUL Issuer
0x00000000的 Codec 文档。没有文档 ID,用DOC-ID放置 CODEC-POINTER(0x00000000、Codec ID、0)。Codec ID 是把 Kind·Codec TAG WORD 写成 32 位的值(0x0B80→0x00000B80)(规格文档)。
示例
- Issuer
0x00000002,文档0x…0005:1C79 0418 0000 0002 0000 0000 0000 0005 0000 0000(Meta TAG 1 + Reference TAG 1 + Issuer 2 + 文档 ID 4 + 版本 2 = 10 WORD)
规格文档原文
这是用 geul show 读取规格文档 0x00000000/codecs/0x00001C70/latest.geul 的结果(十六进制为大写)。
SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001C7000000000
BODY
#1 DECLARE 0x1C70
#2 FIELD #1 record
#5 CODEC #2 0x0410
#3 BIND #1 "DOC-ID"
#4 BIND #2 "doc"
#6 CODEC #2 0x0420