draft-ietf-idr-bgp4-mibv2-01.txt

BCAST Implementation for NS2

            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
-- 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).
             ::= { bgpPeerEntry 15 }

        bgpPeerErrors
        OBJECT IDENTIFIER ::= { bgpPeer 2 }

        bgpPeerErrorsTable OBJECT-TYPE
            SYNTAX     SEQUENCE OF BgpPeerErrorsEntry
            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
                    bgpPeerIndex, exists in this table, then no such errors
                    have been observed, reported, and recorded on the
                    session."
            ::= { bgpPeerErrors 1 }

        bgpPeerErrorsEntry OBJECT-TYPE
            SYNTAX     BgpPeerErrorsEntry
            MAX-ACCESS not-accessible
            STATUS     current
            DESCRIPTION
                "Each entry contains information about an error on
                    a given BGP peer session."
            INDEX { bgpPeerIndex }
            ::= { bgpPeerErrorsTable 1 }

        BgpPeerErrorsEntry ::= SEQUENCE {



Various Authors           Expires May 21, 2002                 [Page 21]


Internet Draft                 BGP-MIB v2              November 21, 2001


            bgpPeerLastError
                OCTET STRING,
            bgpPeerLastErrorData
                Unsigned32
        }

        bgpPeerLastError OBJECT-TYPE
            SYNTAX     OCTET STRING (SIZE (2))
            MAX-ACCESS read-only
            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 the subcode."
            REFERENCE
                "draft-ietf-bgp4-15.txt, Sec. 4.5"
            ::= { bgpPeerErrorsEntry 1 }

        bgpPeerLastErrorData OBJECT-TYPE
            SYNTAX     Unsigned32 (0..4075)
            MAX-ACCESS read-only
            STATUS     current
            DESCRIPTION
                "The last error code's data seen by this peer on this
                 connection."
            ::= { bgpPeerErrorsEntry 2 }

        bgpPeerAuthentication
        OBJECT IDENTIFIER ::= { bgpPeer 3 }


        --
        -- Peer Authentication
        --

        bgpPeerAuthTable OBJECT-TYPE
            SYNTAX     SEQUENCE OF BgpPeerAuthEntry
            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."
            ::= { bgpPeerAuthentication 1 }




Various Authors           Expires May 21, 2002                 [Page 22]


Internet Draft                 BGP-MIB v2              November 21, 2001


        bgpPeerAuthEntry OBJECT-TYPE
            SYNTAX     BgpPeerAuthEntry
            MAX-ACCESS not-accessible
            STATUS     current
            DESCRIPTION
                "Entry containing information about the authentication
                 with a BGP peer."
            INDEX { bgpPeerIndex }
            ::= { bgpPeerAuthTable 1 }


        BgpPeerAuthEntry ::= SEQUENCE {
            bgpPeerAuthSent
                TruthValue,
            bgpPeerAuthSentCode
                Unsigned32,
            bgpPeerAuthSentValue
                OCTET STRING,
            bgpPeerAuthRcvd
                TruthValue,
            bgpPeerAuthRcvdCode
                Unsigned32,
            bgpPeerAuthRcvdValue
                OCTET STRING
    }


        bgpPeerAuthSent OBJECT-TYPE
            SYNTAX TruthValue
            MAX-ACCESS read-write
            STATUS current
            DESCRIPTION
                "The local peer has sent authentication
                to the remote peer in the BGP Authentication
                    field."
               ::= { bgpPeerAuthEntry 1 }


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





Various Authors           Expires May 21, 2002                 [Page 23]


Internet Draft                 BGP-MIB v2              November 21, 2001


        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?
            MAX-ACCESS read-write
            STATUS current
            DESCRIPTION
                "The payload of the authentication information
                from the remote peer."
            ::= { bgpPeerAuthEntry 3 }


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


        bgpPeerAuthRcvdCode OBJECT-TYPE
            SYNTAX  Unsigned32 (0..255)
            MAX-ACCESS read-only
            STATUS current
            DESCRIPTION
                "The code of the authentication information
                from the remote peer."
            ::= { bgpPeerAuthEntry 5 }


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

        bgpPeerTimers
        OBJECT IDENTIFIER ::= { bgpPeer 4 }


        --



Various Authors           Expires May 21, 2002                 [Page 24]


Internet Draft                 BGP-MIB v2              November 21, 2001


        -- Peer Event Times
        --

        bgpPeerEventTimesTable OBJECT-TYPE
            SYNTAX     SEQUENCE OF BgpPeerEventTimesEntry
            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."
            ::= { bgpPeerTimers 1 }

        bgpPeerEventTimesEntry OBJECT-TYPE
            SYNTAX     BgpPeerEventTimesEntry
            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."
            INDEX { bgpPeerIndex }
            ::= { bgpPeerEventTimesTable 1 }

        BgpPeerEventTimesEntry ::= SEQUENCE {
            bgpPeerFsmEstablishedTime
                Gauge32,
            bgpPeerInUpdatesElapsedTime
                Gauge32
    }

        bgpPeerFsmEstablishedTime 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."
            ::= { bgpPeerEventTimesEntry 1 }


        bgpPeerInUpdatesElapsedTime OBJECT-TYPE
            SYNTAX     Gauge32
            MAX-ACCESS read-only
            STATUS     current



Various Authors           Expires May 21, 2002                 [Page 25]


Internet Draft                 BGP-MIB v2              November 21, 2001


            DESCRIPTION
                 "Elapsed time in seconds since the last BGP
                message was received from the peer.  Each time
                bgpPeerInUpdates is incremented, the value of this
                object is set to zero (0)."
            ::= { bgpPeerEventTimesEntry 2 }


        --
        -- Peer Configured Timers
        --

        bgpPeerConfiguredTimersTable OBJECT-TYPE
            SYNTAX     SEQUENCE OF BgpPeerConfiguredTimersEntry
            MAX-ACCESS not-accessible
            STATUS     current
            DESCRIPTION
                "Per peer management data on BGP session timers."
            ::= { bgpPeerTimers 2 }

        bgpPeerConfiguredTimersEntry OBJECT-TYPE
            SYNTAX     BgpPeerConfiguredTimersEntry
            MAX-ACCESS not-accessible
            STATUS     current
            DESCRIPTION
                "Each entry corresponds to the current state of BGP
                    timers on a given peering session."
            INDEX { bgpPeerIndex }
            ::= { bgpPeerConfiguredTimersTable 1 }

        BgpPeerConfiguredTimersEntry ::= SEQUENCE {
            bgpPeerConnectRetryInterval
                Unsigned32,
            bgpPeerHoldTimeConfigured
                Unsigned32,
            bgpPeerKeepAliveConfigured
                Unsigned32,
            bgpPeerMinASOriginationInterval
                Unsigned32,
            bgpPeerMinRouteAdvertiseInterval
                Unsigned32
    }

        bgpPeerConnectRetryInterval OBJECT-TYPE
            SYNTAX     Unsigned32 (1..65535)
            MAX-ACCESS read-write
            STATUS     current
            DESCRIPTION



Various Authors           Expires May 21, 2002                 [Page 26]


Internet Draft                 BGP-MIB v2              November 21, 2001


                "Time interval in seconds for the ConnectRetry
                timer.  The suggested value for this timer is 120
                seconds."
            ::= { bgpPeerConfiguredTimersEntry 1 }



        bgpPeerHoldTimeConfigured OBJECT-TYPE
            SYNTAX     Unsigned32 ( 0 | 3..65535 )
            MAX-ACCESS read-write
            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"
            ::= { bgpPeerConfiguredTimersEntry 2 }

        bgpPeerKeepAliveConfigured OBJECT-TYPE
            SYNTAX     Unsigned32 ( 0 | 1..21845 )
            MAX-ACCESS read-write
            STATUS     current
            DESCRIPTION
                "Time interval in seconds for the KeepAlive
                configured for this BGP speaker with this
                peer. The value of this object will only
                determine the KEEPALIVE messages' frequency
                relative to the value specified in
                bgpPeerHoldTimeConfigured; the actual time
                interval for the KEEPALIVE messages is
                indicated by bgpPeerKeepAlive.  A
                reasonable maximum value for this timer
                would be configured to be one third
                of that of bgpPeerHoldTimeConfigured.

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