IETF                                                         D. McWalter
Internet-Draft                                       Data Connection Ltd
Expires: April 8, 2006                                   October 5, 2005


                        PIM Bootstrap Router MIB
                   draft-mcwalter-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 April 8, 2006.

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 objects used for managing the Bootstrap
   Router (BSR) mechanism for PIM.








McWalter                  Expires April 8, 2006                 [Page 1]


Internet-Draft                 PIM BSR MIB                  October 2005


Table of Contents

   1.  Introduction . . . . . . . . . . . . . . . . . . . . . . . . .  3
   2.  The Internet-Standard Management Framework . . . . . . . . . .  3
   3.  Overview . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
   4.  Definitions  . . . . . . . . . . . . . . . . . . . . . . . . .  4
   5.  Security Considerations  . . . . . . . . . . . . . . . . . . . 15
   6.  IANA Considerations  . . . . . . . . . . . . . . . . . . . . . 15
   7.  Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 16
   8.  References . . . . . . . . . . . . . . . . . . . . . . . . . . 16
     8.1   Normative References . . . . . . . . . . . . . . . . . . . 16
     8.2   Informative References . . . . . . . . . . . . . . . . . . 17
       Author's Address . . . . . . . . . . . . . . . . . . . . . . . 17
       Intellectual Property and Copyright Statements . . . . . . . . 18





































McWalter                  Expires April 8, 2006                 [Page 2]


Internet-Draft                 PIM BSR MIB                  October 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 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 draft was created by the removal of BSR MIB support from the
   draft PIM MIB [I-D.ietf-pim-mib-v2-new].  This draft contains the
   removed material, presented as a separate MIB.

   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 [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
   [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,
   [RFC2578], STD 58, [RFC2579] and STD 58, [RFC2580].

3.  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 RP-Set Table, which contains one row for each group
       mapping that was learned via BSR.

   3.  The BSR Candidate-BSR Table, which contains 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



McWalter                  Expires April 8, 2006                 [Page 3]


Internet-Draft                 PIM BSR MIB                  October 2005


   [RFC2863], the INET-ADDRESS-MIB [RFC4001] and the IANA-RTPROTO-MIB.

4.  Definitions

PIM-BSR-MIB DEFINITIONS ::= BEGIN

IMPORTS
    MODULE-IDENTITY, OBJECT-TYPE,
    mib-2, Unsigned32, TimeTicks     FROM SNMPv2-SMI
    RowStatus, TruthValue            FROM SNMPv2-TC
    MODULE-COMPLIANCE, OBJECT-GROUP  FROM SNMPv2-CONF
    InetAddressType,
    InetAddressPrefixLength,
    InetAddress                      FROM INET-ADDRESS-MIB
    PimGroupMappingOriginType        FROM PIM-STD-MIB;

pimBsrMIB MODULE-IDENTITY
    LAST-UPDATED "200510050000Z" -- 5 October 2005
    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 (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     "200510050000Z" -- 5 October 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

--
-- Top-level structure
--

pimBsrMIBObjects OBJECT IDENTIFIER ::= { pimBsrMIB 1 }
pimBsr           OBJECT IDENTIFIER ::= { pimBsrMIBObjects 1 }

--
-- The BSR Candidate-RP Table
--

bsrCandidateRPTable OBJECT-TYPE
    SYNTAX     SEQUENCE OF BsrCandidateRPEntry



McWalter                  Expires April 8, 2006                 [Page 4]


Internet-Draft                 PIM BSR MIB                  October 2005


    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."
    ::= { pimBsr 1 }

bsrCandidateRPEntry OBJECT-TYPE
    SYNTAX     BsrCandidateRPEntry
    MAX-ACCESS not-accessible
    STATUS     current
    DESCRIPTION
            "An entry (conceptual row) in the bsrCandidateRPTable.  This
            entry is preserved on agent restart."
    INDEX      { bsrCandidateRPAddressType,
                 bsrCandidateRPAddress,
                 bsrCandidateRPGroupAddress,
                 bsrCandidateRPGroupPrefixLength }
    ::= { bsrCandidateRPTable 1 }

BsrCandidateRPEntry ::= SEQUENCE {
    bsrCandidateRPAddressType       InetAddressType,
    bsrCandidateRPAddress           InetAddress,
    bsrCandidateRPGroupAddress      InetAddress,
    bsrCandidateRPGroupPrefixLength InetAddressPrefixLength,
    bsrCandidateRPBidir             TruthValue,
    bsrCandidateRPStatus            RowStatus
}

bsrCandidateRPAddressType OBJECT-TYPE
    SYNTAX     InetAddressType
    MAX-ACCESS not-accessible
    STATUS     current
    DESCRIPTION
            "The 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 }




McWalter                  Expires April 8, 2006                 [Page 5]


Internet-Draft                 PIM BSR MIB                  October 2005


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 to 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 }

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.

            This status object can be set to active(1) without setting
            any other columnar objects in this entry.

            No other writeable objects in this entry can be modified
            when the status of this entry is active(1)."



McWalter                  Expires April 8, 2006                 [Page 6]


Internet-Draft                 PIM BSR MIB                  October 2005


    ::= { bsrCandidateRPEntry 6 }

--
-- The BSR RP-Set Table
--

bsrRPSetTable OBJECT-TYPE
    SYNTAX     SEQUENCE OF BsrRPSetEntry
    MAX-ACCESS not-accessible
    STATUS     current
    DESCRIPTION
            "The (conceptual) table listing BSR-specific information
            about PIM group mappings learned via BSR.  There is one
            entry in this table for every entry in the
            pimGroupMappingTable with a pimGroupMappingOrigin value of
            'bsr'."
    ::= { pimBsr 2 }

bsrRPSetEntry OBJECT-TYPE
    SYNTAX     BsrRPSetEntry
    MAX-ACCESS not-accessible
    STATUS     current
    DESCRIPTION
            "An entry (conceptual row) in the bsrRPSetTable.  This entry
            is preserved on agent restart."
    INDEX      { bsrGroupMappingOrigin,
                 bsrGroupMappingAddressType,
                 bsrGroupMappingGrpAddress,
                 bsrGroupMappingGrpPrefixLength,
                 bsrGroupMappingRPAddress }
    ::= { bsrRPSetTable 1 }

BsrRPSetEntry ::= SEQUENCE {
    bsrGroupMappingOrigin           PimGroupMappingOriginType,
    bsrGroupMappingAddressType      InetAddressType,
    bsrGroupMappingGrpAddress       InetAddress,
    bsrGroupMappingGrpPrefixLength  InetAddressPrefixLength,
    bsrGroupMappingRPAddress        InetAddress,
    bsrRPSetPriority                Unsigned32,
    bsrRPSetHoldtime                Unsigned32,
    bsrRPSetExpiryTime              TimeTicks
}

bsrGroupMappingOrigin OBJECT-TYPE
    SYNTAX     PimGroupMappingOriginType
    MAX-ACCESS not-accessible
    STATUS     current
    DESCRIPTION



McWalter                  Expires April 8, 2006                 [Page 7]


Internet-Draft                 PIM BSR MIB                  October 2005


            "The mechanism by which this group mapping was learned."
    ::= { bsrRPSetEntry 1 }

bsrGroupMappingAddressType OBJECT-TYPE
    SYNTAX     InetAddressType
    MAX-ACCESS not-accessible
    STATUS     current
    DESCRIPTION
            "The address type of the IP multicast group prefix."
    ::= { bsrRPSetEntry 2 }

bsrGroupMappingGrpAddress 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
            pimGroupMappingGrpPrefixLength, gives the group prefix for
            this mapping.  The InetAddressType is given by the
            pimGroupMappingAddressType object.

            This address object is only significant up to
            pimGroupMappingGrpPrefixLength bits.  The remainder of the
            address bits are zero.  This is especially important for
            this index field, which is part of the index of this entry.
            Any non-zero bits would signify an entirely different
            entry."
    ::= { bsrRPSetEntry 3 }

bsrGroupMappingGrpPrefixLength OBJECT-TYPE
    SYNTAX     InetAddressPrefixLength (4..128)
    MAX-ACCESS not-accessible
    STATUS     current
    DESCRIPTION
            "The multicast group prefix length, which, when combined
            with pimGroupMappingGrpAddress, gives the group prefix for
            this mapping.  The InetAddressType is given by the
            pimGroupMappingAddressType object.  If
            pimGroupMappingAddressType is 'ipv4' or 'ipv4z', this
            object must be in the range 4..32.  If
            pimGroupMappingAddressType is 'ipv6' or 'ipv6z', this object
            must be in the range 8..128."
    ::= { bsrRPSetEntry 4 }

bsrGroupMappingRPAddress OBJECT-TYPE
    SYNTAX     InetAddress (SIZE (4|8|16|20))
    MAX-ACCESS not-accessible
    STATUS     current



McWalter                  Expires April 8, 2006                 [Page 8]


Internet-Draft                 PIM BSR MIB                  October 2005


    DESCRIPTION
            "The IP address of the RP to be used for groups within this
            group prefix, or zero if no RP is to be used or if the RP
            address is unknown.  The InetAddressType is given by the
            pimGroupMappingAddressType object.  This object must be zero
            if pimGroupMappingPimMode is 'ssm', or if
            pimGroupMappingOrigin is 'embedded'."
    ::= { bsrRPSetEntry 5 }

bsrRPSetPriority OBJECT-TYPE
    SYNTAX     Unsigned32 (0..255)
    MAX-ACCESS read-only
    STATUS     current
    DESCRIPTION
            "The RP Priority from 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."
    ::= { bsrRPSetEntry 6 }

bsrRPSetHoldtime OBJECT-TYPE
    SYNTAX     Unsigned32 (0..65535)
    UNITS      "seconds"
    MAX-ACCESS read-only
    STATUS     current
    DESCRIPTION
            "The RP Holdtime from the PIM Candidate-RP-Advertisement
            message or PIM Bootstrap message by which this RP was
            learned."
    ::= { bsrRPSetEntry 7 }

bsrRPSetExpiryTime 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."
    ::= { bsrRPSetEntry 8 }

--
-- The BSR Candidate-BSR Table
--

bsrCandidateBSRTable OBJECT-TYPE
    SYNTAX     SEQUENCE OF BsrCandidateBSREntry



McWalter                  Expires April 8, 2006                 [Page 9]


Internet-Draft                 PIM BSR MIB                  October 2005


    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 address family 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.
            This entry is preserved on agent restart."
    INDEX      { bsrCandidateBSRAddressType }
    ::= { bsrCandidateBSRTable 1 }

BsrCandidateBSREntry ::= SEQUENCE {
    bsrCandidateBSRAddressType      InetAddressType,
    bsrCandidateBSRAddress          InetAddress,
    bsrCandidateBSRPriority         Unsigned32,
    bsrCandidateBSRHashMaskLength   Unsigned32,
    bsrCandidateBSRElectedBSR       TruthValue,
    bsrCandidateBSRBootstrapTimer   TimeTicks,
    bsrCandidateBSRStatus           RowStatus
}

bsrCandidateBSRAddressType OBJECT-TYPE
    SYNTAX     InetAddressType
    MAX-ACCESS not-accessible
    STATUS     current
    DESCRIPTION
            "The address type of the Candidate-BSR."
    ::= { bsrCandidateBSREntry 1 }

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 2 }

bsrCandidateBSRPriority OBJECT-TYPE



McWalter                  Expires April 8, 2006                [Page 10]


Internet-Draft                 PIM BSR MIB                  October 2005


    SYNTAX     Unsigned32 (0..255)
    MAX-ACCESS read-create
    STATUS     current
    DESCRIPTION
            "The priority value for the local router as a Candidate-BSR
            for this address type.  Numerically higher values for this
            object indicate higher priorities."
    DEFVAL { 0 }
    ::= { bsrCandidateBSREntry 3 }

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 address type.  This object defaults to 30 if
            bsrCandidateBSRAddressType is 'ipv4' or 'ipv4z', and
            defaults to 126 if bsrCandidateBSRAddressType is 'ipv6' or
            'ipv6z'."
    -- DEFVAL { 30 or 126 }
    ::= { bsrCandidateBSREntry 4 }

bsrCandidateBSRElectedBSR OBJECT-TYPE
    SYNTAX     TruthValue
    MAX-ACCESS read-only
    STATUS     current
    DESCRIPTION
            "Whether the local router is the elected BSR for this
            address type."
    ::= { bsrCandidateBSREntry 5 }

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 address type.  This is zero if
            bsrCandidateBSRElectedBSR is 'false'."
    ::= { bsrCandidateBSREntry 6 }

bsrCandidateBSRStatus OBJECT-TYPE
    SYNTAX     RowStatus
    MAX-ACCESS read-create
    STATUS     current
    DESCRIPTION



McWalter                  Expires April 8, 2006                [Page 11]


Internet-Draft                 PIM BSR MIB                  October 2005


            "The status of this row, by which new entries may be
            created, or old entries deleted from this table.  There are
            no other other writeable columnar objects in this entry."
    ::= { bsrCandidateBSREntry 7 }

--
-- 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 address family
            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.  This
            entry is preserved on agent restart."
    INDEX      { bsrElectedBSRAddressType }
    ::= { bsrElectedBSRTable 1 }

BsrElectedBSREntry ::= SEQUENCE {
    bsrElectedBSRAddressType      InetAddressType,
    bsrElectedBSRAddress          InetAddress,
    bsrElectedBSRPriority         Unsigned32,
    bsrElectedBSRHashMaskLength   Unsigned32,
    bsrElectedBSRExpiryTime       TimeTicks,
    bsrElectedBSRCRPAdvTimer      TimeTicks
}

bsrElectedBSRAddressType OBJECT-TYPE
    SYNTAX     InetAddressType
    MAX-ACCESS not-accessible
    STATUS     current
    DESCRIPTION
            "The address type of the elected BSR."
    ::= { bsrElectedBSREntry 1 }

bsrElectedBSRAddress OBJECT-TYPE
    SYNTAX     InetAddress (SIZE (4|8|16|20))



McWalter                  Expires April 8, 2006                [Page 12]


Internet-Draft                 PIM BSR MIB                  October 2005


    MAX-ACCESS read-only
    STATUS     current
    DESCRIPTION
            "The (unicast) address of the elected BSR.  The
            InetAddressType is given by the bsrElectedBSRAddressType
            object."
    ::= { bsrElectedBSREntry 2 }

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 3 }

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 address type."
    ::= { bsrElectedBSREntry 4 }

bsrElectedBSRExpiryTime OBJECT-TYPE
    SYNTAX     TimeTicks
    MAX-ACCESS read-only
    STATUS     current
    DESCRIPTION
            "The minimum time remaining before the elected BSR for this
            address type will be declared down."
    ::= { bsrElectedBSREntry 5 }

bsrElectedBSRCRPAdvTimer OBJECT-TYPE
    SYNTAX     TimeTicks
    MAX-ACCESS read-only
    STATUS     current
    DESCRIPTION
            "The time remaining before the local router next sends a
            Candidate-RP-Advertisement signal to the elected BSR for
            this address type.

            If the local router is not configured as a candidate RP,
            then this object is set to zero."
    ::= { bsrElectedBSREntry 6 }



McWalter                  Expires April 8, 2006                [Page 13]


Internet-Draft                 PIM BSR MIB                  October 2005


--
-- 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
            the PIM BSR MIB."
    MODULE  -- this module
    MANDATORY-GROUPS { pimBsrObjectGroup }
    ::= { pimBsrMIBCompliances 1 }

--
-- Units of Conformance
--

pimBsrObjectGroup OBJECT-GROUP
    OBJECTS { bsrCandidateRPBidir,
              bsrCandidateRPStatus,
              bsrRPSetPriority,
              bsrRPSetHoldtime,
              bsrRPSetExpiryTime,
              bsrCandidateBSRAddress,
              bsrCandidateBSRPriority,
              bsrCandidateBSRHashMaskLength,
              bsrCandidateBSRElectedBSR,
              bsrCandidateBSRBootstrapTimer,
              bsrCandidateBSRStatus,
              bsrElectedBSRAddress,
              bsrElectedBSRPriority,
              bsrElectedBSRHashMaskLength,
              bsrElectedBSRExpiryTime,
              bsrElectedBSRCRPAdvTimer }
    STATUS  current
    DESCRIPTION
            "A collection of objects for managing PIM routers."
    ::= { pimBsrMIBGroups 1 }

END



McWalter                  Expires April 8, 2006                [Page 14]


Internet-Draft                 PIM BSR MIB                  October 2005


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:

   TO DO

   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:

   TO DO

   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.

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






McWalter                  Expires April 8, 2006                [Page 15]


Internet-Draft                 PIM BSR MIB                  October 2005


7.  Acknowledgements

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

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

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.

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

   [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):
              Protocol Specification  (Revised)",
              draft-ietf-pim-sm-v2-new-11 (work in progress),
              October 2004.




McWalter                  Expires April 8, 2006                [Page 16]


Internet-Draft                 PIM BSR MIB                  October 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.

   [I-D.ietf-pim-mib-v2]
              Sivaramu, R., Lingard, J., McWalter, D., and Joshi, B.,
              "Protocol Independent Multicast MIB",
              draft-ietf-pim-mib-v2-04, (work in progress),
              October 2005.

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.


Author's Address

   David McWalter
   Data Connection Ltd
   100 Church Street
   Enfield  EN2 6BQ
   UK

   Email: dmcw@dataconnection.com
























McWalter                  Expires April 8, 2006                [Page 17]


Internet-Draft                 PIM BSR MIB                  October 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.




McWalter                  Expires April 8, 2006                [Page 18]