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

Table of Contents

Switch Command Quick Reference

Switch Command Quick Reference

This chapter provides a quick command reference for the Catalyst 5000 series switch CLI.

Table 1-1 identifies each command in the switch command set, shows the command syntax, provides a short description, and specifies the mode for the command. For a list of acronyms used in this publication, refer to Appendix A, "List of Acronyms." For definitions of any terms listed in this publication, refer to Internetworking Terms and Acronyms.


Table 1-1: Switch Commands
Command Syntax Description Mode1
alias alias [name=value] Sets an alias to a command. N
boot boot -xv device imagename Boots the Supervisor Engine III from a file on a server. P
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 clear boot [mod_num] Clears the boot value. 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 | rmon | all} Clears the configuration and resets the system. P
clear counters clear counters Clears MAC and port counters. P
clear ip alias clear ip alias {name | all} Clears aliases of IP addresses. 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 | all} Clears IP routing table entries. P
clear log clear log [mod_num] Deletes all entries in the system error log. P
clear logging buffer clear logging buffer Clears the system logging buffer. P
clear logging server clear logging server ip_addr Deletes a syslog server from the configuration. P
clear multicast router clear multicast router {mod_num/port_num | all} Clears multicast router ports. P
clear ntp server clear ntp server {ip_addr | all} Deletes an NTP server from the server table. P
clear port broadcast clear port broadcast mod_num/port_num Disables broadcast/multicast suppression on one or more ports. P
clear 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 portcosts to the factory default values. P
clear spantree uplinkfast 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 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 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 Clears VTP statistics. P
configure configure {host file | network} Downloads a configuration file from the network and executes each command in the file. P
confreg confreg [num] Configures the register utility. N
copy copy file-id [tftp | flash | file-id]
copy tftp [flash | file-id]
copy flash [tftp | file-id]
copy [tftp | file-id] 		Copies software images between a Supervisor Engine III and a host. P
delete delete [[m/]device:] filename Deletes a file. P
dev dev Lists the devices on a switch. N
dir dir [[m/]device:][filename] {all | deleted | long} Displays a list of files on a Flash device. P
dir dir [device] Lists the files on a device. N
disable disable [level] 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] Copies a software image from a host to a module's Flash memory. P
download vmps download serial [mod_num] Copies software images to the supervisor card or Flash memory through a serial port. 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
history history Shows the contents of the command history buffer. N
meminfo meminfo [-l] Displays switch memory information. 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:] 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
repeat repeat [number | string] Repeats a specified command. N
reset reset {mod_num | system} 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 set Displays or sets ROM monitor variables. N
set alias set alias name command [parameter] [parameter] Creates an alias for a command. P
set arp set arp {ip_addr hw_addr [route_descr] | agingtime agingtime} Creates an ARP table entry, and sets the ARP entry aging time. P
set authentication enable set authentication enable {tacacs | local} {enable | disable} Sets TACACS+ enable authentication (for privileged mode access). P
set authentication login set authentication login {tacacs | local} {enable | disable} Sets TACACS+ login authentication (for login access). P
set banner motd set banner motd c [text] c Sets the message-of-the-day banner. P
set boot config-register set boot config-register 0xvalue [mod_num]
set boot config-register baud <1200 | 2400 | 4800 | 9600> [mod_num]
set boot config-register ignore-config <enable | disable> [mod_num]
set boot config-register boot <rommon | bootflash | system> [mod_num] 		Sets the boot configuration register attributes. P
set boot system flash set boot system flash device:[filename] [mod_num][prepend] Sets the boot system flash device. P
set boot config-register 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 | multicast_mac} mod_num/port_nums [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_num/port_num | all} Enables or disables CDP on a port. P
set cdp interval set cdp interval {mod_num/port_num | all} 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 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 interface set interface {sc0 | sl0} {up | down}
set interface sc0 [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 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 destination gateway [metric] Adds entries to the IP routing table. P
set ip unreachable set ip unreachable {enable | disable} Enables or disables ICMP unreachable messages. P
set length set length number [default] Sets the number of lines in the terminal display screen. N
set logging console set logging console {enable | disable} Enables and disables system message logging to the console. P
set logging level set logging level facility severity [default] Sets the facility and severity level for system message logging. P
set logging server set logging server {enable | disable}
set logging server ip_addr 		Enables or disables system message logging to syslog servers, and adds syslog servers to the system logging server table. P
set logging session set logging session {enable | disable} Enables and disables system logging messages to the current login session. P
set logout set logout timeout Sets the number of minutes before an automatic logout. P
set module 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 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 port_list {on | off | desirable | auto} Enables or disables Fast EtherChannel on two or more ports. P
set port disable set port {enable | disable} mod_num/port_num Enables or 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 level set port level mod_num/port_num {normal | high | auto} 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 [name_string] Sets the name 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 Ethernet 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 prompt set prompt prompt_string Sets the CLI prompt. 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]
set snmp trap rcvr_addr rcvr_community 		Enables or disables SNMP traps, and sets the SNMP trap receiver address and community. P
set span set span enable
set span disable
set span {src_mod/src_ports...} {dest_mod/dest_port} [rx|tx|both]
set span {src_vlan} {dest_mod/dest_port} [rx|tx|both] 		Enables or disables SPAN and sets the source and destination SPAN ports. P
set spantree disable set spantree disable [vlan] Disables spanning tree. P
set spantree enable set spantree enable [vlan] 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 | 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 priority | trcrf} Sets the bridge priority for a spanning-tree port. P
set spantree portstate set spantree portstate trcf {block | forward | auto} [trbf] Sets the forwarding state for a spanning-tree port. P
set spantree portvlancost set spantree portvlancost mod_num/port_num [cost cost] [VLAN_list] Assigns a lower path cost to a set of VLANS on a port. P
set spantree portvlancost 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] 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 trunk set trunk mod_num/port_num [on | off | desirable | auto] [vlan_range] Configures trunk ports. P
set vlan set vlan vlan_num mod/ports
set vlan vlan_num [name name] [type {ethernet | fddi | token_ring | fddi_net | tr_net}] [state {active | suspend}] [said said] [mtu mtu] [ring ring_num] [bridge bridge_num] [stp {ieee | ibm}] [parent vlan_num] [translation vlan_num] 		Creates and configures options for VLANs. 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 vmps tftpserver set vmps tftpserver ip_addr [filename] Specifies the IP address of the VMPS TFTP server. P
set vtp set vtp [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] Shows aliases for commands. N
show arp show arp [noalias] Shows the ARP table. N
show boot show boot [mod_num] Displays the contents of the BOOT and BOOTLDR environment.
show bridge show bridge Displays bridge information. N
show cam show cam {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 cdp show cdp neighbors [mod_num[/port_num]] [detail]
show cdp port [mod_num[/port_num]] 		Shows CDP information. N
show cgmp statistics show cgmp statistics [vlan_num] Displays CGMP statistical information. N
show config show config Shows the current system configuration. P
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 flash show flash [[m/]device:] Lists Flash code information. P
show interface show interface Shows information about network interfaces. 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 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]] Shows MAC counters. N
show microcode show microcode Displays the switch microcode version. P
show module show module [mod_num] Shows module information. N
show multicast group show multicast group [cgmp] [mac_addr] [vlan_id] Displays the multicast group configuration. N
show multicast group count show multicast group count Shows the total count of multicast addresses (groups) in a VLAN P
show multicast group count show multicast router [cgmp] [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 channel show port channel [mod_num[/port_num][info | statistics] Shows Fast EtherChannel information. N
show port counters show port counters [mod_num/port_num] Displays the counters for a port. P
show rif show rif [vlan] Displays RIF information. P
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]
show spantree [blockedports | active | statistics | summary]
show spantree portvlancost mod_num/port_num
show spantree uplinkfast 		Shows spanning-tree information. N
show spantree portvlancost 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 trunk show trunk [mod_num[/port_num]] Shows trunking information for the switch. N
show users show users [noalias] Shows whether the console port is active, and lists all active Telnet sessions. N
show version show version Shows software and hardware version information. N
show vlan show vlan [vlan] [trunk | notrunk] Shows VLAN 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 between active and standby supervisors. P
sync sync Saves changes to the ROM monitor configuration. N
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
unalias unalias name Removes a ROM monitor alias. N
undelete undelete index [[m/]device:] Undeletes a file. P
upload upload host file [mod_num] Uploads a software image to a network host. P
varname varname=value Assigns a variable to a value. N
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
whichboot whichboot Displays the name of the active boot device. P
write write {host file | network | terminal} Uploads the current configuration to a host or displays it on the terminal. P

1 P=Privileged; N=Normal

hometocprevnextglossaryfeedbacksearchhelp
Copyright 1989-1997 © Cisco Systems Inc.