- Contents
SNMP Technical Reference
hrDevice objects
hrDeviceTable
| Type | Access | Description |
|---|---|---|
|
N/A |
not-accessible |
The (conceptual) table of devices contained by the host. |
hrDeviceEntry
| Type | Access | Description |
|---|---|---|
|
N/A |
not-accessible |
A (conceptual) entry for one device contained by the host. As an example, an instance of the hrDeviceType object might be named hrDeviceType.3 Each entry contains data for the following objects: hrDeviceIndex hrDeviceType hrDeviceDescr hrDeviceID hrDeviceStatus hrDeviceErrors |
hrDeviceIndex
| Type | Access | Description |
|---|---|---|
|
Integer |
read-only |
A unique value for each device 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. |
hrDeviceType
| Type | Access | Description |
|---|---|---|
|
Object Identifier |
read-only |
An indication of the type of device. If this value is `hrDeviceProcessor { hrDeviceTypes 3 }' then an entry exists in the hrProcessorTable which corresponds to this device. If this value is `hrDeviceNetwork { hrDeviceTypes 4 }', then an entry exists in the hrNetworkTable which corresponds to this device. If this value is `hrDevicePrinter { hrDeviceTypes 5 }', then an entry exists in the hrPrinterTable which corresponds to this device. If this value is `hrDeviceDiskStorage { hrDeviceTypes 6 }', then an entry exists in the hrDiskStorageTable which corresponds to this device. |
hrDeviceDescr
| Type | Access | Description |
|---|---|---|
|
DisplayString |
read-only |
A textual description of this device, including the device's manufacturer and revision, and optionally, its serial number. |
hrDeviceID
| Type | Access | Description |
|---|---|---|
|
ProductID |
read-only |
The product ID for this device. |
hrDeviceStatus
| Type | Access | Description |
|---|---|---|
|
Integer |
read-only |
The current operational state of the device described by this row of the table. A value unknown(1) indicates that the current state of the device is unknown. running(2) indicates that the device is up and running and that no unusual error conditions are known. The warning(3) state 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 a 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 state of down(5) is used only when the agent has been informed that the device is not available for any use. This object supports the following values: 1 = unknown 2 = running 3 = warning 4 = testing 5 = down |
hrDeviceErrors
| Type | Access | Description |
|---|---|---|
|
Counter |
read-only |
The number of errors detected on this device. It should be noted that as this object has a SYNTAX of Counter, that it does not have a defined initial value. However, it is recommended that this object be initialized to zero. |
hrProcessorTable
| Type | Access | Description |
|---|---|---|
|
N/A |
not-accessible |
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'. |
hrProcessorEntry
| Type | Access | Description |
|---|---|---|
|
N/A |
not-accessible |
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. As an example of how objects in this table are named, an instance of the hrProcessorFrwID object might be named hrProcessorFrwID.3 Each entry contains data for the following objects: hrProcessorFrwID hrProcessorLoad |
hrProcessorFrwID
| Type | Access | Description |
|---|---|---|
|
ProductID |
read-only |
The product ID of the firmware associated with the processor. |
hrProcessorLoad
| Type | Access | Description |
|---|---|---|
|
Integer |
read-only |
The average, over the last minute, of the percentage of time that this processor was not idle. Implementations may approximate this one minute smoothing period if necessary. |
hrNetworkTable
| Type | Access | Description |
|---|---|---|
|
N/A |
not-accessible |
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 `hrDeviceNetwork'. |
hrNetworkEntry
| Type | Access | Description |
|---|---|---|
|
N/A |
not-accessible |
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. As an example of how objects in this table are named, an instance of the hrNetworkIfIndex object might be named hrNetworkIfIndex.3. Each entry contains data for the following objects: hrNetworkIfIndex |
hrNetworkIfIndex
| Type | Access | Description |
|---|---|---|
|
Integer |
read-only |
The value of ifIndex which corresponds to this network device. |
hrPrinterTable
| Type | Access | Description |
|---|---|---|
|
N/A |
not-accessible |
The (conceptual) table of printers local to the host. Note that this table is potentially sparse: a (conceptual) entry exists only if the correspondent value of the hrDeviceType object is `hrDevicePrinter'. Each entry contains data for the following objects: HrPrinterEntry |
hrPrinterEntry
| Type | Access | Description |
|---|---|---|
|
N/A |
not-accessible |
A (conceptual) entry for one printer local to the host. The hrDeviceIndex in the index represents the entry in the hrDeviceTable that corresponds to the hrPrinterEntry. As an example of how objects in this table are named, an instance of the hrPrinterStatus object might be named hrPrinterStatus.3 Each entry contains data for the following objects: hrPrinterStatus hrPrinterDetectedErrorState |
hrPrinterStatus
| Type | Access | Description |
|---|---|---|
|
Integer |
read-only |
The current status of this printer device. This object supports the following values: 1 = other 2 = unknown 3 = idle 4 = printing 5 = warmup |
hrPrinterDetectedErrorState
| Type | Access | Description | |||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Octet String |
read-only |
This object represents any error conditions detected by the printer. The error conditions are encoded as bits in an octet string, with the following definitions:
If multiple conditions are currently detected and the hrDeviceStatus would not otherwise be unknown(1) or testing(4), the hrDeviceStatus shall correspond to the worst state of those indicated, where down(5) is worse than warning(3) which is worse than running(2). Bits are numbered starting with the most significant bit of the first byte being bit 0, the least significant bit of the first byte being bit 7, the most significant bit of the second byte being bit 8, and so on. A one bit encodes that the condition was detected, while a zero bit encodes that the condition was not detected. This object is useful for alerting an operator to specific warning or error conditions that may occur, especially those requiring human intervention. |
hrDiskStorageTable
| Type | Access | Description |
|---|---|---|
|
N/A |
not-accessible |
The (conceptual) table of long-term storage devices contained by the host. In particular, disk devices accessed remotely over a network are not included here. Note that this table is potentially sparse: a (conceptual) entry exists only if the correspondent value of the hrDeviceType object is `hrDeviceDiskStorage'. |
hrDiskStorageEntry
| Type | Access | Description |
|---|---|---|
|
N/A |
not-accessible |
A (conceptual) entry for one long-term storage device contained by the host. The hrDeviceIndex in the index represents the entry in the hrDeviceTable that corresponds to the hrDiskStorageEntry. As an example, an instance of the hrDiskStorageCapacity object might be named hrDiskStorageCapacity.3 Each entry contains data for the following objects: hrDiskStorageAccess hrDiskStorageMedia hrDiskStorageRemoveble hrDiskStorageCapacity |
hrDiskStorageAccess
| Type | Access | Description |
|---|---|---|
|
Integer |
read-only |
An indication if this long-term storage device is readable and writable or only readable. This should reflect the media type, any write-protect mechanism, and any device configuration that affects the entire device. This object supports the following values: 1 = readWrite 2 = readOnly |
hrDiskStorageMedia
| Type | Access | Description |
|---|---|---|
|
Integer |
read-only |
An indication of the type of media used in this long-term storage device. This object supports the following values: 1 = other 2 = unknown 3 = hardDisk 4 = floppyDisk 5 = opticalDiskROM 6 = opticalDiskWORM 7 = opticalDiskRW 8 = ramDisk |
hrDiskStorageRemoveble
| Type | Access | Description |
|---|---|---|
|
Boolean |
read-only |
Denotes whether or not the disk media may be removed from the drive. This object supports the following values: 1 = true 2 = false |
hrDiskStorageCapacity
| Type | Access | Description |
|---|---|---|
|
KBytes |
read-only |
The total size for this long-term storage device. |
hrPartitionTable
| Type | Access | Description |
|---|---|---|
|
N/A |
not-accessible |
The (conceptual) table of partitions for long-term storage devices contained by the host. In particular, partitions accessed remotely over a network are not included here. |
hrPartitionEntry
| Type | Access | Description |
|---|---|---|
|
N/A |
not-accessible |
A (conceptual) entry for one partition. The hrDeviceIndex in the index represents the entry in the hrDeviceTable that corresponds to the hrPartitionEntry. As an example of how objects in this table are named, an instance of the hrPartitionSize object might be named hrPartitionSize.3.1 Each entry contains data for the following objects: hrPartitionIndex hrPartitionLabel hrPartitionID hrPartitionSize hrPartitionFSIndex |
hrPartitionIndex
| Type | Access | Description |
|---|---|---|
|
Integer |
read-only |
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. |
hrPartitionLabel
| Type | Access | Description |
|---|---|---|
|
InternationalDisplayString |
read-only |
A textual description of this partition. |
hrPartitionID
| Type | Access | Description |
|---|---|---|
|
Octet String |
read-only |
A descriptor which uniquely represents this partition to the responsible operating system. On some systems, this might take on a binary representation. |
hrPartitionSize
| Type | Access | Description |
|---|---|---|
|
KBytes |
read-only |
The size of this partition. |
hrPartitionFSIndex
| Type | Access | Description |
|---|---|---|
|
Integer |
read-only |
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. Note that multiple partitions may point to one file system, denoting that that file system resides on those partitions. Multiple file systems may not reside on one partition. |
hrFSTable
| Type | Access | Description |
|---|---|---|
|
N/A |
not-accessible |
The (conceptual) table of file systems local to this host or remotely mounted from a file server. File systems that are in only one user's environment on a multi-user system will not be included in this table. |
hrFSEntry
| Type | Access | Description |
|---|---|---|
|
N/A |
not-accessible |
A (conceptual) entry for one file system local to this host or remotely mounted from a file server. File systems that are in only one user's environment on a multi-user system will not be included in this table. As an example of how objects in this table are named, an instance of the hrFSMountPoint object might be named hrFSMountPoint.3 Each entry contains data for the following objects: hrFSIndex hrFSMountPoint hrFSRemoteMountPoint hrFSType hrFSAccess hrFSBootable hrFSStorageIndex hrFSLastFullBackupDate hrFSLastPartialBackupDate |
hrFSIndex
| Type | Access | Description |
|---|---|---|
|
Integer |
read-only |
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. |
hrFSMountPoint
| Type | Access | Description |
|---|---|---|
|
InternationalDisplayString |
read-only |
The path name of the root of this file system. |
hrFSRemoteMountPoint
| Type | Access | Description |
|---|---|---|
|
InternationalDisplayString |
read-only |
A description of the name and/or address of the server that this file system is mounted from. This may also include parameters such as the mount point on the remote file system. If this is not a remote file system, this string should have a length of zero. |
hrFSType
| Type | Access | Description | ||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Object Identifier |
read-only |
The value of this object identifies the type of this file system. This object supports the following values:
|
hrFSAccess
| Type | Access | Description |
|---|---|---|
|
Integer |
read-only |
An indication if this file system is logically configured by the operating system to be readable and writable or only readable. This does not represent any local access-control policy, except one that is applied to the file system as a whole. This object supports the following values: 1 = readWrite 2 = readOnly |
hrFSBootable
| Type | Access | Description |
|---|---|---|
|
Boolean |
read-only |
A flag indicating whether this file system is bootable. |
hrFSStorageIndex
| Type | Access | Description |
|---|---|---|
|
Integer |
read-only |
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. The relevant storage entry will be useful in tracking the percent usage of this file system and diagnosing errors that may occur when it runs out of space. |
hrFSLastFullBackupDate
| Type | Access | Description |
|---|---|---|
|
DateAndTime |
read-write |
The last date at which this complete file system was copied to another storage device for backup. This information is useful for ensuring that backups are being performed regularly. If this information is not known, then this variable shall have the value corresponding to January 1, year 0000, 00:00:00.0, which is encoded as (hex)'00 00 01 01 00 00 00 00'. |
hrFSLastPartialBackupDate
| Type | Access | Description |
|---|---|---|
|
DateAndTime |
read-write |
The last date at which a portion of this file system was copied to another storage device for backup. This information is useful for ensuring that backups are being performed regularly. If this information is not known, then this variable shall have the value corresponding to January 1, year 0000, 00:00:00.0, which is encoded as (hex)'00 00 01 01 00 00 00 00'. |

