Network Working Group E. Horley Internet-Draft T. Coffeen Intended status: Informational S. Hogg Expires: November 4, 2021 HexaBuild N. Buraglio Energy Sciences Network K. Myers IP ArchiTechs C. Cummings Energy Sciences Network R. White Juniper Networks May 3, 2021 Expanding the IPv6 Address Prefix Reserved for Documentation draft-horley-v6ops-expand-doc-00 Abstract To reduce the likelihood of conflict and confusion when relating documented examples to deployed systems, an IPv6 unicast address prefix is reserved for use in examples in RFCs, books, documentation, and the like. This document adds an additional prefix to the existing reserved IPv6 prefixes, 2001:db8::/32. This document describes the use of the IPv6 address prefix 3ffe::/16 (formerly 6bone) as a reserved prefix for use in documentation. 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 November 4, 2021. Horley, et al. Expires November 4, 2021 [Page 1] Internet-DrExpanding the IPv6 Address Prefix Reserved for Doc May 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 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. Expanded Documentation IPv6 Address Prefix . . . . . . . . . 2 3. Operational Implications . . . . . . . . . . . . . . . . . . 2 4. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 3 5. Security Considerations . . . . . . . . . . . . . . . . . . . 3 6. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 3 7. References . . . . . . . . . . . . . . . . . . . . . . . . . 3 7.1. Normative References . . . . . . . . . . . . . . . . . . 3 7.2. Informative References . . . . . . . . . . . . . . . . . 4 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 4 1. Introduction The address architecture for IPv6 [RFC4291] does not specifically allocate an IPv6 address prefix for use for documentation purposes. The current IPv6 documentation prefix of 2001:db8::/32 defined in [RFC6890] is not large enough for many design, lab, and documentation requirements. An example of this limitation is apparent when doumenting a multi-provder ISP network address plan. An additional, larger allocation would help address these needs. 2. Expanded Documentation IPv6 Address Prefix The additional prefix allocated for documentation purposes is 3ffe::/16. 3. Operational Implications This assignment implies that IPv6 network operators should add this address prefix to the list of non-routeable, bogon IPv6 address space, and if packet filters are deployed, this address prefix should Horley, et al. Expires November 4, 2021 [Page 2] Internet-DrExpanding the IPv6 Address Prefix Reserved for Doc May 2021 be added to packet filters intended to prevent public routing of such address space. Because this address prefix has previously been used for the 6bone, and subsequently the 6bone was shutdown, this address prefix is already listed in many non-routeable tables, filters and lists. It was also depreferred in [RFC6724] which limits its usability. In addition, the address prefix was returned to IANA and is available to be marked for documentation purposes. This is not a local-use address prefix, and the filters may be used in both local and public contexts. 4. IANA Considerations IANA is to record the allocation of the IPv6 global unicast address prefix 3ffe::/16 as a documentation-only prefix in the IPv6 address registry. No end party is to be assigned this address. 5. Security Considerations IPv6 addressing documents generally do not have any direct impact on Internet infrastructure security. However, the assignment of a new address space for documentation purposes does mean, as indicated above, that these addresses SHOULD be added to any filters required by individual operators to prevent their use for globally routed destinations. 6. Acknowledgements The authors acknowledge the work of Geoff Huston, assisted by Anne Lord, and Philip Smith, in authoring the previous proposal for the IPv6 documentation prefix. 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, . [RFC3513] Hinden, R. and S. Deering, "Internet Protocol Version 6 (IPv6) Addressing Architecture", RFC 3513, DOI 10.17487/RFC3513, April 2003, . Horley, et al. Expires November 4, 2021 [Page 3] Internet-DrExpanding the IPv6 Address Prefix Reserved for Doc May 2021 [RFC4291] Hinden, R. and S. Deering, "IP Version 6 Addressing Architecture", RFC 4291, DOI 10.17487/RFC4291, February 2006, . 7.2. Informative References [RFC3306] Haberman, B. and D. Thaler, "Unicast-Prefix-based IPv6 Multicast Addresses", RFC 3306, DOI 10.17487/RFC3306, August 2002, . [RFC6724] Thaler, D., Ed., Draves, R., Matsumoto, A., and T. Chown, "Default Address Selection for Internet Protocol Version 6 (IPv6)", RFC 6724, DOI 10.17487/RFC6724, September 2012, . [RFC6890] Cotton, M., Vegoda, L., Bonica, R., Ed., and B. Haberman, "Special-Purpose IP Address Registries", BCP 153, RFC 6890, DOI 10.17487/RFC6890, April 2013, . Authors' Addresses Ed Horley HexaBuild Email: ed@hexabuild.io Tom Coffeen HexaBuild Email: tom@hexabuild.io Scott Hogg HexaBuild Email: scott@hexabuild.io Nick Buraglio Energy Sciences Network Email: buraglio@es.net Horley, et al. Expires November 4, 2021 [Page 4] Internet-DrExpanding the IPv6 Address Prefix Reserved for Doc May 2021 Kevin Myers IP ArchiTechs Email: kevin.myers@iparchitechs.com Chris Cummings Energy Sciences Network Email: chriscummings@es.net Russ White Juniper Networks Email: russ@riw.us Horley, et al. Expires November 4, 2021 [Page 5]