Network Working Group
Request for Comments: 4446
BCP: 116
Category: Best Current Practice
L. Martini
Cisco Systems Inc.
April 2006

IANA Allocations for Pseudowire Edge to Edge Emulation (PWE3)

Status of This Memo

This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements. Distribution of this memo is unlimited.

Copyright Notice

Copyright © The Internet Society (2006).

Abstract

This document allocates the fixed pseudowire identifier and other fixed protocol values for protocols that have been defined in the Pseudo Wire Edge to Edge (PWE3) working group. Detailed IANA allocation instructions are also included in this document.

Table of Contents

   1. Introduction ....................................................2
   2. Specification of Requirements ...................................2
   3. IANA Considerations .............................................2
      3.1. Expert Review Directives ...................................2
      3.2. MPLS Pseudowire Type .......................................3
      3.3. Interface Parameters Sub-TLV Type ..........................4
      3.4. Attachment Identifiers .....................................5
           3.4.1. Attachment Individual Identifier Type ...............5
           3.4.2. Attachment Group Identifier (AGI) Type ..............5
      3.5. Pseudowire Status ..........................................6
      3.6. PW Associated Channel Type .................................6
   4. Security Considerations .........................................7
   5. References ......................................................7
      5.1. Normative References .......................................7
      5.2. Informative References .....................................7

1. Introduction

Most of the new IANA registries and respective IANA-allocation processes for protocols defined in the PWE3 IETF working group can be found in this document. The IANA registries defined here are in general subdivided into three main ranges: a range to be allocated by IETF consensus according to [RFC2434], a range to be allocated by the expert review process according to [RFC2434], and a range to be allocated on a first come, first served basis that is reserved for vendor proprietary allocations. Note that vendor proprietary types MUST NOT be registered for IETF standards or extensions thereof, whether they are still in development or already completed.

2. Specification of Requirements

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].

3. IANA Considerations

IANA has created several registries as described in the following paragraphs. Each of these registries contains numeric values used to identify data types. In each of these registries, the value of 0 is reserved and MUST not be used.

3.1. Expert Review Directives

Throughout this document, allocation procedures for several registries call for an expert review process according to [RFC2434]. The expert should consider the following points:

  • Duplication of code point allocations should be avoided.
  • A brief, clear description of the code point allocation requested should be provided.
  • The type allocation requested should be appropriate for the particular requested value range in the registry.

The expert reviewing the request MUST approve or disapprove the request within 10 business days from when he or she received the expert review request.

3.2. MPLS Pseudowire Type

IANA has set up the registry of "MPLS Pseudowire Type". This type has 15-bit values. PW Type values 1 through 30 are specified in this document, and PW Type values 31 through 1024 are to be assigned by IANA, using the "Expert Review" policy defined in [RFC2434]. PW Type values 1025 through 4096 and 32767 are to be allocated using the IETF consensus policy defined in [RFC2434]. PW Type values 4097 through 32766 are reserved for vendor-proprietary extensions and are to be assigned by IANA, using the "First Come First Served" policy defined in [RFC2434]. A Pseudowire Type description is required for any assignment from this registry. Additionally, for the vendor- proprietary extensions range, a citation of a person or company name is also required. A document reference should also be provided.

Initial Pseudowire Type value allocations are specified below:

   PW type Description                                      Reference
   ===================================================================
   0x0001  Frame Relay DLCI ( Martini Mode )                [FRAME]
   0x0002  ATM AAL5 SDU VCC transport                       [ATM]
   0x0003  ATM transparent cell transport                   [ATM]
   0x0004  Ethernet Tagged Mode                             [ETH]
   0x0005  Ethernet                                         [ETH]
   0x0006  HDLC                                             [PPPHDLC]
   0x0007  PPP                                              [PPPHDLC]
   0x0008  SONET/SDH Circuit Emulation Service Over MPLS    [CEP]
   0x0009  ATM n-to-one VCC cell transport                  [ATM]
   0x000A  ATM n-to-one VPC cell transport                  [ATM]
   0x000B  IP Layer2 Transport                              [RFC3032]
   0x000C  ATM one-to-one VCC Cell Mode                     [ATM]
   0x000D  ATM one-to-one VPC Cell Mode                     [ATM]
   0x000E  ATM AAL5 PDU VCC transport                       [ATM]
   0x000F  Frame-Relay Port mode                            [FRAME]
   0x0010  SONET/SDH Circuit Emulation over Packet          [CEP]
   0x0011  Structure-agnostic E1 over Packet                [SAToP]
   0x0012  Structure-agnostic T1 (DS1) over Packet          [SAToP]
   0x0013  Structure-agnostic E3 over Packet                [SAToP]
   0x0014  Structure-agnostic T3 (DS3) over Packet          [SAToP]
   0x0015  CESoPSN basic mode                               [CESoPSN]
   0x0016  TDMoIP AAL1 Mode                                 [TDMoIP]
   0x0017  CESoPSN TDM with CAS                             [CESoPSN]
   0x0018  TDMoIP AAL2 Mode                                 [TDMoIP]
   0x0019  Frame Relay DLCI                                 [FRAME]

3.3. Interface Parameters Sub-TLV Type

IANA has to set up the registry of "Pseudowire Interface Parameter Sub-TLV types". This type has 8-bit values. Sub-TLV types 1 through 12 are specified in this document. Sub-TLV types 13 through 64 are to be assigned by IANA, using the "Expert Review" policy defined in [RFC2434]. Sub-TLV types 65 through 127 and 255 are to be allocated using the IETF consensus policy defined in [RFC2434]. Sub-TLV types values 128 through 254 are reserved for vendor-proprietary extensions and are to be assigned by IANA, using the "First Come First Served" policy defined in [RFC2434].

Any assignments requested from this registry require a description of up to 54 characters.

For each allocation, a length field MUST also be specified in one of the following formats:

- Text as follows:"up to X", where X is a decimal integer. - Up to 3 different decimal integers.

The text "up to X" means up to and including X.

Additionally, for the vendor-proprietary extensions range, a citation of a person or company name is also required. A document reference should also be provided.

Initial Pseudowire Interface Parameter Sub-TLV type allocations are specified below:

Parameter  Length       Description                       Reference
 ID
========================================================================
 0x01      4       Interface MTU in octets               [CRTL]
 0x02      4       Maximum Number of concatenated ATM cells [ATM]
 0x03   up to 82   Optional Interface Description string [CRTL][RFC2277]
 0x04      4       CEP/TDM Payload Bytes                 [CEP][TDMoIP]
 0x05      4       CEP options                           [CEP]
 0x06      4       Requested VLAN ID                     [ETH]
 0x07      6       CEP/TDM bit-rate                      [CEP][TDMoIP]
 0x08      4       Frame-Relay DLCI Length               [FRAME]
 0x09      4       Fragmentation indicator               [FRAG]
 0x0A      4       FCS retention indicator               [FCS]
 0x0B    4/8/12    TDM options                           [TDMoIP]
 0x0C      4       VCCV parameter                        [VCCV]

Note that the Length field is defined as the length of the Sub-TLV, including the Sub-TLV type and length field itself.

3.4. Attachment Identifiers

3.4.1. Attachment Individual Identifier Type

IANA has to set up the registry of "Attachment Individual Identifier (AII) Type". This type has 8-bit values. AII Type value 1 is defined in this document. AII Type values 2 through 64 are to be assigned by IANA, using the "Expert Review" policy defined in [RFC2434]. AII Type values 65 through 127 and 255 are to be allocated using the IETF consensus policy defined in [RFC2434]. AII types values 128 through 254 are reserved for vendor-proprietary extensions and are to be assigned by IANA, using the "First Come First Served" policy defined in [RFC2434].

Any assignments requested from this registry require a description of up to 54 characters.

For each allocation, a length field MUST also be specified as a decimal integer.

Additionally, for the vendor-proprietary extensions range, a citation of a person or company name is also required. A document reference should also be provided.

Initial Attachment Individual Identifier (AII) Type allocations are specified below:

   AII Type     Length    Description                          Reference
   =====================================================================
   0x01         4         A 32 bit unsigned number local       [SIG]
                          identifier.

3.4.2. Attachment Group Identifier (AGI) Type

IANA has to set up the registry of "Attachment Group Identifier (AGI) Type". This type has 8-bit values. AGI Type value 1 is defined in this document. AGI Type values 2 through 64 are to be assigned by IANA, using the "Expert Review" policy defined in [RFC2434]. AGI Type values 65 through 127 and 255 are to be allocated using the IETF consensus policy defined in [RFC2434]. AGI type values 128 through 254 are reserved for vendor-proprietary extensions and are to be assigned by IANA, using the "First Come First Served" policy defined in [RFC2434].

Any assignments requested from this registry require a description of up to 54 characters.

For each allocation, a length field MUST also be specified as a decimal integer.

Additionally, for the vendor-proprietary extensions range, a citation of a person or company name is also required. A document reference should also be provided.

Initial Attachment Group Identifier (AGI) Type allocations are specified below:

   AGI Type     Length    Description                        Reference
   
    ===================================================================
    0x01         8         AGI encoded as Route Distinguisher [SIG]

3.5. Pseudowire Status

IANA has to set up the registry of "Pseudowire Status Codes". These are bit strings of length 32. Status bits 0 through 4 are defined in this document. Status bits 5 through 31 are to be assigned by IANA using the "Expert Review" policy defined in [RFC2434].

Any requests for allocation from this registry require a description of up to 65 characters.

Initial Pseudowire Status Code value allocations are as follows:

   Bit Mask     Description
   ====================================================================
   0x00000000 - Pseudowire forwarding (clear all failures)       [CRTL]
   0x00000001 - Pseudowire Not Forwarding                        [CRTL]
   0x00000002 - Local Attachment Circuit (ingress) Receive Fault [CRTL]
   0x00000004 - Local Attachment Circuit (egress) Transmit Fault [CRTL]
   0x00000008 - Local PSN-facing PW (ingress) Receive Fault      [CRTL]
   0x00000010 - Local PSN-facing PW (egress) Transmit Fault      [CRTL]

For the definition of the "PW Associated Channel Type" please refer to [RFC4385].

3.6 PW Associated Channel Type

For the definition of the "PW Associated Channel Type", please refer to [RFC4385].

4. Security Considerations

This document specifies only fixed identifiers, and not the protocols used to carry the encapsulated packets across the network. Each such protocol may have its own set of security issues, but those issues are not affected by the identifiers specified herein.

5. References

5.1. Normative References

   [RFC2434] Narten, T. and H. Alvestrand, "Guidelines for Writing an
             IANA Considerations Section in RFCs", BCP 26, RFC 2434,
             October 1998.
   
   [RFC2277] Alvestrand, H., "IETF Policy on Character Sets and
             Languages", BCP 18, RFC 2277, January 1998.
   
   [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
             Requirement Levels", BCP 14, RFC 2119, March 1997.

5.2. Informative References

   [CRTL]    Martini, L., Ed., Rosen, E., El-Aawar, N., Smith, T., and
             G. Heron, "Pseudowire Setup and Maintenance Using the Label
             Distribution Protocol (LDP)", RFC 4447, April 2006.
   
   [VCCV]    Nadeau, T. and R. Aggarwal, "Pseudo Wire Virtual Circuit
             Connectivity Verification (VCCV)", Work in Progress, August
             2005.
   
   [FRAG]    Malis, A. and M. Townsley, "PWE3 Fragmentation and
             Reassembly", Work in Progress, September 2005.
   
   [FCS]     Malis, A., Allan, D., and N. Del Regno, "PWE3 Frame Check
             Sequence Retention", Work in Progress, September 2005.
   
   [CEP]     Malis, A., Pate, P., Cohen, R., Ed., and D. Zelig,
             "SONET/SDH Circuit Emulation Service Over Packet (CEP)",
             Work in Progress.
   
   [SAToP]   Vainshtein, A. Ed. and Y. Stein, Ed. "Structure-Agnostic
             TDM over Packet (SAToP)", Work in Progress.
   
   [FRAME]   Martini, L., Ed. and C. Kawa, "Encapsulation Methods for
             Transport of Frame Relay Over MPLS Networks", Work in
             Progress.
   
   [ATM]     Martini, L., Ed., El-Aawar, N., and M. Bocci, Ed.,
             "Encapsulation Methods for Transport of ATM Over MPLS
             Networks", Work in Progress.
   
   [PPPHDLC] Martini, L., Rosen, E., Heron, G. and A. Malis,
             "Encapsulation Methods for Transport of PPP/HDLC Frames
             Over MPLS Networks", Work in Progress.
   
   [ETH]     Martini, L., Rosen, E., El-Aawar, N., and G. Heron,
             "Encapsulation Methods for Transport of Ethernet Frames
             Over MPLS Networks", RFC 4448, April 2006.
   
   [CESoPSN] Vainshtein, A., Ed., Sasson, I., Metz, E., Frost, T., and
             P. Pate, "Structure-aware TDM Circuit Emulation Service
             over Packet Switched Network (CESoPSN)", Work in Progress.
   
   [TDMoIP]  Stein, Y., Shashoua, R., Insler, R., and M. Anavi, "TDM
             over IP", Work in Progress, February 2005.
   
   [RFC3032] Rosen, E., Tappan, D., Fedorkow, G., Rekhter, Y.,
             Farinacci, D., Li, T., and A. Conta, "MPLS Label Stack
             Encoding", RFC 3032, January 2001.
   
   [SIG]     Rosen, E., Luo, W., Davie, B., and V. Radoaca,
             "Provisioning, Autodiscovery, and Signaling in L2VPNs",
             Work in Progress, September 2005.
   
   [RFC4385] Bryant, S., Swallow, G., Martini, L., and D. McPherson,
             "Pseudowire Emulation Edge-to-Edge (PWE3) Control Word for
             Use over an MPLS PSN", RFC 4385, February 2006.

Author's Address

Luca Martini
Cisco Systems, Inc.
9155 East Nichols Avenue, Suite 400
Englewood, CO, 80112

EMail:

          lmartini@cisco.com

Full Copyright Statement

Copyright © The Internet Society (2006).

This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the authors retain all their rights.

This document and the information contained herein are provided on an "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM 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 Rights 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; nor does it represent that it has made any independent effort to identify any such rights. Information on the procedures with respect to rights in RFC documents can be found in BCP 78 and BCP 79.

Copies of IPR disclosures made to the IETF Secretariat 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 implementers or users of this specification can be obtained from the IETF on-line IPR repository at http://www.ietf.org/ipr.

The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights that may cover technology that may be required to implement this standard. Please address the information to the IETF at ietf-ipr@ietf.org.

Acknowledgement

Funding for the RFC Editor function is provided by the IETF Administrative Support Activity (IASA).