<?xml version="1.0" encoding="US-ASCII"?>
<!DOCTYPE rfc SYSTEM "rfc2629.dtd">
<?rfc toc="yes" ?>
<?rfc symrefs="yes" ?>
<?rfc sortrefs="yes"?>
<?rfc iprnotified="no" ?>
<?rfc strict="yes" ?>
<?rfc comments="yes" ?>
<?rfc inline="yes" ?>
<?rfc compact="yes"?>
<?rfc subcompact="no"?>

<rfc ipr="trust200902" category="std" docName='draft-emailcore-iana-cleanup-01'>
  <front>
    <title abbrev="Abbreviated Title">
      Updates to SMTP related IANA registries
    </title>
    
<!--    
    <author initials="I." surname="Somebody" fullname="Someone Somebody">
      <organization></organization>
      <address>
        <postal>
          <street></street>
          <city></city>
          <region></region>
          <code></code>
          <country></country>
        </postal>
        <email></email>
      </address>
    </author>
  -->
    <author initials="A." surname="Melnikov" fullname="Alexey Melnikov">
      <organization>Isode Ltd</organization>
      <address>
        <postal>
          <street>14 Castle Mews</street>
          <city>Hampton</city>
          <region>Middlesex</region>
          <code>TW12 2NP</code>
          <country>UK</country>
        </postal>
        <email>alexey.melnikov@isode.com</email>
      </address>
    </author>
    <date year="2025"/>
    
    <!--One or more extra keywords which don't appear in the title-->
    <keyword>SMTP</keyword>
      
    <abstract>

    <t>
    While EMAILCORE working group was working on update to SMTP specification,
    it became clear that existing entries in SMTP related registries are missing information or contain stale information
    and need to be updated. This document updates such entries.
    </t>
	
    </abstract>
    
  </front>
  <middle>

    <section title="Introduction">
      
      <t>
      While EMAILCORE working group was working on update to SMTP specification <xref target="I-D.ietf-emailcore-rfc5321bis"/>,
      it became clear that existing entries in SMTP related registries are missing information or contain stale information
      and need to be updated. This document updates such entries,
      assuming IANA actions specified in <xref target="I-D.ietf-emailcore-rfc5321bis"/> were already performed.
      </t>

      <t>
      This document doesn't do any restructuring to existing SMTP related registries.
      </t>

<!--Example:
        <t>
	      S/MIME <xref target="RFC5751"/> is typically used to protect (sign and/on encrypt) Email message body parts,
        but not header of corresponding Email messages. Header fields may contain confidential information
        or information whose validity need protecting from disclosure or modification.
        <xref target="RFC5751"/> describes how to protect the Email message header <xref target="RFC5322"/>,
        by wrapping the message inside a message/rfc822 container <xref target="RFC2045"/>:
        </t>
        
      <t>
        When generating S/MIME messages which protect header fields by wrapping a message inside message/rfc822 wrapper:

        <list style='numbers'>

          <t>
          </t>

          <t>
          </t>

        </list>
      </t>
        
-->
    </section>
    
    <section title="Conventions Used in This Document">
      
      <t>The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
      "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
      "OPTIONAL" in this document are to be interpreted as described in BCP
      14 <xref target="RFC2119"/> <xref target="RFC8174"/>
      when, and only when, they appear in all capitals, as shown here.
      </t>

    </section>

    <section title="IANA Considerations">

      <section title='Updates to the "Simple Mail Transfer Protocol (SMTP) Service Extensions" registry'>

        <t>Updates to the "Simple Mail Transfer Protocol (SMTP) Service Extensions" registry are described
        as an ordered list of steps that should be performed sequentually.
        Each step is described by a subsection of this section.</t>
        
        
        <section title='Updates to the "References" field'>

          <t>IANA is requested to change values of the "References" field for
          "EXPN" and "HELP" extensions to <xref target="I-D.ietf-emailcore-rfc5321bis"/>.
          The "References" field values for "SEND", "SOML", "SAML" and "TURN" remain unchanged,
          as they were obsoleted and there are no newer reference than RFC 821.
          </t>

        </section>


        <section title='Updates to the "EHLO Parameters" field'>

          <t>
            IANA is requested to update the following values in this field:

            <list style='numbers'>

              <t>
              The value corresponding to the DELIVERBY extension should be changed to "A comma separated list of options (optional)", as per <xref target="RFC2852"/>.
              </t>

              <t>
              The value corresponding to the FUTURERELEASE extension should be changed to "max-future-release-interval and max-future-release-date-time", as per <xref target="RFC4865"/>.
              </t>

              <t>
              The value corresponding to the LIMITS extension should be changed to "List of limits", as per <xref target="RFC9422"/>.
              </t>
              
            </list>

          </t>

        </section>




        <section title='Updates to the "Message submission Use and Values" field'>

          <t>
          IANA is requested to update values of the "Message submission Use and Values" field
          corresponding to "HELP", "BURL", "FUTURERELEASE",
          "SMTPUTF8", "MT-PRIORITY", "RRVS", "REQUIRETLS" and "LIMITS" extensions to "MAY".
          </t>

        </section>



        <section title='Updates to the "Additional verbs", "MAIL/RCPT Parameter Values" fields'>

          <t>
            IANA is requested to update "Additional verbs" and "MAIL/RCPT Parameter Values" fields as per the table specified below.
            Information for relevant fields was extracted from existing RFCs describing corresponding SMTP Extensions.
          </t>
            
            
          <texttable>

<ttcol>EHLO Keyword</ttcol><ttcol>Additional verbs</ttcol><ttcol>MAIL/RCPT Parameter Values</ttcol>

<c>SEND</c><c>SEND</c><c>none</c>
<c>SOML</c><c>SOML</c><c>none</c>
<c>SAML</c><c>SAML</c><c>none</c>
<c>EXPN</c><c>EXPN</c><c>none</c>
<c>HELP</c><c>HELP</c><c>none</c>
<c>TURN</c><c>TURN</c><c>none</c>
<c>8BITMIME</c><c>none</c><c>BODY parameter to MAIL command</c>
<c>SIZE</c><c>none</c><c>SIZE parameter to MAIL command</c>
<c>CHUNKING</c><c>BDAT</c><c>none</c>
<c>BINARYMIME</c><c>none</c><c>BODY parameter to MAIL command (an extra choice was added)</c>
<c>CHECKPOINT</c><c>none</c><c>TRANSID parameter to the MAIL command</c>
<c>DELIVERBY</c><c>none</c><c>BY parameter to MAIL command</c>
<c>PIPELINING</c><c>none</c><c>none</c>
<c>DSN</c><c>none</c><c>NOTIFY and ORCPT parameters to RCPT command. RET and ENVID parameters to MAIL command</c>
<c>ETRN</c><c>ETRN</c><c>none</c>
<c>ENHANCEDSTATUSCODES</c><c>none</c><c>none</c>
<c>STARTTLS</c><c>STARTTLS</c><c>none</c>
<c>NO-SOLICITING</c><c>none</c><c>SOLICIT parameter to MAIL command</c>
<c>MTRK</c><c>none</c><c>MTRK parameters to MAIL command. Also see DSN extension parameters</c>
<c>SUBMITTER</c><c>none</c><c>SUBMITTER parameters to MAIL command</c>
<c>ATRN</c><c>ATRN</c><c>none</c>
<c>AUTH</c><c>AUTH</c><c>AUTH parameter to MAIL command</c>
<c>BURL</c><c>BURL</c><c>none</c>
<c>FUTURERELEASE</c><c>none</c><c>HOLDFOR and HOLDUNTIL parameters to MAIL command.</c>
<c>UTF8SMTP</c><c>none</c><c>One optional parameter, ALT-ADDRESS, is added to the MAIL and RCPT commands</c>
<c>CONPERM</c><c>none</c><c>CONPERM parameter to MAIL command</c>
<c>CONNEG</c><c>none</c><c>CONNEG parameter to RCPT command</c>
<c>SMTPUTF8</c><c>none</c><c>SMTPUTF8 parameter to the MAIL command</c>
<c>MT-PRIORITY</c><c>none</c><c>MT-PRIORITY parameter to MAIL command</c>
<c>RRVS</c><c>none</c><c>RRVS parameter to RCPT command</c>
<c>REQUIRETLS</c><c>none</c><c>REQUIRETLS parameter to MAIL command</c>
<c>LIMITS</c><c>none</c><c>none</c>
  
          </texttable>


          <t>
            IANA is further requested to update "Length Added" fields as per the table specified below.
            Information for this field was either extracted or calculated from information in
            existing RFCs describing corresponding SMTP Extensions.
          </t>
          
          <texttable>

<ttcol>EHLO Keyword</ttcol><ttcol>Length Added</ttcol><ttcol>Comment</ttcol>

<c>SIZE</c><c>26</c><c>https://datatracker.ietf.org/doc/html/rfc1870#section-3</c>
<c>CHUNKING</c><c>0</c><c>https://datatracker.ietf.org/doc/html/rfc3030#section-2</c>
<c>BINARYMIME</c><c>16</c><c>https://datatracker.ietf.org/doc/html/rfc3030#section-3</c>
<c>CHECKPOINT</c><c>88</c><c>https://datatracker.ietf.org/doc/html/rfc1845#section-2</c>
<c>DELIVERBY</c><c>17</c><c>https://datatracker.ietf.org/doc/html/rfc2852#section-2</c>
<c>MTRK</c><c>40</c><c>https://datatracker.ietf.org/doc/html/rfc3885#section-2</c>
<c>AUTH</c><c>500</c><c>https://datatracker.ietf.org/doc/html/rfc4954#section-3</c>
<c>FUTURERELEASE</c><c>34</c><c>https://datatracker.ietf.org/doc/html/rfc4865#section-3</c>
<c>UTF8SMTP</c><c>460</c><c>https://datatracker.ietf.org/doc/html/rfc5336#section-3.1</c>
<c>SMTPUTF8</c><c>10</c><c>https://datatracker.ietf.org/doc/html/rfc6531#section-3.1</c>
<c>MT-PRIORITY</c><c>15</c><c>https://datatracker.ietf.org/doc/html/rfc6710#section-3</c>
<c>RRVS</c><c>33</c><c>https://datatracker.ietf.org/doc/html/rfc7293#section-3.1</c>
<c>REQUIRETLS</c><c>11</c><c>https://www.rfc-editor.org/rfc/rfc8689.html#name-iana-considerations</c>
            
<!--
<c>LIMITS</c><c></c><c></c>
  -->
          </texttable>

          <t>TBD: Calculate "Length Added" when not specified in existing RFCs.
          Also possibly merge this with the previous table?</t>

          <t>
            IANA is further requested to update "Message Submission Use and Values" fields as per the table specified below.
            Most of these extensions were published since RFC 6409 was published, so they are not explicitly listed in it.
            In regards to HELP extension, there is no particular reason to prohibit it on Submission.
          </t>
          
          <texttable>

<ttcol>EHLO Keyword</ttcol><ttcol>Message Submission Use and Values</ttcol>

<c>HELP</c><c>MAY</c>
            
<c>BURL</c><c>MAY</c>
<c>FUTURERELEASE</c><c>MAY</c>
<c>SMTPUTF8</c><c>MAY</c>
<c>MT-PRIORITY</c><c>MAY</c>
<c>RRVS</c><c>MAY</c>
<c>REQUIRETLS</c><c>MAY</c>
<c>LIMITS</c><c>MAY</c>

          </texttable>
          

        </section>



<!--        
        <section title='Updates to the "Additional verbs", "MAIL/RCPT Parameter Values" fields'>

          <t>
            IANA is requested to update the following values in this field:

            <list style='numbers'>

              <t>
              </t>

              <t>
              </t>

              <t>
              </t>

            </list>

          </t>

        </section>
  -->


      </section>

    </section>

    <section title="Security Considerations" anchor="seccons">

      <t>This document only specifies IANA related actions, thus it doesn't directly
      affect security on SMTP or its extensions. However better documentation of SMTP extensions
      in IANA registries can, hopefully, lead to better and more secure implementations.</t>

    </section>
    
  </middle>
  <back>
    <references title="Normative References">
      <?rfc include="reference.RFC.2119"?> <!-- Keywords, part 1 -->
      <?rfc include="reference.RFC.8174"?> <!-- Keywords, part 2 -->

      <?rfc include="reference.RFC.6409"?> <!-- SMTP Submission -->

      <reference anchor="I-D.ietf-emailcore-rfc5321bis" target="https://datatracker.ietf.org/doc/html/draft-ietf-emailcore-rfc5321bis-43">
        <front>
          <title>Simple Mail Transfer Protocol</title>
          <author fullname="Dr. John C. Klensin" initials="J. C." surname="Klensin"/>
          <date day="28" month="April" year="2025"/>
          <abstract>
            <t>This document is a specification of the basic protocol for Internet electronic mail transport. It (including text carried forward from RFC 5321) consolidates, updates, and clarifies several previous documents, making all or parts of most of them obsolete. It covers the SMTP extension mechanisms and best practices for the contemporary Internet, but does not provide details about particular extensions. The document also provides information about use of SMTP for other than strict mail transport and delivery. This document replaces RFC 5321, the earlier version with the same title, and supersedes RFCs 1846, 7504, and 7505, incorporating all the relevant information in them.</t>
          </abstract>
        </front>
        <seriesInfo name="Internet-Draft" value="draft-ietf-emailcore-rfc5321bis-43"/>
      </reference>


      <?rfc include="reference.RFC.1870"?> <!-- SIZE -->
      <?rfc include="reference.RFC.3030"?> <!-- BINARYMIME, CHUNKING -->
      <?rfc include="reference.RFC.1845"?> <!-- CHECKPOINT -->
      <?rfc include="reference.RFC.2852"?> <!-- DELIVERBY -->
      <?rfc include="reference.RFC.3885"?> <!-- MTRK -->
      <?rfc include="reference.RFC.4865"?> <!-- FUTURERELEASE -->
      <?rfc include="reference.RFC.5336"?> <!-- UTF8SMTP -->
      <?rfc include="reference.RFC.6531"?> <!-- SMTPUTF8 -->
      <?rfc include="reference.RFC.6710"?> <!-- MT-PRIORITY -->
      <?rfc include="reference.RFC.7293"?> <!-- RRVS -->
      <?rfc include="reference.RFC.8689"?> <!-- REQUIRETLS -->
      <?rfc include="reference.RFC.9422"?> <!-- LIMITS -->

<!--
      <?rfc include="reference.RFC.2119"?>
      <?rfc include="reference.RFC.2119"?>
      <?rfc include="reference.RFC.2119"?>
  -->

  <!--
      <reference anchor="ABNF">
        <front>
          <title>Augmented BNF for Syntax Specifications: ABNF</title>
          <author initials="D" surname="Crocker" fullname="Dave Crocker" role="editor">
            <organization />
          </author>
          <author initials="P" surname="Overell" fullname="Paul Overell" role="editor">
            <organization />
          </author>
          <date year="2008" month="January"/>
        </front>
        <seriesInfo name="RFC" value="5234" />
        <format type="TXT" target="https://www.rfc-editor.org/info/rfc5234" />
      </reference>
    -->
      

    </references>

    <references title="Informative References">
      <?rfc include="reference.RFC.5321"?> <!-- SMTP -->
    </references>

    <section title="Acknowledgements">
	
      <t>Thank you to John Klensin and Tero Kivinen for suggestions, comments and corrections on this document.</t>

      <t>Tero Kivinen provided initial version of the table with Length Added values for various SMTP extensions.</t>

    </section>
    
  </back>
</rfc>
