Cisco Reader Comment Card

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 model(s)
4 I perform these types of tasks: H/W Install and/or Maintenance S/W Config
Network Management Other:
5 I use these types of documentation: H/W Install H/W Config S/W Config
Command Reference Quick Reference Release Notes Online Help
Other:
6 I access this information through: % Cisco Connection Online (CCO) % CD-ROM
% Printed docs % Other:
7 Which method do you prefer?
8 I use the following three product features the most:

Document Information
Document Title: Command Reference—Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G
Part Number: 78-12648-03 Software Releases 6.3 and 6.4
On a scale of 1–5 (5 being the best) please let us know how we rate in the following areas:
The document is written at my technical The information is accurate.
level of understanding.
The document is complete. The information I wanted was easy to find.
The information is well organized. The information I found was useful to my
job.

Please comment on our lowest score(s):

Mailing Information
Company Name Date
Contact Name Job Title
Mailing Address

City State/Province ZIP/Postal Code

Country Phone ( ) Extension
Fax ( ) E-mail
Can we contact you further concerning our documentation? Yes No
You can also send us your comments by e-mail to [email protected], or by fax to 408-527-8089.
 NO POSTAGE
NECESSARY
IF MAILED
IN THE
UNITED STATES
BUSINESS REPLY MAIL
FIRST-CLASS MAIL PERMIT NO. 4631 SAN JOSE CA
POSTAGE WILL BE PAID BY ADDRESSEE
DOCUMENT RESOURCE CONNECTION
CISCO SYSTEMS INC
170 WEST TASMAN DR
SAN JOSE CA 95134-9916
Command Reference
Catalyst 4000 Family
Catalyst 2948G
Catalyst 2980G

Software Releases 6.3 and 6.4

Corporate Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 526-4100

Customer Order Number: DOC-7812648=

Text Part Number: 78-12648-03
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.

CCIP, the Cisco Arrow logo, the Cisco Powered Network mark, the Cisco Systems Verified logo, Cisco Unity, Follow Me Browsing, FormShare, iQ Breakthrough, iQ
Expertise, iQ FastTrack, the iQ Logo, iQ Net Readiness Scorecard, Networking Academy, ScriptShare, SMARTnet, TransPath, and Voice LAN are trademarks of Cisco
Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, Discover All That’s Possible, The Fastest Way to Increase Your Internet Quotient, and iQuick Study are
service marks of Cisco Systems, Inc.; and Aironet, ASIST, BPX, Catalyst, CCDA, CCDP, CCIE, CCNA, CCNP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco
IOS, the Cisco IOS logo, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Empowering the Internet Generation, Enterprise/Solver, EtherChannel,
EtherSwitch, Fast Step, GigaStack, Internet Quotient, IOS, IP/TV, LightStream, MGX, MICA, the Networkers logo, Network Registrar, Packet, PIX, Post-Routing,
Pre-Routing, RateMUX, Registrar, SlideCast, StrataView Plus, Stratm, SwitchProbe, TeleRouter, and VCO are registered trademarks of Cisco Systems, Inc. and/or its
affiliates in the U.S. and certain other countries.

All other trademarks mentioned in this document or Web site 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. (0208R)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
Copyright © 2000—2003, Cisco Systems, Inc.
All rights reserved.
 C O N T E N T S

Preface xvii

Audience xvii

Organization xvii

Related Documentation xviii

Conventions xviii

Obtaining Documentation xix

Obtaining Technical Assistance xx

CHAPTER 1 Command-Line Interface 1-1

Switch CLI 1-1

ROM Monitor CLI 1-9

CHAPTER 2 Catalyst 4000 Family, Catalyst 2948G, 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-11

clear config pvlan 2-12

clear config—ROM monitor 2-13

clear config—switch 2-14

clear counters 2-16

clear crypto key rsa 2-17

clear dot1x config 2-18

clear gmrp statistics 2-19

clear gvrp statistics 2-20

clear ip alias 2-21

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 iii
Contents

clear ip dns domain 2-22

clear ip dns server 2-23

clear ip permit 2-24

clear ip route—ROM monitor 2-26

clear ip route—switch 2-27

clear kerberos clients mandatory 2-28

clear kerberos credentials forward 2-29

clear kerberos creds 2-30

clear kerberos realm 2-31

clear kerberos server 2-32

clear kerberos srvtab entry 2-33

clear key config-key 2-34

clear log 2-35

clear log command 2-36

clear logging buffer 2-37

clear logging level 2-38

clear logging server 2-39

clear multicast router 2-40

clear ntp key 2-41

clear ntp server 2-42

clear ntp timezone 2-43

clear port host 2-44

clear port security 2-45

clear pvlan mapping 2-46

clear qos config 2-47

clear qos defaultcos 2-48

clear qos map 2-49

clear radius key 2-50

clear radius server 2-51

clear rcp 2-52

clear snmp access 2-53

clear snmp community 2-54

clear snmp group 2-55

clear snmp notify 2-56

clear snmp targetaddr 2-57

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
iv 78-12648-03
 Contents

clear snmp targetparams 2-58

clear snmp trap 2-59

clear snmp user 2-60

clear snmp view 2-61

clear spantree portinstancecost 2-62

clear spantree portinstancepri 2-63

clear spantree portvlancost 2-64

clear spantree portvlanpri 2-66

clear spantree root 2-67

clear spantree statistics 2-68

clear spantree uplinkfast 2-69

clear tacacs key 2-70

clear tacacs server 2-71

clear timezone 2-72

clear top 2-73

clear trunk 2-74

clear vlan 2-75

clear vlan mapping 2-77

clear vmps rcp 2-78

clear vmps statistics 2-79

clear vtp pruning 2-80

clear vtp statistics 2-81

configure 2-82

confreg 2-84
copy 2-86

del 2-89

delete 2-90

dir—ROM monitor 2-91

dir—switch 2-92

disable 2-94

disconnect 2-95

download 2-96

enable 2-99

format 2-100

help—ROM monitor 2-102

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 v
Contents

history—ROM monitor 2-103

history—switch 2-104

l2trace 2-105

meminfo 2-107

ping—ROM monitor 2-108

ping—switch 2-109

pwd 2-112

quit 2-113

reconfirm vmps 2-114

repeat 2-115

reset—ROM monitor 2-117

reset—switch 2-118

session 2-120

set 2-121

set accounting commands 2-122

set accounting connect 2-124

set accounting exec 2-126

set accounting suppress 2-128

set accounting system 2-129

set accounting update 2-131

set alias 2-132

set arp 2-133

set authentication enable 2-135

set authentication login 2-138

set authorization commands 2-141

set authorization enable 2-143

set authorization exec 2-145

set banner motd 2-147

set boot auto-config 2-148

set boot config-register 2-149

set boot sync now 2-152

set boot system flash 2-153

set cam 2-155

set cdp 2-157

set cdp holdtime 2-159

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
vi 78-12648-03
 Contents

set cdp interval 2-160

set cdp version 2-161

set cgmp 2-162

set cgmp leave 2-163

set channel cost 2-164

set channel vlancost 2-165

set config mode 2-166

set crypto key rsa 2-168

set dot1q-all-tagged 2-169

set dot1x 2-170

set enablepass 2-173

set errdisable-timeout 2-174

set errordetection 2-176

set feature mdg 2-177

set garp timer 2-178

set gmrp 2-180

set gmrp fwdall 2-181

set gmrp registration 2-182

set gmrp timer 2-183

set gvrp 2-185

set gvrp applicant 2-186

set gvrp dynamic-vlan-creation 2-187

set gvrp registration 2-188

set gvrp timer 2-190

set inlinepower defaultallocation 2-191

set interface 2-192

set interface trap 2-195

set ip alias 2-196

set ip dns 2-197

set ip dns domain 2-198

set ip dns server 2-199

set ip fragmentation 2-200

set ip http port 2-201

set ip http server 2-202

set ip permit 2-203

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 vii
 Contents

set ip redirect 2-205

set ip route—ROM monitor 2-206

set ip route—switch 2-207

set ip unreachable 2-209

set kerberos clients mandatory 2-210

set kerberos credentials forward 2-211

set kerberos local-realm 2-212

set kerberos realm 2-213

set kerberos server 2-214

set kerberos srvtab entry 2-215

set kerberos srvtab remote 2-217

set key config-key 2-218

set length 2-219

set logging buffer 2-220

set logging console 2-221

set logging history 2-222

set logging level 2-223

set logging server 2-226

set logging session 2-228

set logging telnet 2-229

set logging timestamp 2-230

set logout 2-231

set module disable 2-232

set module enable 2-233

set module name 2-234

set multicast router 2-235

set ntp authentication 2-236

set ntp broadcastclient 2-237

set ntp broadcastdelay 2-238

set ntp client 2-239

set ntp key 2-240

set ntp server 2-241

set ntp summertime 2-242

set ntp timezone 2-244

set password 2-245

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
viii 78-12648-03
 Contents

set port auxiliaryvlan 2-246

set port channel 2-248

set port disable 2-251

set port dot1x 2-252

set port duplex 2-255

set port enable 2-256

set port flowcontrol 2-257

set port gmrp 2-260

set port gvrp 2-261

set port host 2-263

set port inlinepower 2-264

set port level 2-265

set port membership 2-266

set port name 2-268

set port negotiation 2-269

set port protocol 2-271

set port security 2-273

set port speed 2-275

set port trap 2-277

set power budget 2-278

set prompt 2-279

set protocolfilter 2-280

set pvlan 2-281

set pvlan mapping 2-283

set power budget 2-285

set qos 2-286

set qos defaultcos 2-287

set qos map 2-288

set radius deadtime 2-289

set radius key 2-290

set radius retransmit 2-291

set radius server 2-292

set radius timeout 2-293

set rcp username 2-294

set rspan 2-295

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 ix
Contents

set snmp access 2-298

set snmp community 2-300

set snmp extendedrmon netflow 2-301

set snmp group 2-302

set snmp notify 2-304

set snmp rmon 2-306

set snmp rmonmemory 2-307

set snmp targetaddr 2-308

set snmp targetparams 2-310

set snmp trap 2-312

set snmp user 2-314

set snmp view 2-316

set span 2-318

set spantree backbonefast 2-322

set spantree bpdu-skewing 2-323

set spantree defaultcostmode 2-324

set spantree disable 2-326

set spantree enable 2-327

set spantree fwddelay 2-328

set spantree guard 2-329

set spantree hello 2-331

set spantree macreduction 2-332

set spantree maxage 2-333

set spantree mode 2-334

set spantree portcost 2-336

set spantree portfast 2-338

set spantree portfast bpdu-filter 2-339

set spantree portfast bpdu-guard 2-340

set spantree portinstancecost 2-341

set spantree portinstancepri 2-343

set spantree portpri 2-344

set spantree portvlancost 2-345

set spantree portvlanpri 2-347

set spantree priority 2-348

set spantree root 2-349

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
x 78-12648-03
 Contents

set spantree uplinkfast 2-351

set summertime 2-353

set switchacceleration 2-355

set system baud 2-356

set system contact 2-357

set system countrycode 2-358

set system location 2-359

set system modem 2-360

set system name 2-361

set tacacs directedrequest 2-362

set tacacs key 2-363

set tacacs server 2-364

set tacacs timeout 2-365

set test diaglevel 2-366

set test switch-memory 2-368

set time 2-370

set timezone 2-371

set trace 2-372

set traffic monitor 2-373

set trunk 2-374

set udld 2-377

set udld aggressive-mode 2-379

set udld interval 2-380

set vlan 2-381

set vlan mapping 2-384

set vmps server 2-386

set vtp 2-387

set vtp pruneeligible 2-390

set vtp pruning 2-391

show accounting 2-393

show alias 2-395

show arp 2-396

show authentication 2-397

show authorization 2-398

show banner 2-399

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 xi
Contents

show boot—ROM monitor 2-400

show boot—switch 2-401

show cam 2-402

show cam agingtime 2-405

show cdp 2-406

show cgmp leave 2-409

show cgmp statistics 2-410

show channel 2-412

show channel group 2-417

show channel mac 2-422

show channel traffic 2-423

show config 2-424

show config mode 2-430

show counters 2-431

show crypto key 2-433

show dot1q-all-tagged 2-434

show dot1x 2-435

show dvlan statistics 2-436

show environment 2-437

show environment power 2-438

show errdisable-timeout 2-439

show errordetection 2-440

show file 2-441

show flash 2-443

show garp timer 2-447

show gmrp configuration 2-448

show gmrp statistics 2-449

show gmrp timer 2-450

show gvrp configuration 2-451

show gvrp statistics 2-452

show imagemib 2-454

show interface—ROM monitor 2-455

show interface—switch 2-456

show ip alias 2-458

show ip dns 2-459

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
xii 78-12648-03
 Contents

show ip http 2-460

show ip permit 2-462

show ip route—ROM monitor 2-464

show ip route—switch 2-465

show kerberos 2-467

show kerberos creds 2-468

show log 2-469

show log command 2-472

show logging 2-473

show logging buffer 2-475

show mac 2-477

show module 2-480

show multicast group 2-483

show multicast group count 2-485

show multicast protocols status 2-486

show multicast router 2-487

show netstat 2-489

show ntp 2-496

show port 2-498

show port auxiliaryvlan 2-502

show port capabilities 2-504

show port cdp 2-506

show port channel 2-508

show port counters 2-513

show port dot1x 2-516

show port flowcontrol 2-518

show port ifindex 2-520

show port inlinepower 2-521

show port mac 2-522

show port negotiation 2-524

show port protocol 2-525

show port security 2-527

show port security statistics 2-529

show port spantree 2-530

show port status 2-531

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 xiii
Contents

show port trap 2-533

show port trunk 2-534

show proc 2-536

show protocolfilter 2-539

show pvlan 2-540

show pvlan capability 2-542

show pvlan mapping 2-544

show qos info 2-546

show qos status 2-547

show radius 2-548

show rcp 2-549

show reset 2-550

show rspan 2-551

show running-config 2-553

show snmp 2-555

show snmp access 2-557

show snmp community 2-559

show snmp context 2-561

show snmp counters 2-562

show snmp engineid 2-565

show snmp group 2-566

show snmp notify 2-568

show snmp targetaddr 2-570

show snmp targetparams 2-572

show snmp user 2-574

show snmp view 2-576

show span 2-578

show spantree 2-580

show spantree backbonefast 2-583

show spantree blockedports 2-584

show spantree bpdu-skewing 2-585

show spantree conflicts 2-587

show spantree defaultcostmode 2-589

show spantree guard 2-590

show spantree mapping 2-592

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
xiv 78-12648-03
 Contents

show spantree mistp-instance 2-594

show spantree portfast 2-596

show spantree portinstancecost 2-597

show spantree portvlancost 2-598

show spantree statistics 2-599

show spantree summary 2-604

show spantree uplinkfast 2-605

show summertime 2-606

show switchacceleration 2-607

show system 2-608

show tacacs 2-610

show tech-support 2-612

show test 2-614

show test switch-memory 2-620

show time 2-622

show timezone 2-623

show top 2-624

show top report 2-626

show trace 2-628

show traffic 2-630

show trunk 2-631

show udld 2-633

show users 2-635

show version—switch 2-636

show vlan 2-639

show vmps 2-643

show vmps statistics 2-645

show vtp domain 2-646

show vtp statistics 2-648

slip 2-650

sprom read 2-651

squeeze—ROM monitor 2-654

squeeze—switch 2-655

sync 2-656

telnet 2-657

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 xv
 Contents

test snmp trap 2-658

traceroute 2-659

unalias 2-662

undelete—ROM monitor 2-663

undelete—switch 2-664

unset=varname 2-665

upload 2-666

varname= 2-668

verify 2-669

version 2-670

wait 2-671

whichboot 2-672

write 2-673

write tech-support 2-676

write terminal 2-679

APPENDIX A Acronyms A-1

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
xvi 78-12648-03
 Preface

This preface describes who should read the Command Reference—Catalyst 4000 Family,
Catalyst 2948G, and Catalyst 2980G Switches publication, how it is organized, and its document
conventions.
Cisco documentation and additional literature are available in a CD-ROM package, which ships with
your product. The Documentation CD-ROM, a member of the Cisco Connection Family, is updated
monthly. Therefore, it might be more up to date than printed documentation. To order additional copies
of the Documentation CD-ROM, contact your local sales representative or call customer service. The
CD-ROM package is available as a single package or as an annual subscription. You can also access
Cisco documentation on the World Wide Web at http://www.cisco.com, http://www-china.cisco.com, or
http://www-europe.cisco.com.

Audience
This publication is for experienced network administrators who are responsible for configuring and
maintaining Catalyst 4000 family, Catalyst 2948G, and Catalyst 2980G switches.

Organization
This guide is organized as follows:

Chapter Title Description

Chapter 1 Command-Line Interfaces Describes the CLI types found on
Catalyst 4000 family, Catalyst 2948G, and
Catalyst 2980G switches and contains
quick reference guides for all switch and
ROM monitor commands.
Chapter 2 Catalyst 4000 Family, Lists alphabetically all Catalyst 4000
Catalyst 2948G, and family, 2948G, and Catalyst 2980G switch
Catalyst 2980G Switch and and ROM monitor commands and provides
ROM Monitor Commands detailed information on them.
Appendix A Acronyms Defines the acronyms used in this
publication.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 xvii
 Preface
Related Documentation

Related Documentation
Other documents in the Catalyst 4000 family, 2948G, and 2980G switch documentation set include:
• Catalyst 4000 Family Installation Guide
• Catalyst 4912G Installation Guide
• Quick Software Configuration Guide—Catalyst 5000 Family, 4000 Family, 2926G Series, 2948G,
and 2980G Switches
• Software Configuration Guide—Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G
• ATM Software Configuration Guide—Catalyst 5000 Family, Catalyst 4000 Family, Catalyst 2926G
Series, Catalyst 2948G, and Catalyst 2980G Switches
• System Message Guide—Catalyst 6000 Family, Catalyst 5000 Family, Catalyst 4000 Family,
Catalyst 2926G Series, Catalyst 2948G, and Catalyst 2980G Switches
• Catalyst 4000 Family 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 4000 series switches.
• Configuration Fundamentals Command Reference publication—Use this publication to locate
additional information on Cisco IOS commands.

Conventions
This document uses the following typeface and character conventions:

Convention Description
boldface font Commands and keywords are in boldface.
italic font Arguments for which you supply values are in italics.
[ ] Elements in square brackets are optional.
{x|y|z} Alternative keywords are grouped in braces and separated by
vertical bars.
[x|y|z] Optional alternative keywords are grouped in brackets and
separated by vertical bars.
string 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
screenfont.
boldface screen font Information you enter is in boldface screen font.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
xviii 78-12648-03
 Preface
Obtaining Documentation

Convention Description
italic screen font Arguments for which you supply values are in italic
screen font.
^ The symbol ^ represents the key labeled Control . For
example, the key combination ^D in a screen display means
hold down the Control key while you press the D key.
< > Nonprinting characters, such as passwords, are in angle
brackets.

Notes use the following conventions:

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

Cautions 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 Documentation
The following sections provide sources for obtaining documentation from Cisco Systems.

World Wide Web

You can access the most current Cisco documentation on the World Wide Web at the following sites:
• http://www.cisco.com
• http://www-china.cisco.com
• http://www-europe.cisco.com

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

Ordering Documentation
Cisco documentation is available in the following ways:
• Registered Cisco Direct Customers can order Cisco Product documentation from the Networking
Products MarketPlace:

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 xix
 Preface
Obtaining Technical Assistance

http://www.cisco.com/cgi-bin/order/order_root.pl
• Registered Cisco.com users can order the Documentation CD-ROM through the online Subscription
Store:
http://www.cisco.com/go/subscription
• Nonregistered CCO users can order documentation through a local account representative by calling
Cisco corporate headquarters (California, USA) at 408 526-7208 or, in North America, by calling
800 553-NETS(6387).

Documentation Feedback
If you are reading Cisco product documentation on the World Wide Web, you can submit technical
comments electronically. Click Feedback in the toolbar and select Documentation. After you complete
the form, click Submit to send it to Cisco.
You can e-mail your comments to [email protected].
To submit your comments by mail, for your convenience many documents contain a response card
behind the front cover. Otherwise, you can mail your comments to the following address:
Cisco Systems, Inc.
Document Resource Connection
170 West Tasman Drive
San Jose, CA 95134-9883
We appreciate your comments.

Obtaining Technical Assistance

Cisco provides Cisco.com as a starting point for all technical assistance. Customers and partners can
obtain documentation, troubleshooting tips, and sample configurations from online tools. For Cisco.com
registered users, additional troubleshooting tools are available from the TAC website.

Cisco.com
Cisco.com is the foundation of a suite of interactive, networked services that provides immediate, open
access to Cisco information and resources at anytime, from anywhere in the world. This highly
integrated Internet application is a powerful, easy-to-use tool for doing business with Cisco.
Cisco.com provides a broad range of features and services to help customers and partners streamline
business processes and improve productivity. Through Cisco.com, you can find information about Cisco
and our networking solutions, services, and programs. In addition, you can resolve technical issues with
online technical support, download and test software packages, and order Cisco learning materials and
merchandise. Valuable online skill assessment, training, and certification programs are also available.
Customers and partners can self-register on Cisco.com to obtain additional personalized information and
services. Registered users can order products, check on the status of an order, access technical support,
and view benefits specific to their relationships with Cisco.
To access Cisco.com, go to the following website:
http://www.cisco.com

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
xx 78-12648-03
 Preface
Obtaining Technical Assistance

Technical Assistance Center

The Cisco TAC website is available to all customers who need technical assistance with a Cisco product
or technology that is under warranty or covered by a maintenance contract.

Contacting TAC by Using the Cisco TAC Website

If you have a priority level 3 (P3) or priority level 4 (P4) problem, contact TAC by going to the TAC
website:
http://www.cisco.com/tac
P3 and P4 level problems are defined as follows:
• P3—Your network performance is degraded. Network functionality is noticeably impaired, but most
business operations continue.
• P4—You need information or assistance on Cisco product capabilities, product installation, or basic
product configuration.
In each of the above cases, use the Cisco TAC website to quickly find answers to your questions.
To register for Cisco.com, go to the following website:
http://www.cisco.com/register/
If you cannot resolve your technical issue by using the TAC online resources, Cisco.com registered users
can open a case online by using the TAC Case Open tool at the following website:
http://www.cisco.com/tac/caseopen

Contacting TAC by Telephone

If you have a priority level 1(P1) or priority level 2 (P2) problem, contact TAC by telephone and
immediately open a case. To obtain a directory of toll-free numbers for your country, go to the following
website:
http://www.cisco.com/warp/public/687/Directory/DirTAC.shtml
P1 and P2 level problems are defined as follows:
• P1—Your production network is down, causing a critical impact to business operations if service is
not restored quickly. No workaround is available.
• P2—Your production network is severely degraded, affecting significant aspects of your business
operations. No workaround is available.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 xxi
 Preface
Obtaining Technical Assistance

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
xxii 78-12648-03
 C H A P T E R 1
Command-Line Interface

This chapter describes the command-line interface (CLI) available on the Catalyst 4000 family,
Catalyst 2948G, and Catalyst 2980G switches and contains the following sections:
• Switch CLI, page 1-1
• ROM Monitor CLI, page 1-9
Appendix A, “Acronyms,” 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 4000 family, Catalyst 2948G, 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 4000 family, Catalyst 2948G, and Catalyst 2980G switch’s
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 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.

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 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 1-1
 Chapter 1 Command-Line Interface
Switch CLI

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>
password. The Console> prompt
appears indicating that you have
accessed the CLI in normal mode.
Step 3 Enter the necessary commands to Appropriate commands
complete your desired tasks.
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 hostname | ip_addr
telnet command and the name or
IP address of the switch you want
to access.
Step 2 At the prompt, enter the password <password>
for the CLI. If no password has
been configured, press Return.
Step 3 Enter the necessary commands to Appropriate commands
complete your desired tasks.
Step 4 When finished, exit the Telnet quit
session.

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

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

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
1-2 78-12648-03
 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
context. 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.
1
Ctrl-B or the left arrow key Moves the cursor back one character.
Ctrl-C Escapes and terminates prompts and tasks.
Ctrl-D Deletes the character at the cursor.
Ctrl-E Jumps to the end of the current command line.
1
Ctrl-F or the right arrow key Moves the cursor forward one character.
Ctrl-K Deletes from the cursor to the end of the command line.
Ctrl-L; Ctrl-R Repeats current command line on a new line.
1
Ctrl-N or the down arrow key Enters next command line in the history buffer.
1
Ctrl-P or the up arrow key Enters previous command line in the history buffer.
Ctrl-U; Ctrl-X Deletes from the cursor to the beginning of the command
line.
Ctrl-W Deletes last word typed.
Esc B Moves the cursor back one word.
Esc D Deletes from the cursor to the end of the word.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 1-3
 Chapter 1 Command-Line Interface
Switch CLI

Table 1-1 Command-Line Editing Keystrokes (continued)

Keystroke Function
Esc F Moves the cursor forward one word.
Delete key or Backspace key Erases mistake when entering a command; reenter
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:
!! 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:
^aaa^bbb Replace 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 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
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 execute the command.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
1-4 78-12648-03
 Chapter 1 Command-Line Interface
Switch CLI

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 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.

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.

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

Specifying Modules, Ports, and VLANs

Modules, ports, and VLANs are numbered sequentially, beginning with 1. The supervisor engine module
is module 1, residing in slot 1.
To designate a specific module, use the module number. In most systems, the module number and the
slot number are the same. However, in some cases the slot number and the module number are different.
For example, the Route Switch Feature Card (RSFC) on the supervisor engine is physically in slot 1 or
slot 2 but is logically identified as module 15 or module 16.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 1-5
 Chapter 1 Command-Line Interface
Switch CLI

On the fixed-configuration switches, there are two logical modules. However, on the Catalyst 4912G
switch, there are two modules but only one slot. When you enter configuration commands on these
switches, you must refer to the module number, not the slot number. For example, all of the
user-configurable ports on these switches are logically on module 2.
On modules that have user-configurable ports, the left-most port is always port 1. To designate a specific
port on a specific module, the command syntax is mod_num/port_num. For example, 3/1 specifies
module 3, port 1. On the Catalyst 4912G switch, the left-most switch port is numbered 2/1 rather
than 1/1 because the ports are logically located on module 2.
With many commands you can enter lists of ports. To specify a range of ports, use a comma-separated
list (do not insert spaces) to specify individual ports or a hyphen (-) between the port numbers to specify
a range of ports. Hyphens take precedence over commas.
Table 1-4 shows examples of how to designate ports and port ranges.

Table 1-4 Designating Ports and Port Ranges

Example Function
2/1 Specifies port 1 on module 2
3/4-8 Specifies ports 4, 5, 6, 7, and 8 on module 3
5/2,5/4,6/10 Specifies ports 2 and 4 on module 5 and port 10 on module 6
3/1-2,4/8 Specifies ports 1 and 2 on module 3 and port 8 on module 4

VLANs are identified using the VLAN ID, a single number associated with the VLAN. To specify a list
of VLANs, use a comma-separated list (do not insert spaces) to specify individual VLANs or use a
hyphen (-) between the VLAN numbers to specify a range of VLANs.
Table 1-5 shows examples of how to designate VLANs and VLAN ranges.

Table 1-5 Designating VLANs and VLAN Ranges

Example Function
10 Specifies VLAN 10
5,10,15 Specifies VLANs 5, 10, and 15
10-50,500 Specifies VLANs 10 through 50, inclusive, and VLAN 500

Specifying MAC Addresses

Some commands require you to specify a Media Access Control (MAC) address, which must be
designated in a standard format. The MAC address format must be six hexadecimal numbers separated
by hyphens, as shown in the following example:
00-00-0c-24-d2-fe

Specifying IP Addresses, Hostnames, and IP Aliases

Some commands require an IP address, IP hostname, or IP alias. The IP address format is 32 bits, written
in dotted decimal format, as shown in the following example:
172.16.10.1

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
1-6 78-12648-03
 Chapter 1 Command-Line Interface
Switch CLI

If DNS is configured properly on the switch, you can use IP hostnames instead of IP addresses. For
information on configuring DNS, see the Software Configuration Guide–Catalyst 4000 Family,
Catalyst 2948G, and Catalyst 2980G Switches.
You also can configure IP aliases on the switch, which you can use in place of IP addresses. IP aliases
can be used for most commands that use an IP address, except for commands that define the IP address
or IP alias. For information on using IP aliases, see the Software Configuration Guide–Catalyst 4000
Family, Catalyst 2948G, and Catalyst 2980G Switches.

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
disable Disable privileged mode
disconnect Disconnect user session
download Download code to a processor
enable Enable privileged mode
format Format a flash device
help Show this message
history Show contents of history substitution buffer
ping Send echo packets to hosts
pwd Show default flash device

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 1-7
 Chapter 1 Command-Line Interface
Switch CLI

quit Exit from the Admin session

reconfirm Reconfirm VMPS
reload Force software reload to linecard
reset Reset system or module
session Tunnel to ATM or Router module
set Set, use 'set help' for more info
show Show, use 'show help' for more info
slip Attach/detach Serial Line IP interface
squeeze Reclaim space used by deleted files
switch Switch to standby <clock|supervisor>
telnet Telnet to a remote host
test Test, use 'test help' for more info
traceroute Trace the route to a host
undelete Undelete a file on flash device
upload Upload code from a processor
verify Verify checksum of file on flash device
wait Wait for x seconds
whichboot Which file booted
write Write system configuration to terminal/network
Console> (enable)

Displaying Command Categories

When you enter help or ? after some commands (such as clear, set, and show), a list of commands in
that category is displayed. For example, the following display shows a partial list of commands for the
clear category:
Console> (enable) clear help

Clear commands:
----------------------------------------------------------------------------
clear alias Clear aliases of commands
clear arp Clear ARP table entries
clear banner Clear Message Of The Day banner
clear boot Clear booting environment variable
clear cam Clear CAM table entries
...

Using Context-Sensitive Help

Usage and syntax information for individual commands are displayed by appending help or ? to any
specific command. For example, the following display shows usage and syntax information for the set
length command:
Console> set length help
Usage: set length <screenlength>
(screenlength = 5..512, 0 to disable 'more' feature)
Console>

Performing Keyword Lookups

You can use the self-repeat feature and the keyword-lookup or partial-keyword-lookup functions by
entering ?.
To use the keyword-lookup function, enter ? to display a list of valid keywords and arguments for a
command. Insert a space between the last parameter and the question mark (?). For example, eight
parameters are used by the set mls command. To see these parameters, enter set mls ? at the privileged
prompt.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
1-8 78-12648-03
 Chapter 1 Command-Line Interface
ROM Monitor CLI

The system displays all valid keywords and arguments as follows:

Console> (enable) set mls ?
agingtime Set agingtime for MLS cache entry
disable Disable MLS in the switch
enable Enable MLS in the switch
nde Configure Netflow Data Export
flow Set minimum flow mask
include Include MLS-RP
multicast Set MLS feature for multicast
statistics Add protocols to protocol statistics list
Console> (enable) set mls

Note that the system repeats the command you entered without the ?.
To use the partial-keyword-lookup function, enter ? to display a list of commands that begin with a
specific set of characters. Do not insert a space between the last letter of the variable and the question
mark (?). For example, enter co? at the privileged prompt to display a list of commands that start with
co. The system displays all commands that begin with co as follows:
Console> (enable) co?
configureConfigure system from network
copy Copy files between TFTP/RCP/module/flash devices
Console> (enable) co

Note that the system repeats the command you entered without the ?.

ROM Monitor CLI

The ROM monitor is a ROM-based program that executes upon platform power-up or reset or when a
fatal exception occurs.

Accessing the ROM Monitor CLI

The system enters ROM monitor mode if the switch does not find a valid system image, if the nonvolatile
RAM (NVRAM) configuration is corrupted, or if the configuration register is set to enter ROM monitor
mode. You can manually load an image from any Flash device.
You can also enter ROM monitor mode by restarting the switch and pressing the Break key during the
first 60 seconds of startup.

Note The Break key is always enabled for 60 seconds after rebooting the system, regardless of whether the
Break key is configured to be off by configuration register settings.

To access the ROM monitor through a terminal server, you can escape to the Telnet prompt and enter the
send break command for your terminal emulation program to break into ROM monitor mode.
Once you are in ROM monitor mode, the prompt changes to rommon>. Use the ? command to see the
available ROM monitor commands.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 1-9
 Chapter 1 Command-Line Interface
ROM Monitor CLI

Operating the ROM Monitor CLI

ROM monitor commands are used to load and copy system images, microcode images, and configuration
files. System images contain the system software. Microcode images contain microcode to be
downloaded to various hardware devices. Configuration files contain commands entered to customize
the function of Cisco IOS software.
The manual boot command has the following syntax:
boot [-xv] [device][imagename]
If you do not specify an image name, the system defaults to the first valid file in the device. The image
name is case sensitive.

Note The Catalyst enterprise LAN switches do not support netboot.

Once you are in ROM monitor mode, the prompt changes to rommon #>.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
1-10 78-12648-03
 C H A P T E R 2
Catalyst 4000 Family, Catalyst 2948G, and
Catalyst 2980G Switch and ROM Monitor
Commands

This chapter contains an alphabetical listing of all switch and ROM monitor commands available on the
Catalyst 4000 family, Catalyst 2948G, and Catalyst 2980G switches.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-1
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
alias

alias
Use the alias command to set and display aliases.

alias [name=value]

Syntax Description name= (Optional) Name you give to the alias.

value (Optional) Value of the alias.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Usage Guidelines If value contains white space or other special (shell) characters, you must enclose the entry in quotation
marks. If value has a space as its last character, the next command line word is checked for an alias
(normally, only the first word on a command line is checked).
Without an argument, this command prints a list of all alias names and their values.
An equal sign (=) is required between the name and value of the alias.

Examples This example shows how to display a list of available alias commands and how to create an alias for the
set command:
rommon 1 > alias
r=repeat
h=history
?=help
b=boot
i=reset
rommon 2 > alias s=set
rommon 3 > alias
r=repeat
h=history
?=help
b=boot
i=reset
s=set
rommon 4 > s
PS1=rommon ! >
BOOT=bootflash:RTSYNC_llue_11,1;slot0:f1,1;
=========================================================================

Related Commands unalias

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-2 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
boot

boot
Use the boot command to boot up an external process.

boot [-x] [-v] [device][imagename]

Syntax Description -x (Optional) Load the image but do not execute.

-v (Optional) Toggle verbose mode.
device (Optional) ID of the device.
imagename (Optional) Name of the image.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Usage Guidelines With no arguments, boot will boot the first image in Flash memory. Specify an image by typing its name.
Specify the device by typing the device ID.
You must specify a device name.

Examples This example shows how to use the boot command:

rommon> boot -x bootflash:cat5000-sup3.6-1-0-59.bin
CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
Uncompressing file:
##########################################################################################
##########################################################################################
################################################################################
rommon>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-3
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
cd

cd
Use the cd command to set the default Flash device for the system.

cd [[m/]device:]]

Syntax Description m/ (Optional) Module number of the supervisor engine containing the
Flash device.
device: (Optional) Flash device name. Valid devices include bootflash:,
slot0:, and slot1:.

Defaults By default, the Flash device is bootflash.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines A colon (:) is required after the specified device.

For those commands for which device is an option, the device set by cd is used if a Flash device is not
specified.
This command is supported on the Supervisor Engine III only.

Examples This example shows how to set the system default Flash device to bootflash:
Console> (enable) cd bootflash:
Console> (enable)

Related Commands pwd

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-4 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear alias

clear alias
Use the clear alias command to clear the abbreviated versions of commands.

clear alias {name | all}

Syntax Description name Alternate identifier of the command.

all Keyword to identify every alternate identifier previously created.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to erase the arpdel alias:

Console> (enable) clear alias arpdel
Command alias deleted.
Console> (enable)

This example shows how to erase all the aliases:

Console> (enable) clear alias all
Command alias table cleared. (1)
Console> (enable)

(1) indicates the number of entries cleared.

Related Commands set alias

show alias

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-5
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear arp

clear arp
Use the clear arp command to delete a specific entry or all entries from the ARP table.

clear arp [all | dynamic | permanent | static]

clear arp ip_addr

Syntax Description all (Optional) Keyword to clear all ARP entries.

dynamic (Optional) Keyword to clear all dynamic ARP entries.
permanent (Optional) Keyword to clear all permanent ARP entries.
static (Optional) Keyword to clear all static ARP entries.
ip_addr IP address to clear from the ARP table.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to remove a specific IP address from the ARP table:
Console> (enable) clear arp 198.133.219.209
ARP entry deleted.
Console> (enable)

This example shows how to remove all entries from the ARP table:
Console> (enable) clear arp all
ARP table cleared. (1)
Console> (enable)

(1) indicates the number of entries cleared.

This example shows how to remove all ARP entries of a specific type:
Console> (enable) clear arp dynamic
Unknown host
Dynamic ARP entries cleared. (3)
Console> (enable)

Related Commands set arp

show alias

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-6 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear banner motd

clear banner motd

Use the clear banner motd command to clear the message-of-the-day banner.

clear banner motd

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You can use either the clear banner motd command or the set banner motd ## command to clear the
message-of-the-day banner.

Examples This example shows how to clear the message-of-the-day banner:

Console> (enable) clear banner motd
MOTD banner cleared
Console> (enable)

Related Commands set banner motd

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-7
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear boot—ROM monitor

clear boot—ROM monitor

Use the clear boot command to clear the contents of the BOOT environment variable and the autoboot
state machine.

clear boot

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Examples This example shows how to clear the contents of the BOOT environment:
rommon 1 > clear boot
rommon 2 >

Related Commands boot

show boot—ROM monitor

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-8 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear boot—switch

clear boot—switch
Use the clear boot command to clear the contents of the BOOT environment variable and the
configuration register setting.

clear boot system all [mod]

clear boot system flash device:[filename] [mod]

clear boot auto-config [mod]

Syntax Description all Keyword to clear the whole BOOT environment variable.
mod (Optional) Module number of the supervisor engine on which to clear the BOOT
environment variable.
flash Keyword to specify the Flash file system.
device: Valid devices include bootflash, slot0, and slot1.
filename (Optional) Filename of the system image on the Flash device.
auto-config Keyword to specify the auto-config file.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you want to rearrange the booting order, you can use the prepend keyword with the set boot system
command or you can clear the entire BOOT environment variable using the clear boot system command
and then redefine the list.
This command is supported on the Supervisor Engine III only.

Examples This example shows how to clear the contents of the Flash device:
Console> (enable) clear boot system all
BOOT variable =
Console> (enable)

This example shows how to clear the auto-config file:

Console> (enable) clear boot auto-config
CONFIG_FILE variable =
Console> (enable)

Related Commands show boot—switch

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-9
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear cam

clear cam
Use the clear cam command to delete a specific entry or all entries from the CAM table.

clear cam {mac_addr | dynamic | static | permanent} [vlan]

Syntax Description mac_addr One or more MAC addresses to clear from the CAM table.
dynamic Keyword to clear the dynamic CAM entries from the CAM table.
static Keyword to clear the static CAM entries from the CAM table.
permanent Keyword to clear the permanent CAM entries from the CAM table.
vlan (Optional) Number of the VLAN associated with the CAM entries.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you enter the clear cam command, the EARL CAM table entries are cleared.

Examples This example shows how to remove MAC address 00-40-0b-a0-03-fa from the CAM table:
Console> (enable) clear cam 00-40-0b-a0-03-fa
CAM table entry cleared.
Console> (enable)

This example shows how to clear dynamic entries from the CAM table:
Console> (enable) clear cam dynamic
Dynamic CAM entries cleared.
Console> (enable)

Related Commands set cam

show cam

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-10 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear cgmp statistics

clear cgmp statistics

Use the clear cgmp statistics command to clear CGMP statistical information.

clear cgmp statistics

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to clear CGMP statistical information:

Console> (enable) clear cgmp statistics
CGMP statistics cleared.
Console> (enable)

Related Commands set cgmp

show cgmp leave
show cgmp statistics

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-11
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear config pvlan

clear config pvlan

Use the clear config pvlan command to clear all private VLAN configurations in the system, including
port mappings.

clear config pvlan

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to clear all private VLAN configurations in the system:
Console> (enable) clear config pvlan
This command will clear all private VLAN configurations.
Do you want to continue (y/n) [n]? y
VLAN 15 deleted
VLAN 16 deleted
VLAN 17 deleted
VLAN 18 deleted
Private VLAN configuration cleared.
Console> (enable)

Related Commands clear vlan

clear pvlan mapping
configure
set pvlan
set pvlan mapping
set vlan
show config
show pvlan
show pvlan mapping
show vlan

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-12 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear config—ROM monitor

clear config—ROM monitor

Use the clear config command to clear information about the system or module configuration stored in
NVRAM.

clear config all

Syntax Description all Keyword that specifies all modules and system configuration
information including the IP address.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Usage Guidelines When you clear the configuration using the clear config all command, the default switch configuration
is restored. The information that is cleared includes manually configured IP addresses and IP addresses
learned through DHCP or RARP.
When you clear the configuration, the IP address and subnet mask on the me1 and sc0 interfaces are set
to 0.0.0.0. The me1 interface is brought down, and the sc0 interface is brought up.

Note Before using the clear config all command, save a backup of the configuration.

Examples This example shows how to delete all the configuration information:
rommon 1 > set boot config-register ignore-config enable
rommon 2 > boot -x bootflash:cat4000.6-1-1.bin
CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
CCCCCCCCCCCCCCCCCCC#############################
Starting Off-line Diagnostics
[ output of Off-line Diagnostics ]
Exiting Off-line Diagnostics
IP address for Catalyst not configured
DHCP/BOOTP will commence after the ports are online
Ports are coming online ...
Cisco Systems, Inc. Console
Enter password:
2000 Jun 24 06:29:21 %SYS-4-NVLOG:initBootNvram:ignore-config enabled:clear config all
Console>

Related Commands configure

show config

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-13
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear config—switch

clear config—switch
Use the clear config command to clear the system or module configuration information stored in
NVRAM.

clear config {mod | rmon | all | snmp | acl nvram}

Syntax Description mod Number of the module.

rmon Keyword to clear all RMON configurations, including the historyControlTable, the
alarmTable, the eventTable, and the ringStation ControlTable.
all Keyword to clear all module and system configuration information, including the IP
address.
snmp Keyword to clear all SNMP configurations.
acl nvram Keywords to clear all ACL configurations.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines When you clear the configuration using the clear config all command, the default switch configuration
is restored. The information that is cleared includes manually configured IP addresses and IP addresses
learned through DHCP or RARP.
When you clear the configuration, the IP address and subnet mask on the sc0 interface are set to 0.0.0.0.

Note Before using the clear config all command, save a backup of the configuration.

Examples This example shows how to delete the configuration information in NVRAM on module 2:
Console> (enable) clear config 2
This command will clear module 2 configuration.
Do you want to continue (y/n) [n]? y
..............................
Module 2 configuration cleared.
Console> (enable)

This example shows how to delete the configuration information stored in NVRAM on module 1
(supervisor engine):
Console> (enable) clear config 1
This command will clear module 1 configuration.
Do you want to continue (y/n) [n]? y
......

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-14 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear config—switch

Module 1 configuration cleared.

host%

This example shows how to delete all the configuration information:

Console> (enable) clear config all
This command will clear all configuration in NVRAM.
This command will cause ifIndex to be reassigned on the next system startup.
Do you want to continue (y/n) [n]? y
Releasing IP address...Done
......
.................
.....................................................

System configuration cleared.

Console> (enable)

This example shows how to delete all the SNMP configuration information:
Console> (enable) clear config snmp
This command will clear SNMP configuration in NVRAM.
Do you want to continue (y/n) [n]? y
...........................................
Connection closed by foreign host
host%

This example shows how to delete all ACL configuration information from NVRAM:
Console> (enable) clear config acl nvram
ACL configuration has been deleted from NVRAM.
Warning:Use the copy commands to save the ACL configuration to a file
and the 'set boot config-register auto-config' commands to configure the
auto-config feature.
Console> (enable)

Related Commands configure

show config

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-15
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear counters

clear counters
Use the clear counters command to clear MAC and port counters.

clear counters

Syntax Description This command has no keywords or arguments.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines This command also clears ATM module counters.

Examples This example shows how to reset MAC and port counters to zero:
Console> (enable) clear counters
MAC and Port counters cleared.
Console> (enable)

Related Commands show port

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-16 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear crypto key rsa

clear crypto key rsa

Use the clear crypto key rsa command to remove all RSA public-key pairs.

clear crypto key rsa

Syntax Description This command has no keywords or arguments.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to clear RSA key pairs:

Console> (enable) clear crypto key rsa
Do you really want to clear RSA keys (y/n) [n]? y
RSA keys has been cleared.
Console> (enable)

Related Commands set crypto key rsa

show crypto key

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-17
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear dot1x config

clear dot1x config

Use the clear dot1x config command to disable dot1x on all ports and return the values to the factory
default settings.

clear dot1x config

Syntax Description This command has no keywords or arguments.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to disable dot1x and return the values to the factory default settings:
Console> (enable) clear dot1x config
This command will disable Dot1x and take values back to factory default.

Do you want to continue (y/n) [n]? y

Dot1x config cleared.
Console> (enable)

Related Commands set dot1x

set port dot1x
show dot1x
show port dot1x

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-18 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear gmrp statistics

clear gmrp statistics

Use the clear gmrp statistics command to clear all the GMRP statistics information from a specified
VLAN or all VLANs.

clear gmrp statistics {vlan | all}

Syntax Description vlan Number of the VLAN.

all Keyword to specify all VLANs.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to clear GMRP statistical information from all VLANs:
Console> (enable) clear gmrp statistics all
GMRP statistics cleared.
Console> (enable)

This example shows how to clear GMRP statistical information from VLAN 1:
Console> (enable) clear gmrp statistics 1
GMRP statistics cleared from VLAN 1.
Console> (enable)

Related Commands show gmrp statistics

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-19
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear gvrp statistics

clear gvrp statistics

Use the clear gvrp statistics command to clear all the GVRP statistics information.

clear gvrp statistics {mod/port | all}

Syntax Description mod/port Number of the module and port.

all Keyword that specifies all ports.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to clear GVRP statistical information:

Console> (enable) clear gvrp statistics all
GVRP statistics cleared for all ports.
Console> (enable)

This example shows how to clear GVRP statistical information for module 2, port 1:
Console> (enable) clear gvrp statistics 2/1
GVRP statistics cleared on port 2/1.
Console> (enable)

Related Commands set gvrp

show gvrp statistics

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-20 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear ip alias

clear ip alias
Use the clear ip alias command to clear IP aliases that are set using the set ip alias command.

clear ip alias {name | all}

Syntax Description name IP address alias to delete.

all Keyword that specifies that all previously set IP address aliases be
deleted.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to delete a previously defined IP alias named babar:
Console> (enable) clear ip alias babar
IP alias deleted.
Console> (enable)

Related Commands set ip alias

show ip alias

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-21
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear ip dns domain

clear ip dns domain

Use the clear ip dns domain command to clear the default DNS domain name.

clear ip dns domain

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to clear the default DNS domain name:
Console> (enable) clear ip dns domain
Default DNS domain name cleared.
Console> (enable)

Related Commands set ip dns domain

show ip dns

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-22 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear ip dns server

clear ip dns server

Use the clear ip dns server command to remove a DNS server from the DNS server listing.

clear ip dns server {ip_addr | all}

Syntax Description ip_addr IP address of the DNS server you want to remove. An IP alias or a
host name that can be resolved through DNS can also be used.
all Keyword that specifies all the IP addresses in the DNS server listing
be removed.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to remove the DNS server at IP address 192.168.255.255 from the DNS server
listing:
Console> (enable) clear ip dns server 192.168.255.255
192.168.255.255 cleared from DNS table.
Console> (enable)

Related Commands set ip dns server

show ip dns

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-23
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear ip permit

clear ip permit
Use the clear ip permit command to remove a specified IP address and mask or all IP addresses and
masks from the permit list.

clear ip permit {ip_addr} [mask] [telnet | ssh | snmp | all]

clear ip permit all

Syntax Description ip_addr IP address to be cleared. An IP alias or a host name that can be
resolved through DNS can also be used.
mask (Optional) Subnet mask of the specified IP address.
telnet (Optional) Keyword that specifies removal from the Telnet IP
permit list.
ssh (Optional) Keyword that specifies removal from the SSH permit
list.
snmp (Optional) Keyword that specifies removal from the SNMP IP
permit list.
all (Optional) Keyword that specifies removal from both SNMP and
Telnet IP permit lists.
all Keyword that specifies all entries in the IP permit list be removed.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The clear ip permit all command clears the permit list but does not change the state of the IP permit
feature. A warning is displayed if all IP addresses are cleared from the permit list, and the feature is
enabled. If a mask other than the default (255.255.255.255) has been configured, you must provide both
the address and mask to clear a specific entry.
If the telnet, ssh, snmp, or all keywords are not specified, the IP address is removed from both the
SNMP and Telnet permit lists.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-24 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear ip permit

Examples These examples show how to remove specified IP addresses:

Console> (enable) clear ip permit 172.100.101.102
172.100.101.102 cleared from IP permit list.
Console> (enable)

Console> (enable) clear ip permit 172.160.161.0 255.255.192.0 snmp

172.160.128.0 with mask 255.255.192.0 cleared from snmp permit list.
Console> (enable)

Console> (enable) clear ip permit 172.100.101.102 telnet

172.100.101.102 cleared from telnet permit list.
Console> (enable)

Console> (enable) clear ip permit 172.100.101.102 ssh

172.100.101.102 cleared from secure shell permit list.
Console> (enable)

Console> (enable) clear ip permit all

IP permit list cleared.
WARNING
IP permit list is still enabled.
Console> (enable)

Related Commands set ip permit

show ip permit
show port counters

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-25
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear ip route—ROM monitor

clear ip route—ROM monitor

Use the clear ip route command to clear IP routes that are set using the set ip command.

clear ip route all

Syntax Description all Keyword that specifies that all previously set IP address routes be
deleted.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Examples This example shows how to delete previously defined IP routes:

rommon 1 > clear ip route all
rommon 2 >

Related Commands set ip route—ROM monitor

show ip route—ROM monitor

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-26 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear ip route—switch

clear ip route—switch
Use the clear ip route command to delete IP routing table entries.

clear ip route all

clear ip route destination gateway

Syntax Description all Keyword that deletes all IP routing table entries.
destination IP address of the host or network. An IP alias or a host name that
can be resolved through DNS can also be used.
gateway IP address or alias of the gateway router.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to delete the route table entries using the clear ip route command:
Console> (enable) clear ip route 172.16.2.2 elvis
Route deleted.
Console> (enable)

Related Commands set ip route—switch

show ip route—switch

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-27
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear kerberos clients mandatory

clear kerberos clients mandatory

Use the clear kerberos clients mandatory command to disable mandatory Kerberos authentication for
services on the network.

clear kerberos clients mandatory

Syntax Description This command has no arguments or keywords.

Defaults By default, kerberos clients are not set to mandatory.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines A user authenticated to a Kerberized switch has a ticket granting ticket (TGT) and can use it to
authenticate to a host on the network. However, if forwarding is not enabled and a user tries to list
credentials after authenticating to a host, the output will show no Kerberos credentials present.
You can optionally configure the switch to forward users’ TGTs with them as they authenticate from the
switch to Kerberized remote hosts on the network when using Kerberized Telnet.
As an added layer of security, you can optionally configure the switch so that after users authenticate to
it, they can authenticate to other services on the network only with Kerberos clients. If you do not make
Kerberos authentication mandatory and Kerberos authentication fails, the application attempts to
authenticate users using the default method of authentication for that network service. For example,
Telnet prompts for a password.

Examples This example shows how to clear mandatory Kerberos authentication:

Console> (enable) clear kerberos clients mandatory
Kerberos clients mandatory cleared
Console> (enable)

Related Commands set kerberos clients mandatory

set kerberos credentials forward

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-28 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear kerberos credentials forward

clear kerberos credentials forward

Use the clear kerberos credentials forward command to disable credentials forwarding.

clear kerberos credentials forward

Syntax Description This command has no arguments or keywords.

Defaults By default, forwarding is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines A user authenticated to a Kerberized switch has a ticket granting ticket (TGT) and can use it to
authenticate to a host on the network. However, if forwarding is not enabled and a user tries to list
credentials after authenticating to a host, the output will show no Kerberos credentials present.
You can optionally configure the switch to forward users’ TGTs with them as they authenticate from the
switch to Kerberized remote hosts on the network when using Kerberized Telnet.

Examples This example shows how to disable Kerberos credentials forwarding:

Console> (enable) clear kerberos credentials forward
Kerberos credentials forwarding disabled
Console> (enable)

Related Commands set kerberos clients mandatory

set kerberos credentials forward

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-29
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear kerberos creds

clear kerberos creds

Use the clear kerberos creds command to delete all the Kerberos credentials.

clear kerberos creds

Syntax Description This command has no arguments or keywords.

Defaults By default, forwarding is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines A user authenticated to a Kerberized switch has a ticket granting ticket (TGT) and can use it to
authenticate to a host on the network. This command deletes all Kerberos credentials.

Examples This example shows how to delete all Kerberos credentials:

Console> (enable) clear kerberos creds
Console> (enable)

Related Commands set kerberos credentials forward

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-30 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear kerberos realm

clear kerberos realm

Use the clear kerberos realm command to clear an entry that is mapping the name of a Kerberos realm
to a DNS domain name or a host name.

clear kerberos realm {dns-domain | host} kerberos-realm

Syntax Description dns-domain DNS domain name to map to a Kerberos realm.

host IP address or name to map to a Kerberos realm.
kerberos-realm IP address or name of a Kerberos realm.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The name of the Kerberos realm can sometimes be mapped to a DNS domain name or a host name. This
mapping can be done with the set kerberos realm command.

Examples This example shows how to clear an entry mapping a kerberos-realm to a domain name:
Console> (enable) clear kerberos realm CISCO CISCO.COM
Kerberos DnsDomain-Realm entry CISCO - CISCO.COM deleted
Console> (enable)

Related Commands set kerberos local-realm

set kerberos realm

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-31
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear kerberos server

clear kerberos server

Use the clear kerberos server command to clear a specified key distribution center (KDC) entry.

clear kerberos server kerberos-realm {hostname | ip-address} [port_num]

Syntax Description kerberos-realm Name of a Kerberos realm.

hostname Name of host running the KDC.
ip-address IP address of host running the KDC.
port_num Number of the port on the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You can specify to the switch which KDC to use in a Kerberos realm. This command clears a server entry
from the table.

Examples This example shows how to clear a KDC server entered on the switch:
Console> (enable) clear kerberos server CISCO.COM 187.0.2.1 750
Kerberos Realm-Server-Port entry CISCO.COM-187.0.2.1-750 deleted
Console> (enable)

Related Commands set kerberos server

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-32 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear kerberos srvtab entry

clear kerberos srvtab entry

Use the clear kerberos srvtab entry command to clear the SRVTAB file that is entered directly into the
switch from the command line.

clear kerberos srvtab entry kerberos-principal principal-type

Syntax Description kerberos-principal Service on the switch.

principal-type Version of the Kerberos SRVTAB.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to clear a SRVTAB file entered directly into the switch:
kerberos> (enable) clear kerberos srvtab entry host/[email protected] 0
kerberos> (enable)

Related Commands set kerberos srvtab entry

set kerberos srvtab remote

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-33
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear key config-key

clear key config-key

Use the clear key config-key command to clear the configuration key.

clear key config-key

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to delete a DES key:

Console> (enable) clear key config-key

Related Commands set key config-key

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-34 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear log

clear log
Use the clear log command set to delete module, system error log, or dump log entries.

clear log [mod]

clear log dump

Syntax Description mod (Optional) Module number.

dump Keyword to clear dump log entries.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you do not specify a module number, the system error log for the entire system is erased.

Examples This example shows how to clear the system error log:
Console> (enable) clear log
System error log cleared.
Console> (enable)

This example shows how to clear the dump log:

Console> (enable) clear log dump
Console> (enable)

Related Commands show kerberos

show log

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-35
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear log command

clear log command

Use the clear log command command to clear the command log entry table.

clear log command [mod]

Syntax Description mod (Optional) Number of the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The command log entry table is a history log of the commands input to the switch from the console or
from Telnet.

Examples This example shows how to clear the command log table for module 3:
Console> (enable) clear log command 3
Module 3 log cleared.
Console> (enable)

Related Commands show log command

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-36 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear logging buffer

clear logging buffer

Use the clear logging buffer command to clear the system logging buffer.

clear logging buffer

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to clear the system logging buffer:
Console> (enable) clear logging buffer
System logging buffer cleared.
Console> (enable)

Related Commands show logging buffer

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-37
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear logging level

clear logging level

Use the clear logging level command to reset the default logging level of all facilities to their default
factory settings.

clear logging level [facility | all]

Syntax Description facility (Optional) Name of facility to reset. For facility types, see set
logging level.
all (Optional) Keyword that specifies to reset all facilities.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to reset all facilities back to their factory default settings:
Console> (enable) clear logging level all
Default logging level for all facilities cleared.

This example shows how to reset a system back to its factory default settings:
Console> (enable) clear logging level system
Default logging level for facility <sys> cleared.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-38 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear logging server

clear logging server

Use the clear logging server command to delete a syslog server from the system log server table.

clear logging server ip_addr

Syntax Description ip_addr IP address of the syslog server to be deleted.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to delete a syslog server from the configuration:
Console> (enable) clear logging server 192.168.255.255
System log server 192.168.255.255 removed from system log server table.
Console> (enable)

Related Commands set logging server

show logging

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-39
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear multicast router

clear multicast router

Use the clear multicast router command to clear manually configured multicast router ports from the
multicast router port list.

clear multicast router {mod_num/port_num | all}

Syntax Description mod_num Number of the module.

port_num Number of the port on the module.
all Keyword that specifies all multicast router ports to be cleared.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to remove port 1 on module 3 from the list of multicast router ports:
Console> (enable) clear multicast router 3/1
Port 3/1 cleared from multicast router port list.
Console> (enable)

Related Commands set multicast router

show multicast router

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-40 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear ntp key

clear ntp key

Use the clear ntp key command to remove all authentication keys or a specific authentication key.

clear ntp key {public_keynum | all}

Syntax Description public_keynum Number of the key pair. Valid values are 1 to 4292945295.
all Keyword that specifies to remove all authentication keys.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to clear an NTP authentication key:

Console> (enable) clear ntp key 435
NTP key 435 cleared.
Console> (enable)

Related Commands set ntp key

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-41
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear ntp server

clear ntp server

Use the clear ntp server command to remove one or more servers from the NTP server table.

clear ntp server {ip_addr | all}

Syntax Description ip_addr IP address of the server to remove from the server table.
all Keyword that specifies that all server addresses in the server table
be removed.

Defaults In the default configuration, no NTP servers are configured.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to clear a specific NTP server from the server table:
Console> (enable) clear ntp server 172.20.22.191
NTP server 172.20.22.191 removed.
Console> (enable)

This example shows how to clear all NTP servers from the server table:
Console> (enable) clear ntp server all
All NTP servers cleared.
Console> (enable)

Related Commands set ntp server

show ntp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-42 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear ntp timezone

clear ntp timezone

Use the clear ntp timezone command to return the time zone to its default, Coordinated Universal Time
(UTC).

clear ntp timezone

Syntax Description This command has no arguments or keywords.

Defaults By default, the time zone is set to UTC.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The clear ntp timezone command functions only when NTP is running. If you set the time manually
and NTP is disengaged, this command has no effect.

Examples This example shows how to clear the time zone:

Console> (enable) clear ntp timezone
Timezone name and offset cleared.
Console> (enable)

Related Commands set ntp timezone

show ntp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-43
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear port host

clear port host

Use the clear port host command to return access ports back to the system default configuration.

clear port host

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to clear port host 1 on module 2:

Console> (enable) clear port host 2/1
Port(s) 2/1 trunk mode set to auto.
Spantree port 2/1 fast start disabled.
Port(s) 2/1 channel mode set to auto.
Console> (enable)

This example shows how to clear port hosts 1 to 4 on module 2:

Console> (enable) clear port host 2/1-4
Port(s) 2/1 trunk mode set to auto.
Port(s) 2/2 trunk mode set to auto.
Port(s) 2/3 trunk mode set to auto.
Port(s) 2/4 trunk mode set to auto.
Spantree ports 2/1-4 fast start disabled.
Port(s) 2/1 channel mode set to auto.
Port(s) 2/2 channel mode set to auto.
Port(s) 2/3 channel mode set to auto.
Port(s) 2/4 channel mode set to auto.
console> (enable)

Related Commands set port host

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-44 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear port security

clear port security

Use the clear port security command to clear all MAC addresses or a specific MAC address from the
list of secure MAC addresses on a port.

clear port security mod_num/port_num {mac_addr | all}

Syntax Description mod_num/ (Optional) Number of the module and the ports on the module.
port_num
mac_addr Specific MAC address to be deleted.
all Keyword that removes all MAC addresses.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to remove a specific MAC address from a port’s list of secure addresses:
Console> (enable) clear port security 4/1 00-11-22-33-44-55
00-11-22-33-44-55 cleared from secure address list list for port 4/1.
Console> (enable)

Related Commands set port security

show port security

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-45
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear pvlan mapping

clear pvlan mapping

Use the clear pvlan mapping command to delete a private VLAN mapping.

clear pvlan mapping {primary_vlan}{isolated_vlan | community_vlan}{mod/port}

clear pvlan mapping {mod/port}

Syntax Description primary_vlan Number of the primary VLAN.

isolated_vlan Number of the isolated VLAN.
community_vlan Number of the community VLAN.
mod/port Number of the module and promiscuous port on the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you do not specify the mapping to clear, all the mappings of the specified promiscuous ports are
cleared.

Examples This example shows how to clear the mapping of VLAN 902 to 901, previously set on module 3, ports
2 to 5:
Console> (enable) clear pvlan mapping 901 902 3/2-5
Successfully cleared mapping between 901 and 902 on 3/2-5
Console> (enable)

Related Commands clear config pvlan

clear vlan
set pvlan
set pvlan mapping
set vlan
show pvlan
show pvlan mapping
show vlan

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-46 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear qos config

clear qos config

Use the clear qos config command to return the values set by the set qos command to the default values
and delete the Class of Service-to-MAC address mappings.

clear qos config

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to return the values set by the set qos command to the default values and delete
the Class of Service (CoS) assigned to MAC addresses:
Console> (enable) clear qos config
This command will disable QoS and take values back to factory default.
Do you want to continue (y/n) [n]? y
QoS config cleared.
Console> (enable)

Related Commands set qos

show qos status

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-47
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear qos defaultcos

clear qos defaultcos

Use the clear qos defaultcos command to restore the default Class of Service (CoS) value for the entire
switch.

clear qos defaultcos

Syntax Description This command has no arguments or keywords.

Defaults By default, CoS for the entire switch is set to CoS equals 0.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to restore the default CoS value for the entire switch:
Console> (enable) clear qos defaultcos
qos defaultcos setting cleared.
Console> (enable)

Related Commands set qos

show qos status

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-48 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear qos map

clear qos map

Use the clear qos map command to return the CoS-to-transmit queue and drop threshold values to their
default values.

clear qos map port_type

Syntax Description port_type Port type. Valid port types are 1q4t and 2q1t.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to return the CoS-to-transmit queue and drop threshold mappings to the default
values on 1q4t ports:
Console> (enable) clear qos map 1q4t
Qos map setting cleared.
Console> (enable)

Related Commands set qos map

show qos status

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-49
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear radius key

clear radius key

Use the clear radius key command to clear all or one of the RADIUS shared keys from the RADIUS
shared key table.

clear radius key

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to clear the RADIUS key:

Console> (enable) clear radius key
Radius server key cleared.
Console> (enable)

Related Commands set radius key

show radius

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-50 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear radius server

clear radius server

Use the clear radius server command to clear all or one of the RADIUS servers from the RADIUS
server table.

clear radius server all

clear radius server ip_addr

Syntax Description all Keyword that specifies all RADIUS servers.

ip_addr IP address of the RADIUS server you want to remove.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to clear a specific RADIUS server from the RADIUS server table:
Console> (enable) clear radius server 192.168.255.255
192.168.255.255 cleared from radius server table.
Console> (enable)

Related Commands set radius server

show radius

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-51
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear rcp

clear rcp
Use the clear rcp command to clear rcp information for file transfers.

clear rcp

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to clear rcp information:

Console> (enable) clear rcp
Console> (enable)

Related Commands set rcp username

show rcp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-52 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear snmp access

clear snmp access

Use the clear snmp access command to remove the access rights of an SNMP group with a specific
security model and security level.

clear snmp access [-hex] {groupname security-model {v1 | v2c | v3} {noauthentication |
authentication | privacy}

Syntax Description -hex (Optional) Keyword that displays the groupname in hexadecimal format.
groupname SNMP access table name.
security-model v1 | v2c Keywords to specify the security model v1 or v2c.
security-model v3 Keywords to specify security model v3.
noauthentication Security model is not set to use authentication protocol.
authentication Indicates the type of authentication protocol.
privacy Messages sent on behalf of the user are protected from disclosure.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you use special characters for groupname (nonprintable delimiters for this parameter), you must use
a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example,
00:ab:34.

Examples This example shows how to clear SNMP access for a group:
Console> (enable) clear snmp access cisco-group security-model v3 authentication
Cleared snmp access cisco-group version v3 level authentication.
Console> (enable)

Related Commands clear config—switch

set snmp access
show snmp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-53
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear snmp community

clear snmp community

Use the clear snmp community command to remove the mappings between different community strings
and security modes.

clear snmp community index [-hex] {index_name}

Syntax Description index Keyword to specify clearing an index.

-hex (Optional) Keyword to display the index_name in hexadecimal format.
index_name Name of the SNMP index.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you use special characters for index_name (nonprintable delimiters for this parameter), you must use
a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example,
00:ab:34.
If you do not enter an index_name, a NULL context string is used.

Examples This example shows how to clear SNMP access for a group:
Console> (enable) clear snmp community index ind1
Cleared snmp community ind1.
Console> (enable)

Related Commands set snmp community

show snmp community

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-54 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear snmp group

clear snmp group

Use the clear snmp group command to clear the SNMP user from an SNMP group.

clear snmp group [-hex] groupname user {[-hex] username}

security-model {v1 | v2c | v3}

Syntax Description -hex (Optional) Keyword that displays the groupname and username in
hexadecimal format.
groupname Name of the SNMP group that defines an access control.
user Keyword that specifies the SNMP group user name.
username Name of the SNMP user.
security model Keyword that specifies security model v1, v2c, or v3.
v1 | v2c | v3

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you use special characters for groupname or username (nonprintable delimiters for these parameters),
you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:);
for example, 00:ab:34.

Examples This example shows how to clear the SNMP group from the vacmAccessTable:
Console> (enable) clear snmp group cisco-group user joe security-model v3
Cleared snmp group cisco-group user joe version v3.
Console> (enable)

Related Commands set snmp group

show snmp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-55
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear snmp notify

clear snmp notify

Use the clear snmp notify command to clear the SNMP notifyname in the SNMP Notify Table.

clear snmp notify [-hex] {notifyname}

Syntax Description -hex (Optional) Keyword that displays the notifyname in hexadecimal format.
notifyname A unique identifier to index the snmpNotifyTable.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you use special characters for notifyname (nonprintable delimiters for this parameter), you must use
a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example,
00:ab:34.

Examples This example shows how to clear an SNMP notifyname from the snmpNotifyTable:
Console> (enable) clear snmp notify joe
Cleared SNMP notify table joe.
Console> (enable)

Related Commands set snmp notify

show snmp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-56 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear snmp targetaddr

clear snmp targetaddr

Use the clear snmp targetaddr command to clear the SNMP target address entry in the
TargetAddressTable.

clear snmp targetaddr [-hex] {addrname}

Syntax Description -hex (Optional) Keyword that displays the addrname in hexadecimal format.
addrname An arbitrary but unique name of the target agent; the maximum length is
32 bytes.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you use special characters for addrname (nonprintable delimiters for this parameter), you must use a
hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example,
00:ab:34.

Examples This example shows how to clear an SNMP target address entry in the snmpTargetAddressTable:
Console> (enable) clear snmp targetaddr joe
Cleared SNMP targetaddr joe.
Console> (enable)

Related Commands set snmp targetaddr

show snmp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-57
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear snmp targetparams

clear snmp targetparams

Use the clear snmp targetparams command to clear the SNMP target parameters used in the
snmpTargetParamsTable.

clear snmp targetparams [-hex] {paramsname}

Syntax Description -hex (Optional) Keyword to display the paramsname in hexadecimal format.
paramsname Name of the target parameter in the snmpTargetParamsTable; the
maximum length is 32 bytes.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you use special characters for paramsname (nonprintable delimiters for this parameter), you must use
a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example,
00:ab:34.

Examples This example shows how to clear the SNMP target parameters in the snmpTargetParamsTable:
Console> (enable) clear snmp targetparams joe
Cleared SNMP targetparams table joe.
Console> (enable)

Related Commands set snmp targetparams

show snmp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-58 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear snmp trap

clear snmp trap

Use the clear snmp trap command to clear an entry from the SNMP trap receiver table.

clear snmp trap {rcvr_addr | all}

clear snmp trap rcvr_addr [port rcvr_port] [owner rcvr_owner] [index rcvr_index]

Syntax Description rcvr_addr IP address or IP alias of the trap receiver (the SNMP management
station) to clear, in dotted decimal notation, such as
101.102.103.104.
all Keyword that specifies every entry in the SNMP trap receiver table.
port rcvr_port (Optional) Keyword that specifies the UDP port and port number.
This value for rcvr_port can be from 0 to 65,535.
owner rcvr_owner (Optional) Keyword that identifies the user who configured the
settings for snmp trap. The rcvr_owner can be from 1 to 21
characters in length.
index rcvr_index (Optional) Keyword that identifies this entry. The rcvr_index is a
value from 1 to 65,535.

Defaults By default, there are no entries in the SNMP trap receiver table.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to clear an entry from the SNMP trap receiver table:
Console> (enable) clear snmp trap 192.168.255.255
SNMP trap receiver deleted.
Console> (enable)

Related Commands set snmp trap

show port counters
test snmp trap

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-59
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear snmp user

clear snmp user

Use the clear snmp user command to remove an SNMP user.

clear snmp user [-hex] {username} [remote {engineid}]

Syntax Description -hex (Optional) Keyword that displays the username in hexadecimal format.
username Name of the user on the host that connects to the agent.
remote engineid (Optional) Keyword and variable that specify the username on a remote
SNMP engine.

Defaults If a remote engine ID is not provided, the default local SNMP engine ID is used.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you use special characters for username (nonprintable delimiters for this parameter), you must use a
hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example,
00:ab:34.

Examples This example shows how to remove a user from an SNMP group:
Console> (enable) clear snmp user joe
Cleared SNMP user joe.
Console> (enable)

This example shows how to remove a user on a remote SNMP engine:

Console> (enable) clear snmp user joe remote 00:00:00:09:00:d0:00:4c:18:00
Cleared SNMP user.
Console> (enable)

Related Commands set snmp user

show snmp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-60 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear snmp view

clear snmp view

Use the clear snmp view command to remove the MIB viewname from the vacmViewTreeFamilyTable.

clear snmp view [-hex] {viewname} {subtree}

Syntax Description -hex (Optional) Keyword that displays the viewname in hexadecimal format.
viewname Name of a MIB view.
subtree Name of the subtree.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you use special characters for viewname (nonprintable delimiters for this parameter), you must use a
hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example,
00:ab:34.
A MIB subtree used in conjunction with a mask defines a view subtree that can be in OID format or a
text name mapped to a valid OID.

Examples This example shows how to clear the SNMP MIB viewname:
Console> (enable) clear snmp view myview 1.1.3
Cleared snmp view myview with subtree 1.1.3
Console> (enable)

Related Commands set snmp view

show snmp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-61
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear spantree portinstancecost

clear spantree portinstancecost

Use the clear spantree portinstancecost command to restore the default path cost to an instance on a
port.

clear spantree portinstancecost mod/port instances

Syntax Description mod/port Number of the module and the port on the module.
instances Number of the instance. Valid values are from 1 to 16.

Defaults The default path cost is based on port speed; see Table 2-1 for default settings.

Table 2-1 Default Port Cost—Short Mode

Port Speed Default Port Cost

4 Mb 250
10 Mb 100
16 Mb 62
100 Mb 19
155 Mb 14
1 Gb 4
10 Gb 2

Command Types Switch command.

Command Modes Privileged.

Examples These examples show how to restore the default path cost to an instance on a port:
Console> (enable) clear spantree portinstancecost 5/1 2
Port 5/1 mistp-instance 1-16 have path cost 200000.
Console> (enable)

Usage Guidelines This command is valid in MISTP mode only.

Related Commands set spantree portinstancecost

show spantree statistics

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-62 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear spantree portinstancepri

clear spantree portinstancepri

Use the clear spantree portinstancepri command to reset the spanning tree port instance priority.

clear spantree portinstancepri mod/port [instances]

Syntax Description mod/port Number of the module and the port on the module.
instances (Optional) Number of the instance. Valid values are from 1 to 16.

Defaults By default, the port priority is set to 0, with no instances specified.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines This command is valid in MISTP mode only.

Examples This example shows how to reset the spanning tree port instance priority:
Console> (enable) clear spantree portinstancepri 5/1 2
Port 5/1 instances 1-16 using portpri 32.
Console> (enable)

Related Commands set spantree portinstancepri

show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-63
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear spantree portvlancost

clear spantree portvlancost

Use the clear spantree portvlancost command to restore the default spanning tree port VLAN cost on
a port.

clear spantree portvlancost mod_num port_num preferred_vlans

Syntax Description mod_num Number of the module.

port_num Number of the port.
preferred_vlans List of VLANs for which to restore the default spanning tree port
VLAN cost. Valid values are 1 to 1005.

Defaults The default cost is based on the port speed; see Table 2-2 for default settings.

Table 2-2 Default Port Cost

Port Speed Default Port Cost

100 Kb 200,000,000
1 Mb 20,000,000
10 Mb 2,000,000
100 Mb 200,000
1 Gb 20,000
10 Gb 2,000
100 Gb 200
1 Tb 20
10 Tb 2

Command Types Switch command.

Command Modes Privileged.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-64 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear spantree portvlancost

Examples This example shows how to restore the default spanning tree port VLAN cost for VLANs 1 through 10
on port 2/10:
Console> (enable) clear spantree portvlancost 2/10 1-10
Port 2/10 VLANs 11-21 have path cost 6
Port 2/10 VLANs 1-10,22-1000 have path cost 10.
Console> (enable)

Console> (enable) clear spantree portvlancost 2/10

Port 2/10 VLANs 1-1000 have path cost 10.
Console> (enable)

Related Commands set spantree portfast

show spantree statistics

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-65
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear spantree portvlanpri

clear spantree portvlanpri

Use the clear spantree portvlanpri command to restore the default spanning tree port VLAN priority
on a port.

clear spantree portvlanpri mod_num port_num vlans

clear spantree portvlanpri trcrf | trbrf

Syntax Description mod_num Number of the module.

port_num Number of the port on the module.
vlans List of VLANs for which to restore the default spanning tree port
VLAN priority. Valid values are 1 to 1005.
trcrf Keyword that specifies the TrCRF for which to clear the spanning
tree port VLAN priority.
trbrf Keyword that specifies the TrBRF for which to clear the spanning
tree port VLAN priority.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to restore the default spanning tree port VLAN priority for VLANs 23 to 40
on module 1 port 2:
Console> (enable) clear spantree portvlanpri 1/2 23-40
Port 1/2 vlans 3,6-20,23-1000 using portpri 32
Port 1/2 vlans 1-2,4-5,21-22 using portpri 30
Console> (enable)

Related Commands
show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-66 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear spantree root

clear spantree root

Use the clear spantree root command to restore the spanning tree bridge priority, hello time, maxage,
and forward delay on the switch to their default values.

clear spantree root vlans

Syntax Description vlans List of the VLANs for which to restore the spanning tree default
settings. Valid values are 1 to 1005.

Defaults The default bridge configurations are:

switch priority 32768

forward delay 15 seconds
hello time 2 seconds
maxage 20 seconds

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to restore the switch priority, forward delay, hello time, and maxage for VLANs
1 to 20 to their default values:
Console>(enable) clear spantree root 1-20
VLANs 1-20 bridge priority set to 32678.
VLANs 1-20 bridge hello time set to 2 seconds.
VLANs 1-20 bridge max aging time set to 20 seconds.
VLANs 1-20 bridge forward delay set to 15 seconds.

Related Commands set spantree root

show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-67
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear spantree statistics

clear spantree statistics

Use the clear spantree statistics command to clear the spanning tree statistics on a specified port
or VLAN.

clear spantree statistics mod_num port_num

clear spantree statistics vlan

Syntax Description mod_num Number of the module.

port_num Number of the port on the module.
vlan List of the VLAN numbers to clear.

Defaults This command has no defaults.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to clear the spanning tree statistics for VLAN 1:
Console>(enable) clear spantree statistics 1
Cleared all VLAN counters for VLAN 1
Statistics cleared for vlans 1
Console> (enable)

Related Commands show spantree statistics

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-68 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear spantree uplinkfast

clear spantree uplinkfast

Use the clear spantree uplinkfast command to disable UplinkFast and return the spanning tree bridge
priority, port priorities, and port costs to their default values.

clear spantree uplinkfast

Syntax Description This command has no arguments or keywords.

Defaults This command has no defaults.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines This command changes spanning tree port priorities and port costs, which might affect VLAN
load-balancing configurations.

Examples This example shows how to turn off the UplinkFast feature and return the spanning tree bridge priority,
port priorities, and port costs to their default values:
Console>(enable) clear spantree uplinkfast
This command will cause all portcosts, portvlancosts, and the
bridge priority on all vlans to be set to default.
Do you want to continue (y/n) [n]? y
VLANs 1-1005 bridge priority set to 32768.
The port cost of all bridge ports set to default value.
The portvlancost of all bridge ports set to default value.
uplinkfast disabled for bridge.
Console> (enable)

Related Commands set spantree uplinkfast

show spantree uplinkfast

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-69
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear tacacs key

clear tacacs key

Use the clear tacacs key command to remove the TACACS+ authentication and encryption server key.

clear tacacs key

Syntax Description This command has no arguments or keywords.

Defaults By default, the key value is NULL.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to clear the TACACS+ server key used for authentication and encryption:
Console> (enable) clear tacacs key
TACACS server key cleared.
Console> (enable)

Related Commands set tacacs key

show tacacs

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-70 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear tacacs server

clear tacacs server

Use the clear tacacs server command to remove a host from the list of TACACS+ servers.

clear tacacs server {ip_addr | all}

Syntax Description ip_addr IP address of the server to be removed from the list of TACACS+
servers.
all Keyword that specifies removal of all hosts from the list of
TACACS+ servers.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to remove a server from the list of TACACS+ servers:
Console> (enable) clear tacacs server 192.168.255.255
192.168.255.255 cleared from TACACS table
Console> (enable)

Related Commands show tacacs

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-71
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear timezone

clear timezone
Use the clear timezone command to return the time zone to its default, Coordinated Universal Time
(UTC).

clear timezone

Syntax Description This command has no arguments or keywords.

Defaults By default, the time zone is UTC.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The clear timezone command functions only when NTP is enabled. If you set the time manually and
NTP is disabled, the clear timezone command has no effect.

Examples This example shows how to clear the time zone:

Console> (enable) clear timezone
Timezone name and offset cleared.
Console> (enable)

Related Commands set timezone

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-72 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear top

clear top
Use the clear top command to terminate any TopN report processes that are running.

clear top {all | report_num}

Syntax Description all Keyword that terminates all nonpending TopN results.
report_num TopN report number to terminate. Valid values are 1 to 5.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The clear top all command will not kill any pending TopN reports. Only reports with a done status are
killed.
You can terminate TopN processes without the background option by pressing Ctrl-C in the same
Telnet or console session, or by entering the clear top [report_num] command from a separate Telnet or
console session. Use the show top background command to find out if the background option is used.
The prompt is not displayed before the TopN report is completely displayed. Other commands will be
blocked until the report has been displayed.

Examples This example shows how to stop the TopN process 1 from a console session or a Telnet session:
Console> (enable) clear top 1
Console> (enable) %MGMT-5-TOPN_TERMINATE:Report 1 terminated by Console//
Console> (enable)

Console> (enable) clear top 1

Console> (enable) %MGMT-5-TOPN_TERMINATE:Report 1 terminated by telnet/172.20.52.124//
Console> (enable)

This example shows how to stop all nonpending TopN report processes:
Console> (enable) clear top all
Console> (enable) %MGMT-5-TOPN_TERMINATE:Report 1 terminated by Console//
%MGMT-5-TOPN_TERMINATE:Report 2 terminated by Console//
%MGMT-5-TOPN_TERMINATE:Report 3terminated by Console//
Console> (enable)

Related Commands show top

show top report

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-73
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear trunk

clear trunk
Use the clear trunk command to restore a trunk port to its default trunk type and mode or to clear
specific VLANs from the allowed VLAN list for a trunk port.

clear trunk mod ports [vlans]

Syntax Description mod Number of the module.

ports Number of the ports on the module.
vlans (Optional) One or more VLANs to remove from the allowed VLAN list for
the trunk port. Valid values are 2 to 1005.

Defaults If you do not specify any VLANs, this command sets the mode to auto for ISL and IEEE 802.1Q trunk
ports. For more information about auto and off modes, see the set trunk command.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you specify VLANs, those VLANs are removed from the list of VLANs allowed on the trunk. Traffic
for the removed VLANs is not forwarded over the trunk port.
Default VLANs cannot be cleared from the allowed VLAN list on the trunk.
To add VLANs that you have removed, use the set trunk mod_num/port_num vlan_range command.

Examples This example shows how to clear VLANs 200 to 500 from the trunk port on port 2 of module 1:
Console> (enable) clear trunk 1/2 200-500
Removing Vlan(s) 200-500 from allowed list.
Port 1/2 allowed vlans modified to 1-199,501-1000.
Console> (enable)

This example shows how to clear the trunk on port 2 of module 1:

Console> (enable) clear trunk 1/2
Port(s) 1/2 trunk mode set to auto.
Port(s) 1/2 trunk type set to isl.
Console> (enable)

Related Commands set trunk

show trunk

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-74 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear vlan

clear vlan
Use the clear vlan command to delete an existing VLAN from a management domain.

clear vlan vlan

Syntax Description vlan Number of the VLAN. Valid values are 2 to 1000.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines Follow these guidelines for deleting VLANs:

• When you delete a normal-range Ethernet VLAN in VTP server mode, the VLAN is removed from
all switches in the same VTP domain.
• When you delete a normal-range VLAN in VTP transparent mode, the VLAN is deleted only on the
current switch.
• You can delete an extended-range VLAN only on the switch where it was created.

Caution When you clear a VLAN on a switch configured as a VTP server, the VLAN is deleted from the entire
VTP domain. Every switch in that VTP domain will delete the VLAN.

Caution When you clear a VLAN, all ports assigned to that VLAN become inactive. However, the VLAN port
assignments are retained until you move the ports to another VLAN. If the cleared VLAN is
reactivated, all ports still configured on that VLAN are also reactivated.

When you clear a private VLAN (primary, isolated, or community), the ports are set to inactive and are
not assigned to any VLAN. The private VLAN mappings for the selected VLAN are also cleared. ACL
to VLAN mappings are also deleted.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-75
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear vlan

Examples This example shows how to clear an existing VLAN (VLAN 4) from a management domain:
Console> (enable) clear vlan 4
This command will deactivate all ports on vlan 4
in the entire management domain
Do you want to continue(y/n) [n]? y
VLAN 4 deleted
Console> (enable)

Related Commands set vlan

show vlan

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-76 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear vlan mapping

clear vlan mapping

Use the clear vlan mapping command to delete existing 802.1Q VLAN to ISL VLAN mapped pairs.

clear vlan mapping dot1q {1q_vlan_num | all}

Syntax Description dot1q Keyword that specifies the 802.1Q VLAN.

1q_vlan_num Number identifying the 802.1Q VLAN from
which to remove the mapping.
all Keyword that specifies to clear the mapping table
of all entries.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to clear an existing mapped 802.1Q VLAN (VLAN 1044) from the
mapping table:
Console> (enable) clear vlan mapping dot1q 1044
Vlan Mapping 1044 Deleted.
Console> (enable)

This example shows how to clear all mapped 802.1Q VLANs from the mapping table:
Console> (enable) clear vlan mapping dot1q all
All Vlan Mapping Deleted.
Console> (enable)

Related Commands set vlan mapping

show vlan

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-77
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear vmps rcp

clear vmps rcp

Use the clear vmps rcp command to delete a VMPS RCP username from the VMPS server table.

clear vmps rcp username

Syntax Description username Username up to 14 characters long.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you do not enter a username, all RCP usernames are deleted.

Examples This example shows how to clear the VMPS RCP username jdoe from the VMPS server table:
Console> (enable) clear vmps rcp jdoe
Console> (enable)

Related Commands set rcp username

show rcp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-78 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear vmps statistics

clear vmps statistics

Use the clear vmps statistics command to delete existing VMPS client statistics.

clear vmps statistics

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to delete existing VMPS statistics:

Console> (enable) clear vmps statistics
VMPS and dynamic vlan statistics cleared.
Console> (enable)

Related Commands show vmps statistics

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-79
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear vtp pruning

clear vtp pruning

Use the clear vtp pruning command to specify the VLANs in the VTP domain that are ineligible for
pruning.

clear vtp pruning vlan_num

Syntax Description vlan_num Number of VLANs to be made ineligible for pruning. Valid values
are 1 to 1005.

Defaults By default, VLANs 2 to 1000 are eligible for pruning.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines VTP pruning prevents traffic in each pruning-eligible VLAN from being transmitted on a VLAN trunk
if no stations belonging to that VLAN are located across that trunk. Use the set vtp command to enable
VTP pruning.
Use the set vtp pruning command to make the VLANs eligible for pruning again.

Examples This example shows how to make VLANs 200 to 500 ineligible for pruning:
Console> (enable) clear vtp pruning 200-500
Vlans 1,200-500,1001-1005 will not be pruned on this device.
VTP domain Company modified.
Console> (enable)

Related Commands set vtp

show vtp statistics

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-80 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear vtp statistics

clear vtp statistics

Use the clear vtp statistics command to delete the VTP statistics.

clear vtp statistics

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to clear the VTP statistics:

Console> (enable) clear vtp statistics
vtp statistics cleared.
Console> (enable)

Related Commands set vtp

show vtp statistics

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-81
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
configure

configure
Use the configure command to download a configuration file from a host and execute each command in
that file.

configure host file [rcp]

Syntax Description host IP address or IP alias of the host.

file Name of the configuration file.
rcp (Optional) Keyword that specifies rcp as file transfer method.

Defaults By default, the file transfer method is TFTP.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines Refer to the Software Configuration Guide–Catalyst 4000 Family, 2948G, and 2980G Switches for
information on how to construct a configuration file to download using the configure command.

Examples The following is a sample configuration file. Each line contains a command, except for the lines that
begin with ! or #. On some servers (NT), the TFTP directory might not be /tftpboot.
begin
show time
set ip alias conc7 198.133.219.207
set ip alias montreux 198.133.119.42
set ip alias cres 192.122.174.42
set prompt system5>
set password
# empty string old password

pingpong
pingpong
end
#

This example shows how to configure the switch using a configuration file downloaded from a TFTP
server:
Console> (enable) configure 192.122.174.42 system5.cfg
Configure using system5.cfg from 192.122.174.42 (y/n) [n]? y
/
Done. Finished Network Download. (446 bytes)
>> show time
Wed Nov 11 1998, 17:42:50
>> set ip alias conc7 198.133.219.207
IP alias added.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-82 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
configure

>> set ip alias montreux 198.133.219.40

IP alias added.
>> set ip alias cres 192.122.174.42
IP alias added.
>> set prompt system5>
>> set password
Enter old password:
Enter new password: pingpong
Retype new password: pingpong
Password changed.

Related Commands copy

show config

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-83
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
confreg

confreg
Use the confreg command to set the configuration register value or to modify the configuration register
using the configuration register utility.

confreg [hexvalue]

Syntax Description hexvalue (Optional) Hexadecimal value of the configuration register.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Usage Guidelines If you specify hexvalue, the confreg command changes the configuration register value to the
hexadecimal value specified.
If you do not specify hexvalue, confreg shows the current configuration register values and prompts you
to keep or change the current values.
The new configuration register value is written into NVRAM and does not take effect until you reset or
power cycle the switch.

Examples This example shows how to use the confreg command:

rommon 1 > confreg

Configuration Summary
enabled are:
console baud:9600
boot:the ROM Monitor

do you wish to change the configuration? y/n [n]: y

enable "diagnostic mode"? y/n [n]:<Return>
enable "use net in IP bcast address"? y/n [n]:<Return>
enable "load rom after netboot fails"? y/n [n]:<Return>
enable "use all zero broadcast"? y/n [n]:<Return>
enable "break/abort has effect"? y/n [n]:<Return>
enable "ignore system config info"? y/n [n]:<Return>
change console baud rate? y/n [n]:<Return>
change the boot characteristics? y/n [n]: y
enter to boot:
0 = ROM Monitor
1 = the boot helper image
2-15 = boot system
[0]: 2

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-84 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
confreg

Configuration Summary
enabled are:
console baud:9600
boot:image specified by the boot system commands
or default to:cisco2-Presto

do you wish to change the configuration? y/n [n]:<Return>

You must reset or power cycle for new config to take effect
rommon 2 >

Related Commands sync

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-85
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
copy

copy
Use the copy command set to upload or download a Flash image or a switch configuration to or from a
Flash device, rcp server, or TFTP server.

copy file-id {config | flash | rcp | tftp}

copy config {file-id | flash | rcp| tftp} [all]
copy tftp {file-id | flash | config}
copy rcp {file-id | flash | config}
copy flash {file-id | tftp | rcp | config}

Syntax Description file-id The file on which to perform the copy action, where file-id is in the format
[[m/]device:][filename].
m/ = The module where the Flash device is located (such as the standby
supervisor engine, an FDDI module, or an ATM module). Module 1 is
assumed if a different module is not specified.
device: = Device where the file is located. Valid Flash devices are
bootflash:, slot0:, and slot1:. You can also specify tftp: as the device name.
The colon (:) is required after the device name.
filename = Name of the system image or configuration file.
tftp Keyword that specifies that the file will be copied to or from a TFTP server.
rcp Keyword that specifies that the file will be copied to or from an rcp server.
flash Keyword that specifies that the file will be copied to or from the Flash file
system.
config Keyword that specifies that the switch configuration file will be copied to
the specified file, or that the specified file will be used to configure the
switch.
all (Optional) Keyword that specifies the entire configuration be copied to the
specified destination configuration file. If you do not use the all keyword,
only nondefault commands are copied to the destination configuration file.

Defaults If a source or destination Flash device is not specified, the default Flash device (specified by the cd
command) is used. Use the pwd command to display the current default Flash device. If the destination
filename is omitted, the system uses the source filename.
When you define a system name using the set system name command, the system stores image and
configuration files in the sysname.cfg file; otherwise, it uses the default myswitch.cfg file.
If you do not specify a module in the file-id, module 1 is assumed.

Command Types Switch command.

Command Modes Privileged.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-86 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
copy

Usage Guidelines The Catalyst 4000 family switches support only the bootflash: Flash device.
If you use the flash keyword as the copy source or destination, you are prompted for the Flash device
name. If you are copying a software image to multiple intelligent switching modules of the same type,
use the flash keyword as the copy destination. The switch automatically determines which modules to
copy the image to based on the header in the source image file. If you want to copy a software image to
a single intelligent switching module in a switch with multiple modules of the same type, you must
specify the destination file-id as m/bootflash: (do not specify a filename).

Examples This example shows how to upload the non-default switch configuration to a file named cat.cfg on the
slot0: Flash device:
Console> (enable) copy config slot0:cat.cfg
Upload configuration to slot0:cat.cfg
649324 bytes available on device slot0, proceed (y/n) [n]? y
.........
/
Configuration has been copied successfully. (10200 bytes)
Console> (enable)

This example shows how to upload both the default and non-default switch configuration to a file named
lab2.cfg on a TFTP server:
Console> (enable) copy config tftp:lab2.cfg all
IP address or name of remote host [172.20.22.7]? y
Upload configuration to imgFile:lab2.cfg (y/n) [n]? y
.........
/
Configuration has been copied successfully. (10299 bytes).
Console> (enable)

This example shows how to upload the non-default switch configuration to the cat.cfg file on the slot1:
Flash device:
Console> (enable) copy config flash
Flash device [bootflash]? slot1:
Name of file to copy to [configFile]? cat.cfg
Upload configuration to slot1:cat.cfg
749124 bytes available on device slot1, proceed (y/n) [n]? y
.........
/
Configuration has been copied successfully. (200345 bytes).
Console> (enable)

This example shows how to upload an image from a remote host into Flash using rcp:
Console> (enable) copy rcp flash
IP address or name of remote host []? 172.20.52.3
Name of file to copy from []? cat5000-sup3.4-2-1.bin
Flash device [bootflash]?
Name of file to copy to [cat5000-sup3.4-2-1.bin]?

4369664 bytes available on device bootflash, proceed (y/n) [n]? y

CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
File has been copied successfully.
Console> (enable)

This example shows how to upload the running configuration on a Catalyst 4000 family, Catalyst 2948G,
or Catalyst 2980G switch to an rcp server for storage:
Console> (enable) copy config rcp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-87
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
copy

IP address or name of remote host []? 172.20.52.3

Name of file to copy to []? cat5000_config.cfg

Upload configuration to rcp:cat5000_config.cfg, (y/n) [n]? y

.....
/
Configuration has been copied successfully.
Console> (enable)

This example shows how to configure a switch using a configuration file downloaded from an rcp server:
Console> (enable) copy rcp config
IP address or name of remote host []? 172.20.52.3
Name of file to copy from []? dns-config.cfg

Configure using rcp:dns-config.cfg (y/n) [n]? y

/
Finished network download. (134 bytes)
>>
>> set ip dns server 172.16.10.70 primary
172.16.10.70 added to DNS server table as primary server.
>> set ip dns server 172.16.10.140
172.16.10.140 added to DNS server table as backup server.
>> set ip dns enable
DNS is enabled
>> set ip dns domain corp.com
Default DNS domain name set to corp.com
Console> (enable)

This example shows how to configure the switch using a configuration file on a Flash device:
Console> (enable) copy flash config
Flash device [bootflash]?
Name of configuration file? test.cfg
Configure using bootflash:test.cfg (y/n) [n]? y
/
Finished download. (10900 bytes)
>> set password $1$FMFQ$HfZR5DUszVHIRhrz4h6V70
Password changed.
>> set enablepass $1$FMFQ$HfZR5DUszVHIRhrz4h6V70
Password changed.
>> set prompt Console>
>> set length 24 default
Screen length set to 24.
>> set logout 20
.....
Console> (enable)

This example shows how to copy a file from a TFTP server to a Flash device:
Console> (enable) copy tftp bootflash:
Address or name of remote host [172.20.22.7]?
Enter source file name [cat4000-sup.4-5-1.bin]?
Enter destination file name [cat4000-sup.4-5-1.bin]?
6942528 bytes available in flash, proceed (y/n) [n]?y
Console> (enable)

Related Commands configure

write

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-88 78-12648-03
 2
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
del

del
Use the del command to delete files.

del device:filename

Syntax Description device: Name of the device.

filename Name of the system image or configuration file.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Usage Guidelines The Catalyst 4000 family, 2948G, and 2980G switches support only the bootflash: Flash device.
A file cannot be undeleted if a valid file with the same name exists. Instead, you must delete the existing
one first and then undelete the desired file. A file can be deleted or undeleted up to 15 times. To
permanently remove all deleted files on a device, use the squeeze command. You need to use the squeeze
command to reclaim the space used by the deleted file.

Examples This example shows how to delete a file:

rommon 1 > del bootflash:cat4000.6-1-1.bin
rommon 2 >

Related Commands squeeze—ROM monitor

undelete—ROM monitor

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-89
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
delete

delete
Use the delete command to delete a file on a Flash device.

delete [file-id]

Syntax Description file-id The file to delete, where file-id is in the format [[m/]device:][filename].
m/ = The module where the Flash device is located (such as the standby
supervisor engine, an FDDI module, or an ATM module). Module 1 is assumed
if no module is specified.
device: = Device where the file is located. Valid Flash devices are bootflash:,
slot0:, and slot1:. The colon (:) is required after the device name.
filename = Name of the system image or configuration file.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The Catalyst 4000 family, 2948G, and 2980G switches support only the bootflash: Flash device:
Use the undelete (switch) command to recover a deleted file.
A file cannot be undeleted if a valid file with the same name exists. Instead, you must delete the existing
one first and then undelete the desired file. A file can be deleted or undeleted up to 15 times. To
permanently remove all deleted files on a device, use the squeeze (switch) command.

Examples This example shows how to delete a file from a Flash device:
Console> (enable) delete bootflash:switch_config.cfg
Console> (enable)

Related Commands dir—switch

show flash
squeeze—switch
undelete—switch

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-90 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
dir—ROM monitor

dir—ROM monitor
Use the dir command to list the files on a Flash device.

dir device

Syntax Description device Name of the Flash device.

Defaults This command has no defaults.

Command Types ROM monitor command.

Command Modes Normal.

Examples This example shows how to list the files on a Flash device:
rommon 6 > dir bootflash:
File size Checksum File name
14086 bytes (0x3706) 0xa6a84c93 switch_config.cfg (deleted)
5415 bytes (0x1527) 0x53bbccda 5509_config.cfg
446464 bytes (0x6d000) 0x8503219d cat5000-sup3.5-1-1.bin (deleted)
4231861 bytes (0x4092b5) 0x1d6092f4 cat5000-sup3.5-2-1.bin
rommon 7 >

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-91
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
dir—switch

dir—switch
Use the dir command to display a list of files on a Flash device.

dir file-id [all | deleted | long]

Syntax Description file-id The file on which to perform the copy action, where file-id is of the
format [[m/]device:][filename].
m/ = The module where the Flash device is located (such as the
standby supervisor engine, an FDDI module, or an ATM module).
Module 1 is assumed if no module is specified.
device: = Device where the file is located. Valid Flash devices are
bootflash:, slot0:, and slot1:. You can also specify tftp: as the
device name. The colon (:) is required after the device name.
filename = Name of the system image or configuration file.
all (Optional) Keyword that specifies to display all files on the device,
including deleted files.
deleted (Optional) Keyword that specifies to display only deleted files.
long (Optional) Keyword that specifies to display files that have not
been deleted, in long format.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal and privileged.

Usage Guidelines When you omit all keywords (all, deleted, or long), the system displays file information in short format.
Table 2-3 explains the short format output.

Table 2-3 Short Format File Information

Column Heading Description

# File index number
length File length
date/time Date and time the file was created
name Filename

When you use one of the keywords, the system displays file information in long format.
Table 2-4 explains the long format output.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-92 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
dir—switch

Table 2-4 Long Format File Information

Column Heading Description

# File index number
ED Letter to indicate whether the file contains an error (E) or is
deleted (D)
type File type (1 = configuration file, 2 = image file); when the file
type is unknown, the system displays a zero or FFFFFFFF in this
field
crc File cyclic redundancy check
seek Offset into the file system of the next file
nlen Filename length
length File length
date/time Date and time the file was created
name Filename

Examples This example shows how to display the file information in short format:
Console> (enable) dir
-#- -length- -----date/time------ name
2 3761580 Jun 14 2000 14:16:05 cat4000.6-1-0-104-ORL.bin
3 3773884 Jul 10 2000 09:06:25 cat4000.6-1-0-126-ORL.bin

21040 bytes available (11382224 bytes used)

Console> (enable)

This example shows how to display the file information in long format:
Console> (enable) dir long
-#- ED --type-- --crc--- -seek-- nlen -length- -----date/time------ name
2 .. ffffffff d69fff2c 781794 25 3761580 Jun 14 2000 14:16:05 cat4000.6-1-0-104-ORL.bin
3 .. ffffffff d3b83f6b b1add0 25 3773884 Jul 10 2000 09:06:25 cat4000.6-1-0-126-ORL.bin

21040 bytes available (11382224 bytes used)

Console> (enable)

This example shows the file with index number 1 deleted:

Console> (enable) dir all
-#- ED --type-- --crc--- -seek-- nlen -length- -----date/time------ name
1 .D ffffffff 9be31a86 3eb168 28 3846376 Jun 14 2000 14:13:10 cat4000-k4.6-1-0-104-ORL.bin
2 .. ffffffff d69fff2c 781794 25 3761580 Jun 14 2000 14:16:05 cat4000.6-1-0-104-ORL.bin
3 .. ffffffff d3b83f6b b1add0 25 3773884 Jul 10 2000 09:06:25 cat4000.6-1-0-126-ORL.bin

21040 bytes available (11382224 bytes used)

Console> (enable)

Related Commands show flash

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-93
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
disable

disable
Use the disable command to return to normal mode from privileged mode.

disable

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to return to normal mode:

Console> (enable) disable
Console>

Related Commands enable

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-94 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
disconnect

disconnect
Use the disconnect command to close an active console port or Telnet session.

disconnect {ip_addr | console}

Syntax Description ip_addr Source IP address or IP alias of the session to disconnect; in dot
notation, for example, 101.102.103.104.
console Keyword that specifies to clear an active session on the console port.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If multiple sessions from the same IP address exist, the system checks if the current session originated
from the specified IP address. If the session did not originate from the specified IP address, all Telnet
sessions from the address are disconnected. If the session does originate from the specified address, all
sessions, other than the current session, are disconnected. The system prompts whether to disconnect the
current Telnet session. You can answer n and remain connected or answer y and be disconnected.

Examples This example shows how to close a Telnet session to host 192.168.255.255 (the 1 in parenthesis indicates
the number of active sessions disconnected):
Console> (enable) disconnect 192.168.255.255
Telnet session from 192.168.255.255 disconnected. (1)
Console> (enable)

This example shows how to close the current console session:

Console> (enable) disconnect console
Console session disconnected.
Console> (enable)

Related Commands telnet

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-95
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
download

download
Use the download command to copy a software image from a specified host to the Flash memory of the
supervisor engine or a designated module.

download host file [mod_num] [rcp]

download serial [mod_num]

Syntax Description host Name or IP address of the host.

file Name of the file to be downloaded.
mod_num (Optional) Number of the module to receive the downloaded image.
rcp (Optional) Keyword that specifies to copy an image from a specified
host to Flash memory using rcp.
serial Keyword that specifies to download through the serial (console)
port.

Defaults If a module number is not specified, the image is downloaded to all modules for which the image
is valid.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The Catalyst 4000 family switches download new code to the processors using Kermit serial download
through the EIA/TIA-232 console port.
The download command downloads code to the Flash memory. Catalyst 4000 family switch software
rejects an image if it is not a valid image for the module.
The download serial command uses Kermit through the serial EIA/TIA-232 console port. The
download serial command is not allowed from a Telnet session.
If you specify the module number, the download goes to the specified module, but the download will fail
if the module is of a different type than is indicated by the download header. If you do not specify the
module number, the download goes to all modules of that type.

Note You can use the download command as part of a minimal downtime software upgrade. For complete
information on performing a minimal downtime software upgrade, refer to the Software
Configuration Guide for your switch.

The download serial command uses the Kermit protocol through the serial EIA/TIA-232 console port.
The download serial command is not allowed from a console session (the console port must be available
for the serial download).

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-96 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
download

Caution After starting the serial download using Kermit, do not attempt to abort the serial download by
pressing Ctrl-C. Pressing Ctrl-C interrupts the download process and might leave the switch in a
problematic state. If this occurs, reboot the switch.

Examples This example shows how to download a file named cat4000.6-1-2.bin from host called mercury to the
supervisor engine module (by default):
Console> (enable) download mercury cat4000.6-1-2.bin
Download image cat4000.6-1-2.bin from mercury to module 1FLASH (y/n) [n]? y
\
Finished network single module download. (2418396 bytes)
FLASH on Catalyst:

Type Address Location

Intel 28F008 20000000 NMP (P3) 4MB SIM

Erasing flash sector...done.

Programming flash sector...done.
Erasing flash sector...done.
Programming flash sector...done.
The system needs to be reset to run the new image.
Console> (enable)

This sample session shows how to connect to a remote terminal from a workstation and how to use the
download serial command to copy a software image to the supervisor engine module:
[At local workstation]
host% kermit
C-Kermit 5A(172) ALPHA, 30 Jun 95, SUNOS 4.0 (BSD)
Type ? or ’help’ for help
C-Kermit> set line /dev/ttyb
C-Kermit> c
Connecting to /dev/ttyb, speed 9600.
The escape character is ^ (ASCII 28).
Type the escape character followed by C to get back,
or followed by ? to see other options.

Console> enable
Enter Password:
Console> (enable) set system baud 19200
^\C
[Back at local workstation]
C-Kermit> set speed 19200
/dev/ttyb, 19200 bps
C-Kermit> c
Connecting to /dev/ttyb, speed 19200.
The escape character is ^ (ASCII 28).
Type the escape character followed by C to get back,
or followed by ? to see other options.

Console> (enable) download serial

Download Supervisor image via console port (y/n) [n]? y

Concentrator Boot ROM (Ver 1.00)

Waiting for DOWNLOAD!!

Return to your local Machine by typing its escape sequence
Issue Kermit send command from there[ Send ‘Filename‘]

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-97
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
download

^\C
[Back at Local System]
C-Kermit> send c4000_xx.bin
SF
c5000_xx.bin => C4000_XX.BIN, Size: 1233266

X to cancel file, CR to resend current packet

Z to cancel group, A for status report
E to send Error packet, Ctrl-C to quit immediately:...................................
......................................................................................
...... [OK]
ZB
C-Kermit> quit
host%

Related Commands reset—switch

show flash
upload

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-98 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
enable

enable
Use the enable command to activate privileged mode. In privileged mode, additional commands are
available, and certain commands display additional information.

enable

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines The (enable) in the prompt indicates that privileged commands can be entered.

Examples This example shows how to enter privileged mode:

Console> enable
Enter password:
Console> (enable)

Related Commands disable

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-99
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
format

format
Use the format command to format a Flash device. Flash PC cards must be formatted before they can
be used.

format [spare spare_num m/] {device1:} [device2: monlib_filename]

Syntax Description spare spare_num (Optional) Number of spare sectors to reserve for use if other
sectors fail. Valid values are 0 to 16.
m/ (Optional) Module number of the supervisor engine containing the
Flash device.
device1: Flash device to be formatted. A colon (:) is required after the
specified device.
device2: (Optional) Flash device that contains the monlib file to be used to
format device1:. A colon (:) is required after the specified device.
monlib_filename (Optional) Name of the monlib file to be used to format device1:.

Defaults The default number of spare sectors is 0.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You can reserve up to 16 spare sectors for use when other sectors fail. If you do not reserve spare sectors
and later some sectors on the device fail, you will have to reformat the entire Flash device, which will
erase all existing data.
The monlib file is the ROM monitor library used by the ROM monitor to access files in the Flash file
system. The file is also compiled into the system image. In the command syntax, device1: is the device
to format and device2: contains the monlib file to use.
When you omit the [device2:][monlib_filename]] argument, the system formats device1: using the
monlib that is bundled with the system software.
When you omit device2: from the [[device2:][monlib_filename]] argument, the system formats device1:
using the named monlib file from the default Flash device (specified by the cd command).
When you omit monlib_filename from the [[device2:][monlib_filename]] argument, the system formats
device1: using the monlib file from device2:. When you specify the whole [[device2:][monlib_filename]]
argument, the system formats device1: using the specified monlib file from the specified device.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-100 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
format

You can also specify device1:monlib_filename as the device and filename to be used, as follows:

format device1: [device1: [monlib_filename]]

If monlib_filename is omitted, the system formats device1: using the built-in monlib file on the device.

Note When the system cannot find a monlib file, the system terminates the formatting process.

Examples This example shows how to format a Flash device (Flash PC card in slot 1):
Console> (enable) format slot1:
All sectors will be erased, proceed (y/n) [n]?y
Enter volume id (up to 31 characters):
Formatting sector 1
Format device slot1 completed.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-101
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
help—ROM monitor

help—ROM monitor
Use the help command to display a listing of commands you can use to set switch features.

help

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Examples This example shows how to display the commands list:

rommon 1 > help
alias set and display aliases command
dir list files in file system
del delete a file
undelete undelete a file
squeeze remove deleted files
history monitor command history
repeat repeat a monitor command
boot boot an image from flash/network
clear clear configurations, use 'clear help' for more info
help print list of available commands
ping ping an ip addr
reset restart the system
set show/set environment vars, use 'set help' for more info
show show config parameters, use 'show help' for more info
sprom display sprom contents
version display version info
rommon 2 >

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-102 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
history—ROM monitor

history—ROM monitor
Use the history command to display the command history (the last 16 commands executed in the ROM
monitor environment).

history

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Usage Guidelines For convenience you can use the alias h for this command.

Examples This example shows how to display the command history:

rommon 13 > history

1 help
2 break -s 0x20090
3 break -s 10090
4 break -s 0xa0001000
5 cont
6 help
7 dev
8 dir
9 dir bootflash:
10 dis
11 dis 0xa0001000
12 dis 0xbe000000
13 history
=============================================================================

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-103
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
history—switch

history—switch
Use the history command to show the contents of the command history buffer.

history

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines The history buffer size is fixed at 20 commands. Refer to the “Command-Line Interface” chapter for
detailed information about the command history feature.

Examples This example shows how to display the command history and execute the second entry in the command
history buffer:
Console> history
1 help
2 history
Console> !2
history
1 help
2 history
3 history
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-104 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
l2trace

l2trace
Use the l2trace command to display the Layer 2 path taken by the packets that start at a specified source
address and end at a specified destination address.

l2trace src_mac_addr dest_mac_addr [vlan] [detail]

l2trace src_ip_addr dest_ip_addr [detail]

Syntax Description src_mac_addr Source MAC address.

dest_mac_addr Destination MAC address.
vlan (Optional) Number of the VLAN.
detail (Optional) Keyword that specifies to provide detailed information.
src_ip_addr Source IP address or alias.
dest_ip_addr Destination IP address or alias.

Defaults This command has no default settings.

Command Types Switch command.

Command Types Privileged.

Usage Guidelines All the intermediate devices should be Catalyst 4000, Catalyst 5000, or Catalyst 6000 family switches
running Supervisor Engine software release 6.1 or later.
The l2trace command displays the Layer 2 path when the specified source and destination addresses
belong to the same VLAN. If you specify source and destination address which belong to different
VLANs, l2trace aborts with an error message.
You must enable CDP on all the Catalyst 4000, 5000, or 6000 family switches in the network.
When the switch detects a device in the Layer 2 path that does not belong to the Catalyst 4000,
Catalyst 5000, or Catalyst 6000 family switch, the switch continues to send Layer 2 trace queries and
lets them time out.
This command is rejected if you enter a multicast source or destination MAC address.
If a source or destination address belongs to multiple VLANs, you must specify the VLAN to be used for
determining the Layer 2 path.
The Layer 2 trace feature is not supported when multiple devices are attached to one port via hubs (for
example, when multiple CDP neighbors are detected on a port). When more than one CDP neighbor is
detected on the port, l2trace is aborted.
If you specify the IP address of the source and destination systems instead of the MAC addresses, the switch
looks at the ARP table to determine the IP-address-to-MAC-address mapping of the source and destination
systems. If an ARP entry exists for the specified IP address, the corresponding MAC address is used. If no

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-105
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
l2trace

matching ARP entry exists, the system does an ARP query and tries to resolve the IP address. If this is the
case, a restriction is imposed that requires the source and destination systems to be in the same subnet as the
switch in order for the ARP query to be resolved.

Examples This example shows how to display the Layer 2 packet path for the specified source and destination MAC
addresses:
Console> (enable) l2trace 00-01-22-33-44-55 10-22-33-44-55-66 detail
l2trace vlan number is 10.

00-01-22-33-44-55 found in C5500 named wiring-1 on port 4/1 10Mb half duplex
C5500: wiring-1: 192.168.242.10: 4/1 10Mb half duplex -> 5/2 100MB full duplex
C5000: backup-wiring-1: 192.168.242.20: 1/1 100Mb full duplex -> 3/1-4 FEC attached
C5000: backup-core-1: 192.168.242.30: 4/1-4 FEC attached -> 1/1-2 GEC attached
C6000: core-1: 192.168.242.40: 1/1-2 GEC attached -> 2/1 10MB half duplex.
10-22-33-44-55-66 found in C6000 named core-1 on port 2/1 10MB half duplex.
Console> (enable)

This example shows how to display the Layer 2 packet path for the specified source and destination IP
aliases:
Console> (enable) l2trace user-1-pc user-2-pc detail
Mapping IP address to MAC Address
user-1-pc -> 00-01-22-33-44-55
user-2-pc -> 10-22-33-44-55-66
l2trace vlan number is 10

00-01-22-33-44-55 found in C5500 named wiring-1 on port 4/1 10Mb half duplex
C5500: wiring-1: 192.168.242.10: 4/1 10Mb half duplex -> 5/2 100MB full duplex
C5000: backup-wiring-1: 192.168.242.20: 1/1 100Mb full duplex -> 3/1-4 FEC attached
C5000: backup-core-1: 192.168.242.30: 4/1-4 FEC attached -> 1/1-2 GEC attached
C6000: core-1: 192.168.242.40: 1/1-2 GEC attached -> 2/1 10MB half duplex.
10-22-33-44-55-66 found in C6000 named core-1 on port 2/1 10MB half duplex.
Console> (enable)

This example shows how to display a summary of Layer 2 packet path information for the specified
source and destination MAC addresses:
Console> (enable) l2trace 00-01-22-33-44-55 10-22-33-44-55-66
Starting L2 Trace
sc0 :9.7.0.7 : 3/7
4/16 :9.7.0.2 : 4/10
Console> (enable)

This example show how to display a summary of Layer 2 packet path information for the specified source
and destination IP addresses:
Console> (enable) l2trace 9.7.0.7 9.7.0.6
Starting L2 Trace
sc0 :9.7.0.7 : 3/7
4/16 :9.7.0.2 : 4/10
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-106 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
meminfo

meminfo
Use the meminfo command to display information about the main memory, packet memory, and
NVRAM.

meminfo [-l]

Syntax Description -l (Optional) Keyword that specifies to use the long listing, which
displays the supported DRAM configurations.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Usage Guidelines The hyphen (-) is required with the -l option.

Examples This example shows how to use the meminfo command:

rommon 9 > meminfo

Main memory size: 16 MB in 32 bit mode.

Available main memory starts at 0xa000e000, size 16328KB
IO (packet) memory size: 25 percent of main memory.
NVRAM size: 32KB

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-107
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
ping—ROM monitor

ping—ROM monitor
Use the ping command to send ICMP echo-request packets to another node on the network.

ping host

Syntax Description host IP address of the host.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Usage Guidelines You must enter the IP address of the node because ROM monitor does not support DNS name resolution.

Examples This example shows how to ping 10.1.1.1:

rommon 1 > ping 10.1.1.1
10.1.1.1 is alive
rommon 2 >

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-108 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
ping—switch

ping—switch
Use the ping command set to send ICMP echo-request packets to another node on the network. You can
also use the ping command without arguments to configure ping.

ping -s host

ping -s host [packet_size] [packet_count]

Syntax Description -s Keyword that specifies for the ping command to send one datagram per
second, printing one line of output for every response received.
host IP address or IP alias of the host.
packet_size (Optional) Number of bytes in a packet, from 56 to 1472 bytes.
packet_count (Optional) Number of packets to send. Valid values are from 0 to
2,147,483,647.

Defaults The defaults for ping -s are:

• packet_size is 56 bytes
• packet_count is 2,147,483,647
The defaults for ping with no arguments after the host are:
• packet_size is 56 bytes
• packet_count is 5
• Wait time is 2 seconds
• Target IP address is none (this is a mandatory field)
• Source address is the host IP address

Command Types Switch command.

Command Modes Normal. Privileged to configure ping.

Usage Guidelines The following are general ping command guidelines:

• A hyphen (-) is required with the -s option.
• Pinging stops when you press Ctrl-C.
• A continuous ping occurs when packets are generated continuously and are dispatched to the host
unless you press Ctrl-C to stop pinging.
• Because the switch adds header information, the actual packet size is 8 bytes larger than the size you
specify.
• Normal response—The normal response occurs in 1 to 10 seconds, depending on network traffic.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-109
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
ping—switch

The following guidelines are for the ping -s command:

• The maximum waiting time before timing out is 2 seconds.
• A new ping packet is generated after one second of sending the previous packet, regardless of
whether an echo-reply is received or not.
• A continuous ping occurs if you do not enter a packet count.
• Network or host unreachable—The switch found no corresponding entry in the route table.
• Destination does not respond—If the host does not respond, a “no answer from host” appears in
2 seconds.
• Destination unreachable—This destination gateway indicates that the destination is unreachable.
The following guidelines are for the ping command without arguments beyond the IP address:
• The ping ip_address command is accepted in normal mode only. The parameters take the default
values automatically.
• The target IP address is a mandatory field to be entered.
• The maximum waiting time is configurable.
• A new ping packet is generated only when a echo-reply is received.
• A continuous ping occurs if you enter a packet count of 0.
• Output returns only when a response is received or you press Return. This is available in privileged
mode only.
• When configuring ping, you must either press Return or enter a response. Valid responses and
appropriate values are as follows:
– Target IP address—IP address or host name of the destination node you plan to ping.
– Number of Packets—Number of ping packets to be sent to the destination address. Valid values
are from 0 to 2,147,483,647 (0 specifies continuous ping).
– Datagram size—Size of the ping packet. Valid values are from 56 to 1472 bytes.
– Timeout in seconds—Timeout interval. Valid values are from 0 to 3600 seconds.
– Source IP Address [(default)]—IP address or IP alias of the source.
This example shows how to ping a host with IP alias elvis a single time:
Console> ping elvis
!!!!!

-----172.20.52.19 PING Statistics------

5 packets transmitted, 5 packets received, 0% packet loss
round-trip (ms) min/avg/max = 1/1/1
Console>

This example shows how to ping a host with the IP alias elvis once per second until you press Ctrl-C to
stop pinging:
Console> ping -s elvis
ping elvis: 56 data bytes
64 bytes from elvis: icmp_seq=0. time=11 ms
64 bytes from elvis: icmp_seq=1. time=8 ms
64 bytes from elvis: icmp_seq=2. time=8 ms
64 bytes from elvis: icmp_seq=3. time=7 ms
64 bytes from elvis: icmp_seq=4. time=11 ms
64 bytes from elvis: icmp_seq=5. time=7 ms
64 bytes from elvis: icmp_seq=6. time=7 ms
^C

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-110 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
ping—switch

----elvis PING Statistics----

7 packets transmitted, 7 packets received, 0% packet loss
round-trip (ms) min/avg/max = 7/8/11
Console>

This example shows how to configure ping:

Console> (enable) ping

Target IP Address []: 172.20.52.19

Number of Packets [5]: 6
Datagram Size [56]: 75
Timeout in seconds [2]: 1
Source IP Address [172.20.52.18]:
!!!!!!

----172.20.52.19 PING Statistics----

6 packets transmitted, 6 packets received, 0% packet loss
round-trip (ms) min/avg/max = 1/1/1
Console> (enable)

Related Commands set interface

set ip route—switch
show interface—switch
show ip route—switch

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-111
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
pwd

pwd
Use the pwd command to show the current default Flash device.

pwd [mod]

Syntax Description mod (Optional) Module number of the supervisor engine for which to
display the current default Flash device.

Defaults If no module number is specified, pwd defaults to the active supervisor engine.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to display the current default Flash device:
Console> pwd
bootflash
Console> cd
Default flash device set to slot0.
Console> pwd
slot0

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-112 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
quit

quit
Use the quit command to exit a CLI session.

quit

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines The exit and logout command aliases perform the same function as the quit command.

Examples This example shows how to quit a CLI session:

Console> quit
Connection closed by foreign host.
host%

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-113
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
reconfirm vmps

reconfirm vmps
Use the reconfirm vmps command to reconfirm the current dynamic port VLAN membership
assignments with the VMPS server.

reconfirm vmps

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines VMPS database changes are not conveyed automatically to switches participating in VMPS. Therefore,
after making a VMPS database change, use this command on VMPS clients and servers to apply the
database changes.

Examples This example shows how to reconfirm the current dynamic port VLAN membership with VMPS:
Console (enable) reconfirm vmps
reconfirm process started
Use 'show dvlan statistics' to see reconfirm status
Console (enable)

Related Commands set vmps server

show dvlan statistics
show vmps
show vmps statistics

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-114 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
repeat

repeat
Use the repeat ROM monitor command to repeat a command.

repeat [num | string]

Syntax Description num (Optional) Number of the command (from the command history
buffer list).
string (Optional) String that uniquely matches a command in the
command history buffer list.

Defaults If no argument is specified, the last command is repeated.

Command Types ROM monitor command.

Command Modes Normal.

Usage Guidelines The optional num and string arguments specify which command in the command history buffer to repeat.
If you specify a string to match, the most recent command in the buffer to begin with the specified string
is executed again.
If the string contains white space, you must use quotation marks.
For convenience you can use the alias r for this command.

Examples These examples show how to repeat the most recent dir command, repeat the most recent command, and
repeat command with the ID 15. You use the history command to display the list of previously entered
commands:
rommon 22 > history

8 dir
9 dir bootflash:
10 dis
11 dis 0xa0001000
12 dis 0xbe000000
13 history
14 meminfo
15 meminfo -l
16 meminfo
17 meminfo -l
18 meminfo
19 meminfo
20 meminfo -l
21 meminfo -l
22 history
rommon 23 > repeat dir

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-115
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
repeat

dir bootflash:
File size Checksum File name
1973032 bytes (0x1e1b28) 0xdadf5e24 llue
rommon 24 > repeat
dir bootflash:
File size Checksum File name
1973032 bytes (0x1e1b28) 0xdadf5e24 llue
rommon 25 > repeat 15
meminfo -l

Main memory size: 16 MB.

Packet memory size: 0 MB
Main memory size: 0x1000000
Available main memory starts at 0xa000e000, size 0xff2000
NVRAM size: 0x20000

Parity Map for the DRAM Banks

Socket 0 in Bank 0 Has No Parity
Socket 1 in Bank 0 Has No Parity
Socket 0 in Bank 1 Has No Parity
Socket 1 in Bank 1 Has No Parity
==========================================================================

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-116 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
reset—ROM monitor

reset—ROM monitor
Use the reset ROM monitor command to perform a soft reset of the switch.

reset {mod_num | system}

Syntax Description mod_num Number of the module to be reset.

system Keyword that specifies to reset the entire switch.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Examples This example shows how to reset the switch:

rommon 26 > reset

System Bootstrap, Version 3.1(1.69)

Copyright (c) 1994-1997 by cisco Systems, Inc.
Supervisor III processor with 16384 Kbytes of main memory

rommon 1 >
===========================================================================

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-117
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
reset—switch

reset—switch
Use the reset command to restart the system or an individual module and to schedule a system reset.

reset [mod_num | system | mindown]

reset [mindown] at {hh:mm} [mm/dd] [reason]

reset [mindown] in [hh:] {mm} [reason]

reset cancel

Syntax Description mod_num (Optional) Number of the module to be restarted.

system (Optional) Keyword that specifies to reset the system.
mindown (Optional) Keyword that specifies to perform a reset as part of a
minimal downtime software upgrade in a system with redundant
supervisor engine modules.
at Keyword that specifies to schedule a system reset at a specific future
time.
hh:mm Variable specifying the hour and minute of the scheduled reset.
mm/dd (Optional) Month and data of scheduled reset.
in Keyword that specifies to schedule a system reset after a specified
time.
hh: (Optional) Variable specifying how many hours into the future to
reset the switch.
mm Variable specifying how many minutes into the future to reset the
switch.
reason (Optional) Variable indicating the reason for the reset.
cancel Keyword that specifies to cancel a scheduled reset.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you do not specify a module number (either a switching module or the active supervisor engine
module), the command resets the entire system.
You can use the reset mod_num command to switch to the standby supervisor engine, where mod_num
is the module number of the active supervisor.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-118 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
reset—switch

In software release 5.2 and later, you can use the reset mindown command to reset the switch as part of
a minimal downtime software upgrade in a system with redundant supervisor engine modules. For
complete information on performing a minimal downtime software upgrade, refer to the Software
Configuration Guide–Catalyst 4000 Family, 2948G, and 2980G Switches.

Caution If you make configuration changes after entering the reset mindown command but before the active
supervisor engine resets, the changes are not saved. Input from the CLI is still accepted by the switch
while the standby supervisor engine is reset, but any changes you make to the configuration between
the time when you enter the reset mindown command and the time when the supervisor engine
comes online running the new software image are not saved or synchronized with the standby
supervisor engine.

Examples This example shows how to reset module 4:

Console> (enable) reset 4
This command will reset module 4 and may disconnect your telnet session.
Do you want to continue (y/n) [n]? y
Resetting module 4...
Console> (enable)

This example shows how to schedule a reset at a specific future time and include a reason for the reset:
cat> (enable) reset at 23:00 08/18 Software upgrade to 5.3(1).
Reset scheduled at 23:00:00, Wed Aug 18 2000.
Reset reason: Software upgrade to 5.3(1).
Proceed with scheduled reset? (y/n) [n]? y
Reset scheduled for 23:00:00, Wed Aug 18 2000 (in 0 day 8 hours 39 minutes).
cat> (enable)

This example shows how to schedule a reset with minimum down time.
cat> (enable) reset mindown at 23:00 08/18 Software upgrade to 5.3(1).
Reset scheduled at 23:00:00, Wed Aug 18 2000.
Reset reason: Software upgrade to 5.3(1).
Proceed with scheduled reset? (y/n) [n]? y
Reset mindown scheduled for 23:00:00, Wed Aug 18 2000 (in 0 day 8 hours 39 minutes).
cat> (enable)

This example shows how to schedule a reset after a specified time:

cat> (enable) reset in 05:20 Configuration update
Reset scheduled in 5 hours 20 minutes.
Reset reason: Configuration update
Proceed with scheduled reset? (y/n) [n]? y
Reset scheduled for 19:56:01, Wed Aug 18 2000 (in 5 hours 20 minutes).
Reset reason: Configuration update
cat> (enable)

This example shows how to cancel a scheduled reset:

cat> (enable) reset cancel
Cancel reset scheduled for 19:56:01, Wed Aug 18 2000 (in 5 hours 20 minutes).
cat> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-119
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
session

session
Use the session command to access the CLI of an intelligent module such as a Catalyst 5000 family
RSM, RSFC, or ATM module.

session mod

Syntax Description mod Number of the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines After you enter this command, the system responds with the Enter Password: prompt, if a password is
configured on the module.
To end the session with the intelligent module, enter the quit command.

Examples This example shows how to open a session with an ATM module (module 4):
Console> session 4
Trying ATM-4...
Connected to ATM-4.
Escape character is ‘^]’.

ATM>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-120 78-12648-03
 2
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set

set
Use the set command to display all of the ROM monitor command variable names, along with their
values.

set

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Examples This example shows how to use the set command to display all of the monitor variable names along with
their values:
rommon 2 > set
PS1=rommon ! >
BOOT=
?=0

Related Commands varname=

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-121
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set accounting commands

set accounting commands

Use the set accounting commands command to enable command event accounting on the switch.

set accounting commands enable {config | enable | all} [stop-only]{tacacs+}

set accounting commands disable

Syntax Description enable Keyword that specifies to enable the specified accounting method
for commands.
config Keyword that specifies to permit accounting for configuration
commands only.
enable Keyword that specifies to permit accounting for enable mode
commands only.
all Keyword that specifies to permit accounting for all commands.
stop-only (Optional) Keyword that specifies the accounting method that
applies at the conclusion of the command.
tacacs+ Keyword that specifies TACACS+ accounting for commands.
disable Keyword that specifies to disable accounting for commands.

Defaults By default, accounting is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You must configure the TACACS+ servers before you enable accounting.

Examples This example shows how to enable accounting for configuration commands when sending records only
upon termination of the event, using a TACACS+ server:
Console> (enable) set accounting commands enable config stop-only tacacs+
Accounting set to enable for commands-config events in stop-only mode.
Console> (enable)

This example shows how to enable accounting for all commands when sending records only upon
termination of an event, using a TACACS+ server:
Console> (enable) set accounting commands enable all stop-only tacacs+
Accounting set to enable for commands-all events in stop-only mode.
Console> (enable) reset cancel

This example shows how to disable command accounting:

Console> (enable) set accounting commands disable

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-122 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set accounting commands

Accounting set to disable for commands-config events.

Console> (enable)

This example shows how to configure accounting for enable mode commands:
Console> (enable) set accounting commands enable enable stop-only tacacs+
Accounting set to enable for commands-enable-mode event in stop-only mode.

Related Commands set accounting connect

set accounting exec
set accounting suppress
set accounting system
set accounting update
set tacacs server
show accounting

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-123
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set accounting connect

set accounting connect

Use the set accounting connect command to enable accounting of outbound connection events on the
switch.

set accounting connect enable {start-stop | stop-only} {tacacs+ | radius}

set accounting connect disable

Syntax Description enable Keyword that specifies to enable the specified accounting method
for connection events.
start-stop Keyword that specifies the accounting method that applies at the
start and stop of the connection event.
stop-only Keyword that specifies the accounting method that applies at the
conclusion of the connection event.
tacacs+ Keyword that specifies TACACS+ accounting for connection
events.
radius Keyword that specifies RADIUS accounting for connection events.
disable Keyword that specifies to disable accounting of connection events.

Defaults By default, accounting is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You must configure the RADIUS or TACACS+ servers and shared keys before enabling accounting.

Examples This example shows how to enable accounting on Telnet and rlogin sessions when generating records at
stop only, using a TACACS+ server:
Console> (enable) set accounting connect enable stop-only tacacs+
Accounting set to enable for connect events in stop-only mode.
Console> (enable)

This example shows how to disable accounting:

Console> (enable) set accounting connect disable
Accounting set to disable for connect events.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-124 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set accounting connect

Related Commands set accounting commands

set accounting exec
set accounting suppress
set accounting system
set accounting update
set radius key
set tacacs key
set tacacs server
show accounting

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-125
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set accounting exec

set accounting exec

Use the set accounting exec command to enable accounting of normal mode sessions on the switch.

set accounting exec enable {start-stop | stop-only} {tacacs+ | radius}

set accounting exec disable

Syntax Description enable Keyword that specifies to enable the specified accounting method
for normal mode events.
start-stop Keyword that specifies the accounting method applies at the start
and stop of the normal mode event.
stop-only Keyword that specifies the accounting method applies at the
conclusion of the normal mode event.
tacacs+ Keyword that specifies TACACS+ accounting for normal mode
events.
radius Keyword that specifies RADIUS accounting for normal mode
events.
disable Keyword that specifies to disable accounting for normal mode
events.

Defaults By default, accounting is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You must configure the RADIUS or TACACS+ servers and shared keys before enabling accounting.

Examples This example shows how to enable accounting of normal login mode events when generating records at
start and stop, using a RADIUS server:
Console> (enable) set accounting exec enable start-stop radius
Accounting set to enable for exec events in start-stop mode.
Console> (enable)

This example shows how to enable accounting of normal login mode events when generating records at
stop only, using a RADIUS server:
Console> (enable) set accounting exec enable stop-only radius
Accounting set to enable for exec events in stop-only mode.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-126 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set accounting exec

This example shows how to enable accounting of normal login mode events when generating records at
start and stop, using a TACACS+ server:
Console> (enable) set accounting exec enable start-stop tacacs+
Accounting set to enable for exec events in start-stop mode.
Console> (enable)

This example shows how to enable accounting of normal login mode events when generating records at
stop only, using a TACACS+ server:
Console> (enable) set accounting exec enable stop-only tacacs+
Accounting set to enable for exec events in stop-only mode.
Console> (enable)

This example shows how to disable accounting of normal login mode events:
Console> (enable) set accounting exec disable
Accounting set to disable for exec events in start-stop mode.
Console> (enable)

Related Commands set accounting commands

set accounting connect
set accounting suppress
set accounting system
set accounting update
set radius key
set radius server
set tacacs key
set tacacs server
show accounting

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-127
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set accounting suppress

set accounting suppress

Use the set accounting suppress command to enable or disable suppression of accounting information
for a user who has logged in without a username.

set accounting suppress null-username {enable | disable}

Syntax Description null-username Keyword that specifies unknown users.

enable Keyword that specifies to enable suppression for unknown users.
disable Keyword that specifies to disable suppression unknown users.

Defaults By default, accounting is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You must configure the TACACS+ servers and shared keys before enabling accounting.

Examples This example shows how to suppress accounting information for users without a username:
Console> (enable) set accounting suppress null-username enable
Accounting will be suppressed for user with no username.
Console> (enable)

This example shows how to include accounting-event information of users without usernames:
Console> (enable) set accounting suppress null-username disable
Accounting will be not be suppressed for user with no username.
Console> (enable)

Related Commands set accounting commands

set accounting connect
set accounting exec
set accounting system
set accounting update
set tacacs key
set tacacs server
show accounting

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-128 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set accounting system

set accounting system

Use the set accounting system command to enable accounting of system events on the switch.

set accounting system enable {start-stop | stop-only} {tacacs+ | radius}

set accounting system disable

Syntax Description enable Keyword that specifies to enable the specified accounting method
for system events.
start-stop Keyword that specifies the accounting method applies at the start
and stop of the system event.
stop-only Keyword that specifies the accounting method applies at the
conclusion of the system event.
tacacs+ Keyword that specifies TACACS+ accounting for system events.
radius Keyword that specifies RADIUS accounting for system events.
disable Keyword that specifies to disable accounting for system events.

Defaults By default, accounting is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You must configure the RADIUS or TACACS+ servers and shared keys before enabling accounting.

Examples This example shows how to enable accounting for system events when sending records only upon
termination of the event, using a RADIUS server:
Console> (enable) set accounting system enable stop-only radius
Accounting set to enable for system events in start-stop mode.
Console> (enable)

This example shows how to enable accounting for system events when sending records upon the
start-stop of the event, using a RADIUS server:
Console> (enable) set accounting system enable start-stop radius
Accounting set to enable for system events in start-stop mode.
Console> (enable)

This example shows how to enable accounting for system events when sending records only upon
termination of the event, using a TACACS+ server:
Console> (enable) set accounting system enable stop-only tacacs+
Accounting set to enable for system events in start-stop mode.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-129
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set accounting system

This example shows how to enable accounting for system events when sending records upon the
start-stop of the event, using a TACACS server:
Console> (enable) set accounting system enable start-stop tacacs+
Accounting set to enable for system events in start-stop mode.
Console> (enable)

This example shows how to disable accounting for system events:

Console> (enable) set accounting system disable
Accounting set to disable for system events.
Console> (enable)

Related Commands set accounting commands

set accounting connect
set accounting exec
set accounting suppress
set accounting update
set radius key
set radius server
set tacacs key
set tacacs server
show accounting

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-130 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set accounting update

set accounting update

Use the set accounting update command to configure the frequency of accounting updates.

set accounting update {new-info | periodic [interval]}

Syntax Description new-info Keyword that specifies to update only when new information is
available.
periodic Keyword that specifies to update periodically.
interval (Optional) Periodic update interval time in minutes. Valid intervals
are 1 to 71582 minutes.

Defaults By default, accounting is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You must configure the TACACS+ servers and shared keys before enabling accounting.

Examples This example shows how to send accounting updates every 200 minutes:
Console> (enable) set accounting update periodic 200
Accounting updates will be periodic at 200 minute intervals.
Console> (enable)

This example shows how to send accounting updates only when there is new information:
Console> (enable) set accounting update new-info
Accounting updates will be sent on new information only.
Console> (enable)

Related Commands set accounting commands

set accounting connect
set accounting exec
set accounting suppress
set accounting system
set radius key
set radius server
set tacacs key
set tacacs server
show accounting

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-131
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set alias

set alias
Use the set alias command to define command aliases (shortened versions of command names).

set alias name command [parameter] [parameter]

Syntax Description name Alias being created.

command Command for which the alias is being created.
parameter (Optional) Parameter that applies to the command for which an alias
is being created. See the specific command for information about
parameters that apply.

Defaults By default, there are no aliases configured.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The name all cannot be defined as an alias. Reserved words cannot be defined as aliases.

Examples This example shows how to set arpdel as the alias for the clear arp command:
Console> (enable) set alias arpdel clear arp
Command alias added.
Console> (enable)

Related Commands show alias

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-132 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set arp

set arp
Use the set arp command to add IP address-to-MAC address mapping entries to the ARP table and to
set the ARP aging time for the table.

set arp [dynamic | permanent | static] [ip_addr | hw_addr]

set arp agingtime agingtime

Syntax Description dynamic (Optional) Keyword that specifies that entries are subject to ARP aging
updates.
permanent (Optional) Keyword that specifies that permanent entries are stored in
NVRAM until they are removed by the clear arp or clear config command.
static (Optional) Keyword that specifies that entries are not subject to ARP aging
updates.
ip_addr (Optional) IP address or IP alias to map to the specified MAC address.
hw_addr (Optional) MAC address to map to the specified IP address or IP alias.
agingtime Keyword to set the period of time after which an ARP entry is removed from
the ARP table.
agingtime Number of seconds (from 0 to 1000000) for which entries will remain in the
ARP table before being deleted. Setting this value to 0 disables aging.

Defaults By default, no ARP table entries exist; ARP aging is set to 1200 seconds.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines hw_addr is 6-hexbyte MAC address expressed in canonical (00-11-22-33-44-55) or noncanonical
(00:11:22:33:44:55) format.

Examples This example shows how to configure a dynamic ARP entry mapping that will age out after the
configured ARP aging time:
Console> (enable) set arp dynamic 198.133.219.232 00-00-0c-40-0f-bc
ARP entry added.
Console> (enable)

This example shows how to set the aging time for the ARP table to 1800 seconds (30 minutes):
Console> (enable) set arp agingtime 1800
ARP aging time set to 1800 seconds.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-133
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set arp

This example shows how to configure a permanent ARP entry, which will remain in the ARP cache after
a system reset:
Console> (enable) set arp permanent 198.146.232.23 00-00-0c-30-0f-bc
Permanent ARP entry added as 198.146.232.23 at 00-00-0c-30-0f-bc on vlan 5
Console> (enable)

This example shows how to configure a static ARP entry, which will be removed from the ARP cache
after a system reset:
Console> (enable) set arp static 198.144.239.22 00-00-0c-50-0f-bc
Static ARP entry added as 198.144.239.22 at 00-00-0c-50-0f-bc on vlan 5
Console> (enable)

Related Commands clear arp

show arp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-134 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set authentication enable

set authentication enable

Use the set authentication enable command to configure the switch to use RADIUS, TACACS+,
Kerberos, or local authentication to authenticate privileged (enable) mode access on the switch.

set authentication enable {radius | tacacs | kerberos} {enable} [console | telnet | http | all]
[primary]

set authentication enable {radius | tacacs | kerberos} {disable} [console | telnet | http | all]

set authentication enable local {enable | disable} [console | telnet | http | all]

set authentication enable attempt count [console | remote]

set authentication enable lockout {time} [console | remote]

Syntax Description radius Keyword that specifies RADIUS authentication for privileged mode access.
tacacs Keyword that specifies TACACS+ authentication for privileged mode
access.
kerberos Keyword that specifies Kerberos authentication for privileged mode access.
enable Keyword that specifies to enable the specified authentication method for
privileged mode access.
console (Optional) Keyword that specifies that the authentication method applies to
console sessions.
telnet (Optional) Keyword that specifies that the authentication method applies to
Telnet sessions.
http (Optional) Keyword that specifies that the authentication method applies to
HTTP sessions.
all (Optional) Keyword that specifies that the authentication method applies to
all sessions.
primary (Optional) Keyword that specifies that the authentication method specified
must be tried first.
disable Keyword that specifies to disable the specified authentication method for
privileged mode access.
local Keyword that specifies local authentication for privileged mode access.
attempt Keyword that specifies the number of login attempts.
count Number of allowed login attempts.
remote (Optional) Keyword that specifies that the authentication method applies to
remote logins such as Telnet, SSH, Kerberos, and HTTP.
lockout time Keyword that specifies the period of time a user is locked out of the switch
after unsuccessfully attempting login.
time Period of time a user is locked out in seconds.

Defaults By default, local authentication is enabled for console and Telnet sessions. RADIUS, TACACS+, and
Kerberos are disabled for all session types.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-135
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set authentication enable

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You can specify TACACS+ or RADIUS as the primary authentication method for login and enable
access by entering the primary keyword. If you enter the primary keyword, the specified authentication
method will be tried first. If you do not specify a primary authentication, authentication will be tried in
the order in which you enabled them.
You can specify that the authentication method applies to console sessions, Telnet sessions, or both, by
entering the console or telnet keyword. If you do not specify console or telnet the authentication
method applies to both console and Telnet sessions.

Examples This example shows how to use the TACACS+ server to determine if a user has privileged access
permission:
Console> (enable) set authentication enable tacacs enable
tacacs enable authentication set to enable for console, telnet and http session.
Console> (enable)

This example shows how to use the local password to determine if the user has privileged access
permission:
Console> (enable) set authentication enable local enable
local enable authentication set to enable for console, telnet and http session.
Console> (enable)

This example shows how to use the RADIUS server to determine if a user has privileged access
permission for all session types:
Console> (enable) set authentication enable radius enable
radius enable authentication set to enable for console, telnet and http session.
Console> (enable)

This example shows how to use the TACACS+ server to determine if a user has privileged access
permission for a console session:
Console> (enable) set authentication enable tacacs enable console
tacacs enable authentication set to enable for console session.
Console> (enable)

This example shows how to set the Kerberos server to be used first:
Console> (enable) set authentication enable kerberos enable primary
kerberos enable authentication set to enable for console, telnet and http session
n as primary authentication method.
Console> (enable)

This example shows how to set the enable login attempt to 5 for both console and remote sessions:
Console> (enable) set authentication enable attempt 5
Enable mode authentication attempts for console and remote login set to 5.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-136 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set authentication enable

This example shows how to set the enable login attempt to 7 for remote sessions:
Console> (enable) set authentication enable attempt 7 remote
Enable mode authentication attempts for remote login set to 7.
Console> (enable)

This example shows how to set the enable login attempt to 8 for console sessions:
Console> (enable) set authentication enable attempt 8 console
Enable mode authentication attempts for console login set to 8.
Console> (enable)

This example shows how to set the enable lockout time for both console and remote sessions to 50
seconds:
Console> (enable) set authentication enable lockout 50
Enable mode lockout time for console and remote login set to 50 seconds.
Console> (enable)

This example shows how to set the enable lockout time for console sessions to 5 minutes:
Console> (enable) set authentication enable lockout 300 console
Enable mode lockout time for console login set to 5 minutes.
Console> (enable)

This example shows how to set the enable lockout time for remote sessions to 7 minutes and 10 seconds:
Console> (enable) set authentication enable lockout 430 remote
Enable mode lockout time for console and remote login set to 7 minutes and 10 seconds.
Console> (enable)

Related Commands set authentication login

show authentication

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-137
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set authentication login

set authentication login

Use the set authentication login command to configure the switch to use TACACS+, Kerberos,
RADIUS, or local authentication to authenticate normal (login) mode access on the switch.

set authentication login attempt count [console | remote]

set authentication login lockout time [console | remote]

set authentication login {radius | tacacs | kerberos} enable [console | telnet | http | all]
[primary]

set authentication login {radius | tacacs | kerberos} disable [console | telnet | http | all]

set authentication login local {enable | disable} [console | telnet | http | all]

Syntax Description attempt count Keyword that specifies the number of login attempts.
remote (Optional) Keyword that specifies the authentication method applies to
remote logins such as Telnet, SSH, kerberos, and HTTP.
lockout time Keyword that specifies that the period of time a user is locked out of the
switch after unsuccessfully attempting login.
radius Keyword that specifies RADIUS authentication for normal mode access.
tacacs Keyword that specifies TACACS+ authentication for normal mode access.
kerberos Keyword that specifies Kerberos authentication for normal mode access.
enable Keyword that specifies to enable the specified authentication method for
normal mode access.
console (Optional) Keyword that specifies that the authentication method applies to
console sessions.
telnet (Optional) Keyword that specifies that the authentication method applies to
Telnet sessions.
http (Optional) Keyword that specifies that the authentication method applies to
HTTP sessions.
all (Optional) Keyword that specifies that the authentication method applies to
all sessions.
primary (Optional) Keyword that specifies that the specified authentication method
be tried first.
disable Keyword that specifies to disable the specified authentication method for
normal mode access.
local Keyword that specifies local authentication for normal mode access.

Defaults The defaults are:

• Three login attempts
• Local authentication as the primary authentication method for login

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-138 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set authentication login

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines This command allows you to choose the authentication method for the web interface. If you configure
the authentication method for the HTTP session as RADIUS, then the username or password is validated
using the RADIUS protocol, and TACACS+ and Kerberos authentication is set to disable for the HTTP
sessions. By default, the HTTP login is validated using the local login password.
You can specify the authentication method for console, telnet, http, or all by entering the console,
telnet, http, or all keywords. If you do not specify console, telnet, http, or all, the authentication
method default is for all sessions.
The maximum number of login attempts from SNMP and the command-line interface (CLI) can be
configured. The configurable range is from 0 to 10. To disable login attempts, set the level to 0. Failed
login system logs are generated at level 5. If you are attempting access to enable mode, and the password
fails more than the number of attempts allowed, the system will disable the execution of the enable
command for the lockout time.
The lockout time is configurable from SNMP and the CLI. The configurable range is from 30 to 600
seconds (half a minute to ten minutes). For console login, the console will not allow logging in during
that time. For remote logins the connection will be closed when the limit is reached, and any subsequent
login attempts from that station will be closed immediately by the switch.
When attempt limit checking is disabled, the lockout restriction is no longer applicable.

Examples This example shows how to set the login attempt to 5 for both console and remote sessions:
Console> (enable) set authentication login attempt 5
Login authentication attempts for console and remote login set to 5.
Console> (enable)

This example shows how to set the login attempt to 7 for remote sessions:
Console> (enable) set authentication login attempt 7 remote
Login authentication attempts for remote login set to 7.
Console> (enable)

This example shows how to set the login attempt to 8 for console sessions:
Console> (enable) set authentication login attempt 8 console
Login authentication attempts for console login set to 8.
Console> (enable)

This example shows how to set the lockout time for both console and remote sessions to 50 seconds:
Console> (enable) set authentication login lockout 50
Login lockout time for console and remote login set to 50 seconds.
Console> (enable)

This example shows how to set the lockout time for console sessions to 5 minutes:
Console> (enable) set authentication login lockout 300 console
Login lockout time for console login set to 5 minutes.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-139
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set authentication login

This example shows how to set the lockout time for remote sessions to 7 minutes and 10 seconds:
Console> (enable) set authentication login lockout 430 remote
Login lockout time for console and remote login set to 7 minutes and 10 seconds.
Console> (enable)

This example shows how to disable TACACS+ authentication access for Telnet sessions:
Console> (enable) set authentication login tacacs disable telnet
tacacs login authentication set to disable for the telnet sessions.
Console> (enable)

This example shows how to disable RADIUS authentication access for console sessions:
Console> (enable) set authentication login radius disable console
radius login authentication set to disable for the console sessions.
Console> (enable)

This example shows how to disable Kerberos authentication access for Telnet sessions:
Console> (enable) set authentication login kerberos disable telnet
kerberos login authentication set to disable for the telnet sessions.
Console> (enable)

This example shows how to set TACACS+ authentication access as the primary method for HTTP
sessions:
Console> (enable) set authentication login tacacs enable http primary
tacacs login authentication set to enable for HTTP sessions as primary authentication
method.
Console> (enable)

Related Commands set authentication enable

show authentication

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-140 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set authorization commands

set authorization commands

Use the set authorization commands command set to enable authorization of command events on the
switch.

set authorization commands enable {config | enable | all} {option} {fallbackoption} [console |
telnet | both]

set authorization commands disable [console | telnet | both]

Syntax Description enable Keyword that specifies to enable the specified authorization method
for commands.
config Keyword that specifies to permit authorization for configuration
commands only.
enable Keyword that specifies to permit authorization for enable mode
commands only.
all Keyword that specifies to permit authorization for all commands.
option Switch response to an authorization request. Valid values are
tacacs+, if-authenticated, and none. Refer to the “Usage
Guidelines” below for definitions of valid value.
fallbackoption Switch fallback response to an authorization request if the
TACACS+ server is down or not responding. Valid values are
tacacs+, deny, if-authenticated, and none. Refer to the “Usage
Guidelines” below for definitions of valid value.
console (Optional) Keyword that specifies that the authorization method
applies to console sessions.
telnet (Optional) Keyword that specifies that the authorization method
applies to Telnet sessions.
both (Optional) Keyword that specifies that the authorization method
applies to both console and Telnet sessions.
disable Keyword that disables authorization for commands.

Defaults By default, authorization is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines When you define the option and fallbackoption values, the following occurs:
• tacacs+ specifies the TACACS+ authorization method.
• deny does not let you proceed.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-141
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set authorization commands

• if-authenticated allows you to proceed with your action if you have been authenticated.
• none allows you to proceed without further authorization in case the TACACS+ server does not
respond.

Examples This example shows how to enable authorization for all commands with an if-authenticated option and
no fallback option, in case the TACACS+ daemon is down or does not respond:
Console> (enable) set authorization commands enable all if-authenticated none
Successfully enabled commands authorization.
Console> (enable)

This example shows how to disable command authorization:

Console> (enable) set authorization commands disable
Successfully disabled commands authorization.
Console> (enable)

This example shows how to configure authorization for enable mode commands:
Console> (enable) set authorization commands enable enable tacacs+ deny telnet
Successfully enabled commands authorization.

Related Commands set authorization enable

set authorization exec
show authorization

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-142 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set authorization enable

set authorization enable

Use the set authorization enable command to authorize enable (privileged mode) session events on the
switch.

set authorization enable enable {option} {fallbackoption} [console | telnet | both]

set authorization enable disable [console | telnet | both]

Syntax Description enable Keyword that enables the specified authorization method.
option Switch response to an authorization request. Valid values are
tacacs+, if-authenticated, and none. Refer to the “Usage
Guidelines” below for definitions of valid value.
fallbackoption Switch fallback response to an authorization request if the
TACACS+ server is down or not responding. Valid values are
tacacs+, deny, if-authenticated, and none. Refer to the “Usage
Guidelines” below for definitions of valid value.
console (Optional) Keyword that specifies that the authorization method
applies to console sessions.
telnet (Optional) Keyword that specifies that the authorization method
applies to Telnet sessions.
both (Optional) Keyword that specifies that the authorization method
applies to both console and Telnet sessions.
disable Keyword that disables the specified authorization method.

Defaults By default, authorization is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The tacacs+ value allows you to proceed with your action if you have authorization.
The deny value does not let you proceed if the TACACS+ server does not respond.
The if-authenticated value allows you to proceed with your action if you have been authenticated.
The none value allows you to proceed without further authorization in case the TACACS+ server does
not respond.

Examples This example shows how to enable authorization of configuration commands in enable mode sessions:
Console> (enable) set authorization enable enable if-authenticated
Successfully enabled enable authorization.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-143
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set authorization enable

This example shows how to disable enable mode authorization:

Console> (enable) set authorization enable disable
Successfully disabled enable authorization.
Console> (enable)

Related Commands set authorization commands

set authorization exec
show authorization

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-144 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set authorization exec

set authorization exec

Use the set authorization exec command to enable authorization of exec (normal mode) session events
on the switch.

set authorization exec enable {option} {fallbackoption} [console | telnet | both]

set authorization exec disable [console | telnet | both]

Syntax Description enable Keyword that specifies to enable the specified authorization
method.
option Switch response to an authorization request. Valid values are
tacacs+, if-authenticated, and none. Refer to the “Usage
Guidelines” below for definitions of valid value.
fallbackoption Switch fallback response to an authorization request if the
TACACS+ server is down or not responding. Valid values are
tacacs+, deny, if-authenticated, and none. Refer to the “Usage
Guidelines” below for definitions of valid value.
console (Optional) Keyword that specifies that the authorization method
applies to console sessions.
telnet (Optional) Keyword that specifies that the authorization method
applies to Telnet sessions.
both (Optional) Keyword that specifies that the authorization method
applies to both console and Telnet sessions.
disable Keyword that disables the specified authorization method.

Defaults By default, authorization is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The tacacs+ value allows you to proceed with your action if you have authorization.
The deny value does not let you proceed if the TACACS+ server does not respond.
The if-authenticated value allows you to proceed with your action if you have been authenticated.
The none value allows you to proceed without further authorization in case the TACACS+ server does
not respond.

Examples This example shows how to enable authorization of configuration commands in exec mode sessions:
Console> (enable) set authorization exec enable if-authenticated
Successfully enabled exec authorization.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-145
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set authorization exec

Console> (enable)

This example shows how to disable exec mode authorization:

Console> (enable) set authorization exec disable
Successfully disabled exec authorization.
Console> (enable)

Related Commands set authorization commands

set authorization enable
show authorization

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-146 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set banner motd

set banner motd

Use the set banner motd command to create a login banner that is displayed when users access the
switch.

set banner motd c [text] c

Syntax Description c Delimiting character used to begin and end the message.
text (Optional) Message of the day.

Defaults By default, no MOTD banner is displayed.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The banner cannot contain more than 3070 characters, including tabs. Tabs display as eight characters
but take only one character of memory.
You can use either the clear banner motd command or the set banner motd command to clear the
message-of-the-day banner.

Examples This example shows how to set the message of the day using the pound sign (#) as the delimiting
character:
Console> (enable) set banner motd #
** System upgrade: starting: 6:00am Tuesday.
** Please log out before leaving on Monday. #
MOTD banner set.
Console> (enable>

This example shows how to clear the message of the day using the set banner motd command:
Console> (enable) set banner motd ##
MOTD banner cleared.
Console> (enable>

Related Commands clear banner motd

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-147
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set boot auto-config

set boot auto-config

Use the set boot auto-config command to specify one or more configuration files to use to configure the
switch at startup and to set the recurrence option. A list of configuration files is stored in the config_file
environment variable.

set boot auto-config device:filename [;<device:filename>...] [mod_num]

Syntax Description device: Device where the startup configuration file resides.
filename Name of the startup configuration file.
mod_num (Optional) Module number of the supervisor engine containing the
Flash device.

Defaults By default, this command is set to non-recurring and the CONFIG_FILE is not defined.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The set boot auto-config command always overwrites the existing CONFIG_FILE environment
variable settings (you cannot prepend or append a file to the variable contents).
In the Catalyst 4000 family switches, multiple configuration files may be specified, but they must be
separated by a semicolon (;).
To set the recurrence on the Catalyst 4000 family switches, use the set boot config-register auto-config
command.

Examples This example shows how to specify the configuration file environment variable:
Console> (enable) set boot auto-config slot0:cfg1
CONFIG_FILE variable = slot0:cfg1
WARNING: nvram configuration may be lost during next bootup,
and re-configured using the file(s) specified.
Console> (enable)

Related Commands set boot system flash

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-148 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set boot config-register

set boot config-register

Use the set boot config-register command to set the boot configuration register value.

set boot config-register 0xvalue [mod_num]

set boot config-register boot {rommon | bootflash | system} [mod_num]

set boot config-register baud {1200 | 2400 | 4800 | 9600} [mod_num]

set boot config-register ignore-config {enable | disable} [mod_num]

set boot config-register auto-config {recurring | non-recurring} [mod_num]

Syntax Description 0xvalue Keyword to set the 16-bit configuration register value. This value is
a hexadecimal value and the valid range is 0x0 to 0xFFFF.
mod_num (Optional) Module number of the supervisor engine on which to set
the configuration register value.
boot Keyword that specifies the boot method to use the next time the
switch is reset or power cycled.
rommon Keyword that causes the switch to remain in ROM monitor mode
the next time the switch is reset or power cycled.
bootflash Keyword that causes the switch to boot using the first valid system
image in bootflash the next time the switch is reset or power cycled.
system Keyword that causes the switch to boot using the system images
specified in the BOOT environment variable the next time the
switch is reset or power cycled.
baud Keyword that specifies to set the console baud rate.
1200 | 2400 | 4800 Keywords that specifies the ROM monitor console port baud rate.
| 9600
ignore-config Keyword that specifies whether the switch should ignore the
configuration in NVRAM the next time the switch is restarted.
enable Keyword that causes the switch to ignore the configuration in
NVRAM the next time the switch is restarted.
disable Keyword that prevents the switch from ignoring the configuration
in NVRAM the next time the switch is restarted.
recurring Keyword that causes the switch to retain the contents of the
CONFIG_FILE environment variable after the switch is reset or
power cycled and configured using the files specified by the
CONFIG_FILE environment variable.
non-recurring Keyword that causes the switch to clear the contents of the
CONFIG_FILE environment variable after the switch is reset or
power cycled and before the switch is configured using the files
specified by the CONFIG_FILE environment variable.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-149
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set boot config-register

Defaults The default configuration register value is 0x10F, which specifies the following settings:
• Boot method is “system” (the switch boots using the system images specified in the BOOT
environment variable).
• ROM monitor console port baud rate is set to 9600.
• The ignore-config parameter is disabled.
• The auto-config parameter is set to non-recurring.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines We recommend that you use only the rommon and system options to the set boot config-register boot
command.
Each time you enter one of the set boot config-register commands, the system displays all current
configuration register information (the equivalent of entering the show boot command).
The baud rate specified in the configuration register is used by the ROM monitor only and is different
from the baud rate specified by the set system baud command.
The auto-config_file variable is slot0:switch.cfg for non-recurring and bootflash:switch.cfg for the
Catalyst 4000 family switches.

Caution Enabling the ignore-config parameter is the same as entering the clear config all command; that is,
it clears the entire configuration stored in NVRAM the next time the switch is restarted.

Caution When you use the set boot config-register 0xvalue command it is recommended that you confirm
and verify the 0xvalue. If you enter an incorrect 0xvalue the switch may behave incorrectly by not
booting correctly or losing the configuration in NVRAM.

Examples This example shows how to specify the default 16-bit configuration register value:
Console> (enable) set boot config-register 0x10f
Configuration register is 0x10f
ignore-config: disabled
auto-config: non-recurring
console baud: 9600
boot: image specified by the boot system commands
Console> (enable)

This example shows how to specify rommon as the boot image to use on the next restart:
Console> (enable) set boot config-register boot rommon
Configuration register is 0x100
ignore-config: disabled
auto-config: non-recurring
console baud: 9600

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-150 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set boot config-register

boot: the ROM monitor

Console> (enable)

This example shows how to change the ROM monitor console port baud rate to 4800:
Console> (enable) set boot config-register baud 4800
Configuration register is 0x900
ignore-config: disabled
auto-config: non-recurring
console baud: 4800
boot: the ROM monitor
Console> (enable)

This example shows how to cause the switch to ignore the configuration in NVRAM the next time the
switch is reset or power cycled:
Console> (enable) set boot config-register ignore-config enable
Configuration register is 0x940
ignore-config: enabled
auto-config: non-recurring
console baud: 4800
boot: the ROM monitor
Console> (enable)

This example shows how to set the auto-configuration to recurring:

Console> (enable) set boot config-register auto-config recurring
Configuration register is 0x960
ignore-config: enabled
auto-config: recurring
console baud: 4800
boot: the ROM monitor
Console> (enable)

Related Commands clear boot—switch

show boot—switch

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-151
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set boot sync now

set boot sync now

Use the set boot sync now command to initiate synchronization of the auto-config file.

set boot sync now

Syntax Description This command has no arguments or keywords.

Defaults By default, synchronization is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The set boot sync now command is similar to the set boot config-register command. The set boot sync
now command initiates synchronization to force the configuration files to synchronize automatically to
the standby supervisor engine. The files are kept consistent with what is on the active supervisor engine.

Examples This example shows how to initiate synchronization of the auto-config file:
Console> (enable) set boot sync now
Console> (enable)

Related Commands set boot auto-config

show boot—switch

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-152 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set boot system flash

set boot system flash

Use the set boot system flash command to set the BOOT environment variable, which specifies a list of
software images that the switch attempts to load at startup.

set boot system flash device:filename [prepend] [mod_num]

Syntax Description device: Flash device where the software image is stored (the colon [:] is required).
filename Name of the software image file on the Flash device.
prepend (Optional) Keyword that specifies to place the software image file first in the list
of images to attempt to boot.
mod_num (Optional) Module number of the supervisor engine on which to modify the
BOOT environment variable.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You can enter several boot system commands to provide a fail-safe method for booting the switch. The
system stores and executes the boot system commands in the order in which you enter them.
When you copy a new software image to a Flash device and want to switch to boot that image the next
time the switch is reset, clear the BOOT environment variable using the clear boot system all command
or use the prepend keyword to place the new software image file first in the list of images to attempt to
boot.
If the file does not exist (for example, if you entered the wrong filename), then the filename is appended
to the bootstring, and a message displays, “Warning: File not found but still added in the bootstring.”
If the file does exist, but is not a supervisor engine software image, the file is not added to the bootstring,
and a message displays, “Warning: file found but it is not a valid boot image.”

Examples This example shows how to append a software image file to the BOOT environment variable:
Console> (enable) set boot system flash bootflash:cat5000-sup3.5-1-1.bin
BOOT variable =
bootflash:cat5000-sup3.5-2-1.bin,1;bootflash:cat5000-sup3.5-1-1.bin,1;
Console> (enable)

This example shows how to prepend a software image file to the BOOT environment variable:
Console> (enable) set boot system flash slot0:cat5000-sup3.5-2-1.bin prepend
BOOT variable =
slot0:cat5000-sup3.5-2-1.bin,1;bootflash:cat5000-sup3.4-5-2.bin,1;
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-153
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set boot system flash

Related Commands clear boot—switch

show boot—switch

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-154 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set cam

set cam
Use the set cam command to add entries into the CAM table and to set the aging time for the CAM table.

set cam agingtime [vlan] agingtime

set cam {dynamic | static | permanent} {unicast_mac | route_descr} {mod/port} [vlan]

set cam {static | permanent} {multicast_mac} {mod/ports...} [vlan]

set cam {static | permanent} filter {unicast_mac} [vlan]

Syntax Description agingtime Keyword that specifies to set the period of time after which an entry is
removed from the table.
vlan (Optional) Number of the VLAN. This number is optional unless you are
setting CAM entries to dynamic, static, or permanent for a trunk port, or if
you are using the agingtime keyword.
agingtime Number of seconds (0 and 15 to 1000000 for the Catalyst 4000 family,
Catalyst 2948G, and Catalyst 2980G switches) that dynamic entries remain
in the table before being deleted. Setting aging time to 0 disables aging.
dynamic Keyword that specifies that entries are subject to aging.
static Keyword that specifies that entries are not subject to aging. Static
(nonpermanent) entries will remain in the table until the system is reset.
permanent Keyword that specifies that permanent entries are stored in NVRAM until
they are removed by the clear cam or clear config command.
unicast_mac MAC address of the destination host used for a unicast.
mod/port Number of the module and the port.
route_descr Route descriptor of the “next hop” relative to this switch. This variable is
entered as two hexadecimal bytes in the following format: 004F. Do not use
a “-” to separate the bytes.
multicast_mac MAC address of the destination host used for a multicast.
mod/ports... Number of the module and the ports.
filter Keyword to specify a traffic filter entry.

Defaults The default configuration has a local MAC address, spanning tree address (01-80-c2-00-00-00), and
CDP multicast address for destination port 1/3 (the supervisor engine). The default aging time for all
configured VLANs is 300 seconds.
The vlan variable is required when you configure the traffic filter entry.
Setting the aging time to 0 disables aging.

Command Types Switch command.

Command Modes Privileged.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-155
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set cam

Usage Guidelines If the given MAC address is a multicast address (the least significant bit of the most significant byte is
set to 1) or broadcast address (ff-ff-ff-ff-ff-ff) and you specify multiple ports, the ports must all be in the
same VLAN. If the given address is a unicast address and you specify multiple ports, the ports must be
in different VLANs.
The MSM does not support the set cam command.
If you enter a route descriptor with no VLAN parameter specified, the default is the VLAN already
associated with the port. If you enter a route descriptor, you may only use a single port number (of the
associated port).
The MAC address and VLAN for a host can be stored in the NVRAM it is maintained even after a reset.
The vlan number is optional unless you are setting CAM entries to dynamic, static, or permanent for a
trunk port, or if you are using the agingtime keyword.
If port(s) are trunk ports, you must specify the VLAN.
Static (nonpermanent) entries remain in the table until you reset the active supervisor engine.
Enter the route_descr variable as two hexadecimal bytes in the following format: 004F. Do not use a “-”
to separate the bytes.
The minimum configurable non-zero agetime for the Catalyst 4000 family, 2948G, and 2980G switches
is 15 seconds. You cannot configure an agetime between 1 and 15 seconds.

Examples This example shows how to set the CAM table aging time for VLAN 1 to 300 seconds:
Console> (enable) set cam agingtime 1 300
Vlan 1 CAM aging time set to 300 seconds.
Console> (enable)

This example shows how to add a static unicast entry to the table for module 2, port 9:
Console> (enable) set cam static 00-00-0c-a0-03-fa 2/9
Static unicast entry added to CAM table.
Console> (enable)

This example shows how to add a permanent multicast entry to the table for a group of ports:
Console> (enable) set cam permanent 01-40-0b-a0-03-fa 1/1,2/1,2/3,2/8-12
Permanent multicast entry added to CAM table.
Console> (enable)

This example shows how to add a traffic filter entry to the table:
Console> (enable) set cam static filter 00-02-03-04-05-06 1
Filter entry added to CAM table.
Console> (enable)

This example shows how to add a filter for a specific MAC address:
Console> (enable) set cam static filter 00-02-03-04-05-06 1
Filter entry added to CAM table.
Console> (enable)

Related Commands clear cam

show cam

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-156 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set cdp

set cdp
Use the set cdp command to enable or disable the Cisco Discovery Protocol (CDP) globally or on
specified ports, and to configure the CDP hold time.

set cdp {enable | disable} [mod/ports...]

Syntax Description enable Keyword that specifies to enable the CDP feature.
disable Keyword that specifies to disable the CDP feature.
mod/ports... (Optional) Number of the module and ports.

Defaults By default, the system configuration has CDP enabled; the message interval is set to 60 seconds for
every port.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you enter the global set cdp enable or disable command, CDP is globally configured. If CDP is
globally disabled, CDP is automatically disabled on all ports, but the per-port enable (or disable)
configuration is not changed. If CDP is globally enabled, whether CDP is running on a port or not
depends on its per-port configuration.
If you configure CDP on a per-port basis, the mod/ports... can be entered as a single module and port or
a range of ports; for example, 2/1-12,3/5-12.

Examples This example shows how to enable the CDP globally:

Console> (enable) set cdp enable
CDP enabled globally
Console> (enable) 2000 Jun 02 08:46:49 %TAC-2-NOADDR:No TACACS server defined

This example shows how to enable the CDP on port 1 on module 2:

Console> (enable) set cdp enable 2/1
CDP enabled on port 2/1.
Console> (enable)

This example shows how to disable CDP globally:

Console> (enable) set cdp disable
CDP disabled globally
Console> (enable) 2000 Jun 02 08:46:57 %TAC-2-NOADDR:No TACACS server defined

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-157
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set cdp

This example shows how to disable the CDP message display for port 1 on module 2:
Console> (enable) set cdp disable 2/1
CDP disabled on port 2/1.
Console> (enable)

Related Commands show cdp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-158 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set cdp holdtime

set cdp holdtime

Use the set cdp holdtime command to configure the Cisco Discovery Protocol (CDP) hold time.

set cdp holdtime holdtime

Syntax Description holdtime Number of seconds for the global CDP hold time value. Valid values are 10
to 255 seconds.

Defaults By default, the CDP holdtime interval is set to 180 seconds.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to set the global CDP holdtime value to 200 seconds:
Console> (enable) set cdp 200
CDP holdtime set to 200 seconds.
Console> (enable)

Related Commands show cdp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-159
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set cdp interval

set cdp interval

Use the set cdp interval command to globally set the message interval for the Cisco Discovery Protocol
(CDP).

set cdp interval interval

Syntax Description interval Number of seconds the system waits between CDP message
transmissions. Valid values are 5 to 900 seconds

Defaults By default, the message interval is set to 60 seconds.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to set the CDP message interval to 100 seconds:
Console> (enable) set cdp interval 100
CDP message interval set to 100 seconds for all ports.
Console> (enable)

Related Commands set cdp

show cdp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-160 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set cdp version

set cdp version

Use the set cdp version command to set the version of the Cisco Discovery Protocol (CDP) to run on
the switch.

set cdp version {v1 | v2}

Syntax Description v1 | v2 Keywords that specify the version of CDP.

Defaults By default, the CDP version is v2.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to set the CDP to version 1:

Console> (enable) set cdp version v1
CDP version set to v1
Console> (enable)

Related Commands set cdp

show cdp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-161
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set cgmp

set cgmp
Use the set cgmp command to enable or disable Cisco Group Management Protocol (CGMP) on the
switch.

set cgmp {enable | disable}

Syntax Description enable Keyword that specifies to enable CGMP on the switch.
disable Keyword that specifies to disable CGMP on the switch.

Defaults By default, CGMP is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines CGMP requires that you connect the switch to a router running CGMP.

Examples This example shows how to enable CGMP on a device:

Console> (enable) set cgmp enable
CMGP support for IP multicast enabled.
Console> (enable)

This example shows how to disable CGMP on a device:

Console> (enable) set cgmp disable
CMGP support for IP multicast disabled.
Console> (enable)

This example shows what happens if you try to enable CGMP if IGMP snooping is already enabled:
Console> (enable) set cgmp enable
Disable IGMP Snooping feature to enable CGMP.
Console> (enable)

Related Commands clear multicast router

set multicast router
show multicast group
show multicast group count

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-162 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set cgmp leave

set cgmp leave

Use the set cgmp leave command to enable or disable Cisco Group Management Protocol (CGMP) leave
processing.

set cgmp leave {enable | disable}

Syntax Description enable Keyword that specifies to enable CGMP leave processing.
disable Keyword that specifies to disable CGMP leave processing.

Defaults By default, CGMP leave processing is disabled.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to enable CGMP leave processing:

Console> (enable) set cgmp leave enable
CMGP support for leave processing enabled.
Console> (enable)

This example shows how to disable CGMP leave processing:

Console> (enable) set cgmp leave disable
CMGP support for leave processing disabled.
Console> (enable)

Related Commands clear multicast router

set multicast router
show cgmp statistics
show multicast group
show multicast group count

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-163
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set channel cost

set channel cost

Use the set channel cost command to set the spanningtree port cost for an EtherChannel port bundle.

set channel cost {channel_id | all} [cost]

Syntax Description channel_id EtherChannel ID of the channel to modify.

all Keyword that specifies all EtherChannel port bundles on the switch.
cost (Optional) Spanning tree port cost to apply to the EtherChannel.

Defaults By default, the spanning tree port cost is calculated automatically, based on the current port costs of the
ports in the EtherChannel.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines To determine the channel_id of an EtherChannel port bundle, use the show channel command.
If you do not specify the cost, the spanning tree port cost is updated based on the current port costs of
the channeling ports. If you change the channel port cost, the port costs of member ports in the channel
are modified to reflect the new cost. A message appears listing the ports whose port costs were changed.

Examples This example shows how to set the channel 768 path cost to 23:
Console> (enable) set channel cost 768 23
Port(s) 1/1-2,7/3,7/5 port path cost are updated to 60.
Channel 768 cost is set to 23.
Warning:channel cost may not be applicable if channel is broken.
Console> (enable)

This example shows how to set all channel path costs to 15:
Console> (enable) set channel cost all 15
Port(s) 4/1-4 port path cost are updated to 39.
Channel 768 cost is set to 15.
Warning:channel cost may not be applicable if channel is broken.
Console> (enable)

Related Commands set channel vlancost

set port channel
show channel
show channel group
show port channel
set spantree portcost

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-164 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set channel vlancost

set channel vlancost

Use the set channel vlancost command to set the spanning tree port-VLAN cost for an EtherChannel
port bundle.

set channel vlancost channel_id [cost]

Syntax Description channel_id EtherChannel ID of the channel to modify.

cost (Optional) Spanning tree port-VLAN cost to apply to the
EtherChannel.

Defaults By default, the spanning tree port-VLAN cost is calculated automatically, based on the current
port-VLAN costs of the ports in the EtherChannel.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You can configure the port-VLAN cost of only one EtherChannel at a time.
To determine the channel_id of an EtherChannel port bundle, use the show channel command.
If you do not specify the cost, the spanning tree port-VLAN cost is updated based on the current
port-VLAN costs of the channeling ports. If you change the channel port-VLAN cost, the port-VLAN
costs of member ports in the channel are modified to reflect the new cost. A message appears listing the
ports whose port-VLAN costs were changed.

Examples This example shows how to set the channel 768 port-VLAN cost to 10:
Console> (enable) set channel vlancost 768 10
Port(s) 1/1-2 vlan cost are updated to 24.
Channel 768 vlancost is set to 10.
Console> (enable)

Related Commands set channel cost

set port channel
show channel
show channel group
show port channel
set spantree portvlancost

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-165
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set config mode

set config mode

Use the set config mode command to change the configuration mode from a binary model to a text
model.

set config mode binary

set config mode text {nvram | device:file-id}

Syntax Description binary Keyword that specifies to set the system configuration mode to a binary
model.
text Keyword that specifies to set the system configuration mode to a text model.
nvram Keyword that specifies the saved configuration be stored in NVRAM.
device:file-id Name of the device and filename where the saved configuration will be
stored.

Defaults By default, the setting for this command is binary, which will save the configuration to NVRAM when
the write memory command is used.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines When you configure the system to use text file configuration mode the system stores its configuration
as a text file in non-volatile storage, either in NVRAM or FLASH memory. The text file consists of
commands entered by you to configure various features. For example, if you disable a port the command
to disable that port will be in the text configuration file.
The text file only contains commands you have used to configure your switch. Because the text
configuration file in most cases requires less space NVRAM is a good place for the file to be stored. If
the text file exceeds NVRAM space, it can also be stored to FLASH memory.
User settings are not immediately saved to NVRAM. To save user settings you must enter the write
memory command to store the configuration in non-volatile storage.

Examples This example shows how to set the configuration mode to binary:
Console> (enable) set config mode binary
System configuration copied to NVRAM. Configuration mode set to binary.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-166 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set config mode

This example shows how to set the configuration mode to text and designate the location and filename
for saving the text configuration file:
Console> (enable) set config mode text bootflash:switch.cfg
Binary system configuration has been deleted from NVRAM. Configuration mode set to text.
Use the write memory command to save configuration changes. System configuration file set
to: bootflash:switch.cfg
The file specified will be used for configuration during the next bootup.
Console> (enable)

Related Commands show config mode

write memory

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-167
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set crypto key rsa

set crypto key rsa

Use the set crypto key rsa command to generate and configure an RSA key pair.

set crypto key rsa nbits [force]

Syntax Description nbits Size of the key. Valid values are 512 to 2048 bits.
force (Optional) Keyword to regenerate the keys and suppress the warning
prompt of overwriting existing keys.

Defaults By default, the key size is 1024.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you do not enter the force keyword, the set crypto key command is saved into the configuration file,
and you will have to use the clear config all command to clear the RSA keys.
To support SSH login, you first must generate an RSA key pair.

Examples This example shows how to create an RSA key pair with a size of 1004 bits:
Console> (enable) set crypto key rsa 1004
Generating RSA keys.... [OK]
Console> (enable)

Related Commands clear crypto key rsa

show crypto key

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-168 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set dot1q-all-tagged

set dot1q-all-tagged
Use the set dot1q-all-tagged command to change all existing and new dot1q trunks to the dot1q-only
mode.

set dot1q-all-tagged {enable | disable} [all]

Syntax Description enable Keyword to enable dot1q-tagged-only mode.

disable Keyword to disable dot1q-tagged-only mode.
all (Optional) Keyword to specify dot1q tagging for all ports.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines When you enable the dot1q-tagged-only mode, all data packets are sent out tagged, and all received
untagged data packets are dropped on all 802.1q trunks.
You cannot enable the dot1q tunneling feature on a port until dot1q-tagged-only mode is enabled.
You cannot disable dot1q-tagged-only mode on the switch until dot1q tunneling is disabled on all the
ports on the switch.
The optional all keyword is not supported.

Examples This example shows how to enable dot1q tagging:

Console> (enable) set dot1q-all-tagged enable
Dot1q tagging is enabled
Console> (enable)

This example shows how to disable dot1q tagging:

Console> (enable) set dot1q-all-tagged disable
Dot1q tagging is disabled
Console> (enable)

Related Commands show dot1q-all-tagged

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-169
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set dot1x

set dot1x
Use the set dot1x command set to configure dot1x on a system.

set dot1x {system-auth-control {enable | disable}

set dot1x {quiet-period | tx-period | re-authperiod} seconds

set dot1x {supptimeout | servertimeout} seconds

set dot1x maxreq count

Syntax Description system-auth-control Keyword to specify authentication for the system.

enable Keyword to enable the specified dot1x function.
disable Keyword to disable the specified dot1x function.
quiet-period seconds Keyword to specify the idle time between authentication attempts;
valid values are from 0 to 65535 seconds.
tx-period seconds Keyword to specify the time for the retransmission of
EAP-Request/Identity frame; valid values are from 0 to 65535 seconds.
See the “Usage Guidelines” section for additional information.
re-authperiod seconds Keyword and variable to specify the time constant for the
retransmission reauthentication time; valid values are from 1 to
65535 seconds.
supp-timeout seconds Keyword and variable to specify the time constant for the
retransmission of EAP-Request packets; valid values are from 0 to
65535 seconds. See the “Usage Guidelines” section for additional
information.
server-timeout Keyword and variable to specify the time constant for the
seconds retransmission of packets by the backend authenticator to the
authentication server; valid values are from 1 to 65535 seconds. See
the “Usage Guidelines” section for additional information.
max-req count Keyword and variable to specify the maximum number of times that
the state machine retransmits an EAP-Request frame to the supplicant
before it times out the authentication session; valid values are from 1
to 10.

Defaults The default settings are as follows:

• system-auth-control is enabled.
• quiet-period is 60 seconds.
• tx-period is 30 seconds.
• re-authperiod is 3,600 seconds.
• supptimeout is 30 seconds.
• servertimeout is 30 seconds.
• maxreq count is 2.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-170 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set dot1x

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines When you set the system-auth-control, the following applies:
• The enable keyword allows you to control the authorization status for each port per the port-control
parameter that you set using the set port dot1x command.
• The disable keyword allows you to make all ports behave as though the port-control parameter is
set to force-authorized.
If you do not enable reauthentication, reauthentication does not automatically occur after authentication has
occurred.
When the supplicant does not notify the authenticator that it received the EAP-request/identity packet,
the authenticator waits a period of time (set by entering the tx-period seconds parameter), and then
retransmits the packet.
When the supplicant does not notify the backend authenticator that it received the EAP-request packet,
the backend authenticator waits a period of time (set by entering the supp-timeout seconds parameter),
and then retransmits the packet.
When the authentication server does not notify the backend authenticator that it received specific
packets, the backend authenticator waits a period of time (set by entering the server-timeout seconds
parameter), and then retransmits the packets.

Examples This example shows how to set the system authentication control:
Console> (enable) set dot1x system-auth-control enable
dot1x authorization enabled.
Console> (enable)

This example shows how to set the idle time between authentication attempts:
Console> (enable) set dot1x quiet-period 45
dot1x quiet-period set to 45 seconds.
Console> (enable)

This example shows how to set the retransmission time:

Console> (enable) set dot1x tx-period 15
dot1x tx-period set to 15 seconds.
Console> (enable)

This example shows you how to specify the reauthentication time:

Console> (enable) set dot1x re-authperiod 7200
dot1x re-authperiod set to 7200 seconds
Console> (enable)

This example shows you how to specify the retransmission of EAP-Request packets by the authenticator to
the supplicant:
Console> (enable) set dot1x supp-timeout 15
dot1x supp-timeout set to 15 seconds.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-171
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set dot1x

This example shows how to specify the retransmission of packets by the backend authenticator to the
authentication server:
Console> (enable) set dot1x server-timeout 15
dot1x server-timeout set to 15 seconds.
Console> (enable)

This example shows how to specify the maximum number of packet retransmissions:
Console> (enable) set dot1x max-req 5
dot1x max-req set to 5.
Console> (enable)

Related Commands clear dot1x config

set port dot1x
show dot1x
show port dot1x

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-172 78-12648-03
 2
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set enablepass

set enablepass
Use the set enablepass command to change the privileged (enable) mode password on the switch.

set enablepass

Syntax Description This command has no arguments or keywords.

Defaults By default, no enable password is configured.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines Passwords are case sensitive; they may be 0 to 30 characters in length, including spaces.
The command prompts you for the old password. If the password you enter is valid, you are prompted
to enter a new password and to verify the new password.

Examples This example shows how to establish a new password:

Console> (enable) set enablepass
Enter old password: <old_password>
Enter new password: <new_password>
Retype new password: <new_password>
Password changed.
Console> (enable)

Related Commands enable

set password

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-173
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set errdisable-timeout

set errdisable-timeout
Use the set errdisable-timeout command to configure a timeout for ports that are in the errdisable state
to automatically reenable them.

set errdisable-timeout {enable | disable} {reason}

set errdisable-timeout interval {interval}

Syntax Description enable Keyword to enable errdisable timeout.

disable Keyword to disable errdisable timeout.
reason Reason for the port being in the errdisable state. Valid values are bpdu-guard,
channel-misconfig, duplex-mismatch, udld, other, and all.
interval Timeout interval. Valid values are 30 to 86,400 seconds (30 seconds to 24 hours).
interval

Defaults The default is disable, and the interval is 300 seconds.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines These events can set a port to errdisable state:

• Channel misconfiguration
• Duplex mismatch
• BPDU port-guard
• UDLD
• Other
Ports that are in errdisable state due to a cause other than a channel misconfiguration, duplex mismatch,
BPDU port-guard, or UDLD will have an errdisable cause of Other. If you enter other, the ports are in
an errdisable timeout.

Examples This example shows how to enable an errdisable timeout due to a BPDU port-guard event:
Console> (enable) set errdisable-timeout enable bpdu-guard
Successfully enabled errdisable-timeout for bpdu-guard.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-174 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set errdisable-timeout

This example shows how to set an errdisable timeout interval to 450 seconds:
Console> (enable) set errdisable-timeout interval 450
Successfully set errdisable timeout to 450 seconds.
Console> (enable)

Related Commands show errdisable-timeout

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-175
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set errordetection

set errordetection
Use the set errordetection command to enable or disable detection of various errors.

set errordetection inband {enable | disable}

set errordetection memory {enable | disable}

Syntax Description inband Keyword to specify in-band error detection.

enable Keyword to enable the specified error detection.
disable Keyword to disable the specified error detection.
memory Keyword to specify memory error detection.

Defaults The defaults are memory and inband error detection disabled.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to enable memory error detection:

Console> (enable) set errordetection memory enable
Memory error detection enabled.
Console> (enable)

Related Commands show errordetection

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-176 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set feature mdg

set feature mdg

Use the set feature mdg command to enable or disable the Multiple Default Gateway feature.

set feature mdg {enable | disable}

Syntax Description enable Keyword that enables multiple default gateway feature on the
switch.
disable Keyword that disables multiple default gateway feature on the
switch.

Defaults By default, Multiple Default Gateway (MDG) is enabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If the MDG feature is enabled, the switch will ping its default gateways every ten seconds to verify that
they are available.

Examples This example shows how to enable the MDG feature:

Console> (enable) set feature mdg enable
Multiple Default Gateway feature enabled.
Console> (enable)

This example shows how to disable the MDG feature:

Console> (enable) set feature mdg disable
Multiple Default Gateway feature disabled.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-177
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set garp timer

set garp timer

Use the set garp timer command to adjust the values of the join, leave, and leaveall timers.

set garp timer timer_type timer_value

Syntax Description timer_type Type of timer. Valid values are join, leave, and leaveall.
timer_value Timer value in milliseconds. Valid values are 1 to 2,147,483,647
milliseconds.

Defaults By default, the join timer is 200 ms; the leave timer is 600 ms; the leaveall timer is
10000 ms.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You must maintain the following initial relationships for the various timer values:
• Leave time must be greater than twice the join time
• Leaveall time must be greater than the leave time

Note The modified values of timers are applied to all GARP applications, ports, and VLANs on the switch.

Examples This example shows how to set the join timer value to 100 ms for all the ports on all the VLANs:
Console> (enable) set garp timer join 100
GMRP/GARP Join timer value is set to 100 milliseconds.
Console> (enable)

This example shows how to set the leave timer value to 300 ms for all the ports on all the VLANs:
Console> (enable) set garp timer leave 300
GMRP/GARP Leave timer value is set to 300 milliseconds.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-178 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set garp timer

This example shows how to set the leaveall timer value to 20000 ms for all the ports on all the VLANs:
Console> (enable) set garp timer leaveall 20000
GMRP/GARP LeaveAll timer value is set to 20000 milliseconds.
Console> (enable)
Related Coins

Related Commands set gmrp timer

set gvrp timer
show gmrp configuration
show gvrp configuration

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-179
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set gmrp

set gmrp
Use the set gmrp command to enable or disable GARP Multicast Registration Protocol (GMRP) on the
switch in all VLANs on all ports.

set gmrp {enable | disable}

Syntax Description enable Keyword that specifies to enable GMRP on the switch.
disable Keyword that specifies to disable GMRP on the switch.

Defaults By default, GMRP is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You cannot enable GMRP if IGMP snooping or CGMP is already enabled.

Examples This example shows how to enable GMRP on the switch:

Console> (enable) set gmrp enable
GMRP is enabled.
Console> (enable)

This example shows how to disable GMRP on the switch:

Console> (enable) set gmrp disable
GMRP is disabled.
Console> (enable)

This example shows the display if you try to enable GMRP on the switch with IGMP enabled:
Console> (enable) set gmrp enable
Disable IGMP to enable GMRP snooping feature.
Console> (enable)

Related Commands show gmrp configuration

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-180 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set gmrp fwdall

set gmrp fwdall

Use the set gmrp fwdall command to enable or disable the Forward All option on a specified port or
module and port list.

set gmrp fwdall {enable | disable} mod/port...

Syntax Description enable Keyword that enables GARP Multicast Registration Protocol
(GMRP) Forward All on a specified port.
disable Keyword that disables GMRP Forward All on a specified port.
mod/port... Module number and port number list.

Defaults By default, the Forward All option is disabled on all ports.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines When you enable the Forward All option on a port, that port receives all traffic for all multicast groups
on the switch.
If you enable the Forward All option on a trunk port, the option is applied to all VLANs carried on that
trunk port.

Examples This example shows how to enable GMRP Forward All on module 5, port 5:
Console> (enable) set gmrp fwdall enable 5/5
GMRP Forward All groups option enabled on port(s) 5/5.
Console> (enable)

This example shows how to disable the GMRP Forward All on module 3, port 2:
Console> (enable) set gmrp service fwdall disable 3/2
GMRP Forward All groups option disabled on port(s) 3/2.
Console> (enable)

Related Commands show gmrp configuration

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-181
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set gmrp registration

set gmrp registration

Use the set gmrp registration command to specify the GARP Multicast Registration Protocol (GMRP)
registration type.

set gmrp registration registration-type mod/port...

Syntax Description registration-type Type of registration. Valid values are normal, fixed, or forbidden.
mod/port... Module number and port number list.

Defaults By default, normal registration is enabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you enter a registration-type of normal, dynamic creation, registration, and deregistration of VLANs
are supported.
If you enter a registration-type of fixed, manual VLAN creation and registration, prevention of VLAN
deregistration, and registration of all VLANs known to other ports when the set gvrp registration fixed
command is issued are supported.
If you enter a registration-type of forbidden, deregistration of all VLANs (except VLAN 1) and
prevention of any further VLAN creation or registration are supported.
GMRP supports 100 multicast addresses per VLAN and a total of 3072 for the whole switch.

Examples This example shows how to set the registration type to fixed on module 3, port 3:
Console> (enable) set gmrp registration fixed 3/3
GMRP Registration is set to Fixed for port(s) 3/3.
Console> (enable)

This example shows how to set the registration type to forbidden on module 1, port 1:
Console> (enable) set gmrp registration forbidden 1/1
GMRP Registration is set to Forbidden for port(s) 1/1.
Console> (enable)

Related Commands show gmrp configuration

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-182 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set gmrp timer

set gmrp timer

Use the set gmrp timer command to adjust the values of the join, leave, and leaveall timers.

set gmrp timer timer-type timer-value

Syntax Description timer-type Type of timer. Valid values are join, leave, and leaveall.
timer-value Timer value in milliseconds. Valid values are 1 to 2,147,483,647
milliseconds.

Defaults By default, the join timer is 200 ms; the leave timer is 600 ms; the leaveall timer is 10000 ms.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You must maintain the following relationships for the various timer values:
• Leave time must be greater than twice the join time
• Leaveall time must be greater than the leave time

Note The modified values of timers are applied to all the GARP applications, ports, and VLANs on the
switch.

Examples This example shows how to set the join timer value to 100 ms for all the ports on all the VLANs:
Console> (enable) set gmrp timer join 100
GARP Join timer value is set to 100 milliseconds.
Console> (enable)

This example shows how to set the leave timer value to 300 ms for all the ports on all the VLANs:
Console> (enable) set gmrp timer leave 300
GARP Leave timer value is set to 300 milliseconds.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-183
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set gmrp timer

This example shows how to set the leaveall timer value to 20000 ms for all the ports on all the VLANs:
Console> (enable) set gmrp timer leaveall 20000
GARP LeaveAll timer value is set to 20000 milliseconds.
Console> (enable)

Related Commands set garp timer

set gvrp timer
show gmrp timer

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-184 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set gvrp

set gvrp
Use the set gvrp command to enable or disable GARP VLAN Registration Protocol (GVRP) globally
on the switch.

set gvrp {enable | disable}

Syntax Description enable Keyword that specifies to enable GVRP on the switch.
disable Keyword that specifies to disable GVRP on the switch.

Defaults By default, GVRP is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines To run GVRP on a trunk, enable GVRP globally on the switch and individually on the trunk.
When VTP pruning is enabled, VTP pruning runs on all the GVRP-disabled trunks.

Examples This example shows how to enable GVRP globally on the switch:
Console> (enable) set gvrp enable
GVRP enabled.
Console> (enable)

This example shows how to disable GVRP:

Console> (enable) set gvrp disable
GVRP disabled.
Console> (enable)

This example shows how to enable GVRP on module 2, port 1:

Console> (enable) set gvrp enable 2/1
GVRP enabled on port 2/1.
Console> (enable)

Related Commands set garp timer

set gvrp timer
show gvrp configuration
show gvrp statistics

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-185
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set gvrp applicant

set gvrp applicant

Use the set gvrp applicant command to specify if a VLAN is declared out of blocking ports.

set gvrp applicant {normal | active} mod/port...

Syntax Description normal Keyword that specifies to disallow the declaration of any VLAN out of
blocking ports.
active Keyword that specifies to allow the declaration of active VLANs out of
blocking ports.
mod/port... Module number and port number list.

Defaults By default, the GVRP applicant is set to normal.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines To run GVRP on a trunk, GVRP needs to be enabled both globally on the switch and enabled individually
on the trunk.
To prevent undesirable STP topology reconfiguration on a port connected to a device that does not
support the per-VLAN mode of STP, configure the GVRP applicant state to active on the port. Ports in
the GVRP active applicant state send GVRP VLAN declarations when they are in the STP blocking
state, which prevents the STP BPDUs from being pruned from the other port.

Note Configuring fixed registration on the other device’s port also prevents undesirable STP topology
reconfiguration.

Examples This example shows how to enforce the declaration of all active VLANs out of specified blocking ports:
Console> (enable) set gvrp applicant active 4/2-3,4/9-10,4/12-24
Applicant was set to active on port(s) 4/2-3,4/9-10,4/12-24.
Console> (enable)

This example shows how to disallow the declaration of any VLAN out of specified blocking ports:
Console> (enable) set gvrp applicant normal 4/2-3,4/9-10,4/12-24
Applicant was set to normal on port(s) 4/2-3,4/9-10,4/12-24.
Console> (enable)

Related Commands show gvrp configuration

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-186 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set gvrp dynamic-vlan-creation

set gvrp dynamic-vlan-creation

Use the set gvrp dynamic-vlan-creation command to enable or disable GARP VLAN Registration
Protocol (GVRP) dynamic VLAN creation.

set gvrp dynamic-vlan-creation {enable | disable}

Syntax Description enable Keyword that specifies to enable dynamic VLAN creation.
disable Keyword that specifies to disable dynamic VLAN creation.

Defaults By default, dynamic VLAN creation is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You can enable dynamic VLAN creation only when VTP is in transparent mode and no ISL trunks exist
in the switch.
You cannot use this command when there are any 802.1q trunks that are not configured with GVRP.

Examples This example shows how to enable dynamic VLAN creation:

Console> (enable) set gvrp dynamic-vlan-creation enable
Dynamic VLAN creation enabled.
Console> (enable)

This example shows what happens if you try to enable dynamic VLAN creation and VTP is not in
transparent mode:
Console> (enable) set gvrp dynamic-vlan-creation enable
VTP has to be in TRANSPARENT mode to enable this feature.
Console> (enable)

This example shows how to disable dynamic VLAN creation:

Console> (enable) set gvrp dynamic-vlan-creation disable
Dynamic VLAN creation disabled.
Console> (enable)

Related Commands set vtp

show gvrp configuration

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-187
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set gvrp registration

set gvrp registration

Use the set gvrp registration command to set the administrative control of an outbound port. GVRP
registration commands are entered on a per-port basis and apply to all VLANs on the trunk.

set gvrp registration {normal | fixed | forbidden} mod/port...

Syntax Description normal Keyword that specifies to allow dynamic registering and
deregistering each VLAN (except VLAN 1) on the port.
fixed Keyword that specifies to support manual VLAN creation and
registration, prevent VLAN deregistration, and register all VLANs
known to other ports.
forbidden Keyword that specifies that all the VLANs (except VLAN 1) are
statically deregistered from the port.
mod/port... Module number and port number list.

Defaults By default, administrative control is normal.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines When you set VLAN registration, you are indicating to the switch that the VLAN is interested in the
users connecting to this port and the VLAN’s broadcast and multicast traffic is allowed to send to
the port.
For static VLAN configuration, you should set the mod/port... control to fixed or forbidden if the
mod/port... will not receive or process any GVRP message.
For each dynamically configured VLAN on a port, you should set the mod/port... control to normal
(default), except for VLAN 1; VLAN 1 should be set to fixed.
When GVRP is running, you can create a VLAN through a GVRP trunk port only if you enter the set
gvrp dynamic-vlan-creation enable and the set gvrp registration normal commands.

Examples This example shows how to set the administrative control to normal on module 3, port 7:
Console> (enable) set gvrp registration normal 3/7
Registrar Administrative Control set to normal on port 3/7.
Console> (enable)

This example shows how to set the administrative control to fixed on module 5, port 10:
Console> (enable) set gvrp registration fixed 5/10
Registrar Administrative Control set to fixed on port 5/10.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-188 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set gvrp registration

This example shows how to set the administrative control to forbidden on module 5, port 2:
Console> (enable) set gvrp registration forbidden 5/2
Registrar Administrative Control set to forbidden on port 5/2.
Console> (enable)

Related Commands show gvrp configuration

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-189
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set gvrp timer

set gvrp timer

Use the set gvrp timer command to adjust the values of the join, leave, and leaveall timers.

set gvrp timer {timer-type} {timer-value}

Syntax Description timer-type Type of timer. Valid values are join, leave, and leaveall.
timer-value Timer value in milliseconds. Valid values are 1 to 2,147,483,647
milliseconds.

Defaults By default, the join timer is 200 ms; the leave timer is 600 ms; the leaveall timer is 10000 ms.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines This command is equivalent to the set garp timer command.
You must maintain the following relationships for the various timer values:
• Leave time must be greater than twice the join time
• Leaveall time must be greater than the leave time

Note The modified values of timers are applied to all the GARP applications, ports, and VLANs.

Examples This example shows how to set the join timer value to 100 ms for all the ports on all the VLANs:
Console> (enable) set gvrp timer join 100
GVRP/GARP Join timer value is set to 100 milliseconds.
Console> (enable)

This example shows how to set the leave timer value to 300 ms for all the ports on all the VLANs:
Console> (enable) set gvrp timer leave 300
GVRP/GARP Leave timer value is set to 300 milliseconds.
Console> (enable)

This example shows how to set the leaveall timer value to 20,000 ms for all the ports on all the VLANs:
Console> (enable) set gvrp timer leaveall 20000
GVRP/GARP LeaveAll timer value is set to 20000 milliseconds.
Console> (enable)

Related Commands set garp timer

show gvrp configuration

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-190 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set inlinepower defaultallocation

set inlinepower defaultallocation

Use the set inlinepower defaultallocation command to set the default power allocation for a port.

set inlinepower defaultallocation value

Syntax Description value Default power allocation. Valid values are from 2000 to 12500 mW.

Defaults By default, the power allocation is 10000 mW.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to set the default power allocation to 2000 mW:
Console> (enable) set inlinepower defaultallocation 2000
Default inline power allocation set to 9500 mWatt per applicable port.
Console> (enable)

Related Commands show environment

show port inlinepower

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-191
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set interface

set interface
Use the set interface command to set the network interface configuration and to enable or disable
standard SNMP trap operation.

set interface {sc0 | me1 | sl0} {up | down}

set interface sc0 [vlan] [ip_addr [netmask [broadcast]]]

set interface sc0 [vlan] [ip_addr/netmask [broadcast]]

set interface me1 ip_addr [netmask [broadcast]]

set interface me1 ip_addr/netmask [broadcast]

set interface sl0 slip_addr dest_addr

set interface sc0 dhcp {renew | release}

Syntax Description sc0 Keyword that specifies the in-band management interface.
me1 Keyword that specifies the out-of-band management Ethernet interface.
sl0 Keyword that specifies the SLIP interface.
up Keyword that specifies to bring the interface into operation.
down Keyword that specifies to bring the interface out of operation.
vlan (Optional) Number of the VLAN to be assigned to the interface.
ip_addr (Optional) IP address to assign to the interface.
netmask (Optional) Subnet mask or mask bits to assign to the interface.
broadcast (Optional) Broadcast address to assign to the interface.
slip_addr SLIP source address of the console port.
dest_addr SLIP destination address of the host to which the console port will be
connected.
dhcp Keyword that specifies to perform DHCP operations on the sc0 interface.
renew Keyword that specifies to renew the lease on a DHCP-learned IP address.
release Keyword that specifies to release a DHCP-learned IP address back to the
DHCP IP address pool.

Defaults The default configuration has the IP address, subnet mask, and broadcast address of the in-band
management interface (sc0) and out-of-band management Ethernet interface (me1) set to 0.0.0.0, with
the sc0 interface in VLAN 1. The default configuration for the SLIP interface (sl0) is that the SLIP
source and destination addresses are set to 0.0.0.0.

Command Types Switch command.

Command Modes Privileged.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-192 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set interface

Usage Guidelines

Caution On the Catalyst 4000 family switches, when entering the set interface me1 or set interface trap
{sc0 | sl0 | me1} command, sc0 and me1 cannot be configured as up when both are in the same subnet
or overlapping subnets. If you specify an IP address and subnet for the sc0 or me1 interface that
causes an overlap, the me1 interface is kept up or brought up, and the sc0 interface is brought down.
The only exception is when both the me1 and sc0 interfaces have IP address 0.0.0.0. In this case, the
me1 interface is brought down and the sc0 interface is brought up to allow the DHCP and RARP to
run on the sc0 interface.

The Catalyst 4000 family switches support three IP management interfaces: sc0, sl0, and an out-of-band
management Ethernet interface (me1). The me1 interface is not attached to the switching fabric. If both
the sc0 and me1 interfaces are configured, the supervisor engine software determines which interface to
use when performing standard transmission and reception of IP packets based on the local routing table.
Operations that use this functionality include TFTP, ping, Telnet, and SNMP.
You can enter the netmask value in dotted decimal format or you can specify the number of bits in the
netmask (for example, 204.20.22.7/24).

Examples This example shows how to use set interface sc0 and set interface sl0 from the console port. It also
shows how to bring down interface sc0 using a terminal connected to the console port:
Console> (enable) set interface sc0 192.200.11.44 255.255.255.0
Interface sc0 IP address and netmask set.
Console> (enable) set interface sl0 192.200.10.45 192.200.10.103
Interface sl0 SLIP and destination address set.
Console> (enable) set interface sc0 down
Interface sc0 administratively down.
Console> (enable)

This example shows how to set the IP address for sc0. If you do not specify a subnet mask, the default
mask for that IP address class is used (for example, 255.255.0.0 for a class B address):
Console> (enable) set interface sc0 172.20.52.123
Interface sc0 IP address and netmask set.
Console> (enable)

This example shows how to set the VLAN, IP address, and subnet mask bits for the sc0 interface:
Console> (enable) set interface sc0 5 172.20.52.123/28
Interface sc0 vlan set, IP address and netmask set.
Console> (enable)

This example shows how to change the VLAN membership of the sc0 interface:
Console> (enable) set interface sc0 2
Interface sc0 vlan set.
Console> (enable)

This example shows how to take the sc0 interface down:

Console> (enable) set interface sc0 down
Interface sc0 administratively down.
Console> (enable)

This example shows how to bring the sc0 interface up:

Console> (enable) set interface sc0 up
Interface sc0 administratively up.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-193
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set interface

Console> (enable)

This example shows how to set the IP address and netmask for me1:
Console> (enable) set interface me1 10.10.10.20/24
Interface me1 IP address and netmask set.
Console> (enable)

This example shows how to set the SLIP source and destination addresses for the console port on the sl0
interface:
Console> (enable) set interface sl0 10.1.1.1 10.1.1.2
Interface sl0 slip and destination address set.
Console> (enable)

This example shows how to release a DHCP IP address assigned to the sc0 interface:
Console> (enable) set interface sc0 dhcp release

Console> (enable)

This example shows how to renew the lease on a DHCP IP address assigned to the sc0 interface:
Console> (enable) set interface sc0 dhcp release

Console> (enable)

This example shows how to release a DHCP IP address assigned to the sc0 interface and obtain a new
IP address from the DHCP server:
Console> (enable) set interface sc0 dhcp release

Console> (enable)

This example shows how to renew the lease on a DHCP-assigned IP address:

Console> (enable) set interface sc0 dhcp renew
Renewing IP address...
Console> (enable) Sending DHCP packet with address:00:90:0c:5a:8f:ff
dhcpoffer
Sending DHCP packet with address:00:90:0c:5a:8f:ff
Timezone set to '', offset from UTC is 7 hours 58 minutes
Timezone set to '', offset from UTC is 7 hours 58 minutes
172.16.30.32 added to DNS server table as primary server.
172.16.31.32 added to DNS server table as backup server.
172.16.32.32 added to DNS server table as backup server.
NTP server 172.16.25.253 added
NTP server 172.16.25.252 added
%MGMT-5-DHCP_S:Assigned IP address 172.20.25.244 from DHCP Server 172.20.25.254
Console> (enable)

This example shows how to release the lease on a DHCP-assigned IP address:

Console> (enable) set interface sc0 dhcp release
Releasing IP address...
Console> (enable) Sending DHCP packet with address:00:90:0c:5a:8f:ff
Done
Console> (enable)

Related Commands set interface trap

show interface—switch
slip

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-194 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set interface trap

set interface trap

Use the set interface trap command to enable or disable SNMP link-up or link-down traps on the switch
interfaces.

set interface trap {sc0 | me1 | sl0} {enable | disable}

Syntax Description sc0 Keyword that specifies the in-band management interface.
me1 Keyword that specifies the out-of-band management Ethernet interface.
sl0 Keyword that specifies the SLIP interface.
enable Keyword that specifies to enable the SNMP link up/down traps on the
specified interface.
disable Keyword that specifies to disable the SNMP link up/down traps on the
specified interface.

Defaults By default, SNMP link-up or link-down traps are disabled on all interfaces.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to enable SNMP link-up or link-down traps on the sc0 interface:
Console> (enable) set interface trap sc0 enable
Interface sc0 up/down trap enabled.
Console> (enable)

This example shows how to disable SNMP link-up or link-down traps on the sc0 interface:
Console> (enable) set interface trap sc0 disable
Interface sc0 up/down trap disabled.
Console> (enable)

Related Commands set interface

show interface—switch
slip

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-195
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ip alias

set ip alias
Use the set ip alias command to add aliases of IP addresses.

set ip alias name ip_addr

Syntax Description name Name of the alias being defined.

ip_addr IP address of the alias being defined.

Defaults By default, one IP alias, “default,” is mapped to the IP address 0.0.0.0.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines IP aliases take precedence over DNS hostnames.

Examples This example shows how to define an IP alias of mercury for IP address 192.168.255.255:
Console> (enable) set ip alias mercury 192.168.255.255
IP alias added.
Console> (enable)

Related Commands clear ip alias

show ip alias

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-196 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ip dns

set ip dns
Use the set ip dns command to enable or disable DNS.

set ip dns {enable | disable}

Syntax Description enable Keyword that specifies to enable DNS.

disable Keyword that specifies to disable DNS.

Defaults By default, DNS is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If DNS is disabled, you must use the IP address with all commands that require explicit IP addresses or
manually define an alias for that address. The alias has priority over DNS.

Examples This example shows how to enable DNS:

Console> (enable) set ip dns enable
DNS is enabled.
Console> (enable)

This example shows how to disable DNS:

Console> (enable) set ip dns disable
DNS is disabled.
Console> (enable)

Related Commands show ip dns

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-197
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ip dns domain

set ip dns domain

Use the set ip dns domain command to set the default DNS domain name.

set ip dns domain name

Syntax Description name Default DNS domain name.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you specify a domain name on the command line, the system attempts to resolve the host name as
entered. If the system cannot resolve the host name as entered, it appends the default DNS domain name
as defined with the set ip dns domain command. If you specify a domain name with a trailing dot, the
program considers this an absolute domain name.

Examples This example shows how to set the default DNS domain name as yow.com:
Console> (enable) set ip dns domain yow.com
Default DNS domain name set to yow.com.
Console> (enable)

Related Commands clear ip dns domain

show ip dns

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-198 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ip dns server

set ip dns server

Use the set ip dns server command to set the IP address of a DNS server.

set ip dns server ip_addr [primary]

Syntax Description ip_addr IP address of the DNS server.

primary (Optional) Keyword that specifies to configure a DNS server as the
primary server.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You can configure up to three DNS name servers as backup. You can also configure any DNS server as
the primary server. The primary server is queried first. If the primary server fails, the backup servers are
queried.

Examples These examples show how to set the IP address of a DNS server:
Console> (enable) set ip dns server 198.92.30.32
198.92.30.32 added to DNS server table as primary server.
Console> (enable)

Console> (enable) set ip dns server 171.69.2.132 primary

171.69.2.132 added to DNS server table as primary server.
Console> (enable)

Console> (enable) set ip dns server 171.69.2.143 primary

171.69.2.143 added to DNS server table as primary server.
Console> (enable)

This example shows what happens if you enter more than three DNS name servers as backup:
Console> (enable) set ip dns server 161.44.128.70
DNS server table is full. 161.44.128.70 not added to DNS server table.
Console> (enable)

Related Commands clear ip dns server

show ip dns

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-199
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ip fragmentation

set ip fragmentation
Use the set ip fragmentation command to enable or disable the fragmentation of IP packets bridged
between FDDI and Ethernet networks. Note that FDDI and Ethernet networks have different maximum
transmission units (MTUs).

set ip fragmentation {enable | disable}

Syntax Description enable Keyword that specifies to enable fragmentation for IP packets
bridged between FDDI and Ethernet networks.
disable Keyword that specifies to disable fragmentation for IP packets
bridged between FDDI and Ethernet networks.

Defaults By default, IP fragmentation is enabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If IP fragmentation is disabled, FDDI packets that exceed the Ethernet MTU are dropped if they are
being bridged to Ethernet on the switch.

Examples This example shows how to enable IP fragmentation:

Console> (enable) set ip fragmentation enable
Bridge IP fragmentation enabled.
Console> (enable)

This example shows how to disable IP fragmentation:

Console> (enable) set ip fragmentation disable
Bridge IP fragmentation disabled.
Console> (enable)

Related Commands show ip route—switch

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-200 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ip http port

set ip http port

Use the set ip http port command to configure the TCP port number for the HTTP server.

set ip http port {port_num} [default port_num]

Syntax Description port_num TCP port number. Valid values are from 1 to 65,535.
default port_num (Optional) Keyword and variable that specify the TCP default port
number. Valid values are from 80 to 65,535.

Defaults By default, the TCP port number is 80.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to set the IP HTTP port default:
Console> (enable) set ip http port default
HTTP TCP port number is set to 80.
Console> (enable)

This example shows how to set the IP HTTP port number:

Console> (enable) set ip http port 2398
HTTP TCP port number is set to 2398.
Console> (enable)

Related Commands set ip http server

show ip http

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-201
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ip http server

set ip http server

Use the set ip http server command to enable or disable the HTTP server.

set ip http server {enable | disable}

Syntax Description enable Keyword that enables the HTTP server.

disable Keyword that disables the HTTP server.

Defaults By default, the HTTP server is disabled.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to enable the HTTP server:

Console> (enable) set ip http server enable
HTTP server is enabled.
Console> (enable)

This example shows the system response when the HTTP server enable command is not supported:
Console> (enable) set ip http server enable
Feature not supported.
Console> (enable)

This example shows how to disable the HTTP server:

Console> (enable) set ip http server disable
HTTP server disabled.
Console> (enable)

Related Commands set ip http port

show ip http

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-202 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ip permit

set ip permit
Use the set ip permit command to enable or disable the IP permit list and to specify IP addresses to be
added to the IP permit list.

set ip permit {enable | disable} [telnet | ssh | snmp]

set ip permit ip_addr [mask] [telnet | ssh | snmp | all]

Syntax Description enable Keyword that specifies to enable the IP permit list.
disable Keyword that specifies to disable the IP permit list.
telnet (Optional) Telnet IP permit list.
ssh (Optional) SSH permit list.
snmp (Optional) SNMP IP permit list.
ip_addr IP address to be added to the IP permit list. An IP alias or host name
that can be resolved through DNS can also be used.
mask (Optional) Subnet mask of the specified IP address.
all (Optional) Keyword that specifies all entries in the IP permit list.

Defaults By default, the IP permit list is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You can configure up to 100 entries in the permit list. If the IP permit list is enabled, but the permit list
has no entries configured, a caution displays on the screen.
Make sure you enter the entire disable keyword when entering the set ip permit disable command. If
you abbreviate the keyword, the abbreviation is interpreted as a host name to add to the IP permit list.
If telnet, ssh, snmp, or all variables are not specified, the IP address is added to both the SNMP and
Telnet permit lists.
You enter the mask in dotted decimal format, for example, 255.255.0.0.

Examples This example shows how to add an IP address to the IP permit list:
Console> (enable) set ip permit 192.168.255.255
192.168.255.255 added to IP permit list.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-203
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ip permit

This example shows how to add an IP address using an IP alias or host name to both the SNMP and Telnet
permit lists:
Console> (enable) set ip permit batboy
batboy added to IP permit list.
Console> (enable)

This example shows how to add a subnet mask of the IP address to both the SNMP and Telnet permit
lists:
Console> (enable) set ip permit 192.168.255.255 255.255.192.0
192.168.255.255 with mask 255.255.192.0 added to IP permit list.
Console> (enable)

This example shows how to add an IP address to the Telnet IP permit list:
Console> (enable) set ip permit 172.16.0.0 255.255.0.0 telnet
172.16.0.0 with mask 255.255.0.0 added to telnet permit list.
Console> (enable)

This example shows how to add an IP address to the SNMP IP permit list:
Console> (enable) set ip permit 172.20.52.32 255.255.255.224 snmp
172.20.52.32 with mask 255.255.255.224 added to snmp permit list.
Console> (enable)

This example shows how to add an IP address to the all IP permit lists:
Console> (enable) set ip permit 172.20.52.3 all
172.20.52.3 added to IP permit list.
Console> (enable)

This example shows how to enable the IP permit list:

Console> (enable) set ip permit enable
IP permit list enabled.
Console> (enable)

This example shows how to disable the IP permit list:

Console> (enable) set ip permit disable
IP permit list disabled.
Console> (enable)

Related Commands clear ip permit

show ip permit

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-204 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ip redirect

set ip redirect
Use the set ip redirect command to enable or disable Internet Control Message Protocol (ICMP) redirect
messages.

set ip redirect {enable | disable}

Syntax Description enable Keyword that specifies to permit ICMP redirect messages to be
returned to the source host.
disable Keyword that specifies to prevent ICMP redirect messages from
being returned to the source host.

Defaults By default, ICMP redirect is enabled.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to deactivate ICMP redirect messages:

Console> (enable) set ip redirect disable
ICMP redirect messages disabled.
Console> (enable)

Related Commands show ip route—switch

show netstat

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-205
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ip route—ROM monitor

set ip route—ROM monitor

Use the set ip route command to set the default IP address or alias to the IP routing table.

set ip route default {ip_addr}

Syntax Description default Keyword that specifies the entry as a default route.
ip_addr IP address of the router.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Examples This example shows how to add the default route to the routing table:
rommon 1 > set ip route default 172.20.52.35
rommon 2 >

Related Commands clear ip route—ROM monitor

show ip route—ROM monitor

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-206 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ip route—switch

set ip route—switch
Use the set ip route command to add IP addresses or aliases to the IP routing table.

set ip route default gateway [metric] [primary]

set ip route destination[/netmask] gateway

Syntax Description default Keyword that specifies the entry as a default route.
gateway IP address or IP alias of the router.
metric (Optional) Value used to indicate the number of hops between the switch and
the gateway.
primary (Optional) Keyword that specifies the primary default route.
destination IP address or IP alias of the network, or IP address, DNS hostname, or IP
alias of a specific host to be added.
/netmask (Optional) Subnet mask or mask bits to assign to the interface.

Defaults By default, the local network is routed through the sc0 interface with metric 0 as soon as sc0 is
configured.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You can configure up to three default gateways. You can specify a primary default gateway using the
primary keyword. If a primary is not designated, the first default gateway you configure is the primary.
The switch forwards all off-network IP traffic generated by the switch itself to the primary default
gateway unless the primary is unavailable. The entries in the IP routing table are only used for IP traffic
generated by the switch itself (for example, Telnet, ping, or TFTP sessions from the switch CLI), not for
IP data travelling through the switch.
On the Catalyst 4000 family switches, the supervisor engine software automatically determines whether
a default gateway is reached through the sc0 interface or the me1 interface.
You can enter the destination and gateway as either an IP alias or IP address in dotted format (for
example, 172.20.52.7). You can enter the destination network mask in dotted decimal format or you can
specify the number of bits in the netmask (for example, 204.20.22.7/24). CIDR IP address and subnet
mask values are accepted for the destination network address.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-207
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ip route—switch

Examples This example shows how to add three default routes to the IP routing table:
Console> (enable) set ip route default 172.20.52.35
Route added.
Console> (enable) set ip route default 172.20.52.40
Route added.
Console> (enable) set ip route default 172.20.52.45
Route added.
Console> (enable)

This example shows how to add a route to network 10.10.0.0/16 through gateway 172.20.52.33:
Console> (enable) set ip route 10.10.0.0/16 172.20.52.33
Route added.
Console> (enable)

This example shows how to add a route to a specific host:

Console> (enable) set ip route 172.20.50.2/32 172.20.52.41
Route added.
Console> (enable)

Related Commands clear ip route—switch

show ip route—switch

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-208 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ip unreachable

set ip unreachable
Use the set ip unreachable command to enable or disable ICMP unreachable messages on the switch.

set ip unreachable {enable | disable}

Syntax Description enable Keyword that specifies to allow IP unreachable messages to be

returned to the source host.
disable Keyword that specifies to prevent IP unreachable messages from
being returned to the source host.

Defaults By default, ICMP unreachable messages are enabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines When you enable ICMP unreachable messages, the switch returns an ICMP unreachable message to the
source host whenever it receives an IP datagram that it cannot deliver. When you disable ICMP
unreachable messages, the switch does not notify the source host when it receives an IP datagram that it
cannot deliver.
For example, a switch has the ICMP unreachable message function enabled and IP fragmentation
disabled. If an FDDI frame is received and needs to transmit to an Ethernet port, the switch cannot
fragment the packet. The switch drops the packet and returns an IP unreachable message to the Internet
source host.

Examples This example shows how to disable ICMP unreachable messages:

Console> (enable) set ip unreachable disable
ICMP Unreachable message disabled.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-209
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set kerberos clients mandatory

set kerberos clients mandatory

Use the set kerberos clients mandatory command to use Kerberos client authentication to validate
other services on the network.

set kerberos clients mandatory

Syntax Description This command has no arguments or keywords.

Defaults By default, kerberos clients are not set to mandatory.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines As an added layer of security, you can optionally configure the switch so that after users authenticate to
it, they can authenticate to other services on the network only with Kerberos clients. If you do not make
Kerberos authentication mandatory and Kerberos authentication fails, the application attempts to
authenticate users using the default method of authentication for that network service. For example,
Telnet prompts for a password.

Examples This example shows how to make Kerberos authentication mandatory:

Console> (enable) set kerberos clients mandatory
Kerberos clients set to mandatory
Console> (enable)

Related Commands clear kerberos clients mandatory

set kerberos credentials forward
show kerberos

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-210 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set kerberos credentials forward

set kerberos credentials forward

Use the set kerberos credentials forward command to configure clients to forward a user’s credentials
as the user connects to other hosts in the Kerberos realm.

set kerberos credentials forward

Syntax Description This command has no arguments or keywords.

Defaults By default, forwarding is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines A user authenticated to a Kerberized switch has a ticket-granting ticket (TGT) and can use it to
authenticate to a host on the network. However, if forwarding is not enabled and a user tries to list
credentials after authenticating to a host, the output will show no Kerberos credentials present.
You can optionally configure the switch to forward users' TGTs with them as they authenticate from the
switch to Kerberized remote hosts on the network when using Kerberized Telnet.

Examples This example shows how to enable Kerberos credentials forwarding:

kerberos> (enable) set kerberos credentials forward
Kerberos credentials forwarding enabled
kerberos> (enable)

Related Commands clear kerberos credentials forward

set kerberos clients mandatory
show kerberos
show kerberos creds

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-211
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set kerberos local-realm

set kerberos local-realm

Use the set kerberos local-realm command to configure a switch to authenticate users defined in the
Kerberos database.

set kerberos local-realm kerberos_realm

Syntax Description kerberos_realm IP address or name of the Kerberos realm.

Defaults By default, the Kerberos database contains a NULL string.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines For a switch to authenticate a user defined in the Kerberos database, the switch must know the host name
or IP address of the host running the key distribution center (KDC) and the name of the Kerberos realm.
Optionally, the switch should be able to map the host name or Domain Naming System (DNS) domain
to the Kerberos realm.
kerberos_realm must be entered in uppercase characters.

Examples This example shows how to set CISCO.COM as the default Kerberos local realm for the switch:
kerberos> (enable) set kerberos local-realm CISCO.COM
Kerberos local realm for this switch set to CISCO.COM.
aspen-kerberos> (enable)

Related Commands clear kerberos realm

set kerberos realm
show kerberos

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-212 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set kerberos realm

set kerberos realm

Use the set kerberos realm command to map the name of a Kerberos realm to a DNS domain name or
a host name.

set kerberos realm {dns-domain | host} kerberos_realm

Syntax Description dns-domain DNS domain name to map to Kerberos realm.

host IP address or name to map to Kerberos realm.
kerberos_realm IP address or name of Kerberos realm.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The name of the Kerberos realm can be mapped to a DNS domain name or a host name. This can be done
by the set kerberos realm command, which is an optional command. The information entered with this
command is stored in a table with one entry for each Kerberos realm. The maximum number of entries
in the table is 100.
kerberos_realm must be entered in uppercase characters.

Examples This example shows how to map the Kerberos realm CISCO.COM to the CISCO domain name:
Console> (enable) set kerberos realm CISCO CISCO.COM
Kerberos DnsDomain-Realm entry set to CISCO - CISCO.COM
Console> (enable)

Related Commands clear kerberos realm

set kerberos local-realm
show kerberos

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-213
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set kerberos server

set kerberos server

Use the set kerberos server command to specify which Key Distribution Center (KDC) to use on the
switch.

set kerberos server {kerberos_realm} {hostname | ip_address} [port_number]

Syntax Description kerberos_realm Name of the Kerberos realm.

hostname Name of host running the KDC.
ip_address IP address of host running the KDC.
port_number (Optional) Number of the port.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You can specify to the switch which KDC to use in a Kerberos realm. Optionally, you can also specify
which port number the KDC monitors. The Kerberos server information you enter is maintained in a
table with one entry for each Kerberos realm. The maximum number of entries in the table is 100.
kerberos_realm must be entered in uppercase characters.

Examples This example shows how to specify the Kerberos server:

kerberos> (enable) set kerberos server CISCO.COM 187.0.2.1 750
Kerberos Realm-Server-Port entry set to:CISCO.COM - 187.0.2.1 - 750
kerberos> (enable)

Related Commands clear kerberos server

show kerberos

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-214 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set kerberos srvtab entry

set kerberos srvtab entry

Use the set kerberos srvtab entry command to enter the SRVTAB file directly into the switch from the
command line.

set kerberos srvtab entry {kerberos_principal} {principal_type} {timestamp} {key_version}

{key_type} {key_length} {encrypted_keytab}

Syntax Description kerberos_principal Service on the switch.

principal_type Version of the Kerberos SRVTAB.
timestamp Number representing the date and time the SRVTAB entry was created.
key_version Version of the encrypted key format.
key_type Type of encryption used.
key_length Length, in bytes, of the encryption key.
encrypted_keytab Secret key the switch shares with the Key Distribution Center (KDC). This
key is encrypted with the private DES key when you copy the configuration
to a file or enter the show config command.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines When you enter the SRVTAB directly into the switch, create an entry for each Kerberos principal
(service) on the switch. The entries are maintained in the SRVTAB table. The maximum size of the table
is 20 entries.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-215
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set kerberos srvtab entry

Examples This example shows how to enter a SRVTAB file directly into the switch:
kerberos> (enable) set kerberos srvtab entry host/[email protected] 0 932423923 1
1 8 03;;5>00>50;0=0=0
Kerberos SRVTAB entry set to
Principal:host/[email protected]
Principal Type:0
Timestamp:932423923
Key version number:1
Key type:1
Key length:8
Encrypted key tab:03;;5>00>50;0=0=0

Related Commands clear kerberos srvtab entry

set kerberos srvtab remote
show kerberos

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-216 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set kerberos srvtab remote

set kerberos srvtab remote

Use the set kerberos srvtab remote command to provide the switch with a copy of the SRVTAB file
from the Key Distribution Center (KDC) that contains the secret key.

set kerberos srvtab remote {hostname | ip-address} filename

Syntax Description hostname Name of host running the KDC.

ip-address IP address of host running the KDC
filename Name of the SRVTAB file.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines To make it possible for remote users to authenticate to the switch using Kerberos credentials, the switch
must share a secret key with the KDC. To do this, you must give the switch a copy of the file that is stored
in the KDC, which contains the secret key. These files are called SRVTAB files.
The most secure method to copy SRVTAB files to the hosts in your Kerberos realm is to copy them onto
physical media and go to each host in turn and manually copy the files onto the system. To copy SRVTAB
files to the switch, which does not have a physical media drive, you must transfer them through the
network using Trivial File Transfer Protocol (TFTP).

Examples This example shows how to remotely copy SRVTAB files to the switch from the KDC:
kerberos> (enable) set kerberos srvtab remote 187.20.32.10 /users/jdoe/krb5/ninerskeytab
kerberos> (enable)

Related Commands set kerberos srvtab entry

show kerberos

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-217
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set key config-key

set key config-key

Use the set key config-key command to define a private DES key for the switch.

set key config-key string

Syntax Description string DES key for switch. Cannot exceed eight bytes.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You can define a private DES key for the switch. The private DES key can be used to encrypt the secret
key that the switch shares with the KDC. If the DES key is set, the secret key is not displayed in clear
text when the show kerberos command is executed. The key length should be eight characters or less.

Examples This example shows how to define a DES key:

kerberos> (enable) set key config-key abcd
Kerberos config key set to abcd
kerberos> (enable)

Related Commands clear key config-key

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-218 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set length

set length
Use the set length command to configure the number of lines in the terminal display.

set length number [default]

Syntax Description number Number of lines to display on the screen. Valid values are 0 and 5 to 512.
0 turns off the scrolling feature.
default (Optional) Keyword that specifies to set the number of lines in the
terminal display screen for the current administration session and all
other sessions. This keyword is available only in normal mode.

Defaults By default, the screen length is 24 lines.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines Output from a single command that overflows a single display screen is followed by the --More--
prompt. At the --More-- prompt, you can press Ctrl-C, q, or Q to interrupt the output and return to the
prompt, press the Spacebar to display an additional screen of output, or press Return to display one
more line of output.
Setting the screen length to 0 turns off the scrolling feature and causes the entire output to display at
once. Unless the default keyword is used, a change to the terminal length value applies only to the
current session.

Examples This example shows how to set the screen length to 60 lines:
Console> (enable) set length 60
Screen length for this session set to 60.
Console> (enable)

This example shows how to set the default screen length to 40 lines:
Console> (enable) set length 40 default
Screen length set to 40.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-219
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set logging buffer

set logging buffer

Use the set logging buffer command to limit the number of system logging messages buffered.

set logging buffer buffer_size

Syntax Description buffer_size Number of system logging messages to store in the buffer. Valid
values are 1 to 500.

Defaults By default, the buffer limit is set to 500 messages.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to limit the syslog message buffer to 400 messages:
Console> (enable) set logging buffer 400
System logging buffer size set to <400>.
Console> (enable)

Related Commands clear logging buffer

set logging timestamp
show logging buffer

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-220 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set logging console

set logging console

Use the set logging console command to enable and disable the sending of system logging messages to
the console.

set logging console {enable | disable}

Syntax Description enable Keyword that specifies to enable system message logging to the
console.
disable Keyword that specifies to disable system message logging to the
console.

Defaults By default, system message logging to the console is enabled.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to enable system message logging to the console:
Console> (enable) set logging console enable
System logging messages will be sent to the console.
Console> (enable)

This example shows how to disable system message logging to the console:
Console> (enable) set logging console disable
System logging messages will not be sent to the console.

Related Commands set logging level

set logging session
show logging
show logging buffer

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-221
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set logging history

set logging history

Use the set logging history command to specify the size of the syslog history table.

set logging history syslog_history_table_size

Syntax Description syslog_history_table_size Size of the syslog history table. Valid values are 0 to 500.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to set the size of the syslog history table to 400:
Console> (enable) set logging history 400
System logging history table size set to <400>.
Console> (enable)

Related Commands show logging

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-222 78-12648-03
 2
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set logging level

set logging level

Use the set logging level command to set the facility and severity level to be used when system messages
are logged.

set logging level facility severity [default]

Syntax Description facility Value for the type of system messages to capture. Facility types are shown
in Table 2-5.
severity Value for the severity level of system messages to capture. Severity level
definitions are shown in Table 2-6.
default (Optional) Keyword that specifies the logging level to apply to all sessions.
If default is not used, the specified logging level applies only to the current
session.

Table 2-5 Facility Types

Facility Type Definition

all All facilities
cdp Cisco Discovery Protocol
cops Common Open Policy Service
dot1x IEEE 802.1x
dtp Dynamic Trunking Protocol
dvlan Dynamic VLAN
earl Enhanced Address Recognition Logic
filesys File system
gvrp GARP VLAN Registration Protocol
ip Internet Protocol
kernel Kernel
mcast Multicast
mgmt Management
mls Multilayer Switching
pagp Port Aggregation Protocol
protfilt Protocol Filter
pruning VTP pruning
qos Quality of Service
radius Remote Access Dial-In User Service
security Security
snmp Simple Network Management Protocol

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-223
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set logging level

Table 2-5 Facility Types (continued)

Facility Type Definition

spantree Spanning Tree Protocol
sys System
tac Terminal Access Controller
tcp Transmission Control Protocol
telnet Terminal Emulation Protocol
tftp Trivial File Transfer Protocol
udld User Datagram Protocol
vtp Virtual Terminal Protocol

Table 2-6 Severity Level Definitions

Severity
Level Severity Type Description
0 Emergencies System unusable
1 Alerts Immediate action required
2 Critical Critical condition
3 Errors Error conditions
4 Warnings Warning conditions
5 Notifications Normal bug significant
condition
6 Informational Informational messages
7 Debugging Debugging messages

Defaults The Catalyst 4000 family switches ship with the following default configuration:

Configuration Parameter Default Setting

system message logging to the console enabled
system message logging to Telnet enabled
sessions
logging server disabled
syslog server unconfigured
server facility LOCAL7
server severity Warnings (4)
logging buffer 500
logging history size 1

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-224 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set logging level

Configuration Parameter Default Setting

timestamp option disabled
facility/severity level for system sys/5
messages dtp/5
pagp/5
mgmt/5
mls/5
all other facilities/2

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You can also set the logging level by using the set logging server command.
If you do not use the default keyword, the specified logging level applies only to the current session.

Examples This example shows how to set the default system message logging severity level for the SNMP facility:
Console> (enable) set logging level snmp 2 default
System logging facility <snmp> set to severity 2(critical).
Console> (enable)

Related Commands show logging

show logging buffer

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-225
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set logging server

set logging server

Use the set logging server command to enable and disable system message logging to configured syslog
servers and to add a syslog server to the system logging server table.

set logging server {enable | disable}

set logging server ip_addr

set logging server facility server_facility_parameter

set logging server severity server_severity_level

Syntax Description enable Keyword that specifies to enable system message logging to
configured syslog servers.
disable Keyword that specifies to disable system message logging to
configured syslog servers.
ip_addr IP address of the syslog server to be added to the configuration. An
IP alias or a host name that can be resolved through DNS can also
be used.
facility Keyword that specifies to set the type of system messages to
capture.
server_facility_parameter Value that specifies the logging facility of syslog server. Valid
values are local0, local1, local2, local3, local4, local5, local6,
local7, and syslog.
severity Keyword to set the severity level of system messages to capture.
server_severity_level Value that specifies the severity level of system messages to
capture. Valid values are 0 to 7. Severity level definitions are shown
in Table 2-6.

Defaults The default is that no syslog servers are configured to receive system messages.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to enable system message logging to the console:
Console> (enable) set logging server enable
System logging messages will be sent to the configured syslog servers.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-226 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set logging server

This example shows how to add a syslog server to the system logging server table:
Console> (enable) set logging server 192.168.255.255
192.168.255.255 added to the System logging server table.
Console> (enable)

This example shows how to set the syslog server facility to local7:
Console> (enable) set logging server facility local7
System logging server facility set to <local7>
Console> (enable)

This example shows how to set the syslog server severity level to 4:
Console> (enable) set logging server severity 4
System logging server severity set to <4>
Console> (enable)

This example shows how to set the syslog history table size to 400:
Console> (enable) set logging history 400
System logging history table size set to <400>
Console> (enable)

Related Commands clear logging server

show logging

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-227
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set logging session

set logging session

Use the set logging session command to enable or disable the sending of system logging messages to
the current login session.

set logging session {enable | disable}

Syntax Description enable Keyword that specifies to enable the sending of system logging
messages to the current login session.
disable Keyword that specifies to disable the sending of system logging
messages to the current login session.

Defaults The default is system message logging to the current login session enabled.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to prevent system logging messages from being sent to the current login
session:
Console> (enable) set logging session disable
System logging messages will not be sent to the current login session.
Console> (enable)

This example shows how to cause system logging messages to be sent to the current login session:
Console> (enable) set logging session enable
System logging messages will be sent to the current login session.
Console> (enable)

Related Commands set logging buffer

set logging level
show logging
show logging buffer

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-228 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set logging telnet

set logging telnet

Use the set logging telnet command to enable or disable logging on Telnet sessions.

set logging telnet {enable | disable}

Syntax Description enable Keyword to enable logging on Telnet sessions.

disable Keyword to disable logging on Telnet sessions.

Defaults The default is system message logging to the Telnet session is enabled.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to allow system logging messages to be sent to new Telnet sessions:
Console> (enable) set logging telnet enable
System logging messages will be sent to the new telnet sessions.
Console> (enable)

This example shows how to prevent system logging messages from being sent to new Telnet sessions:
Console> (enable) set logging telnet disable
System logging messages will not be sent to the new telnet sessions.
Console> (enable)

Related Commands set logging console

set logging history
show logging
show logging buffer

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-229
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set logging timestamp

set logging timestamp

Use the set logging timestamp command to enable or disable the timestamp display on system logging
messages.

set logging timestamp {enable | disable}

Syntax Description enable Keyword that specifies to enable the timestamp display.
disable Keyword that specifies to disable the timestamp display.

Defaults The default is system message logging timestamp enabled.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to enable the timestamp display:

Console> (enable) set logging timestamp enable
System logging messages timestamp will be enabled.
Console> (enable)

This example shows how to disable the timestamp display:

Console> (enable) set logging timestamp disable
System logging messages timestamp will be disabled.
Console> (enable)

Related Commands show logging

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-230 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set logout

set logout
Use the set logout command to specify the number of minutes the system waits before automatically
disconnecting an idle session.

set logout timeout

Syntax Description timeout Number of minutes until the system disconnects an idle session
automatically. Valid values are 0 to 10000. Setting the value to 0
disables the automatic disconnection of idle sessions.

Defaults The default value is 20 minutes.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to set the number of minutes until the system disconnects an idle session
automatically:
Console> (enable) set logout 20
Sessions will be automatically logged out after 20 minutes of idle time.
Console> (enable)

This example shows how to disable the automatic disconnection of idle sessions:
Console> (enable) set logout 0
Sessions will not be automatically logged out.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-231
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set module disable

set module disable

Use the set module disable command to disable a module.

set module disable mod_num

Syntax Description mod_num Number of the module.

Defaults The default configuration has all modules enabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines Avoid disabling a module when you are connected through a Telnet session; if you disable the module
that contains the port through which your Telnet session was established, you will disconnect your Telnet
session.
If there are no other network connections to the switch, you must connect to the switch through the
console port to reenable the module.
You can specify a series of modules by entering a comma between each module number (for example,
2,3,5). You can specify a range of modules by entering a hyphen between module numbers
(for example, 2-5).

Examples This example shows how to disable module 3 when connected through the console port:
Console> (enable) set module disable 3
Module 3 disabled.
Console> (enable)

This example shows how to disable module 2 when connected through a Telnet session:
Console> (enable) set module disable 2
This command may disconnect your telnet session.
Do you want to continue (y/n) [n]? y
Module 2 disabled.

Related Commands set module enable

show module

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-232 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set module enable

set module enable

Use the set module enable command to enable a module.

set module enable mod_num

Syntax Description mod_num Number of the module to enable.

Defaults The default setting has all modules enabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If an individual port on a module was previously disabled, enabling the module does not enable the
disabled port.

Examples This example shows how to enable module 2:

Console> (enable) set module enable 2
Module 2 enabled.
Console> (enable)

Related Commands set module disable

show module

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-233
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set module name

set module name

Use the set module name command to set the name for a module.

set module name mod_num [mod_name]

Syntax Description mod_num Number of the module.

mod_name (Optional) Name to assign to the module.

Defaults The default configuration has no module names configured for any modules.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you do not specify a mod_name value, any previously specified name is cleared.
Module names configured using the set module name command are displayed in the output of the show
module command and other commands.

Examples This example shows how to set Supervisor as the name for module 1:
Console> (enable) set module name 1 Supervisor
Module name set.
Console> (enable)

Related Commands show module

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-234 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set multicast router

set multicast router

Use the set multicast router command to manually configure a port as a multicast router port.

set multicast router mod_num/port_num

Syntax Description mod_num/port _num Number of the module and the port.

Defaults The default is that no ports are configured as multicast router ports.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines When you enable CGMP or IGMP snooping, the ports to which a multicast-capable router is attached
are identified automatically. The set multicast router command allows you to configure multicast router
ports statically.

Examples This example shows how to manually configure module 3 port 1 as a multicast router port:
Console> (enable) set multicast router 3/1
Port 3/1 added to multicast router port list.
Console> (enable)

Related Commands clear multicast router

set cgmp
show multicast group count
show multicast router

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-235
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ntp authentication

set ntp authentication

Use the set ntp authentication command to enable or disable the Network Time Protocol (NTP)
authentication feature.

set ntp authentication {enable | disable}

Syntax Description enable Keyword that specifies to enable NTP authentication.

disable Keyword that specifies to disable NTP authentication.

Defaults The default is NTP authentication.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to enable NTP authentication:

Console> (enable) set ntp authentication enable
NTP authentication feature enabled.
At least one trusted key must be set for NTP to work.
Console> (enable)

This example shows how to disable NTP authentication:

Console> (enable) set ntp authentication disable
NTP authentication feature disabled.
Console> (enable)

Related Commands show ntp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-236 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ntp broadcastclient

set ntp broadcastclient

Use the set ntp broadcastclient command to enable or disable Network Time Protocol (NTP)
broadcast-client mode.

set ntp broadcastclient {enable | disable}

Syntax Description enable Keyword that specifies to enable NTP broadcast-client mode.
disable Keyword that specifies to disable NTP broadcast-client mode.

Defaults The default setting for this command is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You can configure NTP in either broadcast-client mode or client mode. The broadcast-client mode
assumes that a broadcast server, such as a router, sends time-of-day information regularly to the switch.

Examples This example shows how to enable NTP broadcast client:

Console> (enable) set ntp broadcastclient enable
NTP Broadcast Client mode enabled.
Console> (enable)

This example shows how to disable NTP broadcast client:

Console> (enable) set ntp broadcastclient disable
NTP Broadcast Client mode disabled.
Console> (enable)

Related Commands show ntp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-237
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ntp broadcastdelay

set ntp broadcastdelay

Use the set ntp broadcastdelay command to configure a time-adjustment factor so the switch can
receive broadcast packets.

set ntp broadcastdelay microseconds

Syntax Description microseconds Estimated round-trip time, in microseconds, for Network Time
Protocol (NTP) broadcasts. Valid values are 1 to 999,999.

Defaults The default is the NTP broadcast delay set to 3000.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to set the NTP broadcast delay to 4000 microseconds (4 seconds):
Console> (enable) set ntp broadcastdelay 4000
NTP broadcast delay set to 4000 microseconds.
Console> (enable)

Related Commands show ntp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-238 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ntp client

set ntp client

Use the set ntp client command to enable or disable the switch as an Network Time Protocol (NTP)
client.

set ntp client {enable | disable}

Syntax Description enable Keyword that specifies to enable the NTP client.
disable Keyword that specifies to disable the NTP client.

Defaults The default is NTP client mode disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You can configure NTP in either broadcast-client mode or client mode. The client mode assumes that the
client switch regularly sends time-of-day requests to the NTP server.

Examples This example shows how to enable NTP client mode:

Console> (enable) set ntp client enable
NTP client mode enabled.
Console> (enable)

Related Commands show ntp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-239
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ntp key

set ntp key

Use the set ntp key command to define an Network Time Protocol (NTP) authentication key pair or to
specify a key to be trusted or untrusted.

set ntp key public_keynum {trusted | untrusted} [md5 secret_keystring]

Syntax Description public_keynum Number of the key pair. Valid values are 1 to 4,292,945,295.
trusted Keyword that specifies the trusted key mode.
untrusted Keyword that specifies the untrusted key mode.
md5 (Optional) Keyword that sets the keystring of the key pair.
secret_keystring (Optional) Key string. Valid values are 1 to 32 printable characters.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you enter the set ntp key command without the md5 keyword, the trusted or untrusted mode of the
key will change after it is entered into the key table. Enter the set ntp key command with the md5 option
to enter an authentication key pair into the system.

Examples This example shows how to define an NTP authentication key:

Console> (enable) set ntp key 435 trusted md5 have_a_good_day
NTP key 435 added.
Console> (enable)

This example shows how to trust an NTP key:

Console> (enable) set ntp key 435 trusted
NTP key 435 configured to be trusted.
Console> (enable)

This example shows how to untrust an NTP key:

Console> (enable) set ntp key 9999 untrusted
NTP key 9999 configured not to be trusted.
Console> (enable)

Related Commands clear ntp key

show ntp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-240 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ntp server

set ntp server

Use the set ntp server command to specify the Network Time Protocol (NTP) server address and to
configure an NTP server authentication key.

set ntp server ip_addr [key public_keynum]

Syntax Description ip_addr IP address of the NTP server.

key (Optional) Keyword that specifies the key number.
public_keynum (Optional) Number of the key pair. Valid values are 1 to
4,292,945,295.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you enter the set ntp server command without the key argument, and the authentication feature is
enabled, the following message appears:
A trusted key may be required to communicate with this server.

Examples This example shows how to configure an NTP server:

Console> (enable) set ntp server 172.20.52.3
NTP server 172.20.52.3 added
Console> (enable)

This example shows how to configure an NTP server with a key:

Console> (enable) set ntp server 111.222.111.222 key 879
NTP server 111.222.111.222 with key 879 added
Console> (enable)

This example shows how to assign a new key to an NTP server:

Console> (enable) set ntp server 111.222.111.222 key 4323423
NTP server 111.222.111.222 has been updated with key 4323423
Console> (enable)

Related Commands clear ntp server

show ntp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-241
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ntp summertime

set ntp summertime

Use the set ntp summertime command to specify whether the system should set the clock ahead one
hour to accommodate daylight saving time.

set ntp summertime {enable | disable} [zone]

set ntp summertime recurring {week day month hh:mm} [offset]

set ntp summertime date {month date year hh:mm} [offset]

Syntax Description enable Keyword that sets the clock ahead one hour to accommodate
daylight saving time.
disable Keyword that prevents the system from setting the clock ahead one
hour during daylight saving time.
zone (Optional) Time zone used by the set summertime command.
recurring Keyword to specify the summertime dates that recur every year.
week Week of the month. Valid values are first, second, third, fourth, last,
1, 2, 3, 4, and 5.
day Day of the week. Valid values are Sunday, Monday, Tuesday,
Wednesday, Thursday, Friday, and Saturday.
month Month of the year. Valid values are January, February, March, and
so on.
hh:mm Hours and minutes.
offset (Optional) Amount of offset in minutes. Valid values are 1 to 1,440
minutes.
date Keyword to specify that daylight savings begins and ends on a
particular, nonrecurring date.
date Day of the month. Valid values are 1 to 31.
year Number of the year. Valid values are 1993 to 2035.

Defaults The default is the set ntp summertime command disabled. When enabled, the default for offset is
60 minutes, following U.S. standards.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines After you enter the clear config command, the dates and times return to default (US summertime).
Unless you configure it otherwise, this command advances the clock one hour at 2:00 a.m. on the first
Sunday in April and moves the clock back one hour at 2:00 a.m. on the last Sunday in October.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-242 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ntp summertime

Examples This example shows how to configure the system to set the clock ahead one hour for daylight saving time
to Pacific daylight time (PDT):
Console> (enable) set ntp summertime enable PDT
Summertime is enabled and set to “PDT”.
Console> (enable)

This example shows how to prevent the system from setting the clock ahead one hour for daylight saving
time:
Console> (enable) set ntp summertime disable
Summertime disabled.
Console> (enable)

This example shows how to set daylight saving time to repeat every year, starting from the third Monday
of February at noon and ending at the second Saturday of August at 3:00 p.m., with an offset of
30 minutes:
Console> (enable) set ntp summertime recurring 3 mon feb 12:00 2 saturday aug 15:00 30
Summertime is disabled and set to ''
Start : Mon Feb 19 2001, 12:00:00
End : Sat Aug 11 2001, 15:00:00
Offset: 30 minutes
Recurring: yes, starting at 12:00pm of third Monday of February and ending on
15:00pm of second Saturday of August. Console> (enable)

This example shows how to set daylight saving time to start on January 29, 1999, at 2:00 a.m. and end
on August 19, 2004, at 3:00 p.m., with an offset of 30 minutes:
Console> (enable) set ntp summertime date jan 29 1999 02:00 aug 19 2004 15:00 30
Summertime is disabled and set to ''
Start : Fri Jan 29 1999, 02:00:00
End : Thu Aug 19 2004, 15:00:00
Offset: 30 minutes
Recurring: no
Console> (enable)

This example shows how to set recurring to default to the standard US daylight savings:
Console> (enable) set ntp summertime recurring 3 mon feb 2:00 4 thurs oct 2:00 60
Summertime is disabled and set to ''
Start : Mon Feb 19 2001, 02:00:00
End : Thu Oct 25 2001, 02:00:00
Offset: 60 minutes
Recurring: yes, starting at 02:00am of third Monday of February and ending on
02:00am of fourth Thursday of October.
Console> (enable)

Related Commands show ntp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-243
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set ntp timezone

set ntp timezone

Use the set ntp timezone command to configure the time offset from Greenwich Mean Time.

set ntp timezone [zone_name] [hours [minutes]]

Syntax Description zone_name Name of the timezone.

hours (Optional) Time offset (in hours) from Greenwich Mean Time. Valid
values are from –12 to 12 hours.
minutes (Optional) Time offset (in minutes) from Greenwich Mean Time. Valid
values are 0 to 59 minutes.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The set ntp timezone command is effective only when NTP is running. If you set the time explicitly and
NTP is disengaged, the set ntp timezone command has no effect. If you have enabled NTP and have not
entered the set timezone command, the Catalyst 4000 family switch displays UTC by default.

Examples This example shows how to set the time zone to Pacific Standard Time, with an offset of minus 8 hours
from UTC:
Console> (enable) set ntp timezone PST -8
Timezone set to “PST”, offset from UTC is -8 hours.
Console> (enable)

Related Commands clear ntp timezone

show ntp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-244 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set password

set password
Use the set password command to change the normal (login) mode password on the switch.

set password

Syntax Description This command has no arguments or keywords.

Defaults The default configuration has no password configured.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines Passwords are case sensitive; they may be 0 to 30 characters in length, including spaces.
The command prompts you for the old password. If the password you enter is valid, you are prompted
to enter a new password and to verify the new password. A zero-length password is allowed by pressing
Return.

Examples This example shows how to set the normal (login) mode password:
Console> (enable) set password
Enter old password: <old_password>
Enter new password: <new_password>
Retype new password: <new_password>
Password changed.
Console> (enable)

Related Commands set enablepass

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-245
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port auxiliaryvlan

set port auxiliaryvlan

Use the set port auxiliaryvlan command to configure the auxiliary VLAN ports.

set port auxiliaryvlan mod[/ports] {vlan | untagged | none}

Syntax Description mod [/ports] Number of the module and (optional) ports.
vlan Number of the VLAN. Valid values are to 1000.
untagged Keyword to specify that the port send untagged packets.
none Keyword to specify that the port does not send any auxiliary VLAN
information in the CDP packets from that port.

Defaults The default setting is none.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you do not specify a port, all ports are selected.
The vlan option specifies that the connected device send packets tagged with a specific VLAN.
Dynamic VLAN support for VVID includes these restrictions to the following configuration of MVAP
on the switch port:
• You can configure any VVID on a dynamic port including dot1p and untagged, except when the
VVID is equal to untagged. If this is the case, you must configure VMPS with the MAC address of
the IP phone. When you configure the VVID as untagged on a dynamic port, the following a
warning message displays:
VMPS should be configured with the IP phone mac’s.

• You cannot change the VVID of the port equal to PVID assigned by the VMPS for the dynamic port.
• You cannot configure trunk ports as dynamic ports, but an MVAP can be configured as a dynamic
port.

Examples This example shows how to set the auxiliary VLAN port to untagged:
Console> (enable) set port auxiliaryvlan 3/7 untagged
Port 3/7 allows the connected device send and receive untagged packets and without 802.1p
priority.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-246 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port auxiliaryvlan

This example shows how to set the auxiliary VLAN port to none:
Console> (enable) set port auxiliaryvlan 3/12 none
Port 3/12 will not allow sending CDP packets with AuxiliaryVlan information.
Console> (enable)

This example shows how to set the auxiliary VLAN port to a specific module, port, and VLAN:
Console> (enable) set port auxiliaryvlan 2/1-3 222
Auxiliaryvlan 222 configuration successful.
AuxiliaryVlan AuxVlanStatus Mod/Ports
------------- ------------- -------------------------
222 active 1/2,2/1-3

Related Commands show port auxiliaryvlan

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-247
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port channel

set port channel

Use the set port channel command set to configure EtherChannel on Ethernet module ports.

set port channel mod/port [admin_group]

set port channel mod/port mode {on | off | desirable | auto} [silent | non-silent]

set port channel all mode off

set port channel all distribution mac [both]

Syntax Description mod/port Number of the module and the port on the module.
admin_group (Optional) Number of administrative group. Valid values are from
1 to 1024.
mode Keyword to specify the EtherChannel mode.
on Keyword to enable and force specified ports to channel without
PAgP.
off Keyword to prevent ports from channeling.
desirable Keyword to set a PAgP mode that places a port into an active
negotiating state, in which the port initiates negotiations with
other ports by sending PAgP packets.
auto Keyword to set a PAgP mode that 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.
silent (Optional) Keyword to use with auto or desirable when no traffic
is expected from the other device to prevent the link from being
reported to STP as down.
non-silent (Optional) Keyword to use with auto or desirable when traffic is
expected from the other device.
all mode off Keywords to globally turn off channeling on all ports.
all distribution Keywords to apply frame distribution to all ports in the switch.
mac Keyword to specify the frame distribution method using MAC
address values.
both (Optional) Keyword to specify the frame distribution method
using source and destination address values.

Defaults The default is EtherChannel set to auto and silent on all module ports. The defaults for frame
distribution are mac and both.

Command Types Switch command.

Command Modes Privileged.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-248 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port channel

Usage Guidelines Make sure that all ports you intend to channel are configured properly. For complete information on
EtherChannel configuration restrictions, refer to the Software Configuration Guide–Catalyst 4000
Family, Catalyst 2948G, and Catalyst 2980G Switches.
Because of the port ID handling by the spanning tree feature, the maximum supported number of
channels is 126 for a 6-slot chassis.
Administrative groups specify which ports can form an EtherChannel together. An administrative group
can contain a maximum of eight ports. However, administrative group membership is restricted by
hardware capabilities. Use the show port capabilities command to determine which ports can form a
channel together.
On the Catalyst 4000 family switches, an EtherChannel bundle can consist of any two to eight ports.
Ports in an EtherChannel do not have to be contiguous, nor do they have to be on the same module.
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 are running QoS, make sure that bundled ports are all of the same trust types and have similar
queueing and drop capabilities.
Disable the port security feature on the channeled ports (see the set port securitycommand). If you
enable port security for a channeled port, the port shuts down when it receives packets with source
addresses that do not match the secure address of the port.
You can configure up to eight ports on the same switch in each administrative group.
When you assign ports to an existing admin group, the original ports associated with the admin group
will move to an automatically picked new admin group. You cannot add ports to the same admin group.
If you do not enter an admin_group, it means that you want to create a new administrative group with
admin_group selected automatically. The next available admin_group is automatically selected.
If you do not enter the channel mode, the channel mode of the ports addressed are not modified.
The silent | non-silent parameters only apply if desirable or auto modes are entered.
If you do not specify silent or non-silent, the current setting is not affected.
To support jumbo frames, channeling ports need to have the same jumbo frame setting on each port.
This command is not supported by non-EtherChannel-capable modules.

Examples This example shows how to create an EtherChannel on ports 5 and 6 of module 4:
Console> (enable) set port channel 4/5-6 on
Port(s) 4/5-6 are assigned to admin group 56.
Port(s) 4/5-6 channel mode set to on.
Console> (enable)
This example shows how to remove an EtherChannel on ports 5 and 6 of module 4:
Console> (enable) set port channel 4/5-6 mode auto
Port(s) 4/5-6 channel mode set to auto.
Console> (enable) show port channel

This example shows the display when the port list is exceeded:
Console> (enable) set port channel 2/1-9 1
No more than 8 ports can be assigned to an admin group.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-249
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port channel

This example shows how to disable EtherChannel on module 4, ports 4 to 6:

Console> (enable) set port channel 4/4-6 mode off
Port(s) 4/4-6 channel mode set to off.
Console> (enable)

This example shows the display output when you assign ports to an existing admin group. This example
moves ports in admin group 96 to another admin group and assigns module 4, ports 4 to 6 to admin
group 96:
Console> (enable) set port channel 4/4-6 96
Port(s) 4/1-3 are moved to admin group 97.
Port(s) 4/4-6 are assigned to admin group 96.
Console> (enable)

This example shows how to set the channel mode to off for module 4, ports 4 to 6 and assign those ports
to an automatically selected admin group:
Console> (enable) set port channel 4/4-6 off
Port(s) 4/4-6 channel mode set to off.
Port(s) 4/4-6 are assigned to admin group 23.
Console> (enable)

Related Commands set channel cost

set channel vlancost
show channel
show channel group
show port channel

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-250 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port disable

set port disable

Use the set port disable command to disable a port or a range of ports.

set port disable mod_num/port_num

Syntax Description mod_num Number of the module.

port_num Number of the port.

Defaults The default system configuration has all ports enabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines This command is not supported by the Access Gateway module.

Examples This example shows how to disable port 5/10:

Console> (enable) set port disable 5/10
Port 5/10 disabled.
Console> (enable)

Related Commands set port enable

show port

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-251
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port dot1x

set port dot1x

Use the set port dot1x commands to configure dot1x on a port.

set port dot1x mod/port multiple-host {enable | disable}

set port dot1x mod/port {port-control port_control_value}

set port dot1x mod/port {initialize | re-authenticate}

set port dot1x mod/port re-authentication {enable | disable}

Syntax Description mod/port Number of the module and port on the module.
multiple-host Keyword to specify multiple-user access; see the “Usage
Guidelines” section for additional information.
enable Keyword to enable multiple-user access.
disable Keyword to disable multiple-user access.
port-control Keyword and variable to specify the port control type; valid values
port_control_value are force-authorized, force-unauthorized, and auto.
initialize Keyword to initialize dot1x on the port.
re-authenticate Keyword to manually initiate a reauthentication of the entity
connected to the port.
re-authentication Keyword to automatically initiate reauthentication of the entity
connected to the port within the reauthentication time period; see
the “Usage Guidelines” section for more information.
enable Keyword to enable automatic reauthentication.
disable Keyword to disable automatic reauthentication.

Defaults The default settings are as follows:

• The default port_control_value is force-authorized.
• The multiple host feature is disabled.
• The reauthentication feature is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The dot1x port will not be allowed to become a trunk port, MVAP, channel port, dynamic port, or a secure
port.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-252 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port dot1x

When setting the port control type, the following applies:

• force-authorized forces the controlled port to transition to the authorized state unconditionally and
is equivalent to disabling 802.1x restriction in the port.
• force-unauthorized forces the controlled port to transit to the unauthorized state unconditionally and
prevents the authorized services of the authenticator to the supplicant.
• auto enables 802.1x control on the port.
If you disable the multiple host feature, once a dot1x port is authorized through a successful
authentication of a supplicant, only that particular host (MAC address) is allowed on that port. When the
system detects another host (different MAC address) on the authorized port, it shuts down the port and
displays a syslog message. This is the default system behavior.
If you enable the multiple host feature, once a dot1x port is authorized through a successful
authentication of a supplicant, any host (any MAC address) is allowed to send or receive traffic on that
port.
If you enable reauthentication, you can set the reauthentication time period in seconds by entering the
set dot1x re-authperiod seconds command. The default for the reauthentication time period is
3600 seconds.

Examples This example shows how to set the port control type automatically:
Console> (enable) set port dot1x 4/1 port-control auto
Port 4/1 dot1x port-control is set to auto.
Console> (enable)

This example shows how to initialize dot1x on a port:

Console> (enable) set port dot1x 4/1 initialize
dot1x port 4/1 initializing...
dot1x initialized on port 4/1.
Console> (enable)

This example shows how to manually reauthenticate a port:

Console> (enable) set port dot1x 4/1 re-authenticate
dot1x port 4/1 re-authenticating...
dot1x re-authentication successful...
dot1x port 4/1 authorized.
Console> (enable)

This example shows how to enable multiple-user access on a specific port:

Console> (enable) set port dot1x 4/1 multiple-host enable
Multiple hosts allowed on port 4/1.
Console> (enable)

This example shows how to enable automatic reauthentication on a port:

Console> (enable) set port dot1x 4/1 re-authentication enable
Port 4/1 re-authentication enabled.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-253
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port dot1x

Related Commands clear dot1x config

set dot1x
show dot1x
show port dot1x

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-254 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port duplex

set port duplex

Use the set port duplex command to configure the duplex type of an Ethernet or Fast Ethernet port or
range of ports.

set port duplex mod_num/port_num {full | half}

Syntax Description mod_num Number of the module.

port_num Number of the port.
full Keyword that specifies full-duplex transmission.
half Keyword that specifies half-duplex transmission.

Defaults By default, 10-Mbps and 100-Mbps modules have all Ethernet ports set to half duplex.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You can configure Ethernet and Fast Ethernet interfaces to either full duplex or half duplex.
The set port duplex command is not supported on Token Ring ports.
You cannot configure the duplex mode on Gigabit Ethernet ports (they are always in full-duplex mode).

Examples This example shows how to set port 1 on module 2 to full duplex:
Console> (enable) set port duplex 2/1 full
Port 2/1 set to full-duplex.
Console> (enable)

This example shows how to set port 1 on module 2 to half duplex:

Console> (enable) set port duplex 2/1 half
Port 2/1 set to half-duplex.
Console> (enable)

Related Commands show port

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-255
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port enable

set port enable

Use the set port enable command to enable a port or a range of ports.

set port enable mod_num/port_num

Syntax Description mod _num Number of the module.

port_num Number of the port.

Defaults By default, all ports are enabled.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to enable port 3 on module 2:

Console> (enable) set port enable 2/3
Port 2/3 enabled.
Console> (enable)

Related Commands set port disable

show port

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-256 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port flowcontrol

set port flowcontrol

Use the set port flowcontrol command to configure a port to send or receive pause frames. Pause frames
are special packets that signal a source to stop sending frames for a specific period of time because the
buffers are full.

set port flowcontrol mod_num/port_num {receive | send} {off | on | desired}

Syntax Description mod_num Number of the module.

port_num Number of the port on the module.
receive Keyword that specifies if a port processes pause frames.
send Keyword that specifies if a port sends pause frames.
off Keyword that prevents a local port from receiving and processing pause frames
from remote ports or from sending pause frames to remote ports.
on Keyword that enables a local port to receive and process pause frames from
remote ports or send pause frames to remote ports.
desired Keyword that obtains predictable results whether a remote port is set to on, off,
or desired.

Defaults Flow control defaults vary according to port speed:

• Gigabit Ethernet ports default to off for receive and desired for transmit
– Oversubscribed Gigabit Ethernet ports (ports 3-18) on the Catalyst 4000 family 18-port Gigabit
Ethernet switching module (WS-X4418-GB) default to desired for receive and on for transmit
• Fast Ethernet ports default to off for receive and on for transmit

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines When you install an Access Gateway module on your switch, the switch will enable the internal
Gigabit Ethernet port and force flow control off for both send and receive.
Table 2-7 describes guidelines for using different configurations of the send and receive keywords with
the set port flowcontrol command.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-257
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port flowcontrol

Table 2-7 Send and Receive Keyword Configurations

Configuration Description
send on Enables a local port to send pause frames to remote ports. To obtain
predictable results, use send on only when remote ports are set to
receive on or receive desired.
send off Prevents a local port from sending pause frames to remote ports. To
obtain predictable results, use send off only when remote ports are set
to receive off or receive desired.
send desired Obtains predictable results whether a remote port is set to receive on,
receive off, or receive desired.
receive on Enables a local port to process pause frames that a remote port sends.
To obtain predictable results, use receive on only when remote ports
are set to send on or send desired.
receive off Prevents remote ports from sending pause frames to local port. To
obtain predictable results, use send off only when remote ports are set
to receive off or receive desired.
receive desired Obtains predictable results whether a remote port is set to send on,
send off, or send desired.

All Catalyst Gigabit Ethernet ports can receive and process pause frames from remote devices. However,
not all such ports can send pause frames to remote devices.
Table 2-8 identifies the Catalyst Gigabit Ethernet switches, modules, and ports that can send pause
frames to remote devices.

Table 2-8 Send Capability by Switch Type, Module, and Port

Module Ports Send

All modules except All ports except for the No
WS-X4418-GB, oversubscibed ports listed
WS-X4412-2GB-TX, and below
WS-X4416-2GB-TX)
WS-X4418-GB Uplink ports (1-2) No
WS-X4418-GB Oversubscribed ports (3-18) Yes
WS-X4412-2GB-TX Uplink ports (13-14) No
WS-X4412-2GB-TX Oversubscribed ports (1-12) Yes
WS-X4416-2GB-TX Uplink ports (17-18) No

Examples This example shows how to configure port 1 of module 5 to receive and process pause frames:
Console> (enable) set port flowcontrol 5/1 receive on
Port 5/1 flow control receive administration status set to on
(port will require far end to send flowcontrol)
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-258 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port flowcontrol

This example shows how to configure port 1 of module 5 to receive and process pause frames if the
remote port is configured to send pause frames:
Console> (enable) set port flowcontrol 5/1 receive desired
Port 5/1 flow control receive administration status set to desired
(port will allow far end to send flowcontrol if far end supports it)
Console> (enable)

This example shows how to configure port 1 of module 5 to receive but not process pause frames on port
1 of module 5:
Console> (enable) set port flowcontrol 5/1 receive off
Port 5/1 flow control receive administration status set to off
(port will not allow far end to send flowcontrol)
Console> (enable)

This example shows how to configure port 1 of module 5 to send pause frames:
Console> (enable) set port flowcontrol 5/1 send on
Port 5/1 flow control send administration status set to on
(port will send flowcontrol to far end)
Console> (enable)

This example shows how to configure port 1 of module 5 to send pause frames and yield predictable
results even if the remote port is set to receive off:
Console> (enable) set port flowcontrol 5/1 send desired
Port 5/1 flow control send administration status set to desired
(port will send flowcontrol to far end if far end supports it)
Console> (enable)

This example shows how to configure port 1 of module 5 to not send pause frames:
Console> (enable) set port flowcontrol 5/1 send off
Port 5/1 flow control send administration status set to off
(port will not send flowcontrol to far end)
Console> (enable)

Related Commands show port flowcontrol

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-259
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port gmrp

set port gmrp

Use the set port gmrp command to enable or disable GARP Multicast Registration Protocol (GMRP)
on the specified ports in all VLANs.

set port gmrp mod/ports... {enable | disable}

Syntax Description mod/ports... Module number and port number list.

enable Keyword that specifies to enable GMRP on a specified port.
disable Keyword that specifies to disable GMRP on a specified port.

Defaults By default, GMRP is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You can modify the per-port GMRP configuration, but you must enable GMRP globally using the set
gmrp enable command before the per-port GMRP configuration takes effect.
This command is not supported by the Access Gateway module.

Examples This example shows how to enable GMRP on module 3, port 1:

Console> (enable) set port gmrp 3/1 enable
GMRP enabled on port(s) 3/1.
GMRP feature is currently disabled on the switch.
Console> (enable)

This example shows how to disable GMRP on module 3, ports 1 to 5:

Console> (enable) set port gmrp 3/1-5 disable
GMRP disabled on port(s) 3/1-5.
Console> (enable)

Related Commands show gmrp configuration

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-260 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port gvrp

set port gvrp

Use the set port gvrp command to enable or disable GARP VLAN Registration Protocol (GVRP) on the
specified ports in all VLANs.

set port gvrp mod/ports... {enable | disable}

Syntax Description mod/ports... Module number and port number list.

enable Keyword that specifies to enable GVRP on the specified ports.
disable Keyword that specifies to disable GVRP on the specified ports.

Defaults By default, GVRP is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines GVRP can only be enabled on IEEE 802.1Q trunks.

When VTP pruning is enabled, VTP pruning runs on all GVRP-disabled trunks.
To run GVRP on a trunk, GVRP needs to be enabled both globally on the switch and enabled individually
on the trunk.
You can configure GVRP on a port even when GVRP is globally disabled. However, the port will not
become a GVRP participant until GVRP is also globally enabled.
This command is not supported by the Access Gateway module.

Examples This example shows how to enable GVRP on module 3, port 2:

Console> (enable) set port gvrp 3/2 enable
GVRP enabled on 3/2.
Console> (enable)

This example shows how to disable GVRP on module 3, port 2:

Console> (enable) set port gvrp 3/2 disable
GVRP disabled on 3/2.
Console> (enable)

This example shows what happens if you try to enable GVRP on a port that is not an 802.1Q trunk:
Console> (enable) set port gvrp 4/1 enable
Failed to set port 4/1 to GVRP enable. Port not allow GVRP.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-261
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port gvrp

This example shows what happens if you try to enable GVRP on a specific port when GVRP has not first
been enabled using the set port gvrp command:
Console> (enable) set port gvrp 5/1 enable
GVRP enabled on 5/1.
GVRP feature is currently disabled on the switch.
Console> (enable)

Related Commands clear gvrp statistics

set gvrp
show gvrp configuration

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-262 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port host

set port host

Use the set port host command to optimize the port configuration for a host connection.

set port host mod/ports...

Syntax Description mod/ports... Module number and port number list.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The set port host command sets channel mode to off, enables spanning-tree portfast, and sets trunk
mode to off. Only an end station can accept this configuration.
Enable spanning-tree portfast start only on ports connected to a single host. Connecting hubs,
concentrators, switches, and bridges to a fast start port can cause temporary spanning tree loops.
Enable the set port host command to decrease the time it takes to start up packet forwarding.

Examples This example shows how to optimize the port configuration for end station/host connections on port 1
of modules 2 and 3:
Console> (enable) set port host 2/1,3/1

Warning: Span tree port fast start should only be enabled on ports connected to a single
host. Connecting hubs, concentrators, switches, bridges, etc. to a fast start port can
cause temporary spanning tree loops. Use with caution.
Spantree ports 2/1,3/1 fast start enabled.
Port(s) 2/1,3/1 trunk mode set to off.
Port(s) 2/1 channel mode set to off.

Console> (enable)

Related Commands clear port host

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-263
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port inlinepower

set port inlinepower

Use the set port inlinepower command to set the inline power mode of a port or group of ports.

set port inlinepower mod/ports {off | auto}

Syntax Description mod/ports Number of the module and the ports on the module.
off Keyword to not power up the port even if an unpowered phone is connected.
auto Keyword to power up the port only if the switching module has discovered the
phone.

Defaults By default, the inline power mode is auto.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you enter this command on a port that does not support the IP phone power feature, an error message
is displayed.
You can enter a single port or a range of ports, but you cannot enter only the module number.
An inline power-capable device can still be detected even if the inline power mode is set to off.

Caution Damage can occur to equipment connected to the port if you are not using a phone that can be
configured for the IP phone phantom power feature.

Examples This example shows how to set the inline power to off for module 2, port 5:
Console> (enable) set port inlinepower 2/5 off
Inline power for port 2/5 set to off.
Console> (enable)

This example shows the output if the inline power feature is not supported for module 2, ports 3 to 9:
Console> (enable) set port inlinepower 2/3-9 auto
Feature not supported on module 2.
Console> (enable)

Related Commands set inlinepower defaultallocation

show environment
show port inlinepower

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-264 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port level

set port level

Use the set port level command to set the priority level of a port or range of ports on the
switching bus.

set port level mod_num/port_num {normal | high}

Syntax Description mod_num Number of the module.

port_num Number of the port on the module.
normal Keyword that specifies to set the port priority to normal.
high Keyword that specifies to set the port priority to high.

Defaults By default, all ports are set to the normal priority level.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines Packets traveling through a port set at normal priority are served only after packets traveling through a
port set at high priority are served.

Examples This example shows how to set the priority level for port 2 on module 1 to high:
Console> (enable) set port level 1/2 high
Port 1/2 port level set to high.
Console> (enable)

This example shows how to set the priority level for port 2 on module 1 to normal:
Console> (enable) set port level 1/2 normal
Port 1/2 level set to normal.
Console> (enable)

Related Commands set port disable

set port enable
set port name
set port speed
show port

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-265
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port membership

set port membership

Use the set port membership command to configure ports for dynamic or static VLAN membership.

set port membership mod_num/port_num {dynamic | static}

Syntax Description mod_num Module number.

port_num Port number.
dynamic Keyword that specifies to configure the port for dynamic VLAN
membership.
static Keyword that specifies to configure the port for static VLAN
membership.

Defaults By default, port membership is static.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines Ports configured for dynamic VLAN membership obtain their VLAN assignment through VMPS. Ports
configured for static VLAN membership obtain their VLAN assignment through the set vlan command.
When a port is assigned a VLAN dynamically, the show port command output identifies the VLAN as
dynamic. If the dynamic port is shut down by a VMPS, its status is shown as shutdown.
This command is not supported by the Access Gateway module.
Dynamic VLAN support for VVID includes these restrictions to the following configuration of MVAP
on the switch port:
• You can configure any VVID on a dynamic port including dot1p and untagged, except when the
VVID is equal to dot1p or untagged. If this case, then you must configure VMPS with the MAC
address of the IP phone. When you configure the VVID as dot1p or untagged on a dynamic port, this
warning message displays:
VMPS should be configured with the IP phone mac’s.

• You cannot change the VVID of the port equal to PVID assigned by the VMPS for the dynamic port.
• You cannot configure trunk ports as dynamic ports, but an MVAP can be configured as a dynamic
port.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-266 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port membership

Examples This example shows how to set the port membership VLAN assignment to dynamic on module 3,
ports 1 to 3:
Console> (enable) set port membership 3/1-3 dynamic
Ports 3/1-3 vlan assignment set to dynamic.
Spantree port fast start option enabled for ports 3/1-3.
Console> (enable)

This example shows how to configure a port for static VLAN membership on module 3, ports 1 to 3:
Console> (enable) set port membership 3/1-3 static
Ports 3/1-3 vlan assignment set to static.
Console> (enable)

Related Commands set port enable

show port

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-267
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port name

set port name

Use the set port name command to configure a name for a port.

set port name mod_num/port_num [port_name]

Syntax Description mod_num Number of the module.

port_num Number of the port.
port_name (Optional) Name of the port.

Defaults By default, no port names are configured for any ports.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you do not specify the name string, the port name is cleared.

Examples This example shows how to set port 1 on module 4 to Snowy:

Console> (enable) set port name 4/1 Snowy
Port 4/1 name set.
Console> (enable)

Related Commands show port

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-268 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port negotiation

set port negotiation

Use the set port negotiation command to enable link negotiation on the port that you specify. Link
negotiation autonegotiates flow control, duplex mode, and remote fault information.

set port negotiation mod_num/port_num [enable | disable]

Syntax Description mod_num Number of the module.

port_num Number of the port.
enable (Optional) Keyword that specifies to enable the link negotiation
protocol.
disable (Optional) Keyword that specifies to disable the link negotiation
protocol.

Defaults By default, link negotiation protocol is enabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines

Note Use the set port negotiation command only on 1000BASE [SX, LX, and ZX].

If the port does not support this command, the following message appears:
Feature not supported on Port N/N.

N/N is the module and port number.

When you enable link negotiation with the set port negotiation command, the system autonegotiates
flow control, duplex mode, and remote fault information.
You must either enable or disable link negotiation on both ends of the link. Both ends of the link must
be set to the same value or the link cannot connect.

Examples This example shows how to enable link negotiation on port 1, module 3:
Console> (enable) set port negotiation 3/1 enable
Link negotiation protocol disabled on port 3/1.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-269
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port negotiation

This example shows how to disable link negotiation on port 1, module 4:

Console> (enable) set port negotiation 4/1 disable
Link negotiation protocol disabled on port 4/1.
Console> (enable)

Related Commands show port negotiation

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-270 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port protocol

set port protocol

Use the set port protocol command to set the protocol filtering group membership of ports.

set port protocol mod_num/port_num {ip | ipx | group} {on | off | auto}

Syntax Description mod_num Number of the module.

port_num Number of the port.
ip Keyword that specifies the IP protocol filtering group.
ipx Keyword that specifies the IPX protocol filtering group.
group Keyword that specifies the Group protocol filtering group.
on Keyword that specifies to indicate the port will receive all the flood
traffic for that protocol.
off Keyword that specifies to indicate the port will not receive any
flood traffic for that protocol.
auto Keyword that specifies to indicate the port will receive the flood
traffic for that protocol only after transmitting packets of that
specific protocol.

Defaults By default, ports are configured to on for the IP protocol group and auto for the IPX and group protocol
groups.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines Protocol filtering is supported only on nontrunking Ethernet, Fast Ethernet, and Gigabit Ethernet ports.
Trunking ports are always members of all the protocol groups.
You must enable protocol filtering globally on the switch using the set protocolfilter command.
If the configuration for one of the protocol groups is set to auto, the port initially does not receive any
flood packets for that protocol. If the connected device transmits packets of that protocol, the port is
added to the protocol group and flood traffic for that protocol is transmitted on that port.
Ports configured as auto are removed from the protocol group if the connected device does not transmit
the protocol packets within 60 minutes. The ports are also removed from the protocol group on detection
of a link down.
On the Catalyst 4000 family switches, packets are classified into the following protocol groups:
• IP
• IPX
• AppleTalk and DECnet (“group”)
• Packets not belonging to any of these protocols

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-271
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port protocol

Examples This example shows how to enable IP protocol membership of port 1 on module 2:
Console> (enable) set port protocol 2/1 ip on
IPX protocol disabled on port 2/1.
Console> (enable)

This example shows how to disable IP protocol membership of port 1 on module 2:

Console> (enable) set port protocol 2/1 ip off
IPX protocol disabled on port 2/1.
Console> (enable)

This example shows how to enable automatic IP membership of port 1 on module 5:

Console> (enable) set port protocol 5/1 ip auto
IP protocol set to auto mode on module 5/1.
Console> (enable)

This example shows how to enable IPX protocol membership of port 1 on module 2:
Console> (enable) set port protocol 2/1 ipx on
IPX protocol disabled on port 2/1.
Console> (enable)

This example shows how to disable IPX protocol membership of port 1 on module 2:
Console> (enable) set port protocol 2/1 ipx off
IPX protocol disabled on port 2/1.
Console> (enable)

This example shows how to enable automatic IPX membership of port 1 on module 5:
Console> (enable) set port protocol 5/1 ipx auto
IP protocol set to auto mode on module 5/1.
Console> (enable)

This example shows how to enable group IP membership of port 1 on module 1:

Console> (enable) set port protocol 1/1 group on
Group protocol enabled on port 1/1.
Console> (enable)

This example shows how to disable group IP membership of port 1 on module 1:

Console> (enable) set port protocol 1/1 group off
Group protocol disabled on port 1/1.
Console> (enable)

This example shows how to enable automatic group IP membership of port 1 on module 1:
Console> (enable) set port protocol 1/1 group auto
Group protocol set to auto mode on port 1/1.
Console> (enable)

Related Commands set protocolfilter

show port protocol

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-272 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port security

set port security

Use the set port security command to configure port security on a port or range of ports.

set port security mod ports... [enable | disable mac_addr age age_time maximum
num_of_mac shutdown shutdown_time violation shutdown | restrict]

Syntax Description mod Number of the module.

ports... Number of the ports.
enable (Optional) Keyword that specifies to enable port security.
disable (Optional) Keyword that specifies to disable port security.
mac_addr (Optional) Secure MAC address of the enabled port.
age (Optional) Keyword that specifies the duration for which addresses
on the port will be secured.
age_time (Optional) Specifies the duration for which addresses on the port
will be secured. Valid time iare 10–1440 minutes.
maximum (Optional) Keyword that specifies the maximum number of MAC
addresses on the port will be secured.
num_of_mac (Optional) Maximum number of MAC addresses to secure on the
port. Valid values are 1 to 1025.
shutdown (Optional) Keyword that specifies the duration for which a port will
remain disabled in case of a security violation.
shutdown_time (Optional) Duration for which a port will remain disabled. Valid
values are 10 to 1440 minutes.
violation (Optional) Action to be taken in the event of a security violation.
shutdown (Optional) Keyword used to shut down the port in the event of a
security violation.
restrict (Optional) Keyword used to restrict packets from unsecure hosts.

Defaults The default port security configuration is as follows:

• Port security is disabled.
• Number of secure addresses per port is one.
• Violation action is shutdown.
• Age is permanent (addresses are not aged out).
• Shutdown time is indefinite.

Command Types Switch command.

Command Modes Privileged.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-273
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port security

Usage Guidelines If you enter the set port security enable command but do not specify a MAC address, the first MAC
address seen on the port becomes the secure MAC address.
You can specify the number of MAC addresses to secure on a port. You can add MAC addresses to this
list of secure addresses. The maximum number is 1024.
The set port security violation command allows you to specify whether you want the port to shut down
or to restrict access only to insecure MAC addresses. You can specify the duration of the shutdown time
in the event of a security violation.
This command is not supported by the Access Gateway module.

Examples This example shows how to set port security with a learned MAC address:
Console> (enable) set port security 3/1 enable
Port 3/1 security enabled.
Trunking disabled for port 1/1 due to Security Mode.
Console> (enable)

This example shows how to set port security with a specific MAC address:
Console> (enable) set port security 3/1 enable 01-02-03-04-05-06
Port 3/1 security enabled.
Mac address 01-02-03-04-05-06 set for port 1/1.
Console> (enable)

This example sets the shutdown time to 600 minutes (10 hours) on port 7 on module 6:
Console> (enable) set port security 6/7 shutdown 600
Port 7/7 security shutdown time 600.
Console> (enable)

This example sets port 7 on module 6 to drop all packets that are coming in from insecure hosts:
Console> (enable) set port security 6/7 violation restrict
Port 7/7 security violation mode restrict.
Console> (enable)

Related Commands clear qos config

show port security

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-274 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port speed

set port speed

Use the set port speed command to configure transmission speed or autonegotiation. In the default
mode, autonegotiation manages the transmission speed, duplex mode, master link, and slave link.

set port speed mod_num port_num {10 | 100 | 1000 | auto}

Syntax Description mod_num Number of the module.

port_num Number of the port on the module.
10 Keyword that specifies a transmission rate of 10 Mbps on 10/100 Fast Ethernet ports.
100 Keyword that specifies a transmission rate of 100 Mbps on 10/100 Fast Ethernet
ports.
1000 Keyword that specifies a transmission rate of 1000 Mbps on a 1000BASE-T port.
auto Keyword that specifies autonegotiation for transmission speed and duplex mode on
10/100 Fast Ethernet ports. On 1000BASE-T Gigabit Ethernet ports, this keyword
specifies that autonegotiation determines the master and slave links.

Defaults By default, all module ports are set to auto.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines On 1000BASE-T Gigabit Ethernet ports, autonegotiation determines which side of the link is master and
which side is slave.
You can configure Ethernet interfaces on the 10/100-Mbps Ethernet switching modules to either
10 Mbps or 100 Mbps, or to autosensing mode, allowing them to sense and distinguish between 10-Mbps
and 100-Mbps port transmission speeds and full-duplex or half-duplex port transmission types at a
remote port connection. If you set the interfaces to autosensing mode, they automatically configure
themselves to operate at the proper speed and transmission type.
If you change the transmission speed of a port that is open to 4 or 16 Mbps, the port will close and reopen
at the new transmission speed. If a port closes and reopens on an existing ring using a transmission speed
different from that which the ring is operating, the ring will beacon.
If you set the port speed to auto, duplex mode is automatically set to auto.

Examples This example shows how to configure port 1 on module 2 to auto:

Console> (enable) set port speed 2/1 auto
Port 2/1 speed set to auto-sensing mode.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-275
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port speed

This example shows how to configure port 2 on module 2 port speed to 10 Mbps:
Console> (enable) set port speed 2/2 10
Port 2/2 speed set to 10 Mbps.
Console> (enable)

This example shows how to configure port 4 on module 3 port speed to 16 Mbps:
Console> (enable) set port speed 3/4 16
Port(s) 3/4 speed set to 16Mbps.
Console> (enable)

Related Commands set port duplex

show port

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-276 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set port trap

set port trap

Use the set port trap command to enable or disable the operation of the standard SNMP link trap (up
or down) for a port or range of ports.

set port trap mod_num port_num {enable | disable}

Syntax Description mod_num Number of the module.

port_num Number of the port.
enable Keyword that specifies to activate the SNMP link trap.
disable Keyword that specifies to deactivate the SNMP link trap.

Defaults By default, all port traps are disabled.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to enable the SNMP link trap for module 1, port 2:
Console> (enable) set port trap 1/2 enable
Port 1/2 up/down trap enabled.
Console> (enable)

Related Commands set port disable

set port duplex
set port enable
set port name
set port speed
show port

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-277
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set power budget

set power budget

Use the set power budget command to configure the power settings for the chassis.

set power budget {1 | 2}

Syntax Description 1 Keyword that specifies configure the chassis for one power supply.
2 Keyword that specifies configure the chassis for two power
supplies.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If the chassis is has two power supplies and is configured to a power budget of 2, and you try to set the
power budget to 1, it is disallowed. You must pull out the extra linecards and design a valid and supported
configuration in order to change the power budget to 1.

Examples This example shows how to set the power budget to 1 for the chassis:
Console>(enable) set power budget 1
Warning: Your power supply budget will be constrained to one power supply and may cause
one or more linecards to be disabled depending upon your chassis configuration.
Do you want to continue ? [confirm (y/n)]:y
Console>(enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-278 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set prompt

set prompt
Use the set prompt command to change the prompt for the CLI.

set prompt prompt_string

Syntax Description prompt_string String to use as the command prompt.

Defaults By default, the prompt is set to Console>.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you use the set system name command to assign a name to the switch, the switch name is used as the
prompt string. However, if you specify a different prompt string later, using the set prompt command,
that new string is used as the prompt.

Examples This example shows how to set the prompt to system100>:

Console> (enable) set prompt system100>
system100> (enable)

Related Commands set system name

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-279
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set protocolfilter

set protocolfilter
Use the set protocolfilter command to activate or deactivate protocol filtering.

set protocolfilter {enable | disable}

Syntax Description enable Keyword that specifies to activate protocol filtering.

disable Keyword that specifies to deactivate protocol filtering.

Defaults By default, protocol filtering is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines Use the set port protocol command to configure protocol filtering group membership on switch ports.

Examples This example shows how to activate protocol filtering:

Console> (enable) set protocolfilter enable
Protocol filtering enabled on this switch.
Console> (enable)

This example shows how to deactivate protocol filtering:

Console> (enable) set protocolfilter disable
Protocol filtering disabled on this switch.
Console> (enable)

Related Commands set port protocol

show protocolfilter

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-280 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set pvlan

set pvlan
Use the set pvlan command to bind the isolated or community VLAN to the primary VLAN and assign
the isolated or community ports to the private VLAN.

set pvlan primary_vlan {isolated_vlan | community_vlan} [mod/port | sc0]

Caution Before using this command, we recommend that you read and understand the “Configuring VLANs”
chapter in the Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Software Configuration
Guide.

Syntax Description primary_vlan Number of the primary VLAN.

isolated_vlan Number of the isolated VLAN.
community_vlan Number of the community VLAN.
mod/port (Optional) Module and port numbers of the isolated or community ports.
sc0 (Optional) Keyword that specifies the inband port sc0.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You must set the primary VLAN, isolated VLANs, and community VLANs using the set vlan
pvlan-type pvlan_type command before making the association using the set pvlan command.
Each isolated or community VLAN can have only one primary VLAN associated to it. A primary VLAN
may have one isolated and/or multiple community VLANs associated to it.
Although you can configure sc0 as a private VLAN port, you cannot configure sc0 as a promiscuous port.

Examples This example shows how to map VLANs 901, 902, and 903 (isolated or community VLANs) to VLAN 7
(the primary VLAN):
Console> (enable) set pvlan 7 901 4/3
Port 4/3 is successfully assigned to vlan 7, 901 and is made an isolated port.
Console> (enable) set pvlan 7 902 4/4-5
Ports 4/4-5 are successfully assigned to vlan 7, 902 and are made community ports.
Console> (enable) set pvlan 7 903 4/6-7
Ports 4/6-7 are successfully assigned to vlan 7, 903 and are made community ports.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-281
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set pvlan

This example shows how to assign the sc0 interface to private VLANs 300 (the primary VLAN) and 301
(isolated, community, or two-way community VLANs):
Console> (enable) set pvlan 300 301 sc0
Successfully set the following ports to Private Vlan 300, 301:
sc0
Console> (enable)

Related Commands clear config pvlan

clear pvlan mapping
clear vlan
set pvlan mapping
set vlan
show vlan
show pvlan
show pvlan capability
show pvlan mapping

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-282 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set pvlan mapping

set pvlan mapping

Use the set pvlan mapping command to map isolated or community VLANs to the primary VLAN on
a promiscuous port.

set pvlan mapping primary_vlan {isolated_vlan | community_vlan} {mod/port}

Syntax Description primary_vlan Number of the primary VLAN.

isolated_vlan Number of the isolated VLAN.
community_vlan Number of the community VLAN.
mod/port Module and port number of the promiscuous port.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines Before you can associate the VLANs of any of the promiscuous ports with the set pvlan mapping
command, you must set the primary VLAN, isolated VLANs, and community VLANs using the set vlan
pvlan-type command bound with the set pvlan command.
You should connect a promiscuous port to an external device for the ports in the private VLAN to
communicate with any other device outside the private VLAN.
You should use this command for each primary and isolated VLAN or community VLAN association in
the private VLAN.

Examples This example shows how to remap community VLAN 903 to the primary VLAN 901 on ports 3 through
5 on module 8:
Console> (enable) set pvlan mapping 901 903 8/3-5
Successfully set mapping between 901 and 903 on 8/3-5.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-283
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set pvlan mapping

Related Commands clear pvlan mapping

clear vlan
set pvlan
set vlan
show vlan
show pvlan
show pvlan capability
show pvlan mapping

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-284 78-12648-03
 2
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set power budget

set power budget

Use the set power budget command to configure the redundancy mode based on the power budget
available for nonredundant operation.

set power budget [1 | 2]

Syntax Description 1 Keyword that specifies to set the power budget to one power supply.
2 Keyword that specifies to set the power budget to two power supplies.

Defaults By default, two power supplies are set for the power budget.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to set the power budget to one power supply.
Console> (enable) set power budget 1

Related Commands show config

show environment power
show system

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-285
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set qos

set qos
Use the set qos command to enable and disable Quality of Service (QoS) on a switch.

set qos {enable | disable}

Syntax Description enable Keyword to enable QoS on the switch.

disable Keyword to disable QoS on the switch.

Defaults By default, QoS is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines Do not enable and disable QoS in quick succession (within 2 seconds of each other).

Examples This example shows how to enable QoS:

Console> (enable) set qos enable
QoS is enabled.
Console> (enable)

This example shows how to disable QoS:

Console> (enable) set qos disable
QoS is disabled.
Console> (enable)

Related Commands show qos info

show qos status

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-286 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set qos defaultcos

set qos defaultcos

Use the set qos defaultcos command to define the default Class of Service (CoS) value for the entire
switch.

set qos defaultcos cos_value

Syntax Description cos_value CoS value to use as the default CoS for the switch. Valid values are
0 to 7

Defaults By default, the CoS value for the entire switch is 0.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to set the switch default CoS to 7:
Console> (enable) set qos defaultcos 7
qos defaultcos set to 7
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-287
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set qos map

set qos map

Use the set qos map command to associate CoS values to a transmit queue and drop threshold.

set qos map port_type q# threshold# cos coslist

Syntax Description port_type The port_type is hardware dependent. Use the show port capabilities command to
determine the port_type for your hardware. The port type is defined by the number of
transmit queues and the number of drop thresholds supported on the port. For
example, the 1q4t port type supports one transmit queue and four drop thresholds.
q# Transmit queue number.
threshold# Drop threshold number. The higher the threshold number, the lower the chance traffic
will be dropped.
cos Keyword that specifies CoS values.
coslist List of CoS values between 0 to 7. The higher the number the higher the priority.

Defaults The default for CoS value-to-drop threshold mapping 1is CoS 0 to 7.
The default for CoS value-to-transmit queue mapping 1 is Cos 0 to 7, and CoS value-to-transmit queue
mapping 2 is none configured.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to map CoS values 4 to 7 to the second transmit queue and the first drop
threshold for that queue on a 2q1t port:
Console> (enable) set qos map 2q1t 2 1 cos 4-7
Qos tx priority queue and threshold mapped to cos successfully.
Console> (enable)

Related Commands clear qos map

show port capabilities
show qos status

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-288 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set radius deadtime

set radius deadtime

Use the set radius deadtime command to set the time to skip RADIUS servers that do not reply.

set radius deadtime minutes

Syntax Description minutes The length of time a RADIUS server does not respond to an authentication
request. Valid values are 0 to 1440 minutes.

Defaults By default, the radius deadtime setting is 0 minutes.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If only one RADIUS server is configured or if all the configured servers are marked dead, deadtime will
be ignored, because no alternate servers are available. By default, the deadtime will be 0 minutes; that
is, the RADIUS servers will not be marked dead if they do not respond.

Examples This example shows how to set the RADIUS deadtime to 10 minutes:
Console> (enable) set radius deadtime 10
Radius deadtime set to 10 minutes.
Console> (enable)

Related Commands show radius

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-289
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set radius key

set radius key

Use the set radius key command to set the encryption and authentication for all communication between
the RADIUS client and the server.

set radius key {key}

Syntax Description key User-defined password key.

Defaults By default, the key is set to NULL.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The key you set must be the same one as configured in the RADIUS server. All leading spaces are
ignored; spaces within and at the end of the key are not ignored. Double quotes are not required even if
there are spaces in the key, unless the quotes themselves are part of the key. The length of the key is
limited to 65 characters, and can include any printable ASCII character except tabs.

Examples This example shows how to set the RADIUS encryption and authentication key to Make my day:
Console> (enable) set radius key Make my day
Radius key set to Make my day.
Console> (enable)

Related Commands show radius

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-290 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set radius retransmit

set radius retransmit

Use the set radius retransmit command to specify the number of times that the switch attempts to
retransmit to the RADIUS servers.

set radius retransmit count

Syntax Description count Number of times the switch attempts to retransmit. Valid values are 1 to
100.

Defaults By default, two retransmission attempts are made (three total attempts).

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to set the retransmit attempts to 3:

Console> (enable) set radius retransmit 3
Radius retransmit count set to 3.
Console> (enable)

Related Commands show radius

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-291
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set radius server

set radius server

Use the set radius server command to set the RADIUS server parameters.

set radius server ip_addr [auth-port port] [acct-port port] [primary]

Syntax Description ip_addr Number of the IP address or IP alias in dotted quad format (a.b.c.d).
auth-port (Optional) Keyword that specifies a destination UDP port for RADIUS
authorization messages.
port Number of the destination UDP port number to which RADIUS messages
are sent.
acct-port (Optional) Keyword that specifies a destination UDP port for RADIUS
accounting messages.
primary (Optional) Keyword that specifies that this server be contacted first.

Defaults The default auth-port is 1812.

The default acct-port is 1813.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You can add up to three RADIUS servers.

The RADIUS server will not be used for authentication if the port number is set to 0.

Examples This example shows how to add a primary server using the IP alias tampa.users.com:
Console> (enable) set radius server tampa.users.com
tampa.users.com added to RADIUS server table as primary server.
Console> (enable)

Related Commands show radius

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-292 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set radius timeout

set radius timeout

Use the set radius timeout command to set the time between retransmissions to the RADIUS server.

set radius timeout seconds

Syntax Description seconds Number of seconds to wait for a reply. Valid values are 1 to 1000
seconds.

Defaults By default, the timeout is 5 seconds.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to set the time between retransmissions to 7 seconds:
Console> (enable) set radius timeout 7
Radius timeout set to 7 seconds.
Console> (enable)

Related Commands show radius

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-293
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set rcp username

set rcp username

Use the set rcp username command to specify a username for remote copy protocol (rcp) file transfers.

set rcp username username

Syntax Description username User name. Maximum length is 14 characters.

Defaults There are no default settings for this command.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines Username must be different from “root” and not a null string. The only case in which rcp username is
not used is for the VMPS database. For that database an rcp VMPS username is used.

Examples This example shows how to set the username for rcp:
Console> (enable) set rcp username jdoe
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-294 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set rspan

set rspan
Use the set rspan command set to create remote SPAN sessions.

set rspan disable source [rspan_vlan | all]

set rpsan disable destination [mod/port | all]

set rspan source {src_mod/src_ports... | vlans... | sc0} {rspan_vlan} reflector {mod/port} [rx | tx
| both] [multicast {enable | disable}] [filter vlans...] [create]

set rspan destination mod/port {rspan_vlan} [inpkts {enable | disable}]

[learning {enable | disable}] [create]

Syntax Description disable source Keywords to disable remote SPAN source information.
rspan_vlan (Optional) Remote SPAN VLAN.
all (Optional) Keyword to disable all remote SPAN source or destination
sessions.
disable destination Keywords to disable remote SPAN destination information.
mod/port (Optional) Module and port.
src_mod/src_ports... Monitored ports (remote SPAN source).
vlans... Monitored VLANs (remote SPAN source).
sc0 Keyword to specify the inband port is a valid source.
reflector Keyword to specify a reflector port.
rx (Optional) Keyword to specify that information received at the source
(ingress SPAN) is monitored.
tx (Optional) Keyword to specify that information transmitted from the
source (egress SPAN) is monitored.
both (Optional) Keyword to specify that information both transmitted from
the source (ingress SPAN) and received (egress SPAN) at the source are
monitored.
multicast enable (Optional) Keywords to enable monitoring multicast traffic (egress
traffic only).
multicast disable (Optional) Keywords to disable monitoring multicast traffic (egress
traffic only).
filter vlans (Optional) Keywords to monitor traffic on selected VLANs on source
trunk ports.
create (Optional) Keyword to create a new remote SPAN session instead of
overwriting the previous SPAN session.
inpkts enable (Optional) Keywords to allow the remote SPAN destination port to
receive normal ingress traffic (from the network to the bus) while
forwarding the remote SPAN traffic.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-295
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set rspan

inpkts disable (Optional) Keywords to disable the receiving of normal inbound traffic
on the remote SPAN destination port.
learning enable (Optional) Keywords to enable learning for the remote SPAN
destination port.
learning disable (Optional) Keywords to disable learning for the remote SPAN
destination port.

Defaults The defaults are as follows:

• Remote SPAN is disabled.
• There is no VLAN filtering.
• Monitoring multicast traffic is enabled.
• Learning is enabled.
• inpkts is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines This command is not supported by the Network Analysis Module (NAM).
The rspan_vlan variable is optional in the set rspan disable source command and required in the set
rspan source and set rspan destination command set.
When SPAN is enabled, system defaults are used (if no parameters are set). If you set parameters, the
parameters you set are stored in NVRAM, and are used.
Use a network analyzer to monitor ports.
Use the inpkts keyword with the enable option to allow the remote SPAN destination port to receive
normal incoming traffic in addition to the traffic mirrored from the remote SPAN source. Use the disable
option to prevent the remote SPAN destination port from receiving normal incoming traffic.
You can specify an MSM port as the remote SPAN source port. However, you cannot specify an MSM
port as the remote SPAN destination port.
When you enable the inpkts option, a warning message notifies you that the destination port does not
join STP and may cause loops if this option is enabled.
If you do not use the keyword create and you have only one session, the session will be overwritten. If
a matching rspan_vlan or destination port exists, the particular session will be overwritten (regardless
of whether the keyword create is used). If you use the keyword create and there is no matching
rspan_vlan or destination port, the session will be created.
Each switch can source only one remote SPAN session (ingress, egress, or both). When you configure a
remote ingress or bidirectional SPAN session in a source switch, the limit for local ingress or
bidirectional SPAN session is reduced to one. There are no limits on the number of remote SPAN
sessions carried across the network within the remote SPAN session limits.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-296 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set rspan

You can configure any VLAN as a remote SPAN VLAN as long as these conditions are met:
• The same remote SPAN VLAN is used for a remote SPAN session in the switches.
• All the participating switches have appropriate hardware and software.
• No unwanted access port is configured in the remote SPAN VLAN.

Examples This example shows how to disable all enabled source sessions:
Console> (enable) set rspan disable source all
This command will disable all remote span source session(s).
Do you want to continue (y/n) [n]? y
Disabled monitoring of all source(s) on the switch for remote span.
Console> (enable)

This example shows how to disable one source session to a specific VLAN:
Console> (enable) set rspan disable source 903
Disabled monitoring of all source(s) on the switch for rspan_vlan 903.
Console> (enable)

This example shows how to disable all enabled destination sessions:

Console> (enable) set rspan disable destination all
This command will disable all remote span destination session(s).
Do you want to continue (y/n) [n]? y
Disabled monitoring of remote span traffic on ports 9/1,9/2,9/3,9/4,9/5,9/6.
Console> (enable)

This example shows how to disable one destination session to a specific port:
Console> (enable) set rspan disable destination 4/1
Disabled monitoring of remote span traffic on port 4/1.
Console> (enable)

Related Commands show rspan

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-297
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set snmp access

set snmp access

Use the set snmp access command to define the access rights of an SNMP group with a specific security
model at different security levels.

set snmp access [-hex] groupname {security-model v1 | v2c} [read [-hex] readview]
[write [-hex] writeview] [notify [-hex] notifyview] [volatile | nonvolatile]

set snmp access [-hex] groupname {security-model v3} {noauthentication | authentication

| privacy} [read [-hex] readview] [write [-hex] writeview] [notify [-hex] notifyview]
[context [-hex] contextname] [exact | prefix] [volatile | nonvolatile]

Syntax Description -hex (Optional) Keyword to display the groupname, readview, writeview, and
notifyview in hexadecimal format.
groupname Name of the SNMP group.
security-model v1| v2c Keywords that specify security model v1 or v2c.
read readview (Optional) Keyword and variable that specify the name of the view that
allows you to see MIB objects.
write writeview (Optional) Keyword and variable that specify the name of the view that
allows you to configure the contents of an agent.
notify notifyview (Optional) Keyword and variable that specify the name of the view that
allows you to send a trap for MIB objects.
v3 Keyword that specifies security model v3.
context contextname (Optional) Keyword and variable to specify the name of the context
string and the way to match the context string; maximum of 32
characters.
volatile (Optional) Keyword that specifies that the storage type is defined as
temporary memory and that the content is deleted if the device is turned
off.
nonvolatile (Optional) Keyword that specifies that the storage type is defined as
persistent memory and the content remains after the device is power
cycled.
noauthentication Keyword that specifies that the security model is not set to use the
authentication protocol.
authentication Keyword that specifies the type of authentication protocol.
privacy Keyword that specifies the messages sent on behalf of the user are
protected from disclosure.

Defaults The defaults are as follows:

• storage type is nonvolatile.
• read readview is Internet OID space.
• write writeview is NULL OID.
• notify notifyview is NULL OID.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-298 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set snmp access

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you use special characters (nonprintable delimiters for the parameters) for groupname, readview,
writeview, and notifyview, you must use a hexadecimal keyword, which is one or two hexadecimal digits
separated by a colon (:); for example, 00:ab:34.
readview is assumed to be every object belonging to the Internet (1.3.6.1) OID space; you can use the
read option to override this state.
For writeview, you must also configure write access.
For notifyview, if a view is specified, any notifications in that view are sent to all users associated with
the group (an SNMP server host configuration must exist for the user).
For contextname, the string is treated as either a full context name or the prefix of a context name,
depending on whether you use the exact or prefix keyword. If you use the prefix keyword, a simple form
of wildcarding is used. For example, if you enter a contextname of vlan, vlan-1 and vlan-100 are selected.
If you do not specify a contextname, a NULL context string is used.

Examples This example shows how to set the SNMP access rights for a group:
Console> (enable) set snmp access cisco-group security-model v3 authentication
SNMP access group was set to cisco-group version v3 level authentication, readview
internet, nonvolatile.
Console> (enable)

Related Commands clear snmp access

show snmp access
show snmp context

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-299
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set snmp community

set snmp community

Use the set snmp community command to set SNMP communities and associated access types.

set snmp community {read-only | read-write | read-write-all} [community_string]

Syntax Description read-only Keyword that specifies to assign read-only access to the specified SNMP
community.
read-write Keyword that specifies to assign read-write access to the specified SNMP
community.
read-write-all Keyword that specifies to assign read-write-all access to the specified
SNMP community.
community_string (Optional) Name of the SNMP community.

Defaults The default configuration has the following communities and access types defined:
• public—read-only
• private—read-write
• secret—read-write-all

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines There are three configurable SNMP communities, one for each access type. If you do not specify the
community string, the community string configured for that access type is cleared.

Examples This example shows how to set read-write access to the SNMP community called yappledapple:
Console> (enable) set snmp community read-write yappledapple
SNMP read-write community string set.
Console> (enable)

This example shows how to clear the community string defined for read-only access:
Console> (enable) set snmp community read-only
SNMP read-only community string cleared.
Console> (enable)

Related Commands show snmp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-300 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set snmp extendedrmon netflow

set snmp extendedrmon netflow

Use the set snmp extendedrmon netflow command to enable or disable the SNMP extended Remote
Monitoring (RMON) NetFlow support for the Network Analysis Module (NAM).

set snmp extendedrmon netflow {enable | disable} {mod}

Syntax Description enable Keyword to enable the extended RMON support.

disable Keyword to disable the extended RMON support.
mod Module number of the extended RMON NAM.

Defaults By default, SNMP extended RMON NetFlow support is disabled.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to enable SNMP-extended RMON NetFlow support:
Console> (enable) set snmp extendedrmon netflow enable 2
Snmp extended RMON netflow enabled
Console> (enable)

This example shows how to disable SNMP-extended RMON NetFlow support:

Console> (enable) set snmp extendedrmon netflow disable 2
Snmp extended RMON netflow disabled
Console> (enable)

This example shows the response when the SNMP-extended RMON NetFlow feature is not supported:
Console> (enable) set snmp extendedrmon enable 4
NAM card is not installed.
Console> (enable)

Related Commands set snmp rmon

show snmp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-301
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set snmp group

set snmp group

Use the set snmp group command to establish a relationship between an SNMP group and a user with
a specific security model.

set snmp group [-hex] {groupname} user [-hex] {username} {security-model {v1 | v2c |
v3}} [volatile | nonvolatile]

Syntax Description -hex Keyword that displays the groupname and username in hexadecimal
format.
groupname Name of the SNMP group that defines an access control. The
maximum length is 32 bytes.
user Keyword that specifies the SNMP group username.
username Name of the SNMP user that belongs to the SNMP group. The
maximum length is 32 bytes.
security-model Keywords that specify security model v1, v2c, or v3.
v1 | v2c | v3
volatile (Optional) Keyword that specifies that the storage type is defined as
temporary memory and that the content is deleted if the device is
turned off.
nonvolatile (Optional) Keyword that specifies that the storage type is defined as
persistent memory and that the content remains after the device is
turned off and on again.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you use special characters (nonprintable delimiters for the parameters) for groupname or username,
you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:);
for example, 00:ab:34.

Examples This example shows how to establish a security model v3 relationship between the SNMP group named
cisco-group and a user named joe:
Console> (enable) set snmp group cisco-group user joe security-model v3
SNMP group was set to cisco-group user joe and version v3,nonvolatile.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-302 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set snmp group

Related Commands clear snmp group

show snmp group

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-303
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set snmp notify

set snmp notify

Use the set snmp notify command to set the notifyname in the snmpNotifyTable and set the notifytag
in the snmpTargetAddrTable.

set snmp notify [-hex] {notifyname} tag [-hex] {notifytag} [trap | inform] [volatile |
nonvolatile]

Syntax Description -hex (Optional) Keyword that displays notifyname and notifytag in hexadecimal
format.
notifyname Keyword that specifies a unique identifier to index the snmpNotifyTable.
tag Keyword that specifies the tag name in the taglist.
notifytag Keyword that specifies selected entries in the snmpTargetAddrTable.
trap (Optional) Keyword that specifies all messages that contain snmpv2-Trap
PDUs.
inform (Optional) Keyword that specifies all messages that contain InfoRequest
PDUs.
volatile (Optional) Keyword that specifies that the storage type is defined as
temporary memory and that the content is deleted if the device is turned
off.
nonvolatile (Optional) Keyword that specifies that the storage type is defined as
persistent memory and that the content remains after the device is power
cycled.

Defaults The defaults are as follows:

• Storage type is volatile.
• Notify type is trap.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you use special characters (nonprintable delimiters for the parameters) for the notifyname and
notifytag, you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a
colon (:); for example, 00:ab:34.

Examples This example shows how to set the SNMP notify for the notifyname hello and the notifytag world:
Console> (enable) set snmp notify hello tag world inform
SNMP notify name was set to hello with tag world notifyType inform, and storageType
nonvolatile.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-304 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set snmp notify

Related Commands clear snmp notify

show snmp notify

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-305
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set snmp rmon

set snmp rmon

Use the set snmp rmon command to enable or disable SNMP RMON support.

set snmp rmon {enable | disable}

Syntax Description enable Keyword that specifies to activate SNMP RMON support.
disable Keyword that specifies to deactivate SNMP RMON support.

Defaults By default, RMON support is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines RMON statistics are collected on a segment basis instead of a repeater-port basis for the Catalyst 4000
family group Ethernet modules.
The RMON feature uninstalls the domains for all of the interfaces on an Ethernet module that has been
removed from the system.
RMON is supported on Ethernet, Fast Ethernet, Gigabit Ethernet, and Token Ring switch ports.
When RMON is enabled, the supported RMON groups for Ethernet ports are Statistics, History, Alarms,
and Events, as specified in RFC 1757.
When RMON is enabled, the supported RMON groups for Token Ring ports are Mac-Layer Statistics,
Promiscuous Statistics, Mac-Layer History, Promiscuous History, Ring Station Order Table, Alarms,
and Events, as specified in RFC 1513 and RFC 1757.
Use of this command requires a separate software license.

Examples This example shows how to enable RMON support:

Console> (enable) set snmp rmon enable
SNMP RMON support enabled.
Console> (enable)

This example shows how to disable RMON support:

Console> (enable) set snmp rmon disable
SNMP RMON support disabled.
Console> (enable)

Related Commands show snmp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-306 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set snmp rmonmemory

set snmp rmonmemory

Use the set snmp rmonmemory command to set the memory usage limit as a percentage.

set snmp rmonmemory percentage

Syntax Description percentage Memory usage limit; see the “Usage Guidelines” section below for
additional information.

Defaults By default, the memory usage limit is 85 percent.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines This command is not supported by the NAM.

When you use this command, setting the percentage value to 85 does not mean that RMON can use
85 percent of memory. Rather it means that you cannot create new RMON entries or restore entries from
the NVRAM if memory usage exceeds 85 percent.
If you expect the device to run other sessions such as Telnet, set the memory limit at a lower value,
otherwise the new Telnet sessions may fail because the amount of available memory is insufficient.

Examples This example shows how to set the memory usage limit to 90%:
Console> (enable) set snmp rmonmemory 90
Console> (enable)

Related Commands clear snmp notify set snmp notify

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-307
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set snmp targetaddr

set snmp targetaddr

Use the set snmp targetaddr command to configure SNMP target address entries in the
snmpTargetAddressTable.

set snmp targetaddr [-hex] {addrname} param [-hex] {paramsname}{ip_addr} [udpport

{port}] [timeout {value}] [retries {value}] [volatile | nonvolatile] [taglist {[-hex] tag}]
[[-hex] tag]

Syntax Description -hex (Optional) Keyword that displays addrname, paramsname, and tag in
hexadecimal format.
addrname Arbitrary but unique name of the target agent; the maximum length is
32 bytes.
param Keyword that specifies an entry in the snmpTargetParamsTable which
provides parameters to be used when generating a message to the
target; the maximum length is 32 bytes.
paramsname Entry in the snmpTargetParamsTable; the maximum length is 32 bytes.
ip_addr IP address of the target.
udpport port (Optional) Keyword and variable that specify which UDP port of the
target host to use.
timeout value (Optional) Keyword and variable that specify the number of timeouts.
retries value (Optional) Keyword and variable that specify the number of retries.
volatile (Optional) Keyword that specifies that the storage type is defined as
temporary memory and that the content is deleted if the device is
turned off.
nonvolatile (Optional) Keyword that specifies that the storage type is defined as
persistent memory and that the content remains after the device is
power cycled.
taglist tag (Optional) Keyword and variables that specify a tag names in the
taglist. The maximum length for tag is 255 bytes.
tag (Optional) Keyword that specify the tag name.

Defaults The defaults are as follows:

• Storage type is nonvolatile.
• udpport is 162.
• timeout is 1500.
• retries is 3.
• taglist is NULL.

Command Types Switch command.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-308 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set snmp targetaddr

Command Modes Privileged.

Usage Guidelines If you use special characters (nonprintable delimiters for these parameters) for the addrname,
paramsname, tag, and tagvalue, you must use a hexadecimal keyword, which is one or two hexadecimal
digits separated by a colon (:); for example, 00:ab:34.

Examples This example shows how to set the target address in the snmpTargetAddressTable:
Console> (enable) set snmp targetaddr foo param bar 10.1.2.4 udpport 160 timeout 10
retries 3 taglist tag1 tag2 tag3
SNMP targetaddr name was set to foo with param bar ipAddr 10.1.2.4, udpport 160, timeout
10, retries 3, storageType nonvolatile with taglist tag1 tag2 tag3.
Console> (enable)

Related Commands clear snmp targetaddr

set snmp notify
clear snmp notify

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-309
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set snmp targetparams

set snmp targetparams

Use the set snmp targetparams command to configure the SNMP parameters used in the
snmpTargetParamsTable when generating a message to a target.

set snmp targetparams [-hex] {paramsname} user [-hex] {username} {security-model

{v1 | v2c}} {message-processing {v1 | v2c | v3}} [volatile | nonvolatile]

set snmp targetparams [-hex] {paramsname} user [-hex] {username} {security-model v3}
{message-processing v3 {noauthentication | authentication | privacy}} [volatile |
nonvolatile]

Syntax Description -hex Keyword that displays the paramsname and username in hexadecimal
format.
paramsname A unique identifier used to index the snmpTargetParamsTable; the
maximum length is 32 bytes.
user Keyword that specifies the SNMP group user name.
username Name of the SNMP user that belongs to the SNMP group; the maximum
length is 32 bytes.
security-model Keywords that specify security model v1 or v2c.
v1 | v2c
message-processing Keywords that specify the version number used by the message
v1 | v2c | v3 processing model.
security-model v3 Keywords that specify security model v3.
message-processing Keywords that specify version 3 is used by the message- processing
v3 model.
noauthentication Keyword that specifies security model is not set to use authentication
protocol.
authentication Keyword that specifies the type of authentication protocol.
privacy Keyword that specifies the messages sent on behalf of the user are
protected from disclosure.
volatile (Optional) Keyword that specifies that the storage type is defined as
temporary memory and that the content is deleted if the device is turned
off.
nonvolatile (Optional) Keyword that specifies that the storage type is defined as
persistent memory and that the content remains after the device is power
cycled.

Defaults The default storage type is volatile.

Command Types Switch command.

Command Modes Privileged.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-310 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set snmp targetparams

Usage Guidelines If you use special characters (nonprintable delimiters for these parameters) for the paramsname and
username, you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a
colon (:); for example, 00:ab:34.

Examples This example shows how to set target parameters in the snmpTargetParamsTable:
Console> (enable) set snmp targetparams bar user joe security-model v3 message-processing
v3 authentication
SNMP target params was set to bar v3 authentication, message-processing v3, user joe
nonvolatile.
Console> (enable)

Related Commands clear snmp targetparams

show snmp targetparams

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-311
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set snmp trap

set snmp trap

Use the set snmp trap command to enable or disable the different SNMP traps on the system or to add
an entry into the SNMP authentication trap receiver table.

set snmp trap {enable | disable} [all | module | chassis | bridge | auth | vtp |
ippermit | vmps | config | entity | stpx | syslog]

set snmp trap rcvr_addr rcvr_community [port rcvr_port] [owner rcvr_owner] [index rcvr_index]

Syntax Description enable Keyword that specifies to activate SNMP traps.

disable Keyword that specifies to deactivate SNMP traps.
all (Optional) Keyword that specifies all trap types.
module (Optional) Keyword that specifies the moduleUp and
moduleDown traps from the CISCO-STACK-MIB.
chassis (Optional) Keyword that specifies the ciscoSyslogMIB trap
from the CISCO-SYSLOG-MIB.
bridge (Optional) Keyword that specifies the newRoot and
topologyChange traps from RFC 1493 (the BRIDGE-MIB).
auth (Optional) Keyword that specifies the authenticationFailure
trap from RFC 1157.
vtp (Optional) Keyword that specifies the VTP from the
CISCO-VTP-MIB.
ippermit (Optional) Keyword that specifies the IP Permit Denied access
from the CISCO-STACK-MIB.
vmps (Optional) Keyword that specifies the vmVmpsChange trap
from the CISCO-VLAN-MEMBERSHIP-MIB.
config (Optional) Keyword that specifies the sysConfigChange trap
from the CISCO-STACK-MIB.
entity (Optional) Keyword that specifies the entityMIB trap from the
ENTITY-MIB.
stpx (Optional) Keyword that specifies the STPX trap.
syslog (Optional) Keyword that specifies the system log.
rcvr_addr IP address or IP alias of the system to receive SNMP traps.
rcvr_community Community string to use when sending authentication traps.
port rcvr_port (Optional) Keyword that specifies the UDP port and port
number. This value for rcvr_port can be from 0 to 65,535.
owner rcvr_owner (Optional) Keyword that identifies the user who configured the
settings for snmp trap. The rcvr_owner can be from 1 to 21
characters in length.
index rcvr_index (Optional) Keyword that identifies this entry. The rcvr_index
is a value from 1 to 65,535.

Defaults By default, SNMP traps are disabled.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-312 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set snmp trap

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines An IP permit trap is sent when unauthorized access based on the IP permit list is attempted.
Use the show snmp command to verify that the appropriate traps were configured.

Examples This example shows how to enable SNMP chassis traps:

Console> (enable) set snmp trap enable chassis
SNMP chassis alarm traps enabled.
Console> (enable)

This example shows how to enable all traps:

Console> (enable) set snmp trap enable
All SNMP traps enabled.
Console> (enable)

This example shows how to disable SNMP chassis traps:

Console> (enable) set snmp trap disable chassis
SNMP chassis alarm traps disabled.
Console> (enable)

This example shows how to add an entry in the SNMP trap receiver table:
Console> (enable) set snmp trap 192.122.173.42 public
SNMP trap receiver added.
Console> (enable)

Related Commands clear ip permit

set ip permit
show ip permit
show port counters
show snmp
test snmp trap

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-313
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set snmp user

set snmp user

Use the set snmp user command to configure a new SNMP user.

set snmp user [-hex] {username} {remote {engineid}} [authentication {md5 | sha |
authpassword}] [privacy {privpassword}] [volatile | nonvolatile]

Syntax Description -hex (Optional) Keyword that displays username in hexadecimal

format.
username Name of the SNMP user.
remote engineid Keyword and variable that specify the remote SNMP engine ID.
authentication (Optional) Keyword that specifies the authentication protocol.
md5 Keyword that specifies HMAC-MD5-96 authentication protocol.
sha Keyword that specifies HMAC-SHA-96 authentication protocol.
authpassword Password for authentication.
privacy (Optional) Keyword and variable that enable the host to encrypt
privpassword the contents of the message sent to or from the agent; the
maximum length is 32 bytes, password for privacy.
volatile (Optional) Keyword that specifies that the storage type is defined
as temporary memory and the content is deleted if the device is
turned off.
nonvolatile (Optional) Keyword that specifies that the storage type is defined
as persistent memory and the content remains after the device is
power cycled.

Defaults The default storage type is volatile.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you use special characters (nonprintable delimiters for these parameters) for username, you must use
a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example,
00:ab:34.
authpassword and privpassword must be hexadecimal characters without delimiters in between.
If authentication is not specified, the security level default will be noauthentication. If privacy is not
specified, the default will be no privacy.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-314 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set snmp user

Examples This example shows how to set a specific user name:

Console> (enable) set snmp user joe
Snmp user was set to joe authProt no-auth privProt no-priv with engineid 00:00.
Console> (enable)

This example shows how to set a specific user name, authentication, and authpassword:
Console> (enable) set snmp user John authentication md5 arizona2
Snmp user was set to John authProt md5 authPasswd arizona2. privProt no-priv wi.
Console> (enable)

Related Commands clear snmp user

show snmp user

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-315
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set snmp view

set snmp view

Use the set snmp view command to configure the SNMP MIB view.

set snmp view [-hex] {viewname} {subtree} [mask] [included | excluded] [volatile |
nonvolatile]

Syntax Description -hex (Optional) Keyword that displays the viewname in hexadecimal format.
viewname Name of a MIB view.
subtree The MIB subtree.
mask (Optional) Keyword that specifies that the bit mask is used with the
subtree. A bit mask can be all one’s, all zero’s or any combination; the
maximum length is 3 bytes.
included | (Optional) Keywords that specify that the MIB subtree is included or
excluded excluded.
volatile (Optional) Keyword that specifies that the storage type is defined as
temporary memory and the content is deleted if the device is turned off.
nonvolatile (Optional) Keyword that specifies that the storage type is defined as
persistent memory and the content remains after the device is turned off
and on again.

Defaults The defaults are as follows:

• Storage type is volatile.
• Bit mask is NULL.
• MIB subtree is included.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you use special characters (nonprintable delimiters for these parameters) for viewname, you must use
a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example,
00:ab:34.
A MOB subtree with a mask defines a view subtree. The MIB subtree can be in OID format or a text
name mapped to a valid OID.

Examples This example shows how to assign a subtree to the view public:
Console> (enable) set snmp view public 1.3.6.1 included
Snmp view name was set to public with subtree 1.3.6.1 included, nonvolatile.
Control> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-316 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set snmp view

This example shows the response when the subtree is incorrect:

Console> (enable) set snmp view stats statistics excluded
Statistics is not a valid subtree OID
Control> (enable)

Related Commands clear snmp view

show snmp view

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-317
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set span

set span
Use the set span command to enable or disable SPAN and to set up the switch port and VLAN analyzer
for multiple SPAN sessions.

set span disable [dest_mod/dest_port | all]

set span {src_mod/src_ports... | src_vlan...} {dest_mod/dest_port} [rx | tx | both]

[filter {vlan}][inpkts {enable | disable}] [learning {enable | disable}]
[multicast {enable | disable}] [create]

Syntax Description disable Keyword that specifies to disable SPAN.

dest_mod (Optional) Monitoring module (SPAN destination).
dest_port (Optional) Monitoring port (SPAN destination).
all (Optional) Keyword that specifies to disable the spanning for all VLANs.
src_mod Monitored module (SPAN source).
src_ports... Monitored ports (SPAN source).
src_vlan... Monitored VLAN (SPAN source).
rx (Optional) Keyword that specifies that information received at the source is
monitored.
tx (Optional) Keyword that specifies that information transmitted from the source is
monitored.
both (Optional) Keyword that specifies that information both transmitted from the source
and received at the source is monitored.
filter (Optional) Keyword that specifies that VLANs are filtered.
vlan Number of the VLAN.
inpkts enable (Optional) Keywords that specify to enable the receiving of normal inbound traffic on
the SPAN destination port.
inpkts disable (Optional) Keywords that specify to disable the receiving of normal inbound traffic
on the SPAN destination port.
learning (Optional) Keywords that specify to learn the packet’s source address.
enable
learning (Optional) Keywords that specify to not learn the packet’s source address.
disable
multicast (Optional) Keywords that specify to enable the receiving multicast packets on the
enable SPAN destination port.
multicast (Optional) Keywords that specify to disable the receiving multicast packets on the
disable SPAN destination port.
create (Optional) Keyword that specifies to create a new SPAN session.

Defaults The default is that SPAN is not set up.

learning is enabled.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-318 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set span

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines After you install an Access Gateway module on your switch, you cannot configure the internal
Gigabit Ethernet port as a SPAN destination port.
You can configure multiple SPAN sessions to run at the same time. One ingress SPAN session (RX or
Both direction) and four egress SPAN sessions (TX direction only) can be configured.
A trunk port can be configured as a source or destination port. If the destination port is a trunk port, the
outgoing packets through the SPAN port will carry ISL or 802.1Q VLAN headers.
If SPAN is enabled, and you change the VLAN configuration of the SPAN port (destination), you must
disable SPAN before the new configuration will be in effect.
If SPAN is enabled, and you disable a source or destination port, the SPAN function will not work until
you enable SPAN on both ports.
You can configure a disabled port to be a source or destination port, but the SPAN function will not work
until you enable SPAN on both ports.
If SPAN is enabled for monitoring a particular VLAN, the number of ports being monitored changes
when you move a switched port into or out of the specified monitored VLAN.
FDDI port can also be a source port.
Source and destination ports cannot be the same port.
After SPAN is enabled, if no parameters were ever set, the first configured SPAN is used as a reference.
You can configure additional SPAN ports which monitor VLANs only. These ports support a source of
one or more VLANs and require the destination port to be a trunk-capable port. This port will filter all
traffic except traffic from the configured VLAN for that port.
For monitoring inbound traffic, only one ingress session (or both directions) SPAN is allowed regardless
of the port-based SPAN. An egress SPAN can coexist with other SPAN sessions.
Use either a dedicated RMON probe or a network analyzer to monitor ports.
Use the inpkts keyword with the enable option to allow the SPAN destination port to receive normal
incoming traffic in addition to the traffic mirrored from the SPAN source. Use the disable option to
prevent the SPAN destination port from receiving normal incoming traffic.
The keyword learning is dependent on the inpkts option. If the inpkts option is disabled, learning will
not take effect. The inpkts option must be set to enable to use learning.
When the keyword learning is enabled, the dont_learn control bit is disabled, allowing the system to
learn a packet’s source address. When learning is disabled, the packet is forwarded to its destination as
usual.
If you are configuring the Gigabit EtherChannel switching module VLAN, only the both argument is
allowed, you cannot specify tx or rx.
You cannot disable multicast on SPAN ports.
If you are running a supervisor engine software release prior to release 4.5(1), we recommend that you
configure only a single source port to be monitored. With the supervisor engine software release 4.5(1)
and later, a single source port will be the standard Token Ring SPAN configuration.
You cannot monitor a VLAN to which none of the ports belong.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-319
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set span

If you specify a set of VLANs with the filter option, the traffic spanned by the session is limited to the
VLANs specified. Use this option when you want to select a subset of the VLANs carried by a trunk in
PSPAN sessions.
VLAN filtering is not available for VSPAN sessions.

Examples This example shows how to configure SPAN so that both the transmit traffic and receive traffic on the
source port (1/1) is mirrored to the destination port (2/1), and how to verify SPAN configuration:
Console> (enable) set span 1/1 2/1
Enabled monitoring of Port 1/1 transmit/receive traffic by Port 2/1
Console> (enable) show span
Status : enabled
Admin Source : Port 1/1
Oper Source : Port 1/1
Destination : Port 2/1
Direction : transmit/receive
Incoming Packets: disabled
Console> (enable)

This example shows how to set VLAN 522 as the SPAN source and port 2/1 as the SPAN destination:
Console> (enable) set span 522 2/1
Enabled monitoring of VLAN 522 transmit/receive traffic by Port 2/1
Console> (enable) show span
Status : enabled
Admin Source : VLAN 522
Oper Source : Port 3/1-2
Destination : Port 2/1
Direction : transmit/receive
Incoming Packets: disabled
Console> (enable)

This example shows how to set VLAN 522 as the SPAN source and port 2/12 as the SPAN destination:
Console> (enable) set span 522 2/12 tx inpkts enable
SPAN destination port incoming packets enabled.
Enabled monitoring of VLAN 522 transmit traffic by Port 2/12
Console> (enable) show span
Status : enabled
Admin Source : VLAN 522
Oper Source : Port 2/1-2
Destination : Port 2/12
Direction : transmit
Incoming Packets: enabled
Console> (enable)

This example shows how to enable learning on the SPAN source and port 1/1:
Console> (enable) set span 522 1/1 learning enable
Overwrote Port 1/1 to monitor transmit/receive traffic of VLAN 522
Incoming Packets disabled. Learning enabled. Multicast enabled.
Console> (enable)

This example shows how to disable learning on the SPAN source and port 1/1:
Console> (enable) set span 522 1/1 learning disable
Overwrote Port 1/1 to monitor transmit/receive traffic of VLAN 522
Incoming Packets disabled. Learning disabled. Multicast enabled.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-320 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set span

Related Commands clear config—switch

show span

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-321
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree backbonefast

set spantree backbonefast

Use the set spantree backbonefast command to enable or disable the spanning tree Backbone Fast
Convergence feature.

set spantree backbonefast {enable | disable}

Syntax Description enable Keyword that specifies to enable Backbone Fast Convergence.
disable Keyword that specifies to disable Backbone Fast Convergence.

Defaults By default, Backbone Fast Convergence is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines Backbone Fast Convergence is not supported on Token Ring VLANs.
For Backbone Fast Convergence to work, you must enable it on all switches in the network.

Examples This example shows how to enable Backbone Fast Convergence:

Console> (enable) set spantree backbonefast enable
Backbonefast enabled for all VLANs.
Console> (enable)

Related Commands show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-322 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree bpdu-skewing

set spantree bpdu-skewing

Use the set spantree bpdu-skewing command to enable or disable collection of the spanning tree BPDU
skewing detection statistics.

set spantree bpdu-skewing {enable | disable}

Syntax Description enable Keyword to enable the collection of BPDU skewing detection
statistics.
disable Keyword to disable the collection of BPDU skewing detection
statistics.

Defaults By default, spanning tree BPDU skewing detection is enabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines This command is not supported by the NAM.

When network convergence is slow due to skewing, you can use this command to help troubleshoot.
Skewing occurs when spanning tree timers lapse, and expected BPDUs are not received and spanning
tree detects topology changes. The difference between the expected result and those actually received is
a “skew.” The skew causes BPDUs to be reflooded onto the network to keep the spanning tree topology
database up to date.

Examples This example shows how to enable the BPDU skew detection feature:
Console> (enable) set spantree bpdu-skewing enable
Spantree bpdu-skewing enabled on this switch.
Console> (enable)

This example shows how to disable the BPDU skew detection feature:
Console> (enable) set spantree bpdu-skew disable
Spantree bpdu-skewing disabled on this switch.
Console> (enable)

Related Commands show spantree bpdu-skewing

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-323
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree defaultcostmode

set spantree defaultcostmode

Use the set spantree defaultcostmode command to specify the spanning tree default port cost mode.

set spantree defaultcostmode {short | long}

Syntax Description short Keyword to set the default port cost for port speeds slower than
10 gigabits.
long Keyword to set the default port cost mode port speeds of
10 gigabits and faster.

Defaults By default, the spanning tree default port cost mode is short.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The set spantree defaultcostmode long command is available in PVST+ mode only. If you enter this
command in MISTP or MISTP-PVST+ mode, this message displays:
In MISTP or MISTP-PVST+ mode, default portcost and portinstancecost always
use long format default values.

All switches in a network must have the same default. If any switch in the network supports port speeds
of 10 gigabits and greater, the default cost mode must be set to long on all the switches in the network.
For port speeds of 1 gigabit and greater, the default port cost should be set to long. For port speeds of
less than 10 gigabits, the default port cost can be set to short.
The default path cost is based on port speed; see Table 2-9 and Table 2-10 for default settings.

Table 2-9 Default Port Cost—Short Mode

Port Speed Default Port Cost

4 MB 250
01 Mb 100
16 Mb 62
100 Mb 19
155 Mb 14
1 Gb 4
10 Gb 2

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-324 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree defaultcostmode

Table 2-10 Default Port Cost—Long Mode

Port Speed Default Port Cost

100 Kb 200,000,000
1 Mb 20,000,000
10 Mb 2,000,000
100 Mb 200,000
1 Gb 20,000
10 Gb 2,000
100 Gb 200
1 Tb 20
10 Tb 2

Examples This example shows how to set the spanning tree default port cost mode to long:
Console> (enable) set spantree defaultcostmode long
Portcost and portvlancost set to use long format default values.
Console> (enable)

Related Commands show spantree defaultcostmode

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-325
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree disable

set spantree disable

Use the set spantree disable command to disable the spanning tree algorithm for all VLANs.

set spantree disable all

Syntax Description all Keyword that specifies to disable the spanning tree algorithm for all
VLANs.

Defaults By default, all spanning trees are enabled.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to disable the spanning tree algorithm:
Console> (enable) set spantree disable al1
VLAN 1 bridge spanning tree disabled.
Console> (enable)

Related Commands set spantree enable

show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-326 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree enable

set spantree enable

Use the set spantree enable command to enable the spanning tree algorithm for a VLAN or all VLANs.

set spantree enable all

Syntax Description all Keyword that specifies to enable the spanning tree algorithm for all
VLANs.

Defaults By default, all spanning trees are enabled.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to activate the spanning tree algorithm:
Console> (enable) set spantree enable all
VLAN 1 bridge spanning tree enabled.
Console> (enable)

Related Commands set spantree disable

show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-327
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree fwddelay

set spantree fwddelay

Use the set spantree fwddelay command to set the bridge forward delay for a VLAN.

set spantree fwddelay delay [vlan]

Syntax Description delay Number of seconds for the bridge forward delay. Valid values are 4
to 30 seconds.
vlan (Optional) Number of the VLAN; if a VLAN number is not
specified, VLAN 1 is assumed. Valid values are 1 to 1005.

Defaults By default, the bridge forward delay is set to 15 seconds for all VLANs.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to set the bridge forward delay for VLAN 100 to 16 seconds:
Console> (enable) set spantree fwddelay 16 100
Spantree 100 forward delay set to 16 seconds.
Console> (enable)

Related Commands show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-328 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree guard

set spantree guard

Use the set spantree guard command to enable or disable spantree guard features.

set spantree guard {none | root | uplink} {mod/port}

Syntax Description none Keyword to disable the spantree guard feature.

root Keyword to enable root guard.
uplink Keyword to enable UplinkGuard.
mod/port Number of the module and port(s) on the module.

Defaults By default, spantree guard features are disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You may want to prevent switches from becoming the root switch. The root guard feature forces a port
to become a designated port so that no switch on the other end of the link can become a root switch.
When you enable root guard on a per-port basis, it is automatically applied to all of the active VLANs
to which that port belongs. When you disable root guard, it is disabled for the specified port(s). If a port
goes into the root-inconsistent state, it will automatically enters the listening state.
You may want to designate one or more ports on switches as either a root or a backup root port. When
you enable uplink guard on a per-port basis, it is automatically applied to all of the active VLANs to
which that port belongs. When you disable uplink guard, it is disabled for the specified port(s). If a port
goes into the uplink-inconsistent state, it will automatically enters the listening state.

Examples This example shows how to enable root guard on port 5/1:
Console> (enable) set spantree guard root 5/1
Rootguard on port 5/1 is enabled.
Warning!! Enabling rootguard may result in a topolopy change.
Console> (enable)

This example shows how to enable the UplinkGuard feature on port 5/1:
Console> (enable) set spantree guard uplink 5/1
Rootguard is enabled on port 5/1, enabling uplinkguard will disable rootguard on
this port.
Do you want to continue (y/n) [n]? y
Uplinkguard on port 5/1 is enabled.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-329
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree guard

Related Commands show spantree guard

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-330 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree hello

set spantree hello

Use the set spantree hello command to set the bridge hello time for a VLAN.

set spantree hello interval [vlan]

Syntax Description interval Number of seconds the system waits before sending a bridge hello
message (a multicast message indicating that the system is active).
Valid values are 1 to 10.
vlan (Optional) Number of the VLAN; if a VLAN number is not
specified, VLAN 1 is assumed. Valid values are 1 to 1005.

Defaults By default, the bridge hello time is set to two seconds for all VLANs.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to set the spanning tree hello time for VLAN 100 to three seconds:
Console> (enable) set spantree hello 3 100
Spantree 100 hello time set to 3 seconds.
Console> (enable)

Related Commands show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-331
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree macreduction

set spantree macreduction

Use the set spantree macreduction command to enable or disable the spanning tree MAC address
reduction feature.

set spantree macreduction {enable | disable}

Syntax Description enable Keyword to enable MAC address reduction.

disable Keyword to disable MAC address reduction.

Defaults By default, MAC address reduction is enabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The MAC address reduction feature allows the switch to support a large number of spanning tree
instances with a very limited number of MAC addresses, and still maintain the IEEE 802.1D bridge-ID
requirement for each STP instance.
You cannot disable this feature if extended range VLANs exist.

Examples This example shows how to disable the MAC address reduction feature:
Console> (enable) set spantree macreduction disable
MAC address reduction disabled
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-332 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree maxage

set spantree maxage

Use the set spantree maxage command to set the bridge maximum aging time for a VLAN.

set spantree maxage agingtime [vlan]

Syntax Description agingtime Maximum number of seconds that the system retains the information received from
other bridges through Spanning Tree Protocol. Valid values are 6 to 40 seconds.
vlan (Optional) Number of the VLAN; if a VLAN number is not specified, VLAN 1 is
assumed. Valid values are 1 to 1005.

Defaults By default, the bridge maximum aging time is 20 seconds for all VLANs.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to set the maximum aging time for VLAN 1000 to 25 seconds:
Console> (enable) set spantree maxage 25 1000
Spantree 1000 max aging time set to 25 seconds.
Console> (enable)

Related Commands show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-333
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree mode

set spantree mode

Use the set spantree mode command to configure the type of Spanning Tree Protocol mode to run.

set spantree mode {mistp | pvst+ | mistp-pvst+}

Syntax Description mistp Keyword to specify MISTP mode.

pvst+ Keyword to specify PVST+ mode.
mistp-pvst+ Keywords to allow the switch running MISTP to tunnel BPDUs with remote
switches running PVST+.

Defaults By default, the Spanning Tree Protocol mode is PVST+.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines When you connect to a switch using Telnet and try to change the spanning-tree mode from PVST+ to
MISTP or MISTP-PVST+, and no VLANs are mapped to any instance on that switch, this warning
message displays:
Console> (enable) set spantree mode mistp
Warning!! Changing the STP mode from a telnet session will disconnect the
session because there are no VLANs mapped to any MISTP instance.
Do you want to continue [n]?

When you connect to a switch using Telnet and try to change the spanning-tree mode from MISTP or
MISTP-PVST+ to PVST+, or when you connect to a switch by Telnet and try to change the spanning-tree
mode from PVST+ to MISTP or MISTP-PVST+, and additional VLAN-instances are mapped on that
switch, this warning message displays:
Console> (enable) set spantree mode pvst+
Warning!! Changing the STP mode from a telnet session might disconnect the
session.
Do you want to continue [n]?

When you change from MISTP to PVST+ and there more than 8,000 VLAN ports currently configured
on the switch, this warning message displays:
Console> (enable) set spantree mode pvst+
Warning!! This switch has 12345 VLAN-ports currently configured for STP.
Going out of MISTP mode could impact system performance.
Do you want to continue [n]?

If you change the spanning-tree mode from PVST+ to MISTP or MISTP to PVST+, the previous STP mode
stops, all the information collected at run time is used to build the port database for the new mode, and the
new STP mode restarts the computation of the active topology from zero. All the parameters of the previous
STP per VLAN or per instance are kept in NVRAM.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-334 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree mode

If you change the spanning-tree mode from PVST+ to MISTP or MISTP to PVST+ and Backbone Fast
is enabled, this message displays:
Console> (enable) set spantree mode mistp
Cannot change the spantree mode to MISTP when backbonefast is enabled.

Examples This example shows how to set the spanning-tree mode to PVST+:
Console> (enable) set spantree mode pvst+
Warning!! Changing the STP mode from a telnet session might disconnect the session.
Do you want to continue [n]?y
Spantree mode set to PVST+.
Console> (enable)

This example shows what happens if you change the spanning tree mode from PVST+ to MISTP:
Console> (enable) set spantree mode mistp
Warning!! Changing the STP mode from a telnet session will disconnect the session because
there are no VLANs mapped to any MISTP instance.
Do you want to continue [n]? y
Console> (enable)

Related Commands set vlan

show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-335
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree portcost

set spantree portcost

Use the set spantree portcost command to set the path cost for a port.

set spantree portcost {mod_num/port_num} cost

Syntax Description mod_num Number of the module.

port_num Number of the port on the module.
cost Number that indicates the cost of the path. Valid values are 1 to 65535. Zero (0) is the
low cost and 65535 the high cost.

Defaults The default configuration is as follows:

10-Gbps module port cost = 2
1-Gbps module port cost = 4
622-Mbps module port cost = 6
155-Mbps module port cost = 14
100-Mbps module port cost = 19
45-Mbps module port cost = 39
16-Mbps module port cost = 80
10-Mbps module port cost = 100
4-Mbps module port cost = 250
10/100-Mbps module port cost = See “Usage Guidelines”
4/16-Mbps module port cost = See “Usage Guidelines”

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines Spanning Tree Protocol uses port path costs to determine which port to select as a forwarding port. You
should assign lower numbers to ports attached to faster media (such as full duplex) and higher numbers
to ports attached to slower media. The possible range is 0 to 65535.
For 10/100 and 4/16 modules, the default port cost is set automatically depending on the current speed
of the port. For example, if a 10/100 port is working at 10 Mbps, the port cost is 100. If the port speed
changes to 100 Mbps, the port cost adjusts automatically to 19.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-336 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree portcost

Examples The following example shows how to set the port cost for port 12 on module 2 to 19:
Console> (enable) set spantree portcost 2/12 19
Spantree port 2/12 path cost set to 19.
Console> (enable)

Related Commands show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-337
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree portfast

set spantree portfast

Use the set spantree portfast command to allow a port that is connected to a single workstation or PC
to start faster when it is connected.

set spantree portfast mod_num/port_num {enable | disable}

Syntax Description mod_num Number of the module.

port_num Number of the port on the module.
enable Keyword that specifies to enable the spanning tree port fast-start
feature on the port.
disable Keyword that specifies to disable the spanning tree port fast-start
feature on the port.

Defaults By default, the port fast-start feature is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines When a port configured with the spantree portfast enable command is connected, the port immediately
enters the spanning tree forwarding state instead of going through the normal spanning tree states such
as listening and learning. Use this command on ports that are connected to a single workstation or PC
only; do not use it on ports that are connected to networking devices such as hubs, routers, switches,
bridges, or concentrators.

Examples This example shows how to enable the spanning tree port fast-start feature on port 2 on module 1:
Console> (enable) set spantree portfast 1/2 enable

Warning: Spantree port fast start should only be enabled on ports connected to a single
host. Connecting hubs, concentrators, switches, bridges, etc. to a fast start port can
cause temporary spanning tree loops. Use with caution.
Spantree port 1/2 fast start enabled.
Console> (enable)

Related Commands show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-338 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree portfast bpdu-filter

set spantree portfast bpdu-filter

Use the set spantree portfast bpdu-filter command to enable or disable BPDU packet filtering on the
switch.

set spantree portfast bpdu-filter {enable | disable}

Syntax Description enable Keyword to enable BPDU packet filtering.

disable Keyword to disable BPDU packet filtering.

Defaults By default, BPDU packet filtering is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines This command is not supported by the NAM.

BPDU packet filtering turns off BPDU transmission on PortFast-enabled ports and nontrunking ports.

Examples This example shows how to enable BPDU packet filtering:

Console> (enable) set spantree portfast bpdu-filter enable
Spantree portfast bpdu-filter enabled on this switch.
Console> (enable)

This example shows how to disable BPDU packet filtering:

Console> (enable) set spantree portfast bpdu-filter disable
Spantree portfast bpdu-filter disabled on this switch.
Console> (enable)

Related Commands show spantree portfast

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-339
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree portfast bpdu-guard

set spantree portfast bpdu-guard

Use the set spantree portfast bpdu-guard command to enable and disable BPDU Guard on the switch.
You can prevent loops by moving a nontrunking port configured for PortFast into an ErrDisable state
when a BPDU is received on that port.

set spantree portfast bpdu-guard {enable | disable}

Syntax Description enable Keyword to enable spanning tree PortFast BPDU Guard.
disable Keyword to disable spanning tree PortFast BPDU Guard.

Defaults By default, PortFast BPDU-Guard is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines When you enable PortFast BPDU Guard, a nontrunking PortFast-enabled port is moved into an
ErrDisable state when a BPDU is received on that port. When you disable PortFast BPDU Guard, a
PortFast-enabled nontrunking port will stay up when it receives BPDUs. This may cause spanning tree
loops.

Examples This example shows how to enable the spanning tree PortFast BPDU-Guard:
Console> (enable) set spantree portfast bpdu-guard enable
Spantree portfast bpdu-guard enabled on this switch.
Console> (enable)

This example shows how to disable the spanning tree PortFast BPDU-Guard:
Console> (enable) set spantree portfast bpdu-guard disable
Spantree portfast bpdu-guard disabled on this switch.
Console> (enable)

Related Commands show spantree summary

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-340 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree portinstancecost

set spantree portinstancecost

Use the set spantree portinstancecost command to assign the path cost of the port for the specified
instances.

set spantree portinstancecost mod/port [cost cost] [instances]

Syntax Description mod/port Number of the module and the port on the module.
cost cost (Optional) Keyword and variable to indicate the path cost; see the
“Usage Guidelines” section for additional information.
instances (Optional) Instance number. Valid values are 1 to 16.

Defaults The default path cost is based on port speed; see Table 2-11 for default settings.

Table 2-11 Default Port Cost—Short Mode

Port Speed Default Port Cost

4 Mb 250
10 Mb 100
16 Mb 62
100 Mb 19
155 Mb 14
1 Gb 4
10 Gb 2

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines This command is not supported by the NAM.

If the spanning tree mode is short and long or MISTP, valid cost values are 1 to 65535; otherwise valid
cost values are 1 to 2000000.
The portinstancecost applies to trunk ports only.
The value specified is used as the path cost of the port for the specified instances. The rest of the
instances have a path cost equal to the port path cost set via the set spantree instancecost command (if
not set, the value is the default path cost of the port).

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-341
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree portinstancecost

Examples This example shows how to use the set spantree portinstancecost command and explicitly specify the
path cost of a port:
Console> (enable) set spantree portinstancecost 2/10 cost 6 1-10
Port 2/10 instances 11-16 have path cost 2000000.
Port 2/10 instances 1-10 have path cost 6.
This parameter applies to trunking ports only.
Console> (enable)

These examples show how to use the set spantree portinstancecost command without explicitly
specifying the path cost of a port:
Console> (enable) set spantree portinstancecost 1/2
Port 1/2 Instances 1-1005 have path cost 3100.
Console> (enable)

Console> (enable) set spantree portinstancecost 1/2 16

Port 1/2 Instances 16,22-1005 have path cost 3100.
Console> (enable)

This example shows the display if you enter the command when PVST+ is enabled:
Console> (enable) set spantree portinstancecost 3/1
This command is only valid when STP is in MISTP or MISTP-PVST+ mode.
Console> (enable)

Related Commands clear spantree portinstancecost

show spantree mistp-instance

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-342 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree portinstancepri

set spantree portinstancepri

Use the set spantree portinstancepri command to set the port priority for instances in the trunk port.

set spantree portinstancepri {mod/port} priority [instances]

Syntax Description mod/port Number of the module and the port on the module.
priority Number that represents the cost of a link in a spanning tree bridge. The priority
level is from 0 to 63, with 0 indicating high priority and 63 indicating low
priority.
instances (Optional) Instance number. Valid values are from 1 to 16.

Defaults By default, the port priority is set to 0, with no instances specified.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines This command is not supported by the NAM.

Use this command to add instances to a specified port priority level. Subsequent calls to this command
do not replace instances that are already set at a specified port priority level.
This feature is not supported for the MSM.
The set spantree portinstancepri command applies to trunk ports only. If you enter this command, you
see this message:
Port xx is not a trunk-capable port

Examples This example shows how to set the port priority for module 1, port 2, on specific instances:
Console> (enable) set spantree portinstancepri 1/2 16 1-11
Port 1/2 instances 1-11 using portpri 16.
This parameter applies to trunking ports only.
Console> (enable)

Related Commands clear spantree portinstancecost

show spantree mistp-instance

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-343
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree portpri

set spantree portpri

Use the set spantree portpri command to set the bridge priority for a spanning tree port or TrCRF.

set spantree portpri {mod_num/port_num} [priority]

Syntax Description mod_num Number of the module.

port_num Number of the port on the module.
priority (Optional) Number that represents the cost of a link in a spanning tree bridge. Valid
values are 0 (high) to 63 (low).

Defaults By default, all ports with bridge priority are set to 32.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The specified bridge priority on an ATM port applies to all emulated LANs on that port.

Examples This example shows how to set the priority of port 1 on module 4 to 63:
Console> (enable) set spantree portpri 4/1 63
Bridge port 4/1 priority set to 63.
Console> (enable)

Related Commands show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-344 78-12648-02
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree portvlancost

set spantree portvlancost

Use the set spantree portvlancost command to assign a lower path cost to a set of VLANs on a port.

set spantree portvlancost mod_num/port_num [cost cost_value] [preferred_vlans]

Syntax Description mod_num Number of the module.

port_num Number of the port.
cost cost_value (Optional) Keyword to indicate the path cost. The port VLAN cost
applies only to trunk ports. Valid values are 1 to 65535.
preferred_vlans (Optional) If you do not list a specific VLAN, the VLANs that were
listed in prior use of this command are affected. If you do not list a
specific cost, and previous cost values are specified in prior use of the
command, then the port VLAN cost is set to one less than the current
port cost for a port. However, this may not assure load balancing in all
cases. Valid values are 1 to 1005.

Defaults The value specified is used as the path cost of the port for the specified set of VLANs. The rest of the
VLANs have a path cost equal to the port path cost, set with the set spantree portcost command. If the
path cost is not set, the value is the default path cost of the port.

Command Types Switch command.

Command Modes Privileged.

Examples These examples show various ways to use the set spantree portvlancost command:
Console> (enable) set spantree portvlancost 2/10 cost 25 1-20
Cannot set portvlancost to a higher value than the port cost, 10, for port 2/10.
Console> (enable)

Console> (enable) set spantree portvlancost 2/10 1-20

Port 2/10 VLANs 1-20 have a path cost of 9.
Console> (enable)

Console> (enable) set spantree portvlancost 2/10 cost 4 1-20

Port 2/10 VLANs 1-20 have path cost 4.
Port 2/10 VLANs 21-1000 have path cost 10.
Console> (enable)
Console> (enable) set spantree portvlancost 2/10 cost 6 21
Port 2/10 VLANs 1-21 have path cost 6.
Port 2/10 VLANs 22-1000 have path cost 10.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-02 2-345
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree portvlancost

These examples show how to use the set spantree portvlancost command without explicitly
specifying cost:
Console> (enable) set spantree portvlancost 1/2
Port 1/2 VLANs 1-1005 have path cost 3100.
Console> (enable)

Console> (enable) set spantree portvlancost 1/2 21

Port 1/2 VLANs 1-20,22-1005 have path cost 3100.
Port 1/2 VLANs 21 have path cost 3099.
Console> (enable)

Related Commands clear spantree portvlancost

show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-346 78-12648-02
 2
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree portvlanpri

set spantree portvlanpri

Use the set spantree portvlanpri command to set the port priority for a subset of VLANs in the trunk
port.

set spantree portvlanpri mod_num/port_num priority [vlans]

Syntax Description mod_num Number of the module.

port_num Number of the port.
priority Number that represents the cost of a link in a spanning tree bridge. The priority
level is 0 to 63, with 0 indicating high priority and 63 indicating low priority.
vlans (Optional) VLANs that use the specified priority level.

Defaults By default, the port VLAN priority is set to 0 with no VLANs specified.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You can use this command to add VLANs to a specified port priority level. Subsequent calls to this
command do not replace VLANs that are already set at a specified port priority level.
The set spantree portvlanpri command applies only to trunk ports.

Examples This example shows how to set the port priority to 16 for module 1, port 2, on VLANs 21 to 40:
Console> (enable) set spantree portvlanpri 1/2 16 21-40
Port 1/2 vlans 3,6-20,41-1000 using portpri 32
Port 1/2 vlans 1-2,4-5,21-40 using portpri 16
Console> (enable)

Related Commands clear spantree portvlanpri

show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-347
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree priority

set spantree priority

Use the set spantree priority command to set the bridge priority for a VLAN.

set spantree priority bridge_priority [vlan]

Syntax Description bridge_priority Number representing the priority of the bridge; see the “Usage
Guidelines” section for valid values.
vlan (Optional) Number of the VLAN. If you do not specify a VLAN
number, VLAN 1 is used. Valid values are 1 to 1005.

Defaults By default, the bridge priority is set to 32768.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If the MAC reduction feature is enabled, valid bridge_priority values are 0, 4096, 8192, 12288, 16384,
20480, 24576, 28672, 32768, 36864, 40960, 45056, 49152, 53248, 57344, and 61440, with 0 indicating
high priority and 61440, low priority. Any other value will be rejected.
If the MAC reduction feature is disabled, valid bridge_priority values are 0 to 65535.

Examples This example shows how to set the bridge priority of VLAN 1 to 4096:
Console> (enable) set spantree priority 4096 64
Spantree 64 bridge ID priority set 4160 (bridge priority: 4096 + sys ID ext: 64).
Console> (enable)

Related Commands show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-348 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree root

set spantree root

Use the set spantree root command to set the primary or secondary root for specific VLANs of the
switch or for all VLANs of the switch.

set spantree root [secondary] [vlan_list] [dia network_diameter] [hello hello_time]

Syntax Description secondary (Optional) Keyword that specifies to designate this switch as a
secondary root, if the primary root fails.
vlan_list (Optional) Number of the VLAN. If you do not specify a VLAN
number, VLAN 1 is used. Valid values are 1 to 1005.
dia network_diameter (Optional) Keyword that specifies the maximum number of bridges
between any two points of attachment of end stations. Valid values
are 2 to 7.
hello hello_time (Optional) Keyword that specifies in seconds, the duration between
generation of configuration messages by the root switch. Valid
values are 1 to 10.

Defaults If the secondary keyword is not specified, the default is to make the switch the primary root.
The default value of network_diameter is 7.
If not specified, the current value of hello_time from the NVRAM is used.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines This command runs on backbone or distribution switches.

You can run the secondary root many times to create backup switches in case of a root failure.
The secondary command reduces the bridge priority value to 16384.
This command increases path costs to a value greater than 3000.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-349
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree root

Examples This example shows how to set the spantree root for VLANS 1 to 10 with a maximum of 4 bridges:
Console>(enable) set spantree root 1-10 dia 4
VLANs 1-10 bridge priority set to 8192
VLANs 1-10 bridge max aging time set to 14 seconds.
VLANs 1-10 bridge hello time set to 2 seconds.
VLANs 1-10 bridge forward delay set to 9 seconds.
Switch is now the root switch for active VLANs 1-6.
Console> (enable)

This example shows that setting the bridge priority to 8192 was not sufficient to make this switch the
root. The priority was further reduced to 7192 (100 less than the current root switch) to make this switch
the root switch. However, reducing the priority to this value did not make it the root switch for active
VLANs 16 and 17.
Console> (enable) set spantree root 11-20.
VLANs 11-20 bridge priority set to 7192
VLANs 11-10 bridge max aging time set to 20 seconds.
VLANs 1-10 bridge hello time set to 2 seconds.
VLANs 1-10 bridge forward delay set to 13 seconds.
Switch is now the root switch for active VLANs 11-15,18-20.
Switch could not become root switch for active VLAN 16-17.
Console> (enable)

Console>(enable) set spantree root secondary 22,24 dia 5 hello 1

VLANs 22,24 bridge priority set to 16384.
VLANs 22,24 bridge max aging time set to 10 seconds.
VLANs 22,24 bridge hello time set to 1 second.
VLANs 22,24 bridge forward delay set to 7 seconds.
Console> (enable)

Related Commands clear spantree root

show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-350 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree uplinkfast

set spantree uplinkfast

Use the set spantree uplinkfast command to enable fast switchover to alternate ports when the root port
fails. This command applies to a switch, not to a WAN.

set spantree uplinkfast enable [rate station_update_rate] [all-protocols {off | on}]

set spantree uplinkfast disable

Syntax Description enable Keyword that enables a fast switchover.

rate station_update_rate (Optional) Keyword that specifies the number of multicast packets
transmitted per 100 ms when an alternate port is chosen after the
root port goes down.
all-protocols (Optional) Keyword that specifies whether the switch generates
dummy multicast packets for all protocol groups (IP, IPX, and
Group) in a network with switches using protocol filtering.
off (Optional) Keyword that specifies to prevent the switch from
generating multicasts for all protocol groups.
on (Optional) Keyword that specifies to cause the switch to generate
multicasts for all protocol groups.
disable Keyword that disables fast switchover.

Defaults The default station_update_rate is 15 packets per 100 ms.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The set spantree uplinkfast enable command has the following results:
• Changes the bridge priority to 49152 for all VLANs (allowed VLANs).
• Increases the path cost and port VLAN cost of all ports to a value greater than 3000.
• On detecting the failure of a root port, an instant cutover occurs to an alternate port selected by
Spanning Tree Protocol.
If you run set spantree uplinkfast enable on a switch that has this feature already enabled, only the
station update rate is updated. The rest of the parameters are not modified.
If you run set spantree uplinkfast disable on a switch, the UplinkFast feature is disabled but the switch
priority and port cost values are not reset to the factory defaults. To reset the values to the factory
defaults, enter the clear spantree uplinkfast command.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-351
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set spantree uplinkfast

The default station_update_rate value is 15 packets per 100 ms, which is equivalent to a 1 percent load
on a 10-Mbps Ethernet port. If you specify this value as 0, the switch does not generate
station-update-rate packets.
Use the all-protocols on keywords on switches that have UplinkFast enabled but do not have protocol
filtering enabled, and that are connected to upstream switches in the network that have protocol filtering
enabled. The all-protocols on keywords cause the switch to generate multicasts for each
protocol-filtering group.
On switches with both UplinkFast and protocol filtering enabled, or if no other switches have protocol
filtering enabled, you do not need to use the all-protocols on keywords.

Examples This example shows how to enable the spantree UplinkFast feature and specify the number of multicast
packets transmitted to 40 packets per 100 ms:
Console>(enable) set spantree uplinkfast enable rate 40
VLANs 1-1005 bridge priority set to 49152.
The port cost and portvlancost of all ports increased to above 3000.
Station update rate set to 40 packets/100ms.
uplinkfast turned on for bridge.
Console> (enable)

This example shows how to disable the spantree UplinkFast feature:

console> (enable) set spantree uplinkfast disable
Uplinkfast disabled for switch.
Use clear spantree uplinkfast to return stp parameters to default.
console>(enable) clear spantree uplink
This command will cause all portcosts, portvlancosts, and the
bridge priority on all vlans to be set to default.
Do you want to continue (y/n) [n]? y
VLANs 1-1005 bridge priority set to 32768.
The port cost of all bridge ports set to default value.
The portvlancost of all bridge ports set to default value.
uplinkfast disabled for bridge.
Console> (enable)

This example shows how to enable the all-protocols feature:

Console> (enable) set spantree uplinkfast enable all-protocols on
uplinkfast update packets enabled for all protocols.
uplinkfast already enabled for bridge.

This example shows how to disable the all-protocols feature:

Console> (enable) set spantree uplinkfast disable all-protocols off
uplinkfast all-protocols field set to off.
uplinkfast already enabled for bridge.
Console> (enable)

Related Commands clear spantree uplinkfast

show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-352 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set summertime

set summertime
Use the set summertime command to specify whether the system should set the clock ahead one hour
during daylight saving time.

set summertime {enable | disable} [zone]

set summertime recurring {week} {day} {month} {hh:mm} {week} {day} {month} {hh:mm}
[offset]

set summertime date {month} {date} {year} {hh:mm}{month} {date} {year} {hh:mm} [offset]

Syntax Description enable Keyword that causes the system to set the clock ahead one hour
during daylight saving time.
disable Keyword that prevents the system from setting the clock ahead one
hour during daylight saving time.
zone (Optional) Time zone used by the set summertime command.
week Week of the month (first, second, third, fourth, last, 1...5).
day Day of the week (Sunday, Monday, Tuesday, etc.).
month Month of the year (January, February, March, etc.).
hh:mm Time in both hours and minutes.
offset (Optional) Amount of offset in minutes. Valid values are 1 to 1440
minutes.
date Day of the month. Valid values are 1 to 31.
year Number of the year. Valid values are 1993 to 2035.

Defaults The default is that the set summertime command is disabled. When the command is enabled, the default
for offset is 60 minutes, following U.S. standards.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines When you enter the clear config command, the dates and times are set back to the default.
Unless otherwise configured, this command advances the clock one hour at 2:00 a.m. on the first Sunday
in April and moves back the clock one hour at 2:00 a.m. on the last Sunday in October.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-353
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set summertime

Examples This example shows how to cause the system to set the clock ahead one hour during daylight saving time:
Console> (enable) set summertime enable PDT
Summertime is enabled and set to “PDT”.
Console> (enable)

This example shows how to prevent the system from setting the clock ahead one hour during daylight
saving time:
Console> (enable) set summertime disable
Summertime disabled.
Console> (enable)

This example shows how to set daylight saving time to zonename “AUS,” repeat every year, starting from
the third Monday of February at noon and ending at the second Saturday of August at
3:00 p.m. with an offset of 30 minutes:
Console> (enable) set summertime recurring 3 Mon Feb 03:00 4 Thursday oct 08:00 500
Command authorization none.
Summertime is enabled and set to ’’
start: Mon Feb 21 2000, 03:00:00
end: Fri Oct 20 2000. 08:00:00
offset: 1..1440 minutes (default 60)
Recurring: yes, starting at 03:00:00am of third Monday of February and ending on
08:00am of fourth Thursday of October.
Console> (enable)

This example shows how to set the daylight saving time to start on January 29, 1999 at 2:00 a.m. and
end on August 19, 2004 at 3:00 p.m. with an offset of 30 minutes:
Console> (enable) set summertime date jan 29 1999 02:00 aug 19 2004 15:00 30
Summertime is disabled and set to ''
Start : Fri Jan 29 1999, 02:00:00
End : Thu Aug 19 2004, 15:00:00
Offset: 30 minutes
Recurring: no
Console> (enable)

Related Commands show summertime

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-354 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set switchacceleration

set switchacceleration
Use the set switchacceleration command to increase the switching bandwidth of the switch.

set switchacceleration {enable | disable} mod_num

Syntax Description enable Keyword that activates switch acceleration.

disable Keyword that deactivates switch acceleration.
mod_num Number of the module.

Defaults By default, switch acceleration is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The set switchacceleration command is valid only on Catalyst 4000 family switches with Supervisor
Engine II. To enable switch acceleration on the switch, you must disable both the ports on it. Switch
acceleration on the switch can be disabled without any conditions.

Examples This example shows how to enable switch acceleration on port 1 of module 1 on the switch:
Console> (enable) set port disable 1/1-2
Port(s) 1/1-2 disabled.
Console> (enable)

Console> (enable) set switchacceleration enable 1

Enabling or Disabling switch acceleration may impact performance for 1-2 seconds.
Do you want to continue (y/n) [n]? y
Switch Acceleration on module 1 enabled.
Console> (enable)

This example shows how to disable switch acceleration on port 1 of module 1 on the switch:
Console> (enable) set switchacceleration disable 1
Enabling or Disabling switch acceleration may impact performance for 1-2 seconds.
Do you want to continue (y/n) [n]? y
Switch Acceleration on module 1 disabled.
Console> (enable)

Related Commands show switchacceleration

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-355
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set system baud

set system baud

Use the set system baud command to set the console port baud rate.

set system baud rate

Syntax Description rate Baud rate. Valid rates are 600, 1200, 2400, 4800, 9600, 19200, and
38400.

Defaults By default, the console port baud rate is 9600 baud.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to set the system baud rate to 19200:
Console> (enable) set system baud 19200
System console port baud rate set to 19200.
Console> (enable)

Related Commands show system

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-356 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set system contact

set system contact

Use the set system contact command to identify a contact person for the system.

set system contact [contact_string]

Syntax Description contact_string (Optional) Text string that contains the name of the person to
contact for system administration. If no contact string is specified,
the system contact string is cleared.

Defaults By default, no system contact is configured.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to set the system contact string to Xena ext.24:
Console> (enable) set system contact Xena ext.24
System contact set.
Console> (enable)

Related Commands show system

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-357
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set system countrycode

set system countrycode

Use the set system countrycode command to specify the country where the system is physically located.

set system countrycode code

Syntax Description code Country code; see the “Usage Guidelines” section below for format
information.

Defaults By default, the country is US (United States).

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The country code is a 2-letter country code taken from ISO-3166 (for example, VA=Holy See [Vatican
City State], VU=Vanuatu, and TF=French Southern Territories).

Examples This example shows how to set the system country code to Great Britain:
Console> (enable) set system countrycode GB
Country code is set to GB
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-358 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set system location

set system location

Use the set system location command to identify the location of the system.

set system location [location_string]

Syntax Description location_string (Optional) Text string that indicates where the system is located.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If no location_string is specified, the system location is cleared.

Examples This example shows how to set the system location string to Closet 230 4/F:
Console> (enable) set system location Closet 230 4/F
System location set.
Console> (enable)

Related Commands show system

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-359
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set system modem

set system modem

Use the set system modem command to enable or disable modem control lines on the console port.

set system modem {enable | disable}

Syntax Description enable Keyword that specifies to activate modem control lines on the
console port.
disable Keyword that specifies to deactivate modem control lines on the
console port.

Defaults By default, modem control lines are disabled.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to enable modem control lines on the console port:
Console> (enable) set system modem enable
Modem control lines enabled on console port.
Console> (enable)

This example shows how to disable modem control lines on the console port:
Console> (enable) set system modem disable
Modem control lines disabled on console port.
Console> (enable)

Related Commands show system

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-360 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set system name

set system name

Use the set system name command to configure a name for the system.

set system name [name_string]

Syntax Description name_string (Optional) Text string that identifies the system.

Defaults By default, no system name is configured.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines In Catalyst 4000 family software release 4.4 and later, if you use the set system name command to
assign a name to the switch, the switch name is used as the prompt string. However, if you specify a
different prompt string using the set prompt command, that string is used for the prompt. If no name is
specified, the system name is cleared.
The system name can be 255 characters long, and the prompt can be 20 characters long. The system name
is truncated appropriately when used as a prompt; a greater-than symbol (>) is appended to the truncated
system name. If the system name was found from a DNS lookup, it is truncated to remove the domain
name. If the prompt is obtained using the system name, it is updated whenever the system name changes.
You can overwrite this prompt any time by setting the prompt manually. Any change in the prompt is
reflected in all current open sessions.

Examples This example shows how to set the system name to Information Systems:
Console> (enable) set system name Information Systems
System name set.
Console> (enable)

Related Commands set prompt

show system

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-361
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set tacacs directedrequest

set tacacs directedrequest

Use the set tacacs directedrequest command to enable or disable the TACACS+ directed-request
option. When enabled, you can direct a request to any of the configured TACACS+ servers and only the
username is sent to the specified server.

set tacacs directedrequest {enable | disable}

Syntax Description enable Keyword that specifies to send the portion of the address before the
at (@) sign (the username) to the host specified after the @ sign.
disable Keyword that specifies to send the entire address string to the
default TACACS+ server.

Defaults By default, the TACACS+ directed-request option is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines When tacacs directedrequest is enabled, you must specify a configured TACACS+ server after the @
sign. If the specified host name does not match the IP address of a configured TACACS+ server, the
request is rejected. When tacacs directedrequest is disabled, the 4000 family, 2948G, and 2980G switch
queries the list of servers beginning with the first server in the list and then sends the entire string,
accepting the first response from the server. This command is useful for sites that have developed their
own TACACS+ server software to parse the entire address string and make decisions based on the
contents of the string.

Examples This example shows how to enable the TACACS+ directed-request option:
Console> (enable) set tacacs directedrequest enable
Tacacs direct request has been enabled.
Console> (enable)

This example shows how to disable the TACACS+ directed-request option:

Console> (enable) set tacacs directedrequest disable
Tacacs direct request has been disabled.
Console> (enable)

Related Commands show tacacs

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-362 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set tacacs key

set tacacs key

Use the set tacacs key command to set the key for TACACS+ authentication and encryption.

set tacacs key key

Syntax Description key Printable ASCII characters used for authentication and encryption.
Key length must be less than 100 characters.

Defaults By default, the value of the key is NULL.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The key must be the same as the key used on the TACACS+ server. All leading spaces are ignored.
Spaces within the key and at the end of the key are included. Double quotation marks are not required,
even if there are spaces between words in the key, unless the quotation marks themselves are part of the
key. The key can consist of any printable ASCII characters except the tab character.

Examples This example shows how to set the authentication and encryption key:
Console> (enable) set tacacs key Who Goes There
The tacacs key has been set to Who Goes There.
Console> (enable)

Related Commands clear tacacs key

show tacacs

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-363
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set tacacs server

set tacacs server

Use the set tacacs server command to define a TACACS+ server.

set tacacs server ip_addr [primary]

Syntax Description ip_addr IP address of the server on which the TACACS+ server resides.
primary (Optional) Keyword that specifies to designate the specified server
as the primary TACACS+ server.

Defaults There is no default setting for this command.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You can configure a maximum of three servers. The primary server, if configured, is contacted first. If
no primary server is configured, the first server configured becomes the primary server.

Examples This example shows how to configure the server on which the TACACS+ server resides and to designate
it as the primary server:
Console> (enable) set tacacs server 170.1.2.20 primary
170.1.2.20 added to TACACS server table as primary server.
Console> (enable)

Related Commands clear tacacs server

show tacacs

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-364 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set tacacs timeout

set tacacs timeout

Use the set tacacs timeout command to set the response timeout interval for the TACACS+ server
daemon. The TACACS+ server must respond to a TACACS+ authentication request before this interval
expires or the next configured server is queried.

set tacacs timeout seconds

Syntax Description seconds Timeout response interval in seconds. Valid values are 1 to 255.

Defaults By default, the value for the response timeout interval for the TACACS+ server is 5 seconds.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to set the response timeout interval for the TACACS+ server to 8 seconds:
Console> (enable) set tacacs timeout 8
Tacacs timeout set to 8 seconds.
Console> (enable)

Related Commands show tacacs

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-365
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set test diaglevel

set test diaglevel

Use the set test diaglevel command to set the diagnostic level.

set test diaglevel {complete | minimal | bypass}

Syntax Description complete Keyword that specifies complete diagnostics.

minimal Keyword that specifies minimal diagnostics.
bypass Keyword that specifies bypass diagnostics.

Defaults By default, the diagnostic level is set to complete.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The minimal keyword is not supported at this time. Setting the diagnostic level to minimal will be
ignored.
Setting the diagnostic level to bypass will skip POST and online diagnostic testing. If you skip diagnostic
testing, the show test mod_num command reports that the module has passed all tests.

Caution Be careful when setting the diagnostic level to bypass. Bypassing diagnostic tests allows hardware
failures to go undetected and could cause other problems.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-366 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set test diaglevel

Examples This example shows how to set the diagnostic level to complete:
Console> (enable) set test diaglevel complete
Diagnostic level set to complete.
Console> (enable)

This example shows how to set the diagnostic level to minimal:

Console> (enable) set test diaglevel minimal
Diagnostic level set to minimal.
Console> (enable)

This example shows how to set the diagnostic level to bypass:

Console> (enable) set test diaglevel bypass
Diagnostic level set to bypass.
Console> (enable)

Related Commands show test

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-367
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set test switch-memory

set test switch-memory

To enable the packet memory diagnostics, use the set test switch-memory command.

set test switch-memory {enable | disable} [action {best-effort | halt | none}]

Syntax Description enable Enable ongoing switch memory diagnostics.

disable Disable ongoing switch memory diagnostics.
action (Optional) Action to take if switch memory errors are detected.
best-effort (Optional) Resets switch and removes affected memory from circulation.
halt (Optional) Resets switch and disables all ports.
none (Optional) Does not take any action when SRAM errors are detected.

Defaults Packet memory diagnostics is enabled and action is best effort.

Command Types Switch command

Command Modes Privileged

Usage Guidelines If you want to clear or change this environment variable you must do so manually, you cannot reset the
defaults using the clear config all command.

Examples This example shows how to enable packet memory diagnostics:

Console> (enable) set test switch-memory enable
set test switch-memory enable

switch-memory tests enabled

Console> (enable)

This example shows how to disable packet memory diagnostics:

Console> (enable) set test switch-memory disable
set test switch-memory disable

switch-memory tests disabled

Console> (enable)

This example shows how to enable packet memory diagnostics and set the action to best-effort:
Console> (enable) set test switch-memory enable action best-effort
set test switch-memory enable action best-effort

Test switch-memory enabled, action set to best-effort

Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-368 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set test switch-memory

This example shows how to enable packet memory diagnostics and set the action to halt:
Console> (enable) set test switch-memory enable action halt
set test switch-memory enable action halt

Test switch-memory enabled, action set to halt

Console> (enable)

This example shows how to enable packet memory diagnostics and set the action to none:
Console> (enable) set test switch-memory enable action none
set test switch-memory enable action none

Test switch-memory enabled, action set to none

Console> (enable)

Related Commands show test switch-memory

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-369
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set time

set time
Use the set time command to change the time of day on the system clock.

set time [day_of_week] [mm/dd/yyyy] [hh:mm:ss]

Syntax Description day_of_week (Optional) Day of the week. Valid values are monday, tuesday,
wednesday, thursday, friday, saturday, and sunday.
mm/dd/yyyy (Optional) Month, day, and year.
hh:mm:ss (Optional) Current time in 24-hour format.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to set the system clock to Sunday, March 21, 2000, 7:50 a.m:
Console> (enable) set time sun 03/21/2000 7:50
Sun Mar 21 2000, 07:50:00
Console> (enable)

Related Commands show timezone

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-370 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set timezone

set timezone
Use the set timezone command to set the time zone for the system.

set timezone [zone_name] [hours [minutes]]

Syntax Description zone_name (Optional) Name of the time zone to be displayed.

hours (Optional) Number of hours offset from UTC. Valid values are –12
to 12.
minutes (Optional) Number of minutes offset from UTC. If the specified hours
value is a negative number, then the minutes value is assumed to be
negative as well. Valid values are 0 to 59.

Defaults By default, the time zone is set to UTC.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The set timezone command is effective only when NTP is running. If you set the time explicitly and
NTP is disengaged, the set timezone command has no effect. If you have enabled NTP and have not
entered the set timezone command, the Catalyst 4000 family switch displays UTC by default.

Examples This example shows how to set the time zone to Pacific Standard Time with an offset of –8 hours from
UTC:
Console> (enable) set timezone PST -8
Timezone set to “PST”, offset from UTC is -8 hours.
Console> (enable)

Related Commands clear timezone

show timezone

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-371
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set trace

set trace
Use the set trace command to obtain the debug information for the switch web interface.

set trace {category} [level]

set trace monitor {enable | disable}

Syntax Description category Trace category.

level (Optional) Trace level; see the “Usage Guidelines” for valid values.
monitor Keyword that specifies monitoring for debug information for the switch web
interface.
enable Keyword that enables the trace monitor.
disable Keyword that disables the trace monitor.

Defaults By default, the trace level is 1.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines Valid values for the trace level are 0 to 15. Trace levels 0 to 255 are for inband only. To disable the trace
level, set the value to 0.

Examples This example shows how to obtain switch web interface debug information:
Console> (enable) set trace vmps
VMPS tracing set to 1.
Warning!! Turning on trace may affect the operation of the system.
Use with caution.
Console> (enable)

This example shows how to enable trace monitoring:

Console> (enable) set trace monitor enable
Trace monitor is enabled for this session.
Console> (enable)

This example shows how to disable trace monitoring:

Console> (enable) set trace monitor disable
Trace monitor is disabled for this session.
Console> (enable)

Related Commands show trace

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-372 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set traffic monitor

set traffic monitor

Use the set traffic monitor command to configure the threshold at which a high traffic log will be
generated.

set traffic monitor threshold

Syntax Description threshold The threshold percentage at which a high traffic log will be generated. Valid
values are 0 to 100 percent.

Defaults By default, threshold is set to 100 percent. No high traffic log is created.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If backplane traffic exceeds the threshold configured by the set traffic monitor command, a high traffic
log is created. If the threshold is set to 100 percent, no high-traffic system warning is generated.

Examples This example shows how to set the high traffic threshold to 80%:
Console> (enable) set traffic monitor 80
Traffic monitoring threshold set to 80%.
Console> (enable)

Related Commands show traffic

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-373
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set trunk

set trunk
Use the set trunk command to configure trunk ports and to add VLANs to the allowed VLAN list for
existing trunks.

set trunk mod_num/port_num [on | off | desirable | auto | nonegotiate] [vlan_range] [isl | dot1q
dot10 | lane | negotiate]

Syntax Description mod_num Number of the module.

port_num Number of the port on the module.
on (Optional) Keyword that specifies to force the port to become a trunk port and
persuade the neighboring port to become a trunk port. The port becomes a trunk
port even if the neighbor port does not agree to become a trunk. This is the only
possible mode for ATM ports.
off (Optional) Keyword that specifies to force a port to become a nontrunk port and
persuade the neighboring port to become a nontrunk port. The port becomes a
nontrunk port even if the neighbor port does not agree to become a nontrunk
port. This is the default mode for FDDI trunks. This option is not allowed for
ATM ports.
desirable (Optional) Keyword that specifies a port negotiate actively with the neighbor
port to become a trunk link. This mode is not allowed on FDDI and ATM ports.
auto (Optional) Keyword that specifies to cause the port to become a trunk port if the
neighboring port tries to negotiate a trunk link. This mode is not allowed on
FDDI and ATM ports. This is the default mode for Fast Ethernet and Gigabit
Ethernet ports.
nonegotiate (Optional) Keyword that specifies to force the port to become a trunk port but
prevent it from sending DTP frames to its neighbor. This mode is only allowed
on ISL and IEEE 802.1Q trunks.
vlan_range (Optional) VLANs to add to the list of allowed VLANs on the trunk. Valid
values are1 to 1005.
isl (Optional) Keyword that specifies an ISL trunk on an Ethernet port.
dot1q (Optional) Keyword that specifies an IEEE 802.1Q trunk on an Ethernet port.
IEEE 802.1Q trunks are supported in Catalyst 5000 family and 2926G series
software release 4.1(1) and later with 802.1Q-capable hardware. Automatic
negotiation of 802.1Q trunks is supported in software release 4.2(1) and later.
In software release 4.1, you must use the nonegotiate mode with 802.1Q trunks.
dot10 (Optional) Keyword that specifies an IEEE 802.10 trunk on a FDDI or CDDI
port.
lane (Optional) Keyword that specifies an ATM LANE trunk on an ATM port.
negotiate (Optional) Keyword that specifies that the port become an ISL (preferred) or
802.1Q trunk, depending on the configuration and capabilities of the
neighboring port.

Defaults All ports except ATM LANE ports are nontrunk ports by default. ATM LANE and RSM ports are always
configured as trunk ports.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-374 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set trunk

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines Trunking capabilities are hardware dependent. Refer to the Module Installation Guide for your switch
to determine the trunking capabilities of your hardware, or enter the show port capabilities command.
The Catalyst 4000 family switches use the DTP (formerly known as DISL) to negotiate trunk links
automatically on Fast Ethernet and Gigabit Ethernet ports. Whether a port will negotiate to become a
trunk port depends on both the mode and the trunk type specified for that port. Refer to the Software
Configuration Guide–Catalyst 4000 Family, 2948G, and 2980G Switches for detailed information on
how trunk ports are negotiated.
DTP is a point-to-point protocol. However, some internetworking devices might improperly forward
DTP frames. You can avoid this problem by ensuring that trunking is turned off on ports connected to
non-Catalyst 4000 family devices if you do not intend to trunk across those links. When enabling
trunking on a link to a Cisco router, enter the nonegotiate keyword to cause the port to become a trunk
but not generate DTP frames. The nonegotiate keyword is available in Catalyst 4000 family software
release 2.4(3) and later.
For trunking to be negotiated on Fast Ethernet and Gigabit Ethernet ports, the ports must be in the same
VTP domain. However, you can use the on or nonegotiate mode to force a port to become a trunk, even
if it is in a different domain.
To remove VLANs from the allowed list for a trunk, enter the clear trunk mod_num/port_num
vlan_range command. When you first configure a port as a trunk, the set trunk command always adds
all VLANs to the allowed VLAN list for the trunk, even if you specify a VLAN range (the specified
VLAN range is ignored).
To remove VLANs from the allowed list, enter the clear trunk mod_num/port_num vlan_range
command. To later add VLANs that were removed, enter the set trunk mod_num/port_num vlan_range
command.
If you do not enter a trunk-type keyword, the value is unchanged from the previous configuration.
The dot1q trunk type is the only trunk type supported by the Catalyst 4000 family switches.
To return a trunk to its default trunk type and mode, enter the clear trunk mod_num/port_num
command.
If you enter the set trunk command on a Token Ring port, you receive a message indicating that the port
is “not a trunk-capable port.”
When you are running the set trunk command on an Access Gateway module you have limited usage of
the command.

Examples This example shows how to set port 2 on module 1 as a trunk port:
Console> (enable) set trunk 1/2 on
Port(s) 1/2 trunk mode set to on.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-375
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set trunk

This example shows how to set port 2 on module 1 as a nontrunk port:

Console> (enable) set trunk 1/2 off
Port(s) 1/2 trunk mode set to off.
Console> (enable)

This example shows how to set port 2 on module 1 as a preferred trunk port:
Console> (enable) set trunk 1/2 desirable
Port(s) 1/2 trunk mode set to desirable.
Console> (enable) 2000 Jan 11 09:16:29 %DTP-5-TRUNKPORTON:Port 1/2 has become ik

This example shows how to add VLANs 5 through 50 to the allowed VLAN list for a trunk port (VLANs
were previously removed from the allowed list with the clear trunk command):
Console> (enable) set trunk 1/1 5-50
Adding vlans 5-50 to allowed list.
Port(s) 1/1 allowed vlans modified to 1,5-50,101-1005.
Console> (enable)

This example shows how to set port 5 on module 4 as an 802.1Q trunk port in desirable mode:
Console> (enable) set trunk 4/5 desirable dot1q
Port(s) 4/5 trunk mode set to desirable.
Port(s) 4/5 trunk type set to dot1q.
Console> (enable)

This example shows how to set port 1 on module 1 as an ISL trunk port:
Console> (enable) set trunk 1/1 isl
Port(s) 1/1 trunk type set to isl.
Console> (enable)

Related Commands clear trunk

set vtp
show trunk
show vtp statistics

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-376 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set udld

set udld
Use the set udld command to enable or disable the UDLD feature on specified ports or globally on all
ports.

set udld {enable | disable} mod/ports...

Syntax Description enable Keyword that enables the UDLD feature.

disable Keyword that disables the UDLD feature.
mod/ports... Number of the module and ports.

Defaults By default, UDLD is globally disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines Whenever a unidirectional connection is detected, UDLD displays a syslog message to notify you and
the network management application (via SNMP) that the port on which the misconfiguration has been
detected has been disabled.
If you enter the global set udld enable or disable command, UDLD is globally configured. If UDLD is
globally disabled, UDLD is automatically disabled on all interfaces, but the per-port enable (or disable)
configuration is not changed. If UDLD is globally enabled, whether UDLD is running on an interface or
not depends on its per-port configuration.
UDLD is supported on both Ethernet fiber and copper interfaces and only those interfaces can be
enabled.

Examples This example shows how to enable the UDLD feature for port 1 on module 2:
Console> (enable) set udld enable 2/1
UDLD enabled on port 2/1.
Warning:UniDirectional Link Detection should be enabled on all the ends of the connection
in order to work properly.
Console> (enable)

This example shows how to disable the UDLD feature for port 1 on module 2:
Console> (enable) set udld disable 2/1
UDLD disabled on port 2/1.
Warning:UniDirectional Link Detection should be enabled on all the ends of the connection
in order to work properly.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-377
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set udld

This example shows how to enable the UDLD feature for all ports on all modules:
Console> (enable) set udld enable
UDLD enabled globally
Console> (enable)

This example shows how to disable the UDLD message display for all ports on all modules:
Console> (enable) set udld disable
UDLD disabled globally
Console> (enable)

Related Commands show udld

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-378 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set udld aggressive-mode

set udld aggressive-mode

Use the set udld aggressive-mode command to enable UDLD aggressive mode on specified ports or
globally on all ports.

set udld aggressive-mode {enable | disable} mod/port

Syntax Description enable Keyword that enables UDLD aggressive mode.

disable Keyword that disables UDLD aggressive mode.
mod/port Number of the module and port(s).

Defaults By default, aggressive mode is disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines After all the neighbors of a port have aged out either in the advertisement or in the detection phase,
aggressive mode allows UDLD to restart the linkup sequence to resynchronize with any potentially
out-of-sync neighbors, and shut down the port if the link is still undetermined after the fast train of
messages.
You also can enable aggressive mode to shut down an active port that does not support FEFI or
autonegotiation and becomes connected to its neighbor by a single fiber strand or copper wire after being
part of a bidirectional link. This prevents possible spanning tree loops if the port belongs to a channel.

Examples This example shows how to enable aggressive mode:

Console> (enable) set udld aggressive-mode enable 2/1
Aggressive UDLD enabled on port 2/1.
Warning: UniDirectional Link Detection should be enabled on all the ends of the connection
in order to work properly.
Console> (enable)

This example shows how to disable aggressive mode:

Console> (enable) set udld aggressive-mode disable 2/1
Aggressive UDLD disabled on port 2/1.
Warning: UniDirectional Link Detection should be enabled on all the ends of the connection
in order to work properly.
Console> (enable)

Related Commands show udld

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-379
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set udld interval

set udld interval

Use the set udld interval command to set the UDLD message interval timer.

set udld interval interval

Syntax Description interval Message interval in seconds. Valid values are 7 to 90 seconds.

Defaults By default, the UDLD message interval timer is set to 60 seconds.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to set the message interval timer:
Console> (enable) set udld interval 90
UDLD message interval set to 90 seconds
Console> (enable)

Related Commands show udld

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-380 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set vlan

set vlan
Use the set vlan command to group ports into a VLAN.

set vlan {vlan} {mod/port}

set vlan {vlan} [name {name}] [type {type}] [state {state}] [said {said}] [mtu {mtu}]
[mode {bridge_mode}] [stp {stp_type}] [translation vlan_num]
[pvlan-type {pvlan_type}] [rspan]

Syntax Description vlan Number of the VLAN.

mod/port Number of the module and port.
name name (Optional) Keyword that specifies to define a text string used as the name of the
VLAN (1 to 32 characters).
type type (Optional) Keyword that identify the VLAN type as 802.1Q.
state state (Optional) Keyword that specifies whether the state of the VLAN is active or
suspended. VLANs in suspended state do not pass packets.
said said (Optional) Keyword that specifies the security association identifier. Valid
values are 1 to 4294967294.
mtu mtu (Optional) Keyword that specifies the maximum transmission unit (packet size,
in bytes) that the VLAN can use. Valid values are 576 to 18190.
mode bridge_mode (Optional) Keyword to specify the bridge mode. Valid values are srt and srb.
stp stp_type (Optional) Keyword that specifies the version of the Spanning Tree Protocol to
use, source routing transparent (ieee), source route bridging (ibm), automatic
source selection (auto).
translation vlan_num (Optional) Keyword that specifies a translational VLAN used to translate FDDI
to Ethernet. Valid values are 1 to 1005.
pvlan-type pvlan-type (Optional) Keyword and variable to specify the private VLAN type. See the
“Usage Guidelines” section below for valid values.
rspan (Optional) Keyword to create a VLAN for remote SPAN.

Defaults The default values are as follows:

• Switched Ethernet ports and Ethernet repeater ports are in VLAN 1.
• said is 100001 for VLAN 1, 100002 for VLAN 2, 100003 for VLAN 3, and so forth.
• type is Ethernet.
• mtu is 1500 bytes.
• state is active.
• pvlan-type is none.

Command Types Switch command.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-381
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set vlan

Command Modes Privileged.

Usage Guidelines The VLAN numbers are always ISL VLAN identifiers, and not 802.1q VLAN identifiers.
VLAN 1 parameters are factory configured and cannot be changed.
If you specify a range of VLANs, you cannot use the VLAN name.
If you enter the mistp-instance none command, the specified VLANs are unmapped from any instance
they are mapped to.
If you are configuring normal range VLANs, you cannot use the set vlan command until the
Catalyst 4000 family switch is either in VTP transparent mode (set vtp mode transparent) or until a
VTP domain name has been set (set vtp domain name). To create a private VLAN, UTP mode must be
transparent.
You cannot set multiple VLANs for ISL ports using this command. The VLAN name can be from 1 to
32 characters in length. If you are adding a new VLAN or modifying an existing VLAN, the VLAN
number must be within the range of 1 to 1000 and 1025 to 4094.
If you want to use the extended range VLANs (1025 to 4094), you must enable the MAC address
reduction feature using the set spantree macreduction command. When you enable MAC address
reduction, the pool of MAC addresses used for the VLAN spanning tree is disabled, leaving a single
MAC address that identifies the switch.
You must configure a private VLAN on the supervisor engine.
Valid values for pvlan-type are the following:
• primary specifies the VLAN as the primary VLAN in a private VLAN.
• isolated specifies the VLAN as the isolated VLAN in a private VLAN.
• community specifies the VLAN as the community VLAN in a private VLAN.
• twoway-community specifies the VLAN as a bidirectional community VLAN that carries the
traffic among community ports and to and from community ports to and from the MSFC. Non-trunk
promiscuous ports do not support the twoway community type for remapping.
• none specifies that the VLAN is a normal Ethernet VLAN, not a private VLAN.
Only regular VLANs with no access ports assigned to them can be used in private VLANs. Do not use
the set vlan command to add ports to a private VLAN; use the set pvlan command to add ports to a
private VLAN.
VLANs 1001, 1002, 1003, 1004, and 1005 cannot be used in private VLANs.
VLANs in a suspended state do not pass packets.

Examples This example shows how to set VLAN 850 to include ports 4 through 6on module 3. Because ports 4
through 6 were originally assigned to VLAN 1, the message reflects the modification of VLAN 1:
Console> (enable) set vlan 850 3/4-6
VLAN 850 modified.
VLAN 1 modified.
VLAN Mod/Ports
---- -----------------------
850 3/4-6
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-382 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set vlan

This example shows how to set VLAN 7 as a primary VLAN:

Console> (enable) set vlan 7 pvlan-type primary
Console> (enable)

This example shows how to set VLAN 901 as an isolated VLAN:

Console> (enable) set vlan 901 pvlan-type isolated
Console> (enable)

This example shows how to set VLAN 903 as a community VLAN:

Console> (enable) set vlan 903 pvlan-type community
Console> (enable)
This example shows how to set VLAN 2 as an RSPAN vlan:
Console> (enable) set vlan 2 rspan
VTP advertisements transmitting temporarily stopped,
and will resume after the command finishes.
Vlan 2 configuration successful
Console> (enable)

Related Commands clear config pvlan

clear pvlan mapping
clear vlan
set pvlan
set spantree macreduction
set vlan mapping
show pvlan
show pvlan mapping
show vlan

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-383
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set vlan mapping

set vlan mapping

Use the set vlan mapping command to map 802.1Q VLANs to ISL VLANs.

set vlan mapping dot1q 1q_vlan_num isl isl_vlan_num

Syntax Description dot1q Keyword that specifies the 802.1Q VLAN.

1q_vlan_num Number identifying the 802.1Q VLAN. Valid values are 1001 to 4095.
isl Keyword that specifies the ISL VLAN.
isl_vlan_num Number identifying the ISL VLAN. Valid values are 1 to 1000.

Defaults By default, no 802.1Q-to-ISL mappings are defined.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines IEEE 802.1Q VLAN trunks support VLANs 1 through 4095. ISL VLAN trunks support VLANs 1
through 1000. The switch automatically maps 802.1Q VLANs 1000 and lower to ISL VLANs with the
same number.
Catalyst 4000 family switches support only 802.1Q trunks. You can map up to seven VLAN indexes
greater than 1000 to ISL VLANs.
The native VLAN of the 802.1Q trunk cannot be used in the mapping.
Use this feature to map 802.1Q VLANs above 1000 to ISL VLANs. Note that if you map a 802.1Q
VLAN over 1000 to an ISL VLAN, the corresponding 802.1Q VLAN will be blocked. For example, if
you map 802.1Q VLAN 2000 to ISL VLAN 200, then 802.1Q VLAN 200 will be blocked.
You can map up to seven VLANs. Only one 802.1Q VLAN can be mapped to an ISL VLAN. For
example, if 802.1Q VLAN 800 has been automatically mapped to ISL VLAN 800, do not manually map
any other 802.1Q VLANs to ISL VLAN 800.
You cannot overwrite existing 802.1Q VLAN mapping. If the 802.1Q VLAN number is in the mapping
table, the command is aborted. You must first clear that mapping.
If vlan_num does not exist, then either of the following occurs:
• If the switch is in server or transparent mode, the VLAN is created with all default values.
• If the switch is in client mode, then the command proceeds without creating the VLAN. A warning
will be given indicating that the VLAN does not exist.
If the table is full, the command is aborted with an error message indicating the table is full.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-384 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set vlan mapping

Examples This example shows how to map 802.1Q VLAN 1022 to ISL VLAN 850:
Console> (enable) set vlan mapping dot1q 1022 isl 850
Vlan 850 configuration successful
Vlan mapping successful
Console> (enable)

This example shows the display if you enter a VLAN that does not exist:
Console> (enable) set vlan mapping dot1q 1017 isl 999
Vlan mapping successful
Warning: vlan 999 non-existent
Vlan 999 configuration successful
Console> (enable)

This example shows the display if you enter an existing mapping:

Console> (enable) set vlan mapping dot1q 1033 isl 722
722 exists in the mapping table. Please clear the mapping first.
Console> (enable)

This example shows the display if the mapping table is full:

Console> (enable) set vlan mapping dot1q 1099 isl 917
Vlan Mapping Table Full.
Console> (enable)

Related Commands clear vlan mapping

show vlan

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-385
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set vmps server

set vmps server

Use the set vmps server command to configure the IP address of the VMPS server to be queried.

set vmps server ip_addr [primary]

Syntax Description ip_addr IP address of the VMPS server.

primary (Optional) Keyword that specifies to identify the specified device as
the primary VMPS server.

Defaults If no IP address is specified, VMPS uses the local VMPS configuration.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You can specify the IP addresses of up to three VMPS servers. You can define any VMPS server as the
primary VMPS server.
If the primary VMPS server is down, all subsequent queries go to a secondary VMPS server. VMPS
checks on the primary server’s availability once every five minutes. When the primary VMPS server
comes back online, subsequent VMPS queries are directed back to the primary VMPS server.
To use a co-resident VMPS (when VMPS is enabled in a device), configure one of the three VMPS
addresses as the IP address of interface sc0.

Examples This example shows how to define a VMPS server:

Console> (enable) set vmps server 192.168.10.140 primary
192.168.10.140 added to VMPS table as primary domain server.
Console> (enable) set vmps server 192.168.69.171
192.168.69.171 added to VMPS table as backup domain server.
Console> (enable)

Related Commands set vmps server

show dvlan statistics
show vmps
show vmps statistics

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-386 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set vtp

set vtp
Use the set vtp command to set the options for VTP.

set vtp [domain domain_name] [mode {client | server | transparent}] [passwd passwd]
[pruning {enable | disable}] [v2 {enable | disable}]

Syntax Description domain (Optional) Keywords that specifies to define the name that identifies the
domain_name VLAN management domain. The domain_name can be 1 to 32 characters
in length.
mode (Optional) Keyword that specifies the VTP mode.
client (Optional) Keyword that specifies VTP client mode.
server (Optional) Keyword that specifies VTP server mode.
transparent (Optional) Keyword that specifies VTP transparent mode.
passwd passwd (Optional) Keyword that specifies to define the VLAN trunk protocol
password. The VTP password can be 8 to 64 characters in length.
pruning enable | (Optional) Keywords that specify to enable or disable VTP pruning for the
disable entire management domain.
v2 (Optional) Keyword that specifies to set version 2 mode.
enable (Optional) Keyword that specifies to enable v2.
disable (Optional) Keyword that specifies to disable v2.

Defaults The defaults are as follows: server mode, no password, pruning disabled, and v2 disabled.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines All switches in a VTP domain must run the same version of VTP. VTP version 1 and VTP
version 2 do not operate on switches in the same VTP domain. VTP version 2 is supported in software
release 3.1(1) and later and is disabled by default.
If all switches in a domain are VTP version 2-capable, you only need to enable VTP version 2 on one
switch (using the set vtp v2 enable command); the version number is then propagated to the other
version 2-capable switches in the VTP domain.
If the VTP password has already been defined, entering passwd 0 (zero) clears the VTP password.
VTP supports three different modes: server, client, and transparent. If you make a change to the VTP or
VLAN configuration on a switch in server mode, that change is propagated to all of the switches in the
same VTP domain.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-387
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set vtp

If the receiving switch is in server mode and its revision number is higher than the sending switch, the
configuration is not changed. If the revision number is lower the configuration is duplicated.
If the receiving switch is in client mode, the client switch changes its configuration to duplicate the
configuration of the server. If you have switches in client mode, make sure to make all VTP or VLAN
configuration changes on a switch in server mode.
If the receiving switch is in transparent mode, the configuration is not changed. Switches in transparent
mode do not participate in VTP. If you make VTP or VLAN configuration changes on a switch in
transparent mode, the changes are not propagated to the other switches in the network.
If you assign a VTP password, no VTP or VLAN configuration changes can be made without first
entering the password.
The pruning keyword is used to enable or disable VTP pruning for the VTP domain. VTP pruning
causes information about each pruning-eligible VLAN to be removed from VTP updates if there are no
stations belonging to that VLAN out a particular switch port. Use the set vtp pruning and clear vtp
pruning commands to specify which VLANs should or should not be pruned when pruning is enabled
for the domain.
To disable VTP, enter the set vtp mode transparent command. This disables VTP from the domain but
does not remove the domain from the switch. Use the clear config all command to remove the domain
from the switch.

Caution Be careful when you use the clear config all command. This command clears the entire switch
configuration, not just the VTP domain.

Examples This example shows how to set the domain Engineering to client:
Console> (enable) set vtp domain Engineering mode client
VTP domain Engineering modified
Console> (enable)

This example shows how to set the domain Engineering to server:

Console> (enable) set vtp domain Engineering mode server
VTP domain Engineering modified
Console> (enable)

This example shows how to enable pruning:

Console> (enable) set vtp pruning enable
This command will enable the pruning function in the entire management domain.
All devices in the management domain should be pruning-capable before enabling.
Do you want to continue (y/n) [n]? y
VTP domain Lab_Network modified
Console> (enable)

This example shows how to disable pruning:

Console> (enable) set vtp pruning disable
This command will disable the pruning function in the entire management domain.
Do you want to continue (y/n) [n]? y
VTP domain Lab_Network modified
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-388 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set vtp

Related Commands clear config—switch

clear vlan
clear vtp pruning
set vlan
show vlan
show vtp domain

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-389
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set vtp pruneeligible

set vtp pruneeligible

Use the set vtp pruneeligible command to specify the VTP domain on which VLANs are prune eligible.

set vtp pruneeligible vlans

Syntax Description vlans Range of VLAN numbers. Valid values are 2 to 1000.

Defaults By default, VLANs 2 to 1000 are eligible for pruning.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines VTP pruning causes information about each pruning-eligible VLAN to be removed from VTP updates
if there are no stations belonging to that VLAN on a particular switch port. Use the set vtp command to
enable VTP pruning.
By default, VLANs 2 to 1000 are pruning eligible. You do not need to use the set vtp pruning command
unless you have previously used the clear vtp pruning command to make some VLANs pruning
ineligible. If VLANs have been made pruning ineligible, use the set vtp pruning command to make
them pruning eligible again.

Examples This example shows how to configure pruning eligibility for VLANs 120 and 150:
Console> set vtp pruneeligible 120,150
Vlans 120,150 eligible for pruning on this device.
VTP domain nada modified.
Console>

In this example, VLANs 200 to 500 were made pruning ineligible using the clear vtp pruning
command. This example shows how to make VLANs 220 to 320 pruning eligible again:
Console> set vtp pruneeligible 220-320
Vlans 2-199,220-320,501-1000 eligible for pruning on this device.
VTP domain Company modified.
Console>

Related Commands clear vtp pruning

set vlan
show vtp domain

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-390 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set vtp pruning

set vtp pruning

Use the set vtp pruning command to specify which VLANs in the VTP domain are eligible for pruning.

set vtp pruning vlans

Syntax Description vlans Range of VLAN numbers. Valid values are 2 to 1000.

Defaults By default, VLANs 2 to 1000 are eligible for pruning.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines VTP pruning causes information about each pruning-eligible VLAN to be removed from VTP updates
if there are no stations belonging to that VLAN out a particular switch port. Use the set vtp command
to enable VTP pruning.
By default, VLANs 2 to 1000 are pruning eligible. You do not need to use the set vtp pruning command
unless you have previously used the clear vtp pruning command to make some VLANs pruning
ineligible.
If VLANs have been made pruning ineligible, use the set vtp pruning command to make them pruning
eligible again.

Examples This example shows how to configure pruning eligibility for VLANs 120 and 150:
Console> (enable) set vtp pruning 120,150
Vlans 120,150 eligible for pruning on this device.
VTP domain nada modified.
Console> (enable)

In this example, VLANs 200–500 were made pruning ineligible using the clear vtp pruning command.
This example shows how to make VLANs 220 to 320 pruning eligible again:
Console> (enable) clear vtp pruning 200-500
Vlans 1,200-500,1001-1005 will not be pruned on this device.
VTP domain Company modified.
Console> (enable)

Console> (enable) set vtp pruning 220-320

Vlans 2-199,220-320,501-1000 eligible for pruning on this device.
VTP domain Company modified.
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-391
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
set vtp pruning

Related Commands clear vtp pruning

set vlan
show vtp domain

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-392 78-12648-03
 2
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show accounting

show accounting
Use the show accounting command to display accounting setup and configuration information on the
switch.

show accounting

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows the configuration details of a switch with RADIUS accounting enabled:
Console> (enable) show accounting
Event Method1 Mode
----- ------- ----
exec: tacacs+ start-stop
connect: radius stop-only
system: tacacs+ stop-only
commands:
config: tacacs+ stop-only
all: - -

TACACS+ Suppress for no username: disabled

Update Frequency: newinfo

Accounting information:
-----------------------

Active Accounted actions on tty2168059284l, User NULL Priv 15

Task ID 3, EXEC Accounting record, 0,00:00:22 Elapsed
task_id=3 start_time=934463479 timezone=UTC service=shell
Active Accounted actions on tty0l, User kannank Priv 15
Task ID 2, EXEC Accounting record, 0,00:01:23 Elapsed
task_id=2 start_time=934463418 timezone=UTC service=shell
Active Accounted actions on tty2168059284l, User danny Priv 15
Task ID 4, Connection Accounting record, 0,00:00:07 Elapsed
task_id=4 start_time=934463495 timezone=UTC service=connection protocol=telnet
addr=-1407968771 cmd=telnet 172.20.25.253

Overall Accounting Traffic:

Starts Stops Active
Exec 1 0 2
Connect 0 0 1
Command 0 0 0
System 0 0 0
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-393
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show accounting

This example shows the configuration details of a switch with TACACS+ accounting enabled:
Console> (enable) show accounting
Tacacs key:
Tacacs login attempts: 3
Tacacs timeout: 5 seconds
Tacacs direct request: disabled

Tacacs-Server Status
-------------- -------
171.69.1.2 primary
171.69.1.3

TACACS+ Suppress for no username: disabled

Update Frequency: newinfo

Accounting information:
-----------------------

Active Accounted actions on tty2168059284l, User NULL Priv 15

Task ID 3, EXEC Accounting record, 0,00:00:22 Elapsed
task_id=3 start_time=934463479 timezone=UTC service=shell

Active Accounted actions on tty0l, User kannank Priv 15

Task ID 2, EXEC Accounting record, 0,00:01:23 Elapsed
task_id=2 start_time=934463418 timezone=UTC service=shell

Active Accounted actions on tty2168059284l, User danny Priv 15

Task ID 4, Connection Accounting record, 0,00:00:07 Elapsed
task_id=4 start_time=934463495 timezone=UTC service=connection protocol=telnet
addr=-1407968771 cmd=telnet 172.20.25.253

Overall Accounting Traffic:

Starts Stops Active
Exec 1 0 2
Connect 0 0 1
Command 0 0 0
System 0 0 0

Console> (enable)

Related Commands set accounting commands

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

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-394 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show alias

show alias
Use the show alias command to display a list of defined command aliases.

show alias [name]

Syntax Description name (Optional) Name of the alias to be displayed. If name is not
specified, all defined aliases are displayed.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display all aliases:

Console> show alias
shint show interface
cc clear config
shf show flash
sip show ip route
Console>

Related Commands clear kerberos clients mandatory

session
set alias

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-395
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show arp

show arp
Use the show arp command to display the ARP table.

show arp [ip_addr | hostname] [noalias]

Syntax Description ip_addr (Optional) Number of the IP address.

hostname (Optional) Name of the host.
noalias (Optional) Keyword that specifies to force the display to show only
IP addresses, not IP aliases.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines The ARP Aging time display in the output is the period of time that indicates when an ARP entry is
removed from the ARP table. Set this value by entering the set arp agingtime command. The remaining
lines of the display show the mappings of IP addresses (or IP aliases) to MAC addresses.
Use the ip_addr or the hostname options to specify a specific IP host when the ARP cache is large.

Examples This example shows how to display the ARP table:

Console> (enable) show arp
ARP Aging time = 300 sec
+ - Permanent Arp Entries
* - Static Arp Entries
* 2.2.2.2 at 00-08-cc-44-aa-18 on vlan 5
+ 1.1.1.1 at 00-08-94-cc-02-aa on vlan 5
142.10.52.195 at 00-10-07-3c-05-13 port 7/1-4 on vlan 5
Console> (enable)

This example shows how to display the ARP table without aliases:
Console> (enable) show arp noalias
ARP Aging time = 300 sec
+ - Permanent Arp Entries
* - Static Arp Entries
142.10.52.195 at 00-10-07-3c-05-13 port 7/1-4 on vlan 5
121.23.79.121 at 00-00-1c-03-00-40 port 7/1-4 on vlan 5
Console> (enable)

Related Commands clear arp

set arp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-396 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show authentication

show authentication
Use the show authentication command to display authentication information.

show authentication

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display authentication information:

Console> show authentication
Console Session Telnet Session Http Session
Login Authentication:
--------------------- ---------------- --------------- -----------
tacacs disabled disabled disabled
radius disabled disabled disabled
kerberos disabled disabled disabled
local enabled(primary) enabled(primary) enabled(primary)
attempt limit 3 3 -
lockout timeout (sec) 230 seconds 120 seconds 120 seconds

Enable Authentication: Console Session Telnet Session Http Session

---------------------- ----------------- ---------------- ----------------
tacacs disabled disabled disabled
radius disabled disabled disabled
kerberos disabled disabled disabled
local enabled(primary) enabled(primary) enabled(primary)
attempt limit 3 3 -
lockout timeout (sec) disabled 600 seconds 600 seconds
(*) primary

Console>

Related Commands set authentication enable

set authentication login

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-397
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show authorization

show authorization
Use the show authorization command to display authorization setup and configuration information on
the switch.

show authorization

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display authorization information:

Console> (enable) show authorization

Telnet:
-------
Primary Fallback
------- --------
exec: tacacs+ If-authen
enable: - -
commands:
config: tacacs+ If-authen
all: - -

Console:
--------
Primary Fallback
------- --------
exec: tacacs+ If-authen
enable: - -
commands:
config: - -
all: - -
Console> (enable)

Related Commands set authorization commands

set authorization enable
set authorization exec

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-398 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show banner

show banner
Use the show banner command to view the message of the day (MOTD) banner.

show banner

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the MOTD and Catalyst 4000 Family Switch Fabric Module LCD
banner stored in NVRAM:
Console> show banner
MOTD banner:

Catalyst 4006, Software Release 6.1(1)

Console>

Related Commands set banner motd

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-399
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show boot—ROM monitor

show boot—ROM monitor

Use the show boot command to display the contents of the BOOT environment variables and the
configuration register setting.

show boot

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Examples This example shows how to display information on the BOOT environment variables and the
configuration register settings:
rommon 2 > show boot
BOOT variable = bootflash:cat4000.6-1-1.bin,1;
Configuration reg is 0x41
ignore-config: enabled
console baud: 9600
boot: first image in "bootflash:"
autoboot state = 2
autoboot count = 0
autoboot sptr = 0
rommon 3 >

Related Commands boot

clear boot—ROM monitor

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-400 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show boot—switch

show boot—switch
Note This command applies to only the Supervisor Engine III or the Catalyst 4000 family and 2948G
switch supervisor engine modules. If you attempt to run this command on a Supervisor Engine I or
II, you will receive an error message.

Use the show boot command to display the contents of the BOOT environment variables and the
configuration register setting.

show boot [mod_num]

Syntax Description mod_num (Optional) Module number of the supervisor engine containing the
Flash device.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to use the show boot command:
Console> show boot
BOOT variable = bootflash:cat5000-sup3.5-1-0-59.bin,1;bootflash:cat5000-sup3.4-;
CONFIG_FILE variable = slot0:cfgfile1;slot0:cfgfile2

Configuration register is 0x10f

ignore-config: disabled
auto-config: recurring
console baud: 9600
boot: image specified by the boot system commands
Console>

Related Commands show boot—switch

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-401
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show cam

show cam
Use the show cam command to display the CAM table.

show cam count {dynamic | static | permanent | system} [vlan]

show cam {dynamic | static | permanent} mod_num/port_num

show cam mac_addr [vlan]

Syntax Description count Keyword that specifies to display only the number of CAM entries.
dynamic Keyword that specifies to display dynamic CAM entries.
static Keyword that specifies to display static CAM entries.
permanent Keyword that specifies to display permanent CAM entries.
system Keyword that specifies to display system CAM entries.
vlan (Optional) Number of the VLAN. If a VLAN is not specified, all VLANs are
displayed.
mod_num Number of the module.
port_num Number of the port.
mac_addr MAC address.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If you display the output associated with the MAC address of an ATM dual PHY OC-12 module,
additional information is displayed, including the VCD, VPI, VCI, and VC type.
If you enter the show cam command on the Catalyst 4000 family switches, the ASE CAM table entries
are displayed.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-402 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show cam

Examples This example shows how to display dynamic CAM entries for all VLANs:
Console> show cam dynamic
* = Static Entry. + = Permanent Entry. # = System Entry. R = Router Entry.

VLAN Dest MAC/Route Des Destination Ports or VCs / [Protocol Type]

---- ------------------ ----------------------------------------------------
1 00-60-5c-86-5b-81 4/1 [ALL]
1 00-60-2f-35-48-17 4/1 [ALL]
1 00-80-24-f3-47-20 1/2 [ALL]
1 00-60-09-78-96-fb 4/1 [ALL]
1 00-80-24-1d-d9-ed 1/2 [ALL]
1 00-80-24-1d-da-01 1/2 [ALL]
1 08-00-20-7a-63-01 4/1 [ALL]

Total Matching CAM Entries Displayed = 7

Console>

This example shows the output associated with the MAC address of an ATM dual PHY OC-12 module,
which includes the dynamic CAM entries for all VLANs:
Console> show cam dynamic
VLAN Dest MAC/Route Des Destination Ports or VCs
---- ------------------ ----------------------------------------------------
12 00-14-14-14-14-1c 6/1
12 00-14-14-14-14-1d 6/1
12 00-14-14-14-14-1a 6/1
12 00-14-14-14-14-1b 6/1
12 00-14-14-14-14-18 6/1
12 00-14-14-14-14-19 6/1
12 00-14-14-14-14-16 6/1
12 00-14-14-14-14-17 6/1
12 00-14-14-14-14-14 6/1
12 00-14-14-14-14-15 6/1
6 00-14-14-14-14-16 4/1 VCD:98 VPI:0 VCI:127 Type: LANE Data Direct
6 00-14-14-14-14-17 4/1 VCD:98 VPI:0 VCI:127 Type: LANE Data Direct
6 00-14-14-14-14-14 4/1 VCD:98 VPI:0 VCI:127 Type: LANE Data Direct
6 00-14-14-14-14-15 4/1 VCD:98 VPI:0 VCI:127 Type: LANE Data Direct
6 00-14-14-14-14-1a 4/1 VCD:98 VPI:0 VCI:127 Type: LANE Data Direct
6 00-14-14-14-14-1b 4/1 VCD:98 VPI:0 VCI:127 Type: LANE Data Direct
6 00-14-14-14-14-18 4/1 VCD:98 VPI:0 VCI:127 Type: LANE Data Direct
6 00-14-14-14-14-19 4/1 VCD:98 VPI:0 VCI:127 Type: LANE Data Direct
6 00-14-14-14-14-1c 4/1 VCD:98 VPI:0 VCI:127 Type: LANE Data Direct
6 00-14-14-14-14-1d 4/1 VCD:98 VPI:0 VCI:127 Type: LANE Data Direct
3 00-14-14-14-14-14 4/1 VCD:101 VPI:0 VCI:130 Type: LANE Data Direct
3 00-14-14-14-14-15 4/1 VCD:101 VPI:0 VCI:130 Type: LANE Data Direct
Do you wish to continue y/n [n]? n
Total Matching CAM Entries Displayed = 21
Console>

Table 2-12 describes the fields in the ATM dual PHY OC-12 module show cam dynamic output.

Table 2-12 show cam dynamic Command Output Fields

Field Description
VCD VCD of the VC
VPI VPI of the VC
VCI VCI of the VC
Type Type of virtual circuit (LANE Data Direct, LANE bus, or
AAL5SNAP PVC)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-403
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show cam

This example shows routers listed as the CAM entries. If the MAC address belongs to a router, it is
shown by appending an “R” to the MAC address. If a VLAN is specified, then only those CAM entries
matching the VLAN number are displayed.
Console> show cam 00-00-81-01-23-45
* = Static Entry. + = Permanent Entry. # = System Entry. R = Router Entry

Router Watergate with IP address 172.25.55.1 has CAM entries:

VLAN Dest MAC/Route Des Destination Ports or VCs
---- ------------------ ----------------------------------------------------
1 00-00-81-01-23-45R 2/9 [IP]
2 00-00-81-01-23-45R 2/10 [IP]
Total Matching CAM Entries = 2
Console>

Related Commands clear cam

set cam
show cam agingtime
show config

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-404 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show cam agingtime

show cam agingtime

Use the show cam agingtime command to display CAM aging time information for all configured
VLANs.

show cam agingtime

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display CAM aging time information:
Console> show cam agingtime
VLAN 1 aging time = 300 sec
VLAN 3 aging time = 300 sec
VLAN 5 aging time = 300 sec
VLAN 9 aging time = 300 sec
VLAN 100 aging time = 300 sec
VLAN 200 aging time = 300 sec
VLAN 201 aging time = 300 sec
VLAN 202 aging time = 300 sec
VLAN 203 aging time = 300 sec
Console>

Related Commands clear cam

set cam
show cam

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-405
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show cdp

show cdp
Use the show cdp command to display CDP information.

show cdp

show cdp neighbors [mod_num] [vlan | duplex | capabilities | detail]

show cdp neighbors [mod_num/port_num] [vlan | duplex | capabilities | detail]

show cdp port [mod_num]

show cdp port [mod_num/port_num]

Syntax Description neighbors Keyword that specifies to show CDP information for Cisco products connected
to the switch.
mod_num (Optional) Number of the module for which CDP information is displayed. If no
module number is specified, CDP information for the entire switch is displayed.
vlan (Optional) Keyword that specifies to show the native VLAN number for the
neighboring Cisco products.
duplex (Optional) Keyword that specifies to show duplex type of the neighboring Cisco
products.
capabilities (Optional) Keyword that specifies to show the capability codes for the
neighboring Cisco products. Valid values are R, T, B, S, H, I, r (R=Router,
T=Trans Bridge, B=Source Route Bridge, S=Switch, H=Host, I=IGMP, and
r=Repeater).
detail (Optional) Keyword that specifies to show detailed information about
neighboring Cisco products.
port_num (Optional) Number of the port for which CDP information is displayed.
port Keyword that specifies to show CDP port settings.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display CDP information for the system:
Console> show cdp
CDP :enabled
Message Interval :60
Hold Time :180
Version :V2
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-406 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show cdp

This example shows how to display detailed CDP neighbor information. The display varies depending
on your network configuration at the time you run the command.
Console> show cdp neighbors 4/4 detail
Port (Our Port):4/4
Device-ID:69046406
Device Addresses:
IP Address:172.20.25.161
Holdtime:150 sec
Capabilities:TRANSPARENT_BRIDGE SWITCH
Version:
WS-C5509 Software, Version McpSW: 5.3(0.29)BOU NmpSW: 5.3(0.29)BOU
Copyright (c) 1995-1999 by Cisco Systems
Port-ID (Port on Device):4/8
Platform:WS-C6009
VTP Management Domain:unknown
Native VLAN:1
Duplex:half
Console>

This example shows how to display CDP information about neighboring systems:
Console> show cdp neighbors
* - indicates vlan mismatch.
# - indicates duplex mismatch.

Port Device-ID Port-ID Platform

-------- ------------------------------- ------------------------- ------------
3/5 002267619 3/6 * WS-C4000
3/6 002267619 3/5 WS-C4000
4/1 002267619 4/2 WS-C4000
4/2 002267619 4/1 # WS-C4000
4/20 069000057 8/5 WS-C5500
5/1 005763872 2/1 WS-C5000
5/1 066506245 2/1 WS-C5505
5/1 066508595 5/12 *# WS-C5505
5/1 066508596 5/1 WS-C5505
Console>

This example shows how to display VLAN information about neighboring systems:
Console> show cdp vlan
* - indicates vlan mismatch.
# - indicates duplex mismatch.

Port Device-ID Port-ID NativeVLAN

-------- ------------------------------- ------------------------- ----------
3/5 002267619 3/6 * 1
3/6 002267619 3/5 1
4/1 002267619 4/2 1
4/2 002267619 4/1 # 1
4/20 069000057 8/5 -
5/1 066508595 5/12 *# 1
5/1 066508596 5/1 1
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-407
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show cdp

This example shows how to display duplex information about neighboring systems:
Console> show cdp neighbors duplex
* - indicates vlan mismatch.
# - indicates duplex mismatch.

Port Device-ID Port-ID Duplex

-------- ------------------------------- ------------------------- ------
3/5 002267619 3/6 * half
3/6 002267619 3/5 half
4/1 002267619 4/2 full
4/2 002267619 4/1 # full
4/20 069000057 8/5 -
5/1 005763872 2/1 -
5/1 066506245 2/1 -
5/1 066508595 5/12 *# half
5/1 066508596 5/1 half
Console>

This example shows how to display capability information about neighboring systems:
Console> show cdp neighbors capabilities
* - indicates vlan mismatch.
# - indicates duplex mismatch.

Port Device-ID Port-ID Capabilities

-------- ------------------------------- ------------------------- ------------
3/5 002267619 3/6 * T S
3/6 002267619 3/5 T S
4/1 002267619 4/2 T S
4/2 002267619 4/1 # T S
4/20 069000057 8/5 T B S
5/1 005763872 2/1 T B S
5/1 066506245 2/1 T B S
5/1 066508595 5/12 *# T B S
5/1 066508596 5/1 T B S
Console>

This example shows how to display CDP information for all ports:
Console> show cdp port
CDP :enabled
Message Interval :60
Hold Time :180
Version :V2

Port CDP Status

-------- ----------
2/1 enabled
2/2 enabled
5/1 enabled
5/2 enabled
5/3 enabled
5/4 enabled
5/5 enabled
5/6 enabled
5/7 enabled
5/8 enabled
Console>

Related Commands set cdp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-408 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show cgmp leave

show cgmp leave

Use the show cgmp leave command to display the status of the CGMP leave feature.

show cgmp leave

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the status of the CGMP leave feature:
Console> show cgmp leave
CGMP: enabled
CGMP leave: enabled
Console>

Related Commands set cgmp leave

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-409
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show cgmp statistics

show cgmp statistics

Use the show cgmp statistics command to display CGMP statistics.

show cgmp statistics [vlan_id]

Syntax Description vlan_id (Optional) VLAN number for which to display CGMP statistics.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display CGMP statistics for VLAN 1:
Console> show cgmp statistics 1
CGMP enabled

CGMP statistics for vlan 1:

valid rx pkts received 211915
invalid rx pkts received 0
valid cgmp joins received 211729
valid cgmp leaves received 186
valid igmp leaves received 0
valid igmp queries received 3122
igmp gs queries transmitted 0
igmp leaves transmitted 0
failures to add GDA to EARL 0
topology notifications received 80
number of CGMP packets dropped 2032227
Console>

Table 2-13 describes the fields in the show cgmp statistics output.

Table 2-13 show cgmp statistics Command Output Fields

Field Description
Valid rx pkts received Number of valid CGMP packets received
Invalid rx pkts received Number of invalid CGMP packets received
valid cgmp joins Number of CGMP group-specific queries received
received
valid cgmp leaves Number of CGMP leaves received
received
valid igmp leaves Number of IGMP leaves received
received

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-410 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show cgmp statistics

Table 2-13 show cgmp statistics Command Output Fields (continued)

Field Description
valid igmp queries Number of IGMP reports received
received
igmp gs queries Number of IGMP group specific-equivalent queries transmitted by
transmitted the switch
igmp leaves transmitted Number of IGMP leaves transmitted by the switch
failures to add GDA to Number of times that the switch failed to add a multicast entry
EARL (GDA) to the EARL table
topology notifications Number of topology change notifications received by the switch
received
number of CGMP Number of IGMP packets dropped by the switch
packets dropped

Related Commands clear cgmp statistics

set cgmp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-411
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show channel

show channel
Use the show channel command to display EtherChannel configuration and statistics information for a
channel based on EtherChannel ID.

show channel [channel_id] [statistics | mac | info [spantree | trunk | protocol | gmrp | gvrp |
qos | auxiliaryvlan | jumbo]]

Syntax Description channel_id (Optional) EtherChannel ID of the channel.

statistics (Optional) Keyword that specifies to display EtherChannel PAgP
statistics.
mac (Optional) Keyword that specifies to display EtherChannel traffic
statistics.
info (Optional) Keyword that specifies to display EtherChannel
configuration information.
spantree (Optional) Keyword that specifies to display only spanning
tree-related configuration information.
trunk (Optional) Keyword that specifies to display only
VLAN-trunk-related configuration information.
protocol (Optional) Keyword that specifies to display only
protocol-filtering-related configuration information.
gmrp (Optional) Keyword that specifies to display only GMRP-related
configuration information.
gvrp (Optional) Keyword that specifies to display only GVRP-related
configuration information.
qos (Optional) Keyword that specifies to display only QoS-related
configuration information.
auxiliaryvlan (Optional) Keyword that specifies to display only auxiliary vlan
related configuration information.
jumbo (Optional) Keyword that specifies to display only jumbo related
configuration information.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-412 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show channel

Usage Guidelines If channel_id is not specified, EtherChannel information is shown for all channels.
If you use the info keyword without qualifying it with one of the feature-specific keywords, all
configuration information is displayed.
No information is displayed if the EtherChannel specified is not in use.

Examples This example shows how to display PAgP statistics for EtherChannel 835:
Console> show channel 835 statistics
Port Channel PAgP Pkts PAgP Pkts PAgP Pkts PAgP Pkts PAgP Pkts PAgP Pkts
id Transmitted Received InFlush RetnFlush OutFlush InError
----- ------- ----------- --------- --------- --------- --------- ---------
7/5 835 194 81 0 0 0 0
7/6 835 204 85 0 0 0 0
Console>

This example shows how to display traffic statistics for EtherChannel:

Console> show channel 835 mac
Channel Rcv-Unicast Rcv-Multicast Rcv-Broadcast
-------- -------------------- -------------------- --------------------
835 0 114650 0

Channel Xmit-Unicast Xmit-Multicast Xmit-Broadcast

-------- -------------------- -------------------- --------------------
835 0 177145 0

Channel Rcv-Octet Xmit-Octet

-------- -------------------- --------------------
835 10852890 14371660

Channel Dely-Exced MTU-Exced In-Discard Lrn-Discrd In-Lost Out-Lost

-------- ---------- ---------- ---------- ---------- ---------- ----------
835 0 0 0 0 0 0
Console>

This example shows how to display EtherChannel information for all channels:
Console> show channel
Channel Id Ports
----------- -----------------------------------------------
768 2/1-2
769 4/3-4
770 4/7-8
Console>

This example shows how to display configuration information for EtherChannel 835:
Console> show channel 835 info
Chan Port Status Channel Admin Speed Duplex Vlan
id mode group
---- ----- ---------- -------------------- ----- ----- ------ ----
835 7/5 connected on 58 a-100 a-full 1
835 7/6 connected on 58 a-100 a-full 1

Chan Port if- Oper-group Neighbor Chan Oper-Distribution PortSecurity/

id Index Oper-group cost Method Dynamic Port
---- ----- ----- ---------- ---------- ----- ----------------- -------------
835 7/5 379 1 0 mac both
835 7/6 379 1 0 mac both

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-413
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show channel

Chan Port Device-ID Port-ID Platform

id
---- ----- ------------------------------- ------------------------- ----------
835 7/5 069003103(5500) 3/5 WS-C5500
835 7/6 069003103(5500) 3/6 WS-C5500

Chan Port Trunk-status Trunk-type Trunk-vlans

id
----- ----- ------------ ------------- -----------------------------------------
835 7/5 not-trunking negotiate 1-1005
835 7/6 not-trunking negotiate 1-1005

Chan Port Portvlancost-vlans

id
---- ----- --------------------------------------------------------------------
835 7/5
835 7/6

Chan Port Port Portfast Port Port

id priority vlanpri vlanpri-vlans
---- ----- -------- -------- ------- ------------------------------------------
835 7/5 32 disabled 0
835 7/6 32 disabled 0

Chan Port IP IPX Group

id
---- ----- -------- -------- --------
835 7/5 on auto-on auto-on
835 7/6 on auto-on auto-on

Chan Port GMRP GMRP GMRP

id status registration forwardAll
---- ----- -------- ------------ ----------
835 7/5 enabled normal disabled
835 7/6 enabled normal disabled

Chan Port GVRP GVRP GVRP

id status registeration applicant
---- ----- -------- ------------- ---------
835 7/5 disabled normal normal
835 7/6 disabled normal normal

Chan Port Qos-Tx Qos-Rx Qos-Trust Qos-DefCos

id
---- ----- ------ ------ ------------ ----------
835 7/5 1q4t - untrusted 0
835 7/6 1q4t - untrusted 0
Console>

Table 2-14 describes the fields in the show channel statistics output.

Table 2-14 show channel statistics Command Output Fields

Field Description
Port Port number
Channel id EtherChannel ID
PAgP Pkts Transmitted Number of PAgP packets transmitted on the port
PAgP Pkts Received Number of PAgP packets received on the port
PAgP Pkts InFlush Number of PAgP flush packets received

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-414 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show channel

Table 2-14 show channel statistics Command Output Fields (continued)

Field Description
PAgP Pkts RetnFlush Number of PAgP flush packets returned
PAgP Pkts OutFlush Number of PAgP flush packets transmitted
PAgP Pkts InError Number of PAgP error packets received

Table 2-15 describes the fields in the show channel mac output.

Table 2-15 show channel mac Command Output Fields

Field Description
Channel EtherChannel ID
Rcv-Unicast Number of unicast frames received on the EtherChannel
Rcv-Multicast Number of multicast frames received on the EtherChannel
Rcv-Broadcast Number of broadcast frames received on the EtherChannel
Xmit-Unicast Number of unicast frames transmitted on the EtherChannel
Xmit-Multicast Number of multicast frames transmitted on the EtherChannel
Xmit-Broadcast Number of broadcast frames transmitted on the EtherChannel
Rcv-Octet Number of octet frames received on the EtherChannel
Xmit-Octet Number of octet frames transmitted on the EtherChannel

Table 2-16 describes the fields in the show channel info output.

Table 2-16 show channel info Command Output Fields

Field Description
Chan id EtherChannel ID
Port Port number
Status Port connection status
Channel mode EtherChannel mode
Admin group EtherChannel administrative group
Speed Port speed
Duplex Port duplex
Vlan Port VLAN membership
if-index Interface index number
Oper-group Capability of the group
Neighbor Oper-group Device ID of the neighboring device with which the port is
channeling
Chan cost EtherChannel spanning tree port cost
Oper-Distribution EtherChannel frame distribution method
Method

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-415
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show channel

Table 2-16 show channel info Command Output Fields (continued)

Field Description
PortSecurity/Dynamic Status of whether the port is secure or dynamic
Port
Device-ID Serial number and hostname of neighboring device
Port-ID Connected port number on neighboring device
Platform Neighboring device platform
Trunk-status VLAN trunking mode
Trunk-type VLAN trunk encapsulation type
Trunk-vlans Allowed VLAN list for the trunk
Portvlancost-vlans Spanning tree port-VLAN cost and associated VLAN IDs
Port priority Spanning tree port priority
Portfast Spanning tree PortFast enable state
Port vlanpri-vlans Spanning tree port-VLAN priority and associated VLAN IDs
IP IP protocol filtering mode
IPX IPX protocol filtering mode
Group Group protocol filtering mode
GMRP status GMRP enable state
GMRP registration GMRP registration mode
GMRP forwardAll GMRP forward-all enable status
GVRP status GVRP enable state
GVRP registration GVRP registration mode
GVRP applicant GVRP applicant mode
Qos-Tx Transmit queue and threshold port type
Qos-Rx Receive queue and threshold port type
Qos-Trust QoS port trust
QoS-DefCos QoS default CoS

Related Commands set channel cost

set channel vlancost
set port channel
show channel group
show port channel

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-416 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show channel group

show channel group

Use the show channel group command to display EtherChannel configuration and statistics information
for a channel based on EtherChannel administrative group membership.

show channel group [admin_group] [statistics | info [spantree | trunk | protocol | gmrp | gvrp |
qos | auxiliaryvlan | jumbo]]

Syntax Description admin_group (Optional) Number of the EtherChannel administrative group. Valid
values are 1 to 1024.
statistics (Optional) Keyword that specifies to display EtherChannel PAgP
statistics.
info (Optional) Keyword that specifies to display EtherChannel
configuration information.
spantree (Optional) Keyword that specifies to display only spanning
tree-related configuration information.
trunk (Optional) Keyword that specifies to display only
VLAN-trunk-related configuration information.
protocol (Optional) Keyword that specifies to display only
protocol-filtering-related configuration information.
gmrp (Optional) Keyword that specifies to display only GMRP-related
configuration information.
gvrp (Optional) Keyword that specifies to display only GVRP-related
configuration information.
qos (Optional) Keyword that specifies to display only QoS-related
configuration information.
auxiliaryvlan (Optional) Keyword that specifies to display only auxiliary vlan
related configuration information.
jumbo (Optional) Keyword that specifies to display only jumbo related
configuration information.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If admin_group is not specified, EtherChannel information is shown for all admin groups.
If you use the info keyword without qualifying it with one of the feature-specific keywords, all
configuration information is displayed.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-417
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show channel group

Examples This example shows how to display EtherChannel information for EtherChannel administrative
group 58:
Console> show channel group 58
Admin Port Status Channel Channel
group Mode id
----- ----- ---------- -------------------- --------
58 6/5 connected on 835
58 6/6 connected on 835

Admin Port Device-ID Port-ID Platform

group
----- ----- ------------------------------- ------------------------- ----------
58 6/5 069003103(5500) 3/5 WS-C5500
58 6/6 069003103(5500) 3/6 WS-C5500
Console>

This example shows how to display PAgP statistics for EtherChannel administrative group 58:
Console> show channel group 58 statistics
Port Admin PAgP Pkts PAgP Pkts PAgP Pkts PAgP Pkts PAgP Pkts PAgP Pkts
Group Transmitted Received InFlush RetnFlush OutFlush InError
----- ------- ----------- --------- --------- --------- --------- ---------
6/5 58 194 81 0 0 0 0
6/6 58 204 85 0 0 0 0
Console>

This example shows how to display EtherChannel configuration information for EtherChannel
administrative group 58:
Console> show channel group 58 info
Admin Port Status Channel Ch Speed Duplex Vlan
group mode id
----- ----- ---------- -------------------- ----- ----- ------ ----
58 6/5 connected on 835 a-100 a-full 1
58 6/6 connected on 835 a-100 a-full 1

Admin Port if- Oper-group Neighbor Chan Oper-Distribution PortSecurity/

group Index Oper-group cost Method Dynamic Port
----- ----- ----- ---------- ---------- ----- ----------------- -------------
58 6/5 379 1 0 mac both
58 6/6 379 1 0 mac both

Admin Port Device-ID Port-ID Platform

group
----- ----- ------------------------------- ------------------------- ----------
58 6/5 069003103(5500) 3/5 WS-C5500
58 6/6 069003103(5500) 3/6 WS-C5500

Admin Port Trunk-status Trunk-type Trunk-vlans

group
----- ----- ------------ ------------- -----------------------------------------
58 6/5 not-trunking negotiate 1-1005
58 6/6 not-trunking negotiate 1-1005
Admin Port Portvlancost-vlans
group
----- ----- --------------------------------------------------------------------
58 6/5
58 6/6

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-418 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show channel group

Admin Port Port Portfast Port Port

group priority vlanpri vlanpri-vlans
----- ----- -------- -------- ------- ------------------------------------------
58 6/5 32 disabled 0
58 6/6 32 disabled 0

Admin Port IP IPX Group

group
----- ----- -------- -------- --------
58 6/5 on auto-on auto-on
58 6/6 on auto-on auto-on

Admin Port GMRP GMRP GMRP

group status registration forwardAll
----- ----- -------- ------------ ----------
58 6/5 enabled normal disabled
58 6/6 enabled normal disabled

Admin Port GVRP GVRP GVRP

group status registration applicant
----- ----- -------- ------------- ---------
58 6/5 disabled normal normal
58 6/6 disabled normal normal

Admin Port Qos-Tx Qos-Rx Qos-Trust Qos-DefCos

group
----- ----- ------ ------ ------------ ----------
58 6/5 - - untrusted 0
58 6/6 - - untrusted 0
Console>

Table 2-17 describes the fields in the show channel group output.

Table 2-17 show channel group Command Output Fields

Field Description
Admin group EtherChannel administrative group
Port Port number
Status Port connection status
Channel Mode EtherChannel mode
Channel id EtherChannel ID
Device-ID Serial number and hostname of neighboring device
Port-ID Connected port number on neighboring device
Platform Neighboring device platform

Table 2-18 describes the fields in the show channel group statistics output.

Table 2-18 show channel group statistics Command Output Fields

Field Description
Port Port number
Admin Group EtherChannel administrative group
PAgP Pkts Transmitted Number of PAgP packets transmitted on the port

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-419
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show channel group

Table 2-18 show channel group statistics Command Output Fields (continued)

Field Description
PAgP Pkts Received Number of PAgP packets received on the port
PAgP Pkts InFlush Number of PAgP flush packets received
PAgP Pkts RetnFlush Number of PAgP flush packets returned
PAgP Pkts OutFlush Number of PAgP flush packets transmitted
PAgP Pkts InError Number of PAgP error packets received

Table 2-19 describes the fields in the show channel group info output.

Table 2-19 show channel group info Command Output Fields

Field Description
Admin group EtherChannel administrative group
Port Port number
Status Port connection status
Channel mode EtherChannel mode
Ch id EtherChannel ID
Speed Port speed
Duplex Port duplex
Vlan Port VLAN membership
if-Index Interface index number
Oper-group Capability of the group
Neighbor Oper-group Device ID of the neighboring device with which the port is
channeling
Chan cost EtherChannel spanning tree port cost
Oper-Distribution EtherChannel frame distribution method
Method
PortSecurity/Dynamic Status of whether the port is secure or dynamic
Port
Device-ID Serial number and hostname of neighboring device
Port-ID Connected port number on neighboring device
Platform Neighboring device platform
Trunk-status VLAN trunking mode
Trunk-type VLAN trunk encapsulation type
Trunk-vlans Allowed VLAN list for the trunk
Portvlancost-vlans Spanning tree port-VLAN cost and associated VLAN IDs
Port priority Spanning tree port priority
Portfast Spanning tree PortFast enable state
Port vlanpri-vlans Spanning tree port-VLAN priority and associated VLAN IDs

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-420 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show channel group

Table 2-19 show channel group info Command Output Fields (continued)

Field Description
IP IP protocol filtering mode
IPX IPX protocol filtering mode
Group Group protocol filtering mode
GMRP status GMRP enable state
GMRP registration GMRP registration mode
GMRP forwardAll GMRP forward-all enable status
GVRP status GVRP enable state
GVRP registration GVRP registration mode
GVRP applicant GVRP applicant mode
Qos-Tx Transmit queue and threshold port type
Qos-Rx Receive queue and threshold port type
Qos-Trust QoS port trust
QoS-DefCos QoS default CoS

Related Commands set channel cost

set channel vlancost
set port channel
show channel
show port channel

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-421
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show channel mac

show channel mac

Use the show channel mac command to display MAC information in a channel.

show channel mac

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display MAC information in a channel:

Console> (enable) show channel mac
Channel Rcv-Unicast Rcv-Multicast Rcv-Broadcast
-------- -------------------- -------------------- --------------------

Channel Xmit-Unicast Xmit-Multicast Xmit-Broadcast

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

Channel Rcv-Octet Xmit-Octet

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

Channel Dely-Exced MTU-Exced In-Discard Lrn-Discrd In-Lost Out-Lost

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

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-422 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show channel traffic

show channel traffic

Use the show channel traffic command to display channel port utilization based on MAC counters.

show channel traffic [channel_id]

Syntax Description channel_id (Optional) Number of the channel.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If you do not specify channel_id, EtherChannel information is shown for all channels.
No information is displayed if the channel specified is not in use.

Examples This example shows how to display traffic information in a channel:

Console> show channel traffic 769
ChanId Port Rx-Ucst Tx-Ucst Rx-Mcst Tx-Mcst Rx-Bcst Tx-Bcst
------ ----- ------- ------- ------- ------- ------- -------
769 1/1 0.00% 0.00% 0.00% 0.00% 0.00% 0.00%
769 1/2 100.00% 100.00% 100.00% 100.00% 0.00% 0.00%
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-423
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show config

show config
Use the show config command to display the non-default system configuration.

show config {system | mod_num} [all]

Syntax Description system Keyword that specifies to display system configuration.

mod_num Number of the module.
all (Optional) Keyword that specifies all modules and system configuration
information, including the IP address.

Defaults The default is that this command shows only non-default configurations. To view the entire
configuration, use the keyword all.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to display the nondefault system and module configuration:
Console> (enable) show config
This command shows non-default configurations only.
Use 'show config all' to show both default and non-default configurations.
........
..

begin
!
# ***** NON-DEFAULT CONFIGURATION *****
!
!
#Time: Thu Dec 23 1999, 21:56:01
!
#version 5.4(0.52)MIA7-Eng
#System Web Interface Version 5.0(0.25)
!
set editing disable
!
#frame distribution method
set port channel all distribution mac unknown
!
#snmp
set snmp trap 0.0.0.0
set snmp trap 0.0.0.0
!
#kerberos
set kerberos server 0.0.0.0
set kerberos server 0.0.0.0
set kerberos realm
set kerberos realm

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-424 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show config

!
#vtp
set vtp domain Lab_Network
set vtp v2 enable
set vtp pruning enable
set vlan 1 name default type ethernet mtu 1500 said 100001 state active
set vlan 2 name VLAN0002 type ethernet mtu 1500 said 100002 state active
set vlan 6 name VLAN0006 type ethernet mtu 1500 said 100006 state active
set vlan 10 name VLAN0010 type ethernet mtu 1500 said 100010 state active
set vlan 20 name VLAN0020 type ethernet mtu 1500 said 100020 state active
set vlan 50 name VLAN0050 type ethernet mtu 1500 said 100050 state active
set vlan 100 name VLAN0100 type ethernet mtu 1500 said 100100 state active
set vlan 152 name VLAN0152 type ethernet mtu 1500 said 100152 state active
set vlan 200 name VLAN0200 type ethernet mtu 1500 said 100200 state active
set vlan 300 name VLAN0300 type ethernet mtu 1500 said 100300 state active
set vlan 303 name VLAN0303 type fddi mtu 1500 said 100303 state active
set vlan 400 name VLAN0400 type ethernet mtu 1500 said 100400 state active
set vlan 500 name VLAN0500 type ethernet mtu 1500 said 100500 state active
set vlan 521 name VLAN0521 type ethernet mtu 1500 said 100521 state active
set vlan 524 name VLAN0524 type ethernet mtu 1500 said 100524 state active
set vlan 570 name VLAN0570 type ethernet mtu 1500 said 100570 state active
set vlan 801 name VLAN0801 type trbrf mtu 4472 said 100801 state active bridge
set vlan 850 name VLAN0850 type ethernet mtu 1500 said 100850 state active
set vlan 917 name VLAN0917 type ethernet mtu 1500 said 100917 state active
set vlan 999 name VLAN0999 type ethernet mtu 1500 said 100999 state active
set vlan 1002 name fddi-default type fddi mtu 1500 said 101002 state active
set vlan 1004 name fddinet-default type fddinet mtu 1500 said 101004 state acti
set vlan 1005 name trbrf-default type trbrf mtu 4472 said 101005 state active b
set vlan 802 name VLAN0802 type trcrf mtu 4472 said 100802 state active parent
set vlan 1003 name trcrf-default type trcrf mtu 4472 said 101003 state active p
set vlan 3 translation 303 translation 0
set vlan 4 translation 304 translation 0
set vlan 5 translation 305 translation 0
set vlan 303 translation 3 translation 0
set vlan 304 translation 4 translation 0
set vlan 305 translation 5 translation 0
set vlan 351 translation 524 translation 0
set vlan 524 translation 351 translation 0
!
#ip
set interface sc0 1 1.10.11.212/255.255.255.0 1.10.11.255

set ip route 0.0.0.0/0.0.0.0 172.20.52.126

set ip route 0.0.0.0/0.0.0.0 172.20.52.125
set ip route 0.0.0.0/0.0.0.0 172.20.52.121
!
#rcp
set rcp username 1
!
#dns
set ip dns server 171.68.10.70 primary
set ip dns server 171.68.10.140
set ip dns enable
set ip dns domain cisco.com
!
#spantree
set spantree fwddelay 4 801
set spantree maxage 10 801
#portfast
set spantree portfast bpdu-guard enable
#vlan 802
set spantree fwddelay 4 802
set spantree maxage 10 802
set spantree portstate 802 block 801

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-425
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show config

#vlan 1003
set spantree fwddelay 4 1003
set spantree maxage 10 1003
set spantree portstate 1003 block 1005
!
#syslog
set logging server 172.20.101.182
!
#set boot command
set boot config-register 0x100
set boot system flash bootflash:cat6000-sup.5-4-0-52.bin
!
#HTTP commands
set ip http server enable
set ip http port 1922
!
# default port status is disable
!
#mls
set mls nde disable
!
#qos
set qos enable
set qos map 1q4t 1 1 cos 2
set qos map 1q4t 1 1 cos 3
set qos map 1q4t 1 1 cos 4
set qos map 1q4t 1 1 cos 5
set qos map 1q4t 1 1 cos 6
set qos map 1q4t 1 1 cos 7
!
#Accounting
set accounting commands enable config stop-only tacacs+
!
# default port status is enable
!
#module 1 : 2-port 1000BaseX Supervisor
!
#module 2 empty
!
#module 3 : 48-port 10/100BaseTX (RJ-45)
set spantree portfast 3/8 enable
!
#module 4 empty
!
#module 5 : 48-port 10/100BaseTX (RJ-45)
!
#module 6 empty
!
set vlan 100 6/1
set spantree portcost 6/1 200
!
#module 7 : 24-port 10/100BaseTX Ethernet
set vlan 5 7/5
set vlan 100 7/23
set vlan 200 7/9
set port disable 7/5

set port name 7/9 1528 Hub

set port security 7/10 enable
set port security 7/10 maximum 200
set port security 7/10 00-11-22-33-44-55
set port security 7/10 00-11-22-33-44-66
set port security 7/10 00-11-22-33-44-77
set port security 7/10 violation restrict

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-426 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show config

set port security 7/10 age 30

set trunk 7/1 desirable isl 1-1005
set trunk 7/2 desirable isl 1-1005
set trunk 7/3 desirable isl 1-1005
set trunk 7/4 desirable isl 1-1005
set trunk 7/10 off negotiate 1-1005
set trunk 7/23 on isl 1-1005
set spantree portcost 7/23 150
set spantree portvlancost 7/23 cost 50 100
!
#module 8 empty
!
#module 9 empty
!
#module 15 empty
!
#module 16 empty
end
Console>

This example shows how to display default and nondefault configuration information:
Console> show config all
begin
!
# ***** ALL (DEFAULT and NON-DEFAULT) CONFIGURATION *****
!
#Current Time: Thu Dec 23 1999, 14:01:24
!
#version 5.4(0.52)
!
set password $1$FMFQ$HfZR5DUszVHIRhrz4h6V70
set enablepass $1$FMFQ$HfZR5DUszVHIRhrz4h6V70
set prompt Console>
set length 24 default
set logout 20
set banner motd ^C^C
!
#system
set system baud 9600
set system modem disable
set system name
set system location
set system contact
!
... <truncated display>
#gvrp
set gvrp dynamic-vlan-creation disable
set gvrp disable
end
console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-427
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show config

This example shows how to display nondefault system configuration information:

Console> show config system
begin
!
# ***** NON-DEFAULT CONFIGURATION *****
!
#Current Time: Thu Dec 23 1999, 14:01:24
!
#version 5.4(0.52)
!
!
#set boot command
set boot config-register 0x2
set boot system flash bootflash:kk1
end
Console>

This example shows how to display all system default and nondefault configuration information:
Console> show config system all
begin
!
#system
set system baud 9600
set system modem disable
set system name
set system location
set system contact
!
end
Console>

This example shows how to display nondefault configuration information for module 1:
Console> show config 1
..............
begin
!
# ***** NON-DEFAULT CONFIGURATION *****
!
!
#Current Time: Thu Dec 23 1999, 14:01:24
!
#version 5.4(0.52)
!
!
#module 1 : 4-port 10/100BaseTX Supervisor
!
end
Console>

This example shows how to display default and nondefault configuration information for module 1:
Console> show config 1 all
begin
!
#module 1 : 4-port 10/100BaseTX Supervisor
set module name 1
set vlan 1 1/1-4
set port channel 1/1-4 off
... <truncated display>
set port flowcontrol 1/1-4 receive on
set cdp enable 1/1-4

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-428 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show config

set trunk 1/1 auto negotiate 1-1005

... <truncated display>
set trunk 1/4 auto negotiate 1-1005
set spantree portfast 1/1-4 disable
... <truncated display>
set spantree portvlancost 1/4 cost 99
set port gvrp 1/1-4 disable
set gvrp registration normal 1/1-4
set gvrp applicant normal 1/1-4
set port gmrp 1/1-4 enable
set gmrp registration normal 1/1-4
set gmrp fwdall disable 1/1-4
!
end
Console>

Related Commands clear config—switch

write

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-429
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show config mode

show config mode

Use the show config mode command to display the system configuration mode currently running on the
switch.

show config mode

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples These examples show how to display the current system configuration mode:
Console> (enable) show config mode
System configuration mode set to text.
System configuration file = bootflash:switch.cfg
Console> (enable)

Console> (enable) show config mode

System configuration mode set to binary.
Console> (enable)

Related Commands set config mode

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-430 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show counters

show counters
Use the show counters command to display hardware counters for a port.

show counters mod/port

Syntax Description mod/port Number of the module and the port.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display hardware counter information for module 2, port 1, a gigabit port:
**GIGABIT PORT
Console> show counters 2/1
0 rxUnicastPacketCount = 0
1 txUnicastPacketCount = 0
2 rxMulticastPacketCount = 0
3 txMulticastPacketCount = 0
4 rxBroadcastPacketCount = 0
5 txBroadcastPacketCount = 0
6 rxByteCount = 0
7 txByteCount = 0
8 pkts64 = 0
9 pkts65to127 = 0
10 pkts128to255 = 0
11 pkts256to511 = 0
12 pkts512to1023 = 0
13 pkts1024to1522 = 0
14 rxNoPacketBufferCount = 0
15 rxCRCAlignErrorPacketCount = 0
16 rxUndersizedPacketCount = 0
17 rxOversizedPacketCount = 0
18 rxFragmentPacketCount = 0
19 rxJabberPacketCount = 0
20 pauseControlFramesRx = 0
21 pauseControlFramesTx = 0
22 unsupportedOpcodesRx = 0
23 txQueueNotAvailable = 0
24 totalCollisionCount = 0
25 lateCollisionCount = 0
26 singleCollisionFrames = 0
27 multipleCollisionFrames = 0
28 excessiveCollisionFrames = 0
29 deferredTransmissions = 0
30 carrierSenseErrors = 0

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-431
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show counters

31 falseCarrierDuringIdle = 0
32 symbolErrorDuringCarrier = 0
33 sequenceErrorDuringCarrier = 0

This example shows how to display hardware counter information for module 3, port 3, a 10/100 port:
**10/100 PORT
Console> show counters 3/3
0 rxUnicastPacketCount = 0
1 txUnicastPacketCount = 0
2 rxMulticastPacketCount = 0
3 txMulticastPacketCount = 0
4 rxBroadcastPacketCount = 0
5 txBroadcastPacketCount = 0
6 rxByteCount = 0
7 txByteCount = 0
8 pkts64 = 0
9 pkts65to127 = 0
10 pkts128to255 = 0
11 pkts256to511 = 0
12 pkts512to1023 = 0
13 pkts1024to1522 = 0
14 rxNoPacketBufferCount = 0
15 rxCRCAlignErrorPacketCount = 0
16 rxUndersizedPacketCount = 0
17 rxOversizedPacketCount = 0
18 rxFragmentPacketCount = 0
19 rxJabberPacketCount = 0
20 pauseControlFramesRx = 0
21 pauseControlFramesTx = 0
22 unsupportedOpcodesRx = 0
23 txQueueNotAvailable = 0
24 totalCollisionCount = 0
25 lateCollisionCount = 0
26 singleCollisionFrames = 0
27 multipleCollisionFrames = 0
28 excessiveCollisionFrames = 0
29 deferredTransmissions = 0
30 carrierSenseErrors = 0
31 falseCarrierDuringIdle = 0
32 symbolErrorDuringCarrier = 0
33 sequenceErrorDuringCarrier = 0

Related Commands clear counters

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-432 78-12648-03
 2
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show crypto key

show crypto key

Use the show crypto key command to display RSA key pair information.

show crypto key

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display key pair information:

Console> (enable) show crypto key
RSA keys was generated at: Tue Dec 14 1999, 14:22:48
1024 37 1120518394839901301166714853840995094745037456682394891249441779951543727187159999
643683033910964386179342272044371326668692894898498425705315929789724607692104535472010393
868648783669579338660482094092720514951237657028608860832162809370173090068651870589350241
85402826063185974102411558894697025607154868421
Console> (enable)

Related Commands clear crypto key rsa

set crypto key rsa

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-433
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show dot1q-all-tagged

show dot1q-all-tagged
Use the show dot1q-all-tagged command to display dot1q tagging status.

show dot1q-all-tagged

Syntax Description This command has no keywords or arguments.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to display dot1q tagging status:

Console> (enable) show dot1q-all-tagged
Dot1q all tagged mode disabled
Console> (enable)

Related Commands set dot1q-all-tagged

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-434 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show dot1x

show dot1x
Use the show dot1x command to display the system dot1x capabilities, protocol version, and timer
values.

show dot1x

Syntax Description This command has no keywords or arguments.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the dot1x information of the system:
Console> show dot1x
PAE Capability Authenticator Only
Protocol Version 1
system-auth-control enabled
re-authentication disabled
max-req 2
quiet-period 60 seconds
re-authperiod 3600 seconds
server-timeout 30 seconds
supp-timeout 30 seconds
tx-period 30 seconds
Console>

Related Commands set dot1x

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-435
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show dvlan statistics

show dvlan statistics

Use the show dvlan statistics command to display DVLAN statistics.

show dvlan statistics

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the DVLAN statistical information:
Console> show dvlan statistics
VMPS Client Statistics
----------------------
VQP Queries: 0
VQP Responses: 0
Vmps Changes: 0
VQP Shutdowns: 0
VQP Denied: 0
VQP Wrong Domain: 0
VQP Wrong Version: 0
VQP Insufficient Resource: 0
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-436 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show environment

show environment
Use the show environment command to display system status information.

show environment {all | power}

Syntax Description all Keyword to display information about the environmental status of the system (for
example, power supply, fan status, and temperature) and about the power
available to the system.
power Keyword to display only information about the inline power status.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to display environmental status information:

Console> show environment all
Total Inline Power Available: 0 Watt
Total Inline Power Drawn From the System: 0 Watt
Remaining Inline Power in the System: 0 Watt
Default Inline Power allocation per port: 6.00 Watts (0.11 Amps @51V)

Module Inline Power Allocated(mA)

------ --------------------------
1 0
2 0
3 0
Console>

This example shows how to display inline power information:

Console> (enable) show environment power
Total Inline Power Available: 0 Watt
Total Inline Power Drawn From the System: 0 Watt
Remaining Inline Power in the System: 0 Watt
Default Inline Power allocation per port: 6.00 Watts (0.11 Amps @51V)

Module Inline Power Allocated(mA)

------ --------------------------
1 0
2 0
3 0

Related Commands set inlinepower defaultallocation

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-437
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show environment power

show environment power

Use the show environment power command to display the current power configuration for the switch,
the total power available to the system, and amount of power currently in use.

show environment power

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the current power configuration for the switch.
Console> show environment power
Power Budget is: 1 power supplies.
Total Power Budget:
Power Available to the system:
Power Drawn from the system:
Remaining Power:
Console>

Related Commands set power budget

show config
show system

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-438 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show errdisable-timeout

show errdisable-timeout
Use the show errdisable-timeout command to display the configuration and status of the errdisable
timeout.

show errdisable-timeout

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If your system is configured with a Supervisor Engine 2, a crossbar-fallback error may be displayed in
the ErrDisable Reason field.

Examples This example shows how to display the errdisable timeout configuration and status:
Console> (enable) show errdisable-timeout
ErrDisable Reason Timeout Status
------------------- ------------
bpdu-guard Enable
channel-misconfig Disable
duplex-mismatch Enable
udld Enable
other Disable

Interval: 300 seconds

Ports that will be enabled at the next timeout:

Port ErrDisable Reason
----- -----------------
3/1 udld
3/8 bpdu-guard
6/5 udld
Console>(enable)

Related Commands set errdisable-timeout

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-439
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show errordetection

show errordetection
Use the show errordetection command to display error detection settings.

show errordetection

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to display the error detection settings:
Console> (enable) show errordetection
Inband error detection: disabled
Memory error detection: enabled
Port counter error detection: disabled
Console> (enable)

Related Commands set errordetection

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-440 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show file

show file
Use the show file command to display the contents of a file.

show file [device:] filename [dump]

Syntax Description device: (Optional) Name of the device. Valid value is bootflash.
filename Name of the file.
dump (Optional) Keyword that specifies to show the hex dump of the file.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines A colon (:) is required after the specified device.

Examples This example shows how to view the file cfg2:

Console> (enable) show file cfg2

begin
!
# ***** NON-DEFAULT CONFIGURATION *****
!
!
# Wed Apr 21 1999, 22:55:10
!
#version 5.3(0.53-Eng)ASP
!
set prompt test>
!
#frame distribution method
set port channel all distribution mac both
!
#ip
set interface sc0 1 172.20.25.145/255.255.0.0 172.20.255.255

set ip route 0.0.0.0/0.0.0.0 172.20.25.201

!
#set boot command
set boot auto-config non-recurring
!
#qos
set qos map 1q4t 0 0 cos 0
set qos map 1q4t 0 0 cos 1
set qos map 1q4t 0 0 cos 2

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-441
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show file

set qos map 1q4t 0 0 cos 4

set qos map 1q4t 0 0 cos 5
set qos map 1q4t 0 0 cos 6
set qos map 1q4t 0 0 cos 7
set qos wred-threshold 1q4t tx queue 1 0 0 0 0
!
#module 1 : 4-port 10/100BaseTX Supervisor
!
#module 2 : 24-port 10BaseF Ethernet
!
#module 3 : 12-port 10/100BaseTX Ethernet
!
#module 4 empty
!
#module 5 empty
end
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-442 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show flash

show flash
Use the show flash command to list Flash information, including file code names, version numbers, and
sizes.

show flash [[m/]device:] [all | chips | filesys]

Syntax Description m/ (Optional) Supervisor Engine III and Catalyst 4000 family and 2948G
switch supervisor engine modules only; module number of the supervisor
engine containing the Flash device.
device: (Optional) Supervisor Engine III only: valid devices are bootflash, slot0,
and slot1; Catalyst 4000 family and 2948G switch supervisor engine
module: valid value is bootflash.
all (Optional) Supervisor Engine III and Catalyst 4000 family and 2948G
switch supervisor engine module only: keyword that specifies to list deleted
files, undeleted files, and files with errors on a Flash memory device.
chips (Optional) Supervisor Engine III and Catalyst 4000 family and 2948G
switch supervisor engine modules only: keyword that specifies to show
information about the Flash chip.
filesys (Optional) Supervisor Engine III and Catalyst 4000 family and 2948G
switch supervisor engine modules only: keyword that specifies to show the
Device Info Block, the Status Info, and the Usage Info.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines A colon (:) is required after the specified device.

Examples The following examples show how to list Flash information:

Console> show flash
-#- ED --type-- --crc--- -seek-- nlen -length- -----date/time------ name
1 .D 2 2D6B310A 100fc0 15 1052123 Aug 26 1998 15:43:50 cat5k_r47_1.cbi
2 .. 2 43B312DF 201ed8 15 1052608 Aug 27 1998 10:23:30 cat5k_r47_1.cbi

6283877 bytes available (2104731 bytes used)

Console> show flash chips

******** Intel Series 2+ Status/Register Dump ********

ATTRIBUTE MEMORY REGISTERS:

Config Option Reg (4000): 2

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-443
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show flash

Config Status Reg (4002): 0

Card Status Reg (4100): 1
Write Protect Reg (4104): 4
Voltage Cntrl Reg (410C): 0
Rdy/Busy Mode Reg (4140): 2

COMMON MEMORY REGISTERS: Bank 0

Intelligent ID Code : 8989A0A0
Compatible Status Reg: 8080
Global Status Reg: B0B0
Block Status Regs:
0 : B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0
8 : B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0
16 : B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0
24 : B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0

COMMON MEMORY REGISTERS: Bank 1

Intelligent ID Code : 8989A0A0
Compatible Status Reg: 8080
Global Status Reg: B0B0
Block Status Regs:
0 : B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0
8 : B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0
16 : B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0
24 : B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0

COMMON MEMORY REGISTERS: Bank 2

Intelligent ID Code : FF00FF
IID Not Intel -- assuming bank not populated
COMMON MEMORY REGISTERS: Bank 3
Intelligent ID Code : FF00FF
IID Not Intel -- assuming bank not populated

COMMON MEMORY REGISTERS: Bank 4

Intelligent ID Code : FF00FF
IID Not Intel -- assuming bank not populated

Console> show flash filesys

-------- F I L E S Y S T E M S T A T U S --------
Device Number = 0
DEVICE INFO BLOCK:
Magic Number = 6887635 File System Vers = 10000 (1.0)
Length = 800000 Sector Size = 20000
Programming Algorithm = 4 Erased State = FFFFFFFF
File System Offset = 20000 Length = 7A0000
MONLIB Offset = 100 Length = C730
Bad Sector Map Offset = 1FFF8 Length = 8
Squeeze Log Offset = 7C0000 Length = 20000
Squeeze Buffer Offset = 7E0000 Length = 20000
Num Spare Sectors = 0
Spares:
STATUS INFO:
Writable
NO File Open for Write
Complete Stats
No Unrecovered Errors
USAGE INFO:
Bytes Used = 201D9B Bytes Available = 5FE265
Bad Sectors = 0 Spared Sectors = 0
OK Files = 1 Bytes = 100FC0
Deleted Files = 1 Bytes = 100DDB
Files w/Errors = 0 Bytes = 0

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-444 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show flash

Console> show flash all

-#- ED --type-- --crc--- -seek-- nlen -length- -----date/time------ name
1 .D 2 2D6B310A 100fc0 15 1052123 Aug 26 1998 15:43:50 cat5k_r47_1.cbi
2 .. 2 43B312DF 201ed8 15 1052608 Aug 27 1998 10:23:30 cat5k_r47_1.cbi

6283877 bytes available (2104731 bytes used)

-------- F I L E S Y S T E M S T A T U S --------
Device Number = 0
DEVICE INFO BLOCK:
Magic Number = 6887635 File System Vers = 10000 (1.0)
Length = 800000 Sector Size = 20000
Programming Algorithm = 4 Erased State = FFFFFFFF
File System Offset = 20000 Length = 7A0000
MONLIB Offset = 100 Length = C730
Bad Sector Map Offset = 1FFF8 Length = 8
Squeeze Log Offset = 7C0000 Length = 20000
Squeeze Buffer Offset = 7E0000 Length = 20000
Num Spare Sectors = 0
Spares:
STATUS INFO:
Writable
NO File Open for Write
Complete Stats
No Unrecovered Errors
USAGE INFO:
Bytes Used = 201D9B Bytes Available = 5FE265
Bad Sectors = 0 Spared Sectors = 0
OK Files = 1 Bytes = 100FC0
Deleted Files = 1 Bytes = 100DDB
Files w/Errors = 0 Bytes = 0

******** Intel Series 2+ Status/Register Dump ********

ATTRIBUTE MEMORY REGISTERS:

Config Option Reg (4000): 2
Config Status Reg (4002): 0
Card Status Reg (4100): 1
Write Protect Reg (4104): 4
Voltage Cntrl Reg (410C): 0
Rdy/Busy Mode Reg (4140): 2

COMMON MEMORY REGISTERS: Bank 0

Intelligent ID Code : 8989A0A0
Compatible Status Reg: 8080
Global Status Reg: B0B0
Block Status Regs:
0 : B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0
8 : B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0
16 : B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0
24 : B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0

COMMON MEMORY REGISTERS: Bank 1

Intelligent ID Code : 8989A0A0
Compatible Status Reg: 8080
Global Status Reg: B0B0
Block Status Regs:
0 : B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0
8 : B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0
16 : B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0
24 : B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0 B0B0

COMMON MEMORY REGISTERS: Bank 2

Intelligent ID Code : FF00FF

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-445
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show flash

IID Not Intel -- assuming bank not populated

COMMON MEMORY REGISTERS: Bank 3

Intelligent ID Code : FF00FF
IID Not Intel -- assuming bank not populated

COMMON MEMORY REGISTERS: Bank 4

Intelligent ID Code : FF00FF
IID Not Intel -- assuming bank not populated

Related Commands reset—switch

show version—switch

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-446 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show garp timer

show garp timer

Use the show garp timer command to display all the values of the GARP timers.

show garp timer

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines You must maintain the following relationship for the various timer values:
• Leave time must be greater than or equal to three times the join time.
• Leaveall time must be greater than the leave time.

Caution Set the same GARP application (for example, GMRP and GVRP) timer values on all
Layer 2-connected devices. If the GARP timers are set differently on such devices, GARP
applications will not operate successfully.

Note The modified timer values are applied to all GARP application (for example, GMRP and GVRP)
timer values.

Examples This example shows how to display all the values of the GARP timers:
Console> (enable) show garp timer
Timer Timer Value (milliseconds)
-------- --------------------------
Join 200
Leave 600
LeaveAll 10000
Console> (enable)

Related Commands set garp timer

set gmrp timer
set gvrp timer

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-447
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show gmrp configuration

show gmrp configuration

Use the show gmrp configuration command to display complete GMRP-related configuration
information.

show gmrp configuration

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If the port list exceeds the line spaces available, the list wraps to the next line.

Examples This example shows the display when GMRP is enabled:

Console> (enable) show gmrp configuration
Global GMRP Configuration:
GMRP Feature is currently enabled on this switch.
GMRP Timers (milliseconds):
Join = 200
Leave = 600
LeaveAll = 10000
Port based GMRP Configuration:
GMRP Status Registration Forward All Port
--------------------------------------------------------------------
Enabled Fixed Disabled 2/1,3/1-2
Console> (enable)

Related Commands set gmrp registration

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-448 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show gmrp statistics

show gmrp statistics

Use the show gmrp statistics command to display GMRP-related statistics for a specified VLAN.

show gmrp statistics [vlan]

Syntax Description vlan (Optional) VLAN for which to show GMRP statistics.

Defaults If no VLAN is specified, the default is that statistics for VLAN 1 are shown.

Command Types Switch command.

Command Modes Normal.

Examples This example shows the display for all the GMRP-related statistics for VLAN 23:
Console> show gmrp statistics 23
GMRP Statistics for vlan <23>:
Total valid GMRP Packets Received: 500
Join Emptys: 200
Join INs: 250
Leaves: 10
Leave Alls: 35
Emptys: 5
Fwd Alls: 0
Fwd Unregistered: 0
Total valid GMRP Packets Transmitted: 600
Join Emptys: 200
Join INs: 150
Leaves: 45
Leave Alls: 200
Emptys: 5
Fwd Alls: 0
Fwd Unregistered: 0
Total valid GMRP Packets Received: 0
Total GMRP packets dropped: 0
Total GMRP Registrations Failed: 0
Console>

Related Commands clear gmrp statistics

set gmrp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-449
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show gmrp timer

show gmrp timer

Use the show gmrp timer command to display all the GMRP timers values.

show gmrp timer

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines You can enter the show multicast group command to display GMRP configuration values.

Examples This example shows how to display all the GMRP timer values:
Console> (enable) show gmrp timer
Timer Timer Value(milliseconds)
---------------------------------------------
Join 200
Leave 600
Leave All 10000
Console> (enable)

Related Commands set garp timer

set gmrp timer
set gvrp timer
show multicast group

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-450 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show gvrp configuration

show gvrp configuration

Use the show gvrp configuration command to display GARP VLAN Registration Protocol (GVRP)
configuration information, including timer values, whether GVRP and dynamic VLAN creation are
enabled, and which ports are running GVRP.

show gvrp configuration

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If the port list exceeds the available line spaces, the list wraps to the next line.
If no ports are GVRP participants, the message output changes from “GVRP Participants running on
port_list” to “GVRP Participants running on no ports.”

Examples This example shows how to view GVRP configuration information:

Console> show gvrp configuration

Global GVRP Configuration:

GVRP Feature is currently enabled on the switch.
GVRP dynamic VLAN creation is enabled.
GVRP Timers(milliseconds)
Join = 200
Leave = 600
LeaveAll = 10000

Port based GVRP Configuration:

GVRP Status Registration Port
-------------- --------------- -------------------------------------------------------
Enabled Normal 2/1-2,3/1-8,7/1-24,8/1-24
GVRP Participants running on 3/7-8.
Console>

Related Commands clear gvrp statistics

set gvrp
set gvrp dynamic-vlan-creation
set gvrp registration
set gvrp timer
show gvrp statistics

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-451
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show gvrp statistics

show gvrp statistics

Use the show gvrp statistics command to view GARP VLAN Registration Protocol (GVRP) statistics
for a port.

show gvrp statistics [mod/port]

Syntax Description mod/port (Optional) Number of the module and port.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to view GVRP statistics for module 2, port 1:
Console> show gvrp statistics 2/1
GVRP enabled

GVRP statistics for port 2/1:

Total valid pkts rcvd: 18951
Total invalid pkts recvd 0
General Queries recvd 377
Group Specific Queries recvd 0
MAC-Based General Queries recvd 0
Leaves recvd 14
Reports recvd 16741
Queries Xmitted 0
GS Queries Xmitted 16
Reports Xmitted 0
Leaves Xmitted 0
Failures to add GDA to EARL 0
Topology Notifications rcvd 10
GVRP packets dropped 0
Console>

Table 2-20 describes the fields in the show gvrp statistics output.

Table 2-20 show gvrp statistics Command Output Fields

Field Description
GVRP enabled Status of whether GVRP is enabled or disabled
Total valid pkts recvd Total number of valid GVRP packets received
Total invalid pkts recvd Total number of invalid GVRP packets received
General Queries recvd Total number of GVRP general queries received

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-452 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show gvrp statistics

Table 2-20 show gvrp statistics Command Output Fields (continued)

Field Description
Group Specific Queries Total number of GVRP group-specific queries received
recvd
MAC-Based General Total number of MAC-based general queries received
Queries recvd
Leaves recvd Total number of GVRP leaves received
Reports recvd Total number of GVRP reports received
Queries Xmitted Total number of GVRP general queries transmitted by the switch
GS Queries Xmitted Total number of GVRP group specific-equivalent queries
transmitted by the switch
Reports Xmitted Total number of GVRP reports transmitted by the switch
Leaves Xmitted Total number of GVRP leaves transmitted by the switch
Failures to add GDA to Total number of times the switch failed to add a multicast entry
EARL (GDA) to the EARL table
Topology Notifications Total number of topology change notifications received by the
rcvd switch
GVRP packets dropped Total number of GVRP packets dropped by the switch

Related Commands clear gvrp statistics

set gvrp
set gvrp dynamic-vlan-creation
set gvrp registration
set gvrp timer
show gvrp configuration

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-453
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show imagemib

show imagemib
Use the show imagemib command to display image information provided in the CISCO-IMAGE-MIB
for a particular image.

show imagemib filename

Syntax Description filename Name of the Flash device.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display CISCO-IMAGE-MIB information for the Flash device on the
supervisor engine module:
Console> show imagemib cat4000.4-4-0-14.bin
show mib info for file cat4000.4-4-0-14.bin
show_presto_nmp_image_header : open file cat4000.4-4-0-14.bin error code = -3, )
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-454 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show interface—ROM monitor

show interface—ROM monitor

Use the show interface command to display information about network interfaces.

show interface

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Examples This example shows how to display information on all network interfaces:
rommon 1 > show interface
me1: inet 172.20.52.37 netmask 255.255.255.248 broadcast 172.20.52.39
rommon 2 >

Related Commands set interface

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-455
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show interface—switch

show interface—switch
Use the show interface command to display information about network interfaces and standard SNMP
link trap operation.

show interface

show interface trap

Syntax Description trap Keyword that specifies to display the trap interface.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display information on all network interfaces:
Console> show interface
sl0: flags=50<DOWN,POINTOPOINT,RUNNING>
slip 0.0.0.0 dest 0.0.0.0
sc0: flags=63<UP,BROADCAST,RUNNING>
vlan 100 inet 172.20.52.37 netmask 255.255.255.248 broadcast 172.20.52.39
me1: flags=62<DOWN,BROADCAST,RUNNING>
inet 172.20.52.37 netmask 255.255.255.224 broadcast 172.20.52.63
Console>

This example shows how to display whether the trap interface is enabled or disabled:
Console> (enable) show interface trap
Interface Trap
-------- ----
sc0 enabled
me1 disabled
sl0 disabled
Console> (enable)

Table 2-21 describes the fields in the show interface command output.

Table 2-21 show interface Command Output Fields

Field Description
me1 Information on the me1 interface
flags Flags indicating the interface state (decoded in the subsequent
field).
<UP,BROADCAST, Interface state (UP, DOWN, BROADCAST, LOOPBACK,
RUNNING> POINTOPOINT, or RUNNING)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-456 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show interface—switch

Table 2-21 show interface Command Output Fields (continued)

Field Description
inet IP address of the interface
netmask Network mask for the interface
broadcast Broadcast address for the interface
sl0 Information on the SLIP interface
<UP,POINTOPOINT, Interface state (UP, DOWN, BROADCAST, LOOPBACK,
RUNNING> POINTOPOINT, or RUNNING)
slip IP address of the SLIP interface
dest IP address of the host to which the console port will be connected
sc0 Information on the in-band interface
vlan Number of the VLAN to which the sc0 interface has been assigned
(known as the management VLAN)
Interface Type of interface
Trap Status of whether the trap is enabled or disabled

Related Commands set interface

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-457
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show ip alias

show ip alias
Use the show ip alias command to show a listing of defined IP aliases.

show ip alias [name]

Syntax Description name (Optional) Alias for a specific host.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display a listing of all IP aliases:

Console> show ip alias
default 0.0.0.0
sparc20 192.168.10.69
cat5500-1 172.16.169.16
cat5500-2 172.16.169.20
Console>

Related Commands clear ip alias

set ip alias

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-458 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show ip dns

show ip dns
Use the show ip dns command to show the DNS name servers and the default DNS domain name.

show ip dns

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the DNS name servers and the default DNS domain name:
Console> show ip dns
DNS is currently enabled.
The default DNS domain name is: cisco.com

DNS name server status

--------------- -------
172.16.30.32
192.168.2.132 primary
172.31.128.70
Console>

Table 2-22 describes the fields in the show ip dns command output.

Table 2-22 show ip dns Command Output Fields

Field Description
DNS is currently Status of whether DNS is enabled or disabled.
enabled
default DNS domain Default DNS domain name.
name
DNS name server IP addresses or IP aliases of the configured DNS servers.
status Primary DNS server.

Related Commands clear ip dns domain

clear ip dns server
set ip dns
set ip dns domain
set ip dns server

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-459
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show ip http

show ip http
Use the show ip http command to view the HTTP configuration and switch web interface information.

show ip http

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the HTTP configuration and web interface information if the web
interface is supported:
Console> show ip http
HTTP Configuration Information:
----------------
HTTP Server: enabled
HTTP port: 80
Web Interface: Supported

Switch Information:
------------------
File: applet.html
size: 912 bytes
version: 5.0(0.26)
date: 10/9/99
File: cvembopt.jar
size: 3500000 bytes
version: 5.0(0.26)
date: 10/9/99

Active Web Interface Session: 1

-----------------------------
Client IP Address: 192.20.20.45
Request Type: GET
Request URI: /all-engine.jar
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-460 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show ip http

This example shows the HTTP configuration and web interface information if the web interface is not
supported:
Console> show ip http
HTTP Configuration Information:
----------------
HTTP Server: disabled
HTTP port: 80
Web Interface: Not Supported
Console>

Related Commands set ip http port

set ip http server

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-461
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show ip permit

show ip permit
Use the show ip permit command to display the IP permit list information.

show ip permit [noalias]

Syntax Description noalias (Optional) Keyword that specifies to force the display to show IP
addresses, not IP aliases.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display IP permit list information:

Console> (enable) show ip permit
Telnet permit list feature enabled.
Snmp permit list feature disabled.

Permit List Mask Access-Type

---------------- --------------- ---------------
172.16.0.0 255.255.0.0 telnet
172.20.52.3 snmp telnet
172.20.52.32 255.255.255.224 ssh

Denied IP Address Last Accessed Time Type Telnet Count SNMP Count
----------------- ------------------ ------ ------------ ----------
172.100.101.104 01/20/97,07:45:20 SNMP 14 1430
172.187.206.222 01/21/97,14:23:05 Telnet 7 236

Console> (enable)

Table 2-23 describes the fields in the show ip permit command output.

Table 2-23 show ip permit Command Output Fields

Field Description
Permit List IP addresses and IP aliases that are allowed to access the switch
Mask Subnet masks of permitted IP addresses
Denied IP Address IP addresses and IP aliases that are not allowed to access the switch
Access-Type The type of access the IP address has: telnet, snmp, ssh, or a
combination of these.
Last Accessed Time Date and time of the last attempt to log in to the switch from the
address

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-462 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show ip permit

Table 2-23 show ip permit Command Output Fields (continued)

Field Description
Type Login-attempt type
Telent Count The number of times the IP address attempted a Telnet access
SNMP Count The number of times the IP address attempted an SNMP access

Related Commands clear ip permit

set ip permit
set snmp trap

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-463
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show ip route—ROM monitor

show ip route—ROM monitor

Use the show ip route command to display IP routing table entries.

show ip route

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Examples This example shows how to display IP routing table entries:

rommon 3 > show ip route
Destination Gateway Interface
----------------------- ----------------------- ---------
default 172.20.52.33 me1
rommon 4 >

Related Commands clear ip route—ROM monitor

set ip route—ROM monitor

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-464 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show ip route—switch

show ip route—switch
Use the show ip route command to display IP routing table entries.

show ip route [noalias]

Syntax Description noalias (Optional) Keyword that specifies to force the display to show IP
addresses, not IP aliases.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the IP route table:

Console> (enable) show ip route
Fragmentation Redirect Unreachable
------------- -------- -----------
enabled enabled enabled

Destination Gateway RouteMask Flags Use Interface

--------------- --------------- ---------- ----- -------- ---------
default 172.20.52.1 0x0 UG 73439 sc0
172.20.52.0 172.20.52.5 0xffffffe0 U 4 sc0
default default 0xff000000 UH 0 sl0
Console> (enable)

Table 2-24 describes the fields in the show ip route command output.

Table 2-24 show ip route Command Output Fields

Field Description
Fragmentation Current setting of IP fragmentation
Redirect Current setting of ICMP redirect
Unreachable Current setting of ICMP unreachable messages
Destination Destination address IP route mask
Gateway IP address or IP alias of the gateway router
RouteMask Path that is closer to the destination
Flags Route status; possible values are U=up, G=route to a Gateway, H=route to
a Host, and D=Dynamically created by a redirect
Use Number of times a route entry was used to route packets
Interface Type of interface

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-465
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show ip route—switch

Related Commands clear ip route—switch

set ip route—switch

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-466 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show kerberos

show kerberos
Use the show kerberos command to display information about a Kerberos configuration.

show kerberos

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display Kerberos configuration information:

kerberos> (enable) show kerberos
Kerberos Local Realm:CISCO.COM
Kerberos server entries:
Realm:CISCO.COM, Server:187.0.2.1, Port:750

Kerberos Domain<->Realm entries:

Domain:cisco.com, Realm:CISCO.COM

Kerberos Clients NOT Mandatory

Kerberos Credentials Forwarding Enabled
Kerberos Pre Authentication Method set to None
Kerberos config key:
Kerberos SRVTAB Entries
Srvtab Entry 1:host/[email protected] 0 932423923 1 1 8 01;;8>00>50;0=0=0
kerberos> (enable)

Table 2-25 describes the fields in the show kerberos command output.

Table 2-25 show kerberos Command Output Fields

Field Description
Kerberos Local Realm Shows whether local realm is configured
Kerberos server entries Shows servers entered into the switch
Kerberos Pre Authentication Shows whether preauthentication is enabled or disabled
Method
Kerberos config key Shows whether a DES key has been configured
Kerberos SRVTAB entries Shows the SRVTAB entries

Related Commands show kerberos creds

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-467
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show kerberos creds

show kerberos creds

Use the show kerberos creds command to display the Kerberos credentials on a switch.

show kerberos creds

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display Kerberos credentials information:

Console> (enable) show kerberos creds
No Kerberos credentials.
Console> (enable)

Related Commands show kerberos

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-468 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show log

show log
Use the show log command set to display the error log for a system or for a specific module.

show log [mod]

show log dump [-count]

Syntax Description mod (Optional) Number of the module for which the log is displayed.
dump Keyword to display dump log information.
-count (Optional) Number of dump log entries to display.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines To display the contents of ASIC error messages as soon as they are received from SLCP/LCP, see the set
logging server command.
You can use the dump keyword to display log dump information generated when certain events occur,
such as memory corruption.

Examples This example shows how to display the error log for the system:
Console> show log
Network Management Processor (ACTIVE NMP) Log:
Reset count: 26
Re-boot History: Jan 05 2001 14:27:13 0, Jan 05 2001 14:20:50 0
Dec 27 2000 10:18:30 0, Nov 22 2000 15:03:15 0
Nov 21 2000 14:52:26 0, Nov 13 2000 09:13:20 0
Bootrom Checksum Failures: 0 UART Failures: 0
Flash Checksum Failures: 0 Flash Program Failures: 0
Power Supply 1 Failures: 0 Power Supply 2 Failures: 2
DRAM Failures: 0

Exceptions: 0

Loaded NMP version: 6.2(1)

Reload same NMP version count: 0

Last software reset by user: 1/5/2001,14:26:35

MCP Exceptions/Hang: 0
Heap Memory Log:
Corrupted Block = none

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-469
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show log

NVRAM log:
01. 7/26/1999,15:57:51: convertCiscoMIB:PreSac(0) checksum failed: 0x0(0x4C5C)
02. 12/27/2000,10:18:30: convert_post_SAC_CiscoMIB:Block 0 converted from versio
n 13 to 14
03. 12/27/2000,10:18:33: supVersion:Nmp version 6.2(0.57)KEY
04. 1/5/2001,14:27:17: supVersion:Nmp version 6.2(1)

Module 2 Log:
Reset Count: 12
Reset History: Fri Jan 5 2001, 14:27:23
Fri Jan 5 2001, 14:21:00
Wed Dec 27 2000, 10:18:40
Wed Nov 22 2000, 15:03:25

Module 3 Log:
Reset Count: 12
Reset History: Fri Jan 5 2001, 14:27:24
Fri Jan 5 2001, 14:21:01
Wed Dec 27 2000, 10:18:40
Wed Nov 22 2000, 15:03:25

NOTE: Use "show crashdump 1" to see the crashdump.

Console>

Table 2-26 describes the fields in the show log command output.

Table 2-26 show log Command Output Fields

Field Description
Network Management Log that applies to the NMP on the supervisor engine module
Processor (ACTIVE NMP) Log
Reset count Number of times that the system has reset
Re-boot History Date and times that the system has rebooted
Bootrom Checksum Failures Number of bootrom checksum failures
UART Failures Number of times that the UART has failed
Flash Checksum Failures Number of times that the Flash Checksum has failed
Flash Program Failures Number of times that the Flash Program has failed
Power Supply 1 Failures Number of times that Power Supply 1 has failed
Power Supply 2 Failures Number of times that Power Supply 2 has failed
DRAM Failures Number of times that the DRAM has failed
Exceptions: Exceptions log
Loaded NMP version Supervisor Engine software version loaded on the switch.
Reload same NMP version Number of times the current Supervisor Engine software has been
count loaded on the switch
NVRAM log Number of times that NVRAM errors have occurred
Reset History Date and times that the system has reset

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-470 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show log

This example shows how to display dump log information:

Console> show log dump
Total logs: 1
Console>

Related Commands clear log

set logging server

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-471
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show log command

show log command

Use the show log command to display command log entries.

show log command [mod]

Syntax Description mod (Optional) Number of the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The command log entry table is a history log of the commands to the switch from the console or from
Telnet.

Examples This example shows how to display the command log for module 1:
Console> (enable) show log command 1
Active Command log:

001. Oct 04 09:44:35 Pid = 86 show mod

002. Oct 04 09:44:55 Pid = 86 clear log command 3
003. Oct 04 10:09:07 Pid = 86 show port membership
004. Oct 04 10:10:15 Pid = 86 enable
005. Oct 04 10:10:19 Pid = 86 clear port help
006. Oct 04 10:10:47 Pid = 86 clear spantree help
007. Oct 04 10:12:42 Pid = 86 show
008. Oct 04 10:12:57 Pid = 86 show qos help
009. Oct 04 10:14:46 Pid = 86 show log 5
010. Oct 04 10:14:53 Pid = 86 show log 1
011. Oct 04 10:15:04 Pid = 86 show log command 5
012. Oct 04 10:15:08 Pid = 86 show log command 1

Console> (enable)

Related Commands clear log command

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-472 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show logging

show logging
Use the show logging command to display the system message log configuration.

show logging [noalias]

Syntax Description noalias (Optional) Keyword that specifies to display syslog servers in IP
dotted format.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows the default system message log configuration:
Console <enable> show logging

Logging buffer size: 500

timestamp option: enabled
Logging history size: 1
Logging console: enabled
Logging telnet: disabled
Logging server: disabled
server facility: LOCAL7
server severity: warnings(4)

Facility Default Severity Current Session Severity

------------- ----------------------- ------------------------
cdp 4 4
drip 2 2
dtp 5 5
dvlan 2 2
earl 2 2
fddi 2 2
filesys 2 2
gvrp 2 2
ip 2 2
kernel 2 2
mcast 2 2
mgmt 5 5
mls 5 5
pagp 5 5
protfilt 2 2
pruning 2 2
radius 2 2
security 2 2
snmp 2 2
spantree 2 2

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-473
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show logging

sys 5 5
tac 2 2
tcp 2 2
telnet 2 2
tftp 2 2
udld 4 4
vmps 2 2
vtp 2 2

0(emergencies) 1(alerts) 2(critical)

3(errors) 4(warnings) 5(notifications)
6(information) 7(debugging)
Console>

Table 2-27 describes the fields in the show logging command output.

Table 2-27 show logging Command Output Fields

Field Description
Logging buffer size Capacity of the logging buffer
Logging history size Capacity of the logging history
Logging console Status of whether logging to the console is enabled or disabled
Logging telnet Status of whether logging to telnet is enabled or disabled
Logging server Status of whether logging to the logging server is enabled or
disabled
Current Logging Session Status of whether system logging messages are sent to the current
login session
Facility Name of the facility to be logged
Server/Default Severity Default severity level at which point an error from that facility is
logged
Current Session Severity Severity level at which point an error from that facility is logged
during the current session
0 (emergencies), 1 Key to the numeric severity level codes
(alerts)...

Related Commands clear logging server

set logging buffer
set logging level
set logging server
set logging session
show logging buffer

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-474 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show logging buffer

show logging buffer

Use the show logging buffer command to display system messages from the internal buffer.

show logging buffer [-] [number_of_messages]

Syntax Description - (Optional) Keyword that causes the system to display system
messages starting from the end of the buffer.
number_of_messages (Optional) Number of system messages to be displayed. Valid
values are 1 to 1023.

Defaults By default, the setting is -20, which displays the last 20 messages in the buffer.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If the - keyword is not used, system messages are displayed from the beginning of the buffer. If
number_of_messages is not specified, the last 20 messages in the buffer are displayed.
If the logging timestamp option is enabled, a timestamp is also included in the display. Use the set
logging timestamp command to enable the timestamp option.
If the logging timestamp option is enabled, the +00:00 or -00:00 in the output indicates the hours and
minutes offset from UTC.

Examples This example shows how to display all the system messages from the internal buffer; this example
displays the output with the timestamp option enabled:
Console <enable> show logging buffer
1999 Mar 09 19:33:05 +00:00%SYS-5:Module 1 is online
1999 Mar 09 19:33:05 +00:00%SYS-5:Module 5 is online
1999 Mar 09 19:33:05 +00:00%SYS-5:Module 3 failed configuration
1999 Mar 09 19:33:05 +00:00%SYS-5:Module 3 failed configuration
1999 Mar 09 19:33:05 +00:00%SYS-5:Module 4 is online
1999 Mar 09 19:33:05 +00:00%SNMP-6:Subagent 2 connected
1999 Mar 09 19:33:05 +00:00%SNMP-5:Cold Start Trap
Console <enable>

This example shows how to display the first four system messages from the internal buffer; this example
displays the output with the timestamp option disabled:
Console <enable> show logging buffer 4
%SYS-5:Module 1 is online
%SYS-5:Module 5 is online
%SYS-5:Module 3 failed configuration
Console <enable>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-475
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show logging buffer

This example shows how to display the last four system messages from the internal buffer; this example
displays the output with the timestamp option enabled:
Console <enable> show logging buffer -4
1999 Mar 09 19:33:05 +00:00%SYS-5:Module 3 failed configuration
1999 Mar 09 19:33:05 +00:00%SYS-5:Module 4 is online
1999 Mar 09 19:33:05 +00:00%SNMP-6:Subagent 2 connected
1999 Mar 09 19:33:05 +00:00%SNMP-5:Cold Start Trap
Console <enable>

Related Commands set logging buffer

set logging timestamp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-476 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show mac

show mac
Use the show mac command to display MAC counters.

show mac [mod_num[/port_num]]

Syntax Description mod_num (Optional) Number of the module.

/port_num (Optional) Number of the port on the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If you do not specify a module number, all modules are shown.
If you do not specify a port number, all ports are shown.

Examples This example shows how to display MAC information for port 4 on module 3:
Console> show mac 3/4
MAC Rcv-Frms Xmit-Frms Rcv-Multi Xmit-Multi Rcv-Broad Xmit-Broad
-------- ---------- ---------- ---------- ---------- ---------- ----------
3/4 0 0 0 0 0 0

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

-------- ---------- ---------- ---------- ---------- ---------- ----------
3/4 0 0 0 0 0 0

MAC SMT-Address Curr-Path TReq TNeg TMax TVX

------- ----------------- ---------- -------- -------- -------- --------
3/4 00:06:7c:b3:bc:98 primary 165000 165000 165004 2509
00-60-3e-cd-3d-19

MAC Upstream-Nbr Downstream-Nbr Old-Upstrm-Nbr Old-Downstrm-Nbr

------- ----------------- ----------------- ----------------- -----------------
3/4 00:00:1f:00:00:00 00:00:1f:00:00:00 00:00:1f:00:00:00 00:00:1f:00:00:00
00-00-f8-00-00-00 00-00-f8-00-00-00 00-00-f8-00-00-00 00-00-f8-00-00-00

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

------- ---------- ---------- ---------- ---------- ---------- ----------
3/4 0 0 1 61 0 1

Port Rcv-Unicast Rcv-Multicast Rcv-Broadcast

-------- -------------------- -------------------- --------------------
3/4 0 0 0

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-477
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show mac

Port Xmit-Unicast Xmit-Multicast Xmit-Broadcast

-------- -------------------- -------------------- --------------------
3/4 0 0 0

Port Rcv-Octet Xmit-Octet

-------- -------------------- --------------------
3/4 0 0

Last-Time-Cleared
--------------------------
Tue Apr 13 1999, 08:31:20
Console>

Table 2-28 describes possible fields displayed in the show mac command output.

Table 2-28 show mac Command Output Fields

Field Description
MAC Module and port
Rcv-Frms Frames received on the port
Xmit-Frms Frames transmitted on the port
Rcv-Multi Multicast frames received on the port
Xmit-Multi Multicast frames transmitted on the port
Rcv-Broad Broadcast frames received on the port
Xmit-Broad Broadcast frames transmitted on the port
Dely-Exced Total transmit frames aborted due to excessive deferral
MTU-Exced Frames for which the MTU size was exceeded
In-Discard Incoming frames that were discarded because the frame did not
need to be switched
Lrn-Discard CAM entries discarded due to page full in EARL
In-Lost Sum of error packets that were received on the port. This is
different from the Catalyst 5000 series switches because the
architecture is different.

Note In-Lost is the sum of

rxCRCAlignErrorPacketCount,
rxUndersizedPacketCount,
rxOversizedPacketCount,
rxFragmentPacketCount, and
rxJabberPacketCount.

Out-Lost Outgoing frames that were lost before being forwarded (due to
insufficient buffer space)
SMT-Address SMT address of the FDDI port
Curr-Path Current path used (primary or secondary)
TReq Token rotation time request value

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-478 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show mac

Table 2-28 show mac Command Output Fields (continued)

Field Description
TNeg Negotiated token rotation time value
TMax Maximum token rotation time value
TVX Value of the valid transmission timer
Upstream-Nbr MAC address of the current upstream neighbor
Downstream-Nbr MAC address of the current downstream neighbor
Old-Upstrm-Nbr MAC address of the previous upstream neighbor
Old-Downstrm-Nbr MAC address of the previous downstream neighbor
Rcv-Smt Number of SMT frames received by the port
Xmit-Smt Number of NSMT frames transmitted by the port
Rcv-llc Number of NLLC frames received by the port
Xmit-llc Number of LLC frames transmitted by the port
Tvx-Exp-Ct Number of times the TVX timer expired
RingOp-Ct Number of times the ring became operational
Rcv-Unicast Number of unicast frames received on the port
Rcv-Multicast Number of multicast frames received on the port
Rcv-Broadcast Number of broadcast frames received on the port
Xmit-Unicast Number of unicast frames transmitted on the port
Xmit-Multicast Number of multicast frames transmitted on the port
Xmit-Broadcast Number of broadcast frames transmitted on the port
Rcv-Octet Number of octet frames received on the port
Xmit-Octet Number of octet frames transmitted on the port
Last-Time-Cleared Date and time of the last clear counters command

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-479
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show module

show module
Use the show module command to display module status and information.

show module [mod_num]

Syntax Description mod_num (Optional) Number of the module. If a number is not specified, all modules are
shown.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If you remove a module and replace it with a different type module, a message appears in the show
module display that states that the module configuration is inconsistent with the current module type.
To clear the message, you can either enter the clear config mod_num command for the module or set
different parameters for the new module.
For Catalyst 4000 family switches, the show module command displays the supervisor engine as having
“1” slot.
For Catalyst 4000 family switches, in the show module command display, the combination of the
32-port module (WS-X4502) and 4-port 100FX daughtercard results in an entry that reads 36 ports. If
the uplink card is not installed, only ports 1 to 32 are listed.
Although me1 resides on the supervisor engine module for the Catalyst 4000 family switches, me1 port
information is not displayed by the show module or show port commands.

Examples This example shows how to display status and information for module 3:
Console> show module 3
Mod Slot Ports Module-Type Model Sub Status
--- ---- ----- ------------------------- ------------------- --- --------
3 3 9 Gigabit Ethernet WS-X5410 no ok

Mod Module-Name Serial-Num

--- ------------------- --------------------
3 00007285650

Mod MAC-Address(es) Hw Fw Sw
--- -------------------------------------- ------ ---------- -----------------
3 00-e0-1e-38-48-cc to 00-e0-1e-38-48-d7 0.2 4.1(0.53-E 5.1(0.59))

Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-480 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show module

This example shows how to display status and information for the Catalyst 4000 family switch:
Console> show module
Mod Slot Ports Module-Type Model Sub Status
--- ---- ----- ------------------------- ------------------- --- --------
1 1 0 Switching Supervisor WS-X4012 yes ok
2 2 6 1000BaseX Ethernet Ext WS-X4306
3 3 6 1000BaseX Ethernet WS-X4306 no ok

Mod Module-Name Serial-Num

--- ------------------- --------------------
1 JAB023806JR
2 JAB0240004D
3 JAB024000YY

Mod MAC-Address(es) Hw Fw Sw
--- -------------------------------------- ------ ---------- -----------------
1 00-10-7b-f8-03-00 to 00-10-7b-f8-06-ff 0.1 4.4(0.14) 5.1(0.57)
2 00-10-7b-f6-b1-a8 to 00-10-7b-f6-b1-ad 0.2
3 00-10-7b-f6-b2-1a to 00-10-7b-f6-b2-1f 0.2
Console>

Table 2-29 describes the possible fields in the show module command output.

Table 2-29 show module Command Output Fields

Field Description
Mod Module number.
Slot Slot number.
Module-Name Name of the module (if configured).
Ports Number of ports on the module.
Module-Type Module type (such as 10BASE-T Ethernet or Token Ring).
Model Model number of the module.
Serial-Num Serial number of the module.
Status Status of the module. Possible status strings are ok, disable, faulty, other,
standby, and error.
MAC-Address(es) MAC address or MAC address range for the module. Token Ring module
MAC addresses appear in noncanonical format.
Hw Hardware version of the module1.
Fw Firmware version of the module2.
Sw Software version on the module.
SMT User-Data User-data string defined for the FDDI module.
T-Notify T-Notify timer value configured for the FDDI module.
CF-St Configuration management state of the FDDI module.
ECM-St Entity Coordination Management state of the FDDI module.
Bypass Status of whether an optical bypass switch is present.
3
Sub-Type Submodule type.
3
Sub-Model Model number of the submodule.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-481
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show module

Table 2-29 show module Command Output Fields (continued)

Field Description
3
Sub-Serial Serial number of the submodule.
3
Sub-Hw Hardware version of the submodule.
1. Hw for the supervisor engine module displays the supervisor engine module's EARL hardware version.
2. Fw for the supervisor engine module displays the supervisor engine module's boot version.
3. This field displays EARL information; this field is dd on the Catalyst 4000 family and Catalyst 2948G switches.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-482 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show multicast group

show multicast group

Use the show multicast group command to display the multicast group configuration.

show multicast group [mac_addr] [vlan_id]

Syntax Description mac_addr (Optional) Destination MAC address.

vlan_id (Optional) Number of the VLAN.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the multicast group configuration for VLAN 1:
Console> show multicast group 1
VLAN Dest MAC/Route Des [CoS] Destination Ports or VCs / [Protocol Type]
---- ----------------- ----- ----------------------------------
1 01-00-5e-00-01-28* 3/1,12/9
1 01-00-5e-63-7f-6f* 3/1,12/5,12/9
Total Number of Entries = 2
Console>

This example shows how to display the multicast group configuration for a specific MAC address on
VLAN 5:
Console> show multicast group 01-00-5E-00-00-5C 5
VLAN Dest MAC/Route Des [CoS] Destination Ports or VCs / [Protocol Type]
---- ----------------- ----- ----------------------------------
5 01-00-5E-00-00-5C 3/1, 3/9
Total Number of Entries = 1
Console>

Table 2-30 describes the fields in the show multicast group command output.

Table 2-30 show multicast group Command Output Fields

Field Description
VLAN VLAN number.
Dest MAC/Route Des Group destination MAC address.
* Status of whether the port was configured manually as a multicast
router port.
CoS CoS value.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-483
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show multicast group

Table 2-30 show multicast group Command Output Fields (continued)

Field Description
Destination Ports or VCs List of all the ports that belong to this multicast group. Traffic
destined to this group address will be forwarded on all these ports.
Total Number of Entries Total number of entries in the multicast group table that match the
criteria specified by the command.

Related Commands clear multicast router

set cgmp
set multicast router
show multicast router

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-484 78-12648-03
 2
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show multicast group count

show multicast group count

Use the show multicast group count command to show the total number of multicast addresses (groups)
in a VLAN.

show multicast group count [vlan_id]

Syntax Description vlan_id (Optional) Number of the VLAN.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal

Examples This example shows how to display the total count of multicast groups in VLAN 5:
Console> show multicast group count 5
Total Number of Entries = 2
Console>

Related Commands clear multicast router

set cgmp
set multicast router
show multicast router

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-485
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show multicast protocols status

show multicast protocols status

Use the show multicast protocols status command to display multicast protocol configuration status.

show multicast protocols status

Syntax Description This command has no keywords or arguments.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal

Examples This example show how to display the multicast protocol configuration:
Console> show multicast protocols status
CGMP disabled
IGMP enabled
IGMP fastleave disabled
RGMP enabled
GMRP disabled
Console> (enable)

Related Commands clear multicast router

set multicast router
show multicast group count
show multicast router

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-486 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show multicast router

show multicast router

Use the show multicast router command to display which ports have Cisco Group Management
Protocol (CGMP_-capable routers assigned to them.

show multicast router [cgmp | rgmp] [mod_num/port_num] [vlan_id]

Syntax Description cgmp (Optional) Keyword that specifies to display only the configuration
information learned through CGMP.
rgmp (Optional) Keyword that specifies to display only the configuration
information learned through RGMP.
mod_num (Optional) Number of the module.
port_num (Optional) Number of the port on the module.
vlan_id (Optional) Number of the VLAN.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example show how to display the multicast router configuration:
Console> show multicast router
Port Vlan
---------- ----------------

Total Number of Entries = 0

'*' - Configured
'+' - RGMP-capable
Console> (enable)

This example show how to display the multicast router configuration for VLAN 99:
Console> show multicast router 99
Port Vlan
---------- ----------------

Total Number of Entries = 0

'*' - Configured
Console>

This example shows how to display only the configuration information learned through CGMP:
Console> show multicast router cgmp
CMGP Feature is enabled.
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-487
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show multicast router

Table 2-31 describes the fields in the show multicast router command output.

Table 2-31 show multicast router Command Output Fields

Field Description
Port Port through which a multicast router can be reached
Vlan VLAN associated with the port
* Status of whether the port was manually configured as a multicast
router port
+ States whether the port is RGMP capable
CGMP enabled Status of whether CGMP is enabled or disabled
Total Number of Entries Total number of entries in the table that match the criteria specified by
the command

Related Commands clear multicast router

set cgmp
set multicast router
show multicast group count

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-488 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show netstat

show netstat
Use the show netstat command to display the currently active network connections and to list statistics
for the various protocols.

show netstat [tcp | udp | ip | icmp | routes | stats | interfaces]

Syntax Description tcp (Optional) Keyword that specifies to show TCP statistics.
udp (Optional) Keyword that specifies to show UDP statistics.
ip (Optional) Keyword that specifies to show IP statistics.
icmp (Optional) Keyword that specifies to show ICMP statistics.
routes (Optional) Keyword that specifies to show the IP routing table.
stats (Optional) Keyword that specifies to show all statistics for TCP,
UDP, IP, and ICMP.
interfaces (Optional) Keyword that specifies to show interface statistics.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines Counter information for me1 is viewed by entering the show netstat interfaces command.

Examples This example shows how to display the current active network connections:
Console> show netstat
Active Internet connections (including servers)
Proto Recv-Q Send-Q Local Address Foreign Address (state)
tcp 0 128 172.20.25.142.23 171.68.10.75.44720 ESTABLISHED
tcp 0 0 *.7161 *.* LISTEN
tcp 0 0 *.23 *.* LISTEN
udp 0 0 *.* *.*
udp 0 0 *.161 *.*
udp 0 0 *.123 *.*
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-489
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show netstat

This example shows how to display TCP statistics:

Console> show netstat tcp
tcp:
5122 packets sent
4642 data packets (102292 bytes)
28 data packets (6148 bytes) retransmitted
434 ack-only packets (412 delayed)
0 URG only packets
0 window probe packets
1 window update packet
17 control packets
7621 packets received
4639 acks (for 103883 bytes)
69 duplicate acks
0 acks for unsent data
3468 packets (15367 bytes) received in-sequence
12 completely duplicate packets (20 bytes)
0 packets with some dup. data (0 bytes duped)
4 out-of-order packets (0 bytes)
0 packets (0 bytes) of data after window
0 window probes
0 window update packets
0 packets received after close
0 discarded for bad checksums
0 discarded for bad header offset fields
0 discarded because packet too short
6 connection requests
6 connection accepts
10 connections established (including accepts)
11 connections closed (including 1 drop)
2 embryonic connections dropped
4581 segments updated rtt (of 4600 attempts)
28 retransmit timeouts
0 connections dropped by rexmit timeout
0 persist timeouts
66 keepalive timeouts
63 keepalive probes sent
3 connections dropped by keepalive
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-490 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show netstat

Table 2-32 describes the fields in the show netstat tcp command output.

Table 2-32 show netstat tcp Command Output Fields

Field Description
packets sent Total number of TCP packets sent
data packets (bytes) Number of TCP data packets sent and the size of those packets in
bytes
data packets (bytes) Number of TCP data packets retransmitted and the size of those
retransmitted packets in bytes
ack-only packets Number of TCP acknowledgment-only packets sent and the
(delayed) number of those packets delayed
packets received Total number of TCP packets received
acks (for x bytes) Number of TCP acknowledgments received and the total bytes
acknowledged
duplicate acks Number of duplicate TCP acknowledgments received
acks for unsent data Number of TCP acknowledgments received for data that was not
sent
packets (bytes) received Number of TCP packets (and the size in bytes) received in sequence
in-sequence
completely duplicate Number of duplicate TCP packets (and the size in bytes) received
packets (bytes)
packets with some dup. Number of TCP packets received with duplicate data (and the
data (bytes duped) number of bytes of duplicated data)
out-of-order packets Number of out-of-order TCP packets (and the size in bytes)
(bytes) received
packets (bytes) of data Number of TCP packets (and the size in bytes) received outside of
after window the specified data window
discarded for bad Number of TCP packets received and discarded that failed the
checksums checksum
discarded because Number of TCP packets received and discarded that were truncated
packet too short
connection requests Total number of TCP connection requests sent
connection accepts Total number of TCP connection accepts sent
connections established Total number of TCP connections established, including those for
(including accepts) which a connection accept was sent
connections closed Total number of TCP connections closed, including dropped
(including x drops) connections
retransmit timeouts Number of timeouts that occurred when a retransmission was
attempted
connections dropped by Number of connections dropped due to retransmission timeouts
rexmit timeout
keepalive timeouts Number of keepalive timeouts that occurred

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-491
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show netstat

Table 2-32 show netstat tcp Command Output Fields (continued)

Field Description
keepalive probes sent Number of TCP keepalive probes sent
connections dropped by Number of connections dropped
keepalive

This example shows how to display UDP statistics:

Console> show netstat udp
udp:
0 incomplete headers
0 bad data length fields
0 bad checksums
0 socket overflows
1116 no such ports
Console>

Table 2-33 describes the fields in the show netstat udp command output.

Table 2-33 show netstat udp Command Output Fields

Field Description
incomplete headers Number of UDP packets received with incomplete packet headers
bad data length fields Number of UDP packets received with a data length field that did
not match the actual length of the packet payload
bad checksums Number of UDP packets received that failed the checksum
socket overflows Number of socket overflows
no such ports Number of UDP packets received destined for nonexistent ports

This example shows how to display IP statistics:

Console> show netstat ip
ip:
76894 total packets received
0 bad header checksums
0 with size smaller than minimum
0 with data size < data length
0 with header length < data size
0 with data length < header length
0 fragments received
0 fragments dropped (dup or out of space)
0 fragments dropped after timeout
0 packets forwarded
0 packets not forwardable
0 redirects sent
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-492 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show netstat

Table 2-34 describes the fields in the show netstat ip command output.

Table 2-34 show netstat ip Command Output Fields

Field Description
total packets received Total number of IP packets received
bad header checksums Number of received IP packets that failed the checksum
with size smaller than Number of received IP packets that were smaller than the minimum
minimum IP packet size
fragments received Number of IP packet fragments received
fragments dropped (dup Number of received IP packet fragments that were dropped because
or out of space) of duplicate data or buffer overflow
fragments dropped after Number of received IP packet fragments that were dropped
timeout
packets forwarded Number of forwarded IP packets
packets not forwardable Number of IP packets that the switch did not forward

This example shows how to display ICMP statistics:

Console> show netstat icmp
icmp:
Redirect enabled
0 calls to icmp_error
0 errors not generated 'cuz old message was icmp
Output histogram:
echo reply: 1001
1 message with bad code fields
0 messages < minimum length
0 bad checksums
0 messages with bad length
Input histogram:
echo reply: 12
destination unreachable: 3961
echo: 1001
1001 message responses generated
Console>

Table 2-35 describes the fields in the show netstat icmp command output.

Table 2-35 show netstat icmp Command Output Fields

Field Description
Redirect enabled Status of whether ICMP redirection is enabled or disabled
Output histogram Frequency distribution statistics for output ICMP packets
echo reply Number of output echo reply ICMP packets
messages with bad code Number of ICMP packets with an invalid code field
fields
messages < minimum Number of ICMP packets with less than the minimum packet
length length
bad checksums Number of ICMP packets that failed the checksum

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-493
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show netstat

Table 2-35 show netstat icmp Command Output Fields (continued)

Field Description
messages with bad Number of ICMP packets with an invalid length
length
Input histogram Frequency distribution statistics for input ICMP packets
echo reply Number of input echo reply ICMP packets
destination unreachable Number of input destination unreachable ICMP packets
echo Number of input echo ICMP packets
message responses Number of ICMP message responses the system generated
generated

This example shows how to display the IP routing table:

Console> show netstat routes
DESTINATION GATEWAY FLAGS USE INTERFACE
default 172.16.1.201 UG 6186 sc0
172.16.0.0 172.16.25.142 U 6383 sc0
default default UH 0 sl0
Console>

Table 2-36 describes the fields in the show netstat routes command output.

Table 2-36 show netstat routes Command Output Fields

Field Description
DESTINATION Destination IP address or network
GATEWAY Next hop to the destination
INTERFACE Interface out of which packets to the destination should be
forwarded

This example shows how to display interface statistics:

Console> show netstat interface
Interface InPackets InErrors OutPackets OutErrors
sl0 0 0 0 0
sc0 33 0 117192 0
me1 2 0 57075 0
Interface Rcv-Octet Xmit-Octet
--------- -------------------- --------------------
sc0 2389 0
me1 1172 0
sl0 0 0
Interface Rcv-Unicast Xmit-Unicast
--------- -------------------- --------------------
sc0 28 0
me1 28 0
sl0 0 0
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-494 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show netstat

Table 2-37 describes the fields in the show netstat interface command output.

Table 2-37 show netstat interface Command Output Fields

Field Description
Interface Interface number (sl0 is the SLIP interface; sc0 is the in-band
interface; me1 is the out-of-band interface)
InPackets Number of input packets on the interface
InErrors Number of input errors on the interface
OutPackets Number of output packets on the interface
OutErrors Number of output errors on the interface
Rcv-Octet Number of octet frames received on the port
Xmit-Octet Number of octet frames transmitted on the port
Rcv-Unicast Number of unicast frames received on the port
Xmit-Unicast Number of unicast frames transmitted on the port

Related Commands set interface

set ip route—switch

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-495
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show ntp

show ntp
Use the show ntp command to display the current Network Time Protocol (NTP) status.

show ntp

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the current NTP status:
Console> show ntp
Current time: Thu Jan 15 1999, 11:19:03 pst
Timezone: 'pst', offset from UTC is -8 hours
Summertime: 'pst', enabled
Last NTP update:
Broadcast client mode: enabled
Broadcast delay: 3000 microseconds
Client mode: disabled
Authentication: enabled

NTP-Server Server Key

---------------------------------------- ----------
172.20.33.140 1722033140
172.20.33.114 1722033114

Console>

The following output appears in the show ntp command output when entered from privileged mode:
Key Number Mode Key String
---------- --------- --------------------------------
1234 trusted 32423423423
1722033140 untrusted termserv-am
Console>

Table 2-38 describes the fields in the show ntp command output.

Table 2-38 show ntp Command Output Fields

Field Description
Current time Current system time
Timezone Time zone and offset in hours from UTC

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-496 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show ntp

Table 2-38 show ntp Command Output Fields (continued)

Field Description
Summertime Time zone for daylight saving time and whether the daylight saving
time adjustment is enabled or disabled
Last NTP update Time of the last NTP update
Broadcast client mode Status of whether NTP broadcast-client mode is enabled or
disabled
Broadcast delay Configured NTP broadcast delay
Client mode Status of whether NTP client mode is enabled or disabled
NTP-Server List of configured NTP servers

Related Commands clear ntp key

clear ntp server
set ntp broadcastclient
set ntp broadcastdelay
set ntp client
set ntp key
set ntp server

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-497
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port

show port
Use the show port command to display port status and counters.

show port [mod[/port]]

Syntax Description mod (Optional) Number of the module.

port (Optional) Number of the port on the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If you do not specify a mod, the ports on all modules are shown.
If you do not specify a port, all the ports on the module are shown.
In the Status field for the switch ports, the following applies:
• connected indicates the port is operational.

Note connected is also displayed for the status of a port that is receiving remote fault
indications. Remote fault indications are not sent until the link comes up and both ends
can hear each other. This means that the link is up and working correctly. According to
the 802.3z Gigabit Ethernet Specification, a link partner is not allowed to send remote
fault indications until after the link comes up successfully.

• notconnect indicates the port is off or there is no GBIC in port.

• faulty indicates the port failed diagnostics tests.
• remfault indicates the far end station cannot synchronize with its receive signal.
• disable indicates the port has been manually disabled.
• remdisable indicates the far end port has been manually disabled.
• configerr indicates that this port is not satisfied with the output of flow control and or duplex
negotiation.
• remcfgerr indicates that the far end port is not satisfied with the output of flow control and or duplex
negotiation.
• disagree indicates that the two ports have failed to agree on a duplex condition or that
autonegotiation has failed.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-498 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port

In the show port command display, the combination of the 32-port module (WS-X4502) and 4-port
100FX card results in an entry that lists 36 ports. If the uplink card is not installed, only ports 1 through
32 are listed.
Although me1 resides on the supervisor engine module for the Catalyst 4000 family switches, me1 port
information is not displayed by the show module or show port CLI commands.

Examples This example shows how to display the status and counters for ports on module 2:
Console> show port 2
Port Name Status Vlan Level Duplex Speed Type
----- ------------------ ---------- ---------- ------ ------ ----- ------------
2/1 connected 1 normal full 1000 1000BaseSX
2/2 connected 1 normal full 1000 1000BaseSX
2/3 notconnect 1 normal full 1000 No GBIC
2/4 notconnect 1 normal full 1000 No GBIC
2/5 notconnect 1 normal full 1000 No GBIC
2/34 reflector rspan-2 normal a-full a-100 10/100BaseTX

Port Security Secure-Src-Addr Last-Src-Addr Shutdown Trap IfIndex

----- -------- ----------------- ----------------- -------- -------- -------
2/1 disabled No disabled 90
2/2 disabled No disabled 91
2/3 disabled No disabled 92
2/4 disabled No disabled 93
2/5 disabled No disabled 94
2/6 disabled No disabled 95

Port Send FlowControl Receive FlowControl RxPause TxPause Unsupported

admin oper admin oper opcodes
----- -------- -------- -------- -------- ------- ------- -----------
2/1 desired off off off 0 0 0
2/2 desired off off off 0 0 0
2/3 desired off off off 0 0 0
2/4 desired off off off 0 0 0
2/5 desired off off off 0 0 0
2/6 desired off off off 0 0 0

Port Align-Err FCS-Err Xmit-Err Rcv-Err UnderSize

----- ---------- ---------- ---------- ---------- ---------
2/1 - 0 1 0 0
2/2 - 8 2 8 0
2/3 - 0 0 0 0
2/4 - 0 0 0 0
2/5 - 0 0 0 0
2/6 - 0 0 0 0

Port Single-Col Multi-Coll Late-Coll Excess-Col Carri-Sen Runts Giants

----- ---------- ---------- ---------- ---------- --------- --------- ---------
2/1 0 0 0 0 1 0 0
2/2 0 0 0 0 1 0 0
2/3 0 0 0 0 0 0 0
2/4 0 0 0 0 0 0 0
2/5 0 0 0 0 0 0 0
2/6 0 0 0 0 0 0 0

Last-Time-Cleared
--------------------------
Fri Apr 9 1999, 18:54:17
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-499
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port

Table 2-39 describes the possible fields (depending on the port type queried) in the show port command
output.

Table 2-39 show port Command Output Fields

Field Description
Port Module and port number.
Name Name (if configured) of the port.
Status Status of the port. For the Catalyst 4000 family and Catalyst 2948G switches,
possible displays are connected, notconnect, faulty, remfault, disable,
remdisable, configerr, remcfgerr, reflector, and disagree.
Vlan VLANs to which the port belongs.
Duplex Duplex setting for the port (auto, full, fdx, half, hdx, a-half, a-hdx, a-full, or
a-fdx).
Speed Speed setting for the port Valid values are auto, 10, 100, 155, a-10, a-100,
4, 16, a-14,or a-16.
Type1 Port type, for example, 100BASE-FX MM, 100BASE-FX SM,
10/100BASE-TX.
Security Status of whether port security is enabled or disabled.
Secure-Src-Addr Secure MAC address for the security enabled port.
Last-Src-Addr Source MAC address of the last packet received by the port.
Shutdown Status of whether the port was shut down because of security.
Trap Status of whether port trap is enabled or disabled.
IfIndex Number of the ifIndex.
Broadcast-Limit Broadcast threshold configured for the port.
Broadcast-Drop Number of broadcast/multicast packets dropped because the broadcast limit
for the port was exceeded.
Send admin Flow-control administration. Possible settings: on indicates the local port
sends flow control to the far end; off indicates the local port does not send
flow control to the far end; desired indicates the local end sends flow control
to the far end if the far end supports it.
FlowControl oper Flow-control operation. Possible setting: disagree indicates the two ports
could not agree on a link protocol.
Receive admin Flow-control administration. Possible settings: on indicates the local port
requires the far end to send flow control; off indicates the local port does not
allow the far end to send flow control; desired indicates the local end allows
the far end to send flow control.
FlowControl oper Flow-control operation. Possible setting: disagree indicates the two ports
could not agree on a link protocol.
RxPause Number of Pause frames received.
TxPause Number of Pause frames transmitted.
Unsupported Number of unsupported operating codes.
Opcodes

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-500 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port

Table 2-39 show port Command Output Fields (continued)

Field Description
Align-Err Number of frames with alignment errors (frames that do not end with an even
number of octets and have a bad CRC) received on the port.
FCS-Err The number of valid size frames with FCS errors but no framing errors.
Xmit-Err Number of transmit errors that occurred on the port (indicating that the
internal transmit buffer is full).
Rcv-Err Number of receive errors that occurred on the port (indicating that the
internal receive buffer is full).
UnderSize Number of received frames less than 64 octets long (but are otherwise
well-formed).
Single-Col Number of times one collision occurred before the port transmitted a frame
to the media successfully.
Multi-Coll Number of times multiple collisions occurred before the port transmitted a
frame to the media successfully.
Late-Coll Number of late collisions (collisions outside the collision domain).
Excess-Col Number of excessive collisions that occurred on the port (indicating that a
frame encountered 16 collisions and was discarded).
Carri-Sen Number of times the port sensed a carrier (to determine whether the cable is
currently being used).
Runts Number of received runt frames (frames that are smaller than the minimum
IEEE 802.3 frame size) on the port.
Giants Number of received giant frames (frames that exceed the maximum IEEE
802.3 frame size) on the port.
Last-Time-Cleared Last time the port counters were cleared.
Auto-Part The number of times the port entered the auto-partition state due to excessive
consecutive collisions.
Data-rate The number of valid size frames experienced overrun or underrun.
mismatch
Src-addr change The number of times the last source address changed.
Good-bytes The total number of octets in frames with no error.
Short-event The number of times activity with a duration less than the ShortEventMax
Time (74 to 82 bit times) is detected.
1. These fields will change according to the system configuration.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-501
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port auxiliaryvlan

show port auxiliaryvlan

Use the show port auxiliaryvlan command to display the port auxiliary VLAN status for a specific port.

show port auxiliaryvlan [vlan | untagged | none]

Syntax Description vlan (Optional) Number of the VLAN; valid values are from 1 to 1000.
untagged (Optional) Keyword to display the port that sends untagged packets.
none (Optional) Keyword to display the port that does not send any
auxiliary VLAN information in the CDP packets from that port.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines This command is not supported by the NAM.

Examples This example shows how to display the port information for all auxiliary VLANs:
Console> (enable) show port auxiliaryvlan
AuxiliaryVlan AuxVlanStatus Mod/Ports
------------- ------------- ------------------------------------------------
222 active 2/4-7
333 active 2/13-18
dot1p dot1p 2/23,8/31-34
untagged untagged 3/12
none none 2/1-3,2/8-12,2/19-22,2/24-30,2/35-48,3/1-11,3/13-48

This example shows how to display the port information for a specific auxiliary VLAN:
Console> (enable) show port auxiliaryvlan 123

AuxiliaryVlan AuxVlanStatus Mod/Ports

------------- ------------- -------------------------
123 active 1/2,2/1-3
Console> (enable)

This example shows how to display the status of the switch that does not send any auxiliary VLAN
information in the CDP packets:
Console> (enable) show port auxiliaryvlan none
AuxiliaryVlan AuxVlanStatus Mod/Ports
------------- ------------- ------------------------------------------------
none none 2/1-3,2/8-12,2/19-22,2/24-30,2/35-48,3/1-11,3/13-48
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-502 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port auxiliaryvlan

This example shows how to display the status of the switch that sends untagged packets:
Console> (enable) show port auxiliaryvlan untagged
AuxiliaryVlan AuxVlanStatus Mod/Ports
------------- ------------- -------------------------
untagged untagged 3/12
Console> (enable)

Table 2-40 describes the possible fields (depending on the port type queried) in the show port
auxiliaryvlan command output.

Table 2-40 show port auxiliaryvlan Command Output Fields

Field Description
AuxiliaryVlan Number of the auxiliary VLAN
AuxVlanStatus Status of the auxiliary VLAN
Mod/Ports Number of the module and ports assigned to the auxiliary VLAN

Related Commands set port auxiliaryvlan

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-503
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port capabilities

show port capabilities

Use the show port capabilities command to display the capabilities of the modules and ports in a switch.

show port capabilities [mod_num[/port_num]]

Syntax Description mod_num (Optional) Number of the module.

/port_num (Optional) Number of the port on the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If you do not specify a mod_num, the ports on all modules are shown.
If you do not specify a /port_num, all the ports on the module are shown.

Examples This example shows how to show the port capabilities for module 1, port 1:
Console> (enable) show port capabilities 1/1
Model WS-X5530
Port 1/1
Type 10/100BaseTX
Speed auto,10,100
Duplex half,full
Trunk encap type 802.1Q,ISL
Trunk mode on,off,desirable,auto,nonegotiate
Channel 1/1-2,1/1-4
Broadcast suppression percentage(0-100)
Flow control receive-(off,on),send-(off,on)
Security yes
Membership static,dynamic
Fast start yes
QOS scheduling rx-(none),tx-(none)
CoS rewrite yes
ToS rewrite IP-Precedence
Rewrite yes
UDLD Capable
Voice vlan no

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-504 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port capabilities

Table 2-41 describes the possible fields (depending on the type of port queried) and the values in the
show port capabilities command output.

Table 2-41 show port capabilities Command Output Fields

Field Description
Model Module model number.
Port Module number and port number.
Type1 Port type (for example, 100BASE-FX MM, 100BASE-FX SM, or
10/100BASE-TX).
Speed1 Port speed setting (for example, auto, 100, or 1000).
Duplex Duplex mode (half, full, auto, fdx, hdx, or no).
Trunk encap type Trunk encapsulation type (ISL, 802.1Q, 802.10, or no).
Trunk mode Trunk administrative status of the port (on, off, auto, desirable,
nonegotiate, or no).
Channel Status of which ports can form a channel group. The ports are shown in
mod_num/port_num format. For example, 3/1-2 indicates module 3, ports
1 and 2. In addition, any ports in range [mod/1-mod/high_port] or no ports
may be indicated.
Broadcast Number of packets-per-second (pps) of broadcast/multicast traffic allowed
suppression on the port (0 to 150000) or the percentage of total available bandwidth that
can be used by broadcast/multicast traffic (0 to 100).
Flow control Flow-control options that can be set (receive-[off, on, desired], send-[off,
on, desired], or no).
Security Status of whether port security is enabled (yes or no).
Membership Method of membership assignment of a port or range of ports to a VLAN
(static or dynamic).
Fast Start Status of whether the spanning tree port fast-start feature on the port is
enabled (yes or no).
QoS Scheduling (rx-(none),tx-(none)).
CoS Rewrite Status of whether the port supports COS rewrite (yes or no).
ToS Rewrite Status of whether the port supports TOS rewrite (IP-Precedence).
Rewrite Status of whether the port supports inline rewrite (yes or no).
UDLD Status of whether the port supports UDLD (Capable, Not capable).
Voice Vlan Status of whether the port supports voice or VLAN (yes or no).
1. These fields will change depending on the system configuration.

Related Commands set port channel

set port security
set port speed
set spantree portfast
set trunk

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-505
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port cdp

show port cdp

Use the show port cdp command to display port Cisco Discovery Protocol (CDP) enable state and
message interval on the port.

show port cdp [mod_num[/port_num]]

Syntax Description mod_num (Optional) Number of the module.

/port_num (Optional) Number of the port on the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If you do not specify a mod_num, the ports on all modules are shown. If you do not specify a /port_num,
all the ports on the module are shown.

Examples This example shows how to display CDP information for all ports:
Console> show port cdp
CDP :enabled
Message Interval :60
Hold Time :180

Port CDP Status

-------- ----------
2/1 enabled
2/2 enabled
5/1 enabled
5/2 enabled
5/3 enabled
5/4 enabled
5/5 enabled
5/6 enabled
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-506 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port cdp

Table 2-42 describes the fields in the show port cdp command output.

Table 2-42 show port cdp Command Output Fields

Field Description
Port Module and port number
CDP Status CDP status of the port (enabled, disabled)
Message-Interval Interval between CDP message exchange with neighbor

Related Commands set cdp

set cdp interval

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-507
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port channel

show port channel

Use the show port channel command to display EtherChannel information for a specific module or port.

show port channel [mod_num[/port_num]] [statistics | info [spantree | trunk | protocol |

gmrp | gvrp | qos]]

Syntax Description mod_num (Optional) Number of the module.

port_num (Optional) Number of the port.
statistics (Optional) Keyword to display EtherChannel PAgP statistics.
info (Optional) Keyword to display EtherChannel configuration information.
spantree (Optional) Keyword to display only spanning-tree-related configuration information.
trunk (Optional) Keyword to display only VLAN-trunk-related configuration information.
protocol (Optional) Keyword to display only protocol-filtering-related configuration
information.
gmrp (Optional) Keyword to display only GMRP-related configuration information.
gvrp (Optional) Keyword to display only GVRP-related configuration information.
qos (Optional) Keyword to display only QoS-related configuration information.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If the module and port are not specified, EtherChannel information is shown for all channeling ports on
all modules.

Examples This example shows how to display Fast EtherChannel information for port 1/4:
Console> show port channel 1/4
Port Status Channel Admin Ch
Mode Group Id
----- ---------- -------------------- ----- -----
1/1 connected auto silent 22 769
1/2 connected auto silent 22 769
1/3 connected auto silent 22 769
1/4 connected auto silent 22 769
----- ---------- -------------------- ----- -----

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-508 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port channel

Port Device-ID Port-ID Platform

----- ------------------------------- ------------------------- ----------------
1/1 069003103(5500) 3/13 WS-C5500
1/2 069003103(5500) 3/14 WS-C5500
1/3 069003103(5500) 3/15 WS-C5500
1/4 069003103(5500) 3/16 WS-C5500
----- ------------------------------- ------------------------- ----------------
Console>

Table 2-43 describes the fields in the show port channel output.

Table 2-43 show port channel Command Output Fields

Field Description
Port Module and port number
Status Port connection status
Channel mode EtherChannel mode
Admin Group EtherChannel administrative group
Ch Id EtherChannel ID
Device-ID Serial number and hostname of neighboring device
Port-ID Connected port number on neighboring device
Platform Neighboring device platform

This example shows how to display PAgP packet statistics:

Console> show port channel statistics
Port Admin PAgP Pkts PAgP Pkts PAgP Pkts PAgP Pkts PAgP Pkts PAgP Pkts
Group Transmitted Received InFlush RetnFlush OutFlush InError
----- ------- ----------- --------- --------- --------- --------- ---------
1/1 22 5063 5073 0 0 0 0
1/2 22 5062 5075 0 0 0 0
1/3 22 5068 5077 0 0 0 0
1/4 22 5076 5066 0 0 0 0
----- ------- ----------- --------- --------- --------- --------- ---------
Console>

Table 2-44 describes the fields in the show port channel statistics output.

Table 2-44 show port channel statistics Command Output Fields

Field Description
Port Port number
Admin Group EtherChannel administrative group
PAgP Pkts Transmitted Number of PAgP packets transmitted on the port
PAgP Pkts Received Number of PAgP packets received on the port
PAgP Pkts InFlush Number of PAgP flush packets received
PAgP Pkts RetnFlush Number of PAgP flush packets returned
PAgP Pkts OutFlush Number of PAgP flush packets transmitted
PAgP Pkts InError Number of PAgP error packets received

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-509
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port channel

This example shows how to display EtherChannel configuration information:

Console> show port channel info
Switch Frame Distribution Method: mac both

Port Status Channel Admin Channel Speed Duplex Vlan

mode group id
----- ---------- -------------------- ----- ------- ----- ------ ----
1/1 connected auto silent 22 769 a-100 a-full 1
1/2 connected auto silent 22 769 a-100 a-full 1
1/3 connected auto silent 22 769 a-100 a-full 1
1/4 connected auto silent 22 769 a-100 a-full 1
----- ---------- -------------------- ----- ------- ----- ------ ----

Port ifIndex Oper-group Neighbor Oper-Distribution PortSecurity/

Oper-group Method Dynamic port
----- ------- ---------- ---------- ----------------- -------------
1/1 626 1 mac both
1/2 626 1 mac both
1/3 626 1 mac both
1/4 626 1 mac both
----- ------- ---------- ---------- ----------------- -------------

Port Device-ID Port-ID Platform

----- ------------------------------- ------------------------- ----------------
1/1 069003103(5500) 3/13 WS-C5500
1/2 069003103(5500) 3/14 WS-C5500
1/3 069003103(5500) 3/15 WS-C5500
1/4 069003103(5500) 3/16 WS-C5500
----- ------------------------------- ------------------------- ----------------

Port Trunk-status Trunk-type Trunk-vlans

----- ------------ ------------- -----------------------------------------------
1/1 trunking n-isl 1-1005
1/2 trunking n-isl 1-1005
1/3 trunking n-isl 1-1005
1/4 trunking n-isl 1-1005
----- ------------ ------------- -----------------------------------------------

Port Portvlancost-vlans
----- --------------------------------------------------------------------------
1/1
1/2
1/3
1/4
----- --------------------------------------------------------------------------

Port Port Portfast Port Port

priority vlanpri vlanpri-vlans
----- -------- -------- ------- ------------------------------------------------
1/1 32 disabled 0
1/2 32 disabled 0
1/3 32 disabled 0
1/4 32 disabled 0
----- -------- -------- ------- ------------------------------------------------

Port IP IPX Group

----- -------- -------- --------
1/1 on auto-on auto-on
1/2 on auto-on auto-on
1/3 on auto-on auto-on
1/4 on auto-on auto-on
----- -------- -------- --------

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-510 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port channel

Port GMRP GMRP GMRP

status registration forwardAll
----- -------- ------------ ----------
1/1 enabled normal disabled
1/2 enabled normal disabled
1/3 enabled normal disabled
1/4 enabled normal disabled
----- -------- ------------ ----------

Port GVRP GVRP GVRP

status registration applicant
----- -------- ------------- ---------
1/1 disabled normal normal
1/2 disabled normal normal
1/3 disabled normal normal
1/4 disabled normal normal
----- -------- ------------- ---------

Port Qos-Tx Qos-Rx Qos-Trust Qos-DefCos

PortType PortType Type
----- -------- -------- ------------ ----------
1/1 - - untrusted 0
1/2 - - untrusted 0
1/3 - - untrusted 0
1/4 - - untrusted 0
----- -------- -------- ------------ ----------

Console>

Table 2-45 describes the fields in the show port channel info output.

Table 2-45 show port channel info Command Output Fields

Field Description
Switch Frame Frame distribution method for all EtherChannels on the switch
Distribution Method
Port Port number
Status Port connection status
Channel mode EtherChannel mode
Admin group EtherChannel administrative group
Channel id EtherChannel ID
Speed Port speed
Duplex Port duplex
Vlan Port VLAN membership
if-index Interface index number
Oper-group Capability of the group
Neighbor Oper-group Device ID of the neighboring device with which the port is
channeling
Chan cost EtherChannel spanning tree port cost
Oper-Distribution EtherChannel frame distribution method
Method

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-511
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port channel

Table 2-45 show port channel info Command Output Fields (continued)

Field Description
PortSecurity/Dynamic Status of whether the port is secure or dynamic
Port
Device-ID Serial number and hostname of neighboring device
Port-ID Connected port number on neighboring device
Platform Neighboring device platform
Trunk-status VLAN trunking mode
Trunk-type VLAN trunk encapsulation type
Trunk-vlans Allowed VLAN list for the trunk
Portvlancost-vlans Spanning tree port-VLAN cost and associated VLAN IDs
Port priority Spanning tree port priority
Portfast Spanning tree PortFast enable state
Port vlanpri-vlans Spanning tree port-VLAN priority and associated VLAN IDs
IP IP protocol filtering mode
IPX IPX protocol filtering mode
Group Group protocol filtering mode
GMRP status GMRP enable state
GMRP registration GMRP registration mode
GMRP forwardAll GMRP forward-all enable status
GVRP status GVRP enable state
GVRP registration GVRP registration mode
GVRP applicant GVRP applicant mode
Qos-Tx Transmit queue and threshold port type
Qos-Rx Receive queue and threshold port type
Qos-Trust QoS port trust
QoS-DefCos QoS default CoS

Related Commands set channel cost

set channel vlancost
set port channel
show channel
show channel group

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-512 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port counters

show port counters

Use the show port counters command to show all the counters for a port.

show port counters [mod_num/port_num]

Syntax Description mod_num (Optional) Number of the module for which to show port counter information.
/port_num (Optional) Number of the port on the module for which to show port counter
information.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If you do not specify a mod_num, the ports on all modules are shown.
If you do not specify a /port_num, all the ports on the module are shown.

Examples This example shows the output of the show port counters command:
Console> (enable) show port counters
Port Align-Err FCS-Err Xmit-Err Rcv-Err Broad-Limit Broad-Drop
---- ---------- ---------- ---------- ---------- ----------- ----------
1/1 0 0 0 0 - 0
1/2 0 0 0 0 - 0
4/1 0 0 0 0 10000p/s 0
4/2 0 0 0 0 100p/s 53728
4/3 0 0 0 0 - 0
4/4 0 0 0 0 11.50p/s 52
Port Single-Col Multi-Coll Late-Coll Excess-Col Carri-Sens Runts Giants
---- ---------- ---------- --------- ---------- ---------- ----- ------
1/1 0 0 0 0 0 0 -
1/2 0 0 0 0 0 0 -
4/1 0 0 0 0 0 0 -
4/2 0 0 0 0 0 0 -
4/3 0 0 0 0 0 0 -
4/4 0 0 0 0 0 0 -

Ler
Port CE-State Conn-State Type Neig Con Est Alm Cut Lem-Ct Lem-Rej-Ct Tl-Min
----- -------- ---------- ---- ---- --------------- ---------- ---------- ------
3/1 isolated connecting A U no 9 9 7 0 0 102
3/2 isolated connecting B U no 9 8 7 0 0 40

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-513
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port counters

Last-Time-Cleared
--------------------------
Wed Apr 10 1996, 14:59:51
Console> (enable)

Table 2-46 describes the possible fields (depending on the port type queried) in the show port counters
command output.

Table 2-46 show port counters Command Output Fields

Field Description
Port Module and port number.
Align-Err Number of frames with alignment errors (frames that do not end with an
even number of octets and have a bad CRC) received on the port.
FCS-Err Number of frame check sequence errors that occurred on the port.
Xmit-Err Number of transmit errors that occurred on the port (indicating that the
internal transmit buffer is full).
Rcv-Err Number of receive errors that occurred on the port (indicating that the
internal receive buffer is full).
UnderSize Number of received frames less than 64 octets long (but are otherwise well
formed).
Broad-Limit Broadcast threshold configured for the port in percent or packets per
second.
Broad-Drop Number of broadcast/multicast packets dropped because the broadcast
limit for the port was exceeded.
Single-Col Number of times one collision occurred before the port successfully
transmitted a frame to the media.
Multi-Coll Number of times multiple collisions occurred before the port successfully
transmitted a frame to the media.
Late-Coll Number of late collisions (collisions outside the collision domain).
Excess-Col Number of excessive collisions that occurred on the port (indicating that a
frame encountered 16 collisions and was discarded).
Carri-Sens Number of times the port sensed a carrier (to determine whether the cable
is currently being used).
Runts Number of received runt frames (frames that are smaller than the minimum
IEEE 802.3 frame size) on the port.
Giants Number of received giant frames (frames that exceed the maximum IEEE
802.3 frame size) on the port.
CE-State Connection entity status.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-514 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port counters

Table 2-46 show port counters Command Output Fields (continued)

Field Description
Conn-State Connection state of the port, as follows:
• Disabled—The port has no line module or was disabled by the user.
• Connecting—The port attempted to connect or was disabled.
• Standby—The connection was withheld or was the inactive port of a
dual-homing concentrator.
• Active—The port made a connection.
• Other—The concentrator was unable to determine the Conn-State.
Type Type of port, such as A—A port and B—B port.
Neig Type of port attached to this port. The neighbor can be one of these types:
• A—A port.
• B—B port.
• M—M port.
• S—Slave port.
• U—The concentrator cannot determine the type of the neighbor port.
Ler Con Status of whether the port is currently in a LER condition.
Est Estimated LER.
Alm LER at which a link connection exceeds the LER alarm threshold.
Cut LER cutoff value (the LER at which a link connection is flagged as faulty).
Lem-Ct Number of LEM errors received on the port.
Lem-Rej-Ct Number of times a connection was rejected because of excessive LEM
errors.
Tl-Min TL-min value (the minimum time to transmit a FDDI PHY line state)
before advancing to the next PCM state.
Last-Time-Cleared Last time the port counters were cleared.

Related Commands show port

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-515
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port dot1x

show port dot1x

Use the show port dot1x command to display all the configurable and current state values associated
with the authenticator PAE and backend authenticator and statistics for the different types of EAP
packets transmitted and received by the authenticator on a specific port.

show port dot1x [mod[/port]]

show port dot1x statistics [mod[/port]]

Syntax Description mod (Optional) Number of the module.

port (Optional) Number of the port on the module.
statistics Keyword to display statistics for different EAP packets transmitted and received
by the authenticator on a specific port.

This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display all the configurable and current state values associated with the
authenticator PAE and backend authenticator on a specific port:
Console> show port dot1x 3/3
Port Auth-State BEnd-State Port-Control Port-Status
----- ------------------- ---------- ------------------- -------------
3/3 force-authorized idle force-authorized authorized
Port Multiple-Host Re-authentication
----- ------------- -----------------
3/3 disabled disabled
Console>

This example displays the statistics of different types of EAP packets that are transmitted and received by
the authenticator on a specific port:
Console> show port dot1x statistics 4/1,4/2
Port Tx_Req/Id Tx_Req Tx_Total Rx_Start Rx_Logff Rx_Resp/Id Rx_Resp
4/1 1 2 4 2 0 1 0
4/2 3 4 6 0 1 1 0

Port Rx_Invalid Rx_Len_Err Rx_Total Last_Rx_Frm_Ver Last_Rx_Frm_Src_Mac

4/1 0 0 3 1 00-f0-3b-2b-d1-a9
4/2 0 0 3 1 00-d0-62-95-7b-ff
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-516 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port dot1x

Related Commands clear dot1x config

set port dot1x
show dot1x
show port dot1x

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-517
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port flowcontrol

show port flowcontrol

Use the show port flowcontrol command to display per-port status information and statistics related to
flow control.

show port flowcontrol [mod_num[/port_num]]

Syntax Description mod_num (Optional) Number of the module.

/port_num (Optional) Number of the port on the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If you do not specify a number, filters configured on all the ports on the module are shown.

Examples This example shows how to display the flow-control port status and statistics:
Console> show port flowcontrol
Port Send-Flowcontrol Receive-Flowcntl RxPause TxPause
Admin Oper Admin Oper
----- ---------------- ---------------- ------- ------
3/1 on disagree on disagree 0 0
3/2 off off off off 0 0
3/3 desired on desired off 10 10
Console>

Table 2-47 describes the fields in the show port flowcontrol command output.

Table 2-47 show port flowcontrol Command Output Fields

Field Description
Port Module and port number.
Send-Flowcontrol– Flow-control administration. Possible settings: on
Admin indicates the local port sends flow control to the
far end; off indicates the local port does not send
flow control to the far end; desired indicates the
local end sends flow control to the far end if the
far end supports it.
Send-Flowcontrol– Flow-control operation. Possible setting: disagree
Oper indicates the two ports could not agree on a link
protocol.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-518 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port flowcontrol

Table 2-47 show port flowcontrol Command Output Fields (continued)

Field Description
Receive-Flowcntl– Flow-control administration. Possible settings: on
Admin indicates the local port requires the far end to send
flow control; off indicates the local port does not
allow the far end to send flow control; desired
indicates the local end allows the far end to send
flow control.
Receive-Flowcntl– Flow-control operation. Possible setting: disagree
Oper indicates the two ports could not agree on a link
protocol.
RxPause Number of Pause frames received.
TxPause Number of Pause frames transmitted.

Related Commands set port flowcontrol

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-519
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port ifindex

show port ifindex

Use the show port ifindex command to view ifIndex information on a per-port or per-module basis.

show port ifindex [mod_num]

show port ifindex mod_num/port_num

Syntax Description mod_num (Optional) Number of the module.

mod_num/port_num Number of the module and the ports on the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display ifIndex information for all the ports:
Console> show port ifindex
Port ifIndex
----- -------
1/1 3
1/2 4
3/1 383
3/2 384
4/1 385
4/2 386
4/3 387
4/4 388
4/5 389
4/6 390
4/7 391
4/8 392
4/9 393
4/10 394
4/11 395
4/12 396
4/13 397
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-520 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port inlinepower

show port inlinepower

Use the show port inlinepower command to display port power administration and operational status.

show port inlinepower [mod_num[/port_num]]

Syntax Description mod_num (Optional) Number of the module.

/port_num (Optional) Number of the port on the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines An inline power-capable device can still be detected even if the inline power mode is set to off.
The Operational (Oper) status field descriptions are:
• on—Power is being supplied by the port.
• off—Power is not being supplied by the port.
• denied—System does not have enough available power for the port, and power is not supplied by
the port.
• faulty—The port is unable to provide power to the connected device.

Examples This example shows how to display the inline power status for multiple ports on module 3, ports 2 to 6:
Console> show port inlinepower 3/2-6
Default Inline Power allocation per port: 9.500 Watts (0.22 Amps @42V)
Total inline power drawn by module 3: 0 Watt
Port InlinePowered PowerAllocated
Admin Oper Detected mWatt mA @42V
----- ----- ------ -------- ----- --------
3/2 auto on yes 10.00 0.250
3/3 auto on yes 9.8 0.198
3/4 auto denied yes 0 0
3/5 off off no 0 0
3/6 off off yes 0 0
Console>

Related Commands set inlinepower defaultallocation

set port inlinepower
show environment

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-521
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port mac

show port mac

Use the show port mac command to display information about the port MAC counter.

show port mac [mod_num[/port_num]]

Syntax Description mod_num (Optional) Number of the module.

/port_num (Optional) Number of the port on the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If you do not specify a port number, the port mac counter information is displayed for all the ports on
the module.

Examples This example shows how to display port MAC counter information for all ports on module 1:
Console> show port mac 1

Port Rcv-Unicast Rcv-Multicast Rcv-Broadcast

-------- -------------------- -------------------- --------------------
1/1 0 0 0
1/2 0 0 0
1/3 0 0 0
1/4 0 0 0

Port Xmit-Unicast Xmit-Multicast Xmit-Broadcast

-------- -------------------- -------------------- --------------------
1/1 0 0 0
1/2 0 0 0
1/3 0 0 0
1/4 0 0 0

Port Rcv-Octet Xmit-Octet

-------- -------------------- --------------------
1/1 0 0
1/2 0 0
1/3 0 0
1/4 0 0

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-522 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port mac

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

-------- ---------- ---------- ---------- ---------- ---------- ----------
1/1 0 0 0 0 0 0
1/2 0 0 0 0 0 0
1/3 0 0 0 0 0 0
1/4 0 0 0 0 0 0

Last-Time-Cleared
--------------------------
Fri Sep 1 2000, 20:03:06
Console>

Table 2-48 describes the fields in the show port mac command output.

Table 2-48 show port mac Command Output Fields

Field Description
Rcv-Unicast Number of unicast frames received on the port
Rcv-Multicast Number of multicast frames received on the port
Rcv-Broadcast Number of broadcast frames received on the port
Xmit-Unicast Number of unicast frames transmitted by the port
Xmit-Multicast Number of multicast frames transmitted by the port
Xmit-Broadcast Number of broadcast frames transmitted by the port
Rcv-Octet Number of octet frames received on the port
Xmit-Octet Number of octet frames transmitted by the port
Dely-Exced Number of transmit frames aborted due to excessive deferral
MTU-Exced Number of frames for which the MTU size was exceeded
In-Discard Number of incoming frames that were discarded because the frame did not
need to be switched
Lrn-Discard Number of outbound packets chosen to be discarded even though no errors had
been detected to prevent transmission
In-Lost Number of incoming frames
Out-Lost Number of outbound packets

Related Commands clear counters

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-523
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port negotiation

show port negotiation

Use the show port negotiation command to display the link negotiation protocol setting for a specified
port.

show port negotiation [mod_num[/port_num]]

Syntax Description mod_num (Optional) Number of the module.

/port_num (Optional) Number of the port on the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines This command is supported on Gigabit Ethernet and some Fast Ethernet ports. If the port does not
support the command, the following message appears (where N/N is the module and port number):
Feature not supported on Port N/N.

Examples This example shows how to display the link negotiation protocol settings on module 3, port 1:
Console> show port negotiation 3/1
Port Link Negotiation
------- --------------------
3/1 enabled
Console>

Related Commands set port negotiation

show port flowcontrol

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-524 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port protocol

show port protocol

Use the show port protocol command to view protocol filters configured on the ports.

show port protocol [mod_num[/port_num]]

Syntax Description mod_num (Optional) Number of the module.

/port_num (Optional) Number of the port on the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If you do not specify a port number, filters configured on all the ports on the module are shown.

Examples This example shows how to view protocol filters on configured ports:
Console> show port protocol
Port Vlan IP IP Hosts IPX IPX Hosts Group Group Hosts
-------- ---------- -------- -------- -------- --------- -------- -----------
1/1 1 on 0 on 0 on 0
1/2 1 on 0 on 0 on 0
2/1 1 on 3 auto-on 0 auto-on 0
2/2 1 on 0 on 0 on 0
2/3 1 on 0 on 0 on 0
2/4 1 on 0 on 0 on 0
2/5 1 on 0 on 0 on 0
2/6 1 on 0 on 0 on 0
2/7 1 on 0 on 0 on 0
2/8 1 on 0 on 0 on 0
2/9 1 on 0 on 0 on 0
2/10 1 on 0 on 0 on 0
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-525
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port protocol

This example shows how to view protocol filters on port 15 of module 3:

Console> (enable) show port protocol 3/15
Port Vlan IP IP Hosts IPX IPX Hosts Group Group
Hosts
-------- ---------- ------- -------- ----- -------- ----- --------
3/15 1000 auto-on 2 auto-off 0 auto-off 0

To:

Port Vlan AuxVlan IP IP IPX IPX Group Group

Status Hosts Status Hosts Status Hosts
-------- ---------- ------- -------- ----- -------- ----- -------- -----
3/15 1000 234 auto-on 2 auto-off 0 auto-off 0
Console> (enable)

Related Commands set port protocol

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-526 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port security

show port security

Use the show port security command to view port security configuration information and statistics.

show port security [mod_num[/port_num...]] [statistics]

Syntax Description mod_num Number of the module.

/port_num... Number of the ports.
statistics Keyword that specifies to display security statistics.

Defaults By default, configuration information is displayed.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you enter this command on a Token Ring port, the following message is generated:
Feature not supported for Module x.

Examples This example shows how to display port security configuration information on a secured port and
the output:
Console> (enable) show port security 4/1
Port Security Violation Shutdown-Time Age-Time Maximum-Addrs Trap IfIndex
----- -------- --------- ------------- -------- ------------- -------- -------
4/1 enabled shutdown 120 1440 25 disabled 3

Port Secure-Src-Addrs Age-Left Last-Src-Addr Shutdown Shutdown-Time-Left

---- ----------------- -------- ----------------- -------- ------------------
4/1 00-11-22-33-44-55 4 00-11-22-33-44-55 No -
00-10-14-da-77-f1 100

This example shows the output on a port that has experienced a security violation:
Console> (enable) show port security 4/1
Port Security Violation Shutdown-Time Age-Time Maximum-Addrs Trap IfIndex
----- -------- --------- ------------- -------- ------------- -------- -------
4/1 enabled shutdown 120 600 25 disabled 3

Port Secure-Src-Addrs Age-Left Last-Src-Addr Shutdown Shutdown-Time-Left

---- ----------------- -------- ----------------- -------- ------------------
4/1 00-11-22-33-44-55 60 00-11-22-33-44-77 Yes -
00-10-14-da-77-f1 200
00-11-22-33-44-66 200

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-527
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port security

This example shows that port 4/1 has been shut down and that the timeout left is 60 minutes before the
port will be reenabled:
Console> (enable) show port security 4/1
Port Security Violation Shutdown-Time Age-Time Maximum-Addrs Trap IfIndex
----- -------- --------- ------------- -------- ------------- -------- -------
4/1 enabled restrict 120 600 25 disabled 3

Port Secure-Src-Addrs Age-Left Last-Src-Addr Shutdown Shutdown-Time-Left

---- ----------------- -------- ----------------- -------- ------------------
4/1 00-11-22-33-44-55 60 00-11-22-33-44-77 Yes -
00-10-14-da-77-ff

Related Commands clear qos config

set port security

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-528 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port security statistics

show port security statistics

Use the show port security command to view port security configuration statistics.

show port security statistics [mod_num[mod_num/port_num]] [system]

Syntax Description mod_num Number of the module.

mod_num/port_num Number of the module and port.
system (Optional) Keyword to display systemwide configuration statistics.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you enter this command on a Token Ring port, the following message is generated:
Feature not supported for Module x.

Examples This example shows how to display port security configuration information on a secured port and
the output:
Console> (enable) show port security statistics system
Module 1:
Total ports: 4
Total MAC address(es): 4
Total global address space used (out of 1024): 0
Status: installed

Module 3:
Total ports: 24
Total MAC address(es): 24
Total global address space used (out of 1024): 0
Status: installed
Module 8:
Module does not support port security feature
Module 10:
Module does not support port security feature
Console> (enable)

Related Commands clear qos config

set port security

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-529
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port spantree

show port spantree

Use the show port spantree command to display port spanning tree information.

show port spantree [mod_num[/port_num]]

Syntax Description mod_num (Optional) Number of the module.

/port_num (Optional) Number of the port on the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If you do not specify mod, the ports on all modules are shown. If you do not specify a port, all the ports
on the module are shown.

Examples This example shows how to display spanning tree information on all ports on module 5:
Console> (enable) show port spantree 5
Port(s) Vlan Port-State Cost Prio Portfast Channel_id
------------------------ ---- ------------- --------- ---- -------- ----------
5/1 1 not-connected 2684354 32 disabled 0
5/2 1 not-connected 2684354 32 disabled 0
5/3 1 not-connected 2684354 32 disabled 0
5/4 1 not-connected 2684354 32 disabled 0
5/5 1 not-connected 2684354 32 disabled 0
5/6 1 not-connected 2684354 32 disabled 0
5/7 1 not-connected 2684354 32 disabled 0
5/8 1 not-connected 2684354 32 disabled 0
5/9 1 forwarding 268435 32 disabled 0

Related Commands show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-530 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port status

show port status

Use the show port status command to display port status information.

show port status [mod_num[/port_num]]

Syntax Description mod_num (Optional) Number of the module.

/port_num (Optional) Number of the port on the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If you do not specify a module number, the ports on all modules are shown.
If you do not specify a port number, all the ports on a specified module are shown.

Examples This example shows how to display port status information for all ports on all modules:
Console> show port status
Port Name Status Vlan Level Duplex Speed Type
----- ------------------ ---------- ---------- ------ ------ ----- ------------
1/1 connected 523 normal half 100 100BaseTX
1/2 notconnect 1 normal half 100 100BaseTX
2/1 connected trunk normal half 400 Route Switch
3/1 notconnect trunk normal full 155 OC3 MMF ATM
5/1 notconnect 1 normal half 100 FDDI
5/2 notconnect 1 normal half 100 FDDI
Console>

Table 2-49 describes the fields in the show port status command output.

Table 2-49 show port status Command Output Fields

Field Description
Port Module and port number
Name Name (if configured) of the port
Status Status of the port (connected, notconnect, connecting, standby, faulty,
inactive, shutdown, disabled, or monitor)
Vlan VLAN to which the port belongs
Level Level setting for the port (normal or high)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-531
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port status

Table 2-49 show port status Command Output Fields (continued)

Field Description
Duplex Duplex setting for the port (auto, full, fdx, half, hdx, a-half, a-hdx, a-full,
or a-fdx)
Speed Speed setting for the port (auto, 10, 100, 155, 400, a-10, a-100, 4, 16, a-14,
or a-16)
Type1 Port type (for example, 10BASE-T, 10BaseFL MM, 100BASE-TX,
100BASE-T4, 100BASE-FX MM, 100BASE-FX SM, 10/100BASE-TX,
TokenRing, FDDI, CDDI, OC3, MMF, ATM, or RSM)
1. The types will change according to the system configuration.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-532 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port trap

show port trap

Use the show port trap command to display port trap status.

show port trap [mod_num[/port_num]]

Syntax Description mod_num (Optional) Number of the module.

/port_num (Optional) Number of the port on the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If you do not specify mod, the ports on all modules are shown. If you do not specify port, all the ports
on a specified module are shown.

Examples This example shows how to display port trap status for all ports on module 1:
Console> show port trap 1

Port Trap
----- --------
1/1 disabled
1/2 enabled
1/3 disabled
1/4 disabled
Console>

Related Commands set port trap

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-533
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port trunk

show port trunk

Use the show port trunk command to display port trunk information.

show port trunk [mod_num/port_num]

Syntax Description mod_num (Optional) Number of the module.

/port_num (Optional) Number of the port on the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If you do not specify mod, the ports on all modules are shown. If you do not specify port, all the ports
on a specified module are shown.

Examples This example shows how to display trunking information for module 4, port 5:
Console> (enable) show port trunk 4/5
* - indicates vtp domain mismatch

Port Mode Encapsulation Status Native vlan

-------- ----------- ------------- ------------ -----------
4/5 nonegotiate dot1q trunking 1

Port Vlans allowed on trunk

-------- ---------------------------------------------------------------------
4/5 1-1005

Port Vlans allowed and active in management domain

-------- ---------------------------------------------------------------------
4/5 1-3,1003,1005

Port Vlans in spanning tree forwarding state and not pruned

-------- ---------------------------------------------------------------------
4/5 1005
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-534 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show port trunk

Table 2-50 describes the fields in the show port trunk command output.

Table 2-50 show port trunk Command Output Fields

Field Description
Port Module and port numbers
Mode Trunk administrative status of the port (on, off, auto, nonnegotiate, or
desirable)
Encapsulation Trunking type configured by administration
Status Status of whether the port is trunking or nontrunking
Native VLAN Number of the native VLAN for the trunk link (for 802.1Q trunks, the
VLAN for which untagged traffic can be transmitted and received
over the trunk; for ISL trunks, packets are tagged on all VLANs,
including the native VLAN)
Vlans allowed on trunk Range of VLANs allowed to go on the trunk (valid values are 1 to
1000)
Vlans allowed and active in Range of active VLANs within the allowed range
management domain
Vlans in spanning tree Range of VLANs that actually go on the trunk with Spanning Tree
forwarding state and not Protocol forwarding state
pruned

Related Commands show trunk

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-535
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show proc

show proc
Use the show proc command to display CPU, memory allocation, and process utilization information.

show proc [cpu | mem] {mod_num}

Syntax Description cpu (Optional) Keyword that specifies CPU information.

mem (Optional) Keyword that specifies malloced memory information.
mod_num Number of the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines This command can only be entered in privileged mode. If you do not specify cpu or mem, process
information is displayed.
The mem keyword allows you to display malloced memory information, such as how much each process
has allocated and how much memory it has freed can be obtained.

Examples This example shows how to display CPU information:

Console> (enable) show proc cpu

CPU utilization for five seconds: 1.44%

one minute: 1.96%
five minutes: 1.02%

PID Runtime(ms) Invoked uSecs 5Sec 1Min 5Min TTY Process

--- ----------- ---------- -------- ------- ------- ------- --- ---------------
1 0 0 0 98.56% 98.04% 98.98% 0 Kernel and Idle
2 4 38 1000 0.00% 0.00% 0.00% 0 Flash MIB Updat
3 1421 5547 466000 0.00% 0.00% 0.00% 0 SynDiags
4 166212 519822 19000 0.22% 0.00% 0.00% 0 SynConfig
5 185 94681 1000 0.00% 0.00% 0.00% 0 Statuspoll
6 472 297 0 0.00% 0.00% 0.00% 0 SWPoll64bCnt
7 90 3548211 1000 0.00% 0.00% 0.00% 0 SL_TASK
8 113 141960 106000 0.00% 0.00% 0.00% 0 RedundantTask
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-536 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show proc

This example shows how to display process information:

Console> (enable) show proc mem

Memory Used: 1281040

Freed: 9597104
Total: 10878144

PID TTY Allocated Freed Holding Process

---------- ---------- ---------- ---------- ---------- ---------------
1 0 711008 2832 708176 Kernel and Idle
2 0 240 0 240 Flash MIB Updat
3 0 284128 283712 416 SynDiags
4 0 211856 1920 209936 SynConfig
5 0 96 0 96 Statuspoll
6 0 4944 4352 592 SWPoll64bCnt
7 0 80 0 80 SL_TASK
8 0 2272 1952 320 RedundantTask
Console> (enable)

This example shows how to display process utilization information:

Console> (enable) show proc

CPU utilization for five seconds: 0.44%

one minute: 1.00%
five minutes: 1.00%

PID Q T PC Runtime(ms) Invoked uSecs Stacks TTY Process

--- -- -- ---------- ----------- -------- ------- --------- --- ---------------
1 1 rd 0x8041ab80 0 0 0 1580/6144 0 Kernel and Idle
2 1 st 0x8041adfc 4 38 1000 1604/6144 0 Flash MIB Updat
3 2 st 0x8041adfc 1421 5547 466000 3364/6144 0 SynDiags
4 1 si 0x8041adfc 166438 520543 19000 1764/6144 0 SynConfig
5 2 si 0x8041adfc 186 94812 1000 1576/6144 0 Statuspoll
6 4 si 0x8041adfc 472 297 0 244/6144 0 SWPoll64bCnt
7 2 si 0x8041adfc 92 3553068 1000 904/6144 0 SL_TASK
8 2 si 0x8041adfc 113 142157 106000 1172/6144 0 RedundantTask
Console> (enable)

Table 2-51 describes the possible fields in the show proc command outputs.

Table 2-51 show proc Command Output Fields

Field Definition
CPU Sum of all the loads from all the processes running on the CPU in the last 5
Utilization seconds, 1 minute, and 5 minutes.
PID Process ID.
Runtime Time the process has run since being created (in milliseconds).
Invoked Number of times the process has been invoked since being created.
uSecs Maximum time a process ran in a single invocation.
5sec Percentage of time this process ran on the CPU in the last 5 second interval.
1Min Percentage of time this process ran on the CPU in the last 1 minute interval.
5Min Percentage of time this process ran on the CPU in the last 5 minute interval.
TTY TTY associated with the process.
Process Name of the process.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-537
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show proc

Table 2-51 show proc Command Output Fields (continued)

Field Definition
Allocated Sum of all the memory malloced by the process since it was created, and
includes the memory previously freed.
Freed Sum of memory the process has freed until now.
Holding Amount of memory the process is currently holding.
PC Calling PC for “show_process” function.
Q Process priority in terms of numbers. A low number means high priority.
T State of the process (Running, we=waiting for event, st=sleeping, si=sleeping
on an interval, rd=ready to run, id=idle, xx=dead/zombie).
Stacks Size of the stack used by the process, or the total stack size allocated to the
process (in bytes).

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-538 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show protocolfilter

show protocolfilter
Use the show protocolfilter command to determine whether protocol filtering is enabled or disabled.

show protocolfilter

Syntax Description This command has no keywords or arguments.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display whether protocol filtering is enabled or disabled:
Console> show protocolfilter
Protocol filtering is enabled on this switch.
Console>

Related Commands set port protocol

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-539
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show pvlan

show pvlan
Use the show pvlan command to show the configuration for a specified private VLAN (PVLAN).

show pvlan [vlan | primary | isolated | community | twoway-community]

Syntax Description vlan (Optional) Number of the private VLAN.

primary (Optional) Keyword to display the primary private VLANs.
isolated (Optional) Keyword to display the isolated private VLANs.
community (Optional) Keyword to display the community private VLANs.
twoway-community (Optional) Keyword to display the bidirectional community private VLANs.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines A twoway-community PVLAN is a bidirectional community PVLAN that carries traffic among
community ports and to and from community ports to and from the supervisor engine.

Examples This example shows how to display the status for VLAN 10:
Console> show pvlan 10
Primary Secondary Secondary-Type Ports
------- --------- -------------- ------------
10 20 isolated 6/1
Console>

This example shows how to display the status for all VLANs set as primary:
Console> show pvlan primary
Primary Secondary Secondary-Type Ports
------- --------- -------------- ------------
10 20 isolated 6/1
11 21 isolated 6/2
30 - -
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-540 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show pvlan

This example shows how to display the status for all VLANs set as isolated:
Console> show pvlan isolated
Primary Secondary Secondary-Type Ports
------- --------- -------------- ------------
10 20 isolated 6/1
11 21 isolated 6/2
- 31 isolated
Console>

This example shows how to display the status for all VLANs set as community:
Console> show pvlan community
Primary Secondary Secondary-Type Ports
------- --------- -------------- ------------
7 902 community 2/4-6
Console>

Related Commands clear config pvlan

clear pvlan mapping
clear vlan
set pvlan
set pvlan mapping
set vlan
show pvlan capability
show pvlan mapping
show vlan

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-541
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show pvlan capability

show pvlan capability

Caution Use the show pvlan capability command to determine whether a port can be made a PVLAN port.

show pvlan capability mod/port

Syntax Description mod/port Number of the module and the port on the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to determine if port 20 on module 5 can be made into a PVLAN:
Console> (enable) show pvlan capability 5/20
Ports 5/13 - 5/24 are in the same ASIC range as port 5/20.

Port 5/20 can be made a private vlan port.

Console> (enable)

These examples show the output if a port cannot be made into a PVLAN:
Console> (enable) show pvlan capability 3/1
Port 3/1 cannot be made a private vlan port due to:
------------------------------------------------------
Promiscuous ports cannot be made private vlan ports.
Console> (enable)

Console> (enable) show pvlan capability 5/1

Ports 5/1 - 5/12 are in the same ASIC range as port 5/1.

Port 5/1 cannot be made a private vlan port due to:

------------------------------------------------------
Trunking ports are not Private Vlan capable.
Conflict with Promiscuous port(s) : 5/2
Console> (enable)

Console> (enable) show pvlan capability 5/2

Ports 5/1 - 5/12 are in the same ASIC range as port 5/2.

Port 5/2 cannot be made a private vlan port due to:

------------------------------------------------------
Promiscuous ports cannot be made private vlan ports.
Conflict with Trunking port(s) : 5/1
Console> (enable)

Console> (enable) show pvlan capability 5/3

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-542 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show pvlan capability

Ports 5/1 - 5/12 are in the same ASIC range as port 5/3.

Port 5/3 cannot be made a private vlan port due to:

------------------------------------------------------
Conflict with Promiscuous port(s) : 5/2
Conflict with Trunking port(s) : 5/1
Console> (enable)

Console> (enable) show pvlan capability 15/1

Port 15/1 cannot be made a private vlan port due to:
------------------------------------------------------
Only ethernet ports can be added to private vlans.
Console> (enable)

Related Commands clear config pvlan

clear pvlan mapping
clear vlan
set pvlan
set pvlan mapping
set vlan
show pvlan
show pvlan mapping
show vlan

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-543
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show pvlan mapping

show pvlan mapping

Use the show pvlan mapping command to show the PVLAN mappings configured on promiscuous
ports.

show pvlan mapping [private_vlan | mod/port]

Syntax Description private_ vlan (Optional) Number of the private VLAN.

mod/port (Optional) Number of the module and port.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the private VLAN mapping by port:
Console> show pvlan mapping
Port Primary Secondary
---- ------- ---------
6/3 10 20
Console>

This example shows how to display a private VLAN mapping for VLAN 10:
Console> show pvlan mapping 10
Primary Secondary Ports
------- --------- -----
10 20 6/3
Console>

This example shows how to display the private VLAN mapping for port 3 on module 6:
Console> show pvlan mapping 6/3
Port Primary Secondary
---- ------- ---------
6/3 10 20
Console>

This example shows the results when no VLANs are mapped:

Console> show pvlan mapping
Port Primary Secondary
---- ------- ---------
No Private Vlan Mappings configured.
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-544 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show pvlan mapping

Related Commands clear config pvlan

clear pvlan mapping
clear vlan
set pvlan
set pvlan mapping
set vlan
show pvlan
show pvlan capability
show vlan

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-545
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show qos info

show qos info

Use the show qos info command to display Quality of Service (QoS) related information for a specified
port.

show qos info {runtime | config}

Syntax Description runtime Keyword that specifies to show the current QoS run time information.
config Keyword that specifies to show the NVRAM setting of QoS.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines The show qos info runtime command display shows both the absolute values and the percentages that
you specified for the drop thresholds, queue sizes, and WRR. However, because of the precision
limitations of the hardware, the absolute values may not exactly match the percentages specified.

Examples This example shows how to display current QoS configuration information:
Console> show qos info config
QoS setting in NVRAM:
QoS is enabled
All ports have 2 transmit queues with 1 drop thresholds (2q1t).
Default CoS = 4
Queue and Threshold Mapping:
Queue Threshold CoS
----- --------- ---------------
1 1 0 1 2 3
2 1 4 5 6 7
Console>

Related Commands set qos

set qos map

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-546 78-12648-03
 2
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show qos status

show qos status

Use the show qos status command to display whether Quality of Service (QoS) is enabled or disabled.

show qos status

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows the output from the show qos status command:
Console> (enable) show qos status
QoS is disabled on this switch.
Console> (enable) set qos enable
QoS is enabled.
Console> (enable) show qos status
QoS is enabled on this switch.

Related Commands set qos

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-547
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show radius

show radius
Use the show radius command to display configured RADIUS parameters.

show radius [noalias]

Syntax Description noalias (Optional) Keyword that forces the display to show IP addresses, not IP aliases.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines This command can be entered in Normal or Privileged mode, but the RADIUS key is displayed only if
the command is entered in Privileged mode.

Examples This example shows how to display RADIUS information:

Console> (enable) show radius
Login Authentication: Console Session Telnet Session
--------------------- ---------------- ---------------
tacacs disabled disabled
radius enabled(primary) enabled(primary)
local enabled enabled
Enable Authentication: Console Session Telnet Session
---------------------- ---------------- ---------------
tacacs disabled disabled
radius enabled(primary) enabled(primary)
local enabled enabled
Radius deadtime: 0 minutes
Radius key: hello
Radius retransmit: 3
Radius timeout: 5 seconds
Radius-Server Status Auth-port Acct-port
------------------- ------- --------- ---------
198.32.67.9 primary 1645 1813
172.31.11.12 1645 1646
Console> (enable)

Related Commands set qos

set radius key
set radius retransmit
set radius server
set radius timeout

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-548 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show rcp

show rcp
Use the show rcp command to display remote copy protocol (rcp) information.

show rcp

Syntax Description This command has no keywords or arguments.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display rcp information:

Console> (enable) show rcp
rcp username for VMPS :xena
rcp username for others :jdoe
Console> (enable)

Related Commands clear rcp

set rcp username

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-549
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show reset

show reset
Use the show reset command to display scheduled reset information.

show reset

Syntax Description This command has no keywords or arguments.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display scheduled reset information:

Console> (enable) show reset
Reset schedule for Fri Jan 21 2000, 23:00:00 (in 3 days 12 hours 56 minutes 57 s
econds).
Reset reason: Software upgrade
Console> (enable)

Related Commands reset—switch

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-550 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show rspan

show rspan
Use the show rspan command to display the remote SPAN configuration.

show rspan

Syntax Description This command has no keywords or arguments.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines Which fields are displayed depends on the configuration. For example, if this is a source session, the
Destination, Incoming Packets, and Learning fields are not displayed. If this is a destination session, the
Admin Source, Oper Source, Direction, Multicast, Filter, and Max Bandwidth fields are not displayed.
If there is no VLAN filtering on the source session, the Filter field is not displayed.

Examples This example shows the display output from the show rspan command:
Console> (enable) show rspan

Destination : -
Rspan Vlan : 900
Admin Source : VLAN 50
Oper Source : Port 2/1,2/3,2/5,2/7,2/9,2/11,2/13,2/15,2/17,2/19
Direction : receive
Incoming Packets: -
Learning : -
Multicast : disabled
Filter : 10,20,30,40,500,600,700,800,900
Status : active

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

Destination : Port 3/1

Rspan Vlan : 901
Admin Source : -
Oper Source : -
Direction : -
Incoming Packets: disabled
Learning : disabled
Multicast : -
Filter : -
Status : active
--------------------------------------------

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-551
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show rspan

Destination : Port 6/1

Rspan Vlan : 906
Admin Source : -
Oper Source : -
Direction : -
Incoming Packets: disabled
Learning : -
Multicast : -
Filter : -

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

Destination : -
Rspan Vlan : 903
Admin Source : INBAND
Oper Source : INBAND
Direction : transmit
Incoming Packets: -
Learning : -
Multicast : disabled
Filter : -

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

Destination : Port 7/1

Rspan Vlan : 902
Admin Source : -
Oper Source : -
Direction : -
Incoming Packets: enabled
Learning : -
Multicast : -
Filter : -
Console> (enable)

Related Commands set rspan

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-552 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show running-config

show running-config
Use the show running-config command to display the configuration information currently running on
the switch or the configuration for a specific Access Control List (ACL).

show running-config [system | mod_num] [all]

Syntax Description system (Optional) Keyword that specifies to display system configuration.
mod_num (Optional) Number of the module.
all (Optional) Keyword that specifies all modules and system configuration
information, including the IP address.

Defaults By default, this command shows only nondefault configurations. To view the entire configuration, use
the keyword all.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to display the nondefault system and module configuration:
Console> (enable) show running-config
This command shows non-default configurations only.
Use 'show running-config all' to show both default and non-default configurations.
............

....................
..................
..

begin
!
# ***** NON-DEFAULT CONFIGURATION *****
!
!
#time: Wed May 9 2001, 15:23:22
!
#version 6.3(0.40)PAN
!
!
#system web interface version(s)
!
#test
set test diaglevel minimal
!
#system
set system countrycode GB
!
#frame distribution method
set port channel all distribution mac both

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-553
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show running-config

!
#snmp
set snmp access catherine security-model v1 read defaultAdminView nonvolatile
!
#tacacs+
set tacacs attempts 5
!
#kerberos
set kerberos local-realm help
!
<<<< output truncated >>>>
#switch port analyzer
set span 522 2/12 both inpkts enable learning enable create
set rspan source 2/3 500 rx reflector 2/34 create
set rspan destination 3/1 500 inpkts disable learning enable create
end
Console> (enable)

This example shows how to display the nondefault system configuration for module 3:
Console> (enable) show running-config 3
This command shows non-default configurations only.
Use 'show running-config <mod> all' to show both default and non-default configurations.
..................
begin
!
# ***** NON-DEFAULT CONFIGURATION *****
!
!
#time: Wed May 9 2001, 15:20:26
!
#module 3 : 6-port 1000BaseX Ethernet
set vlan 1 3/1
set trunk 3/4 on dot1q 1-1005
end
Console> (enable)

Related Commands clear config—switch

write

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-554 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp

show snmp
Use the show snmp command to display SNMP information.

show snmp [noalias]

Syntax Description noalias (Optional) Keyword that forces the display of IP addresses, not IP aliases.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display SNMP information:

Console> show snmp
RMON: Enabled
Extended Rmon: Extended RMON module is not present
Traps Enabled: Chassis
Port Traps Enabled: None

Community-Access Community-String
---------------- --------------------
read-only public
read-write private
read-write-all secret

Trap-Rec-Address Trap-Rec-Community
---------------------------------------- --------------------
192.122.173.42 public
Console>

Table 2-52 describes the fields in the show snmp command output. The fields displayed depend on the
port type queried.

Table 2-52 show snmp Command Output Fields

Field Description
RMON RMON statistics (enabled or disabled)
Extended RMON Extended RMON statistics (enabled or disabled)
Traps Enabled Trap types that are enabled
Port Traps Enabled Set of ports whose linkup/linkdown trap is enabled
Community-Access Configured SNMP communities
Community-String SNMP community strings associated with each SNMP community

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-555
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp

Table 2-52 show snmp Command Output Fields (continued)

Field Description
Trap-Rec-Address IP address or IP alias of trap receiver hosts
Trap-Rec-Community SNMP community string used for trap messages to the trap receiver

Related Commands set snmp rmon

set snmp trap

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-556 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp access

show snmp access

Use the show snmp access command to display SNMP access information.

show snmp access [volatile | nonvolatile | read-only]

show snmp access [-hex] groupname security-model {v1 | v2c}

show snmp access [-hex] groupname security-model v3 {noauthentication | authentication |

privacy}

Syntax Description volatile (Optional) Keyword that displays information for volatile storage
types.
nonvolatile (Optional) Keyword that displays information for nonvolatile storage
types.
read-only (Optional) Keyword that displays information for read-only storage
types.
-hex (Optional) Keyword that displays groupname as a hexadecimal
character.
groupname Name of the SNMP group or collection of users who have a common
access policy.
security-model v1 | Keywords that specify security model v1, v2c, or v3.
v2c | v3
noauthentication Keyword that displays information for security models not set to use
authentication protocol.
authentication Keyword that displays information for authentication protocol.
privacy Keyword that displays information regarding messages sent on behalf
of the user that are protected from disclosure.

Defaults The default storage type is volatile.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you use special characters for the groupname (nonprintable delimiters for these parameters), you must
use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:), such as
00:ab:34.
The read-only keyword is supported for security model v3 only.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-557
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp access

Examples This example shows how to display SNMP access information:

Console> (enable) show snmp access
Group Name: defaultROgroup
Context:
Security Model: v1
Security Level: noauthentication
Context Match: exact
Read View: defaultUserView
Write View:
Notify View: defaultUserView
Storage Type: read-only
Row Status: active

Group Name: defaultROgroup

Context:
Security Model: v2c
Security Level: noauthentication
Context Match: exact
Read View: defaultUserView
Write View:
Notify View: defaultUserView
Storage Type: read-only
Row Status: active
Console> (enable)

Related Commands clear snmp access

set snmp access

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-558 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp community

show snmp community

Use the show snmp community command to display SNMP community information.

show snmp community

show snmp community [read-only | volatile | nonvolatile]

show snmp community index [-hex] {index name}

Syntax Description read-only (Optional) Keyword to specify that the community is defined as read
only.
volatile (Optional) Keyword to specify that the community type is defined as
temporary memory and the content is deleted if the device is turned
off.
nonvolatile (Optional) Keyword to specify that the community type is defined as
persistent memory and the content remains after the device is turned
off and on again.
index Keyword to specify the name of the community index.
-hex (Optional) Keyword to display index name as a hexadecimal
character.
index name Name of the community index.

Defaults By default, this command displays all table entries.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display SNMP community information:

Console> (enable) show snmp community
Community Index: sysCommunityRo.0
Community Name: public
Security Name: public
Context Name:
Transport Tag:
Storage Type: read-only
Row Status: active

Community Index: sysCommunityRw.0

Community Name: private
Security Name: private
Context Name:
Transport Tag:
Storage Type: read-only
Row Status: active

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-559
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp community

Community Index: sysCommunityRwa.0

Community Name: secret
Security Name: secret
Context Name:
Transport Tag:
Storage Type: read-only
Row Status: active

Console> (enable)

Related Commands clear snmp community

set snmp community

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-560 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp context

show snmp context

Use the show snmp context command to display SNMP context information.

show snmp context

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display SNMP context information:

Console> (enable) show snmp context
Index Context
----- --------
0
1 vlan-1
2 vlan-55
3 vlan-1002
4 vlan-1003
5 vlan-1004
6 vlan-1005
Console> (enable)

Related Commands clear snmp access

set snmp access
show snmp access

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-561
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp counters

show snmp counters

Use the show snmp counters command set to display SNMP counter information.

show snmp counters [v3 | {mod/port} {dot1d | dot3 | hcrmon | ifmib | rmon}]

Syntax Description v3 (Optional) Keyword to specify SNMPv3 counters.

mod Module number.
port Port number.
dot1d (Optional) Keyword to specify dot1d counters.
dot3 (Optional) Keyword to specify dot3 counters.
hcrmon (Optional) Keyword to specify HCRMON counters.
ifmib (Optional) Keyword to specify if-MIB counters.
rmon (Optional) Keyword to specify RMON counters.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display all SNMP counters:

Console> show snmp counters
mib2 SNMP group counters:
snmpInPkts = 13993
snmpOutPkts = 13960
snmpInBadVersions = 0
snmpInBadCommunityNames = 33
snmpInBadCommunityUses = 0
snmpInASNParseErrs = 0
snmpInTooBigs = 0
snmpInNoSuchNames = 0
snmpInBadValues = 0
snmpInReadOnlys = 0
snmpInGenErrs = 0
snmpInTotalReqVars = 61747
snmpInTotalSetVars = 0
snmpInGetRequests = 623
snmpInGetNexts = 13337
snmpInSetRequests = 0
snmpInGetResponses = 0
snmpInTraps = 0
snmpOutTooBigs = 0
snmpOutNoSuchNames = 230
snmpOutBadValues = 0
snmpOutGenErrs = 0
snmpOutGetRequests = 0

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-562 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp counters

snmpOutGetNexts = 0
snmpOutSetRequests = 0
snmpOutGetResponses = 13960
snmpOutTraps = 0
Console>

Table 2-53 describes the fields in the show snmp counters command output.

Table 2-53 show snmp counters Command Output Fields

Field Description
snmpInPkts Number of messages delivered to the SNMP entity from the
transport service
snmpOutPkts Number of SNMP messages passed from the SNMP protocol
entity to the transport service
snmpInBadVersions Number of SNMP messages delivered to the SNMP entity for
an unsupported SNMP version
snmpInBadCommunityNames Number of SNMP messages delivered to the SNMP entity that
used an SNMP community name not known to said entity
snmpInBadCommunityUses Number of SNMP messages delivered to the SNMP entity that
represented an SNMP operation not allowed by the SNMP
community named in the message
snmpInASNParseErrs Number of ASN.1 or BER errors encountered by the SNMP
entity when decoding received SNMP messages
snmpInTooBigs Number of SNMP PDUs delivered to the SNMP protocol entity
with the value of the error-status field as “tooBig”
snmpInNoSuchNames Number of SNMP PDUs delivered to the SNMP protocol entity
with the value of the error-status field as “noSuchName”
snmpInBadValues Number of SNMP PDUs delivered to the SNMP protocol entity
with the value of the error-status field as “badValue”
snmpInReadOnlys1 Number of valid SNMP PDUs delivered to the SNMP protocol
entity with the value of the error-status field as “readOnly”
snmpInGenErrs Number of SNMP PDUs delivered to the SNMP protocol entity
with the value of the error-status field as “genErr”
snmpInTotalReqVars Number of MIB objects retrieved successfully by the SNMP
protocol entity as the result of receiving valid SNMP
Get-Request and Get-Next PDUs
snmpInTotalSetVars Number of MIB objects altered successfully by the SNMP
protocol entity as the result of receiving valid SNMP
Set-Request PDUs
snmpInGetRequests Number of SNMP Get-Request PDUs accepted and processed
by the SNMP protocol entity
snmpInGetNexts Number of SNMP Get-Next PDUs accepted and processed by
the SNMP protocol entity

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-563
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp counters

Table 2-53 show snmp counters Command Output Fields (continued)

Field Description
snmpInSetRequests Number of SNMP Set-Request PDUs accepted and processed
by the SNMP protocol entity
snmpInGetResponses Number of SNMP Get-Response PDUs accepted and processed
by the SNMP protocol entity
snmpInTraps Number of SNMP Trap PDUs accepted and processed by the
SNMP protocol entity
snmpOutTooBigs Number of SNMP PDUs generated by the SNMP protocol
entity with the value of the error-status field as “tooBig”
snmpOutNoSuchNames Number of SNMP PDUs generated by the SNMP protocol
entity with the value of the error-status as “noSuchName”
snmpOutBadValues Number of SNMP PDUs generated by the SNMP protocol
entity with the value of the error-status field as “badValue”
snmpOutGenErrs Number of SNMP PDUs generated by the SNMP protocol
entity with the value of the error-status field as “genErr”
snmpOutGetRequests Number of SNMP Get-Request PDUs generated by the SNMP
protocol entity
snmpOutGetNexts Number of SNMP Get-Next PDUs generated by the SNMP
protocol entity
snmpOutSetRequests Number of SNMP Set-Request PDUs generated by the SNMP
protocol entity
snmpOutGetResponses Number of SNMP Get-Response PDUs generated by the SNMP
protocol entity
snmpOutTraps Number of SNMP Trap PDUs generated by the SNMP protocol
entity
1. It is a protocol error to generate an SNMP PDU that contains the value “readOnly” in the error-status field. This object is
provided as a means of detecting incorrect implementations of the SNMP.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-564 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp engineid

show snmp engineid

Use the show snmp engineid command to display the SNMP local engine ID.

show snmp engineid

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If the SNMP engine ID is cleared, the system automatically regenerates a local SNMP engine ID.
The SNMP engine and the SNMP entity have a one-to-one mapping. You can also identify the SNMP
entity, which is represented as hexadecimal numbers only, and must be from 5 to 32 bytes long; for
example, 00:00:00:09:0a:fe:ff:12:97:33:45:12.

Examples This example shows how to display the SNMP engine ID:
Console> (enable) show snmp engineid
EngineId: 00:00:00:09:00:d0:00:4c:18:00
Engine Boots: 1234455
Console> (enable)

Table 2-54 describes the fields in the show snmp engineid command output.

Table 2-54 show snmp engineid Command Output Fields

Field Description
EngineId String identifying the name of the SNMP copy on the device
Engine Boots Number of times an SNMP engine has been started or reinitialized

Related Commands show snmp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-565
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp group

show snmp group

Use the show snmp group command to display the name of the SNMP group or collection of users who
have a common access policy.

show snmp group [volatile | nonvolatile | read-only]

show snmp group {-hex} {groupname} user {-hex} {username} {security-model

{v1 | v2c | v3}}

Syntax Description volatile (Optional) Keyword that specifies that the storage type is defined as
temporary memory and the content is deleted if the device is turned off.
nonvolatile (Optional) Keyword that specifies that the storage type is defined as
persistent memory and the content remains after the device is turned off
and on again.
read-only (Optional) Keyword that specifies that the storage type is read-only.
groupname Name of the SNMP group or collection of users who have a common
access policy.
user Keyword that specifies a SNMP group.
-hex Keyword that displays groupname and username as a hexadecimal
character.
username Keyword that specifies the SNMP group user name.
security-model Keywords that specify security model v1, v2c, or v3.
v1 | v2c | v3

Defaults The default storage type is volatile.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you use special characters for the groupname and username variables (nonprintable delimiters for
these parameters), you must use a hexadecimal keyword, which is one or two hexadecimal digits
separated by a colon (:); for example, 00:ab:34.

Examples This example shows how to display the SNMP group:

Console> (enable) show snmp group
Security Model: v1
Security Name: public
Group Name: defaultROgroup
Storage Type: volatile
Row Status: active

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-566 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp group

Security Model: v1
Security Name: secret
Group Name: defaultRWALLgroup
Storage Type: volatile
Row Status: active

Security Model: v1
Security Name: private
Group Name: defaultRWgroup
Storage Type: volatile
Row Status: active

Security Model: v2c

Security Name: public
Group Name: defaultROgroup
Storage Type: volatile
Row Status: active
Console> (enable)

Table 2-55 describes the fields in the show snmp group command output.

Table 2-55 show snmp group Command Output Fields

Field Description
Security Model Security model used by the group
Security Name Security string definition
Group Name Name of the SNMP group or collection of users who have a
common access policy
Storage Type Keyword to indicate whether the settings are volatile or nonvolatile
Row Status Status of the entry

Related Commands clear snmp group

set snmp group

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-567
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp notify

show snmp notify

Use the show snmp notify command to display the snmpNotifyTable configuration.

show snmp notify [volatile | nonvolatile | read-only]

show snmp notify {-hex} {notifyname}

Syntax Description volatile (Optional) Keyword that specifies that the storage type is defined as
temporary memory and the content is deleted if the device is turned off.
nonvolatile (Optional) Keyword that specifies that the storage type is defined as
persistent memory and the content remains after the device is power
cycled.
read-only (Optional) Keyword that specifies that the storage type is read-only.
-hex Keyword that displays notifyname as a hexadecimal character.
notifyname A unique identifier that indexes the snmpNotifyTable.

Defaults The default is that storage type is nonvolatile.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you use special characters for the notifyname variable (nonprintable delimiters for this parameter), you
must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for
example, 00:ab:34.

Examples This example shows how to display the SNMP notify information for a specific notifyname:
Console> (enable) show snmp notify snmpV1Notification
Notify Name: snmpV1Notification
Notify Tag: snmpV1Trap
Notify Type: trap
Storage Type: volatile
Row Status: active
Console> (enable)

Table 2-56 describes the fields in the show snmp notify command output.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-568 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp notify

Table 2-56 show snmp notify Command Output Fields

Field Description
Notify Name Unique identifier used to index the snmpTargetAddrTable
Notify Tag Specifies selected entries in the snmpTargetAddrTable
Notify Type Trap: all messages generated contain SNMPv2-Trap PDUs
Inform: all messages generated contain InfoRequest PDUs
Storage Type Indicates whether the settings are volatile or nonvolatile
Row Status Status of the entry

Related Commands clear snmp notify

set snmp notify

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-569
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp targetaddr

show snmp targetaddr

Use the show snmp targetaddr command to display the SNMP target address entries in the
snmpTargetAddressTable.

show snmp targetaddr [volatile | nonvolatile | read-only]

show snmp targetaddr {-hex} {addrname}

Syntax Description volatile (Optional) Keyword that specifies that the storage type is defined as
temporary memory and the content is deleted if the device is turned off.
nonvolatile (Optional) Keyword that specifies that the storage type is defined as
persistent memory and the content remains after the device is power
cycled.
read-only (Optional) Keyword that specifies that the storage type is read-only.
-hex Keyword that displays addrname as a hexadecimal character.
addrname The arbitrary but unique name of the target agent; the maximum length is
32 bytes.

Defaults By default, the storage type is nonvolatile.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you use special characters for the addrname variable (nonprintable delimiters for this parameter), you
must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for
example, 00:ab:34.
The read-only keyword is supported for security model v3 only.

Examples This example shows how to display specific target address information in the snmpTargetAddressTable:
Console> (enable) show snmp targetaddr cisco
Target Address Name: cisco
IP Address: 170.0.25.1
UDP Port#: 165
Timeout: 100
Retry count: 5
Tag List: tag1 tag2 tag3
Parameters: jeorge
Storage Type: nonvolatile
Row Status: active
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-570 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp targetaddr

Table 2-57 describes the fields in the show snmp targetaddr command output.

Table 2-57 show snmp targetaddr Command Output Fields

Field Description
Target Address Name Name of the target address
IP Address Target IP address
UDP Port# Number of the UDP port of the target host to use
Timeout Number of timeouts
Retry count Number of retries
Tag List Tags that point to target addresses to send notifications to
Parameters Entry in the snmpTargetParamsTable; the maximum length is 32 bytes
Storage Type Keyword to indicate whether the settings are volatile or nonvolatile
Row Status Status of the entry

Related Commands clear snmp targetaddr

set snmp targetaddr

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-571
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp targetparams

show snmp targetparams

Use the show snmp targetparams command to display the SNMP parameters used in the
snmpTargetParamsTable when generating a message to a target.

show snmp targetparams [volatile | nonvolatile | read-only]

show snmp targetparams {-hex} {paramsname}

Syntax Description volatile (Optional) Keyword that specifies that the storage type is defined as
temporary memory and the content is deleted if the device is turned off.
nonvolatile (Optional) Keyword that specifies that the storage type is defined as
persistent memory and the content remains after the device is power
cycled.
read-only (Optional) Keyword that specifies that the storage type is read-only.
-hex Keyword that displays paramsname as a hexadecimal character.
paramsname A unique identifier that indexes the snmpTargetParamsTable; the
maximum length is 32 bytes.

Defaults By default, the storage type is volatile.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you use special characters for the paramsname variable (nonprintable delimiters for this parameter),
you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:);
for example, 00:ab:34.

Examples This example shows how to display specific target parameter information in the
snmpTargetParamsTable:
Console> (enable) show snmp targetparams snmpV1TrapParams
Target Parameter Name: snmpV1TrapParams
Message Processing Model: v1
Security Name: public
Security Level: noauthentication
Storage Type: volatile
Row Status: active
Console> (enable)

Table 2-58 describes the fields in the show snmp targetparams command output.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-572 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp targetparams

Table 2-58 show snmp targetparams Command Output Fields

Field Description
Target Parameter Name A unique identifier used to index the snmpTargetParamsTable
Message Processing Model Displays the version number used by the Message Processing
Model
Security Name Security string definition
Security Level Type of security level (authentication: security level is set to use
authentication protocol; noauthentication: security level is not
set to use authentication protocol)
Storage Type Keyword to indicate whether the settings are volatile or
nonvolatile
Row Status Status of the entry

Related Commands clear snmp targetparams

set snmp targetparams

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-573
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp user

show snmp user

Use the show snmp user command to display SNMP information for a specific user.

show snmp user [volatile | nonvolatile | read-only]

show snmp user {-hex} {user} [remote {engineid}]

show snmp summary

Syntax Description volatile (Optional) Keyword that specifies that the storage type is defined as
temporary memory and the content is deleted if the device is turned off.
nonvolatile (Optional) Keyword that specifies that the storage type is defined as persistent
memory and the content remains after the device is power cycled.
read-only (Optional) Keyword that specifies that the storage type is read-only.
-hex Keyword that displays user as a hexadecimal character.
user Name of the SNMP user.
remote engineid (Optional) Keyword and variable that specify the user name on a remote
SNMP engine.
summary Keyword that specifies summary of SNMP users.

Defaults The defaults are as follows:

• Storage type is nonvolatile.
• Local SNMP engine ID.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you use special characters for the user variable (nonprintable delimiters for this parameter), you must
use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for
example, 00:ab:34.

Examples This example shows how to display specific user information:

Console> (enable) show snmp user joe
EngineId: 00:11:22:33:44
User Name: joe
Authentication Protocol: md5
Privacy Protocol: des56
Storage Type: volatile
Row Status: active
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-574 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp user

Table 2-59 describes the fields in the show snmp user command output.

Table 2-59 show snmp user Command Output Fields

Field Description
EngineId String identifying the name of the copy of SNMP on the device
User Name String identifying the name of the SNMP user
Authentication Protocol Type of authentication protocol
Privacy Protocol Type of privacy authentication protocol
Storage Type Keyword to indicate whether the settings are volatile or nonvolatile
Row Status Status of the entry

Related Commands clear snmp user

set snmp user

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-575
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp view

show snmp view

Use the show snmp view command to display the SNMP MIB view configuration.

show snmp view [volatile | nonvolatile | read-only]

show snmp view {-hex} {viewname} {subtree}

Syntax Description volatile (Optional) Keyword that specifies that the storage type is defined as
temporary memory and the content is deleted if the device is turned off.
nonvolatile (Optional) Keyword that specifies that the storage type is defined as
persistent memory and the content remains after the device is power
cycled.
read-only (Optional) Keyword that specifies that the storage type is read-only.
-hex Keyword that displays the viewname as a hexadecimal character.
viewname Name of a MIB view.
subtree Name of the subtree.

Defaults By default, the view is volatile.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines If you use special characters for the viewname variable (nonprintable delimiters for this parameter), you
must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for
example, 00:ab:34.
A MIB subtree used with a mask defines a view subtree; it can appear in OID format or as a text name
mapped to a valid OID.

Examples This example shows how to display the SNMP MIB configuration:
Console> (enable) show snmp view
View Name: defaultUserView
Subtree OID: 1.3.6.1
Subtree Mask:
View Type: included
Storage Type: volatile
Row Status: active
Control> (enable)

Table 2-60 describes the fields in the show snmp view command output.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-576 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show snmp view

Table 2-60 show snmp view Command Output Fields

Field Description
View Name Name of a MIB view
Subtree OID Name of a MIB subtree in OID format or as a textname mapped to a valid OID
Subtree Mask Subtree mask (can be all ones, all zeros, or a combination of both).
View Type Status of whether the MIB subtree is included or excluded
Storage Type Keyword to indicate whether the settings are volatile or nonvolatile
Row Status Status of the entry

Related Commands clear snmp view

set snmp view

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-577
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show span

show span
Use the show span command to display information about the current SPAN configuration:

show span [all]

Syntax Description all (Optional) Keyword to display local and remote SPAN configuration
information.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines SPAN in the context of a single module is the only possible configuration for Token Ring modules.

Examples This example shows how to display current SPAN information for a switch:
Console> (enable) show span
----------------------------------------------------------
Destination : Port 4/1
Admin Source : Port 2/2
Oper Source : Port 2/2
Direction : transmit/receive
Incoming Packets: enabled
Learning : -
Multicast : enabled
Filter : 10,20,30,40,50,60,70,80,90,100
Status : inactive

------------------------------------------------------------------------
Total local span sessions: 1
Console> (enable)

Table 2-61 describes the fields in the show span command output.

Table 2-61 show span Command Output Fields

Field Description
Destination Destination port for SPAN information.
Admin Source Source port or VLAN for SPAN information.
Oper Source Operator port or VLAN for SPAN information.
Direction Status of whether transmit, receive, or transmit and receive
information is monitored.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-578 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show span

Table 2-61 show span Command Output Fields (continued)

Field Description
Incoming Packets Status of whether reception of normal incoming packets on the SPAN
destination port is enabled or disabled.
Learning Status of whether learning is enabled or disabled for the SPAN
destination port.
Multicast Status of whether monitoring multicast traffic is enabled or disabled.
Filter Monitored VLANs in source trunk ports.
Status Status of whether SPAN is active or inactive

Related Commands clear config—switch

set span

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-579
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree

show spantree
Use the show spantree command to display spanning tree information for a VLAN.

show spantree [vlan | mod/port] [active]

Syntax Description vlan (Optional) Number of the VLAN.

mod/port (Optional) Number of the module and the port on the module.
active (Optional) Keyword that specifies to display only the active ports.

Defaults By default, spanning tree information is displayed for VLAN 1.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If the VLAN number is not specified, the default is VLAN 1.

Examples This example shows how to display the spanning tree configuration for VLAN 64:
Console> show spantree 64
VLAN 64
Spanning tree enabled

Designated Root 00-10-79-57-88-00

Designated Root Priority 8191
Designated Root Cost 3061
Designated Root Port 6/48
Root Max Age 20 sec Hello Time 2 sec Forward Delay 15 sec

Bridge ID MAC ADDR 00-50-3e-8f-8c-00

Bridge ID Priority 4160 (bridge priority: 4096, sys ID ext: 64)
Bridge Max Age 6 sec Hello Time 2 sec Forward Delay 4 sec

Port,Vlan Vlan Port-State Cost Priority Fast-Start Group-method

--------- ---- ------------- ----- -------- ---------- ------------
1003 1005 inactive 80 32 disabled
Console>

This example shows how to display only the active ports:

Console> show spantree active
VLAN 1
Spanning tree enabled
Spanning tree type ieee

Designated Root 00-60-70-4c-70-00

Designated Root Priority 32768

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-580 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree

Designated Root Cost 19

Designated Root Port 1/1
Root Max Age 20 sec Hello Time 2 sec Forward Delay 15 sec

Bridge ID MAC ADDR 00-e0-1e-9b-2e-00

Bridge ID Priority 32768
Bridge Max Age 20 sec Hello Time 2 sec Forward Delay 15 sec

Port Vlan Port-State Cost Priority Fast-Start Group-Method

--------- ---- ------------- ----- -------- ---------- ------------
1/1 1 forwarding 19 32 disabled
3/1-2 1 forwarding 19 32 disabled redundancy

Table 2-62 describes the possible fields in the show spantree command output.

Table 2-62 show spantree Command Output Fields

Field Description
VLAN VLAN for which spanning tree information is shown
Spanning tree Status of whether Spanning Tree Protocol is enabled or disabled
Designated Root MAC address of the designated spanning tree root bridge
Designated Root Priority of the designated root bridge
Priority
Designated Root Total path cost to reach the root
Cost
Designated Root Port through which the root bridge can be reached (shown only on nonroot
Port bridges)
Root Max Age Amount of time a BPDU packet should be considered valid
Hello Time Number of times the root bridge sends BPDUs
Forward Delay Amount of time the port spends in listening or learning mode
Bridge ID MAC Bridge MAC address
ADDR
Bridge ID Priority Bridge priority
Bridge Max Age Bridge maximum age
Hello Time Amount of time the bridge sends BPDUs
Forward Delay Amount of time the bridge spends in listening or learning mode
Port Port number
Vlan VLAN to which the port belongs
Port-State Spanning tree port state (disabled, inactive, not-connected, blocking,
listening, learning, forwarding, bridging, or type-pvid-inconsistent)
Cost Cost associated with the port
Priority Priority associated with the port
Fast-Start Status of whether the port is configured to use the fast-start feature
Group-Method How the multiple ports are treated (redundancy=dual PHY and FDDI;
repeater=RSM; channel=Fast EtherChannel)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-581
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree

Related Commands set spantree disable

set spantree enable
set spantree fwddelay
set spantree hello
set spantree maxage
set spantree portcost
set spantree portfast
set spantree portpri
set spantree portvlancost

show spantree backbonefast

show spantree blockedports
show spantree guard
show spantree statistics
show spantree summary
show spantree uplinkfast

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-582 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree backbonefast

show spantree backbonefast

Use the show spantree backbonefast command to display whether the spanning tree Backbone Fast
Convergence feature is enabled.

show spantree backbonefast

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display whether the spanning tree Backbone Fast Convergence feature is
enabled:
Console> show spantree backbonefast
Backbonefast is enabled.
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-583
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree blockedports

show spantree blockedports

Use the show spantree blockedports command to display ports that are blocked.

show spantree blockedports [vlan_num]

Syntax Description vlan_num (Optional) Number of the VLAN.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If you do not specify a VLAN number, all blocked ports in the system are displayed.

Examples This example shows how to display the blocked ports for VLAN 1002:
Console> show spantree blockedports 1002
Number of blocked ports (segments) in VLAN 1002 : 0
Console>

Related Commands show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-584 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree bpdu-skewing

show spantree bpdu-skewing

Use the show spantree bpdu-skewing command to display the status of BPDU skewing detection.

show spantree bpdu-skewing [vlan] mod/port

show spantree bpdu-skewing {mistp-instance [instance]} mod/port

Syntax Description vlan (Optional) Number of the VLAN. Valid values are 1 to 1005 and
1025 to 4094.
mod/port Number of the module and the port on the module.
mistp-instance Keyword and optional variable to display instance-specific
instance information. Valid values are 1 to 16.

Defaults By default, BPDU skew status for all VLANs is displayed.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines This command is not supported by the NAM.

This command is available in MISTP mode only.

Examples This example shows how to display the BPDU skewing status for VLAN 1:
Console> show spantree bpdu-skewing 1

Bpdu skewing statistics for vlan 1

Port Last Skewing Worst Skewing Worst Skewing Date

------ ------------- ------------- -------------------------
8/2 5869 108370 Tue Nov 21 2000, 06:25:59
8/4 4050 113198 Tue Nov 21 2000, 06:26:04
8/6 113363 113363 Tue Nov 21 2000, 06:26:05
8/8 4111 113441 Tue Nov 21 2000, 06:26:05
8/10 113522 113522 Tue Nov 21 2000, 06:26:05
8/12 4111 113600 Tue Nov 21 2000, 06:26:05
8/14 113678 113678 Tue Nov 21 2000, 06:26:05
8/16 4111 113755 Tue Nov 21 2000, 06:26:05
8/18 113833 113833 Tue Nov 21 2000, 06:26:05
8/20 4111 113913 Tue Nov 21 2000, 06:26:05
8/22 113917 113917 Tue Nov 21 2000, 06:26:05
8/24 4110 113922 Tue Nov 21 2000, 06:26:05
8/26 113926 113926 Tue Nov 21 2000, 06:26:05
8/28 4111 113931 Tue Nov 21 2000, 06:26:05
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-585
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree bpdu-skewing

This example shows how to display the BPDU skewing status for port 2 on module 8 in VLAN 1:
Console> (enable) show spantree bpdu-skewing 1 8/2
Bpdu skewing statistics for vlan 1
Port Last Skewing Worst Skewing Worst Skewing Date
------ ------------- ------------- -------------------------
8/2 5869 108370 Tue Nov 21 2000, 06:25:59
Console> (enable)

Related Commands set spantree bpdu-skewing

show spantree summary

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-586 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree conflicts

show spantree conflicts

Use the show spantree conflicts command to display the MAC address of the root switch in the instance,
the time remaining before the VLAN joins the instance, and the number of seconds left before the entry
expires and is removed from the table.

show spantree conflicts vlan

Syntax Description vlan Number of the VLAN.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines This command is available in MISTP or MISTP/PVST+ mode only.

When only one entry is printed (or when all the entries are associated to the same instance), the VLAN
is mapped to that instance. If two or more entries are associated with different instances, then the VLAN
has a conflict, is blocked, and is not mapped to any instance.
The time left timers associated with the mapping of a VLAN to a MISTP instance are started with the
max age of the BPDU, and can be up to the maximum max age. The delay field can show “inactive” to
indicate the MAC address is the same as the MAC address of the switch (for example, the switch is the
root). In all the other cases, the entry is a number, and the timer restarts every time an incoming BPDU
confirms the mapping.
The delay timer field can display:
• Number in seconds that represents the timer running; this timer can be up to the maximum forward
delay. The timer is initialized with the fwd delay.
• If the timer is not running, “inactive” is displayed. This is displayed because the VLAN is already
mapped to the instance or a conflict exists.

Examples This example shows the output if there are no conflicts on VLAN 1:
Console> (enable) show spantree conflicts 1
No conflicts for vlan 1
Inst MAC Delay Time left
---- ----------------- --------- ---------
1 00-30-a3-4a-0c-00 inactive 35
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-587
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree conflicts

This example shows the output if there are conflicts on the specified VLAN:
Console> (enable) show spantree conflicts 1
Inst MAC Delay Time left
---- ----------------- --------- ---------
1 00-30-a3-4a-0c-00 inactive 35
3 00-30-f1-e5-00-01 inactive 23
Console> (enable)

Table 2-63 describes the fields in the show spantree conflict command output.

Table 2-63 show spantree conflict Command Output Fields

Field Description
Inst Instance number that is requesting to map the VLAN.
MAC MAC address of the root sending the BPDU claiming the VLAN (taken from
the root ID of the BPDU).
Delay Time remaining before the VLAN joins the instance.
Time left Age of the entry, as time in seconds left before the entry expires and is
removed from the table.

Related Commands show spantree mistp-instance

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-588 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree defaultcostmode

show spantree defaultcostmode

Use the show spantree defaultcostmode to display the current default port cost mode.

show spantree defaultcostmode

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the default port cost mode:
Console> (enable) show spantree defaultcostmode
Portcost and portvlancost set to use 802.1d default values.
Console> (enable)

Related Commands set spantree defaultcostmode

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-589
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree guard

show spantree guard

Use the show spantree guard command to display rootguard information for VLANs or instances on a
port.

show spantree guard [vlan]

show spantree guard mod/port

show spantree guard mistp-instance [instance | mod/port]

Syntax Description vlan (Optional) Number of the VLAN. Valid values are 1 to 1005 and
1025 to 4094.
mod/port (Optional) Number of the module and the port on the module.
mistp-instance Keyword that specifies rootguard for the MISTP instance.
instance (Optional) Number of the instance.

Defaults The default is VLAN 1. The default port list is all the ports in the specified or default VLAN.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines You can specify a VLAN or a port, but not both. You can specify an instance or a port, but not both.

Examples This examples shows how to display root guard information for VLAN 1:
Console> show spantree guard 1
Port VLAN Port-State Root guard
------------------------ ---- ------------- ----------
1/1 1 not-connected disabled
1/2 1 not-connected disabled
2/1 1 not-connected disabled
2/5 1 not-connected disabled
<<<< output truncated >>>>
Console>

This examples shows how to display root guard information for instance 3:
Console> show spantree guard mistp-instance 3
Port Inst Port-State Root guard
------------------------ ---- ------------- ----------
1/1 1 connected enabled
1/2 1 connected enabled
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-590 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree guard

Related Commands set spantree uplinkfast

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-591
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree mapping

show spantree mapping

Use the show spantree mapping command to display VLAN and instance mapping information.

show spantree mapping [config]

Syntax Description config (Optional) Keyword to display the mapping that has been configured on
the local switch.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If you do not enter the optional config keyword, the mapping information propagated from the root
switch in the instance is displayed. This runtime command is available in MISTP or MISTP-PVST+
mode only. If you enter the config keyword, the list of mappings configured on the local switch is
displayed. It is available in PVST+ mode.
If you enter this command in PVST+ mode, the following message is displayed:
Runtime vlan and instance mapping information is only available in MISTP
or
MISTP-PVST mode. Use 'show spantree mapping config' to view mappings
configured on the local switch.

Examples This example shows how to display runtime VLAN and instance mapping information:
Console> (enable) show spantree mapping
Inst Root Mac Vlans
---- ----------------- --------------------------------------------------
1 00-50-3e-78-70-00 1
2 00-50-3e-78-70-00 -
3 00-50-3e-78-70-00 -
4 00-50-3e-78-70-00 -
5 00-50-3e-78-70-00 -
6 00-50-3e-78-70-00 -
7 00-50-3e-78-70-00 -
8 00-50-3e-78-70-00 -
9 00-50-3e-78-70-00 -
10 00-50-3e-78-70-00 -
11 00-50-3e-78-70-00 -
12 00-50-3e-78-70-00 -
13 00-50-3e-78-70-00 -
14 00-50-3e-78-70-00 -
15 00-50-3e-78-70-00 -
16 00-50-3e-78-70-00 -
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-592 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree mapping

This example shows how to display mappings configured on the local switch:
Console> (enable) show spantree mapping config
Inst Root Mac Vlans
---- ----------------- --------------------------------------------------
1 - 1
2 - -
3 - -
4 - -
5 - -
6 - -
7 - -
8 - -
9 - -
10 - -
11 - -
12 - -
13 - -
14 - -
15 - -
16 - -
Console> (enable)

Related Commands set vlan

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-593
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree mistp-instance

show spantree mistp-instance

Use the show spantree mistp-instance command set to display instance information.

show spantree mistp-instance [instance] [active]

show spantree mistp-instance mod/port

Syntax Description instance (Optional) Instance number. Valid values are from 1 to 16.
active (Optional) Keyword to display only active ports.
mod/port Number of the module and the port on the module.

Defaults By default, the instance number is 1.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines This command is available in MISTP mode only.

If you specify the mod/port number only, the VLAN mapping information is not displayed.

Examples This example shows how to display information regarding active instances only:
Console> show spantree mistp-instance active
Instance 1
Spanning tree mode MISTP
Spanning tree type ieee
Spanning tree instance enabled

Designated Root 00-d0-00-4c-18-00

Designated Root Priority 32769 (root priority: 32768, sys ID ext: 1)
Designated Root Cost 0
Designated Root Port none
VLANs mapped: 1
Root Max Age 20 sec Hello Time 2 sec Forward Delay 15 sec

Bridge ID MAC ADDR 00-d0-00-4c-18-00

Bridge ID Priority 32769 (bridge priority: 32768, sys ID ext: 1)
VLANs mapped: 1
Bridge Max Age 20 sec Hello Time 2 sec Forward Delay 15 sec

Port Inst Port-State Cost Prio Portfast Channel_id

------------------------ ---- ------------- --------- ---- -------- ----------
2/3 1 forwarding 200000 32 disabled 0
2/12 1 forwarding 200000 32 disabled
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-594 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree mistp-instance

Table 2-64 describes the fields in the show spantree mistp-instance command output:

Table 2-64 show spantree mistp-instance Command Output Fields

Field Description
Instance Instance for which spanning tree information is shown.
Spanning tree mode Spanning tree mode.
Spanning tree type Spanning tree type.
Spanning tree instance Status of whether spanning tree instance is enabled or disabled.
Designated Root MAC address of the designated spanning tree root bridge.
Designated Root Priority Priority of the designated root bridge.
Designated Root Cost Total path cost to reach the root.
Designated Root Port Port through which the root bridge can be reached (shown only on
nonroot bridges).
VLANs mapped Number of VLANs mapped.
Root Max Age Amount of time a BPDU packet should be considered valid.
Hello Time Number of times the root bridge sends BPDUs.
Forward Delay Amount of time the port spends in listening or learning mode.
Bridge ID MAC ADDR Bridge MAC address.
Bridge ID Priority Part of the bridge identifier and is taken as the most significant part
bridge ID comparisons.
Bridge Max Age Bridge maximum age.
Hello Time Amount of time the bridge sends BPDUs.
Forward Delay Amount of time the bridge spends in listening or learning mode.
Port Port number.
Instance Instance to which the port belongs.
Port-State Spanning tree port state (disabled, inactive, not-connected, blocking,
listening, learning, forwarding, bridging, or type-pvid-inconsistent).
Cost Cost associated with the port.
Prio Priority associated with the port.
Portfast Status of whether the port is configured to use the PortFast feature.
Channel_id Channel ID number.

Related Commands set spantree portinstancecost

set spantree portinstancepri

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-595
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree portfast

show spantree portfast

Use the show spantree portfast command to display PortFast information.

show spantree portfast

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display PortFast information:

Console> show spantree portfast
Portfast BPDU guard is disabled.
Portfast BPDU filter is disabled.
Console>

Related Commands set spantree portfast

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

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-596 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree portinstancecost

show spantree portinstancecost

Use the show spantree portinstancecost command to show the path cost for the instances on a port.

show spantree portinstancecost mod/port

Syntax Description mod/port Number of the module and the port on the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the path cost for the MISTP instances on port 1/1:
Console> show spantree portinstancecost 1/1
Port 1/1 instances 1-16 have path cost 20000.
Console>

Related Commands clear spantree portinstancecost

set spantree portinstancecost

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-597
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree portvlancost

show spantree portvlancost

Use the show spantree portvlancost command to show the path cost for the VLANs on a port.

show spantree portvlancost mod/port

Syntax Description mod/port Number of the module and the port on the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the path cost for the VLANs on port 2/12:
Console> show spantree portvlancost 2/12
Port 2/12 VLANs 1-1005 have path cost 19.
Console>

Related Commands set spantree portvlancost

show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-598 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree statistics

show spantree statistics

Use the show spantree statistics command to show spanning tree statistical information.

show spantree statistics mod/port [vlan]

Syntax Description mod/port Number of the module and port.

vlan (Optional) Number of the VLAN.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display TrCRF statistical information:

Console> (enable) show spantree statistics 6/48 64
Port 6/48 VLAN 64
SpanningTree enabled for vlanNo = 64
BPDU-related parameters
port spanning tree enabled
state disabled
port_id 0xcccf
port number 0x7eb
path cost 80
message age (port/VLAN) 0(10)
designated_root 00-10-2f-52-eb-ec
designated_cost 0
designated_bridge 00-10-2f-52-eb-ec
designated_port 0xcccf
top_change_ack FALSE
config_pending FALSE
port_inconsistency none

PORT based information & statistics

config bpdu's xmitted (port/VLAN) 0(0)
config bpdu's received (port/VLAN) 0(0)
tcn bpdu's xmitted (port/VLAN) 0(0)
tcn bpdu's received (port/VLAN) 0(0)
forward trans count 0
scp failure count 0

Status of Port Timers

forward delay timer INACTIVE
forward delay timer value 0
message age timer INACTIVE
message age timer value 0
topology change timer INACTIVE
topology change timer value 0
hold timer INACTIVE

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-599
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree statistics

hold timer value 0

delay root port timer INACTIVE
delay root port timer value 0

VLAN based information & statistics

spanningtree type ibm
spanningtree multicast address c0-00-00-00-01-00
bridge priority 32768
bridge mac address 00-10-2f-52-eb-ec
bridge hello time 2 sec
bridge forward delay 4 sec
topology change initiator: 1/0
topology change FALSE
topology change time 14
topology change detected FALSE
topology change count 0
topology change last recvd. from 00-00-00-00-00-00

Other port-specific info

dynamic max age transitions 0
port bpdu ok count 0
msg age expiry count 0
link loading 1
bpdu in processing FALSE
num of similar bpdus to process 0
next state 0
src mac count: 0
total src mac count 0
curr_src_mac 00-00-00-00-00-00
next_src_mac 00-00-00-00-00-00
channel_src_mac 00-00-00-00-00-00
channel src count 0
channel ok count 0

bridge ID priority 4160 (bridge priority: 4096, sys ID ext: 64)

Console> (enable)

Table 2-65 describes the possible fields in the show spantree statistics command output.

Table 2-65 show spantree statistics Command Output Fields

Field Description
BPDU-related parameters
port spanning tree Status of whether Spanning Tree Protocol is enabled or disabled on the port.
state Spanning tree port state (Disabled, Listening, Learning, Forwarding, or
Blocking).
port_id Port identifier of the associated port.
port number Port number.
path cost Contribution of the path through this root port. This applies to the total path
cost to the root for this bridge.
message age Age of the received protocol information recorded for a port and the value of
(port/VLAN) the Max Age parameter (shown in parenthesis) recorded by the switch.
designated_root MAC address of the designated spanningtree root bridge.
designated_cost Cost of the path to the root offered by the designated port on the LAN to
which this port is attached.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-600 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree statistics

Table 2-65 show spantree statistics Command Output Fields (continued)

Field Description
designated_bridge Bridge identifier of the bridge assumed to be the Designated Bridge for the
LAN associated with the port.
designated_port Port identifier of the Bridge Port assumed to be the Designated Port for the
LAN associated with the port.
top_change_ack Value of the Topology Change Acknowledgment flag in the next configured
BPDU to be transmitted on the associated port. The flag is set in reply to a
Topology Change Notification BPDU.
config_pending Boolean parameter set to record that a configured BPDU should be
transmitted on expiration of the hold timer for the associated port.
port_inconsistency Status of whether the port is in an inconsistent (PVID or port type) state or
not.
PORT-based information and statistics
config bpdu's xmitted Number of BPDUs transmitted from the port. The number in parentheses is
(port/VLAN) the number of configured BPDUs transmitted by the switch for this instance
of spanning tree.
config bpdu's Number of BPDUs received by this port. The number in parentheses is the
received number of configured BPDUs received by the switch for this instance of
(port/VLAN) spanning tree.
tcn bpdu's xmitted Number of TCN BDPUs transmitted on this port.
(port/VLAN)
tcn bpdu's received Number of TCN BPDUs received on this port.
(port/VLAN)
forward trans count Number of times the port state transitioned to FORWARDing state.
scp failure count Number of SCP failures.
Status of Port Timers
forward delay timer Status of the forward delay timer. This timer monitors the time spent by a
port in the Listening and Learning States.
forward delay timer Current value of the forward delay timer.
value
message age timer Status of the message age timer. This timer measures the age of the received
protocol information recorded for a port.
message age timer Current value of the message age timer.
value
topology change Status of the topology change timer. This timer determines the time period
timer in which configured BPDUs are transmitted with the topology change flag
set by the bridge when it is root following the detection of a topology change.
topology change Current value of the topology change timer.
timer value
hold timer Status of the hold timer. This timer ensures that configured BPDUs are not
transmitted too frequently through any bridge port.
hold timer value Current value of the hold timer.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-601
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree statistics

Table 2-65 show spantree statistics Command Output Fields (continued)

Field Description
delay root port timer Status of the delay root port timer. This timer enables fast convergence on
linkup when the UplinkFast feature is enabled.
delay root port timer Current value of the delay root port timer.
value
VLAN-based information and statistics
spanningtree type Type of spanning tree (IEEE, IBM, CISCO).
spanningtree Destination address used to send out configured BPDUs on a bridge port.
multicast address
bridge priority Part of the bridge identifier and is taken as the most significant part bridge
ID comparisons.
bridge mac address Bridge MAC address.
bridge hello time Value of the Hello Time parameter when the bridge is the root or is
attempting to become the root.
bridge forward delay Value of the Forward Delay parameter when the bridge is the root or is
attempting to become the root.
topology change Time the last topology change occurred.
topology change Number of the port that caused the topology change.
initiator:
topology change Number of times configured BPDUs have been transmitted by the bridge on
the LANs for which the bridge is the designated bridge.
topology change time Time period for which BPDUs are transmitted with the topology change flag
set by the bridge when it is the root following the detection of a topology
change. It is equal to the sum of the bridge's Max Age and Forward Delay
parameters.
topology change Number of topology changes that have been detected by or notified to the
detected bridge.
topology change Number of times the topology change has occurred.
count
topology change last MAC address of the bridge that transmitted the last TCN BPDU.
recvd. from
Other port-specific info
dynamic max age Number of dynamic max age transitions.
transitions
port bpdu ok count Number of reported port BPDU counts.
msg age expiry count Number of message age expires.
link loading Status of whether the link is oversubscribed.
bpdu in processing Status of whether the BPDU is under processing.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-602 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree statistics

Table 2-65 show spantree statistics Command Output Fields (continued)

Field Description
num of similar bpdus Number of similar BPDUs to process that are received on a specific port.
to process
received_inferior_bp Status of whether the port received an inferior BPDU or in response to an
du RLQ BPDU.
next state Port state before it is actually set by spanning tree, to facilitate other tasks in
using the new value.
src mac count: Number of BPDUs with the same source MAC address.
total src mac count Number of BPDUs with all the source MAC addresses.
curr_src_mac Source MAC address of the configured BPDU received on a particular port.
next_src_mac MAC address from the different source.
channel_src_mac Source MAC address of the channel port. It is used to detect channel
misconfiguration and avoid spanning tree loops.
channel src count Number of times channel_src_mac gets changed and if the limit is exceeded,
a channel misconfiguration is detected.
channel ok count Boolean flag which records the channel status.

Related Commands clear spantree statistics

show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-603
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree summary

show spantree summary

Use the show spantree summary command to display a summary of spanning tree information.

show spantree summary

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display a summary of spanning tree information:
Console> show spantree summary
Summary of connected spanning tree ports by vlan

Uplinkfast disabled for bridge.

Backbonefast enabled for bridge.

Vlan Blocking Listening Learning Forwarding STP Active

----- -------- --------- -------- ---------- ----------
1 0 0 0 1 1

BackboneFast statistics
-----------------------
Number of inferior BPDUs received (all VLANs) : 0
Number of RLQ req PDUs received (all VLANs) : 0
Number of RLQ res PDUs received (all VLANs) : 0
Number of RLQ req PDUs transmitted (all VLANs) : 0
Number of RLQ res PDUs transmitted (all VLANs) : 0
Console>

Related Commands show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-604 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show spantree uplinkfast

show spantree uplinkfast

Use the show spantree uplinkfast command to show the UplinkFast settings.

show spantree uplinkfast

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the UplinkFast settings:

Console> show spantree uplinkfast
VLAN port list
------------------------------------------------
1-20 1/1(fwd),1/2-1/5
21-50 1/9(fwd), 1/6-1/8, 1/10-1/12
51-100 2/1(fwd), 2/12
Console>

Related Commands clear spantree uplinkfast

set spantree uplinkfast
show spantree

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-605
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show summertime

show summertime
Use the show summertime command to determine whether the summertime feature is enabled or
disabled.

show summertime

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the current status of the summertime feature:
Console> show summertime
Summertime is disabled and set to ''
Start : Sun Apr 2 2000, 02:00:00
End : Sun Oct 29 2000, 02:00:00
Offset: 60 minutes
Recurring: yes, starting at 02:00am of first Sunday of April and ending on 02:00am of last
Sunday of October.
Console>

Related Commands set summertime

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-606 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show switchacceleration

show switchacceleration
Use the show switchacceleration command to display the current status of the switch acceleration
feature.

show switchacceleration mod_num

Syntax Description mod_num Number of the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the current status of the switch acceleration feature on module 1:
Console> show switchacceleration 1
Module 1 has switch acceleration enabled.
Console>

Related Commands set switchacceleration

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-607
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show system

show system
Use the show system command to display system information.

show system

Syntax Description This command has no keywords or arguments.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines In a Token Ring module, the values shown for Traffic and Peak are the average of three switching buses.

Examples This example shows the system status and other information:
Console> show system
PS1-Status PS2-Status Fan-Status Temp-Alarm Sys-Status Uptime d,h:m:s Logout
---------- ---------- ---------- ---------- ---------- -------------- ---------
ok none ok off ok 3,02:08:53 20 min

PS1-Type PS2-Type Modem Baud Traffic Peak Peak-Time

---------- ---------- ------- ----- ------- ---- -------------------------
WS-C4008A none disable 9600 0% 0% Thu Aug 10 1998, 03:22:20

System Name System Location System Contact

------------------------ ------------------------ ------------------------
Catalyst 4000 San Jose, CA Susan x237
Console>

Table 2-66 describes the fields in the show system command output.

Table 2-66 show system Command Output Fields

Field Description
PS1-Status Status of power supply 1 (ok, fan failed, faulty, or none)
PS2-Status Status of power supply 2 (ok, fan failed, faulty, or none)
Fan-Status Status of the fan (ok, faulty, or other)
Temp-Alarm Status of the temperature alarm is off or on
Sys-Status System status (ok or faulty). Corresponds to system LED status
Uptime d,h:m:s Amount of time in days, hours, minutes, and seconds, that the
system has been up and running

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-608 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show system

Table 2-66 show system Command Output Fields (continued)

Field Description
Logout Amount of time after which an idle session is disconnected
PS1-Type Part number of the power supply
PS2-Type Part number of the redundant power supply, if present
Modem Status of the modem status (enabled or disabled)
Baud Baud rate to which the modem is set
Traffic Current traffic percentage
Peak Peak percentage of traffic on the backplane
Peak-Time Time stamp when peak percentage was recorded
System Name System name
System Location System location
System Contact System contact information

Related Commands set system baud

set system contact
set system location
set system modem
set system name

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-609
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show tacacs

show tacacs
Use the show tacacs command to display the TACACS+ protocol configuration.

show tacacs [noalias]

Syntax Description noalias (Optional) Keyword to force the display to show IP addresses, not IP
aliases.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the TACACS+ protocol configuration:
Console> (enable) show tacacs

Login Authentication: Console Session Telnet Session

--------------------- ---------------- ----------------
tacacs disabled disabled
radius disabled disabled
kerberos disabled disabled
local enabled(primary) enabled(primary)

Enable Authentication: Console Session Telnet Session

---------------------- ----------------- ----------------
tacacs disabled disabled
radius disabled disabled
kerberos disabled disabled
local enabled(primary) enabled(primary)

Tacacs key:
Tacacs login attempts: 3
Tacacs timeout: 5 seconds
Tacacs direct request: disabled

Tacacs-Server Status
---------------------------------------- -------
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-610 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show tacacs

This example shows how to display the TACACS+ protocol configuration without aliases:
Console> (enable) show tacacs noalias

Login Authentication: Console Session Telnet Session

--------------------- ---------------- ----------------
tacacs disabled disabled
radius disabled disabled
kerberos disabled disabled
local enabled(primary) enabled(primary)

Enable Authentication: Console Session Telnet Session

---------------------- ----------------- ----------------
tacacs disabled disabled
radius disabled disabled
kerberos disabled disabled
local enabled(primary) enabled(primary)

Tacacs key:
Tacacs login attempts: 3
Tacacs timeout: 5 seconds
Tacacs direct request: disabled

Tacacs-Server Status
---------------------------------------- -------
Console> (enable)

Table 2-67 describes the fields in the show tacacs command output.

Table 2-67 show tacacs Command Output Fields

Field Description
Tacacs login attempts Number of failed login attempts allowed
Tacacs timeout Time in seconds to wait for a response from the TACACS+ server
Tacacs direct request Status of whether TACACS+ directed-request option is enabled or
disabled
Tacacs-Server IP addresses or IP aliases of configured TACACS+ servers
Status Primary TACACS+ server

Related Commands set tacacs directedrequest

set tacacs key
set tacacs server
set tacacs timeout

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-611
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show tech-support

show tech-support
Use the show tech-support command to display system and configuration information that you can
provide to the Cisco Technical Assistance Center (TAC) when reporting a problem.

show tech-support [module mod] [vlan vlan] [memory | config]

show tech-support [port mod/port] [vlan vlan] [memory] [config]

Syntax Description module (Optional) Keyword that specifies to display data for switching
modules.
mod (Optional) Keyword that specifies the number of the module.
vlan (Optional) Keyword that specifies to display data for VLANs.
vlan (Optional) Keyword that specifies the number of the VLAN.
memory (Optional) Keyword that specifies to display memory and processor
state data.
config (Optional) Keyword that specifies to display the configuration of
the switch.
port (Optional) Keyword that specifies to display data for switch ports.
mod/port (Optional) Number of the port for which to display data.

Defaults By default this command displays the output for technical-support-related show commands. Use
keywords to specify the type of information to be displayed. If no parameters are specified, the system
displays all configuration, memory, module, port, and VLAN data.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The show tech-support command output is continuous; it does not display one screen at a time. To
interrupt the output, press Ctrl-C.
The show tech-support command may time out if the configuration file output takes longer to display
than the configured session timeout time. If this happens, enter a set logout timeout value of 0 to disable
automatic disconnection of idle sessions or enter a larger timeout value.
If you specify the config keyword, the show tech-support command displays the output of these
commands:
• show config
• show flash
• show log
• show microcode

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-612 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show tech-support

• show module
• show port
• show spantree active
• show system
• show test
• show trunk
• show version
• show vlan
If you specify the memory keyword, the show tech-support command displays the output of these
commands:
• ps
• ps -c
• show cam static
• show cam system
• show flash
• show memory buffers
• show microcode
• show module
• show proc
• show proc mem
• show proc cpu
• show system
• show spantree active
• show version
If you specify a module, port, or VLAN number, the system displays general system information and
information for the component you specified.

Related Commands show cam

show config
show flash
show log
show module
show port
show proc
show spantree
show system
show test
show trunk
show version—switch
show vlan

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-613
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show test

show test
Use the show test command to display the results of diagnostic tests.

show test [mod_num]

show test [diaglevel]

show test [[packetbuffer] [status]]

Syntax Description mod_num (Optional) Number of the module.

diaglevel (Optional) Keyword that specifies the diagnostic mode of the last
bootup and the next reset of the switch.
packetbuffer (Optional) Keyword that specifies packet buffer test schedule
information.
status (Optional) Keyword that specifies status of current packet buffer test.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If you do not specify a module number, test statistics are given for the general system and for module 1.
Network Management Processor (NMP) information applies only to module; consequently, only the
display for module 1 includes NMP status. If you specify other modules, NMP status is not displayed.

Examples This example shows how to display general test results for a Catalyst 4000 family switch:
Console> show test

Environmental Status (. = Pass, F = Fail, U = Unknown, N = Not Present)

PS1: . PS2: N PS1 Fan: . PS2 Fan: N Fan Tray: .
Temperature: . Chassis Temperature: 39 degC (102 degF)

Module 1 : 0-port Switching Supervisor

Network Management Processor (NMP) Status: (. = Pass, F = Fail, U = Unknown)
Control Processor Status:
DRAM : . EEPROM : . FLASH : . NVRAM : .

SX1000:
Register : . Network Memory : .

Mgmt Port Loopback Status: .

Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-614 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show test

This example shows how to display general test results for module 3:
Console> show test 3
Module 3: 48 10/100 Base T port Ethernet Card

(HX,CX)1000:
Ports 1-8:. Ports 9-16:. Ports 17-24:.
Ports 25-32:. Ports 33-40:. Ports 41-48:.

10/100BaseTX Loopback Status:

Ports 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
------------------------------------------------------------------------------
. . . . . . . . . . . . . . . . . . . . . . . .
Ports 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48
------------------------------------------------------------------------------

Table 2-68 describes the possible fields in the show test command output.

Table 2-68 show test Command Output Fields

Field Description
Environmental Status Test results that apply to the general system environment.
PS (3.3V) Test results for the 3.3V power supply.
PS (12V) Test results for the 12V power supply.
PS (24V) Test results for the 24V power supply.
PS1 Test results for power supply 1.
PS2 Test results for power supply 2.
Temperature Test results for temperature.
Fan Test results for the fan.
Module 1 Test results that apply to module 1. The module type is indicated as
well.
Network Management Test results that apply to the NMP on the supervisor module.
Processor (NMP) Status
ROM Test results for ROM.
Flash-EEPROM Test results for the Flash EEPROM.
Ser-EEPROM Test results for serial EEPROM.
NVRAM Test results for the NVRAM.
EARL Status Fields that display the EARL status information.
NewLearnTest Test results for NewLearn test (EARL).
IndexLearnTest Test results for IndexLearn test (EARL).
DontForwardTest Test results for DontForward test (EARL).
MonitorTest Test results for Monitor test (EARL).
DontLearn Test results for DontLearn test (EARL).

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-615
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show test

Table 2-68 show test Command Output Fields (continued)

Field Description
FlushPacket Test results for FlushPacket test (EARL).
ConditionalLearn Test results for ConditionalLearn test (EARL).
EarlLearnDiscard Test results for EarlLearnDiscard test (EARL).
EarlTrapTest Test results for EarlTrap test (EARL).
LCP Diag Status for Test results for the specified module.
Module 1
CPU Test results for the CPU.
Sprom Test results for serial PROM.
Bootcsum Test results for Boot ROM checksum.
Archsum Test results for archive Flash checksum.
RAM Test results for the RAM.
LTL Test results for local-target logic.
CBL Test results for color-blocking logic.
DPRAM Test results for dual-port RAM.
SAMBA Test results for SAMBA chip.
Saints Test results for SAINT chips.
Pkt Bufs Test results for the packet buffers.
Repeater Test results for repeater module.
FLASH Test results for the Flash memory.
Phoenix Test results for the Phoenix.
TrafficMeter Test results for the TrafficMeter.
UplinkSprom Test results for the UplinkSprom.
PhoenixSprom Test results for the Phoenix.
MII Status Test results for MII ports.
SAINT/SAGE Status Test results for individual SAINT/SAGE chip.
Phoenix Port Status Test results for Phoenix ports.
Packet Buffer Status Test results for individual packet buffer.
Phoenix Packet Buffer Test results for Phoenix packet buffer.
Status
Loopback Status Test results for the loopback test.
Channel Status Test results for the channel test.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-616 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show test

This example shows how to display test results for module 10 (an FDDI module):
Console> show test 10

Module 10 : 2-port MM MIC FDDI

Module 10 : FDDI Module Status: (. = Pass, F = Fail, U = Unknown)

FDDI Control Processor (FCP) Status:

ROM: . RAM: . Flash-EEPROM: . Dpram: .

Switch Memory Status:

RAM: . Cache-SRAM: . DmpCom: . Loadgen: .

FDDI Status:
Port A Access: . Port B Access: .
Port A Loopback: . Port B Loopback: .
MAC Access: . MAC Buffer R/W: .
MAC Internal LB: . MAC External LB: .
CAM: . . . .

Data Movement Processor (DMP) Status:

Flash-EEPROM: . RAM: . SRAM: . COMM: .

Switch Memory Status:

RAM: . Cache-SRAM: .

FDDI Status:
MAC Access: . MAC Buffer R/W: .
MAC Internal LB: . MAC External LB: . LoadGen:.
FBIGA Access: . FBIGA->MAC Buffer R/W: .
FBIGA->MAC TxDMA: . FBIGA->MAC RxDMA: .
FBIGA->MAC Internal LB:. FBIGA->MAC External LB:. LoadGen:.

Bus Interface Status:

SBIGA Access: . SBIGA->SAGE RxDMA: . SBIGA<-SAGE TxDMA:.
Biga Loop Access: . Biga Loop Rx: . Biga Loop Tx: .

LCP Diag Status for Module 10 (. = Pass, F = Fail, N = N/A)

CPU : . Sprom : . Bootcsum : . Archsum : N
RAM : . LTL : . CBL : . DPRAM : . SAMBA : N
Saints : . Pkt Bufs : . Repeater : N FLASH : N

SAINT/SAGE Status :
Ports 1
--------
.

Packet Buffer Status :

Ports 1
--------
.

Loopback Status :
Ports 1
--------
Console>

Table 2-69 describes the possible fields in the show test command output for an FDDI module.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-617
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show test

Table 2-69 show test Command Output Fields (FDDI)

Field Description
Module 10 Fields that indicate subsequent test results apply to module
10. The module type is indicated as well.
FDDI Control Processor (FCP) Status Fields that indicate FCP status.
ROM Test results for the ROM.
RAM Test results for the RAM.
Flash-EEPROM Test results for the Flash EEPROM.
Dpram Test results for the dynamic PRAM.
Switch Memory Status Fields that indicate the switch memory status.
RAM Test results for the RAM.
Cache-SRAM Test results for the queue SRAM.
DmpCom Test results for communication block.
Loadgen Test results for MAC LoadGen test.
FDDI Status Fields that indicate FDDI status.
Port A Access Test results for port A PHY register test.
Port B Access Test results for port B PHY register test.
Port A Loopback Test results for port A PHY loopback test.
Port B Loopback Test results for port B PHY loopback test.
MAC Access Test results for MAC register test.
MAC Buffer R/W Test results for MAC buffer memory test.
MAC Internal LB Test results for MAC internal loopback test.
MAC External LB Test results for MAC external loopback test.
CAM Test results for the CAM.
Data Movement Processor (DMP) Fields that indicate the DMP status.
Status
Flash-EEPROM Test results for the Flash EEPROM.
RAM Test results for the RAM.
SRAM Test results for the SRAM test.
COMM Test results for communication block.
Switch Memory Status Fields that indicate switch memory status.
RAM Test results for the RAM.
Cache-SRAM Test results for the queue SRAM.
FDDI Status Fields that indicate FDDI status.
MAC Access Test results for MAC register test.
MAC Buffer R/W Test results for MAC buffer memory test.
MAC Internal LB Test results for MAC internal loopback test.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-618 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show test

Table 2-69 show test Command Output Fields (FDDI) (continued)

Field Description
MAC External LB Test results for MAC external loopback test.
LoadGen Test results for MAC LoadGen test.
FBIGA Access Test results for FBIGA register test.
FBIGA->MAC Buffer R/W Test results for FBIGA buffer memory test.
FBIGA->MAC TxDMA Test results for FBIGA transmit test.
FBIGA->MAC RxDMA Test results for FBIGA receive test
FBIGA->MAC Internal LB Test results for FBIGA internal loopback test.
FBIGA->MAC External LB Test results for FBIGA external loopback test.
LoadGen Test results for FBIGA LoadGen test.
Bus Interface Status Fields that indicate bus interface status.

This example shows how to display diagnostic mode information for the last bootup and next reset of
the switch:
Console> show test diaglevel
Diagnostic mode at last bootup : complete
Diagnostic mode at next reset : complete
Console>

This example shows how to display packet buffer schedule information:

Console > (enable) show test packetbuffer
Packet buffer test : enabled
Packet buffer test schedule : continuous
Console > (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-619
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show test switch-memory

show test switch-memory

To display the current results of packet memory diagnostics, use the show test command.

show test switch-memory [summary | detail | affected-entries]

Syntax Description summary (Optional) Displays a summary of the packet memory diagnostics.
detail (Optional) Displays full detail of the packet memory diagnostics.
affected-entries (Optional) Displays packets affected by packet memory diagnostics.

Defaults Summary information is displayed.

Command Types Switch command

Command Modes Normal

Examples This example shows how to display packet memory diagnostics:

Console> show test switch-memory

Memory Diagnostics:Enabled Action:Best-Effort

Switch Chip 0 Test Result Summary

Bad packet buffers at bootup :1

Other affected packet buffers :0

Bad packet buffers found during ongoing tests :0

Packet buffers available in hardware for switching :4031

Packet buffers reserved for testing memory :64

Bad path directory entries at bootup :1

Bad path directory entries found during ongoing tests :0

Packet buffer memory failing blocks at bootup :U33{0}

Path directory memory failing blocks at bootup :U33{0}

Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-620 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show test switch-memory

This example shows how to display a summary of the packet memory diagnostics:
Console> show test switch-memory summary

Memory Diagnostics:Enabled Action:Best-Effort

Switch Chip 0 Test Result Summary

Bad packet buffers at bootup :1

Other affected packet buffers :0

Bad packet buffers found during ongoing tests :0

Packet buffers available in hardware for switching :4031

Packet buffers reserved for testing memory :64

Bad path directory entries at bootup :1

Bad path directory entries found during ongoing tests :0

Packet buffer memory failing blocks at bootup :U33{0}

Path directory memory failing blocks at bootup :U33{0}

Console>

Related Commands set test switch-memory

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-621
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show time

show time
Use the show time command to display the current time of day setting for the system clock.

show time

Syntax Description This command has no keywords or arguments.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the current time:

Console> show time
Thu Apr 15 1999, 02:54:50
Console>

The output shows the day of the week, month, day, year, hour, minutes, and seconds.

Related Commands set time

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-622 78-12648-03
 2
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show timezone

show timezone
Use the show timezone command to display the current time zone and any offset that has been
configured.

show timezone

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the current time zone and offset:
Console> show timezone
Timezone set to 'pst', offset from UTC is -8 hours
Console>

Related Commands clear timezone

set timezone

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-623
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show top

show top
Use the show top command to start the TopN process.

show top [N] [metric] [interval interval] [port_type] [background]

Syntax Description N (Optional) Number of ports displayed. Valid values are 1 to a maximum
number of physical ports.
metric (Optional) Port statistic to sort on. Valid values are as follows:
util—utilization
bytes—in/out bytes
pkts—in/out packets
bcst—in/out broadcast packets
mcst—in/out multicast packets
errors—in errors
overflow—buffer overflow
interval (Optional) Keyword that specifies duration of sample (in seconds).
interval (Optional) Number of seconds for sample. Valid values include 0, 10...999
seconds. If the value is 0, the N topmost ports by absolute counter values are
displayed.
port_type (Optional) Type of switch ports to use for report. Valid values are as follows:
all—all port types are used
eth—All Ethernet port types are used
10e—10 Mbps Ethernet ports types are used
fe—Fast Ethernet port types are used
ge—Gigabit Ethernet port types are used
background (Optional) Keyword that specifies the TopN report not to print to the screen
when the task is done. Instead, send a notification out when the reports are
ready.

Defaults The defaults are as follows:

• Number of ports displayed is 20.
• Port statistics to report on is util.
• Sample duration is 30 seconds.
• Switch port types is all.

Command Types Switch command.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-624 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show top

Command Modes Normal.

Usage Guidelines You can terminate TopN processes with the background option specified only by using the clear top
[report_num] command. You cannot terminate TopN processes by pressing Ctrl-C.
TopN reports with the background option specified are not displayed on the screen unless you enter a
show top report [report_num] command.
If you do not specify the background option, the output TopN results are dumped to the screen when
the task is done, and the results are printed one time only and are not saved.
You can terminate TopN processes (without the background option) by pressing Ctrl-C in the same
Telnet or console session, or by entering a clear top [report_num] command from a separate Telnet or
console session. The prompt is not printed before the TopN report is displayed completely. Other
commands are blocked until the report has displayed.

Examples This example shows how to start the TopN process with the background option:
Console> show top 10 util interval 10 background
03/21/1999,14:05:38:MGMT-5: TopN report 2 started by telnet/172.20.22.7/.
Console>
03/21/1999,14:15:38:MGMT-5: TopN report 2 available.

This example shows how to start the TopN process without the background option:
Console> show top 10 util interval 10
Start Time: 04/09/1999,01:12:48
End Time: 04/09/1999,01:12:58
PortType: all
Metric: util
Port Band- Uti Bytes Pkts Bcst Mcst Error Over
width % (Tx + Rx) (Tx + Rx) (Tx + Rx) (Tx + Rx) (Rx) flow
----- ----- --- -------------------- ---------- ---------- ---------- ----- ----
3/1 100 0 13824 9 0 0 11 0
6/48 10 0 0 0 0 0 0 0
6/47 10 0 0 0 0 0 0 0
6/46 10 0 0 0 0 0 0 0
6/45 10 0 0 0 0 0 0 0
Console>

Related Commands clear top

show top

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-625
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show top report

show top report

Use the show top report command to list all TopN processes and specific TopN reports.

show top report [report_num]

Syntax Description report_num (Optional) TopN report number for each process.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines If you do not specify report_num, this command lists all the active TopN processes and all the available
TopN reports for the switch. Each process is associated with a unique report number. All TopN processes
(both with and without background option) are shown in the list.
An asterisk displayed after the pending status field indicates that it is not a background TopN and the
results are not saved.

Examples This example shows how to display all the active TopN processes and all the available TopN reports for
the switch:
Console> show top report
Rpt Start time Int N Metric Status Owner (type/machine/user)
--- ------------------- --- --- ---------- -------- -------------------------
1 03/21/1999,11:34:00 60 20 Tx/Rx-Bytes done telnet/172.20.22.7/
2 03/21/1999,11:34:08 600 10 Util done telnet/172.34.39.6/
4 03/21/1999,11:35:17 300 20 In-Errors pending Console//
5 03/21/1999,11:34:26 60 20 In-Errors pending* Console//
Console>

This example shows an attempt to display a TopN report 5 (shown in the first example) that is still in
pending status:
Console> show top report 5
Rpt Start time Int N Metric Status Owner (type/machine/user)
--- ------------------- --- --- ---------- -------- -------------------------
5 03/21/1999,11:34:26 60 20 In-Errors pending* Console//
Console>

This example shows how to display the available TopN report 2 (shown in the first example) for the
switch:
Console> show top report 2
Start Time: 03/21/1999,11:34:00
End Time: 03/21/1999,11:34:33
PortType: all

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-626 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show top report

Metric: util
Port Band- Uti Tx/Rx-bytes Tx/Rx-pkts Tx/Rx-bcst Tx/Rx-mcst In- Buf-
width % err Ovflw
----- ----- --- -------------------- ---------- ---------- ---------- ---- -----
/15 100 88 98765432109876543210 9876543210 98765 12345 123 321
5/48 10 75 44532 5389 87 2 0 0
5/47 10 67 5432 398 87 2 0 0
5/46 10 56 1432 398 87 2 0 0
5/45 10 54 432 398 87 2 0 0
5/44 10 48 3210 65 10 10 15 5
5/43 10 45 432 5398 87 2 2 0
5/42 10 37 5432 398 87 2 0 0
5/41 10 36 1432 398 87 2 0 0
5/40 10 14 2732 398 87 2 0 0
Console>

Related Commands clear top

show top

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-627
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show trace

show trace
Use the show trace command to display trace category and level.

show trace [all]

Syntax Description all (Optional) Keyword that displays all trace category and level information.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the active trace category and level information only:
Console> show trace
Trace monitor is enabled for this session.
Trace Category Level
-------------- -----
HTTP 3
SYNFIG 5
Console>

This example shows how to display all trace category and level information:
Console> show trace all
Trace monitor is enabled for this session.
Trace Category Level
-------------- -----
ACCT off
ACL off
BDD off
CDP off
CONFIG off
COPS off
DHCP off
DIAG off
DNS off
DRIP off
DTP off
DUPFLASH off
DUPNVRAM off
DYNVLAN off
EARL off
ENVMON off
EOBC off
EPLD off
ESSR off
EVMGR off
FCP off
FDDI off

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-628 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show trace

FDDI off
FILESYS off
HAMGR off
HTTP off
GARP off
GVRP off
INBAND off
IPC off
KERBEROS off
L3AGE off
L3SUP off
LANE off
LD off
LLC off
LTL off
MBUF off
MCAST off
MDG off
MEMDBG off
MLS off
MLSM off
MODPORT off
NTP off
NVSYNC off
OOB off
PAGP off
PROTFILT off
PPWR off
PRUNING off
PRIVATEVLAN off
QOS off
RADIUS off
REDUN off
RSFC off
RSVP off
RUNTIMECFG off
SCP off
SECURITY off
SLP off
SNMP off
SPAN off
STP off
SYNCMGR off
SYNFIG off
SYSLOG 1
TACACS off
TEST off
TFTP off
TFTPD off
UDLD off
VERB off
VMPS 1
VTP off
Console>

Related Commands set trace

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-629
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show traffic

show traffic
Use the show traffic command to display Traffic and Peak information for each switching bus.

show traffic

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display Traffic and Peak information for each switching bus:
Console> show traffic
Switching-Bus Traffic Peak Peak-Time
------------- ------- ---- -------------------------
A 5% 10% Thu Mar 18 1999, 22:45:20
B 4% 15% Fri Mar 19 1999, 09:59:31
C 6% 8% Fri Mar 19 1999, 11:30:13
Console>

Related Commands show system

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-630 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show trunk

show trunk
Use the show trunk command to display trunking information for the switch.

show trunk [mod_num[/port_num]] [detail]

Syntax Description mod_num (Optional) Number of the module.

/port_num (Optional) Number of the port.
detail (Optional) Keyword that shows detailed information about the specified trunk port.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines Using the show trunk command without a module or port number displays the actively trunking ports.
To display the trunking configuration for a port that is not actively trunking, specify the module and port
number of the port you want to display.

Examples This example shows how to display trunking information for the switch:
Console> (enable) show trunk
* - indicates vtp domain mismatch
Port Mode Encapsulation Status Native vlan
-------- ----------- ------------- ------------ -----------
2/1 auto dot1q trunking 1
4/9 auto isl trunking 1
4/10 desirable isl trunking 1

Port Vlans allowed on trunk

-------- ---------------------------------------------------------------------
2/1 1-1005
4/9 1-1005
4/10 1-1005
Port Vlans allowed and active in management domain
-------- ---------------------------------------------------------------------
2/1 1-5,10,50,152,500,521-524,570
4/9 1,4-5,1003,1005
4/10 1,4-5,1003,1005

Port Vlans in spanning tree forwarding state and not pruned

-------- ---------------------------------------------------------------------
2/1 1-5,10,50,152,500,521-524,570
4/9 1005
4/10 1005
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-631
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show trunk

This example shows how to display trunking information for a specific port:
Console> (enable) show trunk 4/5
* - indicates vtp domain mismatch

Port Mode Encapsulation Status Native vlan

-------- ----------- ------------- ------------ -----------
4/5 nonegotiate dot1q trunking 1

Port Vlans allowed on trunk

-------- ---------------------------------------------------------------------
4/5 1-1005

Port Vlans allowed and active in management domain

-------- ---------------------------------------------------------------------
4/5 1-3,1003,1005

Port Vlans in spanning tree forwarding state and not pruned

-------- ---------------------------------------------------------------------
4/5 1005
Console> (enable)

Table 2-70 describes the fields in the show trunk command output.

Table 2-70 show trunk Command Output Fields

Field Description
Port Module and port numbers.
Mode Trunk administrative status of the port (on, off, auto, or desirable).
Encapsulation Trunking type configured by administration.
Status Status of whether the port is trunking or nontrunking.
Native VLAN Number of the native VLAN for the trunk link (for 802.1Q trunks, the
VLAN for which untagged traffic can be transmitted and received
over the trunk; for ISL trunks, packets are tagged on all VLANs,
including the native VLAN).
Vlans allowed on trunk Range of VLANs allowed to go on the trunk (default is 1 to 1000).
Vlans allowed and active in Range of active VLANs within the allowed range.
management domain
Vlans in spanning tree Range of VLANs that actually go on the trunk with Spanning Tree
forwarding state and not Protocol forwarding state.
pruned

Related Commands set trunk

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-632 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show udld

show udld
Use the show udld command to display Unidirectional Link Detection Protocol (UDLD) information.

show udld

show udld port [mod_num[/port_num]]

Syntax Description port Keyword that specifies module or ports.

mod_num (Optional) Number of the module for which UDLD information is
displayed.
/port_num (Optional) Number of the port for which UDLD information is
displayed.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to find out whether UDLD is enabled or disabled:
Console> show udld
UDLD : enabled
Console>

This example shows how to display UDLD information for module 2 port 1:
Console> show udld port 2/1
UDLD :enabled
Port Admin Status Link State
-------- ------------ ----------------
2/1 enabled undetermined
Console>

This example shows how to display UDLD information for all ports on module 3:
Console> (enable) show udld port 3
UDLD : enabled
Port Admin Status Link State
-------- ------------ ----------------
3/1 enabled undetermined
3/2 enabled undetermined
3/3 enabled undetermined
3/4 enabled undetermined
3/5 enabled undetermined
3/6 disabled not applicable
3/7 disabled not applicable
3/8 disabled not applicable

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-633
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show udld

Table 2-71 describes the fields in the show udld command output.

Table 2-71 show udld Command Output Fields

Field Description
UDLD Status of whether UDLD is globally enabled or disabled
Port Module and port numbers
Admin Status Status of whether UDLD is enabled or disabled on a per-port basis
Link State Status of the link: undetermined (detection in progress, UDLD has
been disabled on the neighbors), not applicable (UDLD is not
supported on the port, UDLD has been disabled on the port, or the
port is disabled), shutdown (unidirectional link has been detected
and the port disabled), bidirectional (bidirectional link has been
detected)

Related Commands set udld

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-634 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show users

show users
Use the show users command to determine whether the console port is active and to list all active Telnet
sessions with the IP address or IP alias of the originating host.

show users [noalias]

Syntax Description noalias (Optional) Keyword used to force the display of IP addresses, not IP
aliases.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the users of the active Telnet and shell sessions:
Console> show users
Session User Location
------------- --------------- ------------------------------
console
ssh 172.16.10.75
telnet 171.31.1.203
Console>

Related Commands disconnect

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-635
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show version—switch

show version—switch
Use the show version command to display software and hardware version information for switching and
supervisor engine modules only.

show version [mod]

Syntax Description mod (Optional) Number of the module.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the software and hardware versions:
Console> show version
WS-C4403 Software, Version NmpSW: 6.1(0.24)FTL
Copyright (c) 1995-1999 by Cisco Systems
NMP S/W compiled on Aug 31 1999, 12:59:28

System Bootstrap Version: 5.2(1)

System Web Interface Version: 5.0(0.25)

Hardware Version: 1.0 Model: WS-C4403 Serial #: SCA032100T8

Mod Port Model Serial # Versions

--- ---- ------------------- ----------- --------------------------------------
1 2 WS-X5K-SUP1-2GE SAD03232101 Hw : 4.0
Fw : 5.2(1)
Fw1: 4.2(0.24)VAI78
Sw : 5.3(0.74)MIA7-Eng
Sw1: 5.3(0.74)MIA7
3 48 WS-X5223-RJ-45 SAD03257164 Hw : 1.1
Fw : 4.2(0.24)VAI78
Sw : 5.3(0.74)MIA7
5 48 WS-X5223-RJ-45 SAD03257171 Hw : 1.1
Fw : 4.2(0.24)VAI78
Sw : 5.3(0.74)MIA7

DRAM FLASH NVRAM

Module Total Used Free Total Used Free Total Used Free
------ ------- ------- ------- ------- ------- ------- ----- ----- -----
1 65408K 24747K 40661K 16384K 14543K 1841K 512K 203K 309K

Uptime is 2 days, 0 hour, 41 minutes

Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-636 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show version—switch

This example show how to display version information for a specific module:
Console> (enable) show version 2
Mod Port Model Serial # Versions
--- ---- ------------------- ----------- --------------------------------------
2 1 WS-X4003- JAB0343055Y Hw : 0.201
Fw : 4.2(0.24)DAY68
Sw : 6.1(0.24)FTL
Console> (enable)

Table 2-72 describes the fields in the show version command output.

Table 2-72 show version Command Output Fields

Field Description
McpSW Version number of the MCP software.
NmpSW Version number of the NMP software.
NMP S/W compiled on Date and time that the NMP software was compiled.
1
MCP S/W compiled on Date and time that the MCP software was compiled.
System Bootstrap System bootstrap version number.
Version
Web Interface Version Web interface version number.
Hardware Version Hardware version number.
Model Switch model number.
Serial # Switch serial number.
Module Module number.
Ports Number of ports on the module.
Model Model number of the module.
Serial # Serial number of the module.
Hw Hardware version of the module.
Fw Version of the firmware installed on the module. If this is a
supervisor engine module, the Fw version number is the NMP boot
ROM version level.
Fw1 Version of the second firmware image on the module, if present. If
this is a supervisor engine module, the Fw1 version number is the
MCP boot ROM version level.
Sw Version of the software installed on the module.
1
Gsp Version of the gigabit switching platform.
1
Nmp Version of the supervisor engine software.
Module Module number.
DRAM Total Total dynamic RAM installed on the module.
Used Amount of DRAM in use.
Free Amount of available DRAM.
FLASH Total Total Flash memory installed on the module.
Used Amount of Flash memory in use.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-637
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show version—switch

Table 2-72 show version Command Output Fields (continued)

Field Description
Free Amount of available Flash memory.
NVRAM Total Total NVRAM installed on the module.
Used Amount of NVRAM in use.
Free Amount of available NVRAM.
Used Amount of NVRAM in use.
Available Amount of NVRAM available.
Uptime is Number of uninterrupted days, hours, minutes, and seconds the
system has been up and running.
1. This field is not supported on the Catalyst 4000 family and 2948G switches.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-638 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show vlan

show vlan
Use the show vlan command to display VLAN information.

show vlan [trunk]

show vlan vlan [notrunk]

show vlan mapping

show vlan type

Syntax Description trunk (Optional) Keyword that specifies to force the display to show information
only on trunk ports.
vlan Number of the VLAN. If the VLAN number is not specified, all VLANs are
displayed.
notrunk (Optional) Keyword that specifies to force the display to show information
only on nontrunk ports.
mapping Keyword to display VLAN mapping table information.
type Type of VLAN. Valid values are Ethernet, FDDI, and FDDInet.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines Each Ethernet switch port and Ethernet repeater group belong to only one VLAN. Trunk, FDDI/CDDI,
and ATM ports can exist on multiple VLANs.

Examples This example shows how to display information for all VLANs:
Console> show vlan
VLAN Name Status IfIndex Mod/Ports, Vlans
---- -------------------------------- --------- ------- ------------------------
1 default active 5 1/2
6/1-48
7/2-24
2 VLAN0002 active 339
5 VLAN0005 active 342
50 VLAN0050 active 346
100 VLAN0100 active 347
152 VLAN0152 active 348
200 VLAN0200 active 349
300 VLAN0300 active 350
305 VLAN0305 active 354

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-639
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show vlan

801 VLAN0801 active 338 338 802

VLAN Type SAID MTU Parent RingNo BrdgNo Stp BrdgMode Trans1 Trans2
---- ----- ---------- ----- ------ ------ ------ ---- -------- ------ ------
1 enet 100001 1500 - - - - - 0 0
10 enet 100010 1500 - - - - - 0 0
901 enet 100901 1500 - - - - - 0 0
999 trbrf 100999 4472 - - 0xe ieee - 0 0
1002 fddi 101002 1500 - 0x0 - - - 0 0
1003 trcrf 101003 1500 0 0x0 - - - 0 0
1004 fdnet 101004 1500 - - 0x0 ieee - 0 0
1005 trbrf 101005 1500 - - 0x0 ibm - 0 0

VLAN AREHops STEHops Backup CRF

---- ------- ------- ----------
1003 7 7 off
Console>

This example shows how to display information for all VLAN trunks:
Console> show vlan trunk
VLAN Name Status IfIndex Mod/Ports, Vlans
---- -------------------------------- --------- ------- ------------------------
1 default active 5 2/1-2
6/4-8
10 VLAN0010 active 18 6/1,6/3
11 VLAN0011 active 19 6/2
20 VLAN0020 active 20
21 VLAN0021 active 21
30 VLAN0030 active 22
31 VLAN0031 active 23
1002 fddi-default active 6
1003 token-ring-default active 9
1004 fddinet-default active 7
1005 trnet-default active 8 8

VLAN Type SAID MTU Parent RingNo BrdgNo Stp BrdgMode Trans1 Trans2
---- ----- ---------- ----- ------ ------ ------ ---- -------- ------ ------
1 enet 100001 1500 - - - - - 0 0
10 enet 100010 1500 - - - - - 0 0
11 enet 100011 1500 - - - - - 0 0
20 enet 100020 1500 - - - - - 0 0
21 enet 100021 1500 - - - - - 0 0
30 enet 100030 1500 - - - - - 0 0
31 enet 100031 1500 - - - - - 0 0
1002 fddi 101002 1500 - - - - - 0 0
1003 trcrf 101003 1500 0 0x0 - - - 0 0
1004 fdnet 101004 1500 - - 0x0 ieee - 0 0
1005 trbrf 101005 1500 - - 0x0 ibm - 0 0

VLAN Inst DynCreated RSPAN

---- ---- ---------- --------
1 1 static disabled
10 static disabled
11 static disabled
20 static disabled
21 static disabled
30 static disabled
31 static disabled
1002 - static disabled
1003 1 static disabled
1004 2 static disabled
1005 - static disabled

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-640 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show vlan

VLAN AREHops STEHops Backup CRF 1q VLAN

---- ------- ------- ---------- -------
1003 7 7 off

Primary Secondary Secondary-Type Ports

------- --------- -------------- ------------
10 20 isolated 6/1,6/3
11 21 isolated 6/2
30 - -
- 31 isolated

This example shows how to display the VLAN mapping table information:
Console> show vlan mapping
802.1q vlan ISL vlan Effective
------------------------------------------
3000 300 true
Console>

This example shows how to display information for a specific VLAN and type:
Console> show vlan 2 fddi
VLAN Name Status IfIndex Mod/Ports, Vlans
---- -------------------------------- --------- ------- ------------------------
1002 fddi-default active 6

VLAN Type SAID MTU Parent RingNo BrdgNo Stp BrdgMode Trans1 Trans2
---- ----- ---------- ----- ------ ------ ------ ---- -------- ------ ------
2 fddi 101002 1500 - - - - - 0 0

VLAN Inst DynCreated RSPAN

---- ---- ---------- --------
2 - static disabled
Console>

This example shows how to display information for nontrunk ports only on a specific VLAN:
Console> (enable) show vlan 2 notrunk
VLAN Name Status IfIndex Mod/Ports, Vlans
---- -------------------------------- --------- ------- ------------------------
2 VLAN0002 active 60

VLAN Type SAID MTU Parent RingNo BrdgNo Stp BrdgMode Trans1 Trans2
---- ----- ---------- ----- ------ ------ ------ ---- -------- ------ ------
2 enet 100002 1500 - - - - - 0 0

VLAN Inst DynCreated RSPAN

---- ---- ---------- --------
2 - static disabled

VLAN AREHops STEHops Backup CRF 1q VLAN

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

Console>

Table 2-73 describes the fields in the show vlan command output.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-641
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show vlan

Table 2-73 show vlan Command Output Fields

Field Description
VLAN VLAN number.
Name Name, if configured, of the VLAN.
Status Status of the VLAN (active or suspend).
IfIndex Interface Index, assigned by SNMP.
Mod/Ports, VLANs Ports that belong to the VLAN.
Type Media type of the VLAN.
SAID Security association ID value for the VLAN.
MTU Maximum transmission unit size for the VLAN.
Parent Parent VLAN, if one exists.
RingNo Ring number for the VLAN, if applicable.
BrdgNo Bridge number for the VLAN, if applicable.
Stp Spanning-Tree Protocol type used on the VLAN.
BrdgMode Bridging mode for this VLAN. Possible values are SRB and SRT; the
default is SRB.
Trans1 First translational VLAN used to translate FDDI or Token Ring to
Ethernet.
Trans2 Second translational VLAN used to translate FDDI or Token Ring to
Ethernet.
AREHops Maximum number of hops for All-Routes Explorer frames. Possible values
are 1 through 13; the default is 7.
STEHops Maximum number of hops for Spanning-Tree Explorer frames. Possible
values are 1 through 13; the default is 7.
Backup CRF Status of whether the TrCRF is a backup path for traffic.

Related Commands set trunk

set vlan
show trunk

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-642 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show vmps

show vmps
Use the show vmps command to display VLAN Membership Policy Server (VMPS) configuration
information.

show vmps [noalias]

Syntax Description noalias (Optional) Keyword that specifies to force the display to show IP
addresses, not IP aliases.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display VMPS configuration information for the Catalyst 4000 family
switches:
Console> show vmps
VMPS Client Status:
---------------------
VMPS VQP Version: 1
Reconfirm Interval: 60 min
Server Retry Count: 3
VMPS domain server:

No dynamic ports configured.

Console>

Table 2-74 describes the fields in the show vmps command output.

Table 2-74 show vmps Command Output Fields

Field Description
VMPS Server Status Status of VMPS server
Management Domain Management domain supported by this server
State Status on whether VMPS is enabled or disabled
Operational Status VMPS status (active, inactive, or downloading)
TFTP Server IP address of the VMPS server
TFTP File VMPS configuration filename
Fallback VLAN VLAN assigned if a VLAN is not assigned to a MAC address in the
database
Secure Mode Secure mode status (open or secure)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-643
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show vmps

Table 2-74 show vmps Command Output Fields (continued)

Field Description
VMPS No Domain Req Status on whether the server accepts requests from clients with no
domain name
VMPS Client Status Status of the VMPS client
VMPS VQP Version Version of VMPS VQP
VMPS domain server VMPS domain server name

Related Commands set vmps server

set vtp
show dvlan statistics
show vmps statistics

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-644 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show vmps statistics

show vmps statistics

Use the show vmps statistics command to display the VLAN Membership Policy Server (VMPS)
statistics (based on the results of the reconfirm vmps command).

show vmps statistics

Syntax Description This command has no keywords or arguments.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display the VMPS statistics:

Console> show vmps statistics
VMPS Statistics:
Last Enabled At: 2,01:30:05
Config Requests: 20
Invalid Requests: 0
Status 'Error' Responses: 0
Status 'Deny' Responses: 5
MAC Address of Last Failed Request: 00-60-00-cc-01-02
Console>

Table 2-75 describes the fields in the show vmps statistics command output.

Table 2-75 show vmps statistics Command Output Fields

Field Description
Last Enabled At Time when the VMPS was enabled
Config Requests Number of configuration requests
Invalid Requests Number of invalid requests
Status ‘Error’ Responses Number of error responses
Status ‘Deny’ Responses Number of “Access Denied” and “Port Shutdown” responses
MAC Address of Last MAC address of the last request for which the response was not
Failed Request successful

Related Commands set vmps server

set vtp
show dvlan statistics
show vmps

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-645
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show vtp domain

show vtp domain

Use the show vtp domain command to display VLAN Trunk Protocol (VTP) domain information.

show vtp domain

Syntax Description This command has no keywords or arguments.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display VTP domain information:

Console> show vtp domain
Domain Name Domain Index VTP Version Local Mode Password
-------------------------------- ------------ ----------- ----------- ----------
1 2 server -

Vlan-count Max-vlan-storage Config Revision Notifications

---------- ---------------- --------------- -------------
15 1023 5 disabled

Last Updater V2 Mode Pruning PruneEligible on Vlans

--------------- ------- -------- -------------------------
172.20.44.30 enabled disabled 2-1000
Console>

Table 2-76 describes the fields in the show vtp domain command output.

Table 2-76 show vtp domain Command Output Fields

Field Description
Domain Name Name of the VTP domain
Domain Index Domain index number of the domain
VTP Version VTP version number
Local Mode VTP mode (server, client, or transparent)
Password Password required or not
Vlan-count Total number of VLANs in the domain
Max-vlan-storage Maximum number of VLANs allowed on the device
Config Revision VTP revision number used to exchange VLAN information
Notifications Notifications to SNMP (enabled or disabled)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-646 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show vtp domain

Table 2-76 show vtp domain Command Output Fields (continued)

Field Description
Last Updater IP address through which VTP was last updated
V2 Mode Status of VTP V2 mode is enabled or disabled
Pruning Status of VTP pruning is enabled or disabled
PruneEligible on Vlans VLANs on which pruning is allowed

Related Commands set vtp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-647
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show vtp statistics

show vtp statistics

Use the show vtp statistics command to display VLAN Trunk Protocol (VTP) statistics.

show vtp statistics

Syntax Description This command has no keywords or arguments.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Examples This example shows how to display VTP statistics:

Console> show vtp statistics
VTP statistics:
summary advts received 0
subset advts received 0
request advts received 0
summary advts transmitted 1
subset advts transmitted 1
request advts transmitted 0
No of config revision errors 0
No of config digest errors 0

VTP pruning statistics:

Trunk Join Transmitted Join Received Summary advts received from

non-pruning-capable device
-------- --------------- ------------- ---------------------------
5/1-2
Console>

Table 2-77 describes the fields in the show vtp statistics command output.

Table 2-77 show vtp statistics Command Output Fields

Field Description
summary advts received Total number of summary advt received.
subset advts received Total number of subset advt received.
request advts received Total number of request advts received.
summary advts transmitted Total number of summary advts transmitted.
subset advts transmitted Total number of subset advts transmitted.
request advts transmitted Total number of request advts transmitted.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-648 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
show vtp statistics

Table 2-77 show vtp statistics Command Output Fields (continued)

Field Description
No of config revision errors Number of config revision errors that have occurred.
No of config digest errors Number of config revision digest errors that have occurred.
Trunk Trunk port participating in VTP pruning.
Join Transmitted Number of VTP-Pruning Joins transmitted.
Join Received Number of VTP-Pruning Joins received.
Summary advts received Number of summary advts received from nonpruning-capable
from non-pruning-capable devices.
device

Related Commands clear vtp statistics

set vtp

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-649
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
slip

slip
Use the slip command to attach or detach Serial Line Internet Protocol (SLIP) for the console port.

slip {attach | detach}

Syntax Description attach Keyword that specifies to attach the Unidirectional Link Detection
Protocol (UDLD) feature.
detach Keyword that specifies to detach SLIP for the console port.

Defaults By default, SLIP is not active (detached).

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines You can enter the slip command from a console port session or a Telnet session.

Examples This example shows how to attach SLIP to a console port during a console port session:
Console> (enable) slip attach
Console port now running SLIP.
<console port running SLIP>

This example shows how to detach SLIP from a console port during a Telnet session:
Console> (enable) slip detach
SLIP detached on Console port.
<console port back to RS-232 Console>
Console> (enable)

Related Commands set interface

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-650 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
sprom read

sprom read
Use the sprom read command to display the contents of the SPROM.

sprom read {mod} [submodule] [chassis]

Syntax Description mod Number of the module.

submodule (Optional) Keyword that specifies the submodule of a specific
module.
chassis (Optional) Keyword that specifies the chassis SPROM information
of the Catalyst 4006 switch.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Examples This example shows how to display SPROM information on module 1:

rommon 5 > sprom read 1
Manipulating sprom at address 160.

Contents of Supervisor ID PROM:

Common ELB portion of ID PROM at address 160:

Block signature: 0xabab

Block version: 1
Block length: 144
Block checksum: 0xfb8
ID prom size: 256
Block count: 2
FRU major type: 0x4101
FRU minor type: 300
OEM string: Cisco Systems, Inc.
Product number string: WS-X4012
Serial number string: JAB03130104
Part number string: 73-3188-04
Part revision string: A0
Mfg deviation string:
HW major revision: 1
HW minor revision: 5
Mfg bits: 0
Eng bits: 0
SNMP OID: 0.0.0.0.0.0.0.0
Power consumption: 0
RMA failure code: 0-0-0-0

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-651
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
sprom read

Supervisor ID PROM Contents:

Block signature: 0x4101

Block version: 1
Block length: 24
Block checksum: 0x2c9
Feature bits: 0x0
Card index: 49
MAC addresses: 00:d0:58:70:a1:00 through 00:d0:58:70:a4:ff (1024 addresses)
rommon 6 >

This example shows how to display submodule SPROM information on module 2:

rommon 5 > sprom read 2 submodule
Manipulating sprom at address 120.

Contents of Supervisor ID PROM:

Common ELB portion of ID PROM at address 120:

Block signature: 0xabab

Block version: 1
Block length: 144
Block checksum: 0xfb8
ID prom size: 256
Block count: 2
FRU major type: 0x4101
FRU minor type: 300
OEM string: Cisco Systems, Inc.
Product number string: WS-X4012
Serial number string: JAB03130104
Part number string: 73-3188-04
Part revision string: A0
Mfg deviation string:
HW major revision: 1
HW minor revision: 5
Mfg bits: 0
Eng bits: 0
SNMP OID: 0.0.0.0.0.0.0.0
Power consumption: 0
RMA failure code: 0-0-0-0

Supervisor ID PROM Contents:

Block signature: 0x4101

Block version: 1
Block length: 24
Block checksum: 0x2c9
Feature bits: 0x0
Card index: 49
MAC addresses: 00:d0:58:70:a1:00 through 00:d0:58:70:a4:ff (1024 addresses)
rommon 6 >

This example shows how to display the Catalyst 4006 chassis SPROM information:
rommon 2 > sprom read chassis
Manipulating sprom at address 160.

Contents of Chassis ID PROM:

Common ELB portion of ID PROM at address 160:

Block signature: 0xabab

Block version: 1

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-652 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
sprom read

Block length: 144

Block checksum: 0x10bf
ID prom size: 256
Block count: 2
FRU major type: 0x4001
FRU minor type: 24
OEM string: Cisco Systems, Inc.
Product number string:WS-C4006
Serial number string: FOX03499057
Part number string: 73-4289-02
Part revision string: 02
Mfg deviation string: 0x00
HW major revision: 0
HW minor revision: 2
Mfg bits: 0
Eng bits: 0
SNMP OID: 0.0.0.0.0.0.0.0
Power consumption: 0
RMA failure code: 0-0-0-0

Chassis ID PROM Contents:

Block signature:0x4001
Block version: 1
Block length: 22
Block checksum: 0x28a
Feature bits: 0x0
MAC addresses: 00:30:94:fc:6e:00 through 00:30:94:fc:71:ff (1024 addresses)
rommon 3 >

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-653
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
squeeze—ROM monitor

squeeze—ROM monitor
Use the squeeze command to reclaim space used by deleted files in Flash memory.

squeeze device:

Syntax Description device: Device where the Flash device resides. The Catalyst 4000 family,
Catalyst 2948G, and Catalyst 2980G switches only support the
device bootflash.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Examples This example shows how to delete a bootflash file:

rommon 1 > squeeze bootflash:
rommon 2 >

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-654 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
squeeze—switch

squeeze—switch
Use the squeeze command to delete Flash memory files permanently.

squeeze [m/]device:

Syntax Description m/ (Optional) Module number of the supervisor engine containing the
Flash device.
device: Device where the Flash device resides.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines A colon (:) is required after the specified device.

Examples These examples show how to use the squeeze command to delete slot0 Flash memory files and then use
the show flash command to confirm the deletion:
Console> squeeze slot0:
All deleted files will be removed, proceed (y/n) [n]?y
Squeeze operation may take a while, proceed (y/n) [n]?y
..........................................................
Console> show flash
-#- ED --type-- --crc--- -seek-- nlen -length- -----date/time------ name
1 .. 2 43B312DF 100fc0 15 1052608 Aug 12 1998 10:23:30 cat5k_r47_1.cbi

7336000 bytes available (1052608 bytes used)

Console>

Related Commands dir—switch

show flash
undelete—switch

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-655
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
sync

sync
Use the sync command to write the current working copy of environment variables and aliases to
NVRAM so that they are read on the next reset.

sync

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Examples This example shows how to use the sync command:

rommon 10 > sync
rommon 11 >

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-656 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
telnet

telnet
Use the telnet command to start a Telnet connection to a remote host.

telnet host [port_num]

Syntax Description host Name or IP address of the remote host to which you want to connect.
port_num (Optional) Specific port connection on the remote host.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to open and close a Telnet session with the host elvis:
Console> (enable) telnet elvis
Trying 192.122.174.11...
Connected to elvis.
Escape character is ’^]’.

UNIX(r) System V Release 4.0 (elvis)

login: fred
Password:
Last login: Thu Jun 11 09:25:01 from forster.cisc.rum
Sun Microsystems Inc. SunOS 5.4 Generic July 1994
You have new mail.
% logout

Console> (enable)

Related Commands disconnect

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-657
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
test snmp trap

test snmp trap

Use the test snmp trap command to send an SNMP trap message to the trap receivers.

test snmp trap trap_num [specific_num]

Syntax Description trap_num Number of the trap.

specific_num (Optional) Number of a predefined trap.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to run trap 0:

Console> (enable) test snmp trap 0
SNMP trap message sent. (4)
Console> (enable)

Related Commands set snmp trap

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-658 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
traceroute

traceroute
Use the traceroute command to display a hop-by-hop path through an IP network from the switch to a
specific destination host.

traceroute [-n] [-w wait_time] [-i initial_ttl] [-m max_ttl] [-p dest_port] [-q nqueries] [-t tos]
host [data_size]

Syntax Description -n (Optional) Prevents traceroute from performing a DNS lookup for each hop on the
path. Only numerical IP addresses are printed.
-w wait_time (Optional) Specifies the amount of time (in seconds) that traceroute will wait for an
ICMP response message. The allowed range for wait_time is 1 to 300 seconds; the
default is 5 seconds.
-i initial_ttl (Optional) Causes traceroute to send ICMP datagrams with a TTL value equal to
initial_ttl instead of the default TTL of 1. This causes traceroute to skip processing
for hosts that are less than initial_ttl hops away.
-m max_ttl (Optional) Specifies the maximum TTL value for outgoing ICMP datagrams. The
allowed range for max_ttl is 1 to 255; the default value is 30.
-p dest_port (Optional) Specifies the base UDP destination port number used in traceroute
datagrams. This value increments each time a datagram is sent. The allowed range for
dest_port is 1 to 65535; the default base port is 33434. Use this option in the unlikely
event that the destination host is listening to a port in the default traceroute port range.
-q nqueries (Optional) Specifies the number of datagrams to send for each TTL value. The allowed
range for nqueries is 1 to 1000; the default is 3.
-t tos (Optional) Specifies the TOS to be set in the IP header of the outgoing datagrams. The
allowed range for tos is 0 to 255; the default is 0. Use this option to see if different
types of service cause routes to change.
host IP alias or IP address in dot notation (a.b.c.d) of the destination host.
data_size (Optional) Number of bytes, in addition to the default of 40 bytes, of the outgoing
datagrams. The allowed range is 0 to 1420; the default is 0.

Defaults Entering the traceroute host command without options sends three 40-byte ICMP datagrams with an
initial TTL of 1, a maximum TTL of 30, a timeout period of 5 seconds, and a TOS specification of 0 to
destination UDP port number 33434. For each host in the processed path, the initial TTL for each host
and the destination UDP port number for each packet sent are incremented by one.

Command Types Switch command.

Command Modes Privileged.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-659
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
traceroute

Usage Guidelines To interrupt traceroute after the command has been issued, press Ctrl-C.
The traceroute command uses the TTL field in the IP header to cause routers and servers to generate
specific return messages. Traceroute starts by sending a UDP datagram to the destination host with the
TTL field set to 1. If a router finds a TTL value of 1 or 0, it drops the datagram and sends back an ICMP
“time exceeded” message to the sender. The traceroute facility determines the address of the first hop
by examining the source address field of the ICMP time-exceeded message.
To identify the next hop, traceroute again sends a UDP packet but this time with a TTL value of 2. The
first router decrements the TTL field by 1 and sends the datagram to the next router. The second router
sees a TTL value of 1, discards the datagram, and returns the time-exceeded message to the source. This
process continues until the TTL is incremented to a value large enough for the datagram to reach the
destination host (or until the maximum TTL is reached).
To determine when a datagram has reached its destination, traceroute sets the UDP destination port in
the datagram to a very large value, one that the destination host is unlikely to be using. In addition, when
a host receives a datagram with an unrecognized port number, it sends an ICMP “port unreachable” error
to the source. This message indicates to the traceroute facility that it has reached the destination.
Catalyst 4000 family switches can participate as the source or destination of the traceroute command.
However, because they are Layer 2 devices, these switches do not examine the TTL field in the IP header
and do not decrement the TTL field or send ICMP time-exceeded messages. A Catalyst 4000 family
switch does not appear as a hop in the traceroute command output.

Examples This example shows how to use the traceroute command to determine the path from the source to the
destination host server10:
Console> (enable) traceroute server10
traceroute to server10.company.com (172.16.22.7), 30 hops max, 40 byte packets
1 engineering-1.company.com (172.31.192.206) 2 ms 1 ms 1 ms
2 engineering-2.company.com (172.31.196.204) 2 ms 3 ms 2 ms
3 gateway_a.company.com (172.16.1.201) 6 ms 3 ms 3 ms
4 server10.company.com (172.16.22.7) 3 ms * 2 ms
Console> (enable)

Table 2-78 describes the fields in the traceroute command output.

Table 2-78 traceroute Command Output Fields

Field Description
30 hops max, 40 byte Maximum TTL value and the size of the ICMP datagrams being sent.
packets
2 ms 1 ms 1 ms Total time (in milliseconds) for each ICMP datagram to reach the router or
host plus the time it took for the ICMP time-exceeded message to return to
the host.
An exclamation point following any of these values (for example, 20 ms !)
indicates that the port-unreachable message returned by the destination had
a TTL of 0 or 1. Typically, this occurs when the destination uses the TTL
value from the arriving datagram as the TTL in its ICMP reply. The reply
does not arrive at the source until the destination receives a traceroute
datagram with a TTL equal to the number of hops between the source and
destination.
3 ms * 2 ms “*” indicates that the timeout period (default of 5 seconds) expired before
an ICMP time-exceeded message was received for the datagram.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-660 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
traceroute

If traceroute receives an ICMP error message other than a time-exceeded or port-unreachable message,
it prints one of the error codes shown in Table 2-79 instead of the round-trip time or an asterisk (*).

Table 2-79 traceroute Error Messages

ICMP Error Code Meaning

!N No route to host. The network is unreachable.
!H No route to host. The host is unreachable.
!P Connection refused. The protocol is unreachable.
!F Fragmentation needed but do not fragment (DF) bit was set.
!S Source route failed.
!A Communication administratively prohibited.
? Unknown error occurred.

Related Commands ping—switch

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-661
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
unalias

unalias
Use the unalias command to remove an alias name and its associated value from an alias list.

unalias name

Syntax Description name Name of the alias.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Examples This example shows how to use the unalias command to remove the s alias and then check to ensure it
was removed:
rommon 5 > alias
r=repeat
h=history
?=help
b=boot
ls=dir
i=reset
k=stack
s=set
rommon 6 > unalias s
rommon 7 > alias
r=repeat
h=history
?=help
b=boot
ls=dir
i=reset
k=stack
rmmon 8 > s
monitor: command "s" not found
===========================================================================

Related Commands alias

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-662 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
undelete—ROM monitor

undelete—ROM monitor
Use the undelete command to recover files that have been deleted.

undelete device:filename

Syntax Description device: Name of the device.

filename Name of the system image or configuration file to be recovered.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Usage Guidelines A colon (:) is required after the specified device.

You can undelete files until you use the squeeze command. When the squeeze command is used, all
deleted files are permanently deleted.

Examples This example shows how to recover a deleted file:

rommon 1 > undelete bootflash:cat4000.6-1-1.bin
rommon 2 >

Related Commands del

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-663
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
undelete—switch

undelete—switch
Use the undelete command to recover a deleted file on a Flash memory device. The deleted file can be
recovered using its index (because there could be multiple deleted files with the same name).

undelete index [[m/]device:]

Syntax Description index Index number of the deleted file.

m/ (Optional) Module number of the supervisor engine containing the
Flash device.
device: (Optional) name of the device where the Flash device resides.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines A colon (:) is required after the specified device.

Use the dir command to learn the index number of the file to be undeleted.
A file cannot be undeleted if a valid file with the same name exists. You must delete the existing file
before you can undelete the target file.
A file can be deleted and undeleted up to 15 times.
To delete all deleted files permanently on a device, use the squeeze—switch command.

Examples This example shows how to recover the deleted file with index 1 and use the show flash command to
confirm:
Console> (enable) undelete 1 bootflash:
Console> (enable) show flash
-#- ED --type-- --crc--- -seek-- nlen -length- -----date/time------ name
1 .. ffffffff a638976e 3627ec 23 3286891 Jan 01 1999 07:04:37 cat5000-supn
2 .. ffffffff a6a84c93 365f74 17 14086 Jan 29 1999 02:33:56 switch_confg
3 .. ffffffff 141a9127 70b7cc 29 3823575 Mar 09 1999 19:15:55 cat5000-supn

1428272 bytes available (6173904 bytes used)

Console> (enable)

Related Commands delete

show flash
squeeze—switch

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-664 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
unset=varname

unset=varname
Use the unset=varname command to remove a variable name from the variable list.

unset=varname

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Examples This example shows how to use the set command to display the variable list, use the unset command to
remove a variable name from the variable list, and then use the set command to display the variable list
to verify its removal:
rommon 2 > set
PS1=rommon ! >
BOOT=
?=0
rommon 3 > unset=0
rommon 4 > set
PS1=rommon ! >
BOOT=

Related Commands varname=

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-665
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
upload

upload
Use the upload command to upload a software image to a network host.

upload host file [mod_num] [rcp | tftp]

Syntax Description host IP address or IP alias of the host.

file Name of the image file.
mod_num (Optional) Number of the module from which to upload the image file.
rcp (Optional) Keyword that specifies to upload a software image to a
network host using rcp.
tftp (Optional) Keyword that allows you to copy to or from a TFTP server.

Defaults If you do not specify the type of upload method, TFTP is used. If no module number is specified, the
default is module 1.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines To upload a software image for the RSM, use the session command.

Examples This example shows how to upload the supervisor image to the c4006_11.bin file from the host mercury:
Console> (enable) upload mercury c4006_11.bin
Upload Module 1 image to c4006_11.bin on mercury (y/n) [n]? y
/
Done. Finished Network Upload. (153908 bytes)
Console> (enable)

This example shows how to upload the c4000_spv11.bin file from the host mercury to the supervisor
engine module using rcp:
Console> (enable) upload mercury c4000_spv11.bin rcp
Upload image c4000_spv11.bin from mercury to module 1FLASH (y/n) [n]? y
\
Finished network single module download. (2418396 bytes)
FLASH on Catalyst:

Type Address Location

Intel 28F008 20000000 NMP (P3) 4MB SIM

Erasing flash sector...done.

Programming flash sector...done.
Erasing flash sector...done.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-666 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
upload

Programming flash sector...done.

The system needs to be reset to run the new image.
Console> (enable)

Related Commands download

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-667
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
varname=

varname=
Use the varname= command to set the variable VARNAME to varvalue. The syntax varname= sets the
variable to a NULL string.

varname=value

Syntax Description varname= Name of the variable.

value Any ROM monitor command.

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Usage Guidelines Do not put a space before or after the equal (=) sign. If there are spaces, you must place the value in
quotes. Spell out variable names in capital letters to make them conspicuous.

Examples This example shows how to assign a variable name to a value:

rommon 1 > s=set
rommon 2 > s
PS1=rommon ! >
BOOT=
?=0

Related Commands unset=varname

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-668 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
verify

verify
Use the verify command to confirm the checksum of a file on a Flash device.

verify [[m/]device:] filename

Syntax Description m/ (Optional) Module number of the supervisor engine containing the
Flash device.
device: (Optional) Name of the device where the Flash device resides.
filename Name of the configuration file.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines A colon (:) is required after the specified device.

Examples This example shows how to use the verify command:

Console> verify cat4k_r47_1.cbi
..........................................................
File cat4k_r47_1.cbi verified OK.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-669
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
version

version
Use the version command to display software and hardware version information.

version

Syntax Description This command has no arguments or keywords

Defaults This command has no default settings.

Command Types ROM monitor command.

Command Modes Normal.

Examples This example shows how to display software and hardware versions:
rommon 8 > version
WS-X4012 bootrom version 4.5(1), built on 1999.03.29 21:04:04
H/W Revisions: Meteor: 4 Comet: 8 Board: 2
Supervisor MAC addresses: 00:d0:58:70:a1:00 through 00:d0:58:70:a4:ff (1024 addresses)
Installed memory: 64 MB
rommon 9 >

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-670 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
wait

wait
Use the wait command to cause the CLI to pause for a specified number of seconds before executing the
next command.

wait seconds

Syntax Description seconds Number of seconds for the CLI to wait.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Normal.

Usage Guidelines This command might be included in a configuration file.

Examples This example shows how to pause the CLI for 5 seconds:
Console> wait 5
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-671
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
whichboot

whichboot
Use the whichboot command to determine which file booted.

whichboot

Syntax Description This command has no arguments or keywords.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to determine which file has booted:
Console> whichboot
Boot image name is 'slot0:cat6000-sup.6-1-1.bin'.
Console>

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-672 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
write

write
Use the write command to upload or display nondefault configurations to a host, terminal, or memory.

write {host file | network | terminal} [rcp all]

write memory

Syntax Description host IP address or IP alias of the host.

file Name of the configuration file.
network Keyword that specifies interactive prompting for the IP address or
IP alias of the host and the filename to upload.
terminal Keyword that displays the nondefault configuration file on the
terminal.
rcp (Optional) Keyword that uploads a software image to a host using
RCP.
all (Optional) Keyword that specifies all modules and system
configuration information, including the IP address.
memory Keyword that uploads the current configuration to a specified
location

Defaults By default, the write command will upload or output only nondefault configurations. Use the keyword
all to upload or output both default and nondefault configurations.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines The write host file command is a shorthand version of the write network command.
You cannot use the write network command to upload software to the ATM module. With the write
network command, the file must already exist on the host (use the UNIX touch filename command to
create the file).
The write memory command is applicable only when the switch is set to save its configuration to a text
file.

Examples This sample session assumes that module 1 is a 2-port supervisor engine module; module 2 is a 12-port
10/100BASE-T switched Ethernet module; modules 3 and 5 are empty; and module 4 is a FDDI module.
Details of the ATM configuration must be accessed through the special module mode.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-673
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
write

This example shows how to upload the system5.cfg file to the mercury host using the write network
command:
Console> (enable) write network
IP address or name of host? mercury
Name of configuration file to write? system5.cfg
Upload configuration to system5.cfg on mercury (y/n) [y]? y
/
Done. Finished Network Upload. (9003 bytes)
Console> (enable)

This example shows how to upload the system5.cfg file to the mercury host using the write network rcp
command:
Console> (enable) write network rcp
IP address or name of host? mercury
Name of configuration file to write? system5.cfg
Upload configuration to system5.cfg on mercury (y/n) [y]? y
/
Done. Finished Network Upload. (9003 bytes)
Console> (enable)

This example shows how to upload the system5.cfg file to the mercury host using the write host file
command as a shorthand method:
Console> (enable) write mercury system5.cfg
Upload configuration to system5.cfg on mercury (y/n) [y]? y
/
Done. Finished Network Upload. (9003 bytes)
Console> (enable)

This example shows how to use the write terminal all command to display the entire (default and
nondefault) configuration file on the terminal (partial display):
Console> (enable) write terminal all
begin
set password $1$FMFQ$HfZR5DUszVHIRhrz4h6V70
set enablepass $1$FMFQ$HfZR5DUszVHIRhrz4h6V70
set prompt Console>
!
#system
set system baud 9600
set system modem disable
set system name
set system location
set system contact
!
#snmp
set snmp community read-only public
set snmp community read-write private
set snmp community read-write-all secret
set snmp trap disable
!
#vlan/trunk
set vlan 1 1/1-2,4/1
set vlan 2 2/1-5
!
#trunks
!
#cam
set cam agingtime 1 300
set cam agingtime 2 300
!
#ip

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-674 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
write

set interface sc0 0.0.0.0 0.0.0.0 0.0.0.0

set interface sl0 0.0.0.0 0.0.0.0
set ip redirect enable
set ip unreachable disable
set ip fragmentation enable
set ip alias default 0.0.0.0
set arp agingtime 1200
!
...
<<<<output truncated>>>>
Console> (enable)

This example shows how to upload the running system configuration to a pre-specified location:
Console> (enable) write memory
Upload configuration to bootflash:switch.cfg
7165844 bytes available on device bootflash, proceed (y/n) [n]? y
Console> (enable)

Related Commands copy

show config
set config mode

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-675
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
write tech-support

write tech-support
Use the write tech-support command to generate a report that contains status information about your
switch or to upload the output of the command to a TFTP server, so that you can send it to TAC.

write tech-support host file [module mod] [vlan vlan] [memory] [config]

write tech-support host file [port mod/port] [vlan vlan] [memory] [config]

Syntax Description host IP address or IP alias of the host.

file Name of the configuration file.
module mod (Optional) Keyword and variable that specifies the module number.
vlan vlan (Optional) Keyword and variable that specifies the VLAN. Valid
values are 1 to 1001.
memory Keyword that specifies memory and processor state information.
config Keyword that specifies switch configuration information.
port mod/port (Optional) Keyword and variables that specifies the module and port
on the module.

Defaults By default, this command displays the output for technical-support-related show commands. Use
keywords to specify the type of information to be displayed. If you do not specify any parameters, the
system displays all configuration, memory, module, port, instance data, and VLAN data.

Command Types Switch command.

Command Modes Privileged.

Usage Guidelines

Caution To prevent spanning tree instability, avoid running multiple write tech-support commands on a
switch or multiple switches on the network segment.

Note If you press Ctrl-C while the write tech-support is outputting, the output file to the TFTP server
might be incomplete.

Note If you are uploading information to a file, ensure that the file already exists in the TFTP server and has
appropriate permissions, and network connections are good before you issue the write tech-support
command.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-676 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
write tech-support

If you specify the config keyword, the write tech-support command displays the output of these
commands:
• show config
• show flash
• show log
• show microcode
• show module
• show port
• show spantree active
• show spantree summary
• show system
• show test
• show trunk
• show version
• show vlan
If you specify the memory keyword, the write tech-support command displays the output of these
commands:
• ps
• ps -c
• show cam static
• show cam system
• show flash
• show memory buffers
• show microcode
• show module
• show proc
• show proc mem
• show proc cpu
• show system
• show spantree active
• show version
If you specify a module, port, or VLAN number, the system displays general system information and
information for the component that you specified.

Examples This example shows how to upload a technical report:

Console> (enable) write tech-support 172.20.32.10 tech.txt
Upload tech-report to tech.txt on 172.20.32.10 (y/n) [n]? y
/
Finished network upload. (67784 bytes)
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-677
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
write tech-support

Related Commands show tech-support

Also see the commands listed in the “Usage Guidelines” section.

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-678 78-12648-03
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
write terminal

write terminal
Use the write terminal command to display the configuration information currently in running memory.

write terminal [all]

Syntax Description all (Optional) Keyword that specifies all configuration information.

Defaults This command has no default settings.

Command Types Switch command.

Command Modes Privileged.

Examples This example shows how to display the current system configuration information:
Console> (enable) write terminal
......

...............

..

begin
!
# ***** NON-DEFAULT CONFIGURATION *****
!
!
#Time: Tue Aug 3 1999, 07:32:26
!
#version 5.3(0.90)ASP
!
!
#frame distribution method
set port channel all distribution mac both
!
#vtp
set vtp domain Lab_Network
set vtp pruning enable
set vlan 1 name default type ethernet mtu 1500 said 100001 state active
set vlan 2 name VLAN0002 type ethernet mtu 1500 said 100002 state active
set vlan 3 name VLAN0003 type ethernet mtu 1500 said 100003 state active
set vlan 4 name VLAN0004 type ethernet mtu 1500 said 100004 state active
set vlan 5 name VLAN0005 type ethernet mtu 1500 said 100005 state active
set vlan 6 name VLAN0006 type ethernet mtu 1500 said 100006 state active
set vlan 10 name VLAN0010 type ethernet mtu 1500 said 100010 state active
set vlan 20 name VLAN0020 type ethernet mtu 1500 said 100020 state active
set vlan 50 name VLAN0050 type ethernet mtu 1500 said 100050 state active
set vlan 100 name VLAN0100 type ethernet mtu 1500 said 100100 state active
set vlan 152 name VLAN0152 type ethernet mtu 1500 said 100152 state active
set vlan 200 name VLAN0200 type ethernet mtu 1500 said 100200 state active

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-679
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
write terminal

set vlan 300 name VLAN0300 type ethernet mtu 1500 said 100300 state active
set vlan 303 name VLAN0303 type fddi mtu 1500 said 100303 state active
set vlan 304 name VLAN0304 type fddi mtu 1500 said 100304 state active
set vlan 305 name VLAN0305 type fddi mtu 1500 said 100305 state active
set vlan 349 name VLAN0349 type fddi mtu 1500 said 100349 state active
set vlan 350 name VLAN0350 type fddi mtu 1500 said 100350 state active
set vlan 351 name VLAN0351 type fddi mtu 1500 said 100351 state active
set vlan 400 name VLAN0400 type ethernet mtu 1500 said 100400 state active
set vlan 500 name VLAN0500 type ethernet mtu 1500 said 100500 state active
set vlan 521 name VLAN0521 type ethernet mtu 1500 said 100521 state active
set vlan 524 name VLAN0524 type ethernet mtu 1500 said 100524 state active
set vlan 570 name VLAN0570 type ethernet mtu 1500 said 100570 state active
set vlan 801 name VLAN0801 type trbrf mtu 4472 said 100801 state active bridge
set vlan 850 name VLAN0850 type ethernet mtu 1500 said 100850 state active
set vlan 917 name VLAN0917 type ethernet mtu 1500 said 100917 state active
set vlan 999 name VLAN0999 type ethernet mtu 1500 said 100999 state active
set vlan 1002 name fddi-default type fddi mtu 1500 said 101002 state active
set vlan 1004 name fddinet-default type fddinet mtu 1500 said 101004 state acti
set vlan 1005 name trnet-default type trbrf mtu 1500 said 101005 state active b
set vlan 802 name VLAN0802 type trcrf mtu 4472 said 100802 state active parent
set vlan 1003 name token-ring-default type trcrf mtu 1500 said 101003 state act
set vlan 3 translation 303 translation 0
set vlan 4 translation 304 translation 0
set vlan 5 translation 305 translation 0
set vlan 303 translation 3 translation 0
set vlan 304 translation 4 translation 0
set vlan 305 translation 5 translation 0
set vlan 351 translation 524 translation 0
set vlan 524 translation 351 translation 0
!
#ip
set interface sc0 5 172.20.52.124/255.255.255.248 172.20.52.127

set ip route 0.0.0.0/0.0.0.0 172.20.52.125

!
#spantree
#vlan 801
set spantree fwddelay 4 801
set spantree maxage 10 801
#vlan 802
set spantree fwddelay 4 802
set spantree maxage 10 802
set spantree portstate 802 block 801
!
#set boot command
set boot auto-config non-recurring
!
#Port Channel
set port channel 7/7-8 3
set port channel 7/5-6 21
!
#module 1 : 2-port 1000BaseX Supervisor IIIG
!
#module 2 empty
!
#module 3 : 2-port DS3 Dual PHY ATM
!
#module 4 empty
!
#module 5 empty
!
#module 6 : 48-port 10BaseT Ethernet
!
#module 7 : 24-port 10/100BaseTX Ethernet

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-680 78-12648-03
Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
write terminal

set trunk 7/1 desirable isl 1-1005

set trunk 7/2 desirable isl 1-1005
set trunk 7/3 desirable isl 1-1005
set trunk 7/4 desirable isl 1-1005
nt7/1-6 mode desirable silent
!
#module 8 empty
!
#module 9 empty
!
#module 15 empty
!
#module 16 empty
end
Console> (enable)

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 2-681
 Chapter 2 Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
write terminal

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
2-682 78-12648-03
 A P P E N D I X A
Acronyms

Table A-1 defines the acronyms used in this publication.

Table A-1 List of Acronyms

Acronym Expansion
AAA authentication, authorization, and accounting
AAL ATM adaptation layer
ACE access control entry
ADM add-drop multiplexer
AFI Authority and Format Identifier
AMP active monitor present
APaRT automated packet recognition/translation
ARP Address Resolution Protocol
ASP ATM switch processor
ATM Asynchronous Transfer Mode
BPDU bridge protocol data unit
BRF Bridge Relay Function
BUS broadcast and unknown server
C3PO Cisco 3 port switch
CAM content-addressable memory
CAS column address strobe
CBR constant bit rate
CDDI Copper Data Distributed Interface
CDP Cisco Discovery Protocol
CGMP Cisco Group Management Protocol
CLI command-line interface
COPS Common Open Policy Service
CoS class of service
CRC cyclic redundancy check
CRF Concentrator Relay Function

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 A-1
 Appendix A Acronyms

Table A-1 List of Acronyms (continued)

Acronym Expansion
DCC Data Country Code
DEC Digital Equipment Corporation
DFI domain-specific part format identifier
DHCP Dynamic Host Configuration Protocol
DISL dynamic inter-switch link
DMP data movement processor
DNS Domain Name System
DoD Department of Defense
DRiP Dual Ring Protocol
DSAP destination service access point
DTP Dynamic Trunking Protocol
DTR dedicated token ring; data terminal ready
EARL Enhanced Address Recognition Logic
ECMA European Computer Manufacturers Association
EEPROM electrically erasable programmable read-only memory
EIA Electronic Industries Association
ELAN emulated local area network
ESI end-system identifier
FCS frame check sequence
FDDI Fiber Distributed Data Interface
FDX full duplex
FSSRP Fast Simple Server Redundancy Protocol
FTP foil twisted-pair; File Transfer Protocol
GARP General Attribute Registration Protocol
GBIC Gigabit Interface Converter
GMRP GARP Multicast Registration Protocol
GSP Gigabit Switch Platform
GVRP GARP VLAN Registration Protocol
HDX half duplex
ICD International Code Designator
ICMP Internet Control Message Protocol
IDP Initial Domain Part
IGMP Internet Group Management Protocol
ILMI Integrated Local Management Interface
IMPL initial microprogram load
IP Internet Protocol

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
A-2 78-12648-03
Appendix A Acronyms

Table A-1 List of Acronyms (continued)

Acronym Expansion
IPC interprocessor communication
IPX Internetwork Packet Exchange
ISL Inter-Switch Link
ISO International Organization of Standardization
KDC Key Distribution Center
LAN local area network
LANE LAN emulation
LAT local-area transport
LCP Link Control Protocol
LEC LAN Emulation Client
LECS LAN Emulation Configuration Server
LEM link error monitor
LER link error rate
LES LAN emulation server
LLC logical link control
MAC Media Access Control
MAP Manufacturing Automation Protocol
MBS maximum burst size
MCP Master Communication Processor
MDG Multiple Default Gateway
MIB Management Information Base
MII media-independent interface
MISTP Multi-Instance Spanning Tree Protocol
MISTP-PVST+ combination mode of Multi-Instance Spanning Tree Protocol and
Per VLAN Spanning Tree
MLS multilayer switching
MLS-RP multilayer switching-route processor
MLSP multilayer switching protocol
MM multimode
MOP Maintenance Operation Protocol
MOTD message-of-the-day
MPC multiprotocol over ATM client
MPOA multiprotocol over ATM
MPS multiprotocol over ATM server
MTU maximum transmission unit
NAM Network Analysis Module

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 A-3
 Appendix A Acronyms

Table A-1 List of Acronyms (continued)

Acronym Expansion
NAUN nearest available upstream neighbor
NBMA nonbroadcast multiaccess
NBS non-bused spare
NDE NetFlow Data Export
NFFC NetFlow Feature Card
NFFC II Enhanced NetFlow Feature Card
NFLS Netflow LAN Switching
NHC Next Hop Client
NHRP Next Hop Resolution Protocol
NHS Next Hop Server
NMP Network Management Processor
NNI Network-Network Interface
NSAP network service access point
NTP Network Time Protocol
NVRAM nonvolatile RAM
OAM operation, administration, and maintenance
OOB out-of-band
OSI Open System Interconnection
PAgP Port Aggregation Protocol
PAM port adapter module
PCM pulse code modulation
PCMCIA Personal Computer Memory Card International Association
PCR peak cell rate
PDU protocol data unit
PHY physical sublayer
PIB Policy Information Base
PLCP physical layer convergence procedure
PLIM physical layer interface module
PPP Point-to-Point Protocol
PRID policy rule identifier
PVC permanent virtual circuit (or permanent virtual connection in ATM
terminology)
QoS quality of service
RADIUS Remote Authentication Dial-in User Service
RAS row address strobe
RCD RAS-to-CAS delay

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
A-4 78-12648-03
Appendix A Acronyms

Table A-1 List of Acronyms (continued)

Acronym Expansion
RCP Remote Copy Protocol
RIF routing information field
RMON remote monitoring
ROM random access memory
RP route processor
RSA public key cryptographic system
RSFC Route Switch Feature Card
RSM Route Switch Module
SAID Security Association Identifier
SAMBA synergy advanced multipurpose bus arbiter
SAP service access point
SAR segmentation and reassembly
SCP Serial Control Protocol
SCR sustainable cell rate
SDP Session Description Protocol
SE search engine
SLIP Serial Line Internet Protocol
SM single-mode
SMP standby monitor present
SMT station management
SNA Systems Network Architecture
SNAP Subnetwork Access Protocol
SNMP Simple Network Management Protocol
SPAN Switched Port Analyzer
SRB source-route bridging
SRT source-route transparent bridging
SSCOP Service-Specific Connection Oriented Protocol
SSH secure shell
SSRP Simple Server Redundancy Protocol
STP shielded twisted-pair; Spanning Tree Protocol
STPX Spanning Tree Protocol Extensions (MIB)
SVC switched virtual circuit
TACACS+ Terminal Access Controller Access Control System Plus
TCP/IP Transmission Control Protocol/Internet Protocol
TFTP Trivial File Transfer Protocol
TGT ticket granting ticket

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 A-5
 Appendix A Acronyms

Table A-1 List of Acronyms (continued)

Acronym Expansion
TIA Telecommunications Industry Association
TLV type-length value
TOS type of service
TrBRF Token Ring Bridge Relay Function
TrCRF Token Ring Concentrator Relay Function
TRT token rotation timer
TTL time to live
TTY teletype
UART Universal Asynchronous Receiver/Transmitter
UBR unspecified bit rate
UDLP UniDirectional Link Protocol
UDP User Datagram Protocol
UNI User-Network Interface
UTC Coordinated Universal Time
VBR variable bit rate
VC virtual circuit
VCC virtual channel connection
VCD virtual channel descriptor
VCI virtual circuit identifier
VCR virtual configuration register
VLAN virtual LAN
VMPS VLAN Membership Policy Server
VPI virtual path identifier
VQP VLAN Query Protocol
VTP VLAN Trunk Protocol
WRED weighted random early detect
WRR weighted round robin

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
A-6 78-12648-03
 I N D E X

Symbols A

? (help) acceleration
switch CLI 1-7 disabling 2-355
displaying status 2-607
enabling 2-355
Numerics
accessing CLI of intelligent module 2-120
802.1q access policies
configuring tagging mode 2-169 displaying group name 2-566
displaying tagging status 2-434 displaying user collection 2-566
802.1x accounting. See RADIUS accounting; TACACS+
accounting
clearing configuration 2-18
addresses. See IP addresses; MAC addresses
configuring on a port 2-252
administrative control
configuring on a system 2-170
setting 2-188
configuring on ports 2-252
aging time
disabling authentication 2-170
displaying ARP 2-396
disabling reauthentication 2-170
displaying CAM 2-405
displaying authenticator 2-516
setting ARP 2-133
displaying backend authenticator 2-516
setting CAM 2-155
displaying protocol version 2-435
aliases
displaying system capabilities 2-435
clearing 2-5
displaying timer values 2-435
command shorthands 2-2
enabling authentication 2-170
defining 2-132
enabling reauthentication 2-170
displaying 2-395
initializing on port 2-252
displaying command aliases 2-2
initializing on ports 2-252
removing alias name and value 2-662
manually initiating reauthentication 2-252
See IP aliases
setting idle time 2-170
setting 2-2
setting number of frame retransmissions 2-170
ARP table
setting retransmission authentication time 2-170
adding entries 2-133
setting retransmission time 2-170
clearing entries 2-6
specifying port control types 2-252
displaying 2-395

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 IN-1
 Index

setting aging time 2-133 displaying contents 2-401

setting ARP aging time 2-133 setting 2-153
ATM modules boot files
accessing CLI 2-120 determining which file booted 2-672
clearing counters 2-16 bootflash
authentication displaying 2-443
RADIUS 2-290 BPDU
specifying lockout time 2-135 disabling 2-340
specifying login lockout time 2-138 disabling packet filtering 2-339
specifying number of connection attempts 2-135 disabling skewing 2-323
specifying number of login connection attempts 2-138 displaying 2-596
specifying primary login method 2-138 enabling 2-340
specifying primary method 2-135 enabling packet filtering 2-339
authentication. See specific type of authentication enabling skewing 2-323
authorization. See TACACS+ authorization BPDU guard
auto-config files disabling 2-340
configuring 2-152 enabling 2-340
synchronizing 2-152 BPDU packet filtering
auxiliary VLANs disabling 2-339
configuring ports 2-246 enabling 2-339
displaying port status 2-502 BPDU skewing
disabling 2-323
displaying 2-585
B
enabling 2-323
BackboneFast bridge priority
disabling 2-322 setting 2-344, 2-348
displaying convergence status 2-583 bridge protocol data unit. See BPDU
enabling 2-322 budgets
bandwidth displaying power configurations 2-438
increasing 2-355 setting power 2-285
banners. See LCD banners; message-of-the-day banners
baud rates
C
setting 2-356
boot CAM tables
synchronizing auto-config files 2-152 adding entries 2-155
boot configuration register clearing entries 2-10
setting 2-149 configuring traffic filtering 2-155
BOOT environment variables deleting entries 2-10
clearing 2-8, 2-9 displaying aging time 2-405

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
IN-IN-2 78-12648-03
 Index

displaying entries 2-402 command aliases. See aliases

setting aging time 2-155 command help
CDP switch CLI 1-7
configuring 2-157 command history
configuring hold time 2-159 switch CLI 1-4
disabling 2-157 command history logs
displaying 2-406 clearing 2-36
displaying message intervals 2-506 displaying 2-472
displaying port status 2-506 command-line interface. See switch CLI; ROM monitor
CLI
enabling 2-157
command logging
selecting version 2-161
clearing log entry table 2-36
setting message intervals 2-160
displaying command log entries 2-472
CGMP
command modes
disabling 2-162
accessing 1-3
enabling 2-162
commands
CGMP leave processing
abbreviating 1-4
disabling 2-163
accounting 2-122
displaying 2-409
case sensitivity 1-3
enabling 2-163
completing partial commands 1-5
CGMP statistics
editing 1-3
clearing 2-11
pausing between 2-671
displaying 2-410
repeating 1-4
channel
communities. See SNMP communities
displaying channel port utilization based on MAC
counters 2-423 configuration files
displaying EtherChannel group status clearing 2-8, 2-9
information 2-417
deleting 2-89, 2-90
display MAC information 2-422
displaying running configurations 2-679
Cisco Discovery Protocol. See CDP
downloading 2-82
Cisco Group Management Protocol. See CGMP specifying for startup 2-148
class of service. See CoS
configuration registers
CLI. See ROM monitor CLI; switch CLI clearing 2-8, 2-9
clocks
configuring 2-84
changing 2-370
displaying 2-401
displaying current time 2-622, 2-623
configurations
displaying summertime status 2-606
clearing 2-13, 2-14
setting 2-242, 2-353
displaying 2-673
closing active console ports 2-95
uploading 2-666
command accounting. See command logging

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 IN-IN-3
 Index

contact person diagnostic tests

setting 2-357 disabling packet memory 2-368
CoS displaying packet memory 2-620
clearing mapping 2-47 displaying results 2-614
deleting from MAC addresses 2-47 enabling packet memory 2-368
mapping values 2-288 setting levels 2-366
setting default values 2-287 DNS
setting on switch 2-287 disabling 2-197
counters. See MAC counters; port counters enabling 2-197
country codes setting domain names 2-198
setting 2-358 DNS servers
CPUs defining as primary 2-199
displaying 2-536 defining IP addresses 2-199
current configurations removing 2-23
uploading 2-673 Domain Name System. See DNS
uploading to file 2-676 downloading
images 2-96
RCP configuration files 2-82
D
dump logs
daylight saving time clearing 2-35
displaying clock 2-606 displaying 2-469
setting clock 2-242, 2-353 duplex types
debug information configuring 2-255
disabling 2-372 DVLAN
displaying trace 2-628 displaying statistics 2-436
enabling 2-372 Dynamic Host Configuration Protocol. See DHCP
setting categories 2-372 Dynamic VLAN. See DVLAN
setting levels 2-372
default gateways
E
specifying 2-206, 2-207
deleted files EAP
recovering 2-663, 2-664 configuring dot1x 2-170
DES keys encryption
defining 2-218 clearing RSA keys 2-17
deleting 2-34 configuring RSA keys 2-168
DHCP displaying RSA 2-433
configuring interfaces 2-192 environment
configuring links on interfaces 2-195 displaying system status 2-437

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
IN-IN-4 78-12648-03
 Index

environment variables displaying contents of files 2-441

copying to NVRAM 2-656 Flash PC cards
error detection displaying 2-443
disabling 2-176 formatting 2-100
displaying settings 2-440 flow control
enabling 2-176 configuring ports 2-257
error disable timeouts displaying for ports 2-518
configuring for ports 2-174 link negotiation 2-269
displaying configuration 2-439 forward delay 2-269
displaying status 2-439 restoring defaults 2-67
error logs setting 2-328
clearing 2-35 fragmentation
displaying 2-469 disabling 2-200
setting 2-226 enabling 2-200
EtherChannels
creating port bundles 2-248
G
defining administrative groups 2-248
displaying channel information 2-412 GARP
displaying module information 2-508 displaying timer values 2-447
displaying port information 2-508 setting timers 2-178
setting channel path cost 2-164 GARP Multicast Registration Protocol. See GMRP
setting channel VLAN cost 2-165 GARP VLAN Registration Protocol. See GVRP
exiting CLI sessions 2-113 General Attribute Registration Protocol. See GARP
Extensible Authentication Protocol. See EAP GMRP
disabling on VLANs 2-180
displaying configuration 2-448
F
displaying timer values 2-450
Flash devices enabling on VLANs 2-180
confirming checksum 2-669 setting registration type 2-182
displaying default 2-112 setting timers 2-183
formatting 2-100 GMRP Forward All
listing files 2-92, 2-443 disabling 2-181
recovering deleted file 2-664 enabling 2-181
recovering deleted files 2-663 GMRP ports
setting defaults 2-4 disabling 2-260
Flash files enabling 2-260
deleting 2-654, 2-655 GMRP statistics
Flash memory clearing 2-19
copying images from host 2-96 displaying 2-449

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 IN-IN-5
 Index

GVRP
I
disabling globally 2-185
displaying configurations 2-451 ICMP
enabling globally 2-185 disabling redirect messages 2-205
setting administrative control 2-188 disabling unreachable messages 2-209
setting timers 2-190 displaying statistics 2-489
VLAN declarations 2-186 enabling redirect messages 2-205
GVRP dynamic VLANs enabling unreachable messages 2-209
disabling 2-187 sending echo-request packets 2-108, 2-109
enabling 2-187 idle sessions
GVRP ports setting timeouts 2-231
disabling 2-261 ifIndexes
enabling 2-261 displaying 2-520
GVRP statistics inband
clearing 2-20 error detection 2-176
displaying 2-452 in-band interfaces
configuring 2-192
configuring links 2-195
H error detection 2-176, 2-440

hardware instances
displaying versions 2-636 displaying BPDU skew status 2-585

hello time displaying instance information 2-594

restoring defaults 2-67 displaying path cost 2-597

setting 2-331 resetting port instance priority 2-63

help setting port priority 2-343

accessing switch commands 1-7 Internet Control Message Protocol. See ICMP
listing ROM monitor commands 2-102 IP addresses
history substitution adding to permit lists 2-203

switch CLI 1-4 clearing 2-24

hop-by-hop paths setting NTP servers 2-241

displaying 2-659 setting on DNS servers 2-199

HTTP setting routing tables 2-206, 2-207

displaying authentication information 2-397 IP aliases

displaying configurations 2-460 adding 2-196

HTTP servers clearing 2-21

configuring TCP port numbers 2-201 displaying 2-458

disabling 2-202 IP DNS

enabling 2-202 clearing default DNS domain name 2-22
defining IP addresses of DNS servers 2-199

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
IN-IN-6 78-12648-03
 Index

displaying DNS domain name 2-459 Kerberos credentials

displaying DNS name server 2-459 deleting 2-30
displaying DNS name servers 2-458 disabling forwarding 2-29
removing DNS servers 2-23 displaying 2-468
IP fragmentation forwarding user 2-211
disabling 2-200 Kerberos realms
enabling 2-200 clearing DNS domain name map 2-31
IP permit lists mapping to DNS domain names 2-213
adding IP addresses 2-203 Kerberos servers
clearing IP addresses 2-24 clearing 2-32
clearing masks 2-24 key distribution center. See KDC
disabling 2-203 keys
displaying 2-462 clearing DES 2-34
enabling 2-203 clearing RSA 2-17
IP routing tables defining authentication pairs 2-240
adding IP addresses 2-206, 2-207 defining DES 2-34
adding IP aliases 2-206, 2-207 enabling RSA 2-168
deleting entries 2-26, 2-27 keys. See DES keys; RADIUS keys; RSA keys
displaying 2-489
displaying entries 2-464, 2-465
L
specifying default IP gateways 2-206, 2-207
Layer 2 paths
displaying 2-105
K
LCD banners
KDC displaying 2-399
clearing 2-32 link negotiation protocol
specifying 2-214 disabling on ports 2-269
Kerberos displaying settings 2-524
displaying configuration information 2-467 enabling on ports 2-269
entering SRVTAB files 2-215 listing Flash memory device files 2-92
providing secret keys 2-217 local command accounting
specifying KDC 2-214 clearing command log entries 2-36
Kerberos authentication displaying command log entries 2-472
authenticating users 2-212 local engine IDs
configuring 2-135 displaying 2-565
disabling 2-28 logging messages
displaying 2-397 disabling 2-226
enabling as primary method for login 2-138 disabling timestamp 2-230
enabling mandatory authentication 2-210 enabling 2-226

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 IN-IN-7
 Index

enabling timestamp 2-230 error detection 2-176

sending to console 2-221, 2-229 message logs
setting levels 2-223 limiting buffers 2-220
login banners. See message-of-the-day banners setting size of syslog table 2-222
login passwords message logs. See also messages
changing 2-245 message-of-the-day banners
loop guard clearing 2-7
disabling 2-329 configuring 2-147
enabling 2-329 displaying 2-399
messages
disabling logging 2-228
M
enabling logging 2-228
MAC addresses sending to current login session 2-228
clearing addresses from lists 2-45 MIBs
deleting CoS assignments 2-47 displaying images 2-454
disabling reduction 2-332 removing view names 2-61
displaying root switch 2-587 MISTP
MAC address reduction displaying 2-594
disabling 2-332 setting 2-334
enabling 2-332 MISTP-PVST+
MAC counters displaying 2-580
clearing 2-16 setting 2-334
displaying 2-477 MLS
displaying port information 2-522 clearing manually configured ports 2-40
Management Information Base. See MIBs displaying 2-487
maximum aging time setting 2-235
displaying 2-580 module configuration
restoring defaults 2-67 displaying nondefault configuration 2-553
setting 2-333 setting configuration mode 2-166
MDG module error logs
disabling 2-177 clearing 2-35
enabling 2-177 modules
membership assignments disabling 2-232
displaying 2-643 displaying port capabilities 2-504
reconfirming 2-114 displaying status 2-480
setting 2-386 displaying the nondefault configuration 2-424
memory enabling 2-233
clearing 2-16 naming 2-234
displaying allocation 2-536

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
IN-IN-8 78-12648-03
 Index

monitoring traffic disabling 2-236

configuring threshold 2-373 enabling 2-236
MOTD. See message-of-the-day removing keys 2-41
multicast routers NTP client
clearing 2-40 disabling switch as 2-239
configuring ports as 2-235 enabling switch as 2-239
displaying group configurations 2-483 NTP servers
displaying group counts in VLANs 2-485 configuring authentication keys 2-241
displaying ports with CGMP-capable routers 2-487 configuring IP address of 2-241
displaying protocols status 2-486 removing 2-42
Multi-Instance Spanning Tree Protocol. See MISTP NTP time zones
Multi-Instance Spanning Tree Protocol and Per VLAN restoring defaults 2-43
Spanning Tree. See MISTP-PVST+
NVRAM
multilayer switching. See MLS
copying environment variables to 2-656
Multiple Default Gateway. See MDG
displaying 2-107
writing aliases to 2-656

NAM P
disabling SNMP extended RMON support 2-301
packets
enabling SNMP extended RMON support 2-301
displaying Layer 2 paths 2-105
naming
PAgP
modules 2-234
configuring ports 2-248
systems 2-361
displaying module information 2-508
network interfaces displaying port information 2-508
configuring 2-192
displaying port statistics 2-412
displaying 2-455, 2-456
passwords
network statistics
case sensitivity 2-173
displaying 2-489
changing login 2-245
Network Time Protocol. See NTP
changing privileged mode 2-173
nonvolatile RAM. See NVRAM setting 2-245
normal mode
setting for privileged mode 2-173
returning from privileged mode 2-94
path costs
NTP
displaying instance costs 2-597
configuring time-adjustment factor 2-238
displaying port costs 2-589
displaying current status 2-496
peak traffic
setting daylight saving time 2-242
displaying 2-630
NTP authentication
Per VLAN Spanning Tree. See PVST+
defining key pairs 2-240

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 IN-IN-9
 Index

ping setting default 2-324

configuring 2-108, 2-109 port power
Port Aggregation Protocol. See PAgP displaying administration status 2-521
port capabilities displaying operational status 2-521
configuring speed 2-275 setting default allocation 2-191
displaying 2-504 port priority
specifying frame-distribution methods 2-248 displaying 2-498
port counters setting 2-343
clearing 2-16 setting levels 2-265
displaying 2-513 ports
error detection 2-176 disabling 2-251
port duplex types displaying flow control information 2-518
configuring 2-255 displaying information 2-534
PortFast displaying status 2-498, 2-531
disabling 2-340 enabling 2-256
displaying 2-596 setting names 2-268
enabling 2-340 port security
PortFast-start clearing MAC addresses 2-45
disabling 2-338 configuring 2-273
enabling 2-338 displaying 2-527
port flow control displaying configuration statistics 2-529
configuring 2-257 port speed
displaying 2-518 configuring 2-275
port hosts displaying 2-498
clearing 2-44 port traps
optimizing configurations for host connections 2-263 disabling 2-277
port mapping displaying 2-533
clearing 2-12 enabling 2-277
displaying 2-639 port VLAN priority
setting 2-384 clearing 2-66
port names displaying 2-580
displaying 2-498 setting 2-347
setting 2-268 power
port negotiation displaying configurations 2-438
disabling 2-269 setting budgets 2-285
displaying link negotiation settings 2-524 setting for ports 2-264
enabling 2-269 private VLANs. See PVLAN
port path costs privileged mode
setting 2-336 activating 2-99

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
IN-IN-10 78-12648-03
 Index

returning to normal mode 2-94 setting default CoS values 2-287

setting passwords 2-173 quality of service. See QoS
process utilization
displaying 2-536
R
prompts
changing 2-279 RADIUS
protocol filters displaying configuration 2-548
disabling 2-280 setting deadtime 2-289
displaying 2-525 RADIUS accounting
displaying status 2-539 disabling normal login session 2-126
enabling 2-280 disabling system events 2-129
protocol membership enabling normal login session 2-126
disabling on ports 2-271 enabling system events 2-129
enabling on ports 2-271 RADIUS authentication
PVLANs configuring 2-135
binding port to private VLAN 2-281 displaying 2-397
binding VLAN to primary VLAN 2-281 enabling as primary method for login 2-138
clearing configuration 2-12 RADIUS keys
deleting mapping 2-46 clearing 2-50
determining PVLAN capability 2-542 setting encryption 2-290
displaying configuration 2-540 RADIUS server
displaying mapping configuration 2-544 clearing 2-51
mapping VLAN to primary VLAN 2-283 setting up 2-292
PVST+ RADIUS servers
displaying 2-580 setting time between retransmissions 2-293
setting 2-334 specifying retransmit times 2-291
RCP
clearing information 2-52
Q
copying software images to Flash memory 2-96
QoS downloading configuration files 2-82
clearing map values 2-49 downloading Flash images 2-86
deleting CoS assigned to MAC addresses 2-47 downloading switch configurations 2-86
disabling 2-286 uploading Flash images 2-86
displaying related information 2-546 uploading switch configurations 2-86
displaying status 2-547 RCP usernames
enabling 2-286 deleting 2-78
mapping CoS values 2-288 setting 2-294
returning to default thresholds 2-47 redundancy
returning to default values 2-47 displaying power 2-438

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 IN-IN-11
 Index

setting power 2-285 root

Remote Authentication Dial-in user Service. See RADIUS specifying for VLANs 2-349
Remote Copy Protocol. See RCP root guard
remote monitoring. See RMON disabling 2-329
remote span displaying 2-590
disabling sessions 2-295 enabling 2-329
displaying configurations 2-551 Route Switch Feature Card. See RSFCs
enabling sessions 2-295 Route Switch Module. See RSMs
repeating commands 2-115 RSA keys
reset clearing 2-17
canceling 2-118 configuring 2-168
displaying schedule 2-550 displaying 2-433
module 2-118 RSFCs
schedule reset 2-118 accessing CLI 2-120
switch 2-118 RSMs
RMON accessing CLI 2-120
disabling SNMP support 2-306
enabling SNMP support 2-306
S
ROM monitor
booting up external processes 2-3 secure shell. See SSH
configuring configuration register utility 2-84 Serial Line Internet Protocol. See SLIP
displaying aliases 2-2 Simple Network Management Protocol. See SNMP
displaying main memory 2-107 SLIP interfaces
displaying NVRAM 2-107 attaching 2-650
displaying packet memory 2-107 configuring 2-192
displaying supported DRAM configurations 2-107 configuring links 2-195
displaying variable names 2-121 detaching 2-650
repeating commands 2-115 SNMP access
resetting 2-117 clearing 2-53
setting aliases 2-2 defining access rights for groups 2-298
setting ROM monitor variable name values 2-121 displaying 2-557
writing environment variables and aliases to establishing relationships 2-302
NVRAM 2-656
removing access rights 2-53
ROM monitor CLI
SNMP communities
accessing 1-9
associating access types 2-300
exiting sessions 2-113
clearing access types 2-54
operating 1-10
defining access types 2-300
pausing CLI for specified number of seconds 2-671
displaying 2-559

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
IN-IN-12 78-12648-03
 Index

SNMP context configuring 2-310

displaying 2-561 displaying entries 2-572
SNMP counters SNMP trap receiver
displaying 2-562 disabling 2-192
SNMP groups enabling 2-192
common access policies 2-566 SNMP trap receiver tables
defining access rights 2-298 adding entries 2-312
displaying common access policies 2-566 clearing entries 2-59
establishing relationships 2-302 displaying 2-555
removing access rights 2-53 sending messages 2-658
removing users 2-55 SNMP users
SNMP local engine IDs clearing 2-60
displaying information 2-565 configuring 2-314
SNMP notify displaying 2-574
clearing 2-56 removing 2-60
displaying tables 2-568 SNMP views
removing names from tables 2-56 clearing 2-61
setting entries 2-304 configuring MIBs 2-316
SNMP permit lists displaying MIB configurations 2-576
clearing 2-24 removing MIB names 2-61
disabling 2-203 software
enabling 2-203 displaying versions 2-636
SNMP port traps uploading images to network hosts 2-666
disabling 2-277 SPAN
displaying status 2-533 configuring 2-318
enabling 2-277 displaying 2-318, 2-578
SNMP RMON spanning tree
disabling 2-306 clearing statistics 2-68
disabling extendedrmon 2-301 disabling 2-326
displaying 2-555 displaying blocked ports 2-584
enabling 2-306 displaying information summary 2-604
enabling extendedrmon 2-301 displaying instance information 2-594
SNMP target addresses displaying on ports 2-530, 2-580
configuring 2-308 displaying statistics 2-599
displaying entries 2-570 displaying time before entry expires 2-587
removing entries 2-57 displaying time remaining before VLAN joins an
instance 2-587
setting in tables 2-308
enabling 2-327
SNMP target parameters
resetting port priority 2-63
clearing 2-58

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 IN-IN-13
 Index

restoring default bridge priority 2-67 displaying 2-469

restoring factory-set defaults 2-67, 2-69 displaying logging buffer 2-475
setting mode 2-334 displaying system log configuration 2-469
setting primary root 2-349 syslog servers
setting secondary root 2-349 adding 2-226
setting VLAN priorities 2-347 deleting 2-39
SRVTAB files displaying 2-473
entering 2-215 system
SSH permit lists displaying status 2-608
adding 2-203 system clocks. See clocks
clearing 2-24 system configuration
statistics displaying configuration 2-424
displaying 2-489 displaying nondefault configuration 2-553
subnet masks displaying system configuration mode 2-430
clearing 2-24 setting configuration mode 2-166
summertime system contact
displaying status 2-606 setting 2-357
setting daylight saving time 2-242, 2-353 system disconnects
switch acceleration setting timeouts 2-231
disabling 2-355 system error logs. See error logs
displaying status 2-607 system location
enabling 2-355 displaying 2-608
switch CLI identifying 2-359
? (help) 1-7 setting 2-358
accessing 1-1 system logging messages. See logging messages
command aliases 1-5 system logging servers. See syslog servers
command help 1-7 system logs. See syslogs
command modes 1-3 system modems
console port 1-2 disabling 2-360
exiting sessions 2-113 enabling 2-360
history substitution 1-4 system names
operating 1-3 configuring 2-361
pausing CLI for specified number of seconds 2-671 displaying 2-608
Telnet 1-2
Switched Port Analyzer. See SPAN
T
Switch Fabric Modules
displaying LCD banners 2-399 TAC
syslogs displaying configuration information 2-612
clearing buffer 2-37 displaying system information 2-612

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
IN-IN-14 78-12648-03
 Index

TACACS+ deleting keys 2-70

disabling directed-request option 2-362 removing hosts 2-71
displaying protocol configuration 2-610 setting timeout intervals 2-365
enabling directed-request option 2-362 target addresses. See SNMP target addresses
TACACS+ accounting TCP port numbers
disabling command events 2-122 configuring 2-201
disabling normal login sessions 2-126 technical support. See TAC
disabling outbound connections events 2-124 Telnet
disabling suppression 2-128 accessing the switch 1-2
disabling system events 2-129 closing sessions 2-95
displaying 2-393 connecting 2-657
enabling command events 2-122 disconnecting 2-95
enabling normal login sessions 2-126 displaying authentication information 2-397
enabling outbound connection events 2-124 listing active sessions 2-635
enabling suppression 2-128 specifying authentication method 2-135
enabling system events 2-129 specifying authentication method for login 2-138
setting update frequency 2-131 Telnet permit lists
TACACS+ authentication adding 2-203
configuring 2-135 clearing 2-24
displaying 2-397 Terminal Access Controller Access Control System Plus.
See TACACS+
enabling as primary method for login 2-138
terminal display
setting encryption keys 2-363
setting number of lines on screen 2-219
TACACS+ authorization
timeouts
disabling 2-141
idle sessions 2-231
disabling authorization of normal login mode 2-145
timestamp display
disabling EXEC mode events 2-145
disabling on system logging messages 2-230
disabling privileged mode events 2-143
enabling on system logging messages 2-230
disabling session events 2-145
time zones
displaying 2-398
displaying 2-623
enabling 2-141
restoring defaults 2-72
enabling authorization of normal login mode 2-145
restoring NTP defaults 2-43
enabling EXEC mode events 2-145
setting 2-371
enabling of EXEC mode events 2-145
TopN reports
enabling of normal login mode 2-145
clearing 2-73
enabling of session events 2-145
displaying 2-626
enabling privileged mode events 2-143
starting 2-624
enabling session events 2-145
stopping 2-73
TACACS+ servers
defining 2-364

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 IN-IN-15
 Index

trace monitors versions

disabling 2-372 CDP 2-161
displaying 2-628 displaying Flash 2-443
enabling 2-372 displaying hardware 2-670
traffic logs displaying protocols 2-435
configuring threshold 2-373 displaying software 2-670
displaying 2-630 virtual local area network. See VLANs
trunk ports VLAN membership
adding VLANs 2-374 configuring ports 2-266
clearing from ports 2-74 VLAN Membership Policy Server. See VMPS
clearing VLANs 2-74 VLAN path costs
configuring 2-374 assigning port path costs 2-341
displaying 2-631 clearing 2-64
displaying port information 2-534 displaying 2-598
displaying VLAN information 2-639 restoring defaults 2-62
restoring defaults 2-74 setting 2-345
VLAN root guards
disabling 2-351
U
displaying 2-590
UDLD enabling 2-351
disabling 2-377 VLANs
disabling aggressive mode 2-379 adding trunks 2-374
displaying information 2-633 declaring 2-186
enabling 2-377 deleting 2-75
enabling aggressive mode 2-379 deleting reserved mapping 2-77
setting message intervals 2-380 deleting VLAN-mapped pairs 2-77
UplinkFast displaying 2-639
clearing 2-69 displaying blocked ports 2-584
disabling 2-351 displaying conflicts 2-587
displaying settings 2-605 displaying mapping information 2-592
enabling 2-351 displaying nontrunk port information 2-639
displaying spanning tree information 2-580
displaying trunk port information 2-639
V grouping ports 2-381

variable names mapping 802.1Q VLANs to ISL VLANs 2-384

removing 2-665 setting port priority 2-347

setting 2-668 VLAN Trunk Protocol. See VTP

VMPS
configuring servers 2-386

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
IN-IN-16 78-12648-03
 Index

deleting RCP usernames 2-78

deleting statistics 2-79
displaying configuration information 2-643
displaying statistics 2-645
reconfirming membership assignments 2-114
VTP
setting modes 2-387
setting passwords 2-387
VTP domains
displaying 2-646
setting 2-387
VTP pruning
disabling 2-387
enabling 2-387
specifying domains 2-390
specifying ineligibility 2-80
specifying VLANs 2-391
VTP statistics
deleting 2-81
displaying 2-648

web interfaces
configuring TCP port numbers 2-201
disabling HTTP servers 2-202
displaying HTTP configurations 2-460
enabling HTTP servers 2-202
write
display configurations 2-679
upload configurations 2-673

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
78-12648-03 IN-IN-17
 Index

Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Command Reference—Releases 6.3 and 6.4
IN-IN-18 78-12648-03