home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_ietf_i / draft-ietf-idmr-pim-mib-03.txt < prev    next >
Text File  |  1997-03-27  |  33KB  |  1,355 lines
  1.  
  2.  
  3.  
  4.  
  5. IDMR Working Group                                   Keith McCloghrie
  6. INTERNET-DRAFT                                         Dino Farinacci
  7. Expires September 1997                                  Cisco Systems
  8.                                                           Dave Thaler
  9.                                                University of Michigan
  10.                                                         25 March 1997
  11.  
  12.  
  13.  
  14.                    Protocol Independent Multicast MIB
  15.                     <draft-ietf-idmr-pim-mib-03.txt>
  16.  
  17.  
  18.  
  19.  
  20.  
  21. Status of this Memo
  22.  
  23. This document is an Internet Draft.  Internet Drafts are working
  24. documents of the Internet Engineering Task Force (IETF), its Areas, and
  25. its Working Groups.  Note that other groups may also distribute working
  26. documents as Internet Drafts.
  27.  
  28. Internet Drafts are valid for a maximum of six months and may be
  29. updated, replaced, or obsoleted by other documents at any time.  It is
  30. inappropriate to use Internet Drafts as reference material or to cite
  31. them other than as a "work in progress".
  32.  
  33.  
  34. 1.  Introduction
  35.  
  36. This memo defines an experimental portion of the Management Information
  37. Base (MIB) for use with network management protocols in the Internet
  38. community.  In particular, it describes managed objects used for
  39. managing the Protocol Independent Multicast (PIM) protocol [5,6,7,8].
  40. This MIB module is applicable to IP multicast routers which implement
  41. PIM.
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61. Draft                           PIM MIB                       March 1997
  62.  
  63.  
  64. 2.  Revision History
  65.  
  66. A record of changes which will be removed before publication.
  67.  
  68. 25 March
  69.  
  70. (1)  deprecated pimInterfaceMode, which is obsoleted by
  71.      ipMRouteInterfaceProtocol in the IP Multicast MIB.
  72.  
  73. (2)  deprecated pimNeighborMode (to retain support for PIM version 1).
  74.  
  75. (3)  moved pimCandidateBSRPreference to the PIM Interface Table and
  76.      renamed it pimInterfaceCBSRPreference.
  77.  
  78. (4)  moved pimBSRAddress, pimBSRExpiryTime, and pimCandidateRPHoldTime
  79.      to the new PIM Component Table, to manage routers connected to
  80.      multiple PIM domains.
  81.  
  82. (5)  renamed pimMessageInterval to pimJoinPruneInterval and
  83.      pimInterfaceQueryInterval to pimInterfaceHelloInterval.
  84.  
  85. (6)  added pimInterfaceJoinPruneInterval.
  86.  
  87. 9 June:
  88.  
  89. (1)  added pimRPSetTable and pimCandidateRPTable.
  90.  
  91. (2)  deprecated pimRPTable (to retain support for PIM version 1).
  92.  
  93. (3)  removed pimGroupTable.
  94.  
  95. (4)  added pimBSRAddress, pimBSRExpiryTime, pimCandidateBSRPreference
  96.      and pimCandidateRPHoldTime.
  97.  
  98. 4 November:
  99.  
  100. (1)  changed the PIM Group table to hold information common to all RPs
  101.      of a group.
  102.  
  103. (2)  added the PIM RP table with each entry specific to an RP of a
  104.      group.
  105.  
  106. (3)  added pimNeighborMode
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114. Expires September 1997                                          [Page 2]
  115.  
  116.  
  117.  
  118.  
  119.  
  120. Draft                           PIM MIB                       March 1997
  121.  
  122.  
  123. (4)  modified the pimGroupTable to be indexed by pimGroupAddress and
  124.      pimGroupRP, in order to allow for multiple RPs per group.
  125.  
  126. 15 July - initial version.
  127.  
  128.  
  129. 3.  The SNMP Network Management Framework
  130.  
  131. The SNMP Network Management Framework presently consists of three major
  132. components.  They are:
  133.  
  134. o    RFC 1902 [1] which defines the SMI, the mechanisms used for
  135.      describing and naming objects for the purpose of management.
  136.  
  137. o    STD 17, RFC 1213 [2] defines MIB-II, the core set of managed
  138.      objects for the Internet suite of protocols.
  139.  
  140. o    RFC 1157 [3] and RFC 1905 [4] which define two versions of the
  141.      protocol used for network access to managed objects.
  142.  
  143. The Framework permits new objects to be defined for the purpose of
  144. experimentation and evaluation.
  145.  
  146.  
  147. 3.1.  Object Definitions
  148.  
  149. Managed objects are accessed via a virtual information store, termed the
  150. Management Information Base or MIB.  Objects in the MIB are defined
  151. using the subset of Abstract Syntax Notation One (ASN.1) defined in the
  152. SMI.  In particular, each object type is named by an OBJECT IDENTIFIER,
  153. an administratively assigned name.  The object type together with an
  154. object instance serves to uniquely identify a specific instantiation of
  155. the object.  For human convenience, we often use a textual string,
  156. termed the descriptor, to refer to the object type.
  157.  
  158.  
  159. 4.  Overview
  160.  
  161. This MIB module contains one scalar and six tables.  The tables are:
  162.  
  163. (1)  the PIM Interface Table which contains one row for each of the
  164.      router's PIM interfaces;
  165.  
  166. (2)  the PIM Neighbor Table which contains one row for each of the
  167.      router's PIM neighbors; and
  168.  
  169.  
  170.  
  171.  
  172.  
  173. Expires September 1997                                          [Page 3]
  174.  
  175.  
  176.  
  177.  
  178.  
  179. Draft                           PIM MIB                       March 1997
  180.  
  181.  
  182. (3)  the PIM RP-Set Table which contains the PIM (version 2) information
  183.      for sets of candidate Rendezvous Points (RPs) for IP multicast
  184.      group addresses with particular address prefixes.
  185.  
  186. (4)  the PIM Candidate-RP Table which contains the IP multicast groups
  187.      for which the local router is to advertise itself as a Candidate-
  188.      RP.  If this table is empty, then the local router advertises
  189.      itself as a Candidate-RP for all groups.
  190.  
  191. (5)  the (deprecated) PIM RP Table which contains the PIM (version 1)
  192.      information for IP multicast groups which is common to all RPs of a
  193.      group;
  194.  
  195. (6)  the PIM Component Table which contains one row for each of the PIM
  196.      domains to which the router is connected.
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232. Expires September 1997                                          [Page 4]
  233.  
  234.  
  235.  
  236.  
  237.  
  238. Draft                           PIM MIB                       March 1997
  239.  
  240.  
  241. 5.  Definitions
  242.  
  243. PIM-MIB DEFINITIONS ::= BEGIN
  244.  
  245. IMPORTS
  246.     MODULE-IDENTITY, OBJECT-TYPE, experimental,
  247.     Integer32, IpAddress, TimeTicks  FROM SNMPv2-SMI
  248.     RowStatus                        FROM SNMPv2-TC
  249.     MODULE-COMPLIANCE, OBJECT-GROUP  FROM SNMPv2-CONF;
  250.  
  251. pimMIB MODULE-IDENTITY
  252.     LAST-UPDATED "9703261231Z"
  253.     ORGANIZATION "IETF IDMR Working Group."
  254.     CONTACT-INFO
  255.             " Keith McCloghrie
  256.               Cisco Systems, Inc.
  257.               170 West Tasman Drive
  258.               San Jose, CA  95134-1706
  259.               US
  260.  
  261.               Phone: +1 408 526 5260
  262.               EMail: kzm@cisco.com"
  263.     DESCRIPTION
  264.             "The MIB module for management of PIM routers."
  265.     ::= { experimental 61 }
  266.  
  267. pimMIBObjects OBJECT IDENTIFIER ::= { pimMIB 1 }
  268.  
  269. pim           OBJECT IDENTIFIER ::= { pimMIBObjects 1 }
  270.  
  271.  
  272. pimJoinPruneInterval OBJECT-TYPE
  273.     SYNTAX     Integer32
  274.     UNITS      "seconds"
  275.     MAX-ACCESS read-write
  276.     STATUS     current
  277.     DESCRIPTION
  278.             "The default interval at which periodic PIM-SM Join/Prune
  279.             messages are to be sent."
  280.     ::= { pim 1 }
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291. Expires September 1997                                          [Page 5]
  292.  
  293.  
  294.  
  295.  
  296.  
  297. Draft                           PIM MIB                       March 1997
  298.  
  299.  
  300. -- The PIM Interface Table
  301.  
  302. pimInterfaceTable OBJECT-TYPE
  303.     SYNTAX     SEQUENCE OF PimInterfaceEntry
  304.     MAX-ACCESS not-accessible
  305.     STATUS     current
  306.     DESCRIPTION
  307.             "The (conceptual) table listing the router's PIM interfaces.
  308.             IGMP and PIM are enabled on all interfaces listed in this
  309.             table."
  310.     ::= { pim 2 }
  311.  
  312. pimInterfaceEntry OBJECT-TYPE
  313.     SYNTAX     PimInterfaceEntry
  314.     MAX-ACCESS not-accessible
  315.     STATUS     current
  316.     DESCRIPTION
  317.             "An entry (conceptual row) in the pimInterfaceTable."
  318.     INDEX      { pimInterfaceIfIndex }
  319.     ::= { pimInterfaceTable 1 }
  320.  
  321. PimInterfaceEntry ::= SEQUENCE {
  322.     pimInterfaceIfIndex            Integer32,
  323.     pimInterfaceAddress            IpAddress,
  324.     pimInterfaceNetMask            IpAddress,
  325.     pimInterfaceMode               INTEGER,
  326.     pimInterfaceDR                 IpAddress,
  327.     pimInterfaceHelloInterval      Integer32,
  328.     pimInterfaceStatus             RowStatus,
  329.     pimInterfaceJoinPruneInterval  Integer32,
  330.     pimInterfaceCBSRPreference     Integer32
  331. }
  332.  
  333. pimInterfaceIfIndex OBJECT-TYPE
  334.     SYNTAX     Integer32
  335.     MAX-ACCESS not-accessible
  336.     STATUS     current
  337.     DESCRIPTION
  338.             "The ifIndex value of this PIM interface."
  339.     ::= { pimInterfaceEntry 1 }
  340.  
  341. pimInterfaceAddress OBJECT-TYPE
  342.     SYNTAX     IpAddress
  343.     MAX-ACCESS read-only
  344.     STATUS     current
  345.  
  346.  
  347.  
  348.  
  349.  
  350. Expires September 1997                                          [Page 6]
  351.  
  352.  
  353.  
  354.  
  355.  
  356. Draft                           PIM MIB                       March 1997
  357.  
  358.  
  359.     DESCRIPTION
  360.             "The IP address of the PIM interface."
  361.     ::= { pimInterfaceEntry 2 }
  362.  
  363. pimInterfaceNetMask OBJECT-TYPE
  364.     SYNTAX     IpAddress
  365.     MAX-ACCESS read-only
  366.     STATUS     current
  367.     DESCRIPTION
  368.             "The network mask for the IP address of the PIM interface."
  369.     ::= { pimInterfaceEntry 3 }
  370.  
  371. pimInterfaceMode OBJECT-TYPE
  372.     SYNTAX     INTEGER { dense(1), sparse(2) }
  373.     MAX-ACCESS read-create
  374.     STATUS     deprecated
  375.     DESCRIPTION
  376.             "The configured mode of this PIM interface."
  377.     DEFVAL     { dense }
  378.     ::= { pimInterfaceEntry 4 }
  379.  
  380. pimInterfaceDR OBJECT-TYPE
  381.     SYNTAX     IpAddress
  382.     MAX-ACCESS read-only
  383.     STATUS     current
  384.     DESCRIPTION
  385.             "The Designated Router on this PIM interface.  For point-
  386.             to-point interfaces, this object has the value 0.0.0.0."
  387.     ::= { pimInterfaceEntry 5 }
  388.  
  389. pimInterfaceHelloInterval OBJECT-TYPE
  390.     SYNTAX     Integer32
  391.     UNITS      "seconds"
  392.     MAX-ACCESS read-create
  393.     STATUS     current
  394.     DESCRIPTION
  395.             "The frequency at which PIM Hello messages are transmitted
  396.             on this interface."
  397.     DEFVAL     { 30 }
  398.     ::= { pimInterfaceEntry 6 }
  399.  
  400. pimInterfaceStatus OBJECT-TYPE
  401.     SYNTAX     RowStatus
  402.     MAX-ACCESS read-create
  403.     STATUS     current
  404.  
  405.  
  406.  
  407.  
  408.  
  409. Expires September 1997                                          [Page 7]
  410.  
  411.  
  412.  
  413.  
  414.  
  415. Draft                           PIM MIB                       March 1997
  416.  
  417.  
  418.     DESCRIPTION
  419.             "The status of this entry.  Creating the entry enables PIM
  420.             on the interface; destroying the entry disables PIM on the
  421.             interface."
  422.     ::= { pimInterfaceEntry 7 }
  423.  
  424. pimInterfaceJoinPruneInterval OBJECT-TYPE
  425.     SYNTAX     Integer32
  426.     UNITS      "seconds"
  427.     MAX-ACCESS read-create
  428.     STATUS     current
  429.     DESCRIPTION
  430.             "The frequency at which PIM Join/Prune messages are
  431.             transmitted on this PIM interface.  The default value of
  432.             this object is the pimJoinPruneInterval."
  433.     ::= { pimInterfaceEntry 8 }
  434.  
  435. pimInterfaceCBSRPreference OBJECT-TYPE
  436.     SYNTAX     Integer32 (-1..255)
  437.     MAX-ACCESS read-create
  438.     STATUS     current
  439.     DESCRIPTION
  440.             "The preference value for the local interface as a candidate
  441.             bootstrap router.  The value of -1 is used to indicate that
  442.             the local interface is not a candidate BSR interface."
  443.     DEFVAL     { 0 }
  444.     ::= { pimInterfaceEntry 9 }
  445.  
  446.  
  447. -- The PIM Neighbor Table
  448.  
  449. pimNeighborTable OBJECT-TYPE
  450.     SYNTAX     SEQUENCE OF PimNeighborEntry
  451.     MAX-ACCESS not-accessible
  452.     STATUS     current
  453.     DESCRIPTION
  454.             "The (conceptual) table listing the router's PIM neighbors."
  455.     ::= { pim 3 }
  456.  
  457. pimNeighborEntry OBJECT-TYPE
  458.     SYNTAX     PimNeighborEntry
  459.     MAX-ACCESS not-accessible
  460.     STATUS     current
  461.     DESCRIPTION
  462.             "An entry (conceptual row) in the pimNeighborTable."
  463.  
  464.  
  465.  
  466.  
  467.  
  468. Expires September 1997                                          [Page 8]
  469.  
  470.  
  471.  
  472.  
  473.  
  474. Draft                           PIM MIB                       March 1997
  475.  
  476.  
  477.     INDEX      { pimNeighborAddress }
  478.     ::= { pimNeighborTable 1 }
  479.  
  480. PimNeighborEntry ::= SEQUENCE {
  481.     pimNeighborAddress      IpAddress,
  482.     pimNeighborIfIndex      Integer32,
  483.     pimNeighborUpTime       TimeTicks,
  484.     pimNeighborExpiryTime   TimeTicks,
  485.     pimNeighborMode         INTEGER
  486. }
  487.  
  488. pimNeighborAddress OBJECT-TYPE
  489.     SYNTAX     IpAddress
  490.     MAX-ACCESS not-accessible
  491.     STATUS     current
  492.     DESCRIPTION
  493.             "The IP address of the PIM neighbor for which this entry
  494.             contains information."
  495.     ::= { pimNeighborEntry 1 }
  496.  
  497. pimNeighborIfIndex OBJECT-TYPE
  498.     SYNTAX     Integer32
  499.     MAX-ACCESS read-only
  500.     STATUS     current
  501.     DESCRIPTION
  502.             "The value of ifIndex for the interface used to reach this
  503.             PIM neighbor."
  504.     ::= { pimNeighborEntry 2 }
  505.  
  506. pimNeighborUpTime OBJECT-TYPE
  507.     SYNTAX     TimeTicks
  508.     MAX-ACCESS read-only
  509.     STATUS     current
  510.     DESCRIPTION
  511.             "The time since this PIM neighbor (last) became a neighbor
  512.             of the local router."
  513.     ::= { pimNeighborEntry 3 }
  514.  
  515. pimNeighborExpiryTime OBJECT-TYPE
  516.     SYNTAX     TimeTicks
  517.     MAX-ACCESS read-only
  518.     STATUS     current
  519.     DESCRIPTION
  520.             "The minimum time remaining before this PIM neighbor will be
  521.             aged out."
  522.  
  523.  
  524.  
  525.  
  526.  
  527. Expires September 1997                                          [Page 9]
  528.  
  529.  
  530.  
  531.  
  532.  
  533. Draft                           PIM MIB                       March 1997
  534.  
  535.  
  536.     ::= { pimNeighborEntry 4 }
  537.  
  538. pimNeighborMode OBJECT-TYPE
  539.     SYNTAX     INTEGER { dense(1), sparse(2) }
  540.     MAX-ACCESS read-only
  541.     STATUS     deprecated
  542.     DESCRIPTION
  543.             "The active PIM mode of this neighbor.  This object is
  544.             deprecated for PIMv2 routers since all neighbors on the
  545.             interface must be either dense or sparse as determined by
  546.             the protocol running on the interface."
  547.     ::= { pimNeighborEntry 5 }
  548.  
  549.  
  550. -- The PIM RP Table
  551.  
  552. pimRPTable OBJECT-TYPE
  553.     SYNTAX     SEQUENCE OF PimRPEntry
  554.     MAX-ACCESS not-accessible
  555.     STATUS     deprecated
  556.     DESCRIPTION
  557.             "The (conceptual) table listing PIM version 1 information
  558.             for the Rendezvous Points (RPs) for IP multicast groups.
  559.             This table is deprecated since its function is replaced by
  560.             the pimRPSetTable for PIM version 2."
  561.     ::= { pim 5 }
  562.  
  563. pimRPEntry OBJECT-TYPE
  564.     SYNTAX     PimRPEntry
  565.     MAX-ACCESS not-accessible
  566.     STATUS     deprecated
  567.     DESCRIPTION
  568.             "An entry (conceptual row) in the pimRPTable.  There is one
  569.             entry per RP address for each IP multicast group."
  570.     INDEX      { pimRPGroupAddress, pimRPAddress }
  571.     ::= { pimRPTable 1 }
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586. Expires September 1997                                         [Page 10]
  587.  
  588.  
  589.  
  590.  
  591.  
  592. Draft                           PIM MIB                       March 1997
  593.  
  594.  
  595. PimRPEntry ::= SEQUENCE {
  596.     pimRPGroupAddress    IpAddress,
  597.     pimRPAddress         IpAddress,
  598.     pimRPState           INTEGER,
  599.     pimRPStateTimer      TimeTicks,
  600.     pimRPLastChange      TimeTicks,
  601.     pimRPRowStatus       RowStatus
  602. }
  603.  
  604. pimRPGroupAddress OBJECT-TYPE
  605.     SYNTAX     IpAddress
  606.     MAX-ACCESS not-accessible
  607.     STATUS     deprecated
  608.     DESCRIPTION
  609.             "The IP multicast group address for which this entry
  610.             contains information about an RP."
  611.     ::= { pimRPEntry 1 }
  612.  
  613. pimRPAddress OBJECT-TYPE
  614.     SYNTAX     IpAddress
  615.     MAX-ACCESS not-accessible
  616.     STATUS     deprecated
  617.     DESCRIPTION
  618.             "The IP multicast group address for which this entry
  619.             contains PIM version 1 information about an RP."
  620.     ::= { pimRPEntry 2 }
  621.  
  622. pimRPState OBJECT-TYPE
  623.     SYNTAX     INTEGER { up(1), down(2) }
  624.     MAX-ACCESS read-only
  625.     STATUS     deprecated
  626.     DESCRIPTION
  627.             "The state of the RP."
  628.     ::= { pimRPEntry 3 }
  629.  
  630. pimRPStateTimer OBJECT-TYPE
  631.     SYNTAX     TimeTicks
  632.     MAX-ACCESS read-only
  633.     STATUS     deprecated
  634.     DESCRIPTION
  635.             "The minimum time remaining before the next state change.
  636.             When pimRPState is up, this is the minimum time which must
  637.             expire until it can be declared down.  When pimRPState is
  638.             down, this is the time until it will be declared up (in
  639.             order to retry)."
  640.  
  641.  
  642.  
  643.  
  644.  
  645. Expires September 1997                                         [Page 11]
  646.  
  647.  
  648.  
  649.  
  650.  
  651. Draft                           PIM MIB                       March 1997
  652.  
  653.  
  654.     ::= { pimRPEntry 4 }
  655.  
  656. pimRPLastChange OBJECT-TYPE
  657.     SYNTAX     TimeTicks
  658.     MAX-ACCESS read-only
  659.     STATUS     deprecated
  660.     DESCRIPTION
  661.             "The value of sysUpTime at the time when the corresponding
  662.             instance of pimRPState last changed its value."
  663.     ::= { pimRPEntry 5 }
  664.  
  665. pimRPRowStatus OBJECT-TYPE
  666.     SYNTAX     RowStatus
  667.     MAX-ACCESS read-create
  668.     STATUS     deprecated
  669.     DESCRIPTION
  670.             "The status of this row, by which new entries may be
  671.             created, or old entries deleted from this table."
  672.     ::= { pimRPEntry 6 }
  673.  
  674.  
  675. -- The PIM RP-Set Table
  676.  
  677. pimRPSetTable OBJECT-TYPE
  678.     SYNTAX     SEQUENCE OF PimRPSetEntry
  679.     MAX-ACCESS not-accessible
  680.     STATUS     current
  681.     DESCRIPTION
  682.             "The (conceptual) table listing PIM information for
  683.             candidate Rendezvous Points (RPs) for IP multicast groups.
  684.             When the local router is the BSR, this information is
  685.             obtained from received Candidate-RP-Advertisements.  When
  686.             the local router is not the BSR, this information is
  687.             obtained from received RP-Set messages."
  688.     ::= { pim 6 }
  689.  
  690. pimRPSetEntry OBJECT-TYPE
  691.     SYNTAX     PimRPSetEntry
  692.     MAX-ACCESS not-accessible
  693.     STATUS     current
  694.     DESCRIPTION
  695.             "An entry (conceptual row) in the pimRPSetTable."
  696.     INDEX      { pimRPSetGroupAddress, pimRPSetGroupMask,
  697.                  pimRPSetAddress }
  698.     ::= { pimRPSetTable 1 }
  699.  
  700.  
  701.  
  702.  
  703.  
  704. Expires September 1997                                         [Page 12]
  705.  
  706.  
  707.  
  708.  
  709.  
  710. Draft                           PIM MIB                       March 1997
  711.  
  712.  
  713. PimRPSetEntry ::= SEQUENCE {
  714.     pimRPSetGroupAddress    IpAddress,
  715.     pimRPSetGroupMask       IpAddress,
  716.     pimRPSetAddress         IpAddress,
  717.     pimRPSetHoldTime        Integer32,
  718.     pimRPSetExpiryTime      TimeTicks
  719. }
  720.  
  721. pimRPSetGroupAddress OBJECT-TYPE
  722.     SYNTAX     IpAddress
  723.     MAX-ACCESS not-accessible
  724.     STATUS     current
  725.     DESCRIPTION
  726.             "The IP multicast group address which, when combined with
  727.             pimRPSetGroupMask, gives the group prefix for which this
  728.             entry contains information about the Candidate-RP."
  729.     ::= { pimRPSetEntry 1 }
  730.  
  731. pimRPSetGroupMask OBJECT-TYPE
  732.     SYNTAX     IpAddress
  733.     MAX-ACCESS not-accessible
  734.     STATUS     current
  735.     DESCRIPTION
  736.             "The multicast group address mask which, when combined with
  737.             pimRPSetGroupAddress, gives the group prefix for which this
  738.             entry contains information about the Candidate-RP."
  739.     ::= { pimRPSetEntry 2 }
  740.  
  741. pimRPSetAddress OBJECT-TYPE
  742.     SYNTAX     IpAddress
  743.     MAX-ACCESS not-accessible
  744.     STATUS     current
  745.     DESCRIPTION
  746.             "The IP address of the Candidate-RP."
  747.     ::= { pimRPSetEntry 3 }
  748.  
  749. pimRPSetHoldTime OBJECT-TYPE
  750.     SYNTAX     Integer32 (0..255)
  751.     UNITS      "seconds"
  752.     MAX-ACCESS read-only
  753.     STATUS     current
  754.     DESCRIPTION
  755.             "The holdtime of a Candidate-RP.  If the local router is not
  756.             the BSR, this value is 0."
  757.     ::= { pimRPSetEntry 4 }
  758.  
  759.  
  760.  
  761.  
  762.  
  763. Expires September 1997                                         [Page 13]
  764.  
  765.  
  766.  
  767.  
  768.  
  769. Draft                           PIM MIB                       March 1997
  770.  
  771.  
  772. pimRPSetExpiryTime OBJECT-TYPE
  773.     SYNTAX     TimeTicks
  774.     MAX-ACCESS read-only
  775.     STATUS     current
  776.     DESCRIPTION
  777.             "The minimum time remaining before the Candidate-RP will be
  778.             declared down.  If the local router is not the BSR, this
  779.             value is 0."
  780.     ::= { pimRPSetEntry 5 }
  781.  
  782.  
  783. -- The PIM Candidate-RP Table
  784.  
  785. pimCandidateRPTable OBJECT-TYPE
  786.     SYNTAX     SEQUENCE OF PimCandidateRPEntry
  787.     MAX-ACCESS not-accessible
  788.     STATUS     current
  789.     DESCRIPTION
  790.             "The (conceptual) table listing the IP multicast groups for
  791.             which the local router is to advertise itself as a
  792.             Candidate-RP when the value of pimCandidateRPHoldTime is
  793.             non-zero.  If this table is empty, then the local router
  794.             will advertise itself as a Candidate-RP for all groups
  795.             (providing the value of pimCandidateRPHoldTime is non-
  796.             zero)."
  797.     ::= { pim 11 }
  798.  
  799. pimCandidateRPEntry OBJECT-TYPE
  800.     SYNTAX     PimCandidateRPEntry
  801.     MAX-ACCESS not-accessible
  802.     STATUS     current
  803.     DESCRIPTION
  804.             "An entry (conceptual row) in the pimCandidateRPTable."
  805.     INDEX      { pimCandidateRPGroupAddress,
  806.                  pimCandidateRPGroupMask }
  807.     ::= { pimCandidateRPTable 1 }
  808.  
  809. PimCandidateRPEntry ::= SEQUENCE {
  810.     pimCandidateRPGroupAddress    IpAddress,
  811.     pimCandidateRPGroupMask       IpAddress,
  812.     pimCandidateRPAddress         IpAddress,
  813.     pimCandidateRPRowStatus       RowStatus
  814. }
  815.  
  816. pimCandidateRPGroupAddress OBJECT-TYPE
  817.  
  818.  
  819.  
  820.  
  821.  
  822. Expires September 1997                                         [Page 14]
  823.  
  824.  
  825.  
  826.  
  827.  
  828. Draft                           PIM MIB                       March 1997
  829.  
  830.  
  831.     SYNTAX     IpAddress
  832.     MAX-ACCESS not-accessible
  833.     STATUS     current
  834.     DESCRIPTION
  835.             "The IP multicast group address which, when combined with
  836.             pimCandidateRPGroupMask, identifies a group prefix for which
  837.             the local router will advertise itself as a Candidate-RP."
  838.     ::= { pimCandidateRPEntry 1 }
  839.  
  840. pimCandidateRPGroupMask OBJECT-TYPE
  841.     SYNTAX     IpAddress
  842.     MAX-ACCESS not-accessible
  843.     STATUS     current
  844.     DESCRIPTION
  845.             "The multicast group address mask which, when combined with
  846.             pimCandidateRPGroupMask, identifies a group prefix for which
  847.             the local router will advertise itself as a Candidate-RP."
  848.     ::= { pimCandidateRPEntry 2 }
  849.  
  850. pimCandidateRPAddress OBJECT-TYPE
  851.     SYNTAX     IpAddress
  852.     MAX-ACCESS read-create
  853.     STATUS     current
  854.     DESCRIPTION
  855.             "The (unicast) address of the interface which will be
  856.             advertised as a Candidate-RP."
  857.     ::= { pimCandidateRPEntry 3 }
  858.  
  859. pimCandidateRPRowStatus OBJECT-TYPE
  860.     SYNTAX     RowStatus
  861.     MAX-ACCESS read-create
  862.     STATUS     current
  863.     DESCRIPTION
  864.             "The status of this row, by which new entries may be
  865.             created, or old entries deleted from this table."
  866.     ::= { pimCandidateRPEntry 4 }
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881. Expires September 1997                                         [Page 15]
  882.  
  883.  
  884.  
  885.  
  886.  
  887. Draft                           PIM MIB                       March 1997
  888.  
  889.  
  890. -- The PIM Component Table
  891.  
  892. pimComponentTable OBJECT-TYPE
  893.     SYNTAX     SEQUENCE OF PimComponentEntry
  894.     MAX-ACCESS not-accessible
  895.     STATUS     current
  896.     DESCRIPTION
  897.             "The (conceptual) table containing objects specific to a PIM
  898.             domain.  One row exists for each domain to which the router
  899.             is connected."
  900.     ::= { pim 12 }
  901.  
  902. pimComponentEntry OBJECT-TYPE
  903.     SYNTAX     PimComponentEntry
  904.     MAX-ACCESS not-accessible
  905.     STATUS     current
  906.     DESCRIPTION
  907.             "An entry (conceptual row) in the pimComponentTable."
  908.     INDEX      { pimComponentIndex }
  909.     ::= { pimComponentTable 1 }
  910.  
  911. PimComponentEntry ::= SEQUENCE {
  912.     pimComponentIndex              Integer32,
  913.     pimComponentBSRAddress         IpAddress,
  914.     pimComponentBSRExpiryTime      TimeTicks,
  915.     pimComponentCRPHoldTime        Integer32,
  916.     pimComponentStatus             RowStatus
  917. }
  918.  
  919. pimComponentIndex OBJECT-TYPE
  920.     SYNTAX     Integer32
  921.     MAX-ACCESS not-accessible
  922.     STATUS     current
  923.     DESCRIPTION
  924.             "A number uniquely identifying the component.  Each protocol
  925.             instance connected to a separate domain should have a
  926.             different index value."
  927.     ::= { pimComponentEntry 1 }
  928.  
  929. pimComponentBSRAddress OBJECT-TYPE
  930.     SYNTAX     IpAddress
  931.     MAX-ACCESS read-only
  932.     STATUS     current
  933.     DESCRIPTION
  934.             "The IP address of the bootstrap router (BSR) for the local
  935.  
  936.  
  937.  
  938.  
  939.  
  940. Expires September 1997                                         [Page 16]
  941.  
  942.  
  943.  
  944.  
  945.  
  946. Draft                           PIM MIB                       March 1997
  947.  
  948.  
  949.             PIM region."
  950.     ::= { pimComponentEntry 2 }
  951.  
  952. pimComponentBSRExpiryTime OBJECT-TYPE
  953.     SYNTAX     TimeTicks
  954.     MAX-ACCESS read-only
  955.     STATUS     current
  956.     DESCRIPTION
  957.             "The minimum time remaining before the bootstrap router in
  958.             the local domain will be declared down.  For candidate BSRs,
  959.             this is the time until the component sends an RP-Set
  960.             message.  For other routers, this is the time until it may
  961.             accept an RP-Set message from a lower candidate BSR."
  962.     ::= { pimComponentEntry 3 }
  963.  
  964. pimComponentCRPHoldTime OBJECT-TYPE
  965.     SYNTAX     Integer32 (0..255)
  966.     UNITS      "seconds"
  967.     MAX-ACCESS read-create
  968.     STATUS     current
  969.     DESCRIPTION
  970.             "The holdtime of the component when it is a candidate RP in
  971.             the local domain.  The value of 0 is used to indicate that
  972.             the local system is not a Candidate-RP."
  973.     DEFVAL     { 0 }
  974.     ::= { pimComponentEntry 4 }
  975.  
  976. pimComponentStatus OBJECT-TYPE
  977.     SYNTAX     RowStatus
  978.     MAX-ACCESS read-create
  979.     STATUS     current
  980.     DESCRIPTION
  981.             "The status of this entry.  Creating the entry creates
  982.             another protocol instance; destroying the entry disables a
  983.             protocol instance."
  984.     ::= { pimComponentEntry 5 }
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999. Expires September 1997                                         [Page 17]
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005. Draft                           PIM MIB                       March 1997
  1006.  
  1007.  
  1008. -- conformance information
  1009.  
  1010. pimMIBConformance OBJECT IDENTIFIER ::= { pimMIB 2 }
  1011. pimMIBCompliances OBJECT IDENTIFIER ::= { pimMIBConformance 1 }
  1012. pimMIBGroups      OBJECT IDENTIFIER ::= { pimMIBConformance 2 }
  1013.  
  1014.  
  1015. -- compliance statements
  1016.  
  1017. pimV1MIBCompliance MODULE-COMPLIANCE
  1018.     STATUS  deprecated
  1019.     DESCRIPTION
  1020.             "The compliance statement for routers running PIMv1 and
  1021.             implementing the PIM MIB."
  1022.     MODULE  -- this module
  1023.         MANDATORY-GROUPS { pimV1MIBGroup }
  1024.  
  1025.     ::= { pimMIBCompliances 1 }
  1026.  
  1027. pimSparseV2MIBCompliance MODULE-COMPLIANCE
  1028.     STATUS  current
  1029.     DESCRIPTION
  1030.             "The compliance statement for routers running PIM Sparse
  1031.             Mode and implementing the PIM MIB."
  1032.     MODULE  -- this module
  1033.         MANDATORY-GROUPS { pimV2MIBGroup }
  1034.  
  1035.     OBJECT     pimInterfaceStatus
  1036.     MIN-ACCESS read-only
  1037.     DESCRIPTION
  1038.              "Write access is not required."
  1039.  
  1040.     ::= { pimMIBCompliances 2 }
  1041.  
  1042. pimDenseV2MIBCompliance MODULE-COMPLIANCE
  1043.     STATUS  current
  1044.     DESCRIPTION
  1045.             "The compliance statement for routers running PIM Dense Mode
  1046.             and implementing the PIM MIB."
  1047.     MODULE  -- this module
  1048.         MANDATORY-GROUPS { pimDenseV2MIBGroup }
  1049.  
  1050.     OBJECT     pimInterfaceStatus
  1051.     MIN-ACCESS read-only
  1052.     DESCRIPTION
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058. Expires September 1997                                         [Page 18]
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064. Draft                           PIM MIB                       March 1997
  1065.  
  1066.  
  1067.              "Write access is not required."
  1068.  
  1069.     ::= { pimMIBCompliances 3 }
  1070.  
  1071.  
  1072. -- units of conformance
  1073.  
  1074. pimV2MIBGroup OBJECT-GROUP
  1075.     OBJECTS { pimJoinPruneInterval, pimNeighborIfIndex,
  1076.               pimNeighborUpTime, pimNeighborExpiryTime,
  1077.               pimInterfaceAddress, pimInterfaceNetMask,
  1078.               pimInterfaceDR, pimInterfaceHelloInterval,
  1079.               pimInterfaceStatus, pimInterfaceJoinPruneInterval,
  1080.               pimInterfaceCBSRPreference,
  1081.               pimRPSetHoldTime, pimRPSetExpiryTime,
  1082.               pimComponentBSRAddress, pimComponentBSRExpiryTime,
  1083.               pimComponentCRPHoldTime, pimComponentStatus
  1084.             }
  1085.     STATUS  current
  1086.     DESCRIPTION
  1087.             "A collection of objects to support management of PIM Sparse
  1088.             Mode (version 2) routers."
  1089.     ::= { pimMIBGroups 2 }
  1090.  
  1091. pimDenseV2MIBGroup OBJECT-GROUP
  1092.     OBJECTS { pimNeighborIfIndex,
  1093.               pimNeighborUpTime, pimNeighborExpiryTime,
  1094.               pimInterfaceAddress, pimInterfaceNetMask,
  1095.               pimInterfaceDR, pimInterfaceHelloInterval,
  1096.               pimInterfaceStatus
  1097.             }
  1098.     STATUS  current
  1099.     DESCRIPTION
  1100.             "A collection of objects to support management of PIM Dense
  1101.             Mode (version 2) routers."
  1102.     ::= { pimMIBGroups 5 }
  1103.  
  1104. pimV2CandidateRPMIBGroup OBJECT-GROUP
  1105.     OBJECTS { pimCandidateRPAddress,
  1106.               pimCandidateRPRowStatus
  1107.             }
  1108.     STATUS  current
  1109.     DESCRIPTION
  1110.             "A collection of objects to support configuration of which
  1111.             groups a router is to advertise itself as a Candidate-RP."
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117. Expires September 1997                                         [Page 19]
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123. Draft                           PIM MIB                       March 1997
  1124.  
  1125.  
  1126.     ::= { pimMIBGroups 3 }
  1127.  
  1128. pimV1MIBGroup OBJECT-GROUP
  1129.     OBJECTS { pimJoinPruneInterval, pimNeighborIfIndex,
  1130.               pimNeighborUpTime, pimNeighborExpiryTime,
  1131.               pimNeighborMode,
  1132.               pimInterfaceAddress, pimInterfaceNetMask,
  1133.               pimInterfaceMode, pimInterfaceDR,
  1134.               pimInterfaceHelloInterval,
  1135.               pimRPState, pimRPStateTimer,
  1136.               pimRPLastChange, pimRPRowStatus
  1137.             }
  1138.     STATUS  deprecated
  1139.     DESCRIPTION
  1140.             "A collection of objects to support management of PIM
  1141.             (version 1) routers."
  1142.     ::= { pimMIBGroups 4 }
  1143.  
  1144. END
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176. Expires September 1997                                         [Page 20]
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182. Draft                           PIM MIB                       March 1997
  1183.  
  1184.  
  1185. 6.  Acknowledgements
  1186.  
  1187. This MIB module has been updated based on feedback from the IETF's
  1188. Inter-Domain Multicast Routing (IDMR) Working Group.
  1189.  
  1190.  
  1191.  
  1192. 7.  References
  1193.  
  1194. [1]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  1195.      S. Waldbusser, "Structure of Management Information for version 2
  1196.      of the Simple Network Management Protocol (SNMPv2)", RFC 1902,
  1197.      January 1996.
  1198.  
  1199. [2]  McCloghrie, K., and M. Rose, Editors, "Management Information Base
  1200.      for Network Management of TCP/IP-based internets: MIB-II", STD 17,
  1201.      RFC 1213, March 1991.
  1202.  
  1203. [3]  Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple Network
  1204.      Management Protocol", RFC 1157, May 1990.
  1205.  
  1206. [4]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  1207.      S. Waldbusser, "Protocol Operations for version 2 of the Simple
  1208.      Network Management Protocol (SNMPv2)", RFC 1905, January 1996.
  1209.  
  1210. [5]  Deering, S., Estrin, D., Farinacci, D., Jacobson, V., Liu, G., and
  1211.      L. Wei, "Protocol Independent Multicast (PIM): Motivation and
  1212.      Architecture", January 1995.
  1213.  
  1214. [6]  Deering, S., Estrin, D., Farinacci, D., Jacobson, V., Liu, G., and
  1215.      L. Wei, "Protocol Independent Multicast (PIM): Protocol
  1216.      Specification", January 1995.
  1217.  
  1218. [7]  Estrin, D., Farinacci, D., Helmy, A., Thaler, D., Deering, S.,
  1219.      Handley, M., Jacobson, V., Liu, C., Sharma, P., and L. Wei,
  1220.      "Protocol Independent Multicast - Sparse Mode (PIM-SM): Protocol
  1221.      Specification", November 1996.
  1222.  
  1223. [8]  Estrin, D., Farinacci, D., Jacobson, V., Liu, C., Wei, L., Sharma,
  1224.      P, and Helmy, A., "Protocol Independent Multicast-Dense Mode (PIM-
  1225.      DM): Protocol Specification", January 1996.
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235. Expires September 1997                                         [Page 21]
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241. Draft                           PIM MIB                       March 1997
  1242.  
  1243.  
  1244. 8.  Security Considerations
  1245.  
  1246. Security issues are not discussed in this memo.
  1247.  
  1248.  
  1249.  
  1250. 9.  Author's Address
  1251.  
  1252.      Keith McCloghrie
  1253.      cisco Systems, Inc.
  1254.      170 West Tasman Drive
  1255.      San Jose, CA  95134-1706
  1256.      Phone: +1 408 526 5260
  1257.      EMail: kzm@cisco.com
  1258.  
  1259.      Dino Farinacci
  1260.      cisco Systems, Inc.
  1261.      170 West Tasman Drive
  1262.      San Jose, CA  95134-1706
  1263.      Phone: +1 408 526 4696
  1264.      EMail: dino@cisco.com
  1265.  
  1266.      Dave Thaler
  1267.      Department of Electrical Engineering and Computer Science
  1268.      University of Michigan
  1269.      1301 Beal Ave.
  1270.      Ann Arbor, MI 48109-2122
  1271.      Phone: +1 313 763 5243
  1272.      EMail: thalerd@eecs.umich.edu
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294. Expires September 1997                                         [Page 22]
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300. Draft                           PIM MIB                       March 1997
  1301.  
  1302.  
  1303. Table of Contents
  1304.  
  1305.  
  1306. 1 Introduction ....................................................    1
  1307. 2 Revision History ................................................    2
  1308. 3 The SNMP Network Management Framework ...........................    3
  1309. 3.1 Object Definitions ............................................    3
  1310. 4 Overview ........................................................    3
  1311. 5 Definitions .....................................................    5
  1312. 6 Acknowledgements ................................................   21
  1313. 7 References ......................................................   21
  1314. 8 Security Considerations .........................................   22
  1315. 9 Author's Address ................................................   22
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353. Expires September 1997                                         [Page 23]
  1354.  
  1355.