1 HOST-RESOURCES-MIB DEFINITIONS ::= BEGIN
4 MODULE-IDENTITY, OBJECT-TYPE, mib-2,
5 Integer32, Counter32, Gauge32, TimeTicks FROM SNMPv2-SMI
7 TEXTUAL-CONVENTION, DisplayString,
8 TruthValue, DateAndTime, AutonomousType FROM SNMPv2-TC
10 MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF
12 InterfaceIndexOrZero FROM IF-MIB;
14 hostResourcesMibModule MODULE-IDENTITY
15 LAST-UPDATED "200003060000Z" -- 6 March 2000
16 ORGANIZATION "IETF Host Resources MIB Working Group"
19 Postal: Lucent Technologies, Inc.
25 Email: waldbusser@lucent.com
27 In addition, the Host Resources MIB mailing list is
28 dedicated to discussion of this MIB. To join the
29 mailing list, send a request message to
30 hostmib-request@andrew.cmu.edu. The mailing list
31 address is hostmib@andrew.cmu.edu."
33 "This MIB is for use in managing host systems. The term
34 `host' is construed to mean any computer that communicates
35 with other similar computers attached to the internet and
36 that is directly used by one or more human beings. Although
37 this MIB does not necessarily apply to devices whose primary
38 function is communications services (e.g., terminal servers,
39 routers, bridges, monitoring equipment), such relevance is
40 not explicitly precluded. This MIB instruments attributes
41 common to all internet hosts including, for example, both
42 personal computers and systems that run variants of Unix."
44 REVISION "200003060000Z" -- 6 March 2000
46 "Clarifications and bug fixes based on implementation
47 experience. This revision was also reformatted in the SMIv2
48 format. The revisions made were:
50 New RFC document standards:
51 Added Copyright notice, updated introduction to SNMP
52 Framework, updated references section, added reference to
53 RFC 2119, and added a meaningful Security Considerations
56 New IANA considerations section for registration of new types
58 Conversion to new SMIv2 syntax for the following types and
60 Counter32, Integer32, Gauge32, MODULE-IDENTITY,
61 OBJECT-TYPE, TEXTUAL-CONVENTION, OBJECT-IDENTITY,
62 MODULE-COMPLIANCE, OBJECT-GROUP
64 Used new Textual Conventions:
65 TruthValue, DateAndTime, AutonomousType,
68 Fixed typo in hrPrinterStatus.
70 Added missing error bits to hrPrinterDetectedErrorState and
71 clarified confusion resulting from suggested mappings to
74 Clarified that size of objects of type
75 InternationalDisplayString is number of octets, not number
78 Clarified the use of the following objects based on
79 implementation experience:
80 hrSystemInitialLoadDevice, hrSystemInitialLoadParameters,
81 hrMemorySize, hrStorageSize, hrStorageAllocationFailures,
82 hrDeviceErrors, hrProcessorLoad, hrNetworkIfIndex,
83 hrDiskStorageCapacity, hrSWRunStatus, hrSWRunPerfCPU,
84 and hrSWInstalledDate.
86 Clarified implementation technique for hrSWInstalledTable.
88 Used new AUGMENTS clause for hrSWRunPerfTable.
90 Added Internationalization Considerations section.
92 This revision published as RFC2790."
94 REVISION "9910202200Z" -- 20 October, 1999
96 "The original version of this MIB, published as
98 ::= { hrMIBAdminInfo 1 }
100 host OBJECT IDENTIFIER ::= { mib-2 25 }
102 hrSystem OBJECT IDENTIFIER ::= { host 1 }
103 hrStorage OBJECT IDENTIFIER ::= { host 2 }
104 hrDevice OBJECT IDENTIFIER ::= { host 3 }
105 hrSWRun OBJECT IDENTIFIER ::= { host 4 }
106 hrSWRunPerf OBJECT IDENTIFIER ::= { host 5 }
107 hrSWInstalled OBJECT IDENTIFIER ::= { host 6 }
108 hrMIBAdminInfo OBJECT IDENTIFIER ::= { host 7 }
110 -- textual conventions
112 KBytes ::= TEXTUAL-CONVENTION
115 "Storage size, expressed in units of 1024 bytes."
116 SYNTAX Integer32 (0..2147483647)
118 ProductID ::= TEXTUAL-CONVENTION
121 "This textual convention is intended to identify the
123 manufacturer, model, and version of a specific
124 hardware or software product. It is suggested that
125 these OBJECT IDENTIFIERs are allocated such that all
126 products from a particular manufacturer are registered
127 under a subtree distinct to that manufacturer. In
128 addition, all versions of a product should be
129 registered under a subtree distinct to that product.
130 With this strategy, a management station may uniquely
131 determine the manufacturer and/or model of a product
132 whose productID is unknown to the management station.
133 Objects of this type may be useful for inventory
134 purposes or for automatically detecting
135 incompatibilities or version mismatches between
136 various hardware and software components on a system.
138 For example, the product ID for the ACME 4860 66MHz
139 clock doubled processor might be:
140 enterprises.acme.acmeProcessors.a4860DX2.MHz66
142 A software product might be registered as:
143 enterprises.acme.acmeOperatingSystems.acmeDOS.six(6).one(1)
145 SYNTAX OBJECT IDENTIFIER
147 -- unknownProduct will be used for any unknown ProductID
148 -- unknownProduct OBJECT IDENTIFIER ::= { 0 0 }
150 InternationalDisplayString ::= TEXTUAL-CONVENTION
153 "This data type is used to model textual information
154 in some character set. A network management station
155 should use a local algorithm to determine which
156 character set is in use and how it should be
157 displayed. Note that this character set may be
158 encoded with more than one octet per symbol, but will
159 most often be NVT ASCII. When a size clause is
160 specified for an object of this type, the size refers
161 to the length in octets, not the number of symbols."
164 -- The Host Resources System Group
166 hrSystemUptime OBJECT-TYPE
171 "The amount of time since this host was last
172 initialized. Note that this is different from
173 sysUpTime in the SNMPv2-MIB [RFC1907] because
174 sysUpTime is the uptime of the network management
175 portion of the system."
178 hrSystemDate OBJECT-TYPE
180 MAX-ACCESS read-write
183 "The host's notion of the local date and time of day."
186 hrSystemInitialLoadDevice OBJECT-TYPE
187 SYNTAX Integer32 (1..2147483647)
188 MAX-ACCESS read-write
191 "The index of the hrDeviceEntry for the device from
192 which this host is configured to load its initial
193 operating system configuration (i.e., which operating
194 system code and/or boot parameters).
196 Note that writing to this object just changes the
197 configuration that will be used the next time the
198 operating system is loaded and does not actually cause
199 the reload to occur."
202 hrSystemInitialLoadParameters OBJECT-TYPE
203 SYNTAX InternationalDisplayString (SIZE (0..128))
204 MAX-ACCESS read-write
207 "This object contains the parameters (e.g. a pathname
208 and parameter) supplied to the load device when
209 requesting the initial operating system configuration
212 Note that writing to this object just changes the
213 configuration that will be used the next time the
214 operating system is loaded and does not actually cause
215 the reload to occur."
218 hrSystemNumUsers OBJECT-TYPE
223 "The number of user sessions for which this host is
224 storing state information. A session is a collection
225 of processes requiring a single act of user
226 authentication and possibly subject to collective job
230 hrSystemProcesses OBJECT-TYPE
235 "The number of process contexts currently loaded or
236 running on this system."
239 hrSystemMaxProcesses OBJECT-TYPE
240 SYNTAX Integer32 (0..2147483647)
244 "The maximum number of process contexts this system
245 can support. If there is no fixed maximum, the value
246 should be zero. On systems that have a fixed maximum,
247 this object can help diagnose failures that occur when
248 this maximum is reached."
251 -- The Host Resources Storage Group
253 -- Registration point for storage types, for use with hrStorageType.
254 -- These are defined in the HOST-RESOURCES-TYPES module.
255 hrStorageTypes OBJECT IDENTIFIER ::= { hrStorage 1 }
257 hrMemorySize OBJECT-TYPE
263 "The amount of physical read-write main memory,
264 typically RAM, contained by the host."
267 hrStorageTable OBJECT-TYPE
268 SYNTAX SEQUENCE OF HrStorageEntry
269 MAX-ACCESS not-accessible
272 "The (conceptual) table of logical storage areas on
275 An entry shall be placed in the storage table for each
276 logical area of storage that is allocated and has
277 fixed resource limits. The amount of storage
278 represented in an entity is the amount actually usable
279 by the requesting entity, and excludes loss due to
280 formatting or file system reference information.
282 These entries are associated with logical storage
283 areas, as might be seen by an application, rather than
284 physical storage entities which are typically seen by
285 an operating system. Storage such as tapes and
286 floppies without file systems on them are typically
287 not allocated in chunks by the operating system to
288 requesting applications, and therefore shouldn't
289 appear in this table. Examples of valid storage for
290 this table include disk partitions, file systems, ram
291 (for some architectures this is further segmented into
292 regular memory, extended memory, and so on), backing
293 store for virtual memory (`swap space').
295 This table is intended to be a useful diagnostic for
296 `out of memory' and `out of buffers' types of
297 failures. In addition, it can be a useful performance
298 monitoring tool for tracking memory, disk, or buffer
302 hrStorageEntry OBJECT-TYPE
303 SYNTAX HrStorageEntry
304 MAX-ACCESS not-accessible
307 "A (conceptual) entry for one logical storage area on
308 the host. As an example, an instance of the
309 hrStorageType object might be named hrStorageType.3"
310 INDEX { hrStorageIndex }
311 ::= { hrStorageTable 1 }
313 HrStorageEntry ::= SEQUENCE {
314 hrStorageIndex Integer32,
315 hrStorageType AutonomousType,
316 hrStorageDescr DisplayString,
317 hrStorageAllocationUnits Integer32,
318 hrStorageSize Integer32,
319 hrStorageUsed Integer32,
320 hrStorageAllocationFailures Counter32
323 hrStorageIndex OBJECT-TYPE
324 SYNTAX Integer32 (1..2147483647)
328 "A unique value for each logical storage area
329 contained by the host."
330 ::= { hrStorageEntry 1 }
332 hrStorageType OBJECT-TYPE
333 SYNTAX AutonomousType
337 "The type of storage represented by this entry."
338 ::= { hrStorageEntry 2 }
340 hrStorageDescr OBJECT-TYPE
345 "A description of the type and instance of the storage
346 described by this entry."
347 ::= { hrStorageEntry 3 }
349 hrStorageAllocationUnits OBJECT-TYPE
350 SYNTAX Integer32 (1..2147483647)
355 "The size, in bytes, of the data objects allocated
356 from this pool. If this entry is monitoring sectors,
357 blocks, buffers, or packets, for example, this number
358 will commonly be greater than one. Otherwise this
359 number will typically be one."
360 ::= { hrStorageEntry 4 }
362 hrStorageSize OBJECT-TYPE
363 SYNTAX Integer32 (0..2147483647)
364 MAX-ACCESS read-write
367 "The size of the storage represented by this entry, in
368 units of hrStorageAllocationUnits. This object is
369 writable to allow remote configuration of the size of
370 the storage area in those cases where such an
371 operation makes sense and is possible on the
372 underlying system. For example, the amount of main
373 memory allocated to a buffer pool might be modified or
374 the amount of disk space allocated to virtual memory
376 ::= { hrStorageEntry 5 }
378 hrStorageUsed OBJECT-TYPE
379 SYNTAX Integer32 (0..2147483647)
383 "The amount of the storage represented by this entry
384 that is allocated, in units of
385 hrStorageAllocationUnits."
386 ::= { hrStorageEntry 6 }
388 hrStorageAllocationFailures OBJECT-TYPE
393 "The number of requests for storage represented by
394 this entry that could not be honored due to not enough
395 storage. It should be noted that as this object has a
396 SYNTAX of Counter32, that it does not have a defined
397 initial value. However, it is recommended that this
398 object be initialized to zero, even though management
399 stations must not depend on such an initialization."
400 ::= { hrStorageEntry 7 }
402 -- The Host Resources Device Group
404 -- The device group is useful for identifying and diagnosing the
405 -- devices on a system. The hrDeviceTable contains common
406 -- information for any type of device. In addition, some devices
407 -- have device-specific tables for more detailed information. More
408 -- such tables may be defined in the future for other device types.
410 -- Registration point for device types, for use with hrDeviceType.
412 -- These are defined in the HOST-RESOURCES-TYPES module.
413 hrDeviceTypes OBJECT IDENTIFIER ::= { hrDevice 1 }
415 hrDeviceTable OBJECT-TYPE
416 SYNTAX SEQUENCE OF HrDeviceEntry
417 MAX-ACCESS not-accessible
420 "The (conceptual) table of devices contained by the
424 hrDeviceEntry OBJECT-TYPE
426 MAX-ACCESS not-accessible
429 "A (conceptual) entry for one device contained by the
430 host. As an example, an instance of the hrDeviceType
431 object might be named hrDeviceType.3"
432 INDEX { hrDeviceIndex }
433 ::= { hrDeviceTable 1 }
435 HrDeviceEntry ::= SEQUENCE {
436 hrDeviceIndex Integer32,
437 hrDeviceType AutonomousType,
438 hrDeviceDescr DisplayString,
439 hrDeviceID ProductID,
440 hrDeviceStatus INTEGER,
441 hrDeviceErrors Counter32
444 hrDeviceIndex OBJECT-TYPE
445 SYNTAX Integer32 (1..2147483647)
449 "A unique value for each device contained by the host.
450 The value for each device must remain constant at
451 least from one re-initialization of the agent to the
452 next re-initialization."
453 ::= { hrDeviceEntry 1 }
455 hrDeviceType OBJECT-TYPE
456 SYNTAX AutonomousType
460 "An indication of the type of device.
463 `hrDeviceProcessor { hrDeviceTypes 3 }' then an entry
464 exists in the hrProcessorTable which corresponds to
468 `hrDeviceNetwork { hrDeviceTypes 4 }', then an entry
469 exists in the hrNetworkTable which corresponds to this
473 `hrDevicePrinter { hrDeviceTypes 5 }', then an entry
474 exists in the hrPrinterTable which corresponds to this
478 `hrDeviceDiskStorage { hrDeviceTypes 6 }', then an
479 entry exists in the hrDiskStorageTable which
480 corresponds to this device."
481 ::= { hrDeviceEntry 2 }
483 hrDeviceDescr OBJECT-TYPE
484 SYNTAX DisplayString (SIZE (0..64))
488 "A textual description of this device, including the
489 device's manufacturer and revision, and optionally,
491 ::= { hrDeviceEntry 3 }
493 hrDeviceID OBJECT-TYPE
498 "The product ID for this device."
499 ::= { hrDeviceEntry 4 }
501 hrDeviceStatus OBJECT-TYPE
513 "The current operational state of the device described
514 by this row of the table. A value unknown(1)
515 indicates that the current state of the device is
516 unknown. running(2) indicates that the device is up
517 and running and that no unusual error conditions are
518 known. The warning(3) state indicates that agent has
519 been informed of an unusual error condition by the
520 operational software (e.g., a disk device driver) but
521 that the device is still 'operational'. An example
522 would be a high number of soft errors on a disk. A
523 value of testing(4), indicates that the device is not
524 available for use because it is in the testing state.
525 The state of down(5) is used only when the agent has
526 been informed that the device is not available for any
528 ::= { hrDeviceEntry 5 }
530 hrDeviceErrors OBJECT-TYPE
535 "The number of errors detected on this device. It
536 should be noted that as this object has a SYNTAX of
537 Counter32, that it does not have a defined initial
538 value. However, it is recommended that this object be
539 initialized to zero, even though management stations
540 must not depend on such an initialization."
541 ::= { hrDeviceEntry 6 }
543 hrProcessorTable OBJECT-TYPE
544 SYNTAX SEQUENCE OF HrProcessorEntry
545 MAX-ACCESS not-accessible
548 "The (conceptual) table of processors contained by the
551 Note that this table is potentially sparse: a
552 (conceptual) entry exists only if the correspondent
553 value of the hrDeviceType object is
554 `hrDeviceProcessor'."
557 hrProcessorEntry OBJECT-TYPE
558 SYNTAX HrProcessorEntry
559 MAX-ACCESS not-accessible
562 "A (conceptual) entry for one processor contained by
563 the host. The hrDeviceIndex in the index represents
564 the entry in the hrDeviceTable that corresponds to the
567 As an example of how objects in this table are named,
568 an instance of the hrProcessorFrwID object might be
569 named hrProcessorFrwID.3"
570 INDEX { hrDeviceIndex }
571 ::= { hrProcessorTable 1 }
573 HrProcessorEntry ::= SEQUENCE {
574 hrProcessorFrwID ProductID,
575 hrProcessorLoad Integer32
578 hrProcessorFrwID OBJECT-TYPE
583 "The product ID of the firmware associated with the
585 ::= { hrProcessorEntry 1 }
587 hrProcessorLoad OBJECT-TYPE
588 SYNTAX Integer32 (0..100)
592 "The average, over the last minute, of the percentage
593 of time that this processor was not idle.
594 Implementations may approximate this one minute
595 smoothing period if necessary."
596 ::= { hrProcessorEntry 2 }
598 hrNetworkTable OBJECT-TYPE
599 SYNTAX SEQUENCE OF HrNetworkEntry
600 MAX-ACCESS not-accessible
603 "The (conceptual) table of network devices contained
606 Note that this table is potentially sparse: a
607 (conceptual) entry exists only if the correspondent
608 value of the hrDeviceType object is
612 hrNetworkEntry OBJECT-TYPE
613 SYNTAX HrNetworkEntry
614 MAX-ACCESS not-accessible
617 "A (conceptual) entry for one network device contained
618 by the host. The hrDeviceIndex in the index
619 represents the entry in the hrDeviceTable that
620 corresponds to the hrNetworkEntry.
622 As an example of how objects in this table are named,
623 an instance of the hrNetworkIfIndex object might be
624 named hrNetworkIfIndex.3"
625 INDEX { hrDeviceIndex }
626 ::= { hrNetworkTable 1 }
628 HrNetworkEntry ::= SEQUENCE {
629 hrNetworkIfIndex InterfaceIndexOrZero
632 hrNetworkIfIndex OBJECT-TYPE
633 SYNTAX InterfaceIndexOrZero
637 "The value of ifIndex which corresponds to this
638 network device. If this device is not represented in
639 the ifTable, then this value shall be zero."
640 ::= { hrNetworkEntry 1 }
642 hrPrinterTable OBJECT-TYPE
643 SYNTAX SEQUENCE OF HrPrinterEntry
644 MAX-ACCESS not-accessible
647 "The (conceptual) table of printers local to the host.
649 Note that this table is potentially sparse: a
650 (conceptual) entry exists only if the correspondent
651 value of the hrDeviceType object is
655 hrPrinterEntry OBJECT-TYPE
656 SYNTAX HrPrinterEntry
657 MAX-ACCESS not-accessible
660 "A (conceptual) entry for one printer local to the
661 host. The hrDeviceIndex in the index represents the
662 entry in the hrDeviceTable that corresponds to the
665 As an example of how objects in this table are named,
666 an instance of the hrPrinterStatus object might be
667 named hrPrinterStatus.3"
668 INDEX { hrDeviceIndex }
669 ::= { hrPrinterTable 1 }
671 HrPrinterEntry ::= SEQUENCE {
672 hrPrinterStatus INTEGER,
673 hrPrinterDetectedErrorState OCTET STRING
676 hrPrinterStatus OBJECT-TYPE
687 "The current status of this printer device."
688 ::= { hrPrinterEntry 1 }
690 hrPrinterDetectedErrorState OBJECT-TYPE
695 "This object represents any error conditions detected
696 by the printer. The error conditions are encoded as
697 bits in an octet string, with the following
713 markerSupplyMissing 10
717 overduePreventMaint 14
719 Bits are numbered starting with the most significant
720 bit of the first byte being bit 0, the least
721 significant bit of the first byte being bit 7, the
722 most significant bit of the second byte being bit 8,
723 and so on. A one bit encodes that the condition was
724 detected, while a zero bit encodes that the condition
727 This object is useful for alerting an operator to
728 specific warning or error conditions that may occur,
729 especially those requiring human intervention."
730 ::= { hrPrinterEntry 2 }
732 hrDiskStorageTable OBJECT-TYPE
733 SYNTAX SEQUENCE OF HrDiskStorageEntry
734 MAX-ACCESS not-accessible
737 "The (conceptual) table of long-term storage devices
738 contained by the host. In particular, disk devices
739 accessed remotely over a network are not included
742 Note that this table is potentially sparse: a
743 (conceptual) entry exists only if the correspondent
744 value of the hrDeviceType object is
745 `hrDeviceDiskStorage'."
748 hrDiskStorageEntry OBJECT-TYPE
749 SYNTAX HrDiskStorageEntry
750 MAX-ACCESS not-accessible
753 "A (conceptual) entry for one long-term storage device
754 contained by the host. The hrDeviceIndex in the index
755 represents the entry in the hrDeviceTable that
756 corresponds to the hrDiskStorageEntry. As an example,
757 an instance of the hrDiskStorageCapacity object might
758 be named hrDiskStorageCapacity.3"
759 INDEX { hrDeviceIndex }
760 ::= { hrDiskStorageTable 1 }
762 HrDiskStorageEntry ::= SEQUENCE {
763 hrDiskStorageAccess INTEGER,
764 hrDiskStorageMedia INTEGER,
765 hrDiskStorageRemoveble TruthValue,
766 hrDiskStorageCapacity KBytes
769 hrDiskStorageAccess OBJECT-TYPE
777 "An indication if this long-term storage device is
778 readable and writable or only readable. This should
779 reflect the media type, any write-protect mechanism,
780 and any device configuration that affects the entire
782 ::= { hrDiskStorageEntry 1 }
784 hrDiskStorageMedia OBJECT-TYPE
791 opticalDiskWORM(6), -- Write Once Read Many
798 "An indication of the type of media used in this long-
799 term storage device."
800 ::= { hrDiskStorageEntry 2 }
802 hrDiskStorageRemoveble OBJECT-TYPE
807 "Denotes whether or not the disk media may be removed
809 ::= { hrDiskStorageEntry 3 }
811 hrDiskStorageCapacity OBJECT-TYPE
817 "The total size for this long-term storage device. If
818 the media is removable and is currently removed, this
819 value should be zero."
820 ::= { hrDiskStorageEntry 4 }
822 hrPartitionTable OBJECT-TYPE
823 SYNTAX SEQUENCE OF HrPartitionEntry
824 MAX-ACCESS not-accessible
827 "The (conceptual) table of partitions for long-term
828 storage devices contained by the host. In particular,
829 partitions accessed remotely over a network are not
833 hrPartitionEntry OBJECT-TYPE
834 SYNTAX HrPartitionEntry
835 MAX-ACCESS not-accessible
838 "A (conceptual) entry for one partition. The
839 hrDeviceIndex in the index represents the entry in the
840 hrDeviceTable that corresponds to the
843 As an example of how objects in this table are named,
844 an instance of the hrPartitionSize object might be
845 named hrPartitionSize.3.1"
846 INDEX { hrDeviceIndex, hrPartitionIndex }
847 ::= { hrPartitionTable 1 }
849 HrPartitionEntry ::= SEQUENCE {
850 hrPartitionIndex Integer32,
851 hrPartitionLabel InternationalDisplayString,
852 hrPartitionID OCTET STRING,
853 hrPartitionSize KBytes,
854 hrPartitionFSIndex Integer32
857 hrPartitionIndex OBJECT-TYPE
858 SYNTAX Integer32 (1..2147483647)
862 "A unique value for each partition on this long-term
863 storage device. The value for each long-term storage
864 device must remain constant at least from one re-
865 initialization of the agent to the next re-
867 ::= { hrPartitionEntry 1 }
869 hrPartitionLabel OBJECT-TYPE
870 SYNTAX InternationalDisplayString (SIZE (0..128))
874 "A textual description of this partition."
875 ::= { hrPartitionEntry 2 }
877 hrPartitionID OBJECT-TYPE
882 "A descriptor which uniquely represents this partition
883 to the responsible operating system. On some systems,
884 this might take on a binary representation."
885 ::= { hrPartitionEntry 3 }
887 hrPartitionSize OBJECT-TYPE
893 "The size of this partition."
894 ::= { hrPartitionEntry 4 }
896 hrPartitionFSIndex OBJECT-TYPE
897 SYNTAX Integer32 (0..2147483647)
901 "The index of the file system mounted on this
902 partition. If no file system is mounted on this
903 partition, then this value shall be zero. Note that
904 multiple partitions may point to one file system,
905 denoting that that file system resides on those
906 partitions. Multiple file systems may not reside on
908 ::= { hrPartitionEntry 5 }
910 -- The File System Table
912 -- Registration point for popular File System types,
913 -- for use with hrFSType. These are defined in the
914 -- HOST-RESOURCES-TYPES module.
915 hrFSTypes OBJECT IDENTIFIER ::= { hrDevice 9 }
917 hrFSTable OBJECT-TYPE
918 SYNTAX SEQUENCE OF HrFSEntry
919 MAX-ACCESS not-accessible
922 "The (conceptual) table of file systems local to this
923 host or remotely mounted from a file server. File
924 systems that are in only one user's environment on a
925 multi-user system will not be included in this table."
928 hrFSEntry OBJECT-TYPE
930 MAX-ACCESS not-accessible
933 "A (conceptual) entry for one file system local to
934 this host or remotely mounted from a file server.
935 File systems that are in only one user's environment
936 on a multi-user system will not be included in this
939 As an example of how objects in this table are named,
940 an instance of the hrFSMountPoint object might be
941 named hrFSMountPoint.3"
945 HrFSEntry ::= SEQUENCE {
947 hrFSMountPoint InternationalDisplayString,
948 hrFSRemoteMountPoint InternationalDisplayString,
949 hrFSType AutonomousType,
951 hrFSBootable TruthValue,
952 hrFSStorageIndex Integer32,
953 hrFSLastFullBackupDate DateAndTime,
954 hrFSLastPartialBackupDate DateAndTime
957 hrFSIndex OBJECT-TYPE
958 SYNTAX Integer32 (1..2147483647)
962 "A unique value for each file system local to this
963 host. The value for each file system must remain
964 constant at least from one re-initialization of the
965 agent to the next re-initialization."
968 hrFSMountPoint OBJECT-TYPE
969 SYNTAX InternationalDisplayString (SIZE(0..128))
973 "The path name of the root of this file system."
976 hrFSRemoteMountPoint OBJECT-TYPE
977 SYNTAX InternationalDisplayString (SIZE(0..128))
981 "A description of the name and/or address of the
982 server that this file system is mounted from. This
983 may also include parameters such as the mount point on
984 the remote file system. If this is not a remote file
985 system, this string should have a length of zero."
989 SYNTAX AutonomousType
993 "The value of this object identifies the type of this
997 hrFSAccess OBJECT-TYPE
1002 MAX-ACCESS read-only
1005 "An indication if this file system is logically
1006 configured by the operating system to be readable and
1007 writable or only readable. This does not represent
1008 any local access-control policy, except one that is
1009 applied to the file system as a whole."
1012 hrFSBootable OBJECT-TYPE
1014 MAX-ACCESS read-only
1017 "A flag indicating whether this file system is
1021 hrFSStorageIndex OBJECT-TYPE
1022 SYNTAX Integer32 (0..2147483647)
1023 MAX-ACCESS read-only
1026 "The index of the hrStorageEntry that represents
1027 information about this file system. If there is no
1028 such information available, then this value shall be
1029 zero. The relevant storage entry will be useful in
1030 tracking the percent usage of this file system and
1031 diagnosing errors that may occur when it runs out of
1035 hrFSLastFullBackupDate OBJECT-TYPE
1037 MAX-ACCESS read-write
1040 "The last date at which this complete file system was
1042 copied to another storage device for backup. This
1043 information is useful for ensuring that backups are
1044 being performed regularly.
1046 If this information is not known, then this variable
1047 shall have the value corresponding to January 1, year
1048 0000, 00:00:00.0, which is encoded as
1049 (hex)'00 00 01 01 00 00 00 00'."
1052 hrFSLastPartialBackupDate OBJECT-TYPE
1054 MAX-ACCESS read-write
1057 "The last date at which a portion of this file system
1058 was copied to another storage device for backup. This
1059 information is useful for ensuring that backups are
1060 being performed regularly.
1062 If this information is not known, then this variable
1063 shall have the value corresponding to January 1, year
1064 0000, 00:00:00.0, which is encoded as
1065 (hex)'00 00 01 01 00 00 00 00'."
1068 -- The Host Resources Running Software Group
1070 -- The hrSWRunTable contains an entry for each distinct piece of
1071 -- software that is running or loaded into physical or virtual
1072 -- memory in preparation for running. This includes the host's
1073 -- operating system, device drivers, and applications.
1075 hrSWOSIndex OBJECT-TYPE
1076 SYNTAX Integer32 (1..2147483647)
1077 MAX-ACCESS read-only
1080 "The value of the hrSWRunIndex for the hrSWRunEntry
1081 that represents the primary operating system running
1082 on this host. This object is useful for quickly and
1083 uniquely identifying that primary operating system."
1086 hrSWRunTable OBJECT-TYPE
1087 SYNTAX SEQUENCE OF HrSWRunEntry
1088 MAX-ACCESS not-accessible
1091 "The (conceptual) table of software running on the
1095 hrSWRunEntry OBJECT-TYPE
1097 MAX-ACCESS not-accessible
1100 "A (conceptual) entry for one piece of software
1101 running on the host Note that because the installed
1102 software table only contains information for software
1103 stored locally on this host, not every piece of
1104 running software will be found in the installed
1105 software table. This is true of software that was
1106 loaded and run from a non-local source, such as a
1107 network-mounted file system.
1109 As an example of how objects in this table are named,
1110 an instance of the hrSWRunName object might be named
1112 INDEX { hrSWRunIndex }
1113 ::= { hrSWRunTable 1 }
1115 HrSWRunEntry ::= SEQUENCE {
1116 hrSWRunIndex Integer32,
1117 hrSWRunName InternationalDisplayString,
1118 hrSWRunID ProductID,
1119 hrSWRunPath InternationalDisplayString,
1120 hrSWRunParameters InternationalDisplayString,
1121 hrSWRunType INTEGER,
1122 hrSWRunStatus INTEGER
1125 hrSWRunIndex OBJECT-TYPE
1126 SYNTAX Integer32 (1..2147483647)
1127 MAX-ACCESS read-only
1130 "A unique value for each piece of software running on
1131 the host. Wherever possible, this should be the
1132 system's native, unique identification number."
1133 ::= { hrSWRunEntry 1 }
1135 hrSWRunName OBJECT-TYPE
1136 SYNTAX InternationalDisplayString (SIZE (0..64))
1137 MAX-ACCESS read-only
1140 "A textual description of this running piece of
1141 software, including the manufacturer, revision, and
1142 the name by which it is commonly known. If this
1143 software was installed locally, this should be the
1144 same string as used in the corresponding
1146 ::= { hrSWRunEntry 2 }
1148 hrSWRunID OBJECT-TYPE
1150 MAX-ACCESS read-only
1153 "The product ID of this running piece of software."
1154 ::= { hrSWRunEntry 3 }
1156 hrSWRunPath OBJECT-TYPE
1157 SYNTAX InternationalDisplayString (SIZE(0..128))
1158 MAX-ACCESS read-only
1161 "A description of the location on long-term storage
1162 (e.g. a disk drive) from which this software was
1164 ::= { hrSWRunEntry 4 }
1166 hrSWRunParameters OBJECT-TYPE
1167 SYNTAX InternationalDisplayString (SIZE(0..128))
1168 MAX-ACCESS read-only
1171 "A description of the parameters supplied to this
1172 software when it was initially loaded."
1173 ::= { hrSWRunEntry 5 }
1175 hrSWRunType OBJECT-TYPE
1182 MAX-ACCESS read-only
1185 "The type of this software."
1186 ::= { hrSWRunEntry 6 }
1188 hrSWRunStatus OBJECT-TYPE
1191 runnable(2), -- waiting for resource
1192 -- (i.e., CPU, memory, IO)
1193 notRunnable(3), -- loaded but waiting for event
1194 invalid(4) -- not loaded
1196 MAX-ACCESS read-write
1199 "The status of this running piece of software.
1200 Setting this value to invalid(4) shall cause this
1201 software to stop running and to be unloaded. Sets to
1202 other values are not valid."
1203 ::= { hrSWRunEntry 7 }
1205 -- The Host Resources Running Software Performance Group
1207 -- The hrSWRunPerfTable contains an entry corresponding to
1208 -- each entry in the hrSWRunTable.
1210 hrSWRunPerfTable OBJECT-TYPE
1211 SYNTAX SEQUENCE OF HrSWRunPerfEntry
1212 MAX-ACCESS not-accessible
1215 "The (conceptual) table of running software
1216 performance metrics."
1217 ::= { hrSWRunPerf 1 }
1219 hrSWRunPerfEntry OBJECT-TYPE
1220 SYNTAX HrSWRunPerfEntry
1221 MAX-ACCESS not-accessible
1224 "A (conceptual) entry containing software performance
1225 metrics. As an example, an instance of the
1226 hrSWRunPerfCPU object might be named
1227 hrSWRunPerfCPU.1287"
1228 AUGMENTS { hrSWRunEntry } -- This table augments information in
1229 -- the hrSWRunTable.
1230 ::= { hrSWRunPerfTable 1 }
1232 HrSWRunPerfEntry ::= SEQUENCE {
1233 hrSWRunPerfCPU Integer32,
1234 hrSWRunPerfMem KBytes
1237 hrSWRunPerfCPU OBJECT-TYPE
1238 SYNTAX Integer32 (0..2147483647)
1239 MAX-ACCESS read-only
1242 "The number of centi-seconds of the total system's CPU
1243 resources consumed by this process. Note that on a
1244 multi-processor system, this value may increment by
1245 more than one centi-second in one centi-second of real
1247 ::= { hrSWRunPerfEntry 1 }
1249 hrSWRunPerfMem OBJECT-TYPE
1252 MAX-ACCESS read-only
1255 "The total amount of real system memory allocated to
1257 ::= { hrSWRunPerfEntry 2 }
1259 -- The Host Resources Installed Software Group
1261 -- The hrSWInstalledTable contains an entry for each piece
1262 -- of software installed in long-term storage (e.g. a disk
1263 -- drive) locally on this host. Note that this does not
1264 -- include software loadable remotely from a network
1267 -- Different implementations may track software in varying
1268 -- ways. For example, while some implementations may track
1269 -- executable files as distinct pieces of software, other
1270 -- implementations may use other strategies such as keeping
1271 -- track of software "packages" (e.g., related groups of files)
1272 -- or keeping track of system or application "patches".
1274 -- This table is useful for identifying and inventorying
1275 -- software on a host and for diagnosing incompatibility
1276 -- and version mismatch problems between various pieces
1277 -- of hardware and software.
1279 hrSWInstalledLastChange OBJECT-TYPE
1281 MAX-ACCESS read-only
1284 "The value of sysUpTime when an entry in the
1285 hrSWInstalledTable was last added, renamed, or
1286 deleted. Because this table is likely to contain many
1287 entries, polling of this object allows a management
1288 station to determine when re-downloading of the table
1290 ::= { hrSWInstalled 1 }
1292 hrSWInstalledLastUpdateTime OBJECT-TYPE
1294 MAX-ACCESS read-only
1297 "The value of sysUpTime when the hrSWInstalledTable
1298 was last completely updated. Because caching of this
1299 data will be a popular implementation strategy,
1300 retrieval of this object allows a management station
1301 to obtain a guarantee that no data in this table is
1302 older than the indicated time."
1303 ::= { hrSWInstalled 2 }
1305 hrSWInstalledTable OBJECT-TYPE
1306 SYNTAX SEQUENCE OF HrSWInstalledEntry
1307 MAX-ACCESS not-accessible
1310 "The (conceptual) table of software installed on this
1312 ::= { hrSWInstalled 3 }
1314 hrSWInstalledEntry OBJECT-TYPE
1315 SYNTAX HrSWInstalledEntry
1316 MAX-ACCESS not-accessible
1319 "A (conceptual) entry for a piece of software
1320 installed on this host.
1322 As an example of how objects in this table are named,
1323 an instance of the hrSWInstalledName object might be
1324 named hrSWInstalledName.96"
1325 INDEX { hrSWInstalledIndex }
1326 ::= { hrSWInstalledTable 1 }
1328 HrSWInstalledEntry ::= SEQUENCE {
1329 hrSWInstalledIndex Integer32,
1330 hrSWInstalledName InternationalDisplayString,
1331 hrSWInstalledID ProductID,
1332 hrSWInstalledType INTEGER,
1333 hrSWInstalledDate DateAndTime
1336 hrSWInstalledIndex OBJECT-TYPE
1337 SYNTAX Integer32 (1..2147483647)
1338 MAX-ACCESS read-only
1341 "A unique value for each piece of software installed
1342 on the host. This value shall be in the range from 1
1343 to the number of pieces of software installed on the
1345 ::= { hrSWInstalledEntry 1 }
1347 hrSWInstalledName OBJECT-TYPE
1348 SYNTAX InternationalDisplayString (SIZE (0..64))
1349 MAX-ACCESS read-only
1352 "A textual description of this installed piece of
1353 software, including the manufacturer, revision, the
1354 name by which it is commonly known, and optionally,
1356 ::= { hrSWInstalledEntry 2 }
1358 hrSWInstalledID OBJECT-TYPE
1360 MAX-ACCESS read-only
1363 "The product ID of this installed piece of software."
1364 ::= { hrSWInstalledEntry 3 }
1366 hrSWInstalledType OBJECT-TYPE
1373 MAX-ACCESS read-only
1376 "The type of this software."
1377 ::= { hrSWInstalledEntry 4 }
1379 hrSWInstalledDate OBJECT-TYPE
1381 MAX-ACCESS read-only
1384 "The last-modification date of this application as it
1385 would appear in a directory listing.
1387 If this information is not known, then this variable
1388 shall have the value corresponding to January 1, year
1389 0000, 00:00:00.0, which is encoded as
1390 (hex)'00 00 01 01 00 00 00 00'."
1391 ::= { hrSWInstalledEntry 5 }
1393 -- Conformance information
1395 hrMIBCompliances OBJECT IDENTIFIER ::= { hrMIBAdminInfo 2 }
1396 hrMIBGroups OBJECT IDENTIFIER ::= { hrMIBAdminInfo 3 }
1398 -- Compliance Statements
1399 hrMIBCompliance MODULE-COMPLIANCE
1402 "The requirements for conformance to the Host Resources MIB."
1403 MODULE -- this module
1404 MANDATORY-GROUPS { hrSystemGroup, hrStorageGroup,
1408 MIN-ACCESS read-only
1410 "Write access is not required."
1412 OBJECT hrSystemInitialLoadDevice
1413 MIN-ACCESS read-only
1415 "Write access is not required."
1417 OBJECT hrSystemInitialLoadParameters
1418 MIN-ACCESS read-only
1420 "Write access is not required."
1422 OBJECT hrStorageSize
1423 MIN-ACCESS read-only
1425 "Write access is not required."
1427 OBJECT hrFSLastFullBackupDate
1428 MIN-ACCESS read-only
1430 "Write access is not required."
1432 OBJECT hrFSLastPartialBackupDate
1433 MIN-ACCESS read-only
1435 "Write access is not required."
1439 "The Running Software Group. Implementation
1440 of this group is mandatory only when the
1441 hrSWRunPerfGroup is implemented."
1443 OBJECT hrSWRunStatus
1444 MIN-ACCESS read-only
1446 "Write access is not required."
1448 GROUP hrSWRunPerfGroup
1450 "The Running Software Performance Group.
1451 Implementation of this group is at the discretion
1452 of the implementor."
1454 GROUP hrSWInstalledGroup
1456 "The Installed Software Group.
1457 Implementation of this group is at the discretion
1458 of the implementor."
1459 ::= { hrMIBCompliances 1 }
1461 hrSystemGroup OBJECT-GROUP
1463 hrSystemUptime, hrSystemDate,
1464 hrSystemInitialLoadDevice,
1465 hrSystemInitialLoadParameters,
1466 hrSystemNumUsers, hrSystemProcesses,
1467 hrSystemMaxProcesses
1471 "The Host Resources System Group."
1472 ::= { hrMIBGroups 1 }
1474 hrStorageGroup OBJECT-GROUP
1476 hrMemorySize, hrStorageIndex, hrStorageType,
1477 hrStorageDescr, hrStorageAllocationUnits,
1478 hrStorageSize, hrStorageUsed,
1479 hrStorageAllocationFailures
1483 "The Host Resources Storage Group."
1484 ::= { hrMIBGroups 2 }
1486 hrDeviceGroup OBJECT-GROUP
1488 hrDeviceIndex, hrDeviceType, hrDeviceDescr,
1489 hrDeviceID, hrDeviceStatus, hrDeviceErrors,
1490 hrProcessorFrwID, hrProcessorLoad,
1491 hrNetworkIfIndex, hrPrinterStatus,
1492 hrPrinterDetectedErrorState,
1493 hrDiskStorageAccess, hrDiskStorageMedia,
1494 hrDiskStorageRemoveble, hrDiskStorageCapacity,
1495 hrPartitionIndex, hrPartitionLabel,
1496 hrPartitionID, hrPartitionSize,
1497 hrPartitionFSIndex, hrFSIndex, hrFSMountPoint,
1498 hrFSRemoteMountPoint, hrFSType, hrFSAccess,
1499 hrFSBootable, hrFSStorageIndex,
1500 hrFSLastFullBackupDate,
1501 hrFSLastPartialBackupDate
1505 "The Host Resources Device Group."
1506 ::= { hrMIBGroups 3 }
1508 hrSWRunGroup OBJECT-GROUP
1510 hrSWOSIndex, hrSWRunIndex, hrSWRunName,
1511 hrSWRunID, hrSWRunPath, hrSWRunParameters,
1512 hrSWRunType, hrSWRunStatus
1516 "The Host Resources Running Software Group."
1517 ::= { hrMIBGroups 4 }
1519 hrSWRunPerfGroup OBJECT-GROUP
1520 OBJECTS { hrSWRunPerfCPU, hrSWRunPerfMem }
1523 "The Host Resources Running Software
1525 ::= { hrMIBGroups 5 }
1527 hrSWInstalledGroup OBJECT-GROUP
1529 hrSWInstalledLastChange,
1530 hrSWInstalledLastUpdateTime,
1531 hrSWInstalledIndex, hrSWInstalledName,
1532 hrSWInstalledID, hrSWInstalledType,
1537 "The Host Resources Installed Software Group."
1538 ::= { hrMIBGroups 6 }