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

Table of Contents

Command-Line Interfaces

Command-Line Interfaces

This chapter describes the command-line interfaces (CLI) available on the Catalyst 6000 family 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 family 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 family 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 family consists of the Catalyst 6000 and 6500 series switches. The Catalyst 6000 series consists of the Catalyst 6006 and 6009 switches; the Catalyst 6500 series consists of the Catalyst 6506 and 6509 switches. Throughout this publication and all Catalyst 6000 family documents, the phrase Catalyst 6000 family switches refers to all four 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 family 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 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, this 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 family 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 displayed as mod/ports..., mod/port..., or mod_num/port_num. 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 the following example, VLANs 1 through 10 and VLAN 1000 are specified:

1-10,1000

Designating MAC Addresses, IP and IPX 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.

When entering the IPX address syntax, use the following format:

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 cops

clear cops roles role1 [role2]...
clear cops all-roles
clear cops server all
clear cops server ipaddress [primary] [diff-serv |     rsvp]
clear cops server ipaddress [diff-serv | rsvp]
clear cops domain-name

Clears COPS configurations.

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 lda

clear lda mls
clear lda mls [destination ip_addr_spec]
    [source ip_addr_spec] [protocol protocol
    src-port src_port dst-port dst_port]
clear lda vip {all | vip | vip tcp_port}
clear lda mac {all | router_mac_address}

Removes the ASLB entries from the switch.

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 mls

clear mls statistics
clear mls statistics protocol {protocol} {port} | all
clear mls entry [ip| ipx] all
clear mls entry [ip] [destination ip_addr_spec]     [source ip_addr_spec] [flow protocol src_port
dst_port]
clear mls entry [ipx] [destination ipx_addr_spec]
[source ipx_net_addr]

Clears MLS features in the Catalyst 6000 family switches.

P

clear mls exclude protocol

clear mls exclude protocol tcp | udp | both
 port_number

Removes a protocol port from the list of ports that been been excluded from shortcutting.

P

clear mls multicast statistics

clear mls multicast statistics [mod]

Clears multicast MSFC ports.

P

clear mls nde flow

clear mls nde flow

Resets the NDE filters.

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 cops

clear port cops mod/port roles role1 [role2]...
clear port cops mod/port all-roles

Clears port roles.

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 acl

clear qos acl map acl_name {mod_num/port_num |       vlan | all}
clear qos acl acl_name [editbuffer_index]
clear qos acl default-action {ip | ipx | mac | all}

Removes various ACL configurations.

P

clear qos config

clear qos config

Returns the values set by various QoS commands to the factory-set default values.

P

clear qos cos-dscp-map

clear qos cos-dscp-map

Clears the CoS-to-DSCP mapping.

P

clear qos dscp-cos-map

clear qos dscp-cos-map

Clears the DSCP-to-CoS mapping.

P

clear qos ipprec-dscp-map

clear qos ipprec-dscp-map

Clears the IP precedence-to-DSCP mapping.

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 tx | rx

Returns the values set by the set qos map command to the factory-set default values for the specified ports.

P

clear qos policed-dscp-map

clear qos policed-dscp-map

Resets the mapping to the defaults.

P

clear qos policer

clear qos policer microflow microflow_name | all
clear qos policer aggregate aggregate_name | all

Clears policing rules from NVRAM.

P

clear radius

clear radius server all
clear radius server ipaddr
clear radius key

Clears one or all of the RADIUS servers from the RADIUS server table.

P

clear security acl

clear security acl all
clear security acl acl_name
clear security acl acl_name editbuffer_index

Removes a specific ACE or all ACEs from an ACL, and deletes the ACLs from the edit buffer.

P

clear security acl map

clear security acl map all
clear security acl map acl_name
clear security acl map vlan
clear security acl map acl_name vlan

Removes VACL-to-VLAN mapping.

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

clear vmps statistics

Deletes VMPS statistics.

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

commit

commit qos acl acl_name | all
commit security acl acl_name | all

Commits ACEs in NVRAM that have not been written to hardware.

P

commit lda

commit lda

Commits ASLB configuration to NVRAM that has not been written to hardware

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

download vmps

download vmps

Downloads VMPS database information.

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

reconfirm vmps

reconfirm vmps

Reconfirms the current dynamic port VLAN membership with VMPS.

P

resetswitch

reset {mod_num | system}

Sets the system to its default values or configures the system as an individual module.

P

rollback

rollback qos acl acl_name
rollback security acl acl_name

Clears all changes to the edit buffer and restores the committed setting.

P

session

session mod_num

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

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 enable | disable     [console | telnet | both] [primary]
set authentication enable radius enable | disable     [console| telnet | both] [primary]
set authentication enable local enable | disable     [console | telnet | both]

Sets authentication method.

P

set authentication login

set authentication login tacacs enable | disable     [console | telnet | both] [primary]
set authentication login radius enable | disable     [console | telnet | both] [primary]
set authentication login local enable | disable     [console | telnet | both]

Enables TACACS+ or RADIUS as the primary authentication method for login.

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 cops

set cops server ipaddress [port] [primary]
    [diff-serv | rsvp]
set cops domain-name domain_name
set cops retry-interval initial incr max

Sets COPS functionality.

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 lda

set lda enable | disable
set lda vip {server_virtual_ip} {destination_tcp_port} {server_virtual_ip}
{destination_tcp_port}..]
set lda mac ld {ld_mac-address}
set lda mac router {mac-address}...
set lda router {router_vlan} {ld_mod/port}
[backup_ld_mod/port]
set lda server {server_vlan} {ld_mod/port}
[backup_ld_mod/port]

Configures the ASLB feature.

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 history

set logging history syslog_history_table_size

Sets the size of the syslog history table.

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
set logging server severity 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 mls agingtime

set mls agingtime [ip | ipx] [agingtime}
    agingtime fast {fastagingtime} {pkt_threshold)

Configures the MLS aging time of shortcuts to an MLS entry.

P

set mls exclude protocol

set mls exclude protocol {tcp | udp | both}     {port_number}

Adds a protocol port to be excluded from being shortcut.

P

set mls multicast

set mls multicast enable
set mls multicast disable

Enables and disables the IP multicast MLS feature.

P

set mls nde

set mls nde {enable | disable}
set mls nde {collector_ip | collector_name}     {udp_port_num}
set mls nde version {1 | 7 | 8}
set mls nde flow [exclude | include] [destination     ip_addr_spec] [source ip_addr_spec]
[protocol protocol] [src-port port_number]     [dst-port port_number]

Configures the NDE feature to allow command exporting statistics to be sent to the preconfigured collector.

P

set mls statistics protocol

set mls statistics protocol protocol port

Sets protocols for statistics collection.

N

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 msmautostate

set msmautostate {enable | disable}

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

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 cops

set port cops mod/port roles role1 [role2]...

Creates port roles.

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 jumbo

set port jumbo {mod/port} {enable | disable}

Enables or disables the jumbo frame feature on specified ports.

P

set port name

set port name mod_num/port_num [port_name]

Configures a name for 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

set port qos mod/port... port-based | vlan-based

Specifies whether an interface is interpreted as a physical port or as a VLAN.

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 rsvp dsbm-election

set port rsvp mod/port dsbm-election enable |
disable [dsbm_priority]

Specifies whether the switch will participate in the DSBM election on that particular segment.

P

set port qos trust

set port qos mod/ports.. trust {untrusted | trust-cos |     trust-ipprec | trust-dscp}

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 acl default-action

set qos acl default-action ip {dscp {dscp} | trust-cos     | trust-ipprec | trust-dscp}     [microflow microflow_name]
    [aggregate aggregate_name]
set qos acl default-action ipx {dscp {dscp} |
trust-cos} [microflow microflow_name]
    [aggregate aggregate_name]
set qos acl default-action ipx | mac {dscp {dscp} |
trust-cos} [aggregate aggregate_name]

Sets the ACL default actions.

P

set qos acl ip

set qos acl ip {acl_name} {dscp dscp | trust-cos |
trust-ipprec | trust-dscp}
    [microflow microflow_name]
    [aggregate aggregate_name] {src_ip_spec}
    [before editbuffer_index | modify editbuffer_index]
set qos acl ip {acl_name} {dscp dscp | trust-cos |     trust-ipprec | trust-dscp}
    [microflow microflow_name]
    [aggregate aggregate_name] {protocol}     {src_ip_spec} {dest_ip_spec}
    [precedence precedence | dscp-field dscp]
    [before editbuffer_index |
    modify editbuffer_index]
set qos acl ip {acl_name} {dscp dscp | trust-cos |     trust-ipprec | trust-dscp}
    [microflow microflow_name]
    [aggregate aggregate_name] icmp {src_ip_spec}
    {dest_ip_spec} [icmp_type [icmp_code] |     icmp_message] [precedence precedence |
    dscp-field dscp] [before editbuffer_index |
    modify editbuffer_index]
set qos acl ip {acl_name} {dscp dscp | trust-cos |     trust-ipprec | trust-dscp}
    [microflow microflow_name]
    [aggregate aggregate_name] igmp {src_ip_spec}
    {dest_ip_spec} [igmp_type]
    [precedence precedence | dscp-field dscp]
    [before editbuffer_index | modify editbuffer_index]
set qos acl ip {acl_name} {dscp dscp | trust-cos |     trust-ipprec | trust-dscp}
    [microflow microflow_name]
    [aggregate aggregate_name] tcp {src_ip_spec}     [{operator} {port} [port]] {dest_ip_spec}     [{operator} {port} [port]] [established]
    [precedence precedence | dscp-field dscp]
    [before editbuffer_index |
    modify editbuffer_index]
set qos acl ip {acl_name} {dscp dscp | trust-cos |     trust-ipprec | trust-dscp}
    [microflow microflow_name]
    [aggregate aggregate_name] udp src_ip_spec}     [{operator} {port} [port]] {dest_ip_spec}     [{operator {port} [port]] [precedence precedence |
    dscp-field dscp] [before editbuffer_index |
    modify editbuffer_index]

Defines the QoS IP access lists.

P

set qos acl ipx

set qos acl ipx {acl_name} {dscp dscp | trust-cos}     [microflow microflow_name]     [aggregate aggregate_name] {protocol} {src_net}     [dest_net.[dest_node]
    [[dest_net_mask.]dest_node_mask]]
    [before editbuffer_index | modify editbuffer_index]

Defines the QoS IPX access lists.

P

set qos acl mac

set qos acl mac {acl_name} {dscp dscp | trust-cos}     [aggregate aggregate_name]     {src_mac_addr_spec} {dest_mac_addr_spec     [ether-type] [before editbuffer_index |     modify editbuffer_index]

Defines the QoS MAC access lists.

P

set qos acl map

set qos acl map acl_name mod_num/port_num | vlan

Attaches an ACL to an interface.

P

set qos bridged-microflow-policing

set qos bridged-microflow-policing {enable |     disable} vlanlist

Enables or disables microflow policing of bridged packets.

P

set qos cos-dscp-map

set qos cos-dscp-map dscp1 dscp2... dscp8

Sets the CoS-to-DSCP mapping.

P

set qos drop-threshold

set qos drop-threshold 2q2t tx queue q# thr1 thr2
set qos drop-threshold {1q4t | 1p1q4t} rx queue q#     thr1 thr2 thr3 thr4

Programs the transmit and receive drop thresholds on all ports in the system.

P

set qos dscp-cos-map

set qos dscp-cos-map dscp_list:cos_value ...

Sets the DSCP-to-CoS mapping.

P

set qos ipprec-dscp-map

set qos ipprec-dscp-map dscp1 ... dscp8

Sets the IP precedence-to-DSCP map.

P

set qos mac-cos

set qos mac-cos dest_mac vlan cos

Sets the CoS value for a MAC and VLAN pair.

P

set qos map

set qos map port_type tx | rx 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 policed-dscp-map

set qos policed-dscp-map     in_profile_dscp:policed_dscp...

Sets the mapping of policed in-profile DSCPs.

P

set qos policer

set qos policer microflow microflow_name rate rate     burst burst drop | policed-dscp
set qos policer aggregate aggregate_name rate rate     burst burst drop | policed-dscp

Creates a microflow policing rule.

P

set qos policy-source

set qos policy-source local | cops

Sets the QoS policy source.

P

set qos rsvp

set qos rsvp enable | disable
set qos rsvp policy-timeout timeout
set qos rsvp local-policy forward | reject

Turns the RSVP+ feature on the switch, sets the time in minutes after which the RSVP+ databases get flushed (when the policy server dies) and sets the local policy.

P

set qos txq-ratio

set qos txq-ratio port_type queue1_val queue2_val...     queueN_val

Sets the amount of packet buffer memory allocated to high-priority traffic and low-priority traffic.

P

set qos wred-threshold

set qos wred-threshold 1p2q2t tx queue q# thr1 thr2

Configures the WRED threshold parameters for the specified port type.

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 radius deadtime

set radius deadtime minutes

Sets time to skip RADIUS servers that do not reply.

P

set radius key

set radius key key

Sets the RADIUS encryption key.

P

set radius retransmit

set radius retransmit count

Sets iterations of RADIUS server lists.

P

set radius server

set radius server ipaddr [auth-port port] [primary]

Sets the RADIUS server address.

P

set radius timeout

set radius deadtime seconds

Sets the time to wait for a RADIUS server reply.

P

set rspan

set rspan disable source [rspan_vlan | all]
set rpsan disable destination [mod_num/port_num |     all]
set rspan source {mod/ports... | vlans... | sc0}     {rspan_vlan} [rx | tx | both] [multicast {enable      | disable}] [filter vlans...] [create]
set rspan destination {mod_num/port_num}     {rspan_vlan} [inpkts {enable | disable}]     [learning {enable | disable}] [create]

Enables or disables remote SPAN and sets the source and destination remote SPAN ports.

P

set security acl ip

set security acl ip {acl_name} {permit | deny}     {src_ip_spec} [before editbuffer_index |
    modify editbuffer_index]
    [microflow microflow_name]
    [aggregate aggregate_name] {src_ip_spec}
    [before editbuffer_index | modify editbuffer_index]
set security acl ip {acl_name} {permit | deny |     redirect mod_num/port_num} {protocol}     {src_ip_spec} {dest_ip_spec}
    [precedence precedence] [tos tos]
    [before editbuffer_index | modify editbuffer_index]
set security acl ip {acl_name} {permit | deny |     redirect {mod_num/port_num}} [IP | 0]     {src_ip_spec} {dest_ip_spec}
    [precedence precedence] [tos tos]
    [before editbuffer_index | modify editbuffer_index
set security acl ip {acl_name} {permit | deny |     redirect {mod_num/port_num}} [ICMP | 1]     {src_ip_spec} {dest_ip_spec} [icmp_type]     [icmp_code] | [icmp_message]
    [precedence precedence] [tos tos]
    [before editbuffer_index | modify editbuffer_index]
set security acl ip {acl_name} {permit | deny |     redirect {mod_num/port_num}} [IGMP | 2]     {src_ip_spec} {dest_ip_spec} [igmp_type]     [precedence precedence] [tos tos]
    [before editbuffer_index | modify editbuffer_index]
set security acl ip {acl_name} {permit | deny |     redirect {mod_num/port_num}} [TCP | 6]     {src_ip_spec} [operator port [port]]     {dest_ip_spec} [operator port [port]] [established]     [precedence precedence] [tos tos]
    [before editbuffer_index | modify editbuffer_index]
set security acl ip acl_name} {permit | deny |     redirect {mod_num/port_num}} [UDP | 17]     {src_ip_spec} [operator port [port]]     {dest_ip_spec} [operator port [port]]
    [precedence precedence] [tos tos]
    [before editbuffer_index | modify editbuffer_index]

Creates a new entry in an IP VACL and appends the new entry at the end of the VACL.

P

set security acl ipx

set security acl ipx {acl_name} {permit | deny | redirect mod_num/port_num} {protocol}     {src_net} [dest_net.[dest_node]     [[dest_net_mask.]dest_node_mask]]
    [before editbuffer_index modify editbuffer_index]

Creates a new entry in a standard IPX VACL.

P

set security acl mac

set security acl mac {acl_name} {permit | deny}     {src_mac_addr_spec} {dest_mac_addr_spec}     [ether-type] [before editbuffer_index |
    modify editbuffer_index]

Creates a new entry in a non-IP or non-IPX protocol VACL.

P

set security acl map

set security acl map acl_name vlan

Maps an existing VACL to a VLAN.

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 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}] [learning {enable | disable}]     [multicast {enable | disable}]
    [filter vlans...] [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

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} |
    trcrf [priority | trcrf_priority]

Sets the bridge priority for a spanning-tree port.

P

set spantree portstate

set spantree portstate trcrf {block | forward | auto}     [trbrf]

Assigns the state of a TrCRF.

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] [rspan]

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

set vmps tftpserver ip_addr [filename]

Specifies the IP address of the VMPS TFTP server.

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 cam msfc

show cam msfc {mod_num} [vlan]

Displays the router's MAC-VLAN entries.

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]
show channel [channel_id] [info [spantree | trunk |     protcol | gmrp | gvrp | qos]]

Displays EtherChannel information for a channel.

N

show channel group

show channel group [admin_group] [info | statistics]
show channel group [admin_group] [info [spantree |     trunk | protcol | gmrp | gvrp | qos]]

Displays EtherChannel group status information.

N

show config

show config

Displays the current system configuration.

P

show config qos acl

show config qos acl acl_name | all

Displays the committed access lists.

N

show cops

show cops info [diff-serv | rsvp]
show cops pib
show cops roles

Displays COPS information.

N

show counters

show counters mod/port

Displays hardware counters for a port.

N

show environment

show environment [temperature | all | power]

Displays system status information.

N

show file

show file [device:]filename [dump]]

Displays the contents of a file that has been saved to Flash.

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 lda

show lda [committed | uncommitted]
show lda mls entry
show lda mls entry [destination ip_addr_spec]     [source ip_addr_spec] [protocol protocol]
[src-port port_number] [dst-port port_number]
    [short | long]
show lda mls statistics count
show lda mls statistics entry
show lda mls statistics entry
    [destination ip_addr_spec] [source ip_addr_spec]
[protocol protocol] [src-port port_number]     [dst-port port_number]

Displays the ASLB configuration information.

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 mls

show mls [ip | ipx] [mod]
show mls nde

Displays MLS shortcut information.

N

show mls entry

show mls entry [mod] [short | long]
show mls entry ip [mod] [destination ip_addr_spec]     [source ip_addr_spec] [protocol protocol]     [src-port port_number] [dst-port port_number]
    [short | long]
show mls entry ipx [mod]
[destination ipx_addr_spec]
[source ipx_addr_spec] [short | long]

Displays MLS state information.

N

show mls exclude protocol

show mls exclude protocol

Displays excluded protocols on TCP or UDP from being shortcuts.

N

show mls multicast

show mls multicast
show mls multicast entry {[mod] [vlan vlan_id]     [group ip_addr]} [source ip_addr]
[all | long | short]
show mls multicast statistics {mod}

Displays MLS multicast information.

N

show mls statistics

show mls statistics protocol
show mls statistics entry [mod]
show mls statistics entry ip [mod]
    [destination ip_addr_spec] [source ip_addr_spec]
[flow protocol src_port dst_port]
show mls statistics entry ipx [mod]
    [destination ipx_addr_spec]
    [source ipx_addr_spec]

Displays MLS statistical information.

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 cops

show port cops [mod | mod/port]

Displays COPS information for all or individual ports.

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 jumbo

show port jumbo

Displays jumbo frame information for all ports.

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 rsvp

show port rsvp [mod | mod/port]

Displays RSVP+-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 acl editbuffer

show qos acl editbuffer

Displays ACL names in the edit buffer.

N

show qos acl info

show qos acl info default-action ip | ipx | mac | all
show qos acl info acl_name | all [editbuffer     [editbuffer_index]]

Displays QoS ACL information.

N

show qos acl map

show qos acl map {config | runtime} {acl_name |     mod_num/port_num | vlan | all}

Displays ACL mapping information.

N

show qos acl resource-usage

show qos acl resource-usage

Displays ACL management information.

N

show qos bridged-packet-policing

show qos bridged-packet-policing [vlan]

Displays the bridged packet policing status for different VLANs.

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] [config]
show qos mac-cos all [config]

Displays the currently configured QoS-related information MAC/VLAN pair.

N

show qos maps

show qos maps [config | runtime] [cos-dscp-map |     ipprec-dscp-map | dscp-cos-map |     policed-dscp-map]

Displays QoS map information.

N

show qos policer

show qos policer {config | runtime} {microflow |     aggregate | all}

Displays policing information.

N

show qos rsvp

show qos rsvp info
show qos rsvp flow-info

Displays RSVP+ information.

N

show qos statistics

show qos statistics {mod_num}
show qos statistics {mod_num/port_num}
show qos statistics {l3stats}

Displays the various QoS-related counters for a specified port.

N

show radius

show radius [noalias]

Displays configured RADIUS parameters.

N

show rsmautostate

show rsmautostate mod_num

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

N

show rspan

show rspan

Displays the remote SPAN configuration.

N

show security acl

show security acl
show security acl [editbuffer]
show security acl info acl_name | all [editbuffer [editbuffer_index]]

Displays the contents of the ACL that is currently configured or were last committed to NVRAM and hardware.

N

show security acl map

show security acl map acl_name
show security acl map vlan

Displays VACL-to-VLAN mapping for a specified ACL or VLAN.

N

show security acl resource-usage

show security acl resource-usage

Displays ACL management information.

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 vmps

show vmps [noalias]

Displays VMPS configuration information.

N

show vmps statistics

show vmps statistics

Displays VMPS statistics.

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

switch console

switch console

Switches the console connection from the supervisor engine console to the MFSC on the active 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 family 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: Fri Dec 31 10:56:41 PST 1999
Copyright 1989-1999©Cisco Systems Inc.