- Contents
SNMP Technical Reference
Interfaces objects
ifNumber
| Type | Access | Description |
|---|---|---|
|
Integer |
read-only |
The number of network interfaces (regardless of their current state) present on this system. |
ifTable
| Type | Access | Description |
|---|---|---|
|
N/A |
not-accessible |
A list of interface entries. The number of entries is given by the value of ifNumber. |
ifEntry
| Type | Access | Description |
|---|---|---|
|
N/A |
not-accessible |
An interface entry containing objects at the subnetwork layer and below for a particular interface. Each entry contains data for the following objects: ifIndex ifDescr ifType ifMtu ifSpeed ifPhysAddress ifAdminStatus ifOperStatus ifLastChange ifInOctets ifInUcastPkts ifInNUcastPkts ifInDiscards ifInErrors ifInUnknownProtos ifOutOctets ifOutUcastPkts ifOutNUcastPkts ifOutDiscards ifOutErrors ifOutQLen ifSpecific |
ifIndex
| Type | Access | Description |
|---|---|---|
|
Integer |
read-only |
A unique value for each interface. Its value ranges between 1 and the value of ifNumber. The value for each interface must remain constant at least from one re-initialization of the entity's network management system to the next re-initialization. |
ifDescr
| Type | Access | Description |
|---|---|---|
|
DisplayString |
read-only |
A textual string containing information about the interface. This string should include the name of the manufacturer, the product name, and the version of the hardware interface. |
ifType
| Type | Access | Description |
|---|---|---|
|
Integer |
read-only |
The type of interface, distinguished according to the physical/link protocol(s) immediately `below' the network layer in the protocol stack. This object supports the following values: 1 = other (none of the following) 2 = regular1822 3 = hdh1822 4 = ddn-x25 5 = rfc877-x25 6 = ethernet-csmacd 7 = iso88023-csmacd 8 = iso88024-tokenBus 9 = iso88025-tokenRing 10 = iso88026-man 11 = starLan 12 = proteon-10Mbit 13 = proteon-80Mbit 14 = hyperchannel 15 = fddi 16 = lapb 17 = sdlc 18 = ds1 (T1) 19 = e1 20 = basicISDN 21 = primaryISDN (proprietary serial) 22 = propPointToPointSerial 23 = ppp 24 = softwareLoopback 25 = eon (CLNP over IP [11]) 26 = ethernet-3Mbit 27 = nsip (XNS over IP) 28 = slip (generic SLIP) 29 = ultra (ULTRA technologies) 30 = ds3 (T3) 31 = sip (SMDS) 32 = frame-relay |
ifMtu
| Type | Access | Description |
|---|---|---|
|
Integer |
read-only |
The size of the largest datagram that can be sent/received on the interface, specified in octets. For interfaces that are used for transmitting network datagrams, this is the size of the largest network datagram that can be sent on the interface. |
ifSpeed
| Type | Access | Description |
|---|---|---|
|
Gauge |
read-only |
An estimate of the interface's current bandwidth in bits per second. For interfaces that do not vary in bandwidth or for those where no accurate estimation can be made, this object should contain the nominal bandwidth. |
ifPhysAddress
| Type | Access | Description |
|---|---|---|
|
PhysAddress |
read-only |
The interface's address at the protocol layer immediately 'below' the network layer in the protocol stack. For interfaces that do not have such as address (e.g., a serial line), this object should contain an octet string of zero length. |
ifAdminStatus
| Type | Access | Description |
|---|---|---|
|
Integer |
read-write |
The desired state of the interface. The 'testing' state indicates that no operation packets can be passed. This object supports the following values: 1 = up 2 = down 3 = testing |
ifOperStatus
| Type | Access | Description |
|---|---|---|
|
Integer |
read-only |
The current operational state of the interface. The 'testing' state indicates that no operational packets can be passed. This object supports the following values: 1 = up 2 = down 3 = testing |
ifLastChange
| Type | Access | Description |
|---|---|---|
|
TimeTicks |
read-only |
The value of sysUpTime at the time the interface entered its current operational state. If the current state was entered prior to the last re-initialization of the local network management subsystem, then this object contains a zero value. |
ifInOctets
| Type | Access | Description |
|---|---|---|
|
Counter |
read-only |
The total number of octets received on the interface, including framing characters. |
ifInUcastPkts
| Type | Access | Description |
|---|---|---|
|
Counter |
read-only |
The number of subnetwork-unicast packets delivered to a higher-layer protocol. |
ifInNUcastPkts
| Type | Access | Description |
|---|---|---|
|
Counter |
read-only |
The number of non-unicast (i.e., subnetwork-broadcast or subnetwork-multicast) packets delivered to a higher-layer protocol. |
ifInDiscards
| Type | Access | Description |
|---|---|---|
|
Counter |
read-only |
The number of inbound packets that were chose to be discarded even though no errors had been detected to prevent their being deliverable to a higher-layer protocol. One possible reason for discarding such a packet could be to free up buffer space. |
ifInErrors
| Type | Access | Description |
|---|---|---|
|
Counter |
read-only |
The number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. |
ifInUnknownProtos
| Type | Access | Description |
|---|---|---|
|
Counter |
read-only |
The number of packets received via the interface that were discarded because of an unknown or unsupported protocol. |
ifOutOctets
| Type | Access | Description |
|---|---|---|
|
Counter |
read-only |
The total number of octets transmitted out of the interface, including framing characters. |
ifOutUcastPkts
| Type | Access | Description |
|---|---|---|
|
Counter |
read-only |
The total number of packets that higher-level protocols requested for transmission to a subnetwork-unicast address, including those that were discarded or not sent. |
ifOutNUcastPkts
| Type | Access | Description |
|---|---|---|
|
Counter |
read-only |
The total number of packets that higher-level protocols requested for transmission to a non-unicast (i.e., a subnetwork-broadcast or subnetwork-multicast) address, including those that were discarded or not sent. |
ifOutDiscards
| Type | Access | Description |
|---|---|---|
|
Counter |
read-only |
The number of outbound packets that were chosen to be discarded even though no errors had been detected to prevent their being transmitted. One possible reason for discarding such a packet could be to free up buffer space. |
ifOutErrors
| Type | Access | Description |
|---|---|---|
|
Counter |
read-only |
The number of outbound packets that could not be transmitted because of errors. |
ifOutQLen
| Type | Access | Description |
|---|---|---|
|
Gauge |
read-only |
The length of the output packet queue (in packets). |
ifSpecific
| Type | Access | Description |
|---|---|---|
|
Object Identifier |
read-only |
A reference to MIB definitions specific to the particular media being used to realize the interface. For example, if the interface is realized by an Ethernet, then the value of this object refers to a document defining objects specific to Ethernet. If this information is not present, its value should be set to the OBJECT IDENTIFIER {0 0}, which is a syntactically valid object identifier, and any conformant implementation of ASN.1 and BER must be able to generate and recognize this value. |

