Network Working Group F. Templin, Ed. Internet-Draft The Boeing Company Intended status: Standards Track A. Whyman Expires: July 30, 2021 MWA Ltd c/o Inmarsat Global Ltd January 26, 2021 IPv6 Neighbor Discovery Overlay Multilink Network Interface (OMNI) Option draft-templin-6man-omni-option-07 Abstract This document defines a new IPv6 Neighbor Discovery (ND) option termed the "Overlay Multilink Network Interface (OMNI) Option". The OMNI option may appear in any IPv6 ND message type; it is processed by interface types that recognize the option and ignored by all other interface types. The option supports functions such as prefix registration and multilink coordination, and is extensible to support additional functions in the future. Status of This Memo This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet- Drafts is at https://datatracker.ietf.org/drafts/current/. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." This Internet-Draft will expire on July 30, 2021. Copyright Notice Copyright (c) 2021 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect Templin & Whyman Expires July 30, 2021 [Page 1] Internet-Draft IPv6 ND OMNI Option January 2021 to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2 2. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 2 3. The Overlay Multilink Network Interface (OMNI) IPv6 ND Option 3 3.1. Sub-Options . . . . . . . . . . . . . . . . . . . . . . . 4 3.1.1. Pad1 . . . . . . . . . . . . . . . . . . . . . . . . 5 3.1.2. PadN . . . . . . . . . . . . . . . . . . . . . . . . 6 3.1.3. Interface Attributes (Type 1) . . . . . . . . . . . . 6 4. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 7 5. Security Considerations . . . . . . . . . . . . . . . . . . . 8 6. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 8 7. References . . . . . . . . . . . . . . . . . . . . . . . . . 8 7.1. Normative References . . . . . . . . . . . . . . . . . . 8 7.2. Informative References . . . . . . . . . . . . . . . . . 9 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 9 1. Introduction This document defines a new IPv6 Neighbor Discovery (ND) option termed the "Overlay Multilink Network Interface (OMNI) Option". The OMNI option may appear in any IPv6 ND message type; it is processed by interface types that recognize the option and ignored by all other interface types. The option supports functions such as prefix registration and multilink coordination for interface types such as the OMNI interface [I-D.templin-6man-omni-interface], and is extensible to support additional functions in the future. The following sections discuss the OMNI option format and contents. Use cases appear in IPv6 over specific link layer documents such as [I-D.templin-6man-omni-interface], where the International Civil Aviation Organization (ICAO) has expressed interest in the option in support of their Document 9896 [ATN][ATN-IPS]. An IPv6 ND option Type number assignment is requested in the IANA Considerations section. 2. Terminology The terminology in the normative references applies. The term "underlying interface" refers to one of potentially multiple Layer-2 interfaces over which a Layer-3 (virtual) interface is configured. Templin & Whyman Expires July 30, 2021 [Page 2] Internet-Draft IPv6 ND OMNI Option January 2021 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 [RFC2119][RFC8174] when, and only when, they appear in all capitals, as shown here. 3. The Overlay Multilink Network Interface (OMNI) IPv6 ND Option An Overlay Multilink Network Interface (OMNI) IPv6 ND option is defined. The option (known as the "OMNI option") is formatted as shown in Figure 1: 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 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Type | Length |T| Preflen | S/T-omIndex | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | ~ Sub-Options ~ | | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Figure 1: OMNI Option Format In this format: o Type is set to TBD. o Length is set to the number of 8 octet blocks in the option. o T is a 1-bit flag set to 1 if an address is temporary (otherwise, set to 0) and Preflen is a 7 bit field that determines the length of prefix to be applied to an address. Values 1 through 127 specify a prefix length, while the value 0 indicates a singleton address (i.e., a /128). For IPv6 ND messages sent from a node to a router, T and Preflen apply to the IPv6 source address. For IPv6 ND messages sent from the router to the node, T and Preflen apply to the IPv6 destination address. o S/T-omIndex is a 1-octet field that encodes a value between 0 and 255 identifying the source or target underlying interface for the IPv6 ND message. For RS and NS messages S/T-omIndex refers to the "Source" underlying interface over which the message is sent, while for RA and NA messages S/T-omIndex refers to the "Target" underlying interface that will receive the message. Templin & Whyman Expires July 30, 2021 [Page 3] Internet-Draft IPv6 ND OMNI Option January 2021 o Sub-Options is a Variable-length field, of length such that the complete OMNI Option is an integer multiple of 8 octets long. Contains one or more Sub-Options, as described in Section 3.1. The OMNI option may appear in any IPv6 ND message type; it is processed by interfaces that recognize the option and ignored by all other interfaces. If multiple OMNI option instances appear in the same IPv6 ND message, the interface processes the T, Preflen and S/ T-ifIndex fields in the first instance and ignores those fields in all other instances. The interface processes the Sub-Options of all OMNI option instances in the consecutive order in which they appear in the IPv6 ND message, beginning with the first instance and continuing consecutively through any additional instances to the end of the message. The OMNI option(s) in each IPv6 ND message may include full or partial information for the neighbor. The union of the information in the most recently received OMNI options is therefore retained, and the information is aged/removed in conjunction with the corresponding neighbor cache entry. 3.1. Sub-Options The OMNI option includes zero or more Sub-Options. Each consecutive Sub-Option is concatenated immediately after its predecessor. All Sub-Options except Pad1 (see below) are in type-length-value (TLV) encoded in the following format: 0 1 2 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 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+- | Sub-Type | Sub-length | Sub-Option Data ... +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+- Figure 2: Sub-Option Format o Sub-Type is a 6-bit field that encodes the Sub-Option type. Sub- Options defined in this document are: Option Name Sub-Type Pad1 0 PadN 1 Interface Attributes (Type 1) 2 Figure 3 Templin & Whyman Expires July 30, 2021 [Page 4] Internet-Draft IPv6 ND OMNI Option January 2021 Sub-Types 3-61 are available for future assignment. Sub-Type 62 is reserved for experimentation, as recommended in [RFC3692]. Sub-Type 63 is reserved by IANA. o Sub-Length is a 10-bit field that encodes the length of the Sub- Option Data (i.e., ranging from 0 to 1023 octets). o Sub-Option Data is a block of data with format determined by Sub- Type and length determined by Sub-Length. Note that Sub-Type and Sub-Length are coded together in network byte order in two consecutive octets. Note also that Sub-Option Data may be up to 1023 bytes in length. This allows ample space for encoding large objects (e.g., ascii character strings, security codes, etc.), while a single OMNI option is limited to 2048 bytes the same as for any IPv6 ND option. If the Sub-Options to be coded would cause the OMNI option to exceed 2048 bytes, any remaining Sub-Options are encoded in additional OMNI options in the consecutive order of intended processing. Implementations must therefore be mindful of size limitations, and must refrain from sending IPv6 ND messages larger than the OMNI interface MTU. During processing, unrecognized Sub-Options are ignored and the next Sub-Option processed until the end of the OMNI option is reached. The following Sub-Option types and formats are defined in this document (note that other documents that are active at the time of this writing will define additional Sub-Option types in the near future): 3.1.1. Pad1 0 0 1 2 3 4 5 6 7 +-+-+-+-+-+-+-+-+ | Sub-Type=0|x|x| +-+-+-+-+-+-+-+-+ Figure 4: Pad1 o Sub-Type is set to 0. If multiple instances appear in the same OMNI option all are processed. o Sub-Type is followed by two 'x' bits, set randomly on transmission and ignored on receipt. Pad1 therefore consists of a whole single octet with the most significant 6 bits set to 0, and with no Sub- Length or Sub-Option Data fields following. Templin & Whyman Expires July 30, 2021 [Page 5] Internet-Draft IPv6 ND OMNI Option January 2021 3.1.2. PadN 0 1 2 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 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+- | Sub-Type=1| Sub-length=N | N padding octets ... +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+- Figure 5: PadN o Sub-Type is set to 1. If multiple instances appear in the same OMNI option all are processed. o Sub-Length is set to N (from 0 to 1023) being the number of padding octets that follow. o Sub-Option Data consists of N padding octets that are typically zero-valued (any non-zero values that may appear in the padding octets are not to be interpreted in any way other than as simple padding). 3.1.3. Interface Attributes (Type 1) 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 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Sub-Type=2| Sub-length=N | omIndex | omType | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Provider ID | Link | Resvd |P00|P01|P02|P03|P04|P05|P06|P07| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |P08|P09|P10|P11|P12|P13|P14|P15|P16|P17|P18|P19|P20|P21|P22|P23| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |P24|P25|P26|P27|P28|P29|P30|P31|P32|P33|P34|P35|P36|P37|P38|P39| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |P40|P41|P42|P43|P44|P45|P46|P47|P48|P49|P50|P51|P52|P53|P54|P55| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |P56|P57|P58|P59|P60|P61|P62|P63| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Figure 6: Interface Attributes (Type 1) o Sub-Type is set to 2. If multiple instances with different omIndex values appear in the same OMNI option all are processed; if multiple instances with the same omIndex value appear, the first is processed and all others are ignored o Sub-Length is set to N (from 1 to 1023 that encodes the number of Sub-Option Data octets that follow. Templin & Whyman Expires July 30, 2021 [Page 6] Internet-Draft IPv6 ND OMNI Option January 2021 o omIndex is a 1-octet field containing a value from 0 to 255 identifying the underlying interface for which the interface attributes apply. o omType is a 1-octet field containing a value from 0 to 255 corresponding to the underlying interface identified by omIndex. o Provider ID is a 1-octet field containing a value from 0 to 255 corresponding to the underlying interface identified by omIndex. o Link encodes a 4-bit link metric. The value '0' means the link is DOWN, and the remaining values mean the link is UP with metric ranging from '1' ("lowest") to '15' ("highest"). o Resvd is reserved for future use. o A 16-octet ""Preferences" field immediately follows 'Resvd', with values P[00] through P[63] corresponding to the 64 Differentiated Service Code Point (DSCP) values [RFC2474]. Each 2-bit P[*] field is set to the value '0' ("disabled"), '1' ("low"), '2' ("medium") or '3' ("high") to indicate a QoS preference for underlying interface selection purposes. 4. IANA Considerations The IANA is instructed to allocate a Type number TBD from the registry "IPv6 Neighbor Discovery Option Formats" for the OMNI option (see: Section 13 of [RFC4861]) as a provisional registration in accordance with Section 4.13 of [RFC8126]. The OMNI option also defines an 8-bit Sub-Type field, for which IANA is instructed to create and maintain a new registry entitled "OMNI option Sub-Type values". Initial values for the OMNI option Sub-Type values registry are given below; future assignments are to be made through Expert Review [RFC8126]. Value Sub-Type name Reference ----- ------------- ---------- 0 Pad1 [RFCXXXX] 1 PadN [RFCXXXX] 2 Interface Attributes (Type 1) [RFCXXXX] 3-61 Unassigned 62 Experimental [RFCXXXX] 63 Reserved [RFCXXXX] Figure 7: OMNI Option Sub-Type Values Templin & Whyman Expires July 30, 2021 [Page 7] Internet-Draft IPv6 ND OMNI Option January 2021 5. Security Considerations Security considerations for IPv6 [RFC8200] and IPv6 Neighbor Discovery [RFC4861] apply. 6. Acknowledgements This document is aligned with the International Civil Aviation Organization (ICAO) Aeronautical Telecommunications Network (ATN) with Internet Protocol Services (ATN/IPS) development program. This document is aligned with the IETF 6man (IPv6) working group. 7. References 7.1. Normative References [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997, . [RFC3692] Narten, T., "Assigning Experimental and Testing Numbers Considered Useful", BCP 82, RFC 3692, DOI 10.17487/RFC3692, January 2004, . [RFC4861] Narten, T., Nordmark, E., Simpson, W., and H. Soliman, "Neighbor Discovery for IP version 6 (IPv6)", RFC 4861, DOI 10.17487/RFC4861, September 2007, . [RFC8126] Cotton, M., Leiba, B., and T. Narten, "Guidelines for Writing an IANA Considerations Section in RFCs", BCP 26, RFC 8126, DOI 10.17487/RFC8126, June 2017, . [RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, May 2017, . [RFC8200] Deering, S. and R. Hinden, "Internet Protocol, Version 6 (IPv6) Specification", STD 86, RFC 8200, DOI 10.17487/RFC8200, July 2017, . Templin & Whyman Expires July 30, 2021 [Page 8] Internet-Draft IPv6 ND OMNI Option January 2021 7.2. Informative References [ATN] Maiolla, V., "The OMNI Interface - An IPv6 Air/Ground Interface for Civil Aviation, IETF Liaison Statement #1676, https://datatracker.ietf.org/liaison/1676/", March 2020. [ATN-IPS] WG-I, ICAO., "ICAO Document 9896 (Manual on the Aeronautical Telecommunication Network (ATN) using Internet Protocol Suite (IPS) Standards and Protocol), Draft Edition 3 (work-in-progress)", December 2020. [I-D.templin-6man-omni-interface] Templin, F. and T. Whyman, "Transmission of IP Packets over Overlay Multilink Network (OMNI) Interfaces", draft- templin-6man-omni-interface-69 (work in progress), January 2021. [RFC2474] Nichols, K., Blake, S., Baker, F., and D. Black, "Definition of the Differentiated Services Field (DS Field) in the IPv4 and IPv6 Headers", RFC 2474, DOI 10.17487/RFC2474, December 1998, . Authors' Addresses Fred L. Templin (editor) The Boeing Company P.O. Box 3707 Seattle, WA 98124 USA Email: fltemplin@acm.org Tony Whyman MWA Ltd c/o Inmarsat Global Ltd 99 City Road London EC1Y 1AX England Email: tony.whyman@mccallumwhyman.com Templin & Whyman Expires July 30, 2021 [Page 9]