Catalyst 6500 Series Switch Command Reference

1 Years of networking experience: Years of experience with Cisco products:

2 I have these network types: LAN Backbone WAN

Other:

3 I have these Cisco products: Switches Routers Other (specify models):

4 I perform these types of tasks: H/W installation and/or maintenance S/W configuration Network management Other:

5 I use these types of documentation: H/W installation H/W configuration S/W configuration Command reference Quick reference Release notes Online help Other:

6 I access this information through: % Cisco.com % CD-ROM % Printed manuals % Other:

7 I prefer this access method: Cisco.com CD-ROM Printed manuals Other:

8 I use the following three product features the most:

Document Information

Document Title: Catalyst 6500 Series Switch Command Reference

Part Number: OL-8977-01 S/W Release (if applicable): 8.6 On a scale of 1–5 (5 being the best), please let us know how we rate in the following areas:

The document is complete. The information is accurate.

The information is well organized. The information I wanted was easy to find. The document is written at my

technical level of understanding.

The information I found was useful to my job.

Please comment on our lowest scores:

Mailing Information

Organization Date

Contact Name Mailing Address

City State/Province Zip/Postal Code

Country Phone ( ) Extension

Corporate Headquarters

Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA

http://www.cisco.com Tel: 408 526-4000

800 553-NETS (6387) Fax: 408 526-4100

Catalyst 6500 Series Switch

Command Reference

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS. THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.

NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT

LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

CCVP, the Cisco Logo, and the Cisco Square Bridge logo are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn is a service mark of Cisco Systems, Inc.; and Access Registrar, Aironet, BPX, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, Follow Me Browsing, FormShare, GigaDrive, GigaStack, HomeLink, Internet Quotient, IOS, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, iQuick Study, LightStream, Linksys, MeetingPlace, MGX, Networking Academy, Network Registrar, Packet, PIX, ProConnect, RateMUX, ScriptShare, SlideCast, SMARTnet, StackWise, The Fastest Way to Increase Your Internet Quotient, and TransPath are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.

All other trademarks mentioned in this document or Website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0609R)

Catalyst 6500 Series Switch Command Reference

C O N T E N T S

Preface

Audience

Organization

Related Documentation

Conventions

Obtaining Documentation

Cisco.com

Product Documentation DVD

Ordering Documentation

Documentation Feedback

Cisco Product Security Overview

Reporting Security Problems in Cisco Products

Obtaining Technical Assistance

Cisco Technical Support & Documentation Website

Submitting a Service Request

Definitions of Service Request Severity

Obtaining Additional Publications and Information

C H A P T E R 1

Command-Line Interfaces

Switch CLI

Accessing the Switch CLI

Operating the Switch CLI

Using the CLI String Search

ROM Monitor CLI

Accessing the ROM Monitor CLI

Operating the ROM Monitor CLI

C H A P T E R 2

Catalyst 6500 Series Switch and ROM Monitor Commands

alias

boot

clear alias

clear arp

clear autoshut

clear banner motd

clear boot auto-config

clear boot device

clear boot system

clear cam

clear cam monitor

clear cam notification

clear channel statistics

clear config

clear config checkpoint

clear config pvlan

clear cops

clear counters

clear crypto key rsa

clear dhcp-snooping bindings

clear dhcp-snooping statistics

clear diagnostic

clear dot1x config

clear dot1x vlan-group

clear eou

clear ethernet-cfm

clear ftp

clear gmrp statistics

clear gvrp statistics

clear igmp statistics

clear ip alias

clear ip dns domain

clear ip dns server

clear kerberos creds

clear kerberos realm

clear kerberos server

clear key config-key

clear l2protocol-tunnel cos

clear l2protocol-tunnel statistics

clear lacp-channel statistics

clear lda

clear localuser

clear log

clear log command

clear logging buffer

clear logging callhome

clear logging callhome from

clear logging callhome reply-to

clear logging callhome severity

clear logging callhome smtp-server

clear logging level

clear logging server

clear macro

clear mls cef

clear mls cef rpf statistics

clear mls entry

clear mls entry cef

clear mls exclude protocol

clear mls multicast statistics

clear mls nde

clear mls nde flow

clear mls statistics

clear mls statistics entry

clear module password

clear msfcautostate

clear multicast router

clear pbf

clear packet-capture

clear pbf arp-inspection

clear pbf client

clear pbf gw

clear pbf-map

clear pbf vlan

clear policy

clear port broadcast

clear port cops

clear port eou

clear port ethernet-cfm

clear port ethernet-oam

clear port flexlink

clear port host

clear port qos autoqos

clear port qos cos

clear port security

clear port vlan-mapping

clear port web-auth

clear pvlan mapping

clear qos acl

clear qos autoqos

clear qos config

clear qos cos-cos-map

clear qos cos-dscp-map

clear qos dscp-cos-map

clear qos dscp-mutation-map

clear qos dscp-mutation-table-map

clear qos ipprec-dscp-map

clear qos mac-cos

clear radius

clear rcp

clear rgmp statistics

clear security acl

clear security acl capture-ports

clear security acl counters

clear security acl cram

clear security acl log flow

clear security acl map

clear security acl statistics

clear snmp access

clear snmp access-list

clear snmp community

clear snmp community-ext

clear snmp group

clear snmp ifalias

clear snmp inform

clear snmp notify

clear snmp targetaddr

clear snmp targetparams

clear snmp trap

clear snmp user

clear snmp view

clear spantree detected-protocols

clear spantree mst

clear spantree portcost

clear spantree portinstancecost

clear spantree portinstancepri

clear spantree portpri

clear spantree portvlancost

clear spantree portvlanpri

clear spantree root

clear spantree statistics

clear system info-log command

clear system profile

clear tacacs key

clear tacacs server

clear timezone

clear top

clear trunk

clear vlan

clear vlan counters

clear vlan mapping

clear vmps rcp

clear vmps server

clear vmps statistics

clear vtp pruneeligible

clear vtp statistics

clear web-auth

commit

commit lda

configure

confreg

context

copy

delete

dev

diagnostic start

diagnostic stop

dir—ROM monitor

dir—switch

disable

disconnect

download

history—ROM monitor

history—switch

l2trace

meminfo

ping

ping ethernet

pwd

quit

reconfirm vmps

reload

repeat

reset—ROM monitor

reset—switch

restore counters

rollback

session

set

set accounting commands

set accounting connect

set accounting exec

set accounting suppress

set accounting system

set accounting update

set acllog ratelimit

set acl mac-packet-classify

set alias

set arp

set authentication enable

set authentication login

set authorization commands

set authorization enable

set authorization exec

set autoshut

set banner telnet

set boot auto-config

set boot config-register

set boot config-register auto-config

set boot device

set boot sync now

set boot sync timer

set boot system flash

set cam

set cam monitor

set cam notification

set cdp

set channelprotocol

set channel vlancost

set config acl nvram

set config checkpoint

set config mode

set config rollback

set cops

set crypto key rsa

set default portstatus

set dhcp-snooping

set diagnostic bootup level

set diagnostic diagfail-action

set diagnostic event-log size

set diagnostic monitor

set diagnostic ondemand

set diagnostic schedule

set dot1q-all-tagged

set dot1x

set enablepass

set eou logging

set eou max-retry

set eou radius-accounting

set eou rate-limit

set eou revalidate

set eou timeout

set errdisable-timeout

set errordetection

set ethernet-cfm

set ethernet-cfm continuity-check

set ethernet-cfm continuity-check level

set ethernet-cfm domain

set ethernet-cfm ping-reply

set ethernet-cfm vlan

set fan-tray-version

set feature agg-link-partner

set feature mdg

set firewall

set ftp

set garp timer

set gmrp

set gmrp fwdall

set gmrp registration

set gmrp timer

set gvrp

set gvrp applicant

set gvrp dynamic-vlan-creation

set gvrp registration

set gvrp timer

set igmp

set igmp fastblock

set igmp fastleave

set igmp flooding

set igmp querier

set igmp v3-processing

set image-verification

set inlinepower

set interface

set ip alias

set ip dns

set ip dns domain

set ip dns server

set ip fragmentation

set ip http port

set ip http server

set ip permit

set ip redirect

set ip route

set ip telnet server

set ip unreachable

set kerberos clients mandatory

set kerberos credentials forward

set kerberos local-realm

set kerberos realm

set kerberos server

set kerberos srvtab entry

set kerberos srvtab remote

set key config-key

set l2protocol-tunnel cos

set l2protocol-tunnel trunk

set lacp-channel system-priority

set lcperroraction

set lda

set length

set logging callhome from

set logging callhome reply-to

set logging callhome severity

set logging callhome smtp-server

set logging console

set logging history

set logging level

set logging server

set logging session

set logging telnet

set logging timestamp

set logout

set mac-auth-bypass

set macro

set macro ciscosmartports

set mls agingtime

set mls bridged-flow-statistics

set mls cef load-balance

set mls cef maximum-routes

set mls cef per-prefix-statistics

set mls exclude protocol

set mls flow

set mls nde

set mls netflow-entry-create

set mls netflow-per-interface

set mls rate

set mls statistics protocol

set mls verify

set module

set module autoshut

set module name

set module power

set module shutdown

set multicast ratelimit

set multicast router

set ntp broadcastclient

set ntp broadcastdelay

set ntp client

set ntp server

set ntp summertime

set ntp timezone

set packet-capture

set packet-capture dump-file

set packet-capture filter

set packet-capture limit

set packet-capture snap-length

set password

set pbf

set pbf arp-inspection

set pbf client

set pbf gw

set pbf-map

set pbf vlan

set policy

set poll

set port arp-inspection

set port auto-mdix

set port auxiliaryvlan

set port broadcast

set port channel

set port cops

set port critical

set port debounce

set port description

set port dot1qtunnel

set port dot1x

set port duplex

set port enable

set port eou

set port errdisable-timeout

set port errordetection

set port ethernet-cfm

set port ethernet-oam

set port ethernet-oam action

set port ethernet-oam link-monitor

set port ethernet-oam mode

set port ethernet-oam remote-loopback

set port flexlink

set port flowcontrol

set port gmrp

set port gvrp

set port host

set port inlinepower

set port jumbo

set port l2protocol-tunnel

set port lacp-channel

set port mac-auth-bypass

set port macro

set port membership

set port name

set port negotiation

set port protocol

set port qos

set port qos autoqos

set port qos cos

set port qos policy-source

set port qos trust

set port rsvp dsbm-election

set port security

set port security-acl

set port speed

set port sync-restart-delay

set port trap

set port unicast-flood

set port vlan-mapping

set port voice interface dhcp

set port vtp

set port web-auth

set port web-auth initialize

set power redundancy

set prompt

set protocolfilter

set pvlan

set pvlan mapping

set qos

set qos acl default-action

set qos acl ip

set qos acl ipx

set qos acl mac

set qos acl map

set qos autoqos

set qos bridged-microflow-policing

set qos cos-cos-map

set qos cos-dscp-map

set qos drop-threshold

set qos dscp-cos-map

set qos dscp-mutation-map

set qos dscp-mutation-table-map

set qos policed-dscp-map

set qos policer

set qos policy-source

set qos rsvp

set qos rxq-ratio

set qos statistics export

set qos statistics export aggregate

set qos statistics export destination

set qos statistics export interval

set qos statistics export port

set qos txq-ratio

set qos wred

set qos wrr

set radius attribute

set radius auto-initialize

set radius deadtime

set radius keepalive

set radius key

set radius retransmit

set radius server

set radius timeout

set rate-limit

set rcp username

set rgmp

set rspan

set security acl adjacency

set security acl arp-inspection

set security acl capture-ports

set security acl cram

set security acl feature ratelimit

set security acl ip

set security acl ipx

set security acl log

set security acl statistics

set snmp

set snmp access

set snmp access-list

set snmp buffer

set snmp chassis-alias

set snmp community

set snmp community-ext

set snmp extendedrmon netflow

set snmp group

set snmp ifalias

set snmp inform

set snmp notify

set snmp rmon

set snmp rmonmemory

set snmp targetaddr

set snmp targetparams

set snmp trap

set snmp user

set snmp view

set span

set spantree backbonefast

set spantree bpdu-filter

set spantree bpdu-guard

set spantree bpdu-skewing

set spantree channelcost

set spantree channelvlancost

set spantree defaultcostmode

set spantree disable

set spantree enable

set spantree fwddelay

set spantree macreduction

set spantree maxage

set spantree mode

set spantree mst

set spantree mst config

set spantree mst link-type

set spantree mst maxhops

set spantree mst vlan

set spantree portcost

set spantree portfast

set spantree portfast bpdu-filter

set spantree portfast bpdu-guard

set spantree portinstancecost

set spantree portinstancepri

set spantree portpri

set spantree portvlancost

set spantree portvlanpri

set spantree priority

set spantree root

set spantree uplinkfast

set ssh mode

set summertime

set system baud

set system contact

set system core-dump

set system core-file

set system countrycode

set system crashinfo

set system crossbar-fallback

set system highavailability

set system highavailability versioning

set system info-log

set system location

set system profile

set system supervisor-update

set system switchmode allow

set system syslog-dump

set system syslog-file

set tacacs attempts

set tacacs directedrequest

set tacacs key

set tacacs server

set tacacs timeout

set test diagfail-action

set test diaglevel

set time

set timezone

set traffic monitor

set transceiver-monitoring

set trunk

set udld

set udld aggressive-mode

set udld interval

set vlan

set vlan mapping

set vlan verify-port-provisioning

set vmps config-file

set vmps downloadmethod

set vmps downloadserver

set vmps server

set vmps state

set vtp

set vtp pruneeligible

set web-auth

set web-auth session-timeout

show accounting

show acllog

show acl mac-packet-classify

show aclmerge algo

show alias

show arp

show authentication

show authorization

show autoshut

show banner

show boot

show boot device

show cam

show cam agingtime

show cam count

show cam monitor

show cam msfc

show cam notification

show cdp

show channel

show channel group

show channel hash

show channel mac

show channelprotocol

show channel traffic

show config

show config checkpoints

show config differences

show config mode

show config qos acl

show cops

show counters

show dhcp-snooping bindings

show dhcp-snooping config

show dhcp-snooping statistics

show diagnostic

show dot1q-all-tagged

show dot1x

show dvlan statistics

show environment

show eou

show errdisable-timeout

show errordetection

show ethernet-cfm continuity-check statistics

show ethernet-cfm domain

show ethernet-cfm errors

show ethernet-cfm maintenance-point

show ethernet-cfm status

show fabric channel

show fabric errors

show fabric status

show file

show firewall

show flash

show ftp

show garp timer

show gmrp configuration

show gmrp statistics

show gmrp timer

show gvrp configuration

show gvrp statistics

show ifindex

show igmp flooding

show igmp statistics

show imagemib

show image-verification

show inlinepower

show interface

show inventory

show ip alias

show ip dns

show ip http

show ip permit

show ip route

show ip telnet

show kerberos

show l2protocol-tunnel statistics

show lacp-channel

show lcperroraction

show lda

show localuser

show log

show log command

show logging

show logging buffer

show logging callhome

show logging callhome destination

show logging callhome from

show logging callhome reply-to

show logging callhome severity

show logging callhome smtp-server

show mac

show mac-auth-bypass

show macro

show microcode

show mls

show mls cef interface

show mls cef mac

show mls cef maximum-routes

show mls cef rpf

show mls cef summary

show mls entry

show mls entry cef

show mls entry netflow-route

show mls exclude protocol

show mls flowmask

show mls multicast

show mls nde

show mls netflow-route

show mls pbr-route

show mls statistics

show mls verify

show module

show moduleinit

show msfcautostate

show msmautostate

show multicast group

show multicast group count

show multicast protocols status

show multicast ratelimit-info

show multicast router

show multicast v3-group

show netstat

show ntp

show packet-capture

show pbf

show pbf arp-inspection

show poll

show port

show port arp-inspection

show port auto-mdix

show port auxiliaryvlan

show port broadcast

show port capabilities

show port cdp

show port channel

show port cops

show port counters

show port critical

show port debounce

show port description

show port dhcp-snooping

show port dot1q-all-tagged

show port dot1q-ethertype

show port dot1qtunnel

show port dot1x

show port eou

show port errdisable-timeout

show port errordetection

show port ethernet-oam

show port flexlink

show port flowcontrol

show port inlinepower

show port jumbo

show port l2protocol-tunnel

show port lacp-channel

show port mac

show port mac-address

show port mac-auth-bypass

show port negotiation

show port qos

show port rsvp

show port security

show port security-acl

show port spantree

show port status

show port sync-restart-delay

show port tdr

show port transceiver

show port trap

show port trunk

show port unicast-flood

show port vlan-mapping

show port voice

show port voice active

show port voice fdl

show port voice interface

show port vtp

show port web-auth

show proc

show protocolfilter

show pvlan

show pvlan capability

show pvlan mapping

show qos acl editbuffer

show qos acl info

show qos acl map

show qos acl resource-usage

show qos bridged-microflow-policing

show qos info

show qos mac-cos

show qos statistics

show qos statistics export info

show qos status

show radius

show rate-limit

show rcp

show reset

show rgmp group

show rgmp statistics

show rspan

show running-config

show security acl

show security acl arp-inspection

show security acl capture-ports

show security acl cram

show security acl feature ratelimit

show security acl log

show security acl map

show security acl resource-usage

show security acl tcam interface

show snmp

show snmp access

show snmp access-list

show snmp buffer

show snmp community

show snmp context

show snmp counters

show snmp engineid

show snmp group

show snmp ifalias

show snmp inform

show snmp notify

show snmp rmonmemory

show snmp user

show snmp view

show span

show spantree

show spantree backbonefast

show spantree blockedports

show spantree bpdu-filter

show spantree bpdu-guard

show spantree bpdu-skewing

show spantree conflicts

show spantree defaultcostmode

show spantree guard

show spantree mapping

show spantree mistp-instance

show spantree mst

show spantree mst config

show spantree portfast

show spantree portinstancecost

show spantree portvlancost

show spantree statistics

show spantree summary

show spantree uplinkfast

show ssh

show startup-config

show summertime

show system

show system health

show system highavailability

show system info-log

show system profile

show system sanity

show test

show time

show timezone

show top

show top report

show traffic

show trunk

show udld

show users

show version

show vlan

show vlan counters

show vlan verify-port-provisioning

show vmps

show vmps mac

show vmps statistics

show vmps vlan

show vtp

show vtp domain

show vtp statistics

show web-auth summary

slip

squeeze

stack

switch

switch console

switch fabric

sync

sysret

tclquit

tclsh

telnet

test cable-diagnostics

traceroute ethernet

unalias

undelete

unset=varname

varname=

verify

wait

whichboot

write

write tech-support

A P P E N D I X A

Acronyms

A P P E N D I X B

Acknowledgments for Open-Source Software

Preface

This preface describes the audience, organization, and conventions of this publication and provides information on how to obtain related documentation.

Audience

This publication is for experienced network administrators who are responsible for configuring and maintaining Catalyst 6500 series switches.

Organization

This publication is organized as follows:

Related Documentation

Other documents in the Catalyst 6500 series switch documentation set include the following:

• Catalyst 6500 Series Installation Guide

• Catalyst 6000 Series Installation Guide

• Catalyst 6500 Series Module Installation Guide

• Catalyst 6500 Series Software Configuration Guide Catalyst 6500 Series System Message Guide

Chapter Title Description

Chapter 1 Command-Line Interfaces

Describes the two types of CLIs found on Catalyst 6500 series switches.

Chapter 2 Catalyst 6500 Series Switch and ROM Monitor Commands

Lists alphabetically and provides detailed information for all Catalyst 6500 series switch and ROM-monitor commands.

• ATM Software Configuration Guide and Command Reference for the Catalyst 5000 Family and 6500 Series Switches

• Release Notes for Catalyst 6500 Series For information about MIBs, refer to this URL:

http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml

Conventions

This publication uses the following conventions:

Notes use the following conventions:

Convention Description

boldface font Commands, command options, and keywords are in

boldface.

italic font Arguments for which you supply values are in italics.

[ ] Elements in square brackets are optional.

{ x | y | z } Alternative keywords are grouped in braces and separated by vertical bars.

[ x | y | z ] Optional alternative keywords are grouped in brackets and separated by vertical bars.

string A nonquoted set of characters. Do not use quotation marks around the string or the string will include the quotation marks.

screen font Terminal sessions and information the system displays are in

screen font.

boldface screen

font

Information you must enter is in boldface screen _font.

italic screen font Arguments for which you supply values are in italic screen font.

^ The symbol ^ represents the key labeled Control—for example, the key combination ^D in a screen display means hold down the Control key while you press the D key.

< > Nonprinting characters, such as passwords are in angle brackets.

[ ] Default responses to system prompts are in square brackets.

Obtaining Documentation

Cisco documentation and additional literature are available on Cisco.com. Cisco also provides several ways to obtain technical assistance and other technical resources. These sections explain how to obtain technical information from Cisco Systems.

Cisco.com

You can access the most current Cisco documentation at this URL:

http://www.cisco.com/techsupport

You can access the Cisco website at this URL:

http://www.cisco.com

You can access international Cisco websites at this URL:

http://www.cisco.com/public/countries_languages.shtml

Product Documentation DVD

Cisco documentation and additional literature are available in the Product Documentation DVD package, which may have shipped with your product. The Product Documentation DVD is updated regularly and may be more current than printed documentation.

The Product Documentation DVD is a comprehensive library of technical product documentation on portable media. The DVD enables you to access multiple versions of hardware and software installation, configuration, and command guides for Cisco products and to view technical documentation in HTML. With the DVD, you have access to the same documentation that is found on the Cisco website without being connected to the Internet. Certain products also have .pdf versions of the documentation available.

The Product Documentation DVD is available as a single unit or as a subscription. Registered Cisco.com users (Cisco direct customers) can order a Product Documentation DVD (product number

DOC-DOCDVD=) from Cisco Marketplace at this URL:

http://www.cisco.com/go/marketplace/

Ordering Documentation

Beginning June 30, 2005, registered Cisco.com users may order Cisco documentation at the Product Documentation Store in the Cisco Marketplace at this URL:

http://www.cisco.com/go/marketplace/

Nonregistered Cisco.com users can order technical documentation from 8:00 a.m. to 5:00 p.m. (0800 to 1700) PDT by calling 1 866 463-3487 in the United States and Canada, or elsewhere by calling 011 408 519-5055. You can also order documentation by e-mail at

[email protected] or by fax at 1 408 519-5001 in the United States and Canada,

Documentation Feedback

You can rate and provide feedback about Cisco technical documents by completing the online feedback form that appears with the technical documents on Cisco.com.

You can send comments about Cisco documentation to [email protected].

You can submit comments by using the response card (if present) behind the front cover of your document or by writing to the following address:

Cisco Systems

Attn: Customer Document Ordering 170 West Tasman Drive

San Jose, CA 95134-9883

We appreciate your comments.

Cisco Product Security Overview

Cisco provides a free online Security Vulnerability Policy portal at this URL:

http://www.cisco.com/en/US/products/products_security_vulnerability_policy.html

From this site, you can perform these tasks:

• Report security vulnerabilities in Cisco products.

• Obtain assistance with security incidents that involve Cisco products.

• Register to receive security information from Cisco.

A current list of security advisories and notices for Cisco products is available at this URL:

http://www.cisco.com/go/psirt

If you prefer to see advisories and notices as they are updated in real time, you can access a Product Security Incident Response Team Really Simple Syndication (PSIRT RSS) feed from this URL:

http://www.cisco.com/en/US/products/products_psirt_rss_feed.html

Reporting Security Problems in Cisco Products

Cisco is committed to delivering secure products. We test our products internally before we release them, and we strive to correct all vulnerabilities quickly. If you think that you might have identified a vulnerability in a Cisco product, contact PSIRT:

• Emergencies —[email protected]

An emergency is either a condition in which a system is under active attack or a condition for which a severe and urgent security vulnerability should be reported. All other conditions are considered nonemergencies.

• Nonemergencies —[email protected]

Tip We encourage you to use Pretty Good Privacy (PGP) or a compatible product to encrypt any sensitive information that you send to Cisco. PSIRT can work from encrypted information that is compatible with PGP versions 2.x through 8.x.

Never use a revoked or an expired encryption key. The correct public key to use in your correspondence with PSIRT is the one linked in the Contact Summary section of the Security Vulnerability Policy page at this URL:

http://www.cisco.com/en/US/products/products_security_vulnerability_policy.html

The link on this page has the current PGP key ID in use.

Obtaining Technical Assistance

Cisco Technical Support provides 24-hour-a-day award-winning technical assistance. The Cisco Technical Support & Documentation website on Cisco.com features extensive online support resources. In addition, if you have a valid Cisco service contract, Cisco Technical Assistance Center (TAC) engineers provide telephone support. If you do not have a valid Cisco service contract, contact your reseller.

Cisco Technical Support & Documentation Website

The Cisco Technical Support & Documentation website provides online documents and tools for troubleshooting and resolving technical issues with Cisco products and technologies. The website is available 24 hours a day, at this URL:

http://www.cisco.com/techsupport

Access to all tools on the Cisco Technical Support & Documentation website requires a Cisco.com user ID and password. If you have a valid service contract but do not have a user ID or password, you can register at this URL:

http://tools.cisco.com/RPF/register/register.do

Note Use the Cisco Product Identification (CPI) tool to locate your product serial number before submitting a web or phone request for service. You can access the CPI tool from the Cisco Technical Support & Documentation website by clicking the Tools & Resources link under Documentation & Tools.Choose

Submitting a Service Request

Using the online TAC Service Request Tool is the fastest way to open S3 and S4 service requests. (S3 and S4 service requests are those in which your network is minimally impaired or for which you require product information.) After you describe your situation, the TAC Service Request Tool provides recommended solutions. If your issue is not resolved using the recommended resources, your service request is assigned to a Cisco engineer. The TAC Service Request Tool is located at this URL:

http://www.cisco.com/techsupport/servicerequest

For S1 or S2 service requests or if you do not have Internet access, contact the Cisco TAC by telephone. (S1 or S2 service requests are those in which your production network is down or severely degraded.) Cisco engineers are assigned immediately to S1 and S2 service requests to help keep your business operations running smoothly.

To open a service request by telephone, use one of the following numbers:

Asia-Pacific: +61 2 8446 7411 (Australia: 1 800 805 227) EMEA: +32 2 704 55 55

USA: 1 800 553-2447

For a complete list of Cisco TAC contacts, go to this URL:

http://www.cisco.com/techsupport/contacts

Definitions of Service Request Severity

To ensure that all service requests are reported in a standard format, Cisco has established severity definitions.

Severity 1 (S1)—Your network is “down,” or there is a critical impact to your business operations. You and Cisco will commit all necessary resources around the clock to resolve the situation.

Severity 2 (S2)—Operation of an existing network is severely degraded, or significant aspects of your business operation are negatively affected by inadequate performance of Cisco products. You and Cisco will commit full-time resources during normal business hours to resolve the situation.

Severity 3 (S3)—Operational performance of your network is impaired, but most business operations remain functional. You and Cisco will commit resources during normal business hours to restore service to satisfactory levels.

Severity 4 (S4)—You require information or assistance with Cisco product capabilities, installation, or configuration. There is little or no effect on your business operations.

Obtaining Additional Publications and Information

Information about Cisco products, technologies, and network solutions is available from various online and printed sources.

• Cisco Marketplace provides a variety of Cisco books, reference guides, documentation, and logo merchandise. Visit Cisco Marketplace, the company store, at this URL:

• Cisco Press publishes a wide range of general networking, training and certification titles. Both new and experienced users will benefit from these publications. For current Cisco Press titles and other information, go to Cisco Press at this URL:

http://www.ciscopress.com

• Packet magazine is the Cisco Systems technical user magazine for maximizing Internet and networking investments. Each quarter, Packet delivers coverage of the latest industry trends, technology breakthroughs, and Cisco products and solutions, as well as network deployment and troubleshooting tips, configuration examples, customer case studies, certification and training information, and links to scores of in-depth online resources. You can access Packet magazine at this URL:

http://www.cisco.com/packet

• iQ Magazine is the quarterly publication from Cisco Systems designed to help growing companies learn how they can use technology to increase revenue, streamline their business, and expand services. The publication identifies the challenges facing these companies and the technologies to help solve them, using real-world case studies and business strategies to help readers make sound technology investment decisions. You can access iQ Magazine at this URL:

http://www.cisco.com/go/iqmagazine

or view the digital edition at this URL:

http://ciscoiq.texterity.com/ciscoiq/sample/

• Internet Protocol Journal is a quarterly journal published by Cisco Systems for engineering professionals involved in designing, developing, and operating public and private internets and intranets. You can access the Internet Protocol Journal at this URL:

http://www.cisco.com/ipj

• Networking products offered by Cisco Systems, as well as customer support services, can be obtained at this URL:

http://www.cisco.com/en/US/products/index.html

• Networking Professionals Connection is an interactive website for networking professionals to share questions, suggestions, and information about networking products and technologies with Cisco experts and other networking professionals. Join a discussion at this URL:

http://www.cisco.com/discuss/networking

• World-class networking training is available from Cisco. You can view current offerings at this URL:

C H A P T E R

1

Command-Line Interfaces

This chapter describes the command-line interfaces (CLI) available on the Catalyst 6500 series switches and contains these sections:

• Switch CLI, page 1-1

• ROM Monitor CLI, page 1-17

For information regarding the ATM CLI and commands, refer to the ATM Software Configuration Guide and Command Reference—Catalyst 5000 Family and 6500 Series Switches publication.

For information regarding the IDSM CLI and commands, refer to the Catalyst 6500 Series Intrusion Detection System Module Installation and Configuration Note publication.

For definitions of terms and acronyms listed in this publication, seeAppendix A, “Acronyms.”

Switch CLI

Catalyst 6500 series switches are multimodule systems. Commands you enter from the CLI can apply to the entire system or to a specific module, port, or VLAN.

You can configure and maintain the Catalyst 6500 series switches by entering commands from the switch CLI. The CLI is a basic command-line interpreter similar to the UNIX C shell. Using the CLI

session command, you can access the router configuration software and perform tasks such as history substitution and alias creation.

Accessing the Switch CLI

You can access the switch CLI from a console terminal connected to an EIA/TIA-232 port or through a Telnet session. The CLI allows fixed baud rates. Telnet sessions disconnect automatically after remaining idle for a user-defined time period.

Accessing the Switch CLI via the Console Port (EIA/TIA-232)

To access the switch through the console (EIA/TIA-232) port, perform these steps:

Step 1 From the Cisco Systems Console prompt, press Return.

Step 2 At the prompt, enter the system password. TheConsole>prompt appears, indicating that you have accessed the CLI in normal mode.

Step 3 Enter the necessary commands to complete your desired tasks.

Step 4 When finished, exit the session by entering the quit command.

After connecting through the console port, you see this display:

Cisco Systems Console Enter password: Console> <password> Console>

Accessing the Switch CLI via Telnet

To access the switch through a Telnet session, you must first set the IP address for the switch. You can open multiple sessions to the switch via Telnet.

To access the switch from a remote host with Telnet, perform these steps:

Step 1 From the remote host, enter the telnet command and the host name or IP address of the switch that you want to access.

Step 2 At the prompt, enter the password for the CLI. If no password has been configured, press Return.

Step 3 Enter the necessary commands to complete your desired tasks.

Step 4 When finished, exit the Telnet session by entering the quit command.

After connecting through a Telnet session, you see this display:

host% telnet cat6000-1.cisco.com

Operating the Switch CLI

This section describes command modes and functions that allow you to operate the switch CLI.

Accessing the Command Modes

The CLI has two modes of operation: normal and privileged. Both are password-protected. Use normal-mode commands for everyday system monitoring. Use privileged commands for system configuration and basic troubleshooting.

After you log in, the system enters normal mode, which gives you access to normal-mode commands only. You can enter privileged mode by entering the enable command followed by the enable password. Privileged mode is indicated by the word “enable” in the system prompt. To return to normal mode, enter the disable command at the prompt.

The following example shows how to enter privileged mode:

Console> enable

Enter password: <password> Console> (enable)

Using Command-Line Processing

Switch commands are not case sensitive. You can abbreviate commands and parameters as long as they contain enough letters to be different from any other currently available commands or parameters. You can scroll through the last 20 commands stored in the history buffer and enter or edit the command at the prompt. (See Table 1-1.)

Table 1-1 Command-Line Processing Keystroke

Keystroke Function

Ctrl-A Jumps to the first character of the command line.

Ctrl-B or the left arrow key Moves the cursor back one character.

Ctrl-C Escapes and terminates prompts and tasks.

Ctrl-D Deletes the character at the cursor.

Ctrl-E Jumps to the end of the current command line.

Ctrl-F or the right arrow key1 Moves the cursor forward one character.

Ctrl-K Deletes from the cursor to the end of the command line.

Ctrl-L; Ctrl-R Repeats current command line on a new line.

Ctrl-N or the down arrow key1 Enters next command line in the history buffer.

Ctrl-P or the up arrow key1 Enters previous command line in the history buffer.

Ctrl-U; Ctrl-X Deletes from the cursor to the beginning of the command line.

Using the Command-Line Editing Features

Catalyst 6500 series switch software includes an enhanced editing mode that provides a set of editing key functions similar to those of the Emacs editor. You can enter commands in uppercase, lowercase, or a mix of both. Only passwords are case sensitive. You can abbreviate commands and keywords to the number of characters that allow a unique abbreviation.

For example, you can abbreviate the show command to sh. After entering the command at the system prompt, press Return to execute the command.

Moving Around on the Command Line

Perform one of these tasks to move the cursor around on the command line for corrections or changes:

Completing a Partial Command Name

If you cannot remember a complete command name, press the Tab key to allow the system to complete a partial entry. To do so, perform this task:

Esc B Moves the cursor back one word.

Esc D Deletes from the cursor to the end of the word.

Esc F Moves the cursor forward one word.

Delete key or Backspace key Erases a mistake when entering a command; reenter the command after using this key.

1. The arrow keys function only on ANSI-compatible terminals such as VT100s. Table 1-1 Command-Line Processing Keystroke (continued)

Keystroke Function

Task Keystrokes

Move the cursor back one character. Press Ctrl-B or press the left arrow key1_.

1. The arrow keys function only on ANSI-compatible terminals such as VT100s.

Move the cursor forward one character. Press Ctrl-F or press the right arrow key1. Move the cursor to the beginning of the

command line.

Press Ctrl-A.

Move the cursor to the end of the command line.

Press Ctrl-E.

Move the cursor back one word. Press Esc B. Move the cursor forward one word. Press Esc F.

Task Keystrokes

In the following example, when you enter the letters conf and press the Tab key, the system provides the complete command:

Console> (enable) conf<Tab>

Console> (enable) configure

If you enter a set of characters that could indicate more than one command, the system beeps to indicate an error. Enter a question mark (?) to obtain a list of commands that begin with that set of characters. Do not leave a space between the last letter and the question mark (?). For example, three commands in privileged mode start with co. To see what they are, enter co? at the privileged prompt. The system displays all commands that begin with co, as follows:

Console> (enable) co?

configure connect copy

Pasting in Buffer Entries

The system provides a buffer that contains the last ten items you deleted. You can recall these items and paste them in the command line by performing this task:

The buffer contains only the last ten items you have deleted or cut. If you press Esc Y more than ten times, you cycle back to the first buffer entry.

Editing Command Lines That Wrap

The new editing command set provides a wraparound feature for commands that extend beyond a single line on the screen. When the cursor reaches the right margin, the command line shifts ten spaces to the left. You cannot see the first ten characters of the line, but you can scroll back and check the syntax at the beginning of the command. To scroll back, perform this task:

Use line wrapping with the command history feature to recall and modify previous complex command entries. See the “Using History Substitution” section on page 1-8 for information about recalling previous command entries.

The system assumes your terminal screen is 80 columns wide. If your screen has a different width, enter the terminal width command to tell the router the correct width of your screen.

Task Keystrokes

Recall the most recent entry in the buffer.

Press Ctrl-Y.

Recall the next buffer entry. Press Esc Y.

Task Keystrokes

Return to the beginning of a command line to verify that you have entered a lengthy command correctly.

Press Ctrl-B or the left arrow key repeatedly until you scroll back to the beginning of the command entry, or press Ctrl-A to return directly to the beginning of the line1.

Deleting Entries

Perform one of these tasks to delete command entries if you make a mistake or change your mind:

Scrolling Down a Line or a Screen

When you use the help facility to list the commands in a particular mode, the list is often longer than the terminal screen can display. In such cases, a ---More--- prompt is displayed at the bottom of the screen. To view the next line or screen, perform these tasks:

Note The ---More--- prompt is used for any output that has more lines than can be displayed on the terminal screen, including show command output.

Scrolling to Specified Text

If you enter /text and press the Return key at the --More-- prompt, the display starts two lines above the line containing the text string. If the text string is not found, “Pattern Not Found” is displayed. You can also enter “n” at the --More-- prompt to search for the last entered text string. You can use this search method on all show commands that use the more buffer to display screen by screen ouput. The following is a list of show commands that do not use the more buffer and do not support this feature:

• show cam

• show mls

• show tech-support

Task Keystrokes

Erase the character to the left of the cursor. Press the Delete or Backspace key. Delete the character at the cursor. Press Ctrl-D.

Delete from the cursor to the end of the command line.

Press Ctrl-K.

Delete from the cursor to the beginning of the command line.

Press Ctrl-U or Ctrl-X.

Delete the word to the left of the cursor. Press Ctrl-W. Delete from the cursor to the end of the word. Press Esc D.

Task Keystrokes

Redisplaying the Current Command Line

If you enter a command and the system suddenly sends a message to your screen, you can recall your current command line entry. To do so, perform this task:

Transposing Mistyped Characters

If you mistype a command entry, you can transpose the mistyped characters by performing this task:

Controlling Capitalization

You can change words to uppercase or lowercase, or capitalize a set of letters, with simple keystroke sequences:

Designating a Keystroke as a Command Entry

You can use a particular keystroke as an executable command. Perform this task:

Task Keystrokes

Redisplay the current command line. Press Ctrl-L or Ctrl-R.

Task Keystrokes

Transpose the character to the left of the cursor with the character located at the cursor.

Press Ctrl-T.

Task Keystrokes

Capitalize at the cursor. Press Esc C. Change the word at the cursor to lowercase. Press Esc L. Capitalize letters from the cursor to the end

of the word.

Press Esc U.

Task Keystrokes

Insert a code to indicate to the system that the keystroke immediately following should be treated as a command entry, not an editing key.

Using Command Aliases

Like regular commands, aliases are not case sensitive. However, unlike regular commands, some aliases cannot be abbreviated. See Table 1-2 for a list of switc