1-- *****************************************************************
2-- Cisco System MIB
3--
4-- Janurary 1999, Bob Stewart
5-- September 1999, Padma Pullela
6-- March 2001, Thomas Wu
7--
8-- Copyright (c) 1999-2001, 2007 by cisco Systems Inc.
9-- All rights reserved.
10-- ****************************************************************
11
12CISCO-SYSTEM-MIB DEFINITIONS ::= BEGIN
13
14IMPORTS
15    MODULE-IDENTITY,
16    OBJECT-TYPE,
17    NOTIFICATION-TYPE,
18    Counter32,
19    Integer32
20        FROM SNMPv2-SMI
21    MODULE-COMPLIANCE,
22    OBJECT-GROUP,
23    NOTIFICATION-GROUP
24        FROM SNMPv2-CONF
25    DateAndTime,
26    TruthValue,
27    DisplayString
28        FROM SNMPv2-TC
29    InetAddressType,
30    InetAddress
31        FROM INET-ADDRESS-MIB
32    CountryCode
33        FROM CISCO-TC
34    ciscoMgmt
35        FROM CISCO-SMI;
36
37
38ciscoSystemMIB MODULE-IDENTITY
39    LAST-UPDATED    "200709160000Z"
40    ORGANIZATION    "Cisco Systems, Inc."
41    CONTACT-INFO
42            "Cisco Systems
43            Customer Service
44
45            Postal: 170 W Tasman Drive
46            San Jose, CA  95134
47            USA
48
49            Tel: +1 800 553-NETS
50
51            E-mail: cs-snmp@cisco.com"
52    DESCRIPTION
53        "The systemGroup (see RFC 1907) provides a standard set of
54        basic system information.  This MIB module contains
55        Cisco-defined extensions to the systemGroup."
56
57    REVISION    "200709160000Z"
58    DESCRIPTION
59        "Removed default values for csySummerTimeStatus,
60         csySummerTimeOffset, csySummerTimeRecurringStart and
61         csySummerTimeRecurringEnd objects."
62
63    REVISION        "200705290000Z"
64    DESCRIPTION
65        "Added the following new object:
66        - csyStandardTmZnGMTOffset
67        - csySummerTmZnGMTOffset"
68    REVISION        "200106220000Z"
69    DESCRIPTION
70        "Added SNMP authentication failure objects and clock
71        changed notification."
72    REVISION        "200001251700Z"
73    DESCRIPTION
74        "Added Summertime and ScheduledReset objects."
75    REVISION        "9902021700Z"
76    DESCRIPTION
77        "Initial version of this MIB module."
78    ::= { ciscoMgmt 131 }
79
80
81ciscoSystemMIBObjects  OBJECT IDENTIFIER
82    ::= { ciscoSystemMIB 1 }
83
84csyClock  OBJECT IDENTIFIER
85    ::= { ciscoSystemMIBObjects 1 }
86
87csyLocation  OBJECT IDENTIFIER
88    ::= { ciscoSystemMIBObjects 2 }
89
90csySummerTime  OBJECT IDENTIFIER
91    ::= { ciscoSystemMIBObjects 3 }
92
93csyScheduledReset  OBJECT IDENTIFIER
94    ::= { ciscoSystemMIBObjects 4 }
95
96csySnmpAuthentication  OBJECT IDENTIFIER
97    ::= { ciscoSystemMIBObjects 5 }
98
99csyGeneral  OBJECT IDENTIFIER
100    ::= { ciscoSystemMIBObjects 6 }
101
102
103-- Clock Section
104
105csyClockDateAndTime OBJECT-TYPE
106    SYNTAX          DateAndTime
107    MAX-ACCESS      read-write
108    STATUS          current
109    DESCRIPTION
110        "The current local date and time for the system.
111
112        Setting this object is equivalent to setting an automated
113        clock and calendar.  The value of the object will track the
114        date and time from the value set.  Note that due to hardware
115        limitations some systems may not be able to preserve such
116        meaning across reboots of the system, as indicated by
117        csyClockLostOnReboot.
118
119        A constant value of all zeros and length 8 indicates the
120        system is not aware of the present date and time.
121
122        This object may be read-only on some systems."
123    ::= { csyClock 1 }
124
125csyClockLostOnReboot OBJECT-TYPE
126    SYNTAX          TruthValue
127    MAX-ACCESS      read-only
128    STATUS          current
129    DESCRIPTION
130        "Indication of whether the system can preserve knowledge of
131        current date and time across a system reboot.
132
133        A value of 'true' indicates the clock must be reset from some
134        external source each time the system reboots.
135
136        A value of 'false' indicates the system has the ability to
137        keep time across reboots."
138    ::= { csyClock 2 }
139
140-- Location Section
141
142csyLocationCountry OBJECT-TYPE
143    SYNTAX          CountryCode
144    MAX-ACCESS      read-write
145    STATUS          current
146    DESCRIPTION
147        "The country where the system is physically located.
148
149        On some systems and for some technologies this value affects
150        behavior, such as standards for communication.  All such
151        technologies should default to using the setting of this
152        value, but may provide an override if necessary.
153
154        The default value of this object is 'US'.  Systems destined
155        for other countries may use a different default.  Systems in
156        which the value does not affect operation should default to
157        a zero-length value."
158    ::= { csyLocation 1 }
159
160-- Generic Summertime Section
161
162csySummerTimeStatus OBJECT-TYPE
163    SYNTAX          TruthValue
164    MAX-ACCESS      read-write
165    STATUS          current
166    DESCRIPTION
167        "An indication of whether the summertime feature
168        is enabled on this device. When this object
169        is set to true, then csySummerTimeOffset,
170        csySummerTimeRecurringStart and
171        csySummerTimeRecurringEnd  objects are set
172        to default values provided by the system.
173        When this object is set
174        to false, then csySummerTimeOffset,
175        csySummerTimeRecurringStart,
176        csySummerTimeRecurringEnd objects are
177        not instantiated and the summertime feature
178        is disabled."
179    ::= { csySummerTime 1 }
180
181csySummerTimeOffset OBJECT-TYPE
182    SYNTAX          INTEGER (1..1440)
183    UNITS           "Minutes"
184    MAX-ACCESS      read-write
185    STATUS          current
186    DESCRIPTION
187        "The value of this object indicates number of
188        minutes to add  or to subtract during summertime.
189        This object is not instantiated when
190        csySummerTimeStatus object is set to false."
191    ::= { csySummerTime 2 }
192
193csySummerTimeRecurringStart OBJECT-TYPE
194    SYNTAX          OCTET STRING (SIZE  (6))
195    MAX-ACCESS      read-write
196    STATUS          current
197    DESCRIPTION
198        "Indicates summertime starts at this time every year.
199        octets    contents     range
200        1         week        1..5,ff last = ff
201        2-3       day         1..7
202                              where sunday = 1 saturday = 7
203        4         month       1..12
204                              where january = 1 december = 12
205        5         hour        0..23
206        6         min         0..59
207        For example, the first Monday in Feb at 13:30pm
208        should be given as
209            01 00 02 02 0e 1e
210        For the last Tuesday in dec at 1:20am should be
211        given as
212           ff 00 03 0c 01 14
213        This object is not instantiated when
214        csySummerTimeStatus object is set to false."
215    ::= { csySummerTime 3 }
216
217csySummerTimeRecurringEnd OBJECT-TYPE
218    SYNTAX          OCTET STRING (SIZE  (6))
219    MAX-ACCESS      read-write
220    STATUS          current
221    DESCRIPTION
222        "Indicates summertime ends at this time every year.
223        octets    contents      range
224        1         week        1..5,ff where ff = last
225        2-3       day         1..7
226                              where sunday = 1 saturday = 7
227        4         month       1..12
228                              where january = 1 december = 12
229        5         hour        0..23
230        6         min         0..59
231        For example, the third friday in February at 3:30am
232        should be given as
233             03 00 06 02 03 1e
234
235        For the first Tuesday in May at 1:20am  should
236        be given as
237            01 00 03 05 01 14
238        This object is not instantiated when
239        csySummerTimeStatus object is set to false."
240    ::= { csySummerTime 4 }
241
242csyStandardTmZnGMTOffset OBJECT-TYPE
243    SYNTAX          Integer32 (-720..720 )
244    UNITS           "minutes"
245    MAX-ACCESS      read-write
246    STATUS          current
247    DESCRIPTION
248        "This object is  used to set standard timezone offset from GMT
249        in minutes."
250    DEFVAL          { 0 }
251    ::= { csySummerTime 5 }
252
253csySummerTmZnGMTOffset OBJECT-TYPE
254    SYNTAX          Integer32 (-720..720 )
255    UNITS           "minutes"
256    MAX-ACCESS      read-write
257    STATUS          current
258    DESCRIPTION
259        "This object is  used to set summer timezone offset from GMT in
260        minutes."
261    DEFVAL          { 0 }
262    ::= { csySummerTime 6 }
263
264-- Scheduled Reset Section
265
266csyScheduledResetTime OBJECT-TYPE
267    SYNTAX          DateAndTime
268    MAX-ACCESS      read-write
269    STATUS          current
270    DESCRIPTION
271        "The scheduled date and time the switch will be
272        reset at. The system will only take octet strings
273        with length 8 for this object which indicates the
274        local time of the switch. The maximum scheduled
275        time is 24 days from the current system clock time.
276
277        Setting this object value to be before the current
278        system clock time or beyond the maximum scheduled
279        time limit will be rejected by the system. Setting
280        the object to all-zero octet strings will cancel the
281        previously scheduled reset time and then the system
282        will have no pending scheduled reset time. Setting
283        this object value to be any valid octet strings
284        other than the above cases will override the
285        previously scheduled reset time and cause the system
286        to be reset at the newly specified time.
287
288
289        After the system has accepted the scheduled reset
290        time, if the system clock is advanced ahead of the
291        scheduled reset time, then reset will happen
292        approximately 5 minutes after the current clock."
293    ::= { csyScheduledReset 1 }
294
295csyScheduledResetAction OBJECT-TYPE
296    SYNTAX          INTEGER  {
297                        reset(1), -- reset the system,
298                        resetMinDown(2) -- reset in minimal down time
299                    }
300    MAX-ACCESS      read-write
301    STATUS          current
302    DESCRIPTION
303        "Writing reset(1) to this object perform the normal
304        reset operation on the active supervisor module.
305
306        Writing resetMinDown(2) to this object resets the
307        system with the minimal system down time at the
308        scheduled time. The resetMinDown(2) is only
309        supported in systems with redundant supervisors."
310    DEFVAL          { reset }
311    ::= { csyScheduledReset 2 }
312
313csyScheduledResetReason OBJECT-TYPE
314    SYNTAX          DisplayString
315    MAX-ACCESS      read-write
316    STATUS          current
317    DESCRIPTION
318        "Indicates the reason users input when issuing
319        system's scheduled reset.  After the system
320        is reset, this object value  will be empty octet
321        string."
322    ::= { csyScheduledReset 3 }
323
324-- SNMP Authentication Section
325
326csySnmpAuthFail OBJECT-TYPE
327    SYNTAX          Counter32
328    MAX-ACCESS      read-only
329    STATUS          current
330    DESCRIPTION
331        "The total number of SNMP messages received by the SNMP engine
332        that were not properly authenticated."
333    ::= { csySnmpAuthentication 1 }
334
335csySnmpAuthFailAddressType OBJECT-TYPE
336    SYNTAX          InetAddressType
337    MAX-ACCESS      read-only
338    STATUS          current
339    DESCRIPTION
340        "The type of Internet address by which the last received
341        SNMP message that is not properly authenticated.
342
343        The value of this object is irrelevant if the value of
344        csySnmpAuthFail is zero."
345    ::= { csySnmpAuthentication 2 }
346
347csySnmpAuthFailAddress OBJECT-TYPE
348    SYNTAX          InetAddress
349    MAX-ACCESS      read-only
350    STATUS          current
351    DESCRIPTION
352        "The internet address of the SNMP entity which sent the
353        last received SNMP message that is not properly authenticated.
354
355        The value of this object is irrelevant if the value of
356        csySnmpAuthFail is zero."
357    ::= { csySnmpAuthentication 3 }
358
359-- General Section
360
361csyNotificationsEnable OBJECT-TYPE
362    SYNTAX          TruthValue
363    MAX-ACCESS      read-write
364    STATUS          current
365    DESCRIPTION
366        "This object indicates whether the system produces the
367        notifications defined by the ciscoSystemNotificationsGroup.
368        A false value will prevent notifications from being generated
369        by this system."
370    DEFVAL          { false }
371    ::= { csyGeneral 1 }
372-- Notification
373
374ciscoSystemMIBNotificationPrefix  OBJECT IDENTIFIER
375    ::= { ciscoSystemMIB 2 }
376
377ciscoSystemMIBNotifications  OBJECT IDENTIFIER
378    ::= { ciscoSystemMIBNotificationPrefix 0 }
379
380
381ciscoSystemClockChanged NOTIFICATION-TYPE
382    OBJECTS         { csyClockDateAndTime }
383    STATUS          current
384    DESCRIPTION
385        "A clock changed notification is generated when the current
386        local date and time for the system has been manually changed.
387        The value of csyClockDateAndTime reflects new date and time."
388   ::= { ciscoSystemMIBNotifications 1 }
389-- Conformance
390
391ciscoSystemMIBConformance  OBJECT IDENTIFIER
392    ::= { ciscoSystemMIB 3 }
393
394ciscoSystemMIBCompliances  OBJECT IDENTIFIER
395    ::= { ciscoSystemMIBConformance 1 }
396
397ciscoSystemMIBGroups  OBJECT IDENTIFIER
398    ::= { ciscoSystemMIBConformance 2 }
399
400
401-- Compliance
402
403ciscoSystemMIBCompliance MODULE-COMPLIANCE
404    STATUS          deprecated
405    DESCRIPTION
406        "The compliance statement for entities which implement
407        the Cisco System MIB.  Adherence to this compliance
408        statement is expected of all Cisco systems."
409    MODULE          -- this module
410    MANDATORY-GROUPS {
411                        ciscoSystemClockGroup,
412                        ciscoSystemLocationGroup
413                    }
414
415    OBJECT          csyClockDateAndTime
416    MIN-ACCESS      read-only
417    DESCRIPTION
418        "Write access is not implemented on systems that do
419        not allow their clock to be set either because they
420        have a different, more reliable source or because they
421        do not use such information."
422    ::= { ciscoSystemMIBCompliances 1 }
423
424ciscoSystemMIBCompliance2 MODULE-COMPLIANCE
425    STATUS          deprecated
426    DESCRIPTION
427        "The compliance statement for entities which implement
428        the Cisco System MIB.  Adherence to this compliance
429        statement is expected of all Cisco systems."
430    MODULE          -- this module
431    MANDATORY-GROUPS {
432                        ciscoSystemClockGroup,
433                        ciscoSystemLocationGroup
434                    }
435
436    GROUP           ciscoSystemSummerTimeGroup
437    DESCRIPTION
438        "The ciscoSystemSummerTimeGroup is an optional group
439        containing objects providing information about generic
440        Summertime feature."
441
442    GROUP           ciscoSystemScheduledResetGroup
443    DESCRIPTION
444        "The ciscoSystemScheduledResetGroup is an optional group
445        containing objects providing information about system
446        scheduled reset feature."
447
448    OBJECT          csyClockDateAndTime
449    MIN-ACCESS      read-only
450    DESCRIPTION
451        "Write access is not implemented on systems that do
452        not allow their clock to be set either because they
453        have a different, more reliable source or because they
454        do not use such information."
455    ::= { ciscoSystemMIBCompliances 2 }
456
457ciscoSystemMIBCompliance3 MODULE-COMPLIANCE
458    STATUS          deprecated
459    DESCRIPTION
460        "The compliance statement for entities which implement
461        the Cisco System MIB.  Adherence to this compliance
462        statement is expected of all Cisco systems."
463    MODULE          -- this module
464    MANDATORY-GROUPS {
465                        ciscoSystemClockGroup,
466                        ciscoSystemLocationGroup
467                    }
468
469    GROUP           ciscoSystemSummerTimeGroup
470    DESCRIPTION
471        "The ciscoSystemSummerTimeGroup is an optional group
472        containing objects providing information about generic
473        Summertime feature."
474
475    GROUP           ciscoSystemScheduledResetGroup
476    DESCRIPTION
477        "The ciscoSystemScheduledResetGroup is an optional group
478        containing objects providing information about system
479        scheduled reset feature."
480
481    GROUP           ciscoSystemSnmpAuthGroup
482    DESCRIPTION
483        "The ciscoSystemSnmpAuthGroup is an optional group
484        containing objects providing information about SNMP
485        message that is not properly authenticated."
486
487    GROUP           ciscoSystemGeneralGroup
488    DESCRIPTION
489        "The ciscoSystemGeneralGroup is an optional group
490        containing objects providing information about
491        general configuration within this MIB module."
492
493    GROUP           ciscoSystemNotificationsGroup
494    DESCRIPTION
495        "The ciscoSystemNotificationsGroup is an optional
496        group containing a collection of notifications in
497        this MIB module."
498
499    OBJECT          csyClockDateAndTime
500    MIN-ACCESS      read-only
501    DESCRIPTION
502        "Write access is not implemented on systems that do
503        not allow their clock to be set either because they
504        have a different, more reliable source or because they
505        do not use such information."
506
507    OBJECT          csySnmpAuthFailAddressType
508    SYNTAX          INTEGER  {
509                        ipv4(1)
510                    }
511    DESCRIPTION
512        "An implementation is only required to support IPv4
513        addresses."
514
515    OBJECT          csySnmpAuthFailAddress
516    SYNTAX          InetAddress (SIZE (4))
517    DESCRIPTION
518        "An implementation is only required to support IPv4
519        addresses."
520    ::= { ciscoSystemMIBCompliances 3 }
521
522ciscoSystemMIBCompliance4 MODULE-COMPLIANCE
523    STATUS          current
524    DESCRIPTION
525        "The compliance statement for entities which implement
526        the Cisco System MIB.  Adherence to this compliance
527        statement is expected of all Cisco systems."
528    MODULE          -- this module
529    MANDATORY-GROUPS {
530                        ciscoSystemClockGroup,
531                        ciscoSystemLocationGroup
532                    }
533
534    GROUP           ciscoSystemSummerTimeGroupRev1
535    DESCRIPTION
536        "The ciscoSystemSummerTimeGroup is an optional group
537        containing objects providing information about generic
538        Summertime feature."
539
540    GROUP           ciscoSystemScheduledResetGroup
541    DESCRIPTION
542        "The ciscoSystemScheduledResetGroup is an optional group
543        containing objects providing information about system
544        scheduled reset feature."
545
546    GROUP           ciscoSystemSnmpAuthGroup
547    DESCRIPTION
548        "The ciscoSystemSnmpAuthGroup is an optional group
549        containing objects providing information about SNMP
550        message that is not properly authenticated."
551
552    GROUP           ciscoSystemGeneralGroup
553    DESCRIPTION
554        "The ciscoSystemGeneralGroup is an optional group
555        containing objects providing information about
556        general configuration within this MIB module."
557
558    GROUP           ciscoSystemNotificationsGroup
559    DESCRIPTION
560        "The ciscoSystemNotificationsGroup is an optional
561        group containing a collection of notifications in
562        this MIB module."
563
564    OBJECT          csyClockDateAndTime
565    MIN-ACCESS      read-only
566    DESCRIPTION
567        "Write access is not implemented on systems that do
568        not allow their clock to be set either because they
569        have a different, more reliable source or because they
570        do not use such information."
571
572    OBJECT          csySnmpAuthFailAddressType
573    SYNTAX          INTEGER  {
574                        ipv4(1)
575                    }
576    DESCRIPTION
577        "An implementation is only required to support IPv4
578        addresses."
579
580    OBJECT          csySnmpAuthFailAddress
581    SYNTAX          InetAddress (SIZE (4))
582    DESCRIPTION
583        "An implementation is only required to support IPv4
584        addresses."
585    ::= { ciscoSystemMIBCompliances 4 }
586
587-- Units of Conformance
588
589ciscoSystemClockGroup OBJECT-GROUP
590    OBJECTS         {
591                        csyClockDateAndTime,
592                        csyClockLostOnReboot
593                    }
594    STATUS          current
595    DESCRIPTION
596        "Clock attributes."
597    ::= { ciscoSystemMIBGroups 1 }
598
599ciscoSystemLocationGroup OBJECT-GROUP
600    OBJECTS         { csyLocationCountry }
601    STATUS          current
602    DESCRIPTION
603        "Physical location attributes."
604    ::= { ciscoSystemMIBGroups 2 }
605
606ciscoSystemSummerTimeGroup OBJECT-GROUP
607    OBJECTS         {
608                        csySummerTimeStatus,
609                        csySummerTimeOffset,
610                        csySummerTimeRecurringStart,
611                        csySummerTimeRecurringEnd
612                    }
613    STATUS          deprecated
614    DESCRIPTION
615        "A collection of objects used to set Summertime.
616
617        Implementation of this group is optional. If the
618        generic Summertime feature is supported, the entire
619        group should be implemented."
620    ::= { ciscoSystemMIBGroups 3 }
621
622ciscoSystemScheduledResetGroup OBJECT-GROUP
623    OBJECTS         {
624                        csyScheduledResetTime,
625                        csyScheduledResetAction,
626                        csyScheduledResetReason
627                    }
628    STATUS          current
629    DESCRIPTION
630        "A collection of objects used to set scheduled reset time.
631
632        Implementation of this group is optional. If the system
633        scheduled reset feature is supported, the entire group
634        should be implemented."
635    ::= { ciscoSystemMIBGroups 4 }
636
637ciscoSystemSnmpAuthGroup OBJECT-GROUP
638    OBJECTS         {
639                        csySnmpAuthFail,
640                        csySnmpAuthFailAddressType,
641                        csySnmpAuthFailAddress
642                    }
643    STATUS          current
644    DESCRIPTION
645        "A collection of objects which provide information
646        about SNMP message that is not properly authenticated."
647    ::= { ciscoSystemMIBGroups 5 }
648
649ciscoSystemGeneralGroup OBJECT-GROUP
650    OBJECTS         { csyNotificationsEnable }
651    STATUS          current
652    DESCRIPTION
653        "A collection of objects which provide information
654        about general configuration within this MIB module."
655    ::= { ciscoSystemMIBGroups 6 }
656
657ciscoSystemNotificationsGroup NOTIFICATION-GROUP
658   NOTIFICATIONS    { ciscoSystemClockChanged }
659    STATUS          current
660    DESCRIPTION
661        "A collection of notifications in this MIB module."
662    ::= { ciscoSystemMIBGroups 7 }
663
664ciscoSystemSummerTimeGroupRev1 OBJECT-GROUP
665    OBJECTS         {
666                        csySummerTimeStatus,
667                        csySummerTimeOffset,
668                        csySummerTimeRecurringStart,
669                        csySummerTimeRecurringEnd,
670                        csyStandardTmZnGMTOffset,
671                        csySummerTmZnGMTOffset
672                    }
673    STATUS          current
674    DESCRIPTION
675        "A collection of objects used to set Summertime.
676
677        Implementation of this group is optional. If the
678        generic Summertime feature is supported, the entire
679        group should be implemented."
680    ::= { ciscoSystemMIBGroups 8 }
681
682END
683