cc/td/doc/product/lan/cat5000/rel_5_2
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Command-Line Interfaces

Command-Line Interfaces

This chapter describes the command-line interface (CLI) available on the Catalyst 5000 family, 4000 family, 2926G series, and 2948G switches and contains the following sections:

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

Switch CLI

The Catalyst 5000 family, 4000 family, 2926G series, and 2948G 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 5000 family, 4000 family, 2926G series, and 2948G switches Ethernet, Fast Ethernet, Gigabit Ethernet, CDDI, and FDDI 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.

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 through the Console (EIA/TIA-232) Port

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 through Telnet

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

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 cat5000-1.cisco.com
Trying 172.16.44.30 ...
Connected to cat5000-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 (login) and privileged (enable). 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)

Command-Line Editing

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 commands or parameters available in the same context. You can scroll through the last 20 commands stored in the history buffer, and enter or edit the command at the prompt. Table 1-1 describes the keys used for editing.


Table 1-1: Command-Line Editing 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 History Substitution

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


Table 1-2: 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 the 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 the string aaa.

Abbreviating a Command

You can abbreviate commands and keywords to the number of characters that allow a unique abbreviation.

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

Completing a Partial Command

The Tab key allows you to use the command-completion feature. When you enter a unique partial character string and press the Tab key, the system completes the command or keyword on the command line.

For example, if you enter co and press the Tab key, the system completes the command as configure because it is the only command that matches the criteria.

Scrolling Down a Line or a Screen

When the output of a command fills more than 1 terminal screen 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.

Using Command Aliases

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


Table 1-3: Switch CLI Command Aliases
Alias Command

?

help

batch

configure

di

show

exit

quit

logout

quit

Specifying Modules, Ports, and VLANs

Modules, ports, and VLANs are numbered sequentially, beginning with 1. The supervisor engine module is module 1, residing in slot 1. If your Catalyst 5500 series switch has a redundant supervisor engine, the supervisor modules must be installed in slots 1 and 2.

To designate a specific module, use the module number. In most systems, the module number and the slot number are the same. However, in some cases the slot number and the module number are different. For example, the Route Switch Feature Card (RSFC) on the supervisor engine is physically in slot 1 or slot 2 but is logically identified as module 15 or module 16.

On the fixed-configuration switches, there are two logical modules. However, on the Catalyst 4912G switch and the Catalyst 2948G switch, there are two modules but only one slot. When you enter configuration commands on these switches, you must refer to the module number, not the slot number. For example, all of the user-configurable ports on these switches are logically on module 2.

On modules that have user-configurable ports, the left-most port is always port 1. To designate a specific port on a specific module, the command syntax is mod_num/port_num. For example, 3/1 specifies module 3, port 1. On the Catalyst 4912G switch and the Catalyst 2948G switch, the left-most switch port is numbered 2/1 rather than 1/1 because logically the ports are located on module 2.

With many commands, you can enter lists of ports. To specify a range of ports, use a comma-separated list (do not insert spaces) to specify individual ports or a hyphen (-) between the port numbers to specify a range of ports. Hyphens take precedence over commas.

Table 1-4 shows examples of how to designate ports and port ranges.


Table 1-4: Designating Ports and Port Ranges
Example Function

2/1

Specifies port 1 on module 2

3/4-8

Specifies ports 4, 5, 6, 7, and 8 on module 3

5/2,5/4,6/10

Specifies ports 2 and 4 on module 5 and port 10 on module 6

3/1-2,4/8

Specifies ports 1 and 2 on module 3 and port 8 on module 4

VLANs are identified using the VLAN ID, a single number associated with the VLAN. To specify a list of VLANs, use a comma-separated list (do not insert spaces) to specify individual VLANs or use a hyphen (-) between the VLAN numbers to specify a range of VLANs.

Table 1-5 shows examples of how to designate VLANs and VLAN ranges.


Table 1-5: Designating VLANs and VLAN Ranges
Example Function

10

Specifies VLAN 10

5,10,15

Specifies VLANs 5, 10, and 15

10-50,500

Specifies VLANs 10 through 50, inclusive, and VLAN 500

Specifying MAC Addresses

Some commands require you to specify a Media Access Control (MAC) address, which must be designated in a standard format. The MAC address format must be six hexadecimal numbers separated by hyphens, as shown in the following example:

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

Specifying IP Addresses, Hostnames, and IP Aliases

Some commands require an IP address, IP hostname, or IP alias. The IP address format is 32 bits, written in dotted decimal format, as shown in the following example:

172.16.10.1
 
 

If DNS is configured properly on the switch, you can use IP hostnames instead of IP addresses. For information on configuring DNS, see the Software Configuration Guide for your switch.

You also can configure IP aliases on the switch, which you can use in place of IP addresses. IP aliases can be used for most commands that use an IP address, except for commands that define the IP address or IP alias. For information on using IP aliases, see the Software Configuration Guide for your switch.

Accessing Command Help

To display a list of top-level commands and command categories, enter 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.

Displaying Top-Level Commands and Command Categories

In normal mode, enter help or ? to display 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>
 

In privileged mode, enter help or ? to display 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)
Displaying Command Categories

When you enter help or ? after some commands (such as clear, set, and show), a list of commands in that category is displayed. 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
...
Using Context-Sensitive Help

Usage and syntax information for individual commands are displayed 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>
       (screenlength = 5..512, 0 to disable 'more' feature)
Console> 

Performing Keyword Lookups

You can use the self-repeat feature and the keyword-lookup or partial-keyword-lookup functions by entering ?.

To use the keyword-lookup function, enter ? to display a list of valid keywords and arguments for a command. Insert a space between the last parameter and the question mark (?). For example, eight parameters are used by the set mls command. To see these parameters, enter set mls ? at the privileged prompt. The system displays all valid keywords and arguments as follows:

Console> (enable) set mls ?   
  agingtime                  Set agingtime for MLS cache entry
  disable                    Disable MLS in the switch
  enable                     Enable MLS in the switch
  nde                        Configure Netflow Data Export
  flow                       Set minimum flow mask
  include                    Include MLS-RP
  multicast                  Set MLS feature for multicast
  statistics                 Add protocols to protocol statistics list
Console> (enable) set mls 
 

Note that the system repeats the command you entered without the ?.

To use the partial-keyword-lookup function, enter ? to display a list of commands that begin with a specific set of characters. Do not insert a space between the last letter of the variable and the question mark (?). For example, enter co? at the privileged prompt to display a list of commands that start with co. The system displays all commands that begin with co as follows:

Console> (enable) co? 
  configure                  Configure system from network
  copy                       Copy files between TFTP/RCP/module/flash devices
Console> (enable) co
 

Note that the system repeats the command you entered without the ?.

Switch Commands Quick Reference

Table 1-6 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-6: 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 shorthand version of commands

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

clear boot system all [mod]
clear boot system flash device:[filename] [mod]
clear boot auto-config [mod]

Clears image names from the BOOT environment variable.

P

clear cam

clear cam {mac_addr | dynamic | static |     permanent} [vlan_num]

Clears CAM table entries.

P

clear cgmp statistics

clear cgmp statistics

Clears CGMP statistical information.

P

clear config

clear config mod_num
clear config {rmon | all | extendedrmon}

Clears the configuration and resets the system.

P

clear counters

clear counters

Clears MAC and port counters.

P

clear drip statistics

clear drip statistics

Clears DRiP statistical information.

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 all
clear ip route
destination gateway

Clears IP routing table entries.

P

clear kerberos clients mandatory

clear kerberos clients mandatory

Disables mandatory Kerberos authentication for services on the network.

P

clear kerberos credentials forward

clear kerberos credentials forward

Disables credential forwarding.

P

clear kerberos creds

clear kerberos creds

Deletes all Kerberos credentials.

P

clear kerberos realm

clear kerberos realm {dns-domain | host} kerberos-realm

Clears entry mapping the name of the Kerberos realm to a DNS domain or host name.

P

clear kerberos server

clear kerberos server kerberos-realm {hostname | ip-address} [port_number]

Clears a specified key distribution center entry.

P

clear kerberos srvtab entry

clear kerberos srvtab entry kerberos-principal principal-type

Clears the SRVTAB file entered directly into the switch from the command line.

P

clear key config-key

clear key config-key

Clears the config-key.

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 entry ip

clear mls entry ip [destination ip_addr_spec]     [source ip_addr_spec] [flow protocol src_port     dst_port] [all]

Clears the IP MLS entries in the Catalyst 5000 family and 2926G series switches.

P

clear mls entry ipx

clear mls entry ipx [destination ipx_addr_spec]     [source ipx_addr_spec] [all]

Clears the IPX dynamic MLS entries in the Catalyst 5000 family and 2926G series switches.

P

clear mls include ip

clear mls include ip {ip_addr} [all]

Clears the IP MLS-RP feature in the Catalyst 5000 family and 2926G series switches.

P

clear mls include ipx

clear mls include ipx {ip_addr} [all]

Clears the IPX MLS-RP feature in the Catalyst 5000 family and 2926G series switches.

P

clear mls multicast include

clear mls multicast include{ip_addr | all}

Allows a MLS-RP router to participate in IP multicast MLS.

P

clear mls multicast statistics

clear mls multicast statistics rp

Clears MLS statistics from the router processor.

P

clear mls nde

clear mls nde flow

Clears the netflow data export filter in the Catalyst 5000 family and 2926G series switches.

P

clear mls statistics

clear mls statistics
clear mls statistics protocol protocol | port | all

Clears the IP or IPX MLS feature in the Catalyst 5000 family and 2926G series switches.

P

clear multicast router

clear multicast router all
clear multicast router
mod/ports...

Clears multicast router ports.

P

clear ntp key

clear ntp key {public_keynum | all}

Removes authentication key.

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

Disables broadcast/multicast suppression on one or more ports.

P

clear port filter

clear port filter [mod_num/port_num] [mac_addr |     protocol_type | all]

Clears all configured MAC addresses or protocol filters or those filters configured on a specific port.

P

clear port host

clear port host

Clears host and access ports back to default.

P

clear port qos cos

clear port qos mod/ports... cos

Returns the values set by the set port qos command to the default values for all ports.

P

clear port security

clear port security mod_num/port_num {mac_addr | all}

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

P

clear qos config

clear qos config

Returns the values set by the set qos command to the default values and deletes the CoS-to-MAC address mappings.

P

clear qos defaultcos

clear qos defaultcos

Restores the default CoS value for the entire switch

P

clear qos ip-filter

clear qos ip-filter [ACE#]
clear qos ip-filter all

Returns the values set by the set qos ip-filter command to the default values for all ports.

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

P

clear qos map

clear qos map port_type

Returns the values set by the set qos map command to the default values.

P

clear qos router-mac

clear qos router-mac mac_address vlan
clear qos router-mac all

Returns the values set by the set qos router-mac command to the default values.

P

clear radius key

clear radius key

Clears RADIUS shared keys from the RADIUS shared key table.

P

clear radius server

clear radius server all
clear radius server
ipaddr

Clears RADIUS servers from the RADIUS server table.

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     preferred_vlans

Clears spanning-tree path cost to a VLAN on a port.

P

clear spantree portvlanpri

clear spantree portvlanpri mod_num/port_num     vlans
clear spantree portvlanpri trcrf | trbrf

Clears spanning-tree port VLAN priority.

P

clear spantree root

clear spantree root vlans

Restores the switch priority and Spanning-Tree Protocol parameters to the default values.

P

clear spantree statistics

clear spantree statistics mod_num/port_num
clear spantree statistics vlan

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 | all}

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/ports... [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 existing 802.1Q VLAN to ISL VLAN-mapped pairs.

P

clear vmps server

clear vmps server ip_addr

Removes a VMPS server from the VMPS table.

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

configure

configure host file [rcp]

Downloads a configuration file from the network and executes each command in the file.

P

copy

copy file-id {file-id | tftp | rcp | flash | config}
copy cfg1 {tftp | rcp | flash | config | cfg2} [all]
copy cfg2 {tftp | rcp | flash | config | cfg1} [all]
copy config {file-id | flash | tftp | rcp} [all]
copy tftp {file-id | flash | config | cfg1 | cfg2}
copy rcp {file-id | flash | config | cfg1 | cfg2}
copy flash {file-id | tftp | rcp | config}

Copies software images between a Supervisor Engine III and the Catalyst 4000 and 2948G switch supervisor engine modules 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 (switch command).

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] [rcp]
download serial [mod_num]

Copies a software image from a host to a module's Flash memory.

P

download vmps

download vmps mod [rcp]

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

Shows 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 [mod]

Shows 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

reload

reload mod_num

Forces a Gigabit EtherChannel switching module to accept a download.

P

resetswitch

reset [system]
reset [mod_num | system | mindown]

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

P

session

session mod_num

Connects the CLI to a session on a module (such as the ATM or RSM 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
set arp agingtime agingtime

Creates an ARP table entry and sets the ARP entry aging time.

P

set authentication enable

set authentication enable {local | radius | tacacs |     kerberos} enable [console | telnet | both]     [primary]
set authentication enable {local | radius | tacacs |     kerberos} enable [console | telnet | both]

Set authentication using TACACS+ or RADIUS server to determine access permissions.

P

set authentication login

set authentication login {local | radius | tacacs |     kerberos} enable [console | telnet | both]     [primary]
set authentication login {local | radius | tacacs |     kerberos} enable [console | telnet | both]

Sets authentication method.

P

set banner motd

set banner motd c [text] c

Sets the message-of-the-day banner.

P

set boot auto-config

set boot auto-config device:filename     [;<device:filename>...] [mod_num]
set boot auto-config {cfg1 | cfg2 | cfg1;cfg2}
set boot auto-config {recurring | non-recurring}

Specifies one or more configuration files to use to configure the switch at startup and to set the recurrence option.

P

set boot config-register

set boot config-register 0xvalue [mod_num]
set boot config-register boot {rommon | bootflash |
    system} [mod_num]
set boot config-register baud {1200 | 2400 | 4800 |
    9600} [mod_num]
set boot config-register ignore-config {enable |     disable} [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 bridge apart

set bridge apart {enable | disable}

Enables or disables APaRT on FDDI.

P

set bridge fddicheck

set bridge fddicheck {enable | disable}

Enables or disables FDDICHECK on FDDI.

P

set bridge ipx 8022toether

set bridge ipx 8022toether {8023 | snap | eii |     8023raw}

Sets the default mode for translating IPX frames from FDDI 802.2 to Ethernet.

P

set bridge ipx 8023rawtofddi

set bridge ipx 8023rawtofddi {8022 | snap |     fddiraw}

Sets the default mode for translating IPX frames from Ethernet 802.3 raw to FDDI.

P

set bridge ipx snaptoether

set bridge ipx snaptoether {8023 | snap | eii |     8023raw}

Sets the default mode for translating IPX FDDI SNAP frames to Ethernet frames.

P

set cam

set cam {dynamic | static | permanent}     {unicast_mac} {mod/port} [vlan]
set cam {dynamic | static | permanent}     {route_descr} {mod/port} [vlan]
set cam {static | permanent} {multicast_mac}     {mod/ports...} [vlan]
set cam agingtime vlan agingtime

Creates a CAM table entry and sets the CAM aging time.

P

set cdp

set cdp {enable | disable} [mod/ports...]

Enables and disables CDP on a port.

P

set cdp holdtime

set cdp holdtime holdtime

Configures the CDP hold time.

P

set cdp interval

set cdp interval interval

Sets the message interval for CDP.

P

set cgmp

set cgmp {enable | disable}

Enables or disables CGMP.

P

set cgmp leave

set cgmp leave {enable | disable}

Enables or disables CGMP leave processing.

P

set channel cost

set channel cost {channel_id | all} [cost]

Sets the spanning-tree port cost for an EtherChannel port bundle.

P

set channel vlancost

set channel vlancost channel_id [cost]

Sets the spanning-tree port-VLAN cost for an EtherChannel port bundle.

P

set enablepass

set enablepass

Sets the enable (privileged) password.

P

set fddi alarm

set fddi alarm mod_num/port_num value

Sets the LER-alarm value.

P

set fddi cutoff

set fddi cutoff mod_num/port_num value

Sets the LER-cutoff value.

P

set fddi tlmin

set fddi tlmin mod_num/port_num microseconds

Sets the TL_MIN value for an FDDI port.

P

set fddi tnotify

set fddi tnotify mod_num time

Sets the T_Notify timer value for an FDDI port.

P

set fddi treq

set fddi treq mod_num time

Sets the TRequest value for an FDDI module.

P

set fddi userdata

set fddi userdata mod_num [userdata_string]

Sets the user-data string in the SMT MIB of an FDDI module.

P

set garp timer

set garp timer timer_type timer_value

Adjusts the values of the join, leave, and leaveall timers.

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

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

P

set gmrp registration

set gmrp registration registration-type mod/port...

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.

P

set gvrp

set gvrp {enable | disable}

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

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.

P

set igmp

set igmp {enable | disable}

Enables or disables IGMP snooping on the switch.

P

set igmp fastleave

set igmp fastleave {enable | disable}

Enables or disables IGMP fastleave processing

P

set interface

set interface {sc0 | sl0 | me1} {up | down}
set interface sc0 [vlan] [ip_addr [netmask     [broadcast]]
set interface sc0 [vlan] [ip_addr/netmask     [broadcast]]
set interface me1 [ip_addr [netmask [broadcast]]
set interface me1 [ip_addr/netmask [broadcast]]
set interface sl0 {slip_addr} {dest_addr}
set interface sc0 dhcp {renew | release}

Sets a network interface configuration and enables or disables standard SNMP trap operation.

P

set interface trap

set interface trap {sc0 | me1 | sl0} {enable | disable}

Enables or disables SNMP link up/down traps on the switch interfaces

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 IP fragmentation for 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 default gateway [metric][primary]
set ip route destination [/netmask] gateway

Adds entries to the IP routing table.

P

set ip unreachable

set ip unreachable {enable | disable}

Enables or disables ICMP unreachable messages.

P

set kerberos clients mandatory

set kerberos clients mandatory

Makes Kerberos authentication mandatory for authenticating to services on the network.

P

set kerberos credentials forward

set kerberos credentials forward

Configures clients to forward users' credentials when connecting to other hosts.

P

set kerberos local-realm

set kerberos local-realm kerberos-realm

Configures switch to authenticate users defined in Kerberos database.

P

set kerberos realm

set kerberos realm dns-domain | host kerberos-realm

Maps the name of a Kerberos realm to a DNS or host name.

P

set kerberos server

set kerberos server kerberos-realm hostname | ip-address [port-number]

Specifies key distribtion center to the switch.

P

set kerberos srvtab entry

set kerberos srvtab entry kerberos-principal principal-type timestamp key-version number key-type key-length encrypted-keytab

Enters the SRVTAB file directly into the switch from the command line.

P

set kerberos srvtab remote

set kerberos srvtab remote {hostname | ip-address} {file name}

Provides the switch with SRVTAB file on the key distribtion center.

P

set key config-key

set key config-key string

Defines a private DES key for the switch.

P

set length

set length number [default]

Sets the number of lines in the terminal display screen.

P

set logging buffer

set logging buffer buffer_size

Limits the messages buffered.

P

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 server_facility_parameter
set logging server severity server_severity_level

Enables, disables, or configures 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 or disables system logging messages to the current login session.

P

set logging timestamp

set logging timestamp {enable | disable}

Enables or disables the timestamp display on system logging messages.

P

set logout

set logout timeout

Sets the number of minutes before an automatic logout.

P

set mls

set mls {enable | disable} {ip | ipx}

Enables and disables IP or IPX MLS on the switch.

P

set mls agingtime

set mls agingtime {ip | ipx} agingtime

Configures the MLS feature in the Catalyst 5000 family and 2926G series switches.

P

set mls agingtime fast

set mls agingtime fast fastagingtime pkt_threshold

Configures the MLS fast-aging time feature in the Catalyst 5000 family and 2926G series switches.

P

set mls flow

set mls flow {destination | destination-source | full}

Specifies the minimum flow mask used for MLS.

P

set mls include

set mls include {ip | ipx} ip_addr1 [ip_addr2...]

Use the set mls include command to specify routers to add to the IP MLS-RP include list.

P

set mls multicast

set mls multicast {enable | disable}

Configures the IP multicast MLS feature in the Catalyst 5000 family and 2926G series switches.

P

set mls multicast include

set mls multicast include ip_addr

Specifies routers to add to the IP MMLS-RP include list.

P

set mls nde

set mls nde {disable | enable}
set mls nde {collector_ip | collector_name}     {udp_port_num}
set mls nde flow [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 the preconfigured collector.

P

set mls statistics protocol

set mls statistics protocol protocol port

Specifies protocols and ports for which to gather MLS statistics.

P

set module disable

set module disable mod_num

Disables a module.

P

set module enable

set module enable mod_num

Enables a module.

P

set module name

set module name mod_num [mod_name]

Sets the name of a module.

P

set multicast router

set multicast router mod_num/port_num

Configures multicast router ports.

P

set ntp authentication

set ntp authentication enable | disable

Enables or disables the NTP authentication feature.

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 key

set ntp key public_keynum {trusted | untrusted}
    [md5 secret_keystring]

Defines an NTP authentication key pair or specifies a key to be trusted or untrusted.

set ntp server

set ntp server ip_addr [key public_keynum]

Configures an authentication key to an 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 port_list [admin_group]
set port channel port_list mode {on | off | desirable |     auto} [silent | non-silent]

Configures Fast EtherChannel on two or more ports.

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}

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 filter

set port filter mod_num/port_num {mac_addr |     protocol_type} {permit | deny}

Configures a MAC address filter or a protocol filter.

P

set port flowcontrol

set port flowcontrol mod_num/port_num {receive |     send} {off | on | desired}

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 host

set port host

Configures host and access ports.

set port level

set port level mod_num/port_num {normal | high}

Sets the priority level of a port.

P

set port membership

set port membership mod_num/port_num {dynamic     | static}

Dynamically or statically assigns a port to a VLAN membership.

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

set port qos mod/ports... cos cos_value

Assigns CoS value to a port.

P

set port security

set port security mod/ports... {enable | disable}     [mac_addr]

Enables or disables port security on a port of an Ethernet module.

P

set port speed

set port speed mod_num/port_num {4 | 10 | 16 | 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 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}

Enables or disables QoS functionality.

P

set qos defaultcos

set qos defaultcos cos_value

Defines the default CoS value for the entire switch.

P

set qos ip-filter

set qos ip-filter cos {src_ip_addr_spec}     {dest_ip_addr_spec} [before ACE# | modify     ACE#]
set qos ip-filter cos protocol {src_ip_addr_spec}     {src_port} {dest_ip_addr_spec}{dest_port}     [before ACE# | modify ACE#]

Creates a new IP ACE.

P

set qos mac-cos

set qos mac-cos dest_mac vlan cos

Assigns a CoS value to all frames.

P

set qos map

set qos map port_type q# thr# cos coslist

Assigns CoS values to a transmit drop threshold.

P

set qos router-mac

set qos router-mac mac_address vlan

Assigns a MAC address to a router.

P

set qos wred-threshold

set qos wred-threshold port_type [rx | tx] queue {q#     thr1 thr2 thr3 thr4}

Configures the transmit drop thresholds for all ports on the switch.

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 RADIUS encryption key.

P

set radius retransmit

set radius retransmit count

Sets iterations of RADIUS server list.

P

set radius server

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

Sets RADIUS server address.

P

set radius timeout

set radius timeout seconds

Sets time to wait for RADIUS server reply.

P

set rcp username

set rcp username username

Specifies your username for RCP file transfers.

P

set rsmautostate

set rsmautostate {enable | disable}

Sets the line protocol state determination of the RSMs due to Catalyst 5000 family and 2926G series 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 extendedrmon

set snmp extendedrmon {enable | disable}

Enables or disables the Network Analysis Module.

P

set snmp extendedrmon netflow

set snmp extendedrmon netflow {enable password |     disable}

Enables or disables the Netflow extended SNMP RMON support.

P

set snmp extendedrmon vlanagent

set snmp extendedrmon vlanagent {enable |     disable}

Enables or disables the VLANagent option.

P

set snmp extendedrmon vlanmode

set snmp extendedrmon vlanmode {enable |     disable}

Enables or disables the VLAN mode for extended SNMP RMON.

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. Also 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_vlan... | sc0} {dest_mod/dest_port} [rx | tx | both]
    [inpkts {enable | disable}] [learning {enable | disable}][multicast {enable | disable}]
    [create]

Enables or disables SPAN. Also 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 all

Disables spanning tree.

P

set spantree enable

set spantree enable 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 multicast-address

set spantree multicast-address trbrf_num     {ieee | ibm}

Specifies the bridge functional address instead of the IEEE Spanning-Tree Protocol address.

P

set spantree portcost

set spantree portcost {mod_num/port_num | trcf}     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 trcf {block | forward | auto}     [trbrf]

Sets the forwarding state for a spanning-tree port.

P

set spantree portvlancost

set spantree portvlancost mod_num/port_num [cost     cost_value] [preferred_vlans]

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 [rate     station_update_rate] [all-protocols {off | on}]
set spantree uplinkfast disable

Enables 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 tokenring acbits

set tokenring acbits mod_num/port_num {enable |     disable | sronly | never | always}

Sets whether AC bits are set unconditionally when a port forwards certain LLC frames.

P

set tokenring configloss

set tokenring configloss mod_num/port_num     [threshold thresh_num] [interval int_num]

Sets thresholds that, when exceeded, cause the port to be administratively disabled.

P

set tokenring distrib-crf

set tokenring distrib-crf {enable | disable}

Enables or disables distribution of TrCRF VLANs.

P

set tokenring etr

set tokenring etr mod_num/port_num {enable |     disable}

Enables or disables the early token release procedure when transmitting frames.

P

set tokenring explorer-throttle

set tokenring explorer-throttle mod_num/port_num     maximum_explorers

Controls the number of incoming explorer frames per second allowed on a Token Ring module port.

P

set tokenring locallearning

set tokenring locallearning mod_num/port_num     enable | disable

Enable or disables local MAC address learning on a Token Ring port.

P

set tokenring portaging

set tokenring portaging mod_num/port_num     agingtime

Specifies the address aging limits for a Token Ring port.

P

set tokenring portmode

set tokenring portmode mod_num/port_num {auto |     fdxcport | hdxcport | fdxstation | hdxstation |     riro}

Specifies the connection type and access protocol used by a port.

P

set tokenring priority

set tokenring priority mod_num/port_num     {threshold thresh_num | minxmit min_num}

Specifies the highest and lowest Token Ring frame priority.

P

set tokenring reduction

set tokenring reduction {enable | disable}

Reduces broadcast storms in an externally looped network.

P

set trunk

set trunk mod_num/port_num [on | off | desirable |     auto | nonegotiate] [vlan_range] [isl | dot1q |     dot10 | lane | negotiate]

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_num/port_list
set vlan vlan_num [name name] [type {ethernet |
    fddi | fddinet | trcrf | trbrf}] [state {active |     suspend}] [said said] [mtu mtu] [ring     hex_ring_number ] [decring decimal_ring_number     ] [bridge bridge_num] [parent vlan_num] [mode     {srt | srb}] [stp {ieee | ibm | auto}] [translation     vlan_num] [backupcrf {off | on}] [aremaxhop     hop_count] [stemaxhop 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 vmps downloadmethod

set vmps downloadmethod {rcp | tftp}     [username]

Specifies use of TFTP or RCP to download the VMPS database.

P

set vmps downloadserver

set vmps downloadserver ip_addr [filename]

Specifies use of TFTP or RCP server's IP address from the downloaded VMPS database and the VMPS storage location.

P

set vmps server

set vmps server ip_addr [primary]

Sets the IP address of the VMPS server.

P

set vmps state

set vmps state {enable | disable}

Enables or disables VMPS.

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 vlans

Configures pruning eligibility for the device.

P

show alias

show alias [name]

Shows aliases for commands.

N

show arp

show arp [ip_addr | hostname][noalias]

Shows 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 bridge

show bridge

Displays bridge information.

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]

Shows the CAM table.

N

show cam agingtime

show cam agingtime

Shows CAM aging time information for all configured VLANs.

N

show cam mlsrp

show cam mlsrp {ip_addr}[vlan]

Shows the specified router entries in the MLS forwarding table.

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 cgmp leave

show cgmp leave

Displays CGMP leave feature statistical information.

N

show cgmp statistics

show cgmp statistics [vlan_id]

Displays CGMP statistical information.

N

show channel

show channel [channel_id] [statistics | mac | info     [spantree | trunk | protocol | gmrp | gvrp | qos]]

Displays EtherChannel configuration and statistics information for a channel based on EtherChannel ID.

N

show channel group

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

Displays EtherChannel configuration and statistics information for a channel based on EtherChannel administrative group membership.

N

show config

show config {system | mod_num} [all]

Shows the current system configuration.

P

show counters

show counters mod/port

Displays hardware counters for a port.

N

show drip statistics

show drip statistics

Displays DRiP statistical information.

P

show dvlan statistics

show dvlan statistics

Displays DVLAN statistical information.

N

show fddi

show fddi

Displays the settings of the FDDI/CDDI modules.

N

show fddicam

show fddicam mod_num [fddi] [mac_addr]

Displays the CAM table for the FDDI/CDDI modules.

N

show file

show file [device:] filename [dump]

Displays the contents of a file.

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 GARP 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 flash | filename

Displays image information provided in the CISCO-IMAGE-MIB for a particular image.

N

show interface

show interface
show interface trap

Shows information about network interfaces and standard SNMP link trap operation

N

show ip alias

show ip alias [name]

Shows aliases for IP addresses.

N

show ip dns

show ip dns

Shows the DNS name server and the default domain name.

N

show ip permit

show ip permit [noalias]

Shows IP permit list information.

N

show ip route

show ip route [noalias]

Displays the IP routing table.

N

show kerberos

show kerberos

Displays Kerberos configuration.

N

show kerberos creds

show kerberos creds

Displays Kerberos credentials on the switch.

N

show log

show log [mod_num]

Displays the error log for the system or a specific module.

N

show logging

show logging [noalias]

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

Shows MAC counters.

N

show microcode

show microcode

Displays the switch microcode version.

N

show mls

show mls [ip | ipx]

Displays IP and IPX MLS configuration and status information.

N

show mls debug

show mls debug

Displays a list of all MLS-related debugging information.

P

show mls entry

show mls entry [ip] [qos] [rp ip_addr] [destination      ip_addr_spec] [source ip_addr_spec] [flow      protocol src_port dst_port]
show mls entry [ipx] [rp ip_addr] [destination      ipx_addr_spec] [source ipx_addr_spec]

Displays IP and IPX MLS cache entries.

N

show mls include

show mls include [ip | ipx] [noalias]

Displays information about the routers in the IP MLS-RP include list and the IPX MLS-RP include list.

N

show mls multicast entry

show mls multicast entry [rp rp_ip_addr] [vlan     vlan_id] [group group_ip_addr] [source     source_ip_addr]     [all] [short | long]

Displays IP multicast MLS cache entries.

N

show mls multicast include

show mls multicast include

Displays information about the routers in the IP multicast MLS-RP include list

N

show mls multicast statistics rp

show mls multicast statistics rp {ip_addr}

Displays IP multicast MLS statistics for MMLS-RPs.

N

show mls nde

show mls nde

Displays NDE configuration and status information.

N

show mls rp

show mls rp {ip | ipx} ip_addr [noalias]

Displays MLS shortcut information.

N

show mls statistics

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

Displays MLS statistical information.

N

show module

show module [mod_num]

Shows 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]

Shows the total count of multicast addresses (groups) in a VLAN.

N

show multicast router

show multicast router [cgmp | igmp]     [mod_num/port_num] [vlan_id]

Displays the multicast router configuration.

N

show netstat

show netstat [tcp | udp | ip | icmp | routes | stats |     interfaces]

Shows 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]]

Shows port status and counters.

N

show port broadcast

show port broadcast [mod_num[/port_num]]

Displays broadcast information.

N

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_num[/port_num]] [statistics     | info [spantree | trunk | protocol | gmrp | gvrp |     qos]]

Shows EtherChannel information.

N

show port counters

show port counters [mod_num/port_num]

Displays the counters for a port.

N

show port filter

show port filter [mod_num] [canonical]
show port filter mod_num/port_num [canonical]
show port filter mac_addr [canonical]

Displays configured MAC addresses and protocol filters.

N

show port flowcontrol

show port flowcontrol [mod_num[/port_num]]

Displays per port flow control status and statistics.

N

show port ifindex

show port ifindex [mod_num]
show port ifindex mod_num/port_num

Displays ifIndex information on a per-port or per-module basis.

N

show port negotiation

show port negotiation [mod_num[/port_num]]

Displays the link negotiation protocol setting for the 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
show port qos mod_num

Displays QoS-related information for a specifc port or all ports on a module.

N

show port security

show port security mod/ports... [statistics]

Views port security configuration and security information.

P

show port security statistics

show port security statistics mod | mod/port [system]

Displays port security configuration statistics.

P

show port status

show port status [mod_num[/port_num]]

Displays port status information.

N

show proc

show proc [cpu | mem] {mod_num}

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}
show qos info {runtime | config}     mod_num/port_num
show qos info config port_type tx

Displays the currently configured QoS-related information for a specified port.

N

show qos ip

show qos ip

Displays the access control list.

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 router-mac

show qos router-mac [mac_addr | vlan]

Displays QoS router information for the MAC address and 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 radius

show radius [noalias]

Displays configured RADIUS parameters.

N

show rif

show rif [vlan_num]

Displays RIF information.

N

show rsmautostate

show rsmautostate mod_num

Displays the line protocol state determination of the RSMs.

N

show snmp

show snmp [noalias]

Shows SNMP information.

N

show span

show span

Shows SPAN port monitoring information.

N

show spantree

show spantree [vlan | mod_num/port_num] [active]

Shows 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 portstate

show spantree portstate [trcrf ]

Determines the current spanning-tree state of a Token Ring port within a spanning tree.

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]
show spantree statistics {trcrf | trbrf}

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

N

show standbyports

show standbyports

Displays the current status of the standby ports feature.

N

show station controltable

show station controltable [mod_num[/port_num]]

Displays a collection of statistics and status information associated with each Token Ring station on the local ring.

N

show station ordertable

show station ordertable [mod_num[/port_num]]

Displays a listing of the order of stations on the monitored rings.

N

show summertime

show summertime

Displays the current status of the summertime feature.

N

show system

show system

Shows system information.

N

show tacacs

show tacacs [noalias]

Displays the TACACS+ configuration.

N

show test

show test [mod_num]

Shows the results of diagnostic tests.

N

show time

show time

Shows the current system time.

N

show timezone

show timezone

Shows the current time zone and offset.

N

show tokenring

show tokenring

Displays various Token Ring configuration parameters.

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 traffic

show traffic

Displays traffic/peak information.

N

show trunk

show trunk [mod_num[/port_num]][detail]

Shows 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]

Shows whether the console port is active. Also lists all active Telnet sessions.

N

show versionswitch

show version

Shows software and hardware version information.

N

show vlan

show vlan [trunk]
show vlan vlan [notrunk]
show vlan type

Shows VLAN information.

N

show vlan mapping

show vlan mapping

Shows VLAN mapping information.

N

show vmps

show vmps [noalias]

Displays VMPS configuration information.

N

show vmps mac

show vmps mac [mac_addr]

Displays the MAC-address-to-VLAN mapping table.

N

show vmps statistics

show vmps statistics

Displays VMPS statistics.

N

show vmps vlan

show vmps vlan vlan_name

Displays MAC address to VLAN mappings in the VMPS table.

N

show vmps vlanports

show vmps vlanports vlan_name

Displays ports belonging to a restricted VLAN.

N

show vtp domain

show vtp domain

Shows VTP domain information.

N

show vtp statistics

show vtp statistics

Shows 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 5000, 4000, 2948G, and 2926G series switches to a specific destination host.

P

undelete

undelete index [[m/]device:]

Undeletes a file.

P

upload

upload host file [mod_num] [rcp | tftp]

Uploads a software image to a network host.

P

verify

verify [[m/]device:] filename

Verifies the checksum of a file on a Flash device.

P

wait

wait seconds

Causes the CLI to pause for a specified number of seconds.

N

write

write {host file | network} [rcp] [all]

Uploads the current configuration to a host or displays it on the terminal.

P

write terminal

write terminal all

Displays the system configuration information currently in running memory.

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. The system enters ROM monitor mode if the switch does not find a valid system image, if the nonvolatile RAM (NVRAM) configuration is corrupted, or if the configuration register is set to enter ROM monitor mode.


Note The ROM monitor CLI is present only on the Supervisor Engine III, Supervisor Engine III F and the Catalyst 4000 family, 2926G series, and 2948G supervisor engine modules. The Supervisor Engine I and II modules do not have a ROM monitor interface.

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. You can manually load an image from any Flash device.

You can also enter ROM monitor mode by restarting the switch and pressing the Break key during the first 60 seconds of startup.


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

To access the ROM monitor through a terminal server, you can escape to the Telnet prompt and enter the send break command for your terminal emulation program to break into ROM monitor mode.

Once you are in ROM monitor mode, the prompt changes to rommon>. Use the ? command to see the available ROM monitor commands.

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 entered to customize the function of Cisco IOS software.

The manual boot command has the following syntax:


Note The Catalyst enterprise LAN switches do not support netboot.

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

ROM Monitor Commands Quick Reference

Table 1-7 lists each command in the ROM monitor command set, shows the command syntax, and provides a short description for the command.


Table 1-7: 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 [hexvalue]

Sets the configuration register value and starts the configuration register utility.

dev

dev

Lists the device IDs available on a platform.

dirROM monitor

dir device

Lists the files of the named device.

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 {mod_num | system}

Performs a soft reset of the switch.

set

set

Displays all of the monitor variable names with their values, or sets a monitor variable.

sync

sync

Saves changes to the ROM monitor configuration.

unalias

unalias name

Removes the alias name and associated value from the alias list.

unset=varname

unset=varname

Removes a variable name from the variable list.

varname=

varname=value

Assigns a variable to a value.


hometocprevnextglossaryfeedbacksearchhelp
Posted: Mon Oct 4 14:05:56 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.