Downloads |
Table Of Contents
22stack
To dump a stack trace of frames, use the stack command.
stack [-d | -m] [num]
Syntax Description
-d
(Optional) Dumps the ROM monitor stack.
-m
(Optional) Specifies addresses to dump.
num
(Optional) Number of frames.
Defaults
The default for num is five frames.
Command Types
ROM monitor command.
Command Modes
Normal.
Usage Guidelines
The frames are dumped from the kernel stack and the process stack (if one is available) of a booted image. Use the frame command to display an individual stack frame.
The minus sign (-) is required with the -d and -m options.
Examples
This example shows how to use the stack command to dump a stack trace of eight frames:
rommon 5 > stack 8Kernel Level Stack Trace:Initial SP = 0x60276a98, Initial PC = 0x60033054, RA = 0x6006d380Frame 0 : FP= 0x60276a98, PC= 0x60033054, 0 bytesFrame 1 : FP= 0x60276a98, PC= 0x6006d380, 24 bytesFrame 2 : FP= 0x60276ab0, PC= 0x600e5218, 40 bytesFrame 3 : FP= 0x60276ad8, PC= 0x600dcd48, 32 bytesFrame 4 : FP= 0x60276af8, PC= 0x60033fdc, 0 bytesProcess Level Stack Trace:Initial SP = 0x80007ce8, Initial PC = 0x600dfd38, RA = 0x600dfd20Frame 0 : FP= 0x80007ce8, PC= 0x600dfd38, 24 bytesFrame 1 : FP= 0x80007d00, PC= 0x6005b260, 32 bytesFrame 2 : FP= 0x80007d20, PC= 0x6005c05c, 192 bytesFrame 3 : FP= 0x80007de0, PC= 0x6005b54c, 24 bytesFrame 4 : FP= 0x80007df8, PC= 0x600e82e0, 56 bytesFrame 5 : FP= 0x80007e30, PC= 0x600e9484, 40 bytesFrame 6 : FP= 0x80007e58, PC= 0x600e8b28, 24 bytesFrame 7 : FP= 0x80007e70, PC= 0x600de224, 72 bytesRelated Commands
switch
To switch the clock from the supervisor clock to the internal clock or from the active supervisor engine to the standby supervisor engine, use the switch command.
switch {clock | supervisor}
Syntax Description
clock
Switches the clock from the supervisor clock to the internal clock.
supervisor
Switches from the active supervisor engine to the standby supervisor engine.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to switch the clock:
Console> (enable) switch clockThis command will reset system and force a clock switch-over.Do you want to continue (y/n) [n]?Console> (enable)This example shows how to switch to the standby supervisor engine:
Console> (enable) switch supervisorThis command will force a switch-over to the standby Supervisor module.Do you want to continue (y/n) [n]?Console> (enable)switch console
To switch the console connection physically to the MSFC on the active supervisor engine, use the switch console command.
switch console [mNo]
Syntax Description
Defaults
The default is supervisor engine console.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
This command is not supported on Telnet sessions.
The switch console command allows you to change to the MSFC that shares the slot with the active supervisor engine. To use this command, it is necessary to have active and redundant supervisor engine consoles. Otherwise, you cannot use the switch console command to switch to the console of the MSFC placed in the redundant supervisor engine slot.
If you place the MSFC on a supervisor engine installed in slot 1, the MSFC is recognized as module 15. If you install the supervisor engine in slot 2, the MSFC is recognized as module 16. If the optional argument mNo is excluded, the console will switch to MSFC on the active supervisor engine.
To exit from the router CLI back to the switch CLI, press Ctrl-C three times at the Router> prompt.
Examples
This example shows how to switch the console connection to the MSFC on the active supervisor engine:
Console> (enable) switch console 15Trying Router-15...Connected to Router-15.Type ^C^C^C to switch back...switch fabric
To reset the active Switch Fabric Module and allow the standby Switch Fabric Module to take over, use the switch fabric command.
switch fabric [mNo]
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
This command is not supported on Telnet sessions.
Examples
This example shows how to reset the active Switch Fabric Module:
Console> (enable) switch fabricThis command will force a switch-over to the standby fabric module.Do you want to continue (y/n) [n]?Console> (enable)sync
To write the working in-core copy of environment variables and the aliases out to NVRAM so they are read on the next reset, use the sync command.
sync
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
ROM monitor command.
Command Modes
Normal.
Examples
This example shows how to use the sync command:
rommon 10 > syncrommon 11 >sysret
To display the return information from the last booted system image, use the sysret command.
sysret
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
ROM monitor command.
Command Modes
Normal.
Usage Guidelines
The stack dump information displayed has a maximum of eight frames.
Examples
This example shows how to use the sysret command to display the return information from the last booted system image:
rommon 8 > sysretSystem Return Info:count: 19, reason: user breakpc:0x60043754, error address: 0x0Stack Trace:FP: 0x80007e78, PC: 0x60043754FP: 0x80007ed8, PC: 0x6001540cFP: 0x80007ef8, PC: 0x600087f0FP: 0x80007f18, PC: 0x80008734tclquit
To exit from a tool command language (TCL) shell, use the tclquit command.
tclquit
Syntax Description
This command has no keywords or arguments.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
TCL shell. This mode is indicated by the prompt Console>(tclsh)(enable).
Usage Guidelines
For more information about TCL, refer to the "Administering the Switch" chapter of the Catalyst 6500 Series Switch Software Configuration Guide.
Examples
This example shows how to exit from a TCL shell and return to privileged mode:
Console> (tclsh)(enable) tclquitConsole> (enable)Related Commands
tclsh
To start a tool command language (TCL) shell, use the tclsh command.
tclsh
Syntax Description
This command has no keywords or arguments.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
TCL is a programmable, text-based language that allows you to write command procedures that expand the capabilities of the built-in set of commands. It is used primarily with interactive programs such as text editors, debuggers, illustrators, and shells.
TCL provides a standard syntax so that once you know TCL, you can issue commands to any TCL-based application. Using the utility commands and the general programming interface of TCL, you can implement a few low-level commands and build them into more complex commands.
When you start a TCL shell, the switch prompt changes from Console> (enable) to Console> (tclsh)(enable).
All TCL commands and constructions are available once the TCL shell is active.
For a list of TCL commands and constructions, refer to the "Administering the Switch" chapter of the Catalyst 6500 Series Switch Software Configuration Guide.
Examples
This example shows how to start a TCL shell:
Console> (enable) tclshConsole> (tclsh)(enable)Related Commands
telnet
To start a Telnet connection to a remote host or to encrypt a Telnet session, use the telnet command.
telnet host [port]
telnet encrypt kerberos host
Syntax Description
host
Name or IP address of the remote host to which you want to connect.
port
(Optional) Specific port connection on the remote host.
encrypt kerberos
Encrypts the Telnet session.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
After you authenticate to a switch using Kerberos and you make a Telnet connection to another switch or host, that connection might not be authenticated by Kerberos. Whether or not the Telnet connection is authenticated by Kerberos depends on the authentication method that the Telnet server uses. If the Telnet server uses Kerberos for authentication, you can encrypt all application data packets for the duration of the Telnet session by using the telnet encrypt kerberos command.
Examples
This example shows how to open and close a Telnet session with the host elvis:
Console> (enable) telnet elvisTrying 192.122.174.11...Connected to elvis.Escape character is '^]'.UNIX(r) System V Release 4.0 (elvis)login: fredPassword:Last login: Thu Oct 15 09:25:01 from forster.cisc.rumSun Microsystems Inc. SunOS 5.4 Generic July 1994You have new mail.% logoutConsole> (enable)Related Commands
clear kerberos creds
disconnect
show kerberostest cable-diagnostics
To test the condition of 10-Gigabit Ethernet links and copper cables on 48-port 10/100/1000 BASE-T modules, use the test cable-diagnostics command.
test cable-diagnostics prbs {start | stop} mod/port
test cable-diagnostics tdr mod/port
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
The PRBS test is currently available only on the 1-port 10GBASE-E serial 10-Gigabit Ethernet module (WS-X6502-10GE).
To run the PRBS test properly between two devices, you must start it on both ends of the cable. If the cable is looped back, a single end can generate the test sequence (on the Tx) as well as verify it and count the errors (on the Rx).
Before the PRBS test starts, the port is automatically put in errdisable state. The errdisable timeout is disabled for the port so that the port is not automatically reenabled after the timeout interval concludes. The errdisable timeout is automatically reenabled on the port after the PRBS test finishes.
When the PRBS test is running, the system will not you permit you to enter the set port enable and set port disable commands.
The TDR test is supported on these modules: WS-X6148-GE-TX, WS-X6148V-GE-TX, WS-X6548-GE-TX, WS-X6548V-GE-TX, WS-X6548-GE-45AF, WS-X6748-GE-TX, WS-X6148A-GE-TX, WS-X6148-GE-45AF, WS-X6148A-GE-45AF, WS-X6148A-RJ-45, and WS-X6148A-45AF.
Note
When you run the TDR test, we recommend that you do not make any configurations on the port that you are testing or enter the show port command for that port. If you make any port-related configurations or enter the show port command, the TDR test results might be inaccurate or the module might fail.
Examples
This example shows how to start the PRBS test on port 1 on module 5:
Console> (enable) test cable-diagnostics prbs start 5/1PRBS cable-diagnostic test started on port 5/1.Console> (enable)This example shows how to stop the PRBS test on port 1 on module 5:
Console> (enable) test cable-diagnostics prbs stop 5/1PRBS cable-diagnostic test stopped on port 5/1.Console> (enable)This example shows the message that displays when the PRBS test is not supported:
Console> (enable) test cable-diagnostics prbs start 6/1Feature not supported on module 6.Console> (enable)This example shows how to start the TDR test on port 1 on module 8:
Console> (enable) test cable-diagnostics tdr 8/1TDR test started on port 8/1. Use show port tdr <m/p> to see the resultsConsole> (enable)Related Commands
test snmp trap
To send an SNMP trap message to the trap receivers, use the test snmp trap command.
test snmp trap {trap_num [specific_num] | trap_name}
Syntax Description
trap_num
Number of the trap.
specific_num
(Optional) Number of a predefined trap.
trap_name
Name of the notification defined in the MIB.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
You must enable the SNMP trap before testing.
Examples
This example shows how to run trap 0:
Console> (enable) test snmp trap 0SNMP trap message sent. (4)Console> (enable)These examples show how to test SNMP traps by specific names:
Console> (enable) test snmp trap ciscoRFSwactNotifciscoRFSwactNotif notification was sent.Console> (enable)Console> (enable) test snmp trap ciscoFlashDeviceInsertedNotifciscoFlashDeviceInsertedNotif notification was sent.Console> (enable)Related Commands
traceroute
To display a hop-by-hop path through an IP network from the Catalyst 6500 series switch to a specific destination host, use the traceroute command.
traceroute [-n] [-w wait_time] [-i initial_ttl] [-m max_ttl] [-p dest_port] [-q nqueries] [-t tos]
host [data_size]Syntax Description
Defaults
Entering the traceroute host command without options sends three 40-byte ICMP datagrams with an initial TTL of 1, a maximum TTL of 30, a timeout period of 5 seconds, and a ToS specification of 0 to destination UDP port number 33434. For each host in the processed path, the initial TTL for each host and the destination UDP port number for each packet sent are incremented by one.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
To interrupt traceroute after the command has been issued, press Ctrl-C.
The traceroute command uses the TTL field in the IP header to cause routers and servers to generate specific return messages. Traceroute starts by sending a UDP datagram to the destination host with the TTL field set to 1. If a router finds a TTL value of 1 or 0, it drops the datagram and sends back an ICMP "time-exceeded" message to the sender. The traceroute facility determines the address of the first hop by examining the source address field of the ICMP time-exceeded message.
To identify the next hop, traceroute again sends a UDP packet but this time with a TTL value of 2. The first router decrements the TTL field by 1 and sends the datagram to the next router. The second router sees a TTL value of 1, discards the datagram, and returns the time-exceeded message to the source. This process continues until the TTL is incremented to a value large enough for the datagram to reach the destination host (or until the maximum TTL is reached).
To determine when a datagram has reached its destination, traceroute sets the UDP destination port in the datagram to a very large value that the destination host is unlikely to be using. When a host receives a datagram with an unrecognized port number, it sends an ICMP "port unreachable" error to the source. This message indicates to the traceroute facility that it has reached the destination.
Catalyst 6500 series switches can participate as the source or destination of the traceroute command. However, because they are Layer 2 devices, Catalyst 6500 series switches do not examine the TTL field in the IP header and do not decrement the TTL field or send ICMP time-exceeded messages. Thus, a Catalyst 6500 series switch does not appear as a hop in the traceroute command output.
Use the tos option to see if different types of service cause routes to change.
Examples
This example shows how to use the traceroute command to determine the path from the source to the destination host server10:
Console> (enable) traceroute server10traceroute to server10.company.com (172.16.22.7), 30 hops max, 40 byte packets1 engineering-1.company.com (172.31.192.206) 2 ms 1 ms 1 ms2 engineering-2.company.com (172.31.196.204) 2 ms 3 ms 2 ms3 gateway_a.company.com (172.16.1.201) 6 ms 3 ms 3 ms4 server10.company.com (172.16.22.7) 3 ms * 2 msConsole> (enable)Table 2-119 describes the fields in the traceroute command output.
If traceroute receives an ICMP error message other than a time-exceeded or port-unreachable message, it prints one of the error codes shown in Table 2-120 instead of the round-trip time or an asterisk (*).
Related Commands
traceroute ethernet
To transmit Ethernet CFM traceroute messages to a specific destination MAC address, use the traceroute ethernet command.
traceroute ethernet dest-mac domain domain-name vlan vlan
traceroute ethernet dest-mac level level vlan vlan
traceroute ethernet dest-mac vlan vlan
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Normal.
Usage Guidelines
This command sends out Ethernet CFM traceroute messages to a device specified by a destination MAC address. You must include a VLAN because the same device may be present in multiple VLANs.
Examples
This example specifies a ping to MAC address 00-d0-00-b3-6b-fb in VLAN 2, for maintenance points in domain sjlabf1 at level 1:
Console> traceroute ethernet 00-d0-00-b3-6b-fb vlan 2 domain sjlabf1 level 1Type escape sequence to abort. TTL 255. Per-Hop Timeout is 10 seconds--------------------------------------------------------------------------------Hop Host MAC Ingress Ingress Relay egress egress NextHopPort Action Action Port Action--------------------------------------------------------------------------------B 1 6509 00-90-6f-96-23-fb 1/2 IngOk RlyCCDBConsole>)unalias
To remove the alias name and associated value from the alias list, use the unalias command.
unalias name
Syntax Description
Defaults
This command has no default settings.
Command Types
ROM monitor command.
Command Modes
Normal.
Usage Guidelines
You must issue a sync command to save your change. Otherwise, the change is not saved and the reset—ROM monitor command removes your change.
Examples
This example shows how to use the unalias command to remove the s alias and then check to ensure it was removed:
rommon 5 > aliasr=repeath=history?=helpb=bootls=diri=resetk=stacks=setrommon 6 > unalias srommon 7 > aliasr=repeath=history?=helpb=bootls=diri=resetk=stackrmmon 8 > smonitor: command "s" not found===========================================================================Related Commands
undelete
To recover a deleted file on a Flash memory device, use the undelete command. The deleted file can be recovered using its index (because there could be multiple deleted files with the same name).
undelete index [[m/]device:]
Syntax Description
index
Index number of the deleted file.
m/
(Optional) Module number of the supervisor engine containing the Flash device.
device:
(Optional) Device where the Flash resides.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
A colon (:) is required after the specified device. See the dir—switch command to learn the index number of the file to be undeleted. A file cannot be undeleted if a valid file with the same name exists. You must delete the existing file before you can undelete the target file. A file can be deleted and undeleted up to 15 times. To delete all deleted files permanently on a device, use the squeeze command.
Examples
This example shows how to recover the deleted file with index 1 and use the show flash command to confirm:
Console> (enable) undelete 1 bootflash:Console> (enable)Console> (enable) show flash-#- ED --type-- --crc--- -seek-- nlen -length- -----date/time------ name1 .. ffffffff fec05d7a 4b3a4c 25 4667849 Mar 03 2000 08:52:09 cat6000-sup.5-3-4-CSX.bin2 .. ffffffff 4e5efc31 c0fadc 30 7716879 May 19 2000 06:50:55 cat6000-sup-d.6-1-0.bin3605796 bytes available (12384988 bytes used)Console> (enable)Related Commands
unset=varname
To remove a variable name from the variable list, use the unset=varname command.
unset=varname
Syntax Description
Defaults
This command has no default settings.
Command Types
ROM monitor command.
Command Modes
Normal.
Usage Guidelines
You must enter the sync command to save your change to NVRAM. Otherwise, the change is not saved and a reset removes your change.
Examples
This example shows how to use the set command to display the variable list, remove a variable name from the variable list, and then display the variable list to verify:
rommon 2 > setPS1=rommon ! >BOOT=?=0rommon 3 > unset=0rommon 4 > setPS1=rommon ! >BOOT=Related Commands
varname=
To set the variable VARNAME to varvalue, use the varname= command. Note that the syntax varname= sets the variable to a NULL string.
varname=value
Syntax Description
Defaults
This command has no default settings.
Command Types
ROM monitor command.
Command Modes
Normal.
Usage Guidelines
Do not put a space before or after the equal (=) sign. If there are spaces, you must place the value in quotes. Spell out variable names in uppercase letters to make them conspicuous.
Examples
This example shows how to assign a variable name to a value:
rommon 1 > s=setrommon 2 > sPS1=rommon ! >BOOT=?=0Related Commands
verify
To confirm the checksum of a file on a Flash device, use the verify command.
verify [[m/]device:] filename
Syntax Description
m/
(Optional) Module number of the supervisor engine containing the Flash device.
device:
(Optional) Device where the Flash resides.
filename
Name of the configuration file.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
A colon (:) is required after the specified device.
Examples
This example shows how to use the verify command:
Console> verify cat6k_r47_1.cbi..........................................................File cat6k_r47_1.cbi verified OK.wait
To cause the CLI to pause for a specified number of seconds before executing the next command, use the wait command. This command might be included in a configuration file.
wait seconds
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Normal.
Examples
This example shows how to pause the CLI for 5 seconds:
Console> wait 5Console>whichboot
To determine which file booted, use the whichboot command.
whichboot
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to use the whichboot command:
Console> whichbootBoot image name is 'slot0:cat6000-sup.6-1-1.bin'.Console>write
To upload the current configuration to the network or , use the write command.
write network [all]
write terminal [all]
write {host file} [all] [rcp]
write memory
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
The write terminal command is exactly the same as the show config command. The write host file command is a shorthand version of the write network command.
You cannot use the write network command to upload software to the ATM module.
With the write network command, the file must already exist on the host (use the UNIX touch filename command to create it).
Before you can enter the write memory command, you must enter text configuration mode. Enter text configuration mode by entering the set config mode text command.
Examples
This example shows how to upload the system5.cfg file to the mercury host:
Console> (enable) write networkIP address or name of host? mercuryName of configuration file to write? system5.cfgUpload configuration to system5.cfg on mercury (y/n) [y]? y/Done. Finished Network Upload. (9003 bytes)Console> (enable)This example shows how to upload the system5.cfg file to the mercury host:
Console> (enable) write mercury system5.cfgUpload configuration to system5.cfg on mercury (y/n) [y]? y/Done. Finished Network Upload. (9003 bytes)Console> (enable)This example shows how to display the configuration file on the terminal (partial display):
Console> (enable) write terminal!........................................begin!#version 4.2(0.24)VAI58 set password $1$FMFQ$HfZR5DUszVHIRhrz4h6V70set enablepass $1$FMFQ$HfZR5DUszVHIRhrz4h6V70set prompt Console>set length 24 defaultset logout 20set banner motd ^C^C!#systemset system baud 9600set system modem disableset system nameset system locationset system contact!#powerset power redundancy enable!#snmpset snmp community read-only publicset snmp community read-write privateset snmp community read-write-all secretset snmp rmon disableset snmp trap disable module...<<<< output truncated >>>>This example shows how to upload the running system configuration to a prespecified location:
Console> (enable) write memoryUpload configuration to bootflash:switch.cfg7165844 bytes available on device bootflash, proceed (y/n) [n]? yConsole> (enable)Related Commands
copy
set config mode
show configwrite tech-support
To generate a report that contains status information about your switch or upload the output of the command to a TFTP server, where you can send it to the Technical Assistance Center, use the write tech-support command.
write tech-support host file [module mod] [vlan vlan] [mistp-instance instance] [mst instance] [memory] [config]
write tech-support host file [port mod/port] [vlan vlan] [mistp-instance instance] [mst instance] [memory] [config]
Syntax Description
Defaults
By default, this command displays the output for technical-support-related show commands. Use keywords to specify the type of information to be displayed. If you do not specify any parameters, the system displays all configuration, memory, module, port, instance, and VLAN data.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
Caution
Note
Note
If you specify the config keyword, the write tech-support command displays the output of these commands:
•
•
•
•
•
•
•
•
•
•
•
•
•
Note
Note
If you specify the memory keyword, the write tech-support command displays the output of these commands:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
If you specify a module, port, or VLAN number, the system displays general system information and information for the component you specified.
Examples
This example shows how to upload the technical report:
Console> (enable) write tech-support 172.20.32.10 tech.txtUpload tech-report to tech.txt on 172.20.32.10 (y/n) [n]? y/Finished network upload. (67784 bytes)Console> (enable)Related Commands
show tech-support
See the commands listed in the "Usage Guidelines" section.
