cc/td/doc/product/wanbu/mgx8850/20x
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

IF MIB File

IF MIB File

This chapter describes the individual MIB objects that comprise the PXM45-specific MIB files. The
IF MIB resides in the IF-MIB.my file. This MIB is extracted from RFC 2233 and describes the generic network interface sub-layers. The IF MIB is an updated version of MIB-II's ifTable and incorporates the extensions defined in RFC 1229.

Contents of this chapter include:

Interface Index

The interface index contains the semantics of the ifIndex and is used for any objects defined on other mib modules that need these semantics.

The object identifier for each MIB object is listed in Table 3-1.


Table 3-1: Interface Index Object Identifiers
Name Object Identifier

OwnerString

none

InterfaceIndex

none

InterfaceIndexOrZero

none

ifNumber

::= { interfaces 1 }

ifTableLastChange

::= { ifMIBObjects 5 }

The MIB objects are listed in Table 3-2.


Table 3-2: Interface Index MIB Objects
Name Syntax Description Default Value

OwnerString

OCTET STRING (SIZE(0..255))

Uses a model as an administratively-assigned name of the resource-owner for this data type. This information is taken from the NVT ASCII character set. It is suggested that this name contains one or more of the following:

  • ASCII form of the manager station's transport address.

  • Management station name (for example, domain name).

  • Network management personnel's name, location, or phone number.

In some cases, the agent itself is the owner of an entry. In these cases, start of the string can be the agent substring.

InterfaceIndex contains the semantics of ifIndex and is used for any syntax defined on other MIB modules that need these semantics.

Display Hint: 255a

Status: current

none

InterfaceIndex

Integer32 (1..2147483647)

Specifies a unique value, greater than zero, for each interface or interface sub-layer in the managed system. 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.

Display Hint: d

Status: current

none

InterfaceIndexOrZero

Integer32 (0..2147483647)

Specifies an extension of the InterfaceIndex convention for this textual convention. The latter defines a greater than zero value used to identify an interface or interface sub-layer in the managed system. This extension permits the additional value of zero. The zero value is specific and must therefore be defined as part of the description of any object using this syntax. Examples of the usage of zero include situations when the interface was unknown, or when none or all interfaces are referenced.

Display Hint: d

Status: current

none

ifNumber

Integer32

Determines the number of network interfaces (regardless of their current state) present on this system.

Max-Access: read-only

Status: current

none

ifTableLastChange

TimeTicks

Determines the value sysUpTime at the last creation or deletion of an entry in the ifTable. If the number of entries are unchanged since the last re-initialization of the local network management subsystem, this contains a zero value.

Max-Access: read-only

Status: current

none

Interface Table

The interface table contains information on the entity's interfaces. Each sub-layer below the internetwork layer of a network interface is considered to be an interface.

The object identifier for each MIB object is listed in Table 3-3.


Table 3-3: Interface Table Object Identifiers
Name Object Identifier

ifTable

::= { interfaces 2 }

ifEntry

::= { ifTable 1 }

ifIndex

::= { ifEntry 1 }

ifDescr

::= { ifEntry 2 }

ifType

::= { ifEntry 3 }

ifMtu

::= { ifEntry 4 }

ifSpeed

::= { ifEntry 5 }

ifPhysAddress

::= { ifEntry 6 }

ifAdminStatus

::= { ifEntry 7 }

ifOperStatus

::= { ifEntry 8 }

ifLastChange

::= { ifEntry 9 }

ifInOctets

::= { ifEntry 10 }

ifInUcastPkts

::= { ifEntry 11 }

ifInNUcastPkts

::= { ifEntry 12 }

ifInDiscards

::= { ifEntry 13 }

ifInErrors

::= { ifEntry 14 }

ifInUnknownProtos

::= { ifEntry 15 }

ifOutOctets

::= { ifEntry 16 }

ifOutUcastPkts

::= { ifEntry 17 }

ifOutNUcastPkts

::= { ifEntry 18 }

ifOutDiscards

::= { ifEntry 19 }

ifOutErrors

::= { ifEntry 20 }

ifOutQLen

::= { ifEntry 21 }

ifSpecific

::= { ifEntry 22 }

The MIB objects are listed in Table 3-4.


Table 3-4: Interface Table MIB Objects
Name Syntax Description Default Value

ifTable

Sequence of IfEntry

Provides a list of interface entries. The number of entries is given by the value of ifNumber.

Max-Access: not-accessible

Status: current

none

ifEntry

IfEntry

Contains an entry that is used for management information applicable to a particular interface.

Max-Access: not-accessible

Status: current

The index contains ifIndex.

none

ifIndex

InterfaceIndex

Specifies a unique value, greater than zero, for each interface. It is recommended that values be assigned contiguously starting from one. The value for each interface sub-layer must remain constant from one reinitialization of the entity's network management system to the next reinitialization.


Note   For the Cisco MGX 8850, the values may not be contiguous and cannot start from one. The ifIndex association with a physical interface or a logical interface is found in ifName object.

Max-Access: read-only

Status: current

none

ifDescr

DisplayString (SIZE (0..255))

Specifies a textual string that contains information about the interface. This string can include the name of the manufacturer, the product name, and the version of the interface hardware and software.

An example can be the association of the interface with a physical or logical interface.

Max-Access: read-only

Status: current

none

ifType

IANAifType

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

Max-Access: read-only

Status: current

none

ifMtu

Integer32

Indicates the size of the largest packet that is sent and received on the interface, specified in octets. For interfaces that are used to transmit network datagrams, this is the largest network datagram sent on the interface.

Max-Access: read-only

Status: current

none

ifSpeed

Gauge32

Determines an estimate of the interface's current bandwidth in bits per second. For interfaces which do not vary in bandwidth or no accurate estimation is made, ifSpeed can indicate the nominal bandwidth. If the bandwidth of the interface is greater than the maximum value reportable, ifSpeed can report its maximum value (4,294,967,295). For a sub-layer which has no concept of bandwidth, ifSpeed is zero.

Max-Access: read-only

Status: current

none

ifPhysAddress

PhysAddress

Indicates the address of the interface at the protocol sub-layer. For example, an interface can normally contain a Media Access Control (MAC) address. The interface's media-specific MIB must define the bit and byte ordering and the format of the value of this address. For interfaces which do not have such an address (for example, a serial line), ifPhysAddress can contain an octet string of zero length.

Max-Access: read-only

Status: current

none

ifAdminStatus

Integer {up (1), ready to pass packets down; (2), testing; (3), in some test mode}

Indicates the desired state of the interface. The
testing(3) state indicates no operational packets are 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 through configuration information retained by the managed system, ifAdminStatus is then changed to either the up(1), testing(3), or remains in the
down( 2) state.

Max-Access: read-write

Status: current

none

ifOperStatus

Integer {up (1), ready to pass packets; down (2); testing (3), in some test mode; unknown (4), status can not be determined; dormant (5); notPresent (6), some component is missing; lowerLayerDown (7), down due to state of lower-layer interface(s)}

Indicates the current operational state of the interface. The testing(3) state indicates that no operational packets are passed. If ifAdminStatus is down(2), ifOperStatus is down(2). If ifAdminStatus is changed to up(1), ifOperStatus can change to up(1). If the interface is ready to transmit and receive network traffic, it can change to dormant(5) when the interface is waiting for external actions (such as a serial line waiting for an incoming connection). It can remain in the down(2) state if and only if there is a fault that prevents it from going to the up(1) state. It can remain in the notPresent(6) state if the interface is missing hardware components.

Max-Access: read-only

Status: current

none

ifLastChange

TimeTicks

Indicates the sysUpTime value at the time the interface entered the current operational state. If the current state is entered prior to the last reinitialization of the local network management subsystem, this contains a zero value.

Max-Access: read-only

Status: current

none

ifInOctets

Counter32

Indicates the total number of octets received on the interface, including framing characters. The discontinued counter value can occur at reinitialization of the management system, and at other times as indicated by the ifCounterDiscontinuityTime value.

Max-Access: read-only

Status: current

none

ifInUcastPkts

Counter32

Indicates the number of packets delivered by this sub-layer to a higher sub-layer. The packets were not addressed to a multicast or broadcast address at this sub-layer. The discontinued counter value can occur at reinitialization of the management system, and at other times as indicated by the ifCounterDiscontinuityTime value.

Max-Access: read-only

Status: current

none

ifInNUcastPkts

Counter32

Indicates the number of packets that are delivered by this sub-layer to a higher sub-layer. They are addressed to a multicast or broadcast address at this sub-layer. The discontinued counter values can occur at reinitialization of the management system, and at other times as indicated by the ifCounterDiscontinuityTime value. This is deprecated in favor of ifInMulticastPkts and ifInBroadcastPkts.

Max-Access: read-only

Status: deprecated

none

ifInDiscards

Counter32

Indicates the number of inbound packets that are chosen to be discarded even though no errors are detected to prevent their being deliverable to a higher-layer protocol. One possible reason for discarding such a packet can be to free up buffer space. The discontinued counter values can occur at reinitialization of the management system, and at other times as indicated by the ifCounterDiscontinuityTime value.

Max-Access: read-only

Status: current

none

ifInErrors

Counter32

Indicates the number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol for packet-oriented interfaces. For character-oriented or fixed-length interfaces, the number of inbound transmission units contained errors that prevented them from being delivered to a higher-layer protocol. The discontinued counter values can occur at reinitialization of the management system, and at other times as indicated by the ifCounterDiscontinuityTime value.

Max-Access: read-only

Status: current

none

ifInUnknownProtos

Counter32

Indicates the number of packets received through the interface, which are discarded because of an unknown or unsupported protocol for packet-oriented interfaces. For character-oriented or fixed-length interfaces that support protocol multiplexing, this object indicates the number of transmission units received through the interface. These units were discarded because of an unknown or unsupported protocol. For an interface that does not support protocol multiplexing, this counter is always zero. The discontinued counter value can occur at reinitialization of the management system and at other times as indicated by the ifCounterDiscontinuityTime value.

Max-Access: read-only

Status: current

none

ifOutOctets

Counter32

Indicates the number of octets transmitted out of the interface, including framing characters. The discontinued counter value can occur at reinitialization of the management system, and at other times indicated by the ifCounterDiscontinuityTime value.

Max-Access: read-only

Status: current

none

ifOutUcastPkts

Counter32

Indicates the number of packets that are requested for transmission by higher-level protocols. These packets are not addressed to a multicast or broadcast address at this sub-layer. The number includes those that are discarded or not sent. The discontinued counter value can occur at reinitialization of the management system, and at other times, as indicated by the ifCounterDiscontinuityTime value.

Max-Access: read-only

Status: current

none

ifOutNUcastPkts

Counter32

Indicates the number of packets that are requested for transmission by higher-level protocols, which are addressed to a multicast or broadcast address at this sub-layer. The number includes those that are discarded or not sent. The discontinued counter value can occur at re-initialization of the management system, and at other times, as indicated by the ifCounterDiscontinuityTime value. This is deprecated in favor of ifOutMulticastPkts and ifOutBroadcastPkts.

Max-Access: read-only

Status: deprecated

none

ifOutDiscards

Counter32

Indicates the number of outbound packets chosen to be discarded, even though no errors have been detected to prevent their transmission. One possible reason for discarding such a packet can be to free up buffer space. The discontinued counter value can occur at reinitialization of the management system, and at other times, as indicated by the ifCounterDiscontinuityTime value.

Max-Access: read-only

Status: current

none

ifOutErrors

Counter32

Indicates the number of outbound packets that cannot be transmitted because of errors for packet-oriented interfaces. For character-oriented or fixed-length interfaces, this object indicates the number of outbound transmission units that can not be transmitted because of errors. The discontinued counter value can occur at re-nitialization of the management system, and at other times, as indicated by the ifCounterDiscontinuityTime value.

Max-Access: read-only

Status: current

none

ifOutQLen

Gauge32

Indicates the length of the output packet queue (in packets).

Max-Access: read-only

Status: deprecated

none

ifSpecific

IDENTIFIER

Refers to MIB definitions specific to the particular media being used to realize the interface. It is recommended that this value points to an instance of a MIB in the media-specific MIB. The pointer can have the semantics associated with the Instance Pointer textual convention defined in RFC 1903. In fact, it is recommended that the media-specific MIB specify what value ifSpecific can take for values of ifType. If no MIB definitions specific to the particular media are available, the value is set to the IDENTIFIER { 0 0 }.

Max-Access: read-only

Status: deprecated

none

Extension to the Interface Table

The object identifier for each MIB object is listed in Table 3-5.


Note   This table replaces the ifExtnsTable table.


Table 3-5: Extension to the Interface Table Object Identifiers
Name Object Identifier

ifXTable

::= { ifMIBobjects 1 }

ifXEntry

::= { ifXTable 1 }

ifName

::= { ifXEntry 1 }

ifInMulticastPkts

::= { ifXEntry 2 }

ifInBroadcastPkts

::= { ifXEntry 3 }

ifOutMulticastPkts

::= { ifXEntry 4 }

ifOutBroadcastPkts

::= { ifXEntry 5 }

The MIB objects are listed in Table 3-6.


Table 3-6: Extension to the Interface Table MIB Objects
Name Syntax Description Default Value

ifXTable

SEQUENCE OF IfXEntry

Lists the interface entries. The number of entries given by the value of ifNumber. This table contains additional entries for the interface table.

Max-Access: not-accessible

Status: current

none

ifXEntry

IfXEntry

Contains additional management information applicable to a particular interface for this entry.

Max-Access: not-accessible

Status: current

The index contains ifEntry.

none

ifName

DisplayString

Specifies the textual name of the interface. The ifName value is the name of the interface assigned by the local device and is suitable for use in commands entered at the device console. Depending on the interface naming syntax of the device, ifName is a text name such as le0 or a simple port number such as 1. If several entries in the ifTable together represent a single interface as named by the device, each has the same value of ifName.


Note   For an agent that responds to SNMP queries concerning an interface on some other (proxy) device, the ifName value for such an interface is the proxy device local name.

If there is no local name, or if ifName is not applicable, this object contains a zero length string.


Note   For the Cisco MGX 8850, ifName contains the physical or logical association of a name.

Max-Access: read-only

Status: current

The actual values depend on the implementation. The following is an example that illustrates the value(s) for the ifName object:

none

ifDescr ifName Remark

<string>

rs232MP.7.1.1

Association of RS232 Maintenance Port Logical Slot 7, Bay 1, Port 1

<string>

ethernet.7.1.1

Association of Ethernet Port Logical
Slot 1, Bay 1, Port 1

<string>

slip.7.1.2.1

Association of slip Logical Slot 7, Bay 1 rs232port 2, Interface 1

Physical lines, ATM physical lines, and ATM virtual interfaces are the three conventions used for the ifName object.

Physical Lines

This format is used for Physical Lines such as SONET, DS3, DS1, and so on forth. The following is an example:

<lineType>.<logical-slot>.<bay>.<lineNumber>

The following are the values for the physical lines:

lineType

Refers to SONET, DS3, DS1, Ethernet, and RS232

logical-slot

Determines the logical slot number of the module.

ifName

(continued)

bay

Determines the back card number.

lineNumber

Specifies the physical line number.

The following is a SONET physical line example:

sonet.4.1.1 => sonet, Logical Slot 4, Bay 1 , Physical Line 1

The following is a ds3.6.2.3 physical line example:

ds3.6.2.3 => ds3, Logical Slot 6, Bay 2, Physical Line 3

ATM Physical Interfaces

The following is the format used for ATM Physical Interfaces:

atm.<logical-slot>.<bay>.<lineNumber>

The following is the values for the ATM Physical Interfaces:

logical-slot

Determines the logical slot number of the module.

bay

Determines the back card number.

lineNumber

Determines the physical line number.

The following is is an example of the ATM physical interface:

atm.4.2.2.1 => atm, Logical Slot 4, Bay 2, Physical Line 2, ATM Phy 1
atm.4.1.2.2 => atm, Logical Slot 4, Bay 1, IMA Id 2, ATM Phy 2

ATM Virtual Interfaces

The following format is used for ATM Virtual Interfaces (atmVirtual):

atmVirtual.<logical-slot>.<bay>.<lineNumber>.<vi-number>.[<vpi-number>]

The following are the values for the ATM Virtual Interface:

logical-slot

Determines the logical slot number of the module.

bay

Determines the back card number.

lineNumber/Ima-Id

Specifies the physical line number or Ima ID.

vi-number

Determines the virtual interface number.

vpi-number

Determines the VPI number and exists only for virtual trunk.

ifName

(continued)

The following is the first example of the ATM virtual interface:

atmVirtual.3.1.2.33 => atmVirtual, Logical Slot 3, Bay 1 , Physical Line 2, VI 33

The following is the second example of the ATM virtual interface:

atmVirtual.3.1.3.23 => atmVirtual, Logical Slot 3, Bay 1, IMA Id 3, VI 23

The following is the third example of the ATM virtual interface:

atmVirtual.4.2.2.34.2000 => atmVirtual, Logical Slot 4, Bay 2, 
Physical Line 2, VI 34, VPI 2000

ifInMulticast
Pkts

Counter32

Indicates the number of packets delivered by this sub-layer to a higher sub-layer, which is addressed to a multicast address at this sub-layer. For a MAC layer protocol, this includes both groups and functional addresses. The discontinued counter value can occur at re-nitialization of the management system, and at other times, as indicated by the ifCounterDiscontinuityTime value.

Max-Access: read-only

Status: current

none

ifInBroadcast
Pkts

Counter32

Indicates the number of packets delivered by this sub-layer to a higher sub-layer . These packets are addressed to a broadcast address.The discontinued counter value can occur at reinitialization of the management system, and at other times, as indicated by the ifCounterDiscontinuityTime value.

Max-Access: read-only

Status: current

none

ifOutMulticast
Pkts

Counter32

Indicates the number of packets that higher-level protocols request be transmitted. These packets are addressed to a multicast address, which includes those that are discarded or not sent. Both group and functional addresses are included if requested by a MAC layer protocol. The discontinued counter value can occur at reinitialization of the management system, and at other times, as indicated by the ifCounterDiscontinuityTime value.

Max-Access: read-only

Status: current

none

ifOutBroadcast
Pkts

Counter32

Indicates the number of packets that higher-level protocols requested be transmitted, which are addressed to a broadcast address at this sub-layer. The object includes those that are discarded or not sent. The discontinued counter value can occur at reinitialization of the management system, and at other times, as indicated by the ifCounterDiscontinuityTime value.

Max-Access: read-only

Status: current

none

High Capacity Counters

The high capacity counters are 64 bit versions of the basic ifTable counters. They have the same basic semantics as their 32-bit counterparts; their syntax is extended to 64 bits.

The object identifier for each MIB object is listed in Table 3-7.


Table 3-7: High Capacity Counters Object Identifiers
Name Object Identifier

ifHCInOctets

::= { ifXEntry 6 }

ifHCInUcastPkts

::= { ifXEntry 7 }

ifHCInMulticastPkts

::= { ifXEntry 8 }

ifHCInBroadcastPkts

::= { ifXEntry 9 }

ifHCOutOctets

::= { ifXEntry 10 }

ifHCOutUcastPkts

::= { ifXEntry 11 }

ifHCOutMulticastPkts

::= { ifXEntry 12 }

ifHCOutBroadcastPkts

::= { ifXEntry 13 }

ifLinkUpDownTrapEnable

::= { ifXEntry 14 }

ifHighSpeed

::= { ifXEntry 15 }

ifPromiscuousMode

::= { ifXEntry 16 }

ifConnectorPresent

::= { ifXEntry 17 }

ifAlias

::= { ifXEntry 18 }

ifCounterDiscontinuityTime

::= { ifXEntry 19 }

The MIB objects are listed in Table 3-8.


Table 3-8: High Capacity Counters MIB Objects
Name Syntax Description Default Value

ifHCInOctets

Counter64

Indicates the number of octets received on the interface, which includes framing characters. ifHCInOctets is a 64-bit version of ifInOctets. The discontinued counter value can occur at reinitialization of the management system, and at other times, as indicated by ifCounterDiscontinuityTime value.

Max-Access: read-only

Status: current

none

ifHCInUcastPkts

Counter64

Indicates the number of packets delivered by this sub-layer to a higher sub-layer.These packets are not addressed to a multicast or broadcast address at this sub-layer. This is a 64-bit version of ifInUcastPkts. The discontinued counter value can occur at reinitialization of the management system, and at other times, as indicated by the ifCounterDiscontinuityTime value.

Max-Access: read-only

Status: current

none

ifHCInMulticastPkts

Counter64

Indicates the number of packets delivered by a sub-layer to a higher sub-layer, which are 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. The discontinued counter values can occur at reinitialization of the management system, and at other times, as indicated by the ifCounterDiscontinuityTime value.

Max-Access: read-only

Status: current

none

ifHCInBroadcastPkts

Counter64

Indicates the number of packets that are delivered by a lower sub-layer to a higher sub-layer, which are addressed to a broadcast address at the lower sub-layer. This is a 64-bit version of ifInBroadcastPkts. The discontinued counter values can occur at reinitialization of the management system, and at other times, as indicated by the ifCounterDiscontinuityTime value.

Max-Access: read-only

Status: current

none

ifHCOutOctets

Counter64

Indicates the number of octets transmitted out of the interface that includes framing characters. This is a 64-bit version of ifOutOctets. The discontinued counter values can occur at reinitialization of the management system, and at other times, as indicated by the ifCounterDiscontinuityTime value.

Max-Access: read-only

Status: current

none

ifHCOutUcastPkts

Counter64

Indicates the number of packets that higher-level protocols requested be transmitted, which are not addressed to a multicast or broadcast address at this sub-layer. This includes those packets that are discarded or not sent. This is a 64-bit version of ifOutUcastPkts. The discontinued counter values can occur at reinitialization of the management system, and at other times, as indicated by the ifCounterDiscontinuityTime value.

Max-Access: read-only

Status: current

none

ifHCOutMulticastPkts

Counter64

Indicates the total number of packets that higher-level protocols requested be transmitted, which are addressed to a multicast address at this sub-layer. This includes the packets that are discarded or not sent. For a MAC layer protocol, this includes both group and functional addresses. This is a 64-bit version of ifOutMulticastPkts. The discontinued counter values can occur at reinitialization of the management system, and at other times, as indicated by the ifCounterDiscontinuityTime value.

Max-Access: read-only

Status: current

none

ifHCOutBroadcastPkts

Counter64

Indicates the number of packets that higher-level protocols requested be transmitted, which are addressed to a broadcast address at this sub-layer. This includes those packets that are discarded or not sent. This is a 64-bit version of ifOutBroadcastPkts. The discontinued counter values can occur at reinitialization of the management system, and at other times, as indicated by the ifCounterDiscontinuityTime value.

Max-Access: read-only

Status: current

none

ifLinkUpDownTrapEnable

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

Indicates whether linkUp or linkDown traps can be generated for this interface. By default, this can 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.

Max-Access: read-write

Status: current

none

ifHighSpeed

Gauge32

Provides an estimate of the interface current bandwidth in units of 1,000,000 bits per second. If this reports a value of n, the speed of the interface is from n-500,000 to n+499,999. For interfaces that do not vary in bandwidth or for those where no accurate estimation can be made, ifHighSpeed can contain the nominal bandwidth. For a sub-layer having a defined bandwidth, the value is zero.

Max-Access: read-only

Status: current

none

ifPromiscuousMode

TruthValue

Specifies a value of false(2) if the interface accepts only packets or frames that are addressed to this station. It has a value of true(1) when the station accepts all packets or frames transmitted on the media. The value true(1) is valid only on certain types of media. If valid, setting ifPromiscuousMode to a value of true(1) can require the interface to be reset before becoming effective. The value of ifPromiscuousMode does not effect the reception of broadcast and multicast packets or frames by the interface.

Max-Access: read-write

Status: current

none

ifConnectorPresent

TruthValue

Specifies the value true(1) if the interface sublayer has a physical connector and the value false(2).

Max-Access: read-only

Status: current

none

ifAlias

DisplayString (SIZE(0..64))

Describes an alias for the interface as specified by a network manager. It provides a non-volatile handle for the interface. On the first instance of an interface, the value of ifAlias associated with that interface is the zero-length string. When a value is written into ifAlias through a network management set operation, the agent must retain the supplied value in the ifAlias instance associated with the same interface. The agent must retain this supplied value for as long as that interface remains instantiated. The duration that the interface remains instantiated includes all reinitializations and reboots of the network management system. It also includes those which result in a change of the interface's ifIndex value.

An example of the value that a network manager can store in ifAlias for a WAN interface is the Telco's circuit number or identifier of the interface.

Some agents can support write-access only for interfaces having particular values of ifType. An agent that supports write access to this is required to keep the value in non-volatile storage, but it can limit the length of new values depending on how much storage is occupied by the current values for other interfaces.

Max-Access: read-write

Status: current

none

ifCounterDiscontinuityTime

TimeStamp

Indicates the sysUpTime value on the most recent occasion 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 contained in the ifTable or ifXTable. If no such discontinuities have occurred since the last reinitialization of the local management subsystem, this object contains a zero value.

Max-Access: read-only

Status: current

none

Interface-Related Traps

The object identifier for each trap is listed in Table 3-9.


Table 3-9: Interface-Related Traps Object Identifiers
Name Object Identifier

linkDown

::= { snmpTraps 3 }

linkUp

::= { snmpTraps 4 }

The traps are listed n in Table 3-10.


Table 3-10: Interface-Related Traps MIB Objects
Name Syntax Description Default Value

linkDown

{ifIndex, ifAdminStatus, ifOperStatus}

Signifies that the SNMPv2 entity, acting in an agent role, has detected that the ifOperStatus for one of its communication links is about to enter the down state. This can be from any other state except the notPresent state. This previous state is indicated by the included value of ifOperStatus.

Status: current

none

linkUp

{ifIndex, ifAdminStatus, ifOperStatus}

Signifies that the SNMPv2 entity, acting in an agent role, has detected that the ifOperStatus for one of its communication links left the down state and transitioned into some other state. This includes any previous state except the notPresent state. This previous state is indicated by the included value of ifOperStatus.

Status: current

none

IF MIB Conformance and Compliance Statements

The information on conformance is specific to SNMPv2. Table 3-11 lists the conformance groups.


Table 3-11: IF MIB Conformance Groups
Name Object Identifier

ifConformance

::= { ifMIB 2 }

ifGroups

::= { ifConformance 1 }

ifCompliances

::= { ifConformance 2 }

IF MIB Conformance Groups

The object identifier for each MIB object is listed in Table 3-12.


Note   The five groups ifFixedLengthGroup, ifPacketGroup, ifHCPacketGroup, ifVHCPacketGroup, and ifRcvAddressGroup are mutually exclusive; only one of these groups is implemented for any interface.


Table 3-12: IF MIB Conformance Group Object Identifiers
Name Object Identifier

ifLinkUpDownTrapEnable

none

ifPromiscuousMode

none

ifStackStatus

none

ifAdminStatus

none

ifAlias

::= { ifCompliances 2 }

ifGeneralInformationGroup

::= { ifGroups 10 }

ifFixedLengthGroup

::= { ifGroups 2 }

ifHCFixedLengthGroup

::= { ifGroups 3 }

ifPacketGroup

::= { ifGroups 4 }

ifHCPacketGroup

::= { ifGroups 5 }

ifVHCPacketGroup

::= { ifGroups 6 }

ifRcvAddressGroup

::= { ifGroups 7 }

ifStackGroup2

::= { ifGroups 11 }

ifCounterDiscontinuityGroup

::= { ifGroups 13 }

A list of the MIB objects is listed in Table 3-13.


Table 3-13: IF MIB Conformance Group MIB Objects
Name Syntax Description Default Value

ifCompliance2E

{ifGeneralInformation
Group, ifStackGroup2, ifCounterDiscontinuity
Group}

Specifies the compliance statement for the SNMPv2 entities that have network interfaces.

Status: current

Module: PXM45

The following is the description of each group:

none

ifLinkUpDownTrapEnable

none

Specifies the write access is not required for this object.

Min-Access: read-only

none

ifPromiscuousMode

none

Specifies the write access is not required for this object.

Min-Access: read-only

none

ifStackStatus

Integer {active(1)} (a subset of RowStatus)

Specifies the write access is not required for this object. Only one of the six enumerated values for the RowStatus textual convention need to be supported, specifically; active(1).

Min-Access: read-only

none

ifAdminStatus

Integer {up(1), down(2)}

Specifies the write access is not required for this object. The value testing(3) is also not supported.

Min-Access: read-only

none

ifAlias

none

Specifies the write access is not required for this object.

Min-Access: read-only

none

ifGeneralInformationGroup

{ifIndex, ifDescr, ifType, ifSpeed, ifPhysAddress, ifAdminStatus, ifOperStatus, ifLastChange, ifLinkUpDownTrapEnable, ifConnectorPresent, ifHighSpeed, ifName, ifNumber, ifAlias, ifTableLastChange}

Describes a collection of objects that provides information applicable to all network interfaces.

Status: current

none

ifFixedLengthGroup

{ifInOctets, ifOutOctets, ifInUnknownProtos, ifInErrors, ifOutErrors}

Describes a collection of objects that provides information specific to non-high speed character-oriented or fixed-length-transmission network interfaces.


Note   Non-high speed interfaces are defined as those that transmit and receive at speeds less than or equal to 20 million bits/second.

Status: current

none

ifHCFixedLengthGroup

{ifHCInOctets, ifHCOutOctets, ifInOctets, ifOutOctets, ifInUnknownProtos, ifInErrors, ifOutErrors }

Describes collection of objects that provides information specific to high speed (greater than
20 million bits/second) that are either character-oriented or fixed-length-transmission network interfaces.

Status: current

none

ifPacketGroup

{ifInOctets, ifOutOctets, ifInUnknownProtos, ifInErrors, ifOutErrors, ifMtu, ifInUcastPkts, ifInMulticastPkts, ifInBroadcastPkts, ifInDiscards, ifOutUcastPkts, ifOutMulticastPkts, ifOutBroadcastPkts, ifOutDiscards, ifPromiscuousMode}

Describes a collection of objects that provides information specific to non-high speed (non-high speed interfaces transmit and receive at speeds less than or equal to 20 millionbits/second) packet-oriented network interfaces.

Status: current

none

ifHCPacketGroup

{ifHCInOctets, ifHCOutOctets, ifInOctets, ifOutOctets, ifInUnknownProtos, ifInErrors, ifOutErrors, ifMtu, ifInUcastPkts, ifInMulticastPkts, ifInBroadcastPkts, ifInDiscards, ifOutUcastPkts, ifOutMulticastPkts, ifOutBroadcastPkts, ifOutDiscards, ifPromiscuousMode}

Describes a collection of objects that provides information specific to high speed (greater than
20 million bits/second but less than or equal to
650 million bits/second) packet-oriented network interfaces.

Status: current

none

ifVHCPacketGroup

{ifHCInUcastPkts, ifHCInMulticastPkts, ifHCInBroadcastPkts, ifHCOutUcastPkts, ifHCOutMulticastPkts, ifHCOutBroadcastPkts, ifHCInOctets, ifHCOutOctets, ifInOctets, ifOutOctets, ifInUnknownProtos, ifInErrors, ifOutErrors, ifMtu, ifInUcastPkts, ifInMulticastPkts, ifInBroadcastPkts, ifInDiscards, ifOutUcastPkts, ifOutMulticastPkts, ifOutBroadcastPkts, ifOutDiscards, ifPromiscuousMode}

Describes a collection of objects that provides information specific to higher speed (greater than
650 million bits/second) packet-oriented network interfaces.

Status: current

none

ifRcvAddressGroup

{ifRcvAddressStatus, ifRcvAddressType}

Describes a collection of objects that provides information on the multiple addresses that an interface receives.

Status: current

none

ifStackGroup2

{ifStackStatus, ifStackLastChange}

Describes a collection of objects that provides information on the layering of MIB-II interfaces.

Status: current

none

ifCounterDiscontinuityGroup

{ifCounterDiscontinuity
Time}

Describes a collection of objects that provides information specific to interface counter discontinuities.

Status: current

none


hometocprevnextglossaryfeedbacksearchhelp
Posted: Fri Sep 15 11:56:36 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.