Troubleshooting Commands

This chapter explains the function and syntax of the troubleshooting commands. For more information about defaults and usage guidelines, see the corresponding chapter of the Cisco IOS Configuration Fundamentals Command Reference, Release 12.1.

attach

To connect to a specific line card for the purpose of executing monitoring and maintenance commands on that line card only, use the attach privileged EXEC command. To exit from the Cisco IOS software image on the line card and return to the Cisco IOS image on the GRP card, use the exit command.

attach slot-number

Syntax Description

slot-number

Slot number of the line card you want to connect to. Slot numbers range from 0 to 11 for the Cisco 12012 and 0 to 7 for the Cisco 12008. If the slot number is omitted, you are prompted for the slot number.

slot-number	Slot number of the line card you want to connect to. Slot numbers range from 0 to 11 for the Cisco 12012 and 0 to 7 for the Cisco 12008. If the slot number is omitted, you are prompted for the slot number.

clear logging

To clear messages from the logging buffer, use the clear logging privileged EXEC command.

clear logging

Syntax Description

This command has no arguments or keywords.

diag

To perform field diagnostics on a line card, on the Gigabit Route Processor (GRP), on the Switch Fabric Cards (SFC), and on the Clock Scheduler Card (CSC) in Cisco 12000 series Gigabit Switch Routers, use the diag privileged EXEC command. To disable field diagnostics on a line card, use the no form of this command.

diag slot-number [halt | previous | post | verbose [wait] | wait]

no diag slot-number

Syntax Description

slot-number

Slot number of the line card you want to test. Slot numbers range from 0 to 11 for the Cisco 12012 and 0 to 7 for the Cisco 12008. Slot numbers for the CSC are 16 and 17 and for the FSC are18, 19, and 20.

halt

(Optional) Stops the field diagnostic testing on the line card.

previous

(Optional) Displays previous test results (if any) for the line card.

post

(Optional) Initiates a EPROM-based extended power-on self-test (EPOST) only. The EPOST test suite is not as comprehensive as the field diagnostics, and a pass/fail message is the only message displayed on the console.

verbose [wait]

(Optional) Enables the maximum status messages to be displayed on the console. By default, only the minimum status messages are displayed on the console. If you specify the optional wait keyword, the Cisco IOS software is not be automatically reloaded on the line card after the test completes successfully.

wait

(Optional) Stops the automatic reloading of the Cisco IOS software on the line card after the successful completion of the field diagnostic testing. If you use this keyword, you must use the microcode reload slot global configuration command, or manually remove and insert the line card (to power it up) in the slot so that the GRP will recognize the line card and download the Cisco IOS software image to the line card.

slot-number	Slot number of the line card you want to test. Slot numbers range from 0 to 11 for the Cisco 12012 and 0 to 7 for the Cisco 12008. Slot numbers for the CSC are 16 and 17 and for the FSC are18, 19, and 20.
halt	(Optional) Stops the field diagnostic testing on the line card.
previous	(Optional) Displays previous test results (if any) for the line card.
post	(Optional) Initiates a EPROM-based extended power-on self-test (EPOST) only. The EPOST test suite is not as comprehensive as the field diagnostics, and a pass/fail message is the only message displayed on the console.
verbose [wait]	(Optional) Enables the maximum status messages to be displayed on the console. By default, only the minimum status messages are displayed on the console. If you specify the optional wait keyword, the Cisco IOS software is not be automatically reloaded on the line card after the test completes successfully.
wait	(Optional) Stops the automatic reloading of the Cisco IOS software on the line card after the successful completion of the field diagnostic testing. If you use this keyword, you must use the microcode reload slot global configuration command, or manually remove and insert the line card (to power it up) in the slot so that the GRP will recognize the line card and download the Cisco IOS software image to the line card.

exception core-file

To specify the name of the core dump file, use the exception core-file global configuration command. To return to the default core filename, use the no form of this command.

exception core-file name

no exception core-file

Syntax Description

name

Name of the core dump file saved on the server.

name	Name of the core dump file saved on the server.

exception dump

To configure the router to dump a core file to a particular server when the router crashes, use the exception dump global configuration command. To disable core dumps, use the no form of this command.

exception dump ip-address

no exception dump

Syntax Description

ip-address

IP address of the server that stores the core dump file.

ip-address	IP address of the server that stores the core dump file.

exception linecard

To enable storing of crash information for a line card and optionally specify the type and amount of information stored, use the exception linecard global configuration command. To disable the storing of crash information for the line card, use the no form of this command.

exception linecard {all | slot slot-number} [corefile filename | main-memory size [k | m] | queue-ram size [k | m] | rx-buffer size [k | m] | sqe-register-rx | sqe-register-tx | tx-buffer size [k | m]]

no exception linecard

Syntax Description

all

Stores crash information for all line cards.

slot slot- number

Stores crash information for the line card in the specified slot. Slot numbers range from 0 to 11 for the Cisco 12012 and 0 to 7 for the Cisco 12008.

corefile filename

(Optional) Stores the crash information in the specified file in NVRAM. The default file name is hostname-core-slot-number (for example, c12012-core-8).

main-memory size

(Optional) Stores the crash information for the main memory on the line card and specify the size of the crash information. Size of the memory to store is 0 to 268435456.

queue-ram size

(Optional) Stores the crash information for the queue RAM memory on the line card and specify the size of the crash information. Size of the memory to store can be from 0 to 1048576.

rx-buffer size

tx-buffer size

(Optional) Stores the crash information for the receive and transmit buffer on the line card and specify the size of the crash information. Size of the memory to store can be from 0 to 67108864.

sqe-register-rx

sqe-register-tx

(Optional) Stores crash information for the receive or transmit silicon queueing engine registers on the line card.

k

m

(Optional) The k option multiplies the specified size by 1K (1024), and the m option multiplies the specified size by 1M (1024*1024).

all	Stores crash information for all line cards.
slot slot- number	Stores crash information for the line card in the specified slot. Slot numbers range from 0 to 11 for the Cisco 12012 and 0 to 7 for the Cisco 12008.
corefile filename	(Optional) Stores the crash information in the specified file in NVRAM. The default file name is hostname-core-slot-number (for example, c12012-core-8).
main-memory size	(Optional) Stores the crash information for the main memory on the line card and specify the size of the crash information. Size of the memory to store is 0 to 268435456.
queue-ram size	(Optional) Stores the crash information for the queue RAM memory on the line card and specify the size of the crash information. Size of the memory to store can be from 0 to 1048576.
rx-buffer size tx-buffer size	(Optional) Stores the crash information for the receive and transmit buffer on the line card and specify the size of the crash information. Size of the memory to store can be from 0 to 67108864.
sqe-register-rx sqe-register-tx	(Optional) Stores crash information for the receive or transmit silicon queueing engine registers on the line card.
k m	(Optional) The k option multiplies the specified size by 1K (1024), and the m option multiplies the specified size by 1M (1024*1024).

exception memory

To cause the router to create a core dump and reboot when certain memory size parameters are violated, use the exception memory global configuration command. To disable the rebooting and core dump, use the no form of this command.

exception memory {fragment size | minimum size}

no exception memory {fragment | minimum}

Syntax Description

fragment size

The minimum contiguous block of memory in the free pool, in bytes.

minimum size

The minimum size of the free memory pool, in bytes.

fragment size	The minimum contiguous block of memory in the free pool, in bytes.
minimum size	The minimum size of the free memory pool, in bytes.

exception protocol

To configure the protocol used for core dumps, use the exception protocol global configuration command. To configure the router to use the default protocol, use the no form of this command.

exception protocol {ftp | rcp | tftp}

no exception protocol

Syntax Description

ftp

Use FTP for core dumps.

rcp

Use rcp for core dumps.

tftp

Use TFTP for core dumps. This is the default.

ftp	Use FTP for core dumps.
rcp	Use rcp for core dumps.
tftp	Use TFTP for core dumps. This is the default.

execute-on

To execute commands on a line card, use the execute-on privileged EXEC command.

execute-on {slot slot-number | all | master} command

Syntax Description

slot slot-number

Executes the command on the line card in the specified slot. Slot numbers can be chosen from the following ranges:

Cisco 12012: 0 to 11

Cisco 12008: 0 to 7

Cisco AS5800: 0 to 13

all

Executes the command on all line cards.

master

(AS5800 only) Executes the designated command on a Dial Shelf Controller (DSC). Do not use this option; it is used for technical support troubleshooting only.

command

Cisco IOS command to remotely execute on the line card.

slot slot-number	Executes the command on the line card in the specified slot. Slot numbers can be chosen from the following ranges: Cisco 12012: 0 to 11 Cisco 12008: 0 to 7 Cisco AS5800: 0 to 13
all	Executes the command on all line cards.
master	(AS5800 only) Executes the designated command on a Dial Shelf Controller (DSC). Do not use this option; it is used for technical support troubleshooting only.
command	Cisco IOS command to remotely execute on the line card.

logging

To log messages to a syslog server host, use the logging global configuration command. The no form of this command deletes the syslog server with the specified address from the list of syslogs.

logging host

no logging host

Syntax Description

host

Name or IP address of the host to be used as a syslog server.

host	Name or IP address of the host to be used as a syslog server.

logging buffered

To log messages to an internal buffer, use the logging buffered global configuration command. The no form of this command cancels the use of the buffer. The default form of this command returns the buffer size to the default size.

logging buffered [size]

no logging buffered

default logging buffered

Syntax Description

size

(Optional) Size of the buffer from 4096 to 4294967295 bytes. The default size varies by platform.

size	(Optional) Size of the buffer from 4096 to 4294967295 bytes. The default size varies by platform.

logging console

To limit messages logged to the console based on severity, use the logging console global configuration command. The no form of this command disables logging to the console terminal.

logging console level

no logging console

Syntax Description

level

Limits the logging of messages displayed on the console terminal to a specified level. See Table 55 for a list of the level arguments.

level	Limits the logging of messages displayed on the console terminal to a specified level. See Table 55 for a list of the level arguments.

logging facility

To configure the syslog facility in which error messages are sent, use the logging facility global configuration command. To revert to the default of local7, use the no form of this command.

logging facility facility-type

no logging facility

Syntax Description

facility-type

Syslog facility.

facility-type	Syslog facility.

log ging history

To limit syslog messages sent to the router's history table and the Simple Network Management Protocol network management station based on severity, use the logging history global configuration command. The no form of this command returns the logging of syslog messages to the default level.

logging history level

no logging history

Syntax Description

level

Limits the messages saved in the history table and sent to the SNMP network management station to the specified set of levels.

level	Limits the messages saved in the history table and sent to the SNMP network management station to the specified set of levels.

logging history size

To change the number of syslog messages stored in the router's history table, use the logging history size global configuration command. The no form of this command returns the number of messages to the default value.

logging history size number

no logging history size

Syntax Description

number

Number from 1 to 500 that indicates the maximum number of messages stored in the history table.

number	Number from 1 to 500 that indicates the maximum number of messages stored in the history table.

logging linecard

To log messages to an internal buffer on a line card, use the logging linecard global configuration command. To cancel the use of the internal buffer on the line cards, use the no form of this command.

logging linecard [size | message-level]

no logging linecard

Syntax Description

size

(Optional) Size of the buffer used for each line card. The range is 4096 to 65536 bytes. The default is 8 KB.

message-level

(Optional) Limits the logging of messages displayed on the console terminal to a specified level. The message level can be:

alerts---Immediate action needed

critical---Critical conditions

debugging---Debugging messages

emergencies---System is unusable

errors---Error conditions

informational---Informational messages

notifications---Normal but significant conditions

warnings---Warning conditions

size	(Optional) Size of the buffer used for each line card. The range is 4096 to 65536 bytes. The default is 8 KB.
message-level	(Optional) Limits the logging of messages displayed on the console terminal to a specified level. The message level can be: alerts---Immediate action needed critical---Critical conditions debugging---Debugging messages emergencies---System is unusable errors---Error conditions informational---Informational messages notifications---Normal but significant conditions warnings---Warning conditions

logging monitor

To limit messages logged to the terminal lines (monitors) based on severity, use the logging monitor global configuration command. This command limits the logging messages displayed on terminal lines other than the console line to messages with a level at or above the level argument. The no form of this command disables logging to terminal lines other than the console line.

logging monitor level

no logging monitor

Syntax Description

level

One of the level arguments listed in Table 13.

level	One of the level arguments listed in Table 13.

Table 13 lists the message levels and associated numerical level. For example, if you specify a message level of critical, all critical, alert, and emergency messages will be logged.

Table 13: Message Levels

Level Keyword Level Syslog Definition

emergencies

0

LOG_EMERG

alerts

1

LOG_ALERT

critical

2

LOG_CRIT

errors

3

LOG_ERR

warnings

4

LOG_WARNING

notifications

5

LOG_NOTICE

informational

6

LOG_INFO

debugging

7

LOG_DEBUG

Level Keyword	Level	Syslog Definition
emergencies	0	LOG_EMERG
alerts	1	LOG_ALERT
critical	2	LOG_CRIT
errors	3	LOG_ERR
warnings	4	LOG_WARNING
notifications	5	LOG_NOTICE
informational	6	LOG_INFO
debugging	7	LOG_DEBUG

logging on

To control logging of error messages, use the logging on global configuration command. This command sends debug or error messages to a logging process, which logs messages to designated locations asynchronously to the processes that generated the messages. The no form of this command disables the logging process.

logging on

no logging on

Syntax Description

This command has no arguments or keywords.

logging source-interface

To specify the source IP address of syslog packets, use the logging source-interface global configuration command. Use the no form of this command to remove the source designation.

logging source-interface type number

no logging source-interface

Syntax Description

type

Interface type.

number

Interface number.

type	Interface type.
number	Interface number.

logging synchronous

To synchronize unsolicited messages and debug output with solicited Cisco IOS software output and prompts for a specific console port line, auxiliary port line, or virtual terminal line, use the logging synchronous line configuration command. Use the no form of this command to disable synchronization of unsolicited messages and debug output.

logging synchronous [level severity-level | all] [limit number-of-buffers]

no logging synchronous [level severity-level | all] [limit number-of-buffers]

Syntax Description

level severity-level

(Optional) Specifies the message severity level. Messages with a severity level equal to or higher than this value are printed asynchronously. Low numbers indicate greater severity and high numbers indicate lesser severity. The default value is 2.

all

(Optional) Specifies that all messages are printed asynchronously, regardless of the severity level.

limit number-of-buffers

(Optional) Specifies the number of buffers to be queued for the terminal after which new messages are dropped. The default value is 20.

level severity-level	(Optional) Specifies the message severity level. Messages with a severity level equal to or higher than this value are printed asynchronously. Low numbers indicate greater severity and high numbers indicate lesser severity. The default value is 2.
all	(Optional) Specifies that all messages are printed asynchronously, regardless of the severity level.
limit number-of-buffers	(Optional) Specifies the number of buffers to be queued for the terminal after which new messages are dropped. The default value is 20.

logging trap

To limit messages logged to the syslog servers based on severity, use the logging trap global configuration command. The command limits the logging of error messages sent to syslog servers to only those messages at the specified level. Use the no form of this command to disable logging to syslog servers.

logging trap level

no logging trap

Syntax Description

level

One of the level arguments listed in Table 13.

level	One of the level arguments listed in Table 13.

ping (privile ged)

To diagnose basic network connectivity on Apollo, AppleTalk, Connectionless Network Service (CLNS), DECnet, IP, Novell IPX, VINES, or XNS networks, use the ping (packet internet groper) privileged EXEC command.

ping [protocol] {host | address}

Syntax Description

protocol

(Optional) Protocol keyword, one of apollo, appletalk, clns, decnet, ip, ipx, vines, or xns.

host

Host name of system to ping.

address

Address of system to ping.

protocol	(Optional) Protocol keyword, one of apollo, appletalk, clns, decnet, ip, ipx, vines, or xns.
host	Host name of system to ping.
address	Address of system to ping.

ping (user )

To diagnose basic network connectivity on AppleTalk, CLNS, IP, Novell, Apollo, VINES, DECnet, or XNS networks, use the ping (packet internet groper) user EXEC command.

ping [protocol] {host | address}

protocol	(Optional) Protocol keyword, one of apollo, appletalk, clns, decnet, ip, ipx, vines, or xns.
host	Host name of system to ping.
address	Address of system to ping.

service slave-log

To allow slave Versatile Interface Processor (VIP) cards to log important error messages to the console, use the service slave-log global configuration command. Use the no form of this command to disable slave logging.

service slave-log

no service slave-log

Syntax Description

This command has no arguments or keywords.

service tcp-keepalives-in

To generate keepalive packets on idle incoming network connections (initiated by the remote host), use the service tcp-keepalives-in global configuration command. The no form of this command with the appropriate keyword disables the keepalives.

service tcp-keepalives-in

no service tcp-keepalives-in

Syntax Description

This command has no arguments or keywords.

service tcp-keepalives-out

To generate keepalive packets on idle outgoing network connections (initiated by a user), use the service tcp-keepalives-out global configuration command. The no form of this command with the appropriate keyword disables the keepalives.

service tcp-keepalives-out

no service tcp-keepalives-out

Syntax Description

This command has no arguments or keywords.

service timestamps

To configure the system to time-stamp debugging or logging messages, use one of the service timestamps global configuration commands. Use the no form of this command to disable this service.

service timestamps type [uptime]

service timestamps type datetime [msec] [localtime] [show-timezone]

no service timestamps type

Syntax Description

type

Type of message to time stamp: debug or log.

uptime

(Optional) Time stamp with time since the system was rebooted.

datetime

Time stamp with the date and time.

msec

(Optional) Include milliseconds in the date and time stamp.

localtime

(Optional) Time stamp relative to the local time zone.

show-timezone

(Optional) Include the time zone name in the time stamp.

type	Type of message to time stamp: debug or log.
uptime	(Optional) Time stamp with time since the system was rebooted.
datetime	Time stamp with the date and time.
msec	(Optional) Include milliseconds in the date and time stamp.
localtime	(Optional) Time stamp relative to the local time zone.
show-timezone	(Optional) Include the time zone name in the time stamp.

show c2600 (Cisco 2600 series)

To display information for troubleshooting the Cisco 2600 series router, enter the show c2600 EXEC command.

Syntax Description

This command has no arguments or keywords.

show c7200 (Cisco 7200 series)

To display information about the CPU and midplane for Cisco 7200 series routers, use the show c7200 EXEC command.

show c7200

Syntax Description

This command has no arguments or keywords.

show context (2600)

To display information stored in NVRAM when an exception occurs, use the show context EXEC command.

show context

Syntax Description

This command has no arguments or keywords.

show context

To display information stored in NVRAM when the router crashes, use the show context EXEC command.

show context summary

show context {all | slot slot-number [crash-index] [all] [debug]}

Syntax Description

summary

Displays a summary of all the crashes recorded.

all

Displays all crashes for all the slots. When optionally used with the slot keyword, displays crash information for the specified slot.

slot slot-number [crash-index]

Displays information for a particular line card. Slot numbers range from 0 to 11 for the Cisco 12012 and 0 to 7 for the Cisco 12008. Index number allows you to look at previous crash contexts. Contexts from the last 24 line card crashes are saved on the GRP card. If the GRP reloads, the last 24 line card crash contexts are lost. For example, show context slot 3 2 shows the second most recent crash for line card in slot 3. Index numbers are displayed by the show context summary command

debug

(Optional) Displays crash information as hex record dump in addition to one of the options listed.

summary	Displays a summary of all the crashes recorded.
all	Displays all crashes for all the slots. When optionally used with the slot keyword, displays crash information for the specified slot.
slot slot-number [crash-index]	Displays information for a particular line card. Slot numbers range from 0 to 11 for the Cisco 12012 and 0 to 7 for the Cisco 12008. Index number allows you to look at previous crash contexts. Contexts from the last 24 line card crashes are saved on the GRP card. If the GRP reloads, the last 24 line card crash contexts are lost. For example, show context slot 3 2 shows the second most recent crash for line card in slot 3. Index numbers are displayed by the show context summary command
debug	(Optional) Displays crash information as hex record dump in addition to one of the options listed.

show controllers (GRP image)

To display information that is specific to the hardware, use the show controllers privileged EXEC command.

Syntax Description

atm number

(Optional) Displays the ATM controllers. Number is slot-number/ port-number (for example, 4/0). Slot numbers range from 0 to 11 for the Cisco 12012 and 0 to 7 for the Cisco 12008.

clock

(Optional) Displays the clock card configuration.

csar [register]

(Optional) Displays the Cisco Cell Segmentation and Reassembly (CSAR) information. CSAR is the name of the chip on the card that handles traffic between the GRP and the switch fabric interface ASICs.

csc-fpga

(Optional) Displays the clock and scheduler card register information in the field programmable gate array (FPGA).

dp83800

(Optional) Displays the Ethernet information on the GRP card.

fab-clk

(Optional) Display the switch fabric clock register information. The switch fabric clock FPGA is a chip that monitors the incoming fabric clock generated by the switch fabric. This clock is needed by each card connecting to the switch fabric to properly communicate with it. There are two switch fabric clocks arriving at each card; only one can be used. The FPGA monitors both clocks and selects which one to use if only one of them is running.

fia [register]

(Optional) Displays the fabric interface ASIC information and optionally display the register information.

pos [number] [details]

(Optional) Displays the POS framer state and optionally displays all the details for the interface. Number is slot-number/ port-number (for example, 4/0). Slot numbers range from 0 to 11 for the Cisco 12012 and 0 to 7 for the Cisco 12008.

queues [slot-number]

(Optional) Displays the SDRAM buffer carve information and optionally displays the information for a specific line card. The SDRAM buffer carve information displayed is suggested carve information from the GRP card to the line card. Line cards might change the shown percentages based on SDRAM available. Slot numbers range from 0 to 11 for the Cisco 12012 and 0 to 7 for the Cisco 12008.

sca

(Optional) Displays the SCA register information. The SCA is an ASIC that arbitrates among the line cards requests to use the switch fabric.

xbar

(Optional) Displays the crossbar register information. The XBAR is an ASIC that switches the data as it passes through the switch fabric.

atm number	(Optional) Displays the ATM controllers. Number is slot-number/ port-number (for example, 4/0). Slot numbers range from 0 to 11 for the Cisco 12012 and 0 to 7 for the Cisco 12008.
clock	(Optional) Displays the clock card configuration.
csar [register]	(Optional) Displays the Cisco Cell Segmentation and Reassembly (CSAR) information. CSAR is the name of the chip on the card that handles traffic between the GRP and the switch fabric interface ASICs.
csc-fpga	(Optional) Displays the clock and scheduler card register information in the field programmable gate array (FPGA).
dp83800	(Optional) Displays the Ethernet information on the GRP card.
fab-clk	(Optional) Display the switch fabric clock register information. The switch fabric clock FPGA is a chip that monitors the incoming fabric clock generated by the switch fabric. This clock is needed by each card connecting to the switch fabric to properly communicate with it. There are two switch fabric clocks arriving at each card; only one can be used. The FPGA monitors both clocks and selects which one to use if only one of them is running.
fia [register]	(Optional) Displays the fabric interface ASIC information and optionally display the register information.
pos [number] [details]	(Optional) Displays the POS framer state and optionally displays all the details for the interface. Number is slot-number/ port-number (for example, 4/0). Slot numbers range from 0 to 11 for the Cisco 12012 and 0 to 7 for the Cisco 12008.
queues [slot-number]	(Optional) Displays the SDRAM buffer carve information and optionally displays the information for a specific line card. The SDRAM buffer carve information displayed is suggested carve information from the GRP card to the line card. Line cards might change the shown percentages based on SDRAM available. Slot numbers range from 0 to 11 for the Cisco 12012 and 0 to 7 for the Cisco 12008.
sca	(Optional) Displays the SCA register information. The SCA is an ASIC that arbitrates among the line cards requests to use the switch fabric.
xbar	(Optional) Displays the crossbar register information. The XBAR is an ASIC that switches the data as it passes through the switch fabric.

show controllers (line card image)

To display information that is specific to the hardware on a line card, use the attach privileged EXEC command to connect to the line card and then use the show controllers privileged EXEC command or the execute-on privileged EXEC command.

show controllers atm [[port-number] [all | sar | summary]]

show controllers fia [register]

show controllers {frfab | tofab} {bma {microcode | ms-inst | register} | qelem start-queue-element [end-queue-element] | qnum start-queue-number [end-queue-number] | queues | statistics}

show controllers io

show controllers l3

show controllers pos {framers | queues | registers | rxsram port-number queue-start-address [queue-length] | txsram port-number queue-start-address [queue-length]}

Syntax Description

atm

Displays the ATM controller information.

port-number

(Optional)Displays request for the physical interface on the ATM card. The range of choices is 0-3.

all

(Optional) Lists all details.

sar

(Optional) Lists SAR interactive command.

summary

(Optional) Lists SAR status summary.

fia

Displays the fabric interface ASIC information.

register

(Optional) Displays the register information.

frfab

(Optional) Displays the from fabric (transmit).

tofab

(Optional) Displays the to fabric (receive) information.

bma

For the frfab or tofab keywords, displays microcode, micro-sequencer, or register information for the silicon queuing engine (SQE), also known as the buffer management ASIC (BMA).

microcode

Displays silicon queuing engine (SQE) information for the microcode bundled in the line card and currently running version.

mis-inst

Displays silicon queuing engine (SQE) information for the micro sequencer instruction.

register

Displays silicon queuing engine (SQE) information for the register.

qelem

For the frfab or tofab keywords, displays the SDRAM buffer pool queue element summary information.

start-queue-element

Specifies the start queue element number (0 to 65535).

end-queue-element

(Optional) Specifies the end queue element number (0 to 65535).

qnum

For the frfab or tofab keywords, displays the SDRAM buffer pool queue detail information.

start-queue-number

Specifies the start free queue number (0 to 127).

end-queue-number

(Optional) Specifies the end free queue number (0 to 127).

queues

For the frfab or tofab keywords, displays the SDRAM buffer pool information.

statistics

For the frfab or tofab keywords, displays the BMA counters.

io

Displays input/output registers.

l3

Displays Layer 3 ASIC information.

pos

Displays packet-over-sonic (POS) information for framer registers, framer queues, and ASIC registers.

framers

Displays the POS framer registers.

queues

Displays the POS framer queue information.

registers

Displays the ASIC registers.

rxsram

Displays the receive queue SRAM.

port-number

Specifies a port number (valid range is 0 to 3).

queue-start-address

Specifies the queue SRAM logica starting address.

queue-length

(Optional) Specifies the queue SRAM length.

txsram

Displays the transmit queue SRAM.

show controllers logging

To display logging information about a Versatile Interface Processor (VIP) card, use the show controllers logging privileged EXEC command.

show controllers vip slot-number logging

Syntax Description

vip slot-number

VIP slot number.

show controllers tech-support

To display general information about a Versatile Interface Processor (VIP) card when reporting a problem, use the show controllers tech-support privileged EXEC command.

show controllers vip slot-number tech-support

Syntax Description

vip slot-number

VIP slot number.

show debugging

To display information about the types of debugging that are enabled for your router, use the show debugging privileged EXEC command.

show debugging

Syntax Description

This command has no arguments or keywords.

show diag

To display hardware information including DRAM and Static RAM (SRAM) on the line cards, use the show diag privileged EXEC command.

show diag [slot-number] [details] [summary]

Syntax Description

slot-number

(Optional) Slot number of the interface.

details

(Optional) Displays more details than the normal show diag output.

summary

(Optional) Displays a summary (one line per slot) of the chassis.

show environment

To display temperature, voltage, and blower information on the Cisco 7000 series, Cisco 7200 series, Cisco 7500 series routers, and Cisco 12000 series Gigabit Switch Routers (GSRs), use the show environment privileged EXEC command.

Syntax Description

alarms

(Optional) Displays the alarm contact information.

all

(Optional) Displays a detailed listing of the power supplies, temperature readings, voltage readings, and blower speeds.

fans

(Optional) Displays blower and fan information.

hardware

(Optional) Displays hardware-specific information.

last

(Optional) Displays information on the last measurement made.

leds

(Optional) Displays the status of the MBus LEDs on the clock and scheduler cards and switch fabric cards.

power-supply

(Optional) Displays power supply voltage and current information.

table

(Optional) Displays the temperature, voltage, and blower thresholds.

temperature

(Optional) Displays temperature information.

voltages

(Optional) Displays voltage information.

show gsr

To display hardware information on the Cisco 12000 series Gigabit Switch Routers (GSRs), use the show gsr EXEC command.

show gsr [chassis-info [details]]

Syntax Description

chassis-info

(Optional) Displays backplane NVRAM information.

details

(Optional) In addition to the information displayed, this option includes hexadecimal output of the backplane NVRAM information.

show gt64010 (Cisco 7200 series)

To display all GT64010 internal registers and interrupt status on the Cisco 7200 series routers, use the show gt64010 EXEC command.

show gt64010

Syntax Description

This command has no arguments or keywords.

show logging

To display the state of logging (syslog), use the show logging privileged EXEC command.

show logging [history | slot slot-number | summary]

Syntax Description

history

(Optional) Displays information in the syslog history table only.

slot slot-number

(Optional) Displays information in the syslog history table for a specific line card. Slot numbers range from 0 to 11 for the Cisco 12012 and 0 to 7 for the Cisco 12008.

summary

(Optional) Displays counts of messages by type for each line card.

show memory

To show statistics about memory, including memory-free pool statistics, use the show memory EXEC command.

show memory [memory-type] [free] [summary]

Syntax Description

memory-type

(Optional) Memory type to display (processor, multibus, io, sram). If type is not specified, statistics for all memory types present are displayed.

free

(Optional) Displays free memory statistics.

summary

(Optional) Displays a summary of memory usage including the size and number of blocks allocated for each address of the system call that allocated the block.

show pci

To display information about the peripheral component interconnect (PCI) hardware registers or bridge registers for the Cisco 7200 series routers, use the show pci EXEC command.

show pci {hardware | bridge [register]}

Syntax Description

hardware

Displays PCI hardware registers.

bridge

Displays PCI bridge registers.

register

(Optional) Number of a specific bridge register in the range 0 to 7. If not specified, this command displays information about all registers.

show pci hardware

To display information about the Host-PCI bridge, use the show pci hardware EXEC command.

show pci hardware

Syntax Description

This command has no arguments or keywords.

show processes

To display information about the active processes, use the show processes EXEC command.

show processes [cpu]

Syntax Description

cpu

(Optional) Displays detailed CPU utilization statistics.

show processes memory

To show memory used, use the show processes memory EXEC command.

show processes memory

Syntax Description

This command has no arguments or keywords.

show protocols

To display the configured protocols, use the show protocols EXEC command.

This command shows the global and interface-specific status of any configured Level 3 protocol; for example, IP, DECnet, IPX, AppleTalk, and so on.

show protocols

Syntax Description

This command has no arguments or keywords.

show stacks

To monitor the stack usage of processes and interrupt routines, use the show stacks EXEC command.

show stacks

Syntax Description

This command has no arguments or keywords.

show subsys

To display the subsystem information, use the show subsys privileged EXEC command.

show subsys [class class | name name]

Syntax Description

class class

(Optional) Shows the subsystems of the specified class. Valid classes are driver, kernel, library, management, protocol, and registry.

name name

(Optional) Shows the specified subsystem. Use the asterisk character (*) as a wildcard at the end of the name to list all subsystems starting with the specified characters.

show tcp

To display the status of TCP connections, use the show tcp EXEC command.

show tcp [line-number]

Syntax Description

line-number

(Optional) Absolute line number of the line for which you want to display Telnet connection status.

show tcp brief

To display a concise description of TCP connection endpoints, use the show tcp brief EXEC command.

show tcp brief [all]

Syntax Description

all

(Optional) Displays status for all endpoints. Without this keyword, endpoints in the LISTEN state are not shown.

show tdm connections

To display a snapshot of the time-division multiplexing (TDM) bus connection memory in a Cisco AS5200 access server, use the show tdm connections EXEC command.

show tdm connections [motherboard | slot number]

Syntax Description

motherboard

(Optional) Motherboard in the Cisco AS5200 access server.

slot number

(Optional) Slot number.

show tdm data

To display a snapshot of the time-division multiplexing (TDM) bus data memory in a Cisco AS5200 access server, use the show tdm data EXEC command.

show tdm data [motherboard | slot number]

Syntax Description

motherboard

(Optional) Motherboard in the Cisco AS5200 access server.

slot number

(Optional) Slot number.

show tech-support

To display general information about the router when it reports a problem, use the show tech-support privileged EXEC command.

show tech-support [page] [password]

Syntax Description

page

(Optional) Causes the output to display a page of information at a time. Use the return key to display the next line of output or use the space bar to display the next page of information. If not used, the output scrolls (that is, does not stop for page breaks).

password

(Optional) Leaves passwords and other security information in the output. If not used, passwords and other security-sensitive information in the output are replaced with the label "<removed>" (this is the default).

test flash

To test Flash memory on MCI and envm Flash EPROM interfaces, use the test flash EXEC command.

test flash

Syntax Description

This command has no arguments or keywords.

test interfaces

To test the system interfaces on the modular router, use the test interfaces EXEC command.

test interfaces

Syntax Description

This command has no arguments or keywords.

test memory

To perform a test of Multibus memory (including nonvolatile memory) on the modular router, use the test memory EXEC command. The memory test overwrites memory.

test memory

Syntax Description

This command has no arguments or keywords.

trace (privileged)

To discover the routes that packets will actually take when traveling to their destination, use the trace privileged EXEC command.

trace [protocol] [destination]

Syntax Description

protocol

(Optional) Protocols that can be used are appletalk, clns, ip and vines.

destination

(Optional) Destination address or host name on the command line. The default parameters for the appropriate protocol are assumed and the tracing action begins.

trace (user)

To discover the IP routes that packets will actually take when traveling to their destination, use the trace EXEC command.

trace [protocol] [destination]

atm	Displays the ATM controller information.
port-number	(Optional)Displays request for the physical interface on the ATM card. The range of choices is 0-3.
all	(Optional) Lists all details.
sar	(Optional) Lists SAR interactive command.
summary	(Optional) Lists SAR status summary.
fia	Displays the fabric interface ASIC information.
register	(Optional) Displays the register information.
frfab	(Optional) Displays the from fabric (transmit).
tofab	(Optional) Displays the to fabric (receive) information.
bma	For the frfab or tofab keywords, displays microcode, micro-sequencer, or register information for the silicon queuing engine (SQE), also known as the buffer management ASIC (BMA).
microcode	Displays silicon queuing engine (SQE) information for the microcode bundled in the line card and currently running version.
mis-inst	Displays silicon queuing engine (SQE) information for the micro sequencer instruction.
register	Displays silicon queuing engine (SQE) information for the register.
qelem	For the frfab or tofab keywords, displays the SDRAM buffer pool queue element summary information.
start-queue-element	Specifies the start queue element number (0 to 65535).
end-queue-element	(Optional) Specifies the end queue element number (0 to 65535).
qnum	For the frfab or tofab keywords, displays the SDRAM buffer pool queue detail information.
start-queue-number	Specifies the start free queue number (0 to 127).
end-queue-number	(Optional) Specifies the end free queue number (0 to 127).
queues	For the frfab or tofab keywords, displays the SDRAM buffer pool information.
statistics	For the frfab or tofab keywords, displays the BMA counters.
io	Displays input/output registers.
l3	Displays Layer 3 ASIC information.
pos	Displays packet-over-sonic (POS) information for framer registers, framer queues, and ASIC registers.
framers	Displays the POS framer registers.
queues	Displays the POS framer queue information.
registers	Displays the ASIC registers.
rxsram	Displays the receive queue SRAM.
port-number	Specifies a port number (valid range is 0 to 3).
queue-start-address	Specifies the queue SRAM logica starting address.
queue-length	(Optional) Specifies the queue SRAM length.
txsram	Displays the transmit queue SRAM.

slot-number	(Optional) Slot number of the interface.
details	(Optional) Displays more details than the normal show diag output.
summary	(Optional) Displays a summary (one line per slot) of the chassis.

alarms	(Optional) Displays the alarm contact information.
all	(Optional) Displays a detailed listing of the power supplies, temperature readings, voltage readings, and blower speeds.
fans	(Optional) Displays blower and fan information.
hardware	(Optional) Displays hardware-specific information.
last	(Optional) Displays information on the last measurement made.
leds	(Optional) Displays the status of the MBus LEDs on the clock and scheduler cards and switch fabric cards.
power-supply	(Optional) Displays power supply voltage and current information.
table	(Optional) Displays the temperature, voltage, and blower thresholds.
temperature	(Optional) Displays temperature information.
voltages	(Optional) Displays voltage information.

chassis-info	(Optional) Displays backplane NVRAM information.
details	(Optional) In addition to the information displayed, this option includes hexadecimal output of the backplane NVRAM information.

history	(Optional) Displays information in the syslog history table only.
slot slot-number	(Optional) Displays information in the syslog history table for a specific line card. Slot numbers range from 0 to 11 for the Cisco 12012 and 0 to 7 for the Cisco 12008.
summary	(Optional) Displays counts of messages by type for each line card.

memory-type	(Optional) Memory type to display (processor, multibus, io, sram). If type is not specified, statistics for all memory types present are displayed.
free	(Optional) Displays free memory statistics.
summary	(Optional) Displays a summary of memory usage including the size and number of blocks allocated for each address of the system call that allocated the block.

hardware	Displays PCI hardware registers.
bridge	Displays PCI bridge registers.
register	(Optional) Number of a specific bridge register in the range 0 to 7. If not specified, this command displays information about all registers.

class class	(Optional) Shows the subsystems of the specified class. Valid classes are driver, kernel, library, management, protocol, and registry.
name name	(Optional) Shows the specified subsystem. Use the asterisk character (*) as a wildcard at the end of the name to list all subsystems starting with the specified characters.

motherboard	(Optional) Motherboard in the Cisco AS5200 access server.
slot number	(Optional) Slot number.

page	(Optional) Causes the output to display a page of information at a time. Use the return key to display the next line of output or use the space bar to display the next page of information. If not used, the output scrolls (that is, does not stop for page breaks).
password	(Optional) Leaves passwords and other security information in the output. If not used, passwords and other security-sensitive information in the output are replaced with the label "<removed>" (this is the default).

protocol	(Optional) Protocols that can be used are appletalk, clns, ip and vines.
destination	(Optional) Destination address or host name on the command line. The default parameters for the appropriate protocol are assumed and the tracing action begins.

Table of Contents

Troubleshooting Commands