Cisco IOS

Interface and Hardware Component

Command Reference

Corporate Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 526-4100

Text Part Number: OL-7502-01

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL
STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT
WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.

THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT
SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE
OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public
domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.

NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH
ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF
DEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING,
WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO
OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

CCIP, the Cisco Arrow logo, the Cisco Powered Network mark, the Cisco Systems Verified logo, Cisco Unity, Follow Me Browsing, FormShare, Internet Quotient, iQ
Breakthrough, iQ Expertise, iQ FastTrack, the iQ Logo, iQ Net Readiness Scorecard, Networking Academy, ScriptShare, SMARTnet, TransPath, and Voice LAN are trademarks
of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, Discover All That’s Possible, The Fastest Way to Increase Your Internet Quotient, and iQuick Study are
service marks of Cisco Systems, Inc.; and Aironet, ASIST, BPX, Catalyst, CCDA, CCDP, CCIE, CCNA, CCNP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS,
the Cisco IOS logo, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Empowering the Internet Generation, Enterprise/Solver, EtherChannel,
EtherSwitch, Fast Step, GigaStack, IOS, IP/TV, LightStream, MGX, MICA, the Networkers logo, Network Registrar, Packet, PIX, Post-Routing, Pre-Routing, RateMUX,
Registrar, SlideCast, StrataView Plus, Stratm, SwitchProbe, TeleRouter, and VCO are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and certain other
countries.

All other trademarks mentioned in this document or Web site are the property of their respective owners. The use of the word partner does not imply a partnership relationship
between Cisco and any other company. (0206R)

Cisco IOS Interface and Hardware Component Command Reference

Copyright © 2005 Cisco Systems, Inc. All rights reserved.
 C O N T E N T S

Introduction IR-1

Interface and Hardware Component Commands IR-3

Cisco IOS Interface and Hardware Component Command Reference

iii
Contents

Cisco IOS Interface and Hardware Component Command Reference

iv
Introduction

This book describes the basic command-line interface (CLI) commands that can be used on different
types of interfaces and hardware components that are supported by Cisco networking devices. The
commands in this book can be used to enable an interface and to configure basic interface and hardware
component features.
Two types of interfaces are supported: physical interfaces and virtual interfaces. The types of physical
interfaces on a device depend upon the networking technology to which the device connects and upon
the associated physical layer standards. The virtual interfaces that Cisco networking devices support
include subinterfaces, loopback interfaces, virtual-access interfaces, and IP tunnels.
Commands in this book can be grouped into the following interfaces and hardware component types,
which correspond to the interface and hardware component configuration tasks that are included in the
Cisco IOS configuration guides:
• LAN interfaces
• Serial interfaces and controllers
• Logical or virtual interfaces
• Dialer and virtual-access interfaces
• Cisco Mainframe Channel Connection (CMCC) adapters
• ISDN interfaces and controllers
Other interface commands, specific to a particular technology area, are described in the
technology-specific command references or installation guides. For example, for hardware technical
descriptions and for information about installing the interfaces or hardware components, refer to the
hardware installation and maintenance publication for your particular product.

Cisco IOS Interface and Hardware Component Command Reference

IR-1
 Introduction

Cisco IOS Interface and Hardware Component Command Reference

IR-2
Interface and Hardware Component Commands

Cisco IOS Interface and Hardware Component Command Reference

IR-3
 Interface and Hardware Component Commands
alarm-interface

alarm-interface
To enter alarm-interface mode and configure the alarm interface controller (AIC), use the
alarm-interface command in global configuration mode. To leave alarm interface mode, use the exit
command.

alarm-interface slot-number

Syntax Description slot-number Number of the port in which the AIC is installed.

Defaults No default behavior or values

Command Modes Global configuration

Command History Release Modification

12.2(2)XG This command was introduced for the Cisco 2600 series and the
Cisco 3600 series.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T.

Examples The following examples show how the alarm-interface command is used in conjunction with the
ip address and the reset commands:
Router(config)# alarm-interface 5
Router(config-aic)# ip address 10.2.130.105

A change in the AIC IP configuration might not take effect until the next time the card is started. Use
the reset command to restart the card, as in the following example:
Router(config-aic)# reset
Alarm Interface Card in slot 5 restarted

Router(config-aic)# end

Related Commands Command Description

ip address Sets a primary or secondary IP address for an interface.
reset Resets the AIC CPU.

Cisco IOS Interface and Hardware Component Command Reference

IR-4
 Interface and Hardware Component Commands
analysis-module monitoring

analysis-module monitoring
To enable Network Analysis Module (NAM) packet monitoring on an interface, use the
analysis-module monitoring command in interface configuration mode. To disable NAM packet
monitoring, use the no form of this command.

analysis-module monitoring

no analysis-module monitoring

Syntax Description This command has no arguments or keywords.

Defaults NAM packet monitoring is disabled.

Command Modes Interface configuration

Command History Release Modification

12.3(4)XD This command was introduced on the following platforms: Cisco 2600XM
series, Cisco 2691, Cisco 3660, Cisco 3725, and Cisco 3745.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T.
12.3(8)T4 This command was implemented on the following platforms: Cisco 2811,
Cisco 2821, Cisco 2851, and Cisco 3800 series.
12.3(11)T This command was implemented on the Cisco 3800 series.

Usage Guidelines When you enable NAM packet monitoring on an interface, Cisco Express Forwarding (CEF) sends an
extra copy of each IP packet that is received or sent on that interface to the NAM through the analysis
module interface on the router and then through the internal NM-NAM interface.

Note Traffic sent through the internal NAM interface—and the router’s analysis module interface—uses
router resources such as CPU, SDRAM bandwidth, and backplane Peripheral Component
Interconnect (PCI) bandwidth. Therefore, Cisco recommends that you use the internal NAM interface
to monitor WAN interfaces and that you use the external NAM interface to monitor LAN interfaces.

Examples The following example shows how to enable NAM packet monitoring on a serial interface:
Router(config)# interface serial 0/0
Router(config-if)# analysis-module monitoring

Cisco IOS Interface and Hardware Component Command Reference

IR-5
 Interface and Hardware Component Commands
apply (satellite initial configuration)

apply (satellite initial configuration)

To save new or changed satellite initial configuration parameters and to reset the Cisco IP VSAT
satellite WAN network module (NM-1VSAT-GILAT), use the apply command in satellite initial
configuration mode.

apply

Syntax Description This command has no arguments or keywords.

Defaults No default behavior or values

Command Modes Satellite initial configuration mode

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines The apply command saves any new or changed satellite initial configuration parameters to the
nonvolatile memory of the Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT),
and initiates a network module software reset. Commands entered in satellite initial configuration
mode do not appear in the router configuration.
When you enter the exit or end command to exit satellite initial configuration mode, the system
automatically saves any changed parameters to the NM-1VSAT-GILAT network module’s
nonvolatile memory and resets the NM-1VSAT-GILAT network module.

Note This command is typically used by an installation technician. Do not use this command unless your
satellite service provider instructs you to perform the satellite initial configuration and provides all
necessary parameter values.

Examples The following example shows what appears when you enter the apply command after changing some
initial configuration parameters:
Router(sat-init-config)# apply

Applying changed parameters to the satellite module.

Parameter update succeeded. Module is now resetting.
Router(sat-init-config)#

Cisco IOS Interface and Hardware Component Command Reference

IR-6
 Interface and Hardware Component Commands
apply (satellite initial configuration)

The following example shows what appears when you enter the apply command when no parameters
have been changed:
Router(sat-init-config)# apply

% No new or changed parameters to apply.

Router(sat-init-config)#

Related Commands Command Description

end (satellite initial Exits satellite initial configuration mode, saves any new or changed
configuration) parameters, and resets the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT).
exit (satellite initial Exits satellite initial configuration mode, saves any new or changed
configuration) parameters, and resets the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT).

Cisco IOS Interface and Hardware Component Command Reference

IR-7
 Interface and Hardware Component Commands
aps authenticate

aps authenticate
To enable authentication and specify the string that must be present to accept any packet on the
out-of-band (OOB) communications channel on a Packet-over-SONET (POS) interface, use the aps
authenticate command in interface configuration mode. To disable authentication, use the no form of
this command.

aps authenticate string

no aps authenticate

Syntax Description string Text that must be present to accept the packet on a protected or working interface.
A maximum of eight alphanumeric characters are accepted.

Defaults Authentication is disabled.

Command Modes Interface configuration

Command History Release Modification

11.1 CC This command was introduced.

Usage Guidelines Use the aps authenticate command to ensure that only valid packets are accepted on the OOB
communications channel.
The aps authenticate command must be configured on both the working and protect interfaces.

Examples The following example shows how to enable authentication on POS interface 0 in slot 4:
Router# configure terminal
Router(config)# interface pos 4/0/0
Router(config-if)# aps working 1
Router(config-if)# aps authenticate sanjose
Router(config-if)# end

Related Commands Command Description

aps manual sonet Enables a POS interface as a protect interface.
aps working Configures a POS interface as a working interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-8
 Interface and Hardware Component Commands
aps clear sonet

aps clear sonet

To remove all externally initiated SONET automatic protection switching (APS) commands configured
on a Cisco AS5850, use the aps clear sonet command in privileged EXEC mode.

aps clear sonet slot/port

Syntax Description slot Slot number on an STM-1 trunk card.

/port SONET port number on an STM-1 trunk card. The slash mark is required
between the slot argument and the port argument.

Defaults No APS switch commands are removed.

Command Modes Privileged EXEC

Command History Release Modification

12.3(11)T This command was introduced on the Cisco AS5850.

Usage Guidelines Use the aps clear sonet command to remove any SONET APS commands, such as the aps force sonet
command, that could switch the working fiber to the protect fiber on an STM-1 trunk card.
This command applies to the Cisco AS5850 universal gateway only.

Examples The following example shows how to remove all externally initiated SONET APS switch commands:
Router# aps clear sonet 1/0

Related Commands Command Description

aps force sonet Requests an APS forced switch of a specified port to the alternate port unless
a request of equal or higher priority is in effect.
aps lockout sonet Prevents a working SONET port from switching to a protect SONET port
unless a request of equal or higher priority is in effect.
aps manual sonet Requests a manual APS switch on a SONET port.
aps protect (SONET) Enables SONET APS.

Cisco IOS Interface and Hardware Component Command Reference

IR-9
 Interface and Hardware Component Commands
aps force

aps force
To manually switch the specified circuit to a protect interface, unless a request of equal or higher priority
is in effect, use the aps force command in interface configuration mode. To cancel the switch, use the
no form of this command.

aps force circuit-number

no aps force circuit-number

Syntax Description circuit-number Number of the circuit to switch to the protect interface.

Defaults No circuit is switched.

Command Modes Interface configuration

Command History Release Modification

11.1 CC This command was introduced.

Usage Guidelines Use the aps force command to manually switch the interface to a protect interface when you are not
using the aps revert command. For example, if you need to change the fiber connection, you can
manually force the working interface to switch to the protect interface.
In a one-plus-one (1+1) configuration only, you can use the aps force 0 command to force traffic from
the protect interface back onto the working interface.
The aps force command has a higher priority than any of the signal failures or the aps manual
command.
The aps force command is configured only on protect interfaces.

Examples The following example shows how to force the circuit on POS interface 0 in slot 3 (a protect interface)
back onto a working interface:
Router# configure terminal
Router(config)# interface pos 3/0/0
Router(config-if)# aps protect 10/30/1/1
Router(config-if)# aps force 1
Router(config-if)# end

Related Commands Command Description

aps manual Manually switches a circuit to a protect interface.
aps manual sonet Enables a POS interface as a protect interface.
aps working Configures a POS interface as a working interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-10
 Interface and Hardware Component Commands
aps force sonet

aps force sonet

To force a specified port to switch to the alternate port within a redundant pair unless a request of equal
or higher priority is in effect, use the aps force sonet command in privileged EXEC mode.

aps force sonet slot/port from {protection | working}

Syntax Description slot Slot number on an STM-1 trunk card.

/port SONET port number on an STM-1 trunk card. The slash mark is required
between the slot argument and the port argument.
from protection Specifies that you want to switch from the protect port to the working port.
from working Specifies that you want to switch from the working port to the protect port.

Defaults No port is switched.

Command Modes Privileged EXEC

Command History Release Modification

12.3(11)T This command was introduced on the Cisco AS5850.

Usage Guidelines Forced is a defined APS request priority level. The request succeeds if no higher priority request (lockout
is the only higher priority request) is posted. The aps force sonet command does not persist after a
system restart. The slot and port arguments indicate the SONET interface on which you want to issue
the aps force sonet command. The aps force sonet command has a higher priority than any of the signal
failures or the aps manual sonet command.
For more information about APS priority requests, see the ITU-T G.841 standard.
This command applies to the Cisco AS5850 universal gateway only.

Examples The following example shows how to force the protect port in the SONET controller to become an active
port:
Router# configure terminal
Router(config)# controller sonet 1/0
Router(config-controller)# aps protect
Router(config-controller)# end
Router# aps force sonet 1/0 from working

Cisco IOS Interface and Hardware Component Command Reference

IR-11
 Interface and Hardware Component Commands
aps force sonet

Related Commands Command Description

aps clear sonet Removes any APS switch commands configured using CLI.
aps lockout sonet Prevents a working SONET port from switching to a protect SONET port
unless a request of equal or higher priority is in effect.
aps manual sonet Requests a manual APS switch on a SONET port.
aps protect (SONET) Enables SONET APS.

Cisco IOS Interface and Hardware Component Command Reference

IR-12
 Interface and Hardware Component Commands
aps group

aps group
To allow more than one protect and working interface to be supported on a router, use the aps group
command in interface configuration mode. To remove a group, use the no form of this command.

aps group group-number

no aps group group-number

Syntax Description group-number Number of the group. Default is 0.

Defaults No groups exist.

Note 0 is a valid group number.

Command Modes Interface configuration

Command History Release Modification

11.1 CC This command was introduced.

Usage Guidelines Use the aps group command to specify more than one working and protect interfaces on a router, for
example, working channel for group 0 and protect channel for group 1 on one router, and working
channel for group 1 and protect channel for group 0 on another router.
The default group number is 0. The aps group 0 command does not imply that no groups exist.
The aps group command must be configured on both the protect and working interfaces.

Examples The following example shows hw to configure two working/protect interface pairs. Working interface
(3/0/0) is configured in group 10 (the protect interface for this working interface is configured on another
router), and protect interface (2/0/1) is configured in group 20.
Router# configure terminal
Router(config)# interface ethernet 0/0
Router(config-if)# ip address 10.7.7.6 255.255.255.0
Router(config-if)# exit
Router(config)# interface pos 3/0/0
Router(config-if)# aps group 10
Router(config-if)# aps working 1
Router(config-if)# exit
Router(config)# interface pos 2/0/1
Router(config-if)# aps group 20
Router(config-if)# aps protect 1 10.7.7.7
Router(config-if)# end

Cisco IOS Interface and Hardware Component Command Reference

IR-13
 Interface and Hardware Component Commands
aps group

On the second router, protect interface (4/0/0) is configured in group 10, and working interface (5/0/0)
is configured in group 20 (the protect interface for this working interface is configured on another
router).
Router(config)# interface ethernet 0/0
Router(config-if)# ip address 10.7.7.7 255.255.255.0
Router(config-if)# exit
Router(config)# interface pos 4/0/0
Router(config-if)# aps group 10
Router(config-if)# aps protect 1 10.7.7.6
Router(config-if)# exit
Router(config)# interface pos 5/0/0
Router(config-if)# aps group 20
Router(config-if)# aps working 1
Router(config-if)# end

Related Commands Command Description

aps manual sonet Enables a POS interface as a protect interface.
aps working Configures a POS interface as a working interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-14
 Interface and Hardware Component Commands
aps lockout

aps lockout
To prevent a working interface from switching to a protect interface, use the aps lockout command in
interface configuration mode. To remove the lockout, use the no form of this command.

aps lockout circuit-number

no aps lockout circuit-number

Syntax Description circuit-number Number of the circuit to lock out.

Defaults No lockout exists.

Command Modes Interface configuration

Command History Release Modification

11.1 CC This command was introduced.

Usage Guidelines The aps lockout command is configured only on protect interfaces.

Examples The following example shows how to lock out POS interface 3/0/0 (that is, prevents the circuit from
switching to a protect interface if the working circuit becomes unavailable):
Router# configure terminal
Router(config)# interface pos 3/0/0
Router(config-if)# aps protect 1 10.7.7.7
Router(config-if)# aps lockout 1
Router(config-if)# end

Related Commands Command Description

aps manual sonet Enables a POS interface as a protect interface.
aps working Configures a POS interface as a working interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-15
 Interface and Hardware Component Commands
aps lockout sonet

aps lockout sonet

To prevent a working port from switching to a protect port unless a request of equal or higher priority is
in effect, use the aps lockout sonet command in privileged EXEC mode.

aps lockout sonet slot/port

Syntax Description slot Slot number on an STM-1 trunk card.

/port SONET port number on an STM-1 trunk card. The slash mark is required
between the slot argument and the port argument.

Defaults No lockout exists; that is, a working port is not prevented from switching to a protect port.

Command Modes Privileged EXEC

Command History Release Modification

12.3(11)T This command was introduced on the Cisco AS5850.

Usage Guidelines Lockout is defined as the highest APS request priority level.
The aps lockout sonet command does not persist after a system restart. The slot and port arguments
indicate the SONET interface from which the protect port is to be locked out. When the specified port
is locked out, SONET APS switching from the working port is not allowed.
For more information about APS priority requests, see the ITU-T G.841 standard.
This command applies to the Cisco AS5850 universal gateway only.

Examples The following example shows how to lock out SONET port 1/0 (prevents SONET APS switching to a
protect interface if the working circuit becomes unavailable):
Router# configure terminal
Router(config)# controller sonet 1/0
Router(config-controller)# aps protect
Router(config-controller)# end
Router# aps lockout sonet 1/0

Cisco IOS Interface and Hardware Component Command Reference

IR-16
 Interface and Hardware Component Commands
aps lockout sonet

Related Commands Command Description

aps clear sonet Removes any APS switch commands configured using CLI.
aps force sonet Requests an APS forced switch of a specified port to the alternate port unless
a request of equal or higher priority is in effect.
aps manual sonet Requests a manual APS switch on a SONET port.
aps protect (SONET) Enables SONET APS.

Cisco IOS Interface and Hardware Component Command Reference

IR-17
 Interface and Hardware Component Commands
aps manual

aps manual
To manually switch a circuit to a protect interface, use the aps manual command in interface
configuration mode. To cancel the switch, use the no form of this command.

aps manual circuit-number

no aps manual circuit-number

Syntax Description circuit-number Number of the circuit to switch to a protect interface.

Defaults No circuit is switched.

Command Modes Interface configuration

Command History Release Modification

11.1 CC This command was introduced.

Usage Guidelines Use the aps manual command to manually switch the interface to a protect interface. For example, you
can use this feature when you need to perform maintenance on the working channel. If a protection
switch is already up, you can also use the aps manual command to revert the communication link back
to the working interface before the wait to restore (WTR) time has expired. The WTR time period is set
by the aps revert command.
In a one-plus-one (1+1) configuration only, you can use the aps manual 0 command to force traffic from
the protect interface back onto the working interface.
The aps manual command is a lower priority than any of the signal failures or the aps force command.

Examples The following example shows how to force the circuit on POS interface 0 in slot 3 (a working interface)
back onto the protect interface:
Router# configure terminal
Router(config)# interface pos 3/0/0
Router(config-if)# aps working 1
Router(config-if)# aps manual 1
Router(config-if)# end

Related Commands Command Description

aps group Manually switches the specified circuit to a protect interface, unless a
request of equal or higher priority is in effect.
aps manual sonet Enables a POS interface as a protect interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-18
Interface and Hardware Component Commands
aps manual

Command Description
aps revert Enables automatic switchover from the protect interface to the working
interface after the working interface becomes available.
aps working Configures a POS interface as a working interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-19
 Interface and Hardware Component Commands
aps manual sonet

aps manual sonet

To manually switch to the alternate port within a redundant pair unless a request of equal or higher
priority is in effect, use the aps manual sonet command in privileged EXEC mode.

aps manual sonet slot/port from {protection | working}

Syntax Description slot Slot number on an STM-1 trunk card.

/port SONET port number on an STM-1 trunk card. The slash mark is required
between the slot argument and the port argument.
from protection Specifies that you want to switch from the protect port to the working port.
from working Specifies that you want to switch from the working port to the protect port.

Defaults No port is switched.

Command Modes Privileged EXEC

Command History Release Modification

12.3(11)T This command was introduced on the Cisco AS5850.

Usage Guidelines Use the aps manual sonet command to manually switch the active port to the alternate port. For
example, you can use this command when you need to perform maintenance on the working port.
Manual is a defined APS request priority level. The request succeeds if no higher priority request is
posted. The aps manual sonet command does not persist after a system restart. The slot and port
arguments indicate the SONET interface on which you want to issue the aps manual sonet command.
The aps manual sonet command has a lower priority than any of the signal failures or the aps force
sonet command.
For more information about APS priority requests, see the ITU-T G.841 standard.
This command applies to the Cisco AS5850 universal gateway only.

Examples The following example shows how to manually switch the working port, SONET port 1/0, to the protect
port:
Router# configure terminal
Router(config)# controller sonet 1/0
Router(config-controller)# aps protect
Router(config-controller)# end
Router# aps manual sonet 1/0 from working

Cisco IOS Interface and Hardware Component Command Reference

IR-20
 Interface and Hardware Component Commands
aps manual sonet

Related Commands Command Description

aps clear sonet Removes any APS switch commands configured using CLI.
aps force sonet Requests an APS forced switch of a specified port to the alternate port unless
a request of equal or higher priority is in effect.
aps lockout sonet Prevents a working SONET port from switching to a protect SONET port
unless a request of equal or higher priority is in effect.
aps protect (SONET) Enables SONET APS.

Cisco IOS Interface and Hardware Component Command Reference

IR-21
 Interface and Hardware Component Commands
aps protect

aps protect
To enable a POS interface as a protect interface, use the aps protect command in interface configuration
mode. To remove the POS interface as a protect interface, use the no form of this command.

aps protect circuit-number ip-address

no aps protect circuit-number ip-address

Syntax Description circuit-number Number of the circuit to enable as a protect interface.

ip-address IP address of the router that has the working POS interface.

Defaults No circuit is protected.

Command Modes Interface configuration

Command History Release Modification

11.1 CC This command was introduced.

Usage Guidelines Use the aps protect command to configure the POS interface used by a working interface if the working
interface becomes unavailable because of a router failure, degradation or loss of channel signal, or
manual intervention.

Caution Configure the working interface before configuring the protect interface to keep the protect
interface from becoming the active circuit and disabling the working circuit when it is finally discovered.

Examples The following example shows how to configure circuit 1 on POS interface 5/0/0 as a protect interface
for the working interface on the router with the IP address of 10.7.7.7. For information on how to
configure the working interface, refer to the aps working command.
Router# configure terminal
Router(config)# interface pos 5/0/0
Router(config-if)# aps protect 1 10.7.7.7
Router(config-if)# end

Related Commands Command Description

aps working Configures a POS interface as a working interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-22
 Interface and Hardware Component Commands
aps protect (SONET)

aps protect (SONET)

To enable automatic protection switching (APS) on a SONET port in an STM-1 trunk card, use the aps
protect command in controller configuration mode. To disable APS on the SONET port, use the no form
of this command.

aps protect

no aps protect

Syntax Description This command has no arguments or keywords.

Defaults APS is disabled.

Command Modes Controller configuration

Command History Release Modification

12.3(11)T This command was introduced on the Cisco AS5850.

Usage Guidelines Use the aps protect command to enable APS on a protect SONET port as a working port if the working
port becomes unavailable because of a fiber failure, degradation or loss of channel signal, or manual
intervention.

Examples The following example shows how to enable APS on SONET port 0/1 in an STM-1 trunk card.
Router# configure terminal
Router(config)# controller sonet 1/0
Router(config-controller)# aps protect
Router(config-controller)# end

Related Commands Command Description

aps unidirectional Configures a protect SONET port for unidirectional mode.
show controllers sonet Displays information about SONET controllers.

Cisco IOS Interface and Hardware Component Command Reference

IR-23
 Interface and Hardware Component Commands
aps revert

aps revert
To enable automatic switchover from the protect interface to the working interface after the working
interface becomes available, use the aps revert command in interface configuration mode. To disable
automatic switchover, use the no form of this command.

aps revert minutes

no aps revert

Syntax Description minutes Number of minutes until the circuit is switched back to the working interface
after the working interface is available.

Defaults Automatic switchover is disabled.

Command Modes Interface configuration

Command History Release Modification

11.1 CC This command was introduced.

Usage Guidelines Use the aps revert command to return the circuit to the working interface when it becomes available.
The aps revert command is configured only on protect interfaces.

Examples The following example shows how to enable circuit 1 on POS interface 5/0/0 to revert to the working
interface after the working interface has been available for 3 minutes:
Router# configure terminal
Router(config)# interface pos 5/0/0
Router(config-if)# aps protect 1 10.7.7.7
Router(config-if)# aps revert 3
Router(config-if)# end

Related Commands Command Description

aps manual sonet Enables a POS interface as a protect interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-24
 Interface and Hardware Component Commands
aps timers

aps timers
To change the time between hello packets and the time before the protect interface process declares a
working interface router to be down, use the aps timers command in interface configuration mode. To
return to the default timers, use the no form of this command.

aps timers seconds1 seconds2

no aps timers

Syntax Description seconds1 Number of seconds to wait before sending a hello packet (hello timer). Default
is 1.
seconds2 Number of seconds to wait to receive a response from a hello packet before
the interface is declared down (hold timer). Default is 3.

Defaults Hello time is 1 second

Hold time is 3 seconds.

Command Modes Interface configuration

Command History Release Modification

11.1 CC This command was introduced.

Usage Guidelines Use the aps timers command to control the time between an automatic switchover from the protect
interface to the working interface after the working interface becomes available.
Normally, the hold time is greater than or equal to three times the hello time.
The aps timers command is configured only on protect interfaces.

Examples The following example shows how to specify a hello time of 2 seconds and a hold time of 6 seconds on
circuit 1 on POS interface 5/0/0:
Router# configure terminal
Router(config)# interface pos 5/0/0
Router(config-if)# aps working 1
Router(config-if)# aps timers 2 6
Router(config-if)# end

Cisco IOS Interface and Hardware Component Command Reference

IR-25
 Interface and Hardware Component Commands
aps unidirectional

aps unidirectional
To configure a protect interface for unidirectional mode, use the aps unidirectional command in
controller configuration or interface configuration mode. To return to the default, bidirectional mode,
use the no form of this command.

aps unidirectional

no aps unidirectional

Syntax Description This command has no arguments or keywords.

Defaults Bidirectional mode

Command Modes Controller configuration

Interface configuration

Command History Release Modification

11.1 CC This command was introduced.
12.3(11)T Support for SONET APS using an STM-1 card was added on the
Cisco AS5850.

Usage Guidelines The aps unidirectional command is configured only on protect interfaces.
Use the aps unidirectional command when you must interoperate with SONET network equipment,
add/drop multiplexors (ADMs) that supports unidirectional mode.

Note We recommend bidirectional mode when it is supported by the interconnecting SONET equipment.
When the protect interface is configured as bidirectional, the working and protect interfaces must
cooperate to switch the transmit and receive SONET channel in a bidirectional fashion. This
happens automatically when the SONET network equipment is in bidirectional mode.

Examples The following example shows how to configure POS interface 3/0/0 for unidirectional mode on a Cisco
12000 series router:
Router# configure terminal
Router(config)# interface pos 3/0/0
Router(config-if)# aps unidirectional
Router(config-if)# aps protect 1 10.7.7.7
Router(config-if)# end

Cisco IOS Interface and Hardware Component Command Reference

IR-26
Interface and Hardware Component Commands
aps unidirectional

The following example shows how to configure SONET port 0/0 for unidirectional mode on a Cisco
AS5850 universal gateway using an STM-1 trunk card:
Router# configure terminal
Router(config)# controller sonet 0/0
Router(config-controller)# aps protect
Router(config-controller)# aps unidirectional
Router(config-controller)# end

Cisco IOS Interface and Hardware Component Command Reference

IR-27
 Interface and Hardware Component Commands
aps working

aps working
To configure a Packet over SONET (POS) interface as a working interface, use the aps working
command in interface configuration mode. To remove the protect option from the POS interface, use the
no form of this command.

aps working circuit-number

no aps working circuit-number

Syntax Description circuit-number Circuit number associated with this working interface.

Defaults No circuit is configured as working.

Command Modes Interface configuration

Command History Release Modification

11.1 CC This command was introduced.

Usage Guidelines When a working interface becomes unavailable because of a router failure, degradation or loss of
channel signal, or manual intervention, the circuit is switched to the protect interface to maintain the
connection.
To enable the circuit on the protect interface to switch back to the working interface after the working
interface becomes available again, use the aps revert command in interface configuration mode.

Caution Configure the working interface before configuring the protect interface to keep the protect interface
from becoming the active circuit and disabling the working circuit when it is finally discovered.

Examples The following example shows how to configure POS interface 0 in slot 4 as a working interface. For
information on how to configure the protect interface, refer to the aps protect command.
Router# configure terminal
Router(config)# interface pos 4/0/0
Router(config-if)# aps working 1
Router(config-if)# end

Related Commands Command Description

aps manual sonet Enables a POS interface as a protect interface.
aps revert Enables automatic switchover from the protect interface to the working
interface after the working interface becomes available.

Cisco IOS Interface and Hardware Component Command Reference

IR-28
 Interface and Hardware Component Commands
atm sonet

atm sonet
To set the mode of operation and thus control the type of the ATM cell used for cell-rate decoupling on
the SONET physical layer interface module (PLIM), use the atm sonet command in interface
configuration mode. To restore the default Synchronous Transport Signal level 12, concatenated
(STS-12c) operation, use the no form of this command.

atm sonet [stm-4]

no atm sonet [stm-4]

Syntax Description stm-4 (Optional) Synchronous Digital Hierarchy/Synchronous Transport Signal

level 4 (SDH/STM-4) operation (ITU-T specification).

Defaults STS-12c

Command Modes Interface configuration

Command History Release Modification

11.1 CC This command was introduced.
11.2 GS The stm-4 keyword was added.

Usage Guidelines Use STM-4 in applications in which SDH framing is required.

Use the default (STS-12c) in applications in which the ATM switch requires “unassigned cells” for rate
adaptation. An unassigned cell contains 32 zeros.

Examples The following example shows how to set the mode of operation to SONET STM-4 on ATM interface 3/0:
Router(config)# interface atm 3/0
Router(config-if)# atm sonet stm-4
Router(config-if)# end

Cisco IOS Interface and Hardware Component Command Reference

IR-29
 Interface and Hardware Component Commands
au-3

au-3
To configure a particular Administrative Unit type 3 (AU-3) of an E1 line that has been mapped to an
AU-3, use the au-3 command in controller configuration mode.

au-3 au-3-number

Syntax Description au-3-number Number in the range from 1 to 3.

Defaults No default behavior or values

Command Modes Controller configuration

Command History Release Modification

12.0(14)S This command was introduced.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.

Usage Guidelines An administrative unit group (AUG) of an STM-1 can be derived from either AU-3s or an AU-4. Use the
aug mapping au-3 configuration controller command to map the AUG to an AU-3 with the following
muxing/alignment/mapping:
C-12 <--> VC-12 <--> TU-12 <--> TUG-2 <--> VC-3 <--> AU-3 <--> AUG
Configuring the au-3 command enables you to enter configuration controller au3 command mode and
creates a serial interface with the following name format:
slot/port-adapter/port.au-3-number/tug-2-number/e1-number
The aug mapping au-3 and au-3 commands are available only when SDH framing is configured.

Examples The following example shows how to configure AUG mapping to be derived from an AU-3 and selects
AU-3 3 to configure as a serial interface:
Router(config)# controller sonet 2/0/0
Router(config-controller)# aug mapping au-3
Router(config-ctrlr-au3)# au-3 3

Related Commands Command Description

au-4 tug-3 Specifies a TUG-3 for configuration.
aug mapping Configures the AUG mapping mode of the PA-MC-STM-1 to AU-3.

Cisco IOS Interface and Hardware Component Command Reference

IR-30
 Interface and Hardware Component Commands
au-4 tug-3

au-4 tug-3
To specify the Administrative Unit type 4 (AU-4) and Tributary Unit group type 3 (TUG-3) number of
an E1 line that has been mapped to an AU-4, use the au-4 tug-3 command in controller configuration
mode.

au-4 au-4-number tug-3 tug-3-number

Syntax Description au-4-number Number in the range from 1 to N where N is the STM level. Default is 1.
tug-3-number Number in the range from 1 to 3.

Defaults Default au-4-number value for STM-1 card is 1.

Command Modes Controller configuration

Command History Release Modification

12.0(14)S This command was introduced.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.

Usage Guidelines An AUG of an STM-1 can be derived from either AU-3s or an AU-4. Use the aug mapping au-4
configuration controller command to map the AUG to an TUG-3 with the following
muxing/alignment/mapping:
C-12 <--> VC-12 <--> TU-12< --> TUG-2 <--> TUG-3 <--> VC-4 <--> AU-4 <--> AUG
Configuring the au-4 command enables you to enter configuration controller tug3 command mode and
creates a serial interface with the following name format:
slot/port-adapter/port.au-4-number/tug-2-number/e1-number
The aug mapping au-4 and au-4 tug-3 commands are available only when SDH framing is configured.

Examples The following example shows how to configure AUG mapping to be derived from a TUG-3 and selects
TUG-3 1 of AU-4 1:
Router(config)# controller sonet 2/0/0
Router(config-controller)# aug mapping au-4
Router(config-ctrlr-tug3)# au-4 1 tug-3 1

Related Commands Command Description

au-3 Specifies an AU-3 for configuration.
aug mapping Configures the AUG mapping mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-31
 Interface and Hardware Component Commands
aug mapping

aug mapping
To configure administrative unit group (AUG) mapping when SDH framing is selected, use the aug
mapping command in controller configuration mode.

aug mapping {au-3 | au-4}

Syntax Description au-3 Specifies use of three paths—a path is known as an Administrative Unit
(AU)—consisting of seven TUG-2s (Tributary Unit group type 2). Each TUG-2
consists of three virtual containers (VC-12s), which carry E1 lines resulting in 21 E1
lines within one AU-3 path.
au-4 Specifies use of one path consisting of three TUG-3 types. Each TUG-3 consists of
seven TUG-2s, resulting in a total of 63 E1 lines within one AU-4 path. This is the
default.

Defaults au-4

Command Modes Controller configuration

Command History Release Modification

12.0(14)S This command was introduced.
12.0(17)S Support for the two-port STM-1/OC-3 channelized E1/T1 line card was
added.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.

Usage Guidelines In SDH, there are two possible mapping/multiplexing schemes for most payload types: ANSI and ETSI.
In ANSI mapping, the Low Order payloads are aggregated into a VC-3 High Order Path. An AU pointer
is added to the VC-3 to create an AU-3. Three such AU-3s are then synchronously multiplexed into an
AUG. The multiplexing scheme is as follows:
… VC-3 <–> AU-3 (x3) <–> AUG <–> STM-1
SDH ANSI mapping is very similar to the SONET frame structure.
In ETSI mapping, the Low Order payloads are aggregated into a VC-4 High Order Path. An AU pointer
is added to the VC-4 to create an AU-4 (Administrative Unit type 4). One AU-4 is “multiplexed” into an
AUG (AU group), which is to say, the AUG is, in fact, equivalent to an AU-4. The multiplexing scheme
is as follows:
… TUG-3 (x3) <–> VC-4 <–> AU-4 (x1) <–> STM-1
This command is available only when SDH framing is configured.
This command does not have a no form because data must flow using one of the two
mapping/multiplexing schemes.

Cisco IOS Interface and Hardware Component Command Reference

IR-32
 Interface and Hardware Component Commands
aug mapping

Examples The following example shows how to configure AU-3 mapping for the STM-1 trunk card:
Router(config)# controller sonet 1/0
Router(config-controller)# aug mapping au-3

Cisco IOS Interface and Hardware Component Command Reference

IR-33
 Interface and Hardware Component Commands
auto-polarity

auto-polarity
To enable automatic receiver polarity reversal on a hub port connected to an Ethernet interface of a
Cisco 2505 or Cisco 2507 router, use the auto-polarity command in hub configuration mode. To disable
this function, use the no form of this command.

auto-polarity

no auto-polarity

Syntax Description This command has no arguments or keywords.

Defaults Enabled

Command Modes Hub configuration

Command History Release Modification

10.3 This command was introduced.

Usage Guidelines This command applies to a port on an Ethernet hub only.

Examples The following example shows how to enable automatic receiver polarity reversal on hub 0, ports 1
through 3:
Router(config)# hub ethernet 0 1 3
Router(config-hub)# auto-polarity

Related Commands Command Description

hub Enables and configures a port on an Ethernet hub of a Cisco 2505 or
Cisco 2507 router.

Cisco IOS Interface and Hardware Component Command Reference

IR-34
 Interface and Hardware Component Commands
b2 sd-ber

b2 sd-ber
To set the signal degrade bit-error rate (BER) threshold values, use the b2 sd-ber command in controller
configuration mode. To return to the default setting, use the no form of this command.

b2 sd-ber rate

no b2 sd-ber

Syntax Description rate Bit-error rate from 3 to 9 (10-n). The value of 9 represents better quality, and
the value of 3 represents lower quality. The default is 6.

Defaults rate: 6

Command Modes Controller configuration

Command History Release Modification

12.2(15)T This command was introduced.

Usage Guidelines Use this command to configure the threshold for degradation of quality of signal with b2 errors.

Examples The following example shows how to configure a signal degrade BER threshold value of 7 on the SONET
controller:
Router(config)# controller sonet 1/0
Router(config-controller)# b2 sd-ber 7

Related Commands Command Description

show controllers sonet Displays information about the SONET controllers.

Cisco IOS Interface and Hardware Component Command Reference

IR-35
 Interface and Hardware Component Commands
b2 sf-ber

b2 sf-ber
To set the signal failure bit-error rate (BER) threshold values, use the b2 sf-ber command in controller
configuration mode. To return to the default setting, use the no form of this command.

b2 sf-ber rate

no b2 sf-ber rate

Syntax Description rate Bit-error rate from 3 to 9 (10-n). The value of 9 represents better quality, and
the value of 3 represents lower quality. The default is 3.

Defaults rate: 3

Command Modes Controller configuration

Command History Release Modification

12.2(15)T This command was introduced.

Usage Guidelines Use this command to configure the threshold for failure of quality of signal with b2 errors. The value of
9 represents better quality and the value of 3 represents lower quality.

Examples The following example shows how to configure a signal failure BER threshold value of 7 on the SONET
controller:
Router(config)# controller sonet 1/0
Router(config-controller)# b2 sf-ber 7

Related Commands Command Description

show controllers sonet Displays information about the SONET controllers.

Cisco IOS Interface and Hardware Component Command Reference

IR-36
 Interface and Hardware Component Commands
bandwidth (interface)

bandwidth (interface)
To set and communicate the current bandwidth value for an interface to higher-level protocols, use the
bandwidth command in interface configuration mode. To restore the default values, use the no form of
this command.

bandwidth kbps

no bandwidth

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

Defaults Default bandwidth values are set during startup; the bandwidth values can be displayed using the
show interfaces EXEC command.

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines Bandwidth Information

The bandwidth command sets an informational parameter to communicate only the current bandwidth
to the higher-level protocols; you cannot adjust the actual bandwidth of an interface using this command.

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

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

Examples The following example shows how to set the full bandwidth for DS3 transmissions:
Router(config)# interface serial 0
Router(config-if)# bandwidth 44736

Related Commands Command Description

show interfaces Displays statistics for all interfaces configured on the router.

Cisco IOS Interface and Hardware Component Command Reference

IR-37
 Interface and Hardware Component Commands
bert abort

bert abort
To end a bit error rate testing session, use the bert abort command in privileged EXEC mode.

bert abort

Syntax Description This command has no arguments or keywords.

Command Modes Privileged EXEC

Command History Release Modification

12.0(2)XD This command was introduced.
12.0(3)T This command was integrated into Cisco IOS Release 12.0(3)T.

Usage Guidelines Use the bert abort command to cancel bit error rate testing on each port of the Cisco AS5300 router.
The bit error rate test (BERT) feature enables you to test the quality of the connected PRI links by direct
comparison of a pseudorandom or repetitive test pattern with an identical locally generated test pattern.

Examples The following is sample output from the bert abort command when no bit error rate test is running:
Router# bert abort
Router#
17:53:33: There is no BERT Test running ....

The following is sample output from the bert abort command when a bit error rate test is running:
Router# bert abort
Do you really want to abort the current BERT [confirm] Y

17:56:56: %BERT-6-BERT_RESULTS: Controller T1 0 Profile default : The Test was

aborted by User

Related Commands Command Description

bert controller Starts a bit error rate test for a particular port.
bert pattern (T1/E1) Sets up various bit error rate testing profiles.

Cisco IOS Interface and Hardware Component Command Reference

IR-38
 Interface and Hardware Component Commands
bert controller

bert controller
To start a bit error rate test (BERT) for a particular port, use the bert controller command in privileged
EXEC mode.

bert controller [type-controller] {last-controller | profile [number | default]}

Syntax Description type-controller (Optional) Type of controller being tested. Use either T1 or E1
depending on the type of facility.
last-controller (Optional) Last controller number. The valid range is from 0 to 7.
profile Sets the profile numbers for the bit error rate test.
number (Optional) Numbers of the test profiles to use. The valid range is from
0 to 15. The default is 0.
default (Optional) Executes the default bit error rate test (0).

Defaults number: 0

Command Modes Privileged EXEC

Command History Release Modification

12.0(2)XD This command was introduced.
12.0(3)T This command was integrated into Cisco IOS Release 12.0(3)T.

Usage Guidelines Use the bert controller command to start a bit error rate test for a particular port on a Cisco AS5300
router.

Quality Testing
The BERT feature enables you to test the quality of the connected PRI links by direct comparison of a
pseudorandom or repetitive test pattern with an identical locally generated test pattern.

E1 Controllers
The E1 controller cannot be set in loopback mode from the Cisco AS5300. For the bert controller
command to work correctly with the E1 controller, the controller must be configured as a channel group
or channel-associated signaling (CAS) and the line must be configured as a remote loop from the switch
side of the link.

Examples The following is sample output from the bert controller command with the profile set at the default for
the bit rate:
Router# bert controller T1 profile default

Cisco IOS Interface and Hardware Component Command Reference

IR-39
 Interface and Hardware Component Commands
bert controller

Press <Return> to start the BERT [confirm] Y

17:55:34: %BERT-6-BERT_START: Starting BERT on Interface 0 with Profile default

Data in current interval (10 seconds elapsed):
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs

Table 1 describes the significant fields shown in the display.

Table 1 bert controller Field Description s

Field Description
Data in Current Interval Shows the current accumulation period, which rolls into the 24-hour
accumulation every 15 minutes. As the latest 15-minute
accumulation period enters the buffer, the oldest 15-minute period is
deleted. The accumulation period is from 1 to 900 seconds.
Line Code Violations For alternate mark inversion (AMI)-coded signals, a line code
violation is a bipolar violation (BPV) occurrence. Indicates the
occurrence of either a BPV or an excessive zeros (EXZ) error event.
Path Code Violations When super frame (SF) (D4) framing is used, a path code violation is
a framing error. When extended super frame (ESF) framing is used,
a path code violation is a cyclic redundancy check type 6 (CRC-6)
error. Indicates a frame-synchronization bit error in the D4 and
E1-non-CRC formats, or a CRC error in the ESF and E1-CRC
formats.
Slip Secs Indicates the replication or deletion of the payload bits of a DS1
frame. A slip may be indicated when there is a difference between the
timing of a synchronous receiving terminal and the received signal.
Fr Loss Secs Seconds during which the framing pattern has been lost. Indicates the
number of seconds for which an Out-of-Frame error is detected.
Line Err Secs A line error second (LES) is a second in which one or more line code
violation (LCV or CV-L) errors are detected.
Degraded Mins A degraded minute is one in which the estimated error rate exceeds
1-6 but does not exceed 1-3.
Errored Secs In extended superframe (ESF) and E1-CRC links, an errored second
is a second in which one of the following is detected: one or more
path code violations; one or more Out-of-Frame defects; one or more
controlled slip events; an alarm indication signal (AIS) defect.
For D4 and E1-non-CRC links, the presence of bipolar violations also
triggers an errored second.
Bursty Err Secs Second with fewer than 320 and more than 1 path code violation
error, no severely errored frame defects, and no detected incoming
AIS defects. Controlled slips are not included in this parameter.

Cisco IOS Interface and Hardware Component Command Reference

IR-40
 Interface and Hardware Component Commands
bert controller

Table 1 bert controller Field Description (continued)s

Severely Err Secs For ESF signals, a second with one of the following errors: 320 or
more path code violation errors; one or more Out-of-Frame defects;
a detected AIS defect.
For E1-CRC signals, a second with one of the following errors: 832
or more path code violation errors; one or more Out-of-Frame
defects.
For E1-non-CRC signals, a second with 2048 or more line code
violations.
For D4 signals, a count of 1-second intervals with framing errors, or
an Out-of-Frame defect, or 1544 line code violations.
Unavail Secs Count for every second in which an unavailable signal state occurs.
This term is used by new standards in place of failed seconds (FS).

Related Commands Command Description

bert abort Aborts a bit error rate testing session.
bert pattern (T1/E1) Sets up various bit error rate testing profiles.

Cisco IOS Interface and Hardware Component Command Reference

IR-41
 Interface and Hardware Component Commands
bert pattern (T1/E1)

bert pattern (T1/E1)

To enable a bit error rate test (BERT) pattern on a T1 or E1 line, use the bert pattern command in
controller configuration mode. To disable a BER test pattern, use the no form of this command.

bert pattern {2^23 | 2^20 | 2^20-QRSS | 2^15 | 2^11 | 1s | 0s | alt-0-1} interval time

no bert pattern {2^23 | 2^20 | 2^20-QRSS | 2^15 | 2^11 | 1s | 0s | alt-0-1} interval time

Syntax Description 2^23 Invokes a pseudorandom 0.151 test pattern that is 8,388,607 bits in length.
2^20 Invokes a pseudorandom 0.153 test pattern that is 1,048,575 bits in length.
2^20-QRSS Invokes a pseudorandom quasi-random signal sequence (QRSS) 0.153 test
pattern that is 1,048,575 bits in length.
2^15 Invokes a pseudorandom 0.151 test pattern that is 32,768 bits in length.
2^11 Invokes a pseudorandom test pattern that is 2,048 bits in length.
1s Invokes a repeating pattern of ones (...111...).
0s Invokes a repeating pattern of zeros (...000...).
alt-0-1 Invokes a repeating pattern of alternating zeros and ones (...01010...).
interval time Specifies the duration (in minutes) of the BER test. The interval can be a value
from 1 to 14400. There is no default.

Defaults Disabled

Command Modes Controller configuration

Command History Release Modification

11.1CC This command was introduced.
12.0(5)XE This command was enhanced as an ATM interface configuration command.
12.0(7)XE1 This command was implemented on Cisco 7100 series routers.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.

Usage Guidelines BER testing is supported on each of the T1 or E1 links, is done only over an unframed T1 or E1 signal,
and is run on only one port at a time.
To view the BER test results, use the show controllers atm EXEC command. The BERT results include
the following information:
• Type of test pattern selected
• Status of the test
• Interval selected
• Time remaining on the BER test

Cisco IOS Interface and Hardware Component Command Reference

IR-42
 Interface and Hardware Component Commands
bert pattern (T1/E1)

• Total bit errors

• Total bits received
When the T1 or E1 line has a BER test running, the line state is DOWN and the status field shows the
current/last result of the test.
The bert pattern command is not written to NVRAM because this command is only used to test the T1
or E1 line for a short predefined interval, and to avoid accidentally saving the command.

Examples The following example shows how to run a BERT pattern of all zeros on a Cisco 7200 series router for
30 minutes on the T1 controller in slot 1:
Router(config)# controller T1 1/0
Router(config-if)# bert pattern 0s interval 30

Related Commands Command Description

show controllers atm Displays information about T1/E1 links in Cisco 7100 series routers,
Cisco 7200 series routers, and Cisco 7500 series routers.

Cisco IOS Interface and Hardware Component Command Reference

IR-43
 Interface and Hardware Component Commands
bert pattern (T3/E3)

bert pattern (T3/E3)

To enable a bit error rate test (BERT) pattern on a T3 or E3 controller, use the bert pattern command
in controller configuration mode. To disable a BER test pattern, use the no form of this command.

bert pattern {2^23 | 2^20 | 2^15 | 1s | 0s | alt-0-1} interval time

no bert pattern

Syntax Description 2^23 Invokes a pseudorandom 0.151 test pattern that is 8,388,607 bits in length.
2^20 Invokes a pseudorandom 0.153 test pattern that is 1,048,575 bits in length.
2^15 Invokes a pseudorandom 0.151 test pattern that is 32,768 bits in length.
1s Invokes a repeating pattern of ones (...111...).
0s Invokes a repeating pattern of zeros (...000...).
alt-0-1 Invokes a repeating pattern of alternating zeros and ones (...01010...).
interval time Specifies the duration (in minutes) of the BER test. The interval can be a value
from 1 to 14400. There is no default.

Defaults Disabled

Command Modes Controller configuration

Command History Release Modification

11.1 CC This command was introduced.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and
implemented on the following platforms: Cisco 2650XM, Cisco 2651XM,
Cisco 2691, Cisco 3660 series, Cisco 3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.

Usage Guidelines BER testing is supported on T3/E3 links and is done only over framed T3 or E3 signals, unless E3
framing is in bypass mode.
To display the BER test results, use the show controllers t3 or show controllers e3 EXEC command.
The BER test results include the following information:
• Type of test pattern selected
• Status of the test
• Interval selected
• Time remaining on the BER test

Cisco IOS Interface and Hardware Component Command Reference

IR-44
 Interface and Hardware Component Commands
bert pattern (T3/E3)

• Total bit errors

• Total bits received
When the T3 or E3 line has a BER test running, the line state is DOWN and the status field shows the
current or last result of the test.
The bert pattern command is not written to NVRAM because this command is used only to test the T3
or E3 line for a short predefined interval, and to avoid accidentally saving the command.

Examples The following example shows how to run a BERT pattern of all zeros for 30 minutes on the T3 controller
in slot 1:
Router(config)# controller T3 1/0
Router(config-if)# bert pattern 0s interval 30

Related Commands Command Description

show controllers e3 Displays information about E3 controllers.
show controllers t3 Displays information about T3 controllers.

Cisco IOS Interface and Hardware Component Command Reference

IR-45
 Interface and Hardware Component Commands
bert profile

bert profile
To set up various bit error rate testing profiles, use the bert profile command in global configuration
mode. To disable the particular bit error rate test (BERT) profile indicated by profile number, use the no
form of this command.

bert profile number pattern pattern threshold threshold error-injection err-inj duration time

no bert profile number pattern pattern threshold threshold error-injection err-inj duration time

Syntax Description number BERT profile number. The valid range is from 1 to 15. This is the number assigned
to a particular set of parameters. If no such profile of the same number exists in the
system, a new profile is created with that number; otherwise, an existing set of
parameters with that profile number is overwritten by the new profile.
pattern Pattern that BERT will generate on the line.
pattern 0s—Repetitive pattern, all zeros.
1_in_16—n repetitive pattern, 1 in 16.
1s—n repetitive pattern, all ones.
211-O.152—n pseudorandom pattern, 2 11 -1 O.152.
215-O.15—n pseudorandom pattern, 215 -1 O.151.
220-O.151QRSS—n pseudorandom pattern, 220 -1 O.151 QRSS. (This is the
default.)
220-O.153—n pseudorandom pattern, 2 20 -1 O.153.
3_in_24—n repetitive pattern, 3 in 24.
threshold Test failure (error) threshold that determines if the BERT on this line passed.
threshold 10^-2—Bit error rate of 10-2.
10^-3—Bit error rate of 10-3.
10^-4—Bit error rate of 10-4.
10^-5—Bit error rate of 10-5.
10^-6—Bit error rate of 10-6. (This is the default.)
10^-7—Bit error rate of 10-7.
10^-8—Bit error rate of 10-8.
error-injection Error injection rate for bit errors injected into the BERT pattern generated by the
chip.
err-inj 10^-1—Error injection of 10-1.
10^-2—Error injection of 10-2.
10^-3—Error injection of 10-3.
10^-4—Error injection of 10-4.
10^-5—Error injection of 10-5.
10^-6—Error injection of 10-6.
10^-7—Error injection of 10-7.
none—No error injection in the data pattern. (This is the default.)
duration Duration, in minutes, for which BERT is to be executed.
time Duration of BERT, in minutes. The valid range is from 1 to 1440. The default is 10.

Cisco IOS Interface and Hardware Component Command Reference

IR-46
 Interface and Hardware Component Commands
bert profile

Defaults The default profile created internally by the system has parameters that cannot be changed. This profile
has been defined so that you can execute BERT on a line without having to configure a new profile. The
default profile is displayed when the running configuration is displayed and is not stored in NVRAM:
bert profile number pattern 220-0151QRSS threshold 10^-6 error-injection none duration 10

Command Modes Global configuration

Command History Release Modification

12.0(2)XD This command was introduced.
12.0(3)T This command was integrated into Cisco IOS Release 12.0(3)T.

Usage Guidelines Use the bert profile command to set up bit error rate testing profiles for the Cisco AS5300 router.
The bit error rate test (BERT) feature enables you to test the quality of the connected PRI links by direct
comparison of a pseudorandom or repetitive test pattern with an identical locally generated test pattern.
A BERT profile is a set of parameters related to a BERT test and is stored as part of the configuration in
NVRAM. You can define up to 15 BERT profiles on the system. By setting up the BERT profiles in this
way, you do not have to enter the parameters each time you want to run a BERT—just select the number
of the BERT profile that you want to run.

Examples The following example shows a configured BERT profile number 1 to have a 0s test pattern, with a 10-2
threshold, no error injection, and a duration of 125 minutes:
Router(config)# bert profile 1 pattern 0s threshold 10^-2 error-injection none duration
125

Related Commands Command Description

bert abort Aborts a bit error rate testing session.
bert controller Starts a bit error rate test for a particular port.

Cisco IOS Interface and Hardware Component Command Reference

IR-47
 Interface and Hardware Component Commands
cable bundle

cable bundle
To configure a cable interface to belong to an interface bundle, use the cable bundle command in
interface configuration mode. To delete a cable interface bundle definition, use the no form of this
command.

cable bundle number [master]

no cable bundle number [master]

Syntax Description number Specifies the bundle identifier. Valid range is from 1 to 255.
master (Optional) Defines the specified interface as the master.

Defaults No cable interface bundle is defined.

Command Modes Interface configuration

Command History Release Modification

12.0(7)XR This command was introduced.

Usage Guidelines You can configure up to four interface bundles. In each bundle, specify one interface as the master
interface by using the optional master keyword.
Configure only an IP address on the master interface. If an IP address is configured and the interface is
not specified as the master interface, any attempt to add an interface to a bundle is rejected.
Specify all generic IP networking information (such as IP address, routing protocols, and switching
modes) on the bundle master interface. Do not specify generic IP networking information on bundle
slave interfaces.
If you attempt to add an interface to a bundle as nonmaster interface and an IP address is assigned to this
interface, the command will fail. You must remove the IP address configuration before you can add the
interface to a bundle.
If you have configured an IP address on a bundled interface and the interface is not the master interface,
a warning message appears.
Specify generic (not downstream or upstream related) cable interface configurations, such as
source-verify or Address Resolution Protocol (ARP) handling, on the master interface. Do not specify
generic configuration on nonmaster interfaces.
If you configure an interface as a part of a bundle and it is not the master interface, all generic cable
configuration for this interface is removed. The master interface configuration will then apply to all
interfaces in the bundle.

Cisco IOS Interface and Hardware Component Command Reference

IR-48
 Interface and Hardware Component Commands
cable bundle

If you shut down or remove the master interface in a bundle, no data packets are sent to any of the
interfaces in this bundle. Packets are still physically received from nonmaster interfaces that have not
been shut down, but those packets will be discarded. Modems connected to those interfaces will not be
disconnected immediately, but modems going online will not be able to obtain an IP address, download
their configuration file, or renew their IP address assignment if the Dynamic Host Configuration
Protocol (DHCP) lease expires.
If you shut down a slave interface, only this shut down interface is affected.

Examples The following example shows how to configure interface 25 to be the master interface:
Router(config-if)# cable bundle 25 master

Router(config-if)#
07:28:17: %UBR7200-5-UPDOWN: Interface Cable3/0 Port U0, changed state to down
07:28:18: %UBR7200-5-UPDOWN: Interface Cable3/0 Port U0, changed state to up

The following example shows the error message that appears if you try to configure an interface with an
IP address that is not the master interface:
Router(config-if)# cable bundle 5

Please remove ip address config first then reenter this command

Related Commands Command Description

show cable bundle Displays the forwarding table for the specified interface bundle.

Cisco IOS Interface and Hardware Component Command Reference

IR-49
 Interface and Hardware Component Commands
cable helper-address

cable helper-address
To specify a destination address for User Datagram Protocol (UDP) broadcast Dynamic Host
Configuration Protocol (DHCP) packets, use the cable helper-address command in interface
configuration mode. To remove the specified destination address for UDP DHCP packets, use the no
form of this command.

cable helper-address ip-address {cable-modem | host}

no cable helper-address ip-address {cable-modem | host}

Syntax Description ip-address The IP address of a DHCP server.

Based on whether you add the host or cable-modem keyword at the end
of the cable helper-address command, it is the IP address of the multiple
service operators (MSOs) Cisco Network Registrar (CNR) server or the
Internet service providers (ISPs) DHCP server.
cable-modem Specifies that only cable modem UDP broadcasts are forwarded
host Specifies that only host UDP broadcasts are forwarded.

Defaults This command is disabled by default.

Command Modes Interface configuration

Command History Release Modification

11.3 NA This command was introduced.

Usage Guidelines If you specify a secondary interface address, the giaddr field in the DHCP requests will be sent to the
primary address for DHCP requests received from cable modems, and to the secondary IP address for
DHCP requests received from hosts.

Examples The following example shows how to forward UDP broadcasts from cable modems to the DHCP server
at 172.23.66.44:
Router(config-if)# cable helper-address 172.23.66.44 cable-modem

The following example shows how to forward UDP broadcasts from hosts to the DHCP server at
172.23.66.44:
Router(config-if)# cable helper-address 172.23.66.44 host

Cisco IOS Interface and Hardware Component Command Reference

IR-50
 Interface and Hardware Component Commands
cablelength

cablelength
To specify the distance of the cable from the routers to the network equipment, use the cablelength
command in controller configuration mode. To restore the default cable length, use the no form of this
command.

cablelength feet

no cablelength

Syntax Description feet Number of feet in the range of 0 to 450. The default values are as follows:
• 224 feet for a Channelized T3 Interface Processor (CT3IP) and Clear
Channel T3/E3 network module
• 49 feet for PA-T3 and PA-2T3 port adapters

Defaults 224 feet for a CT3IP interface processor and Clear Channel T3/E3 network module
49 feet for PA-T3 and PA-2T3 port adapters

Command Modes Controller configuration

Command History Release Modification

11.1 CA This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and
implemented on the following platforms: Cisco 2650XM, Cisco 2651XM,
Cisco 2691, Cisco 3660 series, Cisco 3725, and Cisco 3745 routers. Support
for the Clear Channel T3/E3 network module was added.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.

Usage Guidelines The default cable length of 224 feet is used by the CT3IP interface processor and the Clear Channel
T3/E3 network module.
The default cable length of 49 feet is used by the PA-T3 and PA-2T3 port adapters.

Note Although you can specify a cable length from 0 to 450 feet, the hardware recognizes only two
ranges: 0 to 49 and 50 to 450. For example, entering 35 feet uses the 0 to 49 range. If you later
change the cable length to 40 feet, there is no change because 40 is still within the 0 to 49 range.
However, if you change the cable length to 50, the 50 to 450 range is used. The actual number you
enter is stored in the configuration file.

Cisco IOS Interface and Hardware Component Command Reference

IR-51
 Interface and Hardware Component Commands
cablelength

Examples The following example shows how to set the cable length for the router to 300 feet:
Router(config)# controller t3 9/0/0
Router(config-controller)# cablelength 300

Cisco IOS Interface and Hardware Component Command Reference

IR-52
 Interface and Hardware Component Commands
cablelength (E1 controller)

cablelength (E1 controller)

To fine-tune the pulse of a signal at the receiver for an E1 cable on a Cisco AS5300 or Cisco AS5400,
use the cablelength command in controller configuration mode. To restore the default receiver
sensitivity, use the no form of this command.

cablelength {custom gain-value [squelch-on] | long [squelch-on] | medium [squelch-on] |

short [squelch-on]}

no cablelength

Syntax Description custom Fine-tunes the receiver sensitivity for long-haul, medium-haul, and
short-haul applications.
gain-value Custom gain value for the receiver in the range of 0x1 to 0x3F. These
settings are mapped to values in the range of 0 to –45 dB.
long Fine-tunes the receiver sensitivity for long-haul applications.
medium Fine-tunes the receiver sensitivity for medium-haul applications.
short Fine-tunes the receiver sensitivity for short-haul applications.
squelch-on (Optional) Enables squelch to improve the signal-to-noise ratio.

Command Default Default receiver sensitivity for E1 cables is applied.

Command Modes Controller configuration

Command History Release Modification

12.3(17) This command was introduced.

Usage Guidelines This command is supported on E1 controllers only.

Note The cable line pulse gain values are not dependent upon the E1 line being configured in balanced
(120-ohm) mode or unbalanced (75-ohm) mode.

Examples The following example shows how to fine-tune the receiver sensitivity for an E1 cable on a
Cisco AS5300 to support a long-haul configuration:
Router(config-controller)# cablelength long squelch-on

Cisco IOS Interface and Hardware Component Command Reference

IR-53
 Interface and Hardware Component Commands
cablelength long

cablelength long
To increase the pulse of a signal at the receiver and to decrease the pulse from the transmitter using pulse
equalization and line build-out for a T1 cable, use the cablelength long command in controller
configuration or interface configuration mode. To return the pulse equalization and line build-out values
to their default settings, use the no form of this command.

cablelength long db-gain-value db-loss-value

no cablelength long

Syntax Description db-gain-value Number of decibels (dB) by which the receiver signal is increased. Use one of the
following values:
• gain26
• gain36
The default is 26 dB.
db-loss-value Number of decibels by which the transmit signal is decreased. Use one of the
following values:
• 0db
• -7.5db
• -15db
• -22.5db
The default is 0 dB.

Defaults db-gain-value: gain26

db-loss-value: 0db

Command Modes Controller configuration for the Cisco AS5800 and Cisco MC3810.
Interface configuration for the Cisco 2600 and Cisco 3600 series routers.

Command History Release Modification

11.2 This command was introduced.
11.3 The following keywords were added: gain26, gain36, 0db, -7.5db, -15db,
-22.5db.
12.0(5)XK This command was modified to include support as an ATM interface
configuration command for the Cisco 2600 and Cisco 3600 series routers and as
a controller configuration command for the Cisco AS5800 universal access
server.

Cisco IOS Interface and Hardware Component Command Reference

IR-54
 Interface and Hardware Component Commands
cablelength long

Usage Guidelines Cisco AS5800 and Cisco MC3810

Use this command for configuring the controller T1 interface on the Cisco AS5200 access server, on the
Cisco AS5800 universal access server, or on the Cisco MC3810 multiservice access concentrator. The
cablelength long command is used to configure DS1 links (meaning, to build CSU/DSU links) when the
cable length is no longer than 655 feet.
On the Cisco MC3810, this command is supported on T1 controllers only and applies to Voice over
Frame Relay, Voice over ATM, and Voice over HDLC.

Note On the Cisco MC3810, you cannot use the cablelength long command on a DSX-1 interface only.
The cablelength long command can be used only on CSU interfaces.

A pulse equalizer regenerates a signal that has been attenuated and filtered by a cable loss. Pulse
equalization does not produce a simple gain, but it filters the signal to compensate for complex cable
loss. A gain26 receiver gain compensates for a long cable length equivalent to 26 dB of loss, whereas a
gain36 compensates for 36 dB of loss.
The lengthening or building out of a line is used to control far-end crosstalk. Line build-out attenuates
the stronger signal from the customer installation transmitter so that the transmitting and receiving
signals have similar amplitudes. A signal difference of less than 7.5 dB is ideal. Line build-out does not
produce simple flat loss (also known as resistive flat loss). Instead, it simulates a cable loss of 7.5 dB,
15 dB, or 22.5 dB so that the resulting signal is handled properly by the receiving equalizer at the other
end.

Cisco 2600 and Cisco 3600 Series Routers

This command is supported on T1 long-haul links only. If you enter the cablelength long command on
a DSX-1 (short-haul) interface, the command is rejected.
The transmit attenuation value is best obtained by experimentation. If the signal received by the far-end
equipment is too strong, reduce the transmit level by entering additional attenuation.

Examples Cisco AS5800 and Cisco MC3810

The following example shows how to increase the receiver gain by 36 decibels and decreases the
transmitting pulse by 15 decibels for a long cable on a Cisco AS5800:
AS5800(config)# controller t1 0
AS5800(config-controller)# cablelength long gain36 -15db

The following example shows how to configure the cable length for controller T1 0 on a Cisco MC3810
to a decibel pulse gain of 36 decibels and a decibel pulse rate of –22.5 decibels:
MC3810(config)# controller t1 0
MC3810(config-controller)# cablelength long gain36 -22.5db

Cisco 2600 and Cisco 3600 Series Routers

On a Cisco 2600 or Cisco 3600 series router, the following example shows how to specify a pulse gain
of 36 decibels and a decibel pulse rate of –7.5 decibels:
Router(config)# interface atm 0/2
Router(config-if)# cablelength long gain36 -7.5db

Cisco IOS Interface and Hardware Component Command Reference

IR-55
 Interface and Hardware Component Commands
cablelength long

Related Commands Command Description

cablelength short Sets a cable length of 655 feet or shorter for a DS1 link.

Cisco IOS Interface and Hardware Component Command Reference

IR-56
 Interface and Hardware Component Commands
cablelength short

cablelength short
To set a cable length of 655 feet or shorter for a DS1 link on the Cisco MC3810 or Cisco 2600 and
Cisco 3600 series routers, use the cablelength short command in controller configuration or interface
configuration mode. To delete the cablelength short value, use the no form of this command.

cablelength short length

no cablelength short

Syntax Description length Specifies a cable length. Use one of the following values:
• 133—Specifies a cable length from 0 to 133 feet.
• 266—Specifies a cable length from 134 to 266 feet.
• 399—Specifies a cable length from 267 to 399 feet.
• 533—Specifies a cable length from 400 to 533 feet.
• 655—Specifies a cable length from 534 to 655 feet.

Defaults The default is 133 feet for the Cisco AS5200 access server, Cisco AS5800 universal access server, and
Cisco MC3810 multiservice access concentrator.
There is no default cable length for the Cisco 2600 and Cisco 3600 series routers.

Command Modes Controller configuration for the Cisco AS5200 access server, Cisco AS5800 universal access server, and
Cisco MC3810 multiservice access concentrator.
Interface configuration for the Cisco 2600 and Cisco 3600 series routers.

Command History Release Modification

11.3(2)AA This command was introduced.
12.0(5)XK This command was modified to include support as an ATM interface
command for the Cisco 2600 and 3600 series routers and as a controller
configuration command for the Cisco AS5800 universal access server.

Usage Guidelines Cisco AS5200 Access Server, Cisco AS5800 Universal Access Server, and Cisco MC3810 Multiservice Access
Concentrator
On the Cisco MC3810, the cablelength short command is used to configure DSX-1 links when the cable
length is 655 feet or less than 655 feet. On the Cisco MC3810, this command is supported on T1
controllers only.

Note On the Cisco MC3810, you cannot enter the cablelength short command on a CSU interface. The
cablelength short command can be used only on DSX-1 interfaces.

Cisco IOS Interface and Hardware Component Command Reference

IR-57
 Interface and Hardware Component Commands
cablelength short

Cisco 2600 and Cisco 3600 Series Routers

This command is supported on T1 short-haul links only. If you enter the cablelength short command on
a long-haul interface, the command is rejected.
To set cable lengths longer than 655 feet, use the cablelength long command.
This command is supported on T1 controllers only.

Cisco AS5200 Access Server, Cisco AS5800 Universal Access Server, and Cisco MC3810 Multiservice Access
Concentrator
The following example shows how to set the cable length to 266 for the T1 controller in slot 1 on dial
shelf 0:
Router# configure terminal
Router(config)# controller t1 1/1/0
Router(config-controller)# cablelength short 266
Router(config-controller)# end

Cisco 2600 and Cisco 3600 Series Routers

On a Cisco 2600 or Cisco 3600 series router, the following example shows how to specify a cable length
from 0 to 133 feet:
Router(config)# interface atm 0/2
Router(config-if)# cablelength short 133

Related Commands Command Description

cablelength long Increases the pulse of a signal at the receiver and decreases the pulse from
the sender using pulse equalization and line build-out.

Cisco IOS Interface and Hardware Component Command Reference

IR-58
 Interface and Hardware Component Commands
carrier-delay

carrier-delay
To set the carrier delay on a serial interface, use the carrier-delay command in interface configuration
mode. To return to the default carrier delay value, use the no form of this command.

carrier-delay [seconds | msec milliseconds]

no carrier-delay [seconds | msec milliseconds]

Syntax Description seconds (Optional) Time, in seconds, to wait for the system to change states. The range is
from 0 to 60. The default is 2.
msec milliseconds (Optional) Time, in milliseconds. The default is 50.

Defaults seconds: 2
milliseconds: 50

Command Modes Interface configuration

Command History Release Modification

10.1 This command was introduced.

Usage Guidelines If a link goes down and comes back up before the carrier delay timer expires, the down state is effectively
filtered, and the rest of the software on the switch is not aware that a link-down event occurred.
Therefore, a large carrier delay timer results in fewer link-up/link-down events being detected. On the
other hand, setting the carrier delay time to 0 means that every link-up/link-down event is detected.
In most environments a lower carrier delay is better than a higher one. The exact value that you choose
depends on the nature of the link outages that you expect to see in your network and how long you expect
those outages to last.
If data links in your network are subject to short outages, especially if those outages last less than the
time it takes for your IP routing to converge, you should set a relatively long carrier delay value to
prevent these short outages from causing unnecessary churn in your routing tables. If outages in your
network tend to be longer, you might want to set a shorter carrier delay so that the outages are detected
sooner, and the IP route convergence begins and ends sooner.

Examples The following example shows how to change the carrier delay to 5 seconds:
Router(config)# interface serial 0
Router(config-if)# carrier-delay 5

Cisco IOS Interface and Hardware Component Command Reference

IR-59
 Interface and Hardware Component Commands
cem

cem
To enter circuit emulation (CEM) configuration mode, use the cem command in global configuration
mode.

cem slot/port/channel

Syntax Description slot Slot number in which the Circuit Emulation over IP (CEoIP) network
module (NM) is installed on the networking device.
/port Port number on the CEoIP NM. The slash mark is required between the slot
argument and the port argument.
/channel Channel number that identifies the channel that you want to configure
(T1/E1 only). The channel number on a serial port is always 0. The slash
mark is required between the port argument and the channel argument.

Defaults No default behavior or values

Command Modes Global configuration

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines Use this command to enter CEM configuration mode to allow the configuration of all CEM options.

Examples The following example shows how to enter CEM configuration mode:
Router(config)# cem 1/2/0
Router(config-cem)#

Related Commands Command Description

clear cem Clears CEM statistics.
show cem Displays CEM statistics.

Cisco IOS Interface and Hardware Component Command Reference

IR-60
 Interface and Hardware Component Commands
cem-group

cem-group
To create a circuit emulation (CEM) channel from one or more time slots of a T1 or E1 line of an
NM-CEM-4TE1 network module, use the cem-group command in controller configuration mode. To
remove a CEM group and release the associated time slots, use the no form of this command.

cem-group group-number {unframed | timeslots time-slot-range [speed {56 | 64}]}

no cem-group group-number

Syntax Description group-number Channel number to be used for this group of time slots.
• For T1 ports, the range is from 0 to 23.
• For E1 ports, the range is from 0 to 30.
unframed Specifies that a single CEM channel is being created including all time slots
and the framing structure of the line.
timeslots Specifies that a list of time slots is to be used as specified by the
time-slot-range argument.
• time-slot-range—Specifies the time slots to be included in the CEM
channel. The list of time slots may include commas and hyphens with
no spaces between the numbers.
• speed—(Optional) Specifies the speed of the channels by specifying the
number of kbps of each time slot to be used. This keyword applies only
to T1 channels.
– 56—Specifies a speed of 56 kbps where only the seven most
significant bits (MSBs) of each eight-bit time slot are used.
– 64—Specifies a speed of 64 kbps where all eight bits of each
eight-bit time slot are used.

Defaults No CEM groups are defined.

Command Modes Controller configuration

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines Use this command to create CEM channels on the T1 or E1 network module, NM-CEM-4TE1. A
maximum of 64 channels may be created on an NM-CEM-4TE1.

Examples The following example shows how to create circuit emulation group number 0 with a single CEM
channel including all time slots and the framing structure of the line on an NM-CEM-4TE1.

Cisco IOS Interface and Hardware Component Command Reference

IR-61
 Interface and Hardware Component Commands
cem-group

Router(config-controller)# cem-group 0 unframed

The following example shows how to create circuit emulation channel number 6 with T1 channel time
slots one through four, nine, and ten using all eight bits of each time slot on an NM-CEM-4TE1.
Router(config-controller)# cem-group 6 timeslots 1-4,9,10 speed 64

Related Commands Command Description

cem Enters circuit emulation configuration mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-62
 Interface and Hardware Component Commands
channel-group (EtherChannel)

channel-group (EtherChannel)
To assign a Fast Ethernet interface to an EtherChannel group, use the channel-group command in
interface configuration mode. To remove the channel-group configuration from the interface, use the no
form of this command.

Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers

channel-group port-channel-number mode on

no channel-group

Cisco Catalyst Switches

channel-group port-channel-number mode {on | auto [non-silent] | desirable [non-silent]}

no channel-group

Syntax Description port-channel-number Specifies the port-channel group number; see the “Usage Guidelines” section
for valid values.
mode Specifies the EtherChannel mode of the interface.
on Forces the port to channel without Port Aggregation Protocol (PAgP).
auto Places a port into a passive negotiating state in which the port responds to
PAgP packets it receives but does not initiate PAgP packet negotiation.
non-silent (Optional) Used with the auto or desirable mode when traffic is expected from
the other device.
desirable Places a port into an active negotiating state in which the port initiates
negotiations with other ports by sending PAgP packets.

Defaults No channel groups are assigned.

Command Modes Interface configuration

Command History Release Modification

12.0(7)XE This command was introduced on Cisco Catalyst 6000 family switches.
12.1(3a)E3 The number of valid values for the port-channel-number argument was changed; see
the “Usage Guidelines” section for valid values.
12.2(2)XT This command was introduced on the Cisco 2600 series, Cisco 3600 series, and
Cisco 3700 series routers.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T on the
Cisco 2600 series, the Cisco 3600 series, and the Cisco 3700 series routers.

Cisco IOS Interface and Hardware Component Command Reference

IR-63
 Interface and Hardware Component Commands
channel-group (EtherChannel)

Usage Guidelines IP Address for the Physical Interface

You do not have to disable the IP address that is assigned to a physical interface that is part of a channel
group, but Cisco highly recommends doing so.

Layer-2 and Layer-3 Port Channels

You can create both Layer 2 and Layer 3 port channels by entering the interface port-channel command
or, when the channel-group gets its first physical interface assignment. The port channels are not created
at run time, nor are they created dynamically.
You do not have to create a port-channel interface before assigning a physical interface to a channel
group. A port-channel interface is automatically created when the channel group gets its first physical
interface, if it is not already created.

Propagation of Configuration and Attribute Changes

Any configuration or attribute changes you make to the port-channel interface are propagated to all
interfaces within the same channel group as the port channel. (for example, configuration changes are
also propagated to the physical interfaces that are not part of the port-channel, but are part of the channel
group.)

The on Keyword
When you use the on keyword, a usable EtherChannel exists only when a port group in “on” mode is
connected to another port group in the “on” mode.

Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers
You do not have to create a port-channel interface before assigning a physical interface to a channel
group. A port-channel interface is created automatically when the channel group gets its first physical
interface, if it is not already created.

Cisco Catalyst Switches

The number of valid values for port-channel-number depends on the software release. For software
releases prior to Cisco IOS Release 12.1(3a)E3, valid values are from 1 to 256; for
Cisco IOS Release 12.1(3a)E3, 12.1(3a)E4, and 12.1(4)E1, valid values are from 1 to 64.
Cisco IOS Release 12.1 E and later releases support a maximum of 64 values ranging from 1 to 256.

Caution Do not enable Layer 3 addresses on the physical EtherChannel interfaces. Do not assign bridge
groups on the physical EtherChannel interfaces because loops will result.

Examples The following example shows how to add EtherChannel interface 1/0 to the EtherChannel group
specified by port-channel 1:
Router(config-if)# channel-group 1 mode on

Related Commands Command Description

interface port-channel Accesses or creates the IDB port channel.
show interfaces port-channel Displays statistics for all interfaces configured.

Cisco IOS Interface and Hardware Component Command Reference

IR-64
 Interface and Hardware Component Commands
channel-group (Fast EtherChannel)

channel-group (Fast EtherChannel)

To assign a Fast Ethernet interface to a Fast EtherChannel group, use the channel-group command in
interface configuration mode. To remove a Fast Ethernet interface from a Fast EtherChannel group, use
the no form of this command.

channel-group channel-number

no channel-group channel-number

Syntax Description channel-number Port-channel number previously assigned to the port-channel interface using
the interface port-channel global configuration command. The range is from
1 to 4.

Defaults No channel group is configured.

Command Modes Interface configuration

Command History Release Modification

11.1 CA This command was introduced.

Usage Guidelines Before you assign a Fast Ethernet interface to a Fast EtherChannel group, you must first create a
port-channel interface. To create a port-channel interface, use the interface port-channel global
configuration command.
If the Fast Ethernet interface has an IP address assigned, you must disable it before adding the Fast
Ethernet interface to the Fast EtherChannel. To disable an existing IP address on the Fast Ethernet
interface, use the no ip address command in interface configuration mode.
The Fast EtherChannel feature allows multiple Fast Ethernet point-to-point links to be bundled into one
logical link to provide bidirectional bandwidth of up to 800 Mbps. Fast EtherChannel can be configured
between Cisco 7500 series routers and Cisco 7000 series routers with the 7000 Series Route Switch
Processor (RSP7000) and 7000 Series Chassis Interface (RSP7000CI) or between a Cisco 7500 series
router or a Cisco 7000 series router with the RSP7000 and RSP700CI and a Cisco Catalyst 5000 switch.
A maximum of four Fast Ethernet interfaces can be added to a Fast EtherChannel group.

Caution The port-channel interface is the routed interface. Do not enable Layer 3 addresses on the physical
Fast Ethernet interfaces. Do not assign bridge groups on the physical Fast Ethernet interfaces
because it creates loops. Also, you must disable spanning tree.

To display information about the Fast EtherChannel, use the show interfaces port-channel EXEC
command.

Cisco IOS Interface and Hardware Component Command Reference

IR-65
 Interface and Hardware Component Commands
channel-group (Fast EtherChannel)

Examples The following example shows how to add Fast Ethernet 1/0 to the Fast EtherChannel group specified by
port-channel 1:
Router(config)# interface port-channel 1
Router(config-if)# exit
Router(config)# interface fastethernet 1/0/
Router(config-if)# channel-group 1

Related Commands Command Description

interface port-channel Specifies a Fast EtherChannel and enters interface configuration
mode.
ip address Sets a primary or secondary IP address on an interface.
show interfaces port-channel Displays the information about the Fast EtherChannel on
Cisco 7500 series routers and Cisco 7000 series routers with the
RSP7000 and RSP7000CI.

Cisco IOS Interface and Hardware Component Command Reference

IR-66
 Interface and Hardware Component Commands
channelized

channelized
To configure the T3 controller for channelized mode, use the channelized command in configuration
controller mode. To configure the T3 controller for unchannelized mode, use the no form of this
command.

channelized

no channelized

Syntax Description This command has no arguments or keywords.

Defaults The T3 controller is channelized.

Channelized: maximum transmission unit (MTU) size is set to 1500.
Unchannelized: MTU size is set to 4470.

Command Modes Configuration controller

Command History Release Modification

12.0(14)S This command was introduced.
12.1(5a)E This command was integrated into Cisco IOS Release 12.1(5a)E.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.

Usage Guidelines Use the no channelized configuration controller command to configure the T3 controller for
unchannelized mode. When you configure the PA-MC-2T3+ port adapter on a Cisco 7500 series router
with the no channelized command, the MTU size is set to 4470. In channelized mode, the default MTU
size is 1500. The change in MTU sizes will cause a memory recarve and CBus complex to occur,
disrupting all traffic on the router for several minutes.
The following message will be displayed when switching between channelized and unchannelized
modes on a Cisco 7500 series router:
Change to subrate mode will cause cbus complex reset. Proceed? [yes/no]: Y

Type Y for “yes” at the end of the warning. At the prompt, type ^Z to exit. You will exit configuration
mode and enter unchannelized mode.

Examples The following example shows how to configure unchannelized mode on a PA-MC-2T3+ port adapter in
slot 1 of a Versatile Interface Processor version 2 (VIP2) or VIP4 in a Cisco 7500 series router:
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# controller T3 1/1/0
Router(config-controller)# no channelized
Change to subrate mode will cause cbus complex reset. Proceed? [yes/no]: Y
^Z

Cisco IOS Interface and Hardware Component Command Reference

IR-67
 Interface and Hardware Component Commands
clear aim

clear aim
To clear the data compression Advanced Interface Module (AIM) daughter card registers and reset the
hardware, use the clear aim command in privileged EXEC mode.

clear aim element-number

Syntax Description element-number Number of AIM slot. AIM slots begin with 0.

Command Modes Privileged EXEC

Command History Release Modification

12.0(1)T This command was introduced.

Usage Guidelines The clear aim command is used to reset the data compression AIM hardware. This command is used if
the compression Advanced Interface Module (CAIM) hardware becomes “stuck” or hangs for some
reason. The CAIM registers are cleared, and the hardware is reset upon execution. All compression
history is lost when the CAIM is reset.
This command is supported only on Cisco 2600 series routers.

Examples The following example shows how to use the clear aim command. This command will reset the
hardware, flushing the buffers and history for all compression tasks currently under operation:
Router# clear aim 0
Router#
1w0d: %CAIM-6-SHUTDOWN: CompressionAim0 shutting down
1w0d: %CAIM-6-STARTUP: CompressionAim0 starting up

Related Commands Command Description

show pas caim Displays the IDPROM contents for each AIM board in the Cisco 2600
series routers.
test aim eeprom Tests the data compression AIM after it is installed in a Cisco 2600
series router.

Cisco IOS Interface and Hardware Component Command Reference

IR-68
 Interface and Hardware Component Commands
clear cem

clear cem
To clear circuit emulation (CEM) statistics, use the clear cem command in privileged EXEC mode.

clear cem {slot | slot/port/channel | all}

Syntax Description slot Clears the statistics for all CEM channels on the card in the specified slot (if
the card is a Circuit Emulation over IP [CEoIP] card).
slot Specifies the slot of the CEM channel to clear.
/port Specifies the port of the CEM channel to clear. The slash mark is required
between the slot argument and the port argument.
/channel Specifies the CEM channel to clear. The slash mark is required between the
port argument and the channel argument.
all Clears the statistics for all CEM channels on the router.

Command Modes Privileged EXEC

Command History Release Modification

12.3(7)T This command was introduced.

Examples The following example shows how to clear CEM statistics for CEM channel number 10 on the card
installed in slot 1, port 1.
Router# clear cem 1/1/10

Related Commands Command Description

cem Enters CEM configuration mode.
show cem Displays CEM statistics.

Cisco IOS Interface and Hardware Component Command Reference

IR-69
 Interface and Hardware Component Commands
clear controller

clear controller
To reset the T1 or E1 controller, use the clear controller command in user EXEC or privileged EXEC
mode.

Cisco 7200 Series and Cisco 7500 Series Routers

clear controller {t1 | e1} slot/port

Cisco AS5200 Series and Cisco AS5300 Series Routers

clear controller {t1 | e1} number

Syntax Description t1 T1 controller.

e1 E1 controller.
slot/port Backplane slot number and port number on the interface. Refer to your
hardware installation manual for the specific slot and port numbers.
number Network interface module (NIM) number, in the range from 0 to 2.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

10.1 This command was introduced.

Examples The following example resets the T1 controller at slot 4, port 0 on a Cisco 7500 series router:
Router# clear controller t1 4/0

The following example resets the E1 controller at NIM 0:

Router# clear controller e1 0

Related Commands Command Description

controller Configures a T1, E1, or J1 controller and enters controller configuration
mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-70
 Interface and Hardware Component Commands
clear counters

clear counters
To clear the interface counters, use the clear counters command in user EXEC or privileged EXEC
mode.

clear counters [interface-type interface-number]

Cisco 7200 Series and 7500 Series with a Packet over SONET Interface Processor

clear counters [interface-type] slot/port

Cisco 7500 Series with Ports on VIP Cards

clear counters [interface-type] slot/port-adapter/port

Syntax Description interface-type (Optional) Specifies the interface type; one of the keywords listed in Table 2.
number (Optional) Specifies the interface number displayed with the show interfaces
command.
slot Slot number. Refer to the appropriate hardware manual for slot and port
information.
port Port number. Refer to the appropriate hardware manual for slot and port
information.
port-adapter Port adapter number. Refer to the appropriate hardware manual for information
about port adapter compatibility.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

10.0 This command was introduced.
11.2 F The virtual-access keyword was added.
11.3 The following keywords were added or modified:
• vg-anylan keyword was added.
• posi keyword was changed to pos.
12.2(15)T The ethernet and serial keywords were removed because the LAN
Extension feature is no longer available in Cisco IOS software.

Usage Guidelines This command clears all the current interface counters from the interface unless the optional arguments
type and number are specified to clear only a specific interface type (serial, Ethernet, Token Ring, and
so on). Table 2 lists the command keywords and their descriptions.

Cisco IOS Interface and Hardware Component Command Reference

IR-71
 Interface and Hardware Component Commands
clear counters

Note This command does not clear counters retrieved using Simple Network Management Protocol (SNMP),
but only those seen with the show interface EXEC command.

Table 2 clear counters Interface Type Keywords

Keyword Interface Type

async Asynchronous interface
bri ISDN BRI
dialer Dialer interface
ethernet Ethernet interface
fast-ethernet Fast Ethernet interface
fddi FDDI
hssi High-Speed Serial Interface (HSSI)
line Terminal line
loopback Loopback interface
null Null interface
port-channel Port channel interface
pos Packet OC-3 interface
serial Synchronous serial interface
switch Switch interface
tokenring Token Ring interface
tunnel Tunnel interface (IEEE 02.5)
vg-anylan 100VG-AnyLAN port adapter
virtual-access Virtual-access interface (Refer to the Cisco IOS Dial Technologies Command
Reference for details on virtual templates.)
virtual-template Virtual-template interface (Refer to the Cisco IOS Dial Technologies Command
Reference for details on virtual templates.)
virtual-tokenring Virtual token ring interface

Examples The following example clears all interface counters:

Router# clear counters

The following example clears the Packet OC-3 interface counters on a POSIP card in slot 1 on a
Cisco 7500 series router:
Router# clear counters pos 1/0

The following example clears the interface counters on a Fast EtherChannel interface.
Router# clear counter port-channel 1

Clear “show interface” counters on all interfaces [confirm] Y

%CLEAR-5-COUNTERS: Clear counter on all interfaces by console 1

Cisco IOS Interface and Hardware Component Command Reference

IR-72
 Interface and Hardware Component Commands
clear counters

Related Commands Command Description

show interfaces Displays the statistical information specific to a serial interface.
show interfaces port-channel Displays the information about the Fast EtherChannel on
Cisco 7500 series routers and Cisco 7000 series routers with the
RSP7000 and RSP7000CI.

Cisco IOS Interface and Hardware Component Command Reference

IR-73
 Interface and Hardware Component Commands
clear hub

clear hub
To reset and reinitialize the hub hardware connected to an interface of a Cisco 2505 or Cisco 2507 router,
use the clear hub command in user EXEC or privileged EXEC mode.

clear hub ethernet number

Syntax Description ethernet Hub in front of an Ethernet interface.

number Hub number to clear, starting with 0. Because there is only one hub, this number
is 0.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

10.3 This command was introduced.

Examples The following example clears hub 0:

Router# clear hub ethernet 0

Related Commands Command Description

hub Enables and configures a port on an Ethernet hub of a Cisco 2505 or
Cisco 2507 router.

Cisco IOS Interface and Hardware Component Command Reference

IR-74
 Interface and Hardware Component Commands
clear hub counters

clear hub counters

To set the hub counters on an interface of a Cisco 2505 or Cisco 2507 router to zero, use the clear hub
counters command in user EXEC or privileged EXEC mode.

clear hub counters [ether number [port [end-port]]]

Syntax Descriptionn ether (Optional) Hub in front of an Ethernet interface.

number (Optional) Hub number for which to clear counters. Because there is currently
only one hub, this number is 0. If you specify the keyword ether, you must specify
the number.
port (Optional) Port number on the hub. On the Cisco 2505 router, port numbers range
from 1 to 8. On the Cisco 2507 router, port numbers range from 1 to 16. If a second
port number follows, this port number indicates the end of a port range. If you do
not specify a port number, counters for all ports are cleared.
end-port (Optional) Ending port number of a range.

Defaults If no port numbers are specified, counters for all ports are cleared.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

10.3 This command was introduced.

Examples The following example shows how to clear the counters displayed by a show hub command for all ports
on hub 0:
Router# clear hub counters ether 0

Related Commands Command Description

show hub Displays information about the hub (repeater) on an Ethernet interface of a
Cisco 2505 or Cisco 2507 router.

Cisco IOS Interface and Hardware Component Command Reference

IR-75
 Interface and Hardware Component Commands
clear interface

clear interface
To reset the hardware logic on an interface, use the clear interface command in user EXEC or privileged
EXEC mode.

clear interface type number [name-tag]

Cisco 7200 Series and Cisco 7500 Series with a Packet OC-3 Interface Processor

clear interface type slot/port

Cisco 7500 Series with Ports on VIP Cards

clear interface type slot/port-adapter/port

Cisco 7500 Series

clear interface type slot/port[:channel-group]

Cisco 7500 Series with a CT3IP Port Adapter

clear interface type slot/port-adapter/port[:t1-channel]

Syntax Description type Interface type; it is one of the keywords listed in Table 3.
number Port, connector, or interface card number.
name-tag (Optional for use with the Redundant Link Manager (RLM) feature) Logic name
to identify the server configuration so that multiple server configurations can be
entered.
slot Number of the slot being configured. Refer to the appropriate hardware manual for
slot and port information.
port Number of the port being configured. Refer to the appropriate hardware manual
for slot and port information.
port-adapter Number of the port adapter being configured. Refer to the appropriate hardware
manual for information about port adapter compatibility.
:channel-group (Optional) On Cisco 7500 series routers that support channelized T1, specifies the
channel number from 0 to 23. This number is preceded by a colon.
:t1-channel (Optional) For the CT3IP port adapter, the T1 channel is a number between 1 and
28. T1 channels on the CT3IP are numbered 1 to 28 rather than the more traditional
zero-based scheme (0 to 27) used with other Cisco products. This numbering
scheme ensures consistency with telco numbering schemes for T1 channels within
channelized T3 equipment.

Command Modes User EXEC

Privileged EXEC

Cisco IOS Interface and Hardware Component Command Reference

IR-76
 Interface and Hardware Component Commands
clear interface

Command History Release Modification

10.0 This command was introduced.
11.3 The following keywords were added or modified:
• vg-anylan keyword added
• posi keyword changed to pos
12.0(3)T The following optional argument was added for the RLM feature:
• name-tag

Usage Guidelines Under normal circumstances, you do not need to clear the hardware logic on interfaces.
This command clears all the current interface hardware logic unless the type and number arguments are
specified to clear only a specific interface type (serial, Ethernet, Token Ring, and so on). Table 3 lists
the command keywords and their descriptions.

Table 3 clear interface Type Keywords

Keyword Interface Type

async Async interface
atm ATM interface
bri ISDN BRI
ethernet Ethernet interface
fddi FDDI
hssi High-Speed Serial Interface (HSSI)
loopback Loopback interface
null Null interface
port-channel Port channel interface
pos Packet OC-3 Interface Processor
serial Synchronous serial interface
switch Switch interface
tokenring Token Ring interface
tunnel Tunnel interface
vg-anylan 100VG-AnyLAN port adapter

Examples The following example shows how to reset the interface logic on HSSI interface 1:
Router# clear interface hssi 1

The following example shows how to reset the interface logic on Packet OC-3 interface 0 on the POSIP
in slot 1:
Router# clear interface pos 1/0

The following example shows how to reset the interface logic on T1 0 on the CT3IP port adapter in slot 9:
Router# clear interface serial 9/0/0:0

Cisco IOS Interface and Hardware Component Command Reference

IR-77
 Interface and Hardware Component Commands
clear interface

The following example shows how to reset the interface logic on Fast EtherChannel interface 1:
Router# clear interface port-channel 1

The following example shows how to reset demonstrates the use of the clear interface command with
the RLM feature:
Router# clear interface loopback 1

Router#
02:48:52: rlm 1: [State_Up, rx ACTIVE_LINK_BROKEN] over link [10.1.1.1(Loopback1),
10.1.4.1]
02:48:52: rlm 1: link [10.1.1.2(Loopback2), 10.1.4.2] requests activation
02:48:52: rlm 1: link [10.1.1.1(Loopback1), 10.1.4.1] is deactivated
02:48:52: rlm 1: link [10.1.1.1(Loopback1), 10.1.4.1] = socket[10.1.1.1, 10.1.4.1]
02:48:52: rlm 1: [State_Recover, rx USER_SOCKET_OPENED] over link [10.1.1.1(Loopback1),
10.1.4.1] for user RLM_MGR
02:48:52: rlm 1: link [10.1.1.1(Loopback1), 10.1.4.1] is opened
02:48:52: rlm 1: link [10.1.1.1(Loopback1), 10.1.5.1] = socket[10.1.1.1, 10.1.5.1]
02:48:52: rlm 1: [State_Recover, rx USER_SOCKET_OPENED] over link [10.1.1.1(Loopback1),
10.1.5.1] for user RLM_MGR
02:48:52: rlm 1: link [10.1.1.1(Loopback1), 10.1.5.1] is opened
02:48:52: rlm 1: [State_Recover, rx START_ACK] over link [10.1.1.2(Loopback2), 10.1.4.2]
02:48:52: rlm 1: link [10.1.1.2(Loopback2), 10.1.4.2] is activated
02:48:52: rlm 1: [State_Up, rx LINK_OPENED] over link [10.1.1.1(Loopback1), 10.1.4.1]

Router# show rlm group 1 status

RLM Group 1 Status

User/Port: RLM_MGR/3000
Link State: Up Last Link Status Reported: Up_Recovered
Next tx TID: 4 Last rx TID: 0
Server Link Group[r1-server]:
link [10.1.1.1(Loopback1), 10.1.4.1] = socket[standby, 10.1.1.1, 10.1.4.1]
link [10.1.1.2(Loopback2), 10.1.4.2] = socket[active, 10.1.1.2, 10.1.4.2]
Server Link Group[r2-server]:
link [10.1.1.1(Loopback1), 10.1.5.1] = socket[opening, 10.1.1.1, 10.1.5.1]
link [10.1.1.2(Loopback2), 10.1.5.2] = socket[opening, 10.1.1.2, 10.1.5.2]

Router#
02:49:52: rlm 1: [State_Up, rx UP_RECOVERED_MIN_TIMEOUT]
02:49:52: rlm 1: link [10.1.1.1(Loopback1), 10.1.4.1] requests activation
02:49:52: rlm 1: [State_Switch, rx SWITCH_ACK] over link [10.1.1.1(Loopback1), 10.1.4.1]
02:49:52: rlm 1: link [10.1.1.2(Loopback2), 10.1.4.2] is deactivated
02:49:52: rlm 1: link [10.1.1.1(Loopback1), 10.1.4.1] is activated

Related Commands Command Description

interface Defines the IP addresses of the server, configures an interface type, and
enters interface configuration mode.
show rlm group Displays the status of the RLM group.
shutdown (RLM) Shuts down all of the links under the RLM group.

Cisco IOS Interface and Hardware Component Command Reference

IR-78
 Interface and Hardware Component Commands
clear interface fastethernet

clear interface fastethernet

To reset the controller for a specified Fast Ethernet interface, use the clear interface fastethernet
command in privileged EXEC mode.

Cisco 4500 and Cisco 4700 Series

clear interface fastethernet interface-number

Cisco 7200 and Cisco 7500 Series

clear interface fastethernet slot/port

Cisco 7500 Series with a VIP

clear interface fastethernet slot/port-adapter/port

Syntax Description interface-number Port, connector, or interface card number. On a Cisco 4500 or
Cisco 4700 Series router, specifies the number of the network
processor module (NPM). The numbers are assigned at the factory at
the time of installation or when added to a system.
slot Slot number. Refer to the appropriate hardware manual for slot and
port information.
/port Port number. Refer to the appropriate hardware manual for slot and
port information.
/port-adapter Port adapter number. Refer to the appropriate hardware manual for
information about port adapter compatibility.

Command Modes Privileged EXEC

Command History Release Modification

11.2 This command was introduced.

Examples Cisco 4500 Series

The following example resets the controller for Fast Ethernet interface 0 on a Cisco 4500:
Router# clear interface fastethernet 0

Cisco 7200 and Cisco 7500 Series

The following example resets the controller for the Fast Ethernet interface located in slot 1, port 0 on a
Cisco 7200 series router or Cisco 7500 series router:
Router# clear interface fastethernet 1/0

Cisco IOS Interface and Hardware Component Command Reference

IR-79
 Interface and Hardware Component Commands
clear interface fastethernet

Cisco 7500 Series with a VIP

The following example resets the controller for the Fast Ethernet interface located in slot 1,
port adapter 0, port 0 on a Cisco 7500 series router with a virtual interface processor (VIP):
Router# clear interface fastethernet 1/0/0

Related Commands Command Description

clear counters Clears the interface counters.
show interfaces Displays statistics for all interfaces configured on the router or access
server.
show interfaces serial Displays information about a serial interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-80
 Interface and Hardware Component Commands
clear interface serial

clear interface serial

To reset the statistical information specific to a serial interface, use the clear interface serial command
in user EXEC or privileged EXEC mode.

clear interface serial dial-shelf/slot/t3-port:t1-num:chan-group

Syntax Description dial-shelf Dial shelf chassis in the Cisco AS5800 access server that contains the
CT3 interface card.
/slot Location of the CT3 interface card in the dial shelf chassis.
/t3-port T3 port number. The only valid value is 0.
:t1-num T1 time slot in the T3 line. The value can be from 1 to 28.
:chan-group Channel group identifier.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines The clear interface serial command clears the interface hardware. To reset the counters for an interface,
use the clear counters command with the serial keyword specified. To confirm at the prompt, use the
show interfaces serial command.

Examples The following example clears the interface hardware, disconnecting any active lines:
Router# clear interface serial 1/4/0:2:23

Related Commands Command Description

clear counters Clears the interface counters.
show interfaces Displays statistics for all interfaces configured on the router or access
server.
show interfaces Displays information about a fastethernet interface.
fastethernet

Cisco IOS Interface and Hardware Component Command Reference

IR-81
 Interface and Hardware Component Commands
clear ipc statistics

clear ipc statistics

To clear all interprocess communication (IPC) statistics, use the clear ipc statistics command in
privileged EXEC mode.

clear ipc statistics

Syntax Description This command has no arguments or keywords.

Command Modes Privileged EXEC

Command History Release Modification

12.2(15)T This command was introduced.

Usage Guidelines The clear ipc statistics command clears all the IPC statistics and is useful for troubleshooting issues
with IPC services.

Examples The following example shows how to clear all of the statistics used by IPC services. A show ipc status
command is issued first to display the current IPC counters for a local IPC server. The clear ipc statistics
command is then entered to clear and reset the counters. A final show ipc status command is issued to
show that all the counters, except those counters that show the packets sent since the clearing, are reset
to zero.
Router# show ipc status

IPC System Status

Time last IPC stat cleared : never

This processor is the IPC master server.

Do not drop output of IPC frames for test purposes.

1000 IPC Message Headers Cached.

Rx Side Tx Side

Total Frames 189 140

Total from Local Ports 189 70
Total Protocol Control Frames 70 44
Total Frames Dropped 0 0

Service Usage

Total via Unreliable Connection-Less Service 145 0

Total via Unreliable Sequenced Connection-Less Svc 0 0
Total via Reliable Connection-Oriented Service 44 70

IPC Protocol Version 0

Total Acknowledgements 70 44

Cisco IOS Interface and Hardware Component Command Reference

IR-82
Interface and Hardware Component Commands
clear ipc statistics

Total Negative Acknowledgements 0 0

Device Drivers

Total via Local Driver 0 0

Total via Platform Driver 0 70
Total Frames Dropped by Platform Drivers 0 0

Reliable Tx Statistics

Re-Transmission 0
Re-Tx Timeout 0

Rx Errors Tx Errors

Unsupp IPC Proto Version 0 Tx Session Error 0

Corrupt Frame 0 Tx Seat Error 0
Duplicate Frame 0 Destination Unreachable 0
Out-of-Sequence Frame 0 Tx Test Drop 0
Dest Port does Not Exist 0 Tx Driver Failed 0
Rx IPC Msg Alloc Failed 0 Ctrl Frm Alloc Failed 0
Unable to Deliver Msg 0

Buffer Errors Misc Errors

IPC Msg Alloc 0 IPC Open Port 0

Emer IPC Msg Alloc 0 No HWQ 0
IPC Frame PakType Alloc 0 Hardware Error 0
IPC Frame MemD Alloc 0

Tx Driver Errors

No Transport 0
MTU Failure 0
Dest does not Exist 0

Router# clear ipc statistics

Router# show ipc status

IPC System Status

Time last IPC stat cleared : 00:00:03

This processor is the IPC master server.

Do not drop output of IPC frames for test purposes.

1000 IPC Message Headers Cached.

Rx Side Tx Side

Total Frames 26 0
Total from Local Ports 26 0
Total Protocol Control Frames 0 0
Total Frames Dropped 0 0

Service Usage

Total via Unreliable Connection-Less Service 26 0

Total via Unreliable Sequenced Connection-Less Svc 0 0
Total via Reliable Connection-Oriented Service 0 0

IPC Protocol Version 0

Cisco IOS Interface and Hardware Component Command Reference

IR-83
 Interface and Hardware Component Commands
clear ipc statistics

Total Acknowledgements 0 0
Total Negative Acknowledgements 0 0

Device Drivers

Total via Local Driver 0 0

Total via Platform Driver 0 0
Total Frames Dropped by Platform Drivers 0 0

Reliable Tx Statistics

Re-Transmission 0
Re-Tx Timeout 0

Rx Errors Tx Errors

Unsupp IPC Proto Version 0 Tx Session Error 0

Corrupt Frame 0 Tx Seat Error 0
Duplicate Frame 0 Destination Unreachable 0
Out-of-Sequence Frame 0 Tx Test Drop 0
Dest Port does Not Exist 0 Tx Driver Failed 0
Rx IPC Msg Alloc Failed 0 Ctrl Frm Alloc Failed 0
Unable to Deliver Msg 0

Buffer Errors Misc Errors

IPC Msg Alloc 0 IPC Open Port 0

Emer IPC Msg Alloc 0 No HWQ 0
IPC Frame PakType Alloc 0 Hardware Error 0
IPC Frame MemD Alloc 0

Tx Driver Errors

No Transport 0
MTU Failure 0
Dest does not Exist 0

Related Commands Command Description

show ipc Displays IPC statistics.

Cisco IOS Interface and Hardware Component Command Reference

IR-84
 Interface and Hardware Component Commands
clear rbscp

clear rbscp
To reset and restart a Rate Based Satellite Control Protocol (RBSCP) tunnel, use the clear rbscp
command in privileged EXEC mode.

clear rbscp [tunnel tunnel-number]

Syntax Description tunnel (Optional) Resets and restarts the RBSCP tunnel interface specified in the
tunnel-number argument. If a tunnel interface is not specified, all RBSCP
tunnels are reset and restarted.
• tunnel-number—Number of the tunnel interface in the range from 0 to
2147483647.

Command Modes Privileged EXEC

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines The clear rbscp command resets the tunnel interface to its initial state and this clears RBSCP statistical
information. Use this command for troubleshooting issues with RBSCP tunnels.

Examples The following example shows how to clear the RBSCP statistics. A show rbscp statistics command is
issued first to display the current RBSCP counters for tunnel interface 0. The clear rbscp command is
then entered to reset and restart tunnel interface 0. All the counters for tunnel interface 0 are reset to
zero. A final show rbscp statistics command is issued to show that all the counters, except those
counters that show the packets sent since the clearing, are reset to zero.
Router# show rbscp statistics tunnel 0

Tunnel0 is up, line protocol is up

RBSCP protocol statistics:
Init FWD-TSNs sent 15, received 11
TUNNEL-UPs sent 10, received 5
CLOSEDs sent 3, received 2
TSNs sent 40, resent 2, lost by sender 1
TSNs received 36 (duplicates 2)
FWD-TSNs sent 144 (heartbeats 2)
FWD-TSNs received 120 (ignored 1)
FWD-TSNs caused 3 packet drops, 0 whole window drops
SACKs sent 10, received 6 (ignored 1)
Recovered with RTX 1
Received with delay 2
Most released at once 5
Failed sends into the: tunnel 1, network 0
Dropped due to: excess delay 0, tmit queue full 0
Max on any queue: num packets: 12, num bytes: 0
Max outstanding: 0

Cisco IOS Interface and Hardware Component Command Reference

IR-85
 Interface and Hardware Component Commands
clear rbscp

Router# clear rbscp tunnel 0

Tunnel0: cleared statistics

Router# show rbscp statistics tunnel 0

Tunnel0 is up, line protocol is up

RBSCP protocol statistics:
Init FWD-TSNs sent 0, received 0
TUNNEL-UPs sent 0, received 0
CLOSEDs sent 0, received 0
TSNs sent 0, resent 0, lost by sender 0
TSNs received 0 (duplicates 0)
FWD-TSNs sent 26 (heartbeats 0)
FWD-TSNs received 0 (ignored 0)
FWD-TSNs caused 0 packet drops, 0 whole window drops
SACKs sent 0, received 0 (ignored 0)
Recovered with RTX 0
Received with delay 0
Most released at once 0
Failed sends into the: tunnel 0, network 0
Dropped due to: excess delay 0, tmit queue full 0
Max on any queue: num packets: 0, num bytes: 0
Max outstanding: 0

Related Commands Command Description

show rbscp Displays RBSCP state and statistical information.

Cisco IOS Interface and Hardware Component Command Reference

IR-86
 Interface and Hardware Component Commands
clear service-module serial

clear service-module serial

To reset an integrated CSU/DSU, use the clear service-module serial command in privileged EXEC
mode.

clear service-module serial number

Syntax Description number Number of the serial interface.

Command Modes Privileged EXEC

Command History Release Modification

11.2 This command was introduced.

Usage Guidelines Use this command only in severe circumstances (for example, when the router is not responding to a
CSU/DSU configuration command).
This command terminates all DTE and line loopbacks that are locally or remotely configured. It also
interrupts data transmission through the router for up to 15 seconds. The software performs an automatic
software reset in case of two consecutive configuration failures.
The CSU/DSU module is not reset with the clear interface command.

Caution If you experience technical difficulties with your router and intend to contact customer support,
refrain from using this command. This command erases the router’s past CSU/DSU performance
statistics. To clear only the CSU/DSU performance statistics, issue the clear counters command.

Examples The following example show how to reset the CSU/DSU on a router:
Router# clear service-module serial 0

Related Commands Command Description

clear counters Clears the interface counters.
test service-module Performs self-tests on an integrated CSU/DSU serial interface module, such
as a 4-wire, 56/64-kbps CSU/DSU.

Cisco IOS Interface and Hardware Component Command Reference

IR-87
 Interface and Hardware Component Commands
clock mode

clock mode
To configure the clock mode of a serial circuit emulation (CEM) channel, use the clock mode command
in CEM configuration mode. To reset the clock mode to its default, use the no form of this command.

clock mode {normal | split}

no clock mode

Syntax Description normal Specifies normal mode, in which the DCE, whether it is a CEM over IP
(CEoIP) data port or the external data device, provides both the receive clock
and the transmit clock to the DTE.
split Specifies split mode, in which the DCE, whether it is a CEoIP data port or
the external device, provides the receiver clock to the DTE and the DTE
provides the transmit clock to the DCE.

Defaults The clock mode command defaults to normal mode.

Command Modes CEM configuration

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines This command applies only to serial ports.

Examples The following example shows how to configure the CEM clock for normal mode.
Router(config-cem)# clock mode normal

Related Commands Command Description

cem Enters circuit emulation configuration mode.
clock rate Configures the clock rate of a serial port.
clock source Configures the clock source of a serial port.
show cem Displays CEM statistics.

Cisco IOS Interface and Hardware Component Command Reference

IR-88
 Interface and Hardware Component Commands
clock rate (interface ATM)

clock rate (interface ATM)

To configure the clock rate between a WAN interface card (WIC) and the serial communication
controllers (SCCs) that are used by the WIC, use the clock rate command in interface ATM
configuration mode. To disable the clock rate setting, use the no form of this command.

clock rate [aal2 | aal5] clock-rate-value

no clock rate [aal2 | aal5] clock-rate-value

Syntax Description aal2 (Optional) Specifies the ATM adaptation layer 2 (AAL2) clock rate.
aal5 (Optional) Specifies the ATM adaptation layer 5 (AAL5) clock rate.
clock-rate-value Clock rate value, which can be changed as follows:

aal2—For Cisco 1700 series routers, the minimum value for

asymmetric digital subscriber line (ADSL) and symmetrical
high-data-rate digital subscriber line (G.SHDSL) is 4 Mbps.
The default value for ADSL and G.SHDSL is 8 Mbps.

For Cisco 2600 and Cisco 3600 series routers, the minimum value
for ADSL and G.SHDSL is 1 Mbps. The maximum value is 7 Mbps
for mainboard slots and 5.3 Mbps for network modules. The
default value for ADSL and G.SHDSL is 2.6 Mbps for both
mainboard slots and network modules.
To make full use of the 2.3 Mbps bandwidth for Voice over ATM
(VoATM) nonswitched trunk calls on G.SHDSL, you can change the
1 Mbps default value on Cisco 2600 and Cisco 3600 series routers and
configure the AAL2 clock rate as 2.6 Mbps.
We recommend, however, that you keep the ADSL SCC clock rate for
AAL2 at the default value of 1 Mbps because the upstream of ADSL
cannot exceed 1 Mbps.
Note You should change the AAL2 default value on Cisco 2600 and
Cisco 3600 series routers only if you are using G.SHDSL for
VoATM nonswitched trunk calls using an NM-HDV. At all other
times, the default for AAL2 should remain at 1 Mbps for ADSL and
G.SHDSL.

• aal5—For Cisco 1700 series routers, the minimum value for ADSL and
G.SHDSL is 4 Mbps. The default value for ADSL and G.SHDSL is
8 Mbps.
For Cisco 2600 and Cisco 3600 series routers, the minimum value for
ADSL and G.SHDSL is 1 Mbps. The maximum value is 7 Mbps for
mainboard slots and 5.3 Mbps for network modules. The default value
for ADSL and G.SHDSL is 2.6 Mbps for both mainboard slots and
network modules.
Note If you configure a clock rate that exceeds the maximum limit, the
configuration will fail.

Cisco IOS Interface and Hardware Component Command Reference

IR-89
 Interface and Hardware Component Commands
clock rate (interface ATM)

Command Modes Interface ATM configuration

Command History Release Modification

12.2(8)YN This command was introduced.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.
12.3(2)T This command was integrated into Cisco IOS Release 12.3(2)T for the
following platforms: Cisco 1721, Cisco 2610XM-2651XM, Cisco 2691,
and Cisco 3660.

Usage Guidelines The communication between digital subscriber line (DSL) WICs and a host in a router occurs through a
device called the SCC. If a host wants to forward data or send any control traffic to a DSL WIC, it uses
SCCs. In the same way, if a DSL WIC wants to forward incoming data from a line to the host, it also
uses SCCs. Each DSL WIC installed in the router uses two SCCs. One SCC (SCC-A) is used for AAL5
data traffic, and the other SCC (SCC-B) is used for AAL2 and control traffic. The speed at which the
SCC transfers data between a host and a WIC depends on the clock rate with which it has been
configured. You can configure this clock rate on the basis of the DSL line rate. Even though the DSL
upstream and downstream line rate may vary, the clock rate between the SCC and the DSL WIC is the
same for both the transmitting and receiving direction. That is, the communication between the SCC and
the DSL WIC is synchronous. Therefore, you need to configure only one clock rate for an SCC that will
be used for both transmitting and receiving between an SCC and a DSL WIC.
We always recommend that you configure the SCC clock rate slightly higher than the DSL line rate to
accommodate overhead between the SCC and the DSL WIC. For an asynchronous DSL WIC (for
example, ADSL), the SCC clock rate depends on either the downstream or the upstream line rate,
whichever is the maximum rate. For a synchronous DSL WIC (for example, G.SHDSL), the bandwidth
for upstream and downstream is the same. Therefore, the SCC clock rate configuration can be based on
either the upstream or the downstream line rate.
Because the maximum line rate for G.SHDSL is 2.312 Mbps, the default SCC clock rate of 2.6 Mbps for
AAL5 and 1 Mbps for AAL2 should be sufficient. However, for ADSL, the clock rate may need to be
configured on the basis of the current line rate. If AAL2 is used for voice traffic, the AAL2 SCC must
be configured to the appropriate clock rate: 1 Mbps for ADSL and 2.6 Mbps for G.SHDSL.
The maximum data rate between an SCC and a DSL WIC depends primarily on the maximum clock rate
that the SCC can support. For example, on the Cisco 2600 series mainboard, which supports two DSL
WICs, the total SCC clock rate that can be configured for both WICs is 8 Mbps. Therefore, if only one
DSL WIC is present on the mainboard, AAL5 and AAL2 clock rates can be configured to 7 Mbps and 1
Mbps, respectively. If two DSL WICs are supported on the mainboard, the total of 8 Mbps should be
distributed among the four SCCs.
Network module SCCs also pose similar limitations. That is, on the Cisco 2600 series, the total clock
rate for all four SCCs is 8 Mbps. The maximum AAL5 clock rate that may be configured on a network
module is 5.3 Mbps. On the Cisco 1700 series, the maximum configurable SCC clock rate for both AAL5
and AAL2 is 8 Mbps.
If the clock rate is not configured, the SCC is reset to the default values.
The clock rate can be configured independently for each SCC. To verify the clock rate setting, use the
show running-config command.

Cisco IOS Interface and Hardware Component Command Reference

IR-90
 Interface and Hardware Component Commands
clock rate (interface ATM)

Examples The following example shows how to set the clock rate to 2 Mbps for AAL5 and to 1.3 Mbps for AAL2
for a Cisco 2600 or Cisco 3600 series router:
Router (config)# interface atm1/0
Router (config-if)# no ip address
Router (config-if)# no atm ilmi-keepalive
Router (config-if)# pvc 6/65
Router (config-if)# clock rate aal5 2000000
Router (config-if)# clock rate aal2 1300000
Router (config-if)# vbr-nrt 640 640 128
Router (config-if)# tx-ring-limit 3

Related Commands Command Description

show running-config Displays the current configuration.

Cisco IOS Interface and Hardware Component Command Reference

IR-91
 Interface and Hardware Component Commands
clock rate (interface serial)

clock rate (interface serial)

To configure the clock rate for the hardware connections on serial interfaces, such as network interface
modules (NIMs) and interface processors, to an acceptable bit rate, use the clock rate command in
interface configuration mode. To remove the clock rate if you change the interface from a DCE to a DTE
device, use the no form of this command. Using the no form of this command on a DCE interface sets
the clock rate to the hardware-dependent default value.

clock rate {line | rate}

no clock rate

Syntax Description line (Optional) Specifies that the clock source is the network.
rate Desired clock rate, in bits per second (bps): 1200, 2400, 4800, 9600, 19200, 38400,
56000, 64000, 72000, 125000, 148000, 250000, 500000, 800000, 1000000, 1300000,
2000000, 4000000, or 8000000.
For the synchronous serial port adapters (PA-8T-V35, PA-8T-X21, PA-8T-232, and
PA-4T+), a nonstandard clock rate can be used. You can enter any value from 300 to
8000000 bps. The clock rate you enter is rounded (adjusted), if necessary, to the nearest
value that your hardware can support except for the following standard rates: 1200, 2400,
4800, 9600, 14400, 19200, 28800, 38400, 56000, 64000, 128000, or 2015232.

Defaults No clock rate is configured.

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.
11.3 This command was modified to include nonstandard clock rates for the PA-8T-V35,
PA-8T-X21, PA-8T-232, and PA-4T+ synchronous serial port adapters.
12.3(2)T This command was modified to include the line keyword.

Usage Guidelines Using the no form of this command on a DCE interface sets the clock rate to the hardware-dependent
default value.

Cable Length
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 EIA/TIA-232 signaling. It is recommended that you use the
synchronous serial EIA/TIA-232 signal at speeds up to 64,000 bits per second only. To permit a faster
speed, use EIA/TIA-449 or V.35.

Cisco IOS Interface and Hardware Component Command Reference

IR-92
 Interface and Hardware Component Commands
clock rate (interface serial)

Synchronous Serial Port Adapters

For the synchronous serial port adapters (PA-8T-V35, PA-8T-X21, PA-8T-232, and PA-4T+) on
Cisco 7200 series routers and on second-generation Versatile Interface Processors (VIP2s) in Cisco 7500
series routers, the clock rate that you enter is rounded (if needed) to the nearest value that your hardware
can support. To display the clock rate value for the port adapter, use the show running-config command.
If you plan to boot from a network (TFTP) server over a synchronous serial port adapter interface and
have a boot image prior to Cisco IOS Release 11.1(9)CA that does not support nonstandard (rounded)
clock rates for the port adapters, you must use one of the following standard clock rates:
• 1200
• 2400
• 4800
• 9600
• 19200
• 38400
• 56000
• 64000

Examples The following example shows how to set the clock rate to use the network as the clock source:
Router(config)# interface serial 0
Router(config-if)# clock rate line

The following example shows how to set the clock rate on a synchronous serial port adapter in slot 5,
port 0 to 1,234,567 bps. In this example, the clock rate is adjusted to 1,151,526 bps.
Router(config)# interface serial 5/0
Router(config-if)# clock rate 1234567
%Clockrate rounded to nearest value that your hardware can support.

The following example shows how to determine the exact clock rate that the serial interface was rounded
to by using the show running-config command.
Router# show running-config

Building configuration...
.
.
.
!
interface Serial5/0
no ip address
clockrate 1151526
!
.
.
.

Related Commands Command Description

show running-config Displays the current configuration.

Cisco IOS Interface and Hardware Component Command Reference

IR-93
 Interface and Hardware Component Commands
clock rate network-clock

clock rate network-clock

To configure the network clock rate (speed) for serial ports 0 or 1 in DCE mode, use the clock rate
network-clock command in interface configuration mode. To cancel the network clock rate value, use
the no form of this command.

clock rate network-clock rate

no clock rate network-clock rate

Syntax Description rate Network clock rate, in kbps per second. The range is from 56 to 2048. The
value entered should be a multiple of the value set for the network-clock
base-rate command. There is no default rate.

Defaults No clock rate is set.

Command Modes Interface configuration

Command History Release Modification

11.3(1)MA This command was introduced on the Cisco MC3810 multiservice access
concentrator.

Usage Guidelines This command uses a synchronized clock on the serial port. The use of this command allows the clock
on the serial port to be synchronized with the clock source of controller T1 0.
To configure the clock rate for a serial port in DTE mode, use the clock rate line command.

Examples The following example shows how to configure the clock rate on serial port 1 in DCE mode:
Router(config)# interface serial 1
Router(config-if)# clock rate network-clock 2048

Related Commands Command Description

clock rate line Configures the line clock rate for serial ports 0 or 1 in DTE mode.
clock source (MC3810) Specifies the clock source of a DS1 link on the Cisco MC3810
multiservice access concentrator.
network-clock base-rate Configures the network clock base rate for universal I/O serial ports 0
and 1 on the Cisco MC3810 multiservice concentrator.

Cisco IOS Interface and Hardware Component Command Reference

IR-94
 Interface and Hardware Component Commands
clock save interval

clock save interval

To preserve recent date and time information in NVRAM for when a Cisco IOS device without a
battery-backed calendar is power-cycled or reloaded, use the clock save interval command in global
configuration mode. To return to the default disabled state, use the no form of this command.

clock save interval hours

no clock save interval hours

Syntax Description hours Interval at which the time will be stored in NVRAM. Accepted intervals range
from 8 to 24 hours.

Defaults This function is disabled by default.

Command Modes Global configuration

Command History Release Modification

12.3(2)T This command was introduced.

Usage Guidelines The benefit of using this command is that upon returning from a system reload or power cycle, the system
clock will be set to a time and date near the current time and date instead of being reset to the system
default time and date. In the absence of better information, Cisco IOS devices will initially set their
system clocks to epoch start, which will typically be midnight (UTC) March 1, 1993 or 2002.
When this command is entered, the date and time are saved to NVRAM at the interval specified by this
command, and also during any shutdown process. When the system starts up, the system clock is set to
the last time and date saved to NVRAM.
All Cisco IOS devices support Network Time Protocol (NTP) or Simple Network Time Protocol (SNTP)
to learn the time from the network, and some Cisco IOS devices have built-in battery-backed clocks to
maintain that time. The clock save interval command is for those Cisco IOS devices that do not have
battery-backed clocks and need to know the time and date before they can start communicating with a
network. Because the March 1 system default date will likely occur before the valid date of any recently
issued certificate, communications attempted with almost any certificate will fail because it is not yet
valid according to the local clock.
Saving the time at a 24-hour interval should work well for most networks, unless there is a certificate
that maintains a shorter life span.
Being aware of the time and date is critical for networking devices, and it becomes an issue when
communication to a network requires use of a time-based credential, such as a certificate that has start
and end dates and times. NTP and SNTP are the proper ways to set the time of a network device. The
clock save interval command is intended to complement use of NTP and SNTP, so this command is
useful only when a certificate is required to initiate communication to an NTP server, and the Cisco IOS
device does not have a battery-back hardware clock, but does have NVRAM.

Cisco IOS Interface and Hardware Component Command Reference

IR-95
 Interface and Hardware Component Commands
clock save interval

The system time will only be saved to NVRAM when set by an authoritative source such as NTP or
SNTP; the system will not save the time entered through the set clock command. Additionally, a clock
is considered valid only when the following criteria apply:
• The clock was set by the user using the set clock command and declared authoritative by the clock
calendar-valid command.
• The clock time was learned through NTP or SNTP.
Through a confluence of events, there is no means to authoritatively declare a user-entered time as valid
unless the calendar (battery-backed date and time) is declared valid. Since there is no actual calendar in
a system with this command, the clock calendar-valid command is unavailable, and therefore a
user-entered time can never be considered authoritative on platforms without a battery-backed calendar.
This state is intentional because a battery-backed clock continues to run, and an NVRAM clock will stay
the same. And again, for these reasons the clock save interval command must complement the use of
NTP and SNTP.

Examples The following example shows how to configure a Cisco IOS device to save the time at 24-hour intervals:
Router(config)# clock save interval 24

Cisco IOS Interface and Hardware Component Command Reference

IR-96
 Interface and Hardware Component Commands
clock source (CEM)

clock source (CEM)

To configure the clock source of a circuit emulation (CEM) network module port, use the clock source
command in CEM configuration mode or controller configuration mode. To return to the default clock
source, use the no form of this command.

Cisco NM-CEM-4SER

clock source {internal | loop | adaptive}

no clock source {internal | loop | adaptive}

Cisco NM-CEM-4TE1

clock source {internal | line | adaptive channel-number}

no clock source {internal | line | adaptive channel-number}

Syntax Description internal Specifies that the clocks provided by the port to the attached CPE are
derived from the router’s TDM bus backplane clock (if one exists in the
router) or from the onboard oscillator on the network module.
loop (Cisco NM-CEM-4SER network module only) Specifies that the clock
provided by the port to the attached CPE is derived from the clock received
on the same port from the attached CPE.
line (Cisco NM-CEM-4TE1 network module only) Specifies that the port
transmit clock is derived from receive clock on the same port.
adaptive Specifies that the clocks provided by the port to the attached CPE are locally
synthesized on the basis of the average data content of the local dejitter
buffer.
• channel-number—(Cisco NM-CEM-4TE1 network module only)
Number of the channel whose dejitter buffer is to be used to synthesize
the port’s transmit clock.

Defaults Cisco NM-CEM-4SER

The clock source defaults to internal.

Cisco NM-CEM-4TE1
The clock source defaults to line.

Command Modes Cisco NM-CEM-4SER

CEM configuration

Cisco NM-CEM-4TE1
Controller configuration

Cisco IOS Interface and Hardware Component Command Reference

IR-97
 Interface and Hardware Component Commands
clock source (CEM)

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines When clock source internal is specified, the clocks provided by the network module are derived from
either of the following source:
• The router’s backplane TDM clock frequency (in any router equipped with a TDM backplane bus)
• The master oscillator on the network module (in any router not equipped with a TDM backplane bus)
When the adaptive keyword is specified, the clocks provided by the network module are derived from
the same source as in the clock source internal case. However, the derived frequency is further adjusted
up or down on the basis of the measured average fill of the egress dejitter buffer of the connection. If the
dejitter buffer is perceived to be slowly filling, the frequency is adjusted slightly upward. If the dejitter
buffer is perceived to be slowly depleting, the frequency is adjusted slightly downward.

Cisco NM-CEM-4SER
When the loop keyword is specified, the clock provided by the NM-CEM-4SER is the same as the clock
provided to the NM-CEM-4SER from the attached CPE. The specification of clock source loop is only
valid when the clock mode split command is specified. The clock mode command is used only during
configuration of the NM-CEM-4SER.

Examples The following example shows how to configure the clock source for the serial CEM network module,
NM-CEM-4SER:
Router(config-cem)# clock source loop

The following example shows how to configure the clock source for the T1/E1 CEM network module,
NM-CEM-4TE1:
Router(config-controller)# clock source adaptive 6

Related Commands Command Description

cem Enters circuit emulation configuration mode.
clock mode Configures the clock mode on an NM-CEM-4SER network module.

Cisco IOS Interface and Hardware Component Command Reference

IR-98
 Interface and Hardware Component Commands
clock source (controller)

clock source (controller)

To set the T1-line clock source for the Multichannel Interface Processor (MIP) in the Cisco 7200 series
and Cisco 7500 series, a T3 interface, or a PA-T3 serial port adapter, use the clock source command in
controller configuration mode. To restore the clock source to its default setting, use the no form of this
command.

clock source {line {primary | secondary} | internal}

no clock source

Syntax Description line Specifies that the interface will clock its transmitted data from a clock recovered
from the line’s receive data stream. This is the default.
primary Specifies the source of primary line clocking. The default primary time-division
multiplexing (TDM) clock source is from the T0 controller.
secondary Specifies the source of secondary line clocking. The default secondary TDM
clock source is from the T1 controller.
internal Specifies that the interface will clock its transmitted data from its internal clock.

Defaults The default primary TDM clock source is from the T0 controller.
The default secondary TDM clock source is from the T1 controller.
The default clock for the interface’s transmitted data is from a clock recovered from the line’s receive
data stream from the PA-T3 serial port adapter.

Command Modes Controller configuration

Command History Release Modification

10.3 This command was introduced.
11.1 CA This command was modified to include the T3 serial port adapter and
PA-T3 serial port adapter.

Usage Guidelines This command applies to a Cisco 4000, Cisco 7000 series, Cisco 7200 series, or Cisco 7500 series
router. A T3 interface on a PA-T3 serial port adapter can clock its transmitted data either from its internal
clock or from a clock recovered from the line’s receive data stream.
To use the clocking coming in from a T1 line, configure the clock source line primary command on the
controller that has the most reliable clocking. Configure the clock source line secondary command on
the controller that has the next best known clocking. With this configuration, the primary line clocking
is backed up to the secondary line if the primary clocking shuts down.

Examples The following example shows how to configure the Cisco AS5300 to use the T0 controller as the primary
clocking source and the T1 controller as the secondary clocking source:

Cisco IOS Interface and Hardware Component Command Reference

IR-99
 Interface and Hardware Component Commands
clock source (controller)

AS5200(config)# controller t1 0
AS5200(config-controller)# clock source line primary
AS5200(config-controller)# exit
AS5200(config)# controller t1 1
AS5200(config-controller)# clock source line secondary

Related Commands Command Description

framing Selects the frame type for the T1 or E1 data line.
linecode Selects the line code type for T1 or E1 line.

Cisco IOS Interface and Hardware Component Command Reference

IR-100
 Interface and Hardware Component Commands
clock source (CT3IP)

clock source (CT3IP)

To specify where the clock source is obtained for use by the Channelized T3 Interface Processor (CT3IP)
in Cisco 7500 series routers, use the clock source command in controller configuration mode. To restore
the default clock source, use the no form of this command.

clock source {internal | line | loop-timed}

no clock source

Syntax Description internal Specifies that the internal clock source is used. This is the default.
line Specifies that the network clock source is used.
loop-timed Decouples the controller clock from the system-wide clock set with the
network-clock-select command. The loop-timed clock enables the Digital
Voice Module (DVM) to connect to a PBX and to connect the Multiflex Trunk
Module (MFT) to a central office when both the PBX and the central office
function as DCE clock sources. This situation assumes that the PBX also takes
the clocking from the central office, thereby synchronizing the clocks on the
DVM and the MFT.

Defaults The internal clock source is used.

Command Modes Controller configuration

Command History Release Modification

11.3 This command was introduced.

Usage Guidelines If you do not specify the clock source command, the default internal clock source is used by the CT3IP.
You can also set the clock source for each T1 channel by using the t1 clock source controller
configuration command.

Note This command replaces the pos internal-clock command.

Examples The following example sets the clock source for the CT3IP to line:
Router(config)# controller t3 9/0/0
Router(config-controller)# clock source line

Cisco IOS Interface and Hardware Component Command Reference

IR-101
 Interface and Hardware Component Commands
clock source (CT3IP)

Related Commands Command Description

network-clock-select Specifies selection priority for the clock sources.
t1 clock source Specifies where the clock source is obtained for use by each T1 channel on
the CT3IP in Cisco 7500 series routers.

Cisco IOS Interface and Hardware Component Command Reference

IR-102
 Interface and Hardware Component Commands
clock source (interface)

clock source (interface)

To control the clock from which a G.703-E1 interface, an E1-G.703/G.704 serial port adapter, or a PA-E3
serial port adapter clocks its transmitted data, use the clock source command in interface configuration
mode. To restore the default clock source, use the no form of this command.

Cisco 7000, Cisco 7200, and Cisco 7500 Series

clock source {line | internal}

no clock source

Cisco AS5300 Access Servers

clock source {line {primary | secondary} | internal}

no clock source line {primary | secondary}

Syntax Description line Specifies that the interface will clock its transmitted data from a clock recovered
from the line’s receive data stream. This is the default.
internal Specifies that the interface will clock its transmitted data from its internal clock.
primary Specifies the primary time-division multiplexing (TDM) clock source.
secondary Specifies the secondary TDM clock source.

Defaults Cisco 7000, Cisco 7200, and Cisco 7500 Series

The clock source is obtained from the receive data stream of the line.

Cisco AS5300 Access Servers

The primary TDM clock source is from the T0 controller.
The secondary TDM clock source is from the T1 controller.

Command Modes Interface configuration

Command History Release Modification

10.3 This command was introduced for the Cisco 4000 series, Cisco 7000 series
with RSP7000, and Cisco 7500 series routers with the G.703 E1 interface.
11.1 CA This command was implemented on the TDM bus in a Cisco AS5200 or
Cisco AS5300 access server and was modified to support the
E1-G.703/G.704 serial port adapter, PA-E3 serial port adapters, and
Cisco 7200 series routers.

Cisco IOS Interface and Hardware Component Command Reference

IR-103
 Interface and Hardware Component Commands
clock source (interface)

Usage Guidelines Cisco 7000, Cisco 7200, and Cisco 7500 Series
A G.703-E1 interface, E1-G.703/G.704 serial port adapter, or a PA-E3 serial port adapter can clock its
transmitted data from either its internal clock or from a clock recovered from the line’s receive data
stream.

Cisco AS5300 Access Servers

To use the clocking coming in from a T1 line, configure the clock source line primary command on the
controller that has the most reliable clocking. Configure the clock source line secondary command on
the controller that has the next best known clocking. With this configuration, the primary line clocking
is backed up to the secondary line if the primary clocking shuts down.

Examples Cisco 7000, Cisco 7200, and Cisco 7500 Series

The following example shows how to configure the G.703-E1 interface to clock its transmitted data from
its internal clock:
Router(config)# interface serial 0/1
Router(config-if)# clock source internal

Cisco AS5300 Access Servers

The following example shows how to configure the Cisco AS5300 to use serial interface 1/0 as the
primary clocking source and the serial interface 2/0 as the secondary clocking source:
AS5300(config)# interface serial 1/0
AS5300(config-if)# clock source line primary
AS5300(config-if)# exit
AS5300(config)# interface serial 2/0
AS5300(config-if)# clock source line secondary

The following example shows how to specify the T3 interface to clock its transmitted data from its
internal clock:
Router(config)# interface serial 1/0
Router(config-if)# clock source internal

Cisco IOS Interface and Hardware Component Command Reference

IR-104
 Interface and Hardware Component Commands
clock source (J1 controller)

clock source (J1 controller)

To configure the clock source for a J1 controller, use the clock source command in controller configuration
mode. To restore the clock source to its default setting, use the no form of this command.

clock source {line | internal}

no clock source

Syntax Description line The controller recovers the external clock from the line and provides the
recovered clock to the internal (system) clock generator. The line value is
the default clock source.
internal The controller synchronizes itself to the internal (system) clock.

Defaults Clock source is line for the J1 controller.

Command Modes Controller configuration

Command History Release Modification

11.1 T This command was introduced.
12.2(8)T The command was introduced as a J1 controller configuration command for
the Cisco 2600 and Cisco 3600 series.

Usage Guidelines If multiple network modules are present in the router, then each J1 controller must be given a separate
priority by configuration of the network-clock-select command. The controller having the highest
priority will drive the internal clock.

Examples The following example configures the clock source for line:
Router(config)# controller j1 3/0
Router(config-controller)# clock source line

Related Commands Command Description

network-clock-select Sets the selection priority for a clock source.

Cisco IOS Interface and Hardware Component Command Reference

IR-105
 Interface and Hardware Component Commands
clock source (SONET controller)

clock source (SONET controller)

To specify the clock source of a SONET controller, use the clock source command in controller
configuration mode. To restore the clock source to its default setting, use the no form of this command.

clock source {internal | line | loop}

no clock source

Syntax Description internal Specifies that the clock source uses the internal clock provided by the Route
Switch Controller (RSC). This is the default.
line Specifies that the clock source uses the primary system clock from the optical
line and the recovered clock will go through the RSC phased locked loop (PLL)
circuitry. Can be used when one or more STM-1 cards are installed.
loop Specifies that the clock source uses the primary system clock from the optical
line and the same recovered clock is used in the transmit (tx) direction without
going through the RSC PLL circuitry. Can be used when only one STM-1 card is
installed.

Defaults Internal

Command Modes Controller configuration

Command History Release Modification

10.3 This command was introduced.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.

Examples The following example shows how to specify line timing as the clock source on a SONET controller of
an STM-1 card in physical slot number 2 on a Cisco AS5850:
Router(config)# controller sonet 2/0
Router(config-controller)# clock source line

Cisco IOS Interface and Hardware Component Command Reference

IR-106
 Interface and Hardware Component Commands
clock source (T1/E1 controller)

clock source (T1/E1 controller)

To set clocking for individual T1 or E1 links, use the clock source command in controller configuration
mode. To return to the default, use the no form of this command.

clock source {line [primary | bits] | internal | free-running}

no clock source

Syntax Description line Specifies that the phase-locked loop (PLL) on this controller derives its
clocking from the external source to which the controller is connected,
which is generally the telephone company central office (CO).
• primary—(Optional) Specifies that the PLL on this controller derives
its clocking from the external source to which the controller is
connected. This option also puts a second port, which is generally
connected to the PBX, into looped-time mode. Both ports are
configured with line, but only the port connected to the external source
is configured with primary.
• bits—(Optional) Specifies that the controller will derive clocking from
the Building Integrated Timing Supply (BITS).
internal Specifies that the clock is generated from the T1 or E1 controller’s internal
PLL.
free-running Specifies a free-running clock derived from the oscillator on the
motherboard, which is used only for testing and back-to-back connections.

Defaults The default is line.

Command Modes Controller configuration

Command History Release Modification

12.2(2)XB This command was introduced in controller configuration mode for
Cisco 2600 series and Cisco 3660 routers.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T.
12.2(15)T This command was implemented on the Cisco 2691 and the Cisco 3700
series.
12.3(4)XD The bits keyword was added.
12.3(7)T The bits keyword was integrated into Cisco IOS Release 12.3(7)T.

Usage Guidelines For a detailed discussion of clock sources on individual ports, refer to “Clock Sources on Digital T1/E1
Voice Ports” in the “Configuring Voice Ports” chapter of the Cisco IOS Voice, Video, and Fax
Configuration Guide, Release 12.3.

Cisco IOS Interface and Hardware Component Command Reference

IR-107
 Interface and Hardware Component Commands
clock source (T1/E1 controller)

Examples The following example shows the router providing clock source to two controllers:
Router(config)# controller E1 1/0
Router(config-controller)# framing crc
Router(config-controller)# linecoding hdb3
Router(config-controller)# clock source internal
Router(config-controller)# ds0-group timeslots 1-15 type e&m-wink-start
!
Router(config)# controller E1 1/1
Router(config-controller)# framing esf
Router(config-controller)# linecoding b8zs
Router(config-controller)# clock source internal
Router(config-controller)# ds0-group timeslots 1-15 type e&m-wink-start

The following example shows the digital voice hardware receiving clocking for the PLL from E1 1/0 and
using this clock as a reference to clock E1 1/1. If controller E1 1/0 fails, the PLL internally generates
the clock reference to drive E1 1/1.
Router(config)# controller E1 1/0
Router(config-controller)# framing crc
Router(config-controller)# linecoding hdb3
Router(config-controller)# clock source line
Router(config-controller)# ds0-group timeslots 1-15 type e&m-wink-start
!
Router(config)# controller E1 1/1
Router(config-controller)# framing crc4
Router(config-controller)# linecoding hdb3
Router(config-controller)# clock source internal
Router(config-controller)# ds0-group timeslots 1-15 type e&m-wink-start

The following example shows the router being configured to receive clocking from the BITS.
Router(config)# network-clock-participate slot 1
Router(config)# network-clock-select 1 E1 1/1
Router(config)# controller E1 1/1
Router(config-controller)# clock source line bits

Related Commands Command Description

controller Configures a T1 or E1 controller and enters controller configuration mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-108
 Interface and Hardware Component Commands
clock source (T1/E1 interface)

clock source (T1/E1 interface)

To configure the clock source of a DS1 link, use the clock source command in interface configuration
or ATM interface configuration mode. To restore the default line setting, use the no form of this
command.

clock source {line | internal | loop-timed}

no clock source

Syntax Description line Specifies that the T1/E1 link uses the recovered clock from the line. This is the
default.
internal Specifies that the T1/E1 link uses the internal clock from the interface.
loop-timed Specifies that the T1/E1 interface takes the clock from the Rx (line) and uses it
for Tx.

Defaults line

Command Modes Interface configuration

ATM interface configuration for the Cisco 2600 and Cisco 3600 series routers.

Command History Release Modification

10.3 This command was introduced.
11.1 CA This command was modified to support the E1-G.703/G.704 serial
port adapter, PA-E3 serial port adapters, and Cisco 7200 series routers.
11.3 MA This command was introduced as a controller configuration command for the
Cisco MC3810.
12.0(5)XK The command was introduced as an ATM interface configuration command
for the Cisco 2600 and Cisco 3600 series routers.

Usage Guidelines This command sets clocking for individual T1/E1 links.
Make sure that you specify the clock source correctly for each link, even if you are planning to specify
that a certain link will provide clocking for all the links in an IMA group. Because links may be taken
in and out of service, requiring that the system select another link for common clocking, any link in an
IMA group may provide the common clock.
If the ATM interface is part of an IMA group, you can use the loop-timed keyword to specify that the
clock source is the same as the IMA group clock source.

Examples On a Cisco 2600 or Cisco 3600 series router, the following example specifies an internal clock source
for the link:
Router(config)# interface atm 0/2

Cisco IOS Interface and Hardware Component Command Reference

IR-109
 Interface and Hardware Component Commands
clock source (T1/E1 interface)

Router(config-if)# clock source internal

Related Commands Command Description

ima clock-mode Sets the transmit clock mode for an ATM IMA group.

Cisco IOS Interface and Hardware Component Command Reference

IR-110
 Interface and Hardware Component Commands
clock source (T3/E3 controller)

clock source (T3/E3 controller)

To specify where the clock source is obtained for use by a T3 or E3 controller, use the clock source
command in controller configuration mode. To restore the default clock source, use the no form of this
command.

clock source {internal | line}

no clock source

Syntax Description internal Specifies that the internal clock source is used. This is the default for T3.
line Specifies that the network clock source is used. This is the default for E3.

Defaults The internal clock source is used for T3 controllers.

The line clock source is used for E3 controllers.

Command Modes Controller configuration

Command History Release Modification

12.2(11)YT This command was introduced on the following platforms: Cisco 2650XM,
Cisco 2651XM, Cisco 2691, Cisco 3660 series, Cisco 3725, and Cisco 3745
routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.

Usage Guidelines If you do not specify the clock source command, the default clock source is used.
Configure the clock source line command if your telephone company or the remote data service unit
provides the master clock of the T3 or E3 connection.
Configure the clock source internal command if your router provides the master clock of the T3 or E3
connection.

Note For a back-to-back connection between two T3 or E3 network modules, one controller must be
configured for internal clocking while the other controller must be configured for line clocking.

Examples The following example shows how to set the clock source to line:
Router(config)# controller t3 1/0
Router(config-controller)# clock source line

Cisco IOS Interface and Hardware Component Command Reference

IR-111
 Interface and Hardware Component Commands
clock source (T3/E3 controller)

Related Commands Command Description

controller Configures a T1 or E1 controller and enters controller configuration mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-112
 Interface and Hardware Component Commands
cmt connect

cmt connect
To start the processes that perform the connection management (CMT) function and to allow the ring on
one fiber to be started, use the cmt connect command in user EXEC or privileged EXEC mode.

cmt connect [fddi [port | slot/port] [phy-a | phy-b]]

Syntax Description fddi (Optional) Identifies this as a FDDI interface.

port (Optional) Port number. Refer to the appropriate hardware manual for slot and
port information.
slot (Optional) Slot number. Refer to the appropriate hardware manual for slot and
port information.
phy-a (Optional) Selects Physical Sublayer A.
phy-b (Optional) Selects Physical Sublayer B.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines In normal operation, the FDDI interface is operational once the interface is connected and configured.
The cmt connect command allows the operator to start the processes that perform the CMT function.
The cmt connect command is not needed in the normal operation of FDDI; this command is used mainly
in interoperability tests.
This command does not have a no form. To stop the CMT processes, use the cmt disconnect command.

Examples The following examples demonstrate use of the cmt connect command for starting the CMT processes
on the FDDI ring.
The following command starts all FDDI interfaces:
Router# cmt connect fddi

The following command starts both fibers on FDDI interface unit 0:

Router# cmt connect fddi 0

The following command on the Cisco 7200 series or Cisco 7500 series starts both fibers on FDDI
interface unit 0:
Router# cmt connect fddi 1/0

The following command starts only Physical Sublayer A on FDDI interface unit 0:
Router# cmt connect fddi 0 phy-a

Cisco IOS Interface and Hardware Component Command Reference

IR-113
 Interface and Hardware Component Commands
cmt connect

Related Commands Command Description

cmt disconnect Stops the CMT processes.

Cisco IOS Interface and Hardware Component Command Reference

IR-114
 Interface and Hardware Component Commands
cmt disconnect

cmt disconnect
To stop the processes that perform the connection management (CMT) function and to allow the ring on
one fiber to be stopped, use the cmt disconnect command in user EXEC or privileged EXEC mode.

cmt disconnect [fddi [port | slot/port] [phy-a | phy-b]]

Syntax Description fddi (Optional) Identifies this as a FDDI interface.

port (Optional) Port number. Refer to the appropriate hardware manual for slot and port
information.
slot (Optional) Slot number. Refer to the appropriate hardware manual for slot and port
information.
phy-a (Optional) Selects Physical Sublayer A.
phy-b (Optional) Selects Physical Sublayer B.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines In normal operation, the FDDI interface is operational once the interface is connected and configured,
and is turned on using the no shutdown command in interface configuration mode. The cmt disconnect
command allows the operator to stop the processes that perform the CMT function and allow the ring on
one fiber to be stopped.
The cmt disconnect command is not needed in the normal operation of FDDI; this command is used
mainly in interoperability tests.
This command does not have a no form. To start the CMT processes, use the cmt connect command.

Examples The following examples demonstrate use of the cmt disconnect command for stopping the CMT
processes on the FDDI ring.
The following command stops all FDDI interfaces:
Router# cmt disconnect fddi

The following command stops both fibers on FDDI interface unit 0:

Router# cmt disconnect fddi 0

The following command on the Cisco 7200 series or Cisco 7500 series stops both fibers on FDDI
interface unit 0:
Router# cmt disconnect fddi 1/0

Cisco IOS Interface and Hardware Component Command Reference

IR-115
 Interface and Hardware Component Commands
cmt disconnect

The following command stops only Physical Sublayer A on the FDDI interface unit 0. This command
causes the FDDI media to go into a wrapped state so that the ring will be broken.
Router# cmt disconnect fddi 0 phy-a

The following command on the Cisco 7500 series stops only Physical Sublayer A on FDDI interface
unit 0 in slot 1. This command causes the FDDI media to go into a wrapped state so that the ring will be
broken.
Router# cmt disconnect fddi 1/0 phy-a

Related Commands Command Description

cmt connect Starts the CMT processes.

Cisco IOS Interface and Hardware Component Command Reference

IR-116
 Interface and Hardware Component Commands
compress

compress
To configure software compression for Link Access Procedure, Balanced (LAPB), PPP, and High-Level
Data Link Control (HDLC) encapsulations, use the compress command in interface configuration mode.
To disable compression, use the no form of this command.

compress {predictor | stac}

no compress {predictor | stac}

Cisco VIP2 Cards

compress {predictor | stac [distributed | software]}

[no] compress {predictor | stac [distributed | software]}

Cisco 7200 Series and Cisco 7500 Series

compress {predictor | stac [csa slot | software]}

[no] compress {predictor | stac [csa slot | software]}

PPP Encapsulation

compress [predictor | stac | mppc [ignore-pfc]]

[no] compress [predictor | stac | mppc [ignore-pfc]]

Syntax Description predictor Specifies that a predictor (RAND) compression algorithm will be used on LAPB
and PPP encapsulation. Compression is implemented in the software installed in
the router’s main processor.
stac Specifies that a Stacker (LZS) compression algorithm will be used on LAPB,
HDLC, and PPP encapsulation. For all platforms except Cisco 7200 series and
platforms that support the Virtual Interface Processor 2 (VIP2), compression is
implemented in the software installed in the router’s main processor.
On Cisco 7200 series and on VIP2s in Cisco 7500 series, specifying the
compress stac command with no options causes the router to use the fastest
available compression method for PPP encapsulation only:
• If the router contains a compression service adapter (CSA), compression is
performed in the CSA hardware (hardware compression).
• If a CSA is not available, compression is performed in the software installed
on the VIP2 (distributed compression).
• If a VIP2 is not available, compression is performed in the router’s main
processor (software compression).
distributed (Optional) Specifies that compression is implemented in the software that is
installed in a VIP2. If the VIP2 is not available, compression is performed in the
router’s main processor (software compression).
software (Optional) Specifies that compression is implemented in the Cisco IOS software
installed in the router’s main processor.

Cisco IOS Interface and Hardware Component Command Reference

IR-117
 Interface and Hardware Component Commands
compress

csa slot (Optional) Specifies the CSA to use for a particular interface.
mppc (Optional) Specifies that the Microsoft Point-to-Point Compression (MPPC)
compression algorithm be used.
ignore-pfc (Optional) Specifies that the protocol field compression flag negotiated through
Link Control Protocol (LCP) will be ignored.

Defaults Compression is disabled.

Command Modes Interface configuration

Command History Release Modification

10.3 This command was introduced.
11.3 P The following keywords were added:
• distributed
• software
• csa slot
11.3 T The following keywords were added:
• mppc
• ignore-pfc

Note This command replaces the compress predictor command.

Usage Guidelines Point-to-Point Compression

Compression reduces the size of frames through lossless data compression. You can configure
point-to-point software compression for all LAPB, PPP, and HDLC encapsulations. 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.
End-point devices must be configured to use the same compression method (predictor, Stacker or
MPPC).
HDLC encapsulations supports the Stacker compression algorithm. PPP and LAPB encapsulations
support both predictor and Stacker compression algorithms.

MPPC Compression
The compress command using the mppc and ignore-pfc options support compression between Cisco
routers and access servers and Microsoft clients, such as Windows 95 and Windows NT. MPPC
implements an LZ-based compression algorithm that uses a compression dictionary to compress PPP
packets. The ignore-pfc keyword instructs the router to ignore the protocol field compression flag
negotiated by LCP. For example, the standard protocol field value for IP is 0x0021 when compression is
disabled and 0x21 when compression is enabled. When the ignore-pfc option is enabled, the router will
continue to use the uncompressed value (0x0021). Using the ignore-pfc option is helpful for some

Cisco IOS Interface and Hardware Component Command Reference

IR-118
Interface and Hardware Component Commands
compress

asynchronous driver devices that use an uncompressed protocol field (0x0021), even though the pfc is
negotiated between peers. If protocol rejects are displayed when the debug ppp negotiation command
is enabled, setting the ignore-pfc option may remedy the problem.

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

Public Data Network Connections

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.

Cisco 7200 and Cisco 7500 Series

Using CSA hardware compression on Cisco 7200 series routers and Cisco 7500 series routers removes
the compression and decompression responsibilities from the VIP2 or the main processor installed in the
router. By using the compress stac command, the router determines the fastest compression method
available on the router.
On Cisco 7200 series routers and Cisco 7500 series routers, hardware compression on the compression
service adapter (CSA) is supported for PPP links. When using hardware compression on Cisco 7200
series routers with multiple CSAs, you can optionally specify which CSA is used by the interface to
perform compression. If no CSA is specified, the router determines which CSA is used. On Cisco 7500
series routers, the router uses the CSA on the same VIP2 as the interface.

System Performance

Caution When compression is performed in software installed in the router’s main processor, it might affect
system performance significantly. We recommend that you disable compression if the CPU load
exceeds 40 percent. To display the CPU load, use the show process cpu EXEC command.

If the majority of your traffic is already compressed files, we recommend that you not use compression.
If the files are already compressed, the additional processing time spent in attempting unsuccessfully to
compress them again will slow system performance.
Table 4 provides general guidelines for deciding which compression type to select.

Table 4 Compression Guidelines

Situation Compression Type to Use

Bottleneck is caused by the load on the router. Predictor
Bottleneck is the result of line bandwidth or hardware compression on the Stacker
CSA is available.
Most files are already compressed. None

Software compression makes heavy demands on the router’s processor. The maximum compressed serial
line rate depends on the type of Cisco router that you are using and which compression algorithm you
specify. Table 5 shows a summary of the compressed serial line rates for software compression. The
maximums shown in Table 5 apply to the “combined” serial compressed load on the router. For example,
a Cisco 4000 series router could handle four 64-kbps lines using Stacker compression or one 256-kbps
line. These maximums also assume that there is very little processor load on the router aside from
compression. Lower these numbers when the router is required to do other processor-intensive tasks.

Cisco IOS Interface and Hardware Component Command Reference

IR-119
 Interface and Hardware Component Commands
compress

Table 5 Combined Compressed Serial Line Rates (Software Compression)

Compression Cisco 1000 Cisco 3000 Cisco 4000 Cisco 4500 Cisco 4700 Cisco 7000
Method Series Series Series Series Series Family
Stacker (kbps) 128 128 256 500 T1 256
Predictor (kbps) 256 256 500 T1 2xT1 500

Hardware compression can support a combined line rate of 16 Mbps.

Cisco recommends that you do not adjust the maximum transmission unit (MTU) for the serial interface
and the LAPB maximum bits per frame (N1) parameter.

Note The best performance data compression algorithms adjust their compression methodology as they
identify patterns in the data. To prevent data loss and support this adjustment process, the
compression algorithm is run over LAPB to ensure that everything is sent in order, with no missing
data and no duplicate data.

Note For information on configuring Frame Relay compression, refer to the “Configuring Frame Relay”
chapter in the Cisco IOS Wide-Area Networking Configuration Guide.

Examples The following example enables hardware compression and PPP encapsulation on serial interface 3/1/0.
Router(config)# interface serial 3/1/0
Router(config-if)# encapsulate ppp
Router(config-if)# compress stac

The following example enables predictor compression on serial interface 0 for a LAPB link:
Router(config)# interface serial 0
Router(config-if)# encapsulation lapb
Router(config-if)# compress predictor
Router(config-if)# mtu 1509
Router(config-if)# 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); we recommend that you do not change
those LAPB parameters for Stacker compression:
Router(config)# interface serial 0
Router(config-if)# encapsulation lapb
Router(config-if)# compress predictor

The following example configures BRI interface 0 to perform MPPC:

Router(config)# interface BRI0
Router(config-if)# ip unnumbered ethernet0
Router(config-if)# encapsulation ppp
Router(config-if)# isdn spid1 5551234
Router(config-if)# dialer map ip 172.21.71.74 5551234
Router(config-if)# dialer-group 1
Router(config-if)# compress mppc

Cisco IOS Interface and Hardware Component Command Reference

IR-120
 Interface and Hardware Component Commands
compress

The following example configures asynchronous interface 1 to implement MPPC and ignore the protocol
field compression flag negotiated by LCP:
Router(config)# interface async1
Router(config-if)# ip unnumbered ethernet0
Router(config-if)# encapsulation ppp
Router(config-if)# async default routing
Router(config-if)# async dynamic routing
Router(config-if)# async mode interactive
Router(config-if)# peer default ip address 172.21.71.74
Router(config-if)# compress mppc ignore-pfc

Related Commands Command Description

encapsulation Sets the encapsulation method used by the interface.
encapsulation x25 Specifies operation of a serial interface as an X.25 device.
exec Allows an EXEC process on a line.
show compress Displays compression statistics.
show processes Displays information about the active processes.

Cisco IOS Interface and Hardware Component Command Reference

IR-121
 Interface and Hardware Component Commands
compress mppc

compress mppc
To configure compression using the Microsoft Point-to-Point Compression (MPPC) algorithm on your
data compression Advanced Interface Module (AIM) for the Cisco 2600 series router, use the compress
mppc command in interface configuration mode. To disable MPPC compression, use the no form of this
command.

compress mppc

no compress mppc

Syntax Description This command has no arguments or keywords.

Defaults Disabled

Command Modes Interface configuration

Command History Release Modification

12.0(1)T This command was introduced.

Usage Guidelines The MPPC compression algorithm is used to exchange compressed information with a Microsoft NT
remote access server.
When configuring PPP on a serial interface, you can use hardware compression on the data compression
AIM daughter card for MPPC if one is installed; otherwise you can use software compression.

Examples The following example shows how to configure the data compression AIM daughtercard for MPPC:
Router(config-if)# encapsulate ppp
Router(config-if)# compress mppc

Related Commands Command Description

clear aim Clears data compression AIM registers and resets the hardware.
compress stac caim Specifies the exact hardware compression resource preferred.
encapsulation Sets the encapsulation method used by the interface.
show compress Displays compression statistics.
show pas caim Displays debug information about the data compression AIM
daughtercard.
show processes Displays information about the active processes.

Cisco IOS Interface and Hardware Component Command Reference

IR-122
 Interface and Hardware Component Commands
compress stac caim

compress stac caim

To specify the hardware compression, use the compress stac caim command in interface configuration
mode. To disable compression, use the no form of this command.

compress stac caim interface-number

no compress stac caim interface-number

Syntax Description interface-number Interface on which compression is enabled. AIM interfaces begin with 0.

Defaults Disabled

Command Modes Interface configuration

Command History Release Modification

12.0(1)T This command was introduced.

Usage Guidelines Hardware Compression

If the router contains a data compression Advanced Interface Module (CAIM), compression is
performed in the CAIM hardware.
Using hardware compression in the AIM frees the main processor of the router for other tasks. You can
also configure the router to use the Compression Port Module to perform compression by using the
distributed option or to use the router's main processor by using the software option. If the Compression
Port Module compression is performed in the main processor of the router.

Software Compression
If the CAIM is not available, compression is performed in the main processor of the router.
When compression is performed by the software installed in the router's main memory, system
performance might be affected significantly. It is recommended that you disable compression in the main
processor if the router CPU load exceeds 40 percent. To display the CPU load, use the show process cpu
command in EXEC mode.

Examples The following example specifies that hardware compression should be activated for CAIM interface 0:
Router(config-if)# encapsulation ppp
Router(config-if)# compress stac caim 0

Cisco IOS Interface and Hardware Component Command Reference

IR-123
 Interface and Hardware Component Commands
compress stac caim

Related Commands Command Description

clear aim Clears data compression AIM registers and resets the hardware.
encapsulation Sets the encapsulation method used by the interface.
show compress Displays compression statistics.
show pas caim Displays debug information about the data compression AIM
daughtercard.

Cisco IOS Interface and Hardware Component Command Reference

IR-124
 Interface and Hardware Component Commands
control-lead sampling-rate

control-lead sampling-rate
To configure the sampling rate of input control leads, use the control-lead sampling-rate command in
CEM configuration mode.

control-lead sampling-rate rate

Syntax Description rate Integer that specifies the number of samples per second. Range is from 0 to
20. Default is 0.

Defaults The control-lead sampling rate defaults to 0 (no sampling).

Command Modes CEM configuration

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines This command applies only to serial channels. This command does not have a no form; to disable
control-lead sampling, set the rate argument to 0.

Examples The following example shows how to configure the ingress control-lead sampling rate to 20 samples per
second on a serial CEM port.
Router(config-cem)# control-lead sampling-rate 20

Related Commands Command Description

cem Enters circuit emulation configuration mode.
clear cem Clears CEM channel statistics.
control-lead state Specifies the state of an output control lead.
show cem Displays CEM channel statistics.

Cisco IOS Interface and Hardware Component Command Reference

IR-125
 Interface and Hardware Component Commands
control-lead state

control-lead state
To specify the state of an output control lead, use the control-lead state command in CEM configuration
mode. The choice of output lead depends on whether the port is DCE or DTE.

control-lead state {active | fail} output-lead {on | off | follow} [{local | remote} follow-lead]

Syntax Description active Active template configuration.

fail Failed template configuration.
output-lead Specifies the name of the output control lead. The choice of the control lead
depends on whether the port is DCE or DTE.
on Activates the lead.
off Deactivates the lead.
follow Specifies the control lead state to follow.
local (Optional) Specifies a local lead state.
remote (Optional) Specifies a remote lead state.
follow-lead (Optional) Specifies the local or remote input control lead for this control
lead to follow. The choice of the control lead depends on whether the port is
DCE or DTE.

Defaults The default Active template activated depends on whether the port is DCE or DTE. The default Fail
template deactivates all signals. Table 6 shows the various control-lead default states.

Table 6 Control-Lead Default States

Lead Number DCE Name DTE Name Active Default Fail Default
1 CTS RTS On Off
2 DSR DTR On Off
3 DCD — On Off
4 — LL Off —
5 TM — On Off
6 RI RL Off Off

Command Modes CEM configuration

Command History Release Modification

12.3(7)T This command was introduced.

Cisco IOS Interface and Hardware Component Command Reference

IR-126
 Interface and Hardware Component Commands
control-lead state

Usage Guidelines The state of each output control lead may be specified to assume a constant level (on or off) or to change
on the basis of the state of any input control lead, either at the local data port or at the remote data port.
This command applies only to serial ports. This command does not have a no form; to disable the control
lead, specify the off keyword.

Examples The following example shows how to specify the state of an output control lead.
Router(config-cem)# control-lead state active cts on

Related Commands Command Description

cem Enters circuit emulation configuration mode.
control-lead sampling-rate Configures the sampling rate of input control leads.
show cem Displays CEM channel statistics.

Cisco IOS Interface and Hardware Component Command Reference

IR-127
 Interface and Hardware Component Commands
controller

controller
To configure a T1, E1, or J1 controller and enter controller configuration mode, use the controller
command in global configuration mode.

Cisco 2600 and 3600 Series Routers

controller {t1 | e1 | j1} slot/port

Cisco 7200 Series and Cisco 7500 Series Routers

controller {t1 | e1} slot/port

Cisco AS5300 Access Servers

controller {t1 | e1} number

Cisco AS5800 Access Servers

controller t1 dial-shelf/slot/t3-port:t1-num

Syntax Description t1 T1 controller.

e1 E1 controller.
j1 J1 controller.
slot/port Backplane slot number and port number on the interface. Refer to your hardware
installation manual for the specific values and slot numbers.
number Network processor module (NPM) number, in the range 0 through 2.
dial-shelf Dial shelf chassis in the Cisco AS5800 access server that contains the interface card.
/t3-port T3 port number. The only valid value is 0.
:t1-num T1 timeslot in the T3 line. The value can be from 1 to 28.

Defaults No T1, E1, or J1 controller is configured.

Command Modes Global configuration

Command History Release Modification

10.0 This command was introduced.
10.3 The e1 keyword was added.
12.0(3)T Support was added for dial shelves on Cisco AS5800 access servers.
12.2(7)XO The j1 keyword was added for the Cisco 2600 and Cisco 3600 series.

Cisco IOS Interface and Hardware Component Command Reference

IR-128
 Interface and Hardware Component Commands
controller

Usage Guidelines T1 or E1 Fractional Data Lines

This command is used in configurations where the router or access server is intended to communicate
with a T1 or E1 fractional data line. Additional parameters for the T1 or E1 line must be configured for
the controller before the T1 or E1 circuits can be configured by means of the interface global
configuration command.
To view the status of the controllers use the show controllers command.

Examples Cisco 7500 Series Router As a T1 Controller

The following example configures the MIP in slot 4, port 0 of a Cisco 7500 series router as a T1
controller:
Router(config)# controller t1 4/0
Router(config-controller)#

Cisco AS5800 Access Server with Dial Shelf

The following example configures the T1 controller in shelf 1, slot 0, port 0:
Router(config)# controller t1 1/0/0:1
Router(config-controller)#

Cisco 3660 As a J1 Controller

The following example configures the Cisco IOS interface card in slot 3, port 0 of a Cisco 3660 as a J1
controller:
Router(config)# controller j1 3/0
Router(config-controller)#

Related Commands Command Description

bert abort Resets the T1 or E1 controller.
interface serial Specifies a serial interface created on a channelized E1 or channelized
T1 controller (for ISDN PRI, CAS, or robbed-bit signaling).
show controllers Displays information about the E1 links supported by the NPM
content-engine (Cisco 4000) or MIP (Cisco 7500 series).
show controllers j1 Displays information about the J1 link.
show controllers t1 Displays the total number of calls and call durations on a T1 controller.

Cisco IOS Interface and Hardware Component Command Reference

IR-129
 Interface and Hardware Component Commands
controller dsl

controller dsl
To configure the Digital Subscriber Line (DSL) controller and enter controller configuration mode, use
the controller dsl command in global configuration mode.

controller dsl slot/port

Syntax Description slot Slot number of the DSL controller. Valid numbers are 0 and 1.
/port Port number of the DSL controller. Valid numbers are 0 and 1. The slash
mark is required between the slot argument and the port argument.

Defaults No default behavior or values.

Command Modes Global configuration

Command History Release Modification

12.3(4)XD This command was introduced on Cisco 2600 series and Cisco 3700 series
routers.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T on
Cisco 2600 series and Cisco 3700 series routers.

Usage Guidelines This command is used to enter controller configuration mode for the controller in the specified slot and
port. The central office (CO) and customer premises equipment (CPE) sides must be configured the same
in order for the connection to be made. This command is available only when the WIC-1SHDSL-V2 is
installed.

Examples The following example shows how to enter DSL controller configuration mode on the controller in slot 1
and port 0:
Router(config)# controller dsl 1/0
Router(config-controller)#

Related Commands Command Description

controller shdsl Configures the controller status.
show controller dsl Displays the DSL controller status and the controller number.

Cisco IOS Interface and Hardware Component Command Reference

IR-130
 Interface and Hardware Component Commands
controller e3

controller e3
To configure an E3 controller and enter controller configuration mode, use the controller e3 command
in global configuration mode.

controller e3 slot/port

Syntax Description slot/port Number of the slot and port being configured. Refer to the appropriate
hardware manual for slot and port information. The slash mark is required.

Defaults No E3 controller is configured.

Command Modes Global configuration

Command History Release Modification

11.1 This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and
implemented on the following platforms: Cisco 2650XM, Cisco 2651XM,
Cisco 2691, Cisco 3660 series, Cisco 3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.

Examples The following example shows the E3 controller configured in slot 0, port 0:
Router(config)# controller e3 0/0
Router(config-controller)#

Related Commands Command Description

controller t3 Configures a T3 controller and enters controller configuration mode.
show controllers e3 Displays information about E3 controllers.
show controllers t3 Displays information about T3 controllers.

Cisco IOS Interface and Hardware Component Command Reference

IR-131
 Interface and Hardware Component Commands
controller sonet

controller sonet
To configure a SONET controller and enter controller configuration mode, use the controller sonet
command in global configuration mode.

controller sonet slot/port

Syntax Description slot Physical slot number. The slot number is in a range either from 0 to 5 or 8 to 13,
depending on the slot in which the STM-1 card resides.
/port SONET port number. The port number is always 0 because only one STM-1 port is
supported per interface. The slash mark is required.

Defaults port: 0

Command Modes Global configuration

Command History Release Modification

12.0(14)S This command was introduced.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.

Usage Guidelines This command does not have a no form because the SONET controller is created automatically when the
STM-1 trunk card is detected by the Cisco AS5850. Use this command to specify which slot number the
STM-1 card is plugged into and to configure different attributes under controller configuration mode.

Examples The following example shows how to specify that the SONET controller is in slot number 2:
Router(config)# controller sonet 2/0
Router(config-controller)#

Related Commands Command Description

show controllers sonet Displays information about SONET controllers.

Cisco IOS Interface and Hardware Component Command Reference

IR-132
 Interface and Hardware Component Commands
controller t3

controller t3
To configure the Channelized T3 Interface Processor (CT3IP) in Cisco 7500 series routers or the CT3
feature board in Cisco AS5800 access servers, use the controller t3 command in global configuration
mode. To delete the defined controller, use the no form of this command.

Cisco 7500 Series

controller t3 slot/port-adapter/port

no controller t3 slot/port-adapter/port

Cisco AS5800 Access Server

controller t3 dial-shelf/slot/t3-port

no controller t3 dial-shelf/slot/t3-port

Syntax Description slot Number of the slot being configured. Refer to the appropriate hardware
manual for slot and port information./
/port-adapter Number of the port adapter being configured. Refer to the appropriate
hardware manual for information about port adapter compatibility.
/port Number of the port being configured. Refer to the appropriate hardware
manual for slot and port information.
dial-shelf Dial shelf chassis in the Cisco AS5800 access server containing the CT3
interface card.
/slot Location of the CT3 interface card in the dial shelf chassis.
/t3-port T3 port number. The only valid value is 0.

Defaults Cisco 7500 Series

No T3 controller is configured.

Cisco AS5800 Access Server

No default behavior or values.

Command Modes Global configuration

Command History Release Modification

11.3 This command was introduced.
12.0(3)T This command was implemented on the Cisco AS5800 access server.

Cisco IOS Interface and Hardware Component Command Reference

IR-133
 Interface and Hardware Component Commands
controller t3

Usage Guidelines This command is used to configure the CT3IP and the 28 T1 channels. After the T1 channels are
configured, continue to configure each T1 channel as a serial interface by using the interface serial
global configuration command

Examples Cisco 7500 Series

The following example configures the CT3IP in slot 3:
Router(config)# controller t3 3/0/0

Cisco AS5800 Access Server

The following example configures the T3 controller in shelf 3, slot 0, port 0 and T1 time slot 1:
Router(config)# controller t3 3/0/0

Related Commands Command Description

controller Configures a T1, E1, or J1 controller and enters controller configuration
mode.
interface Specifies a serial interface created on a channelized E1 or channelized
T1 controller (for ISDN PRI, CAS, or robbed-bit signaling).

Cisco IOS Interface and Hardware Component Command Reference

IR-134
 Interface and Hardware Component Commands
crc

crc
To set the length of the cyclic redundancy check (CRC) on a Fast Serial Interface Processor (FSIP) or
HSSI Interface Processor (HIP) of the Cisco 7500 series routers or on a 4-port serial adapter of the
Cisco 7200 series routers, use the crc command in interface configuration mode. To set the CRC length
to 16 bits, use the no form of this command.

crc size

no crc

Syntax Description size CRC size in bits. Valid values are 16 and 32. The default is 16.

Defaults 16 bits

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines All interfaces use a 16-bit CRC by default, but also support a 32-bit CRC. CRC is an error-checking
technique that uses a calculated numeric value to detect errors in transmitted data. The designators 16
and 32 indicate the length (in bits) of the frame check sequence (FCS). A CRC of 32 bits provides more
powerful error detection, but adds overhead. Both the sender and receiver must use the same setting.
CRC-16, the most widely used throughout the United States and Europe, is used extensively with WANs.
CRC-32 is specified by IEEE 802 and as an option by some point-to-point transmission standards. It is
often used on Switched Multimegabit Data Service (SMDS) networks and LANs.

Examples The following example enables the 32-bit CRC on serial interface 3/0:
Router(config)# interface serial 3/0
Router(config-if)# crc 32

Cisco IOS Interface and Hardware Component Command Reference

IR-135
 Interface and Hardware Component Commands
crc bits 5

crc bits 5
To enable generation of CRC5 (per ITU Recommendation G.704 and G.703) to improve data integrity,
use the crc bits 5 command in interface configuration mode. To disable this function, use the no form
of this command.

crc bits 5

no crc bits 5

Syntax Description This command has no arguments or keywords.

Defaults CRC5 checking is disabled.

Command Modes Interface configuration

Command History Release Modification

11.1 CA This command was introduced.

Usage Guidelines This command is available for the JT2 6.3-MHz serial port adapter (PA-2JT2) on the second-generation
Versatile Interface Processor (VIP2), in Cisco 7500 series routers, and in Cisco 7000 series routers with
the Cisco 7000 series Route Switch Processor (RSP7000) and the Cisco 7000 series Chassis Interface
(RSP7000CI).
This command is useful for checking data integrity while operating in framed mode. CRC5 provides
additional protection for a frame alignment signal under noisy conditions. For data transmission at
JT2 (6.312 Mbps), the G.704 standard suggests 5 bits CRC. Refer to ITU Recommendation G.704 for a
definition of CRC5.
You can also use the crc command to set the CRC size for the High-Level Data Link Control (HDLC)
controllers.

Examples The following example enables CRC5 generation on the PA-2JT2 port adapter and also sets the CRC size
to 32 bits:
Router(config)# interface serial 0/0
Router(config-if)# crc 32
Router(config-if)# crc bits 5

Related Commands Command Description

crc Sets the length of the CRC.

Cisco IOS Interface and Hardware Component Command Reference

IR-136
 Interface and Hardware Component Commands
crc4

crc4
To enable generation of CRC4 (per ITU Recommendation G.704 and G.703) to improve data integrity,
use the crc4 command in interface configuration mode. To disable this function, use the no form of this
command.

crc4

no crc4

Syntax Description This command has no arguments or keywords.

Defaults Disabled

Command Modes Interface configuration

Command History Release Modification

10.3 This command was introduced.
11.1 CA This command was implemented on the Cisco 7200 series router and the
E1-G.703/G.704 serial port adapter.

Usage Guidelines This command applies to the Cisco 7200 series, Cisco 7000 series, and Cisco 7500 series routers. This
command is supported on the Fast Serial Interface Processor (FSIP) and the E1-G.703/G.704 serial port
adapter.
This command is useful for checking data integrity while operating in framed mode. CRC4 provides
additional protection for a frame alignment signal under noisy conditions. For data transmission at
E1 (2.048 Mbps), the G.704 standard suggests 4 bits CRC. Refer to CCITT Recommendation G.704 for
a definition of CRC4.
You can also use the crc command to set the CRC size for the High-Level Data Link Control (HDLC)
controllers.

Examples The following example enables CRC4 generation on the E1-G.703/G.704 serial port adapter and also
sets the CRC size to 32 bits:
Router(config)# interface serial 0/0
Router(config-if)# crc 32
Router(config-if)# crc4

Related Commands Command Description

crc Sets the length of the CRC.

Cisco IOS Interface and Hardware Component Command Reference

IR-137
 Interface and Hardware Component Commands
crc-threshold

crc-threshold
To define a severely errored second (SES) by specifying the number of cyclic redundancy check (CRC)
errors that occur in one second, use the crc-threshold command in controller configuration mode. To
return to the default value, use the no form of this command.

crc-threshold value

no crc-threshold

Syntax Description value Number of CRC errors in one second that results in the second being
declared a severely errored second (SES). Range is from 0 to 3000. Default
is 320.

Defaults The default threshold value is 320 CRC errors per second.

Command Modes Controller configuration

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines On a T1 port, this command applies only if extended super frame (ESF) framing is used because the
super frame (SF) (also known as D4) frame structure does not include any CRC protection.
This command does not apply to an E1 port.

Examples The following example shows how to set the CRC threshold at 512 CRC errors in one second.
Router(config-controller)# crc-threshold 512

Cisco IOS Interface and Hardware Component Command Reference

IR-138
 Interface and Hardware Component Commands
cut-through

cut-through
To configure the interfaces on the PA-12E/2FE port adapter to use cut-through switching technology
between interfaces within the same bridge group, use the cut-through command in interface
configuration mode. To return each interface to store-and-forward switching, use the no form of this
command.

cut-through [receive | transmit]

no cut-through

Syntax Description receive (Optional) Selects cut-through switching technology on received data.
transmit (Optional) Selects cut-through switching technology on transmitted data.

Defaults Store-and-forward switching technology (that is, no cut-through)

Command Modes Interface configuration

Command History Release Modification

11.2 P This command was introduced.

Usage Guidelines Cut-through mode allows switched packets to be transmitted after 64 bytes are received. The
transmission of the packets can start before the end of the packet arrives. This reduces the time spent in
the switch, but allows packets to be transmitted with bad cyclical redundancy checks (CRCs), because
the transmission is initiated before the CRC is received or checked. Store-and-forward mode waits for
the entire packet to be received before that packet is forwarded, but will check the CRC before starting
transmission.
The PA-12E/2FE port adapter offloads Layer 2 switching from the host CPU by using store-and-forward
or cut-through switching technology between interfaces within the same VLAN on the PA-12E/2FE port
adapter. The PA-12E/2FE port adapter supports up to four VLANs (bridge groups).

Examples The following example configures interface 3/0 for cut-through switching:
Router(config)# interface fastethernet 3/0
Router(config-if)# bridge-group 10
Router(config-if)# cut-through
Router(config-if)# no shutdown
Router(config-if)# exit

Cisco IOS Interface and Hardware Component Command Reference

IR-139
 Interface and Hardware Component Commands
data-protection

data-protection
To enable data protection for a circuit emulation (CEM) channel, use the data-protection command in
CEM configuration mode. To disable data protection, use the no form of this command.

data-protection

no data-protection

Syntax Description This command has no arguments or keywords.

Defaults Data protection is disabled.

Command Modes CEM configuration

Command History Release Modification

12.3(7)T This command was introduced.

Examples The following example demonstrates how to enable data protection.

Router(config-cem)# data-protection

Related Commands Command Description

cem Enters circuit emulation configuration mode.
clear cem Clears CEM channel statistics.
show cem Displays CEM channel statistics.

Cisco IOS Interface and Hardware Component Command Reference

IR-140
 Interface and Hardware Component Commands
data-strobe

data-strobe
To specify an input control lead to be monitored as an indicator of valid data, use the data-strobe
command in CEM configuration mode. To disable the monitoring of an input control lead, use the no
form of this command.

data-strobe input-lead {on | off}

no data-strobe

Syntax Description input-lead Specifies the input lead. The choice of leads depends on whether the port is
DCE or DTE.
on Enables packet creation when the lead is asserted.
off Enables packet creation when the lead is deactivated.

Defaults No input control lead is monitored.

Command Modes CEM configuration

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines Any input control signal on a serial data port may be configured as a "data strobe" to indicate to the
NM-CEM-4SER network module whether ingress data on the port should be encapsulated for
transmission or ignored. If the data strobe command is specified with the on keyword, data packets are
created and sent when the input lead is asserted. If the data strobe is off (either intentionally, or as a result
of the failure of the customer premises equipment [CPE]), no data packets are created, and this results
in preservation of bandwidth in the IP network.
This command applies only to serial ports.

Examples The following example demonstrates how to specify that packets are to be created and sent to the far end
only when the DTR input control lead is asserted.
Router(config-cem)# data-strobe dtr on

Related Commands Command Description

cem Enters circuit emulation configuration mode.
clear cem Clears CEM channel statistics.
control-lead sampling rate Configures the sampling rate of input control leads.

Cisco IOS Interface and Hardware Component Command Reference

IR-141
 Interface and Hardware Component Commands
data-strobe

Command Description
control-lead state Specifies the state of an output control lead.
show cem Displays CEM channel statistics.

Cisco IOS Interface and Hardware Component Command Reference

IR-142
 Interface and Hardware Component Commands
dce-terminal-timing enable

dce-terminal-timing enable
To prevent phase shifting of the data with respect to the clock when running the line at high speeds and
long distances, use the dce-terminal-timing enable command in interface configuration mode. If serial
clock transmit external (SCTE) terminal timing is not available from the DTE, use the no form of this
command; the DCE will use its own clock instead of SCTE from the DTE.

dce-terminal-timing enable

no dce-terminal-timing enable

Syntax Description This command has no arguments or keywords.

Defaults The DCE uses its own clock.

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines On the Cisco 4000 router, you can specify the serial Network Interface Module timing signal
configuration. When the board is operating as a DCE and the DTE provides terminal timing (SCTE or
TT), the dce-terminal-timing enable command causes the DCE to use SCTE from the DTE.

Examples The following example shows how to prevent phase shifting of the data with respect to the clock:
Router(config)# interface serial 0
Router(config-if)# dce-terminal-timing enable

Cisco IOS Interface and Hardware Component Command Reference

IR-143
 Interface and Hardware Component Commands
default (CEM)

default (CEM)
To reset channel options to their default values, use the default command in CEM configuration mode.

default {data-protection | dejitter-buffer | idle-pattern | ip dscp | ip tos | ip precedence |

payload-compression | payload-size | signaling}

Syntax Description data-protection Resets data protection to its default value.

dejitter-buffer Resets the dejitter buffer to its default value.
idle-pattern Resets the idle pattern to its default value.
ip dscp Resets the IP differentiated services code point (DSCP) field to its default
value.
ip tos Resets the IP type of service (ToS) field to its default value.
ip precedence Resets the IP precedence field to its default value.
payload-compression Resets payload compression to its default value.
payload-size Resets payload size to its default value.
signaling Resets signaling to its default value.

Defaults The CEM channel options are set at their configured values.

Command Modes CEM configuration

Command History Release Modification

12.3(7)T This command was introduced for CEM configuration mode.

Examples The following example demonstrates how to reset CEM channel data protection to its default value.
Router(config-cem)# default data-protection

Related Commands Command Description

cem Enters circuit emulation configuration mode.
clear cem Clears CEM channel statistics.
data-protection Enables data protection.
dejitter-buffer Configures the dejitter buffer size.
idle-pattern Defines the idle pattern that the channel transmits when it goes down.
payload-compression Enables payload compression.
payload-size Configures the payload size.
show cem Displays CEM channel statistics.
signaling Enables CAS signaling.

Cisco IOS Interface and Hardware Component Command Reference

IR-144
 Interface and Hardware Component Commands
dejitter-buffer

dejitter-buffer
To configure the size of the dejitter buffer, use the dejitter-buffer command in CEM configuration
mode. To restore the dejitter buffer to its default size, use the no form of this command.

dejitter-buffer size

no dejitter-buffer

Syntax Description size Size, in milliseconds, of the dejitter buffer. The range is from 5 to 500. The
default is 60.

Defaults The dejitter buffer defaults to 60 milliseconds.

Command Modes CEM configuration

Command History Release Modification

12.3(7)T This command was introduced.

Examples The following example shows how to set the dejitter buffer to 200 milliseconds.
Router(config-cem)# dejitter-buffer 200

Related Commands Command Description

cem Enters circuit emulation configuration mode.
clear cem Clears CEM channel statistics.
show cem Displays CEM channel statistics.

Cisco IOS Interface and Hardware Component Command Reference

IR-145
 Interface and Hardware Component Commands
delay (interface)

delay (interface)
To set a delay value for an interface, use the delay command in interface configuration mode. To restore
the default delay value, use the no form of this command.

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. To see the default delay, use the show interfaces
command.

Defaults Default delay values may be displayed with the show interfaces EXEC command.

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Examples The following example shows how to set a delay of 30,000 microseconds on serial interface 3:
Router(config)# interface serial 3
Router(config-if)# delay 3000

Related Commands Command Description

show interfaces Displays the statistical information specific to a serial interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-146
 Interface and Hardware Component Commands
description (controller)

description (controller)
To add a description to an E1 or T1 controller or the Channelized T3 Interface Processor (CT3IP) in
Cisco 7500 series routers, use the description command in controller configuration mode. To remove
the description, use the no form of this command.

description string

no description

Syntax Description string Comment or description (up to 80 characters) to help you remember what is
attached to an interface.

Defaults No description is added.

Command Modes Controller configuration

Command History Release Modification

10.3 This command was introduced.
11.3 This command was modified to include the CT3IP controller.

Usage Guidelines The description command is meant solely as a comment to be put in the configuration to help you
remember what certain controllers are used for. The description affects the CT3IP and Multichannel
Interface Processor (MIP) interfaces only and appears in the output of the show controller e1, show
controller t1, show controller t3, and show running-config EXEC commands.

Examples The following example shows how to add a description for a 3174 controller:
Router(config)# controller t1
Router(config-controller)# description 3174 Controller for test lab

Related Commands Command Description

show controllers e1 Displays information about the E1 links supported by the NPM
(Cisco 4000) or MIP (Cisco 7500 series).
show controllers t1 Displays information about the T1 links.
show controllers t3 Displays information about the CT3IP on Cisco 7500 series routers.

Cisco IOS Interface and Hardware Component Command Reference

IR-147
 Interface and Hardware Component Commands
dot1q tunneling ethertype

dot1q tunneling ethertype

To define the Ethertype field type used by peer devices when implementing Q-in-Q VLAN tagging, use
the dot1q tunneling ethertype command in interface configuration mode. To remove the VLAN tag
Ethertype, use the no form of this command.

dot1q tunneling ethertype ethertype

no dot1q tunneling ethertype ethertype

Syntax Description ethertype Type of Ethertype field. Valid values are either 0x8100 or 0x9100. Default is
0x8100.

Defaults The Ethertype field used by peer devices when implementing Q-in-Q VLAN tagging is 0x8100.

Command Modes Interface configuration

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines Use the dot1q tunneling ethertype command if the peer switching devices are using an Ethertype field
value of 0x9100. All Cisco switching devices use the default Ethertype field value of 0x8100.
This command is used with the IEEE 802.1Q-in-Q VLAN Tag Termination feature in which double
VLAN tagging is configured using the encapsulation dot1q command. 802.1q double tagging allows a
service provider to use a single VLAN to support customers who have multiple VLANs.

Examples The following example shows how to configure an Ethertype field as 0x9100:
Router(config)# interface gigabitethernet 1/0/0
Router(config-if)# dot1q tunneling ethertype 0x9100

Related Commands Command Description

encapsulation dot1q Enables 802.1q encapsulation of traffic on a specified subinterface or range
of subinterfaces.
interface Configures an interface and enters interface configuration mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-148
 Interface and Hardware Component Commands
down-when-looped

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

down-when-looped

Syntax Description This command has no arguments or keywords.

Defaults Disabled

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines This command is valid for High-Level Data Link Control (HDLC) or PPP encapsulation on serial and
High-Speed Serial Interface (HSSI) interfaces.
This command does not have a no form.

Backup 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 enabled only
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.

Testing an Interface with the Loopback Command

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

Examples The following example shows how to configure interface serial 0 for HDLC encapsulation. The interface
is then configured to let the system know that it is down when in loopback mode.
Router(config)# interface serial0
Router(config-if)# encapsulation hdlc
Router(config-if)# down-when-looped

Cisco IOS Interface and Hardware Component Command Reference

IR-149
 Interface and Hardware Component Commands
down-when-looped

Related Commands Command Description

backup interface Configures an interface as a secondary or dial backup interface.
loopback (E3 Diagnoses equipment malfunctions between an interface and a device.
controller)

Cisco IOS Interface and Hardware Component Command Reference

IR-150
 Interface and Hardware Component Commands
ds0-group (J1 controller)

ds0-group (J1 controller)

To configure channelized J1 time slots, use the ds0-group command in controller configuration mode.
To remove the DS0 group, use the no form of this command.

ds0-group ds0-group-no timeslots timeslot-list type external-signaling

no ds0-group ds0-group-no timeslots timeslot-list type external-signaling

Syntax Description ds0-group-no Specifies the DS0 group number.

timeslots timeslot-list Specifies the DS0 time slot range of values from 1 to 31 for J1 interfaces.
Time slot 16 is reserved for signaling.
type external-signaling Specifies that the signaling traffic comes from an outside source. The
signaling method selection for type depends on the connection that you are
making.

Defaults No DS0 group is defined.

Command Modes Controller configuration

Command History Release Modification

11.2 This command was originally the cas-group command.
12.0(1)T The cas-group command was introduced for the Cisco 3600 series.
12.0(5)XE The command was renamed ds0-group on the Cisco AS5300 and on the
Cisco 2600 and Cisco 3600 series.
12.0(7)T The command was integrated into the Cisco IOS Release 12.0(7)T.
12.2(8)T The command was introduced as a J1 configuration command for the
Cisco 2600 and Cisco 3600 series.

Usage Guidelines The ds0-group command replaces the existing cas-group command. Making the command generic
allows flexibility and scalability. It is not restricted to channel associated signaling (CAS) or channel
bundling.
The ds0-group command automatically creates a logical voice port that is numbered as follows on
Cisco 2600 and Cisco 3600 series routers: slot/port:ds0-group-no. Although only one voice port is
created for each group, applicable calls are routed to any channel in the group.

Examples The following example is sample output from the show controllers j1 command on the Cisco 3660
series after channelized J1 time slots have been configured:
Router(config-controller)# ds0-group 1 timeslots 1-15,17-31 type e&m-wink-start
Router(config-controller)# end
Router# show controllers j1

Cisco IOS Interface and Hardware Component Command Reference

IR-151
 Interface and Hardware Component Commands
ds0-group (J1 controller)

*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(1), cp

*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(2), cp
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(3), cp
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(4), cp
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(5), cp
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(6), cp
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(7), cp
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(8), cp
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(9), cp
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(10), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(11), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(12), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(13), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(14), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(15), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(17), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(18), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(19), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(20), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(21), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(22), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(23), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(24), p
*Mar 1 03:12:26.263: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(25), p
*Mar 1 03:12:26.263: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(26), p
*Mar 1 03:12:26.263: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(27), p
*Mar 1 03:12:26.263: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(28), p
*Mar 1 03:12:26.263: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(29), p
*Mar 1 03:12:26.263: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(30), p
*Mar 1 03:12:26.263: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(31), p

Related Commands Command Description

ds0 busyout Busyouts one or more signal level 0s (DS0s).

Cisco IOS Interface and Hardware Component Command Reference

IR-152
 Interface and Hardware Component Commands
dsl-mode shdsl symmetric annex

dsl-mode shdsl symmetric annex

To specify the operating mode of the digital subscriber line (DSL) controller, use the dsl-mode shdsl
symmetric annex command in controller configuration mode. To return the DSL to the default Annex A,
use the no form of this command.

dsl-mode shdsl symmetric annex mode

Syntax Description mode Sets the DSL operating mode. The valid values are:
• a: Supports Annex A of the G.991.2 standard for North America. This
is the default.
• b: Supports Annex B of the G.991.2 standard for Europe.
• a-b: Supports Annex A or B. For CPE mode only. Not supported in CO
mode. Selected when the line trains.
• a-b-anfp: Supports Annex A or B–ANFP. For CPE mode only. Not
supported in CO mode. Selected when the line trains.
• b-anfp: Supports Annex B–ANFP.

Defaults The annex defaults to A for North America.

Command Modes Controller configuration

Command History Release Modification

12.3(4)XD This command was introduced on Cisco 2600 series and Cisco 3700 series
routers.
12.3(4)XG This command was integrated into the Cisco IOS Release 12.3(4)XG on the
Cisco 1700 series routers.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T on
Cisco 2600 series, Cisco 3631, and Cisco 3700 series routers.
12.3(11)T Support for the following additional annex parameters was integrated into
Cisco IOS Release 12.3(11)T to support Cisco 1700, Cisco 1800,
Cisco 2600, Cisco 2800, Cisco 3700, and Cisco 3800 series routers:
• b
• a–b
• a–b–anfp
• b–anfp

Cisco IOS Interface and Hardware Component Command Reference

IR-153
 Interface and Hardware Component Commands
dsl-mode shdsl symmetric annex

Usage Guidelines This command is used to configure the DSL controller interface to operate in a specified DSL mode and
to set regional operating parameters. The shdsl keyword is used to set the mode to SHDSL and
configures multirate, high-speed DSL per ITU G.991.2. The symmetric keyword configures the
controller to symmetric mode. The annex keyword configures the controller to use regional operating
parameters. The regional operating parameters default to North America.

Examples The following example displays the use of the controller dsl 0/0 command to configure the controller
in the router configured on the central office (CO) side. Use the dsl-mode shdsl symmetric annex b
command to configure the controller for multirate, high-speed DSL with symmetric mode for European
operating parameters.
Router# configure terminal

Router(config)# controller dsl 0/0

Router(config-controller)# line-term co
Router(config-controller)# dsl-mode shdsl symmetric annex b
Router(config-controller)# mode atm
Router(config-controller)#
00:22:07: %CONTROLLER-5-UPDOWN: Controller DSL 0/0, changed state to down

Router(config-controller)# line-mode 4-wire

00:23:25: %CONTROLLER-5-UPDOWN: Controller DSL 0/0, changed state to up
00:23:31: %LINK-3-UPDOWN: Interface ATM0/0, changed state to up
00:23:32: %LINEPROTO-5-UPDOWN: Line protocol on Interface ATM0/0, changed state to up

Related Commands Command Description

controller dsl Configures the DSL controller.

Cisco IOS Interface and Hardware Component Command Reference

IR-154
 Interface and Hardware Component Commands
dsu bandwidth

dsu bandwidth
To specify the maximum allowable bandwidth used by a T3 or E3 controller or the PA-T3 and PA-E3
port adapters, use the dsu bandwidth command in interface configuration mode. To return to the default
bandwidth, use the no form of this command.

dsu bandwidth kbps

no dsu bandwidth

Syntax Description kbps Maximum bandwidth, in kbps. Range is from 22 to 44736. Default values are as
follows:
• 34010 for E3 or PA-E3
• 44210 for T3
• 44736 for PA-T3

Defaults 34010 kbps for E3 or PA-E3

44210 kbps for T3
44736 kbps for PA-T3

Command Modes Interface configuration

Command History Release Modification

11.1 CA This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and
implemented on the following platforms: Cisco 2650XM, Cisco 2651XM,
Cisco 2691, Cisco 3660 series, Cisco 3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.

Usage Guidelines The local interface configuration must match the remote interface configuration. For example, if you
reduce the maximum bandwidth to 16000 on the local port, you must also do the same on the remote port.
The dsu bandwidth command reduces the bandwidth by padding the E3 and T3 frame.
To verify the data service unit (DSU) bandwidth configured on the interface, use the show interfaces
serial EXEC command.
When G.751 framing is used, DSU bandwidth can be used to select a payload subrate from 34010 kbps
down to 22 kbps. Before framing bypass can be used, a DSU bandwidth of 34010 kbps must be
configured.

Cisco IOS Interface and Hardware Component Command Reference

IR-155
 Interface and Hardware Component Commands
dsu bandwidth

Even though software allows the user to configure a continuous range of bandwidths in subrate modes,
vendors support bandwidths only in quantums (for example, in an E3 digital link, bandwidth must be in
multiples of 358 kbps). Therefore, the software sets the user-configured bandwidth to the closest
vendor-supported bandwidth. Use the show interfaces serial slot/port command to display the actual
bandwidth that is configured.
The user-configured subrate mode, subrate bandwidth, actual subrate bandwidth configured, and
scramble configuration are displayed near the end of the show interfaces serial command output.
The following table shows DSU modes and vendor-supported bandwidths.

Mode DSU Bandwidth Range Bandwidth Multiples

0 Digital Link or Cisco 358–34010 kbps for E3 358 kbps
300–44210 kbps for T3 300.746 kbps
1 ADC Kentrox T3/E3 IDSU 1000–34010 kbps for E3 500 kbps
1500–44210 kbps for T3 500 kbps
2 Larscom Access T45 3100–44210 kbps 3158 kbps
3 Adtran T3SU 300 75–44210 kbps 75.186 kbps
4 Verilink HDM 2182 1500–44210 kbps 1579 kbps

Examples The following example sets the maximum allowable DSU bandwidth to 16,000 kbps on interface 1/0/0:
Router(config)# interface serial 1/0/0
Router(config-if)# dsu bandwidth 16000

The following example shows the user-configured subrate bandwidth and the actual configured subrate
bandwidth as displayed in the output of the show interfaces serial command:
Router# show interfaces serial

Serial1/0 is up, line protocol is up

Hardware is DSXPNM Serial
MTU 1500 bytes, BW 44210 Kbit, DLY 20000 usec,
reliability 253/255, txload 1/255, rxload 1/255
Encapsulation HDLC, crc 16, loopback not set
Keepalive not set
DTR is pulsed for 0 seconds on reset, Restart-Delay is 1637167 secs
Last input 04:59:04, output 04:59:04, output hang never
Last clearing of "show interface" counters 00:00:02
Input queue:0/75/0/0 (size/max/drops/flushes); Total output drops:0
Queueing strategy:fifo
Output queue :0/40 (size/max)
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 throttles
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 output buffer failures, 0 output buffers swapped out
0 carrier transitions
DSU mode 0, bandwidth 34010, real bandwidth 34010, scramble 0

Cisco IOS Interface and Hardware Component Command Reference

IR-156
 Interface and Hardware Component Commands
dsu bandwidth

Related Commands Command Description

show interfaces serial Displays information that is specific to the interface hardware.

Cisco IOS Interface and Hardware Component Command Reference

IR-157
 Interface and Hardware Component Commands
dsu mode

dsu mode
To specify the interoperability mode used by a T3 or E3 controller or the PA-T3 and PA-E3 port adapters,
use the dsu mode command in interface configuration mode. To return to the default mode, use the no
form of this command.

dsu mode {0 | 1 | 2 | 3 | 4}

no dsu mode

Syntax Description 0 Sets the interoperability mode to 0. This is the default. Specify mode 0 to
connect an E3 controller to another E3 controller or to a Digital Link DSU
(DL3100). Specify mode 0 to connect a PA-E3 port adapter to another PA-E3
port adapter or to a Digital Link DSU (DL3100). Use mode 0 to connect a
PA-T3 port adapter to another PA-T3 port adapter or to a Digital Link DSU
(DL3100).
1 Sets the interoperability mode to 1. Specify mode 1 to connect an E3 or T3
controller or a PA-E3 or PA-T3 port adapter to a Kentrox DSU.
2 Sets the interoperability mode to 2. Specify mode 2 to connect a T3 controller
or a PA-T3 port adapter to a Larscom DSU.
3 Sets the interoperability mode to 3. Specify mode 3 to connect a T3 controller
to an Adtran T3SU 300.
4 Sets the interoperability mode to 4. Specify mode 4 to connect a T3 controller
to a Verilink HDM 2182.

Defaults 0

Command Modes Interface configuration

Command History Release Modification

11.1 CA This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and
implemented on the following platforms for E3 and T3 controllers:
Cisco 2650XM, Cisco 2651XM, Cisco 2691, Cisco 3660 series, Cisco 3725,
and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.

Usage Guidelines Scrambling Support on T3 and E3 Serial Interfaces in DSU Mode 1

DSU mode 1 refers to Kentrox mode. If DSU mode is used on a T3 serial interface and the bandwidth is
= > 35,000 bps, the scrambling option is not supported. Likewise, if DSU mode 1 is used for an E3 serial
interface and the bandwidth is = > 24,510 bps, scrambling is not supported.

Cisco IOS Interface and Hardware Component Command Reference

IR-158
 Interface and Hardware Component Commands
dsu mode

Match Local and Remote DSU Configurations

The local interface configuration must match the remote interface configuration. For example, if you
define the data service unit (DSU) interoperability mode as 1 on the local port, you must also do the same
on the remote port.

Know the DSU Type

You must know what type of DSU is connected to the remote port to determine if it interoperates with
an E3 or T3 controller or a PA-E3 or PA-T3 port adapter. The dsu mode command enables and improves
interoperability with other DSUs.

Verify DSU Mode

To verify the DSU mode configured on the interface, use the show controllers serial or show interfaces
serial EXEC commands.

Examples The following example sets the DSU mode to 1 on interface 1/0/0:
Router(config)# interface serial 1/0/0
Router(config-if)# dsu mode 1

The following example shows the configuration for a serial interface configured in DSU mode 1. The
bandwidth is set higher than that supported by the Kentrox firmware allows for scrambling. therefore,
the scrambling option is not supported in this configuration.
Router(config)# interface serial 1/0/0
Router(config-if)# mtu 4474
Router(config-if)# ip address 216.186.93.114 255.255.255.252
Router(config-if)# ip mtu 4470
Router(config-if)# dsu mode 1
Router(config-if)# dsu bandwidth 44210

Related Commands Command Description

show controllers serial Displays information that is specific to the serial controllers.
show interfaces serial Displays information that is specific to the interface hardware.

Cisco IOS Interface and Hardware Component Command Reference

IR-159
 Interface and Hardware Component Commands
dte-invert-txc

dte-invert-txc
To invert the transmit external clock (TXC) signal received from the DCE when the device is operating
as a DTE, use the dte-invert-txc command in interface configuration mode. If the DCE accepts serial
clock transmit external (SCTE) signal when the device is operating as a DTE, use the no form of this
command.

dte-invert-txc

no dte-invert-txc

Syntax Description This command has no arguments or keywords.

Defaults The TXC signal is not inverted.

Command Modes Interface configuration

Command History Release Modification

9.1 This command was introduced.

Usage Guidelines Use this command if the DCE cannot receive SCTE from the DTE, the data is running at high speeds,
and the transmission line is long. The dte-invert-txc command prevents phase shifting of the data with
respect to the clock.
On the Cisco 4000 series, you can specify the serial Network Processor Module timing signal
configuration. When the board is operating as a DTE, the dte-invert-txc command inverts the TXC
clock signal it gets from the DCE that the DTE uses to transmit data.
If the DCE accepts SCTE from the DTE, use no dte-invert-txc.

Examples The following example inverts the TXC on serial interface 0:

Router(config)# interface serial 0
Router(config-if)# dte-invert-txc

Cisco IOS Interface and Hardware Component Command Reference

IR-160
 Interface and Hardware Component Commands
duplex

duplex
To configure duplex operation on an interface, use the duplex command in interface configuration mode.
To return the system to half-duplex mode, the system default, use the no form of this command.

duplex {full | half | auto}

no duplex

Syntax Description full Specifies full-duplex operation.

half Specifies half-duplex operation. This is the default.
auto Specifies the autonegotiation capability. The interface automatically operates at half or
full duplex, depending on environmental factors, such as the type of media and the
transmission speeds for the peer routers, hubs, and switches used in the
network configuration.

Defaults Half-duplex mode

Command Modes Interface configuration

Command History Release Modification

11.2(10)P This command was introduced.

Usage Guidelines To use the autonegotiation capability (that is, detect speed and duplex modes automatically), you must
set both speed and duplex to auto.
Table 7 describes the access server’s performance for different combinations of the duplex and speed
modes. The specified duplex command configured with the specified speed command produces the
resulting system action.

Table 7 Relationship Between duplex and speed Commands

duplex Command speed Command Resulting System Action

duplex auto speed auto Autonegotiates both speed and duplex
modes.
duplex auto speed 100 or speed 10 Autonegotiates both speed and duplex
modes.
duplex half or duplex full speed auto Autonegotiates both speed and duplex
modes.
duplex half speed 10 Forces 10 Mbps and half duplex.
duplex full speed 10 Forces 10 Mbps and full duplex.

Cisco IOS Interface and Hardware Component Command Reference

IR-161
 Interface and Hardware Component Commands
duplex

Table 7 Relationship Between duplex and speed Commands (continued)

duplex Command speed Command Resulting System Action

duplex half speed 100 Forces 100 Mbps and half duplex.
duplex full speed 100 Forces 100 Mbps and full duplex.

For the Cisco AS5300, the duplex {full | half | auto} command syntax replaces the following two earlier
duplex commands:
• half-duplex
• full-duplex
You will get the following error messages if you try to use these commands on a Cisco AS5300:
Router(config)# interface fastethernet 0
Router(config-if)# full-duplex
Please use duplex command to configure duplex mode
Router(config-if)#
Router(config-if)# half-duplex
Please use duplex command to configure duplex mode

Examples The following example shows how to configure full- duplex operation on a Cisco AS5300:
Router(config)# interface fastethernet 0
Router(config-if)# duplex full

Related Commands Command Description

interface fastethernet Selects a particular Fast Ethernet interface for configuration.
show controllers Displays information about initialization block information, transmit
fastethernet ring, receive ring, and errors for the Fast Ethernet controller chip on
the Cisco 4500, Cisco 7200 series, or Cisco 7500 series routers.
speed Configures the speed for a Fast Ethernet interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-162
 Interface and Hardware Component Commands
e2-clockrate

e2-clockrate
To configure serial interface 0 for E2 (8 MHz full duplex) and to shut down the other three serial
interfaces (1 to 3), use the e2-clockrate command in interface configuration mode. To disable the full
duplex E2, use the no form of this command.

e2-clockrate

no e2-clockrate

Syntax Description This command has no arguments or keywords.

Defaults All interfaces are running.

Command Modes Interface configuration

Command History Release Modification

12.0(2)XD This command was introduced.
12.0(3)T This command was integrated into Cisco IOS Release 12.0(3)T.

Usage Guidelines The e2-clockrate command is an interface configuration command and is seen only with interface
serial0. When this command is used, serial interface 0 supports speeds up to E2 (8 MHz full duplex) and
the other three serial interfaces (1 to 3) are put in the “shutdown” state. Also, running this command
displays the following warning message:
Serial interface 0 is configured to support E2 rates and serial ports “1-3” are moved to
shutdown state.

Examples The following example shows sample display output for the e2-clockrate EXEC command.
Router(config-if)# e2-clockrate
Interface Serial 0 is configured to support clockrates up to E2 (8Mbps)
Interfaces serial 1-3 will not be operational

Related Commands Command Description

clock rate Configures the clock rate for the hardware connections on serial interfaces such as
NIMs and interface processors to an acceptable bit rate.

Cisco IOS Interface and Hardware Component Command Reference

IR-163
 Interface and Hardware Component Commands
early-token-release

early-token-release
To enable early token release on Token Ring interfaces, use the early-token-release command in
interface configuration mode. To disable this function, use the no form of this command.

early-token-release

no early-token-release

Syntax Description This command has no arguments or keywords.

Defaults Disabled

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines 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. This feature helps
increase the total bandwidth of the Token Ring.
The Token Ring Interface Processor (TRIP) on the Cisco 7500 series routers and the Token Ring adapters
on the Cisco 7200 series routers all support early token release.

Examples The following example enables the use of early token release on Token Ring interface 1:
Router(config)# interface tokenring 1
Router(config-if)# early-token-release

The following example enables the use of early token release on the Token Ring interface processor in
slot 4 on port 1 on the Cisco 7500 series routers:
Router(config)# interface tokenring 4/1
Router(config-if)# early-token-release

Cisco IOS Interface and Hardware Component Command Reference

IR-164
 Interface and Hardware Component Commands
encapsulation

encapsulation
To set the encapsulation method used by the interface, use the encapsulation command in interface
configuration mode. To remove the encapsulation, use the no form of this command.

encapsulation encapsulation-type

no encapsulation encapsulation-type

Syntax Description encapsulation-type Encapsulation type; one of the following keywords:

• atm-dxi—ATM Mode-Data Exchange Interface.
• bstun—Block Serial Tunnel.
• dot1q vlan-id [native]—Enables IEEE 802.1q encapsulation of traffic
on a specified subinterface in VLANs. The vlan-id argument is a virtual
LAN identifier. The valid range is from 1 to 1000. The optional native
keyword sets the PVID value of the port to the vlan-id value.
• 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. This is the default for synchronous serial interfaces.
• isl vlan-id—Inter-Switch Link (ISL) (for VLANs).
• lapb—X.25 Link Access Procedure, Balanced. Data link layer protocol
(LAPB) DTE operation (for serial interface).
• ppp—PPP (for serial interface).
• sde said—IEEE 802.10. The said argument is a security association
identifier. This value is used as the VLAN identifier. The valid range is
from 0 to 0xFFFFFFFE.
• sdlc—IBM serial Systems Network Architecture (SNA).
• sdlc-primary—IBM serial SNA (for primary serial interface).
• sdlc-secondary—IBM serial SNA (for secondary serial interface).
• slip—Specifies Serial Line Internet Protocol (SLIP) encapsulation for
an interface configured for dedicated asynchronous mode or
dial-on-demand routing (DDR). This is the default for asynchronous
interfaces.
• smds—Switched Multimegabit Data Services (SMDS) (for serial
interface).
• ss7—Sets the encapsulation type to SS7 and overrides the serial
interface objects high-level data link control (HDLC) default.

Defaults The default depends on the type of interface. For example, synchronous serial interfaces default to
HDLC and asynchronous interfaces default to SLIP.

Cisco IOS Interface and Hardware Component Command Reference

IR-165
 Interface and Hardware Component Commands
encapsulation

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.
10.3 The sde keyword was added to support IEEE 802.10
11.1 The isl keyword was added to support the Interswitch Link (ISL) Cisco
protocol for interconnecting multiple switches and routers, and for defining
virtual LAN (VLAN) topologies.
11.3(4)T The tr-isl trbrf-vlan keyword was added to support TRISL, a Cisco
proprietary protocol for interconnecting multiple routers and switches and
maintaining VLAN information as traffic goes between switches.
12.0(1)T The dot1q keyword was added to support IEEE 8021q standard for
encapsulation of traffic on a specified subinterface in VLANs.
12.1(3)T The native keyword was added.
12.2(11)T This command was modified to include the ss7 keyword in support of
integrated signaling link terminal capabilities.
12.3(2)T The tr-isl trbrf-vlan keyword was removed because support for the TRISL
protocol is no longer available in Cisco IOS software.

Usage Guidelines SLIP and PPP

To use SLIP or PPP, the router or access server must be configured with an IP routing protocol or with
the ip host-routing command. This configuration is done automatically if you are using old-style slip
address commands. However, you must configure it manually if you configure SLIP or PPP via the
interface async command.
On lines configured for interactive use, encapsulation is selected by the user when they establish a
connection with the slip or ppp EXEC command.
IP Control Protocol (IPCP) is the part of PPP that brings up and configures IP links. After devices at both
ends of a connection communicate and bring up PPP, they bring up the control protocol for each network
protocol that they intend to run over the PPP link such as IP or IPX. If you have problems passing IP
packets and the show interface command shows that line is up, use the negotiations command to see if
and where the negotiations are failing. You might have different versions of software running, or
different versions of PPP, in which case you might need to upgrade your software or turn off PPP option
negotiations. All IPCP options as listed in RFC 1332, PPP Internet Protocol Control Protocol (IPCP),
are supported on asynchronous lines. Only Option 2, TCP/IP header compression, is supported on
synchronous interfaces.
PPP echo requests are used as keepalive packets to detect line failure. The no keepalive command can
be used to disable echo requests. For more information about the no keepalive command, refer to the
chapter “IP Services Commands” in the Cisco IOS IP Command Reference, Volume 1 of 4: Addressing
and Services and to the chapter “Configuring IP Services” in the Cisco IOS IP Configuration Guide.
To use SLIP or PPP, the Cisco IOS software must be configured with an IP routing protocol or with the
ip host-routing command. This configuration is done automatically if you are using old-style slip
address commands. However, you must configure it manually if you configure SLIP or PPP via the
interface async command.

Cisco IOS Interface and Hardware Component Command Reference

IR-166
 Interface and Hardware Component Commands
encapsulation

Note Disable software flow control on SLIP and PPP lines before using the encapsulation command.

SS7
The SS7 encapsulation command is new with the Integrated SLT feature and is available only for
interface serial objects created by the channel-group command. For network access server (NAS)
platforms, the encapsulation for channel group serial interface objects defaults to HDLC. You must
explicitly set the encapsulation type to SS7 to override this default.
When encapsulation is set to SS7, the encapsulation command for that object is no longer available. A
serial SS7 link is deleted only when its associated dial feature card (DFC) card is removed. As with
existing Cisco 26xx-based SLTs, you do not need to specify whether the SS7 link is to be used as an
A-link or an F-link.
By itself this command does not select the correct encapsulation type. Therefore, once created, you must
set the encapsulation type to the new SS7 value, as well as assign a session channel ID to the link at the
serial interface command level. The configuration on a digital SS7 link can be saved (no shutdown) only
when its encapsulation is successfully set to SS7 and it has been assigned a channel identifier.

VLANs
Do not configure encapsulation on the native VLAN of an IEEE 802.1q trunk without the native
keyword. (Always use the native keyword when the vlan-id is the ID of the IEEE 802.1q native VLAN.)
For detailed information on use of this command with VLANs, refer to the Cisco IOS Switching Services
Configuration Guide and the Cisco IOS Switching Services Command Reference.

Examples The following example shows how to reset HDLC serial encapsulation on serial interface 1:
Router(config)# interface serial 1
Router(config-if)# encapsulation hdlc

The following example shows how to enable PPP encapsulation on serial interface 0:
Router(config)# interface serial 0
Router(config-if)# encapsulation ppp

The following example shows how to configure async interface 1 for PPP encapsulation:
Router(config)# interface async 1
Router(config-if)# encapsulation ppp

To learn more about the virtual serial interface and check SS7 encapsulation, enter the show interfaces
serial slot/trunk:channel-group command in privileged EXEC mode, as in the following example:
Router# show interfaces serial 7/3:1

Serial7/3:1 is up, line protocol is down

Hardware is PowerQUICC Serial
MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec,
reliability 255/255, txload 4/255, rxload 1/255
Encapsulation SS7 MTP2, loopback not set
Keepalive set (10 sec)
Last input never, output 00:00:00, output hang never
Last clearing of "show interface" counters 03:53:40
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 26000 bits/sec, 836 packets/sec

Cisco IOS Interface and Hardware Component Command Reference

IR-167
 Interface and Hardware Component Commands
encapsulation

0 packets input, 0 bytes, 0 no buffer

Received 0 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
11580159 packets output, 46320636 bytes, 0 underruns
0 output errors, 0 collisions, 1 interface resets
0 output buffer failures, 0 output buffers swapped out
2 carrier transitions
DCD=up DSR=down DTR=down RTS=down CTS=down

Related Commands Command Description

channel-group Assigns a channel group and selects the DSO time slots desired for SS7
links.
encapsulation x25 Specifies operation of a serial interface as an X.25 device.
keepalive Sets the keepalive timer for a specific interface.
ppp Starts an asynchronous connection using PPP.
ppp authentication Enables CHAP or PAP or both and specifies the order in which CHAP and
PAP authentication are selected on the interface.
ppp bap call Sets PPP BACP call parameters.
slip Starts a serial connection to a remote host using SLIP.

Cisco IOS Interface and Hardware Component Command Reference

IR-168
 Interface and Hardware Component Commands
end (satellite initial configuration)

end (satellite initial configuration)

To exit satellite initial configuration mode, save any new or changed parameters, and reset the Cisco IP
VSAT satellite WAN network module (NM-1VSAT-GILAT), use the end command in satellite initial
configuration mode.

end

Syntax Description This command has no arguments or keywords.

Defaults No default behavior or values

Command Modes Satellite initial configuration

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines The end command is identical to the exit command in satellite initial configuration mode.
When you enter the exit or end command to exit satellite initial configuration mode, the system
automatically saves any changed parameters to the NM-1VSAT-GILAT network module nonvolatile
memory and resets the NM-1VSAT-GILAT network module.

Examples The following example shows what appears when you enter the end or exit command after changing one
or more initial configuration parameters:
Router(sat-init-config)# end
Applying changed parameters to the satellite module.
Parameter update succeeded. Module is now resetting.
Router#

The following example shows what appears when you enter the end or exit command when no
parameters have been changed:
Router(sat-init-config)# end
Router#

Related Commands Command Description

apply Saves new or changed satellite initial configuration parameters and resets the
Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT).
exit (satellite initial Exits satellite initial configuration mode, saves any new or changed
configuration) parameters, and resets the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT).

Cisco IOS Interface and Hardware Component Command Reference

IR-169
 Interface and Hardware Component Commands
exit (satellite initial configuration)

exit (satellite initial configuration)

To exit satellite initial configuration mode, save any new or changed parameters, and reset the Cisco IP
VSAT satellite WAN network module (NM-1VSAT-GILAT), use the exit command in satellite initial
configuration mode.

exit

Syntax Description This command has no arguments or keywords.

Defaults No default behavior or values

Command Modes Satellite initial configuration

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines The exit command is identical to the end command in satellite initial configuration mode.
When you enter the exit or end command to exit satellite initial configuration mode, the system
automatically saves any changed parameters to the NM-1VSAT-GILAT network module nonvolatile
memory and resets the NM-1VSAT-GILAT network module.

Examples The following example shows what appears when you enter the exit or end command after changing one
or more initial configuration parameters:
Router(sat-init-config)# exit
Applying changed parameters to the satellite module.
Parameter update succeeded. Module is now resetting.
Router#

The following example shows what appears when you enter the exit or end command when no
parameters have been changed:
Router(sat-init-config)# exit
Router#

Related Commands Command Description

apply Saves new or changed satellite initial configuration parameters and resets the
Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT).
end (satellite initial Exits satellite initial configuration mode, saves any new or changed
configuration) parameters, and resets the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT).

Cisco IOS Interface and Hardware Component Command Reference

IR-170
 Interface and Hardware Component Commands
error throttling

error throttling
To stop receiving error data packets on multiple channel groups configured on all interfaces on the T1
controller of a channelized T3 port adapter, use the error throttling command in T3 controller
configuration mode. To continue receiving error data packets on all channels on the T1 controller, use
the no form of this command.

error throttling

no error throttling

Syntax Description This command has no arguments or keywords.

Defaults The error throttling command is enabled by default.

Command Modes T3 controller configuration

Command History Release Modification

12.2(19c) This command was introduced.

Usage Guidelines Use the show controllers t3 command to display whether the current router configuration has error
throttling enabled or disabled.
The error throttling command disables the T1 level clock in order to stop receiving error data packets
on a T1 controller.
When a T1 has multiple channel groups configured over it, error throttling affects all the channels on a
T1. If any single interface receives a burst of errors, over a short duration, such as 400 errors in 100
milliseconds, the T1 clock is turned off for a period of 100 milliseconds. The reason is that when there
is a high rate of errors, the error rate is very likely to continue for a long duration of time. Using error
throttling to stop receiving the error data packets reduces wasteful processing and discarding of error
packets.
The no error throttling command allows all the error data packets to be processed, dropped, and
accounted for on a T1 controller. When the error rate is high, the CPU can become overloaded.
When the no error throttling command is used to configure a T3 port, the configuration applies to all
of the 28 associated T1 channels.

Examples The following example enables error throttling by disabling the T1 clock in order to stop receiving error
data packets on a T1 controller:
Router(config-controller)# error throttling

Cisco IOS Interface and Hardware Component Command Reference

IR-171
 Interface and Hardware Component Commands
error throttling

The following example uses the show controllers t3 command to display partial output showing that
error throttling is enabled on the T1 controller:
Router# show controllers t3 2/1/0

T3 2/1/0 is down. Hardware is 2CT3 single wide port adapter

CT3 H/W Version: 0.2.2, CT3 ROM Version: 1.0, CT3 F/W Version: 2.5.1
FREEDM version: 1, reset 0 resurrect 0
Applique type is Channelized T3
Transmitter is sending remote alarm.
Receiver has loss of signal.
FEAC code received: No code is being received
Framing is M23, Line Code is B3ZS, Clock Source is Internal
Rx-error throttling on T1's ENABLED
.
.
.

Related
Commands Command Description
show controllers t3 Displays whether the current router configuration has error throttling
enabled or disabled.

Cisco IOS Interface and Hardware Component Command Reference

IR-172
 Interface and Hardware Component Commands
fddi burst-count

fddi burst-count
To allow the FCI card to preallocate buffers to handle bursty FDDI traffic (for example, Network File
System [NFS] bursty traffic), use the fddi burst-count command in interface configuration mode. To
revert to the default value, use the no form of this command.

fddi burst-count number

no fddi burst-count

Syntax Description number Number of preallocated buffers in the range from 1 to 10. The default is 3.

Defaults 3 buffers

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines This command applies to the FCI card only.

Note The microcode software version should not be 128.45 or 128.43.

Examples The following example sets the number of buffers to 5:

Router(config)# interface fddi 0
Router(config-if)# fddi burst-count 5

Cisco IOS Interface and Hardware Component Command Reference

IR-173
 Interface and Hardware Component Commands
fddi c-min

fddi c-min
To set the C-Min timer on the pulse code modulation (PCM), use the fddi c-min command in interface
configuration mode. To revert to the default value, use the no form of this command.

fddi c-min microseconds

no fddi c-min

Syntax Description microseconds Sets the timer value, in microseconds. The default is 1600.

Defaults 1600 microseconds

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines This command applies to the processor connection management (CMT) only. You need extensive
knowledge of the PCM state machine to tune this timer. Use this command when you run into PCM
interoperability problems.

Examples The following example sets the C-Min timer to 2000 microseconds:
Router(config)# interface fddi 0
Router(config-if)# fddi c-min 2000

Related Commands Command Description

fddi tb-min Sets the TB-Min timer in the PCM.
fddi tl-min-time Controls the TL-Min time (the minimum time to transmit a PHY line state
before advancing to the PCM state, as defined by the X3T9.5 specification).
fddi t-out Sets the t-out timer in the PCM.

Cisco IOS Interface and Hardware Component Command Reference

IR-174
 Interface and Hardware Component Commands
fddi cmt-signal-bits

fddi cmt-signal-bits
To control the information transmitted during the connection management (CMT) signaling phase, use
the fddi cmt-signal-bits command in interface configuration mode.

fddi cmt-signal-bits signal-bits [phy-a | phy-b]

Syntax Description signal-bits A hexadecimal number preceded by 0x; for example, 0x208. The FDDI
standard defines 10 bits of signaling information that must be transmitted, as
follows:
• bit 0—Escape bit. Reserved for future assignment by the FDDI standards
committee.
• bits 1 and 2—Physical type, as defined in Table 8.
• bit 3—Physical compatibility. Set if topology rules include the
connection of a physical-to-physical type at the end of the connection.
• bits 4 and 5—Link confidence test duration; set as defined in Table 9.
• bit 6—MAC available for link confidence test.
• bit 7—Link confidence test failed. The setting of bit 7 indicates that the
link confidence was failed by the Cisco end of the connection.
• bit 8—MAC for local loop.
• bit 9—MAC on physical output.
phy-a (Optional) Selects Physical Sublayer A. The default is 0x008 (hexadecimal)
or 00 0000 1000 (binary). Bits 1 and 2 are set to 00 to select Physical A. Bit 3
is set to 1 to indicate “accept any connection.”
phy-b (Optional) Selects Physical Sublayer B. The default is 0x20c (hexadecimal)
or 10 0000 1100 (binary). Bits 1 and 2 are set to 10 to select Physical B. Bit
3 is set to 1 to indicate “accept any connection.” Bit 9 is set to 1 to select MAC
on output. The normal data flow on FDDI is input on Physical A and output
on Physical B.

Defaults • phy-a is set to 0x008 (hexadecimal) or 00 0000 1000 (binary). Bits 1 and 2 are set to 00 to select
Physical A. Bit 3 is set to 1 to indicate “accept any connection.”
• phy-b is set to 0x20c (hexadecimal) or 10 0000 1100 (binary). Bits 1 and 2 are set to 10 to select
Physical B. Bit 3 is set to 1 to indicate “accept any connection.” Bit 9 is set to 1 to select MAC on
output. The normal data flow on FDDI is input on Physical A and output on Physical B.

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Cisco IOS Interface and Hardware Component Command Reference

IR-175
 Interface and Hardware Component Commands
fddi cmt-signal-bits

Usage Guidelines If neither the phy-a nor phy-b keyword is specified, the signal bits apply to both physical connections.

Caution Use of the fddi cmt-signal-bits configuration command is not recommended under normal operations.
This command is used when debugging specific CMT implementation issues.

Table 8 lists the physical types.

Table 8 FDDI Physical Type Bit Specifications

Bit 2 Bit 1 Physical Type

0 0 Physical A
1 0 Physical B
0 1 Physical S
1 1 Physical M

Table 9 lists the duration bits.

Table 9 FDDI Link Confidence Test Duration Bit Specification

Bit 5 Bit 4 Test Duration

0 0 Short test (default 50 milliseconds)
1 0 Medium test (default 500 milliseconds)
0 1 Long test (default 5 seconds)
1 1 Extended test (default 50 seconds)

This command does not have a no form.

Examples The following example sets the CMT signaling phase to signal bits 0x208 on both physical connections:
Router(config)# interface fddi 0
Router(config-if)# fddi cmt-signal-bits 0x208

Cisco IOS Interface and Hardware Component Command Reference

IR-176
 Interface and Hardware Component Commands
fddi duplicate-address-check

fddi duplicate-address-check
To enable the duplicate address detection capability on the FDDI interface, use the fddi
duplicate-address-check command in interface configuration mode. To disable this function, use the no
form of this command.

fddi duplicate-address-check

no fddi duplicate-address-check

Syntax Description This command has no arguments or keywords.

Defaults Disabled

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines If you use this command, the Cisco IOS software will detect a duplicate address if multiple stations are
sharing the same MAC address. If the software finds a duplicate address, it will shut down the interface.

Examples The following example enables duplicate address checking on the FDDI interface:
Router(config)# interface fddi 0
Router(config-if)# fddi duplicate-address-check

Cisco IOS Interface and Hardware Component Command Reference

IR-177
 Interface and Hardware Component Commands
fddi encapsulate

fddi encapsulate
To specify encapsulating bridge mode on the CSC-C2/FCIT interface card, use the fddi encapsulate
command in interface configuration mode. To turn off encapsulation bridging and return the FCIT
interface to its translational, nonencapsulating mode, use the no form of this command.

fddi encapsulate

no fddi encapsulate

Syntax Description This command has no arguments or keywords.

Defaults By default, the FDDI interface uses the SNAP encapsulation format defined in RFC 1042, Standard for
the Transmission of IP Datagrams Over IEEE 802 Networks. It is not necessary to define an
encapsulation method for this interface when using the CSC-FCI interface card.

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines The no fddi encapsulate command applies only to CSC-C2/FCIT interfaces, because the CSC-FCI
interfaces are always in encapsulating bridge mode. The CSC-C2/FCIT interface card fully supports
transparent and translational bridging for the following configurations:
• FDDI to FDDI
• FDDI to Ethernet
• FDDI to Token Ring
The fddi encapsulate command puts the CSC-C2/FCIT interface into encapsulation mode when doing
bridging. In transparent mode, the FCIT interface interoperates with earlier versions of the CSC-FCI
encapsulating interfaces when performing bridging functions on the same ring.

Caution Bridging between dissimilar media presents several problems that can prevent communications
from occurring. These problems include bit-order translation (or usage of MAC addresses as data),
maximum transfer unit (MTU) differences, frame status differences, and multicast address usage.
Some or all of these problems might be present in a multimedia bridged LAN and might prevent
communication from taking place. These problems are most prevalent when bridging between
Token Rings and Ethernets or between Token Rings and FDDI nets. This is because of the different
way Token Ring is implemented by the end nodes.

Cisco IOS Interface and Hardware Component Command Reference

IR-178
 Interface and Hardware Component Commands
fddi encapsulate

The following protocols have problems when bridged between Token Ring and other media: Novell IPX,
DECnet Phase IV, AppleTalk, VINES, XNS, and IP. Furthermore, the following protocols may have
problems when bridged between FDDI and other media: Novell IPX and XNS. We recommend that these
protocols be routed whenever possible.

Examples The following example sets FDDI interface 1 on the CSC-C2/FCIT interface card to encapsulating
bridge mode:
Router(config)# interface fddi 1
Router(config-if)# fddi encapsulate

Cisco IOS Interface and Hardware Component Command Reference

IR-179
 Interface and Hardware Component Commands
fddi frames-per-token

fddi frames-per-token
To specify the maximum number of frames that the FDDI interface transmits per token capture, use the
fddi frames-per-token command in interface configuration mode. To revert to the default value, use the
no form of this command.

fddi frames-per-token number

no fddi frames-per-token

Syntax Description number Maximum number of frames to transmit per token capture. Valid values
are from 1 to 10. The default is 3.

Defaults 3 frames

Command Modes Interface configuration

Command History Release Modification

11.2 P This command was introduced.

Usage Guidelines Changing the value will increase or decrease the maximum number of frames that the FDDI interface
can transmit when it receives a token. Increasing the value does not necessarily mean more frames will
be transmitted on each token capture. This is heavily dependent on the traffic load of the specific
interface.
When the interface captures a token, it transmits all of the frames that are queued in the interface’s
transmit ring, up to a maximum value specified by the fddi frames-per-token command.
If there are no frames ready for transmission, the token is passed on, and no frames are transmitted. If
there are less than the fddi frames-per-token value in the transmit ring, all frames in the transmit ring
are transmitted before the token is passed on. If there are more than the fddi frames-per-token value in
the transmit ring, the specified value is transmitted before the token is passed on. The remaining frames
in the transmit ring remain queued until the token is captured again.

Examples The following example shows how to configure the FDDI interface to transmit four frames per token
capture:
Router(config-if)# fddi frames-per-token 4

Cisco IOS Interface and Hardware Component Command Reference

IR-180
 Interface and Hardware Component Commands
fddi smt-frames

fddi smt-frames
To enable the Station Management (SMT) frame processing capability on the FDDI, use the fddi
smt-frames command in interface configuration mode. To disable this function and prevent the
Cisco IOS software from generating or responding to SMT frames, use the no form of this command.

fddi smt-frames

no fddi smt-frames

Syntax Description This command has no arguments or keywords.

Defaults Enabled

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines Use the no form of this command to turn off SMT frame processing for diagnosing purposes. Use the
fddi smt-frames command to reenable the feature.

Examples The following example disables SMT frame processing:

Router(config)# interface fddi 0
Router(config-if)# no fddi smt-frames

Cisco IOS Interface and Hardware Component Command Reference

IR-181
 Interface and Hardware Component Commands
fddi tb-min

fddi tb-min
To set the TB-Min timer in the physical connection management (PCM), use the fddi tb-min command
in interface configuration mode. To revert to the default value, use the no form of this command.

fddi tb-min milliseconds

no fddi tb-min

Syntax Description milliseconds Number, in milliseconds, that sets the TB-Min timer value. The range is from 0 to
65535. The default is 100.

Defaults milliseconds: 100

Command Modes Interface configuration

Command History Release Modification

10.3 This command was introduced.

Usage Guidelines This command applies to the processor connection management (CMT) only. Use this command when
you run into PCM interoperability problems.

Note You need extensive knowledge of the PCM state machine to tune this timer.

Examples The following example shows how to set the TB-Min timer to 200 ms:
Router(config)# interface fddi 0
Router(config-if)# fddi tb-min 200

Related Commands Command Description

fddi c-min Sets the C-Min timer on the PCM.
fddi tl-min-time Controls the TL-Min time (the minimum time to transmit a PHY line state
before advancing to the PCM state, as defined by the X3T9.5 specification).
fddi t-out Sets the t-out timer in the PCM.

Cisco IOS Interface and Hardware Component Command Reference

IR-182
 Interface and Hardware Component Commands
fddi tl-min-time

fddi tl-min-time
To control the TL-Min time (the minimum time to transmit a Physical Sublayer, or PHY line state, before
advancing to the next physical connection management [PCM] state, as defined by the X3T9.5
specification), use the fddi tl-min-time command in interface configuration mode.

fddi tl-min-time microseconds

Syntax Description microseconds Number, in microseconds, that specifies the time used during the connection
management (CMT) phase to ensure that signals are maintained for at least the
value of TL-Min so that the remote station can acquire the signal. The range is
from 0 to 4294967295. The default is 30.

Defaults microseconds: 30

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines Interoperability tests have shown that some implementations of the FDDI standard need more than
30 microseconds to sense a signal.
This command does not have a no form.

Examples The following example changes the TL-Min time from 30 microseconds to 100 microseconds:
Router(config)# interface fddi 0
Router(config-if)# fddi tl-min-time 100

The following example changes the TL-Min time from 30 microseconds to 100 microseconds on a
Cisco 7500 series router:
Router(config)# interface fddi 3/0
Router(config-if)# fddi tl-min-time 100

Related Commands Command Description

fddi c-min Sets the C-Min timer on the PCM.
fddi t-out Sets the t-out timer in the PCM.

Cisco IOS Interface and Hardware Component Command Reference

IR-183
 Interface and Hardware Component Commands
fddi token-rotation-time

fddi token-rotation-time
To control ring scheduling during normal operation and to detect and recover from serious ring error
situations, use the fddi token-rotation-time command in interface configuration mode. To revert to the
default value, use the no form of this command.

fddi token-rotation-time microseconds

no fddi token-rotation-time

Syntax Description microseconds Number, in microseconds, that specifies the token rotation time (TRT). The
range is from 4000 to 165000. The default is 5000.

Defaults microseconds: 5000

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines The FDDI standard restricts the allowed time to be greater than 4000 microseconds and less than
165,000 microseconds. As defined in the X3T9.5 specification, the value remaining in the TRT is loaded
into the token holding timer (THT). Combining the values of these two timers provides the means to
determine the amount of bandwidth available for subsequent transmissions.

Examples The following example sets the rotation time to 24,000 microseconds:
Router(config)# interface fddi 0
Router(config-if)# fddi token-rotation-time 24000

The following example sets the rotation time to 24,000 microseconds on a Cisco 7500 series router:
Router(config)# interface fddi 3/0
Router(config-if)# fddi token-rotation-time 24000

Cisco IOS Interface and Hardware Component Command Reference

IR-184
 Interface and Hardware Component Commands
fddi t-out

fddi t-out
To set the timeout timer in the physical connection management (PCM), use the fddi t-out command in
interface configuration mode. To revert to the default value, use the no form of this command.

fddi t-out milliseconds

no fddi t-out

Syntax Description milliseconds Number, in milliseconds, that sets the timeout timer. The range is from 0 to 65535.
The default is 100.

Defaults milliseconds: 100

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines This command applies to the processor connection management (CMT) only. Use this command when
you run into PCM interoperability problems.

Note You need extensive knowledge of the PCM state machine to tune this timer.

Examples The following example sets the timeout timer to 200 ms:
Router(config)# interface fddi 0
Router(config-if)# fddi t-out 200

Related Commands Command Description

fddi c-min Sets the C-Min timer on the PCM.
fddi tb-min Sets the TB-Min timer in the PCM.
fddi tl-min-time Controls the TL-Min time (the minimum time to transmit a PHY line state
before advancing to the PCM state, as defined by the X3T9.5 specification).

Cisco IOS Interface and Hardware Component Command Reference

IR-185
 Interface and Hardware Component Commands
fddi valid-transmission-time

fddi valid-transmission-time
To change the transmission valid timer (TVX) interval, use the fddi valid-transmission-time command
in interface configuration mode. To revert to the default value, use the no form of this command.

fddi valid-transmission-time microseconds

no fddi valid-transmission-time

Syntax Description microseconds Number, in microseconds, that specifies the TVX interval. The range is from 2500
to 2147483647. The default is 2500.

Defaults microseconds: 2500

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines Use this command to recover from a transient FDDI ring error by setting a longer transmission timer
interval.

Examples The following example shows how to change the transmission timer interval to 3000 microseconds:
Router(config)# interface fddi 0
Router(config-if)# fddi valid-transmission-time 3000

The following example shows how to change the transmission timer interval to 3000 microseconds on
Cisco 7000 series routers or Cisco 7200 series routers:
Router(config)# interface fddi 3/0
Router(config-if)# fddi valid-transmission-time 3000

Cisco IOS Interface and Hardware Component Command Reference

IR-186
 Interface and Hardware Component Commands
fdl

fdl
To set the Facility Data Link (FDL) exchange standard for CSU controllers or to set the FDL exchange
standard for a T1 interface that uses the Extended Super Frame (ESF) framing format, use the fdl
command in ATM interface configuration mode. To disable FDL support or to specify that there is no
ESF FDL, use the no form of this command.

fdl {att | ansi | all | none}

no fdl {att | ansi | all | none}

Syntax Description att Selects AT&T technical reference 54016 for ESF FDL exchange support.
ansi Selects ANSI T1.403 for ESF FDL exchange support.
all Specifies support for both AT&T technical reference 54016 and ANSI T1.403 for
ESF FDL exchange support.
none Specifies that there is no support for ESF FDL exchange.

Defaults ansi

Command Modes ATM interface configuration

Command History Release Modification

11.3 This command was introduced.
12.0(5)T and The command was introduced as an ATM interface configuration command for
12.0(5)XK the Cisco 2600 and Cisco 3600 series. The none keyword was added, and the
both keyword was changed to all.

Usage Guidelines This command is available for T1 links only and sets the standard that will be followed for FDL
messaging through a 4-Kbps out-of-band channel that a service provider uses to check for errors on the
facility. You must use the same FDL exchange standard as your service provider. If the setting is not
correct, the link may fail to come up. You can have a different standard configured on each T1 interface.

Note When using a multiport T1 ATM IMA network module on a Cisco 2600 or Cisco 3600 series
router, ESF framing and binary eight zero substitution (B8ZS) line encoding are supported. When
using a multiport E1 ATM IMA network module on a Cisco 2600 or Cisco 3600 series router,
CRC4 multiframe framing and HDB3 line encoding are supported. These are the parameters
specified by the ATM Forum, and they cannot be changed.

Examples The following example shows how to specify both ANSI and AT&T standards for FDL exchange on a
Cisco 2600 or Cisco 3600 series router:

Cisco IOS Interface and Hardware Component Command Reference

IR-187
 Interface and Hardware Component Commands
fdl

Router(config)# interface atm 0/2

Router(config-if)# fdl all

Cisco IOS Interface and Hardware Component Command Reference

IR-188
 Interface and Hardware Component Commands
framing

framing
To select the frame type for the T1 or E1 data line, use the framing command in controller
configuration mode.

T1 Lines

framing {sfadm | esfadm}

E1 Lines

framing {crc4adm | pcm30adm | clear e1}

Syntax Description sfadm Specifies super frame for the T1 channel.

esfadm Specifies extended super frame for the T1 channel.
crc4adm Specifies CRC4 framing mode for the E1 channel.
pcm30adm Specifies CRC4 disabled framing mode for the E1 channel.
clear e1 Specifies clear-e1 framing mode for the E1 channel.

Defaults Extended super frame for a T1 line

CRC4 disabled framing for an E1 line

Command Modes Controller configuration

Command History Release Modification

11.3 This command was introduced.
12.0(5)XE The command was enhanced as an ATM interface configuration command.
12.0(7)XE1 This command was implemented on the Cisco 7100 series routers.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.

Usage Guidelines Use this command in configurations in which the router or access server is intended to communicate with
T1 or E1 fractional data lines. The service provided determines which framing type is required for your
T1 or E1 circuit.
This command does not have a no form.

Examples The following example selects extended super frame as the T1 frame type:
Router(config)# controller t1 4/0
Router(config-controller)# framing esfadm

Cisco IOS Interface and Hardware Component Command Reference

IR-189
 Interface and Hardware Component Commands
framing

Related Commands Command Description

lbo Specifies the distance of the cable from the routers to the network
equipment.
linecode Selects the line code type for a T1 or E1 line.

Cisco IOS Interface and Hardware Component Command Reference

IR-190
 Interface and Hardware Component Commands
framing (CEM)

framing (CEM)
To specify the framing format of a circuit emulation (CEM) T1 or E1 port, use the framing command
in controller configuration mode. To reset the framing format of the port to its default value, use the no
form of this command.

T1 Port

framing {sf | esf | unframed}

no framing

E1 Port

framing {crc4 | no-crc4 | unframed}

no framing

Syntax Description sf Specifies that the T1 port framing format is set to super frame (SF) format,
also commonly known as D4 framing format.
esf Specifies that the T1 port framing format is set to extended super frame
(ESF) format.
crc4 Specifies that the E1 port framing format is set to the G.704 standard with
the optional CRC4 mechanism defined in time slot 0 enabled.
no-crc4 Specifies that the E1 port framing format is set to the G.704 standard with
the optional CRC4 mechanism defined in time slot 0 disabled.
unframed Specifies that no framing structure is sought (on the ingress data stream) or
imposed (on the egress data stream) on the T1 or E1 port.

Defaults T1 lines default to esf.

E1 lines default to crc4.
The unframed option is automatically selected if an unframed CEM channel is created on the port using
the cem-group command.

Command Modes Controller configuration

Command History Release Modification

12.3(7)T This command was introduced to support circuit emulation.

Usage Guidelines Framing must be configured to match the framing format used by the attached equipment.
In order to change a line between unframed and any framed mode, you must first delete the CEM
channels defined in the line.

Cisco IOS Interface and Hardware Component Command Reference

IR-191
 Interface and Hardware Component Commands
framing (CEM)

Examples The following example shows how to set the framing format of a CEM T1 port to be super frame format.
Router(config-controller)# framing sf

The following example shows how to set the framing format of a CEM E1 port to the G.704 standard
with the optional CRC4 mechanism defined in time slot 0 disabled.
Router(config-controller)# framing no-crc4

Related Commands Command Description

cem-group Creates CEM channels on T1 or E1 ports.

Cisco IOS Interface and Hardware Component Command Reference

IR-192
 Interface and Hardware Component Commands
framing (E3 controller)

framing (E3 controller)

To specify the type of framing used by the E3 controller, use the framing command in controller
configuration mode. To restore the default framing type, use the no form of this command.

framing {bypass | g751}

no framing

Syntax Description bypass Specifies that G.751 framing be bypassed.

g751 Specifies G.751 as the E3 framing type. This is the default.

Defaults G.751 framing

Command Modes Controller configuration

Command History Release Modification

11.1 CA This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and
implemented on the following platforms for E3: Cisco 2650XM,
Cisco 2651XM, Cisco 2691, Cisco 3660 series, Cisco 3725, and
Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.

Usage Guidelines If you do not specify the framing command, the default, g751, is used by the E3 controller to
automatically determine the framing type received from the far-end equipment.
Configure framing as G.751 when the E3 connection terminates remotely on a Digital Link or Kentrox
data service unit (DSU), or when needing a subrate on an E3 connection between two T3 or E3 network
modules.

Note The local interface configuration must match the remote interface, or DSU, configuration.

When G.751 framing is used, DSU bandwidth can be used to select a payload subrate from 34,010 kbps
down to 22 kbps.
When framing bypass is used, DSU bandwidth of 34,010 kbps must be configured.
When G.751 framing is used, configuring the scramble command can prevent some payload data from
being mistakenly interpreted as G.751 framing bits by switches placed between the DSUs. By default,
the no scramble command is configured.
When framing bypass is used, the no scramble command must be configured.
When G.751 framing is used, bit 11 of the G.751 frame is reserved for national use and is set to 1 by
default.

Cisco IOS Interface and Hardware Component Command Reference

IR-193
 Interface and Hardware Component Commands
framing (E3 controller)

Configure national bit 1 only when required for interoperability with your telephone company.

Examples The following example shows the framing for the E3 controller set to bypass:
Router(config)# controller e3 1/0
Router(config-controller)# framing bypass

Related Commands Command Description

scramble Specifies the type of framing used by the T1 channels on the CT3IP in
Cisco 7500 series routers.

Cisco IOS Interface and Hardware Component Command Reference

IR-194
 Interface and Hardware Component Commands
framing (SONET)

framing (SONET)
To select the frame type of the frame received on an optical line, use the framing command in controller
configuration mode.

framing {sonet | sdh}

Syntax Description sonet Specifies the framing type as SONET.

sdh Specifies the framing type as SDH.

Defaults SONET is the default for the PA-MC-STM-1 port adapter.

SDH is the default for the STM-1 trunk card.

Command Modes Controller configuration

Command History Release Modification

12.0(14)S This command was introduced.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T and support
was added for the STM-1 trunk card on the Cisco AS5850 platform.

Usage Guidelines Use this command to configure the framing type of the SONET controller. The PA-MC-STM-1port
adapter supports both the SONET and SDH framing modes. The STM-1 trunk feature card on the
Cisco AS5850 only supports SDH framing.
This command does not have a no form.

Examples The following example shows how to configure the framing type on a SONET controller of an STM-1
card in physical slot number 2 on a Cisco AS5850:
Router(config)# controller sonet 2/0
Router(config-controller)# framing sdh

Related Commands Command Description

show controllers sonet Displays information about SONET controllers.

Cisco IOS Interface and Hardware Component Command Reference

IR-195
 Interface and Hardware Component Commands
framing (T1/E1 controller)

framing (T1/E1 controller)

To select the frame type for the T1 or E1 data line, use the framing command in controller configuration
mode.

T1 Lines

framing {sf | esf}

E1 Lines

framing {crc4 | no-crc4} [australia]

Syntax Description sf Specifies super frame as the T1 frame type. This is the default.
esf Specifies extended super frame as the T1 frame type.
crc4 Specifies CRC4 frame as the E1 frame type. This is the default for Australia.
no-crc4 Specifies no CRC4 frame as the E1 frame type.
australia (Optional) Specifies the E1 frame type used in Australia.

Defaults Super frame is the default on a T1 line.

CRC4 frame is the default on an E1 line.

Command Modes Controller configuration

Usage Guidelines Use this command in configurations in which the router or access server is intended to communicate with
T1 or E1 fractional data lines. The service provider determines the framing type required for your T1/E1
circuit.
This command does not have a no form.

Examples The following example selects extended super frame as the T1 frame type:
Router(config-controller)# framing esf

Related Commands Command Description

cablelength Specifies the distance of the cable from the routers to the network
equipment.
linecode Selects the linecode type for T1 or E1 line.

Cisco IOS Interface and Hardware Component Command Reference

IR-196
 Interface and Hardware Component Commands
framing (T3 controller)

framing (T3 controller)

To specify the type of framing used by the T3 controller or by the CT3IP port adapter in Cisco 7500
series routers, use the framing command in controller configuration mode. To restore the default
framing type, use the no form of this command.

T3 Controllers

framing {c-bit | m23}

no framing

Cisco 7500 Series Routers with CT3IP Port Adapter

framing {c-bit | m23 | auto-detect}

no framing

Syntax Description c-bit Specifies that C-bit framing is used as the T3 framing type. This is the
default for most T3 controllers.
m23 Specifies that M23 framing is used as the T3 framing type.
auto-detect Specifies that the CT3IP detects the framing type that it receives from the
far-end equipment. This is the default for the CT3IP in a Cisco 7500
series router.

Defaults c-bit for most T3 controllers

auto-detect for the CT3IP in a Cisco 7500 series router

Command Modes Controller configuration

Command History Release Modification

11.1 CA This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and
implemented on the following platforms for T3: Cisco 2650XM,
Cisco 2651XM, Cisco 2691, Cisco 3660 series, Cisco 3725, and Cisco 3745
routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.

Usage Guidelines If you do not specify the framing command, the default c-bit is used by most T3 controllers to
automatically determine the framing type received from the far-end equipment. If you do not specify the
framing command on the CT3IP, the default auto-detect is used to automatically determine the framing
type received from the far-end equipment.

Cisco IOS Interface and Hardware Component Command Reference

IR-197
 Interface and Hardware Component Commands
framing (T3 controller)

Because the CT3IP supports the Application Identification Channel (AIC) signal, the setting for the
framing might be overridden by the CT3IP firmware.
You can also set the framing for each T1 channel by using the t1 framing controller configuration
command.

Examples The following example sets the framing for the CT3IP to C-bit:
Router(config)# controller t3 9/0/0
Router(config-controller)# framing c-bit

Related Commands Command Description

t1 framing Specifies the type of framing used by the T1 channels on the CT3IP in
Cisco 7500 series routers.

Cisco IOS Interface and Hardware Component Command Reference

IR-198
 Interface and Hardware Component Commands
framing (T3/E3 interface)

framing (T3/E3 interface)

To specify T3 or E3 line framing for a PA-T3 or PA-E3 port adapter, use the framing command in
interface configuration mode. To return to the default C-bit framing or G.751 framing, use the no form
of this command.

PA-T3

framing {c-bit | m13 | bypass}

no framing

PA-E3

framing {bypass | g751}

no framing

Syntax Description c-bit Specifies that C-bit framing is used as the T3 framing type. This is the default
for the PA-T3.
m13 Specifies m13 T3 framing.
bypass Specifies bypass E3 framing.
g751 Specifies G.751 E3 framing. This is the default for the PA-E3.

Defaults C-bit framing for PA-T3

G.751 framing for PA-E3

Command Modes Interface configuration

Command History Release Modification

11.1 CA This command was introduced.

Usage Guidelines The default framing is described in the ITU-T Recommendation G.751.

Note The International Telecommunication Union Telecommunication Standardization Sector (ITU-T) carries
out the functions of the former Consultative Committee for International Telegraph and Telephone
(CCITT).

When the framing mode is bypass, the T3 frame data is not included in the T3 frame, just the data.
When the framing mode is bypass, the E3 frame data is not included in the E3 frame, just the data.
If you use the bypass keyword, scrambling must be set to the default (disabled), the DSU mode must be
set to the default (0), and the DSU bandwidth must be set to the default (44736).

Cisco IOS Interface and Hardware Component Command Reference

IR-199
 Interface and Hardware Component Commands
framing (T3/E3 interface)

To verify the framing mode configured on the interface, use the show controllers serial command in
EXEC mode.

Examples The following example sets the framing mode to bypass on interface 1/0/0:
Router(config)# interface serial 1/0/0
Router(config-if)# framing bypass

Related Commands Command Description

show controllers serial Displays information that is specific to the interface hardware.

Cisco IOS Interface and Hardware Component Command Reference

IR-200
 Interface and Hardware Component Commands
full-duplex

full-duplex
To specify full-duplex mode on full-duplex single-mode and multimode port adapters, use the
full-duplex command in interface configuration mode. To restore the default half-duplex mode, use the
no form of this command.

full-duplex

no full-duplex

Syntax Description This command has no arguments or keywords.

Defaults Half-duplex mode is the default mode on a Cisco 7500 series router, a Fast Ethernet Interface Processor
(FEIP), and serial interfaces that are configured for bisynchronous tunneling.

Command Modes Interface configuration

Command History Release Modification

11.1 This command was introduced.
11.3 This command was modified to include information on FDDI full-duplex,
single-mode, and multimode port adapters.

Usage Guidelines Use this command if the equipment on the other end is capable of full-duplex mode.
This command specifies full-duplex mode on full-duplex single-mode and multimode port adapters
available on the following networking devices:
• Cisco 7200 series routers
• Second-generation Versatile Interface Processors (VIP2s) in Cisco 7500 series routers
• FEIP port
• Serial interface port that uses bisynchronous tunneling
Refer to the Cisco Product Catalog for hardware compatibility information and for specific model
numbers of port adapters.
To enable half-duplex mode, use the no full-duplex or half-duplex commands.

Note For the Cisco AS5300, the duplex {full | half | auto} command replaces the full-duplex and
half-duplex commands. You will get the following error messages if you try to use the full-duplex
and half-duplex commands on a Cisco AS5300:

Router(config)# interface fastethernet 0

Router(config-if)# full-duplex
Please use duplex command to configure duplex mode

Cisco IOS Interface and Hardware Component Command Reference

IR-201
 Interface and Hardware Component Commands
full-duplex

Router(config-if)#
Router(config-if)# half-duplex
Please use duplex command to configure duplex mode

Support for This Command

Use the question mark (?) command to find out which port adapters support this command. If the
interface does not support full-duplex, an informational message similar to the one shown below is
displayed, and no changes are made to the interface. To determine if the interface supports full-duplex,
use the show interfaces command. For example, the following message is displayed if the interface does
not support full-duplex:
% interface does not support full-duplex.

Use on FDDI
Full-duplex on the FDDI full-duplex port adapters allows an FDDI ring with exactly two stations to
transform the ring into a full-duplex, point-to-point topology. To operate in full-duplex mode, there must
be only two stations on the ring, the two stations must be capable of operating in full-duplex mode, and
both stations must complete a full-duplex autoconfiguration protocol. There is no FDDI token in
full-duplex mode. Refer to the Cisco Product Catalog for specific model numbers of port adapters.
Full-duplex autoconfiguration protocol allows an FDDI station to dynamically and automatically operate
in either half-duplex (or ring) or full-duplex mode, and ensures that the stations fall back to ring mode
when a configuration change occurs, such as a third station joining the ring.
After booting up, the FDDI stations begin operation in half-duplex mode. While the station performs the
full-duplex autoconfiguration protocol, the station continues to provide data-link services to its users.
Under normal conditions, the transition between half-duplex mode and full-duplex mode is transparent
to the data-link users. The data-link services provided by full-duplex mode are functionally the same as
the services provided by half-duplex mode.
If you change the full-duplex configuration (for example from disabled to enabled) on supported
interfaces, the interface resets.

Examples The following example configures full-duplex mode on the Cisco 7200 series routers:
Router(config)# interface fastethernet 0/1
Router(config-if)# full-duplex

The following example specifies full-duplex binary synchronous communications (Bisync) mode:
Router(config)# interface serial 0
Router(config-if)# encapsulation bstun
Router(config-if)# full-duplex

The following example enables full-duplex mode on FDDI interface 0:

Router(config)# interface fddi 0/1/0
Router(config-if)# full-duplex

Related Commands Command Description

half-duplex Specifies half-duplex mode on an SDLC interface or on the FDDI
full-duplex, single-mode port adapter and FDDI full-duplex, multimode port
adapter on the Cisco 7200 series and Cisco 7500 series routers.
interface Configures an interface type and enters interface configuration mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-202
Interface and Hardware Component Commands
full-duplex

Command Description
interface fastethernet Selects a particular Fast Ethernet interface for configuration.
interface serial Specifies a serial interface created on a channelized E1 or channelized T1
controller (for ISDN PRI, CAS, or robbed-bit signaling).
show interfaces Displays statistics for all interfaces configured on the router or access server.
show interfaces fddi Displays information about the FDDI interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-203
 Interface and Hardware Component Commands
half-duplex

half-duplex
To specify half-duplex mode on an Synchronous Data Link Control (SDLC) interface or on the FDDI
full-duplex, single-mode port adapter and FDDI full-duplex, multimode port adapter on the Cisco 7200
series and Cisco 7500 series routers, use the half-duplex command in interface configuration mode. To
reset the interface to full-duplex mode, use the no form of this command.

half-duplex

no half-duplex

Syntax Description This command has no arguments or keywords.

Defaults Full-duplex mode is the default mode on an SDLC interface, the FDDI full-duplex, single-mode port
adapter and FDDI full-duplex, multimode port adapter on the Cisco 7200 series and Cisco 7500 series
routers.

Command Modes Interface configuration

Command History Release Modification

11.1 This command was introduced.
11.3 This command was modified to include information on FDDI full-duplex,
single-mode, and multimode port adapters.

Usage Guidelines SDLC Interfaces

The half-duplex command is used to configure an SDLC interface for half-duplex mode and is used on
a variety of port adapters. Use the question mark (?) command to find out which port adapters support
this command.

Note The half-duplex command replaces the sdlc hdx and media-type half-duplex commands.

Note For the Cisco AS5300, the duplex {full | half | auto} command replaces the full-duplex and
half-duplex commands. You will get the following error messages if you try to use the full-duplex
and half-duplex commands on a Cisco AS5300:

Router(config)# interface fastethernet 0

Router(config-if)# full-duplex
Please use duplex command to configure duplex mode
Router(config-if)#
Router(config-if)# half-duplex
Please use duplex command to configure duplex mode

Cisco IOS Interface and Hardware Component Command Reference

IR-204
 Interface and Hardware Component Commands
half-duplex

Enabling Full-Duplex Mode

To enable full-duplex mode, use the no half-duplex or full-duplex commands.

Note The media-type half-duplex command exists in Cisco IOS Release 11.0(5). As of Release 11.0(6),
the keyword half-duplex was removed from the media-type command. In Release 11.0(6), the
functionality for specifying half-duplex mode is provided by the half-duplex command.

Port Adapters
Refer to the Cisco Product Catalog for specific model numbers of port adapters.

Examples The following example configures an SDLC interface for half-duplex mode:
Router(config-if)# encapsulation sdlc-primary
Router(config-if)# half-duplex

Related Commands Command Description

full-duplex Specifies full-duplex mode on full-duplex single-mode and multimode port
adapters.

Cisco IOS Interface and Hardware Component Command Reference

IR-205
 Interface and Hardware Component Commands
half-duplex controlled-carrier

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 command in interface configuration mode. To return the interface
to constant-carrier mode, use the no form of this command.

half-duplex controlled-carrier

no half-duplex controlled-carrier

Syntax Description This command has no arguments or keywords.

Defaults Constant-carrier mode, where Data Carrier Detect (DCD) is held constant and asserted by the DCE
half-duplex interface.

Command Modes Interface configuration

Command History Release Modification

11.2 This command was introduced.

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 half-duplex command. Refer to the Cisco Product Catalog
for specific model numbers of networking devices which support serial interfaces.
Controlled-carrier operation means that the DCE interface has DCD deasserted in the quiescent state.
When the interface has something to transmit, it asserts DCD, waits a user-configured amount of time,
then starts the transmission. When the interface has finished transmitting, it waits a user-configured
amount of time and then deasserts DCD.

Examples The following examples place the interface in controlled-carrier mode and then back into
constant-carrier operation.
This example shows changing to controlled-carrier mode from the default of constant-carrier operation:
Router(config)# interface serial 2
Router(config-if)# half-duplex controlled-carrier

This example shows changing to constant-carrier operation from controlled-carrier mode:

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

Cisco IOS Interface and Hardware Component Command Reference

IR-206
 Interface and Hardware Component Commands
half-duplex controlled-carrier

Related Commands Command Description

half-duplex Specifies half-duplex mode on an SDLC interface or single-mode and
multimode port adapters.
half-duplex timer Tunes half-duplex timers.
physical-layer Specifies the mode of a slow-speed serial interface on a router as either
synchronous or asynchronous.

Cisco IOS Interface and Hardware Component Command Reference

IR-207
 Interface and Hardware Component Commands
half-duplex timer

half-duplex timer
To tune half-duplex timers, use the half-duplex timer command in interface configuration mode. To
return to the default parameter values, use the no form of this 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 from the time it
detects the Request to Send (RTS) to the time it asserts Clear to Send
(CTS) in response. The range is dependent on the serial interface
hardware. The default cts-delay value is 0 ms.
cts-drop-timeout value Determines the amount of time a DTE interface waits for CTS to be
deasserted after it has deasserted RTS. If CTS is not deasserted during
this time, an error counter is incremented to note this event. The range
is from 0 to 1,140,000 ms (1140 seconds). The default
cts-drop-timeout 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 deassertion of Data Carrier Detect (DCD). The range is
from 0 to 4400 ms (4.4 seconds). The default dcd-drop-delay 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 from 0 to 1,140,000 ms (1140 seconds). The default
dcd-txstart-delay value is 100 ms.
rts-drop-delay value Specifies the time delay between the end of transmission by the DTE
interface and deassertion of RTS. The range is from 0 to 1,140,000 ms
(1140 seconds). The default rts-drop-delay value is 3 ms.
rts-timeout value Determines the number of milliseconds 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 rts-timeout value is 3 ms.
transmit-delay value Specifies the number of milliseconds 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 from
0 to 4400 ms (4.4 seconds). The default transmit-delay value is 0 ms.

Cisco IOS Interface and Hardware Component Command Reference

IR-208
 Interface and Hardware Component Commands
half-duplex timer

Defaults 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 Modes Interface configuration

Command History Release Modification

11.3 This command was introduced.

Usage Guidelines Tuning Half-Duplex Timers

The half-duplex timer command is used to tune half-duplex timers. With these timer tuning commands
you can adjust the timing of the half-duplex state machines to suit the particular needs of their
half-duplex installation.
You can configure more than one option using this command, but each option must be specified as a
separate command.

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

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

Examples The following example set the cts-delay timer to 10 ms and the transmit-delay timer to 50 ms:
Router(config)# interface serial 2
Router(config-if)# half-duplex timer cts-delay 10
Router(config-if)# half-duplex timer transmit-delay 50

Related Commands Command Description

half-duplex controlled-carrier Places a low-speed serial interface in controlled-carrier mode,
instead of constant-carrier mode.
physical-layer Specifies the mode of a slow-speed serial interface on a router as
either synchronous or asynchronous.

Cisco IOS Interface and Hardware Component Command Reference

IR-209
 Interface and Hardware Component Commands
hold-queue

hold-queue
To limit the size of the IP output queue on an interface, use the hold-queue command in interface
configuration mode. To restore the default values, use the no form of this command.

hold-queue length {in | out}

no hold-queue {in | out}

Syntax Description length Integer that specifies the maximum number of packets in the queue. The range of
valid values is from 0 to 65535.
in Specifies the input queue. The default is 75 packets. For asynchronous interfaces,
the default is 10 packets.
out Specifies the output queue. The default is 40 packets. For asynchronous interfaces,
the default is 10 packets.

Defaults The default input hold-queue limit is 75 packets.

The default output hold-queue limit is 40 packets.
For asynchronous interfaces the default is 10 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 Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.
11.1 The no hold-queue command was added.

Usage Guidelines Back-to-Back Routing Updates

The default of 10 packets allows the Cisco IOS software to queue a number of back-to-back routing
updates. This is the default for asynchronous interfaces only; other media types have different defaults.

Hold Queues and Priority Queueing

The hold queue stores packets received from the network that are waiting to be sent to the client. It is
recommended that the queue size not exceed ten packets on asynchronous interfaces. For most other
interfaces, queue length should not exceed 100.
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.

Cisco IOS Interface and Hardware Component Command Reference

IR-210
 Interface and Hardware Component Commands
hold-queue

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 show interfaces command in EXEC mode.

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

Examples The following example shows how to set a small input queue on a slow serial line:
Router(config)# interface serial 0
Router(config-if)# hold-queue 30 in

Related Commands Command Description

priority-list Assigns a priority queue for those packets that do not match any other rule
in the priority list.
show interfaces Displays statistics for all interfaces configured on the router or access server.

Cisco IOS Interface and Hardware Component Command Reference

IR-211
 Interface and Hardware Component Commands
hssi external-loop-request

hssi external-loop-request
To allow the router to support a CSU/DSU that uses the loopback circuit (LC) signal to request a
loopback from the router, use the hssi external-loop-request command in interface configuration mode.
To disable this function, use the no form of this command.

hssi external-loop-request

no hssi external-loop-request

Syntax Description This command has no arguments or keywords.

Defaults Disabled

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines The HSA applique on the High-Speed Serial Interface (HSSI) contains an LED that indicates the
loopback circuit A (LA), loopback circuit B (LB), and LC signals that are transiting through the devices.
The CSU/DSU uses the LC signal to request a loopback from the router. The CSU/DSU may want to do
this so that its own network management diagnostics can independently check the integrity of the
connection between the CSU/DSU and the router.
Use this command to enable a two-way, internal, and external loopback request on the HSSI from the
CSU/DSU.

Caution If your CSU/DSU does not support this function, it should not be enabled on the router. Not
enabling this function prevents spurious line noise from accidentally tripping the external
loopback request line, which would interrupt the normal data flow.

Examples The following example enables a CSU/DSU to use the LC signal to request a loopback from the router:
Router(config-if)# hssi external-loop-request

Cisco IOS Interface and Hardware Component Command Reference

IR-212
 Interface and Hardware Component Commands
hssi internal-clock

hssi internal-clock
To convert the High-Speed Serial Interface (HSSI) into a clock master, use the hssi internal-clock
command in interface configuration mode. To disable the clock master mode, use the no form of this
command.

hssi internal-clock

no hssi internal-clock

Syntax Description This command has no arguments or keywords.

Defaults Disabled

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines Use this command in conjunction with the HSSI null-modem cable to connect two Cisco routers together
with HSSI. You must configure this command at both ends of the link, not just one.

Note HSSI network module provides full-duplex connectivity at SONET OC-1/STS-1 (51.840 Mhz), T3
(44.736 MHZ), and E3 (34.368 MHz) rates in conformance with the EIA/TIA-612 and EIA/TIA-613
specifications. The actual rate of the interface depends on the external data service unit (DSU) and
the type of service to which it is connected.

Examples The following example shows how to convert the HSSI interface into a clock master:
Router(config-if)# hssi internal-clock

Cisco IOS Interface and Hardware Component Command Reference

IR-213
 Interface and Hardware Component Commands
hub

hub
To enable and configure a port on an Ethernet hub of a Cisco 2505 or Cisco 2507 router, use the hub
command in global configuration mode.

hub ethernet number port [end-port]

Syntax Description ethernet Indicates that the hub is in front of an Ethernet interface.
number Hub number, starting with 0. Because there is only one hub, this number is 0.
port Port number on the hub. On the Cisco 2505 router, port numbers range from 1 to 8.
On the Cisco 2507 router, port numbers range from 1 to 16. If a second port number
follows, then this port number indicates the beginning of a port range.
end-port (Optional) Last port number of a range.

Defaults No hub ports are configured.

Command Modes Global configuration

Command History Release Modification

10.3 This command was introduced.

Usage Guidelines This command does not have a no form.

Examples The following example enables port 1 on hub 0:

Router# hub ethernet 0 1
Router(config-hub)# no shutdown

The following example enables ports 1 through 8 on hub 0:

Router# hub ethernet 0 1 8
Router(config-hub)# no shutdown

Related Commands Command Description

shutdown (hub) Shuts down a port on an Ethernet hub of a Cisco 2505 or Cisco 2507 router.

Cisco IOS Interface and Hardware Component Command Reference

IR-214
 Interface and Hardware Component Commands
hw-module main-cpu qa error-recovery

hw-module main-cpu qa error-recovery

To enable the recovery mechanism for a QA error condition on a Cisco 7500 series router, use the
hw-module main-cpu qa error-recovery command in global configuration mode. To disable the
recovery mechanism for a QA error condition, use the no form of this command.

hw-module main-cpu qa error-recovery

no hw-module main-cpu qa error-recovery

Syntax Description This command has no arguments or keywords.

Defaults In Cisco IOS Release 12.0(24)S1, the recovery mechanism for a QA error condition is disabled; in all
other releases, it is enabled.

Command Modes Global configuration

Command History Release Modification

12.1(19)E This command was introduced.
12.0(24)S1 This command was integrated into Cisco IOS Release 12.0(24)S1.
12.2(15)T5 This command was integrated into Cisco IOS Release 12.2(15)T5.
12.2(18)S This command was integrated into Cisco IOS Release 12.2(18)S.
12.0(26)S This command was integrated into Cisco IOS Release 12.0(26)S.
12.3(6) This command was integrated into Cisco IOS Release 12.3(6).

Usage Guidelines QA errors are sometimes seen in heavy traffic situations and may indicate a hardware failure or a
software bug. In the case of a hardware failure, a Versatile Interface Processor (VIP) or a Route Switch
Processor (RSP) must be replaced. It is possible, however, to recover from a QA error and not see another
error for months. When the same buffer header is present in two different queues, the QA ASIC goes
into an error condition and triggers a QA error interrupt. The QA error interrupt causes the RSP to dump
the QA diagnostics and perform a cbus complex during which all the line cards are reloaded. Although
the duplicate buffer header condition does not always indicate a hardware failure, the downtime of up to
300 seconds creates a real problem in the network.
The hw-module main-cpu qa error-recovery command has been created to enable a recovery
mechanism for a QA error by allowing the router to remove the duplicate buffer header from the queue
that shows the problem and requeue the buffer header. By using the QA error recovery, the downtime is
reduced to less than one second under lab conditions. Three QA errors caused by buffer headers are
permitted before the router performs a cbus complex and reloads all the line cards.
After three QA errors caused by duplicate queued buffer headers occur, the cbus complex is initiated and
the line cards reload. Other QA errors, such as a null buffer header on any queue, can occur. Recovery
is not possible in these cases, and the QA error triggers a cbus complex and subsequent line-card reloads.
The QA error condition is specific to the Cisco 7500 series routers.

Cisco IOS Interface and Hardware Component Command Reference

IR-215
 Interface and Hardware Component Commands
hw-module main-cpu qa error-recovery

Examples The following example shows how to enable the QA error recovery mechanism when a Cisco IOS
Release 12.0(24)S1 image is used on a Cisco 7500 series router. In all other supported releases, the QA
error recovery mechanism is enabled by default.
Router(config)# hw-module main-cpu qa error-recovery

Related Commands Command Description

show controllers cbus Displays information about the cBus controller card.

Cisco IOS Interface and Hardware Component Command Reference

IR-216
 Interface and Hardware Component Commands
hw-module sec-cpu reset

hw-module sec-cpu reset

To reset and reload the standby Route Switch Processor (RSP) with the specified Cisco IOS image and
to execute the image, use the hw-module sec-cpu reset command in privileged EXEC mode.

hw-module sec-cpu reset

Syntax Description This command has no arguments or keywords.

Command Modes Privileged EXEC

Command History Release Modification

12.0(16)ST This command was introduced.
12.0(19)ST1 This command was enabled in privileged EXEC mode.
12.0(22)S This command was integrated into Cisco IOS Release 12.0(22)S.
12.2(14)S This command was integrated into Cisco IOS Release 12.2(14)S.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T.

Usage Guidelines Before using this command, you must use the hw-module slot image global configuration command to
specify a high availability Cisco IOS image to run on the standby RSP. After the high availability image
is loaded in the active RSP, use the hw-module sec-cpu reset command to reset and reload the standby
RSP with the specified Cisco IOS image and to execute the image. To load the standby RSP with the
default micro-IOS software contained in the active RSP image instead of a high availability Cisco IOS
image, use the no form of the hw-module slot image command followed by the hw-module sec-cpu
reset command.

Examples The following example shows a Cisco 7513 router with the standby RSP loaded in slot 7. The standby
RSP is reset and reloaded with the rsp-pv-mz high availability Cisco IOS image. Both RSPs have slot 0
flash memory cards.
Router(config)# hw-module slot 7 image slot0:rsp-pv-mz
Router(config)# end
Router# hw-module sec-cpu reset

Related Commands Command Description

hw-module slot image Specifies a high availability Cisco IOS image to run on an active or
standby RSP.

Cisco IOS Interface and Hardware Component Command Reference

IR-217
 Interface and Hardware Component Commands
hw-module slot

hw-module slot
To enable the router shelf to restart a stopped Dial Shelf Controller (DSC) card, to stop a DSC card, or
to cause a shutdown, reset, or reload of any specified dial shelf feature board, use the hw-module slot
command in privileged EXEC mode.

hw-module slot shelf-id/slot-number {reload | reset | shutdown | start | stop}

Syntax Description shelf-id Number of the dial shelf. The default number for the dial shelf is 1.
/slot-number Number of the slot in the shelf where the target feature board or DSC is
installed. If the start or stop keyword is used, the slot number must be either
12 or 13, because these keywords apply only to DSCs.
reload Enables a remote reload of an individual feature board without having to use
manual online insertion and removal (OIR).
reset Resets a feature board.
shutdown Shuts down a feature board.
start Restarts the specified DSC.
stop Stops the specified DSC.

Command Modes Privileged EXEC

Command History Release Modification

11.3(6)AA The hw-module command was introduced.
12.1 • The hw-module command was expanded to become the hw-module slot
command.
• The reload keyword was added to enable a remote reload of a feature board.
12.3(2)T The reset and shutdown keywords were added.

Usage Guidelines The stop form of this command is issued from the router shelf console instead of by pressing the
attention (ATTN) button on the target DSC. Confirmation of when the start or stop took place is
displayed. Warnings are issued and confirmation input is required if a stop command will result in a loss
of service when backup functionality is not available.
When a DSC card is stopped, removed, and then reinstalled, there is no need to restart the card (whether
the card is the original or a replacement) because a freshly installed card reboots as the backup DSC
automatically. However, if a DSC is stopped, either by using the ATTN button or by issuing the
hw-module slot stop command, it must be restarted by using the start form of the same command, or
the DSC must be removed and reinstalled in order to reboot.
Press the ATTN button on the DSCs to shut down a card manually before removing the card. This is
equivalent to issuing a hw-module slot command for that card at the router command prompt. Use the
ATTN button to shut down the card before it is swapped out or tested in place, or to restart it, if the card
has not been removed after having been shut down.

Cisco IOS Interface and Hardware Component Command Reference

IR-218
 Interface and Hardware Component Commands
hw-module slot

Tip The hw-module slot shelf-id/slot-number reload form of this command is useful for simulating an
OIR event in the case of a feature board failure when physical access to the feature board card is
restricted.

Entering the hw-module slot shelf-id/slot-number reload command initiates the feature board reload
process through power cycling. The hw-module slot shelf-id/slot-number reload command cannot be
used to reload DSCs.
Use the reset form of this command to reset the specified feature card and drop all active calls.
Use the shutdown form of this command to shut down the specified feature card and drop all active calls.

Examples The following example shows how to stop the DSC in slot 13 and start the other DSC in slot 12 (which
was previously stopped):
Router# hw-module slot 1/13 stop
Router# hw-module slot 1/12 start

The following example shows how to reload the dial shelf feature board in slot 6:
Router# hw-module slot 1/6 reload

The following example shows how to reset the card in slot 3:

Router# hw-module slot 1/3 reset

The following example shows how to shut down the PRE card located in slot 3:
Router# hw-module slot 1/3 shutdown

Related Commands Command Description

debug redundancy Displays information used for troubleshooting dual (redundant) DSC
cards.
show redundancy Displays current or historical status and related information on dual
(redundant) DSC cards.

Cisco IOS Interface and Hardware Component Command Reference

IR-219
 Interface and Hardware Component Commands
hw-module slot image

hw-module slot image

To specify a high availability Cisco IOS image to run on an active or standby Route Switch Processor
(RSP), use the hw-module slot image command in global configuration mode. To remove a high
availability Cisco IOS image from the running configuration, use the no form of this command.

hw-module slot slot-number image file-spec

no hw-module slot slot-number image file-spec

Syntax Description slot-number Specifies the number of the RSP slot.

file-spec Specifies the flash memory card location to load the image into and the
name of the image.

Defaults No high availability Cisco IOS images are specified to run on the active or standby RSPs.

Command Modes Global configuration

Command History Release Modification

12.0(16)ST This command was introduced.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T.

Examples The following example shows a Cisco 7513 router with the active RSP loaded in slot 6 and the standby
RSP loaded in slot 7. The rsp-pv-mz high availability Cisco IOS image is specified to run on both the
active and the standby RSP. Both RSPs have slot 0 flash memory cards.
Router(config)# hw-module slot 6 image slot0:rsp-pv-mz
Router(config)# hw-module slot 7 image slot0:rsp-pv-mz

Related Commands Command Description

hw-module sec-cpu Resets and reloads the standby RSP with the specified Cisco IOS image and
reset executes the image.
mode (HSA Configures the redundancy mode.
redundancy)
redundancy Enters redundancy configuration mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-220
 Interface and Hardware Component Commands
id aa-group

id aa-group
To configure the asynchronous acknowledgement group ID, use the id aa-group command in satellite
initial configuration mode. To remove the ID configuration, use the no form of this command.

id aa-group number

no id aa-group

Syntax Description number Asynchronous acknowledgement group ID number in the range from 256 to
511.

Defaults No default behavior or values

Command Modes Satellite initial configuration

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your
satellite service provider instructs you to perform the satellite initial configuration and provides all
necessary parameter values.

Examples The following example shows how to configure the asynchronous acknowledgement group identification
number:
Router(sat-init-config)# id aa-group 336

Cisco IOS Interface and Hardware Component Command Reference

IR-221
 Interface and Hardware Component Commands
id software group

id software group
To configure the operational software group identification number, use the id software group command
in satellite initial configuration mode. To remove the ID configuration, use the no form of this command.

id software group number

no id software group

Syntax Description number ID number in the range from 512 to 767.

Defaults No default behavior or values

Command Modes Satellite initial configuration

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your
satellite service provider instructs you to perform the satellite initial configuration and provides all
necessary parameter values.

Examples The following example shows how to configure the operational software group identification number:
Router(sat-init-config)# id software group 598

Cisco IOS Interface and Hardware Component Command Reference

IR-222
 Interface and Hardware Component Commands
id vsat

id vsat
To configure the component physical address (CPA), use the id vsat command in satellite initial
configuration mode. To remove the CPA configuration, use the no form of this command.

id vsat number

no id vsat number

Syntax Description number CPA number in the range from 1280 to 8100.

Defaults No default behavior or values

Command Modes Satellite initial configuration

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines The CPA uniquely identifies the VSAT endpoint in the satellite network.

Note This command is typically used by an installation technician. Do not use this command unless your
satellite service provider instructs you to perform the satellite initial configuration and provides all
necessary parameter values.

Examples The following example shows how to configure the CPA number:
Router(sat-init-config)# id vsat 1284

Cisco IOS Interface and Hardware Component Command Reference

IR-223
 Interface and Hardware Component Commands
idle-pattern

idle-pattern
To define the idle pattern that a circuit emulation (CEM) channel transmits when the channel experiences
an underrun condition or to replace any missing packets, use the idle-pattern command in CEM
configuration mode. To stop sending idle pattern data, use the no form of this command.

idle-pattern {pattern | length pattern1 [pattern2]}

no idle-pattern

Syntax Description pattern An 8-bit hexadecimal number. T1 and E1 channels require only this
argument.
length Length, in bits, of the pattern. Serial cards require that you enter a value for
length.
pattern1 Specifies (in hex notation) up to 32 bits of the least significant bits of the idle
data pattern. Default is 0xFF.
pattern2 (Optional) Specifies (in hex notation) the most significant bits of the idle
data pattern. If the length argument is 32 bits or less, this argument is not
permitted.

Defaults For T1 or E1 channels: 0xFF.

For serial channels: 8 bits and 0xFF.

Command Modes CEM configuration

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines Idle pattern data is always sent in multiples of one entire packet payload. If a single packet is missing
from the arriving data stream it is replaced by an idle packet of the same payload size and composed of
repetitions of the specified idle pattern. If the CEM channel outbound (egress) buffer experiences an
underrun condition, identical idle packets are transmitted until the dejitter buffer is filled to at least half
its total depth.

Examples The following example shows how to configure a 32-bit idle pattern for a serial CEM channel.
Router(config-cem)# idle-pattern 32 0x12345678

Related Commands Command Description

cem Enters circuit emulation configuration mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-224
Interface and Hardware Component Commands
idle-pattern

Command Description
clear cem Clears CEM channel statistics.
show cem Displays CEM channel statistics.

Cisco IOS Interface and Hardware Component Command Reference

IR-225
 Interface and Hardware Component Commands
ids-service-module monitoring

ids-service-module monitoring
To enable Intrusion Detection System (IDS) monitoring on a specified interface, use the
ids-service-module monitoring command in interface configuration mode. To perform IDS monitoring,
the routing device must have a Cisco IDS network module installed. To disable IDS monitoring, use the
no form of this command.

ids-service-module monitoring

no ids-service-module monitoring

Syntax Description This command has no arguments or keywords.

Defaults IDS monitoring is not enabled.

Command Modes Interface configuration

Command History Release Modification

12.3(4)T This command was introduced.

Usage Guidelines Use the ids-service-module monitoring command to enable IDS monitoring on a specified interface or
subinterface. Both inbound and outbound packets on the specified interface are forwarded for
monitoring.
The Cisco IDS network module is also referred to as the NM-CIDS.

Examples The following example shows how to configure Fast Ethernet interface 0/0 to copy network traffic to the
Cisco IDS network module and enable IDS monitoring:
Router(config)# interface FastEthernet0/0
Router(config-if)# ids-service-module monitoring

Related Commands Command Description

service-module Reboots, resets, enables console access to, shuts down, and monitors the
ids-sensor status of the Cisco IDS network module.

Cisco IOS Interface and Hardware Component Command Reference

IR-226
 Interface and Hardware Component Commands
ignore (interface)

ignore (interface)
To configure the serial interface to ignore the specified serial signals as the line up/down indicator, use
the ignore command in interface configuration mode. To restore the default, use the no form of this
command.

DCE Asynchronous Mode

ignore [dtr | rts]

no ignore [dtr | rts]

DCE Synchronous Mode

ignore [dtr | local-loopback | rts]

no ignore [dtr | local-loopback | rts]

DTE Asynchronous Mode

ignore [cts | dsr]

no ignore [cts | dsr]

DTE Synchronous Mode

ignore [cts | dcd | dsr]

no ignore [cts | dcd | dsr]

Syntax Description dtr Specifies that the DCE ignores the Data Terminal Ready (DTR) signal.
rts Specifies that the DCE ignores the Request To Send (RTS) signal.
local-loopback Specifies that the DCE ignores the local loopback signal.
cts Specifies that the DTE ignores the Clear To Send (CTS) signal.
dsr Specifies that the DTE ignores the Data Set Ready (DSR) signal.
dcd Specifies that the DTE ignores the Data Carrier Detect (DCD) signal.

Defaults The no form of this command is the default. The serial interface monitors the serial signal as the line
up/down indicator.

Command Modes Interface configuration

Cisco IOS Interface and Hardware Component Command Reference

IR-227
 Interface and Hardware Component Commands
ignore (interface)

Command History Release Modification

12.2(15)ZJ This command was introduced on the following platforms: Cisco 2610XM,
Cisco 2611XM, Cisco 2620XM, Cisco 2621XM, Cisco 2650XM,
Cisco 2651XM, Cisco 2691, Cisco 3631, Cisco 3660, Cisco 3725, and
Cisco 3745 routers.
12.3(2)T This command was integrated into Cisco IOS Release 12.3(2)T.

Usage Guidelines Serial Interfaces in DTE Mode

When the serial interface is operating in DTE mode, it monitors the 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.

SDLC Multidrop Environments

In some configurations, such as a Synchronous Data Link Control (SDLC) multidrop environment, the
DCE device sends the 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.

Examples The following example shows how to configure serial interface 0 to ignore the DCD signal as the line
up/down indicator:
Router(config)# interface serial 0
Router(config-if)# ignore dcd

Related Commands Command Description

debug serial lead-transition Activates the leads status transition debug capability for all capable ports.
show interfaces serial Displays information about a serial interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-228
 Interface and Hardware Component Commands
ignore-dcd

ignore-dcd
To configure the serial interface to monitor the Data Set Ready (DSR) signal instead of the Data Carrier
Detect (DCD) signal as the line up/down indicator, use the ignore-dcd command in interface
configuration mode. To restore the default, use the no form of this command.

ignore-dcd

no ignore-dcd

Syntax Description This command has no arguments or keywords.

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

Command Modes Interface configuration

Command History Release Modification

11.0 This command was introduced.

Usage Guidelines This command applies to Quad Serial NIM interfaces on the Cisco 4000 series routers and Hitachi-based
serial interfaces on the Cisco 2500 and Cisco 3000 series routers.

Serial Interfaces in DTE Mode

When the serial interface is operating in DTE mode, it monitors the 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.

SDLC Multidrop Environments

In some configurations, such as an Synchronous Data Link Control (SDLC) multidrop environment, the
DCE device sends the 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.

Examples The following example shows how to configure serial interface 0 to monitor the DSR signal as the line
up/down indicator:
Router(config)# interface serial 0
Router(config-if)# ignore-dcd

Cisco IOS Interface and Hardware Component Command Reference

IR-229
 Interface and Hardware Component Commands
ignore-error-duration

ignore-error-duration
To ignore initial train-up errors when the DSL controller is connected to DSLAMs with chipsets other
than Globespan, use the ignore-error-duration command in controller configuration mode. To set the
error duration to the default of 0 seconds, use the no form of the command.

ignore-error-duration seconds

Syntax Description seconds Sets the time in seconds for which errors will be ignored during training of
the line. Range is from 15 to 30 seconds.

Defaults 0 seconds

Command Modes Controller configuration

Command History Release Modification

12.3(4)XD This command was introduced on Cisco 2600 series and Cisco 3700 series
routers.
12.3(4)XG This command was integrated into the Cisco IOS Release 12.3(4)XG on the
Cisco 1700 series routers.
12.3(7)T This command was implemented on Cisco 2600 series, Cisco 3631, and
Cisco 3700 series routers.
12.3(11)T This command was implemented on Cisco 2800 and Cisco 3800 series
routers.
12.3(14)T This command was implemented on Cisco 1800 series routers.

Usage Guidelines This command is used to ignore initial train-up errors when connected to DSLAMs with chipsets other
than Globespan. Use the time period of 15 to 30 seconds to allow the line to train without being affected
by errors that result because of the line training.

Examples The following example sets the time during which errors will be ignored to 15 seconds:
Router(config)# controller dsl 4/0
Router(config-controller)# ignore-error-duration 15

Related Commands Command Description

controller dsl Configures the DSL controller.

Cisco IOS Interface and Hardware Component Command Reference

IR-230
 Interface and Hardware Component Commands
ignore-hw local-loopback

ignore-hw local-loopback
To disable the monitoring of the (local-loopback) LL pin when in DCE mode, use the ingnore-hw
local-loopback command in interface configuration mode. To enable the monitoring of the LL pin, use
the no form of this command.

ignore-hw local-loopback

no ignore-hw local-loopback

Syntax Description This command has no arguments or keywords.

Defaults Enabled

Command Modes Interface configuration

Command History Release Modification

11.3 This command was introduced.

Usage Guidelines Use this command if your system is experiencing spurious modem interrupts that momentarily cause the
interface to enter loopback mode. The end result of this behavior is the loss of Synchronous Data Link
Control (SDLC) Logical Link Control (SDLLC) sessions.

Note This command works only with the low-speed serial interfaces.

Examples The following example shows how to disable the monitoring of the LL pin when in DCE mode:
Router(config)# interface serial 2
Router(config-if)# ignore-hw local-loopback

Cisco IOS Interface and Hardware Component Command Reference

IR-231
 Interface and Hardware Component Commands
interface

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

interface type number [name-tag]

Cisco 7200 Series and Cisco 7500 Series with a Packet over SONET Interface Processor

interface type slot/port

Cisco 7200 VXR Router used as a Router Shelf in an AS5800 Universal Access Server

interface type router-shelf/slot/port

Cisco 7500 Series with Channelized T1 or E1

interface serial slot/port:channel-group

Cisco 7500 Series with Ports on VIP Cards

interface type slot/port-adapter/port

Content Engine Network Module

interface content-engine slot/unit

Satellite Network Module

interface satellite slot/unit

Service Engine Network Module or Advanced Integration Module (AIM)

interface service-engine slot/port

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

Cisco 7200 Series

interface type slot/port.subinterface-number [multipoint | point-to-point]

Cisco 7500 Series

interface type slot/port-adapter.subinterface-number [multipoint | point-to-point]

Cisco 7500 Series with Ports on VIP Cards

interface type slot/port-adapter/port.subinterface-number [multipoint | point-to-point]

Cisco IOS Interface and Hardware Component Command Reference

IR-232
 Interface and Hardware Component Commands
interface

Syntax Description type Type of interface to be configured. See Table 11.

number Port, connector, or interface card number. On Cisco 4700 series routers,
specifies the network interface module (NIM) or network processor
module (NPM) 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.
name-tag (Optional) Specifies the logic name to identify the server configuration
so that multiple entries of server configuration can be entered.
This optional argument is for use with the Redundant Link Manager
(RLM) feature.
slot Slot number. Refer to the appropriate hardware manual for slot and port
information.
/port Port number. Refer to the appropriate hardware manual for slot and port
information.
router-shelf Router shelf number in a Cisco AS5800 universal access server. Refer
to the appropriate hardware manual for slot and port information.
:channel-group Channel group number. Cisco 7500 series routers specify the channel
group number in the range of 0 to 4 defined with the channel-group
controller configuration command.
/port-adapter Port adapter number. Refer to the appropriate hardware manual for
information about port adapter compatibility.
/unit Number of the daughter card on the network module.
• For content engine (CE) network modules, always use 0.
• For NM-1VSAT-GILAT network modules, always use 0.
.subinterface-number Subinterface number in the range 1 to 4,294,967,293. 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.

Defaults No interface types are configured.

Command Modes Global configuration

Note To use this command with the RLM feature, you must be in interface configuration mode.

Command History Release Modification

10.0 This command was introduced for the Cisco 7000 series routers.
11.0 This command was introduced for the Cisco 4000 series routers.
12.0(3)T The optional name-tag argument was added for the RLM feature.
12.2(13)T The content-engine keyword was added.

Cisco IOS Interface and Hardware Component Command Reference

IR-233
 Interface and Hardware Component Commands
interface

Release Modification
12.2(15)T The lex keyword was removed because the LAN Extension feature is no
longer available in Cisco IOS software.
12.3(4)T The service engine keyword was added.
12.3(7)T Support was added for service engine Advanced Integration Module (AIM).
12.3(14)T The satellite keyword was added to support satellite interface configuration
on network modules.

Usage Guidelines Subinterfaces can be configured to support partially meshed Frame Relay networks. Refer to the
“Configuring Serial Interfaces” chapter in the Cisco IOS Interface and Hardware Component
Configuration Guide.

Table 10 interface Type Keywords

Keyword Interface Type

async Port line used as an asynchronous interface.
atm ATM interface.
bri ISDN BRI. This interface configuration is propagated to each of the B
channels. B channels cannot be individually configured. The interface
must be configured with dial-on-demand commands in order for calls to
be placed on that interface.
content-engine Content engine (CE) network module interface. The The CE network
module interface cannot be configured for subinterfaces or for speed,
duplex mode, and similar parameters. See command-line interface
(CLI) help for a list of valid parameters. The content-engine keyword
was formerly documented as the interface content-engine command.
dialer Dialer interface.
ethernet Ethernet IEEE 802.3 interface.
fastethernet 100-Mbps Ethernet interface. The fastethernet keyword was formerly
documented as the interface fastethernet command.
fddi FDDI interface.
gigabitethernet 1000-Mbps Ethernet interface. The gigabitethernet keyword was
formerly documented as the interface gigabitethernet command.
group-async Master asynchronous interface. The group-async keyword was
formerly documented as the interface group-async command.
hssi High-Speed Serial Interface (HSSI).
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 that you can create.
null Null interface.
port-channel Port channel interface. The port-channel keyword was formerly
documented as the interface port-channel command.

Cisco IOS Interface and Hardware Component Command Reference

IR-234
Interface and Hardware Component Commands
interface

Table 10 interface Type Keywords (continued)

Keyword Interface Type

pos Packet OC-3 interface on the Packet-over-SONET (POS) interface
processor. The pos keyword was formerly documented as the interface
pos command.
satellite Satellite network module. Enters satellite configuration mode.
serial Serial interface.
service-engine Network module (NM) or an Advanced Integration Module (AIM),This
command may be used for NMs and AIMs only. If your system does not
have this hardware, you will be unable to enter this command.
The no form of this command (no interface service-engine) is not
available. The exit command can be used to exit interface configuration
mode.
switch Switch interface
tokenring Token Ring interface.
tunnel Tunnel interface; a virtual interface. The 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 that you can create.
vg-anylan 100VG-AnyLAN port adapter. The vg-anylan keyword was formerly
documented as the interface vg-anylan command.

This command does not have a no form.

Using the group-async Keyword

Using the group-async keyword, 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 be associated only with one group.

Using the port-channel Keyword

The Fast EtherChannel feature allows multiple Fast Ethernet point-to-point links to be bundled into one
logical link to provide bidirectional bandwidth of up to 800 Mbps. You can configure the port-channel
interface as you would do to any Fast Ethernet interface.
After you create a port-channel interface, you assign Fast Ethernet interfaces (up to four) to it. For
information on how to assign a Fast Ethernet interface to a port-channel interface, refer to the
channel-group interface configuration command.

Caution The port-channel interface is the routed interface. Do not enable Layer 3 addresses on the physical Fast
Ethernet interfaces. Do not assign bridge groups on the physical Fast Ethernet interfaces because it
creates loops. Also, you must disable spanning tree.

Cisco IOS Interface and Hardware Component Command Reference

IR-235
 Interface and Hardware Component Commands
interface

Caution With Release 11.1(20)CC, the Fast EtherChannel supports Cisco Express Forwarding (CEF) and
Distributed Cisco Express Forwarding (dCEF). We recommend that you clear all explicit ip route-cache
distributed commands from the Fast Ethernet interfaces before enabling dCEF on the port-channel
interface. Clearing the route cache gives the port-channel interface proper control of its physical Fast
Ethernet links. When you enable CEF/dCEF globally, all interfaces that support CEF/dCEF are enabled.
When CEF/dCEF is enabled on the port-channel interface, it is automatically enabled on each of the Fast
Ethernet interfaces in the channel group. However, if you have previously disabled CEF/dCEF on the
Fast Ethernet interface, CEF/dCEF is not automatically enabled. In this case, you must enable
CEF/dCEF on the Fast Ethernet interface.

As you work with the port-channel keyword, consider the following points:
• Currently, if you want to use the Cisco Discovery Protocol (CDP), you must configure it only on the
port-channel interface and not on the physical Fast Ethernet interface.
• If you do not assign a static MAC address on the port-channel interface, the Cisco IOS software
automatically assigns a MAC address. If you assign a static MAC address and then later remove it,
Cisco IOS software automatically assigns a MAC address.

Using the vg-anylan Keyword

The 100VG-AnyLAN port adapter provides a single interface port that is compatible with and specified
by IEEE 802.12. The 100VG-AnyLAN port adapter provides 100 Mbps over Category 3 or Category 5
unshielded twisted-pair (UTP) cable with RJ-45 terminators, and supports IEEE 802.3 Ethernet packets.
You configure the 100VG-AnyLAN port adapter as you would any Ethernet or Fast Ethernet interface.
The 100VG-AnyLAN port adapter can be monitored with the IEEE 802.12 Interface MIB.

Examples Asynchronous Group Master Interface

The following example shows how to define asynchronous group master interface 0:
Router(config)# interface group-async 0

Content Engine Network Module

The following example configures an interface for a content engine network module in slot 1:
Router(config)# interface content-engine 1/0

Ethernet Port 4 on the Ethernet Interface Processor (EIP)

The following example shows how to configure Ethernet port 4 on the Ethernet Interface Processor (EIP)
in slot 2 on the Cisco 7500 series router:
Router(config)# interface ethernet 2/4

Fast Ethernet
The following example shows how to configure Fast Ethernet interface 0 for standard ARPA
encapsulation (the default setting) on a Cisco 4700 series router:
Router(config)# interface fastethernet 0

Gigabit Ethernet
The following example shows how to configure Gigabit Ethernet interface for slot 0, port 0:
Router(config)# interface gigabitethernet 0/0

Cisco IOS Interface and Hardware Component Command Reference

IR-236
Interface and Hardware Component Commands
interface

Loopback Mode
The following example shows how to enable 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:
Router(config)# interface loopback 0
Router(config-if)# ip address 10.108.1.1 255.255.255.0

Packet OC-3
The following example shows how to specify the single Packet OC-3 interface on port 0 of the POS OC-3
port adapter in slot 2:
Router(config)# interface pos 2/0/0

Partially Meshed Frame Relay Network

The following example shows how to configure a partially meshed Frame Relay network. In this
example, subinterface serial 0.1 is configured as a multipoint subinterface with three associated Frame
Relay permanent virtual connections (PVCs), and subinterface serial 0.2 is configured as a point-to-point
subinterface.
Router(config)# interface serial 0
Router(config-if)# encapsulation frame-relay
Router(config-if)# exit
Router(config)# interface serial 0/0.1 multipoint
Router(config-if)# ip address 10.108.10.1 255.255.255.0
Router(config-if)# frame-relay interface-dlci 42 broadcast
Router(config-if)# frame-relay interface-dlci 53 broadcast
Router(config-if)# exit
Router(config)# interface serial 0/0.2 point-to-point
Router(config-if)# ip address 10.108.11.1 255.255.0
Router(config-if)# frame-relay interface-dlci 59 broadcast

Port Channel in Channel Group

The following example shows how to create a port-channel interface with a channel group number of 1
and adds two Fast Ethernet interfaces to port-channel 1:
Router(config)# interface port-channel 1
Router(config-if)# ip address 10.1.1.10 255.255.255.0
Router(config-if)# exit
Router(config)# interface fastethernet 1/0/0
Router(config-if)# channel-group 1
Router(config-if)# exit
Router(config)# interface fastethernet 4/0/0
Router(config-if)# channel-group 1

PPP Encapsulation
The following example shows how to configure serial interface 0 with PPP encapsulation:
Router(config)# interface serial 0
Router(config-if)# encapsulation ppp

Satellite Interface Configuration

The following example shows how to enter satellite interface configuration mode:
Router(config)# interface satellite 1/0
Router(config-if)#

Cisco IOS Interface and Hardware Component Command Reference

IR-237
 Interface and Hardware Component Commands
interface

Service Engine for NM or AIM

The following example shows the command for entering interface configuration mode for either an NM
or an AIM located in slot 1, unit 1:
Router (config)# interface service-engine 1/1
Router (config-if)# exit

T1 Link for Point-to-Point (PPP)

The following example shows how to configure circuit 0 of a T1 link for Point-to-Point Protocol (PPP)
encapsulation:
Router(config)# controller t1 4/1
Router(config-controller)# circuit 0 1
Router(config-controller)# exit
Router(config)# interface serial 4/1:0
Router(config-if)# ip address 10.108.13.1 255.255.255.0
Router(config-if)# encapsulation ppp

Token Ring Interface Processor

The following example shows how to configure the Token Ring interface processor in slot 1 on port 0 of
a Cisco 7500 series routers:
Router(config)# interface tokenring 1/0

Related Commands Command Description

channel (Fastethernet) Defines the time slots of each T1 or E1 circuit.
channel-group Defines the timeslots that belong to each T1 or E1 circuit.
channel-group Assigns a Fast Ethernet interface to a Fast EtherChannel group.
(Fastethernet)
clear interface Resets the hardware logic on an interface.
controller Configures an E1, J1, T1, or T3 controller and enters controller
configuration mode.
mac-address Sets the MAC layer address of the Cisco Token Ring.
ppp Starts an asynchronous connection using PPP.
service-module satellite Displays status information related to the hardware and software on the
status Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT),
including the initial configuration parameters.
show controllers Displays controller information for CE network modules.
content-engine
show controllers satellite Displays controller information about the internal router interface that
connects to an installed Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT).
show interfaces Displays information about interfaces.
show interfaces Displays basic interface configuration information for a CE network
content-engine module.
show interface satellite Displays general interface settings and traffic rates for the internal router
interface that connects to an installed Cisco IP VSAT satellite WAN
network module (NM-1VSAT-GILAT).
shutdown (RLM) Shuts down all of the links under the RLM group.
slip Starts a serial connection to a remote host using SLIP.

Cisco IOS Interface and Hardware Component Command Reference

IR-238
 Interface and Hardware Component Commands
interface analysis-module

interface analysis-module
To configure the Analysis-Module interface on the router that connects to an installed Network Analysis
Module (NM-NAM), use the interface analysis-module command in global configuration mode. This
command does not have a not form.

interface analysis-module slot/unit

Syntax Description slot Number of the router chassis slot for the network module.
/unit Number of the daughter card on the network module. For NM-NAM, always
use 0. The slash (/) between the slot and unit arguments is required.

Defaults The interface is not configured.

Command Modes Global configuration

Command History Release Modification

12.3(4)XD This command was introduced on the following platforms:
Cisco 2600XM series, Cisco 2691, Cisco 3660, Cisco 3725, and Cisco 3745.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T.
12.3(8)T4 This command was implemented on the following platforms: Cisco 2811,
Cisco 2821, and the Cisco 2851 series.
12.3(11)T This command was made available on the Cisco 3800 series.

Usage Guidelines The Analysis-Module interface is a Fast Ethernet interface on the router that connects to the internal
interface on the Network Analysis Module (NM-NAM).
This type of interface cannot be configured for subinterfaces or for speed, duplex mode, and similar
parameters. See the command-line interface (CLI) help for a list of valid parameters.
The interface analysis-module command enters Analysis-Module interface configuration mode.

Examples The following example shows how to configure the Analysis-Module interface when the NM-NAM is in
router slot 1:
Router(config)# interface analysis-module 1/0

Cisco IOS Interface and Hardware Component Command Reference

IR-239
 Interface and Hardware Component Commands
interface analysis-module

Related Commands Command Description

ip unnumbered Enables IP processing on an interface without assigning an explicit IP
address to the interface.
show interfaces Displays status, traffic data, and configuration information about the
analysis-module Analysis-Module interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-240
Interface and Hardware Component Commands
interface content-engine

interface content-engine
The interface content-engine command is now documented as the content-engine keyword of the
interface command. For more information, see the interface command.

Cisco IOS Interface and Hardware Component Command Reference

IR-241
 Interface and Hardware Component Commands
interface fastethernet

interface fastethernet
The interface fastethernet command is now documented as the fastethernet keyword of the interface
command. For more information, see the interface command.

Cisco IOS Interface and Hardware Component Command Reference

IR-242
 Interface and Hardware Component Commands
interface gigabitethernet

interface gigabitethernet
The interface gigabitethernet command is now documented as the gigabitethernet keyword of the
interface command. For more information, see the interface command.

Cisco IOS Interface and Hardware Component Command Reference

IR-243
 Interface and Hardware Component Commands
interface group-async

interface group-async
The interface group-async command is now documented as the group-async keyword of the interface
command. For more information, see the interface command.

Cisco IOS Interface and Hardware Component Command Reference

IR-244
Interface and Hardware Component Commands
interface port-channel

interface port-channel
The interface port-channel command is now documented as the port-channel keyword of the interface
command. For more information, see the interface command.

Cisco IOS Interface and Hardware Component Command Reference

IR-245
 Interface and Hardware Component Commands
interface pos

interface pos
The interface pos command is now documented as the pos keyword of the interface command. For
more information, see the interface command.

Cisco IOS Interface and Hardware Component Command Reference

IR-246
 Interface and Hardware Component Commands
interface range

interface range
To execute commands on multiple subinterfaces at the same time, use the interface range command in
global configuration mode.

interface range {{ethernet | fastethernet | gigabitethernet | atm | vlan vlan}

slot/interface.subinterface - {ethernet | fastethernet | gigabitethernet | atm | vlan vlan}
slot/interface.subinterface | macro macro-name}

Syntax Description ethernet | fastethernet | Specifies the type of subinterface being configured.
gigabitethernet | atm |
vlan vlan
slot/ Slot number.
interface.subinterface Creates the specified subinterface if not already configured and includes
the specified interface in the subinterface range.
- Hyphen must be entered with a space on either side to separate the range
information.
macro Specifies an interface range macro.
macro-name Name of macro.

Defaults No default behavior or values

Command Modes Global configuration

Command History Release Modification

12.0(7)XE This command was introduced.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.
12.2(2)DD This command was expanded to support subinterface ranges.
12.2(4)B This command was integrated into Cisco IOS Release 12.2(4)B.
12.2(8)T The modified interface range command was integrated into Cisco IOS
Release 12.2(8)T.

Usage Guidelines Subinterface Groups

Subinterfaces specified by the interface range command are grouped into a configurable subinterface
group. Subinterfaces that are specified by the interface range command and that have not been
previously created are created by the interface range command.
The no interface range command is not supported. You must delete individual subinterfaces to delete a
range.

Cisco IOS Interface and Hardware Component Command Reference

IR-247
 Interface and Hardware Component Commands
interface range

Configuration Changes
All configuration changes made to a range of subinterfaces are saved to NVRAM, but the range itself
does not get saved to NVRAM. Use the define interface-range command to create and save a range.
You can enter the range in two ways:
• Specifying up to five interface ranges
• Specifying a previously defined macro
You can specify either the interfaces or the name of a range macro. A range must consist of the same
interface type, and the interfaces within a range cannot span slots.
You cannot specify both a macro and an interface range in the same command. After creating a macro,
the CLI does not allow you to enter additional ranges. Likewise, if you have already entered an interface
range, the CLI does not allow you to enter a macro.
The spaces around the dash in the interface range command syntax are required. For example, the
command interface range fastethernet 1 - fastethernet 5 is valid; the command interface range
fastethernet 1-fastethernet 5 is not valid.

VLAN Ranges
When you define a VLAN range, valid values are from 1 to 4095. The last VLAN number cannot exceed
4095.
You cannot use the interface range command to create switch virtual interfaces (SVIs). You must create
SVIs with individual interface VLAN commands. You can use the interface range command on
existing VLAN SVIs. To display VLAN SVIs, enter the show running-config command. VLANs not
displayed cannot be used in the interface range command.
The commands entered under the interface range command are applied to all existing VLAN SVIs.

Examples The following example shows how to use the interface range command to configure a subinterface
range:
Router(config)# interface range ethernet1/0.11 - ethernet1/0.60
Router(config-int-range)#

The following example configures the Fast Ethernet subinterfaces within the range from 5/1.1 to 5/1.4
and applies the following VLAN IDs to those subinterfaces:
Fast Ethernet5/1.1 = VLAN ID 301 (vlan-id)
Fast Ethernet5/1.2 = VLAN ID 302 (vlan-id = 301 + 2 – 1 = 302)
Fast Ethernet5/1.3 = VLAN ID 303 (vlan-id = 301 + 3 – 1 = 303)
Fast Ethernet5/1.4 = VLAN ID 304 (vlan-id = 301 + 4 – 1 = 304)
Router(config)# interface range fastethernet5/1.1 - fastethernet5/1.4
Router(config-if)# encapsulation dot1q 301
Router(config-if)# no shutdown
Router(config-if)#
*Oct 6 08:24:35: %LINK-3-UPDOWN: Interface FastEthernet5/1.1, changed state to up
*Oct 6 08:24:35: %LINK-3-UPDOWN: Interface FastEthernet5/1.2, changed state to up
*Oct 6 08:24:35: %LINK-3-UPDOWN: Interface FastEthernet5/1.3, changed state to up
*Oct 6 08:24:35: %LINK-3-UPDOWN: Interface FastEthernet5/1.4, changed state to up
*Oct 6 08:24:36: %LINEPROTO-5-UPDOWN: Line protocol on Interface FastEthernet5/1.1,
changed state to up
*Oct 6 08:24:36: %LINEPROTO-5-UPDOWN: Line protocol on Interface FastEthernet5/1.2,
changed state to up

Cisco IOS Interface and Hardware Component Command Reference

IR-248
 Interface and Hardware Component Commands
interface range

*Oct 6 08:24:36: %LINEPROTO-5-UPDOWN: Line protocol on Interface FastEthernet5/1.3,

changed state to up
*Oct 6 08:24:36: %LINEPROTO-5-UPDOWN: Line protocol on Interface FastEthernet5/1.4,
changed state to up

The following example shows how to execute a range macro:

Router(config)# interface range macro macro1

Related Commands Command Description

define interface range Defines an interface range macro.
encapsulation dot1q Applies a unique VLAN ID to each subinterface within the range.
interface vlan Configures a VLAN interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-249
 Interface and Hardware Component Commands
interface service-engine

interface service-engine
To enter the interface configuration mode for a network module (NM) or an advanced Integration
Module (AIM), use the interface service-engine command in global configuration mode.

interface service-engine slot/port

Syntax Description slot Interface slot number.

port Interface port number.

Defaults No default behavior or values.

Command Modes Global configuration

Command History Release Modification

12.2(15)ZJ This command was introduced for NMs.
12.3(4)T This command was integrated into Cisco IOS Release 12.3(4)T.
12.3(7)T Support was added for AIMs.

Usage Guidelines This command may only be used for NMs and AIMs. If your system does not have this hardware, then
you will be unable to enter this command.
The no form of this command (no interface service-engine) is not available. The exit command can be
used to exit the interface configuration mode.

Examples The following example shows the command for entering configuration mode for either a NM or AIM
located in slot 1, unit 1:
Router (config)# interface service-engine 1/1
Router (config-if)# exit

Cisco IOS Interface and Hardware Component Command Reference

IR-250
Interface and Hardware Component Commands
interface vg-anylan

interface vg-anylan
The interface vg-anylan command is now documented as the vg-anylan keyword of the interface
command. For more information, see the interface command.

Cisco IOS Interface and Hardware Component Command Reference

IR-251
 Interface and Hardware Component Commands
interface

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

interface type number [name-tag]

Analysis Module Network Module

interface analysis-module slot/unit

Content Engine Network Module

interface content-engine slot/unit

Cisco 7200 Series and Cisco 7500 Series with a Packet over SONET Interface Processor

interface type slot/port

Cisco 7200 VXR Router used as a Router Shelf in a Cisco AS5800 Universal Access Server

interface type router-shelf/slot/port

Cisco 7500 Series with Channelized T1 or E1

interface serial slot/port:channel-group

Cisco 7500 Series with Ports on VIP Cards

interface type slot/port-adapter/port

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

Cisco 7200 Series

interface type slot/port.subinterface-number [multipoint | point-to-point]

Cisco 7500 Series

interface type slot/port-adapter.subinterface-number [multipoint | point-to-point]

Cisco 7500 Series with Ports on VIP Cards

interface type slot/port-adapter/port.subinterface-number [multipoint | point-to-point]

Syntax Description type Type of interface to be configured. See Table 11.

number Port, connector, or interface card number. On Cisco 4700 series routers,
specifies the network interface module (NIM) or network processor
module (NPM) 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.

Cisco IOS Interface and Hardware Component Command Reference

IR-252
 Interface and Hardware Component Commands
interface

name-tag (Optional) Specifies the logic name to identify the server configuration
so that multiple server configurations can be entered.
This optional argument is for use with the Redundant Link Manager
(RLM) feature.
slot Slot number. Refer to the appropriate hardware manual for slot
information.
/unit Number of the daughter card on the network module. For analysis
module and content engine (CE) network modules, always use 0.
/port Port number. Refer to the appropriate hardware manual for port
information.
router-shelf Router shelf number in a Cisco AS5800 universal access server. Refer
to the appropriate hardware manual for router shelf information.
:channel-group Channel group number. Cisco 7500 series routers specify the channel
group number in the range of 0 to 4 defined with the channel-group
controller configuration command.
/port-adapter Port adapter number. Refer to the appropriate hardware manual for
information about port adapter compatibility.
.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.

Defaults No interface types are configured.

Command Modes Global configuration

Note To use this command with the RLM feature, you must be in interface configuration mode.

Command History Release Modification

10.0 This command was introduced for the Cisco 7000 series routers.
11.0 This command was implemented on the Cisco 4000 series routers.
12.0(3)T The optional name-tag argument was added for the RLM feature.
12.2(13)T The content-engine keyword was added.
12.2(15)T The lex keyword was removed because the LAN Extension feature is no
longer available in Cisco IOS software.
12.3(7)T The analysis-module keyword was added.

Usage Guidelines This command does not have a no form.

Cisco IOS Interface and Hardware Component Command Reference

IR-253
 Interface and Hardware Component Commands
interface

Subinterfaces can be configured to support partially meshed Frame Relay networks. Refer to the
“Configuring Serial Interfaces” chapter in the Cisco IOS Interface and Hardware Component
Configuration Guide.
Table 11 displays the keywords that represent the types of interfaces that can be configured with the
interface command. Replace the type argument with the appropriate keyword from the table.

Table 11 Interface Type Keywords

Keyword Interface Type

analysis-module Analysis module interface. The analysis module interface is a Fast
Ethernet interface on the router that connects to the internal interface on
the Network Analysis Module (NAM). This interface cannot be
configured for subinterfaces or for speed, duplex mode, and similar
parameters. See the command-line interface (CLI) help for a list of
valid parameters.
async Port line used as an asynchronous interface.
atm ATM interface.
bri ISDN BRI. This interface configuration is propagated to each of the B
channels. B channels cannot be individually configured. The interface
must be configured with dial-on-demand commands in order for calls to
be placed on that interface.
content-engine Content engine (CE) network module interface. The CE network
module interface cannot be configured for subinterfaces or for speed,
duplex mode, and similar parameters. See the command-line interface
(CLI) help for a list of valid parameters. The content-engine keyword
was formerly documented as the interface content-engine command.
dialer Dialer interface.
ethernet Ethernet IEEE 802.3 interface.
fastethernet 100-Mbps Ethernet interface. The fastethernet keyword was formerly
documented as the interface fastethernet command.
fddi FDDI interface.
gigabitethernet 1000-Mbps Ethernet interface. The gigabitethernet keyword was
formerly documented as the interface gigabitethernet command.
group-async Master asynchronous interface. The group-async keyword was
formerly documented as the interface group-async command.
hssi High-Speed Serial Interface (HSSI).
loopback Software-only loopback interface that emulates an interface that is
always up. It is a virtual interface supported on all platforms. The
number argument is the number of the loopback interface that you want
to create or configure. There is no limit on the number of loopback
interfaces that you can create.
null Null interface.
port-channel Port channel interface. The port-channel keyword was formerly
documented as the interface port-channel command.

Cisco IOS Interface and Hardware Component Command Reference

IR-254
Interface and Hardware Component Commands
interface

Table 11 Interface Type Keywords (continued)

Keyword Interface Type

pos Packet OC-3 interface on the Packet-over-SONET (POS) interface
processor. The pos keyword was formerly documented as the interface
pos command.
serial Serial interface.
switch Switch interface.
tokenring Token Ring interface.
tunnel Tunnel interface; a virtual interface. The number argument is the
number of the tunnel interface that you want to create or configure.
There is no limit on the number of tunnel interfaces that you can create.
vg-anylan 100VG-AnyLAN port adapter. The vg-anylan keyword was formerly
documented as the interface vg-anylan command.

Using the analysis-module Keyword

The analysis module interface is used to access the NAM console for the initial configuration. After the
NAM IP parameters are configured, the analysis module interface is typically used only during NAM
software upgrades and while troubleshooting if the NAM Traffic Analyzer is inaccessible.
Visible only to the Cisco IOS software on the router, the analysis module interface is an internal Fast
Ethernet interface on the router that connects to the internal NAM interface. The analysis module
interface is connected to the router’s Peripheral Component Interconnect (PCI) backplane, and all
configuration and management of the analysis module interface must be performed from the Cisco IOS
CLI.

Using the group-async Keyword

Using the group-async keyword, you create a single asynchronous interface with 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 be associated only with one group.

Using the port-channel Keyword

The Fast EtherChannel feature allows multiple Fast Ethernet point-to-point links to be bundled into one
logical link to provide bidirectional bandwidth of up to 800 Mbps. You can configure the port-channel
interface as you would any Fast Ethernet interface.
After you create a port-channel interface, you assign Fast Ethernet interfaces (up to four) to it. For
information on how to assign a Fast Ethernet interface to a port-channel interface, refer to the
channel-group interface configuration command.

Caution The port-channel interface is the routed interface. Do not enable Layer 3 addresses on the physical
Fast Ethernet interfaces. Do not assign bridge groups on the physical Fast Ethernet interfaces
because it creates loops. Also, you must disable spanning tree.

Cisco IOS Interface and Hardware Component Command Reference

IR-255
 Interface and Hardware Component Commands
interface

Caution With Release 11.1(20)CC, the Fast EtherChannel supports Cisco Express Forwarding (CEF) and
distributed Cisco Express Forwarding (dCEF). We recommend that you clear all explicit
ip route-cache distributed commands from the Fast Ethernet interfaces before enabling dCEF on
the port-channel interface. Clearing the route cache gives the port-channel interface proper control
of its physical Fast Ethernet links. When you enable CEF/dCEF globally, all interfaces that support
CEF/dCEF are enabled. When CEF/dCEF is enabled on the port-channel interface, it is automatically
enabled on each of the Fast Ethernet interfaces in the channel group. However, if you have
previously disabled CEF/dCEF on the Fast Ethernet interface, CEF/dCEF is not automatically
enabled. In this case, you must enable CEF/dCEF on the Fast Ethernet interface.

As you work with the port-channel keyword, consider the following points:
• Currently, if you want to use the Cisco Discovery Protocol (CDP), you must configure it only on the
port-channel interface and not on the physical Fast Ethernet interface.
• If you do not assign a static MAC address on the port-channel interface, the Cisco IOS software
automatically assigns a MAC address. If you assign a static MAC address and then later remove it,
Cisco IOS software automatically assigns a MAC address.

Using the vg-anylan Keyword

The 100VG-AnyLAN port adapter provides a single interface port that is compatible with and specified
by IEEE 802.12. The 100VG-AnyLAN port adapter provides 100 Mbps over Category 3 or Category 5
unshielded twisted-pair (UTP) cable with RJ-45 terminators, and supports IEEE 802.3 Ethernet packets.
You configure the 100VG-AnyLAN port adapter as you would any Ethernet or Fast Ethernet interface.
The 100VG-AnyLAN port adapter can be monitored with the IEEE 802.12 Interface MIB.

Examples The following example shows how to configure serial interface 0 with PPP encapsulation:
Router(config)# interface serial 0
Router(config-if)# encapsulation ppp

The following example shows how to enable 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.
Router(config)# interface loopback 0
Router(config-if)# ip address 10.108.1.1 255.255.255.0

The following example shows how to configure Ethernet port 4 on the Ethernet Interface Processor (EIP)
in slot 2 on the Cisco 7500 series router:
Router(config)# interface ethernet 2/4

The following example shows how to configure the Token Ring interface processor in slot 1 on port 0 of
a Cisco 7500 series router:
Router(config)# interface tokenring 1/0

The following example configures an analysis module interface when the NAM router is in router slot 1:
Router(config)# interface analysis-module 1/0

The following example configures an interface for a content engine network module in slot 1:
Router(config)# interface content-engine 1/0

Cisco IOS Interface and Hardware Component Command Reference

IR-256
Interface and Hardware Component Commands
interface

The following example shows how to configure Fast Ethernet interface 0 for standard ARPA
encapsulation (the default setting) on a Cisco 4700 series router:
Router(config)# interface fastethernet 0

The following example shows how to configure the Gigabit Ethernet interface for slot 0, port 0:
Router(config)# interface gigabitethernet 0/0

The following example shows how to define asynchronous group master interface 0:
Router(config)# interface group-async 0

The following example shows how to create a port-channel interface with a channel group number of 1
and adds two Fast Ethernet interfaces to port-channel 1:
Router(config)# interface port-channel 1
Router(config-if)# ip address 10.1.1.10 255.255.255.0
Router(config-if)# exit
Router(config)# interface fastethernet 1/0/0
Router(config-if)# channel-group 1
Router(config-if)# exit
Router(config)# interface fastethernet 4/0/0
Router(config-if)# channel-group 1

The following example shows how to specify the single Packet OC-3 interface on port 0 of the POS OC-3
port adapter in slot 2:
Router(config)# interface pos 2/0

The following example shows how to specify the 100VG-AnyLAN port adapter in the first port adapter
in slot 1:
Router(config)# interface vg-anylan 1/0/0

The following example shows how to configure a partially meshed Frame Relay network. In this
example, subinterface serial 0.1 is configured as a multipoint subinterface with two associated Frame
Relay permanent virtual connections (PVCs), and subinterface serial 0.2 is configured as a point-to-point
subinterface.
Router(config)# interface serial 0
Router(config-if)# encapsulation frame-relay
Router(config-if)# exit
Router(config)# interface serial 0/0.1 multipoint
Router(config-if)# ip address 10.108.10.1 255.255.255.0
Router(config-if)# frame-relay interface-dlci 42 broadcast
Router(config-if)# frame-relay interface-dlci 53 broadcast
Router(config-if)# exit
Router(config)# interface serial 0/0.2 point-to-point
Router(config-if)# ip address 10.108.11.1 255.255.255.0
Router(config-if)# frame-relay interface-dlci 59 broadcast

The following example shows how to configure circuit 0 of a T1 link for PPP encapsulation:
Router(config)# controller t1 4/1
Router(config-controller)# circuit 0 1
Router(config-controller)# exit
Router(config)# interface serial 4/1:0
Router(config-if)# ip address 10.108.13.1 255.255.255.0
Router(config-if)# encapsulation ppp

Cisco IOS Interface and Hardware Component Command Reference

IR-257
 Interface and Hardware Component Commands
interface

Related Commands Command Description

channel-group Defines the timeslots that belong to each T1 or E1 circuit.
channel-group (Fast Assigns a Fast Ethernet interface to a Fast EtherChannel group.
EtherChannel)
clear interface Resets the hardware logic on an interface.
controller Configures an E1, J1, T1, or T3 controller and enters controller
configuration mode.
group-range Creates a list of asynchronous interfaces that are associated with a group
interface on the same device.
mac-address Sets the MAC layer address.
ppp Starts an asynchronous connection using PPP.
show controllers Displays controller information for CE network modules.
content-engine
show interfaces Displays information about interfaces.
show interfaces Displays basic interface configuration information for a CE network
content-engine module.
shutdown (RLM) Shuts down all of the links under the RLM group.
slip Starts a serial connection to a remote host using SLIP.

Cisco IOS Interface and Hardware Component Command Reference

IR-258
 Interface and Hardware Component Commands
international bit

international bit
To set the E3 international bit in the G.751 frame used by the PA-E3 port adapter, use the
international bit command in interface configuration mode. To return to the default international bit,
use the no form of this command.

international bit {0 | 1} {0 | 1}

no international bit

Syntax Description 0 Sets either of the two required E3 international bits in the G.751 frame to 0.
This is the default.
1 Sets either of the two required E3 international bits in the G.751 frame to 1.

Defaults The default value for each bit is 0.

Command Modes Interface configuration

Command History Release Modification

11.1 CA This command was introduced.

Usage Guidelines The international bit command sets bits 6 and 8, respectively, of set II in the E3 frame.
To verify the international bit configured on the interface, use the show controllers serial EXEC
command.

Examples The following example sets the international bit to 1 1 on the PA-E3 port adapter in slot 1, port adapter
slot 0, interface 0:
Router(config)# interface serial 1/0/0
Router(config-if)# international bit 1 1

Related Commands Command Description

national bit Sets the E3 national bit in the G.751 frame used by the PA-E3 port adapter.
(interface)
show controllers Displays information that is specific to the interface hardware.
serial

Cisco IOS Interface and Hardware Component Command Reference

IR-259
 Interface and Hardware Component Commands
invert data

invert data
To invert the data stream, use the invert data command in interface configuration mode. This command
applies only to the Cisco 7000 series routers with the RSP7000 and RSP7000CI, Cisco 7200 series
routers, and Cisco 7500 series routers. To disable inverting the data stream, use the no form of this
command.

invert data

no invert data

Syntax Description This command has no arguments or keywords.

Defaults Data is not inverted.

Command Modes Interface configuration

Command History Release Modification

11.1 CA This command was introduced.
11.2 P This command was integrated into Cisco IOS Release 11.2 P.

Usage Guidelines T1 Line Without B8ZS Encoding

If the interface on the PA-8T and PA-4T+ synchronous serial port adapters and the PA-T3 and PA-2T3
synchronous serial port adapters is used to drive a dedicated T1 line that does not have B8ZS encoding
(a method to avoid 15 zeros), the data stream must be inverted (both transmitting and receiving data)
either in the connecting CSU/DSU or in the interface.
Inverting is a method of avoiding excessive zeroes that is superseded by the use of B8ZS encryption.
This option could be needed for use with legacy equipment that supports this option. By inverting the
High-Level Data Link Control (HDLC) data stream, the HDLC zero insertion algorithm becomes a ones
insertion algorithm that satisfies the T1 requirements. Be careful not to invert data both on the interface
and on the CSU/DSU because two data inversions will cancel each other out.

AMI Line Coding

If the interface on the CT3IP uses alternate mark inversion (AMI) line coding, you must also invert the
data on the T1 channel. For more information, see the t1 linecode controller configuration command.

Examples The following example inverts data on serial interface 3/1/0:

Router(config)# interface serial 3/1/0
Router(config-if)# invert data

Cisco IOS Interface and Hardware Component Command Reference

IR-260
 Interface and Hardware Component Commands
invert data

Related Commands Command Description

t1 linecode Specifies the type of linecoding used by the T1 channels on the CT3IP in
Cisco 7500 series routers.

Cisco IOS Interface and Hardware Component Command Reference

IR-261
 Interface and Hardware Component Commands
invert rxclock

invert rxclock
To invert the phase of the receive (RX) clock signal on the universal I/O (UIO) serial interface that does
not use the T1/E1 interface, use the invert rxclock command in interface configuration mode. To disable
the phase inversion, use the no form of this command.

invert rxclock

no invert rxclock

Syntax Description This command has no arguments or keywords.

Defaults The receive clock signal is not inverted.

Command Modes Interface configuration

Command History Release Modification

11.3 MA This command was introduced.

Usage Guidelines When a delay occurs between a signal being sent and the signal being received it can indicate that the
receive clock signal is not appropriate for the interface rate. This command allows the receive clock
signal to be inverted to attempt to correct the delay.

Examples The following example inverts the receive clock signal on serial interface 1:
Router(config)# interface serial 1
Router(config-if)# invert rxclock

Cisco IOS Interface and Hardware Component Command Reference

IR-262
 Interface and Hardware Component Commands
invert txclock

invert txclock
To invert the transmit (TX) clock signal, use the invert txclock command in interface configuration
mode. To return the TX clock signal to its initial state, use the no form of this command.

invert txclock

no invert txclock

Syntax Description This command has no arguments or keywords.

Defaults The transmit clock signal is not inverted.

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.
11.3 The invert-transmit-clock command was replaced by the invert txclock
command.

Usage Guidelines Delays between the serial clock transmit external (SCTE) clock and data transmission indicate that the
TX clock signal might not be appropriate for the interface rate and length of cable being used. Different
ends of the wire can have variances that differ slightly. The invert txclock command compensates for
these variances. This command replaces the invert-transmit-clock command.
Systems that use long cables or cables that are not transmitting the TxC signal (transmit echoed clock
line, also known as TXCE or SCTE clock) can experience high error rates when operating at the higher
transmission speeds. For example, if a PA-8T synchronous serial port adapter is reporting a high number
of error packets, a phase shift might be the problem. Inverting the clock might correct this shift.
When a PA-8T or PA-4T+ port adapter interface is DTE, the invert txclock command inverts the TxC
signal it received from the remote DCE. When the PA-8T or PA-4T+ port adapter interface is DCE, this
command changes the signal back to its original phase.

Examples The following example inverts the TX clock signal on serial interface 3/0:
Router(config)# interface serial 3/0
Router(config-if)# invert txclock

Cisco IOS Interface and Hardware Component Command Reference

IR-263
 Interface and Hardware Component Commands
ip dscp

ip dscp
To enable the use of IP differentiated services code point (DSCP) for packets that originate from a circuit
emulation (CEM) channel, use the ip dscp command in CEM configuration mode. To disable the use of
IP DSCP, use the no form of this command.

ip dscp [dscp-value]

no ip dscp

Syntax Description dscp-value Value placed in the DSCP field of IP packets that originate from a CEM
channel. Range is from 0 to 63. Default is 46.

Defaults IP DSCP is enabled.

Command Modes CEM configuration

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines DSCP is mutually exclusive from both IP type of service (ToS) and IP precedence. Thus, if DSCP is
configured, the ip tos command and the ip precedence command are both unavailable at the
command-line interface (CLI).

Examples The following example shows how to set the IP DSCP field value to 36.
Router(config-cem)# ip dscp 36

Related Commands Command Description

ip precedence Configures the IP precedence bits for the CEM channel.
ip tos Configures the IP ToS bits for the CEM channel.

Cisco IOS Interface and Hardware Component Command Reference

IR-264
 Interface and Hardware Component Commands
keepalive

keepalive
To enable keepalive packets and to specify the number of times that the Cisco IOS software tries to send
keepalive packets without a response before bringing down the interface or before bringing the tunnel
protocol down for a specific interface, use the keepalive command in interface configuration mode.
When the keepalive function is enabled, a keepalive packet is sent at the specified time interval to keep
the interface active. To turn off keepalive packets entirely, use the no form of this command.

keepalive [period [retries]]

no keepalive [period [retries]]

Syntax Description period (Optional) Integer value in seconds greater than 0. The default is 10.
retries (Optional) Specifies the number of times that the device will continue to send
keepalive packets without response before bringing the interface down. Integer
value greater than 1 and less than 255. If omitted, the value that was previously
set is used; if no value was specified previously, the default of 5 is used.
If using this command with a tunnel interface, specifies the number of times
that the device will continue to send keepalive packets without response before
bringing the tunnel interface protocol down.

Defaults period: 10 seconds

retries: 5
If you enter only the keepalive command with no arguments, defaults for both arguments are used.
If you enter only the keepalive command and the timeout parameter, the default number of retries (5) is
used.
If you enter the no keepalive command, keepalive packets are disabled on the interface.

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.
12.2(8)T The retries argument was added and made available on tunnel interfaces.
12.2(13)T The default value for the retries argument was increased to 5.

Usage Guidelines Keepalive Time Interval

You can configure the keepalive time interval, which is the frequency at which the Cisco IOS software
sends messages to itself (Ethernet and Token Ring) or to the other end (serial and tunnel), to ensure that
a network interface is alive. The interval is 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
unless the retry value is set higher.

Cisco IOS Interface and Hardware Component Command Reference

IR-265
 Interface and Hardware Component Commands
keepalive

Note Ethernet interface drivers on some access platforms use keepalive time as the interval to test for network
connectivity. By default, Ethernet link failure detection occurs between 1 and 9 seconds. Keepalive
packets are still transmitted on the interface during this time.

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

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

Keepalive Packets with Tunnel Interfaces

GRE keepalive packets may be sent from both sides of a tunnel, or from just one side. If they are sent
from both sides, the period and retry parameters can be different at each side of the link. If you configure
keepalives on only one side of the tunnel, the tunnel interface on the sending side might perceive the
tunnel interface on the receiving side to be down because the sending interface is not receiving
keepalives. From the receiving side of the tunnel, the link appears normal because no keepalives were
enabled on the second side of the link.

Dropped Packets
Keepalive packets are treated as ordinary packets, so it is possible that they will be dropped. To reduce
the chance that dropped keepalive packets will cause the tunnel interface to be taken down, increase the
number of retries.

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 may
need to experiment to determine the best values to use for the timeout and the number of
retry attempts.

GRE Tunnels with IPSec

When using GRE with IPSec, the keepalives are encrypted like any other traffic. As with user data
packets, if the IKE and IPSec security associations are not already active on the GRE tunnel, the first
GRE keepalive packet will trigger IKE/IPSec initialization.

Examples The following example shows how to set the keepalive interval to 3 seconds:
Router(config)# interface ethernet 0
Router(config-if)# keepalive 3

The following example shows how to set the keepalive interval to 3 seconds and the retry value to 7:
Router(config)# interface tunnel 1
Router(config-if)# keepalive 3 7

Cisco IOS Interface and Hardware Component Command Reference

IR-266
 Interface and Hardware Component Commands
lbo

lbo
To set a cable length longer than 655 feet for a DS-1 link, use the lbo command in interface configuration
mode on the interface for a T1 link. To delete the lbo value, use the no form of this command.

lbo {long {gain26 | gain36} {-15db | -22.5db | -7.5db | 0db} | short {133 | 266 | 399 | 533 | 655}}

no lbo

Syntax Description long Specifies the long-haul mode where the gain and line build out must be
configured.
gain26 Specifies the decibel pulse gain at 26 decibels. This is the default pulse
gain.
gain36 Specifies the decibel pulse gain at 36 decibels.
-15db Specifies the decibel pulse rate at –15 decibels.
-22.5db Specifies the decibel pulse rate at –22.5 decibels.
-7.5db Specifies the decibel pulse rate at –7.5 decibels.
0db Specifies the decibel pulse rate at 0 decibels. This is the default.
short Specifies the short-haul mode where the cable length, in feet, must be
configured.
133 Specifies a cable length from 0 to 133 feet.
266 Specifies a cable length from 134 to 266 feet.
399 Specifies a cable length from 267 to 399 feet.
533 Specifies a cable length from 400 to 533 feet.
655 Specifies a cable length from 534 to 655 feet.

Defaults gain26 and 0db

Command Modes Interface configuration

Command History Release Modification

11.3 MA This command was introduced as a Cisco MC3810 controller
configuration command.
12.0(5)XE The command was introduced as an ATM interface command.
12.0(7)XE1 This command was implemented on Cisco 7100 series routers.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.

Usage Guidelines This command is supported on T1 links only.

Each T1 port can operate in long-haul or short-haul mode. In long haul mode, the user must specify the
gain and the line build out. In short-haul mode, the user must specify the cable length in feet.

Cisco IOS Interface and Hardware Component Command Reference

IR-267
 Interface and Hardware Component Commands
lbo

The transmit attenuation value is best obtained by experimentation. If the signal received by the far-end
equipment is too strong, reduce the transmit level by entering additional attenuation.

Examples On Cisco 7100 or Cisco 7200 series routers, the following example specifies a pulse gain of 36 decibels
and a decibel pulse rate of –7.5 decibels:
Router(config)# interface atm 1/2
Router(config-if)# lbo long gain36 -7.5db

Cisco IOS Interface and Hardware Component Command Reference

IR-268
 Interface and Hardware Component Commands
linecode

linecode
To select the line-code type for T1 or E1 lines, use the linecode command in controller configuration
mode.

linecode {ami | b8zs | hdb3}

Syntax Description ami Specifies alternate mark inversion (AMI) as the line-code type. Valid for T1 or
E1 controllers. This is the default for T1 lines.
b8zs Specifies B8ZS as the line-code type. Valid for T1 controller only.
hdb3 Specifies high-density bipolar 3 (hdb3) as the line-code type. Valid for E1
controller only. This is the default for E1 lines.

Defaults AMI is the default for T1 lines.

High-density bipolar 3 is the default for E1 lines.

Command Modes Controller configuration

Command History Release Modification

10.3 This command was introduced.

Usage Guidelines Use this command in configurations in which the router or access server must communicate with T1
fractional data lines. The T1 service provider determines which line-code type, either ami or b8zs, is
required for your T1 circuit. Likewise, the E1 service provider determines which line-code type, either
ami or hdb3, is required for your E1 circuit.
This command does not have a no form.

Examples The following example specifies B8ZS as the line-code type:

Router(config-controller)# linecode b8zs

Cisco IOS Interface and Hardware Component Command Reference

IR-269
 Interface and Hardware Component Commands
line-mode

line-mode
To configure the controller to operate in two-wire or four-wire mode, or to configure automatic detection
of the line mode, use the line-mode command in controller configuration mode. This command specifies
the mode for the SHDSL port. To return to two-wire mode on line 0, use the no form of this command.

For CPE:

line-mode {2-wire line-number | 4-wire | auto}

no line-mode

For CO:

line-mode {2-wire line-number | 4-wire}

no line-mode

Syntax Description 2-wire Configures the controller to operate in two-wire mode. This is the default.
line-number Specifies the line number for two-wire mode operation. Valid values are
line-zero (default) or line-one. Line-zero selects RJ-11 pins 3 and 4;
line-one selects the RJ-11 pins 2 and 5.
4-wire Configures the controller to operate in four-wire mode.
auto For CPEs only. Configures the line mode to be automatically detected as
two-wire or four-wire. The decision is based on the configuration at the
remote connection. The local connection will be configured to match the
remote end configuration.

Defaults The default is two-wire mode if this command is omitted or if the 4-wire keyword is omitted. The default
uses Line 0, which is the first pair of wires.

Command Modes Controller configuration

Command History Release Modification

12.3(4)XD This command was introduced on Cisco 2600 series and Cisco 3700 series
routers.
12.3(4)XG This command was integrated into the Cisco IOS Release 12.3(4)XG on the
Cisco 1700 series routers.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T on
Cisco 2600 series, Cystic 3631, and Cystic 3700 series routers.
12.3(4)XG1 The line-number argument and the auto keyword were added.
12.3(11)T Support for auto-detection of line mode in two-wire and four-wire mode
was added.

Cisco IOS Interface and Hardware Component Command Reference

IR-270
 Interface and Hardware Component Commands
line-mode

Usage Guidelines This command is used to configure the controller for two-wire and four-wire mode. To operate in
four-wire mode for SHDSL, the line-mode command must be set to the 4-wire keyword.

Examples 4-Wire Line Mode Example

The following example configures the controller mode of DSL on the controller in slot 1 and port 0 to
verify the controller status:
Router(config)# controller dsl 1/0
Router(config-controller)# line-mode 4-wire

CPE Line Mode Example

The following example configures the controller in slot 1 and port 0. The router is set to terminate as
CPE with the line mode automatically selecting between two-wire mode and four-wire mode. The line
rate has not been set to the value of 4608 before and displays the output from the router.
Router(config)# controller dsl 1/0
Router(config-controller)# line-mode auto
Router(config-controller)# line-term cpe

Router(config-controller)# line-rate 4608

Router(config-controller)#
*Jun 15 17:39:49.680: %CONTROLLER-5-UPDOWN: Controller DSL 1/0, changed state tn
*Jun 15 17:39:51.680: %LINK-3-UPDOWN: Interface ATM1/0, changed state to down
*Jun 15 17:39:52.680: %LINEPROTO-5-UPDOWN: Line protocol on Interface ATM1/0, cn
*Jun 15 17:40:15.588: DSL 1/0 controller Link up! line rate: 4608 Kbps

*Jun 15 17:40:15.588: %CONTROLLER-5-UPDOWN: Controller DSL 1/0, changed state tp

*Jun 15 17:40:27.504: %LINK-3-UPDOWN: Interface ATM1/0, changed state to up
*Jun 15 17:40:28.504: %LINEPROTO-5-UPDOWN: Line protocol on Interface ATM1/0, cp
Router(config-controller)# exit

Related Commands Command Description

line-rate Specifies a line-rate for configuration and begins the line configuration
mode.
line-term Specifies a line-term for configuration and begins the line configuration
mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-271
 Interface and Hardware Component Commands
line-rate

line-rate
To specify a line rate for the DSL controller, use the line-rate command in controller configuration
mode. To return the line rate to the default, use the no form of this command.

line-rate {auto | rate}

no line-rate

Syntax Description auto Allows the controller to select the rate. This option is available only in
two-wire mode.
rate Sets the DSL line rate, in kbps. The line will train at the selected rate plus
8 kbps of DSL framing overhead. The supported line rates are as follows:
• For two-wire mode:
– 192, 256, 320, 384, 448, 512, 576, 640, 704, 768, 832, 896, 960,
1024, 1088, 1152, 1216, 1280, 1344, 1408, 1472, 1536, 1600,
1664, 1728, 1792, 1856, 1920, 1984, 2048, 2112, 2176, 2240, and
2304
• For four-wire mode:
– 384, 512, 640, 768, 896, 1024, 1152, 1280, 1408, 1536, 1664,
1792, 1920, 2048, 2176, 2304, 2432, 2560, 2688, 2816, 2944,
3072, 3200, 3328, 3456, 3584, 3712, 3840, 3968, 4096, 4224,
4352, 4480, and 4608

Defaults 2-wire mode: line rate is set to auto

4-wire mode: line rate is set to 4608

Command Modes Controller configuration

Command History Release Modification

12.3(4)XD This command was introduced on Cisco 2600 series and Cisco 3700 series
routers.
12.3(4)XG This command was integrated into the Cisco IOS Release 12.3(4)XG on the
Cisco 1700 series routers.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T on
Cisco 2600 series, Cisco 3631, and Cisco 3700 series routers.
12.3(11)T This command was integrated into Cisco IOS Release 12.3(11)T on
Cisco 2800 series and Cisco 3800 series routers.

Cisco IOS Interface and Hardware Component Command Reference

IR-272
 Interface and Hardware Component Commands
line-rate

Usage Guidelines This command specifies the DSL line rate for the SHDSL port.

Line Condition
The line rate setting is based on the condition of the physical line. If the line condition is good, a higher
rate can be used. When lesser quality exists on the line, use a slower rate.
If you set the line rate higher and the line condition is not good, the line will not drain. It might also flap
or produce CRCs. Reduce the line rate so that the packet delivery is more consistent.

Line Rate in Two-Wire or Four-Wire Mode

Use this command to configure the line rate in two-wire or four-wire mode.

SHDSL Rate
The SHDSL rate is in kbps, but the line trains at the selected rate plus 16 kbps in 4-wire mode and 8 kbps
in 2-wire mode of DSL framing overhead.

Note • Automatic rate mode (auto) is used only in two-wire mode. It is not available in four-wire mode.
• If different DSL line rates are configured at opposite ends of the DSL uplink, the actual DSL line
rate is always the lower rate.
• The maximum peak cell rate is 8 kbps less than the line rate.

Examples CPE with Line Mode Automatically Selected

The following example displays the configuration of the controller in slot 1 and port 0. The router is set
to terminate as CPE with the line mode automatically selecting between two-wire mode and four-wire
mode. The line rate is set to 4608 kbps.
Router(config)# controller dsl 1/0
Router(config-controller)# line-term cpe
Router(config-controller)# mode atm
Router(config-controller)# line-mode auto
No change in line mode

Router(config-controller)# line-rate ?
384, 512, 640, 768, 896, 1024, 1152, 1280, 1408, 1536, 1664, 1792, 1920, 2048, 2176, 2304,
2432, 2560, 2688, 2816, 2944, 3072, 3200, 3328, 3456, 3584, 3712, 3840, 3968, 4096, 4224,
4352, 4480, and 4608

Router(config-controller)# line-rate 4608

Router(config-controller)#
*Jun 15 17:39:49.680: %CONTROLLER-5-UPDOWN: Controller DSL 1/0, changed state tn
*Jun 15 17:39:51.680: %LINK-3-UPDOWN: Interface ATM1/0, changed state to down
*Jun 15 17:39:52.680: %LINEPROTO-5-UPDOWN: Line protocol on Interface ATM1/0, cn
*Jun 15 17:40:15.588: DSL 1/0 controller Link up! line rate: 4608 Kbps

*Jun 15 17:40:15.588: %CONTROLLER-5-UPDOWN: Controller DSL 1/0, changed state tp

*Jun 15 17:40:27.504: %LINK-3-UPDOWN: Interface ATM1/0, changed state to up
*Jun 15 17:40:28.504: %LINEPROTO-5-UPDOWN: Line protocol on Interface ATM1/0, cp
Router(config-controller)# exit

Cisco IOS Interface and Hardware Component Command Reference

IR-273
 Interface and Hardware Component Commands
line-rate

Four-Wire Mode
The following example displays first the line-mode command, which is used to select the four-wire
mode, followed by the line-rate command. The Cisco IOS help is used to display the available line rates.
The rate of 4608 is selected, and the output of the router is shown.
Router(config)# controller dsl 1/0
Router(config-controller)# line-mode 4-wire
Router(config-controller)#
*Jun 15 18:00:48.159: %CONTROLLER-5-UPDOWN: Controller DSL 1/0, changed state tn
*Jun 15 18:00:50.159: %LINK-3-UPDOWN: Interface ATM1/0, changed state to down
*Jun 15 18:00:51.159: %LINEPROTO-5-UPDOWN: Line protocol on Interface ATM1/0, cn
Router(config-controller)#
Router(config-controller)# line-rate 4608
Router(config-controller)#
*Jun 15 18:01:36.627: %CONTROLLER-5-UPDOWN: Controller DSL 1/0, changed state tn
*Jun 15 18:01:36.967: %CONTROLLER-5-UPDOWN: Controller DSL 1/0, changed state tn
Router(config-controller)# exit

Related Commands Command Description

line-mode Configures the controller to operate in two-wire or four-wire mode.
line-term Specifies a line-term for configuration and begins the line configuration
mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-274
 Interface and Hardware Component Commands
line-term

line-term
To specify a termination for the line, use the line-term command in controller configuration mode. To
the default line termination value of cpe, use the no form of this command to return.

line-term {co | cpe}

no line-term

Syntax DescriptionC co Central office.

cpe Customer premises equipment (default value).

Defaults The default value is cpe.

Command Modes Controller configuration

Command History Release Modification

12.3(4)XD This command was introduced on Cisco 2600 series and Cisco 3700 series
routers.
12.3(4)XG This command was integrated into Cisco IOS Release 12.3(4)XG on the
Cisco 1700 series routers.
12.3(7)T This command was integrated in Cisco IOS Release 12.3(7)T on
Cisco 2600 series, Cisco 3631, and Cisco 3700 series routers.
12.3(11)T This command was implemented on Cisco 2800 series and Cisco 3800
series routers.

Usage Guidelines This command is used to configure the line termination for use as either the central office (CO) or the
customer premises equipment (CPE).

Examples The following example displays the configuration of the controller in slot 1 and port 0. The router is set
to terminate as CPE with the line mode automatically selecting between two-wire mode and four-wire
mode.
Router(config)# controller dsl 1/0
Router(config-controller)# line-term cpe
Router(config-controller)# mode atm
Router(config-controller)# line-mode auto
No change in line mode

Cisco IOS Interface and Hardware Component Command Reference

IR-275
 Interface and Hardware Component Commands
line-term

Related Commands Command Description

line-mode Configures the controller to operate in two-wire or four-wire mode.
line-rate Specifies a line rate for configuration and begins the line configuration
mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-276
 Interface and Hardware Component Commands
line-termination

line-termination
To set the line termination on an E1 controller, use the line-termination command in controller
configuration mode. To return to the default line termination, use the no form of this command.

line-termination {75-ohm | 120-ohm}

no line-termination

Syntax Description 75-ohm Specifies 75-ohm unbalanced termination.

120-ohm Specifies 120-ohm balanced termination. This is the default.

Defaults 120-ohms

Command Modes Controller configuration

Command History Release Modification

11.3(2)AA This command was introduced.

Usage Guidelines This command applies only to E1 controllers. To determine the line termination setting for the controller,
use the show controllers e1 command.

Examples In the following example, the line termination is set to 75 ohms for the E1 port located in shelf 6, slot 0,
port 0:
Router# configure terminal
Router(config)# controller e1 6/0/0
Router(config-controller)# line-termination 75-ohm
Router(config-controller)# end

Related Commands Command Description

show controllers e1 Displays information about the E1 links supported by the NPM (Cisco 4000)
or MIP (Cisco 7500 series).

Cisco IOS Interface and Hardware Component Command Reference

IR-277
 Interface and Hardware Component Commands
link-test

link-test
To reenable the link-test function on a port on an Ethernet hub of a Cisco 2505 or Cisco 2507 router, use
the link-test command in hub configuration mode. To disable this function, use the no form of this
command.

link-test

no link-test

Syntax Description This command has no arguments or keywords.

Defaults Enabled

Command Modes Hub configuration

Command History Release Modification

10.3 This command was introduced.

Usage Guidelines This command applies to a port on an Ethernet hub only. Disable this feature if a 10Base-T twisted-pair
device at the other end of the hub does not implement the link test function.

Examples The following example disables the link test function on hub 0, ports 1 through 3:
Router(config)# hub ethernet 0 1 3
Router(config-hub)# no link-test

Related Commands Command Description

hub Enables and configures a port on an Ethernet hub of a Cisco 2505 or
Cisco 2507 router.

Cisco IOS Interface and Hardware Component Command Reference

IR-278
 Interface and Hardware Component Commands
local ip address

local ip address
To define an IP address to identify a local circuit emulation (CEM) channel, use the local ip address
command in CEM xconnect configuration mode.

local ip address ip-address

Syntax Description ip-address IP address of a regular or loopback interface in the local router. Default is
0.0.0.0

Defaults The default local IP address is 0.0.0.0.

Command Modes CEM xconnect configuration

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines The local IP address used to identify the local end of a CEM connection must be the same as the IP
address defined by the remote-ip-address argument used in the xconnect command to identify the CEM
channel at the other end of the CEM connection.

Note If there are multiple CEM connections that originate from the same router, they may share the same
local IP address provided that each local IP address defines a unique UDP port number using the
local udp port command.

Examples The following example demonstrates how to configure the IP address of the local endpoint of the CEM
over IP (CEoIP) connection.
Router(config-cem-xconnect)# local ip address 10.0.5.1

Related Commands Command Description

clear cem Clears CEM statistics.
local udp port Defines the UDP port at the local end of a CEM connection.
show cem Displays CEM statistics.
xconnect (CEM) Builds one end of a CEM connection and enters CEM xconnect
configuration mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-279
 Interface and Hardware Component Commands
local udp port

local udp port

To define the User Datagram Protocol (UDP) port of the local endpoint of a circuit emulation (CEM)
connection, use the local udp port command in CEM xconnect configuration mode.

local udp port port

Syntax Description port Number of the CEM local UDP port. Possible values are 0, 2141, and 15872
through 16383. The default is 0.

Defaults The default local UDP port number is 0.

Command Modes CEM xconnect configuration

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines This command does not have a no form. To remove a local UPD port number either configure a new UPD
port number or enter the no xconnect command to disable the connection and all its parameters.

Examples The following example demonstrates how to configure the UDP port of the local endpoint of the CEM
over IP (CEMoIP) connection.
Router(config-cem-xconnect)# local udp port 2141

Related Commands Command Description

remote udp port Defines the UDP port of the remote endpoint of a CEM connection.
show cem Displays CEM channel statistics.
xconnect (CEM) Builds one end of a CEM connection and enters CEM xconnect
configuration mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-280
 Interface and Hardware Component Commands
local-lnm

local-lnm
To enable Lanoptics Hub Networking Management of a PCbus Token Ring interface, use the local-lnm
command in interface configuration mode. To disable Lanoptics Hub Networking Management, use the
no form of this command.

local-lnm

no local-lnm

Syntax Description This command has no arguments or keywords.

Defaults Management is not enabled.

Command Modes Interface configuration

Command History Release Modification

10.3 This command was introduced.

Usage Guidelines The Token Ring interface on the AccessPro PC card can be managed by a remote LAN manager over the
PCbus interface. At present, the Lanoptics Hub Networking Management software running on an IBM
compatible PC is supported.

Examples The following example enables Lanoptics Hub Networking Management:

Router(config-if)# local-lnm

Cisco IOS Interface and Hardware Component Command Reference

IR-281
 Interface and Hardware Component Commands
logging event

logging event
To enable notification of interface, subinterface, and Frame Relay data link connection identifier (DLCI)
data link status changes, use the logging event command in interface configuration mode. To disable
notification, use the no form of this command.

logging event {dlci-status-change | link-status | subif-link-status}

no logging event {dlci-status-change | link-status | subif-link-status}

Syntax Description dlci-status-change Enables notification of Frame Relay DLCI status changes.
Note This option is supported only when the encapsulation on the
interface is Frame Relay.
link-status Enables notification of interface data link status changes.
subif-link-status Enables notification of subinterface data link status changes.

Defaults For system images, notification of interface, subinterface, and Frame Relay DLCI data link status
changes is enabled by default.
For boot images, notification of Frame Relay subinterface and DLCI data link status changes is disabled
by default. Notification of interface data link status changes is enabled by default.

Command Modes Interface configuration

Command History Release Modification

12.0 This command was introduced.

Examples The following example shows how to enable notification of subinterface link status changes:
Router(config-if)# logging event subif-link-status

The following are examples of Frame Relay DLCI and subinterface status change notification messages
filtered by the logging event command:
00:16:22: %FR-5-DLCICHANGE: Inteface Serial3/0/0:1 - DLCI 105 state changed to INACTIVE
00:16:22: %LINEPROTO-5-UPDOWN: Line protocol on Interface Serial3/0/0:1.5, changed state
to down

Cisco IOS Interface and Hardware Component Command Reference

IR-282
 Interface and Hardware Component Commands
logging-events

logging-events
to print typical T3 controller Up and Down messages on a Channelized T3 Port Adapter, use the
logging-events command in T3 controller configuration mode. Use the no form of this command to
disable printing of the T3 controller Up and Down messages.

logging-events [detail]

[no] logging-events

Syntax Description detail (Optional) Enables printing the reason code when a T3 controller changes
from the Up to Down state.

Defaults The logging-events command is the default.

Command Modes T3 controller configuration

Command History Release Modification

12.2(19c) This command was introduced.

Usage Guidelines When the no logging-events command disables printing of the T3 controller Up and Down messages,
these messages will neither appear on the console nor in the logs.

Examples The following example uses the logging-events [detail] command to show the Out-of-Frame (OOF)
reason code when the T3 controller changes from an Up state to a Down state:
Router(config-controller)# logging-events detail

*Jun 19 17:47:50: %CONTROLLER-5-DOWNDETAIL: Controller T3 4/1, changed state to down due

to OOF

Related Commands Command Description

t1 logging-events Prints the typical T1 controller Up and Down messages on a channelized T3
port adapter.

Cisco IOS Interface and Hardware Component Command Reference

IR-283
 Interface and Hardware Component Commands
loopback (CEM)

loopback (CEM)
To set the loopback method for testing a T1, E1, or serial CEM interface, use the loopback command in
controller configuration or CEM configuration mode. To remove any existing loopback, use the no form
of this command.

Cisco NM-CEM-4SER

loopback {local | network}

no loopback

Cisco NM-CEM-4TE1

loopback {local {payload | line} | network}

no loopback

Syntax Description local Places the interface into local loopback mode and creates a loopback
wherein information received from the locally-attached customer premises
equipment (CPE) is transmitted back to the locally-attached CPE.
• payload—(Used only if a local loopback is specified for a T1/E1
channel) Creates a loopback of only the data in individual time slots. In
this mode, framing bits are terminated and then regenerated instead of
being looped back. This mode is not available if the port is configured
for framing unframed.
• line—(Used only if a local loopback is specified for a T1/E1 channel)
Creates a full physical layer loopback of all bits, including data and
framing bits.
network Creates a loopback wherein data received over the network from the remote
CPE is transmitted back to the remote CPE.

Defaults No loopback is configured.

Command Modes Cisco NM-CEM-4SER

CEM configuration

Cisco NM-CEM-4TE1
Controller configuration

Command History Release Modification

12.3(7)T This command was introduced.

Cisco IOS Interface and Hardware Component Command Reference

IR-284
 Interface and Hardware Component Commands
loopback (CEM)

Usage Guidelines Use this command to create a loopback for a CEM interface. You can use a loopback to test for
equipment malfunction caused by the interface.
The NM-CEM-4TE1 does not respond to loopback requests initiated by the CPE, locally attached or
remote, using the extended super frame (ESF) Facility Data Link (FDL) mechanism or by any other
mechanism.
The NM-CEM-4SER does not respond to any form of loopback request initiated by the locally attached
or remote CPE on the Local Loop (LL) or Remote Loop (RL) control leads. Nor does the
NM-CEM-4SER respond to any form of loopback request initiated by the locally attached or remote CPE
using in-band loopback codes.

Examples The following example shows how to create a loopback on a CEM T1/E1 interface so that data received
from a remote CPE is transmitted back to the remote CPE on the network.
Router(config-controller)# loopback network

The following example shows how to create a loopback of data in individual time slots on a CEM T1/E1
interface. Data received from a locally attached CPE will be sent back to the locally attached CPE.
Router(config-controller)# loopback local payload

The following example shows how to create a loopback on a serial CEM channel so that data received
from a remote CPE is transmitted back to the remote CPE on the network.
Router(config-cem)# loopback network

Related Commands Command Description

cem Enters circuit emulation configuration mode.
controller Enters controller configuration mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-285
 Interface and Hardware Component Commands
loopback (DSL controller)

loopback (DSL controller)

To test the controller and configure the core loopback, use the loopback (DSL Controller) command in
controller configuration mode. To remove the loopback interface, use the no form of this command.

loopback {analog | digital}

no loopback

Syntax Description analog Loops the circuit at the analog hybrid to verify the analog loopback
hardware to the analog hybrid.
digital Loops the circuit at the framer to verify the hardware to the framer.

Defaults No default behavior or values.

Command Modes Controller configuration

Command History Release Modification

12.3(4)XD This command was introduced on Cisco 2600 series and Cisco 3700 series
routers.
12.3(4)XG This command was integrated into Cisco IOS Release 12.3(4)XG on the
Cisco 1700 series routers.
12.3(7)T This command was integrated in Cisco IOS Release 12.3(7)T on
Cisco 2600 series, Cisco 3631, and Cisco 3700 series routers.
12.3(11)T This command was integrated into Cisco IOS Release 12.3(11)T on
Cisco 2800 series and Cisco 3800 series routers.

Usage Guidelines Analog and digital loopbacks are local loopbacks. Digital loopbacks loop the circuit at the framer to
verify the hardware to the framer, and analog loopbacks loop the circuit at the analog hybrid to verify
the analog loopback hardware to the analog hybrid. The controller must be shut down before loopback
can be configured.

Examples If the controller is still up, the router will prompt you to turn the controller off as shown in this example:
Router(config-controller)# loopback analog
Please shut down the xDSL controller
Router(config-controller)# loopback digital
Please shut down the xDSL controller

The following example shows the configuration of a loopback digital interface:

Router(config-controller)# loopback digital
Please shut down the xDSL controller
Router(config-controller)# shutdown
Router(config-controller)#

Cisco IOS Interface and Hardware Component Command Reference

IR-286
Interface and Hardware Component Commands
loopback (DSL controller)

00:59:50: %CONTROLLER-5-UPDOWN: Controller DSL 0/0, changed state to

administratively down
Router(config-controller)#
Router(config-controller)# loopback digital
Router(config-controller)# no shutdown
Apr 23 06:59:01.435: DSL 0/0 controller Link up! line rate: 4608 Kbps
o
00:59:59: %CONTROLLER-5-UPDOWN: Controller DSL 0/0, changed state to up
Router(config-controller)#end

Router# show controllers dsl 0/0

DSL 0/0 controller UP

Local Digital loopback is running
Globespan xDSL controller chipset
DSL mode: SHDSL Annex B
Frame mode: Utopia
Configured Line rate: 4608Kbps
Line Re-activated 4 times after system bootup
LOSW Defect alarm: ACTIVE
CRC per second alarm: ACTIVE
Line termination: CO
FPGA Revision: 0xA7

Line 0 statistics

Current 15 min CRC: 679

Current 15 min LOSW Defect: 8
Current 15 min ES: 5
Current 15 min SES: 5
Current 15 min UAS: 397

Previous 15 min CRC: 0

Previous 15 min LOSW Defect: 0
Previous 15 min ES: 0
Previous 15 min SES: 0
Previous 15 min UAS: 0

Line 1 statistics

Current 15 min CRC: 577

Current 15 min LOSW Defect: 8
Current 15 min ES: 7
Current 15 min SES: 4
Current 15 min UAS: 411

Previous 15 min CRC: 0

Previous 15 min LOSW Defect: 0
Previous 15 min ES: 0
Previous 15 min SES: 0
Previous 15 min UAS: 0

Line-0 status
Chipset Version: 1
Firmware Version: A29733
Modem Status: un checked mode, Status 83
Last Fail Mode: No Failure status:0x0
Line rate: 2312 Kbps
Framer Sync Status: In Sync
Rcv Clock Status: In the Range
Loop Attenuation: 0.0 dB
Transmit Power: 13.5 dB
Receiver Gain: 936.8420 dB

Cisco IOS Interface and Hardware Component Command Reference

IR-287
 Interface and Hardware Component Commands
loopback (DSL controller)

SNR Sampling: 16.960 dB

Line-1 status
Chipset Version: 1
Firmware Version: A29733
Modem Status: un checked mode, Status 83
Last Fail Mode: No Failure status:0x0
Line rate: 2312 Kbps
Framer Sync Status: In Sync
Rcv Clock Status: In the Range
Loop Attenuation: 0.0 dB
Transmit Power: 13.5 dB
Receiver Gain: 936.8420 dB
SNR Sampling: 16.3590 dB
Dying Gasp: Present

Related Commands Command Description

show interfaces Displays information about the loopback interface.
loopback

Cisco IOS Interface and Hardware Component Command Reference

IR-288
 Interface and Hardware Component Commands
loopback (E3 controller)

loopback (E3 controller)

To loop an entire E3 line toward the line and back toward the router, use the loopback command in
controller configuration mode. To remove the loop, use the no form of this command.

loopback {local | network {line | payload}}

no loopback

Syntax Description local Loops the data back toward the router and sends an AIS signal out
toward the network. This is the default.
network {line | payload} Sets the loopback toward the network either before going through the
framer (line) or after going through the framer (payload).

Defaults local

Command Modes Controller configuration

Command History Release Modification

11.3 This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and
implemented on the following platforms for E3: Cisco 2650XM,
Cisco 2651XM, Cisco 2691, Cisco 3660 series, Cisco 3725, and
Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.

Usage Guidelines Use this command for troubleshooting purposes. To verify that a loopback is configured on the interface,
use the show controllers e3 EXEC command. Note that line loopback is available only in C-bit parity
mode.

Examples The following example shows how to configure the controller located in slot 1, port 0 for a local
loopback:
Router(config)# controller e3 1/0
Router(config-controller)# loopback local

Related Commands Command Description

show controllers e3 Displays information about the E3 controllers.

Cisco IOS Interface and Hardware Component Command Reference

IR-289
 Interface and Hardware Component Commands
loopback (interface)

loopback (interface)
To diagnose equipment malfunctions between the interface and device, use the loopback command in
interface configuration mode. To disable the test, use the no form of this command.

loopback

no loopback

Syntax Description This command has no arguments or keywords.

Defaults Disabled

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines Loopback on HSSI Cards

On High-Speed Serial Interface (HSSI) cards, the loopback function configures a two-way internal and
external loop on the HSA applique of the specific interface.

Loopback on MCI and SCI Serial Interface Cards

On MCI and SCI serial interface cards, the loopback functions when a CSU/DSU or equivalent device
is attached to the router or access server. The loopback command loops the packets through the
CSU/DSU to configure a CSU loop, when the device supports this feature.

Loopback on MCI and MEC Ethernet Cards

On the MCI and MEC Ethernet cards, the interface receives back every packet it sends when the
loopback command is enabled. Loopback operation has the additional effect of disconnecting network
server functionality from the network.

Loopback on CSC-FCI FDDI Cards

On the CSC-FCI FDDI card, the interface receives back every packet it sends when the loopback
command is enabled. Loopback operation has the additional effect of disconnecting network server
functionality from the network.

Loopback on Token Ring Interface Cards

On all Token Ring interface cards (except the 4-megabit CSC-R card), the interface receives back every
packet it sends when the loopback command is enabled. Loopback operation has the additional effect
of disconnecting network server functionality from the network.

Cisco IOS Interface and Hardware Component Command Reference

IR-290
 Interface and Hardware Component Commands
loopback (interface)

Active Loopback Interfaces

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

Note Loopback does not work on an X.21 DTE because the X.21 interface definition does not include a
loopback definition.

Examples The following example configures the loopback test on Ethernet interface 4:
Router(config)# interface ethernet 4
Router(config-if)# loopback

Related Commands Command Description

down-when-looped Configures an interface to inform the system it is down when loopback is
detected.
show interfaces Displays information about the loopback interface.
loopback

Cisco IOS Interface and Hardware Component Command Reference

IR-291
 Interface and Hardware Component Commands
loopback (J1 controller )

loopback (J1 controller )

To set the loopback method for testing the J1 interface, use the loopback command in controller
configuration mode. To turn off loopback, use the no form of this command. This command should be
used for testing purposes only.

loopback {local | line | isolation}

no loopback {local | line | isolation}

Syntax Description local Places the interface into local loopback mode.
line Places the interface into external loopback mode at the line level.
isolation Places the interface into both local and line loopback mode.

Defaults No loopback is configured.

Command Modes Controller configuration

Command History Release Modification

11.3 MA This command was implemented on the Cisco MC3810.
12.0(5)T and 12.0(7)XR The command was implemented on the Cisco 2600 and Cisco 3600 series.
12.0(5)XE The command was implemented on the Cisco 7200 and Cisco 7500 series.
12.1(1)T The command was implemented on the Cisco 2600 series.
12.2(8)T The command was implemented on the Cisco 2600 and Cisco 3600 series.

Examples The following example establishes a loopback of the incoming J1 signal on controller J1 3/0:
Router(config)# controller j1 3/0
Router(config-controller)# loopback line

Cisco IOS Interface and Hardware Component Command Reference

IR-292
 Interface and Hardware Component Commands
loopback (PA-MC-8TE1+ port adapter)

loopback (PA-MC-8TE1+ port adapter)

To enable loopback testing of data for the PA-MC-8TE1+ port adapter, use the loopback command in
interface configuration mode. To disable loopback testing, use the no form of this command.

loopback [internal | line]

no loopback [internal | line]

Syntax Description internal (Optional) Loops any data received at the PA-MC-8TE1+ port adapter’s
network interface back into the PA-MC-8TE1+ port adapter.
line (Optional) Loops any data received at the PA-MC-8TE1+ port adapter’s
network interface back into the network.

Defaults Loopback mode is not enabled.

Command Modes Interface configuration

Command History Release Modification

12.2(13)T This command was introduced.

Examples In the following example, a loopback is set for the PA-MC-8TE1+ port adapter in slot 2:
Router(config)# interface 2/0
Router(config-if)# loopback line

Cisco IOS Interface and Hardware Component Command Reference

IR-293
 Interface and Hardware Component Commands
loopback (T1 interface)

loopback (T1 interface)

To loop individual T1 channels on the CT3IP in Cisco 7000 series routers that have the RSP7000 and
RSP7000CI and in Cisco 7500 series routers, use the loopback command in interface configuration
mode. To remove the loopback, use the no form of this command.

loopback [local | network {line | payload} | remote {line {fdl {ansi | bellcore} | inband} |
payload [fdl] [ansi]}]

no loopback

Syntax Description local (Optional) Loops the router output data back toward the router at the T1
framer and sends an alarm indication signal (AIS) signal out toward
the network.
network {line | payload} (Optional) Loops the data back toward the network before the T1
framer and automatically sets a local loopback at the High-Level Data
Link Control (HDLC) controllers (line), or loops the payload data back
toward the network at the T1 framer and automatically sets a local
loopback at the HDLC controllers (payload).
remote line fdl {ansi | (Optional) Sends a repeating, 16-bit Extended Superframe (ESF) data
bellcore} link code word (00001110 11111111 for FDL ANSI and 00010010
11111111 for FDL Bellcore) to the remote end requesting that it enter
into a network line loopback. Specify the ansi keyword to enable the
remote line Facility Data Link (FDL) ANSI bit loopback on the T1
channel, per the ANSI T1.403 specification. Specify the bellcore
keyword to enable the remote SmartJack loopback on the T1 channel,
per the TR-TSY-000312 specification.
remote line inband (Optional) Sends a repeating, 5-bit inband pattern (00001) to the remote
end requesting that it enter into a network line loopback.
remote payload [fdl] [ansi] (Optional) Sends a repeating, 16-bit ESF data link code word
(00010100 11111111) to the remote end requesting that it enter into a
network payload loopback. Enables the remote payload FDL ANSI bit
loopback on the T1 channel.
You can optionally specify fdl and ansi, but it is not necessary.

Defaults No loopback is configured.

Command Modes Interface configuration

Command History Release Modification

11.1 CA This command was introduced.

Usage Guidelines Use this command for troubleshooting purposes.

Cisco IOS Interface and Hardware Component Command Reference

IR-294
 Interface and Hardware Component Commands
loopback (T1 interface)

To better diagnose T1 provisioning problems, you can place the remote CSU or remote SmartJack into
loopback. The loopback remote line fdl interface configuration command allows you to place either the
CSU or the SmartJack into loopback:
• ansi—Places the CSU into loopback, per the ANSI T1.403 Specification.
• bellcore—Places the SmartJack into loopback, per the TR-TSY-000312 Specification.
When both are configured, transmission of loss of frame (LOF) indication (yellow alarm) takes priority
over transmission of some facilities data link (FDL) messages.
If the remote loopback appears not to be working, use the show controllers t3 command to determine
if the given T1 is currently attempting to transmit a LOF indication (yellow alarm):
Router# show controllers t3 0/0/0:2

T3 0/0/0 is up.
CT3 H/W Version: 5, CT3 ROM Version: 1.2, CT3 F/W Version: 2.5.9
Mx H/W version: 2, Mx ucode ver: 1.34

T1 2 is down, speed: 1536 kbs, non-inverted data

timeslots: 1-24
FDL per AT&T 54016 spec.
Transmitter is sending LOF Indication.
Receiver is getting AIS.

If the transmitter is sending a LOF indication, as in the previous example, stop the transmission of the
LOF indication (yellow alarm) with the no t1 yellow generation configuration command as shown in
the following example:
Router(config)# controllers t3 0/0/0
Router(config-controller)# no t1 2 yellow generation
Router(config-controller)# Ctrl-D

To verify that the transmission of the LOF indication (yellow alarm) has stopped, use the
show controllers t3 command:
Router# show controllers t3 0/0/0:2

T3 0/0/0 is up.
CT3 H/W Version: 5, CT3 ROM Version: 1.2, CT3 F/W Version: 2.5.9
Mx H/W version: 2, Mx ucode ver: 1.34
T1 2 is down, speed: 1536 kbs, non-inverted data
timeslots: 1-24
FDL per AT&T 54016 spec.
Receiver is getting AIS.
Framing is ESF, Line Code is B8ZS, Clock Source is Internal.
Yellow Alarm Generation is disabled

Then retry the remote loopback command. When diagnosis is complete, remember to reenable the LOF
indication (yellow alarm).
You can also loopback all the T1 channels by using the loopback (CT3IP) interface configuration
command.

Examples The following example configures T1 channel 5 for a local loopback:

Router(config)# interface serial 3/0/0:5
Router(config-if)# loopback local

Cisco IOS Interface and Hardware Component Command Reference

IR-295
 Interface and Hardware Component Commands
loopback (T1 interface)

Related Commands Command Description

loopback (T3 controller) Loops the entire T3 (all 28 T1 channels) on the CT3IP in Cisco 7500
series routers.
t1 yellow generation Enables detection and generation of yellow alarms for a T1 channel on
the CT3IP in Cisco 7500 series routers.

Cisco IOS Interface and Hardware Component Command Reference

IR-296
 Interface and Hardware Component Commands
loopback (T3 controller)

loopback (T3 controller)

To loop the entire T3 (all 28 T1 channels) line on the T3 controller or on the CT3IP in Cisco 7500 series
routers, use the loopback command in controller configuration mode. To remove the loop, use the no
form of this command.

loopback {local | network {line | payload} | remote}

no loopback

Syntax Description local Loops the data back toward the router and sends an alarm indication
signal (AIS) out toward the network.
network {line | payload} Sets the loopback toward the network either before going through the
framer (line) or after going through the framer (payload).
remote Sends a far-end alarm control (FEAC) request to the remote end
requesting that it enter into a network line loopback. FEAC requests
(and therefore remote loopbacks) are possible only when the T3 is
configured for C-bit framing. The M23 format does not support remote
loopbacks.

Defaults No loops are configured on the T3 line.

Command Modes Controller configuration

Command History Release Modification

11.3 This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and
implemented on the following platforms for T3: Cisco 2650XM,
Cisco 2651XM, Cisco 2691, Cisco 3660 series, Cisco 3725, and Cisco 3745
routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.

Usage Guidelines Use this command for troubleshooting purposes. To verify that a loopback is configured on the interface,
use the show controllers T3 EXEC command. Note that remote loopback is available only in C-bit
parity mode.
You can also loopback each T1 channel by using the loopback interface configuration command for T1.
For more information, refer to the “Troubleshooting the T3 and T1 Channels” section in the
“Configuring Serial Interfaces” chapter of the Cisco IOS Interface and Hardware Component
Configuration Guide.

Examples The following example configures the T3 or CT3IP for a local loopback:

Cisco IOS Interface and Hardware Component Command Reference

IR-297
 Interface and Hardware Component Commands
loopback (T3 controller)

Router(config)# controller t3 3/0/0

Router(config-controller)# loopback local

Related Commands Command Description

framing Selects the frame type for the T1 or E1 data line.
loopback (interface) Places the specified module in loopback mode.
loopback remote (interface) Loops packets through a CSU/DSU, over a DS3 link or a channelized
T1 link, to the remote CSU/DSU and back.
show controllers t3 Displays information about the T3 controllers.

Cisco IOS Interface and Hardware Component Command Reference

IR-298
 Interface and Hardware Component Commands
loopback (T3/E3 interface)

loopback (T3/E3 interface)

To loop the serial interface on a PA-T3 or PA-E3 port adapter, use the loopback command in interface
configuration mode. To remove the loopback, use the no form of this command.

PA-T3 Port Adapter

loopback {dte | local | network {line | payload} | remote}

no loopback

PA-E3 Port Adapter

loopback {dte | local | network {line | payload}}

no loopback

Syntax Description dte Sets the loopback after the line interface unit (LIU) toward the terminal.
local Sets the loopback after going through the framer toward the terminal.
network {line | payload} Sets the loopback toward the network before going through the framer
(line) or after going through the framer (payload).
remote Sends a far-end alarm control (FEAC) to set the remote framer in
loopback.

Defaults No loops are configured on the serial interface.

Command Modes Interface configuration

Command History Release Modification

11.1 CA This command was introduced.

Usage Guidelines Use this command for troubleshooting purposes.

To verify that a loopback is configured on the interface, use the show interfaces serial or show
interfaces loopback command.

Examples The following example configures the serial interface located in slot 3/0/0 for a local loopback:
Router(config)# interface serial 3/0/0
Router(config-if)# loopback local

Cisco IOS Interface and Hardware Component Command Reference

IR-299
 Interface and Hardware Component Commands
loopback (T3/E3 interface)

Related Commands Command Description

show controllers serial Displays information that is specific to the interface hardware.
show interfaces loopback Displays information about the loopback interface.
show interfaces serial Displays information about a serial interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-300
 Interface and Hardware Component Commands
loopback applique

loopback applique
To configure an internal loop on the High-Speed Serial Interface (HSSI) applique, use the loopback
applique command in interface configuration mode. To remove the loop, use the no form of this
command.

loopback applique

no loopback applique

Syntax Description This command has no arguments or keywords.

Defaults No loops are configured on the HSSI applique.

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines This command loops the packets within the applique to provide a way to test communication within the
router or access server. It is useful for sending pings to yourself to check functionality of the applique.
To show a specific interface that is currently in loopback operation, use the show interfaces loopback
EXEC command.

Examples The following example configures the loopback test on the HSSI applique:
Router(config)# interface serial 1
Router(config-if)# loopback applique

Related Commands Command Description

show interfaces loopback Displays information about the loopback interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-301
 Interface and Hardware Component Commands
loopback dte

loopback dte
To loop packets back to the DTE from the CSU/DSU, when the device supports this function, use the
loopback dte command in interface configuration mode. To remove the loop, use the no form of this
command.

loopback dte

no loopback dte

Syntax Description This command has no arguments or keywords.

Defaults No loops are configured.

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines This command is useful for testing the DTE-to-DCE cable.
This command is used to test the performance of the integrated CSU/DSU. Packets are looped from
within the CSU/DSU back to the serial interface of the router. Send a test ping to see if the packets
successfully looped back. To cancel the loopback test, use the no loopback dte command.
When using the 4-wire 56/64-kbps CSU/DSU module, an out-of-service signal is transmitted to the
remote CSU/DSU.
To show a specific interface that is currently in loopback operation, use the show interfaces loopback
EXEC command.

Examples The following example configures the loopback test on the DTE interface:
Router(config)# interface serial 0
Router(config-if)# loopback dte

Related Commands Command Description

show interfaces loopback Displays information about the loopback interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-302
 Interface and Hardware Component Commands
loopback line

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

loopback line [payload]

no loopback line [payload]

Syntax Description payload (Optional) Configures a loopback point at the DSU and loops data back to the
network on an integrated CSU/DSU.

Defaults No loops are configured.

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines This command is useful for testing the DCE device (CSU/DSU) itself. When the loopback line
command is configured on the 2-wire 56-kbps CSU/DSU module or the 4-wire 56/64-kbps CSU/DSU
modules, the network data loops back at the CSU and the router data loops back at the DSU. If the
CSU/DSU is configured for switched mode, you must have an established connection to perform a
payload-line loopback. To loop the received data through the minimum amount of CSU/DSU circuitry,
issue the loopback line command.
When you issue the loopback line payload command on an integrated CSU/DSU module, the router
cannot transmit data through the serial interface for the duration of the loopback. Choosing the DSU as
a loopback point loops the received-network data through the maximum amount of CSU/DSU circuitry.
Data is not looped back to the serial interface. An active connection is required when operating in
switched mode for payload loopbacks.
If you enable the loopback line command on the fractional T1/T1 module, the CSU/DSU performs a
full-bandwidth loopback through the CSU portion of the module and data transmission through the serial
interface is interrupted for the duration of the loopback. No reframing or corrections of bipolar violation
errors or cyclic redundancy check (CRC) errors are performed. When you configure the loopback line
payload command on the FT1/T1 module, the CSU/DSU performs a loopback through the DSU portion
of the module. The loopback line payload command reframes the data link, regenerates the signal, and
corrects bipolar violations and Extended Super Frame CRC errors.
When performing a T1-line loopback with Extended Super Frame, communication over the facilities
data link is interrupted, but performance statistics are still updated. To show interfaces currently in
loopback operation, use the show service-module EXEC command.
To show interfaces that are currently in loopback operation on other routers, use the show interfaces
loopback EXEC command.

Cisco IOS Interface and Hardware Component Command Reference

IR-303
 Interface and Hardware Component Commands
loopback line

Examples The following example configures the loopback test on the DCE device:
Router(config)# interface serial 1
Router(config-if)# loopback line

The following example shows how to configure a payload loopback on a Cisco 2524 or Cisco 2525
router:
Router1(config-if)# loopback line payload
Loopback in progress
Router1(config-if)# no loopback line

The following example shows the output on a Cisco 2524 or Cisco 2525 router when you loop a packet
in switched mode without an active connection:
Router1(config-if)# service-module 56k network-type switched
Router1(config-if)# loopback line payload
Need active connection for this type of loopback
% Service module configuration command failed: WRONG FORMAT.

Related Commands Command Description

show interfaces loopback Displays information about the loopback interface.
show service-module Displays the performance report for an integrated CSU/DSU.

Cisco IOS Interface and Hardware Component Command Reference

IR-304
 Interface and Hardware Component Commands
loopback remote (interface)

loopback remote (interface)

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

FT1/T1 CSU/DSU Modules

loopback remote {full | payload | smart-jack} [0in1 | 1in1 | 1in2 | 1in5 | 1in8 | 3in24 | qrw |
user-pattern 24-bit-binary-value]

no loopback remote {full | payload | smart-jack}

2- and 4-Wire, 56/64-kbps CSU/DSU Modules

loopback remote [2047 | 511 | stress-pattern pattern-number]

no loopback remote

Syntax Description full Transmits a full-bandwidth line loopback request to a remote device, which is
used for testing.
payload Transmits a payload line loopback request to a remote device, which is used
for testing the line and remote DSU.
smart-jack Transmits a loopback request to the remote smart jack, which some service
providers attach on the line before the customer premises equipment (CPE).
You cannot put the local smart jack into loopback.
0in1 (Optional) Transmits an all-zeros test pattern used for verifying B8ZS line
encoding. The remote end might report a loss of signal when using alternate
mark inversion (AMI) line coding.
1in1 (Optional) Transmits an all-ones test pattern used for signal power
measurements.
1in2 (Optional) Transmits an alternating ones-and-zeroes test pattern used for
testing bridge taps.
1in5 (Optional) Transmits the industry-standard test-pattern loopback request.
1in8 (Optional) Transmits a test pattern used for stressing timing recovery of
repeaters.
3in24 (Optional) Transmits a test pattern used for testing the ones density tolerance
on AMI lines.
qrw (Optional) Transmits a quasi-random word test pattern, which is a random
signal that simulates user data.
user-pattern (Optional) Transmits a test pattern that you define. Enter a binary string up to
24-bit-binary-value 24 bits long. For the fixed patterns such 0in1 and 1in1, the T1 framing bits are
jammed on top of the test pattern; for the user-pattern, the pattern is simply
repeated in the time slots.

Cisco IOS Interface and Hardware Component Command Reference

IR-305
 Interface and Hardware Component Commands
loopback remote (interface)

2047 (Optional) Transmits a pseudorandom test pattern that repeats after 2047 bits.
511 (Optional) Transmits a pseudorandom test pattern that repeats after 511 bits.
stress-pattern (Optional) Transmits a DDS stress pattern available only on the 4-wire
pattern-number 56/64-kbps CSU/DSU module. You may enter a stress pattern from 1 to 4.
A 1 pattern sends 100 bytes of all 1s and then 100 bytes of all 0s to test the
stress clocking of the network. A 2 pattern sends 100 bytes of a 0x7e pattern
and then 100 bytes of all 0s. A 3 pattern sends continuous bytes of a 0x46
pattern. A 4 pattern sends continuous bytes of a 0x02 pattern.

Defaults No remote loopback interface is configured.

Command Modes Interface configuration

Command History Release Modification

11.0 This command was introduced.

Usage Guidelines This command is used for testing the data communication channels along with or without remote
CSU/DSU circuitry. The loopback is usually performed at the line port, rather than the DTE port, of the
remote CSU/DSU.
For a multiport interface processor 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 if 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.”
For the integrated FT1/T1 CSU/DSU module, the loopback remote full command sends the loopup code
to the remote CSU/DSU. The remote CSU/DSU performs a full-bandwidth loopback through the CSU
portion of the module. The loopback remote payload command sends the loopup code on the
configured time slots, while maintaining the D4-extended super frame. The remote CSU/DSU performs
the equivalent of a loopback line payload request. The remote CSU/DSU loops back only those time slots
that are configured on the remote end. This loopback reframes the data link, regenerates the signal, and
corrects bipolar violations and extended super frame CRC errors. The loopback remote smart-jack
command sends a loopup code to the remote smart jack. You cannot put the local smart jack into
loopback.
Failure to loopup or initiate a remote loopback request could be caused by enabling the
no service-module t1 remote-loopback command or having an alternate remote-loopback code
configured on the remote end. When the loopback is terminated, the result of the pattern test is displayed.
For the 2- and 4-wire, 56/64-kbps CSU/DSU module, an active connection is required before a loopup
can be initiated while in switched mode. When transmitting V.54 loopbacks, the loopback mode is
initiated on the remote device using V.54 messages. Failure to loopup or initiate a remote loopback
request could be caused by enabling the no service-module 56k remote-loopback command.

Cisco IOS Interface and Hardware Component Command Reference

IR-306
 Interface and Hardware Component Commands
loopback remote (interface)

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

Examples Example for Remote Loopback Test

The following example configures a remote loopback test:
Router(config)# interface serial 0
Router(config-if)# loopback remote

Example of Full-Bandwidth Line Loopback

The following example configures the remote device into full-bandwidth line loopback while specifying
the qrw test pattern over the T1 CSU/DSU module on a Cisco 2524 or Cisco 2525 router:
Router(config)# interface serial 0
Router(config-if)# loopback remote full qrw
Router(config-if)#
%LINEPROTO-5-UPDOWN: Line protocol on Interface Serial0, changed state to down
%LINK-3-UPDOWN: Interface Serial0, changed state to down
%SERVICE_MODULE-5-LOOPUPREMOTE: Unit 0 - Remote unit placed in loopback

Example of Loopback Stress Pattern

The following example transmits a remote loopback stress pattern over the 4-wire, 56/64-kbps
CSU/DSU module, which tests the stress clocking of the network:
Router(config-if)# loopback remote stress-pattern 1
Router(config-if)#
%LINEPROTO-5-UPDOWN: Line protocol on Interface Serial1, changed state to down
%LINK-3-UPDOWN: Interface Serial1, changed state to down
%SERVICE_MODULE-5-LOOPUPREMOTE: Unit 1 - Remote unit placed in loopback

Related Commands Command Description

clear service-module serial Resets an integrated CSU/DSU.
loopback dte Loops packets back to the DTE device from the CSU/DSU.
loopback line Loops packets completely through the CSU/DSU to
configure the CSU loop.
service-module 56k Enables the acceptance of a remote loopback request on a
remote-loopback serial interface on a 2- or 4-wire, 56/64-kbps CSU/DSU
module.
service-module t1 remote-loopback Specifies whether the fractional T1/T1 CSU/DSU module
enters loopback mode when it receives a loopback code on
the line.
show interfaces loopback Displays information about the loopback interface.
show service-module serial Displays the performance report for an integrated CSU/DSU.

Cisco IOS Interface and Hardware Component Command Reference

IR-307
 Interface and Hardware Component Commands
main-fiber port

main-fiber port
To specify the port number to use for the optical link connection on the SDH/STM-1 trunk card on a
Cisco AS5850, use the main-fiber port command in controller configuration mode.

main-fiber port {0 | 1}

Syntax Description 0 Specifies use of port 0 as the optical link connection. This is the default.
1 Specifies use of port 1 as the optical link connection.

Defaults Port 0

Command Modes Controller configuration

Command History Release Modification

12.2(15)T This command was introduced.

Usage Guidelines Use the main-fiber controller configuration command if you need to use optical port 1 during
installation of the SDH/STM-1 trunk card on a Cisco AS5850 or if you suspect some problem with
optical port 0.
This command does not have a no form. To restore the default value, use the main-fiber port 0
command.

Examples The following example selects port 1 as the port with the optical connection:
Router(config)# controller sonet 1/0
Router(config-controller)# main-fiber port 1

Cisco IOS Interface and Hardware Component Command Reference

IR-308
 Interface and Hardware Component Commands
mdl

mdl
To configure the Maintenance Data Link (MDL) message defined in the ANSI T1.107a-1990
specification, use the mdl command in controller configuration mode. To remove the message, use the
no form of this command.

mdl {transmit {path | idle-signal | test-signal} | string {eic | lic | fic | unit | pfi | port | generator}
string}

no mdl {transmit {path | idle-signal | test-signal} | string {eic | lic | fic | unit | pfi | port
| generator} string}

Syntax Description transmit path Enables transmission of the MDL Path message.
transmit idle-signal Enables transmission of the MDL Idle Signal message.
transmit test-signal Enables transmission of the MDL Test Signal message.
string eic string Specifies the Equipment Identification Code; can be up to 10 characters.
string lic string Specifies the Location Identification Code; can be up to 11 characters.
string fic string Specifies the Frame Identification Code; can be up to 10 characters.
string unit string Specifies the Unit Identification Code; can be up to 6 characters.
string pfi string Specifies the Path Facility Identification Code sent in the MDL Path
message; can be up to 38 characters.
string port string Specifies the Port number string sent in the MDL Idle Signal message;
can be up to 38 characters.
string generator string Specifies the Generator number string sent in the MDL Test Signal
message; can be up to 38 characters.

Defaults No MDL message is configured.

Command Modes Controller configuration

Command History Release Modification

11.3 This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and
implemented on the following platforms: Cisco 2650XM, Cisco 2651XM,
Cisco 2691, Cisco 3660 series, Cisco 3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.

Usage Guidelines Use the show controllers t3 command to display MDL information (received strings). MDL information
is displayed only when framing is set to C-bit.

Cisco IOS Interface and Hardware Component Command Reference

IR-309
 Interface and Hardware Component Commands
mdl

Note MDL is supported only when the DS3 framing is C-bit parity.

Examples The following example shows the mdl commands on a T3 controller in slot 1, port 0:
Router(config)# controller t3 1/0
Router(config-controller)# clock source line
Router(config-controller)# mdl string eic ID
Router(config-controller)# mdl string fic Building B
Router(config-controller)# mdl string unit ABC
Router(config-controller)# mdl string pfi Facility Z
Router(config-controller)# mdl string port Port 7
Router(config-controller)# mdl transmit path
Router(config-controller)# mdl transmit idle-signal

Related Commands Command Description

show controllers t3 Displays information about T3 controllers.

Cisco IOS Interface and Hardware Component Command Reference

IR-310
 Interface and Hardware Component Commands
media-type

media-type
To specify the physical connection on an interface, use the media-type command in interface
configuration mode. To restore the default value, use the no form of this command.

media-type {aui | 10baset | 100baset | mii}

no media-type {aui | 10baset | 100baset | mii}

Syntax Description aui Selects an AUI 15-pin physical connection. This is the default on Cisco 4000 series
routers.
10baset Selects an R-J45 10BASE-T physical connection.
100baset Specifies an RJ-45 100BASE-T physical connection. This is the default on Cisco 7000
series and Cisco 7200 series routers.
mii Specifies a media-independent interface.

Defaults An AUI 15-pin physical connection is the default setting on Cisco 4000 series routers.
A 100BASE-T physical connection is the default setting on Cisco 7000 series and Cisco 7200 series
routers.

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines To specify the physical connection on an interface, use the following interface configuration:
• Ethernet network interface module configuration on Cisco 4000 series routers
• Fast Ethernet Interface Processor (FEIP) on Cisco 7000 series, 7200 series, and 7500 series routers
• Full-duplex or half-duplex mode on a serial interface

Examples The following example selects an RJ-45 10BASE-T physical connection on Ethernet interface 1:
Router(config)# interface ethernet 1
Router(config-if)# media-type 10baset

The following example specifies a media-independent interface physical connection to Fast Ethernet
slot 0, port 1 on the Cisco 7000 or Cisco 7200 series:
Router(config)# interface fastethernet 0/1
Router(config-if)# media-type mii

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

Cisco IOS Interface and Hardware Component Command Reference

IR-311
 Interface and Hardware Component Commands
media-type

Router(config)# interface fastethernet 0/1/1

Router(config-if)# media-type mii

Cisco IOS Interface and Hardware Component Command Reference

IR-312
 Interface and Hardware Component Commands
microcode reload controller

microcode reload controller

To reload the firmware and field programmable gate array (FPGA) without reloading the Cisco IOS image,
use the microcode reload controller command in privileged EXEC mode.

microcode reload controller j1 slot/port

Syntax Description j1 J1 controller.

slot/port Backplane slot number and port number on the controller.

Defaults No microcode reload activity is initiated.

Command Modes Privileged EXEC

Command History Release Modification

12.1(2)XH This command was introduced.
12.1(3)T This command was integrated into Cisco IOS Release 12.1(3)T.
12.2(8)T The j1 keyword was added.

Usage Guidelines Configurations such as loopbacks in the running configuration are restored after this command is
entered. If the controller is in a looped state before this command is issued, the looped condition is
dropped. You have to re-initiate the loopbacks from the remote end by doing no loop from the controller
configuration.

Examples The following example show how to start the microcode reload activity:
Router# microcode reload controller j1 3/0

TDM-connections and network traffic will be briefly disrupted.

Proceed with reload microcode?[confirm]
Router#
*Mar 3 209.165.200.225: clk_src_link_up_down: Status of this CLK does not matter

*Mar 3 209.165.200.226: clk_src_link_up_down: Status of this CLK does not matter

*Mar 3 209.165.200.227: %CONTROLLER-5-UPDOWN: Controller J1 3/0, changed state to)

*Mar 3 209.165.200.227: clk_src_link_up_down: Status of this CLK does not matter

*Mar 3 209.165.200.228: clk_src_link_up_down: Status of this CLK does not matter

*Mar 3 209.165.200.229: %CONTROLLER-5-UPDOWN: Controller J1 3/0, changed state top

*Mar 3 209.165.200.229: clk_src_link_up_down: Status of this CLK does not matter

*Mar 3 209.165.200.229: clk_src_link_up_down: Status of this CLK does not matter

Cisco IOS Interface and Hardware Component Command Reference

IR-313
 Interface and Hardware Component Commands
mode (ATM/T1/E1 controller)

mode (ATM/T1/E1 controller)

To set the DSL controller into ATM mode and create an ATM interface or to set the T1 or E1 controller
into T1 or E1 mode and create a logical T1/E1 controller, use the mode command in controller
configuration mode. To disable the current mode and prepare to change modes, use the no form of this
command.

Cisco 3700 Series, Cisco 2800 Series, Cisco 3800 Series

mode atm

no mode atm

Cisco 1700 Series, Cisco 2600XM Platform,

mode {atm | t1 | e1}

no mode {atm | t1 | e1}

Cisco IAD2430

mode {atm [aim aim-slot] | cas | t1 | e1}

no mode {atm [aim aim-slot] | cas | t1 | e1}

Syntax Description atm Sets the controller into ATM mode and creates an ATM interface (ATM 0).
When ATM mode is enabled, no channel groups, DS0 groups, PRI groups,
or time-division multiplexing (TDM) groups are allowed, because ATM
occupies all the DS0s on the T1/E1 trunk.
When you set the controller to ATM mode, the controller framing is
automatically set to extended super frame (ESF) for T1 or cyclic
redundancy check type 4 (CRC4) for E1. The line code is automatically set
to binary 8-zero substitution (B8ZS) for T1 or high-density bipolar C
(HDBC) for E1. When you remove ATM mode by entering the no mode
atm command, ATM interface 0 is deleted.
Note The mode atm command without the aim keyword uses software to
perform ATM segmentation and reassembly (SAR). This is
supported on Cisco 2600 series WIC slots only; it is not supported
on network module slots.
aim (Optional) The configuration on this controller uses the Advanced
Integration Module (AIM) in the specified slot for ATM SAR. The aim
keyword does not apply to the Cisco IAD2430 series IAD.
aim-slot (Optional) AIM slot number on the router chassis:
• Cisco 2600 series—0.
• Cisco 3660—0 or 1.

Cisco IOS Interface and Hardware Component Command Reference

IR-314
 Interface and Hardware Component Commands
mode (ATM/T1/E1 controller)

cas (Cisco 2600 series WIC slots only) Channel-associated signaling (CAS)
mode. The T1 or E1 in this WIC slot is mapped to support T1 or E1 voice
(that is, it is configured in a DS0 group or a PRI group).
CAS mode is supported on both controller 0 and controller 1.
On the Cisco IAD2430 series IAD, CAS mode is not supported.
t1 Sets the controller into T1 mode and creates a T1 interface.
When you set the controller to T1 mode, the controller framing is
automatically set to ESF for T1. The line code is automatically set to B8ZS
for T1.
e1 Sets the controller into E1 mode and creates an E1 interface.
When you set the controller to E1 mode, the controller framing is
automatically set to CRC4 for E1. The line code is automatically set to
HDB3 for E1.

Defaults The controller mode is disabled.

Command Modes Controller configuration

Command History Release Modification

11.3 MA This command was introduced on the Cisco MC3810.
12.1(5)XM Support for this command was extended to the merged SGCP/MGCP
software.
12.2(2)T This command was integrated into Cisco IOS Release 12.2(2)T.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T for the
Cisco IAD2420 IADs.
12.2(2)XB Support was extended to the Cisco 2600 series and Cisco 3660. The
keyword aim and the argument aim-slot were added. The parenthetical
modifier for the command was changed from “Voice over ATM” to “T1/E1
controller.”
12.2(15)T This command was implemented on the Cisco 2691 and the Cisco 3700
series.
12.3(4)XD This command was integrated into Cisco IOS Release 12.3(4)XD on
Cisco 2600 series and Cisco 3700 series routers to configure DSL Frame
mode and to add T1/E1 Framed support.
12.3(4)XG This command was integrated into Cisco IOS Release 12.3(4)XG on the
Cisco 1700 series routers.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T on
Cisco 2600 series and Cisco 3700 series routers.
12.3(11)T This command was implemented on Cisco 2800 and Cisco 3800 series
routers.

Cisco IOS Interface and Hardware Component Command Reference

IR-315
 Interface and Hardware Component Commands
mode (ATM/T1/E1 controller)

Usage Guidelines When a DSL controller is configured in ATM mode, the mode must be configured identically on both
the CO and CPE sides. Both sides must be set to ATM mode.

Note If using the no mode atm command to leave ATM mode, the router must be rebooted immediately to
clear the mode.

When configuring a DSL controller in T1 or E1 mode, the mode must be configured identically on the
CPE and CO sides.

Examples ATM Mode Example

The following example configures ATM mode on the DSL controller.
Router(config)# controller dsl 3/0
Router(config-controller)# mode atm

T1 Mode Example
The following example configures T1 mode on the DSL controller.
Router(config)# controller dsl 3/0
Router(config-controller)# mode t1

Related Commands Command Description

channel-group Configures a list of time slots for voice channels on controller T1 0 or E1 0.
tdm-group Configures a list of time slots for creating clear channel groups
(pass-through) for time-division multiplexing (TDM) cross-connect.

Cisco IOS Interface and Hardware Component Command Reference

IR-316
 Interface and Hardware Component Commands
mode download

mode download
To enable operational code download mode for the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT), use the mode download command in satellite initial configuration mode.
To disable operational code download mode, use the no form of this command.

mode download

no mode download

Syntax Description This command has no arguments or keywords.

Defaults Operational code download mode is enabled.

Command Modes Satellite initial configuration

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your
satellite service provider instructs you to perform the satellite initial configuration and provides all
necessary parameter values.

Examples The following example shows how to disable operational code download mode:
Router(sat-init-config)# no mode download

Cisco IOS Interface and Hardware Component Command Reference

IR-317
 Interface and Hardware Component Commands
mode (HSA redundancy)

mode (HSA redundancy)

To configure the redundancy mode, use the mode command in redundancy configuration mode. To
configure the default redundancy mode, use the no form of this command.

mode {hsa | rpr | rpr-plus}

no mode {hsa | rpr | rpr-plus}

Syntax Description hsa Selects High System Availability (HSA) redundancy mode. This is the
default.
rpr Selects Route Processor Redundancy (RPR) mode.
rpr-plus Selects RPR Plus (RPR+) redundancy mode.

Defaults HSA redundancy mode

Command Modes Redundancy configuration

Command History Release Modification

12.0(16)ST This command was introduced.
12.0(19)ST1 The rpr-plus keyword was added.
12.0(22)S This command was integrated into Cisco IOS Release 12.0(22)S.
12.2(14)S This command was integrated into Cisco IOS Release 12.2(14)S.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.

Usage Guidelines The mode selected by the mode command in redundancy configuration mode must be fully supported
by the image that has been installed in both the active and standby Route Switch Processors (RSPs). A
high availability image must be installed in the RSPs before RPR+ can be configured. Use the
hw-module slot image command to specify a high availability image to run on the standby RSP.
If the mode cannot be set on both RSPs, HSA is the default mode. A Cisco 7507 or Cisco 7513 router
that has only one RSP installed operates in single Route Processor mode.

Examples The following example enters redundancy configuration mode and sets RPR+ as the redundancy mode
for a Cisco 7500 series router.
Router(config)# redundancy
Router(config-r)# mode rpr-plus
Router(config-r)# end

Cisco IOS Interface and Hardware Component Command Reference

IR-318
 Interface and Hardware Component Commands
mode (HSA redundancy)

Related Commands Command Description

hw-module sec-cpu reset Resets and reloads the standby RSP with the specified Cisco IOS
image and executes the image.
hw-module slot image Specifies a high availability Cisco IOS image to run on an active or
standby RSP.
redundancy Enters redundancy configuration mode.
redundancy force-switchover Switches control of a router from the active RSP to the standby RSP.
show redundancy Displays the current redundancy mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-319
 Interface and Hardware Component Commands
mode (RSC redundancy)

mode (RSC redundancy)

To choose between classic-split mode (maximum throughput with no load sharing) and handover-split
mode (maximum availability with load sharing), use the mode command in redundancy configuration
mode. To reset to the default mode, use the no form of this command.

mode {classic-split | handover-split}

no mode

Syntax Description classic-split Nonredundant mode in which slots are split in a fixed 6/6 pattern between
the two route-switch-controller (RSC) cards, and no handover occurs. This
is the default.
handover-split Redundant mode in which, if one RSC fails, the peer RSC takes over control
of the failed RSC’s resources (slots and cards).

Defaults Classic-split mode

Command Modes Redundancy configuration

Command History Release Modification

12.2(2)XB1 This command was introduced.
12.2(11)T This command was integrated into Cisco IOS Release 12.2(11)T.

Usage Guidelines You must be connected to an RSC card on your Cisco AS5850 to use this command.

Examples The following example selects handover-split mode:

Router(config)# redundancy
Router(config-r)# mode handover-split

Related Commands Command Description

show chassis Displays, for a router with two RSCs, information about mode
(handover-split or classic-split), RSC configuration, and slot
ownership.
show chassis clocks Displays all configured clock sources, even those from non-owned
cards. This is because only one RSC can provide the master clock,
and it may need to have backup clock sources configured from all
cards present, regardless of ownership.
show context Displays information about specified slots.
show redundancy debug-log Displays up to 256 redundancy-related debug entries.

Cisco IOS Interface and Hardware Component Command Reference

IR-320
 Interface and Hardware Component Commands
mode (T1/E1 controller)

mode (T1/E1 controller)

To set the T1 or E1 controller into asynchronous transfer mode (ATM) and create an ATM interface, to
set the T1 or E1 controller into T1 or E1 mode and create a logical T1 or E1 controller, or to set the T1
or E1 controller into channel-associated signaling (CAS) mode, use the mode command in controller
configuration mode. To disable the current mode and prepare to change modes, use the no form of this
command.

mode {atm [aim aim-slot] | cas | t1 | e1}

no mode {atm [aim aim-slot] | cas | t1 | e1}

Syntax Description atm Sets the controller into ATM mode and creates an ATM interface (ATM 0).
When ATM mode is enabled, no channel groups, DS0 groups, PRI groups,
or time-division multiplexing (TDM) groups are allowed, because ATM
occupies all the DS0s on the T1/E1 trunk.
When you set the controller to ATM mode, the controller framing is
automatically set to extended super frame (ESF) for T1 or cyclic
redundancy check type 4 (CRC4) for E1. The line code is automatically set
to binary 8-zero substitution (B8ZS) for T1 or high-density binary 3
(HDB3) for E1. When you remove ATM mode by entering the no mode atm
command, ATM interface 0 is deleted.
Note The mode atm command without the aim keyword uses software to
perform ATM segmentation and reassembly (SAR). This is
supported on Cisco 2600 series WIC slots only and is not supported
on network module slots.
aim (Optional) The configuration on this controller uses the Advanced
Integration Module (AIM) in the specified slot for ATM SAR. The aim
keyword does not apply to the Cisco IAD2420 series IAD.
aim-slot (Optional) AIM slot number on the router chassis. For the Cisco 2600
series, the AIM slot number is 0; for the Cisco 3660, the AIM slot number
is 0 or 1.
cas (CAS mode on Cisco 2600 series WIC slots only) The T1 or E1 in this WIC
slot is mapped to support T1 or E1 voice (it is configured in a DS0 group or
a PRI group).
CAS mode is supported on both controller 0 and controller 1.
t1 (Cisco 2600XM series using the G.SHDSL WIC only) Sets the controller
into T1 mode and creates a T1 interface.
When you set the controller to T1 mode, the controller framing is
automatically set to ESF for T1. The line code is automatically set to B8ZS
for T1.
e1 (Cisco 2600XM series using the G.SHDSL WIC only) Sets the controller
into E1 mode and creates an E1 interface.
When you set the controller to E1 mode, the controller framing is
automatically set to CRC4 for E1. The line code is automatically set to
HDB3 for E1.

Cisco IOS Interface and Hardware Component Command Reference

IR-321
 Interface and Hardware Component Commands
mode (T1/E1 controller)

Defaults No controller mode is configured.

Command Modes Controller configuration

Command History Release Modification

11.3 MA This command was introduced on the Cisco MC3810.
12.1(5)XM Support for this command was extended to Simple Gateway Control
Protocol (SGCP) and Media Gateway Control Protocol (MGCP).
12.2(2)T This command was integrated into Cisco IOS Release 12.2(2)T and
implemented on the Cisco 7200 series.
12.2(2)XB Support was extended to the Cisco 2600 series and Cisco 3660. The aim
keyword and the aim-slot argument were added. The parenthetical modifier
for the command was changed from “Voice over ATM” to “T1/E1
controller.”
12.2(8)T This command was implemented on the Cisco IAD2420 series.
12.2(11)T This command was implemented on the Cisco AS5300 and Cisco AS5850.
12.2(15)T This command was implemented on the Cisco 2691 and the Cisco 3700
series.
12.3(4)XD Support was extended on Cisco 2600 series and Cisco 3700 series routers to
configure DSL Frame mode and to add T1/E1 Framed support.
12.3(7)T The support that was added in Cisco IOS Release 12.3(4)XD was integrated
into Cisco IOS Release 12.3(7)T.

Usage Guidelines This command has the following platform-specific usage guidelines:

Cisco 2600 Series, Cisco 3660 Routers, or Cisco 3700 Series Rotuers That Use AIM for ATM Processing
You must use the mode atm aim aim-slot command.

Cisco 2600 Series Routers: For AIM for DSP Processing and That Specify DS0 Groups
You must use the mode cas command if using WIC slots for voice. This command does not apply if
network modules are being used.

Cisco 3660 Routers or Cisco 3700 Series That Use an AIM Only for DSP Resources
Do not use this command.

On Cisco 2600 Series Routers That Use WIC Slots for Voice
The mode atm command without the aim keyword specifies software ATM segmentation and
reassembly. When the aim keyword is used with the mode atm command, the AIM performs ATM
segmentation and reassembly.

On Cisco 2600 Series and Cisco 3700 Series Routers That Configure a DSL Controller in ATM Mode,
The mode must be set to the same mode on both the CO and CPE sides. Both sides must be set to ATM
mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-322
 Interface and Hardware Component Commands
mode (T1/E1 controller)

If the no mode atm command is used to leave ATM mode, the router must be rebooted immediately to
clear the mode.

On Cisco 2600 Series and Cisco 3700 Series RoutersWith a DSL Controller in T1 or E1 Mode
The mode must be configured identically on the CO and CPE sides.

Examples ATM Mode for Voice Over ATM

The following example configures ATM mode on controller T1 0. This step is required for Voice over
ATM.
Router(config)# controller t1 0
Router(config-controller)# mode atm

ATM Mode on Cisco 2600 Series Router with AIM

The following example configures ATM mode on controller T1 1/ 0 on a Cisco 2600 series router using
an AIM in slot 0 for ATM segmentation and reassembly:
Router(config)# controller t1 1/0
Router(config-controller)# mode atm aim 0

ATM Mode on DSL Controller

The following example configures ATM mode on the DSL controller.
Router(config)# controller dsl 3/0
Router(config-controller)# mode atm

CAS Mode on T1 Controller

The following example configures CAS mode on controller T1 1 on a Cisco 2600 series router:
Router(config)# controller t1 1
Router(config-controller)# mode cas

T1 Mode on DSL Controller

The following example configures T1 mode on the DSL controller.
Router(config)# controller dsl 3/0
Router(config-controller)# mode t1

Related Commands Command Description

channel-group Defines the time slots for voice channels on controller T1 0 or E1 0.
tdm-group Configures a list of time slots for creating clear channel groups
(pass-through) for TDM cross-connect.

Cisco IOS Interface and Hardware Component Command Reference

IR-323
 Interface and Hardware Component Commands
mode two-way

mode two-way
To enable two-way operational mode for the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT), use the mode two-way command in satellite initial configuration mode.
To revert to one-way operational mode, use the no form of this command.

mode two-way

no mode two-way

Syntax Description This command has no arguments or keywords.

Defaults Two-way mode is enabled.

Command Modes Satellite initial configuration

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your
satellite service provider instructs you to perform the satellite initial configuration and provides all
necessary parameter values.

Examples The following example shows how to specify two-way operational mode:
Router(sat-init-config)# mode two-way

The following example shows how to specify one-way operational mode:

Router(sat-init-config)# no mode two-way

Cisco IOS Interface and Hardware Component Command Reference

IR-324
 Interface and Hardware Component Commands
modem dtr-delay

modem dtr-delay
To control the time that a data terminal ready (DTR) signal is held down when a line clears, use the
modem dtr-delay command in line configuration mode. To restore the default hold down time, use the
no form of this command.

modem dtr-delay seconds

no modem dtr-delay seconds

Syntax Description seconds Number of seconds. The default is 5.

Defaults The default DTR signal hold down time is 5 seconds.

Command Modes Line configuration

Command History Release Modification

12.1 This command was introduced.

Usage Guidelines Use this command to reduce the time that a DTR signal is held down after an asynchronous line clears
and before the DTR signal is raised again to accept new calls. Incoming calls may be rejected in heavily
loaded systems even when modems are unused because the default DTR hold down interval may be too
long. The modem dtr-delay command is designed for lines used for an unframed asynchronous session
such as Telnet. Lines used for a framed asynchronous session such as PPP should use the pulse-time
interface command.

Examples The following example shows how to specify a DTR hold down interval of 2 seconds:
Router(config)# line 7
Router(config-line)# modem dtr-delay 2

Related Commands Command Description

pulse-time Enables pulsing DTR signal intervals on serial interfaces.

Cisco IOS Interface and Hardware Component Command Reference

IR-325
 Interface and Hardware Component Commands
mop enabled

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

mop enabled

no mop enabled

Syntax Description This command has no arguments or keywords.

Defaults Enabled on Ethernet interfaces and disabled on all other interfaces.

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Examples The following example enables MOP for serial interface 0:

Router(config)# interface serial 0
Router(config-if)# mop enabled

Related Commands Command Description

mop retransmit-timer Configures the length of time that the Cisco IOS software waits before
sending boot requests again to a MOP server.
mop retries Configures the number of times the Cisco IOS software will send boot
requests again to a MOP server.
mop sysid Enables an interface to send out periodic MOP system identification
messages.

Cisco IOS Interface and Hardware Component Command Reference

IR-326
 Interface and Hardware Component Commands
mop sysid

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

mop sysid

no mop sysid

Syntax Description This command has no arguments or keywords.

Defaults Enabled

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

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

Examples The following example enables serial interface 0 to send MOP system identification messages:
Router(config)# interface serial 0
Router(config-if)# mop sysid

Related Commands Command Description

mop device-code Identifies the type of device sending MOP sysid messages and request
program messages.
mop enabled Enables an interface to support the MOP.

Cisco IOS Interface and Hardware Component Command Reference

IR-327
 Interface and Hardware Component Commands
mtu

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

mtu bytes

no mtu

Syntax Description bytes MTU size, in bytes.

Defaults Table 12 lists default MTU values according to media type.

Table 12 Default Media MTU Values

Media Type Default MTU (Bytes)

Ethernet 1500
Serial 1500
Token Ring 4464
ATM 4470
FDDI 4470
HSSI (HSA) 4470

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

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

Note Changing an MTU size on a Cisco 7500 series router results in the recarving of buffers and
resetting of all interfaces. The following message is displayed:

%RSP-3-Restart:cbus complex.

Cisco IOS Interface and Hardware Component Command Reference

IR-328
 Interface and Hardware Component Commands
mtu

Protocol-Specific Versions of the mtu Command

Changing the MTU value with the mtu interface configuration command can affect values for the
protocol-specific versions of the command (the ip mtu command, for example). If the value 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.

ATM and LANE Interfaces

ATM interfaces are not bound by what is configured on the major interface. By default, MTU on a
subinterface is equal to the default MTU (4490); if a client is configured the default is 1500. MTU can
be changed on subinterfaces, but it may result in recarving of buffers to accommodate the new maximum
MTU on the interface.

Examples The following example specifies an MTU of 1000 bytes:

Router(config)# interface serial 1
Router(config-if)# mtu 1000

Related Commands Command Description

encapsulation smds Enables SMDS service on the desired interface.
ip mtu Sets the MTU size of IP packets sent on an interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-329
 Interface and Hardware Component Commands
national bit (controller)

national bit (controller)

To set the E3 national bit in the G.751 frame used by the E3 controller, use the national bit command
in controller configuration mode. To return to the default E3 controller national bit, use the no form of
this command.

national bit {0 | 1}

no national bit

Syntax Description 0 Sets the E3 national bit in the G.751 frame to 0.

1 Sets the E3 national bit in the G.751 frame to 1. This is the default.

Defaults The default value is 1.

Command Modes Controller configuration

Command History Release Modification

11.1 CA This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and
implemented on the following platforms: Cisco 2650XM, Cisco 2651XM,
Cisco 2691, Cisco 3660 series, Cisco 3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.

Usage Guidelines When G.751 framing is used, bit 11 of the G.751 frame is reserved for national use and is set to 1 by
default.
Configure national bit 1 only when required for interoperability with your telephone company.
To verify the national bit configured on the interface, use the show controllers serial EXEC command.

Examples The following example sets the national bit to 1 on an E3 controller in slot 1, port 0:
Router(config)# controller e3 1/0
Router(config-controller)# national bit 1

Related Commands show controllers serial Displays information that is specific to the interface hardware.

Cisco IOS Interface and Hardware Component Command Reference

IR-330
 Interface and Hardware Component Commands
national bit (interface)

national bit (interface)

To set the E3 national bit in the G.751 frame used by the PA-E3 port adapter, use the national bit
command in interface configuration mode. To return to the default E3 interface national bit, use the no
form of this command.

national bit {0 | 1}

no national bit

Syntax Description 0 Sets the E3 national bit in the G.751 frame to 0. This is the default.
1 Sets the E3 national bit in the G.751 frame to 1.

Defaults The default value is 0.

Command Modes Interface configuration

Command History Release Modification

11.1 CA This command was introduced.

Usage Guidelines The national bit command sets bit 12 in the E3 frame.
To verify the national bit configured on the interface, use the show controllers serial EXEC command.

Examples The following example sets the national bit to 1 on the PA-E3 port adapter in slot 1, port adapter slot 0,
interface 0:
Router(config)# interface serial 1/0/0
Router(config-if)# national bit 1

Related Commands Command Description

international bit Sets the E3 international bit in the G.751 frame used by the PA-E3 port
adapter.
show controllers serial Displays information that is specific to the interface hardware.

Cisco IOS Interface and Hardware Component Command Reference

IR-331
 Interface and Hardware Component Commands
national reserve

national reserve
To set the E1 national bit, use the national reserve command in interface configuration mode. To return
to the default E1 national bit, use the no form of this command.

national reserve {0 | 1}{0 | 1}{0 | 1}{0 | 1}{0 | 1}{0 | 1}

no national reserve

Syntax Description 0 Sets any of the six required E1 national bits in the G.751 frame to 0.
1 Sets any of the six required E1 national bits in the G.751 frame to 1. This is the
default.

Defaults 111111

Command Modes Interface configuration

Command History Release Modification

12.0(5)XE This command was introduced.
12.0(7)XE1 This command was implemented on the Cisco 7100 series routers.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.

Usage Guidelines This command applies only for E1. This command not only sets the national reserve bits but also sets
the international bit as well. The far left digit represents the international bit. All six digits must be
present for the pattern to be valid.

Examples On Cisco 7100 series routers, the following example sets the E1 national bit on interface 1 on the
port adapter in slot 0 to no scrambling:
Router(config)# interface atm 1/0
Router(config-if)# national reserve 011011

Cisco IOS Interface and Hardware Component Command Reference

IR-332
 Interface and Hardware Component Commands
negotiation

negotiation
To configure speed, duplex, and flow control on the Gigabit Ethernet port of the Cisco 7200-I/O-GE+E,
use the negotiation command in interface configuration mode. To disable automatic negotiation, use the
no negotiation auto command.

negotiation {forced | auto}

no negotiation auto

Syntax Description forced Disables flow control and configures the Gigabit Ethernet interface in
1000/full-duplex mode.
auto Enables the autonegotiation protocol to configures the speed, duplex, and
automatic flow control of the Gigabit Ethernet interface. This is the default.

Defaults auto

Command Modes Interface configuration

Command History Release Modification

11.1 CC This command was introduced.
12.0(7)S, 12.0(6)T The forced keyword was added.
12.1(3a)E This command was implemented on the Cisco 7200-I/O-GE+E controller.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.

Usage Guidelines The negotiation command is applicable only to the Gigabit Ethernet interface of the
Cisco 7200-I/O-GE+E. The negotiation auto command is used instead of the duplex and speed
commands (which are used on Ethernet and Fast Ethernet interfaces) to automatically configure the
duplex and speed settings of the interfaces. The negotiation forced command is used to configure the
Gigabit Ethernet interface to be 1000/full-duplex only and to disable flow control. The Gigabit Ethernet
interface of the Cisco 7200-I/O-GE+E is restricted to 1000 Mbps/full duplex only. Autonegotiation
negotiates only to these values.

Examples The following example configures the Gigabit Ethernet interface of the Cisco 7200-I/O-GE +E to
autonegotiate:
Router(config)# interface gigabitethernet 0/0
Router(config-if)# negotiation auto

Cisco IOS Interface and Hardware Component Command Reference

IR-333
 Interface and Hardware Component Commands
negotiation

Related Commands Command Description

show interfaces Displays the status and configuration settings of the Gigabit Ethernet
gigabitethernet interface of the Cisco 7200-I/O-GE+E.

Cisco IOS Interface and Hardware Component Command Reference

IR-334
 Interface and Hardware Component Commands
nrzi-encoding

nrzi-encoding
To enable nonreturn-to-zero inverted (NRZI) line-coding format, use the nrzi-encoding command in
interface configuration mode. To disable this capability, use the no form of this command.

nrzi-encoding [mark]

no nrzi-encoding

Syntax Description mark (Optional) Specifies that NRZI mark encoding is required on the PA-8T and PA-4T+
synchronous serial port adapters on Cisco 7200 and Cisco 7500 series routers. If the
mark keyword is not specified, NRZI space encoding is used.

Defaults Disabled

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.
11.3 The mark keyword was added for the Cisco 7200 series routers and Cisco 7500
series routers.

Usage Guidelines All FSIP, PA-8T, and PA-4T+ interface types support nonreturn-to-zero (NRZ) and NRZI format. This
is a line-coding format that is required for serial connections in some environments. NRZ encoding is
most common. NRZI encoding is used primarily with EIA/TIA-232 connections in IBM environments.

Examples The following example configures serial interface 1 for NRZI encoding:
Router(config)# interface serial 1
Router(config-if)# nrzi-encoding

The following example configures serial interface 3/1/0 for NRZI mark encoding:
Router(config)# interface serial 3/1/0
Router(config-if)# nrzi-encoding mark

Cisco IOS Interface and Hardware Component Command Reference

IR-335
 Interface and Hardware Component Commands
outbound data-pid

outbound data-pid
Note Effective with Cisco IOS Release 12.4(2)T, this command is superseded by the outbound pid
management command. The outbound data-pid command is still available, but use of the outbound
pid management command is recommended.

To specify the outbound data packet identification (PID) number, use the outbound data-pid
command in satellite initial configuration mode. To remove the PID number configuration, use
the no form of this command.

outbound data-pid number

no outbound data-pid

Syntax Description number Packet identification (PID) number in the range from 1 to 8190.

Defaults No default behavior or values

Command Modes Satellite initial configuration

Command History Release Modification

12.3(14)T This command was introduced.
12.4(2)T This command was superseded by the outbound pid management
command.

Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your
satellite service provider instructs you to perform the satellite initial configuration and provides all
necessary parameter values.

Examples The following example shows how to specify the outbound data PID number:
Router(sat-init-config)# outbound data-pid 3000

Cisco IOS Interface and Hardware Component Command Reference

IR-336
 Interface and Hardware Component Commands
outbound data-rate

outbound data-rate
To specify the VSAT data rate, use the outbound data-rate command in satellite initial configuration
mode. To remove the data rate configuration, use the no form of this command.

outbound data-rate rate

no outbound data-rate

Syntax Description rate VSAT data rate in the range from 250000 to 73000000 bits per second.

Defaults No default behavior or values

Command Modes Satellite initial configuration

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your
satellite service provider instructs you to perform the satellite initial configuration and provides all
necessary parameter values.

Examples The following example shows how to specify the VSAT data rate:
Router(sat-init-config)# outbound data-rate 450000

Cisco IOS Interface and Hardware Component Command Reference

IR-337
 Interface and Hardware Component Commands
outbound frequency

outbound frequency
To specify the VSAT outbound frequency, use the outbound frequency command in satellite initial
configuration mode. To remove the outbound frequency configuration, use the no form of this command.

outbound frequency frequency

no outbound frequency

Syntax Description frequency VSAT outbound frequency in the range from 950000 to 2150000 kilohertz.

Defaults No default behavior or values

Command Modes Satellite initial configuration

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your
satellite service provider instructs you to perform the satellite initial configuration and provides all
necessary parameter values.

Examples The following example shows how to configure the VSAT outbound frequency:
Router(sat-init-config)# outbound frequency 950000

Cisco IOS Interface and Hardware Component Command Reference

IR-338
 Interface and Hardware Component Commands
outbound id

outbound id
To specify the VSAT outbound ID, use the outbound id command in satellite initial configuration mode.
To remove the outbound ID configuration, use the no form of this command.

outbound id number

no outbound id

Syntax Description number ID number in the range from 0 to 255.

Defaults No default behavior or values

Command Modes Satellite initial configuration

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your
satellite service provider instructs you to perform the satellite initial configuration and provides all
necessary parameter values.

Examples The following example shows how to configure the VSAT outbound ID:
Router(sat-init-config)# outbound id 95

Cisco IOS Interface and Hardware Component Command Reference

IR-339
 Interface and Hardware Component Commands
outbound modulation-type

outbound modulation-type
To specify the VSAT modulation type, use the outbound modulation-type command in satellite initial
configuration mode. To remove the VSAT modulation type configuration, use the no form of this
command.

outbound modulation-type {DVB | TURBO_QPSK | 8PSK}

no outbound modulation-type

Syntax Description DVB Digital Video Broadcasting for satellite.

TURBO_QPSK Turbo-coded quadrature Phase Shift Keying.
8PSK Phase Shift Keying.

Defaults No default behavior or values

Command Modes Satellite initial configuration

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your
satellite service provider instructs you to perform the satellite initial configuration and provides all
necessary parameter values.

Examples The following example shows how to configure the VSAT modulation type:
Router(sat-init-config)# outbound modulation-type DVB

Cisco IOS Interface and Hardware Component Command Reference

IR-340
 Interface and Hardware Component Commands
outbound sync ip address

outbound sync ip address

To specify the outbound synchronization IP address, use the outbound sync ip address command in
satellite initial configuration mode. To remove the outbound synchronization IP address configuration,
use the no form of this command.

outbound sync ip address address

no outbound sync ip address

Syntax Description address Outbound synchronization IP address.

Defaults No default behavior or values

Command Modes Satellite initial configuration

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your
satellite service provider instructs you to perform the satellite initial configuration and provides all
necessary parameter values.

Examples The following example shows how to configure the outbound synchronization IP address:
Router(sat-init-config)# outbound sync ip address 10.2.2.2

Cisco IOS Interface and Hardware Component Command Reference

IR-341
 Interface and Hardware Component Commands
outbound viterbi-rate

outbound viterbi-rate
To specify the VSAT Viterbi code rate, use the outbound viterbi-rate command in satellite initial
configuration mode. To return to the default rate, use the no form of this command.

outbound viterbi-rate rate

no outbound viterbi-rate

Syntax Description rate Viterbi code rate. It can be one of the following values:
• 1/2
• 1/4
• 2/3
• 3/4
• 3/4(2.05)
• 3/4(2.1)
• 3/4(2.6)
• 5/6
• 6/7
• 7/8
• 8/9

Defaults No default behavior or values

Command Modes Satellite initial configuration

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your
satellite service provider instructs you to perform the satellite initial configuration and provides all
necessary parameter values.

Examples The following example shows how to configure the VSAT Viterbi code rate:
Router(sat-init-config)# outbound viterbi-rate 3/4(2.6)

Cisco IOS Interface and Hardware Component Command Reference

IR-342
 Interface and Hardware Component Commands
overhead j0

overhead j0
To specify the Regenerator Section (RS) Trace identifier (J0), use the overhead j0 command in
controller configuration mode. To restore the default value, use the no form of this command.

overhead j0 {transmit | receive} string

no overhead j0 {transmit | receive} string

Syntax Description transmit Specifies that the string argument is sent on the transmit line.
receive Specifies that the configured string argument is matched with the string received
from a peer.
string Value in the range from 0 to 255 that is converted into character format and
embedded in a 16-byte frame. The default is 1.

Defaults The default value is 1, and no peer authentication is performed.

Command Modes Controller configuration

Command History Release Modification

12.0(17)S This command was introduced.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T, and the
transmit and receive keywords were added.

Usage Guidelines RS trace is a maintenance feature of SONET. One byte (J0) of the Section overhead associated with each
SONET frame is used to carry information identifying the transmitting equipment.
Use this command for peer authentication and continuity testing between two STM-1 optical peers. If
the authentication string sent by the originating peer does not match the configured string on the
receiving peer, the SONET controller will not come up on the receiving peer. Alarm logs on the
originating peer will show that it has RS-Trace Identifier Mismatch (RS-TIM).

Examples The following example shows how to configure J0 overhead in both the transmit and receive directions
on a STM-1 trunk card:
Router(config)# controller sonet 2/0
Router(config-controller)# overhead j0 transmit 22
Router(config-controller)# overhead j0 receive 34

The following example shows how to set the RS Trace identifier to 82:
Router(config-controller)# overhead j0 transmit 82

Cisco IOS Interface and Hardware Component Command Reference

IR-343
 Interface and Hardware Component Commands
overhead j1

overhead j1
To configure the message length and the message text of the High Order Path Trace identifier (J1), use
the overhead j1 command in controller configuration or path configuration mode. To restore the default
value, use the no form of this command.

overhead j1 length {16 | 64} {transmit-message | receive-message} string

no overhead j1 length {16 | 64} {transmit-message | receive-message} string

Syntax Description length Specifies the length of the authentication string argument.
16 Specifies that the length of the authentication string is 16 characters. The STM-1
trunk card supports a string length of 16.
64 Specifies that the length of the authentication string is 64 characters.
transmit-message Specifies that the string argument is sent on the transmit line.
receive-message Specifies that the configured string argument is matched with the string received
from a peer.
string Combination of characters and numbers for the specified length value.

Defaults The default message length is 16 for SDH framing and 64 for SONET framing.
No peer authentication is performed.

Command Modes SDH Framing with AU-4 Mapping

Controller configuration

SDH Framing with AU-3 Mapping, or SONET Framing

Path configuration

Command History Release Modification

12.0(17)S This command was introduced.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T, and the
transmit-message and receive-message keywords were added.

Usage Guidelines Path trace is a maintenance feature of SONET/SDH. One byte (J1) of the Path overhead associated with
each path in the SONET/SDH frame is used to carry information identifying the originating Path
Terminating Equipment (PTE).
Where you configure the Path Trace identifier depends on the framing (SDH or SONET) and the AUG
mapping. In SDH with AU-4 mapping, the Path Trace identifier is configured at the SONET controller
level. In SDH with AU-3 mapping or in SONET framing, the Path Trace identifier is configured at the
path level.
In accordance with SONET and SDH standard requirements, the Path Trace message you enter is
manipulated as follows:

Cisco IOS Interface and Hardware Component Command Reference

IR-344
 Interface and Hardware Component Commands
overhead j1

• If you select a message length of 16, the actual message length can be up to 15 characters. An
additional byte, prepended to the message, contains the result of a CRC7 calculated on the message.
If the actual message text is fewer than 15 characters, the message text is padded to its full length
with NULL characters.
• If you select a message length of 64 and the actual message text is fewer than 62 characters, the
message text is padded with NULL characters. The last two byte positions, 63 and 64, are always
CR/LF (0x0D/0x0A).
Use this command for peer authentication and continuity testing between two STM-1 optical peers. If
the authentication string sent by the originating peer does not match the configured string on the
receiving peer, the Path (and all E1 controllers within the path) will not come up on the receiving peer.
Alarm logs on the originating peer will show that it has High Order Path-Trace Identifier Mismatch
(HP-TIM).

Examples The following example shows J1 configuration in SDH framing with AU-4 AUG mapping. The
overhead j1 command sets the message length to 16, and specifies the message text as metro_SF:
Router(config-controller)# au-4 1
Router(config-ctrlr-au4)# overhead j1 length 16 transmit-message metro_SF

The following example shows J1 configuration in SDH framing with AU-3 AUG mapping. The
overhead j1 command sets the message length to 16, and specifies the message text as metro_LA:
Router(config)# controller sonet 4/0
Router(config-controller)# au-3 3
Router(config-ctrlr-au3)# overhead j1 length 16 receive-message metro_L

The following example shows J1 configuration in SONET framing in STS-1 mode. The overhead j1
command sets the message length to 64, and specifies the message text:
Router(config)# controller sonet 4/0
Router(config-controller)# sts-1 3
Router(config-ctrlr-sts1)# overhead j1 length 64 transmit-message metro_washington
gsr_0057/4/3

The following example shows how to configure j1 overhead in both the transmit and receive directions:
Router(config)# controller sonet 2/0
Router(config-controller)# overhead j1 length 2 transmit-message 22
Router(config-controller)# overhead j1 length 2 receive-message 34

Cisco IOS Interface and Hardware Component Command Reference

IR-345
 Interface and Hardware Component Commands
payload-compression

payload-compression
To enable payload compression, use the payload-compression command in CEM configuration mode.
To disable payload compression, use the no form of this command.

payload-compression

no payload-compression

Syntax Description This command has no arguments or keywords.

Defaults Payload compression is disabled.

Command Modes CEM configuration

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines Payload compression can be enabled only for a maximum of 3 Mbps per network module.

Examples The following example demonstrates how to enable payload compression.

Router(config-cem)# payload-compression

Related Commands Command Description

cem Enters circuit emulation configuration mode.
payload-size Configures payload size.
show cem Displays CEM statistics.

Cisco IOS Interface and Hardware Component Command Reference

IR-346
 Interface and Hardware Component Commands
payload-size

payload-size
To configure the payload size of a circuit emulation (CEM) over IP (CEoIP) packet, use the payload-size
command in CEM configuration mode. To restore the default payload size, use the no form of this
command.

payload-size size

no payload-size

Syntax Description size Integer that defines the number of bytes per CEoIP packet. Range is from 1
to 1312.
The maximum configurable payload size is as follows:
• 1312 bytes if data protection is not enabled
• 656 bytes if data protection is enabled
The minimum configurable payload size for an unframed T1 or E1 channel
is 256 bytes.
The minimum configurable payload size for a framed T1 or E1 channel is as
follows:
• 56 bytes if the data rate is less than or equal to 256,000 kbps
• 128 bytes if the data rate is greater than 256,000 kbps and less than or
equal to 512,000 kbps
• 256 bytes if the data rate is greater than 512,000 kbps
The minimum configurable payload size for a serial channel is as follows:
• 1 byte if the data rate is less than or equal to 2400 kbps
• 4 bytes if the data rate is greater than 2400 kbps but less than or equal to
9600 kbps
• 16 bytes if the data rate is greater than 9600 kbps but less than or equal
to 32,000 kbps
• 32 bytes if the data rate is greater than 32,000 kbps but less than or equal
to 64,000 kbps
• 64 bytes if the data rate is greater than 64,000 kbps but less than or equal
to 256,000 kbps
• 128 bytes if the data rate is greater than 256,000 kbps but less than or
equal to 512,000 kbps
• 256 bytes if the data rate is greater than 512,000 kbps
Note For T1 and E1, the integer must be a multiple of the number of time
slots and 16.

Defaults The default payload size for a serial channel is 32 bytes. Defaults for T1 and E1 channels are shown in
Table 13 and Table 14.

Cisco IOS Interface and Hardware Component Command Reference

IR-347
 Interface and Hardware Component Commands
payload-size

Table 13 Default Payload Size for N*64 kbps T1/E1 Channels

Number of Time Slots Channel Data Rate (kbps) Default Payload Size (bytes)
1 64 64
2 128 64
3 192 96
4 256 64
5 320 160
6 384 144
7 448 224
8 512 128
9 576 288
10 640 320
11 704 352
12 768 288
13 832 416
14 896 336
15 960 480
16 1024 256
Unframed T1 1544 512
Unframed E1 2048 512
17 1088 544
18 1152 576
19 1216 608
20 1280 560
21 1344 672
22 1408 528
23 1472 736
24 1536 528
25 1600 800
26 1664 624
27 1728 864
28 1792 560
29 1856 928
30 1920 720
31 1984 992

Table 14 Default Payload Size for N*56 kbps T1 Channels

Cisco IOS Interface and Hardware Component Command Reference

IR-348
 Interface and Hardware Component Commands
payload-size

Number of Time Slots Channel Data Rate (kbps) Default Payload Size (bytes)
1 56 56
2 112 56
3 168 168
4 224 56
5 280 280
6 336 168
7 392 168
8 448 168
9 504 504
10 560 280
11 616 616
12 672 336
13 728 728
14 784 280
15 840 840
16 896 336
17 952 952
18 1008 1008
19 1064 1064
20 1120 560
21 1176 672
22 1232 616
23 1288 1288
24 1344 672

Command Modes CEM configuration

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines Use this command to configure the size of each CEoIP packet. Smaller sizes reduce delay but diminish
efficiency.

Cisco IOS Interface and Hardware Component Command Reference

IR-349
 Interface and Hardware Component Commands
payload-size

Note The payload size must be a multiple of the number of time slots and 16. The payload size entered
by the user will be automatically changed to match the above requirement, and a console message
will inform the user of this change.

Examples The following example demonstrates how to configure a payload size of 224.
Router(config-cem)# payload-size 224

Related Commands Command Description

cem Enters circuit emulation configuration mode.
payload-compression Enables payload compression.
show cem Displays CEM channel statistics.

Cisco IOS Interface and Hardware Component Command Reference

IR-350
 Interface and Hardware Component Commands
physical-layer

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

physical-layer {sync | async}

no physical-layer

Syntax Description sync Places the interface in synchronous mode. This is the default.
async Places the interface in asynchronous mode.

Defaults Synchronous mode

Command Modes Interface configuration

Command History Release Modification

11.2 This command was introduced.

Usage Guidelines This command applies only to low-speed serial interfaces available on Cisco 2520 through Cisco 2523
series routers.
In synchronous mode, low-speed serial interfaces support all interface configuration commands
available for high-speed serial interfaces, except the following two commands:
• half-duplex timer cts-delay
• half-duplex timer 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 more system:running-config and
more nvram:startup-config commands because the command is a physical-layer command.

Examples The following example shows how to change a low-speed serial interface from synchronous to
asynchronous mode:
Router(config)# interface serial 2
Router(config-if)# physical-layer async

Related Commands Command Description

more Displays a specified file.

Cisco IOS Interface and Hardware Component Command Reference

IR-351
 Interface and Hardware Component Commands
port (interface)

port (interface)
To enable an interface on a PA-4R-DTR port adapter to operate as a concentrator port, use the port
command in interface configuration mode. To restore the default station mode, use the no form of this
command.

port

no port

Syntax Description This command has no arguments or keywords.

Defaults Station mode

Command Modes Interface configuration

Command History Release Modification

11.3(3)T This command was introduced.

Usage Guidelines By default, the interfaces of the PA-4R-DTR operate as Token Ring stations. Station mode is the typical
operating mode. Use this command to enable an interface to operate as a concentrator port.

Examples The following example configures the PA-4R-DTR ports to operate in concentrator mode on a
Cisco 7000 series router:
Router(config)# interface tokenring 3/0/0
Router(config-if)# port

Cisco IOS Interface and Hardware Component Command Reference

IR-352
 Interface and Hardware Component Commands
pos ais-shut

pos ais-shut
To send the line alarm indication signal (LAIS) when the Packet-over-SONET (POS) interface is placed
in any administrative shutdown state, use the pos ais-shut command in interface configuration mode.

pos ais-shut

Syntax Description This command has no arguments or keywords.

Defaults No LAIS is sent.

Command Modes Interface configuration

Command History Release Modification

11.1 CC This command was introduced.

Usage Guidelines In Automatic Protection Switching (APS) environments, LAIS can be used to force a protection switch.
This command forces an APS switch when the interface is placed in the administrative shutdown state.
For more information on APS, refer to the “Configuring Serial Interfaces” chapter in the Cisco IOS
Interface and Hardware Component Configuration Guide.
This command does not have a no form.

Examples The following example forces the alarm indication on POS OC-3 interface 0 in slot 3:
Router(config)# interface pos 3/0
Router(config-if)# shutdown
Router(config-if)# pos ais-shut

Cisco IOS Interface and Hardware Component Command Reference

IR-353
 Interface and Hardware Component Commands
pos flag

pos flag
To set the SONET overhead bytes in the frame header to meet a specific standards requirement or to
ensure interoperability with the equipment of another vendor, use the pos flag command in interface
configuration mode. To remove the setting of the SONET overhead bytes, use the no form of this
command.

pos flag {c2 | j0 | s1s0} value

no pos flag {c2 | j0 | s1s0} value

Syntax Description c2 value Path signal identifier used to identify the payload content type. The default value
is 0xCF.
j0 value Section trace byte (formerly the C1 byte). For interoperability with Synchronous
Digital Hierarchy (SDH) equipment in Japan, use the value 0x1. The byte value can
be 0 to 255.
sls0 value S1 and S0 bits (bits 5 and 6 of the H1 #1 payload pointer byte). Use the following
values to tell the SONET transmission equipment the SS bit:
• For OC-3c, use 0 (this is the default).
• For AU-4 container in SDH, use 2.
The S1 and S0 bits can be 0 to 3. Values 1 and 3 are undefined. The default value
is 0.

Defaults The default c2 value is 0xCF.

The default sls0 value is 0.

Command Modes Interface configuration

Command History Release Modification

11.2 GS This command was introduced to support the Cisco 12000 series Internet routers.

Usage Guidelines Use the following values to tell the SONET transmission equipment the payload type:
• For PPP, or High-Level Data Link Control (HDLC) when required, use 0xCF (this is the default).
• For ATM, use 0x13.
• For other equipment, use any nonzero value.
• The byte value can be 0 to 255.

Cisco IOS Interface and Hardware Component Command Reference

IR-354
 Interface and Hardware Component Commands
pos flag

Examples The following example sets the path signal identifier used to identify the payload content type to ATM
on the pos interface in slot 9:
Router(config)# interface pos 9/0
Router(config-if)# pos flag c2 0x13
Router(config-if)# end

Cisco IOS Interface and Hardware Component Command Reference

IR-355
 Interface and Hardware Component Commands
pos framing

pos framing
To specify the framing used on the POS (Packet-over-SONET) interface, use the pos framing command
in interface configuration mode. To return to the default SONET STS-3c framing mode, use the no form
of this command.

pos framing {sdh | sonet}

no pos framing

Syntax Description sdh Selects SDH STM-1 framing. This framing mode is typically used in Europe.
sonet Selects SONET STS-3c framing. This is the default.

Defaults SONET STS-3c framing

Command Modes Interface configuration

Command History Release Modification

11.2 This command was introduced.
11.3 This command was modified to change the posi framing-sdh command to
pos framing-sdh.
11.2 GS The command syntax was changed from pos framing-sdh to pos framing.
The sonet keyword was added.

Examples The following example configures the interface for SDH STM-1 framing:
Router(config)# interface pos 3/0
Router(config-if)# pos framing sdh
Router(config-if)# no shutdown

Related Commands Command Description

clock source (interface) Controls the clock used by a G.703-E1 interface.
interface Configures an interface type, and enters interface configuration mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-356
 Interface and Hardware Component Commands
pos report

pos report
To permit selected SONET alarms to be logged to the console for a POS (Packet-over-SONET) interface,
use the pos report command in interface configuration mode. To disable logging of select SONET
alarms, use the no form of this command.

pos report {b1-tca | b2-tca | b3-tca | lais | lrdi | pais | plop | prdi | rdool | sd-ber | sf-ber | slof |
slos}

no pos report {b1-tca | b2-tca | b3-tca | lais | lrdi | pais | plop | prdi | rdool | sd-ber | sf-ber | slof
| slos}

Syntax Description b1-tca Reports B1 bit-error rate (BER) threshold crossing alarm (TCA) errors.
b2-tca Reports B2 BER crossing TCA errors.
b3-tca Reports B3 BER crossing TCA errors.
lais Reports line alarm indication signal errors.
lrdi Reports line remote defect indication errors.
pais Reports path alarm indication signal errors.
plop Reports path loss of pointer errors.
prdi Reports path remote defect indication errors.
rdool Reports receive data out of lock errors.
sd-ber Reports signal degradation BER errors.
sf-ber Reports signal failure BER errors.
slof Reports section loss of frame errors.
slos Reports section los of signal errors.

Defaults The following alarms are reported by default:

• b1-tca
• b2-tca
• b3-tca
• plop
• sf-ber
• slof
• slos

Command Modes Interface configuration

Command History Release Modification

11.1 CC This command was introduced.

Cisco IOS Interface and Hardware Component Command Reference

IR-357
 Interface and Hardware Component Commands
pos report

Usage Guidelines Reporting an alarm means that the alarm can be logged to the console. Just because an alarm is permitted
to be logged does not guarantee that it is logged. SONET alarm hierarchy rules dictate that only the most
severe alarm of an alarm group is reported. Whether an alarm is reported or not, you can view the current
state of a defect by checking the “Active Defects” line from the show controllers pos command output.
A defect is a problem indication that is a candidate for an alarm.
For B1, the bit interleaved parity error report is calculated by comparing the BIP-8 code with the BIP-8
code extracted from the B1 byte of the following frame. Differences indicate that section level bit errors
have occurred.
For B2, the bit interleaved parity error report is calculated by comparing the BIP-8/24 code with the
BIP-8 code extracted from the B2 byte of the following frame. Differences indicate that line level bit
errors have occurred.
For B3, the bit interleaved parity error report is calculated by comparing the BIP-8 code with the BIP-8
code extracted from the B3 byte of the following frame. Differences indicate that path level bit errors
have occurred.
PAIS is sent by line terminating equipment (LTE) to alert the downstream path terminating equipment
(PTE) that it has detected a defect on its incoming line signal.
PLOP is reported as a result of an invalid pointer (H1, H2) or an excess number of new data flag (NDF)
enabled indications.
SLOF is detected when a severely error framing (SEF) defect on the incoming SONET signal persists
for 3 milliseconds.
SLOS is detected when an all-zeros pattern on the incoming SONET signal lasts 19 plus or minus
3 microseconds or longer. This defect might also be reported if the received signal level drops below the
specified threshold.
To determine the alarms that are reported on the interface, use the show controllers pos command.

Examples The following example enables reporting of SD-BER and LAIS alarms on the interface:
Router(config)# interface pos 3/0/0
Router(config-if)# pos report sd-ber
Router(config-if)# pos report lais
Router(config-if)# end

Related Commands Command Description

interface Configures an interface type, and enters interface configuration mode.
show controllers pos Displays information about the POS controllers.

Cisco IOS Interface and Hardware Component Command Reference

IR-358
 Interface and Hardware Component Commands
pos scramble-atm

pos scramble-atm
To enable SONET payload scrambling on a POS (Packet-over-SONET) interface, use the pos
scramble-atm command in interface configuration mode. To disable scrambling, use the no form of this
command.

pos scramble-atm

no pos scramble-atm

Syntax Description This command has no arguments or keywords.

Defaults Scrambling is disabled.

Command Modes Interface configuration

Command History Release Modification

11.1 CA This command was introduced.

Usage Guidelines SONET payload scrambling applies a self-synchronous scrambler (x43+1) to the Synchronous Payload
Envelope (SPE) of the interface to ensure sufficient bit transition density. Both ends of the connection
must use the same scrambling algorithm. When enabling POS scrambling on a VIP2 POSIP on the
Cisco 7500 series router that has a hardware revision of 1.5 or higher, you can specify CRC 16 only (that
is, CRC 32 is currently not supported).
To determine the hardware revision of the POSIP, use the show diag command.
To determine whether scrambling is enabled on the interface, use the show interface pos command or
the show running-config command.

Note SONET payload scrambling is enabled with the pos scramble-atm command. SONET payload
scrambling applies a self-synchronous scrambler (x 43+1) to the Synchronous Payload Envelope (SPE) of
the interface to ensure sufficient bit transition density. Both sides of the connection must be configured
using the pos scramble-atm command. Currently, when connecting to a Cisco 7500 series router and
using the pos scramble-atm command, you must specify the crc 16 command rather than the crc 32
command.

Examples The following example enables scrambling on the interface:

Router(config)# interface pos 3/0
Router(config-if)# pos scramble-atm
Router(config-if)# no shutdown
Router(config-if)# end

Cisco IOS Interface and Hardware Component Command Reference

IR-359
 Interface and Hardware Component Commands
pos scramble-atm

Related Commands Command Description

crc Sets the length of the CRC on an FSIP or HIP of the Cisco 7500 series
routers or on a 4-port serial adapter of the Cisco 7200 series routers.
interface Configures an interface type, and enters interface configuration mode.
show diag Displays hardware information for the router.
show interfaces pos Displays information about the Packet OC-3 interface in Cisco 7500
series routers.

Cisco IOS Interface and Hardware Component Command Reference

IR-360
 Interface and Hardware Component Commands
pos threshold

pos threshold
To set the bit-error rate (BER) threshold values of the specified alarms for a POS (Packet-Over-SONET)
interface, use the pos threshold command in interface configuration mode. To return to the default
setting, use the no form of this command.

pos threshold {b1-tca | b2-tca | b3-tca | sd-ber | sf-ber} rate

no pos threshold {b1-tca | b2-tca | b3-tca | sd-ber | sf-ber} rate

Syntax Description b1-tca B1 BER threshold crossing alarm. The default rate is 6.
b2-tca B2 BER threshold crossing alarm. The default rate is 6..
b3-tca B3 BER threshold crossing alarm. The default rate is 6..
sd-ber Signal degrade BER threshold. The default rate is 6..
sf-ber Signal failure BER threshold. The default rate is 3 (10e-3).
rate Bit-error rate from 3 to 9 (10-n).

Defaults The default rate is 6 for b1-tca, b2-tca, b3-tca, and sd-ber.
The default rate is 3 (10e-3) for sf-ber.

Command Modes Interface configuration

Command History Release Modification

11.1 CC This command was introduced.

Usage Guidelines For B1, the bit interleaved parity error report is calculated by comparing the BIP-8 code with the BIP-8
code extracted from the B1 byte of the following frame. Differences indicate that section level bit errors
have occurred.
For B2, the bit interleaved parity error report is calculated by comparing the BIP-8/24 code with the
BIP-8 code extracted from the B2 byte of the following frame. Differences indicate that line level bit
errors have occurred.
For B3, the bit interleaved parity error report is calculated by comparing the BIP-8 code with the BIP-8
code extracted from the B3 byte of the following frame. Differences indicate that path level bit errors
have occurred.
SF-BER and SD-BER are sourced from B2 BIP-8 error counts (as is B2-TCA). However, SF-BER and
SD-BER feed into the automatic protection switching (APS) machine and can lead to a protection switch
(if APS is configured).
B1-TCA, B2-TCA, and B3-TCA do nothing more than print a log message to the console (if reports for
them are enabled).
To determine the BER thresholds configured on the interface, use the show controllers pos command.

Cisco IOS Interface and Hardware Component Command Reference

IR-361
 Interface and Hardware Component Commands
pos threshold

Examples The following example configures thresholds on the interface:

Router(config)# interface pos 3/0/0
Router(config-if)# pos threshold sd-ber 8
Router(config-if)# pos threshold sf-ber 4
Router(config-if)# pos threshold b1-tca 4
Router(config-if)# end

Related Commands Command Description

interface Configures an interface type, and enters interface configuration mode.
pos report Permits selected SONET alarms to be logged to the console for a POS
interface.
show controllers pos Displays information about the POS controllers.

Cisco IOS Interface and Hardware Component Command Reference

IR-362
 Interface and Hardware Component Commands
power inline

power inline
To determine how inline power is applied to the device on the specified Fast Ethernet port, use the power
inline command in interface configuration mode. To return the setting to its default, use the no form of
this command.

power inline {auto | never}

no power inline

Syntax Description auto Automatically detects and powers inline devices. This is the default.
never Never applies inline power.

Defaults Power is applied when a telephone is detected on the port (auto).

Command Modes Interface configuration

Command History Release Modification

12.0(5)XU This command was first introduced.
12.2(2)XT This command was integrated to support switchport creation on Cisco 2600 series,
Cisco 3600 series, and Cisco 3700 series routers.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T to support
switchport creation.

Examples The following example shows how to always apply power to the port:
Router(config-if)# power inline auto

Related Commands Command Description

show power inline Displays the power status for the specified port or for all ports.
switchport priority extend Determines how the telephone connected to the specified port handles
priority traffic received on its incoming port.
switchport voice vlan Configures the voice VLAN on the port.

Cisco IOS Interface and Hardware Component Command Reference

IR-363
 Interface and Hardware Component Commands
pulse-time

pulse-time
To enable pulsing data terminal ready (DTR) signal intervals on the serial interfaces, use the pulse-time
command in interface configuration mode. To restore the default interval, use the no form of this
command.

pulse-time [msec] seconds

no pulse-time

Syntax Description msec (Optional) Specifies the use of milliseconds for the DTR signal interval.
seconds Integer that specifies the DTR signal interval in seconds. If the msec keyword is
configured, the DTR signal interval is specified in milliseconds. The default is 0.

Defaults 0 seconds

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.
12.1(5)T The optional msec keyword was added to configure the interval in
milliseconds.

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.
Use the optional msec keyword to specify the DTR signal interval in milliseconds. A signal interval set
to milliseconds is recommended on High-Speed Serial Interfaces (HSSIs).

Examples The following example enables DTR pulse signals for 3 seconds on serial interface 2:
Router(config)# interface serial 2
Router(config-if)# pulse-time 3

The following example enables DTR pulse signals for 150 milliseconds on HSSI interface 2/1/0:
Router(config)# interface hssi 2/1/0
Router(config-if)# pulse-time msec 150

Cisco IOS Interface and Hardware Component Command Reference

IR-364
 Interface and Hardware Component Commands
redundancy handover

redundancy handover
To hand over control of resources (slots and cards) from a route-switch-controller (RSC) card to its peer
RSC card, use the redundancy handover command in privileged EXEC mode.

redundancy handover {cancel | {peer-resources | shelf-resources}

[busyout-period mins] [at hh:mm [{day month | month day} year]]}

Syntax Description cancel Any pending handover is canceled.

peer-resources Resources to be handed over are those on the side of the peer RSC. This
parameter applies only when the system is in extraload.
shelf-resources Resources to be handed over are those on the side of the RSC from which the
command is run.
busyout-period mins (Optional) Time period for which all slots in the selected resources are to be
busied out before handover. If time options are omitted, handover or busyout
period begins immediately.
at hh:mm day month (Optional) Time of the handover or start of the busyout period, in 24-hour
year time format; hour and minute are required; day, month, and year are optional.

Defaults Control remains with the assigned RSC.

Command Modes Privileged EXEC

Command History Release Modification

12.2(2)XB1 This command was introduced.
12.2(11)T This command was integrated into Cisco IOS Release 12.2(11)T.

Usage Guidelines To use this command, you must have two RSC cards installed on your Cisco AS5850 and you must be
connected to one of them in handover-split mode. This command can be run from either RSC and can
specify that slots be handed over to the peer RSC.
After handover and subsequent restoration of the failed RSC, connect to the active RSC and use this
command to return control of cards to the previously failed but now restored RSC.
Note that when you enter the command with the shelf-resources option, the RSC reloads.

Cisco IOS Interface and Hardware Component Command Reference

IR-365
 Interface and Hardware Component Commands
redundancy handover

Examples The following example hands over control, to the peer RSC, of the slots and cards on the corresponding
side of the chassis. Note the prompt to confirm clearing of calls, handover, and reload on the last line.
Router# redundancy handover shelf-resources busyout-period 10 at 22:00 3 Sep 2005

Newly entered handover schedule:

Busyout period at 22:00:00 PDT Sat Sep 3 2005 for a duration of 10 minutes
Handover pending at 22:10:00 PDT Sat Sep 3 2005
Clear calls, handover and reload as specified above? y

Related Commands Command Description

show redundancy debug-log Displays up to 256 relevant debug entries.
show redundancy handover Displays details of any pending handover (that is, a handover
command that was entered previously and is not yet completed).
show redundancy history Displays logged handover events.

Cisco IOS Interface and Hardware Component Command Reference

IR-366
 Interface and Hardware Component Commands
redundancy stateful

redundancy stateful
To configure stateful failover for tunnels using IP Security (IPSec), use the redundancy stateful
command in crypto map configuration mode. To disable stateful failover for tunnel protection, use the
no form of this command.

redundancy standby-group-name stateful

no redundancy standby-group-name stateful

Syntax Description standby-group-name Refers to the name of the standby group as defined by Hot Standby Router
Protocol (HSRP) standby commands. Both routers in the standby group are
defined by this argument and share the same virtual IP (VIP) address.

Defaults Stateful failover is not enabled for IPSec tunnels.

Command Modes Crypto map configuration

Command History Release Modification

12.3(11)T This command was introduced.

Usage Guidelines The redundancy stateful command uses an existing IPSec profile (which is specified via the crypto
ipsec profile command) to configure IPSec stateful failover for tunnel protection. (You do not configure
the tunnel interface as you would with a crypto map configuration.) IPSec stateful failover enables you
to define a backup IPSec peer (secondary) to take over the tasks of the active (primary) router if the active
router is deemed unavailable.
The tunnel source address must be a VIP address, and it must not be an interface name.

Examples The following example shows how to configure stateful failover for tunnel protection:
crypto ipsec profile peer-profile
redundancy HA-out stateful

interface Tunnel1
ip unnumbered Loopback0
tunnel source 209.165.201.3
tunnel destination 10.0.0.5
tunnel protection ipsec profile peer-profile
!
interface Ethernet0/0
ip address 209.165.201.1 255.255.255.224
standby 1 ip 209.165.201.3
standby 1 name HA-out

Cisco IOS Interface and Hardware Component Command Reference

IR-367
 Interface and Hardware Component Commands
redundancy stateful

Related Commands Command Description

crypto ipsec profile Defines the IPSec parameters that are to be used for IPSec encryption
between two routers and enters crypto map configuration mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-368
 Interface and Hardware Component Commands
reset (alarm-interface)

reset (alarm-interface)
To reset the CPU in the alarm interface controller (AIC), use the reset command in alarm-interface
mode.

reset

Syntax Description This command has no arguments or keywords.

Defaults No default behavior or values

Command Modes Alarm-interface

Command History Release Modification

12.2(2)XG This command was introduced on the Cisco 2600 series and Cisco 3600
series.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T.

Usage Guidelines A change in the AIC IP configuration might not take effect until the next time the card is started. Use
the reset command to restart the card. This command does not have a no form.

Examples The following example shows a message that might be returned after the reset command is entered:
Router(alarm-aic)# reset

Selected card in slot 1 restarted

Related Commands Command Description

alarm-interface Enters alarm-interface mode and configures the AIC.

Cisco IOS Interface and Hardware Component Command Reference

IR-369
 Interface and Hardware Component Commands
ring-speed

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

ring-speed speed

Syntax Description speed Integer that specifies the ring speed, either 4 for 4-Mbps operation or 16 for 16-Mbps
operation. The default is 16.

Defaults 16-Mbps operation

Caution Configuring a ring speed that is wrong or incompatible with the connected Token Ring causes the ring
to beacon, which makes the ring nonoperational.

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines This command does not have a no form.

Examples The following example shows how to sets the ring speed to 4 Mbps on a Token Ring interfaces:
Router(config)# interface tokenring 0
Router(config-if)# ring-speed 4

Cisco IOS Interface and Hardware Component Command Reference

IR-370
 Interface and Hardware Component Commands
scramble

scramble
To enable scrambling (encryption) of the payload on a T3 or E3 controller or on the PA-T3 and PA-E3
port adapters, use the scramble command in interface configuration mode. To disable scrambling, use
the no form of this command.

scramble

no scramble

Syntax Description This command has no arguments or keywords.

Defaults Scrambling is disabled.

Command Modes Interface configuration

Command History Release Modification

11.1 CA This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and
implemented on the following platforms: Cisco 2650XM, Cisco 2651XM,
Cisco 2691, Cisco 3660 series, Cisco 3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.

Usage Guidelines T3/E3 scrambling is used to assist clock recovery on the receiving end. Scrambling is designed to
randomize the pattern of 1s and 0s carried in the physical layer frame. Randomizing the digital bits can
prevent continuous, nonvariable bit patterns—in other words, long strings of all 1s or all 0s. Several
physical layer protocols rely on transitions between 1s and 0s to maintain clocking.
Scrambling can prevent some bit patterns from being mistakenly interpreted as alarms by switches
placed between the Data Service Units (DSUs).
The local interface configuration must match the remote interface configuration. For example, if you
enable scrambling on the local port, you must also do the same on the remote port.
To verify that scrambling is configured on the interface, use the show controllers serial or the show
interfaces serial commands.
For T3 controllers, all the DSU modes support scrambling except Clear mode.
For E3 controllers, only Kentrox mode supports scrambling.

Examples The following example enables scrambling on the PA-E3 port adapter in slot 1, port adapter slot 0,
interface 0:
Router(config)# interface serial 1/0/0
Router(config-if)# scramble

Cisco IOS Interface and Hardware Component Command Reference

IR-371
 Interface and Hardware Component Commands
scramble

The following example enables scrambling on the controller in slot 1, port 0:

Router(config)# interface serial 1/0
Router(config-if)# scramble

Related Commands Command Description

show controllers serial Displays information that is specific to the serial controllers.
show interfaces serial Displays information that is specific to the interface hardware.

Cisco IOS Interface and Hardware Component Command Reference

IR-372
 Interface and Hardware Component Commands
serial restart-delay

serial restart-delay
To set the amount of time that the router waits before trying to bring up a serial interface when it goes
down, use the serial restart-delay command in interface configuration mode. To restore the default, use
the no form of the command.

serial restart-delay count

no serial restart-delay

Syntax Description count Frequency, in milliseconds, at which the hardware is reset. Range is from 0
to 900. Default is 0.

Defaults 0 milliseconds

Command Modes Interface configuration

Command History Release Modification

11.2 P This command was introduced.
12.2(4)T The count value was changed to set time in milliseconds rather than in
seconds.

Usage Guidelines The router resets the hardware each time the serial restart timer expires. This command is often used
with the dial backup feature and with the pulse-time command, which sets the amount of time to wait
before redialing when a DTR dialed device fails to connect.
When the count value is set to the default of 0, the hardware is not reset when it goes down. In this way,
if the interface is used to answer a call, it does not cause DTR to drop, which can cause a communications
device to disconnect.

Examples The following example shows how to set the restart delay on serial interface 0 to 0:
Router(config)# interface serial 0
Router(config-if)# serial restart-delay 0

Related Commands Command Description

pulse-time Enables pulsing DTR signal intervals on the serial interfaces.
show interfaces serial Displays information about a serial interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-373
 Interface and Hardware Component Commands
service single-slot-reload-enable

service single-slot-reload-enable
To enable single line card reloading for all line cards in the Cisco 7500 series router, use the service
single-slot-reload-enable command in global configuration mode. To disable single line card reloading
for the line cards in the Cisco 7500 series router, use the no form of this command.

service single-slot-reload-enable

no service single-slot-reload-enable

Syntax Description This command has no arguments or keywords.

Defaults Single line card reloading is disabled.

Command Modes Global configuration

Command History Release Modification

12.0(13)S This command was introduced.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.

Examples In the following example, single line card reloading is enabled for all lines cards on the Cisco 7500 series
router:
Router(config)# service single-slot-reload-enable

Related Commands Command Description

show diag Displays hardware information for a networking device.
show running-config Displays configuration information.

Cisco IOS Interface and Hardware Component Command Reference

IR-374
 Interface and Hardware Component Commands
service-module 56k clock rate

service-module 56k clock rate

To configure the network line speed for a serial interface on a 4-wire, 56/64-kbps CSU/DSU module, use
the service-module 56k clock rate command in interface configuration mode. To enable a network line
speed of 56 kbps, which is the default, use the no form of this command.

service-module 56k clock rate speed

no service-module 56k clock rate speed

Syntax Description speed Network line speed in kbps. The default speed is 56 kbps. Choose from one of the
following optional speeds:
• 2.4—2.4 kbps
• 4.8—4.8 kbps
• 9.6—9.6 kbps
• 19.2—19.2 kbps
• 38.4—38.4 kbps
• 56—56 kbps (default)
• 64—64 kbps
• auto—Automatic line speed mode. Configure this option if your line speed is
constantly changing.

Defaults 56 kbps

Command Modes Interface configuration

Command History Release Modification

11.2 This command was introduced.

Usage Guidelines The 56-kbps line speed is available in switched mode, which is enabled using the service-module 56k
network-type interface configuration command on the 4-wire CSU/DSU. If you have a 2-wire
CSU/DSU module, the default is automatically set to switched mode.
The 64-kbps line speed cannot be used with back-to-back digital data service (DDS) lines. The subrate
line speeds are determined by the service provider.
The auto keyword enables the CSU/DSU to decipher current line speed from the sealing current running
on the network. Use the auto keyword only when transmitting over telco DDS lines and the clocking
source is taken from the line.

Cisco IOS Interface and Hardware Component Command Reference

IR-375
 Interface and Hardware Component Commands
service-module 56k clock rate

Examples The following example displays two routers connected in back-to-back DDS mode. However, notice that
at first the configuration fails because the auto option is used. Later in the example the correct matching
configuration is issued, which is 38.4 kbps.
Router1(config)# interface serial 0
Router1(config-if)# service-module 56k clock source internal
Router1(config-if)# service-module 56k clock rate 38.4

Router2(config-if)# service-module 56k clock rate auto

Router1# ping 10.1.1.2

Type escape sequence to abort.
Sending 5, 100-byte ICMP Echos to 10.1.1.2, timeout is 2 seconds:
.....
Success rate is 0 percent (0/5)

Router2(config-if)# service-module 56k clock rate 38.4

Router1# ping 10.1.1.2

Type escape sequence to abort.
Sending 5, 100-byte ICMP Echos to 10.1.1.2, timeout is 2 seconds:
!!!!!
Success rate is 100 percent (5/5), round-trip min/avg/max = 52/54/56 ms

When transferring from DDS mode to switched mode, you must set the correct clock rate, as shown in
the following example:
Router2(config-if)# service-module 56k network-type dds
Router2(config-if)# service-module 56k clock rate 38.4
Router2(config-if)# service-module 56k network-type switched
% Have to use 56k or auto clock rate for switched mode
% Service module configuration command failed: WRONG FORMAT.

Router2(config-if)# service-module 56k clock rate auto

% WARNING - auto rate will not work in back-to-back DDS.
Router2(config-if)# service-module 56k network-type switched

Related Commands Command Description

service-module 56k clock source Sets up the clock source on a serial interface for a 4-wire,
56/64-kbps CSU/DSU module.
service-module 56k network-type Sends packets in switched dial-up mode or DDS mode using a
serial interface on a 4-wire, 56/64-kbps CSU/DSU module.

Cisco IOS Interface and Hardware Component Command Reference

IR-376
 Interface and Hardware Component Commands
service-module 56k clock source

service-module 56k clock source

To set up the clock source on a serial interface for a 4-wire, 56/64-kbps CSU/DSU module, use the
service-module 56k clock source command in interface configuration mode. To specify that the
clocking come from the line, use the no form of this command.

service-module 56k clock source {line | internal}

no service-module 56k clock source {line | internal}

Syntax Description line Uses the clocking provided by the active line coming in to the router. This is the
default.
internal Uses the internal clocking provided by the hardware module.

Defaults Line clock

Command Modes Interface configuration

Command History Release Modification

11.1 This command was introduced.

Usage Guidelines In most applications, the CSU/DSU should be configured with the clock source line command.
For back-to-back configurations, configure one CSU/DSU with the clock source internal command and
the other with clock source line command.

Examples The following example configures internal clocking and transmission speed at 38.4 kbps.
Router(config)# interface serial 0
Router(config-if)# service-module 56k clock source internal
Router(config-if)# service-module 56k clock rate 38.4

Related Commands Command Description

clock source (interface) Controls the clock used by a G.703-E1 interface.
service-module 56k clock Configures the network line speed for a serial interface on a 4-wire,
rate 56/64-kbps CSU/DSU module.

Cisco IOS Interface and Hardware Component Command Reference

IR-377
 Interface and Hardware Component Commands
service-module 56k data-coding

service-module 56k data-coding

To prevent application data from replicating loopback codes when operating at 64 kbps on a 4-wire
CSU/DSU, use the service-module 56k data-coding command in interface configuration mode. To
enable normal transmission, use the no form of this command.

service-module 56k data-coding {normal | scrambled}

no service-module 56k data-coding {normal | scrambled}

Syntax Description normal Specifies normal transmission of data. This is the default.
scrambled Scrambles bit codes or user data before transmission. All control codes such as
out-of-service and out-of-frame are avoided.

Defaults Normal data transmission

Command Modes Interface configuration

Command History Release Modification

11.2 This command was introduced.

Usage Guidelines Enable the scrambled configuration only in 64-kbps digital data service (DDS) mode. If the network type
is set to switched, the configuration is refused.
If you transmit scrambled bit codes, both CSU/DSUs must have this command configured for successful
communication.

Examples The following example scrambles bit codes or user data before transmission:
Router(config)# interface serial 0
Router(config-if)# service-module 56k clock rate 64
Router(config-if)# service-module 56k data-coding scrambled

Related Commands Command Description

service-module 56k clock rate Configures the network line speed for a serial interface on a
4-wire, 56/64-kbps CSU/DSU module.

Cisco IOS Interface and Hardware Component Command Reference

IR-378
 Interface and Hardware Component Commands
service-module 56k network-type

service-module 56k network-type

To transmit packets in switched dial-up mode or digital data service (DDS) mode using a serial interface
on a 4-wire, 56/64-kbps CSU/DSU module, use the service-module 56k network-type command in
interface configuration mode. To transmit from a dedicated leased line in DDS mode, use the no form of
this command.

service-module 56k network-type {dds | switched}

no service-module 56k network-type {dds | switched}

Syntax Description dds Transmits packets in DDS mode or through a dedicated leased line. The default
is DDS enabled for the 4-wire CSU/DSU.
switched Transmits packets in switched dial-up mode. On a 2-wire, switched 56-kbps
CSU/DSU module, this is the default and only setting.

Defaults DDS is enabled for the 4-wire CSU/DSU.

Switched is enabled for the 2-wire CSU/DSU.

Command Modes Interface configuration

Command History Release Modification

11.2 This command was introduced.

Usage Guidelines In switched mode, you need additional dialer configuration commands to configure dial-out numbers.
Before you enable the service-module 56k network-type switched command, both CSU/DSUs must
use a clock source coming from the line and have the clock rate configured to auto or 56 kbps. If the
clock rate is not set correctly, this command will not be accepted.
The 2-wire and 4-wire, 56/64-kbps CSU/DSU modules use V.25 bis dial commands to interface with the
router. Therefore, the interface must be configured using the dialer in-band command. Data terminal
ready (DTR) dial is not supported.

Note Any loopbacks in progress are terminated when switching between modes.

Examples The following example configures transmission in switched dial-up mode:

Router(config)# interface serial 0
Router(config-if)# service-module 56k clock rate auto
Router(config-if)# service-module 56k network-type switched
Router(config-if)# dialer in-band
Router(config-if)# dialer string 5550111
Router(config-if)# dialer-group 1

Cisco IOS Interface and Hardware Component Command Reference

IR-379
 Interface and Hardware Component Commands
service-module 56k network-type

Related Commands Command Description

dialer in-band Specifies that DDR is to be supported.
service-module 56k clock rate Configures the network line speed for a serial interface
on a 4-wire, 56/64-kbps CSU/DSU module.
service-module 56k clock source Sets up the clock source on a serial interface for a 4-wire,
56/64-kbps CSU/DSU module.
service-module 56k switched-carrier Selects a service provider to use with a 2- or 4-wire,
56/64-kbps dial-up serial line.

Cisco IOS Interface and Hardware Component Command Reference

IR-380
 Interface and Hardware Component Commands
service-module 56k remote-loopback

service-module 56k remote-loopback

To enable the acceptance of a remote loopback request on a serial interface on a 2- or 4-wire, 56/64-kbps
CSU/DSU module, use the service-module 56k remote-loopback command in interface configuration
mode. To disable the module from entering loopback, use the no form of this command.

service-module 56k remote-loopback

no service-module 56k remote-loopback

Syntax Description This command has no arguments or keywords.

Defaults Enabled

Command Modes Interface configuration

Command History Release Modification

11.2 This command was introduced.

Usage Guidelines The no service-module 56k remote-loopback command prevents the local CSU/DSU from being
placed into loopback by remote devices on the line. The line provider is still able to put the module into
loopback by reversing sealing current. Unlike the T1 module, the 2- or 4-wire, 56/64-kbps CSU/DSU
module can still initiate remote loopbacks with the no form of this command configured.

Examples The following example enables transmitting and receiving remote loopbacks:
Router(config)# interface serial 0
Router(config-if)# service-module 56k remote-loopback

Related Commands Command Description

loopback remote (interface) Loops packets through a CSU/DSU, over a DS3 link or a channelized
T1 link, to the remote CSU/DSU and back.

Cisco IOS Interface and Hardware Component Command Reference

IR-381
 Interface and Hardware Component Commands
service-module 56k switched-carrier

service-module 56k switched-carrier

To select a service provider to use with a 2- or 4-wire, 56/64-kbps dial-up serial line, use the
service-module 56k switched-carrier command in interface configuration mode. To enable the default
service provider, use the no form of this command.

service-module 56k switched-carrier {att | sprint | other}

no service-module 56k switched-carrier {att | sprint | other}

Syntax Description att AT&T or other digital network service provider. This is the default on the 4-wire,
56/64-kbps CSU/DSU module.
sprint Sprint or other service provider whose network requires echo cancelers. This is
the default on the 2-wire, switched 56-kbps CSU/DSU module.
other Any other service provider.

Defaults ATT is enabled on the 4-wire, 56/64-kbps CSU/DSU module.

Sprint is enabled on the 2-wire, switched 56-kbps CSU/DSU module.

Command Modes Interface configuration

Command History Release Modification

11.2 This command was introduced.

Usage Guidelines On a Sprint network, echo-canceler tones are sent during call setup to prevent the echo cancelers from
damaging digital data. The transmission of echo-canceler tones may increase call setup times by
8 seconds on the 4-wire module. Having echo cancellation enabled does not affect data traffic.
This configuration command is ignored if the network type is DDS.

Examples The following example configures AT&T as a service provider:

Router(config)# interface serial 0
Router(config-if)# service-module 56k network-type switched
Router(config-if)# service-module 56k switched-carrier att

Related Commands Command Description

service-module 56k network-type Sends packets in switched dial-up mode or DDS mode using
a serial interface on a 4-wire, 56/64-kbps CSU/DSU module.

Cisco IOS Interface and Hardware Component Command Reference

IR-382
 Interface and Hardware Component Commands
service-module analysis-module reload

service-module analysis-module reload

To perform a graceful halt and reboot of the Network Analysis Module (NAM) software on the
NM-NAM network module, use the service-module analysis-module reload command in privileged
EXEC mode.

service-module analysis-module slot/unit reload

Syntax Description slot Number of the router chassis slot for the network module.
/unit Number of the daughter card on the network module. For the NM-NAM,
always use 0. The slash mark is required between the slot argument and the
unit argument.

Command Modes Privileged EXEC

Command History Release Modification

12.3(4)XD This command was introduced on the following platforms: Cisco 2600XM
series, Cisco 2691, Cisco 3660, Cisco 3725, and Cisco 3745.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T.
12.3(8)T4 This command was implemented on the following platforms: Cisco 2811,
Cisco 2821, and Cisco 2851.
12.3(11)T This command was implemented on the Cisco 3800 series.

Usage Guidelines The service-module analysis-module reload command is the Cisco IOS equivalent of the reboot
NAM CLI command. These commands can be used to initiate the NAM software upgrade process or to
access the NAM helper image.

Examples The following example shows how to gracefully halt and reboot the NAM application software:
Router# service-module analysis-module 1/0 reload

Do you want to proceed with reload?[confirm]

Trying to reload Service Module Analysis-Module1/0.

Related Commands Command Description

service-module analysis-module Resets the hardware on the NM-NAM.
reset
service-module analysis-module Gracefully halts the operating system on the NM-NAM.
shutdown
service-module analysis-module Displays hardware and software status information about the
status NM-NAM.

Cisco IOS Interface and Hardware Component Command Reference

IR-383
 Interface and Hardware Component Commands
service-module analysis-module reset

service-module analysis-module reset

To reset the hardware on the Network Analysis Module (NM-NAM), use the service-module
analysis-module reset command in privileged EXEC mode.

service-module analysis-module slot/unit reset

Syntax Description slot Number of the router chassis slot for the network module.
/unit Number of the daughter card on the network module. For the NM-NAM,
always use 0. The slash mark is required between the slot argument and the
unit argument.

Command Modes Privileged EXEC

Command History Release Modification

12.3(4)XD This command was introduced on the following platforms: Cisco 2600XM
series, Cisco 2691, Cisco 3660, Cisco 3725, and Cisco 3745.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T.
12.3(8)T4 This command was implemented on the following platforms: Cisco 2811,
Cisco 2821, and Cisco 2851.
12.3(11)T This command was implemented on the Cisco 3800 series.

Usage Guidelines Use the service-module analysis-module reset command to bring up the NM-NAM after it has been
shut down using the service-module analysis-module shutdown command.

Examples The following example shows how to reset the hardware on the NM-NAM:
Router# service-module analysis-module 1/0 reset

Use reset only to recover from shutdown or failed state

Warning:May lose data on the hard disc!
Do you want to reset?[confirm]
Trying to reset Service Module Analysis-Module1/0.

Related Commands Command Description

service-module analysis-module Gracefully halts and reboots the software on the NM-NAM.
reload
service-module analysis-module Gracefully halts the operating system on the NM-NAM.
shutdown
service-module analysis-module Displays hardware and software status information about the
status NM-NAM.

Cisco IOS Interface and Hardware Component Command Reference

IR-384
 Interface and Hardware Component Commands
service-module analysis-module session

service-module analysis-module session

To access the Network Analysis Module (NAM) console from the router, use the service-module
analysis-module session command in privileged EXEC mode.

service-module analysis-module slot/unit session [clear]

Syntax Description slot Number of the router chassis slot for the network module.
/unit Number of the daughter card on the network module. For the NM-NAM, always use
0. The slash mark is required between the slot argument and the unit argument.
clear (Optional) Clears the NAM console line.

Defaults The router cannot access the NAM console.

Command Modes Privileged EXEC

Command History Release Modification

12.3(4)XD This command was introduced on the following platforms: Cisco 2600XM series,
Cisco 2691, Cisco 3660, Cisco 3725, and Cisco 3745.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T.
12.3(8)T4 This command was implemented on the following platforms: Cisco 2811, Cisco
2821, and Cisco 2851.
12.3(11)T This command was implemented on the Cisco 3800 series.

Usage Guidelines When entered without the clear keyword, this command opens a NAM console session from the router.

Examples Opening a NAM console Session

The following example shows how to open a NAM console session when the NM-NAM is installed in
router slot 2:
Router# service-module analysis-module 2/0 session

Trying 10.1.1.1, 2065 ... Open

<Press Return>

Cisco Network Analysis Module (NM-NAM)

nam1.cisco.com login: root

Password: <password>
Terminal type: vt100

Cisco Network Analysis Module (NM-NAM) Console, 3.2(0.9)

Copyright (c) 1999-2003 by Cisco Systems, Inc.

Cisco IOS Interface and Hardware Component Command Reference

IR-385
 Interface and Hardware Component Commands
service-module analysis-module session

WARNING! Default password has not been changed!

[email protected]#

Clearing the NAM Console Line

The following example shows how to clear the NAM console line when the NM-NAM is installed in
router slot 1:
Router# service-module analysis-module 1/0 session clear
[confirm]
[OK]

Related Commands Command Description

ssh Starts an encrypted session with a remote networking device.
telnet Logs in to a host that supports Telnet.

Cisco IOS Interface and Hardware Component Command Reference

IR-386
 Interface and Hardware Component Commands
service-module analysis-module shutdown

service-module analysis-module shutdown

To gracefully halt the operating system on the Network Analysis Module (NM-NAM), use the
service-module analysis-module shutdown command in privileged EXEC mode.

service-module analysis-module slot/unit shutdown [no-confirm]

Syntax Description slot Number of the router chassis slot for the network module.
/unit Number of the daughter card on the network module. For the NM-NAM,
always use 0. The slash mark is required between the slot argument and the
unit argument.
no-confirm (Optional) No confirmation message appears before shutdown.

Command Modes Privileged EXEC

Command History Release Modification

12.3(4)XD This command was introduced on the following platforms: Cisco 2600XM
series, Cisco 2691, Cisco 3660, Cisco 3725, and Cisco 3745.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T.
12.3(8)T4 This command was implemented on the following platforms: Cisco 2811,
Cisco 2821, and Cisco 2851.
12.3(11)T This command was implemented on the Cisco 3800 series.

Usage Guidelines The service-module analysis-module shutdown command properly brings down the operating system
of the Network Analysis Module (NM-NAM) to protect the network module’s hard drive. When the
operating system has been shut down, the NM-NAM can be removed from the router.
At the confirmation prompt, press Enter to confirm the action or n to cancel.
If you enter the no-confirm keyword, the confirmation prompt does not appear.

Examples Gracefully Halt the Operating System with Confirmation

The following example shows how to gracefully halt the operating system of the NM-NAM in slot 1:
Router# service-module analysis-module 1/0 shutdown

Shutdown is used for Online removal of Service Module.

Do you want to proceed with shutdown?[confirm]
Use service module reset command to recover from shutdown.

Cisco IOS Interface and Hardware Component Command Reference

IR-387
 Interface and Hardware Component Commands
service-module analysis-module shutdown

Gracefully Halt the Operating System — No Confirmation

The following example shows how to gracefully halt the operating system of the NM-NAM in slot 2
without any user confirmation:
Router# service-module analysis-module 2/0 shutdown no-confirm

Use service module reset command to recover from shutdown.

Related Commands Command Description

service-module analysis-module Gracefully halts and reboots the software on the NM-NAM.
reload
service-module analysis-module Resets the hardware on the NM-NAM.
reset
service-module analysis-module Displays hardware and software status information about the
status NM-NAM.

Cisco IOS Interface and Hardware Component Command Reference

IR-388
 Interface and Hardware Component Commands
service-module analysis-module status

service-module analysis-module status

To display hardware and software status information about the Network Analysis Module (NM-NAM),
use the service-module analysis-module status command in privileged EXEC mode.

service-module analysis-module slot/unit status

Syntax Description slot Number of the router chassis slot for the network module.
/unit Number of the daughter card on the network module. For the NM-NAM,
always use 0. The slash mark is required between the slot argument and the
unit argument.

Command Modes Privileged EXEC

Command History Release Modification

12.3(4)XD This command was introduced on the following platforms:
Cisco 2600XM series, Cisco 2691, Cisco 3660, Cisco 3725, and Cisco 3745.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T.
12.3(8)T4 This command was implemented on the following platforms: Cisco 2811,
Cisco 2821, and Cisco 2851.
12.3(11)T This command was implemented on the Cisco 3800 series.

Usage Guidelines Use the service-module analysis-module status command to:

• Display the NAM software release version.
• Check the NAM status (steady or down).

Examples The command in the following example displays information about the NM-NAM in router slot 1:
Router# service-module analysis-module 1/0 status

Service Module is Cisco Analysis-Module1/0

Service Module supports session via TTY line 33
Service Module is in Steady state
Getting status from the Service Module, please wait...
Cisco Network Analysis Module (NM-NAM), version 3.2(0.8)

Related Commands Command Description

show controllers analysis-module Displays controller information for the analysis module
interface.
show interfaces analysis-module Displays status, traffic data, and configuration information
about the analysis module interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-389
 Interface and Hardware Component Commands
service-module backup interface

service-module backup interface

To configure an interface as a secondary or dial backup to the satellite interface, use the service module
backup interface command in satellite interface configuration mode. To remove the backup interface
configuration, use the no form of this command.

service module backup interface interface

no service module backup interface interface

Syntax Description interface Interface type and number.

Defaults No default behavior or values

Command Modes Satellite interface configuration

Command History Release Modification

12.3(14)T This command was introduced.

Examples The following example shows how to set interface async 1 as the backup to the satellite link:
Router(config-if)# service-module backup interface async1

Related Commands Command Description

service-module Sets the terrestrial backup mode for the Cisco IP VSAT satellite WAN
backup mode network module (NM-1VSAT-GILAT).

Cisco IOS Interface and Hardware Component Command Reference

IR-390
 Interface and Hardware Component Commands
service-module backup mode

service-module backup mode

To set the terrestrial dial backup mode for the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT), use the service-module backup mode command in satellite interface
configuration mode. To return to the router (default) dial backup mode, use the no form of this command.

service-module backup mode [hub | router]

no service-module backup mode

Syntax Description hub Hub dial backup mode.

router Router dial backup mode.

Defaults Router dial backup mode

Command Modes Satellite interface configuration

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines Hub Dial Backup Mode

Hub dial backup mode maintains TCP connections during transitions between primary and backup links.
Note, however, that hub dial backup mode provides backup for the satellite link, but not for the
NM-1VSAT-GILAT network module hardware, the router satellite interface, or other router interfaces.
If the satellite link goes down (for example, because of rain fade) in hub dial backup mode, the
NM-1VSAT-GILAT network module connects to the hub using dial-on-demand routing (DDR).
Common DDR backup links use ISDN BRIs, modems on auxiliary ports, and T1/E1 lines.
The NM-1VSAT-GILAT network module always encapsulates packets using a satellite backbone
protocol before sending the packets over the satellite link. In hub dial backup mode, the
NM-1VSAT-GILAT network module continues to encapsulate the packets using the satellite backbone
protocol before sending the packets over the dial backup link to the hub; this is how hub dial backup
mode maintains TCP connections during transitions between the primary satellite link and the dial
backup link. Therefore, hub dial backup mode works only when the NM-1VSAT-GILAT network module
itself is functioning properly.

Router Dial Backup Mode

If the satellite link goes down in router dial backup mode, the router uses DDR to send data out a
different interface. Unlike hub dial backup mode, router dial backup mode does these things:
• Tears down and reestablishes TCP connections during transitions between primary and backup links
• Does not require that the NM-1VSAT-GILAT network module work properly while the backup link
is in use

Cisco IOS Interface and Hardware Component Command Reference

IR-391
 Interface and Hardware Component Commands
service-module backup mode

Examples The following example shows how to specify hub backup mode:
Router(config-if)# service-module backup mode hub

The following example shows how to specify router backup mode:

Router(config-if)# service-module backup mode router

Related Commands Command Description

service-module Specifies the interface to use to back up the satellite interface.
backup interface

Cisco IOS Interface and Hardware Component Command Reference

IR-392
 Interface and Hardware Component Commands
service-module content-engine reload

service-module content-engine reload

To perform a graceful halt and reboot of a content engine (CE) network module operating system, use
the service-module content-engine reload command in privileged EXEC mode.

service-module content-engine slot/unit reload

Syntax Description slot Number of the router chassis slot for the network module.
/unit Number of the daughter card on the network module. For CE network
modules, always use 0. The slash mark is required between the slot
argument and the unit argument.

Command Modes Privileged EXEC

Command History Release Modification

12.2(11)YT This command was introduced.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.

Usage Guidelines At the confirmation prompt, press Enter to confirm the action or n to cancel.

Examples The following example gracefully halts and reboots the CE network module operating system in slot 1:
Router# service-module content-engine 1/0 reload

Do you want to proceed with reload?[confirm]

Related Commands Command Description

interface content-engine Configures an interface for a CE network module and enters
interface configuration mode.
service-module content-engine Resets the hardware on a CE network module.
reset
service-module content-engine Gracefully halts a CE network module.
shutdown
show controllers content-engine Displays controller information for CE network modules.
show interfaces content-engine Displays basic interface configuration information for a CE
network module.

Cisco IOS Interface and Hardware Component Command Reference

IR-393
 Interface and Hardware Component Commands
service-module content-engine reset

service-module content-engine reset

To reset the hardware on a content engine (CE) network module, use the service-module content-engine
reset command in privileged EXEC mode.

service-module content-engine slot/unit reset

Syntax Description slot Number of the router chassis slot for the network module.
/unit Number of the daughter card on the network module. For CE network
modules, always use 0. The slash mark is required between the slot
argument and the unit argument.

Command Modes Privileged EXEC

Command History Release Modification

12.2(11)YT This command was introduced.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.

Usage Guidelines At the confirmation prompt, press Enter to confirm the action or n to cancel.

Note Use the service-module content-engine reset command only to recover from a shutdown or failed
state because you may lose data.

Examples The following example resets the hardware on the CE network module in slot 1:
Router# service-module content-engine 1/0 reset

Use reset only to recover from shutdown or failed state

Warning: May lose data on the hard disc!
Do you want to reset?[confirm]

Related Commands Command Description

interface content-engine Configures an interface for a CE network module and enters
interface configuration mode.
service-module content-engine Performs a graceful halt and reboot of a CE network module
reload operating system.
service-module content-engine Gracefully halts a CE network module.
shutdown
show controllers content-engine Displays controller information for CE network modules.
show interfaces content-engine Displays basic interface configuration information for a CE
network module.

Cisco IOS Interface and Hardware Component Command Reference

IR-394
 Interface and Hardware Component Commands
service-module content-engine session

service-module content-engine session

To access a content engine (CE) network module console and begin a configuration session, use the
service-module content-engine session command in privileged EXEC mode.

service-module content-engine slot/unit session [clear]

Syntax Description slot Number of the router chassis slot for the network module.
/unit Number of the daughter card on the network module. For CE network
modules, always use 0. The slash mark is required between the slot
argument and the unit argument.
clear (Optional) Clears the CE configuration session.

Command Modes Privileged EXEC

Command History Release Modification

12.2(11)YT This command was introduced.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.

Usage Guidelines Only one session at a time is allowed into the content engine from the internal CE network-module-side
interface. This interface provides console access to the CE network module from the router
command-line interface (CLI) by initiating a reverse Telnet connection that uses the IP address of the
CE interface and the terminal (TTY) line associated with the CE network module. The TTY line number
is calculated using the formula (n*32) + 1, where n is the number of the chassis slot that contains the CE
network module. The CE interface must be up before you can use this command.
Once a session is started, you can perform any CE configuration task. You first access the CE console in
a user-level shell. To access the privileged EXEC command shell, where most commands are available,
use the enable command. Note that this is a Cisco Application and Content Networking System (ACNS)
software command, not a Cisco IOS software command.
CE configuration tasks are described in the documentation for Cisco Application and Content
Networking Software, Release 4.2. Initial CE configuration tasks are covered in the Cisco Content
Delivery Networking Products Getting Started Guide, section 6, “Perform an Initial Startup
Configuration.”
After you finish CE configuration and exit the CE console session, use this command with the clear
keyword to clear the session. At the confirmation prompt, press Enter to confirm the action or n to
cancel.

Examples The following example shows a CE session being opened for a CE network module in slot 2:
Router# service-module content-engine 2/0 session

Trying 10.10.10.1, 2129 ... Open

CE-netmodule con now available

Cisco IOS Interface and Hardware Component Command Reference

IR-395
 Interface and Hardware Component Commands
service-module content-engine session

Press RETURN to get started!

CE-netmodule> enable
CE-netmodule#

The following example clears the session that had been used to configure the CE in the network module
in slot 1:
Router# service-module content-engine 1/0 session clear

[confirm]
[OK]

Related Commands Command Description

interface content-engine Configures an interface for a CE network module and enters
interface configuration mode.
show controllers content-engine Displays controller information for CE network modules.
show interfaces content-engine Displays basic interface configuration information for a CE
network module.

Cisco IOS Interface and Hardware Component Command Reference

IR-396
 Interface and Hardware Component Commands
service-module content-engine shutdown

service-module content-engine shutdown

To gracefully halt a content engine (CE) network module, use the service-module content-engine
shutdown command in privileged EXEC mode.

service-module content-engine slot/unit shutdown

Syntax Description slot Number of the router chassis slot for the network module.
/unit Number of the daughter card on the network module. For CE network
modules, always use 0. The slash mark is required between the slot
argument and the unit argument.

Command Modes Privileged EXEC

Command History Release Modification

12.2(11)YT This command was introduced.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.

Usage Guidelines At the confirmation prompt, press Enter to confirm the action or n to cancel.
The service-module content-engine shutdown command brings down the operating system of the
specified content engine network module in an orderly fashion to protect the network module’s hard
drive. When the system has been shut down, the network module can be removed from the router.

Examples The following example gracefully halts the CE network module in slot 1:
Router# service-module content-engine 1/0 shutdown

Shutdown is used for Online removal of Service Module.

Do you want to proceed with shutdown?[confirm]
Use service module reset command to recover from shutdown.

Related Commands Command Description

interface content-engine Configures an interface for a CE network module and enters
interface configuration mode.
service-module content-engine Performs a graceful halt and reboot of a CE network module
reload operating system.
service-module content-engine Resets the hardware on a CE network module.
reset
show controllers content-engine Displays controller information for CE network modules.
show interfaces content-engine Displays basic interface configuration information for a CE
network module.

Cisco IOS Interface and Hardware Component Command Reference

IR-397
 Interface and Hardware Component Commands
service-module content-engine shutdown

Cisco IOS Interface and Hardware Component Command Reference

IR-398
 Interface and Hardware Component Commands
service-module content-engine status

service-module content-engine status

To display configuration information related to the hardware and software on the content engine (CE)
side of a CE network module, use the service-module content-engine status command in privileged
EXEC mode.

service-module content-engine slot/unit status

Syntax Description slot Number of the router chassis slot for the network module.
/unit Number of the daughter card on the network module. For CE network
modules, always use 0. The slash mark is required between the slot
argument and the unit argument.

Command Modes Privileged EXEC

Command History Release Modification

12.2(11)YT This command was introduced.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.

Usage Guidelines Use the service-module content-engine status command to:

• Display the CE network module software release version.
• Check the CE network module status (steady or down).
• Display hardware information for the CE network module including CPU, memory, interface, and
disk drive information.

Examples The following example displays information for a CE network module in router slot 1:
Router# service-module content-engine 1/0 status

Service Module is Cisco Content-Engine1/0

Service Module supports session via TTY line 33
Service Module is in Steady state
Getting status from the Service Module, please wait..
Application and Content Networking Software (ACNS)
Copyright (c) 1999-2002 by Cisco Systems, Inc.
Application and Content Networking Software Release 4.2.2 (build b3 May 6 2002)
Version: ce2636-sw-<unknown-version>
Compiled 18:03:40 May 6 2002 by engineer
Compile Time Options: PP

System was restarted on Mon Jan 7 20:30:37 1980.

The system has been up for 8 minutes, 30 seconds.

Core CPU is GenuineIntel Pentium III (Coppermine) (rev 8) running at 498MHz.

246 Mbytes of Physical memory.
2 FastEthernet interfaces

Cisco IOS Interface and Hardware Component Command Reference

IR-399
 Interface and Hardware Component Commands
service-module content-engine status

1 Console interface

List of disk drives:

disk00: Normal (h00 c00 i00 l00) 19075MB( 18.6GB)

Related Commands Command Description

interface content-engine Configures an interface for a CE network module and enters
interface configuration mode.
show controllers content-engine Displays controller information for CE network modules.
show interfaces content-engine Displays basic interface configuration information for a CE
network module.

Cisco IOS Interface and Hardware Component Command Reference

IR-400
 Interface and Hardware Component Commands
service-module external ip address

service-module external ip address

To define the IP address for the external LAN interface on a content engine (CE) network module, use
the service-module external ip address command in content-engine interface configuration mode. To
delete the IP address associated with this interface, use the no form of this command.

service-module external ip address external-ip-addr subnet-mask

no service-module external ip address

Syntax Description external-ip-addr IP address of the external LAN interface on a CE network module.
subnet-mask Subnet mask to append to the IP address.

Defaults No default behavior or values

Command Modes Content-engine interface configuration

Command History Release Modification

12.2(11)YT This command was introduced.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.

Examples The following example defines an IP address for the external LAN interface on the CE network module
in slot 1:
Router(config)# interface content-engine 1/0
Router(config-if)# service-module external ip address 172.18.12.28 255.255.255.0
Router(config-if)# exit

Related Commands Command Description

interface content-engine Configures an interface for a CE network module and enters
interface configuration mode.
show controllers content-engine Displays controller information for CE network modules.
show interfaces content-engine Displays basic interface configuration information for a CE
network module.

Cisco IOS Interface and Hardware Component Command Reference

IR-401
 Interface and Hardware Component Commands
service-module ids-sensor

service-module ids-sensor
To reboot, reset, enable console access to, shutdown, and monitor the status of the Cisco Intrusion
Detection System (IDS) network module, use the service-module ids-sensor command in privileged
EXEC mode.

service-module ids-sensor slot/port {reload | reset | session | shutdown | status}

Syntax Description slot Number of the router chassis slot for the network module.
/port Port number of the network module. For Cisco IDS network modules,
always use 0. The slash mark is required between the slot argument and
the unit argument.
reload Performs a graceful halt and reboot of the operating system on a Cisco
IDS network module.
reset Resets the hardware on the Cisco IDS network module. This command
is usually used to recover from a shutdown.
session Enables console access to the Cisco IDS network module from the
router.
shutdown Shuts down the IDS applications that are running on a Cisco IDS
network module.
status Provides information on the status of the Cisco IDS software.

Command Modes Privileged EXEC

Command History Release Modification

12.3(4)T This command was introduced.

Usage Guidelines If a confirmation prompt is displayed, press Enter to confirm the action or n to cancel.
The Cisco IDS network module is also referred to as the NM-CIDS.

Examples The following example gracefully halts and reboots the operating system on the Cisco IDS network
module in slot 1:
Router# service-module ids-sensor 1/0 reload

Do you want to proceed with reload?[confirm]

The following example resets the hardware on the Cisco IDS network module in slot 1. A warning is
displayed.
Router# service-module ids-sensor 1/0 reset

Use reset only to recover from shutdown or failed state

Warning: May lose data on the hard disk!

Cisco IOS Interface and Hardware Component Command Reference

IR-402
 Interface and Hardware Component Commands
service-module ids-sensor

Do you want to reset?[confirm]

Caution Hard-disk drive data loss occurs only if you issue the reset command without first shutting down
the Cisco IDS network module. You can use the reset command safely in other situations.

The following example enables console access to the Cisco IDS network module operating system in slot
1:
Router# service-module ids-sensor 1/0 session

The following example shuts down IDS applications that are running on the Cisco IDS network module
in slot 1:
Router# service-module ids-sensor 1/0 shutdown

Trying 10.10.10.1, 2129 ... Open

%SERVICEMODULE-5-SHUTDOWN2:Service module IDS-Sensor1/0 shutdown complete

The following example shows the status of the Cisco IDS software:
Router# service-module ids-sensor 1/0 status

Service Module is Cisco IDS-Sensor1/0

Service Module supports session via TTY line 33
Service Module is in Steady state
Getting status from the Service Module, please wait...
Service Module Version information received, Major ver = 1, Minor ver= 1
Cisco Systems Intrusion Detection System Network Module
Software version: 4.1(1)S42(0.3)
Model: NM-CIDS
Memory: 254676 KB

Related Commands Command Description

ids-service-module monitoring Enables IDS monitoring on a specified interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-403
 Interface and Hardware Component Commands
service-module ip address

service-module ip address
To define the IP address for the internal network-module-side interface on a content engine network
module (NM-CE-BP) or Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT), use
the service-module ip address command in content-engine interface configuration mode or satellite
interface configuration mode. To delete the IP address associated with this interface, use the no form of
this command.

service-module ip address nm-side-ip-address subnet-mask

no service-module ip address

Syntax Description nm-side-ip-address IP address of the internal network-module-side interface on a CE network

module (NM-CE-BP) or Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT).
subnet-mask Subnet mask to append to the IP address.

Defaults No default behavior or values

Command Modes Content-engine interface configuration

Satellite interface configuration

Command History Release Modification

12.2(11)YT This command was introduced for the CE network module.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.
12.3(14)T This command was implemented for the Cisco IP VSAT satellite WAN
network module (NM-1VSAT-GILAT).

Usage Guidelines Content Engine Network Module (NM-CE-BP)

There are no usage guidelines for this command.

Cisco IP VSAT Satellite WAN Network Module (NM-1VSAT-GILAT)

For the NM-1VSAT-GILAT network module, the service-module ip address command is typically not
used. The NM-1VSAT-GILAT network module IP address is automatically configured when you enter
the ip address command in satellite interface configuration mode to configure the IP address and subnet
mask of the router satellite interface with these conditions:
• The IP address leaves a remainder of 2 when the last octet is divided by 4.
• The subnet mask has /30 or fewer masking bits.

Cisco IOS Interface and Hardware Component Command Reference

IR-404
 Interface and Hardware Component Commands
service-module ip address

If you use this method to configure the IP address for the router satellite interface, the system
automatically configures the IP address and subnet mask on the NM-1VSAT-GILAT network module
with these results:
• The IP address is 1 less than the IP address that you configured for the router satellite interface.
• The subnet mask is /30.
You can override the automatically configured IP address and mask by manually entering the
service-module ip address command.

Note The automatically configured IP address does not appear in the router configuration, because the
service-module ip address command is considered to be set to its default value. Similarly, if you
manually configure an IP address and subnet mask that are identical to the automatically configured
IP address and subnet mask, the service-module ip address command does not appear in the router
configuration.

Examples This section provides the following examples:

• Content Engine Network Module (NM-CE-BP) Example
• Cisco IP VSAT Satellite WAN Network Module (NM-1VSAT-GILAT) Example—Manually
Configuring the IP Address
• Cisco IP VSAT Satellite WAN Network Module (NM-1VSAT-GILAT) Example—Using the
Automatically Configured IP Address
• Cisco IP VSAT Satellite WAN Network Module (NM-1VSAT-GILAT) Example—Overriding the
Automatically Configured IP Address

Content Engine Network Module (NM-CE-BP) Example

The following example shows how to define an IP address for the internal network-module-side interface
on the CE network module in slot 1:
Router(config)# interface content-engine 1/0
Router(config-if)# service-module ip address 172.18.12.26 255.255.255.0
Router(config-if)# exit

Cisco IP VSAT Satellite WAN Network Module (NM-1VSAT-GILAT)

Example—Manually Configuring the IP Address
In the following example, the router satellite interface is assigned an IP address (10.0.0.7), the last octet
of which does not leave a remainder of 2 when divided by 4. The system displays a message to manually
configure the IP address for the NM-1VSAT-GILAT network module. Notice that the IP addresses for
both the router satellite interface and the NM-1VSAT-GILAT network module appear in the running
configuration.
Router(config)# interface satellite 1/0
Router(config-if)# ip address 10.0.0.7 255.255.255.0

%VSAT-6-PIMINCOMPADDR:The IP address configured on Satellite1/0

requires a manually configured IP address for the satellite module

Router(config-if)# service-module ip address 10.0.0.6 255.255.255.0

Router(config-if)# end

Cisco IOS Interface and Hardware Component Command Reference

IR-405
 Interface and Hardware Component Commands
service-module ip address

Router# show running-config | begin Satellite

Router(config)# interface Satellite 1/0

Router(config-if)# ip address 10.0.0.7 255.255.255.0
Router(config-if)# service-module ip address 10.0.0.6 255.255.255.0
.
.
.

Cisco IP VSAT Satellite WAN Network Module (NM-1VSAT-GILAT)

Example—Using the Automatically Configured IP Address
In the following example, the router satellite interface IP address is configured as 10.0.0.6. Because the
last octet of the IP address leaves a remainder of 2 when divided by 4, the system automatically
configures the IP address for the NM-1VSAT-GILAT network module.
Although the NM-1VSAT-GILAT network module IP address and mask do not appear in the router
configuration, you know that the IP address is 1 less than the IP address of the router satellite interface
and has a subnet mask of /30. In this case, the NM-1VSAT-GILAT network module is automatically
configured with the following IP address and mask: 10.0.0.5 255.255.255.252.
!
Router(config)# interface Satellite 1/0
Router(config-if)#ip address 10.0.0.6 255.255.255.0
!

Cisco IP VSAT Satellite WAN Network Module (NM-1VSAT-GILAT)

Example—Overriding the Automatically Configured IP Address
In the following example, the router satellite interface IP address is configured as 10.0.0.6. Because the
last octet of the IP address leaves a remainder of 2 when divided by 4, the system automatically
configures the IP address and mask for the NM-1VSAT-GILAT network module as 10.0.0.5
255.255.255.252.
Nevertheless, the NM-1VSAT-GILAT network module IP address and mask are manually configured as
10.0.0.1 255.255.255.0 to override the automatically derived IP address and mask. Notice that the IP
addresses for both the router satellite interface and the NM-1VSAT-GILAT network module appear in
the running configuration.
!
Router(config)# interface Satellite 1/0
Router(config-if)# ip address 10.0.0.6 255.255.255.0
Router(config-if)# service-module ip address 10.0.0.1 255.255.255.0
!

Related Commands Command Description

ip address Specifies the IP address for a specified interface.
show controllers Displays controller information for CE network modules.
content-engine
show controllers Displays controller information about the internal router interface that
satellite connects to an installed Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT).

Cisco IOS Interface and Hardware Component Command Reference

IR-406
Interface and Hardware Component Commands
service-module ip address

Command Description
show interfaces Displays general interface settings and traffic rates for the internal router
satellite interface that connects to an installed Cisco IP VSAT satellite WAN
network module (NM-1VSAT-GILAT).
show interfaces Displays basic interface configuration information for a CE network module.
content-engine

Cisco IOS Interface and Hardware Component Command Reference

IR-407
 Interface and Hardware Component Commands
service-module ip default-gateway

service-module ip default-gateway
To define a default gateway (router) for a content engine (CE) network module, use the service-module
ip default-gateway command in content-engine interface configuration mode. To remove the default
gateway from the CE configuration, use the no form of this command.

service-module ip default-gateway gw-ip-addr

no service-module ip default-gateway

Syntax Description gw-ip-addr IP address of the default gateway.

Defaults No default behavior or values

Command Modes Content-engine interface configuration

Command History Release Modification

12.2(11)YT This command was introduced.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.

Examples The following example configures a default gateway for the CE network module in slot 1:
Router(config)# interface content-engine 1/0
Router(config-if)# service-module ip default-gateway 172.18.12.1
Router(config-if)# exit

Related Commands Command Description

interface content-engine Configures an interface for a CE network module and enters
interface configuration mode.
show controllers content-engine Displays controller information for CE network modules.
show interfaces content-engine Displays basic interface configuration information for a CE
network module.

Cisco IOS Interface and Hardware Component Command Reference

IR-408
 Interface and Hardware Component Commands
service-module ip redundancy

service-module ip redundancy
To link the primary HSRP interface status to that of the satellite interface, use the service-module
ip redundancy command in satellite interface configuration mode. To remove the link between the
primary HSRP interface status and the satellite interface status, use the no form of this command.

service-module ip redundancy group-name

no service-module ip redundancy group-name

Syntax Description group-name Name of the hot standby group. This name must match the hot standby group
name configured for the primary HSRP interface, which is typically an
Ethernet interface.

Defaults HSRP is disabled.

Command Modes Satellite interface configuration

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines Use the service-module ip redundancy command only when you have two Cisco IP VSAT satellite
WAN network modules (NM-1VSAT-GILAT) on separate HSRP-redundant routers that connect to the
same outdoor unit (ODU).
This command enables the satellite interface to spoof the line protocol UP state.

Examples The following example shows how to link the primary HSRP interface status to that of the
satellite interface:
service-module ip redundancy grp-hsrp

Related Commands Command Description

standby ip Activates HSRP.
standby name Configures the name of the hot standby group.
standby preempt Enables preemption on the router and optionally configures a preemption
delay.
standby track Configures an interface so that the hot standby priority changes based on the
availability of other interfaces.

Cisco IOS Interface and Hardware Component Command Reference

IR-409
 Interface and Hardware Component Commands
service-module routing redistribute

service-module routing redistribute

To enable the router to send its routing database to the satellite network central hub, use the
service-module routing redistribute command in satellite interface configuration mode. To prevent the
router from sending its routing database over the satellite network, use the no form of this command.

service-module routing redistribute

no service-module routing redistribute

Syntax Description This command has no arguments or keywords.

Defaults The router is enabled to send its routing database to the hub.

Command Modes Satellite interface configuration

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines The service-module routing redistribute command is used on a VSAT router, that is, an earthbound
modular access router equipped with a Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT) that connects to a satellite network. When VSAT route updates are enabled, the
NM-1VSAT-GILAT network module uses Router Blade Configuration Protocol (RBCP) messages to
communicate VSAT routing table changes to the hub.
Entering the no service-module routing redistribute command is useful when you do not want the hub
to be aware of all the routes known by the VSAT router, such as when Network Address Translation
(NAT) is configured on the router.
The hub must learn the remote VSAT routing database for the satellite network to function properly.
Therefore, if you enter the no service-module routing redistribute command, one of the following
actions is required:
• You use RIPv2 as the only routing protocol on your VSAT router. The hub can understand and track
RIPv2 route updates.
• On the hub router, configure static routes to the VSAT router networks.

Examples The following example shows how to prevent the VSAT router from sending its routing database to the
satellite network central hub:
Router(config-if)# no service-module routing redistribute

Cisco IOS Interface and Hardware Component Command Reference

IR-410
 Interface and Hardware Component Commands
service-module satellite backup

service-module satellite backup

To test the hub dial backup connection for the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT), use the service-module satellite backup command in privileged EXEC mode.

service-module satellite slot/unit backup {initiate | terminate}

Syntax Description slot Router chassis slot in which the network module is installed.
/unit Interface number. For NM-1VSAT-GILAT network modules, always use 0.
initiate Initiates a hub dial backup connection.
terminate Terminates a hub dial backup connection.

Defaults No default behavior or values.

Command Modes Privileged EXEC

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines The service-module satellite backup command is used only when you configure hub dial backup for
the Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT).
Normally, the hub dial backup connection comes up only when the satellite link goes down (for example,
because of a rain-fade event). The service-module satellite backup command allows you to artificially
bring down the satellite link to test the hub dial backup connection.

Examples The following example shows how to initiate a satellite backup test:
Router# service-module satellite 1/0 backup initiate

The following example shows how to terminate a running satellite backup test:
Router# service-module satellite 1/0 backup terminate

Related Commands Command Description

service-module Specifies the interface to use to back up the satellite interface on the Cisco IP
backup interface VSAT satellite WAN network module (NM-1VSAT-GILAT).
service-module Sets the terrestrial backup mode for the Cisco IP VSAT satellite WAN
backup mode network module (NM-1VSAT-GILAT).

Cisco IOS Interface and Hardware Component Command Reference

IR-411
 Interface and Hardware Component Commands
service-module satellite configuration

service-module satellite configuration

To enter satellite initial configuration mode, use the service-module satellite configuration command
in user EXEC or privileged EXEC mode.

service-module satellite slot/unit configuration

Syntax Description slot Router chassis slot in which the network module is installed.
/unit Interface number. For NM-1VSAT-GILAT network modules, always use 0.

Defaults No default behavior or values.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines You need a password from your satellite service provider to enter satellite initial configuration mode.
The parameters that you configure in satellite initial configuration mode are saved directly to the
network module and do not appear in the router configuration, even though you configure the parameters
through the Cisco IOS CLI.
To view the parameter values that were configured in satellite initial configuration mode, use one of the
following commands:
• show command in satellite initial configuration mode
• service-module satellite slot/0 status command in privileged EXEC mode

Note Theservice-module satellite configuration command is typically used by an installation technician. Do

not use this command unless your satellite service provider instructs you to perform the satellite initial
configuration and provides all necessary parameter values.

Examples The following example shows how to enter satellite initial configuration mode:
Router> service-module satellite 1/0 configuration
Password: <mypassword>
Reminder:changing any parameters will result in a software reset of the module.
Router(sat-init-config)>

Cisco IOS Interface and Hardware Component Command Reference

IR-412
 Interface and Hardware Component Commands
service-module satellite configuration

Related Commands Command Description

end (satellite initial Exits satellite initial configuration mode, saves any new or changed
configuration) parameters, and resets the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT).
exit (satellite initial Exits satellite initial configuration mode, saves any new or changed
configuration) parameters, and resets the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT).
service-module Displays status information related to the hardware and software on the
satellite status Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT),
including the initial configuration parameters.
show (satellite initial Displays the initial configuration parameters for the Cisco IP VSAT satellite
configuration) WAN network module (NM-1VSAT-GILAT).

Cisco IOS Interface and Hardware Component Command Reference

IR-413
 Interface and Hardware Component Commands
service-module satellite cw-mode

service-module satellite cw-mode

To enable or disable continuous wave mode, use the service-module satellite cw-mode command in
satellite interface configuration mode.

service-module satellite slot/unit cw-mode {off | on frequency frequency [time time]}

Syntax Description slot Router chassis slot in which the network module is installed.
/unit Interface number. For NM-1VSAT-GILAT network modules, always use 0.
off Disables continuous wave mode.
on Enables continuous wave mode.
frequency frequency Frequency, in kilohertz. The range is from 900000 to 1650000.
time time (Optional) Length of time, in seconds, for which continuous wave mode is
enabled. The range is from 60 to 1800.

Defaults Continuous wave mode is disabled.

If the time is not specified, continuous wave mode continues until turned off.

Command Modes Privileged EXEC

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines Continuous wave mode can be enabled only when the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT) is in boot mode.
When continuous wave mode is enabled, the NM-1VSAT-GILAT network module transmits
unmodulated carrier waves that can be used for dish antenna orientation adjustments and for signal
quality measurements.

Note This command is typically used by an installation technician. Do not use this command unless your
satellite service provider instructs you to do so.

Examples The following example shows how to enable continuous wave mode for 2 minutes, at 900000 kilohertz:
Router# service-module satellite 1/0 cw-mode on frequency 900000 time 120
CW mode obtained.

The following example shows how to disable continuous wave mode:

Router# service-module satellite 1/0 cw-mode off
CW mode released.

Cisco IOS Interface and Hardware Component Command Reference

IR-414
Interface and Hardware Component Commands
service-module satellite cw-mode

The following example shows the message that appears when you try to enable continuous wave mode
while the NM-1VSAT-GILAT network module is not in boot mode:
Router# service-module satellite 1/0 cw-mode on frequency 900000 time 120
% CW mode NOT obtained! Valid during boot mode only.

Cisco IOS Interface and Hardware Component Command Reference

IR-415
 Interface and Hardware Component Commands
service-module satellite status

service-module satellite status

To display status information related to the hardware and software on the Cisco IP VSAT satellite
WAN network module (NM-1VSAT-GILAT), including the initial configuration parameters, use the
service-module satellite status command in privileged EXEC mode.

service-module satellite slot/unit status [log]

Syntax Description slot Router chassis slot in which the network module is installed.
/unit Interface number. For NM-1VSAT-GILAT network modules, always use 0.
log (Optional) Extends the output to include the last ring of messages from the
firmware and the last crash dump available from the NM-1VSAT-GILAT
network module.

Defaults No default behavior or values.

Command Modes Privileged EXEC

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines Use the service-module satellite status command to troubleshoot the Cisco IP VSAT satellite WAN
network module (NM-1VSAT-GILAT).

Examples See Table 15 for service-module satellite status command output field descriptions.
This section provides the following examples:
• Normal Operation Example
• Boot Mode Example
• Software Reset Example
• Hub Dial Backup Example
• VoIP Example
• Firmware Debug Log Example

Cisco IOS Interface and Hardware Component Command Reference

IR-416
Interface and Hardware Component Commands
service-module satellite status

Normal Operation Example

The following example shows that the link to the hub (backbone status) is up, as is expected in normal
working conditions:
Router# service-module satellite 2/0 status

Getting status from the satellite module, please wait..

Software Versions, OS:14.2.2, RSP:1.5.1.3, MBC:1.0.0.5

HW Version:00008100
CPA Number:6204, HPS CPA:1, HSP Link:2
AA Group: 258, SW Group: 512, Download: YES
Service Module Uptime:00:06:40, Router Uptime:1 day, 20 hours, 26 minutes
Current router clocktime:*03:11:22.641 UTC Tue Dec 2 2003
Oper Mode:OPERATIONAL, In Dial Backup:NO, Standby:NO, One-Way:NO
RBCP Received Packets:44, RBCP Sent Packets:41
Bit Error Rate:0e-0, Signal to Noise Ratio:12.4453
IP Address/Mask:10.22.1.1/255.255.255.252
Service Module MAC:00:A0:AC:00:20:60
RX Lock:LOCKED, Sync Lock:LOCKED
BackBone Status:UP, Two-Way Mode:YES, DA/RA Mode:RA
Outbound Modulation Type:DVB, OB Code Rate:3/4
Outbound Unicast Packets:61, OB Multicast Packets:23547
Outbound ID:2, OB PID:514, OB Freq:1201000, OB Bit Rate:30000000
Outbound Sync IP address: 172.22.0.3
Inbound Start Freq:1201176, IB Stop Freq:1209336
Inbound Data Rate:307200, IB Freq Offset:0
Inbound Packets:3553
BackBone Hub Link Status:UP
BackBone Received Packets:1, BB Sent:3552
BackBone Received Retransmitted:0, BB Sent Retrans:0
Service Module Eth RX:3550, TX:47110
Service Module Eth Multicast RX:1, Multicast TX:23563
Bufs Configured:5000, Bufs Free:4951
Internal Software State parameters:
Service Module SW State Var:3
General IOS FSM:LINK_UP, HSRP FSM:ACTIVE, HSRP VSAT Mode:ACTIVE
Lost Beats Total:0, Lost Beats This Retry:0
VOIP DA calls:
NONE

Boot Mode Example

The following example shows that the NM-1VSAT-GILAT network module is in boot mode after a
software reset, so that the link to the hub (backbone status) is down:
Router# service-module satellite 1/0 status

Getting status from the satellite module, please wait..

Software Versions, OS:0.0.0, RSP:1.0.0.5, MBC:0.0.0.0

HW Version:001D1757
CPA Number:6204, HPS CPA:0, HSP Link:2
AA Group: 258, SW Group: 512, Download: YES
Service Module Uptime:00:00:14, Router Uptime:1 day, 20 hours, 19 minutes
Current router clocktime:*03:04:38.017 UTC Tue Dec 2 2003
Oper Mode:BOOT, In Dial Backup:NO, Standby:NO, One-Way:NO
RBCP Received Packets:1, RBCP Sent Packets:8
Bit Error Rate:0e-0, Signal to Noise Ratio:12.4453
IP Address/Mask:172.27.1.54/255.255.255.252
Service Module MAC:00:A0:AC:00:20:60
RX Lock:LOCKED, Sync Lock:NOT LOCKED
BackBone Status:DOWN, Two-Way Mode:YES, DA/RA Mode:RA

Cisco IOS Interface and Hardware Component Command Reference

IR-417
 Interface and Hardware Component Commands
service-module satellite status

Outbound Modulation Type:DVB, OB Code Rate:3/4

Outbound Unicast Packets:0, OB Multicast Packets:0
Outbound ID:2, OB PID:514, OB Freq:1201000, OB Bit Rate:30000000
Outbound Sync IP address: 172.22.0.3
Inbound Start Freq:1201176, IB Stop Freq:1209336
Inbound Data Rate:307200, IB Freq Offset:0

COUNTERS OMITTED. Not available at this time.

Internal Software State parameters:

Service Module SW State Var:3
General IOS FSM:LINK_DOWN, HSRP FSM:ACTIVE, HSRP VSAT Mode:ACTIVE
Lost Beats Total:0, Lost Beats This Retry:0
VOIP DA calls:
NONE

Software Reset Example

The following example shows what appears during the beginning stages of a software reset:
Router# service-module satellite 2/0 status

Getting status from the satellite module, please wait..

% Satellite2/0 card is busy. Status is not available. Try later.

Hub Dial Backup Example

The following example shows that the hub dial backup link is being used instead of the satellite link.
Note, however, that hub dial backup keeps the backbone status up. In hub dial backup mode, the
NM-1VSAT-GILAT network module connects to the hub over a specified dial backup link and maintains
TCP connections.
Router# service-module satellite 1/0 status

Getting status from the satellite module, please wait..

Software Versions, OS:14.2.3, RSP:1.5.1.3, MBC:1.0.0.5

HW Version:00008100
CPA Number:3201, HPS CPA:1, HSP Link:2
AA Group: 258, SW Group: 512, Download: YES
Service Module Uptime:02:09:38, Router Uptime:2 hours, 10 minutes
Current router clocktime:*19:28:20.195 UTC Wed Apr 7 2004
Oper Mode:OPERATIONAL, In Dial Backup:YES, Standby:NO, One-Way:NO
RBCP Received Packets:31511, RBCP Sent Packets:31358
Bit Error Rate:0e-0, Signal to Noise Ratio:12.4453
IP Address/Mask:10.0.0.100/255.255.255.0
Service Module MAC:00:A0:AC:00:20:66
RX Lock:LOCKED, Sync Lock:NOT LOCKED
BackBone Status:UP, Two-Way Mode:YES, DA/RA Mode:RA
Outbound Modulation Type:DVB, OB Code Rate:3/4
Outbound Unicast Packets:39944, OB Multicast Packets:45612
Outbound ID:2, OB PID:514, OB Freq:1201000, OB Bit Rate:30000000
Outbound Sync IP address: 172.22.0.3
Inbound Start Freq:1201176, IB Stop Freq:1209336
Inbound Data Rate:307200, IB Freq Offset:0
Inbound Packets:8281
BackBone Hub Link Status:UP
BackBone Received Packets:37894, BB Sent:39162
BackBone Received Retransmitted:1, BB Sent Retrans:12
Service Module Eth RX:37840, TX:129000
Service Module Eth Multicast RX:202, Multicast TX:45970

Cisco IOS Interface and Hardware Component Command Reference

IR-418
Interface and Hardware Component Commands
service-module satellite status

Bufs Configured:5000, Bufs Free:4949

Internal Software State parameters:
Service Module SW State Var:3
General IOS FSM:LINK_UP, HSRP FSM:N/A, HSRP VSAT Mode:N/A
Lost Beats Total:0, Lost Beats This Retry:0

VoIP Example
The following example shows the status of VoIP calls. Note that dedicated access (DA) mode is in use,
and you can see the bandwidth (26 kilobits per second) being used on the DA channels.
Router# service-module satellite 1/0 status

Getting status from the satellite module, please wait..

Software Versions, OS:14.2.3, RSP:1.5.1.3, MBC:1.0.0.5

HW Version:00008100
CPA Number:6202, HPS CPA:1, HSP Link:2
AA Group: 258, SW Group: 512, Download: YES
Service Module Uptime:00:34:53, Router Uptime:2 days, 21 hours, 23 minutes
Current router clocktime:*08:33:51.301 UTC Mon Feb 16 2004
Oper Mode:OPERATIONAL, In Dial Backup:NO, Standby:NO, One-Way:NO
RBCP Received Packets:335, RBCP Sent Packets:332
Bit Error Rate:0e-0, Signal to Noise Ratio:12.4453
IP Address/Mask:10.2.0.2/255.255.0.0
Service Module MAC:00:A0:AC:00:20:67
RX Lock:LOCKED, Sync Lock:LOCKED
BackBone Status:UP, Two-Way Mode:YES, DA/RA Mode:DA
Outbound Modulation Type:DVB, OB Code Rate:3/4
Outbound Unicast Packets:758, OB Multicast Packets:139823
Outbound ID:2, OB PID:514, OB Freq:1201000, OB Bit Rate:30000000
Outbound Sync IP address: 172.22.0.3
Inbound Start Freq:1201176, IB Stop Freq:1209336
Inbound Data Rate:307200, IB Freq Offset:0
Inbound Packets:346
BackBone Hub Link Status:UP
BackBone Received Packets:335, BB Sent:288
BackBone Received Retransmitted:0, BB Sent Retrans:0
Service Module Eth RX:356, TX:280163
Service Module Eth Multicast RX:1, Multicast TX:139918
Bufs Configured:5000, Bufs Free:4951
Internal Software State parameters:
Service Module SW State Var:3
General IOS FSM:LINK_UP, HSRP FSM:N/A, HSRP VSAT Mode:N/A
Lost Beats Total:0, Lost Beats This Retry:0
VOIP DA calls:
Call ID BW (kb) Dst Port Src Port Dest Addr
======== ======= ======== ======== ==============
16075 26 18310 16866 172.20.0.2

Firmware Debug Log Example

The following example includes the firmware debug message log:
Router# service-module satellite 1/0 status log

Getting status from the satellite module, please wait..

Software Versions, OS:14.2.3, RSP:1.5.1.3, MBC:1.0.0.5

HW Version:00008100
CPA Number:1203, HPS CPA:1, HSP Link:2
AA Group: 258, SW Group: 512, Download: YES
Service Module Uptime:19:01:32, Router Uptime:1 week, 4 days, 16 hours,

Cisco IOS Interface and Hardware Component Command Reference

IR-419
 Interface and Hardware Component Commands
service-module satellite status

15 minutes
Current router clocktime:*15:12:45.310 UTC Mon May 13 2002
Oper Mode:OPERATIONAL, In Dial Backup:NO, Standby:NO, One-Way:NO
RBCP Received Packets:9279, RBCP Sent Packets:9276
Bit Error Rate:0e-0, Signal to Noise Ratio:12.4453
IP Address/Mask:172.20.0.6/255.255.255.0
Service Module MAC:00:A0:AC:00:20:72
RX Lock:LOCKED, Sync Lock:LOCKED
BackBone Status:UP, Two-Way Mode:YES, DA/RA Mode:RA
Outbound Modulation Type:DVB, OB Code Rate:3/4
Outbound Unicast Packets:11099797, OB Multicast Packets:429401
Outbound ID:2, OB PID:514, OB Freq:1201000, OB Bit Rate:30000000
Outbound Sync IP address: 172.22.0.3
Inbound Start Freq:1201176, IB Stop Freq:1209336
Inbound Data Rate:307200, IB Freq Offset:0
Inbound Packets:674619
BackBone Hub Link Status:UP
BackBone Received Packets:11084921, BB Sent:93899
BackBone Received Retransmitted:352, BB Sent Retrans:2
Service Module Eth RX:10001424, TX:18532485
Service Module Eth Multicast RX:2615, Multicast TX:431486
Bufs Configured:5000, Bufs Free:1240
Internal Software State parameters:
Service Module SW State Var:3
General IOS FSM:LINK_UP, HSRP FSM:N/A, HSRP VSAT Mode:N/A
Lost Beats Total:4, Lost Beats This Retry:0
VOIP DA calls:
NONE

Last forced reset log from card

===============================
bb 01 e3 a3 28 00 00 10 00 01 ff 6f f0 00 00 10
00 00 2a aa 00 4f f9 5f c4 00 00 01 2a ff ff ff
ff 00 00 80 00 01 ff 6f f0 00 00 00 00 01 ff 76
b0 01 e3 a3 28 00 00 90 02 00 00 00 00 00 00 00
13 00 18 84 1c 00 00 00 00 01 e3 a3 28 00 2b 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 2b 00 00 01 ff 76 b0 00 2a a2 80 00 00 88
88 00 00 90 02 00 0a 7f 58 00 00 00 00 00 00 00
00 40 00 00 43 20 00 00 00 00 00 00 00 01 ff 76
b0 00 00 00 00 01 ff 70 20 ff ff ff

Table 15 describes the significant fields shown in the displays.

Table 15 service-module satellite status Field Descriptions

Field Description
Software Versions Software (not Cisco IOS) and hardware versions on
HW Version the NM-1VSAT-GILAT network module. Useful for
technical support.
CPA Number VSAT-to-hub link parameters.
HPS CPA
HSP Link
AA Group
SW Group
Download

Cisco IOS Interface and Hardware Component Command Reference

IR-420
Interface and Hardware Component Commands
service-module satellite status

Table 15 service-module satellite status Field Descriptions (continued)

Field Description
Oper Mode Operational mode; one of the following values:
• OPERATIONAL—Boot complete and running
operational code.
• BOOT HOLD—Held in boot mode.
• BOOT—In boot mode after a reset.
• IDLE—Transitional state.
• UNKNOWN—Indicates an error.
In Dial Backup YES indicates that the satellite link is down and that the hub
dial backup connection is in use.
NO means that the hub dial backup connection is not in use
or not configured.
Note This field does not indicate whether router dial
backup mode is in use.
Standby YES indicates that the router in which the
NM-1VSAT-GILAT network module is installed is in
standby mode for Hot Standby Router Protocol (HSRP).
NO indicates either that the router in which the
NM-1VSAT-GILAT network module is installed is in active
mode for HSRP or that HSRP is not configured.
One-Way YES indicates one-way operational mode.
NO indicates two-way operational mode.
RBCP Received Packets Number of sent and received Router Blade Configuration
RBCP Sent Packets Protocol (RBCP) packets.
IP Address/Mask IP address and subnet mask of the NM-1VSAT-GILAT
network module.

Cisco IOS Interface and Hardware Component Command Reference

IR-421
 Interface and Hardware Component Commands
service-module satellite status

Table 15 service-module satellite status Field Descriptions (continued)

Field Description
RX Lock Corresponds to the following LEDs on the
Sync Lock NM-1VSAT-GILAT network module faceplate:
• RX LOCK—Indicates whether or not the DVB
(outbound) receiver is locked.
• SYNC—Indicates whether or not the
NM-1VSAT-GILAT network module is synchronized
with the hub timing.
For both fields:
• LOCKED indicates that the initial connection to the hub
was successful. This means that the dish antenna is
positioned correctly and the satellite initial configuration
parameters are valid.
• NOT LOCKED indicates that the NM-1VSAT-GILAT
network module is in a transitional state during the boot
process. If NOT LOCKED does not eventually become
LOCKED, then the satellite initial configuration
parameters are incorrect, there is a hardware problem, or
the satellite signal has faded because of rain-fade or
obstruction.
BackBone Status Backbone link to the hub, either fully established (UP) or not
fully established (DOWN).
Corresponds to the ON LINE LED on the
NM-1VSAT-GILAT network module faceplate.
Two-Way Mode YES indicates two-way operational mode.
NO indicates one-way operational mode.
DA/RA Mode Indicates whether the satellite link is operating in random
access (RA) or dedicated access (DA) mode. DA mode is
required for VoIP calls.
Outbound Modulation Type Satellite initial configuration parameters:
OB Code Rate • Outbound modulation type
Outbound ID • Outbound Viterbi code rate
OB PID • Outbound VSAT ID
OB Freq • Outbound packet identifier (PID)
OB Bit Rate • Outbound frequency
Outbound Sync IP address • Outbound data rate
• Outbound synchronization IP address
Internal Software State parameters Internal states that are useful for technical support.
VOIP DA calls Information about VoIP calls, which use DA mode.
Note This field appears only on routers that run
VoIP-enabled Cisco IOS software images.
Last forced reset log from card Debug information used by technical support.

Cisco IOS Interface and Hardware Component Command Reference

IR-422
 Interface and Hardware Component Commands
service-module satellite status

Related Commands Command Description

show (satellite initial Displays the initial configuration parameters for the Cisco IP VSAT satellite
configuration) WAN network module (NM-1VSAT-GILAT).
show controllers Displays controller information about the internal router interface that
satellite connects to an installed Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT).
show interfaces Displays general interface settings and traffic rates for the internal router
satellite interface that connects to an installed Cisco IP VSAT satellite WAN
network module (NM-1VSAT-GILAT).

Cisco IOS Interface and Hardware Component Command Reference

IR-423
 Interface and Hardware Component Commands
service-module service-engine

service-module service-engine
To enter the Cisco Unity Express command environment using a network module (NM) or an Advanced
Integration Module (AIM) card module, use the service-module service-engine command in privileged
EXEC mode.

service-module service-engine slot/port session

Syntax Description slot Slot number of the NM or AIM.

/port Port number of the NM or AIM.

Defaults No default behavior or values.

Command Modes Privileged EXEC

Command History Release Modification

12.2(15)ZJ This command was introduced for NMs.
12.3(4)T This command was integrated into Cisco IOS Release 12.3(4)T.
12.3(7)T Support was added for AIMs.

Usage Guidelines This command may be used for only NMs and AIMs running Cisco Unity Express. If your system does
not have this hardware, then you will be unable to enter this command.
The no form of this command (no service-module service-engine) is not available. You can enter the
exit command to return to the router.

Examples The following example shows the command for enabling the Cisco Unity Express command
environment using either a NM or AIM located in slot 4, port 0:
Router# service-module service-engine 4/0 session
Router# Trying 172.18.106.66, 2129 ... Open

Cisco IOS Interface and Hardware Component Command Reference

IR-424
 Interface and Hardware Component Commands
service-module t1 cablelength short

service-module t1 cablelength short

To set transmission attenuation for shorter cable lengths, use the service-module t1 cablelength short
command in interface configuration mode. To disable transmission attenuation for shorter cable lengths,
use the no form of this command.

service-module t1 cablelength short {110ft | 220ft | 330ft | 440ft | 550ft | 660ft}

no service-module t1 cablelength short

Syntax Description 110ft Sets a cable length from 0 to 110 feet.

220ft Sets a cable length from 111 to 220 feet.
330ft Sets a cable length from 221 to 330 feet.
440ft Sets a cable length from 331 to 440 feet.
550ft Sets a cable length from 441 to 550 feet.
660ft Sets a cable length from 551 to 660 feet.

Defaults No default behavior or values

Command Modes Interface configuration

Command History Release Modification

12.2(15)ZL This command was introduced.
12.3(2)T This command was integrated into Cisco IOS Release 12.3(2)T.

Usage Guidelines This command is intended only for the Version 2 card, WIC-1-DSU-T1 V2, as part of the
service-module t1 configuration options.
Use this command to configure the transmission (tx) attenuation for cables whose length is shorter than
or equal to 660 feet. The related command, service-module t1 lbo, is used to define the line-build-out
values for cable lengths longer than 660ft. At any time, only one, either the short configuration or the
lbo configuration, can exist. They cannot co-exist. The configuration of one command will cause the
effect of the other command to cease and only the new command will be in effect.

Examples The following example shows how to set the short cablelength to 220 feet.
Router(config)# interface serial 0/0
Router(config-if)# service-module t1 cablelength short 220ft

Cisco IOS Interface and Hardware Component Command Reference

IR-425
 Interface and Hardware Component Commands
service-module t1 cablelength short

Related Commands Command Description

service-module t1 lbo Configures the CSU line-build-out (lbo) on a fractional T1/T1
DSU/CSU module.

Cisco IOS Interface and Hardware Component Command Reference

IR-426
 Interface and Hardware Component Commands
service-module t1 clock source

service-module t1 clock source

To specify the clock source for the fractional T1/T1 CSU/DSU module, use the service-module t1 clock
source command in interface configuration mode. To return to the default line clock, use the no form of
this command.

service-module t1 clock source {internal | line}

no service-module t1 clock source

Syntax Description internal Specifies the CSU/DSU internal clock.

line Specifies the line clock. This is the default.

Defaults Line clock

Command Modes Interface configuration

Command History Release Modification

11.2 This command was introduced.

Examples The following example sets an internal clock source on serial line 0:
Router(config)# interface serial 0
Router(config-if)# service-module t1 clock source internal

Related Commands Command Description

service-module 56k clock source Sets up the clock source on a serial interface for a 4-wire,
56/64-kbps CSU/DSU module.

Cisco IOS Interface and Hardware Component Command Reference

IR-427
 Interface and Hardware Component Commands
service-module t1 data-coding

service-module t1 data-coding
To guarantee the ones density requirement on an alternate mark inversion (AMI) line using the fractional
T1/T1 module, use the service-module t1 data-coding command in interface configuration mode. To
enable normal data transmission, use the no form of this command.

service-module t1 data-coding {inverted | normal}

no service-module t1 data-coding

Syntax Description inverted Inverts bit codes by changing all 1 bits to 0 bits and all 0 bits to 1 bits.
normal Requests that no bit codes be inverted before transmission. This is the default.

Defaults Normal transmission

Command Modes Interface configuration

Command History Release Modification

11.2 This command was introduced.

Usage Guidelines Data inversion is used to guarantee the ones density requirement on an AMI line when using bit-oriented
protocols such as High-Level Data Link Control (HDLC), PPP, X.25, and Frame Relay. If the time slot
speed is set to 56 kbps, this command is rejected because line density is guaranteed when transmitting
at 56 kbps. Use this command with the 64-kbps line speed.
If you transmit inverted bit codes, both CSU/DSUs must have this command configured for successful
communication.

Examples The following example inverts bit codes using a time slot speed of 64 kbps:
Router(config)# interface serial 0
Router(config-if)# service-module t1 timeslots all speed 64
Router(config-if)# service-module t1 data-coding inverted

Related Commands Command Description

service-module t1 linecode Selects the linecode for the fractional T1/T1 module.
service-module t1 timeslots Defines time slots that constitute a fractional T1/T1 (FT1/T1) channel.

Cisco IOS Interface and Hardware Component Command Reference

IR-428
 Interface and Hardware Component Commands
service-module t1 fdl

service-module t1 fdl
To set the facilities data link (FDL) parameter to either ATT or ANSI, use the service-module t1 fdl
command in interface configuration mode. To ignore the FDL parameter, use the no form of this
command.

service-module t1 fdl {ansi | att}

no service-module t1 fdl

Syntax Description ansi Sets the FDL parameter to ANSI.

att Sets the FDL parameter to ATT.

Defaults Determined by the telephone company

Command Modes Interface configuration

Command History Release Modification

11.2 P This command was introduced.

Usage Guidelines The default is no service-module t1 fdl. The ansi or att options are determined by your service provider
or telephone company.

Examples The following example sets the FDL parameter to ANSI:

Router(config)# interface serial 0
Router(config-if)# service-module t1 fdl ansi

Cisco IOS Interface and Hardware Component Command Reference

IR-429
 Interface and Hardware Component Commands
service-module t1 framing

service-module t1 framing
To select the frame type for a line using the fractional T1/T1 (FT1/T1) module, use the service-module
t1 framing command in interface configuration mode. To revert to the default, Extended Super Frame,
use the no form of this command.

service-module t1 framing {esf | sf}

no service-module t1 framing {esf | sf}

Syntax Description esf Specifies extended super frame (ESF) as the T1 frame type. This is the default.
sf Specifies D4 super frame (SF) as the T1 frame type.

Defaults esf

Command Modes Interface configuration

Command History Release Modification

11.2 This command was introduced.

Usage Guidelines Use this command in configurations in which the router communicates with FT1/T1 data lines. The
service provider determines which framing type, either esf or sf, is required for your circuit.

Examples The following example enables Super Frame as the FT1/T1 frame type:
Router(config-if)# service-module t1 framing sf

Cisco IOS Interface and Hardware Component Command Reference

IR-430
 Interface and Hardware Component Commands
service-module t1 lbo

service-module t1 lbo
To configure the CSU line-build-out (LBO) on a fractional T1/T1 CSU/DSU module, use the
service-module t1 lbo command in interface configuration mode. To disable line-build-out, use the no
form of this command.

service-module t1 lbo {-15 db | -7.5 db | none}

no service-module t1 lbo {-15 db | -7.5 db | none}

Syntax Description -15 db Decreases outgoing signal strength by 15 dB.

-7.5 db Decreases outgoing signal strength by 7.5 dB.
none Transmits packets without decreasing outgoing signal strength.

Defaults Disabled

Command Modes Interface configuration

Command History Release Modification

11.2 This command was introduced.

Usage Guidelines Use this command to decrease the outgoing signal strength to an optimum value for a fractional T1 line
receiver. The ideal signal strength should be –15 dB to –22 dB, which is calculated by adding the phone
company loss, cable length loss, and line build out.
You may use this command in back-to-back configurations, but it is not needed on most actual T1 lines.

Examples The following example sets the LBO to –7.5 dB:

Router(config)# interface serial 0
Router(config-if)# service-module t1 lbo -7.5 db

Cisco IOS Interface and Hardware Component Command Reference

IR-431
 Interface and Hardware Component Commands
service-module t1 linecode

service-module t1 linecode
To select the line code for the fractional T1/T1 module, use the service-module t1 linecode command
in interface configuration mode. To select the default, the B8ZS line code, use the no form of this
command.

service-module t1 linecode {ami | b8zs}

no service-module t1 linecode {ami | b8zs}

Syntax Description ami Specifies alternate mark inversion (AMI) as the line code.
b8zs Specifies binary 8 zero substitution (B8ZS) as the line code. This is the default.

Defaults The default line code is B8ZS.

Command Modes Interface configuration

Command History Release Modification

11.2 This command was introduced.

Usage Guidelines Configuring B8ZS is a method of ensuring the ones density requirement on a T1 line by substituting
intentional bipolar violations in bit positions four and seven for a sequence of eight zero bits. When the
CSU/DSU is configured for AMI, you must guarantee the ones density requirement in your router
configuration using the service-module t1 data-coding inverted command or the service-module t1
time slots speed 56 command.
Your T1 service provider determines which line code, either ami or b8zs, is required for your T1 circuit.

Examples The following example specifies AMI as the line code:

Router(config)# interface serial 0
Router(config-if)# service-module t1 linecode ami

Related Commands Command Description

service-module t1 data-coding Guarantees the ones density requirement on an AMI line using the
fractional T1/T1 module.
service-module t1 timeslots Defines time slots that constitute a fractional T1/T1 (FT1/T1)
channel.

Cisco IOS Interface and Hardware Component Command Reference

IR-432
 Interface and Hardware Component Commands
service-module t1 remote-alarm-enable

service-module t1 remote-alarm-enable
To generate remote alarms (yellow alarms) at the local CSU/DSU or detect remote alarms sent from the
remote CSU/DSU, use the service-module t1 remote-alarm-enable command in interface
configuration mode. To disable remote alarms, use the no form of this command.

service-module t1 remote-alarm-enable

no service-module t1 remote-alarm-enable

Syntax Description This command has no arguments or keywords.

Defaults Remote alarms are disabled.

Command Modes Interface configuration

Command History Release Modification

11.2 This command was introduced.

Usage Guidelines Remote alarms are transmitted by the CSU/DSU when it detects an alarm condition, such as a red alarm
(loss of frame) or blue alarm (unframed ones). The receiving CSU/DSU then knows that there is an error
condition on the line.
With D4 Super Frame configured, a remote alarm condition is transmitted by setting the bit 2 of each
time slot to zero. For received user data that has the bit 2 of each time slot set to zero, the CSU/DSU
interprets the data as a remote alarm and interrupts data transmission, which explains why remote alarms
are disabled by default. With Extended Super Frame configured, the remote alarm condition is signalled
out of band in the facilities data link.
You can see if the FT1/T1 CSU/DSU is receiving a remote alarm (yellow alarm) by issuing the show
service-module serial command.

Examples The following example enables remote alarm generation and detection:
Router(config)# interface serial 0
Router(config-if)# service-module t1 remote-alarm-enable

Related Commands Command Description

service-module t1 framing Selects the frame type for a line using the fractional T1/T1 (FT1/T1)
module.
show service-module serial Displays performance statistics for an integrated CSU/DSU.

Cisco IOS Interface and Hardware Component Command Reference

IR-433
 Interface and Hardware Component Commands
service-module t1 remote-loopback

service-module t1 remote-loopback
To specify that the fractional T1/T1 DSU/CSU module enters loopback mode when it receives a
loopback code on the line, use the service-module t1 remote-loopback command in interface
configuration mode. To disable remote loopbacks, use the no form of this command.

service-module t1 remote-loopback {full | payload v54}

no service-module t1 remote-loopback {full | payload v54

Syntax Description full Configures the remote loopback code used to transmit or accept CSU
loopback requests.
payload Configures the loopback code used by the local CSU/DSU to generate or
detect payload-loopback commands.
v54 Industry standard loopback code. Use this keyword for CSU/DSUs that may
not support the Accunet loopup standards. This keyword is used only with
a payload request, not a full request.

Use the full keyword to enable the standard loopup codes, which use a 1-in-5 pattern for loopup and a
1-in-3 pattern for loopdown. Use the payload v54 keywords to enable the v54 pseudo-random loopup codes
for loopup and v54 pseudo-random loopdown codes for loopdown.

Defaults Full and payload loopbacks with standard loopup codes

Command Modes Interface configuration

Command History Release Modification

11.2 This command was introduced.
12.3(2)T The provision for an alternate loopback code was removed.

Usage Guidelines The no form of this command disables loopback requests. For example, the no service-module t1
remote-loopback full command ignores all full-bandwidth loopback transmissions and requests.
Configuring the no form of the command might not prevent telco line providers from looping your router in
extended super frame (esf) mode because fractional T1/T1 lines use facilities data link messages to initiate
loopbacks.
To have the loopback remote commands on the FT1/T1 CSU/DSU module function successfully, you need to
enable the service-module t1 remote-loopback command.

Note Use the full keyword to enable the standard loopup codes, which use a 1-in-5 pattern for loopup and a
1-in-3 pattern for loopdown. Use the payload v54 keywords to enable the v54 pseudorandom codes for
loopup and v54 pseudorandom codes for loopdown.

Cisco IOS Interface and Hardware Component Command Reference

IR-434
 Interface and Hardware Component Commands
service-module t1 remote-loopback

Examples The following example shows how to configure two routers connected back-to-back through a fractional
T1/T1 line to enter loopback mode:
Router(config)# interface serial 0/0
Router(config-if)# service-module t1 remote-loopback full
Router(config-if)# loopback remote full
!
%SERVICE_MODULE-5-LOOPUPREMOTE: Unit Serial0/0 - Remote unit placed in loopback

Router(config-if)# no loopback remote

%SERVICE_MODULE-5-LOOPDOWNREMOTE: Unit Serial0/0 - Remote loopback test cancelled

The following example shows how to configure two routers connected back-to-back through a
fractional T1/T1 line to enter loopback mode and generate or detect payload-loopback
commands:

Router(config-if)# service-module t1 remote-loopback payload v54

Router(config-if)# loopback remote payload

%%SERVICE_MODULE-5-LOOPUPREMOTE: Unit Serial0/0 - Remote unit placed in loopback

Related Commands Command Description

loopback remote (interface) Loops packets through a DSU/CSU to a remote DSU/CSU and
back over a channelized T1 link.

Cisco IOS Interface and Hardware Component Command Reference

IR-435
 Interface and Hardware Component Commands
service-module t1 timeslots

service-module t1 timeslots
To define time slots that constitute a fractional T1/T1 (FT1/T1) channel, use the service-module t1
timeslots command in interface configuration mode. To resume the default setting (all FT1/T1 time slots
transmit at 64 kbps), use the no form of this command.

service-module t1 timeslots {range | all} [speed {56 | 64}]

no service-module t1 timeslots {range | all}

Syntax Description range The DS0 time slots that constitute the FT1/T1 channel. The range is from 1 to 24,
where the first time slot is numbered 1 and the last time slot is numbered 24. Specify
this field by using a series of subranges separated by commas.
all Selects all FT1/T1 time slots.
speed (Optional) Specifies the time slot speed.
56 (Optional) 56 kbps.
64 (Optional) 64 kbps. This is the default.

Defaults 64 kbps is the default for all time slots.

Command Modes Interface configuration

Command History Release Modification

11.2 This command was introduced.

Usage Guidelines This command specifies which time slots are used in fractional T1 operation and determines the amount
of bandwidth available to the router in each FT1/T1 channel.
The time-slot range must match the time slots assigned to the channel group. Your service provider
defines the time slots that comprise a channel group.
To use the entire T1 line, enable the service-module t1 timeslots all command.

Examples The following example displays a series of time-slot ranges and a speed of 64 kbps:
Router(config-if)# service-module t1 timeslots 1-10,15-20,22 speed 64

Related Commands Command Description

service-module t1 data-coding Guarantees the ones density requirement on an AMI line using the
fractional T1/T1 module.
service-module t1 linecode Selects the linecode for the fractional T1/T1 module.

Cisco IOS Interface and Hardware Component Command Reference

IR-436
Interface and Hardware Component Commands
service-module t1 timeslots

Cisco IOS Interface and Hardware Component Command Reference

IR-437
 Interface and Hardware Component Commands
set ip df

set ip df
To change the Don’t Fragment (DF) bit value in the IP header, use the set ip df command in route-map
configuration mode. To disable changing the DF bit value, use the no form of this command.

set ip df {0 | 1}

no set ip df {0 | 1}

Syntax Description 0 Sets the DF bit to 0 (clears the DF bit ) and allows packet fragmentation.
1 Sets the DF bit to 1 which prohibits packet fragmentation.

Defaults The DF bit value is not changed in the IP header.

Command Modes Route-map configuration

Command History Release Modification

12.1(6) This command was introduced.

Usage Guidelines Using Path MTU Discovery (PMTUD) you can determine an MTU value for IP packets that avoids
fragmentation. If ICMP messages are blocked by a router, the path MTU is broken and packets with the
DF bit set are discarded. Use the set ip df command to clear the DF bit and allow the packet to be
fragmented and sent. Fragmentation can slow the speed of packet forwarding on the network but access
lists can be used to limit the number of packets on which the DF bit will be cleared.

Note Some IP transmitters (notably some versions of Linux) may set the identification field in the
IP header (IPid) to zero when the DF bit is set. If the router should clear the DF bit on such a packet
and if that packet should subsequently be fragmented, then the IP receiver will probably be unable
to correctly reassemble the original IP packet.

Examples The following example shows how to clear the DF bit to allow fragmentation. In this example a router
is blocking ICMP messages and breaking the path MTU. Using policy routing both the inbound and
outbound packets on interface serial 0 will have their DF bit set to 0 which allows fragmentation.
interface serial 0

ip policy route-map clear-df-bit

route-map clear-df-bit permit 10
match ip address 111
set ip df 0

access-list 111 permit tcp any any

Cisco IOS Interface and Hardware Component Command Reference

IR-438
 Interface and Hardware Component Commands
set ip df

Related Commands Command Description

ip tcp path-mtu-discovery Enables Path MTU Discovery.
route-map Defines a route map to control where packets are output.

Cisco IOS Interface and Hardware Component Command Reference

IR-439
 Interface and Hardware Component Commands
show alarm-interface

show alarm-interface
To display the alarm interface controller (AIC) configuration setting and the information sent to the
Cisco IOS software by the AIC, use the show alarm-interface command in privileged EXEC mode.

show alarm-interface [slot-number] [summary]

Syntax Description slot-number (Optional) Slot number in which the AIC was placed.
summary (Optional) Selects the summary format for the output message.

Defaults Displays verbose message output and displays all AICs in all slot numbers on the router.

Command Modes Privileged EXEC

Command History Release Modification

12.2(2)XG This command was introduced on the Cisco 2600 series and Cisco 3600 series.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T.

Examples The following is sample output from the show alarm-interface summary command:
Router# show alarm-interface 5 summary

Alarm Interface Card in Slot 5:

Configured IP address:10.2.130.102
Status: KEEPALIVE TIMER EXPIRED
Alarm Interface Card in Slot 5:
Configured IP address:10.2.130.102
Status:KEEPALIVE TIMER EXPIRED

The following is an example of a verbose show alarm-interface display:

Router# show alarm-interface 4

Alarm Interface Card in Slot 4:

Configured IP address: 10.10.10.2
Status: RUNNING
Timer expires in < 11 min.
Reported version: 00 00 00 01
Expected version: 00 00 00 01
Last Self Test result: READY
Last Start-Up message:
----------
<AIC>: Hardware Version 1, Revision A Software Version 2, Revision A 1.0.1 Installed and
running, POST passed.
----------
Last Status severity: 0
Last Status message:
----------
Status
----------

Cisco IOS Interface and Hardware Component Command Reference

IR-440
 Interface and Hardware Component Commands
show alarm-interface

Table 16 describes significant fields shown in this output.

Table 16 show alarm-interface Field Descriptions

Field Description
Alarm Interface Card in Card type and slot number.
Slot
Configured IP address Configured IP address
Status AIC card status. Can be one of the following:
• HARDWARE DETECTED
• RUNNING
• HARDWARE NOT PRESENT
• KEEPALIVE TIMER EXPIRED
Timer expires in Current value of the KEEPALIVE TIMER, or states if the timer has been
disabled. This line is only active when the status line reads HARDWARE
DETECTED or RUNNING.
Used in troubleshooting to detect operational failures of the AIC.
Reported version Active software version number.
Comparing the reported version to the expected version may reveal
possible incompatibilities between the AIC’s software and the IOS image.
Expected version Expected software version number.
Comparing the reported version to the expected version may reveal
possible incompatibilities between the AIC’s software and the IOS image.
Last Self Test result Result of the AIC’s power on self-test (POST).
Last Start-Up message Startup messages.
<AIC> AIC. Includes version and activity information.
Last Status severity Rates the severity of the status message. Any number other than 0
indicates a need for intervention. The number 1 indicates the most severe
condition.
Last Status message Last status message.

Related Commands Command Description

alarm-interface Enters the alarm interface mode and configures the AIC.

Cisco IOS Interface and Hardware Component Command Reference

IR-441
 Interface and Hardware Component Commands
show aps

show aps
To display information about the current automatic protection switching (APS) feature, use the show aps
command in privileged EXEC mode.

show aps

Syntax Description This command has no arguments or keywords.

Command Modes Privileged EXEC

Command History Release Modification

11.1 CC This command was introduced.

Examples The following is sample output from the show aps command on a router configured with a working
interface. In this example, POS interface 0/0/0 is configured as a working interface in group 1, and the
interface is selected (that is, active).
Router1# show aps

POS0/0/0 working group 1 channel 1 Enabled Selected

The following is sample output from the show aps command on a router configured with a protect
interface. In this example, POS interface 2/0/0 is configured as a protect interface in group 1, and the
interface is not selected (the ~ indicates that the interface is not active). The output also shows that the
working channel is located on the router with the IP address 10.1.6.1 and that the interface is currently
selected (that is, active).
Router2# show aps

POS2/0/0 protect group 1 channel 0 bidirectional ~Selected

Rx_K1= 0, Rx_K2= 0 Tx_K1= 0 Tx_K2= 5
Working channel 1 at 10.1.6.1 Enabled

For the K1 field (8 bits), the first 4 bits indicate the channel number that has made the request, and the
last 4 bits map to the requests (local or external) listed in Table 17. For the K2 field (8 bits), the first 4
bits indicate the channel number bridged onto the protect line, the next bit is the architecture used, and
the last 3 bits indicate the mode of operation or non-APS use listed in Table 17.

Table 17 K1 Bit Descriptions

Bits (Hexadecimal) Description

K1 bits 8765 K1 bits 8 through 5: Channel number that made the request.
K1 bits 4321 K1 bits 4 through 1: Type of request.
1111 (0xF) Lockout of protection request.
1110 (0xE) Forced switch request.
1101 (0xD) Signal failure (SF)—high priority request.

Cisco IOS Interface and Hardware Component Command Reference

IR-442
Interface and Hardware Component Commands
show aps

Table 17 K1 Bit Descriptions (continued)

Bits (Hexadecimal) Description

1100 (0xC) Signal failure (SF)—low priority request.
1011 (0xB) Signal degradation (SD)—high priority request.
1010 (0xA) Signal degradation (SD)—low priority request.
1001 (0x9) Not used.
1000 (0x8) Manual switch request.
0111 (0x7) Not used.
0110 (0x6) Wait to restore request.
0101 (0x5) Not used.
0100 (0x4) Exercised request.
0011 (0x3) Not used.
0010 (0x2) Reverse request.
0001 (0x1) Do not revert request.
0000 (0x0) No request.

Cisco IOS Interface and Hardware Component Command Reference

IR-443
 Interface and Hardware Component Commands
show cable bundle

show cable bundle

To display the forwarding table for the specified interface, use the show cable bundle command in
privileged EXEC mode.

show cable bundle bundle-number forwarding-table

Syntax Description bundle-number Specifies the bundle identifier. Valid range is from 1 to 255.
forwarding-table Displays the forwarding table for the specified interface.

Command Modes Privileged EXEC

Command History Release Modification

12.0(7)XR This command was introduced.

Examples In the following example, a cable bundle of 25 is specified:

Router# show cable bundle 25 forwarding-table

MAC address Interface

0050.7366.17ab Cable3/0
0050.7366.1803 Cable3/0
0050.7366.1801 Cable3/0

Table 18 describes the significant fields shown in the display.

Table 18 show cable bundle Field Descriptions

Field Description
MAC address Media Access Control ID for each interface in the bundle.
Interface The cable interface slot and port number.

Related Commands Command Description

cable bundle Creates an interface bundle.

Cisco IOS Interface and Hardware Component Command Reference

IR-444
 Interface and Hardware Component Commands
show cem

show cem
To display circuit emulation (CEM) statistics, use the show cem command in privileged EXEC mode.

show cem {slot/port/channel | summary}

Syntax Description slot Slot number where the Circuit Emulation over IP (CEoIP) network module
(NM) is installed on the networking device.
/port Port number on the CEoIP NM. The slash mark is required between the slot
argument and the port argument.
/channel Channel number that identifies the channel that you want to configure
(T1/E1 only). The channel number on a serial port is always 0. The slash
mark is required between the port argument and the channel argument.
summary Displays summary CEM statistics.

Command Modes Privileged EXEC

Command History Release Modification

12.3(7)T This command was introduced.

Examples The following example shows a summary of some of the configuration parameters of the CEM channels.
Router(config-cem)# show cem summary

cem summary

CSTATE: CEM state

LSTATE: line state
OSTATE: operational state
PSIZE: payload-size
PCOMP: payload-compression
DPROT: data-protection

CEM CSTATE LSTATE OSTATE PSIZE PCOMP DPROT

----------------------------------------------------------------------
2/0/0 shutdown up config-incomplete 256 disabled disabled
2/1/0 shutdown up config-incomplete 256 disabled disabled
2/2/0 shutdown up config-incomplete 256 disabled disabled
2/3/0 shutdown up config-incomplete 256 disabled disabled
4/0/1 up up active 96 enabled disabled
4/0/2 up up active 96 enabled disabled
4/0/3 up up active 96 enabled disabled
4/0/4 up up active 96 enabled disabled
4/0/5 up up active 96 enabled disabled
4/0/6 up up active 96 enabled disabled
4/0/7 up up active 96 disabled disabled
4/0/8 up up active 96 disabled disabled
4/0/9 up up active 96 disabled disabled
4/0/10 up up active 96 disabled disabled
4/0/11 up up active 96 disabled disabled

Cisco IOS Interface and Hardware Component Command Reference

IR-445
 Interface and Hardware Component Commands
show cem

4/0/12 up up active 96 disabled disabled

4/0/13 up up active 96 disabled disabled
4/0/14 up up active 96 disabled disabled
4/1/1 down down config-incomplete 96 enabled disabled
4/1/2 down down config-incomplete 96 enabled disabled
4/1/3 down down config-incomplete 96 enabled disabled
4/1/4 down down config-incomplete 96 enabled disabled
4/1/5 down down config-incomplete 96 enabled disabled
4/1/6 down down config-incomplete 96 enabled disabled
4/1/7 down down config-incomplete 96 disabled disabled
4/1/8 down down config-incomplete 96 disabled disabled
4/1/9 down down config-incomplete 96 disabled disabled
4/1/10 down down config-incomplete 96 disabled disabled
4/1/11 down down config-incomplete 96 disabled disabled
4/1/12 down down config-incomplete 96 disabled disabled
4/1/13 down down config-incomplete 96 disabled disabled
4/1/14 down down config-incomplete 96 disabled disabled

Table 19 describes the significant fields shown in the display.

Table 19 show cem summary Field Descriptions

Field Description
CEM Displays the slot, port, and channel number of a CEM
channel.
CSTATE Displays the current state of a CEM channel. The state can be
one of the following:
• up—The channel is receiving valid packets from a source
CEM channel.
• down—The channel is receiving no packets (for
example, the dejitter buffer is empty).
• shutdown—The CEM channel has been administratively
shut down.
LSTATE Displays the current line state of a CEM channel. The line
state can be one of the following:
• up—The line is ready.
• down—The line is down. A T1 or E1 line is down when
the line is experiencing a physical-layer failure, such as
loss of signal (LOS), loss of multiframe alignment
(OOF), or alarm indication signal (AIS). A serial line is
down when no cable is attached to the port.

Cisco IOS Interface and Hardware Component Command Reference

IR-446
 Interface and Hardware Component Commands
show cem

Table 19 show cem summary Field Descriptions (continued)

Field Description
OSTATE Displays the current operational state of a CEM channel. The
operational state can be one of the following:
• config-incomplete—The channel is in a
config-incomplete state when any of the following
conditions exist:
– An xconnect is not defined.
– A local IP address is not defined.
– A local UDP port is not defined.
– A remote UDP port is not defined.
– The CEM channel is administratively shut down.
• enabled—If none of the conditions for the
config-incomplete state exists, but the CEM channel is
receiving no packets from the remote side, the CEM
channel is in an enabled state.
• config-mismatch—If packets are arriving from the
remote side but with a different payload size, data
protection setting, or compression setting, the channel is
in the config-mismatch state.
• active—The CEM channel is active if none of the
conditions outlined above exist.
PSIZE Payload size configured for the CEM channel, in bytes.
PCOMP Displays whether payload compression is enabled or disabled
for the CEM channel.
DPROT Displays whether data protection is enabled or disabled for
the CEM channel.

Related Commands Commands Description

cem Enters circuit emulation configuration mode.
clear cem Clears CEM statistics.

Cisco IOS Interface and Hardware Component Command Reference

IR-447
 Interface and Hardware Component Commands
show chassis

show chassis
To display processor and memory information, use the show chassis command in privileged EXEC
mode.

show chassis [clocks | slot slot-number | split]

Syntax Description clocks (Optional) Displays trunk (T1/E1) clock information.

slot slot-number (Optional) Displays slot-specific information.
split (Optional) Displays split-related data.

Command Modes Privileged EXEC

Command History Release Modification

12.2(2)XB1 This command was introduced on the Cisco AS5850 universal gateway.
12.2(11)T This command was integrated into Cisco IOS Release 12.2(11)T.

Usage Guidelines You must enter this command from one of the route-switch-controller (RSC) cards.
Use the show chassis command to display additional output relevant to handover-split mode. Command
output shows the RSC card to be configured with all slots of the entire chassis, regardless of configured
ownership. Slots owned by the peer RSC are shown in the ignore state, properly configured and ready to
go.

Examples The following example shows output for a system in handover-split mode. Each RSC is shown to be
configured with all slots in the entire chassis, regardless of whether the RSC actually owns the slot. Slots that
are not owned by an RSC are shown to be in the ignore state. The RSC from which the command is entered
owns slots 0 to 5, but has configured for it all slots (0 to 5 and 8 to 13—all slots except those in which the
RSCs are inserted). Entries for slots 8 and 10 show the designator “ignore.”
Router# show chassis

System is in handover-split mode, RSC in slot 6.

!
Slots owned: 0 1 2 3 4 5
Slots configured: 0 1 2 3 4 5 8 9 10 11 12 13
Slots owned by other: 8 9 10 11 12 13
Slot Board CPU DRAM I/O Memory State Elapsed
Type Util Total (free) Total (free) Time
5 UP324 0%/0% 26814176( 20%) 33554432( 45%) Up 01:02:54
8 CT3_UP216 0( 0%) 0( 0%) Ignore 01:05:19
10 UP324 0( 0%) 0( 0%) Ignore 01:05:19

The following example shows output for a system in classic-split mode. The RSC from which the
command is entered owns slots 0 to 5, and has configured for it only those same slots 0 to 5.
Router# show chassis

Cisco IOS Interface and Hardware Component Command Reference

IR-448
 Interface and Hardware Component Commands
show chassis

System is in classic-split mode, RSC in slot 6.

Slots owned: 0 1 2 3 4 5
Slots configured: 0 1 2 3 4 5
Slots owned by other: 8 9 10 11 12 13

The following example shows details for the card in slot 0:

Router# show chassis slot 0

Slot: 0, Type: 24 E1 Ports (700)

CPU utilization: 0%/0% (5 secs); 0% (1 min); 0% (5 mins)
Memory: Total(b) Used(b) Free(b) Lowest(b) Largest(b)
Processor 59304928 16307688 42997240 42817836 42819352
I/O 67108864 8200288 58908576 58515056 58515004
State: IOS up; elapsed time in state: 13:28:35
Flags:
FB_FLAGS_PRESENT
FB_FLAGS_LINECARD
FB_FLAGS_ANALYZED
FB_FLAGS_CHECKPOINT
Inserted: 13:39:30 ago
Last update: 00:00:08 ago

Table 20 describes significant fields shown in this output.

Table 20 show chassis Fields Descriptions

Table 1

Field Description
Slot Slot number.
Type Card type.
CPU utilization CPU usage in percentages.
Memory Current processor and I/O memory values.
State Current state of slot and time in hours, minutes, and seconds that the slot
has spent in current state.
Flags Displays a sequence of flag states that the slot has been through.
Inserted Time in hours, minutes, and seconds since the slot was inserted into the
chassis.
Last Update Time in hours, minutes, and seconds since the last update message was
sent.

Related Commands Command Description

show dial-shelf Displays information about dial shelves.

Cisco IOS Interface and Hardware Component Command Reference

IR-449
 Interface and Hardware Component Commands
show compress

show compress
To display compression statistics, use the show compress command in user EXEC or privileged EXEC
mode.

show compress

Syntax Description This command has no arguments or keywords.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

10.0 This command was introduced.
11.3 An example for hardware compression was added as implemented in the
Canadian Standards Association (CSA) hardware.

Examples The following is a sample output from the show compress command when software compression is used
on the router:
Router# show compress

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

Table 21 describes the fields shown in the display.

Table 21 show compress Field Descriptions—Software Compression

Field Description
Serial0 Name and number of the interface.
uncompressed bytes Total number of uncompressed bytes sent and received.
xmt/rcv
1 min avg ratio xmt/rcv Static compression ratio for bytes sent and received, averaged over 1, 5,
and 10 minutes.
5 min avg ratio xmt/rcv
10 min avg ratio xmt/rcv
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 (for example, line errors could cause resets).

Cisco IOS Interface and Hardware Component Command Reference

IR-450
 Interface and Hardware Component Commands
show compress

The following is a sample output from the show compress command when hardware compression is
enabled (that is, compression is implemented in the CSA hardware):
Router# show compress

Serial6/1
Hardware compression enabled
CSA in slot3 in use
Compressed bytes sent: 402 bytes 0 Kbits/sec ratio: 4.092
Compressed bytes recv: 390 bytes 0 Kbits/sec ratio: 3.476
restarts:1
last clearing of counters: 1278 seconds

Table 22 describes the fields shown in the display. The information displayed by the show compress
command is the same for hardware and distributed compression. For Cisco 7200 series routers with
multiple CSAs, an additional line is displayed indicating the CSA in use.

Table 22 show compress Field Descriptions—Hardware or Distributed Compression

Field Description
Serial6/1 Name and number of the interface.
Hardware compression Type of compression.
enabled
CSA in slot3 in use Identifies the CSA that is performing compression service.
Compressed bytes sent Total number of compressed bytes sent including the kilobits per
second.
Compressed bytes recv Total number of compressed bytes received including the kilobits per
second.
ratio Compression ratio for bytes sent and received since the link last came
up or since the counters were last cleared.
restarts Number of times the compression process restarted or reset.
last clearing of counters Duration since the last time the counters were cleared with the clear
counters command.

Related Commands Command Description

compress Configures compression for LAPB, PPP, and HDLC encapsulations.

Cisco IOS Interface and Hardware Component Command Reference

IR-451
 Interface and Hardware Component Commands
show controller dsl

show controller dsl

To display the DSL controller status and the statistics of a DSL port, use the show controller dsl
command in privileged EXEC mode.

show controller dsl slot/port

Syntax Description slot Slot number of the DSL controller.

/port Port number of the DSL controller. The slash (/) character is required and
must be entered when specifying the slot and port arguments.

Command Modes Privileged EXEC

Command History Release Modification

12.3(4)XD This command was introduced on Cisco 2600 series and Cisco 3700 series
routers.
12.3(4)XG This command was integrated into Cisco IOS Release 12.3(4)XG on the
Cisco 1700 series routers.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T on
Cisco 2600 series, Cisco 3631, and Cisco 3700 series routers.
12.3(11)T This command was implemented on Cisco 2800 and Cisco 3800 series
routers.

Usage Guidelines This command is used to display the controller mode of the controller in the specified slot and port and
to display the statistics. Use this command in troubleshooting. Use the Cisco IOS help to find the valid
slot and port numbers.

Examples Display for DSL Controller Configured in ATM 4-Wire Mode

The following example displays the status and statistics of the DSL controller in slot 1 and port 0
configured in ATM 4-wire mode:
Router# show controller dsl 1/0

DSL 1/0 controller UP

Globespan xDSL controller chipset
DSL mode:SHDSL Annex B
Frame mode:Utopia
Configured Line rate:4608Kbps
Line Re-activated 0 times after system bootup
LOSW Defect alarm:ACTIVE
CRC per second alarm:ACTIVE
Line termination:CO
FPGA Revision:0xAD

Line 0 statistics

Cisco IOS Interface and Hardware Component Command Reference

IR-452
Interface and Hardware Component Commands
show controller dsl

Current 15 min CRC:0

Current 15 min LOSW Defect:0
Current 15 min ES:0
Current 15 min SES:0
Current 15 min UAS:41

Previous 15 min CRC:0

Previous 15 min LOSW Defect:0
Previous 15 min ES:0
Previous 15 min SES:0
Previous 15 min UAS:0

Line 1 statistics

Current 15 min CRC:0

Current 15 min LOSW Defect:0
Current 15 min ES:0
Current 15 min SES:0
Current 15 min UAS:30

Previous 15 min CRC:0

Previous 15 min LOSW Defect:0
Previous 15 min ES:0
Previous 15 min SES:0
Previous 15 min UAS:0

Line-0 status
Chipset Version: 1
Firmware Version: A29733
Modem Status: Data, Status 1
Last Fail Mode: No Failure status:0x0
Line rate: 2312 Kbps
Framer Sync Status:In Sync
Rcv Clock Status:In the Range
Loop Attenuation: 0.600 dB
Transmit Power: 8.5 dB
Receiver Gain: 21.420 dB
SNR Sampling: 39.3690 dB
Line-1 status
Chipset Version: 1
Firmware Version: A29733
Modem Status: Data, Status 1
Last Fail Mode: No Failure status:0x0
Line rate: 2312 Kbps
Framer Sync Status:In Sync
Rcv Clock Status:In the Range
Loop Attenuation: 0.600 dB
Transmit Power: 8.5 dB
Receiver Gain: 21.420 dB
SNR Sampling: 39.1570 dB
Dying Gasp:Present

Display for DSL Controller Configured in T1 Mode

This example shows the display of a DSL controller that has been configured in T1 mode.
Router# show controller dsl 0/0

DSL 0/0 controller UP

SLOT 0:Globespan xDSL controller chipset
Line Mode:Two Wire
DSL mode:SHDSL Annex A

Cisco IOS Interface and Hardware Component Command Reference

IR-453
 Interface and Hardware Component Commands
show controller dsl

Frame mode:T1
Line Re-activated 0 times after system bootup
LOSW Defect alarm:ACTIVE
CRC per second alarm:ACTIVE
Line termination:CPE
FPGA Revision:0xA9

Current 15 min CRC:5

Current 15 min LOSW Defect:0
Current 15 min ES:1
Current 15 min SES:0
Current 15 min UAS:570

Previous 15 min CRC:0

Previous 15 min LOSW Defect:0
Previous 15 min ES:0
Previous 15 min SES:0
Previous 15 min UAS:0

Line-0 status
Chipset Version: 1
Firmware Version: A29733
Modem Status: Data, Status 1
Last Fail Mode: No Failure status:0x0
Line rate: 1552 Kbps
Framer Sync Status:In Sync
Rcv Clock Status:In the Range
Loop Attenuation: 0.7800 dB
Transmit Power: 7.5 dB
Receiver Gain: 22.5420 dB
SNR Sampling: 35.6120 dB
Dying Gasp:Present

Annex Display When Line Is Trained

The following example shows the DSL controller annex display when the line is trained:
Router# show controller dsl 1/0

DSL 1/0 controller UP

SLOT 0: Globespan xDSL controller chipset
DSL mode: SHDSL Trained with Annex B-ANFP

Annex Display When Line Is Not Trained

The following example shows the DSL controller annex display when the line is not trained:
Router# show controller dsl 1/0

DSL 1/0 controller DOWN

SLOT 0: Globespan xDSL controller chipset
DSL mode: Not trained

The following table describes the significant fields of the show controller dsl command.

Cisco IOS Interface and Hardware Component Command Reference

IR-454
 Interface and Hardware Component Commands
show controller dsl

Table 23 show controller dsl Field Descriptions

Field Description
DSL ... controller ... Describes the status of the controller in the
indicated slot number.
DSL mode Displays the DSL mode of the controller.
Frame mode Displays the frame mode of the controller.
Configured Line rate Displays the line rate.
LOSW Defect alarm Displays the status of the LOSW alarm.
CRC per second alarm Displays the status of the CRC per second alarm.
Line termination Displays how the line is terminated.
Chipset Version Displays the version of the chipset.
Firmware Version Displays the version of the firmware.
Modem Status Displays the status of the modem.
Last Fail Mode Displays the last fail mode.
Line rate Displays the line rate.
Framer Sync Status Displays the framer synchronization status.
Rcv Clock Status Displays the revision clock status.
Loop Attenuation Displays the loop attenuation.
Transmit Power Displays the transmit power.
Receiver Gain Displays the receiver gain.
SNR Sampling Displays the signal-to-noise ratio sampling.

Related Commands Command Description

controller dsl Configures the controller status and the controller number.

Cisco IOS Interface and Hardware Component Command Reference

IR-455
 Interface and Hardware Component Commands
show controller dsl

show controller dsl

To display the DSL controller status and the statistics of a DSL port, use the show controller dsl
command in privileged EXEC mode.

show controller dsl slot/port

Syntax Description slot Slot number of the DSL controller.

/port Port number of the DSL controller. The slash (/) character is required and
must be entered when specifying the slot and port arguments.

Command Modes Privileged EXEC

Command History Release Modification

12.3(4)XD This command was introduced on Cisco 2600 series and Cisco 3700 series
routers.
12.3(4)XG This command was integrated into Cisco IOS Release 12.3(4)XG on the
Cisco 1700 series routers.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T on
Cisco 2600 series, Cisco 3631, and Cisco 3700 series routers.
12.3(11)T This command was implemented on Cisco 2800 and Cisco 3800 series
routers.

Usage Guidelines This command is used to display the controller mode of the controller in the specified slot and port and
to display the statistics. Use this command in troubleshooting. Use the Cisco IOS help to find the valid
slot and port numbers.

Examples Display for DSL Controller Configured in ATM 4-Wire Mode

The following example displays the status and statistics of the DSL controller in slot 1 and port 0
configured in ATM 4-wire mode:
Router# show controller dsl 1/0

DSL 1/0 controller UP

Globespan xDSL controller chipset
DSL mode:SHDSL Annex B
Frame mode:Utopia
Configured Line rate:4608Kbps
Line Re-activated 0 times after system bootup
LOSW Defect alarm:ACTIVE
CRC per second alarm:ACTIVE
Line termination:CO
FPGA Revision:0xAD

Line 0 statistics

Cisco IOS Interface and Hardware Component Command Reference

IR-456
Interface and Hardware Component Commands
show controller dsl

Current 15 min CRC:0

Current 15 min LOSW Defect:0
Current 15 min ES:0
Current 15 min SES:0
Current 15 min UAS:41

Previous 15 min CRC:0

Previous 15 min LOSW Defect:0
Previous 15 min ES:0
Previous 15 min SES:0
Previous 15 min UAS:0

Line 1 statistics

Current 15 min CRC:0

Current 15 min LOSW Defect:0
Current 15 min ES:0
Current 15 min SES:0
Current 15 min UAS:30

Previous 15 min CRC:0

Previous 15 min LOSW Defect:0
Previous 15 min ES:0
Previous 15 min SES:0
Previous 15 min UAS:0

Line-0 status
Chipset Version: 1
Firmware Version: A29733
Modem Status: Data, Status 1
Last Fail Mode: No Failure status:0x0
Line rate: 2312 Kbps
Framer Sync Status:In Sync
Rcv Clock Status:In the Range
Loop Attenuation: 0.600 dB
Transmit Power: 8.5 dB
Receiver Gain: 21.420 dB
SNR Sampling: 39.3690 dB
Line-1 status
Chipset Version: 1
Firmware Version: A29733
Modem Status: Data, Status 1
Last Fail Mode: No Failure status:0x0
Line rate: 2312 Kbps
Framer Sync Status:In Sync
Rcv Clock Status:In the Range
Loop Attenuation: 0.600 dB
Transmit Power: 8.5 dB
Receiver Gain: 21.420 dB
SNR Sampling: 39.1570 dB
Dying Gasp:Present

Display for DSL Controller Configured in T1 Mode

This example shows the display of a DSL controller that has been configured in T1 mode.
Router# show controller dsl 0/0

DSL 0/0 controller UP

SLOT 0:Globespan xDSL controller chipset
Line Mode:Two Wire
DSL mode:SHDSL Annex A

Cisco IOS Interface and Hardware Component Command Reference

IR-457
 Interface and Hardware Component Commands
show controller dsl

Frame mode:T1
Line Re-activated 0 times after system bootup
LOSW Defect alarm:ACTIVE
CRC per second alarm:ACTIVE
Line termination:CPE
FPGA Revision:0xA9

Current 15 min CRC:5

Current 15 min LOSW Defect:0
Current 15 min ES:1
Current 15 min SES:0
Current 15 min UAS:570

Previous 15 min CRC:0

Previous 15 min LOSW Defect:0
Previous 15 min ES:0
Previous 15 min SES:0
Previous 15 min UAS:0

Line-0 status
Chipset Version: 1
Firmware Version: A29733
Modem Status: Data, Status 1
Last Fail Mode: No Failure status:0x0
Line rate: 1552 Kbps
Framer Sync Status:In Sync
Rcv Clock Status:In the Range
Loop Attenuation: 0.7800 dB
Transmit Power: 7.5 dB
Receiver Gain: 22.5420 dB
SNR Sampling: 35.6120 dB
Dying Gasp:Present

Annex Display When Line Is Trained

The following example shows the DSL controller annex display when the line is trained:
Router# show controller dsl 1/0

DSL 1/0 controller UP

SLOT 0: Globespan xDSL controller chipset
DSL mode: SHDSL Trained with Annex B-ANFP

Annex Display When Line Is Not Trained

The following example shows the DSL controller annex display when the line is not trained:
Router# show controller dsl 1/0

DSL 1/0 controller DOWN

SLOT 0: Globespan xDSL controller chipset
DSL mode: Not trained

The following table describes the significant fields of the show controller dsl command.

Cisco IOS Interface and Hardware Component Command Reference

IR-458
 Interface and Hardware Component Commands
show controller dsl

Table 24 show controller dsl Field Descriptions

Field Description
DSL ... controller ... Describes the status of the controller in the
indicated slot number.
DSL mode Displays the DSL mode of the controller.
Frame mode Displays the frame mode of the controller.
Configured Line rate Displays the line rate.
LOSW Defect alarm Displays the status of the LOSW alarm.
CRC per second alarm Displays the status of the CRC per second alarm.
Line termination Displays how the line is terminated.
Chipset Version Displays the version of the chipset.
Firmware Version Displays the version of the firmware.
Modem Status Displays the status of the modem.
Last Fail Mode Displays the last fail mode.
Line rate Displays the line rate.
Framer Sync Status Displays the framer synchronization status.
Rcv Clock Status Displays the revision clock status.
Loop Attenuation Displays the loop attenuation.
Transmit Power Displays the transmit power.
Receiver Gain Displays the receiver gain.
SNR Sampling Displays the signal-to-noise ratio sampling.

Related Commands Command Description

controller dsl Configures the controller status and the controller number.

Cisco IOS Interface and Hardware Component Command Reference

IR-459
 Interface and Hardware Component Commands
show controllers cbus

show controllers cbus

To display all information under the cBus controller card including the capabilities of the card and
reports controller-related failures, use the show controllers cbus command in privileged EXEC mode
on the Cisco 7500 series routers.

show controllers cbus

Syntax Description This command has no arguments or keywords.

Command Modes Privileged EXEC

Command History Release Modification

10.0 This command was introduced.

Examples The following is a partial output from the show controllers cbus command on a Cisco 7500 series router
with one Versatile Interface Processor version 2 (VIP2) card. This example does not show output from
additional interface processors that are usually installed in a Cisco 7500 series router.
Router# show controllers cbus

MEMD at 40000000, 2097152 bytes (unused 2752, recarves 1, lost 0)

RawQ 48000100, ReturnQ 48000108, EventQ 48000110
BufhdrQ 48000138 (2849 items), LovltrQ 48000150 (42 items, 1632 bytes)
IpcbufQ 48000158 (32 items, 4096 bytes)
3570 buffer headers (48002000 - 4800FF10)
pool0: 15 buffers, 256 bytes, queue 48000140
pool1: 368 buffers, 1536 bytes, queue 48000148
pool2: 260 buffers, 4544 bytes, queue 48000160
pool3: 4 buffers, 4576 bytes, queue 48000168

slot1: VIP2, hw 2.2, sw 200.50, ccb 5800FF30, cmdq 48000088, vps 8192
software loaded from system
FLASH ROM version 255.255
Fast Ethernet1/0/0, addr 0000.0c41.6c20 (bia 0000.0c41.6c20)
gfreeq 48000148, lfreeq 480001D0 (1536 bytes), throttled 0
rxlo 4, rxhi 30, rxcurr 0, maxrxcurr 0
txq 48001A00, txacc 48001A02 (value 0), txlimit 20
Ethernet1/1/0, addr 0000.0c41.6c28 (bia 0000.0c41.6c28)
gfreeq 48000148, lfreeq 480001D8 (1536 bytes), throttled 0
rxlo 4, rxhi 30, rxcurr 0, maxrxcurr 0
txq 48001A08, txacc 48001A0A (value 0), txlimit 20
Ethernet1/1/1, addr 0000.0c41.6c29 (bia 0000.0c41.6c29)
gfreeq 48000148, lfreeq 480001E0 (1536 bytes), throttled 0
rxlo 4, rxhi 30, rxcurr 0, maxrxcurr 0
txq 48001A10, txacc 48001A12 (value 0), txlimit 20
Ethernet1/1/2, addr 0000.0c41.6c2a (bia 0000.0c41.6c2a)
gfreeq 48000148, lfreeq 480001E8 (1536 bytes), throttled 0
rxlo 4, rxhi 30, rxcurr 0, maxrxcurr 0
txq 48001A18, txacc 48001A1A (value 0), txlimit 20
Ethernet1/1/3, addr 0000.0c41.6c2b (bia 0000.0c41.6c2b)
gfreeq 48000148, lfreeq 480001F0 (1536 bytes), throttled 0

Cisco IOS Interface and Hardware Component Command Reference

IR-460
Interface and Hardware Component Commands
show controllers cbus

rxlo 4, rxhi 30, rxcurr 0, maxrxcurr 0

txq 48001A20, txacc 48001A22 (value 0), txlimit 20
Ethernet1/1/4, addr 0000.0c41.6c2c (bia 0000.0c41.6c2c)
gfreeq 48000148, lfreeq 480001F8 (1536 bytes), throttled 0
rxlo 4, rxhi 30, rxcurr 0, maxrxcurr 0
txq 48001A28, txacc 48001A2A (value 0), txlimit 20
Ethernet1/1/5, addr 0000.0c41.6c2d (bia 0000.0c41.6c2d)
gfreeq 48000148, lfreeq 48000200 (1536 bytes), throttled 0
rxlo 4, rxhi 30, rxcurr 0, maxrxcurr 0
txq 48001A30, txacc 48001A32 (value 0), txlimit 20
Ethernet1/1/6, addr 0000.0c41.6c2e (bia 0000.0c41.6c2e)
gfreeq 48000148, lfreeq 48000208 (1536 bytes), throttled 0
rxlo 4, rxhi 30, rxcurr 0, maxrxcurr 0
txq 48001A38, txacc 48001A3A (value 0), txlimit 20
Ethernet1/1/7, addr 0000.0c41.6c2f (bia 0000.0c41.6c2f)
gfreeq 48000148, lfreeq 48000210 (1536 bytes), throttled 0
rxlo 4, rxhi 30, rxcurr 0, maxrxcurr 0
txq 48001A40, txacc 48001A42 (value 0), txlimit 20

The following is a partial output from the show controllers cbus command for a Packet-Over-SONET
Interface Processor (POSIP) in slot 0; its single Packet OC-3 interface is Posi0/0.
Router# show controllers cbus

slot0: POSIP, hw 2.1, sw 200.01, ccb 5800FF30, cmdq 48000080, vps 8192
software loaded from flash slot0:rsp_posip.new
FLASH ROM version 160.4, VPLD version 2.2
Posi0/0, applique is SONET
gfreeq 48000148, lfreeq 48000158 (4480 bytes), throttled 0
rxlo 4, rxhi 226, rxcurr 0, maxrxcurr 186
txq 48000160, txacc 48000082 (value 150), txlimit 150

The following is partial output from the show controllers cbus command for a Multichannel Interface
Processor (MIP). Not all of the 23 channels defined on serial interface 1/0 are shown.
Router# show controllers cbus

slot1: MIP, hw 1.1, sw 205.03, ccb 5800FF40, cmdq 48000088, vps 8192
software loaded from system
T1 1/0, applique is Channelized T1
gfreeq 48000130, lfreeq 480001B0 (1536 bytes), throttled 0
rxlo 4, rxhi 360, rxcurr 0, maxrxcurr 3
Serial1/0:0, txq 480001B8, txacc 48000082 (value 3), txlimit 3
Serial1/0:1, txq 480001B8, txacc 4800008A (value 3), txlimit 3
Serial1/0:2, txq 480001B8, txacc 48000092 (value 3), txlimit 3
Serial1/0:3, txq 480001B8, txacc 4800009A (value 3), txlimit 3
Serial1/0:4, txq 480001B8, txacc 480000A2 (value 3), txlimit 3
Serial1/0:5, txq 480001B8, txacc 480000AA (value 3), txlimit 3
Serial1/0:6, txq 480001B8, txacc 480000B2 (value 3), txlimit 3
Serial1/0:7, txq 480001B8, txacc 480000BA (value 3), txlimit 3

Table 25 describes significant fields in the per-slot part of these displays.

Table 25 show controllers cbus Command—Per-Slot Field Descriptions

Field Description
slot1 Slot location of the specific interface processor (in this case
Packet-over-SONET Interface Processor).
hw Version number of the card.
sw Version number of the card’s internal software (in ROM).

Cisco IOS Interface and Hardware Component Command Reference

IR-461
 Interface and Hardware Component Commands
show controllers cbus

Table 25 show controllers cbus Command—Per-Slot Field Descriptions (continued)

Field Description
software loaded from Source device and file name from which the router software was loaded.
FLASH ROM version Version of Flash ROM.
VPLD version
Pos1/0, applique is Location of the specific interface and the hardware applique type (in this
SONET case a Packet OC-3 interface).
gfreeq Location of the global free queue that is shared among similar interfaces.
lfreeq Location of the local free queue, which is a private queue of MEMD buffers.
throttled Number of times input packet processing has been throttled on this interface.
rxlo Minimum number of MEMD buffers held on local free queue. When idle, the
interface returns buffers from its local queue to the global free queue until
only this number of buffers remain in the local queue.
rxhi Maximum number of MEMD buffers that the interface can remove from the
global free queue in order to populate its local queue.
rxcurr Number of MEMD buffers currently on the local free queue.
maxrxcurr Maximum number of MEMD buffers that were enqueued on the local free
queue.
txq Address of the transmit queue.
txacc Address of the transmit queue accumulator.
txlimit Maximum number of buffers allowed in the transmit queue.

The following is sample output from the show controllers cbus command on a Cisco 7500 series router:
Router# show controllers cbus

cBus 1, controller type 3.0, microcode version 2.0

128 Kbytes of main memory, 32 Kbytes cache memory
40 1520 byte buffers, 14 4484 byte buffers
Restarts: 0 line down, 0 hung output, 0 controller error
HSCI 1, controller type 10.0, microcode version 129.3
Interface 6 - Hssi0, electrical interface is Hssi DTE
5 buffer RX queue threshold, 7 buffer TX queue limit, buffer size 1520
ift 0004, rql 2, tq 0000 0000, tql 7
Transmitter delay is 0 microseconds
MEC 3, controller type 5.1, microcode version 130.6
Interface 18 - Ethernet2, station address 0000.0c02.a03c (bia 0000.0c02.a03c)
10 buffer RX queue threshold, 7 buffer TX queue limit, buffer size 1520
ift 0000, rql 10, tq 0000 0000, tql 7
Transmitter delay is 0 microseconds
Interface 19 - Ethernet3, station address 0000.0c02.a03d (bia 0000.0c02.a03d)
10 buffer RX queue threshold, 7 buffer TX queue limit, buffer size 1520
ift 0000, rql 10, tq 0000 0000, tql 7
Transmitter delay is 0 microseconds

Table 26 describes the fields shown in the following lines of output.

cBus 1, controller type 3.0, microcode version 2.0
128 Kbytes of main memory, 32 Kbytes cache memory
40 1520 byte buffers, 14 4484 byte buffers
Restarts: 0 line down, 0 hung output, 0 controller error

Cisco IOS Interface and Hardware Component Command Reference

IR-462
Interface and Hardware Component Commands
show controllers cbus

Table 26 show controllers cbus Field Descriptions—Part 1

Field Description
cBus 1 Card type and number (varies depending on card).
controller type 3.0 Version number of the card.
microcode version 2.0 Version number of the card’s internal software (in ROM).
128 Kbytes of main memory Amount of main memory on the card.
32 Kbytes cache memory Amount of cache memory on the card.
40 1520 byte buffers Number of buffers of this size on the card.
14 4484 byte buffers Number of buffers of this size on the card.
Restarts Count of restarts for the following conditions:
• 0 line down • Communication line down
• 0 hung output • Output unable to transmit
• 0 controller error • Internal error

Table 27 describes the fields shown in the following lines of output:

HSCI 1, controller type 10.0, microcode version 129.3
Interface 6 - Hssi0, electrical interface is Hssi DTE
5 buffer RX queue threshold, 7 buffer TX queue limit, buffer size 1520
ift 0004, rql 2, tq 0000 0000, tql 7
Transmitter delay is 0 microseconds

Table 27 show controllers cbus Field Descriptions—Part 2

Field Description
HSCI 1 Card type and number (varies depending on card).
controller type 10.0 Version number of the card.
microcode version 129.3 Version number of the card’s internal software (in ROM).
Interface 6 Physical interface number.
Hssi 0 Logical name for this interface.
electrical interface is Hssi DTE Self-explanatory.
5 buffer RX queue threshold Maximum number of buffers allowed in the receive queue.
7 buffer TX queue limit Maximum number of buffers allowed in the transmit queue.
buffer size 1520 Size of the buffers on this card (in bytes).
ift 0004 Interface type code:
• 0 = EIP
• 1 = FSIP
• 4 = HIP
• 5 = TRIP
• 6 = FIP
• 7 = AIP

Cisco IOS Interface and Hardware Component Command Reference

IR-463
 Interface and Hardware Component Commands
show controllers cbus

Table 27 show controllers cbus Field Descriptions—Part 2 (continued)

Field Description
rql 2 Receive queue limit. Current number of buffers allowed for
the receive queue. It is used to limit the number of buffers
used by a particular inbound interface. When equal to 0, all
of that interface’s receive buffers are in use.
tq 0000 0000 Transmit queue head and tail pointers.
tql 7 Transmit queue limit. Current number of buffers allowed for
transmit queue. It limits the maximum cBus buffers allowed
to sit on a particular interface’s transmit queue.
Transmitter delay is 0 microseconds Transmitter delay between the packets.

The following is a sample output from the show controllers cbus command for an ATM Interface
Processor (AIP) installed in IP slot 4. The running AIP microcode is Version 170.30, the physical layer
interface module (PLIM) type is 4B/5B, and the available bandwidth is 100 Mbps:
Router# show controllers cbus

Switch Processor 5, hardware version 11.1, microcode version 170.46

Microcode loaded from system
512 Kbytes of main memory, 128 Kbytes cache memory
60 1520 byte buffers, 91 4496 byte buffers
Restarts: 0 line down, 0 hung output, 0 controller error
AIP 4, hardware version 1.0, microcode version 170.30
Microcode loaded from system
Interface 32 - ATM4/0, PLIM is 4B5B(100Mbps)
15 buffer RX queue threshold, 36 buffer TX queue limit, buffer size 4496
ift 0007, rql 12, tq 0000 0620, tql 36
Transmitter delay is 0 microseconds

The following is sample output from the show controllers cbus command for the Service Provider
MultiChannel Interface Processor (SMIP):
Router# show controllers cbus

SMIP 2, hardware version 1.0, microcode version 10.0

Microcode loaded from system
Interface 16 - T1 2/0, electrical interface is Channelized T1
10 buffer RX queue threshold, 14 buffer TX queue limit, buffer size 1580 ift 0001, rql
7, tq 0000 05B0, tql 14
Transmitter delay is 0 microseconds

Cisco IOS Interface and Hardware Component Command Reference

IR-464
 Interface and Hardware Component Commands
show controllers content-engine

show controllers content-engine

To display controller information for content engine (CE) network modules, use the show controllers
content-engine command in privileged EXEC mode.

show controllers content-engine slot/unit

Syntax Description slot Number of the router chassis slot for the network module.
/unit Number of the daughter card on the network module. For CE network
modules, always use 0.

Command Modes Privileged EXEC

Command History Release Modification

12.2(11)YT This command was introduced.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.

Examples The following example displays controller information for the CE network module in router slot 1:
Router# show controllers content-engine 1/0

Interface Content-Engine1/0
Hardware is Intel 82559 FastEthernet
IDB: 82A92DC4, FASTSEND: 8021B488, MCI_INDEX: 0

INSTANCE=0x82A94534
Rx Ring entries = 64
Rx Shadow = 0x82A947A0
Rx Ring = 0x 3CB5160
Rx Ring Head = 14
Rx Ring Last = 13
Rx Buffer Descr = 0x 3CB55A0
Rx Buffer Descr Head = 14
Rx Buffer Descr Last = 13
Rx Shadow (malloc) = 0x82A947A0
Rx Ring (malloc) = 0x 3CB5160
Rx Buffer Descr (malloc) = 0x 3CB55A0
Tx Ring entries = 128
Tx Shadow = 0x82A948D0
Tx Shadow Head = 79
Tx Shadow Tail = 79
Tx Shadow Free = 128
Tx Ring = 0x 3CB59E0
Tx Head = 81
Tx Last = 80
Tx Tail = 81
Tx Count = 0
Tx Buffer Descr = 0x 3CB6A20
Tx Buffer Descr Head = 0
Tx Buffer Descr Tail = 0
Tx Shadow (malloc) = 0x82A948D0

Cisco IOS Interface and Hardware Component Command Reference

IR-465
 Interface and Hardware Component Commands
show controllers content-engine

Tx Ring (malloc) = 0x 3CB59E0

Tx Buffer Descr (malloc) = 0x 3CB6A20

CONTROL AND STATUS REGISTERS (CSR)=0x40800000

SCB Intr Mask = 00
SCB CU/RU Cmd = 00
SCB Intr Status = 00
SCB CU/RU Status = 50
SCB General Ptr = 00000000
PORT = 00000000
EEPROM = 0008
FLASH = 0002
MDI = 1821782D
Rx Byte Count = 00000608
PMDR = 80
FC Cmd = 00
FC Threshold = 03
Early Rx = 00
General Status = 05
General Control = 00

PHY REGISTERS
Register 0x00: 1000 782D 02A8 0154 0441 45E1 0001 0000
Register 0x08: 0000 0000 0000 0000 0000 0000 0000 0000
Register 0x10: 0401 0000 0001 0000 0000 0000 0000 0000
Register 0x18: 0000 0000 8000 0000 0000 0000 0000 0000

HARDWARE STATISTICS
Rx good frames: 14
Rx CRC: 0
Rx alignment: 0
Rx resource: 0
Rx overrun: 0
Rx collision detects: 0
Rx short: 0
Tx good frames: 79
Tx maximum collisions: 0
Tx late collisions: 0
Tx underruns: 0
Tx lost carrier sense: 0
Tx deferred: 0
Tx single collisions: 0
Tx multiple collisions: 0
Tx total collisions: 0
FC Tx pause: 0
FC Rx pause: 0
FC Rx unsupported: 0

Receive All Multicasts = enabled

Receive Promiscuous = disabled
Loopback Mode = disabled

Table 28 describes the significant fields shown in the display.

Table 28 show controllers content-engine Field Descriptions

Field Description
Hardware Description of the chip being used.
IDB, FASTSEND Address in router memory of the Interface Descriptor Block
(IDB) and the fastsend routine.

Cisco IOS Interface and Hardware Component Command Reference

IR-466
 Interface and Hardware Component Commands
show controllers content-engine

Table 28 show controllers content-engine Field Descriptions (continued)

Field Description
INSTANCE Device-specific data stored in router memory that lists the
memory locations and current indices of receive (Rx) and
transmit (Tx) rings in router I/O memory.
CONTROL AND STATUS Control and status registers that are physically located on the chip
REGISTERS (CSR) itself and that are accessed by the CPU over the protocol control
information (PCI) bus.
PHY REGISTERS Contents of the physical layer (PHY) registers. A PHY module is
a device that interfaces the physical Ethernet line and that is
located between the chip and the physical line.
HARDWARE STATISTICS Receive (Rx) and transmit (Tx) traffic statistics collected by the
chip.

Related Commands Command Description

interface content-engine Configures an interface for a CE network module and enters
interface configuration mode.
show interfaces content-engine Displays basic interface configuration information for a CE
network module.

Cisco IOS Interface and Hardware Component Command Reference

IR-467
 Interface and Hardware Component Commands
show controllers e1

show controllers e1
To display information about E1 links, use the show controllers e1 command in privileged EXEC mode.

Cisco 4000 Series Routers

show controllers e1 controller-number

Cisco 7500 Series Routers

show controllers e1 [slot/port]

Cisco AS5000 Series Access Servers

show controllers e1 {controller-number | clock | firmware-status | monitor | timeslots

timeslot-range}

Syntax Description controller-number Controller number.

slot/port (Optional) Backplane slot number and port number on the interface. Refer
to the hardware manuals for your controller type to determine specific slot
and port numbers.
clock Displays primary clock change history.
firmware-status Displays system crash history.
monitor Displays primary monitor change history.
timeslots timeslot-range Displays DS0 information. Time slot range is 1 through 31 for the E1
controller.

Command Modes Privileged EXEC

Command History Release Modification

10.0 This command was introduced.
11.2 This command was implemented on additional router platforms.
12.1(3)T This command was implemented on additional access server platforms.

Usage Guidelines This command displays controller status that is specific to the controller hardware. The information
displayed is generally useful for diagnostic tasks performed by technical support personnel only.
The Network Processor Module (NPM) on the Cisco 4000 series router or MultiChannel Interface
Processor (MIP) on a Cisco 7500 series router can query the port adapters to determine their current
status. Issue a show controllers e1 command to display statistics about the E1 link.
On a Cisco 7500 series router, if you specify a slot and port number each 15-minute period will be
displayed.

Cisco IOS Interface and Hardware Component Command Reference

IR-468
 Interface and Hardware Component Commands
show controllers e1

On the Cisco 5000 series access servers use the show controllers e1 timeslots command to display the
CAS and ISDN PRI channel state in detail. This command shows whether the DS0 channels of a
controller are in idle, in-service, maintenance, or busyout states. Enter the commands to display statistics
about the E1 links.

Examples The following is sample output from the show controllers e1 command on the Cisco 7500 series router:
Router# show controllers e1

e1 0/0 is up.
Applique type is Channelized E1 - unbalanced
Framing is CRC4, Line Code is HDB3
No alarms detected.
Data in current interval (725 seconds elapsed):
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs
Total Data (last 24 hours)
0 Line Code Violations, 0 Path Code Violations,
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins,
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs

The following is sample output from the show controllers e1 command including the board identifier
type:
Router# show controllers e1

E1 4/1 is up.
No alarms detected.
Framing is CRC4, Line Code is hdb3
Data in current interval (0 seconds elapsed):
0 Line Code Violations, 0 Path Code Violations 0 Slip Secs, 0 Fr Loss Secs,
0 Line Err Secs, 0 Degraded Mins 0 Errored Secs, 0 Bursty Err Secs,
0 Severely Err Secs, 0 Unavail Secs
Total Data (last 79 15 minute intervals):
0 Line Code Violations, 0 Path Code Violations, 0 Slip Secs, 0 Fr Loss Secs,
0 Line Err Secs, 0 Degraded Mins, 0 Errored Secs, 0 Bursty Err Secs,
0 Severely Err Secs, 0 Unavail Secs

Table 29 describes the significant fields shown in the display.

Table 29 show controllers e1 Field Descriptions

Field Description
e1 0/0 is up The E1 controller 0 in slot 0 is operating. The controller’s state can be up,
down, or administratively down. Loopback conditions are shown by
(Locally Looped) or (Remotely Looped).
Applique type The applique type is shown and will indicate balanced or unbalanced.
Framing is Displays the current framing type.
Linecode is Displays the current linecode type.

Cisco IOS Interface and Hardware Component Command Reference

IR-469
 Interface and Hardware Component Commands
show controllers e1

Table 29 show controllers e1 Field Descriptions (continued)

Field Description
No alarms detected Any alarms detected by the controller are displayed here. Possible alarms
are as follows:
• Transmitter is sending remote alarm.
• Transmitter is sending AIS.
• Receiver has loss of signal.
• Receiver is getting AIS.
• Receiver has loss of frame.
• Receiver has remote alarm.
• Receiver has no alarms.
Data in current interval Displays the current accumulation period, which rolls into the 24-hour
(725 seconds elapsed) accumulation every 15 minutes. Accumulation period is from 1 to
900 seconds. The oldest 15-minute period falls off the back of the
24-hour accumulation buffer.
Line Code Violations Indicates the occurrence of either a Bipolar Violation (BPV) or Excessive
Zeros (EXZ) error event.
Path Code Violations Indicates a frame synchronization bit error in the D4 and E1-no-CRC
formats, or a cyclic redundancy check (CRC) error in the Extended
Superframe (ESF) and E1-CRC formats.
Slip Secs Indicates the replication or deletion of the payload bits of a DS1 frame.
A slip might be performed when there is a difference between the timing
of a synchronous receiving terminal and the received signal.
Fr Loss Secs Indicates the number of seconds an Out Of Frame (OOF) error is
detected.
Line Err Secs Line Errored Seconds (LES) is a second in which one or more Line Code
Violation errors are detected.
Degraded Mins A Degraded Minute is one in which the estimated error rate exceeds 1E-6
but does not exceed 1E-3.
Errored Secs In ESF and E1 CRC links, an Errored Second is a second in which one of
the following are detected: one or more Path Code Violations; one or
more Out of Frame defects; one or more Controlled Slip events; a
detected AIS defect.
For SF and E1 no-CRC links, the presence of Bipolar Violations also
triggers an Errored Second.
Bursty Err Secs A second with fewer than 320 and more than 1 Path Coding Violation
error, no Severely Errored Frame defects and no detected incoming AIS
defects. Controlled slips are not included in this parameter.

Cisco IOS Interface and Hardware Component Command Reference

IR-470
Interface and Hardware Component Commands
show controllers e1

Table 29 show controllers e1 Field Descriptions (continued)

Field Description
Severely Err Secs For ESF signals, a second with one of the following errors: 320 or more
Path Code Violation errors; one or more Out of Frame defects; a detected
AIS defect.
For E1-CRC signals, a second with one of the following errors: 832 or
more Path Code Violation errors; one or more Out of Frame defects.
For E1-nonCRC signals, a second with 2048 Line Code Violations or
more.
For D4 signals, a count of 1-second intervals with Framing Errors, or an
Out of Frame defect, or 1544 Line Code Violations.
Unavail Secs A count of the total number of seconds on the interface.

The following is sample output from the show controllers e1 timeslots command on a Cisco access
server. The information displayed is self-explanatory.
Router# show controllers e1 timeslots 1

SERVICE STATES CAS CHANNEL STATES

insvc = In Service down = Down
outofsvc = Out of Service idle = Idle
maint = Maintenance connected = Call Connected
signaling = Signaling
static-bo = Static Busyout
dynamic-bo = Dynamic Busyout

ISDN CHANNEL STATES

idle = Available
proposed = Negotiating
busy = Unavailable
reserved = Reserved
restart = Restart Pending
maint_pend = Maintenance Pending
reassigned = Reassigned
prop'd_1tr6= Net may change channel #

Cisco IOS Interface and Hardware Component Command Reference

IR-471
 Interface and Hardware Component Commands
show controllers e3

show controllers e3
To display information about an E3 controller, use the show controllers e3 command in user EXEC or
privileged EXEC mode.

show controllers e3 slot/port [brief | tabular]

Syntax Description slot Slot number. Refer to the appropriate hardware manual for slot information.
/port Port number. Refer to the appropriate hardware manual for port
information.
brief (Optional) Displays a list of configurations only.
tabular (Optional) Displays a list of configurations and MIB information in a tabular
format.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

11.1 CC This command was introduced on the E3 controller.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and
implemented on the following platforms: Cisco 2650XM, Cisco 2651XM,
Cisco 2691, Cisco 3660 series, Cisco 3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.

Examples The following are samples of output from the show controllers e3 command:
Router# show controllers e3 2/0

E3 2/0 is down.
Applique type is Subrate E3
Transmitter is sending remote alarm.
Receiver has loss of signal.
Framing is G751, Clock Source is Internal.
Data in current interval (450 seconds elapsed):
0 C-bit Coding Violation
0 P-bit Err Secs, 0 P-bit Severely Err Secs
0 Severely Err Framing Secs, 450 Unavailable Secs
0 Line Errored Secs, 0-C-bit Errored Secs, 0 C-bit Severely Errored Secs
Data in Interval 1:
0 C-bit Coding Violation
0 P-bit Err Secs, 0 P-bit Severely Err Secs
0 Severely Err Framing Secs, 900 Unavailable Secs
0 Line Errored Secs, 0-C-bit Errored Secs, 0 C-bit Severely Errored Secs
Total Data (last 1 15 minute intervals):
0 C-bit Coding Violation
0 P-bit Err Secs, 0 P-bit Severely Err Secs
0 Severely Err Framing Secs, 900 Unavailable Secs
0 Line Errored Secs, 0-C-bit Errored Secs, 0 C-bit Severely Errored Secs

Cisco IOS Interface and Hardware Component Command Reference

IR-472
Interface and Hardware Component Commands
show controllers e3

Router# show controllers e3 2/0 brief

E3 2/0 is down.
Applique type is Subrate E3
Transmitter is sending remote alarm.
Receiver has loss of signal.
Framing is G571, Clock Source is Internal.

Router# show controllers e3 2/0 tabular

E3 2/0 is down.
Applique type is Subrate E3
Transmitter is sending remote alarm.
Receiver has loss of signal.
Framing is G571, Clock Source is Internal.
INTERNAL LCV PCV CCV PES PSES SEFS UAS LES CES CSES
18:10-18:21 0 0 0 0 0 0 680 0 0 0
17:55-18:10 0 0 0 0 0 0 900 0 0 0
Total 0 0 0 0 0 0 900 0 0 0

Table 30 describes the significant fields shown in the display.

Table 30 show controllers e3 Field Descriptions

Field Description
E3 2/0 is down The E3 controller in slot 0 shows the state in which it is operating.
The controller’s state can be up, down, or administratively down.
Loopback conditions are shown by (Locally Looped) or
(Remotely Looped).
Applique type Controller type.
Description User-specified information about the E3 controller.
No alarms detected (not shown in Any alarms detected by the controller are displayed here. Possible
display) alarms are as follows:
• Transmitter is sending remote alarm.
• Transmitter is sending alarm indication signal (AIS).
• Receiver has loss of signal.
• Receiver is getting AIS.
• Receiver has loss of frame.
• Receiver has remote alarm.
• Receiver has no alarms.
Linecode is (not shown in display) Line coding format on the E3.
Framing Framing type.
Clock Source User-specified clock source (Line or Internal).
Data in current interval (450 Shows the current accumulation period, which rolls into the
seconds elapsed) 24-hour accumulation every 15 minutes. Accumulation period is
from 1 to 900 seconds. The oldest 15-minute period falls off the
back of the 24-hour accumulation buffer.
PCV Path coding violation (PCV) error event is a frame
synchronization bit error in the E1-no-CRC formats or a cyclic
redundancy check (CRC) error in the E1-CRC formats.

Cisco IOS Interface and Hardware Component Command Reference

IR-473
 Interface and Hardware Component Commands
show controllers e3

Table 30 show controllers e3 Field Descriptions (continued)

Field Description
CCV C-bit coding violation (CCV) error event for C-bit parity. This is
the count of coding violations reported via the C-bits occurring in
the accumulation interval.
PES P-bit errored seconds (PES) is a second with one or more PCVs,
one or more out-of-frame defects, or a detected incoming AIS.
This gauge is not incremented when unavailable seconds are
counted.
PSES P-bit severely errored seconds (PSES) is a second with 44 or more
PCVs, one or more out-of-frame defects, or a detected incoming
AIS. This gauge is not incremented when unavailable seconds are
counted.
SEFS Severely errored framing seconds (SEFS) is a second with one or
more out-of-frame defects or a detected incoming AIS.
UAS Unavailable seconds (UAS) are calculated by counting the
number of seconds for which the interface is unavailable. For
more information, refer to RFC 1407.
LES Line errored seconds (LES) is a second in which one or more code
violations or one or more LOS defects occurred.
CES C-bit errored seconds (CES) is a second with one or more
out-of-frame defects or a detected incoming AIS. This gauge is
not incremented when UASs are counted.
CSES C-bit severely errored seconds (CSES) is a second with one or
more out-of-frame defects or a detected incoming AIS. This
gauge is not incremented when UASs are counted.
Total Displays the last 15-minute accumulation period.

Cisco IOS Interface and Hardware Component Command Reference

IR-474
 Interface and Hardware Component Commands
show controllers ethernet

show controllers ethernet

To display information on the Cisco 2500 and Cisco 4000 series routers, use the show controllers
ethernet command in user EXEC or privileged EXEC mode.

show controllers ethernet interface-number

Syntax Description interface-number Interface number of the Ethernet interface.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

10.0 This command was introduced.

Examples The following is sample output from the show controllers ethernet command on Cisco 4000 series
routers:
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

Cisco IOS Interface and Hardware Component Command Reference

IR-475
 Interface and Hardware Component Commands
show controllers ethernet

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

Cisco IOS Interface and Hardware Component Command Reference

IR-476
 Interface and Hardware Component Commands
show controllers fastethernet

show controllers fastethernet

To display information about initialization block, transmit ring, receive ring, and errors for the Fast
Ethernet controller chip, use the show controllers fastethernet command in user EXEC or privileged
EXEC mode.

Standard Syntax

show controllers fastethernet number

Cisco 7200 Series

show controllers fastethernet slot/port

Cisco 7500 Series

show controllers fastethernet slot/port-adapter/port

Syntax Description number Port, connector, or interface card number. On a Cisco 4500 or Cisco 4700
router, specifies the network processor module (NPM) number. The numbers
are assigned at the factory at the time of installation or when added to a
system.
slot Slot number. Refer to the appropriate hardware manual for slot information.
/port Port number. Refer to the appropriate hardware manual for port information.
/port-adapter Port adapter number. Refer to the appropriate hardware manual for
information about port adapter compatibility.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

11.2 This command was introduced.

Usage Guidelines The output from this command is generally useful for diagnostic tasks performed by technical support.

Examples The following is a sample output from the show controllers fastethernet command on a Cisco 4500
series router:
Router# show controllers fastethernet 0

DEC21140 Slot 0, Subunit 0

dec21140_ds=0x60001234, registers=0x3c001000, ib=0x42301563, ring entries=256
rxring=0x40235878, rxr shadow=0x64528745, rx_head=0, rx_tail=10
txring=0x43562188, txr shadow=0x65438721, tx_head=17, tx_tail=34, tx_count=17
DEC21140 Registers
CSR0=0x23457667, CSR3=0x12349878, CSR4=0x34528745, CSR5=0x76674565

Cisco IOS Interface and Hardware Component Command Reference

IR-477
 Interface and Hardware Component Commands
show controllers fastethernet

CSR6=0x76453676, CSR7=0x76456574, CSR8=0x25367648, CSR9=0x87253674

CSR11=0x23456454, CSR12=0x76564787, CSR15=0x98273465
DEC21140 PCI registers
bus_no=0, device_no=0
CFID=0x12341234, CFCS=0x76547654, CFRV=0x87658765, CFLT=0x98769876
CBIO=0x12344321, CBMA=0x23454321, CFIT=0x34567654, CFDA=0x76544567
MII registers
Register 0x00: 0x1234 0x1234 0x2345 0x3456 0x4567 0x5678 0x6789 0x7890
Register 0x08: 0x9876 0x8765 0x7654 0x6543 0x5432 0x4321 0x3210 0x2109
Register 0x10: 0x1234 0x2345 0x3456 0x4567 0x5678 0x6789 0x7890
Register 0x18: 0x9876 0x8765 0x7654 0x6543 0x5432 0x4321
DEC21140 statistics
filtered_in_sw=1000, throttled=10, enabled=10
rx_fifo_overflow=10, rx_no_enp=12, rx_late_collision=18
rx_watchdog=15, rx_process_stopped=15, rx_buffer_unavailable=1500
tx_jabber_timeout=10, tx_carrier_loss=2, tx_deffered=15
tx_no_carrier=1, tx_late_collision=10, tx_excess_coll=10
tx_process_stopped=1, fata_tx_err=0

The following is a sample output from the show controllers fastethernet command on a Cisco AS5300
router:
Router# show controller fastethernet 0

DEC21140
Setup Frame
(0 ) 00e0.1e3e.c179
(1 ) 0100.0ccc.cccc
(2 ) 0900.2b00.000f
(3 ) 0900.2b02.0104
(4 ) 0300.0000.0001
dec21140_ds=0x60BD33B8, registers=0x3C210000, ib=0x4002F75C, ring entries=32
rxring=0x4002F844, rxr shadow=0x60F14B58, rx_head=6, rx_tail=6
txring=0x4002FA6C, txr shadow=0x60F14BF8, tx_head=10, tx_tail=10, tx_count=0
tx_size=32, rx_size=32
PHY link up
DEC21140 Registers:
CSR0=0xFE024480, CSR3=0x4002F844, CSR4=0x4002FA6C, CSR5=0xFC660000
CSR6=0x322C2002, CSR7=0xFFFFA241, CSR8=0xE0000000, CSR9=0xFFFDC3FF
CSR11=0xFFFE0000, CSR12=0xFFFFFF09, CSR15=0xFFFFFEC8
DEC21140 PCI registers:
bus_no=2, device_no=0
CFID=0x00091011, CFCS=0x82800005, CFRV=0x02000021, CFLT=0x0000FF00
CBIO=0x3C210001, CBMA=0x00000000, CFIT=0x28140100, CFDA=0x00000000

MII registers:
Register 0x00: 0000 784D 2000 5C01 0001 0000 0000 0000
Register 0x08: 0000 0000 0000 0000 0000 0000 0000 0000
Register 0x10: 0000 0000 0000 0000 0000 0001 8060
Register 0x18: 8020 0840 0000 3000 A3B9

throttled=7, enabled=7
rx_fifo_overflow=0, rx_no_enp=0, late_collision=0
rx_watchdog=0, rx_process_stopped=0, rx_buffer_unavailable=0
tx_jabber_timeout=0, tx_carrier_loss=1, tx_deferred=0
tx_no_carrier=1, tx_late_collision=0, tx_excess_coll=0
tx_process_stopped=0, fatal_tx_err=0
overflow_resets=0
0 missed datagrams, 0 overruns
0 transmitter underruns, 0 excessive collisions
0 single collisions, 0 multiple collisions
0 dma memory errors, 0 CRC errors

0 alignment errors, 0 runts, 0 giants

Cisco IOS Interface and Hardware Component Command Reference

IR-478
 Interface and Hardware Component Commands
show controllers fastethernet

The following is a sample output from the show controllers fastethernet command on a Cisco 7200
series router:
Router# show controllers fastethernet 0/0

Interface Fast Ethernet0/0

Hardware is DEC21140
dec21140_ds=0x60895888, registers=0x3C018000, ib=0x4B019500
rx ring entries=128, tx ring entries=128
rxring=0x4B019640, rxr shadow=0x60895970, rx_head=0, rx_tail=0
txring=0x4B019EC0, txr shadow=0x60895B98, tx_head=77, tx_tail=77, tx_count=0
CSR0=0xFFFA4882, CSR3=0x4B019640, CSR4=0x4B019EC0, CSR5=0xFC660000
CSR6=0xE20CA202, CSR7=0xFFFFA241, CSR8=0xFFFE0000, CSR9=0xFFFDD7FF
CSR11=0xFFFE0000, CSR12=0xFFFFFF98, CSR15=0xFFFFFEC8
DEC21140 PCI registers:
bus_no=0, device_no=6
CFID=0x00091011, CFCS=0x02800006, CFRV=0x02000012, CFLT=0x0000FF00
CBIO=0x7C5AFF81, CBMA=0x48018000, CFIT=0x0000018F, CFDA=0x0000AF00
MII registers:
Register 0x00: 2000 780B 2000 5C00 01E1 0000 0000 0000
Register 0x08: 0000 0000 0000 0000 0000 0000 0000 0000
Register 0x10: 0000 0000 0000 0000 0000 0000 8040
Register 0x18: 8000 0000 0000 3800 A3B9
throttled=0, enabled=0, disabled=0
rx_fifo_overflow=0, rx_no_enp=0, rx_discard=0
tx_underrun_err=0, tx_jabber_timeout=0, tx_carrier_loss=1
tx_no_carrier=1, tx_late_collision=0, tx_excess_coll=0
tx_collision_cnt=0, tx_deferred=0, fatal_tx_err=0, mult_ovfl=0
HW addr filter: 0x60895FC0, ISL Enabled
Entry= 0: Addr=0100.0CCC.CCCC
Entry= 1: Addr=0300.0000.0001
Entry= 2: Addr=0100.0C00.0000
Entry= 3: Addr=FFFF.FFFF.FFFF
Entry= 4: Addr=FFFF.FFFF.FFFF
Entry= 5: Addr=FFFF.FFFF.FFFF
Entry= 6: Addr=FFFF.FFFF.FFFF
Entry= 7: Addr=FFFF.FFFF.FFFF
Entry= 8: Addr=FFFF.FFFF.FFFF
Entry= 9: Addr=FFFF.FFFF.FFFF
Entry=10: Addr=FFFF.FFFF.FFFF
Entry=11: Addr=FFFF.FFFF.FFFF
Entry=12: Addr=FFFF.FFFF.FFFF
Entry=13: Addr=FFFF.FFFF.FFFF
Entry=14: Addr=FFFF.FFFF.FFFF
Entry=15: Addr=0060.3E28.6E00

Related Commands Command Description

show interfaces fastethernet Displays information about the Fast Ethernet interfaces.

Cisco IOS Interface and Hardware Component Command Reference

IR-479
 Interface and Hardware Component Commands
show controllers fddi

show controllers fddi

To display all information under the FDDI Interface Processor (FIP) on the Cisco 7200 series and
Cisco 7500 series routers, use the show controllers fddi command in user EXEC or privileged EXEC
mode.

show controllers fddi

Syntax Description This command has no arguments or keywords.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines This command reflects the internal state of the chips and information that 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.

Examples The following is sample output from the show controllers fddi command:
Router# show controllers fddi

Fddi2/0 - hardware version 2.2, microcode version 1.2

Phy-A registers:
cr0 4, cr1 0, cr2 0, status 3, cr3 0
Phy-B registers:
cr0 4, cr1 4, cr2 0, status 3, cr3 0
FORMAC registers:
irdtlb 71C2, irdtneg F85E, irdthtt F5D5, irdmir FFFF0BDC
irdtrth F85F, irdtmax FBC5, irdtvxt 5959, irdstmc 0810
irdmode 6A20, irdimsk 0000, irdstat 8060, irdtpri 0000
FIP registers
ccb: 002C cmd: 0006 fr: 000F mdptr: 0000 mema: 0000
icb: 00C0 arg: 0003 app: 0004 mdpg: 0000 af: 0603
clm: E002 bcn: E016 clbn: 0198 rxoff: 002A en: 0001
clmbc: 8011 bcnbc: 8011 robn: 0004 park: 0000 fop: 8004

txchn: 0000 pend: 0000 act: 0000 tail: 0000 cnt: 0000
state: 0003 check: 0000 eof: 0000 tail: 0000 cnt: 0000
rxchn: 0000 buf0: 0534 nxt0: 0570 eof: 0000 tail: 0000
eofch: 0000 buf1: 051C nxt1: 0528 pool: 0050 err: 005C

head: 0984 cur: 0000 t0: 0030 t1: 0027 t2: 000F
tail: 0984 cnt: 0001 t3: 0000 rxlft: 000B used: 0000
txq_s: 0018 txq_f: 0018 Aarm: 0000 Barm: 1388 fint: 8004

Total LEM: phy-a 6, phy-b 13

Cisco IOS Interface and Hardware Component Command Reference

IR-480
Interface and Hardware Component Commands
show controllers fddi

The last line of output indicates how many times the specific PHY encountered an “UNKNOWN LINE
STATE” event on the fiber.

Cisco IOS Interface and Hardware Component Command Reference

IR-481
 Interface and Hardware Component Commands
show controllers gigabitethernet

show controllers gigabitethernet

To display initialization block information, transmit ring, receive ring, and errors for Gigabit Ethernet
interface controllers, use the show controllers gigabitethernet command in privileged EXEC mode.

show controllers gigabitethernet slot/port

Syntax Description slot Slot number on the interface.

/port Port number on the interface.

Command Modes Privileged EXEC

Command History Release Modification

11.1 CC This command was introduced.
12.1(3a)E Support for the Cisco 7200-I/O-GE+E controller was introduced.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.

Usage Guidelines This command is used to display hardware and software information about the Gigabit Ethernet
interface. The I/O controller is always found in slot 0.

Examples The following is sample output from the show controllers gigabitethernet command:
Router# show controllers gigabitethernet 0/0

Interface GigabitEthernet0/0 (idb 0x627D8344)

Hardware is i82543 (Livengood) A1
network connection mode is AUTO
network link is up
loopback type is none
SERDES is enabled (TBI mode), GBIC is enabled
GBIC type is 1000BaseSX
idb->lc_ip_turbo_fs=0x604A82B0, ip_routecache=0x1(dfs=0/mdfs=0), max_mtu=1524
i82543_ds=0x627DA094, registers=0x3C100000, curr_intr=0
rx cache size=2000, rx cache end=1744, rx_nobuffer=0
i82543 MAC registers:
CTRL =0x0ACC0004, STATUS=0x00000FAB, CTRL_X=0x000048E0, IMS =0x00000096
RCTL =0x0042803A, RDBAL =0x2000E000, RDBAH =0x00000000, RDLEN =0x00001000
RDH =0x000000CB, RDT =0x000000CA, RDTR =0x00000000
TCTL =0x000400FA, TDBAL =0x20010000, TDBAH =0x00000000, TDLEN =0x00001000
TDH =0x00000057, TDT =0x00000057, TIPG =0x00600806
ETT =0x00000000, TXDMAC=0x00000001
TXCW =0xC00001A0, RXCW =0xDC004120, FCRTH =0x0000AFF0, FCRTL =0x80001200
FCAH =0x00000100, FCAL =0x00C28001, FCT =0x00008808, FCTTV =0x00000080
RDFH =0x00000BFA, RDFT =0x00000BFA, RDFPC =0x00000000
TDFH =0x00001EBA, TDFT =0x00001EBA, TDFPC =0x00000000
RX is normal, enabled TX is normal, enabled
Device status = full-duplex, link up
AN status = done(RF:0 , PAUSE:2 ), bit sync OK, rx idle stream, rx invalid
symbols, rx idle char

Cisco IOS Interface and Hardware Component Command Reference

IR-482
Interface and Hardware Component Commands
show controllers gigabitethernet

GBIC registers:
Register 0x00: 01 00 01 00 00 00 01 00
Register 0x08: 00 00 00 00 0D 00 00 00
Register 0x10: 32 1E 00 00 4D 65 74 68
Register 0x18: 6F 64 65 20 45 6C 65 63
Register 0x20: 2E 20 20 20 00 00 00 00
Register 0x28: 4D 47 42 43 2D 32 30 2D
Register 0x30: 34 2D 31 2D 53 20 20 20
Register 0x38: 31 30 30 30 00 00 00 55
Register 0x40: 00 0A 00 00 41 4A 42 48
Register 0x48: 47 30 36 30 20 20 20 20
Register 0x50: 20 20 20 20 30 30 30 33
Register 0x58: 32 30 20 20 00 00 00 61
PartNumber:MGBC-20-4-1-S
PartRev:G
SerialNo:AJBHG060
Options: 0
Length(9um/50um/62.5um):000/500/300
Date Code:000320
Gigabit Ethernet Codes: 1
PCI configuration registers:
bus_no=0, device_no=8
DeviceID=0x1001, VendorID=0x8086, Command=0x0156, Status=0x0230
Class=0x02/0x00/0x00, Revision=0x01, LatencyTimer=0xFC, CacheLineSize=0x20
BaseAddr0=0x48100000, BaseAddr1=0x00000000, MaxLat=0x00, MinGnt=0xFF
SubsysDeviceID=0x1001, SubsysVendorID=0x8086
Cap_Ptr=0x000000DC Retry/TRDY Timeout=0x00000000
PMC=0x00220001 PMCSR=0x00000000
I82543 Internal Driver Variables:
rxring(256)=0x2000E000, shadow=0x627DA3F0, head=203, rx_buf_size=512
txring(256)=0x20010000, shadow=0x627DA81C, head=87, tail=87
chip_state=2, pci_rev=1
tx_count=0, tx_limited=0
rx_overrun=0, rx_seq=0, rx_no_enp=0, rx_discard=0
throttled=0, enabled=0, disabled=0
reset=17(init=1, check=0, restart=3, pci=0), auto_restart=18
link_reset=0, tx_carrier_loss=1, fatal_tx_err=0
isl_err=0, wait_for_last_tdt=0
HW addr filter:0x627DB048, ISL disabled, Promiscuous mode on
Entry= 0: Addr=0000.C000.4000
(All other entries are empty)
i82543 Statistics
CRC error 0 Symbol error 7
Missed Packets 0 Single Collision 0
Excessive Coll 0 Multiple Coll 0
Late Coll 0 Collision 0
Defer 0 Receive Length 0
Sequence Error 0 XON RX 0
XON TX 0 XOFF RX 0
OFF TX 0 FC RX Unsupport 0
Packet RX (64) 11510 Packet RX (127) 17488
Packet RX (255) 1176 Packet RX (511) 7941
Packet RX (1023) 738 Packet RX (1522) 18
Good Packet RX 38871 Broadcast RX 0
Multicast RX 0 Good Packet TX 5208
Good Octets RX.H 0 Good Octets RX.L 5579526
Good Octets TX.H 0 Good Octets TX.L 513145
RX No Buff 0 RX Undersize 0
RX Fragment 0 RX Oversize 0
RX Octets High 0 RX Octets Low 5579526
TX Octets High 0 TX Octets Low 513145
TX Packet 5208 RX Packet 38871
TX Broadcast 1796 TX Multicast 330
Packet TX (64) 1795 Packet TX (127) 3110

Cisco IOS Interface and Hardware Component Command Reference

IR-483
 Interface and Hardware Component Commands
show controllers gigabitethernet

Packet TX (255) 0 Packet TX (511) 300

Packet TX (1023) 3 Packet TX (1522) 0
TX Underruns 0 TX No CSR 0
RX Error Count 0 RX DMA Underruns 0
RX Carrier Ext 0
TCP Segmentation 0 TCP Seg Failed 0

Related Commands Command Description

show interfaces Displays software and hardware information about an Ethernet interface.
ethernet
show interfaces Displays software and hardware information about a Gigabit Ethernet
gigabitethernet interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-484
 Interface and Hardware Component Commands
show controllers j1

show controllers j1
To display statistics about the J1 link, use the show controllers j1 command in privileged EXEC mode.

show controllers j1 slot/port

Syntax Description slot/port Backplane slot and port number on the controller.

Command Modes Privileged EXEC

Command History Release Modification

12.2(8)T The command was introduced on the J1 controller for the Cisco 2600 and
Cisco 3600 series.

Examples The following is sample output from the show controllers j1 command on the Cisco 3660:
Router# show controllers j1 3/0

J1 3/0 is up.
Applique type is Channelized J1 - TTC2M
No alarms detected.
Version info Firmware: 20010530, FPGA: 1
Framing is J1-TTC2M MF, Line Code is CMI, Clock Source is Line.
Data in current interval (344 seconds elapsed):
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs
Total Data (last 24 hours)
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins,
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs

Table 31describes the fields shown in the display.

Table 31 show controllers j1 Field Descriptions

Field Description
j1 3/0 is up. The J1 controller 3 in slot 0 is operating. The controller’s
state can be up, down, or administratively down.
Applique type The applique type is shown and is always Channelized.

Cisco IOS Interface and Hardware Component Command Reference

IR-485
 Interface and Hardware Component Commands
show controllers j1

Table 31 show controllers j1 Field Descriptions (continued)

Field Description
No alarms detected Any alarms detected by the controller are displayed here.
Possible alarms are as follows:
• Transmitter is sending remote alarm.
• Transmitter is sending AIS.
• Receiver has loss of signal.
• Receiver is getting AIS.
• Receiver has loss of frame.
• Receiver has remote alarm.
• Receiver has no alarms.
Version Indicates date of compilation.
Framing is Shows the current framing type which is always
J1-TTC2M MF.
Linecode is Shows the current line encoding type which is always coded
mark inversion (CMI).
Clock Source Shows the current clock source type.
Data in current interval (344 seconds Shows the current accumulation period, which rolls into the
elapsed) 24-hour accumulation every 15 minutes. Accumulation
period is from 1 to 900 seconds. The oldest 15-minute period
falls off the back of the 24-hour accumulation buffer.
Slip Secs Indicates the replication or deletion of the payload bits of a
DS1 frame. A slip might be performed when there is a
difference between the timing of a synchronous receiving
terminal and the received signal.
Fr Loss Secs Indicates the number of seconds an Out of Frame (OOF)
error is detected.
Line Err Secs Line errored seconds (LES) is a second in which one or more
line code violation errors are detected.
Degraded Mins A degraded minute is one in which the estimated error rate
exceeds 1E-6 but does not exceed 1E-3.
Errored Secs An errored second is a second in which one of the following
are detected:
• One or more path code violations.
• One or more out of rame defects.
• One or more controlled slip events.
• A detected alarm indication signal (AIS) defect.
Bursty Err Secs A second with fewer than 320 and more than 1 path coding
violation error, no severely errored frame defects, and no
detected incoming AIS defects. Controlled slips are not
included in this parameter.

Cisco IOS Interface and Hardware Component Command Reference

IR-486
Interface and Hardware Component Commands
show controllers j1

Table 31 show controllers j1 Field Descriptions (continued)

Field Description
Severely Err Secs A severely err sec is a second with one of the following
errors: 320 or more path code violation errors; one or more
out of frame defects; a detected AIS defect.
Unavail Secs A count of the total number of seconds where the controller
did not get a clock.

Cisco IOS Interface and Hardware Component Command Reference

IR-487
 Interface and Hardware Component Commands
show controllers mci

show controllers mci

To display all information under the Multiport Communications Interface (MCI) card or the Serial
Communications Interface (SCI) card, use the show controllers mci command in privileged EXEC
mode.

show controllers mci

Syntax Description This command has no arguments or keywords.

Command Modes Privileged EXEC

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines This command displays information that 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.
The interface type is queried only at startup. If the hardware changes subsequent to initial startup, 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, the display
presented for the show interfaces command incorrectly reports attachment to a DTE device although the
software recognizes the DCE interface and behaves accordingly.

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

MCI 0, controller type 1.1, microcode version 1.8

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

Table 32 describes significant fields shown in the display.

Cisco IOS Interface and Hardware Component Command Reference

IR-488
 Interface and Hardware Component Commands
show controllers mci

Table 32 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 ROM).
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 Count of restarts for the following conditions:
• 0 line down • Communication line down
• 0 hung output • Output unable to transmit
• 0 controller error • 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.

Related Commands Command Description

tx-queue-limit Controls the number of transmit buffers available to a specified interface on
the MCI and SCI cards.

Cisco IOS Interface and Hardware Component Command Reference

IR-489
 Interface and Hardware Component Commands
show controllers pcbus

show controllers pcbus

To display all information about the bus interface, use the show controllers pcbus command in
privileged EXEC mode.

show controllers pcbus

Syntax Description This command has no arguments or keywords.

Command Modes Privileged EXEC

Command History Release Modification

11.0 This command was introduced.

Usage Guidelines This command is valid on LanOptics Branchcard or Stacknet 2000 products only.

Examples The following is sample output from the show controllers pcbus command:
Router# show controllers pcbus

PCbus unit 0, Name = PCbus0 Hardware is ISA PCbus shared RAM

IDB at 0x3719B0, Interface driver data structure at 0x3735F8
Control/status register at 0x2110008, Shared memory at 0xC000000
Shared memory is initialized

Shared memory interface control block :

Magic no = 0x41435A56 (valid) Version = 1.0
Shared memory size = 64K bytes, Interface is NOT shutdown
Interface state is up, line protocol is up

Tx buffer : (control block at 0xC000010)

Start offset = 0x30, Size = 0x7FE8, Overflows = 1
GET_ptr = 0x4F6C, PUT_ptr = 0x4F6C, WRAP_ptr = 0x3BB0

Rx buffer : (control block at 0xC000020)

Start offset = 0x8018, Size 0x7FE8, Overflows = 22250698
GET_ptr = 0x60, PUT_ptr = 0x60, WRAP_ptr = 0x7FD0

Interrupts received = 567

Cisco IOS Interface and Hardware Component Command Reference

IR-490
 Interface and Hardware Component Commands
show controllers pos

show controllers pos

To display information about the Packet-over-SONET (POS) controllers, use the show controllers pos
command in privileged EXEC mode.

show controllers pos [slot-number] [details | pm [time-interval]]

Syntax Description slot-number (Optional) Number of the chassis slot that contains the POS interface. If you
do not specify a slot number, information for all the installed POS controllers
is displayed.

Cisco 7500 Series Routers

Use slot/port-adapter/port (for example, 2/0/0).

Cisco 12000 Series Routers

Use slot/port (for example, 4/0).
details (Optional) In addition to the normal information displayed by the show
controllers pos command, the details keyword provides a hexadecimal and
ASCII “dump” of the path trace buffer.
pm (Optional) Displays SONET performance monitoring statistics accumulated
for a 24-hour period in 15-minute intervals.
time-interval (Optional) Number of the SONET MIB 15-minute time interval in the range
from 1 to 96. If the time-interval argument is not specified, the performance
monitoring statistics for the current time interval are displayed.

Command Modes Privileged EXEC

Command History Release Modification

11.1 CC This command was introduced.

Usage Guidelines The show controllers pos command with the pm keyword displays SONET performance monitoring
statistics accumulated at 15-minute intervals, and these statistics can be queried using Simple Network
Management Protocol (SNMP) tools. The performance monitoring statistics are collected according to
the RFC 1595 specification.
The information that this command displays is generally useful only for diagnostic tasks performed by
technical support personnel.

Examples The following is sample output from the show controllers pos command on a Cisco 7500 series router:
Router# show controllers pos

POS2/0/0
SECTION
LOF = 0 LOS = 2335 BIP(B1) = 77937133

Cisco IOS Interface and Hardware Component Command Reference

IR-491
 Interface and Hardware Component Commands
show controllers pos

LINE
AIS = 2335 RDI = 20 FEBE = 3387950089 BIP(B2) = 1622825387
PATH
AIS = 2340 RDI = 66090 FEBE = 248886263 BIP(B3) = 103862953
LOP = 246806 NEWPTR = 11428072 PSE = 5067357 NSE = 4645

Active Defects: B2-TCA B3-TCA

Active Alarms: None
Alarm reporting enabled for: B1-TCA

APS
COAPS = 12612784 PSBF = 8339
State: PSBF_state = False
Rx(K1/K2): 00/CC Tx(K1/K2): 00/00
S1S0 = 03, C2 = 96
CLOCK RECOVERY
RDOOL = 64322060
State: RDOOL_state = True
PATH TRACE BUFFER: UNSTABLE
Remote hostname :
Remote interface:
Remote IP addr :
Remote Rx(K1/K2): ../.. Tx(K1/K2): ../..
BER thresholds: SF = 10e-3 SD = 10e-8
TCA thresholds: B1 = 10e-7 B2 = 10e-3 B3 = 10e-6

Table 33 describes the fields shown in the display.

Table 33 show controllers pos Field Descriptions

Field Description
POS2/0/0 Slot number of the POS interface.
LOF Section loss of frame is detected when a severely error framing (SEF)
defect on the incoming SONET signal persist for 3 milliseconds.
LOS Section loss of signal is detected when an all-zeros pattern on the
incoming SONET signal lasts 19 plus or minus 3 microseconds or
longer. This defect might also be reported if the received signal level
drops below the specified threshold.
BIP(B1)/BIP(B2)/BIP(B3) Bit interleaved parity (BIP).
For B1, the BIP error report is calculated by comparing the BIP-8 code
with the BIP-8 code extracted from the B1 byte of the following frame.
Differences indicate that section-level bit errors have occurred.
For B2, the BIP error report is calculated by comparing the BIP-8/24
code with the BIP-8 code extracted from the B2 byte of the following
frame. Differences indicate that line-level bit errors have occurred.
For B3, the BIP error report is calculated by comparing the BIP-8 code
with the BIP-8 code extracted from the B3 byte of the following frame.
Differences indicate that path-level bit errors have occurred.

Cisco IOS Interface and Hardware Component Command Reference

IR-492
Interface and Hardware Component Commands
show controllers pos

Table 33 show controllers pos Field Descriptions (continued)

Field Description
AIS Alarm indication signal.
A line alarm indication signal is sent by the section terminating
equipment (STE) to alert the downstream line terminating equipment
(LTE) that a loss of signal (LOS) or loss of frame (LOF) defect has been
detected on the incoming SONET section.
A path alarm indication signal is sent by the LTE to alert the
downstream path terminating equipment (PTE) that it has detected a
defect on its incoming line signal.
RDI Remote defect indication.
A line remote defect indication is reported by the downstream LTE
when it detects LOF, LOS, or AIS.
A path remote defect indication is reported by the downstream PTE
when it detects a defect on the incoming signal.
FEBE Far end block errors.
Line FEBE (accumulated from the M0 or M1 byte) is reported when the
downstream LTE detects BIP(B2) errors.
Path FEBE (accumulated from the G1 byte) is reported when the
downstream PTE detects BIP(B3) errors.
LOP Path loss of pointer is reported as a result of an invalid pointer (H1, H2)
or an excess number of new data flag (NDF) enabled indications.
NEWPTR Inexact count of the number of times that the SONET framer has
validated a new SONET pointer value (H1, H2).
PSE Inexact count of the number of times that the SONET framer has
detected a positive stuff event in the received pointer (H1, H2).
NSE Inexact count of the number of times that the SONET framer has
detected a negative stuff event in the received pointer (H1, H2).
Active Defects List of all currently active SONET defects.
Active Alarms List of current alarms as enforced by Sonet Alarm Hierarchy.
Alarm reporting enabled for List of alarms for which you enabled reporting with the pos report
interface command.
APS Automatic protection switching.
COAPS An inexact count of the number of times that a new APS value has been
detected in the K1, K2 bytes.
PSBF An inexact count of the number of times that a protection switching
byte failure has been detected (no three consecutive SONET frames
contain identical K1 bytes).
PSBF_state Protection switching byte failure state.
Rx(K1/K2)/Tx(K1/K2) Contents of the received and transmitted K1 and K2 bytes.
S1S0 The two S bits received in the last H1 byte.
C2 The value extracted from the SONET path signal label byte (C2).

Cisco IOS Interface and Hardware Component Command Reference

IR-493
 Interface and Hardware Component Commands
show controllers pos

Table 33 show controllers pos Field Descriptions (continued)

Field Description
CLOCK RECOVERY The SONET clock is recovered using information in the SONET
overhead. RDOOL is an inexact count of the number of times that
Receive Data Out Of Lock has been detected, which indicates that the
clock recovery phased lock loop is unable to lock to the receive stream.
PATH TRACE BUFFER SONET path trace buffer is used to communicate information regarding
the remote host name, interface name/number, and IP address. This is a
Cisco-proprietary use of the J1 (path trace) byte.
BER thresholds List of the bit error rate (BER) thresholds that you configured with the
pos threshold interface command.
TCA thresholds List of threshold crossing alarms (TCAs) that you configured with the
pos threshold interface command.

The following is sample output from the show controllers pos pm command that displays performance
monitoring statistics on a Cisco 12000 series router:
Router# show controllers pos 1/0 pm

POS1/0
Medium is SONET
Line coding is RZ, Line type is LONG SM
Data in current interval (516 seconds elapsed)
SECTION ( NO DEFECT )
515 Errored Secs, 515 Severely Err Secs
0 Coding Violations, 515 Sev Err Framing Secs
LINE ( NO DEFECT )
0 Errored Secs, 0 Severely Err Secs
0 Coding Violations, 0 Unavailable Secs
FAR END LINE
0 Errored Secs, 0 Severely Err Secs
0 Coding Violations, 0 Unavailable Secs
PATH ( NO DEFECT )
0 Errored Secs, 0 Severely Err Secs
0 Coding Violations, 0 Unavailable Secs
FAR END PATH
0 Errored Secs, 0 Severely Err Secs
0 Coding Violations, 0 Unavailable Secs

Table 34 describes the fields shown in the display.

Table 34 show controllers pos pm Field Descriptions

Field Description
POS1/0 Slot number of the POS interface.
Line coding Shows the current line encoding type, either return to zero (RZ) or nonreturn
to zero (NRZ).
Line type Line type for this interface. Optical line types can be either long range
(LONG) or short range (SHORT), and either single mode (SM) or multimode
(MM).

Cisco IOS Interface and Hardware Component Command Reference

IR-494
 Interface and Hardware Component Commands
show controllers pos

Table 34 show controllers pos pm Field Descriptions (continued)

Field Description
Data in current interval Shows the current accumulation period, which rolls into the 24-hour
accumulation every 15 minutes. Accumulation period is from 1 to 900
seconds. The oldest 15-minute period falls off the back of the 24-hour
accumulation buffer.
Errored Secs An errored second is a second in which one of the following is detected:
• One or more coding violations.
• One or more incoming defects (for example, a severely errored frame
(SEF) defect, an LOS defect, an AIS defect, or an LOP defect).
Severely Err Secs A severely errored second (SES) is a second with one of the following errors:
• A certain number of coding violations. The number is dependent on the
line rate and the BER.
• A certain number of incoming defects.
Coding Violations Number of coding violations for the current interval. Coding violations are
defined as BIP errors that are detected in the incoming signal. The coding
violations counter is incremented for each BIP error detected.
Sev Err Framing Secs Severely errored framing seconds (SEFS) are seconds with one or more SEF
defects.
Unavailable Secs Total number of seconds for which the interface is unavailable. The interface
is considered to be unavailable after a series of ten consecutive SESs.

Related Commands Command Description

pos report Permits selected SONET alarms to be logged to the console for a POS
interface.
pos threshold Sets the BER threshold values of specified alarms for a POS interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-495
 Interface and Hardware Component Commands
show controllers satellite

show controllers satellite

To display controller information about the internal router interface that connects to an installed Cisco IP
VSAT satellite WAN network module (NM-1VSAT-GILAT), use the show controllers satellite
command in user EXEC or privileged EXEC mode.

show controllers satellite slot/unit

Syntax Description slot Router chassis slot in which the network module is installed.
/unit Interface number. For NM-1VSAT-GILAT network modules, always use 0.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines The output from this command is generally useful for diagnostic tasks performed by technical support.
The show controllers satellite command displays information about initialization block, transmit ring,
receive ring, and errors for the Fast Ethernet controller chip in the internal router interface that connects
to an installed Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT).

Examples The following example shows how to display controller information about the internal router interface
that connects to an installed NM-1VSAT-GILAT network module:
Router# show controllers satellite 2/0

Interface Satellite2/0
Hardware is Intel 82559 FastEthernet
IDB:640B6584, FASTSEND:60A585E0, MCI_INDEX:0

INSTANCE=0x640B7D84
Rx Ring entries = 64
Rx Shadow = 0x640B8054
Rx Ring = 0x 70FEE80
Rx Ring Head = 51
Rx Ring Last = 50
Rx Buffer Descr = 0x 70FF2C0
Rx Buffer Descr Head = 51
Rx Buffer Descr Last = 50
Rx Shadow (malloc) = 0x640B8054
Rx Ring (malloc) = 0x 70FEE80
Rx Buffer Descr (malloc) = 0x 70FF2C0
Tx Ring entries = 128
Tx Shadow = 0x640B8184
Tx Shadow Head = 78
Tx Shadow Tail = 78
Tx Shadow Free = 128

Cisco IOS Interface and Hardware Component Command Reference

IR-496
Interface and Hardware Component Commands
show controllers satellite

Tx Ring = 0x 70FF700
Tx Head = 80
Tx Last = 79
Tx Tail = 80
Tx Count = 0
Tx Buffer Descr = 0x 7100740
Tx Buffer Descr Head = 0
Tx Buffer Descr Tail = 0
Tx Shadow (malloc) = 0x640B8184
Tx Ring (malloc) = 0x 70FF700
Tx Buffer Descr (malloc) = 0x 7100740

CONTROL AND STATUS REGISTERS (CSR)=0x3E000000

SCB Intr Mask = 00
SCB CU/RU Cmd = 00
SCB Intr Status = 00
SCB CU Status = 01
SCB RU Status = 04
SCB General Ptr = 00000000
PORT = 00000000
EEPROM = 0008
FLASH = 0002
MDI = 1821780D
Rx Byte Count = 00000608
PMDR = 80
FC Cmd = 00
FC Threshold = 03
Early Rx = 00
General Status = 03
General Control = 00

PHY REGISTERS
Register 0x00: 2000 780D 02A8 0154 0081 0000 0000 0000
Register 0x08: 0000 0000 0000 0000 0000 0000 0000 0000
Register 0x10: 0202 0000 0001 0005 0000 0000 0000 0000
Register 0x18: 0000 0000 8B10 0000 0010 0000 0000 0000

HARDWARE STATISTICS
Rx good frames: 420979
Rx CRC: 0
Rx alignment: 0
Rx resource: 0
Rx overrun: 0
Rx collision detects: 0
Rx short: 0
Tx good frames: 653125
Tx maximum collisions: 0
Tx late collisions: 0
Tx underruns: 0
Tx lost carrier sense: 9
Tx deferred: 86
Tx single collisions: 1
Tx multiple collisions:1
Tx total collisions: 3
FC Tx pause: 0
FC Rx pause: 0
FC Rx unsupported: 0

INTERRUPT STATISTICS
CX = 653136
FR = 420979
CNA = 0
RNR = 0
MDI = 0

Cisco IOS Interface and Hardware Component Command Reference

IR-497
 Interface and Hardware Component Commands
show controllers satellite

SWI = 0
FCP = 0

Receive All Multicasts = enabled

Receive Promiscuous = disabled
Loopback Mode = disabled

Table 35 describes the significant fields shown in the display.

Table 35 show controllers satellite Field Descriptions

Field Description
Hardware Description of the chip being used.
IDB Address in router memory of the Interface Descriptor Block
(IDB).
FASTSEND Fastsend routine.
INSTANCE Device-specific data stored in router memory that lists the
memory locations and current indices of receive (Rx) and
transmit (Tx) rings in router I/O memory.
CONTROL AND STATUS Control and status registers that are physically located on the
REGISTERS (CSR) chip itself and that are accessed by the CPU over the protocol
control information (PCI) bus.
PHY REGISTERS Contents of the physical layer (PHY) registers of the PHY
module, which is an internal device that interfaces between
the internal physical Ethernet line and the external physical
line.
HARDWARE STATISTICS Receive (Rx) and transmit (Tx) traffic statistics collected by
the chip.
INTERRUPT STATISTICS Receive (Rx), transmit (Tx), control, software, and flow
control interrupt statistics collected by the chip.

Related Commands Command Description

service-module Displays status information related to the hardware and software on the
satellite status Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT),
including the initial configuration parameters.
show interfaces Displays general interface settings and traffic rates for the internal router
satellite interface that connects to an installed Cisco IP VSAT satellite WAN
network module (NM-1VSAT-GILAT).

Cisco IOS Interface and Hardware Component Command Reference

IR-498
 Interface and Hardware Component Commands
show controllers serial

show controllers serial

To display information that is specific to the interface hardware, use the show controllers serial
command in privileged EXEC mode.
Standard Syntax

show controllers serial [slot/port]

Cisco 7000 Series with the RSP7000 and RSP7000CI and Cisco 7500 Series

show controllers serial [slot/port-adapter/port]

Syntax Description slot (Optional) Slot number of the interface.

/port (Optional) Port number on the interface.
/port-adapter (Optional) On Cisco 7500 series routers and Cisco 7000 series routers with
the RSP7000 and RSP7000CI, the location of the port adapter on a Versatile
Interface Processor (VIP). The value can be 0 or 1.

Command Modes Privileged EXEC

Command History Release Modification

10.0 This command was introduced.
11.1 CA This command was modified to include support for the PA-E3 and PA-T3 port adapters.

Usage Guidelines The information displayed is generally useful for diagnostic tasks performed by technical support
personnel only. For the PA-E3 or PA-T3 port adapters, the show controllers serial command also
displays configuration information such as the framing, clock source, bandwidth limit, whether
scrambling is enabled, the national bit, the international bits, and DSU mode configured on the interface.
Also displayed is the performance statistics for the current interval and last 15-minute interval and
whether any alarms exist.

Examples The following is sample output from the show controllers serial command on the Cisco 4000:
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

Cisco IOS Interface and Hardware Component Command Reference

IR-499
 Interface and Hardware Component Commands
show controllers serial

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

The following is sample output from the show controllers serial command for a PA-E3 serial port
adapter installed in slot 2:
Router# show controllers serial 2/0

M1T-E3 pa: show controller:

PAS unit 0, subunit 0, f/w version 2-55, rev ID 0x2800001, version 2
idb = 0x6080D54C, ds = 0x6080F304, ssb=0x6080F4F4
Clock mux=0x30, ucmd_ctrl=0x0, port_status=0x1
Serial config=0x8, line config=0x1B0202

Cisco IOS Interface and Hardware Component Command Reference

IR-500
Interface and Hardware Component Commands
show controllers serial

maxdgram=4474, bufpool=128Kb, 256 particles

rxLOS inactive, rxLOF inactive, rxAIS inactive

txAIS inactive, rxRAI inactive, txRAI inactive

line state: up
E3 DTE cable, received clockrate 50071882

base0 registers=0x3D000000, base1 registers=0x3D002000

mxt_ds=0x608BA654, rx ring entries=128, tx ring entries=256
rxring=0x4B01F480, rxr shadow=0x6081081C, rx_head=26
txring=0x4B01F960, txr shadow=0x60810E48, tx_head=192, tx_tail=192, tx_count=0
throttled=0, enabled=0, disabled=0
rx_no_eop_err=0, rx_no_stp_err=0, rx_no_eop_stp_err=0
rx_no_buf=0, rx_soft_overrun_err=0, dump_err= 1
tx_underrun_err=0, tx_soft_underrun_err=0, tx_limited=0
tx_fullring=0, tx_started=11504
Framing is g751, Clock Source is Line, Bandwidth limit is 34010.
Scrambling is enabled
National Bit is 0, International Bits are: 0 0
DSU mode 1
Data in current interval (213 seconds elapsed):
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation
0 P-bit Err Secs, 0 P-bit Severely Err Secs
0 Severely Err Framing Secs, 0 Unavailable Secs
0 Line Errored Secs, 0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
Total Data (last 24 hours)
0 Line Code Violations, 0 P-bit Coding Violation,
0 C-bit Coding Violation,
0 P-bit Err Secs, 0 P-bit Severely Err Secs,
0 Severely Err Framing Secs, 0 Unavailable Secs,
0 Line Errored Secs, 0 C-bit Errored Secs, 0 C-bit Severely Errored Secs

No alarms detected.

The following is sample output from the show controllers serial command that shows serial port 1/0/0
on a 1-port PA-T3 serial port adapter installed on a VIP2 in chassis slot 1:
Router# show controllers serial 2/0/1

Serial1/0/0 -
Mx T3(1) HW Revision 0x3, FW Revision 2.55
Framing is c-bit, Clock Source is Line
Bandwidth limit is 35000, DSU mode 1, Cable length is 50

Data in current interval (325 seconds elapsed):

0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation
0 P-bit Err Secs, 0 P-bit Sev Err Secs
0 Sev Err Framing Secs, 0 Unavailable Secs
0 Line Errored Secs, 0 C-bit Errored Secs, 0 C-bit Sev Err Secs
Total Data (last 24 hours)
0 Line Code Violations, 0 P-bit Coding Violation,
0 C-bit Coding Violation,
0 P-bit Err Secs, 0 P-bit Sev Err Secs,
0 Sev Err Framing Secs, 0 Unavailable Secs,
0 Line Errored Secs, 0 C-bit Errored Secs, 0 C-bit Sev Err Secs
No alarms detected.

Cisco IOS Interface and Hardware Component Command Reference

IR-501
 Interface and Hardware Component Commands
show controllers sonet

show controllers sonet

To display information about SONET controllers, use the show controllers sonet command in user
EXEC or privileged EXEC mode with the appropriate parameters for the operating mode of the
channelized line.

show controllers sonet [slot/port | slot/port.sts1-number/t1-number | slot/port.vtg1-number/

sts1-number/t1-number | slot/port.au-3-number/tug-2-number/t1-number |
slot/port.au-4-number/tug-3-number/tug-2-number/e1-line-number |
slot/port.au-4-number/vc3-number | slot/port:interface-number |
t3 slot/port:t1-line-number] [bert | brief | tabular]

Syntax Description slot/port (Optional) Slot and port number. The slash mark is required
between the slot argument and the port argument.
Note This form of the syntax is used only for the STM-1 trunk
card on a Cisco AS5850 universal gateway.
slot/port.sts1-number/ (Optional) Slot and port number of a T1 line under SONET framing
t1-number in CT3 mode.
slot/port.vtg1-number/ (Optional) Slot and port number of a T1 line under SONET framing
sts1-number/t1-number in VT-15 mode.
slot/port.au-3-number/ (Optional) Slot and port number of a T1 line under SDH framing
tug-2-number/t1-number with AU-3 AUG mapping.
slot/port.au-4-number/ (Optional) Slot and port number of an E1 line under SDH framing
tug-3-number/tug-2-number/ with AU-4 AUG mapping.
e1-line-number
slot/port.au-4-number/ (Optional) Slot and port number of a DS3/E3 interface under SDH
vc3-number framing with AU-4 mapping.
slot/port:interface-number (Optional) Slot and port number of a DS3/E3 interface under
SONET framing or SDH framing with AU-3 mapping.
t3 slot/port:t1-line-number (Optional) Displays information for a T1 line under SF or ESF
format framing.
bert (Optional) Displays bit error rate test (BERT) information.
brief (Optional) Displays summary information.
tabular (Optional) Displays information in a tabular format.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

12.0(21)S This command was introduced on Cisco 12000 series Internet routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T, and
support was added for the STM-1 trunk card on the Cisco AS5850 platform.
12.3(11)T Output was modified to support SONET APS on the Cisco AS5850
platform.

Cisco IOS Interface and Hardware Component Command Reference

IR-502
 Interface and Hardware Component Commands
show controllers sonet

Usage Guidelines You can enter the show controllers sonet command at any time during a BER test.

Examples The following is sample output from the show controllers sonet command on a T1 line under SONET
framing in VT-15 mode. (Table 36 describes the lines in the BER test portion of the output.)
Router# show controllers sonet 4/0.1/1/1 brief

OC3.STS1 4/0.1 is up. Hardware is GSR 2 port STM1/OC3 (channelized)

Applique type is VT1.5 in STS-1

STS-1 1, VTG 1, T1 1 (VT1.5 1/1/1) is up

timeslots: 1-24
FDL per AT&T 54016 spec.
No alarms detected.
Framing is ESF, Clock Source is Internal
BERT test result (running)
Test Pattern : 2^20-QRSS, Status : Sync, Sync Detected : 1
Interval : 5 minute(s), Time Remain : 4 minute(s)
Bit Errors (since BERT started): 0 bits,
Bits Received (since BERT started): 112 Mbits
Bit Errors (since last sync): 0 bits
Bits Received (since last sync): 112 Mbits

Table 36 show controllers sonet Line Descriptions

Output Line Description

BERT test result (running) Indicates the current state of the test. In this case,
“running” indicates that the test is still active. If
the test is complete, “done” is displayed.
Test Pattern : 2^20-QRSS, Status : Sync, Indicates the test pattern that you selected for the
Sync Detected : 1 test (2^20-QRSS), the current synchronization
state (Sync), and the number of times that
synchronization was detected during this test (1).
Interval : 5 minute(s), Time Remain : 4 minute(s) Indicates the time allocated for the test to run and
the time remaining for the test to run.
For a BER test that you terminate before the time
expires, this line indicates the time the test would
have taken to run and the time remaining for the
test to run had you not terminated it. “unable to
complete” is displayed to indicate that you
interrupted the test.
Bit Errors (since BERT started): 0 bits Shows the bit errors that were detected versus the
Bits Received (since BERT started): 112 Mbits total number of test bits that were received since
Bit Errors (since last sync): 0 bits the test started and since the last synchronization
Bits Received (since last sync): 112 Mbits was detected.

Cisco IOS Interface and Hardware Component Command Reference

IR-503
 Interface and Hardware Component Commands
show controllers sonet

The following is sample output from the show controllers sonet command for an E1 line under SDH
framing with AU-4 AUG mapping.
Router# show controllers sonet 3/0.1/1/3/5

SONET 3/0 is up. (Configured for Locally Looped) Hardware is GSR 2 port
STM1/OC3 (channelized)
Applique type is Channelized OCx interface
Clock Source is Line, AUG mapping is AU4.
Medium info:
Type: SDH, Line Coding: NRZ, Line Type: Short SM
Regenerator Section:
LOF = 0 LOS = 0 BIP(B1) = 0
Multiplex Section:
AIS = 0 RDI = 0 REI = 0 BIP(B2) = 0
Active Defects: None
Active Alarms: None
Alarm reporting enabled for: SF SLOS SLOF B1-TCA B2-TCA B3-TCA
BER thresholds: SF = 10e-3 SD = 10e-6
TCA thresholds: B1 = 10e-6 B2 = 10e-6 B3 = 10e-6
High Order Path:

PATH 1:
AIS = 0 RDI = 0 REI = 15 BIP(B3) = 11
LOP = 0 PSE = 4 NSE = 0 NEWPTR = 1
LOM = 0 PLM = 0 UNEQ = 0
Active Defects: None

S1S0 = 02, C2 = 02

PATH TRACE BUFFER : STABLE

CRC-7: 0xF2 OK
52 6F 75 74 65 72 33 2F 30 2F 31 00 00 00 00 Router3/0/1....

STM1.AU4 3/0.1 is up. Hardware is GSR 2 port STM1/OC3 (channelized)

Applique type is C12 in TUG-3 in AU-4

AU-4 1, TUG-3 1, TUG-2 1, E1 1 (C-12 1/1/1/1) is up

timeslots: 1-31
No alarms detected.
Framing is crc4, Clock Source is Internal
BERT test result (running)
Test Pattern : 2^15, Status : Sync, Sync Detected : 1
Interval : 5 minute(s), Time Remain : 5 minute(s)
Bit Errors (since BERT started): 0 bits,
Bits Received (since BERT started): 95 Mbits
Bit Errors (since last sync): 0 bits
Bits Received (since last sync): 95 Mbits
Data in current interval (708 seconds elapsed):
0 Line Code Violations, 1 Path Code Violations
0 Slip Secs, 1 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
1 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavail Secs, 0 Stuffed Secs
Data in Interval 1:
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavail Secs, 0 Stuffed Secs
Data in Interval 2:
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavail Secs, 0 Stuffed Secs

Cisco IOS Interface and Hardware Component Command Reference

IR-504
Interface and Hardware Component Commands
show controllers sonet

Data in Interval 3:
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 1 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
1 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavail Secs, 0 Stuffed Secs
Total Data (last 3 15 minute intervals):
0 Line Code Violations,0 Path Code Violations,
0 Slip Secs, 1 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins,
1 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavail Secs, 0 Stuffed Secs

The following is sample output from the show controllers sonet command when AUG mapping is AU-3
and the tabular keyword is specified.
Router# show controllers sonet 2/0.1/1/1 tabular

SONET 2/0/0 is up.

Channelized OC-3/STM-1 SMI PA
H/W Version : 0.2.3, ROM Version : 1.2
FREEDM version : 2, F/W Version : 0.14.0
SONET 2/0/0 E1 1/1/1 is down
Transmitter is sending LOF Indication (RAI).
Receiver has loss of frame.
Framing is crc4, Clock Source is internal, National bits are 0x1F.
INTERVAL LCV PCV CSS SEFS LES DM ES BES SES UAS SS
17:26-17:29 0 0 0 0 0 0 0 0 0 173 0
17:11-17:26 0 0 0 0 0 0 0 0 0 471 0
16:56-17:11 0 0 0 0 0 0 0 0 0 0 0
16:41-16:56 0 0 0 0 0 0 0 0 0 0 0
16:26-16:41 0 0 0 0 0 0 0 0 0 216 0
16:11-16:26 0 0 0 0 0 0 0 0 0 225 0
Total 0 0 0 0 0 0 0 0 0 912 0

The following is partial sample output from the show controllers sonet command using an STM-1 card
in the Cisco AS5850.
Router# show controllers sonet 3/0

SONET 3/0 is down.

Applique type is Channelized Sonet/SDH
Clock Source is Internal, AUG mapping is AU4.

Medium info:
Type: SDH, Line Coding: NRZ, Line Type: Short SM

Regenerator Section Status:

LOS

Multiplex Section Status:

Higher Order Path Status:

Path# 1 has no defects

Lower Order Path Status:

VC-12 1/1/1/1 has no defects
VC-12 1/1/1/2 has no defects
VC-12 1/1/1/3 has no defects
VC-12 1/1/2/1 has no defects
VC-12 1/1/2/2 has no defects
VC-12 1/1/2/3 has no defects
VC-12 1/1/3/1 has no defects
VC-12 1/1/3/2 has no defects
VC-12 1/1/3/3 has no defects
VC-12 1/1/4/1 has no defects

Cisco IOS Interface and Hardware Component Command Reference

IR-505
 Interface and Hardware Component Commands
show controllers sonet

VC-12 1/1/4/2 has no defects

VC-12 1/1/4/3 has no defects
VC-12 1/1/5/1 has no defects
VC-12 1/1/5/2 has no defects
VC-12 1/1/5/3 has no defects
VC-12 1/1/6/1 has no defects
VC-12 1/1/6/2 has no defects
.
.
.
VC-12 1/3/5/3 has no defects
VC-12 1/3/6/1 has no defects
VC-12 1/3/6/2 has no defects
VC-12 1/3/6/3 has no defects
VC-12 1/3/7/1 has no defects
VC-12 1/3/7/2 has no defects
VC-12 1/3/7/3 has no defects
Data in current interval (20 seconds elapsed):
Regenerator Section:
0 CVs, 20 ESs, 20 SESs, 0 SEFSs
Multiplex Section:
0 CVs, 0 ESs, 0 SESs, 0 UASs
Higher Order Path:
Path# 1: 0 CVs, 0 ESs, 0 SESs, 20 UASs
Lower Order Path:
VC-12 1/1/1/1: 0 CVs, 0 ESs, 0 SESs, 20 UASs
VC-12 1/1/1/2: 0 CVs, 0 ESs, 0 SESs, 20 UASs
VC-12 1/1/1/3: 0 CVs, 0 ESs, 0 SESs, 20 UASs
VC-12 1/1/2/1: 0 CVs, 0 ESs, 0 SESs, 20 UASs
VC-12 1/1/2/2: 0 CVs, 0 ESs, 0 SESs, 20 UASs
VC-12 1/1/2/3: 0 CVs, 0 ESs, 0 SESs, 20 UASs
.
.
.
VC-12 1/3/5/3: 0 CVs, 0 ESs, 0 SESs, 20 UASs
VC-12 1/3/6/1: 0 CVs, 0 ESs, 0 SESs, 20 UASs
VC-12 1/3/6/2: 0 CVs, 0 ESs, 0 SESs, 20 UASs
VC-12 1/3/6/3: 0 CVs, 0 ESs, 0 SESs, 20 UASs
VC-12 1/3/7/1: 0 CVs, 0 ESs, 0 SESs, 20 UASs
VC-12 1/3/7/2: 0 CVs, 0 ESs, 0 SESs, 20 UASs
VC-12 1/3/7/3: 0 CVs, 0 ESs, 0 SESs, 20 UASs

Table 30 describes the significant fields shown in the display.

Table 37 show controllers sonet STM-1 Field Descriptions

Field Description
SONET 3/0 The SONET controller in slot 3 shows the state in which it is
operating. The controller’s state can be up, down, or
administratively down. Loopback conditions are shown by
(Locally Looped) or (Remotely Looped).
Applique type Controller type.
Clock Source User-specified clock source (Line or Internal).
AUG mapping Indicates type of administrative unit group (AUG) mapping.
Line Coding Shows the current line encoding type, either return to zero (RZ)
or nonreturn to zero (NRZ).

Cisco IOS Interface and Hardware Component Command Reference

IR-506
Interface and Hardware Component Commands
show controllers sonet

Table 37 show controllers sonet STM-1 Field Descriptions (continued)

Field Description
Line Type Line type for this interface. Optical line types can be either long
range (LONG) or short range (SHORT), and either single mode
(SM) or multimode (MM).
VC-12 Indicates the number of the virtual circuit (VC) and whether the
VC has reported any defects.
CVs Number of coding violation (CV) error events.
ESs An errored second (ES) is a second in which one of the following
is detected:
• One or more path code violations.
• One or more out of frame defects.
• One or more controlled slip events.
• A detected alarm indication signal (AIS) defect.
SESs Severely errored seconds (SESs) are seconds with one or more
out-of-frame defects or a detected incoming AIS. This gauge is
not incremented when UASs are counted.
SEFSs Severely errored framing seconds (SEFSs) are seconds with one
or more out-of-frame defects or a detected incoming AIS.
UASs Unavailable seconds (UASs) are calculated by counting the
number of seconds for which the interface is unavailable.

The following is partial output from the show controllers sonet command using an STM-1 card in the
Cisco AS5850 with SONET APS configured.
Router# show controllers sonet 1/0

SONET 1/0 is up.

Applique type is Channelized Sonet/SDH
Clock Source is Line, AUG mapping is AU4.
MSP 1+1 bi-directional enabled
Protection fiber (Port 0), No Alarm, traffic in-use
Working fiber (Port 1), No Alarm, traffic not in-use
Local request: No Request
Remote request: No Request

Medium info:
Type: SDH, Line Coding: NRZ, Line Type: Short SM

Regenerator Section Status:

No alarms detected.

Multiplex Section Status:

No alarms detected.
No BER failure/degrade detected
B2 BER_SF threshold power : 3
B2 BER_SD threshold power : 6

Higher Order Path Status:

Path# 1 has no defects

Cisco IOS Interface and Hardware Component Command Reference

IR-507
 Interface and Hardware Component Commands
show controllers sonet

Lower Order Path Status:

VC-12 1/1/1/1 has no defects
VC-12 1/1/1/2 has no defects
VC-12 1/1/1/3 has no defects
.
.
.

Table 38 describes the significant fields shown in the display that are different from the fields described
in Table 30.

Table 38 show controllers sonet STM-1 APS Field Descriptions

Field Description
MSP 1+1 Indicates whether the SDH multiplex section protection (MSP) is
bidirectional or unidirectional.
Protection fiber Indicates the port location of the protect fiber, whether an alarm
has been detected, and whether traffic is flowing through the port.
Working fiber Indicates the port location of the working fiber, whether an alarm
has been detected, and whether traffic is flowing through the port.
Local request Indicates whether a local request to switch fibers has been
received. If a request has been received, the type of request
(forced, lockout, or manual) is indicated.
Remote request Indicates whether a remote request to switch fibers has been
received. If a request has been received, the type of request
(forced, lockout, or manual) is indicated.
No alarms detected Any alarms detected by the controller are displayed here. Possible
alarms are as follows:
• Transmitter is sending remote alarm.
• Transmitter is sending alarm indication signal (AIS).
• Receiver has loss of signal.
• Receiver is getting AIS.
• Receiver has loss of frame.
• Receiver has remote alarm.
• Receiver has no alarms.
No BER failure/degrade detected No bit error rate (BER) failures or degrades detected.
B2 BER_SF threshold power BER signal failure (SF) threshold configured with the b2 sf-ber
controller command.
B2 BER_SD threshold power BER signal degrade (SD) threshold configured with the b2 sd-ber
controller command.

Related Commands Command Description

aps protect (SONET) Enables SONET APS.
show version Displays information about the hardware and software on a router.

Cisco IOS Interface and Hardware Component Command Reference

IR-508
 Interface and Hardware Component Commands
show controllers t1

show controllers t1
To display information about the T1 links and to display the hardware and software driver information
for the T1 controller, use the show controllers t1 command in privileged EXEC mode.

Standard Syntax

show controllers t1 number [bert]

Cisco 7500 Series

show controllers t1 [slot/port] [bert]

Cisco AS5800 Access Servers

show controllers t1 dial-shelf/slot/t3-port:t1-num [bert]

Syntax Description number Network processor number (NPM)) number, in the range 0 through 2.
slot/port (Optional) Backplane slot number and port number on the interface. Refer to your
hardware installation manual for the specific slot and port numbers.
dial-shelf Dial shelf chassis in the Cisco AS5800 access server that contains the CT3 interface
card.
/slot Location of the CT3 interface card in the dial shelf chassis.
/t3-port T3 port number. The only valid value is 0.
:t1-num T1 time slot in the T3 line. The value can be from 1 to 28.
bert (Optional) Type bert to get a specific display for the bit-error rate testing (BERT)
results. Otherwise, the display will include all other non-BERT information.

Command Modes Privileged EXEC

Command History Release Modification

11.0 This command was introduced.
12.0(2)XD The keyword bert was added.
12.0(3)T This command was implemented on the Cisco AS5800 access server.

Usage Guidelines This command displays controller status that is specific to the controller hardware. The information
displayed is generally useful for diagnostic tasks performed by technical support personnel. Use the
show controllers t1 bert command to display the results of the BERT feature.
The NPM or MultiChannel Interface Processor (MIP) can query the port adapters to determine their
current status. Issue a show controllers t1 command to display statistics about the T1 link.
If you specify a slot and port number, each 15-minute period will be displayed.

Cisco IOS Interface and Hardware Component Command Reference

IR-509
 Interface and Hardware Component Commands
show controllers t1

Examples Cisco 7500 Series Routers

The following is sample output from the show controllers t1 command on the Cisco 7500 series routers:
Router# show controllers t1

T1 4/1 is up.
No alarms detected.
Framing is ESF, Line Code is AMI, Clock Source is line
Data in current interval (10 seconds elapsed):
0 Line Code Violations, 0 Path Code Violations 0 Slip Secs, 0 Fr Loss Secs,
0 Line Err Secs, 0 Degraded Mins 0 Errored Secs, 0 Bursty Err Secs,
0 Severely Err Secs, 0 Unavail Secs
Total Data (last 79 15 minute intervals):
0 Line Code Violations, 0 Path Code Violations, 0 Slip Secs, 0 Fr Loss Secs,
0 Line Err Secs, 0 Degraded Mins, 0 Errored Secs, 0 Bursty Err Secs,
0 Severely Err Secs, 0 Unavail Secs

Table 39 describes the fields shown in the display.

Table 39 show controllers t1 Field Descriptions—Cisco 7500 Series

Field Description
T1 4/1 is up The T1 controller 1 in slot 4 is operating. The controller’s state can be up,
down, or administratively down. Loopback conditions are shown by
(Locally Looped) or (Remotely Looped).
No alarms detected Any alarms detected by the controller are displayed here. Possible alarms
are as follows:
• Transmitter is sending remote alarm.
• Transmitter is sending AIS.
• Receiver has loss of signal.
• Receiver is getting AIS.
• Receiver has loss of frame.
• Receiver has remote alarm.
• Receiver has no alarms.
Data in current interval Shows the current accumulation period, which rolls into the 24-hour
(10 seconds elapsed) accumulation every 15 minutes. Accumulation period is from 1 to
900 seconds. The oldest 15-minute period falls off the back of the 24-hour
accumulation buffer.
Line Code Violations Indicates the occurrence of either a Bipolar Violation (BPV) or Excessive
Zeros (EXZ) error event.
Path Code Violations Indicates a frame synchronization bit error in the D4 and E1-no-CRC
formats, or a CRC error in the ESF and E1-CRC formats.
Slip Secs Indicates the replication or deletion of the payload bits of a DS1 frame. A
slip may be performed when there is a difference between the timing of a
synchronous receiving terminal and the received signal.
Fr Loss Secs Indicates the number of seconds an out-of-frame error is detected.
Line Err Secs Line Errored Seconds (LES) is a second in which one or more Line Code
Violation errors are detected.

Cisco IOS Interface and Hardware Component Command Reference

IR-510
Interface and Hardware Component Commands
show controllers t1

Table 39 show controllers t1 Field Descriptions—Cisco 7500 Series (continued)

Field Description
Degraded Mins Degraded Minute is one in which the estimated error rate exceeds 1E-6 but
does not exceed 1E-3.
Errored Secs In ESF and E1-CRC links, an Errored Second is a second in which one of
the following are detected: one or more Path Code Violations; one or more
out-of-frame defects; one or more Controlled Slip events; a detected AIS
defect.
For D4 and E1-no-CRC links, the presence of Bipolar Violations also
triggers an Errored Second.
Bursty Err Secs Second with fewer than 320 and more than 1 Path Coding Violation error,
no Severely Errored Frame defects and no detected incoming AIS defects.
Controlled slips are not included in this parameter.
Severely Err Secs For ESF signals, a second with one of the following errors: 320 or more
Path Code Violation errors; one or more out-of-frame defects; a detected
AIS defect.
For E1-CRC signals, a second with one of the following errors: 832 or
more Path Code Violation errors; one or more out-of-frame defects.
For E1-no-CRC signals, a second with 2048 Line Code Violations or more.
For D4 signals, a count of 1-second intervals with Framing Errors, or an
Out-of-Frame defect, or 1544 Line Code Violations.
Unavail Secs Count of the total number of seconds on the interface.

Cisco AS5800 Access Server

The following example shows the status of the T1 controllers connected to the Cisco AS5800 access
servers:
Router# show controllers t1 1/0/0:1

T1 1/0/0:1 is up.
No alarms detected.
Framing is ESF, Line Code is AMI, Clock Source is Line.
Data in current interval (770 seconds elapsed):
5 Line Code Violations, 8 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 7 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 7 Unavail Secs
Total Data (last 81 15 minute intervals):
7 Line Code Violations, 4 Path Code Violations,
6 Slip Secs, 20 Fr Loss Secs, 2 Line Err Secs, 0 Degraded Mins,
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 2 Unavail Secs
T1 1/0/1:5 is down.
Transmitter is sending remote alarm.
Receiver has loss of frame.
Framing is SF, Line Code is AMI, Clock Source is Line.
Data in current interval (770 seconds elapsed):
50 Line Code Violations, 5 Path Code Violations
0 Slip Secs, 7 Fr Loss Secs, 7 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 7 Unavail Secs
Total Data (last 81 15 minute intervals):
27 Line Code Violations, 22 Path Code Violations,
0 Slip Secs, 13 Fr Loss Secs, 13 Line Err Secs, 0 Degraded Mins,
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 13 Unavail Secs

Cisco IOS Interface and Hardware Component Command Reference

IR-511
 Interface and Hardware Component Commands
show controllers t1

Table 40 describes the fields shown in the display.

Table 40 show controllers t1 Field Descriptions—Cisco AS5800 Access Server

Field Description
T1 ... is up Status of T1 line.
No alarms detected Access server received no alarms.
Framing is ... Standard T1 framing type. In this example, the framing is Extended
Super Frame (ESF).
Line Code is ... Standard T1 line-coding format. In this example, the line-coding
format is Alternate Mark Inversion (AMI).
Clock Source is ... Source of the synchronization signal (clock). In this example, the
line is providing the clock signal.
Data in current interval ... Summary statistics for T1 signal quality for the current time
interval of 900 seconds. In this example, the statistics are for
current partial interval (770 seconds of 900 seconds).
Line Code Violations Number of T1 line code violations for the current interval.
Path Code Violations Number of T1 path code violations for the current interval.
Slip Secs Number of seconds in this interval during which a frame
misalignment occurred.
Fr Loss Secs Number of seconds in this interval during which frame loss
occurred.
Line Err Secs Number of seconds in this interval during which line errors
occurred.
Degraded Mins Number of minutes in this interval during which the signal quality
was degraded.
Errored Secs Number of seconds in this interval during which an error was
reported.
Bursty Err Secs Number of bursty error seconds in this interval.
Severely Err Secs Number of severely errored seconds in this interval.
Unavail Secs Number of unavailable seconds in this interval.
Total Data (last ... 15 minute Summary statistics for T1 signal quality for 15-minute intervals.
intervals) Every 24 hours (96 intervals) the counters in this data block clear.

Using the bert Keyword

The following is sample output from the show controllers t1 bert command displaying the BERT status
for all ports:
Router# show controllers t1 bert

Controller T1 0 Profile default : The Test was aborted by User

Controller T1 0 Profile 2 : Test Never Ran
Controller T1 1 Profile 3 : Test Never Ran
Controller T1 1 Profile 3 : Test Failed with a BER of 10^-2
Controller T1 2 Profile 3 : Current running, BER 0
Controller T1 2 Profile 2 : Passed with a BER of 0
Controller T1 3 Profile default : Test Never Ran
Controller T1 3 Profile 2 : Test Never Ran

Cisco IOS Interface and Hardware Component Command Reference

IR-512
Interface and Hardware Component Commands
show controllers t1

Controller T1 4 Profile default : Test Never Ran

Controller T1 4 Profile 2 : Test Never Ran
Controller T1 5 Profile default : Test Never Ran
Controller T1 5 Profile 2 : Test Never Ran
Controller T1 6 Profile default : Test Never Ran
Controller T1 6 Profile 2 : Test Never Ran
Controller T1 7 Profile default : Test Never Ran
Controller T1 7 Profile 2 : Test Never Ran

The following is sample output from the show controllers t1 bert command with only one T1 port, port
0.
Router# show controllers t1 0 bert

Controller T1 0 Profile default : The Test was aborted by User

Controller T1 0 Profile 2 : Test Never Ran

Cisco IOS Interface and Hardware Component Command Reference

IR-513
 Interface and Hardware Component Commands
show controllers t3

show controllers t3
To display information about the T3 links and to display the hardware and software driver information
for the T3 controller, use the show controllers t3 command in privileged EXEC mode.

Cisco 2650XM, Cisco 2651XM, Cisco 2691, Cisco 3660 Series, Cisco 3725, and Cisco 3745 Routers

show controllers t3 slot/port [brief | tabular]

Cisco 7200 Series Routers

show controllers t3 [bay/port[/t1-channel]] [brief | errors | tabular | remote performance [brief

| tabular]]

Cisco 7500 Series Routers

show controllers t3 [slot/bay/port[/t1-channel]] [brief | errors | tabular | remote performance

[brief | tabular]]

Cisco AS5800 Access Servers

show controllers t3 dial-shelf/slot/t3-port

Syntax Description slot Slot number. Refer to the appropriate hardware manual for slot information.
/port Port number. Refer to the appropriate hardware manual for port information.
port-adapter (Optional) Port adapter number. Refer to the appropriate hardware manual for
information about port adapter compatibility.
/bay (Optional) The port-adaptor-bay number. Refer to the appropriate hardware
manual for bay information
/t1-channel (Optional) Number between 1 and 28 that represents the T1 channel for the
Channelized T3 Interface Processor (CT3IP) on Cisco 7200 series and
Cisco 5200 series routers.
dial-shelf Dial shelf chassis in the Cisco AS5800 access server that contains the CT3
interface card.
/slot Location of the CT3 interface card in the dial shelf chassis.
/t3-port T3 port number. The only valid value is 0.
brief (Optional) Displays a subset of information.
errors (Optional) Displays a history of alarm events that causes a T3 controller or a
T1 controller of a T3 to transition from an Up state to a Down state. The
history size is 18 events.
tabular (Optional) Displays information in a tabular format.
remote performance (Optional) Displays the far-end ANSI performance monitor information when
enabled on the T1 channel with the t1 fdl ansi controller configuration
command.

Command Modes Privileged EXEC

Cisco IOS Interface and Hardware Component Command Reference

IR-514
 Interface and Hardware Component Commands
show controllers t3

Command History Release Modification

11.3 This command was introduced.
12.0(3)T This command was implemented on the Cisco AS5800 access server.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and
implemented on the following platforms: Cisco 2650XM, Cisco 2651XM,
Cisco 2691, Cisco 3660 series, Cisco 3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
12.2(19c) This command was modified to display error throttling and alarm conditions
that cause the T3 controller to enter a failure state.

Usage Guidelines Cisco 7500 Series Routers

This command displays controller status that is specific to the controller hardware. The information
displayed is generally useful for diagnostic tasks performed by technical support personnel only.
By using the errors keyword, this command displays history that identifies which alarm events caused
a T3 or T1 controller of a T3 to go down for the Cisco 7500 and Cisco 7200 series routers.

Note T1 channels on the CT3IP are numbered 1 to 28 rather than the more traditional zero-based
numbering scheme (0 to 27) used with other Cisco products. This is to ensure consistency with
telco numbering schemes for T1 channels within channelized T3 equipment.

The show controllers t3 command also displays Maintenance Data Link (MDL) information (received
strings) if MDL is configured and framing is set to C-bit.

Examples Cisco 7200 Series Routers

The following is partial output from the show controllers t3 errors command for Cisco IOS
Release 12.2(19c) for a specific T1 controller of a T3 on a Cisco 7200 series router with a bay/port of
4/1, displaying the T1 1 alarm event of OOF:
Router# show controllers t3 4/1/1 errors

T3 4/1: Error Log Information

present alarm: NONE
Error: AIS
17:28:08-17:29:18
T1 1 Error Log Information
present alarm: OOF
Since 17:30:55
Error: OOF
17:30:09-17:30:46

The following is partial output from the show controllers t3 errors command from Cisco IOS
Release 12.2(19c) for a T3 controller on a Cisco 7200 series router with a bay/port of 4/1, displaying a
history of all alarm events on all 28 T1 channels:
Router# show controllers t3 4/1 errors

T3 4/1: Error Log Information

present alarm: NONE
Error: AIS
17:28:08-17:29:18

Cisco IOS Interface and Hardware Component Command Reference

IR-515
 Interface and Hardware Component Commands
show controllers t3

T1 1 Error Log Information

present alarm: OOF
Since 17:30:55
Error: OOF
17:30:09-17:30:46
T1 2 Error Log Information
present alarm: NONE
T1 3 Error Log Information
present alarm: NONE
T1 4 Error Log Information
present alarm: NONE
T1 5 Error Log Information
present alarm: NONE
T1 6 Error Log Information
present alarm: NONE
T1 7 Error Log Information
present alarm: NONE
T1 8 Error Log Information
present alarm: NONE
T1 9 Error Log Information
present alarm: NONE
T1 10 Error Log Information
present alarm: NONE
T1 11 Error Log Information
present alarm: NONE
T1 12 Error Log Information
present alarm: NONE
T1 13 Error Log Information
present alarm: NONE
T1 14 Error Log Information
present alarm: NONE
T1 15 Error Log Information
present alarm: NONE
T1 16 Error Log Information
present alarm: NONE
T1 17 Error Log Information
present alarm: NONE
T1 18 Error Log Information
present alarm: NONE
T1 19 Error Log Information
present alarm: NONE
T1 20 Error Log Information
present alarm: NONE
T1 21 Error Log Information
present alarm: NONE
T1 22 Error Log Information
present alarm: NONE
T1 23 Error Log Information
present alarm: NONE
T1 24 Error Log Information
present alarm: NONE
T1 25 Error Log Information
present alarm: NONE
T1 26 Error Log Information
present alarm: NONE
T1 27 Error Log Information
present alarm: NONE
T1 28 Error Log Information
present alarm: NONE

Cisco IOS Interface and Hardware Component Command Reference

IR-516
Interface and Hardware Component Commands
show controllers t3

Cisco 7500 Series Routers

The following is partial output from the show controllers t3 errors command from Cisco IOS
Release 12.2(19c) for a T3 controller with a slot/bay/port of 1/4/1, displaying a history of all alarm
events on all 28 T1 channels:
Router# show controllers t3 1/4/1 errors

T3 1/4/1: Error Log Information

present alarm: NONE
Error: AIS
17:28:08-17:29:18
T1 1 Error Log Information
present alarm: OOF
Since 17:30:55
Error: OOF
17:30:09-17:30:46
T1 2 Error Log Information
present alarm: NONE
T1 3 Error Log Information
present alarm: NONE
T1 4 Error Log Information
present alarm: NONE
T1 5 Error Log Information
present alarm: NONE
T1 6 Error Log Information
present alarm: NONE
T1 7 Error Log Information
present alarm: NONE
T1 8 Error Log Information
present alarm: NONE
T1 9 Error Log Information
present alarm: NONE
T1 10 Error Log Information
present alarm: NONE
T1 11 Error Log Information
present alarm: NONE
T1 12 Error Log Information
present alarm: NONE
T1 13 Error Log Information
present alarm: NONE
T1 14 Error Log Information
present alarm: NONE
T1 15 Error Log Information
present alarm: NONE
T1 16 Error Log Information
present alarm: NONE
T1 17 Error Log Information
present alarm: NONE
T1 18 Error Log Information
present alarm: NONE
T1 19 Error Log Information
present alarm: NONE
T1 20 Error Log Information
present alarm: NONE
T1 21 Error Log Information
present alarm: NONE
T1 22 Error Log Information
present alarm: NONE
T1 23 Error Log Information
present alarm: NONE
T1 24 Error Log Information
present alarm: NONE
T1 25 Error Log Information

Cisco IOS Interface and Hardware Component Command Reference

IR-517
 Interface and Hardware Component Commands
show controllers t3

present alarm: NONE

T1 26 Error Log Information
present alarm: NONE
T1 27 Error Log Information
present alarm: NONE
T1 28 Error Log Information
present alarm: NONE
.
.
.

The following is partial output from the show controllers t3 errors command from Cisco IOS
Release 12.2(19c) for a specific T1 controller of a T3 on a Cisco 7200 series router with a bay/port of
4/1, displaying the T1 1 alarm event of OOF:
Router# show controllers t3 4/1/1 errors
T3 4/1: Error Log Information
present alarm: NONE
Error: AIS
17:28:08-17:29:18
T1 1 Error Log Information
present alarm: OOF
Since 17:30:55
Error: OOF
17:30:09-17:30:46
.
.
.

The following is partial output from the show controllers t3 command from Cisco IOS
Release 12.2(19c):
Router# show controllers t3 2/1/0
T3 2/1/0 is down. Hardware is 2CT3 single wide port adapter
CT3 H/W Version:0.2.2, CT3 ROM Version:1.0, CT3 F/W Version:2.5.1
FREEDM version:1, reset 0 resurrect 0
Applique type is Channelized T3
Transmitter is sending remote alarm.
Receiver has loss of signal.
FEAC code received:No code is being received
Framing is M23, Line Code is B3ZS, Clock Source is Internal
Rx-error throttling on T1's ENABLED
Rx throttle total 0, equipment customer loopback
Data in current interval (545 seconds elapsed):
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
545 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
Data in Interval 1:
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
900 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
Data in Interval 2:
<snip>

The following is partial output from the show controllers t3 command from
Cisco IOS Release 12.2(19c) for the T1 channel of the T3 controller:
Router# show controllers t3 2/1/0 /1
T3 2/1/0 is down. Hardware is 2CT3 single wide port adapter

Cisco IOS Interface and Hardware Component Command Reference

IR-518
Interface and Hardware Component Commands
show controllers t3

CT3 H/W Version:0.2.2, CT3 ROM Version:1.0, CT3 F/W Version:2.5.1

FREEDM version:1, reset 0 resurrect 0

T1 1 is down
timeslots:1-24
FDL per AT&T 54016 spec.
Receiver has loss of signal.
Framing is ESF, Clock Source is Internal
Data in current interval (0 seconds elapsed):
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavail Secs, 0 Stuffed Secs

The following is partial output from the show controllers t3 command:

Router# show controllers t3 3/0/0

T3 3/0/0 is up.
CT3 H/W Version: 4, CT3 ROM Version: 0.116, CT3 F/W Version: 0.10.0
Mx H/W version: 2, Mx ucode ver: 1.24
Applique type is Channelized T3
No alarms detected.
FEAC code received: No code is being received
Framing is M23, Line Code is B3ZS, Clock Source is Internal.
Ext1: LOS, Ext2: LOS, Ext3: LOS, Test: OK
Data in current interval (39 seconds elapsed):
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation
0 P-bit Err Secs, 0 P-bit Severely Err Secs
0 Severely Err Framing Secs, 0 Unavailable Secs
0 Line Errored Secs, 0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
Total Data (last 1 15 minute intervals):
0 Line Code Violations, 0 P-bit Coding Violation,
0 C-bit Coding Violation,
0 P-bit Err Secs, 0 P-bit Severely Err Secs,
0 Severely Err Framing Secs, 0 Unavailable Secs,
0 Line Errored Secs, 0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
.
.
.
T1 1 is down, speed: 1536 kbs, non-inverted data
timeslots: 1-24
FDL per ANSI T1.403 and AT&T 54016 spec.
Configured for FDL Remotely Line Looped
No alarms detected.
Framing is ESF, LineCode is B8ZS, Clock Source is Internal.
BERT test result (running)
Test Pattern: All 0’s, Status: Sync, Sync Detected: 1
Interval: 4 minute(s), Tim Remain: 4 minute(s)
Bit Errors (Sync BERT Started): 0 bits
Bit Errors (Sync last Sync): 0 bits, Bits Received: 7 Mbits

The following is partial output from the show controllers t3 brief command:
Router# show controllers t3 3/0/0 brief

T3 3/0/0 is up.
CT3 H/W Version: 4, CT3 ROM Version: 0.116, CT3 F/W Version: 0.10.0
Mxt H/W version: 2, Mxt ucode ver: 1.24
Applique type is Channelized T3
No alarms detected.
FEAC code received: No code is being received
Framing is M23, Line Code is B3ZS, Clock Source is Internal.

Cisco IOS Interface and Hardware Component Command Reference

IR-519
 Interface and Hardware Component Commands
show controllers t3

Ext1: LOS, Ext2: LOS, Ext3: LOS, Test: OK

T1 1 is up, speed: 1536 kbs, non-inverted data

timeslots: 1-24
FDL per ANSI T1.403 and AT&T 54016 spec.
Configured for FDL Remotely Line Looped
No alarms detected.
Framing is ESF, LineCode is B8ZS, Clock Source is Internal.
BERT test result (done)
Test Pattern: All 0’s, Status: Not Sync, Sync Detected: 1
Interval: 4 minute(s), Tim Remain: 0 minute(s)
Bit Errors(Sync BERT Started): 0 bits
Bit Errors(Sync last Sync): 0 bits, Bits Received: 368 Mbits
.
.
.

The following is partial output from the show controllers t3 tabular command:
Router# show controllers t3 3/0/0 tabular

T3 3/0/0 is up.
CT3 H/W Version: 4, CT3 ROM Version: 1.2, CT3 F/W Version: 2.1.0
Mx H/W version: 2, Mx ucode ver: 1.25
Applique type is Channelized T3
No alarms detected.
MDL transmission is disabled

FEAC code received: No code is being received

Framing is C-BIT Parity, Line Code is B3ZS, Clock Source is Internal.
Ext1: AIS, Ext2: LOS, Ext3: LOS, Test: LOS
INTERVAL LCV PCV CCV PES PSES SEFS UAS LES CES CSES
08:56-09:11 0 0 0 0 0 0 0 0 0 0
08:41-08:56 0 0 0 0 0 0 0 0 0 0
08:26-08:41 0 0 0 0 0 0 0 0 0 0
Total 0 0 0 0 0 0 0 0 0 0
.
.
.

T1 2 is up, speed: 1536 kbs, non-inverted data

timeslots: 1-24
FDL per AT&T 54016 spec.
No alarms detected.
Framing is ESF, Line Code is B8ZS, Clock Source is Internal.
INTERVAL LCV PCV CSS SELS LES DM ES BES SES UAS SS
08:56-09:11 0 0 0 0 0 0 0 0 0 0 0
08:41-08:56 0 0 0 0 0 0 0 0 0 0 0
08:26-08:41 0 0 0 0 0 0 0 0 0 0 0
Total 0 0 0 0 0 0 0 0 0 0 0

The following output shows a controller with a high number of errors on the line, thus showing a throttle
count (RX throttles).
Router# show controllers t3 6/0/0 tabular

T1 2 is up
timeslots: 1-24
FDL per AT&T 54016 spec.
No alarms detected.
Framing is ESF, Clock Source is Line, Rx throttles 47
INTERVAL LCV PCV CSS SELS LES DM ES BES SES UAS SS
07:48-07:53 0 0 0 0 0 0 0 0 0 0

Cisco IOS Interface and Hardware Component Command Reference

IR-520
Interface and Hardware Component Commands
show controllers t3

The following is partial output from the show controllers t3 remote performance command. This
information is available if the t1 fdl ansi controller configuration command is enabled for a T1 channel
on a CT3IP.
Router# show controllers t3 3/0/0 remote performance

T3 3/0/0 is up.
CT3 H/W Version: 4, CT3 ROM Version: 0.116, CT3 F/W Version: 20.2.0
Mx H/W version: 2, Mx ucode ver: 1.25

T1 1 - Remote Performance Data

Data in current interval (356 seconds elapsed):
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavail Secs
Data in Interval 1:
1 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
2 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavail Secs
Data in Interval 2:
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavail Secs
Total Data (last 2 15 minute intervals):
1 Path Code Violations
1 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins,
2 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavail Secs
.
.
.

Table 41 describes the fields shown in the display.

Table 41 show controllers t3 Field Descriptions—Cisco 7500 Series

Field Description
T3 3/0/0 is up T3 controller in slot 3 is operating. The controller’s state can be up, down,
or administratively down. Loopback conditions are shown by (Locally
Looped) or (Remotely Looped).
CT3 H/W Version Version number of the hardware.
CT3 ROM Version Version number of the ROM.
CT3 F/W Version Version number of the firmware.
Mx H/W version Hardware version number of the HDLC controller chip.
Mx ucode ver Microcode version of the HDLC controller chip.
Applique type Controller type.

Cisco IOS Interface and Hardware Component Command Reference

IR-521
 Interface and Hardware Component Commands
show controllers t3

Table 41 show controllers t3 Field Descriptions—Cisco 7500 Series (continued)

Field Description
No alarms detected Any alarms detected by the controller are displayed here. Possible alarms
are as follows:
• Transmitter is sending remote alarm.
• Transmitter is sending AIS.
• Receiver has loss of signal.
• Receiver is getting AIS.
• Receiver has loss of frame.
• Receiver has remote alarm.
• Receiver has no alarms.
MDL transmission Status of the Maintenance Data Link (either enabled or disabled).
FEAC code received Whether or not a far-end alarm code request is being received. Possible
values are as follows:
• DS3 Eqpt. Failure (SA)
• DS3 LOS/HBER
• DS3 Out-of-Frame
• DS3 AIS Received
• DS3 IDLE Received
• DS3 Eqpt. Failure (NSA)
• Common Eqpt. Failure (NSA)
• Multiple DS1 LOS/HBER
• DS1 Eqpt. Failure
• Single DS1 LOS/HBER
• DS1 Eqpt. Failure (NSA)
• No code is being received
Framing Framing type on the CT3IP. Values are M23, C-Bit, and Auto-detect.
Line Code Line coding format on the CT3IP.
Clock Source Clock source on the CT3IP. Values are internal or line.
RX-error throttling Indicates that error throttling is enabled. The error throttling command
disables the T1 level clock in order to stop receiving error data packets
on a T1 controller. If any single interface receives a burst of errors over a
short duration, such as 400 errors in 100 milliseconds, the T1 clock will
be turned off for a period of 100 milliseconds.
RX throttles The presence of the throttle count indicates that there are many input
errors on lines. On the CT3 PA, the T1 is throttled when there are a
number of input errors on an interface (400 errors in 100 milliseconds).
The T1 is throttled even if one of the interfaces on it sees continuous
errors. The 1-second periodic process checks for throttled interfaces and
unthrottles them back.

Cisco IOS Interface and Hardware Component Command Reference

IR-522
Interface and Hardware Component Commands
show controllers t3

Table 41 show controllers t3 Field Descriptions—Cisco 7500 Series (continued)

Field Description
BERT test result BERT test information is available if the t1 bert controller configuration
command is enabled for the T1 channel on the CT3IP. The BERT results
include the following information:
• Test Pattern—Type of test pattern selected.
• Status—Status of the test.
• Sync Detected—Number of times the pattern synch is detected (that
is, the number of times the pattern goes from No Sync to Sync).
• Interval—Duration selected.
• Tim Remain—Time remaining on the BERT test.
• Bit Errors (Sync BERT Started)—Number of bit errors during the
BERT test.
• Bit Errors (Sync last Sync)—Number of bit errors since the last
pattern sync was detected.
• Bits Received—Total bits received.
When the T1 channel has a BERT test running, the line state is DOWN.
Also, when the BERT test is running and the Status field is Not Sync, the
information in the total bit errors field is not valid. When the BERT test
is done, the Status field is not relevant.
Data in current interval Shows the current accumulation period, which rolls into the 24-hour
(39 seconds elapsed) accumulation every 15 minutes. Accumulation period is from 1 to
900 seconds. The oldest 15-minute period falls off the back of the
24-hour accumulation buffer.
Line Code Violations Line Code Violations (LCVs) is a count of both Bipolar Violations
(BPVs) and Excessive Zeros (EXZs) that occur over the accumulation
period. An EXZ increments the LCV by one regardless of the length of
the zero string.
P-bit Coding Violation For all DS3 applications, a P-bit coding violation (PCV) error event is a
P-bit parity error event. A P-bit parity error event is the occurrence of a
received P-bit code on the DS3 M-frame that is not identical to the
corresponding locally calculated code.
C-bit Coding Violation For C-bit parity and SYNTRAN DS3 applications, the C-bit coding
violation (CCV) is the count of coding violations reported via the C-bits.
For C-bit parity, it is the count of CP-bit parity errors that occur during
the accumulation interval. For SYNTRAN, it is a count of CRC-9 errors
that occur during the accumulation interval.
P-bit Err Secs P-bit errored seconds (PES) is a second with one or more PCVs, one or
more out-of-frame defects, or a detected incoming AIS. This gauge is not
incremented when unavailable seconds are counted.
P-bit Severely Err Secs P-bit severely errored seconds (PSES) is a second with 44 or more PCVs,
one or more out-of-frame defects, or a detected incoming AIS. This
gauge is not incremented when unavailable seconds are counted.
Severely Err Framing Secs Severely errored framing seconds (SEFS) is a second with one or more
out-of-frame defects or a detected incoming AIS.

Cisco IOS Interface and Hardware Component Command Reference

IR-523
 Interface and Hardware Component Commands
show controllers t3

Table 41 show controllers t3 Field Descriptions—Cisco 7500 Series (continued)

Field Description
Unavailable Secs The number of unavailable seconds (UAS) is calculated by counting the
number of seconds for which the interface is unavailable. For more
information, refer to RFC 1407, DS3 MIB Variables.
Line Errored Secs Line errored seconds (LES) is a second in which one or more code
violations or one or more LOS defects occurred.
C-bit Errored Secs C-bit errored seconds (CES) is a second with one or more C-bit code
violations (CCV), one or more out-of-frame defects, or a detected
incoming AIS. This gauge is not incremented when UASs are counted.
C-bit Severely Errored C-bit severely errored seconds (CSES) is a second with 44 or more CCVs,
Secs one or more out-of-frame defects, or a detected incoming AIS. This
gauge is not incremented when UASs are counted.
Total Data (last 1 Shows the last 15-minute accumulation period.
15 minute intervals)
T1 1 is up T1 channel is operating. The channel’s state can be up, down, or
administratively down. Loopback conditions are shown by (Locally
Looped) or (Remotely Looped).
speed Speed of the T1 channel, in kbps.
non-inverted data Indicates if the T1 channel is configured for inverted data.
timeslots Time slots assigned to the T1 channel.
FDL per ANSI T1.403 and Performance monitoring is via Facility Data Link per ANSI T1.403 and
AT&T 54016 spec. AT&T standard specification number 54016.
No alarms detected Any alarms detected by the T1 controller are displayed here. Possible
alarms are as follows:
• Transmitter is sending remote alarm.
• Transmitter is sending AIS.
• Receiver has loss of signal.
• Receiver is getting AIS.
• Receiver has loss of frame.
• Receiver has remote alarm.
• Receiver has no alarms.
Framing Type of framing used on the T1 channel. Values are ESF or SF.
Line Code Type of line coding used on the T1 channel. Values are B8ZS or AMI.
Clock Source Clock source on the T1 channel. Values are internal or line.
Path Code Violations Path coding violation (PCV) error event is a frame synchronization bit
error in the D4 and E1-no-CRC formats or a CRC error in the ESF and
E1-CRC formats.
Slip Secs Controlled slip second (CSS) is a 1-second interval that contains one or
more controlled slips.
Fr Loss Secs Frame loss seconds (SELS) is the number of seconds for which an
out-of-frame error is detected.

Cisco IOS Interface and Hardware Component Command Reference

IR-524
Interface and Hardware Component Commands
show controllers t3

Table 41 show controllers t3 Field Descriptions—Cisco 7500 Series (continued)

Field Description
Line Err Secs Line errored seconds (LES) is a second in which one or more line code
violation errors are detected.
Degraded Mins Degraded minute (DM) is a minute in which the estimated error rate
exceeds 1E-6 but does not exceed 1E-3. For more information, refer to
RFC 1406, Definitions of Managed Objects for DS1 and E1 Interface
Types.
Errored Secs Errored seconds (ES) is a second with one or more path coding violations,
one or more out-of-frame defects, or one or more controlled slip events
or a detected AIS defect.
Bursty Err Secs Bursty errored seconds (BES) is a second with fewer than 320 and more
than one path coding violation error events, no severely errored frame
defects, and no detected incoming AIS defects. Controlled slips are not
included in this parameter.
Severely Err Secs Severely errored seconds (SES) is a second with 320 or more path code
violation errors events, one or more out-of-frame defects, or a detected
AIS defect.
Unavailable Secs Number of seconds during which the interface was not available in this
interval. Referred to as UAS.
Stuffed Secs Stuffed seconds (SS) is a second in which one more bit stuffings take
place. This happens when the Pulse Density Enforcer detects a potential
violation in the output stream and inserts a 1 to prevent it. Such bit
stuffings corrupt user data and indicate that the network is configured
incorrectly. This counter can be used to help diagnose this situation.

Cisco AS5800 Access Servers

The following example shows the summary status of the T3 controller located in shelf 1, slot 4, port 0:
Router# show controllers t3 1/4/0 brief

T3 1/4/0 is up.
Applique type is Channelized T3
No alarms detected.
MDL transmission is disabled

FEAC code received: Multiple DS1 LOS/HBER

Framing is C-BIT Parity, Line Code is B3ZS, Clock Source is Line.
Data in current interval (491 seconds elapsed):
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
0 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
Total Data (last 80 15 minute intervals):
3 Line Code Violations, 4 P-bit Coding Violation,
2 C-bit Coding Violation, 0 P-bit Err Secs,
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs,
2 Unavailable Secs, 0 Line Errored Secs,
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs

Cisco IOS Interface and Hardware Component Command Reference

IR-525
 Interface and Hardware Component Commands
show controllers t3

The following example shows the detailed status of the T3 controller connected to the Cisco AS5800 in
shelf 1, slot 4, port 0. Notice that the detailed information shows the last eighty-six 15-minute time
periods.
Router# show controllers t3 1/4/0

T3 1/4/0 is up.
Applique type is Channelized T3
No alarms detected.
MDL transmission is disabled

FEAC code received: Multiple DS1 LOS/HBER

Framing is C-BIT Parity, Line Code is B3ZS, Clock Source is Line.
Data in current interval (91 seconds elapsed):
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
0 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
Data in Interval 1:
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
0 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
Data in Interval 2:
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
0 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
Data in Interval 3:
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
0 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
Data in Interval 4:
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
0 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
.
.
.

Data in Interval 86:

3 Line Code Violations, 4 P-bit Coding Violation
2 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
2 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
Total Data (last 86 15 minute intervals):
3 Line Code Violations, 4 P-bit Coding Violation,
2 C-bit Coding Violation, 0 P-bit Err Secs,
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs,
2 Unavailable Secs, 0 Line Errored Secs,
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs

Cisco IOS Interface and Hardware Component Command Reference

IR-526
Interface and Hardware Component Commands
show controllers t3

Table 42 describes the fields shown in the display.

Table 42 show controllers t3 Field Descriptions—Cisco AS5800

Field Description
T3 1/4/0 is up T3 controller connected to this Cisco AS5800 access server in
shelf 1, slot 4, port 0 is up. The controller’s state can be up, down,
or administratively down. Loopback conditions are shown by
Locally Looped or Remotely Looped.
Applique type Describes the type of controller.
No alarms detected Any alarms detected by the controller are displayed here. Possible
alarms are as follows:
• Transmitter is sending remote alarm.
• Transmitter is sending alarm indication signal (AIS).
• Receiver has loss of signal (LOS).
• Receiver is getting AIS.
• Receiver has loss of frame (LOF).
• Receiver has remote alarm.
• Receiver has no alarms.
MDL transmission Maintenance Data Link status (either enabled or disabled). Used
for carrying performance information and control signals across
the network toward the far-end T3 unit. It is the counterpart of
Facility Data Link (FDL) in a T1 link.
FEAC code received Whether or not a far-end alarm code request is being received.
Possible values are as follows:
• DS3 Eqpt. Failure (SA)
• DS3 LOS/HBER
• DS3 Out-of-Frame
• DS3 AIS Received
• DS3 IDLE Received
• DS3 Eqpt. Failure (NSA)
• Common Eqpt. Failure (NSA)
• Multiple DS1 LOS/HBER
• DS1 Eqpt. Failure
• Single DS1 LOS/HBER
• DS1 Eqpt. Failure (NSA)
• No code is being received
Framing Standard T3 framing type: M23, C-Bit, or Auto-detect.
Line Code Standard T3 line-coding format. In this example, the line-coding
format is bipolar 3-zero substitution (B3ZS).
Clock Source The source of the synchronization signal (clock): line or internal.
In this example, the line is providing the clock signal.

Cisco IOS Interface and Hardware Component Command Reference

IR-527
 Interface and Hardware Component Commands
show controllers t3

Table 42 show controllers t3 Field Descriptions—Cisco AS5800 (continued)

Field Description
Data in current interval Summary statistics for T3 signal quality for the current time
(... seconds elapsed) interval of 900 seconds (15 minutes). In this example, the statistics
are for current partial interval. Statistics roll into the 24-hour
accumulation buffer every 15 minutes. The oldest 15-minute
period falls off the back of the 24-hour accumulation buffer.
Line Code Violations Count of both Bipolar Violations (BPVs) and Excessive Zeros
(EXZs) that occur over the accumulation period. An EXZ
increments the Line Code Violations (LCVs) by one regardless of
the length of the zero string.
P-bit Coding Violation P-bit parity error event. A P-bit parity error event is the occurrence
of a received P-bit code on the DS3 M-frame that is not identical to
the corresponding locally calculated code. Referred to as PCV.
C-bit Coding Violation Count of coding violations reported via the C-bits. For C-bit parity,
it is the count of CP-bit parity errors that occur during the
accumulation interval. Referred to as CCV.
P-bit Err Secs Number of seconds with one or more PCVs, one or more
out-of-frame defects, or a detected incoming AIS. This gauge is not
incremented when unavailable seconds are counted.
P-bit Severely Err Secs Number of seconds with 44 or more PCVs, one or more
out-of-frame defects, or a detected incoming AIS. This gauge is not
incremented when unavailable seconds are counted.
Severely Err Framing Secs Number of a seconds with one or more out-of-frame defects or a
detected incoming AIS.
Unavailable Secs Number of seconds during which the interface was not available in
this interval. Referred to as UAS.
Line Errored Secs Number of seconds in this interval during which one or more code
violations or one or more LOS defects occurred. Referred to as
LES.
C-bit Errored Secs Number of seconds with one or more C-bit code violations (CCV),
one or more out-of-frame defects, or a detected incoming AIS. This
gauge is not incremented when UASs are counted. Referred to as
CES.
C-bit Severely Errored Secs Number of seconds with 44 or more CCVs, one or more
out-of-frame defects, or a detected incoming AIS. This gauge is not
incremented when UASs are counted.
Total Data (last ... 15 minute Summary statistics for T3 signal quality for 15-minute intervals.
intervals) Every 24 hours (96 intervals) the counters in this data block clear.

Cisco IOS Interface and Hardware Component Command Reference

IR-528
 Interface and Hardware Component Commands
show controllers token

show controllers token

To display information about memory management and error counters on the Token Ring Interface
Processor (TRIP) for the Cisco 7500 series routers, use the show controllers token command in
privileged EXEC mode.

show controllers token

Syntax Description This command has no arguments or keywords.

Command Modes Privileged EXEC

Command History Release Modification

10.0 This command was introduced.
11.3(3)T The information was modified to include the PA-4R-FDX full-duplex Token
Ring port adapter.

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

Examples The following is sample output for the PA-4R-DTR from the show controllers token command. In this
example, the current operating mode is classic Token Ring station.
Router# show controllers token

Interface TokenRing4/0 state: up

Data from IDB:
Current MAC address: 0008.2a36.1a04, Burned in MAC address: 0008.2a36.1a04
Group address: 80000000
Functional address: 08000000, enables: CDP
Ring mode: 0000, enables:

Last Ring Status: none

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

Current operating mode:

Classic token ring station
MAC state: inserted
Duplex: half
Access protocol: TKP
Ring speed: 16 Mbps
Ring monitor role: Standby monitor

Internal controller data:

Cisco IOS Interface and Hardware Component Command Reference

IR-529
 Interface and Hardware Component Commands
show controllers token

MAC microcode version: 0.240

Hawkeye ASIC revision: 0
Node address: 0008.2a36.1a04
Functional address: 08000000, Group address: 80000000
Hawkeye ASIC registers:
last hisr: 0004h, himr: 00002ABFh, inpace: 0000h
utility: 6316h, txphthre: 1010h, rxtxdmathre: 2828h
dmactrl: 0000E004h, earlyrxthre: 0000h, llcstop: 0000h
reset: 0000h
txhidescstart: 4B0A45C0h, txlodescstart: 00000000h
rxdescstart: 4B0A4180h, srbctrl: 0038h, descipoll: 0100h
congestcnt: 0000h
Hawkeye transmit error counts:
Underrun: 0/0
Hawkeye receive error counts:
Out of descriptors: 0/0, Giants: 0/0
Corrupted frames: 0/0, CRC errors: 0/0
FIFO overflow: 0/0
Device driver ring buffer data:
Transmit ring:
Descriptors outstanding (curr/max): 0/256
Head pointer: 7 Tail pointer: 7
Receive ring:
Ring size: 64 descriptors
Head pointer: 7
Internal controller soft error counts:
Line errors: 0/0, Internal errors: 0/0
Burst errors: 0/0, ARI/FCI errors: 0/0
Abort errors: 0/0, Lost frame errors: 0/0
Copy errors: 0/0, Receiver congestion: 0/0
Token errors: 0/0, Frequency errors: 0/0
Internal controller SMT state:
Adapter MAC: 0008.2a36.1a04, Physical drop: 00000000
NAUN address: 0060.3ebb.0a21, NAUN drop: 00000000
Last beacon src: 0000.0000.0000, Last poll: 0060.3ebb.0a21
Last MVID: 0006, Last attn code: 0000
Txmit priority: 0007, Auth funct class: FFFF
Monitor error: 0000, Front end errors: 0000
Correlator: 0000, Soft error timer: 00C8
Local ring: 0000, Ring status: 0000
Beacon rcv type: 0000, Beacon txmit type: 0000
Last beacon type:0000, Bcn station NAUN: 0000.0000.0000
Beacon drop: 00000000, Phantom support: 0000
Access prot req: 0000, Access prot resp: 0000
Policy flags: 0110, Protocol event state:000D
Ctrl ring state: 0001, Protocol join state: 0000
Reserved: 0000, Protocol mon state: 0000

Table 43 describes the significant fields shown in the display.

Cisco IOS Interface and Hardware Component Command Reference

IR-530
 Interface and Hardware Component Commands
show controllers token

Table 43 show controllers token Field Descriptions

Field Description
Tokenring4/0 Interface processor type, slot, and port.
Last Ring Status Last abnormal ring condition. Can be any of the following:
• Signal Loss
• HW Removal
• Remote Removal
• Counter Overflow
• Only station
• Ring Recovery
Current operating mode Operating mode. Can be one of the following:
• Classic token ring station (standard half-duplex Token Ring
station)
• DTR station (full-duplex Token Ring station)
• DTR concentrator (concentrator port)
MAC state The MAC state indicates the state of the Token Ring MAC layer
protocol. Can be one of the following:
• Not inserted (not connected to any ring)
• Inserting (currently entering a ring)
• Inserted (connected to an active Token ring)

Related Commands Command Description

show interfaces tokenring Displays information about the Token Ring interface and the state of
source-route bridging.
show source-bridge Displays the current source bridge configuration and miscellaneous
statistics.

Cisco IOS Interface and Hardware Component Command Reference

IR-531
 Interface and Hardware Component Commands
show controllers vg-anylan

show controllers vg-anylan

To display the controller information for the 100VG-AnyLAN port adapter on Cisco 7200 series routers
and Cisco 7500 series routers, use the show controllers vg-anylan command in user EXEC or
privileged EXEC mode.

Cisco 7200 Series

show controllers vg-anylan slot/port

Cisco 7500 Series with VIP Cards

show controllers vg-anylan slot/port-adapter/port

Syntax Description slot Slot number. Refer to the appropriate hardware manual for slot and port
information.
/port Port number. Refer to the appropriate hardware manual for slot and port
information.
/port-adapter Port adapter number. Refer to the appropriate hardware manual for information
about port adapter compatibility.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

11.3 This command was introduced.

Usage Guidelines The information displayed is generally useful for diagnostic tasks performed by technical support
personnel only.

Examples The following is sample output from the show controllers vg-anylan command:
Router# show controllers vg-anylan 3/0

Interface VG-AnyLAN3/0
Hardware is MC68852
mc68852_ds=0x60A4C930, registers=0x3C300000, ib=0x4B056240
rx ring entries=31, tx ring entries=31
rxring=0x4B056340, rxr shadow=0x60A4CA08, rx_head=0, rx_tail=0
txring=0x4B057180, txr shadow=0x60A4D07C, tx_head=0, tx_tail=2,
tx_count=2,

MC68852 Registers:
hw_id: 5048, hw_id & page: 7053, opr1=0x26, opr2=0x2C, opr3=0x00
Page 0 - Performance:
isr=0x3400, imr=0x0A0A, flreg=0x0000
xfrct=0xC07E0080, rxcnt=0, txcnt=1F

Cisco IOS Interface and Hardware Component Command Reference

IR-532
Interface and Hardware Component Commands
show controllers vg-anylan

Page 1 - MAC Address/Hash Table:

addrlow= 6009B9, addrhigh=9B1809B9,hash bytes=06 00 20 00 00 00 00 00
Page 2 - Hardware Mapping:
mmmsw=0x3785, mmlsw=0x0000, bmreg =0x04
Page 4 - LAN Configuration:
tccnf1=0x00, tccnf2=0x01
vccnf=0x99, vtrrg=0x0020, valow1=0x0000, valow2=0x0000
maccr1=0xBE, maccr2=0x00, maccr3=0x04, maccr4=0x03
Page 5 - MMU Registers:
rx mem stop addr=0xFF03, tx mem stop addr=0xFF07
MC68852 PCI registers:
bus_no=6, device_no=0
CFID=0x0005101A, CFCS=0x02800005, CFRV=0x02000000, CFLT=0x0000F800
CBIO=0x00006001, CBMA=0x00000000, CFIT=0x20080100, CFDA=0x0000000C

Actel Hardware CAM Control Registers:

CAM DEVICE BASE: 0x3C300800 Register Address: 0x3C300C00
CSR: 0x8000 CAMCR: 0xFFFF
USAR: 0000 MSAR: 0000 LSAR: 0000
FIFOCR: 0x8000 WRMASK: 0x0080
COMPARAND REG: 0000.0000.0000
PERSISTENT SOURCE: 0x0 PERSISTENT DEST: 0xFD010000
ACTEL CAM PCI registers:
bus_no=6, device_no=1
CFID=0x555511AA, CFCS=0x04800003, CFRV=0xF0F0F001, CFLT=0x00000000
CBIO=0x00006800, CBMA=0x00000000, CFIT=0x00000000, CFDA=0x00000000
pak_to_host=0x0, filtered_pak=0
throttled=0, enabled=0, disabled=0
tx_carrier_loss=0
fatal_tx_err=0, mult_ovfl=0

Cisco IOS Interface and Hardware Component Command Reference

IR-533
 Interface and Hardware Component Commands
show diag

show diag
To display diagnostic information about the controller, interface processor, and port adapters for a
networking device, use the show diag command in privileged EXEC mode.

show diag [slot-number] [details | summary]

Syntax Description slot-number (Optional) Slot number of the interface. If a slot number is not specified,
diagnostic information for all slots is displayed.
details (Optional) Displays more details than the normal show diag output.
summary (Optional) Displays a summary (one line per slot) of the chassis.

Command Modes Privileged EXEC

Command History Release Modification

11.2 This command was introduced.
11.2 GS This command was implemented on the Cisco 12000 series.
12.0 This command was implemented on the Cisco AS5300.
12.0(7)T This command was implemented on the Cisco 1750 router.
12.2(8)T This command was implemented for AIC and WIC cards on the Cisco 2600
series and the Cisco 3600 series.
12.2(13)T This command was implemented for the AIM-VPN/EPII and AIM-VPN/HPII
cards on the following platforms: Cisco 2691, Cisco 3660, Cisco 3725, and
Cisco 3745.
12.2(15)ZJ This command was implemented for the AIM-VPN/BPII card on the following
platforms: Cisco 2610XM, Cisco 2611XM, Cisco 2620XM, Cisco 2621XM,
Cisco 2650XM, and Cisco 2651XM.
12.3(4)T Support for the AIM-VPN/BPII card on the Cisco 2600XM series was
integrated into Cisco IOS Release 12.3(4)T.

Usage Guidelines Use this command to determine the type of hardware installed in your networking device. This command
displays information for the EEPROM, motherboard, WAN interface cards (WICs), voice interface cards
(VICs), ATM interface cards (AICs), and advanced integration modules (AIMs).

Note The enhancement to display the field replaceable unit (FRU) number in show diag command output is
not available in all Cisco IOS releases and not all Cisco devices and Cisco network modules will display
their FRU numbers.

Examples of output showing the FRU number are included in the Examples section.

Cisco IOS Interface and Hardware Component Command Reference

IR-534
 Interface and Hardware Component Commands
show diag

Cisco 7304 Router Usage Guidelines

For the Cisco 7304 router, this command applies to NSEs, line cards, MSCs, and SPAs.
• To display hardware information for an NSE, line card, or MSC in the specified slot, use the
slot-number argument. For MSCs, information about the MSC and each of its installed SPAs is
displayed.
• To display hardware information about the backplane, power supplies, and fan modules, use the
chassis keyword.

Shared Port Adapter Usage Guidelines

• To display hardware information for an MSC or SIP only in a specified slot, use the slot-number
argument.
• To display hardware information for a SPA only, use the show diag subslot slot/subslot version of
this command.

Examples Example for a 1-Port T3 Serial Port Adapter on the Cisco 7200 Series Router
The following is sample output from the show diag command for a 1-port T3 serial port adapter in
chassis slot 1 on a Cisco 7200 series router:
Router# show diag 1

Slot 1:
Physical slot 1, ~physical slot 0xE, logical slot 1, CBus 0
Microcode Status 0x4
Master Enable, LED, WCS Loaded
Board is analyzed
Pending I/O Status: None
EEPROM format version 1
VIP2 controller, HW rev 2.4, board revision D0
Serial number: 04372053 Part number: 73-1684-03
Test history: 0x00 RMA number: 00-00-00
Flags: cisco 7000 board; 7500 compatible

EEPROM contents (hex):

0x20: 01 15 02 04 00 42 B6 55 49 06 94 03 00 00 00 00
0x30: 68 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

Slot database information:

Flags: 0x4 Insertion time: 0x14A8 (5d02h ago)

Controller Memory Size: 16 MBytes DRAM, 1024 KBytes SRAM

PA Bay 0 Information:
T3 Serial PA, 1 ports
EEPROM format version 1
HW rev FF.FF, Board revision UNKNOWN
Serial number: 4294967295 Part number: 255-65535-255

Example Output from a Cisco 7200 Showing the FRU Number

The following is sample output from the show diag command on a Cisco 7200 series router showing the
FRU number:
Router# show diag
Slot 0:
Dual FastEthernet (RJ-45) I/O Card Port adapter, 2 ports
Port adapter is analyzed
Port adapter insertion time 6d02h ago

Cisco IOS Interface and Hardware Component Command Reference

IR-535
 Interface and Hardware Component Commands
show diag

EEPROM contents at hardware discovery:

Hardware Revision : 2.1
Top Assy. Part Number : 800-07114-06
Part Number : 73-5003-06
Board Revision : B0
PCB Serial Number : 31558694
RMA History : 00
Fab Version : 03
Fab Part Number : 28-3455-03
Product (FRU) Number : C7200-I/O-2FE/E
Deviation Number : 0-0
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 02 15 41 02 01 C0 46 03 20 00 1B CA 06
0x10: 82 49 13 8B 06 42 42 30 C1 8B 33 31 35 35 38 36
0x20: 39 34 00 00 00 04 00 02 03 85 1C 0D 7F 03 CB 8F
0x30: 43 37 32 30 30 2D 49 2F 4F 2D 32 46 45 2F 45 80
0x40: 00 00 00 00 FF FF FF FF FF FF FF FF FF FF FF FF
0x50: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
Router#

Examples for a Cisco 12000 Series Internet Router

The following is sample output from the show diag command on a Cisco 12000 series Internet router:
Router# show diag 3

SLOT 3 (RP/LC 3 ): 4 Port Packet Over SONET OC-3c/STM-1 Multi Mode

MAIN: type 33, 00-0000-00 rev 70 dev 0
HW config: 0x01 SW key: 00-00-00
PCA: 73-2147-02 rev 94 ver 2
HW version 1.0 S/N 04499695
MBUS: MBUS Agent (1) 73-2146-05 rev 73 dev 0
HW version 1.1 S/N 04494882
Test hist: 0x00 RMA#: 00-00-00 RMA hist: 0x00
DIAG: Test count: 0x05000001 Test results: 0x00000000
MBUS Agent Software version 01.27 (RAM) using CAN Bus A
ROM Monitor version 00.0D
Fabric Downloader version used 00.0D (ROM version is 00.0D)
Board is analyzed
Board State is Line Card Enabled (IOS RUN )
Insertion time: 00:00:10 (00:04:51 ago)
DRAM size: 33554432 bytes
FrFab SDRAM size: 67108864 bytes
ToFab SDRAM size: 16777216 bytes

The following is sample output from the show diag command with the summary keyword:
Router# show diag summary

SLOT 0 (RP/LC 0 ): Route Processor

SLOT 2 (RP/LC 2 ): 4 Port Packet Over SONET OC-3c/STM-1 Single Mode
SLOT 4 (RP/LC 4 ): 4 Port Packet Over SONET OC-3c/STM-1 Single Mode
SLOT 7 (RP/LC 7 ): 4 Port Packet Over SONET OC-3c/STM-1 Single Mode
SLOT 9 (RP/LC 9 ): 4 Port Packet Over SONET OC-3c/STM-1 Single Mode
SLOT 11 (RP/LC 11): 4 Port Packet Over SONET OC-3c/STM-1 Single Mode
SLOT 16 (CSC 0 ): Clock Scheduler Card
SLOT 17 (CSC 1 ): Clock Scheduler Card
SLOT 18 (SFC 0 ): Switch Fabric Card
SLOT 19 (SFC 1 ): Switch Fabric Card
SLOT 20 (SFC 2 ): Switch Fabric Card
SLOT 24 (PS A1 ): AC Power Supply

Cisco IOS Interface and Hardware Component Command Reference

IR-536
Interface and Hardware Component Commands
show diag

SLOT 26 (PS B1 ): AC Power Supply

SLOT 28 (TOP FAN ): Blower Module
SLOT 29 (BOT FAN ): Blower Module

The following is sample output from the show diag command with the details keyword:
Router# show diag 4 details

SLOT 4 (RP/LC 4): 4 Port Packet Over SONET OC-3c/STM-1 Single Mode
MAIN: type 33, 800-2389-01 rev 71 dev 16777215
HW config: 0x00 SW key: FF-FF-FF
PCA: 73-2275-03 rev 75 ver 3
HW version 1.1 S/N 04529465
MBUS: MBUS Agent (1) 73-2146-06 rev 73 dev 0
HW version 1.1 S/N 04541395
Test hist: 0xFF RMA#: FF-FF-FF RMA hist: 0xFF
DIAG: Test count: 0x05000001 Test results: 0x00000000
EEPROM contents (hex):
00: 01 00 01 00 49 00 08 62 06 03 00 00 00 FF FF FF
10: 30 34 35 34 31 33 39 35 FF FF FF FF FF FF FF FF
20: 01 01 00 00 00 00 00 FF FF FF FF FF FF FF FF FF
30: A5 FF A5 A5 A5 A5 FF A5 A5 A5 A5 A5 A5 A5 A5 A5
40: 00 21 01 01 00 49 00 08 E3 03 05 03 00 01 FF FF
50: 03 20 00 09 55 01 01 FF FF FF 00 FF FF FF FF FF
60: 30 34 35 32 39 34 36 35 FF FF FF FF FF FF FF FF
70: FF FF FF FF FF FF FF FF 05 00 00 01 00 00 00 00
MBUS Agent Software version 01.24 (RAM)
Fabric Downloader version 00.0D
Board is analyzed
Flags: 0x4
Board State is Line Card Enabled (IOS RUN)
Insertion time: 00:00:10 (00:04:51 ago)
DRAM size: 33554432 bytes
FrFab SDRAM size: 67108864 bytes
ToFab SDRAM size: 16777216 bytes

Example for an ATM SAR AIM in a Cisco 3660

The following is sample output from the show diag command for one ATM Segmentation and
Reassembly (SAR) AIM in a Cisco 3660 router:
Router# show diag 0

3660 Chassis type: ENTERPRISE

c3600 Backplane EEPROM:

Hardware Revision : 1.0
Top Assy. Part Number : 800-04740-02
.
.
.
ATM AIM: 1
ATM AIM module with SAR only (no DSPs)
Hardware Revision : 1.0
Top Assy. Part Number : 800-03700-01
Board Revision : A0
Deviation Number : 0-0
Fab Version : 02
PCB Serial Number : JAB9801ABCD

Example Output from a Cisco 3660 Showing the FRU Number

The following is sample output from the show diag command on a Cisco 3660 router that shows the FRU
numbers for slots 0 and 1:

Cisco IOS Interface and Hardware Component Command Reference

IR-537
 Interface and Hardware Component Commands
show diag

Router# show diag

3660 Chassis type: ENTERPRISE
3660 Backplane EEPROM:
Hardware Revision : 1.0
Top Assy. Part Number : 800-04740-02
Board Revision : C0
Deviation Number : 0-0
Fab Version : 02
PCB Serial Number : HAD04471U36
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Chassis Serial Number : JAB055180FF
Chassis MAC Address : 0007.ebea.4460
MAC Address block size : 112
Manufacturing Test Data : 00 00 00 00 00 00 00 00
Fab Part Number : 28-2651-02
Number of Slots : 6
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 00 C8 41 01 00 C0 46 03 20 00 12 84 02
0x10: 42 43 30 80 00 00 00 00 02 02 C1 8B 48 41 44 30
0x20: 34 34 37 31 55 33 36 03 00 81 00 00 00 00 04 00
0x30: C2 8B 4A 41 42 30 35 35 31 38 30 46 46 C3 06 00
0x40: 07 EB EA 44 60 43 00 70 C4 08 00 00 00 00 00 00
0x50: 00 00 85 1C 0A 5B 02 01 06 FF FF FF FF FF FF FF
0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
Slot 0:
C3600 Mother board 2FE(TX) Port adapter, 2 ports
Port adapter is analyzed
Port adapter insertion time unknown
EEPROM contents at hardware discovery:
PCB Serial Number : JAB05460CSV
Processor type : 34
Top Assy. Part Number : 800-04737-04
Board Revision : C0
Fab Part Number : 28-3234-02
Deviation Number : 65535-65535
Manufacturing Test Data : FF FF FF FF FF FF FF FF
RMA Number : 255-255-255-255
RMA Test History : FF
RMA History : FF
Field Diagnostics Data : FF FF FF FF FF FF FF FF
Product (FRU) Number : Leopard-2FE
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF C1 8B 4A 41 42 30 35 34 36 30 43 53 56 09
0x10: 34 40 00 B3 C0 46 03 20 00 12 81 04 42 43 30 85
0x20: 1C 0C A2 02 80 FF FF FF FF C4 08 FF FF FF FF FF
0x30: FF FF FF 81 FF FF FF FF 03 FF 04 FF C5 08 FF FF
0x40: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x50: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 00

Slot 1:
Mueslix-4T Port adapter, 4 ports
Port adapter is analyzed
Port adapter insertion time unknown
EEPROM contents at hardware discovery:
Hardware revision 1.1 Board revision D0
Serial number 17202570 Part number 800-02314-02
FRU Part Number: NM-4T=

Cisco IOS Interface and Hardware Component Command Reference

IR-538
Interface and Hardware Component Commands
show diag

Test history 0x0 RMA number 00-00-00

EEPROM format version 1
EEPROM contents (hex):
0x00: 01 54 01 01 01 06 7D 8A 50 09 0A 02 00 00 00 00
0x10: 68 00 00 00 99 11 21 00 00 05 FF FF FF FF FF FF
Router#

Example for an NM-AIC-64 Installed in a Cisco 2611

The following is sample output from the show diag command for a Cisco 2611 router with the
NM-AIC-64 installed.
Router# show diag

Slot 0:
C2611 2E Mainboard Port adapter, 2 ports
Port adapter is analyzed
Port adapter insertion time unknown
EEPROM contents at hardware discovery:
Hardware Revision : 2.3
PCB Serial Number : JAD044808SG (1090473337)
Part Number : 73-2840-13
RMA History : 00
RMA Number : 0-0-0-0
Board Revision : C0
Deviation Number : 0-0
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 00 92 41 02 03 C1 18 4A 41 44 30 34 34
0x10: 38 30 38 53 47 20 28 31 30 39 30 34 37 33 33 33
0x20: 37 29 82 49 0B 18 0D 04 00 81 00 00 00 00 42 43
0x30: 30 80 00 00 00 00 FF FF FF FF FF FF FF FF FF FF
0x40: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x50: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF

Slot 1:
NM_AIC_64 Port adapter, 3 ports
Port adapter is analyzed
Port adapter insertion time unknown
EEPROM contents at hardware discovery:
Hardware Revision : 1.0
Part Number : 74-1923-01
Board Revision : 02
PCB Serial Number : DAN05060012
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 02 55 41 01 00 82 4A 07 83 01 42 30 32
0x10: C1 8B 44 41 4E 30 35 30 36 30 30 31 32 FF FF FF
0x20: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x30: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x40: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x50: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF

Table 44 describes significant fields shown in the display.

Cisco IOS Interface and Hardware Component Command Reference

IR-539
 Interface and Hardware Component Commands
show diag

Table 44 show diag (AIC) Field Descriptions

Field Description
C2611 2E Mainboard Port Line card type; number of ports available.
adapter, 2 ports
Port adapter is analyzed The system has identified the port adapter.
Port adapter insertion time Elapsed time since insertion.
Hardware Revision Version number of the port adapter.
PCB Serial Number Serial number of the printed circuit board.
Part Number Part number of the port adapter.
RMA History Counter that indicates how many times the port adapter has been
returned and repaired.
RMA Number Return material authorization number, which is an administrative
number assigned if the port adapter needs to be returned for repair.
Board Revision Revision number (signifying a minor revision) of the port adapter.
Deviation Number Revision number (signifying a minor deviation) of the port adapter.
EEPROM format version Version number of the EEPROM format.
EEPROM contents (hex) Dumps of EEPROM programmed data.

Example for an AIM-VPN in a Cisco 2611XM

The following example shows how to obtain hardware information about an installed AIM-VPN on the
Cisco 2611XM router.
Router# show diag 0

Encryption AIM 1:
Hardware Revision :1.0
Top Assy. Part Number :800-03700-01
Board Revision :A0
Deviation Number :0-0
Fab Version :02
PCB Serial Number :JAB9801ABCD
RMA Test History :00
RMA Number :0-0-0-0
RMA History :00
EEPROM format version 4
EEPROM contents (hex):
0x00:04 FF 40 03 0B 41 01 00 C0 46 03 20 00 0E 74 01
0x10:42 41 30 80 00 00 00 00 02 02 C1 8B 4A 41 42 39
0x20:38 30 31 41 42 43 44 03 00 81 00 00 00 00 04 00
0x30:FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x40:FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x50:FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x60:FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x70:FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF

Cisco IOS Interface and Hardware Component Command Reference

IR-540
Interface and Hardware Component Commands
show diag

Table 45 describes significant fields shown in the display.

Table 45 show diag (AIM-VPN) Field Descriptions

Field Description
Hardware Revision Version number of the port adapter.
Top Assy. Part Number Part number of the port adapter.
Board Revision Revision number (signifying a minor revision) of the port adapter.
Deviation Number Revision number (signifying a minor deviation) of the port adapter.
PCB Serial Number Serial number of the printed circuit board.
RMA Number Return material authorization number, which is an administrative
number assigned if the port adapter needs to be returned for repair.
RMA History Counter that indicates how many times the port adapter has been
returned and repaired.
EEPROM format version Version number of the EEPROM format.
EEPROM contents (hex) Dumps of EEPROM programmed data.

Example for an MSC-100 on the Cisco 7304 Router

The following is sample output from the show diag slot-number version of the command for an
MSC-100 located in slot number 4 on a Cisco 7304 router. Information about the MSC is followed by
information for its associated SPAs:
Router# show diag 4
Slot 4:
7304-MSC-100 SPA Carrier Card Line Card
Line Card state: Active
Insertion time: 00:08:49 ago
Bandwidth points: 4000000
EEPROM contents at hardware discovery:
Hardware Revision : 0.18
Boot Time out : 0000
PCB Serial Number : CSJ07288905
Part Number : 73-8789-01
Board Revision : A0
Fab Version : 02
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Deviation Number : 0-0
Product Number : 7304-MSC-100
Top Assy. Part Number : 68-1163-04
Manufacturing Test Data : 00 00 00 00 00 00 00 00
Field Diagnostics Data : 00 00 00 00 00 00 00 00
Calibration Data : Minimum: 0 dBmV, Maximum: 0 dBmV
Calibration values :
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 04 50 41 00 12 46 00 00 C1 8B 43 53 4A
0x10: 30 37 32 38 38 39 30 35 82 49 22 55 01 42 41 30
0x20: 02 02 03 00 81 00 00 00 00 04 00 80 00 00 00 00
0x30: CB 94 37 33 30 34 2D 4D 53 43 2D 31 30 30 20 20
0x40: 20 20 20 20 20 20 87 44 04 8B 04 C4 08 00 00 00
0x50: 00 00 00 00 00 C5 08 00 00 00 00 00 00 00 00 C8
0x60: 09 00 00 00 00 00 00 00 00 00 C7 7C F6 44 3F 30
0x70: 00 00 00 00 00 00 00 00 00 00 00 00 02 EE FF C8

Cisco IOS Interface and Hardware Component Command Reference

IR-541
 Interface and Hardware Component Commands
show diag

0x80: C8 37 26 05 DC 64 28 1E 37 26 09 C4 64 32 28 32
0x90: DD 0C E4 64 32 28 43 24 2E E0 AA 82 64 F4 24 00
0xA0: 00 00 00 00 00 00 F0 2E FF FF FF FF FF FF FF FF
0xB0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0xC0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0xD0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0xE0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0xF0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x100: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x110: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x120: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x130: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x140: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x150: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x160: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x170: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x180: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x190: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x1A0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x1B0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x1C0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x1D0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x1E0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x1F0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
FPGA information:
Current FPGA version : 00.23
IOS bundled FPGA version : 00.23
CPLD version : 01.02

Subslot 4/1:
Shared port adapter: SPA-4FE-7304, 4 ports
State: ok
Insertion time: 00:15:13 ago
Bandwidth: 400000 kbps
EEPROM contents:

Examples for Shared Port Adapters on the Cisco 7304 Router

The following is sample output from the show diag subslot command for a 4-Port 10/100 Fast Ethernet
SPA located in the bottom subslot (1) of the MSC that is installed in slot 4 on a Cisco 7304 router:
Router# show diag subslot 4/1
Subslot 4/1:
Shared port adapter: SPA-4FE-7304, 4 ports
Info: hw-ver=0x100, sw-ver=0x0 fpga-ver=0x0
State: ok
Insertion time: 23:20:42 ago
Bandwidth: 400000 kbps
EEPROM contents:
Hardware Revision : 1.0
Boot Time out : 0190
PCB Serial Number : JAB073204G5
Part Number : 73-8717-03
73/68 Level Revision : 01
Fab Version : 02
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Deviation Number : 0
Product Number : SPA-4FE-7304
Product Version Id : V01
Top Assy. Part Number : 68-2181-01
73/68 Level Revision : A0
CLEI Code : CNS9420AAA

Cisco IOS Interface and Hardware Component Command Reference

IR-542
Interface and Hardware Component Commands
show diag

Base MAC Address : 0000.0000.0000

MAC Address block size : 1024
Manufacturing Test Data : 00 00 00 00 00 00 00 00
Field Diagnostics Data : 00 00 00 00 00 00 00 00
Field Diagnostics Data : 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00
Calibration Data : Minimum: 0 dBmV, Maximum: 0 dBmV
Calibration values :
Power Consumption : 160000mW max
Mode 1 : 0mW
Mode 2 : 0mW
Mode 3 : 0mW
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 04 35 41 01 00 46 01 90 C1 8B 4A 41 42
0x10: 30 37 33 32 30 34 47 35 82 49 22 0D 03 8A 30 31
0x20: 20 20 02 02 03 00 81 00 00 00 00 04 00 88 00 00
0x30: 00 00 CB 94 53 50 41 2D 34 46 45 2D 37 33 30 34
0x40: 20 20 20 20 20 20 20 20 89 56 30 31 20 87 44 08
0x50: 85 01 8A 41 30 20 20 C6 8A 43 4E 53 39 34 32 30
0x60: 41 41 41 CF 06 00 00 00 00 00 00 43 04 00 C4 08
0x70: 00 00 00 00 00 00 00 00 C5 08 00 00 00 00 00 00
0x80: 00 00 F4 00 64 00 00 00 00 00 00 00 00 00 00 00
0x90: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xA0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xB0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xC0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xD0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xE0: 00 00 00 00 00 00 00 00 00 C8 09 00 00 00 00 00
0xF0: 00 00 00 00 D7 08 3E 80 00 00 00 00 00 00 F3 00
0x100: 41 01 08 F6 48 43 34 F6 49 44 35 02 31 04 B0 B4
0x110: A0 8C 00 00 05 DC 64 46 32 00 00 07 08 64 46 32
0x120: 00 00 09 C4 64 46 32 00 00 0C E4 64 46 32 00 00
0x130: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 FE 02
0x140: F2 A6 FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x150: CC A0 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x160: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x170: 00 00 D4 A0 00 00 00 00 00 00 00 00 00 00 00 00
0x180: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x190: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1A0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1B0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1C0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1D0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1E0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1F0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
FPGA version:
Software version : 04.17
Hardware version : 04.17

The following is sample output from the show diag subslot command for a 2-Port 10/100/1000 Gigabit
Ethernet SPA located in the top subslot (0) of the MSC that is installed in slot 4 on a Cisco 7304 router:

Cisco IOS Interface and Hardware Component Command Reference

IR-543
 Interface and Hardware Component Commands
show diag

Router# show diag subslot 4/0

Subslot 4/0:
Shared port adapter: SPA-2GE-7304, 2 ports
Info: hw-ver=0x17, sw-ver=0x0 fpga-ver=0x0
State: ok
Insertion time: 00:08:47 ago
Bandwidth: 2000000 kbps
EEPROM contents:
Hardware Revision : 0.23
Boot Time out : 0190
PCB Serial Number : JAB073406YH
Part Number : 73-8792-02
73/68 Level Revision : 01
Fab Version : 02
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Deviation Number : 0
Product Number : SPA-2GE-7304
Product Version Id : V01
Top Assy. Part Number : 68-2181-01
73/68 Level Revision : A0
CLEI Code : CNS9420AAA
Base MAC Address : 0000.0000.0000
MAC Address block size : 1024
Manufacturing Test Data : 00 00 00 00 00 00 00 00
Field Diagnostics Data : 00 00 00 00 00 00 00 00
Field Diagnostics Data : 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00
Calibration Data : Minimum: 0 dBmV, Maximum: 0 dBmV
Calibration values :
Power Consumption : 160000mW max
Mode 1 : 0mW
Mode 2 : 0mW
Mode 3 : 0mW
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 04 36 41 00 17 46 01 90 C1 8B 4A 41 42
0x10: 30 37 33 34 30 36 59 48 82 49 22 58 02 8A 30 31
0x20: 20 20 02 02 03 00 81 00 00 00 00 04 00 88 00 00
0x30: 00 00 CB 94 53 50 41 2D 32 47 45 2D 37 33 30 34
0x40: 20 20 20 20 20 20 20 20 89 56 30 31 20 87 44 08
0x50: 85 01 8A 41 30 20 20 C6 8A 43 4E 53 39 34 32 30
0x60: 41 41 41 CF 06 00 00 00 00 00 00 43 04 00 C4 08
0x70: 00 00 00 00 00 00 00 00 C5 08 00 00 00 00 00 00
0x80: 00 00 F4 00 64 00 00 00 00 00 00 00 00 00 00 00
0x90: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xA0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xB0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xC0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xD0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xE0: 00 00 00 00 00 00 00 00 00 C8 09 00 00 00 00 00
0xF0: 00 00 00 00 D7 08 3E 80 00 00 00 00 00 00 F3 00

Cisco IOS Interface and Hardware Component Command Reference

IR-544
Interface and Hardware Component Commands
show diag

0x100: 41 01 08 F6 48 43 34 F6 49 44 35 02 31 03 E8 B4
0x110: A0 8C 37 26 05 DC 64 46 32 37 26 07 08 64 46 32
0x120: 37 26 09 C4 64 46 32 32 DD 0C E4 64 46 32 43 24
0x130: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 FE 02
0x140: EF E2 FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x150: CC A0 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x160: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x170: 00 00 D4 A0 00 00 00 00 00 00 00 00 00 00 00 00
0x180: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x190: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1A0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1B0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1C0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1D0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1E0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1F0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
FPGA version:
Software version : 04.17
Hardware version : 04.17

Examples for a Shared Port Adapter on a Cisco 12000 Series Router

The following is sample output from the show diag subslot command for the 1-Port OC-192c/STM-64c
POS/RPR XFP SPA in subslot 1 of the SIP located in chassis slot 1 on a Cisco 12000 series router:
Router# show diag subslot 1/1
SUBSLOT 1/1 (SPA-OC192POS-XFP): 1-port OC192/STM64 POS/RPR XFP Optics Shared Port Adapter
Product Identifier (PID) : SPA-OC192POS-XFP
Version Identifier (VID) : V01
PCB Serial Number : PRTA1304061
Top Assy. Part Number : 68-2190-01
Top Assy. Revision : A0
Hardware Revision : 2.0
CLEI Code : UNASSIGNED
Insertion Time : 00:00:10 (13:14:17 ago)
Operational Status : ok

Table 46 describes the significant fields shown in the display.

Table 46 show diag subslot Field Descriptions

Field Description
Product Identifier (PID) Product number of the SPA.
Version Identifier (VID) Version number of the SPA.
PCB Serial Number Serial number of the printed circuit board.
Top Assy. Part Number Part number of the SPA.
Top Assy. Revision Revision number (signifying a minor revision) of the SPA.
Hardware Revision Revision number (signifying a minor revision) of the SPA hardware.
CLEI Code Common Language Equipment Identification number.
Insertion Time Time when the SPA was installed, and elapsed time between that
insertion time and the current time.
Operational Status Current status of the SPA. For more information about the status
field descriptions, refer to the show hw-module subslot oir
command.

Cisco IOS Interface and Hardware Component Command Reference

IR-545
 Interface and Hardware Component Commands
show diag

The following is sample output from the show diag subslot details command for the 1-Port
OC-192c/STM-64c POS/RPR XFP SPA in subslot 1 of the SIP located in chassis slot 1 on a Cisco 12000
series router:
Router# show diag subslot 1/1 details
SUBSLOT 1/1 (SPA-OC192POS-XFP): 1-port OC192/STM64 POS/RPR XFP Optics Shared Port Adapter
EEPROM version : 4
Compatible Type : 0xFF
Controller Type : 1100
Hardware Revision : 2.0
Boot Timeout : 400 msecs
PCB Serial Number : PRTA1304061
PCB Part Number : 73-8546-01
PCB Revision : A0 Fab Version : 01
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Deviation Number : 0
Product Identifier (PID) : SPA-OC192POS-XFP
Version Identifier (VID) : V01
Top Assy. Part Number : 68-2190-01
Top Assy. Revision : A0 IDPROM Format Revision : 36
System Clock Frequency : 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00
CLEI Code : UNASSIGNED
Base MAC Address : 00 00 00 00 00 00
MAC Address block size : 0
Manufacturing Test Data : 00 00 00 00 00 00 00 00
Field Diagnostics Data : 00 00 00 00 00 00 00 00
Calibration Data : Minimum: 0 dBmV, Maximum: 0 dBmV
Calibration values :
Power Consumption : 11000 mWatts (Maximum)
Environment Monitor Data : 03 30 04 B0 46 32 07 08
46 32 09 C4 46 32 0C E4
46 32 13 88 46 32 07 08
46 32 EB B0 50 3C 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 FE 02 F6 AC
Processor Label : 00 00 00 00 00 00 00
Platform features : 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00
Asset ID :
Asset Alias :
Insertion Time : 00:00:10 (13:14:24 ago)
Operational Status : ok

Example for a SPA Interface Processor on a Cisco 12000 Series Router

The following is sample output from the show diag command for a SIP located in chassis slot 2 on a
Cisco 12000 series router:
Router# show diag 2

SLOT 2 (RP/LC 2 ): Modular 10G SPA Interface Card

MAIN: type 149, 800-26270-01 rev 84
Deviation: 0
HW config: 0x00 SW key: 00-00-00
PCA: 73-9607-01 rev 91 ver 1
Design Release 1.0 S/N SAD08460678
MBUS: Embedded Agent

Cisco IOS Interface and Hardware Component Command Reference

IR-546
Interface and Hardware Component Commands
show diag

Test hist: 0x00 RMA#: 00-00-00 RMA hist: 0x00

DIAG: Test count: 0x00000000 Test results: 0x00000000
FRU: Linecard/Module: 12000-SIP-650
FRU: Linecard/Module: 12000-SIP-650
Processor Memory: MEM-LC5-1024=(Non-Replaceable)
Packet Memory: MEM-LC5-PKT-256=(Non-Replaceable)
L3 Engine: 5 - ISE OC192 (10 Gbps)
MBUS Agent Software version 1.114 (RAM) (ROM version is 3.4)
ROM Monitor version 255.255
Fabric Downloader version used 3.7 (ROM version is 255.255)
Primary clock is CSC 1
Board is analyzed
Board State is Line Card Enabled (IOS RUN )
Insertion time: 1d00h (2d08h ago)
Processor Memory size: 1073741824 bytes
TX Packet Memory size: 268435456 bytes, Packet Memory pagesize: 32768 bytes
RX Packet Memory size: 268435456 bytes, Packet Memory pagesize: 32768 bytes
0 crashes since restart

SPA Information:
subslot 2/0: SPA-OC192POS-XFP (0x44C), status is ok
subslot 2/1: Empty
subslot 2/2: Empty
subslot 2/3: Empty

Example for ADSL HWICs

The following is sample output from the show diag command for a Cisco 2811 router with
HWIC-1ADSL installed in slot 1 and HWIC-1ADSLI installed in slot 2. Each HWIC has a daughtercard
as part of its assembly. The command results below give the output from the HWIC followed by the
output from its daughtercard.
Router# show diag 0

Slot 0:
C2811 Motherboard with 2FE and integrated VPN Port adapter, 2 ports
Port adapter is analyzed
Port adapter insertion time unknown
Onboard VPN : v2.2.0
EEPROM contents at hardware discovery:
PCB Serial Number : FOC09052HHA
Hardware Revision : 2.0
Top Assy. Part Number : 800-21849-02
Board Revision : B0
Deviation Number : 0
Fab Version : 06
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Processor type : 87
Hardware date code : 20050205
Chassis Serial Number : FTX0908A0B0
Chassis MAC Address : 0013.1ac2.2848
MAC Address block size : 24
CLEI Code : CNMJ7N0BRA
Product (FRU) Number : CISCO2811
Part Number : 73-7214-09
Version Identifier : NA
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF C1 8B 46 4F 43 30 39 30 35 32 48 48 41 40
0x10: 03 E7 41 02 00 C0 46 03 20 00 55 59 02 42 42 30
0x20: 88 00 00 00 00 02 06 03 00 81 00 00 00 00 04 00

Cisco IOS Interface and Hardware Component Command Reference

IR-547
 Interface and Hardware Component Commands
show diag

0x30: 09 87 83 01 31 F1 1D C2 8B 46 54 58 30 39 30 38
0x40: 41 30 42 30 C3 06 00 13 1A C2 28 48 43 00 18 C6
0x50: 8A 43 4E 4D 4A 37 4E 30 42 52 41 CB 8F 43 49 53
0x60: 43 4F 32 38 31 31 20 20 20 20 20 20 82 49 1C 2E
0x70: 09 89 20 20 4E 41 D9 02 40 C1 FF FF FF FF FF FF

WIC Slot 1:
ADSL over POTS
Hardware Revision : 7.0
Top Assy. Part Number : 800-26247-01
Board Revision : 01
Deviation Number : 0
Fab Version : 07
PCB Serial Number : FHH093600D4
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Product (FRU) Number : HWIC-1ADSL
Version Identifier : V01
CLEI Code :
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 04 C8 41 07 00 C0 46 03 20 00 66 87 01
0x10: 42 30 31 88 00 00 00 00 02 07 C1 8B 46 48 48 30
0x20: 39 33 36 30 30 44 34 03 00 81 00 00 00 00 04 00
0x30: CB 94 48 57 49 43 2D 31 41 44 53 4C 20 20 20 20
0x40: 20 20 20 20 20 20 89 56 30 31 20 D9 02 40 C1 C6
0x50: 8A FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF

EM Slot 0:
ADSL over POTS non-removable daughtercard
Hardware Revision : 5.0
Part Number : 73-9307-05
Board Revision : 03
Deviation Number : 0
Fab Version : 05
PCB Serial Number : FHH0936006E
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Fab Part Number : 28-6607-05
Manufacturing Test Data : 00 00 00 00 00 00 00 00
Field Diagnostics Data : 00 00 00 00 00 00 00 00
Connector Type : 01
Version Identifier : V01
Product (FRU) Number :
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 04 7A 41 05 00 82 49 24 5B 05 42 30 33
0x10: 88 00 00 00 00 02 05 C1 8B 46 48 48 30 39 33 36
0x20: 30 30 36 45 03 00 81 00 00 00 00 04 00 85 1C 19
0x30: CF 05 C4 08 00 00 00 00 00 00 00 00 C5 08 00 00
0x40: 00 00 00 00 00 00 05 01 89 56 30 31 20 FF FF FF
0x50: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF

WIC Slot 2:
ADSL over ISDN
Hardware Revision : 7.0
Top Assy. Part Number : 800-26248-01
Board Revision : 01

Cisco IOS Interface and Hardware Component Command Reference

IR-548
Interface and Hardware Component Commands
show diag

Deviation Number : 0
Fab Version : 07
PCB Serial Number : FHH093600DA
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Product (FRU) Number : HWIC-1ADSLI
Version Identifier : V01
CLEI Code :
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 04 C9 41 07 00 C0 46 03 20 00 66 88 01
0x10: 42 30 31 88 00 00 00 00 02 07 C1 8B 46 48 48 30
0x20: 39 33 36 30 30 44 41 03 00 81 00 00 00 00 04 00
0x30: CB 94 48 57 49 43 2D 31 41 44 53 4C 49 20 20 20
0x40: 20 20 20 20 20 20 89 56 30 31 20 D9 02 40 C1 C6
0x50: 8A FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF

EM Slot 0:
ADSL over ISDN non-removable daughtercard
Hardware Revision : 5.0
Part Number : 73-9308-05
Board Revision : 03
Deviation Number : 0
Fab Version : 05
PCB Serial Number : FHH0936008M
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Fab Part Number : 28-6607-05
Manufacturing Test Data : 00 00 00 00 00 00 00 00
Field Diagnostics Data : 00 00 00 00 00 00 00 00
Connector Type : 01
Version Identifier : V01
Product (FRU) Number :
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 04 7B 41 05 00 82 49 24 5C 05 42 30 33
0x10: 88 00 00 00 00 02 05 C1 8B 46 48 48 30 39 33 36
0x20: 30 30 38 4D 03 00 81 00 00 00 00 04 00 85 1C 19
0x30: CF 05 C4 08 00 00 00 00 00 00 00 00 C5 08 00 00
0x40: 00 00 00 00 00 00 05 01 89 56 30 31 20 FF FF FF
0x50: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF

The following sample output from a Cisco 6500 series switch shows the FRU number:

Router# show diag

Slot 4: Logical_index 8
2 port adapter FlexWAN controller
Board is analyzed ipc ready
HW rev 1.5, board revision A0
Serial Number: SAD062404C8 Part number: 73-3869-08

Slot database information:

Flags: 0x2004 Insertion time: 0x20960 (1d04h ago)

Controller Memory Size:

112 MBytes CPU Memory

Cisco IOS Interface and Hardware Component Command Reference

IR-549
 Interface and Hardware Component Commands
show diag

16 MBytes Packet Memory

128 MBytes Total on Board SDRAM
IOS (tm) cwlc Software (cwpa-DW-M), Version 12.2(18)SXF2, RELEASE SOFTW)

PA Bay 0 Information:
ENHANCED ATM OC3 MM PA, 1 ports, FRU: PA-A3-OC3-MM
EEPROM format version 1
HW rev 2.00, Board revision A0
Serial number: 29360940 Part number: 73-2430-04
Slot 4: Logical_index 9
2 port adapter FlexWAN controller
Board is analyzed ipc ready
HW rev 1.5, board revision A0
Serial Number: SAD062404C8 Part number: 73-3869-08

Slot database information:

Flags: 0x2004 Insertion time: 0x20D10 (1d04h ago)

Controller Memory Size:

112 MBytes CPU Memory
16 MBytes Packet Memory
128 MBytes Total on Board SDRAM
IOS (tm) cwlc Software (cwpa-DW-M), Version 12.2(18)SXF2, RELEASE SOFTW)

PA Bay 1 Information:
Mx Serial PA, 4 ports
EEPROM format version 1
HW rev 1.00, Board revision A0
Serial number: 04387628 Part number: 73-1577-04
Router#

The following sample output from a Cisco 7600 series router shows the FRU number:
Router#show diag

Slot 2: Logical_index 4
2 port adapter Enhanced FlexWAN controller
Board is analyzed ipc ready
HW rev 2.1, board revision A0
Serial Number: JAE0940MH7Z Part number: 73-9539-04

Slot database information:

Flags: 0x2004 Insertion time: 0x256BC (1d01h ago)

Controller Memory Size:

384 MBytes CPU Memory
127 MBytes Packet Memory
511 MBytes Total on Board SDRAM
IOS (tm) cwlc Software (cwpa2-DW-M), Version 12.2(18)SXF2, RELEASE SOFT)

PA Bay 0 Information:
ENHANCED ATM OC3 MM PA, 1 ports, FRU: PA-A3-OC3-MM
EEPROM format version 4
HW rev 2.00, Board revision A0
Serial number: JAE0937KUPX Part number: 73-8728-01
Slot 2: Logical_index 5
2 port adapter Enhanced FlexWAN controller
Board is analyzed ipc ready
HW rev 2.1, board revision A0
Serial Number: JAE0940MH7Z Part number: 73-9539-04

Slot database information:

Flags: 0x2004 Insertion time: 0x22C34 (1d01h ago)

Cisco IOS Interface and Hardware Component Command Reference

IR-550
 Interface and Hardware Component Commands
show diag

Controller Memory Size:

384 MBytes CPU Memory
127 MBytes Packet Memory
511 MBytes Total on Board SDRAM
IOS (tm) cwlc Software (cwpa2-DW-M), Version 12.2(18)SXF2, RELEASE SOFT)

PA Bay 1 Information:
Mx Serial PA, 4 ports
EEPROM format version 1
HW rev 1.14, Board revision D0
Serial number: 33929508 Part number: 73-1577-07
Router#

Related Commands Command Description

dsl operating-mode (ADSL) Modifies the operating mode of the digital subscriber line for an
ATM interface.
show dsl interface atm Shows all of the ADSL-specific information for a specified ATM
interface.
show controllers fastethernet Displays Fast Ethernet interface information, transmission statistics
and errors, and applicable MAC destination address and VLAN
filtering tables.
show controllers Displays Gigabit Ethernet interface information, transmission
gigabitethernet statistics and errors, and applicable MAC destination address and
VLAN filtering tables.

Cisco IOS Interface and Hardware Component Command Reference

IR-551
 Interface and Hardware Component Commands
show dsip clients

show dsip clients

To display information about Distributed System Interconnect Protocol (DSIP) clients, use the
show dsip clients command in EXEC mode.

show dsip clients

Syntax Description This command has no arguments or keywords.

Command Modes EXEC

Command History Release Modification

11.3(2)AA This command was introduced.

Usage Guidelines Use this command to see whether a client is actually registered with DSIP and using its services.
Consider the following example: a client “Trunk” seems to be defunct on a particular node with
absolutely no input/output activity. The command show dsip ports does not show any Trunk port among
its local ports though all other client ports show up. The problem might be that the Trunk client did not
even register with DSIP. To confirm this, use the show dsip clients command.

Examples The following is sample output from the show dsip clients command. This command lists the clients.
Router# show dsip clients

ID Name
0 Console
1 Clock
2 Modem
3 Logger
4 Trunk
5 Async data
6 TDM
7 Dial shelf manager
8 Environment Mon
9 DSIP Test

Related Commands Command Description

show dsip nodes Displays information about the processors running the DSIP.
show dsip ports Displays information about local and remote ports
show dsip queue Displays the number of messages in the retransmit queue waiting for
acknowledgment.
show dsip tracing Displays DSIP tracing buffer information.

Cisco IOS Interface and Hardware Component Command Reference

IR-552
Interface and Hardware Component Commands
show dsip clients

Command Description
show dsip transport Displays information about the DSIP transport statistics for the control/data
and IPC packets and registered addresses.
show dsip version Displays DSIP version information.

Cisco IOS Interface and Hardware Component Command Reference

IR-553
 Interface and Hardware Component Commands
show etherchannel

show etherchannel
To display EtherChannel information for a channel, use the show etherchannel command in privileged
EXEC mode.

Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers

show etherchannel [channel-group] {port-channel | brief | detail | summary | port |

load-balance}

Cisco Catalyst Switches

show etherchannel [channel-group] {port-channel | brief | detail | summary | port |

load-balance} [expression]

Syntax Description channel-group (Optional) Number of the channel group; see the “Usage Guidelines” section
for valid values. If you do not specify a value for channel-group, all channel
groups are displayed
port-channel Displays port channel information.
brief Displays a summary of EtherChannel information.
detail Displays detailed EtherChannel information.
summary Displays a one-line summary per channel group.
port Displays EtherChannel port information.
load-balance Displays load-balance information.
expression (Optional) Expression in the output to use as a reference point.

Command Modes Privileged EXEC

Command History Release Modification

12.0(7)XE This command was introduced on Cisco Catalyst 6000 family switches.
12.1(3a)E3 The number of valid values for channel-group changed; see the “Usage
Guidelines” section for valid values.
12.2(2)XT This command was modified to support switchport creation on Cisco 2600 series,
Cisco 3600 series, and Cisco 3700 series routers.
12.2(8)T This command was modified to support switchport creation.

Usage Guidelines Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers
The channel-group argument supports six EtherChannels and eight ports in each channel.
If you do not specify a value for channel-group, all channel groups are displayed.

Cisco IOS Interface and Hardware Component Command Reference

IR-554
 Interface and Hardware Component Commands
show etherchannel

Cisco Catalyst Switches

The number of valid values for the channel-group argument depends on the software release. For
software releases prior to Cisco IOS Release 12.1(3a)E3, valid values are from 1 to 256; for Cisco IOS
Release 12.1(3a)E3, 12.1(3a)E4, and 12.1(4)E1, valid values are from 1 to 64. Cisco IOS
Release 12.1(5c)EX and later releases support a maximum of 64 values ranging from 1 to 256.
If you do not specify a value for channel-group, all channel groups are displayed.
In the output, the Passive port list field is displayed for Layer 3 port channels only. This field means that
the physical interface, which is still not up, is configured to be in the channel group (and indirectly in
the only port channel in the channel group).

Examples Port Channel Information for a Specific Group

The following example shows how to display port channel information for a specific group:
Router# show etherchannel 1 port-channel

Port-channels in the group:

----------------------
Port-channel: Po1
------------
Age of the Port-channel = 02h:35m:26s
Logical slot/port = 10/1 Number of ports in agport = 0
GC = 0x00000000 HotStandBy port = null
Passive port list = Fa5/4 Fa5/5
Port state = Port-channel L3-Ag Ag-Not-Inuse
Ports in the Port-channel:
Index Load Port
-------------------

Load Balancing
The following example shows how to display load-balancing information:
Router# show etherchannel load-balance

Source XOR Destination mac address

Summary Information for a Specific Group

The following example shows how to display a summary of information for a specific group:
Router# show etherchannel 1 brief

Group state = L3
Ports: 2 Maxports = 8
port-channels: 1 Max port-channels = 1

Detailed Information for a Specific Group

The following example shows how to display detailed information for a specific group:
Router# show etherchannel 1 detail

Group state = L3
Ports: 2 Maxports = 8
Port-channels: 1 Max Port-channels = 1
Ports in the group:
-------------------
Port: Fa5/4
------------
Port state = EC-Enbld Down Not-in-Bndl Usr-Config

Cisco IOS Interface and Hardware Component Command Reference

IR-555
 Interface and Hardware Component Commands
show etherchannel

Channel group = 1 Mode = Desirable Gcchange = 0

Port-channel = null GC = 0x00000000 Psudo-agport = Po1
Port indx = 0 Load = 0x00
Flags: S - Device is sending Slow hello. C - Device is in Consistent state.
A - Device is in Auto mode. P - Device learns on physical port.
Timers: H - Hello timer is running. Q - Quit timer is running.
S - Switching timer is running. I - Interface timer is running.

Local information:
Hello Partner PAgP Learning Group
Port Flags State Timers Interval Count Priority Method Ifindex
Fa5/4 d U1/S1 1s 0 128 Any 0

Age of the port in the current state: 02h:33m:14s

Port: Fa5/5
------------

Port state = EC-Enbld Down Not-in-Bndl Usr-Config

Channel group = 1 Mode = Desirable Gcchange = 0
Port-channel = null GC = 0x00000000 Psudo-agport = Po1
Port indx = 0 Load = 0x00

Flags: S - Device is sending Slow hello. C - Device is in Consistent state.

A - Device is in Auto mode. P - Device learns on physical port.
Timers: H - Hello timer is running. Q - Quit timer is running.
S - Switching timer is running. I - Interface timer is running.

Local information:
Hello Partner PAgP Learning Group
Port Flags State Timers Interval Count Priority Method Ifindex
Fa5/5 d U1/S1 1s 0 128 Any 0

Age of the port in the current state: 02h:33m:17s

Port-channels in the group:
----------------------

Port-channel: Po1
------------
Age of the Port-channel = 02h:33m:52s
Logical slot/port = 10/1 Number of ports in agport = 0
GC = 0x00000000 HotStandBy port = null
Passive port list = Fa5/4 Fa5/5
Port state = Port-channel L3-Ag Ag-Not-Inuse

Ports in the Port-channel:

Index Load Port

-------------------

One-Line Summary Per Channel Group

The following example shows how to display a one-line summary per channel group:
Router# show etherchannel summary

U-in use I-in port-channel S-suspended D-down i-stand-alone d-default

Group Port-channel Ports
----- ------------ ----------------------------------------------------------
1 Po1(U) Fa5/4(I) Fa5/5(I)
2 Po2(U) Fa5/6(I) Fa5/7(I)
255 Fa5/9(i)
256 Fa5/8(i)

Cisco IOS Interface and Hardware Component Command Reference

IR-556
 Interface and Hardware Component Commands
show etherchannel

Port Information for all Groups

The following example shows how to display EtherChannel port information for all ports and all groups:
Router# show etherchannel port

Channel-group listing:
-----------------------
Group: 1
----------
Ports in the group:
-------------------
Port: Fa5/4
------------
Port state = EC-Enbld Down Not-in-Bndl Usr-Config
Channel group = 1 Mode = Desirable Gcchange = 0
Port-channel = null GC = 0x00000000 Psudo-agport = Po1
Port indx = 0 Load = 0x00

Flags: S - Device is sending Slow hello. C - Device is in Consistent state.

A - Device is in Auto mode. P - Device learns on physical port.
Timers: H - Hello timer is running. Q - Quit timer is running.
S - Switching timer is running. I - Interface timer is running.

Local information:
Hello Partner PAgP Learning Group
Port Flags State Timers Interval Count Priority Method Ifindex
Fa5/4 d U1/S1 1s 0 128 Any 0

Age of the port in the current state: 02h:40m:35s

Port: Fa5/5
------------
Port state = EC-Enbld Down Not-in-Bndl Usr-Config
Channel group = 1 Mode = Desirable Gcchange = 0
Port-channel = null GC = 0x00000000 Psudo-agport = Po1
Port indx = 0 Load = 0x00

Flags: S - Device is sending Slow hello. C - Device is in Consistent state.

A - Device is in Auto mode. P - Device learns on physical port.
Timers: H - Hello timer is running. Q - Quit timer is running.
S - Switching timer is running. I - Interface timer is running.
.
.
.

Related Commands Command Description

channel-group Assigns and configures an EtherChannel interface to an EtherChannel group.
interface port-channel Accesses or creates the IDB port channel.

Cisco IOS Interface and Hardware Component Command Reference

IR-557
 Interface and Hardware Component Commands
show hub

show hub
To display information about the hub (repeater) on an Ethernet interface of a Cisco 2505 or Cisco 2507
router, use the show hub command in user EXEC or privileged EXEC mode.

show hub [ethernet number [port [end-port]]]

Syntax Description ethernet (Optional) Indicates that this is an Ethernet hub.

number (Optional) Hub number, starting with 0. Because there is currently only one hub,
this number is 0.
port (Optional) Port number on the hub. On the Cisco 2505 router, port numbers range
from 1 to 8. On the Cisco 2507 router, port numbers range from 1 to 16. If a second
port number follows, this port number indicates the beginning of a port range.
end-port (Optional) Ending port number of a range.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

10.3 This command was introduced.

Usage Guidelines If you do not specify a port or port range for the show hub command, the command displays all ports
(for example, ports 1 through 16 on a Cisco 2507 router) by default. Therefore, the show hub, show hub
ethernet 0, and show hub ethernet 0 1 16 commands produce the same result.
If no ports are specified, the command displays some additional data about the internal port. The internal
port is the hub’s connection to Ethernet interface 0 inside the box. Ethernet interface 0 still exists;
physical access to the interface is via the hub.

Examples Information for a Specific Port

The following is sample output from the show hub command for hub 0, port 2 only:
Router# show hub ethernet 0 2

Port 2 of 16 is administratively down, link state is down

0 packets input, 0 bytes
0 errors with 0 collisions
(0 FCS, 0 alignment, 0 too long,
0 short, 0 runts, 0 late,
0 very long, 0 rate mismatches)
0 auto partitions, last source address (none)
Last clearing of "show hub" counters never

Repeater information (Connected to Ethernet0)

2792429 bytes seen with 18 collisions, 1 hub resets
Version/device ID 0/1 (0/1)
Last clearing of "show hub" counters never

Cisco IOS Interface and Hardware Component Command Reference

IR-558
Interface and Hardware Component Commands
show hub

Information for All Ports

The following is sample output from the show hub command for hub 0, all ports:
Router# show hub ethernet 0

Port 1 of 16 is administratively down, link state is up

2458 packets input, 181443 bytes
3 errors with 18 collisions
(0 FCS, 0 alignment, 0 too long,
0 short, 3 runts, 0 late,
0 very long, 0 rate mismatches)
0 auto partitions, last source address was 0000.0cff.e257
Last clearing of "show hub" counters never
.
.
.
Port 16 of 16 is down, link state is down
0 packets input, 0 bytes
0 errors with 0 collisions
(0 FCS, 0 alignment, 0 too long,
0 short, 0 runts, 0 late,
0 very long, 0 rate mismatches)
0 auto partitions, last source address (none)
Last clearing of "show hub" counters never

Repeater information (Connected to Ethernet0)

2792429 bytes seen with 18 collisions, 1 hub resets
Version/device ID 0/1 (0/1)
Last clearing of "show hub" counters never

Internal Port (Connected to Ethernet0)

36792 packets input, 4349525 bytes
0 errors with 14 collisions
(0 FCS, 0 alignment, 0 too long,
0 short, 0 runts, 0 late,
0 very long, 0 rate mismatches)
0 auto partitions, last source address (none)
Last clearing of "show hub" counters never

Table 47 describes significant fields shown in the display.

Table 47 show hub Field Descriptions

Field Description
Port ... of ... is administratively down Port number out of total ports; indicates whether the interface
hardware is currently active or down because of the following:
• The link-state test failed.
• The MAC address mismatched when source address
configured.
• It has been taken down by an administrator.
link state is up Indicates whether port has been disabled by the link-test
function. If the link-test function is disabled by the user,
nothing will be shown here.
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.

Cisco IOS Interface and Hardware Component Command Reference

IR-559
 Interface and Hardware Component Commands
show hub

Table 47 show hub Field Descriptions (continued)

Field Description
errors Sum of FCS, alignment, too long, short, runts, very long, and
rate mismatches.
collisions Number of messages retransmitted due to Ethernet collisions.
FCS Counter for the number of frames detected on the port with an
invalid frame check sequence.
alignment Counter for the number of frames of valid length (64 to 1518
bytes) that have been detected on the port with an FCS error
and a framing error.
too long Counter for the number of frames that exceed the maximum
valid packet length of 1518 bytes.
short Counter for the number of instances when activity is detected
with duration less than 74 to 82 bit times.
runts Number of packets that are discarded because they are smaller
than the medium’s minimum packet size. For example, any
Ethernet packet that is less than 64 bytes is considered a runt.
late Counter for the number of instances when a collision is
detected after 480 to 565 bit times in the frame.
very longs Counter for the number of times the transmitter is active in
excess of 4 to 7.5 milliseconds.
rate mismatches Counter for the number of occurrences when the frequency, or
data rate of incoming signal is noticeably different from the
local transmit frequency.
auto partitions Counter for the number of instances where the repeater has
partitioned the port from the network.
last source address Source address of last packet received by this port. Indicates
“none” if no packets have been received since power on or a
hub reset.
Last clearing of “show hub” counters Elapsed time since the clear hub counters command was
entered. Indicates “never” if counters have never been cleared.
Repeater information (Connected to Indicates that the following information is about the hub
Ethernet0) connected to the Ethernet interface shown.
... bytes seen with ... collisions, ... Hub resets is the number of times the hub has been reset by
hub resets network management software or by the clear hub command.
Version/device ID 0/1 (0/1) Hub hardware version. IMR+ version device of daughter
board.
Internal Port (Connected to Set of counters for the internal AUI port connected to the
Ethernet0) Ethernet interface.

Related Commands Command Description

hub Enables and configures a port on an Ethernet hub of a Cisco 2505 or
Cisco 2507 router.

Cisco IOS Interface and Hardware Component Command Reference

IR-560
 Interface and Hardware Component Commands
show interfaces

show interfaces
To display statistics for all interfaces configured on the router or access server, use the show interfaces
command in privileged EXEC mode. The resulting output varies, depending on the network for which
an interface has been configured.

Cisco 2500 Series, Cisco 2600 Series, Cisco 4700 Series, and Cisco 7000 Series

show interfaces [type number] [first] [last] [accounting]

Cisco 7200 Series and Cisco 7500 Series with a Packet over SONET Interface Processor

show interfaces [type slot/port] [accounting]

Cisco 7500 Series with Ports on VIPs

show interfaces [type slot/port-adapter/port]

Syntax Description type (Optional) Interface type. Allowed values for type include async, bri0,
dialer, ethernet, fastethernet, fddi, hssi, loopback, null, serial, tokenring,
and tunnel.
For the Cisco 4500 series routers, type can be atm, e1, ethernet,
fastethernet, fddi, serial, t1, and token..
For the Cisco 7000 family, type can be atm, e1, ethernet, fastethernet, fddi,
serial, t1, and tokenring. For the Cisco 7500 series type can also include pos.
number (Optional) Port number on the selected interface.
first last (Optional) For the Cisco 2500 series routers, ISDN BRI only. The first
argument can be either 1 or 2. The last argument can only be 2, indicating B
channels 1 and 2.
D-channel information is obtained by using the command without the
optional arguments.
accounting (Optional) Displays the number of packets of each protocol type that have
been sent through the interface.
slot (Optional) Slot number. Refer to the appropriate hardware manual for slot
information.
/port (Optional) Port number. Refer to the appropriate hardware manual for port
information.
/port-adapter (Optional) Port adapter number. Refer to the appropriate hardware manual for
information about port adapter compatibility.

Command Modes Privileged EXEC

Cisco IOS Interface and Hardware Component Command Reference

IR-561
 Interface and Hardware Component Commands
show interfaces

Command History Release Modification

10.0 This command was introduced.
12.0(3)T This command was modified to include support for flow-based WRED.
12.0(4)T This command was modified to include enhanced display information for
dialer bound interfaces.
12.0(7)T This command was modified to include dialer as an interface type and to
reflect the default behavior.

Usage Guidelines Display Interpretation

The show interfaces command displays statistics for the network interfaces. The resulting display on
the Cisco 7200 series routers shows the interface processors in slot order. If you add interface processors
after booting the system, they will appear at the end of the list, in the order in which they were inserted.

Information About Specific Interfaces

If you use the show interfaces command on the Cisco 7200 series routers without the slot/port
arguments, information for all interface types will be shown. For example, if you type show interfaces
ethernet you will receive information for all ethernet, serial, Token Ring, and FDDI interfaces. Only by
adding the type slot/port argument can you specify a particular interface.

Removed Interfaces
If you enter a show interfaces command for an interface type that has been removed from the router or
access server, interface statistics will be displayed accompanied by the following text: “Hardware has
been removed.”

Weighted Fair Queueing Information

If you use the show interfaces command on a router or access server for which interfaces are configured
to use weighted fair queueing through the fair-queue interface command, additional information is
displayed. This information consists of the current and high-water mark number of flows.

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

Dialer Interfaces Configured for Binding

If you use the show interfaces command on dialer interfaces configured for binding, the display will
report statistics on each physical interface bound to the dialer interface; see the following examples for
more information.

Command Variations
You will use the show interfaces command frequently while configuring and monitoring devices. The
various forms of the show interfaces commands are described in detail in the sections that follow.

Examples 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 router or access server, only a portion of the display
is shown.

Cisco IOS Interface and Hardware Component Command Reference

IR-562
Interface and Hardware Component Commands
show interfaces

Note If an asterisk (*) appears after the throttles counter value, it means that the interface was throttled at the
time the command was run.

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 10.108.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, 57186* throttles
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
.
.
.

Example with Custom Output Queueing

The following shows partial sample output when custom output queueing is enabled:
Router# show interfaces

Last clearing of “show interface” counters 0:00:06

Input queue: 0/75/0 (size/max/drops); Total output drops: 21
Output queues: (queue #: size/max/drops)
0: 14/20/14 1: 0/20/6 2: 0/20/0 3: 0/20/0 4: 0/20/0 5: 0/20/0
6: 0/20/0 7: 0/20/0 8: 0/20/0 9: 0/20/0 10: 0/20/0
.
.
.

When custom queueing is enabled, the drops accounted for in the output queues result from bandwidth
limitation for the associated traffic and leads to queue length overflow. Total output drops include drops
on all custom queues as well as the system queue. Fields are described with the Weighted Fair Queueing
output in Table 48.

Example Including Weighted-Fair-Queueing Output

For each interface on the router or access server configured to use weighted fair queueing, the show
interfaces command displays the information beginning with Input queue: in the following display:
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 10.108.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

Cisco IOS Interface and Hardware Component Command Reference

IR-563
 Interface and Hardware Component Commands
show interfaces

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, 57186* throttles
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
Input queue: 0/75/0 (size/max/drops); Total output drops: 0
Output queue: 7/64/0 (size/threshold/drops)
Conversations 2/9 (active/max active)

Table 48 describes the input queue and output queue fields shown in the preceding two displays.

Table 48 Weighted-Fair-Queueing Output Field Descriptions

Field Description
Input queue:
• size Current size of the input queue.
• max Maximum size of the queue.
• drops Number of messages discarded in this interval.
• Total output drops Total number of messages discarded in this session.
Output queue:
• size Current size of the output queue.
• threshold Congestive-discard threshold. Number of messages in the
queue after which new messages for high-bandwidth
conversations are dropped.
• drops Number of dropped messages.
• Conversations: active Number of currently active conversations.
• Conversations: max active Maximum number of concurrent conversations allowed.

Example with Accounting Option

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.

Note Except for protocols that are encapsulated inside other protocols, such as IP over X.25, the
accounting option also shows the total of all bytes sent and received, including the MAC header. For
example, it totals the size of the Ethernet packet or the size of a packet that includes High-Level Data
Link Control (HDLC) encapsulation.

Per-packet accounting information is displayed for protocols. The following is an example of protocols
for which accounting information is displayed. This list is not inclusive of all protocols and could vary
among platforms.
• Apollo
• AppleTalk
• ARP (for IP, Apollo, Frame Relay, SMDS)
• CLNS

Cisco IOS Interface and Hardware Component Command Reference

IR-564
Interface and Hardware Component Commands
show interfaces

• DEC MOP
The routers use MOP packets to advertise their existence to Digital Equipment Corporation
machines that use the MOP protocol. A router periodically broadcasts MOP packets to identify itself
as a MOP host. This results in MOP packets being counted, even when DECnet is not being actively
used.
• DECnet
• IP
• LAN Manager (LAN Network Manager and IBM Network Manager)
• Novell
• Serial Tunnel (SDLC)
• Spanning Tree
• SR Bridge
• Transparent Bridge
• VINES
• XNS
The following is sample output from the show interfaces accounting command:
Router# show interfaces accounting

Interface TokenRing0 is disabled

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
Interface Serial0 is disabled

Ethernet1
Protocol Pkts In Chars In Pkts Out Chars Out
IP 0 0 37 11845
Novell 0 0 4591 275460
DEC MOP 0 0 1 77
ARP 0 0 7 420

Interface Serial1 is disabled

Interface Ethernet2 is disabled
Interface Serial2 is disabled
Interface Ethernet3 is disabled
Interface Serial3 is disabled
Interface Ethernet4 is disabled
Interface Ethernet5 is disabled
Interface Ethernet6 is disabled
Interface Ethernet7 is disabled
Interface Ethernet8 is disabled
Interface Ethernet9 is disabled

Fddi0
Protocol Pkts In Chars In Pkts Out Chars Out
Novell 0 0 183 11163
ARP 1 49 0 0

When the output indicates an interface is “disabled,” the router has received excessive errors (over 5000
in a keepalive period).

Cisco IOS Interface and Hardware Component Command Reference

IR-565
 Interface and Hardware Component Commands
show interfaces

The following is sample output from the show interfaces accounting command when a switched packet
is dropped:
Router# show interfaces accounting

FastEthernet0/2
Protocol Pkts In Chars In Pkts Out Chars Out
Other 0 0 9373 562380
IP 37342 21789327 954 86850
DEC MOP 0 0 158 12166
ARP 882 52920 71 4260

Interface FastEthernet1/0 is disabled

Interface FastEthernet1/1 is disabled

Protocol Pkts In Chars In Pkts Out Chars Out

No traffic sent or received on this interface

Table 49 describes the fields shown in the display.

Table 49 show interfaces accounting Field Descriptions

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

Example with DWRED

The following is sample output from the show interfaces command when distributed weighted RED
(DWRED) is enabled on an interface. Notice that the packet drop strategy is listed as “VIP-based
weighted RED.”
Router# show interfaces hssi 0/0/0

Hssi0/0/0 is up, line protocol is up

Hardware is cyBus HSSI
Description: 45Mbps to R1
Internet address is 10.200.14.250/30
MTU 4470 bytes, BW 45045 Kbit, DLY 200 usec, rely 255/255, load 1/255
Encapsulation HDLC, loopback not set, keepalive set (10 sec)
Last input 00:00:02, output 00:00:03, output hang never
Last clearing of "show interface" counters never
Queueing strategy: fifo
Packet Drop strategy: VIP-based weighted RED
Output queue 0/40, 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
1976 packets input, 131263 bytes, 0 no buffer
Received 1577 broadcasts, 0 runts, 0 giants
0 parity
4 input errors, 4 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
1939 packets output, 130910 bytes, 0 underruns
0 output errors, 0 applique, 3 interface resets
0 output buffers copied, 0 interrupts, 0 failures

Cisco IOS Interface and Hardware Component Command Reference

IR-566
Interface and Hardware Component Commands
show interfaces

Example with ALC

The following is sample output from the show interfaces command for serial interface 2 when ALC is
enabled:
Router# show interfaces serial 2

Serial2 is up, line protocol is up

Hardware is CD2430
MTU 1500 bytes, BW 115 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation ALC, loopback not set
Full-duplex enabled.
ascus in UP state: 42, 46
ascus in DOWN state:
ascus DISABLED:
Last input never, output never, output hang never
Last clearing of “show interface” counters never
Queueing strategy: fifo
Output queue 0/40, 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, 3 interface resets
0 output buffer failures, 0 output buffers swapped out
DCD=down DSR=down DTR=down RTS=down CTS=down

Example with SDLC

The following is sample output from the show interfaces command for a Synchronous Data Link
Control (SDLC) primary interface supporting the SDLC function:
Router# show interfaces

Serial 0 is up, line protocol is up

Hardware is MCI Serial
MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation SDLC-PRIMARY, loopback not set
Timers (msec): poll pause 100 fair poll 500. Poll limit 1
[T1 3000, N1 12016, N2 20, K 7] timer: 56608 Last polled device: none
SDLLC [ma: 0000.0C01.14--, ring: 7 bridge: 1, target ring: 10
largest token ring frame 2052]
SDLC addr C1 state is CONNECT
VS 6, VR 3, RCNT 0, Remote VR 6, Current retransmit count 0
Hold queue: 0/12 IFRAMEs 77/22 RNRs 0/0 SNRMs 1/0 DISCs 0/0
Poll: clear, Poll count: 0, chain: p: C1 n: C1
SDLLC [largest SDLC frame: 265, XID: disabled]
Last input 00:00:02, output 00:00:01, output hang never
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 517 bits/sec, 30 packets/sec
Five minute output rate 672 bits/sec, 20 packets/sec
357 packets input, 28382 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
926 packets output, 77274 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets, 0 restarts
2 carrier transitions

Table 50 shows the fields relevant to all SDLC connections.

Cisco IOS Interface and Hardware Component Command Reference

IR-567
 Interface and Hardware Component Commands
show interfaces

Table 50 show interfaces Field Descriptions When SDLC Is Enabled

Field Description
Timers (msec) List of timers in milliseconds.
poll pause, fair poll, Poll limit Current values of these timers, as described in the individual
commands in this chapter.
T1, N1, N2, K Current values for these variables, as described in the individual
commands in this chapter.

Table 51 shows other data given for each SDLC secondary interface configured to be attached to this
interface.

Table 51 SDLC Field Descriptions

Field Description
addr Address of this secondary interface.
State Current state of this connection. The possible values follow:
• DISCONNECT—No communication is being attempted to this
secondary.
• CONNECT—A normal connect state exists between this router and this
secondary.
• DISCSENT—This router has sent a disconnect request to this secondary
and is awaiting its response.
• SNRMSENT—This router has sent a connect request (SNRM) to this
secondary and is awaiting its response.
• THEMBUSY—This secondary has told this router that it is temporarily
unable to receive any more information frames.
• USBUSY—This router has told this secondary that it is temporarily
unable to receive any more information frames.
• BOTHBUSY—Both sides have told each other that they are temporarily
unable to receive any more information frames.
• ERROR—This router has detected an error, and is waiting for a response
from the secondary acknowledging this.
VS Sequence number of the next information frame this station sends.
VR Sequence number of the next information frame from this secondary that this
station expects to receive.
RCNT Number of correctly sequenced I-frames received when the Cisco IOS
software was in a state in which it is acceptable to receive I-frames.
Remote VR Last frame transmitted by this station that has been acknowledged by the
other station.
Current retransmit Number of times the current I-frame or sequence of I-frames has been
count retransmitted.
Hold queue Number of frames in hold queue/Maximum size of hold queue.

Cisco IOS Interface and Hardware Component Command Reference

IR-568
Interface and Hardware Component Commands
show interfaces

Table 51 SDLC Field Descriptions (continued)

Field Description
IFRAMEs, RNRs, Sent/received count for these frames.
SNRMs, DISCs
Poll “Set” if this router has a poll outstanding to the secondary; “clear” if it does
not.
Poll count Number of polls, in a row, given to this secondary at this time.
chain Shows the previous (p) and next (n) secondary address on this interface in
the round robin loop of polled devices.

Example with Flow-Based WRED

The following is sample output from the show interfaces command issued for the Serial interface 1 for
which flow-based weighted RED (WRED) is enabled. The output shows that there are 8 active
flow-based WRED flows, that the maximum number of flows active at any time is 9, and that the
maximum number of possible flows configured for the interface is 16:
Router# show interfaces serial 1
Serial1 is up, line protocol is up

Hardware is HD64570
Internet address is 10.1.2.1/24
MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec,
Reliability 255/255, txload 237/255, rxload 1/255
Encapsulation HDLC, loopback not set
Keepalive not set
Last input 00:00:22, output 00:00:00, output hang never
Last clearing of "show interface" counters 00:17:58
Input queue: 0/75/0 (size/max/drops); Total output drops: 2479

Queueing strategy: random early detection(RED)

flows (active/max active/max): 8/9/16
mean queue depth: 27
drops: class random tail min-th max-th mark-prob
0 946 0 20 40 1/10
1 488 0 22 40 1/10
2 429 0 24 40 1/10
3 341 0 26 40 1/10
4 235 0 28 40 1/10
5 40 0 31 40 1/10
6 0 0 33 40 1/10
7 0 0 35 40 1/10
rsvp 0 0 37 40 1/10
30 second input rate 1000 bits/sec, 2 packets/sec
30 second output rate 119000 bits/sec, 126 packets/sec
1346 packets input, 83808 bytes, 0 no buffer
Received 12 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
84543 packets output, 9977642 bytes, 0 underruns
0 output errors, 0 collisions, 6 interface resets
0 output buffer failures, 0 output buffers swapped out
0 carrier transitions
DCD=up DSR=up DTR=up RTS=up CTS=up

Cisco IOS Interface and Hardware Component Command Reference

IR-569
 Interface and Hardware Component Commands
show interfaces

Example with DWFQ

The following is sample output from the show interfaces command when distributed weighted fair
queueing (DWFQ) is enabled on an interface. Notice that the queueing strategy is listed as “VIP-based
fair queueing.”
Router# show interfaces fastethernet 1/1/0

Fast Ethernet 1/1/0 is up, line protocol is up

Hardware is cyBus Fast Ethernet Interface, address is 0007.f618.4448 (bia 00e0)
Description: pkt input i/f for WRL tests (to pagent)
Internet address is 10.0.2.70/24
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec, rely 255/255, load 1/255
Encapsulation ARPA, loopback not set, keepalive not set, fdx, 100BaseTX/FX
ARP type: ARPA, ARP Timeout 04:00:00
Last input never, output 01:11:01, output hang never
Last clearing of "show interface" counters 01:12:31
Queueing strategy: VIP-based fair queueing
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
30 second input rate 0 bits/sec, 0 packets/sec
30 second 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 watchdog, 0 multicast
0 input packets with dribble condition detected
1 packets output, 60 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffers copied, 0 interrupts, 0 failures

Example with DNIS Binding

When the show interfaces command is issued on an unbound dialer interface, the output looks as
follows:
Router# show interfaces dialer0

Dialer0 is up (spoofing), line protocol is up (spoofing)

Hardware is Unknown
Internet address is 10.1.1.2/8
MTU 1500 bytes, BW 64 Kbit, DLY 20000 usec, rely 255/255, load 3/255
Encapsulation PPP, loopback not set
DTR is pulsed for 1 seconds on reset
Last input 00:00:34, output never, output hang never
Last clearing of “show interface” counters 00:05:09
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 1000 bits/sec, 0 packets/sec
18 packets input, 2579 bytes
14 packets output, 5328 bytes

But when the show interfaces command is issued on a bound dialer interface, you will get an additional
report that indicates the binding relationship. The output is shown here:
Router# show interfaces dialer0

Dialer0 is up, line protocol is up

Hardware is Unknown
Internet address is 10.1.1.2/8
MTU 1500 bytes, BW 64 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation PPP, loopback not set
DTR is pulsed for 1 seconds on reset

Cisco IOS Interface and Hardware Component Command Reference

IR-570
Interface and Hardware Component Commands
show interfaces

Interface is bound to BRI0:1

Last input 00:00:38, output never, output hang never
Last clearing of “show interface” counters 00:05:36

Queueing strategy: fifo

Output queue 0/40, 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
38 packets input, 4659 bytes
34 packets output, 9952 bytes
Bound to:
BRI0:1 is up, line protocol is up
Hardware is BRI
MTU 1500 bytes, BW 64 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation PPP, loopback not set, keepalive not set
Interface is bound to Dialer0 (Encapsulation PPP)
LCP Open, multilink Open
Last input 00:00:39, output 00:00:11, output hang never
Last clearing of “show interface” counters never
Queueing strategy: fifo
Output queue 0/40, 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
78 packets input, 9317 bytes, 0 no buffer
Received 65 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
93 packets output, 9864 bytes, 0 underruns
0 output errors, 0 collisions, 7 interface resets
0 output buffer failures, 0 output buffers swapped out
4 carrier transitions

At the end of the Dialer0 output, the show interfaces command is executed on each physical interface
bound to it.

Example with BRI

In this example, the physical interface is the B1 channel of the BRI0 link. This example also illustrates
that the output under the B channel keeps all hardware counts that are not displayed under any logical
or virtual access interface. The line in the report that states “Interface is bound to Dialer0 (Encapsulation
LAPB)” indicates that this B interface is bound to Dialer0 and the encapsulation running over this
connection is LAPB, not PPP, which is the encapsulation configured on the D interface and inherited by
the B channel.
Router# show interfaces bri0:1

BRI0:1 is up, line protocol is up

Hardware is BRI
MTU 1500 bytes, BW 64 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation PPP, loopback not set, keepalive not set
Interface is bound to Dialer0 (Encapsulation LAPB)
LCP Open, multilink Open
Last input 00:00:31, output 00:00:03, output hang never
Last clearing of “show interface” counters never
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 1 packets/sec
5 minute output rate 0 bits/sec, 1 packets/sec
110 packets input, 13994 bytes, 0 no buffer
Received 91 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
135 packets output, 14175 bytes, 0 underruns
0 output errors, 0 collisions, 12 interface resets

Cisco IOS Interface and Hardware Component Command Reference

IR-571
 Interface and Hardware Component Commands
show interfaces

0 output buffer failures, 0 output buffers swapped out

8 carrier transitions

Any protocol configuration and states should be displayed from the Dialer0 interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-572
 Interface and Hardware Component Commands
show interfaces analysis-module

show interfaces analysis-module

To display status, traffic data, and configuration information about the analysis module interface, use the
show interfaces analysis-module command in user EXEC or privileged EXEC mode.

show interfaces analysis-module slot/unit

Syntax Description slot Number of the router chassis slot for the network module.
/unit Number of the daughter card on the network analysis module (NAM). For
NAM, always use 0.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

12.3(4)XD This command was introduced on the following platforms:
Cisco 2600XM series, Cisco 2691, Cisco 3660, Cisco 3725, and Cisco 3745.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T.
12.3(8)T4 This command was implemented on the following platforms: Cisco 2811,
Cisco 2821, and Cisco 2851.
12.3(11)T This command was implemented on the Cisco 3800 series.

Usage Guidelines The analysis module interface is a Fast Ethernet interface on the router that connects to the internal
interface on the Network Analysis Module (NM-NAM).

Examples The command in the following example displays status, traffic data, and configuration information about
the analysis module interface when the NM-NAM is installed in slot 2 of a Cisco 3745.
Router# show interfaces analysis-module 2/0

Network-Analyzer2/0 is up, line protocol is up

Hardware is I82559FE, address is 0001.a535.0920 (bia 0001.a535.0920)
Internet address is 10.1.1.1/24
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive set (10 sec)
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:00:26, output 00:00:00, output hang never
Last clearing of "show interface" counters never
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 4682
Queueing strategy: fifo
Output queue: 0/60 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 36000 bits/sec, 22 packets/sec
905 packets input, 38190 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants, 0 throttles

Cisco IOS Interface and Hardware Component Command Reference

IR-573
 Interface and Hardware Component Commands
show interfaces analysis-module

0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored

0 input packets with dribble condition detected
671863 packets output, 96101624 bytes, 0 underruns
0 output errors, 0 collisions, 1 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out

Table 52 describes the significant fields shown in the display.

Table 52 show interfaces analysis-module Field Descriptions

Field Description
Network-Analyzer Indicates whether the analysis module interface
hardware is currently active. The analysis module
interface is the router-side interface for the internal
Ethernet segment between the router and the NAM
network module.
If the analysis module interface hardware is
operational, the output states that the
“Network-Analyzer 1/0 is up.” If the interface has
been taken down by an administrator, the output
states that the “Network-Analyzer 1/0 is
administratively down.”
line protocol is Indicates whether the software processes that handle
the line protocol consider the line usable or whether
the line has been taken down by an administrator.
Hardware is...address is Hardware type and address.
MTU Maximum transmission unit (MTU) of the analysis
module interface.
BW Bandwidth of the interface, in kbps.
DLY Delay of the interface, in microseconds.
reliability Reliability of the interface as a fraction of 255
(255/255 is 100 percent reliability), calculated as an
exponential average over 5 minutes.
txload Transmit load on the interface as a fraction of 255
(255/255 is completely saturated), calculated as an
exponential average over 5 minutes.
rxload Receive load on the interface as a fraction of 255
(255/255 is completely saturated), calculated as an
exponential average over 5 minutes.
Encapsulation Encapsulation method assigned to the interface.
loopback Indicates whether or not loopback is set.
Keepalive Indicates whether or not keepalives are set and the
interval between keepalives if they have been set.
ARP type...ARP Timeout Type of Address Resolution Protocol (ARP)
assigned and length of timeout.

Cisco IOS Interface and Hardware Component Command Reference

IR-574
Interface and Hardware Component Commands
show interfaces analysis-module

Table 52 show interfaces analysis-module Field Descriptions (continued)

Field Description
Last input Number of hours, minutes, and seconds since the last
packet was successfully received by the interface
and processed locally on the router. This field is
useful for detecting when a dead interface failed.
Note This field is not updated by fast-switched
traffic.
output Number of hours, minutes, and seconds since the last
packet was successfully transmitted by the interface.
This field is useful for detecting when a dead
interface failed.
output hang Number of hours, minutes, and seconds (or never)
since the interface was last reset because a
transmission 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.
Asterisks (***) indicate that the elapsed time is too
large to be displayed.
Input queue Number of packets in the input queue. Each number
is followed by a slash, the maximum size of the
queue, the number of packets dropped because of a
full queue, and the number of times that queued
packets have been discarded.
Total output drops Number of packets in the output queue that have
been dropped because of a full queue.
Queueing strategy Queueing strategy applied to the interface, which is
configurable under the interface. The default is FIFO
(first-in, first-out).
Output queue Number of packets in the output queue, and the
maximum size of the queue. Each number is
followed by a slash.

Cisco IOS Interface and Hardware Component Command Reference

IR-575
 Interface and Hardware Component Commands
show interfaces analysis-module

Table 52 show interfaces analysis-module Field Descriptions (continued)

Field Description
5 minute input rate, 5 minute output rate Average number of bits and packets transmitted per
second in the last 5 minutes. If the interface is not in
promiscuous mode, it senses network traffic that it
sends and receives (rather than all network traffic).
The 5-minute input and output rates should be used
only as an approximation of traffic per second during
a given 5-minute period. These rates are
exponentially weighted averages with a time
constant of 5 minutes. A period of four time
constants must pass before the average will be
within 2 percent of the instantaneous rate of a
uniform stream of traffic over that period.
Note The 5-minute period referenced in this
output is a load interval that is configurable
under the interface. The default value is
5 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.
Received...broadcasts Number of broadcasts received.
runts Number of packets that are discarded because they
are smaller than the minimum packet size of the
medium. 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 maximum packet size of the medium. For
example, any Ethernet packet that is greater than
1518 bytes is considered a giant.
throttles Number of times that the interface requested another
interface within the router to slow down.
input errors Errors that include runts, giants, no buffer, cyclic
redundancy checksum (CRC), frame, overrun, and
ignored counts. Other input-related errors can also
cause the input errors count to be increased, and
some datagrams may have more than one error;
therefore, this sum may not balance with the sum of
enumerated input error counts.

Cisco IOS Interface and Hardware Component Command Reference

IR-576
Interface and Hardware Component Commands
show interfaces analysis-module

Table 52 show interfaces analysis-module Field Descriptions (continued)

Field Description
CRC Errors created when the CRC 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 that is
transmitting bad data.
frame Number of packets received incorrectly that have 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 that 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 that were ignored by the
interface because the interface hardware ran low on
internal buffers. These buffers are different from
system buffer space described. Broadcast storms and
bursts of noise can cause the ignored count to
increase.
input packets with dribble condition detected Number of packets with dribble condition. Dribble
bit error indicates that a frame is slightly too long.
This frame error counter is incremented just for
informational purposes; the router accepts the frame.
packets output Total number of messages that have been transmitted
by the system.
bytes Total number of bytes, including data and MAC
encapsulation, that have been transmitted by the
system.
underruns Number of times that the transmitter has run faster
than the router could 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 that is
being examined. Note that this may not balance with
the sum of the enumerated output errors, because
some datagrams may have more than one error, and
others may have errors that do not fall into any of the
specifically tabulated categories.

Cisco IOS Interface and Hardware Component Command Reference

IR-577
 Interface and Hardware Component Commands
show interfaces analysis-module

Table 52 show interfaces analysis-module Field Descriptions (continued)

Field Description
collisions Number of messages that have been retransmitted
because of 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 that were 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.
babbles Count of frames greater than 1518 bytes that have
been transmitted, indicating that the transmitter has
been on the interface longer than the time necessary
to transmit the largest frame.
late collision Number of late collisions. A collision becomes a late
collision when it occurs after the preamble has been
transmitted.
deferred Deferred indicates that the chip, while ready to
transmit a frame, had to defer because the carrier
was asserted.
lost carrier Number of times that the carrier was lost during
transmission.
no carrier Number of times that the carrier was not present
during the transmission.
output buffer failures, output buffers swapped Number of failed buffers and number of buffers
out swapped out.

Related Commands Command Description

show controllers Displays controller information for the analysis module interface.
analysis-module

Cisco IOS Interface and Hardware Component Command Reference

IR-578
 Interface and Hardware Component Commands
show interfaces content-engine

show interfaces content-engine

To display basic interface configuration information for a content engine (CE) network module, use the
show interfaces content-engine command in privileged EXEC mode.

show interfaces content-engine slot/unit

Syntax Description slot Number of the router chassis slot for the network module.
unit Number of the daughter card on the network module. For CE network
modules, always use 0.

Command Modes Privileged EXEC

Command History Release Modification

12.2(11)YT This command was introduced.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.

Usage Guidelines The output for this command contains the basic configuration for the interface, as well as the number of
packets transmitted, output rate, and so forth.

Examples The following example displays interface status and data for the CE network module in slot 1 for
Cisco 2600 series routers (except the Cisco 2691). Note that the bandwidth is 10 Mbps.
Router# show interfaces content-engine 1/0

Content-Engine1/0 is up, line protocol is up

Hardware is I82559FE, address is 0006.280e.10b0 (bia 0006.280e.10b0)
MTU 1500 bytes, BW 10000 Kbit, DLY 1000 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive set (10 sec)
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:00:50, output 00:00:04, output hang never
Last clearing of "show interface" counters never
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue :0/40 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
13 packets input, 5835 bytes, 0 no buffer
Received 13 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 input packets with dribble condition detected
71 packets output, 6285 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out

Cisco IOS Interface and Hardware Component Command Reference

IR-579
 Interface and Hardware Component Commands
show interfaces content-engine

The following example displays interface status and data for a CE network module in slot 3 of a
Cisco 2691. This example shows the 100-Mbps bandwidth of a Cisco 2691 and all the other supported
routers except the remainder of the Cisco 2600 series.
Router# show interfaces content-engine 3/0

Content-Engine3/0 is up, line protocol is up

Hardware is I82559FE, address is 0004.9a0b.4b30 (bia 0004.9a0b.4b30)
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive set (10 sec)
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:00:41, output 00:00:04, output hang never
Last clearing of "show interface" counters never
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue :0/40 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
14 packets input, 6176 bytes, 0 no buffer
Received 14 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 input packets with dribble condition detected
109 packets output, 16881 bytes, 0 underruns
0 output errors, 0 collisions, 1 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out

Table 53 describes the significant fields shown in the display.

Table 53 show interfaces content-engine Field Descriptions

Field Description
Content-Engine Indicates whether the CE interface hardware is currently active. If
the CE interface hardware is operational, the output states that
“Content-Engine slot/port is up.” If it has been taken down by an
administrator, the output states that “Content-Engine slot/port is
administratively down.”
line protocol Indicates whether the software processes that handle the line
protocol consider the line usable or whether the line has been
taken down by an administrator.
Hardware...address Hardware type and address.
MTU Maximum transmission unit (MTU) of the content engine
interface.
BW Bandwidth of the interface, in kilobits per second.
DLY Delay of the interface, in microseconds.
reliability Reliability of the interface as a fraction of 255 (255/255 is
100 percent reliability), calculated as an exponential average over
5 minutes.
txload Transmit load on the interface as a fraction of 255 (255/255 is
completely saturated), calculated as an exponential average over
5 minutes.

Cisco IOS Interface and Hardware Component Command Reference

IR-580
Interface and Hardware Component Commands
show interfaces content-engine

Table 53 show interfaces content-engine Field Descriptions (continued)

Field Description
rxload Receive load on the interface as a fraction of 255 (255/255 is
completely saturated), calculated as an exponential average over
5 minutes.
Encapsulation Encapsulation method assigned to the interface.
loopback Indicates whether loopback is set.
Keepalive Indicates whether keepalives are set and the interval between
keepalives if they have been set.
ARP type...Timeout Type of Address Resolution Protocol (ARP) assigned and length
of timeout.
Last input Number of hours, minutes, and seconds since the last packet was
successfully received by the interface and processed locally on
the router. This field is useful for detecting when a dead interface
failed.
Note This field is not updated by fast-switched traffic.
output Number of hours, minutes, and seconds since the last packet was
successfully transmitted by the interface. This field is useful for
detecting when a dead interface failed.
output hang Number of hours, minutes, and seconds (or never) since the
interface was last reset because a transmission 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.
Asterisks (***) indicate that the elapsed time is too large to be
displayed.
A time of all zeroes (0:00:00) indicates that the counters were
cleared more than 231 ms (and less than 232 ms) ago.
Input queue Number of packets in the input queue. Each number is followed
by a slash, the maximum size of the queue, the number of packets
dropped because of a full queue, and the number of times that
queued packets have been discarded.
Total output drops Number of packets in the output queue that have been dropped
because of a full queue.
Queueing strategy Queueing strategy applied to the interface, which is configurable
under the interface. The default is FIFO.
Output queue Number of packets in the output queue. Each number is followed
by a slash, the maximum size of the queue, and the number of
packets dropped because of a full queue.

Cisco IOS Interface and Hardware Component Command Reference

IR-581
 Interface and Hardware Component Commands
show interfaces content-engine

Table 53 show interfaces content-engine Field Descriptions (continued)

Field Description
5 minute input rate, Average number of bits and packets transmitted per second in the
5 minute output rate last 5 minutes. If the interface is not in promiscuous mode, it
senses network traffic that it sends and receives (rather than all
network traffic).
The 5-minute input and output rates should be used only as an
approximation of traffic per second during a given 5-minute
period. These rates are exponentially weighted averages with a
time constant of 5 minutes. A period of four time constants must
pass before the average will be within 2 percent of the
instantaneous rate of a uniform stream of traffic over that period.
Note The 5-minute period referenced in this output is a load
interval that is configurable under the interface. The
default value is 5 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.
Received...broadcasts Number of broadcasts received.
runts Number of packets that are discarded because they are smaller
than the minimum packet size of the medium. 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
maximum packet size of the medium. For example, any Ethernet
packet that is greater than 1518 bytes is considered a giant.
throttles Number of times that the interface requested another interface
within the router to slow down.
input errors Errors that include runts, giants, no buffer, cyclic redundancy
check (CRC), frame, overrun, and ignored counts. Other
input-related errors can also cause the input errors count to be
increased, and some datagrams may have more than one error;
therefore, this sum may not balance with the sum of enumerated
input error counts.
CRC Errors created when the CRC 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 that is transmitting bad data.
frame Number of packets received incorrectly that have a CRC error and
a non integer number of octets. On a LAN, this is usually the
result of collisions or a malfunctioning Ethernet device.

Cisco IOS Interface and Hardware Component Command Reference

IR-582
Interface and Hardware Component Commands
show interfaces content-engine

Table 53 show interfaces content-engine Field Descriptions (continued)

Field Description
overrun Number of times that 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 that were ignored by the interface
because the interface hardware ran low on internal buffers. These
buffers are different from system buffer space described.
Broadcast storms and bursts of noise can cause the ignored count
to increase.
input packets with dribble Number of packets with dribble condition. Dribble bit error
condition detected indicates that a frame is slightly too long. This frame error
counter is incremented just for informational purposes; the router
accepts the frame.
packets output Total number of messages that have been transmitted by the
system.
bytes Total number of bytes, including data and MAC encapsulation,
that have been transmitted by the system.
underruns Number of times that the transmitter has run faster than the router
could 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 content engine that is being examined. Note
that this may not balance with the sum of the enumerated output
errors, because some datagrams may have more than one error,
and others may have errors that do not fall into any of the
specifically tabulated categories.
collisions Number of messages that have been retransmitted because of 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 that were 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.
babbles Count of frames greater than 1518 bytes that have been
transmitted, indicating that the transmitter has been on the
interface longer than the time necessary to transmit the largest
frame.
late collision Number of late collisions. A collision becomes a late collision
when it occurs after the preamble has been transmitted.

Cisco IOS Interface and Hardware Component Command Reference

IR-583
 Interface and Hardware Component Commands
show interfaces content-engine

Table 53 show interfaces content-engine Field Descriptions (continued)

Field Description
deferred Deferred indicates that the chip, while ready to transmit a frame,
had to defer because the carrier was asserted.
lost carrier Number of times that the carrier was lost during transmission.
no carrier Number of times that the carrier was not present during the
transmission.
output buffer failures, Number of failed buffers and number of buffers swapped out.
output buffers swapped out

Related Commands Command Description

interface content-engine Configures an interface for a CE network module and enters
interface configuration mode.
show controllers content-engine Displays controller information for CE network modules.

Cisco IOS Interface and Hardware Component Command Reference

IR-584
 Interface and Hardware Component Commands
show interfaces ctunnel

show interfaces ctunnel

To display information about an IP over Connectionless Network service (CLNS) tunnel (CTunnel), use
the show interfaces ctunnel command in privileged EXEC mode.

show interfaces ctunnel interface-number [accounting]

Syntax Description interface-number Virtual interface number.

accounting (Optional) Displays the number of packets of each protocol type that have been
sent through the interface.

Command Modes Privileged EXEC

Command History Release Modification

12.1(5)T This command was introduced.

Usage Guidelines For the show interfaces ctunnel command, all output that relates to a physical medium is irrelevant and
should be ignored because the CTunnel is a virtual interface.

Examples The following is sample output from the show interfaces ctunnel command:
Router# show interfaces ctunnel 1

CTunnel1 is up, line protocol is up

Hardware is CTunnel
Internet address is 10.0.0.1/24
MTU 1514 bytes, BW 9 Kbit, DLY 500000 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation TUNNEL, loopback not set
Keepalive set (10 sec)
Tunnel destination 49.0001.2222.2222.2222.cc
Last input never, output 00:00:05, output hang never
Last clearing of “show interface” counters never
Queueing strategy: fifo
Output queue 0/0, 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 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
1 packets output, 104 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 output buffer failures, 0 output buffers swapped out

Table 54 describes the significant fields shown in the display.

Cisco IOS Interface and Hardware Component Command Reference

IR-585
 Interface and Hardware Component Commands
show interfaces ctunnel

Table 54 show interfaces ctunnel Field Descriptions

Field Description
CTunnel is {up | down | Interface is currently active (up) or inactive (down). Shows interface is
administratively down} administratively down if disabled.
line protocol is {up | down} Shows line protocol up if a valid route is available to the CLNS tunnel
(CTunnel) destination. Shows line protocol down if no route is available,
or if the route would be recursive.
Hardware Type of interface, in this instance CTunnel.
Internet address IP address of the interface.
MTU Maximum transmission unit of the interface.
BW Bandwidth, as specified by the user, that is available on the link.
DLY Delay of the interface, in microseconds.
Encapsulation Encapsulation method is always TUNNEL for tunnels.
Loopback Shows whether loopback is set or not.
Keepalive Shows whether keepalives are set or not.
Tunnel destination The NSAP address of the tunnel destination. The N-Selector part of the
displayed NSAP address is set by the router and cannot be changed.
Last input Number of hours, minutes, and seconds since the last packet was
successfully received by an interface. This counter is updated only when
packets are process-switched, not when packets are fast-switched.
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 that the elapsed time is too large to be displayed.
0:00:00 indicates that the counters were cleared more than 231 ms (and
less than 232 ms) ago.
Queueing strategy Type of queueing active on this interface.
Output queue, drops Number of packets in output and input queues. Each number is followed
Input queue, drops by a slash, the maximum size of the queue, and the number of packets
dropped because of a full queue.
Five minute input rate, Average number of bits and packets transmitted per second in the last
Five minute output rate 5 minutes.
The 5-minute input and output rates should be used only as an
approximation of traffic per second during a given 5-minute period.
These rates are exponentially weighted averages with a time constant of
5 minutes. A period of 4 time constants must pass before the average
will be within 2 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 in the error-free packets received by the system.
no buffer Number of received packets discarded because there was no memory
buffer available.

Cisco IOS Interface and Hardware Component Command Reference

IR-586
 Interface and Hardware Component Commands
show interfaces ctunnel

Table 54 show interfaces ctunnel Field Descriptions (continued)

Field Description
broadcasts Total number of broadcast or multicast packets received by the interface.
runts This field does not apply to the CTunnel virtual interface.
giants This field does not apply to the CTunnel virtual interface.
throttles This field does not apply to the CTunnel virtual interface.
input errors This field does not apply to the CTunnel virtual interface.
CRC This field does not apply to the CTunnel virtual interface.
frame This field does not apply to the CTunnel virtual interface.
overrun This field does not apply to the CTunnel virtual interface.
ignored This field does not apply to the CTunnel virtual interface.
abort This field does not apply to the CTunnel virtual interface.
packets output Total number of messages transmitted by the system.
bytes Total number of bytes transmitted by the system.
underruns This field does not apply to the CTunnel virtual interface.
output errors This field does not apply to the CTunnel virtual interface.
collisions This field does not apply to the CTunnel virtual interface.
interface resets Number of times an interface has been reset. The interface may be reset
manually by the administrator or automatically by the system when an
internal error occurs.
output buffer failures Number of buffer failures.
output buffers swapped out Number of output buffer allocation failures.

Related Commands Command Description

show interfaces Displays the statistical information specific to interfaces.

Cisco IOS Interface and Hardware Component Command Reference

IR-587
 Interface and Hardware Component Commands
show interfaces ethernet

show interfaces ethernet

To display information about an Ethernet interface on the router, use the show interfaces ethernet
command in privileged EXEC mode.

Standard Syntax

show interfaces ethernet [number] [accounting]

Cisco 7200 and 7500 Series

show interfaces ethernet [slot/port] [accounting]

Cisco 7500 Series with Ports on VIPs

show interfaces ethernet [slot/port-adapter/port]

Syntax Description number (Optional) Port number on the selected interface.

accounting (Optional) Displays the number of packets of each protocol type that have been
sent through the interface.
slot (Optional) Slot number. Refer to the appropriate hardware manual for slot and
port information.
/port (Optional) Port number. Refer to the appropriate hardware manual for slot and
port information.
/port-adapter (Optional) Port adapter number. Refer to the appropriate hardware manual for
information about port adapter compatibility.

Command Modes Privileged EXEC

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines If you do not provide values for the number argument (or slot, port, and port-adapter arguments), the
command displays 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.

Examples The following is sample output from the show interfaces ethernet command for Ethernet interface 0:
Router# show interfaces ethernet 0

Ethernet0 is up, line protocol is up

Hardware is Lance, address is 0060.3ef1.702b (bia 0060.3ef1.702b)
Internet address is 172.21.102.33/24
MTU 1500 bytes, BW 10000 Kbit, DLY 1000 usec, rely 255/255, load 1/255
Encapsulation ARPA, loopback not set, keepalive set (10 sec)

Cisco IOS Interface and Hardware Component Command Reference

IR-588
Interface and Hardware Component Commands
show interfaces ethernet

ARP type: ARPA, ARP Timeout 04:00:00

Last input 00:00:20, output 00:00:06, output hang never
Last clearing of "show interface" counters never
Queueing strategy: fifo
Output queue 0/40, 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
115331 packets input, 27282407 bytes, 0 no buffer
Received 93567 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 input packets with dribble condition detected
143782 packets output, 14482169 bytes, 0 underruns
0 output errors, 1 collisions, 5 interface resets
0 babbles, 0 late collision, 7 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out

Table 55 describes significant fields shown in the display.

Table 55 show interfaces ethernet Field Descriptions

Field Description
Ethernet ... is up ... is Indicates whether the interface hardware is currently active and if it has
administratively down been taken down by an administrator. “Disabled” indicates the router 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
administratively down} 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, cBus Ethernet) and
address.
Internet address Internet 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 percent
reliability), calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely
saturated), calculated as an exponential average over 5 minutes.
Encapsulation Encapsulation method assigned to interface.
ARP type: Type of Address Resolution Protocol assigned.
loopback Indicates whether loopback is set or not.
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 and processed locally on the router.
Useful for knowing when a dead interface failed. This counter is updated
only when packets are process-switched, not when packets are
fast-switched.

Cisco IOS Interface and Hardware Component Command Reference

IR-589
 Interface and Hardware Component Commands
show interfaces ethernet

Table 55 show interfaces ethernet Field Descriptions (continued)

Field Description
Last output Number of hours, minutes, and seconds since the last packet was
successfully transmitted by an interface. This counter is updated only
when packets are process-switched, not when packets are fast-switched.
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.
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 231 ms (and less
than 232 ms) ago.
Output queue, input queue, Number of packets in output and input queues. Each number is followed
drops by a slash, the maximum size of the queue, and the number of packets
dropped because of a full queue.
5 minute input rate, Average number of bits and packets transmitted per second in the last
5 minute output rate 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 input Total number of bytes, including data and MAC encapsulation, in the
error-free packets received by the system.
no buffers Number of received packets discarded because there was no buffer space
in the main system. Compare with ignored count. Broadcast storms on
Ethernet networks 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
minimum packet size of the medium. 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 maximum
packet size of the medium. For example, any Ethernet packet that is
greater than 1518 bytes is considered a giant.

Cisco IOS Interface and Hardware Component Command Reference

IR-590
Interface and Hardware Component Commands
show interfaces ethernet

Table 55 show interfaces ethernet Field Descriptions (continued)

Field Description
input error 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 may have more than one error;
therefore, this sum may not balance with the sum of enumerated input
error counts.
CRC 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.
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.
input packets with dribble Dribble bit error indicates that a frame is slightly too long. This frame
condition detected error counter is incremented just for informational purposes; the router
accepts the frame.
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
router 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 may not balance with the
sum of the enumerated output errors, as some datagrams may have more
than one error, and others may have errors that do not fall into any of the
specifically tabulated categories.
collisions Number of messages transmitted because of an Ethernet collision. 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. 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.

Cisco IOS Interface and Hardware Component Command Reference

IR-591
 Interface and Hardware Component Commands
show interfaces ethernet

Table 55 show interfaces ethernet Field Descriptions (continued)

Field Description
restarts Number of times a Type 2 Ethernet controller was restarted because of
errors.
babbles The transmit jabber timer expired.
late collision Number of late collisions. Late collision happens when a collision
occurs after transmitting the preamble. The most common cause of late
collisions is that your Ethernet cable segments are too long for the speed
at which you are transmitting.
deferred Deferred indicates that the chip had to defer while ready to transmit a
frame because the carrier was asserted.
lost carrier Number of times the carrier was lost during transmission.
no carrier Number of times the carrier was not present during the transmission.
output buffer failures Number of failed buffers and number of buffers swapped out.

Example on Cisco 7500 Series Routers

The following sample output illustrates the show interfaces ethernet command on a Cisco 7500 series
router:
Router# show interfaces ethernet 4/2

Ethernet4/2 is up, line protocol is up

Hardware is cxBus Ethernet, address is 0000.0c02.d0ce (bia 0000.0c02.d0ce)
Internet address is 10.108.7.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, ARP Timeout 4:00:00
Last input 0:00:00, output 0:00:09, output hang never
Last clearing of “show interface” counters 0:56:40
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 3000 bits/sec, 4 packets/sec
Five minute output rate 0 bits/sec, 0 packets/sec
4961 packets input, 715381 bytes, 0 no buffer
Received 2014 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
567 packets output, 224914 bytes, 0 underruns
0 output errors, 168 collisions, 0 interface resets, 0 restarts
0 babbles, 2 late collision, 7 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out

Example with Accounting Option

The following is sample output from the show interfaces ethernet command with the accounting
option on a Cisco 7500 series router:
Router# show interfaces ethernet 4/2 accounting

Ethernet4/2
Protocol Pkts In Chars In Pkts Out Chars Out
IP 7344 4787842 1803 1535774
Appletalk 33345 4797459 12781 1089695
DEC MOP 0 0 127 9779
ARP 7 420 39 2340
Table 56 describes the fields shown in the display.

Cisco IOS Interface and Hardware Component Command Reference

IR-592
Interface and Hardware Component Commands
show interfaces ethernet

Table 56 show interfaces ethernet Field Descriptions—Accounting

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

Cisco IOS Interface and Hardware Component Command Reference

IR-593
 Interface and Hardware Component Commands
show interfaces fastethernet

show interfaces fastethernet

To display information about the Fast Ethernet interfaces, use the show interfaces fastethernet
command in user EXEC or privileged EXEC mode.

Standard Syntax

show interfaces fastethernet [number]

Cisco 7200 and Cisco 7500 Series

show interfaces fastethernet [slot/port]

Cisco 7500 Series with a VIP

show interfaces fastethernet [slot/port-adapter/port]

Syntax Description number (Optional) Port, connector, or interface card number. On a Cisco 4700 series
routers, specifies the network interface module (NIM) or NPM number. The
numbers are assigned at the factory at the time of installation or when added
to a system.
slot (Optional) Slot number. Refer to the appropriate hardware manual for slot and
port information.
port (Optional) Port number. Refer to the appropriate hardware manual for slot and
port information.
port-adapter (Optional) Port adapter number. Refer to the appropriate hardware manual for
information about port adapter compatibility.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

11.2 This command was introduced.

Examples The following is sample output from the show interfaces fastethernet command on a Cisco 4700 series
router:
Router# show interfaces fastethernet 0

Fast Ethernet0 is up, line protocol is up

Hardware is DEC21140, address is 0000.0c0c.1111 (bia 0002.eaa3.5a60)
Internet address is 10.0.0.1 255.0.0.0
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec, rely 255/255, load 1/255
Encapsulation ARPA, loopback not set, keepalive not set, hdx, 100BaseTX
ARP type: ARPA, ARP Timeout 4:00:00
Last input never, output 0:00:16, output hang 0:28:01
Last clearing of “show interface” counters 0:20:05
Output queue 0/40, 0 drops; input queue 0/75, 0 drops

Cisco IOS Interface and Hardware Component Command Reference

IR-594
Interface and Hardware Component Commands
show interfaces fastethernet

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, 1786161921 ignored, 0 abort
0 watchdog, 0 multicast
0 input packets with dribble condition detected
67 packets output, 8151 bytes, 0 underruns
0 output errors, 0 collisions, 1 interface resets, 0 restarts
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out

The following is sample output from the show interfaces fastethernet command on a Cisco AS5300
access server:
Router# show interfaces fastethernet 0

Fast Ethernet0 is up, line protocol is up

Hardware is DEC21140AD, address is 00e0.1e3e.c179 (bia 00e0.1e3e.c179)
Internet address is 10.17.30.4/16
MTU 1500 bytes, BW 10000 Kbit, DLY 1000 usec, rely 255/255, load 1/255
Encapsulation ARPA, loopback not set, keepalive set (10 sec)
Half-duplex, 10Mb/s, 100BaseTX/FX
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:00:00, output 00:00:03, output hang never
Last clearing of "show interface" counters never
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/120, 8 drops
5 minute input rate 2000 bits/sec, 3 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
158773 packets input, 17362631 bytes, 4 no buffer
Received 158781 broadcasts, 0 runts, 0 giants, 7 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 watchdog, 0 multicast
0 input packets with dribble condition detected
6299 packets output, 622530 bytes, 0 underruns
1 output errors, 0 collisions, 3 interface resets
0 babbles, 0 late collision, 0 deferred
1 lost carrier, 1 no carrier
0 output buffer failures, 0 output buffers swapped out

The following shows information specific to the first Fast Ethernet Interface Processor (FEIP) port in
slot 0 on a Cisco 7500 series router:
Router# show interfaces fastethernet 0/1

Fast Ethernet0/1 is administratively down, line protocol is down

Hardware is cxBus Fast Ethernet, address is 0000.0c35.dc16 (bia 0000.0c35.dc16)
Internet address is 10.1.0.64 255.255.0.0
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec, rely 255/255, load 1/255
Encapsulation ARPA, loopback not set, keepalive not set, half-duplex, RJ45 (or MII)
ARP type: ARPA, ARP Timeout 4:00:00
Last input never, output 2:03:52, output hang never
Last clearing of "show interface" counters never
Output queue 0/40, 0 drops; input queue 0/75, 1 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 watchdog, 0 multicast
0 input packets with dribble condition detected
5 packets output, 805 bytes, 0 underruns

Cisco IOS Interface and Hardware Component Command Reference

IR-595
 Interface and Hardware Component Commands
show interfaces fastethernet

0 output errors, 0 collisions, 4 interface resets, 0 restarts

0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out

Table 57 describes the fields shown in these displays.

Table 57 show interfaces fastethernet Field Descriptions

Field Description
Fast Ethernet0 is ... is up Indicates whether the interface hardware is currently active and if it has
...is administratively down been taken down by an administrator.
line protocol is Indicates whether the software processes that handle the line protocol
consider the line usable or if it has been taken down by an administrator.
Hardware Hardware type (for example, MCI Ethernet, SCI, cBus Ethernet) and
address.
Internet address Internet 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 percent
reliability), calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely
saturated), calculated as an exponential average over 5 minutes.
Encapsulation Encapsulation method assigned to interface.
ARP type Type of Address Resolution Protocol assigned.
loopback Indicates whether loopback is set or not.
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 and processed locally on the router.
Useful for knowing when a dead interface failed. This counter is updated
only when packets are process-switched, not when packets are
fast-switched.
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. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
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.

Cisco IOS Interface and Hardware Component Command Reference

IR-596
Interface and Hardware Component Commands
show interfaces fastethernet

Table 57 show interfaces fastethernet Field Descriptions (continued)

Field Description
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 231 ms (and less
than 232 ms) ago.
Output queue, input queue, Number of packets in output and input queues. Each number is followed
drops by a slash, the maximum size of the queue, and the number of packets
dropped because of a full queue.
5 minute input rate, Average number of bits and packets transmitted per second in the last
5 minute output rate 5 minutes. If the interface is not in promiscuous mode, it senses network
traffic it sends and receives (rather than all network traffic).
The 5-minute input and output rates should be used only as an
approximation of traffic per second during a given 5-minute period.
These rates are exponentially weighted averages with a time constant of
5 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
minimum packet size of the medium. 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 maximum
packet size of the medium. For example, any Ethernet packet that is
greater than 1518 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 may have more than one error;
therefore, this sum may not balance with the sum of enumerated input
error counts.
CRC 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.

Cisco IOS Interface and Hardware Component Command Reference

IR-597
 Interface and Hardware Component Commands
show interfaces fastethernet

Table 57 show interfaces fastethernet Field Descriptions (continued)

Field Description
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.
watchdog Number of times watchdog receive timer expired. It happens when
receiving a packet with length greater than 2048.
multicast Number of multicast packets received.
input packets with dribble Dribble bit error indicates that a frame is slightly too long. This frame
condition detected error counter is incremented just for informational purposes; the router
accepts the frame.
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
router 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 may not balance with the
sum of the enumerated output errors, as some datagrams may have more
than one error, and others may have errors that do not fall into any of the
specifically tabulated categories.
collisions Number of messages retransmitted because of an Ethernet collision. 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. 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.
babbles The transmit jabber timer expired.

Cisco IOS Interface and Hardware Component Command Reference

IR-598
Interface and Hardware Component Commands
show interfaces fastethernet

Table 57 show interfaces fastethernet Field Descriptions (continued)

Field Description
late collision Number of late collisions. Late collision happens when a collision
occurs after transmitting the preamble. The most common cause of late
collisions is that your Ethernet cable segments are too long for the speed
at which you are transmitting.
deferred Deferred indicates that the chip had to defer while ready to transmit a
frame because the carrier was asserted.
lost carrier Number of times the carrier was lost during transmission.
no carrier Number of times the carrier was not present during the transmission.
output buffer failures Number of failed buffers and number of buffers swapped out.

The following example of the show interfaces fastethernet command shows all the information specific
to the first PA-12E/2FE interface port (interface port 0) in port adapter slot 3:
Router# show interfaces fastethernet 3/0

Fast Ethernet3/0 is up, line protocol is up

Hardware is TSWITCH, address is 00e0.f7a4.5130 (bia 00e0.f7a4.5130)
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec, rely 255/255, load 1/255
Encapsulation ARPA, loopback not set, keepalive set (10 sec)
Half-duplex, 100BaseTX
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:05:30, output 00:00:00, output hang never
Last clearing of “show interface” counters never
Queueing strategy: fifo
Output queue 0/40, 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
312 packets input, 18370 bytes, 0 no buffer
Received 216 broadcasts, 0 runts, 0 giants, 0 throttles
3 input errors, 0 CRC, 0 frame, 0 overrun, 3 ignored, 0 abort
0 input packets with dribble condition detected
15490 packets output, 1555780 bytes, 0 underruns
2 output errors, 0 collisions, 2 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
2 output buffer failures, 0 output buffers swapped out

Table 58 describes the fields shown in this display.

Table 58 show interfaces fastethernet Field Descriptions—PA-12E/2FE

Field Description
Fast Ethernet... is up Indicates whether the interface hardware is currently active and if it
...is administratively down has been taken down by an administrator.
line protocol is Indicates whether the software processes that handle the line protocol
consider the line usable or if it has been taken down by an
administrator.
Hardware Hardware type (for example, MCI Ethernet, SCI, cBus Ethernet) and
address.
Internet address Internet address followed by subnet mask.

Cisco IOS Interface and Hardware Component Command Reference

IR-599
 Interface and Hardware Component Commands
show interfaces fastethernet

Table 58 show interfaces fastethernet Field Descriptions—PA-12E/2FE (continued)

Field Description
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 percent
reliability), calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely
saturated), calculated as an exponential average over 5 minutes.
Encapsulation Encapsulation method assigned to interface.
ARP type Type of Address Resolution Protocol assigned.
loopback Indicates whether loopback is set or not.
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 and processed locally on the
router. Useful for knowing when a dead interface failed. This counter
is updated only when packets are process-switched, not when packets
are fast-switched.
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.
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 231 ms (and less
than 232 ms) ago.
Output queue, input queue, Number of packets in output and input queues. Each number is
drops followed by a slash, the maximum size of the queue, and the number
of packets dropped because of a full queue.

Cisco IOS Interface and Hardware Component Command Reference

IR-600
Interface and Hardware Component Commands
show interfaces fastethernet

Table 58 show interfaces fastethernet Field Descriptions—PA-12E/2FE (continued)

Field Description
5 minute input rate, Average number of bits and packets transmitted per second in the last
5 minute output rate 5 minutes. If the interface is not in promiscuous mode, it senses
network traffic it sends and receives (rather than all network traffic).
The 5-minute input and output rates should be used only as an
approximation of traffic per second during a given 5-minute period.
These rates are exponentially weighted averages with a time constant
of 5 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 minimum packet size of the medium. 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
maximum packet size of the medium. For example, any Ethernet
packet that is greater than 1518 bytes is considered a giant.
throttles Number of times the receiver on the port was disabled, possibly
because of buffer or processor overload.
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 may have more than one error;
therefore, this sum may not balance with the sum of enumerated input
error counts.
CRC 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.
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.

Cisco IOS Interface and Hardware Component Command Reference

IR-601
 Interface and Hardware Component Commands
show interfaces fastethernet

Table 58 show interfaces fastethernet Field Descriptions—PA-12E/2FE (continued)

Field Description
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.
input packets with dribble Dribble bit error indicates that a frame is slightly too long. This frame
condition detected error counter is incremented for informational purposes; the router
accepts the frame.
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
router 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 may not balance
with the sum of the enumerated output errors, as some datagrams may
have more than one error, and others may have errors that do not fall
into any of the specifically tabulated categories.
collisions Number of messages retransmitted because of an Ethernet collision. 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. 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.
babbles Transmit jabber timer expired.
late collision Number of late collisions. Late collision happens when a collision
occurs after transmitting the preamble. The most common cause of
late collisions is that your Ethernet cable segments are too long for the
speed at which you are transmitting.
deferred Deferred indicates that the chip had to defer while ready to transmit a
frame because the carrier was asserted.
lost carrier Number of times the carrier was lost during transmission.
no carrier Number of times the carrier was not present during the transmission.

Cisco IOS Interface and Hardware Component Command Reference

IR-602
 Interface and Hardware Component Commands
show interfaces fddi

show interfaces fddi

To display information about the FDDI interface, use the show interfaces fddi command in user EXEC
or privileged EXEC mode.

Standard Syntax

show interfaces fddi number [accounting]

Cisco 7000 and Cisco 7200 Series

show interfaces fddi [slot/port] [accounting]

Cisco 7500 Series

show interfaces fddi [slot/port-adapter/port] [accounting]

Syntax Description number Port number on the selected interface.

accounting (Optional) Displays the number of packets of each protocol type that have been
sent through the interface.
slot (Optional) Slot number. Refer to the appropriate hardware manual for slot and
port information.
port (Optional) Port number. Refer to the appropriate hardware manual for slot and
port information.
port-adapter (Optional) Port adapter number. Refer to the appropriate hardware manual for
information about port adapter compatibility.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

10.0 This command was introduced.
11.3 This command was modified to include support for FDDI full-duplex,
single- and multimode port adapters (PA-F/FD-SM and PA-F/FD-MM).

Examples The following is a sample partial display of FDDI-specific data from the show interfaces fddi command
on a Cisco 7500 series router:
Router# show interfaces fddi 3/0/0

Fddi3/0/0 is up, line protocol is up

Hardware is cxBus Fddi, address is 0000.0c02.adf1 (bia 0000.0c02.adf1)
Internet address is 10.108.33.14, subnet mask is 255.255.255.0
MTU 4470 bytes, BW 100000 Kbit, DLY 100 usec, rely 255/255, load 1/255
Encapsulation SNAP, loopback not set, keepalive not set
ARP type: SNAP, ARP Timeout 4:00:00
Phy-A state is active, neighbor is B, cmt signal bits 008/20C, status ILS

Cisco IOS Interface and Hardware Component Command Reference

IR-603
 Interface and Hardware Component Commands
show interfaces fddi

Phy-B state is active, neighbor is A, cmt signal bits 20C/008, status ILS
ECM is in, CFM is thru, RMT is ring_op
Token rotation 5000 usec, ring operational 21:32:34
Upstream neighbor 0000.0c02.ba83, downstream neighbor 0000.0c02.ba83
Last input 0:00:05, output 0:00:00, output hang never
Last clearing of “show interface” counters 0:59:10
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 69000 bits/sec, 44 packets/sec
Five minute output rate 0 bits/sec, 1 packets/sec
113157 packets input, 21622582 bytes, 0 no buffer
Received 276 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
4740 packets output, 487346 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets, 0 restarts
0 transitions, 2 traces, 3 claims, 2 beacons

The following is sample output from the show interfaces fddi command for the full-duplex FDDI port
adapter on a Cisco 7500 series router:
Router# show interfaces fddi 0/1/0

Fddi0/1/0 is up, line protocol is up

Hardware is cxBus FDDI, address is 0060.3e33.3608 (bia 0060.3e33.3608)
Internet address is 10.1.1.1/24
MTU 4470 bytes, BW 100000 Kbit, DLY 100 usec, rely 255/255, load 1/255
Encapsulation SNAP, loopback not set, keepalive not set
ARP type: SNAP, ARP Timeout 04:00:00
FDX supported, FDX enabled, FDX state is operation
Phy-A state is maintenance, neighbor is Unknown, status HLS
Phy-B state is active, neighbor is A, status SILS
ECM is in, CFM is c_wrap_b, RMT is ring_op,
Requested token rotation 5000 usec, negotiated 4997 usec
Configured tvx is 2500 usec
LER for PortA = 0A, LER for PortB = 0A ring operational 00:02:45
Upstream neighbor 0060.3e73.4600, downstream neighbor 0060.3e73.4600
Last input 00:00:12, output 00:00:13, output hang never
Last clearing of “show interface” counters never
Queueing strategy: fifo
Output queue 0/40, 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
62 packets input, 6024 bytes, 0 no buffer
Received 18 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
71 packets output, 4961 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
3 transitions, 0 traces, 100 claims, 0 beacon

Table 59 describes the fields shown in the display.

Table 59 show interfaces fddi Field Descriptions

Field Description
Fddi is {up | down | Gives the interface processor unit number and tells whether the interface
administratively down hardware is currently active and can transmit and receive or if it has been
taken down by an administrator.
line protocol is {up | Indicates whether the software processes that handle the line protocol
down} consider the interface usable.
Hardware Provides the hardware type, followed by the hardware address.

Cisco IOS Interface and Hardware Component Command Reference

IR-604
Interface and Hardware Component Commands
show interfaces fddi

Table 59 show interfaces fddi Field Descriptions (continued)

Field Description
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 percent
reliability), calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely
saturated), calculated as an exponential average over 5 minutes.
Encapsulation Encapsulation method assigned to interface.
loopback Indicates whether or not loopback is set.
keepalive Indicates whether or not keepalives are set.
ARP type Type of Address Resolution Protocol assigned.
FDX Displays full-duplex information. Values are: not supported or supported.
When the value is supported, the display indicates whether full-duplex is
enabled or disabled. When enabled, the state of the FDX negotiation
process is displayed. The negotiation states only relate to the full-duplex
negotiation process. You must also ensure that the interface is up and
working by looking at other fields in the show interfaces fddi command
such as line protocol and RMT. Negotiation states are:
• idle—Interface is working but not in full-duplex mode yet. If
persistent, it could mean that the interface did not meet all
negotiation conditions (for example, there are more than two stations
in the ring).
• request—Interface is working but not in full-duplex mode yet. If
persistent, it could mean that the remote interface does not support
full-duplex or full-duplex is not enabled on the interface.
• confirm—Transient state.
• operation—Negotiations completed successfully, and both stations
are operating in full-duplex mode.
Phy-{A | B} Lists the state the Physical A or Physical B connection is in; one of the
following: off, active, trace, connect, next, signal, join, verify, or break.

Cisco IOS Interface and Hardware Component Command Reference

IR-605
 Interface and Hardware Component Commands
show interfaces fddi

Table 59 show interfaces fddi Field Descriptions (continued)

Field Description
neighbor State of the neighbor:
• A—Indicates that the connection management (CMT) process has
established a connection with its neighbor. The bits received during
the CMT signaling process indicate that the neighbor is a Physical A
type dual attachment station (DAS) or concentrator that attaches to
the primary ring IN and the secondary ring OUT when attaching to
the dual ring.
• S—Indicates that the CMT process has established a connection with
its neighbor and that the bits received during the CMT signaling
process indicate that the neighbor is one Physical type in a single
attachment station (SAS).
• B—Indicates that the CMT process has established a connection with
its neighbor and that the bits received during the CMT signaling
process indicate that the neighbor is a Physical B dual attachment
station or concentrator that attaches to the secondary ring IN and the
primary ring OUT when attaching to the dual ring.
• M—Indicates that the CMT process has established a connection
with its neighbor and that the bits received during the CMT signaling
process indicate that the router’s neighbor is a Physical M-type
concentrator serving as a Master to a connected station or
concentrator.
• unk—Indicates that the network server has not completed the CMT
process and, as a result, does not know about its neighbor. See the
section “Setting Bit Control” for an explanation of the bit patterns.
cmt signal bits Shows the transmitted/received CMT bits. The transmitted bits are 0x008
for a Physical A type and 0x20C for Physical B type. The number after
the slash (/) is the received signal bits. If the connection is not active, the
received bits are zero (0); see the line beginning Phy-B in the display.
This applies to FIP interfaces only.

Cisco IOS Interface and Hardware Component Command Reference

IR-606
Interface and Hardware Component Commands
show interfaces fddi

Table 59 show interfaces fddi Field Descriptions (continued)

Field Description
status Status value displayed is the actual status on the fiber. The FDDI standard
defines the following values:
• LSU—Line State Unknown, the criteria for entering or remaining in
any other line state have not been met.
• NLS—Noise Line State is entered upon the occurrence of 16
potential noise events without satisfying the criteria for entry into
another line state.
• MLS—Master Line State is entered upon the receipt of eight or nine
consecutive HQ or QH symbol pairs.
• ILS—Idle Line State is entered upon receipt of four or five idle
symbols.
• HLS—Halt Line State is entered upon the receipt of 16 or
17 consecutive H symbols.
• QLS—Quiet Line State is entered upon the receipt of 16 or
17 consecutive Q symbols or when carrier detect goes low.
• ALS—Active Line State is entered upon receipt of a JK symbol pair
when carrier detect is high.
• OVUF—Elasticity buffer Overflow/Underflow. The normal states for
a connected Physical type are ILS or ALS. If the report displays the
QLS status, this indicates that the fiber is disconnected from Physical
B, or that it is not connected to another Physical type, or that the other
station is not running.
ECM is... ECM is the SMT entity coordination management, which overlooks the
operation of CFM and PCM. The ECM state can be one of the following:
• out—Router is isolated from the network.
• in—Router is actively connected to the network. This is the normal
state for a connected router.
• trace—Router is trying to localize a stuck beacon condition.
• leave—Router is allowing time for all the connections to break before
leaving the network.
• path_test—Router is testing its internal paths.
• insert—Router is allowing time for the optical bypass to insert.
• check—Router is making sure optical bypasses switched correctly.
• deinsert—Router is allowing time for the optical bypass to deinsert.

Cisco IOS Interface and Hardware Component Command Reference

IR-607
 Interface and Hardware Component Commands
show interfaces fddi

Table 59 show interfaces fddi Field Descriptions (continued)

Field Description
CFM is... Contains information about the current state of the MAC connection. The
Configuration Management state can be one of the following:
• isolated—MAC is not attached to any Physical type.
• wrap_a—MAC is attached to Physical A. Data is received on
Physical A and transmitted on Physical A.
• wrap_b—MAC is attached to Physical B. Data is received on
Physical B and transmitted on Physical B.
• wrap_s—MAC is attached to Physical S. Data is received on Physical
S and transmitted on Physical S. This is the normal mode for a single
attachment station (SAS).
• thru—MAC is attached to Physical A and B. Data is received on
Physical A and transmitted on Physical B. This is the normal mode
for a dual attachment station (DAS) with one MAC. The ring has been
operational for 1 minute and 42 seconds.
RMT is... RMT (Ring Management) is the SMT MAC-related state machine. The
RMT state can be one of the following:
• isolated—MAC is not trying to participate in the ring. This is the
initial state.
• non_op—MAC is participating in ring recovery, and ring is not
operational.
• ring_op—MAC is participating in an operational ring. This is the
normal state while the MAC is connected to the ring.
• detect—Ring has been nonoperational for longer than normal.
Duplicate address conditions are being checked.
• non_op_dup—Indications have been received that the address of the
MAC is a duplicate of another MAC on the ring. Ring is not
operational.
• ring_op_dup—Indications have been received that the address of the
MAC is a duplicate of another MAC on the ring. Ring is operational
in this state.
• directed—MAC is sending beacon frames notifying the ring of the
stuck condition.
• trace—Trace has been initiated by this MAC, and the RMT state
machine is waiting for its completion before starting an internal path
test.
token rotation Token rotation value is the default or configured rotation value as
determined by the fddi token-rotation-time command. This value is
used by all stations on the ring. The default is 5000 microseconds. For
FDDI full-duplex, this indicates the value in use prior to entering
full-duplex operation.
negotiated Actual (negotiated) target token rotation time.

Cisco IOS Interface and Hardware Component Command Reference

IR-608
Interface and Hardware Component Commands
show interfaces fddi

Table 59 show interfaces fddi Field Descriptions (continued)

Field Description
ring operational When the ring is operational, the displayed value will be the negotiated
token rotation time of all stations on the ring. Operational times are
displayed by the number of hours:minutes:seconds the ring has been up.
If the ring is not operational, the message “ring not operational” is
displayed.
Configured tvx Transmission timer.
LER Link error rate.
Upstream | downstream Displays the canonical MAC address of outgoing upstream and
neighbor downstream neighbors. If the address is unknown, the value will be the
FDDI unknown address (0x00 00 f8 00 00 00).
Last input Number of hours, minutes, and seconds since the last packet was
successfully received by an interface and processed locally on the router.
Useful for knowing when a dead interface failed. This counter is updated
only when packets are process-switched, not when packets are
fast-switched.
output Number of hours, minutes, and seconds since the last packet was
successfully transmitted by an interface. This counter is updated only
when packets are process-switched, not when packets are fast-switched.
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 231 ms (and less
than 232 ms) ago.
Queueing strategy First-in, first-out queueing strategy (other queueing strategies you might
see are priority-list, custom-list, and weighted fair).
Output queue, input Number of packets in output and input queues. Each number is followed
queue, drops by a slash, the maximum size of the queue, and the number of packets
dropped because of a full queue.
5 minute input rate Average number of bits and packets transmitted per second in the last
5 minute output rate 5 minutes.
The five-minute input and output rates should be used only as an
approximation of traffic per second during a given 5-minute period. These
rates are exponentially weighted averages with a time constant of
5 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.

Cisco IOS Interface and Hardware Component Command Reference

IR-609
 Interface and Hardware Component Commands
show interfaces fddi

Table 59 show interfaces fddi Field Descriptions (continued)

Field Description
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
Ethernet networks 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
minimum packet size of the media.
giants Number of packets that are discarded because they exceed the maximum
packet size of the medium.
CRC 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.
frame Number of packets received incorrectly that have a CRC error and a
noninteger number of octets. On a LAN, this is usually the result of
collisions or a malfunctioning Ethernet device. On an FDDI LAN, this
also can be the result of a failing fiber (cracks) or a hardware malfunction.
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 from 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 transmit aborts (when the router cannot feed the transmitter
fast enough).
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, because some datagrams can have
more than one error, and others can have errors that do not fall into any of
the specifically tabulated categories.
collisions Because an FDDI ring cannot have collisions, this statistic is always zero.
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 FDDI interfaces.
output buffer failures Number of no resource errors received on the output.

Cisco IOS Interface and Hardware Component Command Reference

IR-610
Interface and Hardware Component Commands
show interfaces fddi

Table 59 show interfaces fddi Field Descriptions (continued)

Field Description
output buffers swapped Number of packets swapped to DRAM.
out
transitions The number of times the ring made a transition from ring operational to
ring nonoperational, or vice versa. A large number of transitions indicates
a problem with the ring or the interface.
traces Trace count applies to both the FCI, FCIT, and FIP. Indicates the number
of times this interface started a trace.
claims Pertains to FCIT and FIP only. Indicates the number of times this
interface has been in claim state.
beacons Pertains to FCIT and FIP only. Indicates the number of times the interface
has been in beacon state.

The following is sample output that includes the accounting option. When you use the accounting
option, only the accounting statistics are displayed.
Router# show interfaces fddi 3/0 accounting

Fddi3/0
Protocol Pkts In Chars In Pkts Out Chars Out
IP 7344 4787842 1803 1535774
Appletalk 33345 4797459 12781 1089695
DEC MOP 0 0 127 9779
ARP 7 420 39 2340

Table 60 describes the fields shown in the display.

Table 60 show interfaces fddi Field Descriptions—Accounting

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

Cisco IOS Interface and Hardware Component Command Reference

IR-611
 Interface and Hardware Component Commands
show interfaces gigabitethernet

show interfaces gigabitethernet

To check the status and configuration settings of the Gigabit Ethernet interface of the
Cisco 7200-I/O-GE+E, use the show interfaces gigabitethernet command in privileged EXEC mode.

show interfaces gigabitethernet slot/port

Syntax Description slot Slot number on the interface.

port Port number on the interface.

Command Modes Privileged EXEC

Command History Release Modification

11.1 CC This command was introduced.
12.1(3a)E This command was implemented on the Cisco 7200-I/O-GE+E controller.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.

Usage Guidelines This command is used on the Cisco 7200-I/O-GE+E to display the configuration status of the
Gigabit Ethernet interface. Slot 0 is always reserved for the Gigabit Ethernet port on the I/O controller.

Examples The following is sample output from the show interfaces gigabitethernet command:
Router# show interfaces gigabitethernet 0/0

GigabitEthernet0/0 is up, line protocol is up

Hardware is 82543 (Livengood), address is 00d0.ffb6.4c00 (bia 00d0.ffb6.4c00)
Internet address is 10.1.1.3/8
MTU 1500 bytes, BW 1000000 Kbit, DLY 10 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive set (10 sec)
Full-duplex mode, link type is autonegotiation, media type is SX
output flow-control is on, input flow-control is on
ARP type:ARPA, ARP Timeout 04:00:00
Last input 00:00:04, output 00:00:03, output hang never
Last clearing of "show interface" counters never
Queueing strategy:fifo
Output queue 0/40, 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
2252 packets input, 135120 bytes, 0 no buffer
Received 2252 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 watchdog, 0 multicast, 0 pause input
0 input packets with dribble condition detected
2631 packets output, 268395 bytes, 0 underruns
0 output errors, 0 collisions, 2 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier, 0 pause output

Cisco IOS Interface and Hardware Component Command Reference

IR-612
 Interface and Hardware Component Commands
show interfaces gigabitethernet

0 output buffer failures, 0 output buffers swapped out

Related Commands Command Description

show controllers Displays initialization block information, transmit ring, receive ring, and
gigabitethernet errors for the interface controllers for the Gigabit Ethernet interface of the
Cisco 7200-I/O-GE+E.

Cisco IOS Interface and Hardware Component Command Reference

IR-613
 Interface and Hardware Component Commands
show interfaces hssi

show interfaces hssi

To display information about the high-speed serial interface (HSSI), use the show interfaces hssi
command in privileged EXEC mode.

Standard Syntax

show interfaces hssi number [accounting]

Cisco 7500 Series

show interfaces hssi [slot/port] [accounting]

Syntax Description number Port number on the selected interface.

accounting (Optional) Displays the number of packets of each protocol type that have been
sent through the interface.
slot (Optional) Slot number. Refer to the appropriate hardware manual for slot and
port information.
port (Optional) Port number. Refer to the appropriate hardware manual for slot and
port information.

Command Modes Privileged EXEC

Command History Release Modification

10.0 This command was introduced.

Examples The following is sample output from the show interfaces hssi command when HSSI is enabled:
Router# show interfaces hssi 0

HSSI 0 is up, line protocol is up

Hardware is cBus HSSI
Internet address is 10.136.67.190, subnet mask is 255.255.255.0
MTU 4470 bytes, BW 45045 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation HDLC, loopback not set, keepalive set (10 sec)
Last input 0:00:03, 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
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
0 parity, 0 rx disabled
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
17 packets output, 994 bytes, 0 underruns
0 output errors, 0 applique, 4 interface resets, 0 restarts
2 carrier transitions

Table 61 describes significant fields shown in the display.

Cisco IOS Interface and Hardware Component Command Reference

IR-614
Interface and Hardware Component Commands
show interfaces hssi

Table 61 show interfaces hssi Field Descriptions

Field Description
HSSI is {up | down | Indicates whether the interface hardware is currently active (whether
administratively down} carrier detect is present) and whether it has been taken down by an
administrator. “Disabled” indicate that the router has received over
5000 errors in a keepalive interval, which is 10 seconds by default.
line protocol Indicates whether the software processes that handle the line protocol
is {up | down | consider the line usable (that is, whether keepalives are successful).
administratively down}
Hardware Specifies the hardware type.
Internet address Lists the Internet 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 percent reliability), calculated as an exponential average over
5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely
saturated), calculated as an exponential average over 5 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 and processed locally on the
router. Useful for knowing when a dead interface failed. This counter
is updated only when packets are process-switched, not when packets
are fast-switched.
Last output Number of hours, minutes, and seconds since the last packet was
successfully transmitted by an interface. This counter is updated only
when packets are process-switched, not when packets are
fast-switched.
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 231 ms (and
less than 232 ms) ago.

Cisco IOS Interface and Hardware Component Command Reference

IR-615
 Interface and Hardware Component Commands
show interfaces hssi

Table 61 show interfaces hssi Field Descriptions (continued)

Field Description
Output queue, drops Number of packets in output and input queues. Each number is
Input queue, drops followed by a slash, the maximum size of the queue, and the number
of packets dropped because of a full queue.
Five minute input rate, Average number of bits and packets transmitted per second in the last
Five minute output rate 5 minutes.
packets input Total number of error-free packets received by the system.
bytes input 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 Ethernet networks 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 minimum packet size of the medium.
giants Number of packets that are discarded because they exceed the
maximum packet size of the medium.
parity Report of the parity errors on the HSSI.
rx disabled Indicates that the HSSI could not find a free buffer on the ciscoBus
controller to reserve for use for the HSSI receiver. When this
happens, the HSSI shuts down its receiver and waits until a buffer is
available. Data is not lost unless a packet comes in and overflows the
HSSI FIFO. Usually, the receive disables are frequent but do not last
for long, and the number of dropped packets is less than the count in
the “rx disabled” field. A receive disabled condition can happen in
systems that are under heavy traffic load and that have shorter
packets. In this situation, the number of buffers available on the
ciscoBus controller is at a premium. One way to alleviate this
problem is to reduce the maximum transmission unit (MTU) on the
HSSI interface from 4500 (FDDI size) to 1500 (Ethernet size). Doing
so allows the software to take the fixed memory of the ciscoBus
controller and divide it into a larger number of smaller buffers, rather
than a small number of large buffers. Receive disables are not errors,
so they are not included in any error counts.
input errors Sum of all errors that prevented the receipt of datagrams on the
interface being examined. This may not balance with the sum of the
enumerated output errors, because some datagrams may have more
than one error and others may have errors that do not fall into any of
the specifically tabulated categories.

Cisco IOS Interface and Hardware Component Command Reference

IR-616
Interface and Hardware Component Commands
show interfaces hssi

Table 61 show interfaces hssi Field Descriptions (continued)

Field Description
CRC Cyclic redundancy checksum (CRC) 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
ability of the receiver 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 router receiver can handle.
congestion drop Number of messages discarded because the output queue on an
interface grew too long. This can happen on a slow, congested serial
link.
output errors Sum of all errors that prevented the final transmission of datagrams
out of the interface being examined. Note that this may not balance
with the sum of the enumerated output errors, because some
datagrams may have more than one error, and others may have errors
that do not fall into any of the specifically tabulated categories.
applique Indicates that an unrecoverable error has occurred on the
High-System Availability (HSA) applique. The system then invokes
an interface reset.

Cisco IOS Interface and Hardware Component Command Reference

IR-617
 Interface and Hardware Component Commands
show interfaces hssi

Table 61 show interfaces hssi Field Descriptions (continued)

Field Description
interface resets Number of times that 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 that the controller was restarted because of errors.
carrier transitions Number of times that the carrier detect signal of the interface has
changed state. Indicates modem or line problems if the carrier detect
line is changing state often.

The following is sample output from the show interfaces hssi command on a Cisco 7500 series router:
Router# show interfaces hssi 1/0

Hssi1/0 is up, line protocol is up

Hardware is cxBus HSSI
Internet address is 10.108.38.14, subnet mask is 255.255.255.0
MTU 1500 bytes, BW 45045 Kbit, DLY 1000000 usec, rely 255/255, load 1/255
Encapsulation HDLC, loopback not set, keepalive set (10 sec)
Last input 0:00:00, output 0:00:08, output hang never
Last clearing of "show interface" counters never
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 1000 bits/sec, 2 packets/sec
Five minute output rate 0 bits/sec, 0 packets/sec
630573548 packets input, 2077237628 bytes, 0 no buffer
Received 2832063 broadcasts, 0 runts, 0 giants
0 parity, 1970 rx disabled
113 input errors, 20 CRC, 93 frame, 0 overrun, 0 ignored, 0 abort
629721628 packets output, 1934313295 bytes, 0 underruns
0 output errors, 0 applique, 62 interface resets, 0 restarts
309 carrier transitions

The following is sample output from the show interfaces hssi command with the accounting option on
a Cisco 7500 series router:
Router# show interfaces hssi 1/0 accounting

HIP1/0
Protocol Pkts In Chars In Pkts Out Chars Out
IP 7344 4787842 1803 1535774
Appletalk 33345 4797459 12781 1089695
DEC MOP 0 0 127 9779
ARP 7 420 39 2340

Table 62 describes the fields shown in the display.

Table 62 show interfaces hssi Field Descriptions—Accounting

Field Description
Protocol Protocol that is operating on the interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-618
Interface and Hardware Component Commands
show interfaces hssi

Table 62 show interfaces hssi Field Descriptions—Accounting

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.

Cisco IOS Interface and Hardware Component Command Reference

IR-619
 Interface and Hardware Component Commands
show interfaces loopback

show interfaces loopback

To display information about the loopback interface, use the show interfaces loopback command in
privileged EXEC mode.

show interfaces loopback [number] [accounting]

Syntax Description number (Optional) 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 Modes Privileged EXEC

Command History Release Modification

10.0 This command was introduced.

Examples 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 packets output, 0 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets, 0 restarts

The following is sample output when the accounting keyword is included:

Router# show interfaces loopback 0 accounting

Loopback0
Protocol Pkts In Chars In Pkts Out Chars Out
No traffic sent or received on this interface.

Table 63 describes significant fields shown in the displays.

Cisco IOS Interface and Hardware Component Command Reference

IR-620
Interface and Hardware Component Commands
show interfaces loopback

Table 63 show interfaces loopback Field Descriptions

Field Description
Loopback is {up | down | Indicates whether the interface hardware is currently active (whether
administratively down} carrier detect is present), is currently inactive, or has been taken down
by an administrator.
line protocol is {up | down | Indicates whether the software processes that handle the line protocol
administratively down} consider 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 percent
reliability), calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely
saturated), calculated as an exponential average over 5 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 and processed locally on the
router. Useful for knowing when a dead interface failed. This counter
is updated only when packets are process-switched, not when packets
are fast-switched.
Last output Number of hours, minutes, and seconds since the last packet was
successfully transmitted by an interface. This counter is updated only
when packets are process-switched, not when packets are
fast-switched.
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 231 ms (and less
than 232 ms) ago.
Output queue, drops; Number of packets in output and input queues. Each number is
Input queue, drops followed by a slash, the maximum size of the queue, and the number
of packets dropped because of a full queue.

Cisco IOS Interface and Hardware Component Command Reference

IR-621
 Interface and Hardware Component Commands
show interfaces loopback

Table 63 show interfaces loopback Field Descriptions (continued)

Field Description
Five minute input rate, Average number of bits and packets transmitted per second in the last
Five minute output rate 5 minutes.
packets input Total number of error-free packets received by the system.
bytes input 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 Ethernet networks 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 minimum packet size of the medium.
giants Number of packets that are discarded because they exceed the
maximum packet size of the medium.
input errors Sum of all errors that prevented the receipt of datagrams on the
interface being examined. This may not balance with the sum of the
enumerated output errors, because some datagrams may have more
than one error and others may have errors that do not fall into any of
the specifically tabulated categories.
CRC 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. 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.

Cisco IOS Interface and Hardware Component Command Reference

IR-622
Interface and Hardware Component Commands
show interfaces loopback

Table 63 show interfaces loopback Field Descriptions (continued)

Field Description
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 router’s receiver can handle. This may 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 may not balance
with the sum of the enumerated output errors, as some datagrams may
have more than one error, and others may have errors that do not fall
into any of the specifically tabulated categories.
collisions Loopback interface does not have collisions.
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.

Cisco IOS Interface and Hardware Component Command Reference

IR-623
 Interface and Hardware Component Commands
show interfaces port-channel

show interfaces port-channel

To display the information about the Fast EtherChannel on Cisco 7000 series routers with the RSP7000
and RSP7000CI, Cisco 7200 series routers, and Cisco 7500 series routers, use the show interfaces
port-channel command in user EXEC or privileged EXEC mode.

show interfaces port-channel [channel-number]

Syntax Description channel-number (Optional) Port channel number. Range is from 1 to 4.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

11.1 CA This command was introduced.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.

Examples The following is sample output from the show interfaces port-channel command:
Router# show interfaces port-channel 1

Port-channel1 is up, line protocol is up

Hardware is FEChannel, address is 0000.0ca8.6220 (bia 0000.0000.0000)
MTU 1500 bytes, BW 400000 Kbit, DLY 100 usec, rely 255/255, load 1/255
Encapsulation ARPA, loopback not set, keepalive not set, fdx
ARP type: ARPA, ARP Timeout 04:00:00
No. of active members in this channel: 4
Member 0 : Fast Ethernet1/0/0
Member 1 : Fast Ethernet1/1/0
Member 2 : Fast Ethernet4/0/0
Member 3 : Fast Ethernet4/1/0
Last input 01:22:13, output never, output hang never
Last clearing of “show interface” counters never
Queueing strategy: fifo
Output queue 0/40, 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
223 packets input, 11462 bytes, 0 no buffer
Received 1 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 watchdog, 0 multicast
0 input packets with dribble condition detected
192 packets output, 13232 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out

Table 64 describes significant fields shown in the display.

Cisco IOS Interface and Hardware Component Command Reference

IR-624
Interface and Hardware Component Commands
show interfaces port-channel

Table 64 show interfaces port-channel Field Descriptions

Field Description
Port-channel1 is up, Indicates if the interface hardware is currently active and can transmit and
line protocol is up receive or if it has been taken down by an administrator.
Hardware is Hardware type (Fast EtherChannel).
address is Address being used by the interface.
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 percent
reliability), calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely
saturated), calculated as an exponential average over 5 minutes. The
calculation uses the value from the bandwidth interface configuration
command.
Encapsulation Encapsulation method assigned to the interface.
loopback Indicates if loopbacks are set.
keepalive Indicates if keepalives are set.
fdx Indicates the interface is operating in full-duplex mode.
ARA type ARP type on the interface.
ARP timeout Number of hours, minutes, and seconds an ARP cache entry will stay in
the cache.
No. of active members in Number of Fast Ethernet interfaces that are currently active (not down) and
this channel: 4 part of the Fast EtherChannel group.
Member 0: Fast Specific Fast Ethernet interface that is part of the Fast EtherChannel
Ethernet1/0/0 group.
Last input Number of hours, minutes, and seconds since the last packet was
successfully received by an interface and processed locally on the router.
Useful for knowing when a dead interface failed. This counter is updated
only when packets are process-switched, not when packets are
fast-switched.
output Number of hours, minutes, and seconds since the last packet was
successfully transmitted by an interface. This counter is updated only
when packets are process-switched, not when packets are fast-switched.
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.

Cisco IOS Interface and Hardware Component Command Reference

IR-625
 Interface and Hardware Component Commands
show interfaces port-channel

Table 64 show interfaces port-channel Field Descriptions (continued)

Field Description
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. 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 231 ms (and less
than 232 ms)) ago.
Queueing strategy First-in, first-out queueing strategy (other queueing strategies you might
see are priority-list, custom-list, and weighted fair).
Output queue, drops Number of packets in output and input queues. Each number is followed
input queue, drops by a slash, the maximum size of the queue, and the number of packets
dropped because a queue was full.
5 minute input rate Average number of bits and packets received or transmitted per second in
5 minute output rate the last 5 minutes.
packets input Total number of error-free packets received by the system.
bytes (input) 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
minimum packet size of the medium.
giants Number of packets that are discarded because they exceed the maximum
packet size of the medium.
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 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.

Cisco IOS Interface and Hardware Component Command Reference

IR-626
Interface and Hardware Component Commands
show interfaces port-channel

Table 64 show interfaces port-channel Field Descriptions (continued)

Field Description
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 ones bit on the interface.
watchdog Number of times watchdog receive timer expired. It happens when
receiving a packet with length greater than 2048.
multicast Number of multicast packets received.
input packets with Dribble bit error indicates that a frame is slightly too long. This frame
dribble condition error counter is incremented just for informational purposes; the router
detected accepts the frame.
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 router’s receiver can handle.
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 can have more
than one error, and others can have errors that do not fall into any of the
specifically tabulated categories.
collisions Number of messages retransmitted because of an Ethernet collision. 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 a certain interval.
If the system notices that the carrier detect line of an 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 unrecoverable interface
processor error occurred, or when an interface is looped back or shut
down.
babbles The transmit jabber timer expired.
late collision Number of late collisions. Late collision happens when a collision occurs
after transmitting the preamble. The most common cause of late collisions
is that your Ethernet cable segments are too long for the speed at which
you are transmitting.
deferred Deferred indicates that the chip had to defer while ready to transmit a
frame because the carrier was asserted.
lost carrier Number of times the carrier was lost during transmission.
no carrier Number of times the carrier was not present during the transmission.

Cisco IOS Interface and Hardware Component Command Reference

IR-627
 Interface and Hardware Component Commands
show interfaces port-channel

Table 64 show interfaces port-channel Field Descriptions (continued)

Field Description
output buffer failures Number of times that a packet was not output from the output hold queue
because of a shortage of MEMD shared memory.
output buffers swapped Number of packets stored in main memory when the output queue is full;
out swapping buffers to main memory prevents packets from being dropped
when output is congested. The number is high when traffic is bursty.

Related Commands Command Description

interface multilink Specifies a Fast EtherChannel and enters interface configuration mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-628
 Interface and Hardware Component Commands
show interfaces pos

show interfaces pos

To display information about the Packet OC-3 interface in Cisco 7500 series routers, use the show
interfaces pos command in user EXEC or privileged EXEC mode.

Cisco 7000 and Cisco 7500 Series with VIPs

show interfaces pos [slot/port-adapter/port]

Syntax Description slot (Optional) Slot number. Refer to the appropriate hardware manual for slot and
port information.
/port-adapter (Optional) Port adapter number. Refer to the appropriate hardware manual for
information about port adapter compatibility.
/port (Optional) Port number. Refer to the appropriate hardware manual for slot and
port information.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

11.2 The show interface posi command was introduced.
11.3 The name of the command was modified from show interface posi to show
interfaces pos, and the sample output was updated.

Examples The following is sample output from the show interfaces pos command on a Cisco 7513 router with one
Packet OC-3 Interface Processor (POSIP):
Router# show interfaces pos 2/0/0

POS2/0/0 is up, line protocol is up

Hardware is cyBus Packet over Sonet
Description: PRI-T1 net to zippy (4K) to Pac-Bell
Internet address is 10.1.1.1/27
MTU 4470 bytes, BW 1000 Kbit, DLY 40000 usec, rely 255/255, load 1/255
Encapsulation HDLC, loopback not set, keepalive set (3 sec)
Last input 00:00:00, output 00:00:00, output hang never
Last clearing of “show interface” counters 00:23:09
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 1 packets/sec
5 minute output rate 1000 bits/sec, 1 packets/sec
1046 packets input, 54437 bytes, 0 no buffer
Received 485 broadcasts, 0 runts, 0 giants, 0 parity
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
4013 packets output, 1357412 bytes, 0 underruns
0 output errors, 0 applique, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
0 carrier transitions

Cisco IOS Interface and Hardware Component Command Reference

IR-629
 Interface and Hardware Component Commands
show interfaces pos

Table 65 describes the significant fields shown in the display.

Table 65 show interfaces pos Field Descriptions

Field Description
POS2/0/0 is up, line protocol is up Indicates whether the interface hardware is currently active and
can transmit and receive or whether it has been taken down by
an administrator.
Hardware is cyBus Packet over Hardware type.
Sonet
Internet address is Internet address and 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 percent reliability), calculated as an exponential average
over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is
completely saturated), calculated as an exponential average
over 5 minutes. The calculation uses the value from the
bandwidth interface configuration command.
Encapsulation Encapsulation method assigned to interface.
loopback Indicates whether loopbacks are set.
keepalive Indicates whether keepalives are set.
Last input Number of hours, minutes, and seconds since the last packet
was successfully received by an interface and processed locally
on the router. Useful for knowing when a dead interface failed.
This counter is updated only when packets are
process-switched, not when packets are fast-switched.
(Last) output Number of hours, minutes, and seconds since the last packet
was successfully transmitted by an interface. This counter is
updated only when packets are process-switched, not when
packets are fast-switched.
(Last) 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 2231 ms
(and less than 2 32 ms) ago.

Cisco IOS Interface and Hardware Component Command Reference

IR-630
Interface and Hardware Component Commands
show interfaces pos

Table 65 show interfaces pos Field Descriptions (continued)

Field Description
Queueing strategy First-in, first-out queueing strategy (other queueing strategies
you might see are priority-list, custom-list, and weighted fair).
Output queue, drops Number of packets in output and input queues. Each number is
input queue, drops followed by a slash, the maximum size of the queue, and the
number of packets dropped because a queue was full.
5 minute input rate Average number of bits and packets received or transmitted per
5 minute output rate second in the last 5 minutes.
packets input Total number of error-free packets received by the system.
bytes (input) 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 minimum packet size of the medium.
giants Number of packets that are discarded because they exceed the
maximum packet size of the medium.
parity Report of the parity errors on the interface.
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 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 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.

Cisco IOS Interface and Hardware Component Command Reference

IR-631
 Interface and Hardware Component Commands
show interfaces pos

Table 65 show interfaces pos Field Descriptions (continued)

Field Description
abort Illegal sequence of one bits on the interface.
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 router’s receiver can handle.
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 can have more than one error, and others can
have errors that do not fall into any of the specifically tabulated
categories.
applique Indicates an unrecoverable error has occurred on the POSIP
applique. The system then invokes an interface reset.
interface resets Number of times an interface has been completely reset. This
can happen if packets queued for transmission were not sent
within a certain interval. If the system notices that the carrier
detect line of an 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 unrecoverable interface
processor error occurred, or when an interface is looped back or
shut down.
carrier transitions Number of times the carrier detect signal of the interface has
changed state.

Related Commands Command Description

interface Configures an interface type and enters interface configuration mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-632
 Interface and Hardware Component Commands
show interfaces satellite

show interfaces satellite

To display general interface settings and traffic rates for the internal router interface that connects
to an installed Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT), use the
show interfaces satellite command in user EXEC or privileged EXEC mode.

show interfaces satellite slot/unit

Syntax Description slot Router chassis slot in which the network module is installed.
/unit Interface number. For NM-1VSAT-GILAT network modules, always use 0.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines The show interfaces satellite command displays the following:
• Basic configuration information for the internal router interface that connects to an installed
Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT)
• Traffic statistics, including the number of packets transmitted, input and output rate, and errors
• Interface and line protocol status (up or down), with the following exceptions:
– Line Protocol Status Exception—Hub Dial Backup Mode
– Line Protocol Status Exception—Hot Standby Router Protocol (HSRP) Standby Mode

Line Protocol Status Exception—Hub Dial Backup Mode

If you configure hub dial backup mode on the satellite interface, the show interfaces satellite command
always displays Line Protocol Up status, even when the line protocol is down. To view the actual line
protocol status, enter the show controllers satellite command or the service-module satellite slot/0
status command in privileged EXEC mode.

Line Protocol Status Exception—Hot Standby Router Protocol (HSRP) Standby Mode
If the router is in a hot standby group and is in standby mode, the show interfaces satellite command
displays “line protocol is up (standby),” even though a link to the hub is not established from the standby
router. To view the actual line protocol status, enter the show controllers satellite command or the
service-module satellite slot/0 status command in privileged EXEC mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-633
 Interface and Hardware Component Commands
show interfaces satellite

Examples This section provides the following examples:

• Normal Operation or Hub Dial Backup Mode Example
• Satellite Backup for a Terrestrial Link—Standby Mode Example
• Hot Standby Router Protocol (HSRP)—Standby Mode Example
For output field descriptions, see Table 66 on page 636.

Normal Operation or Hub Dial Backup Mode Example

In the following example, the satellite interface is up and the line protocol is up.
If you configure hub dial backup for the NM-1VSAT-GILAT network module, the line protocol appears
to be up even if the satellite link is actually down. To view the actual line protocol status while hub dial
backup mode is configured, use the show controllers satellite command or the service-module satellite
slot/0 status command instead.
Router# show interfaces satellite 2/0

Satellite2/0 is up, line protocol is up

Hardware is I82559FE, address is 0008.e35f.7370 (bia 0008.e35f.7370)
Internet address is 10.22.1.2/24
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive not set
ARP type:ARPA, ARP Timeout 04:00:00
Last input 00:00:02, output 00:00:00, output hang never
Last clearing of "show interface" counters never
Input queue:0/75/0/0 (size/max/drops/flushes); Total output drops:0
Queueing strategy:fifo
Output queue:0/40 (size/max)
5 minute input rate 13000 bits/sec, 6 packets/sec
5 minute output rate 8000 bits/sec, 9 packets/sec
419433 packets input, 108329352 bytes, 0 no buffer
Received 11792 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 input packets with dribble condition detected
650568 packets output, 73969720 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out

Satellite Backup for a Terrestrial Link—Standby Mode Example

In the following example, the satellite interface is in standby mode because the primary terrestrial link
is up:
Router# show interfaces satellite 1/0

Satellite1/0 is standby mode, line protocol is down

Hardware is I82559FE, address is 00e0.f7ff.f310 (bia 00e0.f7ff.f310)
Internet address is 10.0.0.1/24
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive not set
ARP type:ARPA, ARP Timeout 04:00:00
Last input 00:00:00, output 00:00:03, output hang never
Last clearing of "show interface" counters 00:00:04
Input queue:0/75/0/0 (size/max/drops/flushes); Total output drops:0

Cisco IOS Interface and Hardware Component Command Reference

IR-634
Interface and Hardware Component Commands
show interfaces satellite

Queueing strategy:fifo
Output queue:0/40 (size/max)
30 second input rate 13000 bits/sec, 6 packets/sec
30 second output rate 0 bits/sec, 0 packets/sec
30 packets input, 7474 bytes, 0 no buffer
Received 1 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 input packets with dribble condition detected
1 packets output, 82 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out

Hot Standby Router Protocol (HSRP)—Standby Mode Example

In the following example, homogeneous HSRP is configured on two routers, each of which contains an
NM-1VSAT-GILAT network module that connects to the same dish antenna (ODU). The following
output from the standby router shows that the line protocol is “up (standby),” even though the satellite
link on the standby router is actually down. To view the actual line protocol status, use the
show controllers satellite command or the service-module satellite slot/0 status command.
Router# show interfaces satellite 2/0

Satellite2/0 is up, line protocol is up (standby)

Hardware is I82559FE, address is 0008.e35f.7370 (bia 0008.e35f.7370)
Internet address is 10.22.1.2/24
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive not set
ARP type:ARPA, ARP Timeout 04:00:00
Last input 00:00:02, output 00:00:00, output hang never
Last clearing of "show interface" counters never
Input queue:0/75/0/0 (size/max/drops/flushes); Total output drops:0
Queueing strategy:fifo
Output queue:0/40 (size/max)
5 minute input rate 13000 bits/sec, 6 packets/sec
5 minute output rate 8000 bits/sec, 9 packets/sec
419433 packets input, 108329352 bytes, 0 no buffer
Received 11792 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 input packets with dribble condition detected
650568 packets output, 73969720 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out

Table 66 describes the significant fields shown in the display.

Cisco IOS Interface and Hardware Component Command Reference

IR-635
 Interface and Hardware Component Commands
show interfaces satellite

Table 66 show interfaces satellite Field Descriptions

Field Description
Satellite2/0 is... State of the interface hardware:
• up • Currently active.
• down • Has been taken down by an administrator.
• standby mode • In HSRP standby mode when two HSRP-redundant
NM-1VSAT-GILAT network modules (in separate
routers) connect to one dish antenna (ODU).
line protocol is State of the backbone link to the hub: up or down. See the
following exceptions:
• Line Protocol Status Exception—Hub Dial Backup
Mode, page 633
• Line Protocol Status Exception—Hot Standby Router
Protocol (HSRP) Standby Mode, page 633
Hardware is Hardware type (for example, Fast Ethernet) and address.
Internet address Internet 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.
reliability Reliability of the interface as a fraction of 255 (255/255 is
100 percent reliability), calculated as an exponential average
over 5 minutes.
txload and rxload Transmitted and received load on the interface as a fraction
of 255 (255/255 is completely saturated), calculated as an
exponential average over 5 minutes.
Encapsulation Encapsulation method assigned to the 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 and processed
locally on the router. Useful for knowing when a dead
interface failed. This counter is updated only when packets
are process-switched, not when packets are fast-switched.
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. This counter is
updated only when packets are process-switched, not when
packets are fast-switched.

Cisco IOS Interface and Hardware Component Command Reference

IR-636
Interface and Hardware Component Commands
show interfaces satellite

Table 66 show interfaces satellite Field Descriptions (continued)

Field Description
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 231 ms
(and less than 232 ms) ago.
Input queue Input queue information:
• Size—Number of packets in the input queue
• Max—Maximum size of the queue
• Drops—Number of packets discarded because of a full
queue
• Flushes—Number of times data on queue has been
discarded
Total output drops Total number of output packets dropped.
Queueing strategy First-in, first-out queueing strategy (other queueing strategies
you might see are priority-list, custom-list, and weighted
fair).
Output queue Number of packets in the output queue and the maximum size
of the queue.
5 minute input rate Average number of bits and packets transmitted per second in
5 minute output rate the last 5 minutes.
The 5-minute input and output rates should be used only as
an approximation of traffic per second during a given
5-minute period. These rates are exponentially weighted
averages with a time constant of 5 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.

Cisco IOS Interface and Hardware Component Command Reference

IR-637
 Interface and Hardware Component Commands
show interfaces satellite

Table 66 show interfaces satellite Field Descriptions (continued)

Field Description
no buffer Number of received packets discarded because there was no
buffer space in the main system. Compare with ignored
count. Broadcast storms on Ethernet networks 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 minimum packet size of the media.
giants Number of packets that are discarded because they exceed the
maximum packet size of the media.
throttles Number of times that the interface requested another
interface within the router to slow down.
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 may
have more than one error; therefore, this sum may not balance
with the sum of enumerated input error counts.
CRC Number of times that 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.
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 from the system buffers mentioned
previously in the “no buffer” description. Broadcast storms
and bursts of noise can increase the ignored count.
input packets with dribble condition Dribble bit error indicates that a frame is slightly too long.
detected This frame error counter is incremented just for
informational purposes; the router accepts the frame.
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 router can handle. This may never be reported on
some interfaces.

Cisco IOS Interface and Hardware Component Command Reference

IR-638
 Interface and Hardware Component Commands
show interfaces satellite

Table 66 show interfaces satellite Field Descriptions (continued)

Field Description
output errors Sum of all errors that prevented the final transmission of
datagrams out of the interface being examined. Note that this
may not balance with the sum of the enumerated output
errors, because some datagrams may have more than one
error, and others may have errors that do not fall into any of
the specifically tabulated categories.
collisions Number of messages retransmitted because of an Ethernet
collision. A packet that collides is counted only once in
output packets.
interface resets Number of times that 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.
babbles1 Indicates that the transmit jabber timer expired.
1
late collision Number of late collisions. Late collision happens when a
collision occurs after the preamble has been transmitted. The
most common cause of late collisions is that your Ethernet
cable segments are too long for the speed at which you are
transmitting.
deferred1 Deferred indicates that the chip had to defer transmission
while ready to transmit a frame, because the carrier was
asserted.
lost carrier1 Number of times the carrier was lost during transmission.
1
no carrier Number of times the carrier was not present during the
transmission.
output buffer failures Number of failed buffers.
output buffers swapped out Number of buffers swapped out.
1. This field applies to the router internal interface that connects to the installed Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT). This field typically does not apply to the external satellite interface.

Related Commands Command Description

service-module Displays status information related to the hardware and software on the
satellite status Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT),
including the initial configuration parameters.
show controllers Displays controller information about the internal router interface that
satellite connects to an installed Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT).

Cisco IOS Interface and Hardware Component Command Reference

IR-639
 Interface and Hardware Component Commands
show interfaces serial

show interfaces serial

To display information about a serial interface, use the show interfaces serial command in privileged
EXEC mode. When using Frame Relay encapsulation, use the show interfaces serial command in user
EXEC or privileged EXEC mode to display information about the multicast data-link connection
identifier (DLCI), the DLCIs used on the interface, and the DLCI used for the Local Management
Interface (LMI).

Cisco 4000 Series

show interfaces serial [number[:channel-group]] [accounting]

Cisco 7000 and Cisco 7500 Series with the RSP7000, RSP7000CI, or Ports on VIPs

show interfaces serial [slot/port-adapter/port]

Cisco 7500 Series

show interfaces serial [slot/port[:channel-group]] [accounting]

Cisco 7500 Series with a CT3IP

show interfaces serial [slot/port-adapter/port][:t1-channel] [accounting | crb]

Cisco AS5350 and Cisco AS5400 Universal Gateways

show interfaces serial slot/port

Cisco AS5800 Access Servers

show interfaces serial dial-shelf/slot/t3-port:t1-num:chan-group

Syntax Description number (Optional) Number of the port being displayed.

:channel-group (Optional) On the Cisco 4000 series with a Network Management Processor
(NPM) or the Cisco 7500 series routers with a MultiChannel Interface Processor
(MIP), specifies the T1 channel-group number in the range of 0 to 23 defined with
the channel-group controller configuration command.
accounting (Optional) Displays the number of packets of each protocol type that have been
sent through the interface.
slot (Optional) Number of the slot being displayed. Refer to the appropriate hardware
manual for slot and port information.
/port (Optional) Number of the port being displayed. Refer to the appropriate hardware
manual for slot and port information.
/port-adapter (Optional) Number of the port adapter being displayed. Refer to the appropriate
hardware manual for information about port adapter compatibility.

Cisco IOS Interface and Hardware Component Command Reference

IR-640
 Interface and Hardware Component Commands
show interfaces serial

:t1-channel (Optional) T1 channel number. For the CT3IP, the T1 channel is a number
between 1 and 28.
T1 channels on the CT3IP are numbered 1 to 28 rather than the more traditional
zero-based scheme (0 to 27) used with other Cisco products. This scheme ensures
consistency with telco numbering schemes for T1 channels within channelized T3
equipment.
crb (Optional) Displays interface routing and bridging information.
dial-shelf Dial shelf chassis in the Cisco AS5800 access server that contains the CT3
interface card.
slot Location of the CT3 interface card in the dial shelf chassis.
t3-port T3 port number. The only valid value is 0.
:t1-num T1 time slot in the T3 line. The value can be from 1 to 28.
:chan-group Channel group identifier.

Command Modes User EXEC (when Frame Relay encapsulation is used)

Privileged EXEC

Command History Release Modification

10.0 This command was introduced on the Cisco 4000 series routers.
11.0 This command was implemented on the Cisco 7000 series routers.
11.1 CA This command was modified to include sample output for the PA-2JT2,
PA-E3, and PA-T3 serial port adapters.
11.3 This command was modified to include the CT3IP.
12.0(3)T This command was implemented on the Cisco AS5800 access servers.
12.0(4)T This command was modified to include enhanced display information for
dialer bound interfaces.
12.2(11)T This command was implemented on the Cisco AS5350 and Cisco AS5400.
12.2(13)T This command was modified to display information about Frame Relay
interface queueing and fragmentation.

Usage Guidelines Frame Relay

Use this command to determine the status of the Frame Relay link. This display also indicates Layer 2
status if switched virtual circuits (SVCs) are configured.

Channel Groups as Virtual Serial Interfaces

To find out about channel groups configured as virtual serial interfaces, to verify that the router has
High-Level Data Link Control (HDLC) encapsulation on the interface, and to verify that the interface
sees the loopback, use the show interfaces serial command in privileged EXEC mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-641
 Interface and Hardware Component Commands
show interfaces serial

Examples Example of Synchronous Serial Interface

The following is sample output from the show interfaces serial 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 192.168.10.203, subnet mask is 255.255.255.0
MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation HDLC, loopback not set, keepalive set (10 sec)
Last input 0:00:07, output 0:00:00, output hang never
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 0 bits/sec, 0 packets/sec
Five minute output rate 0 bits/sec, 0 packets/sec
16263 packets input, 1347238 bytes, 0 no buffer
Received 13983 broadcasts, 0 runts, 0 giants
2 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 2 abort
1 carrier transitions

22146 packets output, 2383680 bytes, 0 underruns

0 output errors, 0 collisions, 2 interface resets, 0 restarts

Table 67 describes significant fields shown in the display.

Table 67 show interfaces serial Field Descriptions—Synchronous Serial Interface

Field Description
Serial ... is {up | down} ... Indicates whether the interface hardware is currently active (whether
is administratively down carrier detect is present), is currently inactive, or has been taken down by
an administrator.
line protocol is Indicates whether the software processes that handle the line protocol
{up | down} consider the line usable (that is, whether keepalives are successful) or
whether the line has been taken down by an administrator.
Hardware is Specifies the hardware type.
Internet address is Specifies the Internet address and 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 kbps). If the interface is attached to a serial line with
a line speed that does not match the default (1536 or 1544 kbps for T1 and
56 kbps 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 percent
reliability), calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely
saturated), calculated as an exponential average over 5 minutes.
Encapsulation Encapsulation method assigned to interface.
loopback Indicates whether or not loopback is set.
keepalive Indicates whether or not keepalives are set.

Cisco IOS Interface and Hardware Component Command Reference

IR-642
Interface and Hardware Component Commands
show interfaces serial

Table 67 show interfaces serial Field Descriptions—Synchronous Serial Interface (continued)

Field Description
Last input Number of hours, minutes, and seconds since the last packet was
successfully received by an interface and processed locally on the router.
Useful for knowing when a dead interface failed. This counter is updated
only when packets are process-switched, not when packets are
fast-switched.
Last output Number of hours, minutes, and seconds since the last packet was
successfully transmitted by an interface. This counter is updated only
when packets are process-switched, not when packets are fast-switched.
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 Number of packets in output and input queues. Each number is followed
input queue, drops by a slash, the maximum size of the queue, and the number of packets
dropped because of a full queue.
5 minute input rate Average number of bits and packets transmitted per second in the last
5 minute output rate 5 minutes.
The 5-minute input and output rates should be used only as an
approximation of traffic per second during a given 5-minute period. These
rates are exponentially weighted averages with a time constant of
5 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
Ethernet networks 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
minimum packet size of the medium.
giants Number of packets that are discarded because they exceed the maximum
packet size of the medium.
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 checksum 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.

Cisco IOS Interface and Hardware Component Command Reference

IR-643
 Interface and Hardware Component Commands
show interfaces serial

Table 67 show interfaces serial Field Descriptions—Synchronous Serial Interface (continued)

Field Description
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. For example, if data carrier detect (DCD) goes down and comes up,
the carrier transition counter will increment two times. 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 output 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
router 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 from being examined. Note that this might not balance with
the sum of the enumerated output errors because some datagrams can have
more than one error, and others can have errors that do not fall into any of
the specifically tabulated categories.
collisions Number of messages retransmitted because of an Ethernet collision. Some
collisions are normal. However, if your collision rate climbs to around 4
or 5 percent, 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.
alarm indications, remote Number of CSU/DSU alarms and number of occurrences of receive loss of
alarms, rx LOF, rx LOS frame and receive loss of signal.
BER inactive, NELR Status of G.703-E1 counters for bit-error rate (BER) alarm, near-end loop
inactive, FELR inactive remote (NELR), and far-end loop remote (FELR). Note that you cannot set
the NELR or FELR.

Cisco IOS Interface and Hardware Component Command Reference

IR-644
Interface and Hardware Component Commands
show interfaces serial

Example of PA-2JT2 Serial Interface

The following is sample output from the show interfaces serial command for a PA-2JT2 serial interface:
Router# show interfaces serial 3/0/0

Serial3/0/0 is up, line protocol is up

Hardware is cyBus Serial
Internet address is 10.0.0.1/8
MTU 1500 bytes, BW 6312 Kbit, DLY 20000 usec, rely 255/255, load 26/255
Encapsulation HDLC, loopback not set, keepalive not set
Last input 00:04:31, output 00:04:31, output hang never
Last clearing of “show interface” counters 00:06:07
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 162000 bits/sec, 8 packets/sec
5 minute output rate 162000 bits/sec, 8 packets/sec
20005 packets input, 20080520 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
20005 packets output, 20080520 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
0 carrier transitions
0 cv errors, 0 crc5 errors, 0 frame errors
rxLOS inactive, rxLOF inactive, rxPAIS inactive
rxAIS inactive, rxRAI inactive, rxHBER inactive

Table 68 describes significant fields shown in the display that are different from the fields described in
Table 67 on page 642.

Table 68 show interfaces serial Field Descriptions—PA-2JT2

Field Description
Last clearing of “show Time the counters were last cleared.
interface” counters
Queueing strategy First-in, first-out queueing strategy (other queueing strategies that you
might see are priority-list, custom-list, and weighted fair).
output buffer failures Number of “no resource” errors received on the output.
output buffers swapped out Number of packets swapped to DRAM.
carrier transitions Number of times the carrier detect signal of a serial interface has
changed state. For example, if data carrier detect (DCD) goes down and
comes up, the carrier transition counter will increment two times.
Indicates modem or line problems if the carrier detect line is changing
state often.
cv errors B8ZS/B6ZS (zero suppression) coding violation counter.
crc5 errors CRC-5 error counter.
frame errors Framing error counter.
rxLOS Receive loss of signal alarm. Values are active or inactive.
rxLOF Receive loss of frame alarm. Values are active or inactive.
rxPAIS Receive loss of payload alarm indication signal (AIS). Values are active
or inactive.
rxAIS Receive loss of physical AIS. Values are active or inactive.

Cisco IOS Interface and Hardware Component Command Reference

IR-645
 Interface and Hardware Component Commands
show interfaces serial

Table 68 show interfaces serial Field Descriptions—PA-2JT2 (continued)

Field Description
rxRAI Receive remote AIS. Values are active or inactive.
rxHBER Receive high bit-error rate alarm. Values are active or inactive.

Example of PA-E3 Serial Port Adapter

The following is sample output from the show interfaces serial command for a PA-E3 serial port adapter
installed in chassis slot 2:
Router# show interfaces serial 2/0

Serial2/0 is up, line protocol is up

Hardware is M1T-E3 pa
Internet address is 172.17.1.1/24
MTU 4470 bytes, BW 34010 Kbit, DLY 200 usec, rely 128/255, load 1/255
Encapsulation HDLC, loopback not set, keepalive not set
Last input 1w0d, output 00:00:48, output hang never
Last clearing of “show interface” counters 1w0d
Queueing strategy: fifo
Output queue 0/40, 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
20 packets input, 2080 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants, 0 parity
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
11472 packets output, 3824748 bytes, 0 underruns
0 output errors, 0 applique, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
0 carrier transitions
rxLOS inactive, rxLOF inactive, rxAIS inactive
txAIS inactive, rxRAI inactive, txRAI inactive

Table 69 describes significant fields shown in the display that are different from the fields described in
Table 67 on page 642.

Table 69 show interfaces serial Field Descriptions—PA-E3

Field Description
Last clearing of “show Time the counters were last cleared.
interface” counters
Queueing strategy First-in, first-out queueing strategy (other queueing strategies that you
might see are priority-list, custom-list, and weighted fair).
parity Number of the parity errors on the interface.
applique Indicates that an unrecoverable error has occurred on the E3 applique.
The router then invokes an interface reset.
output buffer failures Number of “no resource” errors received on the output.
output buffers swapped out Number of packets swapped to DRAM.

Cisco IOS Interface and Hardware Component Command Reference

IR-646
Interface and Hardware Component Commands
show interfaces serial

Table 69 show interfaces serial Field Descriptions—PA-E3 (continued)

Field Description
rxLOS, rxLOF, rxAIS Receive loss of signal, loss of frame, and alarm indication signal status.
Values are inactive or active.
txAIS, rxRAI, txRAI Transmit alarm indication signal, receive remote alarm indicator, and
transmit remote alarm indicator status. Values are inactive or active.
When the router receives an LOS, LOF, or AIS, the txRAI is active.
When the remote router receives an LOS, LOF, or AIS, the rxRAI is
active.

Example of 1-Port PA-T3 Serial Port Adapter Installed in a VIP2

The following is sample output from the show interfaces serial command for a 1-port PA-T3 serial port
adapter installed in a VIP2 in chassis slot 1, in port adapter slot 0:
Router# show interfaces serial 1/0/0

Serial1/0/0 is up, line protocol is up

Hardware is cyBus PODS3 Serial
Internet address is 172.18.1.1/24
MTU 4470 bytes, BW 44736 Kbit, DLY 200 usec, rely 255/255, load 1/255
Encapsulation HDLC, loopback not set, keepalive set (10 sec)
Last input 00:00:05, output 00:00:02, output hang never
Last clearing of “show interface” counters 5d02h
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 27269 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
79039 packets input, 14195344 bytes, 0 no buffer
Received 84506 broadcasts, 0 runts, 0 giants
0 parity
9574 input errors, 6714 CRC, 0 frame, 1 overrun, 0 ignored, 2859 abort
62472 packets output, 13751644 bytes, 0 underruns
0 output errors, 0 applique, 10 interface resets
0 output buffer failures, 0 output buffers swapped out
16 carrier transitions
rxLOS inactive, rxLOF inactive, rxAIS inactive
txAIS inactive, rxRAI inactive, txRAI inactive

Table 70 describes significant fields shown in the display that are different from the fields described in
Table 67 on page 642.

Table 70 show interfaces serial Field Descriptions—PA-T3

Field Description
Last clearing of “show Time the counters were last cleared.
interface” counters
Queueing strategy First-in, first-out queueing strategy (other queueing strategies that you
might see are priority-list, custom-list, and weighted fair).
parity Number of the parity errors on the interface.
applique Indicates that an unrecoverable error has occurred on the T3 applique. The
router then invokes an interface reset.
output buffer failures Number of “no resource” errors received on the output.

Cisco IOS Interface and Hardware Component Command Reference

IR-647
 Interface and Hardware Component Commands
show interfaces serial

Table 70 show interfaces serial Field Descriptions—PA-T3 (continued)

Field Description
output buffers swapped Number of packets swapped to DRAM.
out
rxLOS, rxLOF, rxAIS Receive loss of signal, loss of frame, and alarm indication signal status.
Values are inactive or active.
txAIS, rxRAI, txRAI Transmit alarm indication signal, receive remote alarm indicator, and
transmit remote alarm indicator status. Values are inactive or active. When
the router receives an LOS, LOF, or AIS, the txRAI is active. When the
remote router receives an LOS, LOF, or AIS, the rxRAI is active.

Example of CT3IP Serial Interface

The following is sample output from the show interfaces serial command for the CT3IP serial interface:
Router# show interfaces serial 3/0/0:25

Serial3/0/0:25 is up, line protocol is up

Hardware is cyBus T3
Internet address is 10.25.25.2/24
MTU 1500 bytes, BW 1536 Kbit, DLY 20000 usec, rely 255/255, load 12/255
Encapsulation HDLC, loopback not set, keepalive not set
Last input 00:19:01, output 00:11:49, output hang never
Last clearing of “show interface” counters 00:19:39
Input queue: 0/75/0 (size/max/drops); Total output drops: 0
Queueing strategy: weighted fair
Output queue: 0/64/0 (size/threshold/drops)
Conversations 0/1 (active/max active)
Reserved Conversations 0/0 (allocated/max allocated)
5 minute input rate 69000 bits/sec, 90 packets/sec
5 minute output rate 71000 bits/sec, 90 packets/sec
762350 packets input, 79284400 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
150 input errors, 0 CRC, 0 frame, 150 overrun, 0 ignored, 0 abort
763213 packets output, 80900472 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
0 carrier transitions no alarm present
Timeslot(s) Used:1-24, Transmitter delay is 0 flags, transmit queue length 5
non-inverted data

Table 71 describes significant fields relevant to the CT3IP shown in the display that are different from
the fields described in Table 67 on page 642.

Table 71 show interfaces serial Field Descriptions—CT3IP

Field Description
Timeslot(s) Used Number of time slots assigned to the T1 channel.
Transmitter delay Number of idle flags inserted between each HDLC frame.
transmit queue Number of packets allowed in the transmit queue.
length
non-inverted data Indicates whether or not the interface is configured for inverted data.

Cisco IOS Interface and Hardware Component Command Reference

IR-648
Interface and Hardware Component Commands
show interfaces serial

Example of an HDLC Synchronous Serial Interface on a Cisco 7500 Series Router

The following is sample output from the show interfaces serial command for an HDLC synchronous
serial interface on a Cisco 7500 series router:
Router# show interfaces serial 1/0

Serial1/0 is up, line protocol is up

Hardware is cxBus Serial
Internet address is 172.19.190.203, subnet mask is 255.255.255.0
MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation HDLC, loopback not set, keepalive set (10 sec)
Last input 0:00:07, output 0:00:00, output hang never
Last clearing of “show interface” counters 2w4d
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
22146 packets output, 2383680 bytes, 0 underruns
0 output errors, 0 collisions, 2 interface resets, 0 restarts
1 carrier transitions

Table 67 on page 642 describes significant fields shown in the display.

Example of HDLC Encapsulation

The following example displays High-Level Data Link Control (HDLC) encapsulation on serial interface
0:
Router# show interfaces serial 0

Serial0 is up, line protocol is up (looped)

Hardware is HD64570
Internet address is 10.1.1.1, subnet mask is 255.255.255.0
MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation HDLC, loopback set, keepalive set (10 sec)

Table 67 on page 642 describes significant fields shown in the display.

Example of a G.703 Interface with Framing

The following is sample output from the show interfaces serial command for a G.703 interface on which
framing is enabled:
Router# show interfaces serial 2/3

Serial2/3 is up, line protocol is up

Hardware is cxBus Serial
Internet address is 10.4.4.1, subnet mask is 255.255.255.0
MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation HDLC, loopback not set, keepalive not set
Last input 0:00:21, output 0:00:21, output hang never
Last clearing of “show interface” counters 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
53 packets input, 7810 bytes, 0 no buffer
Received 53 broadcasts, 0 runts, 0 giants
2 input errors, 2 CRC, 0 frame, 0 overrun, 0 ignored, 2 abort
56 packets output, 8218 bytes, 0 underruns
0 output errors, 0 collisions, 2 interface resets, 0 restarts
1 carrier transitions

Cisco IOS Interface and Hardware Component Command Reference

IR-649
 Interface and Hardware Component Commands
show interfaces serial

2 alarm indications, 333 remote alarms, 332 rx LOF, 0 rx LOS

RTS up, CTS up, DTR up, DCD up, DSR up
BER inactive, NELR inactive, FELR inactive

Table 67 on page 642 describes significant fields shown in the display.

Example with Frame Relay Encapsulation

When using Frame Relay encapsulation, use the show interfaces serial command to display information
on the multicast data-link connection identifier (DLCI), the DLCI of the interface, and the DLCI used
for the local management interface (LMI).
The multicast DLCI and the local DLCI can be set using the frame-relay multicast-dlci and
frame-relay local-dlci configuration commands. The status information is taken from the LMI, when
active.
The following is sample output from the show interfaces serial command when Frame Relay
encapsulation and LMI are enabled:
Router# show interfaces serial

Serial 2 is up, line protocol is up

Hardware type is MCI Serial
Internet address is 172.20.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 using the frame-relay multicast-dlci
interface configuration command.
The display shows the statistics for the LMI as 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). Refer to the Frame Relay Interface specification for additional explanations of this output.

Example with Frame Relay Queueing and Fragmentation at the Interface

The following is sample output from the show interfaces serial command when low-latency queueing
and FRF.12 end-to-end fragmentation are configured on a Frame Relay interface:
Router# show interfaces serial 3/2

Serial3/2 is up, line protocol is up

Hardware is M4T
MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation FRAME-RELAY, crc 16, loopback not set
Keepalive set (10 sec)
LMI enq sent 0, LMI stat recvd 0, LMI upd recvd 0, DTE LMI up
LMI enq recvd 0, LMI stat sent 0, LMI upd sent 0
LMI DLCI 1023 LMI type is CISCO frame relay DTE

Cisco IOS Interface and Hardware Component Command Reference

IR-650
Interface and Hardware Component Commands
show interfaces serial

Fragmentation type: end-to-end, size 80, PQ interleaves 0

Broadcast queue 0/64, broadcasts sent/dropped 0/0, interface broadcasts 0
Last input 2d15h, output 2d15h, output hang never
Last clearing of "show interface" counters 00:01:31
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: weighted fair
Output queue: 0/1000/64/0 (size/max total/threshold/drops)
Conversations 0/0/256 (active/max active/max total)
Reserved Conversations 0/0 (allocated/max allocated)
Available Bandwidth 1094 kilobits/sec
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 throttles
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, 1 interface resets
0 output buffer failures, 0 output buffers swapped out
1 carrier transitions DCD=up DSR=up DTR=up RTS=up CTS=up

Table 72 describes significant fields shown in the display that are different from the fields described in
Table 67 on page 642.

Table 72 show interfaces serial Field Descriptions—Frame Relay Interface Queueing and
Fragmentation

Field Description
txload Interface load in the transmit direction.
rxload Interface load in the receive direction.
crc Length the cyclic redundancy check (CRC) used on the interface.
LMI enq sent Number of Frame Relay status inquiry messages sent.
LMI stat recvd Number of Frame Relay status request messages received.
LMI upd recvd Number of single PVC asynchronous status messages received.
DTE LMI up LMI peers are synchronized.
LMI enq recvd Number of Frame Relay status inquiry messages received.
LMI stat sent Number of Frame Relay status request messages sent.
LMI upd sent Number of single PVC asynchronous status messages sent.
Fragmentation type Type of fragmentation: end-to-end, Cisco, or VoFR
size Fragmentation size.
PQ interleaves Number of priority queue frames that have interleaved data fragments.
Broadcast queue Number on queue/queue depth.
broadcasts Number of broadcasts sent and dropped.
sent/dropped
interface broadcasts Number of broadcasts sent on interface.
Input queue size—Current size of the input queue.
max—Maximum size of the queue.
drops—Number of messages discarded.
flushes—Number of times that data on queue has been discarded.
Queueing strategy Type of queueing configured on the interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-651
 Interface and Hardware Component Commands
show interfaces serial

Table 72 show interfaces serial Field Descriptions—Frame Relay Interface Queueing and
Fragmentation (continued)

Field Description
Output queue size—Current size of the output queue.
max total—Maximum number of frames that can be queued.
threshold—Congestive-discard threshold. Number of messages in the queue
after which new messages for high-bandwidth conversations are dropped.
drops—Number of dropped messages.
Conversations active—Number of currently active conversations.
max active—Maximum number of conversations that have ever occurred at
one time.
max total—Maximum number of active conversations allowed.
throttles Number of times the receiver on the port was disabled, possibly because of
processor or buffer overload.
output buffer failures Number of “no resource” errors received on the output.
output buffers swapped Number of packets swapped to DRAM.
out

Example with ANSI LMI

For a serial interface with the ANSI Local Management Interface (LMI) enabled, use the show
interfaces serial command to determine the LMI type implemented. The following is sample output
from the show interfaces serial command 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.18.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 serial output for a serial interface with ANSI LMI shown in this display
is very similar to that for encapsulation set to Frame Relay, as shown in the previous display. Table 73
describes the few differences that exist.

Cisco IOS Interface and Hardware Component Command Reference

IR-652
Interface and Hardware Component Commands
show interfaces serial

Table 73 show interfaces serial Field Descriptions—ANSI LMI

Field Description
LMI DLCI 0 Identifies the DLCI used by the LMI for this interface. The default is 1023.
LMI sent 10 Number of LMI packets that the router sent.
LMI type is ANSI Indicates that the interface is configured for the ANSI-adopted Frame
Annex D Relay specification T1.617 Annex D.

Example with LAPB Encapsulation

Use the show interfaces serial command to display operation statistics for an interface that uses Link
Access Procedure, Balanced (LAPB) encapsulation. The following is partial sample output from the
show interfaces serial command for a serial interface that uses LAPB encapsulation:
Router# show interfaces serial 1

LAPB state is SABMSENT, T1 3000, N1 12056, N2 20, k7,Protocol ip

VS 0, VR 0, RCNT 0, Remote VR 0, Retransmissions 2
IFRAMEs 0/0 RNRs 0/0 REJs 0/0 SABMs 3/0 FRMRs 0/0 DISCs 0/0

Table 74 shows the fields relevant to all LAPB connections.

Table 74 show interfaces serial Field Descriptions—LAPB

Field Description
LAPB state is State of the LAPB protocol.
T1 3000, N1 12056, ... Current parameter settings.
Protocol Protocol encapsulated on a LAPB link; this field is not present on
interfaces configured for multiprotocol LAPB or X.25 encapsulations.
VS Modulo 8 frame number of the next outgoing information frame.
VR Modulo 8 frame number of the next information frame expected to be
received.
RCNT Number of received information frames that have not yet been
acknowledged.
Remote VR Number of the next information frame that the remote device expects
to receive.
Retransmissions Count of current retransmissions because of expiration of T1.
Window is closed No more frames can be transmitted until some outstanding frames
have been acknowledged. This message should be displayed only
temporarily.
IFRAMEs Count of information frames in the form of sent/received.
RNRs Count of Receiver Not Ready frames in the form of sent/received.
REJs Count of Reject frames in the form of sent/received.
SABMs Count of Set Asynchronous Balanced Mode commands in the form of
sent/received.
FRMRs Count of Frame Reject frames in the form of sent/received.
DISCs Count of Disconnect commands in the form of sent/received.

Cisco IOS Interface and Hardware Component Command Reference

IR-653
 Interface and Hardware Component Commands
show interfaces serial

Example with PPP Encapsulation

The output for an interface configured for synchronous PPP encapsulation differs from the standard
show interfaces serial output. An interface configured for PPP might include the following
information:
Router# show interfaces serial 1

lcp state = OPEN

ncp ipcp state = OPEN ncp osicp state = NOT NEGOTIATED
ncp ipxcp state = NOT NEGOTIATED ncp deccp state = NOT NEGOTIATED
ncp bridgecp state = NOT NEGOTIATED ncp atalkcp state = NOT NEGOTIATED

Table 75 show the fields relevant to PPP connections.

Table 75 show interfaces serial Field Descriptions—PPP Encapsulation

Field Description
lcp state Link Control Protocol.
ncp ipcp state Network Control Protocol Internet Protocol Control Protocol.
ncp osicp state Network Control Protocol OSI (CLNS) Control Protocol.
ncp ipxcp state Network Control Protocol IPX (Novell) Control Protocol.
ncp deccp state Network Control Protocol DECnet Control Protocol.
ncp bridgecp state Network Control Protocol Bridging Control Protocol.
ncp atalkcp state Network Control Protocol AppleTalk Control Protocol.

Example with SDLC Connections

Use the show interfaces serial command to display the Synchronous Data Link Control (SDLC)
information for a given SDLC interface. The following is sample output from the show interfaces serial
command for an SDLC primary interface that supports the SDLLC function:
Router# show interfaces serial

Serial 0 is up, line protocol is up

Hardware is MCI Serial
MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation SDLC-PRIMARY, loopback not set
Timers (msec): poll pause 100 fair poll 500. Poll limit 1
[T1 3000, N1 12016, N2 20, K 7] timer: 56608 Last polled device: none
SDLLC [ma: 0000.0C01.14--, ring: 7 bridge: 1, target ring: 10
largest token ring frame 2052]
SDLC addr C1 state is CONNECT
VS 6, VR 3, RCNT 0, Remote VR 6, Current retransmit count 0
Hold queue: 0/12 IFRAMEs 77/22 RNRs 0/0 SNRMs 1/0 DISCs 0/0
Poll: clear, Poll count: 0, chain: p: C1 n: C1
SDLLC [largest SDLC frame: 265, XID: disabled]
Last input 00:00:02, output 00:00:01, output hang never
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 517 bits/sec, 30 packets/sec
Five minute output rate 672 bits/sec, 20 packets/sec
357 packets input, 28382 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
926 packets output, 77274 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets, 0 restarts
2 carrier transitions

Cisco IOS Interface and Hardware Component Command Reference

IR-654
Interface and Hardware Component Commands
show interfaces serial

Table 76 shows the fields relevant to all SDLC connections.

Table 76 show interfaces serial Field Descriptions—SDLC Enabled

Field Description
Timers (msec): poll pause, fair Current values of these timers for the primary SDLC interface.
poll, Poll limit
T1, N1, N2, K Values for these parameters for the primary SDLC interface.

Table 77 shows other data given for each SDLC secondary interface configured to be attached to the
serial interface.

Table 77 SDLC Secondary Interface Descriptions

Field Description
addr Address of this SDLC secondary interface.
state is Current state of this connection, which is one of the following:
• DISCONNECT—No communication is being attempted to
this secondary.
• CONNECT—A normal connect state exists between this
router and this secondary.
• DISCSENT—This router has sent a disconnect request to this
secondary and is awaiting its response.
• SNRMSENT—This router has sent a connect request
(SNRM) to this secondary and is awaiting its response.
• THEMBUSY—This secondary has told this router that it is
temporarily unable to receive any more information frames.
• USBUSY—This router has told this secondary that it is
temporarily unable to receive any more information frames.
• BOTHBUSY—Both sides have told each other that they are
temporarily unable to receive any more information frames.
• ERROR—This router has detected an error and is waiting for
a response from the secondary acknowledging this.
VS Sequence number of the next information frame that this station
sends.
VR Sequence number of the next information frame from this
secondary that this station expects to receive.
Remote VR Last frame transmitted by this station that has been acknowledged
by the other station.
Current retransmit count: Number of times the current I-frame or sequence of I-frames has
been retransmitted.
Hold Queue Number of frames in hold queue and maximum size of hold
queue.
IFRAMEs, RNRs, SNRMs, Sent/received count for these frames.
DISCs

Cisco IOS Interface and Hardware Component Command Reference

IR-655
 Interface and Hardware Component Commands
show interfaces serial

Table 77 SDLC Secondary Interface Descriptions (continued)

Field Description
Poll “Set” if this router has a poll outstanding to the secondary; “clear”
if it does not.
Poll Count Number of polls in a row that have been given to this secondary
at this time.
Chain Shows the previous (p) and next (n) secondary address on this
interface in the round robin loop of polled devices.

Example with SDLLC

Use the show interfaces serial command to display the SDLLC statistics for SDLLC-configured
interfaces. The following is sample output from the show interfaces serial command for a serial
interface configured for SDLLC:
Router# show interfaces serial

Serial 0 is up, line protocol is up

Hardware is MCI Serial
MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation SDLC-PRIMARY, loopback not set
Timers (msec): poll pause 100 fair poll 500. Poll limit 1
[T1 3000, N1 12016, N2 20, K 7] timer: 56608 Last polled device: none
SDLLC [ma: 0000.0C01.14--, ring: 7 bridge: 1, target ring: 10
largest token ring frame 2052]
SDLC addr C1 state is CONNECT
VS 6, VR 3, RCNT 0, Remote VR 6, Current retransmit count 0
Hold queue: 0/12 IFRAMEs 77/22 RNRs 0/0 SNRMs 1/0 DISCs 0/0
Poll: clear, Poll count: 0, chain: p: C1 n: C1
SDLLC [largest SDLC frame: 265, XID: disabled]
Last input 00:00:02, output 00:00:01, output hang never
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 517 bits/sec, 30 packets/sec
Five minute output rate 672 bits/sec, 20 packets/sec
357 packets input, 28382 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
926 packets output, 77274 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets, 0 restarts
6608 Last polled device: none
SDLLC [ma: 0000.0C01.14--, ring: 7 brid2 carrier transitions

Most of the output shown in the display is generic to all SDLC-encapsulated interfaces and is described
in the Cisco IOS Bridging and IBM Networking Command Reference, Volume 2 of 2: IBM Networking.
Table 78 shows the parameters specific to SDLLC.

Table 78 SDLLC Parameter Descriptions

Field Description
SDLLC ma Lists the MAC address configured for this interface. The last byte is
shown as “--” to indicate that it is filled in with the SDLC address of the
connection.
ring, bridge, target ring Lists the parameters as configured by the sdllc traddr command.
largest token ring frame Shows the largest Token Ring frame that is accepted on the Logical Link
control, type 2 (LLC2) side of the connection.

Cisco IOS Interface and Hardware Component Command Reference

IR-656
Interface and Hardware Component Commands
show interfaces serial

Table 78 SDLLC Parameter Descriptions (continued)

Field Description
largest SDLC frame Shows the largest SDLC frame that is accepted and will be generated on
the SDLC side of the connection.
XID Enabled or disabled: Shows whether XID processing is enabled on the
SDLC side of the connection. If enabled, it will show the XID value for
this address.

Example with X.25

The following is partial sample output from the show interfaces serial command for a serial X.25
interface:
Router# show interfaces serial 1

X25 address 000000010100, state R1, modulo 8, idle 0, timer 0, nvc 1

Window size: input 2, output 2, Packet size: input 128, output 128
Timers: T20 180, T21 200, T22 180, T23 180, TH 0
Channels: Incoming-only none, Two-way 1-1024, Outgoing-only none
(configuration on RESTART: modulo 8,
Window size: input 2 output 2, Packet size: input 128, output 128
Channels: Incoming-only none, Two-way 5-1024, Outgoing-only none)
RESTARTs 3/2 CALLs 1000+2/1294+190/0+0/ DIAGs 0/0

The stability of the X.25 protocol requires that some parameters not be changed without a restart of the
protocol. Any change to these parameters is held until a restart is sent or received. If any of these
parameters changes, information about the router configuration at restart will be displayed as well as the
values that are currently in effect.
Table 79 describes significant fields shown in the display.

Table 79 show interfaces serial Field Descriptions—X.25 Enabled

Field Description
X25 address Address used to originate and accept calls.
state State of the interface. Possible values follow:
• R1 is the normal ready state.
• R2 is the DTE restarting state.
• R3 is the DCE restarting state.
If the state is R2 or R3, the interface is awaiting acknowledgment of
a Restart packet.
modulo Modulo value; determines the packet sequence numbering scheme
used.
idle Number of minutes for which the Cisco IOS software waits before
closing idle virtual circuits that it originated or accepted.
timer Value of the interface timer, which is zero unless the interface state
is R2 or R3.
nvc Default maximum number of simultaneous virtual circuits
permitted to and from a single host for a particular protocol.

Cisco IOS Interface and Hardware Component Command Reference

IR-657
 Interface and Hardware Component Commands
show interfaces serial

Table 79 show interfaces serial Field Descriptions—X.25 Enabled (continued)

Field Description
Window size: input, output Default window sizes (in packets) for the interface. The x25 facility
interface configuration command can be used to override these
default values for the switched virtual circuits originated by the
router.
Packet size: input, output Default maximum packet sizes (in bytes) for the interface. The
x25 facility interface configuration command can be used to
override these default values for the switched virtual circuits
originated by the router.
Timers: Values of the X.25 timers:
• T10 through T13 for a DCE device
• T20 through T23 for a DTE device
TH Packet acknowledgment threshold (in packets). This value
determines how many packets are received before an explicit
acknowledgment is sent. The default value (0) sends an explicit
acknowledgment only when the incoming window is full.
Channels: Incoming-only, Displays the virtual circuit ranges for this interface.
Two-way, Outgoing-only
RESTARTs Shows Restart packet statistics for the interface using the format
Sent/Received.
CALLs Successful calls sent + failed calls/calls received + calls failed/calls
forwarded + calls failed. Calls forwarded are counted as calls sent.
DIAGs Diagnostic messages sent and received.

Example with Accounting Option

The following example illustrates the show interfaces serial command with the accounting option on
a Cisco 7500 series routers:
Router# show interfaces serial 1/0 accounting

Serial1/0
Protocol Pkts In Chars In Pkts Out Chars Out
IP 7344 4787842 1803 1535774
Appletalk 33345 4797459 12781 1089695
DEC MOP 0 0 127 9779
ARP 7 420 39 2340

Table 80 describes the fields shown in the display.

Cisco IOS Interface and Hardware Component Command Reference

IR-658
Interface and Hardware Component Commands
show interfaces serial

Table 80 show interfaces serial Field Descriptions—Accounting

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

Example with Cisco AS5800 Access Server

The following example shows the activity that occurred on the serial interface in shelf 1, slot 4, port 0
for time slot 2 in group 23:
Router# show interfaces serial 1/4/0:2:23

Serial1/4/0:2:23 is up, line protocol is up (spoofing)

Hardware is DS-T1
MTU 1500 bytes, BW 64 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation HDLC, loopback not set
Last input 00:00:01, output 00:00:01, output hang never
Last clearing of "show interface" counters 22:24:30
Queueing strategy: fifo
Output queue 0/40, 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

5274 packets input, 20122 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
5274 packets output, 30836 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
2 carrier transitions no alarm present
Timeslot(s) Used:24, subrate: 64Kb/s, transmit delay is 0 flags

Table 81 describes the significant fields shown in the display that are different from the fields described
in Table 67 on page 642.

Table 81 show interfaces serial Command Field Descriptions—Cisco AS5800

Field Description
Last clearing of “show interface” Time at which the counters that measure cumulative statistics
counters (such as number of bytes transmitted and received) were last reset
to zero.
Queueing strategy Displays the type of queueing configured for this interface. In the
example output, the type of queueing configured is FIFO.
throttles Number of times that the receiver on the port was disabled,
possibly because of buffer or processor overload.
output buffer failures Number of times that the output buffer has failed.
output buffer swapped out Number of times that the output buffer has been swapped out.
Timeslot(s) Used Number of time slots assigned to the T1 channel.

Cisco IOS Interface and Hardware Component Command Reference

IR-659
 Interface and Hardware Component Commands
show interfaces serial

Table 81 show interfaces serial Command Field Descriptions—Cisco AS5800 (continued)

Field Description
subrate Bandwidth of each time slot.
transmit delay is ... Number of idle flags inserted between each frame.

Related Commands Command Description

show controllers serial Displays information about the virtual serial interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-660
 Interface and Hardware Component Commands
show interfaces tokenring

show interfaces tokenring

To display information about the Token Ring interface and the state of source route bridging, use the
show interfaces tokenring command in privileged EXEC mode.
Standard Syntax

show interfaces tokenring number [accounting]

Cisco 7200 and Cisco 7500 Series

show interfaces tokenring slot/port [accounting]

Cisco 7500 Series with Ports on VIPs

show interfaces tokenring [slot/port-adapter/port]

Syntax Description number Interface port line number.

accounting (Optional) Displays the number of packets of each protocol type that have been
sent through the interface.
slot On the Cisco 7000 series routers, slot location of the interface processor. On
the Cisco 7000, the value can be 0, 1, 2, 3, or 4. On the Cisco 7010, the value
can be 0, 1, or 2.
On the Cisco 7200 series routers, slot location of the port adapter; the value can
be 1, 2, 3, 4, 5, or 6.
/port Port number on the interface. On the Cisco 7000 series routers this argument
is required, and the values can be 0, 1, 2, or 3.
(Optional) For the VIP, this argument is optional, and the port value can be 0,
1, 2, or 3 for 4-port Token Ring interfaces.
On the Cisco 7200 series routers, the number depends on the type of port
adapter installed.
/port-adapter (Optional) On the Cisco 7000 series and Cisco 7500 series routers, specifies
the ports on a VIP. The value can be 0 or 1.

Command Modes Privileged EXEC

Command History Release Modification

10.0 This command was introduced.
11.3(3)T The information was modified to include the PA-4R-FDX full-duplex Token
Ring port adapter.

Usage Guidelines If you do not provide values for the slot and port arguments, the command displays statistics for all the
network interfaces. The optional accounting keyword displays the number of packets of each protocol
type that have been sent through the interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-661
 Interface and Hardware Component Commands
show interfaces tokenring

Examples 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 10.136.230.203, subnet mask is 255.255.255.0
MTU 8136 bytes, BW 16000 Kbit, DLY 630 usec, rely 255/255, load 1/255
Encapsulation SNAP, loopback not set, keepalive set (10 sec)
ARP type: SNAP, ARP Timeout 4:00:00
Ring speed: 16 Mbps
Single ring node, Source Route Bridge capable
Group Address: 0x00000000, Functional Address: 0x60840000
Last input 0:00:01, output 0:00:01, output hang never
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 0 bits/sec, 0 packets/sec
Five minute output rate 0 bits/sec, 0 packets/sec
16339 packets input, 1496515 bytes, 0 no buffer
Received 9895 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
32648 packets output, 9738303 bytes, 0 underruns
0 output errors, 0 collisions, 2 interface resets, 0 restarts
5 transitions

Table 82 describes the significant fields shown in the displays.

Table 82 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).
On the Cisco 7500 series routers, gives the interface processor type,
slot number, and port number.
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 Hardware has been taken down by an administrator.
Administratively Down
line protocol is {up | down | Indicates whether the software processes that handle the line
administratively down} 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 Internet 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 percent reliability), calculated as an exponential average over
5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely
saturated), calculated as an exponential average over 5 minutes.

Cisco IOS Interface and Hardware Component Command Reference

IR-662
Interface and Hardware Component Commands
show interfaces tokenring

Table 82 show interfaces tokenring Field Descriptions (continued)

Field Description
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 may share the same
group address. Each interface may have at most one group address.
Functional Address: Bit-significant group address. Each “on” bit represents a function
performed by the station.
Ethernet Transit OUI: The Organizational Unique Identifier (OUI) code to be used in the
encapsulation of Ethernet Type II frames across Token Ring
backbone networks.
Last input Number of hours, minutes, and seconds since the last packet was
successfully received by an interface and processed locally on the
router. Useful for knowing when a dead interface failed. This
counter is updated only when packets are process-switched, not
when packets are fast-switched.
Last output Number of hours, minutes, and seconds since the last packet was
successfully transmitted by an interface. This counter is updated
only when packets are process-switched, not when packets are
fast-switched.
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 231 ms (and
less than 232 ms) ago.
Output queue, drops Number of packets in output and input queues. Each number is
Input queue, drops followed by a slash, the maximum size of the queue, and the number
of packets dropped because of a full queue.

Cisco IOS Interface and Hardware Component Command Reference

IR-663
 Interface and Hardware Component Commands
show interfaces tokenring

Table 82 show interfaces tokenring Field Descriptions (continued)

Field Description
Five minute input rate, Average number of bits and packets transmitted per second in the
Five minute output rate last 5 minutes.
The 5-minute input and output rates should be used only as an
approximation of traffic per second during a given 5-minute period.
These rates are exponentially weighted averages with a time
constant of 5 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 input 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 Ethernet networks 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 minimum packet size of the medium.
giants Number of packets that are discarded because they exceed the of
them medium maximum packet size.
CRC 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 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 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 router’s receiver can handle. This may never be
reported on some interfaces.

Cisco IOS Interface and Hardware Component Command Reference

IR-664
Interface and Hardware Component Commands
show interfaces tokenring

Table 82 show interfaces tokenring Field Descriptions (continued)

Field Description
output errors Sum of all errors that prevented the final transmission of datagrams
out of the interface being examined. Note that this may not balance
with the sum of the enumerated output errors, as some datagrams
may have more than one error, and others may 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.

The following is sample output from the show interfaces tokenring command on a Cisco 7500 series
routers:
Router# show interfaces tokenring 2/0

TokenRing2/0 is administratively down, line protocol is down

Hardware is cxBus Token Ring, address is 0000.3040.8b4a (bia 0000.3040.8b4a)
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: 0 Mbps
Single ring node, Source Route Transparent Bridge capable
Ethernet Transit OUI: 0x0000F8
Last input never, output never, output hang never
Last clearing of “show interface” counters 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
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, 1 interface resets, 0 restarts
1 transitions

The following example on the Cisco 7500 series routers includes the accounting option. When you use
the accounting option, only the accounting statistics are displayed.
Router# show interfaces tokenring 2/0 accounting

TokenRing2/0
Protocol Pkts In Chars In Pkts Out Chars Out
IP 7344 4787842 1803 1535774
Appletalk 33345 4797459 12781 1089695
DEC MOP 0 0 127 9779
ARP 7 420 39 2340

Table 83 describes the fields shown in the display.

Cisco IOS Interface and Hardware Component Command Reference

IR-665
 Interface and Hardware Component Commands
show interfaces tokenring

Table 83 show interfaces tokenring Field Descriptions—Accounting

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

Cisco IOS Interface and Hardware Component Command Reference

IR-666
 Interface and Hardware Component Commands
show interfaces tunnel

show interfaces tunnel

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

show interfaces tunnel number [accounting]

Syntax Description number Port line number.

accounting (Optional) Displays the number of packets of each protocol type that have been
sent through the interface.

Command Modes Privileged EXEC

Command History Release Modification

10.0 This command was introduced.

Examples The following is sample output from the show interfaces 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 packets output, 0 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets, 0 restarts

Table 84 describes significant fields shown in the display.

Cisco IOS Interface and Hardware Component Command Reference

IR-667
 Interface and Hardware Component Commands
show interfaces tunnel

Table 84 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).
On the Cisco 7500 series routers, gives the interface processor type, slot
number, and port number.
line protocol is {up | down | Shows line protocol up if a valid route is available to the tunnel
administratively down} 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 percent
reliability), calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely
saturated), calculated as an exponential average over 5 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 and processed locally on the router.
Useful for knowing when a dead interface failed. This counter is updated
only when packets are process-switched, not when packets are
fast-switched.
Last output Number of hours, minutes, and seconds since the last packet was
successfully transmitted by an interface. This counter is updated only
when packets are process-switched, not when packets are fast-switched.
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.

Cisco IOS Interface and Hardware Component Command Reference

IR-668
Interface and Hardware Component Commands
show interfaces tunnel

Table 84 show interfaces tunnel Field Descriptions (continued)

Field Description
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 231 ms (and less
than 232 ms) ago.
Output queue, drops Number of packets in output and input queues. Each number is followed
Input queue, drops by a slash, the maximum size of the queue, and the number of packets
dropped because of a full queue.
Five minute input rate, Average number of bits and packets transmitted per second in the last
Five minute output rate 5 minutes.
The 5-minute input and output rates should be used only as an
approximation of traffic per second during a given 5-minute period.
These rates are exponentially weighted averages with a time constant of
5 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
Ethernet networks 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
minimum packet size of them medium.
giants Number of packets that are discarded because they exceed the maximum
packet size of the medium.
CRC 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 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.

Cisco IOS Interface and Hardware Component Command Reference

IR-669
 Interface and Hardware Component Commands
show interfaces tunnel

Table 84 show interfaces tunnel Field Descriptions (continued)

Field Description
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 router’s receiver 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 may not balance with the
sum of the enumerated output errors, as some datagrams may have more
than one error, and others may have errors that do not fall into any of the
specifically tabulated categories.
collisions Number of messages retransmitted because of an Ethernet collision.
Some collisions are normal. However, if your collision rate climbs to
around 4 or 5 percent, 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 that the controller was restarted because of errors.

Related Commands Command Description

show interfaces serial Displays the statistical information specific to a serial interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-670
 Interface and Hardware Component Commands
show interfaces vg-anylan

show interfaces vg-anylan

To display the information about the 100VG-AnyLAN port adapter on Cisco 7200 series routers and
Cisco 7500 series routers, use the show interfaces vg-anylan command in user EXEC or privileged
EXEC mode.

Cisco 7200 Series

show interfaces vg-anylan [slot/port]

Cisco 7500 Series with VIPs

show interfaces vg-anylan [slot/port-adapter/port]

Syntax Description slot (Optional) Slot number. Refer to the appropriate hardware manual for slot and
port information.
port (Optional) Port number. Refer to the appropriate hardware manual for slot and
port information.
port-adapter (Optional) Port adapter number. Refer to the appropriate hardware manual for
information about port adapter compatibility.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

11.3 This command was introduced.

Examples The following is sample output from the show interfaces vg-anylan command:
Router# show interfaces vg-anylan 3/0/0

VG-AnyLAN3/0/0 is up, line protocol is up

Hardware is cyBus VG-AnyLAN Interface
Frame type is 802.3, address is 0060.3e64.2460 (bia 0060.3e64.2460)
Internet address is 10.1.1.5/16
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec, rely 255/255, load 1/255
Encapsulation ARPA, loopback not set, keepalive set (10 sec)
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:00:26, output 00:00:09, output hang never
Last clearing of “show interface” counters never
Queueing strategy: fifo
Output queue 0/40, 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
5316 packets input, 857349 bytes, 0 no buffer
Received 5310 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
7920 packets output, 754259 bytes, 0 underruns

Cisco IOS Interface and Hardware Component Command Reference

IR-671
 Interface and Hardware Component Commands
show interfaces vg-anylan

0 output errors, 0 collisions, 2 interface resets

0 output buffer failures, 0 output buffers swapped out
0 vg alignment error, 0 vg balance error
0 vg invalid ipm error, 0 vg symbol error
0 vg skew error, 0 vg frame delimit error
0 vg high priority packets, 0 vg high priority octets
0 output errors, 0 collisions, 2 interface resets
0 output buffer failures, 0 output buffers swapped out
0 vg alignment error, 0 vg balance error
0 vg invalid ipm error, 0 vg symbol error
0 vg skew error, 0 vg frame delimit error
0 vg high priority packets, 0 vg high priority octets

Table 85 describes significant fields shown in the display.

Table 85 show interfaces vg-anylan Field Descriptions

Field Description
VG-AnyLAN3/0/0 is up, line Indicates if the interface hardware is currently active and can transmit
protocol is up and receive or if it has been taken down by an administrator.
Hardware is cyBus Hardware type.
VG-AnyLAN
Frame type is 803.2 Currently the frame type supported is 803.2.
Internet address Internet address and 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 percent
reliability), calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely
saturated), calculated as an exponential average over 5 minutes. The
calculation uses the value from the bandwidth interface configuration
command.
Encapsulation Encapsulation method assigned to the interface.
loopback Indicates if loopbacks are set.
keepalive Indicates if keepalives are set.
ARA type ARP type on the interface.
Last input Number of hours, minutes, and seconds since the last packet was
successfully received by an interface and processed locally on the
router. Useful for knowing when a dead interface failed. This counter
is updated only when packets are process-switched, not when packets
are fast-switched.
output Number of hours, minutes, and seconds since the last packet was
successfully transmitted by an interface. This counter is updated only
when packets are process-switched, not when packets are
fast-switched.

Cisco IOS Interface and Hardware Component Command Reference

IR-672
Interface and Hardware Component Commands
show interfaces vg-anylan

Table 85 show interfaces vg-anylan Field Descriptions (continued)

Field Description
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. 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 231 ms (and less
than 232 ms) ago.
Queueing strategy First-in, first-out queueing strategy (other queueing strategies that you
might see are priority-list, custom-list, and weighted fair).
Output queue, drops Number of packets in output and input queues. Each number is
input queue, drops followed by a slash, the maximum size of the queue, and the number
of packets dropped because a queue was full.
5 minute input rate Average number of bits and packets received or transmitted per second
5 minute output rate in the last 5 minutes.
packets input Total number of error-free packets received by the system.
bytes (input) 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 Ethernet networks 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 minimum packet size of the medium.
giants Number of packets that are discarded because they exceed the
maximum packet size of the medium.
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 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.

Cisco IOS Interface and Hardware Component Command Reference

IR-673
 Interface and Hardware Component Commands
show interfaces vg-anylan

Table 85 show interfaces vg-anylan Field Descriptions (continued)

Field Description
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 the interface.
input packets with dribble Dribble bit error indicates that a frame is slightly too long. This frame
condition detected error counter is incremented just for informational purposes; the
router accepts the frame.
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 router’s receiver can handle.
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 can
have more than one error, and others can have errors that do not fall
into any of the specifically tabulated categories.
collisions Number of messages retransmitted because of an Ethernet collision. 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 a
certain interval. If the system notices that the carrier detect line of an
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 unrecoverable interface processor error occurred, or when an
interface is looped back or shut down.
output buffer failures Number of times that a packet was not output from the output hold
queue because of a shortage of MEMD shared memory.
output buffers swapped out Number of packets stored in main memory when the output queue is
full; swapping buffers to main memory prevents packets from being
dropped when output is congested. The number is high when traffic is
bursty.
vg alignment error Number of nonoctets received.
vg balance error Number of incorrect balanced symbols received.
vg invalid ipm error Number of packets received with an invalid packet marker (IPM).

Cisco IOS Interface and Hardware Component Command Reference

IR-674
 Interface and Hardware Component Commands
show interfaces vg-anylan

Table 85 show interfaces vg-anylan Field Descriptions (continued)

Field Description
vg symbol error Number of symbols received that were not correctly decoded.
vg skew error Number of skews between four pairs of twisted-pair wire that
exceeded the allowable skew.
vg frame delimit error Number of start-of-frame errors or false-start errors received.
vg high priority packets Number of high-priority packets received.
vg high priority octets Number of high-priority octets received.

Related Commands Command Description

interface vg-anylan Specifies the interface on a 100VG-AnyLAN port adapter and enters
interface configuration mode on Cisco 7200 series routers and Cisco 7500
series routers.

Cisco IOS Interface and Hardware Component Command Reference

IR-675
 Interface and Hardware Component Commands
show ipc

show ipc
To display interprocess communication (IPC) statistics, use the show ipc command in privileged EXEC
mode.

show ipc {nodes | ports [open] | queue | status [cumulative] | zones}

Syntax Description nodes Displays participating nodes.

ports Displays local and registered IPC ports.
open (Optional) Displays local IPC ports that have been opened by the current seat
(node).
queue Displays information about the IPC retransmission queue and the IPC
message queue.
status Displays the status of the local IPC server.
cumulative (Optional) Displays cumulative totals for the status counters of the local IPC
server since the router was rebooted.
zones Displays information about the IPC zones and seats.

Command Modes Privileged EXEC

Command History Release Modification

12.1(12c)EW This command was introduced.
12.2(15)T The cumulative keyword was added.
12.3(7)T The zones keyword was added.

Usage Guidelines The Cisco IOS version of IPC provides a reliable ordered delivery of messages using an underlying platform driver
transport or UDP transport protocol.

Nodes
A node (referred to as a seat) is an intelligent element like a processor that can communicate using IPC
services. A seat is where entities and ports reside. A seat manager performs all the interprocessor
communications by receiving messages from the network and forwarding the messages to the
appropriate port.

Ports
IPC communication endpoints (ports) receive and queue received IPC messages.

Queue
Use the queue keyword to display information about the IPC retransmission queue and the IPC message
queue.

Cisco IOS Interface and Hardware Component Command Reference

IR-676
 Interface and Hardware Component Commands
show ipc

Status
Use the status keyword to display the IPC statistics that have been generated since a clear ipc statistics
command was entered. The show ipc status command with the cumulative keyword displays the IPC
statistics that have been gathered since the router was rebooted, regardless of how many times the
statistics have been cleared.

Zones
The IPC zone manager allows more than one group of IPC seats to exist to enable direct communication
between line cards and the route processor. Use the zones keyword to display the IPC zone and seat
information.

Examples The following is sample output from the show ipc command with the nodes keyword displaying the
participating seats (nodes):
Router# show ipc nodes

There are 6 nodes in this IPC realm.

ID Type Name Last Last
Sent Heard
0.10000 Local IPC Master 0 0
0.1060000 RSP-CY RSP IPC card slot 6 9 79
0.1050000 RSP-CY RSP IPC card slot 5 21 22
0.1080000 RSP-CY RSP IPC card slot 8 21 22
1.10000 Local IPC Master: -Zone#1 0 0
2.10000 Local IPC Master: -Zone#2

Table 86 describes the significant fields shown in the display.

Table 86 show ipc nodes Field Descriptions

Field Description
ID Port ID, which consists of a zone ID followed by the seat ID.
Type Type of seat (node).
Name Seat name.
Last Sent Sequence number of the message that was last sent.
Last Heard Sequence number of the in-sequence message that was last heard.

The following is sample output from the show ipc command with the ports keyword displaying the local
and registered IPC ports:
Router# show ipc ports

There are 11 ports defined.

Port ID Type Name (current/peak/total)

1.10000.1 unicast IPC Master:Zone
1.10000.2 unicast IPC Master:Echo
1.10000.3 unicast IPC Master:Control
1.10000.4 unicast Remote TTY Server Port
1.10000.5 unicast GALIOS RF :Active
index = 0 seat_id = 0x2020000 last sent = 0 heard = 1635 0/1/1635

1.10000.6 unicast GALIOS RED:Active

index = 0 seat_id = 0x2020000 last sent = 0 heard = 2 0/1/2

Cisco IOS Interface and Hardware Component Command Reference

IR-677
 Interface and Hardware Component Commands
show ipc

2.2020000.3 unicast GALIOS IPC:Card 2:Control

2.2020000.4 unicast GALIOS RFS :Standby
2.2020000.5 unicast Slave: Remote TTY Client Port
2.2020000.6 unicast GALIOS RF :Standby
2.2020000.7 unicast GALIOS RED:Standby
RPC packets: current/peak/total 0/1/17

Table 87 describes the significant fields shown in the display.

Table 87 show ipc ports Field Descriptions

Field Description
Port ID Port ID, which consists of a zone ID followed by the seat ID.
Type Type of port.
Name Port name.
current/peak/total Displays information about the number of messages held by this IPC
session.

The following is sample output from the show ipc command with the queue keyword displaying
information about the IPC retransmission queue and the IPC message queue:
Router# show ipc queue

There are 0 IPC messages waiting for acknowledgement in the transmit queue.
There are 0 IPC messages waiting for a response.
There are 0 IPC messages waiting for additional fragments.
There are 0 IPC messages currently on the IPC inboundQ.
There are 0 messages currently in use by the system.

The following is sample output from the show ipc command with the status keyword displaying
information about the local IPC server:
Router# show ipc status

IPC System Status

Time last IPC stat cleared : never

This processor is the IPC master server.

Do not drop output of IPC frames for test purposes.

1000 IPC Message Headers Cached.

Rx Side Tx Side

Total Frames 189 140

Total from Local Ports 189 70
Total Protocol Control Frames 70 44
Total Frames Dropped 0 0

Service Usage

Total via Unreliable Connection-Less Service 145 0

Total via Unreliable Sequenced Connection-Less Svc 0 0
Total via Reliable Connection-Oriented Service 44 70

IPC Protocol Version 0

Cisco IOS Interface and Hardware Component Command Reference

IR-678
Interface and Hardware Component Commands
show ipc

Total Acknowledgements 70 44
Total Negative Acknowledgements 0 0

Device Drivers

Total via Local Driver 0 0

Total via Platform Driver 0 70
Total Frames Dropped by Platform Drivers 0 0

Reliable Tx Statistics

Re-Transmission 0
Re-Tx Timeout 0

Rx Errors Tx Errors

Unsupp IPC Proto Version 0 Tx Session Error 0

Corrupt Frame 0 Tx Seat Error 0
Duplicate Frame 0 Destination Unreachable 0
Out-of-Sequence Frame 0 Tx Test Drop 0
Dest Port does Not Exist 0 Tx Driver Failed 0
Rx IPC Msg Alloc Failed 0 Ctrl Frm Alloc Failed 0
Unable to Deliver Msg 0

Buffer Errors Misc Errors

IPC Msg Alloc 0 IPC Open Port 0

Emer IPC Msg Alloc 0 No HWQ 0
IPC Frame PakType Alloc 0 Hardware Error 0
IPC Frame MemD Alloc 0

Tx Driver Errors

No Transport 0
MTU Failure 0
Dest does not Exist 0

Table 88 describes the significant fields shown in the display.

Table 88 show ipc status Field Descriptions

Field Description
Time last IPC stat cleared Displays the time, in dd:hh:mm (or never), since the IPC statistics
were last cleared.
This processor is Shows whether the processor is the IPC master or an IPC slave.
IPC Message Headers Cached Number of message headers available in the IPC message cache.
Rx Side Information about IPC messages received.
Tx Side Information about IPC messages sent.
Service Usage Number of IPC messages received or sent via connectionless or
connection-oriented protocols.
IPC Protocol Version 0 Number of acknowledgements and negative acknowledgements
received or sent by the system.
Device Drivers Number of IPC messages received or sent using the underlying
device drivers.
Reliable Tx Statistics Number of IPC messages that were retransmitted or that timed out
on retransmission using a reliable connection-oriented protocol.

Cisco IOS Interface and Hardware Component Command Reference

IR-679
 Interface and Hardware Component Commands
show ipc

Table 88 show ipc status Field Descriptions (continued)

Field Description
Rx Errors Number of IPC messages received that displayed various internal
frame or delivery errors.
Tx Errors Number of IPC messages sent that displayed various transmission
errors.
Buffer Errors Number of message allocation failures from the IPC message cache,
IPC emergency message cache, IPC frame allocation cache, and IPC
frame memory allocation cache.
Misc Errors Various miscellaneous errors that relate to the IPC open queue, to
the hardware queue, or to other hardware failures.
Tx Driver Errors Number of messages that relate to IPC transmission driver failures
including messages to or from a destination without a valid
transport entity from the seat; number of messages dropped because
the packet size is larger than the maximum transmission unit
(MTU); and number of messages without a valid destination
address.

The following example shows how to display cumulative IPC counters for the local IPC server. Note that
the recent IPC clearing has not cleared the IPC counters because the cumulative keyword displays the
IPC statistics that have been generated since the router was rebooted.
Router# show ipc status cumulative

IPC System Status

Time last IPC stat cleared : 00:00:05

This processor is the IPC master server.

Do not drop output of IPC frames for test purposes.

1000 IPC Message Headers Cached.

Rx Side Tx Side

Total Frames 3473 184

Total from Local Ports 3473 92
Total Protocol Control Frames 92 54
Total Frames Dropped 0 0

Service Usage

Total via Unreliable Connection-Less Service 2449 0

Total via Unreliable Sequenced Connection-Less Svc 970 0
Total via Reliable Connection-Oriented Service 54 92

IPC Protocol Version 0

Total Acknowledgements 0 0
Total Negative Acknowledgements 0 0

Device Drivers

Total via Local Driver 0 0

Total via Platform Driver 0 92
Total Frames Dropped by Platform Drivers 0 0

Cisco IOS Interface and Hardware Component Command Reference

IR-680
 Interface and Hardware Component Commands
show ipc

Reliable Tx Statistics

Re-Transmission 0
Re-Tx Timeout 0

Rx Errors Tx Errors

Unsupp IPC Proto Version 0 Tx Session Error 0

Corrupt Frame 0 Tx Seat Error 0
Duplicate Frame 0 Destination Unreachable 0
Out-of-Sequence Frame 0 Tx Test Drop 0
Dest Port does Not Exist 0 Tx Driver Failed 0
Rx IPC Msg Alloc Failed 0 Ctrl Frm Alloc Failed 0
Unable to Deliver Msg 0

Buffer Errors Misc Errors

IPC Msg Alloc 0 IPC Open Port 0

Emer IPC Msg Alloc 0 No HWQ 0
IPC Frame PakType Alloc 0 Hardware Error 0
IPC Frame MemD Alloc 0

Tx Driver Errors

No Transport 0
MTU Failure 0
Dest does not Exist 0

The following is sample output from the show ipc command with the zones keyword displaying
information about the IPC zones and seats:
Router# show ipc zones

There are 3 Zones in this IPC realm.

Zone ID Seat ID Name

0 10000 IPC Default Zone
1 10000 IPC TEST ZONE#1
2 10000 IPC TEST ZONE#2

Table 89 describes the significant fields shown in the display.

Table 89 show ipc zones Field Descriptions

Field Description
Zone ID Zone number.
Seat ID Seat number.
Name Zone name.

Related Commands Command Description

clear ipc statistics Clears and resets the IPC statistics.

Cisco IOS Interface and Hardware Component Command Reference

IR-681
 Interface and Hardware Component Commands
show pas caim

show pas caim

To show debug information about the data compression Advanced Interface Module (CAIM) daughter
card, use the show pas caim command in user EXEC or privileged EXEC mode.

show pas caim {rings | dma | coprocessor | stats | cnxt_table | page_table} element-number

Syntax Description rings element-number Displays current content of the Direct Memory Access (DMA) ring
buffer.
dma element-number Displays registers of the Jupiter DMA controller.
coprocessor element-number Displays registers of the Hifn 9711 compression coprocessor.
stats element-number Displays statistics that describes operation of the data compression
Advanced Interface Module (AIM).
cnxt_table element-number Displays the context of the specific data compression AIM element.
page_table element-number Displays the page table for each CAIM element.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

12.0(2)T This command was introduced.

Usage Guidelines This command displays performance statistics that describe the operation of the CAIM. This command
is primarily intended for engineering debug, but it can also be useful to Cisco support personnel and to
Cisco customers in troubleshooting network problems. Table 90 lists the output values for this
command.

Table 90 show pas caim Output Values and Descriptions

Value Description
uncomp paks in Number of packets containing uncompressed data input to the
CAIM for compression.
comp paks out Number of packets containing uncompressed data that were
successfully compressed.
comp paks in Number of packets containing compressed data input to the CAIM
for compression.
uncomp paks out Number of packets containing compressed data that were
successfully decompressed.

Cisco IOS Interface and Hardware Component Command Reference

IR-682
Interface and Hardware Component Commands
show pas caim

Table 90 show pas caim Output Values and Descriptions (continued)

Value Description
uncomp bytes in / comp bytes out Summarizes the compression performance of the CAIM. The
“uncomp bytes in” statistic gives the total number of uncompressed
bytes submitted to the CAIM for compression. The “Comp bytes
out” statistic gives the resulting number of compressed bytes
output by the CAIM. If one forms the ratio of “uncomp bytes in” to
“comp bytes out”, one obtains the average compression ratio
achieved by the CAIM.
comp bytes in / uncomp bytes out Summarizes the decompression performance of the CAIM. The
“comp bytes in” statistic gives the total number of compressed
bytes submitted to the CAIM for decompression. The “uncomp
bytes out” statistic gives the resulting number of uncompressed
bytes output by the CAIM. The average decompression ratio
achieved can be computed as the ratio of “uncomp bytes out” to
“comp bytes in”.
Note that each packet submitted for compression or decompression
has a small header at the front which is always clear data and hence
never compressed nor decompressed. The “comp bytes in / uncomp
bytes out” and “uncomp bytes in / comp bytes out” statistics do not
include this header.
uncomp paks/sec in A time average of the number of packets per second containing
uncompressed data submitted as input to the CAIM for
compression. It is computed as the ratio of the “uncomp paks in”
statistic to the “seconds since last clear” statistic.
comp paks/sec out A time average of the number of packets per second containing
uncompressed data which were successfully compressed by the
CAIM. It is computed as the ratio of the “comp paks out” statistic
to the “seconds since last clear” compressed by the CAIM. It is
computed as the ratio of the “comp paks out” statistic to the
“seconds since last clear” statistic.
comp paks/sec in A time average of the number of packets per second containing
compressed data submitted as input to the CAIM for
decompression. It is computed as the ratio of the “comp paks in”
statistic to the “seconds since last clear” statistic.

Cisco IOS Interface and Hardware Component Command Reference

IR-683
 Interface and Hardware Component Commands
show pas caim

Table 90 show pas caim Output Values and Descriptions (continued)

Value Description
uncomp paks/sec out A time average of the number of packets per second containing
compressed data which were successfully decompressed by the
CAIM. It is computed as the ratio of the “uncomp paks out”
statistic to the “seconds since last clear” statistic.
Note that the “uncomp paks/sec in”, “comp paks/sec out”, “comp
paks/sec in”, and “uncomp paks/sec out” statistics are averages
over the entire time since the last “clear count” command was
issued. This means that as time progresses, these statistics become
averages over an ever larger time interval. As time progresses,
these statistics become ever less sensitive to current prevailing
conditions. Note also that the “uncomp paks in”, “comp paks out”,
“comp paks in”, and “uncomp paks out” statistics are 32-bit
counters and can roll over from 0xffff ffff to 0. When they do so,
the “uncomp paks/sec in”, “comp paks/sec out”, “comp paks/sec
in”, and “uncomp paks/sec out” statistics can be rendered
meaningless. It is therefore recommend that one issue a “clear
count” command before sampling these statistics.
uncomp bits/sec in A time average of the number of bits per second of uncompressed
data which were submitted to the CAIM for compression. It is
computed as the ratio of the “uncomp bytes in” statistic, times 8, to
the “seconds since last clear” statistic.
comp bits/sec out A time average of the number of bits per second of uncompressed
data which were successfully compressed by the CAIM. It is
computed as the ratio of the “comp bytes out” statistic, times 8, to
the “seconds since last clear” statistic.
comp bits/sec in A time average of the number of bits per second of compressed data
which were submitted to the CAIM for decompression. It is
computed as the ratio of the “comp bytes in” statistic, times 8, to
the “seconds since last clear” statistic.
uncomp bits/sec out A time average of the number of bits per second of compressed data
which were successfully decompressed by the CAIM. It is
computed as the ratio of the “uncomp bytes in” statistic, times 8, to
the “seconds since last clear” statistic.
Note again that these “bits/sec” statistics are time averages over the
“seconds since last clear” statistics, and therefore become less and
less sensitive to current conditions as time progresses. Also, these
“bits/sec” statistics are computed from 32-bit counters, and when
the counters roll over from the maximum 32-bit value to 0, the
“bits/sec” statistics become inaccurate. It is again recommended
that one issue the “clear count” command before sampling the
“bits/sec” statistics.

Cisco IOS Interface and Hardware Component Command Reference

IR-684
Interface and Hardware Component Commands
show pas caim

Table 90 show pas caim Output Values and Descriptions (continued)

Value Description
The remaining statistics summarize operational state and error conditions encountered by the CAIM,
and have the following interpretations:
holdq Gives the number of packets occupying the “hold queue” of the
CAIM. The hold queue is a holding area, or “overflow” area, for
packets to be processed by the CAIM. Normally, the CAIM is fast
enough that no overflow into the hold queue occurs, and so
normally this statistic should show zero.
hw_enable Flag indicating if the CAIM is disabled or not. Zero implies
disabled; one implies enabled. The CAIM can become disabled if
certain fatal hardware error conditions are detected. It can be
reenabled by issuing the clear aim element-number command.
src_limited Flag indicating if the CAIM is in “source limited” mode. In source
limited mode, the CAIM can only process a single command at a
time. In non source limited mode, the CAIM can process several
commands at a time using a pipeline built into the 9711
coprocessor. Note that the normal mode of operation is
“non-source limited”, and there is no command to place the CAIM
in “source limited” mode. Hence, this statistic should always read
zero.
num cnxts Gives the number of “contexts” which are currently open on the
CAIM. Each interface configured for compression opens two
contexts, one for each direction of data transfer.
no data Counts the number of times in which the CAIM performed either a
compress or decompression operation, and the output data length
was reported with a length of zero. In normal operation, this
statistic should always read zero. A nonzero value is an indication
of a malfunctioning CAIM.
drops Counts the total number of times in which the CAIM was forced to
drop a packet it was asked to compress or decompress. This can
happen for a number of reasons, and the remaining statistics
summarize these reasons. This statistic indicates that the CAIM is
being overloaded with requests for compression/decompression.
nobuffers Counts the total number of times the CAIM needed to allocate
memory for buffers but could not obtain memory. The CAIM
allocates memory for buffers for holding the results of compression
or decompression operations. In normal operation, there is plenty
of memory available for holding CAIM results. This statistic, if
nonzero, indicates that there is a significant backup in memory, or
perhaps a memory leak.

Cisco IOS Interface and Hardware Component Command Reference

IR-685
 Interface and Hardware Component Commands
show pas caim

Table 90 show pas caim Output Values and Descriptions (continued)

Value Description
enc adj errs Each packet compressed or decompressed involves an adjustment
of the encapsulation of the packet between the LZS-DCP, FRF9, or
MPPC encapsulation used to transport compressed packets to the
standard encapsulation used to transport clear data. This statistic
counts the number of times this encapsulation adjustment failed. In
normal operation, this statistic should be zero. A nonzero value
indicates that we are short in a specific memory resource referred
to as “paktypes”, and that packets are being dropped because of
this shortage.
fallbacks Number of times the data compression AIM card could not use its
pre-allocated buffers to store compression results and had to
“fallback” to using a common buffer pool.
no replace Each time a compression or decompression operation is completed
and the resultant data fill up a buffer, the CAIM software allocates
a new buffer to replace the buffer filled. If no buffers are available,
then the packet involved in this operation is dropped and the old
buffer reused. This statistic thus represents the number of times
such an allocation failure occurred. In normal operation there is
plenty of memory available for these buffers. A nonzero value for
this statistic is thus a serious indication of a memory leak or other
backup in buffer usage somewhere in the system.
num seq errs This statistic is incremented when the CAIM produces results in a
different order than that in which the requests were submitted.
Packets involved in such errors are dropped. A nonzero value in
this statistic indicates a serious malfunction in the CAIM.
num desc errs Incremented when the CAIM reports error in a compression or
decompression operation. Such errors are most likely bus errors,
and they indicate a serious malfunction in the CAIM.
cmds complete Reports the number of compression/decompression commands
completed. This statistic should steadily increase in normal
operation (assuming that the CAIM is continuously being asked to
perform compression or decompression). If this statistic is not
steadily increasing or decreasing when a steady stream of
compression/decompression is expected, this is an indication of a
malfunctioning CAIM.
bad reqs Reports the number of compression/decompression requests that
the CAIM software determined it could not possibly handle. This
occurs only if a severely scattered packet (with more than 64
“particles”, or separate buffers of data) is handed to the CAIM to
compress or decompress. This statistic should not increment during
normal operation. A nonzero value indicates a software bug.

Cisco IOS Interface and Hardware Component Command Reference

IR-686
Interface and Hardware Component Commands
show pas caim

Table 90 show pas caim Output Values and Descriptions (continued)

Value Description
dead cntxts Number of times a packet was successfully compressed or
decompressed, only to find that the software “context”, or stream
sourcing the packet, was no longer around. In such a case the
packet is dropped. This statistic can be incremented at times when
a serial interface is administratively disabled. If the timing is right,
the CAIM may be right in the middle of operating on a packet from
that interface when the disable takes effect. When the CAIM
operation completes, it finds that the interface has been disabled
and all “compression contexts” pertaining to that interface have
been deleted. Another situation in which this can occur is when a
Frame Relay DLC goes down. This is a normal and tolerable. If this
statistic is incrementing when no such situations exist, it is an
indication of a software bug.
no paks If a packet to be compressed or decompressed overflows into the
hold queue, then it must undergo an operation called “reparenting”.
This involves the allocation of a “paktype” structure for the packet.
If no paktype structures are available, then the packet is dropped
and this statistic is incremented. A nonzero value of this statistic
indicates that the CAIM is being overtaxed, that is, it is being asked
to compress/decompress at a rate exceeding its capabilities.
enq errors Closely related to the “no paks” statistic. The hold queue for the
CAIM is limited in length, and if the hold queue grows to this
length, no further packets may be placed on it. A nonzero value of
this statistic therefore also indicates that the CAIM is being
overtaxed.
rx pkt drops Contains the total number of packets dropped because of “no paks”
or “enq errors”, which were destined to be decompressed.
tx pkt drops Contains the total number of packets dropped because of “no paks”
or “enq errors”, which were destined to be compressed
dequeues Indicates the total number of packets which were removed from the
CAIM hold queue when the CAIM became available for servicing
its hold queue.
requeues Indicates the total number of packets that were removed from the
hold queue, only to find that the necessary CAIM resources were
not available (it is not possible to determine whether CAIM
resources are available until the packet is dequeued). Such packets
are requeued onto the hold queue, with order in the queue
preserved.
drops disabled Indicates the total number of packets which were submitted for
compression or decompression, but that were dropped because the
CAIM was disabled.
clears Indicates the number of times the CAIM was reset using the clear
aim element-number command.

Cisco IOS Interface and Hardware Component Command Reference

IR-687
 Interface and Hardware Component Commands
show pas caim

Table 90 show pas caim Output Values and Descriptions (continued)

Value Description
# ints Indicates the number of interrupts serviced by the CAIM software.
This statistic should steadily increase (assuming that the CAIM
workload is steady). If this statistic is not incremented when
expected, it indicates a severe CAIM malfunction.
# purges Indicates the total number of times the compression history for a
session had to be purged. This statistic is incremented a couple of
times at startup. Thereafter, any increase in this statistic is an
indication that the other side of the serial link detected bad data or
gaps in the compressed packets being passed to it, and hence
signalled a request to purge compression history in order to get
back in synchronization. This can indicate that the CAIM is being
overtaxed or that the serial interface is overtaxed and being forced
to drop output packets.
no cnxts Indicates the total number of times a request was issued to open a
context, but the CAIM could not support any more contexts. Recall
that two contexts are required for each interface configured for
compression.
bad algos Indicates the total number of times a request was issued to open a
context for a compression algorithm not supported by the CAIM.
Recall that the CAIM supports the LZS and MPPC algorithms only.
no crams Indicates the total number of times a request was issued to open a
context but there was insufficient compression DRAM to open
another context. The CAIM software is set up to run out of contexts
before it runs out of compression DRAM, so this statistic should
always be zero.
bad paks Indicates the total number of times a packet was submitted for
compression or decompression to the CAIM, but the packet had an
invalid size.
# opens Indicates the total number of times a context was opened.
# closes Indicates the total number of times a context was closed.
# hangs Indicates the total number of times a CAIM appeared hung up,
necessitating a clear of the CAIM.

Examples The show pas caim rings element-number command displays the current state of the DMA ring buffers
maintained by the CAIM software. These rings feed the CAIM with data and commands. It is intended
for an engineering debug of the compression AIM. It produces the following output:
Router# show pas caim rings 0

CAIM Command Ring: 0x01A2BC00 Stack: 0x01A2BE40 Shadow: 0x80F88BAC

Head: 0021 Tail: 0021 Count: 0000
CAIM Source Ring: 0x01A2C900 Shadow: 0x80F88BAC
Head: 0021 Tail: 0021 Num: 0000
CAIM Results Ring: 0x01A2C280 Stack: 0x01A2C4C0
Head=021 Tail=021
CAIM Dest Ring: 0x01A2CB40 Shadow: 0x80F892D8 Head=021 Tail=000
Desc: 0x01A2CBE8 flags: 0x8000060C dptr: 0x019E7EB8 part: 0x80F84BE0

Cisco IOS Interface and Hardware Component Command Reference

IR-688
Interface and Hardware Component Commands
show pas caim

Desc: 0x01A2CBF0 flags: 0x8000060C dptr: 0x019FC63C part: 0x80F85240

.
.
.

Table 91 describes the significant fields shown in the display.

Table 91 show pas caim rings Field Descriptions

Field Description
CAIM Command Ring Feeds commands to the CAIM.
command ring address Address of the command ring.
Command Ring Stack Ring that feeds additional commands to the CAIM.
command ring stack address Address of the command ring stack.
Command Ring Shadow Software ring that stores additional information about each
command.
command ring shadow address Address of the command ring shadow.
Command Ring Head Index into the Source Ring, specifying where the next entry will be
extracted from.
Command Ring Tail Index into the Source Ring, specifying where the next entry will be
inserted.
CAIM Source Ring Feeds information about input data to the CAIM.
source ring address Address of the source ring.
Source Ring Shadow Ring that contains additional information about each source buffer.
source ring shadow address Address of the source ring shadow.
Source Ring Head Specifies where the next entry will be extracted from.
Source Ring Tail Specifies where the next entry will be inserted.
CAIM Results Ring Receives information about each CAIM command as it is
completed.
results ring address Address of the results ring.
Results Ring Stack Ring that receives additional information about each completed
command.
results ring stack address Address of the results ring stack.
Results Ring Head Specifies where the next entry will be extracted from.
Results Ring Tail Specifies where the next entry will be inserted.
CAIM Dest Ring Holds information about the buffers available to the CAIM for
output data.
dest ring address Address of the dest ring.
Dest Ring Shadow Ring that holds additional information about each output buffer.
dest ring shadow address Address of the dest ring shadow.
Dest Ring Head Index into the Source Ring, specifying where the next entry will be
extracted from.
Dest Ring Tail Index into the Source Ring, specifying where the next entry will be
inserted.

Cisco IOS Interface and Hardware Component Command Reference

IR-689
 Interface and Hardware Component Commands
show pas caim

Table 91 show pas caim rings Field Descriptions (continued)

Field Description
The remaining fields describe each output data buffer.
dest Address of a so-called descriptor, used by the Jupiter DMA engine.
flags Contains flags describing attributes of the buffer.
dptr Displays the actual address of the output buffer.
part Displays the address of the corresponding particle type structure, a
software-defined structure that describes a buffer when it is a
component of a network data buffer.

The show pas caim dma element-number command displays the registers of the Jupiter DMA Controller.
These registers control the operation of the Jupiter DMA Controller. This command is intended for
Engineering debug of the CAIM. You can find detailed descriptions of the various fields in the Jupiter
DMA Controller specification. It produces the following output:
Router# show pas caim dma 0

Jupiter DMA Controller Registers: (0x40200000

Cmd Ring: 0x01A2BCA8 Src Ring: 0x01A2C9A8
Res Ring: 0x01A2C328 Dst Ring: 0x01A2CBE8
Status/Cntl: present: 0x80808084 last int: 0x80808084
Inten: 0x10100000 config: 0x00100003
Num DMA ints: 143330469

The show pas caim compressor element-number command displays the registers of the Hifn 9711
compression coprocessor. These registers control the operation of the Hifn 9711 part. This command is
intended for engineering to debug the CAIM. Detailed descriptions of the various fields may be found
in the Hifn 9711 data book. It produces the following output:
Router# show pas caim compressor 0

Hifn9711 Data Compression Coprocessor Registers (0x40201000):

Config: 0x000051D4 Inten: 0x00000E00
Status: 0x00004000 FIFO status: 0x00004000
FIFO config: 0x00000101

Table 92 describes the fields shown in the preceding display.

Table 92 show pas caim compressor Field Descriptions

Field Description
Hifn9711 Data Compression Controls the operation of the Hifn 9711 part.
Coprocessor Registers
registers address Address of the registers in the address space of the processor.
Config Displays the current contents of the 9711 configuration register.
Inten Displays the contents of the 9711 interrupt enable register.
Status Displays the contents of the 9711 status register.
FIFO status Contents of the 9711 FIFO Status register.
FIFO config Contents of the 9711 FIFO Config register.

Cisco IOS Interface and Hardware Component Command Reference

IR-690
Interface and Hardware Component Commands
show pas caim

The show pas caim cnxt_table element-number command displays the context table for the specified
CAIM element. The context table is a table of information concerning each compression context. It
produces the following output:
Router# show pas caim cnxt_table 0

CAIM0 Context Table

Context: 0x8104F320 Type: Compr Algo: Stac
Hdrlen: 0006 History: 0x0000
Callback: 0x8011D68C Shutdown: x8011EBE4 Purge: N
Comp_db: 0x81034BC0 idb: 0x81038084 ds: 0x8104E514
Context: 0x8104F340 Type: Decomp Algo: Stac
Hdrlen: 0002 History: 0x0000
Callback: 0x8011E700 Shutdown: x8011EBE4 Purge: N
Comp_db: 0x81034BC0 idb: 0x81038084 ds: 0x8104E514

Table 93 describes the fields shown in the preceding display.

Table 93 show pas caim cnxt_table Fields Descriptions

Field Description
Context Numeric internal reference for the compression context.
Type Gives the type of context:
• Compr—compression context
• Decomp—decompression context
Algo Gives the compression algorithm used:
• Stac
• Mppc
Hdrlen Gives the number of bytes in the compression header for each
compressed packet.
History Gives the 16-KB page number in compression RAM for the
context.
Callback Gives an internal numeric reference for a control structures or
procedure to facilitate debugging.
Shutdown Gives an internal numeric reference for a control structures or
procedure to facilitate debugging.
Comp_db Gives an internal numeric reference for a control structures or
procedure to facilitate debugging.
idb Gives an internal numeric reference for a control structures or
procedure to facilitate debugging.
idb Gives an internal numeric reference for a control structures or
procedure to facilitate debugging.
Purge Indicates whether the compression context has been flagged to
have its history purged.

The show pas caim page_table element-number command displays the page table for the selected
CAIM element. The page table is a table of entries describing each page in compression RAM. It
produces the following output:
Router# show pas caim page_table 0

Cisco IOS Interface and Hardware Component Command Reference

IR-691
 Interface and Hardware Component Commands
show pas caim

CAIM0 Page Table

Page 0x0000 Comp cnxt: 8104F320 Decmp cnxt: 8104F340 Algo: Stac

Table 94 describes the fields shown in the preceding display.

Table 94 show pas caim page_table Field Descriptions

Field Description
Page 16 KB page number of the page.
Comp cnxt Contains an internal numeric reference to the context structures
using this page.
Decmp cnxt Contains an internal numeric reference to the context structures
using this page.
Algo Gives the compression algorithm used:
• Stac
• Mppc

The following example shows statistics of an active data compression AIM session:
Router# show pas caim stats 0

CompressionAim0
ds:0x80F56A44 idb:0x80F50DB8
422074 uncomp paks in --> 422076 comp paks out
422071 comp paks in --> 422075 uncomp paks out
633912308 uncomp bytes in--> 22791798 comp bytes out
27433911 comp bytes in --> 633911762 uncomp bytes out
974 uncomp paks/sec in--> 974 comp paks/sec out
974 comp paks/sec in --> 974 uncomp paks/sec out
11739116 uncomp bits/sec in--> 422070 comp bits/sec out
508035 comp bits/sec in --> 11739106 uncomp bits/sec out
433 seconds since last clear
holdq: 0 hw_enable: 1 src_limited: 0 num cnxts: 4
no data: 0 drops: 0 nobuffers: 0 enc adj errs: 0 fallbacks: 0
no Replace: 0 num seq errs: 0 num desc errs: 0 cmds complete: 844151
Bad reqs: 0 Dead cnxts: 0 No Paks: 0 enq errs: 0
rx pkt drops: 0 tx pkt drops: 0 dequeues: 0 requeues: 0
drops disabled: 0 clears: 0 ints: 844314 purges: 0
no cnxts: 0 bad algos: 0 no crams: 0 bad paks: 0
# opens: 0 # closes: 0 # hangs: 0

Related Commands Command Description

show compress Displays compression statistics.

Cisco IOS Interface and Hardware Component Command Reference

IR-692
 Interface and Hardware Component Commands
show pas eswitch address

show pas eswitch address

To display the Layer 2 learned addresses for an interface, use the show pas eswitch address command
in user EXEC or privileged EXEC mode.

show pas eswitch address [ethernet | fastethernet] [slot/port]

Syntax Description ethernet | fastethernet (Optional) Type of interface.

slot (Optional) Slot number of the interface.
port (Optional) Interface number.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

11.2 P This command was introduced.

Examples The following sample output shows that the first PA-12E/2FE interface (listed below as port 0) in port
adapter slot 3 has learned the Layer 2 address 00e0.f7a4.5100 for bridge group 30 (listed below as
BG 30):
Router# show pas eswitch address fastethernet 3/0

U 00e0.f7a4.5100, AgeTs 56273 s, BG 30 (vLAN 0), Port 0

Cisco IOS Interface and Hardware Component Command Reference

IR-693
 Interface and Hardware Component Commands
show pas isa controller

show pas isa controller

To show controller information that is specific to the Virtual Private Network (VPN) accelerator
controller when an Integrated Services Adapter (ISA) is installed, use the show pas isa controller EXEC
command.

show pas isa controller

Syntax Description This command has no arguments or keywords.

Command Modes Privileged EXEC

Command History Release Modification

12.1(5)T This command was introduced.

Examples The following is sample output from the show pas isa controller command:
Router# show pas isa controller

Interface ISA5/1 :

Encryption Mode = IPSec

Addresses of Rings and instance structure:

High Priority Rings
TX: 0x4B0E97C0 TX Shadow:0x62060E00
RX: 0x4B0EB840 RX Pool:0x4B0EBC80 RX Pool Shadow:0x62068E58
Low Priority Rings
TX: 0x4B0EA800 TX Shadow:0x62066E2C
RX: 0x4B0EC0C0, RX Shadow:0x62069284

Instance Structure address:0x620603D8

Firmware write head/tail offset:0x4B0EC900

Firmware read head/tail offset:0x3EA00000

Related Commands Command Description

show pas isa interface Displays interface status information that is specific to the VPN accelerator
card.

Cisco IOS Interface and Hardware Component Command Reference

IR-694
 Interface and Hardware Component Commands
show pas isa interface

show pas isa interface

To display interface information that is specific to the Virtual Private Network (VPN) accelerator card
when an Integrated Services Adapter (ISA) is installed, use the show pas isa interface command in
privileged EXEC mode.

show pas isa interface

Syntax Description This command has no arguments or keywords.

Command Modes Privileged EXEC

Command History Release Modification

12.1(5)T This command was introduced.

Examples The following is sample output from the show pas isa interface command:
Router# show pas isa interface

Interface ISA5/1 :
Statistics of packets and bytes through this interface:
2876894 packets in 2910021 packets out
420 paks/sec in 415 paks/sec out
2327 Kbits/sec in 2408 Kbits/sec out
632 commands out 632 commands acknowledged
low_pri_pkts_sent 1911 low_pri_pkts_rcvd: 1911
invalid_sa: 260 invalid_flow: 33127
invalid_dh: 0 ah_seq_failure: 0
ah_spi_failure: 0 esp_auth_failure: 0
esp_seq_failure: 0 esp_spi_failure: 0
esp_protocol_absent: 0 ah_protocol_absent: 0
bad_key_group: 0 no_shared_secret: 0
no_skeyids: 0 pad_size_error: 0
cmd_ring_full: 0 bulk_ring_full: 990
bad_peer_pub_len: 0 authentication_failure: 0
fallback: 1606642 no_particle: 0
6922 seconds since last clear of counters

Table 95 describes the significant fields shown in the display.

Table 95 show pas isa interface Field Descriptions

Field Description
packets in/out Number of data packets received from, or sent to, the
Integrated Service Adapter (ISA).
paks/sec in/out Number of packets received in, or sent out, with the total
number of seconds that the ISA is active.
Kbits/sec in/out Number of kilobits (Kbits) received in, or sent out, with the
total number of seconds that the ISA is active.

Cisco IOS Interface and Hardware Component Command Reference

IR-695
 Interface and Hardware Component Commands
show pas isa interface

Table 95 show pas isa interface Field Descriptions (continued)

Field Description
commands out Number of commands going to the ISA. Examples of
commands include setting up encryption sessions and
retrieving statistics or status from the ISA.
commands acknowledged Number of commands returning from the ISA. Examples of
commands include setting up encryption sessions and
retrieving statistics or status from the ISA.
low_pri_pkts_sent This is a summary counter for number of Internet Key
Exchange (IKE) and IPSec commands submitted to ISA.
low_pri_pkts_rcvd This is a summary counter for number of IKE & IPSEC
command responses received from ISA.
invalid_sa Reference to an unusable security association key pair.
invalid_flow An invalid packet using an IPSec key is received for
encryption or decryption.
Example: session has expired.
invalid_dh Reference to an unusable Diffie-Hellman( DH) key pair.
ah_seq_failure Unacceptably late Authentication Header (AH) header
received.
ah_spi_failure SPI specified in the AH header does not match the SPI
associated with the IPSec AH key.
esp_auth_failure Number of ESP packets received with authentication failures.
esp_seq_failure Unacceptably late ESP packet received.
esp_spi_failure SPI specified in the ESP header does not match the SPI
associated with the IPSec ESP key.
esp_protocol_absent Packet is missing expected ESP header.
ah_protocol_absent Packet is missing expected AH header.
bad_key_group Unsupported key group requested during a Diffie-Hellman
generation.
no_shared_secret Attempting to use a Diffie-Hellman shared secret that is not
generated.
no_skeyids Attempting to use a shared secret that is not generated.
pad_size_error The length of the ESP padding is greater than the length of
the entire packet.
cmd_ring_full New IKE setup messages are not queued for processing until
the previous queued requests are processed.
bulk_ring_full New packets requiring IPSec functionality are not queued to
the ISA until the ISA completes the processing of existing
requests.
bad_peer_pub_len Length of peer's DH public key does not match the length
specified for the negotiated DH key group.
authentication_failure Authentication failed.

Cisco IOS Interface and Hardware Component Command Reference

IR-696
 Interface and Hardware Component Commands
show pas isa interface

Table 95 show pas isa interface Field Descriptions (continued)

Field Description
fallback The number of instances when the driver is successful in
getting a replacement buffer from the global pool.
no_particle The number of instances when the driver was unable to get a
replacement buffer from the driver pool and the global
(fallback) pool.

Related Commands Command Description

show pas isa controller Displays controller status information that is specific to the VPN
accelerator card.

Cisco IOS Interface and Hardware Component Command Reference

IR-697
 Interface and Hardware Component Commands
show pas vam controller

show pas vam controller

To display controller information that is specific to the VPN Acceleration Module (VAM), use the show
pas vam controller command in privileged EXEC mode.

show pas vam controller

Syntax Description This command has no arguments or keywords.

Command Modes Privileged EXEC

Command History Release Modification

12.1(9)E This command was introduced.
12.2(9)YE This command was integrated into Cisco IOS Release 12.2(9)YE.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.

Examples The following is sample output from the show pas vam controller command:
Router# show pas vam controller

Encryption Mode = IPSec

Addresses of Rings and instance structure:

Low Priority Queue:
OMQ=0xF2CB2E0, OMQ Shadow = 0x630E6638, {1, 1, 0, 256}
PKQ=0xF2CF320, PKQ Shadow = 0x630EBE64, {232, 232, 0, 256}
ERQ=0xF2D3360, ERQ Shadow = 0x630F1690, {0, 0, 0, 256}
High Priority Rings:
TX: 0x0F2D73A0 TX Shadow:0x630F6EBC, {6, 6, queued=0}
RX: 0x7F2D93E0 {13, 0, 256}
RX Pool:0x7F2DA420 RX Pool Shadow:0x630FCAE8, {6, 0, 255}
Instance Structure address:0x630E5898

Misc registers:
mini-omq=0xF2DB460, shdw=0x63102714
Group0=0x3D800000, Group1=0x3D801000
IndexReg = 0xDFFE700
Heartbeat info:<Addr, Value> = <0xF2DB520, 0x2A55A>
Running default HSP (addr=0x629D36AC, size=294268)

Related Commands Command Description

show pas vam interface Displays interface status information specific to the VPN accelerator
module.

Cisco IOS Interface and Hardware Component Command Reference

IR-698
 Interface and Hardware Component Commands
show pas vam interface

show pas vam interface

To display interface information that is specific to the VPN Acceleration Module (VAM), use the show
pas vam interface command in privileged EXEC mode.

show pas vam interface

Syntax Description This command has no arguments or keywords.

Command Modes Privileged EXEC

Command History Release Modification

12.1(9)E This command was introduced.
12.2(9)YE This command was integrated into Cisco IOS Release 12.2(9)YE.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.

Usage Guidelines Enter the show pas vam interface command to see if the VAM is currently processing crypto packets.

Examples The following is sample output from the show pas vam interface command:
Router# show pas vam interface

Interface VAM 2/1 :

ds: 0x621CE0D8 idb:0x621C28DC
Statistics of packets and bytes that through this interface:
1110 packets in 1110 packets out
123387 bytes in 100979 bytes out
0 paks/sec in 0 paks/sec out
0 Kbits/sec in 0 Kbits/sec out
3507 commands out 3507 commands acknowledged
ppq_full_err : 0 ppq_rx_err : 0
cmdq_full_err : 0 cmdq_rx_err : 0
no_buffer : 0 fallback : 0
dst_overflow : 0 nr_overflow : 0
sess_expired : 0 pkt_fragmented : 0
out_of_mem : 0 access_denied : 0
invalid_fc : 0 invalid_param : 0
invalid_handle : 0 output_overrun : 0
input_underrun : 0 input_overrun : 0
key_invalid : 0 packet_invalid : 0
decrypt_failed : 0 verify_failed : 0
attr_invalid : 0 attr_val_invalid : 0
attr_missing : 0 obj_not_wrap : 0
bad_imp_hash : 0 cant_fragment : 0
out_of_handles : 0 compr_cancelled : 0
rng_st_fail : 0 other_errors : 0
3420 seconds since last clear of counters
Table 96 describes the significant fields shown in the display.

Cisco IOS Interface and Hardware Component Command Reference

IR-699
 Interface and Hardware Component Commands
show pas vam interface

Table 96 show pas vam interface Field Descriptions

Field Description
packets in/out Number of data packets received from, or sent to, the
VAM.
bytes in/out Number of data bytes received from, or sent to, the
VAM.
paks/sec in/out Number of packets received in, or sent out, with the
total number of seconds that the VAM is active.
Kbits/sec in/out Number of kilobits (Kbits) received in, or sent out,
with the total number of seconds that the VAM is
active.
commands out Number of commands going to the VAM. Examples
of commands include setting up encryption sessions
and retrieving statistics or status from the VAM.
commands acknowledged Number of commands returning from the VAM.
Examples of commands include setting up encryption
sessions and retrieving statistics or status from the
VAM.
ppq_full_err Number of packets dropped because of a lack of space
in the packet processing queues for the VAM. This
usually means that input traffic has reached VAM
maximum throughput possible.
ppq_rx_err Summary counter for all errors related to packet
processing.
cmdq_full_err Number of commands dropped because of a lack of
space in the command processing queues for the
VAM. This error indicates that the input tunnel setup
rate has reached the VAM maximum setup rate. The
Internet Key Exchange (IKE) process retries the
tunnel creation and deletion when commands are
dropped by VAM.
cmdq_rx_err Summary counter for all errors related to command
processing (for example, IKE, or IPSec session
creation or deletion).
no_buffer Errors related to the VAM running out of buffers. May
occur with large packets. Although VAM buffers
cannot be tuned, try tuning buffers for other
interfaces.
fallback Internal VAM buffer pool is completely used up and
VAM has to fallback to global buffer pool. This may
cause minor performance impact, however, packets
are still processed so this error can be ignored.
dst_overflow Counter that is incremented when the VAM has
completed an operation, but there is no available
space into which to place the result.

Cisco IOS Interface and Hardware Component Command Reference

IR-700
Interface and Hardware Component Commands
show pas vam interface

Table 96 show pas vam interface Field Descriptions (continued)

Field Description
nr_overflow Counter that is incremented when the VAM has
completed an operation, but there is no available
space into which to place the result.
sess_expired Counter that is incremented if the session used to
encrypt or decrypt the packet has expired because of
time or space limit.
pkt_fragmented Counter that is incremented when the input packet has
to be fragmented after encryption. This counter
should always be 0 as fragmentation by VAM is
disabled.
out_of_mem Counter that is incremented when the VAM runs out
of memory.
access_denied Counter that is incremented when the VAM is
requested to perform an operation on an object that
can not be modified.
invalid_fc Counter that is incremented when the VAM has
received a request that is illegal for the specified
object type.
invalid_param Counter that is incremented when the VAM has
received invalid parameters within a command.
invalid_handle Counter that is incremented when the VAM receives a
request for an operation to be performed on an object
that does not exist.
output_overrun Counter that is incremented when the space allocated
for a response is not large enough to hold the result
posted by the VAM.
input_underrun Counter that is incremented when the VAM receives a
packet for which it finds a premature end to the data,
for example, a truncated packet.
input_overrun Counter that is incremented when the VAM receives a
buffer that is too large for the requested operation.
key_invalid Counter that is incremented when the VAM receives a
request for an operation on a key where the key is
invalid or of the wrong type.
packet_invalid Counter that is incremented when the VAM receives a
packet whose body is badly formed.
decrypt_failed Counter that is incremented when the VAM receives a
packet that cannot be decrypted because the
decrypted data was not properly formatted (for
example, padding is wrong).
verify_failed Counter that is incremented when the VAM receives a
packet which could not be verified because the
verification of a signature or authentication value
failed.

Cisco IOS Interface and Hardware Component Command Reference

IR-701
 Interface and Hardware Component Commands
show pas vam interface

Table 96 show pas vam interface Field Descriptions (continued)

Field Description
attr_invalid Counter that is incremented when the VAM receives a
packet which specifies an attribute that is not correct
for the specified object or operation.
attr_val_invalid Counter that is incremented when the VAM
encounters errors during packet or command
processing. The packets or commands are dropped in
such cases.
attr_missing Counter that is incremented when the VAM receives
an operation request for which the value of a required
attribute is missing.
obj_not_wrap Counter that is incremented when the VAM receives
an operation request to retrieve an object that is
hidden or unavailable for export beyond the FIPS
boundary of the VPN Module.
bad_imp_hash Counter that is incremented when the VAM sees a
hash miscompare on unwrap.
cant_fragment Counter that is incremented when the VAM
determines a need to fragment a packet, but cannot
fragment because the “don’t fragment” bit is set. This
counter should always be zero because the
fragmentation on the VAM is disabled.
out_of_handles Counter that is incremented when the VAM has run
out of available space for objects of the requested
type.
comp_cancelled Due to the operation of the compression algorithm,
some data patterns cannot be compressed. Usually
data that has already been compressed or data that
does not have a sufficient number of repetitive
patterns cannot be compressed and a compress
operation would actually result in expansion of the
data.
There are certain known data patterns which do not
compress. In these cases, the compression engine
cancels the compression of the data and returns the
original, uncompressed data without an IPPCP
header.
These counters are useful to determine if the content
of the traffic on the network is actually benefiting
from compression. If a large percentage of the
network traffic is already compressed files, these
counters may indicate that compression on these
streams are not improving the performance of the
network.
rng_st_fail Counter that is incremented when the VAM detects a
Random Number Generator self test failure.

Cisco IOS Interface and Hardware Component Command Reference

IR-702
 Interface and Hardware Component Commands
show pas vam interface

Table 96 show pas vam interface Field Descriptions (continued)

Field Description
pkt_replay_err Counter that is incremented when a replay error is
detected by the VAM.
other_errors Counter that is incremented when the VAM
encounters a packet or command error that is not
listed in other error categories. An example could be
if the packet IP header checksum is incorrect.

Related Commands Command Description

show pas vam controller Displays controller status information that is specific to the VPN
accelerator module.

Cisco IOS Interface and Hardware Component Command Reference

IR-703
 Interface and Hardware Component Commands
show pci aim

show pci aim

To show the IDPROM contents for each compression Advanced Interface Module (AIM) daughter card
in the Cisco 2600 router, use the show pci aim command in user EXEC or privileged EXEC mode.

show pci aim

Syntax Description This command has no arguments or keywords.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

12.0(1)T This command was introduced.

Usage Guidelines This command shows the IDPROM contents for each compression AIM daughtercard present in the
system, by AIM slot number (currently 0, since that is the only daughtercard installed for Cisco IOS
Release 12.0(1)T). The IDPROM is a small PROM built into the AIM board used to identify it to the
system. It is sometimes referred to as an EEPROM because it is implemented using electronically
erasable PROM.

Examples The following example shows the IDPROM output for the installed compression AIM daughter card:
Router# show pci aim

AIM Slot 0: ID 0x012D

Hardware Revision : 1.0
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 01 2D 41 01 00 FF FF FF FF FF FF FF FF
0x10: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x20: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x30: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x40: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x50: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF

Related Commands Command Description

clear aim Clears data compression AIM registers and resets the hardware.
test aim eeprom Tests the data compression AIM after it is installed in a Cisco 2600
series router.

Cisco IOS Interface and Hardware Component Command Reference

IR-704
 Interface and Hardware Component Commands
show power inline

show power inline

To display the power status for a specified port or for all ports, use the show power inline command in
privileged EXEC mode.

show power inline [interface-type slot/port] [actual | configured]

Syntax Description interface-type (Optional) Type of interface.

slot (Optional) Slot number.
/port (Optional) Port number.
actual (Optional) Displays the present power status, which might not be the same as the
configured power.
configured (Optional) Displays the configured power status.

Command Modes Privileged EXEC

Command History Release Modification

12.0(5)XU This command was introduced.
12.2(2)XT This command was introduced on the Cisco 2600 series, the Cisco 3600 series, and
the Cisco 3700 series routers to support switchport creation.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T to support
switchport creation on Cisco 2600 series, the Cisco 3600 series, and
Cisco 3700 series routers.

Usage Guidelines The show power inline command displays the amount of power used to operate a Cisco IP phone. To
view the amount of power requested, use the show cdp neighbors command.

Examples The following is sample output from the show power inline fa0/4 actual command asking for the actual
status of each interface rather than what is configured for each:
Router# show power inline fastethernet 0/4 actual

Interface Power
-------------------- -----
FastEthernet0/4 no

Notice that the status shown for the FastEthernet interface 0/4, there is no power.

Cisco IOS Interface and Hardware Component Command Reference

IR-705
 Interface and Hardware Component Commands
show power inline

Related Commands Command Description

power inline Determines how inline power is applied to devices on the specified Fast
Ethernet port.
show cdp neighbors Displays detailed information about neighboring devices discovered using
CDP.

Cisco IOS Interface and Hardware Component Command Reference

IR-706
 Interface and Hardware Component Commands
show rbscp

show rbscp
To display state and statistical information about Rate Based Satellite Control Protocol (RBSCP)
tunnels, use the show rbscp command in user EXEC or privileged EXEC mode.

show rbscp {all | state | statistics} [tunnel tunnel-number]

Syntax Description all Displays both RBSCP state and RBSCP statistical information.
state Displays the RBSCP state information.
statistics Displays RBSCP statistical information.
tunnel (Optional) Displays the RBSCP information for the tunnel interface
specified in the tunnel-number argument. If a tunnel interface is not
specified, information for all RBSCP tunnels is displayed.
• tunnel-number—Number of the tunnel interface in the range from 0 to
2147483647.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines The output of this command is most helpful to the person who has the task of configuring and monitoring
RBSCP tunnels. The output shows various state and statistical information about RBSCP tunnels.

Examples The following is sample output from the show rbscp all command:
Router# show rbscp all

Tunnel0 is up, line protocol is up

RBSCP operational state: IS OPENING
RBSCP operating mode: (264h) ack_split window_stuffing inorder SCTP_report
window step: 1
drop scale : 0
ACK split size: 4
input drop scale: 2
initial TSN: 1h
fuzz factor: 0
next TSN: 1h
next sequence: 1h
current outstanding: 0
max out per RTT: 68750
packets since SACK: 0
cumulative ack: 0h
TSN at SACK: 1h
last cumulative ack: 0h
last delivered TSN: 0h

Cisco IOS Interface and Hardware Component Command Reference

IR-707
 Interface and Hardware Component Commands
show rbscp

next FWDTSN corr: 6h

RTO: 704 ms
RTT: 550 ms srtt_sa: 0 srtt_sv: 4
sentQ: num packets: 0, num bytes: 0
tmitQ: num packets: 0, num bytes: 0

RBSCP protocol statistics:

Init FWD-TSNs sent 0, received 0
TUNNEL-UPs sent 0, received 0
CLOSEDs sent 0, received 0
TSNs sent 0, resent 0, lost by sender 0
TSNs received 0 (duplicates 0)
FWD-TSNs sent 63 (heartbeats 0)
FWD-TSNs received 0 (ignored 0)
FWD-TSNs caused 0 packet drops, 0 whole window drops
SACKs sent 0, received 0 (ignored 0)
Recovered with RTX 0
Received with delay 0
Most released at once 0
Failed sends into the: tunnel 1, network 0
Dropped due to: excess delay 0, tmit queue full 0
Max on any queue: num packets: 0, num bytes: 0
Max outstanding: 0

Table 97 describes the significant fields shown in the display.

Table 97 show rbscp all Field Descriptions

Field Description
tunnel is {up | down} Interface is currently active (up) or inactive (down).
line protocol is {up | down | Shows line protocol up if a valid route is available to the tunnel
administratively down} destination. Shows line protocol down if no route is available or
if the route would be recursive.
RBSCP operational state Indicates the current RBSCP state.
RBSCP operating mode Indicates the RBSCP operating mode.
window step Step size for the window scale.
drop scale Scale factor for the number of bytes that can be queued before
packets are dropped on the output side.
Ack split size Number of TCP acknowledgements to send for every ack
received.
input drop scale Scale factor for the number of bytes that can be queued before
packets are dropped on the input side.
initial TSN Transport Sequence Number (TSN) of the first outgoing
RBSCP/IP packet sent to a peer. RBSCP uses sequence numbers
to ensure a reliable service. Peers will send the TSN back in the
acknowledgment packet.
fuzz factor Value added to the RBSCP delay clock to pad the delay when
large round-trip time (RTT) fluctuations occur.
next TSN TSN of the next outgoing RBSCP/IP packet.
next sequence Next sequence number to use, in hex.
current outstanding Current number of bytes that are in transit or are
unacknowledged.

Cisco IOS Interface and Hardware Component Command Reference

IR-708
Interface and Hardware Component Commands
show rbscp

Table 97 show rbscp all Field Descriptions

Field Description
max out per RTT Maximum number of bytes allowed to be sent out per RTT.
packets sent since SACK Number of packets sent since an RBSCP Selective
Acknowledgement (SACK).
cumulative ack Cumulative acknowledgement point which is the highest in
sequence TSN that was received from a peer.
TSN at SACK Value of highest TSN for the last SACK that was received from a
peer.
last cumulative ack Last cumulative acknowledgement point that was received from
the peer.
last delivered TSN Last TSN received that was subsequently delivered to an upper
level protocol.
next FWDTSN corr Next FWD_TSN correlation entry to use.
RTO Retransmission timeout, in milliseconds.
RTT Round-trip time estimate, in milliseconds.
srtt_sa Smoothed round-trip time average.
srtt_sv Smoothed round-trip time variance.
sentQ Number of packets and bytes sent but not yet acknowledged.
tmitQ Number of packets and bytes ready to be sent.
Init FWD-TSNs Number of TSNs sent and received for initializing the RBSCP
tunnel.
TUNNEL-UPs Number of TUNNEL_UP messages sent and received.
CLOSEDs Number of CLOSED messages sent and received.
heartbeats Heartbeats are equivalent to keepalive messages.
Recovered with RTX Number of packets recovered using a retransmitted message.
Received with delay Number of packets that included a delay value.
Most released at once Maximum burst of packets sent in one interval.
Failed sends Number of packets that were sent but failed because of an internal
error, such as no route or the underlying interface is down.

The following is sample output from the show rbscp state command:
Router# show rbscp state

Tunnel0 is up, line protocol is up

RBSCP operational state: IS OPENING
RBSCP operating mode: (264h) ack_split window_stuffing inorder SCTP_report
window step: 1
drop scale : 0
ACK split size: 4
input drop scale: 2
initial TSN: 1h
fuzz factor: 0
next TSN: 1h
next sequence: 1h
current outstanding: 0

Cisco IOS Interface and Hardware Component Command Reference

IR-709
 Interface and Hardware Component Commands
show rbscp

max out per RTT: 68750

packets since SACK: 0
cumulative ack: 0h
TSN at SACK: 1h
last cumulative ack: 0h
last delivered TSN: 0h
next FWDTSN corr: 0h
RTO: 704 ms
RTT: 550 ms srtt_sa: 0 srtt_sv: 4
sentQ: num packets: 0, num bytes: 0
tmitQ: num packets: 0, num bytes: 0

The following is sample output from the show rbscp statistics command:
Router# show rbscp statistics tunnel 0

Tunnel0 is up, line protocol is up

RBSCP protocol statistics:
Init FWD-TSNs sent 0, received 0
TUNNEL-UPs sent 0, received 0
CLOSEDs sent 0, received 0
TSNs sent 0, resent 0, lost by sender 0
TSNs received 0 (duplicates 0)
FWD-TSNs sent 136 (heartbeats 0)
FWD-TSNs received 0 (ignored 0)
FWD-TSNs caused 0 packet drops, 0 whole window drops
SACKs sent 0, received 0 (ignored 0)
Recovered with RTX 0
Received with delay 0
Most released at once 0
Failed sends into the: tunnel 1, network 0
Dropped due to: excess delay 0, tmit queue full 0
Max on any queue: num packets: 0, num bytes: 0
Max outstanding: 0

Related Commands Command Description

clear rbscp Resets and restarts RBSCP tunnels.

Cisco IOS Interface and Hardware Component Command Reference

IR-710
 Interface and Hardware Component Commands
show redundancy

show redundancy
To display information about the current redundant configuration and recent changes in states, use the
show redundancy command in EXEC mode. To display current or historical status and related
information on planned or logged handovers, use the show redundancy command in privileged EXEC
mode.

EXEC Mode

show redundancy

Privileged EXEC Mode

show redundancy [clients | counters | debug-log | handover | history | states | inter-device]

Syntax Description clients (Optional) Redundancy-aware client-application list.

counters (Optional) Redundancy-related operational measurements.
debug-log (Optional) Log of up to 256 redundancy-related debug entries.
handover (Optional) Details of any pending scheduled handover.
history (Optional) Log of past status and related information about logged
handovers. This is the only keyword supported on the Cisco AS5800.
states (Optional) Redundancy-related states: disabled, initialization, standby,
active (various substates for the latter two).
inter-device (Optional) Redundancy inter-device operational state and statistics.

Command Modes EXEC

Privileged EXEC

Command History Release Modification

11.3(6)AA This command was introduced in privileged EXEC mode.
12.2(8)T The privileged EXEC mode form of this command was integrated. Support
for the Cisco AS5800 and Cisco AS5850 is not included in this release.
12.2(11)T The privileged EXEC mode form of this command was implemented on
the Cisco AS5800 and Cisco AS5850.
12.3(8)T The inter-device keyword was added to the privileged EXEC form of the
command.
12.2(8)MC2 This command was introduced in EXEC mode.
12.3(11)T The EXEC form of this command was integrated.

Usage Guidelines EXEC Mode

When used in EXEC mode, this command has no keywords or arguments.

Cisco IOS Interface and Hardware Component Command Reference

IR-711
 Interface and Hardware Component Commands
show redundancy

Privileged EXEC Mode

In the standby group name group-name command, if you omit the group-name or if you enter a group
name that does not begin with one or two, the configuration will fail and there will be a mismatch in the
information displayed by the show redundancy and show standby commands.

Cisco AS5800
Use this command from the router-shelf console to determine when failover is enabled. Use this
command with the history keyword to log failover events.

Cisco AS5850
To use this command, you must have two route-switch-controller (RSC) cards installed and you must be
connected to one of them.

Examples Cisco AS5850 Example

The following is sample output from the show redundancy handover and show redundancy states
commands on a Cisco AS5850:
Router# show redundancy handover

No busyout period specified

Handover pending at 23:00:00 PDT Wed May 9 2001

Router# show redundancy states

my state = 14 -ACTIVE_EXTRALOAD
peer state = 4 -STANDBY COLD
Mode = Duplex
Unit = Preferred Primary
Unit ID = 6
Redundancy Mode = Handover-split: If one RSC fails, the peer RSC will take over the
feature boards
Maintenance Mode = Disabled
Manual Swact = Disabled Reason: Progression in progress
Communications = Up
client count = 3
client_notification_TMR = 30000 milliseconds
keep_alive TMR = 4000 milliseconds
keep_alive count = 1
keep_alive threshold = 7
RF debug mask = 0x0

Cisco AS5800 Example

The following is sample output from the show redundancy command on a Cisco AS5800:
Router# show redundancy

DSC in slot 12:

Hub is in 'active' state.
Clock is in 'active' state.
DSC in slot 13:
Hub is in 'backup' state.
Clock is in 'backup' state.

Cisco IOS Interface and Hardware Component Command Reference

IR-712
Interface and Hardware Component Commands
show redundancy

Cisco AS5800 with History Example

The following is sample output from the show redundancy history command on a Cisco AS5800:
Router# show redundancy history

DSC Redundancy Status Change History:

981130 18:56 Slot 12 DSC: Hub, becoming active - RS instruction

981130 19:03 Slot 12 DSC: Hub, becoming active - D13 order

Cisco AS5800 Router Shelves as Failover Pair Example

The following is sample output from two Cisco AS5800 router shelves configured as a failover pair. The
active router shelf is initially RouterA. The show redundancy history and show redundancy
commands have been issued. The show redundancy command shows that failover is enabled, shows the
configured group number, and shows that this router shelf is the active one of the pair. Compare this
output with that from the backup router shelf (RouterB) further below.

Note When RouterA is reloaded, thereby forcing a failover, new entries are shown on RouterB when a
show redundancy history command is issued after failover has occurred.

Log from the First Router (RouterA)

RouterA# show redundancy history

DSC Redundancy Status Change History:

010215 18:17 Slot -1 DSC:Failover configured -> ACTIVE role by default.

010215 18:18 Slot -1 DSC:Failover -> BACKUP role.
010215 18:18 Slot 12 DSC:Failover -> ACTIVE role.
010215 18:18 Slot 12 DSC:Hub, becoming active - arb timeout

RouterA# show redundancy

failover mode enabled, failover group = 32

Currently ACTIVE role.
DSC in slot 12:
Hub is in 'active' state.
Clock is in 'active' state.
No connection to slot 13

RouterA# reload

Proceed with reload? [confirm] y

*Feb 15 20:19:11.059:%SYS-5-RELOAD:Reload requested
System Bootstrap, Version xxx
Copyright xxx by cisco Systems, Inc.
C7200 processor with 131072 Kbytes of main memory

Log from the Second Router (RouterB)

RouterB# show redundancy

failover mode enabled, failover group = 32

Currently BACKUP role.
No connection to slot 12
DSC in slot 13:
Hub is in 'backup' state.
Clock is in 'backup' state.

*Feb 16 03:24:53.931:%DSC_REDUNDANCY-3-BICLINK:Switching to DSC 13

Cisco IOS Interface and Hardware Component Command Reference

IR-713
 Interface and Hardware Component Commands
show redundancy

*Feb 16 03:24:53.931:%DSC_REDUNDANCY-3-BICLINK:Failover:changing to active mode

*Feb 16 03:24:54.931:%DIAL13-3-MSG:
02:32:06:%DSC_REDUNDANCY-3-EVENT:Redundancy event:LINK_FAIL from other DSC
*Feb 16 03:24:55.491:%OIR-6-INSCARD:Card inserted in slot 12, interfaces administratively
shut down
*Feb 16 03:24:58.455:%DIAL13-3-MSG:
02:32:09:%DSC_REDUNDANCY-3-EVENT:Redundancy event:LINK_FAIL from other DSC
*Feb 16 03:25:04.939:%DIAL13-0-MSG:

RouterB# show redundancy

failover mode enabled, failover group = 32

Currently ACTIVE role.
No connection to slot 12
DSC in slot 13:
Hub is in 'active' state.
Clock is in 'backup' state.

RouterB# show redundancy history

DSC Redundancy Status Change History:

010216 03:09 Slot -1 DSC:Failover configured -> BACKUP role.

010216 03:24 Slot 13 DSC:Failover -> ACTIVE role.
010216 03:24 Slot 13 DSC:Hub, becoming active - D12 linkfail
010216 03:24 Slot 13 DSC:Hub, becoming active - D12 linkfail

*Feb 16 03:26:14.079:%DSIPPF-5-DS_HELLO:DSIP Hello from shelf 47 slot 1 Succeeded

*Feb 16 03:26:14.255:%DSIPPF-5-DS_HELLO:DSIP Hello from shelf 47 slot 3 Succeeded
*Feb 16 03:26:14.979:%DSIPPF-5-DS_HELLO:DSIP Hello from shelf 47 slot 10 Succeeded

EXEC Mode Example

The following is sample output generated by this command in EXEC mode.
Router# show redundancy

MWR1900 is the Active Router

Previous States with most recent at bottom

INITL_INITL Dec 31 19:00:00.000

LISTN_INITL Feb 28 19:00:15.568
LISTN_LISTN Feb 28 19:00:15.568
SPEAK_LISTN Feb 28 19:00:18.568
SPEAK_SPEAK Feb 28 19:00:18.568
STDBY_SPEAK Mar 19 08:54:26.191
ACTIV_SPEAK Mar 19 08:54:26.191
ACTIV_STDBY Mar 19 08:54:26.191
ACTIV_ACTIV Mar 19 08:54:26.191
INITL_ACTIV Mar 19 08:56:22.700
INITL_INITL Mar 19 08:56:22.700
INITL_LISTN Mar 19 08:56:28.544
LISTN_LISTN Mar 19 08:56:28.652
LISTN_SPEAK Mar 19 08:56:31.544
SPEAK_SPEAK Mar 19 08:56:31.652
SPEAK_STDBY Mar 19 08:56:34.544
SPEAK_ACTIV Mar 19 08:56:34.544
STDBY_ACTIV Mar 19 08:56:34.652
ACTIV_ACTIV Mar 19 08:56:34.652
INITL_ACTIV Mar 19 10:20:41.455
INITL_INITL Mar 19 10:20:41.455
INITL_LISTN Mar 19 10:20:49.243
LISTN_LISTN Mar 19 10:20:49.299
LISTN_SPEAK Mar 19 10:20:52.244

Cisco IOS Interface and Hardware Component Command Reference

IR-714
 Interface and Hardware Component Commands
show redundancy

SPEAK_SPEAK Mar 19 10:20:52.300

SPEAK_STDBY Mar 19 10:20:55.244
STDBY_STDBY Mar 19 10:20:55.300
ACTIV_STDBY Mar 19 10:21:01.692
ACTIV_ACTIV Mar 19 10:21:01.692

Related Commands Command Description

debug redundancy Displays information used for troubleshooting dual (redundant)
router shelves (Cisco AS5800) or RSCs (Cisco AS5850).
hw-module Enables the router shelf to stop a DSC or to restart a stopped DSC.
mode y-cable Invokes y-cable mode.
redundancy Enters redundancy configuration mode.
show chassis Displays, for a router with two RSCs, information about mode
(handover-split or classic-split), RSC configuration, and slot
ownership.
show standby Displays the standby configuration.
standalone Specifies whether the MWR 1941-DC router is used in a redundant
or stand-alone configuration.
standby Sets HSRP attributes.

Cisco IOS Interface and Hardware Component Command Reference

IR-715
 Interface and Hardware Component Commands
show redundancy (HSA redundancy)

show redundancy (HSA redundancy)

To display the current redundancy mode, use the show redundancy command in user EXEC or
privileged EXEC mode.

show redundancy

Syntax Description This command has no arguments or keywords.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

11.2 GS This command was introduced.
12.0(16)ST This command was modified to display information about Route Processor
Redundancy (RPR).
12.0(19)ST1 This command was modified to display information about RPR Plus
(RPR+).
12.3(7)T The command modifications to support RPR and RPR+ were integrated into
Cisco IOS Release 12.3(7)T.

Usage Guidelines Use this command to display the redundancy mode of a Cisco 7500 series router. The default redundancy
mode is High System Availability (HSA). Use the redundancy configuration command to enter
redundancy configuration mode. Use the mode rpr command in redundancy configuration mode to
configure RPR as the high availability mode. HSA is the default high availability mode.

Examples The following is sample output from the show redundancy command for a router with RPR configured:
Router# show redundancy

redundancy mode rpr

hw-module slot 2 image slot0:rsp-pv-mz
hw-module slot 3 image slot0:rsp-pv-mz

Related Commands Command Description

hw-module sec-cpu reset Resets and reloads the standby RSP with the specified Cisco IOS image
and executes the image.
hw-module slot image Specifies a high availability Cisco IOS image to run on a standby RSP.
mode (HSA redundancy) Configures the redundancy mode.
redundancy Enters redundancy configuration mode.

Cisco IOS Interface and Hardware Component Command Reference

IR-716
 Interface and Hardware Component Commands
show (satellite initial configuration)

show (satellite initial configuration)

To display the initial configuration parameters for the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT), use the show command in satellite initial configuration mode.

show

Syntax Description This command has no arguments or keywords.

Command Modes Satellite initial configuration

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your
satellite service provider instructs you to perform the satellite initial configuration and provides all
necessary parameter values.
You can also view the satellite initial configuration parameters by entering the service-module satellite
slot/0 status command in privileged EXEC mode.

Examples The following example shows the satellite initial configuration parameters for the Cisco IP VSAT
satellite WAN network module (NM-1VSAT-GILAT):
Router(sat-init-config)# show
!
! Initial Configuration Parameters:
!
id aa-group 298
id software group 598
id vsat 6201
mode download
mode two-way
outbound data-pid 514
outbound data-rate 15000000
outbound frequency 1201000
outbound id 2
outbound modulation-type DVB
outbound sync ip address 172.16.0.3
outbound viterbi-rate 1/2
!
!
Router(sat-init-config)#

Cisco IOS Interface and Hardware Component Command Reference

IR-717
 Interface and Hardware Component Commands
show (satellite initial configuration)

Related Commands Command Description

service-module Displays status information related to the hardware and software on the
satellite status Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT),
including the initial configuration parameters.

Cisco IOS Interface and Hardware Component Command Reference

IR-718
 Interface and Hardware Component Commands
show service-module serial

show service-module serial

To display the performance report for an integrated CSU/DSU, use the show service-module serial
command in privileged EXEC mode.

show service-module serial number [performance-statistics [interval-range]]

Syntax Description number Interface number 0 or 1.

performance-statistics (Optional) Displays the CSU/DSU performance statistics for the past
24 hours. This keyword applies only to the fractional T1/T1 module.
interval-range (Optional) Specifies the number of 15-minute intervals displayed. You
can choose a range from 1 to 96, where each value represents the
CSU/DSU activity performed in that 15-minute interval. For example, a
range of 2-3 displays the performance statistics for the intervals two and
three.

Command Modes Privileged EXEC

Command History Release Modification

11.2 This command was introduced.

Usage Guidelines This command applies to the 2- and 4-wire 56/64-kbps CSU/DSU module and FT1/T1 CSU/DSU
module. The performance-statistics keyword applies only to the FT1/T1 CSU/DSU module.

Examples The following sample output shows CSU/DSU performance statistics on a Cisco 2524 or Cisco 2525
router for intervals 30 to 32. Each interval is 15 minutes long. All the data is zero because no errors were
discovered on the T1 line:
Router# show service-module serial 1 performance-statistics 30-32

Total Data (last 58 15 minute intervals):

0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs
Data in current interval (131 seconds elapsed):
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs
Data in Interval 30:
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs
Data in Interval 31:
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs

Cisco IOS Interface and Hardware Component Command Reference

IR-719
 Interface and Hardware Component Commands
show service-module serial

Data in Interval 32:

0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs

The following is sample output from the show service-module serial command for a fractional T1 line:
Router1# show service-module serial 0

Module type is T1/fractional

Hardware revision is B, Software revision is 1.1 ,
Image checksum is 0x2160B7C, Protocol revision is 1.1
Receiver has AIS alarm,
Unit is currently in test mode:
line loopback is in progress
Framing is ESF, Line Code is B8ZS, Current clock source is line,
Fraction has 24 timeslots (64 Kbits/sec each), Net bandwidth is 1536 Kbits/sec.
Last user loopback performed:
remote loopback
Failed to loopup remote
Last module self-test (done at startup): Passed
Last clearing of alarm counters 0:05:50
loss of signal : 1, last occurred 0:01:50
loss of frame : 0,
AIS alarm : 1, current duration 0:00:49
Remote alarm : 0,
Module access errors : 0,
Total Data (last 0 15 minute intervals):
Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs
Data in current interval (351 seconds elapsed):
1466 Line Code Violations, 0 Path Code Violations
25 Slip Secs, 49 Fr Loss Secs, 40 Line Err Secs, 1 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 49 Unavail Secs

The following sample output from the show service-module serial command displays the status of a
switched 56-KB line:
Router1# show service-module serial 1

Module type is 4-wire Switched 56

Hardware revision is B, Software revision is 1.00,
Image checksum is 0x44453634, Protocol revision is 1.0
Connection state: active,
Receiver has loss of signal, loss of sealing current,
Unit is currently in test mode:
line loopback is in progress
Current line rate is 56 Kbits/sec
Last user loopback performed:
dte loopback
duration 00:00:58
Last module self-test (done at startup): Passed
Last clearing of alarm counters 0:13:54
oos/oof : 3, last occurred 0:00:24
loss of signal : 3, current duration 0:00:24
loss of sealing curren: 2, current duration 0:04:39
loss of frame : 0,
rate adaption attempts: 0,

The following shows sample output from the show service-module serial command issued on a
Cisco 3640 modular access router:
Router# show service-module serial 0/1

Cisco IOS Interface and Hardware Component Command Reference

IR-720
Interface and Hardware Component Commands
show service-module serial

Module type is 4-wire Switched 56

Hardware revision is B, Software revision is 1.00,
Image checksum is 0x42364436, Protocol revision is 1.0
Connection state: Idle
Receiver has no alarms.
CSU/DSU Alarm mask is 0
Current line rate is 56 Kbits/sec
Last module self-test (done at startup): Passed
Last clearing of alarm counters 4d02h
oos/oof : 0,
loss of signal : 0,
loss of sealing curren: 0,
loss of frame : 0,
rate adaptation attemp: 0,

The following shows sample output from the show service-module serial command issued on a
Cisco 1605 router:
Router# show service-module serial 0

Module type is 4-wire Switched 56

Hardware revision is B, Software revision is 1.00,
Image checksum is 0x42364436, Protocol revision is 1.0
Receiver has oos/oof, loss of signal,
CSU/DSU Alarm mask is 4
Current line rate is 56 Kbits/sec
Last module self-test (done at startup): Passed
Last clearing of alarm counters 1d02h
oos/oof : 1, current duration 1d02h
loss of signal : 1, current duration 1d02h
loss of frame : 0,
rate adaptation attemp: 0,

Table 98 describes the fields displayed by the show service-module serial command.

Cisco IOS Interface and Hardware Component Command Reference

IR-721
 Interface and Hardware Component Commands
show service-module serial

Table 98 show service-module serial Field Descriptions

Field Description
Module type CSU/DSU module installed in the router. The possible modules are
T1/fractional, 2-wire switched 56-kbps, and 4-wire 56/64-kbps.
Receiver has AIS alarm Alarms detected by the FT1/T1 CSU/DSU module or 2- and 4-wire
56/64-kbps CSU/DSU modules.
Possible T1 alarms are as follows:
• Transmitter is sending remote alarm.
• Transmitter is sending AIS.
• Receiver has loss of signal.
• Receiver has loss of frame.
• Receiver has remote alarm.
• Receiver has no alarms.
Possible switched 56k alarms are as follows:
• Receiver has loss of signal.
• Receiver has loss of sealing current.
• Receiver has loss of frame.
• Receiver has rate adaptation attempts.
Unit is currently in test mode Loopback tests are in progress.
Framing Indicates frame type used on the line. Can be extended super frame or
super frame.
Line Code Indicated line-code type configured. Can be alternate mark inversion
(AMI) or binary 8-zero substitution (B8ZS).
Current clock source Clock source configured on the line, which can be supplied by the
service provider (line) or the integrated CSU/DSU module (internal).
Fraction Number of time slots defined for the FT1/T1 module, which can range
from 1 to 24.
Net bandwidth Total bandwidth of the line (for example, 24 time slots multiplied by
64 kbps equals a bandwidth of 1536 kbps).
Last user loopback performed Type and outcome of the last performed loopback.
Last module self-test (done at Status of the last self-test performed on an integrated CSU/DSU
startup): Passed module.
Last clearing of alarm List of network alarms that were detected and cleared on the
counters CSU/DSU module.
Total Data Shows the current accumulation period, which rolls into the 24-hour
Data in current interval accumulation every 15 minutes. The oldest 15-minute period falls off
the back of the 24-hour accumulation buffer.
Line Code Violations Indicates the occurrence of either a bipolar violation or excessive
zeroes error event.

Cisco IOS Interface and Hardware Component Command Reference

IR-722
 Interface and Hardware Component Commands
show service-module serial

Table 98 show service-module serial Field Descriptions (continued)

Field Description
Path Code Violations Indicates a frame synchronization bit error in the D4 and E1-no cyclic
redundancy checksum (CRC) formats or a CRC error in the extended
super frame (ESF) and E1-CRC formats.
Slip Secs Indicates the replication or detection of the payload bits of a DS1
frame. A slip may be performed when there is a difference between the
timing of a synchronous receiving terminal and the received signal.
Fr Loss Secs Indicates the number of seconds an Out-of-Frame error is detected.
Line Err Secs Line errored seconds is a second in which one or more line code
violation errors are detected.
Errored Secs In ESF and E1-CRC links, an errored second is a second in which one
of the following is detected: one or more path code violations; one or
more Out-of-Frame defects; one or more controlled slip events; a
detected AIS defect.
For D4 and E1-no-CRC links, the presence of bipolar violation also
triggers an errored second.
Bursty Err Secs Second with fewer than 320 and more than 1 path coding violation
errors. No severely errored frame defects or incoming AIS defects are
detected. Controlled slips are not included in this parameter.
Severely Err Secs For ESF signals, a second with one of the following errors: 320 or
more path code violation errors; one or more Out-of-Frame defects; a
detected AIS defect.
For D4 signals, a count of 1-second intervals with framing errors, or
an Out-of-Frame defect, or 1544 line code violations.
Unavail Secs Total time the line was out of service.

Related Commands Command Description

clear service-module serial Resets an integrated CSU/DSU.

Cisco IOS Interface and Hardware Component Command Reference

IR-723
 Interface and Hardware Component Commands
show smf

show smf
To display the configured software MAC address filter (SMF) on various interfaces of a router, use the show
smf command in user EXEC or privileged EXEC mode.

show smf [interface-name]

Syntax Description interface-name (Optional) Displays information about the specified interface. Choices can
include atm, ethernet, fastethernet, null, serial, tokenring, and async.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

10.0 This command was introduced in a release prior to 10.0.

Usage Guidelines The SMF is active whenever the router is doing bridging or Integrated Routing and Bridging (IRB). MAC
address filtering can be used as a security feature in bridging or switching environments.

Examples The following is sample output from the show smf command:
Router# show smf fastethernet

Software MAC address filter on FastEthernet0/0.2

Hash Len Address Matches Act Type
0x00: 0 ffff.ffff.ffff 0 RCV Physical broadcast
0x0C: 0 0100.0c00.0000 0 RCV ISL vLAN Multicast
0x2A: 0 0900.2b01.0001 0 RCV DEC spanning tree
0xA6: 0 0010.a6ae.6000 0 RCV Interface MAC address
0xC1: 0 0100.0ccc.cccd 0 RCV SSTP MAC address
0xC2: 0 0180.c200.0000 0 RCV IEEE spanning tree
0xC2: 1 0180.c200.0000 0 RCV IBM spanning tree
0xC2: 2 0100.0ccd.cdce 0 RCV VLAN Bridge STP

Table 99 describes the fields shown in the display.

Table 99 show smf Field Descriptions

Field Description
Hash Position in the hash table for this entry.
Len Length of the entry.
Address MAC address for the interface.
Matches Number of hits for the address.

Cisco IOS Interface and Hardware Component Command Reference

IR-724
Interface and Hardware Component Commands
show smf

Table 99 show smf Field Descriptions (continued)

Field Description
Act Action taken. Values can be receive (RCV), forward
(FWD), or discard (DIS).
Type Type of MAC address.

Cisco IOS Interface and Hardware Component Command Reference

IR-725
 Interface and Hardware Component Commands
show storm-control

show storm-control
To display switchport characteristics, including storm-control levels set on the interface, use the show
storm-control command in privileged EXEC mode.

show storm-control [interface-type interface-number] [broadcast | multicast | unicast | history]

Syntax Description interface-type (Optional) Port for which information is to be displayed.

interface-number
broadcast (Optional) Displays broadcast storm information. This is the default.
multicast (Optional) Displays multicast storm information.
unicast (Optional) Displays unicast storm information.
history (Optional) Displays storm history on a per-port basis.

Defaults If the interface-type and interface-number values are omitted, the show storm-control command
displays storm-control settings for all ports on the switch.
You can display broadcast, multicast, or unicast packet-storm information by using the corresponding
keyword. When no keyword option is specified, the default is to display broadcast storm-control
information.

Command Modes Privileged EXEC

Command History Release Modification

12.2(2)XT This command was introduced.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T to support
switchport creation on Cisco 2600 series, Cisco 3600 series, and Cisco 3700 series
routers.
12.2(15)ZJ The interface-type and interface-number arguments and the broadcast, multicast,
unicast, and history keywords were added to support the Ethernet switch network
module on the Cisco 2600 series, Cisco 3600 series, and Cisco 3700 series routers.
12.3(4)T The arguments and keywords were integrated into Cisco IOS Release 12.3(4)T on
the following platforms: Cisco 2600 series, Cisco 3600 series, and Cisco 3700
series routers.

Examples The following is partial sample output from the show storm-control broadcast command:
Router# show storm-control broadcast

Interface Filter State Upper Lower Current

--------- ------------- ------- ------- -------
Fa0/1 <inactive> 100.00% 100.00% 0.00%
Fa0/2 <inactive> 100.00% 100.00% 0.00%
Fa0/3 <inactive> 100.00% 100.00% 0.00%
Fa0/4 Forwarding 30.00% 20.00% 20.32%

Cisco IOS Interface and Hardware Component Command Reference

IR-726
Interface and Hardware Component Commands
show storm-control

.
.
.

Table 100 describes the fields shown in the display.

Table 100 show storm-control broadcast Field Descriptions

Field Description
Interface Displays the ID of the interface.
Filter State Displays the status of the filter:
• Blocking—Storm control is enabled, a storm has occurred, and the
action is filter.
• Forwarding—Storm control is enabled, and a storm has not occurred.
• Inactive—Storm control is disabled.
• Shutdown—Storm control is enabled, a storm has occurred, and the
action is to shut down.
Note If an interface is disabled by a broadcast, multicast, or unicast storm,
the filter state for all traffic types is shutdown.
Upper Displays the rising suppression level as a percentage of total available
bandwidth.
Lower Displays the falling suppression level as a percentage of total available
bandwidth.
Current Displays the bandwidth utilization of a specific traffic type as a percentage
of total available bandwidth. This field is valid only when storm control is
enabled.

The following is sample output from the show storm-control fastethernet0/4 history command, which
displays the ten most recent storm events for an interface:
Router# show storm-control fastethernet0/4 history

Interface Fa0/4 Storm Event History

Event Type Event Start Time Duration (seconds)

------------------ ---------------- ------------------
Unicast 04:58:18 206
Broadcast 05:01:54 n/a
Multicast 05:01:54 n/a
Unicast 05:01:54 108
Broadcast 05:05:00 n/a
Multicast 05:05:00 n/a
Unicast 05:06:00 n/a
Broadcast 05:09:39 n/a
Multicast 05:09:39 n/a
Broadcast 05:11:32 172

Table 101 describes the fields shown in the display.

Cisco IOS Interface and Hardware Component Command Reference

IR-727
 Interface and Hardware Component Commands
show storm-control

Table 101 show storm-control history Field Descriptions

Field Description
Interface Displays the ID of the interface.
Event Type Displays the type of storm event. The event type is one of the following:
• Broadcast
• Multicast
• Unicast
Event Start Time Time when the event started, in hours, minutes, seconds.
Duration (seconds) Duration time of the event, in seconds.
Note The duration field could be n/a when a storm is still present or when
a new storm of a different type occurs before the current storm ends.

Related Commands Command Description

show interface counters Displays the count of discarded packets.
storm control Enables broadcast, multicast, or unicast storm control on a port.

Cisco IOS Interface and Hardware Component Command Reference

IR-728
 Interface and Hardware Component Commands
show syscon sdp

show syscon sdp

To display information about the Shelf Discovery Protocol (SDP), use the show syscon sdp command
in privileged EXEC or user EXEC mode.

show syscon sdp

Syntax Description This command has no arguments or keywords.

Command Modes Privileged EXEC

User EXEC

Command History Release Modification

11.3AA This command was introduced.

Examples The following is sample output from the show syscon sdp command:
Router# show syscon sdp

Current time 10:46:32 PST Jan 28 1998, system controller 172.23.66.100

Last hello packet received at 10:45:38 PST Jan 28 1998
11773 Total SDP packets
0 packets with bad MD5 hash
5884 Hello packets received
5889 Hello packets sent
0 Command packets received
0 Command packets sent

Table 102 describes the fields shown in the sample display.

Table 102 show syscon sdp Field Descriptions

Field Description
Current time Current time and date.
system controller IP address of the system controller.
Last hello packet received Time and date when the last hello packet from the system
controller was received by the shelf.
Total SDP packets Total number of SDP packets sent or received by the shelf.
packets with bad MD5 hash Number of packets with a bad MD5 hash.
Hello packets received Number of hello packets received by the shelf from the
system controller.
Hello packets sent Number of hello packets sent from the shelf to the system
controller.

Cisco IOS Interface and Hardware Component Command Reference

IR-729
 Interface and Hardware Component Commands
show syscon sdp

Table 102 show syscon sdp Field Descriptions

Field Description
Command packets received Number of packets containing commands received by the
shelf.
Command packets sent Number of commands sent by the shelf.

Related Commands Command Description

syscon address Specifies the system controller for a managed shelf.
syscon Specifies the interface to use for the source address in SDP packets.
source-interface

Cisco IOS Interface and Hardware Component Command Reference

IR-730
 Interface and Hardware Component Commands
show tdm backplane

show tdm backplane

To display modem and PRI channel assignments with streams and channels on the modem side as
assigned to the unit and channels on the PRI side of the time-division multiplexing (TDM) assignment,
use the show tdm backplane command in privileged EXEC mode.

show tdm backplane stream [stream-number]

Syntax Description stream Backplane stream in the range 0 to 7. There are 8 backplane “streams” on the
TDM backplane for the Cisco AS5300 access server. Each stream runs at
2 MHz and has 32 channels (running at 64 Hz) on the Cisco AS5300 access
server backplane hardware.
stream-number (Optional) Actual number entered (either 0 to 7 or 0 to 15).

Command Modes Privileged EXEC

Command History Release Modification

12.0(2)XD This command was introduced.
12.0(3)T This command was integrated into Cisco IOS Release 12.0(3)T.

Usage Guidelines The show tdm backplane command shows the status of the TDM backplane, related data structure
values, and TDM chip memory settings. This commands is generally used only by a Cisco technical
support representative during troubleshooting of data continuity problems.

Examples The following example shows sample output for the show tdm backplane command. When the debug
tdm detail command is executed, more detail is shown. The following examples are run with the debug
tdm detail command executed:
Router# show tdm backplane

Show BackPlane Connections

TDM Backplane Connection for Stream 0
Modem (St/Ch)<->PRI (Unit/Ch) xx/xx:Not Used ??/??:Unknown State
0 : xx/xx<->xx/xx, xx/xx<->xx/xx, 00/02<->00/30, 00/03<->03/10
4 : 00/04<->00/15, 00/05<->02/02, 00/06<->02/07, 00/07<->02/08
8 : xx/xx<->xx/xx, 00/09<->03/11, 00/10<->02/09, xx/xx<->xx/xx
12 : 00/12<->00/17, 00/13<->02/17, 00/14<->02/18, 00/15<->02/10
16 : xx/xx<->xx/xx, xx/xx<->xx/xx, 00/18<->00/19, 00/19<->02/19
20 : 00/20<->02/11, xx/xx<->xx/xx, xx/xx<->xx/xx, 00/23<->00/07
24 : xx/xx<->xx/xx, 00/25<->00/01, 00/26<->00/20, 00/27<->02/20
28 : xx/xx<->xx/xx, 00/29<->00/18, xx/xx<->xx/xx, xx/xx<->xx/xx

TDM Backplane Connection for Stream 1

Modem (St/Ch)<->PRI (Unit/Ch) xx/xx:Not Used ??/??:Unknown State
0 : xx/xx<->xx/xx, xx/xx<->xx/xx, xx/xx<->xx/xx, 01/03<->03/09
4 : 01/04<->00/03, 01/05<->02/13, xx/xx<->xx/xx, xx/xx<->xx/xx
8 : xx/xx<->xx/xx, xx/xx<->xx/xx, 01/10<->02/14, 01/11<->00/04

Cisco IOS Interface and Hardware Component Command Reference

IR-731
 Interface and Hardware Component Commands
show tdm backplane

12 : 01/12<->00/21, xx/xx<->xx/xx, 01/14<->00/05, xx/xx<->xx/xx

16 : xx/xx<->xx/xx, xx/xx<->xx/xx, xx/xx<->xx/xx, 01/08<->02/12
20 : 01/20<->00/06, 01/09<->00/02, xx/xx<->xx/xx, xx/xx<->xx/xx
24 : 01/24<->03/01, xx/xx<->xx/xx, 01/26<->02/15, xx/xx<->xx/xx
28 : 01/28<->03/05, xx/xx<->xx/xx, xx/xx<->xx/xx, xx/xx<->xx/xx
.
.
.

Related Commands Command Description

debug tdm detail Displays debugging messages about TDM commands.
show tdm connections Displays details about a specific TDM channel programmed on the Mitel
chip.
show tdm data Displays information about TDM bus connection memory on Cisco
access servers.
show tdm detail Displays information about the specified TDM device.
show tdm information Displays TDM resources available for the specified TDM device.
show tdm pool Displays information about the specified TDM pool.

Cisco IOS Interface and Hardware Component Command Reference

IR-732
 Interface and Hardware Component Commands
show tdm connections

show tdm connections

To display a snapshot of the time-division multiplexing (TDM) bus connection memory in a Cisco access
server or to display information about the connection memory programmed on the Mitel TDM chip in a
Cisco AS5800 access server, use the show tdm connections command in privileged EXEC mode.

Standard Syntax

show tdm connections [motherboard | slot slot-number]

Cisco AS5800 Access Server

show tdm connections {motherboard {stream stream-number} | slot slot-number {device

device-number {stream stream-number}}}

Syntax Description motherboard (Optional) Displays connection memory for the TDM bus connections on the
motherboard in the Cisco access server only.

Cisco AS5800 Access Server

The motherboard in the Cisco AS5800 access server has ethernet and serial
interfaces, console port, and aux port. The motherboard has one TDM device
(MT8980) for the Cisco 5300 access server.
slot slot-number (Optional) Slot number.

Cisco AS5800 Access Server

There are three slots on the Cisco AS5800 access server. The range of the slots
is from 0 to 2. A modem card or a trunk PRI card can be inserted into each slot.
Each card in the slot has one or two TDM devices (either MT8980 or MT90820)
on them.
stream Device stream in the range 0 to 7. There are 8 backplane “streams” on the TDM
backplane for the Cisco AS5800 access server. Each stream runs at 2 Mhz and
has 32 channels (running at 64 Hz) on the Cisco AS5800 access server
backplane hardware.
stream-number Stream number (the range is from 0 to 7 or 0 to 15).
device TDM device on the motherboard or slot cards. The range for the Cisco AS5800
access server is from 0 to 1. Each card has at least one TDM device (MT8980 or
MT80920), and some of the slot cards have two devices (for example, the Octal
PRI has two MT90820 TDM devices). The TDM device is also referred to as
“TSI Chip Number” in the online help.
device-number Valid range is from 0 to 1.

Command Modes Privileged EXEC

Cisco IOS Interface and Hardware Component Command Reference

IR-733
 Interface and Hardware Component Commands
show tdm connections

Command History Release Modification

11.2 This command was introduced.
12.0(3)T This command was modified to include support for the Cisco AS5800 access
server.

Usage Guidelines Cisco AS5800 Access Server

The show tdm connections command shows the status of the TDM chip memory settings. This
command is generally used only by a Cisco technical support representative during troubleshooting of
data continuity problems.

Examples Cisco AS5800 Access Server

The following example shows sample output for the show tdm connections command. When the debug
tdm detail command is executed, more detail is shown. The following examples are run with the debug
tdm detail executed.
Router# show tdm connections slot 0

Slot 0 MT8980 TDM Device 0, Control Register = 0x1E, ODE Register = 0x01
Connection Memory for ST0:
Ch0: 0x00 0xE1, Ch1: 0x00 0xE2, Ch2: 0x01 0xDE, Ch3: 0x00 0x00
Ch4: 0x01 0xCF, Ch5: 0x00 0xE4, Ch6: 0x00 0xE5, Ch7: 0x00 0x00
Ch8: 0x00 0xEB, Ch9: 0x00 0xE6, Ch10: 0x00 0xE7, Ch11: 0x00 0x00
Ch12: 0x01 0xD1, Ch13: 0x00 0xE8, Ch14: 0x00 0x00, Ch15: 0x00 0xE9
Ch16: 0x00 0x00, Ch17: 0x00 0xD2, Ch18: 0x01 0xD3, Ch19: 0x00 0xEA
Ch20: 0x00 0xEB, Ch21: 0x00 0xC1, Ch22: 0x00 0xEC, Ch23: 0x01 0xC7
Ch24: 0x00 0xED, Ch25: 0x01 0xC1, Ch26: 0x01 0xD4, Ch27: 0x00 0xEE
Ch28: 0x00 0xE1, Ch29: 0x01 0xD2, Ch30: 0x00 0x00, Ch31: 0x00 0x00
Connection Memory for ST1:
Ch0: 0x00 0xEF, Ch1: 0x00 0xC2, Ch2: 0x00 0xED, Ch3: 0x00 0xF1
Ch4: 0x01 0xC3, Ch5: 0x00 0xF2, Ch6: 0x00 0xE2, Ch7: 0x00 0x00
Ch8: 0x00 0xF3, Ch9: 0x00 0xFF, Ch10: 0x00 0xF4, Ch11: 0x01 0xC4
Ch12: 0x01 0xD5, Ch13: 0x00 0xF5, Ch14: 0x01 0xC5, Ch15: 0x00 0xEE
Ch16: 0x00 0xF6, Ch17: 0x00 0xE3, Ch18: 0x00 0x00, Ch19: 0x00 0xF7
Ch20: 0x01 0xC6, Ch21: 0x01 0xC2, Ch22: 0x00 0xF8, Ch23: 0x00 0xE4
Ch24: 0x00 0xF9, Ch25: 0x00 0xC7, Ch26: 0x00 0x00, Ch27: 0x00 0xFA
Ch28: 0x00 0xFB, Ch29: 0x00 0xE5, Ch30: 0x00 0x00, Ch31: 0x00 0x00

Related Commands Command Description

debug tdm detail Displays debugging messages about TDM commands.
show tdm data Displays information about TDM bus connection memory on Cisco access
servers.

Cisco IOS Interface and Hardware Component Command Reference

IR-734
 Interface and Hardware Component Commands
show tdm data

show tdm data

To display a snapshot of the time-division multiplexing (TDM) bus data memory in a Cisco access server
or to display data memory that is programmed on the Mitel TDM chip in a Cisco 5800 access server, use
the show tdm data command in privileged EXEC mode.

Standard Syntax

show tdm data [motherboard | slot slot-number]

Cisco AS5800 Access Server

show tdm data {motherboard {stream stream-number} | slot slot-number {device device-number
{stream stream-number}}}

Syntax Description motherboard (Optional) Displays bus data memory for the TDM bus connections on the
motherboard in the Cisco access server only.

Cisco AS5800 Access Server

The motherboard on the Cisco AS5300 access server has the ethernet I/Fs,
serial I/Fs, console port, and aux port. The motherboard has one TDM device
(MT8980) for the Cisco AS5300 access server.
slot slot-number (Optional) Slot number.

Cisco AS5800 Access Server

In addition to the motherboard, there are three slots on the Cisco AS5300
access server. The range of the slots is 0 to 2. A modem card or a trunk PRI
card can be inserted in each slot. Each card in the slot has one or two TDM
devices (either MT8980 or MT90820) on them.
stream TDM device stream in the range 0 to 15. There are up to 16 streams on a
TDM device (Mitel 90820). The TDM device is also known as the TSI chip.
The help on the command (by typing ?) indicates whether the stream is
“Stream number within the TSI chip” or “Backplane Stream.”
stream-number Stream number within the range of either 0 to 7 or 0 to 15.
device TDM device on the motherboard, or slot cards. Valid range for the
Cisco AS5300 access server is 0 to 1. Each card has at least one TDM device
(MT8980 or MT80920), and the Octal PRI has two MT90820 TDM devices.
Also referred to as TSI Chip Number in the help pages.
device-number Valid range is from 0 to 1.

Command Modes Privileged EXEC

Cisco IOS Interface and Hardware Component Command Reference

IR-735
 Interface and Hardware Component Commands
show tdm data

Command History Release Modification

11.2 This command was introduced.
12.0(3)T This command was modified to include support for the Cisco AS5800 access
server.

Usage Guidelines The data memory for all TDM bus connections in the access server is displayed if you do not specify a
motherboard or slot.

Cisco AS5800 Access Server

The show tdm data command shows the status of the TDM data structure values. This command is
generally used only by a Cisco technical support representative during troubleshooting of data continuity
problems.

Examples The following is sample output for the show tdm data command on a Cisco AS5800 access server. When
the debug tdm detail command is executed, more detail is shown. The following example is run with
the debug tdm detail executed:
Router# show tdm data

Motherboard MT8980 TDM Device 0, Control Register = 0x1F, ODE Register = 0xE1
Data Memory for ST0:
Ch0: 0xFF, Ch1: 0xFF, Ch2: 0x98, Ch3: 0x61
Ch4: 0x0C, Ch5: 0xE1, Ch6: 0x8D, Ch7: 0x86
Ch8: 0xFF, Ch9: 0xF3, Ch10: 0xE4, Ch11: 0xFF
Ch12: 0x51, Ch13: 0x02, Ch14: 0x18, Ch15: 0x14
Ch16: 0xFF, Ch17: 0xFF, Ch18: 0x05, Ch19: 0xC7
Ch20: 0x00, Ch21: 0xFF, Ch22: 0xFF, Ch23: 0x98
Ch24: 0xFF, Ch25: 0x15, Ch26: 0x5C, Ch27: 0x15
Ch28: 0xFF, Ch29: 0x80, Ch30: 0xFF, Ch31: 0xFF
Data Memory for ST1:
Ch0: 0xFF, Ch1: 0xFF, Ch2: 0xFF, Ch3: 0x62
Ch4: 0x94, Ch5: 0x88, Ch6: 0xFF, Ch7: 0xFF
Ch8: 0xFF, Ch9: 0xFF, Ch10: 0xFB, Ch11: 0x91
Ch12: 0xF7, Ch13: 0xFF, Ch14: 0x96, Ch15: 0xFF
Ch16: 0xFF, Ch17: 0xFF, Ch18: 0xFF, Ch19: 0x94
Ch20: 0x8F, Ch21: 0x95, Ch22: 0xFF, Ch23: 0xFF
Ch24: 0xE2, Ch25: 0xFF, Ch26: 0xD3, Ch27: 0xFF
Ch28: 0x87, Ch29: 0xFF, Ch30: 0xFF, Ch31: 0xFF
Data Memory for ST2:
.
.
.

Related Commands Command Description

debug tdm detail Displays debugging messages about TDM commands.
show tdm connections Displays details about a specific TDM channel programmed on the Mitel
chip.

Cisco IOS Interface and Hardware Component Command Reference

IR-736
 Interface and Hardware Component Commands
show tdm detail

show tdm detail

To display details about a specific time-division mulltiplexing (TDM) channel programmed on the Mitel
chip, use the show tdm detail command in privileged EXEC mode.

show tdm detail slot-number/device-number source-stream-number/source-channel-number

Syntax Description slot-number There are three slots on the Cisco AS5300 access server. A modem
card or a trunk PRI card can be inserted in each slot. Each card has
one or two TDM devices (either MT8980 or MT90820) on it. The
valid range is from 0 to 2.
/device-number TDM device on the motherboard or slot cards. Each card has at least
one TDM device (MT8980 or MT80920), and the Octal PRI has two
MT90820 TDM devices. Also referred to a TSI Chip Number in the
online help. The valid range is from 0 to 1.
source-stream-number Source stream number from the TDM device. The valid range is from
0 to 15.
/source-channel-number Source channel from the TDM device stream. The valid range is from
0 to 31.

Command Modes Privileged EXEC

Command History Release Modification

12.0(2)XD This command was introduced.
12.0(3)T This command was integrated into Cisco IOS Release 12.0(3)T.

Usage Guidelines The show tdm detail command shows the status of the TDM backplane, related data structure values,
and TDM chip memory settings. This command is generally used only by a Cisco technical support
representative during troubleshooting of data continuity problems.
This command indicates connection memory and map, data memory, and whether the channel is enabled
or disabled. Specify the specific slot, TDM device, TDM stream, and TDM channel.

Examples The following example shows sample output displayed for the show tdm detail command. When the
debug tdm detail command is executed, more detail is shown. The following example was run with the
debug tdm detail command executed:
Router# show tdm detail 0/0 1/2

Show Detail TDM device info: slot 0 unit 0

ODE Register: 0x0001
Connection Memory: 0x00ED, Output is Disable
Connection Map: STi7 CHi13 ----> STo1 CHo2
Data Memory: 0x00FF

Cisco IOS Interface and Hardware Component Command Reference

IR-737
 Interface and Hardware Component Commands
show tdm detail

Related Commands Command Description

debug tdm detail Displays debugging messages about TDM commands.
show tdm backplane Displays modem and PRI channel assignments with streams and
channels on the modem side as assigned to the unit and channels on the
PRI side of the TDM assignment.
show tdm connections Displays details about a specific TDM channel programmed on the Mitel
chip.
show tdm data Displays information about TDM bus connection memory on Cisco
access servers.
show tdm information Displays TDM resources available for the specified TDM device.
show tdm pool Displays information about the specified TDM pool.

Cisco IOS Interface and Hardware Component Command Reference

IR-738
 Interface and Hardware Component Commands
show tdm information

show tdm information

To display information about the specified time-division multiplexing (TDM) device, use the show tdm
information command in privileged EXEC mode.

show tdm information {motherboard | slot slot-number {device device-number}}

Syntax Description motherboard Motherboard on the Cisco AS5300 access server has the Ethernet
I/Fs, serial I/Fs, console port, and aux port. The motherboard has one
TDM device (MT8980) for the Cisco AS5300 access server.
slot There are three slots on the Cisco AS5300 access server. The range
of the slots is 0 to 2. A modem card or a trunk PRI card can be
inserted in each slot. Each card has one or two TDM devices (either
MT8980 or MT90820) on it.
slot-number Slot number. Valid range is from 0 to 2.
device TDM device on the motherboard or slot cards. The valid range is
from 0 to 1. Each card has at least one TDM device (MT8980 or
MT80920), and the Octal PRI has two MT90820 TDM devices. Also
referred to as TSI Chip Number in the online help.
device-number Device number. Valid range is from 0 to 1.

Command Modes Privileged EXEC

Command History Release Modification

12.0(2)XD This command was introduced.
12.0(3)T This command was integrated into Cisco IOS Release 12.0(3)T.

Usage Guidelines The show tdm information command shows the status of the TDM backplane, related data structure
values, and TDM chip memory settings. This command is generally used only by a Cisco technical
support representative during troubleshooting of data continuity problems.
This command displays the register base address, device type, and capabilities on a per-slot basis.

Examples The following example shows sample output for the show tdm information command. When the debug
tdm detail command is executed, more detail is shown. The following example is run with the debug
tdm detail command executed:
Router# show tdm information motherboard

TDM Slot Info display for Motherboard:

Slot Info ptr @0x610D39C0 Feature info ptr @0x60B737E8
Feature board is MOTHERBOARD, NIM ID: 0x30
TSI device is MT8980, 1 on this board. Each TSI device supports 0 DS1s
First TSI device is at offset: 0x100
TSI device 0, register base 0x3E801100
TDM Device Info ptr @0x611AA3EC for slot -1

Cisco IOS Interface and Hardware Component Command Reference

IR-739
 Interface and Hardware Component Commands
show tdm information

TSI device Info ptr @0x60FCC0BC memory size = 0x100

This device supports 8 streams with 32 channels per stream
TDM Information display for slot 0:
Slot Info ptr @0x610D39E4 Feature info ptr @0x60B73818
Feature board is E1 Quad PRI, NIM ID: 0x43
TSI device is MT8980, 2 on this board. Each TSI device supports 2 DS1s
First TSI device is at offset: 0x100, Second TSI device is at Offset: 0x200
HDLC Streams start at 4
Framer Streams start at 6
TSI device 0, register base 0x3C400100
TDM Device Info ptr @0x61222054 for slot 0
TSI device Info ptr @0x60FCC0BC memory size = 0x100
This device supports 8 streams with 32 channels per stream
TSI device 1, register base 0x3C400200
TDM Device Info ptr @0x61222098 for slot 0
TSI device Info ptr @0x60FCC0BC memory size = 0x100
This device supports 8 streams with 32 channels per stream
TDM Information display for slot 1:
Slot Info ptr @0x610D3A08 Feature info ptr @0x60B738A8
Feature board is High Density Modems, NIM ID: 0x47
TSI device is MT8980, 1 on this board. Each TSI device supports 0 DS1s
First TSI device is at offset: 0x100
TSI device 0, register base 0x3C500100
TDM Device Info ptr @0x612F1B80 for slot 1
TSI device Info ptr @0x60FCC0BC memory size = 0x100
This device supports 8 streams with 32 channels per stream
TDM Information display for slot 2:
Slot Info ptr @0x610D3A2C Feature info ptr @0x60B738A8
Feature board is High Density Modems, NIM ID: 0x47
TSI device is MT8980, 1 on this board. Each TSI device supports 0 DS1s
First TSI device is at offset: 0x100
TSI device 0, register base 0x3C600100
TDM Device Info ptr @0x613A6F60 for slot 2
TSI device Info ptr @0x60FCC0BC memory size = 0x100
This device supports 8 streams with 32 channels per stream

Related Commands Command Description

debug tdm detail Displays debugging messages about TDM commands.
show tdm backplane Displays modem and PRI channel assignments with streams and
channels on the modem side as assigned to the unit and channels on the
PRI side of the TDM assignment.
show tdm connections Displays details about a specific TDM channel programmed on the Mitel
chip.
show tdm data Displays information about TDM bus connection memory on Cisco
access servers.
show tdm detail Displays information about the specified TDM device.
show tdm pool Displays information about the specified TDM pool.

Cisco IOS Interface and Hardware Component Command Reference

IR-740
 Interface and Hardware Component Commands
show tdm pool

show tdm pool

To display time-division multiplexing (TDM) resources available for a TDM device, use the show tdm
pool command in privileged EXEC mode.

show tdm pool [slot slot-number]

Syntax Description slot (Optional) There are three slots on the Cisco AS5300 access server with a
range of 0 to 2. A modem card or a trunk PRI card can be inserted in each
slot. Each card has one or two TDM devices (either MT8980 or MT90820)
on it.
slot-number (Optional) Slot number. Valid range is from 0 to 2 for the Cisco AS5300
access server.

Command Modes Privileged EXEC

Command History Release Modification

12.0(2)XD This command was introduced.
12.0(3)T This command was integrated into Cisco IOS Release 12.0(3)T.

Usage Guidelines The show tdm pool command shows the status of the TDM backplane, related data structure values, and
TDM chip memory settings. This command is generally used only by a Cisco technical support
representative during troubleshooting of data continuity problems.
This command displays TDM groups, where group 0 is streams 0 to 3 and group 1 is streams 4 to 7. It
also displays register address and capabilities on a per-slot basis.

Examples The following example shows sample output for the show tdm pool command. When the debug tdm
detail command is executed, more detail is shown. The following example was run with the debug tdm
detail command executed:
Router# show tdm pool

Dynamic Backplane Timeslot Pool:

Grp ST Ttl/Free Req(Cur/Ttl/Fail) Queues(Free/Used) Pool Ptr
0 0-3 120 60 60 361 0 0x61077E28 0x61077E28 0x61077E20
1 4-7 0 0 0 0 0 0x61077E38 0x61077E28 0x61077E24

Related Commands Command Description

debug tdm detail Displays debugging messages about TDM commands.
show tdm backplane Displays modem and PRI channel assignments with streams and
channels on the modem side as assigned to the unit and channels on the
PRI side of the TDM assignment.

Cisco IOS Interface and Hardware Component Command Reference

IR-741
 Interface and Hardware Component Commands
show tdm pool

Command Description
show tdm connections Displays details about a specific TDM channel programmed on the Mitel
chip.
show tdm data Displays information about TDM bus connection memory on Cisco
access servers.
show tdm detail Displays information about the specified TDM device.
show tdm information Displays TDM resources available for the specified TDM device.

Cisco IOS Interface and Hardware Component Command Reference

IR-742
 Interface and Hardware Component Commands
shutdown (controller)

shutdown (controller)
To disable the Channelized T3 Interface Processor (CT3IP) in Cisco 7500 series routers, use the
shutdown command in controller configuration mode. To restart a disabled CT3IP, use the no form of
this command.

shutdown

no shutdown

Syntax Description This command has no arguments or keywords.

Defaults Using this command assumes that the controller is already enabled. By default, if this command is not
issued, the controller remains enabled.

Command Modes Controller configuration

Command History Release Modification

11.3 This command was introduced.

Usage Guidelines Shutting down the CT3IP disables all functions on the interface and sends a blue alarm to the network.
The shutdown command marks the interface as unavailable. To check if the CT3IP is disabled, use the
show controllers t3 command.

Examples The following example shuts down the CT3IP:

Router(config)# controller t3 9/0/0
Router(config-controller)# shutdown

Related Commands Command Description

show controllers t3 Displays the hardware and software driver information for a T3 controller.

Cisco IOS Interface and Hardware Component Command Reference

IR-743
 Interface and Hardware Component Commands
shutdown (hub)

shutdown (hub)
To shut down a port on an Ethernet hub of a Cisco 2505 or Cisco 2507 router, use the shutdown
command in hub configuration mode. To restart the disabled hub, use the no form of this command.

shutdown

no shutdown

Syntax Description This command has no arguments or keywords.

Defaults Using this command assumes that the hub is already enabled. By default, if this command is not issued,
the hub remains enabled.

Command Modes Hub configuration

Command History Release Modification

10.3 This command was introduced.

Examples The following example shuts down hub 0, ports 1 through 3:

Router(config)# hub ethernet 0 1 3
Router(config-hub)# shutdown

Related Commands Command Description

hub Enables and configures a port on an Ethernet hub of a Cisco 2505 or
Cisco 2507 router.

Cisco IOS Interface and Hardware Component Command Reference

IR-744
 Interface and Hardware Component Commands
shutdown (interface)

shutdown (interface)
To disable an interface, use the shutdown command in interface configuration mode. To restart a
disabled interface, use the no form of this command.

shutdown

no shutdown

Syntax Description This command has no arguments or keywords.

Defaults Using this command assumes that the interface is already enabled. By default, if this command is not
issued, the interface remains enabled.

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines The shutdown command disables all functions on the specified interface. On serial interfaces, this
command causes the data terminal ready (DTR) signal to be dropped. On Token Ring interfaces, this
command causes the interface to be removed from the ring. On FDDI interfaces, this command causes
the optical bypass switch, if present, to go into bypass mode.
This command also marks the interface as unavailable. To check whether an interface is disabled, use
the show interfaces EXEC command; 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:

Router(config)# interface ethernet 0
Router(config-if)# shutdown
08:32:03:%LINK-5-CHANGED:Interface Ethernet 0, changed state to administratively down

The following example turns the interface back on:

Router(config)# interface ethernet 0
Router(config-if)# no shutdown
08:32:16:%LINK-3-UPDOWN:Interface Ethernet 0, changed state to up
08:32:17:%LINEPROTO-5-UPDOWN:Line protocol on Interface Ethernet 0, changed state to up

Related Commands Command Description

interface Configures an interface type and enters interface configuration mode.
show interfaces Displays the statistical information specific to a serial interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-745
 Interface and Hardware Component Commands
signaling

signaling
To enable channel-associated signaling (CAS), use the signaling command in CEM configuration mode.
To disable signaling, use the no form of this command.

signaling

no signaling

Syntax Description This command has no arguments or keywords.

Defaults CAS is disabled.

Command Modes CEM configuration

Command History Release Modification

12.3(7)T This command was introduced.

Examples The following example demonstrates how to enable signaling.

Router(config-cem)# signaling

Related Commands Command Description

cem Enters circuit emulation configuration mode.
show cem Displays CEM channel statistics.

Cisco IOS Interface and Hardware Component Command Reference

IR-746
 Interface and Hardware Component Commands
smt-queue-threshold

smt-queue-threshold
To set the maximum number of unprocessed FDDI station management (SMT) frames that will be held
for processing, use the smt-queue-threshold command in global configuration mode. To restore the
queue to the default, use the no form of this command.

smt-queue-threshold number

no smt-queue-threshold

Syntax Description number Number of buffers used to store unprocessed SMT messages that are to be queued for
processing. Acceptable values are positive integers. The default value is equal to the
number of FDDI interfaces installed in the router.

Defaults The default threshold value is equal to the number of FDDI interfaces installed in the router.

Command Modes Global configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines This command helps ensure that routers keep track of FDDI upstream and downstream neighbors,
particularly when a router includes more than one FDDI interface.
In FDDI, upstream and downstream neighbors are determined by transmitting and receiving SMT
Neighbor Information Frames (NIFs). The router can appear to lose track of neighbors when it receives
an SMT frame and the queue currently contains an unprocessed frame. This occurs because the router
discards incoming SMT frames if the queue is full. Discarding SMT NIF frames can cause the router to
lose its upstream or downstream neighbor.

Caution Use this command carefully because the SMT buffer is charged to the inbound interface (input hold
queue) until the frame is completely processed by the system. Setting this value to a high limit can
impact buffer usage and the ability of the router to receive routable packets or routing updates.

Examples The following example specifies that the SMT queue can hold ten messages. As SMT frames are
processed by the system, the queue is decreased by one:
Router(config)# smt-queue-threshold 10

Cisco IOS Interface and Hardware Component Command Reference

IR-747
 Interface and Hardware Component Commands
snmp ifindex clear

snmp ifindex clear

To clear any previously configured SNMP ifIndex commands issued in interface configuration mode for
a specific interface, use the snmp ifindex clear command in interface configuration mode.

snmp ifindex clear

Syntax Description This command has no arguments or keywords.

Defaults The SNMP index is not cleared.

Command Modes Interface configuration

Command History Release Modification

12.0(11)S This command was introduced.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.

Usage Guidelines Interface Index Persistence means that ifIndex values in the IF-MIB persist across reboots, allowing for
consistent identification of specific interfaces using Simple Network Management Protocol (SNMP).
Use the snmp ifindex clear command on a specific interface when you want that interface to use the
global configuration setting for ifIndex persistence. This command clears any ifIndex configuration
commands previously entered for that specific interface.
This command does not have a no form.

Examples In the following example, ifIndex persistence is enabled for all interfaces:
Router(config)# snmp-server ifindex persist

IfIndex persistence is then disabled for Ethernet interface 0/1 only:

Router(config)# interface ethernet 0/1
Router(config-if)# no snmp ifindex persist
Router(config-if)# exit

Later, the ifIndex configuration command is cleared from the configuration for Ethernet interface 0/1:
Router(config)# interface ethernet 0/1
Router(config-if)# snmp ifindex clear
Router(config-if)# exit

This leaves ifIndex persistence enabled for all interfaces, as specified by the snmp-server ifindex
persist global configuration command.

Cisco IOS Interface and Hardware Component Command Reference

IR-748
 Interface and Hardware Component Commands
snmp ifindex clear

Related Commands Command Description

snmp ifindex persist Enables ifIndex values in the Interfaces MIB (IF-MIB) that
persist across reboots (ifIndex persistence) only on a specific
interface.
snmp-server ifindex persist Enables ifIndex values that will remain constant across reboots
for use by SNMP.

Cisco IOS Interface and Hardware Component Command Reference

IR-749
 Interface and Hardware Component Commands
snmp ifindex persist

snmp ifindex persist

To enable ifIndex values in the Interfaces MIB (IF-MIB) that persist across reboots (ifIndex persistence)
on a specific interface only, use the snmp ifindex persist command in interface configuration mode. To
disable ifIndex persistence on a specific interface only, use the no form of this command.

snmp ifindex persist

no snmp ifindex persist

Syntax Description This command has no arguments or keywords.

Defaults This command is disabled.

Command Modes Interface configuration

Command History Release Modification

12.0(11)S This command was introduced.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.

Usage Guidelines Interface Index Persistence means that ifIndex values in the IF-MIB persist across reboots, allowing for
consistent identification of specific interfaces using Simple Network Management Protocol (SNMP).
The snmp ifindex persistence interface configuration command enables and disables ifIndex
persistence for individual entries (corresponding to individual interfaces) in the ifIndex table of the
IF-MIB.
The snmp-server ifindex persistence global configuration command enables and disables ifIndex
persistence for all interfaces on the routing device (this applies only to interfaces that have ifDescr and
ifIndex entries in the ifIndex table of the IF-MIB).
IfIndex commands configured for an interface apply to all subinterfaces on that interface.

Examples In the following example, ifIndex persistence is enabled for Ethernet interface 0/1 only:
Router(config)# interface ethernet 0/1
Router(config-if)# snmp ifindex persist
Router(config-if)# exit

In the following example, ifIndex persistence is enabled for all interfaces and then disabled for interface
Ethernet interface 0/1 only:
Router(config)# snmp-server ifindex persist
Router(config)# interface ethernet 0/1
Router(config-if)# no snmp ifindex persist
Router(config-if)# exit

Cisco IOS Interface and Hardware Component Command Reference

IR-750
 Interface and Hardware Component Commands
snmp ifindex persist

Related Commands Command Description

snmp ifindex clear Clears any previously configured snmp ifIndex commands issued
in interface configuration mode for a specific interface.
snmp-server ifindex persist Enables ifIndex values that will remain constant across reboots
for use by SNMP.

Cisco IOS Interface and Hardware Component Command Reference

IR-751
 Interface and Hardware Component Commands
snmp trap illegal-address

snmp trap illegal-address

To issue a Simple Network Management Protocol (SNMP) trap when a MAC address violation is
detected on an Ethernet hub port of a Cisco 2505, Cisco 2507, or Cisco 2516 router, use the snmp trap
illegal-address command in hub configuration mode. To disable this function, use the no form of this
command.

snmp trap illegal-address

no snmp trap illegal-address

Syntax Description This command has no arguments or keywords.

Defaults No SNMP trap is issued.

Command Modes Hub configuration

Command History Release Modification

11.1 This command was introduced.

Usage Guidelines In addition to setting the snmp trap illegal-address command on the Ethernet hub, you can set the
frequency that the trap is sent to the network management station (NMS). This is done on the NMS via
the Cisco Repeater MIB. The frequency of the trap can be configured for once only or at a decaying rate
(the default). If the decaying rate is used, the first trap is sent immediately, the second trap is sent after
one minute, the third trap is sent after two minutes, and so on until 32 minutes, at which time the trap is
sent every 32 minutes. If you use a decaying rate, you can also set the trap acknowledgment so that the
trap will be acknowledged after it is received and will no longer be sent to the network management
station.
Because traps are not reliable, additional information on a port basis is provided by the Cisco Repeater
MIB. The network management function can query the following information: the last illegal MAC
source address, the illegal address trap acknowledgment, the illegal address trap enabled, the illegal
address first heard (timestamp), the illegal address last heard (timestamp), the last illegal address trap
count for the port, and the illegal address trap total count for the port.
In addition to issuing a trap when a MAC address violation is detected, the port is also disabled as long
as the MAC address is invalid. The port is enabled and the trap is no longer sent when the MAC address
is valid (that is, either the address was configured correctly or learned).

Examples The following example enables an SNMP trap to be issued when a MAC address violation is detected on
hub ports 2, 3, or 4. SNMP support must already be configured on the router.
Router(config)# hub ethernet 0 2 4
Router(config-hub)# snmp trap illegal-address

Cisco IOS Interface and Hardware Component Command Reference

IR-752
 Interface and Hardware Component Commands
snmp trap illegal-address

Related Commands Command Description

hub Enables and configures a port on an Ethernet hub of a Cisco 2505 or
Cisco 2507 router.

Cisco IOS Interface and Hardware Component Command Reference

IR-753
 Interface and Hardware Component Commands
snmp-server ifindex persist

snmp-server ifindex persist

To globally enable ifIndex values that will remain constant across reboots for use by Simple Network
Management Protocol (SNMP), use the snmp-server ifindex persist command in global configuration
mode. To globally disable ifIndex persistence, use the no form of this command.

snmp-server ifindex persist

no snmp-server ifindex persist

Syntax Description This command has no arguments or keywords.

Defaults This command is disabled.

Command Modes Global configuration

Command History Release Modification

12.0(11)S This command was introduced.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.

Usage Guidelines Interface Index Persistence means that ifIndex values in the IF-MIB persist across reboots, allowing for
consistent identification of specific interfaces using SNMP.
The snmp-server ifindex persist global configuration command will not override interface-specific
configuration. Interface-specific configuration of ifIndex persistence is performed with the [no] snmp
ifindex persist and snmp ifindex clear interface configuration commands.
The [no] snmp-server ifindex persist global configuration command enables and disables ifIndex
persistence for all interfaces on the routing device using ifDescr and ifIndex entries in the ifIndex table
of the IF-MIB.

Examples In the following example, ifIndex persistence is enabled for all interfaces:
Router(config)# snmp-server ifindex persist

Note that in this example if ifIndex persistence was previously disabled for a specific interface using the
no snmp ifindex persist interface configuration command, ifIndex persistence will remain disabled for
that interface. The global ifIndex command does not override the interface-specific commands.

Cisco IOS Interface and Hardware Component Command Reference

IR-754
 Interface and Hardware Component Commands
snmp-server ifindex persist

Related Commands Command Description

snmp ifindex clear Clears any previously configured snmp ifIndex commands issued
in interface configuration mode for a specific interface.
snmp ifindex persist Enables ifIndex values in the Interfaces MIB (IF-MIB) that
persist across reboots (ifIndex persistence) only on a specific
interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-755
 Interface and Hardware Component Commands
snr margin

snr margin
To set the signal-to-noise ratio (SNR) on the controller to improve the line stability, use the snr margin
command in controller configuration mode. To reset the SNR to default settings, use the no form of this
command.

snr margin {current [snr-value | disable] | snext [snr-value | disable]}

no snr margin {current | snext}

Syntax Description current Sets the current signal-to-noise ratio on the controller. To disable the current
SNR, set current to disable.
snext Sets the Self Near End Cross Talk (SNEXT) signal-to-noise ratio. To
disable the SNEXT, set snext to disable.
snr-value (Optional) Value, in decibels (dB), for the signal-to-noise ratio on the
controller or the SNEXT. Range is from –10 to 10 . The default value is 0.
disable (Optional) Disables the snr margin command.

Defaults The default value for both current and snext is 0.

Command Modes Controller configuration

Command History Release Modification

12.3(4)XD This command was introduced on the Cisco 2600 series, Cisco 3600 series,
and Cisco 3700 series routers.
12.3(4)XG This command was integrated into Cisco IOS Release 12.3(4)XG on the
Cisco 1700 series routers.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T on
Cisco 2600 series, Cisco 3631, and Cisco 3700 series routers.
12.3(11)T This command was integrated into Cisco IOS Release 12.3(11)T on
Cisco 2800 series and Cisco 3800 series routers.

Usage Guidelines The snr margin current command can create a more stable line by making the line train more than the
current noise margin plus signal-to-noise ratio threshold during training time. If any external noise is
applied that is less than the set SNR margin, the line will be stable.
The snr margin snext command can create a more stable line by making the line train more than the
Self Near End Cross Talk (SNEXT) threshold during training time. If any external noise is applied that
is less than the set SNEXT margin, the line will be stable.

Cisco IOS Interface and Hardware Component Command Reference

IR-756
 Interface and Hardware Component Commands
snr margin

Examples SNR with SNEXT Disabled

The following example configures the signal-to-noise ratio to 5 dB on the DSL controller in slot 3 and
port 0 and disables the SNEXT signal-to-ratio.
Router(config)# controller dsl 3/0
Router(config-controller)# snr margin current 5

Router(config)# controller dsl 3/0

Router(config-controller)# snr margin snext disable

SNR Margin set on CPE Router

The following example shows the snr margin snext 5 command issued on the customer premises
equipment (CPE) router.
Router_CPE(config)# controller dsl 1/0
Router_CPE(config-controller)# snr margin snext 5
Router_CPE(config-controller)#
*Jun 15 18:29:38.511: %CONTROLLER-5-UPDOWN: Controller DSL 1/0, changed state tn
*Jun 15 18:29:40.511: %LINK-3-UPDOWN: Interface ATM1/0, changed state to down
*Jun 15 18:29:41.511: %LINEPROTO-5-UPDOWN: Line protocol on Interface ATM1/0, cn
*Jun 15 18:30:04.579: DSL 1/0 controller Link up! line rate: 4608 Kbps

*Jun 15 18:30:04.579: %CONTROLLER-5-UPDOWN: Controller DSL 1/0, changed state tp

*Jun 15 18:30:12.351: %LINK-3-UPDOWN: Interface ATM1/0, changed state to up
*Jun 15 18:30:13.351: %LINEPROTO-5-UPDOWN: Line protocol on Interface ATM1/0, cp

Status on CO Side with SNR Margin set on CPE Router

The following example is the resulting output on the router that is configured as the central office (CO)
side after the snr margin snext 5 command is entered on the CPE side.
Router_CO#
Jun 15 18:29:42.781: %CONTROLLER-5-UPDOWN: Controller DSL 0/0, changed state ton
Jun 15 18:29:44.784: %LINK-3-UPDOWN: Interface ATM0/0, changed state to down
Jun 15 18:29:45.786: %LINEPROTO-5-UPDOWN: Line protocol on Interface ATM0/0, chn
Jun 15 18:30:03.122: DSL 0/0 controller Link up! line rate: 4608 Kbps

Jun 15 18:30:03.122: %CONTROLLER-5-UPDOWN: Controller DSL 0/0, changed state top

Jun 15 18:30:11.456: %LINK-3-UPDOWN: Interface ATM0/0, changed state to up
Jun 15 18:30:12.458: %LINEPROTO-5-UPDOWN: Line protocol on Interface ATM0/0, chp

Cisco IOS Interface and Hardware Component Command Reference

IR-757
 Interface and Hardware Component Commands
source-address

source-address
To configure source address control on a port on an Ethernet hub of a Cisco 2505 or Cisco 2507 router,
use the source-address command in hub configuration mode. To remove a previously defined source
address, use the no form of this command.

source-address [mac-address]

no source-address

Syntax Description mac-address (Optional) MAC address in the packets that the hub will allow to access the
network.

Defaults Source address control is disabled.

Command Modes Hub configuration

Command History Release Modification

10.3 This command was introduced.

Usage Guidelines If you omit the MAC address, the hub uses the value in the last source address register, and if the address
register is invalid, it will remember the first MAC address it receives on the previously specified port and
allow only packets from that MAC address onto that port.

Examples The following example configures the hub to allow only packets from MAC address 1111.2222.3333 on
port 2 of hub 0:
Router(config)# hub ethernet 0 2
Router(config-hub)# source-address 1111.2222.3333

The following example configures the hub to use the value of the last source address register. If the
address register is invalid, it will remember the first MAC address it receives on port 2 and allow only
packets from the learned MAC address on port 2:
Router(config)# hub ethernet 0 2
Router(config-hub)# source-address

Related Commands Command Description

hub Enables and configures a port on an Ethernet hub of a Cisco 2505 or
Cisco 2507 router.

Cisco IOS Interface and Hardware Component Command Reference

IR-758
 Interface and Hardware Component Commands
speed

speed
To configure the speed for a Fast Ethernet interface, use the speed command in interface configuration
mode. To disable a speed setting, use the no form of this command.

speed {10 | 100 | auto}

no speed

Syntax Description 10 Configures the interface to transmit at 10 Mbps.

100 Configures the interface to transmit at 100 Mbps. This is the default.
auto Turns on the Fast Ethernet autonegotiation capability. The interface automatically
operates at 10 or 100 Mbps depending on environmental factors, such as the type of
media and transmission speeds for the peer routers, hubs, and switches used in the
network configuration.

Defaults 100 Mbps

Command Modes Interface configuration

Command History Release Modification

11.2(10)P This command was introduced.

Usage Guidelines The autonegotiation capability is turned on for the Fast Ethernet interface by either configuring the
speed auto interface configuration command or the duplex auto interface configuration command.
Table 103 describes the performance of the system for different combinations of the duplex and speed
modes. The specified duplex command configured with the specified speed command produces the
resulting system action.

Table 103 Relationship Between duplex and speed Commands

duplex Command speed Command Resulting System Action

duplex auto speed auto Autonegotiates both speed and
duplex modes.
duplex auto speed 100 or speed 10 Autonegotiates both speed and
duplex modes.
duplex half or duplex full speed auto Autonegotiates both speed and
duplex modes.
duplex half speed 10 Forces 10 Mbps and half duplex.
duplex full speed 10 Forces 10 Mbps and full duplex.

Cisco IOS Interface and Hardware Component Command Reference

IR-759
 Interface and Hardware Component Commands
speed

Table 103 Relationship Between duplex and speed Commands (continued)

duplex Command speed Command Resulting System Action

duplex half speed 100 Forces 100 Mbps and half duplex.
duplex full speed 100 Forces 100 Mbps and full duplex.

Examples The following example shows how to configure a speed of 10 Mbps for Fast Ethernet interface 0:
Router(config)# interface fastethernet 0
Router(config-if)# speed 10

Related Commands Command Description

duplex Configures the duplex operation on an interface.
interface fastethernet Selects a particular Fast Ethernet interface for configuration.
show controllers Displays information about initialization block information, transmit
fastethernet ring, receive ring, and errors for the Fast Ethernet controller chip on
the Cisco 4700, Cisco 7200 series, or Cisco 7500 series routers.
show interfaces fastethernet Displays information about the Fast Ethernet interfaces.

Cisco IOS Interface and Hardware Component Command Reference

IR-760
 Interface and Hardware Component Commands
squelch

squelch
To extend the Ethernet twisted-pair 10BASE-T capability beyond the standard 100 meters on the
Cisco 4000 platform, use the squelch command in interface configuration mode. To restore the default,
use the no form of this command.

squelch {normal | reduced}

no squelch

Syntax Description normal Allows normal capability. This is the default.

reduced Allows extended 10BASE-T capability.

Defaults Normal range

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Examples The following example extends the twisted-pair 10BASE-T capability on the cable attached to Ethernet
interface 2:
Router(config)# interface ethernet 2
Router(config-if)# squelch reduced

Cisco IOS Interface and Hardware Component Command Reference

IR-761
 Interface and Hardware Component Commands
srp buffer-size

srp buffer-size
To make adjustments to buffer settings on the receive side for different priority traffic, use the
srp buffer-size command in interface configuration mode. To disable buffer size configurations, use the
no form of this command.

srp buffer-size receive [low buffer | medium buffer | high buffer]

no srp buffer-size receive [low buffer | medium buffer | high buffer]

Syntax Description receive Allocates SDRAM buffer for incoming packets.

low buffer (Optional) Specifies buffer size, in kilobytes, for low-priority
packets. Any number from 16 to 8192. The default is 8192.
medium buffer (Optional) Specifies buffer size, in kilobytes, for medium-priority
packets. Any number from 16 to 8192. The default is 4096.
high buffer (Optional) Specifies buffer size, in kilobytes, for high-priority
packets. Any number from 16 to 8192. The default is 4096.

Defaults low = 8192 kilobytes, medium = 4096 kilobytes, high = 4096 kilobytes

Command Modes Interface configuration

Command History Release Modification

12.0(6)S This command was introduced.
12.0(7)XE1 This command was implemented on Cisco 7500 series routers.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.

Examples The following example sets the buffer size for the receive side at the high setting of 17 kilobytes:
Router(config-if)# srp buffer-size receive high 17

Related Commands Command Description

mtu Adjusts the maximum packet size MTU size.
srp deficit-round-robin Transfers packets from the internal receive buffer to Cisco IOS
software.

Cisco IOS Interface and Hardware Component Command Reference

IR-762
 Interface and Hardware Component Commands
srp deficit-round-robin

srp deficit-round-robin
To transfer packets from the internal receive buffer to Cisco IOS software, use the srp
deficit-round-robin command in interface configuration mode. To disable the packet transfer, use the
no form of this command.

srp deficit-round-robin [input | output] [low | medium | high ] [quantum number | deficit
number]

no srp deficit-round-robin

Syntax Description input (Optional) Specifies input buffer.

output (Optional) Specifies output buffer.
low (Optional) Specifies low-priority queue level.
medium (Optional) Specifies medium-priority queue level.
high (Optional) Specifies high-priority queue level.
quantum number (Optional) Specifies the Deficit Round Robin (DRR) quantum value.
Any number from 9216 to 32767. The default is 9216.
deficit number (Optional) Specifies the DRR deficit value. Any number from 0 to
65535. The default is 16384.

Defaults quantum: 9216

deficit: 16384

Command Modes Interface configuration

Command History Release Modification

12.0(6)S This command was introduced.
12.0(7)XE1 This command was implemented on Cisco 7500 series routers.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.

Examples The following example shows how to configure packets for the medium-priority input queue:
Router(config)# srp deficit-round-robin input medium deficit 15000

Related Commands Command Description

srp buffer-size Makes adjustments to buffer settings on the receive side for different
priority traffic.
srp priority-map Sets priority mapping for transmitting and receiving packets.
srp random-detect Configures WRED parameters on packets received through an SRP
interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-763
 Interface and Hardware Component Commands
srp loopback

srp loopback
To loop the spatial reuse protocol (SRP) interface on an OC-12c DPTIP, use the srp loopback command
in interface configuration mode. To remove the loopback, use the no form of this command.

srp loopback {internal | line} {a | b}

no srp loopback

Syntax Description internal Sets the loopback toward the network before going through the framer
line Loops the payload data toward the network.
a Loops back the A side of the interface (inner tx, outer rx).
b Loops back the B side of the interface (outer tx, inner rx).

Defaults No loops are configured.

Command Modes Interface configuration

Command History Release Modification

12.0(6)S This command was introduced.
12.0(7)XE1 This command was introduced on Cisco 7500 series routers.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.

Usage Guidelines Use this command for troubleshooting purposes.

Examples The following example configures the loopback test on the A side of the SRP interface:
Router(config-if)# srp loopback line a

Cisco IOS Interface and Hardware Component Command Reference

IR-764
 Interface and Hardware Component Commands
srp priority-map

srp priority-map
To set priority mapping for transmitting and receiving packets, use the srp priority-map command in
interface configuration mode. To disable priority mapping use the no form of this command.

srp priority-map {receive {low priority | medium priority | high priority | {transmit {medium
priority | high priority}}

no srp priority-map

Syntax Description receive Specifies priority mapping for receiving packets.

transmit Specifies priority mapping for transmitting packets.
low priority (Optional) Specifies mapping for low-priority packets. Any number
from 1 to 8. The default is 1.
medium buffer (Optional) Specifies mapping for medium-priority packets. Any
number from 1 to 8. The default is 3.
high buffer (Optional) Specifies mapping for high-priority packets. Any number
from 1 to 8. The default is 5 for receiving packets, and default is 7 for
transmitting packets.

Defaults receive low: 1

receive medium: 3
receive high: 5
transmit high: 7

Command Modes Interface configuration

Command History Release Modification

12.0(6)S This command was introduced.
12.0(7)XE1 This command was implemented on Cisco 7500 series routers.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.

Usage Guidelines The spatial reuse protocol (SRP) interface provides commands to enforce quality of service (QoS)
functionality on the transmit side and receive side of Cisco routers. SRP uses the IP type of service (ToS)
field values to determine packet priority.
The SRP interface classifies traffic on the transmit side into high- and low-priority traffic. High-priority
traffic is rate shaped and has higher priority than low-priority traffic. You have the option to configure
high- or low-priority traffic and can rate limit the high-priority traffic.
The srp priority-map transmit command enables the user to specify IP packets with values equal to or
greater than the ToS value to be considered as high-priority traffic.

Cisco IOS Interface and Hardware Component Command Reference

IR-765
 Interface and Hardware Component Commands
srp priority-map

On the receive side, when WRED is enabled, SRP hardware classifies packets into high-, medium-, and
low-priority packets on the basis of the IP ToS value. After classification, it stores the packet into the
internal receive buffer. The receive buffer is partitioned for each priority packet. Cisco routers can
employ WRED on the basis of the IP ToS value. Routers also employ the Deficit Round Robin (DRR)
algorithm to transfer packets from the internal receive buffer to Cisco IOS software.
The srp priority-map receive command enables the user to classify packets as high, medium, or low
based on the IP ToS value.

Examples The following example configures Cisco 7500 series routers to transmit packets with priority greater
than 5 as high-priority packets:
Router(config-if)# srp priority-map transmit high 6

Related Commands Command Description

srp random-detect Configures WRED parameters on packets received through an SRP
interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-766
 Interface and Hardware Component Commands
srp random-detect

srp random-detect
To configure weighted RED (WRED) parameters on packets received through an spatial reuse
protocol (SRP) interface, use the srp random-detect command in interface configuration mode. To
return the value to the default, use the no form of this command.

srp random-detect {compute-interval interval | enable | input [low | medium | high] |

[exponential-weight weight | precedence precedence]}

no srp random-detect

Syntax Description compute-interval Specifies the queue depth compute interval, in nanoseconds. Number
compute-interval in the range from 1 to 128. Default is 128.
enable Enables WRED.
input Specifies WRED on packet input path.
low (Optional) Specifies low-priority queue level.
medium (Optional) Specifies medium-priority queue level.
high (Optional) Specifies high-priority queue level.
exponential-weight weight (Optional) Specifies the queue weight, in bits. Number in the range
from 0 to 6. The default is 6.
precedence number (Optional) Specifies the input queue precedence. Number in the
range from 0 to 7. The default is 7.

Defaults compute-interval: 128

weight: 6
precedence: 7

Command Modes Interface configuration

Command History Release Modification

12.0(6)S This command was introduced.
12.0(7)XE1 This command was implemented on Cisco 7500 series routers.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.

Examples The following example configures WRED parameters on packets received through an SRP interface with
a weight factor of 5:
Router(config-if)# srp random-detect input high exponential-weight 5

Cisco IOS Interface and Hardware Component Command Reference

IR-767
 Interface and Hardware Component Commands
srp shutdown

srp shutdown
To disable the spatial reuse protocol (SRP) interface, use the srp shutdown command in interface
configuration mode. To restart a disabled interface, use the no form of this command.

srp shutdown [a | b]

no srp shutdown [a | b]

Syntax Description a (Optional) Specifies side A of the SRP interface.

b (Optional) Specifies side B of the SRP interface.

Defaults The SRP interface continues to be enabled until this command is issued.

Command Modes Interface configuration

Command History Release Modification

12.0(6)S This command was introduced.
12.0(7)XE1 This command was introduced on Cisco 7500 series routers.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.

Usage Guidelines The srp shutdown command disables all functions on the specified side.

Examples The following example turns off side A of the SRP interface:
Router(config-if)# srp shutdown a

Cisco IOS Interface and Hardware Component Command Reference

IR-768
 Interface and Hardware Component Commands
srp tx-traffic-rate

srp tx-traffic-rate
To limit the amount of high-priority traffic that the spatial reuse protocol (SRP) interface can handle, use
the srp tx-traffic-rate command in interface configuration mode. Use the no form of this command to
disable transmitted traffic rate.

srp tx-traffic-rate number

no srp tx-traffic-rate number

Syntax Description number Transmission speed, in kilobits per second. The range is from 1 to 65535.
Default is 10.

Defaults number: 10

Command Modes Interface configuration

Command History Release Modification

12.0(6)S This command was introduced.
12.0(7)XE1 This command was implemented on Cisco 7500 series routers.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.

Examples The following example configures SRP traffic to transmit at 1000 kilobits per second:
Router(config-if)# srp tx-traffic-rate 1000

Cisco IOS Interface and Hardware Component Command Reference

IR-769
 Interface and Hardware Component Commands
storm-control

storm-control
To enable broadcast, multicast, or unicast storm control on a port or to specify the action taken when a
storm occurs on a port, use the storm-control command in interface configuration mode. To disable
storm control for broadcast, multicast, or unicast traffic or to disable the specified storm-control action,
use the no form of this command.

storm-control {{broadcast | multicast | unicast} level level [lower-level] | action shutdown}

no storm-control {{broadcast | multicast | unicast} level | action shutdown}

Syntax Description broadcast Enables broadcast storm control on the port.

multicast Enables multicast storm control on the port.
unicast Enables unicast storm control on the port.
level level [lower-level] Defines the rising and falling suppression levels.
• level—Rising suppression level as a percent of total bandwidth,
up to two decimal places; valid values are from 0 to 100. When
the value specified for level is reached, the flooding of storm
packets is blocked.
• lower-level—(Optional) Falling suppression level as a percent of
total bandwidth, up to two decimal places; valid values are from
0 to 100. This value must be less than the rising suppression
value.
action Action taken when a storm occurs on a port. The default action is to
filter traffic.
shutdown Disables the port during a storm.

Defaults Broadcast, multicast, and unicast storm control is disabled.

The default action is to filter traffic.

Command Modes Interface configuration

Command History Release Modification

12.2(2)XT This command was introduced on Cisco 2600 series, Cisco 3600 series, and
Cisco 3700 series routers.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T to support
switchport creation on Cisco 2600 series, Cisco 3600 series, and Cisco 3700 series
routers.

Cisco IOS Interface and Hardware Component Command Reference

IR-770
 Interface and Hardware Component Commands
storm-control

Release Modification
12.2(15)ZJ The level keyword, the lower-level argument, and the action and shutdown
keywords were added to support the Ethernet switch network module on
Cisco 2600 series, Cisco 3600 series, and Cisco 3700 series routers.
12.3(4)T The level keyword, the lower-level argument, and the action and shutdown
keywords were integrated into Cisco IOS Release 12.3(4)T on the following
platforms: Cisco 2600 series, Cisco 3600 series, and Cisco 3700 series routers.

Usage Guidelines Use the storm-control command to enable or disable broadcast, multicast, or unicast storm control on
a port. After a port is disabled during a storm, use the no form of the shutdown interface configuration
command to enable the port.
The suppression levels are entered as a percentage of total bandwidth. A suppression value of
100 percent means that no limit is placed on the specified traffic type. This command is enabled only
when the rising suppression level is less than 100 percent. If no other storm-control configuration is
specified, the default action is to filter the traffic that is causing the storm.
When a storm occurs and the action is to filter traffic, if the falling suppression level is not specified, the
networking device blocks all traffic until the traffic rate drops below the rising suppression level. If the
falling suppression level is specified, the networking device blocks traffic until the traffic rate drops
below this level.
When a multicast or unicast storm occurs and the action is to filter traffic, the networking device blocks
all traffic (broadcast, multicast, and unicast traffic) and sends only Spanning Tree Protocol (STP)
packets.
When a broadcast storm occurs and the action is to filter traffic, the networking device blocks only
broadcast traffic.

Examples The following example shows how to enable broadcast storm control on a port with a 75.67 percent rising
suppression level:
Router(config-if)# storm-control broadcast level 75.67

The following example shows how to enable multicast storm control on a port with an 87 percent rising
suppression level and a 65 percent falling suppression level:
Router(config-if)# storm-control multicast level 87 65

The following example shows how to enable the shutdown action on a port:
Router(config-if)# storm-control action shutdown

The following example shows how to disable the shutdown action on a port:
Router(config-if)# no storm-control action shutdown

Related Commands Command Description

show storm-control Displays the packet-storm control information.
shutdown (interface) Disables an interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-771
 Interface and Hardware Component Commands
switchport

switchport
To put an interface that is in Layer 3 mode into Layer 2 mode for Layer 2 configuration, use the
switchport command in interface configuration mode. To put an interface into Layer 3 mode, use the no
form of this command.

switchport

no switchport

Syntax Description This command has no arguments or keywords.

Defaults All interfaces are in Layer 2 mode.

Command Modes Interface configuration

Command History Release Modification

12.1(4)EA1 This command was introduced.
12.2(15)ZJ This command was implemented on Cisco 2600 series, Cisco 3600 series,
and Cisco 3700 series routers.
12.3(4)T This command was integrated into Cisco IOS Release 12.3(4)T on the
following platforms: Cisco 2600 series, Cisco 3600 series, and Cisco 3700
series routers.

Usage Guidelines Use the no switchport command to put the interface into the routed-interface status and to erase all
Layer 2 configurations. You must use this command before assigning an IP address to a routed port.
Entering the no switchport command shuts the port down and then reenables it, which might generate
messages on the device to which the port is connected.
You can verify the switchport status of an interface by entering the show running-config privileged
EXEC command.

Examples The following example shows how to cause an interface to cease operating as a Layer 2 port and become
a Cisco-routed (Layer 3) port:
Router(config-if)# no switchport

The following example shows how to cause an interface to cease operating as a Cisco-routed port and to
convert it into a Layer 2 switched interface:
Router(config-if)# switchport

Note The switchport command is not used on platforms that do not support Cisco-routed (Layer 3)
ports. All physical ports on such platforms are assumed to be Layer 2 switched interfaces.

Cisco IOS Interface and Hardware Component Command Reference

IR-772
 Interface and Hardware Component Commands
switchport

Related Commands Command Description

show interfaces switchport Displays the administrative and operational status of a switching
(nonrouting) port, including port blocking and port protection settings.
show running-config Displays the current operating configuration.

Cisco IOS Interface and Hardware Component Command Reference

IR-773
 Interface and Hardware Component Commands
switchport mode

switchport mode
To set the interface type, use the switchport mode command in interface configuration mode. To reset
the mode to the appropriate default mode for the device, use the appropriate no form of this command.

Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers

switchport mode {access | trunk}

Catalyst Switches

switchport mode {access | trunk | dynamic {auto | desirable}}

no switchport mode

switchport mode private-vlan {host | promiscuous}

no switchport mode private-vlan

Syntax Description access Specifies a nontrunking, nontagged single VLAN Layer 2 interface.
trunk Specifies a trunking VLAN Layer 2 interface.
dynamic auto Specifies that the interface convert the link to a trunk link.
dynamic desirable Specifies that the interface actively attempt to convert the link to a trunk
link.
private-vlan host Specifies that the ports with a valid PVLAN association become active
host private VLAN ports.
private-vlan promiscuous Specifies that the ports with a valid PVLAN mapping become active
promiscuous ports.

Defaults Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers
The default is access mode.

Catalyst Switches
The default mode is dependent on the platform; it should be either dynamic auto for platforms that are
intended as wiring closets or dynamic desirable for platforms that are intended as backbone switches.
The default for PVLAN ports is that no mode is set.

Command Modes Interface configuration

Command History Release Modification

12.0(7)XE This command was introduced on the Catalyst 6000 family switches.
12.1(1)E This command was integrated on the Catalyst 6000 family switches
12.1(8a)EX The switchport mode private-vlan {host | promiscuous} syntax was added.

Cisco IOS Interface and Hardware Component Command Reference

IR-774
 Interface and Hardware Component Commands
switchport mode

Release Modification
12.2(2)XT Creation of switchports became available on Cisco 2600 series, Cisco 3600 series,
and Cisco 3700 series routers.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T for creation of
switchports on Cisco 2600 series, Cisco 3600 series, and Cisco 3700 series routers.

Usage Guidelines Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers
If you enter a forced mode, the interface does not negotiate the link to the neighboring interface. Ensure
that the interface ends match.
The no form of the command is not supported on the Cisco 2600 Series, Cisco 3600 Series, and
Cisco 3700 Series Routers.

Catalyst Switches
If you enter access mode, the interface goes into permanent nontrunking mode and negotiates to convert
the link into a nontrunk link even if the neighboring interface does not agree to the change.
If you enter trunk mode, the interface goes into permanent trunking mode and negotiates to convert the
link into a trunk link even if the neighboring interface does not agree to the change.
If you enter dynamic auto mode, the interface converts the link to a trunk link if the neighboring
interface is set to trunk mode or desirable mode.
If you enter dynamic desirable mode, the interface becomes a trunk interface if the neighboring
interface is set to trunk mode, desirable mode, or auto mode.
If you configure a port as a promiscuous or host PVLAN port and one of the following applies, the port
becomes inactive:
• The port does not have a valid PVLAN association or mapping configured.
• The port is a span destination.
Similarly, if a private port PVLAN association or mapping is deleted or if a private port is configured as
a span destination, it becomes inactive.

Examples Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers
The following example shows how to set the interface to access desirable mode:
Router(config-if)# switchport mode access
The following example shows how to set the interface to trunk mode:
Router(config-if)# switchport mode trunk

Catalyst Switches
The following example shows how to set the interface to dynamic desirable mode:
Router(config-if)# switchport mode dynamic desirable
The following example shows how to set a port to PVLAN host mode:
Router(config-if)# switchport mode private-vlan host
The following example shows how to set a port to PVLAN promiscuous mode:
Router(config-if)# switchport mode private-vlan promiscuous

Cisco IOS Interface and Hardware Component Command Reference

IR-775
 Interface and Hardware Component Commands
switchport mode

Related Commands Command Description

show interfaces switchport Displays administrative and operational status of a switching
(nonrouting) port.
show interfaces trunk
switchport Modifies the switching characteristics of the Layer 2-switched
interface.
switchport private-vlan Defines a PVLAN association for an isolated or community port.
host-association
switchport private-vlan Defines the PVLAN mapping for a promiscuous port.
mapping

Cisco IOS Interface and Hardware Component Command Reference

IR-776
 Interface and Hardware Component Commands
switchport trunk

switchport trunk
To set the trunk characteristics when the interface is in trunking mode, use the switchport trunk
commands in interface configuration mode. To reset all of the trunking characteristics back to the
original defaults, use the no form of this command.

Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers

switchport trunk {encapsulation dot1q | native vlan | allowed vlan}}

no switchport trunk {encapsulation dot1q | native vlan | allowed vlan}

Catalyst Switches

no switchport trunk {encapsulation isl | dot1q | negotiate} | {native vlan | allowed vlan |
pruning vlan}}

no switchport trunk {encapsulation {isl | dot1q | negotiate}}| {native vlan | allowed vlan |
pruning vlan}}

Syntax Description allowed vlan vlan-list Sets the list of allowed VLANs that transmit traffic from this interface in
tagged format when in trunking mode. See the “Usage Guidelines” section
for vlan-list formatting guidelines.
encapsulation dot1q Sets the trunk encapsulation format to 802.1Q.
encapsulation isl Sets the trunk encapsulation format to Inter-Switch Link (ISL).
encapsulation Specifies that if the Dynamic Inter-Switch Link (DISL) protocol and
negotiate Dynamic Packet Transport (DPT) negotiation do not resolve the
encapsulation format, ISL is the selected format.
native vlan vlan-id Sets the native VLAN for the trunk in 802.1Q trunking mode.
pruning vlan vlan-list Sets the list of VLANs that are enabled for VTP pruning when in trunking
mode. See the “Usage Guidelines” section for the vlan-list argument
formatting guidelines.

Defaults Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers
The default encapsulation type is dot1q.
The default access VLAN and trunk interface native VLAN is a default VLAN that corresponds to the
platform or interface hardware.
The default for all VLAN lists is to include all VLANs.

Catalyst Switches
The default encapsulation type is dependent on the platform or interface hardware itself.
The default access VLAN and trunk interface native VLAN is a default VLAN corresponding to the
platform or interface hardware.
The default for all VLAN lists is to include all VLANs.

Cisco IOS Interface and Hardware Component Command Reference

IR-777
 Interface and Hardware Component Commands
switchport trunk

Command Modes Interface configuration

Command History Release Modification

12.0(7)XE This command was introduced on the Catalyst 6000 family switch.
12.1(1)E switchport creation on Catalyst 6000 family switches was added.
12.2(2)XT This command was introduced to support switchport creation on Cisco 2600 series,
Cisco 3600 series, and Cisco 3700 series routers.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T to support
switchport creation on Cisco 2600 series, Cisco 3600 series, and Cisco 3700 series
routers.

Usage Guidelines 802.1Q trunks:

• When you connect Cisco switches through an 802.1Q trunk, make sure that the native VLAN for an
802.1Q trunk is the same on both ends of the trunk link. If the native VLAN on one end of the trunk
is different from the native VLAN on the other end, spanning-tree loops might result.
• Disabling spanning tree on the native VLAN of an 802.1Q trunk without disabling spanning tree on
every VLAN in the network can cause spanning-tree loops. Cisco recommends that you leave
spanning tree enabled on the native VLAN of an 802.1Q trunk. If this is not possible, disable
spanning tree on every VLAN in the network. Make sure that your network is free of physical loops
before disabling spanning tree.
• When you connect two Cisco switches through 802.1Q trunks, the switches exchange spanning-tree
BPDUs on each VLAN allowed on the trunks. The BPDUs on the native VLAN of the trunk are sent
untagged to the reserved IEEE 802.1d spanning-tree multicast MAC address (01-80-C2-00-00-00).
The BPDUs on all other VLANs on the trunk are sent tagged to the reserved Shared Spanning Tree
Protocol (SSTP) multicast MAC address (01-00-0c-cc-cc-cd).
• The 802.1Q switches that are not Cisco switches maintain only a single instance of spanning-tree
(the Mono Spanning Tree, or MST) that defines the spanning-tree topology for all VLANs. When
you connect a Cisco switch to a switch through an 802.1Q trunk without a Cisco switch, the MST
of the switch and the native VLAN spanning tree of the Cisco switch combine to form a single
spanning-tree topology known as the CST.
• Because Cisco switches transmit BPDUs to the SSTP multicast MAC address on VLANs other than
the native VLAN of the trunk, switches that are not Cisco switches do not recognize these frames as
BPDUs and flood them on all ports in the corresponding VLAN. Other Cisco switches connected to
the 802.1Q cloud receive these flooded BPDUs. This allows Cisco switches to maintain a per-VLAN
spanning-tree topology across a cloud of 802.1Q switches that are not Cisco switches. The 802.1Q
cloud of switches separating the Cisco switches is treated as a single broadcast segment among all
switches connected to the 802.1Q cloud of switches that are not Cisco switches through 802.1Q
trunks.
• Make certain that the native VLAN is the same on all of the 802.1Q trunks that connects the Cisco
switches to the 802.1Q cloud of switches that are not Cisco switches.
• If you are connecting multiple Cisco switches to a non-Cisco 802.1Q cloud, all of the connections
must be through 802.1Q trunks. You cannot connect Cisco switches to a non-Cisco 802.1Q cloud
through ISL trunks or through access ports. Doing so will cause the switch to place the ISL trunk
port or access port into the spanning-tree “port inconsistent” state and no traffic will pass through
the port.

Cisco IOS Interface and Hardware Component Command Reference

IR-778
 Interface and Hardware Component Commands
switchport trunk

no switchport trunk native vlan Form of the Command

The no form of the no switchport trunk native vlan command resets the native mode VLAN to the
appropriate default VLAN for the device.

no switchport trunk allowed vlan Form of the Command

The no form of the no switchport trunk allowed vlan command resets the list to the default list, which
allows all VLANs.

Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers
The switchport trunk encapsulation command is supported only for platforms and interface hardware
that can support 802.1Q formats.
The vlan-list format is all | none | add | remove | except vlan-list[,vlan-list...] where:
• all—Specifies all VLANs from 1 to 1005.
• none—Indicates an empty list. This keyword is not supported in the switchport trunk allowed vlan
form of the command.
• add—Adds the defined list of VLANs to those currently set instead of replacing the list.
• remove—Removes the defined list of VLANs from those currently set instead of replacing the list.
• except—Lists the VLANs that should be calculated by inverting the defined list of VLANs.
• vlan-list—is either a single VLAN number from 1 to 1005 or a continuous range of VLANs
described by two VLAN numbers, the lesser one first, separated by a hyphen that represents the
VLAN IDs of the allowed VLANs when this port is in trunking mode.

Catalyst Switches
The switchport trunk encapsulation command is supported only for platforms and interface hardware
that can support both ISL and 802.1Q formats.
If you enter the negotiate keyword and DISL and DTP negotiation do not resolve the encapsulation
format, ISL is the selected format. The no form of the command resets the trunk encapsulation format
back to the default.
The no form of the switchport trunk {encapsulation {isl | dot1q | negotiate} pruning vlan command
resets the list to the default list, which enables all VLANs for VTP pruning.
The vlan-list format is all | none | add | remove | except vlan-list[,vlan-list...] where:
• all—Specifies all VLANs from 1 to 1005. This keyword is not supported in the switchport trunk
pruning vlan command.
• none—Indicates an empty list. This keyword is not supported in the switchport trunk allowed vlan
command.
• add—Adds the defined list of VLANs to those currently set, instead of replacing the list.
• remove—Removes the defined list of VLANs from those currently set instead of replacing the list.
• except—Lists the VLANs that should be calculated by inverting the defined list of VLANs.
• vlan-list—Is either a single VLAN number from 1 to 1005 or a continuous range of VLANs
described by two VLAN numbers, the lesser one first, separated by a hyphen that represents the
VLAN IDs of the allowed VLANs when this port is in trunking mode.

Examples The following example shows how to cause a port interface configured as a switched interface to
encapsulate in 802.1Q trunking format regardless of its default trunking format in trunking mode:

Cisco IOS Interface and Hardware Component Command Reference

IR-779
 Interface and Hardware Component Commands
switchport trunk

Router(config-if)# switchport trunk encapsulation dot1q

Related Commands Command Description

show interfaces switchport Displays administrative and operational status of a switching
(nonrouting) port.

Cisco IOS Interface and Hardware Component Command Reference

IR-780
 Interface and Hardware Component Commands
switchport voice vlan

switchport voice vlan

To configure the voice VLAN on the port, use the switchport voice vlan command in interface
configuration mode. To return the setting to its default, use the no form of this command.

switchport voice vlan {vlan-id | dot1p | none | untagged}

no switchport voice vlan

Syntax Description vlan-id VLAN used for voice traffic. Valid IDs are from 1 to 1005 (IDs 1006 to 4096 are
not supported).
Do not enter leading zeros. The switch port is an 802.1Q trunk port.
dot1p The telephone uses priority tagging and uses VLAN 0. The switch port is an
802.1Q trunk port.
none The telephone is not instructed through the command- line interface (CLI) about
the voice VLAN. The telephone uses the configuration from the telephone keypad.
untagged The telephone does not tag frames; it uses VLAN 4095. The switch port can be an
access port or an 802.1Q trunk port.

Defaults The switch default is to not automatically configure the telephone (none).
The Cisco IP 7960 telephone default is to generate an 802.1Q/802.1P frame.

Command Modes Interface configuration

Command History Release Modification

12.2(2)XT This command was introduced.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T to support
creation of switchports.

Usage Guidelines Ports that are not configured as trunk ports but that have a configured voice VLAN are access ports with
a voice VLAN ID (VVID).

Examples The following example shows how to configure VLAN 2 as the voice VLAN:
Switch(config-if)# switchport voice vlan 2

Cisco IOS Interface and Hardware Component Command Reference

IR-781
 Interface and Hardware Component Commands
syscon address

syscon address
To specify the system controller for a managed shelf, use the syscon address command in global
configuration mode. To stop the management of the shelf by the system controller, use the no form of
this command.

syscon address ip-address password

no syscon address

Syntax Description ip-address IP address of the system controller.

password Password string.

Command Default No system controller is specified.

Command Modes Global configuration

Command History Release Modification

11.3AA This command was introduced.

Usage Guidelines This command is required in order for the shelf to be managed by the system controller.

Examples The following example configures a shelf to be managed by a system controller at 10.2.3.4 using the
password green:
Router# syscon address 10.2.3.4 green

Related Commands Command Description

show syscon sdp Displays information about the Shelf Discovery Protocol.
syscon source-interface Specifies the interface to use for the source address in SDP
packets.

Cisco IOS Interface and Hardware Component Command Reference

IR-782
 Interface and Hardware Component Commands
syscon shelf-id

syscon shelf-id
To specify a shelf ID for a managed shelf, use the syscon shelf-id command in global configuration
mode. To remove the shelf ID, use the no form of this command.

syscon shelf-id number

no syscon shelf-id

Syntax Description number Shelf ID. The value ranges from 0 to 9999.

Command Default No shelf ID is specified.

Command Modes Global configuration

Command History Release Modification

11.3AA This command was introduced.

Usage Guidelines Use this command to specify a shelf ID for a managed shelf. Some platforms, such as the Cisco AS5800,
use other commands to assign a shelf ID. In these situations, do not specify a shelf ID with the
syscon shelf-id command. Use the platform-specific command instead.

Examples The following example configures a shelf ID of 5 for the managed shelf:
Router# syscon shelf-id 5

Related Commands Command Description

show syscon sdp Displays information about the Shelf Discovery Protocol.
syscon address Specifies the system controller for a managed shelf.

Cisco IOS Interface and Hardware Component Command Reference

IR-783
 Interface and Hardware Component Commands
syscon source-interface

syscon source-interface
To specify the interface to use for the source address in Shelf Discovery Protocol (SDP) packets, use the
syscon source-interface command in global configuration mode. To return to the default source
interface for a packet (the interface that sent the packet from the shelf), use the no form of this command.

syscon source-interface type number

no syscon source-interface

Syntax Description type number Type and number of the interface to use for the source IP address.

Command Default SDP packets use the IP address of the output interface.

Command Modes Global configuration

Command History Release Modification

11.3AA This command was introduced.

Usage Guidelines Use this command to ensure that all SDP packets sent by the managed shelf have the same source IP
address.

Examples The following example configures a shelf to use the IP address of Ethernet interface 99/1/0:
Router# syscon source-address Ethernet99/1/0

Related Commands Command Description

show syscon sdp Displays information about the Shelf Discovery Protocol.
syscon shelf-id Specifies a shelf ID for a managed shelf.

Cisco IOS Interface and Hardware Component Command Reference

IR-784
 Interface and Hardware Component Commands
t1

t1
To create a logical T1 controller from each of the specified time slots of the T3 line, use the t1 command
in controller configuration mode. To delete the defined logical controller, use the no form of this
command.

t1 ds1 controller

no t1 ds1 controller

Syntax Description ds1 Time slot within the T3 line. The valid time-slot range is from 1 to 28.

Defaults No default behavior or values.

Command Modes Controller configuration

Command History Release Modification

11.3AA This command was introduced.

Usage Guidelines The purpose of this command is to convert the collection of the 28 T1 controllers comprising the T3
controller into individual T1 controllers that the system can use. In other words, the Cisco AS5800
access server cannot pass data until a T1 controller is configured (using the controller command), and
you cannot configure a T1 controller until it has been created using the t1 command.

Examples The following example shows how to configure a logical T1 controller at T1 time slot 1 for the T3
controller located in shelf 1, slot 4, port 0. Note that you have to enter the command from controller
configuration mode.
Router(config)# controller t3 1/4/0
Router(config-controller)# t1 1 controller
Router(config-controller)# end

Related Commands Command Description

controller Configures a T1 and other types of controller and enters controller
configuration mode.
controller t3 Configures a T3 controller.

Cisco IOS Interface and Hardware Component Command Reference

IR-785
 Interface and Hardware Component Commands
t1 bert

t1 bert
To enable or disable a bit error rate tester (BERT) test pattern for a T1 channel on the Channelized T3
Interface Processor (CT3IP) in Cisco 7500 series routers, use the t1 bert command in controller
configuration mode. To disable a BERT test pattern, use the no form of this command.

t1 channel bert pattern {0s | 1s | 2^15 | 2^20 | 2^23} interval minutes

no t1 channel bert pattern {0s | 1s | 2^15 | 2^20 | 2^23} interval minutes

Syntax Description channel Number between 1 and 28 that indicates the T1 channel.
pattern Specifies the length of the repeating BERT test pattern.
0s 0s—Repeating pattern of zeros (...000...).
1s 1s—Repeating pattern of ones (...111...).
2^15 215—Pseudorandom repeating pattern that is 32,767 bits in length.
2^20 220—Pseudorandom repeating pattern that is 1,048,575 bits in length.
2^23 223—Pseudorandom repeating pattern that is 8,388,607 bits in length.
interval minutes Specifies the duration of the BERT test, in minutes. The interval can be a value
from 1 to 14400.

Defaults No BERT test is performed.

Command Modes Controller configuration

Command History Release Modification

11.3 This command was introduced.

Usage Guidelines The BERT test patterns from the CT3IP are framed test patterns (that is, the test patterns are inserted
into the payload of the framed T1 signal).
To view the BERT results, use the show controller t3 or show controller t3 brief EXEC commands.
The BERT results include the following information:
• Type of test pattern selected
• Status of the test
• Interval selected
• Time remaining on the BERT test
• Total bit errors
• Total bits received

Cisco IOS Interface and Hardware Component Command Reference

IR-786
 Interface and Hardware Component Commands
t1 bert

When the T1 channel has a BERT test running, the line state is DOWN. Also, when the BERT test is
running and the Status field is Not Sync, the information in the total bit errors field is not valid. When
the BERT test is done, the Status field is not relevant.
The t1 bert command is not written to NVRAM because it is only used for testing the T1 channel for a
short predefined interval and for avoiding accidentally saving the command, which could cause the
interface not to come up the next time the router reboots.

Note T1 channels on the CT3IP are numbered 1 to 28 rather than the more traditional zero-based scheme
(0 to 27) used with other Cisco products. This numbering scheme ensures consistency with telco
numbering schemes for T1 channels within channelized T3 equipment.

Examples The following example shows how to run a BERT test pattern of all zeros for 30 minutes on T1 channel
6 on the CT3IP in slot 9:
Router(config)# controller t3 9/0/0
Router(config-controller)# t1 6 bert pattern 0s interval 30

Related Commands Command Description

show controllers t3 Displays the hardware and software driver information for a T3 controller.

Cisco IOS Interface and Hardware Component Command Reference

IR-787
 Interface and Hardware Component Commands
t1 clock source

t1 clock source
To specify where the clock source is obtained for use by each T1 channel on the Channelized T3
Interface Processor (CT3IP) in Cisco 7500 series routers, use the t1 clock source command in controller
configuration mode.

t1 channel clock source {internal | line}

Syntax Description channel Number between 1 and 28 that indicates the T1 channel.
internal Specifies that the internal clock source is used. This is the default.
line Specifies that the network clock source is used.

Defaults Internal

Command Modes Controller configuration

Command History Release Modification

11.3 This command was introduced.

Usage Guidelines If you do not specify the t1 clock source command, the default clock source of internal is used by all
the T1s on the CT3IP.
You can also set the clock source for the CT3IP by using the clock source (CT3IP) controller
configuration command.

Note T1 channels on the CT3IP are numbered 1 to 28 rather than the more traditional zero-based scheme
(0 to 27) used with other Cisco products. This numbering scheme ensures consistency with telco
numbering schemes for T1 channels within channelized T3 equipment.

This command does not have a no form.

Examples The following example shows how to set the clock source to line T1 6 and T1 8 on the CT3IP:
Router(config)# controller t3 9/0/0
Router(config-controller)# t1 6 clock source line
Router(config-controller)# t1 8 clock source line

Related Commands Command Description

clock source (CT3IP) Specifies where the clock source is obtained for use by the CT3IP in
Cisco 7500 series routers.

Cisco IOS Interface and Hardware Component Command Reference

IR-788
 Interface and Hardware Component Commands
t1 external

t1 external
To specify that a T1 channel on the Channelized T3 Interface Processor (CT3IP) in Cisco 7500 series
routers is used as an external port so that the T1 channel can be further multiplexed on the Multichannel
Interface Processor (MIP) or other multiplexing equipment, use the t1 external command in controller
configuration mode. To remove a T1 as an external port, use the no form of this command.

t1 external channel [cablelength feet] [linecode [ami | b8zs]]

no t1 external channel

Syntax Description channel Number 1, 2, or 3 that indicates the T1 channel.

cablelength feet (Optional) Specifies the cable length, in feet, from the T1 channel to the
external CSU or MIP. Values are from 0 to 655. Default is 133.
linecode ami | b8zs (Optional) Specifies the line coding used by the T1. Values are alternate mark
inversion (AMI) or bipolar 8 zero suppression (B8ZS). Default is B8ZS.

Defaults No external T1 is specified.

The default cable length is 133 feet.
The default line coding is B8ZS.

Command Modes Controller configuration

Command History Release Modification

11.3 This command was introduced.

Usage Guidelines The first three T1 channels (1, 2, and 3) of the CT3IP can be broken out to the DSUP-15 connectors on
the CPT3IP so that the T1 channel can be further demultiplexed by the MIP on the same router or on
another router.
After you configure the external T1 channel, you can continue configuring it as a channelized T1 (also
referred to as a fractional T1) from the MIP. All channelized T1 commands might not be applicable to
the T1 interface. After you configure the channelized T1 on the MIP, you can continue configuring it as
you would a normal serial interface. All serial interface commands might not be applicable to the T1
interface.
The line coding on the T1 channel and the MIP must be the same. Because the default line coding format
on the T1 channel is B8ZS and the default line coding on the MIP is AMI, you must change the line
coding on the MIP or on the T1 so that they match.
To determine if the external device connected to the external T1 port is configured and cabled correctly
before configuring an external port, use the show controllers t3 command and locate the line Ext1...
in the display output. The line status can be one of the following:
• LOS—Loss of signal indicates that the port is not receiving a valid signal. This is the expected state
if nothing is connected to the port.

Cisco IOS Interface and Hardware Component Command Reference

IR-789
 Interface and Hardware Component Commands
t1 external

• AIS—Alarm indication signal indicates that the port is receiving an all-ones signal.
• OK—A valid signal is being received and the signal is not an all-ones signal.

Note T1 channels on the CT3IP are numbered 1 to 28 rather than the more traditional zero-based scheme
(0 to 27) used with other Cisco products. This numbering scheme ensures consistency with telco
numbering schemes for T1 channels within channelized T3 equipment.

Note Although you can specify a cable length from 0 to 655 feet, the hardware only recognizes the
following ranges: 0 to 133, 134 to 266, 267 to 399, 400 to 533, and 534 to 655. For example,
entering 150 feet uses the 134 to 266 range. If you later change the cable length to 200 feet, there
is no change because 200 is within the 134 to 266 range. However, if you change the cable length to
399, the 267 to 399 range is used. The actual number you enter is stored in the configuration file.

Examples The following example shows how to configure T1 1 on the CT3IP as an external port using AMI line
coding and a cable length of 300 feet:
Router(config)# controllers t3 9/0/0
Router(config-controller)# t1 external 1 cablelength 300 linecode ami

Related Commands Command Description

show controllers t3 Displays the hardware and software driver information for a T3 controller.

Cisco IOS Interface and Hardware Component Command Reference

IR-790
 Interface and Hardware Component Commands
t1 fdl ansi

t1 fdl ansi
To enable the 1-second transmission of the remote performance reports via the Facility Data Link (FDL)
per ANSI T1.403 for a T1 channel on the Channelized T3 Interface Processor (CT3IP) in Cisco 7500
series routers, use the t1 fdl ansi command in controller configuration mode. To disable the performance
report, use the no form of this command.

t1 channel fdl ansi

no t1 channel fdl ansi

Syntax Description channel Number between 1 and 28 that indicates the T1 channel.

Defaults Disabled

Command Modes Controller configuration

Command History Release Modification

11.3 This command was introduced.

Usage Guidelines The t1 fdl ansi command can be used only if the T1 framing type is Extended Super Frame (ESF).
To display the remote performance report information, use the show controllers t3 remote
performance command.

Note T1 channels on the CT3IP are numbered 1 to 28 rather than the more traditional zero-based scheme
(0 to 27) used with other Cisco products. This numbering scheme ensures consistency with telco
numbering schemes for T1 channels within channelized T3 equipment.

Examples The following example shows how to generate the performance reports for T1 channel 8 on the CT3IP:
Router(config)# controller t3 9/0/0
Router(config-controller)# t1 8 fdl ansi

Related Commands Command Description

show controllers t3 Displays the hardware and software driver information for a T3 controller.

Cisco IOS Interface and Hardware Component Command Reference

IR-791
 Interface and Hardware Component Commands
t1 framing

t1 framing
To specify the type of framing used by the T1 channels on the Channelized T3 Interface Processor
(CT3IP) in Cisco 7500 series routers, use the t1 framing command in controller configuration mode.

t1 channel framing {esf | sf}

Syntax Description channel Number between 1 and 28 that indicates the T1 channel.
esf Specifies that Extended Super Frame (ESF) is used as the T1 framing type.
This is the default.
sf Specifies that Super Frame (SF) is used as the T1 framing type.

Defaults Extended Super Frame (ESF)

Command Modes Controller configuration

Command History Release Modification

11.3 This command was introduced.

Usage Guidelines If you do not specify the t1 framing command, the default ESF is used.

Note T1 channels on the CT3IP are numbered 1 to 28 rather than the more traditional zero-based scheme
(0 to 27) used with other Cisco products. This numbering scheme ensures consistency with telco
numbering schemes for T1 channels within channelized T3 equipment.

This command does not have a no form.

Examples The following example shows how to set the framing for the T1 6 and T1 8 on the CT3IP to Super Frame:
Router(config)# controller t3 9/0/0
Router(config-controller)# t1 6 framing sf
Router(config-controller)# t1 8 framing sf

Cisco IOS Interface and Hardware Component Command Reference

IR-792
 Interface and Hardware Component Commands
t1 linecode

t1 linecode
To specify the type of line coding used by the T1 channels on the Channelized T3 Interface Processor
(CT3IP) in Cisco 7500 series routers, use the t1 linecode command in controller configuration mode.

t1 channel linecode [ami | b8zs]

Syntax Description channel Number between 1 and 28 that indicates the T1 channel.
ami Specifies that alternate mark inversion (AMI) line coding is used by the T1 channel.
b8zs Specifies that bipolar 8 zero suppression (B8ZS) line coding is used by the T1
channel. This is the default.

Defaults B8ZS

Command Modes Controller configuration

Command History Release Modification

11.3 This command was introduced.

Usage Guidelines If you do not specify the t1 linecode command, the default B8ZS is used.

AMI Line Coding

If you select ami line coding for the T1 channel, you must also invert the data on the T1 channel by using
the invert data interface command. This is required because the T1 channel is bundled into the T3
signal, so there are no local T1 line drivers and receivers associated with it. Therefore, the t1 channel
linecode ami command does not modify local line driver settings. Rather, it advises the CT3IP what line
code the remote T1 is using. The CT3IP uses this information solely for the purpose of determining
whether or not to enable the pulse density enforcer for that T1 channel.

B8ZS Line Coding

When you select b8zs line coding, the pulse density enforcer is disabled. When you select ami line
coding, the pulse density enforcer is enabled. To avoid having the pulse density enforcer corrupt data,
the T1 channel should be configured for inverted data.

Note T1 channels on the CT3IP are numbered 1 to 28 rather than the more traditional zero-based scheme
(0 to 27) used with other Cisco products. This numbering scheme ensures consistency with telco
numbering schemes for T1 channels within channelized T3 equipment.

Examples The following example shows how to set the line coding for T1 channel 16 on the CT3IP to AMI:
Router(config)# controller t3 9/0/0

Cisco IOS Interface and Hardware Component Command Reference

IR-793
 Interface and Hardware Component Commands
t1 linecode

Router(config-controller)# t1 16 linecode ami

Router(config-controller)# exit
Router(config)# interface serial 9/0/0:16
Router(config-if)# invert data

Related Commands Command Description

invert data Inverts the data stream.
loopback remote (interface) Loops packets through a CSU/DSU, over a DS3 link or a channelized
T1 link, to the remote CSU/DSU and back.

Cisco IOS Interface and Hardware Component Command Reference

IR-794
 Interface and Hardware Component Commands
t1 logging-events

t1 logging-events
To print typical T1 controller Up and Down messages on a channelized T3 port adapter in T3 controller,
use the t1 logging-events command configuration mode. To disable printing of the T1 controller Up and
Down messages, use the no form of this command.

t1 {t1} logging-events [detail]

[no] t1 {t1} logging-events

Syntax Description t1 Number between 1 and 28 that represents the T1 channel for the Channelized
T3 Interface Processor (CT3IP) on Cisco 7500 series and Cisco 7200 series
routers.
detail (Optional) Enables printing the reason code when a T1 controller of a T3
controller changes from the Up state to the Down state.

Defaults The t1 logging-events command is the default.

Command Modes T3 controller configuration mode.

Command History Release Modification

12.2(19c) This command was introduced.

Usage Guidelines This command refers to the T1 controller as part of a T3 controller.

The no t1 logging-events command disables printing of the controller Up and Down messages. These
messages will appear neither on the console nor in the logs.

Examples The following example uses the t1 logging-events command to print normal controller Up and Down
messages, without indicating the reason code for a changed state. The T1 1 controller is part of the T3
controller with a bay/port of 4/1.
Router(config-controller)# t1 1 logging-events

*Jun 20 00:29:39: %CONTROLLER-5-UPDOWN: Controller T3 4/1 T1 1, changed state to UP

*Jun 20 00:30:09: %CONTROLLER-5-UPDOWN: Controller T3 4/1 T1 1, changed state to DOWN

The following example uses the t1 logging-events detail command to show the Out-of-Frame (OOF)
reason code when the T1 1 controller of a T3 controller with a bay/port of 4/1 changes from an Up state
to a Down state:
Router(config-controller)# t1 1 logging-events detail

*Jun 19 17:47:50: %CONTROLLER-5-DOWNDETAIL: Controller T3 4/1 T1 1, changed state to down

due to OOF

Cisco IOS Interface and Hardware Component Command Reference

IR-795
 Interface and Hardware Component Commands
t1 logging-events

Related Commands Command Description

logging-events Prints typical T3 controller Up and Down messages on a channelized T3 port
adapter.

Cisco IOS Interface and Hardware Component Command Reference

IR-796
 Interface and Hardware Component Commands
t1 test

t1 test
To break out a T1 channel on the Channelized T3 Interface Processor (CT3IP) in Cisco 7500 series
routers to the test port for testing, use the t1 test command in controller configuration mode. To remove
the T1 channel from the test port, use the no form of this command.

t1 test channel [cablelength feet] [linecode [ami | b8zs]]

no t1 test channel

Syntax Description channel Number between 1 and 28 that indicates the T1 channel.
cablelength feet (Optional) Specifies the cable length, in feet, from the T1 channel to the
external CSU or Multi-Channel Interface Processor (MIP). Values are from
0 to 655. Default is 133.
linecode {ami | b8zs} (Optional) Specifies the line coding format used by the T1 channel. Values
are alternate mark inversion (AMI) or bipolar 8 zero suppression (B8ZS).
Default is B8ZS.

Defaults No test port is configured.

The default cable length is 133 feet.
The default line coding is B8ZS.

Command Modes Controller configuration

Command History Release Modification

11.3 This command was introduced.

Usage Guidelines You can use the T1 test port available on the CT3IP to break out any of the 28 T1 channels for testing
(for example, 24-hour bit error-rate tester (BERT )testing as is commonly done by telephone companies
before a line is brought into service).
The T1 test port is also available as an external port. For more information on configuring an external
port, see the t1 external controller configuration command.
To determine if the external device connected to the T1 test port is configured and cabled correctly before
configuring a test port, use the show controllers t3 command and locate the line Ext1... in the display
output. The line status can be one of the following:
• LOS—Loss of signal indicates that the port is not receiving a valid signal. This is the expected state
if nothing is connected to the port.
• AIS—Alarm indication signal indicates that the port is receiving an all-ones signal.
• OK—A valid signal is being received and the signal is not an all-ones signal.

Cisco IOS Interface and Hardware Component Command Reference

IR-797
 Interface and Hardware Component Commands
t1 test

Note T1 channels on the CT3IP are numbered 1 to 28 rather than the more traditional zero-based scheme
(0 to 27) used with other Cisco products. This numbering scheme ensures consistency with telco
numbering schemes for T1 channels within channelized T3 equipment.

Note Although you can specify a cable length from 0 to 655 feet, the hardware only recognizes the
following ranges: 0 to 133, 134 to 266, 267 to 399, 400 to 533, and 534 to 655. For example,
entering 150 feet uses the 134 to 266 range. If you later change the cable length to 200 feet, there is
no change because 200 is within the 134 to 266 range. However, if you change the cable length to
399, the 267 to 399 range is used. The actual number you enter is stored in the configuration file.

Examples The following example shows how to configure T1 6 on the CT3IP as a test port using the default cable
length and line coding:
Router(config)# controller t3 9/0/0
Router(config-controller)# t1 test 6

Related Commands Command Description

show controllers t3 Displays the hardware and software driver information for a T3 controller.
t1 external Specifies that a T1 channel on the CT3IP in Cisco 7500 series routers is used
as an external port so the T1 channel can be further multiplexed on the MIP
or other multiplexing equipment.

Cisco IOS Interface and Hardware Component Command Reference

IR-798
 Interface and Hardware Component Commands
t1 timeslot

t1 timeslot
To specify the time slots and data rate used on each T1 channel on the Channelized T3 Interface
Processor (CT3IP) in Cisco 7500 series routers, use the t1 timeslot command in controller configuration
mode. To remove the configured T1 channel, use the no form of this command.

t1 channel timeslot range [speed {56 | 64}]

no t1 channel timeslot

Syntax Description channel Number between 1 and 28 that indicates the T1 channel.
range Specifies the time slots assigned to the T1 channel. The range can be from
1 to 24. A dash represents a range of time slots, and a comma separates time
slots. For example, 1-10,15-18 assigns time slots 1 through 10 and 15
through 18.
speed {56 | 64} (Optional) Specifies the data rate for the T1 channel, in kbps. Values are
56 or 64. The default is 64. The 56-kbps speed is valid only for T1 channels
21 through 28.

Defaults No time slots are specified for the T1 channel.

The default data rate is 64 kbps.

Command Modes Controller configuration

Command History Release Modification

11.3 This command was introduced.

Usage Guidelines You must specify the time slots used by each T1 channel.

Note T1 channels on the CT3IP are numbered 1 to 28 rather than the more traditional zero-based scheme
(0 to 27) used with other Cisco products. This numbering scheme ensures consistency with telco
numbering schemes for T1 channels within channelized T3 equipment.

Examples The following example shows how to assign time slots 1 through 24 to T1 1 for full T1 bandwidth usage:
Router(config)# controller t3 9/0/0
Router(config-controller)# t1 1 timeslot 1-24

The following example shows how to assign time slots 21 to 23 and 26 to 28 and a data rate of 56 kbps
to T1 6 for fractional T1 bandwidth usage:
Router(config)# controller t3 9/0/0
Router(config-controller)# t1 6 timeslot 21-23,26-28 speed 56

Cisco IOS Interface and Hardware Component Command Reference

IR-799
 Interface and Hardware Component Commands
t1 yellow

t1 yellow
To enable detection and generation of yellow alarms for a T1 channel on the Channelized T3 Interface
Processor (CT3IP) in Cisco 7500 series routers, use the t1 yellow command in controller configuration
mode. To disable the detection and generation of yellow alarms, use the no form of this command.

t1 channel yellow {detection | generation}

no t1 channel yellow {detection | generation}

Syntax Description channel Number between 1 and 28 that indicates the T1 channel.
detection Detects yellow alarms. This is the default, along with generation.
generation Generates yellow alarms. This is the default, along with detection.

Defaults Yellow alarms are detected and generated on the T1 channel.

Command Modes Controller configuration

Command History Release Modification

11.3 This command was introduced.

Usage Guidelines If the T1 framing type is super frame (SF), you should consider disabling yellow alarm detection because
the yellow alarm can be incorrectly detected with SF framing.

Note T1 channels on the CT3IP are numbered 1 to 28 rather than the more traditional zero-based scheme
(0 to 27) used with other Cisco products. This numbering scheme ensures consistency with Telco
numbering schemes for T1 channels within channelized T3 equipment.

Examples The following example shows how to disable the yellow alarm detection on T1 channel 6 on the CT3IP:
Router(config)# controller t3 9/0/0
Router(config-controller)# t1 6 framing sf
Router(config-controller)# no t1 6 yellow detection

Cisco IOS Interface and Hardware Component Command Reference

IR-800
 Interface and Hardware Component Commands
test aim eeprom

test aim eeprom

To test the data compression Advanced Interface Module (AIM) after it is installed in the Cisco 2600
series router, use the test aim eeprom command in privileged EXEC mode.

test aim eeprom

Syntax Description This command has no arguments or keywords.

Defaults No tests are performed on the data compression AIM card.

Command Modes Privileged EXEC

Command History Release Modification

12.0(2)T This command was introduced.

Usage Guidelines This command does not have a no form.

Caution Using this command can erase all locations in EEPROM memory.

This command is the AIM counterpart of the test pas eeprom command, which performs similar tasks
for port modules.
Table 104 shows the questions asked of the user when the test aim eeprom command is entered, and the
recommended user responses.

Table 104 Questions and Responses for test aim eeprom Command

Questions Responses
AIM Slot [0]: User responds by entering the slot number of the
AIM whose EEPROM is to be modified. If the user
presses ENTER, the default slot 0 is used.
Use NMC93C46 ID EEPROM [y]: User responds with “y” if the AIM contains an
NMC93C46 type EEPROM and “n” if the AIM
contains an X2444 EEPROM. The compression
Advanced Interface Module (CAIM) contains a
NMC93C46 EEPROM, and this is the default if the
user just pressed ENTER.
AIM Slot %d eeprom (? for help)[%c] General command prompt for the test aim eeprom
command dialog. The AIM slot number chosen is
displayed, and the default command is the last
command entered.

Cisco IOS Interface and Hardware Component Command Reference

IR-801
 Interface and Hardware Component Commands
test aim eeprom

Table 104 Questions and Responses for test aim eeprom Command

Questions Responses
Address within slot %d eeprom, [0x%02x] Enter the desired address within the EEPROM to
modify. The default is the next address beyond the
byte last modified. If the user wishes to enter a
hexadecimal number, it must be preceded by “0x”.
Read or Write access to slot %d at 0x%02x Respond with a W to write to the addressed byte or
[%c]? with an R to read from the addressed byte. The
default value is selected by just pressing Enter and is
the same as the value specified in the last primitive
access.
Write data (hex 8 bits) [%02x]?: If you respond to prompt B with “W”, then prompt
C is issued, requesting the user to enter the data to
write to the addressed byte. The user enters the
desired value. Note that if the user desires to enter a
hex value, the hex value entered must be preceded by
“0x”. Otherwise, the value entered is assumed to be
in decimal radix.

There is a danger that you can erase all bytes in the entire EEPROM. Though it is good to have a
diagnostic tool that allows you to read and write data, there is a danger that lost data will make the
Advanced Interface Module (AIM) card fail.
During your session with the test dialog, you have access to the following commands:

H or h Displays a summary of the available commands.

d Dump EEPROM contents—Displays the contents of the EEPROM in hex.
e Erase EEPROM—Erases the entire EEPROM (all bytes set to 0xff).
p Primitive access—Erases the EEPROM.
q Exit EEPROM test—Causes the test aim eepromp command dialog to exit to the
command line interface (CLI).
z Zero EEPROM—Zeros the entire EEPROM.

Examples The following example displays the test aim eeprom command user dialog:
Router# test aim eeprom

AIM Slot [0]: 0

Use NMC93C46 ID EEPROM [y]: y
AIM Slot 0 eeprom (? for help)[?]: ?
d - dump eeprom contents
e - erase all locations (to 1)
p - primitive access
q - exit eeprom test
z - zero eeprom

'c' rules of radix type-in and display apply.

AIM Slot 0 eeprom (? for help)[?]:

Cisco IOS Interface and Hardware Component Command Reference

IR-802
 Interface and Hardware Component Commands
test interface fastethernet

test interface fastethernet

To test the Fast Ethernet interface by causing the interface to ping itself, use the test interface
fastethernet command in user EXEC or privileged EXEC mode.

test interface fastethernet number

Syntax Description number Port, connector, or interface card number. On a Cisco 4500 or Cisco 4700 series
router, specifies the network processor module (NPM) number. The numbers are
assigned at the factory at the time of installation or when added to a system and
are displayed with the show interfaces command.

Command Modes User EXEC

Privileged EXEC

Command History Release Modification

11.2 This command was introduced.

Usage Guidelines This command sends pings from the specified interface to itself. Unlike the ping command, the test
interface fastethernet command does not require the use of an IP address.

Examples The following example shows how to test a Fast Ethernet interface on a Cisco 4500 router:
Router# test interface fastethernet 0

Related Commands Command Description

ping (privileged) Diagnoses basic network connectivity on AppleTalk, CLNS, DECnet, IP, or
Novell IPX networks.
ping (user) Provides simple ping diagnostics of network connectivity.
show interfaces Displays information about interfaces.

Cisco IOS Interface and Hardware Component Command Reference

IR-803
 Interface and Hardware Component Commands
test satellite satellite mfg link

test satellite satellite mfg link

To force the Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT) to show that the
backbone link to the hub is up, even when the link is actually down, use the test satellite satellite
mfg link command in privileged EXEC mode.

test satellite satellite slot/unit mfg link {force | normal}

Syntax Description slot Router chassis slot in which the network module is installed.
/unit Interface number. For NM-1VSAT-GILAT network modules, always use 0.
force Forces the satellite link to appear to be UP.
normal Allows the satellite link to display the actual status, UP or DOWN. This is
the default.

Defaults The actual status (UP or DOWN) of the satellite link is displayed.

Command Modes Privileged EXEC

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines Use the test satellite satellite mfg link command only when instructed to do so by your satellite service
provider or a technical support representative.

Examples The following example shows how to force the NM-1VSAT-GILAT network module to show that the
backbone link to the hub is up, even if the link is actually down:
Router# test satellite satellite 1/0 mfg link force

The following example shows how to allow the NM-1VSAT-GILAT network module to show the actual
status (UP or DOWN) of the satellite link:
Router# test satellite satellite 1/0 mfg link normal

Cisco IOS Interface and Hardware Component Command Reference

IR-804
 Interface and Hardware Component Commands
test satellite satellite reset

test satellite satellite reset

To reset the Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT), use the test satellite
satellite reset command in privileged EXEC mode.

test satellite satellite slot/unit reset [hard]

Syntax Description slot Router chassis slot in which the network module is installed.
/unit Interface number. For NM-1VSAT-GILAT network modules, always use 0.
hard (Optional) Initiates a hardware reset. Not available on all routers.

Defaults Without the hard keyword, the command initiates a software reset.

Command Modes Privileged EXEC

Command History Release Modification

12.3(14)T This command was introduced.

Usage Guidelines Use the test satellite satellite reset command only when instructed to do so by your satellite service
provider or a technical support representative. You will lose satellite network connectivity while the
NM-1VSAT-GILAT network module resets.
We recommend that you first try a software reset. The hardware reset option is not available on all
routers.

Examples The following example shows how to initiate a software reset of the NM-1VSAT-GILAT
network module:
Router# test satellite satellite 1/0 reset

The following example shows how to initiate a hardware reset of the NM-1VSAT-GILAT
network module:
Router# test satellite satellite 1/0 reset hard

Cisco IOS Interface and Hardware Component Command Reference

IR-805
 Interface and Hardware Component Commands
test service-module

test service-module
To perform self-tests on an integrated CSU/DSU serial interface module, such as a 4-wire, 56/64 kbps
CSU/DSU, use the test service-module command in privileged EXEC mode.

test service-module interface-type interface-number

Syntax Description interface-type Interface type.

interface-number Interface number.

Command Modes Privileged EXEC

Command History Release Modification

11.2 This command was introduced.

Usage Guidelines The following tests are performed on the CSU/DSU:

• ROM checksum test
• RAM test
• EEPROM checksum test
• Flash checksum test
• DTE loopback with an internal pattern test
These self-tests are also performed at power on.
This command cannot be used if a DTE loopback, line loopback, or remote loopback is in progress.
Data transmission is interrupted for 5 seconds when you issue this command. To view the output of the
most recent self-tests, use the show service-module command.
This command does not have a no form.

Examples The following example shows how to perform a self-test on serial interface 0:
Router# test service-module serial 0

SERVICE_MODULE(0): Performing service-module self test

SERVICE_MODULE(0): self test finished: Passed

Related Commands Command Description

channelized Clears the interface counters.
clear service-module serial Resets an integrated CSU/DSU.
show service-module serial Displays the performance report for an integrated CSU/DSU.

Cisco IOS Interface and Hardware Component Command Reference

IR-806
 Interface and Hardware Component Commands
test trunk

test trunk
To configure the test port on a trunk card, use the test trunk command in privileged EXEC mode.

test trunk stm1 {drop | monitor} {tx | rx} {on | off} e1 controller

Syntax Description stm1 Specifies the test port on an STM-1 trunk card. This keyword is supported only
on the Cisco AS5850 platform.
drop Specifies drop mode where the existing signal is dropped and the signal from the
test port is sent to the controller.
monitor Specifies monitor mode where the signal from the specified E1 controller is
monitored via the test port. The original signal is not disturbed.
tx Specifies that signal is sent on the transmit line.
rx Specifies that signal is sent on the receive line.
on Switches the test port on.
off Switches the test port off.
e1 Specifies that an E1 controller is to be used for testing.
controller Slot and port numbers to identify the E1 controller.

Defaults The test port is disabled.

Command Modes Privileged EXEC

Command History Release Modification

11.0 This command was introduced.
12.2(15)T The stm-1 keyword was added.

Usage Guidelines If a controller does not go up, or there are a large number of errors associated with a specific E1
controller, you might be able to determine whether the problem is in the server card or in an external line
by using the test port. The test port is located on the front panel of the SDH/STM-1 trunk card.
This command does not have a no form because the command itself switches the test port on or off.
To use this command, one E1 controller is selected and the transmit and receive lines can be put into
drop or monitor mode. Both drop and monitor modes can be used at the same time on either the transmit
or receive lines, but both transmit and receive lines cannot be used in drop or monitor mode at the same
time.

Examples The following example shows how to configure a test port to use drop mode on the receive line of an E1
controller in the second path of an STM-1 trunk card in slot 2 of a Cisco AS5850 chassis:
Router# test trunk stm-1 drop rx on E1 2/0.2/1/2

Cisco IOS Interface and Hardware Component Command Reference

IR-807
 Interface and Hardware Component Commands
timeslot

timeslot
To enable framed mode on a serial interface on a G.703 E1 port adapter, an FSIP, or an E1-G.703/G.704
serial port adapter, use the timeslot command in interface configuration mode. To restore the interface
to unframed mode, use the no form of this command or set the start slot to 0.

timeslot start-slot stop-slot

no timeslot

Syntax Description start-slot First subframe in the major frame. Valid range is from 1 to 31 and must be less
than or equal to the stop-slot value.
stop-slot Last subframe in the major frame. Valid range is from 1 to 31 and must be greater
than or equal to the start-slot value.

Defaults The default G.703 E1 interface is not configured for framed mode.

Command Modes Interface configuration

Command History Release Modification

10.3 This command was introduced.
11.1 CA This command was modified to include the E1-G.703/G.704 serial port
adapter and Cisco 7200 series routers.

Usage Guidelines Framed mode allows you to specify a bandwidth for the interface by designating some of the 32 time
slots for data and reserving the others for framing (timing). Unframed mode, also known as clear
channel, does not reserve any time slots for framing.
This command applies to Cisco 4000, 7000, 7200, and 7500 series routers. G.703 E1 interfaces have two
modes of operation, framed and unframed. When in framed mode, the range from start-slot to stop-slot
gives the number of 64-kbps slots in use. There are thirty-two 64-kbps slots available.
In framed mode, timeslot 16 is not used for data. To use timeslot 16 for data, use the ts16 interface
configuration command.

Examples The following example shows how to enable framed mode on a serial interface on a G.703 E1 port
adapter or an E1-G.703/G.704 port adapter:
Router(config)# interface serial 3/0
Router(config-if)# timeslot 1-3

Cisco IOS Interface and Hardware Component Command Reference

IR-808
 Interface and Hardware Component Commands
timeslot

Related Commands Command Description

ts16 Controls the use of timeslot 16 for data on a G.703 E1 interface or on an
E1-G703/G.704 serial port adapter.

Cisco IOS Interface and Hardware Component Command Reference

IR-809
 Interface and Hardware Component Commands
transmit-buffers backing-store

transmit-buffers backing-store
To buffer short-term traffic bursts that exceed the bandwidth of the output interface, use the
transmit-buffers backing-store command in interface configuration mode. To disable this function, use
the no form of this command.

transmit-buffers backing-store

no transmit-buffers backing-store

Syntax Description This command has no arguments or keywords.

Defaults The default is off, unless weighted fair queueing is enabled on the interface. If weighted fair queueing
is enabled on the interface, the transmit-buffers backing-store command is enabled by default.

Command Modes Interface configuration

Command History Release Modification

10.3 This command was introduced on the Cisco 7500 series router.

Usage Guidelines If the transmit-buffers backing-store command is enabled and a full hardware transmit queue is
encountered, packets are swapped out of the original memory device (MEMD) into a system buffer in
DRAM. If the transmit-buffers backing-store command is not enabled and the output hold queue is
full, packets are dropped instead of being copied if a full hardware transmit queue is encountered. In
both cases, the original MEMD buffer is freed so that it can be reused for other input packets.
To preserve packet order, the router checks the output hold queue and outputs previously queued packets
first.

Examples The following example shows how to enable the transmit-buffers backing-store command on a FDDI
interface:
Router(config)# interface fddi 3/0
Router(config-if)# transmit-buffers backing-store

Related Commands Command Description

fair-queue (WFQ) Enables WFQ for an interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-810
 Interface and Hardware Component Commands
transmit-clock-internal

transmit-clock-internal
To enable the internally generated clock on a serial interface on a Cisco 7200 series or Cisco 7500 series
router when a DTE does not return a transmit clock, use the transmit-clock-internal command in
interface configuration mode. To disable the internally generated clock, use the no form of this
command.

transmit-clock-internal

no transmit-clock-internal

Syntax Description This command has no arguments or keywords.

Defaults The internally generated clock is disabled.

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Examples The following example shows how to enable the internally generated clock on serial interface 3/0 on a
Cisco 7200 series or Cisco 7500 series router:
Router(config)# interface serial 3/0
Router(config-if)# transmit-clock-internal

Cisco IOS Interface and Hardware Component Command Reference

IR-811
 Interface and Hardware Component Commands
transmitter-delay

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

transmitter-delay delay

no transmitter-delay

Syntax Description delay On the FSIP, high-speed serial interface (HSSI, and) on the IGS router, the minimum
number of High-Level Data Link Control (HDLC) flags to be sent between
successive packets. On all other serial interfaces and routers, approximate number
of microseconds of minimum delay after transmitting a packet. The valid range is
from 0 to 131071. Default is 0.

Defaults 0 flags or microseconds

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

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-R16,
CSC-R16M, CSC-1R, CSC-2R, and CSC-CTR. For the first four cards, the command syntax is the same
as the existing command and specifies the number of microseconds to delay between sending frames that
are generated by the router. Transmitter delay for the CSC-CTR uses the same syntax, but specifies a
relative time interval to delay between transmission of all frames.

Examples The following example shows how to specify a delay of 300 microseconds on serial interface 0:
Router(config)# interface serial 0
Router(config-if)# transmitter-delay 300

Cisco IOS Interface and Hardware Component Command Reference

IR-812
 Interface and Hardware Component Commands
ts16

ts16
To control the use of time slot 16 for data on a G.703 E1 interface or on an E1-G.703/G.704 serial port
adapter, use the ts16 command in interface configuration mode. To restore the default, use the no form
of this command.

ts16

no ts16

Syntax Description This command has no arguments or keywords.

Defaults Time slot 16 is used for signaling.

Command Modes Interface configuration

Command History Release Modification

10.3 This command was introduced.
11.1 CA This command was implemented on the E1-G.703/G.704 serial port adapter
and Cisco 7200 series routers.

Usage Guidelines This command applies to Cisco 4000, 7000, 7200, and 7500 series routers. By default, time slot 16 is
used for signaling. Use this command to configure time slot 16 to be used for data. When in framed
mode, in order to get all possible subframes or time slots, you must use the ts16 command.

Examples The following example shows how to configure time slot 16 to be used for data on a G.703 E1 interface
or an E1-G.703/G.704 serial port adapter:
Router(config-if)# ts16

Related Commands Command Description

timeslot Enables framed mode serial interface on a G.703 E1 port adapter, an FSIP,
or an E1-G.703/G.704 serial port adapter.

Cisco IOS Interface and Hardware Component Command Reference

IR-813
 Interface and Hardware Component Commands
tug-2 e1

tug-2 e1
To create E1 controllers for a specified path under the Tributary Unit group type 2 (TUG-2), use the
tug-2 e1 command in controller configuration mode.

tug-2 tug-2-number e1 e1-number

Syntax Description tug-2-number Number, or range of numbers, from 1 to 7. To specify a range of TUG-2
numbers use a dash between the values, for example 1-5. An individual
TUG-2 can be specified using a comma between values, for example 2,4.
Default is 1.
e-1-number Number, or range of numbers, from 1 to 3. To specify a range of
E1 numbers use a dash between the values, for example 1-3. An individual
E1 can be specified using a comma between values, for example 2,3.

Defaults Default tug-2-number value for STM-1 card is 1.

Command Modes Controller configuration

Command History Release Modification

12.0(14)S This command was introduced.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.

Usage Guidelines Use the tug-2 e1 command to create an E1 controller with the following name format:
slot/port.path/tug-2-number/e1-number
Up to 21 controllers can be created for one path. Only one path can be selected at a time.

Examples The following example shows how to configure 15 E1 controllers on the second path of an STM-1 in
physical slot number 2 of a Cisco AS5850 chassis:
Router(config)# controller sonet 2/0
Router(config-controller)# aug mapping au-4
Router(config-ctrlr-tug3)# au-4 1 tug-3 2
Router(config-ctrlr-tug3)# tug-2 5 e1 3

Related Commands Command Description

show controller sonet Displays information about SONET controllers.

Cisco IOS Interface and Hardware Component Command Reference

IR-814
 Interface and Hardware Component Commands
tunnel bandwidth

tunnel bandwidth
To set the transmit bandwidth used by the tunnel interface, use the tunnel bandwidth command in
interface configuration mode. To restore the default setting, use the no form of this command.

tunnel bandwidth {receive | transmit} bandwidth

no tunnel bandwidth

Syntax Description receive Specifies the bandwidth to be used to receive packets through the tunnel.
Note This keyword is no longer used and will be removed in future releases.
transmit Specifies the bandwidth to be used to send packets through the tunnel.
bandwidth Bandwidth, in kbps. Range is from 0 to 2147483647. Default is 8000.

Defaults 8000 kbps

Command Modes Interface configuration

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines Use the tunnel bandwidth command to specify the capacity of the satellite link.

Examples The following example shows how to set the satellite tunnel bandwidth to 1000 kbps for transmitting
packets using Rate Based Satellite Control Protocol:
Router(config)# interface tunnel 0
Router(config-if)# tunnel bandwidth transmit 1000

Related Commands Command Description

tunnel destination Specifies the destination for a tunnel interface.
tunnel mode Sets the encapsulation mode for a tunnel interface.
tunnel source Sets the source address of a tunnel interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-815
 Interface and Hardware Component Commands
tunnel checksum

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

tunnel checksum

no tunnel checksum

Syntax Description This command has no arguments or keywords.

Defaults Disabled

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines This command currently applies to generic routing 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 routers will drop corrupted packets.

Examples The following example shows how to enable encapsulator-to-decapsulator checksumming of packets for
all protocols on the tunnel interface:
Router(config-if)# tunnel checksum

Cisco IOS Interface and Hardware Component Command Reference

IR-816
 Interface and Hardware Component Commands
tunnel key

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

tunnel key key-number

no tunnel key

Syntax Description key-number Number from 0 to 4294967295 that identifies the tunnel key.

Defaults No tunnel ID keys are enabled.

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

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 improper configuration or injection of packets from a foreign
source.

Note IP multicast traffic is not supported when a tunnel ID key is configured unless the traffic is
process-switched. You must configure the no ip mroute-cache command in interface configuration
mode on the interface if an ID key is configured. This note applies only to Cisco IOS Release 12.0 and
earlier releases.

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

Examples The following example shows how to set the tunnel ID key to 3:
Router(config-if)# tunnel key 3

Cisco IOS Interface and Hardware Component Command Reference

IR-817
 Interface and Hardware Component Commands
tunnel mode

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

tunnel mode {aurp | cayman | dvmrp | eon | gre | gre ipv6 | gre multipoint | ipip
[decapsulate-any] | ipsec ipv4 | iptalk | ipv6 | mpls | nos | rbscp}

no tunnel mode

Syntax Description aurp AppleTalk Update-Based Routing Protocol.

cayman Cayman TunnelTalk AppleTalk encapsulation.
decapsulate-any (Optional) Terminates any number of IP-in-IP tunnels at one tunnel interface.
Note that this tunnel will not carry any outbound traffic; however, any number of
remote tunnel endpoints can use a tunnel configured this way as their destination.
dvmrp Distance Vector Multicast Routing Protocol.
eon EON compatible CLNS tunnel.
gre Generic routing encapsulation protocol. This is the default.
gre ipv6 GRE tunneling using IPv6 as the delivery protocol.
gre multipoint Multipoint GRE (mGRE).
ipip IP-over-IP encapsulation.
ipsec ipv4 Tunnel mode is ipsec and the transport is IPv4.
iptalk Apple IPTalk encapsulation.
ipv6 Static tunnel interface configured to encapsulate IPv6 or IPv4 packets in IPv6.
mpls Multiprotocol Label Switching encapsulation.
nos KA9Q/NOS compatible IP over IP.
rbscp Rate Based Satellite Control Protocol (RBSCP).

Defaults GRE tunneling (gre)

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.
10.3 The following keywords were added:
• aurp
• dvmrp
• ipip
11.2 The optional decapsulate-any keyword was added.
12.2(13)T The gre multipoint keyword was added.

Cisco IOS Interface and Hardware Component Command Reference

IR-818
 Interface and Hardware Component Commands
tunnel mode

Release Modification
12.3(7)T The following keywords were added:
• gre ipv6 to support GRE tunneling using IPv6 as the delivery protocol.
• ipv6 to allow a static tunnel interface to be configured to encapsulate
IPv6 or IPv4 packets in IPv6.
• rbscp to support Rate Based Satellite Control Protocol (RBSCP).
12.3(14)T The ipsec ipv4 keyword was added to support IPSec virtual tunnel
interfaces.

Usage Guidelines Source and Destination Address

You cannot have two tunnels that use 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
Designed by Cayman Systems, Cayman tunneling implements tunneling to enable Cisco routers to
interoperate with Cayman GatorBoxes. With Cayman tunneling, you can establish tunnels between two
routers or between a Cisco router and a GatorBox. When using Cayman tunneling, you must not
configure the tunnel with an AppleTalk network address.

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

GRE with AppleTalk

GRE tunneling can be done between Cisco routers only. When using GRE tunneling for AppleTalk, you
configure the tunnel with an AppleTalk network address. Using the AppleTalk network address you can
ping the other end of the tunnel to check the connection.

Multipoint GRE
After enabling mGRE tunneling, you can enable the tunnel protection command, which allows you to
associate the mGRE tunnel with an IP Security (IPSec) profile. Combining mGRE tunnels and IPSec
encryption allows a single mGRE interface to support multiple IPSec tunnels, thereby simplifying the
size and complexity of the configuration.

Note GRE tunnel keepalives configured using the keepalive command under the GRE interface are supported
only on point-to-point GRE tunnels.

RBSCP
RBSCP tunneling is designed for wireless or long-distance delay links with high error rates, such as
satellite links. Using tunnels, RBSCP can improve the performance of certain IP protocols, such as TCP
and IPSec, over satellite links without breaking the end-to-end model.

Cisco IOS Interface and Hardware Component Command Reference

IR-819
 Interface and Hardware Component Commands
tunnel mode

Examples Cayman Tunneling

The following example shows how to enable Cayman tunneling:
Router(config)# interface tunnel 0
Router(config-if)# tunnel source ethernet 0
Router(config-if)# tunnel destination 10.108.164.19
Router(config-if)# tunnel mode cayman

GRE Tunneling
The following example shows how to enable GRE tunneling:
Router(config)# interface tunnel 0
Router(config-if)# appletalk cable-range 4160-4160 4160.19
Router(config-if)# appletalk zone Engineering
Router(config-if)# tunnel source ethernet0
Router(config-if)# tunnel destination 10.108.164.19
Router(config-if)# tunnel mode gre

IPSec in IPv4 Transport

The following example shows how to configure a tunnel using IPSec encapsulation with IPv4 as the
transport mechanism.
Router(config)# crypto ipsec profile PROF
Router(config)# set transform tset
!
Router(config)# interface tunnel0
Router(config-if)# ip address 1.1.1.1 255.255.255.0
Router(config-if)# tunnel mode ipsec ipv4
Router(config-if)# tunnel source Loopback0
Router(config-if)# tunnel destination 172.16.1.1
Router(config-if)# tunnel protection ipsec profile PROF

Multipoint GRE Tunneling

The following example shows how to enable mGRE tunneling:
interface Tunnel0
bandwidth 1000
ip address 10.0.0.1 255.255.255.0
! Ensures that longer packets are fragmented before they are encrypted; otherwise, the
! receiving router would have to do the reassembly.
ip mtu 1416
! Turns off split horizon on the mGRE tunnel interface; otherwise, EIGRP will not
! advertise routes that are learned via the mGRE interface back out that interface.
no ip split-horizon eigrp 1
no ip next-hop-self eigrp 1
delay 1000
! Sets IPSec peer address to Ethernet interface’s public address.
tunnel source Ethernet0
tunnel mode gre multipoint
! The following line must match on all nodes that want to use this mGRE tunnel.
tunnel key 100000
tunnel protection ipsec profile vpnprof

RBSCP Tunneling
The following example shows how to enable RBSCP tunneling:
Router(config)# interface tunnel 0
Router(config-if)# tunnel source ethernet 0
Router(config-if)# tunnel destination 10.108.164.19
Router(config-if)# tunnel mode rbscp

Cisco IOS Interface and Hardware Component Command Reference

IR-820
 Interface and Hardware Component Commands
tunnel mode

Related Commands Command Description

appletalk cable-range Enables an extended AppleTalk network.
appletalk zone Sets the zone name for the connected AppleTalk network.
tunnel destination Specifies the destination for a tunnel interface.
tunnel protection Associates a tunnel interface with an IPSec profile.
tunnel source Sets the source address of a tunnel interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-821
 Interface and Hardware Component Commands
tunnel path-mtu-discovery

tunnel path-mtu-discovery
To enable Path MTU Discovery (PMTUD) on a GRE or IP-in-IP tunnel interface, use the tunnel
path-mtu-discovery command in interface configuration mode. To disable PMTUD on a tunnel
interface, use the no form of this command.

tunnel path-mtu-discovery [age-timer {aging-mins | infinite}]

no tunnel path-mtu-discovery

Syntax Description age-timer (Optional) Sets a timer to run for a specified interval, in minutes, after which the
tunnel interface resets the maximum transmission unit (MTU) of the path to the
default tunnel MTU minus 24 bytes for GRE tunnels or minus 20 bytes for
IP-in-IP tunnels.
• aging-mins—Number of minutes. Range is from 10 to 30. Default is 10.
• infinite—Disables the age timer.

Defaults Path MTU Discovery is disabled for a tunnel interface.

Command Modes Interface configuration

Command History Release Modification

12.0(5)WC5 This command was introduced.
12.0(7)T3 This command was integrated into Cisco IOS Release 12.0(7)T3.

Usage Guidelines When PMTUD (RFC 1191) is enabled on a tunnel interface, the router performs PMTUD processing for
the GRE (or IP-in-IP) tunnel IP packets. The router always performs PMTUD processing on the original
data IP packets that enter the tunnel. When PMTUD is enabled, no packet fragmentation occurs on the
encapsulated packets that travel through the tunnel. Without packet fragmentation, there is a better
throughput of TCP connections, and this makes PMTUD a method for maximizing the use of available
bandwidth in the network between the endpoints of a tunnel interface.
After PMTUD is enabled, the Don’t Fragment (DF) bit of the IP packet header that is forwarded into the
tunnel is copied to the IP header of the external IP packets. The external IP packet is the encapsulating
IP packet. Adding the DF bit allows the PMTUD mechanism to work on the tunnel path of the tunnel.
The tunnel endpoint listens for ICMP unreachable too-big messages and modifies the IP MTU of the
tunnel interface, if required.
When the aging timer is configured, the tunnel code resets the tunnel MTU after the aging timer expires.
After the tunnel MTU is reset, a set of full-size packets with the DF bit set is required to trigger the tunnel
PMTUD and lower the tunnel MTU. At least two packets are dropped each time the tunnel MTU
changes.
When PMTUD is disabled, the DF bit of an external (encapsulated) IP packet is set to zero even if the
encapsulated packet has a DF bit set to one.

Cisco IOS Interface and Hardware Component Command Reference

IR-822
 Interface and Hardware Component Commands
tunnel path-mtu-discovery

Note PMTUD on a tunnel interface requires that the tunnel endpoint be able to receive ICMP messages
generated by routers in the path of the tunnel. Check that ICMP messages can be received before
using PMTUD over firewall connections.

PMTUD currently works only on GRE and IP-in-IP tunnel interfaces.

Use the show interfaces tunnel command to verify the tunnel PMTUD parameters.

Examples The following example shows how to enable tunnel PMTUD:

Router(config)# interface tunnel 0
Router(config-if)# tunnel path-mtu-discovery

Related Commands Command Description

interface Configures an interface and enters interface configuration mode.
show interfaces tunnel Displays information about the specified tunnel interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-823
 Interface and Hardware Component Commands
tunnel protection

tunnel protection
To associate a tunnel interface with an IP Security (IPSec) profile, use the tunnel protection command
in interface configuration mode. To disassociate a tunnel with an IPSec profile, use the no form of this
command.

tunnel protection ipsec profile name [shared]

no tunnel protection ipsec profile name [shared]

Syntax Description ipsec profile Enables generic routing encapsulation (GRE) tunnel encryption via
IPSec.
name Name of the IPSec profile. This value must match the name specified in
the crypto ipsec profile command.
shared (Optional) Allows the tunnel protection IPSec Security Association
Database (SADB) to share the same dynamic crypto map instead of
creating a unique crypto map per tunnel interface.
Note Unlike the tunnel protection command, which specifies that
IPSec encryption will be performed after GRE encapsulation,
configuring a crypto map on a tunnel interface specifies that
encryption will be performed before GRE encapsulation.

Defaults Tunnel interfaces are not associated with IPSec profiles.

Command Modes Interface configuration

Command History Release Modification

12.2(13)T This command was introduced.
12.3 The shared keyword was added.

Usage Guidelines Use the tunnel protection command to specify that IPSec encryption will be performed after the GRE
has been added to the tunnel packet. The tunnel protection command can be used with multipoint GRE
(mGRE) and point-to-point GRE (p-pGRE) tunnels. With p-pGRE tunnels, the tunnel destination
address will be used as the IPSec peer address. With mGRE tunnels, multiple IPSec peers are possible;
the corresponding Next Hop Resolution Protocol (NHRP) mapping nonbroadcast multiaccess (NBMA)
destination addresses will be used as the IPSec peer addresses.

The shared Keyword

If you wish to configure two Dynamic Multipoint VPN (DMVPN) mGRE and IPSec tunnels on the same
router, you must issue the shared keyword.
The dynamic crypto map that is created by the tunnel protection command is always different from a
crypto map that is configured directly on the interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-824
 Interface and Hardware Component Commands
tunnel protection

Note GRE tunnel keepalives (configured with the keepalive command under the GRE interface) are not
supported in combination with the tunnel protection command.

Examples The following example shows how to associate the IPSec profile “vpnprof” with an mGRE tunnel
interface. In this example, the IPSec source peer address will be the IP address from Ethernet interface 0.
There is a static NHRP mapping from IP address 10.0.0.3 to IP address 172.16.2.1, so for this NHRP
mapping the IPSec destination peer address will be 172.16.2.1. The IPSec proxy will be as follows:
permit gre host ethernet0-ip-address host ip-address. Other NHRP mappings (static or dynamic) will
automatically create additional IPSec security associations (SAs) with the same source peer address and
the destination peer address from the NHRP mapping. The IPSec proxy for these NHRP mappings will
be as follows: permit gre host ethernet0-ip-address host NHRP-mapping-NBMA-address.
crypto ipsec profile vpnprof
set transform-set trans2
!
interface Tunnel0
bandwidth 1000
ip address 10.0.0.1 255.255.255.0
! Ensures that longer packets are fragmented before they are encrypted; otherwise, the
! receiving router would have to do the reassembly.
ip mtu 1416
ip nhrp authentication donttell
ip nhrp map multicast dynamic
ip nhrp network-id 99
ip nhrp holdtime 300
! Turns off split horizon on the mGRE tunnel interface; otherwise, EIGRP will not
! advertise routes that are learned via the mGRE interface back out that interface.
no ip split-horizon eigrp 1
no ip next-hop-self eigrp 1
delay 1000
! Sets the IPSec peer address to the Ethernet interface’s public address.
tunnel source Ethernet0
tunnel mode gre multipoint
! The following line must match on all nodes that want to use this mGRE tunnel.
tunnel key 100000
tunnel protection ipsec profile vpnprof

The following example shows how to associate the IPSec profile “vpnprof” with a p-pGRE tunnel
interface. In this example, the IPSec source peer address will be the IP address from Ethernet interface 0.
The IPSec destination peer address will be 172.16.1.10 (per the tunnel destination address command).
The IPSec proxy will be as follows: permit gre host ethernet0-ip-address host ip-address.
interface Tunnel1
ip address 10.0.1.1 255.255.255.252
! Ensures that longer packets are fragmented before they are encrypted; otherwise, the
! receiving router would have to do the reassembly.
ip mtu 1420
tunnel source Ethernet0
tunnel destination 172.16.1.10
tunnel protection ipsec profile vpnprof

Cisco IOS Interface and Hardware Component Command Reference

IR-825
 Interface and Hardware Component Commands
tunnel protection

Related Commands Command Description

crypto ipsec profile Defines the IPSec parameters that are to be used for IPSec encryption
between two IPSec routers.
interface Configures an interface type and enters interface configuration mode.
keepalive (tunnel Enables keepalive packets and specifies the number of times that the
interfaces) Cisco IOS software tries to send keepalive packets without a response
before bringing the tunnel protocol down for a specific interface.
permit Sets conditions for a named IP access list.

Cisco IOS Interface and Hardware Component Command Reference

IR-826
 Interface and Hardware Component Commands
tunnel rbscp ack_split

tunnel rbscp ack_split

To enable TCP acknowledgement (ACK) splitting for Rate Based Satellite Control Protocol (RBSCP)
tunnels, use the tunnel rbscp ack_split command in interface configuration mode. To disable TCP
acknowledgement splitting for RBSCP tunnels, use the no form of this command.

tunnel rbscp ack_split split-size

no tunnel rbscp ack_split split-size

Syntax Description split-size Number of ACKs to send for every ACK received. Range is from 1 to 32.
Default is 4.

Defaults TCP acknowledgement splitting for RBSCP tunnels is disabled.

Command Modes Interface configuration

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines Performance improvements can be made for clear-text TCP traffic using ACK splitting where a number
of additional TCP ACKs are generated for each TCP ACK received. TCP will open a congestion window
by one maximum transmission unit (MTU) for each TCP ACK received. Opening the congestion window
results in increased bandwidth becoming available. Use the tunnel rbscp ack_split command only when
the satellite link is not using all the available bandwidth. Encrypted traffic cannot use ACK splitting.

Examples The following example shows how to enable RBSCP tunnel TCP ACK splitting and configure three ACK
packets to be sent for each ACK packet received:
Router(config)# interface tunnel 0
Router(config-if)# tunnel rbscp ack_split 3

Related Commands Command Description

show rbscp Displays state and statistical information about RBSCP tunnels.

Cisco IOS Interface and Hardware Component Command Reference

IR-827
 Interface and Hardware Component Commands
tunnel rbscp delay

tunnel rbscp delay

To enable the Rate Based Satellite Control Protocol (RBSCP) tunnel delay, use the tunnel rbscp delay
command in interface configuration mode. To disable RBSCP tunnel delay, use the no form of this
command.

tunnel rbscp delay

no tunnel rbscp delay

Syntax Description This command has no arguments or keywords.

Defaults RBSCP tunnel delay is disabled.

Command Modes Interface configuration

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines Use the tunnel rbscp delay command only if the RBSCP tunnel has a round-trip time (RTT) over
700 milliseconds.

Examples The following example shows how to enable the RBSCP tunnel delay:
Router(config)# interface tunnel 0
Router(config-if)# tunnel rbscp delay

Related Commands Command Description

show rbscp Displays state and statistical information about RBSCP tunnels.

Cisco IOS Interface and Hardware Component Command Reference

IR-828
 Interface and Hardware Component Commands
tunnel rbscp input_drop

tunnel rbscp input_drop

To configure the input queue size on a Rate Based Satellite Control Protocol (RBSCP) tunnel, use the
tunnel rbscp input_drop command in interface configuration mode. To restore the default input queue
size, use the no form of this command.

tunnel rbscp input_drop bw-delay-products

no tunnel rbscp input_drop

Syntax Description bw-delay-products Number of bandwidth delay products (BDP) bytes that can be queued before
packets are dropped on the input side. Range from 1 to 10. Default is 2.

Defaults Input queue size is 2 BDP bytes.

Command Modes Interface configuration

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines Use the tunnel rbscp input_drop command to restrict the amount of data queued by the router. After
the configured byte limit is reached, packets that would be encapsulated and sent via the tunnel are
dropped on the input side. Congestion control of the satellite link is also provided by this command
because the dropped packets will force the end hosts to reduce their sending rate of packets.
Use this command in conjunction with the tunnel rbscp long_drop command which allows packets that
are waiting in an RBSCP tunnel encapsulation queue to be dropped after a period of time.

Examples The following example shows how to set the RBSCP tunnel queue size to 5 BDP bytes:
Router(config)# interface tunnel 0
Router(config-if)# tunnel rbscp input_drop 5

Related Commands Command Description

show rbscp Displays state and statistical information about RBSCP tunnels.
tunnel rbscp long_drop Allows packets to be dropped after waiting in the RBSCP tunnel
encapsulation queue for too long.

Cisco IOS Interface and Hardware Component Command Reference

IR-829
 Interface and Hardware Component Commands
tunnel rbscp long_drop

tunnel rbscp long_drop

To allow packets to be dropped that have been queued too long for Rate Based Satellite Control Protocol
(RBSCP) tunnel encapsulation, use the tunnel rbscp long_drop command in interface configuration
mode. To disable the dropping of queued packets, use the no form of this command.

tunnel rbscp long_drop

no tunnel rbscp long_drop

Syntax Description This command has no arguments or keywords.

Defaults No queued packets are dropped.

Command Modes Interface configuration

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines The tunnel rbscp long_drop command allows the transmitting router to drop packets that have been
waiting in the queue for RBSCP tunnel encapsulation for a long time. The period of time after which
packets are dropped is determined using the round-trip time (RTT) estimate of the tunnel.
Use this command in conjunction with the tunnel rbscp input_drop command which configures the
size of the input queue. After the configured byte limit of the input queue is reached, packets are
dropped.

Examples The following example shows how to allow packets to be dropped when they have been queued for
RBSCP tunnel encapsulation too long:
Router(config)# interface tunnel 0
Router(config-if)# tunnel rbscp long_drop

Related Commands Command Description

show rbscp Displays state and statistical information about RBSCP tunnels.
tunnel rbscp input_drop Configures the input queue size on an RBSCP tunnel.

Cisco IOS Interface and Hardware Component Command Reference

IR-830
 Interface and Hardware Component Commands
tunnel rbscp report

tunnel rbscp report

To report dropped Rate Based Satellite Control Protocol (RBSCP) packets to the Stream Control
Transmission Protocol (SCTP), use the tunnel rbscp report command in interface configuration mode.
To disable dropped-packet reporting to SCTP, use the no form of this command.

tunnel rbscp report

no tunnel rbscp report

Syntax Description This command has no arguments or keywords.

Defaults RBSCP dropped-packet reporting is enabled.

Command Modes Interface configuration

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines Use the tunnel rbscp report command to provide early reporting of dropped RBSCP packets to SCTP
instead of attempting retransmission of the packets at the router. SCTP will inform the end hosts of the
dropped packets and allow the end hosts to retransmit the packets. Reporting dropped packets through
SCTP provides better throughput because the packet dropping is not assumed to be caused by
congestion.

Examples The following example shows how to disable the SCTP drop reporting (reporting is enabled by default):
Router(config)# interface tunnel 0
Router(config-if)# no tunnel rbscp report

Related Commands Command Description

show rbscp Displays state and statistical information about RBSCP tunnels.

Cisco IOS Interface and Hardware Component Command Reference

IR-831
 Interface and Hardware Component Commands
tunnel rbscp window_stuff

tunnel rbscp window_stuff

To enable TCP window stuffing by increasing the value of the TCP window scale for Rate Based Satellite
Control Protocol (RBSCP) tunnels, use the tunnel rbscp window_stuff command in interface
configuration mode. To restore the default TCP window scale value, use the no form of this command.

tunnel rbscp window_stuff step-size

no tunnel rbscp window_stuff

Syntax Description step-size Increment step size for the TCP window scale. Range is from 1 to 20. Default
is 1.

Defaults TCP window stuffing is disabled.

Command Modes Interface configuration

Command History Release Modification

12.3(7)T This command was introduced.

Usage Guidelines Use the tunnel rbscp window_stuff command to make the sending host believe that the receiving host
has a larger window by artificially increasing the TCP window size. RBSCP buffers the additional
window and which be configured up to the satellite link bandwidth or the memory available on the router.

Note The actual TCP window size value that is used by the router may be smaller than the configured value
because of the available bandwidth.

Examples The following example shows how to enable TCP window stuffing on the RBSCP tunnel and configure
a window size of 2:
Router(config)# interface tunnel 0
Router(config-if)# tunnel rbscp window_stuff 2

Related Commands Command Description

show rbscp Displays state and statistical information about RBSCP tunnels.

Cisco IOS Interface and Hardware Component Command Reference

IR-832
 Interface and Hardware Component Commands
tunnel sequence-datagrams

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

tunnel sequence-datagrams

no tunnel sequence-datagrams

Syntax Description This command has no arguments or keywords.

Defaults Disabled

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines This command currently applies to generic routing 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).

Examples The following example shows how to configure the tunnel to drop datagrams that arrive out of order:
Router(config-if)# tunnel sequence-datagrams

Cisco IOS Interface and Hardware Component Command Reference

IR-833
 Interface and Hardware Component Commands
tunnel vrf

tunnel vrf
To associate a VPN routing and forwarding (VRF) instance with a specific tunnel destination, interface
or subinterface, use the tunnel vrf command in global configuration mode or interface configuration
mode. To disassociate a VRF from the tunnel destination, use the no form of this command.

tunnel vrf vrf-name

no tunnel vrf vrf-name

Syntax Description vrf-name Name assigned to a VRF.

Defaults The default destination is determined by the global routing table.

Command Modes Global configuration

Interface configuration

Command History Release Modification

12.0(23)S This command was introduced.
12.3(2)T This command was integrated into Cisco IOS Release 12.3(2)T.

Usage Guidelines The tunnel source and destination must be in the same VRF.
Either the IP VRF or the tunnel VRF can be set to the global routing table (using the no ip vrf
forwarding vrf command or the no tunnel vrf vrf command).
The tunnel will be disabled if no route to the tunnel destination is defined. If the tunnel VRF is set, there
must ba a route to that destination in the VRF.

Examples The following example shows how to associate a VRF with a tunnel destination. The tunnel endpoint,
10.5.5.5 will be looked up in the blue VRF.
interface tunnel0
ip vrf forwarding green
ip address 10.3.3.3 255.255.255.0
tunnel source loop 0
tunnel destination 10.5.5.5
tunnel vrf blue

Related Commands Command Description

ip route vrf Establishes static routes for a VRF.
ip vrf Configures a VRF routing table.
ip vrf forwarding Associates a VPN VRF instance with an interface or subinterface.

Cisco IOS Interface and Hardware Component Command Reference

IR-834
Interface and Hardware Component Commands
tunnel vrf

Command Description
tunnel destination Specifies the destination for a tunnel interface.
tunnel source Sets the source address for a tunnel interface.

Cisco IOS Interface and Hardware Component Command Reference

IR-835
 Interface and Hardware Component Commands
tx-queue-limit

tx-queue-limit
To control the number of transmit buffers available to a specified interface on the multiport
communications interface (MCI) and serial communications interface (SCI) cards, use the
tx-queue-limit command in interface configuration mode.

tx-queue-limit number

Syntax Description number Maximum number of transmit buffers that the specified interface can subscribe.

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

Command Modes Interface configuration

Command History Release Modification

10.0 This command was introduced.

Usage Guidelines This command should be used only under the guidance of a technical support representative.
This command does not have a no form.

Examples The following example shows how to set the maximum number of transmit buffers on the interface to 5:
Router(config)# interface ethernet 0
Router(config-if)# tx-queue-limit 5

Related Commands Command Description

show controllers mci Displays all information under the MCI card or the SCI.

Cisco IOS Interface and Hardware Component Command Reference

IR-836
 Interface and Hardware Component Commands
xconnect (CEM)

xconnect (CEM)
To build one end of a circuit emulation (CEM) connection and to enter CEM xconnect configuration
mode, use the xconnect command in CEM configuration mode. To remove any existing CEM
connections from this CEM channel, use the no form of this command.

xconnect remote-ip-address virtual-connect-ID encapsulation encapsulation-type

no xconnect

Syntax Description remote-ip-address IP address of an interface—physical or loopback—on the destination router.

virtual-connect-ID Virtual connect ID (VCID). For CEM over IP (CEoIP), you must enter a
value of 0.
encapsulation Sets the encapsulation type.
encapsulation-type Encapsulation type. You must set the encapsulation type to UDP.

Defaults No CEM connections are built.

Command Modes CEM configuration

Command History Release Modification

12.3(7)T This command was introduced.

Examples The following example shows how to build one end of a CEoIP connection and to enter CEM xconnect
configuration mode.
Router(config-cem)# xconnect 10.0.5.1 0 encapsulation udp
Router(config-cem-xconnect)#

Related Commands Command Description

cem Enters circuit emulation configuration mode.
local ip address Defines the IP address of the local router.
local udp port Defines the local UDP port.
remote udp port Defines the UDP port of a remote endpoint.
show cem Displays CEM channel statistics.

Cisco IOS Interface and Hardware Component Command Reference

IR-837
 Interface and Hardware Component Commands
yellow

yellow
To enable generation and detection of yellow alarms, use the yellow command in interface configuration
mode.

yellow {generation | detection}

Syntax Description generation Enables or disables generation of yellow alarms.

detection Enables or disables detection of yellow alarms.

Defaults Yellow alarm generation and detection are enabled.

Command Modes Interface configuration

Command History Release Modification

12.0(5)XE This command was introduced.
12.0(7)XE1 This command was implemented on Cisco 7100 series routers.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.

Usage Guidelines Use this command to generate and detect yellow alarms. If the received signal is lost the yellow alarm
can be generated to indicate a frame loss event. Generation of a yellow alarm will ensure that the alarm
is sent to the remote end of the link. When the remote end is transmitting a yellow alarm, detection must
be enabled to detect the alarm condition.

Examples The following example shows how to enable generation and detection of yellow alarms on a Cisco 7500
series router:
Router(config)# interface atm 3/1/0
Router(config-if)# yellow generation
Router(config-if)# yellow detection

Cisco IOS Interface and Hardware Component Command Reference

IR-838