PIM-MIB

All MIBs › PIM-MIB

Organization: IETF IDMR Working Group.

Last Updated: 2000-09-28

Category: Routing Protocols

Description: Defines managed objects for managing the Protocol Independent Multicast (PIM) routing protocol for IPv4 multicast traffic.

IPNetwork Monitor uses several OIDs from this MIB in network discovery and polling the applicable devices. Start monitoring PIM-MIB with a free 30-day trial of IPNetwork Monitor.

What Is PIM-MIB?

PIM-MIB is an IETF standards-based MIB module for managing routers running Protocol Independent Multicast (PIM), the multicast routing protocol used to build distribution trees for IPv4 multicast traffic. It exposes configuration and operational data for PIM-enabled interfaces, such as join/prune timers, hello intervals, designated router election, and candidate bootstrap router preferences. Administrators use it primarily to monitor the operational health of multicast routing on a device — verifying which interfaces are actively running PIM, tracking designated-router state, and confirming interface status is up rather than administratively down or failed. The PIM-MIB MIB depends on general IP and interface conventions (via ifIndex references) and is typically used alongside other multicast MIBs such as IGMP-STD-MIB. It is commonly deployed in enterprise and service-provider routers/switches that participate in IP multicast distribution, such as those carrying IPTV or financial market data feeds.

IPNetwork Monitor allows you to monitor SNMP objects defined in PIM-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

Multicast-capable routers
Layer 3 switches
vendor-neutral, standards-based MIB, not tied to a specific manufacturer

Monitoring Examples

An admin would poll pimInterfaceTable/pimInterfaceEntry indexed by pimInterfaceIfIndex to see per-interface PIM mode, address, netmask, and pimInterfaceStatus. If pimInterfaceStatus shows an interface unexpectedly down or pimInterfaceDR changes unexpectedly, it indicates a multicast routing adjacency problem. Monitoring pimInterfaceHelloInterval and pimInterfaceJoinPruneInterval against configured baselines helps confirm timer consistency across neighboring routers, and pimInterfaceCBSRPreference reveals bootstrap router priority for RP-election troubleshooting.

What Can Be Monitored

PIM interface operational status
designated router (DR) identity
hello interval timers
join/prune interval timers
bootstrap router preference
PIM interface mode (sparse/dense)

Imported Objects

From IF-MIB

InterfaceIndex

From IPMROUTE-STD-MIB

ipMRouteGroup	OBJECT-TYPE
ipMRouteNextHopAddress	OBJECT-TYPE
ipMRouteNextHopGroup	OBJECT-TYPE
ipMRouteNextHopIfIndex	OBJECT-TYPE
ipMRouteNextHopSource	OBJECT-TYPE
ipMRouteNextHopSourceMask	OBJECT-TYPE
ipMRouteSource	OBJECT-TYPE
ipMRouteSourceMask	OBJECT-TYPE

From SNMPv2-CONF

MODULE-COMPLIANCE
NOTIFICATION-GROUP
OBJECT-GROUP

From SNMPv2-SMI

Integer32
IpAddress
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE
TimeTicks
experimental

From SNMPv2-TC

RowStatus
TruthValue

How to Use in IPNetwork Monitor

Example using pimNeighborUpTime OID:

Select a multicast-capable router or Layer 3 switch running PIM as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type pimNeighborUpTime into the Find box to locate it in the OID tree, selecting the specific row/instance you want to monitor since this is a table column, then select it and click OK. It reports how long this PIM neighbor relationship has been continuously up. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is a TimeTicks-type OID, Value bounds is the most useful condition here — trigger an alert if the value resets to a low number unexpectedly, since that indicates the neighbor relationship dropped and re-formed. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
pim	1.3.6.1.3.61.1.1
pimAssertGroup	1.3.6.1.3.61.2.2.7			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.
IP pimCandidateRPAddress	1.3.6.1.3.61.1.1.11.1.3	IpAddress	read-create	The (unicast) address of the interface which will be advertised as a Candidate-RP.
pimCandidateRPEntry	1.3.6.1.3.61.1.1.11.1		not-accessible	An entry (conceptual row) in the pimCandidateRPTable.
IP pimCandidateRPGroupAddress	1.3.6.1.3.61.1.1.11.1.1	IpAddress	not-accessible	The IP multicast group address which, when combined with pimCandidateRPGroupMask, identifies a group prefix for which the local router will advertise itself as a Candidate-RP.
IP pimCandidateRPGroupMask	1.3.6.1.3.61.1.1.11.1.2	IpAddress	not-accessible	The multicast group address mask which, when combined with pimCandidateRPGroupMask, identifies a group prefix for which the local router will advertise itself as a Candidate-RP.
ROW pimCandidateRPRowStatus	1.3.6.1.3.61.1.1.11.1.4	RowStatus	read-create	The status of this row, by which new entries may be created, or old entries deleted from this table.
pimCandidateRPTable	1.3.6.1.3.61.1.1.11		not-accessible	The (conceptual) table listing the IP multicast groups for which the local router is to advertise itself as a Candidate-RP when the value of pimComponentCRPHoldTime is non-zero. If this table is empty, then the local router will advertise itself as a Candidate-RP for all groups (providing the value of pimComponentCRPHoldTime is non- zero).
IP pimComponentBSRAddress	1.3.6.1.3.61.1.1.12.1.2	IpAddress	read-only	The IP address of the bootstrap router (BSR) for the local PIM region.
TIK pimComponentBSRExpiryTime	1.3.6.1.3.61.1.1.12.1.3	TimeTicks	read-only	The minimum time remaining before the bootstrap router in the local domain will be declared down. For candidate BSRs, this is the time until the component sends an RP-Set message. For other routers, this is the time until it may accept an RP-Set message from a lower candidate BSR.
I32 pimComponentCRPHoldTime	1.3.6.1.3.61.1.1.12.1.4	Integer32	read-create	The holdtime of the component when it is a candidate RP in the local domain. The value of 0 is used to indicate that the local system is not a Candidate-RP.
pimComponentEntry	1.3.6.1.3.61.1.1.12.1		not-accessible	An entry (conceptual row) in the pimComponentTable.
I32 pimComponentIndex	1.3.6.1.3.61.1.1.12.1.1	Integer32	not-accessible	A number uniquely identifying the component. Each protocol instance connected to a separate domain should have a different index value. Routers that only support membership in a single PIM-SM domain should use a pimComponentIndex value of 1.
ROW pimComponentStatus	1.3.6.1.3.61.1.1.12.1.5	RowStatus	read-create	The status of this entry. Creating the entry creates another protocol instance; destroying the entry disables a protocol instance.
pimComponentTable	1.3.6.1.3.61.1.1.12		not-accessible	The (conceptual) table containing objects specific to a PIM domain. One row exists for each domain to which the router is connected. A PIM-SM domain is defined as an area of the network over which Bootstrap messages are forwarded. Typically, a PIM-SM router will be a member of exactly one domain. This table also supports, however, routers which may form a border between two PIM-SM domains and do not forward Bootstrap messages between them.
pimDenseV2MIBCompliance	1.3.6.1.3.61.2.1.3			The compliance statement for routers running PIM Dense Mode and implementing the PIM MIB.
pimDenseV2MIBGroup	1.3.6.1.3.61.2.2.5			A collection of objects to support management of PIM Dense Mode (version 2) routers.
IP pimInterfaceAddress	1.3.6.1.3.61.1.1.2.1.2	IpAddress	read-only	The IP address of the PIM interface.
I32 pimInterfaceCBSRPreference	1.3.6.1.3.61.1.1.2.1.9	Integer32	read-create	The preference value for the local interface as a candidate bootstrap router. The value of -1 is used to indicate that the local interface is not a candidate BSR interface.
IP pimInterfaceDR	1.3.6.1.3.61.1.1.2.1.5	IpAddress	read-only	The Designated Router on this PIM interface. For point-to- point interfaces, this object has the value 0.0.0.0.
pimInterfaceEntry	1.3.6.1.3.61.1.1.2.1		not-accessible	An entry (conceptual row) in the pimInterfaceTable.
I32 pimInterfaceHelloInterval	1.3.6.1.3.61.1.1.2.1.6	Integer32	read-create	The frequency at which PIM Hello messages are transmitted on this interface.
NUM pimInterfaceIfIndex	1.3.6.1.3.61.1.1.2.1.1	InterfaceIndex	not-accessible	The ifIndex value of this PIM interface.
I32 pimInterfaceJoinPruneInterval	1.3.6.1.3.61.1.1.2.1.8	Integer32	read-create	The frequency at which PIM Join/Prune messages are transmitted on this PIM interface. The default value of this object is the pimJoinPruneInterval.
INT pimInterfaceMode	1.3.6.1.3.61.1.1.2.1.4	INTEGER	read-create	The configured mode of this PIM interface. A value of sparseDense is only valid for PIMv1.
IP pimInterfaceNetMask	1.3.6.1.3.61.1.1.2.1.3	IpAddress	read-only	The network mask for the IP address of the PIM interface.
ROW pimInterfaceStatus	1.3.6.1.3.61.1.1.2.1.7	RowStatus	read-create	The status of this entry. Creating the entry enables PIM on the interface; destroying the entry disables PIM on the interface.
pimInterfaceTable	1.3.6.1.3.61.1.1.2		not-accessible	The (conceptual) table listing the router's PIM interfaces. IGMP and PIM are enabled on all interfaces listed in this table.
I32 pimIpMRouteAssertMetric	1.3.6.1.3.61.1.1.4.1.2	Integer32	read-only	The metric advertised by the assert winner on the upstream interface, or 0 if no such assert is in received.
I32 pimIpMRouteAssertMetricPref	1.3.6.1.3.61.1.1.4.1.3	Integer32	read-only	The preference advertised by the assert winner on the upstream interface, or 0 if no such assert is in effect.
T/F pimIpMRouteAssertRPTBit	1.3.6.1.3.61.1.1.4.1.4	TruthValue	read-only	The value of the RPT-bit advertised by the assert winner on the upstream interface, or false if no such assert is in effect.
pimIpMRouteEntry	1.3.6.1.3.61.1.1.4.1		not-accessible	An entry (conceptual row) in the pimIpMRouteTable. There is one entry per entry in the ipMRouteTable whose incoming interface is running PIM.
BIT pimIpMRouteFlags	1.3.6.1.3.61.1.1.4.1.5	Bits	read-only	This object describes PIM-specific flags related to a multicast state entry. See the PIM Sparse Mode specification for the meaning of the RPT and SPT bits.
pimIpMRouteNextHopEntry	1.3.6.1.3.61.1.1.7.1		not-accessible	An entry (conceptual row) in the pimIpMRouteNextHopTable. There is one entry per entry in the ipMRouteNextHopTable whose interface is running PIM and whose ipMRouteNextHopState is pruned(1).
INT pimIpMRouteNextHopPruneReason	1.3.6.1.3.61.1.1.7.1.2	INTEGER	read-only	This object indicates why the downstream interface was pruned, whether in response to a PIM prune message or due to PIM Assert processing.
pimIpMRouteNextHopTable	1.3.6.1.3.61.1.1.7		not-accessible	The (conceptual) table listing PIM-specific information on a subset of the rows of the ipMRouteNextHopTable defined in the IP Multicast MIB.
pimIpMRouteTable	1.3.6.1.3.61.1.1.4		not-accessible	The (conceptual) table listing PIM-specific information on a subset of the rows of the ipMRouteTable defined in the IP Multicast MIB.
TIK pimIpMRouteUpstreamAssertTimer	1.3.6.1.3.61.1.1.4.1.1	TimeTicks	read-only	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 Sparse and Dense mode specification. A value of 0 indicates that no Assert has changed the upstream neighbor away from the RPF neighbor.
I32 pimJoinPruneInterval	1.3.6.1.3.61.1.1.1	Integer32	read-write	The default interval at which periodic PIM-SM Join/Prune messages are to be sent.
pimMIB	1.3.6.1.3.61			The MIB module for management of PIM routers.
pimMIBCompliances	1.3.6.1.3.61.2.1
pimMIBConformance	1.3.6.1.3.61.2
pimMIBGroups	1.3.6.1.3.61.2.2
pimMIBObjects	1.3.6.1.3.61.1
IP pimNeighborAddress	1.3.6.1.3.61.1.1.3.1.1	IpAddress	not-accessible	The IP address of the PIM neighbor for which this entry contains information.
pimNeighborEntry	1.3.6.1.3.61.1.1.3.1		not-accessible	An entry (conceptual row) in the pimNeighborTable.
TIK pimNeighborExpiryTime	1.3.6.1.3.61.1.1.3.1.4	TimeTicks	read-only	The minimum time remaining before this PIM neighbor will be aged out.
NUM pimNeighborIfIndex	1.3.6.1.3.61.1.1.3.1.2	InterfaceIndex	read-only	The value of ifIndex for the interface used to reach this PIM neighbor.
NTF pimNeighborLoss	1.3.6.1.3.61.1.0.1			A pimNeighborLoss trap signifies the loss of an adjacency with a neighbor. This trap should be generated when the neighbor timer expires, and the router has no other neighbors on the same interface with a lower IP address than itself.
INT pimNeighborMode	1.3.6.1.3.61.1.1.3.1.5	INTEGER	read-only	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.
pimNeighborTable	1.3.6.1.3.61.1.1.3		not-accessible	The (conceptual) table listing the router's PIM neighbors.
TIK pimNeighborUpTimeEx	1.3.6.1.3.61.1.1.3.1.3	TimeTicks	read-only	The time since this PIM neighbor (last) became a neighbor of the local router.
pimNextHopGroup	1.3.6.1.3.61.2.2.6			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.
pimNotificationGroup	1.3.6.1.3.61.2.2.1			A collection of notifications for signaling important PIM events.
IP pimRPAddress	1.3.6.1.3.61.1.1.5.1.2	IpAddress	not-accessible	The unicast address of the RP.
pimRPEntry	1.3.6.1.3.61.1.1.5.1		not-accessible	An entry (conceptual row) in the pimRPTable. There is one entry per RP address for each IP multicast group.
IP pimRPGroupAddress	1.3.6.1.3.61.1.1.5.1.1	IpAddress	not-accessible	The IP multicast group address for which this entry contains information about an RP.
TIK pimRPLastChange	1.3.6.1.3.61.1.1.5.1.5	TimeTicks	read-only	The value of sysUpTime at the time when the corresponding instance of pimRPState last changed its value.
ROW pimRPRowStatus	1.3.6.1.3.61.1.1.5.1.6	RowStatus	read-create	The status of this row, by which new entries may be created, or old entries deleted from this table.
IP pimRPSetAddress	1.3.6.1.3.61.1.1.6.1.3	IpAddress	not-accessible	The IP address of the Candidate-RP.
I32 pimRPSetComponent	1.3.6.1.3.61.1.1.6.1.6	Integer32	not-accessible	A number uniquely identifying the component. Each protocol instance connected to a separate domain should have a different index value.
pimRPSetEntry	1.3.6.1.3.61.1.1.6.1		not-accessible	An entry (conceptual row) in the pimRPSetTable.
TIK pimRPSetExpiryTime	1.3.6.1.3.61.1.1.6.1.5	TimeTicks	read-only	The minimum time remaining before the Candidate-RP will be declared down. If the local router is not the BSR, this value is 0.
IP pimRPSetGroupAddress	1.3.6.1.3.61.1.1.6.1.1	IpAddress	not-accessible	The IP multicast group address which, when combined with pimRPSetGroupMask, gives the group prefix for which this entry contains information about the Candidate-RP.
IP pimRPSetGroupMask	1.3.6.1.3.61.1.1.6.1.2	IpAddress	not-accessible	The multicast group address mask which, when combined with pimRPSetGroupAddress, gives the group prefix for which this entry contains information about the Candidate-RP.
I32 pimRPSetHoldTime	1.3.6.1.3.61.1.1.6.1.4	Integer32	read-only	The holdtime of a Candidate-RP. If the local router is not the BSR, this value is 0.
pimRPSetTable	1.3.6.1.3.61.1.1.6		not-accessible	The (conceptual) table listing PIM information for candidate Rendezvous Points (RPs) for IP multicast groups. When the local router is the BSR, this information is obtained from received Candidate-RP-Advertisements. When the local router is not the BSR, this information is obtained from received RP-Set messages.
INT pimRPState	1.3.6.1.3.61.1.1.5.1.3	INTEGER	read-only	The state of the RP.
TIK pimRPStateTimer	1.3.6.1.3.61.1.1.5.1.4	TimeTicks	read-only	The minimum time remaining before the next state change. When pimRPState is up, this is the minimum time which must expire until it can be declared down. When pimRPState is down, this is the time until it will be declared up (in order to retry).
pimRPTable	1.3.6.1.3.61.1.1.5		not-accessible	The (conceptual) table listing PIM version 1 information for the Rendezvous Points (RPs) for IP multicast groups. This table is deprecated since its function is replaced by the pimRPSetTable for PIM version 2.
pimSparseV2MIBCompliance	1.3.6.1.3.61.2.1.2			The compliance statement for routers running PIM Sparse Mode and implementing the PIM MIB.
pimTraps	1.3.6.1.3.61.1.0
pimV1MIBCompliance	1.3.6.1.3.61.2.1.1			The compliance statement for routers running PIMv1 and implementing the PIM MIB.
pimV1MIBGroup	1.3.6.1.3.61.2.2.4			A collection of objects to support management of PIM (version 1) routers.
pimV2CandidateRPMIBGroup	1.3.6.1.3.61.2.2.3			A collection of objects to support configuration of which groups a router is to advertise itself as a Candidate-RP.
pimV2MIBGroup	1.3.6.1.3.61.2.2.2			A collection of objects to support management of PIM Sparse Mode (version 2) routers.

FAQ

What does PIM-MIB let me check on a multicast routing setup?
It exposes PIM-enabled interface configuration and operational data such as join/prune timers, hello intervals, designated router election, and candidate bootstrap router preferences.

How would this MIB help diagnose a multicast distribution problem, e.g. for IPTV?
An administrator would poll PIM interface operational status and designated-router (DR) identity to verify which interfaces are actively running PIM and confirm they're up rather than administratively down or failed, using ifIndex references to tie PIM state to the underlying interfaces, typically alongside IGMP-STD-MIB in enterprise or service-provider networks carrying IPTV or market-data multicast feeds.

RFC description

Protocol Independent Multicast MIB (RFC 5060) for managing PIM-SM, PIM-DM, and BIDIR-PIM multicast routing protocols in IPv4 and IPv6 networks.

Start monitoring Multicast-capable routers/Layer 3 switches, vendor-neutral standards MIB (PIM routing) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download PIM-MIB