-- extracted from draft-ietf-pim-bsr-mib-00.txt -- at Wed Aug 30 06:06:54 2006 PIM-BSR-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, mib-2, Unsigned32, TimeTicks FROM SNMPv2-SMI RowStatus, TruthValue FROM SNMPv2-TC MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP FROM SNMPv2-CONF InetAddressType, InetAddressPrefixLength, InetAddress, InetZoneIndex FROM INET-ADDRESS-MIB; pimBsrMIB MODULE-IDENTITY LAST-UPDATED "200606160000Z" -- 16 June 2006 ORGANIZATION "IETF PIM Working Group" CONTACT-INFO "Email: pim@ietf.org" DESCRIPTION "The MIB module for management of the Bootstrap Router (BSR) mechanism for PIM routers. Copyright (C) The Internet Society (2006). 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 "200608230000Z" -- 23 August 2006 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 -- -- Top-level structure -- pimBsrMIBObjects OBJECT IDENTIFIER ::= { pimBsrMIB 1 } pimBsrTraps OBJECT IDENTIFIER ::= { pimBsrMIBObjects 0 } pimBsr OBJECT IDENTIFIER ::= { pimBsrMIBObjects 1 } -- -- The BSR Candidate-RP Table -- bsrCandidateRPTable OBJECT-TYPE SYNTAX SEQUENCE OF BsrCandidateRPEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The (conceptual) table listing the IP multicast group prefixes for which the local router is to advertise itself as a Candidate-RP." ::= { pimBsr 1 } bsrCandidateRPEntry OBJECT-TYPE SYNTAX BsrCandidateRPEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry (conceptual row) in the bsrCandidateRPTable." INDEX { bsrCandidateRPAddressType, bsrCandidateRPAddress, bsrCandidateRPGroupAddress, bsrCandidateRPGroupPrefixLength } ::= { bsrCandidateRPTable 1 } BsrCandidateRPEntry ::= SEQUENCE { bsrCandidateRPAddressType InetAddressType, bsrCandidateRPAddress InetAddress, bsrCandidateRPGroupAddress InetAddress, bsrCandidateRPGroupPrefixLength InetAddressPrefixLength, bsrCandidateRPBidir TruthValue, bsrCandidateRPAdvTimer TimeTicks, bsrCandidateRPPriority Unsigned32, bsrCandidateRPAdvInterval Unsigned32, bsrCandidateRPHoldtime Unsigned32, bsrCandidateRPStatus RowStatus } bsrCandidateRPAddressType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS current DESCRIPTION "The Inet address type of the Candidate-RP." ::= { bsrCandidateRPEntry 1 } bsrCandidateRPAddress OBJECT-TYPE SYNTAX InetAddress (SIZE (4|8|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 bsrCandidateRPAddressType object." ::= { bsrCandidateRPEntry 2 } bsrCandidateRPGroupAddress OBJECT-TYPE SYNTAX InetAddress (SIZE (4|8|16|20)) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The IP multicast group address which, when combined with the corresponding value of bsrCandidateRPGroupPrefixLength, identifies a group prefix for which the local router will advertise itself as a Candidate-RP. The InetAddressType is given by the bsrCandidateRPAddressType object." ::= { bsrCandidateRPEntry 3 } bsrCandidateRPGroupPrefixLength OBJECT-TYPE SYNTAX InetAddressPrefixLength (4..128) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The multicast group address mask which, when combined with the corresponding value of bsrCandidateRPGroupAddress, identifies a group prefix for which the local router will advertise itself as a Candidate-RP. The InetAddressType is given by the bsrCandidateRPAddressType object." ::= { bsrCandidateRPEntry 4 } bsrCandidateRPBidir OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-create STATUS current DESCRIPTION "If this object is set to TRUE, this group range is advertised with this RP as a BIDIR-PIM group range. If it is set to FALSE, it is advertised as a PIM-SM group range." DEFVAL { false } ::= { bsrCandidateRPEntry 5 } bsrCandidateRPAdvTimer OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "The time remaining before the local router next sends a Candidate-RP-Advertisement to the elected BSR for this zone." ::= { bsrCandidateRPEntry 6 } bsrCandidateRPPriority OBJECT-TYPE SYNTAX Unsigned32 (0..255) MAX-ACCESS read-create STATUS current DESCRIPTION "The priority for this Candidate RP advertised in Candidate-RP-Advertisements." REFERENCE "I-D.ietf-pim-sm-bsr section 3.2" DEFVAL { 192 } ::= { bsrCandidateRPEntry 7 } bsrCandidateRPAdvInterval OBJECT-TYPE SYNTAX Unsigned32 (0..26214) MAX-ACCESS read-create STATUS current DESCRIPTION "A Candidate RP generates Candidate-RP-Advertisements periodically. This object represents the time interval in seconds between two consecutive advertisements." REFERENCE "I-D.ietf-pim-sm-bsr section 3.2 and section 5" DEFVAL { 60 } ::= { bsrCandidateRPEntry 8 } bsrCandidateRPHoldtime OBJECT-TYPE SYNTAX Unsigned32 (0..65535) MAX-ACCESS read-create STATUS current DESCRIPTION "Holdtime for this Candidate RP. The amount of time (in seconds) this Candidate-RP entry is valid." REFERENCE "I-D.ietf-pim-sm-bsr section 4.2" DEFVAL { 150 } ::= { bsrCandidateRPEntry 9 } bsrCandidateRPStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of this row, by which new entries may be created, or old entries deleted from this table." ::= { bsrCandidateRPEntry 10 } -- -- The BSR Elected BSR RP-Set Table -- bsrElectedBSRRPSetTable OBJECT-TYPE SYNTAX SEQUENCE OF BsrElectedBSRRPSetEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The (conceptual) table listing BSR-specific information about PIM group mappings learned via C-RP advertisements or created locally using configurations. This table is maintained only on the Elected BSR. An Elected BSR uses this table to create Bootstrap Messages after applying a local policy to include some or all of the group mappings in this table." ::= { pimBsr 2 } bsrElectedBSRRPSetEntry OBJECT-TYPE SYNTAX BsrElectedBSRRPSetEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry (conceptual row) in the bsrElectedBSRRPSetTable." INDEX { bsrElectedBSRGrpMappingAddrType, bsrElectedBSRGrpMappingGrpAddr, bsrElectedBSRGrpMappingGrpPrefixLen, bsrElectedBSRGrpMappingRPAddr } ::= { bsrElectedBSRRPSetTable 1 } BsrElectedBSRRPSetEntry ::= SEQUENCE { bsrElectedBSRGrpMappingAddrType InetAddressType, bsrElectedBSRGrpMappingGrpAddr InetAddress, bsrElectedBSRGrpMappingGrpPrefixLen InetAddressPrefixLength, bsrElectedBSRGrpMappingRPAddr InetAddress, bsrElectedBSRRPSetPriority Unsigned32, bsrElectedBSRRPSetHoldtime Unsigned32, bsrElectedBSRRPSetExpiryTime TimeTicks, bsrElectedBSRRPSetGrpBidir TruthValue } bsrElectedBSRGrpMappingAddrType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS current DESCRIPTION "The Inet address type of the IP multicast group prefix." ::= { bsrElectedBSRRPSetEntry 2 } bsrElectedBSRGrpMappingGrpAddr OBJECT-TYPE SYNTAX InetAddress (SIZE (4|8|16|20)) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The IP multicast group address which, when combined with bsrElectedBSRGrpMappingGrpPrefixLen, gives the group prefix for this mapping. The InetAddressType is given by the bsrElectedBSRGrpMappingAddrType object. This address object is only significant up to bsrGroupMappingGrpPrefixLength bits. The remainder of the address bits are zero. This is especially important for this field, which is part of the index of this entry. Any non-zero bits would signify an entirely different entry." ::= { bsrElectedBSRRPSetEntry 3 } bsrElectedBSRGrpMappingGrpPrefixLen OBJECT-TYPE SYNTAX InetAddressPrefixLength (4..128) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The multicast group prefix length, which, when combined with bsrElectedBSRGrpMappingGrpAddr, gives the group prefix for this mapping. The InetAddressType is given by the bsrElectedBSRGrpMappingAddrType object. If bsrElectedBSRGrpMappingAddrType is 'ipv4' or 'ipv4z', this object must be in the range 4..32. If bsrElectedBSRGrpMappingAddrType is 'ipv6' or 'ipv6z', this object must be in the range 8..128." ::= { bsrElectedBSRRPSetEntry 4 } bsrElectedBSRGrpMappingRPAddr OBJECT-TYPE SYNTAX InetAddress (SIZE (4|8|16|20)) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The IP address of the RP to be used for groups within this group prefix. The InetAddressType is given by the bsrElectedBSRGrpMappingAddrType object." ::= { bsrElectedBSRRPSetEntry 5 } bsrElectedBSRRPSetPriority OBJECT-TYPE SYNTAX Unsigned32 (0..255) MAX-ACCESS read-only STATUS current DESCRIPTION "The priority for RP". Numerically higher values for this object indicate lower priorities, with the value zero denoting the highest priority." ::= { bsrElectedBSRRPSetEntry 6 } bsrElectedBSRRPSetHoldtime OBJECT-TYPE SYNTAX Unsigned32 (0..65535) UNITS "seconds" MAX-ACCESS read-only STATUS current DESCRIPTION "The holdtime for RP" ::= { bsrElectedBSRRPSetEntry 7 } bsrElectedBSRRPSetExpiryTime 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." ::= { bsrElectedBSRRPSetEntry 8 } bsrElectedBSRRPSetGrpBidir OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS current DESCRIPTION "If this object is TRUE, this group range with this RP is a BIDIR-PIM group range. If it is set to FALSE, it is a PIM-SM group range." ::= { bsrElectedBSRRPSetEntry 9 } -- -- The BSR Candidate-BSR Table -- bsrCandidateBSRTable OBJECT-TYPE SYNTAX SEQUENCE OF BsrCandidateBSREntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The (conceptual) table containing Candidate-BSR configuration for the local router. The table contains one row for each zone for which the local router is to advertise itself as a Candidate-BSR." ::= { pimBsr 3 } bsrCandidateBSREntry OBJECT-TYPE SYNTAX BsrCandidateBSREntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry (conceptual row) in the bsrCandidateBSRTable." INDEX { bsrCandidateBSRZoneIndex } ::= { bsrCandidateBSRTable 1 } BsrCandidateBSREntry ::= SEQUENCE { bsrCandidateBSRZoneIndex InetZoneIndex, bsrCandidateBSRAddressType InetAddressType, bsrCandidateBSRAddress InetAddress, bsrCandidateBSRPriority Unsigned32, bsrCandidateBSRHashMaskLength Unsigned32, bsrCandidateBSRElectedBSR TruthValue, bsrCandidateBSRBootstrapTimer TimeTicks, bsrCandidateBSRStatus RowStatus } bsrCandidateBSRZoneIndex OBJECT-TYPE SYNTAX InetZoneIndex MAX-ACCESS not-accessible STATUS current DESCRIPTION "The zone index uniquely identifies the zone on a device with which this Candidate BSR is attached. There is one entry for each zone in ipMcastZoneTable. Scope-level information for this zone can be extracted from ipMcastZoneTable in IP MCAST MIB" ::= { bsrCandidateBSREntry 1 } bsrCandidateBSRAddressType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS read-create STATUS current DESCRIPTION "The address type of the Candidate-BSR." ::= { bsrCandidateBSREntry 2 } bsrCandidateBSRAddress OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-create STATUS current DESCRIPTION "The (unicast) address which the local router will use to advertise itself as a Candidate-BSR. The InetAddressType is given by the bsrCandidateBSRAddressType object." ::= { bsrCandidateBSREntry 3 } bsrCandidateBSRPriority OBJECT-TYPE SYNTAX Unsigned32 (0..255) MAX-ACCESS read-create STATUS current DESCRIPTION "The priority value for the local router as a Candidate-BSR for this zone. Numerically higher values for this object indicate higher priorities." DEFVAL { 0 } ::= { bsrCandidateBSREntry 4 } bsrCandidateBSRHashMaskLength OBJECT-TYPE SYNTAX Unsigned32 (0..128) MAX-ACCESS read-create STATUS current DESCRIPTION "The hash mask length (used in the RP hash function) that the local router will advertise in its Bootstrap messages for this zone. This object defaults to 30 if bsrCandidateBSRAddressType is 'ipv4' or 'ipv4z' , and defaults to 126 if bsrCandidateBSRAddressType is 'ipv6' or 'ipv6z'." ::= { bsrCandidateBSREntry 5 } bsrCandidateBSRElectedBSR OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS current DESCRIPTION "Whether the local router is the elected BSR for this zone." ::= { bsrCandidateBSREntry 6 } bsrCandidateBSRBootstrapTimer OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "The time remaining before the local router next originates a Bootstrap message for this zone. Value of this object is zero if bsrCandidateBSRElectedBSR is 'FALSE'." ::= { bsrCandidateBSREntry 7 } bsrCandidateBSRStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of this row, by which new entries may be created, or old entries deleted from this table." ::= { bsrCandidateBSREntry 8 } -- -- The BSR Elected-BSR Table -- bsrElectedBSRTable OBJECT-TYPE SYNTAX SEQUENCE OF BsrElectedBSREntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The (conceptual) table containing information about elected BSRs. The table contains one row for each zone for which there is an elected BSR." ::= { pimBsr 4 } bsrElectedBSREntry OBJECT-TYPE SYNTAX BsrElectedBSREntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry (conceptual row) in the bsrElectedBSRTable." INDEX { bsrElectedBSRZoneIndex } ::= { bsrElectedBSRTable 1 } BsrElectedBSREntry ::= SEQUENCE { bsrElectedBSRZoneIndex InetZoneIndex, bsrElectedBSRAddressType InetAddressType, bsrElectedBSRAddress InetAddress, bsrElectedBSRPriority Unsigned32, bsrElectedBSRHashMaskLength Unsigned32, bsrElectedBSRExpiryTime TimeTicks } bsrElectedBSRZoneIndex OBJECT-TYPE SYNTAX InetZoneIndex MAX-ACCESS not-accessible STATUS current DESCRIPTION "The zone index uniquely identifies the zone on a device with which this Elected BSR is attached. There is one entry for each zone in ipMcastZoneTable. Scope-level information for this zone can be extracted from ipMcastZoneTable in IP MCAST MIB" ::= { bsrElectedBSREntry 1 } bsrElectedBSRAddressType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS current DESCRIPTION "The address type of the elected BSR." ::= { bsrElectedBSREntry 2 } bsrElectedBSRAddress OBJECT-TYPE SYNTAX InetAddress (SIZE (4|8|16|20)) MAX-ACCESS read-only STATUS current DESCRIPTION "The (unicast) address of the elected BSR. The InetAddressType is given by the bsrElectedBSRAddressType object." ::= { bsrElectedBSREntry 3 } bsrElectedBSRPriority OBJECT-TYPE SYNTAX Unsigned32 (0..255) MAX-ACCESS read-only STATUS current DESCRIPTION "The priority value for the elected BSR for this address type. Numerically higher values for this object indicate higher priorities." ::= { bsrElectedBSREntry 4 } bsrElectedBSRHashMaskLength OBJECT-TYPE SYNTAX Unsigned32 (0..128) MAX-ACCESS read-only STATUS current DESCRIPTION "The hash mask length (used in the RP hash function) advertised by the elected BSR for this zone." ::= { bsrElectedBSREntry 5 } bsrElectedBSRExpiryTime OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "The minimum time remaining before the elected BSR for this zone will be declared down." ::= { bsrElectedBSREntry 6 } -- -- PIM BSR Traps -- bsrElectedBSRLostElection NOTIFICATION-TYPE OBJECTS { bsrCandidateBSRElectedBSR } STATUS current DESCRIPTION "A bsrElectedBSRLostElection trap should be generated when current E-BSR lost election to a new Candidate BSR. Only an E-BSR should generate this trap. This notification is generated when bsrCandidateBSRElectedBSR becomes FALSE." REFERENCE "I-D.ietf-pim-sm-bsr section 3.1" ::= { pimBsrTraps 1 } bsrCandidateBSRWinElection NOTIFICATION-TYPE OBJECTS { bsrCandidateBSRElectedBSR } STATUS current DESCRIPTION "A bsrCandidateBSRWinElection trap should be generated when a C-BSR wins BSR Election. Only an E-BSR should generate this trap. This notification is generated when bsrCandidateBSRElectedBSR becomes TRUE" REFERENCE "I-D.ietf-pim-sm-bsr section 3.1" ::= { pimBsrTraps 2 } -- -- Conformance Information -- pimBsrMIBConformance OBJECT IDENTIFIER ::= { pimBsrMIB 2 } pimBsrMIBCompliances OBJECT IDENTIFIER ::= { pimBsrMIBConformance 1 } pimBsrMIBGroups OBJECT IDENTIFIER ::= { pimBsrMIBConformance 2 } -- -- Compliance Statements -- pimBsrMIBCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for PIM routers which implement Bootstrap Router (BSR) mechanism." MODULE -- this module MANDATORY-GROUPS { pimBsrObjectGroup } GROUP pimBsrDiagnosticsGroup DESCRIPTION "This group is optional." ::= { pimBsrMIBCompliances 1 } -- -- Units of Conformance -- pimBsrObjectGroup OBJECT-GROUP OBJECTS { bsrCandidateRPBidir, bsrCandidateRPAdvTimer, bsrCandidateRPPriority, bsrCandidateRPAdvInterval, bsrCandidateRPHoldtime, bsrCandidateRPStatus, bsrElectedBSRRPSetPriority, bsrElectedBSRRPSetHoldtime, bsrElectedBSRRPSetExpiryTime, bsrElectedBSRRPSetGrpBidir, bsrCandidateBSRAddress, bsrCandidateBSRPriority, bsrCandidateBSRHashMaskLength, bsrCandidateBSRElectedBSR, bsrCandidateBSRBootstrapTimer, bsrCandidateBSRStatus, bsrElectedBSRAddress, bsrElectedBSRPriority, bsrElectedBSRHashMaskLength, bsrElectedBSRExpiryTime } STATUS current DESCRIPTION "A collection of objects for managing the Bootstrap Router (BSR) mechanism for PIM routers." ::= { pimBsrMIBGroups 1 } pimBsrDiagnosticsGroup NOTIFICATION-GROUP NOTIFICATIONS { bsrElectedBSRLostElection, bsrCandidateBSRWinElection } STATUS current DESCRIPTION "Objects providing additional diagnostics related to Bootstrap Router (BSR) mechanism for PIM routers." ::= { pimBsrMIBGroups 2 } END -- -- Copyright (C) The Internet Society (2006). 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.