Annotation of embedaddon/quagga/bgpd/BGP4-MIB.txt, revision 1.1.1.1

1.1       misho       1:     BGP4-MIB DEFINITIONS ::= BEGIN
                      2: 
                      3:         IMPORTS
                      4:             MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
                      5:             IpAddress, Integer32, Counter32, Gauge32, mib-2
                      6:                 FROM SNMPv2-SMI
                      7:             MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
                      8:                 FROM SNMPv2-CONF;
                      9: 
                     10:         bgp MODULE-IDENTITY
                     11:             LAST-UPDATED "9902100000Z"
                     12:             ORGANIZATION "IETF IDR Working Group"
                     13:             CONTACT-INFO "E-mail:  idr@merit.net
                     14: 
                     15:                           Susan Hares  (Editor)
                     16:                           Merit Network
                     17:                           4251 Plymouth Road
                     18:                           Suite C
                     19:                           Ann Arbor, MI 48105-2785
                     20:                           Tel: +1 734 936 2095
                     21:                           Fax: +1 734 647 3185
                     22:                           E-mail: skh@merit.edu
                     23: 
                     24:                           Jeff Johnson (Editor)
                     25:                           RedBack Networks, Inc.
                     26:                           1389 Moffett Park Drive
                     27:                           Sunnyvale, CA  94089-1134
                     28:                           Tel: +1 408 548 3516
                     29:                           Fax: +1 408 548 3599
                     30:                           E-mail: jeff@redback.com"
                     31:             DESCRIPTION
                     32:                     "The MIB module for BGP-4."
                     33:             REVISION    "9902100000Z"
                     34:             DESCRIPTION
                     35:                     "Corrected duplicate OBJECT IDENTIFIER
                     36:                      assignment in the conformance information."
                     37:             REVISION    "9601080000Z"
                     38:             DESCRIPTION
                     39:                     "1) Fixed the definitions of the traps to
                     40:                      make them equivalent to their initial
                     41:                      definition in RFC 1269.
                     42:                      2) Added compliance and conformance info."
                     43:             ::= { mib-2 15 }
                     44: 
                     45:         bgpVersion OBJECT-TYPE
                     46:             SYNTAX     OCTET STRING (SIZE (1..255))
                     47:             MAX-ACCESS read-only
                     48:             STATUS     current
                     49:             DESCRIPTION
                     50:                     "Vector of supported BGP protocol version
                     51:                     numbers.  Each peer negotiates the version
                     52:                     from this vector.  Versions are identified
                     53:                     via the string of bits contained within this
                     54:                     object.  The first octet contains bits 0 to
                     55:                     7, the second octet contains bits 8 to 15,
                     56:                     and so on, with the most significant bit
                     57:                     referring to the lowest bit number in the
                     58:                     octet (e.g., the MSB of the first octet
                     59:                     refers to bit 0).  If a bit, i, is present
                     60:                     and set, then the version (i+1) of the BGP
                     61:                     is supported."
                     62:             ::= { bgp 1 }
                     63: 
                     64:         bgpLocalAs OBJECT-TYPE
                     65:             SYNTAX     INTEGER (0..65535)
                     66:             MAX-ACCESS read-only
                     67:             STATUS     current
                     68:             DESCRIPTION
                     69:                     "The local autonomous system number."
                     70:             ::= { bgp 2 }
                     71: 
                     72: 
                     73: 
                     74:         -- BGP Peer table.  This table contains, one entry per BGP
                     75:         -- peer, information about the BGP peer.
                     76: 
                     77:         bgpPeerTable OBJECT-TYPE
                     78:             SYNTAX     SEQUENCE OF BgpPeerEntry
                     79:             MAX-ACCESS not-accessible
                     80:             STATUS     current
                     81:             DESCRIPTION
                     82:                     "BGP peer table.  This table contains,
                     83:                     one entry per BGP peer, information about the
                     84:                     connections with BGP peers."
                     85:             ::= { bgp 3 }
                     86: 
                     87:         bgpPeerEntry OBJECT-TYPE
                     88:             SYNTAX     BgpPeerEntry
                     89:             MAX-ACCESS not-accessible
                     90:             STATUS     current
                     91:             DESCRIPTION
                     92:                     "Entry containing information about the
                     93:                     connection with a BGP peer."
                     94:             INDEX { bgpPeerRemoteAddr }
                     95:             ::= { bgpPeerTable 1 }
                     96: 
                     97:         BgpPeerEntry ::= SEQUENCE {
                     98:                 bgpPeerIdentifier
                     99:                     IpAddress,
                    100:                 bgpPeerState
                    101:                     INTEGER,
                    102:                 bgpPeerAdminStatus
                    103:                     INTEGER,
                    104:                 bgpPeerNegotiatedVersion
                    105:                     Integer32,
                    106:                 bgpPeerLocalAddr
                    107:                     IpAddress,
                    108:                 bgpPeerLocalPort
                    109:                     INTEGER,
                    110:                 bgpPeerRemoteAddr
                    111:                     IpAddress,
                    112:                 bgpPeerRemotePort
                    113:                     INTEGER,
                    114:                 bgpPeerRemoteAs
                    115:                     INTEGER,
                    116:                 bgpPeerInUpdates
                    117:                     Counter32,
                    118:                 bgpPeerOutUpdates
                    119:                     Counter32,
                    120:                 bgpPeerInTotalMessages
                    121:                     Counter32,
                    122:                 bgpPeerOutTotalMessages
                    123:                     Counter32,
                    124:                 bgpPeerLastError
                    125:                     OCTET STRING,
                    126:                 bgpPeerFsmEstablishedTransitions
                    127:                     Counter32,
                    128:                 bgpPeerFsmEstablishedTime
                    129:                     Gauge32,
                    130:                 bgpPeerConnectRetryInterval
                    131:                     INTEGER,
                    132:                 bgpPeerHoldTime
                    133:                     INTEGER,
                    134:                 bgpPeerKeepAlive
                    135:                     INTEGER,
                    136:                 bgpPeerHoldTimeConfigured
                    137:                     INTEGER,
                    138:                 bgpPeerKeepAliveConfigured
                    139:                     INTEGER,
                    140:                 bgpPeerMinASOriginationInterval
                    141:                     INTEGER,
                    142:                 bgpPeerMinRouteAdvertisementInterval
                    143:                     INTEGER,
                    144:                 bgpPeerInUpdateElapsedTime
                    145:                     Gauge32
                    146:                 }
                    147: 
                    148:         bgpPeerIdentifier OBJECT-TYPE
                    149:             SYNTAX     IpAddress
                    150:             MAX-ACCESS read-only
                    151:             STATUS     current
                    152:             DESCRIPTION
                    153:                     "The BGP Identifier of this entry's BGP peer."
                    154:             ::= { bgpPeerEntry 1 }
                    155: 
                    156:         bgpPeerState OBJECT-TYPE
                    157:             SYNTAX     INTEGER {
                    158:                                 idle(1),
                    159:                                 connect(2),
                    160:                                 active(3),
                    161:                                 opensent(4),
                    162:                                 openconfirm(5),
                    163:                                 established(6)
                    164:                        }
                    165:             MAX-ACCESS read-only
                    166:             STATUS     current
                    167:             DESCRIPTION
                    168:                     "The BGP peer connection state."
                    169:             ::= { bgpPeerEntry 2 }
                    170: 
                    171:         bgpPeerAdminStatus OBJECT-TYPE
                    172:             SYNTAX     INTEGER {
                    173:                                 stop(1),
                    174:                                 start(2)
                    175:                        }
                    176:             MAX-ACCESS read-write
                    177:             STATUS     current
                    178:             DESCRIPTION
                    179:                     "The desired state of the BGP connection.  A
                    180:                     transition from 'stop' to 'start' will cause
                    181:                     the BGP Start Event to be generated.  A
                    182:                     transition from 'start' to 'stop' will cause
                    183:                     the BGP Stop Event to be generated.  This
                    184:                     parameter can be used to restart BGP peer
                    185:                     connections.  Care should be used in providing
                    186:                     write access to this object without adequate
                    187:                     authentication."
                    188:             ::= { bgpPeerEntry 3 }
                    189: 
                    190:         bgpPeerNegotiatedVersion OBJECT-TYPE
                    191:             SYNTAX     Integer32
                    192:             MAX-ACCESS read-only
                    193:             STATUS     current
                    194:             DESCRIPTION
                    195:                     "The negotiated version of BGP running between
                    196:                     the two peers."
                    197:             ::= { bgpPeerEntry 4 }
                    198: 
                    199:         bgpPeerLocalAddr OBJECT-TYPE
                    200:             SYNTAX     IpAddress
                    201:             MAX-ACCESS read-only
                    202:             STATUS     current
                    203:             DESCRIPTION
                    204:                     "The local IP address of this entry's BGP
                    205:                     connection."
                    206:             ::= { bgpPeerEntry 5 }
                    207: 
                    208:         bgpPeerLocalPort OBJECT-TYPE
                    209:             SYNTAX     INTEGER (0..65535)
                    210:             MAX-ACCESS read-only
                    211:             STATUS     current
                    212:             DESCRIPTION
                    213:                     "The local port for the TCP connection between
                    214:                     the BGP peers."
                    215:             ::= { bgpPeerEntry 6 }
                    216: 
                    217:         bgpPeerRemoteAddr OBJECT-TYPE
                    218:             SYNTAX     IpAddress
                    219:             MAX-ACCESS read-only
                    220:             STATUS     current
                    221:             DESCRIPTION
                    222:                     "The remote IP address of this entry's BGP
                    223:                     peer."
                    224:             ::= { bgpPeerEntry 7 }
                    225: 
                    226:         bgpPeerRemotePort OBJECT-TYPE
                    227:             SYNTAX     INTEGER (0..65535)
                    228:             MAX-ACCESS read-only
                    229:             STATUS     current
                    230:             DESCRIPTION
                    231:                     "The remote port for the TCP connection between
                    232:                     the BGP peers.  Note that the objects
                    233:                     bgpPeerLocalAddr, bgpPeerLocalPort,
                    234:                     bgpPeerRemoteAddr and bgpPeerRemotePort
                    235:                     provide the appropriate reference to the
                    236:                     standard MIB TCP connection table."
                    237:             ::= { bgpPeerEntry 8 }
                    238: 
                    239:         bgpPeerRemoteAs OBJECT-TYPE
                    240:             SYNTAX     INTEGER (0..65535)
                    241:             MAX-ACCESS read-only
                    242:             STATUS     current
                    243:             DESCRIPTION
                    244:                     "The remote autonomous system number."
                    245:             ::= { bgpPeerEntry 9 }
                    246: 
                    247:         bgpPeerInUpdates OBJECT-TYPE
                    248:             SYNTAX     Counter32
                    249:             MAX-ACCESS read-only
                    250:             STATUS     current
                    251:             DESCRIPTION
                    252:                     "The number of BGP UPDATE messages received on
                    253:                     this connection.  This object should be
                    254:                     initialized to zero (0) when the connection is
                    255:                     established."
                    256:             ::= { bgpPeerEntry 10 }
                    257: 
                    258:         bgpPeerOutUpdates OBJECT-TYPE
                    259:             SYNTAX     Counter32
                    260:             MAX-ACCESS read-only
                    261:             STATUS     current
                    262:             DESCRIPTION
                    263:                     "The number of BGP UPDATE messages transmitted
                    264:                     on this connection.  This object should be
                    265:                     initialized to zero (0) when the connection is
                    266:                     established."
                    267:             ::= { bgpPeerEntry 11 }
                    268: 
                    269:         bgpPeerInTotalMessages OBJECT-TYPE
                    270:             SYNTAX     Counter32
                    271:             MAX-ACCESS read-only
                    272:             STATUS     current
                    273:             DESCRIPTION
                    274:                     "The total number of messages received from the
                    275:                     remote peer on this connection.  This object
                    276:                     should be initialized to zero when the
                    277:                     connection is established."
                    278:             ::= { bgpPeerEntry 12 }
                    279: 
                    280:         bgpPeerOutTotalMessages OBJECT-TYPE
                    281:             SYNTAX     Counter32
                    282:             MAX-ACCESS read-only
                    283:             STATUS     current
                    284:             DESCRIPTION
                    285:                     "The total number of messages transmitted to
                    286:                     the remote peer on this connection.  This object
                    287:                     should be initialized to zero when the
                    288:                     connection is established."
                    289:             ::= { bgpPeerEntry 13 }
                    290: 
                    291:         bgpPeerLastError OBJECT-TYPE
                    292:             SYNTAX     OCTET STRING (SIZE (2))
                    293:             MAX-ACCESS read-only
                    294:             STATUS     current
                    295:             DESCRIPTION
                    296:                     "The last error code and subcode seen by this
                    297:                     peer on this connection.  If no error has
                    298:                     occurred, this field is zero.  Otherwise, the
                    299:                     first byte of this two byte OCTET STRING
                    300:                     contains the error code, and the second byte
                    301:                     contains the subcode."
                    302:             ::= { bgpPeerEntry 14 }
                    303: 
                    304:         bgpPeerFsmEstablishedTransitions OBJECT-TYPE
                    305:             SYNTAX     Counter32
                    306:             MAX-ACCESS read-only
                    307:             STATUS     current
                    308:             DESCRIPTION
                    309:                     "The total number of times the BGP FSM
                    310:                     transitioned into the established state."
                    311:             ::= { bgpPeerEntry 15 }
                    312: 
                    313:         bgpPeerFsmEstablishedTime OBJECT-TYPE
                    314:             SYNTAX     Gauge32
                    315:             MAX-ACCESS read-only
                    316:             STATUS     current
                    317:             DESCRIPTION
                    318:                     "This timer indicates how long (in seconds) this
                    319:                     peer has been in the Established state or how long
                    320:                     since this peer was last in the Established state.
                    321:                     It is set to zero when a new peer is configured or
                    322:                     the router is booted."
                    323:             ::= { bgpPeerEntry 16 }
                    324: 
                    325:         bgpPeerConnectRetryInterval OBJECT-TYPE
                    326:             SYNTAX     INTEGER (1..65535)
                    327:             MAX-ACCESS read-write
                    328:             STATUS     current
                    329:             DESCRIPTION
                    330:                     "Time interval in seconds for the ConnectRetry
                    331:                     timer.  The suggested value for this timer is
                    332:                     120 seconds."
                    333:             ::= { bgpPeerEntry 17 }
                    334: 
                    335:         bgpPeerHoldTime OBJECT-TYPE
                    336:             SYNTAX     INTEGER  ( 0 | 3..65535 )
                    337:             MAX-ACCESS read-only
                    338:             STATUS     current
                    339:             DESCRIPTION
                    340:                     "Time interval in seconds for the Hold Timer
                    341:                     established with the peer.  The value of this
                    342:                     object is calculated by this BGP speaker by
                    343:                     using the smaller of the value in
                    344:                     bgpPeerHoldTimeConfigured and the Hold Time
                    345:                     received in the OPEN message.  This value
                    346:                     must be at lease three seconds if it is not
                    347:                     zero (0) in which case the Hold Timer has
                    348:                     not been established with the peer, or, the
                    349:                     value of bgpPeerHoldTimeConfigured is zero (0)."
                    350:             ::= { bgpPeerEntry 18 }
                    351: 
                    352:         bgpPeerKeepAlive OBJECT-TYPE
                    353:             SYNTAX     INTEGER ( 0 | 1..21845 )
                    354:             MAX-ACCESS read-only
                    355:             STATUS     current
                    356:             DESCRIPTION
                    357:                     "Time interval in seconds for the KeepAlive
                    358:                     timer established with the peer.  The value of
                    359:                     this object is calculated by this BGP speaker
                    360:                     such that, when compared with bgpPeerHoldTime,
                    361:                     it has the same proportion as what
                    362:                     bgpPeerKeepAliveConfigured has when compared
                    363:                     with bgpPeerHoldTimeConfigured.  If the value
                    364:                     of this object is zero (0), it indicates that
                    365:                     the KeepAlive timer has not been established
                    366:                     with the peer, or, the value of
                    367:                     bgpPeerKeepAliveConfigured is zero (0)."
                    368:             ::= { bgpPeerEntry 19 }
                    369: 
                    370:         bgpPeerHoldTimeConfigured OBJECT-TYPE
                    371:             SYNTAX     INTEGER ( 0 | 3..65535 )
                    372:             MAX-ACCESS read-write
                    373:             STATUS     current
                    374:             DESCRIPTION
                    375:                     "Time interval in seconds for the Hold Time
                    376:                     configured for this BGP speaker with this peer.
                    377:                     This value is placed in an OPEN message sent to
                    378:                     this peer by this BGP speaker, and is compared
                    379:                     with the Hold Time field in an OPEN message
                    380:                     received from the peer when determining the Hold
                    381:                     Time (bgpPeerHoldTime) with the peer.  This value
                    382:                     must not be less than three seconds if it is not
                    383:                     zero (0) in which case the Hold Time is NOT to be
                    384:                     established with the peer.  The suggested value for
                    385:                     this timer is 90 seconds."
                    386:             ::= { bgpPeerEntry 20 }
                    387: 
                    388:         bgpPeerKeepAliveConfigured OBJECT-TYPE
                    389:             SYNTAX     INTEGER ( 0 | 1..21845 )
                    390:             MAX-ACCESS read-write
                    391:             STATUS     current
                    392:             DESCRIPTION
                    393:                     "Time interval in seconds for the KeepAlive timer
                    394:                     configured for this BGP speaker with this peer.
                    395:                     The value of this object will only determine the
                    396:                     KEEPALIVE messages' frequency relative to the value
                    397:                     specified in bgpPeerHoldTimeConfigured; the actual
                    398:                     time interval for the KEEPALIVE messages is
                    399:                     indicated by bgpPeerKeepAlive.  A reasonable
                    400:                     maximum value for this timer would be configured to
                    401:                     be one third of that of bgpPeerHoldTimeConfigured.
                    402:                     If the value of this object is zero (0), no
                    403:                     periodical KEEPALIVE messages are sent to the peer
                    404:                     after the BGP connection has been established.  The
                    405:                     suggested value for this timer is 30 seconds."
                    406:             ::= { bgpPeerEntry 21 }
                    407: 
                    408:         bgpPeerMinASOriginationInterval OBJECT-TYPE
                    409:             SYNTAX     INTEGER (1..65535)
                    410:             MAX-ACCESS read-write
                    411:             STATUS     current
                    412:             DESCRIPTION
                    413:                     "Time interval in seconds for the
                    414:                     MinASOriginationInterval timer.
                    415:                     The suggested value for this timer is 15 seconds."
                    416:             ::= { bgpPeerEntry 22 }
                    417: 
                    418:         bgpPeerMinRouteAdvertisementInterval OBJECT-TYPE
                    419:             SYNTAX     INTEGER (1..65535)
                    420:             MAX-ACCESS read-write
                    421:             STATUS     current
                    422:             DESCRIPTION
                    423:                     "Time interval in seconds for the
                    424:                     MinRouteAdvertisementInterval timer.
                    425:                     The suggested value for this timer is 30 seconds."
                    426:             ::= { bgpPeerEntry 23 }
                    427: 
                    428:         bgpPeerInUpdateElapsedTime OBJECT-TYPE
                    429:             SYNTAX     Gauge32
                    430:             MAX-ACCESS read-only
                    431:             STATUS     current
                    432:             DESCRIPTION
                    433:                     "Elapsed time in seconds since the last BGP
                    434:                     UPDATE message was received from the peer.
                    435:                     Each time bgpPeerInUpdates is incremented,
                    436:                     the value of this object is set to zero (0)."
                    437:             ::= { bgpPeerEntry 24 }
                    438: 
                    439: 
                    440: 
                    441:         bgpIdentifier OBJECT-TYPE
                    442:             SYNTAX     IpAddress
                    443:             MAX-ACCESS read-only
                    444:             STATUS     current
                    445:             DESCRIPTION
                    446:                     "The BGP Identifier of local system."
                    447:             ::= { bgp 4 }
                    448: 
                    449: 
                    450: 
                    451:         -- Received Path Attribute Table.  This table contains,
                    452:         -- one entry per path to a network, path attributes
                    453:         -- received from all peers running BGP version 3 or less.
                    454:         -- This table is obsolete, having been replaced in
                    455:         -- functionality with the bgp4PathAttrTable.
                    456: 
                    457:         bgpRcvdPathAttrTable OBJECT-TYPE
                    458:             SYNTAX     SEQUENCE OF BgpPathAttrEntry
                    459:             MAX-ACCESS not-accessible
                    460:             STATUS     obsolete
                    461:             DESCRIPTION
                    462:                     "The BGP Received Path Attribute Table contains
                    463:                     information about paths to destination networks
                    464:                     received from all peers running BGP version 3 or
                    465:                     less."
                    466:             ::= { bgp 5 }
                    467: 
                    468:         bgpPathAttrEntry OBJECT-TYPE
                    469:             SYNTAX     BgpPathAttrEntry
                    470:             MAX-ACCESS not-accessible
                    471:             STATUS     obsolete
                    472:             DESCRIPTION
                    473:                     "Information about a path to a network."
                    474:             INDEX { bgpPathAttrDestNetwork,
                    475:                     bgpPathAttrPeer        }
                    476:             ::= { bgpRcvdPathAttrTable 1 }
                    477: 
                    478:         BgpPathAttrEntry ::= SEQUENCE {
                    479:             bgpPathAttrPeer
                    480:                  IpAddress,
                    481:             bgpPathAttrDestNetwork
                    482:                  IpAddress,
                    483:             bgpPathAttrOrigin
                    484:                  INTEGER,
                    485:             bgpPathAttrASPath
                    486:                  OCTET STRING,
                    487:             bgpPathAttrNextHop
                    488:                  IpAddress,
                    489:             bgpPathAttrInterASMetric
                    490:                  Integer32
                    491:         }
                    492: 
                    493:         bgpPathAttrPeer OBJECT-TYPE
                    494:             SYNTAX     IpAddress
                    495:             MAX-ACCESS read-only
                    496:             STATUS     obsolete
                    497:             DESCRIPTION
                    498:                     "The IP address of the peer where the path
                    499:                     information was learned."
                    500:             ::= { bgpPathAttrEntry 1 }
                    501: 
                    502:         bgpPathAttrDestNetwork OBJECT-TYPE
                    503:             SYNTAX     IpAddress
                    504:             MAX-ACCESS read-only
                    505:             STATUS     obsolete
                    506:             DESCRIPTION
                    507:                     "The address of the destination network."
                    508:             ::= { bgpPathAttrEntry 2 }
                    509: 
                    510:         bgpPathAttrOrigin OBJECT-TYPE
                    511:             SYNTAX     INTEGER {
                    512:                            igp(1),-- networks are interior
                    513:                            egp(2),-- networks learned via EGP
                    514:                            incomplete(3) -- undetermined
                    515:                        }
                    516:             MAX-ACCESS read-only
                    517:             STATUS     obsolete
                    518:             DESCRIPTION
                    519:                  "The ultimate origin of the path information."
                    520:             ::= { bgpPathAttrEntry 3 }
                    521: 
                    522:         bgpPathAttrASPath OBJECT-TYPE
                    523:             SYNTAX     OCTET STRING (SIZE (2..255))
                    524:             MAX-ACCESS read-only
                    525:             STATUS     obsolete
                    526:             DESCRIPTION
                    527:                     "The set of ASs that must be traversed to reach
                    528:                     the network.  This object is probably best
                    529:                     represented as SEQUENCE OF INTEGER.  For SMI
                    530:                     compatibility, though, it is represented as
                    531:                     OCTET STRING.  Each AS is represented as a pair
                    532:                     of octets according to the following algorithm:
                    533: 
                    534:                         first-byte-of-pair = ASNumber / 256;
                    535:                         second-byte-of-pair = ASNumber & 255;"
                    536:             ::= { bgpPathAttrEntry 4 }
                    537: 
                    538:         bgpPathAttrNextHop OBJECT-TYPE
                    539:             SYNTAX     IpAddress
                    540:             MAX-ACCESS read-only
                    541:             STATUS     obsolete
                    542:             DESCRIPTION
                    543:                     "The address of the border router that should
                    544:                     be used for the destination network."
                    545:             ::= { bgpPathAttrEntry 5 }
                    546: 
                    547:         bgpPathAttrInterASMetric OBJECT-TYPE
                    548:             SYNTAX     Integer32
                    549:             MAX-ACCESS read-only
                    550:             STATUS     obsolete
                    551:             DESCRIPTION
                    552:                     "The optional inter-AS metric.  If this
                    553:                     attribute has not been provided for this route,
                    554:                     the value for this object is 0."
                    555:             ::= { bgpPathAttrEntry 6 }
                    556: 
                    557: 
                    558: 
                    559:         -- BGP-4 Received Path Attribute Table.  This table contains,
                    560:         -- one entry per path to a network, path attributes
                    561:         -- received from all peers running BGP-4.
                    562: 
                    563:         bgp4PathAttrTable OBJECT-TYPE
                    564:             SYNTAX     SEQUENCE OF Bgp4PathAttrEntry
                    565:             MAX-ACCESS not-accessible
                    566:             STATUS     current
                    567:             DESCRIPTION
                    568:                     "The BGP-4 Received Path Attribute Table contains
                    569:                     information about paths to destination networks
                    570:                     received from all BGP4 peers."
                    571:             ::= { bgp 6 }
                    572: 
                    573:         bgp4PathAttrEntry OBJECT-TYPE
                    574:             SYNTAX     Bgp4PathAttrEntry
                    575:             MAX-ACCESS not-accessible
                    576:             STATUS     current
                    577:             DESCRIPTION
                    578:                     "Information about a path to a network."
                    579:             INDEX { bgp4PathAttrIpAddrPrefix,
                    580:                     bgp4PathAttrIpAddrPrefixLen,
                    581:                     bgp4PathAttrPeer            }
                    582:             ::= { bgp4PathAttrTable 1 }
                    583: 
                    584:         Bgp4PathAttrEntry ::= SEQUENCE {
                    585:             bgp4PathAttrPeer
                    586:                  IpAddress,
                    587:             bgp4PathAttrIpAddrPrefixLen
                    588:                  INTEGER,
                    589:             bgp4PathAttrIpAddrPrefix
                    590:                  IpAddress,
                    591:             bgp4PathAttrOrigin
                    592:                  INTEGER,
                    593:             bgp4PathAttrASPathSegment
                    594:                  OCTET STRING,
                    595:             bgp4PathAttrNextHop
                    596:                  IpAddress,
                    597:             bgp4PathAttrMultiExitDisc
                    598:                  INTEGER,
                    599:             bgp4PathAttrLocalPref
                    600:                  INTEGER,
                    601:             bgp4PathAttrAtomicAggregate
                    602:                  INTEGER,
                    603:             bgp4PathAttrAggregatorAS
                    604:                  INTEGER,
                    605:             bgp4PathAttrAggregatorAddr
                    606:                  IpAddress,
                    607:             bgp4PathAttrCalcLocalPref
                    608:                  INTEGER,
                    609:             bgp4PathAttrBest
                    610:                  INTEGER,
                    611:             bgp4PathAttrUnknown
                    612:                  OCTET STRING
                    613:         }
                    614: 
                    615:         bgp4PathAttrPeer OBJECT-TYPE
                    616:             SYNTAX     IpAddress
                    617:             MAX-ACCESS read-only
                    618:             STATUS     current
                    619:             DESCRIPTION
                    620:                     "The IP address of the peer where the path
                    621:                     information was learned."
                    622:             ::= { bgp4PathAttrEntry 1 }
                    623:         bgp4PathAttrIpAddrPrefixLen OBJECT-TYPE
                    624:             SYNTAX     INTEGER (0..32)
                    625:             MAX-ACCESS read-only
                    626:             STATUS     current
                    627:             DESCRIPTION
                    628:                     "Length in bits of the IP address prefix in the
                    629:                     Network Layer Reachability Information field."
                    630:             ::= { bgp4PathAttrEntry 2 }
                    631: 
                    632:         bgp4PathAttrIpAddrPrefix OBJECT-TYPE
                    633:             SYNTAX     IpAddress
                    634:             MAX-ACCESS read-only
                    635:             STATUS     current
                    636:             DESCRIPTION
                    637:                     "An IP address prefix in the Network Layer
                    638:                     Reachability Information field.  This object
                    639:                     is an IP address containing the prefix with
                    640:                     length specified by bgp4PathAttrIpAddrPrefixLen.
                    641:                     Any bits beyond the length specified by
                    642:                     bgp4PathAttrIpAddrPrefixLen are zeroed."
                    643:             ::= { bgp4PathAttrEntry 3 }
                    644: 
                    645:         bgp4PathAttrOrigin OBJECT-TYPE
                    646:             SYNTAX     INTEGER {
                    647:                                  igp(1),-- networks are interior
                    648:                                  egp(2),-- networks learned via EGP
                    649:                                  incomplete(3) -- undetermined
                    650:                                }
                    651:             MAX-ACCESS read-only
                    652:             STATUS     current
                    653:             DESCRIPTION
                    654:                     "The ultimate origin of the path information."
                    655:             ::= { bgp4PathAttrEntry 4 }
                    656: 
                    657:         bgp4PathAttrASPathSegment OBJECT-TYPE
                    658:             SYNTAX     OCTET STRING (SIZE (2..255))
                    659:             MAX-ACCESS read-only
                    660:             STATUS     current
                    661:             DESCRIPTION
                    662:                     "The sequence of AS path segments.  Each AS
                    663:                     path segment is represented by a triple
                    664:                     <type, length, value>.
                    665: 
                    666:                     The type is a 1-octet field which has two
                    667:                     possible values:
                    668:                          1      AS_SET: unordered set of ASs a
                    669:                                      route in the UPDATE message
                    670:                                      has traversed
                    671:                          2      AS_SEQUENCE: ordered set of ASs
                    672:                                      a route in the UPDATE message
                    673:                                      has traversed.
                    674: 
                    675:                     The length is a 1-octet field containing the
                    676:                     number of ASs in the value field.
                    677: 
                    678:                     The value field contains one or more AS
                    679:                     numbers, each AS is represented in the octet
                    680:                     string as a pair of octets according to the
                    681:                     following algorithm:
                    682: 
                    683:                         first-byte-of-pair = ASNumber / 256;
                    684:                         second-byte-of-pair = ASNumber & 255;"
                    685:             ::= { bgp4PathAttrEntry 5 }
                    686: 
                    687:         bgp4PathAttrNextHop OBJECT-TYPE
                    688:             SYNTAX     IpAddress
                    689:             MAX-ACCESS read-only
                    690:             STATUS     current
                    691:             DESCRIPTION
                    692:                     "The address of the border router that should
                    693:                     be used for the destination network."
                    694:             ::= { bgp4PathAttrEntry 6 }
                    695: 
                    696:         bgp4PathAttrMultiExitDisc OBJECT-TYPE
                    697:             SYNTAX     INTEGER (-1..2147483647)
                    698:             MAX-ACCESS read-only
                    699:             STATUS     current
                    700:             DESCRIPTION
                    701:                     "This metric is used to discriminate between
                    702:                     multiple exit points to an adjacent autonomous
                    703:                     system.  A value of -1 indicates the absence of
                    704:                     this attribute."
                    705:             ::= { bgp4PathAttrEntry 7 }
                    706: 
                    707:         bgp4PathAttrLocalPref OBJECT-TYPE
                    708:             SYNTAX     INTEGER (-1..2147483647)
                    709:             MAX-ACCESS read-only
                    710:             STATUS     current
                    711:             DESCRIPTION
                    712:                     "The originating BGP4 speaker's degree of
                    713:                     preference for an advertised route.  A value of
                    714:                     -1 indicates the absence of this attribute."
                    715:             ::= { bgp4PathAttrEntry 8 }
                    716: 
                    717:         bgp4PathAttrAtomicAggregate OBJECT-TYPE
                    718:             SYNTAX     INTEGER {
                    719:                            lessSpecificRrouteNotSelected(1),
                    720:                            lessSpecificRouteSelected(2)
                    721:                        }
                    722:             MAX-ACCESS read-only
                    723:             STATUS     current
                    724:             DESCRIPTION
                    725:                     "Whether or not a system has selected
                    726:                     a less specific route without selecting a
                    727:                     more specific route."
                    728:             ::= { bgp4PathAttrEntry 9 }
                    729: 
                    730:         bgp4PathAttrAggregatorAS OBJECT-TYPE
                    731:             SYNTAX     INTEGER (0..65535)
                    732:             MAX-ACCESS read-only
                    733:             STATUS     current
                    734:             DESCRIPTION
                    735:                     "The AS number of the last BGP4 speaker that
                    736:                     performed route aggregation.  A value of zero (0)
                    737:                     indicates the absence of this attribute."
                    738:             ::= { bgp4PathAttrEntry 10 }
                    739: 
                    740:         bgp4PathAttrAggregatorAddr OBJECT-TYPE
                    741:             SYNTAX     IpAddress
                    742:             MAX-ACCESS read-only
                    743:             STATUS     current
                    744:             DESCRIPTION
                    745:                     "The IP address of the last BGP4 speaker that
                    746:                      performed route aggregation.  A value of
                    747:                      0.0.0.0 indicates the absence of this attribute."
                    748:             ::= { bgp4PathAttrEntry 11 }
                    749: 
                    750:         bgp4PathAttrCalcLocalPref OBJECT-TYPE
                    751:             SYNTAX     INTEGER (-1..2147483647)
                    752:             MAX-ACCESS read-only
                    753:             STATUS     current
                    754:             DESCRIPTION
                    755:                     "The degree of preference calculated by the
                    756:                     receiving BGP4 speaker for an advertised route.
                    757:                     A value of -1 indicates the absence of this
                    758:                     attribute."
                    759:             ::= { bgp4PathAttrEntry 12 }
                    760: 
                    761:         bgp4PathAttrBest OBJECT-TYPE
                    762:             SYNTAX     INTEGER {
                    763:                            false(1),-- not chosen as best route
                    764:                            true(2) -- chosen as best route
                    765:                        }
                    766:             MAX-ACCESS read-only
                    767:             STATUS     current
                    768:             DESCRIPTION
                    769:                     "An indication of whether or not this route
                    770:                     was chosen as the best BGP4 route."
                    771:             ::= { bgp4PathAttrEntry 13 }
                    772: 
                    773:         bgp4PathAttrUnknown OBJECT-TYPE
                    774:             SYNTAX     OCTET STRING (SIZE(0..255))
                    775:             MAX-ACCESS read-only
                    776:             STATUS     current
                    777:             DESCRIPTION
                    778:                     "One or more path attributes not understood
                    779:                      by this BGP4 speaker.  Size zero (0) indicates
                    780:                      the absence of such attribute(s).  Octets
                    781:                      beyond the maximum size, if any, are not
                    782:                      recorded by this object."
                    783:             ::= { bgp4PathAttrEntry 14 }
                    784: 
                    785: 
                    786:         -- Traps.
                    787: 
                    788:         -- note that in RFC 1657, bgpTraps was incorrectly
                    789:         -- assigned a value of { bgp 7 }, and each of the
                    790:         -- traps had the bgpPeerRemoteAddr object inappropriately
                    791:         -- removed from their OBJECTS clause.  The following
                    792:         -- definitions restore the semantics of the traps as
                    793:         -- they were initially defined in RFC 1269.
                    794: 
                    795:         -- { bgp 7 } is unused
                    796: 
                    797:         bgpTraps          OBJECT IDENTIFIER ::= { bgp 0 }
                    798: 
                    799:         bgpEstablished NOTIFICATION-TYPE
                    800:             OBJECTS { bgpPeerRemoteAddr,
                    801:                       bgpPeerLastError,
                    802:                       bgpPeerState      }
                    803:             STATUS  current
                    804:             DESCRIPTION
                    805:                     "The BGP Established event is generated when
                    806:                     the BGP FSM enters the ESTABLISHED state."
                    807:             ::= { bgpTraps 1 }
                    808: 
                    809:         bgpBackwardTransition NOTIFICATION-TYPE
                    810:             OBJECTS { bgpPeerRemoteAddr,
                    811:                       bgpPeerLastError,
                    812:                       bgpPeerState      }
                    813:             STATUS  current
                    814:             DESCRIPTION
                    815:                     "The BGPBackwardTransition Event is generated
                    816:                     when the BGP FSM moves from a higher numbered
                    817:                     state to a lower numbered state."
                    818:             ::= { bgpTraps 2 }
                    819: 
                    820:         -- conformance information
                    821: 
                    822:         bgpMIBConformance OBJECT IDENTIFIER ::= { bgp 8 }
                    823:         bgpMIBCompliances OBJECT IDENTIFIER ::= { bgpMIBConformance 1 }
                    824:         bgpMIBGroups      OBJECT IDENTIFIER ::= { bgpMIBConformance 2 }
                    825: 
                    826:         -- compliance statements
                    827: 
                    828:         bgpMIBCompliance MODULE-COMPLIANCE
                    829:             STATUS  current
                    830:             DESCRIPTION
                    831:                     "The compliance statement for entities which
                    832:                      implement the BGP4 mib."
                    833:             MODULE  -- this module
                    834:                 MANDATORY-GROUPS { bgp4MIBGlobalsGroup,
                    835:                                    bgp4MIBPeerGroup,
                    836:                                    bgp4MIBPathAttrGroup,
                    837:                                    bgp4MIBNotificationGroup }
                    838:             ::= { bgpMIBCompliances 1 }
                    839: 
                    840:         -- units of conformance
                    841: 
                    842:         bgp4MIBGlobalsGroup OBJECT-GROUP
                    843:             OBJECTS { bgpVersion,
                    844:                       bgpLocalAs,
                    845:                       bgpIdentifier }
                    846:             STATUS  current
                    847:             DESCRIPTION
                    848:                     "A collection of objects providing information
                    849:                      on global BGP state."
                    850:             ::= { bgpMIBGroups 1 }
                    851: 
                    852:         bgp4MIBPeerGroup OBJECT-GROUP
                    853:             OBJECTS { bgpPeerIdentifier,
                    854:                       bgpPeerState,
                    855:                       bgpPeerAdminStatus,
                    856:                       bgpPeerNegotiatedVersion,
                    857:                       bgpPeerLocalAddr,
                    858:                       bgpPeerLocalPort,
                    859:                       bgpPeerRemoteAddr,
                    860:                       bgpPeerRemotePort,
                    861:                       bgpPeerRemoteAs,
                    862:                       bgpPeerInUpdates,
                    863:                       bgpPeerOutUpdates,
                    864:                       bgpPeerInTotalMessages,
                    865:                       bgpPeerOutTotalMessages,
                    866:                       bgpPeerLastError,
                    867:                       bgpPeerFsmEstablishedTransitions,
                    868:                       bgpPeerFsmEstablishedTime,
                    869:                       bgpPeerConnectRetryInterval,
                    870:                       bgpPeerHoldTime,
                    871:                       bgpPeerKeepAlive,
                    872:                       bgpPeerHoldTimeConfigured,
                    873:                       bgpPeerKeepAliveConfigured,
                    874:                       bgpPeerMinASOriginationInterval,
                    875:                       bgpPeerMinRouteAdvertisementInterval,
                    876:                       bgpPeerInUpdateElapsedTime }
                    877:             STATUS  current
                    878:             DESCRIPTION
                    879:                     "A collection of objects for managing
                    880:                      BGP peers."
                    881:             ::= { bgpMIBGroups 2 }
                    882: 
                    883:         bgp4MIBRcvdPathAttrGroup OBJECT-GROUP
                    884:             OBJECTS { bgpPathAttrPeer,
                    885:                       bgpPathAttrDestNetwork,
                    886:                       bgpPathAttrOrigin,
                    887:                       bgpPathAttrASPath,
                    888:                       bgpPathAttrNextHop,
                    889:                       bgpPathAttrInterASMetric }
                    890:             STATUS  obsolete
                    891:             DESCRIPTION
                    892:                     "A collection of objects for managing BGP
                    893:                      path entries.
                    894: 
                    895:                      This conformance group is obsolete,
                    896:                      replaced by bgp4MIBPathAttrGroup."
                    897:             ::= { bgpMIBGroups 3 }
                    898: 
                    899:         bgp4MIBPathAttrGroup OBJECT-GROUP
                    900:             OBJECTS { bgp4PathAttrPeer,
                    901:                       bgp4PathAttrIpAddrPrefixLen,
                    902:                       bgp4PathAttrIpAddrPrefix,
                    903:                       bgp4PathAttrOrigin,
                    904:                       bgp4PathAttrASPathSegment,
                    905:                       bgp4PathAttrNextHop,
                    906:                       bgp4PathAttrMultiExitDisc,
                    907:                       bgp4PathAttrLocalPref,
                    908:                       bgp4PathAttrAtomicAggregate,
                    909:                       bgp4PathAttrAggregatorAS,
                    910:                       bgp4PathAttrAggregatorAddr,
                    911:                       bgp4PathAttrCalcLocalPref,
                    912:                       bgp4PathAttrBest,
                    913:                       bgp4PathAttrUnknown }
                    914:             STATUS  current
                    915:             DESCRIPTION
                    916:                     "A collection of objects for managing
                    917:                      BGP path entries."
                    918:             ::= { bgpMIBGroups 4 }
                    919: 
                    920:         bgp4MIBNotificationGroup NOTIFICATION-GROUP
                    921:             NOTIFICATIONS { bgpEstablished,
                    922:                             bgpBackwardTransition }
                    923:             STATUS  current
                    924:             DESCRIPTION
                    925:                     "A collection of notifications for signaling
                    926:                     changes in BGP peer relationships."
                    927:             ::= { bgpMIBGroups 5 }
                    928: 
                    929:     END

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>