Skip to content

Commit

Permalink
Merge pull request #71 from netmod-wg/iana-template-update
Browse files Browse the repository at this point in the history
iana-template-update
  • Loading branch information
boucadair authored Oct 21, 2024
2 parents 7f8513d + de5d4fe commit b0cb3b4
Showing 1 changed file with 45 additions and 15 deletions.
60 changes: 45 additions & 15 deletions draft-ietf-netmod-rfc8407bis.md
Original file line number Diff line number Diff line change
Expand Up @@ -593,7 +593,33 @@ should indicate whether the module is IANA-maintained or not. This applies to ne
modules. An example of an update registration for the
"ietf-template" module can be found in {{sec-iana}}.

A registration template is provided below:
Additional IANA considerations applicable to IANA-maintained modules (including instructions to maintain them) are provided in {{sec-iana-mm}}.

### Documents That Create a New Namespace

If an I-D defines a new namespace that is to be administered by the
IANA, then the document MUST include an IANA Considerations section
that specifies how the namespace is to be administered.

Specifically, if any YANG module namespace statement value contained
in the document is not already registered with IANA, then a new entry
in the "ns" subregistry within the "IETF XML Registry" MUST be
requested from the IANA.

A registration template for new YANG modules is provided in {{sec-reg-def-iana}}.

### Documents That Extend an Existing Namespace

It is possible to extend an existing namespace using a YANG submodule
that belongs to an existing module already administered by IANA. In
this case, the document containing the main module MUST be updated to
use the latest revision of the submodule.

### Registration Templates

#### IANA Template for Documents Defining New YANG Modules {#sec-reg-def-iana}

A registration template for a new module is provided below:

~~~
IANA is requested to register the following URI in the "ns"
Expand All @@ -614,26 +640,30 @@ A registration template is provided below:
Reference:
~~~

Additional IANA considerations applicable to IANA-maintained modules (including instructions to maintain them) are provided in {{sec-iana-mm}}.
#### IANA Template for Revising YANG Modules

A registration template for a revised module is provided below:

### Documents That Create a New Namespace
~~~
IANA is requested to update the following registration in the "ns"
subregistry within the "IETF XML Registry" [RFC3688] to reference
this document:

If an I-D defines a new namespace that is to be administered by the
IANA, then the document MUST include an IANA Considerations section
that specifies how the namespace is to be administered.
URI:
Registrant Contact: The IESG.
XML: N/A; the requested URI is an XML namespace.

Specifically, if any YANG module namespace statement value contained
in the document is not already registered with IANA, then a new entry
in the "ns" subregistry within the "IETF XML Registry" MUST be
requested from the IANA.
IANA is requested to register the following YANG module in the "YANG
Module Names" subregistry [RFC6020] within the "YANG Parameters"
registry.

### Documents That Extend an Existing Namespace
Name:
Maintained by IANA? Y/N
Namespace:
Prefix:
Reference:
~~~

It is possible to extend an existing namespace using a YANG submodule
that belongs to an existing module already administered by IANA. In
this case, the document containing the main module MUST be updated to
use the latest revision of the submodule.

## References Sections

Expand Down

0 comments on commit b0cb3b4

Please sign in to comment.