Access and Communication Servers Command Reference
User Interface Config Commands

Table Of Contents

Interface Configuration Commands

backup delay

backup interface

backup load

bandwidth

clear counters

clear interface

clear line

clockrate

compress

delay

description

down-when-looped

early-token-release

encapsulation

error-threshold

group-range

half-duplex controlled-carrier

half-duplex timer

hold-queue

ignore-dcd

interface

interface dialer

interface group-async

ip address-pool

ip dhcp-server

ip local pool

keepalive

loopback remote (interface)

loopback dte

loopback line

loopback remote

media-type

member

mop enabled

mop sysid

mtu

peer default ip address

physical-layer

ppp authentication

ppp quality

pulse-time

ring-speed

scheduler-interval

show async status

show compress

show controllers ethernet

show controllers mci

show controllers serial

show controllers token

show dhcp

show interfaces

show interfaces async

show interfaces dialer

show interfaces ethernet

show interfaces ip-brief

show interfaces loopback

show interfaces serial

show interfaces tokenring

show interfaces tunnel

show interfaces vty

show ip interface

show ip local pool

shutdown

transmitter-delay

tunnel checksum

tunnel destination

tunnel key

tunnel mode

tunnel sequence-datagrams

tunnel source

tx-queue-limit


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.

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 .

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 .

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.

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 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 .

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:

to specify the Ethernet Network Interface Module configuration on the Cisco 4000 series

to specify the FEIP on the Cisco 7000 series

to specify full-duplex or half-duplex mode on a serial interface

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

lists default MTU values according to media type.

Table 6-6

Media Type
Default MTU

Ethernet

1500

Serial

1500

Token Ring

4464


Default Media MTU Values

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.

For all interfaces not configured with a peer default IP address mechanism (equivalent to selecting the peer default ip address pool command), the router uses the Global Default Mechanism that is defined by the ip address-pool command.

If you select the peer default ip address pool poolname command, then the router uses the locally configured pool on this interface and does not follow the Global Default Mechanism.

If you select the peer default ip address ip-address form of this command, the specific IP address is assigned to any peer connecting to this interface and any Global Default Mechanism is overridden for this interface.

If you select the peer default ip address dhcp form of this command, the DHCP proxy-client mechanism is used by default on this interface and any Global Default Mechanism is overridden for this interface.

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:

sdlc cts-delay

sdlc rts-timeout

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

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

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 

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

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

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.


—Part 1

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

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

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.


—Part 2

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

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

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.


—Part 3

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

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.

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.

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

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.

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

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. describes the differences that exist.

Table 6-19 Show Interfaces Field Description

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.


with ANSI LMI

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

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 PPPAn 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

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    

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

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

describes the fields shown in the display.

Table 6-24 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