Inter-Domain Routing Working Group                         J. Haas
Internet Draft                                             NextHop
                                                          S. Hares
                                                           NextHop
                                                      W. Tackabury
                                              Gold Wire Technology

                                                November 21, 2001

                                                February 28, 2002

                     Definitions of Managed Objects
       for the Fourth Version of Border Gateway Protocol (BGP-4),
                             Second Version
                   <draft-ietf-idr-bgp4-mibv2-01.txt>
                   <draft-ietf-idr-bgp4-mibv2-02.txt>

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 mate-
   rial 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 (2001). (2002).  All Rights Reserved.

Abstract

   This memo defines a portion of the Management Information Base (MIB)
   for use with network management protocols in TCP/IP-based internets.
   In particular, this MIB defines objects that facilitate the
   management of the Border Gateway Protocol Version 4 (BGP4).

   Distribution of this memo is unlimited.

1.  Introduction

   This memo defines a portion of the Management Information Base (MIB)
   for use with network management protocols in the Internet community.
   In particular, it describes managed objects used for managing the
   Border Gateway Protocol Version 4.

   The SNMP Management Framework presently consists of five major compo-
   nents:

     o    An overall architecture, described in RFC 2571 [1].

     o    Mechanisms for describing and naming objects and events for
          the purpose of management. The first version of this Structure
          of Management Information (SMI) is called SMIv1 and described
          in STD 16, RFC 1155 [2], STD 16, RFC 1212 [3] and RFC 1215
          [4]. The second version, called SMIv2, is described in STD 58,
          RFC 2578 [5], RFC 2579 [6] and RFC 2580 [7].

     o    Message protocols for transferring management information. The
          first version of the SNMP message protocol is called SNMPv1
          and described in STD 15, RFC 1157 [8]. A second version of the
          SNMP message protocol, which is not an Internet standards
          track protocol, is called SNMPv2c and described in RFC 1901
          [9] and RFC 1906 [10]. The third version of the message proto-
          col is called SNMPv3 and described in RFC 1906 [10], RFC 2572
          [11] and RFC 2574 [12].

     o    Protocol operations for accessing management information. The
          first set of protocol operations and associated PDU formats is
          described in STD 15, RFC 1157 [8]. A second set of protocol
          operations and associated PDU formats is described in RFC 1905
          [13].

     o    A set of fundamental applications described in RFC 2573 [14]
          and the view-based access control mechanism described in RFC
          2575 [15].

   A more detailed introduction to the current SNMP Management Framework
   can be found in RFC 2570 [18].

   Managed objects are accessed via a virtual information store, termed
   the Management Information Base or MIB. Objects in the MIB are
   defined using the mechanisms defined in the SMI.

2.  Objectives

   This MIB Module is meant to broadly update and replace a prior MIB
   Module defined in RFC 1657 [12].  Additionally, there is another
   effort underway to address very specific limited objectives in updat-
   ing points in the RFC 1657 object definition and managed object
   attributes [13].  The MIB Module described herein is intended to
   fully serve the functions and scope of RFC 1657 and these RFC 1657
   updates.

2.1.  Protocol Extensions

   Additionally, however, there are a number of ways in which the BGP
   Protocol has been enhanced through its ability for added capabili-
   ties. Implementations of those capabilities have not been able to
   have any management capabilities present in RFC 1657-compliant MIB
   module agents, since the capabilities themselves postdated the adop-
   tion of RFC 1657.  For several significant capabilities, in the form
   of BGP Communities [17], Autonomous System Confederation [16] , BGP
   Multiprotocol Extensions [18], and Route Reflection [19], the MIB
   Module defined in this document exposes object types to manage those
   extended capabilities and their operation.

   One of these extensions in particular (the multiprotocol extensions)
   requires a thorough redefinition of MIB table row indices from the
   RFC 1657 state.  This allows transport-independent address indices
   consistent with the Address Family Identifier (AFI) and Subsequent
   Address Family Identifier (SAFI) mechanisms of that extension.

2.2.  Mechanisms for MIB Extensibility

   Moreover, the requirement for the incremental update of support for
   capabilities such as these begs the issue of placing modular extensi-
   bility for protocol extensions within the framework of the MIB
   itself.  Going forward, it would be very desirable to have attributes
   of the MIB structure, and administrative procedures, to allow the
   incremental update of the MIB scope to cover any such new protocol
   extensions, without requiring a reissue of the entire MIB.  In this
   sense, we seek to structure the MIB much like the underlying BGP4
   itself, allowing capability-by-capability update.

2.3.  BGP Configuration

   Finally, the definition and adoption of Version 3 of the SNMP has
   occurred since the adoption of the RFC 1657 MIB.  As a result, the
   ability to deploy secure configuration of managed elements via SNMP
   in a standardized way has become a reality for managed networks.  In
   this MIB definition effort, we seek to expose a more thorough capac-
   ity for configuration of BGP4 and its capabilities than was present
   in RFC 1657 or than was common practice at the time of its adoption.

3.  MIB Organization

   The MIB is broken down into several top level sections.  This sec-
   tionalization is important to create an organization for extensibil-
   ity.

   In general, a top level section of the MIB module will identify some
   number of "core" scalar and tabular objects rooted off of it.  If
   there is sufficient depth within a subsection of one of these top-
   level sections, the "core" subdivision off of the top level section
   may provide multiple levels to the OBJECT IDENTIFIER scope necessary
   to define its management data.

   Once this core section is defined, however, each top-level section
   has an explicit provision for an 'extensions' section OBJECT IDENTI-
   FIER.  The intent of the extensions section is to be containment for
   discrete per-extension sections.  By 'extension' here, we refer to
   protocol mechanisms, capabilities, and exchanges which are not
   defined in the base Border Gateway Protocol definition, or is not
   configuration for protocol operations of similarly 'core' status.
   Currently, we propose keying the identification within the per-exten-
   sion section in one of two ways.

   Where the extension is keyed to a defined capability which has an
   associated BGP capability number assiged assigned by IANA (for example, multi-
   protocol mul-
   tiprotocol BGP extensions), the per extension section will be that
   defined IANA capability number.  Where the extension has management
   information suitable for a MIB extension but does not correspond to
   an exchanged protocol capability (for example, BGP Route Reflection),
   the extension section shall have its final OBJECT IDENTIFIER fragment
   correspond to the RFC number which first uniquely defined the exten-
   sion (i.e., not requiring renumbering at the time a defining RFC for
   a protocol mechanism is outdated by a later RFC).

3.1.  bgpBaseScalars  bgpM2BaseScalars

   The bgpBaseScalars bgpM2BaseScalars section (and corresponding OBJECT IDENTIFIER) is
   used to delineate object types used for basic management and monitor-
   ing of the protocol implementation.   These are core parameters for
   the local configuration.  While notifications are designed to be
   extensible into any other section in the MIB module, the currently
   defined traps are located here, in a subsection 'bgpBaseNotifica- 'bgpM2BaseNotifica-
   tions'.  This is rooted at index level zero (0) here, owing to con-
   ventions established in [4].

   Support for multiple concurrently supported versions of BGP is
   exposed through the entries of the bgpVersionTable. bgpM2VersionTable.  Similarly, sup-
   port
   support for multiple capabilities and authentication mechanisms, as
   identified by their assigned numbers, are reported in the bgpSupport-
   edCapabilitiesTable bgpM2Sup-
   portedCapabilitiesTable and bgpSupportedAuthTable bgpM2SupportedAuthTable respectively.

   In the MIB document, there are currently basic scalar extension mech-
   anisms mechanisms
   to allow the agent to report membership of a local BGP Confed-
   eration Confederation
   [21] or Route Reflection Cluster ID [24]. [24], as well as whether these
   capabilities are in fact supported by the implementation.  These are consis-
   tent
   consistent with the non-capability based extension section indexing guide-
   lines
   guidelines as presented above.

   bgpM2BaseScalars also is the root for a subsection, bgpM2BaseScalar-
   Configuration, which contains the companion configuration objects for
   the base scalar objects delineated in the preceding paragraphs.
   These are presented as a series of scalar read-write objects, with a
   single OBJECT-TYPE of syntax StorageType to designate the persistence
   of the instance value data for these configuration scalars.

3.2.  bgpPeerData  bgpM2PeerData

   The bgpPeerData bgpM2PeerData section is per-peer object type definitions. The pre-
   dominant
   predominant table of read-only STATUS object types in that section (bgpPeerTable)
   (bgpM2PeerTable) describes the session, negotiation state, and
   authentication state on a per peer basis.  A second table (bgpPrefixCountersTable) (bgpM2Pre-
   fixCountersTable) exposes information about indi-
   vidual individual route prefixes
   received over each peer session.  A separate subsection and its subordinate sub-
   ordinate table (bgpPeerErrorsTable) (bgpM2PeerErrorsTable) reports information about the
   last error encountered on a given peering ses-
   sion. session.

   Further subsections report authentication state with the peer peer, peer-
   ing session detected errors,  and elapsed time it has taken to
   advance the peering session into various states defined in the protocol proto-
   col FSM.

   The bgpPeerConfiguredTimersTable bgpM2PeerConfiguredTimersTable reports and allows dynamic reset
   of key timers on the peer session.  These currently allow reset of
   hold time and keepalive timer, for compatibility wity with the same capabili-
   ties capa-
   bilities in RFC 1657 [17]. For these resettable timers, their end-to-end end-to-
   end negotiated current values are reflected in the bgpPeerNegotiated-
   TimersTable. bgpM2PeerNegotiat-
   edTimersTable.

   As currently defined, these tables describing authentication, error
   state, and timer values (in addition to the configuration tables for
   session timers) are tightly coupled enough to the logical per-row
   view exposed in the bgpM2PeerTable row entries on a session that
   these subordinate "tables" are defined as AUGMENTing the
   bgpM2PeerTable itself.  The other primary design criterion behind
   this decision is that using this AUGMENTation does not increase the
   per-row-data requirements of bgpM2PeerTable instance retrieval so as
   to make such per-row retrieval unwieldy for the management applica-
   tion.

3.2.1.  bgpPeerCapabilities

   bgpPeerCapabilitiesData  bgpM2PeerCapabilities

   bgpM2PeerCapabilitiesData has objects and tables to describe BGP capa-
   bilities
   capabilities locally supported, and those reported and negotiated
   over each peer session.   For tables supporting each of these capability capa-
   bility sets, capability code and data value are provided.  Attention
   must be given to the fact that multiple instances of a given capability capabil-
   ity can be transmitted between BGP speakers.

3.2.2.  bgpPeerCounters  bgpM2PeerCounters

   The bgpCountersTable bgpM2CountersTable and bgpPrefixCountersTable bgpM2PrefixCountersTable report protocol
   exhanges/FSM
   exchanges/FSM transitions, and discrete number of NLRIs exchanged per
   peering session, respectively.  This is independent of actual
   exhanged
   exchanged path attributes, which are tabularized later in the MIB mod-
   ule.
   module.  Note that session transitions as reflected in changes of
   instances within this table may also be reflected in issuance of
   bgpM2Established and bgpM2BackwardTransition NOTIFICATION-TYPE PDUs.

3.2.3.  Peering Data Extensions

   Route reflector status on a per-peer basis (whether the peer is a
   client or nonClient of  the local BGP router's reflected route propa-
   gation), and peer confederation membership is reported in non capa-
   bility extensions of the peering data section.

3.3.  BGP Routing Information Base Data

   An important table for providing index information for other tables
   in the

3.2.4.  Configuring Peering Sessions

   The MIB module is the bgpNlriTable.  This discriminates has several tables indexed on a given
   network prefix (by AFI/SAFI), per-peer level of granularity
   to control creation and the peer which advertised the pre-
   fix (since it can be heard activation of from multiple spakers).  The bgpPathAt-
   trIndex column which identifies each new peering sessions, and to
   allow control on running sessions (those reflected in bgpM2PeerTable
   row instances) regardless of what caused their creation in this table is used as an
   index for other per-attribute tables through the remainder of the MIB
   module.

   The bgpPathAttrTable provides discrete BGP NLRI attributes which were
   recieved with the advertisement
   routing process.

   The bgpM2CfgPeerAdminStatusTable allows creation and specification of the prefix
   a row by its advertising
   peer.  Specific information about the autonomous system path (AS
   Path) advertised with the NLRI, on a per AS value, bgpM2PeerIndex value (which is to be found in
   the bgpAsPathTable.

   Finally, where attributes which were unable to be reported in the
   bgpPathAttrTable, the AS Path table, or any defined per-NLRI tables how its associated row
   instance is identified in the agent were recieved with bgpM2PeerTable).  For each such row
   instance, the prefix, those attributes are
   reported via set of the bgpPathAttrUnknownTable.  Short bgpM2CfgPeerAdminStatus OBJECT-TYPE of advertised
   attribute type, no semantic breakdown MAX-
   ACCESS read-write can allow management application start and stop of
   the unknown attribute data
   is provided.  That data session.

   This is only available as a raw OCTET STRING in contrasted with the bgpPathAttrUnknownValue column function of this table.

3.3.1.  Routing Information Base Extensions

   There are two extension sections the bgpM2CfgPeerTable, and five subordinate
   its related AUGMENTed tables bgpM2CfgPeerTimersTable and bgpM2Cfg-
   PeerAuthTable.  These are used to facilitate direct creation of peer-
   ing sessions by the management application.  The function of columnar
   OBJECT-TYPEs within the
   bgp4PathAttrTable bgpM2CfgPeerTable for local and RIB data OBJECT IDENTIFIER-delimited MIB module
   section. remote
   address, version negotiation, and various row-administrative
   attributes (RowStatus and StorageType SYNTAXes) are straightforward
   enough.  The bgpPathAttrRouteReflectionExts only subtlety with respect to how peering sessions are
   activated from usage of this table, and its contained bgp-
   PathAttrOriginatorIdTable report on how the originating route reflector.
   The bgpPathAttrClusterTable specifically reports on activated sessions
   are reflected through their bgpM2PeerTable and bgpM2CfgPeerAdminSta-
   tusTable entries, is in the reflection
   route usage of the bgpM2CfgPeerTable columnar
   object bgpM2CfgPeerStatus.  bgpM2CfgPeerStatus can take on two val-
   ues.  When a NLRI peering session, as reflected through its row instance
   in the bgpM2CfgPeerTable, has traversed the bgpM2CfgPeerStatus instance value
   in that row set to get running(2) at the time of the SYNTAX RowStatus
   object instance of bgpM2CfgPeerRowEntryStatus set to active(1), the
   peering session will in fact be activated in the local BGP routing process.

   The bgpPathAttrCommunityExts section deals with extended and non-
   exteded communities for network routes.  The bgpPathAttrCommTable
   bgpPathAttrExtCommTable  contained herein report community membership
   (if any) on a per network-prefix basis.

3.4.  Consideration On Table Indexing

   There are certain efficiency concerns for row index management for
   management applications which are useful process
   (in addition to take into consideration,
   given having its row instance created in the nature of some bgpM2Cfg-
   PeerTable and bgpM2CfgPeerAdminStatusTable).  In this case, the asso-
   ciated row of the tables implied bgpM2CfgPeerAdminStatusTable row bgpM2CfgPeerAdmin-
   Status instance would have the value of start(2).  If, in the preceding sec-
   tion.

   In prior
   example, the first place, it bgpM2CfgPeerStatus is valuable to exploit halted(1) at the direct relationship time of entries in, for example, the bgpPrefixCountersTable as they relate
   bgpM2CfgPeerRowEntryStatus instance set to active(1), only the entry in peer-
   ing table entries would be created at this time of activation, with-
   out the bgpPeerTable to which they are related.  More
   compelling is peering session being automatically started.  The bgpM2Cfg-
   PeerAdminStatusTable row bgpM2CfgPeerAdminStatus instance associated
   with the session would in this case reflect a value of stop(1).

   Since the one-to-many relationship between a row
   entry in the bgpPeerTable and the bgp4PathAttrTable, the latter entries of the per-peer configuration tables which maintains per-row entries for potentially many NLRIs as
   received from a peer in a BGP UPDATE message.  From AUG-
   MENT the point of view
   of normalizing these relationships, it would be useful to have a
   direct reference to bgpM2CfgPeerTable logically fate-share the "governing" bgpPeerTable row entry for instances in
   the
   peer bgpM2CfgPeerTable which is a "dependency" for they are AUGMENTing, they also share the subordinate
   same StorageType and RowStatus SYNTAX object sense of the
   bgpM2CfgPeerTable rows which they augment.

3.3.  BGP Routing Information Base Data

   An important table row entry for providing index information for other peer data.

   Second, tables
   in the nature of protocol-independent addressing makes MIB module is the
   indexing of these entries indirectly even more compelling.  Even
   accounting for the addressing requirements of IPv6 bgpM2NlriTable.  This discriminates on a
   given network prefix (by AFI/SAFI), and the provision
   of AFI and SAFI qualifiers, peer which advertised the logical addressing
   prefix (since it can be heard of a from multiple speakers).  The
   bgpM2PathAttrIndex column which identifies each row in the
   bgp4PathAttrClusterTable (for example) would extend out some 50 bytes
   if there was no direct this table is
   used as an index linkage to for other per-attribute tables through the "governing" bgp4PathAt-
   trTable, and bgpPeerTable entries.

   For this reason, remainder
   of the tables are structured in such MIB module.

   RFC 3107 [26] specifies a way that, where
   there is such capability for exchanged routes between BGP
   peers to attach attribute information to a linkage route indicating, specifi-
   cally, related MPLS label path information.  The MIB supports the
   presentation of this attribute information by generalizing how these
   attributes are presented to accommodate further extensions of this
   particular type.  Within a "dependent" table (where, for example, given bgpM2NlriTable entry, we speak of
   attribute data of this type as being 'opaque' to BGP, and use the bgpPrefixCountersTable "depends on"
   columnar OBJECT-TYPEs bgpM2NlriOpaqueType and bgpM2NlriOpaquePointer
   to refer to it.  In the bgpPeerTable), a table
   will contain a per-row numeric index (e.g., bgpPeerIndex), which case of the
   "dependent" table will use as one RFC 3107 MPLS label encoding
   (which is the only usage of these columnar fields in the bgpM2NlriTa-
   ble right now), a MPLS label stack would be referenced by bgpM2Nlri-
   OpaquePointer by its own per-NLRI instance pointing to a row index values.  These
   indices are manufactured by instance in
   the agent, MPLS LSR MIB mplsLabelStackTable, and are otherwise opaque to the management application (or, bgpM2NlriOpaqueType
   instance having a value of bgpMplsLabelStack(1).

   The bgpM2AdjRibsOutTable row entries reflect data on routes which
   have been placed, per peering session, in the Adj-Rib-Out for that matter, even adver-
   tisement to the
   organization associated peer.

   The bgpM2PathAttrTable provides discrete BGP NLRI attributes which
   were received with the advertisement of the "dependent" table[s]).

4.  Definitions

    BGP4-V2-MIB prefix by its advertising
   peer.  Specific information about the autonomous system path (AS
   Path) advertised with the NLRI, on a per AS value, is to be found in
   the bgpM2AsPathTable.

   Finally, where attributes which were unable to be reported in the
   bgpM2PathAttrTable, the AS Path table, or any defined per-NLRI tables
   in the agent were received with the prefix, those attributes are
   reported via the bgpM2PathAttrUnknownTable.  Short of advertised
   attribute type, no semantic breakdown of the unknown attribute data
   is provided.  That data is only available as a raw OCTET STRING in
   the bgpM2PathAttrUnknownValue column of this table.

3.3.1.  Routing Information Base Extensions

   There are two extension sections and five subordinate tables to the
   bgpM2PathAttrTable and RIB data OBJECT IDENTIFIER-delimited MIB mod-
   ule section. The bgpM2PathAttrRouteReflectionExts and its contained
   bgpM2PathAttrOriginatorIdTable report on the originating route
   reflector.  The bgpM2PathAttrClusterTable specifically reports on the
   reflection route a NLRI has traversed to get to the local BGP routing
   process.

   The bgpM2PathAttrCommunityExts section deals with extended and non-
   extended communities for network routes.  The bgpM2PathAttrCommTable
   bgpM2PathAttrExtCommTable  contained herein report community member-
   ship (if any) on a per network-prefix basis.

3.4.  Consideration On Table Indexing

   There are certain efficiency concerns for row index management for
   management applications which are useful to take into consideration,
   given the nature of some of the tables implied in the preceding sec-
   tion.

   In the first place, it is valuable to exploit the direct relationship
   of entries in, for example, the bgpM2PrefixCountersTable as they
   relate to the entry in the bgpM2PeerTable to which they are related.
   More compelling is the example case of the one-to-many relationship
   between a row entry in the bgpM2PeerTable and the bgpM2PathAttrTable,
   the latter of which maintains per-row entries for potentially many
   NLRIs as received from a peer in a BGP UPDATE message.  From the
   point of view of normalizing these relationships, it would be useful
   to have a direct reference to the "governing" bgpM2PeerTable row
   entry for the peer which is a "dependency" for the subordinate table
   row entry for other peer data.

   Second, the nature of protocol-independent addressing makes the
   indexing of these entries indirectly even more compelling.  Even
   accounting for the addressing requirements of IPv6 and the provision
   of AFI and SAFI qualifiers, the logical addressing of a row in the
   bgpPathAttrClusterTable (for example) would extend out some 50 bytes
   if there was no direct index linkage to the "governing" bgpPathAt-
   trTable, and bgpPeerTable entries.

   For this reason, the tables are structured in such a way that, where
   there is such a linkage to a "dependent" table (where, for example,
   the bgpPrefixCountersTable "depends on" the bgpPeerTable), a table
   will contain a per-row numeric index (e.g., bgpPeerIndex), which the
   "dependent" table will use as one of its own row index values.  These
   indices are manufactured by the agent, and are otherwise opaque to
   the management application (or, for that matter, even to the organi-
   zation of the "dependent" table[s]).

   Where considerations of per-row retrieval overhead (in terms of typi-
   cal row instance data size, as a function of liability to have a sin-
   gle row retrieval exceed PDU size, for example), and those of general
   logical data organization permit, certain tables logically at the
   sub-peering-session level have been specified as AUGMENTing the pri-
   mary tables (bgpM2PeerTable and bgpM2CfgPeerTable) to which those
   sub-peering-session row entries relate.  This is to facilitate ease
   on the part of a management application of assembling (for example,
   via GET-BULK operations across a lexicographically contiguous row
   scope) a management image of control information on a given peering
   session.

1.

BGP4-V2-MIB DEFINITIONS ::= BEGIN

        IMPORTS
            MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
            Integer32, Counter32, Gauge32, mib-2,
            Unsigned32
                FROM SNMPv2-SMI
            InetAddressType, InetAddress
                FROM INET-ADDRESS-MIB
            TEXTUAL-CONVENTION, TruthValue, DisplayString, RowStatus
                FROM SNMPv2-TC
            MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
                FROM SNMPv2-CONF;

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

                          Jeff Haas  (Editor)
                          517 W. William Street
                          Ann Arbor, MI 48103-4943
                          Tel: +1 734 973-2200
                          Fax: +1 734 615-3241
                          E-mail: jhaas@nexthop.com" BEGIN

    IMPORTS
        MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
        Counter32, Gauge32, mib-2, Unsigned32, Integer32
            FROM SNMPv2-SMI
        -- Note that the following reference to INET-ADDRESS-MIB
        -- refers to the version as published in the RFC 2851
        -- update internet draft.
       InetAddressType, InetAddress, InetPortNumber,
        InetAutonomousSystemNumber, InetAddressPrefixLength
            FROM INET-ADDRESS-MIB
        TEXTUAL-CONVENTION, TruthValue, DisplayString, RowPointer,
        StorageType, RowStatus
            FROM SNMPv2-TC
        MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
            FROM SNMPv2-CONF;

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

                      Jeffrey Haas  (Editor)
                      825 Victors Way, Suite 100
                      Ann Arbor, MI  48108
                      Tel: +1 734 973-2200
                      Fax: +1 734 615-3241
                      E-mail: jhaas@nexthop.com"
        DESCRIPTION
            "This MIB module defines management objects for
             the Border Gateway Protocol, Version 4."
        ::= { mib-2 XXX }

    BgpM2Identifier ::= TEXTUAL-CONVENTION
        DISPLAY-HINT "1d."
        STATUS       current
        DESCRIPTION
            "The representation of a BGP Identifier.  The BGP
             Identifier should be represented in the OCTET STRING
             as with the first OCTET of the string containing
             the first OCTET of the BGP Identifier received or sent
             in the OPEN packet and so on.

             Even though the BGP Identifier is trending away from
             an IP address it is still displayed as if it was one,
             even when it would be an illegal IP address."
        SYNTAX OCTET STRING(SIZE (4))

    BgpM2Safi ::= TEXTUAL-CONVENTION
        DISPLAY-HINT "d"
        STATUS       current
        DESCRIPTION
            "The representation of a BGP Safi"
        SYNTAX Unsigned32(0..255)

    BgpM2Community ::= TEXTUAL-CONVENTION
        DISPLAY-HINT "2d:"
        STATUS       current
        DESCRIPTION
            "The representation of a BGP Community."
        SYNTAX OCTET STRING(SIZE(4))

    BgpM2ExtendedCommunity ::= TEXTUAL-CONVENTION
        DISPLAY-HINT "1x:1x:1x1x1x1x1x1x"
        STATUS       current
        DESCRIPTION
            "The representation of a BGP Extended Community."
        SYNTAX OCTET STRING(SIZE(8))

    bgpM2BaseScalars
        OBJECT IDENTIFIER ::= { bgp 1 }
    --
    -- Notifications
    --

    bgpM2BaseNotifications
        OBJECT IDENTIFIER ::= { bgpM2BaseScalars 0 }

    bgpM2Established NOTIFICATION-TYPE
        OBJECTS {
            bgpM2PeerLocalAddrType,
            bgpM2PeerLocalAddr,
            bgpM2PeerRemoteAddrType,
            bgpM2PeerRemoteAddr,
            bgpM2PeerLastErrorReceived,
            bgpM2PeerState
        }
        STATUS  current
        DESCRIPTION
            "The BGP Established event is generated when
             the BGP FSM enters the ESTABLISHED state."
        ::= { bgpM2BaseNotifications 1 }

    bgpM2BackwardTransition NOTIFICATION-TYPE
        OBJECTS {
            bgpM2PeerLocalAddrType,
            bgpM2PeerLocalAddr,
            bgpM2PeerRemoteAddrType,
            bgpM2PeerRemoteAddr,
            bgpM2PeerLastErrorReceived,
            bgpM2PeerLastErrorReceivedText,
            bgpM2PeerState
        }
        STATUS  current
        DESCRIPTION
            "The BGPBackwardTransition Event is generated
             when the BGP FSM moves from a higher numbered
             state to a lower numbered state."
        ::= { bgpM2BaseNotifications 2 }

    --
    -- BGP Supported Version Table
    --

    bgpM2Version
        OBJECT IDENTIFIER ::= { bgpM2BaseScalars 1 }
    bgpM2VersionTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpM2VersionEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "Table of supported BGP versions."
        ::= { bgpM2Version 1 }

    bgpM2VersionEntry OBJECT-TYPE
        SYNTAX     BgpM2VersionEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "Entry containing data on a given supported version
             of the Border Gateway Protocol and the level of
             support provided.  It is expected that any agent
             implementation supporting this MIB module will
             report support for Version 4 of the Border Gateway
             Protocol at the very minimum."
        INDEX {
            bgpM2VersionIndex
        }
        ::= { bgpM2VersionTable 1 }

    BgpM2VersionEntry ::= SEQUENCE {
            bgpM2VersionIndex
                Unsigned32,
            bgpM2VersionSupported
                TruthValue
    }

    bgpM2VersionIndex OBJECT-TYPE
        SYNTAX     Unsigned32(0..255)
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The version number of the BGP Protocol."
        ::= { bgpM2VersionEntry 1 }

    bgpM2VersionSupported OBJECT-TYPE
        SYNTAX     TruthValue
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "This value is TRUE if this version of the BGP protocol
             identified in 'bgpM2VersionIndex' is supported.  The absence
             of a row for a particular bgpM2VersionIndex indicates that
             that bgpM2VersionIndex protocol version number is not
             supported."
        ::= { bgpM2VersionEntry 2 }

    --
    -- Supported authentication mechanisms
    --

    bgpM2SupportedAuthentication
        OBJECT IDENTIFIER ::= { bgpM2BaseScalars 2 }

    bgpM2SupportedAuthTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpM2SupportedAuthEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "The supported BGP authentication mechanisms."
        ::= { bgpM2SupportedAuthentication 1 }

    bgpM2SupportedAuthEntry OBJECT-TYPE
        SYNTAX     BgpM2SupportedAuthEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "Entry containing information whether a given BGP
             authentication mechanism is supported by this
             implementation."
        INDEX {
            bgpM2SupportedAuthCode
        }
        ::= { bgpM2SupportedAuthTable 1 }

    BgpM2SupportedAuthEntry ::= SEQUENCE {
        bgpM2SupportedAuthCode
            Unsigned32,
        bgpM2SupportedAuthValue
            TruthValue
    }

    bgpM2SupportedAuthCode OBJECT-TYPE
        SYNTAX     Unsigned32(0..255)
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The BGP authentication code."
        ::= { bgpM2SupportedAuthEntry 1 }

    bgpM2SupportedAuthValue OBJECT-TYPE
        SYNTAX     TruthValue
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "This value is TRUE if a given authentication method
             is supported by the local implementation."
        ::= { bgpM2SupportedAuthEntry 2 }

    --
    -- Supported BGP Capabilities
    --

    bgpM2SupportedCapabilities
        OBJECT IDENTIFIER ::= { bgpM2BaseScalars 3 }

    bgpM2CapabilitySupportAvailable OBJECT-TYPE
        SYNTAX     TruthValue
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "This value is TRUE if capability support is
             available and is enabled."
        ::= { bgpM2SupportedCapabilities 1 }

    bgpM2SupportedCapabilitiesTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpM2SupportedCapabilityEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "Table of supported BGP-4 capabilities."
        ::= { bgpM2SupportedCapabilities 2 }

    bgpM2SupportedCapabilitiesEntry OBJECT-TYPE
        SYNTAX     BgpM2SupportedCapabilityEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "Information about supported capabilities indexed
             by capability number."
        INDEX {
            bgpM2SupportedCapabilityCode
        }
        ::= { bgpM2SupportedCapabilitiesTable 1 }

    BgpM2SupportedCapabilityEntry ::= SEQUENCE {
        bgpM2SupportedCapabilityCode
            Unsigned32,
        bgpM2SupportedCapability
            TruthValue
    }

    bgpM2SupportedCapabilityCode OBJECT-TYPE
        SYNTAX     Unsigned32 (0..255)
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "Index of supported capability.  The index directly
             corresponds with the BGP-4 Capability Advertisement
             Capability Code."
        ::= { bgpM2SupportedCapabilitiesEntry 1 }

    bgpM2SupportedCapability OBJECT-TYPE
        SYNTAX     TruthValue
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "This value is True if this capability is supported,
             False otherwise."
        ::= { bgpM2SupportedCapabilitiesEntry 2 }

    --
    -- Base Scalars
    --

    bgpM2AsSize OBJECT-TYPE
        SYNTAX     INTEGER {
            twoOctet(1),
            fourOctet(2)
        }
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The size of the AS value in this implementation.

             The semantics of this are determined as per the
             as-4bytes draft."
        REFERENCE
            "draft-ietf-idr-as4bytes-04"
        ::= { bgpM2BaseScalars 4 }

    bgpM2LocalAs OBJECT-TYPE
        SYNTAX     InetAutonomousSystemNumber
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The local autonomous system number.

             If the bgpM2AsSize is twoOctet, then the range is
             constrained to be 0-65535."
        ::= { bgpM2BaseScalars 5 }

    bgpM2LocalIdentifier OBJECT-TYPE
        SYNTAX     BgpM2Identifier
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The BGP Identifier of local system.

             Current practice is trending away from this value being
             treated as an IP address and more as a generic
             identifier."
        ::= { bgpM2BaseScalars 6 }

    --
    -- Base Scalar Extensions
    --

    bgpM2BaseScalarExtensions
        OBJECT IDENTIFIER ::= { bgpM2BaseScalars 7 }

    bgpM2BaseScalarNonCapExts
        OBJECT IDENTIFIER ::= { bgpM2BaseScalarExtensions 1 }
    bgpM2BaseScalarCapExts
        OBJECT IDENTIFIER ::= { bgpM2BaseScalarExtensions 2 }

    --
    -- Base Scalar Route Reflection Extensions
    --

    bgpM2BaseScalarRouteReflectExts OBJECT IDENTIFIER ::=
        { bgpM2BaseScalarNonCapExts 2796 }

    bgpM2RouteReflector OBJECT-TYPE
        SYNTAX      TruthValue
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "This value is TRUE if this implementation supports the
             BGP Route Reflection Extension and is enabled as a
             route reflector.  If the BGP Route Reflection extension
             is not supported this value must be FALSE."
        REFERENCE
            "RFC 2796 - BGP Route Reflection"
        ::= { bgpM2BaseScalarRouteReflectExts 1 }

    bgpM2ClusterId OBJECT-TYPE
        SYNTAX      BgpM2Identifier
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The configured Cluster-ID of the BGP Speaker.  This will
             default to the BGP Speaker's BgpM2Identifier if this
             speaker is functioning as a route reflector and an
             explicit Cluster-ID has not been configured.

             A value of 0.0.0.0 will be present if Route Reflection is
             not enabled."
        REFERENCE
            "RFC 2796 - BGP Route Reflection"
        ::= { bgpM2BaseScalarRouteReflectExts 2 }

    --
    -- Base Scalar AS Confederation Extensions
    --

    bgpM2BaseScalarASConfedExts OBJECT IDENTIFIER ::=
         { bgpM2BaseScalarNonCapExts 3065 }

    bgpM2ConfederationRouter OBJECT-TYPE
        SYNTAX     TruthValue
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "This value is TRUE if this implementation supports the
             BGP AS Confederations Extension and this router is
             configured to be in a confederation."
        REFERENCE
            "RFC 3065 - Autonomous System Confederations for BGP"
        ::= { bgpM2BaseScalarASConfedExts 1 }

    bgpM2ConfederationId OBJECT-TYPE
        SYNTAX     InetAutonomousSystemNumber
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The local Confederation Identification Number.

             This value will be zero (0) if this BGP Speaker is not
             a confederation router."
        REFERENCE
            "RFC 3065 - Autonomous System Confederations for BGP"
        ::= { bgpM2BaseScalarASConfedExts 2 }

    --
    -- Base Configuration Objects
    --

    bgpM2BaseScalarConfiguration
        OBJECT IDENTIFIER ::= { bgpM2BaseScalars 8 }

    bgpM2CfgBaseScalarStorageType OBJECT-TYPE
        SYNTAX     StorageType
        MAX-ACCESS read-write
        STATUS     current
        DESCRIPTION
            "This object specifies the intended storage type for
             all configurable base scalars."
        ::= { bgpM2BaseScalarConfiguration 1 }
    bgpM2CfgLocalAs OBJECT-TYPE
        SYNTAX     InetAutonomousSystemNumber
        MAX-ACCESS read-write
        STATUS     current
        DESCRIPTION
            "The local autonomous system number.

             If the bgpM2AsSize is twoOctet, then the range is
             constrained to be 0-65535."
        ::= { bgpM2BaseScalarConfiguration 2 }

    bgpM2CfgLocalIdentifier OBJECT-TYPE
        SYNTAX     BgpM2Identifier
        MAX-ACCESS read-write
        STATUS     current
        DESCRIPTION
            "The BGP Identifier of local system.

             Current practice is trending away from this value being
             treated as an IP address and more as a generic
             identifier."
        ::= { bgpM2BaseScalarConfiguration 3 }

    --
    -- Base Scalar Extensions
    --

    bgpM2CfgBaseScalarExtensions
        OBJECT IDENTIFIER ::= { bgpM2BaseScalarConfiguration 4 }

    bgpM2CfgBaseScalarNonCapExts
        OBJECT IDENTIFIER ::= { bgpM2CfgBaseScalarExtensions 1 }

    bgpM2CfgBaseScalarCapExts
        OBJECT IDENTIFIER ::= { bgpM2CfgBaseScalarExtensions 2 }

    --
    -- Base Scalar Route Reflection Extensions
    --

    bgpM2CfgBaseScalarReflectorExts
        OBJECT IDENTIFIER ::= { bgpM2CfgBaseScalarNonCapExts 2796 }
    bgpM2CfgRouteReflector OBJECT-TYPE
        SYNTAX      TruthValue
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "This value is set to true if this implementation will
             be supporting route reflection."
        REFERENCE
            "RFC 2796 - BGP Route Reflection"
        ::= { bgpM2CfgBaseScalarReflectorExts 1 }

    bgpM2CfgClusterId OBJECT-TYPE
        SYNTAX      BgpM2Identifier
        MAX-ACCESS  read-write
        STATUS      current
        DESCRIPTION
            "The configured Cluster-ID of the BGP Speaker.  This will
             default to the BGP Speaker's BgpM2Identifier if this
             speaker is functioning as a route reflector and an
             explicit Cluster-ID has not been configured.

             A value of 0.0.0.0 will be present if Route Reflection is
             not enabled."
        REFERENCE
            "RFC 2796 - BGP Route Reflection"
        ::= { bgpM2CfgBaseScalarReflectorExts 2 }

    --
    -- Base Scalar AS Confederation Extensions
    --

    bgpM2CfgBaseScalarASConfedExts
        OBJECT IDENTIFIER ::= { bgpM2CfgBaseScalarNonCapExts 3065 }

    bgpM2CfgConfederationRouter OBJECT-TYPE
        SYNTAX     TruthValue
        MAX-ACCESS read-write
        STATUS     current
        DESCRIPTION
            "This value is set to true if this implementation will be
             supporting BGP AS Confederations."
        REFERENCE
            "RFC 3065 - Autonomous System Confederations for BGP"
        ::= { bgpM2CfgBaseScalarASConfedExts 1 }
    bgpM2CfgConfederationId OBJECT-TYPE
        SYNTAX     InetAutonomousSystemNumber
        MAX-ACCESS read-write
        STATUS     current
        DESCRIPTION
            "The local Confederation Identification Number.

             This value will be zero (0) if this BGP Speaker is not
             a confederation router."
        REFERENCE
            "RFC 3065 - Autonomous System Confederations for BGP"
        ::= { bgpM2CfgBaseScalarASConfedExts 2 }

    --
    -- BGP Peer Data
    --

    bgpM2Peer
        OBJECT IDENTIFIER ::= { bgp 2 }

    bgpM2PeerData
        OBJECT IDENTIFIER ::= { bgpM2Peer 1 }

    bgpM2PeerTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpM2PeerEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "BGP peer table.

             This table contains, one entry per BGP peer,
             and information about the connections with BGP
             peers."
        ::= { bgpM2PeerData 1 }

    bgpM2PeerEntry OBJECT-TYPE
        SYNTAX     BgpM2PeerEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "Entry containing information about the connection with
             a BGP peer."
        INDEX {
            bgpM2PeerLocalAddrType,
            bgpM2PeerLocalAddr,
            bgpM2PeerRemoteAddrType,
            bgpM2PeerRemoteAddr
        }
        ::= { bgpM2PeerTable 1 }

    BgpM2PeerEntry ::= SEQUENCE {
        bgpM2PeerIdentifier
            BgpM2Identifier,
        bgpM2PeerState
            INTEGER,
        bgpM2PeerStatus
            INTEGER,
        bgpM2PeerConfiguredVersion
            Unsigned32,
        bgpM2PeerNegotiatedVersion
            Unsigned32,
        bgpM2PeerLocalAddrType
            InetAddressType,
        bgpM2PeerLocalAddr
            InetAddress,
        bgpM2PeerLocalPort
            InetPortNumber,
        bgpM2PeerLocalAs
            InetAutonomousSystemNumber,
        bgpM2PeerRemoteAddrType
            InetAddressType,
        bgpM2PeerRemoteAddr
            InetAddress,
        bgpM2PeerRemotePort
            InetPortNumber,
        bgpM2PeerRemoteAs
            InetAutonomousSystemNumber,
        bgpM2PeerIndex
            Unsigned32
    }

    bgpM2PeerIdentifier OBJECT-TYPE
        SYNTAX     BgpM2Identifier
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The BGP Identifier of this entry's BGP peer.

             This entry should be 0.0.0.0 unless the bgpM2PeerState is
             in the OpenConfirm or the Established state."
        REFERENCE
            "draft-ietf-idr-bgp4-17.txt, Sec. 4.2"
        ::= { bgpM2PeerEntry 1 }

    bgpM2PeerState OBJECT-TYPE
        SYNTAX     INTEGER {
            idle(1),
            connect(2),
            active(3),
            opensent(4),
            openconfirm(5),
            established(6)
        }
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The BGP peer's FSM state."
        REFERENCE
            "draft-ietf-idr-bgp4-17.txt, Sec. 8"
        ::= { bgpM2PeerEntry 2 }

    bgpM2PeerStatus OBJECT-TYPE
        SYNTAX     INTEGER {
            halted(1),
            running(2)
        }
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "Whether or not the BGP FSM for this peer is halted or
             running.  The BGP FSM for a peer is halted after
             processing a Stop event.  Likewise, it is in the running
             state after a Start event.

             The bgpM2PeerState will generally be in the idle state when
             the FSM is halted, although some extensions such as
             Graceful Restart will leave the peer in the Idle state
             but with the FSM running."
        ::= { bgpM2PeerEntry 3 }

    bgpM2PeerConfiguredVersion OBJECT-TYPE
        SYNTAX     Unsigned32 (1..255)
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The configured version to originally start with this
             peer.  The BGP speaker may permit negotiation to a
             lower version number of the protocol."
        ::= { bgpM2PeerEntry 4 }

    bgpM2PeerNegotiatedVersion OBJECT-TYPE
        SYNTAX     Unsigned32 (1..255)
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The negotiated version of BGP running between the two
             peers."
        ::= { bgpM2PeerEntry 5 }

    bgpM2PeerLocalAddrType OBJECT-TYPE
        SYNTAX     InetAddressType
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The address family of the local end of the peering
             session."
        ::= { bgpM2PeerEntry 6 }

    bgpM2PeerLocalAddr OBJECT-TYPE
        SYNTAX     InetAddress (SIZE(4..20))
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The address of the local end of the peering session."
        ::= { bgpM2PeerEntry 7 }

    bgpM2PeerLocalPort OBJECT-TYPE
        SYNTAX     InetPortNumber
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The local port for the TCP connection between the BGP
             peers."
        ::= { bgpM2PeerEntry 8 }

    bgpM2PeerLocalAs OBJECT-TYPE
        SYNTAX     InetAutonomousSystemNumber
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "Some implementations of BGP can represent themselves
             as multiple ASs.  This is the AS that this peering
             session is representing itself as to the remote peer."
        ::= { bgpM2PeerEntry 9 }

    bgpM2PeerRemoteAddrType OBJECT-TYPE
        SYNTAX     InetAddressType
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The address family of the remote end of the peering
             session."
        ::= { bgpM2PeerEntry 10 }

    bgpM2PeerRemoteAddr OBJECT-TYPE
        SYNTAX     InetAddress (SIZE(4..20))
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The address of the remote end of the peering session."
        ::= { bgpM2PeerEntry 11 }

    bgpM2PeerRemotePort OBJECT-TYPE
        SYNTAX     InetPortNumber
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The remote port for the TCP connection between the BGP
             peers.  In the case of a transport for which the notion
             of 'port' is irrelevant, an instance value of -1
             should be returned by the agent for this object.

             Note that the objects bgpM2PeerLocalAddr,
             bgpM2PeerLocalPort, bgpM2PeerRemoteAddr and
             bgpM2PeerRemotePort provide the appropriate reference to
             the standard MIB TCP connection table. or even the ipv6
             TCP MIB as in rfc2452."
        REFERENCE
            "RFC 2012 - SNMPv2 Management Information Base for the
             Transmission Control Protocol using SMIv2.
             RFC 2542 - IP Version 6 Management Information Base
             for the Transmission Control Protocol."
        ::= { bgpM2PeerEntry 12 }
    bgpM2PeerRemoteAs OBJECT-TYPE
        SYNTAX     InetAutonomousSystemNumber
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The remote autonomous system number."
        ::= { bgpM2PeerEntry 13 }

    bgpM2PeerIndex OBJECT-TYPE
        SYNTAX      Unsigned32
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "This value is a unique index for the peer entry in the
             bgpM2PeerTable.  It is assigned by the agent at the point
             of creation of the bgpM2PeerTable row entry.  While its
             value is guaranteed to be unique at any time, it is
             otherwise opaque to the management application with
             respect to its value or the contiguity of bgpM2PeerIndex
             row instance values across rows of the bgpM2PeerTable.  It
             is used to provide an index structure for other tables
             whose data is logically per-peer.

             For explicitly configured peers, this value will remain
             consistent until this row is deleted by deleting the
             configured peers.  Unconfigured peers will generate
             a monotonically increasing number when a BGP FSM is
             built to process the peering session.  Values in the
             bgpM2PeerTable and other tables utilizing bgpM2PeerIndex
             are expected to remain in existence for an arbitrary
             time after the unconfigured peer has been deleted
             in order to allow management applications to extract
             useful management information for those peers.  Thus,
             an unconfigured peer using the same indices as the
             bgpM2PeerTable that comes up while this row still
             exists will re-utilize the same row."
         ::= { bgpM2PeerEntry 14 }

    --
    -- Errors
    --

    bgpM2PeerErrors
        OBJECT IDENTIFIER ::= { bgpM2Peer 2 }

    bgpM2PeerErrorsTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpM2PeerErrorsEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "On a per peer basis, this table reflects the last
             protocol-defined error encountered and reported on
             the peer session.  If no entry for a given peer,
             by its bgpM2PeerIndex, exists in this table, then no
             such errors have been observed, reported, and
             recorded on the  session."
        ::= { bgpM2PeerErrors 1 }

    bgpM2PeerErrorsEntry OBJECT-TYPE
        SYNTAX     BgpM2PeerErrorsEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "Each entry contains information about errors sent
             and received for a particular BGP peer."
        AUGMENTS {
            bgpM2PeerEntry
        }
        ::= { bgpM2PeerErrorsTable 1 }

    BgpM2PeerErrorsEntry ::= SEQUENCE {
        bgpM2PeerLastErrorReceived
            OCTET STRING,
        bgpM2PeerLastErrorSent
            OCTET STRING,
        bgpM2PeerLastErrorReceivedTime
            TimeTicks,
        bgpM2PeerLastErrorSentTime
            TimeTicks,
        bgpM2PeerLastErrorReceivedText
            DisplayString,
        bgpM2PeerLastErrorSentText
            DisplayString,
        bgpM2PeerLastErrorReceivedData
            OCTET STRING,
        bgpM2PeerLastErrorSentData
            OCTET STRING
    }

    bgpM2PeerLastErrorReceived OBJECT-TYPE
        SYNTAX     OCTET STRING (SIZE (2))
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The last error code and subcode received by this BGP
             Speaker via a NOTIFICATION message for this peer.
             If no error has occurred, this field is zero.
             Otherwise, the first byte of this two byte
             OCTET STRING contains the error code, and the second
             byte contains the subcode."
        REFERENCE
            "draft-ietf-idr-bgp4-15.txt, Sec. 4.5"
        ::= { bgpM2PeerErrorsEntry 1 }

    bgpM2PeerLastErrorSent OBJECT-TYPE
        SYNTAX     OCTET STRING (SIZE (2))
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The last error code and subcode sent by this BGP
             Speaker via a NOTIFICATION message to this peer.
             If no error has occurred, this field is zero.
             Otherwise, the first byte of this two byte
             OCTET STRING contains the error code, and the second
             byte contains the subcode."
        REFERENCE
            "draft-ietf-idr-bgp4-15.txt, Sec. 4.5"
        ::= { bgpM2PeerErrorsEntry 2 }

    bgpM2PeerLastErrorReceivedTime OBJECT-TYPE
        SYNTAX     TimeTicks
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The timestamp that the last NOTIFICATION was received from
             this peer."
        REFERENCE
            "draft-ietf-idr-bgp4-15.txt, Sec. 4.5"
        ::= { bgpM2PeerErrorsEntry 3 }

    bgpM2PeerLastErrorSentTime OBJECT-TYPE
        SYNTAX     TimeTicks
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The timestamp that the last NOTIFICATION was sent to
             this peer."
        REFERENCE
            "draft-ietf-idr-bgp4-15.txt, Sec. 4.5"
        ::= { bgpM2PeerErrorsEntry 4 }

    bgpM2PeerLastErrorReceivedText OBJECT-TYPE
        SYNTAX     DisplayString
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "This object contains an implementation specific
             explanation of the error that was reported."
        ::= { bgpM2PeerErrorsEntry 5 }

    bgpM2PeerLastErrorSentText OBJECT-TYPE
        SYNTAX     DisplayString
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "This object contains an implementation specific
             explanation of the error that is being reported."
        ::= { bgpM2PeerErrorsEntry 6 }

    bgpM2PeerLastErrorReceivedData OBJECT-TYPE
        SYNTAX     OCTET STRING (SIZE(0..4075))
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The last error code's data seen by this peer."
        REFERENCE
            "draft-ietf-idr-bgp4-15.txt, Sec. 4.5"
        ::= { bgpM2PeerErrorsEntry 7 }

    bgpM2PeerLastErrorSentData OBJECT-TYPE
        SYNTAX     OCTET STRING (SIZE(0..4075))
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The last error code's data sent to this peer."
        REFERENCE
            "draft-ietf-idr-bgp4-15.txt, Sec. 4.5"
        ::= { bgpM2PeerErrorsEntry 8 }
    --
    -- Peer Authentication
    --

    bgpM2PeerAuthentication
        OBJECT IDENTIFIER ::= { bgpM2Peer 3 }

    bgpM2PeerAuthTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpM2PeerAuthEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "BGP peer authentication table.

             This table contains, one entry per BGP peer,
             information about the authentication with BGP peers."
        ::= { bgpM2PeerAuthentication 1 }

    bgpM2PeerAuthEntry OBJECT-TYPE
        SYNTAX     BgpM2PeerAuthEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "Entry containing information about the authentication
             with a BGP peer."
        AUGMENTS {
            bgpM2PeerEntry
        }
        ::= { bgpM2PeerAuthTable 1 }

    BgpM2PeerAuthEntry ::= SEQUENCE {
        bgpM2PeerAuthSent
            TruthValue,
        bgpM2PeerAuthSentCode
            Unsigned32,
        bgpM2PeerAuthSentValue
            OCTET STRING,
        bgpM2PeerAuthRcvd
            TruthValue,
        bgpM2PeerAuthRcvdCode
            Unsigned32,
        bgpM2PeerAuthRcvdValue
            OCTET STRING
    }
    bgpM2PeerAuthSent OBJECT-TYPE
        SYNTAX TruthValue
        MAX-ACCESS read-only
        STATUS current
        DESCRIPTION
            "The local peer has sent authentication information
             to the remote peer in the BGP Authentication field."
        ::= { bgpM2PeerAuthEntry 1 }

     bgpM2PeerAuthSentCode OBJECT-TYPE
        SYNTAX  Unsigned32 (0..255)
        MAX-ACCESS read-only
        STATUS current
        DESCRIPTION
            "The code of the authentication information sent to
             the remote peer."
        ::= { bgpM2PeerAuthEntry 2 }

    bgpM2PeerAuthSentValue OBJECT-TYPE
        SYNTAX  OCTET STRING (SIZE (0..252))
        MAX-ACCESS read-only
        STATUS current
        DESCRIPTION
            "The payload of the authentication information
             from the remote peer."
        ::= { bgpM2PeerAuthEntry 3 }

    bgpM2PeerAuthRcvd OBJECT-TYPE
        SYNTAX TruthValue
        MAX-ACCESS read-only
        STATUS current
        DESCRIPTION
            "The local peer has received authentication information
             from the remote peer in the BGP Authentication field."
        ::= { bgpM2PeerAuthEntry 4 }

    bgpM2PeerAuthRcvdCode OBJECT-TYPE
        SYNTAX  Unsigned32 (0..255)
        MAX-ACCESS read-only
        STATUS current
        DESCRIPTION
            "The code of the authentication information received from
             the remote peer."
        ::= { bgpM2PeerAuthEntry 5 }
    bgpM2PeerAuthRcvdValue OBJECT-TYPE
        SYNTAX  OCTET STRING (SIZE (0..252))
        MAX-ACCESS read-only
        STATUS current
        DESCRIPTION
            "The payload of the authentication information from
            the remote peer."
        ::= { bgpM2PeerAuthEntry 6 }

    --
    -- Peer Event Times
    --

    bgpM2PeerTimers
        OBJECT IDENTIFIER ::= { bgpM2Peer 4 }

    bgpM2PeerEventTimesTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpM2PeerEventTimesEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "A table reporting the per-peering session amount
             of time elapsed and update events since the peering
             session advanced into the Established state."
        ::= { bgpM2PeerTimers 1 }

    bgpM2PeerEventTimesEntry OBJECT-TYPE
        SYNTAX     BgpM2PeerEventTimesEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "Each row contains a set of statistics about time
             spent and events encountered in the peer session
             Established state."
        AUGMENTS {
            bgpM2PeerEntry
        }
        ::= { bgpM2PeerEventTimesTable 1 }

    BgpM2PeerEventTimesEntry ::= SEQUENCE {
        bgpM2PeerFsmEstablishedTime
            Gauge32,
        bgpM2PeerInUpdatesElapsedTime
            Gauge32
    }

    bgpM2PeerFsmEstablishedTime OBJECT-TYPE
        SYNTAX     Gauge32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "This timer indicates how long (in seconds) this
             peer has been in the Established state or how long
             since this peer was last in the Established state.
             It is set to zero when a new peer is configured or
             the router is booted."
        ::= { bgpM2PeerEventTimesEntry 1 }

    bgpM2PeerInUpdatesElapsedTime OBJECT-TYPE
        SYNTAX     Gauge32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "Elapsed time in seconds since the last BGP UPDATE
             message was received from the peer.  Each time
             bgpM2PeerInUpdates is incremented, the value of this
             object is set to zero (0).  This value shall also be
             zero (0) when the peer is not in the Established state"
        ::= { bgpM2PeerEventTimesEntry 2 }

    --
    -- Peer Configured Timers
    --

    bgpM2PeerConfiguredTimersTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpM2PeerConfiguredTimersEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
                "This MIB module defines
            "Per peer management objects data on BGP session timers."
        ::= { bgpM2PeerTimers 2 }

    bgpM2PeerConfiguredTimersEntry OBJECT-TYPE
        SYNTAX     BgpM2PeerConfiguredTimersEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "Each entry corresponds to the current state of
             BGP timers on a given peering session."
        AUGMENTS {
            bgpM2PeerEntry
        }
        ::= { bgpM2PeerConfiguredTimersTable 1 }

    BgpM2PeerConfiguredTimersEntry ::= SEQUENCE {
        bgpM2PeerConnectRetryInterval
            Unsigned32,
        bgpM2PeerHoldTimeConfigured
            Unsigned32,
        bgpM2PeerKeepAliveConfigured
            Unsigned32,
        bgpM2PeerMinASOrigInterval
            Unsigned32,
        bgpM2PeerMinRouteAdverInterval
            Unsigned32
    }

    bgpM2PeerConnectRetryInterval OBJECT-TYPE
        SYNTAX     Unsigned32 (1..65535)
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "Time interval in seconds for the ConnectRetry
             timer.  The suggested value for this timer is 120
             seconds."
        ::= { bgpM2PeerConfiguredTimersEntry 1 }

    bgpM2PeerHoldTimeConfigured OBJECT-TYPE
        SYNTAX     Unsigned32 ( 0 | 3..65535 )
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "Time interval in seconds for the Hold Time configured
             for this BGP speaker with this peer.  This value
             is placed in an OPEN message sent to this peer by
             this BGP speaker, and is compared with the Hold
             Time field in an OPEN message received from the
             peer when determining the Hold Time (bgpM2PeerHoldTime)
             with the peer.  This value must not be less than
             three seconds if it is not zero (0) in which case
             the Hold Time is NOT to be established with the
             peer.  The suggested value for
                the Border Gateway Protocol, Version 4." this timer is 90
             seconds."
        REFERENCE
            "draft-ietf-idr-bgp4-17.txt, Appendix 6.4"
        ::= { mib-2 XXX bgpM2PeerConfiguredTimersEntry 2 }

        BgpIdentifier ::= TEXTUAL-CONVENTION
            DISPLAY-HINT "1d:"
            -- jmh - is this right?
            STATUS     current
            DESCRIPTION
                "The representation of a BGP Identifier."

    bgpM2PeerKeepAliveConfigured OBJECT-TYPE
        SYNTAX OCTET STRING(SIZE (4))

        BgpSafi ::= TEXTUAL-CONVENTION
            DISPLAY-HINT "d"     Unsigned32 ( 0 | 1..21845 )
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "The representation of a
            "Time interval in seconds for the KeepAlive timer
             configured for this BGP Safi"
            SYNTAX Unsigned32(0..255)

        BgpAutonomousSystemNumber ::= TEXTUAL-CONVENTION
            -- JMH - how is Cisco et al. representing speaker with this peer.
             The value of this object will only determine the 4byte
            -- versions?
            DISPLAY-HINT "d"
            STATUS current
            DESCRIPTION
                "An autonomous System Number.  If bgpAsSize is
                two-octet,
             KEEPALIVE messages frequency relative to the range value
             specified in bgpM2PeerHoldTimeConfigured; the actual
             time interval for the KEEPALIVE messages is 0..65535. indicated
             by bgpM2PeerKeepAlive.  A reasonable maximum value
             for this timer would be configured to be one third
             of that of bgpM2PeerHoldTimeConfigured.

             If it is
                four-octet, it is the full range value of Unsigned32."
            SYNTAX Unsigned32

        bgpBaseScalars
        OBJECT IDENTIFIER ::= { bgp 1 }

        bgpBaseNotifications
        OBJECT IDENTIFIER ::= { bgpBaseScalars 0 }

        bgpEstablished NOTIFICATION-TYPE
            OBJECTS {
                bgpPeerLocalAddrType,
                bgpPeerLocalAddr,
                bgpPeerRemoteAddrType,
                bgpPeerRemoteAddr,
                bgpPeerLastError,
                bgpPeerState
             }
            STATUS  current
            DESCRIPTION
                "The BGP Established event this object is generated when zero (0), no
             periodical KEEPALIVE messages are sent to the BGP FSM enters peer
             after the ESTABLISHED state." BGP connection has been established.
             The suggested value for this timer is 30 seconds."
        REFERENCE
            "draft-ietf-idr-bgp4-17.txt, Appendix 6.4"
        ::= { bgpBaseNotifications 1 }

        bgpBackwardTransition NOTIFICATION-TYPE
            OBJECTS {
                bgpPeerLocalAddrType,
                bgpPeerLocalAddr,
                bgpPeerRemoteAddrType,
                bgpPeerRemoteAddr,
                bgpPeerLastError,
                bgpPeerState bgpM2PeerConfiguredTimersEntry 3 }

    bgpM2PeerMinASOrigInterval OBJECT-TYPE
        SYNTAX     Unsigned32 (0..65535)
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "The BGPBackwardTransition Event is generated
                when
            "Time interval in seconds for the BGP FSM moves from a higher numbered
                state to a lower numbered state." MinASOriginationInterval
             timer.  The suggested value for this timer is 15
             seconds."
        ::= { bgpBaseNotifications 2 bgpM2PeerConfiguredTimersEntry 4 }

        bgpVersion
        OBJECT IDENTIFIER

    bgpM2PeerMinRouteAdverInterval OBJECT-TYPE
        SYNTAX     Unsigned32 (0..65535)
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "Time interval in seconds for the
             MinRouteAdvertisementInterval timer.  The suggested
             value for this timer is 30 seconds."
        ::= { bgpBaseScalars 1 bgpM2PeerConfiguredTimersEntry 5 }
    --
    -- BGP Supported Version Table Peer Negotiated Timers
    --

        bgpVersionTable

    bgpM2PeerNegotiatedTimersTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpVersionEntry BgpM2PeerNegotiatedTimersEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
                "Table
            "Current values of supported BGP versions." per-peer timers which can be
             dynamically set in the bgpM2PeerConfiguredTimersTable.
             Values reflected in this table are the current
             operational values, after negotiation from values
             derived from initial configuration or last set from
             bgpM2PeerConfiguredTimersTable row instances."
        ::= { bgpVersion 1 bgpM2PeerTimers 3 }

        bgpVersionEntry

    bgpM2PeerNegotiatedTimersEntry OBJECT-TYPE
        SYNTAX     BgpVersionEntry     BgpM2PeerNegotiatedTimersEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
                "Entry containing data on
            "Each entry reflects a given supported version of
                    the Border Gateway Protocol and the level of support
                    provided.  It is expected that any agent implementation
                    supporting this MIB module will report support for
                    Version 4 value of the Border Gateway Protocol at currently
             operational, negotiated timers as reflected in the very
                    minimum."
         INDEX
             BgpM2PeerNegotiatedTimersEntry."
        AUGMENTS { bgpVersionIndex
            bgpM2PeerEntry
        }
        ::= { bgpVersionTable bgpM2PeerNegotiatedTimersTable 1 }

        BgpVersionEntry

    BgpM2PeerNegotiatedTimersEntry ::= SEQUENCE {
                bgpVersionIndex
        bgpM2PeerHoldTime
            Unsigned32,
                bgpVersionSupported
                    TruthValue
        bgpM2PeerKeepAlive
            Unsigned32
    }

        bgpVersionIndex

    bgpM2PeerHoldTime OBJECT-TYPE
        SYNTAX     Unsigned32(0..255)     Unsigned32  ( 0 | 3..65535 )
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The version number value of this object is calculated by this BGP
             Speaker as being;
             zero (0) - if this was the value sent by the peer and
             this value is permitted by this BGP Protocol."
            ::= { bgpVersionEntry 1 }
        bgpVersionSupported OBJECT-TYPE
            SYNTAX     TruthValue
            MAX-ACCESS read-only
            STATUS     current
            DESCRIPTION
                "This Speaker.  In this
             case, no keepalive messages are sent and the Hold Timer
             is not set.

             At least three (3).  This value is TRUE if the version smaller of
             the BGP protocol
                 identified value sent by this peer in 'bgpVersionIndex' the OPEN message and
             bgpM2PeerHoldTimeConfigured for this peer.

             This value is supported."
            ::= { bgpVersionEntry 2 }

        bgpSupportedAuthentication
        OBJECT IDENTIFIER ::= { bgpBaseScalars 2 }

        --
        -- Supported authentication mechanisms
        --

        bgpSupportedAuthTable OBJECT-TYPE
            SYNTAX     SEQUENCE OF BgpSupportedAuthEntry
            MAX-ACCESS not-accessible
            STATUS     current
            DESCRIPTION
                "The supported BGP authentication mechanisms." only defined when the peering session is
             in the Established state."
        REFERENCE
            "draft-ietf-idr-bgp4-17.txt, Sec. 4.2"
        ::= { bgpSupportedAuthentication bgpM2PeerNegotiatedTimersEntry 1 }

        bgpSupportedAuthEntry

    bgpM2PeerKeepAlive OBJECT-TYPE
        SYNTAX     BgpSupportedAuthEntry     Unsigned32 ( 0 | 1..21845 )
        MAX-ACCESS not-accessible read-only
        STATUS     current
        DESCRIPTION
                "Entry containing information whether a given BGP
                 authentication mechanism
            "Time interval in seconds for the KeepAlive timer
             established with the peer.  The value of this object
             is supported calculated by this
                 implementation."
            INDEX { bgpSupportedAuthCode }
            ::= { bgpSupportedAuthTable 1 }

        BgpSupportedAuthEntry ::= SEQUENCE {
                bgpSupportedAuthCode
                    Unsigned32,
                bgpSupportedAuthValue
                    TruthValue
                }

        bgpSupportedAuthCode OBJECT-TYPE
            SYNTAX     Unsigned32(0..255)
            MAX-ACCESS read-only
            STATUS     current
            DESCRIPTION
                "The BGP authentication code."
            ::= { bgpSupportedAuthEntry 1 }

        bgpSupportedAuthValue OBJECT-TYPE
            SYNTAX     TruthValue
            MAX-ACCESS read-only
            STATUS     current
            DESCRIPTION
                "This speaker such that, when
             compared with bgpM2PeerHoldTime, it has the same
             proportion as what bgpM2PeerKeepAliveConfigured has
             when compared with bgpM2PeerHoldTimeConfigured.  If
             the value of this object is TRUE if a given authentication method zero (0), it indicates
             that the KeepAlive timer has not been established
             with the peer, or, the value of
             bgpM2PeerKeepAliveConfigured is supported by zero (0).

             This value is only defined when the local implementation." peering session is
             in the Established state."
        REFERENCE
            "draft-ietf-idr-bgp4-17, Sec. 4.4"
        ::= { bgpSupportedAuthEntry bgpM2PeerNegotiatedTimersEntry 2 }

        bgpSupportedCapabilities

    --
    -- Peer Capabilities
    --

    bgpM2PeerCapabilities
        OBJECT IDENTIFIER ::= { bgpBaseScalars 3 bgpM2Peer 5 }

    --
    -- Supported BGP Announced Capabilities
    --

        bgpCapabilitySupportAvailable

    bgpM2PeerCapsAnnouncedTable OBJECT-TYPE
        SYNTAX     TruthValue     SEQUENCE OF BgpM2PeerCapsAnnouncedEntry
        MAX-ACCESS read-write not-accessible
        STATUS     current
        DESCRIPTION
            "This variable determines whether BGP-4 table contains the capabilities
             that are supported in this
                 implementation.  This variable may be set to
                 false to disable capability support." for a given peer."
        ::= { bgpSupportedCapabilities bgpM2PeerCapabilities 1 }

        bgpSupportedCapabilitiesTable OBJECT-TYPE
            SYNTAX     SEQUENCE OF BgpSupportedCapabilityEntry
            MAX-ACCESS not-accessible
            STATUS     current
            DESCRIPTION
                "Table of supported BGP-4 capabilities."
            ::= { bgpSupportedCapabilities 2 }

        bgpSupportedCapabilitiesEntry

    bgpM2PeerCapsAnnouncedEntry OBJECT-TYPE
        SYNTAX     BgpSupportedCapabilityEntry     BgpM2PeerCapsAnnouncedEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
                "Information about supported capabilities indexed
            "These entries are keyed by capability number." a BGP-4 peer remote
             address and the BGP Capability Code"
        INDEX {
                bgpSupportedCapabilityIndex
            bgpM2PeerIndex,
            bgpM2PeerCapAnnouncedCode,
            bgpM2PeerCapAnnouncedIndex
        }
        ::= { bgpSupportedCapabilitiesTable bgpM2PeerCapsAnnouncedTable 1 }

        BgpSupportedCapabilityEntry

    BgpM2PeerCapsAnnouncedEntry ::= SEQUENCE {
                bgpSupportedCapabilityIndex
        bgpM2PeerCapAnnouncedCode
            Unsigned32,
                bgpSupportedCapability
                    TruthValue
        bgpM2PeerCapAnnouncedIndex
            Unsigned32,
        bgpM2PeerCapAnnouncedValue
            OCTET STRING
    }

        bgpSupportedCapabilityIndex

    bgpM2PeerCapAnnouncedCode OBJECT-TYPE
        SYNTAX     Unsigned32 (0..255)
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "Index of supported capability.  The index directly
                 corresponds with the BGP-4
            "The BGP Capability Advertisement Capability Code."
        ::= { bgpSupportedCapabilitiesEntry bgpM2PeerCapsAnnouncedEntry 1 }

        bgpSupportedCapability

    bgpM2PeerCapAnnouncedIndex OBJECT-TYPE
        SYNTAX     TruthValue     Unsigned32 (1..128)
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "This value is True if this
            "Multiple instances of a given capability may be sent
             bgp a BGP speaker.  This variable is supported,
                 False otherwise." used to index them."
        ::= { bgpSupportedCapabilitiesEntry bgpM2PeerCapsAnnouncedEntry 2 }

        bgpAsSize

    bgpM2PeerCapAnnouncedValue OBJECT-TYPE
        SYNTAX     INTEGER {
                twoOctet(1),
                fourOctet(2)
            }     OCTET STRING (SIZE(0..255))
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The size of the AS value in this implementation.

                 The semantics of this are determined as per the
                 as-4bytes draft."
            REFERENCE
                "draft-ietf-idr-as4bytes-04" announced capability."
        ::= { bgpBaseScalars 4 bgpM2PeerCapsAnnouncedEntry 3 }

        bgpLocalAs

    --
    -- Received Capabilities
    --

    bgpM2PeerCapsReceivedTable OBJECT-TYPE
        SYNTAX     BgpAutonomousSystemNumber     SEQUENCE OF BgpM24PeerCapsReceivedEntry
        MAX-ACCESS read-write not-accessible
        STATUS     current
        DESCRIPTION
                "The local autonomous system number.

                 If the bgpAsSize is twoOctet, then
            "This table contains the range is
                 constrained to be 0-65535." capabilities
            that are supported for a given peer."
        ::= { bgpBaseScalars 5 bgpM2PeerCapabilities 2 }

        bgpLocalIdentifier

    bgpM2PeerCapsReceivedEntry OBJECT-TYPE
        SYNTAX     BgpIdentifier     BgpM24PeerCapsReceivedEntry
        MAX-ACCESS read-write not-accessible
        STATUS     current
        DESCRIPTION
                "The BGP Identifier of the local system.

                 Current practice is trending away from this value being
                 treated as an IP
            "These entries are keyed by a BGP-4 peer remote
            address and more as a generic
                 identifier."
            ::= { bgpBaseScalars 6 }

        --
        -- Base Scalar Extensions
        --

        bgpBaseScalarExtensions     OBJECT IDENTIFIER ::= the BGP Capability Code"
        INDEX { bgpBaseScalars 7
            bgpM2PeerIndex,
            bgpM2PeerCapReceivedCode,
            bgpM2PeerCapReceivedIndex
        }

        bgpBaseScalarNonCapExts OBJECT IDENTIFIER
        ::= { bgpBaseScalarExtensions bgpM2PeerCapsReceivedTable 1 }

        bgpBaseScalarCapExts OBJECT IDENTIFIER ::=
            { bgpBaseScalarExtensions 2 }

        --
        -- Base Scalar AS Confederation Extensions
        --

        bgpBaseScalarASConfederationExts OBJECT IDENTIFIER

    BgpM24PeerCapsReceivedEntry ::= SEQUENCE { bgpBaseScalarNonCapExts 1965
        bgpM2PeerCapReceivedCode
            Unsigned32,
        bgpM2PeerCapReceivedIndex
            Unsigned32,
        bgpM2PeerCapReceivedValue
            OCTET STRING
    }

        bgpConfederationId

    bgpM2PeerCapReceivedCode OBJECT-TYPE
        SYNTAX     BgpAutonomousSystemNumber     Unsigned32 (0..255)
        MAX-ACCESS read-write read-only
        STATUS     current
        DESCRIPTION
            "The local Confederation Identification Number.

                A value of zero (0) indicates the absence of this
                value."
            REFERENCE
                "RFC 3065 - Autonomous System Confederations for BGP" BGP Capability Advertisement Capability Code."
        ::= { bgpBaseScalarASConfederationExts bgpM2PeerCapsReceivedEntry 1 }

          --
        -- Base Scalar Route Reflection Extensions
        --

        bgpBaseScalarRouteReflectionExts OBJECT IDENTIFIER ::=
            { bgpBaseScalarNonCapExts 1966 }

        bgpClusterId

    bgpM2PeerCapReceivedIndex OBJECT-TYPE
        SYNTAX      BgpIdentifier     Unsigned32 (1..128)
        MAX-ACCESS  read-write read-only
        STATUS     current
        DESCRIPTION
                "The configured Cluster-ID of the local router.

                A value of 0.0.0.0 indicates the absence
            "Multiple instances of this
                value."
            REFERENCE
                "RFC 2796 - a given capability may be sent
             bgp a BGP Route Reflection" speaker.  This variable is used to index them."
        ::= { bgpBaseScalarRouteReflectionExts 1 bgpM2PeerCapsReceivedEntry 2 }

        bgpPeer
        OBJECT IDENTIFIER

    bgpM2PeerCapReceivedValue OBJECT-TYPE
        SYNTAX     OCTET STRING (SIZE(0..255))
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The value of the announced capability."
        ::= { bgp 2 bgpM2PeerCapsReceivedEntry 3 }

        bgpPeerData

    --
    -- Per-peer counters
    --

    bgpM2PeerCounters
        OBJECT IDENTIFIER ::= { bgpPeer 1 bgpM2Peer 6 }

        --
        -- BGP Peer Data
        --

        bgpPeerTable

    bgpM2PeerCountersTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpPeerEntry BgpM2PeerCountersEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
                "BGP peer table.

                This table contains, one entry per BGP peer,
                and information about the connections
            "The counters associated with a BGP
                peers." Peer."
        ::= { bgpPeerData bgpM2PeerCounters 1 }

        bgpPeerEntry

    bgpM2PeerCountersEntry OBJECT-TYPE
        SYNTAX     BgpPeerEntry     BgpM2PeerCountersEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
                "Entry containing information about the connection with
            "Each entry contains counters of message transmissions
             and FSM transitions for a given BGP peer."
            INDEX Peering session."
        AUGMENTS {
                -- JMH We should only need one AddrType?
                bgpPeerLocalAddrType,
                bgpPeerLocalAddr,
                bgpPeerRemoteAddrType,
                bgpPeerRemoteAddr
            bgpM2PeerEntry
        }
        ::= { bgpPeerTable bgpM2PeerCountersTable 1 }

        BgpPeerEntry

    BgpM2PeerCountersEntry ::= SEQUENCE {
                bgpPeerIdentifier
                    BgpIdentifier,
                bgpPeerState
                    INTEGER,
                bgpPeerAdminStatus
                    INTEGER,
                bgpPeerConfiguredVersion
                    Unsigned32,
                bgpPeerNegotiatedVersion
                    Unsigned32,
                bgpPeerLocalAddrType
                    InetAddressType,
                bgpPeerLocalAddr
                    InetAddress,
                bgpPeerLocalPort
                    Integer32,
                bgpPeerLocalAs
                    BgpAutonomousSystemNumber,
                bgpPeerRemoteAddrType
                    InetAddressType,
                bgpPeerRemoteAddr
                    InetAddress,
                bgpPeerRemotePort
                    Integer32,
                bgpPeerRemoteAs
                    BgpAutonomousSystemNumber,
                bgpPeerIndex
                    Unsigned32,
                bgpPeerRowEntryStatus
                    RowStatus
        bgpM2PeerInUpdates
            Counter32,
        bgpM2PeerOutUpdates
            Counter32,
        bgpM2PeerInTotalMessages
            Counter32,
        bgpM2PeerOutTotalMessages
            Counter32,
        bgpM2PeerFsmEstablishedTrans
            Counter32
    }

        bgpPeerIdentifier

-- +++wayne need to describe what happens if connection is broken
-- and then reestablished. Does the prior counter value accumulate?
    bgpM2PeerInUpdates OBJECT-TYPE
        SYNTAX     BgpIdentifier     Counter32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The BGP Identifier number of BGP UPDATE messages received on this entry's
             connection.  This object should be initialized to zero
             (0) when the connection is established."
        ::= { bgpM2PeerCountersEntry 1 }

    bgpM2PeerOutUpdates OBJECT-TYPE
        SYNTAX     Counter32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The number of BGP peer. UPDATE messages transmitted on this
             connection.  This entry object should be 0.0.0.0 unless initialized to zero
             (0) when the bgpPeerState connection is
                 in established."
        ::= { bgpM2PeerCountersEntry 2 }

    bgpM2PeerInTotalMessages OBJECT-TYPE
        SYNTAX     Counter32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The total number of messages received from the openconfirm or remote
             peer on this connection.  This object should be
             initialized to zero when the established state." connection is established."
        ::= { bgpPeerEntry 1 bgpM2PeerCountersEntry 3 }

        bgpPeerState

    bgpM2PeerOutTotalMessages OBJECT-TYPE
        SYNTAX     INTEGER     Counter32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The total number of messages transmitted to the remote
             peer on this connection.  This object should be
             initialized to zero when the connection is established."
        ::= {
                idle(1),
                connect(2),
                active(3),
                opensent(4),
                openconfirm(5),
                established(6) bgpM2PeerCountersEntry 4 }

    bgpM2PeerFsmEstablishedTrans OBJECT-TYPE
        SYNTAX     Counter32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
        "The total number of times the BGP peer's FSM state."
        transitioned into the established state
        for this peer."
        ::= { bgpPeerEntry 2 bgpM2PeerCountersEntry 5 }

    -- JMH
        -- The work here is done by a transition.
        -- This implies that we stay in a state even though
    -- automatic start/stop events imply strobing something Per-Peer Prefix Counters
    -- even when the state machine is running.
        bgpPeerAdminStatus

    bgpM2PrefixCountersTable OBJECT-TYPE
        SYNTAX     INTEGER {
                stop(1),
                start(2)
            }     SEQUENCE OF BgpM2PrefixCountersEntry
        MAX-ACCESS read-write not-accessible
        STATUS     current
        DESCRIPTION
                "The desired state of the BGP connection.

                 A transition from 'stop' to 'start' will cause the BGP
                 Start Event to be generated.

                 A transition from 'start' to 'stop' will cause the BGP
                 Stop Event to be generated.

                 This parameter can be used to restart BGP peer
                 connections.  Care should be used in providing write
                 access to this object without adequate authentication."
            "Additional per-peer, per AFI SAFI counters for prefixes"
        ::= { bgpPeerEntry 3 bgpM2PeerCounters 2 }

        -- JMH
        -- Added this
        bgpPeerConfiguredVersion

    bgpM2PrefixCountersEntry OBJECT-TYPE
        SYNTAX     Unsigned32 (1..255)     BgpM2PrefixCountersEntry
        MAX-ACCESS read-write not-accessible
        STATUS     current
        DESCRIPTION
                "The configured version to originally start with this
                 peer.  The BGP speaker may permit negotiation to
            "Entry containing information about a
                 lower version number of the protocol." bgp-peers prefix
             counters."
        INDEX {
            bgpM2PeerIndex,
            bgpM2PrefixCountersAfi,
            bgpM2PrefixCountersSafi
        }
        ::= { bgpPeerEntry 4 bgpM2PrefixCountersTable 1 }

    BgpM2PrefixCountersEntry ::= SEQUENCE {
        bgpM2PrefixCountersAfi
            InetAddressType,
        bgpM2PrefixCountersSafi
            BgpM2Safi,
        bgpM2PrefixInPrefixes
            Gauge32,
        bgpM2PrefixInPrefixesAccepted
            Gauge32,
        bgpM2PrefixInPrefixesRejected
            Gauge32,
        bgpM2PrefixOutPrefixes
            Gauge32
    }

        bgpPeerNegotiatedVersion

    bgpM2PrefixCountersAfi OBJECT-TYPE
        SYNTAX     Unsigned32 (1..255)     InetAddressType
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The negotiated version AFI index of BGP running between the two
                 peers." per-peer, per prefix counters"
        ::= { bgpPeerEntry 5 bgpM2PrefixCountersEntry 1 }

        bgpPeerLocalAddrType

    bgpM2PrefixCountersSafi OBJECT-TYPE
        SYNTAX     InetAddressType     BgpM2Safi
        MAX-ACCESS read-write read-only
        STATUS     current
        DESCRIPTION
            "The address family of the local end SAFI index of the peering
                 session." per-peer, per prefix counters"
        ::= { bgpPeerEntry 6 bgpM2PrefixCountersEntry 2 }
        bgpPeerLocalAddr

    bgpM2PrefixInPrefixes OBJECT-TYPE
        SYNTAX     InetAddress (SIZE (20))     Gauge32
        MAX-ACCESS read-write read-only
        STATUS     current
        DESCRIPTION
            "The address of the local end number of prefixes received from a peer and are
             stored in the peering session." Adj-Ribs-In for that peer."
             -- jmh - note that we are allowing stuff to be discarded
        ::= { bgpPeerEntry bgpM2PrefixCountersEntry 7 }

        bgpPeerLocalPort

    bgpM2PrefixInPrefixesAccepted OBJECT-TYPE
        SYNTAX     Integer32 (-1 | 0..65535)     Gauge32
        MAX-ACCESS read-only
            STATUS     current
            DESCRIPTION
                "The local port for the transport connection between the BGP
                 peers.  In the case
        STATUS     current
        DESCRIPTION
            "The number of a transport prefixes for which a peer that are installed
             in the notion of
                 'port' is irrelevant, an instance value of -1 should be returned
                 by Adj-Ribs-In and are eligible to become active
             in the agent for this object." Loc-Rib."
        ::= { bgpPeerEntry bgpM2PrefixCountersEntry 8 }

        bgpPeerLocalAs

    bgpM2PrefixInPrefixesRejected OBJECT-TYPE
        SYNTAX     BgpAutonomousSystemNumber     Gauge32
        MAX-ACCESS read-write read-only
        STATUS     current
        DESCRIPTION
                "Some implementations
            "The number of BGP can represent themselves
                 as multiple ASs.  This is the AS prefixes for a peer that this peering
                 session is representing itself as are installed
             in the Adj-Ribs-In and are NOT eligible to become active
             in the remote peer." Loc-Rib."
        ::= { bgpPeerEntry bgpM2PrefixCountersEntry 9 }

        bgpPeerRemoteAddrType

    bgpM2PrefixOutPrefixes OBJECT-TYPE
        SYNTAX     InetAddressType     Gauge32
        MAX-ACCESS read-write read-only
        STATUS     current
        DESCRIPTION
            "The address family of the remote end number of the peering
                 session." prefixes for a peer that are installed
             in that peers Adj-Ribs-Out."
        ::= { bgpPeerEntry bgpM2PrefixCountersEntry 10 }

        bgpPeerRemoteAddr

    bgpM2PeerExtensions
        OBJECT IDENTIFIER ::= { bgpM2Peer 7 }

    bgpM2PeerNonCapExts
        OBJECT IDENTIFIER ::= { bgpM2PeerExtensions 1 }

    bgpM2PeerCapExts
        OBJECT IDENTIFIER ::= { bgpM2PeerExtensions 2 }

    --
    -- Peer Route Reflection Extensions
    --

    bgpM2PeerRouteReflectionExts
        OBJECT IDENTIFIER ::= { bgpM2PeerNonCapExts 2796 }

    bgpM2PeerReflectorClientTable OBJECT-TYPE
        SYNTAX     InetAddress (SIZE (20))     SEQUENCE OF BgpM2PeerReflectorClientEntry
        MAX-ACCESS read-write not-accessible
        STATUS     current
        DESCRIPTION
                "The address of the remote end
            "Table of the peering session." route reflection client settings on a per-peer
             basis."
        REFERENCE
            "RFC 2796 - BGP Route Reflection"
        ::= { bgpPeerEntry 11 bgpM2PeerRouteReflectionExts 1 }

        bgpPeerRemotePort

    bgpM2PeerReflectorClientEntry OBJECT-TYPE
        SYNTAX     Integer32 (-1 | 0..65535)     BgpM2PeerReflectorClientEntry
        MAX-ACCESS      read-write not-accessible
        STATUS     current
        DESCRIPTION
                "The remote port for the TCP connection between
                 the BGP peers.  In the case of
            "Entry containing data on a transport for
                 which per-peer basis on whether
             the notion of 'port' peer is irrelevant, an
                 instance value of -1 should be returned
                 by the agent for this object.

                 -- JMH - this text needs updating
                 Note that the objects bgpPeerLocalAddr,
                 bgpPeerLocalPort, bgpPeerRemoteAddr and
                 bgpPeerRemotePort provide the appropriate reference to
                 the standard MIB TCP connection table. or even the ipv6
                 tcp MIB configured as in rfc2452." a route reflector client."
        REFERENCE
            "RFC 2796 - BGP Route Reflection"
        AUGMENTS {
            bgpM2PeerEntry
        }
        ::= { bgpPeerEntry 12 bgpM2PeerReflectorClientTable 1 }

        bgpPeerRemoteAs OBJECT-TYPE
            SYNTAX     BgpAutonomousSystemNumber
            MAX-ACCESS read-write
            STATUS     current
            DESCRIPTION
                "The remote autonomous system number."

    BgpM2PeerReflectorClientEntry ::= SEQUENCE { bgpPeerEntry 13
        bgpM2PeerReflectorClient
            INTEGER
    }

        bgpPeerIndex

    bgpM2PeerReflectorClient OBJECT-TYPE
        SYNTAX      Unsigned32    INTEGER {
            nonClient(0),
            client(1),
            meshedClient(2)
        }
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "This value is a unique index for indicates whether the given peer entry in the
                 bgpPeerTable.  It is assigned by the agent at the point a
             reflector client of creation this router, or not.  A value of the bgpPeerTable row entry.  While its
             nonClient indicates that this peer is not a reflector
             client.  A value of client indicates that this peer is guaranteed to be unique at any time, it a
             reflector client that is
                 otherwise opaque to the management application not fully meshed with
                 respect to its other
             reflector clients.  A value or the contiguity of bgpPeerIndex
                 row instance values across rows of meshedClient indicates
             that the bgpPeerTable.  It peer is used to provide an index structure for other tables
                 whose data a reflector client and is logically per-peer." fully meshed
             with all other reflector clients.

             This value must be nonClient (0) for BGP external peers."
        REFERENCE
            "RFC 2796 - BGP Route Reflection"
        ::= { bgpM2PeerReflectorClientEntry 1 }

    -- +++wayne (from Tom Nadeau): need text describing fate sharing of index, if
    -- peering session comes up, peer disconnects, and then this or other peer Peer AS Confederations Extensions
    -- connects again.  Will this grow monotonically? (I think that's

    bgpM2PeerASConfederationExts
        OBJECT IDENTIFIER ::= { bgpM2PeerNonCapExts 3065 }

    bgpM2PeerConfedMemberTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpM2PeerConfedMemberEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "Table of confederation member settings on a per-peer
             basis."
        REFERENCE
            "RFC 3065 - BGP Confederations"
        ::= { bgpM2PeerASConfederationExts 1 }

    bgpM2PeerConfedMemberEntry OBJECT-TYPE
        SYNTAX     BgpM2PeerConfedMemberEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "Entry containing data on a per-peer basis on whether
             the question) peer is configured as a BGP confederation member."
        REFERENCE
            "RFC 3065 - BGP Confederations"
        AUGMENTS {
            bgpM2PeerEntry
        }
        ::= { bgpPeerEntry 14 bgpM2PeerConfedMemberTable 1 }

    BgpM2PeerConfedMemberEntry ::= SEQUENCE {
        bgpM2PeerConfedMember
            TruthValue
    }

        bgpPeerRowEntryStatus

    bgpM2PeerConfedMember OBJECT-TYPE
        SYNTAX      RowStatus      TruthValue
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "This object type reflects the status of the row within the
                agent.  Note that this is independent of the bgpPeerAdminStatus
                which reflects the underlying peering session itself.  An instance
                of this row is returned by the agent to reflect the validity of the
                current state of this row.  The valid RowStatus enumeration values
                for this are 'active', 'notInService', and 'notReady'."
-- +++wayne need better definition of the three states, better analysis of
-- value indicates whether this should be read-write, and what, if any, the interaction of setting
-- bgpPeerAdminStatus to 'stop'.  At some point, the entry should age out of the
-- agent, and this needs to track that (in addition to its creation from
-- bgpPeerCfgTable row data). given peer is in our
             confederation or not."
        REFERENCE
            "RFC 3065 - BGP Confederations"
        ::= { bgpPeerEntry 15 bgpM2PeerConfedMemberEntry 1 }

        bgpPeerErrors

    --
    -- Peer configuration objects
    --

    bgpM2PeerConfiguration
        OBJECT IDENTIFIER ::= { bgpPeer 2 bgpM2Peer 8 }

        bgpPeerErrorsTable

    --
    -- Administering activated peering sessions
    --
    bgpM2CfgPeerAdminStatusTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpPeerErrorsEntry BgpM2CfgPeerAdminStatusEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
                "On a per peer basis, this table reflects the last
                    protocol-defined error encountered and reported on the
                    peer session.  If no entry
            "Table containing rows for a given peer, by its
                    bgpPeerIndex, exists in this table, then no such errors
                    have been observed, reported, administratively starting and recorded on the
                    session."
             stopping peering sessions."
        ::= { bgpPeerErrors bgpM2PeerConfiguration 1 }

        bgpPeerErrorsEntry

    bgpM2CfgPeerAdminStatusEntry OBJECT-TYPE
        SYNTAX     BgpPeerErrorsEntry     BgpM2CfgPeerAdminStatusEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
                "Each entry contains information about an error on
                    a given BGP peer session."
            "Entry containing row for administratively starting and
             stopping peers."
        INDEX { bgpPeerIndex
            bgpM2PeerIndex
        }
        ::= { bgpPeerErrorsTable bgpM2CfgPeerAdminStatusTable 1 }

        BgpPeerErrorsEntry

    BgpM2CfgPeerAdminStatusEntry ::= SEQUENCE {
            bgpPeerLastError
                OCTET STRING,
            bgpPeerLastErrorData
                Unsigned32
        bgpM2CfgPeerAdminStatus
            INTEGER
    }

        bgpPeerLastError

    bgpM2CfgPeerAdminStatus OBJECT-TYPE
        SYNTAX     OCTET STRING (SIZE (2))      INTEGER {
            stop(1),
            start(2)
        }
        MAX-ACCESS read-only read-write
        STATUS  current
        DESCRIPTION
                "The last error code and subcode seen by this peer on
                 this connection.  If no error has occurred, this field
                 is zero.  Otherwise, the first byte of this two byte
                 OCTET STRING contains the error code, and the second
                 byte contains
            "This object allows the subcode."
            REFERENCE
                "draft-ietf-bgp4-15.txt, Sec. 4.5" Manual Stop and Manual Start
             events to be sent to an activated peering session."
        ::= { bgpPeerErrorsEntry bgpM2CfgPeerAdminStatusEntry 1 }

        bgpPeerLastErrorData

    --
    -- Peer Configuration
    --

    bgpM2CfgPeerNextIndex OBJECT-TYPE
        SYNTAX     Unsigned32 (0..4075)     Integer32 (0..65535)
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "The last error code's data seen by this peer on
            "This object contains the next appropriate value to
             use as an index for creation of a row instance in
             in the bgpM2CfgPeerTable.  If the number of available
             entries in the bgpM2CfgPeerTable is exhausted, a
             retrieval value of this
                 connection." object instance will return
             0.  A value of 0 may also be returned if the agent
             is otherwise incapable of bgpM2CfgPeerTable row creation
             at the time of bgpM2CfgPeerNextIndex retrieval."
        ::= { bgpPeerErrorsEntry bgpM2PeerConfiguration 2 }

        bgpPeerAuthentication
        OBJECT IDENTIFIER ::= { bgpPeer 3 }

        --
        -- Peer Authentication
        --

        bgpPeerAuthTable

    bgpM2CfgPeerTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpPeerAuthEntry BgpM2CfgPeerEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "BGP configuration peer authentication table.

             This table contains, one entry per BGP peer,
                 information about allows the authentication configuration of the parameters
             for a session with a BGP peers." peer.

             +++wayne provide description of how config should be done
             for a peer per table."
        ::= { bgpPeerAuthentication 1 bgpM2PeerConfiguration 3 }
        bgpPeerAuthEntry

    bgpM2CfgPeerEntry OBJECT-TYPE
        SYNTAX     BgpPeerAuthEntry     BgpM2CfgPeerEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "Entry containing information about the authentication set up by a management
             entity to configure a connection with a BGP peer."
        INDEX { bgpPeerIndex bgpM2CfgPeerIndex }
        ::= { bgpPeerAuthTable bgpM2CfgPeerTable 1 }

        BgpPeerAuthEntry

    BgpM2CfgPeerEntry ::= SEQUENCE {
            bgpPeerAuthSent
                TruthValue,
            bgpPeerAuthSentCode
        bgpM2CfgPeerConfiguredVersion
            Unsigned32,
            bgpPeerAuthSentValue
                OCTET STRING,
            bgpPeerAuthRcvd
        bgpM2CfgAllowVersionNegotiation
            TruthValue,
            bgpPeerAuthRcvdCode
                Unsigned32,
            bgpPeerAuthRcvdValue
                OCTET STRING
        bgpM2CfgPeerLocalAddrType
            InetAddressType,
        bgpM2CfgPeerLocalAddr
            InetAddress,
        bgpM2CfgPeerLocalAs
            InetAutonomousSystemNumber,
        bgpM2CfgPeerRemoteAddrType
            InetAddressType,
        bgpM2CfgPeerRemoteAddr
            InetAddress,
        bgpM2CfgPeerRemotePort
            Integer32,
        bgpM2CfgPeerRemoteAs
            InetAutonomousSystemNumber,
        bgpM2CfgPeerEntryStorageType
            StorageType,
        bgpM2CfgPeerError
            INTEGER,
        bgpM2CfgPeerBgpPeerEntry
            RowPointer,
        bgpM2CfgPeerRowEntryStatus
            RowStatus,
        bgpM2CfgPeerIndex
            Integer32,
        bgpM2CfgPeerStatus
            INTEGER
        }

        bgpPeerAuthSent

    bgpM2CfgPeerConfiguredVersion OBJECT-TYPE
        SYNTAX TruthValue     Unsigned32 (1..255)
        MAX-ACCESS read-write read-create
        STATUS     current
        DESCRIPTION
            "The local peer has sent authentication configured version to originally start with
             this peer.  The BGP speaker may permit negotiation
             to a lower version number of the remote peer in protocol depending on the BGP Authentication
                    field."
             set value of bgpM2CfgAllowVersionNegotiation."
        DEFVAL     { 4 }
        ::= { bgpPeerAuthEntry bgpM2CfgPeerEntry 1 }

         bgpPeerAuthSentCode

    bgpM2CfgAllowVersionNegotiation OBJECT-TYPE
        SYNTAX  Unsigned32 (0..255)     TruthValue
        MAX-ACCESS read-write read-create
        STATUS     current
        DESCRIPTION
                "The code of the authentication information sent
                the remote peer."
            "If set to true, during session establishment with this
             peer, negotiation to a version lower than that specified
             in bgpM2CfgPeerConfiguredVersion will be allowed."
        DEFVAL { false }
        ::= { bgpPeerAuthEntry bgpM2CfgPeerEntry 2 }
        bgpPeerAuthSentValue OBJECT-TYPE
            SYNTAX  OCTET STRING (SIZE (0..255))
        -- jmh length is too much
        -- +++wayne get value from...IPSec MIB? Any opaque TC there to use? }

    bgpM2CfgPeerLocalAddrType OBJECT-TYPE
        SYNTAX     InetAddressType
        MAX-ACCESS read-write read-create
        STATUS     current
        DESCRIPTION
            "The payload address family of the authentication information
                from the remote peer." speakers of this BGP
             session."
        ::= { bgpPeerAuthEntry bgpM2CfgPeerEntry 3 }

        bgpPeerAuthRcvd

    bgpM2CfgPeerLocalAddr OBJECT-TYPE
        SYNTAX TruthValue     InetAddress (SIZE (4..20))
        MAX-ACCESS read-only read-create
        STATUS     current
        DESCRIPTION
            "The local peer has received authentication
                from address of the remote peer in local end of the BGP Authentication
                field." peering session."
        ::= { bgpPeerAuthEntry bgpM2CfgPeerEntry 4 }

        bgpPeerAuthRcvdCode

    bgpM2CfgPeerLocalAs OBJECT-TYPE
        SYNTAX  Unsigned32 (0..255)     InetAutonomousSystemNumber
        MAX-ACCESS read-only read-create
        STATUS     current
        DESCRIPTION
                "The code
            "Autonomous system represented to peer on peering
             session initialization.  Some implementations of
             BGP can represent themselves as multiple ASes.
             These implementations can set this to an alternate
             autonomous system.  If this object is set to zero
             (0) at the authentication information
                from point this row instance is set to active,
             then the remote peer." implementation will initialize this session
             representing itself as the value of bgpM2CfgLocalAs."
        DEFVAL { 0 }
        ::= { bgpPeerAuthEntry bgpM2CfgPeerEntry 5 }

        bgpPeerAuthRcvdValue

    bgpM2CfgPeerRemoteAddrType OBJECT-TYPE
        SYNTAX  OCTET STRING (SIZE (0..255))
        -- jmh length is too much     InetAddressType
        MAX-ACCESS read-only read-create
        STATUS     current
        DESCRIPTION
            "The payload address family of the authentication information
                from speakers of the remote peer." BGP
             session."
        ::= { bgpPeerAuthEntry bgpM2CfgPeerEntry 6 }

        bgpPeerTimers
        OBJECT IDENTIFIER
    bgpM2CfgPeerRemoteAddr OBJECT-TYPE
        SYNTAX      InetAddress (SIZE(4..20))
        MAX-ACCESS  read-create
        STATUS      current
        DESCRIPTION
            "The address of the remote end (destination address
             of peer) for peering session."
        ::= { bgpPeer 4 bgpM2CfgPeerEntry 7 }

    --
        -- Peer Event Times
        --

        bgpPeerEventTimesTable JMH - this isn't compatible with InetPortNumber
    bgpM2CfgPeerRemotePort  OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpPeerEventTimesEntry      Integer32 (-1 | 0..65535)
        MAX-ACCESS not-accessible  read-create
        STATUS      current
        DESCRIPTION
                "A table reporting
            "This is the per-peering session amount remote port for the transport connection
             between the BGP peers.  In the case of time
                    elapsed and update events since a transport for
             which the peering session
                advanced into notion of port is irrelevant, the 'established' state." value of
             -1 can be defaulted or set."
        DEFVAL { -1 }
        ::= { bgpPeerTimers 1 bgpM2CfgPeerEntry 8 }

        bgpPeerEventTimesEntry

    bgpM2CfgPeerRemoteAs OBJECT-TYPE
        SYNTAX     BgpPeerEventTimesEntry     InetAutonomousSystemNumber
        MAX-ACCESS not-accessible read-create
        STATUS     current
        DESCRIPTION
                "Each row contains a set
            "Autonomous system number of statistics about time
                    spent and events encountered in the peer session
                'established' state."
            INDEX { bgpPeerIndex } remote peer."
        ::= { bgpPeerEventTimesTable 1 bgpM2CfgPeerEntry 9 }

        BgpPeerEventTimesEntry

    bgpM2CfgPeerEntryStorageType OBJECT-TYPE
        SYNTAX     StorageType
        MAX-ACCESS read-create
        STATUS     current
        DESCRIPTION
            "This object type specifies the intended storage
             type for the bgpM2CfgPeerEntry row instance."
        ::= SEQUENCE {
            bgpPeerFsmEstablishedTime
                Gauge32,
            bgpPeerInUpdatesElapsedTime
                Gauge32 bgpM2CfgPeerEntry 10 }

        bgpPeerFsmEstablishedTime

    -- JMH - Can we mix caps the enumerations?
    bgpM2CfgPeerError  OBJECT-TYPE
        SYNTAX     Gauge32      INTEGER {
            unknown(0),
            notactivated (1),
            errduplicatepeeringsession (2),
            activated (3)
            -- +++wayne more to follow
        }
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "This timer value indicates how long (in seconds) the current error status of
             the row denoting the configured error status.

             If this row is still under creation (has not been activated
             bgpM2CfgPeerRowEntryStatus), then this instance will be set to
             not-activated (1).

             At the point that the row is activated, bgpM2CfgPeerError
             will reflect the error status of the row data itself.  If
             there is another session already activated with the same
             local and remote addresses as denoted by
             {bgpM2CfgPeerLocalAddrType, bgpM2CfgPeerLocalAddr,
             bgpM2CfgPeerRemoteAddr, bgpM2CfgPeerRemotePort}, then
             the value of this will be set to
             err-duplicate-peering-session (2).

             If this row is associated with a peer session whose
             initialization has been attempted, the value will be
             set to activated (3) (and, bgpM2PeerCfgPeerEntry will
             be set to the row instance of the entry in the Established
             bgpM2PeerTable which reflects the state or how long
                since of the peering
             session).

             Note that this peer was last in object only reflects the Established state.
                It is set to zero when error as a new peer is configured or
             function of the router attempted activation of this row as
             containing data for a bgp peering session.  The actual
             state of the session at the point of any protocol exchange
             or session state machine initiation is booted." reflected in the
             bgpM2PeerTable row instance (as reflected through
             bgpM2CfgPeerPeerEntry) associated with this row instance."
        ::= { bgpPeerEventTimesEntry 1 bgpM2CfgPeerEntry 11 }

        bgpPeerInUpdatesElapsedTime

    bgpM2CfgPeerBgpPeerEntry OBJECT-TYPE
        SYNTAX     Gauge32      RowPointer
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
                 "Elapsed time
            "Upon activation of the session data contained in seconds since this
             row instance, this object points to an instance of a row
             within the last BGP
                message was received from bgpM2PeerTable reflecting the peer.  Each time
                bgpPeerInUpdates is incremented, session in its
             initializing or operational state.  Retrieval of this
             column instance will always yield a value of {0.0} unless
             the session has successfully been activated (via
             bgpM2CfgPeerRowEntryStatus).  Such row instances will always
             have a value of this
                object is set to zero (0)." bgpM2CfgPeerError which is activated (3)."
        ::= { bgpPeerEventTimesEntry 2 bgpM2CfgPeerEntry 12 }

        --
        -- Peer Configured Timers
        --

        bgpPeerConfiguredTimersTable

    bgpM2CfgPeerRowEntryStatus  OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpPeerConfiguredTimersEntry     RowStatus
        MAX-ACCESS not-accessible read-create
        STATUS     current
        DESCRIPTION
                "Per peer management data on BGP session timers."
            "This object type is used to control creation,
             activation, and deletion of this row instance."
            -- +++wayne need better directions for agent auto-removal
            -- of row instances which have moved to active or error
            -- state
        ::= { bgpPeerTimers 2 bgpM2CfgPeerEntry 13 }

        bgpPeerConfiguredTimersEntry

    bgpM2CfgPeerIndex OBJECT-TYPE
        SYNTAX     BgpPeerConfiguredTimersEntry     Integer32 (1..65535)
        MAX-ACCESS not-accessible accessible-for-notify
        STATUS     current
        DESCRIPTION
                "Each entry corresponds to the current state
            "Uniquely identifies an instance of BGP
                    timers on a given peering session."
            INDEX { bgpPeerIndex }
            ::= { bgpPeerConfiguredTimersTable 1 }

        BgpPeerConfiguredTimersEntry peer row, as
             an element of configuration."
        ::= SEQUENCE {
            bgpPeerConnectRetryInterval
                Unsigned32,
            bgpPeerHoldTimeConfigured
                Unsigned32,
            bgpPeerKeepAliveConfigured
                Unsigned32,
            bgpPeerMinASOriginationInterval
                Unsigned32,
            bgpPeerMinRouteAdvertiseInterval
                Unsigned32 bgpM2CfgPeerEntry 14 }

        bgpPeerConnectRetryInterval

    bgpM2CfgPeerStatus OBJECT-TYPE
        SYNTAX     Unsigned32 (1..65535)      INTEGER {
            halted(1),
            running(2)
        }
        MAX-ACCESS read-write read-create
        STATUS  current
        DESCRIPTION
                "Time interval
             "This specifies the state of the peering session upon
              activation.  If disabled, the FSM is in seconds for the ConnectRetry
                timer.  The suggested value for this timer halted
              state and no Automatic Start events are generated.
              If enabled, the FSM is 120
                seconds." in the running state and
              Automatic Start events may be generated."
        ::= { bgpPeerConfiguredTimersEntry 1 bgpM2CfgPeerEntry 15 }

        bgpPeerHoldTimeConfigured

    --
    -- Per-peer authentication table.
    --

    bgpM2CfgPeerAuthTable OBJECT-TYPE
        SYNTAX     Unsigned32 ( 0 | 3..65535 )     SEQUENCE OF BgpM2CfgPeerAuthEntry
        MAX-ACCESS read-write not-accessible
        STATUS     current
        DESCRIPTION
                "Time interval in seconds for the Hold Time configured
                for this BGP speaker with this peer.  This value
                is placed in an OPEN message sent to this peer by
                this BGP speaker, and is compared with the Hold
                Time field in an OPEN message received from the
                peer when determining the Hold Time (bgpPeerHoldTime)
                with the peer.  This value must not be less than
                three seconds if it is not zero (0) in which case
                the Hold Time is NOT to be established with the
                peer.  The suggested value for this timer is 90
                seconds."
            REFERENCE
                "RFC 1771, p. 9"
            "Table contain per peer configuration for BGP Authentication."
        ::= { bgpPeerConfiguredTimersEntry 2 bgpM2PeerConfiguration 4 }

        bgpPeerKeepAliveConfigured

    bgpM2CfgPeerAuthEntry OBJECT-TYPE
        SYNTAX     Unsigned32 ( 0 | 1..21845 )     BgpM2CfgPeerAuthEntry
        MAX-ACCESS read-write not-accessible
        STATUS     current
        DESCRIPTION
                "Time interval in seconds for the KeepAlive
                configured for this
            "Entry containing information about a peer's BGP speaker with this
                peer. The value of this object will only
                determine the KEEPALIVE messages' frequency
                relative to the Authentication
             configuration."
        AUGMENTS {
            bgpM2CfgPeerEntry
        }
        ::= { bgpM2CfgPeerAuthTable 1 }

    BgpM2CfgPeerAuthEntry ::= SEQUENCE {
        bgpM2CfgPeerAuthEnabled
            TruthValue,
        bgpM2CfgPeerAuthCode
            Unsigned32,
        bgpM2CfgPeerAuthValue
            OCTET STRING
    }

    bgpM2CfgPeerAuthEnabled OBJECT-TYPE
        SYNTAX     TruthValue
        MAX-ACCESS read-create
        STATUS     current
        DESCRIPTION
            "This value specified in
                bgpPeerHoldTimeConfigured; the actual time
                interval for the KEEPALIVE messages is
                indicated by bgpPeerKeepAlive.  A
                reasonable maximum value true if BGP Authentication is enabled for
             this timer
                would be configured to be one third
                of that of bgpPeerHoldTimeConfigured.

                If the value of this object peer.  This is zero (0),
                no periodical KEEPALIVE messages are sent to the peer after authentication mechanism
             documented in the base BGP connection has been
                established.

                The suggested value for this timer is 30
                seconds."
            REFERENCE
                "RFC 1771, pp. 17-18" specification, not the MD5
             session protection mechanism."
        DEFVAL {
            false
        }
        ::= { bgpPeerConfiguredTimersEntry 3 bgpM2CfgPeerAuthEntry 1 }

        bgpPeerMinASOriginationInterval
    bgpM2CfgPeerAuthCode OBJECT-TYPE
        SYNTAX     Unsigned32 (1..65535)     Unsigned32(0..255)
        MAX-ACCESS read-write read-create
        STATUS     current
        DESCRIPTION
                "Time interval in seconds
            "The authentication code for the
                timer.  The suggested value for this timer is 15
                seconds." BGP Authentication
             mechanism."
        REFERENCE
            "draft-ietf-idr-bgp4-17.txt, Sec. 4.1.a"
        ::= { bgpPeerConfiguredTimersEntry 4 bgpM2CfgPeerAuthEntry 2 }

        bgpPeerMinRouteAdvertiseInterval

    bgpM2CfgPeerAuthValue OBJECT-TYPE
        SYNTAX     Unsigned32 (1..65535)     OCTET STRING (SIZE(0..252))
        MAX-ACCESS read-write read-create
        STATUS     current
        DESCRIPTION
                "Time interval in seconds
            "The authentication payload for the
                MinRouteAdvertisementInterval timer.  The BGP authentication
             mechanism.  This value for this timer is 30 seconds." has semantic meaning within
             the context of the authentication code."
        REFERENCE
            "draft-ietf-idr-bgp4-17.txt, Sec. 4.1.a"
        ::= { bgpPeerConfiguredTimersEntry 5 bgpM2CfgPeerAuthEntry 3 }

    --
    -- Peer Negotiated Timers Per-peer timers table
    --

        bgpPeerNegotiatedTimersTable

    bgpM2CfgPeerTimersTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpPeerNegotiatedTimersEntry BgpM2CfgPeerTimersEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
                "Current values of per-peer timers which can be
                    dynamically set in the bgpPeerConfiguredTimersTable.
                    Values reflected in this table are the current
                operational values, after negotiation from values
                    derived from initial configuration or last set from
                    bgpPeerConfiguredTimersTable row instances."
            "Table for configuration of per-peer timers."
        ::= { bgpPeerTimers 3  bgpM2PeerConfiguration 5 }

        bgpPeerNegotiatedTimersEntry

    bgpM2CfgPeerTimersEntry OBJECT-TYPE
        SYNTAX     BgpPeerNegotiatedTimersEntry      BgpM2CfgPeerTimersEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
                "Each entry reflects a value of the currently
                    operational, negotiated timers as reflected in the
                    BgpPeerNegotiatedTimersEntry."
            INDEX
            "Entry containing per-peer timer configuration."
        AUGMENTS { bgpPeerIndex
            bgpM2CfgPeerEntry
        }
        ::= { bgpPeerNegotiatedTimersTable bgpM2CfgPeerTimersTable 1 }

        BgpPeerNegotiatedTimersEntry
    BgpM2CfgPeerTimersEntry ::= SEQUENCE {
            bgpPeerHoldTime
                Integer32,
            bgpPeerKeepAlive
                Integer32
        bgpM2CfgPeerConnectRetryInterval
            Unsigned32,
        bgpM2CfgPeerHoldTimeConfigured
            Unsigned32,
        bgpM2CfgPeerKeepAliveConfigured
            Unsigned32,
        bgpM2CfgPeerMinASOrigInterval
            Unsigned32,
        bgpM2CfgPeerMinRouteAdverInter
            Unsigned32
    }

        bgpPeerHoldTime

    bgpM2CfgPeerConnectRetryInterval OBJECT-TYPE
        SYNTAX     Integer32     Unsigned32 (1..65535)
        MAX-ACCESS read-create
        STATUS     current
        DESCRIPTION
            "Time interval in seconds for the ConnectRetry
             timer.  The suggested value for this timer is 120
             seconds."
        DEFVAL {
            120
        }
        ::= { bgpM2CfgPeerTimersEntry 1 }

    bgpM2CfgPeerHoldTimeConfigured OBJECT-TYPE
        SYNTAX     Unsigned32 ( 0 | 3..65535 )
        MAX-ACCESS read-only read-create
        STATUS     current
        DESCRIPTION
            "Time interval in seconds for the Hold Timer
                established Time configured
             for this BGP speaker with the this peer.  The  This value of this
             is calculated placed in an OPEN message sent to this peer by
             this BGP speaker by using the
                smaller of the value in bgpPeerHoldTimeConfigured speaker, and is compared with the Hold
             Time received field in the an OPEN message. message received from the
             peer when determining the Hold Time (bgpM2PeerHoldTime)
             with the peer.  This value must not be at least less than
             three seconds if it is not zero (0) in which case
             the Hold Timer has not
                been Time is NOT to be established with the peer, or, the
             peer.  The suggested value of
                bgpPeerHoldTimeConfigured is zero (0)."
-- +++wayne (from Tom Nadeau) would like to see enumerated cases of
-- description as for this has too many subcases. timer is 90
             seconds."
        REFERENCE
            "draft-ietf-idr-bgp4-17.txt, Appendix 6.4"
        DEFVAL {
            90
        }
        ::= { bgpPeerNegotiatedTimersEntry 1 bgpM2CfgPeerTimersEntry 2 }

        bgpPeerKeepAlive

    bgpM2CfgPeerKeepAliveConfigured OBJECT-TYPE
        SYNTAX     Integer32     Unsigned32 ( 0 | 1..21845 )
        MAX-ACCESS read-only read-create
        STATUS     current
        DESCRIPTION
            "Time interval in seconds for the KeepAlive timer
                established
             configured for this BGP speaker with the this peer.
             The value of this object will only determine the
             KEEPALIVE messages frequency relative to the value
             specified in bgpM2PeerHoldTimeConfigured; the actual
             time interval for the KEEPALIVE messages is calculated indicated
             by bgpM2PeerKeepAlive.  A reasonable maximum value
             for this BGP speaker such that, when
                compared with bgpPeerHoldTime, it has the same
                proportion as what bgpPeerKeepAliveConfigured has
                when compared with bgpPeerHoldTimeConfigured. timer would be configured to be one third
             of that of bgpM2PeerHoldTimeConfigured.

             If the value of this object is zero (0), it indicates
                that value of this object is zero (0), no
             periodical KEEPALIVE messages are sent to the peer
             after the KeepAlive timer BGP connection has not been established
                with the peer, or, the established.
             The suggested value of
                bgpPeerKeepAliveConfigured for this timer is zero (0)."
            ::= 30 seconds."
        REFERENCE
            "draft-ietf-idr-bgp4-17.txt, Appendix 6.4"
        DEFVAL { bgpPeerNegotiatedTimersEntry 2
            30
        }
        bgpPeerCapabilities
        OBJECT IDENTIFIER
        ::= { bgpPeer 5 bgpM2CfgPeerTimersEntry 3 }

        --
        -- Peer Capabilities
        --

        --
        -- Announced Capabilities
        --

        bgpPeerCapsAnnouncedTable

    bgpM2CfgPeerMinASOrigInterval OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpPeerCapsAnnouncedEntry     Unsigned32 (0..65535)
        MAX-ACCESS not-accessible read-create
        STATUS     current
        DESCRIPTION
                "This table contains contains
            "Time interval in seconds for the capabilities
                that are supported MinASOriginationInterval
             timer.  The suggested value for a given peer." this timer is 15
             seconds."
        DEFVAL {
            15
        }
        ::= { bgpPeerCapabilities 1 bgpM2CfgPeerTimersEntry 4 }

        bgpPeerCapsAnnouncedEntry

    bgpM2CfgPeerMinRouteAdverInter OBJECT-TYPE
        SYNTAX     BgpPeerCapsAnnouncedEntry     Unsigned32 (0..65535)
        MAX-ACCESS not-accessible read-create
        STATUS     current
        DESCRIPTION
                "These entries are keyed by a BGP-4 peer remote
                address and
            "Time interval in seconds for the BGP Capability Code"
            INDEX
             MinRouteAdvertisementInterval timer.  The suggested
             value for this timer is 30 seconds."
        DEFVAL {
                bgpPeerIndex,
                bgpPeerCapAnnouncedCode,
                bgpPeerCapAnnouncedIndex
            30
        }
        ::= { bgpPeerCapsAnnouncedTable 1 bgpM2CfgPeerTimersEntry 5 }

        BgpPeerCapsAnnouncedEntry

    --
    -- Per-peer configuration extensions
    --

    bgpM2CfgPeerExtensions
        OBJECT IDENTIFIER ::= SEQUENCE {
                bgpPeerCapAnnouncedCode
                    Unsigned32,
                bgpPeerCapAnnouncedIndex
                    Unsigned32,
                bgpPeerCapAnnouncedLength
                    Unsigned32,
                bgpPeerCapAnnouncedValue
                    OCTET STRING bgpM2PeerConfiguration 6 }
        bgpPeerCapAnnouncedCode OBJECT-TYPE
            SYNTAX     Unsigned32 (0..255)
            MAX-ACCESS read-only
            STATUS     current
            DESCRIPTION
                "The BGP Capability Advertisement Capability Code."

    bgpM2CfgPeerNonCapExts
        OBJECT IDENTIFIER ::= { bgpPeerCapsAnnouncedEntry bgpM2CfgPeerExtensions 1 }

        bgpPeerCapAnnouncedIndex OBJECT-TYPE
            SYNTAX     Unsigned32 (1..128)
            MAX-ACCESS read-only
            STATUS     current
            DESCRIPTION
                "Multiple instances of a given capability may be sent
                bgp a BGP speaker.  This variable is used to index them."

    bgpM2CfgPeerCapExts
        OBJECT IDENTIFIER ::= { bgpPeerCapsAnnouncedEntry bgpM2CfgPeerExtensions 2 }

        bgpPeerCapAnnouncedLength OBJECT-TYPE
            SYNTAX     Unsigned32
            MAX-ACCESS read-only
            STATUS     current
            DESCRIPTION
                "The length of the announced capability."
            ::= { bgpPeerCapsAnnouncedEntry 3 }

        bgpPeerCapAnnouncedValue OBJECT-TYPE
            SYNTAX     OCTET STRING (SIZE(0..255))
            MAX-ACCESS read-only
            STATUS     current
            DESCRIPTION
                "The value of the announced capability."
            ::= { bgpPeerCapsAnnouncedEntry 4 }

    --
    -- Received Capabilities Peer route reflection configuration
    --

        bgpPeerCapsReceivedTable

    bgpM2CfgPeerRouteReflectionExts
        OBJECT IDENTIFIER ::= { bgpM2CfgPeerNonCapExts 2796 }

    bgpM2CfgPeerReflectorClientTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF Bgp4PeerCapsReceivedEntry BgpM2CfgPeerReflectorClientEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
                "This table contains contains the capabilities
                that are supported for
            "Table of route reflection client settings on a given peer." per-peer
             basis."
        REFERENCE
            "RFC 2796 - BGP Route Reflection"
        ::= { bgpPeerCapabilities 2 bgpM2CfgPeerRouteReflectionExts 1 }

        bgpPeerCapsReceivedEntry

    bgpM2CfgPeerReflectorClientEntry OBJECT-TYPE
        SYNTAX     Bgp4PeerCapsReceivedEntry     BgpM2CfgPeerReflectorClientEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
                "These entries are keyed by
            "Entry containing data on a BGP-4 peer remote
                address and per-peer basis on whether
             the peer is configured as a route reflector client."
        REFERENCE
            "RFC 2796 - BGP Capability Code"
            INDEX Route Reflection"
        AUGMENTS {
                bgpPeerRemoteAddrType,
                bgpPeerRemoteAddr,
                bgpPeerCapReceivedCode,
                bgpPeerCapReceivedIndex
            bgpM2CfgPeerEntry
        }
        ::= { bgpPeerCapsReceivedTable bgpM2CfgPeerReflectorClientTable 1 }

        Bgp4PeerCapsReceivedEntry

    BgpM2CfgPeerReflectorClientEntry ::= SEQUENCE {
                bgpPeerCapReceivedCode
                    Unsigned32,
                bgpPeerCapReceivedIndex
                    Unsigned32,
                bgpPeerCapReceivedLength
                    Unsigned32,
                bgpPeerCapReceivedValue
                    OCTET STRING
        bgpM2CfgPeerReflectorClient
            INTEGER
    }

        bgpPeerCapReceivedCode

    bgpM2CfgPeerReflectorClient OBJECT-TYPE
        SYNTAX     Unsigned32 (0..255)
            MAX-ACCESS read-only
            STATUS     current
            DESCRIPTION
                "The BGP Capability Advertisement Capability Code."
            ::=    INTEGER { bgpPeerCapsReceivedEntry 1
            nonClient(0),
            client(1),
            meshedClient(2)
        }

        bgpPeerCapReceivedIndex OBJECT-TYPE
            SYNTAX     Unsigned32 (1..128)
        MAX-ACCESS read-only  read-create
        STATUS      current
        DESCRIPTION
                "Multiple instances
            "This value indicates whether the given peer is a
             reflector client of this router, or not.  A value of
             nonClient indicates that this peer is not a given capability may be sent
                bgp reflector
             client.  A value of client indicates that this peer is a BGP speaker.  This variable
             reflector client that is used to index them." not fully meshed with other
             reflector clients.  A value of meshedClient indicates
             that the peer is a reflector client and is fully meshed
             with all other reflector clients.

             This value must be nonClient (0) for BGP external peers."
        REFERENCE
            "RFC 2796 - BGP Route Reflection"
        ::= { bgpPeerCapsReceivedEntry 2 bgpM2CfgPeerReflectorClientEntry 1 }

        bgpPeerCapReceivedLength OBJECT-TYPE
            SYNTAX     Unsigned32
            MAX-ACCESS read-only
            STATUS     current
            DESCRIPTION
                "The length of the announced capability."

    --
    -- Peer AS Confederations Extensions
    --

    bgpM2CfgPeerASConfederationExts
        OBJECT IDENTIFIER ::= { bgpPeerCapsReceivedEntry 3 bgpM2CfgPeerNonCapExts 3065 }

        bgpPeerCapReceivedValue

    bgpM2CfgPeerConfedMemberTable OBJECT-TYPE
        SYNTAX     OCTET STRING (SIZE(0..255))     SEQUENCE OF BgpM2CfgPeerConfedMemberEntry
        MAX-ACCESS read-only not-accessible
        STATUS     current
        DESCRIPTION
                "The value
            "Table of the announced capability."
            ::= { bgpPeerCapsReceivedEntry 4 }

        bgpPeerCounters
        OBJECT IDENTIFIER confederation member settings on a per-peer
             basis."
        REFERENCE
            "RFC 3065 - BGP Confederations"
        ::= { bgpPeer 6 bgpM2CfgPeerASConfederationExts 1 }

        bgpPeerCountersTable

    bgpM2CfgPeerConfedMemberEntry OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpPeerCountersEntry     BgpM2CfgPeerConfedMemberEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
                "The counters associated with
            "Entry containing data on a per-peer basis on whether
             the peer is configured as a BGP Peer." confederation member."
        REFERENCE
            "RFC 3065 - BGP Confederations"
        AUGMENTS {
            bgpM2PeerEntry
        }
        ::= { bgpPeerCounters bgpM2CfgPeerConfedMemberTable 1 }

        bgpPeerCountersEntry

    BgpM2CfgPeerConfedMemberEntry ::= SEQUENCE {
        bgpM2CfgPeerConfedMember
            TruthValue
    }

    bgpM2CfgPeerConfedMember OBJECT-TYPE
        SYNTAX     BgpPeerCountersEntry      TruthValue
        MAX-ACCESS not-accessible  read-create
        STATUS      current
        DESCRIPTION
                "Each entry contains counters of messsage transmissions
                    and FSM transitions for a
            "This value indicates whether the given peer is in our
             confederation or not."
        REFERENCE
            "RFC 3065 - BGP Peering session."
            INDEX { bgpPeerIndex } Confederations"
        ::= { bgpPeerCountersTable bgpM2CfgPeerConfedMemberEntry 1 }

        BgpPeerCountersEntry
    --
    -- BGP NLRI Data
    --

    bgpM2Rib
        OBJECT IDENTIFIER ::= SEQUENCE {
                bgpPeerInUpdates
                    Counter32,
                bgpPeerOutUpdates
                    Counter32,
                bgpPeerInTotalMessages
                    Counter32,
                bgpPeerOutTotalMessages
                    Counter32,
                bgpPeerFsmEstablishedTransitions
                     Counter32 bgp 3 }

    -- +++wayne need to describe what happens if connection is broken
    -- and then reestablished. Does the prior counter value accumulate?

        bgpPeerInUpdates NLRI Table
    --

    bgpM2NlriTable OBJECT-TYPE
        SYNTAX     Counter32     SEQUENCE OF BgpM2NlriEntry
        MAX-ACCESS read-only not-accessible
        STATUS     current
        DESCRIPTION
            "The number of BGP UPDATE messages BGP-4 Received Path Attribute Table contains
             information about paths to destination networks
             received on from all BGP4 peers.  Collectively, this
                 connection.  This object should be initialized to zero
                 (0) when
             represents the connection Adj-Ribs-In.  The route where
             bgpM2NlriBest is established." TRUE represents, for this NLRI,
             the route that is installed in the LocRib from the
             Adj-Ribs-In."
        ::= { bgpPeerCountersEntry bgpM2Rib 1 }

        bgpPeerOutUpdates

    bgpM2NlriEntry OBJECT-TYPE
        SYNTAX     Counter32     BgpM2NlriEntry
        MAX-ACCESS read-only not-accessible
        STATUS     current
        DESCRIPTION
                "The number of BGP UPDATE messages transmitted on this
                 connection.  This object should be initialized
            "Information about a path to zero
                 (0) when the connection is established." a network."
        INDEX {
            bgpM2PeerIndex,
            bgpM2NlriAfi,
            bgpM2NlriSafi,
            bgpM2NlriPrefixLen,
            bgpM2NlriPrefix,
            bgpM2NlriIndex
        }
        ::= { bgpPeerCountersEntry 2 bgpM2NlriTable 1 }

    BgpM2NlriEntry ::= SEQUENCE {
        bgpM2NlriIndex
            Unsigned32,
        bgpM2NlriAfi
            InetAddressType,
        bgpM2NlriSafi
            BgpM2Safi,
        bgpM2NlriPrefixLen
            InetAddressPrefixLength,
        bgpM2NlriPrefix
            InetAddress,
        bgpM2NlriBest
            TruthValue,
        bgpM2NlriCalcLocalPref
            Unsigned32,
        bgpM2PathAttrIndex
            Unsigned32,
        bgpM2NlriOpaqueType
            INTEGER,
        bgpM2NlriOpaquePointer
            RowPointer
    }

        bgpPeerInTotalMessages

    bgpM2NlriIndex OBJECT-TYPE
        SYNTAX     Counter32     Unsigned32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "The total number
            "This index allows for multiple instances of messages received a base
             prefix for a certain AFI SAFI from the remote
                 peer on this connection. a given peer.
             This object should be
                 initialized is currently useful for two things:
             1. Allowing for a peer in future implementations to zero when
                send more than a single route instance.
             2. Allow for extensions which extend the connection NLRI field
                to send the same prefix while utilizing other
                extension specific information.  An example of
                this is established." RFC 3107 - Carrying MPLS labels in BGP."
        REFERENCE
            "RFC 3107 - Carrying Label Information in BGP-4"
        ::= { bgpPeerCountersEntry 3 bgpM2NlriEntry 1 }

        bgpPeerOutTotalMessages

    bgpM2NlriAfi OBJECT-TYPE
        SYNTAX     Counter32     InetAddressType
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The total number address family of messages transmitted to the remote
                 peer on prefix for this connection.  This object should be
                 initialized to zero when the connection is established." NLRI."
        ::= { bgpPeerCountersEntry 4 bgpM2NlriEntry 2 }

        bgpPeerFsmEstablishedTransitions
    bgpM2NlriSafi OBJECT-TYPE
        SYNTAX     Counter32     BgpM2Safi
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The total number subsequent address family of times the BGP FSM
                transitioned into the established state prefix for
             this peer." NLRI"
        REFERENCE
            "RFC 2858 - Multiprotocol Extensions for BGP-4"
        ::= { bgpPeerCountersEntry 5 bgpM2NlriEntry 3 }

        --
        -- Per-Peer Prefix Counters
        --

        bgpPrefixCountersTable

    bgpM2NlriPrefixLen OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpPrefixCountersEntry     InetAddressPrefixLength
        MAX-ACCESS not-accessible read-only
        STATUS     current
        DESCRIPTION
                "Additional per-peer, per AFI/SAFI counters for prefixes"
            "Length in bits of the address prefix in
             the Network Layer Reachability Information field."
        ::= { bgpPeerCounters 2 bgpM2NlriEntry 4 }

        bgpPrefixCountersEntry

    bgpM2NlriPrefix OBJECT-TYPE
        SYNTAX     BgpPrefixCountersEntry     InetAddress  (SIZE (4..20))
        MAX-ACCESS not-accessible read-only
        STATUS     current
        DESCRIPTION
                "Entry
            "An IP address prefix in the Network Layer
             Reachability Information field.  This object
             is an IP address containing information about a bgp-peer's the prefix
                 counters."
            INDEX {
                bgpPeerIndex,
                bgpPrefixCountersAfi,
                bgpPrefixCountersSafi
                } with
             length specified by
             bgpM2PathAttrAddrPrefixLen.
             Any bits beyond the length specified by
             bgpM2PathAttrAddrPrefixLen are zeroed."
        ::= { bgpPrefixCountersTable 1 bgpM2NlriEntry 5 }

        BgpPrefixCountersEntry

    bgpM2NlriBest OBJECT-TYPE
        SYNTAX     TruthValue
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "An indication of whether or not this route
             was chosen as the best BGP4 route."
        ::= SEQUENCE {
            -- JMH
            -- do we really need AFI and safi in the table?
                bgpPrefixCountersAfi
                  InetAddressType,
                bgpPrefixCountersSafi
                    BgpSafi,
                bgpPrefixInPrefixes
                    Gauge32,
                bgpPrefixInPrefixesAccepted
                    Gauge32,
                bgpPrefixInPrefixesRejected
                    Gauge32,
                bgpPrefixOutPrefixes
                    Gauge32 bgpM2NlriEntry 6 }

        bgpPrefixCountersAfi

    bgpM2NlriCalcLocalPref OBJECT-TYPE
        SYNTAX     InetAddressType     Unsigned32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The AFI index degree of preference calculated by the per-peer, per prefix counters"
             receiving BGP4 speaker for an advertised
             route."
        ::= { bgpPrefixCountersEntry 1 bgpM2NlriEntry 7 }

        bgpPrefixCountersSafi

    bgpM2PathAttrIndex OBJECT-TYPE
        SYNTAX     BgpSafi     Unsigned32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "The SAFI
            "This value is a unique index for the per-NLRI entry
             in the bgpM2PeerAttrTable.  It is assigned by the
             agent at the point of creation of the bgpM2PeerAttrTable
             row entry.  While its value is guaranteed to be unique
             at any time, it is otherwise opaque to the management
             application with respect to its value or the contiguity
             of bgpM2PeerAttrIndex row instance values across rows
             of the bgpM2PeerAttrTable.  It is used to provide an
             index structure for other tables whose data is logically
             per-peer, per prefix counters" per-NLRI."
        ::= { bgpPrefixCountersEntry 2 bgpM2NlriEntry 8 }

        bgpPrefixInPrefixes

    bgpM2NlriOpaqueType OBJECT-TYPE
        SYNTAX     Gauge32     INTEGER {
            none(0),
            bgpMplsLabelStack(1)
        }
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "The number
            "This object enumerates the type of prefixes received from the row that is
             pointed to in the table row bgpM2NlriOpaquePointer
             instance, if bgpM2NlriOpaquePointer is in fact not
             a peer and are
                 stored zero length.  bgpM2NlriOpaqueType is necessary since
             the data referenced by bgpM2NlriOpaquePointer is
             opaque to BGP.  For example, in the Adj-Ribs-In for that peer."
                 -- jmh - note case of RFC 3107,
             the label stack that we're allowing stuff is pointed to may occur in the
             mplsLabelStackTable from the MPLS-LSR-MIB, and the
             instance value of bgpM2NlriOpaqueType would be discarded
             bgpMplsLabelStack(1)."
        REFERENCE
            "RFC 3107 - Carrying Label Information in BGP-4
             draft-ietf-mpls-lsr-mib-08.txt"
        ::= { bgpPrefixCountersEntry 7 bgpM2NlriEntry 9 }

        bgpPrefixInPrefixesAccepted

    bgpM2NlriOpaquePointer OBJECT-TYPE
        SYNTAX     Gauge32     RowPointer
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "The number of prefixes for
            "Pointer to a peer row that are installed
                 in decomposes the Adj-Ribs-In and are eligible data that is
             opaque to become active the BGP MIB but is sent in the Loc-Rib." NLRI.
             This RowPointer has zero (0) length data instance
             if bgpM2NlriOpaqueType is none."
        ::= { bgpPrefixCountersEntry 8 bgpM2NlriEntry 10 }

        bgpPrefixInPrefixesRejected

    --
    -- Adj-Ribs-Out Table
    --

    bgpM2AdjRibsOutTable OBJECT-TYPE
        SYNTAX     Gauge32     SEQUENCE OF BgpM2AdjRibsOutEntry
        MAX-ACCESS read-only not-accessible
        STATUS     current
        DESCRIPTION
                "The number of prefixes for
            "This table contains on a peer that are installed
                 in per-peer basis one or more
             routes from the Adj-Ribs-In and are NOT eligible to become active bgpM2NlriTable that have been
             placed in the Loc-Rib." this peer's Adj-Ribs-Out."
        REFERENCE
            "draft-ietf-idr-bgp4-17.txt, Sec. 3.2"
        ::= { bgpPrefixCountersEntry 9 bgpM2Rib 2 }

        bgpPrefixOutPrefixes

    bgpM2AdjRibsOutEntry OBJECT-TYPE
        SYNTAX     Gauge32     BgpM2AdjRibsOutEntry
        MAX-ACCESS read-only not-accessible
        STATUS     current
        DESCRIPTION
                "The number
            "List of prefixes for a peer that are installed
                 in BGP routes that have been placed into a
             peer's Adj-Ribs-Out."
        INDEX {
            bgpM2PeerIndex,
            bgpM2NlriAfi,
            bgpM2NlriSafi,
            bgpM2NlriPrefixLen,
            bgpM2NlriPrefix,
            bgpM2AdjRibsOutIndex
        }
        ::= { bgpPrefixCountersEntry 10 bgpM2AdjRibsOutTable 1 }

        bgpPeerExtensions
        OBJECT IDENTIFIER

    BgpM2AdjRibsOutEntry ::= SEQUENCE { bgpPeer 7
        bgpM2AdjRibsOutIndex
            Unsigned32,
        bgpM2AdjRibsOutRoute
            RowPointer
    }

        bgpPeerNonCapExts
            OBJECT IDENTIFIER

    bgpM2AdjRibsOutIndex OBJECT-TYPE
        SYNTAX     Unsigned32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "Certain extensions to BGP permit multiple instance of
             a per afi, per safi prefix to be advertised to a peer.
             This object allows the enumeration of them."
        ::= { bgpPeerExtensions bgpM2AdjRibsOutEntry 1 }

        bgpPeerCapExts
            OBJECT IDENTIFIER ::= { bgpPeerExtensions 2 }

        --
        -- Peer Route Reflection Extensions
        --

        bgpPeerRouteReflectionExts
            OBJECT IDENTIFIER ::= { bgpPeerNonCapExts 1966 }

        bgpPeerReflectorClient

    bgpM2AdjRibsOutRoute OBJECT-TYPE
        SYNTAX    INTEGER {
                nonClient(0),
                client(1),
                meshedClient(2)
            }     RowPointer
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "This value indicates whether object points to the given peer is a
                 reflector client of this router, or not.  A value of
                 nonClient(0) indicates route in the bgpM2NlriTable
             that this peer is corresponds to the entry in the peer's
             Adj-Rib-Out.  Outgoing route maps are not a reflector
                 client.  A value of client(1) indicates that
             reflected at this peer is a
                 reflector client that is not fully meshed with other
                 reflector clients.  A value point as those are part of meshedClient(2) indicates
                 that the peer is a reflector client and is fully meshed
                 with all other reflector clients."
             Update-Send process."
        REFERENCE
                "RFC 2796 - BGP Route Reflection"
            "draft-ietf-idr-bgp4-17.txt, Sec. 9.2"
        ::= { bgpPeerRouteReflectionExts 1 bgpM2AdjRibsOutEntry 2 }

    --
    -- Peer AS Confederations Extensions BGP Rib Path Attributes Table
    --

        bgpPeerASConfederationExts
            OBJECT IDENTIFIER ::= { bgpPeerNonCapExts 1965 }

        bgpPeerConfederationMember

    --
    -- Path Attribute Counter
    --

    bgpM2PathAttrCount OBJECT-TYPE
        SYNTAX      TruthValue     Counter32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "This value indicates whether the given peer is
            "The number of entries in our
                 confederation or not."
            REFERENCE
                "RFC 3065 - BGP Confederations"
            ::= { bgpPeerASConfederationExts 1 }

        bgpRib
        OBJECT IDENTIFIER the bgpM2PathAttrTable."
        ::= { bgp bgpM2Rib 3 }

    --
    -- BGP NLRI Data Path Attributes Table
    --

        bgpNlriTable

    bgpM2PathAttrTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpNlriEntry BgpM2PathAttrEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
                "The BGP-4 Received Path Attribute Table
                contains information about paths to
                destination networks received from all
                BGP4 peers."
            "Provides per advertised network-prefix attribute data,
             as advertised over a peering session."
        ::= { bgpRib 1 bgpM2Rib 4 }

        bgpNlriEntry

    bgpM2PathAttrEntry OBJECT-TYPE
        SYNTAX     BgpNlriEntry     BgpM2PathAttrEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
                "Information
            "Each entry contains data about a path to a network." given network
             prefix, per-prefix and per-advertising peer."
        INDEX {
                bgpPeerIndex,
                bgpNlriAfi,
                bgpNlriSafi,
                bgpNlriPrefixLen,
                bgpNlriPrefix
            bgpM2PathAttrIndex
        }
        ::= { bgpNlriTable bgpM2PathAttrTable 1 }

        BgpNlriEntry

    BgpM2PathAttrEntry ::= SEQUENCE {
                bgpNlriAfi
        bgpM2PathAttrOrigin
            INTEGER,
        bgpM2PathAttrNextHopAddrType
            InetAddressType,
                bgpNlriSafi
                    BgpSafi,
                bgpNlriPrefixLen
                    Unsigned32,
                bgpNlriPrefix
        bgpM2PathAttrNextHop
            InetAddress,
                bgpNlriBest
        bgpM2PathAttrMedPresent
            TruthValue,
                bgpPathAttrIndex
        bgpM2PathAttrMed
            Unsigned32,
                bgpNlriASPathStr
                    DisplayString
        bgpM2PathAttrLocalPrefPresent
            TruthValue,
        bgpM2PathAttrLocalPref
            Unsigned32,
        bgpM2PathAttrAtomicAggregate
            INTEGER,
        bgpM2PathAttrAggregatorAS
            InetAutonomousSystemNumber,
        bgpM2PathAttrAggregatorAddr
            BgpM2Identifier,
        bgpM2AsPathCalcLength
            Unsigned32,
        bgpM2AsPathString
            DisplayString,
        bgpM2AsPathIndex
            Unsigned32
    }

    bgpM2PathAttrOrigin OBJECT-TYPE
        SYNTAX     INTEGER {
            igp(1),-- networks are interior
            egp(2),-- networks learned via the EGP protocol
            incomplete(3) -- undetermined
            }

        bgpNlriAfi OBJECT-TYPE
            SYNTAX     InetAddressType
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The address family ultimate origin of the prefix for this NLRI." path information."
        ::= { bgpNlriEntry bgpM2PathAttrEntry 1 }

        bgpNlriSafi

    bgpM2PathAttrNextHopAddrType OBJECT-TYPE
        SYNTAX     BgpSafi      InetAddressType
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The subsequent address family of the prefix for
                this NLRI"
            REFERENCE
                "RFC 2858 - Multiprotocol Extensions address for BGP-4"
            ::= { bgpNlriEntry 2 }

        bgpNlriPrefixLen OBJECT-TYPE
            SYNTAX     Unsigned32 (1..128)
            MAX-ACCESS read-only
            STATUS     current
            DESCRIPTION
                "Length in bits of
             the IP address prefix in border router that should be used
             to access the Network Layer Reachability
                Information field." destination network."
        ::= { bgpNlriEntry 3 bgpM2PathAttrEntry 2 }

    -- JMH - this is going to vary based on AFI/SAFI !!! wrong for RFC2545!
    -- JMH - We need to extend InetAddressType so we have a valid InetAddress is wrong now!
        bgpNlriPrefix
    -- for this.
    bgpM2PathAttrNextHop OBJECT-TYPE
        SYNTAX     InetAddress  (SIZE (4..16)) (SIZE(4..20))
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "An IP
            "The address prefix in of the Network Layer
                Reachability Information field. border router that
             should be used to access the destination
             network.  This object address is an IP the nexthop
             address containing received in the prefix with
                length specified by
                bgpPathAttrAddrPrefixLen.
                Any bits beyond UPDATE packet.
             The address family of this object will be the length specified by
                bgpPathAttrAddrPrefixLen are zeroed."
             same as that of the prefix in this row."
        ::= { bgpNlriEntry 4 bgpM2PathAttrEntry 3 }

        bgpNlriBest

    bgpM2PathAttrMedPresent OBJECT-TYPE
        SYNTAX     TruthValue
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "An indication of whether
            "Whether or not this route
                was chosen as the best BGP4 route." MED value is present.
             If it is not present, the bgpM2PathAttrMed
             object has no useful value and should be set to 0."
        ::= { bgpNlriEntry 5 bgpM2PathAttrEntry 4 }

        bgpPathAttrIndex

    bgpM2PathAttrMed OBJECT-TYPE
        SYNTAX     Unsigned32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "This value is a unique index for the per-NLRI entry in the
                bgpPeerAttrTable.  It is assigned by the agent at the point
                of creation of the bgpPeerAttrTable row entry.  While its
                value is guaranteed to be unique at any time, it is
                otherwise opaque to the management application with
                respect to its value or the contiguity of bgpPeerAttrIndex
                row instance values across rows of the bgpPeerAttrTable.
                It metric is used to provide discriminate
             between multiple exit points to an index structure for other
                tables whose data is logically per-peer, per-NLRI."
             adjacent autonomous system."
        ::= { bgpNlriEntry 6 bgpM2PathAttrEntry 5 }

        bgpNlriASPathStr

    bgpM2PathAttrLocalPrefPresent OBJECT-TYPE
        SYNTAX     DisplayString     TruthValue
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "This is a string depicting the autonomous system path
                 to this network which was received from the peer which
                 advertised it.  The format of
            "Whether or not the string LocalPref value is present.
             If it is implementation-
                 dependent, not present, the bgpM2PathAttrLocalPref
             object has no useful value and should be designed for operator readability." set to 0."
        ::= { bgpNlriEntry 7 bgpM2PathAttrEntry 6 }

        --
        -- BGP Rib Path Attributes Table
        --

        bgpPathAttrTable

    bgpM2PathAttrLocalPref OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpPathAttrEntry     Unsigned32
        MAX-ACCESS not-accessible read-only
        STATUS     current
        DESCRIPTION
                "Provides per advertised network-prefix attribute data,
                    as
            "The originating BGP4 speakers degree of
             preference for an advertised over a peering session." route."
        ::= { bgpRib 2 bgpM2PathAttrEntry 7 }
        bgpPathAttrEntry

-- JMH
-- See comment in v1 draft about this.

    bgpM2PathAttrAtomicAggregate OBJECT-TYPE
        SYNTAX     BgpPathAttrEntry     INTEGER {
            lessSpecificRouteNotSelected(1),
            lessSpecificRouteSelected(2)
            }
        MAX-ACCESS not-accessible read-only
        STATUS     current
        DESCRIPTION
                "Each entry contains data about
            "Whether or not a given network
                    prefix, per-prefix and per-advertising peer."
            INDEX { bgpPathAttrIndex }
            ::= { bgpPathAttrTable 1 }

        BgpPathAttrEntry system has selected
             a less specific route without
             selecting a more specific route."
        ::= SEQUENCE {
                bgpPathAttrOrigin
                    INTEGER,
                bgpPathAttrNextHopAddrType
                    InetAddressType,
                bgpPathAttrNextHop
                    InetAddress,
                bgpPathAttrMultiExitDiscPresent
                    TruthValue,
                bgpPathAttrMultiExitDisc
                    Unsigned32,
                bgpPathAttrLocalPrefPresent
                    TruthValue,
                bgpPathAttrLocalPref
                    Unsigned32,
                bgpPathAttrAtomicAggregate
                    INTEGER,
                bgpPathAttrAggregatorAS
                    BgpAutonomousSystemNumber,
                bgpPathAttrAggregatorAddr
                    BgpIdentifier,
                bgpPathAttrCalcLocalPref
                    Unsigned32 bgpM2PathAttrEntry 8 }

        bgpPathAttrOrigin

    bgpM2PathAttrAggregatorAS OBJECT-TYPE
        SYNTAX     INTEGER {
                igp(1),-- networks are interior
                egp(2),-- networks learned
                       -- via EGP
                incomplete(3) -- undetermined
                }     InetAutonomousSystemNumber
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The ultimate origin AS number of the path
                information." last BGP4 speaker that
             performed route aggregation.  A value of
             zero (0) indicates the absence of this
             attribute.

             Note propagation of AS of zero is illegal in
             the Internet."
        ::= { bgpPathAttrEntry 2 bgpM2PathAttrEntry 9 }

        bgpPathAttrNextHopAddrType

    bgpM2PathAttrAggregatorAddr OBJECT-TYPE
        SYNTAX      InetAddressType     BgpM2Identifier
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The IP address family of the address for
                 the border router last BGP4 speaker
             that should be used
                 to access performed route aggregation.  A
             value of 0.0.0.0 indicates the destination network." absence
             of this attribute."
        ::= { bgpPathAttrEntry 3 bgpM2PathAttrEntry 10 }

        -- JMH - this is wrong for RFC2545!
        bgpPathAttrNextHop

    bgpM2AsPathCalcLength OBJECT-TYPE
        SYNTAX     InetAddress     Unsigned32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "The address
            "This value represents the calculated length of the border router that
                should be used
             AS Path according to access the destination
                network.  This address is the nexthop
                address received in the UPDATE packet.
                The address family of this object will be the
                same as that rules of the prefix BGP specification.
             This value is used in this row." route selection."
        REFERENCE
            "draft-ietf-idr-bgp4-17.txt, Sec. 9.1.2.2.a"
        ::= { bgpPathAttrEntry 4 bgpM2PathAttrEntry 11 }

        bgpPathAttrMultiExitDiscPresent

    bgpM2AsPathString OBJECT-TYPE
        SYNTAX     TruthValue     DisplayString
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "Whether or not the MED value is present.
                If it
            "This is not present, a string depicting the bgpPathAttrMultiExitDisc
                object has no useful value autonomous system
             path to this network which was received from the
             peer which advertised it.  The format of the string
             is implementation-dependent, and should be set to 0." designed
             for operator readability."
        ::= { bgpPathAttrEntry 5 bgpM2PathAttrEntry 12 }

        bgpPathAttrMultiExitDisc

    bgpM2AsPathIndex OBJECT-TYPE
        SYNTAX     Unsigned32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "This metric value is used a unique index for the decomposed AS Path
             in the bgpM2AsPathTable.  It is assigned by the
             agent at the point of creation of the bgpM2AsPathTable
             row entry.  While its value is guaranteed to discriminate
                between multiple exit points be unique
             at any time, it is otherwise opaque to an
                adjacent autonomous system." the management
             application with respect to its value or the contiguity
             of bgpM2AsPathIndex row instance values across rows
             of the bgpM2AsPathTable."
        ::= { bgpPathAttrEntry 6 bgpM2PathAttrEntry 13 }

        bgpPathAttrLocalPrefPresent

    --
    -- As-4 byte AS_PATH
    --

    bgpM2AsPath4byteTable OBJECT-TYPE
        SYNTAX     TruthValue     SEQUENCE OF BgpM2AsPath4byteEntry
        MAX-ACCESS read-only not-accessible
        STATUS     current
        DESCRIPTION
                "Whether or not the LOCAL_PREF value is present.
                If it
            "This table is not present, present for BGP speakers that support
             the bgpPathAttrLocalPref
                object has no useful value AS 4byte specification and should be set to 0." are functioning as
             a router between 2-byte and 4-byte AS space."
        REFERENCE
            "draft-ietf-idr-as4bytes-04.txt - BGP support for
             four-octet AS number space"
        ::= { bgpPathAttrEntry 7 bgpM2Rib 5 }

        bgpPathAttrLocalPref

    bgpM2AsPath4byteEntry OBJECT-TYPE
        SYNTAX     Unsigned32     BgpM2AsPath4byteEntry
        MAX-ACCESS read-only not-accessible
        STATUS     current
        DESCRIPTION
                "The originating BGP4 speaker's degree of
                preference
            "Each row contains the information for an advertised route." the AS 4-byte
             extension's NEW_AS_PATH and NEW_AGGREGATOR attributes."
        AUGMENTS {
            bgpM2PathAttrEntry
        }
        ::= { bgpPathAttrEntry 8 bgpM2AsPath4byteTable 1 }

-- JMH
-- See comment in v1 draft about this.

        bgpPathAttrAtomicAggregate OBJECT-TYPE
            SYNTAX     INTEGER

    BgpM2AsPath4byteEntry ::= SEQUENCE {
                lessSpecificRouteNotSelected(1),
                lessSpecificRouteSelected(2)
        bgpM2AsPath4bytePathPresent
            TruthValue,
        bgpM2AsPath4byteAggregatorAS
            InetAutonomousSystemNumber,
        bgpM2AsPath4byteCalcLength
            Unsigned32,
        bgpM2AsPath4byteString
            DisplayString,
        bgpM2AsPath4byteIndex
            Unsigned32
    }

    bgpM2AsPath4bytePathPresent OBJECT-TYPE
        SYNTAX     TruthValue
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "Whether or not a system has selected
                a less specific route without
                selecting
            "This value may only be true if this BGP Speaker
             is functioning as a more specific route." router between ASs that
             are in 2-byte and 4-byte AS space.  If this
             value is true, then the NEW_AS_PATH attributes
             are present and the 4-byte versions of the
             appropriate path attributes are in this row.

             If this value is false, then the following values
             will be present in the row:

             bgpM2PathAttrAggregatorAS - zero (0).
             bgpM2AsPathCalcLength - zero (0).
             bgpM2AsPathString - zero (0) length string.
             bgpM2AsPathIndex - zero (0)."
        ::= { bgpPathAttrEntry 9 bgpM2AsPath4byteEntry 1 }

        bgpPathAttrAggregatorAS

    bgpM2AsPath4byteAggregatorAS OBJECT-TYPE
        SYNTAX     BgpAutonomousSystemNumber     InetAutonomousSystemNumber
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The NEW_AGGREGATOR AS number of the last BGP4 speaker
             that performed route aggregation.  A value of
             zero (0) indicates the absence of this
                attribute."
             attribute.

             Note propagation of AS of zero is illegal in
             the Internet."
        ::= { bgpPathAttrEntry 10 bgpM2AsPath4byteEntry 2 }

        bgpPathAttrAggregatorAddr

    bgpM2AsPath4byteCalcLength OBJECT-TYPE
        SYNTAX     BgpIdentifier     Unsigned32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
                "The IP address
            "This value represents the calculated length of the
             NEW_AS_PATH according to the rules of the BGP specification.
             This value is used in route selection."
        REFERENCE
            "draft-ietf-idr-bgp4-17.txt, Sec. 9.1.2.2.a"
        ::= { bgpM2AsPath4byteEntry 3 }

    bgpM2AsPath4byteString OBJECT-TYPE
        SYNTAX     DisplayString
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "This is a string depicting the autonomous system
             path to this network which was received from the
             peer which advertised it.  The format of the last BGP4 speaker
                that performed route aggregation.  A string
             is implementation-dependent, and should be designed
             for operator readability."
        ::= { bgpM2AsPath4byteEntry 4 }

    bgpM2AsPath4byteIndex OBJECT-TYPE
        SYNTAX     Unsigned32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "This value is a unique index for the decomposed AS Path
             in the bgpM2AsPathTable.  It is assigned by the
             agent at the point of creation of the bgpM2AsPathTable
             row entry.  While its value is guaranteed to be unique
             at any time, it is otherwise opaque to the management
             application with respect to its value of 0.0.0.0 indicates or the absence
                of this attribute.

                Note propagation of AS contiguity
             of zero is illegal in
                the Internet."
            ::= { bgpPathAttrEntry 11 }

        bgpPathAttrCalcLocalPref OBJECT-TYPE
            SYNTAX     Unsigned32
            MAX-ACCESS read-only
            STATUS     current
            DESCRIPTION
                "The degree bgpM2AsPathIndex row instance values across rows
             of preference calculated by the
                receiving BGP4 speaker for an advertised
                route." bgpM2AsPathTable. "
        ::= { bgpPathAttrEntry 12 bgpM2AsPath4byteEntry 5 }

    --    BGP 4 Path attribute AS Path Table.  There is one row in
    --    this table for each AS which is advertised for a given
    --    route as provided from a peer.

-- JMH
-- We need one of these for the NewAsPath for the 4byte draft

        bgpAsPathTable

    bgpM2AsPathTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpAsPathEntry BgpM2AsPathEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "The BGP-4 Path Attribute AS Path Table
             contains the per network path (NLRI)
             AS Path PATH data recieved received from the
             advertising BGP peer."
        ::= { bgpRib 3 bgpM2Rib 6 }
        bgpAsPathTableEntry

    bgpM2AsPathTableEntry OBJECT-TYPE
        SYNTAX     BgpAsPathEntry     BgpM2AsPathEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "Information about an AS path segment provided with a path to
             a network."
        INDEX {
                    bgpPathAttrIndex,
                    bgpAsPathIndex,
                    bgpAsPathElementValue
            bgpM2PathAttrIndex,
            bgpM2AsPathSegmentIndex,
            bgpM2AsPathElementIndex,
            bgpM2AsPathElementValue
        }
        ::= { bgpAsPathTable bgpM2AsPathTable 1 }

        BgpAsPathEntry

    BgpM2AsPathEntry ::= SEQUENCE {
            bgpAsPathIndex
        bgpM2AsPathSegmentIndex
            Unsigned32,
        bgpM2AsPathElementIndex
            Unsigned32,
            bgpAsPathType
        bgpM2AsPathType
            INTEGER,
            bgpAsPathElementValue
                BgpAutonomousSystemNumber
        bgpM2AsPathElementValue
            InetAutonomousSystemNumber
    }

        bgpAsPathIndex

    bgpM2AsPathSegmentIndex OBJECT-TYPE
        SYNTAX     Unsigned32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "A per-AS path segment index.  This will index a set of
             autonomous systems in an AS path that which are part
             of the same sequence or set (as determined by
             the row value of bgpAsPathType, bgpM2AsPathType, which
             should be the same value for each bgpAsPathTable bgpM2AsPathTable
             entry indexed by the same <bgpPathAttrIndex,
                 bgpAsPathIndex> (bgpM2PathAttrIndex,
             bgpM2AsPathIndex) pair)."
        ::= { bgpAsPathTableEntry bgpM2AsPathTableEntry 1 }

        bgpAsPathType

    bgpM2AsPathElementIndex OBJECT-TYPE
        SYNTAX     Unsigned32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "A per-AS element index.  This will index a particular
             AS within a sequence or set of autonomous systems in
             an AS path."
        ::= { bgpM2AsPathTableEntry 2 }

    bgpM2AsPathType OBJECT-TYPE
        SYNTAX  INTEGER {
            asSet(1),
            asSequence(2),
            confedSequence(3),
            confedSet(4)
         }
         MAX-ACCESS  read-only
         STATUS      current
         DESCRIPTION
             "The type of sequence in which this asPath
              was advertised as an attribute.  Note that
              all asPath row instances for a given <bgpPathAttrIndex,
                  bgpAsPathIndex> (bgpM2PathAttrIndex,
              bgpM2AsPathIndex) index pair will have their
                  bgpAsPathType
              bgpM2AsPathType set to the same value.
              The values for bgpAsPathType bgpM2AsPathType are
              interpreted as defined in the base BGP document
              and the BGP AS Confederations document."
        REFERENCE
            "draft-ietf-idr-bgp4-16
             RFC 3065 - BGP AS Confederations"
        ::= { bgpAsPathTableEntry 2 bgpM2AsPathTableEntry 3 }

        bgpAsPathElementValue

    bgpM2AsPathElementValue OBJECT-TYPE
        SYNTAX     BgpAutonomousSystemNumber     InetAutonomousSystemNumber
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "An AS value for an AS the related NLRI traversed
             in the propagation of its advertisement.  This
             value is to be interpreted in the context of the
             sequence implied by bgpAsPathIndex bgpM2AsPathIndex and
                 bgpAsPathType
             bgpM2AsPathType (and, in sequence of the
             other table rows with the same value of
                 bgpPathAttrIndex
             bgpM2PathAttrIndex and bgpAsPathIndex)." bgpM2AsPathIndex)."
        ::= { bgpAsPathTableEntry 3 bgpM2AsPathTableEntry 4 }

    --    BGP 4 Path unknown attribute.  There is one row in
    --    this table for each attribute not known by this BGP
    --    implementation (or agent instrumentation), but provided
    --    from a peer.

        bgpPathAttrUnknownTable

    bgpM2PathAttrUnknownTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpPathAttrUnknownEntry BgpM2PathAttrUnknownEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "The BGP-4 Path Attribute Unknown Table
             contains the per network path (NLRI)
             data on the path attributes advertised
             with a route but not known to the local BGP implementation
             or not otherwise capable of being returned from this agent.

             The absence of row data for a given index value for
                bgpPathAttrIndex
             bgpM2PathAttrIndex indicates a lack of such unknown
             attribute information for the indicated network path
             (as indexed by that bgpPathAttrIndex bgpM2PathAttrIndex value in the
                bgpPathAttrTable)."
             bgpM2PathAttrTable)."
        ::= { bgpRib 4 bgpM2Rib 7 }

        bgpPathAttrUnknownEntry

    bgpM2PathAttrUnknownEntry OBJECT-TYPE
        SYNTAX     BgpPathAttrUnknownEntry     BgpM2PathAttrUnknownEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "Information about an unknown attribute
             provided with a path to a network."
        INDEX {
                bgpPathAttrIndex,
                bgpPathAttrUnknownIndex
            bgpM2PathAttrIndex,
            bgpM2PathAttrUnknownIndex
        }
        ::= { bgpPathAttrUnknownTable bgpM2PathAttrUnknownTable 1 }

        BgpPathAttrUnknownEntry

    BgpM2PathAttrUnknownEntry ::= SEQUENCE {
                bgpPathAttrUnknownIndex
        bgpM2PathAttrUnknownIndex
            Unsigned32,
                bgpPathAttrUnknownType
        bgpM2PathAttrUnknownType
            Unsigned32,
                bgpPathAttrUnknownValue
        bgpM2PathAttrUnknownValue
            OCTET STRING
    }

        bgpPathAttrUnknownIndex

    bgpM2PathAttrUnknownIndex OBJECT-TYPE
        SYNTAX Unsigned32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "An integer index for a row in this table."
        ::= { bgpPathAttrUnknownEntry bgpM2PathAttrUnknownEntry 1 }

        bgpPathAttrUnknownType

    bgpM2PathAttrUnknownType OBJECT-TYPE
        SYNTAX Unsigned32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "The attribute type advertised with this 'unnkown' unknown
             attribute by the peer."
        ::= { bgpPathAttrUnknownEntry bgpM2PathAttrUnknownEntry 2 }

    -- Maximum size of the following is derived as
    --     4096   max message size
    --   -  16    BGP message marker bytes
    --   -   2    BGP message size
    --   -   1    BGP message type (UPDATE with unknown attr)
    --   -   2    UPDATE routes length (even assuming no routes)
    --   -   2    UPDATE path attributes length
    --   -   1    path attribute flag octet
    --   -   2    unknown path attr type (in bgpPathAttrUnknownType) bgpM2PathAttrUnknownType)
    --  ---------
    --    4070 bytes maximum per-message attribute value data

-- +++wayne ideas as to how to make this a reliably smaller/more broken up
-- string eagerly solicited here

        bgpPathAttrUnknownValue

    bgpM2PathAttrUnknownValue OBJECT-TYPE
        SYNTAX     OCTET STRING (SIZE(0..4070))
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "Value of path attribute not understood
             by the base BGP-4 document.

             Octets beyond the maximum size, if any,
             are not recorded by this row object. "
        ::= { bgpPathAttrUnknownEntry bgpM2PathAttrUnknownEntry 3 }

    --
    -- Path Attribute Extensions
    --

    bgpPathAttrExtensions

    bgpM2PathAttrExtensions
        OBJECT IDENTIFIER ::= { bgpRib 5 bgpM2Rib 8 }

        bgpPathAttrNonCapExts

    bgpM2PathAttrNonCapExts
        OBJECT IDENTIFIER ::= { bgpPathAttrExtensions bgpM2PathAttrExtensions 1 }

        bgpPathAttrCapExts

    bgpM2PathAttrCapExts
        OBJECT IDENTIFIER ::= { bgpPathAttrExtensions bgpM2PathAttrExtensions 2 }
    --
    -- Path Attribute Route Reflection Extensions
    --

    --
    -- Originator ID Table
    -- . This table is overkill, but seems to fit into
        -- . the current paradigm.

        --

        bgpPathAttrRouteReflectionExts

    bgpM2PathAttrRouteReflectionExts
        OBJECT IDENTIFIER ::= { bgpPathAttrNonCapExts 1966 bgpM2PathAttrNonCapExts 2796 }

        bgpPathAttrOriginatorIdTable

    bgpM2PathAttrOriginatorIdTable OBJECT-TYPE
        SYNTAX      SEQUENCE OF BgpPathAttrOriginatorIdEntry BgpM2PathAttrOriginatorIdEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "Per prefix data pertinent to advertisement of a
             network prefix through an originator."
        REFERENCE
            "RFC 2796 - BGP Route Reflection"
        ::= { bgpPathAttrRouteReflectionExts bgpM2PathAttrRouteReflectionExts 1 }

        bgpPathAttrOriginatorIdEntry

    bgpM2PathAttrOriginatorIdEntry OBJECT-TYPE
        SYNTAX      BgpPathAttrOriginatorIdEntry      BgpM2PathAttrOriginatorIdEntry
        MAX-ACCESS  not-accessible
        STATUS      current
        DESCRIPTION
            "Each entry contains data pertinent to a network
             prefix as received through its originating BGP
             route reflector."
        REFERENCE
            "RFC 2796 - BGP Route Reflection"
        INDEX {
                bgpPathAttrIndex
            bgpM2PathAttrIndex
        }
        ::= { bgpPathAttrOriginatorIdTable bgpM2PathAttrOriginatorIdTable 1 }

        BgpPathAttrOriginatorIdEntry

    BgpM2PathAttrOriginatorIdEntry ::= SEQUENCE {
            bgpPathAttrOriginatorId
                BgpIdentifier
        bgpM2PathAttrOriginatorId
            BgpM2Identifier
    }

        bgpPathAttrOriginatorId

    bgpM2PathAttrOriginatorId OBJECT-TYPE
        SYNTAX      BgpIdentifier      BgpM2Identifier
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "The Originator-ID identifying the router that initially
             advertised this destination to a Route Reflector.  A
             value of 0.0.0.0 indicates the absence of this attribute."
        REFERENCE
             "This attribute is defined in [RFC2796]."
        ::= { bgpPathAttrOriginatorIdEntry bgpM2PathAttrOriginatorIdEntry 1 }

    --
    -- Cluster table
    --

        bgpPathAttrClusterTable

    bgpM2PathAttrClusterTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpPathAttrClusterEntry BgpM2PathAttrClusterEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "The BGP-4 Path Attribute Cluster Table
             contains the per network path (NLRI)
             data on the reflection path which a
             route has traversed.  The absence of row
             data for a given index value for bgpPathAttrIndex bgpM2PathAttrIndex
             indicates a lack of this attribute information
             for the indicated network path (as indexed by
             that bgpPathAttrIndex bgpM2PathAttrIndex value in the bgpPathAttrTable)." bgpM2PathAttrTable)."
        ::= { bgpPathAttrRouteReflectionExts bgpM2PathAttrRouteReflectionExts 2 }

        bgpPathAttrClusterEntry

    bgpM2PathAttrClusterEntry OBJECT-TYPE
        SYNTAX     BgpPathAttrClusterEntry     BgpM2PathAttrClusterEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "Information about a cluster traversal
             provided with a path to a network."
        INDEX {
                bgpPathAttrIndex,
                bgpPathAttrClusterIndex
            bgpM2PathAttrIndex,
            bgpM2PathAttrClusterIndex
        }
        ::= { bgpPathAttrClusterTable bgpM2PathAttrClusterTable 1 }

        BgpPathAttrClusterEntry

    BgpM2PathAttrClusterEntry ::= SEQUENCE {
                bgpPathAttrClusterIndex
        bgpM2PathAttrClusterIndex
            Unsigned32,
                bgpPathAttrClusterValue
        bgpM2PathAttrClusterValue
            Unsigned32
    }

        bgpPathAttrClusterIndex

    bgpM2PathAttrClusterIndex OBJECT-TYPE
        SYNTAX     Unsigned32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "An integral index for a row in this table."
        ::= { bgpPathAttrClusterEntry bgpM2PathAttrClusterEntry 1 }

-- +++wayne following changed from OCTET STRING/BgpIdentifier per tdn

        bgpPathAttrClusterValue

    bgpM2PathAttrClusterValue OBJECT-TYPE
        SYNTAX      Unsigned32      BgpM2Identifier
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "A four octet long value representing a part of the
            reflection path that the route has passed.  Each such four
            octet long value represents the ID of a cluster that
            the route has traversed.  The sequence of this path as
            received in the route advertisement will be preserved in
            the sequence of bgpPathAttrClusterTable bgpM2PathAttrClusterTable rows (and the
                bgpPathAttrClusterValue's
            bgpM2PathAttrClusterValues in each row) as returned for
            a given bgpPathAttrIndex bgpM2PathAttrIndex value, and the monotonically
            increasing sequence of bgpPathAttrClusterIndex bgpM2PathAttrClusterIndex values
            for that bgpPathAttrIndex." bgpM2PathAttrIndex."
        REFERENCE
            "This attribute is defined in [RFC2796]."
        ::= { bgpPathAttrClusterEntry bgpM2PathAttrClusterEntry 2 }

    --
    -- BGP Communities
    --

        bgpPathAttrCommunityExts

    bgpM2PathAttrCommunityExts
        OBJECT IDENTIFIER ::= { bgpPathAttrNonCapExts bgpM2PathAttrNonCapExts 1997 }

        bgpPathAttrCommTable

    bgpM2PathAttrCommTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpPathAttrCommEntry BgpM2PathAttrCommEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "The BGP-4 Path Attribute Community Table
             contains the per network path (NLRI)
             data on the community membership advertised
             with a route.  The absence of row
             data for a given index value for bgpPathAttrIndex bgpM2PathAttrIndex
             indicates a lack of this attribute information
             for the indicated network path (as indexed by
             that bgpPathAttrIndex bgpM2PathAttrIndex value in the bgpPathAttrTable)." bgpM2PathAttrTable)."
        ::= { bgpPathAttrCommunityExts bgpM2PathAttrCommunityExts 1 }

        bgpPathAttrCommEntry

    bgpM2PathAttrCommEntry OBJECT-TYPE
        SYNTAX     BgpPathAttrCommEntry     BgpM2PathAttrCommEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "Information about a community association
             provided with a path to a network."
        INDEX { bgpPathAttrIndex, bgpPathAttrCommIndex
            bgpM2PathAttrIndex,
            bgpM2PathAttrCommIndex
        }
        ::= { bgpPathAttrCommTable bgpM2PathAttrCommTable 1 }

        BgpPathAttrCommEntry

    BgpM2PathAttrCommEntry ::= SEQUENCE {
                bgpPathAttrCommIndex
        bgpM2PathAttrCommIndex
            Unsigned32,
                bgpPathAttrCommValue
                    OCTET STRING
        bgpM2PathAttrCommValue
            BgpM2Community
    }

        bgpPathAttrCommIndex

    bgpM2PathAttrCommIndex OBJECT-TYPE
        SYNTAX Unsigned32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "An integer index for a row in this table."
        ::= { bgpPathAttrCommEntry bgpM2PathAttrCommEntry 1 }

        -- JMH
        -- Should we be using a display hint for this object?

        bgpPathAttrCommValue

    bgpM2PathAttrCommValue  OBJECT-TYPE
        SYNTAX      OCTET STRING (SIZE(4))      BgpM2Community
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "A value representing a community.   There are certain
             4-octet long values which could be returned in this
             columnar row data that carry additional semantics."
        REFERENCE
            "RFC 1997 - BGP Communities Attribute"
        ::= { bgpPathAttrCommEntry bgpM2PathAttrCommEntry 2 }

    --
    -- BGP Extended Communities
    --

        bgpPathAttrExtCommTable

    bgpM2PathAttrExtCommTable OBJECT-TYPE
        SYNTAX     SEQUENCE OF BgpPathAttrExtCommEntry BgpM2PathAttrExtCommEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "The BGP-4 Path Attribute Community Table
            contains the per network path (NLRI)
            data on the extended community membership advertised
            with a route.  The absence of row
            data for a given index value for bgpPathAttrIndex bgpM2PathAttrIndex
            indicates a lack of this attribute information
            for the indicated network path (as indexed by
            that bgpPathAttrIndex bgpM2PathAttrIndex value in the bgpPathAttrTable). bgpM2PathAttrTable).

            XXX JMH - can't can not assign the OID until an RFC is published."
        ::= { bgpPathAttrNonCapExts bgpM2PathAttrNonCapExts XXX }

        bgpPathAttrExtCommEntry

    bgpM2PathAttrExtCommEntry OBJECT-TYPE
        SYNTAX     BgpPathAttrExtCommEntry     BgpM2PathAttrExtCommEntry
        MAX-ACCESS not-accessible
        STATUS     current
        DESCRIPTION
            "Information about an extended community association
             provided with a path to a network."
        INDEX {
                bgpPathAttrIndex,
                bgpPathAttrExtCommIndex
            bgpM2PathAttrIndex,
            bgpM2PathAttrExtCommIndex
        }
        ::= { bgpPathAttrExtCommTable bgpM2PathAttrExtCommTable 1 }

        BgpPathAttrExtCommEntry

    BgpM2PathAttrExtCommEntry ::= SEQUENCE {
                bgpPathAttrExtCommIndex
        bgpM2PathAttrExtCommIndex
            Unsigned32,
                bgpPathAttrExtCommValue
                    OCTET STRING
        bgpM2PathAttrExtCommValue
            BgpM2ExtendedCommunity
    }

        bgpPathAttrExtCommIndex
    bgpM2PathAttrExtCommIndex OBJECT-TYPE
        SYNTAX Unsigned32
        MAX-ACCESS read-only
        STATUS     current
        DESCRIPTION
            "An integral index for a row in this table."
        ::= { bgpPathAttrExtCommEntry bgpM2PathAttrExtCommEntry 1 }

        -- JMH
        -- Again, do we want a display hint for this?
        bgpPathAttrExtCommValue

    bgpM2PathAttrExtCommValue  OBJECT-TYPE
        SYNTAX      OCTET STRING (SIZE(8))      BgpM2ExtendedCommunity
        MAX-ACCESS  read-only
        STATUS      current
        DESCRIPTION
            "A value representing an extended community which was
            received with the route implied by the bgpPathAttr bgpM2PathAttr
            Index value of this row data.   There are certain
            8-octet long values which could be returned in this
            columnar row data that carry additional semantics."
        REFERENCE
            "BGP-EXTCOMM - BGP Extended Communities Attribute"
        ::= { bgpPathAttrExtCommEntry bgpM2PathAttrExtCommEntry 2 }

        bgpConformance

    --
    -- Conformance Information
    --

    bgpM2Conformance
        OBJECT IDENTIFIER ::= { bgp 4 }

           -- conformance information

        bgpMIBCompliances

    bgpM2MIBCompliances OBJECT IDENTIFIER ::=
        { bgpConformance bgpM2Conformance 1 }
        bgpMIBGroups

    bgpM2MIBGroups      OBJECT IDENTIFIER ::=
        { bgpConformance bgpM2Conformance 2 }

        bgpMIBCompliance

    bgpM2MIBCompliance MODULE-COMPLIANCE
        STATUS  current
        DESCRIPTION
            "The compliance statement for entities which
            implement the BGP4 mib."
         MODULE  -- this module
         MANDATORY-GROUPS {
                bgpTimersGroup,
                bgpCountersGroup,
                bgpAsPathGroup,
                bgpAs4byteGroup,
                bgpBaseGroup,
                bgpErrorsGroup,
                bgpPeerGroup,
                bgpPathAttributesGroup
            bgpM2TimersGroup,
            bgpM2CountersGroup,
            bgpM2AsPathGroup,
            bgpM2As4byteGroup,
            bgpM2BaseGroup,
            bgpM2ErrorsGroup,
            bgpM2PeerGroup,
            bgpM2PathAttributesGroup
            }
        GROUP bgpAuthenticationGroup bgpM2MIBNotificationsGroup
        DESCRIPTION
            "The notifications group is completely optional,
             but highly recommended."
        GROUP bgpM2AuthenticationGroup
        DESCRIPTION
            "The authentication group is
             mandatory only for those implementations which
             support sending and receiving authentication
             information with peers in the BGP Authentication
             Field."
        GROUP bgpCommunitiesGroup bgpM2CommunitiesGroup
        DESCRIPTION
            "The communities group is mandatory only for those
             which support the BGP community attribute."
        GROUP bgpExtCommunitiesGroup bgpM2ExtCommunitiesGroup
        DESCRIPTION
            "The communities group is mandatory only for those
             which support the BGP extended community attribute."
        GROUP bgpRouteReflectionGroup bgpM2RouteReflectionGroup
        DESCRIPTION
            "The communities group is mandatory only for those
             which support the BGP route reflection relationships."
        GROUP bgpAsConfederationGroup bgpM2AsConfederationGroup
        DESCRIPTION
            "The communities group is mandatory only for those
             which support the BGP confederation membership."
        GROUP bgpTimersGroup bgpM2TimersGroup
        DESCRIPTION
            "This group is mandatory for all agent implementations."
        GROUP bgpCountersGroup bgpM2CountersGroup
        DESCRIPTION
            "This group is mandatory for all agent implementations."
        GROUP bgpCapabilitiesGroup bgpM2CapabilitiesGroup
        DESCRIPTION
            "This group is mandatory for all agent implementations."
        GROUP bgpAsPathGroup bgpM2AsPathGroup
        DESCRIPTION
            "This group is mandatory for all agent implementations."
        GROUP bgpAs4byteGroup bgpM2As4byteGroup
        DESCRIPTION
            "This group is mandatory for all agent implementations."
        GROUP bgpBaseGroup bgpM2BaseGroup
        DESCRIPTION
            "This group is mandatory for all agent implementations."
        GROUP bgpErrorsGroup bgpM2ErrorsGroup
        DESCRIPTION
            "This group is mandatory for all agent implementations."
        GROUP bgpPeerGroup bgpM2PeerGroup
        DESCRIPTION
            "This group is mandatory for all agent implementations."
        GROUP bgpPathAttributesGroup bgpM2PathAttributesGroup
        DESCRIPTION
            "This group is mandatory for all agent implementations."
        GROUP bgpPeerGroup bgpM2PeerConfigurationGroup
        DESCRIPTION
            "This group is mandatory optional for all agent implementations." implementations that wish to
             support configuration via SNMP."
        GROUP bgpM2PeerAuthConfigurationGroup
        DESCRIPTION
            "This group is optional for implementations that wish to
             support configuration of BGP authentication via SNMP.
             Implementation of this feature requires support of the
             bgpM2PeerConfigurationGroup."
        GROUP bgpM2PeerRouteReflectorCfgGroup
        DESCRIPTION
            "This group is optional for implementations that wish to
             support configuration of route reflection via SNMP.
             Implementation of this feature requires support of the
             bgpM2PeerConfigurationGroup."
        GROUP bgpM2PeerAsConfederationCfgGroup
        DESCRIPTION
            "This group is optional for implementations that wish to
             support configuration of BGP AS Confederations via SNMP.
             Implementation of this feature requires support of the
             bgpM2PeerConfigurationGroup."
        ::= { bgpMIBCompliances bgpM2MIBCompliances 1 }
    bgpAuthenticationGroup

    bgpM2AuthenticationGroup OBJECT-GROUP
        OBJECTS {
                bgpSupportedAuthCode,
                bgpSupportedAuthValue,
                bgpSupportedAuthCode,
                bgpSupportedAuthValue,
                bgpPeerAuthSent,
                bgpPeerAuthSentCode,
                bgpPeerAuthSentValue,
                bgpPeerAuthRcvd,
                bgpPeerAuthRcvdCode,
                bgpPeerAuthRcvdValue
            bgpM2SupportedAuthCode,
            bgpM2SupportedAuthValue,
            bgpM2PeerAuthSent,
            bgpM2PeerAuthSentCode,
            bgpM2PeerAuthSentValue,
            bgpM2PeerAuthRcvd,
            bgpM2PeerAuthRcvdCode,
            bgpM2PeerAuthRcvdValue
        }
        STATUS current
        DESCRIPTION
            "Objects associated with BGP authentication."
        ::= { bgpMIBGroups bgpM2MIBGroups 1 }

    bgpCommunitiesGroup

    bgpM2CommunitiesGroup OBJECT-GROUP
        OBJECTS {
                bgpPathAttrCommIndex,
                bgpPathAttrCommValue
            bgpM2PathAttrCommIndex,
            bgpM2PathAttrCommValue
        }
        STATUS current
        DESCRIPTION
            "Objects associated with BGP communities."
        ::= { bgpMIBGroups bgpM2MIBGroups 2 }

    bgpExtCommunitiesGroup

    bgpM2ExtCommunitiesGroup OBJECT-GROUP
        OBJECTS {
                bgpPathAttrExtCommIndex,
                bgpPathAttrExtCommValue
            bgpM2PathAttrExtCommIndex,
            bgpM2PathAttrExtCommValue
        }
        STATUS current
        DESCRIPTION
            "Objects associated with BGP extended communities."
        ::= { bgpMIBGroups bgpM2MIBGroups 3 }

    bgpRouteReflectionGroup

    bgpM2RouteReflectionGroup OBJECT-GROUP
        OBJECTS {
                bgpClusterId,
                bgpPeerReflectorClient,
                bgpPathAttrOriginatorId,
                bgpPathAttrClusterIndex,
                bgpPathAttrClusterValue
            bgpM2RouteReflector,
            bgpM2ClusterId,
            bgpM2PeerReflectorClient,
            bgpM2PathAttrOriginatorId,
            bgpM2PathAttrClusterIndex,
            bgpM2PathAttrClusterValue
        }
        STATUS current
        DESCRIPTION
            "Objects associated with BGP route reflection."
        ::= { bgpMIBGroups bgpM2MIBGroups 4 }

    bgpAsConfederationGroup

    bgpM2AsConfederationGroup OBJECT-GROUP
        OBJECTS {
                bgpConfederationId,
                bgpPeerConfederationMember
            bgpM2ConfederationRouter,
            bgpM2ConfederationId,
            bgpM2PeerConfedMember
        }
        STATUS current
        DESCRIPTION
            "Objects associated with BGP confederation membership."
        ::= { bgpMIBGroups bgpM2MIBGroups 5 }

    bgpTimersGroup

    bgpM2TimersGroup OBJECT-GROUP
        OBJECTS {
                bgpPeerFsmEstablishedTime,
                bgpPeerInUpdatesElapsedTime,
                bgpPeerConnectRetryInterval,
                bgpPeerHoldTimeConfigured,
                bgpPeerKeepAliveConfigured,
                bgpPeerMinASOriginationInterval,
                bgpPeerMinRouteAdvertiseInterval,
                bgpPeerHoldTime,
                bgpPeerKeepAlive
            bgpM2PeerFsmEstablishedTime,
            bgpM2PeerInUpdatesElapsedTime,
            bgpM2PeerConnectRetryInterval,
            bgpM2PeerHoldTimeConfigured,
            bgpM2PeerKeepAliveConfigured,
            bgpM2PeerMinASOrigInterval,
            bgpM2PeerMinRouteAdverInterval,
            bgpM2PeerHoldTime,
            bgpM2PeerKeepAlive
        }
        STATUS current
        DESCRIPTION
            "Objects associated with BGP peering timers."
        ::= { bgpMIBGroups bgpM2MIBGroups 6 }

    bgpCountersGroup

    bgpM2CountersGroup OBJECT-GROUP
        OBJECTS {
                bgpPeerInUpdates,
                bgpPeerOutUpdates,
                bgpPeerInTotalMessages,
                bgpPeerOutTotalMessages,
                bgpPeerFsmEstablishedTransitions,
                bgpPrefixCountersAfi,
                bgpPrefixCountersSafi,
                bgpPrefixInPrefixes,
                bgpPrefixInPrefixesAccepted,
                bgpPrefixInPrefixesRejected,
                bgpPrefixOutPrefixes
            bgpM2PeerInUpdates,
            bgpM2PeerOutUpdates,
            bgpM2PeerInTotalMessages,
            bgpM2PeerOutTotalMessages,
            bgpM2PeerFsmEstablishedTrans,
            bgpM2PrefixCountersAfi,
            bgpM2PrefixCountersSafi,
            bgpM2PrefixInPrefixes,
            bgpM2PrefixInPrefixesAccepted,
            bgpM2PrefixInPrefixesRejected,
            bgpM2PrefixOutPrefixes
        }
        STATUS current
        DESCRIPTION
            "Objects to count discrete events and exchanges on BGP
             sessions."
         ::= { bgpMIBGroups bgpM2MIBGroups 7 }

    bgpCapabilitiesGroup
    bgpM2CapabilitiesGroup OBJECT-GROUP
        OBJECTS {
                bgpCapabilitySupportAvailable,
                bgpSupportedCapabilityIndex,
                bgpSupportedCapability,
                bgpPeerCapAnnouncedCode,
                bgpPeerCapAnnouncedIndex,
                bgpPeerCapAnnouncedLength,
                bgpPeerCapAnnouncedValue,
                bgpPeerCapReceivedCode,
                bgpPeerCapReceivedIndex,
                bgpPeerCapReceivedLength,
                bgpPeerCapReceivedValue,
                bgpPeerCapAnnouncedCode,
                bgpPeerCapAnnouncedIndex,
                bgpPeerCapAnnouncedLength,
                bgpPeerCapAnnouncedValue,
                bgpPeerCapReceivedCode,
                bgpPeerCapReceivedIndex,
                bgpPeerCapReceivedLength,
                bgpPeerCapReceivedValue
            bgpM2CapabilitySupportAvailable,
            bgpM2SupportedCapabilityCode,
            bgpM2SupportedCapability,
            bgpM2PeerCapAnnouncedCode,
            bgpM2PeerCapAnnouncedIndex,
            bgpM2PeerCapAnnouncedValue,
            bgpM2PeerCapReceivedCode,
            bgpM2PeerCapReceivedIndex,
            bgpM2PeerCapReceivedValue
        }
        STATUS current
        DESCRIPTION
            "Objects to report capabilities as received on BGP
             sessions."
        ::= { bgpMIBGroups bgpM2MIBGroups 8 }

    bgpAsPathGroup

    bgpM2AsPathGroup OBJECT-GROUP
        OBJECTS {
                bgpAsPathIndex,
                bgpAsPathType,
                bgpAsPathElementValue
            bgpM2AsPathSegmentIndex,
            bgpM2AsPathElementIndex,
            bgpM2AsPathType,
            bgpM2AsPathElementValue
        }
        STATUS current
        DESCRIPTION
            "Objects to report AS paths received on BGP NLRIs."
        ::= { bgpMIBGroups bgpM2MIBGroups 9 }

    bgpAs4byteGroup

    bgpM2As4byteGroup OBJECT-GROUP
        OBJECTS {
                bgpAsSize
            bgpM2AsSize,
            bgpM2AsPath4bytePathPresent,
            bgpM2AsPath4byteAggregatorAS,
            bgpM2AsPath4byteCalcLength,
            bgpM2AsPath4byteString,
            bgpM2AsPath4byteIndex
        }
        STATUS current
        DESCRIPTION
            "AS Size objects."
        ::= { bgpMIBGroups bgpM2MIBGroups 10 }

    bgpBaseGroup

    bgpM2BaseGroup OBJECT-GROUP
        OBJECTS {
                bgpLocalAs,
                bgpLocalIdentifier,
                bgpVersionIndex,
                bgpVersionSupported
            bgpM2LocalAs,
            bgpM2LocalIdentifier,
            bgpM2VersionIndex,
            bgpM2VersionSupported
        }
        STATUS current
        DESCRIPTION
            "Basic objects in local BGP implementation."
        ::= { bgpMIBGroups bgpM2MIBGroups 11 }

    bgpErrorsGroup

    bgpM2ErrorsGroup OBJECT-GROUP
        OBJECTS {
                bgpPeerLastError,
                bgpPeerLastErrorData
            bgpM2PeerLastErrorReceived,
            bgpM2PeerLastErrorReceivedData,
            bgpM2PeerLastErrorReceivedTime,
            bgpM2PeerLastErrorReceivedText,
            bgpM2PeerLastErrorSent,
            bgpM2PeerLastErrorSentData,
            bgpM2PeerLastErrorSentTime,
            bgpM2PeerLastErrorSentText
        }
        STATUS current
        DESCRIPTION
            "Errors received on BGP peering sessions."
        ::= { bgpMIBGroups bgpM2MIBGroups 12 }

    bgpPeerGroup

    bgpM2PeerGroup OBJECT-GROUP
        OBJECTS {
                bgpPeerIdentifier,
                bgpPeerState,
                bgpPeerAdminStatus,
                bgpPeerConfiguredVersion,
                bgpPeerNegotiatedVersion,
                bgpPeerLocalAddrType,
                bgpPeerLocalAddr,
                bgpPeerLocalPort,
                bgpPeerLocalAs,
                bgpPeerRemoteAddrType,
                bgpPeerRemoteAddr,
                bgpPeerRemotePort,
                bgpPeerRemoteAs,
                bgpPeerIndex,
                bgpPeerRowEntryStatus
            bgpM2PeerIdentifier,
            bgpM2PeerState,
            bgpM2PeerStatus,
            bgpM2PeerConfiguredVersion,
            bgpM2PeerNegotiatedVersion,
            bgpM2PeerLocalAddrType,
            bgpM2PeerLocalAddr,
            bgpM2PeerLocalPort,
            bgpM2PeerLocalAs,
            bgpM2PeerRemoteAddrType,
            bgpM2PeerRemoteAddr,
            bgpM2PeerRemotePort,
            bgpM2PeerRemoteAs,
            bgpM2PeerIndex
        }
        STATUS current
        DESCRIPTION
            "Core object types on BGP peering sessions."
        ::= { bgpMIBGroups bgpM2MIBGroups 13 }
    bgpPathAttributesGroup

    bgpM2PathAttributesGroup OBJECT-GROUP
        OBJECTS {
                bgpNlriAfi,
                bgpNlriSafi,
                bgpNlriPrefixLen,
                bgpNlriPrefix,
                bgpNlriBest,
                bgpPathAttrIndex,
                bgpNlriASPathStr,
                bgpPathAttrOrigin,
                bgpPathAttrNextHopAddrType,
                bgpPathAttrNextHop,
                bgpPathAttrMultiExitDiscPresent,
                bgpPathAttrMultiExitDisc,
                bgpPathAttrLocalPrefPresent,
                bgpPathAttrLocalPref,
                bgpPathAttrAtomicAggregate,
                bgpPathAttrAggregatorAS,
                bgpPathAttrAggregatorAddr,
                bgpPathAttrCalcLocalPref,
                bgpAsPathIndex,
                bgpAsPathType,
                bgpAsPathElementValue,
                bgpPathAttrUnknownIndex,
                bgpPathAttrUnknownType,
                bgpPathAttrUnknownValue
            bgpM2PathAttrCount,
            bgpM2AsPathCalcLength,
            bgpM2AsPathElementValue,
            bgpM2AsPathIndex,
            bgpM2AsPathString,
            bgpM2AsPathType,
            bgpM2NlriAfi,
            bgpM2NlriBest,
            bgpM2NlriPrefix,
            bgpM2NlriPrefixLen,
            bgpM2NlriSafi,
            bgpM2NlriOpaqueType,
            bgpM2NlriOpaquePointer,
            bgpM2NlriIndex,
            bgpM2NlriCalcLocalPref,
            bgpM2AdjRibsOutIndex,
            bgpM2AdjRibsOutRoute,
            bgpM2PathAttrAggregatorAS,
            bgpM2PathAttrAggregatorAddr,
            bgpM2PathAttrAtomicAggregate,
            bgpM2PathAttrIndex,
            bgpM2PathAttrLocalPref,
            bgpM2PathAttrLocalPrefPresent,
            bgpM2PathAttrMed,
            bgpM2PathAttrMedPresent,
            bgpM2PathAttrNextHop,
            bgpM2PathAttrNextHopAddrType,
            bgpM2PathAttrOrigin,
            bgpM2PathAttrUnknownIndex,
            bgpM2PathAttrUnknownType,
            bgpM2PathAttrUnknownValue
        }
        STATUS current
        DESCRIPTION
            "Attributes recieved received on BGP peering sessions."
        ::= { bgpMIBGroups bgpM2MIBGroups 14 }

        bgpMIBNotificationsGroup

    bgpM2PeerConfigurationGroup OBJECT-GROUP
        OBJECTS {
            bgpM2CfgBaseScalarStorageType,
            bgpM2CfgLocalAs,
            bgpM2CfgLocalIdentifier,
            bgpM2CfgPeerAdminStatus,
            bgpM2CfgPeerNextIndex,
            bgpM2CfgPeerConfiguredVersion,
            bgpM2CfgAllowVersionNegotiation,
            bgpM2CfgPeerLocalAddrType,
            bgpM2CfgPeerLocalAddr,
            bgpM2CfgPeerLocalAs,
            bgpM2CfgPeerRemoteAddrType,
            bgpM2CfgPeerRemoteAddr,
            bgpM2CfgPeerRemotePort,
            bgpM2CfgPeerRemoteAs,
            bgpM2CfgPeerEntryStorageType,
            bgpM2CfgPeerError,
            bgpM2CfgPeerBgpPeerEntry,
            bgpM2CfgPeerRowEntryStatus,
            bgpM2CfgPeerIndex,
            bgpM2CfgPeerStatus,
            bgpM2CfgPeerConnectRetryInterval,
            bgpM2CfgPeerHoldTimeConfigured,
            bgpM2CfgPeerKeepAliveConfigured,
            bgpM2CfgPeerMinASOrigInterval,
            bgpM2CfgPeerMinRouteAdverInter
        }
        STATUS current
        DESCRIPTION
            "Configuration objects for BGP peers."
        ::= { bgpM2MIBGroups 15 }

    bgpM2PeerAuthConfigurationGroup OBJECT-GROUP
        OBJECTS {
            bgpM2CfgPeerAuthEnabled,
            bgpM2CfgPeerAuthCode,
            bgpM2CfgPeerAuthValue
        }
        STATUS current
        DESCRIPTION
            "Configuration objects for BGP peers that support
             authentication."
        ::= { bgpM2MIBGroups 16 }

    bgpM2PeerRouteReflectorCfgGroup OBJECT-GROUP
        OBJECTS {
            bgpM2CfgRouteReflector,
            bgpM2CfgClusterId,
            bgpM2CfgPeerReflectorClient
        }
        STATUS current
        DESCRIPTION
            "Configuration objects for BGP peers that support route
             reflection."
        ::= { bgpM2MIBGroups 17 }

    bgpM2PeerAsConfederationCfgGroup OBJECT-GROUP
        OBJECTS {
            bgpM2CfgConfederationRouter,
            bgpM2CfgConfederationId,
            bgpM2CfgPeerConfedMember
        }
        STATUS current
        DESCRIPTION
            "Configuration objects for BGP peers that support BGP
             confederations."
        ::= { bgpM2MIBGroups 18 }

    bgpM2MIBNotificationsGroup NOTIFICATION-GROUP
        NOTIFICATIONS {
                bgpEstablished,
                bgpBackwardTransition
            bgpM2Established,
            bgpM2BackwardTransition
        }
        STATUS  current
        DESCRIPTION
            "This group contains objects for notifications
             supported by this MIB mib module."
        ::= { bgpMIBGroups 15 bgpM2MIBGroups 19 }

END

5.

2.  Security Considerations

   This MIB module contains controls which relate to core services for
   interdomain routing using the Border Gateway Protocol.  In particu-
   lar, this MIB allows configuration of operational elements for those
   services.  If such configuration is done without consideration for
   the effects of such configuration activity, or malicious configura-
   tion activity is allowed on the managed elements, the effect could be
   denial of service to the processes and end users in the affected
   domain(s).

   SNMPv1 is not considered a sufficiently secure environment for the
   deployment of such configuration ability.  Even if the management
   data path is secure at the network protocol layer (by the deployment
   of secure IP, for example), there are still points of exposure around
   such issues as to what operators and applications are allowed to
   access and modify the configuration as exposed through this MIB mod-
   ule.

   It is strongly recommended that the agent implementor considers the
   security features afforded by the SNMP Version 3 framework in expos-
   ing the configuration features of this MIB module.  In particular,
   the availability and usage of the User-based Security Model [12]
   and/or the View-based Access Control Model [15] is highly recom-
   mended.

   It is then incumbent upon the customer deploying network management
   applications which make use of these configuration features to also
   consider and deploy a security discipline to make use of these SNMP
   Version 3 security features.  In particular, the operational staff
   who have access to the configuration controls in their ability to
   create, set, and delete them, should be carefully considered.

6.

3.  Intellectual Property

   The IETF takes no position regarding the validity or scope of any
   intellectual property or other rights that might be claimed to per-
   tain 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.

7.

4.  Acknowledgements

   Tom Nadeau, Cisco Systems, Inc.
   Jon Saperia, JDS Consulting, Inc.
   Bill Fenner, AT&T Research
   Mike McFaden, Riverstone Networks, Inc.
   Joel Krauska, Exodus Networks, Inc.
   Carl W. Kalbfleisch, Verio Networks, Inc.
   Joe Dupre, Gold Wire Technology
    others TBD...

8.  Open Issues

5.  Changes From Last Version

   This section is used to track changes from version to version of this
   document.  This section will be removed from the document prior to
   being issued to IDR working group last call (at the latest). call.

     *    Configuration is discussed, but not currently implemented in a
          thorough way    Changes from draft-ietf-idr-bgp4-mibv2-01.txt to draft-ietf-
          idr-bgp4-mibv2-02.txt (28 February 2002)

          Lots of changes in this rewrite, these are the MIB.

     *    Is 32 bits nearly enough indexing space for a row most dramatic:

          Configuration objects and tables added.

          All references to 'bgp' in the
          bgp4PathAttrTable?  Row Pointers are a little more heavyweight
          for a management application object descriptors changed to work with, but would a Row
          Pointer index type here be more appropriate regardless?

9.
          'bgpM2' to disambiguate from RFC 1657 and its OBSOLETing MIB.

          Community Textual conventions added to beginning of MIB.

          bgpM2CalcLength and PathString columns added to bgpM2PathAttr
          table.

          Creation of separate bgpM2AdjRibsOutTable.

          Appearance of NLRI table notions such as 'opaque type'.

          Overhaul of specification of AS Path types to accommodate eas-
          ier management at time of route aggregation.

6.  References

[1]  Harrington, D., Presuhn, R., and B. Wijnen, "An Architecture for
     Describing SNMP Management Frameworks", RFC 2571, April 1999.

[2]  Rose, M., and K. McCloghrie, "Structure and Identification of Man-
     agement Information for TCP/IP-based Internets", STD 16, RFC 1155,
     May 1990.

[3]  Rose, M., and K. McCloghrie, "Concise MIB Definitions", STD 16, RFC
     1212, March 1991.

[4]  Rose, M., "A Convention for Defining Traps for use with the SNMP",
     RFC 1215, March 1991.

[5]  McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M.,
     and S. Waldbusser, "Structure of Management Information Version 2
     (SMIv2)", STD 58, RFC 2578, April 1999.

[6]  McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M.,
     and S. Waldbusser, "Textual Conventions for SMIv2", STD 58, RFC
     2579, April 1999.

[7]  McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M.,
     and S. Waldbusser, "Conformance Statements for SMIv2", STD 58, RFC
     2580, April 1999.

[8]  Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple Network
     Management Protocol", STD 15, RFC 1157, May 1990.

[9]  Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Introduc-
     tion to Community-based SNMPv2", RFC 1901, January 1996.

[10] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Transport
     Mappings for Version 2 of the Simple Network Management Protocol
     (SNMPv2)", RFC 1906, January 1996.

[11] Case, J., Harrington D., Presuhn R., and B. Wijnen, "Message Pro-
     cessing and Dispatching for the Simple Network Management Protocol
     (SNMP)", RFC 2572, April 1999.

[12] Blumenthal, U., and B. Wijnen, "User-based Security Model (USM) for
     version 3 of the Simple Network Management Protocol (SNMPv3)", RFC
     2574, April 1999.

[13] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Protocol
     Operations for Version 2 of the Simple Network Management Protocol
     (SNMPv2)", RFC 1905, January 1996.

[14] Levi, D., Meyer, P., and B. Stewart, "SNMPv3 Applications", RFC
     2573, April 1999.

[15] Wijnen, B., Presuhn, R., and K. McCloghrie, "View-based Access Con-
     trol Model (VACM) for the Simple Network Management Protocol
     (SNMP)", RFC 2575, April 1999.

[16] McCloghrie, K. and M. Rose, Editors, "Management Information Base
     for Network Management of TCP/IP-based Internets: MIB-II", STD 17,
     RFC 1213, Hughes LAN Systems, Performance Systems International,
     March 1991.

[17] Willis, S., Burruss, J., and Chu, J., "Definitions of Managed
     Objects for the Fourth Version of the Border Gateway Protocol
     (BGP-4) using SMIv2", RFC 1657, July 1994.

[18] Hares, S., Haas, J., Willis, S., Burruss, J., and Chu, J., "Defini-
     tions of Managed Objects for the Fourth Version of Border Gateway
     Protocol (BGP-4)", draft-ietf-idr-bgp4-mib-06.txt, Work-in-
     progress.

[19] Rekhter, Y., Li, T., "A Border Gateway Protocol 4 (BGP-4)", RFC
     1771, March 1995.

[20]  Rekhter, Y., Gross, P., "Application of the Border Gateway Proto-
     col in the Internet", RFC 1772, March 1995.

[21]  Traina, P., McPherson, D., and Scudder, J., "Autonomous System
     Confederations for BGP", RFC 3065, February, 2001.

[22]  Chandra, R., Traina, P., and Li, T., "BGP Communities Attribute",
     RFC 1997, August, 1996.

[23]  Bates, T., Rekhter, Y., Chandra, R., and Katz, D., "Multiprotocol
     Extensions for BGP-4", June, 2000.

[24]  Bates, T., Chandra, R., and Chen, E., "BGP Route Reflection - An
     Alternative to Full Mesh IBGP", RFC 2796, April 2000.

[25] Sangli, S., Tappan, D., and Rekhter, Y., "BGP Extended Communities
     Attribute", Work-in-progress.

10.

[26] Rehkter, Y., and Rosen, E., "Carrying Label Information in BGP-4",
     RFC 3107, May 2001.

7.  Authors' Addresses

   Jeff Haas
   NextHop Technologies
   517 Williams
   825 Victors Way, Suite 100
   Ann Arbor, MI 48103-4943 48108
   Phone: +1 734 936 2095 222-1600
   Fax:   +1 734 615-3241 222-1602
   Email: jhaas@nexthop.com
   Susan Hares
   NextHop Technologies
   517 Williams
   825 Victors Way, Suite 100
   Ann Arbor, MI 48103-4943 48108
   Phone: +1 734 936 2095 222-1600
   Fax:   +1 734 615-3241 222-1602
   Email: skh@nexthop.com

   Wayne Tackabury
   Gold Wire Technology
   411 Waverley Oaks Rd.
   Waltham, MA  02452-8401
   Phone: +1 781 398-8819
   Fax:   +1 781 398-8811
   Email: wayne@goldwiretech.com

11.

8.  Full Copyright Statement

   Copyright (C) The Internet Society (2001). (2002).  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 doc-
   ument 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 develop-
   ing 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 MER-
   CHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

                           Table of Contents

1. Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . .   2
2. Objectives  . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
2.1. Protocol Extensions . . . . . . . . . . . . . . . . . . . . . .   3
2.2. Mechanisms for MIB Extensibility  . . . . . . . . . . . . . . .   3
2.3. BGP Configuration . . . . . . . . . . . . . . . . . . . . . . .   4
3. MIB Organization  . . . . . . . . . . . . . . . . . . . . . . . .   4
3.1. bgpBaseScalars  . bgpM2BaseScalars  . . . . . . . . . . . . . . . . . . . . . . .   5
3.2. bgpPeerData . bgpM2PeerData . . . . . . . . . . . . . . . . . . . . . . . . .   5
3.2.1. bgpPeerCapabilities . bgpM2PeerCapabilities . . . . . . . . . . . . . . . . . . . .   6
3.2.2. bgpPeerCounters . bgpM2PeerCounters . . . . . . . . . . . . . . . . . . . . . .   6
3.2.3. Peering Data Extensions . . . . . . . . . . . . . . . . . . .   6
3.2.4. Configuring Peering Sessions  . . . . . . . . . . . . . . . .   7
3.3. BGP Routing Information Base Data . . . . . . . . . . . . . . .   6   8
3.3.1. Routing Information Base Extensions . . . . . . . . . . . . .   7   9
3.4. Considerations on Table Indexing  . . . . . . . . . . . . . . .   7
4.   9
1. Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
5.  10
2. Security Considerations . . . . . . . . . . . . . . . . . . . . .  62
6.  95
3. Intellectual Property . . . . . . . . . . . . . . . . . . . . . .  62
7.  96
4. Acknowledgements  . . . . . . . . . . . . . . . . . . . . . . . .  63
8. Open Issues . . . . . . .  96
5. Changes From Last Version . . . . . . . . . . . . . . . . . . . .  63
9.  97
6. References  . . . . . . . . . . . . . . . . . . . . . . . . . . .  63
10.  97
7. Authors' Addresses  . . . . . . . . . . . . . . . . . . . . . . .  65
11.  99
8. Full Copyright Statement  . . . . . . . . . . . . . . . . . . . .  66 100