mibs/ietf/PIM-MIB

   1 PIM-MIB DEFINITIONS ::= BEGIN
   2
   3 IMPORTS
   4     MODULE-IDENTITY, OBJECT-TYPE, experimental,
   5     NOTIFICATION-TYPE,
   6     Integer32, IpAddress, TimeTicks  FROM SNMPv2-SMI
   7     RowStatus, TruthValue            FROM SNMPv2-TC
   8     MODULE-COMPLIANCE, OBJECT-GROUP,
   9     NOTIFICATION-GROUP               FROM SNMPv2-CONF
  10     ipMRouteGroup, ipMRouteSource,
  11     ipMRouteSourceMask, ipMRouteNextHopGroup,
  12     ipMRouteNextHopSource, ipMRouteNextHopSourceMask,
  13     ipMRouteNextHopIfIndex,
  14     ipMRouteNextHopAddress           FROM IPMROUTE-STD-MIB
  15     InterfaceIndex                   FROM IF-MIB;
  16
  17 pimMIB MODULE-IDENTITY
  18     LAST-UPDATED "200009280000Z" -- September 28, 2000
  19     ORGANIZATION "IETF IDMR Working Group."
  20     CONTACT-INFO
  21             " Dave Thaler
  22               Microsoft Corporation
  23               One Microsoft Way
  24               Redmond, WA  98052-6399
  25               US
  26
  27               Phone: +1 425 703 8835
  28               EMail: dthaler@microsoft.com"
  29     DESCRIPTION
  30             "The MIB module for management of PIM routers."
  31     REVISION     "200009280000Z" -- September 28, 2000
  32     DESCRIPTION
  33             "Initial version, published as RFC 2934."
  34     ::= { experimental 61 }
  35
  36 pimMIBObjects OBJECT IDENTIFIER ::= { pimMIB 1 }
  37
  38 pimTraps      OBJECT IDENTIFIER ::= { pimMIBObjects 0 }
  39
  40 pim           OBJECT IDENTIFIER ::= { pimMIBObjects 1 }
  41
  42 pimJoinPruneInterval OBJECT-TYPE
  43     SYNTAX     Integer32
  44     UNITS      "seconds"
  45     MAX-ACCESS read-write
  46     STATUS     current
  47
  48
  49     DESCRIPTION
  50             "The default interval at which periodic PIM-SM Join/Prune
  51             messages are to be sent."
  52     ::= { pim 1 }
  53
  54 -- The PIM Interface Table
  55
  56 pimInterfaceTable OBJECT-TYPE
  57     SYNTAX     SEQUENCE OF PimInterfaceEntry
  58     MAX-ACCESS not-accessible
  59     STATUS     current
  60     DESCRIPTION
  61             "The (conceptual) table listing the router's PIM interfaces.
  62             IGMP and PIM are enabled on all interfaces listed in this
  63             table."
  64     ::= { pim 2 }
  65
  66 pimInterfaceEntry OBJECT-TYPE
  67     SYNTAX     PimInterfaceEntry
  68     MAX-ACCESS not-accessible
  69     STATUS     current
  70     DESCRIPTION
  71             "An entry (conceptual row) in the pimInterfaceTable."
  72     INDEX      { pimInterfaceIfIndex }
  73     ::= { pimInterfaceTable 1 }
  74
  75 PimInterfaceEntry ::= SEQUENCE {
  76     pimInterfaceIfIndex            InterfaceIndex,
  77     pimInterfaceAddress            IpAddress,
  78     pimInterfaceNetMask            IpAddress,
  79     pimInterfaceMode               INTEGER,
  80     pimInterfaceDR                 IpAddress,
  81     pimInterfaceHelloInterval      Integer32,
  82     pimInterfaceStatus             RowStatus,
  83     pimInterfaceJoinPruneInterval  Integer32,
  84     pimInterfaceCBSRPreference     Integer32
  85 }
  86
  87 pimInterfaceIfIndex OBJECT-TYPE
  88     SYNTAX     InterfaceIndex
  89     MAX-ACCESS not-accessible
  90     STATUS     current
  91     DESCRIPTION
  92             "The ifIndex value of this PIM interface."
  93     ::= { pimInterfaceEntry 1 }
  94
  95 pimInterfaceAddress OBJECT-TYPE
  96     SYNTAX     IpAddress
  97
  98
  99     MAX-ACCESS read-only
 100     STATUS     current
 101
 102     DESCRIPTION
 103             "The IP address of the PIM interface."
 104     ::= { pimInterfaceEntry 2 }
 105
 106 pimInterfaceNetMask OBJECT-TYPE
 107     SYNTAX     IpAddress
 108     MAX-ACCESS read-only
 109     STATUS     current
 110     DESCRIPTION
 111             "The network mask for the IP address of the PIM interface."
 112     ::= { pimInterfaceEntry 3 }
 113
 114 pimInterfaceMode OBJECT-TYPE
 115     SYNTAX     INTEGER { dense(1), sparse(2), sparseDense(3) }
 116     MAX-ACCESS read-create
 117     STATUS     current
 118     DESCRIPTION
 119             "The configured mode of this PIM interface.  A value of
 120             sparseDense is only valid for PIMv1."
 121     DEFVAL     { dense }
 122     ::= { pimInterfaceEntry 4 }
 123
 124 pimInterfaceDR OBJECT-TYPE
 125     SYNTAX     IpAddress
 126     MAX-ACCESS read-only
 127     STATUS     current
 128     DESCRIPTION
 129             "The Designated Router on this PIM interface.  For point-to-
 130             point interfaces, this object has the value 0.0.0.0."
 131     ::= { pimInterfaceEntry 5 }
 132
 133 pimInterfaceHelloInterval OBJECT-TYPE
 134     SYNTAX     Integer32
 135     UNITS      "seconds"
 136     MAX-ACCESS read-create
 137     STATUS     current
 138     DESCRIPTION
 139             "The frequency at which PIM Hello messages are transmitted
 140             on this interface."
 141     DEFVAL     { 30 }
 142     ::= { pimInterfaceEntry 6 }
 143
 144 pimInterfaceStatus OBJECT-TYPE
 145     SYNTAX     RowStatus
 146     MAX-ACCESS read-create
 147
 148
 149     STATUS     current
 150     DESCRIPTION
 151             "The status of this entry.  Creating the entry enables PIM
 152             on the interface; destroying the entry disables PIM on the
 153             interface."
 154     ::= { pimInterfaceEntry 7 }
 155
 156 pimInterfaceJoinPruneInterval OBJECT-TYPE
 157     SYNTAX     Integer32
 158     UNITS      "seconds"
 159     MAX-ACCESS read-create
 160     STATUS     current
 161     DESCRIPTION
 162             "The frequency at which PIM Join/Prune messages are
 163             transmitted on this PIM interface.  The default value of
 164             this object is the pimJoinPruneInterval."
 165     ::= { pimInterfaceEntry 8 }
 166
 167 pimInterfaceCBSRPreference OBJECT-TYPE
 168     SYNTAX     Integer32 (-1..255)
 169     MAX-ACCESS read-create
 170     STATUS     current
 171     DESCRIPTION
 172             "The preference value for the local interface as a candidate
 173             bootstrap router.  The value of -1 is used to indicate that
 174             the local interface is not a candidate BSR interface."
 175     DEFVAL     { 0 }
 176     ::= { pimInterfaceEntry 9 }
 177
 178
 179 -- The PIM Neighbor Table
 180
 181 pimNeighborTable OBJECT-TYPE
 182     SYNTAX     SEQUENCE OF PimNeighborEntry
 183     MAX-ACCESS not-accessible
 184     STATUS     current
 185     DESCRIPTION
 186             "The (conceptual) table listing the router's PIM neighbors."
 187     ::= { pim 3 }
 188
 189 pimNeighborEntry OBJECT-TYPE
 190     SYNTAX     PimNeighborEntry
 191     MAX-ACCESS not-accessible
 192     STATUS     current
 193     DESCRIPTION
 194             "An entry (conceptual row) in the pimNeighborTable."
 195     INDEX      { pimNeighborAddress }
 196     ::= { pimNeighborTable 1 }
 197
 198
 199 PimNeighborEntry ::= SEQUENCE {
 200     pimNeighborAddress      IpAddress,
 201     pimNeighborIfIndex      InterfaceIndex,
 202     pimNeighborUpTime       TimeTicks,
 203     pimNeighborExpiryTime   TimeTicks,
 204     pimNeighborMode         INTEGER
 205 }
 206
 207 pimNeighborAddress OBJECT-TYPE
 208     SYNTAX     IpAddress
 209     MAX-ACCESS not-accessible
 210     STATUS     current
 211     DESCRIPTION
 212             "The IP address of the PIM neighbor for which this entry
 213             contains information."
 214     ::= { pimNeighborEntry 1 }
 215
 216 pimNeighborIfIndex OBJECT-TYPE
 217     SYNTAX     InterfaceIndex
 218     MAX-ACCESS read-only
 219     STATUS     current
 220     DESCRIPTION
 221             "The value of ifIndex for the interface used to reach this
 222             PIM neighbor."
 223     ::= { pimNeighborEntry 2 }
 224
 225 pimNeighborUpTime OBJECT-TYPE
 226     SYNTAX     TimeTicks
 227     MAX-ACCESS read-only
 228     STATUS     current
 229     DESCRIPTION
 230             "The time since this PIM neighbor (last) became a neighbor
 231             of the local router."
 232     ::= { pimNeighborEntry 3 }
 233
 234 pimNeighborExpiryTime OBJECT-TYPE
 235     SYNTAX     TimeTicks
 236     MAX-ACCESS read-only
 237     STATUS     current
 238     DESCRIPTION
 239             "The minimum time remaining before this PIM neighbor will be
 240             aged out."
 241     ::= { pimNeighborEntry 4 }
 242
 243 pimNeighborMode OBJECT-TYPE
 244     SYNTAX     INTEGER { dense(1), sparse(2) }
 245     MAX-ACCESS read-only
 246     STATUS     deprecated
 247
 248
 249     DESCRIPTION
 250             "The active PIM mode of this neighbor.  This object is
 251             deprecated for PIMv2 routers since all neighbors on the
 252             interface must be either dense or sparse as determined by
 253             the protocol running on the interface."
 254     ::= { pimNeighborEntry 5 }
 255
 256 --
 257 -- The PIM IP Multicast Route Table
 258 --
 259
 260 pimIpMRouteTable OBJECT-TYPE
 261     SYNTAX     SEQUENCE OF PimIpMRouteEntry
 262     MAX-ACCESS not-accessible
 263     STATUS     current
 264     DESCRIPTION
 265             "The (conceptual) table listing PIM-specific information on
 266             a subset of the rows of the ipMRouteTable defined in the IP
 267             Multicast MIB."
 268     ::= { pim 4 }
 269
 270 pimIpMRouteEntry OBJECT-TYPE
 271     SYNTAX     PimIpMRouteEntry
 272     MAX-ACCESS not-accessible
 273     STATUS     current
 274     DESCRIPTION
 275             "An entry (conceptual row) in the pimIpMRouteTable.  There
 276             is one entry per entry in the ipMRouteTable whose incoming
 277             interface is running PIM."
 278     INDEX      { ipMRouteGroup, ipMRouteSource, ipMRouteSourceMask }
 279     ::= { pimIpMRouteTable 1 }
 280
 281 PimIpMRouteEntry ::= SEQUENCE {
 282     pimIpMRouteUpstreamAssertTimer   TimeTicks,
 283     pimIpMRouteAssertMetric          Integer32,
 284     pimIpMRouteAssertMetricPref      Integer32,
 285     pimIpMRouteAssertRPTBit          TruthValue,
 286     pimIpMRouteFlags                 BITS
 287 }
 288
 289 pimIpMRouteUpstreamAssertTimer OBJECT-TYPE
 290     SYNTAX     TimeTicks
 291     MAX-ACCESS read-only
 292     STATUS     current
 293     DESCRIPTION
 294             "The time remaining before the router changes its upstream
 295             neighbor back to its RPF neighbor.  This timer is called the
 296             Assert timer in the PIM Sparse and Dense mode specification.
 297
 298
 299             A value of 0 indicates that no Assert has changed the
 300             upstream neighbor away from the RPF neighbor."
 301     ::= { pimIpMRouteEntry 1 }
 302
 303 pimIpMRouteAssertMetric OBJECT-TYPE
 304     SYNTAX     Integer32
 305     MAX-ACCESS read-only
 306     STATUS     current
 307     DESCRIPTION
 308             "The metric advertised by the assert winner on the upstream
 309             interface, or 0 if no such assert is in received."
 310     ::= { pimIpMRouteEntry 2 }
 311
 312 pimIpMRouteAssertMetricPref OBJECT-TYPE
 313     SYNTAX     Integer32
 314     MAX-ACCESS read-only
 315     STATUS     current
 316     DESCRIPTION
 317             "The preference advertised by the assert winner on the
 318             upstream interface, or 0 if no such assert is in effect."
 319     ::= { pimIpMRouteEntry 3 }
 320
 321 pimIpMRouteAssertRPTBit OBJECT-TYPE
 322     SYNTAX     TruthValue
 323     MAX-ACCESS read-only
 324     STATUS     current
 325     DESCRIPTION
 326             "The value of the RPT-bit advertised by the assert winner on
 327             the upstream interface, or false if no such assert is in
 328             effect."
 329     ::= { pimIpMRouteEntry 4 }
 330
 331 pimIpMRouteFlags OBJECT-TYPE
 332     SYNTAX     BITS {
 333                   rpt(0),
 334                   spt(1)
 335                }
 336     MAX-ACCESS read-only
 337     STATUS     current
 338     DESCRIPTION
 339             "This object describes PIM-specific flags related to a
 340             multicast state entry.  See the PIM Sparse Mode
 341             specification for the meaning of the RPT and SPT bits."
 342     ::= { pimIpMRouteEntry 5 }
 343
 344 --
 345 -- The PIM Next Hop Table
 346 --
 347
 348
 349 pimIpMRouteNextHopTable OBJECT-TYPE
 350     SYNTAX     SEQUENCE OF PimIpMRouteNextHopEntry
 351     MAX-ACCESS not-accessible
 352     STATUS     current
 353     DESCRIPTION
 354             "The (conceptual) table listing PIM-specific information on
 355             a subset of the rows of the ipMRouteNextHopTable defined in
 356             the IP Multicast MIB."
 357     ::= { pim 7 }
 358
 359 pimIpMRouteNextHopEntry OBJECT-TYPE
 360     SYNTAX     PimIpMRouteNextHopEntry
 361     MAX-ACCESS not-accessible
 362     STATUS     current
 363     DESCRIPTION
 364             "An entry (conceptual row) in the pimIpMRouteNextHopTable.
 365             There is one entry per entry in the ipMRouteNextHopTable
 366             whose interface is running PIM and whose
 367             ipMRouteNextHopState is pruned(1)."
 368     INDEX      { ipMRouteNextHopGroup, ipMRouteNextHopSource,
 369                  ipMRouteNextHopSourceMask, ipMRouteNextHopIfIndex,
 370                  ipMRouteNextHopAddress }
 371     ::= { pimIpMRouteNextHopTable 1 }
 372
 373 PimIpMRouteNextHopEntry ::= SEQUENCE {
 374     pimIpMRouteNextHopPruneReason       INTEGER
 375 }
 376
 377 pimIpMRouteNextHopPruneReason OBJECT-TYPE
 378     SYNTAX     INTEGER {
 379                   other (1),
 380                   prune (2),
 381                   assert (3)
 382                }
 383     MAX-ACCESS read-only
 384     STATUS     current
 385     DESCRIPTION
 386             "This object indicates why the downstream interface was
 387             pruned, whether in response to a PIM prune message or due to
 388             PIM Assert processing."
 389     ::= { pimIpMRouteNextHopEntry 2 }
 390
 391 -- The PIM RP Table
 392
 393 pimRPTable OBJECT-TYPE
 394     SYNTAX     SEQUENCE OF PimRPEntry
 395     MAX-ACCESS not-accessible
 396     STATUS     deprecated
 397
 398
 399     DESCRIPTION
 400             "The (conceptual) table listing PIM version 1 information
 401             for the Rendezvous Points (RPs) for IP multicast groups.
 402             This table is deprecated since its function is replaced by
 403             the pimRPSetTable for PIM version 2."
 404     ::= { pim 5 }
 405
 406 pimRPEntry OBJECT-TYPE
 407     SYNTAX     PimRPEntry
 408     MAX-ACCESS not-accessible
 409     STATUS     deprecated
 410     DESCRIPTION
 411             "An entry (conceptual row) in the pimRPTable.  There is one
 412             entry per RP address for each IP multicast group."
 413     INDEX      { pimRPGroupAddress, pimRPAddress }
 414     ::= { pimRPTable 1 }
 415
 416 PimRPEntry ::= SEQUENCE {
 417     pimRPGroupAddress    IpAddress,
 418     pimRPAddress         IpAddress,
 419     pimRPState           INTEGER,
 420     pimRPStateTimer      TimeTicks,
 421     pimRPLastChange      TimeTicks,
 422     pimRPRowStatus       RowStatus
 423 }
 424
 425 pimRPGroupAddress OBJECT-TYPE
 426     SYNTAX     IpAddress
 427     MAX-ACCESS not-accessible
 428     STATUS     deprecated
 429     DESCRIPTION
 430             "The IP multicast group address for which this entry
 431             contains information about an RP."
 432     ::= { pimRPEntry 1 }
 433
 434 pimRPAddress OBJECT-TYPE
 435     SYNTAX     IpAddress
 436     MAX-ACCESS not-accessible
 437     STATUS     deprecated
 438     DESCRIPTION
 439             "The unicast address of the RP."
 440     ::= { pimRPEntry 2 }
 441
 442 pimRPState OBJECT-TYPE
 443     SYNTAX     INTEGER { up(1), down(2) }
 444     MAX-ACCESS read-only
 445     STATUS     deprecated
 446     DESCRIPTION
 447
 448
 449             "The state of the RP."
 450     ::= { pimRPEntry 3 }
 451
 452 pimRPStateTimer OBJECT-TYPE
 453     SYNTAX     TimeTicks
 454     MAX-ACCESS read-only
 455     STATUS     deprecated
 456     DESCRIPTION
 457             "The minimum time remaining before the next state change.
 458             When pimRPState is up, this is the minimum time which must
 459             expire until it can be declared down.  When pimRPState is
 460             down, this is the time until it will be declared up (in
 461             order to retry)."
 462     ::= { pimRPEntry 4 }
 463
 464 pimRPLastChange OBJECT-TYPE
 465     SYNTAX     TimeTicks
 466     MAX-ACCESS read-only
 467     STATUS     deprecated
 468     DESCRIPTION
 469             "The value of sysUpTime at the time when the corresponding
 470             instance of pimRPState last changed its value."
 471     ::= { pimRPEntry 5 }
 472
 473 pimRPRowStatus OBJECT-TYPE
 474     SYNTAX     RowStatus
 475     MAX-ACCESS read-create
 476     STATUS     deprecated
 477     DESCRIPTION
 478             "The status of this row, by which new entries may be
 479             created, or old entries deleted from this table."
 480     ::= { pimRPEntry 6 }
 481
 482 -- The PIM RP-Set Table
 483
 484 pimRPSetTable OBJECT-TYPE
 485     SYNTAX     SEQUENCE OF PimRPSetEntry
 486     MAX-ACCESS not-accessible
 487     STATUS     current
 488     DESCRIPTION
 489             "The (conceptual) table listing PIM information for
 490             candidate Rendezvous Points (RPs) for IP multicast groups.
 491             When the local router is the BSR, this information is
 492             obtained from received Candidate-RP-Advertisements.  When
 493             the local router is not the BSR, this information is
 494             obtained from received RP-Set messages."
 495     ::= { pim 6 }
 496
 497
 498
 499 pimRPSetEntry OBJECT-TYPE
 500     SYNTAX     PimRPSetEntry
 501     MAX-ACCESS not-accessible
 502     STATUS     current
 503     DESCRIPTION
 504             "An entry (conceptual row) in the pimRPSetTable."
 505     INDEX      { pimRPSetComponent, pimRPSetGroupAddress,
 506                  pimRPSetGroupMask, pimRPSetAddress }
 507     ::= { pimRPSetTable 1 }
 508
 509 PimRPSetEntry ::= SEQUENCE {
 510
 511     pimRPSetGroupAddress    IpAddress,
 512     pimRPSetGroupMask       IpAddress,
 513     pimRPSetAddress         IpAddress,
 514     pimRPSetHoldTime        Integer32,
 515     pimRPSetExpiryTime      TimeTicks,
 516     pimRPSetComponent       Integer32
 517 }
 518
 519 pimRPSetGroupAddress OBJECT-TYPE
 520     SYNTAX     IpAddress
 521     MAX-ACCESS not-accessible
 522     STATUS     current
 523     DESCRIPTION
 524             "The IP multicast group address which, when combined with
 525             pimRPSetGroupMask, gives the group prefix for which this
 526             entry contains information about the Candidate-RP."
 527     ::= { pimRPSetEntry 1 }
 528
 529 pimRPSetGroupMask OBJECT-TYPE
 530     SYNTAX     IpAddress
 531     MAX-ACCESS not-accessible
 532     STATUS     current
 533     DESCRIPTION
 534             "The multicast group address mask which, when combined with
 535             pimRPSetGroupAddress, gives the group prefix for which this
 536             entry contains information about the Candidate-RP."
 537     ::= { pimRPSetEntry 2 }
 538
 539 pimRPSetAddress OBJECT-TYPE
 540     SYNTAX     IpAddress
 541     MAX-ACCESS not-accessible
 542     STATUS     current
 543     DESCRIPTION
 544             "The IP address of the Candidate-RP."
 545     ::= { pimRPSetEntry 3 }
 546
 547
 548
 549 pimRPSetHoldTime OBJECT-TYPE
 550     SYNTAX     Integer32 (0..255)
 551     UNITS      "seconds"
 552     MAX-ACCESS read-only
 553     STATUS     current
 554     DESCRIPTION
 555             "The holdtime of a Candidate-RP.  If the local router is not
 556             the BSR, this value is 0."
 557     ::= { pimRPSetEntry 4 }
 558
 559 pimRPSetExpiryTime OBJECT-TYPE
 560     SYNTAX     TimeTicks
 561     MAX-ACCESS read-only
 562     STATUS     current
 563     DESCRIPTION
 564             "The minimum time remaining before the Candidate-RP will be
 565             declared down.  If the local router is not the BSR, this
 566             value is 0."
 567     ::= { pimRPSetEntry 5 }
 568
 569 pimRPSetComponent OBJECT-TYPE
 570     SYNTAX     Integer32 (1..255)
 571     MAX-ACCESS not-accessible
 572     STATUS     current
 573     DESCRIPTION
 574             " A number uniquely identifying the component.  Each
 575             protocol instance connected to a separate domain should have
 576             a different index value."
 577     ::= { pimRPSetEntry 6 }
 578
 579 --
 580 -- Note: { pim 8 } through { pim 10 } were used in older versions
 581 -- of this MIB.  Since some earlier versions of this MIB have been
 582 -- widely-deployed, these values must not be used in the future,
 583 -- as long the MIB is rooted under { experimental 61 }.
 584 --
 585
 586 -- The PIM Candidate-RP Table
 587
 588 pimCandidateRPTable OBJECT-TYPE
 589     SYNTAX     SEQUENCE OF PimCandidateRPEntry
 590     MAX-ACCESS not-accessible
 591     STATUS     current
 592     DESCRIPTION
 593             "The (conceptual) table listing the IP multicast groups for
 594             which the local router is to advertise itself as a
 595             Candidate-RP when the value of pimComponentCRPHoldTime is
 596             non-zero.  If this table is empty, then the local router
 597
 598
 599             will advertise itself as a Candidate-RP for all groups
 600             (providing the value of pimComponentCRPHoldTime is non-
 601             zero)."
 602     ::= { pim 11 }
 603
 604 pimCandidateRPEntry OBJECT-TYPE
 605     SYNTAX     PimCandidateRPEntry
 606     MAX-ACCESS not-accessible
 607     STATUS     current
 608     DESCRIPTION
 609             "An entry (conceptual row) in the pimCandidateRPTable."
 610     INDEX      { pimCandidateRPGroupAddress,
 611                  pimCandidateRPGroupMask }
 612     ::= { pimCandidateRPTable 1 }
 613
 614 PimCandidateRPEntry ::= SEQUENCE {
 615     pimCandidateRPGroupAddress    IpAddress,
 616     pimCandidateRPGroupMask       IpAddress,
 617     pimCandidateRPAddress         IpAddress,
 618     pimCandidateRPRowStatus       RowStatus
 619 }
 620
 621 pimCandidateRPGroupAddress OBJECT-TYPE
 622     SYNTAX     IpAddress
 623     MAX-ACCESS not-accessible
 624     STATUS     current
 625     DESCRIPTION
 626             "The IP multicast group address which, when combined with
 627             pimCandidateRPGroupMask, identifies a group prefix for which
 628             the local router will advertise itself as a Candidate-RP."
 629     ::= { pimCandidateRPEntry 1 }
 630
 631 pimCandidateRPGroupMask OBJECT-TYPE
 632     SYNTAX     IpAddress
 633     MAX-ACCESS not-accessible
 634     STATUS     current
 635     DESCRIPTION
 636             "The multicast group address mask which, when combined with
 637             pimCandidateRPGroupMask, identifies a group prefix for which
 638             the local router will advertise itself as a Candidate-RP."
 639     ::= { pimCandidateRPEntry 2 }
 640
 641 pimCandidateRPAddress OBJECT-TYPE
 642     SYNTAX     IpAddress
 643     MAX-ACCESS read-create
 644     STATUS     current
 645     DESCRIPTION
 646             "The (unicast) address of the interface which will be
 647
 648
 649             advertised as a Candidate-RP."
 650     ::= { pimCandidateRPEntry 3 }
 651
 652 pimCandidateRPRowStatus OBJECT-TYPE
 653     SYNTAX     RowStatus
 654     MAX-ACCESS read-create
 655     STATUS     current
 656     DESCRIPTION
 657             "The status of this row, by which new entries may be
 658             created, or old entries deleted from this table."
 659     ::= { pimCandidateRPEntry 4 }
 660
 661 -- The PIM Component Table
 662
 663 pimComponentTable OBJECT-TYPE
 664     SYNTAX     SEQUENCE OF PimComponentEntry
 665     MAX-ACCESS not-accessible
 666     STATUS     current
 667     DESCRIPTION
 668             "The (conceptual) table containing objects specific to a PIM
 669             domain.  One row exists for each domain to which the router
 670             is connected.  A PIM-SM domain is defined as an area of the
 671             network over which Bootstrap messages are forwarded.
 672             Typically, a PIM-SM router will be a member of exactly one
 673             domain.  This table also supports, however, routers which
 674             may form a border between two PIM-SM domains and do not
 675             forward Bootstrap messages between them."
 676     ::= { pim 12 }
 677
 678 pimComponentEntry OBJECT-TYPE
 679     SYNTAX     PimComponentEntry
 680     MAX-ACCESS not-accessible
 681     STATUS     current
 682     DESCRIPTION
 683             "An entry (conceptual row) in the pimComponentTable."
 684     INDEX      { pimComponentIndex }
 685     ::= { pimComponentTable 1 }
 686
 687 PimComponentEntry ::= SEQUENCE {
 688     pimComponentIndex              Integer32,
 689     pimComponentBSRAddress         IpAddress,
 690     pimComponentBSRExpiryTime      TimeTicks,
 691     pimComponentCRPHoldTime        Integer32,
 692     pimComponentStatus             RowStatus
 693 }
 694
 695 pimComponentIndex OBJECT-TYPE
 696     SYNTAX     Integer32 (1..255)
 697
 698
 699     MAX-ACCESS not-accessible
 700     STATUS     current
 701     DESCRIPTION
 702             "A number uniquely identifying the component.  Each protocol
 703             instance connected to a separate domain should have a
 704             different index value.  Routers that only support membership
 705             in a single PIM-SM domain should use a pimComponentIndex
 706             value of 1."
 707     ::= { pimComponentEntry 1 }
 708
 709 pimComponentBSRAddress OBJECT-TYPE
 710     SYNTAX     IpAddress
 711     MAX-ACCESS read-only
 712     STATUS     current
 713     DESCRIPTION
 714             "The IP address of the bootstrap router (BSR) for the local
 715             PIM region."
 716     ::= { pimComponentEntry 2 }
 717
 718 pimComponentBSRExpiryTime OBJECT-TYPE
 719     SYNTAX     TimeTicks
 720     MAX-ACCESS read-only
 721     STATUS     current
 722     DESCRIPTION
 723             "The minimum time remaining before the bootstrap router in
 724             the local domain will be declared down.  For candidate BSRs,
 725             this is the time until the component sends an RP-Set
 726             message.  For other routers, this is the time until it may
 727             accept an RP-Set message from a lower candidate BSR."
 728     ::= { pimComponentEntry 3 }
 729
 730 pimComponentCRPHoldTime OBJECT-TYPE
 731     SYNTAX     Integer32 (0..255)
 732     UNITS      "seconds"
 733     MAX-ACCESS read-create
 734     STATUS     current
 735     DESCRIPTION
 736             "The holdtime of the component when it is a candidate RP in
 737             the local domain.  The value of 0 is used to indicate that
 738             the local system is not a Candidate-RP."
 739     DEFVAL     { 0 }
 740     ::= { pimComponentEntry 4 }
 741
 742 pimComponentStatus OBJECT-TYPE
 743     SYNTAX     RowStatus
 744     MAX-ACCESS read-create
 745     STATUS     current
 746     DESCRIPTION
 747
 748
 749             "The status of this entry.  Creating the entry creates
 750             another protocol instance; destroying the entry disables a
 751             protocol instance."
 752     ::= { pimComponentEntry 5 }
 753
 754 -- PIM Traps
 755
 756 pimNeighborLoss NOTIFICATION-TYPE
 757     OBJECTS {
 758        pimNeighborIfIndex
 759     }
 760     STATUS             current
 761     DESCRIPTION
 762             "A pimNeighborLoss trap signifies the loss of an adjacency
 763             with a neighbor.  This trap should be generated when the
 764             neighbor timer expires, and the router has no other
 765             neighbors on the same interface with a lower IP address than
 766             itself."
 767     ::= { pimTraps 1 }
 768
 769 -- conformance information
 770
 771 pimMIBConformance OBJECT IDENTIFIER ::= { pimMIB 2 }
 772 pimMIBCompliances OBJECT IDENTIFIER ::= { pimMIBConformance 1 }
 773 pimMIBGroups      OBJECT IDENTIFIER ::= { pimMIBConformance 2 }
 774
 775
 776 -- compliance statements
 777
 778 pimV1MIBCompliance MODULE-COMPLIANCE
 779     STATUS  deprecated
 780     DESCRIPTION
 781             "The compliance statement for routers running PIMv1 and
 782             implementing the PIM MIB."
 783     MODULE  -- this module
 784         MANDATORY-GROUPS { pimV1MIBGroup }
 785
 786     ::= { pimMIBCompliances 1 }
 787
 788 pimSparseV2MIBCompliance MODULE-COMPLIANCE
 789     STATUS  current
 790     DESCRIPTION
 791             "The compliance statement for routers running PIM Sparse
 792             Mode and implementing the PIM MIB."
 793     MODULE  -- this module
 794     MANDATORY-GROUPS { pimV2MIBGroup }
 795
 796     GROUP      pimV2CandidateRPMIBGroup
 797
 798
 799     DESCRIPTION
 800             "This group is mandatory if the router is capable of being a
 801             Candidate RP."
 802
 803     OBJECT     pimInterfaceStatus
 804     MIN-ACCESS read-only
 805     DESCRIPTION
 806              "Write access is not required."
 807
 808     ::= { pimMIBCompliances 2 }
 809
 810 pimDenseV2MIBCompliance MODULE-COMPLIANCE
 811     STATUS  current
 812     DESCRIPTION
 813             "The compliance statement for routers running PIM Dense Mode
 814             and implementing the PIM MIB."
 815     MODULE  -- this module
 816
 817         MANDATORY-GROUPS { pimDenseV2MIBGroup }
 818
 819     OBJECT     pimInterfaceStatus
 820     MIN-ACCESS read-only
 821     DESCRIPTION
 822              "Write access is not required."
 823
 824     ::= { pimMIBCompliances 3 }
 825
 826 -- units of conformance
 827
 828 pimNotificationGroup NOTIFICATION-GROUP
 829     NOTIFICATIONS { pimNeighborLoss }
 830     STATUS  current
 831     DESCRIPTION
 832             "A collection of notifications for signaling important PIM
 833             events."
 834     ::= { pimMIBGroups 1 }
 835
 836 pimV2MIBGroup OBJECT-GROUP
 837     OBJECTS { pimJoinPruneInterval, pimNeighborIfIndex,
 838               pimNeighborUpTime, pimNeighborExpiryTime,
 839               pimInterfaceAddress, pimInterfaceNetMask,
 840               pimInterfaceDR, pimInterfaceHelloInterval,
 841               pimInterfaceStatus, pimInterfaceJoinPruneInterval,
 842               pimInterfaceCBSRPreference, pimInterfaceMode,
 843               pimRPSetHoldTime, pimRPSetExpiryTime,
 844               pimComponentBSRAddress, pimComponentBSRExpiryTime,
 845               pimComponentCRPHoldTime, pimComponentStatus,
 846               pimIpMRouteFlags, pimIpMRouteUpstreamAssertTimer
 847
 848
 849             }
 850     STATUS  current
 851     DESCRIPTION
 852             "A collection of objects to support management of PIM Sparse
 853             Mode (version 2) routers."
 854     ::= { pimMIBGroups 2 }
 855
 856 pimDenseV2MIBGroup OBJECT-GROUP
 857     OBJECTS { pimNeighborIfIndex,
 858               pimNeighborUpTime, pimNeighborExpiryTime,
 859               pimInterfaceAddress, pimInterfaceNetMask,
 860               pimInterfaceDR, pimInterfaceHelloInterval,
 861               pimInterfaceStatus, pimInterfaceMode
 862             }
 863     STATUS  current
 864     DESCRIPTION
 865             "A collection of objects to support management of PIM Dense
 866             Mode (version 2) routers."
 867     ::= { pimMIBGroups 5 }
 868
 869 pimV2CandidateRPMIBGroup OBJECT-GROUP
 870     OBJECTS { pimCandidateRPAddress,
 871               pimCandidateRPRowStatus
 872             }
 873     STATUS  current
 874     DESCRIPTION
 875             "A collection of objects to support configuration of which
 876             groups a router is to advertise itself as a Candidate-RP."
 877     ::= { pimMIBGroups 3 }
 878
 879 pimV1MIBGroup OBJECT-GROUP
 880     OBJECTS { pimJoinPruneInterval, pimNeighborIfIndex,
 881               pimNeighborUpTime, pimNeighborExpiryTime,
 882               pimNeighborMode,
 883               pimInterfaceAddress, pimInterfaceNetMask,
 884               pimInterfaceJoinPruneInterval, pimInterfaceStatus,
 885               pimInterfaceMode, pimInterfaceDR,
 886               pimInterfaceHelloInterval,
 887               pimRPState, pimRPStateTimer,
 888               pimRPLastChange, pimRPRowStatus
 889             }
 890     STATUS  deprecated
 891     DESCRIPTION
 892             "A collection of objects to support management of PIM
 893             (version 1) routers."
 894     ::= { pimMIBGroups 4 }
 895
 896 pimNextHopGroup OBJECT-GROUP
 897
 898
 899     OBJECTS { pimIpMRouteNextHopPruneReason }
 900     STATUS  current
 901     DESCRIPTION
 902             "A collection of optional objects to provide per-next hop
 903             information for diagnostic purposes.  Supporting this group
 904             may add a large number of instances to a tree walk, but the
 905             information in this group can be extremely useful in
 906             tracking down multicast connectivity problems."
 907     ::= { pimMIBGroups 6 }
 908
 909 pimAssertGroup OBJECT-GROUP
 910     OBJECTS { pimIpMRouteAssertMetric, pimIpMRouteAssertMetricPref,
 911               pimIpMRouteAssertRPTBit }
 912     STATUS  current
 913     DESCRIPTION
 914             "A collection of optional objects to provide extra
 915             information about the assert election process.  There is no
 916             protocol reason to keep such information, but some
 917             implementations may already keep this information and make
 918             it available.  These objects can also be very useful in
 919             debugging connectivity or duplicate packet problems,
 920             especially if the assert winner does not support the PIM and
 921             IP Multicast MIBs."
 922     ::= { pimMIBGroups 7 }
 923
 924 END