PIM WG                                                          B. Joshi
Internet-Draft                                 Infosys Technologies Ltd.
Expires: February 24, 2007                                    R. Bijlani
                                                           Cisco Systems
                                                         August 23, 2006


                        PIM Bootstrap Router MIB
                     draft-ietf-pim-bsr-mib-00.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 February 24, 2007.

Copyright Notice

   Copyright (C) The Internet Society (2006).

Abstract

   This document 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 Bootstrap Router (BSR) mechanism for PIM.






Joshi & Bijlani         Expires February 24, 2007               [Page 1]


Internet-Draft                 PIM BSR MIB                   August 2006


Table of Contents

   1.  Introduction . . . . . . . . . . . . . . . . . . . . . . . . .  3
   2.  The Internet-Standard Management Framework . . . . . . . . . .  3
   3.  Conventions  . . . . . . . . . . . . . . . . . . . . . . . . .  3
   4.  Overview . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
   5.  Definitions  . . . . . . . . . . . . . . . . . . . . . . . . .  4
   6.  Security Considerations  . . . . . . . . . . . . . . . . . . . 17
   7.  IANA Considerations  . . . . . . . . . . . . . . . . . . . . . 19
   8.  Acknowledgments  . . . . . . . . . . . . . . . . . . . . . . . 19
   9.  References . . . . . . . . . . . . . . . . . . . . . . . . . . 19
     9.1.  Normative References . . . . . . . . . . . . . . . . . . . 19
     9.2.  Informative References . . . . . . . . . . . . . . . . . . 20
   Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 21
   Intellectual Property and Copyright Statements . . . . . . . . . . 22




































Joshi & Bijlani         Expires February 24, 2007               [Page 2]


Internet-Draft                 PIM BSR MIB                   August 2006


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
   Bootstrap Router (BSR) mechanism for PIM.  [I-D.ietf-pim-sm-v2-new],
   [I-D.ietf-pim-sm-bsr].

   This document was created by moving some of the PIM BSR specific MIB
   tables from one of the earlier version of PIM MIB draft [I-D.ietf-
   pim-mib-v2].


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.  Conventions

   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].


4.  Overview

   This MIB module contains four tables.  The tables are:

   1.  The BSR Candidate-RP Table, which contains one row for each
       multicast group address prefix for which the local router is to
       advertise itself as a Candidate-RP.

   2.  The BSR Elected BSR RP-Set Table, which contains one row for each
       Group-to-RP mapping that was received in C-RP advertisements.





Joshi & Bijlani         Expires February 24, 2007               [Page 3]


Internet-Draft                 PIM BSR MIB                   August 2006


   3.  The BSR Candidate-BSR Table, which contains one row for each
       Candidate-BSR configuration for the local router.

   4.  The BSR Elected BSR Table, which contains one row for each
       elected BSR.

   This MIB module uses textual conventions defined in the IF-MIB
   [RFC2863], the INET-ADDRESS-MIB [RFC4001] and the IANA-RTPROTO-MIB.


5.  Definitions


   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



Joshi & Bijlani         Expires February 24, 2007               [Page 4]


Internet-Draft                 PIM BSR MIB                   August 2006


   --

   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



Joshi & Bijlani         Expires February 24, 2007               [Page 5]


Internet-Draft                 PIM BSR MIB                   August 2006


       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



Joshi & Bijlani         Expires February 24, 2007               [Page 6]


Internet-Draft                 PIM BSR MIB                   August 2006


               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."




Joshi & Bijlani         Expires February 24, 2007               [Page 7]


Internet-Draft                 PIM BSR MIB                   August 2006


       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 }




Joshi & Bijlani         Expires February 24, 2007               [Page 8]


Internet-Draft                 PIM BSR MIB                   August 2006


   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',



Joshi & Bijlani         Expires February 24, 2007               [Page 9]


Internet-Draft                 PIM BSR MIB                   August 2006


               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



Joshi & Bijlani         Expires February 24, 2007              [Page 10]


Internet-Draft                 PIM BSR MIB                   August 2006


       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.



Joshi & Bijlani         Expires February 24, 2007              [Page 11]


Internet-Draft                 PIM BSR MIB                   August 2006


               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 }




Joshi & Bijlani         Expires February 24, 2007              [Page 12]


Internet-Draft                 PIM BSR MIB                   August 2006


   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



Joshi & Bijlani         Expires February 24, 2007              [Page 13]


Internet-Draft                 PIM BSR MIB                   August 2006


               "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



Joshi & Bijlani         Expires February 24, 2007              [Page 14]


Internet-Draft                 PIM BSR MIB                   August 2006


               "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.



Joshi & Bijlani         Expires February 24, 2007              [Page 15]


Internet-Draft                 PIM BSR MIB                   August 2006


               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,



Joshi & Bijlani         Expires February 24, 2007              [Page 16]


Internet-Draft                 PIM BSR MIB                   August 2006


                 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




6.  Security Considerations

   SNMP versions prior to SNMPv3 did not include adequate security.
   Even if the network itself is secure (for example by using IPSec),
   there is still no control over whom on the secure network is allowed
   to access (read/change/create/delete) the objects in this MIB module.
   The support for SET operations in a non-secure environment without
   proper protection can have a negative effect on network operations.

   In this MIB module, possible effects that can be induced by SET
   operations on writable objects include:

   o  A new Candidate BSR with high priority or modification of priority
      of an existing candidate BSR can takeover the functionality of
      Elected BSR which can prevent and disrupt the services.

   o  A new Candidate RP with lower priority or modification of priority
      of an existing Candidate RP can force other routers to select
      itself for a particular group prefix.  This can prevent and



Joshi & Bijlani         Expires February 24, 2007              [Page 17]


Internet-Draft                 PIM BSR MIB                   August 2006


      disrupt the services provided through this group prefix.

   The following are the read-write and read-create objects defined in
   this MIB module:

   bsrCandidateRPBidir
   bsrCandidateRPPriority
   bsrCandidateRPAdvInterval
   bsrCandidateRPHoldtime
   bsrCandidateBSRAddressType
   bsrCandidateBSRAddress
   bsrCandidateBSRPriority
   bsrCandidateBSRHashMaskLength

   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.

   In this MIB module, possible effects that can be induced by GET
   and/or NOTIFY operations include:

   o  Determination of Elected BSR, Candidate BSRs and Candidate RPs in
      the Multicast Network topology.  This information may be sensitive
      and may be used in preparation for DoS attacks including any of
      the attacks described above.

   SNMP versions prior to SNMPv3 did not include adequate security.
   Even if the network itself is secure (for example by using IPSec),
   there is still no control over whom on the secure network is allowed
   to access (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 access (read/change/create/delete) them.





Joshi & Bijlani         Expires February 24, 2007              [Page 18]


Internet-Draft                 PIM BSR MIB                   August 2006


7.  IANA Considerations

   PIM-BSR-MIB should be rooted under the mib-2 subtree.  IANA is
   requested to assign { mib-2 XXX } to the PIM-BSR-MIB module specified
   in this document.


8.  Acknowledgments

   This MIB module is based on the original work in
   [I-D.ietf-pim-mib-v2] by R. Sivaramu, J. Lingard and B. Joshi.

   Many thanks to Stig, Nidhi and David Mcwalter for their feedback on
   this MIB module.

   Suggested IPv6 multicast MIBs by R. Sivaramu and R. Raghunarayan have
   been used for comparison while editing this MIB module.


9.  References

9.1.  Normative References

   [RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
              Requirement Levels", BCP 14, RFC 2119, March 1997.

   [RFC2365]  Meyer, D., "Administratively Scoped IP Multicast", BCP 23,
              RFC 2365, July 1998.

   [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.




Joshi & Bijlani         Expires February 24, 2007              [Page 19]


Internet-Draft                 PIM BSR MIB                   August 2006


   [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., "Protocol Independent Multicast - Sparse Mode
              (PIM-SM): Protocol  Specification (Revised)",
              draft-ietf-pim-sm-v2-new-12 (work in progress),
              March 2006.

   [I-D.ietf-pim-mib-v2]
              Lingard, J., "Protocol Independent Multicast MIB",
              draft-ietf-pim-mib-v2-06 (work in progress), April 2006.

   [I-D.ietf-pim-sm-bsr]
              Bhaskar, N., "Bootstrap Router (BSR) Mechanism for PIM",
              draft-ietf-pim-sm-bsr-08 (work in progress), May 2006.

   [I-D.ietf-mboned-ip-mcast-mib]
              McWalter, D., "IP Multicast MIB",
              draft-ietf-mboned-ip-mcast-mib-03 (work in progress),
              August 2006.

9.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.























Joshi & Bijlani         Expires February 24, 2007              [Page 20]


Internet-Draft                 PIM BSR MIB                   August 2006


Authors' Addresses

   Bharat joshi
   Infosys Technologies Ltd.
   44 Electronics City, Hosur Road
   Bangalore  560 100
   India

   Email: bharat_joshi@infosys.com
   URI:   http://www.infosys.com/


   Raina Bijlani
   Cisco Systems
   170 W.Tasman Drive
   San Jose  CA 95134
   USA

   Email: rainab@cisco.com
































Joshi & Bijlani         Expires February 24, 2007              [Page 21]


Internet-Draft                 PIM BSR MIB                   August 2006


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 (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.




Joshi & Bijlani         Expires February 24, 2007              [Page 22]