cc/td/doc/product/lan/cat6000/sw_5_2
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Command-Line Interfaces

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:

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. Using the CLI session command, you can access the router configuration software and perform tasks such as history substitution and alias creation.

Note The Catalyst 6000 and 6500 series switches include the Catalyst 6009 (16-Gbps backplane) switch and the Catalyst 6509 (56-Gbps backplane) switch. Throughout this publication and all Catalyst 6000 and 6500 series documents, the phrase Catalyst 6000 and 6500 series switches refers to both these switches, unless otherwise noted.

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.

Note EIA/TIA-232 was known as RS-232 before its acceptance as a standard by the Electronic Industries Association and Telecommunications Industry Association.

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.)


Table 1-1: Command-Line Processing Keystrokes
Keystroke Function

Ctrl-A

Jumps to the first character of the command line.

Ctrl-B or the left arrow key

Moves the cursor back one character.

Ctrl-C

Escapes and terminates prompts and tasks.

Ctrl-D

Deletes the character at the cursor.

Ctrl-E

Jumps to the end of the current command line.

Ctrl-F or the right arrow key1

Moves the cursor forward one character.

Ctrl-K

Deletes from the cursor to the end of the command line.

Ctrl-L; Ctrl-R

Repeats current command line on a new line.

Ctrl-N or the down arrow key1

Enters next command line in the history buffer.

Ctrl-P or the up arrow key1

Enters previous command line in the history buffer.

Ctrl-U; Ctrl-X

Deletes from the cursor to the beginning of the command line.

Ctrl-W

Deletes last word typed.

Esc B

Moves the cursor back one word.

Esc D

Deletes from the cursor to the end of the word.

Esc F

Moves the cursor forward one word.

Delete key or Backspace key

Erases mistake when entering a command; reenter command after using this key.

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

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.

Note The ---More--- prompt is used for any output that has more lines than can be displayed on the terminal screen, including show command output.
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.


Table 1-2: Switch CLI Command Aliases
Alias Command

?

help

batch

configure

di

show

earl

cam

exit

quit

logout

quit

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 the 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.

Top-Level Commands and Command Categories

In normal mode, use the help or ? command to display a list of top-level commands and command categories, as follows:

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>

In privileged mode, enter the help or ? command to display a list of top-level commands and command categories, as follows:

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)
Command Categories

On some commands (such as clear, set, and show), typing help or ? after the command provides a list of commands in that category. For example, the following display shows a partial list of commands for the clear category:

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 
...
Context-Sensitive Help

Usage and syntax information for individual commands can be seen by appending help or ? to any specific command. For example, the following display shows usage and syntax information for the set length command:

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:


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 gmrp statistics

clear gmrp statistics {vlan | all}

Clears GMRP statistical information.

P

clear gvrp statistics

clear gvrp statistics {mod/port | all}

Clears GVRP statistical information.

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.

N2

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.

N2

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.

P2

session

session mod_num

Connects the CLI to a session on a module (such as the MSM modules).

P2

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/ports...}
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 for all GARP applications.

P

set gmrp

set gmrp {enable | disable}

Enables or disables the GMRP feature on this switch, in all VLANs, and on all ports.

P

set gmrp fwdall

set gmrp fwdall {enable | disable} mod/ports..

Enables or disables the Forward All feature on a specifed port.

P

set gmrp registration

set gmrp registration {normal | fixed | forbidden} mod/ports..

Specifies the GMRP registration type.

P

set gmrp timer

set gmrp timer {timer_type} {timer_value}

Adjusts the values of the join, leave, and leaveall timers for all GARP applications..

P

set gvrp

set gvrp {enable | disable}[mod/port]

Enables or disables the GVRP feature on this switch, in all VLANs, and on all ports.

P

set gvrp applicant

set gvrp applicant {normal | active} mod/port..

Specifies whether or not a VLAN is declared out of blocking ports.

P

set gvrp dynamic-vlan-creation

set gvrp dynamic-vlan-creation {enable | disable}

Enables or disables dynamic VLAN creation.

P

set gvrp registration

set gvrp registration {normal | fixed | forbidden} mod/ports..

Sets the administrative control of an outbound port.

P

set gvrp timer

set gvrp timer {timer_type} {timer_value}

Adjusts the values of the join, leave, and leaveall timers for all GARP applications.

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]
set port channel all distribution {ip | mac} [source | destination | both]

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 {mod_num/port_num} {receive | send} {off | on | desired}
set port flowcontrol {receive | send} {mod_num/port_num}

Sets the receive flow-control value for a particular port.

P

set port gmrp

set port gmrp {mod/ports...} {enable | disable}

Enables or disables GMRP on specified ports, in all VLANs.

P

set port gvrp

set port gvrp {mod/ports...} {enable | disable}

Enables or disables GVRP on specified ports, in all VLANs.

P

set port name

set port name mod_num/port_num [port_name]

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 that has arrived through an untrusted port.

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 rsmautostate

set rsmautostate {enable | disable}

Sets the line protocol state determination of the MSM(s) due to Catalyst 6000 or 6500 series switch port state changes.

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 | vmps | 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

set spantree backbonefast {enable | disable}

Enables or disables the Spanning-Tree Backbone Fast Convergence feature.

P

set spantree disable

set spantree disable [vlan | all]

Disables spanning tree.

P

set spantree enable

set spantree enable [vlan | all]

Enables spanning tree.

P

set spantree fwddelay

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] [aremaxhop hop_count]

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/port

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 gmrp configuration

show gmrp configuration

Displays complete GMRP-related configuration information.

N

show gmrp statistics

show gmrp statistics [vlan]

Displays all the GMRP-related statistics for a specified VLAN.

N

show gmrp timer

show gmrp timer

Displays all the values for the GMRP timers.

N

show gvrp configuration

show gvrp configuration

Displays all the GVRP configuration information.

N

show gvrp statistics

show gvrp statistics [mod/port]

Displays all the GVRP-related statistics.

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 moduleinit

show moduleinit [mod_num] [log lognum | -logcount]

Displays contents of the information stored in the system module bringup log.

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]] [statistics | info]
show port channel [mod[/port]] [info [spantree | trunk | protcol | gmrp | gvrp | qos]]

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 specific port.

N

show port status

show port status [mod_num[/port_num]]

Displays port status information.

N

show proc

show proc [cpu | mem]

Displays CPU and process information.

P

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 rsmautostate

show rsmautostate mod_num

Displays the line protocol state determination of the MSM(s).

N

show snmp

show snmp [noalias]

Displays SNMP information.

N

show snmp counters

show snmp counters

Displays SNMP counter information.

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.

Note Break is always enabled for 60 seconds after rebooting the system, regardless of whether Break is configured to be off by configuration register settings.

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:

Note Enter the copy file-id {tftp | flash | file-id} command to obtain an image from the network.

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 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.


hometocprevnextglossaryfeedbacksearchhelp
Posted: Mon May 17 11:36:45 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.