Sunteți pe pagina 1din 870

You'll be entered into a quarterly drawing for free Cisco Press books by returning this survey! Cisco is dedicated to customer satisfaction and would like to hear your thoughts on these printed manuals. Please visit the Cisco Product Comments on-line survey at www.cisco.com/go/crc to submit your comments about accessing Cisco technical manuals. Thank you for your time

General Information

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 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference

Part Number:

78-15907-01

S/W Release (if applicable):

8.2(1)GLX

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

The information I found was useful to my job.

technical level of understanding.

Please comment on our lowest scores:

Mailing Information

Organization

Date

Contact Name

Mailing Address

City

State/Province

 

Zip/Postal Code

Country

Phone (

)

Extension

E-mail

Fax

(

)

May we contact you further concerning our documentation?

Yes

No

You can also send us your comments by e-mail to bug-doc@cisco.com, or by fax to 408-527-8089.

When mailing this card from outside of the United States, please enclose in an envelope addressed to the location on the back of this card with the required postage or fax to 1-408-527-8089.

DOCUMENT RESOURCE CONNECTION CISCO SYSTEMS INC 170 WEST TASMAN DR SAN JOSE CA 95134-9916

POSTAGE WILL BE PAID BY ADDRESSEE

BUSINESS REPLY MAIL

FIRST-CLASS MAIL

PERMIT NO. 4631

SAN JOSE CA

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference Software
Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference Software

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference

Software Release 8.2(1)GLX

Corporate Headquarters Cisco Systems, Inc. 170 West Tasman Drive

San Jose, CA 95134-1706 USA http://www.cisco.com

Tel:

408 526-4000

Fax:

800 553-NETS (6387) 408 526-4100

Customer Order Number: DOC-7815907= Text Part Number: 78-15907-01

526-4000 Fax: 800 553-NETS (6387) 408 526-4100 Customer Order Number: DOC-7815907= Text Part Number: 78-15907-01

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.

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)

Command Reference—Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Copyright © 2003 Cisco Systems, Inc. All rights reserved.

CONTENTS
CONTENTS

Preface

xix

Audience xix

Organization xix

Related Documentation

Conventions xx

Obtaining Documentation

Obtaining Technical Assistance

Obtaining Additional Publications and Information

xx

xxi

xxii

xxiv

CHAPTER

1

Command-Line Interface

1-1

 

Switch CLI

1-1

ROM

Monitor CLI

1-15

CHAPTER

2

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G

Switch and ROM Monitor Commands

2-1

alias

2-2

boot

2-3

cd

2-4

clear

alias

2-5

clear

arp 2-6

 

clear

banner motd

2-7

clear

boot—ROM monitor

2-8

clear

boot—switch 2-9

clear

cam

2-10

clear

cgmp statistics

2-12

clear

config pvlan

2-13

clear

config—ROM monitor

2-14

clear

config—switch 2-15

clear

counters 2-17

 

clear

crypto key rsa

2-18

clear

dot1x config

2-19

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX iii 78-15907-01

iii

78-15907-01

Contents

clear gmrp statistics clear gvrp statistics clear igmp filter

clear igmp filter map

clear igmp filter profile

2-22

2-20

2-21

2-23

2-24

clear ip alias

2-25

clear ip dns server clear ip permit

2-28

clear ip dns domain

2-27

2-26

clear ip route—ROM monitor

clear ip route—switch

clear kerberos clients mandatory

clear kerberos credentials forward

2-30

2-31

2-32

2-33

clear kerberos creds

2-34

clear kerberos realm

2-35

clear kerberos server

2-36

clear kerberos srvtab entry

clear key config-key

clear lacp-channel statistics

clear localusers

clear log

2-38

2-40

2-41

2-37

2-39

clear log command clear logging buffer clear logging level

clear log command clear logging buffer clear logging level
clear log command clear logging buffer clear logging level

2-42

2-43

2-44

clear logging server clear multicast router

2-45

2-46

2-47

clear ntp key clear ntp server

2-48

clear ntp timezone

2-50

clear port security

2-49

clear port host

2-51

clear pvlan mapping

2-52

clear qos config

2-53

clear qos defaultcos

2-54

clear qos map

2-55

iv

clear qos defaultcos 2-54 clear qos map 2-55 iv Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX,

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

78-15907-01

Contents

clear radius key

clear radius server

clear rcp

2-58

2-56

2-57

clear snmp access

2-59

clear snmp access-list

2-60

clear snmp community

2-61

clear snmp community-ext

2-62

clear snmp group

2-63

clear snmp notify

2-64

clear snmp targetaddr

clear snmp targetparams

2-65

2-66

clear snmp trap

2-67

clear snmp user

2-68

clear snmp view

2-69

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 redetected-protocols

clear spantree root

clear spantree statistics clear spantree uplinkfast

clear tacacs key

2-70

2-71

2-72

2-73

2-75

2-76

2-77

2-78

2-79

2-80

2-82

2-84

2-85

clear tacacs server clear timezone

2-87

2-86

clear top

2-88

clear trunk

2-89

clear vlan

2-90

clear vlan mapping

2-92

clear vmps rcp

2-93

clear vmps server

2-94

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX v 78-15907-01

v

78-15907-01

Contents

clear vmps statistics

2-95

clear vtp pruning

2-96

clear vtp statistics configure 2-98 confreg 2-100

2-97

copy

2-102

del

2-106

 

delete

2-107

dir—ROM monitor

2-108

dir—switch

2-109

disable

2-112

disconnect

2-113

download

2-114

enable

2-117

format

2-118

help—ROM monitor

history—ROM monitor

history—switch

2-120

2-121

2-122

l2trace

2-123

meminfo

2-125

ping—ROM monitor

2-126

ping—switch

2-127

pwd

2-130

quit

2-131

reconfirm vmps

2-132

repeat

2-133

reset—ROM monitor

reset—switch

session

set

set accounting commands

set accounting connect set accounting exec set accounting suppress set accounting system

2-138

2-135

2-136

2-139

2-140

2-142

2-144

2-146

2-147

vi

2-138 2-135 2-136 2-139 2-140 2-142 2-144 2-146 2-147 vi Catalyst 4500 Series, Catalyst 2948G, Catalyst

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

78-15907-01

Contents

set accounting update

set alias

2-150

set arp

2-151

2-149

set authentication enable set authentication login

set authorization commands set authorization enable

set authorization exec

2-153

2-156

2-159

2-161

2-163

set banner motd

2-165

set banner telnet

2-166

set boot auto-config set boot config-register

set boot sync now

set boot system flash

2-167

2-171

2-168

2-172

set cam

2-174

set cam agingtime

2-176

set cam notification

2-177

set cdp

2-179

set cgmp

2-181

 

2-182

set cgmp fastleave set cgmp leave

2-183

2-184

set channel cost

set channelprotocol set channel vlancost set config mode set crypto key rsa

set channelprotocol set channel vlancost set config mode set crypto key rsa
set channelprotocol set channel vlancost set config mode set crypto key rsa
set channelprotocol set channel vlancost set config mode set crypto key rsa

2-185

2-186

2-187

2-189

set dot1q-all-tagged

set dot1x

set enablepass

set errdisable-timeout

set errordetection set feature mdg set garp timer

set gmrp

set gmrp fwdall

2-190

2-192

2-195

2-196

2-198

2-199

2-200

2-203

2-202

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX vii 78-15907-01

vii

78-15907-01

Contents

set gmrp registration

set gmrp timer

set gvrp

set gvrp applicant

set gvrp dynamic-vlan-creation

set gvrp registration

2-204

2-205

2-207

2-208

2-210

2-209

set gvrp timer

2-212

set igmp filter

2-214

set inlinepower defaultallocation

set interface

set interface trap

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—ROM monitor

set ip route—switch set ip unreachable

set kerberos clients mandatory

2-216

2-217

2-220

2-221

2-222

2-223

2-224

2-226

2-225

2-227

2-228

2-230

2-231

2-232

2-234

2-235

set kerberos credentials forward

2-236

set kerberos local-realm

2-237

set kerberos realm

2-238

set kerberos server

2-239

set kerberos srvtab entry

2-240

set kerberos srvtab remote

2-242

set key config-key

2-243

set lacp-channel system-priority

2-244

set length

2-245

set localuser

2-246

set logging buffer

2-248

viii

set localuser 2-246 set logging buffer 2-248 viii Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX,

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

78-15907-01

Contents

set logging console

set logging history set logging level set logging server set logging session set logging telnet

set logging history set logging level set logging server set logging session set logging telnet
set logging history set logging level set logging server set logging session set logging telnet
set logging history set logging level set logging server set logging session set logging telnet
set logging history set logging level set logging server set logging session set logging telnet

2-249

2-250

2-251

2-254

2-256

2-257

set logging timestamp

2-258

set logout

2-259

set module disable

2-260

set module enable

2-261

set module name

2-262

set multicast router set ntp authentication

set multicast router set ntp authentication

2-263

2-264

set ntp broadcastclient

2-265

set ntp broadcastdelay

2-266

set ntp client set ntp key set ntp server

set ntp summertime set ntp timezone

2-267

2-268

2-269

2-270

2-272

set password set port channel set port debounce set port disable set port dot1x set port duplex set port enable

set password set port channel set port debounce set port disable set port dot1x set port
set password set port channel set port debounce set port disable set port dot1x set port
set password set port channel set port debounce set port disable set port dot1x set port
set password set port channel set port debounce set port disable set port dot1x set port
set password set port channel set port debounce set port disable set port dot1x set port
set password set port channel set port debounce set port disable set port dot1x set port

2-273

2-274

2-277

2-278

2-279

2-281

2-282

set port errdisable-timeout

2-283

set port flowcontrol

2-284

set port gmrp

2-287

set port gvrp

2-288

set port host

2-290

set port inlinepower

2-291

set port lacp-channel

2-293

set port level

2-295

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX ix 78-15907-01

ix

78-15907-01

Contents

set port membership

2-296

set port name

2-298

set port negotiation

2-299

2-301

2-303

set port protocol

set port security

set port speed

2-305

set port trap

2-307

set port unicast-flood

2-308

set port vtp

2-310

set power budget

2-311

set power dcinput

2-312

set prompt

2-313

set protocolfilter

2-314

set pvlan

2-315

set pvlan mapping

2-317

set power budget

2-318

set qos

2-319

set qos defaultcos

2-320

set qos map

2-321

set radius attribute

2-322

set radius deadtime

2-323

set radius key

2-324

set radius retransmit

2-325

2-326

set radius server set radius timeout

2-327

set rcp username

2-328

set rspan

2-329

set runtimediagnositcs

set snmp

set snmp access set snmp access-list

set snmp buffer

set snmp chassis-alias set snmp community set snmp community-ext

2-332

2-333

2-334

2-336

2-337

2-338

2-339

2-341

x

2-332 2-333 2-334 2-336 2-337 2-338 2-339 2-341 x Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX,

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

78-15907-01

Contents

set snmp extendedrmon netflow

2-343

set snmp group set snmp ifalias set snmp notify set snmp rmon

set snmp group set snmp ifalias set snmp notify set snmp rmon
set snmp group set snmp ifalias set snmp notify set snmp rmon
set snmp group set snmp ifalias set snmp notify set snmp rmon

2-344

2-346

2-347

2-348

set snmp rmonmemory set snmp targetaddr

set snmp rmonmemory set snmp targetaddr

set snmp targetparams

2-349

2-350

2-352

set snmp trap

2-354

set snmp user

2-357

set snmp view

2-359

set span

2-361

set spantree backbonefast set spantree bpdu-filter set spantree bpdu-guard set spantree bpdu-skewing set spantree channelcost

spantree backbonefast set spantree bpdu-filter set spantree bpdu-guard set spantree bpdu-skewing set spantree channelcost
spantree backbonefast set spantree bpdu-filter set spantree bpdu-guard set spantree bpdu-skewing set spantree channelcost
spantree backbonefast set spantree bpdu-filter set spantree bpdu-guard set spantree bpdu-skewing set spantree channelcost
spantree backbonefast set spantree bpdu-filter set spantree bpdu-guard set spantree bpdu-skewing set spantree channelcost

2-364

2-365

2-366

2-367

2-368

set spantree channelvlancost

2-370

set spantree defaultcostmode

2-371

set spantree disable set spantree enable set spantree fwddelay

set spantree global-default

set spantree guard set spantree hello set spantree link-type

set spantree macreduction

set spantree maxage set spantree mode set spantree mst

2-373

2-375

2-377

2-381

2-383

2-385

2-387

2-389

2-391

2-379

2-386

set spantree mst config

2-392

set spantree mst link-type

2-394

set spantree mst maxhops

2-395

set spantree mst vlan

2-396

set spantree portcost

2-397

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX xi 78-15907-01

xi

78-15907-01

Contents

set spantree portfast

2-399

set spantree portfast bpdu-filter set spantree portfast bpdu-guard set spantree portinstancecost

set spantree portfast bpdu-filter set spantree portfast bpdu-guard set spantree portinstancecost
set spantree portfast bpdu-filter set spantree portfast bpdu-guard set spantree portinstancecost

2-400

2-401

2-402

set spantree portinstancepri

set spantree portpri

set spantree portvlancost set spantree portvlanpri

set spantree priority set spantree root

set spantree uplinkfast

set summertime

set switchacceleration

set system baud set system contact

set system countrycode set system location

set system modem set system name

set system syslog-dump

set system syslog file

2-404

2-406

2-407

2-409

2-411

2-413

2-418

2-421

2-422

2-424

2-425

2-426

2-416

2-420

2-423

2-427

2-428

set tacacs directedrequest

2-429

2-430

set tacacs key set tacacs server

2-431

set tacacs timeout

2-432

set test diaglevel

2-433

set time

2-434

set timezone

2-435

 

set trace

2-436

set traffic monitor

2-437

set trunk

2-438

set udld

2-441

set udld aggressive-mode

2-443

set udld interval

2-444

set vlan

2-445

xii

set udld interval 2-444 set vlan 2-445 xii Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX,

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

78-15907-01

Contents

set vlan mapping

set vlan verify-port-provisioning

set vmps downloadmethod set vmps downloadserver

set vmps server set vmps state

set vtp

set vtp pruneeligible

2-449

2-452

2-453

2-454

2-456

2-457

2-460

2-451

set vtp pruning

2-461

show accounting

2-463

show alias

2-465

show arp

2-466

show authentication

2-467

show authorization

2-468

show banner

2-469

show boot—ROM monitor

2-470

show boot—switch

2-471

show cam

2-472

show cam agingtime

2-475

show cam notification

2-476

show cdp

2-478

show cgmp leave

2-481

show cgmp statistics

2-482

show channel

2-484

show channel group

2-489

2-494

show channel mac show channelprotocol

2-495

show channel traffic

2-496

show config

2-497

show config mode show counters show crypto key

show dot1q-all-tagged

show dot1x

show dvlan statistics

2-503

2-504

2-510

2-511

2-513

2-512

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX xiii 78-15907-01

xiii

78-15907-01

Contents

show environment

show errdisable-timeout show errordetection

2-514

2-517

2-516

show file

2-518

show flash

2-520

show garp timer

show gmrp configuration

show gmrp statistics show gmrp timer

show gvrp configuration

show gvrp statistics show igmp filter show imagemib

show interface—ROM monitor

show interface—switch

2-524

2-525

2-526

2-527

2-528

2-529

2-531

2-534

2-536

2-535

show ip alias show ip dns show ip http show ip permit

show ip alias show ip dns show ip http show ip permit
show ip alias show ip dns show ip http show ip permit
show ip alias show ip dns show ip http show ip permit

2-538

2-539

2-540

2-542

show ip route—ROM monitor

show ip route—switch

show kerberos

show kerberos creds

show lacp-channel

show localusers

show log

2-545

2-548

2-549

2-547

2-553

2-554

2-544

show log command

2-557

show logging

2-558

show logging buffer

2-560

show mac

2-562

show module

2-565

show multicast group

show multicast group count

show multicast protocols status

show multicast router

2-568

2-570

2-571

2-572

xiv

status show multicast router 2-568 2-570 2-571 2-572 xiv Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX,

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

78-15907-01

Contents

show netstat

2-574

show ntp

2-580

show port

2-582

show port capabilities

show port cdp

2-590

2-587

show port channel show port counters

show port channel show port counters
show port channel show port counters

2-592

2-597

2-600

show port debounce show port dot1x

show port debounce show port dot1x 2-601

2-601

show port errdisable-timeout

2-602

show port flowcontrol

2-606

2-604

show port ifindex

show port inlinepower

2-607

show port lacp-channel

2-609

show port mac

2-612

 

2-614

show port negotiation show port protocol

2-615

2-617

 

show port security

show port security statistics

2-619

show port spantree show port status

show port trap show port trunk

show port unicast-flood

2-624

2-620

2-621

2-623

2-626

show port vtp show proc

show protocolfilter

show pvlan

show pvlan capability

show pvlan mapping

show qos info show qos status

2-627

2-629

2-633

2-632

2-635

2-637

2-639

2-640

show radius

2-641

show rcp

2-643

show reset

2-644

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX xv 78-15907-01

xv

78-15907-01

Contents

show rspan

show running-config

show snmp

show snmp access

show snmp access-list

show snmp buffer

show snmp community

2-645

2-649

2-647

2-651

2-654

2-653

2-655

show snmp context

2-657

show snmp counters

2-658

show snmp engineid

2-661

show snmp group

2-662

show snmp ifalias

2-664

show snmp notify

2-665

show snmp targetaddr

show snmp targetparams

2-667

2-669

show snmp user

2-671

show snmp view

2-673

show span

show spantree

2-675

2-677

show spantree backbonefast show spantree blockedports show spantree bpdu-filter show spantree bpdu-guard show spantree bpdu-skewing

backbonefast show spantree blockedports show spantree bpdu-filter show spantree bpdu-guard show spantree bpdu-skewing
backbonefast show spantree blockedports show spantree bpdu-filter show spantree bpdu-guard show spantree bpdu-skewing
backbonefast show spantree blockedports show spantree bpdu-filter show spantree bpdu-guard show spantree bpdu-skewing
backbonefast show spantree blockedports show spantree bpdu-filter show spantree bpdu-guard show spantree bpdu-skewing

2-680

2-681

2-682

2-683

2-684

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

2-686

2-688

2-689

2-691

2-693

2-695

2-697

2-699

2-700

2-701

2-702

xvi

2-689 2-691 2-693 2-695 2-697 2-699 2-700 2-701 2-702 xvi Catalyst 4500 Series, Catalyst 2948G, Catalyst

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

78-15907-01

Contents

show spantree summary

2-709

show spantree uplinkfast

2-712

show summertime

2-713

show switchacceleration

2-714

show system

2-715

show tacacs

2-717

show tech-support

2-719

show test

2-722

show time

2-728

show timezone

show top

show top report

2-730

2-729

2-732

show trace

2-734

show traffic

2-736

show trunk

2-737

show udld

2-739

show users

2-741

show version—switch

show vlan

show vlan verify-port-provisioning

show vmps

show vmps mac

2-742

2-745

2-750

2-752

2-749

show vmps statistics

2-753

show vmps vlan

2-754

show vmps vlanports

2-755

show vtp

2-756

show vtp domain

2-758

show vtp statistics

2-760

slip

sprom read

squeeze—ROM monitor squeeze—switch 2-767

sync

telnet 2-769 test snmp trap

2-762

2-763

2-768

2-770

2-766

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX xvii 78-15907-01

xvii

78-15907-01

Contents

traceroute 2-771

unalias 2-774

undelete—ROM monitor 2-775 undelete—switch 2-776 unset= varname 2-778 upload 2-779 varname = 2-781 verify 2-782 version 2-783

wait

whichboot

write

write tech-support

write terminal

2-784

2-786

2-785

2-789

2-792

APPENDIX

A

Acronyms

A-1

APPENDIX

B

Acknowledgments for Open-Source Software

B-1

I NDEX

xviii

for Open-Source Software B-1 I NDEX xviii Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX,

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

78-15907-01

Preface This preface describes the audience, organization, and conventions of this publication and provides information

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 4500 series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G switches.

Organization

This publication is organized as follows:

Chapter

Title

Description

Chapter 1

Command-Line Interface

Describes the CLI types found on Catalyst 4500 series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G switches and contains quick reference guides for all switch and ROM monitor commands.

Chapter 2

Catalyst 4500 Series, Catalyst 2948G Switch, Catalyst 2948G-GE-TX, and Catalyst 2980G Switch and ROM Monitor Commands

Provides an alphabetical listing of all switch and ROM monitor commands and gives detailed information about each command.

Appendix A

Acronyms

Defines the acronyms used in this publication.

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX xix 78-15907-01

xix

78-15907-01

Related Documentation

Preface

Related Documentation

Other documents in the Catalyst 4500 series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G switch documentation set include the following:

Catalyst 4000 Family Installation Guide

Catalyst 4912G Switch Installation Guide

Catalyst 4500 Series Switch Installation Guide

Catalyst 5000 Family, Catalyst 4500 Series, Catalyst 2926G Series, Catalyst 2948G, Catalyst 2948GE-TX, and Catalyst 2980G Switches Quick Software Configuration Guide

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Software Configuration Guide

Catalyst 5000 Family, Catalyst 4500 Series, Catalyst 2926G Series, Catalyst 2948G, Catalyst 2948GE-TX, and Catalyst 2980G Switches ATM Software Configuration Guide

System Message Guide—Catalyst 6500 Series, Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948GE-TX, and Catalyst 2980G Switches

Catalyst 4500 Series Switch Release Notes

Enterprise MIB User Quick Reference (online only)

Other useful publications:

Cisco IOS Configuration Guides and Command References—Use these publications to help you configure the Cisco IOS software that runs on the RSM, ATM modules, LightStream 1010 ASP, and Catalyst 8500 series CSR SRP.

http://www.cisco.com/univercd/cc/td/doc/product/lan/cat4000/—This URL has an up-to-date list of online documentation for the Catalyst 4500 series switches.

Configuration Fundamentals Command Reference publication—Use this publication to locate additional information on Cisco IOS commands.

Conventions

Throughout this publication, the conventions listed here used when referring to switch platforms:

Catalyst enterprise LAN switches—Refers to the Catalyst 4500 series, Catalyst 2948G, Catalyst 2948GE-TX, and Catalyst 2980G switches. Catalyst 4500 series switches—Refers to the Catalyst 4000 series and Catalyst 4500 series switches. The Catalyst 4000 series includes the Catalyst 4003, Catalyst 4006, and Catalyst 4912G switches. The Catalyst 4500 series includes the Catalyst 4503 and Catalyst 4506 switches.

Command descriptions use the following typeface and character conventions:

Convention

Description

boldface font

Commands, command options, and keywords are in boldface.

italic font

 

Arguments for which you supply values are in italics.

[

]

Optional elements are enclosed in square brackets.

{

x | y

|

z }

Alternative keywords are grouped in braces and are separated by vertical bars.

xx

grouped in braces and are separated by vertical bars. xx Catalyst 4500 Series, Catalyst 2948G, Catalyst

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

78-15907-01

Preface

Obtaining Documentation

Convention

Description

[ x

|

y | z ]

Optional alternative keywords are grouped in brackets and are separated by vertical bars.

string

 

Nonquoted set of characters. Do not use quotation marks around the string; if you do, 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 enter is in boldface screen font.

italic screen font

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

^

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

<

>

Nonprinting characters, such as passwords, are enclosed in angle brackets.

!, #

 

An exclamation point (!) or a pound sign (#) at the beginning of a line of code indicates a comment line.

at the beginning of a line of code indicates a comment line. Note Notes use the

Note

Notes use the following conventions:

Means reader take note. Notes contain helpful suggestions or references to material not covered in the publication.

Cautions use the following conventions:

in the publication. Cautions use the following conventions: Caution Means reader be careful . In this

Caution

Means reader be careful. In this situation, you might do something that could result in equipment damage or loss of data.

Obtaining Documentation

Cisco provides several ways to obtain documentation, 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 on the World Wide Web at this URL:

http://www.cisco.com/univercd/home/home.htm

You can access the Cisco website at this URL:

International Cisco websites can be accessed from this URL:

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX xxi 78-15907-01

xxi

78-15907-01

Obtaining Technical Assistance

Preface

Documentation CD-ROM

Cisco documentation and additional literature are available in a Cisco Documentation CD-ROM package, which may have shipped with your product. The Documentation CD-ROM is updated regularly and may be more current than printed documentation. The CD-ROM package is available as a single unit or through an annual or quarterly subscription.

Registered Cisco.com users can order a single Documentation CD-ROM (product number DOC-CONDOCCD=) through the Cisco Ordering tool:

All users can order annual or quarterly subscriptions through the online Subscription Store:

Ordering Documentation

You can find instructions for ordering documentation at this URL:

You can order Cisco documentation in these ways:

Registered Cisco.com users (Cisco direct customers) can order Cisco product documentation from the Networking Products MarketPlace:

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 Feedback

You can submit comments electronically on Cisco.com. On the Cisco Documentation home page, click Feedback at the top of the page.

You can send your comments in e-mail to bug-doc@cisco.com.

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.

Obtaining Technical Assistance

For all customers, partners, resellers, and distributors who hold valid Cisco service contracts, the Cisco Technical Assistance Center (TAC) provides 24-hour, award-winning technical support services, online and over the phone. Cisco.com features the Cisco TAC website as an online starting point for technical assistance.

xxii

as an online starting point for technical assistance. xxii Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX,

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

78-15907-01

Preface

Obtaining Technical Assistance

Cisco TAC Website

The Cisco TAC website (http://www.cisco.com/tac) provides online documents and tools for troubleshooting and resolving technical issues with Cisco products and technologies. The Cisco TAC website is available 24 hours a day, 365 days a year.

Accessing all the tools on the Cisco TAC website requires a Cisco.com user ID and password. If you have a valid service contract but do not have a login ID or password, register at this URL:

Opening a TAC Case

The online TAC Case Open Tool (http://www.cisco.com/tac/caseopen) is the fastest way to open P3 and P4 cases. (Your network is minimally impaired or you require product information). After you describe your situation, the TAC Case Open Tool automatically recommends resources for an immediate solution. If your issue is not resolved using these recommendations, your case will be assigned to a Cisco TAC engineer.

For P1 or P2 cases (your production network is down or severely degraded) or if you do not have Internet access, contact Cisco TAC by telephone. Cisco TAC engineers are assigned immediately to P1 and P2 cases to help keep your business operations running smoothly.

To open a case 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 listing of Cisco TAC contacts, go to this URL:

TAC Case Priority Definitions

To ensure that all cases are reported in a standard format, Cisco has established case priority definitions.

Priority 1 (P1)—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.

Priority 2 (P2)—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.

Priority 3 (P3)—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.

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

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX xxiii 78-15907-01

xxiii

78-15907-01

Obtaining Additional Publications and Information

Preface

Obtaining Additional Publications and Information

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

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:

Cisco Press publishes a wide range of networking publications. Cisco suggests these titles for new and experienced users: Internetworking Terms and Acronyms Dictionary, Internetworking Technology Handbook, Internetworking Troubleshooting Guide, and the Internetworking Design Guide. For current Cisco Press titles and other information, go to Cisco Press online at this URL:

Packet magazine is the Cisco quarterly publication that provides the latest networking trends, technology breakthroughs, and Cisco products and solutions to help industry professionals get the most from their networking investment. Included are networking deployment and troubleshooting tips, configuration examples, customer case studies, tutorials and training, certification information, and links to numerous in-depth online resources. You can access Packet magazine at this URL:

iQ Magazine is the Cisco bimonthly publication that delivers the latest information about Internet business strategies for executives. You can access iQ Magazine at this URL:

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:

Training—Cisco offers world-class networking training. Current offerings in network training are listed at this URL:

xxiv

URL: http://www.cisco.com/en/US/learning/index.html xxiv Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX,

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

78-15907-01

1 CHAPTER
1
CHAPTER

Command-Line Interface

This chapter describes the command-line interface (CLI) available on the Catalyst 4500 series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G switches and contains the following sections:

Switch CLI, page 1-1

ROM Monitor CLI, page 1-9

Appendix A contains a list of acronyms used in this publication. For complete definitions of terms listed in this publication, refer to the Internetworking Terms and Acronyms publication.

Switch CLI

The Catalyst 4500 series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G 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 4500 series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G switches Ethernet, Fast Ethernet, Gigabit Ethernet, CDDI, and FDDI modules 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 various 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.

after remaining idle for a user-defined time period. Note EIA/TIA-232 was known as RS-232 before its

Note

EIA/TIA-232 was known as RS-232 before its acceptance as a standard by the Electronic Industries Alliance and Telecommunications Industry Association.

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX 1-1 78-15907-01

1-1

78-15907-01

Switch CLI

Chapter 1

Command-Line Interface

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

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

 

Task

Command

Step 1

From the Cisco Systems Console prompt, press Return.

 

Step 2

At the prompt, enter the system password. The Console> prompt indicates that you have accessed the CLI in normal mode.

<password>

Step 3

Enter the necessary commands to complete your tasks.

Appropriate commands

Step 4

When finished, exit the session.

quit

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

Cisco Systems Console Enter password:

Console>

Console>

Accessing the Switch CLI through Telnet

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

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

 

Task

Command

Step 1

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

telnet hostname | ip_addr

Step 2

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

<password>

Step 3

Enter the necessary commands to complete your tasks.

Appropriate commands

Step 4

When finished, exit the Telnet session.

quit

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

host% telnet cat4000-1.cisco.com Trying 172.16.44.30 Connected to cat4000-1.

1-2

Trying 172.16.44.30 Connected to cat4000-1. 1-2 Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX,

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

78-15907-01

Chapter 1

Command-Line Interface

Switch CLI

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 (login) and privileged (enable). 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)

Command-Line Editing

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 commands or parameters available in the same operating mode. You can scroll through the last 20 commands stored in the history buffer, and enter or edit the command at the prompt. Table 1-1 describes the keys used for editing.

Table 1-1

Command-Line Editing Keystrokes

Keystroke

Function

Ctrl-A

Jumps to the first character of the command line

Ctrl-B or the left arrow key 1

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 key 1

Moves the cursor forward one character

Ctrl-K

Deletes everything from the cursor position to the end of the command line

Ctrl-L; Ctrl-R

Repeats the current command line on a new line

Ctrl-N or the down arrow key 1

Displays the next command line in the history buffer

Ctrl-P or the up arrow key 1

Displays the previous command line in the history buffer

Ctrl-U; Ctrl-X

Deletes everything from the cursor position to the beginning of the command line

Ctrl-W

Deletes the last word typed

Esc B

Moves the cursor back one word

Esc D

Deletes everything from the cursor position to the end of the word

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX 1-3 78-15907-01

1-3

78-15907-01

Switch CLI

Chapter 1

Command-Line Interface

Table 1-1

Command-Line Editing Keystrokes (continued)

Keystroke

Function

Esc F

Moves the cursor forward one word

Delete key or Backspace key

Erases a mistake made when entering a command; reenter the command after using this key

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

Using History Substitution

Commands that you enter during each terminal session are stored in a history buffer, which stores the last 20 commands you entered. History substitution allows you to access these commands without retyping them by using special abbreviated commands. Table 1-2 describes the history substitution commands.

Table 1-2

History Substitution Commands

Command

Function

To repeat recent commands:

!!

Repeats the most recent command

!-nn

Repeats the nnth most recent command

!n

Repeats command n

!aaa

Repeats the command beginning with string aaa

!?aaa

Repeats the command containing the string aaa

To modify and repeat the most recent command:

^aaa^bbb

Replaces the string aaa with the string bbb in the most recent command

To add a string to the end of a previous command and repeat it:

!!aaa

Adds string aaa to the end of the most recent command

!n aaa

Adds string aaa to the end of command n

!aaa bbb

Adds string bbb to the end of the command beginning with string aaa

!?aaa bbb

Adds string bbb to the end of the command containing the string aaa

Abbreviating a Command

You can abbreviate commands and keywords to the number of characters that allow a unique abbreviation.

You can abbreviate the show command to sh. After entering the command at the system prompt, press Return to run the command.

1-4

at the system prompt, press Return to run the command. 1-4 Catalyst 4500 Series, Catalyst 2948G,

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

78-15907-01

Chapter 1

Command-Line Interface

Switch CLI

Moving Around on the Command Line

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

Task

Keystrokes

Move the cursor back one character.

Press Ctrl-B or press the left arrow key 1 .

Move the cursor forward one character.

Press Ctrl-F or press the right arrow key 1 .

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.

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

Completing a Partial Command

The Tab key allows you to use the command-completion feature. When you enter a unique partial character string and press the Tab key, the system automatically completes the command or keyword on the command line.

For example, if you enter co and press the Tab key, the system completes the command as configure because it is the only command that matches the criteria.

because it is the only command that matches the criteria. Note If your keyboard does not

Note

If your keyboard does not have a Tab key, press Ctrl-I instead.

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:

Task

Keystrokes

Recall the most recent entry in the buffer.

Press Ctrl-Y.

Recall the next buffer entry.

Press Esc Y.

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.

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX 1-5 78-15907-01

1-5

78-15907-01

Switch CLI

Chapter 1

Command-Line Interface

Scrolling Down a Line or a Screen

When the output of a command fills more than one terminal screen, a ---More--- prompt is displayed at the bottom of the screen. To view the next line or screen, perform these tasks:

Task

Keystrokes

Scroll down one line

Press the Return key

Scroll down one screen

Press the Spacebar

key Scroll down one screen Press the Spacebar Note The ---More--- prompt is used for any

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.

Using Command Aliases

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

Table 1-3

Switch CLI Command Aliases

Alias

Command

?

help

batch

configure

di

show

exit

quit

logout

quit

Using History Substitution

Commands that you enter during each terminal session are stored in a history buffer, which stores the last 20 commands you entered during a terminal session. History substitution allows you to access these commands without retyping them by using special abbreviated commands. (See Table 1-4.)

Table 1-4

History Substitution Commands

Command

Function

To repeat recent commands:

!!

Repeat the most recent command.

!-nn

Repeat the nnth most recent command.

!n

Repeat command n.

!aaa

Repeat the command beginning with string aaa.

!?aaa

Repeat the command containing the string aaa.

To modify and repeat the most recent command:

1-6

aaa. To modify and repeat the most recent command: 1-6 Catalyst 4500 Series, Catalyst 2948G, Catalyst

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

78-15907-01

Chapter 1

Command-Line Interface

Switch CLI

Table 1-4

History Substitution Commands (continued)

Command

Function

^aaa^bbb

Replace string aaa with string bbb in the most recent command.

To add a string to the end of a previous command and repeat it:

!!aaa

Add string aaa to the end of the most recent command.

!n aaa

Add string aaa to the end of command n.

!aaa bbb

Add string bbb to the end of the command beginning with string aaa.

!?aaa bbb

Add string bbb to the end of the command containing string aaa.

Accessing Command Help

To display a list of top-level commands and command categories, enter help or ? in normal or privileged mode. Context-sensitive help (usage and syntax information) for individual commands can be seen by appending help or ? to any specific command. If you enter a command using the wrong number of arguments or inappropriate arguments, usage and syntax information for that command is displayed. Additionally, appending help or ? to a command category displays a list of commands in that category.

Displaying Top-Level Commands and Command Categories

In normal mode, enter help or ? to display top-level commands and command categories, as follows:

Console> help

Commands:

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

cd

Set default flash device

dir

Show list of files on flash device

enable

Enable privileged mode

help

Show this message

history

Show contents of history substitution buffer

ping

Send echo packets to hosts

pwd

Show default flash device

quit

Exit from the Admin session

session

Tunnel to ATM or Router module

set

Set, use 'set help' for more info

show

Show, use 'show help' for more info

traceroute

Trace the route to a host

verify

Verify checksum of file on flash device

wait

Wait for x seconds

whichboot

Which file booted

Console>

In privileged mode, enter help or ? to display top-level commands and command categories, as follows:

Console> (enable) help

Commands:

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

cd

Set default flash device

clear

Clear, use 'clear help' for more info

configure

Configure system from network

copy

Copy files between TFTP/module/flash devices

delete

Delete a file on flash device

dir

Show list of files on flash device

Catalyst 4500 Series, Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX

Catalyst 2948G, Catalyst 2948G-GE-TX, and Catalyst 2980G Switches Command Reference—Rel. 8.2(1)GLX 1-7 78-15907-01

1-7

78-15907-01

Switch CLI

Chapter 1

Command-Line Interface

disable

Disable privileged mode