Skip to content

Commit

Permalink
Merge pull request #31 from core-wg/pr-preferred-format
Browse files Browse the repository at this point in the history
add check for preferred format of Content Type
  • Loading branch information
thomas-fossati authored Feb 7, 2025
2 parents 125a25c + a9f9e9d commit 153427f
Showing 1 changed file with 18 additions and 3 deletions.
21 changes: 18 additions & 3 deletions draft-ietf-core-cf-reg-update.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@ author:
normative:
RFC7120: iana-early
RFC7252: coap
RFC9110: http-sema
BCP26:
-: iana-cons
=: RFC8126
Expand Down Expand Up @@ -185,15 +186,29 @@ A new column with the title "Note" has been added to the registry, which contain
The Designated Expert is instructed to perform the Expert Review, as described by the following checklist:

1. The combination of content-type and content coding for which the registration is requested must not be already present in the "CoAP Content-Formats" registry;
2. The media type associated with the requested Content-Format must exist (or must have been approved for registration) in the "Media Types" registry {{IANA.media-types}};
3. The optional parameter names must have been defined in association with the media type, and any parameter values associated with such parameter names must be as permitted;
4. If a Content Coding is specified, it must exist (or must have been approved for registration) in the "HTTP Content Coding" registry of the "Hypertext Transfer Protocol (HTTP) Parameters" {{IANA.http-parameters}}.
1. The media type associated with the requested Content-Format must exist (or must have been approved for registration) in the "Media Types" registry {{IANA.media-types}};
1. The optional parameter names must have been defined in association with the media type, and any parameter values associated with such parameter names must be as permitted;
1. The Content Type is in the preferred format defined in {{preferred-format}};
1. If a Content Coding is specified, it must exist (or must have been approved for registration) in the "HTTP Content Coding" registry of the "Hypertext Transfer Protocol (HTTP) Parameters" {{IANA.http-parameters}}.

For the 0-255 range, in addition to the checks described above, the DE is instructed to also evaluate the requested codepoint concerning the limited availability of the 1-byte codepoint space.
For the 256-9999 range and the 10000-64999 range, a similar criterion may also apply where combinations of media type parameters and content coding choices consume considerable code point space.

<!-- Should these actually use BCP14 MUSTs? -->

## Preferred Format for the Content Type Field {#preferred-format}

This section defines the preferred string format for including a requested Content Type into the CoAP Content-Formats registry.
During the review process, the Designated Expert(s) or IANA may rewrite a requested Content Type into this preferred string format before approval.

The preferred string format is as follows:

1. For any case-insensitive elements, lowercase characters must be used.
See {{Section 8.3.1 of -http-sema}} for a definition of case-insensitive elements and some examples.
1. Parameter values are only quoted if the value is such that it requires use of `quoted-string` per {{Section 5.6.6 of -http-sema}}.
Otherwise, a parameter value is included unquoted.
1. A semicolon followed by one space character is used as the separator between media type and parameters.

## Temporary Note Removal
{:removeinrfc}

Expand Down

0 comments on commit 153427f

Please sign in to comment.