INTERNET DRAFT Host Resources MIB Jul 92 Host Resources MIB Sat Oct 3 23:09:58 EDT 1992 Pete Grillo Network Innovations pl0143@mail.psi.net Steven Waldbusser Carnegie Mellon University waldbusser@cmu.edu 1. Status of this Memo This memo provides information for the Internet community. It does not specify any standard. Distribution of this memo is unlimited. Please send comments to the authors. This document is an Internet Draft. Internet Drafts are working documents of the Internet Engineering Task Force (IETF), its Areas, and its Working Groups. Note that other groups may also distribute working documents as Internet Drafts. Internet Drafts are draft documents valid for a maximum of six months. Internet Drafts may be updated, replaced, or obsoleted by other documents at any time. It is not appropriate to use Internet Drafts as reference material or to cite them other than as a ``working draft'' or ``work in progress.'' Please check the 1id-abstracts.txt listing contained in the internet-drafts Shadow Directories on nic.ddn.mil, nnsc.nsf.net, nic.nordu.net, ftp.nisc.sri.com, or munnari.oz.au to learn the current status of any Internet Draft. Grillo, Waldbusser Expires April 7, 1993 [Page 1] INTERNET DRAFT Host Resources MIB Jul 92 2. Abstract This memo defines a MIB for use with managing host systems. The term "host" is construed to mean any computer that communicates with other similar computers attached to the internet and that is directly used by one or more human beings. Although this MIB does not necessarily apply to devices whose primary function is communications services (e.g., terminal servers, routers, bridges, monitoring equipment), such relevance is not explicitly precluded. This MIB instruments attributes common to all internet hosts including, for example, both personal computers and systems that run variants of Unix. Grillo, Waldbusser Expires April 7, 1993 [Page 2] INTERNET DRAFT Host Resources MIB Jul 92 3. The Network Management Framework The Internet-standard Network Management Framework consists of three components. They are: RFC 1155[1] which defines the SMI, the mechanisms used for describing and naming objects for the purpose of management. RFC 1212[2] defines a more concise description mechanism, which is wholly consistent with the SMI. RFC 1213[3] which defines MIB-II, the core set of managed objects for the Internet suite of protocols. RFC 1157[4] which defines the SNMP, the protocol used for network access to managed objects. The Framework permits new objects to be defined for the purpose of experimentation and evaluation. Managed objects are accessed via a virtual information store, termed the Management Information Base or MIB. Within a given MIB module, objects are defined using RFC 1212's OBJECT-TYPE macro. At a minimum, each object has a name, a syntax, an access-level, and an implementation-status. The name is an object identifier, an administratively assigned name, which specifies an object type. The object type together with an object instance serves to uniquely identify a specific instantiation of the object. For human convenience, we often use a textual string, termed the object descriptor, to also refer to the object type. The syntax of an object type defines the abstract data structure corresponding to that object type. The ASN.1[5] language is used for this purpose. However, RFC 1155 purposely restricts the ASN.1 constructs which may be used. These restrictions are explicitly made for simplicity. The access-level of an object type defines whether it makes "protocol sense" to read and/or write the value of an instance of the object type. (This access-level is independent of any administrative authorization policy.) The implementation-status of an object type indicates whether the object is mandatory, optional, obsolete, or deprecated. Grillo, Waldbusser Expires April 7, 1993 [Page 3] INTERNET DRAFT Host Resources MIB Jul 92 4. Host Resources MIB The Host Resources MIB defines a uniform set of objects useful for the management of host computers. Host computers consist of end-systems, and are independent of the operating system, network services, or any software application. The Host Resources MIB defines objects which are common across many computer system architectures. In addition, there are objects in MIB-2 [3] which also provide host management functionality: sysDescr, sysObjectID, sysUpTime, sysContact, sysLocation, and sysServices. Implementation of these objects is mandatory for implementors of MIB-2. Grillo, Waldbusser Expires April 7, 1993 [Page 4] INTERNET DRAFT Host Resources MIB Jul 92 5. Definitions RFC-Host-Resources-MIB DEFINITIONS ::= BEGIN IMPORTS OBJECT-TYPE FROM RFC-1212 DisplayString FROM RFC1213-MIB experimental, TimeTicks, Counter FROM RFC1155-SMI; host OBJECT IDENTIFIER ::= { experimental 36 } hrSystem OBJECT IDENTIFIER ::= { host 1 } hrStorage OBJECT IDENTIFIER ::= { host 2 } hrDevice OBJECT IDENTIFIER ::= { host 3 } hrSWRun OBJECT IDENTIFIER ::= { host 4 } hrSWInstalled OBJECT IDENTIFIER ::= { host 5 } Grillo, Waldbusser Expires April 7, 1993 [Page 5] INTERNET DRAFT Host Resources MIB Jul 92 -- textual conventions -- a truth value Boolean ::= INTEGER { true(1), false(2) } -- memory size, expressed in units of 1024bytes KBytes ::= INTEGER (0..2147483647) -- To identify a specific hardware or software product and -- its version ProductID ::= OBJECT IDENTIFIER -- unknownProduct will be used for any unknown ProductID unknownProduct OBJECT IDENTIFIER ::= { 0 0 } DateAndTime ::= DisplayString (SIZE (14)) -- A date-time specification for the local time of day. -- This data type is intended to provide a consistent -- method of reporting date information. -- -- -- octets contents encoding -- 1-4 year decimal -- 5-6 month decimal (1..12) -- 7-8 day decimal (1..31) -- 9-10 hour decimal (0..23) -- 11-12 minutes decimal (0..59) -- 13-14 seconds decimal (0..59) -- -- For example, Tuesday May 26, 1992 at 1:30:15 PM local time -- would be represented as: -- -- 19920526133015 -- Grillo, Waldbusser Expires April 7, 1993 [Page 6] INTERNET DRAFT Host Resources MIB Jul 92 -- the Host Resources system group -- -- implementation of this group is mandatory for all host systems hrSystemUptime OBJECT-TYPE SYNTAX TimeTicks ACCESS read-only STATUS mandatory DESCRIPTION "The amount of time since this host was last initialized. Note that this is different from sysUpTime in [3] because sysUpTime is the uptime of the network management portion of the system." ::= { hrSystem 1 } hrSystemDate OBJECT-TYPE SYNTAX DateAndTime ACCESS read-write STATUS mandatory DESCRIPTION "The host's notion of the local date and time of day." ::= { hrSystem 2 } hrSystemTimeZone OBJECT-TYPE SYNTAX INTEGER (-1..1439) ACCESS read-write STATUS mandatory DESCRIPTION "The current local time zone, expressed in minutes west of Greenwich. If unknown, the value -1 shall be returned." ::= { hrSystem 3 } hrSystemInitialLoadDevice OBJECT-TYPE SYNTAX INTEGER ACCESS read-write STATUS mandatory DESCRIPTION "This index of the hrDeviceEntry pertaining to the device that this host is configured to load its initial operating system configuration from." ::= { hrSystem 4 } hrSystemInitialLoadParameter OBJECT-TYPE SYNTAX DisplayString (SIZE (0..64)) Grillo, Waldbusser Expires April 7, 1993 [Page 7] INTERNET DRAFT Host Resources MIB Jul 92 ACCESS read-write STATUS mandatory DESCRIPTION "This object contains the parameter (e.g. a pathname) supplied to the load device when requesting the initial operating system configuration from that device." ::= { hrSystem 5 } hrSystemNumUsers OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The number of distinct users currently using CPU or memory resources on this host." ::= { hrSystem 6 } hrSystemProcesses OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The number of process contexts currently loaded or running on this system." ::= { hrSystem 7 } hrSystemMaxProcesses OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The maximum number of process contexts this system can support. If there is no fixed maximum, the value should be zero." ::= { hrSystem 8 } Grillo, Waldbusser Expires April 7, 1993 [Page 8] INTERNET DRAFT Host Resources MIB Jul 92 -- the host storage group -- -- implementation of this group is mandatory for all host systems hrStorageTypes OBJECT IDENTIFIER ::= { hrStorage 1 } hrStorageCache OBJECT IDENTIFIER ::= { hrStorageTypes 1 } hrStorageRam OBJECT IDENTIFIER ::= { hrStorageTypes 2 } hrStorageVirtualMemory OBJECT IDENTIFIER ::= { hrStorageTypes 3 } hrStorageFixedDisk OBJECT IDENTIFIER ::= { hrStorageTypes 4 } hrStorageRemovableDisk OBJECT IDENTIFIER ::= { hrStorageTypes 5 } hrStorageFloppyDisk OBJECT IDENTIFIER ::= { hrStorageTypes 6 } hrStorageCompactDisc OBJECT IDENTIFIER ::= { hrStorageTypes 7 } hrStorageRamDisk OBJECT IDENTIFIER ::= { hrStorageTypes 8 } hrStorageTape OBJECT IDENTIFIER ::= { hrStorageTypes 9 } hrMemorySize OBJECT-TYPE SYNTAX KBytes ACCESS read-only STATUS mandatory DESCRIPTION "The amount of physical main memory contained by the host." ::= { hrStorage 2 } -- An entry shall be placed in the storage table for each logical -- area of storage that is allocated and has fixed resource limits. -- Examples include virtual memory, disk partitions, file systems, -- ram (for some architectures this is further segmented into -- regular memory, extended memory, and so on). hrStorageTable OBJECT-TYPE SYNTAX SEQUENCE OF HrStorageEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "The (conceptual) table of logical storage areas on the host." ::= { hrStorage 3 } hrStorageEntry OBJECT-TYPE SYNTAX HrStorageEntry ACCESS not-accessible STATUS mandatory DESCRIPTION Grillo, Waldbusser Expires April 7, 1993 [Page 9] INTERNET DRAFT Host Resources MIB Jul 92 "A (conceptual) entry for one logical storage area on the host." INDEX { hrStorageIndex } ::= { hrStorageTable 1 } HrStorageEntry ::= SEQUENCE { hrStorageIndex INTEGER, hrStorageType OBJECT IDENTIFIER, hrStorageDescr DisplayString, hrStorageAllocationUnits INTEGER, hrStorageSize INTEGER, hrStorageUsed INTEGER, hrStorageAllocationFailures Counter } hrStorageIndex OBJECT-TYPE SYNTAX INTEGER (1..2147483647) ACCESS read-only STATUS mandatory DESCRIPTION "A unique value for each logical storage area contained by the host." ::= { hrStorageEntry 1 } hrStorageType OBJECT-TYPE SYNTAX OBJECT IDENTIFIER ACCESS read-only STATUS mandatory DESCRIPTION "The type of storage represented by this entry." ::= { hrStorageEntry 2 } hrStorageDescr OBJECT-TYPE SYNTAX DisplayString (SIZE(0..64)) ACCESS read-only STATUS mandatory DESCRIPTION "A description of the type and instance of the storage described by this entry." ::= { hrStorageEntry 3 } hrStorageAllocationUnits OBJECT-TYPE SYNTAX INTEGER ACCESS read-only Grillo, Waldbusser Expires April 7, 1993 [Page 10] INTERNET DRAFT Host Resources MIB Jul 92 STATUS mandatory DESCRIPTION "The size, in bytes, of the data objects allocated from this pool. If this entry is monitoring sectors, blocks, buffers, or packets, for example, this number will commonly be greater than one. Otherwise this number will typically be one." ::= { hrStorageEntry 4 } hrStorageSize OBJECT-TYPE SYNTAX INTEGER ACCESS read-write STATUS mandatory DESCRIPTION "The size of the storage represented by this entry, in units of hrStorageAllocationUnits." ::= { hrStorageEntry 5 } hrStorageUsed OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The amount of the storage represented by this entry that is allocated, in units of hrStorageAllocationUnits." ::= { hrStorageEntry 6 } hrStorageAllocationFailures OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "The number of requests for storage represented by this entry that could not be honored due to not enough storage." ::= { hrStorageEntry 7 } Grillo, Waldbusser Expires April 7, 1993 [Page 11] INTERNET DRAFT Host Resources MIB Jul 92 -- the host device group -- -- implementation of this group is mandatory for all host systems hrDeviceTypes OBJECT IDENTIFIER ::= { hrDevice 1 } hrDeviceProcessor OBJECT IDENTIFIER ::= { hrDeviceTypes 1 } hrDeviceVideo OBJECT IDENTIFIER ::= { hrDeviceTypes 2 } hrDeviceDiskStorage OBJECT IDENTIFIER ::= { hrDeviceTypes 3 } hrDeviceNetwork OBJECT IDENTIFIER ::= { hrDeviceTypes 4 } hrDevicePrinter OBJECT IDENTIFIER ::= { hrDeviceTypes 5 } hrDeviceAudio OBJECT IDENTIFIER ::= { hrDeviceTypes 6 } hrDeviceCoprocessor OBJECT IDENTIFIER ::= { hrDeviceTypes 7 } hrDeviceKeyboard OBJECT IDENTIFIER ::= { hrDeviceTypes 8 } hrDeviceMassStorage OBJECT IDENTIFIER ::= { hrDeviceTypes 9 } hrDeviceMemory OBJECT IDENTIFIER ::= { hrDeviceTypes 10 } hrDeviceModem OBJECT IDENTIFIER ::= { hrDeviceTypes 11 } hrDeviceParallelPort OBJECT IDENTIFIER ::= { hrDeviceTypes 12 } hrDevicePointing OBJECT IDENTIFIER ::= { hrDeviceTypes 13 } hrDeviceSerialPort OBJECT IDENTIFIER ::= { hrDeviceTypes 14 } hrDeviceOther OBJECT IDENTIFIER ::= { hrDeviceTypes 15 } hrDeviceUnknown OBJECT IDENTIFIER ::= { hrDeviceTypes 16 } hrDeviceTable OBJECT-TYPE SYNTAX SEQUENCE OF HrDeviceEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "The (conceptual) table of devices contained by the host." ::= { hrDevice 2 } hrDeviceEntry OBJECT-TYPE SYNTAX HrDeviceEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A (conceptual) entry for one device contained by the host." INDEX { hrDeviceIndex } ::= { hrDeviceTable 1 } HrDeviceEntry ::= SEQUENCE { hrDeviceIndex INTEGER, hrDeviceType OBJECT IDENTIFIER, Grillo, Waldbusser Expires April 7, 1993 [Page 12] INTERNET DRAFT Host Resources MIB Jul 92 hrDeviceDescr DisplayString, hrDeviceID ProductID, hrDeviceLocation INTEGER } hrDeviceIndex OBJECT-TYPE SYNTAX INTEGER (1..2147483647) ACCESS read-only STATUS mandatory DESCRIPTION "A unique value for each devices contained by the host. The value for each device must remain constant at least from one re-initialization of the agent to the next re-initialization." ::= { hrDeviceEntry 1 } hrDeviceType OBJECT-TYPE SYNTAX OBJECT IDENTIFIER ACCESS read-only STATUS mandatory DESCRIPTION "An indication of the type of device. If `hrDeviceProcessor { hrDeviceTypes 1 }' then an entry exists in the hrProcessorTable which corresponds to this device. If `hrDeviceDiskStorage { hrDeviceTypes 3 }', then an entry exists in the hrDiskStorageTable which corresponds to this device. If `hrDeviceNetwork { hrDeviceTypes 4 }', then an entry exists in the hrNetworkTable which corresponds to this device. If `hrDevicePrinter { hrDeviceTypes 5 }', then an entry exists in the hrPrinterTable which corresponds to this device." ::= { hrDeviceEntry 2 } hrDeviceDescr OBJECT-TYPE SYNTAX DisplayString (SIZE (0..64)) ACCESS read-only STATUS mandatory DESCRIPTION Grillo, Waldbusser Expires April 7, 1993 [Page 13] INTERNET DRAFT Host Resources MIB Jul 92 "A textual description of this device, including the device's manufacturer." ::= { hrDeviceEntry 3 } hrDeviceID OBJECT-TYPE SYNTAX ProductID ACCESS read-only STATUS mandatory DESCRIPTION "The product ID for this device." ::= { hrDeviceEntry 4 } hrDeviceStatus OBJECT-TYPE SYNTAX INTEGER { unknown (1), running (2), warning (3), testing(4), down (5) } ACCESS read-only STATUS mandatory DESCRIPTION "The current operational state of the device described by this row of the table. A value 1 indicates that the current state of the device is unknown. 2 indicates that the device is up and running and that no unusual error conditions are known. A warning state 3, indicates that agent has been informed of an unusual error condition by the operational software (e.g., a disk device driver) but that the device is still 'operational'. An example would be high number of soft errors on a disk. A value of testing(4), indicates that the device is not available for use because it is in the testing state. The down(5) state is used only when the agent has been informed that the device is not available for any use." ::= { hrDeviceEntry 5 } hrDeviceErrors OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION Grillo, Waldbusser Expires April 7, 1993 [Page 14] INTERNET DRAFT Host Resources MIB Jul 92 "The number of errors detected on this device." ::= { hrDeviceEntry 6 } hrProcessorTable OBJECT-TYPE SYNTAX SEQUENCE OF HrProcessorEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "The (conceptual) table of processors contained by the host. Note that this table is potentially sparse: a (conceptual) entry exists only if the correspondent value of the hrDeviceType object is `hrDeviceProcessor'." ::= { hrDevice 3 } hrProcessorEntry OBJECT-TYPE SYNTAX HrProcessorEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A (conceptual) entry for one processor contained by the host. The hrDeviceIndex in the index represents the entry in the hrDeviceTable that corresponds to the hrProcessorEntry." INDEX { hrDeviceIndex } ::= { hrProcessorTable 1 } HrProcessorEntry ::= SEQUENCE { hrProcessorSpeed INTEGER, hrProcessorFrwID ProductID, hrProcessorLoad INTEGER } hrProcessorSpeed OBJECT-TYPE SYNTAX INTEGER (1..2147483647) ACCESS read-only STATUS mandatory DESCRIPTION "The rated speed of the processor, expressed in KHz. For example, a 25MHz processor would have a value of 25000." ::= { hrProcessorEntry 1 } Grillo, Waldbusser Expires April 7, 1993 [Page 15] INTERNET DRAFT Host Resources MIB Jul 92 hrProcessorFrwID OBJECT-TYPE SYNTAX ProductID ACCESS read-only STATUS mandatory DESCRIPTION "The product ID of the firmware associated with the processor." ::= { hrProcessorEntry 2 } hrProcessorLoad OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The average number of runnable processes awaiting scheduling on this CPU in the last minute, multiplied by 100. If processes can await scheduling from any of a group of CPUs, the value of this object for each CPU in the group shall be equal to the average number of runnable processes awaiting scheduling by the group of CPUs in the last minute, divided by the number of CPUs in the group, multiplied by 100." ::= { hrProcessorEntry 3 } hrDiskStorageTable OBJECT-TYPE SYNTAX SEQUENCE OF HrDiskStorageEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "The (conceptual) table of long-term storage devices contained by the host. Note that this table is potentially sparse: a (conceptual) entry exists only if the correspondent value of the hrDeviceType object is `hrDeviceDiskStorage'." ::= { hrDevice 4 } hrDiskStorageEntry OBJECT-TYPE SYNTAX HrDiskStorageEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A (conceptual) entry for one long-term storage Grillo, Waldbusser Expires April 7, 1993 [Page 16] INTERNET DRAFT Host Resources MIB Jul 92 device contained by the host. The hrDeviceIndex in the index represents the entry in the hrDeviceTable that corresponds to the hrDiskStorageEntry." INDEX { hrDeviceIndex } ::= { hrDiskStorageTable 1 } HrDiskStorageEntry ::= SEQUENCE { hrDiskStorageType OBJECT IDENTIFIER, hrDiskStorageAccess INTEGER, hrDiskStorageMedia INTEGER, hrDiskStorageCapacity KBytes } -- The assignment of these OBJECT IDENTIFIERs under -- hrDeviceDiskStorage was done solely for convenience and is -- not intended to specify any convention for the assignment of -- such identifiers. hrDiskStorageMFM OBJECT IDENTIFIER ::= { hrDeviceDiskStorage 1 } hrDiskStorageST506 OBJECT IDENTIFIER ::= { hrDeviceDiskStorage 2 } hrDiskStorageESDI OBJECT IDENTIFIER ::= { hrDeviceDiskStorage 3 } hrDiskStorageSCSI OBJECT IDENTIFIER ::= { hrDeviceDiskStorage 4 } hrDiskStorageSCSI2 OBJECT IDENTIFIER ::= { hrDeviceDiskStorage 5 } hrDiskStorageIDE OBJECT IDENTIFIER ::= { hrDeviceDiskStorage 6 } hrDiskStorageUnknown OBJECT IDENTIFIER ::= { 0 0 } hrDiskStorageType OBJECT-TYPE SYNTAX OBJECT IDENTIFIER ACCESS read-only STATUS mandatory DESCRIPTION "An indication of the type of this long-term storage device." ::= { hrDiskStorageEntry 1 } hrDiskStorageAccess OBJECT-TYPE SYNTAX INTEGER { readWrite(1), readOnly(2) } ACCESS read-only STATUS mandatory DESCRIPTION Grillo, Waldbusser Expires April 7, 1993 [Page 17] INTERNET DRAFT Host Resources MIB Jul 92 "An indication if this long-term storage device is readable and writable or only readable." ::= { hrDiskStorageEntry 2 } hrDiskStorageMedia OBJECT-TYPE SYNTAX INTEGER { unknown(1), other(2), hardDisk(3), floppyDisk(4), opticalDiskROM(6), opticalDiskWORM(7), -- Write Once Read Many opticalDiskRW(8), ramDisk(9) } ACCESS read-only STATUS mandatory DESCRIPTION "An indication of the type of media used in this long-term storage device." ::= { hrDiskStorageEntry 3 } hrDiskStorageRemoveable OBJECT-TYPE SYNTAX Boolean ACCESS read-only STATUS mandatory DESCRIPTION "Denotes whether or not the disk media may be removed from the drive." ::= { hrDiskStorageEntry 4 } hrDiskStorageCapacity OBJECT-TYPE SYNTAX KBytes ACCESS read-only STATUS mandatory DESCRIPTION "The total size for this long-term storage device." ::= { hrDiskStorageEntry 5 } hrPartitionTable OBJECT-TYPE SYNTAX SEQUENCE OF HrPartitionEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "The (conceptual) table of partitions for long-term Grillo, Waldbusser Expires April 7, 1993 [Page 18] INTERNET DRAFT Host Resources MIB Jul 92 storage devices contained by he host. Note that this table is potentially sparse: a (conceptual) entry exists only if the correspondent value of the hrDeviceType object is `hrDeviceDiskStorage'." ::= { hrDevice 5 } hrPartitionEntry OBJECT-TYPE SYNTAX HrPartitionEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A (conceptual) entry for one partition. The hrDeviceIndex in the index represents the entry in the hrDeviceTable that corresponds to the hrPartitionEntry. The hrDeviceIndex will usually pertain to a device of type hrDeviceDiskStorage, but for network partitions, it will pertain to a device of type hrDeviceNetwork." INDEX { hrDeviceIndex, hrPartitionIndex } ::= { hrPartitionTable 1 } HrPartitionEntry ::= SEQUENCE { hrPartitionIndex INTEGER, hrPartitionLabel DisplayString, hrPartitionID OCTET STRING, hrPartitionFSIndex INTEGER } hrPartitionIndex OBJECT-TYPE SYNTAX INTEGER (1..2147483647) ACCESS read-only STATUS mandatory DESCRIPTION "A unique value for each partition on this long- term storage device. The value for each long-term storage device must remain constant at least from one re-initialization of the agent to the next re- initialization." ::= { hrPartitionEntry 1 } hrPartitionLabel OBJECT-TYPE SYNTAX DisplayString (SIZE (0..64)) Grillo, Waldbusser Expires April 7, 1993 [Page 19] INTERNET DRAFT Host Resources MIB Jul 92 ACCESS read-only STATUS mandatory DESCRIPTION "A textual description of this partition." ::= { hrPartitionEntry 2 } hrPartitionID OBJECT-TYPE SYNTAX OCTET STRING ACCESS read-only STATUS mandatory DESCRIPTION "A descriptor which uniquely represents this partition to the responsible operating system." ::= { hrPartitionEntry 3 } hrPartitionFSIndex OBJECT-TYPE SYNTAX INTEGER (0..2147483647) ACCESS read-only STATUS mandatory DESCRIPTION "The index of the file system mounted on this partition. If no file system is mounted on this partition, then this value shall be zero." ::= { hrPartitionEntry 4 } -- The File System Table hrFSTable OBJECT-TYPE SYNTAX SEQUENCE OF HrFSEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "The (conceptual) table of file systems local to this host." ::= { hrDevice 6 } hrFSEntry OBJECT-TYPE SYNTAX HrFSEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A (conceptual) entry for one file system local to this host." INDEX { hrFileSystemIndex } ::= { hrFSTable 1 } Grillo, Waldbusser Expires April 7, 1993 [Page 20] INTERNET DRAFT Host Resources MIB Jul 92 HrFSEntry ::= SEQUENCE { hrFSIndex INTEGER, hrFSMountPoint DisplayString, hrFSType OBJECT IDENTIFIER, hrFSAccess INTEGER, hrFSBootable Boolean, hrFSStorageIndex INTEGER, hrFSLastBackupDate DateAndTime, hrFSLastBackupStatus INTEGER } hrFSIndex OBJECT-TYPE SYNTAX INTEGER (1..2147483647) ACCESS read-only STATUS mandatory DESCRIPTION "A unique value for each file system local to this host. The value for each file system must remain constant at least from one re-initialization of the agent to the next re-initialization." ::= { hrFSEntry 1 } hrFSMountPoint OBJECT-TYPE SYNTAX DisplayString (SIZE(0..128)) ACCESS read-only STATUS mandatory DESCRIPTION "The path name of the root of this file system." ::= { hrFSEntry 2 } hrFSType OBJECT-TYPE SYNTAX OBJECT IDENTIFIER ACCESS read-only STATUS mandatory DESCRIPTION "The value of this object identifies the type of this file system." ::= { hrFSEntry 3 } hrFSAccess OBJECT-TYPE SYNTAX INTEGER { readWrite(1), readOnly(2) } Grillo, Waldbusser Expires April 7, 1993 [Page 21] INTERNET DRAFT Host Resources MIB Jul 92 ACCESS read-only STATUS mandatory DESCRIPTION "An indication if this file system is readable and writable or only readable." ::= { hrFSEntry 4 } hrFSBootable OBJECT-TYPE SYNTAX Boolean ACCESS read-only STATUS mandatory DESCRIPTION "A flag indicating whether this file system is bootable." ::= { hrFSEntry 5 } hrFSStorageIndex OBJECT-TYPE SYNTAX INTEGER (0..2147483647) ACCESS read-only STATUS mandatory DESCRIPTION "The index of the hrStorageEntry that represents information about this file system. If there is no such information available, then this value shall be zero." ::= { hrFSEntry 6 } hrFSLastFullBackupDate OBJECT-TYPE SYNTAX DateAndTime ACCESS read-write STATUS mandatory DESCRIPTION "The last date at which this complete file system was copied to another storage device for backup." ::= { hrFSEntry 7 } hrFSLastPartialBackupDate OBJECT-TYPE SYNTAX DateAndTime ACCESS read-write STATUS mandatory DESCRIPTION "The last date at which a portion of this file system was copied to another storage device for backup." ::= { hrFSEntry 8 } Grillo, Waldbusser Expires April 7, 1993 [Page 22] INTERNET DRAFT Host Resources MIB Jul 92 hrNetworkTable OBJECT-TYPE SYNTAX SEQUENCE OF HrNetworkEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "The (conceptual) table of network devices contained by the host. Note that this table is potentially sparse: a (conceptual) entry exists only if the correspondent value of the hrDeviceType object is `network(3)'." ::= { hrDevice 7 } hrNetworkEntry OBJECT-TYPE SYNTAX HrNetworkEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A (conceptual) entry for one network device contained by the host. The hrDeviceIndex in the index represents the entry in the hrDeviceTable that corresponds to the hrNetworkEntry." INDEX { hrDeviceIndex } ::= { hrNetworkTable 1 } HrNetworkEntry ::= SEQUENCE { hrNetworkIfIndex INTEGER } hrNetworkIfIndex OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The value of ifIndex which corresponds to this network device." ::= { hrNetworkEntry 1 } hrPrinterTable OBJECT-TYPE SYNTAX SEQUENCE OF HrPrinterEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "The (conceptual) table of printers contained by Grillo, Waldbusser Expires April 7, 1993 [Page 23] INTERNET DRAFT Host Resources MIB Jul 92 the host. Note that this table is potentially sparse: a (conceptual) entry exists only if the correspondent value of the hrDeviceType object is `hrDevicePrinter'." ::= { hrDevice 8 } hrPrinterEntry OBJECT-TYPE SYNTAX HrPrinterEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A (conceptual) entry for one printer contained by the host. The hrDeviceIndex in the index represents the entry in the hrDeviceTable that corresponds to the hrPrinterEntry." INDEX { hrDeviceIndex } ::= { hrPrinterTable 1 } HrPrinterEntry ::= SEQUENCE { hrPrinterStatus INTEGER, hrPrinterTonerStatus INTEGER, hrPrinterPrinedPages Counter } hrPrinterStatus OBJECT-TYPE SYNTAX INTEGER { idle(1), printing(2), jammed(3), outOfPaper(4), error(5) } ACCESS read-only STATUS mandatory DESCRIPTION "The current status of this printer device." ::= { hrPrinterEntry 1 } hrPrinterTonerStatus OBJECT-TYPE SYNTAX INTEGER { satisfactory(1), low(2), Grillo, Waldbusser Expires April 7, 1993 [Page 24] INTERNET DRAFT Host Resources MIB Jul 92 notApplicable(3), unknown(4) } ACCESS read-only STATUS mandatory DESCRIPTION "The amount of toner left in this printer device." ::= { hrPrinterEntry 2 } hrPrinterPrintedPages OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "The number of pages printed by this printer since this system last rebooted." ::= { hrPrinterEntry 3 } Grillo, Waldbusser Expires April 7, 1993 [Page 25] INTERNET DRAFT Host Resources MIB Jul 92 -- the host running software group -- -- implementation of this group is optional -- -- The hrSWRunningTable contains an entry for each distinct piece of -- software that is running or loaded into physical or virtual -- memory in preparation for running. This includes the host's -- operating system, device drivers, and applications. hrSWOSIndex OBJECT-TYPE SYNTAX INTEGER (1..2147483647) ACCESS read-only STATUS mandatory DESCRIPTION "The index of the entry in the hrSWRunTable that represents the primary operating system running on this host." ::= { hrSWRun 1 } hrSWRunTable OBJECT-TYPE SYNTAX SEQUENCE OF HrSWRunEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "The (conceptual) table of software running on the host." ::= { hrSWRun 2 } hrSWRunEntry OBJECT-TYPE SYNTAX HrSWRunEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A (conceptual) entry for one piece of software running on the host." INDEX { hrSWRunIndex } ::= { hrSWRunTable 1 } HrSWRunEntry ::= SEQUENCE { hrSWRunIndex INTEGER, hrSWRunName DisplayString, hrSWRunID ProductID, hrSWRunPath DisplayString, hrSWRunParameters DisplayString, Grillo, Waldbusser Expires April 7, 1993 [Page 26] INTERNET DRAFT Host Resources MIB Jul 92 hrSWRunSize KBytes, hrSWRunStatus INTEGER } hrSWRunIndex OBJECT-TYPE SYNTAX INTEGER (1..2147483647) ACCESS read-only STATUS mandatory DESCRIPTION "A unique value for each piece of software running on the host." ::= { hrSWRunEntry 1 } hrSWRunName OBJECT-TYPE SYNTAX DisplayString (SIZE (0..64)) ACCESS read-only STATUS mandatory DESCRIPTION "A textual description of this running piece of software, including the manufacturer and the name by which it is commonly known. If this sofware was installed locally, this should be the same string as used in the corresponding hrSWInstalledName." ::= { hrSWRunEntry 2 } hrSWRunID OBJECT-TYPE SYNTAX ProductID ACCESS read-only STATUS mandatory DESCRIPTION "The product ID of this running piece of software." ::= { hrSWRunEntry 3 } hrSWRunPath OBJECT-TYPE SYNTAX DisplayString (SIZE(0..128)) ACCESS read-only STATUS mandatory DESCRIPTION "A description of the location on long-term storage (e.g. a disk drive) from which this software was loaded." ::= { hrSWRunEntry 4 } hrSWRunParameters OBJECT-TYPE SYNTAX DisplayString (SIZE(0..128)) Grillo, Waldbusser Expires April 7, 1993 [Page 27] INTERNET DRAFT Host Resources MIB Jul 92 ACCESS read-only STATUS mandatory DESCRIPTION "A description of the parameters supplied to this software when it was initially loaded." ::= { hrSWRunEntry 5 } hrSWRunType OBJECT-TYPE SYNTAX INTEGER { operatingSystem(1), deviceDriver(2), application(3) } ACCESS read-only STATUS mandatory DESCRIPTION "The type of this software." ::= { hrSWRunEntry 6 } hrSWRunSize OBJECT-TYPE SYNTAX KBytes ACCESS read-only STATUS mandatory DESCRIPTION "The amount of main memory or virtual memory used by this software for both code and data." ::= { hrSWRunEntry 7 } hrSWRunStatus OBJECT-TYPE SYNTAX INTEGER { running(1), runnable(2), -- waiting for resource (CPU, memory, IO) notRunnable(3), -- loaded but waiting for event invalid(4) -- not loaded } ACCESS read-write STATUS mandatory DESCRIPTION "The status of this running piece of software. Setting this value to invalid(4) shall cause this software to stop running and to be unloaded." ::= { hrSWRunEntry 8 } Grillo, Waldbusser Expires April 7, 1993 [Page 28] INTERNET DRAFT Host Resources MIB Jul 92 -- the Host Installed Software group -- -- implementation of this group is optional -- -- The hrSWInstalledTable contains an entry for each piece -- of software installed in long-term storage (e.g. a disk -- drive) locally on this host. Note that this does not -- include software loadable remotely from a network -- server. hrSWInstalledLastChange OBJECT-TYPE SYNTAX TimeTicks ACCESS read-only STATUS mandatory DESCRIPTION "The value of sysUpTime when an entry in the hrSWInstalledTable was last added, renamed, or deleted." ::= { hrSWInstalled 1 } hrSWInstalledLastUpdateTime OBJECT-TYPE SYNTAX TimeTicks ACCESS read-only STATUS mandatory DESCRIPTION "The value of sysUpTime when the hrSWInstalledTable was last completely updated." ::= { hrSWInstalled 2 } hrSWInstalledTable OBJECT-TYPE SYNTAX SEQUENCE OF HrSWInstalledEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "The (conceptual) table of software installed on this host." ::= { hrSWInstalled 3 } hrSWInstalledEntry OBJECT-TYPE SYNTAX HrSWInstalledEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A (conceptual) entry for a piece of software installed on this host." Grillo, Waldbusser Expires April 7, 1993 [Page 29] INTERNET DRAFT Host Resources MIB Jul 92 INDEX { hrSWInstalledIndex } ::= { hrSWInstalledTable 1 } HrSWInstalledEntry ::= SEQUENCE { hrSWInstalledIndex INTEGER, hrSWInstalledName DisplayString, hrSWInstalledID ProductID, hrSWInstalledPath DisplayString, hrSWInstalledDate DateAndTime } hrSWInstalledIndex OBJECT-TYPE SYNTAX INTEGER (1..2147483647) ACCESS read-only STATUS mandatory DESCRIPTION "A unique value for each piece of software installed on the host." ::= { hrSWInstalledEntry 1 } hrSWInstalledName OBJECT-TYPE SYNTAX DisplayString (SIZE (0..64)) ACCESS read-only STATUS mandatory DESCRIPTION "A textual description of this installed piece of software, including the manufacturer and the name by which it is commonly known." ::= { hrSWInstalledEntry 2 } hrSWInstalledID OBJECT-TYPE SYNTAX ProductID ACCESS read-only STATUS mandatory DESCRIPTION "The product ID of this installed piece of software." ::= { hrSWInstalledEntry 3 } hrSWInstalledType OBJECT-TYPE SYNTAX INTEGER { operatingSystem(1), deviceDriver(2), application(3) Grillo, Waldbusser Expires April 7, 1993 [Page 30] INTERNET DRAFT Host Resources MIB Jul 92 } ACCESS read-only STATUS mandatory DESCRIPTION "The type of this software." ::= { hrSWInstalledEntry 4 } hrSWInstalledPath OBJECT-TYPE SYNTAX DisplayString (SIZE(0..128)) ACCESS read-only STATUS mandatory DESCRIPTION "A description of the location on long-term storage (e.g. a disk drive) where this software is located." ::= { hrSWInstalledEntry 5 } hrSWInstalledDate OBJECT-TYPE SYNTAX DateAndTime ACCESS read-only STATUS mandatory DESCRIPTION "The last-modification date of this application as it would appear in a directory listing." ::= { hrSWInstalledEntry 6 } Grillo, Waldbusser Expires April 7, 1993 [Page 31] INTERNET DRAFT Host Resources MIB Jul 92 -- processor assignments, used for hrProcessorType hrProcessorID OBJECT IDENTIFIER ::= { host 7 } END Grillo, Waldbusser Expires April 7, 1993 [Page 32] INTERNET DRAFT Host Resources MIB Jul 92 6. References [1] M.T. Rose and K. McCloghrie, Structure and Identification of Management Information for TCP/IP-based internets. Request for Comments 1155, (May, 1990). [2] M.T. Rose and K. McCloghrie, Concise MIB Definitions. Request for Comments 1212, (March, 1991). [3] K. McCloghrie and M.T. Rose, Management Information Base for Network Management of TCP/IP-based internets: MIB-II. Request for Comments 1213, (March, 1991). [4] J.D. Case, M.S. Fedor, M.L. Schoffstall, and J.R. Davin, Simple Network Management Protocol. Request for Comments 1157, (May, 1990). [5] Information processing systems - Open Systems Interconnection - Specification of Abstract Syntax Notation One (ASN.1), International Organization for Standardization. International Standard 8824, (December, 1987). Grillo, Waldbusser Expires April 7, 1993 [Page 33] INTERNET DRAFT Host Resources MIB Jul 92 Table of Contents 1 Status of this Memo ................................... 1 2 Abstract .............................................. 2 3 The Network Management Framework ...................... 3 4 Host Resources MIB .................................... 4 5 Definitions ........................................... 5 5.1 Textual Conventions ................................. 6 5.2 The Host System Group ............................... 7 5.3 The Host Storage Group .............................. 9 5.4 The Host Device Group ............................... 12 5.5 The Host Running Software Group ..................... 26 5.6 The Host Installed Software Group ................... 29 5.7 Processor Assignments ............................... 32 6 References ............................................ 33 Grillo, Waldbusser Expires April 7, 1993 [Page 34]