cc/td/doc/product/software/ios11
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Interface Configuration Commands

Interface Configuration Commands

This chapter contains the commands used to configure nonprotocol-specific features. The commands are in alphabetical order. For hardware technical descriptions and for information about installing the access server interfaces, refer to the hardware installation and maintenance publication for your product.

For interface configuration tasks and examples, refer to the Access and Communication Servers Configuration Guide.

backup delay

To define how much time should elapse before a secondary line is set up or taken down after a primary line transition, use the backup delay interface configuration command. Use the no form of this command to remove the definition.

backup delay {enable-delay | never} {disable-delay | never}
no backup delay {enable-delay | never} {disable-delay | never}
Syntax Description
enable-delay Integer argument that specifies the delay in seconds after the primary line goes down before the secondary line is activated
disable-delay Integer argument that specifies the delay in seconds after the primary line goes up before the secondary line is deactivated
never Keyword that is specified to prevent the secondary line from being activated or deactivated
Default

A secondary line is never activated nor deactivated.

Command Mode

Interface configuration

Usage Guidelines

When a primary line goes down, the access server delays the number of seconds defined by the enable-delay argument before enabling the secondary line. If, after the delay period, the primary line is still down, the secondary line is activated.

When a primary line comes back up, the access server will delay by the number of seconds defined by the disable-delay argument.

In cases where there are spurious signal disruptions that might appear as intermittent lost carrier signals, it is recommended that some delay be enabled before activating and deactivating a secondary.

The interval configured with the backup delay command does not affect the operation of the backup load command.

Example

The following example sets a 10-second delay on deactivating the secondary line; however, the line is activated immediately:

interface serial 0
backup delay 0 10

backup interface

To configure the serial interface as a secondary, or dial backup line, use the backup interface interface configuration command. Use the no form of this command with the appropriate serial port designation to turn this feature off.

backup interface interface-name
no backup interface interface-name
Syntax Description
interface-name or type Serial port to be set as the secondary interface line
Default

None

Command Mode

Interface configuration

Example

The following example sets serial interface 1 as the backup line to serial interface 0:

interface serial 0
backup interface serial 1
Related Command

down-when-looped

backup load

To set the traffic load thresholds for dial backup service, use the backup load interface configuration command. Use the no form of this command to remove the setting.

backup load {enable-threshold | never} {disable-load | never}
no backup load {
enable-threshold | never} {disable-load | never}
Syntax Description
enable-threshold Integer argument that specifies a percentage of the primary line's available bandwidth
disable-load Integer argument that specifies a percentage of the primary line's available bandwidth
never Keyword that sets the secondary line to never be activated due to load
Default

The secondary line is never activated due to load.

Command Mode

Interface configuration

Usage Guidelines

When the transmitted or received load on the primary line is greater than the value assigned to the enable-threshold argument, the secondary line is enabled.

When the transmitted load on the primary line plus the transmitted load on the secondary line is less than the value entered for the disable-load argument, and the received load on the primary line plus the received load on the secondary line is less than the value entered for the disable-load argument, the secondary line is disabled.

If the never keyword is used instead of an enable-threshold value, the secondary line is never activated because of load. If the never keyword is used instead of an disable-load value, the secondary line is never deactivated because of load.

Example

The following example sets the traffic load threshold to 60 percent on the primary line. When that load is exceeded, the secondary line is activated, and will not be deactivated until the combined load is less than 5 percent of the primary bandwidth.

interface serial 0
backup load 60 5

bandwidth

To set a bandwidth value for an interface, use the bandwidth interface configuration command. Use the no form of this command to restore the default values.

bandwidth kilobits
no bandwidth
Syntax Description
kilobits Intended bandwidth in kilobits per second. For a full bandwidth DS3, enter the value 44736.
Default

Default bandwidth values are set during startup.

Command Mode

Interface configuration

Usage Guidelines

Bandwidth values can be displayed with the EXEC command show interfaces.

The bandwidth command sets an informational parameter only; you cannot adjust the actual bandwidth of an interface with this command. For some media, such as Ethernet, the bandwidth is fixed; for other media, such as serial lines, you can change the actual bandwidth by adjusting hardware. For both classes of media, you can use the bandwidth configuration command to communicate the current bandwidth to the higher-level protocols.

Additionally, IGRP uses the minimum path bandwidth to determine a routing metric. The TCP protocol adjusts initial retransmission parameters based on the apparent bandwidth of the outgoing interface.

At higher bandwidths, the value you configure with the bandwidth command is not what is displayed by the show interface command. The value shown is that used in IGRP updates and also used in computing load.


Note This is a routing parameter only; it does not affect the physical interface.
Example

The following example sets the full bandwidth for DS3 transmissions:

interface serial 0
bandwidth 44736

clear counters

To clear the interface counters, use the clear counters EXEC command.

clear counters [type number]
Syntax Description
type (Optional) Specifies the interface type; it is one of the keywords listed in Table 6-1.
number (Optional) Specifies the interface counter displayed with the show interfaces command.

Table  6-1: Clear Counters Interface Type Keywords
Keyword Interface Type
async Asynchronous serial interface
dialer Dialer interface
ethernet Ethernet interface
loopback Loopback interface
null Null interface
serial Synchronous serial interface
tokenring Token Ring interface
tunnel Tunnel interface
Command Mode

EXEC

Usage Guidelines

This command clears all the current interface counters from the interface unless the optional arguments type-keyword and number are specified to clear only a specific interface type (serial, Ethernet, Token Ring, and so on).


Note This command will not clear counters retrieved using SNMP, but only those seen with the EXEC show interface command.
Example

The following example illustrates how to clear all interface counters:

Router# clear counters
Related Command

show interfaces

clear interface

To reset the hardware logic on an interface, use the clear interface EXEC command.

clear interface type number
Syntax Description
type Specifies the interface type; it is one of the keywords listed in Table 6-2.
number Specifies the port, connector, or interface card number.

Table  6-2: Clear Interface Type Keywords
Keyword Interface Type
async Asynchronous serial interface
ethernet Ethernet interface
loopback Loopback interface
null Null interface
serial Synchronous serial interface
tokenring Token Ring interface
tunnel Tunnel interface
Command Mode

EXEC

Usage Guidelines

Under normal circumstances, you do not need to clear the hardware logic on interfaces.

Example
Router# clear interface async 1

clear line

To return a line to its idle state, enter the clear line privileged EXEC command at the system prompt.

clear line line-number
Syntax Description
line-number Asynchronous line port number assigned with the interface async command
Command Mode

Privileged EXEC

Usage Guidelines

Normally, this command returns the line to its conventional function as a terminal line, with the interface left in a "down" state.

Example

The following example shows how to use the clear line command to return serial interface 5 to its idle state:

clear line 5

clockrate

To configure the clock rate for appliques (connector hardware) on the serial interface of the MCI and SCI cards to an acceptable bit rate, use the clockrate interface configuration command. Use the no form of this command to remove the clock rate if you change the interface from a DCE to a DTE device.

clockrate bps
no clockrate
Syntax Description
bps Desired clock rate in bits per second: 1200, 2400, 4800, 9600, 19200, 34800, 56000, 64000, 72000, 125000, 148000, 500000, 800000, 1000000, 1300000, 2000000, or 4000000
Default

No clock rate

Command Mode

Interface configuration

Usage Guidelines

Be aware that the fastest speeds might not work if your cable is too long, and that speeds faster than 148,000 bits per second are too fast for RS-232 signaling. It is recommended that you only use the synchronous serial RS-232 signal at speeds up to 64,000 bits per second. To permit a faster speed, use an RS-449 or V.35 applique.

Example

The following example sets the clock rate on the first serial interface to 64,000 bits per second:

interface serial 0
clockrate 64000

compress

To configure point-to-point software compression for a LAPB, PPP, and HDLC, use the compress interface configuration command. To disable compression, use the no form of this command.

compress [predictor | stac]
no compress
[predictor | stac]
Syntax Description
predictor Specifies that a predictor compression algorithm will be used on LAPB and PPP encapsulation.
stac Specifies that a Stacker (LZS) compression algorithm will be used on HDLC and PPP encapsulation.
Default

Compression is disabled.

Command Mode

Interface configuration

Usage Guidelines

You can configure point-to-point software compression for all LAPB, point-to-point (PPP), and HDLC encapsulations. Compression reduces the size of frames via lossless data compression. The compression algorithm used is a predictor algorithm (the RAND compression algorithm), which uses a compression dictionary to predict what the next character in the frame will be.

For HDLC encapsulations, you can specify a Stacker compression algorithm by using the stac keyword. PPP and LAPB encapsulations support both predictor and Stacker compression algorithms.

Compression is performed in software and may significantly affect system performance. We recommend that you disable compression if CPU load exceeds 65%. To display the CPU load, use the show process cpu EXEC command.

Compression requires that both ends of the serial link be configured to use compression. You should never enable compression for connections to a public data network.


Note The best performance data compression algorithms "learn", that is, adjust their compression methodology as they discover patterns in the data. For this to work well, no data can be lost, so the compression algorithm is run over LAPB to ensure that everything is sent in order, with no missing data and no duplicate data.

If the majority of your traffic is already compressed files, it is recommended that you not use compression. If the files are already compressed, the additional processing time spent in attempting unsuccessfully to compress them again will slow system performance.

Table 6-3 provides general guidelines for deciding which compression type to select for LAPB encapsulations.


Table  6-3: Compression Guidelines for LAPB Encapsulations
Compression Type to Use Situation
Predictor The bottleneck is the load on the access server.
Stacker The bottleneck is line bandwidth.
None Most files are already compressed.

Stacker compression for LAPB encapsulations reaches its performance ceiling on T1lines; it is not recommended for faster lines because the added processing will slow their performance.

When using predictor compression, you should adjust the MTU for the serial interface and the LAPB N1 parameter as shown in the first example to avoid informational diagnostics regarding excessive MTU or N1 sizes. However, you should not change those parameters when you use Stacker compression.

Example

The following example enables predictor compression on serial interface 0 for a LAPB link:

interface serial 0
encapsulation lapb
compress predictor
mtu 1509
lapb n1 12072

The following example enables Stacker compression on serial interface 0 for a LAPB link. This example does not set the MTU size and the maximum bits per frame (N1); it is recommended that you do not change those LAPB parameters for Stacker compression:

interface serial 0
encapsulation lapb
compress predictor
Related Commands

A dagger (+) indicates that the command is documented in another chapter.

encapsulation lapb+
encapsulation lapb-dce
encapsulation
multi-lapb
encapsulation multi-lapb-dce
encapsulation x25 +
show compress
show processes
+

delay

To set a delay value for an interface, use the delay interface configuration command. Use the no form of this command to restore the default delay value.

delay tens-of-microseconds
no delay
Syntax Description
tens-of-microseconds Integer that specifies the delay in tens of microseconds for an interface or network segment
Default

You can display default delay values with the EXEC command show interfaces.

Command Mode

Interface configuration

Example

The following example sets a 30,000-microsecond delay on serial interface 3:

interface serial 3
delay 30000
Related Command

show interfaces

description

To add a description to an interface configuration, use the description interface configuration command. Use the no form of this command to remove the description.

description string
no description
Syntax Description
string Comment or description to help you remember what is attached to this interface
Default

None

Command Mode

Interface configuration

Usage Guidelines

The description command is meant solely as a comment to be put in the configuration to help you remember what certain interfaces are used for. The description appears in the output of the following EXEC commands: show startup-config, show interfaces, and show running-config.

Example

The following example describes a 3174 controller on serial interface 0:

interface serial 0
description 3174 Controller for test lab
Related Commands

A dagger (+) indicates that the command is documented in another chapter.

show interfaces
show running-config
+
show startup-config +

down-when-looped

To configure an interface to inform the system it is down when loopback is detected, use the
down-when-looped interface configuration command.

down-when-looped
Syntax Description

This command has no arguments or keywords.

Default

Disabled

Command Mode

Interface configuration

Usage Guidelines

This command is valid for PPP encapsulation on serial and HSSI interfaces.

When an interface has a backup interface configured, it is often desirable that the backup interface be enabled when the primary interface is either down or in loopback. By default, the backup is only enabled if the primary interface is down. By using the down-when-looped command, the backup interface will also be enabled if the primary interface is in loopback.

If testing an interface with the loopback command, or by placing the DCE into loopback, down-when-looped should not be configured; otherwise packets will not be transmitted out the interface that is being tested.

Example

In the following example, serial interface 0 is configured for PPP encapsulation. It is then configured to let the system know that it is down when in loopback mode.

interface serial 0
encapsulation ppp
down-when-looped
Related Commands

backup interface
loopback

early-token-release

To enable early token release, use the early-token-release interface configuration command. Use the no form of this command to disable this feature.

early-token-release
no early-token-release
Syntax Description

This command has no arguments or keywords.

Default

Disabled

Command Mode

Interface configuration

Usage Guidelines

This feature helps to increase the total bandwidth of the Token Ring. Early token release is a method whereby the Token Ring interfaces can release the token back onto the ring immediately after transmitting rather than waiting for the frame to return.

The CSC-R16M, CSC-2R, and CSC-1R cards support early token release.

Example

The following example enables the use of early token release on Token Ring interface 1:

interface tokenring 1
early-token-release

encapsulation

To set the encapsulation method used by the interface, use the encapsulation interface configuration command.

encapsulation encapsulation-type
Syntax Description
encapsulation-type Encapsulation type. See Table 6-4 for a list of supported encapsulation types.

Table  6-4: Encapsulation Type Keywords
Keyword Encapsulation Type
arpa This encapsulation uses a 16-bit protocol type code.
bfex25 Blacker Front End Encryption X.25 operation (for serial interface)
ddnx25-dce DDN X.25 DCE operation (for serial interface)
ddnx25 DDN X.25 DTE operation (for serial interface)
frame-relay Frame Relay (for serial interface)
hdlc High-Level Data Link Control (HDLC) protocol for serial interface. This encapsulation method provides the synchronous framing and error detection functions of HDLC without windowing or retransmission.
sap IEEE 802.3 encapsulation. In this encapsulation, the type code becomes the frame length for the IEEE 802.2 LLC encapsulation (destination and source Service Access Points and a control byte).
lapb X.25 LAPB DTE operation (for serial interface)
lapb-dce X.25 LAPB DCE operation (for serial interface)
multip-lapb X.25 LAPB multiprotocol DTE operation (for serial interface)
multi-lapb-dce X.25 LAPB multiprotocol DCE operation (for serial interface)
ppp Point-to-Point Protocol (PPP) (for serial interface)
smds Switched Multimegabit Data Services (SMDS) (for serial interface)
snap IEEE 802.2 Ethernet media. This encapsulation is specified in RFC 1042 and allows Ethernet protocols to run on IEEE 802.2 media.
x25-dce X.25 DCE operation (for serial interface)
x25 X.25 DTE operation (for serial interface)
Default

The default depends on the type of interface. For example, an Ethernet interface defaults to ARPA.

Command Mode

Interface configuration

Examples

The following example reenables standard Ethernet Version 2.0 encapsulation on Ethernet interface 0:

interface ethernet 0
encapsulation arpa

The following example sets IEEE 802.3 encapsulation on Ethernet interface 1:

interface ethernet 1
encapsulation sap

The following example enables PPP encapsulation on serial interface 0:

interface serial 0
encapsulation ppp

The following example sets IEEE 802.2 encapsulation on Ethernet interface 1:

interface ethernet 1
encapsulation snap
Related Commands

A dagger (+) indicates that the command is documented in another chapter.

keepalive
ppp +
physical-layer
slip +

error-threshold

To set the mechanism that protects against packet overload and resulting recount errors on the MCI interface cards, use the error-threshold interface configuration command.

error-threshold milliseconds
Syntax Description
milliseconds Frequency at which the error recount will be set in milliseconds
Default

1000 milliseconds

Command Mode

Interface configuration

Example

The following commands set the error recount threshold on Ethernet interface 2 to 10,000 milliseconds:

interface ethernet 2
error-threshold 10000

group-range

To create a list of member asynchronous interfaces (associated with a group interface), use the group-range command. Use the no form of the command to remove an interface from the member list.

group-range low-end-of-range high-end-of-range
no group-number interface
Syntax Description
low-end-of-range The beginning interface number to be made a member of the group interface.
high-end-of-range The ending interface number to be made a member of the group interface.
interface The interface number to add to the group.
Default

No interfaces are designated as members of a group.

Command Mode

Interface configuration

Usage Guidelines

Using the group-range command, you create a group of asynchronous interfaces that are associated with a group asynchronous interface on the same device. This group interface is configured by using the interface group-async command. This one-to-many structure allows you to configure all associated member interfaces by entering one command on the group interface, rather than entering this command on each interface. You can customize the configuration on a specific interface by using the member command.

Examples

The following example defines interfaces 2, 3, 4, 5, 6, and 7 as members of asynchronous group interface 0:

interface group-async 0
group range 2 7 
Related Commands

interface group-async
member

half-duplex controlled-carrier

To place a low-speed serial interface in controlled-carrier mode, instead of constant-carrier mode, use the half-duplex controlled-carrier interface configuration command. Use the no form of this command to return the interface to constant-carrier mode.

half-duplex controlled-carrier
no half-duplex controlled-carrier
Syntax Description

This command has no arguments or keywords.

Default

Constant-carrier mode, where DCD is held constant and asserted by the DCE half-duplex interface.

Command Mode

Interface Configuration

Usage Guidelines

This command applies only to low-speed serial DCE interfaces in half-duplex mode. Configure a serial interface for half-duplex mode by using the media-type half-duplex command. These interfaces are available on Cisco 2520 through 2523 routers.

Controlled-carrier operation means that the DCE interface will have DCD de-asserted in the quiescent state. When the interface has something to transmit, it will assert DCD, wait a user-configured amount of time, then start the transmission. When the interface has finished transmitting, it will again wait a user configured amount of time, then deassert DCD.

An interface placed in controlled-carrier mode can be returned to constant-carrier mode by using the no form of the command.

Examples

The following examples show how to place the interface in controlled-carrier mode and back into constant-carrier operation.

Changing to controlled-carrier mode from the default of constant-carrier operation:

Router(config)# interface serial 2
Router(config-if)# half-duplex controlled-carrier

Changing to constant-carrier operation from controlled-carrier mode:

Router(config)# interface serial 2
Router(config-if)# no half-duplex controlled-carrier
Related Commands

half-duplex timer
physical-layer

half-duplex timer

To tune half-duplex timers, use the half-duplex timer interface configuration command. The half-duplex timer cts-delay command replaces the sdlc cts-delay command. The half-duplex timer rts-timeout command replaces the sdlc rts-timeout command. Use the no form of this command, along with the appropriate keyword, to return to the default value for that parameter.

You can configure more than one of these options, but each option must be specified as a separate command.

half-duplex timer {cts-delay value | cts-drop-timeout value | dcd-drop-delay value | dcd-txstart-delay value | rts-drop-delay value | rts-timeout value | transmit-delay value} no half-duplex timer {cts-delay value | cts-drop-timeout value | dcd-drop-delay value | dcd-txstart-delay value | rts-drop-delay value | rts-timeout value | transmit-delay value}
Syntax Description
cts-delay value Specifies the delay introduced by the DCE interface between the time it detects RTS to the time it asserts CTS in response. The range is dependent on the serial interface hardware. The default value is 0 ms.
cts-drop-timeout value Determines the amount of time a DTE interface waits for CTS to be de-asserted after it has de-asserted RTS. If CTS is not de-asserted during this time, an error counter is incremented to note this event. The range is 0 to 1140000 ms (1140 seconds). The default value is 250 ms.
dcd-drop-delay value Applies to DCE half-duplex interfaces operating in controlled-carrier mode (see the half-duplex controlled-carrier command). This timer determines the delay between the end of transmission by the DCE and the de-assertion of DCD. The range is 0 to 4400 ms (4.4 seconds). The default value is 100 ms.
dcd-txstart-delay value Applies to DCE half-duplex interfaces operating in controlled-carrier mode. This timer determines the time delay between the assertion of DCD and the start of data transmission by the DCE interface. The range is 0 to 1140000 ms (1140 seconds). The default value is 100 ms.
rts-drop-delay value Specifies the time delay between the end of transmission by the DTE interface and de-assertion of RTS. The range is 0 to 1140000 ms (1140 seconds). The default value is 3 ms.
rts-timeout value Determines the number of ms the DTE waits for CTS to be asserted after the assertion of RTS before giving up on its transmission attempt. If CTS is not asserted in the specified amount of time, an error counter is incremented. The range is dependent on the serial interface hardware. The default value is 3 ms.
transmit-delay value Specifies the number of ms a half-duplex interface will delay the start of transmission. In the case of a DTE interface, this delay specifies how long the interface waits after something shows up in the transmit queue before asserting RTS. For a DCE interface, this dictates how long the interface waits after data is placed in the transmit queue before starting transmission. If the DCE interface is in controlled-carrier mode, this delay shows up as a delayed assertion of DCD.

This timer enables the transmitter to be adjusted if the receiver is a little slow and is not able to keep up with the transmitter. The range is 0 to 4400 ms (4.4 seconds). The default value is 0 ms.

Default

The default cts-delay value is 0 ms.

The default cts-drop-timeout value is 250 ms.

The default dcd-drop-delay value is 100 ms.

The default dcd-txstart-delay value is 100 ms.

The default rts-drop-delay value is 3 ms.

The default rts-timeout value is 3 ms.

The default transmit-delay value is 0 ms.

Command Mode

Interface configuration

Usage Guidelines

The half-duplex timer command is used to tune half-duplex timers. These timer tuning commands permit you to adjust the timing of the half-duplex state machines to suit the particular needs of their half-duplex installation.

The range of values for the cts-delay and rts-timeout keywords are dependent on the serial interface hardware.

Examples

The following examples show how to set the cts-delay timer to 10 ms and the transmit-delay timer to 50 ms.

Cobra(config)# interface serial 2
Cobra(config-if)# half-duplex timer cts-delay 10
Cobra(config-if)# half-duplex timer transmit-delay 50
Related Commands

half-duplex controlled-carrier
physical-layer

hold-queue

To specify the hold-queue limit of an interface, use the hold-queue interface configuration command. Use the no form of this command with the appropriate keyword to restore the default values for an interface.

hold-queue length {in | out}
no hold-queue {in | out}
Syntax Description
length An integer that specifies the maximum number of packets in the queue
in A keyword that specifies the input queue
out A keyword that specifies the output queue
Default

The default input hold-queue limit is 75 packets. The default output hold-queue limit is 40 packets. These limits prevent a malfunctioning interface from consuming an excessive amount of memory. There is no fixed upper limit to a queue size.

Command Mode

Interface configuration

Usage Guidelines

The input hold queue prevents a single interface from flooding the network server with too many input packets. Further input packets are discarded if the interface has too many input packets outstanding in the system.

If priority output queueing is being used, the length of the four output queues is set using the priority-list global configuration command. The hold-queue command cannot be used to set an output hold queue length in this situation.

For slow links, use a small output hold-queue limit. This approach prevents storing packets at a rate that exceeds the transmission capability of the link. For fast links, use a large output hold-queue limit. A fast link may be busy for a short time (and thus require the hold queue), but can empty the output hold queue quickly when capacity returns.

To display the current hold queue setting and the number of packets discarded because of hold queue overflows, use the EXEC command show interfaces.


Note Increasing the hold queue can have detrimental effects on network routing and response times. For protocols that use seq/ack packets to determine round trip times, do not increase the output queue. Dropping packets instead informs hosts to slow down transmissions to match available bandwidth. This is generally better than having duplicate copies of the same packet within the network (which can happen with large hold queues).
Example

The following example illustrates how to set a small input queue on a slow serial line:

interface serial 0
hold-queue 30 in
Related Command

show interfaces

ignore-dcd

Use the ignore-dcd interface configuration command to configure the serial interface to monitor the DSR signal (instead of the DCD signal) as the line up/down indicator. Use the no form of this command to restore the default behavior.

ignore-dcd
no ignore-dcd
Syntax Description

This command has no arguments or keywords.

Default

The serial interface, operating in DTE mode, monitors the DCD signal as the line up/down indicator.

Command Mode

Interface configuration

Usage Guidelines

This command applies to Quad Serial NIM interfaces on the Hitachi-based serial interfaces on the Cisco 2500 series.

When the serial interface is operating in DTE mode, it monitors the Data Carrier Detect (DCD) signal as the line up/down indicator. By default, the attached DCE device sends the DCD signal. When the DTE interface detects the DCD signal, it changes the state of the interface to up.

In some configurations, such as an SDLC multidrop environment, the DCE device sends the Data Set Ready (DSR) signal instead of the DCD signal, which prevents the interface from coming up. Use this command to tell the interface to monitor the DSR signal instead of the DCD signal as the line up/down indicator.

Example

The following example configures serial interface 0 to monitor the DSR signal as the line up/down indicator:

interface serial 0
ignore-dcd

interface

To configure an interface type and enter interface configuration mode, use the interface global configuration command.

interface type number

To configure a subinterface, use the interface global configuration command.

interface type number.subinterface-number [multipoint | point-to-point]
Syntax Description
type Type of interface to be configured. See Table 6-5.
number Port, connector, or interface card number. The numbers are assigned at the factory at the time of installation or when added to a system, and can be displayed with the show interfaces command.
.subinterface-number Subinterface number in the range 1 to 4294967293. The number that precedes the period (.) must match the number to which this subinterface belongs.
multipoint | point-to-point (Optional) Specifies a multipoint or point-to-point subinterface. There is no default.

Table  6-5: Interface Type Keywords
Keyword Interface Type
async Line used as an asynchronous interface.
dialer Refer to the interface dialer command.
ethernet Ethernet IEEE 802.3 interface.
group-async Refer to the interface group-async command.
loopback Software-only loopback interface that emulates an interface that is always up. It is a virtual interface supported on all platforms. The interface-number is the number of the loopback interface that you want to create or configure.There is no limit on the number of loopback interfaces you can create.
null Null interface.
serial Serial interface.
tokenring Token Ring interface.
tunnel Tunnel interface; a virtual interface. The interface-number is the number of the tunnel interface that you want to create or configure. There is no limit on the number of tunnel interfaces you can create.
Default

The default mode for subinterfaces is multipoint.

Command Mode

Global configuration

Usage Guidelines

Subinterfaces can be configured to support partially meshed Frame Relay networks and multiple IPX encapsulations on LAN media (refer to the Access and Communication Servers Configuration Guide).

Examples

In the following example, serial interface 0 is configured with PPP encapsulation:

interface serial 0
encapsulation ppp

The following example enables loopback mode and assigns an IP network address and network mask to the interface. The loopback interface established here will always appear to be up:

interface loopback 0
ip address 172.30.1.1 255.255.255.0

The following example shows how a partially meshed Frame Relay network can be configured. In this example, subinterface serial 0.1 is configured as a multipoint subinterface with three Frame Relay PVCs associated, and subinterface serial 0.2 is configured as a point-to-point subinterface.

interface serial 0
encapsulation frame-relay
interface serial 0.1 multipoint
ip address 172.30.10.1 255.255.255.0
frame-relay interface-dlci 42 broadcast
frame-relay interface-dlci 53 broadcast
interface serial 0.2 point-to-point
ip address 172.30.11.1 255.255.0
frame-relay interface-dlci 59 broadcast
Related Commands

Two daggers (++) indicate that the command is documented in the Cisco Access Connection Guide.

ppp ++
show interfaces
slip ++

interface dialer

To designate a dialer rotary group leader, use the interface dialer global configuration command.

interface dialer interface-number
Syntax Description
interface-number Integer that you select to indicate a dialer rotary group in the range 0 to 9
Default

None

Command Mode

Global configuration

Usage Guidelines

Dialer rotary groups allow you to apply a single interface configuration to a set of interfaces. Once the interface configuration is propagated to a set of interfaces, those interfaces can be used to place calls using the standard dial-on-demand criteria. When many destinations are configured, any of these interfaces can be used for outgoing calls.

Dialer rotary groups are useful in environments that require many calling destinations. Only the rotary group needs to be configured with all of the dialer map commands. The only configuration required for the interfaces is the dialer rotary-group command indicating that each interface is part of a dialer rotary group.

Although a dialer rotary group is configured as an interface, it is not a physical interface. Instead it represents a group of interfaces. Any number of dialer groups can be defined.

Interface configuration commands entered after the interface dialer command will be applied to all physical interfaces assigned to specified rotary group.

Example

The following example identifies dialer interface 1 as the dialer rotary group leader. Dialer interface 1 is not a physical interface, but represents a group of interfaces. The interface configuration commands that follow apply to all interfaces included in this group.

interface dialer 1
encapsulation ppp
dialer in-band
dialer map ip 172.30.2.5 username YYY 14155553434
dialer map ip 172.30.4.5 username ZZZ
Related Command

A dagger (+) indicates that the command is documented in another chapter.

dialer rotary-group +

interface group-async

To create a group interface that will serve as master, to which asynchronous interfaces can be associated as members, use the interface group-async command. Use the no form of the command to restore the default.

interface group-async unit-number
no interface group-async unit-number
Syntax Description
unit-number The number of the asynchronous group interface being created.
Default

No interfaces are designated as group masters.

Command Mode

Global configuration

Usage Guidelines

Using the interface group-async command, you create a single asynchronous interface to which other interfaces are associated as members using the group-range command. This one-to-many configuration allows you to configure all associated member interfaces by entering one command on the group master interface, rather than entering this command on each individual interface. You can create multiple group masters on a device; however, each member interface can only be associated with one group.

Examples

The following example defines asynchronous group master interface 0:

interface group-async 0
Related Commands

group-range
member

ip address-pool

To enable the global default address-pooling mechanism used to supply IP addresses on dial-in asynchronous, synchronous, or ISDN point-to-point interfaces, use the ip address-pool global configuration command. To disable IP address pooling globally on all interfaces with the default configuration, use the no form of the command.

ip address-pool [dhcp-proxy-client | local]
no ip address-pool
Syntax Description
dhcp-proxy-client Use the router as the proxy-client between a third-party Dynamic Host Configuration Protocol (DHCP) server and peers connecting to the router.
local Use the local address pool named default.
Default

IP address pooling is disabled.

Command Mode

Global configuration

Usage Guidelines

The Global Default Mechanism applies to all interfaces that have been left in their default setting of peer default ip address pool.

If any peer default ip address command (other than peer default ip address pool, the default) is configured, then the interface uses that mechanism and not the Global Default Mechanism. Thus all interfaces can be independently configured or left unconfigured so that the Global Default Mechanism setting will apply. This flexibility minimizes the configuration effort on the part of the administrator.

Examples

The following example specifies the DHCP proxy client mechanism as the Global Default Mechanism for assigning peer IP addresses:

ip address-pool dhcp-proxy-client

The following example specifies a local IP address pool called default as the Global Default Mechanism for all interfaces that are left in the default setting:

ip address-pool local
Related Commands

A dagger (+) indicates that the command is documented in another chapter.

encapsulation ppp
encapsulation slip
ip dhcp-server
ip local pool
member peer default ip address
peer default ip address

peer default ip address pool
ppp+
show dhcp
show ip local pool
slip+

ip dhcp-server

To specify which DHCP (Dynamic Host Configuration Protocol) servers to use on your network, specify the IP address of one or more DHCP servers available on the network by using the ip dhcp-server command. Use the no form of the command to remove a DHCP server's IP address.

ip dhcp-server [ip-address | name]
no ip dhcp-server [ip-address | name]
Syntax Description
ip-address IP address of a DHCP server. You can specify up to ten servers on the network.
name Name of a DHCP server. You can specify up to ten servers on the network.
Default

The IP limited broadcast address of 255.255.255.255 is used for transactions if no DHCP server is specified. This allows autodetection of DHCP servers.

Command Mode

Global configuration

Usage Guidelines

A DHCP server temporarily allocates network addresses to clients through the access server on an as-needed basis. While the client is active, the address is automatically renewed in a minimum of 20-minute increments. When the user terminates the session, the interface connection is terminated so that network resources can be quickly reused.

In normal situations, if a user's SLIP/PPP session fails (for example if a modem line disconnects), the allocated address will be temporarily reserved in an attempt to preserve the same IP address for the client when dialed back into the server. This way, the session that was accidentally terminated can often be resumed.

To use the DHCP proxy-client feature, enable your access server to be a proxy-client on asynchronous interfaces by using the ip address-pool dhcp-proxy-client command. If you wish to specify which DHCP servers are used on your network, use the ip dhcp-server command to define up to ten specific DHCP servers.


Note To facilitate transmission, configure intermediary routers (or access servers with router functionality) to use an ip helper address whenever the DHCP server is not on the local LAN and the access server is using broadcasts to interact with the DHCP server. See "Configuring IP" in this publication.

The ip address-pool dhcp-proxy-client command initializes proxy-client status to all interfaces on the access server defined as asynchronous. To selectively disable proxy-client status on a single asynchronous interface, use the no peer default ip address interface command.

Example

The following command specifies a DHCP server with the IP address of 172.30.13.81:

ip dhcp-server 172.30.13.81
Related Commands

A dagger (+) indicates that the command is documented in another chapter.

ip address-pool
ip helper address
+
peer default ip address
show dhcp

ip local pool

To configure a local pool of IP addresses to be used when a remote peer connects to a point-to-point interface, use the ip local pool global configuration command. To delete an address pool, use the no form of this command.

ip local pool {default | poolname low-ip-address [high-ip-address]}
no ip local pool
{default | poolname}
Syntax Description
default Default local address pool that is used if no other pool is named.
poolname Name of a specific local address pool.
low-ip-address Lowest IP address in the pool.
high-ip-address (Optional) Highest IP address in the pool. If this value is omitted only the low-ip-address IP address is included in the local pool. The maximum number of IP addresses per pool is 256.
Default

No address pools are preconfigured.

Command Mode

Global configuration

Usage Guidelines

Use the ip local pool command to create one or more local address pools from which IP addresses are assigned when a peer connects. The default address pool is then used on all point-to-point interfaces after the ip address-pool local global configuration command has been issued. To use a specific named address pool on an interface, use the peer default ip address pool interface configuration command.

These pools can also be used with the translate command for one-step VTY asynchronous connections and in certain AAA/TACACS+ authorization functions. Refer to the chapters "Protocol Translation" and "System Management" of the Access and Communication Configuration Guide for more information. Pools can be displayed with the show ip local pool command.

Example

The following command creates a local IP address pool by the name of quark, which contains all local IP addresses from 172.16.23.0 to 172.16.23.255:

ip local pool quark 172.16.23.0 172.16.23.255 
Related Commands

ip address-pool
show ip local pool

keepalive

Use the keepalive interface configuration command to set the keepalive timer for a specific interface. Use the no form of the command to turn off keepalives entirely.

keepalive [seconds]
no keepalive
[seconds]
Syntax Description
seconds (Optional) Unsigned integer value greater than 0. The default is 10 seconds.
Default

Enabled and set to 10 seconds on most interfaces; disabled on asynchronous interfaces.

Command Mode

Interface configuration

Usage Guidelines

Asynchronous interfaces do not send and do not expect keepalives from the remote end of a point-to-point connection. To enable keepalives on asynchronous interfaces, use the keepalive command and set a specific interval.

You can configure the keepalive interval, which is the frequency at which the access server sends messages to itself (Ethernet and Token Ring) or to the other end (serial), to ensure a network interface is alive. The interval in previous software versions was 10 seconds; it is now adjustable in 1-second increments down to 1 second. An interface is declared down after three update intervals have passed without receiving a keepalive packet.

Setting the keepalive timer to a low value is very useful for rapidly detecting Ethernet interface failures (transceiver cable disconnecting, cable unterminated, and so on).

A typical serial line failure involves losing Carrier Detect (CD). Since this sort of failure is typically noticed within a few milliseconds, adjusting the keepalive timer for quicker routing recovery is generally not useful.


Note When adjusting the keepalive timer for a very low bandwidth serial interface, large datagrams can delay the smaller keepalive packets long enough to cause the line protocol to go down. You might need to experiment to determine the best value.
Example

The following example sets the keepalive interval to 3 seconds:

interface ethernet 0
keepalive 3

loopback remote (interface)

To loop packets through a CSU/DSU, over a DS-3 link or a channelized T1 link, to the remote CSU/DSU and back, use the loopback remote interface configuration command. To remove the loop, use the no form of this command.

loopback remote
no loopback remote
Syntax Description

This command has no arguments or keywords.

Default

Disabled

Command Mode

Interface configuration

Usage Guidelines

This command applies only when the remote CSU/DSU device supports the function. It is used for testing the data communication channels. The loopback usually is performed at the line port, rather than the DTE port, of the remote CSU/DSU.

For a multiport interface processor (MIP) connected to a network via a channelized T1 link, the loopback remote interface configuration command applies if the remote interface is served by a DDS line (56 Kbps or 64 Kbps), and the device at the remote end is a CSU/DSU. In addition, the CSU/DSU at the remote end must react to latched DDS CSU loopback codes. Destinations that are served by other types of lines or that have CSU/DSUs that do not react to latched DDS CSU codes cannot participate in an interface remote loopback. Latched DDS CSU loopback code requirements are described in AT&T specification TR-TSY-000476, "OTGR Network Maintenance Access and Testing."

To show interfaces currently in loopback operation, use the show interfaces loopback EXEC command.

Example

The following example configures a remote loopback test:

interface serial 0
loopback remote
Related Command

show interfaces loopback

loopback dte

To loop packets to DTE internally within the CSU/DSU at the DTE interface, use the loopback interface configuration command. Use the no form of this command to remove the loop.

loopback dte
no loopback dte
Syntax Description

This command has no arguments or keywords.

Default

Disabled

Command Mode

Interface configuration

Example

The following example configures the loopback test on the DTE interface:

interface serial 1
loopback dte

loopback line

To loop packets completely through the CSU/DSU to configure the CSU loop, use the loopback line interface configuration command. Use the no form of this command to remove the loop.

loopback line
no loopback line
Syntax Description

This command has no arguments or keywords.

Default

Disabled

Command Mode

Interface configuration

Usage Guidelines

This command is useful for testing the DCE device (CSU/DSU) itself.

To show interfaces currently in loopback operation, use the show interfaces loopback EXEC command.

Example

The following example configures the loopback test on the DCE device:

interface serial 1
loopback line
Related Command

show interfaces loopback

loopback remote

To loop packets completely through the CSU/DSU, over the DS3 link, to the remote CSU/DSU and back, use the loopback remote interface configuration command. Use the no form of this command to remove the loop.

loopback remote
no loopback remote
Syntax Description

This command has no arguments or keywords.

Default

Disabled

Command Mode

Interface configuration

Usage Guidelines

This command is useful for testing the DCE device (CSU/DSU) itself.

This command applies only when the device supports the remote function. It is used for testing the data communication channels. The loopback usually is performed at the line port, rather than the DTE port, of the remote CSU/DSU.

To show interfaces currently in loopback operation, use the show interfaces loopback EXEC command.

Example

The following example configures a remote loopback test:

interface serial 0
loopback remote
Related Command

show interfaces loopback

media-type

Use the media type command to specify one of the following configurations:

Use the no form of this command to restore the default value. The media-type full-duplex command replaces the bsc fdx command. The media-type half-duplex command replaces the sdlc hdx command.

media-type {aui | 10baset | 100baset | mii | full-duplex | half-duplex}
Syntax Description
aui Specifies a 15-pin physical connection.
10baset Specifies an RJ45 10baseT physical connection.
100baset Specifies an RJ45 100baseT physical connection.
mii Specifies a media-independent interface.
full-duplex Configure a serial interface for full-duplex mode.
half-duplex Configure a serial interface for half-duplex mode.
Defaults

AUI 15-pin physical connection is the default setting on the Cisco 4000 series.

100BaseT physical connection is the default setting on the Cisco 7000 series.

Full-duplex the default mode for serial interfaces.

Half-duplex is the default mode for serial interfaces that are configured for bisynchronous tunneling.

Command Mode

Interface configuration

Examples

The following example specifies an RJ45 10BaseT physical connection to Ethernet interface 1:

interface ethernet 1
media-type 10baset

The following example specifies a media-independent interface physical connection to Fast Ethernet slot 0, port 1 on the Cisco 7000:

interface fastethernet 0/1
media-type mii

The following example specifies full duplex binary synchronous communications (BSC) mode:

interface serial 0
encapsulation bstun
media-type full-duplex

The following example specifies an SDLC interface as half-duplex mode:

interface serial 0
encapsulation sdlc-primary
media-type half-duplex

member

To alter the configuration of an asynchronous interface that is a member of a group, use the member interface configuration command. Use the no form of the command to restore defaults set at the group master interface.

member number interface-command
no member number interface command
Syntax Description
number Number of the asynchronous interface to be altered.
interface-command One or more commands entered for this specific interface. Valid commands are:

· peer default ip address

· description

Default

No individual configurations are set for member interfaces.

Command Mode

Interface configuration

Usage Guidelines

You can customize a member interface by using the member command. (Interfaces are designated as members of a group by using the interface group-async and group-range commands). To restore the defaults set at the group master interface, use the no form of this command.

Examples

The following example defines interface 3 as having a description of line 3, attached to a Hayes Optima modem:

interface group-async 0
member 3 description line #3 Hayes Optima
Related Commands

group-range
interface group-async

mop enabled

To enable an interface to support the Maintenance Operation Protocol (MOP), use the mop enabled interface configuration command. Use the no form of this command to disable MOP on an interface.

mop enabled
no mop enabled
Syntax Description

This command has no arguments or keywords.

Default

Enabled by default on Ethernet interfaces and disabled on all other interfaces.

Command Mode

Interface configuration

Example

In the following example, MOP is enabled for serial interface 0:

interface serial 0
mop enabled
Related Commands

A dagger (+) indicates that the command is documented in another chapter.

mop sysid
mop restransmit-timer
+
mop retries +

mop sysid

To enable an interface to send out periodic Maintenance Operation Protocol (MOP) system identification messages, use the mop sysid interface configuration command. Use the no form of this command to disable MOP message support on an interface.

mop sysid
no mop sysid
Syntax Description

This command has no arguments or keywords.

Default

Enabled

Command Mode

Interface configuration

Usage Guidelines

You can run MOP without having the background system ID messages sent. This lets you use the MOP remote console, but does not generate messages used by the configurator.

Example

In the following example, serial interface 0 is enabled to send MOP system identification messages:

interface serial0
mop sysid
Related Commands

A dagger (+) indicates that the command is documented in another chapter.

mop device-code +
mop enabled

mtu

To adjust the maximum packet size or maximum transmission unit (MTU) size, use the mtu interface configuration command. Use the no form of this command to restore the MTU value to its original default value.

mtu bytes
no mtu
Syntax Description
bytes Desired size in bytes
Default

Table 6-6 lists default MTU values according to media type.


Table  6-6: Default Media MTU Values
Media Type Default MTU
Ethernet 1500
Serial 1500
Token Ring 4464
Command Mode

Interface configuration

Usage Guidelines

Each interface has a default maximum packet size or maximum transmission unit (MTU) size. This number generally defaults to the largest size possible for that type interface. On serial interfaces, the MTU size varies, but cannot be set smaller than 64 bytes.


Note Changing the MTU value with the mtu interface configuration command can affect values for the protocol-specific versions of the command (ip mtu for example). If the values specified with the ip mtu interface configuration command is the same as the value specified with the mtu interface configuration command, and you change the value for the mtu interface configuration command, the ip mtu value automatically matches the new mtu interface configuration command value. However, changing the values for the ip mtu configuration commands has no effect on the value for the mtu interface configuration command.
Example

The following example specifies an MTU of 1000 bytes:

interface serial 1
mtu 1000
Related Commands

A dagger (+) indicates that the command is documented in another chapter.

encapsulation
ip mtu +

peer default ip address

Use the peer default ip address command to specify an IP address, an address from a specific IP address pool, or an address from the DHCP mechanism to be returned to a remote peer connecting to this interface. Use the no form of the command to disable a prior peer IP address pooling configuration on an interface.

peer default ip address {ip-address | dhcp | pool [poolname]}
no peer default ip address
Syntax Description
ipaddress Specific IP address to be assigned to a remote peer dialing in to this interface. To prevent the assignment of duplicate IP addresses on two or more interfaces, this form of the command cannot be applied to a dialer rotary group nor to an ISDN interface.
dhcp Retrieve an IP address from the DHCP server.
pool Use the Global Default Mechanism as defined by the ip address-pool command unless the optional poolname is supplied.
poolname (Optional) Name of a local address pool created using the ip local pool command. Retrieve an address from this pool regardless of the Global Default Mechanism setting.
Default

pool

Command Mode

Interface configuration

Usage Guidelines

This command applies to point-to-point interfaces that support the PPP or SLIP encapsulation.

This command allows an administrator to configure all possible address pooling mechanisms on a interface-by-interface basis.

The peer default ip address command can be used to override on an interface-by-interface basis the Global Default Mechanism defined by the ip address-pool command.

Examples

The following command specifies that this interface will use a local IP address pool called shazam:

peer default ip address pool shazam

The following command specifies that this interface will use the IP address 172.140.34.21:

peer default ip address 172.140.34.21

The following command reenables the Global Default Mechanism to be used on this interface:

peer default ip address pool
Related Commands

A dagger (+) indicates that the command is documented in another chapter.

encapsulation ppp
encapsulation slip
ip address-pool
ip dhcp-server
ip local pool
ppp
+
slip+
show dhcp

physical-layer

To specify the mode of a slow-speed serial interface on a router as either synchronous or asynchronous, use the physical-layer interface configuration command. Use the no form of this command to return the interface to its default mode, which is synchronous.

physical-layer {sync | async}
no physical-layer
Syntax Description
sync Place the interface in synchronous mode.
async Place the interface in asynchronous mode.
Default

Synchronous mode.

Command Mode

Interface Configuration

Usage Guidelines

This command applies only to low-speed serial interfaces available on Cisco 2520 through 2523 routers.

If you specify the no physical-layer command, you return the interface to its default mode (synchronous).

In synchronous mode, low-speed serial interfaces support all interface configuration commands available for high-speed serial interfaces, except the following two commands:

When placed in asynchronous mode, low-speed serial interfaces support all commands available for standard asynchronous interfaces.

When you enter this command, it does not appear in the output of show running config and show startup config commands, because the command is a physical layer command.

Examples

The following examples show different uses of this command.

The following example shows how to change a low-speed serial interface from synchronous asynchronous mode:

Router(config)# interface serial 2
Router(config-if)# physical-layer async

The following examples show how to change a low-speed serial interface from asynchronous mode back to its default synchronous mode:

Router(config)# interface serial 2
Router(config-if)# physical-layer sync
or
Router(config)# interface serial 2
Router(config-if)# no physical-layer

The following example shows some typical asynchronous interface configuration commands:

Router(config)# interface serial 2
Router(config-if)# physical-layer async
Router(config-if)# ip address 1.0.0.2 255.0.0.0 
Router(config-if)# async default ip address 1.0.0.1
Router(config-if)# async mode dedicated
Router(config-if)# async default routing

The following example shows some typical synchronous serial interface configuration commands available when the interface is in synchronous mode:

Router(config)# interface serial 2
Router(config-if)# physical-layer sync
Router(config-if)# ip address 1.0.0.2 255.0.0.0 
Router(config-if)# no keepalive
Router(config-if)# ignore-dcd
Router(config-if)# nrzi-encoding
Router(config-if)# no shutdown
Related Commands

half-duplex controlled-carrier
half-duplex timer

ppp authentication

To enable Challenge Handshake Authentication Protocol (CHAP) or Password Authentication Protocol (PAP), and to enable a TACACS+ authorization method on a serial interface, use the ppp authentication interface configuration command. Use the no form of the command to disable this authentication.

ppp authentication {chap | pap} [if-needed] [listname]
no ppp authentication
Syntax Description
chap Enable CHAP on a serial interface.
pap Enable PAP on a serial interface.
if-needed (Optional) Used with TACACS and Extended TACACS. Do not perform CHAP or PAP authentication if the user has already provided authentication. This option is available only on asynchronous interfaces.
list-name (Optional) Used with AAA/TACACS+. Specify the name of a list of TACACS+ methods of authentication to use. If no listname is specified, the system uses the default. Lists and default are created with the aaa authentication ppp command.
Default

PPP authentication is not enabled.

Command Mode

Interface configuration

Usage Guidelines

Once you have enabled CHAP or PAP, the local access server requires a password from remote devices. If the remote device does not support CHAP or PAP, no traffic will be passed to that device.

If you are using autoselect on a tty line, you will probably want to use the ppp authentication command to turn on PPP authentication for the corresponding interface.

When you specify the if-needed option, PPP authentication is not required when the user has already provided authentication. This option is useful in conjunction with the autoselect command, but cannot be used with AAA/TACACS+.

The list-name keyword can only be used when AAA/TACACS+ has been initialized and cannot be used with the if-needed argument.

Caution If you use a list-name that has not been configured with the aaa authentication ppp command, you disable PPP on this line.
Example

The following example enables CHAP on asynchronous interface 4:

interface async 4
encapsulation ppp
ppp authentication chap
Related Commands

A dagger (+) indicates that the command is documented in another chapter.

aaa authentication ppp+
aaa new-model+
autoselect+
encapsulation
ppp use-tacacs+
username+

ppp quality

To enable Link Quality Monitoring (LQM) on a serial interface, use the ppp quality interface configuration command. Use the no form of this command to disable LQM.

ppp quality percentage
no ppp quality
Syntax Description
percentage Specifies the link quality threshold. The range is 1 to 100.
Default

Disabled

Command Mode

Interface configuration

Usage Guidelines

The percentages are calculated for both incoming and outgoing directions. The outgoing quality is calculated by comparing the total number of packets and bytes sent to the total number of packets and bytes received by the peer. The incoming quality is calculated by comparing the total number of packets and bytes received to the total number of packets and bytes sent by the peer.

If the link quality percentage is not maintained, the link is deemed to be of poor quality and is taken down. The policy implements a time lag so that the link does not bounce up and down.

Example

The following example enables LQM on serial interface 0:

interface serial 0
encapsulation ppp
ppp quality 80
Related Commands

encapsulation
keepalive

pulse-time

To enable pulsing DTR signal intervals on the serial interfaces, use the pulse-time interface configuration command. Use the no form of this command to restore the default interval.

pulse-time seconds
no pulse-time
Syntax Description
seconds Integer that specifies the DTR signal interval in seconds
Default

0 seconds

Command Mode

Interface configuration

Usage Guidelines

When the serial line protocol goes down (for example, because of loss of synchronization) the interface hardware is reset and the DTR signal is held inactive for at least the specified interval. This function is useful for handling encrypting or other similar devices that use the toggling of the DTR signal to resynchronize.

Example

The following example enables DTR pulse signals for three seconds on serial interface 0:

interface serial 0
pulse-time 3

ring-speed

To set the ring speed for the CSC-1R and CSC-2R Token Ring interfaces, use the ring-speed interface configuration command.

ring-speed speed
Syntax Description
speed Integer that specifies the ring speed, either 4 for 4-Mbps or 16 for 16-Mbps operation
Default

16-Mbps operation

Command Mode

Interface configuration

Usage Guidelines
Caution Configuring a ring speed that is wrong or incompatible with the connected Token Ring will cause the ring to beacon, which effectively takes the ring down and makes it nonoperational.
Example

The following example sets a Token Ring interface ring speed to 4 Mbps:

interface tokenring 0
ring-speed 4

scheduler-interval

To control the maximum amount of time that can elapse without running the lowest priority system processes, use the scheduler-interval global configuration command. Use the no form of this command to restore the default.

scheduler-interval milliseconds
no scheduler-interval
Syntax Description
milliseconds An integer that specifies the interval in milliseconds. The minimum interval that you can specify is 500 milliseconds; there is no maximum value.
Default

The default is to allow high-priority operations to use as much of the central processor as needed.

Command Mode

Global configuration

Usage Guidelines

The normal operation of the network server allows the switching operations to use as much of the central processor as is required. If the network is running unusually heavy loads that do not allow the processor the time to handle the routing protocols, give priority to the system process scheduler.

Example

The following example changes the low-priority process schedule to an interval of 750 milliseconds:

scheduler-interval 750

show async status

To list the status of asynchronous interfaces, use the show async status EXEC command:

show async status
Syntax Description

This command has no arguments or keywords.

Command Mode

EXEC

Usage Guidelines

This command shows all asynchronous sessions, whether they are using SLIP or PPP encapsulation.

Sample Display

The following is sample output from the show async status command:

Router> show async status
Async protocol statistics:
  Rcvd: 5448 packets, 7682760 bytes
        1 format errors, 0 checksum errors, 0 overrun, 0 no buffer
  Sent: 5455 packets, 7682676 bytes, 0 dropped
 Int           Local          Remote Qd InPack OutPac Inerr  Drops  MTU Qsz
   1     192.31.7.84         Dynamic  0      0      0     0      0 1500  10

Table 6-7 describes significant fields shown in the display.


Table  6-7: Asynchronous Statistics Display Field Descriptions
Field Description
Rcvd Statistics on packets received.
5548 packets Packets received.
7682760 bytes Total number of bytes.
1 format errors Packets with a bad IP header, even before the checksum is calculated.
0 checksum errors Count of checksum errors.
0 overrun Number of giants received.
0 no buffer Number of packets received when no buffer was available.
Sent Statistics on packets sent.
5455 packets Packets sent.
7682676 bytes Total number of bytes.
0 dropped Number of packets dropped.
Int Interface number.
* Line currently in use.
Local Local IP address on the link.
Remote Remote IP address on the link; "Dynamic" indicates that a remote address is allowed but has not been specified; "None" indicates that no remote address is assigned or being used.
Qd Number of packets on hold queue (Qsz is max).
InPack Number of packets received.
OutPac Number of packets sent.
Inerr Number of total input errors; sum of format errors, checksum errors, overruns and no buffers.
Drops Number of packets received that would not fit on the hold queue.
MTU Current maximum transmission unit size.
Qsz Current output hold queue size.
Related Command

interface async

show compress

To display compression statistics on a serial interface, use the show compress EXEC command.

show compress
Syntax Description

This command has no arguments or keywords.

Command Mode

EXEC

Sample Display

The following is sample output from the show compress command:

Router# show compress
Serial0
uncompressed bytes xmt/rcv 10710562/11376835
1  min avg ratio xmt/rcv 2.773/2.474
5  min avg ratio xmt/rcv 4.084/3.793
10 min avg ratio xmt/rcv 4.125/3.873
no bufs xmt 0 no bufs rcv 0
resets 0

Table 6-8 describes the fields shown in the display.


Table  6-8: Show Compress Field Descriptions
Field Description
Serial0 Name and number of the interface
uncompressed bytes xmt/rcv Total number of uncompressed bytes sent and received
1 min avg ratio xmt/rcv
5 min avg ratio xmt/rcv
10 min avg ratio xmt/rcv
Static compression ratio for bytes sent and received, averaged over 1, 5, and 10 minutes
no bufs xmt Number of times buffers were not available to compress data being sent
no bufs rcv Number of times buffers were not available to uncompress data being received
resets Number of resets
Related Command

compress

show controllers ethernet

Use the show controllers ethernet EXEC command to display information on the Cisco 2500.

show controllers ethernet interface-number
Syntax Description
interface-number Interface number of the Ethernet interface.
Command Mode

EXEC

Sample Display

The following is sample output from the show controllers ethernet command:

Router# show controllers ethernet 0
LANCE unit 0, NIM slot 1, NIM type code 4, NIM version 1
Media Type is 10BaseT, Link State is Up, Squelch is Normal
idb 0x4060, ds 0x5C80, regaddr = 0x8100000
IB at 0x600D7AC: mode=0x0000, mcfilter 0000/0001/0000/0040
station address 0000.0c03.a14f  default station address 0000.0c03.a14f
buffer size 1524
RX ring with 32 entries at 0xD7E8
Rxhead = 0x600D8A0 (12582935), Rxp = 0x5CF0(23)
00 pak=0x60336D0 ds=0x6033822 status=0x80 max_size=1524 pak_size=98
01 pak=0x60327C0 ds=0x6032912 status=0x80 max_size=1524 pak_size=98
02 pak=0x6036B88 ds=0x6036CDA status=0x80 max_size=1524 pak_size=98
03 pak=0x6041138 ds=0x604128A status=0x80 max_size=1524 pak_size=98
04 pak=0x603FAA0 ds=0x603FBF2 status=0x80 max_size=1524 pak_size=98
05 pak=0x600DC50 ds=0x600DDA2 status=0x80 max_size=1524 pak_size=98
06 pak=0x6023E48 ds=0x6023F9A status=0x80 max_size=1524 pak_size=1506
07 pak=0x600E3D8 ds=0x600E52A status=0x80 max_size=1524 pak_size=1506
08 pak=0x6020990 ds=0x6020AE2 status=0x80 max_size=1524 pak_size=386
09 pak=0x602D4E8 ds=0x602D63A status=0x80 max_size=1524 pak_size=98
10 pak=0x603A7C8 ds=0x603A91A status=0x80 max_size=1524 pak_size=98
11 pak=0x601D4D8 ds=0x601D62A status=0x80 max_size=1524 pak_size=98
12 pak=0x603BE60 ds=0x603BFB2 status=0x80 max_size=1524 pak_size=98
13 pak=0x60318B0 ds=0x6031A02 status=0x80 max_size=1524 pak_size=98
14 pak=0x601CD50 ds=0x601CEA2 status=0x80 max_size=1524 pak_size=98
15 pak=0x602C5D8 ds=0x602C72A status=0x80 max_size=1524 pak_size=98
16 pak=0x60245D0 ds=0x6024722 status=0x80 max_size=1524 pak_size=98
17 pak=0x6008328 ds=0x600847A status=0x80 max_size=1524 pak_size=98
18 pak=0x601EB70 ds=0x601ECC2 status=0x80 max_size=1524 pak_size=98
19 pak=0x602DC70 ds=0x602DDC2 status=0x80 max_size=1524 pak_size=98
20 pak=0x60163E0 ds=0x6016532 status=0x80 max_size=1524 pak_size=98
21 pak=0x602CD60 ds=0x602CEB2 status=0x80 max_size=1524 pak_size=98
22 pak=0x6037A98 ds=0x6037BEA status=0x80 max_size=1524 pak_size=98
23 pak=0x602BE50 ds=0x602BFA2 status=0x80 max_size=1524 pak_size=98
24 pak=0x6018988 ds=0x6018ADA status=0x80 max_size=1524 pak_size=98
25 pak=0x6033E58 ds=0x6033FAA status=0x80 max_size=1524 pak_size=98
26 pak=0x601BE40 ds=0x601BF92 status=0x80 max_size=1524 pak_size=98
27 pak=0x6026B78 ds=0x6026CCA status=0x80 max_size=1524 pak_size=98
28 pak=0x6024D58 ds=0x6024EAA status=0x80 max_size=1524 pak_size=74
29 pak=0x602AF40 ds=0x602B092 status=0x80 max_size=1524 pak_size=98
30 pak=0x601FA80 ds=0x601FBD2 status=0x80 max_size=1524 pak_size=98
31 pak=0x6038220 ds=0x6038372 status=0x80 max_size=1524 pak_size=98
TX ring with 8 entries at 0xDA20, tx_count = 0
tx_head = 0x600DA58 (12582919), head_txp = 0x5DC4 (7)
tx_tail = 0x600DA58 (12582919), tail_txp = 0x5DC4 (7)
00 pak=0x000000 ds=0x600CF12 status=0x03 status2=0x0000 pak_size=118
01 pak=0x000000 ds=0x602126A status=0x03 status2=0x0000 pak_size=60
02 pak=0x000000 ds=0x600CF12 status=0x03 status2=0x0000 pak_size=118
03 pak=0x000000 ds=0x600CF12 status=0x03 status2=0x0000 pak_size=118
04 pak=0x000000 ds=0x600CF12 status=0x03 status2=0x0000 pak_size=118
05 pak=0x000000 ds=0x600CF12 status=0x03 status2=0x0000 pak_size=118
06 pak=0x000000 ds=0x600CF12 status=0x03 status2=0x0000 pak_size=118
07 pak=0x000000 ds=0x6003ED2 status=0x03 status2=0x0000 pak_size=126
0 missed datagrams, 0 overruns, 2 late collisions, 2 lost carrier events
0 transmitter underruns, 0 excessive collisions,  0 tdr, 0 babbles
0 memory errors, 0 spurious initialization done interrupts
0 no enp status, 0 buffer errors, 0 overflow errors
10 one_col, 10 more_col, 22 deferred, 0 tx_buff
0 throttled, 0 enabled
Lance csr0 = 0x73

show controllers mci

Use the show controllers mci privileged EXEC command to display all information about the Multiport Communications Interface card. This command displays information the system uses for bridging and routing that is specific to the interface hardware. The information displayed is generally useful for diagnostic tasks performed by technical support personnel only.

show controllers mci
Syntax Description

This command has no arguments or keywords.

Command Mode

Privileged EXEC

Sample Display

The following is sample output from the show controllers mci command:

Router# show controllers mci
MCI 0, controller type 1.1, microcode version 1.8
   	128 Kbytes of main memory, 4 Kbytes cache memory
22 system TX buffers, largest buffer size 1520
   	Restarts: 0 line down, 0 hung output, 0 controller error
Interface 0 is Ethernet0, station address 0000.0c00.d4a6
   	15 total RX buffers, 11 buffer TX queue limit, buffer size 1520
   	Transmitter delay is 0 microseconds
Interface 1 is Serial0, electrical interface is V.35 DTE
   	15 total RX buffers, 11 buffer TX queue limit, buffer size 1520
   	Transmitter delay is 0 microseconds
   	High speed synchronous serial interface
Interface 2 is Ethernet1, station address aa00.0400.3be4
   	15 total RX buffers, 11 buffer TX queue limit, buffer size 1520
   	Transmitter delay is 0 microseconds
Interface 3 is Serial1, electrical interface is V.35 DCE
   	15 total RX buffers, 11 buffer TX queue limit, buffer size 1520
   	Transmitter delay is 0 microseconds
   	High speed synchronous serial interface 

Table 6-9 describes significant fields shown in the display.


Table  6-9: Show Controllers MCI Field Descriptions
Field Description
MCI 0 Card type and unit number (varies depending on card).
controller type 1.1 Version number of the card.
microcode version 1.8 Version number of the card's internal software in read-only memory).
128 Kbytes of main memory Amount of main memory on the card.
4 Kbytes cache memory Amount of cache memory on the card.
22 system TX buffers Number of buffers that hold packets to be transmitted.
largest buffer size 1520 Largest size of these buffers (in bytes).
Restarts
   0 line down
   0 hung output
   0 controller error
Count of restarts due to the following conditions:
   Communication line down
   Output unable to transmit
   Internal error
Interface 0 is Ethernet0 Names of interfaces, by number.
electrical interface is V.35 DTE Line interface type for serial connections.
15 total RX buffers Number of buffers for received packets.
11 buffer TX queue limit Maximum number of buffers in transmit queue.
Transmitter delay is 0 microseconds Delay between outgoing frames.
Station address 0000.0c00.d4a6 Hardware address of the interface.

Note The interface type is only queried at startup. If the hardware changes subsequent to initial startup, then the wrong type is reported. This has no adverse effect on the operation of the software. For instance, if a DCE cable is connected to a dual-mode V.35 applique after the unit has been booted, then the display presented for
show interfaces incorrectly reports attachment to a DTE device although the software recognizes the DCE interface and behaves accordingly.
Related Command

tx-queue-limit

show controllers serial

Use the show controllers serial privileged EXEC command to display information that is specific to the interface hardware. The information displayed is generally useful for diagnostic tasks performed by technical support personnel only.

show controllers serial
Syntax Description

This command has no arguments or keywords.

Command Mode

Privileged EXEC

Sample Display

Sample output of the show controllers serial command:

Router# show controllers serial
MK5 unit 0, NIM slot 1, NIM type code 7, NIM version 1
idb = 0x6150, driver structure at 0x34A878, regaddr = 0x8100300
IB at 0x6045500: mode=0x0108, local_addr=0, remote_addr=0
N1=1524, N2=1, scaler=100, T1=1000, T3=2000, TP=1
buffer size 1524
DTE V.35 serial cable attached
RX ring with 32 entries at 0x45560 : RLEN=5, Rxhead 0
00 pak=0x6044D78  ds=0x6044ED4 status=80 max_size=1524 pak_size=0
01 pak=0x60445F0  ds=0x604474C status=80 max_size=1524 pak_size=0
02 pak=0x6043E68  ds=0x6043FC4 status=80 max_size=1524 pak_size=0
03 pak=0x60436E0  ds=0x604383C status=80 max_size=1524 pak_size=0
04 pak=0x6042F58  ds=0x60430B4 status=80 max_size=1524 pak_size=0
05 pak=0x60427D0  ds=0x604292C status=80 max_size=1524 pak_size=0
06 pak=0x6042048  ds=0x60421A4 status=80 max_size=1524 pak_size=0
07 pak=0x60418C0  ds=0x6041A1C status=80 max_size=1524 pak_size=0
08 pak=0x6041138  ds=0x6041294 status=80 max_size=1524 pak_size=0
09 pak=0x60409B0  ds=0x6040B0C status=80 max_size=1524 pak_size=0
10 pak=0x6040228  ds=0x6040384 status=80 max_size=1524 pak_size=0
11 pak=0x603FAA0  ds=0x603FBFC status=80 max_size=1524 pak_size=0
12 pak=0x603F318  ds=0x603F474 status=80 max_size=1524 pak_size=0
13 pak=0x603EB90  ds=0x603ECEC status=80 max_size=1524 pak_size=0
14 pak=0x603E408  ds=0x603E564 status=80 max_size=1524 pak_size=0
15 pak=0x603DC80  ds=0x603DDDC status=80 max_size=1524 pak_size=0
16 pak=0x603D4F8  ds=0x603D654 status=80 max_size=1524 pak_size=0
17 pak=0x603CD70  ds=0x603CECC status=80 max_size=1524 pak_size=0
18 pak=0x603C5E8  ds=0x603C744 status=80 max_size=1524 pak_size=0
19 pak=0x603BE60  ds=0x603BFBC status=80 max_size=1524 pak_size=0
20 pak=0x603B6D8  ds=0x603B834 status=80 max_size=1524 pak_size=0
21 pak=0x603AF50  ds=0x603B0AC status=80 max_size=1524 pak_size=0
22 pak=0x603A7C8  ds=0x603A924 status=80 max_size=1524 pak_size=0
23 pak=0x603A040  ds=0x603A19C status=80 max_size=1524 pak_size=0
24 pak=0x60398B8  ds=0x6039A14 status=80 max_size=1524 pak_size=0
25 pak=0x6039130  ds=0x603928C status=80 max_size=1524 pak_size=0
26 pak=0x60389A8  ds=0x6038B04 status=80 max_size=1524 pak_size=0
27 pak=0x6038220  ds=0x603837C status=80 max_size=1524 pak_size=0
28 pak=0x6037A98  ds=0x6037BF4 status=80 max_size=1524 pak_size=0
29 pak=0x6037310  ds=0x603746C status=80 max_size=1524 pak_size=0
30 pak=0x6036B88  ds=0x6036CE4 status=80 max_size=1524 pak_size=0
31 pak=0x6036400  ds=0x603655C status=80 max_size=1524 pak_size=0
TX ring with 8 entries at 0x45790 : TLEN=3, TWD=7
tx_count = 0, tx_head = 7, tx_tail = 7
00 pak=0x000000 ds=0x600D70C status=0x38 max_size=1524 pak_size=22
01 pak=0x000000 ds=0x600D70E status=0x38 max_size=1524 pak_size=2
02 pak=0x000000 ds=0x600D70E status=0x38 max_size=1524 pak_size=2
03 pak=0x000000 ds=0x600D70E status=0x38 max_size=1524 pak_size=2
04 pak=0x000000 ds=0x600D70E status=0x38 max_size=1524 pak_size=2
05 pak=0x000000 ds=0x600D70E status=0x38 max_size=1524 pak_size=2
06 pak=0x000000 ds=0x600D70E status=0x38 max_size=1524 pak_size=2
07 pak=0x000000 ds=0x6000000 status=0x38 max_size=1524 pak_size=0
XID/Test TX desc at 0xFFFFFF, status=0x30, max_buffer_size=0, packet_size=0
XID/Test RX desc at 0xFFFFFF, status=0x0, max_buffer_size=0, packet_size=0
Status Buffer at 0x60459C8: rcv=0, tcv=0, local_state=0, remote_state=0
phase=0, tac=0, currd=0x00000, curxd=0x00000
bad_frames=0, frmrs=0, T1_timeouts=0, rej_rxs=0, runts=0
0 missed datagrams, 0 overruns, 0 bad frame addresses
0 bad datagram encapsulations, 0 user primitive errors
0 provider primitives lost, 0 unexpected provider primitives
0 spurious primitive interrupts, 0 memory errors, 0 tr
%LINEPROTO-5-UPDOWN: Linansmitter underruns
mk5025 registers: csr0 = 0x0E00, csr1 = 0x0302, csr2 = 0x0704
                  csr3 = 0x5500, csr4 = 0x0214, csr5 = 0x0008

show controllers token

To display information about memory management, error counters, and the CSC-1R, CSC-2R, and or CSC-R16M Token Ring interface cards, use the show controllers token privileged EXEC command.

show controllers token
Syntax Description

This command has no arguments or keywords.

Command Mode

EXEC

Usage Guidelines

Depending on the board being used, the output can vary. This command also displays information that is proprietary to Cisco Systems. Thus, the information that show controllers token displays is of primary use to Cisco technical personnel. Information that is useful to users can be obtained using the show interfaces tokenring command, described later in this chapter.

Sample Display

The following is sample output of the show controllers token command:

Router# show controllers token
TR Unit 0 is board 0 - ring 0
 state 3, dev blk: 0x1D2EBC, mailbox: 0x2100010, sca: 0x2010000
   current address: 0000.3080.6f40, burned in address: 0000.3080.6f40
   current TX ptr: 0xBA8, current RX ptr: 0x800
   Last Ring Status: none
 Stats: soft:0/0, hard:0/0, sig loss:0/0
        tx beacon: 0/0, wire fault 0/0, recovery: 0/0
        only station: 0/0, remote removal: 0/0
   Bridge: local 3330, bnum 1, target 3583
     max_hops 7, target idb: 0x0, not local
   Interface failures: 0  -- Bkgnd Ints: 0
   TX shorts 0, TX giants 0
   Monitor state: (active)
     flags 0xC0, state 0x0, test 0x0, code 0x0, reason 0x0
 f/w ver: 1.0, chip f/w: '000000.ME31100', [bridge capable]
     SMT versions: 1.01 kernel, 4.02 fastmac
     ring mode: F00, internal enables:  SRB REM RPS CRS/NetMgr
     internal functional: 0000011A (0000011A), group: 00000000 (00000000)
     if_state: 1, ints: 0/0, ghosts: 0/0, bad_states: 0/0
     t2m fifo purges: 0/0
     t2m fifo current: 0, t2m fifo max: 0/0, proto_errs: 0/0
     ring: 3330, bridge num: 1, target: 3583, max hops: 7
Packet counts:
       receive total:  298/6197, small: 298/6197, large 0/0
               runts: 0/0, giants: 0/0
               local: 298/6197, bridged: 0/0, promis: 0/0
             bad rif: 0/0, multiframe: 0/0
       ring num mismatch 0/0, spanning violations 0
       transmit total: 1/25, small: 1/25, large 0/0
                runts: 0/0, giants: 0/0, errors 0/0
bad fs: 0/0, bad ac: 0
congested: 0/0, not present: 0/0
     Unexpected interrupts: 0/0,  last unexp. int: 0
     Internal controller counts:
   	line errors: 0/0,  internal errors: 0/0
   	burst errors: 0/0,  ari/fci errors: 0/0
   	abort errors: 0/0, lost frame: 0/0
   	copy errors: 0/0, rcvr congestion: 0/0
   	token errors: 0/0, frequency errors: 0/0
   	dma bus errors: -/-, dma parity errors: -/-
     Internal controller smt state:
   	Adapter MAC:     0000.3080.6f40, Physical drop:     00000000
   	NAUN Address:    0000.a6e0.11a6, NAUN drop:         00000000
   	Last source:     0000.a6e0.11a6, Last poll:         0000.3080.6f40
   	Last MVID:       0006,           Last attn code:    0006
   	Txmit priority:  0006,           Auth Class:        7FFF
   	Monitor Error:   0000,           Interface Errors:  FFFF
   	Correlator:      0000,           Soft Error Timer:  00C8
   	Local Ring:      0000,           Ring Status:       0000
   	Beacon rcv type: 0000,           Beacon txmit type: 0000
   	Beacon type:     0000,           Beacon NAUN:       0000.a6e0.11a6

Table 6-10 describes the fields shown in the following line of sample output.

TR Unit 0 is board 0 - ring 0

Table  6-10: Show Controllers Token Field Descriptions--Part 1
Field Description
TR Unit 0 Unit number assigned to the Token Ring interface associated with this output.
is board 0 Board number assigned to the Token Ring controller board associated with this interface.
ring 0 Number of the Token Ring associated with this board.

In the following output line, state 3 indicates the state of the board. The rest of this output line displays memory mapping that is of primary use to Cisco engineers.

 state 3, dev blk: 0x1D2EBC, mailbox: 0x2100010, sca: 0x2010000

The following line also appears in show interface token output as the address and burned-in address, respectively:

  current address: 0000.3080.6f40, burned in address: 0000.3080.6f40
  

The following line of output displays buffer management pointers that change by board:

 current TX ptr: 0xBA8, current RX ptr: 0x800

The following line of output indicates the ring status from the controller chip set. This information is used by LAN Network Manager:

  Last Ring Status: none

The following lines of output show Token Ring statistics. See the Token Ring specification for more information.

 Stats: soft:0/0, hard:0/0, sig loss:0/0
        tx beacon: 0/0, wire fault 0/0, recovery: 0/0
        only station: 0/0, remote removal: 0/0

The following line of output indicates that Token Ring communication has been enabled on the interface. If this line of output appears, the message "Source Route Bridge capable" should appear in the show interfaces tokenring display.

  Bridge: local 3330, bnum 1, target 3583

Table 6-11 describes the fields shown in the following line of sample output.

max_hops 7, target idb: 0x0, not local

Table  6-11: Show Controllers Token Field Descriptions--Part 2
Field Description
max_hops 7 Maximum number of bridges.
target idb: 0x0 Destination interface definition.
not local Indicates whether the interface has been defined as a local or remote bridge.

The following line of output is specific to the hardware:

Interface failures: 0  -- Bkgnd Ints: 0

In the following line of output, TX shorts are the number of packets the interface transmits that are discarded because they are smaller than the medium's minimum packet size. TX giants are the number of packets the interface transmits that are discarded because they exceed the medium's maximum packet size.

TX shorts 0, TX giants 0

The following line of output indicates the state of the controller. Possible values include active, failure, inactive, and reset:

 Monitor state: (active)

The following line of output displays detailed information relating to the monitor state shown in the previous line of output. This information relates to the firmware on the controller. This information is relevant to Cisco engineers only if the monitor state is something other than active.

flags 0xC0, state 0x0, test 0x0, code 0x0, reason 0x0

Table 6-12 describes the fields in the following line of output:

 f/w ver: 1.0 expr 0, chip f/w: '000000.ME31100', [bridge capable]
  

Table  6-12: Show Controllers Token Field Descriptions--Part 3
Field Description
f/w ver: 1.0 Version of the Cisco firmware on the board.
chip f/w: '000000.ME31100' Firmware on the chip set.
[bridge capable] Interface has not been configured for bridging, but that it has that capability.

The following line of output displays the version numbers for the kernel and the accelerator microcode of the Madge firmware on the board; this firmware is the LLC interface to the chip set:

   SMT versions: 1.01 kernel, 4.02 fastmac
    

The following line of output displays LAN Network Manager information that relates to ring status:

ring mode: F00, internal enables:  SRB REM RPS CRS/NetMgr
   

The following line of output corresponds to the functional address and the group address shown in show interfaces tokenring output:

  internal functional: 0000011A (0000011A), group: 00000000 (00000000)

The following line of output displays interface board state information that is proprietary to Cisco Systems:

if_state: 1, ints: 0/0, ghosts: 0/0, bad_states: 0/0
    

The following output lines display information that is proprietary to Cisco Systems. Cisco engineers use this information for debugging purposes.

t2m fifo purges: 0/0
t2m fifo current: 0, t2m fifo max: 0/0, proto_errs: 0/0

Each of the fields in the following line of output maps to a field in the show source bridge display, as follows: ring maps to srn; bridge num maps to bn; target maps to trn; and max hops maps to max:

     ring: 3330, bridge num: 1, target: 3583, max hops: 7

In the following lines of output, the number preceding the slash (/) indicates the count since the value was last displayed; the number following the slash (/) indicates count since the system was last booted:

Packet counts:
       receive total:  298/6197, small: 298/6197, large 0/0

In the following line of output, the number preceding the slash (/) indicates the count since the value was last displayed; the number following the slash (/) indicates count since the system was last booted. The runts and giants values that appear here correspond to the runts and giants values that appear in show interfaces tokenring output.

               runts: 0/0, giants: 0/0

The following lines of output are receiver-specific information that Cisco engineers can use for debugging purposes:

               local: 298/6197, bridged: 0/0, promis: 0/0
             bad rif: 0/0, multiframe: 0/0
       ring num mismatch 0/0, spanning violations 0
       transmit total: 1/25, small: 1/25, large 0/0
                runts: 0/0, giants: 0/0, errors 0/0

The following output lines include very specific statistics that are not relevant in most cases, but exist for historical purposes. In particular, the internal errors, burst errors, ari/fci, abort errors, copy errors, frequency errors, dma bus errors, and dma parity errors fields are not relevant.

     Internal controller counts:
	line errors: 0/0,  internal errors: 0/0
	burst errors: 0/0,  ari/fci errors: 0/0
	abort errors: 0/0, lost frame: 0/0
	copy errors: 0/0, rcvr congestion: 0/0
	token errors: 0/0, frequency errors: 0/0
	dma bus errors: -/-, dma parity errors: -/-

The following lines of output are low-level Token Ring interface statistics relating to the state and status of the Token Ring with respect to all other Token Rings on the line:

  Internal controller smt state:
	Adapter MAC:     0000.3080.6f40, Physical drop:     00000000
	NAUN Address:    0000.a6e0.11a6, NAUN drop:         00000000
	Last source:     0000.a6e0.11a6, Last poll:         0000.3080.6f40
	Last MVID:       0006,           Last attn code:    0006
	Txmit priority:  0006,           Auth Class:        7FFF
	Monitor Error:   0000,           Interface Errors:  FFFF
	Correlator:      0000,           Soft Error Timer:  00C8
	Local Ring:      0000,           Ring Status:       0000
	Beacon rcv type: 0000,           Beacon txmit type: 0000

show dhcp

Use the show dhcp command to display the current DHCP settings on the access server's asynchronous interfaces.

show dhcp [interface number]
Syntax Description
interface number (Optional) Interface number.
Command Mode

Privileged EXEC

Usage Guidelines

If you omit the optional argument, the show dhcp command displays information about all interfaces.

Sample Display
Router# show dhcp server
IP address pooling for Point to Point clients is: DHCP Proxy Client
DHCP Proxy Client Status:
   DHCP server: ANY (255.255.255.255)
    Leases:   0
    Offers:   0      Requests: 0     Acks: 0     Naks: 0
    Declines: 0      Releases: 0     Bad:  0

Table 6-13 describes the fields shown in the display.


Table  6-13: Show DHCP Field Descriptions
Field Description
Leases Number of current leased IP addresses.
Offers Number of offers for an IP address sent to a proxy-client from the server.
Requests Number of requests for an IP address to the server.
Acks Number of 'acknowledge' messages sent by the server to the proxy-client.
Naks Number of 'not acknowledge' messages sent by the server to the proxy-client.
Declines Number of offers from the server that are declined by the proxy-client.
Releases Number of times IP addresses have been relinquished gracefully by the client.
Bad Number of bad packets received from wrong length, wrong field type, etc.
Related Commands

ip address-pool
ip dhcp-server
peer default ip address

show interfaces

Use the show interfaces EXEC command to display statistics for all interfaces configured on the access server. The resulting output varies, depending on the network for which an interface has been configured.

show interfaces [type number] [accounting]
Syntax Description
type unit (Optional) Interface type. Allowed values include async, ethernet, loopback, null, serial, tokenring, and tunnel.
number (Optional) Interface number
accounting (Optional) Displays the number of packets of each protocol type that has been sent through the interface. You can show these numbers for all interfaces, or you can specify a specific type and number.
Command Mode

EXEC

Usage Guidelines

The show interfaces command displays statistics for the network interfaces. If you enter a show interfaces command for an interface type that has been removed from the access server, interface statistics will be displayed accompanied by the following text: "Hardware has been removed."

You will use the show interfaces command frequently while configuring and monitoring access servers. The various forms of the show interfaces commands are described in detail in the sections immediately following this command.

To display the number of packets of each protocol type that have been sent through all configured interfaces, use the show interfaces accounting EXEC command. When you use the accounting option, only the accounting statistics are displayed.

Table 6-14 lists the protocols for which per-packet accounting information is kept.


Table  6-14: Per-Packet Counted Protocols
Protocol Notes
ARP For IP, Frame Relay, SMDS.
DEC MOP The access servers use MOP packets to advertise their existence to DEC machines that use the MOP protocol. An access server periodically broadcasts MOP packets to identify itself as a MOP host. This results in MOP packets being counted.
HP Probe --
IP --
Lan Manager LAN Network Manager and IBM Network Manager.
IPX --
Sample Display

The following is sample output from the show interfaces command. Because your display will depend on the type and number of interface cards in your access server, only a portion of the display is shown.

Router# show interfaces
Ethernet 0 is up, line protocol is up
  Hardware is MCI Ethernet, address is 0000.0c00.750c (bia 0000.0c00.750c)
  Internet address is 172.30.28.8, subnet mask is 255.255.255.0
  MTU 1500 bytes, BW 10000 Kbit, DLY 100000 usec, rely 255/255, load 1/255
  Encapsulation ARPA, loopback not set, keepalive set (10 sec)
  ARP type: ARPA, ARP Timeout 4:00:00
  Last input 0:00:00, output 0:00:00, output hang never
  Last clearing of "show interface" counters 0:00:00
  Output queue 0/40, 0 drops; input queue 0/75, 0 drops
  Five minute input rate 0 bits/sec, 0 packets/sec
  Five minute output rate 2000 bits/sec, 4 packets/sec
     1127576 packets input, 447251251 bytes, 0 no buffer
     Received 354125 broadcasts, 0 runts, 0 giants
     0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
     5332142 packets output, 496316039 bytes, 0 underruns
     0 output errors, 432 collisions, 0 interface resets, 0 restarts
---More---
Sample Display with Accounting Option

The following is sample output from the show interfaces accounting command:

Router# show interfaces accounting
Ethernet0
                Protocol    Pkts In   Chars In   Pkts Out  Chars Out
                      IP     873171  735923409      34624    9644258
                  Novell     163849   12361626      57143    4272468
                 DEC MOP          0          0          1         77
                     ARP      69618    4177080       1529      91740

When the output indicates an interface is "disabled," the access server has received excessive errors (over 5000 in a keepalive period).

show interfaces async

Use the show interfaces async EXEC command to display information about the serial interface.

show interfaces async [unit] [accounting]
Syntax Description
unit (Optional) Must be 1.
accounting (Optional) Displays the number of packets of each protocol type that have been sent through the interface.
Command Mode

EXEC

Sample Display

The following is sample output from the show interfaces async command:

Router# show interfaces async 1
Async 1 is up, line protocol is up
   	Hardware is Async Serial
Internet address is 172.30.0.1, subnet mask is 255.0.0.0
MTU 1500 bytes, BW 9 Kbit, DLY 100000 usec, rely 255/255, load 56/255
Encapsulation SLIP, keepalive set (0 sec)
Last input 0:00:03, output 0:00:03, output hang never
Last clearing of "show interface" counters never
Output queue 0/3, 2 drops; input queue 0/0, 0 drops
Five minute input rate 0 bits/sec, 1 packets/sec
Five minute output rate 2000 bits/sec, 1 packets/sec
273 packets input, 13925 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
221 packets output, 41376 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets, 0 restarts
0 carrier transitions

Note The access server does not detect the start of a SLIP packet on an asynchronous interface. When the SLIP connection is established, the access server only knows that it is working with the SLIP host that is generating traffic after it receives an END byte. Data that is transmitted before the END byte is counted as an error.

The following is a sample display from the show interfaces async accounting command:

Router# show interfaces async 0 accounting
Async 0
   Protocol  	Pkts In   	Chars In  	Pkts Out   	Chars Out
   	IP        	7344      	4787842   	1803       	1535774
   	DEC MOP 	  0 	        0 	        127 	       9779
   	ARP 	      7  	       420	       39	         2340

The show line and show slip commands can also be useful in monitoring asynchronous interfaces.

Table 6-15 describes the fields shown in the two sample displays.


Table  6-15: Show Interfaces Async Field Descriptions
Field Description
Async... is {up | down |
administratively down}
Indicates whether the interface hardware is currently active (whether carrier detect is present) and if it has been taken down by an administrator.
line protocol is {up | down |
administratively down}
Indicates whether the software processes that handle the line protocol think the line is usable (that is, whether keepalives are successful).
Hardware is Hardware type.
Internet address is IP address.
Subnet mask is Subnet mask.
MTU Maximum transmission unit of the interface.
BW Bandwidth of the interface in kilobits per second.
DLY Delay of the interface in microseconds.
rely Reliability of the interface as a fraction of 255 (255/255 is 100% reliability), calculated as an exponential average over five minutes.
load Load on the interface as a fraction of 255 (255/255 is completely saturated), calculated as an exponential average over five minutes. The calculation uses the value from the bandwidth interface configuration command.
Encapsulation Encapsulation method assigned to interface.
keepalive Indicates whether keepalives are set or not.
Last input Number of hours, minutes, and seconds since the last packet was successfully received by an interface. Useful for knowing when a dead interface failed.
output The number of hours, minutes, and seconds since the last packet was successfully transmitted by an interface.
output hang Number of hours, minutes, and seconds (or never) since the interface was last reset because of a transmission that took too long. When the number of hours in any of the "last" fields exceeds 24 hours, the number of days and hours is printed. If that field overflows, asterisks are printed.
Last clearing The time at which the counters that measure cumulative statistics (such as number of bytes transmitted and received) shown in this report were last reset to zero. Note that variables that might affect routing (for example, load and reliability) are not cleared when the counters are cleared.
*** indicates the elapsed time is too large to be displayed.
0:00:00 indicates the counters were cleared more than 231ms (and less than 232ms) ago.
Output queue, drops
input queue, drops
Number of packets in output and input queues. Each number is followed by a slash, the maximum size of the queue, and the number of packets dropped due to a full queue.
Five minute input rate,
Five minute output rate
Average number of bits and packets transmitted per second in the last five minutes.
packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the error free packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the main system. Compare with ignored count. Broadcast storms on Ethernets and bursts of noise on serial lines are often responsible for no input buffer events.
broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the medium's minimum packet size.
giants Number of packets that are discarded because they exceed the medium's maximum packet size.
input errors Total number of no buffer, runts, giants, CRCs, frame, overrun, ignored, and abort counts. Other input-related errors can also increment the count, so that this sum might not balance with the other counts.
CRC The cyclic redundancy checksum generated by the originating LAN station or far end device does not match the checksum calculated from the data received. On a LAN, this usually indicates noise or transmission problems on the LAN interface or the LAN bus itself. A high number of CRC's is usually the result of collisions or a station transmitting bad data. On a serial link, CRC's usually indicate noise, gain hits or other transmission problems on the data link.
frame Number of packets received incorrectly having a CRC error and a noninteger number of octets. On a serial line, this is usually the result of noise or other transmission problems.
overrun Number of times the serial receiver hardware was unable to hand received data to a hardware buffer because the input rate exceeded the receiver's ability to handle the data.
ignored Number of received packets ignored by the interface because the interface hardware ran low on internal buffers. These buffers are different than the system buffers mentioned previously in the buffer description. Broadcast storms and bursts of noise can cause the ignored count to be incremented.
abort Illegal sequence of one bits on a serial interface. This usually indicates a clocking problem between the serial interface and the data link equipment.
packets output Total number of messages transmitted by the system.
bytes Total number of bytes, including data and MAC encapsulation, transmitted by the system.
underruns Number of times that the far-end transmitter has been running faster than the near-end access server's receiver can handle. This might never be reported on some interfaces.
output errors Sum of all errors that prevented the final transmission of datagrams out of the interface being examined. Note that this might not balance with the sum of the enumerated output errors, as some datagrams might have more than one error, and others might have errors that do not fall into any of the specifically tabulated categories.
interface resets Number of times an interface has been completely reset. This can happen if packets queued for transmission were not sent within several seconds. On a serial line, this can be caused by a malfunctioning modem that is not supplying the transmit clock signal, or by a cable problem. If the system notices that the carrier detect line of a serial interface is up, but the line protocol is down, it periodically resets the interface in an effort to restart it. Interface resets can also occur when an interface is looped back or shut down.
restarts Number of times the controller was restarted because of errors.
carrier transitions Number of times the carrier detect signal of a serial interface has changed state. Indicates modem or line problems if the carrier detect line is changing state often.
Protocol Protocol that is operating on the interface.
Pkts In Number of packets received for that protocol.
Chars In Number of characters received for that protocol.
Pkts Out Number of packets transmitted for that protocol.
Chars Out Number of characters transmitted for that protocol.

show interfaces dialer

Use the show interfaces dialer EXEC command to display information about the dialer interface.

show interfaces dialer unit [accounting]
Syntax Description
unit Must match a port number on the selected interface.
accounting (Optional) Displays the number of packets of each protocol type that have been sent through the interface.
Command Mode

EXEC

show interfaces ethernet

Use the show interfaces ethernet EXEC command to display information about an Ethernet interface on the access server.

show interfaces ethernet unit [accounting]
Syntax Description
unit Must match a port number on the selected interface.
accounting (Optional) Displays the number of packets of each protocol type that have been sent through the interface.
Command Mode

EXEC

Usage Guidelines

If you do not provide values for the argument unit, the command will display statistics for all network interfaces. The optional keyword accounting displays the number of packets of each protocol type that have been sent through the interface.

Sample Display

The following is sample output from the show interfaces command for the Ethernet 0 interface:

Router# show interfaces ethernet 0
Ethernet 0 is up, line protocol is up
   	Hardware is MCI Ethernet, address is aa00.0400.0134 (bia 0000.0c00.4369)
	   Internet address is 172.30.1.1, subnet mask is 255.255.255.0
	   MTU 1500 bytes, BW 10000 Kbit, DLY 1000 usec, rely 255/255, load 1/255
	   Encapsulation ARPA, loopback not set, keepalive set (10 sec)
   	ARP type: ARPA, PROBE, ARP Timeout 4:00:00
	   Last input 0:00:00, output 0:00:00, output hang never
	   Output queue 0/40, 0 drops; input queue 0/75, 2 drops
	   Five minute input rate 61000 bits/sec, 4 packets/sec
	   Five minute output rate 1000 bits/sec, 2 packets/sec
		       2295197 packets input, 305539992 bytes, 0 no buffer
		       Received 1925500 broadcasts, 0 runts, 0 giants
		       3 input errors, 3 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
		       3594664 packets output, 436549843 bytes, 0 underruns
		       8 output errors, 1790 collisions, 10 interface resets, 0 restarts

Table 6-16 describes significant fields shown in the display.


Table  6-16: Show Interfaces Ethernet Field Descriptions
Field Description
Ethernet ... is up
...is administratively down
Indicates whether the interface hardware is currently active and if it has been taken down by an administrator. "Disabled" indicates the access server has received over 5000 errors in a keepalive interval, which is 10 seconds by default.
line protocol is {up | down |
administratively down}
Indicates whether the software processes that handle the line protocol believe the interface is usable (that is, whether keepalives are successful) or if it has been taken down by an administrator.
Hardware Hardware type (for example, MCI Ethernet, SCI, Ethernet) and address.
Internet address IP address followed by subnet mask.
MTU Maximum transmission unit of the interface.
BW Bandwidth of the interface in kilobits per second.
DLY Delay of the interface in microseconds.
rely Reliability of the interface as a fraction of 255 (255/255 is 100% reliability), calculated as an exponential average over five minutes.
load Load on the interface as a fraction of 255 (255/255 is completely saturated), calculated as an exponential average over five minutes.
Encapsulation Encapsulation method assigned to interface.
loopback Indicates whether loopback is set or not.
keepalive Indicates whether keepalives are set or not.
ARP type: Type of Address Resolution Protocol assigned.
Last input Number of hours, minutes, and seconds since the last packet was successfully received by an interface. Useful for knowing when a dead interface failed.
output Number of hours, minutes, and seconds since the last packet was successfully transmitted by the interface. Useful for knowing when a dead interface failed.
output hang Number of hours, minutes, and seconds (or never) since the interface was last reset because of a transmission that took too long. When the number of hours in any of the "last" fields exceeds 24 hours, the number of days and hours is printed. If that field overflows, asterisks are printed.
Output queue, input queue, drops Number of packets in output and input queues. Each number is followed by a slash, the maximum size of the queue, and the number of packets dropped due to a full queue.
Five minute input rate,
Five minute output rate
Average number of bits and packets transmitted per second in the last five minutes. If the interface is not in promiscuous mode, it senses network traffic it sends and receives (rather than all network traffic).

The five-minute input and output rates should be used only as an approximation of traffic per second during a given five-minute period. These rates are exponentially weighted averages with a time constant of five minutes. A period of four time constants must pass before the average will be within two percent of the instantaneous rate of a uniform stream of traffic over that period.

packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the error free packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the main system. Compare with ignored count. Broadcast storms on Ethernets and bursts of noise on serial lines are often responsible for no input buffer events.
Received ... broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the medium's minimum packet size. For instance, any Ethernet packet that is less than 64 bytes is considered a runt.
giants Number of packets that are discarded because they exceed the medium's maximum packet size. For example, any Ethernet packet that is greater than 1,518 bytes is considered a giant.
input errors Includes runts, giants, no buffer, CRC, frame, overrun, and ignored counts. Other input-related errors can also cause the input errors count to be increased, and some datagrams might have more than one error; therefore, this sum might not balance with the sum of enumerated input error counts.
CRC Cyclic redundancy check generated by the originating LAN station or far-end device does not match the checksum calculated from the data received. On a LAN, this usually indicates noise or transmission problems on the LAN interface or the LAN bus itself. A high number of CRCs is usually the result of collisions or a station transmitting bad data.
frame Number of packets received incorrectly having a CRC error and a noninteger number of octets. On a LAN, this is usually the result of collisions or a malfunctioning Ethernet device.
overrun Number of times the receiver hardware was unable to hand received data to a hardware buffer because the input rate exceeded the receiver's ability to handle the data.
ignored Number of received packets ignored by the interface because the interface hardware ran low on internal buffers. These buffers are different than the system buffers mentioned previously in the buffer description. Broadcast storms and bursts of noise can cause the ignored count to be increased.
abort Number of packets whose receipt was aborted.
packets output Total number of messages transmitted by the system.
bytes Total number of bytes, including data and MAC encapsulation, transmitted by the system.
underruns Number of times that the transmitter has been running faster than the access server can handle. This might never be reported on some interfaces.
output errors Sum of all errors that prevented the final transmission of datagrams out of the interface being examined. Note that this might not balance with the sum of the enumerated output errors, as some datagrams might have more than one error, and others might have errors that do not fall into any of the specifically tabulated categories.
collisions Number of messages retransmitted due to an Ethernet collision. This is usually the result of an overextended LAN (Ethernet or transceiver cable too long, more than two repeaters between stations, or too many cascaded multiport transceivers). A packet that collides is counted only once in output packets.
interface resets Number of times an interface has been completely reset. This can happen if packets queued for transmission were not sent within several seconds' time. On a serial line, this can be caused by a malfunctioning modem that is not supplying the transmit clock signal, or by a cable problem. If the system notices that the carrier detect line of a serial interface is up, but the line protocol is down, it periodically resets the interface in an effort to restart it. Interface resets can also occur when an interface is looped back or shut down.
restarts Number of times a Type 2 Ethernet controller was restarted because of errors.

show interfaces ip-brief

To list a brief summary of an interface IP information and status, use the show interfaces ip-brief EXEC command.

show interfaces ip-brief
Syntax Description

This command has no arguments or keywords.

Command Mode

EXEC

Sample Display

The following provides sample output from the show interfaces ip-brief command:

Router# show interfaces ip-brief
Any interface listed with OK? value "NO" does not have a valid configuration
Interface    IP-Address      OK?  Method     Status                 Protocol
Ethernet0    172.30.160.22   YES  NVRAM      up                     up

show interfaces loopback

Use the show interfaces loopback EXEC command to display information about the dialer interface.

show interfaces loopback [unit] [accounting]
Syntax Description
unit (Optional) Must match a port number on the selected interface.
accounting (Optional) Displays the number of packets of each protocol type that have been sent through the interface.
Command Mode

EXEC

Sample Displays

The following is sample output from the show interfaces loopback command:

Router# show interfaces loopback 0
Loopback0 is up, line protocol is up
  Hardware is Loopback
  MTU 1500 bytes, BW 1 Kbit, DLY 50 usec, rely 255/255, load 1/255
  Encapsulation UNKNOWN, loopback not set, keepalive set (10 sec)
  Last input never, output never, output hang never
  Last clearing of "show interface" counters never
  Output queue 0/0, 0 drops; input queue 0/75, 0 drops
  Five minute input rate 0 bits/sec, 0 packets/sec
  Five minute output rate 0 bits/sec, 0 packets/sec

                          0 packets input, 0 bytes, 0 no buffer

     Received 0 broadcasts, 0 runts, 0 giants
     0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
     0 input packets with dribble condition detected
     0 packets output, 0 bytes, 0 underruns
     0 output errors, 0 collisions, 0 interface resets, 0 restarts

The following is sample when the accounting keyword is included:

Router# show interfaces loopback 0 accounting
Loopback0
                Protocol    Pkts In   Chars In   Pkts Out  Chars Out
No traffic sent or received on this interface.

Table 6-17 describes significant fields shown in the displays.


Table  6-17: Show Interfaces Loopback Descriptions
Field Description
Loopback is {up | down |
administratively down
Indicates whether the interface hardware is currently active (whether carrier detect is present) and if it has been taken down by an administrator. "Disabled" indicates the access server has received over 5000 errors in a keepalive interval, which is 10 seconds by default.
line protocol is {up | down |
administratively down}
Indicates whether the software processes that handle the line protocol considers the line usable (that is, whether keepalives are successful).
Hardware Hardware is Loopback.
MTU Maximum transmission unit of the interface.
BW Bandwidth of the interface in kilobits per second.
DLY Delay of the interface in microseconds.
rely Reliability of the interface as a fraction of 255 (255/255 is 100% reliability), calculated as an exponential average over five minutes.
load Load on the interface as a fraction of 255 (255/255 is completely saturated), calculated as an exponential average over five minutes.
Encapsulation Encapsulation method assigned to interface.
loopback Indicates whether loopback is set and type of loopback test.
keepalive Indicates whether keepalives are set or not.
Last input Number of hours, minutes, and seconds since the last packet was successfully received by an interface. Useful for knowing when a dead interface failed.
output Number of hours, minutes, and seconds since the last packet was successfully transmitted by an interface.
output hang Number of hours, minutes, and seconds (or never) since the interface was last reset because of a transmission that took too long. When the number of hours in any of the "last" fields exceeds 24 hours, the number of days and hours is printed. If that field overflows, asterisks are printed.
Last clearing Time at which the counters that measure cumulative statistics (such as number of bytes transmitted and received) shown in this report were last reset to zero. Note that variables that might affect routing (for example, load and reliability) are not cleared when the counters are cleared.
*** indicates the elapsed time is too large to be displayed.
0:00:00 indicates the counters were cleared more than 231ms (and less than 232ms) ago.
Output queue, drops
Input queue, drops
Number of packets in output and input queues. Each number is followed by a slash, the maximum size of the queue, and the number of packets dropped due to a full queue.
Five minute input rate,
Five minute output rate
Average number of bits and packets transmitted per second in the last five minutes.
packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the error free packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the main system. Compare with ignored count. Broadcast storms on Ethernets and bursts of noise on serial lines are often responsible for no input buffer events.
broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the medium's minimum packet size.
giants Number of packets that are discarded because they exceed the medium's maximum packet size.
input errors Sum of all errors that prevented the receipt of datagrams on the interface being examined. This might not balance with the sum of the enumerated output errors, because some datagrams might have more than one error and others might have errors that do not fall into any of the specifically tabulated categories.
CRC Cyclic redundancy check generated by the originating LAN station or far-end device does not match the checksum calculated from the data received. On a LAN, this usually indicates noise or transmission problems on the LAN interface or the LAN bus itself. A high number of CRCs is usually the result of collisions or a station transmitting bad data. On a serial link, CRCs usually indicate noise, gain hits, or other transmission problems on the data link. CRC errors are also reported when a far-end abort occurs, and when the idle flag pattern is corrupted. This makes it possible to get CRC errors even when there is no data traffic.
frame Number of packets received incorrectly having a CRC error and a noninteger number of octets. On a serial line, this is usually the result of noise or other transmission problems.
overrun Number of times the serial receiver hardware was unable to hand received data to a hardware buffer because the input rate exceeded the receiver's ability to handle the data.
ignored Number of received packets ignored by the interface because the interface hardware ran low on internal buffers. These buffers are different than the system buffers mentioned previously in the buffer description. Broadcast storms and bursts of noise can cause the ignored count to be increased.
abort Number of packets whose receipt was aborted.
packets output Total number of messages transmitted by the system.
bytes output Total number of bytes, including data and MAC encapsulation, transmitted by the system.
underruns Number of times that the far-end transmitter has been running faster than the near-end access server's receiver can handle. This might never happen (be reported) on some interfaces.
output errors Sum of all errors that prevented the final transmission of datagrams out of the interface being examined. Note that this might not balance with the sum of the enumerated output errors, as some datagrams might have more than one error, and others might have errors that do not fall into any of the specifically tabulated categories.
interface resets Number of times an interface has been completely reset. This can happen if packets queued for transmission were not sent within several seconds time. On a serial line, this can be caused by a malfunctioning modem that is not supplying the transmit clock signal, or by a cable problem. If the system notices that the carrier detect line of a serial interface is up, but the line protocol is down, it periodically resets the interface in an effort to restart it. Interface resets can also occur when an interface is looped back or shut down.
restarts Number of times the controller was restarted because of errors.
Protocol Protocol that is operating on the interface.
Pkts In Number of packets received for that protocol.
Chars In Number of characters received for that protocol.
Pkts Out Number of packets transmitted for that protocol.
Chars Out Number of characters transmitted for that protocol.

show interfaces serial

Use the show interfaces serial privileged EXEC command to display information about a serial interface.

show interfaces serial number [accounting]
Syntax Description
number (Optional) Must match the interface port number.
accounting (Optional) Displays the number of packets of each protocol type that have been sent through the interface.
Command Mode

Privileged EXEC

Sample Display

The following is sample output from the show interfaces command for a synchronous serial interface:

Router# show interfaces serial
Serial 0 is up, line protocol is up
   	Hardware is MCI Serial
	   Internet address is 172.30.190.203, subnet mask is 255.255.255.0
	   MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec, rely 255/255, load 1/255
	   Last input 0:00:07, output 0:00:00, output hang never
	   Output queue 0/40, 0 drops; input queue 0/75, 0 drops
	   Five minute input rate 0 bits/sec, 0 packets/sec
	   Five minute output rate 0 bits/sec, 0 packets/sec
		       16263 packets input, 1347238 bytes, 0 no buffer
		       Received 13983 broadcasts, 0 runts, 0 giants
		       2 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 2 abort
1 carrier transitions 
     22146 packets output, 2383680 bytes, 0 underruns
     0 output errors, 0 collisions, 2 interface resets, 0 restarts

Table 6-18 describes significant fields shown in the display.


Table  6-18: Show Interfaces Serial Field Descriptions
Field Description
Serial ... is {up | down |
administratively down}
Indicates whether the interface hardware is currently active (whether carrier detect is present) and if it has been taken down by an administrator. "Disabled" indicates the access server has received over 5000 errors in a keepalive interval, which is 10 seconds by default.
line protocol is {up | down} Indicates whether the software processes that handle the line protocol consider the line usable (that is, whether keepalives are successful) or if it has been taken down by an administrator.
Hardware is Specifies the hardware type.
Internet address is Specifies the IP address.
subnet mask Subnet mask.
MTU Maximum transmission unit of the interface.
BW Indicates the value of the bandwidth parameter that has been configured for the interface (in kilobits per second). The bandwidth parameter is used to compute IGRP metrics only. If the interface is attached to a serial line with a line speed that does not match the default (1536 or 1544 for T1 and 56 for a standard synchronous serial line), use the bandwidth command to specify the correct line speed for this serial line.
DLY Delay of the interface in microseconds.
rely Reliability of the interface as a fraction of 255 (255/255 is 100% reliability), calculated as an exponential average over five minutes.
load Load on the interface as a fraction of 255 (255/255 is completely saturated), calculated as an exponential average over five minutes.
Last input Number of hours, minutes, and seconds since the last packet was successfully received by an interface. Useful for knowing when a dead interface failed.
output Number of hours, minutes, and seconds since the last packet was successfully transmitted by an interface.
output hang Number of hours, minutes, and seconds (or never) since the interface was last reset because of a transmission that took too long. When the number of hours in any of the "last" fields exceeds 24 hours, the number of days and hours is printed. If that field overflows, asterisks are printed.
Output queue, drops
input queue, drops
Number of packets in output and input queues. Each number is followed by a slash, the maximum size of the queue, and the number of packets dropped due to a full queue.
Five minute input rate
Five minute output rate
Average number of bits and packets transmitted per second in the last five minutes.

The five-minute input and output rates should be used only as an approximation of traffic per second during a given five-minute period. These rates are exponentially weighted averages with a time constant of five minutes. A period of four time constants must pass before the average will be within two percent of the instantaneous rate of a uniform stream of traffic over that period.

packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the error free packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the main system. Compare with ignored count. Broadcast storms on Ethernets and bursts of noise on serial lines are often responsible for no input buffer events.
Received ... broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the medium's minimum packet size.
giants Number of packets that are discarded because they exceed the medium's maximum packet size.
input errors Total number of no buffer, runts, giants, CRCs, frame, overrun, ignored, and abort counts. Other input-related errors can also increment the count, so that this sum might not balance with the other counts.
CRC Cyclic redundancy check generated by the originating station or far-end device does not match the checksum calculated from the data received. On a serial link, CRCs usually indicate noise, gain hits, or other transmission problems on the data link.
frame Number of packets received incorrectly having a CRC error and a noninteger number of octets. On a serial line, this is usually the result of noise or other transmission problems.
overrun Number of times the serial receiver hardware was unable to hand received data to a hardware buffer because the input rate exceeded the receiver's ability to handle the data.
ignored Number of received packets ignored by the interface because the interface hardware ran low on internal buffers. Broadcast storms and bursts of noise can cause the ignored count to be increased.
abort Illegal sequence of one bits on a serial interface. This usually indicates a clocking problem between the serial interface and the data link equipment.
carrier transitions Number of times the carrier detect signal of a serial interface has changed state. Indicates modem or line problems if the carrier detect line is changing state often.
packets output Total number of messages transmitted by the system.
bytes Total number of bytes, including data and MAC encapsulation, transmitted by the system.
underruns Number of times that the transmitter has been running faster than the access server can handle. This may never be reported on some interfaces.
output errors Sum of all errors that prevented the final transmission of datagrams out of the interface being examined. Note that this might not balance with the sum of the enumerated output errors, as some datagrams might have more than one error, and others might have errors that do not fall into any of the specifically tabulated categories.
collisions Number of messages retransmitted due to an Ethernet collision. This usually is the result of an overextended LAN (Ethernet or transceiver cable too long, more than two repeaters between stations, or too many cascaded multiport transceivers). Some collisions are normal. However, if your collision rate climbs to around 4-5%, you should consider verifying that there is no faulty equipment on the segment and/or moving some existing stations to a new segment. A packet that collides is counted only once in output packets.
interface resets Number of times an interface has been completely reset. This can happen if packets queued for transmission were not sent within several seconds' time. On a serial line, this can be caused by a malfunctioning modem that is not supplying the transmit clock signal, or by a cable problem. If the system notices that the carrier detect line of a serial interface is up, but the line protocol is down, it periodically resets the interface in an effort to restart it. Interface resets can also occur when an interface is looped back or shut down.
restarts Number of times the controller was restarted because of errors.
Sample Display with Frame Relay Encapsulation

When using the Frame Relay encapsulation, use the show interfaces command to display information on the multicast DLCI, the DLCI of the interface, and the LMI DLCI used for the local management interface.

The multicast DLCI and the local DLCI can be set using the frame-relay multicast-dlci and the frame-relay local-dlci configuration commands, or provided through the local management interface. The status information is taken from the LMI, when active.

The following is a sample display from the show interfaces serial output when using Frame Relay encapsulation:

Router# show interfaces serial
Serial 2 is up, line protocol is up
   	Hardware type is MCI Serial
   	Internet address is 172.30.122.1, subnet mask is 255.255.255.0
	   MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec, rely 255/255, load 1/255
	   Encapsulation FRAME-RELAY, loopback not set, keepalive set (10 sec)
	   multicast DLCI 1022,  status defined, active
	   source DLCI    20, status defined, active
	   LMI DLCI 1023, LMI sent 10, LMI stat recvd 10, LMI upd recvd 2
	   Last input 7:21:29, output 0:00:37, output hang never
	   Output queue 0/100, 0 drops; input queue 0/75, 0 drops
	   Five minute input rate 0 bits/sec, 0 packets/sec
	   Five minute output rate 0 bits/sec, 0 packets/sec
		       47 packets input, 2656 bytes, 0 no buffer
		       Received 5 broadcasts, 0 runts, 0 giants
		       5 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 57 abort
		       518 packets output, 391205 bytes
	       	0 output errors, 0 collisions, 0 interface resets, 0 restarts
		       1 carrier transitions

In this display, the multicast DLCI has been changed to 1022 with the frame-relay multicast-dlci interface configuration command.

The display shows the statistics for the LMI are the number of status inquiry messages sent (LMI sent), the number of status messages received (LMI recvd), and the number of status updates received (upd recvd). See the Frame Relay Interface specification for additional explanations of this output.

Sample Display with ANSI LMI

For a serial interface with the ANSI LMI enabled, use the show interfaces command to determine the LMI type implemented.

The following is a sample display from the show interfaces output for a serial interface with the ANSI LMI enabled.

Router# show interfaces serial
Serial 1 is up, line protocol is up
   	Hardware is MCI Serial
	   Internet address is 172.30.121.1, subnet mask is 255.255.255.0
	   MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec, rely 255/255, load 1/255
	   Encapsulation FRAME-RELAY, loopback not set, keepalive set
	   LMI DLCI    0, LMI sent 10, LMI stat recvd 10
	   LMI type is ANSI Annex D
	   Last input 0:00:00, output 0:00:00, output hang never
	   Output queue 0/40, 0 drops; input queue 0/75, 0 drops
	   Five minute input rate 0 bits/sec, 1 packets/sec
	   Five minute output rate 1000 bits/sec, 1 packets/sec
		       261 packets input, 13212 bytes, 0 no buffer
		       Received 33 broadcasts, 0 runts, 0 giants
		       0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
		       238 packets output, 14751 bytes, 0 underruns
		       0 output errors, 0 collisions, 0 interface resets, 0 restarts

Notice that the show interfaces output for a serial interface with ANSI LMI is very similar to that for encapsulation set to Frame Relay, as shown in the previous display. Table 6-19 describes the differences that exist.


Table  6-19: Show Interfaces Field Description with ANSI LMI
Field Description
LMI DLCI 0 Identifies the DLCI used by the LMI for this interface. Default: 1023.
LMI sent 10 Number of LMI packets the access server sent.
LMI type is ANSI Annex D Indicates that the interface is configured for the ANS-adopted Frame Relay specification T1.617 Annex D.
Sample Display with LAPB Encapsulation

Use the show interfaces command to display operation statistics for an interface using LAPB encapsulation.

The following is sample output from the show interfaces command for a serial interface using LAPB encapsulation:

Router# show interfaces
LAPB state is DISCONNECT, T1 3000, N1 12000, N2 20, K7, TH 3000
Window is closed
IFRAMEs 12/28 RNRs 0/1 REJs 13/1 SABMs 1/13 FRMRs 3/0 DISCs 0/11

Table 6-20 shows the fields relevant to all LAPB connections.


Table  6-20: Show Interfaces Serial Fields and Descriptions When LAPB Is Enabled
Parameter Description
LAPB state is DISCONNECT State of the LAPB protocol.
T1 3000, N1 12000, ... Current parameter settings.
Window is closed Indicates that no more frames can be transmitted until some outstanding frames have been acknowledged.
IFRAMEs 12/28 RNRs 0/1 ... Count of the different types of frames in the form of sent/received.
Show Interfaces Serial with PPP

An interface configured for synchronous PPP encapsulation differs from the standard show interface serial output in the fourth and fifth lines displayed. An interface configured for PPP might include the following information:

  Encapsulation PPP, loopback not set, keepalive set (10 sec)
  PPP: No valid link quality reports received.

The output line that reads "PPP: No valid link quality reports received" indicates that no reports have been received. If link quality monitoring is not negotiated, then that line will indicate the following:

  PPP: LQM not negotiated.

If LQM has been negotiated, and if link quality reports have been received, it will display the following:

  PPP: LQR transmit interval 10 sec, receive interval 10 sec
    local tx/remote rx: packets 50/50  bytes 147/147  success 16/16
     remote tx/local rx:  packets 49/50  bytes 753/790  success 16/16          
    

This display contrasts the number of packets and bytes transmitted with the number received by the remote end, and the number of successful link quality reports received.

show interfaces tokenring

Use the show interfaces tokenring EXEC command to display information about the Token Ring interface and the state of source route bridging.

show interfaces tokenring unit [accounting]
Syntax Description
unit Must match the interface port line number.
accounting (Optional) Displays the number of packets of each protocol type that have been sent through the interface.
Command Mode

EXEC

Usage Guidelines

The optional keyword accounting displays the number of packets of each protocol type that have been sent through the interface.

Sample Display

The following is sample output from the show interfaces tokenring command.

Router# show interfaces tokenring
TokenRing 0 is up, line protocol is up
Hardware is 16/4 Token Ring, address is 5500.2000.dc27 (bia 0000.3000.072b)
   	Internet address is 172.30.230.203, subnet mask is 255.255.255.0
	   MTU 8136 bytes, BW 16000 Kbit, DLY 630 usec, rely 255/255, load 1/255
   	Encapsulation SNAP, loopback not set, keepalive set (10 sec)
	   ARP type: SNAP, ARP Timeout 4:00:00
	   Ring speed: 16 Mbps
	   Single ring node, Source Route Bridge capable
	   Group Address: 0x00000000, Functional Address: 0x60840000
   	Last input 0:00:01, output 0:00:01, output hang never
   	Output queue 0/40, 0 drops; input queue 0/75, 0 drops
   	Five minute input rate 0 bits/sec, 0 packets/sec
   	Five minute output rate 0 bits/sec, 0 packets/sec
	   16339 packets input, 1496515 bytes, 0 no buffer
		        Received 9895 broadcasts, 0 runts, 0 giants
		        0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
     32648 packets output, 9738303 bytes, 0 underruns
0 output errors, 0 collisions, 2 interface resets, 0 restarts
     5 transitions

Table 6-21 describes significant fields shown in the display.


Table  6-21: Show Interfaces Tokenring Field Descriptions
Field Description
Token Ring is up | down Interface is either currently active and inserted into ring (up) or inactive and not inserted (down).

"Disabled" indicates the access server has received over 5000 errors in a keepalive interval, which is 10 seconds by default.

Token Ring is Reset Hardware error has occurred.
Token Ring is Initializing Hardware is up, in the process of inserting the ring.
Token Ring is
Administratively Down
Hardware has been taken down by an administrator.
line protocol is {up | down |
administratively down}
Indicates whether the software processes that handle the line protocol believe the interface is usable (that is, whether keepalives are successful).
Hardware Hardware type. "Hardware is Token Ring" indicates that the board is a CSC-R board. "Hardware is 16/4 Token Ring" indicates that the board is a CSC-R16 board. Also shows the address of the interface.
Internet address Lists the IP address followed by subnet mask.
MTU Maximum transmission unit of the interface.
BW Bandwidth of the interface in kilobits per second.
DLY Delay of the interface in microseconds.
rely Reliability of the interface as a fraction of 255 (255/255 is 100% reliability), calculated as an exponential average over five minutes.
load Load on the interface as a fraction of 255 (255/255 is completely saturated), calculated as an exponential average over five minutes.
Encapsulation Encapsulation method assigned to interface.
loopback Indicates whether loopback is set or not.
keepalive Indicates whether keepalives are set or not.
ARP type Type of Address Resolution Protocol assigned.
Ring speed Speed of Token Ring--4 or 16 Mbps.
{Single ring/multiring node} Indicates whether a node is enabled to collect and use source routing information (RIF) for routable Token Ring protocols.
Group Address Interface's group address, if any. The group address is a multicast address; any number of interfaces on the ring can share the same group address. Each interface can have at most one group address.
Last input Number of hours, minutes, and seconds since the last packet was successfully received by an interface. Useful for knowing when a dead interface failed.
output Number of hours, minutes, and seconds since the last packet was successfully transmitted by an interface.
output hang Number of hours, minutes, and seconds (or never) since the interface was last reset because of a transmission that took too long. When the number of hours in any of the "last" fields exceeds 24 hours, the number of days and hours is printed. If that field overflows, asterisks are printed.
Output queue, drops
Input queue, drops
Number of packets in output and input queues. Each number is followed by a slash, the maximum size of the queue, and the number of packets dropped due to a full queue.
Five minute input rate,
Five minute output rate
Average number of bits and packets transmitted per second in the last five minutes.

The five-minute input and output rates should be used only as an approximation of traffic per second during a given five-minute period. These rates are exponentially weighted averages with a time constant of five minutes. A period of four time constants must pass before the average will be within two percent of the instantaneous rate of a uniform stream of traffic over that period.

packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the error free packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the main system. Compare with ignored count. Broadcast storms on Ethernets and bursts of noise on serial lines are often responsible for no input buffer events.
Received... broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the medium's minimum packet size.
giants Number of packets that are discarded because they exceed the medium's maximum packet size.
input errors Total number of no buffer, runts, giants, CRCs, frame, overrun, ignored, and abort counts. Other input-related errors can also increment the count, so that this sum might not balance with the other counts.
CRC Cyclic redundancy check generated by the originating LAN station or far-end device does not match the checksum calculated from the data received. On a LAN, this usually indicates noise or transmission problems on the LAN interface or the LAN bus itself. A high number of CRCs is usually the result of a station transmitting bad data.
frame Number of packets received incorrectly having a CRC error and a noninteger number of octets.
overrun Number of times the serial receiver hardware was unable to hand received data to a hardware buffer because the input rate exceeded the receiver's ability to handle the data.
ignored Number of received packets ignored by the interface because the interface hardware ran low on internal buffers. These buffers are different than the system buffers mentioned previously in the buffer description. Broadcast storms and bursts of noise can cause the ignored count to be increased.
packets output Total number of messages transmitted by the system.
bytes Total number of bytes, including data and MAC encapsulation, transmitted by the system.
underruns Number of times that the far-end transmitter has been running faster than the near-end access server's receiver can handle. This might never be reported on some interfaces.
output errors Sum of all errors that prevented the final transmission of datagrams out of the interface being examined. Note that this might not balance with the sum of the enumerated output errors, as some datagrams might have more than one error, and others might have errors that do not fall into any of the specifically tabulated categories.
collisions Since a Token Ring cannot have collisions, this statistic is nonzero only if an unusual event occurred when frames were being queued or dequeued by the system software.
interface resets Number of times an interface has been reset. The interface may be reset by the administrator or automatically when an internal error occurs.
restarts Should always be zero for Token Ring interfaces.
transitions Number of times the ring made a transition from up to down, or vice versa. A large number of transitions indicates a problem with the ring or the interface.

show interfaces tunnel

To list tunnel interface information, use the show interfaces tunnel EXEC command.

show interfaces tunnel unit [accounting]
Syntax Description
unit Must match the interface port line number.
accounting (Optional) Displays the number of packets of each protocol type that have been sent through the interface.
Command Mode

EXEC

Sample Display

The following example provides sample output from the show interface tunnel command:

Router# show interfaces tunnel 4
Tunnel4 is up, line protocol is down
  Hardware is Routing Tunnel
  MTU 1500 bytes, BW 9 Kbit, DLY 500000 usec, rely 255/255, load 1/255
  Encapsulation TUNNEL, loopback not set, keepalive set (10 sec)
  Tunnel source 0.0.0.0, destination 0.0.0.0
  Tunnel protocol/transport GRE/IP, key disabled, sequencing disabled
  Last input never, output never, output hang never
  Last clearing of "show interface" counters never
  Output queue 0/0, 0 drops; input queue 0/75, 0 drops
  Five minute input rate 0 bits/sec, 0 packets/sec
  Five minute output rate 0 bits/sec, 0 packets/sec
     0 packets input, 0 bytes, 0 no buffer
     Received 0 broadcasts, 0 runts, 0 giants
     0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
     0 input packets with dribble condition detected
     0 packets output, 0 bytes, 0 underruns
     0 output errors, 0 collisions, 0 interface resets, 0 restarts    

Table 6-22 describes significant fields shown in the display.


Table  6-22: Show Interfaces Tunnel Field Descriptions
Field Description
Tunnel is up | down Interface is currently active and inserted into ring (up) or inactive and not inserted (down).
line protocol is {up | down | administratively down} Shows line protocol up if a valid route is available to the tunnel destination. Shows line protocol down if no route is available, or if the route would be recursive.
Hardware Specifies the hardware type.
MTU Maximum transmission unit of the interface.
BW Bandwidth of the interface in kilobits per second.
DLY Delay of the interface in microseconds.
rely Reliability of the interface as a fraction of 255 (255/255 is 100% reliability), calculated as an exponential average over five minutes.
load Load on the interface as a fraction of 255 (255/255 is completely saturated), calculated as an exponential average over five minutes.
Encapsulation Encapsulation method is always TUNNEL for tunnels.
loopback Indicates whether loopback is set or not.
keepalive Indicates whether keepalives are set or not.
Tunnel source IP address used as the source address for packets in the tunnel.
destination IP address of the host destination.
Tunnel protocol Tunnel transport protocol (the protocol the tunnel is using). This is based on the tunnel mode command, which defaults to GRE.
key ID key for the tunnel interface, unless disabled.
sequencing Indicates whether the tunnel interface drops datagrams that arrive out of order. Can be disabled.
Last input Number of hours, minutes, and seconds since the last packet was successfully received by an interface. Useful for knowing when a dead interface failed.
output Number of hours, minutes, and seconds since the last packet was successfully transmitted by an interface.
output hang Number of hours, minutes, and seconds (or never) since the interface was last reset because of a transmission that took too long. When the number of hours in any of the "last" fields exceeds 24 hours, the number of days and hours is printed. If that field overflows, asterisks are printed.
Last clearing Time at which the counters that measure cumulative statistics (such as number of bytes transmitted and received) shown in this report were last reset to zero. Note that variables that might affect routing (for example, load and reliability) are not cleared when the counters are cleared.
*** indicates the elapsed time is too large to be displayed.
0:00:00 indicates the counters were cleared more than 231ms (and less than 232ms) ago.
Output queue, drops
Input queue, drops
Number of packets in output and input queues. Each number is followed by a slash, the maximum size of the queue, and the number of packets dropped due to a full queue.
Five minute input rate,
Five minute output rate
Average number of bits and packets transmitted per second in the last five minutes.

The five-minute input and output rates should be used only as an approximation of traffic per second during a given five-minute period. These rates are exponentially weighted averages with a time constant of five minutes. A period of four time constants must pass before the average will be within two percent of the instantaneous rate of a uniform stream of traffic over that period.

packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the error free packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the main system. Compare with ignored count. Broadcast storms on Ethernets and bursts of noise on serial lines are often responsible for no input buffer events.
Received... broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the medium's minimum packet size.
giants Number of packets that are discarded because they exceed the medium's maximum packet size.
CRC Cyclic redundancy check generated by the originating LAN station or far-end device does not match the checksum calculated from the data received. On a LAN, this usually indicates noise or transmission problems on the LAN interface or the LAN bus itself. A high number of CRCs is usually the result of a station transmitting bad data.
frame Number of packets received incorrectly having a CRC error and a noninteger number of octets.
overrun Number of times the serial receiver hardware was unable to hand received data to a hardware buffer because the input rate exceeded the receiver's ability to handle the data.
ignored Number of received packets ignored by the interface because the interface hardware ran low on internal buffers. These buffers are different than the system buffers mentioned previously in the buffer description. Broadcast storms and bursts of noise can cause the ignored count to be increased.
abort Illegal sequence of one bits on a serial interface. This usually indicates a clocking problem between the serial interface and the data link equipment.
packets output Total number of messages transmitted by the system.
bytes Total number of bytes, including data and MAC encapsulation, transmitted by the system.
underruns Number of times that the far-end transmitter has been running faster than the near-end access server's receiver can handle. This might never be reported on some interfaces.
output errors Sum of all errors that prevented the final transmission of datagrams out of the interface being examined. Note that this might not balance with the sum of the enumerated output errors, as some datagrams might have more than one error, and others might have errors that do not fall into any of the specifically tabulated categories.
collisions Number of messages retransmitted due to an Ethernet collision. This usually is the result of an overextended LAN (Ethernet or transceiver cable too long, more than two repeaters between stations, or too many cascaded multiport transceivers). Some collisions are normal. However, if your collision rate climbs to around 4-5%, you should consider verifying that there is no faulty equipment on the segment and/or moving some existing stations to a new segment. A packet that collides is counted only once in output packets.
interface resets Number of times an interface has been reset. The interface may be reset by the administrator or automatically when an internal error occurs.
restarts Number of times the controller was restarted because of errors.
Related Commands

A dagger (+) indicates that the command is documented in another chapter.

show ip route +
show route +

show interfaces vty

Use the show interfaces vty EXEC command to display information about virtual asynchronous interfaces.

show interfaces vty number
Syntax Description
number Number of the VTY that has been configured for asynchronous protocol features (vty-async).
Command Mode

EXEC

Sample Display

The following is sample output from the show interfaces vty command:

Router# sh int vty17
VTY-Async17 is up, line protocol is up
  Hardware is Virtual Async Serial
  Interface is unnumbered.  Using address of Ethernet0 (172.30.60.44)
MTU 1500 bytes, BW 9 Kbit, DLY 100000 usec, rely 255/255, load 1/255
  Encapsulation SLIP, loopback not set
  DTR is pulsed for 5 seconds on reset
  Last input never, output never, output hang never
  Last clearing of "show interface" counters never
  Output queue 0/10, 0 drops; input queue 0/75, 0 drops
  5 minute input rate 0 bits/sec, 0 packets/sec
  5 minute output rate 0 bits/sec, 0 packets/sec
     0 packets input, 0 bytes, 0 no buffer
     Received 0 broadcasts, 0 runts, 0 giants
     0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
     0 packets output, 0 bytes, 0 underruns
     0 output errors, 0 collisions, 0 interface resets, 0 restarts
     0 carrier transitions

Table 6-23 describes the fields shown in the sample display.


Table  6-23: Show Interfaces VTY Field Descriptions
Field Description
Async... is {up | down |
administratively down}
Indicates whether the interface is currently active (whether carrier detect is present) and if it has been taken down by an administrator.
line protocol is {up | down |
administratively down}
Indicates whether the software processes that handle the line protocol think the line is usable (that is, whether keepalives are successful).
Hardware is Hardware type.
Internet address | unnumbered IP address, or IP unnumbered for the line. If unnumbered, the output lists the interface and IP address to which the line is assigned (Ethernet0 at 172.30.60.44 in this example).
MTU Maximum transmission unit of the vty-async interface.
BW Bandwidth of the vty-async interface in kilobits per second.
DLY Delay of the vty-async interface in microseconds.
rely Reliability of the vty-async interface as a fraction of 255 (255/255 is 100% reliability), calculated as an exponential average over five minutes.
load Load on the vty-async interface as a fraction of 255 (255/255 is completely saturated), calculated as an exponential average over five minutes. The calculation uses the value from the bandwidth interface configuration command.
Encapsulation Encapsulation method assigned to the vty-async interface.
loopback Test in which signals are sent and then directed back toward the source at some point along the communication path. Used to test network interface usability.
DTR Data Terminal Ready. An RS232-C circuit that is activated to let the DCE know when the DTE is ready to send and receive data.
Last input Number of hours, minutes, and seconds since the last packet was successfully received by a vty-async interface. Useful for knowing when a dead interface failed.
output The number of hours, minutes, and seconds since the last packet was successfully transmitted by a vty-async interface.
output hang Number of hours, minutes, and seconds (or never) since the vty-async interface was last reset because of a transmission that took too long. When the number of hours in any of the "last" fields exceeds 24 hours, the number of days and hours is printed. If that field overflows, asterisks are printed.
Last clearing The time at which the counters that measure cumulative statistics (such as number of bytes transmitted and received) shown in this report were last reset to zero. Note that variables that might affect routing, for example, load and reliability, are not cleared when the counters are cleared.
*** indicates the elapsed time is too large to be displayed.
0:00:00 indicates that the counters were cleared more than 231ms (and less than 232ms) ago.
Output queue, drops
input queue, drops
Number of packets in output and input queues. Each number is followed by a slash, the maximum size of the queue, and the number of packets dropped due to a full queue.
Five minute input rate,
Five minute output rate
Average number of bits and packets transmitted per second in the last five minutes.
packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the error free packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the main system. Compare with ignored count. Broadcast storms on Ethernets and bursts of noise on serial lines are often responsible for no input buffer events.
broadcasts Total number of broadcast or multicast packets received by the vty-async interface.
runts Number of packets that are discarded because they are smaller than the medium's minimum packet size.
giants Number of packets that are discarded because they exceed the medium's maximum packet size.
input errors Total number of no buffer, runts, giants, CRCs, frame, overrun, ignored, and abort counts. Other input-related errors can also increment the count, so that this sum might not balance with the other counts.
CRC The cyclic redundancy checksum generated by the originating LAN station or far end device does not match the checksum calculated from the data received. On a LAN, this usually indicates noise or transmission problems on the LAN interface or the LAN bus itself. A high number of CRCs is usually the result of collisions or a station transmitting bad data. On a serial link, CRCs usually indicate noise, gain hits, or other transmission problems on the data link.
frame Number of packets received incorrectly having a CRC error and a noninteger number of octets. On a serial line, this is usually the result of noise or other transmission problems.
overrun Number of times the serial receiver hardware was unable to hand received data to a hardware buffer because the input rate exceeded the receiver's ability to handle the data.
ignored Number of received packets ignored by the vty-async interface because the interface hardware ran low on internal buffers. These buffers are different than the system buffers mentioned previously in the buffer description. Broadcast storms and bursts of noise can cause the ignored count to be incremented.
abort Illegal sequence of one bits on a vty-async interface. This usually indicates a clocking problem between the vty-async interface and the data link equipment.
packets output Total number of messages transmitted by the system.
bytes Total number of bytes, including data and MAC encapsulation, transmitted by the system.
underruns Number of times that the far-end transmitter has been running faster than the near-end access server's receiver can handle. This might never be reported on some vty-async interfaces.
output errors Sum of all errors that prevented the final transmission of datagrams out of the vty-async interface being examined. Note that this might not balance with the sum of the enumerated output errors, as some datagrams might have more than one error, and others might have errors that do not fall into any of the specifically tabulated categories.
collisions Number of packets colliding.
interface resets Number of times a vty-async interface has been completely reset. This can happen if packets queued for transmission were not sent within several seconds. This can be caused by a malfunctioning modem that is not supplying the transmit clock signal, or by a cable problem. If the system notices that the carrier detect line of a vty-async interface is up, but the line protocol is down, it periodically resets the interface in an effort to restart it. Interface resets can also occur when a vty-async interface is looped back or shut down.
restarts Number of times the controller was restarted because of errors.
carrier transitions Number of times the carrier detect signal of a vty-async interface has changed state. Indicates modem or line problems if the carrier detect line is changing state often.

show ip interface

To list a summary of an interface's IP information and status, use the show ip interface privileged EXEC command.

show ip interface [brief] [type] [number]
Syntax Description
brief (Optional) Displays a brief summary of IP status and configuration.
type (Optional) Specifies that information be displayed about that interface type only. The possible value depends on the type of interfaces the system has. For example, it could be ethernet, null, serial, tokenring, and so on.
number (Optional) Interface number.
Command Mode

Privileged EXEC

Sample Displays

The following is sample output from the show ip interface command:

Router# show ip interface
Ethernet0 is administratively down, line protocol is down
  Internet address is 172.30.46.10, subnet mask is 255.0.0.0
  Broadcast address is 255.255.255.255
  Address determined by setup command
  MTU is 1500 bytes
  Helper address is not set
  Directed broadcast forwarding is enabled
  Multicast groups joined: 224.0.0.1 224.0.0.2
  Outgoing access list is not set
  Inbound  access list is not set
  Proxy ARP is enabled
  Security level is default
  Split horizon is enabled
  ICMP redirects are always sent
  ICMP unreachables are always sent
  ICMP mask replies are never sent
  IP fast switching is enabled
  IP fast switching on the same interface is disabled
  IP SSE switching is disabled
  Router Discovery is disabled
  IP accounting is disabled
  TCP/IP header compression is disabled
  Probe proxy name replies are disabled
  Gateway Discovery is disabled
PCbus0 is administratively down, line protocol is down
  Internet address is 172.30.1.43, subnet mask is 255.255.255.0
  Broadcast address is 255.255.255.255
  Address determined by setup command
  MTU is 1500 bytes
  Helper address is not set
  Directed broadcast forwarding is enabled
  Multicast groups joined: 224.0.0.1 224.0.0.2
  Outgoing access list is not set
  Inbound  access list is not set
  Proxy ARP is enabled
  Security level is default
  Split horizon is enabled
  ICMP redirects are always sent
  ICMP unreachables are always sent
  ICMP mask replies are never sent
  IP fast switching is enabled
  IP fast switching on the same interface is disabled
  IP SSE switching is disabled
  Router Discovery is disabled
  IP accounting is disabled
  TCP/IP header compression is disabled
  Probe proxy name replies are disabled
  Gateway Discovery is disabled
Serial0 is administratively down, line protocol is down
  Internet address is 172.30.2.49, subnet mask is 255.255.255.0
  Broadcast address is 255.255.255.255
  Address determined by setup command
  MTU is 1500 bytes
  Helper address is not set
  Directed broadcast forwarding is enabled
  Multicast groups joined: 224.0.0.1 224.0.0.2
  Outgoing access list is not set
  Inbound  access list is not set
  Proxy ARP is enabled
  Security level is default
  Split horizon is enabled
  ICMP redirects are always sent
  ICMP unreachables are always sent
  ICMP mask replies are never sent
  IP fast switching is enabled
  IP fast switching on the same interface is disabled
  IP SSE switching is disabled
  Router Discovery is disabled
  IP accounting is disabled
  TCP/IP header compression is disabled
  Probe proxy name replies are disabled
  Gateway Discovery is disabled

The following is sample output from the show ip interface brief command:

Router# show ip interface brief
Interface    IP-Address      OK?  Method     Status                 Protocol
Ethernet0    172.30.46.10   YES  manual     administratively down  down    
PCbus0       172.30.1.43    YES  manual     administratively down  down    
Serial0      172.30.2.49    YES  manual     administratively down  down    

The following is sample output from the show ip interface brief pcbus 0 command:

Router# show ip interface brief pcbus 0
Interface    IP-Address      OK?  Method     Status                 Protocol
PCbus0       172.30.1.43    YES  manual     administratively down  down    
Related Command

show interfaces

show ip local pool

To display statistics for any defined IP address pools, use the show ip local pool privileged EXEC command.

show ip local pool [name]
Syntax Description
name (Optional) Name of a specific IP address pool.
Command Mode

Privileged EXEC

Usage Guidelines

If you omit the variable name, the software will display a generic list of all defined address pools and the IP addresses that belong to them. If you specify a name, the software displays more detailed information for that pool.

Sample Display
Router# show ip local pool
Scope    Begin           End             Free InUse
 Dialin   172.30.228.11   172.30.228.26   16   0  
Available addresses:
   172.30.228.12                             
   172.30.228.13                             
   172.30.228.14                             
   172.30.228.15                             
   172.30.228.16                             
   172.30.228.17                             
   172.30.228.18                             
   172.30.228.19                             
   172.30.228.20                             
   172.30.228.21                             
   172.30.228.22                             
   172.30.228.23                             
   172.30.228.24                             
   172.30.228.25                             
   172.30.228.26                             
   172.30.228.11        Async5               
Inuse addresses:
     None

Table 6-24 describes the fields shown in the display.


Show IP Local Pool Field Descriptions
Field Description
Scope The type of access.
Begin The first IP address in the defined range of addresses in this pool.
End The last IP address in the defined range of addresses in this pool.
Free The number of addresses currently available.
InUse The number of addresses currently in use.
Related Commands

ip address-pool
ip local pool

shutdown

To disable an interface, use the shutdown interface configuration command. Use the no form of this command to restart a disabled interface.

shutdown
no shutdown
Syntax Description

This command has no arguments or keywords.

Default

Enabled

Command Mode

Interface configuration

Usage Guidelines

The shutdown command disables all functions on the specified interface. On serial interfaces, this command causes the DTR signal to be dropped. On Token Ring interfaces, this command causes the interface to be deinserted from the ring.

This command also marks the interface as unavailable. To check whether an interface is disabled, use the EXEC command show interfaces. An interface that has been shut down is shown as administratively down in the display from this command.

Examples

The following example turns off Ethernet interface 0:

interface ethernet 0
shutdown

The following example turns the interface back on:

interface ethernet 0
no shutdown
Related Command

show interfaces

transmitter-delay

To specify a minimum dead-time after transmitting a packet, use the transmitter-delay interface configuration command. Use the no form of this command to restore the default.

transmitter-delay microseconds
no transmitter-delay
Syntax Description
microseconds Approximate number of microseconds of minimum delay after transmitting a packet on the MCI and SCI interface cards
Default

0 microseconds

Command Mode

Interface configuration

Usage Guidelines

This command is especially useful for serial interfaces that can send back-to-back data packets over serial interfaces faster than some hosts can receive them.

The transmitter delay feature is implemented for the following Token Ring cards: CSC-R16M, CSC-1R, and CSC-2R. For the first four cards, the command syntax is the same as the existing command and specifies the number of milliseconds to delay between sending frames that are generated by the access server. Transmitter delay for the CSC-CTR uses the same syntax, but specifies a relative time interval to delay between transmission of all frames.

Example

The following example specifies a delay of 300 microseconds on interface serial interface 0:

interface serial 0
transmitter-delay 300

tunnel checksum

To enable encapsulator-to-decapsulator checksumming of packets on a tunnel interface, use the tunnel checksum interface configuration command. Use the no form of this command to disable checksumming.

tunnel checksum
no tunnel checksum
Syntax Description

This command has no arguments or keywords.

Default

No tunnel checksumming

Command Mode

Interface configuration

Usage Guidelines

This command currently applies to generic route encapsulation (GRE) only. Some passenger protocols rely on media checksums to provide data integrity. By default, the tunnel does not guarantee packet integrity. By enabling end-to-end checksums, the access servers will drop corrupted packets.

Example

In the following example, all protocols will have encapsulator-to-decapsulator checksumming of packets on the tunnel interface:

tunnel checksum

tunnel destination

To specify a tunnel interface's destination, use the tunnel destination interface configuration command. Use the no form of this command to remove the destination.

tunnel destination {hostname | ip-address}
no tunnel destination
Syntax Description
hostname Name of the host destination
ip-address IP address of the host destination
Default

No tunnel interface destination is specified.

Command Mode

Interface configuration

Usage Guidelines

You cannot have two tunnels using the same encapsulation mode with exactly the same source and destination address. The workaround is to create a loopback interface and source packets off of the loopback interface.

Example

In the following example, the tunnel destination is 172.30.111.234:

tunnel destination 172.30.111.234
Related Command

tunnel source

tunnel key

To enable an ID key for a tunnel interface, use the tunnel key interface configuration command. Use the no form of this command to remove the ID key.

tunnel key key-number
no tunnel key
Syntax Description
key-number Integer from 0 to 4294967295.
Default

Disabled

Command Mode

Interface configuration

Usage Guidelines

This command currently applies to generic route encapsulation (GRE) only. Tunnel ID keys can be used as a form of weak security to prevent misconfiguration or injection of packets from a foreign source.


Note When using GRE, the ID key is carried in each packet. We do not recommend relying on this key for security purposes.
Example

In the following example, the tunnel key is set to 3:

tunnel key 3

tunnel mode

To set the encapsulation mode for the tunnel interface, use the tunnel mode interface configuration command. To set to the default, use the no form of this command.

tunnel mode {aurp | cayman | eon | gre ip | mbone | nos}
no tunnel mode
Syntax Description
aurp AppleTalk Update Routing Protocol (AURP).
cayman Cayman TunnelTalk AppleTalk encapsulation.
dvmrp Distance Vector Multicast Routing Protocol .
eon EON compatible CLNS tunnel.
gre ip Generic route encapsulation (GRE) protocol over IP.
nos KA9Q/NOS compatible IP over IP.
Default

GRE tunneling

Command Mode

Interface configuration

Usage Guidelines

You cannot have two tunnels using the same encapsulation mode with exactly the same source and destination address. The workaround is to create a loopback interface and source packets off of the loopback interface.

Cayman tunneling implements tunneling as designed by Cayman Systems. This enables our routers and access servers to interoperate with Cayman GatorBoxes. With Cayman tunneling, you can establish tunnels between two routers or between our router and a GatorBox. When using Cayman tunneling, you must not configure the tunnel with an AppleTalk network address. This means that there is no way to ping the other end of the tunnel.

Use DVMRP when a router connects to a mrouted router to run DVMRP over a tunnel. It is required to configure Protocol-Independent Multicast (PIM) and an IP address on a DVMRP tunnel.

Generic route encapsulation (GRE) tunneling can be done between our routers only. When using GRE tunneling for AppleTalk, you configure the tunnel with an AppleTalk network address. This means that you can ping the other end of the tunnel.

Examples

The following example enables Cayman tunneling:

interface tunnel0
tunnel source ethernet0
tunnel destination 172.30.164.19
tunnel mode cayman

The following example enables GRE tunneling:

interface tunnel0
appletalk cable-range 4160-4160 4160.19
appletalk zone Engineering
tunnel source ethernet0
tunnel destination 172.30.164.19
tunnel mode gre ip
Related Commands

tunnel destination
tunnel source

tunnel sequence-datagrams

To configure a tunnel interface to drop datagrams that arrive out of order, use the tunnel sequence-datagrams interface configuration command. Use the no form of this command to disable this function.

tunnel sequence-datagrams
no tunnel sequence-datagrams
Syntax Description

This command has no arguments or keywords.

Default

Disabled

Command Mode

Interface configuration

Usage Guidelines

This command currently applies to generic route encapsulation (GRE) only. This command is useful when carrying passenger protocols that behave poorly when they receive packets out of order (for example, LLC2-based protocols).

Example

In the following example, the tunnel is configured to drop datagrams that arrive out of order:

tunnel sequence-datagrams

tunnel source

To set a tunnel interface's source address, use the tunnel source interface configuring command. Use the no form of this command to remove the source address.

tunnel source {ip-address | interface-type interface-number}
no tunnel source
Syntax Description
ip-address IP address to use as the source address for packets in the tunnel.
interface-type All types.
interface-number Specifies the port, connector, or interface card number. The numbers are assigned at the factory at the time of installation or when added to a system, and can be displayed with the show interfaces command.
Default

No tunnel interface's source address is set.

Command Mode

Interface configuration

Usage Guidelines

You cannot have two tunnels using the same encapsulation mode with exactly the same source and destination address. The workaround is to create a loopback interface and source packets off of the loopback interface.

When using tunnels to Cayman boxes, you must set the tunnel source to an explicit IP address on the same subnet as the Cayman box, not the tunnel itself.

Examples

In the following example, the tunnel source is set to the IP address assigned to Ethernet interface 0:

tunnel source ethernet 0

The following example enables Cayman tunneling:

interface tunnel0
tunnel source ethernet0
tunnel destination 172.30.164.19
tunnel mode cayman

The following example enables GRE tunneling:

interface tunnel0
appletalk cable-range 4160-4160 4160.19
appletalk zone Engineering
tunnel source ethernet0
tunnel destination 172.30.164.19
tunnel mode gre ip
Related Commands

tunnel destination

tx-queue-limit

To control the number of transmit buffers available to a specified interface on the MCI and SCI cards, use the tx-queue-limit interface configuration command.

tx-queue-limit number
Syntax Description
number Maximum number of transmit buffers that the specified interface can subscribe.
Default

Defaults depend on the total transmit buffer pool size and the traffic patterns of all the interfaces on the card. Defaults and specified limits are displayed with the show controllers mci EXEC command.

Command Mode

Interface configuration

Usage Guidelines

Only use this command under the guidance of a technical support representative.

Example

The following example sets the maximum number of transmit buffers on the interface to 5:

interface ethernet 0
tx-queue-limit 5
Related Command

show controllers mci

hometocprevnextglossaryfeedbacksearchhelp
Copyright 1989-1997 © Cisco Systems Inc.