Feedback

  • Contents
 

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.