Skip to main content

Two-Way Active Measurement Protocol (TWAMP) Data Model
draft-ietf-ippm-twamp-yang-00

The information below is for an old version of the document.
Document Type
This is an older version of an Internet-Draft that was ultimately published as RFC 8913.
Authors Ruth Civil , Al Morton , Lianshu Zheng , Reshad Rahman , Mahesh Jethanandani , Kostas Pentikousis
Last updated 2016-03-21
Replaces draft-cmzrjp-ippm-twamp-yang
RFC stream Internet Engineering Task Force (IETF)
Formats
Reviews
Additional resources Mailing list discussion
Stream WG state WG Document
Associated WG milestone
Oct 2017
submit a Standards Track document to the IESG for a YANG model for managing TWAMP clients and servers
Document shepherd (None)
IESG IESG state Became RFC 8913 (Proposed Standard)
Consensus boilerplate Unknown
Telechat date (None)
Responsible AD (None)
Send notices to (None)
draft-ietf-ippm-twamp-yang-00
6MAN Working Group                                           A. Petrescu
Internet-Draft                                                 CEA, LIST
Intended status: Standards Track                      September 24, 2018
Expires: March 28, 2019

                The length of the IPv6 link-local prefix
                  draft-petrescu-6man-ll-prefix-len-01

Abstract

   The length of the IPv6 link-local prefix is 64 decimal.

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 March 28, 2019.

Copyright Notice

   Copyright (c) 2018 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.

Petrescu                 Expires March 28, 2019                 [Page 1]
Internet-Draft                IPv6-LL-plen                September 2018

Table of Contents

   1.  Statement . . . . . . . . . . . . . . . . . . . . . . . . . .   2
   2.  Terminology . . . . . . . . . . . . . . . . . . . . . . . . .   2
   3.  Context . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
   4.  Security Considerations . . . . . . . . . . . . . . . . . . .   3
   5.  IANA Considerations . . . . . . . . . . . . . . . . . . . . .   4
   6.  Contributors  . . . . . . . . . . . . . . . . . . . . . . . .   4
   7.  Acknowledgements  . . . . . . . . . . . . . . . . . . . . . .   4
   8.  Normative References  . . . . . . . . . . . . . . . . . . . .   4
   Appendix A.  ChangeLog  . . . . . . . . . . . . . . . . . . . . .   4
   Author's Address  . . . . . . . . . . . . . . . . . . . . . . . .   5

1.  Statement

   The length of the IPv6 link-local prefix is 64 decimal.

   The IPv6 link-local prefix is represented textually "fe80::/64".

   The illustration of the IPv6 link-local prefix is:

     |
     |    64 bits, the link-local prefix  |          64 bits           |
     +----------+-------------------------+----------------------------+
     |1111111010000000000000...00000000000|       interface ID         |
     +----------+-------------------------+----------------------------+

                   Figure 1: The IPv6 link-local prefix

2.  Terminology

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
   document are to be interpreted as described in RFC 2119 [RFC2119].

   prefix: a contiguous string of bits valid for forwarding operations
   and for subnet formation.

   textual representation of a prefix: e.g. fe80::/64.

   n leading bits: the first n bits in a string of bits read from left
   to right in a writing system that is read left-to-right.  E.g. the 10
   leading bits of the fe80::/64 textual representation of the IPv6
   link-local prefix are 1111111010.

Petrescu                 Expires March 28, 2019                 [Page 2]
Internet-Draft                IPv6-LL-plen                September 2018

3.  Context

   The RFC "IPv6 Address Archi" illustrates the format of the link-local
   addresses.  From the illustration it MAY be understood that the
   length of the link-local prefix is 10 bits of value 1111111010 and 54
   0 bits.

   IANA lists the "IPv6 prefix", and "Address Block", to be "fe80::/10"
   on its website.  It is possible that in the future the IETF could
   decide to use the bits 11-53.

   The RFC 2464 "IPv6-over-Ethernet" states that the prefix for link-
   local addresses is "fe80::/64".

   RFC 6874, "Representing IPv6 Zone Identifiers in Address Literals and
   Uniform Resource Identifiers" specifies the link-local addresses to
   be under prefix "fe80::/1".

   Several knowledgeable interpretations state that, generally speaking,
   the prefix length of link-local addresses is 10, but it is 64 in the
   particular case of Stateless Address-Autoconfiguration (SLAAC).  In
   this latter case, the prefix is named a "subnet prefix", or "prefix
   on a link", and it is "fe80::/64".

   Implementations of an IPv6 stack in a particular operating system
   allow for the manual configuration of both prefix lengths 64 and 10
   for link-local addresses.  In another operating system the prefix
   length for link-local addresses can not be explicitely specified by
   the end user, but may be indirectly derived from two distinct textual
   formats by using an unspecified rule.

   Misconfigurations and lack of interoperability MAY arise between
   computers that use mixed prefix lengths for link-local addresses.

   A memo describes the use of IPv6 link-local addresses in
   applications.  The filename of the Internet Draft is draft-smith-
   ipv6-link-locals-apps-00.

   Historical note: earlier, the link-local prefix fe80::/10 and site-
   local prefix fec0::/10 were grouped into a common fe80::/9.  If bits
   10-64 were 0 then the prefix was a link-local, otherwise a site-
   local.  The site-local addresses were later deprecated by RFC 3879.

4.  Security Considerations

   The clarification of the definition of the prefix length of the IPv6
   link-local prefix at IANA is: call it 'leading bits' and not
   'prefix', or state that the IPv6 prefix length of link-local

Petrescu                 Expires March 28, 2019                 [Page 3]
Internet-Draft                IPv6-LL-plen                September 2018

   addresses is 10 decimal.  This clarification has beneficial impact in
   the algorithm implementation for calculation of the opaque and stable
   Interface Identifiers for IPv6 link-local addresses.  It also
   positively impacts some implementations of IPv6 forwarding.

5.  IANA Considerations

   IANA is requested to change the name of the column head in the table
   that depicts the "Internet Protocol Version 6 Address Space".  The
   name should be "The n leading bits of an address" instead of "IPv6
   Prefix".

   The desired effect of this change is that the IPv6 link-local prefix
   be "fe80::/64" and that the 10 leading bits of this prefix be
   1111111010.  A second effect is that the textual representation
   "fe80::/10" as an IPv6 link-local prefix should disappear from that
   IANA page, because it is wrong.

6.  Contributors

   Listed from 6man WG discussion.

7.  Acknowledgements

   The following persons are acknowledged for the discussion that is
   reflected in this draft.  Not all points are reflected.  Some points
   are copied almost entirely.

   Ole Troan, Scott Timothy Morizot, Brian Carpenter, Fred Baker, Mark
   Smith, Peter Occil, Philip Homburg, Albert Manfredi, _–3/4
   ’BAE, Fernando Gont, Christian Huitema.

8.  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,
              <https://www.rfc-editor.org/info/rfc2119>.

Appendix A.  ChangeLog

   The changes are listed in reverse chronological order, most recent
   changes appearing at the top of the list.

Petrescu                 Expires March 28, 2019                 [Page 4]
Internet-Draft                IPv6-LL-plen                September 2018

gt;

Civil, et al.          Expires September 22, 2016              [Page 55]
Internet-Draft            TWAMP YANG Data Model               March 2016

            <twamp-reflector-test-session>
               <sender-ip>10.1.1.1</sender-ip>
               <sender-udp-port>4000</sender-udp-port>
               <reflector-ip>10.1.1.2</reflector-ip>
               <reflector-udp-port>5000</reflector-udp-port>
               <sid>1232</sid>
               <parent-connection-client-ip>
                  203.0.113.1
               </parent-connection-client-ip>
               <parent-connection-client-tcp-port>
                  16341
               </parent-connection-client-tcp-port>
               <parent-connection-server-ip>
                  203.0.113.2
               </parent-connection-server-ip>
               <parent-connection-server-tcp-port>
                  862
               </parent-connection-server-tcp-port>
               <dscp>32</dscp>
               <sent-packets>2</sent-packets>
               <rcv-packets>2</rcv-packets>
               <last-sent-seq>1</last-sent-seq>
               <last-rcv-seq>1</last-rcv-seq>
            </twamp-reflector-test-session>
            <twamp-reflector-test-session>
               <sender-ip>203.0.113.1</sender-ip>
               <sender-udp-port>4001</sender-udp-port>
               <reflector-ip>192.68.0.2</reflector-ip>
               <reflector-udp-port>5001</reflector-udp-port>
               <sid>178943</sid>
               <parent-connection-client-ip>
                  203.0.113.1
               </parent-connection-client-ip>
               <parent-connection-client-tcp-port>
                  16341
               </parent-connection-client-tcp-port>
               <parent-connection-server-ip>
                  203.0.113.2
               </parent-connection-server-ip>
               <parent-connection-server-tcp-port>
                  862
               </parent-connection-server-tcp-port>
               <dscp>32</dscp>
               <sent-packets>21</sent-packets>
               <rcv-packets>21</rcv-packets>
               <last-sent-seq>20</last-sent-seq>
               <last-rcv-seq>20</last-rcv-seq>
            </twamp-reflector-test-session>

Civil, et al.          Expires September 22, 2016              [Page 56]
Internet-Draft            TWAMP YANG Data Model               March 2016

         </twamp-session-reflector>
      </twamp>
   </data>

Appendix B.  TWAMP Operational Commands

   This document is targeted at configuration details for TWAMP.
   Operational actions such as how TWAMP sessions are started/stopped,
   how results are retrieved, or stored results are cleared, and so on,
   are not addressed by this configuration model and are out of scope of
   this document.

   TWAMP operational commands could be performed programmatically or
   manually, e.g. using a command-line interface (CLI).  With respect to
   programmability, YANG can be used to define NETCONF Remote Procedure
   Calls (RPC), therefore it would be possible to define RPC operations
   for actions such as starting or stopping control or test sessions or
   groups of sessions; retrieving results; clearing stored results, and
   so on.

   However, [RFC5357] does not attempt to describe such operational
   actions, and it is likely that different TWAMP implementations could
   support different sets of operational commands, with different
   restrictions.  Therefore, this document considers it the
   responsibility of the individual implementation to define its
   corresponding TWAMP operational commands data model.

Authors' Addresses

   Ruth Civil
   Ciena Corporation
   307 Legget Drive
   Kanata, ON  K2K 3C8
   Canada

   Email: gcivil@ciena.com
   URI:   www.ciena.com

Civil, et al.          Expires September 22, 2016              [Page 57]
Internet-Draft            TWAMP YANG Data Model               March 2016

   Al Morton
   AT&T Labs
   200 Laurel Avenue South
   Middletown,, NJ  07748
   USA

   Phone: +1 732 420 1571
   Fax:   +1 732 368 1192
   Email: acmorton@att.com
   URI:   http://home.comcast.net/~acmacm/

   Lianshu Zheng
   Huawei Technologies
   China

   Email: vero.zheng@huawei.com

   Reshad Rahman
   Cisco Systems
   2000 Innovation Drive
   Kanata, ON  K2K 3E8
   Canada

   Email: rrahman@cisco.com

   Mahesh Jethanandani
   Cisco Systems
   3700 Cisco Way
   San Jose, CA  95134
   USA

   Email: mjethanandani@gmail.com

   Kostas Pentikousis (editor)
   Berlin
   Germany

   Email: pentikousis@gmail.com

Civil, et al.          Expires September 22, 2016              [Page 58]