Command Reference

Top-Level Commands

There are two categories of commands: privileged and normal. (See Table C-1.)

• Privileged commands are available only after you invoke the enable command. They are used for system configuration and by end users for troubleshooting basic problems. Certain commands are available, and certain displays have extra information in privileged mode. The designation (enable) appears on your screen in sample displays to indicate privileged commands and when the system is in privileged mode.

• Normal commands are available in all cases, and are used by end users for everyday operations.

Displaying Information about Commands

Use the ? command to display usage and syntax information about a specific command or to list groups of commands. In normal mode, use the ? command to display a list of top-level commands, as follows:

In privileged mode, use the ? command to display a list of commands, as follows:

clear Commands

Table C-2 lists the clear commands.

clear alias

Use the clear alias command to clear shorthand versions of commands. Following is a sample display:

See also set alias and show alias.

clear arp

Use the clear arp command to clear ARP tables. To delete an ARP entry, use the command clear arp ip_address, where ip_address is the address in the ARP table you want to delete. Following is a sample display:

See also set arp and show arp.

clear cam

Use the clear cam command to clear CAM table entries. Following is a sample display:

See also set cam and show cam.

clear config

Use the clear config command to clear the configuration information stored in nonvolatile random access memory (NVRAM). The clear config command also resets the system. Following is a sample display:

clear counters

Use the clear counters command to clear MAC and port counters. Following is a sample display:

clear filter

Use the clear filter command to clear custom filtering parameters on a port that were previously set using the set filter command. Following is a sample display:

See also set filter and show filter.

clear help

Use the clear help command to display the following information in privileged mode:

See also set help and show help.

clear ip

Use the clear ip command to clear IP information. Use the clear ip alias command to clear aliases of IP addresses. Use the clear ip route command to clear the IP route table entries. Use the clear ip helper to clear the helper IP address from a particular VLAN. It is only available in privileged mode. Following is a sample display:

See also set ip alias and show ip.

clear log

Use the clear log command to clear the system error log. Following is a sample display:

See also show log.

clear multicast

Use the clear multicast command to clear an IP multicast group or all IP multicast groups. Following is a sample display:

See also set multicast group and show multicast.

clear snmp help

Use the clear snmp trap help command to display the clear snmp commands. Following is a sample display:

clear snmp trap

Use the clear snmp command to clear an entry from the SNMP trap receiver table. Following is a sample display:

See also set snmp help and show snmp.

clear trunk

Use the clear trunk command to clear partial information in the trunk port table or convert trunk link back to bridge ports. This command disables transitencapsulation if the mode is on. If VLANs are specified, only those VLANs are cleared from the trunk port table. When all VLANs in the trunk port are cleared, the port automatically converts back to a regular bridge port. Following is a sample display:

See also set trunk and show trunk.

configure Command

Use the configure network command to download a configuration batch file (designated by filename) from a TFTP server (designated by the server) and then execute the commands in the file. Following is a sample display of the configure command:

If the server is not specified, the default is the first entry in the SNMP trap receiver table.

The configure terminal command prompts you to use the set commands to configure the system. Following is a sample display:

Configuration files are simply multiple Catalyst commands collected in a file. Each Catalyst command is entered on one line. The file should be delimited by begin and end statements and may have comments (identified by a pound sign [#]) as the first character on the line; however, comments must be on lines by themselves. Some commands prompt you for input or confirmation. With input commands, responses should follow the command on the next line(s) to ensure proper operation.

Configuration files should consist only of ASCII text, and should not be larger than 4,608 bytes (4.5 KB).

Following is a sample configuration:

Following is a sample admin. session:

When you enter the configure network command, you are prompted for the host server, then for the configuration filename.

copy Command

Use the copy command to copy data movement processor (DMP) or network management processor (NMP) image files between the network host and Flash memory using the TFTP protocol. Following is a sample display:

disable

Use the disable command to turn off enable mode, as follows:

See also the "enable Command " section.

disconnect Command

Use the disconnect command to temporarily disconnect the FDDI port from the FDDI ring temporarily without disconnecting the FDDI cables. The default is connect. Following is a sample display:

See also "copy Command" section.

download Command

Use the download command to download code to the network management processor (the default) or the data movement processor. Following is a sample display:

Caution  If the SUM port is also connected to the TFTP server while you are downloading an image file, you must disconnect the SUM port to avoid creating a loop condition.

enable Command

Use the enable command to turn on privileged mode. Certain commands are available, and certain displays have extra information in privileged mode.

Following is a sample display:

See also the "clear Commands" section.

help Command

Use the help command to display the following information in normal mode:

Use the help command to display the following information in privileged mode:

history Command

Use the history command to display the contents of the history substitution buffer, as follows:

ping Command

Use the ping command to send Internet Control Message Protocol (ICMP) echo packets to another node on the network. Following is a sample display:

Following are options of the ping command:

• -s--sends one datagram per second, printing one line of output for every response received. The ping command does not return any output when no response is received.

• packet size and packet count--Specifies a packet size and the number of packets to send. Packet sizes range from 1 to 2,000 bytes, with a default of 56 bytes. The actual packet size is eight bytes larger because the switch adds header information.

Following are sample results of the ping command:

• Normal response--The normal response occurs in one to ten seconds, depending on network traffic.

• Destination does not respond--If the host does not respond, a "no answer" message appears in ten seconds.

• Destination unreachable--The gateway given in the route table for this destination indicates that the destination is unreachable.

• Network or host unreachable--The switch did not find a corresponding entry in the route table.

quit Command

Use the quit command to quit the current admin. interface session, as follows:

reset Command

Use the reset command to reset the system. This command is available only in privileged mode.Following is a sample display:

set Commands

Table C-3 lists the set commands.

set alias

Use the set alias command to add shorthand versions of command invocations. The maximum number of aliases that can be defined is 20. The aliases listed in Table C-4 are predefined. Following is a sample display:

See also clear alias and show alias.

set arp

Use the set arp command to add ARP table entries. To add an ARP entry, use the command set arp ip_address hardware_address, where ip_address is the IP address to add, and hardware_address is the hardware address associated with the IP address. Following is a sample display:

See also clear arp and show arp.

set bridge help

Use the set bridge help command to show the following display in privileged mode:

set bridge ipx

As a normal function, the Catalyst 1200 series switch can forward Internetwork Packet Exchange (IPX) packets received on FDDI ports to Ethernet ports, or it can forward IPX packets received on Ethernet ports to FDDI ports. To do this, the switch must be configured for specific IPX protocol translations. By default, the following IPX protocol translations are configured:

• FDDI SNAP to Ethernet 802.3 RAW

• FDDI 802.2 to Ethernet 802.3

• Ethernet 802.3 RAW to FDDI SNAP

You can customize these settings if your environment requires it. Following is a sample display:

set bridge vlan

Use the set bridge vlan command to group ports into a bridge VLAN. This command is only available in privileged mode. The default setting is all ports (FDDI port 1 and Ethernet ports 3 through 10) in bridge VLAN 1. Following is a sample display:

set cam

Use the set cam command to add CAM table entries in the switch. CAM allows you to assign addresses to particular ports in the switch. Following is a sample display:

See also clear cam and show cam.

set cdp disable

Use the set cdp disable command to disable the Cisco MTU Discovery protocol.See the section "Maximum Transmission Unit (MTU) Discovery" in the chapter "Feature Configuration" for a detailed explanation. Following is a sample display:

See also show cdp.

set cdp enable

Use the set cdp enable command to set the Cisco MTU Discovery protocol variables. See the section "Maximum Transmission Unit (MTU) Discovery" in the chapter "Feature Configuration" for a detailed explanation. The default CDP variables are message interval every 30 seconds, enabled. Following is a sample display:

See also show cdp.

set cdp help

Use the set cdp help command to show the following message in privileged mode. Following is a sample display follows:

set cdp interval

Use the set cdp interval command to set the number of seconds between CDP messages. The interval can be specified by port. Following is a sample display:

set enablepass

Use the set enablepass command to change the privileged level password on the user interface. Following is a sample display:

set fddi alarm

Use the set fddi alarm command to set the LER-Alarm value. This value defines the link error rate (LER) at which a link connection exceeds a preset alarm threshold and is used in the link error rate threshold test. The default setting of 8 (10¯8) link errors per second is sufficient for most networks. Following is a sample display:

set fddi cam

Use the set fddi cam command to set the hardware CAM for filtering or forwarding. The default is enabled. Following is a sample display:

set fddi cutoff

Use the set fddi cutoff command to set the LER-Cutoff value. This value determines the link error rate (LER) at which a connection will be flagged as faulty. This value is used in the link error rate threshold test. The default setting of 7 (10¯ 7) is sufficient for most networks. Following is a sample display:

set fddi help

Use the set fddi help command to show the following message in privileged mode. Following is a sample display follows:

set fddi tlmin

Use the set fddi tlmin command to change the TL_MIN timer value for an FDDI port. The TL_MIN parameter sets the minimum time to transmit a Physical Layer Protocol (PHY) line state before advancing to the next physical connection management (PCM) state. This setting affects the station and switch interoperability and might hinder the implementation of FDDI repeaters. By default, the TL_MIN parameter is set to 40 microseconds. Following is a sample display:

set fddi tnotify

Use the set fddi tnotify command to change the TNotify timer value for an FDDI ring. The TNotify parameter sets the interval (in seconds) between neighbor notification frames. These frames are sent out to notify neighboring devices of FDDI module MAC addresses. The default setting (30 seconds) is usually sufficient. Following is a sample display:

set fddi treq

Use the set fddi treq command to change the TReq value for an FDDI ring.The TRequest parameter specifies the FDDI switch value for the Token Ring Timer (TRT) for negotiating the TRT with other stations. The TRT is used to control ring scheduling during normal operation and to detect and recover from serious ring error situations. When the TRT value expires, the station uses the TRequest value to negotiate with other stations for the lowest value. The default setting of 165,000 microseconds is sufficient for most networks.

Following is a sample display:

set fddi userdata

Use the set fddi userdata command to configure the user data string in the SMT MIB. It is only available in privileged mode. The default value is WorkGroup Stack. The user data string is useful for identifying the FDDI module or Catalyst 1200 series switch when using a management tool to configure and maintain an internetwork or when accessing the FDDI module remotely. The user data string can be a term identifying the function of the network node or the users connected to the network node. Following is a sample display:

set filter

Use the set filter command to selectively receive frames based on criteria other than source address, for example, frame contents, vendor code, or protocol type. Custom filtering operates after the frame is received (after a CAM reject/receive decision). It does not override the forwarding information in the CAM. See the section "Access Lists With Broadcast Suppression" in the chapter "Feature Configuration" for detailed configuration examples.

The filtering types are as follows:

• MAC layer address

• Vendor code

• Protocol type

• User defined access lists

• Broadcast and multicast packets

The set filter command sets the custom port filter variables used to allow access list filtering.

Following is a sample display:

The variables are as follows:

• macaddress, port _number mac _address permit | deny

• vendor, port_number vendor_id permit | deny

• protocol, port _number protocol_type permit | deny

• test port_number test_number offset value mask

• complex port_number expression

• broadcast port_number packets_per_second

Following is a sample display:

See also clear filter and show filter.

set help

Use the set help command to display all set commands and brief descriptions of their usage. Following is a sample display:

set interface

Use the set interface command to configure network interfaces by assigning network addresses, subnet masks, broadcast addresses, and destination addresses for FDDI, Ethernet, and SLIP interfaces. You can also use the set interface command to bring the interface up or down.

Following are the interface types:

• sc0 (SUM port)--Assign the Catalyst 1200 series switch IP address to this interface type.

• sl0--Use this interface type when configuring an SLIP connection on the switch.

• lo0--Use this interface type to configure an internal loopback for the switch.

• 1, 3 through 10--Use the port number to assign an IP address to a specific port. Port 1 is the FDDI port. Ports 3 through 10 are Ethernet ports. See the section "Virtual Network Services (VNS)" in the chapter "Feature Configuration" for a detailed IP address assignment description.

The interface defaults are:

• ip_address--0.0.0.0

• netmask--255.0.0.0

• broadcast--0.0.0.0

Following is a sample display:

Console> (enable) set interface

Usage: set interface <if_name|if_number> <ip_address> <net_mask> [broadcast_address]

set interface <if_name> <slip_address> <dest_address>

set interface <if_name|if_number> <up|down>

Console> (enable) set interface 4 192.200.0.44 255.255.255.0 192.200.0.255

Interface sc0 IP address, netmask and broadcast address set.

Console> (enable) set interface sl0 192.200.10.45 192.200.10.103

Interface sl0 IP address and netmask set

Console> (enable) set interface 5 up

Interface sc0 administratively up.

Console> (enable)

Changing the interface port setting to down has the following effects:

• All stations connected to that port through Telnet or ping sessions lose their connection

• Bridging and routing data originated by the station connected to the port are affected

• IP-routed traffic is blocked to the entire route group

See also show interface.

set ip alias

Use the set ip alias command to add aliases for IP addresses. An IP alias is a name you can assign to represent an IP address. You can define up to 50 aliases.

To set an IP alias, use set ip alias name ip_address, where name is the alias and ip_address is the IP address for which you are defining an alias. Following is a sample display:

See also clear ip and show ip.

set ip forwarding

Use the set ip forwarding command to enable or disable IP forwarding. The default is enabled. Following is a sample display:

set ip fragmentation

Use the set ip fragmentation command to enable or disable IP fragmentation on the switch. Following is a sample display:

set ip help

Use the set ip help command to show the help information in privileged mode. Following is a sample display:

See also clear ip.

set ip helper

Use the set ip helper command to set the helper IP address for a particular VLAN. Following is a sample display:

The values for this command are as follows:

• vlan--The number of the IP VLAN where the clients reside.

• helper_vlans--The number of the IP VLAN where the server resides.

set ip redirect

Use the set ip redirect command to enable or disable ICMP redirect messages for the entire Catalyst 1200 series switch. The default is ICMP redirect messages enabled. Following is a sample display:

set ip rip

Use the set ip rip command to enable or disable the IP RIP protocol for the entire Catalyst 1200 series switch. The default is RIP enabled. Following is a sample display:

set ip route

Use the set ip route command to add route table entries. The default metric value is 1. Following is a sample display:

set ip unreachable

Use the set ip unreachable command to enable or disable the ICMP unreachable message for the entire Catalyst 1200 series switch. The default is ICMP unreachable messages enabled. Following is a sample display:

set ip vlan

Use the set ip vlan command to group ports for IP routing protocols. All IP traffic is bridged within a VLAN and routed between VLANs. The VLAN ranges from 1 to 1000. The default is to have all ports in IP VLAN 1 for IP traffic. Following is a sample display:

Console> (enable) set ip vlan

Usage: set ip vlan <vlan> [ports] [<ip_address> <net_mask> [broadcast]]

(vlan = 1..1000,

an example of ports is 1,3-5,9)

Console> (enable) set ip vlan 1 3,7

IP-Vlan Ports IP-Address Netmask Broadcast Helper-VLANs

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

1 1,3-5,7 192.122.174.102 255.255.255.0 192.122.174.255 2

Console> (enable) set ip vlan 1 10 198.219.135.123 255.255.255.0

1,3-5,7,10: flags=863<UP,BROADCAST,RUNNING>

inet 198.219.135.123 netmask 255.255.255.0 broadcast 198.219.135.255

IP-Vlan Ports IP-Address Netmask Broadcast Helper-VLANs

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

1 1,3-5,7,10 198.219.135.123 255.255.255.0 198.219.135.255 2

Console> (enable)

set length

Use the set length command to set the maximum number of lines you want displayed on the terminal screen so that information does not scroll off the screen. A partial display ends with the following prompt:

At the prompt, press Ctrl-C to terminate the display, press the space bar to display the next full screen, or press the Return key to display the next line. Setting the value to 0 disables this feature. The default value is 100.

Following is a sample display:

set multicast agingtime

Use the set multicast agingtime command to set the IGMP aging time. The default IGMP aging is 180 seconds. Setting the value to 0 disables aging. Following is a sample display:

set multicast disable

Use the set multicast disable command to disable IGMP conditional filtering. The default is IGMP conditional filtering disabled. Following is a sample display:

set multicast enable

Use the set multicast enable command to enable IGMP conditional filtering. Following is a sample display:

set multicast group

Use the set multicast group command to configure multicast groups. The default is no multicast groups configured. Following is a sample display:

set multicast help

Use the set multicast help command to show the following display in privileged mode:

See also clear multicast and show multicast.

set multicast router

Use the set multicast route command to configure which ports have IP multicast routers. The default value for all ports is dynamic. Following is a sample display:

set password

Use the set password command to change the password on the admin. interface. The default is Return, no password configured. You must be in privileged mode to modify the password. A sample display follows:

set port disable

Use the set port disable command to disable a port. The default is enabled. Following is a sample display of a console port session:

Following is a sample display of a Telnet session:

set port enable

Use the set port enable command to enable or disable a port. The default is enabled. Following is a sample display:

set port help

Use the set port help command to display the following:

set port name

Use the set port name command to configure a name for a port. The default configuration has no port name configured for any port. If the name string is not specified, the port name is cleared. Following is a sample display:

set prompt

Use the set prompt command to change the administration interface prompt. Following is a sample display:

set snmp community

Use the set snmp community command to set one of the four SNMP community strings. The default is a read-only community of "public," a read-write community of "private," and a read-write-all community of "secret." Following is a sample display:

set snmp help

Use the set snmp help command to display the following:

See also clear snmp and show snmp.

set snmp rmon

Use the set snmp rmon command to enable or disable SNMP RMON support. The default is RMON enabled and RMON default_groups disabled. If the default_groups are enabled, the system starts collecting the statistics. Following is a sample display:

set snmp trap

Use the set snmp trap command to enable, disable, or add an entry in the SNMP trap receiver table. Following is a sample display:

set span

Use the set span command to allow individual port monitoring using SPAN. The variables are as follows:

• source_port-- The port number to be monitored.

• destination_port--The port number where the mirrored port data is to be redirected.

• [rx|tx|both]--Receive, transmit, or both.

• enable|disable--The default is disabled.

Following is a sample display:

See also show span.

set spantree disable

Use the set spantree disable command to disable the spanning tree algorithm for a bridge VLAN. The default configuration has all spanning tree disabled. If the VLAN parameter is not specified, the default is VLAN 1. Following is a sample display:

set spantree enable

Use the set spantree enable command to enable the spanning tree algorithm for a bridge VLAN. The default configuration has all spanning tree disabled. If the VLAN parameter is not specified, the default is VLAN 1. Following is a sample display:

set spantree fwddelay

Before a port is allowed to forward packets, it passes through three states: listening, learning, and forwarding. Use the set spantree fwddelay command to set the number of seconds that the bridge waits in each state before forwarding packets on a specific VLAN when a topology change has occurred. The default configuration has bridge forward delay set to 15 seconds for all VLANs. If the VLAN parameter is not specified, the default is VLAN 1.

Following is a sample display:

set spantree hello

Use the set spantree hello command to set the number of seconds that the switch waits before sending hello bridge protocol data units (BPDUs) for a bridge VLAN. The default configuration has hello time set to 2 seconds. If the VLAN parameter is not specified, the default is VLAN 1. Following is a sample display:

set spantree help

Use the set spantree help command to show the following display:

set spantree maxage

Use the set spantree maxage command to set the number of seconds that the bridge waits to receive a hello frame before it declares itself as root. The default configuration is 20 seconds. If the VLAN parameter is not specified, the default is VLAN 1. Following is a sample display:

set spantree portcost

Use the set spantree portcost command to set the bridge pathcost for a port. The default configuration is fddi port cost = 10, 100Mbps Ethernet port cost = 10, and 10BaseT Ethernet port cost = 100. Following is a sample display:

set spantree portpri

Use the set spantree portpri command to set the bridge priority for a port in Spanning Tree Algorithm. Setting the port priority on a trunk port affects all VLAN ports that are enabled to use the trunk port. The default configuration has all ports with bridge priority set to 128. Following is a sample display:

set spantree priority

Use the set spantree priority command to set the bridge priority for a bridge VLAN. The default configuration has priority set to 32,768. If the VLAN parameter is not specified, the default is VLAN 1. Following is a sample display:

set system baud

Use the set system baud command to set the console port baud rate. The default value is 9,600 baud. Following is a sample display:

set system contact

Use the set system contact command to set the system contact string. The default configuration has no system contact configured. If no contact_string is specified, the system contact is cleared. Following is a sample display:

set system help

Use the set system help command to show the following information in privileged mode:

set system location

Use the set system location command to set the system location string. The default is no name configured. If no location_string is specified, the system location is cleared. Following is a sample display:

set system modem

Use the set system modem command to enable or disable modem control lines on the console port. The default configuration has modem control lines disabled. Following is a sample display:

set system name

Use the set system name command to configure a name for the system. The default configuration has no system name configured. If no name_string is specified, the system name is cleared. Following is a sample display:

set time

User the set time command to change the time of day in the system clock. Following is a sample display:

See also show time.

set trunk

Use the set trunk command to configure an FDDI port to be at trunk link. By default, the FDDI port is not a trunk port. Subsequent calls to the set trunk command on a port that is already a trunk link adds, but does not replace, VLANs to the port.

If the transit encapsulation mode is selected, all VLANs supported through 802.10 encapsulation are cleared and the trunk port is removed from any IP VLAN or bridge VLAN. The default is FDDI port in translational bridging mode, in other words, the transit encapsulation is disabled. Following is a sample display:

See also clear trunk and show trunk.

show Commands

Table C-5 lists the show commands.

show alias

Use the show alias command to display the shorthand versions of admin. interface commands. The first five aliases are predefined. Following is a sample display:

See also clear alias and set alias.

show arp

Use the show arp command to display the ARP table entries that have been defined using the set arp command. Following is a sample display:

See also clear arp and set arp.

show bridge

Use the show bridge command to display bridge information that was set using the set bridge command. The show bridge optimization command displays bridge optimization values. Following is a sample display:

Following is a description of the display fields of the show bridge command:

• IP fragmentation enabled--The current configuration of the set ip fragmentation command.

• Default IPX translations:--The current configuration of the set ip alias command.

• Group--The bridge group number assigned to the ports.

• Ports--The ports assigned to the bridge group.

• Spanning tree enabled--The current configuration of the set spantree enable command.

• Designated Root--The unique bridge identifier of the bridge assumed to be the root.

• Designated Root Priority--The bridge identification priority field for the root bridge.

• Designated Root Cost--The cost of the path to the root from this bridge.

• Designated Root Port--The port identifier of the port that offers the lowest cost to the root bridge.

• Root Max Age--The age of a stored configuration message on the root bridge at which the stored configuration message is judged to be too old and is discarded.

• Root Hello Time--The elapsed time between the configuration messages generated by a bridge that assumes itself to be the root.

• Root Forward Delay--The time spent by a port in the listening and learning states.

• Bridge ID--The unique identifier of the bridge.

• Bridge ID Priority--A two-octet value that allows the network administrator to influence the choice of the root bridge and the designated bridge. This is the most significant portion of the bridge identifier.

• Bridge Max Age--The time value advertised by this bridge for deciding whether to discard spanning-tree frames based on message age.

• Bridge Hello Time--The time value advertised by this bridge for deciding the period between transmission of spanning-tree hello messages.

• Bridge Forward Delay--The time value advertised by this bridge for deciding the time delay that a port must spend in the listening and learning states.

• Port n field (where n is the port number 1 through 10). Following are the fields associated with each port field:

  • State--This can be any one the following five states: blocking, learning, listening, forwarding, or disabled.

  • Path Cost--A comparison between the contribution of the path through this port, when the port is the root port, and the total cost of the path to the root for this bridge.

  • Port Priority--A portion of the port identifier that can be updated by management action and is the most significant portion of the port identifier for that port.

show cam

Use the show cam all command to display the CAM table. Following is a sample display:

Following are descriptions of the display fields of the show cam command:

• Destination MAC Address--The destination MAC address in the packets to be bridged.

• Source Port--The switch port on which a bridged packet is received.

• Destination Port--The port to which the bridged packet is sent. The destination ports are given numerical designators as follows: 0 for an internal destination (packets destined for the switch SNMP agent, the spanning-tree agent, and so forth), 1 for FDDI ports, and 3 through 10 for Ethernet LAN ports.

• Protocol Type--The type of protocol for the source and destination ports.

Following is a sample display of the show cam mac_address command:

In the command show cam static [fddi] mac_addr srcport destports, FDDI indicates that the MAC address in the next parameter is in FDDI format instead of in canonical (Ethernet) format. The field Destination Port can be a list of one or more port numbers, separated by commas, spaces, or tabs.

See also clear cam and set cam.

show cdp

Use the show cdp command to display CDP information. Following is a sample display:

console> show cdp neighbors

Port Device-ID Port-ID Platform Capability

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

3 000100808(Catalyst7) 8 WS-C1201 R S

8 000100808(Catalyst7) 3 WS-C1201 R S

console> show cdp neighbors 3 detail

Device-ID: 000100808(Catalyst7)

Device Addresses:

IP Address: 210.1.1.1

Holdtime: 171 sec

Capabilities: ROUTER SWITCH

Version:

WS-C1201 Software, Version DmpSW: 3.142 NmpSW: 3.146

Copyright (c) 1994,1995 by Cisco Systems, Inc.

DMP S/W compiled on Dec 13 1994 09:15:19

NMP S/W compiled on Dec 20 1994 17:48:26

System Bootstrap Version: 1.0

Hardware Version: 3.118 Model: WS-C1201 Serial #: 000100808

1 FDDI interface

8 10BaseT interfaces

Uptime is 0 day, 15 hours, 50 minutes

Platform: WS-C1201

Port-ID (Port on Device): 8

Port (Our Port): 3

console> show cdp port

Port CDP Status Message-Interval

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

1 disable 30

3 enable 30

4 disable 30

5 disable 30

6 disable 30

7 disable 30

8 enable 30

9 disable 30

10 disable 30

Console> show cdp port 3

Port CDP Status Message-Interval

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

3 enable 30

Console>

See also set cdp disable.

show filter

Use the show filter command to display custom filtering information. Following is a sample display:

show help

Use the show help command to describe each show command. Following is a sample display in normal mode:

Following is a sample display in privileged mode:

See also clear help and set help.

show interface

Use the show interface command to display each network interface and the interface status. Following is a sample display:

See also set interface.

show ip

Use the show ip command to display the IP Information. Use the show ip alias command to show aliases of the IP addresses. Use the show ip route command to show route table entries and the total number of route table entries. Use the show ip vlan command to show IP routing information. Following is a sample display:

Console> (enable) show ip

Commands:

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

show ip alias Show aliases for IP Addresses

show ip route Show IP route table

show ip vlan Show IP Virtual LAN information

Console> (enable) show ip alias

elvis 192.122.174.11

mercury 192.122.174.234

neptune 198.211.203.44

venus 198.211.203.73

Console> (enable) show ip route

Total Route table entries: 3

DESTINATION GATEWAY FLAG METRIC AGE INTERFACE

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

0.0.0.0 198.219.135.40 UG 1 0 1,3,7,9

198.219.135.0 198.219.135.123 U 0 0 1,3,7,9

176.201.0.0 176.201.39.10 U 0 0 4-6,8,10

Console> (enable) show ip route 198.219.133.40

DESTINATION GATEWAY FLAGS METRIC AGE INTERFACE

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

0.0.0.0 198.219.135.40 UG 1 0 1,3,7,9

Console> (enable) show ip vlan

Forwarding Fragmentation Redirect RIP Unreachable

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

enabled enabled enabled enabled enabled

IP-Vlan Ports IP-Address Netmask Broadcast Helper-VLANs

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

1 1,3-5,7,10 198.219.135.123 255.255.255.0 198.219.135.255 2

2 6,8,9 193.122.174.102 255.255.255.0 193.122.174.255

Console> (enable)

See also clear ip and set ip help.

show log

Use the show log command to display the system error log. Following is a sample display:

See also clear log.

show mac

Use the show mac command to display parameters for the MAC layer Network Management Protocol (NMP) software contents for each port switch. Following is a sample display:

Console> show mac help

Commands:

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

show mac Show MAC information

Console> show mac

MAC SMT-Address Curr-Path TReq TNeg TMax TVX

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

1 00-40-0b-80-e0-78 primary 165000 10000 167772 2621

MAC Upstream-Nbr Downstream-Nbr Old-Upstream-Nbr Old-Downstream-Nbr

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

1 00-40-0b-40-00-68 00-40-0b-40-00-80 00-40-0b-40-10-63 00-40-0b-40-80-44

MAC Rcv-Smt Xmit-Smt Rcv-llc Xmit-llc Tvx-Exp-Ct RingOp-Ct

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

1 274 14 180 465 5 5

MAC Rcv-Frms Xmit-Frms Rcv-Multi Xmit-Multi Rcv-Broad Xmit-Broad

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

1 1748680 20904 20473 20 14099 736

3 0 1380230 0 4319 0 12010

4 0 1380231 0 4319 0 12010

5 0 1380232 0 4319 0 12010

6 0 1380232 0 4319 0 12010

7 15784 1395152 0 4319 296 11714

8 0 1380236 0 4319 0 12010

9 2289 1379656 12 4307 2 12008

10 0 1380238 0 4319 0 12010

MAC Dely-Exced MTU-Exceed In-Discard Lrn-Discrd In-Lost Out-Lost

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

1 0 55 0 0 0 0

3 0 0 0 0 0 0

4 0 0 0 0 0 0

5 0 0 0 0 0 0

6 0 0 0 0 0 0

7 0 0 0 0 0 0

8 0 0 0 0 0 0

9 0 0 0 0 0 0

10 0 0 0 0 0 0

Last-Time-Cleared

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

Wed Jun 02 1993, 18:28:46

Following are descriptions of the display fields of the show mac command:

• MAC--Indicates which MAC is being referenced by the data in the other fields.

• SMT-Address--Displays the 48-bit MAC address in canonical format (for example 00:40:0b:a0:03:cf).

• Curr-Path--Indicates the current path handled by the MAC, and takes one of the following values:

  • Primary--The MAC is on the primary path.

  • Isolated--The MAC is not on any path but is isolated.

  • Unknown--The switch cannot determine the path.

• TReq--Shows the time (in microseconds) that the MAC requests as the average token rotation time. You can configure this parameter with the admin. interface set treq command.

• TNeg--Contains the TReq value agreed on by all MACs in the ring.

• TMax--Holds the maximum time (in microseconds) that the MAC sends out as a TReq value.

• TVX--Contains the time (in microseconds) of the MAC valid transmission timer.

• Upstream-Nbr--Contains the address of the most recently known upstream neighbor to the MAC.

• Downstream-Nbr--Contains the address of the most recently known downstream neighbor to the MAC, the next MAC to receive frames from this MAC.

• Old-Upstream-Nbr--Contains the MAC address of the previous upstream neighbor.

• Old-Downstream-Nbr--Contains the MAC address of the previous downstream neighbor.

• Rcv-Smt--Shows the total number of SMT frames received by the MAC.

• Xmit-Smt--Shows the total number of SMT frames transmitted by the MAC.

• Rcv-llc--Shows the total number of Logical Link Control (LLC) frames received by the MAC.

• Xmit-llc--Shows the total number of LLC frames transmitted by the MAC.

• Tvx-Exp-Ct--Displays the number of valid transmission timer (TVX) expirations counted by the MAC.

• RingOp-Ct--Shows the number of times that the ring has encountered a break and has restarted.

• Rcv-Frms--Shows the total number of frames received by the MAC.

• Xmit-Frms--Shows the total number of frames transmitted by the MAC.

• Rcv-Multi--Shows the total number of multicast frames received by the MAC.

• Xmit-Multi--Shows the total number of multicast frames transmitted by the MAC.

• Rcv-Broad--Shows the total number of broadcast frames received by the MAC.

• Xmit-Broad--Shows the total number of broadcast frames transmitted by the MAC.

• Dely-Exced--Shows the number of frames discarded by this port because of excessive transmission delay through the bridge.

• MTU-Exceed--Shows the number of frames discarded by this port because the maximum frame size or MTU has been exceeded.

• In-Discard--Shows the number of valid frames received by this port that were discarded (filtered) by the forwarding process.

• Lrn-Discard--Shows the number of forwarding database entries that have been or would have been learned but have been discarded because of lack of space.

• Last-Time-Cleared--Displays the date and time that the MAC counters were last cleared.

• In-Lost--Displays the number of received frames dropped by the MAC because of hardware limitations.

• Out-Lost--Displays the number of transmit frames dropped by the MAC because of hardware limitations.

show macdbg

Use the show macdbg command to display the MAC debug hardware counter information. Following is a sample display:

Following are descriptions of the display fields of the show macdbg command:

• MAC--Displays the MAC number.

• Rcv-Frms--Displays the receive frames at the MAC.

• Xmit-Frms--Displays the transmit frames at the MAC.

• Error-Frms--Displays the error frames at the MAC.

• Lost Frms--Displays the lost frames at the MAC.

• Total-Frms--Displays the total frames at the MAC.

• Bfr-Frms--Displays the buffer frames at the MAC.

• TMax-Cap--The target token rotation number (TTRT) TMax capability displays the maximum time value this MAC can support.

• TVX-Cap--The timer valid transmission (TVX) capability displays the maximum time value this MAC can support.

• FS-Cap--The frame status (F5) capability displays the optional frame status functions supported.

• Avl-Path--Displays the available (Avl) paths.

• Rq-Path--Displays the requested (Rq) paths.

• DA-Test--Displays the status of the duplicate address (DA) tests as pass or fail.

• DA-Flg--Displays the status of the DA flag as true or false.

• Frm-Mac-Flg--Displays MAC frame error flag condition setting as true or false.

show macreg

Use the show macreg command to display the MAC registers. Following is a sample display:

show macstatus

Use the show macstatus command to display the FDDI MAC status register history. Following is a sample display:

Following are descriptions of the display fields of the show macstatus command:

• Index--Displays the time index of the last 20 MAC status register history.

• ST1U--Displays the upper-level address of status register one.

• ST1L--Displays the lower-level address of status register one.

• ST2U--Displays the upper-level address status register two.

• ST2L--Displays the lower-level address status register two.

show mbuf

Use the show mbuf command to display mbuf and malloc statistics. Following is a sample display:

Following are descriptions of the display fields of the show mbuf command:

• MBSTATS--Displays the memory buffer status.

• MALLOC STATS--Displays the memory allocation status.

• Fram Buffer STATS--Displays the frame buffer status.

• IPC QUEUE STATS--Displays the Inter Processor Communications queue status.

show multicast

Use the show multicast command to display IP multicast information. Following is a sample display:

See also set multicast group.

show netstat

Use the show netstat command to display the TCP/IP protocol stack statistics and the state of the network connections that are active on the system. Following is a sample display:

show port

Use the show port command to display port information. Following is a sample display:

Console> (enable) show port

Port Name Status Curr-Path Conn-State Type Neigh Media

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

1A disabled isolated disabled A M fiber

2B disabled isolated disabled B U fiber

Port Ler-Cond Ler-Est Ler-Alrm Ler-Cutoff Lem-Ct Lem-Rej-Ct tl-min

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

1A false 10 10 10 0 0 40

2B false 9 8 7 0 0 40

Port Duplex

---- ------

1A full

2B full

Port Name Status Align-Err FCS-Err Xmit-Err Rcv-Err

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

3 notconnect 0 0 0 0

4 notconnect 0 0 0 0

5 notconnect 0 0 0 0

6 notconnect 0 0 0 0

7 notconnect 0 0 0 0

8 notconnect 0 0 0 0

9 notconnect 0 0 0 0

10 notconnect 0 0 0 0

Port Single-Col Multi-Coll Late-Coll Excess-Col Carrier-Sense Giants

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

3 0 0 0 0 0 0

4 0 0 0 0 0 0

5 0 0 0 0 0 0

6 0 0 0 0 0 0

7 0 0 0 0 0 0

8 0 0 0 0 0 0

9 0 0 0 0 0 0

10 0 0 0 0 0 0

Port Duplex

---- ------

3 half

4 half

5 half

6 half

7 half

8 half

9 half

10 half

Last-Time-Cleared

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

Sun Oct 29 1995, 16:37:58

Console> (enable)

The show port command screen has two sections: one for the CDDI/FDDI ports and one for the Ethernet ports. Following are descriptions of the display fields of the show port command:

• Port--Displays the port number (1/A or 2/B for CDDI/FDDI, and 3 through 10 for Ethernet).

• Name--Contains the name of the designated port, and displays only if you have given the port a name using the set portname command.

• Status--Shows the port status as one of the following:

  • Ok--The port is connected. The link status LED is green.

  • Minor--A signal is detected, but the port is not connected. The link status LED is orange.

  • Monitor--The port is configured as destination port using the set span command.

  • Other--The port is not connected.

• Curr-Path--Shows the connection state of the port as follows:

  • Isolated--The port is not connected.

  • Primary--The port is inserted in the primary path.

  • Concatenated--The port is inserted in both the primary and secondary paths in a concatenated wrap configuration.

  • Thru--The port is inserted in both the primary and secondary paths in a thru configuration.

• Conn-State--Displays the connection state of the port as follows:

  • Disabled--The port has no line module or was disabled by the user.

  • Connecting--The port is attempting to connect or is disconnected.

  • Standby--The connection is withheld or is the inactive port of a dual homing switch.

  • Active--The port has made connection.

  • Other--The switch is unable to determine the connection state.

• Type--Specifies the type of port as one of the following values:

  • A--A port

  • B--B port

  • U--Undetermined

• Neigh--Indicates the type of port attached to this port (called the neighbor port). The neighbor port can be one of the following types:

  • A--A port

  • B--B port

  • S--Slave port

  • M--Master port

  • U--Undetermined port

• Media--Indicates the media capabilities of the indicated port as follows:

  • mlt-3--The port uses MLT-3 (CDDI) media.

  • fiber--The port uses FDDI fiber-optic cable.

  • none--This port cannot be used because it is missing a line module card (an internal plug-in circuit board).

• Ler-Cond--Shows the link error rate indicator field as either true (an error condition exists on the link) or false (no error conditions exist on the link).

• Ler-Est--Refers to the long-term estimated error rate for the link. The value displayed in this field is the exponent of 10-n. For example, if the indicated value is 11, the estimated error rate is 10-11; thus, the higher the value of the exponent, the lower the number and the better the link error rate. Values range from 10-4 to 10-12.

• Ler-Alrm--Contains the error rate for the link that generates an alarm. The default is 10-8. The value displayed in this field is the exponent of 10-n.

• Ler-Cutoff--Contains the error rate for the link that disables the port. The default is 10-7. The value displayed in this field is the exponent of 10-n.

• Lem-Ct--Holds the link error monitor count, which is the number of recorded link errors received. This count is used to estimate the link error rate (Ler-Est). The link error monitor helps measure link performance and isolate faulty links that pass initial tests.

• Lem-Rej-Ct--Contains the link error monitor rejected count, which is the number of times a link was disabled because the link error rate reached the cutoff threshold.

• Port--Displays the 10BaseT ports numbered 3 through 10.

• Name--Contains the name of the designated port. A name is displayed only if you assigned a name using the set portname command.

• Status--Indicates the relative condition of the port as one of the following:

  • Ok--The port has connection. The link status LED is green.

  • Other--The port is not connected.

  • Disable--The port is disabled.

• Align-Err--Shows the number of frames received on this port that are not an integral number of octets in length and do not pass the frame checksum (FCS) check.

• FCS-Err--Shows the number of frames received on this port that are an integral number of octets in length, but do not pass the FCS check.

• Xmit-Err--Shows the number of frames for which transmission failed on this port because of an internal MAC-sublayer transmit error.

• Rcv-Err--Shows the number of frames for which reception failed on this port because of an internal MAC-sublayer receive error.

• Single-Col--Shows the number of frames successfully transmitted on this port for which transmission is inhibited by one collision.

• Multi-Coll--Shows the number of frames successfully transmitted on this port for which transmission is inhibited by more than one collision.

• Late-Coll--Shows the number of times a collision is detected on this port later than 512 bit times into the transmission of a packet.

• Excess-Col--Shows the number of frames for which transmission on this port failed because of excessive collisions.

• Carrier-Sense--Shows the number of times the carrier-sense condition was lost or never asserted when attempting to transmit a packet on this port.

• Giants--Shows the number of frames received on this port that exceeded the maximum permitted frame size.

• Last-Time-Cleared--Displays the date and time that the port counters were last cleared.

See also set port help.

show portreg

Use the show portreg command to display port register information. Following is a sample display:

show snmp

Use the show snmp command to display SNMP and IP information. Following is a sample display in normal mode:

Following is a sample display in privileged mode:

Following are the descriptions of the display fields of the show snmp command:

• Community-Access--Lists the access modes for the SNMP MIB.

• Community-String--Shows the authentication string that all SNMP messages must contain for the type of MIB access requested.

• Trap-Rec-Address--Contains the address of a network manager to whom trap messages are sent.

• Trap-Rec-Community--Contains the community string for the trap message.

• Auth Traps --Indicates whether authentication trap messages are enabled or disabled.

• RMON--Indicates whether RMON is enabled or disabled.

show span

Use the show span command to display port monitoring information. Following is a sample display:

See also set span.

show spantree

Use the show spantree command to display spanning tree information for a VLAN. If the vlan parameter is not specified, the default is VLAN1. Following is a sample display:

Following are descriptions of the display fields of the show spantree command:

• Spanning tree enabled--The current configuration of the set spantree enable command.

• Designated Root--The unique bridge identifier of the bridge assumed to be the current root bridge.

• Designated Root Priority--The bridge identification priority field for the root bridge.

• Designated Root Cost--The cost of the path to the root from this bridge.

• Designated Root Port--The port identifier of the port that offers the lowest cost to the root bridge.

• Root Max Age--The age of a stored configuration message on the root bridge at which the stored configuration message is judged to be too old and is discarded.

• Root Hello Time--The elapsed time between the configuration messages generated by a bridge that assumes itself to be the root.

• Root Forward Delay--The time spent by a port in the listening and learning states.

• Bridge ID--The unique identifier of the bridge.

• Bridge ID Priority--A two-octet value that allows the network administrator to influence the choice of the root bridge and the designated bridge. This is the most significant portion of the bridge identifier.

• Bridge Max Age--The time value advertised by this bridge for deciding whether to discard spanning-tree frames based on message age.

• Bridge Hello Time--The time value advertised by this bridge for deciding the period between transmission of spanning-tree hello messages.

• Bridge Forward Delay--The time value advertised by this bridge for deciding the time delay that a port must spend in the listening and learning states.

• Port n field (where n is port number 1 through 10). Following are the fields associated with each port field:

  • State--This can be any one the following five states: blocking, learning, listening, forwarding, or disabled.

  • Path Cost--A comparison between the contribution of the path through this port, when the port is the root port, and the total cost of the path to the root for this bridge.

  • Port Priority--A portion of the port identifier that can be updated by management action and is the most significant portion of the port identifier for that port.

show system

Use the show system command to display system information. Following is a sample display:

Following are descriptions of the display fields of the show system command:

• Name--The switch name, which displays only if you have named the switch using the admin. interface set name command.

• Model--The model designation of the switch.

• Serial-Num--The serial number of the switch.

• Hw and Fw--The hardware and firmware revision levels in the switch.

• DmpSw--The software revision level of the DMP.

• NmpSw--The software revision level of the NMP.

• Ps-Type--The rating of the power supply in watts.

• Ps-Status--The current status of the power supply as follows:

  • Ok--No faults or power supply alarms have been detected.

  • Major--Occurs when -5V, +12V, or -12V is bad. The field displays Major, followed by a hexadecimal translation of the power supply test result bit map, as shown in Table C-6.

  • Other--Indicates that the switch is unable to determine the power supply state.

show test

Use the show test command to display the results of the diagnostics tests. Following is a sample display:

show time

Use the show time command to display the current time of day on in the system's clock. Following is a sample display:

See also set time.

show trunk

Use the show trunk command to display trunk link information. If the transitencapsulation mode is on, then this command indicates "None (transit encapsulation)" under the "VLANs allowed" heading. Following is a sample display:

See also clear trunk and set trunk

show users

Use the show users command to display the admin. port status and list active Telnet sessions with the IP address or IP alias of the originating host. Following is a sample display:

show version

Use the show version command to display the Catalyst Switch hardware and software version numbers. Following is a sample display:

slip Command

Use the slip command to attach or detach a SLIP interface, as follows:

test Command

Table C-7 lists the available test commands in privileged mode.

test help

Use the test help command to display the following information:

test online

Use the test online command to run diagnostics tests on the system, as follows:

test snmp

Use the test snmp command to send an SNMP trap message to the trap receivers. The following is a sample display:

upload Command

Use the upload command to upload the Flash memory image file from the catalyst to a network host to create a backup file. The file must be created in advance and saved in the tftpboot directory.

Following is a sample display:

wait Command

Use the wait command to pause the console output for the number of seconds indicated. Following is a sample display:

write Command

Use the write command to write the Catalyst 1200 series switch configuration either to an existing file in a network host tftpboot directory or to the terminal screen display.

Use the ASCII configuration file uploaded by the write terminal command to configure the same switch or edit to configure another Catalyst Switch. (See the section "configure Command," earlier in this appendix.) The uploaded file is the same output as the file generated by the write terminal command, with the following exceptions:

• The configuration file should end with a single line containing the word "end" followed by a carriage return.

• Passwords are saved in the configuration file as clear text and do not echo on the screen.

• A blank line should follow the set password and set enablepass commands, assuming no password is to be configured.

• A blank line should follow each occurrence of the following command line:

  • set port port disable

The blank line is needed to display the confirmation prompt with the no default. When these commands are called from a Telnet session, they are not executed because they may disconnect the Telnet session. It is recommended that you execute the configure command from the EIA/TIA-232 connection, not from a Telnet session.

• A set attach command type change made from a configuration file is set, but the switch must be reset for the attachment type change to be implemented.

The write terminal command functions the same as the copy command. Refer to the "copy Command" section for information about this command.

Following is a sample display: