Table Of Contents

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 statistics

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

varname=

verify

version

wait

write

write tech-support

write terminal

2

show timezone

Use the show timezone command to display the current time zone and offset.

show timezone

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default setting.

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

Use the show top command to start the TopN process.

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

Syntax Description

N	(Optional) Number of ports displayed. Valid values are 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) Keyword that specifies 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) Keyword that specifies the 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 defaults 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

Use the show top report command to list all TopN processes and specific TopN report.

show top report [report_num]

Syntax Description

report_num

(Optional) TopN report number for each process.

Defaults

This command has no default setting.

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

Use the show trace command to display trace category and level.

show trace [all]

Syntax Description

all	(Optional) Keyword that displays all trace category and level information.

Defaults

This command has no setting.

Command Types

Switch command.

Command Modes

Normal.

Examples

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

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

Use the show traffic command to display Traffic and Peak information for each switching bus.

show traffic

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default setting.

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

Use the show trunk command to display trunking information for the switch.

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

Syntax Description

mod_num	(Optional) Number of the module.
/port_num	(Optional) Number of the port.
detail	(Optional) Keyword that shows detailed information about the specified trunk port.

Defaults

This command has no default setting.

Command Types

Switch command.

Command Modes

Normal.

Usage Guidelines

Entering the show trunk command without specifying 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

Use the show udld command to display UDLD information.

show udld

show udld port [mod_num[/port_num]]

Syntax Description

port	Keyword that specifies module or ports.
mod_num	(Optional) Number of the module for which UDLD information is displayed.
/port_num	(Optional) Number of the port for which UDLD information is displayed.

Defaults

This command has no default setting.

Command Types

Switch command.

Command Modes

Normal.

Examples

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

Console> show udld

UDLD      : enabled 

Console> 

This example shows how to display UDLD information for a specific module and port:

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 a specific module:

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

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

show users [noalias]

Syntax Description

noalias

(Optional) Keyword that specifies to indicate, not to display, the IP alias; the IP address is displayed.

Defaults

This command has no default setting.

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

Use the show version command to display software and hardware version information for switching and supervisor engine modules only.

show version [mod]

Syntax Description

mod	(Optional) Number of the module.

Defaults

This command has no default setting.

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 in use.
Free	Amount of available FLASH.
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

Use the show vlan command to display VLAN information.

show vlan [trunk]

show vlan vlan [notrunk]

show vlan mapping

show vlan type

Syntax Description

trunk	(Optional) Keyword that specifies to force the display to show information only on trunk ports.
vlan	Number of the VLAN. If the VLAN number is not specified, all VLANs are displayed.
notrunk	(Optional) Keyword that specifies to force the display to show information only on nontrunk ports.
mapping	Keyword to display VLAN mapping table information.
type	Type of VLAN; valid values are Ethernet, FDDI, FDDInet, TrBRF, and TrCRF.

Defaults

This command has no default setting.

Command Types

Switch command.

Command Modes

Normal.

Usage Guidelines

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

Examples

This example shows how to display information for all VLANs:

Console> show vlan

VLAN Name                             Status    IfIndex Mod/Ports, Vlans

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

1    default                          active    5       1/2

                                                        6/1-48

                                                        7/2-24

2    VLAN0002                         active    339     

5    VLAN0005                         active    342     

50   VLAN0050                         active    346     

100  VLAN0100                         active    347     

152  VLAN0152                         active    348     

200  VLAN0200                         active    349     

300  VLAN0300                         active    350     

305  VLAN0305                         active    354     

801  VLAN0801                         active    338     338     802

VLAN Type  SAID       MTU   Parent RingNo BrdgNo Stp  BrdgMode Trans1 Trans2

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

1    enet  100001     1500  -      -      -      -    -        0      0

10   enet  100010     1500  -      -      -      -    -        0      0

901  enet  100901     1500  -      -      -      -    -        0      0

999  trbrf 100999     4472  -      -      0xe    ieee -        0      0

1002 fddi  101002     1500  -      0x0    -      -    -        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 AREHops STEHops Backup CRF

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

1003 7       7       off

Console> 

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       

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>

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	Interface Index, assigned by SNMP.
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.
Trans1	First translational VLAN used to translate FDDI or Token Ring to Ethernet.
Trans2	Second translational VLAN used to translate FDDI or Token Ring to Ethernet.
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.

Related Commands

set trunk
set vlan
show trunk

show vmps

Use the show vmps command to display VMPS configuration information.

show vmps [noalias]

Syntax Description

noalias

(Optional) Keyword that specifies to force 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 for the Catalyst 4000 family switches:

Console> show vmps

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	Statis of VMPS server.
Management Domain	Management domain supported by this server.
State	Status on 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	Status on 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

set vtp

show vmps statistics

Use the show vmps statistics command to display the VMPS statistics (based on the results of the reconfirm vmps command).

show vmps statistics

Syntax Description

This command has no keywords or arguments.

Defaults

This command has no default setting.

Command Types

Switch command.

Command Modes

Normal.

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-72 describes the fields in the show vmps statistics command output.

Table 2-72 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

show vmps

show vtp domain

Use the show vtp domain command to display VTP domain information.

show vtp domain

Syntax Description

This command has no keywords or arguments.

Defaults

This command has no default setting.

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-73 describes the fields in the show vtp domain command output.

Table 2-73 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 on whether VTP V2 mode is enabled or disabled.
Pruning	Status on whether VTP pruning is enabled or disabled.
PruneEligible on Vlans	VLANs on which pruning is allowed.

Related Commands

set vtp

show vtp statistics

Use the show vtp statistics command to display VTP statistics.

show vtp statistics

Syntax Description

This command has no keywords or arguments.

Defaults

This command has no default setting.

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-74 describes the fields in the show vtp statistics command output.

Table 2-74 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 Trasmitted	Number of VTP-Pruning Joins transmitted.
Join Received	Number of VTP-Pruning Joins received.
Summary advts received from nonpruning-capable device	Number of Summary advts received from nonpruning-capable devices.

Related Commands

set vtp
clear vtp statistics

slip

Use the slip command to attach or detach SLIP for the console port.

slip {attach | detach}

Syntax Description

attach	Keyword that specifies to enable the UDLD feature.
detach	Keyword that specifies to deactivate SLIP for the console port.

Defaults

By default, 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 enable SLIP for 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 disable SLIP for 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

Use the sprom read command to display the contents of the SPROM.

sprom read {mod} [submodule] [chassis]

Syntax Description

mod	Number of the module.
submodule	(Optional) Keyword that specifies the submodule of a specific module.
chassis	(Optional) Keyword that 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 5 > 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 6 > 

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

rommon 5 > 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 6 >

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

rommon 2 > 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 3 >

squeeze—ROM monitor

Use the squeeze command to reclaim space used by deleted files in Flash.

squeeze device

Syntax Description

device

Device where the Flash device resides. The Catalyst 4000 family, 2948G, and 2980G switches only support the device bootflash:.

Defaults

This command has no default settings.

Command Types

ROM monitor command.

Command Modes

Normal.

Examples

This example shows how to delete the bootflash: files:

rommon 1 > squeeze bootflash:

rommon 2 >

squeeze—switch

Use the squeeze command to delete Flash files permanently.

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 setting.

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 the slot0 Flash 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
undelete—switch
show flash

sync

Use the sync command to write the working in-core copy of environment variables and the aliases out to NVRAM so they are read on the next reset.

sync

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default setting.

Command Types

ROM monitor command.

Command Modes

Normal.

Examples

This example shows how to use the sync command:

rommon 10 > sync

rommon 11 >

telnet

Use the telnet command to start a Telnet connection to a remote host.

telnet host [port_num]

Syntax Description

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

Defaults

This command has no default setting.

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

Use the test snmp trap command to send an SNMP trap message to the trap receivers.

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 setting.

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

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

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. Only numerical IP addresses are printed.
-w wait_time	(Optional) Specifies the amount of time (in seconds) that traceroute will wait for an ICMP response message. The allowed range for wait_time is 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. This causes traceroute to skip processing for hosts that are less than initial_ttl hops away.
-m max_ttl	(Optional) Specifies the maximum TTL value for outgoing ICMP datagrams. The allowed range for max_ttl is 1 to 255; the default value is 30.
-p dest_port	(Optional) Specifies the base UDP destination port number used in traceroute datagrams. This value increments each time a datagram is sent. 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.
-q nqueries	(Optional) Specifies the 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) Specifies the 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. Use this option to see if different types of service cause routes to change.
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

Entering the traceroute host command without options sends three 40-byte ICMP datagrams with an initial TTL of 1, a maximum TTL of 30, a timeout period of 5 seconds, and a TOS specification of 0 to destination UDP port number 33434.  For each host in the processed path, the initial TTL for each host and the destination UDP port number for each packet sent are incremented by one.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

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 that the destination host is unlikely to be using. 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-75 describes the fields in the traceroute command output.

Table 2-75 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-76 instead of the round-trip time or an asterisk (*).

Table 2-76 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

Use the unalias command to remove the alias name and associated value from the alias list.

unalias name

Syntax Description

name	Name of the alias.

Defaults

This command has no default setting.

Command Types

ROM monitor command.

Command Modes

Normal.

Examples

This example shows how to use the unalias command to remove the s alias and then check to ensure it was removed:

rommon 5 > alias

r=repeat

h=history

?=help

b=boot

ls=dir

i=reset

k=stack

s=set

rommon 6 > unalias s

rommon 7 > alias

r=repeat

h=history

?=help

b=boot

ls=dir

i=reset

k=stack

rmmon 8 > s

monitor: command "s" not found

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

Related Commands

alias

undelete—ROM monitor

Use the undelete command to recover files that have been deleted.

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

You can undelete a file until you use the squeeze command. Once you have squeezed the system, the file is lost.

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

Use the undelete command to recover a deleted file on a Flash memory device. The deleted file can be recovered using its index (because there could be multiple deleted files with the same name).

undelete index [[m/]device:]

Syntax Description

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

Defaults

This command has no default setting.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

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 delete all deleted files permanently on a device, 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

Use the unset=varname command to remove a variable name from the variable list.

unset=varname

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no defaults.

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 remove a variable name from the variable list, and then use the set command to display the variable list to verify:

rommon 2 > set 

PS1=rommon ! > 

BOOT=

?=0

rommon 3 > unset=0

rommon 4 > set 

PS1=rommon ! > 

BOOT=

Related Commands

varname=

varname=

Use the varname= command to set the variable VARNAME to varvalue. The syntax varname= sets the variable to a NULL string.

varname=value

Syntax Description

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

Defaults

This command has no defaults.

Command Types

ROM monitor command.

Command Modes

Normal.

Usage Guidelines

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

Related Commands

unset=varname

verify

Use the verify command to confirm the checksum of a file on a Flash device.

verify [[m/]device:] filename

Syntax Description

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

Defaults

This command has no default setting.

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 cat5k_r47_1.cbi

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

File cat5k_r47_1.cbi verified OK.

version

Use the version command to display software and hardware version information.

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 software and hardware versions:

rommon 8 > 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 addr

esses)

Installed memory: 64 MB

rommon 9 > 

wait

Use the wait command to cause the CLI to pause for a specified number of seconds before executing the next command. This command might be included in a configuration file.

wait seconds

Syntax Description

seconds

Number of seconds for the CLI to wait.

Defaults

This command has no default setting.

Command Types

Switch command.

Command Modes

Normal.

Examples

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

Console> wait 5

Console> 

write

Use the write command to upload or display non-default configurations to a host or terminal.

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

Syntax Description

host	IP address or IP alias of the host.
file	Name of the configuration file.
network	Keyword that specifies interactive prompting for the IP address or IP alias of the host and the filename to upload.
terminal	Keyword that specifies to display the non-default configuration file on the terminal.
rcp	(Optional) Keyword that specifies to upload a software image to a host using rcp.
all	(Optional) Keyword that specifies all modules and system configuration information, including the IP address.

Defaults

By default, the write command will upload or output only nondefault configurations. Use the keyword all to upload or output both default and nondefault configurations.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

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).

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 an 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:

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

!

#bridge

set bridge ipx snaptoether   8023raw

set bridge ipx 8022toether   8023

set bridge ipx 8023rawtofddi snap

!

#Command alias

!

#cdp

set cdp enable   1/1-2,2/1-5,4/1

set cdp interval 1/1  60

set cdp interval 1/2  60

set cdp interval 2/1  60

set cdp interval 2/2  60

set cdp interval 2/3  60

set cdp interval 2/4  60

set cdp interval 2/5  60

set cdp interval 4/1  60

!

#spantree

#vlan 1

set spantree enable         1

set spantree fwddelay 15    1

set spantree hello    2     1

set spantree maxage   20    1

set spantree priority 32768 1

set spantree portpri  1/1  32

set spantree portcost 1/1  10

set spantree portpri  1/2  32

set spantree portcost 1/2  10

set spantree portpri  4/1  32

set spantree portcost 4/1  10

#vlan 2

set spantree enable         2

set spantree fwddelay 15    2

set spantree hello    2     2

set spantree maxage   20    2

set spantree priority 32768 2

set spantree portpri  2/1  32

set spantree portcost 2/1  100

set spantree portpri  2/2  32

set spantree portcost 2/2  100

set spantree portpri  2/3  32

set spantree portcost 2/3  100

set spantree portpri  2/4  32

set spantree portcost 2/4  100

set spantree portpri  2/5  32

set spantree portcost 2/5  100

!

#trunk

!

#module 1

set module name    1

set port enable    1/1

set port name      1/1

set port duplex    1/1  half

set port level     1/1  normal

set port enable    1/2

set port name      1/2

set port duplex    1/2  half

set port level     1/2  normal

!

#module 2

set module name    2

set module enable  2

!

set port enable    2/1

set port name      2/1

set port duplex    2/1  half

set port level     2/1  normal

set port enable    2/2

set port name      2/2

set port duplex    2/2  half

set port level     2/2  normal

set port enable    2/3

set port name      2/3

set port duplex    2/3  half

set port level     2/3  normal

set port enable    2/4

set port name      2/4

set port duplex    2/4  half

set port level     2/4  normal

set port enable    2/5

set port name      2/5

set port duplex    2/5  half

set port level     2/5  normal

!

#module 3 empty

!

#module 4

set module name    4

set module enable  4

!

set fddi userdata  4 WorkGroup Stack

set fddi tnotify   4 30

set fddi treq      4 5000

set port enable    4/1

set port name      4/1

set port level     4/1  normal

set fddi tlmin     4/1  40

set port enable    4/2

set port name      4/2

set port level     4/2  normal

set fddi tlmin     4/2  40

!

#module 5 empty

end

Console> (enable)

Related Commands

show config
copy

write tech-support

Use the write tech-support command set to generate a report that contains status information about your switch or upload the output of the command to a TFTP server, where you can send it to TAC.

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

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

Syntax Description

host	IP address or IP alias of the host.
file	Name of the configuration file.
module mod	(Optional) Keyword and variable that specifies the module number.
vlan vlan	(Optional) Keyword and variable that specifies the VLAN; valid values are from 1 to 1001.
port mod/port	(Optional) Keyword and variables that specifies the module and port on the module.
memory	Keyword that specifies memory and processor state information.
config	Keyword that specifies switch configuration information.

Defaults

By default, this command displays the output for technical-support-related show commands. 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.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

---

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

---

---

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

---

---

Note If you are uploading the information to a file, make sure 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

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 you specified.

Examples

This example shows how to upload the 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

See the commands listed in the "Usage Guidelines" section.

write terminal

Use the write terminal command to display the configuration information currently in running memory.

write terminal [all]

Syntax Description

all	(Optional) Keyword that specifies all configuration information.

Defaults

This command has no default setting

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)