<?xml version="1.0" encoding="utf-8"?>
<?xml-model href="rfc7991bis.rnc"?>
<!-- Required for schema validation and schema-aware editing -->
<!-- <?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?> -->
<!-- This third-party XSLT can be enabled for direct transformations in XML processors, including most browsers -->

<!DOCTYPE rfc [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">
]>
<!-- If further character entities are required then they should be added to the DOCTYPE above.
     Use of an external entity file is not recommended. -->

<rfc
  xmlns:xi="http://www.w3.org/2001/XInclude"
  category="std"
  docName="draft-equinox-intarea-icmpext-xlat-source-00"
  ipr="trust200902"
  obsoletes=""
  updates=""
  submissionType="IETF"
  consensus="true"
  xml:lang="en"
  version="3">
  <front>
    <title abbrev="icmpext-xlat-source">ICMP Extensions for IP/ICMP translators (XLATs)</title>
    <seriesInfo name="Internet-Draft" value="icmpext-xlat-source"/>

    <author fullname="David 'equinox' Lamparter" initials="D" surname="Lamparter">
      <organization>NetDEF, Inc.</organization>
      <address>
        <postal>
          <city>San Jose</city>
          <country>USA</country>
        </postal>
        <email>equinox@diac24.net</email>
        <email>equinox@opensourcerouting.org</email>
      </address>
    </author>
    <author fullname="Jen Linkova" initials="J" surname="Linkova">
      <organization>Google</organization>
      <address>
        <postal>
          <street>1 Darling Island Rd</street>
          <city>Pyrmont</city>
          <region>NSW</region>
          <code>2009</code>
          <country>AU</country>
        </postal>
        <email>furry13@gmail.com</email>
        <email>furry@google.com</email>
      </address>
    </author>

    <date year="2024"/>
    <area>Internet</area>
    <workgroup>Internet Area</workgroup>
    <keyword>ipv6</keyword>
    <keyword>ipv4</keyword>
    <keyword>clat</keyword>
    <keyword>traceroute</keyword>


    <abstract>
      <t>
          This document suggests the creation of an ICMP Multi-part Extension
          to carry the original IPv6 source address of ICMPv6 messages
          translated to ICMP by stateless (RFC6145) or stateful (RFC 6146) protocol translators.
      </t>
    </abstract>
    <note removeInRFC="true">
      <name>About This Document</name>
      <t>
          Source, version control history, and issue tracker for this draft can
          be found at <eref target="https://github.com/eqvinox/icmpext-clat-source"/>.
      </t>
      <t>
          (Note the draft was renamed (clat → xlat) prior to submission but
          changing the repository name on github breaks too many things to be
          worth the effort.)
      </t>
    </note>
  </front>

  <middle>
    <section>
      <name>Introduction</name>
      <t>
To allow communication between IPv6-only and IPv4-only devices, IPv4/IPv6 translators translate IPv6 and IPv4 packet headers according to the IP/ICMP Translation Algorithm defined in <xref target="RFC6145"/>.
For example, 464XLAT (<xref target="RFC6877"/>) defines an architecture for providing IPv4 connectivity across an IPv6-only network. The solution contains two key elements: provider-side translator (PLAT) and customer-side translator (CLAT). CLAT implementations translate private IPv4 addresses to global IPv6 addresses, and vice versa, as defined in <xref target="RFC6145"/>. 
</t>
<t>

To map IPv4 addresses to IPv6 ones the translators use the translation prefix (either a well-known or a network-specific one, see <xref target="RFC6052"/>). The resulting IPv6 addresses can be statelessly translated back to IPv4.
However it's not the case for an arbitrary global IPv6 addresses. Those addresses can only be translated to IPv4 by a stateful translators. 
</t>
<t>
One of scenarios when it might be required but not currently possible is translating ICMPv6 error messages send by intermediate nodes to the CLAT address in the 464XLAT envinronment. The most typical example is a diagnistic tool like traceroute sending packets to an IPv4 destination from an IPv6-only host.
Received ICMPv6 Time Exceeded are translated to ICMP Time Exceeded. If those packets were originated from an IPv4 address and translated to ICMPv6 by the PLAT (NAT64) device, then the source address of such packet can be mapped back to IPv4 by removing the translation prefix. However ICMPv6 error messages sent by devices located between the IPv6-only host and the NAT64 device have "native" IPv6 source addresses, which can not be mapped back to IPv4.
Those packets are usually dropped and tools like traceroute can not represent IPv6 intermediate hops in any meaningful way. Such behaviour complicates troubleshooting. It's also confusing for users and increases operational costs, as users report packet loss in the network based on traceroute output.
</t>
      <t>
Some CLAT implementations are known to workaround this issue by representing IPv6 addresses in IPv4 traceroute by using a reserved IPv4 address space and using the hop limit as the last octet, so an IPv6 device 5 hops away is shown as 225.0.0.5 etc.
      </t>
<t>
It should be noted that the similar issue occurs in IPv6 Data Center Environments when an ICMPv6 error message needs to be sent to an IPv4-only client.
As per Section 4.8 of <xref target="RFC7755"/>, ICMPv6 error packets are usually dropped by the translator.
</t>
<t>
This document proposes an ICMP extension so original IPv6 address of an ICMPv6 error message can be included into IMCP message and therefore passed to an application.
</t>
    </section>

    <section>
      <name>Requirements Language</name>
      <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 anchor="xlat">
      <name>Improved Translation Behavior</name>
      <t>
          Whenever a translator generates an IPv4 ICMP message from
          an ICMPv6 packet, and the IPv6 source address does not match the NAT64
          prefix (and is therefore not mappable to an IPv4 address), the
          extension described in this document SHOULD be added to the ICMP
          packet.
      </t>
      <t>
          The translator SHOULD NOT add the extension if the packet IPv6 source address
is an IPv4 address mapped to an IPv6 address using the translation prefix known to the translator.
      </t>
      <t>
          TBD: clarify IPv4 source address for consistency?  (maybe not,
          would extend scope of this draft.)
      </t>
    </section>

    <section anchor="ext">
      <name>IPv6 Original Source Extension</name>
      <t>
          The suggested encoding to be appended<xref target="RFC4884"/> to
          ICMP messages is as follows:
      </t>
      <figure align="center" anchor="fig_ext">
        <artwork align="center"><![CDATA[
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|          Length = 20          |   Class TBD1  |  C-Type = 0   |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                                                               |
+                                                               +
|                  original IPv6 source address                 |
+                          16 octets                            +
|                                                               |
+                                                               +
|                                                               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
]]></artwork>
      </figure>
      <t>
          The Length, Class and C-Type fields are as defined in
          <xref target="RFC4884"/> and filled in accordingly.  This document
          describes only one encoding and uses C-Type 0 for it.  C-Type
          MUST be set to 0 when appending this extension.  On receipt,
          this extension MUST be ignored if C-Type is not 0 or if Length is
          not 20.
      </t>
      <t>
          The original IPv6 source address field is always 16 octets in length
          and filled as described in this document.  It may contain any source
          address possibly seen in an ICMPv6 packet.  This notably includes
          link-local addresses, the IPv6 loopback address, and mapped IPv4
          addresses.  Receivers MUST NOT reject addresses solely due to the
          address not being a globally scoped IPv6 addresses.
      </t>
    </section>

    <section anchor="security">
      <name>Security Considerations</name>
      <t>
          TBD.  Should probably be local-only.
      </t>
    </section>
    <section anchor="privacy">
      <name>Privacy Considerations</name>
      <t>
          TBD
      </t>
    </section>
    <section anchor="IANA">
      <name>IANA Considerations</name>
      <t>
          This document requests that IANA allocates a "Class Value" from the
          "ICMP Extension Object Classes and Class Sub-types" registry
          created by <xref target="RFC4884"/> for use as described above.
          The following entry should be appended:
      </t>
      <table>
        <thead>
          <tr><th>Class Value</th><th>Class Name</th><th>Reference</th></tr>
        </thead>
        <tbody>
          <tr><td>TBD1</td><td>Original IPv6 Source Address</td><td>[THIS DOCUMENT]</td></tr>
        </tbody>
      </table>
    </section>
  </middle>

  <back>
    <references>
      <name>References</name>
      <references>
        <name>Normative References</name>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.2119.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.4884.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.6052.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.6145.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.6877.xml"/>
	<xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.8174.xml"/>
      </references>
     <references>
        <name>Informative References</name>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.7755.xml"/>
      </references>
    </references>
    <section anchor="Acknowledgements" numbered="false">
      <name>Acknowledgements</name>
      <t>
          This document is the result of discussions with Thomas Jensen.
      </t>
    </section>
 </back>
</rfc>
