Network Working Group W. Mark Townsley Internet-Draft cisco Systems Category: Standards Track March 2004 HDLC Frames over L2TPv3 Status of this Memo This document is an Internet-Draft and is in full conformance with all provisions of Section 10 of RFC2026. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet- Drafts. 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." The list of current Internet-Drafts can be accessed at http://www.ietf.org/ietf/1id-abstracts.txt The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html. Copyright Notice Copyright (C) The Internet Society (2004). All Rights Reserved. Abstract The Layer 2 Tunneling Protocol, Version 3, (L2TPv3) defines a protocol for tunneling a variety of data link protocols over IP networks. This document describes the specifics of how to tunnel High Level Data Link Control (HDLC) frames over L2TPv3. Townsley Standards Track [Page 1] INTERNET DRAFT HDLC Frames over L2TPv3 March 2004 Contents Status of this Memo.......................................... 1 1. Introduction.............................................. 2 1.1 Abbreviations......................................... 3 2. Control Connection Establishment.......................... 3 3. HDLC Link Status Notification and Session Establishment... 3 3.1 L2TPv3 Session Establishment.......................... 3 3.2 L2TPv3 Session Teardown............................... 5 3.3 L2TPv3 Session Maintenance............................ 5 3.3 Use of Circuit Status AVP for HDLC.................... 5 4. Encapsulation............................................. 6 4.1 Data Packet Sequencing................................ 6 5. Security Considerations................................... 6 6. IANA Considerations....................................... 7 7. Acknowledgments........................................... 7 8. References................................................ 7 8.1 Normative References.................................. 7 8.2 Informative References................................ 7 9. Contacts.................................................. 7 Specification of Requirements In this document, several words are used to signify the requirements of the specification. These words are often capitalized. 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 [RFC2119]. 1. Introduction [L2TPv3] defines a base protocol for Layer 2 Tunneling over IP networks. This document defines the specifics necessary for tunneling HDLC Frames over L2TPv3. Such emulated circuits are referred to as HDLC Pseudowires (HDLCPWs). Protocol specifics defined in this document for L2TPv3 HDLCPWs include those necessary for simple point to point (e.g., between two Townsley Standards Track [Page 2] INTERNET DRAFT HDLC Frames over L2TPv3 March 2004 L2TPv3 nodes) frame encapsulation, and simple interface up and interface down notifications. The reader is expected to be very familiar with the terminology and protocol constructs defined in [L2TPv3]. 1.1 Abbreviations HDLCPW HDLC Pseudo-Wire LCCE L2TP Control Connection Endpoint (See [L2TPv3]) 2. Control Connection Establishment In order to tunnel an HDLC link over IP using L2TPv3, an L2TPv3 Control Connection MUST first be established as described in [L2TPv3]. The L2TPv3 SCCRQ Control Message and corresponding SCCRP Control Message MUST include the HDLC PW Type of TBD1 (See IANA Considerations Section), in the Pseudo Wire Capabilities List as defined in 5.4.3 of [L2TPv3]. This identifies the control connection as able to establish L2TP sessions to support HDLC Pseudo-Wires (HDLCPWs). An LCCE MUST be able to uniquely identify itself in the SCCRQ and SCCRP messages via a globally unique value. By default, this is advertised via the structured Router ID AVP [L2TPv3], though the unstructured Hostname AVP [L2TPv3] MAY be used if both endpoints support an application (as defined by the Application Code AVP [L2TPv3]) to identify LCCEs via this value. 3. HDLC Link Status Notification and Session Establishment This section specifies how the status of an HDLC interface is reported between two LCCEs, and the associated L2TP ssession creation and deletion that occurs. 3.1 L2TPv3 Session Establishment Associating an HDLC serial interface with a PW and its transition to "Ready" or "Up" results in the establishment of an L2TP session via the standard three-way handshake described in section 3.4.1 of [L2TPv3]. For purposes of this discussion, the action of locally associating an interface running HDLC with a PW by local configuration or otherwise is referred to as "provisioning" the HDLC interface. The transition of the interface to "ready" or "up" will be referred to as the interface becoming ACTIVE. The transition of the interface to "not-ready" or "down" will be referred to as the interfacing becoming INACTIVE. Townsley Standards Track [Page 3] INTERNET DRAFT HDLC Frames over L2TPv3 March 2004 An LCCE MAY initiate the session immediately upon association with an HDLC interface, or wait until the interface becomes ACTIVE before attempting to establish an L2TP session. The Circuit Status AVP (see Section 4) MUST be present in the ICRQ, ICRP messages and MAY be present in the SLI message for HDLCPWs. Following is an example of the L2TP messages exchanged for an HDLCPW which is initiated after an HDLC interface is provisioned and becomes ACTIVE. LCCE (LAC) A LCCE (LAC) B ------------------ ------------------ HDLC Interface Provisioned HDLC Interface Provisioned HDLC Interface ACTIVE ICRQ (status = 0x03) ----> HDLC Interface ACTIVE <---- ICRP (status = 0x03) L2TP session established, OK to send data into tunnel ICCN -----> L2TP session established, OK to send data into tunnel In the example above, an ICRQ is sent after the interface is provisioned and becomes ACTIVE. The Circuit Status AVP indicates that this link is ACTIVE and New (0x03). The Remote End ID AVP [L2TPv3] must be present in the ICRQ in order to identify the HDLC link (together with the identity of the LCCE itself as defined in section 2) to associate the L2TP session with. The Remote End ID AVP defined in [L2TPv3] is of opaque form and variable length, though one MUST at a minimum support use of an unstructured four-octet value that is known to both LCCEs (either by direct configuration, or some other means). The exact method of how this value is configured, retrieved, discovered, or otherwise determined at each LCCE is outside the scope of this document. As with the ICRQ, the ICRP is sent only after the associated HDLC interface transitions to ACTIVE as well. If LCCE B had not been provisioned for the interface identified in the ICRQ, a CDN would have been immediately returned indicating that the associated link was not provisioned or available at this LCCE. LCCE A should then Townsley Standards Track [Page 4] INTERNET DRAFT HDLC Frames over L2TPv3 March 2004 exhibit a periodic retry mechanism. The period and maximum number of retries MUST be configurable. An Implementation MAY send an ICRQ or ICRP before an HDLC interface is ACTIVE, as long as the Circuit Status AVP reflects that the link is INACTIVE and an SLI is sent when the PVC becomes ACTIVE (see Section 3.3). The ICCN is the final stage in the session establishment, confirming the receipt of the ICRP with acceptable parameters to allow bidirectional traffic. 3.2 L2TPv3 Session Teardown In the event a link is removed (unprovisioned) at either LCCE, the associated L2TP session MUST be torn down via the CDN message defined in Section 3.4.3 of [L2TPv3]. General Result Codes regarding L2TP session establishment are defined in [L2TPv3]. Additional HDLC result codes are defined as follows: TBD2: HDLC Link was deleted permanently (no longer provisioned) TBD3: HDLC Link has been INACTIVE for an extended period of time 3.3 L2TPv3 Session Maintenance HDLC PW over L2TP makes use of the Set Link Info (SLI) control message defined in [L2TPv3] to signal HDLC link status notifications between PEs. The SLI message is a single message that is sent over the L2TP control channel, signaling the interface state change. The SLI message MUST be sent any time there is a status change of any values identified in the Circuit Status AVP. The only exception to this is the initial ICRQ, ICRP and CDN messages which establish and teardown the L2TP session itself. The SLI message may be sent from either PE at any time after the first ICRQ is sent (and perhaps before an ICRP is received, requiring the peer to perform a reverse Session ID lookup). All sessions established by a given control connection utilize the L2TP Hello facility defined in [L2TPv3] for session keepalive. This gives all sessions basic dead peer and path detection between PEs. 3.3 Use of Circuit Status AVP for HDLC HDLC reports Circuit Status with the Circuit Status AVP defined in [L2TPv3]. For reference, this AVP is shown below: Townsley Standards Track [Page 5] INTERNET DRAFT HDLC Frames over L2TPv3 March 2004 0 1 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Reserved |A|N| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ The Value is a 16 bit mask with the two least significant bits defined and the remaining bits reserved for future use. Reserved bits MUST be set to 0 when sending, and ignored upon receipt. The A (Active) bit indicates whether the HDLC interface is ACTIVE (1) or INACTIVE (0). The N (New) bit SHOULD be set to one (1) if this is the first time this interface has transitioned to ACTIVE, zero (0) otherwise. 4. Encapsulation HDLC PWs use the default encapsulations defined in [L2TPv3] for demultiplexing, sequencing, and flags. The HDLC PW Type over L2TP is intended to operate in an "interface to interface" or "port to port" fashion, passing all HDLC data and control PDUs over the PW. The HDLC PDU is stripped of flags and trailing FCS, bit/byte unstuffing is performed, and the remaining data, including the address, control and protocol fields, transported over the PW. Since all packets are passed in a largely transparent manner over the HDLC PW, any protocol which has HDLC-like framing may utilize the HDLC PW mode, including PPP, Frame-Relay, X.25, etc. Exceptions include cases where direct access to the HDLC interface is required, or modes which operate on the flags, FCS, or bit/byte unstuffing that is performed before sending the HDLC PDU over the PW. An example of this is PPP ACCM negotiation. 4.1 Data Packet Sequencing Data Packet Sequencing MAY be enabled for HDLC PWs. The sequencing mechanisms described in [L2TPv3] MUST be used for signaling sequencing support. HDLC PW over L2TP MUST request the presence of the L2TPv3 Default L2-Specific Sublayer when sequencing is enabled, and MAY request its presence at all times. 5. Security Considerations HDLC over L2TPv3 is subject to the security considerations defined in [L2TPv3]. There are no additional considerations specific to carrying HDLC that are not present carrying other data link types. Townsley Standards Track [Page 6] INTERNET DRAFT HDLC Frames over L2TPv3 March 2004 6. IANA Considerations The signaling mechanisms defined in this document rely upon the assignment of an HDLC Pseudowire Type. IANA assignment of this value should take place within the PWE3 WG. 7. Acknowledgments Thanks to Sudhir Rustogi and George Wilkie for valuable input. 8. References 8.1 Normative References [L2TPv3] J. Lau, M. Townsley, I. Goyret, "Layer Two Tunneling Protocol (Version 3)", work in progress, draft-ietf-l2tpext-l2tp-base-10.txt, August 2003. [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997. 8.2 Informative References [BCP0068] Townsley, W., Layer Two Tunneling Protocol (L2TP) Internet Assigned Numbers Authority (IANA) Considerations Update", RFC3438, BCP0068, December 2002 9. Contacts W. Mark Townsley cisco Systems 7025 Kit Creek Road PO Box 14987 Research Triangle Park, NC 27709 mark@townsley.net Full Copyright Statement Copyright (C) The Internet Society (2004). 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 Townsley Standards Track [Page 7] INTERNET DRAFT HDLC Frames over L2TPv3 March 2004 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." Intellectual Property The IETF takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; neither does it represent that it has made any effort to identify any such rights. Information on the IETF's procedures with respect to rights in standards-track and standards-related documentation can be found in BCP-11 [RFC2028]. Copies of claims of rights made available for publication and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementors or users of this specification can be obtained from the IETF Secretariat. The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights which may cover technology that may be required to practice this standard. Please address the information to the IETF Executive Director. Townsley Standards Track [Page 8]