IF-MIB

1.3.6.1.2.1.2.1

ifNumber

Integer (32 bit)

Read-only

The number of network interfaces (regardless of their current status) present on this system.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.5

ifTableLastChange

INTEGER (0..4294967295)

Read-only

The value of sysUpTime at the time of the last creation or deletion of an entry in the ifTable. If the number of entries has been unchanged since the last re-initialization of the local network management subsystem, then this object contains a zero value.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.6

ifStackLastChange

INTEGER (0..4294967295)

Read-only

The value of sysUpTime at the time of the last change of the (whole) interface stack. A change of the interface stack is defined to be any creation, deletion, or change in value of any instance of ifStackStatus. If the interface stack has been unchanged since the last re-initialization of the local network management subsystem, then this object contains a zero value.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.2.2.1.1

ifIndex

INTEGER

Read-only

A unique value, greater than zero, for each interface.

It is recommended that values are assigned contiguously starting from 1.

The value for each interface sub-layer must remain constant at least from one re-initialization of the entity's network management system to the next re-initialization.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.2.2.1.2

ifDescr

DisplayString (SIZE (0..255))

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 interface hardware/software.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.2.2.1.3

ifType

INTEGER{other(1),regular1822(2),hdh1822(3),ddn-x25(4),rfc877-x25(5),ethernet-csmacd(6),iso88023-csmacd(7),iso88024-tokenBus(8),iso88025-tokenRing(9),iso88026-man(10),starLan(11),proteon-10Mbit(12),proteon-80Mbit(13),hyperchannel(14),fddi(15),lapb(16),sdlc(17),ds1(18),e1(19),basicISDN(20),primaryISDN(21),propPointToPointSerial(22),ppp(23),softwareLoopback(24),eon(25),ethernet-3Mbit(26),nsip(27),slip(28),ultra(29),ds3(30),sip(31),frame-relay(32)}

Read-only

The type of interface. Additional values for ifType are assigned by the Internet Assigned Numbers Authority (IANA), through updating the syntax of the IANAifType textual convention.

After an Ethernet interface is converted into a CSS interface, ifType is displayed as other(1).

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.2.2.1.4

ifMtu

Integer

Read-only

The size of the largest packet which 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.

The ifMtu of a Layer 2 interface is displayed as the jumboframe value. The jumboframe value can be configured using the jumboframe enable [ value ] command.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.2.2.1.5

ifSpeed

INTEGER (0..4294967295)

Read-only

An estimate of the interface's current bandwidth in bits per second.

For interfaces which do not vary in bandwidth or for those where no accurate estimation can be made, this object should contain the nominal bandwidth.

If the bandwidth of the interface is greater than the maximum value reportable by this object then this object should report its maximum value (4,294,967,295) and ifHighSpeed must be used to report the interface's speed.

For a sub-layer which has no concept of bandwidth, this object should be zero.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.2.2.1.6

ifPhysAddress

DisplayString (SIZE (0..255))

Read-only

The interface's address at its protocol sub-layer. For example, for an 802.x interface, this object normally contains a MAC address.

The interface's media-specific MIB must define the bit and byte ordering and the format of the value of this object.

For interfaces which do not have such an address (e.g., a serial line), this object should contain an octet string of zero length.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.2.2.1.7

ifAdminStatus

INTEGER{up(1),down(2),testing(3)}

Read-write

The desired state of the interface.

The testing(3) state indicates that no operational packets can be passed.

When a managed system initializes, all interfaces start with ifAdminStatus in the down(2) state.

As a result of either explicit management action or per configuration information retained by the managed system, ifAdminStatus is then changed to either the up(1) or testing(3) states (or remains in the down(2) state).

Currently, the testing(3) is not supported.

1.3.6.1.2.1.2.2.1.8

ifOperStatus

INTEGER{up(1),down(2),testing(3)}

Read-only

The current operational state of the interface.

The testing(3) state indicates that no operational packets can be passed.

If ifAdminStatus is down(2) then ifOperStatus should be down(2).

If ifAdminStatus is changed to up(1) then ifOperStatus should change to up(1) if the interface is ready to transmit and receive network traffic; it should remain in the down(2) state if and only if there is a fault that prevents it from going to the up(1) state.

Currently, the testing(3) is not supported.

1.3.6.1.2.1.2.2.1.9

ifLastChange

INTEGER (0..4294967295)

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.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.2.2.1.10

ifInOctets

INTEGER (0..4294967295)

Read-only

The total number of octets received on the interface, including framing characters.

Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.2.2.1.11

ifInUcastPkts

INTEGER (0..4294967295)

Read-only

The number of packets, delivered by this sub-layer to a higher (sub-)layer, which were not addressed to a multicast or broadcast address at this sub-layer.

Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.2.2.1.12

ifInNUcastPkts

INTEGER (0..4294967295)

Read-only

Number of non-unicast packets on the inbound interface.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.2.2.1.13

ifInDiscards

INTEGER (0..4294967295)

Read-only

The number of inbound packets which were chosen 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.

Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.2.2.1.14

ifInErrors

INTEGER (0..4294967295)

Read-only

For packet-oriented interfaces, the number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol.

For character-oriented or fixed-length interfaces, the number of inbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol.

Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.2.2.1.15

ifInUnknownProtos

INTEGER (0..4294967295)

Read-only

For packet-oriented interfaces, the number of packets received via the interface which were discarded because of an unknown or unsupported protocol.

For character-oriented or fixed-length interfaces that support protocol multiplexing the number of transmission units received via the interface which were discarded because of an unknown or unsupported protocol.

For any interface that does not support protocol multiplexing, this counter will always be 0.

Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.2.2.1.16

ifOutOctets

INTEGER (0..4294967295)

Read-only

The total number of octets transmitted out of the interface, including framing characters. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.2.2.1.17

ifOutUcastPkts

INTEGER (0..4294967295)

Read-only

The total number of packets that higher-level protocols requested be transmitted, and which were not addressed to a multicast or broadcast address at this sub-layer, including those that were discarded or not sent.

Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.2.2.1.18

ifOutNUcastPkts

INTEGER (0..4294967295)

Read-only

Number of non-unicast packets on the outbound interface.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.2.2.1.19

ifOutDiscards

INTEGER (0..4294967295)

Read-only

The number of outbound packets which 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.

Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.2.2.1.20

ifOutErrors

INTEGER (0..4294967295)

Read-only

For packet-oriented interfaces, the number of outbound packets that could not be transmitted because of errors.

For character-oriented or fixed-length interfaces, the number of outbound transmission units that could not be transmitted because of errors.

Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.2.2.1.21

ifOutQLen

INTEGER (0..4294967295)

Read-only

Length of the queue caching outgoing packets.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.2.2.1.22

ifSpecific

OBJECT IDENTIFIER

Read-only

A reference to MIB definitions specific to the particular media being used to realize the interface. If no MIB definitions specific to the particular media are available, the value is the { 0 0 }.

The value can only be { 0 0 }.

1.3.6.1.2.1.31.1.1.1.1

ifName

OCTET STRING (SIZE (1..64))

Read-only

The textual name of the interface. The value of this object should be the name of the interface as assigned by the local device and should be suitable for use in commands entered at the "console" of device.

This might be a text name, such as 'le0' or a simple port number, such as '1', depending on the interface naming syntax of the device. If several entries in the ifTable together represent a single interface as named by the device, then each will have the same value of ifName.

Note that for an agent which responds to SNMP queries concerning an interface on some other (proxied) device, then the value of ifName for such an interface is the proxied local name of devices for it.

If there is no local name, or this object is otherwise not applicable, then this object contains a zero-length string.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.1.1.2

ifInMulticastPkts

INTEGER (0..4294967295)

Read-only

The number of packets, delivered by this sub-layer to a higher (sub-) layer, which were addressed to a multicast address at this sub-layer.

For a MAC layer protocol, this includes both Group and Functional addresses. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.1.1.3

ifInBroadcastPkts

INTEGER (0..4294967295)

Read-only

The number of packets, delivered by this sub-layer to a higher (sub-) layer, which were addressed to a broadcast address at this sub-layer.

Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.1.1.4

ifOutMulticastPkts

INTEGER (0..4294967295)

Read-only

The total number of packets that higher-level protocols request be transmitted, and which were addressed to a multicast address at this sub-layer, including those that were discarded or not sent.

For a MAC layer protocol, this includes both Group and Functional addresses.

Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.1.1.5

ifOutBroadcastPkts

INTEGER (0..4294967295)

Read-only

The total number of packets that higher-level protocols requested be transmitted, and which were addressed to a broadcast address at this sub-layer, including those that were discarded or not sent.

Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.1.1.6

ifHCInOctets

INTEGER (0..18446744073709551615)

Read-only

The total number of octets received on the interface, including framing characters. This object is a 64-bit version of ifInOctets.

Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.1.1.7

ifHCInUcastPkts

INTEGER (0..18446744073709551615)

Read-only

The number of packets, delivered by this sub-layer to a higher (sub-) layer, which were not addressed to a multicast or broadcast address at this sub-layer.

This object is a 64-bit version of ifInUcastPkts. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.1.1.8

ifHCInMulticastPkts

INTEGER (0..18446744073709551615)

Read-only

The number of packets, delivered by this sub-layer to a higher (sub-) layer, which were addressed to a multicast address at this sub-layer.

For a MAC layer protocol, this includes both Group and Functional addresses.

This object is a 64-bit version of ifInMulticastPkts. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.1.1.9

ifHCInBroadcastPkts

INTEGER (0..18446744073709551615)

Read-only

The number of packets, delivered by this sub-layer to a higher (sub-) layer, which were addressed to a broadcast address at this sub-layer. This object is a 64-bit version of ifInBroadcastPkts.

Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.1.1.10

ifHCOutOctets

INTEGER (0..18446744073709551615)

Read-only

The total number of octets transmitted out of the interface, including framing characters. This object is a 64-bit version of ifOutOctets.

Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.1.1.11

ifHCOutUcastPkts

INTEGER (0..18446744073709551615)

Read-only

The total number of packets that higher-level protocols requested be transmitted, and which were not addressed to a multicast or broadcast address at this sub-layer, including those that were discarded or not sent.

This object is a 64-bit version of ifOutUcastPkts. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.1.1.12

ifHCOutMulticastPkts

INTEGER (0..18446744073709551615)

Read-only

The total number of packets that higher-level protocols requested be transmitted, and which were addressed to a multicast address at this sub-layer, including those that were discarded or not sent. For a MAC layer protocol, this includes both Group and Functional addresses.

This object is a 64-bit version of ifOutMulticastPkts. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.1.1.13

ifHCOutBroadcastPkts

INTEGER (0..18446744073709551615)

Read-only

The total number of packets that higher-level protocols requested be transmitted, and which were addressed to a broadcast address at this sub-layer, including those that were discarded or not sent.

This object is a 64-bit version of ifOutBroadcastPkts. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.1.1.14

ifLinkUpDownTrapEnable

INTEGER{enabled(1),disabled(2)}

Read-write

Indicates whether linkUp/linkDown traps should be generated for this interface.

By default, this object should have the value enabled (1) for interfaces which do not operate on "top" of any other interface (as defined in the ifStackTable), and disabled (2) otherwise.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.1.1.15

ifHighSpeed

INTEGER (0..4294967295)

Read-only

An estimation of the current bandwidth of the interface, in units of 1,000,000 bits per second. If this object reports a value of "n" then the speed of the interface is somewhere in the range of "n-500,000" to "n+499,999".

For interfaces which do not vary in bandwidth or for those where no accurate estimation can be made, this object should contain the nominal bandwidth. For a sub-layer which has no concept of bandwidth, this object should be zero.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.1.1.16

ifPromiscuousMode

INTEGER{true(1),false(2)}

Read-write

This object has a value of false (2) if this interface only accepts packets/frames that are addressed to this station.

This object has a value of true (1) when the station accepts all packets/frames transmitted on the media.

The value true (1) is only legal on certain types of media. If legal, setting this object to a value of true (1) may require the interface to be reset before becoming effective.

The value of ifPromiscuousMode does not affect the reception of broadcast and multicast packets/frames by the interface.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.1.1.17

ifConnectorPresent

INTEGER{true(1),false(2)}

Read-only

This object has the value 'true(1)' if the interface sublayer has a physical connector and the value 'false(2)' otherwise.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.1.1.18

ifAlias

DisplayString(SIZE(0..242))

Read-write

This object is an "alias" name for the interface as specified by a network manager, and provides a non-volatile "handle" for the interface.

On the first instantiation of an interface, the value of ifAlias associated with that interface is the zero-length string.

As and when a value is written into an instance of ifAlias through a network management set operation, then the agent must retain the supplied value in the ifAlias instance associated with the same interface for as long as that interface remains instantiated, including across all re-initializations/reboots of the network management system, including those which result in a change of the ifIndex value of the interface.

An example of the value which a network manager might store in this object for a WAN interface is the (Telco's) circuit number/identifier of the interface.

Some agents may support write-access only for interfaces having particular values of ifType.

An agent which supports write access to this object is required to keep the value in non-volatile storage, but it may limit the length of new values depending on how much storage is already occupied by the current values for other interfaces.

Currently, the read length of alias is 1 to 242, and the written length of alias is 1 to 64. Do not support modifying this item on the Logic-Channel interface.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.1.1.19

ifCounterDiscontinuityTime

TimeTicks

Read-only

The value of sysUpTime on the most recent occasion at which any one or more of this interface's counters suffered a discontinuity.

The relevant counters are the specific instances associated with this interface of any Counter32 or Counter64 object contained in the ifTable or ifXTable.

If no such discontinuities have occurred since the last re-initialization of the local management subsystem, then this object contains a zero value.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.2.1.1

ifStackHigherLayer

Integer

Not-accessible

The value of ifIndex corresponding to the higher sub-layer of the relationship.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.2.1.2

ifStackLowerLayer

Integer

Not-accessible

The status of the relationship between two sub-layers.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.2.1.31.1.2.1.3

ifStackStatus

INTEGER{active(1),notInService(2),notReady(3),createAndGo(4),createAndWait(5),destroy(6)}

Read-create

The status of the relationship between two sub-layers. Changing the value of this object from 'active' to 'notInService' or 'destroy' will likely have consequences up and down the interface stack.

Currently, the maximum access is read-only.

1.3.6.1.6.3.1.1.5.4

linkUp

A linkUp trap signifies that the SNMP entity, acting in an agent role, has detected that the ifOperStatus object for one of its communication links left the down state and transitioned into some other state (but not into the notPresent state). This other state is indicated by the included value of ifOperStatus.

This object is implemented as defined in the corresponding MIB files.

1.3.6.1.6.3.1.1.5.3

linkDown

A linkDown trap signifies that the SNMP entity, acting in an agent role, has detected that the ifOperStatus object for one of its communication links is about to enter the down state from some other state (but not from the notPresent state). This other state is indicated by the included value of ifOperStatus.

This object is implemented as defined in the corresponding MIB files.