| IF-MIB DEFINITIONS ::= BEGIN |
| |
| IMPORTS |
| MODULE-IDENTITY, OBJECT-TYPE, Counter32, Gauge32, Counter64, |
| Integer32, TimeTicks, mib-2, |
| NOTIFICATION-TYPE FROM SNMPv2-SMI |
| TEXTUAL-CONVENTION, DisplayString, |
| PhysAddress, TruthValue, RowStatus, |
| TimeStamp, AutonomousType, TestAndIncr FROM SNMPv2-TC |
| MODULE-COMPLIANCE, OBJECT-GROUP, |
| NOTIFICATION-GROUP FROM SNMPv2-CONF |
| snmpTraps FROM SNMPv2-MIB |
| IANAifType FROM IANAifType-MIB; |
| |
| ifMIB MODULE-IDENTITY |
| LAST-UPDATED "200006140000Z" |
| ORGANIZATION "IETF Interfaces MIB Working Group" |
| CONTACT-INFO |
| " Keith McCloghrie |
| Cisco Systems, Inc. |
| 170 West Tasman Drive |
| San Jose, CA 95134-1706 |
| US |
| |
| 408-526-5260 |
| kzm@cisco.com" |
| DESCRIPTION |
| "The MIB module to describe generic objects for network |
| interface sub-layers. This MIB is an updated version of |
| MIB-II's ifTable, and incorporates the extensions defined in |
| RFC 1229." |
| |
| REVISION "200006140000Z" |
| DESCRIPTION |
| "Clarifications agreed upon by the Interfaces MIB WG, and |
| published as RFC 2863." |
| REVISION "199602282155Z" |
| DESCRIPTION |
| "Revisions made by the Interfaces MIB WG, and published in |
| RFC 2233." |
| REVISION "199311082155Z" |
| DESCRIPTION |
| "Initial revision, published as part of RFC 1573." |
| ::= { mib-2 31 } |
| |
| ifMIBObjects OBJECT IDENTIFIER ::= { ifMIB 1 } |
| |
| interfaces OBJECT IDENTIFIER ::= { mib-2 2 } |
| |
| -- |
| -- Textual Conventions |
| -- |
| |
| -- OwnerString has the same semantics as used in RFC 1271 |
| |
| OwnerString ::= TEXTUAL-CONVENTION |
| DISPLAY-HINT "255a" |
| STATUS deprecated |
| DESCRIPTION |
| "This data type is used to model an administratively |
| assigned name of the owner of a resource. This information |
| is taken from the NVT ASCII character set. It is suggested |
| that this name contain one or more of the following: ASCII |
| form of the manager station's transport address, management |
| station name (e.g., domain name), network management |
| personnel's name, location, or phone number. In some cases |
| the agent itself will be the owner of an entry. In these |
| cases, this string shall be set to a string starting with |
| 'agent'." |
| SYNTAX OCTET STRING (SIZE(0..255)) |
| |
| -- InterfaceIndex contains the semantics of ifIndex and should be used |
| -- for any objects defined in other MIB modules that need these semantics. |
| |
| InterfaceIndex ::= TEXTUAL-CONVENTION |
| DISPLAY-HINT "d" |
| STATUS current |
| DESCRIPTION |
| "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." |
| SYNTAX Integer32 (1..2147483647) |
| |
| InterfaceIndexOrZero ::= TEXTUAL-CONVENTION |
| DISPLAY-HINT "d" |
| STATUS current |
| DESCRIPTION |
| "This textual convention is an extension of the |
| InterfaceIndex 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 value zero is object-specific |
| and must therefore be defined as part of the description of |
| any object which uses this syntax. Examples of the usage of |
| zero might include situations where interface was unknown, |
| or when none or all interfaces need to be referenced." |
| SYNTAX Integer32 (0..2147483647) |
| |
| ifNumber OBJECT-TYPE |
| SYNTAX Integer32 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "The number of network interfaces (regardless of their |
| current state) present on this system." |
| ::= { interfaces 1 } |
| |
| ifTableLastChange OBJECT-TYPE |
| SYNTAX TimeTicks |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifMIBObjects 5 } |
| |
| -- the Interfaces table |
| |
| -- The Interfaces 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. |
| |
| ifTable OBJECT-TYPE |
| SYNTAX SEQUENCE OF IfEntry |
| MAX-ACCESS not-accessible |
| STATUS current |
| DESCRIPTION |
| "A list of interface entries. The number of entries is |
| given by the value of ifNumber." |
| ::= { interfaces 2 } |
| |
| ifEntry OBJECT-TYPE |
| SYNTAX IfEntry |
| MAX-ACCESS not-accessible |
| STATUS current |
| DESCRIPTION |
| "An entry containing management information applicable to a |
| particular interface." |
| INDEX { ifIndex } |
| ::= { ifTable 1 } |
| |
| IfEntry ::= |
| SEQUENCE { |
| ifIndex InterfaceIndex, |
| ifDescr DisplayString, |
| ifType IANAifType, |
| ifMtu Integer32, |
| ifSpeed Gauge32, |
| ifPhysAddress PhysAddress, |
| ifAdminStatus INTEGER, |
| ifOperStatus INTEGER, |
| ifLastChange TimeTicks, |
| ifInOctets Counter32, |
| ifInUcastPkts Counter32, |
| ifInNUcastPkts Counter32, -- deprecated |
| ifInDiscards Counter32, |
| ifInErrors Counter32, |
| ifInUnknownProtos Counter32, |
| ifOutOctets Counter32, |
| ifOutUcastPkts Counter32, |
| ifOutNUcastPkts Counter32, -- deprecated |
| ifOutDiscards Counter32, |
| ifOutErrors Counter32, |
| ifOutQLen Gauge32, -- deprecated |
| ifSpecific OBJECT IDENTIFIER -- deprecated |
| } |
| |
| ifIndex OBJECT-TYPE |
| SYNTAX InterfaceIndex |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifEntry 1 } |
| |
| ifDescr OBJECT-TYPE |
| SYNTAX DisplayString (SIZE (0..255)) |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifEntry 2 } |
| |
| ifType OBJECT-TYPE |
| SYNTAX IANAifType |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifEntry 3 } |
| |
| ifMtu OBJECT-TYPE |
| SYNTAX Integer32 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifEntry 4 } |
| |
| ifSpeed OBJECT-TYPE |
| SYNTAX Gauge32 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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 interace's speed. For a sub-layer which has |
| no concept of bandwidth, this object should be zero." |
| ::= { ifEntry 5 } |
| |
| ifPhysAddress OBJECT-TYPE |
| SYNTAX PhysAddress |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifEntry 6 } |
| |
| ifAdminStatus OBJECT-TYPE |
| SYNTAX INTEGER { |
| up(1), -- ready to pass packets |
| down(2), |
| testing(3) -- in some test mode |
| } |
| MAX-ACCESS read-write |
| STATUS current |
| DESCRIPTION |
| "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)." |
| ::= { ifEntry 7 } |
| |
| ifOperStatus OBJECT-TYPE |
| SYNTAX INTEGER { |
| up(1), -- ready to pass packets |
| down(2), |
| testing(3), -- in some test mode |
| unknown(4), -- status can not be determined |
| -- for some reason. |
| dormant(5), |
| notPresent(6), -- some component is missing |
| lowerLayerDown(7) -- down due to state of |
| -- lower-layer interface(s) |
| } |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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 |
| change to dormant(5) if the interface is waiting for |
| external actions (such as a serial line waiting for an |
| incoming connection); 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; it should remain in the notPresent(6) |
| state if the interface has missing (typically, hardware) |
| components." |
| ::= { ifEntry 8 } |
| |
| ifLastChange OBJECT-TYPE |
| SYNTAX TimeTicks |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifEntry 9 } |
| |
| ifInOctets OBJECT-TYPE |
| SYNTAX Counter32 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifEntry 10 } |
| |
| ifInUcastPkts OBJECT-TYPE |
| SYNTAX Counter32 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifEntry 11 } |
| |
| ifInNUcastPkts OBJECT-TYPE |
| SYNTAX Counter32 |
| MAX-ACCESS read-only |
| STATUS deprecated |
| DESCRIPTION |
| "The number of packets, delivered by this sub-layer to a |
| higher (sub-)layer, which were 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 deprecated in favour of ifInMulticastPkts and |
| ifInBroadcastPkts." |
| ::= { ifEntry 12 } |
| |
| ifInDiscards OBJECT-TYPE |
| SYNTAX Counter32 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifEntry 13 } |
| |
| ifInErrors OBJECT-TYPE |
| SYNTAX Counter32 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifEntry 14 } |
| |
| ifInUnknownProtos OBJECT-TYPE |
| SYNTAX Counter32 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifEntry 15 } |
| |
| ifOutOctets OBJECT-TYPE |
| SYNTAX Counter32 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifEntry 16 } |
| |
| ifOutUcastPkts OBJECT-TYPE |
| SYNTAX Counter32 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifEntry 17 } |
| |
| ifOutNUcastPkts OBJECT-TYPE |
| SYNTAX Counter32 |
| MAX-ACCESS read-only |
| STATUS deprecated |
| DESCRIPTION |
| "The total number of packets that higher-level protocols |
| requested be transmitted, and which were 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 deprecated in favour of ifOutMulticastPkts |
| and ifOutBroadcastPkts." |
| ::= { ifEntry 18 } |
| |
| ifOutDiscards OBJECT-TYPE |
| SYNTAX Counter32 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifEntry 19 } |
| |
| ifOutErrors OBJECT-TYPE |
| SYNTAX Counter32 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifEntry 20 } |
| |
| ifOutQLen OBJECT-TYPE |
| SYNTAX Gauge32 |
| MAX-ACCESS read-only |
| STATUS deprecated |
| DESCRIPTION |
| "The length of the output packet queue (in packets)." |
| ::= { ifEntry 21 } |
| |
| ifSpecific OBJECT-TYPE |
| SYNTAX OBJECT IDENTIFIER |
| MAX-ACCESS read-only |
| STATUS deprecated |
| DESCRIPTION |
| "A reference to MIB definitions specific to the particular |
| media being used to realize the interface. It is |
| |
| recommended that this value point to an instance of a MIB |
| object in the media-specific MIB, i.e., that this object |
| have the semantics associated with the InstancePointer |
| textual convention defined in RFC 2579. In fact, it is |
| recommended that the media-specific MIB specify what value |
| ifSpecific should/can take for values of ifType. If no MIB |
| definitions specific to the particular media are available, |
| the value should be set to the OBJECT IDENTIFIER { 0 0 }." |
| ::= { ifEntry 22 } |
| |
| -- |
| -- Extension to the interface table |
| -- |
| -- This table replaces the ifExtnsTable table. |
| -- |
| |
| ifXTable OBJECT-TYPE |
| SYNTAX SEQUENCE OF IfXEntry |
| MAX-ACCESS not-accessible |
| STATUS current |
| DESCRIPTION |
| "A list of interface entries. The number of entries is |
| given by the value of ifNumber. This table contains |
| additional objects for the interface table." |
| ::= { ifMIBObjects 1 } |
| |
| ifXEntry OBJECT-TYPE |
| SYNTAX IfXEntry |
| MAX-ACCESS not-accessible |
| STATUS current |
| DESCRIPTION |
| "An entry containing additional management information |
| applicable to a particular interface." |
| AUGMENTS { ifEntry } |
| ::= { ifXTable 1 } |
| |
| IfXEntry ::= |
| SEQUENCE { |
| ifName DisplayString, |
| ifInMulticastPkts Counter32, |
| ifInBroadcastPkts Counter32, |
| ifOutMulticastPkts Counter32, |
| ifOutBroadcastPkts Counter32, |
| ifHCInOctets Counter64, |
| ifHCInUcastPkts Counter64, |
| ifHCInMulticastPkts Counter64, |
| ifHCInBroadcastPkts Counter64, |
| ifHCOutOctets Counter64, |
| ifHCOutUcastPkts Counter64, |
| ifHCOutMulticastPkts Counter64, |
| ifHCOutBroadcastPkts Counter64, |
| ifLinkUpDownTrapEnable INTEGER, |
| ifHighSpeed Gauge32, |
| ifPromiscuousMode TruthValue, |
| ifConnectorPresent TruthValue, |
| ifAlias DisplayString, |
| ifCounterDiscontinuityTime TimeStamp |
| } |
| |
| ifName OBJECT-TYPE |
| SYNTAX DisplayString |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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 device's `console'. 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 device's local name for it. |
| |
| If there is no local name, or this object is otherwise not |
| applicable, then this object contains a zero-length string." |
| ::= { ifXEntry 1 } |
| |
| ifInMulticastPkts OBJECT-TYPE |
| SYNTAX Counter32 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifXEntry 2 } |
| |
| ifInBroadcastPkts OBJECT-TYPE |
| SYNTAX Counter32 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifXEntry 3 } |
| |
| ifOutMulticastPkts OBJECT-TYPE |
| SYNTAX Counter32 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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. |
| |
| 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." |
| ::= { ifXEntry 4 } |
| |
| ifOutBroadcastPkts OBJECT-TYPE |
| SYNTAX Counter32 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifXEntry 5 } |
| |
| -- |
| -- High Capacity Counter objects. These objects are all |
| -- 64 bit versions of the "basic" ifTable counters. These |
| -- objects all have the same basic semantics as their 32-bit |
| -- counterparts, however, their syntax has been extended |
| -- to 64 bits. |
| -- |
| |
| ifHCInOctets OBJECT-TYPE |
| SYNTAX Counter64 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifXEntry 6 } |
| |
| ifHCInUcastPkts OBJECT-TYPE |
| SYNTAX Counter64 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifXEntry 7 } |
| |
| ifHCInMulticastPkts OBJECT-TYPE |
| SYNTAX Counter64 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifXEntry 8 } |
| |
| ifHCInBroadcastPkts OBJECT-TYPE |
| SYNTAX Counter64 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifXEntry 9 } |
| |
| ifHCOutOctets OBJECT-TYPE |
| SYNTAX Counter64 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifXEntry 10 } |
| |
| ifHCOutUcastPkts OBJECT-TYPE |
| SYNTAX Counter64 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifXEntry 11 } |
| |
| ifHCOutMulticastPkts OBJECT-TYPE |
| SYNTAX Counter64 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifXEntry 12 } |
| |
| ifHCOutBroadcastPkts OBJECT-TYPE |
| SYNTAX Counter64 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifXEntry 13 } |
| |
| ifLinkUpDownTrapEnable OBJECT-TYPE |
| SYNTAX INTEGER { enabled(1), disabled(2) } |
| MAX-ACCESS read-write |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifXEntry 14 } |
| |
| ifHighSpeed OBJECT-TYPE |
| SYNTAX Gauge32 |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "An estimate of the interface's current bandwidth 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." |
| ::= { ifXEntry 15 } |
| |
| ifPromiscuousMode OBJECT-TYPE |
| SYNTAX TruthValue |
| MAX-ACCESS read-write |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifXEntry 16 } |
| |
| ifConnectorPresent OBJECT-TYPE |
| SYNTAX TruthValue |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "This object has the value 'true(1)' if the interface |
| sublayer has a physical connector and the value 'false(2)' |
| otherwise." |
| ::= { ifXEntry 17 } |
| |
| ifAlias OBJECT-TYPE |
| SYNTAX DisplayString (SIZE(0..64)) |
| MAX-ACCESS read-write |
| STATUS current |
| DESCRIPTION |
| "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 interface's |
| ifIndex value. |
| |
| 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." |
| ::= { ifXEntry 18 } |
| |
| ifCounterDiscontinuityTime OBJECT-TYPE |
| SYNTAX TimeStamp |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifXEntry 19 } |
| |
| -- The Interface Stack Group |
| -- |
| -- Implementation of this group is optional, but strongly recommended |
| -- for all systems |
| -- |
| |
| ifStackTable OBJECT-TYPE |
| SYNTAX SEQUENCE OF IfStackEntry |
| MAX-ACCESS not-accessible |
| STATUS current |
| DESCRIPTION |
| "The table containing information on the relationships |
| between the multiple sub-layers of network interfaces. In |
| particular, it contains information on which sub-layers run |
| 'on top of' which other sub-layers, where each sub-layer |
| corresponds to a conceptual row in the ifTable. For |
| example, when the sub-layer with ifIndex value x runs over |
| the sub-layer with ifIndex value y, then this table |
| contains: |
| |
| ifStackStatus.x.y=active |
| |
| For each ifIndex value, I, which identifies an active |
| interface, there are always at least two instantiated rows |
| in this table associated with I. For one of these rows, I |
| is the value of ifStackHigherLayer; for the other, I is the |
| value of ifStackLowerLayer. (If I is not involved in |
| multiplexing, then these are the only two rows associated |
| with I.) |
| |
| For example, two rows exist even for an interface which has |
| no others stacked on top or below it: |
| |
| ifStackStatus.0.x=active |
| ifStackStatus.x.0=active " |
| ::= { ifMIBObjects 2 } |
| |
| ifStackEntry OBJECT-TYPE |
| SYNTAX IfStackEntry |
| MAX-ACCESS not-accessible |
| STATUS current |
| DESCRIPTION |
| "Information on a particular relationship between two sub- |
| layers, specifying that one sub-layer runs on 'top' of the |
| other sub-layer. Each sub-layer corresponds to a conceptual |
| row in the ifTable." |
| INDEX { ifStackHigherLayer, ifStackLowerLayer } |
| ::= { ifStackTable 1 } |
| |
| IfStackEntry ::= |
| SEQUENCE { |
| ifStackHigherLayer InterfaceIndexOrZero, |
| ifStackLowerLayer InterfaceIndexOrZero, |
| ifStackStatus RowStatus |
| } |
| |
| ifStackHigherLayer OBJECT-TYPE |
| SYNTAX InterfaceIndexOrZero |
| MAX-ACCESS not-accessible |
| STATUS current |
| DESCRIPTION |
| "The value of ifIndex corresponding to the higher sub-layer |
| of the relationship, i.e., the sub-layer which runs on 'top' |
| of the sub-layer identified by the corresponding instance of |
| ifStackLowerLayer. If there is no higher sub-layer (below |
| the internetwork layer), then this object has the value 0." |
| ::= { ifStackEntry 1 } |
| |
| ifStackLowerLayer OBJECT-TYPE |
| SYNTAX InterfaceIndexOrZero |
| MAX-ACCESS not-accessible |
| STATUS current |
| DESCRIPTION |
| "The value of ifIndex corresponding to the lower sub-layer |
| of the relationship, i.e., the sub-layer which runs 'below' |
| the sub-layer identified by the corresponding instance of |
| ifStackHigherLayer. If there is no lower sub-layer, then |
| this object has the value 0." |
| ::= { ifStackEntry 2 } |
| |
| ifStackStatus OBJECT-TYPE |
| SYNTAX RowStatus |
| MAX-ACCESS read-create |
| STATUS current |
| DESCRIPTION |
| "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. Thus, write access to this |
| object is likely to be inappropriate for some types of |
| interfaces, and many implementations will choose not to |
| support write-access for any type of interface." |
| ::= { ifStackEntry 3 } |
| |
| ifStackLastChange OBJECT-TYPE |
| SYNTAX TimeTicks |
| MAX-ACCESS read-only |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { ifMIBObjects 6 } |
| |
| -- Generic Receive Address Table |
| -- |
| -- This group of objects is mandatory for all types of |
| -- interfaces which can receive packets/frames addressed to |
| -- more than one address. |
| -- |
| -- This table replaces the ifExtnsRcvAddr table. The main |
| -- difference is that this table makes use of the RowStatus |
| -- textual convention, while ifExtnsRcvAddr did not. |
| |
| ifRcvAddressTable OBJECT-TYPE |
| SYNTAX SEQUENCE OF IfRcvAddressEntry |
| MAX-ACCESS not-accessible |
| STATUS current |
| DESCRIPTION |
| "This table contains an entry for each address (broadcast, |
| multicast, or uni-cast) for which the system will receive |
| packets/frames on a particular interface, except as follows: |
| |
| - for an interface operating in promiscuous mode, entries |
| are only required for those addresses for which the system |
| would receive frames were it not operating in promiscuous |
| mode. |
| |
| - for 802.5 functional addresses, only one entry is |
| required, for the address which has the functional address |
| bit ANDed with the bit mask of all functional addresses for |
| which the interface will accept frames. |
| |
| A system is normally able to use any unicast address which |
| corresponds to an entry in this table as a source address." |
| ::= { ifMIBObjects 4 } |
| |
| ifRcvAddressEntry OBJECT-TYPE |
| SYNTAX IfRcvAddressEntry |
| MAX-ACCESS not-accessible |
| STATUS current |
| DESCRIPTION |
| "A list of objects identifying an address for which the |
| system will accept packets/frames on the particular |
| interface identified by the index value ifIndex." |
| INDEX { ifIndex, ifRcvAddressAddress } |
| ::= { ifRcvAddressTable 1 } |
| |
| IfRcvAddressEntry ::= |
| SEQUENCE { |
| ifRcvAddressAddress PhysAddress, |
| ifRcvAddressStatus RowStatus, |
| ifRcvAddressType INTEGER |
| } |
| |
| ifRcvAddressAddress OBJECT-TYPE |
| SYNTAX PhysAddress |
| MAX-ACCESS not-accessible |
| STATUS current |
| DESCRIPTION |
| "An address for which the system will accept packets/frames |
| on this entry's interface." |
| ::= { ifRcvAddressEntry 1 } |
| |
| ifRcvAddressStatus OBJECT-TYPE |
| SYNTAX RowStatus |
| MAX-ACCESS read-create |
| STATUS current |
| DESCRIPTION |
| "This object is used to create and delete rows in the |
| ifRcvAddressTable." |
| ::= { ifRcvAddressEntry 2 } |
| |
| ifRcvAddressType OBJECT-TYPE |
| SYNTAX INTEGER { |
| |
| other(1), |
| volatile(2), |
| nonVolatile(3) |
| } |
| MAX-ACCESS read-create |
| STATUS current |
| DESCRIPTION |
| "This object has the value nonVolatile(3) for those entries |
| in the table which are valid and will not be deleted by the |
| next restart of the managed system. Entries having the |
| value volatile(2) are valid and exist, but have not been |
| saved, so that will not exist after the next restart of the |
| managed system. Entries having the value other(1) are valid |
| and exist but are not classified as to whether they will |
| continue to exist after the next restart." |
| DEFVAL { volatile } |
| ::= { ifRcvAddressEntry 3 } |
| |
| -- definition of interface-related traps. |
| |
| linkDown NOTIFICATION-TYPE |
| OBJECTS { ifIndex, ifAdminStatus, ifOperStatus } |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { snmpTraps 3 } |
| |
| linkUp NOTIFICATION-TYPE |
| OBJECTS { ifIndex, ifAdminStatus, ifOperStatus } |
| STATUS current |
| DESCRIPTION |
| "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." |
| ::= { snmpTraps 4 } |
| |
| -- conformance information |
| |
| ifConformance OBJECT IDENTIFIER ::= { ifMIB 2 } |
| |
| ifGroups OBJECT IDENTIFIER ::= { ifConformance 1 } |
| ifCompliances OBJECT IDENTIFIER ::= { ifConformance 2 } |
| |
| -- compliance statements |
| |
| ifCompliance3 MODULE-COMPLIANCE |
| STATUS current |
| DESCRIPTION |
| "The compliance statement for SNMP entities which have |
| network interfaces." |
| |
| MODULE -- this module |
| MANDATORY-GROUPS { ifGeneralInformationGroup, |
| linkUpDownNotificationsGroup } |
| |
| -- The groups: |
| -- ifFixedLengthGroup |
| -- ifHCFixedLengthGroup |
| -- ifPacketGroup |
| -- ifHCPacketGroup |
| -- ifVHCPacketGroup |
| -- are mutually exclusive; at most one of these groups is implemented |
| -- for a particular interface. When any of these groups is implemented |
| -- for a particular interface, then ifCounterDiscontinuityGroup must |
| -- also be implemented for that interface. |
| |
| GROUP ifFixedLengthGroup |
| DESCRIPTION |
| "This group is mandatory for those network interfaces which |
| are character-oriented or transmit data in fixed-length |
| transmission units, and for which the value of the |
| corresponding instance of ifSpeed is less than or equal to |
| 20,000,000 bits/second." |
| |
| GROUP ifHCFixedLengthGroup |
| DESCRIPTION |
| "This group is mandatory for those network interfaces which |
| are character-oriented or transmit data in fixed-length |
| transmission units, and for which the value of the |
| corresponding instance of ifSpeed is greater than 20,000,000 |
| bits/second." |
| |
| GROUP ifPacketGroup |
| DESCRIPTION |
| "This group is mandatory for those network interfaces which |
| are packet-oriented, and for which the value of the |
| corresponding instance of ifSpeed is less than or equal to |
| 20,000,000 bits/second." |
| |
| GROUP ifHCPacketGroup |
| DESCRIPTION |
| "This group is mandatory only for those network interfaces |
| which are packet-oriented and for which the value of the |
| corresponding instance of ifSpeed is greater than 20,000,000 |
| bits/second but less than or equal to 650,000,000 |
| bits/second." |
| |
| GROUP ifVHCPacketGroup |
| DESCRIPTION |
| "This group is mandatory only for those network interfaces |
| which are packet-oriented and for which the value of the |
| corresponding instance of ifSpeed is greater than |
| 650,000,000 bits/second." |
| |
| GROUP ifCounterDiscontinuityGroup |
| DESCRIPTION |
| "This group is mandatory for those network interfaces that |
| are required to maintain counters (i.e., those for which one |
| of the ifFixedLengthGroup, ifHCFixedLengthGroup, |
| ifPacketGroup, ifHCPacketGroup, or ifVHCPacketGroup is |
| mandatory)." |
| |
| GROUP ifRcvAddressGroup |
| DESCRIPTION |
| "The applicability of this group MUST be defined by the |
| media-specific MIBs. Media-specific MIBs must define the |
| exact meaning, use, and semantics of the addresses in this |
| group." |
| |
| OBJECT ifLinkUpDownTrapEnable |
| MIN-ACCESS read-only |
| DESCRIPTION |
| "Write access is not required." |
| |
| OBJECT ifPromiscuousMode |
| MIN-ACCESS read-only |
| DESCRIPTION |
| "Write access is not required." |
| |
| OBJECT ifAdminStatus |
| SYNTAX INTEGER { up(1), down(2) } |
| MIN-ACCESS read-only |
| DESCRIPTION |
| "Write access is not required, nor is support for the value |
| testing(3)." |
| |
| OBJECT ifAlias |
| MIN-ACCESS read-only |
| DESCRIPTION |
| "Write access is not required." |
| ::= { ifCompliances 3 } |
| |
| -- units of conformance |
| |
| ifGeneralInformationGroup OBJECT-GROUP |
| OBJECTS { ifIndex, ifDescr, ifType, ifSpeed, ifPhysAddress, |
| ifAdminStatus, ifOperStatus, ifLastChange, |
| ifLinkUpDownTrapEnable, ifConnectorPresent, |
| ifHighSpeed, ifName, ifNumber, ifAlias, |
| ifTableLastChange } |
| STATUS current |
| DESCRIPTION |
| "A collection of objects providing information applicable to |
| all network interfaces." |
| ::= { ifGroups 10 } |
| |
| -- the following five groups are mutually exclusive; at most |
| -- one of these groups is implemented for any interface |
| |
| ifFixedLengthGroup OBJECT-GROUP |
| OBJECTS { ifInOctets, ifOutOctets, ifInUnknownProtos, |
| ifInErrors, ifOutErrors } |
| STATUS current |
| DESCRIPTION |
| "A collection of objects providing information specific to |
| non-high speed (non-high speed interfaces transmit and |
| receive at speeds less than or equal to 20,000,000 |
| bits/second) character-oriented or fixed-length-transmission |
| network interfaces." |
| ::= { ifGroups 2 } |
| |
| ifHCFixedLengthGroup OBJECT-GROUP |
| OBJECTS { ifHCInOctets, ifHCOutOctets, |
| ifInOctets, ifOutOctets, ifInUnknownProtos, |
| ifInErrors, ifOutErrors } |
| STATUS current |
| DESCRIPTION |
| "A collection of objects providing information specific to |
| high speed (greater than 20,000,000 bits/second) character- |
| oriented or fixed-length-transmission network interfaces." |
| ::= { ifGroups 3 } |
| |
| ifPacketGroup OBJECT-GROUP |
| OBJECTS { ifInOctets, ifOutOctets, ifInUnknownProtos, |
| ifInErrors, ifOutErrors, |
| ifMtu, ifInUcastPkts, ifInMulticastPkts, |
| ifInBroadcastPkts, ifInDiscards, |
| ifOutUcastPkts, ifOutMulticastPkts, |
| ifOutBroadcastPkts, ifOutDiscards, |
| ifPromiscuousMode } |
| STATUS current |
| DESCRIPTION |
| "A collection of objects providing information specific to |
| non-high speed (non-high speed interfaces transmit and |
| receive at speeds less than or equal to 20,000,000 |
| bits/second) packet-oriented network interfaces." |
| ::= { ifGroups 4 } |
| |
| ifHCPacketGroup OBJECT-GROUP |
| OBJECTS { ifHCInOctets, ifHCOutOctets, |
| ifInOctets, ifOutOctets, ifInUnknownProtos, |
| ifInErrors, ifOutErrors, |
| ifMtu, ifInUcastPkts, ifInMulticastPkts, |
| ifInBroadcastPkts, ifInDiscards, |
| ifOutUcastPkts, ifOutMulticastPkts, |
| ifOutBroadcastPkts, ifOutDiscards, |
| ifPromiscuousMode } |
| STATUS current |
| DESCRIPTION |
| "A collection of objects providing information specific to |
| high speed (greater than 20,000,000 bits/second but less |
| than or equal to 650,000,000 bits/second) packet-oriented |
| network interfaces." |
| ::= { ifGroups 5 } |
| |
| ifVHCPacketGroup OBJECT-GROUP |
| OBJECTS { ifHCInUcastPkts, ifHCInMulticastPkts, |
| ifHCInBroadcastPkts, ifHCOutUcastPkts, |
| ifHCOutMulticastPkts, ifHCOutBroadcastPkts, |
| ifHCInOctets, ifHCOutOctets, |
| ifInOctets, ifOutOctets, ifInUnknownProtos, |
| ifInErrors, ifOutErrors, |
| ifMtu, ifInUcastPkts, ifInMulticastPkts, |
| ifInBroadcastPkts, ifInDiscards, |
| ifOutUcastPkts, ifOutMulticastPkts, |
| ifOutBroadcastPkts, ifOutDiscards, |
| ifPromiscuousMode } |
| STATUS current |
| DESCRIPTION |
| "A collection of objects providing information specific to |
| higher speed (greater than 650,000,000 bits/second) packet- |
| oriented network interfaces." |
| ::= { ifGroups 6 } |
| |
| ifRcvAddressGroup OBJECT-GROUP |
| OBJECTS { ifRcvAddressStatus, ifRcvAddressType } |
| STATUS current |
| DESCRIPTION |
| "A collection of objects providing information on the |
| multiple addresses which an interface receives." |
| ::= { ifGroups 7 } |
| |
| ifStackGroup2 OBJECT-GROUP |
| OBJECTS { ifStackStatus, ifStackLastChange } |
| STATUS current |
| DESCRIPTION |
| "A collection of objects providing information on the |
| layering of MIB-II interfaces." |
| ::= { ifGroups 11 } |
| |
| ifCounterDiscontinuityGroup OBJECT-GROUP |
| OBJECTS { ifCounterDiscontinuityTime } |
| STATUS current |
| DESCRIPTION |
| "A collection of objects providing information specific to |
| interface counter discontinuities." |
| ::= { ifGroups 13 } |
| |
| linkUpDownNotificationsGroup NOTIFICATION-GROUP |
| NOTIFICATIONS { linkUp, linkDown } |
| STATUS current |
| DESCRIPTION |
| "The notifications which indicate specific changes in the |
| value of ifOperStatus." |
| ::= { ifGroups 14 } |
| |
| -- Deprecated Definitions - Objects |
| |
| -- |
| -- The Interface Test Table |
| -- |
| -- This group of objects is optional. However, a media-specific |
| |
| -- MIB may make implementation of this group mandatory. |
| -- |
| -- This table replaces the ifExtnsTestTable |
| -- |
| |
| ifTestTable OBJECT-TYPE |
| SYNTAX SEQUENCE OF IfTestEntry |
| MAX-ACCESS not-accessible |
| STATUS deprecated |
| DESCRIPTION |
| "This table contains one entry per interface. It defines |
| objects which allow a network manager to instruct an agent |
| to test an interface for various faults. Tests for an |
| interface are defined in the media-specific MIB for that |
| interface. After invoking a test, the object ifTestResult |
| can be read to determine the outcome. If an agent can not |
| perform the test, ifTestResult is set to so indicate. The |
| object ifTestCode can be used to provide further test- |
| specific or interface-specific (or even enterprise-specific) |
| information concerning the outcome of the test. Only one |
| test can be in progress on each interface at any one time. |
| If one test is in progress when another test is invoked, the |
| second test is rejected. Some agents may reject a test when |
| a prior test is active on another interface. |
| |
| Before starting a test, a manager-station must first obtain |
| 'ownership' of the entry in the ifTestTable for the |
| interface to be tested. This is accomplished with the |
| ifTestId and ifTestStatus objects as follows: |
| |
| try_again: |
| get (ifTestId, ifTestStatus) |
| while (ifTestStatus != notInUse) |
| /* |
| * Loop while a test is running or some other |
| * manager is configuring a test. |
| */ |
| short delay |
| get (ifTestId, ifTestStatus) |
| } |
| |
| /* |
| * Is not being used right now -- let's compete |
| * to see who gets it. |
| */ |
| lock_value = ifTestId |
| |
| if ( set(ifTestId = lock_value, ifTestStatus = inUse, |
| ifTestOwner = 'my-IP-address') == FAILURE) |
| /* |
| * Another manager got the ifTestEntry -- go |
| * try again |
| */ |
| goto try_again; |
| |
| /* |
| * I have the lock |
| */ |
| set up any test parameters. |
| |
| /* |
| * This starts the test |
| */ |
| set(ifTestType = test_to_run); |
| |
| wait for test completion by polling ifTestResult |
| |
| when test completes, agent sets ifTestResult |
| agent also sets ifTestStatus = 'notInUse' |
| |
| retrieve any additional test results, and ifTestId |
| |
| if (ifTestId == lock_value+1) results are valid |
| |
| A manager station first retrieves the value of the |
| appropriate ifTestId and ifTestStatus objects, periodically |
| repeating the retrieval if necessary, until the value of |
| ifTestStatus is 'notInUse'. The manager station then tries |
| to set the same ifTestId object to the value it just |
| retrieved, the same ifTestStatus object to 'inUse', and the |
| corresponding ifTestOwner object to a value indicating |
| itself. If the set operation succeeds then the manager has |
| obtained ownership of the ifTestEntry, and the value of the |
| ifTestId object is incremented by the agent (per the |
| semantics of TestAndIncr). Failure of the set operation |
| indicates that some other manager has obtained ownership of |
| the ifTestEntry. |
| |
| Once ownership is obtained, any test parameters can be |
| setup, and then the test is initiated by setting ifTestType. |
| On completion of the test, the agent sets ifTestStatus to |
| 'notInUse'. Once this occurs, the manager can retrieve the |
| results. In the (rare) event that the invocation of tests |
| by two network managers were to overlap, then there would be |
| a possibility that the first test's results might be |
| overwritten by the second test's results prior to the first |
| |
| results being read. This unlikely circumstance can be |
| detected by a network manager retrieving ifTestId at the |
| same time as retrieving the test results, and ensuring that |
| the results are for the desired request. |
| |
| If ifTestType is not set within an abnormally long period of |
| time after ownership is obtained, the agent should time-out |
| the manager, and reset the value of the ifTestStatus object |
| back to 'notInUse'. It is suggested that this time-out |
| period be 5 minutes. |
| |
| In general, a management station must not retransmit a |
| request to invoke a test for which it does not receive a |
| response; instead, it properly inspects an agent's MIB to |
| determine if the invocation was successful. Only if the |
| invocation was unsuccessful, is the invocation request |
| retransmitted. |
| |
| Some tests may require the interface to be taken off-line in |
| order to execute them, or may even require the agent to |
| reboot after completion of the test. In these |
| circumstances, communication with the management station |
| invoking the test may be lost until after completion of the |
| test. An agent is not required to support such tests. |
| However, if such tests are supported, then the agent should |
| make every effort to transmit a response to the request |
| which invoked the test prior to losing communication. When |
| the agent is restored to normal service, the results of the |
| test are properly made available in the appropriate objects. |
| Note that this requires that the ifIndex value assigned to |
| an interface must be unchanged even if the test causes a |
| reboot. An agent must reject any test for which it cannot, |
| perhaps due to resource constraints, make available at least |
| the minimum amount of information after that test |
| completes." |
| ::= { ifMIBObjects 3 } |
| |
| ifTestEntry OBJECT-TYPE |
| SYNTAX IfTestEntry |
| MAX-ACCESS not-accessible |
| STATUS deprecated |
| DESCRIPTION |
| "An entry containing objects for invoking tests on an |
| interface." |
| AUGMENTS { ifEntry } |
| ::= { ifTestTable 1 } |
| |
| IfTestEntry ::= |
| |
| SEQUENCE { |
| ifTestId TestAndIncr, |
| ifTestStatus INTEGER, |
| ifTestType AutonomousType, |
| ifTestResult INTEGER, |
| ifTestCode OBJECT IDENTIFIER, |
| ifTestOwner OwnerString |
| } |
| |
| ifTestId OBJECT-TYPE |
| SYNTAX TestAndIncr |
| MAX-ACCESS read-write |
| STATUS deprecated |
| DESCRIPTION |
| "This object identifies the current invocation of the |
| interface's test." |
| ::= { ifTestEntry 1 } |
| |
| ifTestStatus OBJECT-TYPE |
| SYNTAX INTEGER { notInUse(1), inUse(2) } |
| MAX-ACCESS read-write |
| STATUS deprecated |
| DESCRIPTION |
| "This object indicates whether or not some manager currently |
| has the necessary 'ownership' required to invoke a test on |
| this interface. A write to this object is only successful |
| when it changes its value from 'notInUse(1)' to 'inUse(2)'. |
| After completion of a test, the agent resets the value back |
| to 'notInUse(1)'." |
| ::= { ifTestEntry 2 } |
| |
| ifTestType OBJECT-TYPE |
| SYNTAX AutonomousType |
| MAX-ACCESS read-write |
| STATUS deprecated |
| DESCRIPTION |
| "A control variable used to start and stop operator- |
| initiated interface tests. Most OBJECT IDENTIFIER values |
| assigned to tests are defined elsewhere, in association with |
| specific types of interface. However, this document assigns |
| a value for a full-duplex loopback test, and defines the |
| special meanings of the subject identifier: |
| |
| noTest OBJECT IDENTIFIER ::= { 0 0 } |
| |
| When the value noTest is written to this object, no action |
| is taken unless a test is in progress, in which case the |
| test is aborted. Writing any other value to this object is |
| |
| only valid when no test is currently in progress, in which |
| case the indicated test is initiated. |
| |
| When read, this object always returns the most recent value |
| that ifTestType was set to. If it has not been set since |
| the last initialization of the network management subsystem |
| on the agent, a value of noTest is returned." |
| ::= { ifTestEntry 3 } |
| |
| ifTestResult OBJECT-TYPE |
| SYNTAX INTEGER { |
| none(1), -- no test yet requested |
| success(2), |
| inProgress(3), |
| notSupported(4), |
| unAbleToRun(5), -- due to state of system |
| aborted(6), |
| failed(7) |
| } |
| MAX-ACCESS read-only |
| STATUS deprecated |
| DESCRIPTION |
| "This object contains the result of the most recently |
| requested test, or the value none(1) if no tests have been |
| requested since the last reset. Note that this facility |
| provides no provision for saving the results of one test |
| when starting another, as could be required if used by |
| multiple managers concurrently." |
| ::= { ifTestEntry 4 } |
| |
| ifTestCode OBJECT-TYPE |
| SYNTAX OBJECT IDENTIFIER |
| MAX-ACCESS read-only |
| STATUS deprecated |
| DESCRIPTION |
| "This object contains a code which contains more specific |
| information on the test result, for example an error-code |
| after a failed test. Error codes and other values this |
| object may take are specific to the type of interface and/or |
| test. The value may have the semantics of either the |
| AutonomousType or InstancePointer textual conventions as |
| defined in RFC 2579. The identifier: |
| |
| testCodeUnknown OBJECT IDENTIFIER ::= { 0 0 } |
| |
| is defined for use if no additional result code is |
| available." |
| ::= { ifTestEntry 5 } |
| |
| ifTestOwner OBJECT-TYPE |
| SYNTAX OwnerString |
| MAX-ACCESS read-write |
| STATUS deprecated |
| DESCRIPTION |
| "The entity which currently has the 'ownership' required to |
| invoke a test on this interface." |
| ::= { ifTestEntry 6 } |
| |
| -- Deprecated Definitions - Groups |
| |
| ifGeneralGroup OBJECT-GROUP |
| OBJECTS { ifDescr, ifType, ifSpeed, ifPhysAddress, |
| ifAdminStatus, ifOperStatus, ifLastChange, |
| ifLinkUpDownTrapEnable, ifConnectorPresent, |
| ifHighSpeed, ifName } |
| STATUS deprecated |
| DESCRIPTION |
| "A collection of objects deprecated in favour of |
| ifGeneralInformationGroup." |
| ::= { ifGroups 1 } |
| |
| ifTestGroup OBJECT-GROUP |
| OBJECTS { ifTestId, ifTestStatus, ifTestType, |
| ifTestResult, ifTestCode, ifTestOwner } |
| STATUS deprecated |
| DESCRIPTION |
| "A collection of objects providing the ability to invoke |
| tests on an interface." |
| ::= { ifGroups 8 } |
| |
| ifStackGroup OBJECT-GROUP |
| OBJECTS { ifStackStatus } |
| STATUS deprecated |
| DESCRIPTION |
| "The previous collection of objects providing information on |
| the layering of MIB-II interfaces." |
| ::= { ifGroups 9 } |
| |
| ifOldObjectsGroup OBJECT-GROUP |
| OBJECTS { ifInNUcastPkts, ifOutNUcastPkts, |
| ifOutQLen, ifSpecific } |
| STATUS deprecated |
| DESCRIPTION |
| "The collection of objects deprecated from the original MIB- |
| II interfaces group." |
| ::= { ifGroups 12 } |
| |
| -- Deprecated Definitions - Compliance |
| |
| ifCompliance MODULE-COMPLIANCE |
| STATUS deprecated |
| DESCRIPTION |
| "A compliance statement defined in a previous version of |
| this MIB module, for SNMP entities which have network |
| interfaces." |
| |
| MODULE -- this module |
| MANDATORY-GROUPS { ifGeneralGroup, ifStackGroup } |
| |
| GROUP ifFixedLengthGroup |
| DESCRIPTION |
| "This group is mandatory for all network interfaces which |
| are character-oriented or transmit data in fixed-length |
| transmission units." |
| |
| GROUP ifHCFixedLengthGroup |
| DESCRIPTION |
| "This group is mandatory only for those network interfaces |
| which are character-oriented or transmit data in fixed- |
| length transmission units, and for which the value of the |
| corresponding instance of ifSpeed is greater than 20,000,000 |
| bits/second." |
| |
| GROUP ifPacketGroup |
| DESCRIPTION |
| "This group is mandatory for all network interfaces which |
| are packet-oriented." |
| |
| GROUP ifHCPacketGroup |
| DESCRIPTION |
| "This group is mandatory only for those network interfaces |
| which are packet-oriented and for which the value of the |
| corresponding instance of ifSpeed is greater than |
| 650,000,000 bits/second." |
| |
| GROUP ifTestGroup |
| DESCRIPTION |
| "This group is optional. Media-specific MIBs which require |
| interface tests are strongly encouraged to use this group |
| for invoking tests and reporting results. A medium specific |
| MIB which has mandatory tests may make implementation of |
| |
| this group mandatory." |
| |
| GROUP ifRcvAddressGroup |
| DESCRIPTION |
| "The applicability of this group MUST be defined by the |
| media-specific MIBs. Media-specific MIBs must define the |
| exact meaning, use, and semantics of the addresses in this |
| group." |
| |
| OBJECT ifLinkUpDownTrapEnable |
| MIN-ACCESS read-only |
| DESCRIPTION |
| "Write access is not required." |
| |
| OBJECT ifPromiscuousMode |
| MIN-ACCESS read-only |
| DESCRIPTION |
| "Write access is not required." |
| |
| OBJECT ifStackStatus |
| SYNTAX INTEGER { active(1) } -- subset of RowStatus |
| MIN-ACCESS read-only |
| DESCRIPTION |
| "Write access is not required, and only one of the six |
| enumerated values for the RowStatus textual convention need |
| be supported, specifically: active(1)." |
| |
| OBJECT ifAdminStatus |
| SYNTAX INTEGER { up(1), down(2) } |
| MIN-ACCESS read-only |
| DESCRIPTION |
| "Write access is not required, nor is support for the value |
| testing(3)." |
| ::= { ifCompliances 1 } |
| |
| ifCompliance2 MODULE-COMPLIANCE |
| STATUS deprecated |
| DESCRIPTION |
| "A compliance statement defined in a previous version of |
| this MIB module, for SNMP entities which have network |
| interfaces." |
| |
| MODULE -- this module |
| MANDATORY-GROUPS { ifGeneralInformationGroup, ifStackGroup2, |
| ifCounterDiscontinuityGroup } |
| |
| GROUP ifFixedLengthGroup |
| DESCRIPTION |
| "This group is mandatory for all network interfaces which |
| are character-oriented or transmit data in fixed-length |
| transmission units." |
| |
| GROUP ifHCFixedLengthGroup |
| DESCRIPTION |
| "This group is mandatory only for those network interfaces |
| which are character-oriented or transmit data in fixed- |
| length transmission units, and for which the value of the |
| corresponding instance of ifSpeed is greater than 20,000,000 |
| bits/second." |
| |
| GROUP ifPacketGroup |
| DESCRIPTION |
| "This group is mandatory for all network interfaces which |
| are packet-oriented." |
| |
| GROUP ifHCPacketGroup |
| DESCRIPTION |
| "This group is mandatory only for those network interfaces |
| which are packet-oriented and for which the value of the |
| corresponding instance of ifSpeed is greater than |
| 650,000,000 bits/second." |
| |
| GROUP ifRcvAddressGroup |
| DESCRIPTION |
| "The applicability of this group MUST be defined by the |
| media-specific MIBs. Media-specific MIBs must define the |
| exact meaning, use, and semantics of the addresses in this |
| group." |
| |
| OBJECT ifLinkUpDownTrapEnable |
| MIN-ACCESS read-only |
| DESCRIPTION |
| "Write access is not required." |
| |
| OBJECT ifPromiscuousMode |
| MIN-ACCESS read-only |
| DESCRIPTION |
| "Write access is not required." |
| |
| OBJECT ifStackStatus |
| SYNTAX INTEGER { active(1) } -- subset of RowStatus |
| MIN-ACCESS read-only |
| DESCRIPTION |
| "Write access is not required, and only one of the six |
| enumerated values for the RowStatus textual convention need |
| be supported, specifically: active(1)." |
| |
| OBJECT ifAdminStatus |
| SYNTAX INTEGER { up(1), down(2) } |
| MIN-ACCESS read-only |
| DESCRIPTION |
| "Write access is not required, nor is support for the value |
| testing(3)." |
| |
| OBJECT ifAlias |
| MIN-ACCESS read-only |
| DESCRIPTION |
| "Write access is not required." |
| ::= { ifCompliances 2 } |
| |
| END |
