- 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. |