| | | | | | |
| |
| |
|
| |
| |
| | |
( status | indexes | columns )
|
( section | top )
|
| |
| | Description |
| |
A list of interface entries. The number of entries
is given by the value of ifNumber.
|
| |
| | | Status: | current |
| | | Row Entry: | ifEntry |
| |
| | | Indexes: |
| | | |
|
| |
| | | Columns: |
| | | |
|
| |
| |
| | |
( status | indexes | columns )
|
( section | top )
|
| |
| | 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.
|
| |
| | | Status: | current |
| | | Row Entry: | ifXEntry |
| | | Augments: | ifEntry |
| |
| | | Columns: |
| | | |
|
| |
| |
| | |
( status | indexes | columns )
|
( section | top )
|
| |
| | 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
|
| |
| | | Status: | current |
| | | Row Entry: | ifStackEntry |
| |
| | | Indexes: |
| | | |
|
| |
| | | Columns: |
| | | |
|
| |
| |
| | |
( status | indexes | columns )
|
( section | top )
|
| |
| | 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.
|
| |
| | | Status: | current |
| | | Row Entry: | ifRcvAddressEntry |
| |
| | | Indexes: |
| | | |
|
| |
| | | Columns: |
| | | |
|
| |
| |
| | |
( status | indexes | columns )
|
( section | top )
|
| |
| | 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.
|
| |
| | | Status: | deprecated |
| | | Row Entry: | ifTestEntry |
| | | Augments: | ifEntry |
| |
| | | Columns: |
| | | |
|
| |
| | | | | | |
| |
| |
|
| |
| |
| | |
( status | access | type | syntax )
|
( section | top )
|
| |
| | 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.
|
| |
| | | Table: | ifTable |
| | | Indexing: | ifTable, ifRcvAddressTable |
| | | Status: | current |
| | | Access: | read-only |
| |
| | | Type: | Integer32 |
| | | Syntax: | IF-MIB.InterfaceIndex |
| |
| |
| | |
( status | access | type | syntax )
|
( section | top )
|
| |
| | 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.
|
| |
| | | Table: | ifTable |
| | | Status: | current |
| | | Access: | read-only |
| |
| | | Type: | OCTET STRING |
| | | Syntax: | SNMPv2-TC.DisplayString
(SIZE
(0..255)
)
|
| |
| |
| | |
( status | access | type | syntax )
|
( section | top )
|
| |
| | 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.
|
| |
| | | Table: | ifTable |
| | | Status: | current |
| | | Access: | read-only |
| |
| | | Type: | INTEGER |
| | | Syntax: | IANAifType-MIB.IANAifType |
| |
| |
| | |
( status | access | type | syntax )
|
( section | top )
|
| |
| | 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.
|
| |
| | | Table: | ifTable |
| | | Status: | current |
| | | Access: | read-only |
| |
| | | Type: | Integer32 |
| | | Syntax: | Integer32 |
| |
| |
| | |
( status | access | type | syntax )
|
( section | top )
|
| |
| | 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.
|
| |
| | | Table: | ifTable |
| | | Status: | current |
| | | Access: | read-only |
| |
| | | Type: | Gauge32 |
| | | Syntax: | Gauge32 |
| |
| |
| | |
( status | access | type | syntax )
|
( section | top )
|
| |
| | 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.
|
| |
| | | Table: | ifTable |
| | | Status: | current |
| | | Access: | read-only |
| |
| | | Type: | OCTET STRING |
| | | Syntax: | SNMPv2-TC.PhysAddress |
| |
| |
| | |
( status | access | type | syntax )
|
( section | top )
|
| |
| | 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).
|
| |
| | | Table: | ifTable |
| | | Status: | current |
| | | Access: | read-write |
| |
| | | Type: | INTEGER |
| | | Syntax: | INTEGER
| { | |
| | up(1), |
| | down(2), |
| | testing(3) |
| } | |
|
| |
| |
| | |
( status | access | type | syntax )
|
( section | top )
|
| |
| | 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.
|
| |
| | | Table: | ifTable |
| | | Status: | current |
| | | Access: | read-only |
| |
| | | Type: | INTEGER |
| | | Syntax: | INTEGER
| { | |
| | up(1), |
| | down(2), |
| | testing(3), |
| | unknown(4), |
| | dormant(5), |
| | notPresent(6), |
| | lowerLayerDown(7) |
| } | |
|
| |
| |
| | |
( status | access | type | syntax )
|
( section | top )
|
| |
| | 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.
|
| |
| | | Table: | ifTable |
| | | Status: | current |
| | | Access: | read-only |
| |
| | | Type: | TimeTicks |
| | | Syntax: | TimeTicks |
| |
| |
| | |
( status | access | type | syntax )
|
( section | top )
|
| |
| | 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.
|
| |
| | | Table: | ifTable |
| | | Status: | current |
| | | Access: | read-only |
| |
| | | Type: | Counter32 |
| | | Syntax: | Counter32 |
| |
| |
| | |
( status | access | type | syntax )
|
( section | top )
|
| |
| | 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.
|
| |
| | | Table: | ifTable |
| | | Status: | current |
| | | Access: | read-only |
| |
| | | Type: | Counter32 |
| | | Syntax: | Counter32 |
| |
| |
| | |
( status | access | type | syntax )
|
( section | top )
|
| |
| | 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.
|
| |
| | | Table: | ifTable |
| | | Status: | deprecated |
| | | Access: | read-only |
| |
| | | Type: | Counter32 |
| | | Syntax: | Counter32 |
| |
| |
| | |
( status | access | type | syntax )
|
( section | top )
|
| |
| | 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.
|
| |
| | | Table: | ifTable |
| | | Status: | current |
| | | Access: | read-only |
| |
| | | Type: | Counter32 |
| | | Syntax: | Counter32 |
| |
| |
| | |
( status | access | type | syntax )
|
( section | top )
|
| |
| | 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.
|
| |
| | | Table: | ifTable |
| | | Status: | current |
| | | Access: | read-only |
| |
| | | Type: | Counter32 |
| | | Syntax: | Counter32 |
| |
| |
| | |
( status | access | type | syntax )
|
( section | top )
|
| |
| | 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.
|
| |
| | | Table: | ifTable |
| | | Status: | current |
| | | Access: | read-only |
| |
| | | Type: | Counter32 |
| | | Syntax: | Counter32 |
| |
| |
| | |
( status | access | type | syntax )
|
( section | top )
|
| |
| | 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.
|
| |
| | | Table: | ifTable |
| | | Status: | current |
| | | Access: | read-only |
| |
| | | Type: | Counter32 |
| | | Syntax: | Counter32 |
| |
| |
| | |
( status | access | type | syntax )
|
( section | top )
|
| |
| | 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.
|
| |
| | | Table: | ifTable |
| | | Status: | current |
| | | Access: | read-only |
| |
| | | Type: | Counter32 |
| | | Syntax: | Counter32 |
| |
| |
| | |
( status | access | type | syntax )
|
( section | top )
|
| |
| | 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.
|
| |
| | | Table: | ifTable |
| | | Status: | deprecated |
| | | Access: | read-only |
| |
| | | Type: | <