Table Of Contents
Troubleshooting and Fault Management Commands
attach
clear logging
diag
exception core-file
exception dump
exception linecard
exception memory
exception protocol
exception region-size
exception spurious-interrupt
execute-on
logging
logging buffered
logging console
logging facility
logging history
logging history size
logging linecard
logging monitor
logging on
logging rate-limit
logging source-interface
logging synchronous
logging trap
ping (privileged)
ping (user)
service slave-log
service tcp-keepalives-in
service tcp-keepalives-out
service timestamps
show c2600 (2600)
show c7200 (7200)
show cls
show context (2600)
show context
show controllers (GRP image)
show controllers (line card image)
show controllers logging
show controllers tech-support
show debugging
show diag
show disk0:
show disk1:
show environment
show gsr
show gt64010 (7200)
show logging
show logging history
show memory
show memory allocating-process
show memory dead
show memory debug references
show memory debug unused
show memory ecc
show memory failures alloc
show memory fast
show memory multibus
show memory pci
show memory processor
show memory scan
show memory statistics history table
show memory transient
show pci
show pci hardware
show processes
show processes cpu
show processes memory
show protocols
show slot
show slot0:
show slot1:
show stacks
show subsys
show tcp
show tcp brief
show tdm connections
show tdm data
show tech-support
test flash
test interfaces
test memory
trace (privileged)
trace (user)
Troubleshooting and Fault Management Commands
Cisco IOS Release 12.2
This chapter describes the commands used to troubleshoot a routing device. To troubleshoot, you need to discover, isolate, and resolve the system problems. You can discover problems with the system monitoring commands, isolate problems with the system test commands (including debug commands), and resolve problems by reconfiguring your system with the suite of Cisco IOS software commands.
This chapter describes general fault management commands. For detailed troubleshooting procedures and a variety of scenarios, see the Cisco IOS Internetwork Troubleshooting Guide publication. For complete details on all debug commands, see the Cisco IOS Debug Command Reference.
For troubleshooting tasks and examples, refer to the "Troubleshooting and Fault Management" chapter in the Release 12.2 Cisco IOS Configuration Fundamentals Configuration Guide.
For documentation of commands in Cisco IOS Release 12.2T or 12.3 mainline, see the Cisco IOS Configuration Fundamentals and Network Management Command Reference, Release 12.3.
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 router and 0 to 7 for the Cisco 12008 router. If the slot number is omitted, you are prompted for the slot number.
|
Defaults
None
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.2 GS
|
This command was added to support the Cisco 12000 series Gigabit Switch Routers.
|
Usage Guidelines
You must first use the attach privileged EXEC command to access the Cisco IOS software image on a line card before using line card-specific show EXEC commands. Alternatively, you can use the execute-on privileged EXEC command to execute a show command on a specific line card.
After you connect to the Cisco IOS image on the line card using the attach command, the prompt changes to LC-Slotx#, where x is the slot number of the line card.
The commands executed on the line card use the Cisco IOS image on that line card.
You can also use the execute-on slot privileged EXEC command to execute commands on one or all line cards.
Note
Do not execute the config EXEC command from the Cisco IOS software image on the line card.
Examples
In the following example, the user connects to the Cisco IOS image running on the line card in slot 9, gets a list of valid show commands, and returns the Cisco IOS image running on the GRP:
Entering Console for 4 Port Packet Over SONET OC-3c/STM-1 in Slot: 9
Type exit to end this session
Press RETURN to get started!
cef Cisco Express Forwarding
clock Display the system clock
context Show context information about recent crash(s)
history Display the session command history
hosts IP domain-name, lookup style, nameservers, and host table
ipc Interprocess communications commands
location Display the system location
sessions Information about Telnet connections
terminal Display terminal configuration parameters
users Display information about terminal lines
version System hardware and software status
Disconnecting from slot 9.
Connection Duration: 00:01:04
Note
Because not all statistics are maintained on the line cards, the output from some of the show commands might not be consistent.
Related Commands
Command
|
Description
|
attach shelf
|
Connects you to a specific (managed) shelf for the purpose of remotely executing commands on that shelf only.
|
execute-on slot
|
Executes commands remotely on a specific line card, or on all line cards simultaneously.
|
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.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
Examples
In the following example, the logging buffer is cleared:
Clear logging buffer [confirm]
Related Commands
Command
|
Description
|
logging buffered
|
Logs messages to an internal buffer.
|
show logging
|
Displays the state of logging (syslog).
|
diag
To perform field diagnostics on a line card, on the Gigabit Route Processor (GRP), on the Switch Fabric Cards (SFCs), and on the Clock Scheduler Card (CSC) in Cisco 12000 series Gigabit Switch Routers (GSRs), 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 router. Slot numbers for the CSC are 16 and 17, and for the FSC are 18, 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 an 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 automatically reloaded on the line card after the test completes.
|
wait
|
(Optional) Stops the automatic reloading of the Cisco IOS software on the line card after the 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.
|
Defaults
No field diagnostics tests are performed on the line card.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.2 GS
|
This command was added to support the Cisco 12000 series GSR.
|
Usage Guidelines
The diag command must be executed from the GRP main console port.
Perform diagnostics on the CSC only if a redundant CSC is in the router.
Diagnostics will stop and ask you for confirmation before altering the router's configuration. For example, running diagnostics on a SFC or CSC will cause the fabric to go from full bandwidth to one-fourth bandwidth. Bandwidth is not affected by GRP or line card diagnostics.
The field diagnostic software image is bundled with the Cisco IOS software and is downloaded automatically from the GRP to the target line card prior to testing.
Caution 
Performing field diagnostics on a line card stops all activity on the line card. Before the
diag EXEC command begins running diagnostics, you are prompted to confirm the request to perform field diagnostics on the line card.
In normal mode, if a test fails, the title of the failed test is displayed on the console. However, not all tests that are performed are displayed. To view all the tests that are performed, use the verbose keyword.
After all diagnostic tests are completed on the line card, a PASSED or TEST FAILURE message is displayed. If the line card sends a PASSED message, the Cisco IOS software image on the line card is automatically reloaded unless the wait keyword is specified. If the line card sends a TEST FAILURE message, the Cisco IOS software image on the line card is not automatically reloaded.
If you want to reload the line card after it fails diagnostic testing, use the microcode reload slot global configuration command.
Note
When you stop the field diagnostic test, the line card remains down (that is, in an unbooted state). In most cases, you stopped the testing because you need to remove the line card or replace the line card. If that is not the case, and you want to bring the line card back up (that is, online), you must use the microcode reload global configuration command or power cycle the line card.
If the line card fails the test, the line card is defective and should be replaced. In future releases this might not be the case because DRAM and SDRAM SIMM modules might be field replaceable units. For example, if the DRAM test failed you might only need to replace the DRAM on the line card.
For more information, refer to the Cisco 12000 series installation and configuration guides.
Examples
In the following example, a user is shown the output when field diagnostics are performed on the line card in slot 3. After the line card passes all field diagnostic tests, the Cisco IOS software is automatically reloaded on the card. Before starting the diagnostic tests, you must confirm the request to perform these tests on the line card because all activity on the line card is halted. The total/indiv. timeout set to 600/220 sec. message indicates that 600 seconds are allowed to perform all field diagnostics tests, and that no single test should exceed 220 seconds to complete.
Running Diags will halt ALL activity on the requested slot. [confirm]
Launching a Field Diagnostic for slot 3
Running DIAG config check
RUNNING DIAG download to slot 3 (timeout set to 400 sec.)
sending cmd FDIAG-DO ALL to fdiag in slot 3
(total/indiv. timeout set to 600/220 sec.)
Field Diagnostic ****PASSED**** for slot 3
Field Diag eeprom values: run 159 fial mode 0 (PASS) slot 3
last test failed was 0, error code 0
sending SHUTDOWN FDIAG_QUIT to fdiag in slot 3
In the following example, a user is shown the output when field diagnostics are performed on the line card in slot 3 in verbose mode:
Running Diags will halt ALL activity on the requested slot. [confirm]
Launching a Field Diagnostic for slot 3
Running DIAG config check
RUNNING DIAG download to slot 3 (timeout set to 400 sec.)
sending cmd FDIAG-DO ALL to fdiag in slot 3
(total/indiv. timeout set to 600/220 sec.)
FDIAG_STAT_IN_PROGRESS: test #1 R5K Internal Cache
FDIAG_STAT_PASS test_num 1
FDIAG_STAT_IN_PROGRESS: test #2 Sunblock Ordering
FDIAG_STAT_PASS test_num 2
FDIAG_STAT_IN_PROGRESS: test #3 Dram Datapins
FDIAG_STAT_PASS test_num 3
Field Diags: FDIAG_STAT_DONE
Field Diagnostic ****PASSED**** for slot 3
Field Diag eeprom values: run 159 fial mode 0 (PASS) slot 3
last test failed was 0, error code 0
sending SHUTDOWN FDIAG_QUIT to fdiag in slot 3
Related Commands
Command
|
Description
|
microcode reload
|
Reloads the Cisco IOS image on a line card on the Cisco 7000 series with RSP7000, Cisco 7500 series, or Cisco 12000 series routers after all microcode configuration commands have been entered.
|
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 file-name
no exception core-file
Syntax Description
file-name
|
Name of the core dump file saved on the server.
|
Defaults
The core file is named hostname-core, where hostname is the name of the router.
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
10.2
|
This command was introduced.
|
Usage Guidelines
Caution 
Use the
exception commands only under the direction of a technical support representative. Creating a core dump while the router is functioning in a network can disrupt network operation. The resulting binary file, which is very large, must be transferred to a TFTP, File Transfer Protocol (FTP), or remote copy protocol (rcp) server and subsequently interpreted by technical personnel that have access to source code and detailed memory maps.
If you use TFTP to dump the core file to a server, the router will only dump the first 16 MB of the core file. If the router's memory is larger than 16 MB, the whole core file will not be copied to the server. Therefore, use rcp or FTP to dump the core file.
Examples
In the following example, a user configures a router to use FTP to dump a core file named dumpfile to the FTP server at 172.17.92.2 when it crashes:
exception dump 172.17.92.2
exception core-file dumpfile
Related Commands
Command
|
Description
|
exception dump
|
Causes the router to dump a core file to a particular server when the router crashes.
|
exception memory
|
Causes the router to create a core dump and reboot when certain memory size parameters are violated.
|
exception spurious-interrupt
|
Causes the router to create a core dump and reload after a specified number of spurious interrupts.
|
exception protocol
|
Configures the protocol used for core dumps.
|
ip ftp password
|
Specifies the password to be used for FTP connections.
|
ip ftp username
|
Configures the username for FTP connections.
|
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.
|
Defaults
Disabled
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
Usage Guidelines
Caution 
Use the
exception commands only under the direction of a technical support representative. Creating a core dump while the router is functioning in a network can disrupt network operation. The resulting binary file, which is very large, must be transferred to a TFTP, File Transfer Protocol (FTP), or remote copy protocol (rcp) server and subsequently interpreted by technical personnel that have access to source code and detailed memory maps.
If you use TFTP to dump the core file to a server, the router will only dump the first 16 MB of the core file. If the router's memory is larger than 16 MB, the whole core file will not be copied to the server. Therefore, use rcp or FTP to dump the core file.
The core dump is written to a file named hostname-core on your server, where hostname is the name of the router. You can change the name of the core file by configuring the exception core-file command.
This procedure can fail for certain types of system crashes. However, if successful, the core dump file will be the size of the memory available on the processor (for example, 16 MB for a CSC/4).
Examples
In the following example, a user configures a router to use FTP to dump a core file to the FTP server at 172.17.92.2 when it crashes:
exception dump 172.17.92.2
Related Commands
Command
|
Description
|
exception core-file
|
Specifies the name of the core dump file.
|
exception memory
|
Causes the router to create a core dump and reboot when certain memory size parameters are violated.
|
exception spurious-interrupt
|
Causes the router to create a core dump and reload after a specified number of spurious interrupts.
|
exception protocol
|
Configures the protocol used for core dumps.
|
ip ftp password
|
Specifies the password to be used for FTP connections.
|
ip ftp username
|
Configures the username for FTP connections.
|
ip rcmd remote-username
|
Configures the remote username to be used when requesting a remote copy using rcp.
|
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 router.
|
corefile filename
|
(Optional) Stores the crash information in the specified file in NVRAM. The default filename 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 specifies 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 specifies 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 specifies 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).
|
Defaults
No crash information is stored for the line card.
If enabled with no options, the default is to store 256 MB of main memory.
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
11.2 GS
|
This command was introduced.
|
Usage Guidelines
This command is currently supported only on Cisco 12000 series Gigabit Switch Routers (GSRs).
Use the exception linecard global configuration command only when directed by a technical support representative. Only enable options that the technical support representative requests you to enable. Technical support representatives need to be able to look at the crash information from the line card to troubleshoot serious problems on the line card. The crash information contains all the line card memory information including the main memory and transmit and receive buffer information.
Caution 
Use caution when enabling the
exception linecard global configuration command. Enabling all options could cause a large amount (150 to 250 MB) of crash information to be sent to the server.
Examples
In the following example, the user enables the storing of crash information for line card 8. By default, 256 MB of main memory is stored.
12000(config)# exception linecard slot 8
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.
|
Defaults
Disabled
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
Usage Guidelines
Caution 
Use the
exception commands only under the direction of a technical support representative. Creating a core dump while the router is functioning in a network can disrupt network operation. The resulting binary file, which is very large, must be transferred to a TFTP, File Transfer Protocol (FTP), or remote copy protocol (rcp) server and subsequently interpreted by technical personnel that have access to source code and detailed memory maps.
This command is useful to troubleshoot memory leaks.
The size is checked every 60 seconds. If you enter a size that is greater than the free memory, a core dump and router reload is generated after 60 seconds.
The exception dump command must be configured in order to generate a core dump file. If the exception dump command is not configured, the router reloads without generating a core dump.
Examples
In the following example, the user configures the router to monitor the free memory. If the amount of free memory falls below 250,000 bytes, the router will dump the core file and reload.
exception dump 131.108.92.2
exception core-file memory.overrun
exception memory minimum 250000
Related Commands
Command
|
Description
|
exception core-file
|
Specifies the name of the core dump file.
|
exception dump
|
Configures the router to dump a core file to a particular server when the router crashes.
|
exception protocol
|
Configures the protocol used for core dumps.
|
exception region-size
|
Specifies the size of the region for the exception-time memory pool.
|
ip ftp password
|
Specifies the password to be used for FTP connections.
|
ip ftp username
|
Configures the username for FTP connections.
|
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
|
Uses File Transfer Protocol (FTP) for core dumps.
|
rcp
|
Uses remote copy protocol (rcp) for core dumps.
|
tftp
|
Uses TFTP for core dumps. This is the default.
|
Defaults
TFTP
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
Usage Guidelines
Caution 
Use the
exception commands only under the direction of a technical support representative. Creating a core dump while the router is functioning in a network can disrupt network operation. The resulting binary file, which is very large, must be transferred to a TFTP, File Transfer Protocol (FTP), or remote copy protocol (rcp) server and subsequently interpreted by technical personnel that have access to source code and detailed memory maps.
If you use TFTP to dump the core file to a server, the router will only dump the first 16 MB of the core file. If the router's memory is larger than 16 MB, the whole core file will not be copied to the server. Therefore, use rcp or FTP to dump the core file.
Examples
In the following example, the user configures a router to use FTP to dump a core file to the FTP server at 172.17.92.2 when it crashes:
exception dump 172.17.92.2
Related Commands
Command
|
Description
|
exception core-file
|
Specifies the name of the core dump file.
|
exception dump
|
Causes the router to dump a core file to a particular server when the router crashes.
|
exception memory
|
Causes the router to create a core dump and reboot when certain memory size parameters are violated.
|
exception spurious-interrupt
|
Causes the router to create a core dump and reload after a specified number of spurious interrupts.
|
ip ftp password
|
Specifies the password to be used for FTP connections.
|
ip ftp username
|
Configures the username for FTP connections.
|
exception region-size
To specify the size of the region for the exception-time memory pool, use the exception region-size global configuration command. To use the default region size, use the no form of this command.
exception region-size size
no exception region-size
Syntax Description
size
|
The size of the region for the exception-time memory pool.
|
Defaults
16,384 bytes
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
Usage Guidelines
Caution 
Use the
exception commands only under the direction of a technical support representative. Creating a core dump while the router is functioning in a network can disrupt network operation. The resulting binary file, which is very large, must be transferred to a TFTP, File Transfer Protocol (FTP), or remote copy protocol (rcp) server and subsequently interpreted by technical personnel that have access to source code and detailed memory maps.
The exception region-size command is used to define a small amount of memory to serve as a fallback pool when the processor memory pool is marked corrupt. The exception memory command must be used to allocate memory to perform a core dump.
Examples
In the following example, the region size is set at 1024:
Router# exception region-size 1024
Related Commands
Command
|
Description
|
exception core-file
|
Specifies the name of the core dump file.
|
exception dump
|
Configures the router to dump a core file to a particular server when the router crashes.
|
exception memory
|
Causes the router to create a core dump and reboot when certain memory size parameters are violated.
|
exception protocol
|
Configures the protocol used for core dumps.
|
ip ftp password
|
Specifies the password to be used for FTP connections.
|
ip ftp username
|
Configures the username for FTP connections.
|
exception spurious-interrupt
To configure the router to create a core dump and reload after a specified number of spurious interrupts, use the exception spurious-interrupt command global configuration command. To disable the core dump and reload, use the no form of this command.
exception spurious-interrupt [number]
no exception spurious-interrupt
Syntax Description
number
|
(Optional) A number from 1 to 4294967295 that indicates the maximum number of spurious interrupts to include in the core dump before reloading.
|
Defaults
Disabled
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
Usage Guidelines
Caution 
Use the
exception commands only under the direction of a technical support representative. Creating a core dump while the router is functioning in a network can disrupt network operation. The resulting binary file, which is very large, must be transferred to a TFTP, File Transfer Protocol (FTP), or remote copy protocol (rcp) server and subsequently interpreted by technical personnel that have access to source code and detailed memory maps.
If you use TFTP to dump the core dump file to a server, the router will only dump the first 16 MB of the file. If the router's memory is larger than 16 MB, the whole core file will not be copied to the server. Therefore, use rcp or FTP to dump the core file.
Examples
In the following example, the user configures a router to create a core dump with a limit of two spurious interrupts:
Router# exception spurious-interrupt 2
Related Commands
Command
|
Description
|
exception core-file
|
Specifies the name of the core dump file.
|
ip ftp password
|
Specifies the password to be used for FTP connections.
|
ip ftp username
|
Configures the user name for FTP connections.
|
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 router: 0 to 11
• Cisco 12008 access server: 0 to 7
• Cisco AS5800 access server: 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.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.2 GS
|
This command was introduced to support Cisco 12000 series Gigabit Switch Routers.
|
11.3(2)AA
|
Support for this command was added to the Cisco AS5800 universal access server.
|
Usage Guidelines
Use this command to execute a command on one or all line cards to monitor and maintain information on one or more line cards (for example, a line card in a specified slot on a dial shelf). This allows you to issue commands remotely; that is, to issue commands without needing to log in to the line card directly. The all form of the command allows you to issue commands to all the line cards without having to log in to each in turn.
Though this command does not have a no form, note that it is possible to use the no form of the remotely executed commands used in this command.
Tip
This command is useful when used with show EXEC commands (such as show version), because you can verify and troubleshoot the features found only on a specific line card. Please note, however, that because not all statistics are maintained on the line cards, the output from some of the show commands might not be consistent.
Cisco 12000 GSR Guidelines and Restrictions
You can use the execute-on privileged EXEC command only from Cisco IOS software running on the GRP card.
Timesaver
Though you can use the attach privileged EXEC command to execute commands on a specific line card, using the execute-on slot command saves you some steps. For example, first you must use the attach command to connect to the Cisco IOS software running on the line card. Next you must issue the command. Finally you must disconnect from the line card to return to the Cisco IOS software running on the GRP card. With the execute-on slot command, you can perform three steps with one command. In addition, the execute-on all command allows you to perform the same command on all line cards simultaneously.
Cisco AS5800 Guidelines and Restrictions
The purpose of the command is to conveniently enable certain commands to be remotely executed on the dial shelf cards from the router without connecting to each line card. This is the recommended procedure, because it avoids the possibility of adversely affecting a good configuration of a line card in the process. The execute-on command does not give access to every Cisco IOS command available on the Cisco AS5800 access server. In general, the purpose of the execute-on command is to provide access to statistical reports from line cards without directly connecting to the dial shelf line cards.
Warning
Do not use this command to change configurations on dial shelf cards, because such changes will not be reflected in the router shelf.
Using this command makes it possible to accumulate inputs for inclusion in the show tech-support command.
The master form of the command can run a designated command remotely on the router from the DSC card. However, using the console on the DSC is not recommended. It is used for technical support troubleshooting only.
The show tech-support command for each dial shelf card is bundled into the router shelf's show tech-support command via the execute-on facility.
The execute-on command also support interactive commands such as the following:
router: execute-on slave slot slot ping
The execute-on command has the same limitations and restrictions as a vty telnet client has; that is, it cannot reload DSC using the following command:
router: execute-on slave slot slot reload
You can use the execute-on command to enable remote execution of the commands included in the following partial list:
•
debug dsc clock
•
show context
•
show diag
•
show environment
•
show dsc clock
•
show dsi
•
show dsip
•
show tech-support
Examples
In the following example, the user executes the show controllers command on the line card in slot 4 of a Cisco 12000 series GSR:
Router# execute-on slot 4 show controllers
========= Line Card (Slot 4) =======
lcpos_instance struct 6033A6E0
RX POS ASIC addr space 12000000
TX POS ASIC addr space 12000100
SUNI framer addr space 12000400
CRC16 enabled, HDLC enc, int clock
lcpos_instance struct 6033CEC0
RX POS ASIC addr space 12000000
TX POS ASIC addr space 12000100
SUNI framer addr space 12000600
CRC32 enabled, HDLC enc, int clock
lcpos_instance struct 6033F6A0
RX POS ASIC addr space 12000000
TX POS ASIC addr space 12000100
SUNI framer addr space 12000800
CRC32 enabled, HDLC enc, int clock
lcpos_instance struct 60341E80
RX POS ASIC addr space 12000000
TX POS ASIC addr space 12000100
SUNI framer addr space 12000A00
CRC32 enabled, HDLC enc, ext clock
Related Commands
Command
|
Description
|
attach
|
Connects you to a specific line card for the purpose of executing commands using the Cisco IOS software image on that line card.
|
logging
To log messages to a syslog server host, use the logging global configuration command. To delete the syslog server with the specified address from the list of syslogs, use the no form of this command.
logging host-name
no logging host-name
Syntax Description
host-name
|
Name or IP address of the host to be used as a syslog server.
|
Defaults
No messages are logged to a syslog server host.
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
This command identifies a syslog server host to receive logging messages. By issuing this command more than once, you build a list of syslog servers that receive logging messages.
Examples
In the following example, messages are logged to a host named john:
Related Commands
Command
|
Description
|
logging trap
|
Limits messages logged to the syslog servers based on severity and limits the logging of system messages sent to syslog servers to only those messages at the specified level.
|
logging buffered
To limit messages logged to an internal buffer based on severity, use the logging buffered global configuration command. To cancel the use of the buffer, use the no form of this command. The default form of this command returns the buffer size to the default size.
logging buffered [buffer-size | level]
no logging buffered
default logging buffered
Syntax Description
buffer-size
|
(Optional) Size of the buffer from 4096 to 4,294,967,295 bytes. The default size varies by platform.
|
level
|
(Optional) Limits the logging of messages to the buffer to a specified level. You can enter the level name or level number. See Table 55 for a list of the accepatable level name or level number keywords.
|
Defaults
For most platforms, the Cisco IOS software logs messages to the internal buffer.
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
11.1(17)T
|
The command syntax was changed to include the level argument.
|
Usage Guidelines
This command copies logging messages to an internal buffer. The buffer is circular in nature, so newer messages overwrite older messages after the buffer is filled.
Specifying a level causes messages at that level and numerically lower levels to be logged in an internal buffer. See Table 55 for a list of level arguments.
Do not make the buffer size too large because the router could run out of memory for other tasks. You can use the show memory EXEC command to view the free processor memory on the router; however, this is the maximum available and should not be approached. The default logging buffered command resets the buffer size to the default for the platform.
To display the messages that are logged in the buffer, use the show logging EXEC command. The first message displayed is the oldest message in the buffer.
The show logging EXEC command displays the addresses and levels associated with the current logging setup, and any other logging statistics.
Table 55 System Message Logging Priorities and Corresponding Level Names/Numbers
Level Name
|
Level Number
|
Description
|
Syslog Definition
|
emergencies
|
0
|
System unusable
|
LOG_EMERG
|
alerts
|
1
|
Immediate action needed
|
LOG_ALERT
|
critical
|
2
|
Critical conditions
|
LOG_CRIT
|
errors
|
3
|
Error conditions
|
LOG_ERR
|
warnings
|
4
|
Warning conditions
|
LOG_WARNING
|
notifications
|
5
|
Normal but significant condition
|
LOG_NOTICE
|
informational
|
6
|
Informational messages only
|
LOG_INFO
|
debugging
|
7
|
Debugging messages
|
LOG_DEBUG
|
Examples
In the following example, the user enables logging to an internal buffer:
Related Commands
Command
|
Description
|
clear logging
|
Clears messages from the logging buffer.
|
show logging
|
Displays the state of logging (syslog).
|
logging console
To limit messages logged to the console based on severity, use the logging console global configuration command. To disable logging to the console terminal, use the no form of this command.
logging console level
no logging console
Syntax Description
level
|
Limits the logging of messages displayed on the console terminal to a specified level. You can enter the level number or level name. See Table 56 for a list of the level arguments.
|
Defaults
debugging
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
Specifying a level causes messages at that level and numerically lower levels to be displayed at the console terminal.
The show logging EXEC command displays the addresses and levels associated with the current logging setup, and any other logging statistics. See Table 56.
Table 56 System Message Logging Priorities and Corresponding Level Names/Numbers
Level Arguments
|
Level
|
Description
|
Syslog Definition
|
emergencies
|
0
|
System unusable
|
LOG_EMERG
|
alerts
|
1
|
Immediate action needed
|
LOG_ALERT
|
critical
|
2
|
Critical conditions
|
LOG_CRIT
|
errors
|
3
|
Error conditions
|
LOG_ERR
|
warnings
|
4
|
Warning conditions
|
LOG_WARNING
|
notifications
|
5
|
Normal but significant condition
|
LOG_NOTICE
|
informational
|
6
|
Informational messages only
|
LOG_INFO
|
debugging
|
7
|
Debugging messages
|
LOG_DEBUG
|
The effect of the log keyword with the IP access list (extended) interface configuration command depends on the setting of the logging console command. The log keyword takes effect only if the logging console level is set to 6 or 7. If you change the default to a level lower than 6 and specify the log keyword with the IP access list (extended) command, no information is logged or displayed.
Examples
In the following example, the user changes the level of messages displayed to the console terminal to alerts, which means alerts and emergencies are displayed:
Related Commands
Command
|
Description
|
access-list (extended)
|
Defines an extended XNS access list.
|
logging facility
|
Configures the syslog facility in which system messages are sent.
|
logging facility
To configure the syslog facility in which system 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. See the Usage Guidelines section of this command reference entry for descriptions of acceptable keywords.
|
Defaults
local7
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
Table 57 describes the acceptable keywords for the facility-type argument.
Table 57 logging facility facility-type Argument
Facility-type keyword
|
Description
|
auth
|
Authorization system
|
cron
|
Cron facility
|
daemon
|
System daemon
|
kern
|
Kernel
|
local0-7
|
Reserved for locally defined messages
|
lpr
|
Line printer system
|
mail
|
Mail system
|
news
|
USENET news
|
sys9
|
System use
|
sys10
|
System use
|
sys11
|
System use
|
sys12
|
System use
|
sys13
|
System use
|
sys14
|
System use
|
syslog
|
System log
|
user
|
User process
|
uucp
|
UNIX-to-UNIX copy system
|
Examples
In the following example, the user configures the syslog facility to the kernel facility type:
Related Commands
Command
|
Description
|
logging console
|
Limits messages logged to the console based on severity.
|
logging history
To limit syslog messages sent to the router's history table and the Simple Network Management Protocol (SNMP) network management station based on severity, use the logging history global configuration command. To return the logging of syslog messages to the default level, use the no form of this command with the previously configured severity level argument.
logging history [severity-level-name | severity-level-number]
no logging history [severity-level-name | severity-level-number]
Syntax Description
severity-level-name
|
Name of the severity level. Specifies the lowest severity level for system error messag logging. See the Usage Guidelines section of this command for available keywords.
|
severity-level-number
|
Number of the severity level. Specifies the lowest severity level for system error messag logging. See the Usage Guidelines section of this command for available keywords.
|
Defaults
Logging of system messages of severity levels 0 through 4 (emergency, alert, critical, error, and warning levels); in other words, "saving level warnings or higher"
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
Usage Guidelines
Sending syslog messages to the SNMP network management station occurs when you enable syslog traps with the snmp-server enable traps global configuration command. Because SNMP traps are inherently unreliable and much too important to lose, at least one syslog message, the most recent message, is stored in a history table on the router. The history table, which contains table size, message status, and message text data, can be viewed using the show logging history command. The number of messages stored in the table is governed by the logging history size EXEC command.
Severity levels are numbered 0 through 7, with 0 being the highest severity level and 7 being the lowest severity level (that is, the lower the number, the more critical the message). Specifying a level causes messages at that severity level and numerically lower levels to be stored in the router's history table and sent to the SNMP network management station. For example, specifying the level critical causes messages as the critical (3), alert (2), and emergency (1) levles to be saved to the logging history table.
Table 58 provides a description of logging severity levels, listed from higest severity to lowest severity, and the arguments used inthe logging history command syntax. Note that you can use the level name or the level number as the level argument in this command.
Table 58 System Logging Message Severity Levels
Severity Level Name
|
Severity Level Number
|
Description
|
Syslog Definition
|
emergencies
|
0
|
System unusable
|
LOG_EMERG
|
alerts
|
1
|
Immediate action needed
|
LOG_ALERT
|
critical
|
2
|
Critical conditions
|
LOG_CRIT
|
errors
|
3
|
Error conditions
|
LOG_ERR
|
warnings
|
4
|
Warning conditions
|
LOG_WARNING
|
notifications
|
5
|
Normal but significant condition
|
LOG_NOTICE
|
informational
|
6
|
Informational messages only
|
LOG_INFO
|
debugging
|
7
|
Debugging messages
|
LOG_DEBUG
|
Examples
In the following example, the system is initially configured to the default of saving severity level 4 or higher. The logging history1 command is used to configure the system to save only level 1 (alert) and level 0 (emergency) messages to the logging history table. The configuration is then confirmed using the show logging history command.
Router#show logging history
Syslog History Table:10 maximum table entries,
! The following line shows that system-error-message-logging is set to the
! default level of "warnings" (4).
saving level warnings or higher
23 messages ignored, 0 dropped, 0 recursion drops
SNMP notifications not enabled
entry number 2 : LINK-3-UPDOWN
Interface FastEthernet0, changed state to up
Router#configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)#logging history 1
4w0d: %SYS-5-CONFIG_I: Configured from console by console
Router#show logging history
Syslog History Table:1 maximum table entries,
! The following line indicates that `logging history level 1' is configured.
saving level alerts or higher
18 messages ignored, 0 dropped, 0 recursion drops
SNMP notifications not enabled
entry number 2 : LINK-3-UPDOWN
Interface FastEthernet0, changed state to up
Related Commands
Command
|
Description
|
logging on
|
Controls (enables or disables) the logging of system messages.
|
logging history size
|
Changes the number of syslog messages stored in the router's history table.
|
show logging
|
Displays the state of logging (syslog).
|
show logging history
|
Displays the state of logging history.
|
snmp-server host
|
Specifies the recipient of an SNMP notification operation.
|
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. To return the number of messages to the default value, use the no form of this command.
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.
|
Defaults
One message
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
Usage Guidelines
When the history table is full (that is, it contains the maximum number of message entries specified with the logging history size command), the oldest message entry is deleted from the table to allow the new message entry to be stored.
Examples
In the following example, the user sets the number of messages stored in the history table to 20:
Related Commands
Command
|
Description
|
logging history
|
Limits syslog messages sent to the router's history table and the SNMP network management station based on severity.
|
show logging
|
Displays the state of logging (syslog).
|
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 | level]
no logging linecard
Syntax Description
size
|
(Optional) Size of the buffer used for each line card. The range is from 4096 to 65,536 bytes. The default is 8 KB.
|
level
|
(Optional) Limits the logging of messages displayed on the console terminal to a specified level. The message level can be one of the following:
• 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
|
Defaults
The Cisco IOS software logs messages to the internal buffer on the GRP card.
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
11.2 GS
|
This command was added to support the Cisco 12000 series Gigabit Switch Routers.
|
Usage Guidelines
Specifying a message level causes messages at that level and numerically lower levels to be stored in the internal buffer on the line cards.
Table 59 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 59 Message Levels
Level Keyword
|
Level
|
emergencies
|
0
|
alerts
|
1
|
critical
|
2
|
errors
|
3
|
warnings
|
4
|
notifications
|
5
|
informational
|
6
|
debugging
|
7
|
To display the messages that are logged in the buffer, use the show logging slot EXEC command. The first message displayed is the oldest message in the buffer.
Do not make the buffer size too large because the router could run out of memory for other tasks. You can use the show memory EXEC command to view the free processor memory on the router; however, this is the maximum available and should not be approached.
Examples
The following example enables logging to an internal buffer on the line cards using the default buffer size and logging warning, error, critical, alert, and emergency messages:
(config)# logging linecard warnings
Related Commands
Command
|
Description
|
clear logging
|
Clears messages from the logging buffer.
|
show logging
|
Displays the state of logging (syslog).
|
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. To disable logging to terminal lines other than the console line, use the no form of this command.
logging monitor severity-level
no logging monitor
Syntax Description
severity-level
|
Limits the logging of messages logged to the terminal lines (monitors) to a specified level. You can enter the level number or level name. See the Usage Guidelines section for a list of acceptable severity-level keywords.
|
Defaults
debugging (severity-level 7)
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
Specifying a level causes messages at that level and numerically lower levels to be displayed to the monitor.
Table 60 logging monitor System Message Logging Priorities
Level Name
|
Level Number
|
Description
|
Syslog Definition
|
emergencies
|
0
|
System unusable
|
LOG_EMERG
|
alerts
|
1
|
Immediate action needed
|
LOG_ALERT
|
critical
|
2
|
Critical conditions
|
LOG_CRIT
|
errors
|
3
|
Error conditions
|
LOG_ERR
|
warnings
|
4
|
Warning conditions
|
LOG_WARNING
|
notifications
|
5
|
Normal but significant conditions
|
LOG_NOTICE
|
informational
|
6
|
Informational messages only
|
LOG_INFO
|
debugging
|
7
|
Debugging messages
|
LOG_DEBUG
|
Examples
In the following example, the user specifies that only messages of the levels errors, critical, alerts, and emergencies be displayed on terminals:
Related Commands
Command
|
Description
|
terminal monitor
|
Enables the display of system messages to the terminal connection.
|
logging on
To control logging of system messages (including error messages or debugging messages), use the logging on global configuration command. This command sends system messages to a logging process, which logs messages to designated locations asynchronously to the processes that generated the messages. To disable the logging process, use the no form of this command.
logging on
no logging on
Syntax Description
This command has no arguments or keywords.
Defaults
The Cisco IOS software sends messages to the asynchronous logging process.
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
The logging process controls the distribution of logging messages to the various destinations, such as the logging buffer, terminal lines, or syslog server. You can turn logging on and off for these destinations individually using the logging buffered, logging monitor, and logging global configuration commands. However, if the logging on command is disabled, no messages will be sent to these destinations. Only the console will receive messages.
Additionally, the logging process logs messages to the console and the various destinations after the processes that generated them have completed. When the logging process is disabled, messages are displayed on the console as soon as they are produced, often appearing in the middle of command output.
Caution 
Disabling the logging on command will substantially slow down the router. Any process generating system messages will wait until the messages have been displayed on the console before continuing.
The logging synchronous line configuration command also affects the displaying of messages to the console. When the logging synchronous command is enabled, messages will appear only after the user types a carriage return.
Examples
The following example shows command output and message output when logging is enabled. The ping process finishes before any of the logging information is printed to the console (or any other destination).
Router(config)# logging on
%SYS-5-CONFIG_I: Configured from console by console
Type escape sequence to abort.
Sending 5, 100-byte ICMP Echos to 172.16.1.129, timeout is 2 seconds:
Success rate is 100 percent (5/5), round-trip min/avg/max = 4/5/8 ms
IP: s=172.21.96.41 (local), d=172.16.1.129 (Ethernet1/0), len 100, sending
IP: s=171.69.1.129 (Ethernet1/0), d=172.21.96.41, len 114, rcvd 1
IP: s=172.21.96.41 (local), d=172.16.1.129 (Ethernet1/0), len 100, sending
IP: s=171.69.1.129 (Ethernet1/0), d=172.21.96.41, len 114, rcvd 1
IP: s=172.21.96.41 (local), d=172.16.1.129 (Ethernet1/0), len 100, sending
IP: s=171.69.1.129 (Ethernet1/0), d=172.21.96.41, len 114, rcvd 1
IP: s=172.21.96.41 (local), d=172.16.1.129 (Ethernet1/0), len 100, sending
IP: s=171.69.1.129 (Ethernet1/0), d=172.21.96.41, len 114, rcvd 1
IP: s=172.21.96.41 (local), d=172.16.1.129 (Ethernet1/0), len 100, sending
IP: s=171.69.1.129 (Ethernet1/0), d=172.21.96.41, len 114, rcvd 1
In the following example, logging is disabled. The message output is displayed as messages are generated, causing the debug messages to be interspersed with the message "Type escape sequence to abort."
Router(config)# no logging on
%SYS-5-CONFIG_I: Configured from console by console
IP: s=172.21.96.41 (local), d=172.16.1.129 (Ethernet1/0), len 100, sendingTyp
IP: s=171.69.1.129 (Ethernet1/0), d=172.21.96.41, len 114, rcvd 1e
IP: s=172.21.96.41 (local), d=172.16.1.129 (Ethernet1/0), len 100, sending esc
IP: s=171.69.1.129 (Ethernet1/0), d=172.21.96.41, len 114, rcvd 1
IP: s=172.21.96.41 (local), d=172.16.1.129 (Ethernet1/0), len 100, sendingape
IP: s=171.69.1.129 (Ethernet1/0), d=172.21.96.41, len 114, rcvd 1
IP: s=172.21.96.41 (local), d=172.16.1.129 (Ethernet1/0), len 100, sendingse
IP: s=171.69.1.129 (Ethernet1/0), d=172.21.96.41, len 114, rcvd 1
IP: s=172.21.96.41 (local), d=172.16.1.129 (Ethernet1/0), len 100, sendingquen
IP: s=171.69.1.129 (Ethernet1/0), d=172.21.96.41, len 114, rcvd 1ce to abort.
Sending 5, 100-byte ICMP Echos to 172.16.1.129, timeout is 2 seconds:
Success rate is 100 percent (5/5), round-trip min/avg/max = 152/152/156 ms
Related Commands
Command
|
Description
|
logging
|
Logs messages to a syslog server host.
|
logging buffered
|
Logs messages to an internal buffer.
|
logging monitor
|
Limits messages logged to the terminal lines (monitors) based on severity.
|
logging synchronous
|
Synchronizes unsolicited messages and debug output with solicited Cisco IOS software output and prompts for a specific console port line, auxiliary port line, or vty.
|
logging rate-limit
To limit the rate of messages logged per second, use the logging rate-limit command in global configuration mode. To disable the limit, use the no form of this command.
logging rate-limit {number | all number | console {number | all number}} [except severity]
no logging rate-limit
Syntax Description
number
|
Maximum number of messages logged per second. The valid values are from 1 to 10000.
|
all
|
Sets the rate limit for all error and debug messages displayed at the console and printer.
|
console
|
Sets the rate limit for error and debug messages displayed at the console.
|
except
|
(Optional) Excludes messages of this severity level or lower.
Severity decreases as the number increases. So, severity level 1 is a more serious problem than severity level 3.
|
severity
|
(Optional) Sets the logging severity level. The valid levels are from 0 to 7.
|
Command Default
The default for this command is 10 messages logged per second and exclusion of messages of the errors level or lower.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.1(3)T
|
This command was introduced.
|
12.2
|
This command was integrated in Cisco IOS Release 12.2.
|
12.3
|
This command was integrated in Cisco IOS Release 12.3.
|
12.3T
|
This command was integrated in Cisco IOS Release 12.3T.
|
12.4
|
This command was integrated in Cisco IOS Release 12.4.
|
12.4T
|
This command was integrated in Cisco IOS Release 12.4T.
|
Usage Guidelines
The logging rate-limit command controls the output of messages from the system. Use this command if you want to avoid a flood of output messages. You can select the severity of the output messages and output rate by using the logging rate-limit command. You can use the logging rate-limit command anytime; it will not negatively impact the performance of your system and may improve the system performance by specifying the severities and rates of output messages.
You can use this command with or without the logging synchronous line configuration command. For example, if you want to see all severity 0, 1, and 2 messages, use the no logging synchronous command and specify logging rate-limit 10 except 2. By using the two commands together, you cause all messages of 0, 1, and 2 severity to print and limit the less severe ones (lower than 2) to only 10 per second.
Table 61 compares the error message logging numeric severity level with its equivalent word description.
Table 61 Error Message Logging Severity Level and Equivalent Word Descriptions
Numeric Severity Level
|
Equivalent Word
|
Description
|
0
|
emergencies
|
System unusable
|
1
|
alerts
|
Immediate action needed
|
2
|
critical
|
Critical conditions
|
3
|
errors
|
Error conditions
|
4
|
warnings
|
Warning conditions
|
5
|
notifications
|
Normal but significant condition
|
6
|
informational
|
Informational messages only
|
7
|
debugging
|
Debugging messages
|
Examples
In the following example, the logging rate-limit configuration mode command limits message output to 200 per second:
Router(config)# logging rate-limit 200
Related Commands
Command
|
Description
|
logging synchronous
|
Synchronizes unsolicited messages and debug output with solicited Cisco IOS software output and prompts for a specific console port line, auxiliary port line, or vty.
|
logging source-interface
To specify the source IP address of syslog packets, use the logging source-interface global configuration command. To remove the source designation, use the no form of this command.
logging source-interface interface-type interface-number
no logging source-interface
Syntax Description
interface-type
|
Interface type.
|
interface-number
|
Interface number.
|
Defaults
No interface is specified.
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
Normally, a syslog message contains the IP address of the interface it uses to leave the router. The logging source-interface command specifies that syslog packets contain the IP address of a particular interface, regardless of which interface the packet uses to exit the router.
Examples
In the following example, the user specifies that the IP address for Ethernet interface 0 is the source IP address for all syslog messages:
logging source-interface ethernet 0
The following example specifies that the IP address for Ethernet interface 2/1 on a Cisco 7000 series router is the source IP address for all syslog messages:
logging source-interface ethernet 2/1
Related Commands
Command
|
Description
|
logging
|
Logs messages to a syslog server host.
|
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 vty, use the logging synchronous line configuration command. To disable synchronization of unsolicited messages and debug output, use the no form of this command.
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.
|
Defaults
This feature is turned off by default.
If you do not specify a severity level, the default value of 2 is assumed.
If you do not specify the maximum number of buffers to be queued, the default value of 20 is assumed.
Command Modes
Line configuration
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
When synchronous logging of unsolicited messages and debug output is turned on, unsolicited Cisco IOS software output is displayed on the console or printed after solicited Cisco IOS software output is displayed or printed. Unsolicited messages and debug output is displayed on the console after the prompt for user input is returned. To keep unsolicited messages and debug output from being interspersed with solicited software output and prompts. After the unsolicited messages are displayed, the console displays the user prompt again.
When specifying a severity level number, consider that for the logging system, low numbers indicate greater severity and high numbers indicate lesser severity.
When a message queue limit of a terminal line is reached, new messages are dropped from the line, although these messages might be displayed on other lines. If messages are dropped, the notice "%SYS-3-MSGLOST number-of-messages due to overflow" follows any messages that are displayed. This notice is displayed only on the terminal that lost the messages. It is not sent to any other lines, any logging servers, or the logging buffer.

Caution 
By configuring abnormally large message queue limits and setting the terminal to "terminal monitor" on a terminal that is accessible to intruders, you expose yourself to "denial of service" attacks. An intruder could carry out the attack by putting the terminal in synchronous output mode, making a Telnet connection to a remote host, and leaving the connection idle. This could cause large numbers of messages to be generated and queued, and these messages would unlikely consume all available RAM. You should guard against this type of attack through proper configuration.
Examples
In the following example, line 4 is identified and synchronous logging for line 4 is enabled with a severity level of 6. Then another line, line 2, is identified and the synchronous logging for line 2 is enabled with a severity level of 7 and is specified with a maximum number of buffers to be 70,000.
line 4
logging synchronous level 6
logging synchronous level 7 limit 70000
Related Commands
Command
|
Description
|
line
|
Identifies a specific line for configuration and starts the line configuration command collection mode.
|
logging on
|
Controls logging of system messages and sends debug or error messages to a logging process, which logs messages to designated locations asynchronously to the processes that generated the messages.
|
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 system messages sent to syslog servers to only those messages at the specified level. To disable logging to syslog servers, use the no form of this command.
logging trap level
no logging trap
Syntax Description
level
|
Limits the logging of messages to the syslog servers to a specified level. You can enter the level number or level name. See the Usage Guidelines section for a list of acceptable level keywords.
|
Defaults
informational (level 6)
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
The show logging EXEC command displays the addresses and levels associated with the current logging setup. The command output also includes ancillary statistics.
Table 1 lists the syslog definitions that correspond to the debugging message levels. Additionally, four categories of messages are generated by the software, as follows:
•
Error messages about software or hardware malfunctions at the LOG_ERR level.
•
Output for the debug commands at the LOG_WARNING level.
•
Interface up/down transitions and system restarts at the LOG_NOTICE level.
•
Reload requests and low process stacks at the LOG_INFO level.
Use the logging and logging trap commands to send messages to a UNIX syslog server.
Table 62 logging trap System Message Logging Priorities
Level Arguments
|
Level
|
Description
|
Syslog Definition
|
emergencies
|
0
|
System unusable
|
LOG_EMERG
|
alerts
|
1
|
Immediate action needed
|
LOG_ALERT
|
critical
|
2
|
Critical conditions
|
LOG_CRIT
|
errors
|
3
|
Error conditions
|
LOG_ERR
|
warnings
|
4
|
Warning conditions
|
LOG_WARNING
|
notifications
|
5
|
Normal but significant condition
|
LOG_NOTICE
|
informational
|
6
|
Informational messages only
|
LOG_INFO
|
debugging
|
7
|
Debugging messages
|
LOG_DEBUG
|
Examples
In the following example, the messages to a host named john is logged:
logging john
logging trap notifications
Related Commands
Command
|
Description
|
logging
|
Logs messages to a syslog server host.
|
ping (privileged)
To diagnose basic network connectivity on Apollo, AppleTalk, Connectionless Network Service (CLNS), DECnet, IP, Novell IPX, VINES, or XNS networks, use the ping privileged EXEC command.
ping [protocol | tag] {host-name | system-address} [data [hex-data-pattern] | df-bit | repeat
[repeat-count] | size [datagram-size] | source [source-address | async | bvi | ctunnel | dialer |
ethernet | fastEthernet | lex | loopback | multilink | null | port-channel | tunnel | vif |
virtual-template | virtual-tokenring | xtagatm] | timeout [seconds] | validate]
Syntax Description
protocol
|
(Optional) Protocol keyword, one of apollo, appletalk, clns, decnet, ip, ipx, srb, vines, or xns.
|
tag
|
(Optional) Specifies a tag encapsulated IP ping.
|
host-name
|
Host name of the system to ping.
|
system-address
|
Address of the system to ping.
|
data
|
(Optional) Specifies the data pattern.
|
hex-data-pattern
|
(Optional) Range is from 0 to FFFF.
|
df-bit
|
(Optional) Enables the "do-not-fragment" bit in the IP header.
|
repeat
|
(Optional) Specifies the number of pings sent. The default is 5.
|
repeat-count
|
(Optional) Range is from 1 to 2147483647.
|
size
|
(Optional) Specifies the datagram size. Datagram size is the number of bytes in each ping.
|
datagram-size
|
(Optional) Range is from 40 to 18024.
|
source
|
(Optional) Specifies the source address or name.
|
source-address
|
(Optional)Source address or name.
|
async
|
(Optional) Asynchronous interface.
|
bvi
|
(Optional) Bridge-Group Virtual Interface.
|
ctunnel
|
(Optional) CTunnel interface.
|
dialer
|
(Optional) Dialer interface.
|
ethernet
|
(Optional) Ethernet IEEE 802.3.
|
fastEthernet
|
(Optional) FastEthernet IEEE 802.3.
|
lex
|
(Optional) Lex interface.
|
loopback
|
(Optional) Loopback interface.
|
multilink
|
(Optional) Multilink-group interface.
|
null
|
(Optional) Null interface.
|
port-channel
|
(Optional) Ethernet channel of interfaces.
|
tunnel
|
(Optional) Tunnel interface.
|
vif
|
(Optional) PGM Multicast Host interface.
|
virtual-template
|
(Optional) Virtual Template interface.
|
virtual-tokenring
|
(Optional) Virtual TokenRing.
|
xtagatm
|
(Optional) Extended Tag ATM interface.
|
timeout
|
(Optional) Specifies the timeout interval in seconds. The default is 2 seconds.
|
seconds
|
(Optional) Range is from 0 to 3600.
|
validate
|
(Optional) Validates the reply data.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
12.0
|
The data, df-bit, repeat, size, source, timeout, and validate keywords were added.
|
Usage Guidelines
The ping (packet internet groper) command sends ISO CLNS echo packets to test the reachability of a remote router over a connectionless Open System Interconnection (OSI) network.
The ping command sends an echo request packet to an address, then awaits a reply. Ping output can help you evaluate path-to-host reliability, delays over the path, and whether the host can be reached or is functioning.
To abnormally terminate a ping session, type the escape sequence—by default, Ctrl-^ X. You type the default by simultaneously pressing and releasing the Ctrl, Shift, and 6 keys, and then pressing the X key.
Table 63 describes the test characters that the ping facility sends.
Table 63 ping Test Characters
Character
|
Description
|
!
|
Each exclamation point indicates receipt of a reply.
|
.
|
Each period indicates that the network server timed out while waiting for a reply.
|
U
|
A destination unreachable error protocol data unit (PDU) was received.
|
C
|
A congestion experienced packet was received.
|
I
|
User interrupted test.
|
?
|
Unknown packet type.
|
&
|
Packet lifetime exceeded.
|
Note
Not all protocols require hosts to support pings. For some protocols, the pings are Cisco-defined and are only answered by another Cisco router.
Examples
After you enter the ping command in privileged mode, the system prompts for one of the following keywords: apollo, appletalk, clns, decnet, ip, novell, vines, or xns. The default protocol is IP.
If you enter a host name or address on the same line as the ping command, the default action is taken as appropriate for the protocol type of that name or address.
The optional data, df-bit, repeat, size, source, timeout, and validate keywords can be used to avoid extended ping command output. You can use as many of these keywords as you need, and you can use them in any order after the host-name or system-address arguments.
Although the precise dialog varies somewhat from protocol to protocol, all are similar to the ping session using default values shown in the following output:
Target IP address: 192.168.7.27
Sweep range of sizes [n]:
Type escape sequence to abort.
Sending 5, 100-byte ICMP Echos to 192.168.7.27, timeout is 2 seconds:
Success rate is 100 percent, round-trip min/avg/max = 1/2/4 ms
Table 64 describes the default ping fields shown in the display.
Table 64 ping Field Descriptions
Field
|
Description
|
Protocol [ip]:
|
Prompts for a supported protocol. Enter appletalk, clns, ip, novell, apollo, vines, decnet, or xns. The default is IP.
|
Target IP address:
|
Prompts for the IP address or host name of the destination node you plan to ping. If you have specified a supported protocol other than IP, enter an appropriate address for that protocol here. The default is none.
|
Repeat count [5]:
|
Prompts for the number of ping packets that will be sent to the destination address. The default is 5 packets.
|
Datagram size [100]:
|
Prompts for the size of the ping packet (in bytes). The default is 100 bytes.
|
Timeout in seconds [2]:
|
Prompts for the timeout interval. The default is 2 seconds.
|
Extended commands [n]:
|
Specifies whether a series of additional commands appears.
|
Sweep range of sizes [n]:
|
Allows you to vary the sizes of the echo packets being sent. This capability is useful for determining the minimum sizes of the MTUs configured on the nodes along the path to the destination address. Packet fragmentation contributing to performance problems can then be reduced.
|
!!!!!
|
Each exclamation point (!) indicates receipt of a reply. A period (.) indicates that the network server timed out while waiting for a reply. Other characters may appear in the ping output display, depending on the protocol type.
|
Success rate is 100 percent
|
Indicates the percentage of packets successfully echoed back to the router. Anything less than 80 percent is usually considered problematic.
|
round-trip min/avg/max = 1/2/4 ms
|
Indicates the round-trip travel time intervals for the protocol echo packets, including minimum/average/maximum (in milliseconds).
|
Related Commands
Command
|
Description
|
ping (user)
|
Tests the connection to a remote host on the network.
|
ping vrf
|
Tests the connection to a remote device in a VPN.
|
ping (user)
To diagnose basic network connectivity on AppleTalk, Connection Network Service (CLNS), IP, Novell, Apollo, VINES, DECnet, or XNS networks, use the ping (packet internet groper) user EXEC command.
ping [protocol] {host-name | system-address}
Syntax Description
protocol
|
(Optional) Protocol keyword, one of apollo, appletalk, clns, decnet, ip, ipx, vines, or xns.
|
host-name
|
Host name of the system to ping.
|
system-address
|
Address of the system to ping.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
The user-level ping feature provides a basic ping facility for users that do not have system privileges. This feature allows the Cisco IOS software to perform the simple default ping functionality for a number of protocols. Only the terse form of the ping command is supported for user-level pings.
If the system cannot map an address for a host name, it returns an "%Unrecognized host or address" error message.
To abnormally terminate a ping session, type the escape sequence—by default, Ctrl-^ X. You type the default by simultaneously pressing and releasing the Ctrl, Shift, and 6 keys, and then pressing the X key.
Table 65 describes the test characters that the ping facility sends.
Table 65 ping Test Characters
Character
|
Description
|
!
|
Each exclamation point indicates receipt of a reply.
|
.
|
Each period indicates that the network server timed out while waiting for a reply.
|
U
|
A destination unreachable error protocol data unit (PDU) was received.
|
C
|
A congestion experienced packet was received.
|
I
|
User interrupted test.
|
?
|
Unknown packet type.
|
&
|
Packet lifetime exceeded.
|
Examples
The following display shows sample ping output when you ping the IP host named donald:
Type escape sequence to abort.
Sending 5, 100-byte ICMP Echos to 192.168.7.27, timeout is 2 seconds:
Success rate is 100 percent, round-trip min/avg/max = 1/3/4 ms
Related Commands
Command
|
Description
|
ping (privileged)
|
Checks host reachability and network connectivity.
|
service slave-log
To allow slave Versatile Interface Processor (VIP) cards to log important system messages to the console, use the service slave-log global configuration command. To disable slave logging, use the no form of this command.
service slave-log
no service slave-log
Syntax Description
This command has no arguments or keywords.
Defaults
This command is enabled by default.
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
11.1
|
This command was introduced.
|
Usage Guidelines
This command allows slave slots to log system messages of level 2 or higher (critical, alerts, and emergencies).
Examples
In the following example, important messages from the slave cards to the console are logged:
In the following example sample output is illustrated when this command is enabled:
%IPC-5-SLAVELOG: VIP-SLOT2:
IPC-2-NOMEM: No memory available for IPC system initialization
The first line indicates which slot sent the message. The second line contains the system message.
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. To disable the keepalives, use the no form of this command.
service tcp-keepalives-in
no service tcp-keepalives-in
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Examples
In the following example, keepalives on incoming TCP connections are generated:
service tcp-keepalives-in
Related Commands
Command
|
Description
|
service tcp-keepalives-out
|
Generates keepalive packets on idle outgoing network connections (initiated by a user).
|
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. To disable the keepalives, use the no form of this command.
service tcp-keepalives-out
no service tcp-keepalives-out
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Examples
In the following example, keepalives on outgoing TCP connections are generated:
service tcp-keepalives-out
Related Commands
Command
|
Description
|
service tcp-keepalives-in
|
Generates keepalive packets on idle incoming network connections (initiated by the remote host).
|
service timestamps
To configure the system to time-stamp debugging or logging messages, use one of the service timestamps global configuration commands. To disable this service, use the no form of this command.
service timestamps [debug | log] [ uptime | datetime [msec] [localtime] [show-timezone] ]
no service timestamps [debug | log]
Syntax Description
debug
|
Indicates timestamping for debugging messages.
|
log
|
Indicates timestamping for system logging messages.
|
uptime
|
(Optional) Specifies that the time stamp should consist of the time since the system was last rebooted. For example "4w6d" (time since last reboot is 4 weeks and 6 days).
• This is the default timestamp format for both debugging messages and logging messages.
• The format for uptime varies depending on how much time has elapsed:
– HHHH:MM:SS (HHHH hours: MM minutes: SS seconds) for the first 24 hours
– DdHHh (D days HH hours) after the first day
– WwDd (W weeks D days) after the first week
|
datetime
|
(Optional) Specifies that the time stamp should consist of the date and time.
• The time stamp format for datetime is MMM DD HH:MM:SS, where MMM is the month, DD is the date, HH is the hour (in 24-hour notation), MM is the minute, and SS is the second.
• If the datetime keyword is specified, you can optionally add the msec localtime, or show-timezone keywords.
• If the service timestamps datetime command is used without addtional keywords, timestamps will be shown using UTC, without the year, without milliseconds, and without a time zone name.
|
msec
|
(Optional) Includes milliseconds in the time stamp, in the format HH:DD:MM:SS.mmm, where .mmm is milliseconds
|
localtime
|
(Optional) Time stamp relative to the local time zone.
|
show-timezone
|
(Optional) Include the time zone name in the time stamp.
Note If the localtime keyword option is not used (or if the local time zone has not been configured using the clock timezone command), time will be displayed in Universal Coordinated Time (UTC).
|
Defaults
No time-stamping.
If the service timestamps command is specified with no arguments or keywords, the default is service timestamps debug uptime.
The default for the service timestamps type datetime command is to format the time in Coordinated Universal Time (UTC), with no milliseconds and no time zone name.
The no service timestamps command by itself disables time stamps for both debug and log messages.
Command Modes
Global configuration (config)
Command History
Release
|
Modification
|
10.0
|
This command was introduced.
|
Usage Guidelines
Time stamps can be added to either debugging or logging messages independently. The uptime form of the command adds time stamps in the format HHHH:MM:SS, indicating the time since the system was rebooted. The datetime form of the command adds time stamps in the format MMM DD HH:MM:SS, indicating the date and time according to the system clock. If the system clock has not been set, the date and time are preceded by an asterisk (*) to indicate that the date and time are probably not correct.
Examples
In the following example, the user enables time stamps on debugging messages, showing the time since reboot:
service timestamps debug uptime
In the following example, the user enables time stamps on logging messages, showing the current time and date relative to the local time zone, with the time zone name included:
service timestamps log datetime localtime show-timezone
Related Commands
Command
|
Description
|
clock set
|
Manually sets the system clock.
|
ntp
|
Controls access to the system's NTP services.
|
show c2600 (2600)
To display information for troubleshooting the Cisco 2600 series router, use the show c2600 EXEC command.
show c2600
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Release
|
Modification
|
11.3 XA
|
This command was introduced.
|
Usage Guidelines
The show c2600 command provides complex troubleshooting information that pertains to the platform's shared references rather than to a specific interface.
Examples
In the following example, sample output is shown for the show c2600 EXEC command. See Table 66 for a description of the output display fields.
C2600 Platform Information:
Vect Handler # of Ints Name
00 801F224C 00000000 Xilinx bridge error interrupt
01 801DE768 0D3EE155 MPC860 TIMER INTERRUPT
02 801E94E0 0000119E 16552 Con/Aux Interrupt
04 801F0D94 00000000 PA Network Management Int Handler
05 801E6C34 00000000 Timebase Reference Interrupt
06 801F0DE4 00002C1A PA Network IO Int Handler
07 801F0EA0 0000015D MPC860 CPM INTERRUPT
14 801F224C 00000000 Xilinx bridge error interrupt
SIU_IRQ_MASK = FFFFFFFF SIEN = EF02xxxx Current Level = 00
Spurious IRQs = 00000000 SIPEND = 0000xxxx
Throttle Count = 00000000 Timer Count = 00000000
Netint usec = 00000000 Netint Mask usec = 000003E8
Active = 0 Configured = 0
Requests = 00000349 Drops = 00000000
Complete = 00000349 Post Coalesce Frames = 00000349
Available Blocks = 256/256
Version string burned in chip: "A986122997"
New version after next program operation: "B018020998"
Table 66 show c2600 Field Descriptions
Field
|
Description
|
Interrupts
|
Denotes that the next section describes the status of the interrupt services.
|
Assigned Handlers
|
Denotes a subsection of the Interrupt section that displays data about the interrupt handlers.
|
Vect
|
The processor vector number.
|
Handler
|
The execution address of the handler assigned to this vector.
|
# of Ints
|
The number of times this handler has been called.
|
Name
|
The name of the handler assigned to this vector.
|
IOS Priority Masks
|
Denotes the subsection of the Interrupt section that displays internal Cisco IOS priorities. Each item in this subsection indicates a Cisco IOS interrupt level and the bit mask used to mask out interrupt sources when that Cisco IOS level is being processed. Used exclusively for debugging.
|
SIU_IRQ_MASK
|
For engineering level debug only.
|
Spurious IRQs
|
For engineering level debug only.
|
Interrupt Throttling:
|
This subsection describes the behavior of the Interrupt Throttling mechanism on the platform.
|
Throttle Count
|
Number of times throttle has become active.
|
Timer Count
|
Number of times throttle has deactivated because the maximum masked out time for network interrupt level has been reached.
|
Netint usec
|
Maximum time network level is allowed to run (in microseconds).
|
Netint Mask usec
|
Maximum time network level interrupt is masked out to allow process level code to run (in microseconds).
|
Active
|
Indicates that the network level interrupt is masked or that the router is in interrupt throttle state.
|
Configured
|
Indicates that throttling is enabled or configured when set to 1.
|
Longest IRQ
|
Duration of longest network level interrupt (in microseconds).
|
IDMA Status
|
Monitors the activity of the Internal Direct Memory Access (IDMA) hardware and software. Used to coalesce packets (turn particalized packets into non particalized packets) for transfer to the process level switching mechanism.
|
Requests
|
Number of times the IDMA engine is asked to coalesce a packet.
|
Drops
|
Number of times the coalescing operation was aborted.
|
Complete
|
Number of times the operation was successful.
|
Post Coalesce Frames
|
Number of Frames completed post coalesce processing.
|
Giant
|
Number of packets too large to coalesce.
|
Available Blocks
|
Indicates the status of the request queue, in the format N/M where N is the number of empty slots in queue and M is the total number of slots; for example, 2/256 indicates that the queue has 256 entries and can accept two more requests before it is full.
|
ISP Status
|
Provides status of In-System-Programmable (ISP) hardware.
|
Version string burned in chip
|
Current version of ISP hardware.
|
New version after next program operation
|
Version of ISP hardware after next ISP programming operation.
|
ISP family type
|
Device family number of ISP hardware.
|
ISP chip ID
|
Internal ID of ISP hardware as designated by the chip manufacturer.
|
Device is programmable
|
"Yes" or "No." Indicates if an ISP operation is possible on this board.
|
Related Commands
Command
|
Description
|
show context
|
Displays information stored in NVRAM when the router crashes.
|
show c7200 (7200)
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.
Command Modes
EXEC
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
Usage Guidelines
You can use the output of this command to determine whether the hardware version level and upgrade is current. The information is generally useful for diagnostic tasks performed by technical support only.
Examples
The following is sample output from the show c7200 command:
C7200 Network IO Interrupt Throttling:
throttle count=0, timer count=0
netint usec=3999, netint mask usec=200
Hardware revision 1.2 Board revision A0
Serial number 2863311530 Part number 170-43690-170
Test history 0xAA RMA number 170-170-170
MAC=0060.3e28.ee00, MAC Size=1024
EEPROM format version 1, Model=0x6
0x20: 01 06 01 02 AA AA AA AA AA AA AA AA 00 60 3E 28
0x30: EE 00 04 00 AA AA AA AA AA AA AA 50 AA AA AA AA
Hardware revision 2.0 Board revision A0
Serial number 3509953 Part number 73-1536-02
Test history 0x0 RMA number 00-00-00
0x20: 01 15 02 00 00 35 8E C1 49 06 00 02 00 00 00 00
0x30: 50 00 00 00 FF FF FF FF FF FF FF FF FF FF FF FF
show cls
To display the current status of all Cisco link services (CLS) sessions on the router, use the show cls EXEC command.
show cls [brief]
Syntax Description
brief
|
(Optional) Displays a brief version of the output.
|
Defaults
Without the brief argument, displays complete output.
Command Modes
EXEC
Command History
Release
|
Modification
|
11.0
|
This command was introduced in a release prior to Cisco IOS Release11.0.
|
Usage Guidelines
The Cisco link service CLS is used as the interface between data link users (DLUs), such as DLSw, LAN Network Manager (LNM), downstream physical unit (DSPU), and SNASw, and their corresponding data link circuits (DLCs) such as Logic Link Control (LLC), VDLC, and Qualified Logic Link Control (QLLC). Each DLU registers a particular service access point (SAP) with CLS, and establishes circuits through CLS over the DLC.
The show cls command displays the SAP values associated with the DLU and the circuits established through CLS.
Examples
The following is sample output from the show cls command:
DTE:1234.4000.0001 1234.4000.0002 04 04
T1 timer:0 T2 timer:0 Inact timer:0
max out:0 max in:0 retry count:10
XID retry:10 XID timer:5000 I-Frame:0
flow:0 DataIndQ:0 DataReqQ:0
The following is sample output from the show cls brief command:
IBD-4500B# show cls brief
DTE:1234.4000.0001 1234.4000.0002 04 04
Bridging VDLC VDLC650
The examples show two DLUs—SNASw and DLSw—active in the router. SNASw uses a SAP value of 0x04, and the associated DLC port is VDLC650. SNASw has a circuit established between MAC addresses 1234.4000.0001 and 1234.4000.0002 using source and destination SAPs 04 and 04. DLSw is a bridging protocol and uses VDLC1000 and VDLC650 ports. There are no circuits in place at this time.
In the output from the show cls command (without the brief argument), the values of timers and counters applicable to this circuit are displayed.
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.
Command Modes
EXEC
Command History
Release
|
Modification
|
10.3
|
This command was introduced.
|
Usage Guidelines
Context information is specific to processors and architectures, whereas software version and uptime information is not specific to architectures. Context information for the Cisco 2600 series router differs from that for other router types because the Cisco 2600 runs with an M860 processor. The display from the show context command includes the following information:
•
Reason for the system reboot
•
Stack trace
•
Software version
•
The signal number, code, and router uptime information
•
All the register contents at the time of the crash
This information is useful only to your technical support representative for analyzing crashes in the field. Use this information when you read the displayed statistics to an engineer over the phone.
Examples
The following is sample output from the show context command following a system failure on a Cisco 2600 series router. See Table 67 for a description of the fields in this output.
S/W Version: Cisco Internetwork Operating System Software
IOS (tm) c2600 Software (c2600-JS-M), Released Version 11.3(19980115:184921]
Copyright (c) 1986-1998 by cisco Systems, Inc.
Compiled Thu 15-Jan-98 13:49 by mmagno
Exception occurred at: 00:02:26 UTC Mon Mar 1 1993
Exception type: Data TLB Miss (0x1200)
PC = 0x80109964 MSR = 0x00009030 CR = 0x55FFFD35 LR = 0x80109958
CTR = 0x800154E4 XER = 0xC000BB6F DAR = 0x00000088 DSISR = 0x00000249
DEC = 0x7FFFDFCA TBU = 0x00000000 TBL = 0x15433FCF IMMR = 0x68010020
R0 = 0x80000000 R1 = 0x80E80BD0 R2 = 0x80000000 R3 = 0x00000000
R4 = 0x80E80BC0 R5 = 0x40800000 R6 = 0x00000001 R7 = 0x68010000
R8 = 0x00000000 R9 = 0x00000060 R10 = 0x00001030 R11 = 0xFFFFFFFF
R12 = 0x00007CE6 R13 = 0xFFF379E8 R14 = 0x80D50000 R15 = 0x00000000
R16 = 0x00000000 R17 = 0x00000000 R18 = 0x00000000 R19 = 0x00000000
R20 = 0x00000000 R21 = 0x00000001 R22 = 0x00000010 R23 = 0x00000000
R24 = 0x00000000 R25 = 0x80E91348 R26 = 0x01936010 R27 = 0x80E92A80
R28 = 0x00000001 R29 = 0x019BA920 R30 = 0x00000000 R31 = 0x00000018
Frame 00: SP = 0x80E80BD0 PC = 0x80109958
Frame 01: SP = 0x80E80C28 PC = 0x8010A720
Frame 02: SP = 0x80E80C40 PC = 0x80271010
Frame 03: SP = 0x80E80C50 PC = 0x8025EE64
Frame 04: SP = 0x80DEE548 PC = 0x8026702C
Frame 05: SP = 0x80DEE558 PC = 0x8026702C
Table 67 show context Field Descriptions
Field
|
Description
|
S/W Version
|
Standard Cisco IOS version string as displayed.
|
Exception occurred at
|
Router real time when exception occurred. The router must have the clock time properly configured for this to be accurate.
|
Exception type
|
Technical reason for exception. For engineering analysis.
|
CPU Register Context
|
Technical processor state information. For engineering analysis.
|
Stack trace
|
Technical processor state information. For engineering analysis.
|
Related Commands
Command
|
Description
|
show processes
|
Displays information about the active processes.
|
show stacks
|
Monitors the stack usage of processes and interrupt routines.
|
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 router and from 0 to 7 for the Cisco 12008. The 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 a hex record dump in addition to one of the options listed.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
11.2 GS
|
This command was modified to add the all, debug, slot, and summary keywords.
|
Usage Guidelines
The display from the show context command includes the following information:
•
Reason for the system reboot
•
Stack trace
•
Software version
•
The signal number, code, and router uptime information
•
All the register contents at the time of the crash
Note
This information is of use only to technical support representatives in analyzing crashes in the field. It is included here in case you need to read the displayed statistics to an engineer over the phone.
Examples
The following is sample output from the show context command following a system failure:
System was restarted by error - a Software forced crash, PC 0x60189354
GS Software (RSP-PV-M), Experimental Version 11.1(2033) [ganesh 111]
Compiled Mon 31-Mar-97 13:21 by ganesh
Image text-base: 0x60010900, data-base: 0x6073E000
Stack trace from system failure:
FP: 0x60AEA798, RA: 0x60189354
FP: 0x60AEA798, RA: 0x601853CC
FP: 0x60AEA7C0, RA: 0x6015E98C
FP: 0x60AEA7F8, RA: 0x6011AB3C
FP: 0x60AEA828, RA: 0x601706CC
FP: 0x60AEA878, RA: 0x60116340
FP: 0x60AEA890, RA: 0x6011632C
GS Software (RSP-PV-M), Experimental Version 11.1(2033) [ganesh 111]
Compiled Mon 31-Mar-97 13:21 by ganesh
Signal = 23, Code = 0x24, Uptime 00:04:19
$0 : 00000000, AT : 60930120, v0 : 00000032, v1 : 00000120
a0 : 60170110, a1 : 6097F22C, a2 : 00000000, a3 : 00000000
t0 : 60AE02A0, t1 : 8000FD80, t2 : 34008F00, t3 : FFFF00FF
t4 : 00000083, t5 : 3E840024, t6 : 00000000, t7 : 11010132
s0 : 00000006, s1 : 607A25F8, s2 : 00000001, s3 : 00000000
s4 : 00000000, s5 : 00000000, s6 : 00000000, s7 : 6097F755
t8 : 600FABBC, t9 : 00000000, k0 : 30408401, k1 : 30410000
gp : 608B9860, sp : 60AEA798, s8 : 00000000, ra : 601853CC
EPC : 60189354, SREG : 3400EF03, Cause : 00000024
The following is sample output from the show context summary command on a Cisco 12012 router. The show context summary command displays a summary of all the crashes recorded.
Router# show context summary
1 - crash at 18:06:41 UTC Tue Nov 5 1996
2 - crash at 12:14:55 UTC Mon Nov 4 1996
Related Commands
Command
|
Description
|
show processes
|
Displays information about the active processes.
|
show stacks
|
Monitors the stack usage of processes and interrupt routines.
|
show controllers (GRP image)
To display information that is specific to the hardware, use the show controllers privileged EXEC command.
show controllers [atm slot-number | clock | csar [register] | csc-fpga | dp83800 | fab-clk | fia
[register] | pos [slot-number] [details] | queues [slot-number] | sca | xbar]
Syntax Description
atm slot-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 router and from 0 to 7 for the Cisco 12008 router.
|
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. Two switch fabric clocks arrive 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 displays the register information.
|
pos [slot-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 router and from 0 to 7 for the Cisco 12008 router.
|
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 router and from 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.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.2 GS
|
This command was added to support the Cisco 12000 series Internet Routers.
|
Usage Guidelines
This information provided by this command is intended for use only by technical support representatives in analyzing system failures in the field.
Examples
The following is sample output from the show controllers pos command for a Cisco 12012:
Router# show controllers pos 7/0
LOF = 2 LOS = 0 BIP(B1) = 5889
AIS = 2 RDI = 2 FEBE = 146 BIP(B2) = 2106453
AIS = 2 RDI = 4 FEBE = 63 BIP(B3) = 3216
LOP = 0 PSE = 8 NSE = 3 NEWPTR = 2
State: PSBF_state = False
Rx(K1/K2): F0/15 Tx(K1/K2): 00/00
PATH TRACE BUFFER : STABLE
Remote interface: POS10/0
Remote IP addr : 10.201.101.2
Remote Rx(K1/K2): F0/15 Tx(K1/K2): 00/00
Related Commands
Command
|
Description
|
clear controllers
|
Resets the T1 or E1 controller.
|
show controllers (line card image)
|
Displays information that is specific to the hardware on a line card.
|
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 from 0 to 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" (transmit) fabric information.
|
tofab
|
(Optional) Displays the "to" (receive) fabric 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 SQE information for the microcode bundled in the line card and currently running version.
|
mis-inst
|
Displays 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 from 0 to 65535.
|
end-queue-element
|
(Optional) Specifies the end queue element number from 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 (from 0 to 127).
|
end-queue-number
|
(Optional) Specifies the end free queue number (from 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 from 0 to 3).
|
queue-start-address
|
Specifies the queue SRAM logical starting address.
|
queue-length
|
(Optional) Specifies the queue SRAM length.
|
txsram
|
Displays the transmit queue SRAM.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.2 GS
|
This command was added to support the Cisco 12000 series Gigabit Switch Routers.
|
Usage Guidelines
This command is intended for use by Cisco technical support.
Note
This information provided by this command is of use only to technical support representatives in analyzing crashes in the field.
Examples
Because you are executing this command on the line card, you must use the execute-on command to use the show command, or you must connect to the card using the attach command. All examples in this section use the execute-on command
The following is partial sample output from the show controllers atm command:
Router# execute-on slot 4 show controllers atm 0
TX SAR (Beta 1.0.0) is Operational;
RX SAR (Beta 1.0.0) is Operational;
Interface Configuration Mode:
Active Maker Channels: total # 6
VCID ChnnlID Type OutputInfo InPkts InOAMs MacString
1 0888 UBR 0C010010 0 0 08882000AAAA030000000800
2 0988 VBR 04010020 0 0 09882000
3 8BC8 UBR 0C010030 0 0 8BC82000AAAA030000000800
4 0E08 UBR 0C010040 0 0 0E082000AAAA030000000800
10 1288 VBR 040100A0 0 0 12882000
11 8BE8 VBR 0C0100B0 0 0 8BE82000AAAA030000000800
total_tx_idle_cells 215267 total_tx_paks 0 total_tx_abort_paks 0
total_rx_paks 0 total_rx_drop_paks 0 total_rx_discard_cells 15
total_rx_crc_err_paks 0 total_rx_giant_paks 0
total_rx_abort_paks 0 total_rx_crc10_cells 0
total_rx_tmout_paks 0 total_rx_unknown_paks 0
total_rx_out_buf_paks 0 total_rx_unknown_vc_paks 0
BATMAN Asic Register Values:
hi_addr_reg 0x8000, lo_addr_reg 0x000C, boot_msk_addr 0x0780,
rmcell_msk_addr 0x0724, rmcnt__msk_addr 0x07C2, txbuf_msk_addr 0x070C,
CM622 SAR Boot Configuration:
txind_q_addr 0x14000 txcmd_q_addr 0x20000
SUNI-622 Framer Register Values:
Master Rst and Ident/Load Meters Reg (#0x0): 0x10
Master Configuration Reg (#0x1): 0x1F
Master Interrupt Status Reg (#0x2): 0x00
PISO Interrupt Reg (#0x3): 0x04
Master Auto Alarm Reg (#0x4): 0x03
Master Auto Alarm Reg (#0x5): 0x07
Parallel Output Port Reg (#0x6): 0x02
BERM Line BIP Threshold LSB Reg (#0x74): 0x00
BERM Line BIP Threshold MSB Reg (#0x75): 0x00
The following is partial sample output from the show controllers command:
Router# execute-on slot 6 show controllers
lcpos_instance struct 60311B40
RX POS ASIC addr space 12000000
TX POS ASIC addr space 12000100
SUNI framer addr space 12000400
CRC32 enabled, HDLC enc, int clock
lcpos_instance struct 603142E0
RX POS ASIC addr space 12000000
TX POS ASIC addr space 12000100
SUNI framer addr space 12000600
CRC32 enabled, HDLC enc, int clock
The following is partial sample output from the show controllers pos framers command:
Router# execute-on slot 6 show controllers pos framers
Framer 0, addr=0x12000400:
master config 1F rrate sts3c trate sts3c fixptr
TACP control status 04 hcsadd
RSOP cntrl intr enable 00
TPOP path sig lbl (c2) 13
Framer 1, addr=0x12000600:
master config 1F rrate sts3c trate sts3c fixptr
TACP control status 04 hcsadd
RSOP cntrl intr enable 00
TPOP path sig lbl (c2) 13
Framer 2, addr=0x12000800:
master config 1F rrate sts3c trate sts3c fixptr
TACP control status 04 hcsadd
RSOP cntrl intr enable 00
TPOP path sig lbl (c2) 13
The following is partial sample output from the show controllers fia command:
Router# execute-on slot 7 show controllers fia
========= Line Card (Slot 7) =======
Fabric configuration: Full bandwidth redundant
Master Scheduler: Slot 17
redund fifo parity 0 redund overflow 0 cell drops 0
crc32 lkup parity 0 cell parity 0 crc32 0
-------- -------- -------- -------- --------
sca not pres 0 req error 0 uni fifo overflow 0
grant parity 0 multi req 0 uni fifo undrflow 0
cntrl parity 0 uni req 0 crc32 lkup parity 0
multi fifo 0 empty dst req 0 handshake error 0
Related Commands
Command
|
Description
|
clear controllers
|
Resets the T1 or E1 controller.
|
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.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
Usage Guidelines
This command displays the state of syslog error and event logging, including host addresses, and whether console logging is enabled.
Examples
The following is sample output from the show controllers logging command:
Router# show controllers vip 4 logging
Console logging: disabled
Monitor logging: level debugging, 266 messages logged.
Trap logging: level informational, 266 messages logged.
Table 68 describes the significant fields shown in the display.
Table 68 show controllers logging Field Descriptions
Field
|
Description
|
Syslog logging
|
When enabled, system logging messages are sent to a UNIX host that acts as a syslog server; that is, it captures and saves the messages.
|
Console logging
|
If enabled, states the level; otherwise, this field displays disabled.
|
Monitor logging
|
Minimum level of severity required for a log message to be sent to a monitor terminal (not the console).
|
Trap logging
|
Minimum level of severity required for a log message to be sent to a syslog server.
|
Related Commands
Command
|
Description
|
show logging
|
Displays the state of system logging (syslog).
|
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.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
Usage Guidelines
Use this command to help collect general information about a VIP card when you are reporting a problem. This command displays the equivalent of the following show commands for the VIP card:
•
more system:running-config
•
show buffers
•
show controllers
•
show interfaces
•
show processes cpu
•
show processes memory
•
show stacks
•
show version
For a sample display of the show controllers tech-support command output, refer to these show commands.
Related Commands
Command
|
Description
|
more system:running-config
|
Displays the running configuration.
|
show buffers
|
Displays statistics for the buffer pools on the network server.
|
show controllers
|
Displays information that is specific to the hardware.
|
show interfaces
|
Uses the show interfaces EXEC command to display ALC information.
|
show processes
|
Displays information about the active processes.
|
show processes memory
|
Displays memory used.
|
show stacks
|
Monitors the stack usage of processes and interrupt routines.
|
show tech-support
|
Displays general information about the router when reporting a problem.
|
show version
|
Displays the configuration of the system hardware, the software version, the names and sources of configuration files, and the boot images.
|
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.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.1
|
This command was introduced.
|
Examples
The following is sample output from the show debugging command. In this example, three types of CDP debugging are enabled.
CDP packet info debugging is on
CDP events debugging is on
CDP neighbor info debugging is on
Related Commands
Command
|
Description
|
debug <feature>
|
Begin message logging for the specified debug command
|
show diag
To display hardware information including DRAM and static RAM (SRAM) on line cards, 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.
|
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.1 CA
|
This command was introduced.
|
11.2
|
This command was introduced.
|
11.2 P
|
This command was modified to show information for PA-12E/2FE, PA-E3, and PA-T3 port adapters.
|
11.2 GS
|
This command was made available on Cisco 12000 series Gigabit Switch Routers (GSRs).
|
11.3 XA
|
This command was integrated in Cisco IOS Release 11.3 XA.
|
12.0(5)XQ
|
This command was enhanced and made available on Cisco 1750 routers.
|
12.0(7)T
|
This command was integrated in Cisco IOS Release 12.0T.
|
Usage Guidelines
Use this command to determine the type of hardware installed in your router. This command applies line cards in Cisco Universal Access Servers; Cisco 1750, 7200, and 7500 series routers; and Cisco 12000 series GSRs.
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 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:
Physical slot 1, ~physical slot 0xE, logical slot 1, CBus 0
Master Enable, LED, WCS Loaded
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
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
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:
Dual FastEthernet (RJ-45) I/O Card Port adapter, 2 ports
Port adapter insertion time 6d02h ago
EEPROM contents at hardware discovery:
Top Assy. Part Number : 800-07114-06
PCB Serial Number : 31558694
Fab Part Number : 28-3455-03
Product (FRU) Number : C7200-I/O-2FE/E
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
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:
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 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
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
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 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:
3660 Chassis type: ENTERPRISE
Top Assy. Part Number : 800-04740-02
ATM AIM module with SAR only (no DSPs)
Top Assy. Part Number : 800-03700-01
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:
3660 Chassis type: ENTERPRISE
Top Assy. Part Number : 800-04740-02
PCB Serial Number : HAD04471U36
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
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
C3600 Mother board 2FE(TX) Port adapter, 2 ports
Port adapter insertion time unknown
EEPROM contents at hardware discovery:
PCB Serial Number : JAB05460CSV
Top Assy. Part Number : 800-04737-04
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
Field Diagnostics Data : FF FF FF FF FF FF FF FF
Product (FRU) Number : Leopard-2FE
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
Mueslix-4T Port adapter, 4 ports
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
Test history 0x0 RMA number 00-00-00
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
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.
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 69 describes significant fields shown in the display.
Table 69 show diag (AIC) Field Descriptions
Field
|
Description
|
C2611 2E Mainboard Port adapter, 2 ports
|
Line card type; number of ports available.
|
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
Table 70 describes significant fields shown in the display.
Table 70 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:
7304-MSC-100 SPA Carrier Card Line Card
Insertion time: 00:08:49 ago
Bandwidth points: 4000000
EEPROM contents at hardware discovery:
PCB Serial Number : CSJ07288905
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
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
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
Current FPGA version : 00.23
IOS bundled FPGA version : 00.23
Shared port adapter: SPA-4FE-7304, 4 ports
Insertion time: 00:15:13 ago
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
Shared port adapter: SPA-4FE-7304, 4 ports
Info: hw-ver=0x100, sw-ver=0x0 fpga-ver=0x0
Insertion time: 23:20:42 ago
PCB Serial Number : JAB073204G5
73/68 Level Revision : 01
Product Number : SPA-4FE-7304
Top Assy. Part Number : 68-2181-01
73/68 Level Revision : A0
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
Calibration Data : Minimum: 0 dBmV, Maximum: 0 dBmV
Power Consumption : 160000mW max
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
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:
Router# show diag subslot 4/0
Shared port adapter: SPA-2GE-7304, 2 ports
Info: hw-ver=0x17, sw-ver=0x0 fpga-ver=0x0
Insertion time: 00:08:47 ago
PCB Serial Number : JAB073406YH
73/68 Level Revision : 01
Product Number : SPA-2GE-7304
Top Assy. Part Number : 68-2181-01
73/68 Level Revision : A0
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
Calibration Data : Minimum: 0 dBmV, Maximum: 0 dBmV
Power Consumption : 160000mW max
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
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
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
Insertion Time : 00:00:10 (13:14:17 ago)
Table 71 describes the significant fields shown in the display.
Table 71 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.
|
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
PCB Serial Number : PRTA1304061
PCB Part Number : 73-8546-01
PCB Revision : A0 Fab Version : 01
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
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
Power Consumption : 11000 mWatts (Maximum)
Environment Monitor Data : 03 30 04 B0 46 32 07 08
Processor Label : 00 00 00 00 00 00 00
Platform features : 00 00 00 00 00 00 00 00
Insertion Time : 00:00:10 (13:14:24 ago)
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:
SLOT 2 (RP/LC 2 ): Modular 10G SPA Interface Card
MAIN: type 149, 800-26270-01 rev 84
HW config: 0x00 SW key: 00-00-00
PCA: 73-9607-01 rev 91 ver 1
Design Release 1.0 S/N SAD08460678
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)
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
subslot 2/0: SPA-OC192POS-XFP (0x44C), status is ok
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 insertion time unknown
EEPROM contents at hardware discovery:
PCB Serial Number : FOC09052HHA
Top Assy. Part Number : 800-21849-02
Hardware date code : 20050205
Chassis Serial Number : FTX0908A0B0
Chassis MAC Address : 0013.1ac2.2848
MAC Address block size : 24
Product (FRU) Number : CISCO2811
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
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
Top Assy. Part Number : 800-26247-01
PCB Serial Number : FHH093600D4
Product (FRU) Number : HWIC-1ADSL
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
ADSL over POTS non-removable daughtercard
PCB Serial Number : FHH0936006E
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
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
Top Assy. Part Number : 800-26248-01
PCB Serial Number : FHH093600DA
Product (FRU) Number : HWIC-1ADSLI
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
ADSL over ISDN non-removable daughtercard
PCB Serial Number : FHH0936008M
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
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:
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)
128 MBytes Total on Board SDRAM
IOS (tm) cwlc Software (cwpa-DW-M), Version 12.2(18)SXF2, RELEASE SOFTW)
ENHANCED ATM OC3 MM PA, 1 ports, FRU: PA-A3-OC3-MM
HW rev 2.00, Board revision A0
Serial number: 29360940 Part number: 73-2430-04
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)
128 MBytes Total on Board SDRAM
IOS (tm) cwlc Software (cwpa-DW-M), Version 12.2(18)SXF2, RELEASE SOFTW)
HW rev 1.00, Board revision A0
Serial number: 04387628 Part number: 73-1577-04
The following sample output from a Cisco 7600 series router shows the FRU number:
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)
511 MBytes Total on Board SDRAM
IOS (tm) cwlc Software (cwpa2-DW-M), Version 12.2(18)SXF2, RELEASE SOFT)
ENHANCED ATM OC3 MM PA, 1 ports, FRU: PA-A3-OC3-MM
HW rev 2.00, Board revision A0
Serial number: JAE0937KUPX Part number: 73-8728-01
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)
511 MBytes Total on Board SDRAM
IOS (tm) cwlc Software (cwpa2-DW-M), Version 12.2(18)SXF2, RELEASE SOFT)
HW rev 1.14, Board revision D0
Serial number: 33929508 Part number: 73-1577-07
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 gigabitethernet
|
Displays Gigabit Ethernet interface information, transmission statistics and errors, and applicable MAC destination address and VLAN filtering tables.
|
show disk0:
To display flash or file system information for a disk located in slot 0, use the show disk command in user EXEC or privileged EXEC mode.
show disk0: [all | filesys]
Syntax Description
all
|
(Optional) The all keyword displays complete information about flash memory, including information about the individual devices in flash memory and the names and sizes of all system image files stored in flash memory, including those that are invalid.
|
filesys
|
(Optional) Displays the device information block, the status information, and the usage information.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
11.3AA
|
This command was introduced.
|
12.2
|