项目值
名称UUID(规格文档 BIND UUID)
TAG ID0x07BL
Codec ID0x000007B0
规格文档0x00000000/codecs/0x000007B0/(DECLARE 对象 07B0)
章节3 0011(Value),章节内偏移 C = 27
KindValue · 系列:BINARY
TAG WORD0000 0111 1011 LLLL(000K KKKC CCCC LLLL)
索引说明固定 Payload 8 WORD 的 RFC 9562 UUID 128bit
Hugo 路径value/binary/uuid.md

字段(规格文档)

FIELD 在文档中的顺序就是 Payload 字段的顺序(Codec 规格文档)。

顺序字段(BIND)FIELD宽度接收格式(CODEC)ENUM
1uuid#2原始值 8 WORD

UUID 是承载 RFC 9562 UUID 128bit 值的定宽 Value。Value 直接码 0x07BL,系列 BINARY。Payload 恰好为 8 WORD(16 octet,128bit)。

布局

TAG WORD          0x07B8 (0000 0111 1011 1000)  总计 9 WORD
Payload           8 WORD (128位)  UUID octet 0 → octet 15

解释与有效性

  • 将 RFC 9562 canonical UUID 的 octet 0 到 octet 15 依次两个 octet 一组。先出现的 octet 是 WORD 的高 8bit。不对 UUID 的 field、version bit、variant bit 重新排列或重新 encode。
  • 8-4-4-4-12 hex-and-dash 字符串只是输入输出表示。大小写和 dash 不进入 Payload,只存储解析结果的 16 octet。
  • 该 UUID Value 无损保存 128bit pattern。在 RFC 9562 variant 10xx 下,version 1、3、4、5、6、7 是标准 layout,version 8 是 custom UUID format。version 2 保留给 DCE Security,RFC 未规定其 layout,version 0 为 unused,version 9–15 保留给未来定义。其他 variant 也保留用于兼容或未来定义。
  • Nil UUID 是 128bit 全零,Max UUID 是 128bit 全一的特殊值。包含保留·unused version/variant 的 128bit pattern 在结构上也不排除,该 pattern 的含义和互操作性由适用标准和外部语境判断。
  • UUID 的同一性以 Payload 的 128bit 值是否相同来判断。值相同这一事实并不保证对象的认证、所有权、当前存在、可解析性和访问权限。
  • 存储 Microsoft COM GUID 时,不原样复制 mixed-endian 的内存·序列化表示。先转换为 RFC 9562 canonical field/octet 顺序的 16 octet。
  • Payload 不是恰好 8 WORD 时拒绝。

标准依据

  • RFC 9562 — Universally Unique IDentifiers (UUIDs) 将 UUID 定义为 16 octet(128bit),要求 field 以 most-significant-byte-first 方式 encode,在 binary format 中按 big-endian field 顺序连接。variant 位于 octet 8 的高位 bit,version 位于 octet 6 的高 4bit,本格式原样保存这些位置。
  • RFC 9562 Sections 4.1–5.10 区分了 variant 与 version 1–8、Nil、Max、保留范围。RFC 9562 取代 RFC 4122,因此本格式现行的规范依据是 RFC 9562。
  • RFC 9562 的 hex-and-dash ABNF 是 text 表示,COM GUID little-endian 的注意事项也另行说明。GEUL 只把 RFC UUID 的 canonical 16 octet 放入 Payload。
  • GEUL TAG、直接 Length、16bit WORD framing 不是 RFC 9562 的一部分,而是本格式增加的规则。

长度

  • 总长为 TAG 1 WORD 与 Payload 8 WORD 之和,恰好 9 WORD,使用直接长度 LLLL=1000。没有 Length 扩展 TAG、descriptor、padding。
  • Payload 不是恰好 8 WORD 时拒绝。

示例

RFC 9562 Appendix A.6 的 UUIDv7 test vector 017f22e2-79b0-7cc3-98c4-dc0c0c07398f:

07B8 017F 22E2 79B0 7CC3 98C4 DC0C 0C07 398F
  • TAG 07B8,Payload 017F 22E2 79B0 7CC3 98C4 DC0C 0C07 398F。

规格文档原文

这是用 geul show 读取规格文档 0x00000000/codecs/0x000007B0/latest.geul 的样子(十六进制为大写)。

SPEC-VERSION 0x0001
DOC-ID 0x042600000000000007B000000000
BODY
#1 DECLARE 0x07B0
#2 FIELD #1 0x0008
#3 BIND #1 "UUID"
#4 BIND #2 "uuid"