-
Corporate HeadquartersCisco Systems, Inc.170 West Tasman
DriveSan Jose, CA 95134-1706 USAhttp://www.cisco.comTel: 408
526-4000
800 553-NETS (6387)Fax: 408 526-4100
Catalyst 6500 Series Switch Cisco IOS Command ReferenceCisco IOS
Release 12.1 E
Customer Order Number: DOC-7814058=Text Part Number:
78-14058-05
-
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 UCBs 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.
CCSP, the Cisco Square Bridge logo, Cisco Unity, Follow Me
Browsing, FormShare, and StackWise are trademarks of Cisco Systems,
Inc.; Changing the Way We Work, Live, Play, and Learn, and iQuick
Study are service marks of Cisco Systems, Inc.; and Aironet, ASIST,
BPX, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, Cisco, the Cisco
Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco
Systems, Cisco Systems Capital, the Cisco Systems logo, Empowering
the Internet Generation, Enterprise/Solver, EtherChannel,
EtherFast, EtherSwitch, Fast Step, GigaDrive, GigaStack, HomeLink,
Internet Quotient, IOS, IP/TV, iQ Expertise, the iQ logo, iQ Net
Readiness Scorecard, LightStream, Linksys, MeetingPlace, MGX, the
Networkers logo, Networking Academy, Network Registrar, Packet,
PIX, Post-Routing, Pre-Routing, ProConnect, RateMUX, Registrar,
ScriptShare, SlideCast, SMARTnet, StrataView Plus, SwitchProbe,
TeleRouter, The Fastest Way to Increase Your Internet Quotient,
TransPath, and VCO 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. (0406R)
Catalyst 6500 Series Switch Cisco IOS Command ReferenceCopyright
20012004 Cisco Systems, Inc. All rights reserved.
-
Catalyst 6500 Series Sw78-14058-05
class-map 2-20
clear catalyst6000 traffic-meter 2-22
clear counters 2-23
clear interface gigabitethernet 2-25
clear interface vlan 2-26C O N T E N T S
Preface xix
Audience xix
Organization xix
Related Documentation xix
Conventions xx
Obtaining Documentation xxi
Documentation Feedback xxi
Obtaining Technical Assistance xxii
Obtaining Additional Publications and Information xxiii
C H A P T E R 1 Command-Line Interface 1-1
Getting Help 1-1
How to Find Command Options 1-2
Understanding Command Modes 1-5
Using the No and Default Forms of Commands 1-6
Using the CLI String Search 1-7
Saving Configuration Changes 1-11
C H A P T E R 2 Cisco IOS Commands for the Catalyst 6500 Series
Switches 2-1
action 2-2
apply 2-4
attach 2-5
auto-sync 2-8
boot config 2-10
cd 2-12
channel-group 2-15
channel-protocol 2-18iiiitch Cisco IOS Command ReferenceRelease
12.1 E
-
Contentsclear ip access-template 2-27
clear ip auth-proxy watch-list 2-28
clear ip cef epoch full 2-29
clear ip cef inconsistency 2-31
clear ip flow stats 2-32
clear ip igmp group 2-33
clear lacp counters 2-35
clear mac-address-table dynamic 2-36
clear mls 2-38
clear mls exclude protocol 2-41
clear mls ip multicast statistics 2-42
clear mls nde counters 2-43
clear mls nde flow 2-44
clear mls qos 2-45
clear pagp 2-47
clear spanning-tree detected-protocol 2-48
clear vlan counters 2-50
copy /noverify 2-51
debug adjacency 2-54
debug backup 2-55
debug callback 2-56
debug cca 2-57
debug condition interface 2-58
debug condition standby 2-60
debug condition vlan 2-62
debug earl 2-64
debug ehsa 2-65
debug entry 2-66
debug etherchnl 2-67
debug ethernet-interface 2-69
debug fastethernet 2-70
debug fm 2-71
debug gssapi 2-72
debug icc 2-73
debug iccshim 2-74ivCatalyst 6500 Series Switch Cisco IOS
Command ReferenceRelease 12.1 E
78-14058-05
-
Contentsdebug interface 2-75
debug ipc 2-77
debug ip rgmp 2-78
debug l2-mgr events 2-79
debug l3-mgr 2-80
debug local-ack 2-81
debug ltl 2-82
debug mergeapi 2-83
debug mls ip multicast 2-84
debug mls rp 2-85
debug monitor 2-86
debug msc 2-87
debug netdr 2-88
debug nvram 2-90
debug pagp 2-91
debug pf 2-92
debug pm 2-93
debug priority 2-95
debug qm 2-96
debug qm-sp 2-97
debug rpc 2-98
debug scp 2-100
debug smf updates 2-101
debug spanning-tree 2-102
debug spanning-tree backbonefast 2-103
debug spanning-tree switch 2-104
debug spanning-tree uplinkfast 2-106
debug sw-vlan 2-107
debug sw-vlan ifs 2-108
debug sw-vlan notification 2-110
debug sw-vlan vtp 2-111
debug tcam 2-113
debug udld 2-114
debug vacl 2-116
debug vlog 2-117vCatalyst 6500 Series Switch Cisco IOS Command
ReferenceRelease 12.1 E
78-14058-05
-
Contentsdefine interface-range 2-118
diagnostic level 2-120
disconnect qdm 2-122
do 2-123
dot1x default 2-124
dot1x max-req 2-125
dot1x multi-hosts 2-126
dot1x port-control 2-127
dot1x reauthentication 2-129
dot1x system-auth-control 2-130
dot1x timeout 2-131
duplex 2-133
erase 2-135
errdisable detect cause 2-137
errdisable flap-setting cause 2-139
errdisable recovery 2-140
fabric lcd-banner 2-142
fabric required 2-144
fabric switching-mode allow 2-145
file verify auto 2-147
flowcontrol 2-148
format 2-150
fsck 2-152
hold-queue 2-155
hw-module reset 2-157
instance 2-158
interface 2-160
interface port-channel 2-162
interface range 2-164
interface vlan 2-166
ip access-list hardware permit fragments 2-168
ip auth-proxy max-login-attempts 2-170
ip auth-proxy watch-list 2-171
ip cef table consistency-check 2-173
ip flow-aggregation cache 2-175viCatalyst 6500 Series Switch
Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Contentsip flow-cache entries 2-177
ip flow-export destination 2-179
ip flow-export source 2-181
ip flow-export version 2-183
ip igmp snooping 2-185
ip igmp snooping fast-leave 2-186
ip igmp snooping l2-entry-limit 2-187
ip igmp snooping last-member-query-interval 2-188
ip igmp snooping mrouter 2-190
ip igmp snooping querier 2-192
ip igmp snooping static 2-194
ip local-proxy-arp 2-196
ip multicast rpf backoff 2-197
ip multicast rpf interval 2-199
ip pim autorp listener 2-200
ip rgmp 2-201
ip route-cache flow 2-203
ip sticky-arp 2-205
ip verify unicast reverse-path 2-206
ip verify unicast source reachable-via 2-208
ip wccp group-listen 2-210
ip wccp redirect exclude in 2-212
ip wccp web-cache accelerated 2-213
l2protocol-tunnel 2-215
l2protocol-tunnel cos 2-217
l2protocol-tunnel drop-threshold 2-219
l2protocol-tunnel shutdown-threshold 2-221
lacp port-priority 2-223
lacp system-priority 2-224
link debounce 2-225
logging event link-status (global configuration) 2-227
logging event link-status (interface configuration) 2-229
logging event subif-link-status 2-230
mac access-list extended 2-231
mac-address-table aging-time 2-233viiCatalyst 6500 Series Switch
Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Contentsmac-address-table static 2-234
mac-address-table unicast-flood 2-236
match 2-238
maxconns (real server configuration submode) 2-240
maximum-paths 2-241
mdix auto 2-242
mkdir disk0: 2-243
mls aclmerge algorithm 2-244
mls aging fast 2-246
mls aging long 2-247
mls aging normal 2-248
mls exclude protocol 2-249
mls flow 2-250
mls ip 2-252
mls ip cef arp-throttling 2-253
mls ip cef load-sharing full 2-254
mls ip cef rate-limit 2-255
mls ip directed-broadcast 2-256
mls ip inspect 2-258
mls ip multicast (global configuration mode) 2-259
mls ip multicast (interface configuration mode) 2-260
mls ip multicast connected 2-261
mls ip multicast consistency-check 2-262
mls ip multicast non-rpf-netflow (global configuration mode)
2-264
mls ip multicast non-rpf-netflow (interface configuration mode)
2-265
mls ip multicast stub 2-266
mls ip multicast threshold 2-268
mls ip pbr 2-269
mls ipx (interface configuration mode) 2-270
mls nde flow 2-271
mls nde interface 2-273
mls nde sender 2-274
mls nde src_address 2-276
mls netflow 2-277
mls netflow maximum-flows 2-278viiiCatalyst 6500 Series Switch
Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Contentsmls netflow sampling 2-279
mls netflow usage notify 2-280
mls qos (global configuration mode) 2-281
mls qos (interface configuration mode) 2-283
mls qos aggregate-policer 2-284
mls qos bridged 2-287
mls qos channel-consistency 2-288
mls qos cos 2-289
mls qos flow-policing 2-290
mls qos map cos-dscp 2-291
mls qos map dscp-cos 2-292
mls qos map ip-prec-dscp 2-294
mls qos map policed-dscp 2-296
mls qos queueing-only 2-297
mls qos statistics-export (global configuration mode) 2-299
mls qos statistics-export (interface configuration mode)
2-300
mls qos statistics-export aggregate-policer 2-302
mls qos statistics-export class-map 2-304
mls qos statistics-export delimiter 2-307
mls qos statistics-export destination 2-308
mls qos statistics-export interval 2-310
mls qos trust 2-311
mls qos trust extend 2-313
mls qos vlan-based 2-315
mls rp ip (global configuration mode) 2-316
mls rp ip (interface configuration mode) 2-317
mls rp ipx (global configuration mode) 2-318
mls rp ipx (interface configuration mode) 2-319
mls rp management-interface 2-320
mls rp nde-address 2-321
mls rp vlan-id 2-323
mls rp vtp-domain 2-324
mls sampling 2-325
mode 2-327
monitor session 2-329ixCatalyst 6500 Series Switch Cisco IOS
Command ReferenceRelease 12.1 E
78-14058-05
-
Contentsmpls l2transport route 2-333
mpls load-balance per-label 2-335
mtu 2-336
name 2-338
net 2-339
pagp learn-method 2-341
pagp port-priority 2-342
policy-map 2-343
port-channel load-balance 2-346
power enable 2-348
power inline 2-349
power redundancy-mode 2-350
ppp link 2-351
private-vlan 2-353
private-vlan mapping 2-355
private-vlan synchronize 2-357
protocol-filtering 2-358
rcv-queue cos-map 2-359
rcv-queue queue-limit 2-361
rcv-queue random-detect 2-363
rcv-queue threshold 2-365
redundancy 2-367
redundancy force-switchover 2-368
reload 2-369
remote command 2-371
remote login 2-373
remote-span 2-375
reset 2-376
retry 2-377
revision 2-378
rmon alarm 2-379
rmon event 2-381
scheduler allocate 2-383
service counters max age 2-385
service-policy input 2-386xCatalyst 6500 Series Switch Cisco IOS
Command ReferenceRelease 12.1 E
78-14058-05
-
Contentssession slot 2-387
set ip dscp 2-388
set ip precedence (policy-map) 2-390
show 2-392
show adjacency 2-394
show arp 2-397
show asic-version 2-398
show bootflash: 2-399
show bootvar 2-401
show cable-diagnostics prbs 2-402
show cable-diagnostics tdr 2-404
show catalyst6000 2-406
show cdp neighbors 2-408
show class-map 2-411
show counters interface 2-412
show cwan 2-415
show diagnostic 2-417
show dot1q-tunnel 2-419
show dot1x 2-421
show environment alarm 2-423
show environment status 2-426
show environment temperature 2-429
show eobc 2-431
show errdisable detect 2-434
show errdisable recovery 2-435
show etherchannel 2-436
show fabric 2-440
show fm features 2-443
show fm inband-counters 2-445
show fm insp 2-446
show fm interface 2-447
show fm reflexive 2-449
show fm summary 2-450
show fm vlan 2-451
show icc 2-453xiCatalyst 6500 Series Switch Cisco IOS Command
ReferenceRelease 12.1 E
78-14058-05
-
Contentsshow idprom 2-455
show interfaces 2-458
show interfaces capabilities 2-460
show interfaces counters 2-463
show interfaces debounce 2-466
show interfaces description 2-467
show interfaces flowcontrol 2-468
show interfaces private-vlan mapping 2-470
show interfaces status 2-471
show interfaces summary 2-473
show interfaces switchport 2-474
show interfaces trunk 2-477
show ip auth-proxy watch-list 2-480
show ip cache flow 2-481
show ip cef epoch 2-485
show ip cef inconsistency 2-487
show ip cef summary 2-489
show ip cef vlan 2-490
show ip igmp interface 2-491
show ip igmp snooping mrouter 2-493
show ip mroute 2-494
show ip rpf events 2-499
show ip wccp 2-500
show ipc 2-502
show l2protocol-tunnel 2-504
show l3-mgr 2-506
show lacp 2-508
show mac-address-table 2-512
show mls asic 2-518
show mls cef 2-519
show mls cef adjacency 2-521
show mls cef exact-route 2-523
show mls cef hardware 2-524
show mls cef ip 2-526
show mls cef ipx 2-528xiiCatalyst 6500 Series Switch Cisco IOS
Command ReferenceRelease 12.1 E
78-14058-05
-
Contentsshow mls cef logging 2-529
show mls cef mac 2-530
show mls cef statistics 2-531
show mls cef summary 2-532
show mls ip 2-534
show mls ip multicast 2-537
show mls ip statistics 2-540
show mls ipx 2-541
show mls nde 2-543
show mls netflow 2-544
show mls netflow ip 2-546
show mls netflow ipx 2-549
show mls qos 2-551
show mls qos aggregate policer 2-554
show mls qos statistics-export info 2-555
show mls sampling 2-557
show mls statistics 2-558
show mls table-contention 2-560
show module 2-561
show monitor session 2-563
show mpls l2transport vc 2-565
show mpls ttfib 2-569
show msfc 2-570
show pagp 2-574
show platform 2-576
show policy-map 2-580
show policy-map interface 2-582
show port-security 2-584
show power 2-586
show protocol-filtering 2-589
show qdm status 2-590
show qm-sp port-data 2-591
show queueing interface 2-593
show redundancy 2-595
show rom-monitor 2-598xiiiCatalyst 6500 Series Switch Cisco IOS
Command ReferenceRelease 12.1 E
78-14058-05
-
Contentsshow rpc 2-599
show running-config 2-601
show scp 2-603
show slot0: 2-604
show spanning-tree 2-607
show spanning-tree mst 2-613
show standby delay 2-616
show sup-bootflash 2-617
show tcam counts 2-620
show tcam interface 2-622
show tech-support 2-624
show udld 2-626
show version 2-628
show vlan 2-631
show vlan access-log 2-635
show vlan access-map 2-637
show vlan counters 2-638
show vlan dot1q tag native 2-639
show vlan filter 2-640
show vlan internal usage 2-642
show vlan mapping 2-644
show vlan private-vlan 2-645
show vlan remote-span 2-647
show vlans 2-648
show vtp 2-650
shutdown vlan 2-653
snmp ifindex clear 2-654
snmp ifindex persist 2-655
snmp-server enable traps 2-657
snmp-server ifindex persist 2-659
spanning-tree backbonefast 2-660
spanning-tree bpdufilter 2-661
spanning-tree bpduguard 2-663
spanning-tree cost 2-664
spanning-tree etherchannel guard misconfig 2-666xivCatalyst 6500
Series Switch Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Contentsspanning-tree extend system-id 2-667
spanning-tree guard 2-668
spanning-tree link-type 2-669
spanning-tree loopguard default 2-670
spanning-tree mode 2-671
spanning-tree mst 2-672
spanning-tree mst configuration 2-674
spanning-tree mst forward-time 2-676
spanning-tree mst hello-time 2-677
spanning-tree mst max-age 2-678
spanning-tree mst max-hops 2-679
spanning-tree mst root 2-680
spanning-tree pathcost method 2-682
spanning-tree portfast (interface configuration mode) 2-683
spanning-tree portfast bpdufilter default 2-685
spanning-tree portfast bpduguard default 2-687
spanning-tree portfast default 2-688
spanning-tree port-priority 2-689
spanning-tree uplinkfast 2-690
spanning-tree vlan 2-692
speed 2-694
squeeze 2-697
stack-mib portname 2-698
standby delay minimum reload 2-699
standby track 2-701
standby use-bia 2-703
storm-control level 2-705
switchport 2-707
switchport access vlan 2-709
switchport capture 2-711
switchport capture allowed vlan 2-713
switchport dot1q 2-715
switchport mode 2-717
switchport port-security 2-719
switchport port-security aging time 2-720xvCatalyst 6500 Series
Switch Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Contentsswitchport port-security mac-address 2-721
switchport port-security maximum 2-722
switchport port-security violation 2-723
switchport private-vlan host-association 2-724
switchport private-vlan mapping 2-726
switchport protocol 2-728
switchport trunk 2-730
switchport voice vlan 2-734
sync-restart-delay 2-736
system jumbomtu 2-737
tcam priority 2-738
test cable-diagnostics 2-740
time-range 2-743
udld 2-745
udld port 2-747
udld reset 2-750
undelete 2-751
upgrade rom-monitor 2-753
username 2-755
verify 2-757
vlan (config-VLAN submode) 2-760
vlan (global configuration mode) 2-763
vlan (VLAN configuration submode) 2-765
vlan access-log 2-768
vlan access-map 2-770
vlan database 2-772
vlan dot1q tag native 2-774
vlan filter 2-776
vlan internal allocation policy 2-778
vlan mapping 2-780
vtp 2-782
wrr-queue bandwidth 2-785
wrr-queue cos-map 2-787
wrr-queue queue-limit 2-788
wrr-queue random-detect 2-790xviCatalyst 6500 Series Switch
Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Contentswrr-queue threshold 2-792
A P P E N D I X A Acronyms A-1
A P P E N D I X B Acknowledgments for Open-Source Software
B-1
I N D E XxviiCatalyst 6500 Series Switch Cisco IOS Command
ReferenceRelease 12.1 E
78-14058-05
-
ContentsxviiiCatalyst 6500 Series Switch Cisco IOS Command
ReferenceRelease 12.1 E
78-14058-05
-
Preface
This preface describes the audience, organization, and
conventions of this publication, and provides information on how to
obtain related documentation.
AudienceThis publication is for experienced network
administrators who are responsible for configuring and maintaining
Catalyst 6500 series switches.
OrganizationThis publication is organized as follows:
Related DocumentationThe Catalyst 6500 series switch Cisco IOS
documentation set includes these documents:
Chapter Title Description
Chapter 1 Command-Line Interface Describes the Catalyst 6500
series switch CLI.
Chapter 2 Cisco IOS Commands for the Catalyst 6500 Series
Switches
Lists alphabetically and provides detailed information for Cisco
IOS commands specific to the Catalyst 6500 series switch.
Appendix A Acronyms Defines the acronyms used in this
publication.xixCatalyst 6500 Series Switch Cisco IOS Command
ReferenceRelease 12.1 E
78-14058-05
Catalyst 6500 Series Switch Module Installation Guide Catalyst
6500 Series Switch Cisco IOS Software Configuration Guide Catalyst
6500 Series Switch Cisco IOS System Message Guide Release Notes for
Catalyst 6500 Series Switch Cisco IOS Software Release X.X
-
PrefaceConventionsThe Cisco IOS documentation set includes these
documents: Configuration Fundamentals Configuration Guide Command
Reference
For information about MIBs, refer to this
URL:http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml
ConventionsThis document uses the following conventions:
Notes use the following conventions:
Note Means reader take note. Notes contain helpful suggestions
or references to material not covered in the publication.
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. Braces can also be used to group keywords and/or
arguments; for example, {interface interface type}.
[ 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 Controlfor 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.!, # An exclamation point (!) or a pound sign (#) at the
beginning
of a line of code indicates a comment line.xxCatalyst 6500
Series Switch Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
PrefaceObtaining DocumentationCautions use the following
conventions:
Caution Means reader be careful. In this situation, you might do
something that could result in equipment damage or loss of
data.
Obtaining DocumentationCisco 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.comYou can access the most current Cisco documentation at
this URL:http://www.cisco.com/univercd/home/home.htmYou can access
the Cisco website at this URL:http://www.cisco.comYou can access
international Cisco websites at this
URL:http://www.cisco.com/public/countries_languages.shtml
Ordering DocumentationYou can find instructions for ordering
documentation at this
URL:http://www.cisco.com/univercd/cc/td/doc/es_inpck/pdi.htmYou can
order Cisco documentation in these ways:
Registered Cisco.com users (Cisco direct customers) can order
Cisco product documentation from the Ordering
tool:http://www.cisco.com/en/US/partner/ordering/index.shtml
Nonregistered Cisco.com users can order documentation through a
local account representative by calling Cisco Systems Corporate
Headquarters (California, USA) at 408 526-7208 or, elsewhere in
North America, by calling 800 553-NETS (6387).
Documentation FeedbackYou can send comments about technical
documentation to [email protected] 6500 Series Switch
Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
PrefaceObtaining Technical AssistanceYou 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 SystemsAttn:
Customer Document Ordering170 West Tasman DriveSan Jose, CA
95134-9883We appreciate your comments.
Obtaining Technical AssistanceFor all customers, partners,
resellers, and distributors who hold valid Cisco service contracts,
Cisco Technical Support provides 24-hour-a-day, award-winning
technical assistance. The Cisco Technical Support Website on
Cisco.com features extensive online support resources. In addition,
Cisco Technical Assistance Center (TAC) engineers provide telephone
support. If you do not hold a valid Cisco service contract, contact
your reseller.
Cisco Technical Support WebsiteThe Cisco Technical Support
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, 365 days a year at this
URL:http://www.cisco.com/techsupportAccess to all tools on the
Cisco Technical Support 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
Submitting a Service RequestUsing 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 automatically
provides recommended solutions. If your issue is not resolved using
the recommended resources, your service request will be assigned to
a Cisco TAC engineer. The TAC Service Request Tool is located at
this URL:
http://www.cisco.com/techsupport/servicerequestFor 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
TAC 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 55USA: 1 800 553 2447xxiiCatalyst 6500
Series Switch Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
PrefaceObtaining Additional Publications and InformationFor a
complete list of Cisco TAC contacts, go to this
URL:http://www.cisco.com/techsupport/contacts
Definitions of Service Request SeverityTo 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 InformationInformation
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, and logo merchandise. Visit Cisco Marketplace, the company
store, at this URL:http://www.cisco.com/go/marketplace/
The Cisco Product Catalog describes the networking products
offered by Cisco Systems, as well as ordering and customer support
services. Access the Cisco Product Catalog at this
URL:http://cisco.com/univercd/cc/td/doc/pcat/
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/packetxxiiiCatalyst 6500 Series Switch
Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
PrefaceObtaining Additional Publications and Information 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
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
World-class networking training is available from Cisco. You can
view current offerings at this URL:
http://www.cisco.com/en/US/learning/index.htmlxxivCatalyst 6500
Series Switch Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Catalyst 6500 Series Switch Cisco IO78-14058-05
abbreviated-command-entry Complete a partia? List all
command
command mode. l command name. s available for a particular C H A
P T E R 1Command-Line Interface
This chapter provides information for understanding and using
the Catalyst 6500 series switch Cisco IOS software using the
command-line interface (CLI). This chapter includes the following
sections:
Getting Help, page 1-1 How to Find Command Options, page 1-2
Understanding Command Modes, page 1-5 Using the No and Default
Forms of Commands, page 1-6 Using the CLI String Search, page 1-7
Saving Configuration Changes, page 1-11
For an overview of the Catalyst 6500 series switch Cisco IOS
software configuration, refer to the Catalyst 6500 Series Switch
Cisco IOS Software Configuration Guide.
Getting HelpTo obtain a list of commands that are available for
each command mode, enter a question mark (?) at the system prompt.
You also can obtain a list of any commands associated keywords and
arguments with the context-sensitive help feature.
Table 1-1 lists commands you can enter to get help that is
specific to a command mode, a command, a keyword, or an
argument.
Table 1-1 Getting Help
Command Purpose
abbreviated-command-entry? Obtain a list of commands that begin
with a particular character string. (Do not leave a space between
the command and question mark.)1-1S Command ReferenceRelease 12.1
E
-
Chapter 1 Command-Line InterfaceHow to Find Command OptionsHow
to Find Command OptionsThis section provides an example of how to
display syntax for a command. The syntax can consist of optional or
required keywords. To display keywords for a command, enter a
question mark (?) at the configuration prompt or after entering
part of a command followed by a space. The Catalyst 6500 series
switch software displays a list of available keywords along with a
brief description of the keywords. For example, if you are in
global configuration mode and want to see all the keywords for the
arap command, you enter arap ?. Table 1-2 shows examples of how you
can use the question mark (?) to assist you in entering commands
and also guides you through entering the following commands:
interface gigabitethernet 1/1 channel-group 1 mode auto
command ? List a commands associated keywords. Leave a space
between the command and question mark.
command keyword ? List a keywords associated arguments. Leave a
space between the keyword and question mark.
Table 1-1 Getting Help (continued)
Command Purpose
Table 1-2 How to Find Command Options
Command Comment
Router> enablePassword: Router#
Enter the enable command and password to access privileged EXEC
commands. You are in privileged EXEC mode when the prompt changes
to Router#.
Router# configure terminalEnter configuration commands, one per
line. End with CNTL/Z.Router(config)#
Enter global configuration mode.You are in global configuration
mode when the prompt changes to Router(config)#.
Router(config)# interface gigabitethernet ? GigabitEthernet
interface number Router(config)# interface gigabitethernet
1/1Router(config-if)#
Enter interface configuration mode by specifying the Gigabit
Ethernet interface that you want to configure using the interface
gigabitethernet global configuration command.Enter a ? to display
what you must enter next on the command line. In this example, you
must enter an interface number from 1 to 9 in the format
module-number/port-number.You are in interface configuration mode
when the prompt changes to Router(config-if)#.1-2Catalyst 6500
Series Switch Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Chapter 1 Command-Line InterfaceHow to Find Command
OptionsRouter(config-if)#?Interface configuration commands:
access-expression Build a bridge boolean access expression apollo
Apollo interface subcommands appletalk Appletalk interface
subcommands arp Set arp type (arpa, probe, snap) or timeout backup
Modify backup parameters bandwidth Set bandwidth informational
parameter bgp-policy Apply policy propogated by bgp community
string bridge-group Transparent bridging interface parameters
carrier-delay Specify delay for interface transitions cdp CDP
interface subcommands channel-group Etherchannel/port bundling
configuration clns CLNS interface subcommands cmns OSI CMNS
custom-queue-list Assign a custom queue list to an interface decnet
Interface DECnet config commands default Set a command to its
defaults delay Specify interface throughput delay description
Interface specific description dlsw DLSw interface subcommands dspu
Down Stream PU exit Exit from interface configuration mode
fair-queue Enable Fair Queuing on an Interface flowcontrol
Configure flow operation. fras DLC Switch Interface Command help
Description of the interactive help system hold-queue Set hold
queue depth ip Interface Internet Protocol config commands ipx
Novell/IPX interface subcommands isis IS-IS commands iso-igrp
ISO-IGRP interface subcommands
.
.
.
Router(config-if)#
Enter a ? to display a list of all the interface configuration
commands available for the Gigabit Ethernet interface.
Router(config-if)# channel-group ? group channel-group of the
interface
Router(config-if)#channel-group
Enter the command that you want to configure for the controller.
In this example, the channel-group command is used. Enter a ? to
display what you must enter next on the command line. In this
example, you must enter the group keyword.Because a is not
displayed, it indicates that you must enter more information to
complete the command.
Table 1-2 How to Find Command Options (continued)
Command Comment1-3Catalyst 6500 Series Switch Cisco IOS Command
ReferenceRelease 12.1 E
78-14058-05
-
Chapter 1 Command-Line InterfaceHow to Find Command
OptionsRouter(config-if)# channel-group ? Channel group number
Router(config-if)#channel-group
After you enter the group keyword, enter a ? to display what you
must enter next on the command line. In this example, you must
enter a channel group number from 1 to 282. Because a is not
displayed, it indicates that you must enter more information to
complete the command.
Router(config-if)# channel-group 1 ? mode Etherchannel Mode of
the interface
Router(config-if)#
After you enter the channel group number, enter a ? to display
what you must enter next on the command line. In this example, you
must enter the mode keyword.Because a is not displayed, it
indicates that you must enter more information to complete the
command.
Router(config-if)# channel-group 1 mode ? auto Enable PAgP only
if a PAgP device is detected desirable Enable PAgP unconditionally
on Enable Etherchannel only
Router(config-if)#
After you enter the mode keyword, enter a ? to display what you
must enter next on the command line. In this example, you must
enter the auto, desirable, or on keyword.Because a is not
displayed, it indicates that you must enter more information to
complete the command.
Router(config-if)# channel-group 1 mode auto ?
Router(config-if)#
In this example, the auto keyword is entered. After you enter
the auto keyword, enter a ? to display what you must enter next on
the command line. Because a is displayed, it indicates that you can
press Return to complete the command. If additional keywords are
listed, you can enter more keywords or press Return to complete the
command.
Router(config-if)# channel-group 1 mode
autoRouter(config-if)#
In this example, press Return to complete the command.
Table 1-2 How to Find Command Options (continued)
Command Comment1-4Catalyst 6500 Series Switch Cisco IOS Command
ReferenceRelease 12.1 E
78-14058-05
-
Chapter 1 Command-Line InterfaceUnderstanding Command
ModesUnderstanding Command ModesThe Catalyst 6500 series switch
Cisco IOS user interface is divided into many different modes. The
commands that are available to you depend on which mode you are
currently in. You can obtain a list of commands that are available
for each command mode by entering a question mark (?) at the system
prompt.
When you start a session on the Catalyst 6500 series switch, you
begin in user mode, often called EXEC mode. Only a limited subset
of the commands are available in EXEC mode. In order to have access
to all commands, you must enter privileged EXEC mode. Normally, you
must enter a password to enter privileged EXEC mode. From
privileged EXEC mode, you can enter any EXEC command or enter
global configuration mode. Most EXEC commands are one-time
commands, such as show commands, which show the current status of a
given item, and clear commands, which clear counters or interfaces.
The EXEC commands are not saved across reboots of the Catalyst 6500
series switch.The configuration modes allow you to make changes to
the running configuration. If you later save the configuration,
these commands are stored across Catalyst 6500 series switch
reboots. In order to get to the various configuration modes, you
must start at global configuration mode where you can enter
interface configuration mode, subinterface configuration mode, and
a variety of protocol-specific modes.ROM-monitor mode is a separate
mode that is used when the Catalyst 6500 series switch cannot boot
properly. If your Catalyst 6500 series switch or access server does
not find a valid system image when it is booting, or if its
configuration file is corrupted at startup, the system might enter
ROM-monitor mode. Table 1-3 provides a summary of the main command
modes.
Table 1-3 Summary of Main Command Modes
Command Mode Access Method Prompt Exit Method
User EXEC Log in. Router> Use the logout command.Privileged
EXEC
From user EXEC mode, enter the enable EXEC command.
Router# To exit to user EXEC mode, enter the disable command.To
enter global configuration mode, enter the configure terminal
privileged EXEC command.
Global configuration
From privileged EXEC mode, enter the configure terminal
privileged EXEC command.
Router(config)# To exit to privileged EXEC mode, enter the exit
or end command or press Ctrl-Z.To enter interface configuration
mode, enter an interface configuration command.
Interface configuration
From global configuration mode, enter by specifying an interface
with an interface command.
Router(config-if)# To exit to global configuration mode, enter
the exit command. To exit to privileged EXEC mode, enter the exit
command or press Ctrl-Z.To enter subinterface configuration mode,
specify a subinterface with the interface command.1-5Catalyst 6500
Series Switch Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Chapter 1 Command-Line InterfaceUsing the No and Default Forms
of CommandsFor more information on command modes, refer to the
Using the Command Line Interface chapter of the Configuration
Fundamentals Configuration Guide.
Note Prior to Cisco IOS Release 12.1(11b)E, you could issue
EXEC-level commands (such as show, clear, and debug commands) in
EXEC mode only. In Cisco IOS Release 12.1(11b)E or later, you can
issue EXEC-level Cisco IOS commands (such as show, clear, and debug
commands) from within global configuration mode or other modes by
issuing the do command followed by the EXEC command. See the do
command for information on how to use this command.
Using the No and Default Forms of CommandsAlmost every
configuration command has a no form. In general, enter the no form
to disable a function. Use the command without the keyword no to
reenable a disabled function or to enable a function that is
disabled by default. For example, IP routing is enabled by default.
To disable IP routing, specify the no ip routing command and
specify ip routing to reenable it. This publication provides the
complete syntax for the configuration commands and describes what
the no form of a command does.Configuration commands can have a
default form. The default form of a command returns the command
setting to its default. Most commands are disabled by default, so
the default form is the same as the no form. However, some commands
are enabled by default and have arguments that are set to certain
default values. In these cases, the default form of the command
enables the command and sets arguments to their default values.
This publication describes what the default form of a command does
if the command is not the same as the no form.
Subinterface configuration
From interface configuration mode, specify a subinterface with
an interface command.
Router(config-subif)# To exit to global configuration mode,
enter the exit command.To enter privileged EXEC mode, enter the end
command or press Ctrl-Z.
ROM monitor From privileged EXEC mode, enter the reload EXEC
command. Press the Break key during the first 60 seconds while the
system is booting.
Rommon> To exit ROM-monitor mode, you must reload the image
by entering the boot command. If you use the boot command without
specifying a file or any other boot instructions, the system boots
from the default Flash image (the first image in onboard Flash
memory). Otherwise, you can instruct the system to boot from a
specific Flash image (using the boot system flash filename
command).
Table 1-3 Summary of Main Command Modes (continued)
Command Mode Access Method Prompt Exit Method1-6Catalyst 6500
Series Switch Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Chapter 1 Command-Line InterfaceUsing the CLI String SearchUsing
the CLI String SearchThe pattern in the command output is referred
to as a string. The CLI string search feature allows you to search
or filter any show or more command output and allows you to search
and filter at --More-- prompts. This feature is useful when you
need to sort though large amounts of output, or if you want to
exclude output that you do not need to see.With the search
function, you can begin unfiltered output at the first line that
contains a regular expression you specify. You can then specify a
maximum of one filter per command or start a new search from the
--More-- prompt. A regular expression is a pattern (a phrase,
number, or more complex pattern) that software uses to match
against show or more command output. Regular expressions are case
sensitive and allow for complex matching requirements. Examples of
simple regular expressions are Serial, misses, and 138. Examples of
complex regular expressions are 00210..., ( is ), and [Oo]utput.You
can perform three types of filtering:
Use the begin keyword to begin output with the line that
contains a specified regular expression. Use the include keyword to
include output lines that contain a specified regular expression.
Use the exclude keyword to exclude output lines that contain a
specified regular expression.
You can then search this filtered output at the --More--
prompts.
Note The CLI string search function does not allow you to search
or filter backward through previous output; filtering cannot be
specified using HTTP access to the CLI.
Regular ExpressionsA regular expression can be a single
character that matches the same single character in the command
output or multiple characters that match the same multiple
characters in the command output. This section describes how to
create both single-character patterns and multiple-character
patterns and how to create more complex regular expressions using
multipliers, alternation, anchoring, and parentheses.
Single-Character Patterns
The simplest regular expression is a single character that
matches the same single character in the command output. You can
use any letter (A-Z, a-z) or digit (0-9) as a single-character
pattern. You can also use other keyboard characters (such as ! or
~) as single-character patterns, but certain keyboard characters
have special meaning when used in regular expressions. Table 1-4
lists the keyboard characters with special meaning.
Table 1-4 Characters with Special Meaning
Character Special Meaning
. Matches any single character, including white space.* Matches
0 or more sequences of the pattern.+ Matches 1 or more sequences of
the pattern.? Matches 0 or 1 occurrences of the pattern.1-7Catalyst
6500 Series Switch Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Chapter 1 Command-Line InterfaceUsing the CLI String SearchTo
enter these special characters as single-character patterns, remove
the special meaning by preceding each character with a backslash
(\). These examples are single-character patterns matching a dollar
sign, an underscore, and a plus sign, respectively.\$ \_ \+ You can
specify a range of single-character patterns to match against
command output. For example, you can create a regular expression
that matches a string containing one of the following letters: a,
e, i, o, or u. One and only one of these characters must exist in
the string for pattern matching to succeed. To specify a range of
single-character patterns, enclose the single-character patterns in
square brackets ([ ]). For example,[aeiou] matches any one of the
five vowels of the lowercase alphabet, while[abcdABCD] matches any
one of the first four letters of the lower- or uppercase
alphabet.You can simplify ranges by entering only the end points of
the range separated by a dash (-). Simplify the previous range as
follows:[a-dA-D] To add a dash as a single-character pattern in
your range, include another dash and precede it with a
backslash:[a-dA-D\-] You can also include a right square bracket
(]) as a single-character pattern in your range. To do so, enter
the following:[a-dA-D\-\]] The previous example matches any one of
the first four letters of the lower- or uppercase alphabet, a dash,
or a right square bracket. You can reverse the matching of the
range by including a caret (^) at the start of the range. This
example matches any letter except the ones listed: [^a-dqsv] This
example matches anything except a right square bracket (]) or the
letter d:[^\]d]
^ Matches the beginning of the string.$ Matches the end of the
string._ (underscore) Matches a comma (,), left brace ({), right
brace (}), left parenthesis ( ( ),
right parenthesis ( ) ), the beginning of the string, the end of
the string, or a space.
Table 1-4 Characters with Special Meaning (continued)
Character Special Meaning1-8Catalyst 6500 Series Switch Cisco
IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Chapter 1 Command-Line InterfaceUsing the CLI String
SearchMultiple-Character Patterns
When creating regular expressions, you can also specify a
pattern containing multiple characters. You create
multiple-character regular expressions by joining letters, digits,
or keyboard characters that do not have special meaning. For
example, a4% is a multiple-character regular expression. Put a
backslash in front of the keyboard characters that have special
meaning when you want to remove their special meaning.
With multiple-character patterns, order is important. The
regular expression a4% matches the character a followed by a 4
followed by a % sign. If the string does not have a4%, in that
order, pattern matching fails. This multiple-character regular
expressiona.
uses the special meaning of the period character to match the
letter a followed by any single character. With this example, the
strings ab, a!, or a2 are all valid matches for the regular
expression. You can remove the special meaning of the period
character by putting a backslash in front of it. In the following
expressiona\. only the string a. matches this regular
expression.
You can create a multiple-character regular expression
containing all letters, all digits, all keyboard characters, or a
combination of letters, digits, and other keyboard characters.
These examples are all valid regular expressions:telebit 3107
v32bis
Multipliers
You can create more complex regular expressions to match
multiple occurrences of a specified regular expression by using
some special characters with your single- and multiple-character
patterns. Table 1-5 lists the special characters that specify
multiples of a regular expression.
This example matches any number of occurrences of the letter a,
including none:a*
This pattern requires that at least one letter a in the string
is matched: a+
This pattern matches the string bb or bab:ba?b This string
matches any number of asterisks (*):\**
Table 1-5 Special Characters Used as Multipliers
Character Description
* Matches 0 or more single- or multiple-character patterns.+
Matches 1 or more single- or multiple-character patterns.? Matches
0 or 1 occurrences of the single- or multiple-character
patterns.1-9Catalyst 6500 Series Switch Cisco IOS Command
ReferenceRelease 12.1 E
78-14058-05
-
Chapter 1 Command-Line InterfaceUsing the CLI String SearchTo
use multipliers with multiple-character patterns, you enclose the
pattern in parentheses. In the following example, the pattern
matches any number of the multiple-character string ab:(ab)* As a
more complex example, this pattern matches one or more instances of
alphanumeric pairs (but not none; that is, an empty string is not a
match):([A-Za-z][0-9])+ The order for matches using multipliers (*,
+, or ?) is to put the longest construct first. Nested constructs
are matched from outside to inside. Concatenated constructs are
matched beginning at the left side of the construct. Thus, the
regular expression matches A9b3, but not 9Ab3 because the letters
are specified before the numbers.
AlternationAlternation allows you to specify alternative
patterns to match against a string. You separate the alternative
patterns with a vertical bar or pipe (|). Exactly one of the
alternatives can match the string. For example, the regular
expression
codex | telebit matches the string codex or the string telebit,
but not both codex and telebit.
AnchoringYou can match a regular expression pattern against the
beginning or the end of the string. That is, you can specify that
the beginning or end of a string contains a specific pattern. You
anchor these regular expressions to a portion of the string using
the special characters shown in Table 1-6.
This regular expression matches a string only if the string
starts with abcd:^abcd In contrast, this expression is in a range
that matches any single letter, as long as it is not the letters a,
b, c, or d:[^abcd] With this example, the regular expression
matches a string that ends with .12:$\.12 Contrast these anchoring
characters with the special character underscore (_). The
underscore matches the beginning of a string (^), the end of a
string ($), parentheses ( ), space ( ), braces { }, comma (,), or
underscore (_). With the underscore character, you can specify that
a pattern exist anywhere in the string.
Table 1-6 Special Characters Used for Anchoring
Character Description
^ Matches the beginning of the string. $ Matches the end of the
string.1-10Catalyst 6500 Series Switch Cisco IOS Command
ReferenceRelease 12.1 E
78-14058-05
-
Chapter 1 Command-Line InterfaceSaving Configuration ChangesFor
example: _1300_ matches any string that has 1300 somewhere in the
string. The strings 1300 can be preceded by or end with a space,
brace, comma, or underscore. For example:{1300_ matches the regular
expression, but 21300 and 13000 do not. Using the underscore
character, you can replace long regular expression lists, such as
the following: ^1300$ ^1300(space) (space)1300 {1300, ,1300, {1300}
,1300, (1300 with
_1300_
Parentheses for RecallAs shown in the Multipliers section on
page 1-9, you use parentheses with multiple-character regular
expressions to multiply the occurrence of a pattern. You can also
use parentheses around a single- or multiple-character pattern to
remember a pattern for use elsewhere in the regular expression.To
create a regular expression that recalls a previous pattern, you
use parentheses to indicate a remembered specific pattern and a
backslash (\) followed by an integer to reuse the remembered
pattern. The integer specifies the occurrence of the parentheses in
the regular expression pattern. If you have more than one
remembered pattern in your regular expression, then \1 indicates
the first remembered pattern, \2 indicates the second remembered
pattern, and so on. This regular expression uses parentheses for
recall:
a(.)bc(.)\1\2 This regular expression matches an a followed by
any character (call it character 1), followed by bc, followed by
any character (character 2), followed by character 1 again, and
followed by character 2 again. The regular expression can match
aZbcTZT. The software remembers that character 1 is Z and character
2 is T and then uses Z and T again later in the regular
expression.
Saving Configuration ChangesTo save your configuration changes
to your startup configuration so that they will not be lost if
there is a system reload or power outage, enter the following
command:Router# copy system:running-config
nvram:startup-configBuilding configuration...
It might take a minute or two to save the configuration. After
the configuration has been saved, the following output
appears:[OK]Router#
On most platforms, this step saves the configuration to NVRAM.
On the Class A Flash file system platforms, this step saves the
configuration to the location specified by the CONFIG_FILE
environment variable. The CONFIG_FILE environment variable defaults
to NVRAM.1-11Catalyst 6500 Series Switch Cisco IOS Command
ReferenceRelease 12.1 E
78-14058-05
-
Chapter 1 Command-Line InterfaceSaving Configuration
Changes1-12Catalyst 6500 Series Switch Cisco IOS Command
ReferenceRelease 12.1 E
78-14058-05
-
Catalyst 6500 Series Switch Cisco IO78-14058-05C H A P T E R
2Cisco IOS Commands for the Catalyst 6500 Series Switches
This chapter contains an alphabetical listing of Cisco IOS
commands unique to the Catalyst 6500 series switches. For
information about Cisco IOS commands not contained in this
publication, refer to the current Cisco IOS documentation
including:
Cisco IOS Release 12.1 Configuration Fundamentals Configuration
Guide Cisco IOS Release 12.1 Command Reference2-1S Command
ReferenceRelease 12.1 E
-
Chapter 2 Cisco IOS Commands for the Catalyst 6500 Series
SwitchesactionactionTo set the packet action clause, use the action
command. Use the no form of this command to remove an action
clause.
action {{drop [log]} | {forward [capture]} | {redirect
{interface interface-number}} | {port-channel channel-id}
{interface interface-number} | {port-channel channel-id} ...}
no action {{drop [log]} | {forward [capture]} | {redirect
{interface interface-number}} | {port-channel channel-id}
{interface interface-number} | {port-channel channel-id} ...}
Syntax Description
Defaults This command has no default settings.
Command Modes VLAN access-map submode
Command History
Usage Guidelines The interface-number argument designates the
module and port number. Valid values for interface-number depend on
the specified interface type and the chassis and module used. For
example, if you specify a Gigabit Ethernet interface and have a
48-port 10/100BASE-T Ethernet module installed in a 13-slot
chassis, valid values for the module number are from 2 to 13 and
valid values for the port number are from 1 to 48.Each redirect
action allows you to specify a list of up to five destination
interfaces. There is also a limit of up to 255 different interface
lists that can be used by redirect actions.
drop Drops the packets.log (Optional) Logs the dropped packets
in software.forward Forwards (switched by hardware) the packets to
its destination.capture (Optional) Sets the capture bit for the
forwarded packets so that ports with
the capture function enabled also receive the packets.redirect
interface Redirects packets to the specified interfaces; possible
valid values are
ethernet, fastethernet, gigabitethernet, tengigabitethernet,
pos, atm, and ge-wan.
interface-number Module and port number; see the Usage
Guidelines section for valid values.
port-channel channel-id
Port channel to redirect traffic; see the Usage Guidelines
section for valid values.
Release Modification
12.1(8a)EX Support for this command was introduced on the
Catalyst 6500 series switches.
12.1(11b)E This command was changed to include the ge-wan, atm,
and pos keywords.2-2Catalyst 6500 Series Switch Cisco IOS Command
ReferenceRelease 12.1 E
78-14058-05
-
Chapter 2 Cisco IOS Commands for the Catalyst 6500 Series
SwitchesactionThe redirect action supports interface lists instead
of single interfaces as shown in the following example:
[...] {redirect {{ethernet | fastethernet | gigabitethernet |
tengigabitethernet} slot/port} | {port-channel channel-id}}
The action clause specifies the action to be taken when a match
occurs. The number of valid values for port-channel number depends
on the software release. For releases prior to Release 12.1(3a)E3,
valid values are from 1 to 256; for Releases 12.1(3a)E3,
12.1(3a)E4, and 12.1(4)E1, valid values are from 1 to 64. Release
12.1(5c)EX and later support a maximum of 64 values ranging from 1
to 256. Release 12.1(13)E and later support a maximum of 64 values
ranging from 1 to 282; values 257 to 282 are supported on the CSM
and FWSM only.The forwarded packets are subject to any applied
Cisco IOS ACLs. The capture action sets the capture bit in
VACL-forwarded packets. Ports with the capture function enabled can
receive VACL-forwarded packets that have the capture bit set. Only
VACL-forwarded packets that have the capture bit set can be
captured. The log option is supported on Supervisor Engine 2 only.
When the log option is specified, dropped packets are logged in
software. Only dropped IP packets can be logged. The redirect
option allows you to specify up to five interfaces, which can be
physical interfaces or EtherChannels. An EtherChannel member is not
allowed to be a redirect interface.The log and redirect keywords
are not supported for VACLs on WAN interfaces.The action clause in
a VACL can be forward, drop, capture, or redirect. Traffic can also
be logged. VACLs applied to WAN interfaces do not support the
redirect or log actions.For systems with a Supervisor Engine 1, the
redirect interface must be in the redirected packets source
VLAN.
For systems with a Supervisor Engine 2, the redirect interface
must be in the VLAN for which the VACL map is configured. In a VLAN
access map, if at least one ACL is configured for a packet type
(IP, IPX, or MAC), the default action for the packet type is drop
(deny).If an ACL is not configured for a packet type, the default
action for the packet type is forward (permit). If an ACL for a
packet type is configured and the ACL is empty or undefined, the
configured action will be applied to the packet type.
Examples This example shows how to define a drop and log action:
Router(config-access-map)# action drop log
Router(config-access-map)#
This example shows how to define a forward action:
Router(config-access-map)# action forward
Router(config-access-map)#
Related Commands show vlan access-mapvlan access-map2-3Catalyst
6500 Series Switch Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Chapter 2 Cisco IOS Commands for the Catalyst 6500 Series
SwitchesapplyapplyTo implement the proposed new VLAN database,
increment the database configuration number, save it in NVRAM, and
propagate it throughout the administrative domain, use the apply
command.
apply
Syntax Description This command has no arguments or
keywords.
Defaults This command has no default settings.
Command Modes VLAN configuration
Command History
Usage Guidelines The apply command implements the configuration
changes you made after you entered VLAN database mode and uses them
for the running configuration. This command keeps you in VLAN
database mode.You cannot use this command when the Catalyst 6500
series switch is in the VTP client mode.You can verify that VLAN
database changes occurred by entering the show vlan command in
privileged EXEC mode.
Examples This example shows how to implement the proposed new
VLAN database and recognize it as the current
database:Router(config-if-vlan)# applyRouter(config-if-vlan)#
Related Commands abort (refer to the Cisco IOS Release 12.1
Command Reference)exit (refer to the Cisco IOS Release 12.1 Command
Reference)resetshow vlanshutdown vlan (refer to the Cisco IOS
Release 12.1 Command Reference)vtp
Release Modification
12.0(7)XE Support for this command was introduced on the
Catalyst 6500 series switches.
12.1(1)E Support for this command on the Catalyst 6500 series
switches was extended to the 12.1 E release.2-4Catalyst 6500 Series
Switch Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Chapter 2 Cisco IOS Commands for the Catalyst 6500 Series
SwitchesattachattachTo remotely connect to a specific module, use
the attach command.
attach num
Syntax Description
Defaults This command has no default settings.
Command Modes Privileged EXEC
Command History
Usage Guidelines
Caution When you enter the attach or remote login command to
access another console from your switch, if you enter global or
interface configuration mode commands, the switch might reset.
The valid values for num depend on the chassis used. For
example, if you have a 13-slot chassis, valid values for the module
number are from 1 to 13.This command is supported on DFC-equipped
modules and the supervisor engine only.When you execute the attach
num command, the prompt changes to Router-dfcx# or Switch-sp#,
depending on the type of module to which you are connecting.The
attach command is identical to the remote login module num
command.There are two ways to end this session:
You can enter the exit command as follows:Router-dfc3# exit
[Connection to Switch closed by foreign host]Router#
You can press Ctrl-C three times as follows:Router-dfc3#
^CRouter-dfc3# ^CRouter-dfc3# ^CTerminate remote login session?
[confirm] y[Connection to Switch closed by local host]
num Module number; see the Usage Guidelines section for valid
values.
Release Modification
12.1(5c)EX Support for this command was introduced on the
Catalyst 6500 series switches.
12.1(8a)E Support for this command on the Catalyst 6500 series
switches was extended to the 12.1 E release.2-5Catalyst 6500 Series
Switch Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Chapter 2 Cisco IOS Commands for the Catalyst 6500 Series
SwitchesattachRouter#2-6Catalyst 6500 Series Switch Cisco IOS
Command ReferenceRelease 12.1 E
78-14058-05
-
Chapter 2 Cisco IOS Commands for the Catalyst 6500 Series
SwitchesattachExamples This example shows how to remotely log in to
the DFC-equipped module:Console (enable)# attach 3Trying Switch
...Entering CONSOLE for SwitchType "^C^C^C" to end this session
Router-dfc3#
Related Commands remote login2-7Catalyst 6500 Series Switch
Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Chapter 2 Cisco IOS Commands for the Catalyst 6500 Series
Switchesauto-syncauto-syncTo enable automatic synchronization of
the configuration files in NVRAM, use the auto-sync command. Use
the no form of this command to disable automatic
synchronization.
auto-sync {startup-config | config-register | bootvar |
running-config | standard}no auto-sync {startup-config |
config-register | bootvar | standard}
Syntax Description
Defaults running-config
Command Modes Main-cpu redundancy mode
Command History
Usage Guidelines For releases prior to Release 12.1(13)E, the
default is standard.If you enter the no auto-sync standard command,
no automatic synchronizations occur. If you want to enable any of
the options, you have to enter the appropriate command for each
option.The auto-sync commands are not supported in RPR+ mode.
Examples This example shows how (from the default configuration)
to enable automatic synchronization of the configuration register
in the main CPU:Router# configure terminalRouter (config)#
redundancyRouter (config-r)# main-cpuRouter (config-r-mc)# no
auto-sync standardRouter (config-r-mc)# auto-sync
configure-registerRouter (config-r-mc)#
startup-config Automatic synchronization of the startup
configuration.config-register Automatic synchronization of the
configuration register configuration.bootvar Automatic
synchronization of the BOOTVAR configuration.running-config
Automatic synchronization of the running configuration.standard
Automatic synchronization of the startup-config, BOOTVAR, and
config-registers.
Release Modification
12.0(7)XE Support for this command was introduced on the
Catalyst 6500 series switches.12.1(1)E Support for this command on
the Catalyst 6500 series switches was extended to
the 12.1 E release.12.1(13)E This command was changed to include
the running-config keyword and
change the default to running-config.2-8Catalyst 6500 Series
Switch Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Chapter 2 Cisco IOS Commands for the Catalyst 6500 Series
Switchesauto-syncRelated Commands redundancy2-9Catalyst 6500 Series
Switch Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Chapter 2 Cisco IOS Commands for the Catalyst 6500 Series
Switchesboot configboot configTo specify the device and filename of
the configuration file from which the system configures itself
during initialization (startup), use the boot config command. Use
the no form of this command to remove the specification.
boot config {device:file-name}no boot config
Syntax Description
Defaults The configuration file is located in NVRAM.
Command Modes Global configuration
Command History
Usage Guidelines The configuration file must be an ASCII file
located in the specified file system.disk0: is a Class C file
system.bootflash:, slot0:, slot1:, and sup-bootflash: are Class A
file systems.For Class A Flash file systems, the CONFIG_FILE
environment variable specifies the file system and filename of the
configuration file to use for initialization (startup). You set the
CONFIG_FILE environment variable in the current running memory when
you use the boot config command. This variable specifies the
configuration file used for initialization (startup). When you use
the boot config command, you affect only the running configuration.
You must save the environment variable setting to your startup
configuration to place the information under ROM monitor control
and to have the environment variable function as expected. Use the
copy system:running-config nvram:startup-config command to save the
environment variable from your running configuration to your
startup configuration.The software displays an error message and
does not update the CONFIG_FILE environment variable in the
following situations:
You specify nvram: as the file system, and it contains only a
distilled version of the configuration. (A distilled configuration
does not contain access lists.)
You specify a configuration file in the filename argument that
does not exist or is not valid.
device: Device identification; valid values are bootflash:,
const_nvram:, flash:, nvram:, slot0:, sup-bootflash:, or
disk0:.
file-name Configuration filename.
Release Modification
12.0(7)XE Support for this command was introduced on the
Catalyst 6500 series switches.
12.1(1)E Support for this command on the Catalyst 6500 series
switches was extended to the 12.1 E release.2-10Catalyst 6500
Series Switch Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Chapter 2 Cisco IOS Commands for the Catalyst 6500 Series
Switchesboot configDuring initialization, the NVRAM configuration
is used when the CONFIG_FILE environment variable does not exist or
when it is null (such as at a first-time startup). If the software
detects a problem with NVRAM or the configuration it contains, the
device enters setup mode. When you use the no form of this command,
the NVRAM configuration is used as the startup configuration.
You can view the contents of the BOOT, BOOTLDR, and the
CONFIG_FILE environment variables using the show bootvar command.
This command displays the settings for these variables as they
exist in the startup configuration as well as in the running
configuration if a running configuration setting differs from a
startup configuration setting.The disk0: keyword is supported only
on systems configured with a Supervisor Engine 2.
Examples This example shows how to set the configuration file
located in the internal Flash memory to configure itself during
initialization. The third line copies the specification to the
startup configuration, ensuring that this specification takes
effect upon the next reload.Router (config)# boot config
flash:router-configRouter (config)# endRouter# copy
system:running-config nvram:startup-configRouter#
Related Commands copy system:running-config nvram:startup-config
(refer to the Cisco IOS Release 12.1 Command Reference)show
bootvar2-11Catalyst 6500 Series Switch Cisco IOS Command
ReferenceRelease 12.1 E
78-14058-05
-
Chapter 2 Cisco IOS Commands for the Catalyst 6500 Series
SwitchescdcdTo change the default directory or file system, use the
cd command.
cd [filesystem:][directory]
Syntax Description
Defaults Initial default file system is slot0:.
Command Modes EXEC
Command History
Usage Guidelines For all EXEC commands that have an optional
filesystem argument, the system uses the file system specified by
the cd command when you omit the optional filesystem argument. For
example, the dir command, which displays a list of files on a file
system, contain an optional filesystem argument. When you omit this
argument, the system lists the files on the file system specified
by the cd command.If you do not specify a directory on a file
system, the default is the root directory on that file system.The
disk0: keyword is supported only on systems configured with a
Supervisor Engine 2.
Examples This example sets the default file system to the Flash
PC card inserted in slot 0:Router# cd slot0:Router# pwdslot0:/
filesystem: (Optional) URL, alias of the directory, or file
system followed by a colon; valid values are bootflash:,
const_nvram:, flash:, nvram:, slot0:, sup-bootflash:, sup-image:,
sup-slot0:, or disk0:.
directory (Optional) Name of the directory.
Release Modification
12.0(7)XE Support for this command was introduced on the
Catalyst 6500 series switches.12.1(1)E Support for this command on
the Catalyst 6500 series switches was extended to
the 12.1 E release.12.1(8a)EX This command was changed to
support the disk0: keyword.2-12Catalyst 6500 Series Switch Cisco
IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Chapter 2 Cisco IOS Commands for the Catalyst 6500 Series
SwitchescdRelated Commands copy (refer to the Cisco IOS Release
12.1 Command Reference)delete (refer to the Cisco IOS Release 12.1
Command Reference)dir (refer to the Cisco IOS Release 12.1 Command
Reference)mkdir disk0:pwd (refer to the Cisco IOS Release 12.1
Command Reference)show file system (refer to the Cisco IOS Release
12.1 Command Reference)undelete2-13Catalyst 6500 Series Switch
Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Chapter 2 Cisco IOS Commands for the Catalyst 6500 Series
Switchescd2-14Catalyst 6500 Series Switch Cisco IOS Command
ReferenceRelease 12.1 E
78-14058-05
-
Chapter 2 Cisco IOS Commands for the Catalyst 6500 Series
Switcheschannel-group
2-15Catalyst 6500 Series Switch Cisco IOS Command
ReferenceRelease 12.1 E
2 278-14058-05channel-groupTo assign and configure an
EtherChannel interface to an EtherChannel group, use the
channel-group command. Use the no form of this command to remove
the channel-group configuration from the interface.
channel-group number mode {active | on | {auto [non-silent]} |
{desirable [non-silent]} | passive}
no channel-group number
Syntax Description
Defaults No channel groups are assigned.
Command Modes Interface configuration
Command History
number Specifies the channel group number; see the Usage
Guidelines section for valid values.
mode EtherChannel mode of the interface.active Enables LACP
unconditionally.on Enables EtherChannel only. auto Places a port
into a passive negotiating state in which the port responds to
PAgP packets it receives but does not initiate PAgP packet
negotiation.non-silent (Optional) Used with the auto or desirable
mode when traffic is expected
from the other device. desirable Places a port into an active
negotiating state in which the port initiates
negotiations with other ports by sending PAgP packets.passive
Enables LACP only if an LACP device is detected.
Release Modification
12.0(7)XE Support for this command was introduced on the
Catalyst 6500 series switches.
12.1(1)E Support for this command on the Catalyst 6500 series
switches was extended to the 12.1 E release.
12.1(3a)E3 The number of valid values for number was changed;
see the Usage Guidelines section for valid values.
12.1(5c)EX Two restrictions were added regarding DFC-equipped
modules; see the Usage Guidelines section for additional
information.
12.1(11b)EX This command was changed to support LACP.12.1(13)E
This command was changed to support the configuration of Layer
2
EtherChannels that include interfaces on different DFC-equipped
switching modules. CSCdt27074
-
Chapter 2 Cisco IOS Commands for the Catalyst 6500 Series
Switcheschannel-groupUsage Guidelines The number of valid values
for the channel-group number depends on the software release. For
releases prior to Release 12.1(3a)E3, valid values are from 1 to
256; for Releases 12.1(3a)E3, 12.1(3a)E4, and 12.1(4)E1, valid
values are from 1 to 64. Release 12.1(5c)EX and later support a
maximum of 64 values ranging from 1 to 256. Release 12.1(13)E and
later support a maximum of 64 values ranging from 1 to 282; values
257 to 282 are supported on the CSM and FWSM only.The channel group
number is global and is shared between all the channeling
protocols. If a specific channel number is used for the
PAgP-enabled interfaces of a channel group, that same channel
number cannot be used for configuring a channel that has
LACP-enabled interfaces or vice versa.Entering the auto or
desirable keyword enables PAgP on the specified interface; the
command will be rejected if it is issued on an LACP-enabled
interface.The active and passive keywords are valid on
PAgP-disabled interfaces only.You can change the mode for an
interface only if it is the only interface designated to the
specified channel group. The on keyword forces the bundling of the
interface on the channel without any negotiation.You can manually
configure a switch with PAgP on one side and LACP on the other side
in the on mode. With the on mode, a usable EtherChannel exists only
when a port group in on mode is connected to another port group in
on mode. If you enter this command on an interface that is added to
a channel with a different protocol (than the protocol you are
entering), the command is rejected. If the interface belongs to a
channel, the no form of this command is rejected.All ports in an
EtherChannel must use the same protocol; you cannot run two
protocols on one module. PAgP and LACP are not compatible; both
ends of a channel must use the same protocol. You can change the
protocol at any time, but this change causes all existing
EtherChannels to reset to the default channel mode for the new
protocol. Configure all ports in an EtherChannel to operate at the
same speed and duplex mode (full duplex only for LACP mode).On
systems configured with nonfabric-enabled modules and
fabric-enabled modules, you can bundle ports across all modules,
but those bundles cannot include a DFC-equipped module port.You do
not have to create a port channel interface before assigning a
physical interface to a channel group. A port channel interface is
created automatically when the channel group gets its first
physical interface, if it is not already created.You do not have to
disable the IP address that is assigned to a physical interface
that is part of a channel group, but it is highly recommended.You
can create both Layer 2 and Layer 3 port channels by entering the
interface port-channel command or when the channel group gets its
first physical interface assignment. The port channels are not
created at runtime or dynamically.Any configuration or attribute
changes you make to the port channel interface are propagated to
all interfaces within the same channel group as the port channel
(for example, configuration changes are also propagated to the
physical interfaces that are not part of the port channel but are
part of the channel group).
Caution Do not enable Layer 3 addresses on the physical
EtherChannel interfaces. Assigning bridge groups on the physical
EtherChannel interfaces causes loops in your network. 2-16Catalyst
6500 Series Switch Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Chapter 2 Cisco IOS Commands for the Catalyst 6500 Series
Switcheschannel-groupFor a complete list of guidelines, refer to
the Configuring EtherChannel section of the Catalyst 6500 Series
Switch Cisco IOS Software Configuration Guide.
Examples This example shows how to add EtherChannel interface
1/0 to the EtherChannel group specified by port-channel
1:Router(config-if)# channel-group 1 mode on Router(config-if)#
Related Commands interface port-channelshow interfaces
port-channel (refer to the Cisco IOS Release 12.1 Command
Reference)2-17Catalyst 6500 Series Switch Cisco IOS Command
ReferenceRelease 12.1 E
78-14058-05
-
Chapter 2 Cisco IOS Commands for the Catalyst 6500 Series
Switcheschannel-protocolchannel-protocolTo set the protocol used on
an interface to manage channeling, use the channel-protocol
command. Use the no form of this command to deselect the
protocol.
channel-protocol {lacp | pagp}no channel-protocol
Syntax Description
Defaults pagp
Command Modes Interface configuration
Command History
Usage Guidelines This command is not supported on systems
configured with a Supervisor Engine 1.You can also select the
protocol using the channel-group command.If the interface belongs
to a channel, the no form of this command is rejected.All ports in
an EtherChannel must use the same protocol. PAgP and LACP are not
compatible; both ends of a channel must use the same protocol. You
can change the protocol at any time, but this change causes all
existing EtherChannels to reset to the default channel mode for the
new protocol. You can use the channel-protocol command to restrict
anyone from selecting a mode that is not applicable to the selected
protocol.Configure all ports in an EtherChannel to operate at the
same speed and duplex mode (full duplex only for LACP mode).For a
complete list of guidelines, refer to the Configuring EtherChannel
section of the Catalyst 6500 Series Switch Cisco IOS Software
Configuration Guide.
lacp Specifies LACP to manage channeling.pagp Specifies PAgP to
manage channeling.
Release Modification
12.1(11b)EX Support for this command was introduced on the
Catalyst 6500 series switches.
12.1(13)E Support for this command on the Catalyst 6500 series
switches was extended to the 12.1 E release. This command was
changed to support the entry of the no channel-protocol command
(without arguments) to deselect the protocol.2-18Catalyst 6500
Series Switch Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Chapter 2 Cisco IOS Commands for the Catalyst 6500 Series
Switcheschannel-protocolExamples This example shows how to select
LACP to manage channeling on the interface:Router(config-if)#
channel-protocol lacpRouter(config-if)#
Related Commands channel-groupshow etherchannel2-19Catalyst 6500
Series Switch Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Chapter 2 Cisco IOS Commands for the Catalyst 6500 Series
Switchesclass-mapclass-mapTo access the QoS class map configuration
mode to configure QoS class maps, use the class-map command. Use
the no form of this command to delete a class map.
class-map name [match-all | match-any]no class-map name
[match-all | match-any]
Syntax Description
Defaults When you do not specify the match-all or match-any
option, the default is match-all.
Command Modes Global configuration
Command History
Usage Guidelines You apply the class-map command and its
subcommands on a per-interface basis to define packet
classification, marking, aggregate, and flow policing as part of a
globally named service policy. After you are in QoS class map
configuration mode, these configuration commands are available:
exitUsed to exit from QoS class map configuration mode. noUsed
to remove a match statement from a class map. matchUsed to
configure classification criteria.
These optional match subcommands are available: access-group
{acl-index | acl-name} ip {dscp | precedence} value1 value2 ...
value8
These subcommands appear in the CLI help but are not supported
on LAN interfaces or WAN interfaces on the OSMs:
input-interface {{interface interface-number} | {null number} |
{vlan vlan-id}} protocol linktype destination-address mac
mac-address source-address mac mac-address
name Class map name.match-all (Optional) Matches all match
criteria in the class map.match-any (Optional) Matches one or more
match criteria.
Release Modification
12.0(7)XE Support for this command was introduced on the
Catalyst 6500 series switches.
12.1(1)E Support for this command on the Catalyst 6500 series
switches was extended to the 12.1 E release.2-20Catalyst 6500
Series Switch Cisco IOS Command ReferenceRelease 12.1 E
78-14058-05
-
Chapter 2 Cisco IOS Commands for the Catalyst 6500 Series
Switchesclass-mapPFC QoS does not support these subcommands:
input-interface {{interface interface-number} | {null number} |
{vlan vlan-id}} protocol linktype destination-address mac
mac-address source-address mac mac-address qos-group
group-value
If you enter these subcommands, PFC QoS does not detect the
unsupported keywords until you attach a policy map to an interface.
When you try to attach the policy map to an interface, you get an
error message. For additional information, refer to the Catalyst
6500 Series Switch Cisco IOS Software Configuration Guide and the
Cisco IOS Command Reference publications.After you have configured
the class map name and are in class map configuration mode, you can
enter the match subcommands. The syntax for these subcommands is as
follows:
match {[{access-group acl-index} | acl-name] | [{ip dscp} |
{precedence value}]}See Table 2-1 for a syntax description of the
match subcommands.
Examples This example shows how to access the class-map commands
and subcommands, configure a class map named ipp5, and enter a
match statement for ip precedence 5:Router# configure terminalEnter
configuration commands, one per line. End with
CNTL/Z.Router(config)# class-map ipp5Router(config-cmap)# match ip
precedence 5Router(config-cmap)#
This example shows how to configure the class map to match an
already configured access list:Router(config-cmap)# match
access-group IPacl1Router(config-cmap)#
Related Commands policy-mapshow class-mapshow policy-mapshow
policy-map interface
Table 2-1 match Syntax Description
Optional Subcommand Description
access-group acl-index | acl-name
Specifies the access list index or access list names; valid
access list index values are from 1 to 2699.
access-group acl-name
Specifies the named access list.
ip dscp value1 value2 ... value8
Specifies IP DSCP values to match; valid values are from 0 to
63. Enter up to 8 DSCP values separated by white spaces.
ip precedence value1 value2 ... value8