跳到主要内容

2. 创建和修订注册表

定义注册表涉及描述要创建的命名空间、列出初始分配集(如适用)以及记录关于未来分配方式的指南.

在定义注册表时,应考虑以这样的方式构建命名空间,即只需要通过集中协调进行顶层分配,这些分配可以委托较低层级的分配,以便可以分散协调.这减轻了 IANA 处理分配的负担,并且在分散协调者对其命名空间部分有更好的了解并更适合处理这些分配的情况下特别有用.

2.1. 注册表的组织​

所有注册表都锚定在 IANA 的"协议注册表"页面:

https://www.iana.org/protocols

该页面在协议类别组中列出注册表,将相关注册表放在一起,使注册表用户更容易找到必要的信息.单击 IANA 协议注册表页面上某个注册表的标题,将读者带到该注册表的详细信息页面.

不幸的是,我们在如何引用这些实体方面一直不一致.这里提到的组名,被各种称为"协议类别组"、"组"、"顶级注册表"或仅称为"注册表".它们下面的注册表被称为"注册表"或"子注册表".

无论使用何种术语,文档作者都应注意注册表分组,应请求将相关注册表分组在一起以使相关注册表更容易找到,并且在创建新注册表时,应检查该注册表是否最好包含在现有组中.该分组信息应在注册表创建请求中清楚地传达给 IANA.

2.2. 注册表的文档要求​

创建新命名空间(或修改现有空间的定义)并期望 IANA 在维护该空间(作为已注册值的存储库)中发挥作用的文档,必须在 IANA 注意事项部分或从中引用的位置提供关于命名空间详细信息的明确说明.

特别是,此类说明必须包括:

注册表的名称​

该名称将出现在 IANA 网页上,并将在需要从新空间分配值的未来文档中引用.应提供完整名称(以及缩写,如适用).非常希望所选名称不容易与另一个注册表的名称混淆.

创建注册表时,必须使用其完整名称识别它所属的组,完全如协议注册表列表中所显示的那样.

提供 URL 以精确识别注册表有助于 IANA 理解请求.此类 URL 可以在最终发布前从 RFC 中删除或留在文档中供参考.如果包含 iana.org URL,IANA 将在审查期间根据需要提供更正.

注册所需的信息​

这告诉注册者他们必须在注册请求中包含哪些信息.一些注册表只需要请求的值和对定义值使用的文档的引用.其他注册表需要更详细的注册模板,描述相关的安全考虑、国际化考虑和其他此类信息.

适用的注册策略​

将适用于所有未来注册请求的策略.请参见第 4 节.

注册表条目的大小、格式和语法​

要在注册表中记录哪些字段,对注册表条目的任何技术要求(整数的有效范围、字符串的长度限制等),以及应显示注册表值的确切格式.对于数字分配,应指定是以十进制、十六进制还是其他格式记录值.

字符串预期为 ASCII,应明确指定大小写是否重要,以及例如字符串是否应在注册表中以大写或小写显示.

表示协议参数的字符串很少(如果有的话)需要包含非 ASCII 字符.如果确实需要非 ASCII 字符,说明应非常明确地说明允许它们,并且应使用"(U+XXXX)"约定将非 ASCII 字符表示为 Unicode 字符.任何创建此类注册表的人都应仔细考虑这一点,并考虑国际化建议,例如 [RFC7564] 第 10 节中的建议.

初始分配和保留​

要包含的任何初始分配或注册.此外,应指示要为"私有使用"、"保留"、"未分配"等保留的任何范围(请参见第 6 节).

例如,文档可能通过包含以下内容来指定新注册表:

---------------------------------------------------------------

X. IANA 注意事项

本文档定义了一个名为"FooBar"的新 DHCP 选项(参见第 y 节),
并从 DHCP 选项空间分配了 TBD1 值
<https://www.iana.org/assignments/bootp-dhcp-parameters>
[RFC2132] [RFC2939]:
Data
Tag Name Length Meaning
---- ---- ------ -------
TBD1 FooBar N FooBar 服务器

FooBar 选项还定义了一个 8 位 FooType 字段,IANA 需要为此
创建和维护一个名为"FooType values"的新注册表,供 FooBar 选项使用.
DHCP FooBar FooType 注册表的初始值如下;未来的分配
将通过专家审查 [BCP26] 进行.分配包括
DHCP FooBar FooType 名称及其关联值.

Value DHCP FooBar FooType Name Definition
---- ------------------------ ----------
0 Reserved
1 Frobnitz RFCXXXX, Section y.1
2 NitzFrob RFCXXXX, Section y.2
3-254 Unassigned
255 Reserved
---------------------------------------------------------------

有关建立注册表的文档示例,请参阅 [RFC3575]、[RFC3968] 和 [RFC4520].

每当 IANA 在公共注册表中包含姓名和联系信息时,一些个人可能更喜欢不公开其联系信息.在这种情况下,可以与 IANA 安排保持联系信息的私密性.

2.3. 为注册表指定变更控制​

注册表定义和注册表内的注册在创建后通常需要更改.当不清楚谁有权进行更改时,进行此类更改的过程就会变得复杂.对于由 IETF 流中的 RFC 创建的注册表,注册表的变更控制默认由 IETF 通过 IESG 负责.对于在 IETF 流 RFC 中进行的值注册也是如此.

由于可以在 IETF 流之外创建注册表并进行注册,因此有时希望在 IETF 和 IESG 之外进行变更控制,明确指定变更控制策略总是有帮助的.

因此,建议所有创建的注册表都明确指定变更控制策略和变更控制者.还建议允许从 IETF 流之外进行注册的注册表,为每个值包含该值的变更控制者的指定.如果已注册值的定义或引用需要更改,或者如果需要弃用已注册值,则 IANA 知道谁有权进行更改至关重要.例如,媒体类型注册表 [RFC6838] 在其注册模板中包含"变更控制者".另请参见第 9.5 节.

2.4. 修订现有注册表​

更新注册流程或更改已经存在的(先前创建的)注册表的格式(无论是显式还是隐式创建),遵循与创建新注册表时使用的类似流程.也就是说,生成一个文档,引用现有命名空间,然后提供处理注册表中分配的详细指南或关于所需更改的详细说明.

如果更改需要在注册表中添加新列,则说明需要明确如何为现有条目填充该列.其他更改可能需要类似的明确性.

此类文档通常以与创建注册表的文档相同的文档状态进行处理.在某些情况下,例如显然需要的直接更改(例如添加"状态"列),或者需要更正早期错误时,IESG 可能会在不需要新文档的情况下批准对注册表的更新.

更新预先存在的注册表中分配指南的示例文档包括:[RFC6895]、[RFC3228] 和 [RFC3575].