-
Catalyst 4000 Family Command Reference, 6.1
-
Book-length PDF: Catalyst 4000 Family Command Reference, Release 6.1
-
Quick Links to Catalyst 4500 Series Switch Cisco CATOS Commands
-
Index
-
About This Publication
-
Command Line Interfaces
-
alias through copy
-
delete through session
-
set through set crypto key rsa
-
set enablepass through set logging history
-
set logging level through set qos
-
set qos defaultcos through set spantree portvlanpri
-
set spantree priority through set vtp pruning
-
show accounting through show crypto key
-
show default through show multicast group count
-
show multicast protocols status through show protocolfilter
-
show qos info through show time
-
show timezone through write terminal
-
Acronyms
-
Table Of Contents
2del
Use the del command to delete files.
del device:filename
Syntax Description
Defaults
This command has no default settings.
Command Types
ROM monitor command.
Command Modes
Normal.
Usage Guidelines
The Catalyst 4000 family, 2948G, and 2980G switches only support the bootflash: Flash device.
A file cannot be undeleted if a valid file with the same name exists. Instead, you must delete the existing one first and then undelete the desired file. A file can be deleted or undeleted up to 15 times. To permanently remove all deleted files on a device, use the squeeze command. You need to use the squeeze command to reclaim the space used by the deleted file.
Examples
This example shows how to delete a file:
rommon 1 > del bootflash:cat4000.6-1-1.binrommon 2 >Related Commands
undelete—ROM monitor
squeeze—ROM monitordelete
Use the delete command to delete a file on a Flash device.
delete [file-id]
Syntax Description
Defaults
This command has no default setting.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
The Catalyst 4000 family switches support only the bootflash: Flash device:
Use the undelete—switch command to recover a deleted file.
A file cannot be undeleted if a valid file with the same name exists. Instead, you must delete the existing one first and then undelete the desired file. A file can be deleted or undeleted up to 15 times. To permanently remove all deleted files on a device, use the squeeze—switch command.
Examples
This example shows how to delete a file from a Flash device:
Console> (enable) delete bootflash:switch_config.cfgConsole> (enable)Related Commands
dir—switch
undelete—switch
show flash
squeeze—switchdir—ROM monitor
Use the dir command to list the files on a Flash device.
dir device
Syntax Description
Defaults
This command has no defaults.
Command Types
ROM monitor command.
Command Modes
Normal.
Examples
This example shows how to list the files on a Flash device:
rommon 6 > dir bootflash:File size Checksum File name14086 bytes (0x3706) 0xa6a84c93 switch_config.cfg (deleted)5415 bytes (0x1527) 0x53bbccda 5509_config.cfg446464 bytes (0x6d000) 0x8503219d cat5000-sup3.5-1-1.bin (deleted)4231861 bytes (0x4092b5) 0x1d6092f4 cat5000-sup3.5-2-1.binrommon 7 >dir—switch
Use the dir command to display a list of files on a Flash device.
dir file-id [all | deleted | long]
Syntax Description
Defaults
This command has no default setting.
Command Types
Switch command.
Command Modes
Normal and privileged.
Usage Guidelines
When you omit all keywords (all, deleted, or long), the system displays file information in short format.
Table 2-2 explains the short format output.
Table 2-2 Short Format File Information
#
File index number
length
File length
date/time
Date and time the file was created
name
Filename
When you use one of the keywords, the system displays file information in long format.
Table 2-3 explains the long format output.
Examples
This example shows how to display the file information in short format:
Console> (enable) dir-#- -length- -----date/time------ name2 3761580 Jun 14 2000 14:16:05 cat4000.6-1-0-104-ORL.bin3 3773884 Jul 10 2000 09:06:25 cat4000.6-1-0-126-ORL.bin21040 bytes available (11382224 bytes used)Console> (enable)This example shows how to display the file information in long format:
Console> (enable) dir long-#- ED --type-- --crc--- -seek-- nlen -length- -----date/time------ name2 .. ffffffff d69fff2c 781794 25 3761580 Jun 14 2000 14:16:05 cat4000.6-1-0-104-ORL.bin3 .. ffffffff d3b83f6b b1add0 25 3773884 Jul 10 2000 09:06:25 cat4000.6-1-0-126-ORL.bin21040 bytes available (11382224 bytes used)Console> (enable)This example shows the file with index number 1 deleted:
Console> (enable) dir all-#- ED --type-- --crc--- -seek-- nlen -length- -----date/time------ name1 .D ffffffff 9be31a86 3eb168 28 3846376 Jun 14 2000 14:13:10 cat4000-k4.6-1-0-104-ORL.bin2 .. ffffffff d69fff2c 781794 25 3761580 Jun 14 2000 14:16:05 cat4000.6-1-0-104-ORL.bin3 .. ffffffff d3b83f6b b1add0 25 3773884 Jul 10 2000 09:06:25 cat4000.6-1-0-126-ORL.bin21040 bytes available (11382224 bytes used)Console> (enable)Related Commands
disable
Use the disable command to return to normal mode from privileged mode.
disable
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default setting.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to return to normal mode:
Console> (enable) disableConsole>Related Commands
disconnect
Use the disconnect command to close an active console port or Telnet session.
disconnect {ip_addr | console}
Syntax Description
ip_addr
Source IP address or IP alias of the session to disconnect; in dot notation, for example, 101.102.103.104.
console
Keyword that specifies to clear an active session on the console port.
Defaults
This command has no default setting.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
If multiple sessions from the same IP address exist, the system checks if the current session originated from the specified IP address. If the session did not originate from the specified IP address, all Telnet sessions from the address are disconnected. If the session does originate from the specified address, all sessions, other than the current session, are disconnected. The system prompts whether to disconnect the current Telnet session. You can answer n and remain connected or answer y and be disconnected.
Examples
This example shows how to close a Telnet session to host 192.168.255.255 (the 1 in parenthesis indicates the number of active sessions disconnected):
Console> (enable) disconnect 192.168.255.255Telnet session from 192.168.255.255 disconnected. (1)Console> (enable)This example shows how to close the current console session:
Console> (enable) disconnect consoleConsole session disconnected.Console> (enable)Related Commands
enable
Use the enable command to activate privileged mode. In privileged mode, additional commands are available, and certain commands display additional information.
enable
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default setting.
Command Types
Switch command.
Command Modes
Normal.
Usage Guidelines
The (enable) in the prompt indicates that privileged commands can be entered.
Examples
This example shows how to enter privileged mode:
Console> enableEnter password:Console> (enable)Related Commands
format
Use the format command to format a Flash device. Flash PC cards must be formatted before it can be used.
format [spare spare_num] [m/]device1: [[device2:][monlib_filename]]
Syntax Description
Defaults
The default number of spare sectors is 0.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
You can reserve up to 16 spare sectors for use when other sectors fail. If you do not reserve spare sectors and later some sectors on the device fail, you will have to reformat the entire Flash device, which will erase all existing data.
The monlib file is the ROM monitor library used by the ROM monitor to access files in the Flash file system. The file is also compiled into the system image. In the command syntax, device1: is the device to format and device2: contains the monlib file to use.
When you omit the [device2:][monlib_filename]] argument, the system formats device1: using the monlib that is bundled with the system software.
When you omit device2: from the [[device2:][monlib_filename]] argument, the system formats device1: using the named monlib file from the default Flash device (specified by the cd command).
When you omit monlib_filename from the [[device2:][monlib_filename]] argument, the system formats device1: using the monlib file from device2:. When you specify the whole [[device2:][monlib_filename]] argument, the system formats device1: using the specified monlib file from the specified device.
You can also specify device1:monlib_filename as the device and filename to be used, as follows:
format device1: [device1: [monlib_filename]]
If monlib_filename is omitted, the system formats device1: using the built-in monlib file on the device.
Note
When the system cannot find a monlib file, the system terminates the formatting process.
Examples
This example shows how to format a Flash device (Flash PC card in slot1):
Console> (enable) format slot1:All sectors will be erased, proceed (y/n) [n]?yEnter volume id (up to 31 characters):Formatting sector 1Format device slot1 completed.Console> (enable)help—ROM monitor
Use the help command to display a listing of commands you can use to set switch features.
help
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
ROM monitor command.
Command Modes
Normal.
Examples
This example shows how to display the commands list:
rommon 1 > helpalias set and display aliases commanddir list files in file systemdel delete a fileundelete undelete a filesqueeze remove deleted fileshistory monitor command historyrepeat repeat a monitor commandboot boot an image from flash/networkclear clear configurations, use 'clear help' for more infohelp print list of available commandsping ping an ip addrreset restart the systemset show/set environment vars, use 'set help' for more infoshow show config parameters, use 'show help' for more infosprom display sprom contentsversion display version inforommon 2 >history—ROM monitor
Use the history command to display the command history (the last 16 commands executed in the ROM monitor environment).
history
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no defaults.
Command Types
ROM monitor command.
Command Modes
Normal.
Usage Guidelines
This command is aliased to h by the ROM monitor for convenience.
Examples
This example shows how to use the history command:
rommon 13 > history1 help2 break -s 0x200903 break -s 100904 break -s 0xa00010005 cont6 help7 dev8 dir9 dir bootflash:10 dis11 dis 0xa000100012 dis 0xbe00000013 history=============================================================================history—switch
Use the history command to show the contents of the command history buffer.
history
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default setting.
Command Types
Switch command.
Command Modes
Normal.
Usage Guidelines
The history buffer size is fixed at 20 commands. Refer to the "Command-Line Interfaces" chapter for detailed information about the command history feature.
Examples
This example shows how to display the command history and execute the second entry in the command history buffer:
Console> history1 help2 historyConsole> !2history1 help2 history3 historyConsole>meminfo
Use the meminfo command to display information about the main memory, packet memory, and NVRAM.
meminfo [-l]
Syntax Description
-l
(Optional) Keyword to specify the long listing, which displays the supported DRAM configurations.
Defaults
This command has no default setting.
Command Types
ROM monitor command.
Command Modes
Normal.
Usage Guidelines
The minus sign (-) is required with the -l option.
Examples
This example shows how to use the meminfo command:
rommon 9 > meminfoMain memory size: 16 MB in 32 bit mode.Available main memory starts at 0xa000e000, size 16328KBIO (packet) memory size: 25 percent of main memory.NVRAM size: 32KBping—ROM monitor
Use the ping command to send ICMP echo-request packets to another node on the network.
ping host
Syntax Description
Defaults
This command has no default settings.
Command Types
ROM monitor command.
Command Modes
Normal.
Usage Guidelines
You must enter the IP address of the node because ROM monitor does not support DNS name resolution.
Examples
This example shows how to ping 10.1.1.1:
rommon 1 > ping 10.1.1.110.1.1.1 is aliverommon 2 >ping—switch
Use the ping command set to send ICMP echo-request packets to another node on the network. You can also use the ping command without arguments to configure ping.
ping -s host
ping -s host [packet_size] [packet_count]
Syntax Description
Defaults
The defaults for ping -s are:
•
•
The defaults for ping with no arguments are:
•
•
•
•
•
Command Types
Switch command.
Command Modes
Normal. Privileged to configure ping.
Usage Guidelines
The following guidelines are general ping command guidelines:
•
•
•
•
The following guidelines are for the ping -s command:
•
•
•
•
•
•
The following guidelines are for the ping command without arguments:
•
•
•
•
•
•
•
–
–
–
–
–
This example shows how to ping a host with IP alias elvis a single time:
Console> ping elvis!!!!!-----172.20.52.19 PING Statistics------5 packets transmitted, 5 packets received, 0% packet lossround-trip (ms) min/avg/max = 1/1/1Console>This example shows how to ping a host with the IP alias elvis once per second until you press Ctrl-C to stop pinging:
Console> ping -s elvisping elvis: 56 data bytes64 bytes from elvis: icmp_seq=0. time=11 ms64 bytes from elvis: icmp_seq=1. time=8 ms64 bytes from elvis: icmp_seq=2. time=8 ms64 bytes from elvis: icmp_seq=3. time=7 ms64 bytes from elvis: icmp_seq=4. time=11 ms64 bytes from elvis: icmp_seq=5. time=7 ms64 bytes from elvis: icmp_seq=6. time=7 ms^C----elvis PING Statistics----7 packets transmitted, 7 packets received, 0% packet lossround-trip (ms) min/avg/max = 7/8/11Console>This example shows how to configure ping:
Console> (enable) pingTarget IP Address []: 172.20.52.19Number of Packets [5]: 6Datagram Size [56]: 75Timeout in seconds [2]: 1Source IP Address [172.20.52.18]:!!!!!!----172.20.52.19 PING Statistics----6 packets transmitted, 6 packets received, 0% packet lossround-trip (ms) min/avg/max = 1/1/1Console> (enable)Related Commands
set interface
set ip route—switch
show interface—switch
show ip route—switchpwd
Use the pwd command to show the current default Flash device.
pwd [mod]
Syntax Description
mod
(Optional) Module number of the supervisor engine for which to display the current default Flash device.
Defaults
If no module number is specified, pwd defaults to the active supervisor engine.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to use the pwd command to display the current default Flash device:
Console> pwdbootflashConsole> cdDefault flash device set to slot0.Console> pwdslot0quit
Use the quit command to exit a CLI session.
quit
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default setting.
Command Types
Switch command.
Command Modes
Normal.
Usage Guidelines
The exit and logout commands perform the same function as the quit command.
Examples
This example shows how to quit a CLI session:
Console> quitConnection closed by foreign host.host%reconfirm vmps
Use the reconfirm vmps command to reconfirm the current dynamic port VLAN membership assignments with the VMPS server.
reconfirm vmps
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default setting.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
VMPS database changes are not conveyed automatically to switches participating in VMPS. Therefore, after making a VMPS database change, use this command on VMPS clients and servers to apply the database changes.
Examples
This example shows how to reconfirm the current dynamic port VLAN membership with VMPS:
Console (enable) reconfirm vmpsreconfirm process startedUse 'show dvlan statistics' to see reconfirm statusConsole (enable)Related Commands
repeat
Use the repeat ROM monitor command to repeat a command.
repeat [num | string]
Syntax Description
num
(Optional) Number of the command (from the command history buffer list).
string
(Optional) String that uniquely matches a command in the command history buffer list.
Defaults
If no argument is specified, the last command is repeated.
Command Types
ROM monitor command.
Command Modes
Normal.
Usage Guidelines
The optional num and string arguments specify which command in the command history buffer to repeat.
If you specify a string to match, the most recent command in the buffer to begin with the specified string is executed again.
If the string contains white space, you must use quotation marks.
This command is aliased to r by the ROM monitor for convenience.
Examples
These examples show how to use the repeat command. You use the history command to display the list of previously entered commands:
rommon 22 > history8 dir9 dir bootflash:10 dis11 dis 0xa000100012 dis 0xbe00000013 history14 meminfo15 meminfo -l16 meminfo17 meminfo -l18 meminfo19 meminfo20 meminfo -l21 meminfo -l22 historyrommon 23 > repeat dirdir bootflash:File size Checksum File name1973032 bytes (0x1e1b28) 0xdadf5e24 lluerommon 24 > repeatdir bootflash:File size Checksum File name1973032 bytes (0x1e1b28) 0xdadf5e24 lluerommon 25 > repeat 15meminfo -lMain memory size: 16 MB.Packet memory size: 0 MBMain memory size: 0x1000000Available main memory starts at 0xa000e000, size 0xff2000NVRAM size: 0x20000Parity Map for the DRAM BanksSocket 0 in Bank 0 Has No ParitySocket 1 in Bank 0 Has No ParitySocket 0 in Bank 1 Has No ParitySocket 1 in Bank 1 Has No Parity==========================================================================reset—ROM monitor
Use the reset ROM monitor command to perform a soft reset of the switch.
reset {mod_num | system}
Syntax Description
Defaults
This command has no default setting.
Command Types
ROM monitor command.
Command Modes
Normal.
Examples
This example shows how to use the reset command:
rommon 26 > resetSystem Bootstrap, Version 3.1(1.69)Copyright (c) 1994-1997 by cisco Systems, Inc.Supervisor III processor with 16384 Kbytes of main memoryrommon 1 >===========================================================================reset—switch
Use the reset command to restart the system or an individual module and to schedule a system reset.
reset [mod_num | system | mindown]
reset [mindown] at {hh:mm} [mm/dd] [reason]
reset [mindown] in [hh:] {mm} [reason]
reset cancel
Syntax Description
Defaults
This command has no default setting.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
If you do not specify a module number (either a switching module or the active supervisor engine module), the command resets the entire system.
You can use the reset mod_num command to switch to the standby supervisor engine, where mod_num is the module number of the active supervisor.
In software release 5.2 and later, you can use the reset mindown command to reset the switch as part of a minimal downtime software upgrade in a system with redundant supervisor engine modules. For complete information on performing a minimal downtime software upgrade, refer to the Software Configuration Guide-Catalyst 4000 Family, 2948G, and 2980G Switches.
Caution
Examples
This example shows how to reset module 4:
Console> (enable) reset 4This command will reset module 4 and may disconnect your telnet session.Do you want to continue (y/n) [n]? yResetting module 4...Console> (enable)This example shows how to schedule a reset for a specific future time and include a reason for the reset:
cat> (enable) reset at 23:00 8/18 Software upgrade to 5.3(1).Reset scheduled at 23:00:00, Wed Aug 18 2000.Reset reason: Software upgrade to 5.3(1).Proceed with scheduled reset? (y/n) [n]? yReset scheduled for 23:00:00, Wed Aug 18 2000 (in 0 day 8 hours 39 minutes).cat> (enable)This example shows how to schedule a reset with minimum down time.
cat> (enable) reset mindown at 23:00 8/18 Software upgrade to 5.3(1).Reset scheduled at 23:00:00, Wed Aug 18 2000.Reset reason: Software upgrade to 5.3(1).Proceed with scheduled reset? (y/n) [n]? yReset mindown scheduled for 23:00:00, Wed Aug 18 2000 (in 0 day 8 hours 39 minutes).cat> (enable)This example shows how to schedule a reset after a specified time:
cat> (enable) reset in 5:20 Configuration updateReset scheduled in 5 hours 20 minutes.Reset reason: Configuration updateProceed with scheduled reset? (y/n) [n]? yReset scheduled for 19:56:01, Wed Aug 18 2000 (in 5 hours 20 minutes).Reset reason: Configuration updatecat> (enable)This example shows how to cancel a scheduled reset:
cat> (enable) reset cancelCancel reset scheduled for 19:56:01, Wed Aug 18 2000 (in 5 hours 20 minutes).cat> (enable)session
Use the session command to access the CLI of an intelligent module such as a Catalyst 5000 family RSM, RSFC, or ATM module.
session mod
Syntax Description
Defaults
This command has no default setting.
Command Types
Switch command.
Command Modes
Normal.
Usage Guidelines
After you enter this command, the system responds with the Enter Password: prompt, if a password is configured on the module.
To end the session with the intelligent module, enter the quit command.
Examples
This example shows how to open a session with an ATM module (module 4):
Console> session 4Trying ATM-4...Connected to ATM-4.Escape character is `^]'.ATM>
