Table Of Contents

show time

show timezone

show top

show top report

show trace

show traffic

show trunk

show udld

show users

show version—switch

show vlan

show vmps

show vmps mac

show vmps statistics

show vmps vlan

show vmps vlanports

show vtp domain

show vtp statistics

slip

sprom read

squeeze—ROM monitor

squeeze—switch

sync

telnet

test snmp trap

traceroute

unalias

undelete—ROM monitor

undelete—switch

unset=varname

upload

varname=

verify

version

wait

whichboot

write

write tech-support

write terminal

show time

To display the current time of day setting for the system clock, use the show time command.

show time

Syntax Description

This command has no keywords or arguments.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Normal

Examples

This example shows how to display the current time:

Console> show time

Thu Apr 15 1999, 02:54:50

Console> 

The output shows the day of the week, month, day, year, hour, minutes, and seconds.

Related Commands

set time

show timezone

To display the current time zone and any offset that has been configured, use the show timezone command.

show timezone

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Normal

Examples

This example shows how to display the current time zone and offset:

Console> show timezone

Timezone set to 'pst', offset from UTC is -8 hours

Console> 

Related Commands

clear timezone
set timezone

show top

To start the TopN process, use the show top command.

show top [N] [metric] [interval interval] [port_type] [background]

Syntax Description

N	(Optional) Number of ports displayed; valid values are from 1 to a maximum number of physical ports.
metric	(Optional) Port statistic to sort on; valid values are as follows: util—utilization bytes—in/out bytes pkts—in/out packets bcst—in/out broadcast packets mcst—in/out multicast packets errors—in errors overflow—buffer overflow
interval	(Optional) Duration of sample (in seconds).
interval	(Optional) Number of seconds for sample. Valid values include 0, 10...999 seconds. If the value is 0, the N topmost ports by absolute counter values are displayed.
port_type	(Optional) Type of switch ports to use for report. Valid values are as follows: all—all port types are used eth—All Ethernet port types are used 10e—10 Mbps Ethernet ports types are used fe—Fast Ethernet port types are used ge—Gigabit Ethernet port types are used
background	(Optional) TopN report not to print to the screen when the task is done. Instead, send a notification out when the reports are ready.

Defaults

The default settings are as follows:

•Number of ports displayed is 20

•Port statistics to report on is util

•Sample duration is 30 seconds

•Switch port types is all

Command Types

Switch command

Command Modes

Normal

Usage Guidelines

You can terminate TopN processes with the background option specified only by using the clear top [report_num] command. You cannot terminate TopN processes by pressing Ctrl-C.

TopN reports with the background option specified are not displayed on the screen unless you enter a show top report [report_num] command.

If you do not specify the background option, the output TopN results are dumped to the screen when the task is done, and the results are printed one time only and are not saved.

You can terminate TopN processes (without the background option) by pressing Ctrl-C in the same Telnet or console session, or by entering a clear top [report_num] command from a separate Telnet or console session. The prompt is not printed before the TopN report is displayed completely. Other commands are blocked until the report has displayed.

Examples

This example shows how to start the TopN process with the background option:

Console> show top 10 util interval 10 background

03/21/1999,14:05:38:MGMT-5: TopN report 2 started by telnet/172.20.22.7/.

Console> 

03/21/1999,14:15:38:MGMT-5: TopN report 2 available.

This example shows how to start the TopN process without the background option:

Console> show top 10 util interval 10 

Start Time:     04/09/1999,01:12:48

End Time:       04/09/1999,01:12:58

PortType:       all

Metric:         util

Port  Band- Uti Bytes                Pkts       Bcst       Mcst       Error Over

      width  %  (Tx + Rx)            (Tx + Rx)  (Tx + Rx)  (Tx + Rx)  (Rx)  flow

----- ----- --- -------------------- ---------- ---------- ---------- ----- ----

3/1    100   0                13824          9          0          0    11    0

6/48    10   0                    0          0          0          0     0    0

6/47    10   0                    0          0          0          0     0    0

6/46    10   0                    0          0          0          0     0    0

6/45    10   0                    0          0          0          0     0    0

Console>

Related Commands

clear top
show top

show top report

To list all TopN processes and specific TopN reports, use the show top report command.

show top report [report_num]

Syntax Description

report_num

(Optional) TopN report number for each process.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Normal

Usage Guidelines

If you do not specify report_num, this command lists all the active TopN processes and all the available TopN reports for the switch. Each process is associated with a unique report number. All TopN processes (both with and without background option) are shown in the list.

An asterisk displayed after the pending status field indicates that it is not a background TopN and the results are not saved.

Examples

This example shows how to display all the active TopN processes and all the available TopN reports for the switch:

Console> show top report

Rpt  Start time          Int N   Metric      Status   Owner (type/machine/user)

---  ------------------- --- --- ----------  -------- -------------------------

  1  03/21/1999,11:34:00 60  20  Tx/Rx-Bytes done     telnet/172.20.22.7/

  2  03/21/1999,11:34:08 600 10  Util        done     telnet/172.34.39.6/

  4  03/21/1999,11:35:17 300 20  In-Errors   pending  Console//

  5  03/21/1999,11:34:26 60  20  In-Errors   pending* Console//

Console> 

This example shows an attempt to display a TopN report 5 (shown in the first example) that is still in pending status:

Console> show top report 5

Rpt  Start time          Int N   Metric     Status   Owner (type/machine/user)

---  ------------------- --- --- ---------- -------- -------------------------

  5  03/21/1999,11:34:26 60  20  In-Errors   pending* Console//

Console> 

This example shows how to display the available TopN report 2 (shown in the first example) for the switch:

Console> show top report 2

Start Time:     03/21/1999,11:34:00

End Time:       03/21/1999,11:34:33

PortType:       all

Metric:         util

Port  Band- Uti Tx/Rx-bytes          Tx/Rx-pkts Tx/Rx-bcst Tx/Rx-mcst In-  Buf-

      width  %                                                        err  Ovflw

----- ----- --- -------------------- ---------- ---------- ---------- ---- -----

 /15  100   88  98765432109876543210 9876543210 98765      12345      123  321    

 5/48 10    75  44532                5389       87         2          0    0    

 5/47 10    67  5432                 398        87         2          0    0    

 5/46 10    56  1432                 398        87         2          0    0    

 5/45 10    54  432                  398        87         2          0    0    

 5/44 10    48  3210                 65         10         10         15   5    

 5/43 10    45  432                  5398       87         2          2    0    

 5/42 10    37  5432                 398        87         2          0    0    

 5/41 10    36  1432                 398        87         2          0    0    

 5/40 10    14  2732                 398        87         2          0    0    

Console> 

Related Commands

clear top
show top

show trace

To display the trace category and level, use the show trace command.

show trace [all]

Syntax Description

all	(Optional) Displays all trace category and level information.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Normal

Examples

This example shows how to display only the active trace category and level information:

Console> show trace

Trace monitor is enabled for this session.

Trace Category  Level

--------------  -----

HTTP             3

SYNFIG           5

Console> 

This example shows how to display all trace category and level information:

Console> show trace all

Trace monitor is enabled for this session.

Trace Category  Level

--------------  -----

ACCT            off

ACL             off

BDD             off

CDP             off

CONFIG          off

COPS            off

DHCP            off

DIAG            off

DNS             off

DRIP            off

DTP             off

DUPFLASH        off

DUPNVRAM        off

DYNVLAN         off

EARL            off

ENVMON          off

EOBC            off

EPLD            off

ESSR            off

EVMGR           off

FCP             off

FDDI            off

FDDI            off

FILESYS         off

HAMGR           off

HTTP            off

GARP            off

GVRP            off

INBAND          off

IPC             off

KERBEROS        off

L3AGE           off

L3SUP           off

LANE            off

LD              off

LLC             off

LTL             off

MBUF            off

MCAST           off

MDG             off

MEMDBG          off

MLS             off

MLSM            off

MODPORT         off

NTP             off

NVSYNC          off

OOB             off

PAGP            off

PROTFILT        off

PPWR            off

PRUNING         off

PRIVATEVLAN     off

QOS             off

RADIUS          off

REDUN           off

RSFC            off

RSVP            off

RUNTIMECFG      off

SCP             off

SECURITY        off

SLP             off

SNMP            off

SPAN            off

STP             off

SYNCMGR         off

SYNFIG          off

SYSLOG            1

TACACS          off

TEST            off

TFTP            off

TFTPD           off

UDLD            off

VERB            off

VMPS              1

VTP             off

Console> 

Related Commands

set trace

show traffic

To display Traffic and Peak information for each switching bus, use the show traffic command.

show traffic

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Normal

Examples

This example shows how to display Traffic and Peak information for each switching bus:

Console> show traffic

Switching-Bus Traffic Peak Peak-Time

------------- ------- ---- -------------------------

A               5%     10% Thu Mar 18 1999, 22:45:20

B               4%     15% Fri Mar 19 1999, 09:59:31

C               6%     8% Fri Mar 19 1999, 11:30:13

Console> 

Related Commands

show system

show trunk

To display trunking information for the switch, use the show trunk command.

show trunk [mod[/port]] [detail]

Syntax Description

mod/port	(Optional) Number of the module and the port on the module.
detail	(Optional) Displays detailed information about the specified trunk port.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Normal

Usage Guidelines

Using the show trunk command without a module or port number displays the actively trunking ports.

To display the trunking configuration for a port that is not actively trunking, specify the module and port number of the port you want to display.

Examples

This example shows how to display trunking information for the switch:

Console> (enable) show trunk

* - indicates vtp domain mismatch

Port      Mode         Encapsulation  Status        Native vlan

--------  -----------  -------------  ------------  -----------

 2/1      auto         dot1q          trunking      1

 4/9      auto         isl            trunking      1

 4/10     desirable    isl            trunking      1

Port      Vlans allowed on trunk

--------  ---------------------------------------------------------------------

 2/1      1-1005

 4/9      1-1005

 4/10     1-1005

Port      Vlans allowed and active in management domain 

--------  ---------------------------------------------------------------------

 2/1      1-5,10,50,152,500,521-524,570

 4/9      1,4-5,1003,1005

 4/10     1,4-5,1003,1005

Port      Vlans in spanning tree forwarding state and not pruned

--------  ---------------------------------------------------------------------

 2/1      1-5,10,50,152,500,521-524,570

 4/9      1005

 4/10     1005

Console> (enable)

This example shows how to display trunking information for a specific port:

Console> (enable) show trunk 4/5

* - indicates vtp domain mismatch

Port      Mode         Encapsulation  Status        Native vlan

--------  -----------  -------------  ------------  -----------

 4/5      nonegotiate  dot1q          trunking      1

Port      Vlans allowed on trunk

--------  ---------------------------------------------------------------------

 4/5      1-1005

Port      Vlans allowed and active in management domain 

--------  ---------------------------------------------------------------------

 4/5      1-3,1003,1005

Port      Vlans in spanning tree forwarding state and not pruned

--------  ---------------------------------------------------------------------

 4/5      1005

Console> (enable) 

Table 2-67 describes the fields in the show trunk command output.

Table 2-67 show trunk Command Output Fields

Field	Description
Port	Module and port numbers.
Mode	Trunk administrative status of the port (on, off, auto, or desirable).
Encapsulation	Trunking type configured by administration.
Status	Status of whether the port is trunking or nontrunking.
Native VLAN	Number of the native VLAN for the trunk link (for 802.1Q trunks, the VLAN for which untagged traffic can be transmitted and received over the trunk; for ISL trunks, packets are tagged on all VLANs, including the native VLAN).
Vlans allowed on trunk	Range of VLANs allowed to go on the trunk (default is 1 to 1000).
Vlans allowed and active in management domain	Range of active VLANs within the allowed range.
Vlans in spanning tree forwarding state and not pruned	Range of VLANs that actually go on the trunk with Spanning Tree Protocol forwarding state.

Related Commands

set trunk

show udld

To display Unidirectional Link Detection Protocol (UDLD) information, use the show udld
command set.

show udld

show udld port [mod[/port]]

Syntax Description

port	Module or the port.
mod/port	(Optional) Number of the module and the port on the module.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Normal

Examples

This example shows how to find out whether UDLD is enabled or disabled:

Console> show udld

UDLD      : enabled 

Console> 

This example shows how to display UDLD information for module 2 port 1:

Console> show udld port 2/1

UDLD      :enabled

Port      Admin Status  Link State

--------  ------------  ----------------

 2/1      enabled       undetermined

Console> 

This example shows how to display UDLD information for all ports on module 3:

Console> (enable) show udld port 3

UDLD      : enabled

Port      Admin Status  Link State

--------  ------------  ----------------

 3/1      enabled       undetermined

 3/2      enabled       undetermined

 3/3      enabled       undetermined

 3/4      enabled       undetermined

 3/5      enabled       undetermined

 3/6      disabled      not applicable

 3/7      disabled      not applicable

 3/8      disabled      not applicable

Table 2-68 describes the fields in the show udld command output.

Table 2-68 show udld Command Output Fields

Field	Description
UDLD	Status of whether UDLD is globally enabled or disabled
Port	Module and port numbers
Admin Status	Status of whether UDLD is enabled or disabled on a per-port basis
Link State	Status of the link: undetermined (detection in progress, UDLD has been disabled on the neighbors), not applicable (UDLD is not supported on the port, UDLD has been disabled on the port, or the port is disabled), shutdown (unidirectional link has been detected and the port disabled), bidirectional (bidirectional link has been detected)

Related Commands

set udld

show users

To determine if the console port is active and to list all active Telnet sessions with the IP address or IP alias of the originating host, use the show users command.

show users [noalias]

Syntax Description

noalias

(Optional) Displays of IP addresses, not IP aliases.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Normal

Examples

This example shows how to display the users of the active Telnet and shell sessions:

Console> show users 

Session          User              Location

-------------    ---------------   ------------------------------

console                            

ssh                                172.16.10.75

telnet                             171.31.1.203

Console> 

Related Commands

disconnect

show version—switch

To display software and hardware version information for switching and supervisor engine modules only, use the show version command.

show version [mod]

Syntax Description

mod	(Optional) Number of the module.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Normal

Examples

This example shows how to display the software and hardware versions:

Console> show version

WS-C4403 Software, Version NmpSW: 6.1(0.24)FTL

Copyright (c) 1995-1999 by Cisco Systems

NMP S/W compiled on Aug 31 1999, 12:59:28

System Bootstrap Version: 5.2(1)

System Web Interface Version: 5.0(0.25)

Hardware Version: 1.0 Model: WS-C4403 Serial #: SCA032100T8

Mod Port Model               Serial #    Versions

--- ---- ------------------- ----------- --------------------------------------

1   2    WS-X5K-SUP1-2GE     SAD03232101 Hw : 4.0

                                         Fw : 5.2(1)

                                         Fw1: 4.2(0.24)VAI78

                                         Sw : 5.3(0.74)MIA7-Eng

                                         Sw1: 5.3(0.74)MIA7

3   48   WS-X5223-RJ-45      SAD03257164 Hw : 1.1

                                         Fw : 4.2(0.24)VAI78

                                         Sw : 5.3(0.74)MIA7

5   48   WS-X5223-RJ-45      SAD03257171 Hw : 1.1

                                         Fw : 4.2(0.24)VAI78

                                         Sw : 5.3(0.74)MIA7

       DRAM                    FLASH                   NVRAM

Module Total   Used    Free    Total   Used    Free    Total Used  Free

------ ------- ------- ------- ------- ------- ------- ----- ----- -----

1       65408K  24747K  40661K  16384K  14543K   1841K 512K 203K 309K

Uptime is 2 days, 0 hour, 41 minutes

Console> (enable) 

This example show how to display version information for a specific module:

Console> (enable) show version 2

Mod Port Model               Serial #    Versions

--- ---- ------------------- ----------- --------------------------------------

2   1    WS-X4003-           JAB0343055Y Hw : 0.201

                                         Fw : 4.2(0.24)DAY68

                                         Sw : 6.1(0.24)FTL

Console> (enable) 

Table 2-69 describes the fields in the show version command output.

Table 2-69 show version Command Output Fields 

Field	Description
McpSW	Version number of the MCP software.
NmpSW	Version number of the NMP software.
NMP S/W compiled on	Date and time that the NMP software was compiled.
MCP S/W compiled on1	Date and time that the MCP software was compiled.
System Bootstrap Version	System bootstrap version number.
Web Interface Version	Web interface version number.
Hardware Version	Hardware version number.
Model	Switch model number.
Serial #	Switch serial number.
Module	Module number.
Ports	Number of ports on the module.
Model	Model number of the module.
Serial #	Serial number of the module.
Hw	Hardware version of the module.
Fw	Version of the firmware installed on the module. If this is a supervisor engine module, the Fw version number is the NMP boot ROM version level.
Fw1	Version of the second firmware image on the module, if present. If this is a supervisor engine module, the Fw1 version number is the MCP boot ROM version level.
Sw	Version of the software installed on the module.
Gsp1	Version of the gigabit switching platform.
Nmp1	Version of the supervisor engine software.
Module	Module number.
DRAM Total	Total dynamic RAM installed on the module.
Used	Amount of DRAM in use.
Free	Amount of available DRAM.
FLASH Total	Total Flash memory installed on the module.
Used	Amount of Flash memory in use.
Free	Amount of available Flash memory.
NVRAM Total	Total NVRAM installed on the module.
Used	Amount of NVRAM in use.
Free	Amount of available NVRAM.
Used	Amount of NVRAM in use.
Available	Amount of NVRAM available.
Uptime is	Number of uninterrupted days, hours, minutes, and seconds the system has been up and running.

1 This field is not supported on the Catalyst 4000 family and 2948G switches.

show vlan

To display VLAN information, such as status, MTU setting, and SAID, use the show vlan command.

show vlan [trunk]

show vlan vlans [notrunk]

show vlan mapping

show vlan type

Syntax Description

trunk	(Optional) Displays information only for trunk ports.
vlans	Number or range of VLANs; valid values are from 1 to 1000 and from 1025 to 4094.
notrunk	(Optional) Displays information only for nontrunk ports.
mapping	Displays the contents of the mapping table.
type	Type of the VLAN; valid values are ethernet, fddi, fddinet, trbrf, or trcrf.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Normal

Usage Guidelines

Each Ethernet switch port and Ethernet repeater group belong to only one VLAN. Trunk ports can be on multiple VLANs.

If you do not specify the VLAN number, all VLANs are displayed.

Examples

This example shows how to display information for all VLAN trunks:

Console> show vlan trunk 

VLAN Name                             Status    IfIndex Mod/Ports, Vlans

---- -------------------------------- --------- ------- ------------------------

1    default                          active    5       2/1-2

                                                        6/4-8

10   VLAN0010                         active    18      6/1,6/3

11   VLAN0011                         active    19      6/2

20   VLAN0020                         active    20      

21   VLAN0021                         active    21      

30   VLAN0030                         active    22      

31   VLAN0031                         active    23      

1002 fddi-default                     active    6       

1003 token-ring-default               active    9       

1004 fddinet-default                  active    7       

1005 trnet-default                    active    8       8       

VLAN Type  SAID       MTU   Parent RingNo BrdgNo Stp  BrdgMode Trans1 Trans2

---- ----- ---------- ----- ------ ------ ------ ---- -------- ------ ------

1    enet  100001     1500  -      -      -      -    -        0      0

10   enet  100010     1500  -      -      -      -    -        0      0

11   enet  100011     1500  -      -      -      -    -        0      0

20   enet  100020     1500  -      -      -      -    -        0      0

21   enet  100021     1500  -      -      -      -    -        0      0

30   enet  100030     1500  -      -      -      -    -        0      0

31   enet  100031     1500  -      -      -      -    -        0      0

1002 fddi  101002     1500  -      -      -      -    -        0      0

1003 trcrf 101003     1500  0      0x0    -      -    -        0      0

1004 fdnet 101004     1500  -      -      0x0    ieee -        0      0

1005 trbrf 101005     1500  -      -      0x0    ibm  -        0      0

VLAN Inst DynCreated  RSPAN

---- ---- ---------- --------

1    1    static     disabled

10        static     disabled

11        static     disabled

20        static     disabled

21        static     disabled

30        static     disabled

31        static     disabled

1002 -    static     disabled

1003 1    static     disabled

1004 2    static     disabled

1005 -    static     disabled

VLAN AREHops STEHops Backup CRF 1q VLAN

---- ------- ------- ---------- -------

1003 7       7       off        

Primary Secondary Secondary-Type Ports

------- --------- -------------- ------------

10      20        isolated       6/1,6/3

11      21        isolated       6/2

30      -         -              

-       31        isolated       

Console> 

This example shows how to display the VLAN mapping table information:

Console> show vlan mapping

802.1q vlan     ISL vlan        Effective

------------------------------------------

3000            300             true

Console> 

This example shows how to display information for a specific VLAN and type:

Console> show vlan 2 fddi

VLAN Name                             Status    IfIndex Mod/Ports, Vlans

---- -------------------------------- --------- ------- ------------------------

1002 fddi-default                     active    6

VLAN Type  SAID       MTU   Parent RingNo BrdgNo Stp  BrdgMode Trans1 Trans2

---- ----- ---------- ----- ------ ------ ------ ---- -------- ------ ------

2    fddi  101002     1500  -      -      -      -    -        0      0        

VLAN Inst DynCreated  RSPAN

---- ---- ---------- --------

2    -    static     disabled

Console>

This example shows how to display information for nontrunk ports only on a specific VLAN:

Console> (enable) show vlan 2 notrunk

VLAN Name                             Status    IfIndex Mod/Ports, Vlans

---- -------------------------------- --------- ------- ------------------------

2    VLAN0002                         active    60      

VLAN Type  SAID       MTU   Parent RingNo BrdgNo Stp  BrdgMode Trans1 Trans2

---- ----- ---------- ----- ------ ------ ------ ---- -------- ------ ------

2    enet  100002     1500  -      -      -      -    -        0      0

VLAN Inst DynCreated  RSPAN

---- ---- ---------- --------

2    -    static     disabled

VLAN AREHops STEHops Backup CRF 1q VLAN

---- ------- ------- ---------- -------

Console>

This example shows how to display extended-range VLANs:

Console> (enable) show vlan 4000

VLAN Name                             Status    IfIndex Mod/Ports, Vlans

---- -------------------------------- --------- ------- ------------------------

Unable to access VTP Vlan 4000 information.

VLAN Type  SAID       MTU   Parent RingNo BrdgNo Stp  BrdgMode Trans1 Trans2

---- ----- ---------- ----- ------ ------ ------ ---- -------- ------ ------

Unable to access VTP Vlan 4000 information.

VLAN Inst DynCreated  RSPAN

---- ---- ---------- --------

Unable to access VTP Vlan 4000 information.

VLAN AREHops STEHops Backup CRF 1q VLAN

---- ------- ------- ---------- -------

Console> (enable)

Table 2-70 describes the fields in the show vlan command output.

Table 2-70 show vlan Command Output Fields 

Field	Description
VLAN	VLAN number.
Name	Name, if configured, of the VLAN.
Status	Status of the VLAN (active or suspend).
IfIndex	Number of the ifIndex.
Mod/Ports, VLANs	Ports that belong to the VLAN.
Type	Media type of the VLAN.
SAID	Security association ID value for the VLAN.
MTU	Maximum transmission unit size for the VLAN.
Parent	Parent VLAN, if one exists.
RingNo	Ring number for the VLAN, if applicable.
BrdgNo	Bridge number for the VLAN, if applicable.
Stp	Spanning Tree Protocol type used on the VLAN.
BrdgMode	Bridging mode for this VLAN. Possible values are SRB and SRT; the default is SRB.
Inst	Instance number.
DynCreated	Status of whether the VLAN is created statically or dynamically.
RSPAN	Status of whether RSPAN is enabled or disabled.
AREHops	Maximum number of hops for All-Routes Explorer frames. Possible values are 1 through 13; the default is 7.
STEHops	Maximum number of hops for Spanning Tree Explorer frames. Possible values are 1 through 13; the default is 7.
Backup CRF	Status of whether the TrCRF is a backup path for traffic.
802.1Q Vlan	Number of the 802.1Q VLAN.
ISL Vlan	Number of the ISL VLAN.
Effective	Status of the VLAN. If the VLAN is active and its type is Ethernet, true is displayed; if not, false is displayed.
Primary	Number of the primary VLAN in a private VLAN.
Secondary	Number of the secondary VLAN in a private VLAN.
Secondary-Type	Type of secondary VLAN port. Possible values are isolated, community, or -.
Ports	Number of the module and ports associated to a specific private VLAN pair.

Related Commands

set trunk
set vlan
show trunk

show vmps

To display VLAN Membership Policy Server (VMPS) configuration information, use the show vmps command.

show vmps [noalias]

Syntax Description

noalias

(Optional) Forces the display to show IP addresses, not IP aliases.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Normal

Examples

This example shows how to display VMPS configuration information:

Console> show vmps

VMPS Server Status:

-------------------

Management Domain:    (null)

State:                disabled

Operational Status:   inactive

TFTP Server:          default

TFTP File:            vmps-config-database.1

Fallback VLAN:        (null)

Secure Mode:          open

VMPS No Domain Req:   allow

VMPS Client Status:

---------------------

VMPS VQP Version:     1

Reconfirm Interval:   60 min

Server Retry Count:   3

VMPS domain server:

No dynamic ports configured.

Console>

Table 2-71 describes the fields in the show vmps command output.

Table 2-71 show vmps Command Output Fields

Field	Description
VMPS Server Status	Status of VMPS server.
Management Domain	Management domain supported by this server.
State	Indicates whether VMPS is enabled or disabled.
Operational Status	VMPS status (active, inactive, or downloading).
TFTP Server	IP address of the VMPS server.
TFTP File	VMPS configuration filename.
Fallback VLAN	VLAN assigned if a VLAN is not assigned to a MAC address in the database.
Secure Mode	Secure mode status (open or secure).
VMPS No Domain Req	Indicates whether the server accepts requests from clients with no domain name.
VMPS Client Status	Status of the VMPS client.
VMPS VQP Version	Version of VMPS VQP.
VMPS domain server	VMPS domain server name.

Related Commands

download
set vmps server
set vmps state

show vmps mac

To display the MAC-address-to-VLAN mapping table, use the show vmps mac command.

show vmps mac [mac_addr]

Syntax Description

mac_addr

(Optional) MAC address that contains the mapping information table.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Normal

Usage Guidelines

If you do not specify a MAC address, the entire mapping table is displayed.

Examples

This example shows the entire MAC-address-to-VLAN mapping table:

Console> show vmps mac

MAC Address       VLAN Name Last Requestor  Port ID Last Accessed Last Response

----------------- --------- --------------- ------- ------------- -------------

00-00-c0-23-c8-34 Hardware  198.4.222.111   3/5     0, 01:25:30   Success

00-00-c0-25-c9-42 --NONE--  198.4.222.111   2/1     0, 05:20:00   Denied

Console>

Table 2-72 describes the fields in the show vmps mac command output.

Table 2-72 show vmps mac Command Output Fields

Field	Description
MAC Address	MAC address.
VLAN Name	VLAN name assigned to the MAC address.
Last Requestor	IP address of the client that last requested a VLAN assignment for this MAC address.
Port ID	Port ID in the last request.
Last Accessed	Time when the last request was processed for this MAC address.
Last Response	Response sent by the server for the last request.

Related Commands

show vmps

show vmps statistics

To display the VMPS statistics, use the show vmps statistics command.

show vmps statistics

Syntax Description

This command has no keywords or arguments.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Normal

Usage Guidelines

The statistics shown are based on the results of the reconfirm vmps command.

Examples

This example shows how to display the VMPS statistics:

Console> show vmps statistics

VMPS Statistics:

Last Enabled At:                   2,01:30:05

Config Requests:                   20

Invalid Requests:                  0

Status 'Error' Responses:          0

Status 'Deny' Responses:           5

MAC Address of Last Failed Request: 00-60-00-cc-01-02

Console>

Table 2-73 describes the fields in the show vmps statistics command output.

Table 2-73 show vmps statistics Command Output Fields

Field	Description
Last Enabled At	Time when the VMPS was enabled
Config Requests	Number of configuration requests
Invalid Requests	Number of invalid requests
Status `Error' Responses	Number of error responses
Status `Deny' Responses	Number of "Access Denied" and "Port Shutdown" responses
MAC Address of Last Failed Request	MAC address of the last request for which the response was not successful

Related Commands

clear vmps statistics

show vmps vlan

To display all the MAC addresses assigned to a VLAN in the VMPS table, use the show vmps vlan command.

show vmps vlan vlan_name

Syntax Description

vlan_name

Name or number of the VLAN.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Normal

Examples

This example shows how to display all MAC addresses assigned to the VLAN named Hardware:

Console> show vmps vlan Hardware

MAC Address       VLAN Name Last Requestor  Port ID Last Accessed Last Response

----------------- --------- --------------- ------- ------------- -------------

00-00-c0-23-c8-34 Hardware  198.4.222.111   3/5     0, 01:25:30   Success

Console>

Table 2-74 describes the fields in the show vmps vlan command output.

Table 2-74 show vmps vlan Command Output Fields

Field	Description
MAC Address	MAC address.
VLAN Name	VLAN name assigned to the MAC address.
Last Requestor	IP address of the client that last requested a VLAN assignment for this MAC address.
Port ID	Port ID in the last request.
Last Accessed	Time when the last request was processed for this MAC address.
Last Response	Response sent by the server for the last request.

Related Commands

show vmps

show vmps vlanports

To display the dynamic ports assigned to a restricted VLAN, use the show vmps vlanports command.

show vmps vlanports vlan_name

Syntax Description

vlan_name

Name or number of the VLAN.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Normal

Examples

This example shows how to display the dynamic ports assigned to a restricted VLAN named VLAN0004:

Console> show vmps vlanports VLAN0004

VLAN Name       Device ID       Port ID

--------------- --------------- ----------

VLAN0004        10.5.6.100      3/11      

VLAN0004        10.5.6.101      4/1 

Console>

Table 2-75 describes the fields in the show vmps vlanports command output.

Table 2-75 show vmps vlan Command Output Fields

Field	Description
VLAN Name	Name of the VLAN that the dynamic ports are assigned to.
Device ID	IP address for the VMPS client with the dynamic ports.
Port ID	Port ID for the dynamic port on the VMPS client

Related Commands

show vmps

show vtp domain

To display VLAN Trunking Protocol (VTP) domain information, use the show vtp domain command.

show vtp domain

Syntax Description

This command has no keywords or arguments.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Normal

Examples

This example shows how to display VTP domain information:

Console> show vtp domain

Domain Name                      Domain Index VTP Version Local Mode  Password

-------------------------------- ------------ ----------- ----------- ----------

                                 1            2           server      -

Vlan-count Max-vlan-storage Config Revision Notifications

---------- ---------------- --------------- -------------

15         1023             5               disabled

Last Updater    V2 Mode Pruning  PruneEligible on Vlans

--------------- ------- -------- -------------------------

172.20.44.30    enabled disabled 2-1000

Console> 

Table 2-76 describes the fields in the show vtp domain command output.

Table 2-76 show vtp domain Command Output Fields 

Field	Description
Domain Name	Name of the VTP domain
Domain Index	Domain index number of the domain
VTP Version	VTP version number
Local Mode	VTP mode (server, client, or transparent)
Password	Password required or not
Vlan-count	Total number of VLANs in the domain
Max-vlan-storage	Maximum number of VLANs allowed on the device
Config Revision	VTP revision number used to exchange VLAN information
Notifications	Notifications to SNMP (enabled or disabled)
Last Updater	IP address through which VTP was last updated
V2 Mode	Status of VTP V2 mode is enabled or disabled
Pruning	Status of VTP pruning is enabled or disabled
PruneEligible on Vlans	VLANs on which pruning is allowed

Related Commands

set vtp

show vtp statistics

To display VLAN Trunking Protocol (VTP) statistics, use the show vtp statistics command.

show vtp statistics

Syntax Description

This command has no keywords or arguments.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Normal

Examples

This example shows how to display VTP statistics:

Console> show vtp statistics

VTP statistics:

summary advts received          0

subset  advts received          0

request advts received          0

summary advts transmitted       1

subset  advts transmitted       1

request advts transmitted       0

No of config revision errors    0

No of config digest errors      0

VTP pruning statistics:

Trunk     Join Transmitted  Join Received  Summary advts received from

                                          non-pruning-capable device

--------  ---------------  -------------  ---------------------------

 5/1-2

Console>

Table 2-77 describes the fields in the show vtp statistics command output.

Table 2-77 show vtp statistics Command Output Fields 

Field	Description
summary advts received	Total number of summary advt received.
subset advts received	Total number of subset advt received.
request advts received	Total number of request advts received.
summary advts transmitted	Total number of summary advts transmitted.
subset advts transmitted	Total number of subset advts transmitted.
request advts transmitted	Total number of request advts transmitted.
No of config revision errors	Number of config revision errors that have occurred.
No of config digest errors	Number of config revision digest errors that have occurred.
Trunk	Trunk port participating in VTP pruning.
Join Transmitted	Number of VTP-Pruning Joins transmitted.
Join Received	Number of VTP-Pruning Joins received.
Summary advts received from non-pruning-capable device	Number of summary advts received from nonpruning-capable devices.

Related Commands

clear vtp statistics
set vtp

slip

To enable Serial Line Internet Protocol (SLIP) for the console port, use the slip command.

slip {attach | detach}

Syntax Description

attach	Enables the Unidirectional Link Detection Protocol (UDLD) feature.
detach	Disables SLIP for the console port.

Defaults

SLIP is not active (detached)

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

You can enter the slip command from a console port session or a Telnet session.

Examples

This example shows how to attach SLIP to a console port during a console port session:

Console> (enable) slip attach

Console port now running SLIP.

<console port running SLIP>

This example shows how to detach SLIP from a console port during a Telnet session:

Console> (enable) slip detach

SLIP detached on Console port.

<console port back to RS-232 Console>

Console> (enable) 

Related Commands

set interface

sprom read

To display the contents of the SPROM, use the sprom read command.

sprom read {mod} [submodule] [chassis]

Syntax Description

mod	Number of the module.
submodule	(Optional) Submodule of a specific module.
chassis	(Optional) Specifies the chassis SPROM information of the Catalyst 4006 switch.

Defaults

This command has no default settings.

Command Types

ROM monitor command

Command Modes

Normal

Examples

This example shows how to display SPROM information on module 1:

rommon 1 > sprom read 1

Manipulating sprom at address 160.

Contents of Supervisor ID PROM:

Common ELB portion of ID PROM at address 160:

  Block signature:       0xabab

  Block version:         1

  Block length:          144

  Block checksum:        0xfb8

  ID prom size:          256

  Block count:           2

  FRU major type:        0x4101

  FRU minor type:        300

  OEM string:            Cisco Systems, Inc.

  Product number string: WS-X4012

  Serial number string:  JAB03130104

  Part number string:    73-3188-04

  Part revision string:  A0

  Mfg deviation string:

  HW major revision:     1

  HW minor revision:     5

  Mfg bits:              0

  Eng bits:              0

  SNMP OID:              0.0.0.0.0.0.0.0

  Power consumption:     0

  RMA failure code:      0-0-0-0

Supervisor ID PROM Contents:

  Block signature: 0x4101

  Block version:   1

  Block length:    24

  Block checksum:  0x2c9

  Feature bits:    0x0

  Card index:      49

  MAC addresses:   00:d0:58:70:a1:00 through 00:d0:58:70:a4:ff (1024 addresses)

rommon 2 > 

This example shows how to display submodule SPROM information on module 2:

rommon 3 > sprom read 2 submodule

Manipulating sprom at address 120.

Contents of Supervisor ID PROM:

Common ELB portion of ID PROM at address 120:

  Block signature:       0xabab

  Block version:         1

  Block length:          144

  Block checksum:        0xfb8

  ID prom size:          256

  Block count:           2

  FRU major type:        0x4101

  FRU minor type:        300

  OEM string:            Cisco Systems, Inc.

  Product number string: WS-X4012

  Serial number string:  JAB03130104

  Part number string:    73-3188-04

  Part revision string:  A0

  Mfg deviation string:

  HW major revision:     1

  HW minor revision:     5

  Mfg bits:              0

  Eng bits:              0

  SNMP OID:              0.0.0.0.0.0.0.0

  Power consumption:     0

  RMA failure code:      0-0-0-0

Supervisor ID PROM Contents:

  Block signature: 0x4101

  Block version:   1

  Block length:    24

  Block checksum:  0x2c9

  Feature bits:    0x0

  Card index:      49

  MAC addresses:   00:d0:58:70:a1:00 through 00:d0:58:70:a4:ff (1024 addresses)

rommon 4 > 

This example shows how to display the Catalyst 4006 chassis SPROM information:

rommon 5 > sprom read chassis

Manipulating sprom at address 160.

Contents of Chassis ID PROM:

Common ELB portion of ID PROM at address 160:

  Block signature:      0xabab

  Block version:        1

  Block length:         144

  Block checksum:       0x10bf

  ID prom size:         256

  Block count:          2

  FRU major type:       0x4001

  FRU minor type:       24

  OEM string:           Cisco Systems, Inc.

  Product number string:WS-C4006

  Serial number string: FOX03499057

  Part number string:   73-4289-02

  Part revision string: 02

  Mfg deviation string: 0x00

  HW major revision:    0

  HW minor revision:    2

  Mfg bits:             0

  Eng bits:             0

  SNMP OID:             0.0.0.0.0.0.0.0

  Power consumption:    0

  RMA failure code:     0-0-0-0

Chassis ID PROM Contents:

  Block signature:0x4001

  Block version:  1

  Block length:   22

  Block checksum: 0x28a

  Feature bits:   0x0

  MAC addresses:  00:30:94:fc:6e:00 through 00:30:94:fc:71:ff (1024 addresses)

rommon 6 >

squeeze—ROM monitor

To reallocate space used by deleted files in Flash memory, use the squeeze command.

squeeze device:

Syntax Description

device:

Specifies where the Flash device resides.

Defaults

This command has no default settings.

Command Types

ROM monitor command

Command Modes

Normal

Usage Guidelines

The Catalyst 4000 family, Catalyst 2948G, and Catalyst 2980G switches only support the device bootflash.

Examples

This example shows how to delete a bootflash file:

rommon 1 > squeeze bootflash:

rommon 2 >

squeeze—switch

To permanently delete Flash memory files, use the squeeze command.

squeeze [m/]device:

Syntax Description

m/	(Optional) Module number of the supervisor engine containing the Flash device.
device:	Device where the Flash device resides.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

A colon (:) is required after the specified device.

Examples

These examples show how to use the squeeze command to delete slot0 Flash memory files and then use the show flash command to confirm the deletion:

Console> squeeze slot0:

All deleted files will be removed, proceed (y/n) [n]?y

Squeeze operation may take a while, proceed (y/n) [n]?y

..........................................................

Console> show flash

-#- ED --type-- --crc--- -seek-- nlen -length- -----date/time------ name

1   .. 2        43B312DF 100fc0  15   1052608  Aug 12 1998 10:23:30 cat5k_r47_1.cbi

7336000 bytes available (1052608 bytes used)

Console>

Related Commands

dir—switch
show flash
undelete—switch

sync

To write the current working copy of environment variables and aliases to NVRAM so that they are read on the next reset, use the sync command.

sync

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 use the sync command:

rommon 1 > sync

rommon 2 >

telnet

To start a Telnet connection to a remote host, use the telnet command.

telnet host [port]

Syntax Description

host	Name or IP address of the remote host to which you want to connect.
port	(Optional) Port connection on the remote host.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to open and close a Telnet session with the host elvis:

Console> (enable) telnet elvis

Trying 192.122.174.11...

Connected to elvis.

Escape character is '^]'.

UNIX(r) System V Release 4.0 (elvis)

login: fred

Password:

Last login: Thu Jun 11 09:25:01 from forster.cisc.rum

Sun Microsystems Inc.   SunOS 5.4       Generic July 1994

You have new mail.

% logout

Console> (enable) 

Related Commands

disconnect

test snmp trap

To send an SNMP trap message to the trap receivers, use the test snmp trap command.

test snmp trap trap_num [specific_num]

Syntax Description

trap_num	Number of the trap.
specific_num	(Optional) Number of a predefined trap.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to run trap 0:

Console> (enable) test snmp trap 0

SNMP trap message sent. (4)

Console> (enable) 

Related Commands

set snmp trap

traceroute

To display a hop-by-hop path through an IP network from the switch to a specific destination host, use the traceroute command.

traceroute [-n] [-w wait_time] [-i initial_ttl] [-m max_ttl] [-p dest_port] [-q nqueries] [-t tos]
host [data_size]

Syntax Description

-n	(Optional) Prevents traceroute from performing a DNS lookup for each hop on the path.
-w wait_time	(Optional) Amount of time (in seconds) that traceroute will wait for an ICMP response message; valid ranges are from 1 to 300 seconds; the default is 5 seconds.
-i initial_ttl	(Optional) Causes traceroute to send ICMP datagrams with a TTL value equal to initial_ttl instead of the default TTL of 1.
-m max_ttl	(Optional) Maximum TTL value for outgoing ICMP datagram; valid ranges are from 1 to 255; the default value is 30.
-p dest_port	(Optional) Base UDP destination port number used in traceroute datagrams. This value increments each time a datagram is sent.
-q nqueries	(Optional) Number of datagrams to send for each TTL value. The allowed range for nqueries is 1 to 1000; the default is 3.
-t tos	(Optional) TOS to be set in the IP header of the outgoing datagrams. The allowed range for tos is 0 to 255; the default is 0.
host	IP alias or IP address in dot notation (a.b.c.d) of the destination host.
data_size	(Optional) Number of bytes, in addition to the default of 40 bytes, of the outgoing datagrams. The allowed range is 0 to 1420; the default is 0.

Defaults

The traceroute host command default settings are as follows:

•Sends three 40-byte ICMP datagrams with an initial TTL of 1.

•Maximum TTL of 30.

•Timeout period of 5 seconds.

•TOS specification of 0 to destination UDP port number 33434.

•Initial TTL for each host in the processed path increments by one.

•Destination UDP port number in the processed path increments by one.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

Only numerical IP addresses are printed.

The allowed range for wait_time is 1 to 300 seconds; the default is 5 seconds.

When you use the -i initial_ttl keyword and variable traceroute will skip processing for hosts that are less than initial_ttl hops away.

The allowed range for max_ttl is 1 to 255; the default value is 30.

The allowed range for dest_port is 1 to 65535; the default base port is 33434. Use this option in the unlikely event that the destination host is listening to a port in the default traceroute port range.

Use the -t tos keyword and variable to see if different types of service cause routes to change.

To interrupt traceroute after the command has been issued, press Ctrl-C.

The traceroute command uses the TTL field in the IP header to cause routers and servers to generate specific return messages. Traceroute starts by sending a UDP datagram to the destination host with the TTL field set to 1. If a router finds a TTL value of 1 or 0, it drops the datagram and sends back an ICMP "time exceeded" message to the sender. The traceroute facility determines the address of the first hop by examining the source address field of the ICMP time-exceeded message.

To identify the next hop, traceroute again sends a UDP packet but this time with a TTL value of 2. The first router decrements the TTL field by 1 and sends the datagram to the next router. The second router sees a TTL value of 1, discards the datagram, and returns the time-exceeded message to the source. This process continues until the TTL is incremented to a value large enough for the datagram to reach the destination host (or until the maximum TTL is reached).

To determine when a datagram has reached its destination, traceroute sets the UDP destination port in the datagram to a very large value, one that the destination host is unlikely to be using. In addition, when a host receives a datagram with an unrecognized port number, it sends an ICMP "port unreachable" error to the source. This message indicates to the traceroute facility that it has reached the destination.

Catalyst 4000 family switches can participate as the source or destination of the traceroute command. However, because they are Layer 2 devices, these switches do not examine the TTL field in the IP header and do not decrement the TTL field or send ICMP time-exceeded messages. A Catalyst 4000 family switch does not appear as a hop in the traceroute command output.

Examples

This example shows how to use the traceroute command to determine the path from the source to the destination host server10:

Console> (enable) traceroute server10

traceroute to server10.company.com (172.16.22.7), 30 hops max, 40 byte packets

 1  engineering-1.company.com (172.31.192.206)  2 ms  1 ms  1 ms

 2  engineering-2.company.com (172.31.196.204)  2 ms  3 ms  2 ms

 3  gateway_a.company.com (172.16.1.201)  6 ms  3 ms  3 ms

 4  server10.company.com (172.16.22.7)  3 ms  *  2 ms

Console> (enable)

Table 2-78 describes the fields in the traceroute command output.

Table 2-78 traceroute Command Output Fields 

Field	Description
30 hops max, 40 byte packets	Maximum TTL value and the size of the ICMP datagrams being sent.
2 ms 1 ms 1 ms	Total time (in milliseconds) for each ICMP datagram to reach the router or host plus the time it took for the ICMP time-exceeded message to return to the host. An exclamation point following any of these values (for example, 20 ms !) indicates that the port-unreachable message returned by the destination had a TTL of 0 or 1. Typically, this occurs when the destination uses the TTL value from the arriving datagram as the TTL in its ICMP reply. The reply does not arrive at the source until the destination receives a traceroute datagram with a TTL equal to the number of hops between the source and destination.
3 ms * 2 ms	"*" indicates that the timeout period (default of 5 seconds) expired before an ICMP time-exceeded message was received for the datagram.

If traceroute receives an ICMP error message other than a time-exceeded or port-unreachable message, it prints one of the error codes shown in Table 2-79 instead of the round-trip time or an asterisk (*).

Table 2-79 traceroute Error Messages

ICMP Error Code	Meaning
!N	No route to host. The network is unreachable.
!H	No route to host. The host is unreachable.
!P	Connection refused. The protocol is unreachable.
!F	Fragmentation needed but do not fragment (DF) bit was set.
!S	Source route failed.
!A	Communication administratively prohibited.
?	Unknown error occurred.

Related Commands

ping—switch

unalias

To delete an alias name and its associated value from an alias list, use the unalias command.

unalias name

Syntax Description

name	Name of the alias.

Defaults

This command has no default settings.

Command Types

ROM monitor command

Command Modes

Normal

Examples

This example shows how to use the unalias command to delete the alias and then check to ensure it was deleted:

rommon 1 > alias

r=repeat

h=history

?=help

b=boot

ls=dir

i=reset

k=stack

s=set

rommon 2 > unalias s

rommon 3 > alias

r=repeat

h=history

?=help

b=boot

ls=dir

i=reset

k=stack

rmmon 4 > s

monitor: command "s" not found

===========================================================================

Related Commands

alias

undelete—ROM monitor

To recover files that have been deleted, use the undelete command.

undelete device:filename

Syntax Description

device:	Name of the device.
filename	Name of the system image or configuration file to be recovered.

Defaults

This command has no default settings.

Command Types

ROM monitor command

Command Modes

Normal

Usage Guidelines

A colon (:) is required after the specified device.

You can undelete files until you use the squeeze command. When the squeeze command is used, all deleted files are permanently deleted.

Examples

This example shows how to recover a deleted file:

rommon 1 > undelete bootflash:cat4000.6-1-1.bin

rommon 2 >

Related Commands

del

undelete—switch

To recover a deleted file on a Flash memory device, use the undelete command.

undelete index [[m/]device:]

Syntax Description

index	Specifies the index number of the deleted file.
m/	(Optional) Specifies the module number of the supervisor engine containing the Flash device.
device:	(Optional) Name of the device where the Flash device resides.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

The deleted file can be recovered using its index (the file name is not used because there could be multiple deleted files with the same name).

A colon (:) is required after the specified device.

Use the dir command to learn the index number of the file to be undeleted.

A file cannot be undeleted if a valid file with the same name exists. You must delete the existing file before you can undelete the target file.

A file can be deleted and undeleted up to 15 times.

To permanently delete the files, use the squeeze—switch command.

Examples

This example shows how to recover the deleted file with index 1 and use the show flash command to confirm:

Console> (enable) undelete 1 bootflash:

Console> (enable)  show flash

-#- ED --type-- --crc--- -seek-- nlen -length- -----date/time------ name

  1 .. ffffffff a638976e  3627ec   23  3286891 Jan 01 1999 07:04:37 cat5000-supn

  2 .. ffffffff a6a84c93  365f74   17    14086 Jan 29 1999 02:33:56 switch_confg

  3 .. ffffffff 141a9127  70b7cc   29  3823575 Mar 09 1999 19:15:55 cat5000-supn

1428272 bytes available (6173904 bytes used)

Console> (enable)

Related Commands

delete
show flash
squeeze—switch

unset=varname

To delete a variable name from the variable list, use the unset=varname command.

unset=varname

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 use the set command to display the variable list, use the unset command to delete a variable name from the variable list, and then use the set command to display the variable list to verify that it was deleted:

rommon 1 > set 

PS1=rommon ! > 

BOOT=

?=0

rommon 2 > unset=0

rommon 3 > set 

PS1=rommon ! > 

BOOT=

rommon 4 > 

Related Commands

varname=

upload

To upload a software image to a network host, use the upload command.

upload host file [mod] [rcp | tftp]

Syntax Description

host	IP address or IP alias of the host.
file	Name of the image file.
mod	(Optional) Number of the module from which to upload the image file.
rcp	(Optional) Uploads a software image to a network host using rcp.
tftp	(Optional) Allows you to copy to or from a TFTP server.

Defaults

The default settings are as follows:

•TFTP is used unless another upload type is specified

•Module 1 is used unless another module number is specified

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

To upload a software image for the RSM, use the session command.

Examples

This example shows how to upload the supervisor image to the c4006_11.bin file from the host mercury:

Console> (enable) upload mercury c4006_11.bin 

Upload Module 1 image to c4006_11.bin on mercury (y/n) [n]? y

/

Done.  Finished Network Upload.  (153908 bytes)

Console> (enable) 

This example shows how to upload the c4000_spv11.bin file from the host mercury to the supervisor engine module using rcp:

Console> (enable) upload mercury c4000_spv11.bin rcp

Upload image c4000_spv11.bin from mercury to module 1FLASH (y/n) [n]? y

\

Finished network single module download. (2418396 bytes)

FLASH on Catalyst:

Type            Address             Location

Intel 28F008    20000000            NMP (P3) 4MB SIM

Erasing flash sector...done.

Programming flash sector...done.

Erasing flash sector...done.

Programming flash sector...done.

The system needs to be reset to run the new image.

Console> (enable)

Related Commands

download

varname=

To set a variable name to a specific value, use the varname= command.

varname=value

Syntax Description

varname=	Name of the variable.
value	Any ROM monitor command

Defaults

This command has no default settings.

Command Types

ROM monitor command

Command Modes

Normal

Usage Guidelines

The syntax varname= sets the variable to a NULL string.

Do not put a space before or after the equal (=) sign. If there are spaces, you must place the value in quotes. Spell out variable names in capital letters to make them conspicuous.

Examples

This example shows how to assign a variable name to a value:

rommon 1 > s=set

rommon 2 > s

PS1=rommon ! >

BOOT=

?=0

rommon 3 > 

Related Commands

unset=varname

verify

To confirm the checksum of a file on a Flash device, use the verify command.

verify [[m/]device:] filename

Syntax Description

m/	(Optional) Module number of the supervisor engine containing the Flash device.
device:	(Optional) Name of the device where the Flash device resides.
filename	Name of the configuration file.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

A colon (:) is required after the specified device.

Examples

This example shows how to use the verify command:

Console> verify cat4k_r47_1.cbi

..........................................................

File cat4k_r47_1.cbi verified OK.

Console>

version

To display the version of the hardware and software the switch is using, use the version command.

version

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 version of the hardware and software the switch is using:

rommon 1 > version

WS-X4012 bootrom version 4.5(1), built on 1999.03.29 21:04:04

H/W Revisions:    Meteor: 4    Comet: 8    Board: 2

Supervisor MAC addresses: 00:d0:58:70:a1:00 through 00:d0:58:70:a4:ff (1024 addresses)

Installed memory: 64 MB

rommon 2 > 

wait

To cause the CLI to pause for a specified number of seconds before running the next command, use the wait command.

wait seconds

Syntax Description

seconds

Number of seconds for the CLI to wait.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Normal

Usage Guidelines

This command can be included in a configuration file.

Examples

This example shows how to pause the CLI for 5 seconds:

Console> wait 5

Console> 

whichboot

To determine which file was used to boot the switch, use the whichboot command.

whichboot

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to determine which file was used to boot up the switch:

Console> whichboot

Boot image name is 'slot0:cat6000-sup.6-1-1.bin'.

Console> 

write

To upload or display nondefault configurations to a host, terminal, or memory, use the write command set.

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

write memory

Syntax Description

host	IP address or IP alias of the host.
file	Name of the configuration file.
network	Interactive prompting for the IP address or IP alias of the host and the filename to upload.
terminal	Displays the nondefault configuration file on the terminal.
rcp	(Optional) Uploads a software image to a host using RCP.
all	(Optional) All modules and system configuration information, including the IP address.
memory	Uploads the current configuration to a specified location.

Defaults

Only nondefault configurations are uploaded or displayed.

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

Use the keyword all to upload or display both default and nondefault configurations.

The write host file command is a shorthand version of the write network command.

You cannot use the write network command to upload software to the ATM module. With the write network command, the file must already exist on the host (use the UNIX touch filename command to create the file).

The write memory command is applicable only when the switch is set to save its configuration to a text file.

Examples

This sample session assumes that module 1 is a 2-port supervisor engine module; module 2 is a 12-port 10/100BASE-T switched Ethernet module; modules 3 and 5 are empty; and module 4 is a FDDI module. Details of the ATM configuration must be accessed through the special module mode.

This example shows how to upload the system5.cfg file to the mercury host using the write network command:

Console> (enable) write network

IP address or name of host? mercury

Name of configuration file to write? system5.cfg

Upload configuration to system5.cfg on mercury (y/n) [y]? y

/

Done.  Finished Network Upload.  (9003 bytes)

Console> (enable) 

This example shows how to upload the system5.cfg file to the mercury host using the write network rcp command:

Console> (enable) write network rcp

IP address or name of host? mercury

Name of configuration file to write? system5.cfg

Upload configuration to system5.cfg on mercury (y/n) [y]? y

/

Done.  Finished Network Upload.  (9003 bytes)

Console> (enable) 

This example shows how to upload the system5.cfg file to the mercury host using the write host file command as a shorthand method:

Console> (enable) write mercury system5.cfg

Upload configuration to system5.cfg on mercury (y/n) [y]? y

/

Done.  Finished Network Upload.  (9003 bytes)

Console> (enable) 

This example shows how to use the write terminal all command to display the entire (default and nondefault) configuration file on the terminal (partial display):

Console> (enable) write terminal all

begin

set password $1$FMFQ$HfZR5DUszVHIRhrz4h6V70

set enablepass $1$FMFQ$HfZR5DUszVHIRhrz4h6V70

set prompt Console>

!

#system

set system baud 9600

set system modem  disable

set system name

set system location

set system contact

!

#snmp

set snmp community read-only public

set snmp community read-write private

set snmp community read-write-all secret

set snmp trap  disable

!

#vlan/trunk

set vlan 1    1/1-2,4/1

set vlan 2    2/1-5

!

#trunks

!

#cam

set cam agingtime 1    300

set cam agingtime 2    300

!

#ip

set interface sc0 0.0.0.0 0.0.0.0 0.0.0.0

set interface sl0 0.0.0.0 0.0.0.0

set ip redirect      enable

set ip unreachable   disable

set ip fragmentation enable

set ip alias default         0.0.0.0

set arp agingtime 1200

!

...

<<<<output truncated>>>>

Console> (enable)

This example shows how to upload the running system configuration to a pre-specified location:

Console> (enable) write memory

Upload configuration to bootflash:switch.cfg

7165844 bytes available on device bootflash, proceed (y/n) [n]? y

Console> (enable)

Related Commands

copy
show config
set config mode

write tech-support

To generate a report that contains status information about your switch or to upload the output of the command to a TFTP server so that you can send it to the Technical Assistance Center (TAC), use the write tech-support command.

write tech-support host file [module mod] [vlan vlan] [mistp-instance instance] [mst instance] [memory] [config]

write tech-support host file [port mod/port] [vlan vlan] [mistp-instance instance] [mst instance] [memory] [config]

Syntax Description

host	IP address or IP alias of the host.
file	Name of the configuration file.
module mod	(Optional) Module number.
vlan vlan	(Optional) VLAN; valid values are from 1 to 1001.
port mod/port	(Optional) Module and port on the module.
mistp-instance instance	(Optional) MISTP instance number; valid values are from 1 to 16.
mst instance	(Optional) MST instance number; valid values are from 0 to 15.
memory	Memory and processor state information.
config	Switch configuration information.

Defaults

Displays the output for technical-support-related show commands.

---

Note Use keywords to specify the type of information to be displayed. If you do not specify any parameters, the system displays all configuration, memory, module, port, instance data, and VLAN data.

---

Command Types

Switch command

Command Modes

Privileged

Usage Guidelines

---

Caution To prevent spanning tree instability, avoid running multiple write tech-support commands on a switch or multiple switches on the network segment.

---

---

Note If you press Ctrl-C while the write tech-support command is writing to the output file, the output file to the TFTP server might be incomplete.

---

---

Note If you are uploading information to a file, ensure that the file already exists in the TFTP server and has appropriate permissions, and network connections are good before you issue the write tech-support command.

---

If you specify the config keyword, the write tech-support command displays the output of these commands:

•show config

•show flash

•show log

•show microcode

•show module

•show port

•show spantree active

•show spantree summary

•show system

•show test

•show trunk

•show version

•show vlan

---

Note If MISTP is running, the output from the show spantree mistp-instance active and show spantree summary mistp-instance commands are displayed instead of the output from the show spantree active and show spantree summary commands.

---

---

Note If MST is running, the output from the show spantree mst and show spantree summary mst commands are displayed instead of the output from the show spantree active and show spantree summary commands.

---

If you specify the memory keyword, the write tech-support command displays the output of these commands:

•ps

•ps -c

•show cam static

•show cam system

•show flash

•show memory buffers

•show microcode

•show module

•show proc

•show proc mem

•show proc cpu

•show system

•show spantree active

•show version

If you specify a module, port, or VLAN number, the system displays general system information and information for the component that you specified.

Examples

This example shows how to upload a technical report:

Console> (enable) write tech-support 172.20.32.10 tech.txt

Upload tech-report to tech.txt on 172.20.32.10 (y/n) [n]? y

/

Finished network upload.  (67784 bytes)

Console> (enable) 

Related Commands

show tech-support

Also see the commands listed in "Usage Guidelines."

write terminal

To display the configuration information currently in running memory, use the write terminal command.

write terminal [all]

Syntax Description

all	(Optional) All configuration information.

Defaults

This command has no default settings.

Command Types

Switch command

Command Modes

Privileged

Examples

This example shows how to display the current system configuration information:

Console> (enable) write terminal

......

..

begin

!

# ***** NON-DEFAULT CONFIGURATION *****

!

!

#Time: Tue Aug 3 1999, 07:32:26 

!

#version 5.3(0.90)ASP

!

!       

#frame distribution method

set port channel all distribution mac both

!

#vtp

set vtp domain Lab_Network

set vtp pruning enable

set vlan 1 name default type ethernet mtu 1500 said 100001 state active 

set vlan 2 name VLAN0002 type ethernet mtu 1500 said 100002 state active 

set vlan 3 name VLAN0003 type ethernet mtu 1500 said 100003 state active 

set vlan 4 name VLAN0004 type ethernet mtu 1500 said 100004 state active 

set vlan 5 name VLAN0005 type ethernet mtu 1500 said 100005 state active 

set vlan 6 name VLAN0006 type ethernet mtu 1500 said 100006 state active 

set vlan 10 name VLAN0010 type ethernet mtu 1500 said 100010 state active 

set vlan 20 name VLAN0020 type ethernet mtu 1500 said 100020 state active 

set vlan 50 name VLAN0050 type ethernet mtu 1500 said 100050 state active 

set vlan 100 name VLAN0100 type ethernet mtu 1500 said 100100 state active 

set vlan 152 name VLAN0152 type ethernet mtu 1500 said 100152 state active 

set vlan 200 name VLAN0200 type ethernet mtu 1500 said 100200 state active 

set vlan 300 name VLAN0300 type ethernet mtu 1500 said 100300 state active 

set vlan 303 name VLAN0303 type fddi mtu 1500 said 100303 state active 

set vlan 304 name VLAN0304 type fddi mtu 1500 said 100304 state active 

set vlan 305 name VLAN0305 type fddi mtu 1500 said 100305 state active 

set vlan 349 name VLAN0349 type fddi mtu 1500 said 100349 state active 

set vlan 350 name VLAN0350 type fddi mtu 1500 said 100350 state active 

set vlan 351 name VLAN0351 type fddi mtu 1500 said 100351 state active 

set vlan 400 name VLAN0400 type ethernet mtu 1500 said 100400 state active 

set vlan 500 name VLAN0500 type ethernet mtu 1500 said 100500 state active 

set vlan 521 name VLAN0521 type ethernet mtu 1500 said 100521 state active 

set vlan 524 name VLAN0524 type ethernet mtu 1500 said 100524 state active 

set vlan 570 name VLAN0570 type ethernet mtu 1500 said 100570 state active 

set vlan 801 name VLAN0801 type trbrf mtu 4472 said 100801 state active bridge  

set vlan 850 name VLAN0850 type ethernet mtu 1500 said 100850 state active 

set vlan 917 name VLAN0917 type ethernet mtu 1500 said 100917 state active 

set vlan 999 name VLAN0999 type ethernet mtu 1500 said 100999 state active 

set vlan 1002 name fddi-default type fddi mtu 1500 said 101002 state active 

set vlan 1004 name fddinet-default type fddinet mtu 1500 said 101004 state acti 

set vlan 1005 name trnet-default type trbrf mtu 1500 said 101005 state active b 

set vlan 802 name VLAN0802 type trcrf mtu 4472 said 100802 state active parent  

set vlan 1003 name token-ring-default type trcrf mtu 1500 said 101003 state act 

set vlan 3 translation 303 translation 0

set vlan 4 translation 304 translation 0

set vlan 5 translation 305 translation 0

set vlan 303 translation 3 translation 0

set vlan 304 translation 4 translation 0

set vlan 305 translation 5 translation 0

set vlan 351 translation 524 translation 0

set vlan 524 translation 351 translation 0

!

#ip

set interface sc0 5 172.20.52.124/255.255.255.248 172.20.52.127

set ip route 0.0.0.0/0.0.0.0         172.20.52.125  

!

#spantree

#vlan 801

set spantree fwddelay 4     801

set spantree maxage   10    801

#vlan 802

set spantree fwddelay 4     802

set spantree maxage   10    802

set spantree portstate 802 block 801

!

#set boot command

set boot auto-config non-recurring

!

#Port Channel

set port channel 7/7-8 3

set port channel 7/5-6 21

!       

#module 1 : 2-port 1000BaseX Supervisor IIIG

!

#module 2 empty

!

#module 3 : 2-port DS3 Dual PHY ATM

!

#module 4 empty

!

#module 5 empty

!

#module 6 : 48-port 10BaseT Ethernet

!

#module 7 : 24-port 10/100BaseTX Ethernet

set trunk 7/1  desirable isl 1-1005

set trunk 7/2  desirable isl 1-1005

set trunk 7/3  desirable isl 1-1005

set trunk 7/4  desirable isl 1-1005

nt7/1-6 mode desirable silent

!

#module 8 empty

!

#module 9 empty

!       

#module 15 empty

!

#module 16 empty

end

Console> (enable)

2