idnits 2.17.1 draft-ietf-pim-mib-v2-06.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- ** It looks like you're using RFC 3978 boilerplate. You should update this to the boilerplate described in the IETF Trust License Policy document (see https://trustee.ietf.org/license-info), which is required now. -- Found old boilerplate from RFC 3978, Section 5.1 on line 19. -- Found old boilerplate from RFC 3978, Section 5.5 on line 4090. -- Found old boilerplate from RFC 3979, Section 5, paragraph 1 on line 4067. -- Found old boilerplate from RFC 3979, Section 5, paragraph 2 on line 4074. -- Found old boilerplate from RFC 3979, Section 5, paragraph 3 on line 4080. ** This document has an original RFC 3978 Section 5.4 Copyright Line, instead of the newer IETF Trust Copyright according to RFC 4748. ** The document seems to lack an RFC 3978 Section 5.4 Reference to BCP 78. ** This document has an original RFC 3978 Section 5.5 Disclaimer, instead of the newer disclaimer which includes the IETF Trust according to RFC 4748. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- == No 'Intended status' indicated for this document; assuming Proposed Standard Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- No issues found here. Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the RFC 3978 Section 5.4 Copyright Line does not match the current year == The document seems to use 'NOT RECOMMENDED' as an RFC 2119 keyword, but does not include the phrase in its RFC 2119 key words list. -- The document seems to lack a disclaimer for pre-RFC5378 work, but may have content which was first submitted before 10 November 2008. If you have contacted all the original authors and they are all willing to grant the BCP78 rights to the IETF Trust, then this is fine, and you can ignore this comment. If not, you may need to add the pre-RFC5378 disclaimer. (See the Legal Provisions document at https://trustee.ietf.org/license-info for more information.) -- The document date (April 13, 2006) is 6560 days in the past. Is this intentional? Checking references for intended status: Proposed Standard ---------------------------------------------------------------------------- (See RFCs 3967 and 4897 for information about using normative references to lower-maturity documents in RFCs) == Unused Reference: 'RFC2434' is defined on line 3949, but no explicit reference was found in the text == Unused Reference: 'RFC3569' is defined on line 3968, but no explicit reference was found in the text == Unused Reference: 'RFC3956' is defined on line 3971, but no explicit reference was found in the text == Unused Reference: 'I-D.ietf-pim-sm-v2-new' is defined on line 3983, but no explicit reference was found in the text == Unused Reference: 'I-D.ietf-pim-sm-bsr' is defined on line 3996, but no explicit reference was found in the text == Unused Reference: 'I-D.ietf-pim-anycast-rp' is defined on line 4001, but no explicit reference was found in the text == Unused Reference: 'I-D.ietf-mboned-ip-mcast-mib' is defined on line 4006, but no explicit reference was found in the text ** Obsolete normative reference: RFC 2434 (Obsoleted by RFC 5226) ** Downref: Normative reference to an Informational RFC: RFC 3569 ** Downref: Normative reference to an Experimental RFC: RFC 3973 == Outdated reference: A later version (-09) exists of draft-ietf-pim-bidir-08 == Outdated reference: A later version (-12) exists of draft-ietf-pim-sm-bsr-07 == Outdated reference: A later version (-07) exists of draft-ietf-mboned-ip-mcast-mib-00 -- Obsolete informational reference (is this intentional?): RFC 2932 (Obsoleted by RFC 5132) Summary: 7 errors (**), 0 flaws (~~), 13 warnings (==), 8 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 PIM WG R. Sivaramu 3 Internet-Draft Cisco Systems 4 Expires: October 15, 2006 J. Lingard 5 D. McWalter 6 Data Connection Ltd 7 B. Joshi 8 Infosys Technologies Ltd 9 April 13, 2006 11 Protocol Independent Multicast MIB 12 draft-ietf-pim-mib-v2-06.txt 14 Status of this Memo 16 By submitting this Internet-Draft, each author represents that any 17 applicable patent or other IPR claims of which he or she is aware 18 have been or will be disclosed, and any of which he or she becomes 19 aware will be disclosed, in accordance with Section 6 of BCP 79. 21 Internet-Drafts are working documents of the Internet Engineering 22 Task Force (IETF), its areas, and its working groups. Note that 23 other groups may also distribute working documents as Internet- 24 Drafts. 26 Internet-Drafts are draft documents valid for a maximum of six months 27 and may be updated, replaced, or obsoleted by other documents at any 28 time. It is inappropriate to use Internet-Drafts as reference 29 material or to cite them other than as "work in progress." 31 The list of current Internet-Drafts can be accessed at 32 http://www.ietf.org/ietf/1id-abstracts.txt. 34 The list of Internet-Draft Shadow Directories can be accessed at 35 http://www.ietf.org/shadow.html. 37 This Internet-Draft will expire on October 15, 2006. 39 Copyright Notice 41 Copyright (C) The Internet Society (2006). 43 Abstract 45 This memo defines a portion of the Management Information Base (MIB) 46 for use with network management protocols in the Internet community. 47 In particular, it describes managed objects used for managing the 48 Protocol Independent Multicast (PIM) protocols (PIM-SM and BIDIR- 49 PIM). This document is part of work in progress to obsolete RFC 50 2934, and is to be preferred where the two documents overlap. This 51 document does not obsolete RFC 2934. 53 Table of Contents 55 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 56 2. The Internet-Standard Management Framework . . . . . . . . . . 3 57 3. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 58 4. Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 5 59 5. Security Considerations . . . . . . . . . . . . . . . . . . . 76 60 6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 83 61 7. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 83 62 8. References . . . . . . . . . . . . . . . . . . . . . . . . . . 83 63 8.1 Normative References . . . . . . . . . . . . . . . . . . . 83 64 8.2 Informative References . . . . . . . . . . . . . . . . . . 84 65 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . 85 66 Intellectual Property and Copyright Statements . . . . . . . . 86 68 1. Introduction 70 This memo defines a portion of the Management Information Base (MIB) 71 for use with network management protocols in the Internet community. 72 In particular, it describes managed objects used for managing the 73 Protocol Independent Multicast (PIM) protocols (PIM-SM [I-D.ietf-pim- 74 sm-v2-new] and BIDIR-PIM [I-D.ietf-pim-bidir]). 76 This document is part of work in progress to obsolete RFC 2934 77 [RFC2934]. RFC 2934 defined an experimental MIB module for managing 78 the PIM protocols. The MIB module defined by this document is a re- 79 working of the MIB module from RFC 2934, with major changes that 80 include the following. 82 o This MIB module is independent of IP version, whereas RFC 2934 83 only supported IPv4. 85 o This MIB module includes support for managing BIDIR-PIM. 87 o This MIB module retains limited support for managing PIM-DM 88 [RFC3973], but that is no longer its primary purpose. 90 o This MIB module does not include support for managing PIM-SM v1. 92 o This MIB module does not depend on the IPv4 Multicast Routing MIB 93 defined in RFC 2932 [RFC2932]. 95 o This MIB module includes support for configuring static RPs. 97 o This MIB module includes support for configuring anycast RPs 98 [I-D.ietf-pim-anycast-rp]>. 100 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", 101 "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this 102 document are to be interpreted as described in RFC 2119 [RFC2119]. 104 2. The Internet-Standard Management Framework 106 For a detailed overview of the documents that describe the current 107 Internet-Standard Management Framework, please refer to section 7 of 108 RFC 3410 [RFC3410]. 110 Managed objects are accessed via a virtual information store, termed 111 the Management Information Base or MIB. MIB objects are generally 112 accessed through the Simple Network Management Protocol (SNMP). 113 Objects in the MIB are defined using the mechanisms defined in the 114 Structure of Management Information (SMI). This memo specifies a MIB 115 module that is compliant to the SMIv2, which is described in STD 58, 116 RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580 117 [RFC2580]. 119 3. Overview 121 This MIB module contains the following tables. 123 1. The PIM Interface Table, which contains one row per IP version 124 for each interface of the router which is running PIM. 126 2. The PIM Neighbor Table, which contains one row for each of the 127 router's PIM neighbors. 129 3. The PIM Neighbor Secondary Address Table, which contains one row 130 for each secondary address advertised by each of the router's 131 PIM neighbors. 133 4. The PIM (*,G) State Table, which contains one row for each group 134 for which PIM has (*,G) state. 136 5. The PIM (*,G,I) State Table, which contains one row for each 137 group and interface for which PIM has interface-specific (*,G) 138 state. 140 6. The PIM (S,G) State Table, which contains one row for each 141 source and group for which PIM has (S,G) state. 143 7. The PIM (S,G,I) State Table, which contains one row for each 144 source, group and interface for which PIM has interface-specific 145 (S,G) state. 147 8. The PIM (S,G,rpt) State Table, which contains one row for each 148 source and group for which PIM has (S,G,rpt) state. 150 9. The PIM (S,G,rpt,I) State Table, which contains one row for each 151 source, group and interface for which PIM has interface-specific 152 (S,G,rpt) state. 154 10. The PIM Bidir DF-Election Table, which contains one row per 155 interface for each Rendezvous Point (RP) for which 156 Bidirectional-PIM Designated Forwarder (DF) election state is 157 maintained. 159 11. The PIM Static RP Table, which contains one row per range of 160 multicast group addresses for which a particular configured RP 161 should be used. 163 12. The PIM Group Mapping Table, which contains one row for each 164 mapping from a multicast group address prefix to the PIM mode 165 and RP address to use for groups within that group prefix, 166 regardless of the source of the group mapping information. 168 13. The PIM Anycast-RP Set Table, which contains one row for each RP 169 within each Anycast-RP set of which the local router is a 170 member. 172 This MIB module uses textual conventions defined in the IF-MIB 173 [RFC2863], the INET-ADDRESS-MIB [RFC4001] and the IANA-RTPROTO-MIB. 175 4. Definitions 177 PIM-STD-MIB DEFINITIONS ::= BEGIN 179 IMPORTS 180 MODULE-IDENTITY, OBJECT-TYPE, mib-2, 181 NOTIFICATION-TYPE, Unsigned32, 182 Counter32, Gauge32, TimeTicks FROM SNMPv2-SMI 183 TEXTUAL-CONVENTION, 184 RowStatus, TruthValue FROM SNMPv2-TC 185 MODULE-COMPLIANCE, OBJECT-GROUP, 186 NOTIFICATION-GROUP FROM SNMPv2-CONF 187 InterfaceIndexOrZero, 188 InterfaceIndex FROM IF-MIB 189 InetAddressType, 190 InetAddressPrefixLength, 191 InetAddress, InetVersion FROM INET-ADDRESS-MIB 192 IANAipRouteProtocol FROM IANA-RTPROTO-MIB; 194 pimStdMIB MODULE-IDENTITY 195 LAST-UPDATED "200604130000Z" -- 13 April 2006 196 ORGANIZATION "IETF PIM Working Group" 197 CONTACT-INFO 198 "Email: pim@ietf.org" 199 DESCRIPTION 200 "The MIB module for management of PIM routers. 202 Copyright (C) The Internet Society (2005). This version of 203 this MIB module is part of RFC yyyy; see the RFC itself for 204 full legal notices." 205 -- RFC Ed.: replace yyyy with actual RFC number & remove this note 206 REVISION "200604130000Z" -- 13 April 2006 207 DESCRIPTION "Initial version, published as RFC yyyy." 208 -- RFC Ed.: replace yyyy with actual RFC number & remove this note 209 ::= { mib-2 XXX } 210 -- RFC Ed.: replace XXX with IANA-assigned number & remove this note 211 -- 212 -- Textual Conventions 213 -- 215 PimMode ::= TEXTUAL-CONVENTION 216 STATUS current 217 DESCRIPTION 218 "The PIM mode in which a group is operating. 220 none(1) The group is not using PIM, which may be the 221 case if, for example, it is a link-local or 222 unroutable group address. 224 ssm(2) Source-Specific Multicast (SSM) with PIM Sparse 225 Mode. 227 asm(3) Any Source Multicast (ASM), with PIM Sparse 228 Mode. 230 bidir(4) Bi-directional PIM. 232 dm(5) PIM Dense Mode. 234 other(6) Any other PIM mode." 236 SYNTAX INTEGER { 237 none(1), 238 ssm(2), 239 asm(3), 240 bidir(4), 241 dm(5), 242 other(6) 243 } 245 PimGroupMappingOriginType ::= TEXTUAL-CONVENTION 246 STATUS current 247 DESCRIPTION 248 "The mechanism by which a PIM group mapping was learned. 250 fixed(1) Link-local or unroutable group mappings. 252 configRp(2) Local static RP configuration. 254 configSsm(3) Local SSM Group configuration. 256 bsr(4) The PIM Bootstrap Router (BSR) mechanism. 258 autoRP(5) Cisco's Auto-RP mechanism. 260 embedded(6) The Embedded-RP mechanism where the RP address 261 is embedded in the multicast group address. 263 other(7) Any other mechanism." 265 REFERENCE "RFC 3956, I-D.ietf-pim-sm-bsr" 266 SYNTAX INTEGER { 267 fixed(1), 268 configRp(2), 269 configSsm(3), 270 bsr(4), 271 autoRP(5), 272 embedded(6), 273 other(7) 274 } 276 -- 277 -- Top-level structure 278 -- 280 pimMIBObjects OBJECT IDENTIFIER ::= { pimStdMIB 1 } 281 pimTraps OBJECT IDENTIFIER ::= { pimMIBObjects 0 } 282 pim OBJECT IDENTIFIER ::= { pimMIBObjects 1 } 284 pimKeepalivePeriod OBJECT-TYPE 285 SYNTAX Unsigned32 (0..65535) 286 UNITS "seconds" 287 MAX-ACCESS read-write 288 STATUS current 289 DESCRIPTION 290 "The duration of the Keepalive Timer. This is the period 291 during which the PIM router will maintain (S,G) state in the 292 absence of explicit (S,G) local membership or (S,G) join 293 messages received to maintain it. This timer period is 294 called the Keepalive_Period in the PIM-SM specification. It 295 is called the SourceLifetime in the PIM-DM specification." 296 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.11" 297 DEFVAL { 210 } 298 ::= { pim 14 } 300 pimRegisterSuppressionTime OBJECT-TYPE 301 SYNTAX Unsigned32 (0..65535) 302 UNITS "seconds" 303 MAX-ACCESS read-write 304 STATUS current 305 DESCRIPTION 306 "The duration of the Register Suppression Timer. This is 307 the period during which a PIM Designated Router (DR) stops 308 sending Register-encapsulated data to the Rendezvous Point 309 (RP) after receiving a Register-Stop message. This object 310 is used to run timers both at the DR and at the RP. This 311 timer period is called the Register_Suppression_Time in the 312 PIM-SM specification." 313 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.11" 314 DEFVAL { 60 } 315 ::= { pim 15 } 317 pimStarGEntries OBJECT-TYPE 318 SYNTAX Gauge32 319 MAX-ACCESS read-only 320 STATUS current 321 DESCRIPTION 322 "The number of entries in the pimStarGTable." 323 ::= { pim 16 } 325 pimStarGIEntries OBJECT-TYPE 326 SYNTAX Gauge32 327 MAX-ACCESS read-only 328 STATUS current 329 DESCRIPTION 330 "The number of entries in the pimStarGITable." 331 ::= { pim 17 } 333 pimSGEntries OBJECT-TYPE 334 SYNTAX Gauge32 335 MAX-ACCESS read-only 336 STATUS current 337 DESCRIPTION 338 "The number of entries in the pimSGTable." 339 ::= { pim 18 } 341 pimSGIEntries OBJECT-TYPE 342 SYNTAX Gauge32 343 MAX-ACCESS read-only 344 STATUS current 345 DESCRIPTION 346 "The number of entries in the pimSGITable." 347 ::= { pim 19 } 349 pimSGRptEntries OBJECT-TYPE 350 SYNTAX Gauge32 351 MAX-ACCESS read-only 352 STATUS current 353 DESCRIPTION 354 "The number of entries in the pimSGRptTable." 355 ::= { pim 20 } 357 pimSGRptIEntries OBJECT-TYPE 358 SYNTAX Gauge32 359 MAX-ACCESS read-only 360 STATUS current 361 DESCRIPTION 362 "The number of entries in the pimSGRptITable." 363 ::= { pim 21 } 365 pimOutAsserts OBJECT-TYPE 366 SYNTAX Counter32 367 MAX-ACCESS read-only 368 STATUS current 369 DESCRIPTION 370 "The number of Asserts sent by this router." 371 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.6" 372 ::= { pim 22 } 374 pimInAsserts OBJECT-TYPE 375 SYNTAX Counter32 376 MAX-ACCESS read-only 377 STATUS current 378 DESCRIPTION 379 "The number of Asserts received by this router. Asserts 380 are multicast to all routers on a network. This counter is 381 incremented by all routers that receive an assert, not only 382 those routers that are contesting the assert." 383 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.6" 384 ::= { pim 23 } 386 pimLastAssertInterface OBJECT-TYPE 387 SYNTAX InterfaceIndexOrZero 388 MAX-ACCESS read-only 389 STATUS current 390 DESCRIPTION 391 "The interface on which this router most recently sent or 392 received an assert, or zero if this router has not sent or 393 received an assert." 394 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.6" 395 ::= { pim 24 } 397 pimLastAssertGroupAddressType OBJECT-TYPE 398 SYNTAX InetAddressType 399 MAX-ACCESS read-only 400 STATUS current 401 DESCRIPTION 402 "The address type of the multicast group address in the most 403 recently sent or received assert. If this router has not 404 sent or received an assert then this object is set to 405 unknown(0)." 406 ::= { pim 25 } 408 pimLastAssertGroupAddress OBJECT-TYPE 409 SYNTAX InetAddress (SIZE (0|4|8|16|20)) 410 MAX-ACCESS read-only 411 STATUS current 412 DESCRIPTION 413 "The multicast group address in the most recently sent or 414 received assert. The InetAddressType is given by the 415 pimLastAssertGroupAddressType object." 416 ::= { pim 26 } 418 pimLastAssertSourceAddressType OBJECT-TYPE 419 SYNTAX InetAddressType 420 MAX-ACCESS read-only 421 STATUS current 422 DESCRIPTION 423 "The address type of the multicast source address in the 424 most recently sent or received assert. If the most recent 425 assert was (*,G), or if this router has not sent or received 426 an assert, then this object is set to unknown(0)." 427 ::= { pim 27 } 429 pimLastAssertSourceAddress OBJECT-TYPE 430 SYNTAX InetAddress (SIZE (0|4|8|16|20)) 431 MAX-ACCESS read-only 432 STATUS current 433 DESCRIPTION 434 "The multicast source address in the most recently sent or 435 received assert. The InetAddressType is given by the 436 pimLastAssertSourceAddressType object." 437 ::= { pim 28 } 439 pimNeighborLossTrapPeriod OBJECT-TYPE 440 SYNTAX Unsigned32 (0..65535) 441 UNITS "seconds" 442 MAX-ACCESS read-write 443 STATUS current 444 DESCRIPTION 445 "The minimum time that must elapse between pimNeighborLoss 446 traps originated by this router. The maximum value 65535 447 represents an 'infinite' time, in which case no 448 pimNeighborLoss traps are ever sent." 449 DEFVAL { 0 } 450 ::= { pim 29 } 452 pimNeighborLossCount OBJECT-TYPE 453 SYNTAX Counter32 454 MAX-ACCESS read-only 455 STATUS current 456 DESCRIPTION 457 "The number of neighbor loss events that have occurred. 459 This count is incremented when the neighbor timer expires, 460 and the router has no other neighbors on the same interface 461 with the same IP version and a lower IP address than itself. 463 This counter is incremented whenever a pimNeighborLoss trap 464 would be generated." 465 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.3.2" 466 ::= { pim 30 } 468 pimInvalidRegisterTrapPeriod OBJECT-TYPE 469 SYNTAX Unsigned32 (10..65535) 470 UNITS "seconds" 471 MAX-ACCESS read-write 472 STATUS current 473 DESCRIPTION 474 "The minimum time that must elapse between 475 pimInvalidRegister traps originated by this router. The 476 default value of 65535 represents an 'infinite' time, in 477 which case no pimInvalidRegister traps are ever sent. 479 The non-zero minimum allowed value provides resilience 480 against propagation of denial-of-service attacks from the 481 data and control planes to the network management plane." 482 DEFVAL { 65535 } 483 ::= { pim 31 } 485 pimInvalidRegisterMsgsRcvd OBJECT-TYPE 486 SYNTAX Counter32 487 MAX-ACCESS read-only 488 STATUS current 489 DESCRIPTION 490 "The number of invalid PIM Register messages that have been 491 received by this device. 493 A PIM Register message is invalid if either 495 o the destination address of the Register message does not 496 match the Group to RP mapping on this device, or 498 o this device believes the group address to be within an 499 SSM address range, but this Register implies ASM usage. 501 These conditions can occur transiently while RP mapping 502 changes propagate through the network. If this counter is 503 incremented repeatedly over several minutes, then there is a 504 persisting configuration error that requires correction. 506 The active Group to RP mapping on this device is specified 507 by the object pimGroupMappingPimMode. If there is no such 508 mapping, then the object pimGroupMappingPimMode is absent. 509 The RP address contained in the invalid Register is 510 pimInvalidRegisterRp. 512 Multicast data carried by invalid Register messages is 513 discarded. The discarded data is from a source directly 514 connected to pimInvalidRegisterOrigin, and is addressed to 515 pimInvalidRegisterGroup." 516 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.4.2" 517 ::= { pim 32 } 519 pimInvalidRegisterAddressType OBJECT-TYPE 520 SYNTAX InetAddressType 521 MAX-ACCESS read-only 522 STATUS current 523 DESCRIPTION 524 "The address type stored in pimInvalidRegisterOrigin, 525 pimInvalidRegisterGroup and pimInvalidRegisterRp. 527 If no unexpected Register messages have been received, then 528 this object is set to unknown(0)." 529 ::= { pim 33 } 531 pimInvalidRegisterOrigin OBJECT-TYPE 532 SYNTAX InetAddress (SIZE (0|4|8|16|20)) 533 MAX-ACCESS read-only 534 STATUS current 535 DESCRIPTION 536 "The source address of the last unexpected Register message 537 received by this device." 538 ::= { pim 34 } 540 pimInvalidRegisterGroup OBJECT-TYPE 541 SYNTAX InetAddress (SIZE (0|4|8|16|20)) 542 MAX-ACCESS read-only 543 STATUS current 544 DESCRIPTION 545 "The IP multicast group address to which the last unexpected 546 Register message received by this device was addressed." 547 ::= { pim 35 } 549 pimInvalidRegisterRp OBJECT-TYPE 550 SYNTAX InetAddress (SIZE (0|4|8|16|20)) 551 MAX-ACCESS read-only 552 STATUS current 553 DESCRIPTION 554 "The RP address to which the last unexpected Register 555 message received by this device was delivered." 556 ::= { pim 36 } 558 pimInvalidJoinPruneTrapPeriod OBJECT-TYPE 559 SYNTAX Unsigned32 (10..65535) 560 UNITS "seconds" 561 MAX-ACCESS read-write 562 STATUS current 563 DESCRIPTION 564 "The minimum time that must elapse between 565 pimInvalidJoinPrune traps originated by this router. The 566 default value of 65535 represents an 'infinite' time, in 567 which case no pimInvalidJoinPrune traps are ever sent. 569 The non-zero minimum allowed value provides resilience 570 against propagation of denial-of-service attacks from the 571 control plane to the network management plane." 572 DEFVAL { 65535 } 573 ::= { pim 37 } 575 pimInvalidJoinPruneMsgsRcvd OBJECT-TYPE 576 SYNTAX Counter32 577 MAX-ACCESS read-only 578 STATUS current 579 DESCRIPTION 580 "The number of invalid PIM Join/Prune messages that have 581 been received by this device. 583 A PIM Join/Prune message is invalid if either 585 o the Group to RP mapping specified by this message does not 586 match the Group to RP mapping on this device, or 588 o this device believes the group address to be within an 589 SSM address range, but this Join/Prune (*,G) or (S,G,rpt) 590 implies ASM usage. 592 These conditions can occur transiently while RP mapping 593 changes propagate through the network. If this counter is 594 incremented repeatedly over several minutes, then there is a 595 persisting configuration error that requires correction. 597 The active Group to RP mapping on this device is specified 598 by the object pimGroupMappingPimMode. If there is no such 599 mapping, then the object pimGroupMappingPimMode is absent. 600 The RP address contained in the invalid Join/Prune is 601 pimInvalidJoinPruneRp. 603 Invalid Join/Prune messages are discarded. This may result 604 in loss of multicast data affecting listeners downstream of 605 pimInvalidJoinPruneOrigin, for multicast data addressed to 606 pimInvalidJoinPruneGroup." 607 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.5.2" 608 ::= { pim 38 } 610 pimInvalidJoinPruneAddressType OBJECT-TYPE 611 SYNTAX InetAddressType 612 MAX-ACCESS read-only 613 STATUS current 614 DESCRIPTION 615 "The address type stored in pimInvalidJoinPruneOrigin, 616 pimInvalidJoinPruneGroup and pimInvalidJoinPruneRp. 618 If no unexpected Join/Prune messages have been received, 619 this object is set to unknown(0)." 620 ::= { pim 39 } 622 pimInvalidJoinPruneOrigin OBJECT-TYPE 623 SYNTAX InetAddress (SIZE (0|4|8|16|20)) 624 MAX-ACCESS read-only 625 STATUS current 626 DESCRIPTION 627 "The source address of the last unexpected Join/Prune 628 message received by this device." 629 ::= { pim 40 } 631 pimInvalidJoinPruneGroup OBJECT-TYPE 632 SYNTAX InetAddress (SIZE (0|4|8|16|20)) 633 MAX-ACCESS read-only 634 STATUS current 635 DESCRIPTION 636 "The IP multicast group address carried in the last 637 unexpected Join/Prune message received by this device." 638 ::= { pim 41 } 640 pimInvalidJoinPruneRp OBJECT-TYPE 641 SYNTAX InetAddress (SIZE (0|4|8|16|20)) 642 MAX-ACCESS read-only 643 STATUS current 644 DESCRIPTION 645 "The RP address carried in the last unexpected Join/Prune 646 message received by this device." 647 ::= { pim 42 } 649 pimRPMappingTrapPeriod OBJECT-TYPE 650 SYNTAX Unsigned32 (0..65535) 651 UNITS "seconds" 652 MAX-ACCESS read-write 653 STATUS current 654 DESCRIPTION 655 "The minimum time that must elapse between 656 pimRPMappingChange traps originated by this router. The 657 default value of 65535 represents an 'infinite' time, in 658 which case no pimRPMappingChange traps are ever sent." 659 DEFVAL { 65535 } 660 ::= { pim 43 } 662 pimRPMappingChangeCount OBJECT-TYPE 663 SYNTAX Counter32 664 MAX-ACCESS read-only 665 STATUS current 666 DESCRIPTION 667 "The number of changes to active RP mappings on this device. 669 Information about active RP mappings is available in 670 pimGroupMappingTable. Only changes to active mappings cause 671 this count to be incremented. That is, changes that modify 672 the pimGroupMappingEntry with the highest precedence for a 673 group (lowest value of pimGroupMappingPrecedence). 675 Such changes may result from manual configuration of this 676 device, or from automatic RP mapping discovery methods 677 including the PIM Bootstrap Router (BSR) mechanism." 678 REFERENCE "I-D.ietf-pim-sm-bsr" 679 ::= { pim 44 } 681 pimInterfaceElectionTrapPeriod OBJECT-TYPE 682 SYNTAX Unsigned32 (0..65535) 683 UNITS "seconds" 684 MAX-ACCESS read-write 685 STATUS current 686 DESCRIPTION 687 "The minimum time that must elapse between 688 pimInterfaceElection traps originated by this router. The 689 default value of 65535 represents an 'infinite' time, in 690 which case no pimInterfaceElection traps are ever sent." 691 DEFVAL { 65535 } 692 ::= { pim 45 } 694 pimInterfaceElectionWinCount OBJECT-TYPE 695 SYNTAX Counter32 696 MAX-ACCESS read-only 697 STATUS current 698 DESCRIPTION 699 "The number of times this device has been elected DR or DF 700 on any interface. 702 Elections occur frequently on newly-active interfaces, as 703 triggered Hellos establish adjacencies. This counter is not 704 incremented for elections on an interface until the first 705 periodic Hello has been sent. If this router is the DR or 706 DF at the time of sending the first periodic Hello after 707 interface activation, then this counter is incremented 708 (once) at that time." 709 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.3.2 and 710 I-D.ietf-pim-bidir section 3.5.2" 711 ::= { pim 46 } 713 pimRefreshInterval OBJECT-TYPE 714 SYNTAX Unsigned32 (0..65535) 715 UNITS "seconds" 716 MAX-ACCESS read-write 717 STATUS current 718 DESCRIPTION 719 "The interval between successive State Refresh messages sent 720 by an Originator. This timer period is called the 721 RefreshInterval in the PIM-DM specification. This object is 722 used only by PIM-DM." 723 REFERENCE "RFC 3973 section 4.8" 724 DEFVAL { 60 } 725 ::= { pim 47 } 727 -- 728 -- The PIM Interface Table 729 -- 731 pimInterfaceTable OBJECT-TYPE 732 SYNTAX SEQUENCE OF PimInterfaceEntry 733 MAX-ACCESS not-accessible 734 STATUS current 735 DESCRIPTION 736 "The (conceptual) table listing the router's PIM interfaces. 737 PIM is enabled on all interfaces listed in this table." 738 ::= { pim 1 } 740 pimInterfaceEntry OBJECT-TYPE 741 SYNTAX PimInterfaceEntry 742 MAX-ACCESS not-accessible 743 STATUS current 744 DESCRIPTION 745 "An entry (conceptual row) in the pimInterfaceTable. This 746 entry is preserved on agent restart." 747 INDEX { pimInterfaceIfIndex, 748 pimInterfaceIPVersion } 749 ::= { pimInterfaceTable 1 } 751 PimInterfaceEntry ::= SEQUENCE { 752 pimInterfaceIfIndex InterfaceIndex, 753 pimInterfaceIPVersion InetVersion, 754 pimInterfaceAddressType InetAddressType, 755 pimInterfaceAddress InetAddress, 756 pimInterfaceDR InetAddress, 757 pimInterfaceHelloInterval Unsigned32, 758 pimInterfaceTrigHelloInterval Unsigned32, 759 pimInterfaceJoinPruneInterval Unsigned32, 760 pimInterfaceDFElectionRobustness Unsigned32, 761 pimInterfaceHelloHoldtime Unsigned32, 762 pimInterfaceJoinPruneHoldtime Unsigned32, 763 pimInterfacePropagationDelay Unsigned32, 764 pimInterfaceOverrideInterval Unsigned32, 765 pimInterfaceGenerationIDValue Unsigned32, 766 pimInterfaceDRPriority Unsigned32, 767 pimInterfaceLanDelayEnabled TruthValue, 768 pimInterfaceEffectPropagDelay Unsigned32, 769 pimInterfaceEffectOverrideIvl Unsigned32, 770 pimInterfaceSuppressionEnabled TruthValue, 771 pimInterfaceBidirCapable TruthValue, 772 pimInterfaceDRPriorityEnabled TruthValue, 773 pimInterfaceDomainBorder TruthValue, 774 pimInterfaceStatus RowStatus, 775 pimInterfaceStubInterface TruthValue, 776 pimInterfacePruneLimitInterval Unsigned32, 777 pimInterfaceGraftRetryInterval Unsigned32, 778 pimInterfaceSRPriorityEnabled TruthValue 779 } 781 pimInterfaceIfIndex OBJECT-TYPE 782 SYNTAX InterfaceIndex 783 MAX-ACCESS not-accessible 784 STATUS current 785 DESCRIPTION 786 "The ifIndex value of this PIM interface." 787 ::= { pimInterfaceEntry 1 } 789 pimInterfaceIPVersion OBJECT-TYPE 790 SYNTAX InetVersion 791 MAX-ACCESS not-accessible 792 STATUS current 793 DESCRIPTION 794 "The IP version of this PIM interface. A physical interface 795 may be configured in multiple modes concurrently, e.g. IPv4 796 and IPv6, however the traffic is considered to be logically 797 separate." 798 ::= { pimInterfaceEntry 2 } 800 pimInterfaceAddressType OBJECT-TYPE 801 SYNTAX InetAddressType 802 MAX-ACCESS read-only 803 STATUS current 804 DESCRIPTION 805 "The address type of this PIM interface." 806 ::= { pimInterfaceEntry 3 } 808 pimInterfaceAddress OBJECT-TYPE 809 SYNTAX InetAddress (SIZE (4|8|16|20)) 810 MAX-ACCESS read-only 811 STATUS current 812 DESCRIPTION 813 "The primary IP address of this router on this PIM 814 interface. The InetAddressType is given by the 815 pimInterfaceAddressType object." 816 ::= { pimInterfaceEntry 4 } 818 pimInterfaceDR OBJECT-TYPE 819 SYNTAX InetAddress (SIZE (4|8|16|20)) 820 MAX-ACCESS read-only 821 STATUS current 822 DESCRIPTION 823 "The primary IP address of the Designated Router on this PIM 824 interface. The InetAddressType is given by the 825 pimInterfaceAddressType object." 826 ::= { pimInterfaceEntry 5 } 828 pimInterfaceHelloInterval OBJECT-TYPE 829 SYNTAX Unsigned32 (0..18000) 830 UNITS "seconds" 831 MAX-ACCESS read-create 832 STATUS current 833 DESCRIPTION 834 "The frequency at which PIM Hello messages are transmitted 835 on this interface. This object corresponds to the 836 'Hello_Period' timer value defined in the PIM-SM 837 specification. A value of zero represents an 'infinite' 838 interval, and indicates that periodic PIM Hello messages 839 should not be sent on this interface." 840 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.11" 841 DEFVAL { 30 } 842 ::= { pimInterfaceEntry 6 } 844 pimInterfaceTrigHelloInterval OBJECT-TYPE 845 SYNTAX Unsigned32 (0..60) 846 UNITS "seconds" 847 MAX-ACCESS read-create 848 STATUS current 849 DESCRIPTION 850 "The maximum time before this router sends a triggered PIM 851 Hello message on this interface. This object corresponds to 852 the 'Trigered_Hello_Delay' timer value defined in the PIM-SM 853 specification. A value of zero has no special meaning and 854 indicates that triggered PIM Hello messages should always be 855 sent immediately." 856 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.11" 857 DEFVAL { 5 } 858 ::= { pimInterfaceEntry 7 } 860 pimInterfaceJoinPruneInterval OBJECT-TYPE 861 SYNTAX Unsigned32 (0..18000) 862 UNITS "seconds" 863 MAX-ACCESS read-create 864 STATUS current 865 DESCRIPTION 866 "The frequency at which this router sends PIM Join/Prune 867 messages on this PIM interface. This object corresponds to 868 the 't_periodic' timer value defined in the PIM-SM 869 specification. A value of zero represents an 'infinite' 870 interval, and indicates that periodic PIM Join/Prune 871 messages should not be sent on this interface." 872 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.11" 873 DEFVAL { 60 } 874 ::= { pimInterfaceEntry 8 } 876 pimInterfaceDFElectionRobustness OBJECT-TYPE 877 SYNTAX Unsigned32 878 MAX-ACCESS read-create 879 STATUS current 880 DESCRIPTION 881 "The minimum number of PIM DF-Election messages that must be 882 lost in order for DF election on this interface to fail." 883 DEFVAL { 3 } 884 ::= { pimInterfaceEntry 9 } 886 pimInterfaceHelloHoldtime OBJECT-TYPE 887 SYNTAX Unsigned32 (0..65535) 888 UNITS "seconds" 889 MAX-ACCESS read-create 890 STATUS current 891 DESCRIPTION 892 "The value set in the Holdtime field of PIM Hello messages 893 transmitted on this interface. A value of 65535 represents 894 an 'infinite' holdtime. Implementations are recommended 895 to use a holdtime that is 3.5 times the value of 896 pimInterfaceHelloInterval, or 65535 if 897 pimInterfaceHelloInterval is set to zero." 898 DEFVAL { 105 } 899 ::= { pimInterfaceEntry 10 } 901 pimInterfaceJoinPruneHoldtime OBJECT-TYPE 902 SYNTAX Unsigned32 (0..65535) 903 UNITS "seconds" 904 MAX-ACCESS read-create 905 STATUS current 906 DESCRIPTION 907 "The value inserted into the Holdtime field of a PIM 908 Join/Prune message sent on this interface. A value of 65535 909 represents an 'infinite' holdtime. Implementations are 910 recommended to use a holdtime that is 3.5 times the value of 911 pimInterfaceJoinPruneInterval, or 65535 if 912 pimInterfaceJoinPruneInterval is set to zero. PIM-DM 913 implementations are recommended to use the value of 914 pimInterfacePruneLimitInterval." 915 DEFVAL { 210 } 916 ::= { pimInterfaceEntry 11 } 918 pimInterfacePropagationDelay OBJECT-TYPE 919 SYNTAX Unsigned32 (0..32767) 920 UNITS "milliseconds" 921 MAX-ACCESS read-create 922 STATUS current 923 DESCRIPTION 924 "The expected propagation delay between PIM routers on this 925 network or link. 927 This router inserts this value into the Propagation_Delay 928 field of the LAN Prune Delay option in the PIM Hello 929 messages sent on this interface. Implementations should 930 enforce a lower bound on the permitted values for this 931 object to allow for scheduling and processing delays within 932 the local router." 933 DEFVAL { 500 } 934 ::= { pimInterfaceEntry 12 } 936 pimInterfaceOverrideInterval OBJECT-TYPE 937 SYNTAX Unsigned32 (0..65535) 938 UNITS "milliseconds" 939 MAX-ACCESS read-create 940 STATUS current 941 DESCRIPTION 942 "The value this router inserts into the Override_Interval 943 field of the LAN Prune Delay option in the PIM Hello 944 messages it sends on this interface. 946 When overriding a prune, PIM routers pick a random timer 947 duration up to the value of this object. The more PIM 948 routers that are active on a network, the more likely it is 949 that the prune will be overridden after a small proportion 950 of this time has elapsed. 952 The more PIM routers are active on this network, the larger 953 this object should be to obtain an optimal spread of prune 954 override latencies." 955 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.3.3" 956 DEFVAL { 2500 } 957 ::= { pimInterfaceEntry 13 } 959 pimInterfaceGenerationIDValue OBJECT-TYPE 960 SYNTAX Unsigned32 961 MAX-ACCESS read-only 962 STATUS current 963 DESCRIPTION 964 "The value of the Generation ID this router inserted in the 965 last PIM Hello message it sent on this interface." 966 ::= { pimInterfaceEntry 14 } 968 pimInterfaceDRPriority OBJECT-TYPE 969 SYNTAX Unsigned32 970 MAX-ACCESS read-create 971 STATUS current 972 DESCRIPTION 973 "The Designated Router Priority value inserted into the DR 974 Priority option on this interface. Numerically higher 975 values for this object indicate higher priorities." 976 DEFVAL { 1 } 977 ::= { pimInterfaceEntry 15 } 979 pimInterfaceLanDelayEnabled OBJECT-TYPE 980 SYNTAX TruthValue 981 MAX-ACCESS read-only 982 STATUS current 983 DESCRIPTION 984 "Evaluates to TRUE if all routers on this interface are 985 using the LAN Prune Delay option." 986 ::= { pimInterfaceEntry 16 } 988 pimInterfaceEffectPropagDelay OBJECT-TYPE 989 SYNTAX Unsigned32 (0..32767) 990 UNITS "milliseconds" 991 MAX-ACCESS read-only 992 STATUS current 993 DESCRIPTION 994 "The Effective Propagation Delay on this interface. This 995 object is always 500 if pimInterfaceLanDelayEnabled is 996 FALSE." 997 ::= { pimInterfaceEntry 17 } 999 pimInterfaceEffectOverrideIvl OBJECT-TYPE 1000 SYNTAX Unsigned32 (0..65535) 1001 UNITS "milliseconds" 1002 MAX-ACCESS read-only 1003 STATUS current 1004 DESCRIPTION 1005 "The Effective Override Interval on this interface. This 1006 object is always 2500 if pimInterfaceLanDelayEnabled is 1007 FALSE." 1008 ::= { pimInterfaceEntry 18 } 1010 pimInterfaceSuppressionEnabled OBJECT-TYPE 1011 SYNTAX TruthValue 1012 MAX-ACCESS read-only 1013 STATUS current 1014 DESCRIPTION 1015 "Whether join suppression is enabled on this interface. 1016 This object is always TRUE if pimInterfaceLanDelayEnabled is 1017 FALSE." 1018 ::= { pimInterfaceEntry 19 } 1020 pimInterfaceBidirCapable OBJECT-TYPE 1021 SYNTAX TruthValue 1022 MAX-ACCESS read-only 1023 STATUS current 1024 DESCRIPTION 1025 "Evaluates to TRUE if all routers on this interface are 1026 using the Bidirectional-PIM Capable option." 1027 ::= { pimInterfaceEntry 20 } 1029 pimInterfaceDRPriorityEnabled OBJECT-TYPE 1030 SYNTAX TruthValue 1031 MAX-ACCESS read-only 1032 STATUS current 1033 DESCRIPTION 1034 "Evaluates to TRUE if all routers on this interface are 1035 using the DR Priority option." 1036 ::= { pimInterfaceEntry 21 } 1038 pimInterfaceDomainBorder OBJECT-TYPE 1039 SYNTAX TruthValue 1040 MAX-ACCESS read-create 1041 STATUS current 1042 DESCRIPTION 1043 "Whether or not this interface is a PIM domain border. This 1044 includes acting as a border for PIM Bootstrap Router (BSR) 1045 messages, if the BSR mechanism is in use." 1046 DEFVAL { false } 1047 ::= { pimInterfaceEntry 22 } 1049 pimInterfaceStatus OBJECT-TYPE 1050 SYNTAX RowStatus 1051 MAX-ACCESS read-create 1052 STATUS current 1053 DESCRIPTION 1054 "The status of this entry. Creating the entry enables PIM 1055 on the interface; destroying the entry disables PIM on the 1056 interface. 1058 This status object can be set to active(1) without setting 1059 any other columnar objects in this entry. 1061 All writeable objects in this entry can be modified when the 1062 status of this entry is active(1)." 1063 ::= { pimInterfaceEntry 23 } 1065 pimInterfaceStubInterface OBJECT-TYPE 1066 SYNTAX TruthValue 1067 MAX-ACCESS read-create 1068 STATUS current 1069 DESCRIPTION 1070 "Whether this interface is a 'stub interface'. If this 1071 object is set to TRUE, then no PIM packets are sent out this 1072 interface, and any received PIM packets are ignored. 1074 Setting this object to TRUE is a security measure for 1075 interfaces towards untrusted hosts. This allows an 1076 interface to be configured for use with IGMP or MGMD, while 1077 also protecting the PIM router from forged PIM messages on 1078 the interface. 1080 To communicate with other PIM routers using this interface, 1081 this object must remain set to FALSE. 1083 Changing the value of this object while the interface is 1084 operational causes the interface to be deactivated and 1085 then reactivated." 1086 DEFVAL { false } 1087 ::= { pimInterfaceEntry 24 } 1089 pimInterfacePruneLimitInterval OBJECT-TYPE 1090 SYNTAX Unsigned32 (0..65535) 1091 UNITS "seconds" 1092 MAX-ACCESS read-create 1093 STATUS current 1094 DESCRIPTION 1095 "The minimum interval that must transpire between two 1096 successive Prunes sent by a router. This object corresponds 1097 to the 't_limit' timer value defined in the PIM-DM 1098 specification. This object is used only by PIM-DM." 1099 REFERENCE "RFC 3973 section 4.8" 1100 DEFVAL { 60 } 1101 ::= { pimInterfaceEntry 25 } 1103 pimInterfaceGraftRetryInterval OBJECT-TYPE 1104 SYNTAX Unsigned32 (0..65535) 1105 UNITS "seconds" 1106 MAX-ACCESS read-create 1107 STATUS current 1108 DESCRIPTION 1109 "The minimum interval that must transpire between two 1110 successive Grafts sent by a router. This object corresponds 1111 to the 'Graft_Retry_Period' timer value defined in the 1112 PIM-DM specification. This object is used only by PIM-DM." 1113 REFERENCE "RFC 3973 section 4.8" 1114 DEFVAL { 3 } 1115 ::= { pimInterfaceEntry 26 } 1117 pimInterfaceSRPriorityEnabled OBJECT-TYPE 1118 SYNTAX TruthValue 1119 MAX-ACCESS read-only 1120 STATUS current 1121 DESCRIPTION 1122 "Evaluates to TRUE if all routers on this interface are 1123 using the State Refresh option. This object is used only by 1124 PIM-DM." 1125 ::= { pimInterfaceEntry 27 } 1127 -- 1128 -- The PIM Neighbor Table 1129 -- 1131 pimNeighborTable OBJECT-TYPE 1132 SYNTAX SEQUENCE OF PimNeighborEntry 1133 MAX-ACCESS not-accessible 1134 STATUS current 1135 DESCRIPTION 1136 "The (conceptual) table listing the router's PIM neighbors." 1137 ::= { pim 2 } 1139 pimNeighborEntry OBJECT-TYPE 1140 SYNTAX PimNeighborEntry 1141 MAX-ACCESS not-accessible 1142 STATUS current 1143 DESCRIPTION 1144 "An entry (conceptual row) in the pimNeighborTable." 1145 INDEX { pimNeighborIfIndex, 1146 pimNeighborAddressType, 1147 pimNeighborAddress } 1148 ::= { pimNeighborTable 1 } 1150 PimNeighborEntry ::= SEQUENCE { 1151 pimNeighborIfIndex InterfaceIndex, 1152 pimNeighborAddressType InetAddressType, 1153 pimNeighborAddress InetAddress, 1154 pimNeighborUpTime TimeTicks, 1155 pimNeighborExpiryTime TimeTicks, 1156 pimNeighborLanPruneDelayPresent TruthValue, 1157 pimNeighborPropagationDelay Unsigned32, 1158 pimNeighborOverrideInterval Unsigned32, 1159 pimNeighborTBit TruthValue, 1160 pimNeighborGenerationIDPresent TruthValue, 1161 pimNeighborGenerationIDValue Unsigned32, 1162 pimNeighborBidirCapable TruthValue, 1163 pimNeighborDRPriorityPresent TruthValue, 1164 pimNeighborDRPriority Unsigned32, 1165 pimNeighborSRCapable TruthValue 1166 } 1168 pimNeighborIfIndex OBJECT-TYPE 1169 SYNTAX InterfaceIndex 1170 MAX-ACCESS not-accessible 1171 STATUS current 1172 DESCRIPTION 1173 "The value of ifIndex for the interface used to reach this 1174 PIM neighbor." 1176 ::= { pimNeighborEntry 1 } 1178 pimNeighborAddressType OBJECT-TYPE 1179 SYNTAX InetAddressType 1180 MAX-ACCESS not-accessible 1181 STATUS current 1182 DESCRIPTION 1183 "The address type of this PIM neighbor." 1184 ::= { pimNeighborEntry 2 } 1186 pimNeighborAddress OBJECT-TYPE 1187 SYNTAX InetAddress (SIZE (4|8|16|20)) 1188 MAX-ACCESS not-accessible 1189 STATUS current 1190 DESCRIPTION 1191 "The primary IP address of this PIM neighbor. The 1192 InetAddressType is given by the pimNeighborAddressType 1193 object." 1194 ::= { pimNeighborEntry 3 } 1196 pimNeighborUpTime OBJECT-TYPE 1197 SYNTAX TimeTicks 1198 MAX-ACCESS read-only 1199 STATUS current 1200 DESCRIPTION 1201 "The time since this PIM neighbor (last) became a neighbor 1202 of the local router." 1203 ::= { pimNeighborEntry 4 } 1205 pimNeighborExpiryTime OBJECT-TYPE 1206 SYNTAX TimeTicks 1207 MAX-ACCESS read-only 1208 STATUS current 1209 DESCRIPTION 1210 "The minimum time remaining before this PIM neighbor will 1211 be aged out. The value zero indicates that this PIM 1212 neighbor will never be aged out." 1213 ::= { pimNeighborEntry 5 } 1215 pimNeighborLanPruneDelayPresent OBJECT-TYPE 1216 SYNTAX TruthValue 1217 MAX-ACCESS read-only 1218 STATUS current 1219 DESCRIPTION 1220 "Evaluates to TRUE if this neighbor is using the LAN Prune 1221 Delay option." 1222 ::= { pimNeighborEntry 6 } 1224 pimNeighborPropagationDelay OBJECT-TYPE 1225 SYNTAX Unsigned32 (0..32767) 1226 MAX-ACCESS read-only 1227 STATUS current 1228 DESCRIPTION 1229 "The value of the Propagation_Delay field of the LAN Prune 1230 Delay option received from this neighbor. This object is 1231 always zero if pimNeighborLanPruneDelayPresent is FALSE." 1232 ::= { pimNeighborEntry 7 } 1234 pimNeighborOverrideInterval OBJECT-TYPE 1235 SYNTAX Unsigned32 (0..65535) 1236 MAX-ACCESS read-only 1237 STATUS current 1238 DESCRIPTION 1239 "The value of the Override_Interval field of the LAN Prune 1240 Delay option received from this neighbor. This object is 1241 always zero if pimNeighborLanPruneDelayPresent is FALSE." 1242 ::= { pimNeighborEntry 8 } 1244 pimNeighborTBit OBJECT-TYPE 1245 SYNTAX TruthValue 1246 MAX-ACCESS read-only 1247 STATUS current 1248 DESCRIPTION 1249 "Whether the T bit was set in the LAN Prune Delay option 1250 received from this neighbor. The T bit specifies the 1251 ability of the neighbor to disable join suppression. This 1252 object is always TRUE if pimNeighborLanPruneDelayPresent is 1253 FALSE." 1254 ::= { pimNeighborEntry 9 } 1256 pimNeighborGenerationIDPresent OBJECT-TYPE 1257 SYNTAX TruthValue 1258 MAX-ACCESS read-only 1259 STATUS current 1260 DESCRIPTION 1261 "Evaluates to TRUE if this neighbor is using the Generation 1262 ID option." 1263 ::= { pimNeighborEntry 10 } 1265 pimNeighborGenerationIDValue OBJECT-TYPE 1266 SYNTAX Unsigned32 1267 MAX-ACCESS read-only 1268 STATUS current 1269 DESCRIPTION 1270 "The value of the Generation ID from the last PIM Hello 1271 message received from this neighbor. This object is always 1272 zero if pimNeighborGenerationIDPresent is FALSE." 1273 ::= { pimNeighborEntry 11 } 1275 pimNeighborBidirCapable OBJECT-TYPE 1276 SYNTAX TruthValue 1277 MAX-ACCESS read-only 1278 STATUS current 1279 DESCRIPTION 1280 "Evaluates to TRUE if this neighbor is using the 1281 Bidirectional-PIM Capable option." 1282 ::= { pimNeighborEntry 12 } 1284 pimNeighborDRPriorityPresent OBJECT-TYPE 1285 SYNTAX TruthValue 1286 MAX-ACCESS read-only 1287 STATUS current 1288 DESCRIPTION 1289 "Evaluates to TRUE if this neighbor is using the DR Priority 1290 option." 1291 ::= { pimNeighborEntry 13 } 1293 pimNeighborDRPriority OBJECT-TYPE 1294 SYNTAX Unsigned32 1295 MAX-ACCESS read-only 1296 STATUS current 1297 DESCRIPTION 1298 "The value of the Designated Router Priority from the last 1299 PIM Hello message received from this neighbor. This object 1300 is always zero if pimNeighborDRPriorityPresent is FALSE." 1301 ::= { pimNeighborEntry 14 } 1303 pimNeighborSRCapable OBJECT-TYPE 1304 SYNTAX TruthValue 1305 MAX-ACCESS read-only 1306 STATUS current 1307 DESCRIPTION 1308 "Evaluates to TRUE if this neighbor is using the State 1309 Refresh Capable option. This object is used only by 1310 PIM-DM." 1311 ::= { pimNeighborEntry 15 } 1313 -- 1314 -- The PIM Neighbor Secondary Address Table 1315 -- 1317 pimNbrSecAddressTable OBJECT-TYPE 1318 SYNTAX SEQUENCE OF PimNbrSecAddressEntry 1319 MAX-ACCESS not-accessible 1320 STATUS current 1321 DESCRIPTION 1322 "The (conceptual) table listing the secondary addresses 1323 advertised by each PIM neighbor (on a subset of the rows of 1324 the pimNeighborTable defined above)." 1325 ::= { pim 3 } 1327 pimNbrSecAddressEntry OBJECT-TYPE 1328 SYNTAX PimNbrSecAddressEntry 1329 MAX-ACCESS not-accessible 1330 STATUS current 1331 DESCRIPTION 1332 "An entry (conceptual row) in the pimNbrSecAddressTable." 1333 INDEX { pimNbrSecAddressIfIndex, 1334 pimNbrSecAddressType, 1335 pimNbrSecAddressPrimary, 1336 pimNbrSecAddress } 1337 ::= { pimNbrSecAddressTable 1 } 1339 PimNbrSecAddressEntry ::= SEQUENCE { 1340 pimNbrSecAddressIfIndex InterfaceIndex, 1341 pimNbrSecAddressType InetAddressType, 1342 pimNbrSecAddressPrimary InetAddress, 1343 pimNbrSecAddress InetAddress 1344 } 1346 pimNbrSecAddressIfIndex OBJECT-TYPE 1347 SYNTAX InterfaceIndex 1348 MAX-ACCESS not-accessible 1349 STATUS current 1350 DESCRIPTION 1351 "The value of ifIndex for the interface used to reach this 1352 PIM neighbor." 1353 ::= { pimNbrSecAddressEntry 1 } 1355 pimNbrSecAddressType OBJECT-TYPE 1356 SYNTAX InetAddressType 1357 MAX-ACCESS not-accessible 1358 STATUS current 1359 DESCRIPTION 1360 "The address type of this PIM neighbor." 1361 ::= { pimNbrSecAddressEntry 2 } 1363 pimNbrSecAddressPrimary OBJECT-TYPE 1364 SYNTAX InetAddress (SIZE (4|8|16|20)) 1365 MAX-ACCESS not-accessible 1366 STATUS current 1367 DESCRIPTION 1368 "The primary IP address of this PIM neighbor. The 1369 InetAddressType is given by the pimNbrSecAddressType 1370 object." 1371 ::= { pimNbrSecAddressEntry 3 } 1373 pimNbrSecAddress OBJECT-TYPE 1374 SYNTAX InetAddress (SIZE (4|8|16|20)) 1375 MAX-ACCESS read-only 1376 STATUS current 1377 DESCRIPTION 1378 "The secondary IP address of this PIM neighbor. The 1379 InetAddressType is given by the pimNbrSecAddressType 1380 object." 1381 ::= { pimNbrSecAddressEntry 4 } 1383 -- 1384 -- The PIM (*,G) State Table 1385 -- 1387 pimStarGTable OBJECT-TYPE 1388 SYNTAX SEQUENCE OF PimStarGEntry 1389 MAX-ACCESS not-accessible 1390 STATUS current 1391 DESCRIPTION 1392 "The (conceptual) table listing the non-interface specific 1393 (*,G) state that PIM has." 1394 ::= { pim 4 } 1396 pimStarGEntry OBJECT-TYPE 1397 SYNTAX PimStarGEntry 1398 MAX-ACCESS not-accessible 1399 STATUS current 1400 DESCRIPTION 1401 "An entry (conceptual row) in the pimStarGTable." 1402 INDEX { pimStarGAddressType, 1403 pimStarGGrpAddress } 1404 ::= { pimStarGTable 1 } 1406 PimStarGEntry ::= SEQUENCE { 1407 pimStarGAddressType InetAddressType, 1408 pimStarGGrpAddress InetAddress, 1409 pimStarGUpTime TimeTicks, 1410 pimStarGPimMode PimMode, 1411 pimStarGRPAddressType InetAddressType, 1412 pimStarGRPAddress InetAddress, 1413 pimStarGPimModeOrigin PimGroupMappingOriginType, 1414 pimStarGRPIsLocal TruthValue, 1415 pimStarGUpstreamJoinState INTEGER, 1416 pimStarGUpstreamJoinTimer TimeTicks, 1417 pimStarGUpstreamNeighborType InetAddressType, 1418 pimStarGUpstreamNeighbor InetAddress, 1419 pimStarGRPFIfIndex InterfaceIndexOrZero, 1420 pimStarGRPFNextHopType InetAddressType, 1421 pimStarGRPFNextHop InetAddress, 1422 pimStarGRPFRouteProtocol IANAipRouteProtocol, 1423 pimStarGRPFRouteAddress InetAddress, 1424 pimStarGRPFRoutePrefixLength InetAddressPrefixLength, 1425 pimStarGRPFRouteMetricPref Unsigned32, 1426 pimStarGRPFRouteMetric Unsigned32 1427 } 1429 pimStarGAddressType OBJECT-TYPE 1430 SYNTAX InetAddressType 1431 MAX-ACCESS not-accessible 1432 STATUS current 1433 DESCRIPTION 1434 "The address type of this multicast group." 1435 ::= { pimStarGEntry 1 } 1437 pimStarGGrpAddress OBJECT-TYPE 1438 SYNTAX InetAddress (SIZE (4|8|16|20)) 1439 MAX-ACCESS not-accessible 1440 STATUS current 1441 DESCRIPTION 1442 "The multicast group address. The InetAddressType is given 1443 by the pimStarGAddressType object." 1444 ::= { pimStarGEntry 2 } 1446 pimStarGUpTime OBJECT-TYPE 1447 SYNTAX TimeTicks 1448 MAX-ACCESS read-only 1449 STATUS current 1450 DESCRIPTION 1451 "The time since this entry was created by the local router." 1452 ::= { pimStarGEntry 3 } 1454 pimStarGPimMode OBJECT-TYPE 1455 SYNTAX PimMode { asm(3), bidir(4) } 1456 MAX-ACCESS read-only 1457 STATUS current 1458 DESCRIPTION 1459 "Whether this entry represents an ASM (Any Source Multicast, 1460 used with PIM-SM) or BIDIR-PIM group." 1461 ::= { pimStarGEntry 4 } 1463 pimStarGRPAddressType OBJECT-TYPE 1464 SYNTAX InetAddressType 1465 MAX-ACCESS read-only 1466 STATUS current 1467 DESCRIPTION 1468 "The address type of the Rendezvous Point (RP), or 1469 unknown(0) if the RP address is unknown." 1470 ::= { pimStarGEntry 5 } 1472 pimStarGRPAddress OBJECT-TYPE 1473 SYNTAX InetAddress (SIZE (0|4|16|20)) 1474 MAX-ACCESS read-only 1475 STATUS current 1476 DESCRIPTION 1477 "The address of the Rendezvous Point (RP) for the group. 1478 The InetAddressType is given by the pimStarGRPAddressType." 1479 ::= { pimStarGEntry 6 } 1481 pimStarGPimModeOrigin OBJECT-TYPE 1482 SYNTAX PimGroupMappingOriginType 1483 MAX-ACCESS read-only 1484 STATUS current 1485 DESCRIPTION 1486 "The mechanism by which the PIM mode and RP for the group 1487 were learned." 1488 ::= { pimStarGEntry 7 } 1490 pimStarGRPIsLocal OBJECT-TYPE 1491 SYNTAX TruthValue 1492 MAX-ACCESS read-only 1493 STATUS current 1494 DESCRIPTION 1495 "Whether the local router is the RP for the group." 1496 ::= { pimStarGEntry 8 } 1498 pimStarGUpstreamJoinState OBJECT-TYPE 1499 SYNTAX INTEGER { 1500 notJoined (1), 1501 joined (2) 1502 } 1503 MAX-ACCESS read-only 1504 STATUS current 1505 DESCRIPTION 1506 "Whether the local router should join the RP tree for the 1507 group. This corresponds to the state of the upstream (*,G) 1508 state machine in the PIM-SM specification." 1509 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.5.6" 1510 ::= { pimStarGEntry 9 } 1512 pimStarGUpstreamJoinTimer OBJECT-TYPE 1513 SYNTAX TimeTicks 1514 MAX-ACCESS read-only 1515 STATUS current 1516 DESCRIPTION 1517 "The time remaining before the local router next sends a 1518 periodic (*,G) Join message on pimStarGRPFIfIndex. This 1519 timer is called the (*,G) Upstream Join Timer in the PIM-SM 1520 specification. This object is zero if the timer is not 1521 running." 1522 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.10" 1523 ::= { pimStarGEntry 10 } 1525 pimStarGUpstreamNeighborType OBJECT-TYPE 1526 SYNTAX InetAddressType 1527 MAX-ACCESS read-only 1528 STATUS current 1529 DESCRIPTION 1530 "The primary address type of the upstream neighbor, or 1531 unknown(0) if the upstream neighbor address is unknown or is 1532 not a PIM neighbor." 1533 ::= { pimStarGEntry 11 } 1535 pimStarGUpstreamNeighbor OBJECT-TYPE 1536 SYNTAX InetAddress (SIZE (0|4|16|20)) 1537 MAX-ACCESS read-only 1538 STATUS current 1539 DESCRIPTION 1540 "The primary address of the neighbor on pimStarGRPFIfIndex 1541 that the local router is sending periodic (*,G) Join 1542 messages to. The InetAddressType is given by the 1543 pimStarGUpstreamNeighborType object. This address is called 1544 RPF'(*,G) in the PIM-SM specification." 1545 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.1.6" 1546 ::= { pimStarGEntry 12 } 1548 pimStarGRPFIfIndex OBJECT-TYPE 1549 SYNTAX InterfaceIndexOrZero 1550 MAX-ACCESS read-only 1551 STATUS current 1552 DESCRIPTION 1553 "The value of ifIndex for the RPF interface towards the RP, 1554 or zero if the RPF interface is unknown." 1555 ::= { pimStarGEntry 13 } 1557 pimStarGRPFNextHopType OBJECT-TYPE 1558 SYNTAX InetAddressType 1559 MAX-ACCESS read-only 1560 STATUS current 1561 DESCRIPTION 1562 "The address type of the RPF next hop towards the RP, or 1563 unknown(0) if the RPF next hop is unknown." 1564 ::= { pimStarGEntry 14 } 1566 pimStarGRPFNextHop OBJECT-TYPE 1567 SYNTAX InetAddress (SIZE (0|4|16|20)) 1568 MAX-ACCESS read-only 1569 STATUS current 1570 DESCRIPTION 1571 "The address of the RPF next hop towards the RP. The 1572 InetAddressType is given by the pimStarGRPFNextHopType 1573 object. This address is called MRIB.next_hop(RP(G)) 1574 in the PIM-SM specification." 1575 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.5.5" 1576 ::= { pimStarGEntry 15 } 1578 pimStarGRPFRouteProtocol OBJECT-TYPE 1579 SYNTAX IANAipRouteProtocol 1580 MAX-ACCESS read-only 1581 STATUS current 1582 DESCRIPTION 1583 "The routing mechanism via which the route used to find the 1584 RPF interface towards the RP was learned." 1585 ::= { pimStarGEntry 16 } 1587 pimStarGRPFRouteAddress OBJECT-TYPE 1588 SYNTAX InetAddress (SIZE (0|4|16|20)) 1589 MAX-ACCESS read-only 1590 STATUS current 1591 DESCRIPTION 1592 "The IP address which when combined with the corresponding 1593 value of pimStarGRPFRoutePrefixLength identifies the route 1594 used to find the RPF interface towards the RP. The 1595 InetAddressType is given by the pimStarGRPFNextHopType 1596 object. 1598 This address object is only significant up to 1599 pimStarGRPFRoutePrefixLength bits. The remainder of the 1600 address bits are zero." 1601 ::= { pimStarGEntry 17 } 1603 pimStarGRPFRoutePrefixLength OBJECT-TYPE 1604 SYNTAX InetAddressPrefixLength 1605 MAX-ACCESS read-only 1606 STATUS current 1607 DESCRIPTION 1608 "The prefix length which when combined with the 1609 corresponding value of pimStarGRPFRouteAddress identifies 1610 the route used to find the RPF interface towards the RP. 1611 The InetAddressType is given by the pimStarGRPFNextHopType 1612 object." 1613 ::= { pimStarGEntry 18 } 1615 pimStarGRPFRouteMetricPref OBJECT-TYPE 1616 SYNTAX Unsigned32 (0..2147483647) 1617 MAX-ACCESS read-only 1618 STATUS current 1619 DESCRIPTION 1620 "The metric preference of the route used to find the RPF 1621 interface towards the RP." 1622 ::= { pimStarGEntry 19 } 1624 pimStarGRPFRouteMetric OBJECT-TYPE 1625 SYNTAX Unsigned32 1626 MAX-ACCESS read-only 1627 STATUS current 1628 DESCRIPTION 1629 "The routing metric of the route used to find the RPF 1630 interface towards the RP." 1631 ::= { pimStarGEntry 20 } 1633 -- 1634 -- The PIM (*,G,I) State Table 1635 -- 1637 pimStarGITable OBJECT-TYPE 1638 SYNTAX SEQUENCE OF PimStarGIEntry 1639 MAX-ACCESS not-accessible 1640 STATUS current 1641 DESCRIPTION 1642 "The (conceptual) table listing the interface-specific (*,G) 1643 state that PIM has." 1644 ::= { pim 5 } 1646 pimStarGIEntry OBJECT-TYPE 1647 SYNTAX PimStarGIEntry 1648 MAX-ACCESS not-accessible 1649 STATUS current 1650 DESCRIPTION 1651 "An entry (conceptual row) in the pimStarGITable." 1652 INDEX { pimStarGAddressType, 1653 pimStarGGrpAddress, 1654 pimStarGIIfIndex } 1655 ::= { pimStarGITable 1 } 1657 PimStarGIEntry ::= SEQUENCE { 1658 pimStarGIIfIndex InterfaceIndex, 1659 pimStarGIUpTime TimeTicks, 1660 pimStarGILocalMembership TruthValue, 1661 pimStarGIJoinPruneState INTEGER, 1662 pimStarGIPrunePendingTimer TimeTicks, 1663 pimStarGIJoinExpiryTimer TimeTicks, 1664 pimStarGIAssertState INTEGER, 1665 pimStarGIAssertTimer TimeTicks, 1666 pimStarGIAssertWinnerAddressType InetAddressType, 1667 pimStarGIAssertWinnerAddress InetAddress, 1668 pimStarGIAssertWinnerMetricPref Unsigned32, 1669 pimStarGIAssertWinnerMetric Unsigned32 1670 } 1672 pimStarGIIfIndex OBJECT-TYPE 1673 SYNTAX InterfaceIndex 1674 MAX-ACCESS not-accessible 1675 STATUS current 1676 DESCRIPTION 1677 "The ifIndex of the interface that this entry corresponds 1678 to." 1679 ::= { pimStarGIEntry 1 } 1681 pimStarGIUpTime OBJECT-TYPE 1682 SYNTAX TimeTicks 1683 MAX-ACCESS read-only 1684 STATUS current 1685 DESCRIPTION 1686 "The time since this entry was created by the local router." 1687 ::= { pimStarGIEntry 2 } 1689 pimStarGILocalMembership OBJECT-TYPE 1690 SYNTAX TruthValue 1691 MAX-ACCESS read-only 1692 STATUS current 1693 DESCRIPTION 1694 "Whether the local router has (*,G) local membership on this 1695 interface (resulting from a mechanism such as IGMP or MLD). 1696 This corresponds to local_receiver_include(*,G,I) in the 1697 PIM-SM specification." 1698 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.1.6" 1699 ::= { pimStarGIEntry 3 } 1701 pimStarGIJoinPruneState OBJECT-TYPE 1702 SYNTAX INTEGER { 1703 noInfo (1), 1704 join (2), 1705 prunePending (3) 1706 } 1707 MAX-ACCESS read-only 1708 STATUS current 1709 DESCRIPTION 1710 "The state resulting from (*,G) Join/Prune messages 1711 received on this interface. This corresponds to the state 1712 of the downstream per-interface (*,G) state machine in the 1713 PIM-SM specification." 1714 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.5.2" 1715 ::= { pimStarGIEntry 4 } 1717 pimStarGIPrunePendingTimer OBJECT-TYPE 1718 SYNTAX TimeTicks 1719 MAX-ACCESS read-only 1720 STATUS current 1721 DESCRIPTION 1722 "The time remaining before the local router acts on a (*,G) 1723 Prune message received on this interface, during which the 1724 router is waiting to see whether another downstream router 1725 will override the Prune message. This timer is called the 1726 (*,G) Prune-Pending Timer in the PIM-SM specification. This 1727 object is zero if the timer is not running." 1728 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.5.1" 1729 ::= { pimStarGIEntry 5 } 1731 pimStarGIJoinExpiryTimer OBJECT-TYPE 1732 SYNTAX TimeTicks 1733 MAX-ACCESS read-only 1734 STATUS current 1735 DESCRIPTION 1736 "The time remaining before (*,G) Join state for this 1737 interface expires. This timer is called the (*,G) Join 1738 Expiry Timer in the PIM-SM specification. This object is 1739 zero if the timer is not running. A value of 'FFFFFFFF'h 1740 indicates an infinite expiry time." 1741 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.10" 1742 ::= { pimStarGIEntry 6 } 1744 pimStarGIAssertState OBJECT-TYPE 1745 SYNTAX INTEGER { 1746 noInfo (1), 1747 iAmAssertWinner (2), 1748 iAmAssertLoser (3) 1749 } 1750 MAX-ACCESS read-only 1751 STATUS current 1752 DESCRIPTION 1753 "The (*,G) Assert state for this interface. This 1754 corresponds to the state of the per-interface (*,G) Assert 1755 state machine in the PIM-SM specification. If 1756 pimStarGPimMode is 'bidir', this object must be 'noInfo'." 1757 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.6.2" 1758 ::= { pimStarGIEntry 7 } 1760 pimStarGIAssertTimer OBJECT-TYPE 1761 SYNTAX TimeTicks 1762 MAX-ACCESS read-only 1763 STATUS current 1764 DESCRIPTION 1765 "If pimStarGIAssertState is 'iAmAssertWinner', this is the 1766 time remaining before the local router next sends a (*,G) 1767 Assert message on this interface. If pimStarGIAssertState 1768 is 'iAmAssertLoser', this is the time remaining before the 1769 (*,G) Assert state expires. If pimStarGIAssertState is 1770 'noInfo', this is zero. This timer is called the (*,G) 1771 Assert Timer in the PIM-SM specification." 1772 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.6.2" 1773 ::= { pimStarGIEntry 8 } 1775 pimStarGIAssertWinnerAddressType OBJECT-TYPE 1776 SYNTAX InetAddressType 1777 MAX-ACCESS read-only 1778 STATUS current 1779 DESCRIPTION 1780 "If pimStarGIAssertState is 'iAmAssertLoser', this is the 1781 address type of the assert winner; otherwise, this object is 1782 unknown(0)." 1783 ::= { pimStarGIEntry 9 } 1785 pimStarGIAssertWinnerAddress OBJECT-TYPE 1786 SYNTAX InetAddress (SIZE (0|4|16|20)) 1787 MAX-ACCESS read-only 1788 STATUS current 1789 DESCRIPTION 1790 "If pimStarGIAssertState is 'iAmAssertLoser', this is the 1791 address of the assert winner. The InetAddressType is given 1792 by the pimStarGIAssertWinnerAddressType object." 1793 ::= { pimStarGIEntry 10 } 1795 pimStarGIAssertWinnerMetricPref OBJECT-TYPE 1796 SYNTAX Unsigned32 (0..2147483647) 1797 MAX-ACCESS read-only 1798 STATUS current 1799 DESCRIPTION 1800 "If pimStarGIAssertState is 'iAmAssertLoser', this is the 1801 metric preference of the route to the RP advertised by the 1802 assert winner; otherwise, this object is zero." 1803 ::= { pimStarGIEntry 11 } 1805 pimStarGIAssertWinnerMetric OBJECT-TYPE 1806 SYNTAX Unsigned32 1807 MAX-ACCESS read-only 1808 STATUS current 1809 DESCRIPTION 1810 "If pimStarGIAssertState is 'iAmAssertLoser', this is the 1811 routing metric of the route to the RP advertised by the 1812 assert winner; otherwise, this object is zero." 1813 ::= { pimStarGIEntry 12 } 1815 -- 1816 -- The PIM (S,G) State Table 1817 -- 1819 pimSGTable OBJECT-TYPE 1820 SYNTAX SEQUENCE OF PimSGEntry 1821 MAX-ACCESS not-accessible 1822 STATUS current 1823 DESCRIPTION 1824 "The (conceptual) table listing the non-interface specific 1825 (S,G) state that PIM has." 1826 ::= { pim 6 } 1828 pimSGEntry OBJECT-TYPE 1829 SYNTAX PimSGEntry 1830 MAX-ACCESS not-accessible 1831 STATUS current 1832 DESCRIPTION 1833 "An entry (conceptual row) in the pimSGTable." 1834 INDEX { pimSGAddressType, 1835 pimSGGrpAddress, 1836 pimSGSrcAddress } 1837 ::= { pimSGTable 1 } 1839 PimSGEntry ::= SEQUENCE { 1840 pimSGAddressType InetAddressType, 1841 pimSGGrpAddress InetAddress, 1842 pimSGSrcAddress InetAddress, 1843 pimSGUpTime TimeTicks, 1844 pimSGPimMode PimMode, 1845 pimSGUpstreamJoinState INTEGER, 1846 pimSGUpstreamJoinTimer TimeTicks, 1847 pimSGUpstreamNeighbor InetAddress, 1848 pimSGRPFIfIndex InterfaceIndexOrZero, 1849 pimSGRPFNextHopType InetAddressType, 1850 pimSGRPFNextHop InetAddress, 1851 pimSGRPFRouteProtocol IANAipRouteProtocol, 1852 pimSGRPFRouteAddress InetAddress, 1853 pimSGRPFRoutePrefixLength InetAddressPrefixLength, 1854 pimSGRPFRouteMetricPref Unsigned32, 1855 pimSGRPFRouteMetric Unsigned32, 1856 pimSGSPTBit TruthValue, 1857 pimSGKeepaliveTimer TimeTicks, 1858 pimSGDRRegisterState INTEGER, 1859 pimSGDRRegisterStopTimer TimeTicks, 1860 pimSGRPRegisterPMBRAddressType InetAddressType, 1861 pimSGRPRegisterPMBRAddress InetAddress, 1862 pimSGUpstreamPruneState INTEGER, 1863 pimSGUpstreamPruneLimitTimer TimeTicks, 1864 pimSGOriginatorState INTEGER, 1865 pimSGSourceActiveTimer TimeTicks, 1866 pimSGStateRefreshTimer TimeTicks 1867 } 1869 pimSGAddressType OBJECT-TYPE 1870 SYNTAX InetAddressType 1871 MAX-ACCESS not-accessible 1872 STATUS current 1873 DESCRIPTION 1874 "The address type of the source and multicast group for this 1875 entry." 1876 ::= { pimSGEntry 1 } 1878 pimSGGrpAddress OBJECT-TYPE 1879 SYNTAX InetAddress (SIZE (4|8|16|20)) 1880 MAX-ACCESS not-accessible 1881 STATUS current 1882 DESCRIPTION 1883 "The multicast group address for this entry. The 1884 InetAddressType is given by the pimSGAddressType object." 1885 ::= { pimSGEntry 2 } 1887 pimSGSrcAddress OBJECT-TYPE 1888 SYNTAX InetAddress (SIZE (4|8|16|20)) 1889 MAX-ACCESS not-accessible 1890 STATUS current 1891 DESCRIPTION 1892 "The source address for this entry. The InetAddressType is 1893 given by the pimSGAddressType object." 1894 ::= { pimSGEntry 3 } 1896 pimSGUpTime OBJECT-TYPE 1897 SYNTAX TimeTicks 1898 MAX-ACCESS read-only 1899 STATUS current 1900 DESCRIPTION 1901 "The time since this entry was created by the local router." 1902 ::= { pimSGEntry 4 } 1904 pimSGPimMode OBJECT-TYPE 1905 SYNTAX PimMode { ssm(2), asm(3) } 1906 MAX-ACCESS read-only 1907 STATUS current 1908 DESCRIPTION 1909 "Whether pimSGGrpAddress is an SSM (Source Specific 1910 Multicast, used with PIM-SM) or ASM (Any Source Multicast, 1911 used with PIM-SM) group." 1912 ::= { pimSGEntry 5 } 1914 pimSGUpstreamJoinState OBJECT-TYPE 1915 SYNTAX INTEGER { 1916 notJoined (1), 1917 joined (2) 1918 } 1919 MAX-ACCESS read-only 1920 STATUS current 1921 DESCRIPTION 1922 "Whether the local router should join the shortest-path tree 1923 for the source and group represented by this entry. This 1924 corresponds to the state of the upstream (S,G) state machine 1925 in the PIM-SM specification." 1926 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.5.7" 1927 ::= { pimSGEntry 6 } 1929 pimSGUpstreamJoinTimer OBJECT-TYPE 1930 SYNTAX TimeTicks 1931 MAX-ACCESS read-only 1932 STATUS current 1933 DESCRIPTION 1934 "The time remaining before the local router next sends a 1935 periodic (S,G) Join message on pimSGRPFIfIndex. This timer 1936 is called the (S,G) Upstream Join Timer in the PIM-SM 1937 specification. This object is zero if the timer is not 1938 running." 1939 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.10 and 4.11" 1940 ::= { pimSGEntry 7 } 1942 pimSGUpstreamNeighbor OBJECT-TYPE 1943 SYNTAX InetAddress (SIZE (4|8|16|20)) 1944 MAX-ACCESS read-only 1945 STATUS current 1946 DESCRIPTION 1947 "The primary address of the neighbor on pimSGRPFIfIndex that 1948 the local router is sending periodic (S,G) Join messages to. 1949 This is zero if the RPF next hop is unknown or is not a 1950 PIM neighbor. The InetAddressType is given by the 1951 pimSGAddressType object. This address is called RPF'(S,G) 1952 in the PIM-SM specification." 1953 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.1.6" 1954 ::= { pimSGEntry 8 } 1956 pimSGRPFIfIndex OBJECT-TYPE 1957 SYNTAX InterfaceIndexOrZero 1958 MAX-ACCESS read-only 1959 STATUS current 1960 DESCRIPTION 1961 "The value of ifIndex for the RPF interface towards the 1962 source, or zero if the RPF interface is unknown." 1963 ::= { pimSGEntry 9 } 1965 pimSGRPFNextHopType OBJECT-TYPE 1966 SYNTAX InetAddressType 1967 MAX-ACCESS read-only 1968 STATUS current 1969 DESCRIPTION 1970 "The address type of the RPF next hop towards the source, or 1971 unknown(0) if the RPF next hop is unknown." 1972 ::= { pimSGEntry 10 } 1974 pimSGRPFNextHop OBJECT-TYPE 1975 SYNTAX InetAddress (SIZE (4|8|16|20)) 1976 MAX-ACCESS read-only 1977 STATUS current 1978 DESCRIPTION 1979 "The address of the RPF next hop towards the source. The 1980 InetAddressType is given by the pimSGRPFNextHopType. This 1981 address is called MRIB.next_hop(S) in the PIM-SM 1982 specification." 1983 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.5.5" 1984 ::= { pimSGEntry 11 } 1986 pimSGRPFRouteProtocol OBJECT-TYPE 1987 SYNTAX IANAipRouteProtocol 1988 MAX-ACCESS read-only 1989 STATUS current 1990 DESCRIPTION 1991 "The routing mechanism via which the route used to find the 1992 RPF interface towards the source was learned." 1994 ::= { pimSGEntry 12 } 1996 pimSGRPFRouteAddress OBJECT-TYPE 1997 SYNTAX InetAddress (SIZE (4|8|16|20)) 1998 MAX-ACCESS read-only 1999 STATUS current 2000 DESCRIPTION 2001 "The IP address which when combined with the corresponding 2002 value of pimSGRPFRoutePrefixLength identifies the route used 2003 to find the RPF interface towards the source. The 2004 InetAddressType is given by the pimSGRPFNextHopType object. 2006 This address object is only significant up to 2007 pimSGRPFRoutePrefixLength bits. The remainder of the 2008 address bits are zero." 2009 ::= { pimSGEntry 13 } 2011 pimSGRPFRoutePrefixLength OBJECT-TYPE 2012 SYNTAX InetAddressPrefixLength 2013 MAX-ACCESS read-only 2014 STATUS current 2015 DESCRIPTION 2016 "The prefix length which when combined with the 2017 corresponding value of pimSGRPFRouteAddress identifies the 2018 route used to find the RPF interface towards the source. 2019 The InetAddressType is given by the pimSGRPFNextHopType 2020 object." 2021 ::= { pimSGEntry 14 } 2023 pimSGRPFRouteMetricPref OBJECT-TYPE 2024 SYNTAX Unsigned32 (0..2147483647) 2025 MAX-ACCESS read-only 2026 STATUS current 2027 DESCRIPTION 2028 "The metric preference of the route used to find the RPF 2029 interface towards the source." 2030 ::= { pimSGEntry 15 } 2032 pimSGRPFRouteMetric OBJECT-TYPE 2033 SYNTAX Unsigned32 2034 MAX-ACCESS read-only 2035 STATUS current 2036 DESCRIPTION 2037 "The routing metric of the route used to find the RPF 2038 interface towards the source." 2039 ::= { pimSGEntry 16 } 2041 pimSGSPTBit OBJECT-TYPE 2042 SYNTAX TruthValue 2043 MAX-ACCESS read-only 2044 STATUS current 2045 DESCRIPTION 2046 "Whether the SPT bit is set; and therefore whether 2047 forwarding is taking place on the shortest-path tree." 2048 ::= { pimSGEntry 17 } 2050 pimSGKeepaliveTimer OBJECT-TYPE 2051 SYNTAX TimeTicks 2052 MAX-ACCESS read-only 2053 STATUS current 2054 DESCRIPTION 2055 "The time remaining before, in the absence of explicit (S,G) 2056 local membership or (S,G) Join messages received to maintain 2057 it, this (S,G) state expires. This timer is called the 2058 (S,G) Keepalive Timer in the PIM-SM specification." 2059 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.1.4" 2060 ::= { pimSGEntry 18 } 2062 pimSGDRRegisterState OBJECT-TYPE 2063 SYNTAX INTEGER { 2064 noInfo (1), 2065 join (2), 2066 joinPending (3), 2067 prune (4) 2068 } 2069 MAX-ACCESS read-only 2070 STATUS current 2071 DESCRIPTION 2072 "Whether the local router should encapsulate (S,G) data 2073 packets in Register messages and send them to the RP. This 2074 corresponds to the state of the per-(S,G) Register state 2075 machine in the PIM-SM specification. This object is always 2076 'noInfo' unless pimSGPimMode is 'asm'." 2077 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.4.1" 2078 ::= { pimSGEntry 19 } 2080 pimSGDRRegisterStopTimer OBJECT-TYPE 2081 SYNTAX TimeTicks 2082 MAX-ACCESS read-only 2083 STATUS current 2084 DESCRIPTION 2085 "If pimSGDRRegisterState is 'prune', this is the time 2086 remaining before the local router sends a Null-Register 2087 message to the RP. If pimSGDRRegisterState is 2088 'joinPending', this is the time remaining before the local 2089 router resumes encapsulating data packets and sending them 2090 to the RP. Otherwise, this is zero. This timer is called 2091 the Register-Stop Timer in the PIM-SM specification." 2092 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.4" 2093 ::= { pimSGEntry 20 } 2095 pimSGRPRegisterPMBRAddressType OBJECT-TYPE 2096 SYNTAX InetAddressType 2097 MAX-ACCESS read-only 2098 STATUS current 2099 DESCRIPTION 2100 "The address type of the first PIM Multicast Border Router 2101 to send a Register message with the Border bit set. This 2102 object is unknown(0) if the local router is not the RP for 2103 the group." 2104 ::= { pimSGEntry 21 } 2106 pimSGRPRegisterPMBRAddress OBJECT-TYPE 2107 SYNTAX InetAddress (SIZE (0|4|16|20)) 2108 MAX-ACCESS read-only 2109 STATUS current 2110 DESCRIPTION 2111 "The IP address of the first PIM Multicast Border Router to 2112 send a Register message with the Border bit set. The 2113 InetAddressType is given by the 2114 pimSGRPRegisterPMBRAddressType object." 2115 ::= { pimSGEntry 22 } 2117 pimSGUpstreamPruneState OBJECT-TYPE 2118 SYNTAX INTEGER { 2119 forwarding (1), 2120 ackpending (2), 2121 pruned (3) 2122 } 2123 MAX-ACCESS read-only 2124 STATUS current 2125 DESCRIPTION 2126 "Whether the local router has pruned itself from the tree. 2127 This corresponds to the state of the upstream prune (S,G) 2128 state machine in the PIM-DM specification. This object is 2129 used only by PIM-DM." 2130 REFERENCE "RFC 3973 section 4.4.1" 2131 ::= { pimSGEntry 23 } 2133 pimSGUpstreamPruneLimitTimer OBJECT-TYPE 2134 SYNTAX TimeTicks 2135 MAX-ACCESS read-only 2136 STATUS current 2137 DESCRIPTION 2138 "The time remaining before the local router may send a (S,G) 2139 Prune message on pimSGRPFIfIndex. This timer is called the 2140 (S,G) Prune Limit Timer in the PIM-DM specification. This 2141 object is zero if the timer is not running. This object is 2142 used only by PIM-DM." 2143 REFERENCE "RFC 2973 section 4.8" 2144 ::= { pimSGEntry 24 } 2146 pimSGOriginatorState OBJECT-TYPE 2147 SYNTAX INTEGER { 2148 notOriginator (1), 2149 originator (2) 2150 } 2151 MAX-ACCESS read-only 2152 STATUS current 2153 DESCRIPTION 2154 "Whether the router is an originator for an (S,G) message 2155 flow. This corresponds to the state of the per-(S,G) 2156 Originator state machine in the PIM-DM specification. This 2157 object is used only by PIM-DM." 2158 REFERENCE "RFC 3973 section 4.5.2" 2159 ::= { pimSGEntry 25 } 2161 pimSGSourceActiveTimer OBJECT-TYPE 2162 SYNTAX TimeTicks 2163 MAX-ACCESS read-only 2164 STATUS current 2165 DESCRIPTION 2166 "If pimSGOriginatorState is 'originator', this is the time 2167 remaining before the local router reverts to a notOriginator 2168 state. Otherwise, this is zero. This timer is called the 2169 Source Active Timer in the PIM-DM specification. This 2170 object is used only by PIM-DM." 2171 REFERENCE "RFC 3973 section 4.8" 2172 ::= { pimSGEntry 26 } 2174 pimSGStateRefreshTimer OBJECT-TYPE 2175 SYNTAX TimeTicks 2176 MAX-ACCESS read-only 2177 STATUS current 2178 DESCRIPTION 2179 "If pimSGOriginatorState is 'originator', this is the time 2180 remaining before the local router sends a State Refresh 2181 message. Otherwise, this is zero. This timer is called the 2182 State Refresh Timer in the PIM-DM specification. This 2183 object is used only by PIM-DM." 2184 REFERENCE "RFC 3973 section 4.8" 2185 ::= { pimSGEntry 27 } 2187 -- 2188 -- The PIM (S,G,I) State Table 2189 -- 2191 pimSGITable OBJECT-TYPE 2192 SYNTAX SEQUENCE OF PimSGIEntry 2193 MAX-ACCESS not-accessible 2194 STATUS current 2195 DESCRIPTION 2196 "The (conceptual) table listing the interface-specific (S,G) 2197 state that PIM has." 2198 ::= { pim 7 } 2200 pimSGIEntry OBJECT-TYPE 2201 SYNTAX PimSGIEntry 2202 MAX-ACCESS not-accessible 2203 STATUS current 2204 DESCRIPTION 2205 "An entry (conceptual row) in the pimSGITable." 2206 INDEX { pimSGAddressType, 2207 pimSGGrpAddress, 2208 pimSGSrcAddress, 2209 pimSGIIfIndex } 2210 ::= { pimSGITable 1 } 2212 PimSGIEntry ::= SEQUENCE { 2213 pimSGIIfIndex InterfaceIndex, 2214 pimSGIUpTime TimeTicks, 2215 pimSGILocalMembership TruthValue, 2216 pimSGIJoinPruneState INTEGER, 2217 pimSGIPrunePendingTimer TimeTicks, 2218 pimSGIJoinExpiryTimer TimeTicks, 2219 pimSGIAssertState INTEGER, 2220 pimSGIAssertTimer TimeTicks, 2221 pimSGIAssertWinnerAddressType InetAddressType, 2222 pimSGIAssertWinnerAddress InetAddress, 2223 pimSGIAssertWinnerMetricPref Unsigned32, 2224 pimSGIAssertWinnerMetric Unsigned32 2225 } 2227 pimSGIIfIndex OBJECT-TYPE 2228 SYNTAX InterfaceIndex 2229 MAX-ACCESS not-accessible 2230 STATUS current 2231 DESCRIPTION 2232 "The ifIndex of the interface that this entry corresponds 2233 to." 2234 ::= { pimSGIEntry 1 } 2236 pimSGIUpTime OBJECT-TYPE 2237 SYNTAX TimeTicks 2238 MAX-ACCESS read-only 2239 STATUS current 2240 DESCRIPTION 2241 "The time since this entry was created by the local router." 2242 ::= { pimSGIEntry 2 } 2244 pimSGILocalMembership OBJECT-TYPE 2245 SYNTAX TruthValue 2246 MAX-ACCESS read-only 2247 STATUS current 2248 DESCRIPTION 2249 "Whether the local router has (S,G) local membership on this 2250 interface (resulting from a mechanism such as IGMPv3 or 2251 MLDv2). This corresponds to local_receiver_include(S,G,I) 2252 in the PIM-SM specification." 2253 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.1.6, 4.6.1 and 4.6.2" 2254 ::= { pimSGIEntry 3 } 2256 pimSGIJoinPruneState OBJECT-TYPE 2257 SYNTAX INTEGER { 2258 noInfo (1), 2259 join (2), 2260 prunePending (3) 2261 } 2262 MAX-ACCESS read-only 2263 STATUS current 2264 DESCRIPTION 2265 "The state resulting from (S,G) Join/Prune messages 2266 received on this interface. This corresponds to the state 2267 of the downstream per-interface (S,G) state machine in the 2268 PIM-SM and PIM-DM specification." 2269 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.5.3 and RFC 3973 section 2270 4.4.2" 2271 ::= { pimSGIEntry 4 } 2273 pimSGIPrunePendingTimer OBJECT-TYPE 2274 SYNTAX TimeTicks 2275 MAX-ACCESS read-only 2276 STATUS current 2277 DESCRIPTION 2278 "The time remaining before the local router acts on an (S,G) 2279 Prune message received on this interface, during which the 2280 router is waiting to see whether another downstream router 2281 will override the Prune message. This timer is called the 2282 (S,G) Prune-Pending Timer in the PIM-SM specification. This 2283 object is zero if the timer is not running." 2285 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.5.3 and 4.5.4" 2286 ::= { pimSGIEntry 5 } 2288 pimSGIJoinExpiryTimer OBJECT-TYPE 2289 SYNTAX TimeTicks 2290 MAX-ACCESS read-only 2291 STATUS current 2292 DESCRIPTION 2293 "The time remaining before (S,G) Join state for this 2294 interface expires. This timer is called the (S,G) Join 2295 Expiry Timer in the PIM-SM specification. This object is 2296 zero if the timer is not running. A value of 'FFFFFFFF'h 2297 indicates an infinite expiry time. This timer is called the 2298 (S,G) Prune Timer in the PIM-DM specification." 2299 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.10 and RFC 3973 section 2300 4.8" 2301 ::= { pimSGIEntry 6 } 2303 pimSGIAssertState OBJECT-TYPE 2304 SYNTAX INTEGER { 2305 noInfo (1), 2306 iAmAssertWinner (2), 2307 iAmAssertLoser (3) 2308 } 2309 MAX-ACCESS read-only 2310 STATUS current 2311 DESCRIPTION 2312 "The (S,G) Assert state for this interface. This 2313 corresponds to the state of the per-interface (S,G) Assert 2314 state machine in the PIM-SM specification." 2315 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.6.1" 2316 ::= { pimSGIEntry 7 } 2318 pimSGIAssertTimer OBJECT-TYPE 2319 SYNTAX TimeTicks 2320 MAX-ACCESS read-only 2321 STATUS current 2322 DESCRIPTION 2323 "If pimSGIAssertState is 'iAmAssertWinner', this is the time 2324 remaining before the local router next sends a (S,G) Assert 2325 message on this interface. If pimSGIAssertState is 2326 'iAmAssertLoser', this is the time remaining before the 2327 (S,G) Assert state expires. If pimSGIAssertState is 2328 'noInfo', this is zero. This timer is called the (S,G) 2329 Assert Timer in the PIM-SM specification." 2330 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.6.1" 2331 ::= { pimSGIEntry 8 } 2333 pimSGIAssertWinnerAddressType OBJECT-TYPE 2334 SYNTAX InetAddressType 2335 MAX-ACCESS read-only 2336 STATUS current 2337 DESCRIPTION 2338 "If pimSGIAssertState is 'iAmAssertLoser', this is the 2339 address type of the assert winner; otherwise, this object is 2340 unknown(0)." 2341 ::= { pimSGIEntry 9 } 2343 pimSGIAssertWinnerAddress OBJECT-TYPE 2344 SYNTAX InetAddress (SIZE (0|4|16|20)) 2345 MAX-ACCESS read-only 2346 STATUS current 2347 DESCRIPTION 2348 "If pimSGIAssertState is 'iAmAssertLoser', this is the 2349 address of the assert winner. The InetAddressType is given 2350 by the pimSGIAssertWinnerAddressType object." 2351 ::= { pimSGIEntry 10 } 2353 pimSGIAssertWinnerMetricPref OBJECT-TYPE 2354 SYNTAX Unsigned32 (0..2147483647) 2355 MAX-ACCESS read-only 2356 STATUS current 2357 DESCRIPTION 2358 "If pimSGIAssertState is 'iAmAssertLoser', this is the 2359 metric preference of the route to the source advertised by 2360 the assert winner; otherwise, this object is zero." 2361 ::= { pimSGIEntry 11 } 2363 pimSGIAssertWinnerMetric OBJECT-TYPE 2364 SYNTAX Unsigned32 2365 MAX-ACCESS read-only 2366 STATUS current 2367 DESCRIPTION 2368 "If pimSGIAssertState is 'iAmAssertLoser', this is the 2369 routing metric of the route to the source advertised by the 2370 assert winner; otherwise, this object is zero." 2371 ::= { pimSGIEntry 12 } 2373 -- 2374 -- The PIM (S,G,rpt) State Table 2375 -- 2377 pimSGRptTable OBJECT-TYPE 2378 SYNTAX SEQUENCE OF PimSGRptEntry 2379 MAX-ACCESS not-accessible 2380 STATUS current 2381 DESCRIPTION 2382 "The (conceptual) table listing the non-interface specific 2383 (S,G,rpt) state that PIM has." 2384 ::= { pim 8 } 2386 pimSGRptEntry OBJECT-TYPE 2387 SYNTAX PimSGRptEntry 2388 MAX-ACCESS not-accessible 2389 STATUS current 2390 DESCRIPTION 2391 "An entry (conceptual row) in the pimSGRptTable." 2392 INDEX { pimStarGAddressType, 2393 pimStarGGrpAddress, 2394 pimSGRptSrcAddress } 2395 ::= { pimSGRptTable 1 } 2397 PimSGRptEntry ::= SEQUENCE { 2398 pimSGRptSrcAddress InetAddress, 2399 pimSGRptUpTime TimeTicks, 2400 pimSGRptUpstreamPruneState INTEGER, 2401 pimSGRptUpstreamOverrideTimer TimeTicks 2402 } 2404 pimSGRptSrcAddress OBJECT-TYPE 2405 SYNTAX InetAddress (SIZE (4|8|16|20)) 2406 MAX-ACCESS not-accessible 2407 STATUS current 2408 DESCRIPTION 2409 "The source address for this entry. The InetAddressType is 2410 given by the pimStarGAddressType object." 2411 ::= { pimSGRptEntry 1 } 2413 pimSGRptUpTime OBJECT-TYPE 2414 SYNTAX TimeTicks 2415 MAX-ACCESS read-only 2416 STATUS current 2417 DESCRIPTION 2418 "The time since this entry was created by the local router." 2419 ::= { pimSGRptEntry 2 } 2421 pimSGRptUpstreamPruneState OBJECT-TYPE 2422 SYNTAX INTEGER { 2423 rptNotJoined (1), 2424 pruned (2), 2425 notPruned (3) 2426 } 2427 MAX-ACCESS read-only 2428 STATUS current 2429 DESCRIPTION 2430 "Whether the local router should prune the source off the RP 2431 tree. This corresponds to the state of the upstream 2432 (S,G,rpt) state machine for triggered messages in the PIM-SM 2433 specification." 2434 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.5.9" 2435 ::= { pimSGRptEntry 3 } 2437 pimSGRptUpstreamOverrideTimer OBJECT-TYPE 2438 SYNTAX TimeTicks 2439 MAX-ACCESS read-only 2440 STATUS current 2441 DESCRIPTION 2442 "The time remaining before the local router sends a 2443 triggered (S,G,rpt) Join message on pimStarGRPFIfIndex. 2444 This timer is called the (S,G,rpt) Upstream Override Timer 2445 in the PIM-SM specification. This object is zero if the 2446 timer is not running." 2447 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.5.9" 2448 ::= { pimSGRptEntry 4 } 2450 -- 2451 -- The PIM (S,G,rpt,I) State Table 2452 -- 2454 pimSGRptITable OBJECT-TYPE 2455 SYNTAX SEQUENCE OF PimSGRptIEntry 2456 MAX-ACCESS not-accessible 2457 STATUS current 2458 DESCRIPTION 2459 "The (conceptual) table listing the interface-specific 2460 (S,G,rpt) state that PIM has." 2461 ::= { pim 9 } 2463 pimSGRptIEntry OBJECT-TYPE 2464 SYNTAX PimSGRptIEntry 2465 MAX-ACCESS not-accessible 2466 STATUS current 2467 DESCRIPTION 2468 "An entry (conceptual row) in the pimSGRptITable." 2469 INDEX { pimStarGAddressType, 2470 pimStarGGrpAddress, 2471 pimSGRptSrcAddress, 2472 pimSGRptIIfIndex } 2473 ::= { pimSGRptITable 1 } 2475 PimSGRptIEntry ::= SEQUENCE { 2476 pimSGRptIIfIndex InterfaceIndex, 2477 pimSGRptIUpTime TimeTicks, 2478 pimSGRptILocalMembership TruthValue, 2479 pimSGRptIJoinPruneState INTEGER, 2480 pimSGRptIPrunePendingTimer TimeTicks, 2481 pimSGRptIPruneExpiryTimer TimeTicks 2482 } 2484 pimSGRptIIfIndex OBJECT-TYPE 2485 SYNTAX InterfaceIndex 2486 MAX-ACCESS not-accessible 2487 STATUS current 2488 DESCRIPTION 2489 "The ifIndex of the interface that this entry corresponds 2490 to." 2491 ::= { pimSGRptIEntry 1 } 2493 pimSGRptIUpTime OBJECT-TYPE 2494 SYNTAX TimeTicks 2495 MAX-ACCESS read-only 2496 STATUS current 2497 DESCRIPTION 2498 "The time since this entry was created by the local router." 2499 ::= { pimSGRptIEntry 2 } 2501 pimSGRptILocalMembership OBJECT-TYPE 2502 SYNTAX TruthValue 2503 MAX-ACCESS read-only 2504 STATUS current 2505 DESCRIPTION 2506 "Whether the local router has both (*,G) include local 2507 membership and (S,G) exclude local membership on this 2508 interface (resulting from a mechanism such as IGMPv3 or 2509 MLDv2). This corresponds to local_receiver_exclude(S,G,I) 2510 in the PIM-SM specification." 2511 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.1.6" 2512 ::= { pimSGRptIEntry 3 } 2514 pimSGRptIJoinPruneState OBJECT-TYPE 2515 SYNTAX INTEGER { 2516 noInfo (1), 2517 prune (2), 2518 prunePending (3) 2519 } 2520 MAX-ACCESS read-only 2521 STATUS current 2522 DESCRIPTION 2523 "The state resulting from (S,G,rpt) Join/Prune messages 2524 received on this interface. This corresponds to the state 2525 of the downstream per-interface (S,G,rpt) state machine in 2526 the PIM-SM specification." 2527 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.5.4" 2528 ::= { pimSGRptIEntry 4 } 2530 pimSGRptIPrunePendingTimer OBJECT-TYPE 2531 SYNTAX TimeTicks 2532 MAX-ACCESS read-only 2533 STATUS current 2534 DESCRIPTION 2535 "The time remaining before the local router starts pruning 2536 this source off the RP tree. This timer is called the 2537 (S,G,rpt) Prune-Pending Timer in the PIM-SM specification. 2538 This object is zero if the timer is not running." 2539 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.5.4" 2540 ::= { pimSGRptIEntry 5 } 2542 pimSGRptIPruneExpiryTimer OBJECT-TYPE 2543 SYNTAX TimeTicks 2544 MAX-ACCESS read-only 2545 STATUS current 2546 DESCRIPTION 2547 "The time remaining before (S,G,rpt) Prune state for this 2548 interface expires. This timer is called the (S,G,rpt) 2549 Prune Expiry Timer in the PIM-SM specification. This object 2550 is zero if the timer is not running. A value of 'FFFFFFFF'h 2551 indicates an infinite expiry time." 2552 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.5.4" 2553 ::= { pimSGRptIEntry 6 } 2555 -- 2556 -- The PIM Bidir DF-Election Table 2557 -- 2559 pimBidirDFElectionTable OBJECT-TYPE 2560 SYNTAX SEQUENCE OF PimBidirDFElectionEntry 2561 MAX-ACCESS not-accessible 2562 STATUS current 2563 DESCRIPTION 2564 "The (conceptual) table listing the per-RP Designated 2565 Forwarder (DF) Election state for each interface for all the 2566 RPs in BIDIR mode." 2567 ::= { pim 10 } 2569 pimBidirDFElectionEntry OBJECT-TYPE 2570 SYNTAX PimBidirDFElectionEntry 2571 MAX-ACCESS not-accessible 2572 STATUS current 2573 DESCRIPTION 2574 "An entry (conceptual row) in the pimBidirDFElectionTable." 2575 INDEX { pimBidirDFElectionAddressType, 2576 pimBidirDFElectionRPAddress, 2577 pimBidirDFElectionIfIndex } 2578 ::= { pimBidirDFElectionTable 1 } 2580 PimBidirDFElectionEntry ::= SEQUENCE { 2581 pimBidirDFElectionAddressType InetAddressType, 2582 pimBidirDFElectionRPAddress InetAddress, 2583 pimBidirDFElectionIfIndex InterfaceIndex, 2584 pimBidirDFElectionWinnerAddressType InetAddressType, 2585 pimBidirDFElectionWinnerAddress InetAddress, 2586 pimBidirDFElectionWinnerUpTime TimeTicks, 2587 pimBidirDFElectionWinnerMetricPref Unsigned32, 2588 pimBidirDFElectionWinnerMetric Unsigned32, 2589 pimBidirDFElectionState INTEGER, 2590 pimBidirDFElectionStateTimer TimeTicks 2591 } 2593 pimBidirDFElectionAddressType OBJECT-TYPE 2594 SYNTAX InetAddressType 2595 MAX-ACCESS not-accessible 2596 STATUS current 2597 DESCRIPTION 2598 "The address type of the RP for which the DF state is being 2599 maintained." 2600 ::= { pimBidirDFElectionEntry 1 } 2602 pimBidirDFElectionRPAddress OBJECT-TYPE 2603 SYNTAX InetAddress (SIZE (4|8|16|20)) 2604 MAX-ACCESS not-accessible 2605 STATUS current 2606 DESCRIPTION 2607 "The IP address of the RP for which the DF state is being 2608 maintained. The InetAddressType is given by the 2609 pimBidirDFElectionAddressType object." 2610 ::= { pimBidirDFElectionEntry 2 } 2612 pimBidirDFElectionIfIndex OBJECT-TYPE 2613 SYNTAX InterfaceIndex 2614 MAX-ACCESS not-accessible 2615 STATUS current 2616 DESCRIPTION 2617 "The value of ifIndex for the interface for which the DF 2618 state is being maintained." 2619 ::= { pimBidirDFElectionEntry 3 } 2621 pimBidirDFElectionWinnerAddressType OBJECT-TYPE 2622 SYNTAX InetAddressType 2623 MAX-ACCESS read-only 2624 STATUS current 2625 DESCRIPTION 2626 "The primary address type of the winner of the DF Election 2627 process. A value of unknown(0) indicates there is currently 2628 no DF." 2629 ::= { pimBidirDFElectionEntry 4 } 2631 pimBidirDFElectionWinnerAddress OBJECT-TYPE 2632 SYNTAX InetAddress (SIZE (0|4|16|20)) 2633 MAX-ACCESS read-only 2634 STATUS current 2635 DESCRIPTION 2636 "The primary IP address of the winner of the DF Election 2637 process. The InetAddressType is given by the 2638 pimBidirDFElectionWinnderAddressType object." 2639 ::= { pimBidirDFElectionEntry 5 } 2641 pimBidirDFElectionWinnerUpTime OBJECT-TYPE 2642 SYNTAX TimeTicks 2643 MAX-ACCESS read-only 2644 STATUS current 2645 DESCRIPTION 2646 "The time since the current winner (last) became elected as 2647 the DF for this RP." 2648 ::= { pimBidirDFElectionEntry 6 } 2650 pimBidirDFElectionWinnerMetricPref OBJECT-TYPE 2651 SYNTAX Unsigned32 2652 MAX-ACCESS read-only 2653 STATUS current 2654 DESCRIPTION 2655 "The metric preference advertised by the DF Winner, or zero 2656 if there is currently no DF." 2657 ::= { pimBidirDFElectionEntry 7 } 2659 pimBidirDFElectionWinnerMetric OBJECT-TYPE 2660 SYNTAX Unsigned32 2661 MAX-ACCESS read-only 2662 STATUS current 2663 DESCRIPTION 2664 "The metric advertised by the DF Winner, or zero if there is 2665 currently no DF." 2666 ::= { pimBidirDFElectionEntry 8 } 2668 pimBidirDFElectionState OBJECT-TYPE 2669 SYNTAX INTEGER { 2670 dfOffer(1), 2671 dfLose(2), 2672 dfWinner(3), 2673 dfBackoff(4) 2674 } 2675 MAX-ACCESS read-only 2676 STATUS current 2677 DESCRIPTION 2678 "The state of this interface with respect to DF-Election for 2679 this RP. The states correspond to the ones defined in the 2680 BIDIR-PIM specification." 2681 REFERENCE "I-D.ietf-pim-bidir-07 section 3.5.3.1" 2682 ::= { pimBidirDFElectionEntry 9 } 2684 pimBidirDFElectionStateTimer OBJECT-TYPE 2685 SYNTAX TimeTicks 2686 MAX-ACCESS read-only 2687 STATUS current 2688 DESCRIPTION 2689 "The minimum time remaining after which the local router 2690 will expire the current DF state represented by 2691 pimBidirDFElectionState." 2692 ::= { pimBidirDFElectionEntry 10 } 2694 -- 2695 -- The PIM Static RP Table 2696 -- 2698 pimStaticRPTable OBJECT-TYPE 2699 SYNTAX SEQUENCE OF PimStaticRPEntry 2700 MAX-ACCESS not-accessible 2701 STATUS current 2702 DESCRIPTION 2703 "This table is used to create and manage static 2704 configuration of RPs. 2706 If the group prefixes configured for two or more rows in 2707 this table overlap, the row with the greatest value of 2708 pimStaticRPGrpPrefixLength is used for the overlapping 2709 range." 2710 ::= { pim 11 } 2712 pimStaticRPEntry OBJECT-TYPE 2713 SYNTAX PimStaticRPEntry 2714 MAX-ACCESS not-accessible 2715 STATUS current 2716 DESCRIPTION 2717 "An entry (conceptual row) in the pimStaticRPTable. This 2718 entry is preserved on agent restart." 2719 INDEX { pimStaticRPAddressType, 2720 pimStaticRPGrpAddress, 2721 pimStaticRPGrpPrefixLength } 2722 ::= { pimStaticRPTable 1 } 2724 PimStaticRPEntry ::= SEQUENCE { 2725 pimStaticRPAddressType InetAddressType, 2726 pimStaticRPGrpAddress InetAddress, 2727 pimStaticRPGrpPrefixLength InetAddressPrefixLength, 2728 pimStaticRPRPAddress InetAddress, 2729 pimStaticRPPimMode PimMode, 2730 pimStaticRPOverrideDynamic TruthValue, 2731 pimStaticRPRowStatus RowStatus, 2732 pimStaticRPPrecedence Unsigned32 2733 } 2735 pimStaticRPAddressType OBJECT-TYPE 2736 SYNTAX InetAddressType 2737 MAX-ACCESS not-accessible 2738 STATUS current 2739 DESCRIPTION 2740 "The address type of this entry." 2741 ::= { pimStaticRPEntry 1 } 2743 pimStaticRPGrpAddress OBJECT-TYPE 2744 SYNTAX InetAddress (SIZE (4|8|16|20)) 2745 MAX-ACCESS not-accessible 2746 STATUS current 2747 DESCRIPTION 2748 "The multicast group address which, when combined with 2749 pimStaticRPGrpPrefixLength, gives the group prefix for this 2750 entry. The InetAddressType is given by the 2751 pimStaticRPAddressType object. 2753 This address object is only significant up to 2754 pimSGRPFRoutePrefixLength bits. The remainder of the 2755 address bits are zero. This is especially important for 2756 this index field, which is part of the index of this entry. 2757 Any non-zero bits would signify an entirely different 2758 entry." 2759 ::= { pimStaticRPEntry 2 } 2761 pimStaticRPGrpPrefixLength OBJECT-TYPE 2762 SYNTAX InetAddressPrefixLength (4..128) 2763 MAX-ACCESS not-accessible 2764 STATUS current 2765 DESCRIPTION 2766 "The multicast group prefix length, which, when combined 2767 with pimStaticRPGrpAddress, gives the group prefix for this 2768 entry. The InetAddressType is given by the 2769 pimStaticRPAddressType object. If pimStaticRPAddressType is 2770 'ipv4' or 'ipv4z', this object must be in the range 4..32. 2771 If pimStaticRPGrpAddressType is 'ipv6' or 'ipv6z', this 2772 object must be in the range 8..128." 2773 ::= { pimStaticRPEntry 3 } 2775 pimStaticRPRPAddress OBJECT-TYPE 2776 SYNTAX InetAddress (SIZE (4|8|16|20)) 2777 MAX-ACCESS read-create 2778 STATUS current 2779 DESCRIPTION 2780 "The IP address of the RP to be used for groups within this 2781 group prefix. The InetAddressType is given by the 2782 pimStaticRPAddressType object." 2783 ::= { pimStaticRPEntry 4 } 2785 pimStaticRPPimMode OBJECT-TYPE 2786 SYNTAX PimMode { ssm(2), asm(3), bidir(4) } 2787 MAX-ACCESS read-create 2788 STATUS current 2789 DESCRIPTION 2790 "The PIM mode to be used for groups in this group prefix. 2792 If this object is set to ssm(2), then pimStaticRPRPAddress 2793 must be set to zero. No RP operations are ever possible for 2794 PIM Mode SSM." 2795 DEFVAL { asm } 2796 ::= { pimStaticRPEntry 5 } 2798 pimStaticRPOverrideDynamic OBJECT-TYPE 2799 SYNTAX TruthValue 2800 MAX-ACCESS read-create 2801 STATUS current 2802 DESCRIPTION 2803 "Whether this static RP configuration overrides RP 2804 information learned dynamically for groups in this group 2805 prefix." 2806 DEFVAL { false } 2807 ::= { pimStaticRPEntry 6 } 2809 pimStaticRPRowStatus OBJECT-TYPE 2810 SYNTAX RowStatus 2811 MAX-ACCESS read-create 2812 STATUS current 2813 DESCRIPTION 2814 "The status of this row, by which rows in this table can 2815 be created and destroyed. 2817 This status object cannot be set to active(1) before valid 2818 values have been written to pimStaticRPRPAddress. 2820 All writeable objects in this entry can be modified when the 2821 status of this entry is active(1)." 2822 ::= { pimStaticRPEntry 7 } 2824 pimStaticRPPrecedence OBJECT-TYPE 2825 SYNTAX Unsigned32 2826 MAX-ACCESS read-create 2827 STATUS current 2828 DESCRIPTION 2829 "The value for pimGroupMappingPrecedence to be used for this 2830 static RP configuration. This allows fine control over 2831 which configuration is overridden by this static 2832 configuration. 2834 If this object is present, then pimStaticRPOverrideDynamic 2835 is ignored. 2837 The absolute values of this object have a significance only 2838 on the local router and do not need to be coordinated with 2839 other routers. A setting of this object may have different 2840 effects when applied to other routers. 2842 Do not use this object unless fine control of static RP 2843 behavior on the local router is required." 2844 ::= { pimStaticRPEntry 8 } 2846 -- 2847 -- The PIM Anycast-RP Set Table 2848 -- 2850 pimAnycastRPSetTable OBJECT-TYPE 2851 SYNTAX SEQUENCE OF PimAnycastRPSetEntry 2852 MAX-ACCESS not-accessible 2853 STATUS current 2854 DESCRIPTION 2855 "This table is used to create and manage Anycast-RP via PIM 2856 Register messages, as opposed to via other protocols such as 2857 MSDP. 2859 Entries must be configured in this table if and only if the 2860 local router is a member of one or more Anycast-RP sets, 2861 that is, one or more Anycast-RP addresses are assigned to 2862 the local router. Note that if using static RP 2863 configuration, this is in addition to, not instead of, the 2864 pimStaticRPTable entries that must be configured for the 2865 Anycast-RPs. 2867 The set of rows with the same values of both 2868 pimAnycastRPSetAddressType and pimAnycastRPSetAnycastAddress 2869 corresponds to the Anycast-RP set for that Anycast-RP 2870 address. 2872 When an Anycast-RP set configuration is active, one entry 2873 per pimAnycastRPSetAnycastAddress corresponds to the local 2874 router. The local router is identified by the 2875 pimAnycastRpSetLocalRouter object. That entry determines 2876 the source address used by the local router when forwarding 2877 PIM Register messages within the Anycast-RP set." 2878 REFERENCE "I-D.ietf-pim-anycast-rp-04" 2879 ::= { pim 12 } 2881 pimAnycastRPSetEntry OBJECT-TYPE 2882 SYNTAX PimAnycastRPSetEntry 2883 MAX-ACCESS not-accessible 2884 STATUS current 2885 DESCRIPTION 2886 "An entry corresponds to a single router within a particular 2887 Anycast-RP set. This entry is preserved on agent restart." 2888 INDEX { pimAnycastRPSetAddressType, 2889 pimAnycastRPSetAnycastAddress, 2890 pimAnycastRPSetRouterAddress } 2891 ::= { pimAnycastRPSetTable 1 } 2893 PimAnycastRPSetEntry ::= SEQUENCE { 2894 pimAnycastRPSetAddressType InetAddressType, 2895 pimAnycastRPSetAnycastAddress InetAddress, 2896 pimAnycastRPSetRouterAddress InetAddress, 2897 pimAnycastRPSetRowStatus RowStatus, 2898 pimAnycastRPSetLocalRouter TruthValue 2899 } 2901 pimAnycastRPSetAddressType OBJECT-TYPE 2902 SYNTAX InetAddressType 2903 MAX-ACCESS not-accessible 2904 STATUS current 2905 DESCRIPTION 2906 "The address type of the Anycast-RP address and router 2907 address." 2908 ::= { pimAnycastRPSetEntry 1 } 2910 pimAnycastRPSetAnycastAddress OBJECT-TYPE 2911 SYNTAX InetAddress (SIZE (4|8|16|20)) 2912 MAX-ACCESS not-accessible 2913 STATUS current 2914 DESCRIPTION 2915 "The Anycast-RP address. The InetAddressType is given by 2916 the pimAnycastRPSetAddressType object." 2917 ::= { pimAnycastRPSetEntry 2 } 2919 pimAnycastRPSetRouterAddress OBJECT-TYPE 2920 SYNTAX InetAddress (SIZE (4|8|16|20)) 2921 MAX-ACCESS not-accessible 2922 STATUS current 2923 DESCRIPTION 2924 "The address of a router that is a member of the Anycast-RP 2925 set. The InetAddressType is given by the 2926 pimAnycastRPSetAddressType object. 2928 This address differs from pimAnycastRPSetAnycastAddress. 2929 Equal values for these two addresses in a single entry is 2930 not permitted. That would cause a Register loop." 2931 ::= { pimAnycastRPSetEntry 3 } 2933 pimAnycastRPSetRowStatus OBJECT-TYPE 2934 SYNTAX RowStatus 2935 MAX-ACCESS read-create 2936 STATUS current 2937 DESCRIPTION 2938 "The status of this row, by which rows in this table can 2939 be created and destroyed. There are no other other 2940 writeable columnar objects in this entry." 2941 ::= { pimAnycastRPSetEntry 4 } 2943 pimAnycastRPSetLocalRouter OBJECT-TYPE 2944 SYNTAX TruthValue 2945 MAX-ACCESS read-only 2946 STATUS current 2947 DESCRIPTION 2948 "Whether this entry corresponds to the local router." 2949 ::= { pimAnycastRPSetEntry 5 } 2951 -- 2952 -- The PIM Group Mapping Table 2953 -- 2955 pimGroupMappingTable OBJECT-TYPE 2956 SYNTAX SEQUENCE OF PimGroupMappingEntry 2957 MAX-ACCESS not-accessible 2958 STATUS current 2959 DESCRIPTION 2960 "The (conceptual) table listing mappings from multicast 2961 group prefixes to the PIM mode and RP address to use for 2962 groups within that group prefix. 2964 Rows in this table are created for a variety of reasons, 2965 indicated by the value of the pimGroupMappingOrigin object. 2967 - Rows with a pimGroupMappingOrigin value of 'fixed' are 2968 created automatically by the router at startup, to 2969 correspond to the well-defined prefixes of link-local and 2970 unroutable group addresses. These rows are never 2971 destroyed. 2973 - Rows with a pimGroupMappingOrigin value of 'embedded' are 2974 created by the router to correspond to group prefixes 2975 that are to be treated as being in Embedded-RP format. 2977 - Rows with a pimGroupMappingOrigin value of 'configRp' are 2978 created and destroyed as a result of rows in the 2979 pimStaticRPTable being created and destroyed. 2981 - Rows with a pimGroupMappingOrigin value of 'configSsm' 2982 are created and destroyed as a result of configuration of 2983 SSM address ranges to the local router. 2985 - Rows with a pimGroupMappingOrigin value of 'bsr' are 2986 created as a result of running the PIM Bootstrap Router 2987 (BSR) mechanism. If the local router is not the elected 2988 BSR, these rows are created to correspond to group 2989 prefixes in the PIM Bootstrap messages received from the 2990 elected BSR. If the local router is the elected BSR, 2991 these rows are created to correspond to group prefixes in 2992 the PIM Bootstrap messages that the local router sends. 2993 In either case, these rows are destroyed when the group 2994 prefixes are timed out by the BSR mechanism. 2996 - Rows with a pimGroupMappingOrigin value of 'other' are 2997 created and destroyed according to some other mechanism 2998 not specified here. 3000 Given the collection of rows in this table at any point in 3001 time, the PIM mode and RP address to use for a particular 3002 group is determined using the following algorithm. 3004 1. From the set of all rows, the subset whose group prefix 3005 contains the group in question are selected. 3007 2. If there are no such rows, the behavior is undefined. 3009 3. If there is at least one such row, from the selected 3010 subset of rows, the subset that have the lowest value 3011 of pimGroupMappingPrecedence are selected. 3013 4. From the selected subset of rows, the subset that have 3014 the greatest value of pimGroupMappingGrpPrefixLength are 3015 selected. 3017 5. If there are multiple selected rows, the subset that have 3018 the highest precedence (the lowest numerical value for 3019 pimGroupMappingPrecedence) are selected. 3021 6. If there are multiple selected rows, the row selected is 3022 implementation dependent; the implementation might or 3023 might not apply the PIM hash function to select the row. 3025 7. The group mode to use is given by the value of 3026 pimGroupMappingPimMode from the single selected row; the 3027 RP to use is given by the value of 3028 pimGroupMappingRPAddress, unless pimGroupMappingOrigin is 3029 'embedded', in which case the RP is extracted from the 3030 group address in question." 3031 REFERENCE "RFC 3956" 3032 ::= { pim 13 } 3034 pimGroupMappingEntry OBJECT-TYPE 3035 SYNTAX PimGroupMappingEntry 3036 MAX-ACCESS not-accessible 3037 STATUS current 3038 DESCRIPTION 3039 "An entry (conceptual row) in the pimGroupMappingTable." 3040 INDEX { pimGroupMappingOrigin, 3041 pimGroupMappingAddressType, 3042 pimGroupMappingGrpAddress, 3043 pimGroupMappingGrpPrefixLength, 3044 pimGroupMappingRPAddressType, 3045 pimGroupMappingRPAddress } 3046 ::= { pimGroupMappingTable 1 } 3048 PimGroupMappingEntry ::= SEQUENCE { 3049 pimGroupMappingOrigin PimGroupMappingOriginType, 3050 pimGroupMappingAddressType InetAddressType, 3051 pimGroupMappingGrpAddress InetAddress, 3052 pimGroupMappingGrpPrefixLength InetAddressPrefixLength, 3053 pimGroupMappingRPAddressType InetAddressType, 3054 pimGroupMappingRPAddress InetAddress, 3055 pimGroupMappingPimMode PimMode, 3056 pimGroupMappingPrecedence Unsigned32 3057 } 3059 pimGroupMappingOrigin OBJECT-TYPE 3060 SYNTAX PimGroupMappingOriginType 3061 MAX-ACCESS not-accessible 3062 STATUS current 3063 DESCRIPTION 3064 "The mechanism by which this group mapping was learned." 3065 ::= { pimGroupMappingEntry 1 } 3067 pimGroupMappingAddressType OBJECT-TYPE 3068 SYNTAX InetAddressType 3069 MAX-ACCESS not-accessible 3070 STATUS current 3071 DESCRIPTION 3072 "The address type of the IP multicast group prefix." 3073 ::= { pimGroupMappingEntry 2 } 3075 pimGroupMappingGrpAddress OBJECT-TYPE 3076 SYNTAX InetAddress (SIZE (4|8|16|20)) 3077 MAX-ACCESS not-accessible 3078 STATUS current 3079 DESCRIPTION 3080 "The IP multicast group address which, when combined with 3081 pimGroupMappingGrpPrefixLength, gives the group prefix for 3082 this mapping. The InetAddressType is given by the 3083 pimGroupMappingAddressType object. 3085 This address object is only significant up to 3086 pimGroupMappingGrpPrefixLength bits. The remainder of the 3087 address bits are zero. This is especially important for 3088 this index field, which is part of the index of this entry. 3089 Any non-zero bits would signify an entirely different 3090 entry." 3091 ::= { pimGroupMappingEntry 3 } 3093 pimGroupMappingGrpPrefixLength OBJECT-TYPE 3094 SYNTAX InetAddressPrefixLength (4..128) 3095 MAX-ACCESS not-accessible 3096 STATUS current 3097 DESCRIPTION 3098 "The multicast group prefix length, which, when combined 3099 with pimGroupMappingGrpAddress, gives the group prefix for 3100 this mapping. The InetAddressType is given by the 3101 pimGroupMappingAddressType object. If 3102 pimGroupMappingAddressType is 'ipv4' or 'ipv4z', this 3103 object must be in the range 4..32. If 3104 pimGroupMappingAddressType is 'ipv6' or 'ipv6z', this object 3105 must be in the range 8..128." 3106 ::= { pimGroupMappingEntry 4 } 3108 pimGroupMappingRPAddressType OBJECT-TYPE 3109 SYNTAX InetAddressType 3110 MAX-ACCESS not-accessible 3111 STATUS current 3112 DESCRIPTION 3113 "The address type of the RP to be used for groups within 3114 this group prefix, or unknown(0) if no RP is to be used or 3115 if the RP address is unknown. This object must be 3116 unknown(0) if pimGroupMappingPimMode is ssm(2), or if 3117 pimGroupMappingOrigin is embedded(6)." 3118 ::= { pimGroupMappingEntry 5 } 3120 pimGroupMappingRPAddress OBJECT-TYPE 3121 SYNTAX InetAddress (SIZE (0|4|8|16|20)) 3122 MAX-ACCESS not-accessible 3123 STATUS current 3124 DESCRIPTION 3125 "The IP address of the RP to be used for groups within this 3126 group prefix. The InetAddressType is given by the 3127 pimGroupMappingRPAddressType object." 3128 ::= { pimGroupMappingEntry 6 } 3130 pimGroupMappingPimMode OBJECT-TYPE 3131 SYNTAX PimMode 3132 MAX-ACCESS read-only 3133 STATUS current 3134 DESCRIPTION 3135 "The PIM mode to be used for groups in this group prefix." 3136 ::= { pimGroupMappingEntry 7 } 3138 pimGroupMappingPrecedence OBJECT-TYPE 3139 SYNTAX Unsigned32 3140 MAX-ACCESS read-only 3141 STATUS current 3142 DESCRIPTION 3143 "The precedence of this row, used in the algorithm that 3144 determines which row applies to a given group address 3145 (described above). Numerically higher values for this 3146 object indicate lower precedences, with the value zero 3147 denoting the highest precedence. 3149 The absolute values of this object have a significance only 3150 on the local router and do not need to be coordinated with 3151 other routers." 3152 ::= { pimGroupMappingEntry 8 } 3154 -- 3155 -- PIM Traps 3156 -- 3158 pimNeighborLoss NOTIFICATION-TYPE 3159 OBJECTS { pimNeighborUpTime } 3160 STATUS current 3161 DESCRIPTION 3162 "A pimNeighborLoss trap signifies the loss of an adjacency 3163 with a neighbor. This trap should be generated when the 3164 neighbor timer expires, and the router has no other 3165 neighbors on the same interface with the same IP version and 3166 a lower IP address than itself. 3168 This notification is generated whenever the counter 3169 pimNeighborLossCount is incremented, subject 3170 to the rate limit specified by pimNeighborLossTrapPeriod." 3171 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.3.2" 3172 ::= { pimTraps 1 } 3174 pimInvalidRegister NOTIFICATION-TYPE 3175 OBJECTS { pimGroupMappingPimMode, 3176 pimInvalidRegisterAddressType, 3177 pimInvalidRegisterOrigin, 3178 pimInvalidRegisterGroup, 3179 pimInvalidRegisterRp 3180 } 3181 STATUS current 3182 DESCRIPTION 3183 "A pimInvalidRegister trap signifies that an invalid PIM 3184 Register message was received by this device. 3186 This notification is generated whenever the counter 3187 pimInvalidRegisterMsgsRcvd is incremented, subject to the 3188 rate limit specified by pimInvalidRegisterTrapPeriod." 3189 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.4.2" 3190 ::= { pimTraps 2 } 3192 pimInvalidJoinPrune NOTIFICATION-TYPE 3193 OBJECTS { pimGroupMappingPimMode, 3194 pimInvalidJoinPruneAddressType, 3195 pimInvalidJoinPruneOrigin, 3196 pimInvalidJoinPruneGroup, 3197 pimInvalidJoinPruneRp, 3198 pimNeighborUpTime 3200 } 3201 STATUS current 3202 DESCRIPTION 3203 "A pimInvalidJoinPrune trap signifies that an invalid PIM 3204 Join/Prune message was received by this device. 3206 This notification is generated whenever the counter 3207 pimInvalidJoinPruneMsgsRcvd is incremented, subject to the 3208 rate limit specified by pimInvalidJoinPruneTrapPeriod." 3209 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.5.2" 3210 ::= { pimTraps 3 } 3212 pimRPMappingChange NOTIFICATION-TYPE 3213 OBJECTS { pimGroupMappingPimMode, 3214 pimGroupMappingPrecedence 3215 } 3216 STATUS current 3217 DESCRIPTION 3218 "A pimRPMappingChange trap signifies a change to the active 3219 RP mapping on this device. 3221 This notification is generated whenever the counter 3222 pimRPMappingChangeCount is incremented, subject to the 3223 rate limit specified by pimRPMappingChangeTrapPeriod." 3224 ::= { pimTraps 4 } 3226 pimInterfaceElection NOTIFICATION-TYPE 3227 OBJECTS { pimInterfaceAddressType, 3228 pimInterfaceAddress } 3229 STATUS current 3230 DESCRIPTION 3231 "A pimInterfaceElection trap signifies that a new DR or DF 3232 has been elected on a network. 3234 This notification is generated whenever the counter 3235 pimInterfaceElectionsWinCount is incremented, subject to the 3236 rate limit specified by pimInterfaceElectionTrapPeriod." 3237 REFERENCE "I-D.ietf-pim-sm-v2-new section 4.3.2 and 3238 I-D.ietf-pim-bidir section 3.5.2" 3239 ::= { pimTraps 5 } 3241 -- 3242 -- Conformance Information 3243 -- 3245 pimMIBConformance OBJECT IDENTIFIER ::= { pimStdMIB 2 } 3246 pimMIBCompliances OBJECT IDENTIFIER ::= { pimMIBConformance 1 } 3247 pimMIBGroups OBJECT IDENTIFIER ::= { pimMIBConformance 2 } 3248 -- 3249 -- Compliance Statements 3250 -- 3252 pimMIBCompliance MODULE-COMPLIANCE 3253 STATUS current 3254 DESCRIPTION 3255 "The compliance statement for the PIM MIB." 3256 MODULE -- this module 3257 MANDATORY-GROUPS { pimTopologyGroup } 3259 GROUP pimNotificationGroup 3260 DESCRIPTION 3261 "This group is optional." 3263 GROUP pimTuningParametersGroup 3264 DESCRIPTION 3265 "This group is optional." 3267 GROUP pimRouterStatisticsGroup 3268 DESCRIPTION 3269 "This group is optional." 3271 GROUP pimSsmGroup 3272 DESCRIPTION 3273 "This group is optional." 3275 GROUP pimRPConfigGroup 3276 DESCRIPTION 3277 "This group is optional." 3279 GROUP pimSmGroup 3280 DESCRIPTION 3281 "This group is optional." 3283 GROUP pimBidirGroup 3284 DESCRIPTION 3285 "This group is optional." 3287 GROUP pimAnycastRpGroup 3288 DESCRIPTION 3289 "This group is optional." 3291 GROUP pimStaticRPPrecedenceGroup 3292 DESCRIPTION 3293 "This group is optional." 3295 GROUP pimNetMgmtNotificationObjects 3296 DESCRIPTION 3297 "This group is optional." 3299 GROUP pimNetMgmtNotificationGroup 3300 DESCRIPTION 3301 "This group is optional." 3303 GROUP pimDiagnosticsGroup 3304 DESCRIPTION 3305 "This group is optional." 3307 GROUP pimDmGroup 3308 DESCRIPTION 3309 "This group is optional." 3311 ::= { pimMIBCompliances 1 } 3313 -- 3314 -- Units of Conformance 3315 -- 3317 pimTopologyGroup OBJECT-GROUP 3318 OBJECTS { pimInterfaceAddressType, 3319 pimInterfaceAddress, 3320 pimInterfaceDR, 3321 pimInterfaceHelloHoldtime, 3322 pimInterfaceJoinPruneHoldtime, 3323 pimInterfaceGenerationIDValue, 3324 pimInterfaceLanDelayEnabled, 3325 pimInterfaceEffectPropagDelay, 3326 pimInterfaceEffectOverrideIvl, 3327 pimInterfaceSuppressionEnabled, 3328 pimInterfaceBidirCapable, 3329 pimInterfaceDRPriorityEnabled, 3330 pimNeighborUpTime, 3331 pimNeighborExpiryTime, 3332 pimNeighborLanPruneDelayPresent, 3333 pimNeighborPropagationDelay, 3334 pimNeighborOverrideInterval, 3335 pimNeighborTBit, 3336 pimNeighborGenerationIDPresent, 3337 pimNeighborGenerationIDValue, 3338 pimNeighborBidirCapable, 3339 pimNeighborDRPriorityPresent, 3340 pimNeighborDRPriority, 3341 pimNbrSecAddress 3342 } 3343 STATUS current 3344 DESCRIPTION 3345 "A collection of read-only objects used to report local PIM 3346 topology." 3347 ::= { pimMIBGroups 1 } 3349 pimNotificationGroup NOTIFICATION-GROUP 3350 NOTIFICATIONS { pimNeighborLoss } 3351 STATUS current 3352 DESCRIPTION 3353 "A collection of notifications for signaling important PIM 3354 events." 3355 ::= { pimMIBGroups 2 } 3357 pimTuningParametersGroup OBJECT-GROUP 3358 OBJECTS { pimKeepalivePeriod, 3359 pimRegisterSuppressionTime, 3360 pimInterfaceHelloInterval, 3361 pimInterfaceTrigHelloInterval, 3362 pimInterfaceJoinPruneInterval, 3363 pimInterfacePropagationDelay, 3364 pimInterfaceOverrideInterval, 3365 pimInterfaceDRPriority, 3366 pimInterfaceDomainBorder, 3367 pimInterfaceStatus, 3368 pimInterfaceStubInterface 3369 } 3370 STATUS current 3371 DESCRIPTION 3372 "A collection of writeable objects used to configure PIM 3373 behavior and to tune performance." 3374 ::= { pimMIBGroups 3 } 3376 pimRouterStatisticsGroup OBJECT-GROUP 3377 OBJECTS { pimStarGEntries, 3378 pimStarGIEntries, 3379 pimSGEntries, 3380 pimSGIEntries, 3381 pimSGRptEntries, 3382 pimSGRptIEntries 3383 } 3384 STATUS current 3385 DESCRIPTION 3386 "A collection of statistics global to the PIM router." 3387 ::= { pimMIBGroups 4 } 3389 pimSsmGroup OBJECT-GROUP 3390 OBJECTS { pimSGUpTime, 3391 pimSGPimMode, 3392 pimSGUpstreamJoinState, 3393 pimSGUpstreamJoinTimer, 3394 pimSGUpstreamNeighbor, 3395 pimSGRPFIfIndex, 3396 pimSGRPFNextHopType, 3397 pimSGRPFNextHop, 3398 pimSGRPFRouteProtocol, 3399 pimSGRPFRouteAddress, 3400 pimSGRPFRoutePrefixLength, 3401 pimSGRPFRouteMetricPref, 3402 pimSGRPFRouteMetric, 3403 pimSGSPTBit, 3404 pimSGKeepaliveTimer, 3405 pimSGDRRegisterState, 3406 pimSGDRRegisterStopTimer, 3407 pimSGRPRegisterPMBRAddressType, 3408 pimSGRPRegisterPMBRAddress, 3409 pimSGIUpTime, 3410 pimSGILocalMembership, 3411 pimSGIJoinPruneState, 3412 pimSGIPrunePendingTimer, 3413 pimSGIJoinExpiryTimer, 3414 pimSGIAssertState, 3415 pimSGIAssertTimer, 3416 pimSGIAssertWinnerAddressType, 3417 pimSGIAssertWinnerAddress, 3418 pimSGIAssertWinnerMetricPref, 3419 pimSGIAssertWinnerMetric 3420 } 3421 STATUS current 3422 DESCRIPTION 3423 "A collection of objects to support management of PIM 3424 routers running the PIM SSM (Source Specific Multicast) 3425 protocol, in PIM mode SM (Sparse Mode)." 3426 ::= { pimMIBGroups 5 } 3428 pimRPConfigGroup OBJECT-GROUP 3429 OBJECTS { pimStaticRPRPAddress, 3430 pimStaticRPPimMode, 3431 pimStaticRPOverrideDynamic, 3432 pimStaticRPRowStatus, 3433 pimGroupMappingPimMode, 3434 pimGroupMappingPrecedence 3435 } 3436 STATUS current 3437 DESCRIPTION 3438 "A collection of objects to support configuration of RPs 3439 (Rendezvous Points) and Group Mappings." 3441 ::= { pimMIBGroups 6 } 3443 pimSmGroup OBJECT-GROUP 3444 OBJECTS { pimStarGUpTime, 3445 pimStarGPimMode, 3446 pimStarGRPAddressType, 3447 pimStarGRPAddress, 3448 pimStarGPimModeOrigin, 3449 pimStarGRPIsLocal, 3450 pimStarGUpstreamJoinState, 3451 pimStarGUpstreamJoinTimer, 3452 pimStarGUpstreamNeighborType, 3453 pimStarGUpstreamNeighbor, 3454 pimStarGRPFIfIndex, 3455 pimStarGRPFNextHopType, 3456 pimStarGRPFNextHop, 3457 pimStarGRPFRouteProtocol, 3458 pimStarGRPFRouteAddress, 3459 pimStarGRPFRoutePrefixLength, 3460 pimStarGRPFRouteMetricPref, 3461 pimStarGRPFRouteMetric, 3462 pimStarGIUpTime, 3463 pimStarGILocalMembership, 3464 pimStarGIJoinPruneState, 3465 pimStarGIPrunePendingTimer, 3466 pimStarGIJoinExpiryTimer, 3467 pimStarGIAssertState, 3468 pimStarGIAssertTimer, 3469 pimStarGIAssertWinnerAddressType, 3470 pimStarGIAssertWinnerAddress, 3471 pimStarGIAssertWinnerMetricPref, 3472 pimStarGIAssertWinnerMetric, 3473 pimSGRptUpTime, 3474 pimSGRptUpstreamPruneState, 3475 pimSGRptUpstreamOverrideTimer, 3476 pimSGRptIUpTime, 3477 pimSGRptILocalMembership, 3478 pimSGRptIJoinPruneState, 3479 pimSGRptIPrunePendingTimer, 3480 pimSGRptIPruneExpiryTimer 3481 } 3482 STATUS current 3483 DESCRIPTION 3484 "A collection of objects to support management of PIM 3485 routers running PIM-SM (Sparse Mode). The groups 3486 pimSsmGroup and pimRPConfigGroup are also required." 3487 ::= { pimMIBGroups 7 } 3489 pimBidirGroup OBJECT-GROUP 3490 OBJECTS { pimInterfaceDFElectionRobustness, 3491 pimBidirDFElectionWinnerAddressType, 3492 pimBidirDFElectionWinnerAddress, 3493 pimBidirDFElectionWinnerUpTime, 3494 pimBidirDFElectionWinnerMetricPref, 3495 pimBidirDFElectionWinnerMetric, 3496 pimBidirDFElectionState, 3497 pimBidirDFElectionStateTimer 3498 } 3499 STATUS current 3500 DESCRIPTION 3501 "A collection of objects to support management of PIM 3502 routers running BIDIR mode. The groups pimSsmGroup, 3503 pimSmGroup and pimRPConfigGroup are also required." 3504 ::= { pimMIBGroups 8 } 3506 pimAnycastRpGroup OBJECT-GROUP 3507 OBJECTS { pimAnycastRPSetRowStatus, 3508 pimAnycastRPSetLocalRouter 3509 } 3510 STATUS current 3511 DESCRIPTION 3512 "A collection of objects to support management of the PIM 3513 Anycast-RP mechanism." 3514 ::= { pimMIBGroups 9 } 3516 pimStaticRPPrecedenceGroup OBJECT-GROUP 3517 OBJECTS { pimStaticRPPrecedence } 3518 STATUS current 3519 DESCRIPTION 3520 "A collection of objects to allow fine control of 3521 interactions between static RP configuration and 3522 dynamically acquired group to RP mappings." 3523 ::= { pimMIBGroups 10 } 3525 pimNetMgmtNotificationObjects OBJECT-GROUP 3526 OBJECTS { pimInvalidRegisterTrapPeriod, 3527 pimInvalidRegisterMsgsRcvd, 3528 pimInvalidRegisterAddressType, 3529 pimInvalidRegisterOrigin, 3530 pimInvalidRegisterGroup, 3531 pimInvalidRegisterRp, 3532 pimInvalidJoinPruneTrapPeriod, 3533 pimInvalidJoinPruneMsgsRcvd, 3534 pimInvalidJoinPruneAddressType, 3535 pimInvalidJoinPruneOrigin, 3536 pimInvalidJoinPruneGroup, 3537 pimInvalidJoinPruneRp, 3538 pimRPMappingTrapPeriod, 3539 pimRPMappingChangeCount, 3540 pimInterfaceElectionTrapPeriod, 3541 pimInterfaceElectionWinCount 3542 } 3543 STATUS current 3544 DESCRIPTION 3545 "A collection of objects to support notification of PIM 3546 network management events." 3547 ::= { pimMIBGroups 11 } 3549 pimNetMgmtNotificationGroup NOTIFICATION-GROUP 3550 NOTIFICATIONS { pimInvalidRegister, 3551 pimInvalidJoinPrune, 3552 pimRPMappingChange, 3553 pimInterfaceElection 3554 } 3555 STATUS current 3556 DESCRIPTION 3557 "A collection of notifications for signaling PIM network 3558 management events." 3559 ::= { pimMIBGroups 12 } 3561 pimDiagnosticsGroup OBJECT-GROUP 3562 OBJECTS { pimInAsserts, 3563 pimOutAsserts, 3564 pimLastAssertInterface, 3565 pimLastAssertGroupAddressType, 3566 pimLastAssertGroupAddress, 3567 pimLastAssertSourceAddressType, 3568 pimLastAssertSourceAddress, 3569 pimNeighborLossTrapPeriod, 3570 pimNeighborLossCount 3571 } 3572 STATUS current 3573 DESCRIPTION 3574 "Objects providing additonal diagnostics related to a PIM 3575 router." 3576 ::= { pimMIBGroups 13 } 3578 pimDmGroup OBJECT-GROUP 3579 OBJECTS { 3580 pimRefreshInterval, 3581 pimInterfacePruneLimitInterval, 3582 pimInterfaceGraftRetryInterval, 3583 pimInterfaceSRPriorityEnabled, 3584 pimNeighborSRCapable, 3585 pimSGUpstreamPruneState, 3586 pimSGUpstreamPruneLimitTimer, 3587 pimSGOriginatorState, 3588 pimSGSourceActiveTimer, 3589 pimSGStateRefreshTimer 3590 } 3591 STATUS current 3592 DESCRIPTION 3593 "A collection of objects required for management of PIM 3594 Dense Mode (PIM-DM) function. The groups pimSsmGroup and 3595 pimSmGroup are also required." 3596 REFERENCE "RFC 3973" 3597 ::= { pimMIBGroups 14 } 3599 END 3601 5. Security Considerations 3603 There are a number of management objects defined in this MIB module 3604 with a MAX-ACCESS clause of read-write and/or read-create. Such 3605 objects may be considered sensitive or vulnerable in some network 3606 environments. The support for SET operations in a non-secure 3607 environment without proper protection can have a negative effect on 3608 network operations. These are the tables and objects and their 3609 sensitivity/vulnerability: 3611 The following tables and objects could be employed to modify 3612 multicast routing behavior in a way that prevents, disrupts, or 3613 subverts services provided by the network, including (but not limited 3614 to) multicast data traffic delivery. For example, attacks can be 3615 envisaged that would pass nominated multicast data streams through a 3616 nominated location, without the sources or listeners becoming aware 3617 of this subversion. 3619 pimKeepalivePeriod pimRegisterSuppressionTime 3620 pimNeighborLossTrapPeriod 3621 pimInvalidRegisterTrapPeriod 3622 pimInvalidJoinPruneTrapPeriod pimRPMappingTrapPeriod 3623 pimInterfaceElectionTrapPeriod pimRefreshInterval 3624 pimInterfaceTable pimInterfaceEntry 3625 pimInterfaceIfIndex pimInterfaceIPVersion 3626 pimInterfaceHelloInterval 3627 pimInterfaceTrigHelloInterval 3628 pimInterfaceJoinPruneInterval 3629 pimInterfaceDFElectionRobustness pimInterfaceHelloHoldtime 3630 pimInterfaceJoinPruneHoldtime 3631 pimInterfacePropagationDelay 3632 pimInterfaceOverrideInterval pimInterfaceDRPriority 3633 pimInterfaceDomainBorder pimInterfaceStatus 3634 pimInterfaceStubInterface 3635 pimInterfacePruneLimitInterval pimStaticRPTable 3636 pimStaticRPEntry pimStaticRPAddressType 3637 pimStaticRPGrpAddress pimStaticRPGrpPrefixLength 3638 pimStaticRPRPAddress pimStaticRPPimMode 3639 pimStaticRPOverrideDynamic pimStaticRPRowStatus 3640 pimStaticRPPrecedence pimAnycastRPSetTable 3641 pimAnycastRPSetEntry pimAnycastRPSetAddressType 3642 pimAnycastRPSetAnycastAddress 3643 pimAnycastRPSetRouterAddress 3645 Some of the readable objects in this MIB module (i.e., objects with a 3646 MAX-ACCESS other than not-accessible) may be considered sensitive or 3647 vulnerable in some network environments. It is thus important to 3648 control even GET and/or NOTIFY access to these objects and possibly 3649 to even encrypt the values of these objects when sending them over 3650 the network via SNMP. These are the tables and objects and their 3651 sensitivity/vulnerability: 3653 The following tables and objects could be employed to determine the 3654 topology, disposition, and composition of the network. This 3655 information may be commercially sensitive, and may also be used in 3656 preparation for attacks, including any of the attacks described 3657 above. 3659 The following tables and objects may also be used to determine 3660 whether multicast data is flowing in the network, or has flowed 3661 recently. They may also be used to determine the network location of 3662 senders and recipients. An attacker can apply 'traffic analysis' to 3663 this data. In some cases, the information revealed by traffic 3664 analyses can be as damaging as full knowledge of the data being 3665 transported. 3667 pimKeepalivePeriod 3668 pimRegisterSuppressionTime 3669 pimStarGEntries 3670 pimStarGIEntries 3671 pimSGEntries 3672 pimSGIEntries 3673 pimSGRptEntries 3674 pimSGRptIEntries 3675 pimOutAsserts 3676 pimInAsserts 3677 pimLastAssertInterface 3678 pimLastAssertGroupAddressType 3679 pimLastAssertGroupAddress 3680 pimLastAssertSourceAddressType 3681 pimLastAssertSourceAddress 3682 pimNeighborLossTrapPeriod 3683 pimNeighborLossCount 3684 pimInvalidRegisterTrapPeriod 3685 pimInvalidRegisterMsgsRcvd 3686 pimInvalidRegisterAddressType 3687 pimInvalidRegisterOrigin 3688 pimInvalidRegisterGroup 3689 pimInvalidRegisterRp 3690 pimInvalidJoinPruneTrapPeriod 3691 pimInvalidJoinPruneMsgsRcvd 3692 pimInvalidJoinPruneAddressType 3693 pimInvalidJoinPruneOrigin 3694 pimInvalidJoinPruneGroup 3695 pimInvalidJoinPruneRp 3696 pimRPMappingTrapPeriod 3697 pimRPMappingChangeCount 3698 pimInterfaceElectionTrapPeriod 3699 pimInterfaceElectionWinCount 3700 pimRefreshInterval 3701 pimInterfaceTable 3702 pimInterfaceEntry 3703 pimInterfaceIfIndex 3704 pimInterfaceIPVersion 3705 pimInterfaceAddressType 3706 pimInterfaceAddress 3707 pimInterfaceDR 3708 pimInterfaceHelloInterval 3709 pimInterfaceTrigHelloInterval 3710 pimInterfaceJoinPruneInterval 3711 pimInterfaceDFElectionRobustness 3712 pimInterfaceHelloHoldtime 3713 pimInterfaceJoinPruneHoldtime 3714 pimInterfacePropagationDelay 3715 pimInterfaceOverrideInterval 3716 pimInterfaceGenerationIDValue 3717 pimInterfaceDRPriority 3718 pimInterfaceLanDelayEnabled 3719 pimInterfaceEffectPropagDelay 3720 pimInterfaceEffectOverrideIvl 3721 pimInterfaceSuppressionEnabled 3722 pimInterfaceBidirCapable 3723 pimInterfaceDRPriorityEnabled 3724 pimInterfaceDomainBorder 3725 pimInterfaceStatus 3726 pimInterfaceStubInterface 3727 pimInterfacePruneLimitInterval 3728 pimInterfaceSRPriorityEnabled 3729 pimNeighborTable 3730 pimNeighborEntry 3731 pimNeighborIfIndex 3732 pimNeighborAddressType 3733 pimNeighborAddress 3734 pimNeighborUpTime 3735 pimNeighborExpiryTime 3736 pimNeighborLanPruneDelayPresent 3737 pimNeighborPropagationDelay 3738 pimNeighborOverrideInterval 3739 pimNeighborTBit 3740 pimNeighborGenerationIDPresent 3741 pimNeighborGenerationIDValue 3742 pimNeighborBidirCapable 3743 pimNeighborDRPriorityPresent 3744 pimNeighborDRPriority 3745 pimNeighborSRCapable 3746 pimNbrSecAddressTable 3747 pimNbrSecAddressEntry 3748 pimNbrSecAddressIfIndex 3749 pimNbrSecAddressType 3750 pimNbrSecAddressPrimary 3751 pimNbrSecAddress 3752 pimStarGTable 3753 pimStarGEntry 3754 pimStarGAddressType 3755 pimStarGGrpAddress 3756 pimStarGUpTime 3757 pimStarGPimMode 3758 pimStarGRPAddressType 3759 pimStarGRPAddress 3760 pimStarGPimModeOrigin 3761 pimStarGRPIsLocal 3762 pimStarGUpstreamJoinState 3763 pimStarGUpstreamJoinTimer 3764 pimStarGUpstreamNeighborType 3765 pimStarGUpstreamNeighbor 3766 pimStarGRPFIfIndex 3767 pimStarGRPFNextHopType 3768 pimStarGRPFNextHop 3769 pimStarGRPFRouteProtocol 3770 pimStarGRPFRouteAddress 3771 pimStarGRPFRoutePrefixLength 3772 pimStarGRPFRouteMetricPref 3773 pimStarGRPFRouteMetric 3774 pimStarGITable 3775 pimStarGIEntry 3776 pimStarGIIfIndex 3777 pimStarGIUpTime 3778 pimStarGILocalMembership 3779 pimStarGIJoinPruneState 3780 pimStarGIPrunePendingTimer 3781 pimStarGIJoinExpiryTimer 3782 pimStarGIAssertState 3783 pimStarGIAssertTimer 3784 pimStarGIAssertWinnerAddressType 3785 pimStarGIAssertWinnerAddress 3786 pimStarGIAssertWinnerMetricPref 3787 pimStarGIAssertWinnerMetric 3788 pimSGTable 3789 pimSGEntry 3790 pimSGAddressType 3791 pimSGGrpAddress 3792 pimSGSrcAddress 3793 pimSGUpTime 3794 pimSGPimMode 3795 pimSGUpstreamJoinState 3796 pimSGUpstreamJoinTimer 3797 pimSGUpstreamNeighbor 3798 pimSGRPFIfIndex 3799 pimSGRPFNextHopType 3800 pimSGRPFNextHop 3801 pimSGRPFRouteProtocol 3802 pimSGRPFRouteAddress 3803 pimSGRPFRoutePrefixLength 3804 pimSGRPFRouteMetricPref 3805 pimSGRPFRouteMetric 3806 pimSGSPTBit 3807 pimSGKeepaliveTimer 3808 pimSGDRRegisterState 3809 pimSGDRRegisterStopTimer 3810 pimSGRPRegisterPMBRAddressType 3811 pimSGRPRegisterPMBRAddress 3812 pimSGUpstreamPruneState 3813 pimSGUpstreamPruneLimitTimer 3814 pimSGOriginatorState 3815 pimSGSourceActiveTimer 3816 pimSGStateRefreshTimer 3817 pimSGITable 3818 pimSGIEntry 3819 pimSGIIfIndex 3820 pimSGIUpTime 3821 pimSGILocalMembership 3822 pimSGIJoinPruneState 3823 pimSGIPrunePendingTimer 3824 pimSGIJoinExpiryTimer 3825 pimSGIAssertState 3826 pimSGIAssertTimer 3827 pimSGIAssertWinnerAddressType 3828 pimSGIAssertWinnerAddress 3829 pimSGIAssertWinnerMetricPref 3830 pimSGIAssertWinnerMetric 3831 pimSGRptTable 3832 pimSGRptEntry 3833 pimSGRptSrcAddress 3834 pimSGRptUpTime 3835 pimSGRptUpstreamPruneState 3836 pimSGRptUpstreamOverrideTimer 3837 pimSGRptITable 3838 pimSGRptIEntry 3839 pimSGRptIIfIndex 3840 pimSGRptIUpTime 3841 pimSGRptILocalMembership 3842 pimSGRptIJoinPruneState 3843 pimSGRptIPrunePendingTimer 3844 pimSGRptIPruneExpiryTimer 3845 pimBidirDFElectionTable 3846 pimBidirDFElectionEntry 3847 pimBidirDFElectionAddressType 3848 pimBidirDFElectionRPAddress 3849 pimBidirDFElectionIfIndex 3850 pimBidirDFElectionWinnerAddressType 3851 pimBidirDFElectionWinnerAddress 3852 pimBidirDFElectionWinnerUpTime 3853 pimBidirDFElectionWinnerMetricPref 3854 pimBidirDFElectionWinnerMetric 3855 pimBidirDFElectionState 3856 pimBidirDFElectionStateTimer 3857 pimStaticRPTable 3858 pimStaticRPEntry 3859 pimStaticRPAddressType 3860 pimStaticRPGrpAddress 3861 pimStaticRPGrpPrefixLength 3862 pimStaticRPRPAddress 3863 pimStaticRPPimMode 3864 pimStaticRPOverrideDynamic 3865 pimStaticRPRowStatus 3866 pimStaticRPPrecedence 3867 pimAnycastRPSetTable 3868 pimAnycastRPSetEntry 3869 pimAnycastRPSetAddressType 3870 pimAnycastRPSetAnycastAddress 3871 pimAnycastRPSetRouterAddress 3872 pimAnycastRPSetRowStatus 3873 pimAnycastRPSetLocalRouter 3874 pimGroupMappingTable 3875 pimGroupMappingEntry 3876 pimGroupMappingOrigin 3877 pimGroupMappingAddressType 3878 pimGroupMappingGrpAddress 3879 pimGroupMappingGrpPrefixLength 3880 pimGroupMappingRPAddress 3881 pimGroupMappingPimMode 3882 pimGroupMappingPrecedence 3884 There is also a specific danger arising from the notification 3885 pimInvalidRegister. This is originated by devices that receive an 3886 incorrect unicast-encapsulted multicast data packet, which poses a 3887 clear danger of propagating a DoS (Denial of Service) attack from the 3888 data or control plane to the network management plane. The following 3889 steps are taken to guard against this. 3891 1. The notification is disabled by default. The writeable field 3892 pimInvalidRegisterTrapPeriod must be set in order to enable it. 3894 2. The syntax of pimInvalidRegisterTrapPeriod prevents any given 3895 device from originating the notification more frequently than 3896 once every 10 seconds. 3898 3. The counter pimInvalidRegisterMsgsRcvd provides equivalent 3899 function to the notification. Management applications are 3900 encouraged to monitor this counter in preference to enabling the 3901 notification. 3903 The same measures are taken in respect of pimInvalidJoinPrune, though 3904 as this notification can only arise as a result of non-routable 3905 control packets, the risk is not so acute. 3907 SNMP versions prior to SNMPv3 did not include adequate security. 3908 Even if the network itself is secure (for example by using IPSec), 3909 even then, there is no control as to who on the secure network is 3910 allowed to access and GET/SET (read/change/create/delete) the objects 3911 in this MIB module. 3913 It is RECOMMENDED that implementers consider the security features as 3914 provided by the SNMPv3 framework (see [RFC3410], section 8), 3915 including full support for the SNMPv3 cryptographic mechanisms (for 3916 authentication and privacy). 3918 Further, deployment of SNMP versions prior to SNMPv3 is NOT 3919 RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to 3920 enable cryptographic security. It is then a customer/operator 3921 responsibility to ensure that the SNMP entity giving access to an 3922 instance of this MIB module is properly configured to give access to 3923 the objects only to those principals (users) that have legitimate 3924 rights to indeed GET or SET (change/create/delete) them. 3926 6. IANA Considerations 3928 PIM-STD-MIB should be rooted under the mib-2 subtree. IANA is 3929 requested to assign { mib-2 XXX } to the PIM-STD-MIB module specified 3930 in this document. 3932 7. Acknowledgements 3934 This MIB module is based on the original work in RFC 2934 [RFC2934] 3935 by K. McCloghrie, D. Farinacci, D. Thaler and W. Fenner and has been 3936 updated based on feedback from the IETF's Protocol Independent 3937 Multicast (PIM) Working Group. 3939 Jonathan Nicholas was the editor of early versions of this document, 3940 and contributed the objects for management of PIM-DM. 3942 8. References 3944 8.1 Normative References 3946 [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate 3947 Requirement Levels", BCP 14, RFC 2119, March 1997. 3949 [RFC2434] Narten, T. and H. Alvestrand, "Guidelines for Writing an 3950 IANA Considerations Section in RFCs", BCP 26, RFC 2434, 3951 October 1998. 3953 [RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J. 3954 Schoenwaelder, Ed., "Structure of Management Information 3955 Version 2 (SMIv2)", STD 58, RFC 2578, April 1999. 3957 [RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J. 3958 Schoenwaelder, Ed., "Textual Conventions for SMIv2", 3959 STD 58, RFC 2579, April 1999. 3961 [RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder, 3962 "Conformance Statements for SMIv2", STD 58, RFC 2580, 3963 April 1999. 3965 [RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group 3966 MIB", RFC 2863, June 2000. 3968 [RFC3569] Bhattacharyya, S., "An Overview of Source-Specific 3969 Multicast (SSM)", RFC 3569, July 2003. 3971 [RFC3956] Savola, P. and B. Haberman, "Embedding the Rendezvous 3972 Point (RP) Address in an IPv6 Multicast Address", 3973 RFC 3956, November 2004. 3975 [RFC3973] Adams, A., Nicholas, J., and W. Siadak, "Protocol 3976 Independent Multicast - Dense Mode (PIM-DM): Protocol 3977 Specification (Revised)", RFC 3973, January 2005. 3979 [RFC4001] Daniele, M., Haberman, B., Routhier, S., and J. 3980 Schoenwaelder, "Textual Conventions for Internet Network 3981 Addresses", RFC 4001, February 2005. 3983 [I-D.ietf-pim-sm-v2-new] 3984 Fenner, B., Handley, M., Holbrook, H., and I. Kouvelas, 3985 "Protocol Independent Multicast - Sparse Mode PIM-SM): 3986 Protocol Specification (Revised)", 3987 draft-ietf-pim-sm-v2-new-12 (work in progress), 3988 March 2006. 3990 [I-D.ietf-pim-bidir] 3991 Handley, M., Kouvelas, I., Speakman, T., and L. Vicisano, 3992 "Bi-directional Protocol Independent Multicast (BIDIR- 3993 PIM)", draft-ietf-pim-bidir-08 (work in progress), 3994 October 2005. 3996 [I-D.ietf-pim-sm-bsr] 3997 Bhaskar, N., "Bootstrap Router (BSR) Mechanism for PIM", 3998 draft-ietf-pim-sm-bsr-07 (work in progress), 3999 March 2006. 4001 [I-D.ietf-pim-anycast-rp] 4002 Farinacci, D., and Cai, Y., "Anycast-RP using PIM", 4003 draft-ietf-pim-anycast-rp-07 (work in progress), 4004 February 2006. 4006 [I-D.ietf-mboned-ip-mcast-mib] 4007 McWalter, D., Thaler, D., and Kessler, A., 4008 "IP Multicast MIB" draft-ietf-mboned-ip-mcast-mib-00, 4009 (work in progress), April 2006. 4011 8.2 Informative References 4013 [RFC2932] McCloghrie, K., Farinacci, D., and D. Thaler, "IPv4 4014 Multicast Routing MIB", RFC 2932, October 2000. 4016 [RFC2934] McCloghrie, K., Farinacci, D., Thaler, D., and B. Fenner, 4017 "Protocol Independent Multicast MIB for IPv4", RFC 2934, 4018 October 2000. 4020 [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, 4021 "Introduction and Applicability Statements for Internet- 4022 Standard Management Framework", RFC 3410, December 2002. 4024 Authors' Addresses 4026 Raghava Sivaramu 4027 Cisco Systems 4028 425 E. Tasman Drive 4029 San Jose CA 95134 4030 USA 4032 Email: raghava@cisco.com 4034 James Lingard 4035 Data Connection Ltd 4036 100 Church Street 4037 Enfield EN2 6BQ 4038 United Kingdom 4040 Email: james.lingard@dataconnection.com 4042 David McWalter 4043 Data Connection Ltd 4044 100 Church Street 4045 Enfield EN2 6BQ 4046 United Kingdom 4048 Email: dmcw@dataconnection.com 4050 Bharat Joshi 4051 Infosys Technologies Ltd 4052 Electronic City 4053 Bangalore 560 100 4054 India 4056 Email: bharat_joshi@infosys.com 4058 Intellectual Property Statement 4060 The IETF takes no position regarding the validity or scope of any 4061 Intellectual Property Rights or other rights that might be claimed to 4062 pertain to the implementation or use of the technology described in 4063 this document or the extent to which any license under such rights 4064 might or might not be available; nor does it represent that it has 4065 made any independent effort to identify any such rights. Information 4066 on the procedures with respect to rights in RFC documents can be 4067 found in BCP 78 and BCP 79. 4069 Copies of IPR disclosures made to the IETF Secretariat and any 4070 assurances of licenses to be made available, or the result of an 4071 attempt made to obtain a general license or permission for the use of 4072 such proprietary rights by implementers or users of this 4073 specification can be obtained from the IETF on-line IPR repository at 4074 http://www.ietf.org/ipr. 4076 The IETF invites any interested party to bring to its attention any 4077 copyrights, patents or patent applications, or other proprietary 4078 rights that may cover technology that may be required to implement 4079 this standard. Please address the information to the IETF at 4080 ietf-ipr@ietf.org. 4082 Disclaimer of Validity 4084 This document and the information contained herein are provided on an 4085 "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS 4086 OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET 4087 ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, 4088 INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE 4089 INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED 4090 WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 4092 Copyright Statement 4094 Copyright (C) The Internet Society (2006). This document is subject 4095 to the rights, licenses and restrictions contained in BCP 78, and 4096 except as set forth therein, the authors retain all their rights. 4098 Acknowledgment 4100 Funding for the RFC Editor function is currently provided by the 4101 Internet Society.