Table of Contents

Switch CLI

Accessing the Switch CLI

Accessing the Switch CLI via the Console Port (EIA/TIA-232)
Accessing the Switch CLI via Telnet

Operating the Switch CLI

Accessing the Command Modes
Using Command-Line Processing
Using the Command-Line Editing Features
Using Command Aliases
Using History Substitution
Accessing Command Help
Designating Modules, Ports, and VLANs
Designating MAC Addresses, IP Addresses, and IP Aliases

Switch Commands Quick Reference
ROM Monitor CLI

Accessing the ROM Monitor CLI
Operating the ROM Monitor CLI

ROM Monitor Commands Quick Reference

Command-Line Interfaces

This chapter describes the command-line interfaces (CLI) available on the Catalyst  6000 and 6500 series switches and contains the following sections:

• Switch CLI on page 1-1

• Switch Commands Quick Reference on page 1-10

• ROM Monitor CLI on page 1-21

• ROM Monitor Commands Quick Reference on page 1-22

For definitions of any terms listed in this publication, refer to Internetworking Terms and Acronyms; "Acronyms," contains a list of acronyms.

Switch CLI

The Catalyst  6000 and 6500 series switches are multimodule systems. Commands you enter from the CLI can apply to the entire system or to a specific module, port, or VLAN.

You can configure and maintain the Catalyst  6000 and 6500 series EtherChannel modules by entering commands from the switch CLI. The CLI is a basic command-line interpreter similar to the UNIX C shell.

Accessing the Switch CLI

You can access the switch CLI from a console terminal connected to an EIA/TIA-232 port or through a Telnet session. The CLI allows fixed baud rates. Telnet sessions disconnect automatically after remaining idle for a user-defined time period.

Accessing the Switch CLI via the Console Port (EIA/TIA-232)

To access the switch through the console (EIA/TIA-232) port, perform these steps:

Task	Command
Step 1 From the Cisco Systems Console prompt, press Return.
Step 2 At the prompt, enter the system password. The Console> prompt appears indicating that you have accessed the CLI in normal mode.	<password>
Step 3 Enter the necessary commands to complete your desired tasks.	Appropriate commands
Step 4 When finished, exit the session.	quit

After connecting through the console port, you see this display:

Cisco Systems Console
Enter password:
Console>
Console>

Accessing the Switch CLI via Telnet

To access the switch through a Telnet session, you must first set the IP address for the switch. You can open multiple sessions to the switch via Telnet.

To access the switch from a remote host with Telnet, perform these steps:

Task	Command
Step 1 From the remote host, enter the telnet command and the name or IP address of the switch you want to access.	telnet hostname | ip_addr
Step 2 At the prompt, enter the password for the CLI. If no password has been configured, press Return.	<password>
Step 3 Enter the necessary commands to complete your desired tasks.	Appropriate commands
Step 4 When finished, exit the Telnet session.	quit

After connecting through a Telnet session, you see this display:

host% telnet cat6000-1.cisco.com
Trying 172.16.44.30 ...
Connected to cat6000-1.

Operating the Switch CLI

This section describes command modes and functions that allow you to operate the switch CLI.

Accessing the Command Modes

The CLI has two modes of operation: normal and privileged. Both are password-protected. Use normal-mode commands for everyday system monitoring. Use privileged commands for system configuration and basic troubleshooting.

After you log in, the system enters normal mode, which gives you access to normal-mode commands only. You can enter privileged mode by entering the enable command followed by the enable password. Privileged mode is indicated by the word "enable" in the system prompt. To return to normal mode, enter the disable command at the prompt.

The following example shows how to enter privileged mode:

Console> enable
Enter password: <password>
Console> (enable)

Using Command-Line Processing

Switch commands are not case-sensitive. You can abbreviate commands and parameters as long as they contain enough letters to be different from any other currently available commands or parameters. You can scroll through the last 20 commands stored in the history buffer, and enter or edit the command at the prompt. (See Table 1-1.)

Using the Command-Line Editing Features

Catalyst 6000 and Catalyst 6500 series switch software includes an enhanced editing mode that provides a set of editing key functions similar to those of the Emacs editor. You can enter commands in uppercase, lowercase, or a mix of both. Only passwords are case-sensitive. You can abbreviate commands and keywords to the number of characters that allow a unique abbreviation.

For example, you can abbreviate the show command to sh. After entering the command at the system prompt, press Return to execute the command.

Moving Around on the Command Line

Perform one of these tasks to move the cursor around on the command line for corrections or changes:

Task	Keystrokes
Move the cursor back one character.	Press Ctrl-B or press the left arrow key1.
Move the cursor forward one character.	Press Ctrl-F or press the right arrow key1.
Move the cursor to the beginning of the command line.	Press Ctrl-A.
Move the cursor to the end of the command line.	Press Ctrl-E.
Move the cursor back one word.	Press Esc B.
Move the cursor forward one word.	Press Esc F.

1The arrow keys function only on ANSI-compatible terminals such as VT100s.

Pasting in Buffer Entries

The system provides a buffer that contains the last ten items you deleted. You can recall these items and paste them in the command line by performing this task:

Task	Keystrokes
Step 1 Recall the most recent entry in the buffer.	Press Ctrl-Y.
Step 2 Recall the next buffer entry.	Press Esc Y.

The buffer contains only the last ten items you have deleted or cut. If you press Esc Y more than ten times, you cycle back to the first buffer entry.

Editing Command Lines That Wrap

The new editing command set provides a wraparound feature for commands that extend beyond a single line on the screen. When the cursor reaches the right margin, the command line shifts ten spaces to the left. You cannot see the first ten characters of the line, but you can scroll back and check the syntax at the beginning of the command. To scroll back, perform this task:

Task	Keystrokes
Return to the beginning of a command line to verify that you have entered a lengthy command correctly.	Press Ctrl-B or the left arrow key repeatedly until you scroll back to the beginning of the command entry, or press Ctrl-A to return directly to the beginning of the line1.

1The arrow keys function only on ANSI-compatible terminals such as VT100s.

Use line wrapping with the command history feature to recall and modify previous complex command entries. See the "Using History Substitution" section for information about recalling previous command entries.

The system assumes your terminal screen is 80 columns wide. If your screen has a different width, enter the terminal width command to tell the router the correct width of your screen.

Deleting Entries

Perform one of these tasks to delete command entries if you make a mistake or change your mind:

Task	Keystrokes
Erase the character to the left of the cursor.	Press the Delete or Backspace key.
Delete the character at the cursor.	Press Ctrl-D.
Delete from the cursor to the end of the command line.	Press Ctrl-K.
Delete from the cursor to the beginning of the command line.	Press Ctrl-U or Ctrl-X.
Delete the word to the left of the cursor.	Press Ctrl-W.
Delete from the cursor to the end of the word.	Press Esc D.

Scrolling Down a Line or a Screen

When you use the help facility to list the commands in a particular mode, the list is often longer than the terminal screen can display. In such cases, a ---More--- prompt is displayed at the bottom of the screen. To view the next line or screen, perform these tasks:

Task	Keystrokes
Scroll down one line.	Press the Return key.
Scroll down one screen.	Press the Spacebar.

Redisplaying the Current Command Line

If you enter a command and the system suddenly sends a message to your screen, you can recall your current command line entry. To do so, perform this task:

Task	Keystrokes
Redisplay the current command line.	Press Ctrl-L or Ctrl-R.

Transposing Mistyped Characters

If you mistype a command entry, you can transpose the mistyped characters by performing this task:

Task	Keystrokes
Transpose the character to the left of the cursor with the character located at the cursor.	Press Ctrl-T.

Controlling Capitalization

You can change words to uppercase or lowercase, or capitalize a set of letters, with simple keystroke sequences:

Task	Keystrokes
Capitalize at the cursor.	Press Esc C.
Change the word at the cursor to lowercase.	Press Esc L.
Capitalize letters from the cursor to the end of the word.	Press Esc U.

Designating a Keystroke as a Command Entry

You can use a particular keystroke as an executable command. Perform this task:

Task	Keystrokes
Insert a code to indicate to the system that the keystroke immediately following should be treated as a command entry, not an editing key.	Press Ctrl-V or Esc Q.

Using Command Aliases

Like regular commands, aliases are not case-sensitive. However, unlike regular commands, some aliases cannot be abbreviated. See Table 1-2 for a list of switch CLI aliases that cannot be abbreviated.

Using History Substitution

Commands that you enter during each terminal session are stored in a history buffer, which stores the last 20 commands you entered during a terminal session. History substitution allows you to access these commands without retyping them by using special abbreviated commands. (See Table 1-3.)

Table 1-3: History Substitution Commands

Command	Function
To repeat recent commands:
!!	Repeat the most recent command.
!-nn	Repeat the nnth most recent command.
!n	Repeat command n.
!aaa	Repeat the command beginning with string aaa.
!?aaa	Repeat the command containing the string aaa.
To modify and repeat the most recent command:
^aaa^bbb	Replace string aaa with string bbb in the most recent command.
To add a string to the end of a previous command and repeat it:
!!aaa	Add string aaa to the end of the most recent command.
!n aaa	Add string aaa to the end of command n.
!aaa bbb	Add string bbb to the end of the command beginning with string aaa.
!?aaa bbb	Add string bbb to the end of the command containing string aaa.

Accessing Command Help

To see a list of top-level commands and command categories, type help or ? in normal or privileged mode. Context-sensitive help (usage and syntax information) for individual commands can be seen by appending help or ? to any specific command. If you enter a command using the wrong number of arguments or inappropriate arguments, usage and syntax information for that command is displayed. Additionally, appending help or ? to a command category displays a list of commands in that category.

Console> help
Commands:
----------------------------------------------------------------------
cd                  Set default flash device
dir                 Show list of files on flash device
enable              Enable privileged mode
help                Show this message
history             Show contents of history substitution buffer
ping                Send echo packets to hosts
pwd                 Show default flash device
quit                Exit from the Admin session
session             Tunnel to ATM or Router module
set                 Set, use 'set help' for more info
show                Show, use 'show help' for more info
traceroute          Trace the route to a host
verify              Verify checksum of file on flash device
wait                Wait for x seconds
whichboot           Which file booted Console>
Console> 

Console> (enable) help
Commands:
----------------------------------------------------------------------
cd                  Set default flash device
clear               Clear, use 'clear help' for more info
configure           Configure system from network
copy                Copy files between TFTP/module/flash devices
delete              Delete a file on flash device
dir                 Show list of files on flash device
disable             Disable privileged mode
disconnect          Disconnect user session
download            Download code to a processor
enable              Enable privileged mode
format              Format a flash device
help                Show this message
history             Show contents of history substitution buffer
ping                Send echo packets to hosts
pwd                 Show default flash device
quit                Exit from the Admin session
reconfirm           Reconfirm VMPS
reload              Force software reload to linecard
reset               Reset system or module
session             Tunnel to ATM or Router module
set                 Set, use 'set help' for more info 
show                Show, use 'show help' for more info
slip                Attach/detach Serial Line IP interface
squeeze             Reclaim space used by deleted files
switch              Switch to standby <clock|supervisor>
telnet              Telnet to a remote host
test                Test, use 'test help' for more info
traceroute          Trace the route to a host
undelete            Undelete a file on flash device
upload              Upload code from a processor
verify              Verify checksum of file on flash device
wait                Wait for x seconds
whichboot           Which file booted
write               Write system configuration to terminal/network 
Console> (enable)

Console> (enable) clear help
 
Clear commands:
----------------------------------------------------------------------------
clear alias                  Clear aliases of commands
clear arp                    Clear ARP table entries
clear banner                 Clear Message Of The Day banner
clear boot                   Clear booting environment variable
clear cam                    Clear CAM table entries
clear channel                Clear PAgP statistical information 
...

Console> set length help
Usage: set length <screenlength> [default]
       (screenlength = 5..512, 0 to disable 'more' feature) 
Console> 

Designating Modules, Ports, and VLANs

The Catalyst  6000 and 6500 series modules (module slots), ports, and VLANs are numbered starting with 1. The supervisor engine module is module 1, residing in the top slot. On each module, port 1 is the left-most port. To reference a specific port on a specific module, the command syntax is mod_num/port_num. For example, 3/1 denotes module 3, port 1. In some commands, such as set trunk, set cam, and set vlan, you can enter lists of ports and VLANs.

To reference ports or a range of ports on a specific module, the command syntax is mod/ports...You can designate ports by entering the module and port number pairs, separated by commas. To specify a range of ports, use a dash (-) between the module number and port number pairs. Dashes take precedence over commas. The following examples show several ways of designating ports:

Example 1: 2/1,2/3 denotes module 2, port 1 and module 2, port 3.

Example 2: 2/1-12 denotes module 2, ports 1 through 12.

Example 3: 2/1-2/12 also denotes module 2, ports 1 through 12.

Each VLAN is designated by a single number. You can specify lists of VLANs the same way you do for ports. Individual VLANs are separated by commas (,); ranges are separated by dashes (-). In this example, VLANs 1 through 10 and VLAN 1000 are specified:

1-10,1000	

Designating MAC Addresses, IP Addresses, and IP Aliases

Some commands require a MAC address, IP address, or IP alias, which you must designate in a standard format. The MAC address format must be six hexadecimal numbers separated by hyphens, as shown in this example:

00-00-0c-24-d2-fe
 

The IP address format is 32 bits, written as four octets separated by periods (dotted decimal format). IP addresses are made up of a network section, an optional subnet section, and a host section, as shown in this example:

126.2.54.1
 

If the IP alias table is configured, you can use IP aliases in place of the dotted decimal IP address. This is true for most commands that use an IP address, except commands that define the IP address or IP alias.

Switch Commands Quick Reference

Table 1-4 identifies each command in the switch command set, shows the command syntax, provides a short description, and specifies the mode for the command. The available modes are:

• P=Privileged

• N=Normal

Table 1-4: Switch Command Set

Command	Syntax	Description	Mode
cd	cd [[m/]device:]	Sets the default Flash device.	P
clear alias	clear alias {name | all}	Clears the specified alias of a command.	P
clear arp	clear arp {ip_addr | all}	Clears ARP table entries.	P
clear banner motd	clear banner motd	Clears the message-of-the-day banner.	P
clear boot system	clear boot system all [mod_num] clear boot system flash device:[filename] [mod_num]	Clears the boot value.	P
clear cam	clear cam {mac_addr | dynamic | static | permanent} [vlan]	Clears CAM table entries.	P
clear channel statistics	clear channel statistics	Clears PAgP statistical information.	P
clear config	clear config {mod_num | rmon | all}	Clears the configuration and resets the system.	P
clear counters	clear counters	Clears MAC and port counters.	P
clear igmp statistics	clear igmp statistics	Clears IGMP statistical information.	P
clear ip alias	clear ip alias {name | all}	Clears IP address aliases.	P
clear ip dns domain	clear ip dns domain	Clears the default DNS domain name.	P
clear ip dns server	clear ip dns server {ip_addr | all}	Clears the IP address of a DNS server.	P
clear ip permit	clear ip permit {ip_addr | all}[mask]	Clears hosts from the IP permit list.	P
clear ip route	clear ip route destination gateway	Clears IP routing table entries.	P
clear log	clear log [mod_num]	Deletes all entries in the system error log.	P
clear logging buffer	clear logging buffer	Clears the system logging buffer.	P
clear logging server	clear logging server ip_addr	Deletes a syslog server from the configuration.	P
clear multicast router	clear multicast router {mod_num/port_num | all}	Clears multicast router ports.	P
clear ntp server	clear ntp server {ip_addr | all}	Deletes an NTP server from the server table.	P
clear port broadcast	clear port broadcast mod_num/port_num	Disables broadcast/multicast suppression on one or more ports.	P
clear port qos cos	clear port qos mod/ports.. cos	Returns the values set by the set port qos cos command to the factory-set default values for all ports.	P
clear qos config	clear qos config	Returns the values set by various QoS commands to the factory-set default values.	P
clear qos mac-cos	clear qos mac-cos dest_mac [vlan] clear qos mac-cos all	Returns the values set by the set qos mac-cos command to the factory-set default values.	P
clear qos map	clear qos map port_type	Returns the values set by the set qos map command to the factory-set default values for the specified ports.	P
clear snmp trap	clear snmp trap {rcvr_addr | all}	Clears SNMP trap receiver addresses.	P
clear spantree portvlancost	clear spantree portvlancost mod_num/port_num [vlan_list]	Clears spanning-tree path cost to a VLAN on a port.	P
clear spantree portvlanpri	clear spantree portvlanpri mod_num/port_num [vlans]	Clears spanning-tree port VLAN priority.	P
clear spantree root	clear spantree root [vlan_list]	Restores the switch priority and Spanning-Tree Protocol parameters to the default values.	P
clear spantree statistics	clear spantree statistics [vlan_list]	Clears spanning-tree statistics.	P
clear spantree uplinkfast	clear spantree uplinkfast	Turns off the UplinkFast features and returns the switch priority and port costs to the factory default values.	P
clear tacacs key	clear tacacs key	Clears the key used for TACACS+ authentication and encryption.	P
clear tacacs server	clear tacacs server ip_addr	Removes a host from the list of TACACS+ servers.	P
clear timezone	clear timezone	Clears NTP time zone information.	P
clear top	clear top {all | report_num}	Stops the TopN process.	P
clear trunk	clear trunk mod_num/port_num [vlans]	Resets trunk ports and clears information from the trunk table.	P
clear vlan	clear vlan vlan_num	Deletes a VLAN from a management domain.	P
clear vlan mapping	clear vlan mapping dot1q 1q_vlan_num | all	Deletes an existing 802.1Q VLAN to ISL VLAN-mapped pair.	P
clear vtp pruneeligible	clear vtp pruneeligible vlan_num	Turns off the pruning eligibility of a VLAN.	P
clear vtp statistics	clear vtp statistics	Deletes VTP statistics.	P
configure	configure {host file | network}	Downloads a configuration file from the network and executes each command in the file.	P
copy	copy file-id {tftp | flash | file-id | config} copy tftp {flash | file-id | config} copy flash {tftp | file-id | config} copy config {flash | file-id | tftp}	Copies software images between a supervisor engine and a host.	P
delete	delete [[m/]device:] filename	Deletes a file.	P
dirswitch	dir [[m/]device:][filename] [all | deleted | long]	Displays a list of files on a Flash device.	N
disable	disable	Returns the CLI to normal mode.	P
disconnect	disconnect {ip_addr | console}	Closes an active console port or Telnet session.	P
download	download host file [mod_num] download serial	Copies a software image from a host to a module's Flash memory.	P
enable	enable	Activates CLI privileged mode.	N
format	format [spare spare-num] [m/]device1: [[device2:][monlib_filename]]	Formats a Flash device.	P
historyswitch	history	Displays the contents of the command history buffer.	N
ping	ping [-s] host [packet_size] [packet_count]	Sends ICMP echo request packets to another node on the network.	N
pwd	pwd [[m/]device:]	Displays the current setting of the cd command.	P
quit	quit	Exits the CLI session.	N
resetswitch	reset {mod_num | system}	Sets the system to its default values or configures the system as an individual module.	P
set alias	set alias name command [parameter] [parameter]	Creates an alias for a command.	P
set arp	set arp ip_addr hw_addr [route_descr] | agingtime agingtime	Creates an ARP table entry and sets the ARP entry aging time.	P
set authentication enable	set authentication enable {tacacs | local} {enable | disable}	Sets TACACS+ enable authentication (for privileged mode access).	P
set authentication login	set authentication login {tacacs  | local} {enable | disable}	Sets TACACS+ login authentication (for login access).	P
set banner motd	set banner motd c [text] c	Sets the message-of-the-day banner.	P
set boot config-register	set boot config-register 0xvalue [mod_num] set boot config-register baud {1200 | 2400 | 4800 | 9600} [mod_num] set boot config-register ignore-config {enable | disable} [mod_num] set boot config-register boot {rommon | bootflash | system} [mod_num]	Sets the boot configuration register attributes.	P
set boot system flash	set boot system flash device:[filename][prepend] [mod_num]	Sets the boot system flash device.	P
set cam	set cam {dynamic | static | permanent} {unicast_mac | route_descr} mod/port [vlan] set cam {static | permanent} {multicast_mac} mod/ports.. [vlan] set cam agingtime vlan agingtime	Creates entries into the CAM table, sets the aging time for the CAM table, and sets the CoS value to a MAC address and VLAN pair.	P
set cdp	set cdp {enable | disable} {mod_num/port_num} set cdp interval interval set cdp holdtime holdtime	Enables, disables, and configures CDP on a port.	P
set channel cost	set channel cost channel_id | all [cost]	Sets the channel path cost and adjusts the port costs of the ports in the channel automatically.	P
set channel vlancost	set channel vlancost channel_id cost	Sets the channel VLAN cost and adjusts the port costs of the ports in the channel automatically.	P
set enablepass	set enablepass	Sets the enable (privileged) password.	P
set garp timer	set garp timer {timer_type} {timer_value}	Adjusts the values of the join, leave, and leaveall timers.	P
set igmp	set igmp {enable | disable}	Enables or disables IGMP snooping on the switch.	P
set interface	set interface {sc0 | sl0} {up | down} set interface sc0 [vlan] [ip_addr/netmask [broadcast]] set interface sl0 slip_addr dest_addr	Sets a network interface configuration.	P
set ip alias	set ip alias name ip_addr	Creates an alias for an IP address.	P
set ip dns	set ip dns {enable | disable}	Enables or disables DNS.	P
set ip dns domain	set ip dns domain name	Sets the default DNS domain name.	P
set ip dns server	set ip dns server ip_addr [primary]	Sets the IP address of a DNS server.	P
set ip fragmentation	set ip fragmentation {enable | disable}	Enables or disables the fragmentation of IP packets bridged between FDDI and Ethernet networks.	P
set ip permit	set ip permit {enable | disable} set ip permit ip_addr [mask]	Enables or disables the IP permit list and creates entries in the IP permit list.	P
set ip redirect	set ip redirect {enable | disable}	Enables or disables ICMP redirect messages.	P
set ip route	set ip route {destination}[/netmask] {gateway} [metric] [primary]	Adds entries to the IP routing table.	P
set ip unreachable	set ip unreachable {enable | disable}	Enables or disables ICMP unreachable messages.	P
set length	set length number [default]	Sets the number of lines in the terminal display screen.	N
set logging console	set logging console {enable | disable}	Enables and disables system message logging to the console.	P
set logging level	set logging level facility severity [default]	Sets the facility and severity level for system message logging.	P
set logging server	set logging server {enable | disable} set logging server ip_addr set logging server facility severity	Enables or disables system message logging to syslog servers and adds syslog servers to the system logging server table.	P
set logging session	set logging session {enable | disable}	Enables and disables system logging messages to the current login session.	P
set logout	set logout timeout	Sets the number of minutes before an automatic logout.	P
set module	set module enable | disable mod_num	Enables or disables a module.	P
set module name	set module name mod_num [mod_name]	Sets the name of a module.	P
set module power	set module power up | down mod_num	Turns on or shuts off the power to a module.	P
set multicast router	set multicast router mod_num/port_num	Configures multicast router ports.	P
set ntp broadcastclient	set ntp broadcastclient {enable | disable}	Enables or disables NTP in broadcast-client mode.	P
set ntp broadcastdelay	set ntp broadcastdelay microseconds	Configures a delay for the receiving of broadcast NTP packets.	P
set ntp client	set ntp client {enable | disable}	Enables or disables the switch as an NTP client.	P
set ntp server	set ntp server ip_addr	Configures the IP address of the NTP server.	P
set password	set password	Sets the console password.	P
set port broadcast	set port broadcast mod_num/port_num threshold%	Sets the broadcast/multicast suppression for one or more ports.	P
set port channel	set port channel mod/ports... [admin_group] set port channel mod_num/port_num mode {on | off | desirable | auto} [silent | non-silent]	Enables or disables EtherChannel on Ethernet module ports and assigns ports to admin groups.	P
set port disable	set port disable mod_num/port_num	Disables a port.	P
set port duplex	set port duplex mod_num/port_num {full | half | auto}	Sets the port duplex mode.	P
set port enable	set port enable mod_num/port_num	Enables a port or a range of ports.	P
set port flowcontrol	set port flowcontrol {receive | send} [mod_num/port_num] {off | on | desired}	Sets the receive flow-control value for a particular port.	P
set port name	set port name mod_num/port_num [name_string]	Sets the name of a port.	P
set port negotiation	set port negotiation mod_num/port_num {enable | disable}	Sets the link negotiation protocol for a port.	P
set port protocol	set port protocol mod_num/port_num {ip | ipx | group} {on | off | auto}	Enables or disables protocol membership of ports.	P
set port qos cos	set port qos mod/ports.. cos cos_value	Sets the value for a packet which has arrived through a port that has not been classified.	P
set port qos trust	set port qos mod/ports.. trust {untrusted | trust-cos}	Sets the state of a port.	P
set port security	set port security mod_num/port_num {enable | disable} [mac_addr]	Enables or disables port security on a port of an EtherChannel module.	P
set port speed	set port speed mod_num/port_num {10 | 100 | auto}	Sets the port speed.	P
set port trap	set port trap mod_num/port_num {enable | disable}	Enables or disables the standard SNMP link trap (up or down) for a port.	P
set power redundancy	set power redundancy enable | disable	Turns redundancy between the power supplies on or off.	P
set prompt	set prompt prompt_string	Sets the CLI prompt.	P
set protocolfilter	set protocolfilter {enable | disable}	Activates or deactivates protocol filtering.	P
set qos	set qos enable | disable	Turns the switch QoS functionality on or off.	P
set qos drop-threshold	set qos drop-threshold 2q2t tx queue q# thr1 thr2 set qos drop-threshold 1q4t rx queue q# thr1 thr2 thr3 thr4	Programs the transmit and receive drop thresholds on all ports in the system.	P
set qos mac-cos	set qos mac-cos dest_mac vlan cos	Sets the CoS value for a MAC/VLAN pair.	P
set qos map	set qos map port_type q# thr# cos coslist	Maps a specific CoS value to one of the two transmit priority queues and one of the two thresholds per available priority queue for all ports.	P
set qos txq-ratio	set qos txq-ratio port_type queue1_val queue2_val	Sets the amount of packet buffer memory allocated to high-priority traffic and low-priority traffic.	P
set qos wrr	set qos wrr port_type queue1_val queue2_val	Specifies the weights used to determine how many packets will be transmitted out of one queue before switching to the other.	P
set snmp community	set snmp community {read-only | read-write | read-write-all} [community_string]	Sets SNMP communities and associated access types.	P
set snmp rmon	set snmp rmon {enable | disable}	Enables or disables SNMP RMON support.	P
set snmp trap	set snmp trap {enable | disable} [all | module | chassis | bridge | repeater | auth | vtp | ippermit | config | entity | stpx] set snmp trap rcvr_addr rcvr_community	Enables or disables SNMP traps and sets the SNMP trap receiver address and community.	P
set span	set span enable | disable [dest_mod/dest_port | all] set span {src_mod/src_ports | src_vlans | sc0} {dest_mod/dest_port} [rx  | tx | both] [inpkts {enable | disable}] [multicast {enable | disable}] [create]	Enables or disables SPAN and sets the source and destination SPAN ports.	P
set spantree backbonefast	backbonefast {enable | disable}	Enables or disables the Spanning-Tree Backbone Fast Convergence feature.	P
set spantree disable	set spantree disable	Disables spanning tree.	P
set spantree enable	set spantree enable	Enables spanning tree.	P
set spantree fwddelay	set spantree fwddelay delay [vlan]	Sets the bridge forward delay for a VLAN.	P
set spantree hello	set spantree hello interval [vlan]	Sets the bridge hello interval for a VLAN.	P
set spantree maxage	set spantree maxage agingtime [vlan]	Sets the bridge maximum aging time for a VLAN.	P
set spantree portcost	set spantree portcost mod_num/port_num cost	Sets the bridge path cost for a port.	P
set spantree portfast	set spantree portfast mod_num/port_num {enable | disable}	Enables or disables fast-start mode on a port.	P
set spantree portpri	set spantree portpri mod_num/port_num [priority]	Sets the bridge priority for a spanning-tree port.	P
set spantree portvlancost	set spantree portvlancost mod_num/port_num [cost cost] [vlan_list]	Assigns a lower path cost to a set of VLANs on a port.	P
set spantree portvlanpri	set spantree portvlanpri mod_num/port_num priority [vlans]	Sets the port priority for a subset of VLANs in the trunk port.	P
set spantree priority	set spantree priority bridge_priority [vlan]	Sets the bridge priority for a VLAN.	P
set spantree root	set spantree root [secondary] [vlan_list] [dia network_diameter] [hello hello_time]	Sets the primary or secondary root for specific VLANs or for all VLANs of the switch.	P
set spantree uplinkfast	set spantree uplinkfast {enable | disable} [rate station_update_rate] [all-protocols off | on]	Enables a fast switchover to alternate ports when the root port fails.	P
set summertime	set summertime {enable | disable} [zone]	Sets the clock adjustment for daylight saving time.	P
set system baud	set system baud rate	Sets the console port baud rate.	P
set system contact	set system contact [contact_string]	Sets the system contact information.	P
set system location	set system location [location_string]	Sets the system location information.	P
set system modem	set system modem {enable | disable}	Enables or disables modem control lines on the console port.	P
set system name	set system name [name_string]	Sets the system name.	P
set tacacs attempts	set tacacs attempts count	Sets the maximum number of TACACS+ login attempts allowed.	P
set tacacs directedrequest	set tacacs directedrequest {enable | disable}	Sets the TACACS+ directed-request option.	P
set tacacs key	set tacacs key key	Sets the TACACS+ authentication and encryption key.	P
set tacacs server	set tacacs server ip_addr [primary]	Sets the IP address of TACACS+ servers.	P
set tacacs timeout	set tacacs timeout seconds	Sets the response timeout interval for the TACACS+ server daemon.	P
set time	set time [day_of_week] [mm/dd/yy] [hh:mm:ss]	Sets the system time.	P
set timezone	set timezone [zone_name] [hours [minutes]]	Sets the time zone.	P
set trunk	set trunk mod_num/port_num {on | off | des | auto | noneg} [isl | dot1q | negotiate] [vlan_range]	Configures trunk ports.	P
set udld	set udld enable | disable mod/ports...	Enables or disables UDLD on a port.	P
set vlan	set vlan vlan_num mod/ports... set vlan vlan_num [name name] [type ethernet] [state {active | suspend}] [said said] [mtu mtu] [bridge bridge_num] [mode bridge_mode] [stp  stp_type] [translation vlan_num]	Creates and configures options for VLANs.	P
set vlan mapping	set vlan mapping dot1q 1q_vlan_num isl isl_vlan_num	Maps 802.1Q VLANs to ISL VLANs.	P
set vtp	set vtp [domain domain_name] [mode {client | server | transparent}] [passwd passwd] [pruning  {enable | disable}] [v2 {enable | disable}]	Sets VTP options.	P
set vtp pruneeligible	set vtp pruneeligible vlan_range	Configures pruning eligibility for the device.	P
show alias	show alias [name]	Displays aliases for commands.	N
show arp	show arp [ip_addr | hostname][noalias]	Displays the ARP table.	N
show authentication	show authentication	Displays authentication information.	N
show boot	show boot [mod_num]	Displays the contents of the BOOT environment variables and the configuration register setting.	N
show cam	show cam [count]{dynamic | static | permanent | system} [vlan] show cam {dynamic | static | permanent} mod_num  | port_num show cam mac_addr [vlan]	Displays the CAM table.	N
show cam agingtime	show cam agingtime	Displays CAM aging time information for all configured VLANs.	N
show cdp	show cdp show cdp neighbors [mod_num] [vlan | duplex | capabilities | detail] show cdp neighbors [mod_num/port_num] [vlan | duplex | capabilities | detail] show cdp port [mod_num] show cdp port [mod_num/port_num]	Displays CDP information.	N
show channel	show channel [channel_id] [info | statistics | mac]	Displays EtherChannel information for a channel.	N
show channel group	show channel group [admin_group] [info | statistics]	Displays EtherChannel group status information.	N
show config	show config	Displays the current system configuration.	P
show counters	show counters mod_num/port_num	Displays hardware counters for a port.	N
show environment	show environment [temperature | all | power]	Displays system status information.	P
show flash	show flash [[m/]device:] [all | chips | filesys]	Lists Flash code information.	N
show ifindex	show ifindex number	Displays ifIndex information.	N
show igmp statistics	show igmp statistics [vlan_id]	Displays IGMP statistics for a particular VLAN.	N
show imagemib	show imagemib filename	Displays image information provided in the CISCO-IMAGE-MIB for a particular image.	N
show interface	show interface	Displays information about network interfaces.	N
show ip alias	show ip alias [name]	Displays aliases for IP addresses.	N
show ip dns	show ip dns	Displays the DNS name server and the default domain name.	N
show ip permit	show ip permit [noalias]	Displays IP permit list information.	N
show ip route	show ip route [noalias]	Displays the IP routing table.	N
show log	show log [mod_num]	Displays system and module error logs.	N
show logging	show logging	Displays the system message log configuration.	N
show logging buffer	show logging buffer [-] [number_of_messages]	Displays system messages from the internal buffer.	N
show mac	show mac [mod_num[/port_num]]	Displays MAC counters.	N
show microcode	show microcode	Displays the switch microcode version.	N
show module	show module [mod_num]	Displays module information.	N
show multicast group	show multicast group [mac_addr] [vlan_id]	Displays the multicast group configuration.	N
show multicast group count	show multicast group count [vlan_id]	Displays the total count of multicast addresses (groups) in a VLAN.	N
show multicast router	show multicast router [mod_num/port_num] [vlan_id]	Displays the multicast router configuration.	N
show netstat	show netstat [tcp | udp | ip | icmp | routes | stats | interfaces]	Displays currently active network connections and network statistics for the TCP/IP stack.	N
show ntp	show ntp	Displays the current NTP status.	N
show port	show port [mod_num[/port_num]]	Displays port status and counters.	N
show port broadcast	show port broadcast [mod_num[/port_num]]	Displays broadcast information.	P
show port capabilities	show port capabilities [mod_num[/port_num]]	Displays the capabilities of the modules and ports in a switch.	N
show port cdp	show port cdp [mod_num[/port_num]]	Displays port CDP information.	N
show port channel	show port channel [mod[/port]] [info | statistics]	Displays EtherChannel information.	N
show port counters	show port counters [mod_num/port_num]	Displays the counters for a port.	N
show port flowcontrol	show port flowcontrol [mod_num[/port_num]]	Displays per port flow-control status and statistics.	N
show port negotiation	show port negotiation [mod_num[/port_num]]	Displays the link-negotiation protocol setting for a specified port.	N
show port protocol	show port protocol [mod_num[/port_num]]	Displays protocol filters.	N
show port qos	show port qos mod_num/port_num	Displays QoS-related information for a specifc port.	N
show port status	show port status [mod_num[/port_num]]	Displays port status information.	N
show protocolfilter	show protocolfilter	Displays enabled or disabled status of protocol filters.	N
show qos info	show qos info {runtime | config} {mod_num/port_num} show qos info config port_type tx | rx	Displays the currently configured QoS-related information for a specified port.	N
show qos mac-cos	show qos mac-cos dest_mac [vlan] show qos mac-cos all	Displays the currently configured QoS-related information MAC/VLAN pair.	N
show qos statistics	show qos statistics {mod_num[/port_num]}	Displays the various QoS-related counters for a specified port.	N
show rif	show rif [vlan_num]	Displays RIF information.	N
show snmp	show snmp [noalias]	Displays SNMP information.	N
show snmp counters	show snmp counters	Displays SNMP counter informationon.	N
show span	show span	Displays SPAN port monitoring information.	N
show spantree	show spantree [vlan | mod_num/port_num] [active]	Displays spanning-tree information.	N
show spantree backbonefast	show spantree backbonefast	Displays whether the spanning-tree Backbone Fast Convergence feature is enabled.	N
show spantree blockedports	show spantree blockedports [vlan_num]	Displays only the blocked ports.	N
show spantree portvlancost	show spantree portvlancost mod_num/port_num	Displays the path cost for the VLANs on a port.	N
show spantree statistics	show spantree statistics mod_num/port_num [vlan]	Displays spanning-tree statistical information.	N
show spantree summary	show spantree summary	Displays a summary of spanning-tree information.	N
show spantree uplinkfast	show spantree uplinkfast	Displays UplinkFast feature settings.	N
show summertime	show summertime	Displays the current status of the summertime feature.	N
show system	show system	Displays system information.	N
show tacacs	show tacacs [noalias]	Displays the TACACS+ configuration.	N
show test	show test [mod_num]	Displays the results of diagnostic tests.	N
show time	show time	Displays the current system time.	N
show timezone	show timezone	Displays the current time zone and offset.	N
show top	show top [N] [metric] [interval interval] [port_type] [background]	Starts the TopN process.	N
show top report	show top report [report_num]	Lists all TopN processes and specific TopN reports.	N
show trunk	show trunk [mod_num[/port_num]][detail]	Displays trunking information for the switch.	N
show udld	show udld show udld port [mod_num[/port_num]]	Displays UDLD information.	N
show users	show users [noalias]	Displays whether the console port is active and lists all active Telnet sessions.	N
show version	show version	Displays software and hardware version information.	N
show vlan	show vlan [vlan] [trunk | notrunk] show vlan mapping	Displays VLAN and VLAN mapping table information.	N
show vtp domain	show vtp domain	Displays VTP domain information.	N
show vtp statistics	show vtp statistics	Displays VTP statistics.	N
slip	slip {attach | detach}	Attaches or detaches SLIP for the console port.	P
squeeze	squeeze [m/]device:	Permanently deletes Flash files.	P
switch	switch {clock | supervisor}	Switches between clocks or from the active to the standby supervisor.	P
telnet	telnet host [port_num]	Starts a Telnet connection to a remote host.	P
test snmp trap	test snmp trap trap_num [specific_num]	Sends an SNMP trap message to the trap receivers.	P
traceroute	traceroute [-n] [-w wait_time] [-i initial_ttl] [-m  max_ttl] [-p dest_port] [-q nqueries] [-t tos] host [data_size]	Displays a hop-by-hop path through an IP network from the Catalyst  6000 or 6500 series switch to a specific destination host.	P
undelete	undelete index [[m/]device:]	Undeletes a file.	P
upload	upload host file [mod_num]	Uploads a software image to a network host.	P
verify	verify[[m/]device:] filename	Verifies the checksum of a file on a Flash device.	N
wait	wait seconds	Causes the CLI to pause for a specified number of seconds.	N
whichboot	whichboot	Displays the name of the active boot device.	N
write	write {host file | network | terminal}	Uploads the current configuration to a host or displays it on the terminal.	P

ROM Monitor CLI

The ROM monitor is a ROM-based program that executes upon platform power-up, reset, or when a fatal exception occurs.

Accessing the ROM Monitor CLI

The system enters ROM-monitor mode if the switch does not find a valid system image, if the NVRAM configuration is corrupted, or if the configuration register is set to enter ROM-monitor mode. From the ROM-monitor mode, you can load a system image manually from Flash memory, from a network server file, or from bootflash. You can also enter ROM-monitor mode by restarting the switch and pressing the Break key during the first 60 seconds of startup.

To connect through a terminal server, escape to the Telnet prompt, and enter the send break command to break back to the ROM-monitor mode.

Operating the ROM Monitor CLI

The ROM monitor commands are used to load and copy system images, microcode images, and configuration files. System images contain the system software. Microcode images contain microcode to be downloaded to various hardware devices. Configuration files contain commands to customize IOS software.

The manual boot command has the following syntax:

• boot-boot from ROM

• boot [-xv] [device:][imagename]-boot from local device. If you do not specify an image name, the system defaults to the first valid file in the device. The image name is case-sensitive.

Once you are in ROM-monitor mode, the prompt changes to rommon #>.

ROM Monitor Commands Quick Reference

Table 1-5 identifies each command in the switch command set, shows the command syntax, provides a short description, and specifies the mode for the command.

Table 1-5: ROM Monitor Commands

Command	Syntax	Description
alias	alias [name=value]	Sets and displays aliases.
boot	boot [-xv] [device:][imagename]	Boots up an external process.
confreg	confreg [num]	Configures the configuration register utility.
context	context	Displays the context of a loaded image.
dev	dev	Lists the device IDs available on a platform.
dirROM monitor	dir device	Lists the files of the named device.
frame	frame [-d | -p] [num]	Displays a selected stack frame.
historyROM Monitor	history	Displays the command history (the last 16  commands executed in the monitor environment).
meminfo	meminfo [-l]	Displays switch memory information.
repeat	repeat [num | string]	Repeats a specified command.
resetROM monitor	reset [-s]	Performs a soft reset of the switch.
set	set	Displays all of the monitor variable names with their values.
stack	stack [-d | -m] [num]	Dumps a stack trace of frames.
sync	sync	Saves changes to the ROM monitor configuration.
sysret	sysret	Displays information from the last system return.
unalias	unalias name	Removes the alias name and associated value from the alias list.
unset=	unset=varname	Removes a variable name from the variable list.
varname=	varname=value	Sets the variable VARNAME to varvalue.

Posted: Thu Feb 4 18:28:57 PST 1999
Copyright 1989-1999©Cisco Systems Inc.