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:
Thu Apr 15 1999, 02:54:50
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:
Timezone set to 'pst', offset from UTC is -8 hours
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/.
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
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
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:
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//
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//
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
Port Band- Uti Tx/Rx-bytes Tx/Rx-pkts Tx/Rx-bcst Tx/Rx-mcst In- Buf-
----- ----- --- -------------------- ---------- ---------- ---------- ---- -----
/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
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:
Trace monitor is enabled for this session.
This example shows how to display all trace category and level information:
Trace monitor is enabled for this session.
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:
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
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/10 desirable isl trunking 1
Port Vlans allowed on trunk
-------- ---------------------------------------------------------------------
Port Vlans allowed and active in management domain
-------- ---------------------------------------------------------------------
2/1 1-5,10,50,152,500,521-524,570
Port Vlans in spanning tree forwarding state and not pruned
-------- ---------------------------------------------------------------------
2/1 1-5,10,50,152,500,521-524,570
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
-------- ---------------------------------------------------------------------
Port Vlans allowed and active in management domain
-------- ---------------------------------------------------------------------
Port Vlans in spanning tree forwarding state and not pruned
-------- ---------------------------------------------------------------------
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:
This example shows how to display UDLD information for module 2 port 1:
Console> show udld port 2/1
Port Admin Status Link State
-------- ------------ ----------------
This example shows how to display UDLD information for all ports on module 3:
Console> (enable) show udld port 3
Port Admin Status Link State
-------- ------------ ----------------
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:
------------- --------------- ------------------------------
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:
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
3 48 WS-X5223-RJ-45 SAD03257164 Hw : 1.1
5 48 WS-X5223-RJ-45 SAD03257171 Hw : 1.1
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
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
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.
|
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:
VLAN Name Status IfIndex Mod/Ports, Vlans
---- -------------------------------- --------- ------- ------------------------
10 VLAN0010 active 18 6/1,6/3
11 VLAN0011 active 19 6/2
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
---- ---- ---------- --------
VLAN AREHops STEHops Backup CRF 1q VLAN
---- ------- ------- ---------- -------
Primary Secondary Secondary-Type Ports
------- --------- -------------- ------------
This example shows how to display the VLAN mapping table information:
Console> show vlan mapping
802.1q vlan ISL vlan Effective
------------------------------------------
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
---- ---- ---------- --------
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
---- -------------------------------- --------- ------- ------------------------
VLAN Type SAID MTU Parent RingNo BrdgNo Stp BrdgMode Trans1 Trans2
---- ----- ---------- ----- ------ ------ ------ ---- -------- ------ ------
2 enet 100002 1500 - - - - - 0 0
VLAN Inst DynCreated RSPAN
---- ---- ---------- --------
VLAN AREHops STEHops Backup CRF 1q VLAN
---- ------- ------- ---------- -------
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
---- ------- ------- ---------- -------
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:
Management Domain: (null)
Operational Status: inactive
TFTP File: vmps-config-database.1
VMPS No Domain Req: allow
Reconfirm Interval: 60 min
No dynamic ports configured.
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:
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
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
Last Enabled At: 2,01:30:05
Status 'Error' Responses: 0
Status 'Deny' Responses: 5
MAC Address of Last Failed Request: 00-60-00-cc-01-02
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
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
--------------- --------------- ----------
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:
Domain Name Domain Index VTP Version Local Mode Password
-------------------------------- ------------ ----------- ----------- ----------
Vlan-count Max-vlan-storage Config Revision Notifications
---------- ---------------- --------------- -------------
Last Updater V2 Mode Pruning PruneEligible on Vlans
--------------- ------- -------- -------------------------
172.20.44.30 enabled disabled 2-1000
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
summary advts transmitted 1
subset advts transmitted 1
request advts transmitted 0
No of config revision errors 0
No of config digest errors 0
Trunk Join Transmitted Join Received Summary advts received from
non-pruning-capable device
-------- --------------- ------------- ---------------------------
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>
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:
Manipulating sprom at address 160.
Contents of Supervisor ID PROM:
Common ELB portion of ID PROM at address 160:
OEM string: Cisco Systems, Inc.
Product number string: WS-X4012
Serial number string: JAB03130104
Part number string: 73-3188-04
SNMP OID: 0.0.0.0.0.0.0.0
RMA failure code: 0-0-0-0
Supervisor ID PROM Contents:
MAC addresses: 00:d0:58:70:a1:00 through 00:d0:58:70:a4:ff (1024 addresses)
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:
OEM string: Cisco Systems, Inc.
Product number string: WS-X4012
Serial number string: JAB03130104
Part number string: 73-3188-04
SNMP OID: 0.0.0.0.0.0.0.0
RMA failure code: 0-0-0-0
Supervisor ID PROM Contents:
MAC addresses: 00:d0:58:70:a1:00 through 00:d0:58:70:a4:ff (1024 addresses)
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:
OEM string: Cisco Systems, Inc.
Product number string:WS-C4006
Serial number string: FOX03499057
Part number string: 73-4289-02
Mfg deviation string: 0x00
SNMP OID: 0.0.0.0.0.0.0.0
RMA failure code: 0-0-0-0
Chassis ID PROM Contents:
MAC addresses: 00:30:94:fc:6e:00 through 00:30:94:fc:71:ff (1024 addresses)
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:
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:
All deleted files will be removed, proceed (y/n) [n]?y
Squeeze operation may take a while, proceed (y/n) [n]?y
..........................................................
-#- 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)
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:
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
Escape character is '^]'.
UNIX(r) System V Release 4.0 (elvis)
Last login: Thu Jun 11 09:25:01 from forster.cisc.rum
Sun Microsystems Inc. SunOS 5.4 Generic July 1994
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)
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
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
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:
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
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)
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:
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)
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)
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.
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:
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.
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:
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)
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:
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:
Boot image name is 'slot0:cat6000-sup.6-1-1.bin'.
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)
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)
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)
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
set password $1$FMFQ$HfZR5DUszVHIRhrz4h6V70
set enablepass $1$FMFQ$HfZR5DUszVHIRhrz4h6V70
set snmp community read-only public
set snmp community read-write private
set snmp community read-write-all secret
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 unreachable disable
set ip fragmentation enable
set ip alias default 0.0.0.0
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
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)
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
# ***** NON-DEFAULT CONFIGURATION *****
#Time: Tue Aug 3 1999, 07:32:26
#frame distribution method
set port channel all distribution mac both
set vtp domain Lab_Network
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
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
set spantree fwddelay 4 801
set spantree maxage 10 801
set spantree fwddelay 4 802
set spantree maxage 10 802
set spantree portstate 802 block 801
set boot auto-config non-recurring
set port channel 7/5-6 21
#module 1 : 2-port 1000BaseX Supervisor IIIG
#module 3 : 2-port DS3 Dual PHY ATM
#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
2