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