<?xml version="1.0" encoding="US-ASCII"?>
<!DOCTYPE rfc SYSTEM "rfc2629.dtd" [
<!-- One method to get references from the online citation libraries.
     There has to be one entity for each item to be referenced. 
     An alternate method (rfc include) is described in the references. -->

<!ENTITY RFC2119 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.2119.xml">
<!ENTITY RFC4271 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.4271.xml">
<!ENTITY RFC4272 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.4272.xml">
<!ENTITY RFC5492 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.5492.xml">
<!ENTITY RFC8174 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC.8174.xml">
<!ENTITY I-D.narten-iana-considerations-rfc2434bis SYSTEM "http://xml.resource.org/public/rfc/bibxml3/reference.I-D.narten-iana-considerations-rfc2434bis.xml">
]>
<?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?>
<?rfc strict="yes" ?>
<?rfc toc="no"?>
<?rfc tocdepth="4"?>
<?rfc symrefs="yes"?>
<?rfc sortrefs="yes" ?>
<?rfc compact="yes" ?>
<?rfc subcompact="no" ?>
<rfc category="std" docName="draft-ietf-idr-ext-opt-param-13" ipr="trust200902"
 updates="4271">

  <front>

    <title abbrev="Extended Optional Parameters Length">Extended
      Optional Parameters Length for BGP OPEN Message</title>

    <author fullname="Enke Chen" initials="E.C." 
            surname="Chen">
      <organization>Palo Alto Networks</organization>

      <address>
        <email>enchen@paloaltonetworks.com</email>
      </address>
    </author>

    <author fullname="John Scudder" initials="J.S." 
            surname="Scudder">
      <organization>Juniper Networks</organization>

      <address>
        <email>jgs@juniper.net</email>
      </address>
    </author>

    <date/>

    <area>General</area>

    <workgroup>IDR</workgroup>

    <keyword>IDR</keyword>
    <keyword>BGP</keyword>

    <abstract>
      <t>
The Optional Parameters in the BGP OPEN message as defined in the base
BGP specification are limited to 255 octets due to a one-octet length
field.  BGP Capabilities are carried in this field and may foreseeably
exceed 255 octets in the future, leading to concern about this
limitation.
      </t>
      <t>
This document updates RFC 4271 by extending, in a
backward-compatible manner, the length of the Optional Parameters in the
BGP OPEN. The Parameter Length field of individual Optional Parameters
is also extended.
      </t>
    </abstract>
  </front>

  <middle>
    <section title="Introduction">
      <t>
The Optional Parameters Length field in the BGP OPEN message is defined
in <xref target="RFC4271">the base BGP specification</xref> as one
octet, thus limiting the Optional Parameters field in the OPEN message
to 255 octets.  Since BGP Capabilities <xref target="RFC5492"></xref> are
carried in the Optional Parameters field, and new BGP capabilities
continue to be introduced, the limitation is a concern for BGP
development.
      </t>
      <t>
This document updates <xref target="RFC4271"/> by extending, in a
backward-compatible manner, the length of the Optional Parameters in BGP
OPEN. This is done by using Optional Parameter Type 255 as a
distinguished value, that indicates an extended Optional Parameters
Length field follows and that the parsing of the BGP OPEN should be
modified according to these procedures.  In this case the Parameter Length 
field of the individual Optional Parameters in the BGP OPEN message is 
also extended.
      </t>

      <section title="Requirements Language">
        <t>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 <xref target="RFC2119"/> <xref
        target="RFC8174"/> when, and only when,
        they appear in all capitals, as shown here.</t>
      </section>
    </section>

    <section anchor="protocol_extensions" title="Update to RFC 4271">
      <t>
This document reserves Optional Parameter Type code 255 as the "Extended
Length" type code.
      </t>
      <t>
In the event that the length of Optional Parameters in the BGP OPEN
message does not exceed 255, the encodings of <xref target="RFC4271">the
base BGP specification</xref> SHOULD be used without alteration.
Configuration MAY override this to force the extended format to be used
in all cases; this might be used, for example to test that a peer
supports this specification. (In any case, an implementation MUST accept
an OPEN message that uses the encoding of this specification even if the
length of Optional Parameters is 255 or less.)
      </t>
      <t>
However, if the length of Optional Parameters in the BGP OPEN message 
does exceed 255, the OPEN message MUST be encoded according to the 
procedure below.
	  </t>
      <figure title="Extended Encoding OPEN Format" anchor="open_fmt">
        <artwork><![CDATA[
       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
       +-+-+-+-+-+-+-+-+
       |    Version    |
       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
       |     My Autonomous System      |
       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
       |           Hold Time           |
       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
       |                         BGP Identifier                        |
       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
       |Non-Ext OP Len.|Non-Ext OP Type|  Extended Opt. Parm. Length   |
       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
       |                                                               |
       |             Optional Parameters (variable)                    |
       |                                                               |
       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
        ]]></artwork>
      </figure>
      <t>
The Non-Extended Optional Parameters Length field (Non-Ext OP Len)
SHOULD be set to 255 on transmission and in any event MUST NOT be set to
0, and MUST be ignored on receipt once the use of the extended format is
determined positively by inspection of the Non-Extended Optional
Parameters Type (Non-Ext OP Type) field.
	  </t>
	  <t>
The subsequent one-octet field (that would be the first Optional
Parameter Type field in the non-extended format, and is called "Non-Ext
OP Type" in the figure above) MUST be set to 255 on transmission. On
receipt, a value of 255 for this field is the indication that the
extended format is in use.
      </t>
      <t>
In this extended encoding, the subsequent two-octet field, termed
the Extended Optional Parameters Length field, is an unsigned
integer indicating the total length of the Optional Parameters field
in octets.  If the value of this field is zero, no Optional
Parameters are present.
	  </t>
      <t>
Likewise, in that situation the Optional Parameters encoding is modified
to be the following:
      </t>
      <figure title="Extended Parameters Format" anchor="parm_fmt">
        <artwork><![CDATA[
    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
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    |  Parm. Type   |        Parameter Length       |
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    ~            Parameter Value (variable)         ~
    |                                               |
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
        ]]></artwork>
      </figure>
      <t>
The rules for encoding Optional Parameters are unchanged with respect
to those given in <xref target="RFC4271"/> other than the extension
of the Parameter Length field to be a two-octet unsigned integer.
      </t>
      <t>
In parsing an OPEN message, if the one-octet "Optional Parameters
Length" field (labeled "Non-Ext OP Len." in <xref
target="open_fmt"/>) is non-zero, a BGP speaker
MUST use the value of the octet following the one-octet "Optional
Parameters Length" field (labeled "Non-Ext OP Type" in <xref
target="open_fmt"/>) to determine both the encoding of the Optional
Parameters length and the size of the "Parameter Length" field of
individual Optional Parameters.  If the value of the "Non-Ext OP Type"
field is 255, then the encoding described above is used for the Optional
Parameters length. Otherwise the encoding defined in <xref
target="RFC4271"></xref> is used.
      </t>
    </section>
    
    <section title="Backward Compatibility">
      <t>
If a BGP speaker supporting this specification (a "new speaker") is
peering with one which does not (an "old speaker") no interoperability
issues arise unless the new speaker needs to encode Optional Parameters
whose length exceeds 255.  In that case, it will transmit an OPEN
message which the old speaker will interpret as containing an Optional
Parameter with type code 255.  Since by definition the old speaker will
not recognize that type code, the old speaker is expected to close
the connection with a NOTIFICATION with an Error Code of OPEN Message
Error and an Error Subcode of Unsupported Optional Parameters, according
to Section 6.2 of <xref target="RFC4271"></xref>.
      </t>
      <t>
Although the Optional Parameter Type code 255 is used in this
specification as the indication that the extended encoding is in use, it
is not a bona fide Optional Parameter Type in the usual sense, and MUST
NOT be used other than as described above. If encountered in any
position other than the first Optional Parameter Type, it MUST be
treated as an unrecognized Optional Parameter and handled according to
<xref target="RFC4271"/> Section 6.2.
	  </t> 
	  <t>
It is not considered an error to receive an OPEN message whose Extended
Optional Parameters Length value is less than or equal to 255. It is not
considered a fatal error to receive an OPEN message whose (non-extended)
Optional Parameters Length value is not 255, and whose first Optional
Parameter type code is 255 -- in this case the encoding of this
specification MUST be used for decoding the message. 
	  </t>
    </section>
    
    <section title="IANA Considerations">
      <t>
IANA is requested to designate type code 255 in the BGP OPEN Optional
Parameter Types registry as the Extended Length type code.
      </t>
    </section>
    
    <section title="Security Considerations">
      <t>
This extension to BGP does not change the underlying security or
confidentiality issues
inherent in the existing BGP <xref target="RFC4272"/>.
      </t>
    </section>
    
    <section title="Acknowledgements">
      <t>
The authors would like to thank Yakov Rekhter and Srihari Sangli for
discussing various options to enlarge the Optional Parameters field. We
would also like to thank Matthew Bocci, Bruno Decraene, John Heasley,
Jakob Heitz, Christer Holmberg, Pradosh Mohapatra, Keyur Patel and Hannes Gredler for their
valuable comments.
      </t>
    </section>
  </middle>

  <back>
    <references title="Normative References">
      &RFC2119;
      &RFC4271;
      &RFC8174;
    </references>

    <references title="Informative References">
      &RFC5492;
      &RFC4272;
    </references>
  </back>
</rfc>
