-
Catalyst 6500 Series Command Reference, 6.3 and 6.4
-
Quick Links to Catalyst 6500 Series Switch and ROM Monitor Commands
-
Index
-
Preface
-
Command-Line Interfaces
-
alias to boot
-
cd to clear mls entry cef adjacency
-
clear mls exclude protocol to clear vtp pruneeligible
-
clear vtp statistics to disable
-
disconnect to enable
-
format to ping
-
pwd to reset-switch
-
restore counters to set crypto key rsa
-
set default portstatus to set logging timestamp
-
set logout to set pbf
-
set port auxiliaryvlan to set rcp username
-
set rgmp to set spantree portvlanpri
-
set spantree priority to set trunk
-
set udld to set vtp pruneeligible
-
show accounting to show default
-
show dot1q-all-tagged to show interface
-
show ip alias to show ip permit
-
show ip route to show pbf
-
show port to show snmp
-
show snmp access to show tech-support
-
show test to show udld
-
show users to squeeze
-
stack to write tech-support
-
Acronyms
-
Table Of Contents
stack
Use the stack command to dump a stack trace of frames.
stack [-d | -m] [num]
Syntax Description
-d
(Optional) Keyword to dump the ROM monitor stack.
-m
(Optional) Keyword to specify 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
Use the switch command to switch the clock from the supervisor clock to the internal clock or from the active supervisor engine to the standby supervisor engine.
switch {clock | supervisor}
Syntax Description
clock
Keyword to switch the clock from the supervisor clock to the internal clock.
supervisor
Keyword to switch 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
Use the switch console command to switch the console connection physically to the MSFC on the active supervisor engine.
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 standby supervisor engine consoles. Otherwise, you cannot use the switch console command to switch to the console of the MSFC placed in the standby 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
Use the switch fabric command to reset the active Switch Fabric Module and allow the standby Switch Fabric Module to take over.
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
Use the sync command to write the working in-core copy of environment variables and the aliases out to NVRAM so they are read on the next reset.
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
Use the sysret command to display the return information from the last booted system image.
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: 0x80008734telnet
Use the telnet command to start a Telnet connection to a remote host.
telnet host [port]
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.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
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
test snmp trap
Use the test snmp trap command to send an SNMP trap message to the trap receivers.
test snmp trap trap_num [specific_num]
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to run trap 0:
Console> (enable) test snmp trap 0SNMP trap message sent. (4)Console> (enable)Related Commands
traceroute
Use the traceroute command to display a hop-by-hop path through an IP network from the Catalyst 6000 family switch to a specific destination host.
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 6000 family switches can participate as the source or destination of the traceroute command. However, because they are Layer 2 devices, Catalyst 6000 family 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 6000 family 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-102 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-103 instead of the round-trip time or an asterisk (*).
Related Commands
unalias
Use the unalias command to remove the alias name and associated value from the alias list.
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
Use the undelete command to recover a deleted file on a Flash memory device. 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
Use the unset=varname command to remove a variable name from the variable list.
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=
Use the varname= command to set the variable VARNAME to varvalue. 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
Use the verify command to confirm the checksum of a file on a Flash device.
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
Use the wait command to cause the CLI to pause for a specified number of seconds before executing the next 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
Use the whichboot command to determine which file booted.
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
Use the write command set to upload the current configuration to the network or .
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
set config mode
show config
copywrite tech-support
Use the write tech-support command set 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.
write tech-support host file [module mod] [vlan vlan] [memory] [config]
write tech-support host file [port mod/port] [vlan vlan] [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
CautionAvoid running multiple write tech-support commands on a switch or multiple switches on the network segment. Doing so may cause spanning tree instability.
Note
Note
If you specify the config keyword, the write tech-support command displays the output of these commands:
•
•
•
•
•
•
•
•
•
•
•
•
•
Note
If you specify the memory keyword, the write tech-support command displays the output of these commands:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Note
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.
