One document matched: draft-ietf-pim-mib-v2-02.txt
Differences from draft-ietf-pim-mib-v2-01.txt
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
Protocol Independent Multicast MIB
draft-ietf-pim-mib-v2-02.txt
Status of this Memo
By submitting this Internet-Draft, each author represents that any
applicable patent or other IPR claims of which he or she is aware
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 working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that
other groups may also distribute working documents as Internet-
Drafts.
Internet-Drafts are draft documents valid for a maximum of six months
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 current Internet-Drafts can be accessed at
http://www.ietf.org/ietf/1id-abstracts.txt.
The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html.
This Internet-Draft will expire on October 31, 2005.
Copyright Notice
Copyright (C) The Internet Society (2005).
Abstract
This memo defines a portion of the Management Information Base (MIB)
for use with network management protocols in the Internet community.
In particular, it describes managed objects used for managing the
Protocol Independent Multicast (PIM) protocols (PIM-SM and BIDIR-
PIM). This document obsoletes RFC 2934.
Sivaramu, et al. Expires October 31, 2005 [Page 1]
Internet-Draft PIM MIB April 2005
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
Sivaramu, et al. Expires October 31, 2005 [Page 2]
Internet-Draft PIM MIB April 2005
1. Introduction
This memo defines a portion of the Management Information Base (MIB)
for use with network management protocols in the Internet community.
In particular, it describes managed objects used for managing the
Protocol Independent Multicast (PIM) protocols (PIM-SM [I-D.ietf-pim-
sm-v2-new] and BIDIR-PIM [I-D.ietf-pim-bidir]).
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.
o This MIB module is independent of IP version, whereas RFC 2934
only supported IPv4.
o This MIB module includes support for managing BIDIR-PIM.
o This MIB module does not include support for managing PIM-DM.
o This MIB module does not include support for managing PIM-SM v1.
o This MIB module does not depend on the IPv4 Multicast Routing MIB
defined in RFC 2932 [RFC2932].
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in RFC 2119 [RFC2119].
2. The Internet-Standard Management Framework
For a detailed overview of the documents that describe the current
Internet-Standard Management Framework, please refer to section 7 of
RFC 3410 [RFC3410].
Managed objects are accessed via a virtual information store, termed
the Management Information Base or MIB. MIB objects are generally
accessed through the Simple Network Management Protocol (SNMP).
Objects in the MIB are defined using the mechanisms defined in the
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
This MIB module contains the following tables.
Sivaramu, et al. Expires October 31, 2005 [Page 3]
Internet-Draft PIM MIB April 2005
1. The PIM Interface Table, which contains one row per IP version
for each interface of the router which is running PIM.
2. The PIM Neighbor Table, which contains one row for each of the
router's PIM neighbors.
3. The PIM Neighbor Secondary Address Table, which contains one row
for each secondary address advertised by each of the router's PIM
neighbors.
4. The PIM Multicast Route Table, which contains one row for each
multicast routing entry created by PIM.
5. The PIM Next Hop Table, which contains one row for each outgoing
interface list entry in the multicast routing table whose
interface is running PIM.
6. The PIM Bidir DF-Election Table, which contains one row per
interface for each Rendezvous Point (RP) for which Bidirectional-
PIM Designated Forwarder (DF) election state is maintained.
7. The PIM RP-Set Table, which contains information about all the
available Rendezvous Points for IP multicast group addresses with
particular address prefixes.
8. The PIM Candidate-RP Table, which contains the IP multicast group
prefixes for which the local router is to advertise itself as a
Candidate-RP.
9. The PIM Scope Zone Table, which contains one row for each of the
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
PIM-STD-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, mib-2,
NOTIFICATION-TYPE,
Unsigned32, TimeTicks FROM SNMPv2-SMI
RowStatus, TruthValue FROM SNMPv2-TC
MODULE-COMPLIANCE, OBJECT-GROUP,
NOTIFICATION-GROUP FROM SNMPv2-CONF
InterfaceIndexOrZero,
Sivaramu, et al. Expires October 31, 2005 [Page 4]
Internet-Draft PIM MIB April 2005
InterfaceIndex FROM IF-MIB
InetAddressType,
InetAddressPrefixLength,
InetAddress, InetVersion FROM INET-ADDRESS-MIB;
pimStdMIB MODULE-IDENTITY
LAST-UPDATED "200504290000Z" -- April 29, 2005
ORGANIZATION "IETF PIM Working Group"
CONTACT-INFO
"Email: pim@ietf.org"
DESCRIPTION
"The MIB module for management of PIM routers.
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 }
pim OBJECT IDENTIFIER ::= { pimMIBObjects 1 }
--
-- The PIM Interface Table
--
pimInterfaceTable OBJECT-TYPE
SYNTAX SEQUENCE OF PimInterfaceEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The (conceptual) table listing the router's PIM interfaces.
PIM is enabled on all interfaces listed in this table."
::= { pim 1 }
pimInterfaceEntry OBJECT-TYPE
SYNTAX PimInterfaceEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry (conceptual row) in the pimInterfaceTable."
INDEX { pimInterfaceIfIndex,
pimInterfaceIPVersion }
Sivaramu, et al. Expires October 31, 2005 [Page 5]
Internet-Draft PIM MIB April 2005
::= { pimInterfaceTable 1 }
PimInterfaceEntry ::= SEQUENCE {
pimInterfaceIfIndex InterfaceIndex,
pimInterfaceIPVersion InetVersion,
pimInterfaceAddressType InetAddressType,
pimInterfaceAddress InetAddress,
pimInterfaceNetMaskLength InetAddressPrefixLength,
pimInterfaceDR InetAddress,
pimInterfaceHelloInterval Unsigned32,
pimInterfaceTrigHelloInterval Unsigned32,
pimInterfaceJoinPruneInterval Unsigned32,
pimInterfaceDFElectionRobustness Unsigned32,
pimInterfaceHelloHoldtime Unsigned32,
pimInterfaceJoinPruneHoldtime Unsigned32,
pimInterfaceUseLanPruneDelay TruthValue,
pimInterfacePropagationDelay Unsigned32,
pimInterfaceOverrideInterval Unsigned32,
pimInterfaceUseGenerationID TruthValue,
pimInterfaceGenerationIDValue Unsigned32,
pimInterfaceUseDRPriority TruthValue,
pimInterfaceDRPriority Unsigned32,
pimInterfaceLanDelayEnabled TruthValue,
pimInterfaceEffectPropagDelay Unsigned32,
pimInterfaceEffectOverrideIvl Unsigned32,
pimInterfaceSuppressionEnabled TruthValue,
pimInterfaceBidirCapable TruthValue,
pimInterfaceDRPriorityEnabled TruthValue,
pimInterfaceBSRBorder TruthValue,
pimInterfaceStatus RowStatus
}
pimInterfaceIfIndex OBJECT-TYPE
SYNTAX InterfaceIndex
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The ifIndex value of this PIM interface."
::= { pimInterfaceEntry 1 }
pimInterfaceIPVersion OBJECT-TYPE
SYNTAX InetVersion
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"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
Sivaramu, et al. Expires October 31, 2005 [Page 6]
Internet-Draft PIM MIB April 2005
separate."
::= { pimInterfaceEntry 2 }
pimInterfaceAddressType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The address type of this PIM interface."
::= { pimInterfaceEntry 3 }
pimInterfaceAddress OBJECT-TYPE
SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The primary IP address of this router on this PIM
interface. The InetAddressType is given by the
pimInterfaceAddressType object."
::= { pimInterfaceEntry 4 }
pimInterfaceNetMaskLength OBJECT-TYPE
SYNTAX InetAddressPrefixLength
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"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 }
pimInterfaceDR OBJECT-TYPE
SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The primary IP address of the Designated Router on this PIM
interface. The InetAddressType is given by the
pimInterfaceAddressType object."
::= { pimInterfaceEntry 6 }
pimInterfaceHelloInterval OBJECT-TYPE
SYNTAX Unsigned32 (0..18000)
UNITS "seconds"
MAX-ACCESS read-create
STATUS current
DESCRIPTION
Sivaramu, et al. Expires October 31, 2005 [Page 7]
Internet-Draft PIM MIB April 2005
"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 [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."
DEFVAL { 30 }
::= { pimInterfaceEntry 7 }
pimInterfaceTrigHelloInterval OBJECT-TYPE
SYNTAX Unsigned32 (0..60)
UNITS "seconds"
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"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 [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 }
pimInterfaceJoinPruneInterval OBJECT-TYPE
SYNTAX Unsigned32 (0..18000)
UNITS "seconds"
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"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 [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 }
pimInterfaceDFElectionRobustness OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The minimum number of PIM DF-Election messages that must be
lost in order for DF election on this interface to fail."
Sivaramu, et al. Expires October 31, 2005 [Page 8]
Internet-Draft PIM MIB April 2005
DEFVAL { 3 }
::= { pimInterfaceEntry 10 }
pimInterfaceHelloHoldtime OBJECT-TYPE
SYNTAX Unsigned32 (0..65535)
UNITS "seconds"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"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 0."
DEFVAL { 105 }
::= { pimInterfaceEntry 11 }
pimInterfaceJoinPruneHoldtime OBJECT-TYPE
SYNTAX Unsigned32 (0..65535)
UNITS "seconds"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"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 }
pimInterfaceUseLanPruneDelay OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Whether or not this router includes the LAN Prune Delay
option in the PIM Hello messages it sends on this
interface."
DEFVAL { true }
::= { pimInterfaceEntry 13 }
pimInterfacePropagationDelay OBJECT-TYPE
SYNTAX Unsigned32 (0..32767)
UNITS "milliseconds"
MAX-ACCESS read-create
Sivaramu, et al. Expires October 31, 2005 [Page 9]
Internet-Draft PIM MIB April 2005
STATUS current
DESCRIPTION
"The value this router inserts into the Propagation_Delay
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 }
pimInterfaceOverrideInterval OBJECT-TYPE
SYNTAX Unsigned32 (0..65535)
UNITS "milliseconds"
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"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. This object is only
used if pimInterfaceUseLanPruneDelay is set to TRUE."
DEFVAL { 2500 }
::= { pimInterfaceEntry 15 }
pimInterfaceUseGenerationID OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Whether or not this router includes the Generation ID
option in the PIM Hello messages it sends on this
interface."
DEFVAL { true }
::= { pimInterfaceEntry 16 }
pimInterfaceGenerationIDValue OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of the Generation ID this router inserted in the
last PIM Hello message it sent on this interface. This
object is 0 if pimInterfaceUseGenerationID is set to FALSE."
::= { pimInterfaceEntry 17 }
pimInterfaceUseDRPriority OBJECT-TYPE
SYNTAX TruthValue
Sivaramu, et al. Expires October 31, 2005 [Page 10]
Internet-Draft PIM MIB April 2005
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Whether or not this router includes the DR Priority option
in the PIM Hello messages it sends on this interface."
DEFVAL { true }
::= { pimInterfaceEntry 18 }
pimInterfaceDRPriority OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The Designated Router Priority value inserted into the DR
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 }
pimInterfaceLanDelayEnabled OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Evaluates to TRUE if all routers on this interface are
using the LAN Prune Delay option."
::= { pimInterfaceEntry 20 }
pimInterfaceEffectPropagDelay OBJECT-TYPE
SYNTAX Unsigned32 (0..32767)
UNITS "milliseconds"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The Effective Propagation Delay on this interface. This
object is always 500 if pimInterfaceLanDelayEnabled is
FALSE."
::= { pimInterfaceEntry 21 }
pimInterfaceEffectOverrideIvl OBJECT-TYPE
SYNTAX Unsigned32 (0..65535)
UNITS "milliseconds"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The Effective Override Interval on this interface. This
Sivaramu, et al. Expires October 31, 2005 [Page 11]
Internet-Draft PIM MIB April 2005
object is always 2500 if pimInterfaceLanDelayEnabled is
FALSE."
::= { 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
Sivaramu, et al. Expires October 31, 2005 [Page 12]
Internet-Draft PIM MIB April 2005
on the interface; destroying the entry disables PIM on the
interface."
::= { pimInterfaceEntry 27 }
--
-- The PIM Neighbor Table
--
pimNeighborTable OBJECT-TYPE
SYNTAX SEQUENCE OF PimNeighborEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The (conceptual) table listing the router's PIM neighbors."
::= { pim 2 }
pimNeighborEntry OBJECT-TYPE
SYNTAX PimNeighborEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry (conceptual row) in the pimNeighborTable."
INDEX { pimNeighborIfIndex,
pimNeighborAddressType,
pimNeighborAddress }
::= { pimNeighborTable 1 }
PimNeighborEntry ::= SEQUENCE {
pimNeighborIfIndex InterfaceIndex,
pimNeighborAddressType InetAddressType,
pimNeighborAddress InetAddress,
pimNeighborUpTime TimeTicks,
pimNeighborExpiryTime TimeTicks,
pimNeighborLanPruneDelayPresent TruthValue,
pimNeighborPropagationDelay Unsigned32,
pimNeighborOverrideInterval Unsigned32,
pimNeighborTBit TruthValue,
pimNeighborGenerationIDPresent TruthValue,
pimNeighborGenerationIDValue Unsigned32,
pimNeighborBidirCapable TruthValue,
pimNeighborDRPriorityPresent TruthValue,
pimNeighborDRPriority Unsigned32
}
pimNeighborIfIndex OBJECT-TYPE
SYNTAX InterfaceIndex
MAX-ACCESS not-accessible
STATUS current
Sivaramu, et al. Expires October 31, 2005 [Page 13]
Internet-Draft PIM MIB April 2005
DESCRIPTION
"The value of ifIndex for the interface used to reach this
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 }
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
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The time since this PIM neighbor (last) became a neighbor
of the local router."
::= { pimNeighborEntry 4 }
pimNeighborExpiryTime OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The minimum time remaining before this PIM neighbor will
be aged out. The value zero indicates that this PIM
neighbor will never be aged out."
::= { pimNeighborEntry 5 }
pimNeighborLanPruneDelayPresent OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Evaluates to TRUE if this neighbor is using the LAN Prune
Sivaramu, et al. Expires October 31, 2005 [Page 14]
Internet-Draft PIM MIB April 2005
Delay option."
::= { pimNeighborEntry 6 }
pimNeighborPropagationDelay OBJECT-TYPE
SYNTAX Unsigned32 (0..32767)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of the Propagation_Delay field of the LAN Prune
Delay option received from this neighbor. This object is
always 0 if pimNeighborLanPruneDelayPresent is FALSE."
::= { pimNeighborEntry 7 }
pimNeighborOverrideInterval OBJECT-TYPE
SYNTAX Unsigned32 (0..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of the Override_Interval field of the LAN Prune
Delay option received from this neighbor. This object is
always 0 if pimNeighborLanPruneDelayPresent is FALSE."
::= { pimNeighborEntry 8 }
pimNeighborTBit OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"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 }
pimNeighborGenerationIDPresent OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Evaluates to TRUE if this neighbor is using the Generation
ID option."
::= { pimNeighborEntry 10 }
pimNeighborGenerationIDValue OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-only
STATUS current
Sivaramu, et al. Expires October 31, 2005 [Page 15]
Internet-Draft PIM MIB April 2005
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
--
pimNbrSecAddressTable OBJECT-TYPE
SYNTAX SEQUENCE OF PimNbrSecAddressEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The (conceptual) table listing the secondary addresses
advertised by each PIM neighbor (on a subset of the rows of
the pimNeighborTable defined above)."
::= { pim 3 }
Sivaramu, et al. Expires October 31, 2005 [Page 16]
Internet-Draft PIM MIB April 2005
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))
Sivaramu, et al. Expires October 31, 2005 [Page 17]
Internet-Draft PIM MIB April 2005
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 }
pimMRouteEntry OBJECT-TYPE
SYNTAX PimMRouteEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry (conceptual row) in the pimMRouteTable."
INDEX { pimMRouteAddressType,
pimMRouteGroup,
pimMRouteSource,
pimMRouteSourcePrefixLength }
::= { pimMRouteTable 1 }
PimMRouteEntry ::= SEQUENCE {
pimMRouteAddressType InetAddressType,
pimMRouteGroup InetAddress,
pimMRouteSource InetAddress,
pimMRouteSourcePrefixLength InetAddressPrefixLength,
pimMRouteUpTime TimeTicks,
pimMRouteExpiryTime TimeTicks,
pimMRouteType INTEGER,
pimMRouteRPAddress InetAddress,
pimMRouteRPFIfIndex InterfaceIndexOrZero,
pimMRouteRPFNeighbor InetAddress,
pimMRouteUpstreamAssertTimer TimeTicks,
pimMRouteAssertRPTBit TruthValue,
pimMRouteAssertMetricPref Unsigned32,
pimMRouteAssertMetric Unsigned32,
Sivaramu, et al. Expires October 31, 2005 [Page 18]
Internet-Draft PIM MIB April 2005
pimMRouteFlags BITS
}
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
Sivaramu, et al. Expires October 31, 2005 [Page 19]
Internet-Draft PIM MIB April 2005
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The time since this multicast routing entry was created by
the local router."
::= { pimMRouteEntry 5 }
pimMRouteExpiryTime OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The minimum time remaining before this entry will be aged
out. The value zero indicates that this entry will never be
aged out."
::= { pimMRouteEntry 6 }
pimMRouteType OBJECT-TYPE
SYNTAX INTEGER {
ssm (1),
asm (2),
bidir (3)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates whether this entry represents an SSM
(Source Specific Multicast, used with PIM-SM), ASM
(Any Source Multicast, used with PIM-SM) or a BIDIR-PIM
route."
::= { pimMRouteEntry 7 }
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
Sivaramu, et al. Expires October 31, 2005 [Page 20]
Internet-Draft PIM MIB April 2005
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
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of the RPT bit advertised by the Assert Winner on
the upstream interface, or FALSE if no such assert is in
effect."
::= { pimMRouteEntry 12 }
pimMRouteAssertMetricPref OBJECT-TYPE
SYNTAX Unsigned32 (0..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The metric preference advertised by the Assert Winner on
Sivaramu, et al. Expires October 31, 2005 [Page 21]
Internet-Draft PIM MIB April 2005
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 {
rpt(0),
spt(1)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object describes PIM-specific flags related to a
multicast routing entry. See the PIM-SM specification
[I-D.ietf-pim-sm-v2-new] for the meaning of the RPT and SPT
bits."
::= { pimMRouteEntry 15 }
--
-- The PIM Next Hop Table
--
pimMRouteNextHopTable OBJECT-TYPE
SYNTAX SEQUENCE OF PimMRouteNextHopEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The (conceptual) table containing information on outgoing
interfaces for routing IP multicast datagrams, on which PIM
Join/Prunes have been received."
::= { pim 5 }
pimMRouteNextHopEntry OBJECT-TYPE
SYNTAX PimMRouteNextHopEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry (conceptual row) in the pimMRouteNextHopTable."
INDEX { pimMRouteNextHopAddressType,
Sivaramu, et al. Expires October 31, 2005 [Page 22]
Internet-Draft PIM MIB April 2005
pimMRouteNextHopGroup,
pimMRouteNextHopSource,
pimMRouteNextHopSourcePrefixLength,
pimMRouteNextHopIfIndex }
::= { pimMRouteNextHopTable 1 }
PimMRouteNextHopEntry ::= SEQUENCE {
pimMRouteNextHopAddressType InetAddressType,
pimMRouteNextHopGroup InetAddress,
pimMRouteNextHopSource InetAddress,
pimMRouteNextHopSourcePrefixLength InetAddressPrefixLength,
pimMRouteNextHopIfIndex InterfaceIndex,
pimMRouteNextHopUpTime TimeTicks,
pimMRouteNextHopForwarding TruthValue,
pimMRouteNextHopJoinPruneTimer TimeTicks,
pimMRouteNextHopAssertWinner InetAddress,
pimMRouteNextHopAssertTimer TimeTicks,
pimMRouteNextHopAssertRPTBit TruthValue,
pimMRouteNextHopAssertMetricPref Unsigned32,
pimMRouteNextHopAssertMetric Unsigned32
}
pimMRouteNextHopAddressType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS not-accessible
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
Sivaramu, et al. Expires October 31, 2005 [Page 23]
Internet-Draft PIM MIB April 2005
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
STATUS current
DESCRIPTION
"The time since this entry was created by the local router."
::= { pimMRouteNextHopEntry 6 }
pimMRouteNextHopForwarding OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Evaluates to TRUE if the outgoing interface represented by
this entry is currently being used to forward IP datagrams."
::= { pimMRouteNextHopEntry 7 }
pimMRouteNextHopJoinPruneTimer OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
Sivaramu, et al. Expires October 31, 2005 [Page 24]
Internet-Draft PIM MIB April 2005
"The time remaining before the local router ceases
forwarding on this interface."
::= { pimMRouteNextHopEntry 8 }
pimMRouteNextHopAssertWinner OBJECT-TYPE
SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"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 }
pimMRouteNextHopAssertTimer OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"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 }
pimMRouteNextHopAssertRPTBit OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of the RPT bit advertised by the Assert Winner,
or FALSE if no assert is in effect."
::= { pimMRouteNextHopEntry 11 }
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 }
pimMRouteNextHopAssertMetric OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The metric advertised by the Assert Winner, or zero if no
Sivaramu, et al. Expires October 31, 2005 [Page 25]
Internet-Draft PIM MIB April 2005
assert is in effect."
::= { pimMRouteNextHopEntry 13 }
--
-- The PIM Bidir DF-Election Table
--
pimBidirDFElectionTable OBJECT-TYPE
SYNTAX SEQUENCE OF PimBidirDFElectionEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The (conceptual) table listing the per-RP Designated
Forwarder (DF) Election state for each interface for all the
RPs in BIDIR mode."
::= { pim 6 }
pimBidirDFElectionEntry OBJECT-TYPE
SYNTAX PimBidirDFElectionEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry (conceptual row) in the pimBidirDFElectionTable."
INDEX { pimBidirDFElectionAddressType,
pimBidirDFElectionRPAddress,
pimBidirDFElectionIfIndex }
::= { pimBidirDFElectionTable 1 }
PimBidirDFElectionEntry ::= SEQUENCE {
pimBidirDFElectionAddressType InetAddressType,
pimBidirDFElectionRPAddress InetAddress,
pimBidirDFElectionIfIndex InterfaceIndex,
pimBidirDFElectionWinnerAddress InetAddress,
pimBidirDFElectionWinnerUpTime TimeTicks,
pimBidirDFElectionWinnerMetricPref Unsigned32,
pimBidirDFElectionWinnerMetric Unsigned32,
pimBidirDFElectionState INTEGER,
pimBidirDFElectionStateTimer TimeTicks
}
pimBidirDFElectionAddressType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The address type of the RP for which the DF state is being
maintained."
::= { pimBidirDFElectionEntry 1 }
Sivaramu, et al. Expires October 31, 2005 [Page 26]
Internet-Draft PIM MIB April 2005
pimBidirDFElectionRPAddress OBJECT-TYPE
SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The IP address of the RP for which the DF state is being
maintained. The InetAddressType is given by the
pimBidirDFElectionAddressType object."
::= { pimBidirDFElectionEntry 2 }
pimBidirDFElectionIfIndex OBJECT-TYPE
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
STATUS current
DESCRIPTION
"The primary IP address of the winner of the DF Election
process. The InetAddressType is given by the
pimBidirDFElectionAddressType object. A value of zero
indicates there is currently no DF."
::= { pimBidirDFElectionEntry 4 }
pimBidirDFElectionWinnerUpTime OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The time since the current winner (last) became elected as
the DF for this RP."
::= { pimBidirDFElectionEntry 5 }
pimBidirDFElectionWinnerMetricPref OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The metric preference advertised by the DF Winner, or zero
if there is currently no DF."
::= { pimBidirDFElectionEntry 6 }
Sivaramu, et al. Expires October 31, 2005 [Page 27]
Internet-Draft PIM MIB April 2005
pimBidirDFElectionWinnerMetric OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The metric advertised by the DF Winner, or zero if there is
currently no DF."
::= { 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
--
pimRPSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF PimRPSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The (conceptual) table listing PIM information for
available Rendezvous Points (RPs) for IP multicast groups."
::= { pim 7 }
pimRPSetEntry OBJECT-TYPE
Sivaramu, et al. Expires October 31, 2005 [Page 28]
Internet-Draft PIM MIB April 2005
SYNTAX PimRPSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry (conceptual row) in the pimRPSetTable."
INDEX { pimRPSetComponent,
pimRPSetAddressType,
pimRPSetGroupAddress,
pimRPSetGroupPrefixLength,
pimRPSetRPType,
pimRPSetRPAddress }
::= { pimRPSetTable 1 }
PimRPSetEntry ::= SEQUENCE {
pimRPSetComponent Unsigned32,
pimRPSetAddressType InetAddressType,
pimRPSetGroupAddress InetAddress,
pimRPSetGroupPrefixLength InetAddressPrefixLength,
pimRPSetRPType INTEGER,
pimRPSetRPAddress InetAddress,
pimRPSetBidirGroup TruthValue,
pimRPSetPriority Unsigned32,
pimRPSetHoldtime Unsigned32,
pimRPSetExpiryTime TimeTicks,
pimRPSetRPActive TruthValue
}
pimRPSetComponent OBJECT-TYPE
SYNTAX Unsigned32 (1..255)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A number uniquely identifying the component. Each protocol
instance connected to a separate domain should have a
different index value."
::= { pimRPSetEntry 1 }
pimRPSetAddressType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The address type of the IP multicast group."
::= { pimRPSetEntry 2 }
pimRPSetGroupAddress OBJECT-TYPE
SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS not-accessible
Sivaramu, et al. Expires October 31, 2005 [Page 29]
Internet-Draft PIM MIB April 2005
STATUS current
DESCRIPTION
"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 }
pimRPSetGroupPrefixLength OBJECT-TYPE
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."
Sivaramu, et al. Expires October 31, 2005 [Page 30]
Internet-Draft PIM MIB April 2005
::= { 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"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The holdtime of this RP entry. This object is 0 if
pimRPSetRPType is not 'bsr'."
::= { pimRPSetEntry 9 }
pimRPSetExpiryTime OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The minimum time remaining before the RP denoted by this
entry will be declared down. The value zero indicates that
the RP will never be declared down."
::= { pimRPSetEntry 10 }
pimRPSetRPActive OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
Sivaramu, et al. Expires October 31, 2005 [Page 31]
Internet-Draft PIM MIB April 2005
"Evaluates to TRUE if the RP in this entry is the currently
active RP for the group range."
::= { pimRPSetEntry 11 }
--
-- The PIM Candidate-RP Table
--
pimCandidateRPTable OBJECT-TYPE
SYNTAX SEQUENCE OF PimCandidateRPEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The (conceptual) table listing the IP multicast groups for
which the local router is to advertise itself as a
Candidate-RP."
::= { pim 8 }
pimCandidateRPEntry OBJECT-TYPE
SYNTAX PimCandidateRPEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry (conceptual row) in the pimCandidateRPTable."
INDEX { pimCandidateRPAddressType,
pimCandidateRPAddress,
pimCandidateRPGroupAddress,
pimCandidateRPGroupPrefixLength }
::= { pimCandidateRPTable 1 }
PimCandidateRPEntry ::= SEQUENCE {
pimCandidateRPAddressType InetAddressType,
pimCandidateRPAddress InetAddress,
pimCandidateRPGroupAddress InetAddress,
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
Sivaramu, et al. Expires October 31, 2005 [Page 32]
Internet-Draft PIM MIB April 2005
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
SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The IP multicast group address which, when combined with
the corresponding value of pimCandidateRPGroupPrefixLength,
identifies a group prefix for which the local router will
advertise itself as a Candidate-RP. The InetAddressType is
given by the pimCandidateRPAddressType object."
::= { pimCandidateRPEntry 3 }
pimCandidateRPGroupPrefixLength OBJECT-TYPE
SYNTAX InetAddressPrefixLength
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The multicast group address mask which, when combined with
the corresponding value of pimCandidateRPGroupMask,
identifies a group prefix for which the local router will
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 }
pimCandidateRPBidir OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"If this object is set to TRUE, this group range is
advertised to this RP as a BIDIR-PIM group range. If it is
set to FALSE, it is advertised as a PIM-SM group range."
::= { pimCandidateRPEntry 5 }
pimCandidateRPStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
Sivaramu, et al. Expires October 31, 2005 [Page 33]
Internet-Draft PIM MIB April 2005
DESCRIPTION
"The status of this row, by which new entries may be
created, or old entries deleted from this table."
::= { pimCandidateRPEntry 6 }
--
-- The PIM Scope Zone Table
--
pimScopeZoneTable OBJECT-TYPE
SYNTAX SEQUENCE OF PimScopeZoneEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The (conceptual) table containing objects specific to a
scoped region within a PIM-SM domain. One row exists for
each scoped zone in each domain to which the router is
connected. A PIM-SM scoped zone is defined as an area
within a PIM-SM domain over which PIM Bootstrap messages for
the group range belonging to the scope are forwarded."
::= { pim 9 }
pimScopeZoneEntry OBJECT-TYPE
SYNTAX PimScopeZoneEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry (conceptual row) in the pimScopeZoneTable."
INDEX { pimScopeZoneId }
::= { pimScopeZoneTable 1 }
PimScopeZoneEntry ::= SEQUENCE {
pimScopeZoneId Unsigned32,
pimScopeZoneCandidateBSR TruthValue,
pimScopeZoneCandidateBSRPriority Unsigned32,
pimScopeZoneBSRAddressType InetAddressType,
pimScopeZoneBSRAddress InetAddress,
pimScopeZoneBSRExpiryTime TimeTicks,
pimScopeZoneStatus RowStatus
}
pimScopeZoneId OBJECT-TYPE
SYNTAX Unsigned32 (1..255)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A number uniquely identifying an admin scoped zone within a
domain."
Sivaramu, et al. Expires October 31, 2005 [Page 34]
Internet-Draft PIM MIB April 2005
::= { pimScopeZoneEntry 1 }
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
STATUS current
DESCRIPTION
"The type of address of the bootstrap router (BSR) for the
local PIM scoped zone."
::= { pimScopeZoneEntry 4 }
pimScopeZoneBSRAddress OBJECT-TYPE
SYNTAX InetAddress (SIZE (4|16|20))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The address of the bootstrap router (BSR) for the local PIM
scoped zone. The InetAddressType is given by the
pimScopeZoneBSRAddressType object."
::= { pimScopeZoneEntry 5 }
pimScopeZoneBSRExpiryTime OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The minimum time remaining before the bootstrap router in
Sivaramu, et al. Expires October 31, 2005 [Page 35]
Internet-Draft PIM MIB April 2005
the local scoped zone will be declared down. For candidate
BSRs, this is the time until the component sends a PIM
Bootstrap message. For other routers, this is the time
until it may accept a PIM Bootstrap message from a lower
candidate BSR."
::= { pimScopeZoneEntry 6 }
pimScopeZoneStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this entry. Creating the entry creates
another protocol instance; destroying the entry disables a
protocol instance."
::= { pimScopeZoneEntry 7 }
--
-- PIM Traps
--
pimNeighborLoss NOTIFICATION-TYPE
OBJECTS { pimNeighborUpTime }
STATUS current
DESCRIPTION
"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 the same IP version and
a lower IP address than itself."
::= { pimTraps 1 }
--
-- Conformance Information
--
pimMIBConformance OBJECT IDENTIFIER ::= { pimStdMIB 2 }
pimMIBCompliances OBJECT IDENTIFIER ::= { pimMIBConformance 1 }
pimMIBGroups OBJECT IDENTIFIER ::= { pimMIBConformance 2 }
--
-- Compliance Statements
--
pimMIBCompliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The compliance statement for PIM routers which implement
Sivaramu, et al. Expires October 31, 2005 [Page 36]
Internet-Draft PIM MIB April 2005
the PIM MIB."
MODULE -- this module
MANDATORY-GROUPS { pimNotificationGroup,
pimObjectGroup }
::= { pimMIBCompliances 1 }
--
-- Units of Conformance
--
pimNotificationGroup NOTIFICATION-GROUP
NOTIFICATIONS { pimNeighborLoss }
STATUS current
DESCRIPTION
"A collection of notifications for signaling important PIM
events."
::= { pimMIBGroups 1 }
pimObjectGroup OBJECT-GROUP
OBJECTS { pimInterfaceAddressType,
pimInterfaceAddress,
pimInterfaceNetMaskLength,
pimInterfaceDR,
pimInterfaceHelloInterval,
pimInterfaceTrigHelloInterval,
pimInterfaceJoinPruneInterval,
pimInterfaceDFElectionRobustness,
pimInterfaceHelloHoldtime,
pimInterfaceJoinPruneHoldtime,
pimInterfaceUseLanPruneDelay,
pimInterfacePropagationDelay,
pimInterfaceOverrideInterval,
pimInterfaceUseGenerationID,
pimInterfaceGenerationIDValue,
pimInterfaceUseDRPriority,
pimInterfaceDRPriority,
pimInterfaceLanDelayEnabled,
pimInterfaceEffectPropagDelay,
pimInterfaceEffectOverrideIvl,
pimInterfaceSuppressionEnabled,
pimInterfaceBidirCapable,
pimInterfaceDRPriorityEnabled,
pimInterfaceBSRBorder,
pimInterfaceStatus,
pimNeighborUpTime,
pimNeighborExpiryTime,
pimNeighborLanPruneDelayPresent,
pimNeighborPropagationDelay,
Sivaramu, et al. Expires October 31, 2005 [Page 37]
Internet-Draft PIM MIB April 2005
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
DESCRIPTION
Sivaramu, et al. Expires October 31, 2005 [Page 38]
Internet-Draft PIM MIB April 2005
"A collection of objects for managing PIM routers."
::= { pimMIBGroups 2 }
END
5. Security Considerations
There are a number of management objects defined in this MIB module
with a MAX-ACCESS clause of read-write and/or read-create. Such
objects may be considered sensitive or vulnerable in some network
environments. The support for SET operations in a non-secure
environment without proper protection can have a negative effect on
network operations. These are the tables and objects and their
sensitivity/vulnerability:
TODO.
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:
TODO.
SNMP versions prior to SNMPv3 did not include adequate security.
Even if the network itself is secure (for example by using IPSec),
even then, there is no control as to who on the secure network is
allowed to access and GET/SET (read/change/create/delete) the objects
in this MIB module.
It is RECOMMENDED that implementers consider the security features as
provided by the SNMPv3 framework (see [RFC3410], section 8),
including full support for the SNMPv3 cryptographic mechanisms (for
authentication and privacy).
Further, deployment of SNMP versions prior to SNMPv3 is NOT
RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to
enable cryptographic security. It is then a customer/operator
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.
Sivaramu, et al. Expires October 31, 2005 [Page 39]
Internet-Draft PIM MIB April 2005
6. IANA Considerations
PIM-STD-MIB should be rooted under the mib-2 subtree. IANA is
requested to assign { mib-2 XXX } to the PIM-STD-MIB module specified
in this document.
7. Acknowledgements
This MIB module is based on the original work in RFC 2934 [RFC2934]
by K. McCloghrie, D. Farinacci, D. Thaler and W. Fenner and has been
updated based on feedback from the IETF's Protocol Independent
Multicast (PIM) Working Group.
Jonathan Nicholas was the editor of early versions of this document.
8. References
8.1 Normative References
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[RFC2434] Narten, T. and H. Alvestrand, "Guidelines for Writing an
IANA Considerations Section in RFCs", BCP 26, RFC 2434,
October 1998.
[RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J.
Schoenwaelder, Ed., "Structure of Management Information
Version 2 (SMIv2)", STD 58, RFC 2578, April 1999.
[RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J.
Schoenwaelder, Ed., "Textual Conventions for SMIv2",
STD 58, RFC 2579, April 1999.
[RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder,
"Conformance Statements for SMIv2", STD 58, RFC 2580,
April 1999.
[RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group
MIB", RFC 2863, June 2000.
[RFC4001] Daniele, M., Haberman, B., Routhier, S., and J.
Schoenwaelder, "Textual Conventions for Internet Network
Addresses", RFC 4001, February 2005.
[I-D.ietf-pim-sm-v2-new]
Fenner, B., Handley, M., Holbrook, H., and I. Kouvelas,
"Protocol Independent Multicast - Sparse Mode PIM-SM):
Sivaramu, et al. Expires October 31, 2005 [Page 40]
Internet-Draft PIM MIB April 2005
Protocol Specification (Revised)",
draft-ietf-pim-sm-v2-new-11 (work in progress),
October 2004.
[I-D.ietf-pim-bidir]
Handley, M., Kouvelas, I., Speakman, T., and L. Vicisano,
"Bi-directional Protocol Independent Multicast (BIDIR-
PIM)", draft-ietf-pim-bidir-07 (work in progress),
March 2005.
[I-D.ietf-pim-sm-bsr]
Bhaskar, N., "Bootstrap Router (BSR) Mechanism for PIM",
draft-ietf-pim-sm-bsr-05 (work in progress),
February 2005.
[RFC3956] Savola, P. and B. Haberman, "Embedding the Rendezvous
Point (RP) Address in an IPv6 Multicast Address",
RFC 3956, November 2004.
8.2 Informative References
[RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart,
"Introduction and Applicability Statements for Internet-
Standard Management Framework", RFC 3410, December 2002.
[RFC2932] McCloghrie, K., Farinacci, D., and D. Thaler, "IPv4
Multicast Routing MIB", RFC 2932, October 2000.
[RFC2934] McCloghrie, K., Farinacci, D., Thaler, D., and B. Fenner,
"Protocol Independent Multicast MIB for IPv4", RFC 2934,
October 2000.
Authors' Addresses
Raghava Sivaramu
Cisco Systems
425 E. Tasman Drive
San Jose CA 95134
USA
Email: raghava@cisco.com
Sivaramu, et al. Expires October 31, 2005 [Page 41]
Internet-Draft PIM MIB April 2005
James Lingard
Data Connection Ltd
100 Church Street
Enfield EN2 6BQ
United Kingdom
Email: james.lingard@dataconnection.com
Bharat Joshi
Infosys Technologies Ltd
Electronic City
Bangalore 560 100
India
Email: bharat_joshi@infosys.com
Sivaramu, et al. Expires October 31, 2005 [Page 42]
Internet-Draft PIM MIB April 2005
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.
Sivaramu, et al. Expires October 31, 2005 [Page 43]
| PAFTECH AB 2003-2026 | 2026-04-21 19:54:48 |