The (conceptual) table listing the router's PIM interfaces.
PIM is enabled on all interfaces listed in this table.
The indexes of the table are pimInterfaceIfIndex, pimInterfaceIPVersion.
OID |
Object |
Syntax |
Max Access |
Description |
Implemented Specifications |
---|---|---|---|---|---|
1.3.6.1.2.1.157.1.1.1.1 |
pimInterfaceIfIndex |
INTEGER |
not-accessible |
The ifIndex value of this PIM interface. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.157.1.1.1.2 |
pimInterfaceIPVersion |
INTEGER{unknown(0),ipv4(1),ipv6(2)} |
not-accessible |
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. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.157.1.1.1.3 |
pimInterfaceAddressType |
INTEGER{unknown(0),ipv4(1),ipv6(2),ipv4z(3),ipv6z(4),dns(16)} |
read-only |
The address type of this PIM interface. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.157.1.1.1.4 |
pimInterfaceAddress |
OCTET STRING{(0,0),(4,4),(8,8),(16,16),(20,20)} |
read-only |
The primary IP address of this router on this PIM interface. The InetAddressType is given by the pimInterfaceAddressType object. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.157.1.1.1.5 |
pimInterfaceGenerationIDValue |
Unsigned32 |
read-only |
The value of the Generation ID this router inserted in the last PIM Hello message it sent on this interface. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.157.1.1.1.6 |
pimInterfaceDR |
OCTET STRING{(0,0),(4,4),(8,8),(16,16),(20,20)} |
read-only |
The primary IP address of the Designated Router on this PIM interface. The InetAddressType is given by the pimInterfaceAddressType object. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.157.1.1.1.7 |
pimInterfaceDRPriority |
Unsigned32 |
read-create |
The Designated Router Priority value inserted into the DR Priority option in PIM Hello messages transmitted on this interface. Numerically higher values for this object indicate higher priorities. |
Currently, only the Get operation is supported. |
1.3.6.1.2.1.157.1.1.1.8 |
pimInterfaceDRPriorityEnabled |
INTEGER{true(1),false(2)} |
read-only |
Evaluates to TRUE if all routers on this interface are using the DR Priority option. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.157.1.1.1.9 |
pimInterfaceHelloInterval |
Unsigned32{(0,18000)} |
read-create |
The frequency at which PIM Hello messages are transmitted on this interface. This object corresponds to the 'Hello_Period' timer value defined in the PIM-SM specification. A value of zero represents an 'infinite' interval, and indicates that periodic PIM Hello messages should not be sent on this interface. |
The actually supported value range is 1-18000. Currently, the Set operation is not supported. |
1.3.6.1.2.1.157.1.1.1.10 |
pimInterfaceTrigHelloInterval |
Unsigned32{(0,60)} |
read-create |
The maximum time before this router sends a triggered PIM Hello message on this interface. This object corresponds to the 'Trigered_Hello_Delay' timer value defined in the PIM-SM specification. A value of zero has no special meaning and indicates that triggered PIM Hello messages should always be sent immediately. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.157.1.1.1.11 |
pimInterfaceHelloHoldtime |
Unsigned32{(0,65535)} |
read-create |
The value set in the Holdtime field of PIM Hello messages 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 zero. |
Currently, the Set operation is not supported. |
1.3.6.1.2.1.157.1.1.1.12 |
pimInterfaceJoinPruneInterval |
Unsigned32{(0,18000)} |
read-create |
The frequency at which this router sends PIM Join/Prune messages on this PIM interface. This object corresponds to the 't_periodic' timer value defined in the PIM-SM specification. A value of zero represents an 'infinite' interval, and indicates that periodic PIM Join/Prune messages should not be sent on this interface. |
Currently, the Set operation is not supported. |
1.3.6.1.2.1.157.1.1.1.13 |
pimInterfaceJoinPruneHoldtime |
Unsigned32{(0,65535)} |
read-create |
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 zero. PIM-DM implementations are recommended to use the value of pimInterfacePruneLimitInterval. |
Currently, the Set operation is not supported. |
1.3.6.1.2.1.157.1.1.1.14 |
pimInterfaceDFElectionRobustness |
Unsigned32 |
read-create |
The minimum number of PIM DF-Election messages that must be lost in order for DF election on this interface to fail. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.157.1.1.1.15 |
pimInterfaceLanDelayEnabled |
INTEGER{true(1),false(2)} |
read-only |
Evaluates to TRUE if all routers on this interface are using the LAN Prune Delay option. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.157.1.1.1.16 |
pimInterfacePropagationDelay |
Unsigned32{(0,32767)} |
read-create |
The expected propagation delay between PIM routers on this network or link. This router inserts this value into the Propagation_Delay field of the LAN Prune Delay option in the PIM Hello messages sent on this interface. Implementations SHOULD enforce a lower bound on the permitted values for this object to allow for scheduling and processing delays within the local router. |
The actually supported access is read-only. Currently, the Set operation is not supported. |
1.3.6.1.2.1.157.1.1.1.17 |
pimInterfaceOverrideInterval |
Unsigned32{(0,65535)} |
read-create |
The value this router inserts into the Override_Interval field of the LAN Prune Delay option in the PIM Hello messages it sends on this interface. When overriding a prune, PIM routers pick a random timer duration up to the value of this object. The more PIM routers that are active on a network, the more likely it is that the prune will be overridden after a small proportion of this time has elapsed. The more PIM routers are active on this network, the larger this object should be to obtain an optimal spread of prune override latencies. |
The actually supported access is read-only. Currently, the Set operation is not supported. |
1.3.6.1.2.1.157.1.1.1.18 |
pimInterfaceEffectPropagDelay |
Unsigned32{(0,32767)} |
read-only |
The Effective Propagation Delay on this interface. This object is always 500 if pimInterfaceLanDelayEnabled is FALSE. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.157.1.1.1.19 |
pimInterfaceEffectOverrideIvl |
Unsigned32{(0,65535)} |
read-only |
The Effective Override Interval on this interface. This object is always 2500 if pimInterfaceLanDelayEnabled is FALSE. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.157.1.1.1.20 |
pimInterfaceSuppressionEnabled |
INTEGER{true(1),false(2)} |
read-only |
Whether join suppression is enabled on this interface. This object is always TRUE if pimInterfaceLanDelayEnabled is FALSE. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.157.1.1.1.21 |
pimInterfaceBidirCapable |
INTEGER{true(1),false(2)} |
read-only |
Evaluates to TRUE if all routers on this interface are using the Bidirectional-PIM Capable option. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.157.1.1.1.22 |
pimInterfaceDomainBorder |
INTEGER{true(1),false(2)} |
read-create |
Whether or not this interface is a PIM domain border. This includes acting as a border for PIM Bootstrap Router (BSR) messages, if the BSR mechanism is in use. |
The actually supported access is read-only. Currently, the Set operation is not supported. |
1.3.6.1.2.1.157.1.1.1.23 |
pimInterfaceStubInterface |
INTEGER{true(1),false(2)} |
read-create |
Whether this interface is a 'stub interface'. If this object is set to TRUE, then no PIM packets are sent out this interface, and any received PIM packets are ignored. Setting this object to TRUE is a security measure for interfaces towards untrusted hosts. This allows an interface to be configured for use with IGMP (Internet Group Management Protocol) or MLD (Multicast Listener Discovery) only, which protects the PIM router from forged PIM messages on the interface. To communicate with other PIM routers using this interface, this object must remain set to FALSE. Changing the value of this object while the interface is operational causes PIM to be disabled and then re-enabled on this interface. |
The actually supported access is read-only. Currently, the Set operation is not supported. |
1.3.6.1.2.1.157.1.1.1.24 |
pimInterfacePruneLimitInterval |
Unsigned32{(0,65535)} |
read-create |
The minimum interval that must transpire between two successive Prunes sent by a router. This object corresponds to the 't_limit' timer value defined in the PIM-DM specification. This object is used only by PIM-DM. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.157.1.1.1.25 |
pimInterfaceGraftRetryInterval |
Unsigned32{(0,65535)} |
read-create |
The minimum interval that must transpire between two successive Grafts sent by a router. This object corresponds to the 'Graft_Retry_Period' timer value defined in the PIM-DM specification. This object is used only by PIM-DM. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.157.1.1.1.26 |
pimInterfaceSRPriorityEnabled |
INTEGER{true(1),false(2)} |
read-only |
Evaluates to TRUE if all routers on this interface are using the State Refresh option. This object is used only by PIM-DM. |
This object is implemented as defined in the corresponding MIB files. |
1.3.6.1.2.1.157.1.1.1.27 |
pimInterfaceStatus |
INTEGER{active(1),notInService(2),notReady(3),createAndGo(4),createAndWait(5),destroy(6)} |
read-create |
The status of this entry. Creating the entry enables PIM on the interface; destroying the entry disables PIM on the interface. This status object can be set to active(1) without setting any other columnar objects in this entry. All writable objects in this entry can be modified when the status of this entry is active(1). |
The actually supported access is read-only. Currently, the Set operation is not supported. |
1.3.6.1.2.1.157.1.1.1.28 |
pimInterfaceStorageType |
INTEGER{other(1),volatile(2),nonVolatile(3),permanent(4),readOnly(5)} |
read-create |
The storage type for this row. Rows having the value 'permanent' need not allow write-access to any columnar objects in the row. |
The actually supported access is read-only. Currently, the Set operation is not supported. |