Network Working Group A. Conta Request for Comments: 2473 Lucent Technologies Inc. Category: Standards Track S. Deering Cisco Systems December 1998 Generic Packet Tunneling in IPv6 Specification Status of this Memo This document specifies an Internet standards track protocol for the Internet community, and requests discussion and suggestions for improvements. Please refer to the current edition of the "Internet Official Protocol Standards" (STD 1) for the standardization state and status of this protocol. Distribution of this memo is unlimited. Copyright Notice Copyright (C) The Internet Society (1998). All Rights Reserved. Abstract This document defines the model and generic mechanisms for IPv6 encapsulation of Internet packets, such as IPv6 and IPv4. The model and mechanisms can be applied to other protocol packets as well, such as AppleTalk, IPX, CLNP, or others. Table of Contents 1. Introduction..................................................2 2. Terminology...................................................2 3. IPv6 Tunneling................................................4 3.1 IPv6 Encapsulation.......................................6 3.2 IPv6 Packet Processing in Tunnels........................7 3.3 IPv6 Decapsulation.......................................7 3.4 IPv6 Tunnel Protocol Engine..............................8 4. Nested Encapsulation.........................................11 4.1 Limiting Nested Encapsulation..........................12 4.1.1 Tunnel Encapsulation Limit Option................13 4.1.2 Loopback Encapsulation...........................15 4.1.3 Routing Loop Nested Encapsulation................15 5. Tunnel IPv6 Header...........................................16 5.1 Tunnel IPv6 Extension Headers...........................17 6. IPv6 Tunnel State Variables..................................19 6.1 IPv6 Tunnel Entry-Point Node............................19 6.2 IPv6 Tunnel Exit-Point Node.............................19 Conta & Deering Standards Track [Page 1] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 6.3 IPv6 Tunnel Hop Limit...................................19 6.4 IPv6 Tunnel Packet Traffic Class........................20 6.5 IPv6 Tunnel Flow Label..................................20 6.6 IPv6 Tunnel Encapsulation Limit.........................20 6.7 IPv6 Tunnel MTU.........................................20 7. IPv6 Tunnel Packet Size Issues...............................21 7.1 IPv6 Tunnel Packet Fragmentation........................21 7.2 IPv4 Tunnel Packet Fragmentation........................22 8. IPv6 Tunnel Error Reporting and Processing...................22 8.1 Tunnel ICMP Messages....................................27 8.2 ICMP Messages for IPv6 Original Packets.................28 8.3 ICMP Messages for IPv4 Original Packets.................29 8.4 ICMP Messages for Nested Tunnel Packets.................30 9. Security Considerations......................................30 10. Acknowledgments.............................................31 11. References..................................................31 Authors' Addresses..............................................32 Appendix A. Risk Factors in Recursive Encapsulation.............33 Full Copyright Statement........................................36 1. Introduction This document specifies a method and generic mechanisms by which a packet is encapsulated and carried as payload within an IPv6 packet. The resulting packet is called an IPv6 tunnel packet. The forwarding path between the source and destination of the tunnel packet is called an IPv6 tunnel. The technique is called IPv6 tunneling. A typical scenario for IPv6 tunneling is the case in which an intermediate node exerts explicit routing control by specifying particular forwarding paths for selected packets. This control is achieved by prepending IPv6 headers to each of the selected original packets. These prepended headers identify the forwarding paths. In addition to the description of generic IPv6 tunneling mechanisms, which is the focus of this document, specific mechanisms for tunneling IPv6 and IPv4 packets are also described herein. The keywords MUST, MUST NOT, MAY, OPTIONAL, REQUIRED, RECOMMENDED, SHALL, SHALL NOT, SHOULD, SHOULD NOT are to be interpreted as defined in RFC 2119. 2. Terminology original packet a packet that undergoes encapsulation. Conta & Deering Standards Track [Page 2] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 original header the header of an original packet. tunnel a forwarding path between two nodes on which the payloads of packets are original packets. tunnel end-node a node where a tunnel begins or ends. tunnel header the header prepended to the original packet during encapsulation. It specifies the tunnel end-points as source and destination. tunnel packet a packet that encapsulates an original packet. tunnel entry-point the tunnel end-node where an original packet is encapsulated. tunnel exit-point the tunnel end-node where a tunnel packet is decapsulated. IPv6 tunnel a tunnel configured as a virtual link between two IPv6 nodes, on which the encapsulating protocol is IPv6. tunnel MTU the maximum size of a tunnel packet payload without requiring fragmentation, that is, the Path MTU between the tunnel entry- point and the tunnel exit-point nodes minus the size of the tunnel header. tunnel hop limit the maximum number of hops that a tunnel packet can travel from the tunnel entry-point to the tunnel exit-point. Conta & Deering Standards Track [Page 3] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 inner tunnel a tunnel that is a hop (virtual link) of another tunnel. outer tunnel a tunnel containing one or more inner tunnels. nested tunnel packet a tunnel packet that has as payload a tunnel packet. nested tunnel header the tunnel header of a nested tunnel packet. nested encapsulation encapsulation of an encapsulated packet. recursive encapsulation encapsulation of a packet that reenters a tunnel before exiting it. tunnel encapsulation limit the maximum number of nested encapsulations of a packet. 3. IPv6 Tunneling IPv6 tunneling is a technique for establishing a "virtual link" between two IPv6 nodes for transmitting data packets as payloads of IPv6 packets (see Fig.1). From the point of view of the two nodes, this "virtual link", called an IPv6 tunnel, appears as a point to point link on which IPv6 acts like a link-layer protocol. The two IPv6 nodes play specific roles. One node encapsulates original packets received from other nodes or from itself and forwards the resulting tunnel packets through the tunnel. The other node decapsulates the received tunnel packets and forwards the resulting original packets towards their destinations, possibly itself. The encapsulator node is called the tunnel entry-point node, and it is the source of the tunnel packets. The decapsulator node is called the tunnel exit-point, and it is the destination of the tunnel packets. Conta & Deering Standards Track [Page 4] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 Note: This document refers in particular to tunnels between two nodes identified by unicast addresses - such tunnels look like "virtual point to point links". The mechanisms described herein apply also to tunnels in which the exit-point nodes are identified by other types of addresses, such as anycast or multicast. These tunnels may look like "virtual point to multipoint links". At the time of writing this document, IPv6 anycast addresses are a subject of ongoing specification and experimental work. Tunnel from node B to node C <----------------------> Tunnel Tunnel Entry-Point Exit-Point Node Node +-+ +-+ +-+ +-+ |A|-->--//-->--|B|=====>=====//=====>=====|C|-->--//-->--|D| +-+ +-+ +-+ +-+ Original Original Packet Packet Source Destination Node Node Fig.1 Tunnel An IPv6 tunnel is a unidirectional mechanism - tunnel packet flow takes place in one direction between the IPv6 tunnel entry-point and exit-point nodes (see Fig.1). Tunnel from Node B to Node C <------------------------> Tunnel Tunnel Original Entry-Point Exit-Point Original Packet Node Node Packet Source Destination Node Node +-+ +-+ +-+ +-+ | |-->--//-->--| |=====>=====//=====>======| |-->--//-->--| | |A| |B| |C| |D| | |--<--//--<--| |=====<=====//=====<======| |--<--//--<--| | +-+ +-+ +-+ +-+ Original Original Packet Packet Destination Tunnel Tunnel Source Node Exit-Point Entry-Point Node Node Node <-------------------------> Tunnel from Node C to Node B Fig.2 Bi-directional Tunneling Mechanism Conta & Deering Standards Track [Page 5] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 Bi-directional tunneling is achieved by merging two unidirectional mechanisms, that is, configuring two tunnels, each in opposite direction to the other - the entry-point node of one tunnel is the exit-point node of the other tunnel (see Fig.2). 3.1 IPv6 Encapsulation IPv6 encapsulation consists of prepending to the original packet an IPv6 header and, optionally, a set of IPv6 extension headers (see Fig.3), which are collectively called tunnel IPv6 headers. The encapsulation takes place in an IPv6 tunnel entry-point node, as the result of an original packet being forwarded onto the virtual link represented by the tunnel. The original packet is processed during forwarding according to the forwarding rules of the protocol of that packet. For instance if the original packet is an: (a) IPv6 packet, the IPv6 original header hop limit is decremented by one. (b) IPv4 packet, the IPv4 original header time to live field (TTL) is decremented by one. At encapsulation, the source field of the tunnel IPv6 header is filled with an IPv6 address of the tunnel entry-point node, and the destination field with an IPv6 address of the tunnel exit-point. Subsequently, the tunnel packet resulting from encapsulation is sent towards the tunnel exit-point node. +----------------------------------//-----+ | Original | | | | Original Packet Payload | | Header | | +----------------------------------//-----+ < Original Packet > | v <Tunnel IPv6 Headers> < Original Packet > +---------+ - - - - - +-------------------------//--------------+ | IPv6 | IPv6 | | | | Extension | Original Packet | | Header | Headers | | +---------+ - - - - - +-------------------------//--------------+ < Tunnel IPv6 Packet > Fig.3 Encapsulating a Packet Conta & Deering Standards Track [Page 6] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 Tunnel extension headers should appear in the order recommended by the specifications that define the extension headers, such as [IPv6- Spec]. A source of original packets and a tunnel entry-point that encapsulates those packets can be the same node. 3.2 Packet Processing in Tunnels The intermediate nodes in the tunnel process the IPv6 tunnel packets according to the IPv6 protocol. For example, a tunnel Hop by Hop Options extension header is processed by each receiving node in the tunnel; a tunnel Routing extension header identifies the intermediate processing nodes, and controls at a finer granularity the forwarding path of the tunnel packet through the tunnel; a tunnel Destination Options extension header is processed at the tunnel exit-point node. 3.3 IPv6 Decapsulation Decapsulation is graphically shown in Fig.4: +---------+- - - - - -+----------------------------------//-----+ | IPv6 | IPv6 | | | | Extension | Original Packet | | Header | Headers | | +---------+- - - - - -+----------------------------------//-----+ < Tunnel IPv6 Packet > | v +----------------------------------//-----+ | Original | | | | Original Packet Payload | | Headers | | +----------------------------------//-----+ < Original Packet > Fig.4 Decapsulating a Packet Upon receiving an IPv6 packet destined to an IPv6 address of a tunnel exit-point node, its IPv6 protocol layer processes the tunnel headers. The strict left-to-right processing rules for extension headers is applied. When processing is complete, control is handed to the next protocol engine, which is identified by the Next Header field value in the last header processed. If this is set to a tunnel protocol value, the tunnel protocol engine discards the tunnel headers and passes the resulting original packet to the Internet or lower layer protocol identified by that value for further processing. Conta & Deering Standards Track [Page 7] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 For example, in the case the Next Header field has the IPv6 Tunnel Protocol value, the resulting original packet is passed to the IPv6 protocol layer. The tunnel exit-point node, which decapsulates the tunnel packets, and the destination node, which receives the resulting original packets can be the same node. 3.4 IPv6 Tunnel Protocol Engine Packet flow (paths #1-7) through the IPv6 Tunnel Protocol Engine on a node is graphically shown in Fig.5: Note: In Fig.5, the Upper-Layer Protocols box represents transport protocols such as TCP, UDP, control protocols such as ICMP, routing protocols such as OSPF, and internet or lower-layer protocol being "tunneled" over IPv6, such as IPv4, IPX, etc. The Link-Layer Protocols box represents Ethernet, Token Ring, FDDI, PPP, X.25, Frame Relay, ATM, etc..., as well as internet layer "tunnels" such as IPv4 tunnels. The IPv6 tunnel protocol engine acts as both an "upper-layer" and a "link-layer", each with a specific input and output as follows: (u.i) "tunnel upper-layer input" - consists of tunnel IPv6 packets that are going to be decapsulated. The tunnel packets are incoming through the IPv6 layer from: (u.i.1) a link-layer - (path #1, Fig.5) These are tunnel packets destined to this node and will undergo decapsulation. (u.i.2) a tunnel link-layer - (path #7, Fig.5) These are tunnel packets that underwent one or more decapsulations on this node, that is, the packets had one or more nested tunnel headers and one nested tunnel header was just discarded. This node is the exit-point of both an outer tunnel and one or more of its inner tunnels. For both above cases the resulting original packets are passed back to the IPv6 layer as "tunnel link-layer" output for further processing (see b.2). Conta & Deering Standards Track [Page 8] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 +-----------------------+ +-----------------------------------+ | Upper-Layer Protocols | | IPv6 Tunnel Upper-Layer | | | | | | | | ---<-------------------<------- | | | | | ---->---|------>--------- | | | | | | | | | | | | +-----------------------+ +-----------------------+ | | | | | | | | | | | | v ^ | v ^ v ^ v ^ v ^ Tunnel | | | | | | | | | | | | Packets| | | | +---------------------------------------------+ | | | | | | | | | / / | | | | D E | | v ^ IPv6 | --<-3--/-/--<---- | | | | E N | | | | Layer ---->-4-/-/--->-- | | | | | C C | | v ^ / / | | | | | | A A | | | | 2 1 | | | | | | P P | | v ^ -----<---5---/-/-<---- v ^ v ^ | | S S | | | | | -->---6---/-/-->-- | | | | | | | U U | | v ^ | | / / 6 5 4 3 8 7 | | L L | | | | | | / / | | | | | | | | A A | | v ^ v ^ / / v ^ | | | | | | T T | +---------------------------------------------+ | E E | | | | | | | | | | | | | | | | | v ^ v ^ v ^ v ^ v ^ v ^ Original| | | | | | | | | | | | | | | | Packets | v ^ | +-----------------------+ +-----------------------+ | | | | | | | | | | | | | | | | | | | ---|----|-------<-------- | | | | | --->--------------->------>---- | | | | | | Link-Layer Protocols | | IPv6 Tunnel Link-Layer | +-----------------------+ +-----------------------------------+ Fig.5 Packet Flow in the IPv6 Tunneling Protocol Engine on a Node (u.o) "tunnel upper-layer output" - consists of tunnel IPv6 packets that are passed through the IPv6 layer down to: (u.o.1) a link-layer - (path #2, Fig.5) These packets underwent encapsulation and are sent towards the tunnel exit-point (u.o.2) a tunnel link-layer - (path #8, Fig.5) These tunnel packets undergo nested encapsulation. This node is the entry-point node of both an outer tunnel and one or more of its inner tunnel. Conta & Deering Standards Track [Page 9] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 Implementation Note: The tunnel upper-layer input and output can be implemented similar to the input and output of the other upper-layer protocols. The tunnel link-layer input and output are as follows: (l.i) "tunnel link-layer input" - consists of original IPv6 packets that are going to be encapsulated. The original packets are incoming through the IPv6 layer from: (l.i.1) an upper-layer - (path #4, Fig.5) These are original packets originating on this node that undergo encapsulation. The original packet source and tunnel entry-point are the same node. (l.i.2) a link-layer - (path #6, Fig.5) These are original packets incoming from a different node that undergo encapsulation on this tunnel entry- point node. (l.i.3) a tunnel upper-layer - (path #8, Fig.5) These packets are tunnel packets that undergo nested encapsulation. This node is the entry-point node of both an outer tunnel and one or more of its inner tunnels. The resulting tunnel packets are passed as tunnel upper-layer output packets through the IPv6 layer (see u.o) down to: (l.o) "tunnel link-layer output" - consists of original IPv6 packets resulting from decapsulation. These packets are passed through the IPv6 layer to: (l.o.1) an upper-layer - (path #3, Fig.5) These original packets are destined to this node. (l.o.2) a link-layer - (path #5, Fig.5) These original packets are destined to another node; they are transmitted on a link towards their destination. Conta & Deering Standards Track [Page 10] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 (l.o.3) a tunnel upper-layer - (path #7, Fig.5) These packets undergo another decapsulation; they were nested tunnel packets. This node is both the exit- point node of an outer tunnel and one or more inner tunnels. Implementation Note: The tunnel link-layer input and output can be implemented similar to the input and output of other link-layer protocols, for instance, associating an interface or pseudo-interface with the IPv6 tunnel. The selection of the "IPv6 tunnel link" over other links results from the packet forwarding decision taken based on the content of the node's routing table. 4. Nested Encapsulation Nested IPv6 encapsulation is the encapsulation of a tunnel packet. It takes place when a hop of an IPv6 tunnel is a tunnel. The tunnel containing a tunnel is called an outer tunnel. The tunnel contained in the outer tunnel is called an inner tunnel - see Fig.6. Inner tunnels and their outer tunnels are nested tunnels. The entry-point node of an "inner IPv6 tunnel" receives tunnel IPv6 packets encapsulated by the "outer IPv6 tunnel" entry-point node. The "inner tunnel entry-point node" treats the receiving tunnel packets as original packets and performs encapsulation. The resulting packets are "tunnel packets" for the "inner IPv6 tunnel", and "nested tunnel packets" for the "outer IPv6 tunnel". Conta & Deering Standards Track [Page 11] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 Outer Tunnel <-------------------------------------> <--links--><-virtual link-><--links---> Inner Tunnel Outer Tunnel Outer Tunnel Entry-Point Exit-Point Node Node +-+ +-+ +-+ +-+ +-+ +-+ | | | | | | | | | | | | | |->-//->-| |=>=//=>=| |**>**//**>**| |=>=//=>==| |->-//->-| | | | | | | | | | | | | | +-+ +-+ +-+ +-+ +-+ +-+ Original Inner Tunnel Inner Tunnel Original Packet Entry-Point Exit-Point Packet Source Node Node Destination Node Node Fig.6. Nested Encapsulation 4.1 Limiting Nested Encapsulation A tunnel IPv6 packet is limited to the maximum IPv6 packet size [IPv6-Spec]. Each encapsulation adds to the size of an encapsulated packet the size of the tunnel IPv6 headers. Consequently, the number of tunnel headers, and therefore, the number of nested encapsulations is limited by the maximum packet size. However this limit is so large (more than 1600 encapsulations for an original packet of minimum size) that it is not an effective limit in most cases. The increase in the size of a tunnel IPv6 packet due to nested encapsulations may require fragmentation [IPv6-Spec] at a tunnel entry point - see section 7. Furthermore, each fragmentation, due to nested encapsulation, of an already fragmented tunnel packet results in a doubling of the number of fragments. Moreover, it is probable that once this fragmentation begins, each new nested encapsulation results in yet additional fragmentation. Therefore limiting nested encapsulation is recommended. The proposed mechanism for limiting excessive nested encapsulation is a "Tunnel Encapsulation Limit" option, which is carried in an IPv6 Destination Options extension header accompanying an encapsulating IPv6 header. Conta & Deering Standards Track [Page 12] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 4.1.1 Tunnel Encapsulation Limit Option A tunnel entry-point node may be configured to include a Tunnel Encapsulation Limit option as part of the information prepended to all packets entering a tunnel at that node. The Tunnel Encapsulaton Limit option is carried in a Destination Options extension header [IPv6-Spec] placed between the encapsulating IPv6 header and the IPv6 header of the original packet. (Other IPv6 extension headers may also be present preceding or following the Destination Options extension header, depending on configuration information at the tunnel entry-point node.) The Tunnel Encapsulation Limit option specifies how many additional levels of encapsulation are permitted to be prepended to the packet -- or, in other words, how many further levels of nesting the packet is permitted to undergo -- not counting the encapsulation in which the option itself is contained. For example, a Tunnel Encapsulation Limit option containing a limit value of zero means that a packet carrying that option may not enter another tunnel before exiting the current tunnel. The Tunnel Encapsulation Limit option has the following format: Option Type Opt Data Len Opt Data Len 0 1 2 3 4 5 6 7 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |0 0 0 0 0 1 0 0| 1 | Tun Encap Lim | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Option Type decimal value 4 - the highest-order two bits - set to 00 - indicate "skip over this option if the option is not recognized". - the third-highest-order bit - set to 0 - indicates that the option data in this option does not change en route to the packet's destination [IPv6-Spec]. Opt Data Len value 1 - the data portion of the Option is one octet long. Opt Data Value the Tunnel Encapsulation Limit value - 8-bit unsigned integer specifying how many further levels of encapsulation are permitted for the Conta & Deering Standards Track [Page 13] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 Tunnel Encapsulation Limit options are of interest only to tunnel entry points. A tunnel entry-point node is required to execute the following procedure for every packet entering a tunnel at that node: (a) Examine the packet to see if a Tunnel Encapsulation Limit option is present following its IPv6 header. The headers following the IPv6 header must be examined in strict "left-to-right" order, with the examination stopping as soon as any one of the following headers is encountered: (i) a Destination Options extension header containing a Tunnel Encapsulation Limit, (ii) another IPv6 header, (iii) a non-extension header, such as TCP, UDP, or ICMP, or (iv) a header that cannot be parsed because it is encrypted or its type is unknown. (Note that this requirment is an exception to the general IPv6 rule that a Destination Options extension header need only be examined by a packet's destination node. An alternative and "cleaner" approach would have been to use a Hop-by-Hop extension header for this purpose, but that would have imposed an undesirable extra processing burden, and possible consequent extra delay, at every IPv6 node along the path of a tunnel.) (b) If a Tunnel Encapsulation Limit option is found in the packet entering the tunnel and its limit value is zero, the packet is discarded and an ICMP Parameter Problem message [ICMP-Spec] is sent to the source of the packet, which is the previous tunnel entry-point node. The Code field of the Parameter Problem message is set to zero ("erroneous header field encountered") and the Pointer field is set to point to the third octet of the Tunnel Encapsulation Limit option (i.e., the octet containing the limit value of zero). (c) If a Tunnel Encapsulation Limit option is found in the packet entering the tunnel and its limit value is non-zero, an additional Tunnel Encapsulation Limit option must be included as part of the encapsulating headers being added at this entry point. The limit value in the encapsulating option is set to one less than the limit value found in the packet being encapsulated. (d) If a Tunnel Encapsulation Limit option is not found in the packet entering the tunnel and if an encapsulation limit has been configured for this tunnel, a Tunnel Encapsulation Limit option must be included as part of the encapsulating headers being added at this entry point. The limit value in the option is set to the configured limit. Conta & Deering Standards Track [Page 14] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 (e) If a Tunnel Encapsulation Limit option is not found in the packet entering the tunnel and if no encapsulation limit has been configured for this tunnel, then no Tunnel Encapsulation Limit option is included as part of the encapsulating headers being added at this entry point. A Tunnel Encapsulation Limit option added at a tunnel entry-point node is removed as part of the decapsulation process at that tunnel's exit-point node. Two cases of encapsulation that should be avoided are described below: 4.1.2 Loopback Encapsulation A particular case of encapsulation which must be avoided is the loopback encapsulation. Loopback encapsulation takes place when a tunnel IPv6 entry-point node encapsulates tunnel IPv6 packets originated from itself, and destined to itself. This can generate an infinite processing loop in the entry-point node. To avoid such a case, it is recommended that an implementation have a mechanism that checks and rejects the configuration of a tunnel in which both the entry-point and exit-point node addresses belong to the same node. It is also recommended that the encapsulating engine check for and reject the encapsulation of a packet that has the pair of tunnel entry-point and exit-point addresses identical with the pair of original packet source and final destination addresses. 4.1.3 Routing-Loop Nested Encapsulation In the case of a forwarding path with multiple-level nested tunnels, a routing-loop from an inner tunnel to an outer tunnel is particularly dangerous when packets from the inner tunnels reenter an outer tunnel from which they have not yet exited. In such a case, the nested encapsulation becomes a recursive encapsulation with the negative effects described in 4.1. Because each nested encapsulation adds a tunnel header with a new hop limit value, the IPv6 hop limit mechanism cannot control the number of times the packet reaches the outer tunnel entry-point node, and thus cannot control the number of recursive encapsulations. When the path of a packet from source to final destination includes tunnels, the maximum number of hops that the packet can traverse should be controlled by two mechanisms used together to avoid the negative effects of recursive encapsulation in routing loops: Conta & Deering Standards Track [Page 15] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 (a) the original packet hop limit. It is decremented at each forwarding operation performed on an original packet. This includes each encapsulation of the original packet. It does not include nested encapsulations of the original packet (b) the tunnel IPv6 packet encapsulation limit. It is decremented at each nested encapsulation of the packet. For a discussion of the excessive encapsulation risk factors in nested encapsulation see Appendix A. 5. Tunnel IPv6 Header The tunnel entry-point node fills out a tunnel IPv6 main header [IPv6-Spec] as follows: Version: value 6 Traffic Class: Depending on the entry-point node tunnel configuration, the traffic class can be set to that of either the original packet or a pre-configured value - see section 6.4. Flow Label: Depending on the entry-point node tunnel configuration, the flow label can be set to a pre-configured value. The typical value is zero - see section 6.5. Payload Length: The original packet length, plus the length of the encapsulating (prepended) IPv6 extension headers, if any. Next Header: The next header value according to [IPv6-Spec] from the Assigned Numbers RFC RFC-1700 or its successors">[RFC-1700 or its successors]. For example, if the original packet is an IPv6 packet, this is set to: Conta & Deering Standards Track [Page 16] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 - decimal value 41 (Assigned Next Header number for IPv6) - if there are no tunnel extension headers. - value 0 (Assigned Next Header number for IPv6 Hop by Hop Options extension header) - if a hop by hop options extension header immediately follows the tunnel IPv6 header. - decimal value 60 (Assigned Next Header number for IPv6 Destination Options extension header) - if a destination options extension header immediately follows the tunnel IPv6 header. Hop Limit: The tunnel IPv6 header hop limit is set to a pre-configured value - see section 6.3. The default value for hosts is the Neighbor Discovery advertised hop limit [ND-Spec]. The default value for routers is the default IPv6 Hop Limit value from the Assigned Numbers RFC (64 at the time of writing this document). Source Address: An IPv6 address of the outgoing interface of the tunnel entry-point node. This address is configured as the tunnel entry-point node address - see section 6.1. Destination Address: An IPv6 address of the tunnel exit-point node. This address is configured as the tunnel exit-point node address - see section 6.2. 5.1 Tunnel IPv6 Extension Headers Depending on IPv6 node configuration parameters, a tunnel entry-point node may append to the tunnel IPv6 main header one or more IPv6 extension headers, such as a Hop-by-Hop Options header, a Routing header, or others. Conta & Deering Standards Track [Page 17] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 To limit the number of nested encapsulations of a packet, if it was configured to do so - see section 6.6 - a tunnel entry-point includes a Destination Options extension header containing a Tunnel Encapsulation Limit option. If that option is the only option present in the Destination Options header, the header has the following format: +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Next Header |Hdr Ext Len = 0| Opt Type = 4 |Opt Data Len=1 | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Tun Encap Lim |PadN Opt Type=1|Opt Data Len=1 | 0 | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Next Header: Identifies the type of the original packet header. For example, if the original packet is an IPv6 packet, the next header protocol value is set to decimal value 41 (Assigned payload type number for IPv6). Hdr Ext Len: Length of the Destination Options extension header in 8- octet units, not including the first 8 octets. Set to value 0, if no other options are present in this destination options header. Option Type: value 4 - see section 4.1.1. Opt Data Len: value 1 - see section 4.1.1. Tun Encap Lim: 8 bit unsigned integer - see section 4.1.1. Option Type: value 1 - PadN option, to align the header following this header. Opt Data Len: value 1 - one octet of option data. Conta & Deering Standards Track [Page 18] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 Option Data: value 0 - one zero-valued octet. 6. IPv6 Tunnel State Variables The IPv6 tunnel state variables, some of which are or may be configured on the tunnel entry-point node, are: 6.1 IPv6 Tunnel Entry-Point Node Address The tunnel entry-point node address is one of the valid IPv6 unicast addresses of the entry-point node - the validation of the address at tunnel configuration time is recommended. The tunnel entry-point node address is copied to the source address field in the tunnel IPv6 header during packet encapsulation. 6.2 IPv6 Tunnel Exit-Point Node Address The tunnel exit-point node address is used as IPv6 destination address for the tunnel IPv6 header. A tunnel acts like a virtual point to point link between the entry-point node and exit-point node. The tunnel exit-point node address is copied to the destination address field in the tunnel IPv6 header during packet encapsulation. The configuration of the tunnel entry-point and exit-point addresses is not subject to IPv6 Autoconfiguration or IPv6 Neighbor Discovery. 6.3 IPv6 Tunnel Hop Limit An IPv6 tunnel is modeled as a "single-hop virtual link" tunnel, in which the passing of the original packet through the tunnel is like the passing of the original packet over a one hop link, regardless of the number of hops in the IPv6 tunnel. The "single-hop" mechanism should be implemented by having the tunnel entry point node set a tunnel IPv6 header hop limit independently of the hop limit of the original header. The "single-hop" mechanism hides from the original IPv6 packets the number of IPv6 hops of the tunnel. It is recommended that the tunnel hop limit be configured with a value that ensures: Conta & Deering Standards Track [Page 19] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 (a) that tunnel IPv6 packets can reach the tunnel exit-point node (b) a quick expiration of the tunnel packet if a routing loop occurs within the IPv6 tunnel. The tunnel hop limit default value for hosts is the IPv6 Neighbor Discovery advertised hop limit [ND-Spec]. The tunnel hop limit default value for routers is the default IPv6 Hop Limit value from the Assigned Numbers RFC (64 at the time of writing this document). The tunnel hop limit is copied into the hop limit field of the tunnel IPv6 header of each packet encapsulated by the tunnel entry-point node. 6.4 IPv6 Tunnel Packet Traffic Class The IPv6 Tunnel Packet Traffic Class indicates the value that a tunnel entry-point node sets in the Traffic Class field of a tunnel header. The default value is zero. The configured Packet Traffic Class can also indicate whether the value of the Traffic Class field in the tunnel header is copied from the original header, or it is set to the pre-configured value. 6.5 IPv6 Tunnel Flow Label The IPv6 Tunnel Flow Label indicates the value that a tunnel entry- point node sets in the flow label of a tunnel header. The default value is zero. 6.6 IPv6 Tunnel Encapsulation Limit The Tunnel Encapsulation Limit value can indicate whether the entry- point node is configured to limit the number of encapsulations of tunnel packets originating on that node. The IPv6 Tunnel Encapsulation Limit is the maximum number of additional encapsulations permitted for packets undergoing encapsulation at that entry-point node. Recommended default value is 4. An entry-point node configured to limit the number of nested encapsulations prepends a Destination Options extension header containing a Tunnel Encapsulation Limit option to an original packet undergoing encapsulation - see sections 4.1 and 4.1.1. 6.7 IPv6 Tunnel MTU The tunnel MTU is set dynamically to the Path MTU between the tunnel entry-point and the tunnel exit-point nodes, minus the size of the tunnel headers: the maximum size of a tunnel packet payload that can Conta & Deering Standards Track [Page 20] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 be sent through the tunnel without fragmentation [IPv6-Spec]. The tunnel entry-point node performs Path MTU discovery on the path between the tunnel entry-point and exit-point nodes [PMTU-Spec], [ICMP-Spec]. The tunnel MTU of a nested tunnel is the tunnel MTU of the outer tunnel minus the size of the nested tunnel headers. 7. IPv6 Tunnel Packet Size Issues Prepending a tunnel header increases the size of a packet, therefore a tunnel packet resulting from the encapsulation of an IPv6 original packet may require fragmentation. A tunnel IPv6 packet resulting from the encapsulation of an original packet is considered an IPv6 packet originating from the tunnel entry-point node. Therefore, like any source of an IPv6 packet, a tunnel entry-point node must support fragmentation of tunnel IPv6 packets. A tunnel intermediate node that forwards a tunnel packet to another node in the tunnel follows the general IPv6 rule that it must not fragment a packet undergoing forwarding. A tunnel exit-point node receiving tunnel packets at the end of the tunnel for decapsulation applies the strict left-to-right processing rules for extension headers. In the case of a fragmented tunnel packet, the fragments are reassembled into a complete tunnel packet before determining that an embedded packet is present. Note: A particular problem arises when the destination of a fragmented tunnel packet is an exit-point node identified by an anycast address. The problem, which is similar to that of original fragmented IPv6 packets destined to nodes identified by an anycast address, is that all the fragments of a packet must arrive at the same destination node for that node to be able to perform a successful reassembly, a requirement that is not necessarily satisfied by packets sent to an anycast address. 7.1 IPv6 Tunnel Packet Fragmentation When an IPv6 original packet enters a tunnel, if the original packet size exceeds the tunnel MTU (i.e., the Path MTU between the tunnel entry-point and the tunnel exit-point, minus the size of the tunnel header(s)), it is handled as follows: Conta & Deering Standards Track [Page 21] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 (a) if the original IPv6 packet size is larger than the IPv6 minimum link MTU [IPv6-Spec], the entry-point node discards the packet and sends an ICMPv6 "Packet Too Big" message to the source address of the original packet with the recommended MTU size field set to the tunnel MTU or the IPv6 minimum link MTU, whichever is larger, i.e. max (tunnel MTU, IPv6 minimum link MTU). Also see sections 6.7 and 8.2. (b) if the original IPv6 packet is equal or smaller than the IPv6 minimum link MTU, the tunnel entry-point node encapsulates the original packet, and subsequently fragments the resulting IPv6 tunnel packet into IPv6 fragments that do not exceed the Path MTU to the tunnel exit-point. 7.2 IPv4 Tunnel Packet Fragmentation When an IPv4 original packet enters a tunnel, if the original packet size exceeds the tunnel MTU (i.e., the Path MTU between the tunnel entry-point and the tunnel exit-point, minus the size of the tunnel header(s)), it is handled as follows: (a) if in the original IPv4 packet header the Don't Fragment - DF - bit flag is SET, the entry-point node discards the packet and returns an ICMP message. The ICMP message has the type = "unreachable", the code = "packet too big", and the recommended MTU size field set to the size of the tunnel MTU - see sections 6.7 and 8.3. (b) if in the original packet header the Don't Fragment - DF - bit flag is CLEAR, the tunnel entry-point node encapsulates the original packet, and subsequently fragments the resulting IPv6 tunnel packet into IPv6 fragments that do not exceed the Path MTU to the tunnel exit-point. 8. IPv6 Tunnel Error Processing and Reporting IPv6 Tunneling follows the general rule that an error detected during the processing of an IPv6 packet is reported through an ICMP message to the source of the packet. On a forwarding path that includes IPv6 tunnels, an error detected by a node that is not in any tunnel is directly reported to the source of the original IPv6 packet. Conta & Deering Standards Track [Page 22] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 An error detected by a node inside a tunnel is reported to the source of the tunnel packet, that is, the tunnel entry-point node. The ICMP message sent to the tunnel entry-point node has as ICMP payload the tunnel IPv6 packet that has the original packet as its payload. The cause of a packet error encountered inside a tunnel can be a problem with: (a) the tunnel header, or (b) the tunnel packet. Both tunnel header and tunnel packet problems are reported to the tunnel entry-point node. If a tunnel packet problem is a consequence of a problem with the original packet, which is the payload of the tunnel packet, then the problem is also reported to the source of the original packet. To report a problem detected inside the tunnel to the source of an original packet, the tunnel entry point node must relay the ICMP message received from inside the tunnel to the source of that original IPv6 packet. An example of the processing that can take place in the error reporting mechanism of a node is illustrated in Fig.7, and Fig.8: Fig.7 path #0 and Fig.8 (a) - The IPv6 tunnel entry-point receives an ICMP packet from inside the tunnel, marked Tunnel ICMPv6 Message in Fig.7. The tunnel entry-point node IPv6 layer passes the received ICMP message to the ICMPv6 Input. The ICMPv6 Input, based on the ICMP type and code [ICMP-Spec] generates an internal "error code". Fig.7 path #1 - The internal error code, is passed with the "ICMPv6 message payload" to the upper-layer protocol - in this case the IPv6 tunnel upper-layer error input. Conta & Deering Standards Track [Page 23] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 +-------+ +-------+ +-----------------------+ | Upper | | Upper | | Upper | | Layer | | Layer | | Layer | | Proto.| | Proto | | IPv6 Tunnel | | Error | | Error | | Error | | Input | | Input | | Input | | | | | | Decapsulate | | | | | | -->--ICMPv6--#2->-- | | | | | | | Payload | | +-------+ +-------+ +--|-----------------|--+ | | | | ^ ^ ^ v | | | | --------------------#1-- -----Orig.Packet?--- - - - - - - - #1 #3 Int.Error Code, #5 | Int.Error Code,^ v Source Address, v v ICMPv6 Payload | IPv6 | Orig. Packet | IPv4 | +--------------+ +------------+ +------------+ + - - + | | | | | | | ICMP v6 | | ICMP v6 | | ICMP v4 | | | | Input | | Err Report | | Err Report | | - - - - +----+ - - - -| + - - - -+ + - - + | | | | | IPv6 Layer | | IPv4 Layer | | | | | | | +--------------------------------+ +------------+ + - - + | | | ^ V V #0 #4 #6 | | | Tunnel ICMPv6 ICMPv6 ICMPv4 Message Message Message | | | Fig.7 Error Reporting Flow in a Node (IPv6 Tunneling Protocol Engine) Fig.7 path #2 and Fig.8 (b) - The IPv6 tunnel error input decapsulates the tunnel IPv6 packet, which is the ICMPv6 message payload, obtaining the original packet, and thus the original headers and dispatches the "internal error code", the source address from the original packet header, and the original packet, down to the error report block of the protocol identified by the Next Header field in the tunnel header immediately preceding the original packet in the ICMP message payload. From here the processing depends on the protocol of the original packet: Conta & Deering Standards Track [Page 24] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 (a) - for an IPv6 original packet Fig.7 path #3 and Fig.8 (c.1)- for an IPv6 original packet, the ICMPv6 error report builds an ICMP message of a type and code according to the "internal error code", containing the "original packet" as ICMP payload. Fig.7 path #4 and Fig.8 (d.1)- The ICMP message has the tunnel entry-point node address as source address, and the original packet source node address as destination address. The tunnel entry-point node sends the ICMP message to the source node of the original packet. (b) - for an IPv4 original packet Fig.7 path #5 and Fig.8 (c.2) - for an IPv4 original packet, the ICMPv4 error report builds an ICMP message of a type and code derived from the the "internal error code", containing the "original packet" as ICMP payload. Fig.7 path #6 and Fig.8 (d.2) - The ICMP message has the tunnel entry-point node IPv4 address as source address, and the original packet IPv4 source node address as destination address. The tunnel entry-point node sends the ICMP message to the source node of the original packet. A graphical description of the header processing taking place is the following: Conta & Deering Standards Track [Page 25] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 < Tunnel Packet > +--------+- - - - - -+--------+------------------------------//------+ | IPv6 | IPv6 | ICMP | Tunnel | (a)| | Extension | | IPv6 | | Header | Headers | Header | Packet in error | +--------+- - - - - -+--------+------------------------------//------+ < Tunnel Headers > < Tunnel ICMP Message > < ICMPv6 Message Payload > | v < Tunnel ICMP Message > < Tunnel IPv6 Packet in Error > +--------+ +---------+ +----------+--------//------+ | ICMP | | Tunnel | | Original | Original | (b) | | + | IPv6 | + | | Packet | | Header | | Headers | | Headers | Payload | +--------+ +---------+ +----------+--------//------+ | <Original Packet in Error > ----------------- | | | --------------|--------------- | | V V +---------+ +--------+ +-------------------//------+ | New | | ICMP | | | (c.1) | IPv6 | + | | + | Orig. Packet in Error | | Headers | | Header | | | +---------+ +--------+ +-------------------//------+ | v +---------+--------+-------------------//------+ | New | ICMP | Original | (d.1) | IPv6 | | | | Headers | Header | Packet in Error | +---------+--------+-------------------//------+ < New ICMP Message > Conta & Deering Standards Track [Page 26] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 or for an IPv4 original packet +---------+ +--------+ +-------------------//------+ | New | | ICMP | | | (c.2) | IPv4 | + | | + | Orig. Packet in Error | | Header | | Header | | | +---------+ +--------+ +-------------------//------+ | v +---------+--------+-------------------//------+ | New | ICMP | Original | (d.2) | IPv4 | | | | Header | Header | Packet in Error | +---------+--------+-------------------//------+ < New ICMP Message > Fig.8 ICMP Error Reporting and Processing 8.1 Tunnel ICMP Messages The tunnel ICMP messages that are reported to the source of the original packet are: hop limit exceeded The tunnel has a misconfigured hop limit, or contains a routing loop, and packets do not reach the tunnel exit- point node. This problem is reported to the tunnel entry- point node, where the tunnel hop limit can be reconfigured to a higher value. The problem is further reported to the source of the original packet as described in section 8.2, or 8.3. unreachable node One of the nodes in the tunnel is not or is no longer reachable. This problem is reported to the tunnel entry- point node, which should be reconfigured with a valid and active path between the entry and exit-point of the tunnel. The problem is further reported to the source of the original packet as described in section 8.2, or 8.3. parameter problem A Parameter Problem ICMP message pointing to a valid Tunnel Encapsulation Limit Destination header with a Tun Encap Lim field value set to one is an indication that the tunnel Conta & Deering Standards Track [Page 27] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 packet exceeded the maximum number of encapsulations allowed. The problem is further reported to the source of the original packet as described in section 8.2, or 8.3. The above three problems detected inside the tunnel, which are a tunnel configuration and a tunnel topology problem, are reported to the source of the original IPv6 packet, as a tunnel generic "unreachable" problem caused by a "link problem" - see section 8.2 and 8.3. packet too big The tunnel packet exceeds the tunnel Path MTU. The information carried by this type of ICMP message is used as follows: - by a receiving tunnel entry-point node to set or adjust the tunnel MTU - by a sending tunnel entry-point node to indicate to the source of an original packet the MTU size that should be used in sending IPv6 packets towards the tunnel entry-point node. 8.2 ICMP Messages for IPv6 Original Packets The tunnel entry-point node builds the ICMP and IPv6 headers of the ICMP message that is sent to the source of the original packet as follows: IPv6 Fields: Source Address A valid unicast IPv6 address of the outgoing interface. Destination Address Copied from the Source Address field of the Original IPv6 header. ICMP Fields: For any of the following tunnel ICMP error messages: "hop limit exceeded" Conta & Deering Standards Track [Page 28] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 "unreachable node" "parameter problem" - pointing to a valid Tunnel Encapsulation Limit destination header with the Tun Encap Lim field set to a value zero: Type 1 - unreachable node Code 3 - address unreachable For tunnel ICMP error message "packet too big": Type 2 - packet too big Code 0 MTU The MTU field from the tunnel ICMP message minus the length of the tunnel headers. According to the general rules described in 7.1, an ICMP "packet too big" message is sent to the source of the original packet only if the original packet size is larger than the minimum link MTU size required for IPv6 [IPv6-Spec]. 8.3 ICMP Messages for IPv4 Original Packets The tunnel entry-point node builds the ICMP and IPv4 header of the ICMP message that is sent to the source of the original packet as follows: IPv4 Fields: Source Address A valid unicast IPv4 address of the outgoing interface. Destination Address Copied from the Source Address field of the Original IPv4 header. ICMP Fields: For any of the following tunnel ICMP error messages: "hop limit exceeded" Conta & Deering Standards Track [Page 29] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 "unreachable node" "parameter problem" - pointing to a valid Tunnel Enacpsulation Limit destination header with the Tun Encap Lim field set to a value zero: Type 3 - destination unreachable Code 1 - host unreachable For a tunnel ICMP error message "packet too big": Type 3 - destination unreachable Code 4 - packet too big MTU The MTU field from the tunnel ICMP message minus the length of the tunnel headers. According to the general rules described in section 7.2, an ICMP "packet too big" message is sent to the original IPv4 packet source node if the the original IPv4 header has the DF - don't fragment - bit flag SET. 8.4 ICMP Messages for Nested Tunnel Packets In case of an error uncovered with a nested tunnel packet, the inner tunnel entry-point, which receives the ICMP error message from the inner tunnel reporting node, relays the ICMP message to the outer tunnel entry-point following the mechanisms described in sections 8.,8.1, 8.2, and 8.3. Further, the outer tunnel entry-point relays the ICMP message to the source of the original packet, following the same mechanisms. 9. Security Considerations An IPv6 tunnel can be secured by securing the IPv6 path between the tunnel entry-point and exit-point node. The security architecture, mechanisms, and services are described in RFC2401">[RFC2401], RFC2402">[RFC2402], and RFC2406">[RFC2406]. A secure IPv6 tunnel may act as a gateway-to-gateway secure path as described in RFC2401">[RFC2401]. For a secure IPv6 tunnel, in addition to the mechanisms described earlier in this document, the entry-point node of the tunnel performs security algorithms on the packet and prepends as part of the tunnel headers one or more security headers in conformance with [IPv6-Spec], RFC2401">[RFC2401], and RFC2402">[RFC2402], or RFC2406">[RFC2406]. Conta & Deering Standards Track [Page 30] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 The exit-point node of a secure IPv6 tunnel performs security algorithms and processes the tunnel security header[s] as part of the tunnel headers processing described earlier, and in conformance with RFC2401">[RFC2401], and RFC2402">[RFC2402], or RFC2406">[RFC2406]. The exit-point node discards the tunnel security header[s] with the rest of the tunnel headers after tunnel headers processing completion. The degree of integrity, authentication, and confidentiality and the security processing performed on a tunnel packet at the entry-point and exit-point node of a secure IPv6 tunnel depend on the type of security header - authentication (AH) or encryption (ESP) - and parameters configured in the Security Association for the tunnel. There is no dependency or interaction between the security level and mechanisms applied to the tunnel packets and the security applied to the original packets which are the payloads of the tunnel packets. In case of nested tunnels, each inner tunnel may have its own set of security services, independently from those of the outer tunnels, or of those between the source and destination of the original packet. 10. Acknowledgments This document is partially derived from several discussions about IPv6 tunneling on the IPng Working Group Mailing List and from feedback from the IPng Working Group to an IPv6 presentation that focused on IPv6 tunneling at the 33rd IETF, in Stockholm, in July 1995. Additionally, the following documents that focused on tunneling or encapsulation were helpful references: RFC 1933 (R. Gilligan, E. Nordmark), RFC 1241 (R. Woodburn, D. Mills), RFC 1326 (P. Tsuchiya), RFC 1701, RFC 1702 (S. Hanks, D. Farinacci, P. Traina), RFC 1853 (W. Simpson), as well as RFC 2003 (C. Perkins). Brian Carpenter, Richard Draves, Bob Hinden, Thomas Narten, Erik Nordmark (in alphabetical order) gave valuable reviewing comments and suggestions for the improvement of this document. Scott Bradner, Ross Callon, Dimitry Haskin, Paul Traina, and James Watt (in alphabetical order) shared their view or experience on matters of concern in this document. Judith Grossman provided a sample of her many years of editorial and writing experience as well as a good amount of probing technical questions. 11. References [IPv6-Spec] Deering, S. and R. Hinden, "Internet Protocol Version 6 (IPv6) Specification", RFC 2460, December 1998. Conta & Deering Standards Track [Page 31] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 [ICMP-Spec] Conta, A. and S. Deering "Internet Control Message Protocol for the Internet Protocol Version 6 (IPv6)", RFC 2463, December 1998. [ND-Spec] Narten, T., Nordmark, E., and W. Simpson "Neighbor Discovery for IP Version 6 (IPv6)", RFC 2461, December 1998. [PMTU-Spec] McCann, J., Deering, S. and J. Mogul, "Path MTU Discovery for IP Version 6 (IPv6)", RFC 1981, August 1996. RFC2401">[RFC2401] Atkinson, R., "Security Architecture for the Internet Protocol", RFC 2401, November 1998. RFC2402">[RFC2402] Atkinson, R., "IP Authentication Header", RFC 2402, November 1998. RFC2406">[RFC2406] Atkinson, R., "IP Encapsulation Security Payload (ESP)", RFC 2406, November 1998. RFC-1853">[RFC-1853] Simpson, W., "IP in IP Tunneling", RFC 1853, October 1995. [Assign-Nr] Reynolds, J. and J. Postel, "Assigned Numbers", STD 2, RFC 1700, October 1994. See also: http://www.iana.org/numbers.html RFC2119">[RFC2119] Bradner, S., "Key words for use in RFCs to indicate Requirement Levels", BCP 14, RFC 2119, March 1997. Authors' Addresses Alex Conta Lucent Technologies Inc. 300 Baker Ave Concord, MA 01742-2168 +1-978-287-2842 EMail: aconta@lucent.com Stephen Deering Cisco Systems 170 West Tasman Dr San Jose, CA 95132-1706 Phone: +1-408-527-8213 EMail: deering@cisco.com Conta & Deering Standards Track [Page 32] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 Appendix A A.1 Risk Factors in Nested Encapsulation Nested encapsulations of a packet become a recursive encapsulation if the packet reenters an outer tunnel before exiting it. The cases which present a high risk of recursive encapsulation are those in which a tunnel entry-point node cannot determine whether a packet that undergoes encapsulation reenters the tunnel before exiting it. Routing loops that cause tunnel packets to reenter a tunnel before exiting it are certainly the major cause of the problem. But since routing loops exist, and happen, it is important to understand and describe, the cases in which the risk for recursive encapsulation is higher. There are two significant elements that determine the risk factor of routing loop recursive encapsulation: (a) the type of tunnel, (b) the type of route to the tunnel exit-point, which determines the packet forwarding through the tunnel, that is, over the tunnel virtual-link. A.1.1 Risk Factor in Nested Encapsulation - type of tunnel. The type of tunnels which were identified as a high risk factor for recursive encapsulation in routing loops are: "inner tunnels with identical exit-points". Since the source and destination of an original packet is the main information used to decide whether to forward a packet through a tunnel or not, a recursive encapsulation can be avoided in case of a single tunnel (non-inner), by checking that the packet to be encapsulated is not originated on the entry-point node. This mechanism is suggested in RFC-1853">[RFC-1853]. However, this type of protection does not seem to work well in case of inner tunnels with different entry-points, and identical exit- points. Inner tunnels with different entry-points and identical exit-points introduce ambiguity in deciding whether to encapsulate a packet, when a packet encapsulated in an inner tunnel reaches the entry-point node of an outer tunnel by means of a routing loop. Because the source of the tunnel packet is the inner tunnel entry-point node which is different than the entry-point node of the outer tunnel, the source Conta & Deering Standards Track [Page 33] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 address checking (mentioned above) fails to detect an invalid encapsulation, and as a consequence the tunnel packet gets encapsulated at the outer tunnel each time it reaches it through the routing loop. A.1.2 Risk Factor in Nested Encapsulation - type of route. The type of route to a tunnel exit-point node has been also identified as a high risk factor of recursive encapsulation in routing loops. One type of route to a tunnel exit-point node is a route to a specified destination node, that is, the destination is a valid specified IPv6 address (route to node). Such a route can be selected based on the longest match of an original packet destination address with the destination address stored in the tunnel entry-point node routing table entry for that route. The packet forwarded on such a route is first encapsulated and then forwarded towards the tunnel exit-point node. Another type of route to a tunnel exit-point node is a route to a specified prefix-net, that is, the destination is a valid specified IPv6 prefix (route to net). Such a route can be selected based on the longest path match of an original packet destination address with the prefix destination stored in the tunnel entry-point node routing table entry for that route. The packet forwarded on such a route is first encapsulated and then forwarded towards the tunnel exit-point node. And finally another type of route to a tunnel exit-point is a default route, or a route to an unspecified destination. This route is selected when no-other match for the destination of the original packet has been found in the routing table. A tunnel that is the first hop of a default route is a "default tunnel". If the route to a tunnel exit-point is a route to node, the risk factor for recursive encapsulation is minimum. If the route to a tunnel exit-point is a route to net, the risk factor for recursive encapsulation is medium. There is a range of destination addresses that will match the prefix the route is associated with. If one or more inner tunnels with different tunnel entry-points have exit-point node addresses that match the route to net of an outer tunnel exit-point, then a recursive encapsulation may occur if a tunnel packet gets diverted from inside such an inner tunnel to the entry-point of the outer tunnel that has a route to its exit-point that matches the exit-point of an inner tunnel. Conta & Deering Standards Track [Page 34] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 If the route to a tunnel exit-point is a default route, the risk factor for recursive encapsulation is maximum. Packets are forwarded through a default tunnel for lack of a better route. In many situations, forwarding through a default tunnel can happen for a wide range of destination addresses which at the maximum extent is the entire Internet minus the node's link. As consequence, it is likely that in a routing loop case, if a tunnel packet gets diverted from an inner tunnel to an outer tunnel entry-point in which the tunnel is a default tunnel, the packet will be once more encapsulated, because the default routing mechanism will not be able to discern differently, based on the destination. Conta & Deering Standards Track [Page 35] RFC 2473 Generic Packet Tunneling in IPv6 December 1998 Full Copyright Statement Copyright (C) The Internet Society (1998). All Rights Reserved. This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the Internet Society or other Internet organizations, except as needed for the purpose of developing Internet standards in which case the procedures for copyrights defined in the Internet Standards process must be followed, or as required to translate it into languages other than English. The limited permissions granted above are perpetual and will not be revoked by the Internet Society or its successors or assigns. This document and the information contained herein is provided on an "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Conta & Deering Standards Track [Page 36]