< draft-ietf-pim-mib-v2-01.txt   draft-ietf-pim-mib-v2-02.txt >
Internet Engineering Task Force PIM-WG
INTERNET-DRAFT Editor
draft-ietf-pim-mib-v2-01.txt Jonathan Nicholas
ITT A/CD
November 2002
Expires May 2003
Protocol Independent Multicast MIB PIM WG R. Sivaramu
Internet-Draft Cisco Systems
Expires: October 31, 2005 J. Lingard
Data Connection Ltd
B. Joshi
Infosys Technologies Ltd
April 29, 2005
Status of this Document Protocol Independent Multicast MIB
draft-ietf-pim-mib-v2-02.txt
This document is an Internet-Draft and is in full conformance with all Status of this Memo
provisions of Section 10 of RFC2026.
Internet-Drafts are working documents of the Internet Engineering Task By submitting this Internet-Draft, each author represents that any
Force (IETF), its areas, and its working groups. Note that other groups applicable patent or other IPR claims of which he or she is aware
may also distribute working documents as Internet-Drafts. have been or will be disclosed, and any of which he or she becomes
aware will be disclosed, in accordance with Section 6 of BCP 79.
Internet-Drafts are draft documents valid for a maximum of six months Internet-Drafts are working documents of the Internet Engineering
and may be updated, replaced, or obsoleted by other documents at any Task Force (IETF), its areas, and its working groups. Note that
time. It is inappropriate to use Internet- Drafts as reference material other groups may also distribute working documents as Internet-
or to cite them other than as "work in progress." Drafts.
The list of current Internet-Drafts can be accessed at Internet-Drafts are draft documents valid for a maximum of six months
http://www.ietf.org/ietf/1id-abstracts.txt and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress."
The list of Internet-Draft Shadow Directories can be accessed at The list of current Internet-Drafts can be accessed at
http://www.ietf.org/shadow.html. http://www.ietf.org/ietf/1id-abstracts.txt.
This document is a product of the IETF PIM WG. Comments should be The list of Internet-Draft Shadow Directories can be accessed at
addressed to the authors, or the WG's mailing list at http://www.ietf.org/shadow.html.
pim@catarina.usc.edu.
Abstract This Internet-Draft will expire on October 31, 2005.
This memo defines a portion of the Management Information Base (MIB) for Copyright Notice
use with network management protocols in the Internet community. In
particular, it describes managed objects used for managing the Protocol
Independent Multicast (PIM) protocol.
Table of Contents Copyright (C) The Internet Society (2005).
1 Introduction ................................................. 2 Abstract
2 The SNMP Network Management Framework ........................ 2
3 Overview ..................................................... 3 This memo defines a portion of the Management Information Base (MIB)
4 Definitions .................................................. 4 for use with network management protocols in the Internet community.
5 Security Considerations ...................................... 29 In particular, it describes managed objects used for managing the
6 Acknowledgements ............................................. 30 Protocol Independent Multicast (PIM) protocols (PIM-SM and BIDIR-
7 Authors' Addresses ........................................... 30 PIM). This document obsoletes RFC 2934.
8 References ................................................... 30
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3
2. The Internet-Standard Management Framework . . . . . . . . . . 3
3. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
4. Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 4
5. Security Considerations . . . . . . . . . . . . . . . . . . . 39
6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 40
7. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 40
8. References . . . . . . . . . . . . . . . . . . . . . . . . . . 40
8.1 Normative References . . . . . . . . . . . . . . . . . . . 40
8.2 Informative References . . . . . . . . . . . . . . . . . . 41
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . 41
Intellectual Property and Copyright Statements . . . . . . . . 43
1. Introduction 1. Introduction
This memo defines a portion of the Management Information Base (MIB) for This memo defines a portion of the Management Information Base (MIB)
use with network management protocols in the Internet community. In for use with network management protocols in the Internet community.
particular, it describes managed objects used for managing the Protocol In particular, it describes managed objects used for managing the
Independent Multicast (PIM) protocol [18,19]. Protocol Independent Multicast (PIM) protocols (PIM-SM [I-D.ietf-pim-
sm-v2-new] and BIDIR-PIM [I-D.ietf-pim-bidir]).
2. The SNMP Network Management Framework This document obsoletes RFC 2934 [RFC2934]. RFC 2934 defined an
experimental MIB module for managing the PIM protocols. The MIB
module defined by this document is a complete re-working of the MIB
module from RFC 2934, with major changes that include the following.
The SNMP Management Framework presently consists of five major o This MIB module is independent of IP version, whereas RFC 2934
components: only supported IPv4.
* An overall architecture, described in RFC 2571 [1]. o This MIB module includes support for managing BIDIR-PIM.
* Mechanisms for describing and naming objects and events for the o This MIB module does not include support for managing PIM-DM.
purpose of management. The first version of this Structure of
Management Information (SMI) is called SMIv1 and described in STD 16,
RFC 1155 [2], STD 16, RFC 1212 [3] and RFC 1215 [4]. The second
version, called SMIv2, is described in STD 58, RFC 2578 [5], STD 58,
RFC 2579 [6] and STD 58, RFC 2580 [7].
* Message protocols for transferring management information. The first o This MIB module does not include support for managing PIM-SM v1.
version of the SNMP message protocol is called SNMPv1 and described
in STD 15, RFC 1157 [8]. A second version of the SNMP message
protocol, which is not an Internet standards track protocol, is called
SNMPv2c and described in RFC 1901 [9] and RFC 1906 [10]. The third
version of the message protocol is called SNMPv3 and described in
RFC 1906 [10], RFC 2572 [11] and RFC 2574 [12].
* Protocol operations for accessing management information. The first o This MIB module does not depend on the IPv4 Multicast Routing MIB
set of protocol operations and associated PDU formats is described in defined in RFC 2932 [RFC2932].
STD 15, RFC 1157 [8]. A second set of protocol operations and
associated PDU formats is described in RFC 1905 [13].
* A set of fundamental applications described in RFC 2573 [14] and the The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
view-based access control mechanism described in RFC 2575 [15]. "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in RFC 2119 [RFC2119].
Managed objects are accessed via a virtual information store, termed the 2. The Internet-Standard Management Framework
Management Information Base or MIB. Objects in the MIB are defined
using the mechanisms defined in the SMI.
This memo specifies a MIB module that is compliant to the SMIv2. A MIB For a detailed overview of the documents that describe the current
conforming to the SMIv1 can be produced through the appropriate Internet-Standard Management Framework, please refer to section 7 of
translations. The resulting translated MIB must be semantically RFC 3410 [RFC3410].
equivalent, except where objects or events are omitted because no
translation is possible (use of Counter64). Some machine readable Managed objects are accessed via a virtual information store, termed
information in SMIv2 will be converted into textual descriptions in the Management Information Base or MIB. MIB objects are generally
SMIv1 during the translation process. However, this loss of machine accessed through the Simple Network Management Protocol (SNMP).
readable information is not considered to change the semantics of the Objects in the MIB are defined using the mechanisms defined in the
MIB. Structure of Management Information (SMI). This memo specifies a MIB
module that is compliant to the SMIv2, which is described in STD 58,
RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580
[RFC2580].
3. Overview 3. Overview
This MIB module contains one scalar and eight tables. Some of the This MIB module contains the following tables.
objects in these tables are deprecated. This MIB contains deprecated
objects since they are necessary for managing PIMv1 routers, but PIMv1
itself is obsoleted by PIM v2 [18,19].
The tables contained in this MIB are: 1. The PIM Interface Table, which contains one row per IP version
for each interface of the router which is running PIM.
(1) The PIM Interface Table contains one row for each of the 2. The PIM Neighbor Table, which contains one row for each of the
router's PIM interfaces. router's PIM neighbors.
(2) The PIM Neighbor Table contains one row for each of the router's 3. The PIM Neighbor Secondary Address Table, which contains one row
PIM neighbors. for each secondary address advertised by each of the router's PIM
neighbors.
(3) The PIM IP Multicast Route Table contains one row for each 4. The PIM Multicast Route Table, which contains one row for each
multicast routing entry whose incoming interface is running PIM. multicast routing entry created by PIM.
(4) The PIM Next Hop Table which contains one row for each outgoing 5. The PIM Next Hop Table, which contains one row for each outgoing
interface list entry in the multicast routing table whose interface list entry in the multicast routing table whose
interface is running PIM, and whose state is pruned. interface is running PIM.
(5) The (deprecated) PIM RP Table contains the PIM (version 1) 6. The PIM Bidir DF-Election Table, which contains one row per
information for IP multicast groups which is common to all RPs interface for each Rendezvous Point (RP) for which Bidirectional-
of a group. PIM Designated Forwarder (DF) election state is maintained.
(6) The PIM RP-Set Table contains the PIM (version 2) information 7. The PIM RP-Set Table, which contains information about all the
for sets of candidate Rendezvous Points (RPs) for IP multicast available Rendezvous Points for IP multicast group addresses with
group addresses with particular address prefixes. particular address prefixes.
(7) The PIM Candidate-RP Table contains the IP multicast groups for 8. The PIM Candidate-RP Table, which contains the IP multicast group
which the local router is to advertise itself as a Candidate-RP. prefixes for which the local router is to advertise itself as a
If this table is empty, then the local router advertises itself Candidate-RP.
as a Candidate-RP for all groups.
(8) The PIM Component Table contains one row for each of the PIM 9. The PIM Scope Zone Table, which contains one row for each of the
domains to which the router is connected. admin scoped zones in the PIM domain to which the router is
connected.
This MIB module uses textual conventions defined in the IF-MIB
[RFC2863] and the INET-ADDRESS-MIB [RFC4001].
4. Definitions 4. Definitions
PIM-MIB DEFINITIONS ::= BEGIN PIM-STD-MIB DEFINITIONS ::= BEGIN
IMPORTS IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, experimental, MODULE-IDENTITY, OBJECT-TYPE, mib-2,
NOTIFICATION-TYPE, NOTIFICATION-TYPE,
Integer32, IpAddress, TimeTicks FROM SNMPv2-SMI Unsigned32, TimeTicks FROM SNMPv2-SMI
RowStatus, TruthValue FROM SNMPv2-TC RowStatus, TruthValue FROM SNMPv2-TC
MODULE-COMPLIANCE, OBJECT-GROUP, MODULE-COMPLIANCE, OBJECT-GROUP,
NOTIFICATION-GROUP FROM SNMPv2-CONF NOTIFICATION-GROUP FROM SNMPv2-CONF
ipMRouteGroup, ipMRouteSource, InterfaceIndexOrZero,
ipMRouteSourceMask, ipMRouteNextHopGroup, InterfaceIndex FROM IF-MIB
ipMRouteNextHopSource, ipMRouteNextHopSourceMask, InetAddressType,
ipMRouteNextHopIfIndex, InetAddressPrefixLength,
ipMRouteNextHopAddress FROM IPMROUTE-STD-MIB InetAddress, InetVersion FROM INET-ADDRESS-MIB;
InterfaceIndex FROM IF-MIB;
pimMIB MODULE-IDENTITY pimStdMIB MODULE-IDENTITY
LAST-UPDATED "200210280000Z" -- October 28, 2002 LAST-UPDATED "200504290000Z" -- April 29, 2005
ORGANIZATION "IETF PIM Working Group." ORGANIZATION "IETF PIM Working Group"
CONTACT-INFO CONTACT-INFO
" Jonathan Nicholas "Email: pim@ietf.org"
ITT Industries
Aerospace/Communications Division
100 Kingsland Rd
Clifton, NJ 07014
Phone: +1 973 284 2019
EMail: jonathan.nicholas@itt.com"
DESCRIPTION
"The MIB module for management of PIM routers."
REVISION "200009280000Z" -- September 28, 2000
DESCRIPTION
"Initial version, published as RFC 2934."
REVISION "200210280000Z" -- October 28, 2002
DESCRIPTION DESCRIPTION
"Revised November 4, 2002." "The MIB module for management of PIM routers.
::= { experimental 61 }
pimMIBObjects OBJECT IDENTIFIER ::= { pimMIB 1 } Copyright (C) The Internet Society (2005). This version of
this MIB module is part of RFC yyyy; see the RFC itself for
full legal notices."
-- RFC Ed.: replace yyyy with actual RFC number & remove this note
REVISION "200404290000Z" -- April 29, 2005
DESCRIPTION "Initial version, published as RFC yyyy."
-- RFC Ed.: replace yyyy with actual RFC number & remove this note
::= { mib-2 XXX }
-- RFC Ed.: replace XXX with IANA-assigned number & remove this note
pimMIBObjects OBJECT IDENTIFIER ::= { pimStdMIB 1 }
pimTraps OBJECT IDENTIFIER ::= { pimMIBObjects 0 } pimTraps OBJECT IDENTIFIER ::= { pimMIBObjects 0 }
pim OBJECT IDENTIFIER ::= { pimMIBObjects 1 } pim OBJECT IDENTIFIER ::= { pimMIBObjects 1 }
pimJoinPruneInterval OBJECT-TYPE
SYNTAX Integer32
UNITS "seconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The default interval at which periodic PIM-SM Join/Prune
messages are to be sent."
DEFVAL { 60 }
::= { pim 1 }
--
-- The PIM Interface Table -- The PIM Interface Table
--
pimInterfaceTable OBJECT-TYPE pimInterfaceTable OBJECT-TYPE
SYNTAX SEQUENCE OF PimInterfaceEntry SYNTAX SEQUENCE OF PimInterfaceEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The (conceptual) table listing the router's PIM interfaces. "The (conceptual) table listing the router's PIM interfaces.
IGMP and PIM are enabled on all interfaces listed in this PIM is enabled on all interfaces listed in this table."
table." ::= { pim 1 }
::= { pim 2 }
pimInterfaceEntry OBJECT-TYPE pimInterfaceEntry OBJECT-TYPE
SYNTAX PimInterfaceEntry SYNTAX PimInterfaceEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An entry (conceptual row) in the pimInterfaceTable." "An entry (conceptual row) in the pimInterfaceTable."
INDEX { pimInterfaceIfIndex } INDEX { pimInterfaceIfIndex,
pimInterfaceIPVersion }
::= { pimInterfaceTable 1 } ::= { pimInterfaceTable 1 }
PimInterfaceEntry ::= SEQUENCE { PimInterfaceEntry ::= SEQUENCE {
pimInterfaceIfIndex InterfaceIndex, pimInterfaceIfIndex InterfaceIndex,
pimInterfaceAddress IpAddress, pimInterfaceIPVersion InetVersion,
pimInterfaceNetMask IpAddress, pimInterfaceAddressType InetAddressType,
pimInterfaceMode INTEGER, pimInterfaceAddress InetAddress,
pimInterfaceDR IpAddress, pimInterfaceNetMaskLength InetAddressPrefixLength,
pimInterfaceHelloInterval Integer32, pimInterfaceDR InetAddress,
pimInterfaceStatus RowStatus, pimInterfaceHelloInterval Unsigned32,
pimInterfaceJoinPruneInterval Integer32, pimInterfaceTrigHelloInterval Unsigned32,
pimInterfaceCBSRPreference Integer32, pimInterfaceJoinPruneInterval Unsigned32,
pimInterfaceTrigHelloInterval Integer32, pimInterfaceDFElectionRobustness Unsigned32,
pimInterfaceHelloHoldtime Integer32, pimInterfaceHelloHoldtime Unsigned32,
pimInterfaceLanPruneDelay BITS, pimInterfaceJoinPruneHoldtime Unsigned32,
pimInterfacePropagationDelay Integer32, pimInterfaceUseLanPruneDelay TruthValue,
pimInterfaceOverrideInterval Integer32, pimInterfacePropagationDelay Unsigned32,
pimInterfaceGenerationID BITS, pimInterfaceOverrideInterval Unsigned32,
pimInterfaceJoinPruneHoldtime Integer32, pimInterfaceUseGenerationID TruthValue,
pimInterfaceGraftRetryInterval Integer32, pimInterfaceGenerationIDValue Unsigned32,
pimInterfaceMaxGraftRetries Integer32, pimInterfaceUseDRPriority TruthValue,
pimInterfaceSRTTLThreshold Integer32, pimInterfaceDRPriority Unsigned32,
pimInterfaceLanDelayEnabled TruthValue, pimInterfaceLanDelayEnabled TruthValue,
pimInterfaceSRCapable TruthValue, pimInterfaceEffectPropagDelay Unsigned32,
pimInterfaceDRPriority Integer32 pimInterfaceEffectOverrideIvl Unsigned32,
pimInterfaceSuppressionEnabled TruthValue,
pimInterfaceBidirCapable TruthValue,
pimInterfaceDRPriorityEnabled TruthValue,
pimInterfaceBSRBorder TruthValue,
pimInterfaceStatus RowStatus
} }
pimInterfaceIfIndex OBJECT-TYPE pimInterfaceIfIndex OBJECT-TYPE
SYNTAX InterfaceIndex SYNTAX InterfaceIndex
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The ifIndex value of this PIM interface." "The ifIndex value of this PIM interface."
::= { pimInterfaceEntry 1 } ::= { pimInterfaceEntry 1 }
pimInterfaceAddress OBJECT-TYPE pimInterfaceIPVersion OBJECT-TYPE
SYNTAX IpAddress SYNTAX InetVersion
MAX-ACCESS read-only MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The IP address of the PIM interface." "The IP version of this PIM interface. A physical interface
may be configured in multiple modes concurrently, e.g. IPv4
and IPv6, however the traffic is considered to be logically
separate."
::= { pimInterfaceEntry 2 } ::= { pimInterfaceEntry 2 }
pimInterfaceNetMask OBJECT-TYPE pimInterfaceAddressType OBJECT-TYPE
SYNTAX IpAddress SYNTAX InetAddressType
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The network mask for the IP address of the PIM interface." "The address type of this PIM interface."
::= { pimInterfaceEntry 3 } ::= { pimInterfaceEntry 3 }
pimInterfaceMode OBJECT-TYPE pimInterfaceAddress OBJECT-TYPE
SYNTAX INTEGER { dense(1), sparse(2), sparseDense(3) } SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS read-create MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The configured mode of this PIM interface. A value of "The primary IP address of this router on this PIM
sparseDense is only valid for PIMv1." interface. The InetAddressType is given by the
DEFVAL { dense } pimInterfaceAddressType object."
::= { pimInterfaceEntry 4 } ::= { pimInterfaceEntry 4 }
pimInterfaceDR OBJECT-TYPE pimInterfaceNetMaskLength OBJECT-TYPE
SYNTAX IpAddress SYNTAX InetAddressPrefixLength
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The Designated Router on this PIM interface." "The network mask length for the primary IP address of this
router on this PIM interface. The InetAddressType is given
by the pimInterfaceAddressType object. A value of 0
indicates that the network mask length is unknown."
::= { pimInterfaceEntry 5 } ::= { pimInterfaceEntry 5 }
pimInterfaceHelloInterval OBJECT-TYPE pimInterfaceDR OBJECT-TYPE
SYNTAX Integer32 SYNTAX InetAddress (SIZE (4|16|20))
UNITS "seconds" MAX-ACCESS read-only
MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The frequency at which PIM Hello messages are transmitted "The primary IP address of the Designated Router on this PIM
on this interface." interface. The InetAddressType is given by the
DEFVAL { 30 } pimInterfaceAddressType object."
::= { pimInterfaceEntry 6 } ::= { pimInterfaceEntry 6 }
pimInterfaceStatus OBJECT-TYPE pimInterfaceHelloInterval OBJECT-TYPE
SYNTAX RowStatus SYNTAX Unsigned32 (0..18000)
UNITS "seconds"
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this entry. Creating the entry enables PIM "The frequency at which PIM Hello messages are transmitted
on the interface; destroying the entry disables PIM on the on this interface. This object corresponds to the
'Hello_Period' timer value defined in the PIM-SM
specification [I-D.ietf-pim-sm-v2-new]. A value of 0
represents an 'infinite' interval, and indicates that
periodic PIM Hello messages should not be sent on this
interface." interface."
DEFVAL { 30 }
::= { pimInterfaceEntry 7 } ::= { pimInterfaceEntry 7 }
pimInterfaceJoinPruneInterval OBJECT-TYPE pimInterfaceTrigHelloInterval OBJECT-TYPE
SYNTAX Integer32 SYNTAX Unsigned32 (0..60)
UNITS "seconds" UNITS "seconds"
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The frequency at which PIM Join/Prune messages are "The maximum time before this router sends a triggered PIM
transmitted on this PIM interface. The default value of Hello message on this interface. This object corresponds to
this object is the pimJoinPruneInterval." the 'Trigered_Hello_Delay' timer value defined in the PIM-SM
specification [I-D.ietf-pim-sm-v2-new]. A value of 0 has
no special meaning and indicates that triggered PIM Hello
messages should always be sent immediately."
DEFVAL { 5 }
::= { pimInterfaceEntry 8 } ::= { pimInterfaceEntry 8 }
pimInterfaceCBSRPreference OBJECT-TYPE pimInterfaceJoinPruneInterval OBJECT-TYPE
SYNTAX Integer32 (-1..255) SYNTAX Unsigned32 (0..18000)
UNITS "seconds"
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The preference value for the local interface as a candidate "The frequency at which this router sends PIM Join/Prune
bootstrap router. The value of -1 is used to indicate that messages on this PIM interface. This object corresponds to
the local interface is not a candidate BSR interface." the 't_periodic' timer value defined in the PIM-SM
DEFVAL { 0 } specification [I-D.ietf-pim-sm-v2-new]. A value of 0
represents an 'infinite' interval, and indicates that
periodic PIM Join/Prune messages should not be sent on this
interface."
DEFVAL { 60 }
::= { pimInterfaceEntry 9 } ::= { pimInterfaceEntry 9 }
pimInterfaceTrigHelloInterval OBJECT-TYPE pimInterfaceDFElectionRobustness OBJECT-TYPE
SYNTAX Integer32 SYNTAX Unsigned32
UNITS "seconds"
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION "The maximum time before a triggered PIM Hello message DESCRIPTION
is transmitted on this interface." "The minimum number of PIM DF-Election messages that must be
DEFVAL { 5 } lost in order for DF election on this interface to fail."
DEFVAL { 3 }
::= { pimInterfaceEntry 10 } ::= { pimInterfaceEntry 10 }
pimInterfaceHelloHoldtime OBJECT-TYPE pimInterfaceHelloHoldtime OBJECT-TYPE
SYNTAX Integer32 (0..65535) SYNTAX Unsigned32 (0..65535)
UNITS "seconds" UNITS "seconds"
MAX-ACCESS read-create MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION "The value set in the Holdtime field of Hello messages DESCRIPTION
transmitted on this interface. This should be 3.5 "The value set in the Holdtime field of PIM Hello messages
times the value of pimInterfaceHelloInterval." transmitted on this interface. A value of 65535 represents
an 'infinite' holdtime. Implementations are recommended
to use a holdtime that is 3.5 times the value of
pimInterfaceHelloInterval, or 65535 if
pimInterfaceHelloInterval is set to 0."
DEFVAL { 105 } DEFVAL { 105 }
::= { pimInterfaceEntry 11 } ::= { pimInterfaceEntry 11 }
pimInterfaceLanPruneDelay OBJECT-TYPE pimInterfaceJoinPruneHoldtime OBJECT-TYPE
SYNTAX BITS { off (0), on (1) } SYNTAX Unsigned32 (0..65535)
MAX-ACCESS read-create UNITS "seconds"
STATUS current MAX-ACCESS read-only
DESCRIPTION "Turns the LAN Prune Delay Option off and on on this STATUS current
interface." DESCRIPTION
DEFVAL { on } "The value inserted into the Holdtime field of a PIM
Join/Prune message sent on this interface. A value of 65535
represents an 'infinite' holdtime. Implementations are
recommended to use a holdtime that is 3.5 times the value of
pimInterfaceJoinPruneInterval, or 65535 if
pimInterfaceJoinPruneInterval is set to 0."
DEFVAL { 210 }
::= { pimInterfaceEntry 12 } ::= { pimInterfaceEntry 12 }
pimInterfacePropagationDelay OBJECT-TYPE pimInterfaceUseLanPruneDelay OBJECT-TYPE
SYNTAX Integer32 (0..32767) SYNTAX TruthValue
UNITS "milliseconds"
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION "The value inserted into the LAN Prune Delay field of a DESCRIPTION
LAN Prune Delay option on this interface." "Whether or not this router includes the LAN Prune Delay
DEFVAL { 500 } option in the PIM Hello messages it sends on this
interface."
DEFVAL { true }
::= { pimInterfaceEntry 13 } ::= { pimInterfaceEntry 13 }
pimInterfaceOverrideInterval OBJECT-TYPE pimInterfacePropagationDelay OBJECT-TYPE
SYNTAX Integer32 (0..65535) SYNTAX Unsigned32 (0..32767)
UNITS "milliseconds"
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION "The value inserted into the Override Interval field of DESCRIPTION
a LAN Prune Delay option on this interface." "The value this router inserts into the Propagation_Delay
DEFVAL { 2500 } field of the LAN Prune Delay option in the PIM Hello
messages it sends on this interface. This object is only
used if pimInterfaceUseLanPruneDelay is set to TRUE.
Implementations should enforce a lower bound on the
permitted values for this object to allow for scheduling and
processing delays within the local router."
DEFVAL { 500 }
::= { pimInterfaceEntry 14 } ::= { pimInterfaceEntry 14 }
pimInterfaceGenerationID OBJECT-TYPE pimInterfaceOverrideInterval OBJECT-TYPE
SYNTAX BITS { off (0), on (1) } SYNTAX Unsigned32 (0..65535)
UNITS "milliseconds"
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION "Turns the Generation ID Option off and on on this DESCRIPTION
interface." "The value this router inserts into the Override_Interval
DEFVAL { off } field of the LAN Prune Delay option in the PIM Hello
messages it sends on this interface. This object is only
used if pimInterfaceUseLanPruneDelay is set to TRUE."
DEFVAL { 2500 }
::= { pimInterfaceEntry 15 } ::= { pimInterfaceEntry 15 }
pimInterfaceJoinPruneHoldtime OBJECT_TYPE pimInterfaceUseGenerationID OBJECT-TYPE
SYNTAX Integer32 (0..65535) SYNTAX TruthValue
UNITS "seconds"
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION "The value inserted into the Holdtime field of a Join/ DESCRIPTION
Prune message sent on this interface. The value should "Whether or not this router includes the Generation ID
be 3.5 times pimInterfaceJoinPruneInterval." option in the PIM Hello messages it sends on this
DEFVAL { 210 } interface."
DEFVAL { true }
::= { pimInterfaceEntry 16 } ::= { pimInterfaceEntry 16 }
pimInterfaceGraftRetryInterval OBJECT-TYPE pimInterfaceGenerationIDValue OBJECT-TYPE
SYNTAX Integer32 SYNTAX Unsigned32
UNITS "seconds" MAX-ACCESS read-only
MAX-ACCESS read-create STATUS current
STATUS current DESCRIPTION
DESCRIPTION "The interval a PIM router waits for a Graft Ack before "The value of the Generation ID this router inserted in the
resending a Graft on this interface." last PIM Hello message it sent on this interface. This
DEFVAL { 3 } object is 0 if pimInterfaceUseGenerationID is set to FALSE."
::= { pimInterfaceEntry 17 } ::= { pimInterfaceEntry 17 }
pimInterfaceMaxGraftRetries OBJECT-TYPE pimInterfaceUseDRPriority OBJECT-TYPE
SYNTAX Integer32 SYNTAX TruthValue
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION "The maximum number of times this router will resend a DESCRIPTION
Graft on this interface." "Whether or not this router includes the DR Priority option
DEFVAL { 2 } in the PIM Hello messages it sends on this interface."
DEFVAL { true }
::= { pimInterfaceEntry 18 } ::= { pimInterfaceEntry 18 }
pimInterfaceSRTTLThreshold OBJECT-TYPE pimInterfaceDRPriority OBJECT-TYPE
SYNTAX Integer32 SYNTAX Unsigned32
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION "The Time To Live in a PIM-DM State Refresh message at DESCRIPTION
which it is not forwarded on this interface." "The Designated Router Priority value inserted into the DR
DEFVAL { 0 } Priority option on this interface. Numerically higher
values for this object indicate higher priorities. This
object is only used if pimInterfaceUseDRPriority is set to
TRUE."
DEFVAL { 1 }
::= { pimInterfaceEntry 19 } ::= { pimInterfaceEntry 19 }
pimInterfaceLanDelayEnabled OBJECT-TYPE pimInterfaceLanDelayEnabled OBJECT-TYPE
SYNTAX TruthValue SYNTAX TruthValue
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION "Evaluates to TRUE if all routers on this interface are DESCRIPTION
using the LAN Prune Delay Option." "Evaluates to TRUE if all routers on this interface are
using the LAN Prune Delay option."
::= { pimInterfaceEntry 20 } ::= { pimInterfaceEntry 20 }
pimInterfaceSRCapable OBJECT-TYPE pimInterfaceEffectPropagDelay OBJECT-TYPE
SYNTAX TruthValue SYNTAX Unsigned32 (0..32767)
UNITS "milliseconds"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION "Evaluates to TRUE if all routers on this interface are DESCRIPTION
using the State Refresh Capable Option." "The Effective Propagation Delay on this interface. This
object is always 500 if pimInterfaceLanDelayEnabled is
FALSE."
::= { pimInterfaceEntry 21 } ::= { pimInterfaceEntry 21 }
pimInterfaceDRPriority OBJECT-TYPE pimInterfaceEffectOverrideIvl OBJECT-TYPE
SYNTAX Integer32 SYNTAX Unsigned32 (0..65535)
MAX-ACCESS read-create UNITS "milliseconds"
STATUS current MAX-ACCESS read-only
DESCRIPTION "The Designater Router Priority inserted into the DR STATUS current
priority option on this interface." DESCRIPTION
DEFVAL { 1 } "The Effective Override Interval on this interface. This
object is always 2500 if pimInterfaceLanDelayEnabled is
FALSE."
::= { pimInterfaceEntry 22 } ::= { pimInterfaceEntry 22 }
pimInterfaceSuppressionEnabled OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Whether join suppression is enabled on this interface.
This object is always TRUE if pimInterfaceLanDelayEnabled is
FALSE."
::= { pimInterfaceEntry 23 }
pimInterfaceBidirCapable OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Evaluates to TRUE if all routers on this interface are
using the Bidirectional-PIM Capable option."
::= { pimInterfaceEntry 24 }
pimInterfaceDRPriorityEnabled OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Evaluates to TRUE if all routers on this interface are
using the DR Priority option."
::= { pimInterfaceEntry 25 }
pimInterfaceBSRBorder OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Whether or not this interface acts as a border for all PIM
Bootstrap messages."
DEFVAL { false }
::= { pimInterfaceEntry 26 }
pimInterfaceStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this entry. Creating the entry enables PIM
on the interface; destroying the entry disables PIM on the
interface."
::= { pimInterfaceEntry 27 }
--
-- The PIM Neighbor Table -- The PIM Neighbor Table
--
pimNeighborTable OBJECT-TYPE pimNeighborTable OBJECT-TYPE
SYNTAX SEQUENCE OF PimNeighborEntry SYNTAX SEQUENCE OF PimNeighborEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The (conceptual) table listing the router's PIM neighbors." "The (conceptual) table listing the router's PIM neighbors."
::= { pim 3 } ::= { pim 2 }
pimNeighborEntry OBJECT-TYPE pimNeighborEntry OBJECT-TYPE
SYNTAX PimNeighborEntry SYNTAX PimNeighborEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An entry (conceptual row) in the pimNeighborTable." "An entry (conceptual row) in the pimNeighborTable."
INDEX { pimNeighborAddress } INDEX { pimNeighborIfIndex,
pimNeighborAddressType,
pimNeighborAddress }
::= { pimNeighborTable 1 } ::= { pimNeighborTable 1 }
PimNeighborEntry ::= SEQUENCE { PimNeighborEntry ::= SEQUENCE {
pimNeighborAddress IpAddress, pimNeighborIfIndex InterfaceIndex,
pimNeighborIfIndex InterfaceIndex, pimNeighborAddressType InetAddressType,
pimNeighborUpTime TimeTicks, pimNeighborAddress InetAddress,
pimNeighborExpiryTime TimeTicks, pimNeighborUpTime TimeTicks,
pimNeighborMode INTEGER, pimNeighborExpiryTime TimeTicks,
pimNeighborLanPruneDelay Integer32, pimNeighborLanPruneDelayPresent TruthValue,
pimNeighborOverrideInterval Integer32, pimNeighborPropagationDelay Unsigned32,
pimNeighborTBit BITS, pimNeighborOverrideInterval Unsigned32,
pimNeighborSRCapable TruthValue, pimNeighborTBit TruthValue,
pimNeighborDRPresent TruthValue pimNeighborGenerationIDPresent TruthValue,
pimNeighborGenerationIDValue Unsigned32,
pimNeighborBidirCapable TruthValue,
pimNeighborDRPriorityPresent TruthValue,
pimNeighborDRPriority Unsigned32
} }
pimNeighborAddress OBJECT-TYPE
SYNTAX IpAddress
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The IP address of the PIM neighbor for which this entry
contains information."
::= { pimNeighborEntry 1 }
pimNeighborIfIndex OBJECT-TYPE pimNeighborIfIndex OBJECT-TYPE
SYNTAX InterfaceIndex SYNTAX InterfaceIndex
MAX-ACCESS read-only MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The value of ifIndex for the interface used to reach this "The value of ifIndex for the interface used to reach this
PIM neighbor." PIM neighbor."
::= { pimNeighborEntry 1 }
pimNeighborAddressType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The address type of this PIM neighbor."
::= { pimNeighborEntry 2 } ::= { pimNeighborEntry 2 }
pimNeighborAddress OBJECT-TYPE
SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The primary IP address of this PIM neighbor. The
InetAddressType is given by the pimNeighborAddressType
object."
::= { pimNeighborEntry 3 }
pimNeighborUpTime OBJECT-TYPE pimNeighborUpTime OBJECT-TYPE
SYNTAX TimeTicks SYNTAX TimeTicks
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The time since this PIM neighbor (last) became a neighbor "The time since this PIM neighbor (last) became a neighbor
of the local router." of the local router."
::= { pimNeighborEntry 3 } ::= { pimNeighborEntry 4 }
pimNeighborExpiryTime OBJECT-TYPE pimNeighborExpiryTime OBJECT-TYPE
SYNTAX TimeTicks SYNTAX TimeTicks
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The minimum time remaining before this PIM neighbor will be "The minimum time remaining before this PIM neighbor will
aged out." be aged out. The value zero indicates that this PIM
::= { pimNeighborEntry 4 } neighbor will never be aged out."
pimNeighborMode OBJECT-TYPE
SYNTAX INTEGER { dense(1), sparse(2) }
MAX-ACCESS read-only
STATUS deprecated
DESCRIPTION
"The active PIM mode of this neighbor. This object is
deprecated for PIMv2 routers since all neighbors on the
interface must be either dense or sparse as determined by
the protocol running on the interface."
::= { pimNeighborEntry 5 } ::= { pimNeighborEntry 5 }
pimNeighborLANPruneDelay OBJECT-TYPE pimNeighborLanPruneDelayPresent OBJECT-TYPE
SYNTAX Integer32 SYNTAX TruthValue
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION "The value of LAN Prune Delay field of the LAN Prune DESCRIPTION
Delay Option received from this neighbor. A value of "Evaluates to TRUE if this neighbor is using the LAN Prune
0 indicates that no LAN Prune Delay Option was Delay option."
received from this neigbor."
::= { pimNeighborEntry 6 } ::= { pimNeighborEntry 6 }
pimNeighborOverrideInterval OBJECT-TYPE pimNeighborPropagationDelay OBJECT-TYPE
SYNTAX Integer32 SYNTAX Unsigned32 (0..32767)
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION "The value of Override Interval field of the LAN Prune DESCRIPTION
Delay Option received from this neighbor. A value of "The value of the Propagation_Delay field of the LAN Prune
0 indicates that no LAN Prune Delay Option was Delay option received from this neighbor. This object is
received from this neigbor." always 0 if pimNeighborLanPruneDelayPresent is FALSE."
::= { pimNeighborEntry 7 } ::= { pimNeighborEntry 7 }
pimNeighborTBit OBJECT-TYPE pimNeighborOverrideInterval OBJECT-TYPE
SYNTAX BITS SYNTAX Unsigned32 (0..65535)
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION "The value of the T bit field of the LAN Prune DESCRIPTION
Delay Option received from this neighbor. The T bit "The value of the Override_Interval field of the LAN Prune
specifies the ability of the neighbor to disable Delay option received from this neighbor. This object is
join suppression." always 0 if pimNeighborLanPruneDelayPresent is FALSE."
::= { pimNeighborEntry 8 } ::= { pimNeighborEntry 8 }
pimNeighborSRCapable OBJECT-TYPE pimNeighborTBit OBJECT-TYPE
SYNTAX TruthValue SYNTAX TruthValue
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION "Evaluates to TRUE if this neighbor is using the State DESCRIPTION
Refresh Capable Option." "Whether the T bit was set in the LAN Prune Delay option
received from this neighbor. The T bit specifies the
ability of the neighbor to disable join suppression. This
object is always TRUE if pimNeighborLanPruneDelayPresent is
FALSE."
::= { pimNeighborEntry 9 } ::= { pimNeighborEntry 9 }
pimNeighborDRPresent OBJECT-TYPE pimNeighborGenerationIDPresent OBJECT-TYPE
SYNTAX TruthValue SYNTAX TruthValue
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION "Evaluates to TRUE if this neighbor is using the DESCRIPTION
Designated Router Option." "Evaluates to TRUE if this neighbor is using the Generation
ID option."
::= { pimNeighborEntry 10 } ::= { pimNeighborEntry 10 }
pimNeighborGenerationIDValue OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of the Generation ID from the last PIM Hello
message received from this neighbor. This object is always
0 if pimNeighborGenerationIDPresent is FALSE."
::= { pimNeighborEntry 11 }
pimNeighborBidirCapable OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Evaluates to TRUE if this neighbor is using the
Bidirectional-PIM Capable option."
::= { pimNeighborEntry 12 }
pimNeighborDRPriorityPresent OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Evaluates to TRUE if this neighbor is using the DR Priority
option."
::= { pimNeighborEntry 13 }
pimNeighborDRPriority OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of the Designated Router Priority from the last
PIM Hello message received from this neighbor. This object
is always 0 if pimNeighborDRPriorityPresent is FALSE."
::= { pimNeighborEntry 14 }
-- --
-- The PIM Neighbor Secondary Address Table
-- --
pimIpMRouteTable OBJECT-TYPE pimNbrSecAddressTable OBJECT-TYPE
SYNTAX SEQUENCE OF PimIpMRouteEntry SYNTAX SEQUENCE OF PimNbrSecAddressEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The (conceptual) table listing PIM-specific information on "The (conceptual) table listing the secondary addresses
a subset of the rows of the ipMRouteTable defined in the IP advertised by each PIM neighbor (on a subset of the rows of
Multicast MIB." the pimNeighborTable defined above)."
::= { pim 3 }
pimNbrSecAddressEntry OBJECT-TYPE
SYNTAX PimNbrSecAddressEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry (conceptual row) in the pimNbrSecAddressTable."
INDEX { pimNbrSecAddressIfIndex,
pimNbrSecAddressType,
pimNbrSecAddressPrimary,
pimNbrSecAddress }
::= { pimNbrSecAddressTable 1 }
PimNbrSecAddressEntry ::= SEQUENCE {
pimNbrSecAddressIfIndex InterfaceIndex,
pimNbrSecAddressType InetAddressType,
pimNbrSecAddressPrimary InetAddress,
pimNbrSecAddress InetAddress
}
pimNbrSecAddressIfIndex OBJECT-TYPE
SYNTAX InterfaceIndex
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The value of ifIndex for the interface used to reach this
PIM neighbor."
::= { pimNbrSecAddressEntry 1 }
pimNbrSecAddressType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The address type of this PIM neighbor."
::= { pimNbrSecAddressEntry 2 }
pimNbrSecAddressPrimary OBJECT-TYPE
SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The primary IP address of this PIM neighbor. The
InetAddressType is given by the pimNbrSecAddressType
object."
::= { pimNbrSecAddressEntry 3 }
pimNbrSecAddress OBJECT-TYPE
SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The secondary IP address of this PIM neighbor. The
InetAddressType is given by the pimNbrSecAddressType
object."
::= { pimNbrSecAddressEntry 4 }
--
-- The PIM Multicast Route Table
--
pimMRouteTable OBJECT-TYPE
SYNTAX SEQUENCE OF PimMRouteEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The (conceptual) table listing one row for each multicast
routing entry created by PIM."
::= { pim 4 } ::= { pim 4 }
pimIpMRouteEntry OBJECT-TYPE pimMRouteEntry OBJECT-TYPE
SYNTAX PimIpMRouteEntry SYNTAX PimMRouteEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An entry (conceptual row) in the pimIpMRouteTable. There "An entry (conceptual row) in the pimMRouteTable."
is one entry per entry in the ipMRouteTable whose incoming INDEX { pimMRouteAddressType,
interface is running PIM." pimMRouteGroup,
INDEX { ipMRouteGroup, ipMRouteSource, ipMRouteSourceMask } pimMRouteSource,
::= { pimIpMRouteTable 1 } pimMRouteSourcePrefixLength }
::= { pimMRouteTable 1 }
PimIpMRouteEntry ::= SEQUENCE { PimMRouteEntry ::= SEQUENCE {
pimIpMRouteUpstreamAssertTimer TimeTicks, pimMRouteAddressType InetAddressType,
pimIpMRouteAssertMetric Integer32, pimMRouteGroup InetAddress,
pimIpMRouteAssertMetricPref Integer32, pimMRouteSource InetAddress,
pimIpMRouteAssertRPTBit TruthValue, pimMRouteSourcePrefixLength InetAddressPrefixLength,
pimIpMRouteFlags BITS, pimMRouteUpTime TimeTicks,
pimIpMRouteRPFNeighbor IpAddress, pimMRouteExpiryTime TimeTicks,
pimIpMRouteSourceTimer TimeTicks, pimMRouteType INTEGER,
pimIpMRouteOriginatorSRTTL Integer32 pimMRouteRPAddress InetAddress,
pimMRouteRPFIfIndex InterfaceIndexOrZero,
pimMRouteRPFNeighbor InetAddress,
pimMRouteUpstreamAssertTimer TimeTicks,
pimMRouteAssertRPTBit TruthValue,
pimMRouteAssertMetricPref Unsigned32,
pimMRouteAssertMetric Unsigned32,
pimMRouteFlags BITS
} }
pimIpMRouteUpstreamAssertTimer OBJECT-TYPE pimMRouteAddressType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The address type of this multicast routing entry."
::= { pimMRouteEntry 1 }
pimMRouteGroup OBJECT-TYPE
SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The IP multicast group address for which this entry
contains multicast routing information. The InetAddressType
is given by the pimMRouteAddressType object."
::= { pimMRouteEntry 2 }
pimMRouteSource OBJECT-TYPE
SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The IP address which when combined with the corresponding
value of pimMRouteSourcePrefixLength identifies the sources
for which this entry contains multicast routing information.
The InetAddressType is given by the pimMRouteAddressType
object."
::= { pimMRouteEntry 3 }
pimMRouteSourcePrefixLength OBJECT-TYPE
SYNTAX InetAddressPrefixLength
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The prefix length which when combined with the
corresponding value of pimMRouteSource identifies the
sources for which this entry contains multicast routing
information. The InetAddressType is given by the
pimMRouteAddressType object. A value of zero indicates that
this entry contains multicast routing information for all
sources."
::= { pimMRouteEntry 4 }
pimMRouteUpTime OBJECT-TYPE
SYNTAX TimeTicks SYNTAX TimeTicks
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The time remaining before the router changes its upstream "The time since this multicast routing entry was created by
neighbor back to its RPF neighbor. This timer is called the the local router."
Assert timer in the PIM Sparse and Dense mode specification. ::= { pimMRouteEntry 5 }
A value of 0 indicates that no Assert has changed the
upstream neighbor away from the RPF neighbor."
::= { pimIpMRouteEntry 1 }
pimIpMRouteAssertMetric OBJECT-TYPE pimMRouteExpiryTime OBJECT-TYPE
SYNTAX Integer32 SYNTAX TimeTicks
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The metric advertised by the assert winner on the upstream "The minimum time remaining before this entry will be aged
interface, or 0 if no such assert is in received." out. The value zero indicates that this entry will never be
::= { pimIpMRouteEntry 2 } aged out."
::= { pimMRouteEntry 6 }
pimIpMRouteAssertMetricPref OBJECT-TYPE pimMRouteType OBJECT-TYPE
SYNTAX Integer32 SYNTAX INTEGER {
ssm (1),
asm (2),
bidir (3)
}
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The preference advertised by the assert winner on the "This object indicates whether this entry represents an SSM
upstream interface, or 0 if no such assert is in effect." (Source Specific Multicast, used with PIM-SM), ASM
::= { pimIpMRouteEntry 3 } (Any Source Multicast, used with PIM-SM) or a BIDIR-PIM
route."
::= { pimMRouteEntry 7 }
pimIpMRouteAssertRPTBit OBJECT-TYPE pimMRouteRPAddress OBJECT-TYPE
SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The address of the Rendezvous Point (RP) for the group
represented by pimMRouteGroup. The InetAddressType is given
by the pimMRouteAddressType object. This object is zero if
pimMRouteType is 'ssm', or if the RP address is unknown."
::= { pimMRouteEntry 8 }
pimMRouteRPFIfIndex OBJECT-TYPE
SYNTAX InterfaceIndexOrZero
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of ifIndex for the RPF interface, from which IP
datagrams sent by these sources to this multicast group
address are accepted, or zero if the RPF interface is
unknown."
::= { pimMRouteEntry 9 }
pimMRouteRPFNeighbor OBJECT-TYPE
SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The address of the RPF neighbor, from which IP datagrams
sent by these sources to this multicast group address are
received, or zero if the RPF neighbor is unknown or is not
a PIM neighbor. The InetAddressType is given by the
pimMRouteAddressType object."
::= { pimMRouteEntry 10 }
pimMRouteUpstreamAssertTimer OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The time remaining before the router changes its upstream
neighbor back to its RPF neighbor. This timer is called the
Assert Timer in the PIM-SM specification
[I-D.ietf-pim-sm-v2-new]. A value of zero indicates that no
assert has changed the upstream neighbor away from the RPF
neighbor."
::= { pimMRouteEntry 11 }
pimMRouteAssertRPTBit OBJECT-TYPE
SYNTAX TruthValue SYNTAX TruthValue
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The value of the RPT-bit advertised by the assert winner on "The value of the RPT bit advertised by the Assert Winner on
the upstream interface, or false if no such assert is in the upstream interface, or FALSE if no such assert is in
effect." effect."
::= { pimIpMRouteEntry 4 } ::= { pimMRouteEntry 12 }
pimIpMRouteFlags OBJECT-TYPE pimMRouteAssertMetricPref OBJECT-TYPE
SYNTAX Unsigned32 (0..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The metric preference advertised by the Assert Winner on
the upstream interface, or zero if no such assert is in
effect."
::= { pimMRouteEntry 13 }
pimMRouteAssertMetric OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The metric advertised by the Assert Winner on the upstream
interface, or zero if no such assert is in effect."
::= { pimMRouteEntry 14 }
pimMRouteFlags OBJECT-TYPE
SYNTAX BITS { SYNTAX BITS {
rpt(0), rpt(0),
spt(1) spt(1)
} }
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object describes PIM-specific flags related to a "This object describes PIM-specific flags related to a
multicast state entry. See the PIM Sparse Mode multicast routing entry. See the PIM-SM specification
specification for the meaning of the RPT and SPT bits." [I-D.ietf-pim-sm-v2-new] for the meaning of the RPT and SPT
::= { pimIpMRouteEntry 5 } bits."
::= { pimMRouteEntry 15 }
pimIpMRouteRPFNeighbor OBJECT-TYPE
SYNTAX IpAddress
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The IP Address of the current RPF neighbor. If there
is an upstream Assert Winner, it will be the RPF
neighbor. Otherwise, the RPF neighbor will be
the next hop indicated by unicast routing."
::= { pimIpMRouteEntry 6 }
pimIpMRouteSourceTimer OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION "The time before this router ceases originating State
Refresh messages for this route."
::= { pimIpMRouteEntry 7 }
pimIpMRouteOriginatorSRTTL OBJECT-TYPE
SYNTAX Integer32
MAX_ACCESS read-only
STATUS current
DESCRIPTION "The TTL used in State Refresh messages originated by
this router for this route."
::= { pimIpMRouteEntry 8 }
-- --
-- The PIM Next Hop Table -- The PIM Next Hop Table
-- --
pimIpMRouteNextHopTable OBJECT-TYPE pimMRouteNextHopTable OBJECT-TYPE
SYNTAX SEQUENCE OF PimIpMRouteNextHopEntry SYNTAX SEQUENCE OF PimMRouteNextHopEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The (conceptual) table listing PIM-specific information on "The (conceptual) table containing information on outgoing
a subset of the rows of the ipMRouteNextHopTable defined in interfaces for routing IP multicast datagrams, on which PIM
the IP Multicast MIB." Join/Prunes have been received."
::= { pim 7 } ::= { pim 5 }
pimIpMRouteNextHopEntry OBJECT-TYPE
SYNTAX PimIpMRouteNextHopEntry pimMRouteNextHopEntry OBJECT-TYPE
SYNTAX PimMRouteNextHopEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An entry (conceptual row) in the pimIpMRouteNextHopTable. "An entry (conceptual row) in the pimMRouteNextHopTable."
There is one entry per entry in the ipMRouteNextHopTable INDEX { pimMRouteNextHopAddressType,
whose interface is running PIM and whose pimMRouteNextHopGroup,
ipMRouteNextHopState is pruned(1)." pimMRouteNextHopSource,
INDEX { ipMRouteNextHopGroup, ipMRouteNextHopSource, pimMRouteNextHopSourcePrefixLength,
ipMRouteNextHopSourceMask, ipMRouteNextHopIfIndex, pimMRouteNextHopIfIndex }
ipMRouteNextHopAddress } ::= { pimMRouteNextHopTable 1 }
::= { pimIpMRouteNextHopTable 1 }
PimIpMRouteNextHopEntry ::= SEQUENCE { PimMRouteNextHopEntry ::= SEQUENCE {
pimIpMRouteNextHopPruneReason INTEGER, pimMRouteNextHopAddressType InetAddressType,
pimIpMRouteNextHopAssertWinner IpAddress, pimMRouteNextHopGroup InetAddress,
pimIpMRouteNextHopAssertTimer TimeTicks, pimMRouteNextHopSource InetAddress,
pimIpMRouteNextHopAssertMetric Integer32, pimMRouteNextHopSourcePrefixLength InetAddressPrefixLength,
pimIpMRouteNextHopAssertMetricPref Integer32, pimMRouteNextHopIfIndex InterfaceIndex,
pimIpMRouteNextHopJoinPruneTimer TimeTicks pimMRouteNextHopUpTime TimeTicks,
pimMRouteNextHopForwarding TruthValue,
pimMRouteNextHopJoinPruneTimer TimeTicks,
pimMRouteNextHopAssertWinner InetAddress,
pimMRouteNextHopAssertTimer TimeTicks,
pimMRouteNextHopAssertRPTBit TruthValue,
pimMRouteNextHopAssertMetricPref Unsigned32,
pimMRouteNextHopAssertMetric Unsigned32
} }
pimIpMRouteNextHopPruneReason OBJECT-TYPE
SYNTAX INTEGER { pimMRouteNextHopAddressType OBJECT-TYPE
other (1), SYNTAX InetAddressType
prune (2), MAX-ACCESS not-accessible
assert (3) STATUS current
} DESCRIPTION
"The address type of this multicast routing entry."
::= { pimMRouteNextHopEntry 1 }
pimMRouteNextHopGroup OBJECT-TYPE
SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The IP multicast group for which this entry specifies an
outgoing interface. The InetAddressType is given by the
pimMRouteNextHopAddressType object."
::= { pimMRouteNextHopEntry 2 }
pimMRouteNextHopSource OBJECT-TYPE
SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The network address which when combined with the
corresponding value of pimMRouteNextHopSourcePrefixLength
identifies the sources for which this entry specifies an
outgoing interface. The InetAddressType is given by the
pimMRouteNextHopAddressType object."
::= { pimMRouteNextHopEntry 3 }
pimMRouteNextHopSourcePrefixLength OBJECT-TYPE
SYNTAX InetAddressPrefixLength
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The network prefix length which when combined with the
corresponding value of pimMRouteNextHopSource identifies the
sources for which this entry specifies an outgoing
interface. The InetAddressType is given by the
pimMRouteNextHopAddressType object. A value of zero
indicates that this entry specifies an outgoing interface
for all sources."
::= { pimMRouteNextHopEntry 4 }
pimMRouteNextHopIfIndex OBJECT-TYPE
SYNTAX InterfaceIndex
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The ifIndex value of the outgoing interface."
::= { pimMRouteNextHopEntry 5 }
pimMRouteNextHopUpTime OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object indicates why the downstream interface was "The time since this entry was created by the local router."
pruned, whether in response to a PIM prune message or due to ::= { pimMRouteNextHopEntry 6 }
PIM Assert processing."
::= { pimIpMRouteNextHopEntry 2 }
pimIpMRouteNextHopAssertWinner OBJECT-TYPE pimMRouteNextHopForwarding OBJECT-TYPE
SYNTAX IpAddress SYNTAX TruthValue
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION "The IP Address of the Assert Winner." DESCRIPTION
::= { pimIpMRouteNextHopEntry 3 } "Evaluates to TRUE if the outgoing interface represented by
this entry is currently being used to forward IP datagrams."
::= { pimMRouteNextHopEntry 7 }
pimIpMRouteNextHopAssertTimer OBJECT-TYPE pimMRouteNextHopJoinPruneTimer OBJECT-TYPE
SYNTAX TimeTicks SYNTAX TimeTicks
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION "The time remaining before the PIM router leaves the DESCRIPTION
current Assert state. A value of 0 indicates that the "The time remaining before the local router ceases
router is in the No Info state." forwarding on this interface."
::= { pimIpMRouteNextHopEntry 4 } ::= { pimMRouteNextHopEntry 8 }
pimIpMRouteNextHopAssertMetric OBJECT-TYPE
SYNTAX Integer32 pimMRouteNextHopAssertWinner OBJECT-TYPE
SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION "The metric advertised by the Assert Winner." DESCRIPTION
::= { pimIpMRouteNextHopEntry 5 } "The IP address of the Assert Winner, or zero if no assert
is in effect. The InetAddressType is given by the
pimMRouteNextHopAddressType object."
::= { pimMRouteNextHopEntry 9 }
pimIpMRouteNextHopAssertMetricPref OBJECT-TYPE pimMRouteNextHopAssertTimer OBJECT-TYPE
SYNTAX Integer32 SYNTAX TimeTicks
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION "The metric preference advertised by the Assert Winner." DESCRIPTION
::= { pimIpMRouteNextHopEntry 6 } "The time remaining before the PIM router leaves the current
Assert state. A value of 0 indicates that the router is in
the NoInfo state."
::= { pimMRouteNextHopEntry 10 }
pimIpMRouteNextHopJoinPruneTimer OBJECT-TYPE pimMRouteNextHopAssertRPTBit OBJECT-TYPE
SYNTAX TimeTicks SYNTAX TruthValue
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION "The time remaining before the PIM router reverts to DESCRIPTION
default operation on this interface. PIM-SM will "The value of the RPT bit advertised by the Assert Winner,
cease forwarding, PIM-DM will resume forwarding." or FALSE if no assert is in effect."
::= { pimIpMRouteNextHopEntry 7 }ss, pimRPAddress } ::= { pimMRouteNextHopEntry 11 }
::= { pimRPTable 1 }
pimMRouteNextHopAssertMetricPref OBJECT-TYPE
SYNTAX Unsigned32 (0..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The metric preference advertised by the Assert Winner, or
zero if no assert is in effect."
::= { pimMRouteNextHopEntry 12 }
pimRPTable OBJECT-TYPE pimMRouteNextHopAssertMetric OBJECT-TYPE
SYNTAX SEQUENCE OF PimRPEntry SYNTAX Unsigned32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The metric advertised by the Assert Winner, or zero if no
assert is in effect."
::= { pimMRouteNextHopEntry 13 }
--
-- The PIM Bidir DF-Election Table
--
pimBidirDFElectionTable OBJECT-TYPE
SYNTAX SEQUENCE OF PimBidirDFElectionEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS deprecated STATUS current
DESCRIPTION DESCRIPTION
"The (conceptual) table listing PIM version 1 information "The (conceptual) table listing the per-RP Designated
for the Rendezvous Points (RPs) for IP multicast groups. Forwarder (DF) Election state for each interface for all the
This table is deprecated since its function is replaced by RPs in BIDIR mode."
the pimRPSetTable for PIM version 2." ::= { pim 6 }
::= { pim 5 }
pimRPEntry OBJECT-TYPE pimBidirDFElectionEntry OBJECT-TYPE
SYNTAX PimRPEntry SYNTAX PimBidirDFElectionEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS deprecated STATUS current
DESCRIPTION DESCRIPTION
"An entry (conceptual row) in the pimRPTable. There is one "An entry (conceptual row) in the pimBidirDFElectionTable."
entry per RP address for each IP multicast group." INDEX { pimBidirDFElectionAddressType,
INDEX { pimRPGroupAddre pimBidirDFElectionRPAddress,
PimRPEntry ::= SEQUENCE { pimBidirDFElectionIfIndex }
pimRPGroupAddress IpAddress, ::= { pimBidirDFElectionTable 1 }
pimRPAddress IpAddress,
pimRPState INTEGER, PimBidirDFElectionEntry ::= SEQUENCE {
pimRPStateTimer TimeTicks, pimBidirDFElectionAddressType InetAddressType,
pimRPLastChange TimeTicks, pimBidirDFElectionRPAddress InetAddress,
pimRPRowStatus RowStatus pimBidirDFElectionIfIndex InterfaceIndex,
pimBidirDFElectionWinnerAddress InetAddress,
pimBidirDFElectionWinnerUpTime TimeTicks,
pimBidirDFElectionWinnerMetricPref Unsigned32,
pimBidirDFElectionWinnerMetric Unsigned32,
pimBidirDFElectionState INTEGER,
pimBidirDFElectionStateTimer TimeTicks
} }
pimRPGroupAddress OBJECT-TYPE pimBidirDFElectionAddressType OBJECT-TYPE
SYNTAX IpAddress SYNTAX InetAddressType
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS deprecated STATUS current
DESCRIPTION DESCRIPTION
"The IP multicast group address for which this entry "The address type of the RP for which the DF state is being
contains information about an RP." maintained."
::= { pimRPEntry 1 } ::= { pimBidirDFElectionEntry 1 }
pimRPAddress OBJECT-TYPE pimBidirDFElectionRPAddress OBJECT-TYPE
SYNTAX IpAddress SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS deprecated STATUS current
DESCRIPTION DESCRIPTION
"The unicast address of the RP." "The IP address of the RP for which the DF state is being
::= { pimRPEntry 2 } maintained. The InetAddressType is given by the
pimBidirDFElectionAddressType object."
::= { pimBidirDFElectionEntry 2 }
pimRPState OBJECT-TYPE pimBidirDFElectionIfIndex OBJECT-TYPE
SYNTAX INTEGER { up(1), down(2) } SYNTAX InterfaceIndex
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The value of ifIndex for the interface for which the DF
state is being maintained."
::= { pimBidirDFElectionEntry 3 }
pimBidirDFElectionWinnerAddress OBJECT-TYPE
SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS deprecated STATUS current
DESCRIPTION DESCRIPTION
"The state of the RP." "The primary IP address of the winner of the DF Election
::= { pimRPEntry 3 } process. The InetAddressType is given by the
pimBidirDFElectionAddressType object. A value of zero
indicates there is currently no DF."
::= { pimBidirDFElectionEntry 4 }
pimRPStateTimer OBJECT-TYPE pimBidirDFElectionWinnerUpTime OBJECT-TYPE
SYNTAX TimeTicks SYNTAX TimeTicks
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS deprecated STATUS current
DESCRIPTION DESCRIPTION
"The minimum time remaining before the next state change. "The time since the current winner (last) became elected as
When pimRPState is up, this is the minimum time which must the DF for this RP."
expire until it can be declared down. When pimRPState is ::= { pimBidirDFElectionEntry 5 }
down, this is the time until it will be declared up (in
order to retry)."
::= { pimRPEntry 4 }
pimRPLastChange OBJECT-TYPE pimBidirDFElectionWinnerMetricPref OBJECT-TYPE
SYNTAX TimeTicks SYNTAX Unsigned32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS deprecated STATUS current
DESCRIPTION DESCRIPTION
"The value of sysUpTime at the time when the corresponding "The metric preference advertised by the DF Winner, or zero
instance of pimRPState last changed its value." if there is currently no DF."
::= { pimRPEntry 5 } ::= { pimBidirDFElectionEntry 6 }
pimRPRowStatus OBJECT-TYPE pimBidirDFElectionWinnerMetric OBJECT-TYPE
SYNTAX RowStatus SYNTAX Unsigned32
MAX-ACCESS read-create MAX-ACCESS read-only
STATUS deprecated STATUS current
DESCRIPTION DESCRIPTION
"The status of this row, by which new entries may be "The metric advertised by the DF Winner, or zero if there is
created, or old entries deleted from this table." currently no DF."
::= { pimRPEntry 6 } ::= { pimBidirDFElectionEntry 7 }
pimBidirDFElectionState OBJECT-TYPE
SYNTAX INTEGER {
dfOffer(1),
dfLose(2),
dfWinner(3),
dfBackoff(4)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The state of this interface with respect to DF-Election for
this RP. The states correspond to the ones defined in the
BIDIR-PIM specification [I-D.ietf-pim-bidir]."
::= { pimBidirDFElectionEntry 8 }
pimBidirDFElectionStateTimer OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The minimum time remaining after which the local router
will expire the current DF state represented by
pimBidirDFElectionState."
::= { pimBidirDFElectionEntry 9 }
--
-- The PIM RP-Set Table -- The PIM RP-Set Table
--
pimRPSetTable OBJECT-TYPE pimRPSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF PimRPSetEntry SYNTAX SEQUENCE OF PimRPSetEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The (conceptual) table listing PIM information for "The (conceptual) table listing PIM information for
candidate Rendezvous Points (RPs) for IP multicast groups. available Rendezvous Points (RPs) for IP multicast groups."
When the local router is the BSR, this information is ::= { pim 7 }
obtained from received Candidate-RP-Advertisements. When
the local router is not the BSR, this information is
obtained from received RP-Set messages."
::= { pim 6 }
pimRPSetEntry OBJECT-TYPE pimRPSetEntry OBJECT-TYPE
SYNTAX PimRPSetEntry SYNTAX PimRPSetEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An entry (conceptual row) in the pimRPSetTable." "An entry (conceptual row) in the pimRPSetTable."
INDEX { pimRPSetComponent, pimRPSetGroupAddress, INDEX { pimRPSetComponent,
pimRPSetGroupMask, pimRPSetAddress } pimRPSetAddressType,
pimRPSetGroupAddress,
pimRPSetGroupPrefixLength,
pimRPSetRPType,
pimRPSetRPAddress }
::= { pimRPSetTable 1 } ::= { pimRPSetTable 1 }
PimRPSetEntry ::= SEQUENCE { PimRPSetEntry ::= SEQUENCE {
pimRPSetComponent Unsigned32,
pimRPSetGroupAddress IpAddress, pimRPSetAddressType InetAddressType,
pimRPSetGroupMask IpAddress, pimRPSetGroupAddress InetAddress,
pimRPSetAddress IpAddress, pimRPSetGroupPrefixLength InetAddressPrefixLength,
pimRPSetHoldTime Integer32, pimRPSetRPType INTEGER,
pimRPSetExpiryTime TimeTicks, pimRPSetRPAddress InetAddress,
pimRPSetComponent Integer32 pimRPSetBidirGroup TruthValue,
pimRPSetPriority Unsigned32,
pimRPSetHoldtime Unsigned32,
pimRPSetExpiryTime TimeTicks,
pimRPSetRPActive TruthValue
} }
pimRPSetGroupAddress OBJECT-TYPE pimRPSetComponent OBJECT-TYPE
SYNTAX IpAddress SYNTAX Unsigned32 (1..255)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The IP multicast group address which, when combined with "A number uniquely identifying the component. Each protocol
pimRPSetGroupMask, gives the group prefix for which this instance connected to a separate domain should have a
entry contains information about the Candidate-RP." different index value."
::= { pimRPSetEntry 1 } ::= { pimRPSetEntry 1 }
pimRPSetGroupMask OBJECT-TYPE pimRPSetAddressType OBJECT-TYPE
SYNTAX IpAddress SYNTAX InetAddressType
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The multicast group address mask which, when combined with "The address type of the IP multicast group."
pimRPSetGroupAddress, gives the group prefix for which this
entry contains information about the Candidate-RP."
::= { pimRPSetEntry 2 } ::= { pimRPSetEntry 2 }
pimRPSetAddress OBJECT-TYPE pimRPSetGroupAddress OBJECT-TYPE
SYNTAX IpAddress SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The IP address of the Candidate-RP." "The IP multicast group address which, when combined with
the corresponding value of pimRPSetGroupPrefixLength, gives
the group prefix for which this entry contains information
about the RP. The InetAddressType is given by the
pimRPSetAddressType object."
::= { pimRPSetEntry 3 } ::= { pimRPSetEntry 3 }
pimRPSetHoldTime OBJECT-TYPE pimRPSetGroupPrefixLength OBJECT-TYPE
SYNTAX Integer32 (0..255) SYNTAX InetAddressPrefixLength
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The multicast group prefix length which, when combined
with the corresponding value of pimRPSetGroupAddress, gives
the group prefix for which this entry contains information
about the RP. The InetAddressType is given by the
pimRPSetAddressType object. A value of zero is not
permitted for this object."
::= { pimRPSetEntry 4 }
pimRPSetRPType OBJECT-TYPE
SYNTAX INTEGER {
static (1),
bsr (2),
embedded (3),
other (4)
}
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This object indicates how the RP was learnt. 'static'
means from local configuration, 'bsr' means the PIM
Bootstrap Router (BSR) mechanism
[I-D.ietf-pim-sm-bsr], 'embedded' means the Embedded-RP
mechanism [RFC3956] where the RP address is embedded in the
multicast group address, and 'other' means any other
mechanism."
::= { pimRPSetEntry 5 }
pimRPSetRPAddress OBJECT-TYPE
SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The IP address of the RP. The InetAddressType is given by
the pimRPSetAddressType object."
::= { pimRPSetEntry 6 }
pimRPSetBidirGroup OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Evaluates to TRUE if groups belonging to the group prefix
in this entry are to be used with BIDIR-PIM."
::= { pimRPSetEntry 7 }
pimRPSetPriority OBJECT-TYPE
SYNTAX Unsigned32 (0..255)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The RP Priority in the PIM Candidate-RP-Advertisement
message or PIM Bootstrap message by which this RP was
learned. Numerically higher values for this object indicate
lower priorities, with the value zero denoting the highest
priority. This object is 0 if pimRPSetRPType is not 'bsr'."
::= { pimRPSetEntry 8 }
pimRPSetHoldtime OBJECT-TYPE
SYNTAX Unsigned32 (0..65535)
UNITS "seconds" UNITS "seconds"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The holdtime of a Candidate-RP. If the local router is not "The holdtime of this RP entry. This object is 0 if
the BSR, this value is 0." pimRPSetRPType is not 'bsr'."
::= { pimRPSetEntry 4 } ::= { pimRPSetEntry 9 }
pimRPSetExpiryTime OBJECT-TYPE pimRPSetExpiryTime OBJECT-TYPE
SYNTAX TimeTicks SYNTAX TimeTicks
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The minimum time remaining before the Candidate-RP will be "The minimum time remaining before the RP denoted by this
declared down. If the local router is not the BSR, this entry will be declared down. The value zero indicates that
value is 0." the RP will never be declared down."
::= { pimRPSetEntry 5 } ::= { pimRPSetEntry 10 }
pimRPSetComponent OBJECT-TYPE pimRPSetRPActive OBJECT-TYPE
SYNTAX Integer32 (1..255) SYNTAX TruthValue
MAX-ACCESS not-accessible MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
" A number uniquely identifying the component. Each "Evaluates to TRUE if the RP in this entry is the currently
protocol instance connected to a separate domain should have active RP for the group range."
a different index value." ::= { pimRPSetEntry 11 }
::= { pimRPSetEntry 6 }
-- --
-- The PIM Candidate-RP Table -- The PIM Candidate-RP Table
--
pimCandidateRPTable OBJECT-TYPE pimCandidateRPTable OBJECT-TYPE
SYNTAX SEQUENCE OF PimCandidateRPEntry SYNTAX SEQUENCE OF PimCandidateRPEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The (conceptual) table listing the IP multicast groups for "The (conceptual) table listing the IP multicast groups for
which the local router is to advertise itself as a which the local router is to advertise itself as a
Candidate-RP when the value of pimComponentCRPHoldTime is Candidate-RP."
non-zero. If this table is empty, then the local router ::= { pim 8 }
will advertise itself as a Candidate-RP for all groups
(providing the value of pimComponentCRPHoldTime is non-
zero)."
::= { pim 11 }
pimCandidateRPEntry OBJECT-TYPE pimCandidateRPEntry OBJECT-TYPE
SYNTAX PimCandidateRPEntry SYNTAX PimCandidateRPEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An entry (conceptual row) in the pimCandidateRPTable." "An entry (conceptual row) in the pimCandidateRPTable."
INDEX { pimCandidateRPGroupAddress, INDEX { pimCandidateRPAddressType,
pimCandidateRPGroupMask } pimCandidateRPAddress,
pimCandidateRPGroupAddress,
pimCandidateRPGroupPrefixLength }
::= { pimCandidateRPTable 1 } ::= { pimCandidateRPTable 1 }
PimCandidateRPEntry ::= SEQUENCE { PimCandidateRPEntry ::= SEQUENCE {
pimCandidateRPGroupAddress IpAddress, pimCandidateRPAddressType InetAddressType,
pimCandidateRPGroupMask IpAddress, pimCandidateRPAddress InetAddress,
pimCandidateRPAddress IpAddress, pimCandidateRPGroupAddress InetAddress,
pimCandidateRPRowStatus RowStatus pimCandidateRPGroupPrefixLength InetAddressPrefixLength,
pimCandidateRPBidir TruthValue,
pimCandidateRPStatus RowStatus
} }
pimCandidateRPAddressType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The address type of the Candidate-RP."
::= { pimCandidateRPEntry 1 }
pimCandidateRPAddress OBJECT-TYPE
SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The (unicast) address which will be advertised as a
Candidate-RP. The InetAddressType is given by
the pimCandidateRPAddressType object."
::= { pimCandidateRPEntry 2 }
pimCandidateRPGroupAddress OBJECT-TYPE pimCandidateRPGroupAddress OBJECT-TYPE
SYNTAX IpAddress SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The IP multicast group address which, when combined with "The IP multicast group address which, when combined with
pimCandidateRPGroupMask, identifies a group prefix for which the corresponding value of pimCandidateRPGroupPrefixLength,
the local router will advertise itself as a Candidate-RP." identifies a group prefix for which the local router will
::= { pimCandidateRPEntry 1 } advertise itself as a Candidate-RP. The InetAddressType is
given by the pimCandidateRPAddressType object."
::= { pimCandidateRPEntry 3 }
pimCandidateRPGroupMask OBJECT-TYPE pimCandidateRPGroupPrefixLength OBJECT-TYPE
SYNTAX IpAddress SYNTAX InetAddressPrefixLength
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The multicast group address mask which, when combined with "The multicast group address mask which, when combined with
pimCandidateRPGroupMask, identifies a group prefix for which the corresponding value of pimCandidateRPGroupMask,
the local router will advertise itself as a Candidate-RP." identifies a group prefix for which the local router will
::= { pimCandidateRPEntry 2 } advertise itself as a Candidate-RP. The InetAddressType is
given by the pimCandidateRPAddressType object. A value of
zero is not permitted for this object."
::= { pimCandidateRPEntry 4 }
pimCandidateRPAddress OBJECT-TYPE pimCandidateRPBidir OBJECT-TYPE
SYNTAX IpAddress SYNTAX TruthValue
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The (unicast) address of the interface which will be "If this object is set to TRUE, this group range is
advertised as a Candidate-RP." advertised to this RP as a BIDIR-PIM group range. If it is
::= { pimCandidateRPEntry 3 } set to FALSE, it is advertised as a PIM-SM group range."
::= { pimCandidateRPEntry 5 }
pimCandidateRPRowStatus OBJECT-TYPE pimCandidateRPStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this row, by which new entries may be "The status of this row, by which new entries may be
created, or old entries deleted from this table." created, or old entries deleted from this table."
::= { pimCandidateRPEntry 4 } ::= { pimCandidateRPEntry 6 }
--
-- The PIM Scope Zone Table
--
pimComponentTable OBJECT-TYPE pimScopeZoneTable OBJECT-TYPE
SYNTAX SEQUENCE OF PimComponentEntry SYNTAX SEQUENCE OF PimScopeZoneEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The (conceptual) table containing objects specific to a PIM "The (conceptual) table containing objects specific to a
domain. One row exists for each domain to which the router scoped region within a PIM-SM domain. One row exists for
is connected. A PIM-SM domain is defined as an area of the each scoped zone in each domain to which the router is
network over which Bootstrap messages are forwarded. connected. A PIM-SM scoped zone is defined as an area
Typically, a PIM-SM router will be a member of exactly one within a PIM-SM domain over which PIM Bootstrap messages for
domain. This table also supports, however, routers which the group range belonging to the scope are forwarded."
may form a border between two PIM-SM domains and do not ::= { pim 9 }
forward Bootstrap messages between them."
::= { pim 12 }
pimComponentEntry OBJECT-TYPE pimScopeZoneEntry OBJECT-TYPE
SYNTAX PimComponentEntry SYNTAX PimScopeZoneEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An entry (conceptual row) in the pimComponentTable." "An entry (conceptual row) in the pimScopeZoneTable."
INDEX { pimComponentIndex } INDEX { pimScopeZoneId }
::= { pimComponentTable 1 } ::= { pimScopeZoneTable 1 }
PimComponentEntry ::= SEQUENCE { PimScopeZoneEntry ::= SEQUENCE {
pimComponentIndex Integer32, pimScopeZoneId Unsigned32,
pimComponentBSRAddress IpAddress, pimScopeZoneCandidateBSR TruthValue,
pimComponentBSRExpiryTime TimeTicks, pimScopeZoneCandidateBSRPriority Unsigned32,
pimComponentCRPHoldTime Integer32, pimScopeZoneBSRAddressType InetAddressType,
pimComponentStatus RowStatus pimScopeZoneBSRAddress InetAddress,
pimScopeZoneBSRExpiryTime TimeTicks,
pimScopeZoneStatus RowStatus
} }
pimComponentIndex OBJECT-TYPE
SYNTAX Integer32 (1..255) pimScopeZoneId OBJECT-TYPE
SYNTAX Unsigned32 (1..255)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A number uniquely identifying the component. Each protocol "A number uniquely identifying an admin scoped zone within a
instance connected to a separate domain should have a domain."
different index value. Routers that only support membership
in a single PIM-SM domain should use a pimComponentIndex
value of 1."
::= { pimComponentEntry 1 }
pimComponentBSRAddress OBJECT-TYPE ::= { pimScopeZoneEntry 1 }
SYNTAX IpAddress
pimScopeZoneCandidateBSR OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Whether or not the local router is a Candidate-BSR."
DEFVAL { false }
::= { pimScopeZoneEntry 2 }
pimScopeZoneCandidateBSRPriority OBJECT-TYPE
SYNTAX Unsigned32 (0..255)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The priority value for the local router as a Candidate-BSR.
Numerically higher values for this object indicate higher
priorities. This object is only used if
pimScopeZoneCandidateBSR is TRUE."
DEFVAL { 0 }
::= { pimScopeZoneEntry 3 }
pimScopeZoneBSRAddressType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The IP address of the bootstrap router (BSR) for the local "The type of address of the bootstrap router (BSR) for the
PIM region." local PIM scoped zone."
::= { pimComponentEntry 2 } ::= { pimScopeZoneEntry 4 }
pimComponentBSRExpiryTime OBJECT-TYPE pimScopeZoneBSRAddress OBJECT-TYPE
SYNTAX TimeTicks SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The minimum time remaining before the bootstrap router in "The address of the bootstrap router (BSR) for the local PIM
the local domain will be declared down. For candidate BSRs, scoped zone. The InetAddressType is given by the
this is the time until the component sends an RP-Set pimScopeZoneBSRAddressType object."
message. For other routers, this is the time until it may ::= { pimScopeZoneEntry 5 }
accept an RP-Set message from a lower candidate BSR."
::= { pimComponentEntry 3 }
pimComponentCRPHoldTime OBJECT-TYPE pimScopeZoneBSRExpiryTime OBJECT-TYPE
SYNTAX Integer32 (0..255) SYNTAX TimeTicks
UNITS "seconds" MAX-ACCESS read-only
MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The holdtime of the component when it is a candidate RP in "The minimum time remaining before the bootstrap router in
the local domain. The value of 0 is used to indicate that the local scoped zone will be declared down. For candidate
the local system is not a Candidate-RP." BSRs, this is the time until the component sends a PIM
DEFVAL { 0 } Bootstrap message. For other routers, this is the time
::= { pimComponentEntry 4 } until it may accept a PIM Bootstrap message from a lower
candidate BSR."
::= { pimScopeZoneEntry 6 }
pimComponentStatus OBJECT-TYPE pimScopeZoneStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this entry. Creating the entry creates "The status of this entry. Creating the entry creates
another protocol instance; destroying the entry disables a another protocol instance; destroying the entry disables a
protocol instance." protocol instance."
::= { pimComponentEntry 5 } ::= { pimScopeZoneEntry 7 }
pimSourceLifetime OBJECT-TYPE
SYNTAX Integer32
UNITS "seconds"
MAX-ACCESS read-create
STATUS current
DESCRIPTION "The maximum time this router will continue to
originate State Refresh messages in the absence of
traffic from the source itself."
DEFVAL { 210 }
::= { pim 13 }
pimStateRefreshInterval OBJECT-TYPE
SYNTAX Integer32 (1..255)
UNITS "seconds"
MAX-ACCESS read-create
STATUS current
DESCRIPTION "The interval between successive State Refresh
messages originated by this router."
DEFVAL { 60 }
::= { pim 14 }
pimStateRefreshLimitInterval OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-create
STATUS current
DESCRIPTION "This router will not forward successive State Refresh
messages received at less than this interval."
DEFVAL { 0 }
::= { pim 15 }
pimStateRefreshTimeToLive OBJECT-TYPE --
SYNTAX Integer32
MAX-ACCESS read-create
STATUS current
DESCRIPTION "The TTL to be used by this router's originated State
Refresh messages if the data packet's TTL is not
recorded."
DEFVAL { 16 }
::= { pim 16 }
-- PIM Traps -- PIM Traps
--
pimNeighborLoss NOTIFICATION-TYPE pimNeighborLoss NOTIFICATION-TYPE
OBJECTS { OBJECTS { pimNeighborUpTime }
pimNeighborIfIndex STATUS current
}
STATUS current
DESCRIPTION DESCRIPTION
"A pimNeighborLoss trap signifies the loss of an adjacency "A pimNeighborLoss trap signifies the loss of an adjacency
with a neighbor. This trap should be generated when the with a neighbor. This trap should be generated when the
neighbor timer expires, and the router has no other neighbor timer expires, and the router has no other
neighbors on the same interface with a lower IP address than neighbors on the same interface with the same IP version and
itself." a lower IP address than itself."
::= { pimTraps 1 } ::= { pimTraps 1 }
--
-- Conformance Information
--
pimMIBConformance OBJECT IDENTIFIER ::= { pimMIB 2 } pimMIBConformance OBJECT IDENTIFIER ::= { pimStdMIB 2 }
pimMIBCompliances OBJECT IDENTIFIER ::= { pimMIBConformance 1 } pimMIBCompliances OBJECT IDENTIFIER ::= { pimMIBConformance 1 }
pimMIBGroups OBJECT IDENTIFIER ::= { pimMIBConformance 2 } pimMIBGroups OBJECT IDENTIFIER ::= { pimMIBConformance 2 }
--
pimV1MIBCompliance MODULE-COMPLIANCE -- Compliance Statements
STATUS deprecated --
DESCRIPTION
"The compliance statement for routers running PIMv1 and
implementing the PIM MIB."
MODULE -- this module
MANDATORY-GROUPS { pimV1MIBGroup }
::= { pimMIBCompliances 1 }
pimSparseV2MIBCompliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The compliance statement for routers running PIM Sparse
Mode and implementing the PIM MIB."
MODULE -- this module
MANDATORY-GROUPS { pimV2MIBGroup }
GROUP pimV2CandidateRPMIBGroup
DESCRIPTION
"This group is mandatory if the router is capable of being a
Candidate RP."
OBJECT pimInterfaceStatus
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required."
::= { pimMIBCompliances 2 }
pimDenseV2MIBCompliance MODULE-COMPLIANCE pimMIBCompliance MODULE-COMPLIANCE
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The compliance statement for routers running PIM Dense Mode "The compliance statement for PIM routers which implement
and implementing the PIM MIB." the PIM MIB."
MODULE -- this module MODULE -- this module
MANDATORY-GROUPS { pimNotificationGroup,
pimObjectGroup }
::= { pimMIBCompliances 1 }
MANDATORY-GROUPS { pimDenseV2MIBGroup } --
-- Units of Conformance
OBJECT pimInterfaceStatus --
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required."
::= { pimMIBCompliances 3 }
pimNotificationGroup NOTIFICATION-GROUP pimNotificationGroup NOTIFICATION-GROUP
NOTIFICATIONS { pimNeighborLoss } NOTIFICATIONS { pimNeighborLoss }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A collection of notifications for signaling important PIM "A collection of notifications for signaling important PIM
events." events."
::= { pimMIBGroups 1 } ::= { pimMIBGroups 1 }
pimV2MIBGroup OBJECT-GROUP pimObjectGroup OBJECT-GROUP
OBJECTS { pimJoinPruneInterval, pimInterfaceIfIndex, OBJECTS { pimInterfaceAddressType,
pimInterfaceAddress, pimInterfaceNetMask, pimInterfaceAddress,
pimInterfaceMode, pimInterfaceDR, pimInterfaceNetMaskLength,
pimInterfaceHelloInterval, pimInterfaceStatus, pimInterfaceDR,
pimInterfaceHelloInterval,
pimInterfaceTrigHelloInterval,
pimInterfaceJoinPruneInterval, pimInterfaceJoinPruneInterval,
pimInterfaceCBSRPreference, pimInterfaceTrigHelloInterval, pimInterfaceDFElectionRobustness,
pimInterfaceHelloHoldtime, pimInterfaceLanPruneDelay, pimInterfaceHelloHoldtime,
pimInterfacePropagationDelay,
pimInterfaceOverrideInterval, pimInterfaceGenerationID,
pimInterfaceJoinPruneHoldtime, pimInterfaceJoinPruneHoldtime,
pimInterfaceLanDelayEnabled, pimInterfaceDRPriority, pimInterfaceUseLanPruneDelay,
pimNeighborAddress, pimNeighborInterfaceIfIndex, pimInterfacePropagationDelay,
pimNeighborUpTime, pimNeighborExpiryTime, pimInterfaceOverrideInterval,
pimNeighborLANPruneDelay, pimNeighborOverrideInterval, pimInterfaceUseGenerationID,
pimNeighborTBit, pimNeighborDRPresent, pimInterfaceGenerationIDValue,
pimIpMRouteUpstreamAssertTimer, pimIpMRouteAssertMetric, pimInterfaceUseDRPriority,
pimIpMRouteIpRouteAssertMetricPref, pimInterfaceDRPriority,
pimIpMRouteAssertRPTBit, pimIpMRouteFlags, pimInterfaceLanDelayEnabled,
pimIpMRouteRPFNeighbor, pimIpMRouteNextHopPruneReason, pimInterfaceEffectPropagDelay,
pimRPSetGroupAddress, pimRPSetGroupMask, pimRPSetAddress, pimInterfaceEffectOverrideIvl,
pimRPSetHoldTime, pimRPSetExpiryTime, pimRPSetComponent, pimInterfaceSuppressionEnabled,
pimComponentBSRAddress, pimComponentBSRExpiryTime, pimInterfaceBidirCapable,
pimComponentCRPHoldTime, pimComponentStatus pimInterfaceDRPriorityEnabled,
} pimInterfaceBSRBorder,
pimInterfaceStatus,
pimNeighborUpTime,
pimNeighborExpiryTime,
pimNeighborLanPruneDelayPresent,
pimNeighborPropagationDelay,
pimNeighborOverrideInterval,
pimNeighborTBit,
pimNeighborGenerationIDPresent,
pimNeighborGenerationIDValue,
pimNeighborBidirCapable,
pimNeighborDRPriorityPresent,
pimNeighborDRPriority,
pimNbrSecAddress,
pimMRouteUpTime,
pimMRouteExpiryTime,
pimMRouteType,
pimMRouteRPAddress,
pimMRouteRPFIfIndex,
pimMRouteRPFNeighbor,
pimMRouteUpstreamAssertTimer,
pimMRouteAssertRPTBit,
pimMRouteAssertMetricPref,
pimMRouteAssertMetric,
pimMRouteFlags,
pimMRouteNextHopUpTime,
pimMRouteNextHopForwarding,
pimMRouteNextHopJoinPruneTimer,
pimMRouteNextHopAssertWinner,
pimMRouteNextHopAssertTimer,
pimMRouteNextHopAssertRPTBit,
pimMRouteNextHopAssertMetricPref,
pimMRouteNextHopAssertMetric,
pimBidirDFElectionWinnerAddress,
pimBidirDFElectionWinnerUpTime,
pimBidirDFElectionWinnerMetricPref,
pimBidirDFElectionWinnerMetric,
pimBidirDFElectionState,
pimBidirDFElectionStateTimer,
pimRPSetBidirGroup,
pimRPSetPriority,
pimRPSetHoldtime,
pimRPSetExpiryTime,
pimRPSetRPActive,
pimCandidateRPBidir,
pimCandidateRPStatus,
pimScopeZoneCandidateBSR,
pimScopeZoneCandidateBSRPriority,
pimScopeZoneBSRAddressType,
pimScopeZoneBSRAddress,
pimScopeZoneBSRExpiryTime,
pimScopeZoneStatus }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A collection of objects to support management of PIM Sparse "A collection of objects for managing PIM routers."
Mode (version 2) routers."
::= { pimMIBGroups 2 } ::= { pimMIBGroups 2 }
pimDenseV2MIBGroup OBJECT-GROUP END
OBJECTS { pimInterfaceIfIndex, pimInterfaceAddress,
pimInterfaceNetMask, pimInterfaceHelloInterval,
pimInterfaceStatus, pimInterfaceTrigHelloInterval,
pimInterfaceHelloHoldtime, pimInterfaceLanPruneDelay,
pimInterfacePropagationDelay, pimInterfaceOverrideInterval,
pimInterfaceGenerationID, pimInterfaceJoinPruneHoldtime,
pimInterfaceGraftRetryInterval,
pimInterfaceMaxGraftRetries, pimInterfaceSRTTLThreshold,
pimInterfaceLanDelayEnabled, pimInterfaceSRCapable,
pimNeighborIfIndex, pimNeighborUpTime,
pimNeighborExpiryTime, pimNeighborLANPruneDelay,
pimNeighborOverrideInterval, pimNeighborSRCapable,
pimIpMRouteSourceTimer, pimIpMRouteOriginatorSRTTL,
pimSourceLifetime, pimStateRefreshInterval,
pimStateRefreshLimitInterval, pimStateRefreshTimeToLive
}
STATUS current
DESCRIPTION
"A collection of objects to support management of PIM Dense
Mode (version 2) routers."
::= { pimMIBGroups 5 }
pimV2CandidateRPMIBGroup OBJECT-GROUP
OBJECTS { pimCandidateRPAddress,
pimCandidateRPRowStatus
}
STATUS current
DESCRIPTION
"A collection of objects to support configuration of which
groups a router is to advertise itself as a Candidate-RP."
::= { pimMIBGroups 3 }
pimV1MIBGroup OBJECT-GROUP 5. Security Considerations
OBJECTS { pimJoinPruneInterval, pimNeighborIfIndex,
pimNeighborUpTime, pimNeighborExpiryTime,
pimNeighborMode,
pimInterfaceAddress, pimInterfaceNetMask,
pimInterfaceJoinPruneInterval, pimInterfaceStatus,
pimInterfaceMode, pimInterfaceDR,
pimInterfaceHelloInterval,
pimRPState, pimRPStateTimer,
pimRPLastChange, pimRPRowStatus
}
STATUS deprecated
DESCRIPTION
"A collection of objects to support management of PIM
(version 1) routers."
::= { pimMIBGroups 4 }
pimNextHopGroup OBJECT-GROUP There are a number of management objects defined in this MIB module
OBJECTS { pimIpMRouteNextHopPruneReason, with a MAX-ACCESS clause of read-write and/or read-create. Such
pimIpMRouteNextHopAssertWinner, objects may be considered sensitive or vulnerable in some network
pimIpMRouteNextHopAssertTimer, environments. The support for SET operations in a non-secure
pimIpMRouteNextHopAssertMetric, environment without proper protection can have a negative effect on
pimIpMRouteNextHopAssertMetricPref, network operations. These are the tables and objects and their
pimIpMRouteNextHopJoinPruneTimer sensitivity/vulnerability:
}
STATUS current
DESCRIPTION
"A collection of optional objects to provide per-next hop
information for diagnostic purposes. Supporting this group
may add a large number of instances to a tree walk, but the
information in this group can be extremely useful in
tracking down multicast connectivity problems."
::= { pimMIBGroups 6 }
pimAssertGroup OBJECT-GROUP TODO.
OBJECTS { pimIpMRouteAssertMetric, pimIpMRouteAssertMetricPref,
pimIpMRouteAssertRPTBit, pimIpMRouteRPFNeighbor}
STATUS current
DESCRIPTION
"A collection of optional objects to provide extra
information about the assert election process. There is no
protocol reason to keep such information, but some
implementations may already keep this information and make
it available. These objects can also be very useful in
debugging connectivity or duplicate packet problems,
especially if the assert winner does not support the PIM and
IP Multicast MIBs."
::= { pimMIBGroups 7 }
END Some of the readable objects in this MIB module (i.e., objects with a
MAX-ACCESS other than not-accessible) may be considered sensitive or
vulnerable in some network environments. It is thus important to
control even GET and/or NOTIFY access to these objects and possibly
to even encrypt the values of these objects when sending them over
the network via SNMP. These are the tables and objects and their
sensitivity/vulnerability:
5. Security Considerations TODO.
This MIB contains readable objects whose values provide information SNMP versions prior to SNMPv3 did not include adequate security.
related to multicast routing, including information on the network Even if the network itself is secure (for example by using IPSec),
topology. There are also a number of objects that have a MAX-ACCESS even then, there is no control as to who on the secure network is
clause of read-write and/or read-create, which allow an administrator allowed to access and GET/SET (read/change/create/delete) the objects
to configure PIM in the router. in this MIB module.
While unauthorized access to the readable objects is relatively It is RECOMMENDED that implementers consider the security features as
innocuous, unauthorized access to the write-able objects could cause provided by the SNMPv3 framework (see [RFC3410], section 8),
a denial of service. Hence, the support for SET operations in a including full support for the SNMPv3 cryptographic mechanisms (for
non-secure environment without proper protection can have a negative authentication and privacy).
effect on network operations.
SNMPv1 by itself is such an insecure environment. Even if the Further, deployment of SNMP versions prior to SNMPv3 is NOT
network itself is secure (for example by using IPSec), even then, RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to
there is no control as to who on the secure network is allowed to enable cryptographic security. It is then a customer/operator
access and SET (change/create/delete) the objects in this MIB. responsibility to ensure that the SNMP entity giving access to an
instance of this MIB module is properly configured to give access to
the objects only to those principals (users) that have legitimate
rights to indeed GET or SET (change/create/delete) them.
It is recommended that the implementers consider the security 6. IANA Considerations
features as provided by the SNMPv3 framework. Specifically, the use
of the User-based Security Model RFC 2274 [12] and the View-based
Access Control Model RFC 2275 [15] is recommended.
It is then a customer/user responsibility to ensure that the SNMP PIM-STD-MIB should be rooted under the mib-2 subtree. IANA is
entity giving access to this MIB, is properly configured to give requested to assign { mib-2 XXX } to the PIM-STD-MIB module specified
access to those objects only to those principals (users) that have in this document.
legitimate rights to access them.
6. Acknowledgements 7. Acknowledgements
This MIB module is based on the original work in RFC 2934 by This MIB module is based on the original work in RFC 2934 [RFC2934]
K. McCloghrie, D. Farinacci, D. Thaler and W. Fenner and has been by K. McCloghrie, D. Farinacci, D. Thaler and W. Fenner and has been
updated based on feedback from the IETF's Protocol Independent updated based on feedback from the IETF's Protocol Independent
Multicast (PIM) Working Group. Multicast (PIM) Working Group.
7. Authors' Addresses Jonathan Nicholas was the editor of early versions of this document.
Jonathan Nicholas 8. References
ITT Industries
Aerospace/Communications Division
100 Kingsland Rd
Clifton, NJ 07014
Phone: +1 973 284 2019 8.1 Normative References
EMail: Jonathan.Nicholas@itt.com
8. References [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[1] Wijnen, B., Harrington, D. and R. Presuhn, "An Architecture for [RFC2434] Narten, T. and H. Alvestrand, "Guidelines for Writing an
Describing SNMP Management Frameworks", RFC 2571, April 1999. IANA Considerations Section in RFCs", BCP 26, RFC 2434,
October 1998.
[2] Rose, M. and K. McCloghrie, "Structure and Identification of [RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J.
Management Information for TCP/IP-based Internets", STD 16, RFC Schoenwaelder, Ed., "Structure of Management Information
1155, May 1990. Version 2 (SMIv2)", STD 58, RFC 2578, April 1999.
[3] Rose, M. and K. McCloghrie, "Concise MIB Definitions", STD 16, [RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J.
RFC 1212, March 1991. Schoenwaelder, Ed., "Textual Conventions for SMIv2",
STD 58, RFC 2579, April 1999.
[4] Rose, M., "A Convention for Defining Traps for use with the [RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder,
SNMP", RFC 1215, March 1991. "Conformance Statements for SMIv2", STD 58, RFC 2580,
April 1999.
[5] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, [RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group
M. and S. Waldbusser, "Structure of Management Information MIB", RFC 2863, June 2000.
Version 2 (SMIv2)", STD 58, RFC 2578, April 1999.
[6] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, [RFC4001] Daniele, M., Haberman, B., Routhier, S., and J.
M. and S. Waldbusser, "Textual Conventions for SMIv2", STD 58, Schoenwaelder, "Textual Conventions for Internet Network
RFC 2579, April 1999. Addresses", RFC 4001, February 2005.
[7] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, [I-D.ietf-pim-sm-v2-new]
M. and S. Waldbusser, "Conformance Statements for SMIv2", STD Fenner, B., Handley, M., Holbrook, H., and I. Kouvelas,
58, RFC 2580, April 1999. "Protocol Independent Multicast - Sparse Mode PIM-SM):
[8] Case, J., Fedor, M., Schoffstall, M. and J. Davin, "Simple Protocol Specification (Revised)",
Network Management Protocol", STD 15, RFC 1157, May 1990. draft-ietf-pim-sm-v2-new-11 (work in progress),
October 2004.
[9] Case, J., McCloghrie, K., Rose, M. and S. Waldbusser, [I-D.ietf-pim-bidir]
"Introduction to Community-based SNMPv2", RFC 1901, January Handley, M., Kouvelas, I., Speakman, T., and L. Vicisano,
1996. "Bi-directional Protocol Independent Multicast (BIDIR-
PIM)", draft-ietf-pim-bidir-07 (work in progress),
March 2005.
[10] Case, J., McCloghrie, K., Rose, M. and S. Waldbusser, "Transport [I-D.ietf-pim-sm-bsr]
Mappings for Version 2 of the Simple Network Management Protocol Bhaskar, N., "Bootstrap Router (BSR) Mechanism for PIM",
(SNMPv2)", RFC 1906, January 1996. draft-ietf-pim-sm-bsr-05 (work in progress),
February 2005.
[11] Case, J., Harrington D., Presuhn R. and B. Wijnen, "Message [RFC3956] Savola, P. and B. Haberman, "Embedding the Rendezvous
Processing and Dispatching for the Simple Network Management Point (RP) Address in an IPv6 Multicast Address",
Protocol (SNMP)", RFC 2572, April 1999. RFC 3956, November 2004.
[12] Blumenthal, U. and B. Wijnen, "User-based Security Model (USM) 8.2 Informative References
for version 3 of the Simple Network Management Protocol
(SNMPv3)", RFC 2574, April 1999.
[13] Case, J., McCloghrie, K., Rose, M. and S. Waldbusser, "Protocol [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart,
Operations for Version 2 of the Simple Network Management "Introduction and Applicability Statements for Internet-
Protocol (SNMPv2)", RFC 1905, January 1996. Standard Management Framework", RFC 3410, December 2002.
[14] Levi, D., Meyer, P. and B. Stewart, "SNMPv3 Applications", RFC [RFC2932] McCloghrie, K., Farinacci, D., and D. Thaler, "IPv4
2573, April 1999. Multicast Routing MIB", RFC 2932, October 2000.
[15] Wijnen, B., Presuhn, R. and K. McCloghrie, "View-based Access [RFC2934] McCloghrie, K., Farinacci, D., Thaler, D., and B. Fenner,
Control Model (VACM) for the Simple Network Management Protocol "Protocol Independent Multicast MIB for IPv4", RFC 2934,
(SNMP)", RFC 2575, April 1999. October 2000.
[18] Estrin, D., Farinacci, D., Helmy, A., Thaler, D., Deering, S., Authors' Addresses
Handley, M., Jacobson, V., Liu, C., Sharma, P. and L. Wei,
"Protocol Independent Multicast - Sparse Mode (PIM-SM): Protocol
Specification", RFC 2362, June 1998.
[19] Adams, A., Nicholas, J., Siadak, W., "Protocol Independent Raghava Sivaramu
Multicast - Dense Mode (PIM-DM): Protocol Specification Cisco Systems
(Revised)", draft-ietf-pim-dm-new-v2-02.txt, work in progress. 425 E. Tasman Drive
San Jose CA 95134
USA
[20] McCloghrie, K., Farinacci, D. and D. Thaler, "IPv4 Multicast Email: raghava@cisco.com
Routing MIB", RFC 2932, October 2000. James Lingard
Data Connection Ltd
100 Church Street
Enfield EN2 6BQ
United Kingdom
[21] Fenner, W., Handley, M., Holbrook, H., Kouvelas, I., Email: james.lingard@dataconnection.com
"Protocol Independent Multicast - Sparse Mode (PIM-SM)", draft-
ietf-pim-sm-v2-new-05.txt, work in progress.
[22] McCloghrie, K., Farinacci, D., Thaler, D., Fenner, W., Bharat Joshi
"Protocol Independent Multicast MIB for IPv4", RFC 2934, Infosys Technologies Ltd
October 2000. Electronic City
Bangalore 560 100
India
Email: bharat_joshi@infosys.com
Intellectual Property Statement
The IETF takes no position regarding the validity or scope of any
Intellectual Property Rights or other rights that might be claimed to
pertain to the implementation or use of the technology described in
this document or the extent to which any license under such rights
might or might not be available; nor does it represent that it has
made any independent effort to identify any such rights. Information
on the procedures with respect to rights in RFC documents can be
found in BCP 78 and BCP 79.
Copies of IPR disclosures made to the IETF Secretariat and any
assurances of licenses to be made available, or the result of an
attempt made to obtain a general license or permission for the use of
such proprietary rights by implementers or users of this
specification can be obtained from the IETF on-line IPR repository at
http://www.ietf.org/ipr.
The IETF invites any interested party to bring to its attention any
copyrights, patents or patent applications, or other proprietary
rights that may cover technology that may be required to implement
this standard. Please address the information to the IETF at
ietf-ipr@ietf.org.
Disclaimer of Validity
This document and the information contained herein are provided on an
"AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Copyright Statement
Copyright (C) The Internet Society (2005). This document is subject
to the rights, licenses and restrictions contained in BCP 78, and
except as set forth therein, the authors retain all their rights.
Acknowledgment
Funding for the RFC Editor function is currently provided by the
Internet Society.
 End of changes. 264 change blocks. 
956 lines changed or deleted 1435 lines changed or added

This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/