Network Working Group M. Richardson
INTERNET DRAFT S. Wright
Expires August 2001 S. Hares
NextHop
February 2001
Definitions of Managed Objects
for the Communities Attribute of Border
Gateway Protocol (BGP-4)
<draft-richardson-bgp4-communities-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 Communities" [RFC1997].
2. Overview
These objects are used to control and manage a BGP-4 implementation
that supports the Communities attribute defined in [RFC1997]. This MIB
extends a table defined in [BGP-MIB]: the BGP-4 Received Path Attribute
Table.
The BGP Communities MIB is composed of the following primary objects:
- bgp4CommTable { bgp 10 1 }
A list of communities received with each route.
3. Definitions
BGP-COMMUNITIES-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
IpAddress, mib-2
FROM SNMPv2-SMI
MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
FROM SNMPv2-CONF
bgp
FROM BGP-MIB;
bgpCommunities 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 973-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 communities attribute defined
in BGP Communities."
REFERENCE
"RFC 1997 - BGP Communities Attribute"
::= { bgp 10 }
bgp4CommTable OBJECT-TYPE
SYNTAX SEQUENCE OF Bgp4CommEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The BGP-4 Communities Table contains information about
the communities received with a route."
::= { bgpCommunities 1 }
bgp4CommEntry OBJECT-TYPE
SYNTAX Bgp4CommEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
AUGMENTS { bgp4PathAttrTable }
::= { bgp4CommTable 1 }
Bgp4CommEntry ::= SEQUENCE {
bgp4PathAttrComm
OCTET STRING
}
bgp4PathAttrComm OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(0..4096))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A list of 4-octet long values, each representing a
community. Size zero (0) indicates the absence of
such attributes. Octets beyond the maximum size, if
any, are not recorded by this object. There are certain
4-octet long values that carry additional semantics."
REFERENCE
"RFC 1997 - BGP Communities Attribute"
::= { bgp4CommEntry 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.
[RFC1997] Chandra, R., Traina, P., "BGP Communities Attribute",
RFC-1997, August 1996.
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
Sue 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