Network Working Group                                      M. Richardson
INTERNET DRAFT                                                 S. Wright
Expires August 2001                                             S. Hares
                                                                 NextHop
                                                           February 2001



                     Definitions of Managed Objects


             for the Extended Communities Attribute in Border


                        Gateway Protocol (BGP-4)


               <draft-richardson-bgp4-ext-comm-mib-00.txt>



Status of this Memo


   This document is an Internet-Draft and is in full conformance with
   all provisions of Section 10 of RFC 2026.


   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.


   The list of Internet-Draft Shadow Directories can be accessed at
   http://www.ietf.org/shadow.html.



Copyright Notice


   Copyright (C) The Internet Society (1999). All Rights Reserved.


Abstract


   This memo is an extension to the SNMP MIB.  It specifies an IAB
   standards track protocol for the Internet community, and requests
   discussion and suggestions for improvements.  This memo extends
   the MIB defined in [BGP-MIB].


   Distribution of this memo is unlimited.  Please forward comments to
   idr@merit.net.




1. Introduction


   This memo defines extensions to the MIB defined in [BGP-MIB].  In
   particular, it describes managed objects based upon attributes defined
   in "BGP Extended Communities Attribute" [BGP-EXTCOMM].


2. Overview


   These objects are used to control and manage a BGP-4 implementation
   that supports BGP Extended Communities [BGP-EXTCOMM].  This MIB extends
   one table defined in [BGP-MIB]:  the BGP-4 Received Path Attribute Table.

   This MIB defines the following primary objects:

    - bgp4ExtCommTable { bgp 13 1 }

      This table contains the set of extended communities received with each
      incoming route.


3. Definitions


    BGP4-EXT-COMM-MIB DEFINITIONS ::= BEGIN


        IMPORTS
            MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
            mib-2
                FROM SNMPv2-SMI
            MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
                FROM SNMPv2-CONF
            bgp
                FROM BGP-MIB;

        bgpExtComm MODULE-IDENTITY
            LAST-UPDATED "200102230000Z"
            ORGANIZATION "IETF IDR Working Group"
            CONTACT-INFO "E-mail:  idr@merit.net

                          Mathew Richardson (Author)
                          E-mail: mrr@nexthop.com
                          Shane Wright (Author)
                          E-mail: swright@nexthop.com
                          517 W. William Street
                          Ann Arbor, MI 48103-4943
                          Tel: +1 734 973-2200
                          Fax: +1 734 615-3241

                          Susan Hares  (Editor)
                          517 W. William Street
                          Ann Arbor, MI 48103-4943
                          Tel: +1 734 933-2200
                          Fax: +1 734 615-3241
                          E-mail: skh@nexthop.com"

            REVISION    "200102230000Z"
            DESCRIPTION
                    "Extension of the MIB module for BGP-4 to include
                     information about the Extended Communities attribute
                     associated with incoming routes."
            REFERENCE
                    "BGP-EXTCOMM - BGP Extended Communities Attribute"

            ::= { bgp 13 }


        bgp4ExtCommTable OBJECT-TYPE
            SYNTAX     SEQUENCE OF Bgp4ExtCommEntry
            MAX-ACCESS not-accessible
            STATUS     current
            DESCRIPTION
                    "BGP Extended Communities Table.  This table contains
                     information on the Extended Communities [BGP-EXTCOMM]
                     learned with incoming routes."
            REFERENCE
                    "RFC 1771 - Border Gateway Protocol version 4 (BGP4)"
            ::= { bgpExtComm 1 }


        bgp4ExtCommEntry OBJECT-TYPE
            SYNTAX     Bgp4ExtCommEntry
            MAX-ACCESS not-accessible
            STATUS     current
            DESCRIPTION
                    "Information about the Extended Communities [BGP-EXTCOMM]
                     learned with a route."
            AUGMENTS    { bgp4PathAttrTable }
            ::= { bgp4ExtCommTable 1 }


        Bgp4ExtCommEntry ::= SEQUENCE {
            bgp4PathAttrExtComm
                 OCTET STRING
        }

        bgp4PathAttrExtComm OBJECT-TYPE
            SYNTAX      OCTET STRING (SIZE(0..4096))
            MAX-ACCESS  read-only
            STATUS      current
            DESCRIPTION
                    "A sequence of values each eight octets long, and each
                     representing an extended community that was received
                     with the route.  The values of each of the individual
                     octets may have semantic meaning.  A length of zero (0)
                     indicates the absence of this attribute."
            REFERENCE
                    "BGP-EXTCOMM - BGP Extended Communities Attribute"
            ::= { bgp4ExtCommEntry 1 }

    END

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



5. Acknowledgements


   The authors would like to thank the following individuals without
   whom this document would never have been possible:

   J. Haas, NextHop Technologies


6. References

   [BGP-MIB]  Hares, S.,  Haas, J., "Definitions of Managed Objects for the
       Fourth Version of Border Gateway Protocol (BGP-4)",
       draft-ietf-idr-bgp4-mib-05.txt, December 2001.

   [BGP-EXTCOMM]  Ramachandra, S., Tappan, D., "BGP Extended Communities
       Attribute", draft-ramachandra-bgp-ext-communities-08.txt,
       February 2001.


7. Security Considerations


   Security considerations are beyond the scope of this document.  See
   [BGP-MIB] for a more detailed discussion of the security implications
   of this document.


8. Authors' Address


   Mathew Richardson
   NextHop Technologies
   517 W. William
   Ann Arbor, MI 48103-4943
   Phone: +1 734 973-2200
   Fax:   +1 734 615-3241
   Email: mrr@nexthop.com

   Shane Wright
   NextHop Technologies
   517 W. William
   Ann Arbor, MI 48103-4943
   Phone: +1 734 973-2200
   Fax:   +1 734 615-3241
   Email: swright@nexthop.com

   Susan Hares
   NextHop Technologies
   517 W. William
   Ann Arbor, MI 48103-4943
   Phone: +1 734 973-2200
   Fax:   +1 734 615-3241
   Email: skh@nexthop.com



9. Full Copyright Statement


   Copyright (C) The Internet Society (1999).  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
   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.

Expires August 2001