Updating the NTP Registries

2.1. Reference ID, Kiss-o'-Death

[RFC5905] defined two registries; the Reference ID in Section 7.3, and the Kiss-o'-Death in Section 7.4. Both of these are allowed to be four ASCII characters; padded on the right with all-bits-zero if necessary. Entries that start with 0x58, the ASCII letter uppercase X, are reserved for Private or Experimental Use. Both registries are first-come first-served. The formal request to define the registries is in [RFC5905], Section 16.¶

2.2. Extension Field Types

[RFC5905], Section 7.5 defined the on-the-wire format of extension fields but did not create a registry for them.¶

[RFC5906], Section 13 mentioned the Extension Field Types registry, and defined it indirectly by defining 30 extensions (10 each for request, response, and error response). It did not provide a formal definition of the columns in the registry. [RFC5906], Section 10 splits the Field Type into four subfields, only for use within the Autokey extensions.¶

[RFC7821] added a new entry, Checksum Complement, to the Extension Field Types registry.¶

[RFC7822] clarified the processing rules for Extension Field Types, particularly around the interaction with the Message Authentication Code (MAC) field. NTPv4 packets may contain a MAC that appears where one would expect the next extension field header.¶

[RFC8573] changed the cryptography used in the MAC field.¶

[RFC8915] added four new entries to the Extension Field Types registry.¶

The following problems exist with the current registry:¶

• Many of the entries in the Extension Field Types registry have swapped some of the nibbles; 0x1234 is listed as 0x1432 for example. This was due to documentation errors with the original implementation of Autokey. This document marks the erroneous values as reserved, in case there is an implementation that used the registered values instead of what the original implementation used.¶

• Some values were mistakenly re-used.¶

2.3. Network Time Security Registries

[RFC8915] defines the NTS protocol. Its registries are listed here for completeness, but no changes to them are specified in this document.¶

Sections 7.1 through 7.5 (inclusive) added entries to existing registries.¶

Section 7.6 created a new registry, NTS Key Establishment Record Types, that partitions the assigned numbers into three different registration policies: IETF Review, Specification Required, and Private or Experimental Use.¶

Section 7.7 created a new registry, NTS Next Protocols, that similarly partitions the assigned numbers.¶

Section 7.8 created two new registries, NTS Error Codes and NTS Warning Codes. Both registries are also partitioned the same way.¶

3.1. Guidance to Designated Experts

The designated experts (DE) should be familiar with [RFC8126], particularly Section 5. As that reference suggests, the DE should ascertain the existence of a suitable specification, and verify that it is publicly available. The DE is also expected to check the clarity of purpose and use of the requested code points.¶

In addition, the DE is expected to be familiar with this document, specifically the history documented here.¶

4.1. NTP Reference Identifier Codes

The registration procedure is changed to Specification Required.¶

The Note is changed to read as follows:¶

• Codes beginning with the character "X" are reserved for experimentation and development. IANA cannot assign them.¶

The columns are defined as follows:¶

• ID (required): a four-byte value padded on the right with all-bits-zero. Each byte other than padding must be an ASCII uppercase letter or digits.¶

• Clock source (required): A brief text description of the ID.¶

• Reference (required): the publication defining the ID.¶

The existing entries are left unchanged.¶

4.2. NTP Kiss-o'-Death Codes

The registration procedure is changed to Specification Required.¶

The Note is changed to read as follows:¶

• Codes beginning with the character "X" are reserved for experimentation and development. IANA cannot assign them.¶

The columns are defined as follows:¶

• ID (required): a four-byte value padded on the right with all-bits-zero. Each byte other than padding must be an ASCII uppercase letter or digits.¶

• Meaning source (required): A brief text description of the ID.¶

• Reference (required): the publication defining the ID.¶

The existing entries are left unchanged. ## NTP Extension Field Types¶

The registration procedure is changed to Specification Required.¶

The reference [RFC5906] should be added, if possible.¶

The following two Notes are added:¶

• Field Types in the range 0xF000 through 0xFFFF, inclusive, are reserved for experimentation and development. IANA cannot assign them. Both NTS Cookie and Autokey Message Request have the same Field Type; in practice this is not a problem as the field semantics will be determined by other parts of the message.¶

• The "Reserved for historic reasons" is for differences between the original documentation and implementation of Autokey and marks the erroneous values as reserved, in case there is an implementation that used the registered values instead of what the original implementation used.¶

The columns are defined as follows:¶

• Field Type (required): A two-byte value in hexadecimal.¶

• Meaning (required): A brief text description of the field type.¶

• Reference (required): the publication defining the field type.¶

The table is replaced with the following entries. IANA is requested to replace "This RFC" with the actual RFC number once assigned.¶