1-- ***************************************************************
2-- CISCO-IETF-PIM-MIB.my: MIB module for management of PIM routers
3--
4-- February 2005, Swaroop George
5--
6-- Copyright (c) 2005 by Cisco Systems, Inc.
7-- All rights reserved.
8-- ***************************************************************
9
10CISCO-IETF-PIM-MIB DEFINITIONS ::= BEGIN
11
12IMPORTS
13    MODULE-IDENTITY, OBJECT-TYPE,
14    NOTIFICATION-TYPE,
15    Integer32, TimeTicks,
16    Unsigned32             FROM SNMPv2-SMI
17    RowStatus, TruthValue            FROM SNMPv2-TC
18    MODULE-COMPLIANCE, OBJECT-GROUP,
19    NOTIFICATION-GROUP               FROM SNMPv2-CONF
20    InetAddressType,
21    InetAddressPrefixLength,
22    InetAddress,
23    InetVersion                      FROM INET-ADDRESS-MIB
24    cIpMRouteAddrType,
25    cIpMRouteGroup,
26    cIpMRouteSource,
27    cIpMRouteSourceMask,
28    cIpMRouteNextHopAddrType,
29    cIpMRouteNextHopGroup,
30    cIpMRouteNextHopSource,
31    cIpMRouteNextHopSourceMask,
32    cIpMRouteNextHopIfIndex,
33    cIpMRouteNextHopAddress          FROM CISCO-IETF-IPMROUTE-MIB
34    InterfaceIndex                   FROM IF-MIB
35    ciscoExperiment                  FROM CISCO-SMI;
36
37ciscoIetfPimMIB MODULE-IDENTITY
38    LAST-UPDATED "200502220000Z"
39    ORGANIZATION "Cisco Systems, Inc."
40    CONTACT-INFO
41            "       Cisco Systems
42                    Customer Service
43            Postal: 170 W Tasman Drive
44                    San Jose, CA  95134
45
46            Tel: +1 800 553-NETS
47
48            E-mail: cs-ipmulticast@cisco.com
49           "
50
51    DESCRIPTION
52            "Address family independent MIB module for
53             management of PIM routers.
54
55             This MIB module is based on RFC 2934 with additional
56             MIB objects added to make it address family independent
57             MIB. This Cisco MIB was created due to non availability
58             of RFC or an Internet Draft, which can provide address
59             family independent MIB for management of PIM routers.
60             This MIB may later be deprecated with a stable RFC or an
61             Internet Draft.
62            "
63
64    REVISION "200502220000Z"
65    DESCRIPTION
66            "Initial version of this MIB module"
67    ::= { ciscoExperiment 119 }
68
69--
70-- Top-level structure of the MIB
71--
72
73cPimNotifs     OBJECT IDENTIFIER ::= { ciscoIetfPimMIB 0 }
74cPimMIBObjects OBJECT IDENTIFIER ::= { ciscoIetfPimMIB 1 }
75cPim           OBJECT IDENTIFIER ::= { cPimMIBObjects 1 }
76
77cPimJoinPruneInterval OBJECT-TYPE
78    SYNTAX     Unsigned32 (1..65535)
79    UNITS      "seconds"
80    MAX-ACCESS read-write
81    STATUS     current
82    DESCRIPTION
83            "The default interval at which periodic PIM-SM Join/Prune
84            messages are to be sent."
85    ::= { cPim 1 }
86
87-- The PIM Interface Table
88
89cPimIfTable OBJECT-TYPE
90    SYNTAX     SEQUENCE OF CPimIfEntry
91    MAX-ACCESS not-accessible
92    STATUS     current
93    DESCRIPTION
94            "The (conceptual) table listing the router's PIM interfaces.
95            Along with PIM IGMP or MLD is enabled on all interfaces
96            listed in this table."
97    ::= { cPim 2 }
98
99cPimIfEntry OBJECT-TYPE
100    SYNTAX     CPimIfEntry
101    MAX-ACCESS not-accessible
102    STATUS     current
103    DESCRIPTION
104            "An entry (conceptual row) in the pimIfTable."
105    INDEX      { cPimIfIndex, cPimIfInetVersion }
106    ::= { cPimIfTable 1 }
107
108CPimIfEntry ::= SEQUENCE {
109    cPimIfIndex              InterfaceIndex,
110    cPimIfInetVersion        InetVersion,
111    cPimIfAddressType        InetAddressType,
112    cPimIfAddress            InetAddress,
113    cPimIfNetMask            InetAddressPrefixLength,
114    cPimIfMode               INTEGER,
115    cPimIfDR                 InetAddress,
116    cPimIfHelloInterval      Unsigned32,
117    cPimIfJoinPruneInterval  Unsigned32,
118    cPimIfCBSRPreference     Integer32,
119    cPimIfStatus             RowStatus
120}
121
122cPimIfIndex OBJECT-TYPE
123    SYNTAX     InterfaceIndex
124    MAX-ACCESS not-accessible
125    STATUS     current
126    DESCRIPTION
127            "The ifIndex value of this PIM interface."
128    ::= { cPimIfEntry 1 }
129
130cPimIfInetVersion OBJECT-TYPE
131    SYNTAX     InetVersion
132    MAX-ACCESS not-accessible
133    STATUS     current
134    DESCRIPTION
135        "The Inet version of this row."
136    ::= { cPimIfEntry 2 }
137
138cPimIfAddressType OBJECT-TYPE
139    SYNTAX     InetAddressType
140    MAX-ACCESS read-create
141    STATUS     current
142    DESCRIPTION
143        "This objects identifies type of InetAddress presented
144         in cPimIfAddress and cPimIfDR "
145    ::= { cPimIfEntry 3 }
146
147cPimIfAddress OBJECT-TYPE
148    SYNTAX     InetAddress (SIZE (4|16|20))
149    MAX-ACCESS read-create
150    STATUS     current
151    DESCRIPTION
152            "The Inet address of the PIM interface."
153    ::= { cPimIfEntry 4 }
154
155cPimIfNetMask OBJECT-TYPE
156    SYNTAX     InetAddressPrefixLength
157    MAX-ACCESS read-only
158    STATUS     current
159    DESCRIPTION
160            "The network mask for the IP address of the PIM interface."
161    ::= { cPimIfEntry 5 }
162
163cPimIfMode OBJECT-TYPE
164    SYNTAX     INTEGER {
165                  dense      (1),
166                  sparse     (2),
167                  sparseDense(3)
168               }
169    MAX-ACCESS read-create
170    STATUS     current
171    DESCRIPTION
172            "The configured mode of this PIM interface.  A value of
173             sparseDense is only valid for PIMv1.
174
175             dense (1): indicates interface is running PIM
176                        dense mode
177
178             sparse (2): indicates interface is running PIM
179                         sparse mode.
180
181             sparseDense (3): indicates interface is running both
182                              dense and sparse mode."
183    DEFVAL     { dense }
184    ::= { cPimIfEntry 6 }
185
186cPimIfDR OBJECT-TYPE
187    SYNTAX     InetAddress (SIZE (4|16|20))
188    MAX-ACCESS read-only
189    STATUS     current
190    DESCRIPTION
191            "The Designated Router on this PIM interface.  For point-to-
192            point interfaces, this object has the value 0.0.0.0 or 0::0"
193    ::= { cPimIfEntry 7 }
194
195cPimIfHelloInterval OBJECT-TYPE
196    SYNTAX     Unsigned32 (1..65535)
197    UNITS      "seconds"
198    MAX-ACCESS read-create
199    STATUS     current
200    DESCRIPTION
201            "The frequency at which PIM Hello messages are transmitted
202            on this interface."
203    DEFVAL     { 30 }
204    ::= { cPimIfEntry 8 }
205
206cPimIfJoinPruneInterval OBJECT-TYPE
207    SYNTAX     Unsigned32 (1..65535)
208    UNITS      "seconds"
209    MAX-ACCESS read-create
210    STATUS     current
211    DESCRIPTION
212            "The frequency at which PIM Join/Prune messages are
213            transmitted on this PIM interface.  The default value of
214            this object is the pimJoinPruneInterval."
215    ::= { cPimIfEntry 9 }
216
217cPimIfCBSRPreference OBJECT-TYPE
218    SYNTAX     Integer32 (-1..255)
219    MAX-ACCESS read-create
220    STATUS     current
221    DESCRIPTION
222            "The preference value for the local interface as a candidate
223            bootstrap router.  The value of -1 is used to indicate that
224            the local interface is not a candidate BSR interface."
225    DEFVAL     { 0 }
226    ::= { cPimIfEntry 10 }
227
228cPimIfStatus OBJECT-TYPE
229    SYNTAX     RowStatus
230    MAX-ACCESS read-create
231    STATUS     current
232    DESCRIPTION
233            "The status of this entry.  Creating the entry enables PIM
234            on the interface; destroying the entry disables PIM on the
235            interface."
236    ::= { cPimIfEntry 11 }
237
238
239-- The PIM Neighbor Table
240
241cPimNbrTable OBJECT-TYPE
242    SYNTAX     SEQUENCE OF CPimNbrEntry
243    MAX-ACCESS not-accessible
244    STATUS     current
245    DESCRIPTION
246            "The (conceptual) table listing the router's PIM neighbors."
247    ::= { cPim 3 }
248
249cPimNbrEntry OBJECT-TYPE
250    SYNTAX     CPimNbrEntry
251    MAX-ACCESS not-accessible
252    STATUS     current
253    DESCRIPTION
254            "An entry (conceptual row) in the pimNbrTable."
255    INDEX      { cPimNbrIfIndex, cPimNbrAddressType, cPimNbrAddress }
256    ::= { cPimNbrTable 1 }
257
258CPimNbrEntry ::= SEQUENCE {
259    cPimNbrIfIndex      InterfaceIndex,
260    cPimNbrAddressType  InetAddressType,
261    cPimNbrAddress      InetAddress,
262    cPimNbrUpTime       TimeTicks,
263    cPimNbrExpiryTime   TimeTicks
264}
265
266cPimNbrIfIndex OBJECT-TYPE
267    SYNTAX     InterfaceIndex
268    MAX-ACCESS not-accessible
269    STATUS     current
270    DESCRIPTION
271            "The value of ifIndex for the interface used to reach this
272            PIM neighbor."
273    ::= { cPimNbrEntry 1 }
274
275cPimNbrAddressType OBJECT-TYPE
276    SYNTAX     InetAddressType
277    MAX-ACCESS not-accessible
278    STATUS     current
279    DESCRIPTION
280            "This objects identifies type of InetAddress presented
281             in cPimNbrAddress."
282    ::= { cPimNbrEntry 2 }
283
284cPimNbrAddress OBJECT-TYPE
285    SYNTAX     InetAddress (SIZE (4|16|20))
286    MAX-ACCESS not-accessible
287    STATUS     current
288    DESCRIPTION
289            "The IP address of the PIM neighbor for which this entry
290            contains information."
291    ::= { cPimNbrEntry 3 }
292
293cPimNbrUpTime OBJECT-TYPE
294    SYNTAX     TimeTicks
295    MAX-ACCESS read-only
296    STATUS     current
297    DESCRIPTION
298            "The time since this PIM neighbor (last) became a neighbor
299            of the local router."
300    ::= { cPimNbrEntry 4}
301
302cPimNbrExpiryTime OBJECT-TYPE
303    SYNTAX     TimeTicks
304    MAX-ACCESS read-only
305    STATUS     current
306    DESCRIPTION
307            "The minimum time remaining before this PIM neighbor will be
308            aged out."
309    ::= { cPimNbrEntry 5 }
310
311--
312-- The PIM IP Multicast Route Table
313--
314
315cPimInetMRouteTable OBJECT-TYPE
316    SYNTAX     SEQUENCE OF CPimInetMRouteEntry
317    MAX-ACCESS not-accessible
318    STATUS     current
319    DESCRIPTION
320            "The (conceptual) table listing PIM-specific information on
321            a subset of the rows of the cIpMRouteTable defined in the IP
322            Multicast MIB."
323    ::= { cPim 4 }
324
325cPimInetMRouteEntry OBJECT-TYPE
326    SYNTAX     CPimInetMRouteEntry
327    MAX-ACCESS not-accessible
328    STATUS     current
329    DESCRIPTION
330            "An entry (conceptual row) in the cPimInetMRouteTable. There
331            is one entry per entry in the cIpMRouteTable whose incoming
332            interface is running PIM."
333    INDEX      { cIpMRouteAddrType, cIpMRouteGroup,
334                 cIpMRouteSource, cIpMRouteSourceMask }
335    ::= { cPimInetMRouteTable 1 }
336
337CPimInetMRouteEntry ::= SEQUENCE {
338    cPimInetMRouteUpstreamAssertTime    TimeTicks,
339    cPimInetMRouteAssertMetric          Unsigned32,
340    cPimInetMRouteAssertMetricPref      Unsigned32,
341    cPimInetMRouteAssertRPTBit          TruthValue,
342    cPimInetMRouteFlags                 BITS
343}
344
345cPimInetMRouteUpstreamAssertTime OBJECT-TYPE
346    SYNTAX     TimeTicks
347    MAX-ACCESS read-only
348    STATUS     current
349    DESCRIPTION
350            "The time remaining before the router changes its upstream
351            neighbor back to its RPF neighbor.  This timer is called the
352            Assert timer in the PIM Sparse and Dense mode specification.
353
354            A value of 0 indicates that no Assert has changed the
355            upstream neighbor away from the RPF neighbor."
356    ::= { cPimInetMRouteEntry 1 }
357
358cPimInetMRouteAssertMetric OBJECT-TYPE
359    SYNTAX     Unsigned32 (0..65535)
360    MAX-ACCESS read-only
361    STATUS     current
362    DESCRIPTION
363            "The metric advertised by the assert winner on the upstream
364            interface, or 0 if no such assert is in received."
365    ::= { cPimInetMRouteEntry 2 }
366
367cPimInetMRouteAssertMetricPref OBJECT-TYPE
368    SYNTAX     Unsigned32 (0..65535)
369    MAX-ACCESS read-only
370    STATUS     current
371    DESCRIPTION
372            "The preference advertised by the assert winner on the
373            upstream interface, or 0 if no such assert is in effect."
374    ::= { cPimInetMRouteEntry 3 }
375
376cPimInetMRouteAssertRPTBit OBJECT-TYPE
377    SYNTAX     TruthValue
378    MAX-ACCESS read-only
379    STATUS     current
380    DESCRIPTION
381            "The value of the RPT-bit advertised by the assert winner on
382            the upstream interface, or false if no such assert is in
383            effect."
384    ::= { cPimInetMRouteEntry 4 }
385
386cPimInetMRouteFlags OBJECT-TYPE
387    SYNTAX     BITS {
388                  rpt(0),
389                  spt(1)
390               }
391    MAX-ACCESS read-only
392    STATUS     current
393    DESCRIPTION
394            "This object describes PIM-specific flags related to a
395            multicast state entry.
396
397            rpt (0): indicates the route is a shared-tree or RP-tree
398                     route.
399
400            spt (1): indicates the route is a shortest-path-tree
401                     route."
402    ::= { cPimInetMRouteEntry 5 }
403
404--
405-- The PIM Next Hop Table
406--
407
408cPimInetMRouteNextHopTable OBJECT-TYPE
409    SYNTAX     SEQUENCE OF CPimInetMRouteNextHopEntry
410    MAX-ACCESS not-accessible
411    STATUS     current
412    DESCRIPTION
413            "The (conceptual) table listing PIM-specific information on
414            a subset of the rows of the cIpMRouteNextHopTable defined in
415            the IP Multicast MIB."
416    ::= { cPim 5 }
417
418cPimInetMRouteNextHopEntry OBJECT-TYPE
419    SYNTAX     CPimInetMRouteNextHopEntry
420    MAX-ACCESS not-accessible
421    STATUS     current
422    DESCRIPTION
423           "An entry (conceptual row) in the cPimInetMRouteNextHopTable.
424            There is one entry per entry in the cIpMRouteNextHopTable
425            whose interface is running PIM and whose
426            cIpMRouteNextHopState is pruned(1)."
427    INDEX      { cIpMRouteNextHopAddrType, cIpMRouteNextHopGroup,
428                 cIpMRouteNextHopSource, cIpMRouteNextHopSourceMask,
429                 cIpMRouteNextHopIfIndex, cIpMRouteNextHopAddress }
430    ::= { cPimInetMRouteNextHopTable 1 }
431
432CPimInetMRouteNextHopEntry ::= SEQUENCE {
433    cPimInetMRouteNextHopPruneReason       INTEGER
434}
435
436cPimInetMRouteNextHopPruneReason OBJECT-TYPE
437    SYNTAX     INTEGER {
438                  other  (1),
439                  prune  (2),
440                  assert (3)
441               }
442    MAX-ACCESS read-only
443    STATUS     current
444    DESCRIPTION
445            "This object indicates the reason why downstream interface
446             was pruned,
447
448             prune (1): indicates downstream interface was pruned in
449                        response to a PIM prune message.
450
451             assert (3): indicates downstream interface was pruned due
452                         to PIM assert processing."
453    ::= { cPimInetMRouteNextHopEntry 2 }
454
455
456-- The PIM RP-Map Table
457
458cPimRPMapTable OBJECT-TYPE
459    SYNTAX     SEQUENCE OF CPimRPMapEntry
460    MAX-ACCESS not-accessible
461    STATUS     current
462    DESCRIPTION
463            "The (conceptual) table listing PIM information for
464            candidate Rendezvous Points (RPs) for IP multicast groups.
465            When the local router is the BSR, this information is
466            obtained from received Candidate-RP-Advertisements.  When
467            the local router is not the BSR, this information is
468            obtained from received RP-Set messages."
469    ::= { cPim 6 }
470
471cPimRPMapEntry OBJECT-TYPE
472    SYNTAX     CPimRPMapEntry
473    MAX-ACCESS not-accessible
474    STATUS     current
475    DESCRIPTION
476            "An entry (conceptual row) in the pimRPsTable."
477    INDEX      { cPimRPMapComponent,
478                 cPimRPMapAddrType, cPimRPMapGroupAddress,
479                 cPimRPMapGroupMask, cPimRPMapAddress }
480    ::= { cPimRPMapTable 1 }
481
482CPimRPMapEntry ::= SEQUENCE {
483    cPimRPMapComponent      Unsigned32,
484    cPimRPMapAddrType       InetAddressType,
485    cPimRPMapGroupAddress   InetAddress,
486    cPimRPMapGroupMask      InetAddressPrefixLength,
487    cPimRPMapAddress        InetAddress,
488    cPimRPMapHoldTime       Unsigned32,
489    cPimRPMapExpiryTime     TimeTicks
490}
491
492cPimRPMapComponent OBJECT-TYPE
493    SYNTAX     Unsigned32 (1..255)
494    MAX-ACCESS not-accessible
495    STATUS     current
496    DESCRIPTION
497            " A number uniquely identifying the component.  Each
498            protocol instance connected to a separate domain should have
499            a different index value."
500    ::= { cPimRPMapEntry 1 }
501
502cPimRPMapAddrType OBJECT-TYPE
503    SYNTAX     InetAddressType
504    MAX-ACCESS not-accessible
505    STATUS     current
506    DESCRIPTION
507            "Type of Inet address presented in this row. This
508             includes cPimRPMapGroupAddress and cPimRPMapAddress"
509    ::= { cPimRPMapEntry 2 }
510
511cPimRPMapGroupAddress OBJECT-TYPE
512    SYNTAX     InetAddress (SIZE (4|16|20))
513    MAX-ACCESS not-accessible
514    STATUS     current
515    DESCRIPTION
516            "The IP multicast group address which, when combined with
517            pimRPsGroupMask, gives the group prefix for which this
518            entry contains information about the Candidate-RP."
519    ::= { cPimRPMapEntry 3 }
520
521cPimRPMapGroupMask OBJECT-TYPE
522    SYNTAX     InetAddressPrefixLength
523    MAX-ACCESS not-accessible
524    STATUS     current
525    DESCRIPTION
526            "The multicast group address mask which, when combined with
527            pimRPsGroupAddress, gives the group prefix for which this
528            entry contains information about the Candidate-RP."
529    ::= { cPimRPMapEntry 4 }
530
531cPimRPMapAddress OBJECT-TYPE
532    SYNTAX     InetAddress (SIZE (4|16|20))
533    MAX-ACCESS not-accessible
534    STATUS     current
535    DESCRIPTION
536            "The IP address of the Candidate-RP."
537    ::= { cPimRPMapEntry 5 }
538
539cPimRPMapHoldTime OBJECT-TYPE
540    SYNTAX     Unsigned32 (0..255)
541    UNITS      "seconds"
542    MAX-ACCESS read-only
543    STATUS     current
544    DESCRIPTION
545            "The holdtime of a Candidate-RP.  If the local router is not
546            the BSR, this value is 0."
547    ::= { cPimRPMapEntry 6 }
548
549cPimRPMapExpiryTime OBJECT-TYPE
550    SYNTAX     TimeTicks
551    MAX-ACCESS read-only
552    STATUS     current
553    DESCRIPTION
554            "The minimum time remaining before the Candidate-RP will be
555            declared down.  If the local router is not the BSR, this
556            value is 0."
557    ::= { cPimRPMapEntry 7 }
558
559-- The PIM Candidate-RP Table
560
561cPimCRPTable OBJECT-TYPE
562    SYNTAX     SEQUENCE OF CPimCRPEntry
563    MAX-ACCESS not-accessible
564    STATUS     current
565    DESCRIPTION
566            "The (conceptual) table listing the IP multicast groups for
567            which the local router is to advertise itself as a
568            Candidate-RP when the value of cPimComponentCRPHoldTime is
569            non-zero.  If this table is empty, then the local router
570            will advertise itself as a Candidate-RP for all groups
571            (providing the value of cPimComponentCRPHoldTime is non-
572            zero)."
573    ::= { cPim 7 }
574
575cPimCRPEntry OBJECT-TYPE
576    SYNTAX     CPimCRPEntry
577    MAX-ACCESS not-accessible
578    STATUS     current
579    DESCRIPTION
580            "An entry (conceptual row) in the cPimCRPTable."
581    INDEX      { cPimCRPAddrType,
582                 cPimCRPGroupAddress,
583                 cPimCRPGroupMask }
584    ::= { cPimCRPTable 1 }
585
586CPimCRPEntry ::= SEQUENCE {
587    cPimCRPAddrType        InetAddressType,
588    cPimCRPGroupAddress    InetAddress,
589    cPimCRPGroupMask       InetAddressPrefixLength,
590    cPimCRPAddress         InetAddress,
591    cPimCRPRowStatus       RowStatus
592}
593
594cPimCRPAddrType OBJECT-TYPE
595    SYNTAX     InetAddressType
596    MAX-ACCESS not-accessible
597    STATUS     current
598    DESCRIPTION
599            "Type of Inet address presented in this row. This
600             includes cPimCRPGroupAddress and cPimCRPAddress"
601    ::= { cPimCRPEntry 1 }
602
603cPimCRPGroupAddress OBJECT-TYPE
604    SYNTAX     InetAddress (SIZE (4|16|20))
605    MAX-ACCESS not-accessible
606    STATUS     current
607    DESCRIPTION
608            "The IP multicast group address which, when combined with
609            cPimCRPGroupMask, identifies a group prefix for which
610            the local router will advertise itself as a Candidate-RP."
611    ::= { cPimCRPEntry 2 }
612
613cPimCRPGroupMask OBJECT-TYPE
614    SYNTAX     InetAddressPrefixLength
615    MAX-ACCESS not-accessible
616    STATUS     current
617    DESCRIPTION
618            "The multicast group address mask which, when combined with
619            cPimCRPGroupMask, identifies a group prefix for which
620            the local router will advertise itself as a Candidate-RP."
621    ::= { cPimCRPEntry 3 }
622
623cPimCRPAddress OBJECT-TYPE
624    SYNTAX     InetAddress (SIZE (4|16|20))
625    MAX-ACCESS read-create
626    STATUS     current
627    DESCRIPTION
628            "The (unicast) address of the interface which will be
629            advertised as a Candidate-RP."
630    ::= { cPimCRPEntry 4 }
631
632cPimCRPRowStatus OBJECT-TYPE
633    SYNTAX     RowStatus
634    MAX-ACCESS read-create
635    STATUS     current
636    DESCRIPTION
637            "The status of this row, by which new entries may be
638            created, or old entries deleted from this table."
639    ::= { cPimCRPEntry 5 }
640
641-- The PIM Component Table
642
643cPimComponentTable OBJECT-TYPE
644    SYNTAX     SEQUENCE OF CPimComponentEntry
645    MAX-ACCESS not-accessible
646    STATUS     current
647    DESCRIPTION
648            "The (conceptual) table containing objects specific to a PIM
649            domain.  One row exists for each domain to which the router
650            is connected.  A PIM-SM domain is defined as an area of the
651            network over which Bootstrap messages are forwarded.
652            Typically, a PIM-SM router will be a member of exactly one
653            domain.  This table also supports, however, routers which
654            may form a border between two PIM-SM domains and do not
655            forward Bootstrap messages between them."
656    ::= { cPim 8 }
657
658cPimComponentEntry OBJECT-TYPE
659    SYNTAX     CPimComponentEntry
660    MAX-ACCESS not-accessible
661    STATUS     current
662    DESCRIPTION
663            "An entry (conceptual row) in the cPimComponentTable."
664    INDEX      { cPimComponentIndex }
665    ::= { cPimComponentTable 1 }
666
667CPimComponentEntry ::= SEQUENCE {
668    cPimComponentIndex              Unsigned32,
669    cPimComponentBSRAddrType        InetAddressType,
670    cPimComponentBSRAddress         InetAddress,
671    cPimComponentBSRExpiryTime      TimeTicks,
672    cPimComponentCRPHoldTime        Unsigned32,
673    cPimComponentStatus             RowStatus
674}
675
676cPimComponentIndex OBJECT-TYPE
677    SYNTAX     Unsigned32 (1..255)
678    MAX-ACCESS not-accessible
679    STATUS     current
680    DESCRIPTION
681            "A number uniquely identifying the component.  Each protocol
682            instance connected to a separate domain should have a
683            different index value.  Routers that only support membership
684            in a single PIM-SM domain should use a cPimComponentIndex
685            value of 1."
686    ::= { cPimComponentEntry 1 }
687
688cPimComponentBSRAddrType OBJECT-TYPE
689    SYNTAX     InetAddressType
690    MAX-ACCESS read-create
691    STATUS     current
692    DESCRIPTION
693            "Type of Inet address presented in cPimComponentBSRAddress."
694    ::= { cPimComponentEntry 2 }
695
696cPimComponentBSRAddress OBJECT-TYPE
697    SYNTAX     InetAddress (SIZE (4|16|20))
698    MAX-ACCESS read-create
699    STATUS     current
700    DESCRIPTION
701            "The IP address of the bootstrap router (BSR) for the local
702            PIM region."
703    ::= { cPimComponentEntry 3 }
704
705cPimComponentBSRExpiryTime OBJECT-TYPE
706    SYNTAX     TimeTicks
707    MAX-ACCESS read-create
708    STATUS     current
709    DESCRIPTION
710            "The minimum time remaining before the bootstrap router in
711            the local domain will be declared down.  For candidate BSRs,
712            this is the time until the component sends an RP-Set
713            message.  For other routers, this is the time until it may
714            accept an RP-Set message from a lower candidate BSR."
715    ::= { cPimComponentEntry 4 }
716
717cPimComponentCRPHoldTime OBJECT-TYPE
718    SYNTAX     Unsigned32 (0..255)
719    UNITS      "seconds"
720    MAX-ACCESS read-create
721    STATUS     current
722    DESCRIPTION
723            "The holdtime of the component when it is a candidate RP in
724            the local domain.  The value of 0 is used to indicate that
725            the local system is not a Candidate-RP."
726    DEFVAL     { 0 }
727    ::= { cPimComponentEntry 5 }
728
729cPimComponentStatus OBJECT-TYPE
730    SYNTAX     RowStatus
731    MAX-ACCESS read-create
732    STATUS     current
733    DESCRIPTION
734           "The status of this entry.  Creating the entry creates
735            another protocol instance; destroying the entry disables a
736            protocol instance."
737    ::= { cPimComponentEntry 6 }
738
739
740-- PIM Traps
741
742cPimNbrLoss NOTIFICATION-TYPE
743    OBJECTS {
744       cPimNbrUpTime
745    }
746    STATUS      current
747    DESCRIPTION
748            "A cPimNbrLoss trap signifies the loss of an adjacency
749            with a neighbor.  This trap should be generated when the
750            neighbor timer expires, and the router has no other
751            neighbors on the same interface with a lower IP address than
752            itself."
753    ::= { cPimNotifs 2 }
754
755-- conformance information
756
757cPimMIBConformance OBJECT IDENTIFIER ::= { ciscoIetfPimMIB 2 }
758cPimMIBCompliances OBJECT IDENTIFIER ::= { cPimMIBConformance 1 }
759cPimMIBGroups      OBJECT IDENTIFIER ::= { cPimMIBConformance 2 }
760
761
762-- compliance statements
763
764cPimSparseV2MIBCompliance MODULE-COMPLIANCE
765    STATUS  current
766    DESCRIPTION
767            "The compliance statement for routers running PIM Sparse
768            Mode and implementing the PIM MIB."
769    MODULE  -- this module
770    MANDATORY-GROUPS { cPimV2MIBGroup }
771
772    GROUP      cPimV2CRPMIBGroup
773
774    DESCRIPTION
775            "This group is mandatory if the router is capable of being a
776            Candidate RP."
777
778    OBJECT     cPimIfStatus
779    MIN-ACCESS read-only
780    DESCRIPTION
781             "Write access is not required."
782
783    ::= { cPimMIBCompliances 1 }
784
785cPimDenseV2MIBCompliance MODULE-COMPLIANCE
786    STATUS  current
787    DESCRIPTION
788            "The compliance statement for routers running PIM Dense Mode
789            and implementing the PIM MIB."
790    MODULE  -- this module
791
792        MANDATORY-GROUPS { cPimDenseV2MIBGroup }
793
794    OBJECT     cPimIfStatus
795    MIN-ACCESS read-only
796    DESCRIPTION
797             "Write access is not required."
798
799    ::= { cPimMIBCompliances 2 }
800
801-- units of conformance
802
803cPimNotificationGroup NOTIFICATION-GROUP
804    NOTIFICATIONS { cPimNbrLoss }
805    STATUS  current
806    DESCRIPTION
807            "A collection of notifications for signaling important PIM
808            events."
809    ::= { cPimMIBGroups 1 }
810
811cPimV2MIBGroup OBJECT-GROUP
812    OBJECTS { cPimJoinPruneInterval,
813              cPimNbrUpTime, cPimNbrExpiryTime,
814              cPimIfAddressType,
815              cPimIfAddress, cPimIfNetMask,
816              cPimIfDR, cPimIfHelloInterval,
817              cPimIfStatus, cPimIfJoinPruneInterval,
818              cPimIfCBSRPreference, cPimIfMode,
819              cPimRPMapHoldTime, cPimRPMapExpiryTime,
820              cPimComponentBSRAddrType,
821              cPimComponentBSRAddress, cPimComponentBSRExpiryTime,
822              cPimComponentCRPHoldTime, cPimComponentStatus,
823              cPimInetMRouteFlags, cPimInetMRouteUpstreamAssertTime
824            }
825    STATUS  current
826    DESCRIPTION
827            "A collection of objects to support management of PIM Sparse
828            Mode (version 2) routers."
829    ::= { cPimMIBGroups 2 }
830
831cPimDenseV2MIBGroup OBJECT-GROUP
832    OBJECTS { cPimNbrUpTime, cPimNbrExpiryTime,
833              cPimIfAddress, cPimIfNetMask,
834              cPimIfDR, cPimIfHelloInterval,
835              cPimIfStatus, cPimIfMode
836            }
837    STATUS  current
838    DESCRIPTION
839            "A collection of objects to support management of PIM Dense
840            Mode (version 2) routers."
841    ::= { cPimMIBGroups 3 }
842
843cPimV2CRPMIBGroup OBJECT-GROUP
844    OBJECTS { cPimCRPAddress,
845              cPimCRPRowStatus
846            }
847    STATUS  current
848    DESCRIPTION
849            "A collection of objects to support configuration of which
850            groups a router is to advertise itself as a Candidate-RP."
851    ::= { cPimMIBGroups 4 }
852
853cPimNextHopGroup OBJECT-GROUP
854
855    OBJECTS { cPimInetMRouteNextHopPruneReason }
856    STATUS  current
857    DESCRIPTION
858            "A collection of optional objects to provide per-next hop
859            information for diagnostic purposes.  Supporting this group
860            may add a large number of instances to a tree walk, but the
861            information in this group can be extremely useful in
862            tracking down multicast connectivity problems."
863    ::= { cPimMIBGroups 5 }
864
865cPimAssertGroup OBJECT-GROUP
866    OBJECTS { cPimInetMRouteAssertMetric,
867              cPimInetMRouteAssertMetricPref,
868              cPimInetMRouteAssertRPTBit }
869    STATUS  current
870    DESCRIPTION
871            "A collection of optional objects to provide extra
872            information about the assert election process.  There is no
873            protocol reason to keep such information, but some
874            implementations may already keep this information and make
875            it available.  These objects can also be very useful in
876            debugging connectivity or duplicate packet problems,
877            especially if the assert winner does not support the PIM and
878            IP Multicast MIBs."
879    ::= { cPimMIBGroups 6 }
880
881END
882