Cisco IOS Interface and Hardware Component Command Reference PDF
Uploaded by
JeffCisco IOS Interface and Hardware Component Command Reference PDF
Uploaded by
JeffCisco IOS Interface and Hardware Component Command Reference
Americas 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 527-0883
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.
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network
topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional
and coincidental.
All printed copies and duplicate soft copies of this document are considered uncontrolled. See the current online version for the latest version.
Cisco has more than 200 offices worldwide. Addresses and phone numbers are listed on the Cisco website at www.cisco.com/go/offices.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com
go trademarks. Third-party trademarks mentioned 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. (1721R)
© 2018 Cisco Systems, Inc. All rights reserved.
CONTENTS
CHAPTER 1 A through B 1
1pps 3
ais-core-failure 4
ais-shut 5
alarm-interface 6
alarm-profile 7
alarm-profile attach 9
alarm report all 10
als 12
als restart 13
als restart mode 14
als restart pulse 15
analysis-module monitoring 17
announce interval 19
announce timeout 20
anti-jam 21
apply (satellite initial configuration) 22
aps authenticate 24
aps adm 25
aps clear sonet 26
aps force 27
aps force sonet 29
aps group 31
aps hspw-icrm-grp 33
aps lockout 36
aps lockout sonet 37
Cisco IOS Interface and Hardware Component Command Reference
iii
Contents
aps manual 38
aps manual sonet 40
aps protect 42
aps protect (SONET) 43
aps revert 44
aps timers 45
aps unidirectional 46
aps working 48
associate slot 50
association 53
attach profile-name 54
atm sonet 56
au-3 57
au-4 tug-3 58
aug mapping 59
aug mapping [au-3 | au-4] stm [stm number] stm1 number [number] 61
aug mapping au-3 stm [stm number] path number [path number] 62
auto-polarity 63
b2 sd-ber 64
b2 sf-ber 65
backup delay 66
backup interface 67
backup interface atm 69
backup interface cem 71
backup load 73
bandwidth (interface configuration) 74
batch 77
bert abort controller 79
bert controller 81
bert errors 85
bert pattern 86
bert pattern (T1 E1) 88
bert pattern (T3 E3) 90
bert profile 92
Cisco IOS Interface and Hardware Component Command Reference
iv
Contents
bitswap line 94
bridge-domain 95
bridge-domain (subinterface) 100
CHAPTER 2 cable bundle through clock mode 103
cable bundle 105
cable helper-address 107
cablelength 108
cablelength (E1 controller) 110
cablelength long 111
cablelength short 114
card 116
card type (T1-E1) 126
card type (T3-E3) 128
card-protection 131
carrier-delay 133
cem 137
cem-group 138
channel-group 141
channel-group (interface) 146
channel-protocol (interface) 151
channelized 152
class cem 154
clear aim 156
clear cable-diagnostics tdr 157
clear catalyst6000 traffic-meter 158
clear cem 159
clear controller 160
clear controller lex 161
clear controller wanphy 163
clear controller vdsl 165
clear counters 166
clear debug platform condition all 169
clear diagnostic event-log 170
Cisco IOS Interface and Hardware Component Command Reference
v
Contents
clear dsip tracing 171
clear facility-alarm 172
clear hub 174
clear hub counters 175
clear interface 176
clear interface cem 181
clear interface fastethernet 182
clear interface gigabitethernet 184
clear interface serial 185
clear interface vlan 186
clear ipc statistics 187
clear lacp counters 189
clear platform netint 190
clear platform software vnic-if-nvtable 191
clear rbscp 192
clear service-module serial 194
clear top counters interface report 195
clock 196
clock destination 198
clock mode 199
CHAPTER 3 clock rate through cut-through 201
clock rate 203
clock rate (interface ATM) 205
clock rate (interface serial) 207
clock rate network-clock 210
clock recovered adaptive/differential cem 211
clock source 212
clock source(10GE) 214
clock source (AS5200) 216
clock source (CEM) 217
clock source (controller) 220
clock source (CT3IP) 223
clock source (interface) 225
Cisco IOS Interface and Hardware Component Command Reference
vi
Contents
clock source (J1 controller) 227
clock source (MC3810) 228
clock source (SONET controller) 230
clock source (T1 E1 controller) 231
clock source (T1 E1 interface) 233
clock source (T3 E3 controller) 235
clock switchover 236
clock-port 237
cmt connect 239
cmt disconnect 241
compress 243
compress mppc 248
compress stac caim 249
connect (module) 251
constellation 254
control-lead sampling-rate 256
control-lead state 257
controller 259
controller dsl 262
controller dwdm 264
controller e3 265
controller mediatype 266
controller protection-group 267
controller sdh 268
controller sonet 269
controller sonet-acr 271
controller t1/e1 272
controller t3 273
copy flash lex 275
copy tftp lex 276
crc 277
crc bits 5 278
crc4 279
crc-threshold 280
Cisco IOS Interface and Hardware Component Command Reference
vii
Contents
ctunnel mode 281
cut-through 283
CHAPTER 4 D through E 285
data-protection 287
data-strobe 288
dce-terminal-timing enable 289
debug l2protocol-tunnel 290
debug platform link-dc 291
debug platform network-clock 295
debug platform software ucse 296
debug snmp tunnel-mib 297
default (CEM) 298
default interface 300
define interface-range 302
dejitter-buffer 304
delay-asymmetry 306
delay (interface) 307
delay-req interval 308
description (controller) 310
description (interface configuration) 311
diagnostic level 312
dial-tdm-clock 314
dot1q tunneling ethertype 316
down-when-looped 318
ds0-group (J1 controller) 320
dsl-group 322
dsl-mode shdsl symmetric annex 327
dsu bandwidth 330
dsu mode 333
dte-invert-txc 336
duplex 337
dxi interface-dfa 342
dxs3mode 344
Cisco IOS Interface and Hardware Component Command Reference
viii
Contents
e2-clockrate 345
early-token-release 346
efm-grp 347
eigrp interface 348
emulation-mode 350
encapsulation 351
end (satellite initial configuration) 355
equipment loopback 356
errdisable detect cause 357
errdisable recovery 359
error throttling 362
esmc mode ql-disabled 364
esmc process 365
exit (satellite initial configuration) 366
CHAPTER 5 F through H 367
fabric buffer-reserve 370
fabric clear-block 372
fabric error-recovery fabric-switchover (virtual switch) 373
fabric lcd-banner 374
fabric required 376
fabric switching-mode allow 378
fabric switching-mode force bus-mode 381
fabric timer 383
facility-alarm 384
facility-alarm critical exceed-action shutdown 386
facility-alarm detect 387
fddi burst-count 389
fddi c-min 390
fddi cmt-signal-bits 391
fddi duplicate-address-check 393
fddi encapsulate 394
fddi frames-per-token 396
fddi smt-frames 397
Cisco IOS Interface and Hardware Component Command Reference
ix
Contents
fddi tb-min 398
fddi tl-min-time 399
fddi token-rotation-time 400
fddi t-out 401
fddi valid-transmission-time 402
fdl 403
flowcontrol 405
frame-relay 407
framing 409
framing (CEM) 411
framing (E3 controller) 413
framing (SONET) 415
framing (T1 E1 controller) 416
framing (T3 controller) 418
framing (T3-E3 interface) 420
full-duplex 422
g709 disable 425
g709 fec 426
g709 odu report 427
g709 odu overhead tti 429
g709 odu threshold 430
g709 otu report 432
g709 otu threshold 434
g709 tti-processing enable 436
gnss 437
gtp 438
half-duplex 440
half-duplex controlled-carrier 442
half-duplex timer 444
history (interface) 446
hold-queue 449
hssi external-loop-request 452
hssi internal-clock 453
hub 454
Cisco IOS Interface and Hardware Component Command Reference
x
Contents
hw-module boot 455
hw-module energywise level 457
hw-module fan-tray version 459
hw-module interface als restart 461
hw-module main-cpu qa error-recovery 462
hw-module mode 464
hw-module oversubscription 466
hw-module power-supply power-cycle 467
hw-module pxf stall-monitoring 468
hw-module reset 469
hw-module sec-cpu reset 470
hw-module shutdown 472
hw-module simulate link-up 473
hw-module slot 474
hw-module slot (6500) 477
hw-module slot (7300) 480
hw-module slot (7600) 482
hw-module slot (ASR 1000 Series) 485
hw-module slot image 488
hw-module slot subslot only 489
hw-module standby 491
hw-module subslot 493
hw-module subslot (4400) 495
hw-module subslot ethernet vlan unlimited 497
hw-module subslot (LAN WAN) 499
hw-module subslot service-engine session 501
hw-module subslot session 503
hw-module subslot shutdown 504
hw-module subslot shutdown (4400) 506
CHAPTER 6 I through K 509
id aa-group 511
id software group 512
id vsat 513
Cisco IOS Interface and Hardware Component Command Reference
xi
Contents
idle-pattern 514
ids-service-module monitoring 515
if-mgr delete 516
ignore (interface) 517
ignore-dcd 519
ignore-error-duration 520
ignore-hw local-loopback 521
imc access-port 522
imc config file 525
imc dns 526
imc ip address default-gateway 527
imc ip address dhcp 528
imc ip dhcp 529
imc remote-manager 530
imc vlan 531
input 532
interface 533
interface analysis-module 546
interface content-engine 547
interface fastethernet 548
interface gigabitethernet 549
interface group-async 550
interface integrated-service-engine 551
interface ism 552
interface port-channel 553
interface pos 554
interface range 555
interface satellite 559
interface service-engine 560
interface sm 561
interface vg-anylan 562
interface vmi 563
interface wlan-controller 565
international bit 566
Cisco IOS Interface and Hardware Component Command Reference
xii
Contents
inter-packet gap 6502-mode 567
invert data 568
invert rxclock 570
invert txclock 571
ip dscp 572
ip pxf 573
ip rbscp ack-split 574
ip verify unicast source reachable-via 576
ipc buffers 582
ipc header-cache 583
ipc holdq threshold 584
ipc master 585
ipc zone default 586
iphc-profile 587
keepalive 591
CHAPTER 7 l2 vfi manual through loopback PA-MC-8TE1 + port adapter 595
l2 vfi manual 597
l2protocol-tunnel 599
l2protocol-tunnel cos 601
l2protocol-tunnel drop-threshold 602
l2protocol-tunnel global drop-threshold 604
l2protocol-tunnel point-to-point 605
l2protocol-tunnel shutdown-threshold 606
l3vpn encapsulation ip 608
lacp active-port distribution automatic 609
lacp fast-switchover 611
lacp max-bundle 613
lacp port-priority 615
lacp rate 617
lacp system-priority 618
lbo 620
lex burned-in-address 622
lex input-address-list 623
Cisco IOS Interface and Hardware Component Command Reference
xiii
Contents
lex input-type-list 624
lex priority-group 625
lex retry-count 627
lex timeout 628
license feature gnss 629
linecard-group y-cable 630
linecode 631
line-mode 632
line-mode bonding 634
line-mode single-wire line 635
line-rate 636
line-term 638
line-termination 639
link debounce 640
link state group 642
link state track 643
li-slot rp rate 644
link-test 645
load-balancing 646
load-interval 648
local ip address 650
local-priority 651
local udp port 652
local-lnm 653
logging event 654
logging source-interface 656
logging event link-status (global configuration) 658
logging event link-status (interface configuration) 660
logging event subif-link-status 661
logging-events 662
logging-events (T1-E1 controller) 663
loopback (CEM) 664
loopback (DSL controller) 666
loopback (E3 controller) 669
Cisco IOS Interface and Hardware Component Command Reference
xiv
Contents
loopback (interface) 670
loopback (J1 controller ) 672
loopback (PA-MC-8TE1+ port adapter) 673
CHAPTER 8 loopback T1 interface through nrzi-encoding 675
loopback (T1 interface) 677
loopback (T3/E3 controller) 680
loopback (T3-E3 interface) 682
loopback applique 684
loopback dte 685
loopback line 686
loopback remote (interface) 688
loopback remote (T1/T3/SDH/SONET Controller) 691
loopback (SONET) 694
mac-address-table learning 695
mac-address (virtual switch) 697
mac-address-table secure 699
main-fiber port 703
max-reserved-bandwidth 704
mdix auto 707
mdl 708
media-type 710
media-type auto-failover 712
member subslot 713
microcode reload controller 717
mls exclude protocol 718
mls ip delete-threshold 719
mls ip directed-broadcast 720
mls ipx 722
mls verify 723
mobility 725
mode 727
mode (ATM T1 E1 controller) 730
mode (HSA redundancy) 733
Cisco IOS Interface and Hardware Component Command Reference
xv
Contents
mode (RSC redundancy) 735
mode (T1 E1 controller) 736
mode bypass 739
mode c-12 741
mode ct3 743
mode download 744
mode e3 745
mode sonet 746
mode sts-nc 747
mode t3/e3 748
mode two-way 749
mode vc-1x 750
mode vc-4 751
mode vc4-Nc 752
mode vt-15 753
mode t3 754
mode tug-3 755
modem dtr-delay 756
monitoring 757
mop enabled 759
mop sysid 760
mtu 761
national bit (controller) 764
national bit (interface) 765
national reserve 766
negotiation 767
neighbor (VPLS) 769
network-clock (BITS) 771
network-clock clear lockout 774
network-clock hold-off global 776
network-clock input-source 777
network-clock set lockout 778
network-clock synchronization ssm option 780
network-clock synchronization automatic 782
Cisco IOS Interface and Hardware Component Command Reference
xvi
Contents
network-clock synchronization mode QL-enabled 783
network-clock quality-level 784
no channelized 787
nrzi-encoding 789
CHAPTER 9 O through R 791
outbound data-pid 794
outbound data-rate 795
outbound frequency 796
outbound id 797
outbound modulation-type 798
outbound sync ip address 799
outbound viterbi-rate 800
output 801
overhead c2 803
overhead j0 804
overhead j1 806
overhead tunnel 808
overhead s1s0 810
password (satellite initial configuration) 811
payload-compression 812
payload-size dejitter-buffer 813
payload-size 815
physical-interface 820
physical-layer 821
platform console 823
platform cwan acl software-switched 824
platform enable controller mediaType 825
platform hardware throughput level 826
platform ip features sequential 829
platform punt-keepalive 831
platform scp retry interval 833
platform smart-sfp 834
platform time-source 836
Cisco IOS Interface and Hardware Component Command Reference
xvii
Contents
platform trace boottime process forwarding-manager module interfaces 838
pm fec threshold 840
pm optics report 841
pm otn report 842
pm optics threshold 845
pm otn threshold 846
port (interface) 847
port access-map 848
port-channel hash-distribution 850
port-channel load-balance 851
port-channel load-balance (interface) 854
port-channel load-balance mpls 856
port-channel load-balance weighted rebalance 858
port-channel load-balancing vlan-manual 859
port-channel load-defer 861
port-channel min-links 863
port-channel per-module load-balance 864
port-channel port load-defer 865
port-channel standalone-disable 867
pos ais-shut 868
pos delay triggers 869
pos flag 872
pos flag s1-byte rx-communicate 874
pos flag s1-byte tx 875
pos framing 876
pos report 877
pos scramble-atm 879
pos threshold 881
power inline 883
power enable 888
power inline 889
power redundancy-mode 894
ppp link 895
ppp loopback no-backoff 897
Cisco IOS Interface and Hardware Component Command Reference
xviii
Contents
ppp multilink mrru 899
pri-group 903
priority1 904
priority2 905
proactive enable 906
proactive rvrt-threshold 907
proactive rvrt-window 908
proactive trig-threshold 909
protection-group 911
protection-group [working | protect] 912
protocol gre 913
ptp clock 914
pulse-time 915
rate 917
recovered-clock 919
redundancy 920
redundancy all-active replicate 925
redundancy force-switchover 926
redundancy handover 929
redundancy stateful 931
remote command 932
remote-span 934
remote login 935
reset (alarm-interface) 937
retry 938
ring-speed 939
rj45-auto-detect-polarity 940
CHAPTER 10 scramble through service-module t1 lbo 941
scramble 944
serial restart-delay 946
server ip address 947
service alarm persistency interval 948
service declassify 949
Cisco IOS Interface and Hardware Component Command Reference
xix
Contents
service-engine default-gateway 952
service-engine hostname 954
service-engine ip address 956
service-engine nameserver 958
service-engine wma-passcode 960
service-engine wma-token 962
service-engine wma-url 964
service single-slot-reload-enable 966
service-module 967
service-module 56k clock rate 969
service-module 56k clock source 971
service-module 56k data-coding 972
service-module 56k network-type 973
service-module 56k remote-loopback 975
service-module 56k switched-carrier 976
service-module analysis-module reload 978
service-module analysis-module reset 979
service-module analysis-module session 980
service-module analysis-module shutdown 982
service-module analysis-module status 984
service-module backup interface 985
service-module backup mode 986
service-module content-engine reload 988
service-module content-engine reset 989
service-module content-engine session 990
service-module content-engine shutdown 992
service-module content-engine status 993
service-module external ip address 995
service-module heartbeat-reset disable 996
service-module ids-sensor 997
service-module integrated-service-engine default-boot 999
service-module integrated-service-engine reload 1000
service-module integrated-service-engine reset 1001
service-module integrated-service-engine session 1003
Cisco IOS Interface and Hardware Component Command Reference
xx
Contents
service-module integrated-service-engine shutdown 1005
service-module integrated-service-engine status 1006
service-module integrated-service-engine statistics 1008
service-module ip address 1009
service-module ip default-gateway 1013
service-module ip redundancy 1014
service-module ism default-boot 1015
service-module ism heartbeat-reset 1016
service-module ism install 1018
service-module ism install abort 1020
service-module ism reload 1021
service-module ism reset 1022
service-module ism session 1023
service-module ism shutdown 1025
service-module ism statistics 1026
service-module ism status 1027
service-module ism uninstall 1028
service-module mgf ip address 1029
service-module mgf ip default-gateway 1030
service-module mgf ipv6 address 1031
service-module routing redistribute 1032
service-module satellite backup 1033
service-module satellite configuration 1034
service-module satellite cw-mode 1036
service-module satellite status 1038
service-module service-engine 1045
service-module sm default-boot 1046
service-module sm heartbeat-reset 1047
service-module sm install 1049
service-module sm install abort 1051
service-module sm reload 1052
service-module sm reset 1053
service-module sm session 1054
service-module sm shutdown 1056
Cisco IOS Interface and Hardware Component Command Reference
xxi
Contents
service-module sm statistics 1057
service-module sm status 1058
service-module sm uninstall 1059
service-module t1 cablelength short 1060
service-module t1 clock source 1061
service-module t1 data-coding 1062
service-module t1 fdl 1063
service-module t1 framing 1064
service-module t1 lbo 1065
CHAPTER 11 service-module t1 linecode through show controllers satellite 1067
service-module t1 linecode 1069
service-module t1 remote-alarm-enable 1070
service-module t1 remote-loopback 1071
service-module t1 timeslots 1073
service-module wlan-ap bootimage 1075
service-module wlan-ap reload 1077
service-module wlan-ap reset 1079
service-module wlan-ap session 1081
service-module wlan-ap statistics 1083
service-module wlan-ap status 1084
session slot 1085
set ip df 1086
set platform hardware qfp active feature ipsec event-monitor 1088
shdsl annex 1089
shdsl rate 1092
shelf-id 1095
show (satellite initial configuration) 1097
show alarm-interface 1099
show alarm-profile 1101
show als 1102
show aps 1104
show asic-version 1106
show c7300 1107
Cisco IOS Interface and Hardware Component Command Reference
xxii
Contents
show c7300 errorlog 1110
show c7300 pxf accounting 1113
show c7300 pxf interfaces 1115
show c7300 slot 1117
show cable bundle 1119
show cable-diagnostics tdr 1120
show card-protection CPGN detail 1122
show catalyst6000 1123
show cem 1125
show cem circuit 1128
show chassis 1132
show class cem 1134
show compress 1136
show controllers c3794 1138
show controller dsl 1139
show controller vdsl 1143
show controllers analysis-module 1148
show controllers cbus 1151
show controllers content-engine 1158
show controllers dsx3 1161
show controller dwdm 1164
show controllers e1 1166
show controllers e3 1171
show controllers ethernet 1176
show controllers fastethernet 1179
show controllers fddi 1190
show controllers gigabitethernet 1191
show controllers integrated-service-engine 1203
show controllers ism 1204
show controllers j1 1207
show controllers lex 1210
show controllers mci 1212
show controllers pcbus 1214
show controllers pos 1215
Cisco IOS Interface and Hardware Component Command Reference
xxiii
Contents
show controllers satellite 1223
CHAPTER 12 show controllers serial through show hw-module slot proc cpu 1227
show cem circuit 1229
show controllers serial 1230
show controllers serial bert 1238
show controllers sm 1240
show controllers sonet 1243
show controllers t1 1256
show controllers t1 bert 1263
show controllers T1-E1 errors 1265
show controllers t3 1266
show controllers t3 bert 1289
show controllers token 1291
show controllers vg-anylan 1294
show controllers wanphy 1296
show controllers wlan-controller 1298
show counters interface 1301
show diag 1304
show diagnostic bootup level 1342
show diagnostic content module 1343
show diagnostic cns 1347
show diagnostic description module 1348
show diagnostic events 1350
show diagnostic result slot 1353
show diagnostic simulation failure 1355
show diagnostic health 1356
show diagnostic ondemand settings 1358
show diagnostic result module 1359
show diagnostic sanity 1362
show diagnostic schedule module 1366
show diagnostic status 1368
show dsc clock 1370
show dsi 1372
Cisco IOS Interface and Hardware Component Command Reference
xxiv
Contents
show dsip 1379
show dsip clients 1382
show dsip nodes 1384
show dsip ports 1386
show dsip queue 1389
show dsip tracing 1390
show dsip transport 1392
show dsip version 1395
show dtp interface 1397
show eobc 1400
show errdisable detect 1403
show errdisable recovery 1404
show esmc 1405
show etherchannel 1407
show etherchannel load-balancing 1416
show fabric 1418
show fm features 1422
show fm inband-counters 1424
show gnss 1425
show gtp 1427
show hspw-aps-icrm 1430
show hub 1431
show hw-module all fpd 1435
show hw-module slot (6500) 1439
show hw-module slot align 1441
show hw-module slot fpd 1442
show hw-module slot logging 1445
show hw-module slot proc cpu 1447
CHAPTER 13 show hw-module slot tech-support through show interfaces vg-anylan 1449
show hw-module slot tech-support 1451
show hw-module subslot 1464
show hw-module subslot fpd 1469
show hw-module subslot oir 1473
Cisco IOS Interface and Hardware Component Command Reference
xxv
Contents
show hw-module subslot service-engine status 1477
show hw-module subslot transceiver 1479
show hw-programmable 1484
show icc 1486
show interfaces cem 1488
show interface history 1490
show interface sdcc 1493
show interfaces 1498
show interfaces accounting 1539
show interfaces analysis-module 1541
show interfaces bdi 1546
show interfaces capabilities 1548
show interfaces content-engine 1551
show interfaces counters nonzero 1557
show interfaces ctunnel 1559
show interfaces debounce 1563
show interfaces description 1565
show interfaces ethernet 1567
show interfaces fastethernet 1573
show interfaces fddi 1582
show interfaces flowcontrol 1591
show interfaces gigabitethernet 1594
show interfaces hssi 1602
show interfaces integrated-service-engine 1608
show interfaces ism 1610
show interfaces lex 1615
show interfaces loopback 1620
show interfaces port-channel 1624
show interfaces port-channel etherchannel 1630
show interfaces pos 1633
show interfaces private-vlan mapping 1639
show interfaces satellite 1641
show interfaces serial 1649
show interfaces sm 1671
Cisco IOS Interface and Hardware Component Command Reference
xxvi
Contents
show interfaces status 1676
show interfaces summary 1679
show interfaces switchport 1682
show interfaces switchport backup 1684
show interfaces tokenring 1686
show interfaces transceiver 1692
show interfaces transceiver details 1700
show interfaces transceiver slot 1703
show interfaces transceiver slot details 1704
show interfaces transceiver subslot 1706
show interfaces transceiver subslot details 1707
show interfaces <interface> transceiver 1709
show interfaces <interface> transceiver detail 1711
show interfaces trunk 1714
show interfaces tunnel 1717
show interfaces ucse 1722
show interfaces unidirectional 1724
show interfaces vg-anylan 1725
CHAPTER 14 show interfaces vlan mapping through show scp 1731
show interfaces vlan mapping 1734
show interfaces wlan-controller 1735
show ip interface 1736
show ipc 1745
show ipc hog-info 1751
show ipv6 ospf interface 1753
show l2protocol-tunnel 1759
show l3-mgr 1763
show l3vpn encapsulation ip 1765
show lacp 1766
show link state group 1772
show mac-address-table dynamic 1773
show mls asic 1777
show mls ip 1778
Cisco IOS Interface and Hardware Component Command Reference
xxvii
Contents
show mls ipx 1781
show mobility 1783
show module 1785
show msfc 1788
show network-clocks 1792
show pagp 1795
show pas caim 1797
show pas eswitch address 1808
show pas i82543 interface 1809
show pas isa controller 1814
show pas isa interface 1815
show pas vam controller 1818
show pas vam interface 1819
show pas y88e8k interface 1823
show pci aim 1825
show platform 1826
show platform acl software-switched 1838
show platform atom disp-tbl backup 1839
show platform atom disp-tbl local-vc-label 1840
show platform atom imp-tbl backup 1841
show platform atom imp-tbl remote-vc-label 1842
show platform atom tbl-summary 1843
show platform condition 1844
show platform diag 1845
show platform discover-devices 1849
show platform dwdm alarm history 1852
show platform hardware capacity 1854
show platform hardware capacity rewrite-engine 1861
show platform hardware interface 1865
show platform hardware network-clocks 1869
show platform hardware pp active interface all 1871
show platform hardware qfp active feature cef-mpls urpf 1872
show platform hardware qfp active feature cef-mpls prefix ip 1873
show platform hardware qfp active feature cef-mpls prefix mpls 1875
Cisco IOS Interface and Hardware Component Command Reference
xxviii
Contents
show platform hardware qfp active feature multicast 1877
show platform hardware qfp active infrastructure punt 1884
show platform hardware qfp active interface if-name statistics 1888
show platform hardware qfp statistics drop 1891
show platform hardware qfp interface 1894
show platform hardware slot 1900
show platform hardware throughput level 1910
show platform hardware subslot 1911
show platform hardware subslot (4400) 1913
show platform hardware transceiver 1916
show platform isg memory 1918
show platform mgf 1919
show platform slot r0 pcie status 1922
show platform software agent iomd 1923
show platform software memory 1925
show platform software mount 1931
show platform software infrastructure punt-keepalive 1935
show platform software interface summary 1937
show platform software process list 1939
show platform software process memory 1949
show platform software ptp foreign-master 1954
show platform software status control-processor 1956
show platform software punt-policer 1960
show platform process slot 1961
show platform software tech-support 1963
show platform software vnic-if interface-mapping 1965
show platform time-source 1967
show plim fpga 1968
show policy-map interface 1970
show power 2017
show power inline 2021
show process | include persis 2023
show protection-group 2024
show ptp clock dataset 2025
Cisco IOS Interface and Hardware Component Command Reference
xxix
Contents
show ptp clock dataset parent 2027
show ptp clock dataset time-properties 2029
show ptp clock running 2031
show ptp port dataset foreign-master 2033
show ptp port dataset port 2035
show pxf cpu access-lists 2037
show pxf cpu iedge 2043
show pxf cpu qos 2044
show pxf dma 2046
show pxf max-logical-interfaces 2049
show qm-sp port-data 2050
show rbscp 2052
show redundancy 2056
show redundancy (HSA redundancy) 2063
show redundancy interchassis 2064
show redundancy interlink 2065
show rpc 2067
show running configuration | include mode 2069
show scp 2070
CHAPTER 15 show service-module serial through standby port 2073
show service-module serial 2075
show sip-disk 2080
show slot0: 2082
show smf 2085
show srp 2087
show storm-control 2090
show sup-bootflash 2093
show syscon sdp 2096
show system jumbomtu 2098
show tcam counts 2099
show tcam interface 2101
show tcam-mgr subslot 2104
show tdm backplane 2109
Cisco IOS Interface and Hardware Component Command Reference
xxx
Contents
show tdm connections 2111
show tdm data 2113
show tdm detail 2115
show tdm information 2117
show tdm pool 2119
show tunnel interface 2121
show tunnel keys-database tunnel 2125
show top counters interface report 2127
show ucse imc download progress 2129
show ucse imc files 2130
show ucse server boot 2131
show ucse server erase device status 2133
show ucse server raid level 2134
show upgrade file 2135
show upgrade fpd file 2136
show upgrade fpd package default 2142
show upgrade fpd progress 2145
show upgrade fpd table 2148
show upgrade fpga progress 2151
show upgrade hw-programmable file 2152
show upgrade hw-programmable progress 2154
show upgrade package default 2155
show upgrade progress 2156
show upgrade table 2157
show vmi neighbors 2158
show wedged-interfaces 2161
shutdown (controller) 2162
shutdown (dwdm) 2164
shutdown (hub) 2165
shutdown (interface) 2166
signaling 2168
smt-queue-threshold 2170
snmp ifmib ifindex persist 2171
snmp ifindex clear 2172
Cisco IOS Interface and Hardware Component Command Reference
xxxi
Contents
snmp-server enable traps netsync 2174
snmp ifindex persist 2175
snmp trap illegal-address 2177
snmp-server ifindex persist 2179
snr margin 2181
source-address 2183
speed 2184
squelch 2190
sra line 2191
standby port 2192
sts-1 2194
CHAPTER 16 squelch through system jumbomtu 2195
squelch 2197
srp buffer-size 2198
srp deficit-round-robin 2199
srp loopback 2201
srp priority-map 2202
srp random-detect 2204
srp shutdown 2205
srp tx-traffic-rate 2206
stack-mib portname 2207
storm-control 2208
storm-control level 2211
subslot 2213
switchport 2214
switchport access vlan 2218
switchport autostate exclude 2220
switchport backup 2222
switchport block unicast 2225
switchport capture 2226
switchport capture allowed vlan 2228
switchport dot1q ethertype 2230
switchport mode 2232
Cisco IOS Interface and Hardware Component Command Reference
xxxii
Contents
switchport port-security 2236
switchport port-security aging 2238
switchport port-security mac-address 2240
switchport port-security maximum 2243
switchport port-security violation 2245
switchport private-vlan host-association 2247
switchport private-vlan mapping 2249
switchport protected 2251
switchport trunk 2253
switchport vlan mapping 2260
switchport vlan mapping enable 2263
switchport voice vlan 2265
sync interval 2267
sync-restart-delay 2269
syscon address 2270
syscon shelf-id 2271
syscon source-interface 2272
system flowcontrol bus 2273
system jumbomtu 2274
CHAPTER 17 t1 through tug-2 e1 unframed 2275
t1 2277
t1 bert 2278
t1/e1 cem-group 2280
t1 clock source 2281
t1 external 2283
t1 fdl ansi 2285
t1 framing 2287
t1 linecode 2289
t1 logging-events 2291
t1/e1 loopback 2292
t1 t1-line-number cem-group 2294
t1 t1-line-number clock source 2295
t1 t1 line-number framing 2296
Cisco IOS Interface and Hardware Component Command Reference
xxxiii
Contents
t1 span 2297
t1 span syslog 2300
t1 test 2302
t1 timeslot 2304
t1 yellow 2306
tcam priority 2307
termination 2309
test aim eeprom 2310
test cable-diagnostics 2312
test interface fastethernet 2314
test platform police get 2315
test platform debugger rommon 2316
test platform police ipv6 disable 2317
test platform police set 2318
test satellite satellite mfg link 2319
test satellite satellite reset 2320
test service-module 2321
test trunk 2323
threshold 2325
timeslot 2326
time-properties persist 2328
tod 2329
transceiver type all 2331
transmit-buffers backing-store 2332
transmit-clock-internal 2333
transmit-interface 2334
transmitter-delay 2335
transport-mode 2336
transport ipv4 2338
transport ipv4 (PTP) 2339
ts16 2341
ttb 2342
ttl 2344
tu-ais 2345
Cisco IOS Interface and Hardware Component Command Reference
xxxiv
Contents
tug-2 2346
tug-2 e1 2347
tug-2 e1 bert pattern 2348
tug-2 e1 channel-group timeslots 2350
tug-2 e1 clock source 2352
tug-2 e1 framing 2354
tug-2 e1 loopback 2356
tug-2 e1 national bits 2358
tug-2 e1 shutdown 2360
tug-2 e1 unframed 2362
tug-3 2364
CHAPTER 18 tunnel bandwidth through yellow 2365
tunnel bandwidth 2367
tunnel checksum 2368
tunnel destination 2369
tunnel endpoint service-policy output 2373
tunnel entropy 2374
tunnel key 2376
tunnel mode 2377
tunnel path-mtu-discovery 2383
tunnel rbscp ack_split 2385
tunnel rbscp delay 2386
tunnel rbscp input_drop 2387
tunnel rbscp long_drop 2388
tunnel rbscp report 2389
tunnel rbscp window_stuff 2390
tunnel route-via 2391
tunnel sequence-datagrams 2392
tunnel source 2393
tunnel tos 2397
tunnel ttl 2398
tunnel vrf 2399
type STS48c 2401
Cisco IOS Interface and Hardware Component Command Reference
xxxv
Contents
tx-queue-limit 2402
ucse subslot imc password-reset 2403
ucse subslot server 2404
ucse subslot server password-reset 2406
ucse subslot shutdown 2408
ucse subslot statistics 2409
ucse subslot status 2410
ucse cmos-reset 2412
ucse heartbeat-reset 2414
ucse imc config 2415
ucse imc file delete 2416
ucse imc file download 2417
ucse password-reset 2418
ucse server boot 2420
ucse server boot order 2422
ucse server erase device hdd 2424
ucse server raid level 2425
ucse server reload boot 2427
ucse server reset boot 2428
ucse session 2429
ucse shutdown 2431
ucse server start boot 2432
ucse statistics 2433
ucse status 2435
ucse stop 2437
unidirectional 2439
upgrade fpd auto 2441
upgrade fpd path 2444
upgrade fpga 2446
upgrade fpga all 2450
upgrade hw-module slot 2454
upgrade hw-module slot fpd file 2458
upgrade hw-module subslot 2462
upgrade hw-module subslot fpd file 2466
Cisco IOS Interface and Hardware Component Command Reference
xxxvi
Contents
upgrade hw-programmable 2469
upgrade rom-monitor default 2471
upgrade satellite satellite 2473
utc offset leap-second offset 2475
vectoring 2476
vtg 2477
wanphy flag j1 transmit 2479
wanphy report-alarm 2480
wanphy threshold 2482
xconnect (CEM) 2484
yellow 2486
Cisco IOS Interface and Hardware Component Command Reference
xxxvii
Contents
Cisco IOS Interface and Hardware Component Command Reference
xxxviii
A through B
• 1pps, on page 3
• ais-core-failure, on page 4
• ais-shut, on page 5
• alarm-interface, on page 6
• alarm-profile, on page 7
• alarm-profile attach, on page 9
• alarm report all, on page 10
• als, on page 12
• als restart, on page 13
• als restart mode, on page 14
• als restart pulse, on page 15
• analysis-module monitoring, on page 17
• announce interval, on page 19
• announce timeout, on page 20
• anti-jam, on page 21
• apply (satellite initial configuration), on page 22
• aps authenticate, on page 24
• aps adm, on page 25
• aps clear sonet, on page 26
• aps force, on page 27
• aps force sonet, on page 29
• aps group, on page 31
• aps hspw-icrm-grp, on page 33
• aps lockout, on page 36
• aps lockout sonet, on page 37
• aps manual, on page 38
• aps manual sonet, on page 40
• aps protect, on page 42
• aps protect (SONET), on page 43
• aps revert, on page 44
• aps timers, on page 45
• aps unidirectional, on page 46
• aps working, on page 48
Cisco IOS Interface and Hardware Component Command Reference
1
A through B
• associate slot, on page 50
• association, on page 53
• attach profile-name, on page 54
• atm sonet, on page 56
• au-3, on page 57
• au-4 tug-3, on page 58
• aug mapping, on page 59
• aug mapping [au-3 | au-4] stm [stm number] stm1 number [number], on page 61
• aug mapping au-3 stm [stm number] path number [path number], on page 62
• auto-polarity, on page 63
• b2 sd-ber, on page 64
• b2 sf-ber, on page 65
• backup delay, on page 66
• backup interface, on page 67
• backup interface atm, on page 69
• backup interface cem, on page 71
• backup load, on page 73
• bandwidth (interface configuration), on page 74
• batch, on page 77
• bert abort controller, on page 79
• bert controller, on page 81
• bert errors, on page 85
• bert pattern, on page 86
• bert pattern (T1 E1), on page 88
• bert pattern (T3 E3), on page 90
• bert profile, on page 92
• bitswap line, on page 94
• bridge-domain, on page 95
• bridge-domain (subinterface), on page 100
Cisco IOS Interface and Hardware Component Command Reference
2
A through B
1pps
1pps
To configure the pulse per second parameters of the global navigation satellite system (GNSS) module on the
Cisco ASR 903, Cisco ASR 907, and the Cisco ASR 920 routers, use the 1pps command in the gnss mode.
To remove the 1pps configuration, use the no form of this command.
1pps {offset|polarity [negative]}
no 1pps {offset|polarity negative}
Syntax Description offset Configures the 1PPS cable compensation. The valid values are from 0 to 1000 nano seconds.
polarity Configures the 1PPS polarity.
negative Configures the polarity as negative. Default polarity is positive.
Command Default No default behavior or values.
Command Modes GNSS configuration (config-gnss)
Command History Release Modification
IOS-XE 3.17 This command was introduced on the Cisco ASR 903, Cisco ASR 907, and the Cisco ASR
920 routers.
Usage Guidelines The pulse per second is used to synchronize time with other sensors and is crucial for the accuracy of the
sensor integration.
Examples The following example shows how to configure the PPS:
Router# configure terminal
Router(config)# gnss slot r0
Router(config-gnss)# 1pps polarity negative
Related Commands Command Description
gnss Configures the GNSS on the router.
anti-jam Enables or disables the anti-jam mode on the GNSS module.
constellation Configures the GNSS module based on the specified satellite constellations.
default Resets the device to its default state.
exit Exists the GNSS sub mode.
no Negates the command or sets the value of the command to its default values.
shutdown Enables GNSS module.
Cisco IOS Interface and Hardware Component Command Reference
3
A through B
ais-core-failure
ais-core-failure
To enable AIS alarms to detect core failure events on a 8/16 T1E1 IM, use the ais-core-failure command in
controller configuration mode. To disable the AIS alarms, use the no form of this command..
ais-core-failure
no ais-core-failure
Syntax Description Syntax Description
This command has no keywords or arguments.
Command Default This command is disabled by default; AIS alarm is not reported during core failure events.
Command Modes Controller configuration
Command History Release Modification
IOS XE Everest Support for this command was introduced on the Cisco ASR 900 Routers.
16.7.1
Usage Guidelines AIS alarms are generated and detected either when the TDM circuits goes down on the access layer of the
network topology or a failure occurs in the MPLS domain due to which SAToP connectivity goes down. This
alarm is only applicable for SDH-E1 and unframed (SAToP) type and is not applicable for framed (CESoP)
type.
You cannot configure AIS alarms if CEM group is enabled.You must first remove the CEM group configuration
and then configure AIS alarms.
Examples The following example shows the configuration of AIS alarm:
Router> enable
Router#configure terminal
Router(config)#controller t1 0/1/2
Router(config-controller)#ais-core-failure
Related Commands Command Description
show run | Displays the AIS alarm configuration.
sec
Cisco IOS Interface and Hardware Component Command Reference
4
A through B
ais-shut
ais-shut
To enable automatic insertion of a Line Alarm Indication Signal (LAIS) in the sent SONET signal whenever
the SONET port enters the administrative shutdown state, use the ais-shut command in SONET configuration
mode. To disable automatic insertion of a LAIS, use the no form of this command..
ais-shut
no ais-shut
Syntax Description Syntax Description
This command has no keywords or arguments.
Command Default This command is disabled by default; no AIS is sent.
Command Modes Controller configuration
Command History Release Modification
XE 3.18 Support for this command was introduced on NCS 4200 Series.
SP
Usage Guidelines When the line is placed in administrative shutdown state, use the ais-shut command to send a signal to
downstream equipment that indicates that there is a problem with the line.
Examples The following example shows the configuration of AIS SHUT:
enable
configure terminal
controller MediaType 0/5/0
mode sonet
controller sonet 0/5/0
ais-shut
end
Related Commands Command Description
controller sonet Configures the SONET mode.
show controller sonet Displays SONET controller configuration.
Cisco IOS Interface and Hardware Component Command Reference
5
A through B
alarm-interface
alarm-interface
To enter alarm-interface mode and configure the alarm interface controller (AIC), use the alarm-interface
command in global configuration mode. To leave alarm-interface mode, use the exit command.
alarm-interface slot-number
Syntax Description slot-number Number of the port in which the AIC is installed.
Command Default No default behavior or values
Command Modes Global configuration
Command History Release Modification
12.2(2)XG This command was introduced for the Cisco 2600 series and the Cisco 3600 series.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T.
Examples The following examples show how the alarm-interface command is used in conjunction with the
ipaddress and the reset commands:
Router(config)# alarm-interface 5
Router(config-aic)# ip address 10.2.130.105
A change in the AIC IP configuration might not take effect until the next time the card is started.
Use the reset command to restart the card, as in the following example:
Router(config-aic)# reset
Alarm Interface Card in slot 5 restarted
Router(config-aic)# end
Related Commands Command Description
ip address Sets a primary or secondary IP address for an interface.
reset Resets the AIC CPU.
Cisco IOS Interface and Hardware Component Command Reference
6
A through B
alarm-profile
alarm-profile
To create an alarm profile for chassis, card or interface module, and port, use the alarm-profile command in
configuration mode. To delete the alarm profile, use the no form of this command.
The alarm profile is associated to an alarm with controller types such as SONET, SDH, DS1, or DS3.
alarm-profile profile-name {chassis | card | port}
Syntax Description Syntax Description
profile-name The name of the alarm profile. The name should be a string with alpha numeric characters
and should not exceed 32 characters.
chassis Alarm profile created for chassis.
card Alarm profile created for card.
port Alarm profile created for port.
Command Default None
Command Modes Configuration mode
Command History Release Modification
Cisco IOS XE 16.8.1 Support for this command was introduced on ASR 900 Series.
Usage Guidelines This command is used to create alarm profile for chassis, card, or port in the configuration mode.
Examples The following example shows how to create an alarm profile for chassis:
router(config)#alarm profile CHASSIS chassis
router(config-alarm-profile)#alarm sonet/sdh
router(config-alarm-properties)#SLOF syslog
router(config-alarm-properties)#SLOF severity critical
Examples The following example shows how to create an alarm profile for card:
router(config)#alarm profile CARD card
router(config-alarm-profile)#alarm ds3
router(config-alarm-properties)#DS3_RX_LOS syslog
router(config-alarm-properties)#DS3_RX_LOS severity major
Examples The following example shows how to create an alarm profile for port:
Cisco IOS Interface and Hardware Component Command Reference
7
A through B
alarm-profile
router(config)#alarm profile PORT port
router(config-alarm-profile)#alarm ds1
router(config-alarm-properties)#DS1_LOS syslog
router(config-alarm-properties)#DS1_LOS severity major
Related Commands Command Description
alarm-profile nameattach Attaches alarm profile to chassis or card.
attach profile profile-name Attaches alarm profile to port.
show alarm-profile Displays alarm profile configured for chassis.
Cisco IOS Interface and Hardware Component Command Reference
8
A through B
alarm-profile attach
alarm-profile attach
To attach an alarm profile to chassis or card, use the alarm-profile name attach command in configuration
mode. To detach the alarm profile from chassis or card, use the no form of this command.
After attaching the alarm profile only, the alarm serverity and other alarm functionalities are applied to the
chassis, card, or port.
alarm-profile profile-name attach {chassis | card slot/bay}
Syntax Description Syntax Description
profile-name The name of the alarm profile.
chassis Specify to attach the alarm profile to chassis.
card slot/bay Specify to attach the alarm profile to card.
Command Default None
Command Modes Configuration mode
Command History Release Modification
Cisco IOS XE 16.8.1 Support for this command was introduced on ASR 900 Series.
Usage Guidelines This command is used to attach alarm profile to chassis or card in the configuration mode.
Examples The following example shows how to attach an alarm profile for chassis:
router>enable
router#configure terminal
router(config)#alarm-profile CHASSIS attach chassis
router(config)#end
Examples The following example shows how to attach an alarm profile to card:
router>enable
router#configure terminal
router(config)#alarm-profile CARD attach card 0/1
router(config)#end
Related Commands Command Description
alarm-profile profile-name Creates a new alarm profile for chassis, card or port.
show alarm-profile Displays alarm profile configured for chassis.
Cisco IOS Interface and Hardware Component Command Reference
9
A through B
alarm report all
alarm report all
To permit selected SONET alarms to be logged to the console for a SONET controller, use the alarm report
all command in SONET configuration mode. To disable logging of select SONET alarms, use the no form
of this command.
alarm-report all {b1-tca | lias | lrdi | pais | plop | pplm | pplm | prdi | sd-ber}
Syntax Description Syntax Description
b1-tca The name of a CEM interface parameters class.
lias Reports Line Alarm Indication signal (LAIS) errors.
lrdi Reports line remote defect indication errors.
pais Enables reporting of Path Alarm Indication Signal (PAIS).
plop Enables reporting of Path Loss Of Pointer (PLOP).
pplm Sets Path Payload Mismatch (PPLM) defect reporting status.
prdi Sets Path Remote Defect Indication (PRDI) reporting status.
sd-ber Enables Signal Degrade (SD) Bit Error Rate (BER) reporting.
Command Default None
Command Modes Controller configuration
Command History Release Modification
XE 3.18 Support for this command was introduced on NCS 4200 Series.
SP
Usage Guidelines This command is used to configure the alarm reports in SONET mode.
Examples The following example shows the configuration of alarm reports:
enable
configure terminal
controller MediaType 0/5/0
mode sonet
controller sonet 0/5/0
alarm report all b1-tcs
end
Related Commands Command Description
controller sonet Configures the SONET mode.
Cisco IOS Interface and Hardware Component Command Reference
10
A through B
alarm report all
Command Description
show controller sonet Displays SONET controller configuration.
Cisco IOS Interface and Hardware Component Command Reference
11
A through B
als
als
To enable the Automatic Laser Shutdown (ALS) mode, use the alscommand in interface configuration mode.
To disable ALS mode, use the no form of this command.
als
no als
Syntax Description This command has no arguments or keywords.
Command Default ALS is disabled.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SRD1 This command was introduced on the Cisco 7600 series router for the ES+ line cards.
Examples The following example shows how to enable ALS:
Router> enable
Router# configure terminal
Router(config)# interface tengigabitethernet 2/1
Router(config-if)# als
Related Commands Command Description
als restart Requests an ALS restart mode.
als restart mode Selects the ALS restart mode.
als restart pulse Select the ALS pulse mode.
hw-module als restart Requests a restart pulse.
show als Displays ALS status.
Cisco IOS Interface and Hardware Component Command Reference
12
A through B
als restart
als restart
To request an Automatic Laser Shutdown (ALS) restart mode, use the alsrestartcommand in interface
configuration mode. To disable an ALS restart mode, use the no form of this command.
als restart {mode|pulse}
no als restart {mode|pulse}
Syntax Description mode Specifies the ALS mode.
pulse Specifies the ALS pulse.
Command Default Command default is automatic.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SRD1 This command was introduced on the Cisco 7600 series router for the ES+ line cards.
Examples The following example restarts the ALS mode:
Router> enable
Router# configure terminal
Router(config)# interface tengigabitethernet 2/1
Router(config-if)# als
Router(config-if)# als restart mode
Related Commands Command Description
als Enables the ALS mode.
als restart mode Selects the ALS restart mode.
als restart pulse Selects the ALS pulse mode.
hw-module als restart Requests a restart pulse.
show als Displays ALS status.
Cisco IOS Interface and Hardware Component Command Reference
13
A through B
als restart mode
als restart mode
To select the Automatic Laser Shutdown (ALS) restart mode, use the alsrestartmodecommand in interface
configuration mode. To reset to the command default mode, use the no form of this command.
als restart mode {automatic|manual}
no als restart mode {automatic|manual}
Syntax Description automatic Selects automatic mode.
manual Selects manual mode.
Command Default Command default is automatic.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SRD1 This command was introduced on the Cisco 7600 series router for the ES+ line cards.
Usage Guidelines In manual restart, you request a single restart pulse from the ALS agent. In automatic restart, you configure
the ALS agent to send a periodic restart pulse.
Examples The following example shows how to select automatic mode:
Router> enable
Router# configure terminal
Router(config)# interface tengigabitethernet 2/1
Router(config-if)# als
Router(config-if)# als restart mode automatic
Related Commands Command Description
als Enables the ALS mode.
als restart Requests an ALS restart mode.
als restart pulse Select the ALS pulse mode.
hw-module als restart Requests a restart pulse.
show als Displays ALS status.
Cisco IOS Interface and Hardware Component Command Reference
14
A through B
als restart pulse
als restart pulse
To select the Automatic Laser Shutdown (ALS) pulse mode, use the alsrestartpulsecommand in inteface
configuration mode. To disable an ALS pulse mode, use the no form of this command.
als restart pulse {interval seconds|width seconds}
no als restart pulse {interval seconds|width seconds}
Syntax Description interval seconds Specifies the interval of the ALS pulse. The range is 100 to 20,000 seconds. Default is
300 seconds.
width seconds Specifies the width of the ALS pulse. The range is 2 to 200 seconds. Default is 200
seconds.
Command Default Pulse interval default is 300 seconds. Pulse width default is 200 seconds.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SRD1 This command was introduced on the Cisco 7600 series router for the ES+ line cards.
Usage Guidelines If a particular platform/OS/interface/controller has the capability to support two ranges, one range for Wave
Division Multiplexing (WDM) and another for non-WDM, use the following pulse width ranges:
• WDM: 60 - 200 (default: 100)
• Non-WDM: 2 - 100 (default: 4)
The recovery pulse interval is the period between the rising edge of pulses. The pulse interval needs to be
greater than the pulse width. If a particular platform/OS/interface/controller has the capability to support two
ranges, one range for WDM and another for non-WDM, use the following pulse width ranges:
• WDM: 200 - 20000 (default: 300)
• Non-WDM: 100 - 2000 (default: 100)
Examples The following example shows how to select an ALS pulse interval:
Router> enable
Router# configure terminal
Router(config)# interface tengigabitethernet 2/1
Router(config-if)# als
Router(config-if)# als restart mode
Router(config-if)# als restart mode automatic
Router(config-if)# als restart pulse interval 2000
The following example shows how to select an ALS pulse width:
Router> enable
Router# configure terminal
Cisco IOS Interface and Hardware Component Command Reference
15
A through B
als restart pulse
Router(config)# interface tengigabitethernet 2/1
Router(config-if)# als
Router(config-if)# als restart mode
Router(config-if)# als restart mode automatic
Router(config-if)# als restart pulse width 200
Related Commands Command Description
als Enables the ALS mode.
als restart Requests an ALS restart mode.
als restart mode Selects the ALS restart mode.
hw-module als restart Requests a restart pulse.
show als Displays ALS status.
Cisco IOS Interface and Hardware Component Command Reference
16
A through B
analysis-module monitoring
analysis-module monitoring
To enable Network Analysis Module (NAM) packet monitoring on an interface, use the
analysis-modulemonitoring command in interface configuration mode. To disable NAM packet monitoring,
use the no form of this command.
analysis-modulemonitoring
noanalysis-modulemonitoring
Syntax Description This command has no arguments or keywords.
Command Default NAM packet monitoring is disabled on the interface.
Command Modes Interface configuration
Command History Release Modification
12.3(4)XD This command was introduced on the following platforms: Cisco 2600XM series,
Cisco 2691, Cisco 3660, Cisco 3725, and Cisco 3745.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T.
12.3(8)T4 This command was implemented on the following platforms: Cisco 2811, Cisco
2821, Cisco 2851, and Cisco 3800 series.
12.3(11)T This command was implemented on the Cisco 3800 series.
Cisco IOS XE Fuji This command was implemented on the Cisco ISR 4000 Series Integrated Services
16.9.1 Routers.
Usage Guidelines When you enable NAM packet monitoring on an interface, Cisco Express Forwarding (CEF) sends an extra
copy of IP packet that is received or sent on that interface to the NAM through the analysis module and then
through the internal NM-NAM interface.
Note The traffic is sent through the internal NAM interface and through the the analysis module interface uses the
router's resources such as CPU, SDRAM bandwidth, and backplane Peripheral Component Interconnect (PCI)
bandwidth. Therefore, it is recommended to use the internal NAM interface to monitor WAN interfaces and
use the external NAM interface to monitor LAN interfaces.
In Cisco IOS XE Fuji 16.9.1, Encapsulated Remote Switched Port Analyzer (ERSPAN) supports the NAM
feature on Cisco 4000 Series ISRs. The Cisco ERSPAN feature allows you to monitor traffic on one or more
ports and then sends the monitored traffic to one or more destination ports.
To enhance the performance of NAM and simplify the configuration of NAM data port, ERSPAN sessions
are extended to a special souce session called NAM SPAN. NAM SPAN supports Layer 2 mode as local span
and monitors the interface on Layer 3 interface on Cisco 4000 Series ISRs.
Cisco IOS Interface and Hardware Component Command Reference
17
A through B
analysis-module monitoring
Note If an interface is monitored by NAM SPAN, it can not be configured as output interface. Each interface can
configure only one interface as output interface.
Examples The following example shows how to enable NAM packet monitoring on a serial interface:
Router(config)# interface serial 0/0
Router(config-if)# analysis-module monitoring
The following example shows how to enable NAM packet monitoring on a serial interface of a Cisco
4000 Series ISRs:
Router(config)# interface serial 0/0
Router(config-if)# analysis-module monitoring ucse0/0/0
Note The output interface is ucse0/0/0 which is configured as NAM/vNAM data port and the source
interface is serial 0/0 in this example.
Cisco IOS Interface and Hardware Component Command Reference
18
A through B
announce interval
announce interval
To set an interval value for timing announcement packets, use the announceinterval command in Precision
Time Protocol clock port mode. To remove an announcement interval configuration, use the no form of this
command.
announce interval interval-value
no announce interval interval-value
Syntax Description interval-value Specifies the interval for announce messages. The intervals use log base 2 values, as follows:
• 4--1 packet every 16 seconds
• 3--1 packet every 8 seconds
• 2--1 packet every 4 seconds
• 1--1 packet every 2 seconds
• 0--1 packet every second
Command Default For the IE 3000 switch, the default value is 1. For the MWR 2941 router, the default value is 2.
Command Modes PTP clock port configuration (config-ptp-port)
Command History Release Modification
15.0(1)S This command was introduced.
Usage Guidelines The interval value defined by this command impacts the timeout value defined by the announcetimeout
command.
Examples The following example shows how to configure an announcement interval:
Router# configure terminal
Router(config)# ptp clock ordinary domain 0
Router(config-ptp-clk)# clock-port slave slaveport
Router(config-ptp-port)# announce interval 3
Router(config-ptp-port)# end
Related Commands Command Description
announce timeout Sets the timeout value for timing announcement packets.
Cisco IOS Interface and Hardware Component Command Reference
19
A through B
announce timeout
announce timeout
To set a timeout value for timing announcement packets, use the announcetimeout command in Precision
Time Protocol clock port mode. To remove an announcement timeout configuration, use the no form of this
command.
announce timeout timeout-value
no announce timeout timeout-value
Syntax Description timeout-value Specifies the number of announcement intervals before the session times out. The range is
from 1 to 10. The default is 3.
Command Default The default timeout value is 3.
Command Modes PTP clock port configuration (config-ptp-port)
Command History Release Modification
15.0(1)S This command was introduced.
Usage Guidelines This command configures the number of announcement intervals before the session times out. To define the
length of the announcement intervals, use the announceinterval command.
Examples The following example shows how to configure an announcementtimeout:
Device> enable
Device# configure terminal
Device(config)# ptp clock ordinary domain 0
Device(config-ptp-clk)# clock-port slave slaveport
Device(config-ptp-port)# announce timeout 7
Device(config-ptp-port)# end
Related Commands Command Description
announce interval Sets interval value for timing announcement packets.
Cisco IOS Interface and Hardware Component Command Reference
20
A through B
anti-jam
anti-jam
To configure the anti-jam mode for the GNSS module on the Cisco ASR 903, Cisco ASR 907, and the Cisco
ASR 920 routers, use the anti-jam command in gnss mode.
anti-jam disable
Syntax Description disable Disables the anti-jam mode.
Command Default Anti-jam is enabled on the GNSS module by default.
Command Modes GNSS configuration (config-gnss)
Command History Release Modification
IOS-XE 3.17 This command was introduced on the Cisco ASR 903, Cisco ASR 907, and the Cisco ASR
920 routers.
Examples The following example shows how to disable the anti-jam mode on the GNSS module:
Router# configure terminal
Router(config)# gnss slot r0
Router(config-gnss)# anti-jam disable
Related Commands Command Description
gnss Configures the GNSS on the router.
1pps Configures the pulse per second from the GNSS module.
constellation Configures the GNSS module based on the specified satellite constellations.
default Resets the device to its default state.
exit Exists the GNSS sub mode.
Cisco IOS Interface and Hardware Component Command Reference
21
A through B
apply (satellite initial configuration)
apply (satellite initial configuration)
To save new or changed satellite initial configuration parameters and to reset the Cisco IP VSAT satellite
WAN network module (NM-1VSAT-GILAT), use the apply command in satellite initial configuration mode.
apply
Syntax Description This command has no arguments or keywords.
Command Default No default behavior or values
Command Modes Satellite initial configuration mode
Command History Release Modification
12.3(14)T This command was introduced.
Usage Guidelines The apply command saves any new or changed satellite initial configuration parameters to the nonvolatile
memory of the Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT) and initiates a network
module software reset. Commands entered in satellite initial configuration mode do not appear in the router
configuration.
When you enter the exit or end command to exit satellite initial configuration mode, the system automatically
saves any changed parameters to the NM-1VSAT-GILAT network module’s nonvolatile memory and resets
the NM-1VSAT-GILAT network module.
Note This command is typically used by an installation technician. Do not use this command unless your satellite
service provider instructs you to perform the satellite initial configuration and provides all necessary parameter
values.
Examples The following example shows what appears when you enter the apply command after changing some
initial configuration parameters:
Router(sat-init-config)# apply
Applying changed parameters to the satellite module.
Parameter update succeeded. Module is now resetting.
Router(sat-init-config)#
The following example shows what appears when you enter the apply command when no parameters
have been changed:
Router(sat-init-config)# apply
% No new or changed parameters to apply.
Router(sat-init-config)#
Cisco IOS Interface and Hardware Component Command Reference
22
A through B
apply (satellite initial configuration)
Related Commands Command Description
end (satellite initial configuration) Exits satellite initial configuration mode, saves any new or changed
parameters, and resets the Cisco IP VSAT satellite WAN network
module (NM-1VSAT-GILAT).
exit (satellite initial configuration) Exits satellite initial configuration mode, saves any new or changed
parameters, and resets the Cisco IP VSAT satellite WAN network
module (NM-1VSAT-GILAT).
Cisco IOS Interface and Hardware Component Command Reference
23
A through B
aps authenticate
aps authenticate
To enable authentication and specify the string that must be present to accept any packet on the out-of-band
(OOB) communications channel on a Packet-over-SONET (POS) interface, use the apsauthenticate command
in interface configuration mode. To disable authentication, use the no form of this command.
aps authenticate string
no aps authenticate
Syntax Description string Text that must be present to accept the packet on a protected or working interface. A maximum of
eight alphanumeric characters are accepted.
Command Default Authentication is disabled.
Command Modes Interface configuration
Command History Release Modification
11.1CC This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use the apsauthenticatecommand to ensure that only valid packets are accepted on the OOB communications
channel.
The apsauthenticate command must be configured on both the working and protect interfaces.
Examples The following example shows how to enable authentication on POS interface 0 in slot 4:
Router# configure terminal
Router(config)# interface pos 4/0/0
Router(config-if)# aps working 1
Router(config-if)# aps authenticate sanjose
Router(config-if)# end
Related Commands Command Description
aps protect Enables a POS interface as a protect interface.
aps working Configures a POS interface as a working interface.
Cisco IOS Interface and Hardware Component Command Reference
24
A through B
aps adm
aps adm
Use this command to configure unidirectional ACR (SONET Framing).
aps adm slot / bay / port
Syntax Description Syntax Description
There are no keywords for this command.
Command Default None
Command Modes Controller configuration
Command History Release Modification
XE 3.18 SP Support for this command was introduced on NCS 4200 Series.
Usage Guidelines The command is used to enable Add Drop Multiplexer (ADM) with unidirectional APS protection.
Examples The following example shows how to configure unidirectional ACR (SONET Framing):
enable
configure terminal
controller MediaType 0/5/0
mode sonet
controller sonet 0/5/0
clock source internal
aps group acr 1
aps working 1
aps unidirectional
aps adm
exit
controller sonet 0/5/0
aps group acr 1
aps protect 1 10.7.7.7
aps revert 3
end
Related Commands Command Description
controller sonet Configures the SONET mode.
show controller sonet Displays SONET controller configuration.
Cisco IOS Interface and Hardware Component Command Reference
25
A through B
aps clear sonet
aps clear sonet
To remove all externally initiated SONET automatic protection switching (APS) commands configured on a
Cisco AS5850, use the apsclearsonetcommand in privileged EXEC mode.
aps clear sonet slot/port
Syntax Description slot Slot number on an STM-1 trunk card.
/ port SONET port number on an STM-1 trunk card. The slash mark is required between the slot argument
and the port argument.
Command Default No APS switch commands are removed.
Command Modes Privileged EXEC
Command History Release Modification
12.3(11)T This command was introduced on the Cisco AS5850.
Usage Guidelines Use the apsclearsonetcommand to remove any SONET APS commands, such as the apsforcesonetcommand,
that could switch the working fiber to the protect fiber on an STM-1 trunk card.
This command applies to the Cisco AS5850 universal gateway only.
Examples The following example shows how to remove all externally initiated SONET APS switch commands:
Router# aps clear sonet 1/0
Related Commands Command Description
aps force sonet Requests an APS forced switch of a specified port to the alternate port unless a
request of equal or higher priority is in effect.
aps lockout sonet Prevents a working SONET port from switching to a protect SONET port unless
a request of equal or higher priority is in effect.
aps manual sonet Requests a manual APS switch on a SONET port.
aps protect (SONET) Enables SONET APS.
Cisco IOS Interface and Hardware Component Command Reference
26
A through B
aps force
aps force
To manually switch the specified circuit to a protect interface, unless a request of equal or higher priority is
in effect, use the apsforcecommand in interface configuration mode. To cancel the switch, use the no form
of this command.
aps force circuit-number
no aps force circuit-number
Syntax Description circuit-number Number of the circuit to switch to the protect interface.
Command Default No circuit is switched.
Command Modes Interface configuration
Command History Release Modification
11.1CC This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use the apsforcecommand to manually switch the interface to a protect interface when you are not using the
apsrevertcommand. For example, if you need to change the fiber connection, you can manually force the
working interface to switch to the protect interface.
In a one-plus-one (1+1) configuration only, you can use the apsforce0 command to force traffic from the
protect interface back onto the working interface.
Theapsforce command has a higher priority than any of the signal failures or the apsmanual command.
The apsforce command is configured only on protect interfaces.
Examples The following example shows how to force the circuit on POS interface 0 in slot 3 (a protect interface)
back onto a working interface:
Router# configure terminal
Router(config)# interface pos 3/0/0
Router(config-if)# aps protect 10/30/1/1
Router(config-if)# aps force 1
Router(config-if)# end
Related Commands Command Description
aps manual Manually switches a circuit to a protect interface.
aps protect Enables a POS interface as a protect interface.
Cisco IOS Interface and Hardware Component Command Reference
27
A through B
aps force
Command Description
aps working Configures a POS interface as a working interface.
Cisco IOS Interface and Hardware Component Command Reference
28
A through B
aps force sonet
aps force sonet
To force a specified port to switch to the alternate port within a redundant pair unless a request of equal or
higher priority is in effect, use the apsforcesonetcommand in privileged EXEC mode.
aps force sonet slot/port from {protection|working}
Syntax Description slot Slot number on an STM-1 trunk card.
/ port SONET port number on an STM-1 trunk card. The slash mark is required between the
slot argument and the port argument.
from protection Specifies that you want to switch from the protect port to the working port.
from working Specifies that you want to switch from the working port to the protect port.
Command Default No port is switched.
Command Modes Privileged EXEC
Command History Release Modification
12.3(11)T This command was introduced on the Cisco AS5850.
Usage Guidelines Forced is a defined APS request priority level. The request succeeds if no higher priority request (lockout is
the only higher priority request) is posted. The apsforcesonetcommand does not persist after a system restart.
The slot and port arguments indicate the SONET interface on which you want to issue the apsforcesonet
command. Theapsforcesonet command has a higher priority than any of the signal failures or the
apsmanualsonet command.
For more information about APS priority requests, see the ITU-T G.841 standard.
This command applies to the Cisco AS5850 universal gateway only.
Examples The following example shows how to force the protect port in the SONET controller to become an
active port:
Router# configure terminal
Router(config)# controller sonet 1/0
Router(config-controller)# aps protect
Router(config-controller)# end
Router# aps force sonet 1/0 from working
Related Commands Command Description
aps clear sonet Removes any APS switch commands configured using CLI.
aps lockout sonet Prevents a working SONET port from switching to a protect SONET port unless
a request of equal or higher priority is in effect.
Cisco IOS Interface and Hardware Component Command Reference
29
A through B
aps force sonet
Command Description
aps manual sonet Requests a manual APS switch on a SONET port.
aps protect (SONET) Enables SONET APS.
Cisco IOS Interface and Hardware Component Command Reference
30
A through B
aps group
aps group
To allow more than one protect and working interface and Access Circuit Redundancy (ACR) group to be
supported on a router, use the aps group command in interface configuration or controller configuration
mode. To remove a group, use the no form of this command.
aps group [acr] group-number
no aps group [acr] group-number
Syntax Description acr (Optional) Specifies an ACR group.
group-number Number of the group. The default is 0.
Command Default No groups exist.
Note 0 is a valid group number.
Command Modes
Interface configuration (config-if)
Controller configuration (config-controller)
Command History Release Modification
11.1CC This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
15.1(1)S This command was modified. The acr keyword was added.
Usage Guidelines Use the aps groupcommand to specify more than one working and protect interface on a router--for example,
working channel for group 0 and protect channel for group 1 on one router, and working channel for group
1 and protect channel for group 0 on another router.
The default group number is 0. The aps group 0 command does not imply that no groups exist.
The aps group command must be configured on both the protect and working interfaces.
Use the acrkeyword to configure an ACR working or protect interface.
Examples The following example shows how to configure two working/protect interface pairs. Working interface
(3/0/0) is configured in group 10 (the protect interface for this working interface is configured on
another router), and protect interface (2/0/1) is configured in group 20.
Router# configure terminal
Router(config)# interface ethernet 0/0
Cisco IOS Interface and Hardware Component Command Reference
31
A through B
aps group
Router(config-if)# ip address 10.7.7.6 255.255.255.0
Router(config-if)# exit
Router(config)# interface pos 3/0/0
Router(config-if)# aps group 10
Router(config-if)# aps working 1
Router(config-if)# exit
Router(config)# interface pos 2/0/1
Router(config-if)# aps group 20
Router(config-if)# aps protect 1 10.7.7.7
Router(config-if)# end
On the second router, protect interface (4/0/0) is configured in group 10, and working interface (5/0/0)
is configured in group 20 (the protect interface for this working interface is configured on another
router).
Router(config)# interface ethernet 0/0
Router(config-if)# ip address 10.7.7.7 255.255.255.0
Router(config-if)# exit
Router(config)# interface pos 4/0/0
Router(config-if)# aps group 10
Router(config-if)# aps protect 1 10.7.7.6
Router(config-if)# exit
Router(config)# interface pos 5/0/0
Router(config-if)# aps group 20
Router(config-if)# aps working 1
Router(config-if)# end
Related Commands Command Description
aps protect Enables a POS interface as a protect interface.
aps working Configures a POS interface as a working interface.
Cisco IOS Interface and Hardware Component Command Reference
32
A through B
aps hspw-icrm-grp
aps hspw-icrm-grp
To associate an Automatic Protection Switching (APS) group to an Interchassis Redundancy Manager (ICRM)
group number, use the aps hspw-icrm-grp command in controller configuration mode. To remove the
association, use the no form of this command.
aps hspw-icrm-grp group-number
no aps hspw-icrm-grp group-number
Syntax Description group-number ICRM group number. Valid values are from 1 to 4294967295.
Command Default Interface connections do not switch from one circuit to another if a circuit fails.
Command Modes Controller configuration (config-controller)
Command History Release Modification
Cisco IOS 15.2(1)S This command was introduced.
Cisco IOS XE 3.11S This command was integrated into Cisco IOS XE Release 3.11S.
Usage Guidelines Use the aps hspw-icrm-grp command to protect SONET networks by enabling SONET connections to switch
to another SONET circuit when a circuit failure occurs.
A protect interface serves as the backup interface for the working interface. When the working interface fails,
the protect interface quickly assumes the former's traffic load.
Examples The following example shows how to configure the Multi Router Automatic Protection Switching
(MR-APS) integration with HSPW on a Circuit Emulation (CEM) interface on the working router
with framing mode as SONET on router P1:
RouterP1> enable
RouterP1# configure terminal
RouterP1(config)# pseudowire-class hspw_aps
RouterP1(config-pw-class)# encapsulation mpls
RouterP1(config-pw-class)# status peer topology dual-homed
RouterP1(config-pw-class)# exit
RouterP1(config)# redundancy
RouterP1(config-red)# interchassis group 1
RouterP1(config-r-ic)# member ip 10.2.0.2
RouterP1(config-r-ic)# backbone interface GigabitEthernet 0/1/0
RouterP1(config-r-ic)# backbone interface GigabitEthernet 0/1/1
RouterP1(config-r-ic)# exit
RouterP1(config)# controller SONET 0/1/0
RouterP1(config-controller)# framing sonet
RouterP1(config-controller)# clock source line
RouterP1(config-controller)# sts-1 1
RouterP1(config-ctrlr-sts1)# mode vt-15
RouterP1(config-ctrlr-sts1)# vtg 1 t1 1 cem-group 0 timeslots 1-24
RouterP1(config-ctrlr-sts1)# exit
RouterP1(config-controller)# aps group 3
RouterP1(config-controller)# aps working 1
Cisco IOS Interface and Hardware Component Command Reference
33
A through B
aps hspw-icrm-grp
RouterP1(config-controller)# aps hspw-icrm-grp 1
RouterP1(config-controller)# exit
RouterP1(config)# interface cem 0/1/0
RouterP1(config-if)# cem 0
RouterP1(config-if)# xconnect 3.3.3.3 1 encapsulation mpls pw-class hspw_aps
RouterP1(config-if)# backup peer 4.4.4.4 2 pw-class hspw_aps
RouterP1(config-if)# exit
RouterP1(config)# end
Examples The following example shows how to configure the MR-APS integration with hot standby pseudowire
(HSPW) on a CEM interface on the protect router with framing mode as SONET on router PE1:
RouterPE1> enable
RouterPE1# configure terminal
RouterPE1(config)# pseudowire-class hspw_aps
RouterPE1(config-pw-class)# encapsulation mpls
RouterPE1(config-pw-class)# status peer topology dual-homed
RouterPE1(config-pw-class)# exit
RouterPE1(config)# redundancy
RouterPE1(config-red)# interchassis group 1
RouterPE1(config-r-ic)# member ip 10.2.0.1
RouterPE1(config-r-ic)# backbone interface GigabitEthernet 0/1/0
RouterPE1(config-r-ic)# backbone interface GigabitEthernet 0/1/1
RouterPE1(config-r-ic)# exit
RouterPE1(config)# controller SONET 0/2/0
RouterPE1(config-controller)# framing sonet
RouterPE1(config-controller)# clock source line
RouterPE1(config-controller)# sts-1 1
RouterPE1(config-ctrlr-sts1)# mode vt-15
RouterPE1(config-ctrlr-sts1)# vtg 1 t1 1 cem-group 0 timeslots 1-24
RouterPE1(config-ctrlr-sts1)# exit
RouterPE1(config-controller)# aps group 3
RouterPE1(config-controller)# aps protect 1 10.2.0.1
RouterPE1(config-controller)# aps hspw-icrm-grp 1
RouterPE1(config-controller)# exit
RouterPE1(config)# interface cem 0/2/0
RouterPE1(config-if)# cem 0
RouterPE1(config-if)# xconnect 3.3.3.3 3 pw-class hspw_aps
RouterPE1(config-if)# backup peer 4.4.4.4 4 pw-class hspw_aps
RouterPE1(config-if)# exit
RouterPE1(config)# end
Examples The following example shows how to configure the MR-APS integration with HSPW on a CEM
interface on the working router with framing mode as SONET on router P2:
RouterP2> enable
RouterP2# configure terminal
RouterP2(config)# pseudowire-class hspw_aps
RouterP2(config-pw-class)# encapsulation mpls
RouterP2(config-pw-class)# status peer topology dual-homed
RouterP2(config-pw-class)# exit
RouterP2(config)# redundancy
RouterP2(config-red)# interchassis group 1
RouterP2(config-r-ic)# member ip 10.6.0.2
RouterP2(config-r-ic)# backbone interface GigabitEthernet 0/2/0
RouterP2(config-r-ic)# backbone interface GigabitEthernet 0/2/1
RouterP2(config-r-ic)# exit
RouterP2(config)# controller SONET 0/1/0
RouterP2(config-controller)# framing sonet
Cisco IOS Interface and Hardware Component Command Reference
34
A through B
aps hspw-icrm-grp
RouterP2(config-controller)# clock source line
RouterP2(config-controller)# sts-1 1
RouterP2(config-ctrlr-sts1)# mode vt-15
RouterP2(config-ctrlr-sts1)# vtg 1 t1 1 cem-group 0 timeslots 1-24
RouterP2(config-ctrlr-sts1)# exit
RouterP2(config-controller)# aps group 3
RouterP2(config-controller)# aps working 1
RouterP2(config-controller)# aps hspw-icrm-grp 1
RouterP2(config-controller)# exit
RouterP2(config)# interface cem 0/1/0
RouterP2(config-if)# cem 0
RouterP2(config-if)# xconnect 1.1.1.1 1 encapsulation mpls pw-class hspw_aps
RouterP2(config-if)# backup peer 2.2.2.2 3 pw-class hspw_aps
RouterP2(config-if)# exit
RouterP2(config)# end
Examples The following example shows how to configure the MR-APS Integration with HSPW on a CEM
interface on the protect router with framing mode as SONET on router PE2:
RouterPE2> enable
RouterPE2# configure terminal
RouterPE2(config)# pseudowire-class hspw_aps
RouterPE2(config-pw-class)# encapsulation mpls
RouterPE2(config-pw-class)# status peer topology dual-homed
RouterPE2(config-pw-class)# exit
RouterPE2(config)# redundancy
RouterPE2(config-red)# interchassis group 1
RouterPE2(config-r-ic)# member ip 10.6.0.1
RouterPE2(config-r-ic)# backbone interface GigabitEthernet 0/2/0
RouterPE2(config-r-ic)# backbone interface GigabitEthernet 0/2/1
RouterPE2(config-r-ic)# exit
RouterPE2(config)# controller SONET 0/2/0
RouterPE2(config-controller)# framing sonet
RouterPE2(config-controller)# clock source line
RouterPE2(config-controller)# sts-1 1
RouterPE2(config-ctrlr-sts1)# mode vt-15
RouterPE2(config-ctrlr-sts1)# vtg 1 t1 1 cem-group 0 timeslots 1-24
RouterPE2(config-ctrlr-sts1)# exit
RouterPE2(config-controller)# aps group 2
RouterPE2(config-controller)# aps protect 1 10.6.0.1
RouterPE2(config-controller)# aps hspw-icrm-grp 1
RouterPE2(config-controller)# exit
RouterPE2(config)# interface cem 0/2/0
RouterPE2(config-if)# cem 0
RouterPE2(config-if)# xconnect 1.1.1.1 2 pw-class hspw_aps
RouterPE2(config-if)# backup peer 2.2.2.2 4 pw-class hspw_aps
RouterPE2(config-if)# exit
Related Commands Command Description
aps protect Configures a POS interface as a protect interface.
aps working Configures a POS interface as a working interface.
Cisco IOS Interface and Hardware Component Command Reference
35
A through B
aps lockout
aps lockout
To prevent a working interface from switching to a protect interface, use the apslockout command in interface
configuration mode. To remove the lockout, use the no form of this command.
aps lockout circuit-number
no aps lockout circuit-number
Syntax Description circuit-number Number of the circuit to lock out.
Command Default No lockout exists.
Command Modes Interface configuration
Command History Release Modification
11.1CC This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The apslockout command is configured only on protect interfaces.
Examples The following example shows how to lock out POS interface 3/0/0 (that is, prevents the circuit from
switching to a protect interface if the working circuit becomes unavailable):
Router# configure terminal
Router(config)# interface pos 3/0/0
Router(config-if)# aps protect 1 10.7.7.7
Router(config-if)# aps lockout 1
Router(config-if)# end
Related Commands Command Description
aps protect Enables a POS interface as a protect interface.
aps working Configures a POS interface as a working interface.
Cisco IOS Interface and Hardware Component Command Reference
36
A through B
aps lockout sonet
aps lockout sonet
To prevent a working port from switching to a protect port unless a request of equal or higher priority is in
effect, use the apslockoutsonet command in privileged EXEC mode.
aps lockout sonet slot/port
Syntax Description slot Slot number on an STM-1 trunk card.
/ port SONET port number on an STM-1 trunk card. The slash mark is required between the slot argument
and the port argument.
Command Default No lockout exists; that is, a working port is not prevented from switching to a protect port.
Command Modes Privileged EXEC
Command History Release Modification
12.3(11)T This command was introduced on the Cisco AS5850.
Usage Guidelines Lockout is defined as the highest APS request priority level.
The apslockoutsonetcommand does not persist after a system restart. The slot and port arguments indicate
the SONET interface from which the protect port is to be locked out. When the specified port is locked out,
SONET APS switching from the working port is not allowed.
For more information about APS priority requests, see the ITU-T G.841 standard.
This command applies to the Cisco AS5850 universal gateway only.
Examples The following example shows how to lock out SONET port 1/0 (prevents SONET APS switching
to a protect interface if the working circuit becomes unavailable):
Router# configure terminal
Router(config)# controller sonet 1/0
Router(config-controller)# aps protect
Router(config-controller)# end
Router# aps lockout sonet 1/0
Related Commands Command Description
aps clear sonet Removes any APS switch commands configured using CLI.
aps force sonet Requests an APS forced switch of a specified port to the alternate port unless a
request of equal or higher priority is in effect.
aps manual sonet Requests a manual APS switch on a SONET port.
aps protect (SONET) Enables SONET APS.
Cisco IOS Interface and Hardware Component Command Reference
37
A through B
aps manual
aps manual
To manually switch a circuit to a protect interface, use the aps manual command in interface configuration
mode. To cancel the switch, use the no form of this command.
aps manual circuit-number
no aps manual circuit-number
Syntax Description circuit-number Number of the circuit to switch to a protect interface.
Command Default No circuit is switched.
Command Modes Interface configuration
Command History Release Modification
11.1CC This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use the aps manual command to manually switch the interface to a protect interface. For example, you can
use this feature when you need to perform maintenance on the working channel. If a protection switch is
already up, you can also use the aps manual command to revert the communication link back to the working
interface before the wait to restore (WTR) time has expired. The WTR time period is set by the aps revert
command.
In a one-plus-one (1+1) configuration only, you can use the aps manual 0 command to force traffic from the
protect interface back onto the working interface.
Theaps manual command is a lower priority than any of the signal failures or theaps force command.
Examples The following example shows how to force the circuit on POS interface 0 in slot 3 (a working
interface) back onto the protect interface:
Router# configure terminal
Router(config)# interface pos 3/0/0
Router(config-if)# aps working 1
Router(config-if)# aps manual 1
Router(config-if)# end
Related Commands Command Description
aps force Manually switches the specified circuit to a protect interface, unless a request of equal or
higher priority is in effect.
aps protect Enables a POS interface as a protect interface.
Cisco IOS Interface and Hardware Component Command Reference
38
A through B
aps manual
Command Description
aps revert Enables automatic switchover from the protect interface to the working interface after the
working interface becomes available.
aps working Configures a POS interface as a working interface.
Cisco IOS Interface and Hardware Component Command Reference
39
A through B
aps manual sonet
aps manual sonet
To manually switch to the alternate port within a redundant pair unless a request of equal or higher priority
is in effect, use the apsmanualsonet command in privileged EXEC mode.
aps manual sonet slot/port from {protection|working}
Syntax Description slot Slot number on an STM-1 trunk card.
/ port SONET port number on an STM-1 trunk card. The slash mark is required between the
slot argument and the port argument.
from protection Specifies that you want to switch from the protect port to the working port.
from working Specifies that you want to switch from the working port to the protect port.
Command Default No port is switched.
Command Modes Privileged EXEC
Command History Release Modification
12.3(11)T This command was introduced on the Cisco AS5850.
Usage Guidelines Use the apsmanualsonetcommand to manually switch the active port to the alternate port. For example, you
can use this command when you need to perform maintenance on the working port.
Manual is a defined APS request priority level. The request succeeds if no higher priority request is posted.
The apsmanualsonetcommand does not persist after a system restart. The slot and port arguments indicate
the SONET interface on which you want to issue the apsmanualsonet command. Theapsmanualsonet
command has a lower priority than any of the signal failures or the apsforcesonetcommand.
For more information about APS priority requests, see the ITU-T G.841 standard.
This command applies to the Cisco AS5850 universal gateway only.
Examples The following example shows how to manually switch the working port, SONET port 1/0, to the
protect port:
Router# configure terminal
Router(config)# controller sonet 1/0
Router(config-controller)# aps protect
Router(config-controller)# end
Router# aps manual sonet 1/0 from working
Related Commands Command Description
aps clear sonet Removes any APS switch commands configured using CLI.
Cisco IOS Interface and Hardware Component Command Reference
40
A through B
aps manual sonet
Command Description
aps force sonet Requests an APS forced switch of a specified port to the alternate port unless a
request of equal or higher priority is in effect.
aps lockout sonet Prevents a working SONET port from switching to a protect SONET port unless
a request of equal or higher priority is in effect.
aps protect (SONET) Enables SONET APS.
Cisco IOS Interface and Hardware Component Command Reference
41
A through B
aps protect
aps protect
To enable a POS interface as a protect interface, use the apsprotectcommand in interface configuration mode.
To remove the POS interface as a protect interface, use the no form of this command.
aps protect circuit-number ip-address
no aps protect circuit-number ip-address
Syntax Description circuit-number Number of the circuit to enable as a protect interface.
ip-address IP address of the router that has the working POS interface.
Command Default No circuit is protected.
Command Modes Interface configuration
Command History Release Modification
11.1CC This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use the apsprotectcommand to configure the POS interface used by a working interface if the working
interface becomes unavailable because of a router failure, degradation or loss of channel signal, or manual
intervention.
Caution Configure the working interface before configuring the protect interface to keep the protect interface from
becoming the active circuit and disabling the working circuit when it is finally discovered.
Examples The following example shows how to configure circuit 1 on POS interface 5/0/0 as a protect interface
for the working interface on the router with the IP address of 10.7.7.7. For information on how to
configure the working interface, refer to the apsworking command.
Router# configure terminal
Router(config)# interface pos 5/0/0
Router(config-if)# aps protect 1 10.7.7.7
Router(config-if)# end
Related Commands Command Description
aps working Configures a POS interface as a working interface.
Cisco IOS Interface and Hardware Component Command Reference
42
A through B
aps protect (SONET)
aps protect (SONET)
To enable automatic protection switching (APS) on a SONET port in an STM-1 trunk card, use the
apsprotectcommand in controller configuration mode. To disable APS on the SONET port, use the no form
of this command.
aps protect
no aps protect
Syntax Description This command has no arguments or keywords.
Command Default APS is disabled.
Command Modes Controller configuration
Command History Release Modification
12.3(11)T This command was introduced on the Cisco AS5850.
Usage Guidelines Use the apsprotectcommand to enable APS on a protect SONET port as a working port if the working port
becomes unavailable because of a fiber failure, degradation or loss of channel signal, or manual intervention.
Examples The following example shows how to enable APS on SONET port 0/1 in an STM-1 trunk card.
Router# configure terminal
Router(config)# controller sonet 1/0
Router(config-controller)# aps protect
Router(config-controller)# end
Related Commands Command Description
aps unidirectional Configures a protect SONET port for unidirectional mode.
show controllers sonet Displays information about SONET controllers.
Cisco IOS Interface and Hardware Component Command Reference
43
A through B
aps revert
aps revert
To enable automatic switchover from the protect interface to the working interface after the working interface
becomes available, use the apsrevertcommand in interface configuration mode. To disable automatic
switchover, use the no form of this command.
aps revert minutes
no aps revert
Syntax Description minutes Number of minutes until the circuit is switched back to the working interface after the working
interface is available.
Command Default Automatic switchover is disabled.
Command Modes Interface configuration
Command History Release Modification
11.1CC This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use the apsrevertcommand to return the circuit to the working interface when it becomes available.
The apsrevert command is configured only on protect interfaces.
Examples The following example shows how to enable circuit 1 on POS interface 5/0/0 to revert to the working
interface after the working interface has been available for 3 minutes:
Router# configure terminal
Router(config)# interface pos 5/0/0
Router(config-if)# aps protect 1 10.7.7.7
Router(config-if)# aps revert 3
Router(config-if)# end
Related Commands Command Description
aps protect Enables a POS interface as a protect interface.
Cisco IOS Interface and Hardware Component Command Reference
44
A through B
aps timers
aps timers
To change the time between hello packets and the time before the protect interface process declares a working
interface router to be down, use the apstimerscommand in interface configuration mode. To return to the
default timers, use the no form of this command.
aps timers seconds1 seconds2
no aps timers
Syntax Description seconds1 Number of seconds to wait before sending a hello packet (hello timer). Default is 1.
seconds2 Number of seconds to wait to receive a response from a hello packet before the interface is
declared down (hold timer). Default is 3.
Command Default Hello time is 1 second Hold time is 3 seconds.
Command Modes Interface configuration
Command History Release Modification
11.1CC This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use the apstimerscommand to control the time between an automatic switchover from the protect interface
to the working interface after the working interface becomes available.
Normally, the hold time is greater than or equal to three times the hello time.
The apstimers command is configured only on protect interfaces.
Examples The following example shows how to specify a hello time of 2 seconds and a hold time of 6 seconds
on circuit 1 on POS interface 5/0/0:
Router# configure terminal
Router(config)# interface pos 5/0/0
Router(config-if)# aps working 1
Router(config-if)# aps timers 2 6
Router(config-if)# end
Cisco IOS Interface and Hardware Component Command Reference
45
A through B
aps unidirectional
aps unidirectional
To configure a protect interface for unidirectional mode, use the apsunidirectional command in controller
configuration or interface configuration mode. To return to the default, bidirectional mode, use the no form
of this command.
aps unidirectional
no aps unidirectional
Syntax Description This command has no arguments or keywords.
Command Default Bidirectional mode
Command Modes Controller configuration Interface configuration
Command History Release Modification
11.1CC This command was introduced.
12.3(11)T Support for SONET APS using an STM-1 card was added on the Cisco AS5850.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The apsunidirectionalcommand is configured only on protect interfaces.
Use the apsunidirectionalcommand when you must interoperate with SONET network equipment, add/drop
multiplexors (ADMs) that supports unidirectional mode.
Note We recommend bidirectional mode when it is supported by the interconnecting SONET equipment. When
the protect interface is configured as bidirectional, the working and protect interfaces must cooperate to switch
the transmit and receive SONET channel in a bidirectional fashion. This happens automatically when the
SONET network equipment is in bidirectional mode.
Examples The following example shows how to configure POS interface 3/0/0 for unidirectional mode on a
Cisco 12000 series router:
Router# configure terminal
Router(config)# interface pos 3/0/0
Router(config-if)# aps unidirectional
Router(config-if)# aps protect 1 10.7.7.7
Router(config-if)# end
The following example shows how to configure SONET port 0/0 for unidirectional mode on a Cisco
AS5850 universal gateway using an STM-1 trunk card:
Cisco IOS Interface and Hardware Component Command Reference
46
A through B
aps unidirectional
Router# configure terminal
Router(config)# controller sonet 0/0
Router(config-controller)# aps protect
Router(config-controller)# aps unidirectional
Router(config-controller)# end
Cisco IOS Interface and Hardware Component Command Reference
47
A through B
aps working
aps working
To configure a Packet over SONET (POS) interface as a working interface, use the apsworking command
in interface configuration mode. To remove the protect option from the POS interface, use the no form of this
command.
aps working circuit-number
no aps working circuit-number
Syntax Description circuit-number Circuit number associated with this working interface.
Command Default No circuit is configured as working.
Command Modes Interface configuration
Command History Release Modification
11.1CC This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines When a working interface becomes unavailable because of a router failure, degradation or loss of channel
signal, or manual intervention, the circuit is switched to the protect interface to maintain the connection.
To enable the circuit on the protect interface to switch back to the working interface after the working interface
becomes available again, use the apsrevert command in interface configuration mode.
Caution Configure the working interface before configuring the protect interface to keep the protect interface from
becoming the active circuit and disabling the working circuit when it is finally discovered.
Examples The following example shows how to configure POS interface 0 in slot 4 as a working interface. For
information on how to configure the protect interface, refer to the apsprotect command.
Router# configure terminal
Router(config)# interface pos 4/0/0
Router(config-if)# aps working 1
Router(config-if)# end
Related Commands Command Description
aps protect Enables a POS interface as a protect interface.
Cisco IOS Interface and Hardware Component Command Reference
48
A through B
aps working
Command Description
aps revert Enables automatic switchover from the protect interface to the working interface after the
working interface becomes available.
Cisco IOS Interface and Hardware Component Command Reference
49
A through B
associate slot
associate slot
To logically associate slots for automatic protection switching (APS) processor redundancy, use the associate
slot command in redundancy configuration mode. To disable slot associations, use the no form of this command.
Single Router APS--Cisco 10000 Series Routers and Cisco uBR10012 Universal Broadband Router
associate slot slot-one [slot-two]
no associate slot slot-one [slot-two]
Multirouter APS--Cisco 10000 Series Routers
associate slot slot-one mr-aps
no associate slot slot-one mr-aps
Syntax Description slot-one Cisco 10000 Series Router
First slot number to be associated for redundancy. Valid range is from 1 to 8.
Cisco uBR10012 Universal Broadband Router
Specifies the slot that contains the working (primary) card. The available range is 1 to 8, but on
the Cisco uBR10012 router the only valid numbers are 1 and 3, and the card must support APS
redundancy.
slot-two Cisco 10000 Series Router
(Optional) Second slot number to be associated for redundancy. Valid range is from 1 to 8.
Cisco uBR10012 Universal Broadband Router
(Optional) Specifies the slot that contains the redundant (backup) card. The available range is 1
to 8, but on the Cisco uBR10012 router the only valid numbers are 2 and 4. If not specified, the
next higher adjacent slot is automatically configured as the redundant slot.
mr-aps (Cisco 10000 Series Routers Only) Specifies that the slot association is between slots in different
routers as part of a multirouter APS configuration.
Command Default No slots are associated.
Command Modes Redundancy configuration
Command History Release Modification
12.1(5a)EY This command was introduced.
12.0(23)SX The mr-aps keyword was added to support multirouter APS on the OC3ATM and OC12ATM
line cards for the Cisco 10000 series router.
12.0(26)S This command was integrated into Cisco IOS Release 12.0(26)S, and support was added for
the CHOC12, CHSTM1, OC32POS, and OC12POS line cards for the Cisco 10000 series
router.
12.2(4)XF1 This command was introduced for the Cisco uBR10012 router.
Cisco IOS Interface and Hardware Component Command Reference
50
A through B
associate slot
Release Modification
12.2(13)BC1 Support was added for the Cisco OC-48 DPT/POS adapter card on the Cisco uBR10012
router.
12.2(31)SB This command was integrated into Cisco IOS Release 12.2(31)SB
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco
uBR7225VXR router was added.
Usage Guidelines Cisco 10000 Series Router
Use the associate command to associate two cards for single-router APS or multirouter APS redundancy
protection. Multirouter APS support is specific to the Cisco 10000 series router. Use the mr-aps keyword in
a multirouter APS configuration to allow a protect interface on a second router to be a backup for a working
interface on the first router.
The associated slots must use the same type of interface module and must support APS redundancy. The cards
also must be located in adjacent slots, for example slots 3 and 4.
Cisco uBR10012 Universal Broadband Router
The two cards must be in adjacent slots, with the working card in slot 1 or 3, and the backup card in slot 2 or
4, respectively. The two cards must be identical cards and must support APS redundancy (such as the OC-12
POS line card).
Note You cannot use the associate command with any of the Performance Routing Engine (PRE) modules or TCC+
cards, because these cards are automatically configured for redundant operation when two cards are installed
in the chassis.
Examples
Single Router APS Example
The following example shows how to associate two slots in the same router in a single router APS
configuration:
redundancy
associate slot 3 4
Multirouter APS Example on the Cisco 10000 Series Router Only
The following example shows how to associate two separate slots in different routers in a multirouter
APS configuration:
! Associate slot 3 on first router for APS redundancy
!
redundancy
associate slot 3 mr-aps
!
! Associate slot 2 on second router for APS redundancy
!
Cisco IOS Interface and Hardware Component Command Reference
51
A through B
associate slot
redundancy
associate slot 2 mr-aps
Related Commands Command Description
redundancy Enters redundancy configuration mode.
Cisco IOS Interface and Hardware Component Command Reference
52
A through B
association
association
To configure an association between current node and a remote node, use the association command in
interprocess communication (IPC) zone configuration mode. To disable this functionality, use the no form
of this command.
association association-ID
no association association-ID
Syntax Description association-ID Association ID assignment. The value range is from 1 through 255. The association ID
must be unique within a specific zone.
Command Default No association between a current node and a remote node exists.
Command Modes IPC zone configuration
Command History Release Modification
12.3(7)T This command was introduced.
Usage Guidelines Use the association command to configure an association between current node and a remote node. There
can be multiple associations within a zone.
Examples The following example configures an association with an ID of 1:
Router(config-ipczone)# association 1
Related Commands Command Description
ipc zone default Enters IPC zone configuration mode.
show ipc Displays IPC statistics.
Cisco IOS Interface and Hardware Component Command Reference
53
A through B
attach profile-name
attach profile-name
To attach alarm profile to port, enter into controller configuration mode, and use the attach profile-name
command in global configuration mode.
Command to enter into controller configuration mode:
controller {sonet|sdh|t1|e1|t3|e3} slot//bay/port
Command to attach alarm profile to port
attachprofile-name
Syntax Description sonet Specifies SONET controller
sdh Specifies SDH controller
t1 Specifies T1 controller
e1 Specifies E1 controller
slot Specifies the slot number of the interface.
bay Specifies the bay number of the interface.
port Specifies the port number of the interface.
profile-name Alarm profile to attach to the port.
Command Default None
Command Modes Configuration mode
Command History Release Modification
Cisco IOS XE 16.8.1 Support for this command was introduced on ASR 900 Series.
Usage Guidelines Enter into the controller configuration mode and then attach the alarm profile to the interface.
Examples The following example shows how to configure SONET controller in slot 0, bay 3, port 3 and then
attach the alarm profile PORT to the interface:
Router(config)# controller sonet 0/3/3
Router(config-controller)#attach profile PORT
Router(config-controller)#end
Related Commands Command Description
alarm-profile name chassis | card | port} Creates new alarm profile for chassis, card, or port.
Cisco IOS Interface and Hardware Component Command Reference
54
A through B
attach profile-name
Command Description
show alarm-profile Displays alarm profile configured for chassis.
Cisco IOS Interface and Hardware Component Command Reference
55
A through B
atm sonet
atm sonet
To set the mode of operation and thus control the type of the ATM cell used for cell-rate decoupling on the
SONET physical layer interface module (PLIM), use the atmsonetcommand in interface configuration mode.
To restore the default Synchronous Transport Signal level 12, concatenated (STS-12c) operation, use the no
form of this command.
atm sonet [stm-4]
no atm sonet [stm-4]
Syntax Description stm-4 (Optional) Synchronous Digital Hierarchy/Synchronous Transport Signal level 4 (SDH/STM-4)
operation (ITU-T specification).
Command Default STS-12c
Command Modes Interface configuration
Command History Release Modification
11.1CC This command was introduced.
11.2GS The stm-4 keyword was added.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use STM-4 in applications in which SDH framing is required.
Use the default (STS-12c) in applications in which the ATM switch requires “unassigned cells” for rate
adaptation. An unassigned cell contains 32 zeros.
Examples The following example shows how to set the mode of operation to SONET STM-4 on ATM interface
3/0:
Router(config)#
interface atm 3/0
Router(config-if)#
atm sonet stm-4
Router(config-if)#
end
Cisco IOS Interface and Hardware Component Command Reference
56
A through B
au-3
au-3
To configure a particular Administrative Unit type 3 (AU-3) of an E1 line that has been mapped to an AU-3,
use the au-3command in controller configuration mode.
au-3 au-3-number
Syntax Description au-3-number Number in the range from 1 to 3.
Command Default No default behavior or values
Command Modes Controller configuration
Command History Release Modification
12.0(14)S This command was introduced.
12.2(14)S This command was integrated into Cisco IOS Release 12.2(14)S.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
XE Everest This command was integrated into the Cisco NCS 4200 Series and
16.6.1
Cisco ASR 900 Series.
Usage Guidelines An administrative unit group (AUG) of an STM-1 can be derived from either AU-3s or an AU-4. Use the
augmappingau-3configuration controller command to map the AUG to an AU-3 with the following
muxing/alignment/mapping:
C-12 <--> VC-12 <--> TU-12 <--> TUG-2 <--> VC-3 <--> AU-3 <--> AUG
Configuring the au-3command enables you to enter configuration controller au3 command mode and creates
a serial interface with the following name format:
slot/port-adapter/port.au-3-number/tug-2-number/e1-number
The aug mapping au-3 and au-3 commands are available only when Synchronous Digital Hierarchy (SDH)
framing is configured.
Examples The following example shows how to configure AUG mapping to be derived from an AU-3 and
selects AU-3 3 to configure as a serial interface:
Router(config)# controller sonet 2/0/0
Router(config-controller)# aug mapping au-3
Router(config-ctrlr-au3)# au-3 3
Related Commands Command Description
au-4 tug-3 Specifies a TUG-3 for configuration.
aug mapping Configures the AUG mapping mode of the PA-MC-STM-1 to AU-3.
Cisco IOS Interface and Hardware Component Command Reference
57
A through B
au-4 tug-3
au-4 tug-3
To specify the Administrative Unit type 4 (AU-4) and Tributary Unit group type 3 (TUG-3) number of an E1
line that has been mapped to an AU-4, use the au-4tug-3command in controller configuration mode.
au-4 au-4-number tug-3 tug-3-number
Syntax Description au-4-number Number in the range from 1 to xwhere xis the STM level. Default is 1.
tug-3-number Number in the range from 1 to 3.
Command Default Default au-4-number value for the STM-1 card is 1.
Command Modes Controller configuration
Command History Release Modification
12.0(14)S This command was introduced.
12.2(14)S This command was integrated into Cisco IOS Release 12.2(14)S.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
XE Everest This command was integrated into the Cisco NCS 4200 Series and
16.6.1
Cisco ASR 900 Series.
Usage Guidelines An AUG of an STM-1 can be derived from either AU-3s or an AU-4. Use the augmappingau-4configuration
controller command to map the AUG to a TUG-3 with the following muxing/alignment/mapping:
C-12 <--> VC-12 <--> TU-12< --> TUG-2 <--> TUG-3 <--> VC-4 <--> AU-4 <--> AUG
Configuring the au-4command enables you to enter configuration controller tug3 command mode and creates
a serial interface with the following name format:
slot/port-adapter/port.au-4-number/tug-2-number/e1-number
The aug mapping au-4 and au-4tug-3commands are available only when SDH framing is configured.
Examples The following example shows how to configure AUG mapping to be derived from a TUG-3 and
selects TUG-3 1 of AU-4 1:
Router(config)# controller sonet 2/0/0
Router(config-controller)# aug mapping au-4
Router(config-ctrlr-tug3)# au-4 1 tug-3 1
Related Commands Command Description
au-3 Specifies an AU-3 for configuration.
aug mapping Configures the AUG mapping mode.
Cisco IOS Interface and Hardware Component Command Reference
58
A through B
aug mapping
aug mapping
To configure administrative unit group (AUG) mapping when Synchronous Digital Hierarchy (SDH) framing
is selected, use the augmapping command in controller configuration mode.
aug mapping {au-3|au-4}
Syntax Description au-3 Specifies use of three paths--a path is known as an Administrative Unit (AU)--consisting of seven
Tributary Unit group type 2s (TUG-2s). Each TUG-2 consists of three virtual containers (VC-12s),
which carry E1 lines resulting in 21 E1 lines within one AU-3 path.
au-4 Specifies use of one path consisting of three TUG-3 types. Each TUG-3 consists of seven TUG-2s,
resulting in a total of 63 E1 lines within one AU-4 path. This is the default.
Command Default au-4
Command Modes Controller configuration
Command History Release Modification
12.0(14)S This command was introduced.
12.0(17)S Support for the two-port STM-1/OC-3 channelized E1/T1 line card was added.
12.2(14)S This command was integrated into Cisco IOS Release 12.2(14)S.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
XE Everest This command was integrated into the Cisco NCS 4200 Series and
16.6.1
Cisco ASR 900 Series.
Usage Guidelines In SDH, there are two possible mapping/multiplexing schemes for most payload types: ANSI and ETSI.
In ANSI mapping, the Low Order payloads are aggregated into a VC-3 High Order Path. An AU pointer is
added to the VC-3 to create an AU-3. Three such AU-3s are then synchronously multiplexed into an AUG.
The multiplexing scheme is as follows:
... VC-3 <-> AU-3 (x3) <-> AUG <-> STM-1
SDH ANSI mapping is very similar to the SONET frame structure.
In ETSI mapping, the Low Order payloads are aggregated into a VC-4 High Order Path. An AU pointer is
added to the VC-4 to create an AU-4 (Administrative Unit type 4). One AU-4 is “multiplexed” into an AUG
(AU group), which is to say, the AUG is, in fact, equivalent to an AU-4. The multiplexing scheme is as follows:
... TUG-3 (x3) <-> VC-4 <-> AU-4 (x1) <-> STM-1
This command is available only when SDH framing is configured.
This command does not have a no form because data must flow using one of the two mapping/multiplexing
schemes.
Cisco IOS Interface and Hardware Component Command Reference
59
A through B
aug mapping
Examples The following example shows how to configure AU-3 mapping for the STM-1 trunk card:
Router(config)# controller sonet 1/0
Router(config-controller)# aug mapping au-3
Cisco IOS Interface and Hardware Component Command Reference
60
A through B
aug mapping [au-3 | au-4] stm [stm number] stm1 number [number]
aug mapping [au-3 | au-4] stm [stm number] stm1 number
[number]
Use this command to configure mixed AU-3 and AU-4 mapping
aug mapping [au-3 | au-4] stm [stm number] stm1 number [number].
Syntax Description Syntax Description
au-3 Mode of augment mapping
au-4 Mode of augment mapping
stm The STM-1 (Synchronous Transport Module level-1)
is the SDH ITU-T fiber optic network transmission
standard. It has a bit rate of 155.52 Mbit/s.
stm1 number The STM number ranges from 1 to 4.
Command Default The default mode is AU-4.
Command Modes Global configuration
Command History Release Modification
XE Everest This command was integrated into the Cisco NCS 4200 Series and
16.6.1
Cisco ASR 900 Series.
Usage Guidelines The aug mapping command is available only when SDH framing is configured. AUG mapping is supported
at STM-1 level.
Examples
enable
configure terminal
aug mapping [au-3 | au-4 stm [1-1] stm1 number [1-4]
end
Related Commands Command Description
show running configuration Verifies aug mapping configuration.
Cisco IOS Interface and Hardware Component Command Reference
61
A through B
aug mapping au-3 stm [stm number] path number [path number]
aug mapping au-3 stm [stm number] path number [path number]
Use this command to change the AUG mapping of a particular STM-1 to AU-3.
aug mapping au-3 stm [1-16] path number [1-16].
Syntax Description Syntax Description
au-3 Mode of augment mapping
au-4 Mode of augment mapping
stm The STM-1 (Synchronous Transport Module level-1)
is the SDH ITU-T fiber optic network transmission
standard. It has a bit rate of 155.52 Mbit/s.
path number The path parameter number ranges from 1 to 16.
Command Default The default mode is AU-4.
Command Modes Global configuration
Command History Release Modification
XE Everest This command was integrated into the Cisco NCS 4200 Series and
16.6.1
Cisco ASR 900 Series.
Examples
enable
configure terminal
aug mapping [au-3 | au-4 stm [1-16] path number [1-16]
end
Related Commands Command Description
show running configuration Verifies aug mapping configuration.
Cisco IOS Interface and Hardware Component Command Reference
62
A through B
auto-polarity
auto-polarity
To enable automatic receiver polarity reversal on a hub port connected to an Ethernet interface of a Cisco
2505 or Cisco 2507 router, use the auto-polarity command in hub configuration mode. To disable this function,
use the no form of this command.
auto-polarity
no auto-polarity
Syntax Description This command has no arguments or keywords.
Command Default Enabled
Command Modes Hub configuration
Command History Release Modification
10.3 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command applies to a port on an Ethernet hub only.
Examples The following example shows how to enable automatic receiver polarity reversal on hub 0, ports 1
through 3:
Router(config)#
hub ethernet 0 1 3
Router(config-hub)#
auto-polarity
Related Commands Command Description
hub Enables and configures a port on an Ethernet hub of a Cisco 2505 or Cisco 2507 router.
Cisco IOS Interface and Hardware Component Command Reference
63
A through B
b2 sd-ber
b2 sd-ber
To set the signal degrade bit-error rate (BER) threshold values, use the b2sd-bercommand in controller
configuration mode. To return to the default setting, use the no form of this command.
b2 sd-ber rate
no b2 sd-ber
Syntax Description rate Bit-error rate from 3 to 9 (10-n). The value of 9 represents better quality, and the value of 3 represents
lower quality. The default is 6.
Command Default rate: 6
Command Modes Controller configuration
Command History Release Modification
12.2(15)T This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use this command to configure the threshold for degradation of quality of signal with b2 errors.
Examples The following example shows how to configure a signal degrade BER threshold value of 7 on the
SONET controller:
Router(config)# controller sonet 1/0
Router(config-controller)# b2 sd-ber 7
Related Commands Command Description
show controllers sonet Displays information about the SONET controllers.
Cisco IOS Interface and Hardware Component Command Reference
64
A through B
b2 sf-ber
b2 sf-ber
To set the signal failure bit-error rate (BER) threshold values, use the b2sf-bercommand in controller
configuration mode. To return to the default setting, use the no form of this command.
b2 sf-ber rate
no b2 sf-ber rate
Syntax Description rate Bit-error rate from 3 to 9 (10-n). The value of 9 represents better quality, and the value of 3 represents
lower quality. The default is 3.
Command Default rate : 3
Command Modes Controller configuration
Command History Release Modification
12.2(15)T This command was introduced.
Usage Guidelines Use this command to configure the threshold for failure of quality of signal with b2 errors. The value of 9
represents better quality and the value of 3 represents lower quality.
Examples The following example shows how to configure a signal failure BER threshold value of 7 on the
SONET controller:
Router(config)# controller sonet 1/0
Router(config-controller)# b2 sf-ber 7
Related Commands Command Description
show controllers sonet Displays information about the SONET controllers.
Cisco IOS Interface and Hardware Component Command Reference
65
A through B
backup delay
backup delay
To define how much time should elapse before a secondary line status changes after a primary line status has
changed, use the backupdelaycommand in interface configuration mode. To return to the default so that as
soon as the primary fails, the secondary is immediately brought up without delay, use the no form of this
command.
backup delay {enable-delay-period|never} {disable-delay-period|never}
no backup delay {enable-delay-period|never} {disable-delay-period|never}
Syntax Description enable-delay-period Number of seconds that elapse after the primary line goes down before the Cisco
IOS software activates the secondary line.
disable-delay-period Number of seconds that elapse after the primary line comes up before the Cisco IOS
software deactivates the secondary line.
never Secondary line is never activated or deactivated.
Command Default 0 second delay
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRB1 This command was integrated into Cisco IOS Release 12.2(33)SRB1.
15.1(2)SNH This command was implemented on the Cisco ASR 901 Series Aggregation Services Routers.
Usage Guidelines For environments in which spurious signal disruptions appear as intermittent lost carrier signals, we recommend
that you enable some delay before activating and deactivating a secondary line.
For the Cisco 7600 Backup Interface for Flexible UNI feature to work correctly, the enable and disable backup
delay must be 0.
Examples The following example sets a 10-second delay on deactivating the secondary line (serial interface
0); however, the line is activated immediately.
interface serial 0
backup delay 0 10
Cisco IOS Interface and Hardware Component Command Reference
66
A through B
backup interface
backup interface
To configure an interface as a secondary or a dial backup, use the backupinterfacecommand in interface
configuration mode. To disable the interface from serving as a backup, use the no form of this command.
Cisco 7200 Series and Cisco 7600 Series Routers Only
backup interface slot/port-adapter/port
no backup interface slot/port-adapter/port
Other Cisco Routers
backup interface type number
no backup interface type number
Syntax Description slot / port-adapter / port Chassis slot, port adapter, and port number of the interface to configure as a
backup. Include a slash (/) between the slot, port adapter, and port (for example,
1/1/1). See your hardware installation manual for the specific slot, port adapter,
and port numbers.
type number Type and port number of the interface that is being configured as a backup.
Command Default An interface is not configured as a backup.
Command Modes Interface configuration (config-if)
Command History Release Modification
11.0 This command was introduced.
12.2(33)SRB1 This command was integrated into Cisco IOS Release 12.2(33)SRB1.
Usage Guidelines The interface that you define with the backupinterface command can back up only one interface.
Serial, ISDN, and Ethernet backup interfaces are supported by the routers. Access servers support both
asynchronous backup interfaces and serial backup interfaces.
In Cisco IOS Release 12.2(33)SRB1 and later releases, you can configure a backup interface for Gigabit
Ethernet interface on the Cisco 7600 router. The backup interface works only when the configurations on the
primary and backup interfaces are identical. This is applicable to all Cisco IOS platforms and interfaces.
Note If the interface configuration includes the xconnectcommand, you must specify a different virtual circuit ID
(VCID) on the primary and backup interfaces.
Examples The following example sets serial interface 1 as the backup line to serial interface 0:
Router(config)# interface serial 0
Router(config-if)# backup interface serial 1
Cisco IOS Interface and Hardware Component Command Reference
67
A through B
backup interface
The following example sets Gigabit Ethernet interface 4/0/1 as the backup interface for Gigabit
Ethernet interface 3/0/1 on the Cisco 7600 router:
Router(config)# interface gigabitEthernet 3/0/1
Router(config-if)# backup interface gigabitEthernet 4/0/1
Related Commands Command Description
aps protect (SONET) Enables SONET APS.
show version Displays information about the currently loaded software along with hardware and
device information.
Cisco IOS Interface and Hardware Component Command Reference
68
A through B
backup interface atm
backup interface atm
To back up a locally switched ATM connection, use the backupinterfaceatmcommand in theconnectsubmode.
To deconfigure the active routing policy set, leaving the SBE with no active routing policy set, use the no
form of this command.
backup interface atm x/y/z vpi/vci
no backup interface atm x/y/z vpi/vci
Syntax Description interface Identifies the interface.
atm > x / y / z > Specifies the backup location for the ATM slot/subslot/port to be backed up.
vpi / vci > Specifies the backup location for the ATM virtual path identifier/virtual channel
identifier (VPI/VCI).
Command Default No default behavior or values.
Command Modes Connect submode (config-connection)
Command History Release Modification
12.2(33)SRC This command was introduced on the Cisco 7600 series routers.
Usage Guidelines • Only the tail end AC can be backed up; if head end fails there is no protection.
• The circuit type of the primary and backup AC must be identical (failover operation will not switch
between different types of interfaces).
• Autoconfiguration is allowed for backup ATM Permanent Virtual Circuits (PVCs) or ATM Permanent
Virtual Paths (PVPs).
• Dynamic modification of parameters in a local switching connection is not supported in the case where
the tail-end segment is backed up to a segment using the backupinterfaceatmcommand. If you want to
modify the parameters in any of the three segments (head-end, tail-end, or backup segment), you must
first unconfigure with the backupinterfaceatm command, make the changes in the individual segments,
and then reconfigure the backup with the backupinterfaceatm command.
Examples The following is an example of a ATM virtual path local switching backup:
Router(config)# connect ATM atm2/0/0 0 atm3/0/0 0
Router(config-connection)# backup interface atm 4/0/0 1
The following is an example of a ATM virtual channel local switching backup:
Router(config)# connect ATM atm2/0/0 24/56 atm3/0/0 24/57
Router(config-connection)# backup interface atm 4/0/0 25/58
!
Cisco IOS Interface and Hardware Component Command Reference
69
A through B
backup interface atm
Related Commands Command Description
connect atm Configures a local switching connection.
Cisco IOS Interface and Hardware Component Command Reference
70
A through B
backup interface cem
backup interface cem
To back up a locally switched CEM connection, use the backupinterfacecem command in theconnectsubmode.
To deconfigure the locally switched CEM connection backup, use the no form of this command.
backup interface cem x/y/z cemckt
no backup interface cem x/y/z cemckt
Syntax Description interface > Identifies the interface.
cem > x / y / z Specifies the CEM interface slot, subslot, and port to be backed up.
cemckt Specifies the backup location for the CEM.
Command Default No default behavior or values.
Command Modes Connect submode (config-connection)
Command History Release Modification
12.2(33)SRC This command was introduced on the Cisco 7600 series routers.
Usage Guidelines • Autoconfiguration of CEM interfaces is not supported.
• Only the tail end AC can be backed up; if head end fails there is no protection.
• The circuit type of the primary and backup AC must be identical (failover operation will not switch
between different types of interfaces or different CEM circuit types).
• Backs up a local switching connection to cem-ckt3 of CEM interface cem3. Only one backup AC is
allowed for each connection.
• Autoconfiguration of backup CEM circuits is not allowed.
• The CEM circuit used as a backup in a local switching connection cannot be used for xconnect
configurations.
• Dynamic modification of parameters in a local switching connection is not supported in the case where
the tail-end segment is backed up to a segment using the backupinterfacecemcommand. If you want to
modify the parameters in any of the three segments (head-end, tail-end, or backup segment), you must
first unconfigure with the backupinterfacecemcommand, make the changes in the individual segments,
and then reconfigure the backup with the backupinterfacecem command.
Examples The following is an example of a CEM local switching backup:
Router(config)# connect cema cem4/3/0 0 cem2/0/0 0
Router(config-connection)# backup interface cem 2/0/0 1
Cisco IOS Interface and Hardware Component Command Reference
71
A through B
backup interface cem
Related Commands Command Description
connect cem Configures a local switching connection.
Cisco IOS Interface and Hardware Component Command Reference
72
A through B
backup load
backup load
To set a traffic load threshold for dial backup service, use the backuploadcommand in interface configuration
mode. To return to the default value, use the no form of this command.
backup load {enable-threshold|never} {disable-load|never}
no backup load {enable-threshold|never} {disable-load|never}
Syntax Description enable-threshold Percentage of the primary line’s available bandwidth that the traffic load must exceed
to enable dial backup.
disable-load Percentage of the available bandwidth that the traffic load must be less than to disable
dial backup. The transmitted or received load on the primary line plus the transmitted or
received load on the secondary line is less than the value entered for the
disable-loadargument to disable dial backup.
never The secondary line is never activated or deactivated because of the traffic load.
Command Default No threshold is defined.
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRB1 This command was integrated into Cisco IOS Release 12.2(33)SRB1.
Usage Guidelines When the transmitted or received load on the primary line is greater than the value assigned to the
enable-threshold argument, the secondary line is enabled.
The secondary line is disabled when one of the following conditions occurs:
• The transmitted load on the primary line plus the transmitted load on the secondary line is less than the
value entered for the disable-loadargument.
• The received load on the primary line plus the received load on the secondary line is less than the value
entered for the disable-load argument.
If the neverkeyword is used instead of an enable-thresholdargument, the secondary line is never activated
because of traffic load. If the never keyword is used instead of a disable-load argument, the secondary line
is never activated because of traffic load.
Examples The following example sets the traffic load threshold to 60 percent of the primary line serial 0. When
that load is exceeded, the secondary line is activated and will not be deactivated until the combined
load is less than 5 percent of the primary bandwidth.
interface serial 0
backup load 60 5
backup interface serial 1
Cisco IOS Interface and Hardware Component Command Reference
73
A through B
bandwidth (interface configuration)
bandwidth (interface configuration)
To set the inherited and received bandwidth values for an interface, use the bandwidth command in interface
or virtual network interface config mode. To restore the default values, use the no form of this command.
bandwidth [{receive}] {kbps| inherit [{kbps}]}
no bandwidth [{receive}] {kbps| inherit [{kbps}]}
Syntax Description kbps Intended bandwidth, in kilobits per second. The range is from 1 to 10000000. For a full bandwidth
DS3 line, enter the value 44736.
inherit (Optional) Specifies how a subinterface inherits the bandwidth of its main interface.
receive (Optional) Enables asymmetric transmit/receive operations so that the transmitted (inherit kbps)
and received bandwidth are different.
Command Default Default bandwidth values are set during startup. The bandwidth values can be displayed using the show
interfaces or show ipv6 interface command. If the receive keyword is not used, by default, the transmit
and receive bandwidths will be assigned the same value.
Command Modes Interface configuration (config-if)
Virtual network interface (config-if-vnet)
Command History Release Modification
10.0 This command was introduced.
12.2T This command was modified. The inherit keyword was added.
12.4(6)T This command was modified. Support for IPv6 was added.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support
in a specific 12.2SX release of this train depends on your feature set, platform,
and platform hardware.
Cisco IOS XE Release 2.1 This command was implemented on Cisco ASR 1000 Aggregation Services
Series Routers.
Cisco IOS XE Release 3.2S This command was modified. Support was added for this command in virtual
network interface configuration mode.
15.1(03)S This command was modified. Support was added for the receive keyword.
Usage Guidelines Bandwidth Information
The bandwidth command sets an informational parameter to communicate only the current bandwidth to the
higher-level protocols; you cannot adjust the actual bandwidth of an interface using this command.
Cisco IOS Interface and Hardware Component Command Reference
74
A through B
bandwidth (interface configuration)
Note This is only a routing parameter. It does not affect the physical interface.
Changing Bandwidth
For some media, such as Ethernet, the bandwidth is fixed; for other media, such as serial lines, you can change
the actual bandwidth by adjusting the hardware. For both classes of media, you can use the bandwidth
command to communicate the current bandwidth to the higher-level protocols.
Bandwidth Inheritance
Before the introduction of the bandwidth inherit command option, when the bandwidth value was changed
on the main interface, the existing subinterfaces did not inherit the bandwidth value. If the subinterface was
created before the bandwidth was changed on the main interface, the subinterface would receive the default
bandwidth of the main interface, and not the configured bandwidth. Additionally, if the router was subsequently
reloaded, the bandwidth of the subinterface would then change to the bandwidth configured on the main
interface.
The bandwidth inherit command controls how a subinterface inherits the bandwidth of its main interface.
This functionality eliminates inconsistencies related to whether the router has been reloaded and what the
order was in entering the commands.
The no bandwidth inherit command enables all subinterfaces to inherit the default bandwidth of the main
interface, regardless of the configured bandwidth. If the bandwidth inherit command is used without
configuring a bandwidth on a subinterface, all subinterfaces will inherit the current bandwidth of the main
interface. If you configure a new bandwidth on the main interface, all subinterfaces will use this new value.
If you do not configure a bandwidth on the subinterface and you configure the bandwidth inherit kbps
command on the main interface, the subinterfaces will inherit the specified bandwidth.
In all cases, if an explicit bandwidth setting is configured on an interface, the interface will use that setting,
regardless of whether the bandwidth inheritance setting is in effect.
Bandwidth Receipt
Some interfaces (such as Asymmetric Digital Subscriber Line (ADSL), V.35, RS-449, and High-Speed Serial
Interface (HSSI)) can operate with different transmit and receive bandwidths. The bandwidth receive
command permits this type of asymmetric operation. For example, for ADSL, the lower layer detects the two
bandwidth values and configures the Integrated Data Base (IDB) accordingly. Other interface drivers,
particularly serial interface cards on low- and midrange-platforms, can operate in this asymmetric bandwidth
mode but cannot measure their clock rates. In these cases, administrative configuration is necessary for
asymmetric operations.
Examples The following example shows how to set the full bandwidth for DS3 transmissions:
Router(config)# interface serial 0
Router(config-if)# bandwidth 44736
The following example shows how to set the receive bandwidth:
Router(config)# interface serial 0
Router(config-if)# bandwidth receive 1000
Cisco IOS Interface and Hardware Component Command Reference
75
A through B
bandwidth (interface configuration)
Related Commands Command Description
show interfaces Displays statistics for all interfaces configured on the router.
show ipv6 interface Displays statistics for all interfaces configured on the IPv6 router.
Cisco IOS Interface and Hardware Component Command Reference
76
A through B
batch
batch
To allow better cache utilization at the interface level, use the batch command under interface configuration
mode.
batch {allowed | countnumber | thresholdrange }
Syntax Description allowed Enables the batch process for packets received.
Number of interrupts received for the batch process. Value ranges from 2 to 8.
When batching is enabled, the packets in the receive ring are processed on every nth RX
count number interrupt, where "n" is configured by "batch count n".
Packets per 4ms threshold to enable the batch. Range is from 2 to 100 packets/4ms. If the
number of packets received within a 4ms period exceeds 'x' then batching is turned on,
threshold range otherwise it is turned off.
Command Default Batch is disabled.
Command Modes configuration-Interface
Command History Release Modification
15.1(3)T This command was introduced.
Usage Guidelines Use this command to increase the performance of packets processing through the interface to optimize the
cache usage. The performance improvement varies depending on the burstiness of the traffic. The traffic with
high burstiness provides better performance.
The batch command is disabled by default. The batch process depends on the batch threshold (x) which is
the number of packets received within a ‘y’ ms period. The batch process is turned on if the number of packets
received within a ‘y’ ms period exceeds ‘x’, otherwise it is turned off.
Currently, the batch command is supported at the interface level on Cisco 890 routers only.
Examples The following example shows the batch command configured in interface fastethernet ports:
!
!
interface FastEthernet0
no ip address
batch allowed
batch count 6
batch threshold 75
!
interface FastEthernet1
no ip address
batch allowed
batch count 6
batch threshold 75
!
Cisco IOS Interface and Hardware Component Command Reference
77
A through B
batch
interface FastEthernet2
no ip address
batch allowed
batch count 6
batch threshold 75
!
interface FastEthernet3
no ip address
batch allowed
batch count 6
batch threshold 75
!
interface FastEthernet4
no ip address
batch allowed
batch count 6
batch threshold 75
!
interface FastEthernet5
no ip address
batch allowed
batch count 6
batch threshold 75
!
interface FastEthernet6
no ip address
batch allowed
batch count 6
batch threshold 75
!
interface FastEthernet7
no ip address
batch allowed
batch count 6
batch threshold 75
!
!
Cisco IOS Interface and Hardware Component Command Reference
78
A through B
bert abort controller
bert abort controller
To end a bit error rate testing (BERT) session, use the bertabortcontrollercommand in privileged EXEC
mode.
bert abort controller controller-type slot/port
Syntax Description controller-type Type of controller being tested. Use either T1 or E1 depending on the type of facility.
slot / port Slot number and port number to end a BERT session.
Command Default A BERT session is configured.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.0(2)XD This command was introduced.
12.0(3)T This command was integrated into Cisco IOS Release 12.0(3)T.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use the bertabortcontrollercommand to cancel bit error rate testing on each port of the Cisco AS5300 router.
The BERT feature enables you to test the quality of the connected Primary Rate Interface (PRI) links by direct
comparison of a pseudorandom or repetitive test pattern with an identical locally generated test pattern.
Examples The following is sample output from the bertabortcontrollercommand when no bit error rate test
is running:
Router# bert abort controller t1 0/0
Router#
17:53:33: There is no BERT Test running ....
The following is sample output from the bertabortcontrollercommand when a bit error rate test is
running:
Router# bert abort controller t1 0/0
Do you really want to abort the current BERT [confirm] Y17:56:56: %BERT-6-BERT_RESULTS:
Controller T1 0 Profile default : The Test was
aborted by User
Related Commands Command Description
bert controller Starts a bit error rate test for a particular port.
Cisco IOS Interface and Hardware Component Command Reference
79
A through B
bert abort controller
Command Description
bert pattern (T1/E1) Sets up various bit error rate testing profiles.
Cisco IOS Interface and Hardware Component Command Reference
80
A through B
bert controller
bert controller
To start a bit error rate test (BERT) for a particular port, use the bertcontrollercommand in privileged EXEC
mode.
bert controller controller-type controller-number last-controller-number profile {profile-number
[last-profile-number] [timeslot timeslot-number [last-timeslot-number]]|default}
Syntax for Cisco 2600 Platforms
bert controller type-controller slot/port [channel-group channel-number] [pattern pattern-name]
[interval range]
Syntax Description controller-type Type of controller being tested. Use either T1 or E1 depending on the type
of facility.
controller-number Controller number. The valid range is from 0 to 7.
last-controller-number Last contoller number. The valid range is from 2 to 7.
profile Sets the profile numbers for the bit error rate test.
profile-number Numbers of the test profiles to use. The valid range is from 0 to 15. The
default is 0.
last-profile-number (Optional) Last profile number. The default is 0.
timeslot (Optional) Generates the data based on the timeslots associated with the
controller.
timeslot-number (Optional) Timeslot number. The valid range is from 1 to 22.
last-timeslot-number (Optional) Last timeslot number. The valid range is from 1 to 24.
default Executes the default bit error rate test (0).
slot/port Slot and port number for the ports to be tested.
channel-group channel-number (Optional) Specifies the channel group number that you want the BERT
test to run on. Numbers can be 0 or 1.
Cisco IOS Interface and Hardware Component Command Reference
81
A through B
bert controller
pattern pattern-name (Optional) BERT patterns available for testing are:
• 0s--repetitive pattern; all zeros test pattern
• 1s--n repetitive pattern; all ones test pattern
• qrw--215-1 QRW test pattern
• qrss (default)--220-1 Quasi-Random Signal Sample 0.151 test pattern
• alt-0-1--alternating zeros and ones test pattern
• 1in8--n repetitive pattern; 1 in 8
• 3in24--n repetitive pattern; 3 in 24
• 63--26-1 63 test pattern
• 511--29-1 511 test pattern
• 2047--211-1 test pattern
interval range (Optional) Range for the test, in minutes. The valid range is from 1 to
14400. The default is 1.
Command Default The test profile 0 is configured by default.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.0(2)XD This command was introduced.
12.0(3)T This command was integrated into Cisco IOS Release 12.0(3)T.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
15.0(1)M This command was modified in a release earlier than Cisco IOS Release 15.0(1)M. The
following keywords and arguments were added:
• last-controller-number
• last-profile-number
• timeslot
• timeslot-number
• last-timeslot-number
• default
Usage Guidelines Use the bertcontroller command to start a bit error rate test for a particular port on a Cisco AS5300 router.
Cisco IOS Interface and Hardware Component Command Reference
82
A through B
bert controller
Quality Testing
The BERT feature enables you to test the quality of the connected Primary Rate Interface (PRI) links by direct
comparison of a pseudorandom or repetitive test pattern with an identical locally generated test pattern.
E1 Controllers
The E1 controller cannot be set in loopback mode from the Cisco AS5300 router. For the bertcontroller
command to work correctly with the E1 controller, the controller must be configured as a channel group or
as channel-associated signaling (CAS) and the line must be configured as a remote loop from the switch side
of the link.
You can use the channel-groupchannel-group-number keyword and argument combination to specify a
channel-group. If the channel-group is specified, BERT will be run on the timeslots associated with the channel
group only. Otherwise, BERT will run on all the timeslots of the specified controller.
Examples The following is sample output from the bertcontroller command:
Router#
bert controller T1 T2 profile default
Press <Return> to start the BERT [confirm]
Y
17:55:34: %BERT-6-BERT_START: Starting BERT on Interface 0 with Profile default
Data in current interval (10 seconds elapsed):
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs
Table 1 describes the significant fields shown in the display.
Table 1: bert controller Field Descriptions
Field Description
Data in current interval Shows the current accumulation period, which rolls into the 24-hour accumulation
every 15 minutes. As the latest 15-minute accumulation period enters the buffer, the
oldest 15-minute period is deleted. The accumulation period is from 1 to 900 seconds.
Line Code Violations For alternate mark inversion (AMI)-coded signals, a line code violation is a bipolar
violation (BPV) occurrence. Indicates the occurrence of either a BPV or an excessive
zeros (EXZ) error event.
Path Code Violations When super frame (SF) (D4) framing is used, a path code violation is a framing
error. When extended super frame (ESF) framing is used, a path code violation is a
cyclic redundancy check type 6 (CRC-6) error. Indicates a frame-synchronization
bit error in the D4 and E1-non-CRC formats, or a CRC error in the ESF and E1-CRC
formats.
Slip Secs Indicates the replication or deletion of the payload bits of a DS1 frame. A slip may
be indicated when there is a difference between the timing of a synchronous receiving
terminal and the received signal.
Fr Loss Secs Seconds during which the framing pattern has been lost. Indicates the number of
seconds for which an Out-of-Frame error is detected.
Cisco IOS Interface and Hardware Component Command Reference
83
A through B
bert controller
Field Description
Line Err Secs A line error second (LES) is a second in which one or more line code violation (LCV
or CV-L) errors are detected.
Degraded Mins A degraded minute is one in which the estimated error rate exceeds 1-6 but does not
exceed 1-3.
Errored Secs In extended superframe (ESF) and E1-CRC links, an errored second is a second in
which one of the following is detected: one or more path code violations; one or
more Out-of-Frame defects; one or more controlled slip events; an alarm indication
signal (AIS) defect.
For D4 and E1-non-CRC links, the presence of bipolar violations also triggers an
errored second.
Bursty Err Secs Seconds with fewer than 320 and more than 1 path code violation error, no severely
errored frame defects, and no detected incoming AIS defects. Controlled slips are
not included in this parameter.
Severely Err Secs For ESF signals, a second with one of the following errors: 320 or more path code
violation errors; one or more Out-of-Frame defects; a detected AIS defect.
For E1-CRC signals, a second with one of the following errors: 832 or more path
code violation errors; one or more Out-of-Frame defects.
For E1-non-CRC signals, a second with 2048 or more line code violations.
For D4 signals, a count of 1-second intervals with framing errors, or an Out-of-Frame
defect, or 1544 line code violations.
Unavail Secs Count for every second in which an unavailable signal state occurs. This term is
used by new standards in place of failed seconds (FS).
The following example shows a BERT test started on a T1 port 0/0 and channel group 0 with a QRSS
signaling pattern for a duration of 5 minutes:
Router# bert controller t1 0/0 channel-group 0 pattern qrss interval 5
Related Commands Command Description
bert abort Aborts a bit error rate testing session.
bert pattern (T1/E1) Sets up various bit error rate testing profiles.
bert abort controller Stops a BERT test prematurely.
Cisco IOS Interface and Hardware Component Command Reference
84
A through B
bert errors
bert errors
To transmit bit error ratio test (BERT) errors while running any BERT pattern, use theberterrorcommand in
interface configuration mode.
bert errors [number]
Syntax Description number (Optional) Range of 1-255BERT errors that may be introduced in a BERT pattern.
Command Default Default is 1.
Command Modes Interface configuration
Command History Release Modification
12.1(12c)EX1 This command was introduced for Cisco 7304 routers.
12.2(18)S This command was introduced on Cisco 7304 routers running Cisco IOS Release 12.2S.
12.2(18)SXE This command was integrated into Cisco IOS Release 12.2(18)SXE to support SPAs on the
Cisco 7600 series router and Catalyst 6500 series switch.
12.2(25)S3 This command was integrated into Cisco IOS Release 12.2(25)S3.
12.0(31)S This command was integrated into Cisco IOS Release 12.0(31)S.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines Use this command to test link availability by injecting a fixed number of bert errors when a pattern is running
and check that the same number of errors were received on the remote end.
Examples This example injects 200 BERT errors in a running bit pattern on slot 5, subslot 0.
Router# configure terminal
Router(config)# interface serial 5/0/0
Router(config-if)# bert errors 200
Related Commands Command Description
bert pattern Starts a BERT pattern on a port.
show controller serial Displays serial line statistics.
Cisco IOS Interface and Hardware Component Command Reference
85
A through B
bert pattern
bert pattern
To start a BERT pattern on a port, use the bertpatterncommand in interface configuration mode. Use the no
bert pattern command to stop the sequence.
bert pattern {0s|1s|2^11|2^15|2^20|2^23|alt-0-1|qrss} interval minutes
no bert pattern {0s|1s|2^11|2^15|2^20|2^23|alt-0-1|qrss} interval minutes
Syntax Description 0s Repeating pattern of zeros (...000...).
1s Repeating pattern of ones (...111...).
2^11 Pseudo-random repeating test pattern that consists of 2,048 bits.
2^15 Pseudorandom 0.151 test pattern that is 32,768 bits in length.
2^20 Pseudorandom 0.153 test pattern that is 1,048,575 bits in length.
2^23 Pseudorandom 0.151 test pattern that is 8,388,607 bits in length.
alt-0-1 Repeating pattern of alternating zeros and ones (...01010...).
qrss Pseudorandom quasi-random signal sequence (QRSS) 0.151 test pattern that is 1,048,575
bits in length.
interval minutes Specifies the length of the BERT test in minutes.
Command Default Bert is disabled by default.
Command Modes Interface configuration
Command History Release Modification
11.1CC The command was introduced.
12.0(5)XE The command was enhanced as an ATM interface configuration command
12.0(7)XE1 Support for Cisco 7100 series routers was added.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.
12.1(12c)EX1 Support for Cisco 7304 routers was added.
12.2(18)S Support for Cisco 7304 routers was added.
12.2(18)SXE This command was integrated into Cisco IOS Release 12.2(18)SXE to support SPAs on
the Cisco 7600 series router and the Catalyst 6500 series switch.
12.0(31)S This command was integrated into Cisco IOS Release 12.0(31)S.
12.2(25)S3 This command was integrated into Cisco IOS Release 12.2(25)S3.
Cisco IOS Interface and Hardware Component Command Reference
86
A through B
bert pattern
Release Modification
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
XE3.18SP This command was integrated into Cisco NCS 4200 Series.
XE Everest This command was implemented on the Cisco ASR 920 Routers and Cisco NCS 4200
16.5.1 Series.
Usage Guidelines Use the bert pattern commamd to start or stop a specific bit pattern. To test link availability, start a pattern on
one end and put the remote end in network loopback and verify that there are no bert errors.
Examples This example starts a bert pattern on slot 5, bay 0.
Router# configure terminal
Router(config)# int serial 5/0/0
Router(config-if)# bert pattern 0s
This example starts a bert pattern pRBS.
Router#enable
Router#configure terminal
Router(config)#bert pattern pRBS interval 5 direction line
exit
Related Commands Command Description
bert errors Transmit bert errors while running any bert pattern.
loopback Loopback at various points in the transmit and receive path.
show controller serial Displays serial line statistics.
show controller sonet Displays sonet interface module statistics.
show controller t1 Displays t1 interface module statistics.
show controller t3 Displays t3 interface module statistics.
Cisco IOS Interface and Hardware Component Command Reference
87
A through B
bert pattern (T1 E1)
bert pattern (T1 E1)
To enable a bit error rate test (BERT) pattern on a T1 or E1 line, use thebertpatterncommand in controller
configuration mode. To disable a BER test pattern, use the no form of this command.
bert pattern pattern interval time
no bert pattern pattern interval time
Syntax Description pattern The test pattern indicated by any of the following allowable values:
2^23 Invokes a pseudorandom 0.151 test pattern that is 8,388,607 bits in length.
2^20 Invokes a pseudorandom 0.153 test pattern that is 1,048,575 bits in length.
2^20-QRSS Invokes a pseudorandom quasi-random signal sequence (QRSS) 0.153 test pattern that is
1,048,575 bits in length.
2^15 Invokes a pseudorandom 0.151 test pattern that is 32,768 bits in length.
2^11 Invokes a pseudorandom test pattern that is 2,048 bits in length.
1s Invokes a repeating pattern of ones (...111...).
0s Invokes a repeating pattern of zeros (...000...).
alt-0-1 Invokes a repeating pattern of alternating zeros and ones (...01010...).
interval time Specifies the duration (in minutes) of the BER test. The interval can be a value from 1 to
14400. There is no default.
Command Default Disabled
Command Modes Controller configuration
Command History Release Modification
11.1CC This command was introduced.
12.0(5)XE This command was enhanced as an ATM interface configuration command.
12.0(7)XE1 This command was implemented on Cisco 7100 series routers.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines BER testing is supported on each of the T1 or E1 lines, is done only over an unframed T1 or E1 signal, and
is run on only one port at a time.
Cisco IOS Interface and Hardware Component Command Reference
88
A through B
bert pattern (T1 E1)
To view the BER test results, use the showcontrollersatmEXEC command. The BERT results include the
following information:
• Type of test pattern selected
• Status of the test
• Interval selected
• Time remaining on the BER test
• Total bit errors
• Total bits received
When the T1 or E1 line has a BER test running, the line state is DOWN and the status field shows the
current/last result of the test.
Thebertpatterncommand is not written to NVRAM because this command is only used to test the T1 or E1
line for a short predefined interval, and to avoid accidentally saving the command.
Examples The following example shows how to run a BERT pattern of all zeros on a Cisco 7200 series router
for 30 minutes on the T1 controller in slot 1:
Router(config)#
controller T1 1/0
Router(config-if)#
bert pattern 0s interval 30
Related Commands Command Description
show controllers atm Displays information about T1/E1 links in Cisco 7100 series routers, Cisco 7200
series routers, and Cisco 7500 series routers.
Cisco IOS Interface and Hardware Component Command Reference
89
A through B
bert pattern (T3 E3)
bert pattern (T3 E3)
To enable a bit error rate test (BERT) pattern on a T3 or E3 controller, use the bertpattern command in
controller configuration mode. To disable a BER test pattern, use the no form of this command.
bert pattern pattern interval time
no bert pattern
Syntax Description pattern The pattern indicated by any of the following allowable values:
2^23 Invokes a pseudorandom 0.151 test pattern that is 8,388,607 bits in length.
2^20 Invokes a pseudorandom 0.153 test pattern that is 1,048,575 bits in length.
2^15 Invokes a pseudorandom 0.151 test pattern that is 32,768 bits in length.
1s Invokes a repeating pattern of ones (...111...).
0s Invokes a repeating pattern of zeros (...000...).
alt-0-1 Invokes a repeating pattern of alternating zeros and ones (...01010...).
interval time Specifies the duration (in minutes) of the BER test. The interval can be a value from 1 to
14400. There is no default.
Command Default Disabled
Command Modes Controller configuration
Command History Release Modification
11.1CC This command was introduced.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and implemented on the
following platforms: Cisco 2650XM, Cisco 2651XM, Cisco 2691, Cisco 3660 series, Cisco
3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines BER testing is supported on T3/E3 links and is done only over framed T3 or E3 signals, unless E3 framing
is in bypass mode.
To display the BER test results, use the show controllers t3 or show controllers e3 EXEC command. The BER
test results include the following information:
Cisco IOS Interface and Hardware Component Command Reference
90
A through B
bert pattern (T3 E3)
• Type of test pattern selected
• Status of the test
• Interval selected
• Time remaining on the BER test
• Total bit errors
• Total bits received
When the T3 or E3 line has a BER test running, the line state is DOWN and the status field shows the current
or last result of the test.
Thebertpatterncommand is not written to NVRAM because this command is used only to test the T3 or E3
line for a short predefined interval, and to avoid accidentally saving the command.
Examples The following example shows how to run a BERT pattern of all zeros for 30 minutes on the T3
controller in slot 1:
Router(config)#
controller T3 1/0
Router(config-if)#
bert pattern 0s interval 30
Related Commands Command Description
show controllers e3 Displays information about E3 controllers.
show controllers t3 Displays information about T3 controllers.
Cisco IOS Interface and Hardware Component Command Reference
91
A through B
bert profile
bert profile
To set up various bit error rate testing profiles, use the bert profile command in global configuration mode.
To disable the particular bit error rate test (BERT) profile indicated by profile number, use the no form of
this command.
bert profile number pattern pattern threshold threshold error-injection err-inj duration time
no bert profile number pattern pattern threshold threshold error-injection err-inj duration time
Syntax Description number BERT profile number. The valid range is from 1 to 15. This is the number assigned to a
particular set of parameters. If no such profile of the same number exists in the system, a
new profile is created with that number; otherwise, an existing set of parameters with that
profile number is overwritten by the new profile.
pattern Pattern that BERT will generate on the line.
pattern 0s --Repetitive pattern, all zeros.1_in_16--n repetitive pattern, 1 in 16.1s--n repetitive
pattern, all ones.211-O.152--n pseudorandom pattern, 211 -1 O.152.215-O.15--n
pseudorandom pattern, 215 -1 O.151.220-O.151QRSS--n pseudorandom pattern, 220 -1
O.151 QRSS. (This is the default.)220-O.153--n pseudorandom pattern, 220 -1
O.153.3_in_24--n repetitive pattern, 3 in 24.
threshold Test failure (error) threshold that determines if the BERT on this line passed.
threshold 10^-2 --Bit error rate of 10-2.10^-3--Bit error rate of 10-3.10^-4--Bit error rate of
10-4.10^-5--Bit error rate of 10-5.10^-6--Bit error rate of 10-6. (This is the
default.)10^-7--Bit error rate of 10-7.10^-8--Bit error rate of 10-8.
error-injection Error injection rate for bit errors injected into the BERT pattern generated by the chip.
err-inj 10^-1 --Error injection of 10-1.10^-2--Error injection of 10-2.10^-3--Error injection of
10-3.10^-4--Error injection of 10-4.10^-5--Error injection of 10-5.10^-6--Error injection
of 10-6.10^-7--Error injection of 10-7.none--No error injection in the data pattern. (This
is the default.)
duration Duration, in minutes, for which BERT is to be executed.
time Duration of BERT, in minutes. The valid range is from 1 to 1440. The default is 10.
Command Default The default profile created internally by the system has parameters that cannot be changed. This profile has
been defined so that you can execute BERT on a line without having to configure a new profile. The default
profile is displayed when the running configuration is displayed and is not stored in NVRAM:
bert profile number pattern 220-0151QRSS threshold 10^-6 error-injection none duration 10
Command Modes Global configuration
Command History Release Modification
12.0(2)XD This command was introduced.
Cisco IOS Interface and Hardware Component Command Reference
92
A through B
bert profile
Release Modification
12.0(3)T This command was integrated into Cisco IOS Release 12.0(3)T.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use the bert profile command to set up bit error rate testing profiles for the Cisco AS5300 router.
The bit error rate test (BERT) feature enables you to test the quality of the connected PRI links by direct
comparison of a pseudorandom or repetitive test pattern with an identical locally generated test pattern. A
BERT profile is a set of parameters related to a BERT test and is stored as part of the configuration in NVRAM.
You can define up to 15 BERT profiles on the system. By setting up the BERT profiles in this way, you do
not have to enter the parameters each time you want to run a BERT--just select the number of the BERT
profile that you want to run.
Examples The following example shows a configured BERT profile number 1 to have a 0s test pattern, with a
10-2 threshold, no error injection, and a duration of 125 minutes:
Router(config)#
bert profile 1 pattern 0s threshold 10^-2 error-injection none duration 125
Related Commands Command Description
bert abort Aborts a bit error rate testing session.
bert controller Starts a bit error rate test for a particular port.
Cisco IOS Interface and Hardware Component Command Reference
93
A through B
bitswap line
bitswap line
To divert the data of a disturbed transmission channel to other channels, use the bitswap line command in
controller configuration mode. To disable bitswapping, use the no form of this command.
bitswap [line line-number]
no bitswap [line line-number]
Syntax Description line-number Line number. Valid values are either 0 or 1.
Command Default Bit swapping is enabled.
Command Modes Controller configuration (config-controller)#
Command History Release Modification
15.4(4)T This command was introduced.
Usage Guidelines • After you enable bit swapping, whenever the line conditions change, the modem swaps the bits around
different channels without retraining.
• If you enable bonded mode, bit swapping will be enabled on both the lines.
• If you specify only the line number, bit swapping will be enabled only on that line.
• In case of single mode, bit swapping will be enabled only on that line.
Examples The following example shows how to enable bit swapping on line 0:
Router(config-controller)# bitswap line 0
The following example shows how to disable bit swapping:
Router(config-controller)# no bitswap
Related Commands Command Description
sra line Accommodates changes to the total link capacity with less disruption to communications.
Cisco IOS Interface and Hardware Component Command Reference
94
A through B
bridge-domain
bridge-domain
To enable RFC 1483 ATM bridging or RFC 1490 Frame Relay bridging to map a bridged VLAN to an ATM
permanent virtual circuit (PVC) or Frame Relay data-link connection identifier (DLCI), use the
bridge-domaincommand in Frame Relay DLCI configuration, interface configuration, interface ATM VC
configuration, or PVC range configuration mode. To disable bridging, use the no form of this command.
bridge-domain vlan-id [{access|dot1q [tag]|dot1q-tunnel}] [broadcast] [ignore-bpdu-pid] [pvst-tlv
CE-vlan] [increment] [lan-fcs] [split-horizon]
no bridge-domain vlan-id
Syntax Description vlan-id The number of the VLAN to be used in this bridging configuration. The valid range is
from 2 to 4094.
access (Optional) Enables bridging access mode, in which the bridged connection does not
transmit or act upon bridge protocol data unit (BPDU) packets.
dot1q (Optional) Enables Institute of Electrical and Electronic Engineers (IEEE) 802.1Q
tagging to preserve the class of service (CoS) information from the Ethernet frames
across the ATM network. If this keyword is not specified, the ingress side assumes a
CoS value of 0 for quality of service (QoS) purposes.
tag (Optional--ATM PVCs only) Specifies the 802.1Q value in the range 1 to 4095. You
can specify up to 32 bridge-domain command entries using dot1qtag for a single PVC.
The highest tag value in a group of bridge-domain commands must be greater than the
first tag entered (but no more than 32 greater).
dot1q-tunnel (Optional) Enables IEEE 802.1Q tunneling mode, so that service providers can use a
single VLAN to support customers who have multiple VLANs, while preserving customer
VLAN IDs and segregating traffic in different customer VLANs.
broadcast (Optional) Enables bridging broadcast mode on this PVC. This option is not supported
for multipoint bridging. Support for this option was removed in Cisco IOS Release
12.2(18)SXF2 and Cisco IOS Release 12.2(33)SRA.
ignore-bpdu-pid (Optional for ATM interfaces only) Ignores BPDU protocol identifiers (PIDs) and treats
all BPDU packets as data packets to allow interoperation with ATM customer premises
equipment (CPE) devices that do not distinguish BPDU packets from data packets.
pvst-tlv (Optional) When the router or switch is transmitting, translates Per-VLAN Spanning
Tree Plus (PVST+) BPDUs into IEEE BPDUs.
When the router or switch is receiving, translates IEEE BPDUs into PVST+ BPDUs.
CE-vlan Customer-edge VLAN in the Shared Spanning Tree Protocol (SSTP) tag-length-value
(TLV) to be inserted in an IEEE BPDU to a PVST+ BPDU conversion.
increment (PVC range configuration mode only) (Optional) Increments the bridge domain number
for each PVC in the range.
Cisco IOS Interface and Hardware Component Command Reference
95
A through B
bridge-domain
lan-fcs (Optional) Specifies that the VLAN bridging should preserve the Ethernet LAN frame
checksum (FCS) of the Ethernet frames across the ATM network.
Note This option applies only to routers using a FlexWAN module. Support for
this option was removed in Cisco IOS Release 12.2(18)SXF2 and Cisco IOS
Release 12.2(33)SRA.
split-horizon (Optional) Enables RFC 1483 split horizon mode to globally prevent bridging between
PVCs in the same VLAN.
Command Default Bridging is disabled.
Command Modes Frame Relay DLCI configuration (config-fr-dlci) Interface configuration (config-if)--Only the dot1q and
dot1q-tunnel keywords are supported in interface configuration mode. Interface ATM VC configuration
(config-if-atm-vc) PVC range configuration (config-if-atm-range)
Command History Release Modification
12.1(13)E This command was introduced as the bridge-vlan command for the 2-port OC-12 ATM
WAN Optical Services Modules (OSMs) on Cisco 7600 series routers and Catalyst 6500
series switches.
12.1(12c)E This command was integrated into Cisco IOS Release 12.1(12c)E.
12.1(14)E1 This command was integrated into Cisco IOS Release 12.1(14)E1. The dot1q-tunnel keyword
was added.
12.2(14)SX This command was integrated into Cisco IOS Release 12.2(14)SX. The dot1q-tunnel keyword
is not supported in this release.
12.1(19)E The split-horizon keyword was added.
12.2(18)S This command was integrated into Cisco IOS Release 12.2(18)S. The dot1q-tunnel and
split-horizon keywords are supported in this release.
12.2(17a)SX Support was added for the dot1q-tunnel keyword in Cisco IOS Release 12.2(17a)SX.
12.2(18)SXE This command was renamed from bridge-vlan to bridge-domain. The access, broadcast,
ignore-bpdu-pid, and increment keywords were added.
12.2(18)SXF2 Support for the lan-fcs and broadcastkeywords was removed. The ignore-bpdu-pidand
pvst-tlvkeywords were added.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines RFC 1483 bridging on ATM interfaces supports the point-to-point bridging of Layer 2 packet data units
(PDUs) over Ethernet networks. RFC 1490 Frame Relay bridging on Packet over SONET (POS) or serial
interfaces that are configured for Frame Relay encapsulation provides bridging of Frame Relay packets over
Ethernet networks.
Cisco IOS Interface and Hardware Component Command Reference
96
A through B
bridge-domain
The Cisco 7600 router can transmit BPDUs with a PID of either 0x00-0E or 0x00-07. When the router connects
to a device that is fully compliant with RFC 1483 Appendix B, in which the IEEE BPDUs are sent and received
by the other device using a PID of 0x00-0E, you must not use the ignore-bpdu-pidkeyword.
If you do not enter the ignore-bpdu-pid keyword, the PVC between the devices operates in compliance with
RFC 1483 Appendix B. This is referred to as strict mode . Entering the ignore-bpdu-pid keyword creates
loose mode . Both modes are described as follows:
• Without the ignore-bpdu-pidkeyword, in strict mode, IEEE BPDUs are sent out using a PID of 0x00-0E,
which complies with RFC 1483.
• With the ignore-bpdu-pidkeyword, in loose mode, IEEE BPDUs are sent out using a PID of 0x00-07,
which is normally reserved for RFC 1483 data.
Cisco-proprietary PVST+ BPDUs are always sent out on data frames using a PID of 0x00-07, regardless of
whether you enter the ignore-bpdu-pid keyword.
Use the ignore-bpdu-pid keyword when connecting to devices such as ATM digital subscriber line (DSL)
modems that send PVST (or 802.1D) BPDUs with a PID of 0x00-07.
The pvst-tlv keyword enables BPDU translation when the router interoperates with devices that understand
only PVST or IEEE Spanning Tree Protocol. Because the Catalyst 6500 series switch ATM modules support
PVST+ only, you must use the pvst-tlv keyword when connecting to a Catalyst 5000 family switch that
understands only PVST on its ATM modules, or when connecting with other Cisco IOS routers that understand
IEEE format only.
When the router or switch is transmitting, the pvst-tlv keyword translates PVST+ BPDUs into IEEE BPDUs.
When the router or switch is receiving, the pvst-tlv keyword translates IEEE BPDUs into PVST+ BPDUs.
Note The bridge-domainand bre-connect commands are mutually exclusive. You cannot use both commands on
the same PVC for concurrent RFC 1483 and BRE bridging.
To preserve class of service (CoS) information across the ATM network, use the dot1q option. This
configuration uses IEEE 802.1Q tagging to preserve the VLAN ID and packet headers as they are transported
across the ATM network.
To enable service providers to use a single VLAN to support customers that have multiple VLANs, while
preserving customer VLAN IDs and segregating traffic in different customer VLANs, use the dot1q-tunnel
option on the service provider router. Then use the dot1q option on the customer routers.
Note The access, dot1q, and dot1q-tunnel options are mutually exclusive. If you do not specify any of these
options, the connection operates in “raw” bridging access mode, which is similar to access, except that the
connection does act on and transmit BPDU packets.
RFC 1483 bridging is supported on AAL5-MUX and AAL5-LLC Subnetwork Access Protocol (SNAP)
encapsulated PVCs. RFC-1483 bridged PVCs must terminate on the ATM interface, and the bridged traffic
must be forwarded over an Ethernet interface, unless the split-horizon option is used, which allows bridging
of traffic across bridged PVCs.
Cisco IOS Interface and Hardware Component Command Reference
97
A through B
bridge-domain
Note RFC 1483 bridging is not supported for switched virtual circuits (SVCs). It also cannot be configured for
PVCs on the main interface.
In interface configuration mode, only the dot1q and dot1q-tunnel keyword options are supported.
Examples The following example shows a PVC being configured for IEEE 802.1Q VLAN bridging using a
VLAN ID of 99:
Router# configure terminal
Router(config)# interface ATM6/2
Router(config-if)# pvc 2/101
Router(config-if-atm-vc)# bridge-domain 99 dot1q
Router(config-if-atm-vc)# end
The following example shows how to enable BPDU translation when a Catalyst 6500 series switch
is connected to a device that understands only IEEE BPDUs in an RFC 1483-compliant topology:
Router(config-if-atm-vc)# bridge-domain
100 pvst-tlv 150
The ignore-bpdu-pid keyword is not used because the device operates in an RFC 1483-compliant
topology for IEEE BPDUs.
The following example shows how to enable BPDU translation when a Catalyst 5500 ATM module
is a device that understands only PVST BPDUs in a non-RFC1483-compliant topology. When a
Catalyst 6500 series switch is connected to a Catalyst 5500 ATM module, you must enter both
keywords.
Router(config-if-atm-vc)# bridge-domain
100 ignore-bpdu-pid pvst-tlv 150
To enable BPDU translation for the Layer 2 Protocol Tunneling ( L2PT) topologies, use the following
command:
Router(config-if-atm-vc)# bridge-domain
100 dot1q-tunnel ignore-bpdu-pid pvst-tlv 150
The following example shows a range of PVCs being configured, with the bridge domain number
being incremented for each PVC in the range:
Router(config)# interface atm 8/0.100
Router(config-if)# range pvc 102/100 102/199
Router(config-if-atm-range)# bridge-domain 102 increment
Related Commands Command Description
bre-connect Enables the BRE over a PVC or SVC.
Cisco IOS Interface and Hardware Component Command Reference
98
A through B
bridge-domain
Command Description
show atm pvc Displays the configuration of a particular PVC.
Cisco IOS Interface and Hardware Component Command Reference
99
A through B
bridge-domain (subinterface)
bridge-domain (subinterface)
To enable bridging across Gigabit Ethernet subinterfaces, use the bridge-domaincommand in subinterface
configuration mode. To disable bridging, use the no form of this command.
bridge-domain vlan-id {dot1q|dot1q-tunnel} [bpdu {drop|transparent}] [split-horizon]
no bridge-domain vlan-id {dot1q|dot1q-tunnel} [bpdu {drop|transparent}] [split-horizon]
Syntax Description vlan-id Specifies the number of the virtual LAN (VLAN) to be used in this bridging
configuration. The valid range is from 2 to 4094.
dot1q Enables IEEE 802.1Q tagging to preserve the class of service (CoS) information
from the Ethernet frames across the ATM network. If not specified, the ingress
side assumes a CoS value of 0 for QoS purposes.
dot1q-tunnel Enables IEEE 802.1Q tunneling mode, so that service providers can use a single
VLAN to support customers who have multiple VLANs, while preserving customer
VLAN IDs and keeping traffic in different customer VLANs segregated.
bpdu {drop | (Optional) Specifies whether or not BPDUs are processed or dropped:
transparent}
• drop --Specifies that BPDU packets are dropped on the subinterface.
• transparent --Specifies that BPDU packets are forwarded as data on the
subinterface, but not processed.
split-horizon (Optional) Enables RFC 1483 split horizon mode to globally prevent bridging
between PVCs in the same VLAN.
Command Default Bridging is disabled.
Command Modes Subinterface configuration (config-subif)
Command History Release Modification
12.2(33)SRA This command was introduced.
Usage Guidelines This command has the following restrictions in Cisco IOS Release 12.2(33)SRA:
• The command is available on the Cisco 7600 SIP-400 with a 2-Port Gigabit Ethernet SPA only.
• You can place up to 120 subinterfaces in the same bridge domain on a single Cisco 7600 SIP-400.
To enable service providers to use a single VLAN to support customers who have multiple VLANs, while
preserving customer VLAN IDs and keeping traffic in different customer VLANs segregated, use the
dot1q-tunnel option on the service provider router. Then use the dot1q option on the customer routers.
Examples The following example shows configuration of IEEE 802.1Q encapsulation for VLANs on Gigabit
Ethernet subinterfaces with configuration of multipoint bridging (MPB). The MPB feature requires
configuration of 802.1Q encapsulation on the subinterface.
Cisco IOS Interface and Hardware Component Command Reference
100
A through B
bridge-domain (subinterface)
The first subinterface bridges traffic on VLAN 100 and preserves CoS information in the packets by
specifying the dot1q keyword.
Router(config)# interface GigabitEthernet 1/0/1.1
Router(config-subif)# encapsulation dot1q 10
Router(config-subif)# bridge-domain 100 dot1q
The second subinterface shows bridging of traffic on VLAN 200 in tunneling mode using the
dot1q-tunnel keyword, which preserves the VLAN IDs of the bridged traffic.
Router(config)# interface GigabitEthernet 2/0/2.2
Router(config-subif)# encapsulation dot1q 20
Router(config-subif)# bridge-domain 200 dot1q-tunnel
The following example shows bridging of traffic from different VLANs on two separate Gigabit
Ethernet subinterfaces into the same VLAN. First, the bridging VLAN 100 is created using the vlan
command. Then, the Gigabit Ethernet subinterfaces implement IEEE 802.1Q encapsulation on VLAN
10 and VLAN 20 and bridge the traffic from those VLANs onto VLAN 100 using the bridge-domain
command:
Router(config)# vlan 100
Router(config-vlan)# exit
!
Router(config)# interface GigabitEthernet 1/0/1.1
Router(config-subif)# encapsulation dot1q 10
Router(config-subif)# bridge-domain 100 dot1q
Router(config-subif)# exit
!
Router(config)# interface GigabitEthernet 1/0/2.1
Router(config-subif)# encapsulation dot1q 20
Router(config-subif)# bridge-domain 100 dot1q
Related Commands Command Description
encapsulation dot1q Enables IEEE 802.1Q encapsulation of traffic on a specified subinterface in a VLAN.
vlan Adds the specified VLAN IDs to the VLAN database and enters VLAN configuration
mode.
Cisco IOS Interface and Hardware Component Command Reference
101
A through B
bridge-domain (subinterface)
Cisco IOS Interface and Hardware Component Command Reference
102
cable bundle through clock mode
• cable bundle, on page 105
• cable helper-address, on page 107
• cablelength, on page 108
• cablelength (E1 controller), on page 110
• cablelength long, on page 111
• cablelength short, on page 114
• card, on page 116
• card type (T1-E1), on page 126
• card type (T3-E3), on page 128
• card-protection, on page 131
• carrier-delay, on page 133
• cem, on page 137
• cem-group, on page 138
• channel-group, on page 141
• channel-group (interface), on page 146
• channel-protocol (interface), on page 151
• channelized, on page 152
• class cem, on page 154
• clear aim, on page 156
• clear cable-diagnostics tdr, on page 157
• clear catalyst6000 traffic-meter, on page 158
• clear cem, on page 159
• clear controller, on page 160
• clear controller lex, on page 161
• clear controller wanphy, on page 163
• clear controller vdsl, on page 165
• clear counters, on page 166
• clear debug platform condition all, on page 169
• clear diagnostic event-log, on page 170
• clear dsip tracing, on page 171
• clear facility-alarm, on page 172
• clear hub, on page 174
• clear hub counters, on page 175
Cisco IOS Interface and Hardware Component Command Reference
103
cable bundle through clock mode
• clear interface, on page 176
• clear interface cem, on page 181
• clear interface fastethernet, on page 182
• clear interface gigabitethernet, on page 184
• clear interface serial, on page 185
• clear interface vlan, on page 186
• clear ipc statistics, on page 187
• clear lacp counters, on page 189
• clear platform netint, on page 190
• clear platform software vnic-if-nvtable, on page 191
• clear rbscp, on page 192
• clear service-module serial, on page 194
• clear top counters interface report, on page 195
• clock, on page 196
• clock destination, on page 198
• clock mode, on page 199
Cisco IOS Interface and Hardware Component Command Reference
104
cable bundle through clock mode
cable bundle
cable bundle
To configure a cable interface to belong to an interface bundle, use the cablebundlecommand in
interfaceconfiguration mode. To delete a cable interface bundle definition, use the no form of this command.
cable bundle number [master]
no cable bundle number [master]
Syntax Description number Specifies the bundle identifier. Valid range is from 1 to 255.
master (Optional) Defines the specified interface as the master.
Command Default No cable interface bundle is defined.
Command Modes Interface configuration
Command History Release Modification
12.0(7)XR This command was introduced.
12.1(1a)T1 This command was integrated into Cisco IOS Release 12.1(1a)T1.
12.0(8)SC This command was integrated into Cisco IOS Release 12.0(8)SC
12.1(2)EC1 This command was integrated into Cisco IOS Release 12.1(2)EC1.
Usage Guidelines You can configure up to four interface bundles. In each bundle, specify one interface as the master interface
by using the optional master keyword.
Configure only an IP address on the master interface. If an IP address is configured and the interface is not
specified as the master interface, any attempt to add an interface to a bundle is rejected.
Specify all generic IP networking information (such as IP address, routing protocols, and switching modes)
on the bundle master interface. Do not specify generic IP networking information on bundle slave interfaces.
If you attempt to add an interface to a bundle as nonmaster interface and an IP address is assigned to this
interface, the command will fail. You must remove the IP address configuration before you can add the
interface to a bundle.
If you have configured an IP address on a bundled interface and the interface is not the master interface, a
warning message appears.
Specify generic (not downstream or upstream related) cable interface configurations, such as source-verify
or Address Resolution Protocol (ARP) handling, on the master interface. Do not specify generic configuration
on nonmaster interfaces.
If you configure an interface as a part of a bundle and it is not the master interface, all generic cable
configuration for this interface is removed. The master interface configuration will then apply to all interfaces
in the bundle.
If you shut down or remove the master interface in a bundle, no data packets are sent to any of the interfaces
in this bundle. Packets are still physically received from nonmaster interfaces that have not been shut down,
but those packets will be discarded. Modems connected to those interfaces will not be disconnected immediately,
Cisco IOS Interface and Hardware Component Command Reference
105
cable bundle through clock mode
cable bundle
but modems going online will not be able to obtain an IP address, download their configuration file, or renew
their IP address assignment if the Dynamic Host Configuration Protocol (DHCP) lease expires.
If you shut down a slave interface, only this shut down interface is affected.
Examples The following example shows how to configure interface 25 to be the master interface:
Router(config-if)# cable bundle 25 master
Router(config-if)#
07:28:17: %UBR7200-5-UPDOWN: Interface Cable3/0 Port U0, changed state to down
07:28:18: %UBR7200-5-UPDOWN: Interface Cable3/0 Port U0, changed state to up
The following example shows the error message that appears if you try to configure an interface with
an IP address that is not the master interface:
Router(config-if)# cable bundle 5
Please remove ip address config first then reenter this command
Related Commands Command Description
show cable bundle Displays the forwarding table for the specified interface bundle.
Cisco IOS Interface and Hardware Component Command Reference
106
cable bundle through clock mode
cable helper-address
cable helper-address
To specify a destination address for User Datagram Protocol (UDP) broadcast Dynamic Host Configuration
Protocol (DHCP) packets, use the cablehelper-addresscommand in interface configuration mode. To remove
the specified destination address for UDP DHCP packets, use the no form of this command.
cable helper-address ip-address {cable-modem|host}
no cable helper-address ip-address {cable-modem|host}
Syntax Description ip-address The IP address of a DHCP server.
Based on whether you add the host or cable-modem keyword at the end of the
cablehelper-address command, it is the IP address of the multiple service operators (MSOs)
Cisco Network Registrar (CNR) server or the Internet service providers (ISPs) DHCP
server.
cable-modem Specifies that only cable modem UDP broadcasts are forwarded.
host Specifies that only host UDP broadcasts are forwarded.
Command Default This command is disabled by default.
Command Modes Interface configuration
Command History Release Modification
11.3NA This command was introduced.
12.3(14)T This command was integrated into Cisco IOS Release 12.3(14)T.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines If you specify a secondary interface address, the giaddr field in the DHCP requests will be sent to the primary
address for DHCP requests received from cable modems, and to the secondary IP address for DHCP requests
received from hosts.
Examples The following example shows how to forward UDP broadcasts from cable modems to the DHCP
server at 172.23.66.44:
Router(config-if)#
cable helper-address 172.23.66.44 cable-modem
The following example shows how to forward UDP broadcasts from hosts to the DHCP server at
172.23.66.44:
Router(config-if)# cable helper-address 172.23.66.44 host
Cisco IOS Interface and Hardware Component Command Reference
107
cable bundle through clock mode
cablelength
cablelength
To specify the distance of the cable from the routers to the network equipment, use the cablelength command
in controller configuration mode. To restore the default cable length, use the no form of this command.
cablelength feet
no cablelength
Syntax Description feet Number of feet in the range of 0 to 450.
Command Default 224 feet for a CT3IP interface processor and Clear Channel T3/E3 network module
49 feet for PA-T3 and PA-2T3 port adapters
450 feet for an interface cable between the near and far-end CSU/DSU device
Command Modes Controller configuration
Command History Release Modification
11.1CA This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and implemented on the
following platforms: Cisco 2650XM, Cisco 2651XM, Cisco 2691, Cisco 3660 series, Cisco
3725, and Cisco 3745 routers. Support for the Clear Channel T3/E3 network module was
added.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
12.2(31)SB This command was integrated into Cisco IOS Release 12.2(31)SB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines CT3IP Interface Processor and Clear Channel T3/E3 Network Module
The default cable length of 224 feet is used by the CT3IP interface processor and the Clear Channel T3/E3
network module.
PA-T3 and PA-2T3 Port Adapters
The default cable length of 49 feet is used by the PA-T3 and PA-2T3 port adapters.
Note Although you can specify a cable length from 0 to 450 feet, the hardware recognizes only two ranges: 0 to
49 and 50 to 450. For example, entering 35 feet uses the 0 to 49 range. If you later change the cable length to
40 feet, there is no change because 40 is still within the 0 to 49 range. However, if you change the cable length
to 50, the 50 to 450 range is used. The actual number you enter is stored in the configuration file.
Cisco IOS Interface and Hardware Component Command Reference
108
cable bundle through clock mode
cablelength
Cisco 1000 Series Router
The table below lists the cable length distances and their relationships to line buildout for E3 and T3 controllers
on Cisco 1000 Series Routers:
Table 2: Cable Length Distances and Line Buildout for E3/T3 Controllers
Interface Cable Length (Feet) Buildout
E3 0 to 244 No line buildout
E3 225 to 450 Line buildout
T3 0 to 299 No line buildout
T3 300 to 450 Line buildout
Note Although you can specify a cable length from 0 to 450 feet, the hardware recognizes only two ranges: 0 to
49 and 50 to 450. For example, entering 35 feet uses the 0 to 49 range. If you later change the cable length to
40 feet, there is no change because 40 is still within the 0 to 49 range. However, if you change the cable length
to 50, the 50 to 450 range is used. The actual number you enter is stored in the configuration file.
Examples
Cable Length to 300 Feet Example
The following example shows how to set the cable length for the router to 300 feet:
Router(config)#
controller t3 9/0/0
Router(config-controller)#
cablelength 300
Cisco 10000 Series Series Router Example
The following example sets the cable length to 120 feet:
Router(config)# controller dsx3 4/0/6
Router(config-controller)# cablelength 120
Related Commands Command Description
cablelength long Increases the pulse of a signal at the receiver and decreases the pulse from the transmitter
using pulse equalization and line buildout for a T1 cable.
cablelength short Sets a cable length of 655 feet or shorter for a DS1 link on the Cisco MC3810 or Cisco
2600 and Cisco 3600 series routers.
Cisco IOS Interface and Hardware Component Command Reference
109
cable bundle through clock mode
cablelength (E1 controller)
cablelength (E1 controller)
To fine-tune the pulse of a signal at the receiver for an E1 cable on a Cisco AS5300 or Cisco AS5400, use
the cablelength command in controller configuration mode. To restore the default receiver sensitivity, use
the no form of this command.
cablelength {custom gain-value [squelch-on]|long [squelch-on]|medium [squelch-on]|short
[squelch-on]}
no cablelength
Syntax Description custom Fine-tunes the receiver sensitivity for long-haul, medium-haul, and short-haul applications.
gain-value Custom gain value for the receiver in the range of 0x1 to 0x3F. These settings are mapped to
values in the range of 0 to -45 dB.
long Fine-tunes the receiver sensitivity for long-haul applications.
medium Fine-tunes the receiver sensitivity for medium-haul applications.
short Fine-tunes the receiver sensitivity for short-haul applications.
squelch-on (Optional) Enables squelch to improve the signal-to-noise ratio.
Command Default Default receiver sensitivity for E1 cables is applied.
Command Modes Controller configuration
Command History Release Modification
12.3(17) This command was introduced.
Usage Guidelines This command is supported on E1 controllers only.
Note The cable line pulse gain values are not dependent upon the E1 line being configured in balanced (120-ohm)
mode or unbalanced (75-ohm) mode.
Examples The following example shows how to fine-tune the receiver sensitivity for an E1 cable on a Cisco
AS5300 to support a long-haul configuration:
Router(config-controller)# cablelength long squelch-on
Cisco IOS Interface and Hardware Component Command Reference
110
cable bundle through clock mode
cablelength long
cablelength long
To increase the pulse of a signal at the receiver and to decrease the pulse from the transmitter using pulse
equalization and line build-out for a T1 cable, use the cablelengthlongcommand in controller configuration
or interface configuration mode. To return the pulse equalization and line build-out values to their default
settings, use the no form of this command.
cablelength long db-gain-value db-loss-value
no cablelength long
Syntax Description db-gain-value Number of decibels (dB) by which the receiver signal is increased. Use one of the following
values:
• gain26
• gain36
The default is 26 dB.
db-loss-value Number of decibels by which the transmit signal is decreased. Use one of the following
values:
• 0db
• -7.5db
• -15db
• -22.5db
The default is 0 dB.
Command Default db-gain-value : gain26 db-loss-value: 0db
Command Modes Controller configuration for the Cisco AS5800 and Cisco MC3810. Interface configuration for the Cisco 2600
and Cisco 3600 series routers.
Command History Release Modification
11.2 This command was introduced.
11.3 The following keywords were added: gain26, gain36, 0db,-7.5db,-15db,-22.5db.
12.0(5)XK This command was modified to include support as an ATM interface configuration command
for the Cisco 2600 and Cisco 3600 series routers and as a controller configuration command
for the Cisco AS5800 universal access server.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Cisco IOS Interface and Hardware Component Command Reference
111
cable bundle through clock mode
cablelength long
Usage Guidelines Cisco AS5800 and Cisco MC3810
Use this command for configuring the controller T1 interface on the Cisco AS5200 access server, on the Cisco
AS5800 universal access server, or on the Cisco MC3810 multiservice access concentrator. The cablelengthlong
command is used to configure DS1 links (meaning, to build CSU/DSU links) when the cable length is no
longer than 655 feet.
On the Cisco MC3810, this command is supported on T1 controllers only and applies to Voice over Frame
Relay, Voice over ATM, and Voice over HDLC.
Note On the Cisco MC3810, you cannot use the cablelengthlong command on a DSX-1 interface only. The
cablelengthlong command can be used only on CSU interfaces.
A pulse equalizer regenerates a signal that has been attenuated and filtered by a cable loss. Pulse equalization
does not produce a simple gain, but it filters the signal to compensate for complex cable loss. A gain26 receiver
gain compensates for a long cable length equivalent to 26 dB of loss, whereas a gain36 compensates for 36
dB of loss.
The lengthening or buildingout of a line is used to control far-end crosstalk. Line build-out attenuates the
stronger signal from the customer installation transmitter so that the transmitting and receiving signals have
similar amplitudes. A signal difference of less than 7.5 dB is ideal. Line build-out does not produce simple
flat loss (also known as resistive flat loss). Instead, it simulates a cable loss of 7.5 dB, 15 dB, or 22.5 dB so
that the resulting signal is handled properly by the receiving equalizer at the other end.
Cisco 2600 and Cisco 3600 Series Routers
This command is supported on T1 long-haul links only. If you enter the cablelengthlong command on a
DSX-1 (short-haul) interface, the command is rejected.
The transmit attenuation value is best obtained by experimentation. If the signal received by the far-end
equipment is too strong, reduce the transmit level by entering additional attenuation.
Examples
Cisco AS5800 and Cisco MC3810
The following example shows how to increase the receiver gain by 36 decibels and decreases the
transmitting pulse by 15 decibels for a long cable on a Cisco AS5800:
AS5800(config)# controller t1 0
AS5800(config-controller)# cablelength long gain36 -15db
The following example shows how to configure the cable length for controller T1 0 on a Cisco
MC3810 to a decibel pulse gain of 36 decibels and a decibel pulse rate of -22.5 decibels:
MC3810(config)# controller t1 0
MC3810(config-controller)# cablelength long gain36 -22.5db
Cisco 2600 and Cisco 3600 Series Routers
On a Cisco 2600 or Cisco 3600 series router, the following example shows how to specify a pulse
gain of 36 decibels and a decibel pulse rate of -7.5 decibels:
Cisco IOS Interface and Hardware Component Command Reference
112
cable bundle through clock mode
cablelength long
Router(config)#
interface atm 0/2
Router(config-if)#
cablelength long gain36 -7.5db
Related Commands Command Description
cablelength short Sets a cable length of 655 feet or shorter for a DS1 link.
Cisco IOS Interface and Hardware Component Command Reference
113
cable bundle through clock mode
cablelength short
cablelength short
To set a cable length of 655 feet or shorter for a DS1 link on the Cisco MC3810, Cisco 2600, Cisco NCS 4200
series, and Cisco 3600 series routers, use the cablelengthshort command in controller configuration or
interface configuration mode. To delete the cablelengthshort value, use the no form of this command.
cablelength short length
no cablelength short
Syntax Description length Specifies a cable length. Use one of the following values:
• 133 --Specifies a cable length from 0 to 133 feet.
• 266 --Specifies a cable length from 134 to 266 feet.
• 399 --Specifies a cable length from 267 to 399 feet.
• 533 --Specifies a cable length from 400 to 533 feet.
• 655 --Specifies a cable length from 534 to 655 feet.
Command Default The default is 133 feet for the Cisco AS5200 access server, Cisco AS5800 universal access server, and Cisco
MC3810 multiservice access concentrator.
There is no default cable length for the Cisco 2600 and Cisco 3600 series routers.
Command Modes Controller configuration for the Cisco AS5200 access server, Cisco AS5800 universal access server, and
Cisco MC3810 multiservice access concentrator. Interface configuration for the Cisco 2600 and Cisco 3600
series routers.
Command History Release Modification
11.3(2)AA This command was introduced.
12.0(5)XK This command was modified to include support as an ATM interface command for the Cisco
2600 and 3600 series routers and as a controller configuration command for the Cisco AS5800
universal access server.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
XE 3.18SP This command was integrated in the Cisco NCS 4200 Series. For Configuring MDL, by
default setting of cablelength is short.
Usage Guidelines Cisco AS5200 Access Server, Cisco AS5800 Universal Access Server, and Cisco MC3810 Multiservice
Access Concentrator
Cisco IOS Interface and Hardware Component Command Reference
114
cable bundle through clock mode
cablelength short
On the Cisco MC3810, the cablelengthshort command is used to configure DSX-1 links when the cable
length is 655 feet or less than 655 feet. On the Cisco MC3810, this command is supported on T1 controllers
only.
Note On the Cisco MC3810, you cannot enter the cablelengthshort command on a CSU interface. The
cablelengthshort command can be used only on DSX-1 interfaces.
Cisco 2600 and Cisco 3600 Series Routers
This command is supported on T1 short-haul links only. If you enter the cablelengthshort command on a
long-haul interface, the command is rejected.
To set cable lengths longer than 655 feet, use the cablelengthlong command.
This command is supported on T1 controllers only.
Cisco AS5200 Access Server, Cisco AS5800 Universal Access Server, and Cisco MC3810 Multiservice
Access Concentrator
The following example shows how to set the cable length to 266 for the T1 controller in slot 1 on dial shelf
0:
Router# configure terminal
Router(config)# controller t1 1/1/0
Router(config-controller)# cablelength short 266
Router(config-controller)# end
Cisco 2600 and Cisco 3600 Series Routers
On a Cisco 2600 or Cisco 3600 series router, the following example shows how to specify a cable length from
0 to 133 feet:
Router(config)#
interface atm 0/2
Router(config-if)#
cablelength short 133
Related Commands Command Description
cablelength long Increases the pulse of a signal at the receiver and decreases the pulse from the sender
using pulse equalization and line build-out.
Cisco IOS Interface and Hardware Component Command Reference
115
cable bundle through clock mode
card
card
To preprovision a router slot for an interface card, use the cardcommand in global configuration mode. To
remove the preprovisioning for a card, use the no form of this command.
card {slot/subslot|slot/subslot/bay} card-type
no card {slot/subslot|slot/subslot/bay} card-type
Cisco 10000 Series Router
card slot/subslot
{lchoc12-1l|gigethernet-l1| gigethernet-hh-1l|oc12atm-1l|oc12pos-11| oc48dpt-pos-12| 4che1t1-14| chstm-14| cht3-hh-14| oc3atm-14| oc3atm_lr-14| jacket-16| cht3-16| oc3pos-18| e3ds3-18| e3ds3atm-18| fastethernet-1
[mode {e1|t1}]spa-type}
no card slot/subslot
Cisco uBR10012 Universal Broadband Router
card {slot {2jacket-1|4jacket-1}|slot/subslot|slot/bay} card-type [license license]
no card {slot|slot/subslot|slot/bay} card-type [license license]
Syntax Description slot/subslot Chassis slot and subslot for the card. The following are the valid values:
• slot --1 to 8
• subslot --0 or 1
slot/subslot/bay Chassis slot and subslot for the Cisco Wideband SIP, and the bay number in the SIP
where the Cisco Wideband SPA is located. The following are the valid values:
• slot --1 to 3
• subslot --0 or 1 (0 is always specified)
• bay --0 (upper bay) or 1 (lower bay)
Note The Cisco uBR10012 router running Cisco IOS Release 12.3(21)BC supports
slot/subslot/bay option.
slot (Cisco uBR10012 router) Chassis slot for the Cisco SPA Interface Processor (SIP).
The valid value of the slotis1 or 3.
Cisco IOS Interface and Hardware Component Command Reference
116
cable bundle through clock mode
card
slot/subslot (Cisco uBR10012 router) Chassis slot and subslot where the Cisco Cable line card,
the Timing, Communication, and Control (TCC) card, Cisco Shared Port Adaptor
(SPA), or the Half-Height Gigabit Ethernet (HHGE) line card is located.
Note Effective with Cisco IOS Release 12.2(33)SCB, the SPA slot numbering is
changed to slot/subslot.
For the Cisco Cable line cards, the valid values are:
• slot --5 to 8
• subslot --0 or 1
For the TCC card, the valid values are:
• slot --1 or 2
• subslot --1
For the HHGE line card, the valid values are:
• slot --3 or 4
• subslot --0 or 1
For the SPA, the valid values are:
• slot --0 or 3 (for SIP-600)
• slot --1 (for Wideband SIP)
• subslot --0 to 3
slot/bay (Cisco uBR10012 router) Chassis slot and bay where the Cisco Shared Port Adaptor
(SPA) is located.
For the SPA, the valid values are:
• slot --1 or 3 (for SIP-600)
• slot --1 (for Wideband SIP)
• bay --0 to 3
license (Cisco uBR10012 router) License supported on the card. For a list of license types
supported on the card, see the second table below.
card-type Type of card for which to preprovision the slot. For a list of the supported cards, which
varies by platform, see the first table below.
lchoc12-1 Preprovisions a line card slot for a 1-Port Channelized OC-12/STM-4 line card.
lgigethernet-l Preprovisions a line card slot for a 1-Port Gigabit Ethernet line card.
1gigethernet-hh-1 Preprovisions a line card slot for a 1-Port Gigabit Ethernet Half-Height line card.
loc12atm-1 Preprovisions a line card slot for a 1-Port OC-12 ATM line card.
Cisco IOS Interface and Hardware Component Command Reference
117
cable bundle through clock mode
card
loc12pos-1 Preprovisions a line card slot for a 1-Port OC-12 Packet over SONET line card.
1oc48dpt-pos-1 Preprovisions a line card slot for a 1-Port OC-48/STM-16 Packet over SONET line
card.
2jacket-1 (Cisco uBR10012 router) Preprovisions a slot for the Cisco Wideband SPA Interface
Processor (SIP).
24che1t1-1 Preprovisions a line card slot for a 24-Port Channelized E1/T1 line card.
4chstm-1 Preprovisions a line card slot for a 4-Port Channelized OC-3/STM-1 line card.
4cht3-hh-1 Preprovisions a line card slot for a 4-port Channelized Half-Height line card.
4jacket-1 (Cisco uBR10012 router) Preprovisions a slot for the Cisco SIP-600.
4jacket-1 Preprovisions a line card slot in the Cisco 10000 series router to accept a Cisco 10000
SIP-600.
4oc3atm-1 Preprovisions a line card slot for a 4-Port OC-3/STM-1 ATM line card with
intermediate-reach optics.
4oc3atm_lr-1 Preprovisions a line card slot for a 4-Port OC-3/STM-1 ATM line card with long-reach
optics.
6cht3-1 Preprovisions a line card slot for a 6-Port Channelized T3 line card.
6oc3pos-1 Preprovisions a line card slot for a 6-Port OC-3/STM-1 Packet over SONET line card.
8e3ds3-1 Preprovisions a line card slot for an 8-Port Unchannelized E3/T3 line card.
8e3ds3atm-1 Preprovisions a line card slot for an 8-Port E3/DS3 ATM line card.
8fastethernet-1 Preprovisions a line card slot for an 8-Port Fast Ethernet Half-Height line card.
mode {e1|t1} Indicates the mode of operation of the 24-Port Channelized E1/T1 line card.
spa-type SPA type to preprovision a SPA interface.
Command Default An empty card slot is not preprovisioned and cannot be configured or displayed.
The default mode of operation for the 24-Port Channelized E1/T1 line card is E1.
Command Modes Global configuration (config)
Command History Release Modification
12.0(17)ST This command was introduced on the Cisco 10000 series routers.
12.0(21)SX This command was integrated into Cisco IOS Release 12.0(21)SX.
12.0(22)S This command was integrated into Cisco IOS Release 12.0(22)S.
Cisco IOS Interface and Hardware Component Command Reference
118
cable bundle through clock mode
card
Release Modification
12.2(1)XF1 This command was introduced on the Cisco uBR10012 Universal Broadband Router for the
following line cards:
• Cisco uBR-LCP-MC28C cable interface line card
• Cisco uBR-LCP-MC28C-BNC cable interface line card
• Cisco uBR10-1GE Gigabit Ethernet (GigE) uplink line card
• Cisco uBR10-1OC12/P-SMI OC-12 POS uplink line card
12.2(4)XF1 Support was added for the Cisco uBR-LCP-MC16C and Cisco uBR-LCP-MC16E cable
interface line cards.
12.2(4)BC1 Support was added for the Cisco uBR10-SRP-OC12SML DPT WAN uplink line card.
12.2(8)BC1 Support was added for the Cisco LCP2 line card processor, and all of its combinations with
the supported cable interface line cards.
12.2(11)BC3 Support was added for the Cisco uBR10012 OC-48 DPT/POS Interface Module uplink line
card and Cisco uBR-MC5X20S cable interface line card.
12.2(15)BX This command was integrated into Cisco IOS Release 12.2(15)BX.
12.2(15)CX1 Support was added for the Cisco uBR-MC16U/X and Cisco uBR-MC28U/X cable interface
line cards.
12.2(15)BC2 Support was added for the Cisco uBR-MC16U/X, Cisco uBR-MC28U/X, and Cisco
uBR-MC5X20U cable interface line cards.
12.2(28)SB This command was integrated into Cisco IOS Release 12.2(28)SB. This command was
modified to support the 4-port Channelized Half-Height line card and the 4-Port OC-3/STM-1
ATM line card with long-reach optics by adding the 4cht3-hh-1 and the 4oc3atm_lr-1
keywords.
12.3(7)XI1 This command was integrated into Cisco IOS Release 12.3(7)XI1.
12.3(21)BC Support was added for the Cisco Wideband SIP and Wideband SPA.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco
uBR7225VXR router was added.
12.2(33)SB This command was enhanced to provide the 4jacket-1 keyword and the spa-type option, which
enable you to preprovision a line card slot to accept a Cisco 10000 SIP-600 and a SPA
interface, respectively. This enhancement was implemented on the Cisco 10000 series router
for the PRE3 and PRE4.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB. Support for the Cisco
SIP-600 was added. This command was modified to change the addressing format for:
• SIPs--From slot/subslottoslot
• SPAs--From slot/subslot/baytoslot/bay
Cisco IOS Interface and Hardware Component Command Reference
119
cable bundle through clock mode
card
Release Modification
12.2(33)SCC This command was modified to support the Cisco UBR-MC20X20V cable interface line card.
12.2(33)SCE This command was modified to support the Cisco uBR-MC3GX60V cable interface line card.
12.2(33)SCH This command was modified to support the Cisco 3 Gbps Wideband SPA card.
Usage Guidelines This command is supported on the Cisco uBR10012 universal broadband router and the Cisco 10000 series
routers.
Use this command to preprovision a slot in the router to accept a particular line card, so that you can configure
the interface without the card being physically present in the chassis. This command allows system
administrators to plan for future configurations, without having to wait for the physical hardware to arrive.
When the line card does arrive, the installer can bring the card online by inserting the card into the chassis
and connecting the necessary cables, without having to do any further configuration using the command-line
interface.
The type of card must be appropriate for the slot being specified. The list of supported card types depends on
the Cisco IOS software release in use and your platform. For the latest information about supported hardware
for your platform, see the release notes that correspond to your Cisco IOS software release and platform.
The table below lists the types of cards that are supported as card-types for the card command.
Table 3: Card Types Supported by the card Command
Card Type Description
lchoc12-1 (Cisco 10000 series router) Preprovisions a line card slot for a 1-Port
Channelized OC-12/STM-4 line card.
1gigethernet-1 (Cisco 10000 series and Cisco uBR10012 routers) Preprovisions a slot for a
Cisco uBR10-1GE Gigabit Ethernet (GigE) uplink line card.
1gigethernet-hh-1 (Cisco 10000 series router and Cisco uBR10012 routers) Preprovisions a line
card slot for a 1-Port Gigabit Ethernet Half-Height line card.
loc12atm-1 (Cisco 10000 series router) Preprovisions a line card slot for a 1-Port OC-12
ATM line card.
1oc12pos-1 (Cisco 10000 series and Cisco uBR10012 routers) Preprovisions a slot for a
Cisco uBR10-1OC12/P-SMI OC-12 POS uplink line card.
1oc48dpt-pos-1 (Cisco 10000 series and Cisco uBR10012 routers) Preprovisions a slot for a
Cisco uBR10012 OC-48 DPT/POS Interface Module uplink line card.
2cable-tccplus (Cisco uBR10012 router) Preprovisions a slot for a Timing, Control, and
Communications Plus (TCC+) utility card.
Note This option is informational only, because slots 1/1 and 2/1 can
be used only for the TCC+ card.
24che1t1-1 (Cisco 10000 series router) Preprovisions a line card slot for a 24-Port
Channelized E1/T1 line card.
Cisco IOS Interface and Hardware Component Command Reference
120
cable bundle through clock mode
card
Card Type Description
2oc12srp-sm-lr (Cisco uBR10012 router) Preprovisions a slot for a Cisco
uBR10-SRP-OC12SML DPT WAN uplink line card.
24rfchannel-spa-1 (Cisco uBR10012 router) Preprovisions a bay in the Cisco Wideband SIP
for the Cisco 1-Gbps Wideband Shared Port Adapter (SPA).
4chstm-1 (Cisco 10000 series router) Preprovisions a line card slot for a 4-Port
Channelized OC-3/STM-1 line card.
4cht3-hh-1 (Cisco 10000 series router) Preprovisions a line card slot for a 4-port
Channelized Half-Height line card.
4oc3atm-1 (Cisco 10000 series router) Preprovisions a line card slot for a 4-Port
OC-3/STM-1 ATM line card with intermediate-reach optics.
4oc3atm_lr-1 (Cisco 10000 series router) Preprovisions a line card slot for a 4-Port
OC-3/STM-1 ATM line card with long-reach optics.
5cable-mc520h-d (Cisco uBR10012 router) Preprovisions a slot for a Cisco
uBR10-MC5X20H-D cable interface line card.
5cable-mc520s (Cisco uBR10012 router) Preprovisions a slot for a Cisco uBR10-MC5X20S
cable interface line card.
5cable-mc520s-d (Cisco uBR10012 router) Preprovisions a slot for a Cisco
uBR10-MC5X20S-D cable interface line card.
5cable-mc520u-d (Cisco uBR10012 router) Preprovisions a slot for a Cisco
uBR10-MC5X20U-D cable interface line card.
5cable-mc520u-f (Cisco uBR10012 router) Preprovisions a slot for a Cisco
uBR10-MC5X20U-F cable interface line card.
6cht3-1 (Cisco 10000 series router) Preprovisions a line card slot for a 6-Port
Channelized T3 line card.
6oc3pos-1 (Cisco 10000 series router) Preprovisions a line card slot for a 6-Port
OC-3/STM-1 Packet over SONET line card.
8e3ds3-1 (Cisco 10000 series router) Preprovisions a line card slot for an 8-Port
Unchannelized E3/T3 line card.
8e3ds3atm-1 (Cisco 10000 series router) Preprovisions a line card slot for an 8-Port E3/DS3
ATM line card.
8fastethernet-1 mode {e1 | (Cisco 10000 series router) Preprovisions a line card slot for an 8-Port Fast
t1} Ethernet Half-Height line card and optionally specifies its mode of operation.
E1 is the default.
ubr10k-clc-3g60 (Cisco uBR10012 router) Preprovisions a slot for a Cisco uBR-MC3GX60V
cable interface line card.
Cisco IOS Interface and Hardware Component Command Reference
121
cable bundle through clock mode
card
Card Type Description
ubr10k-clc-mc2020v (Cisco uBR10012 router) Preprovisions a slot for a Cisco UBR-MC20X20V
cable interface line card.
ubr10k-clc-5x20s (Cisco uBR10012 router) Preprovisions a slot for a Cisco uBR10-MC5X20S
cable interface line card.
SPA-DOCSIS-HD-V1 (Cisco uBR10012 router) Preprovisions a bay in the Cisco SIP-600 for the
{1x10GE | 3x1GE} Cisco 3 Gbps Wideband SPA card.
The license supported depends on the card being specified. The list of supported license types depends on the
Cisco IOS software release in use and your platform. For the latest information about supported hardware for
your platform, see the release notes that correspond to your Cisco IOS software release and platform.
The table below lists the license supported by a card.
Table 4: License Supported by a card
Card Type License Supported Description
Cisco 0X20 Zero downstream and 20 upstream
UBR-MC20X20V
10X20 10 downstream and 20 upstream
15X20 15 downstream and 20 upstream
20X20 20 downstream and 20 upstream
5X20 5 downstream and 20 upstream
invalid Invalid license
Cisco 0 to 72 Downstream license count
uBR-MC3GX60V
none No license
Cisco 3 Gbps none No license
Wideband SPA
0 to 71 Downstream license count
72 Downstream license count
Cisco uBR10012 Universal Broadband Router Usage Guidelines
On the Cisco uBR10012 router, you can use the card command to preprovision a router slot for a line card
or to preprovision one or more slots for a SPA interface processor (SIP), such as the Cisco Wideband SIP.
You can also use the card command to preprovision a SIP bay or subslot for a SPA, such as the Cisco Wideband
SPA or Cisco 3 Gbps Wideband SPA.
The Cisco uBR10012 universal broadband router has the following card slot requirements:
Note Slot 0/0 is an invalid value for this command.
Cisco IOS Interface and Hardware Component Command Reference
122
cable bundle through clock mode
card
• Slots 1/1 and 2/1 are reserved for TCC+ utility cards. A utility card and a SPA can co-exist on a Cisco
uBR10012 router with an index of 1/1.
• Slots 1/0 through 4/0 are reserved for network uplink line cards.
• Slots 1 and 3 can be used for SIPs. Each SIP occupies two physical slots in a Cisco uBR10012 router
(slot pair 1/2 or slot pair 3/4). Slot 1 is recommended for the Cisco Wideband SIP.
• Slot 5/0 through 8/1 are reserved for cable interface line cards.
Tip A preprovisioned card is displayed the same way as a card physically present in the chassis. Some show
commands might also list the preprovisioned card in their displays. In addition, using the card command does
not change the output of the ENTITY-MIB, which displays physically and logical components installed in
the router.
When a line card is inserted in the Cisco uBR10012 chassis, the router performs the following actions,
depending on whether the card slot is preprovisioned for the card:
• If the inserted line card matches the type of line card preprovisioned for the slot, the system applies the
preprovisioned configuration to the line card.
• If the line card slot was not preprovisioned, the system applies a basic configuration to the line card and
adds that configuration to the running configuration file.
• If the line card slot was preprovisioned for one type of line card, but another type of line card has been
inserted, the system replaces the preprovisioned configuration (in the running configuration file) with a
basic configuration for the line card that was actually inserted. The startup configuration file is not
changed.
Tip Use the showrunning-config|includecardcommand to display which slots, if any, are preprovisioned for a
particular card type.
The noversionofthecommand removes the preprovisioning information from the given card slot. This also
removes all configuration information for that card slot, as well as any information in the SNMP MIB database
about the card and its card slot.
Cisco 10000 Series Router Usage Guidelines
You must specify a line card slot and subslot, and the line card for which you want to preprovision the line
card slot.
If you insert a line card into a line card slot that has been preprovisioned for a different line card, the line card
will fail.
You can specify a mode of operation for the 24-Port Channelized E1/T1 line card. If you do not, the line card
operates in the E1 mode.
In Cisco IOS releases earlier than 12.0(28)S, 12.2(16)BX, and 12.3(7)XI1, you used only the card command
to change the provisioning of a line card slot. It was not necessary to remove the old line card before using
the card command to change the line card provisioning.
Cisco IOS Interface and Hardware Component Command Reference
123
cable bundle through clock mode
card
In Cisco IOS releases after 12.0(28)S, 12.2(16)BX, and 12.3(7)XI1, you must deactivate the installed line
card using the hw-module and no card commands before using the card command to provision the line card
slot for a different line card. This is a general best practice when using the card command.
Examples
Cisco uBR10012 Universal Broadband Router Examples
The following example shows a list of supported card types, and then shows that slot 8/0 is being
preprovisioned for a Cisco uBR10-MC5X20S cable interface line card. The cable interface for slot
8/0/0 can then be configured.
Router# config t
Router(config)# card 8/0 ?
5cable-mc520h-d create a uBR10000 line card with MC520H-D
5cable-mc520s create a uBR10000 line card with MC520S
5cable-mc520s-d create a uBR10000 line card with MC520S-D
5cable-mc520u-d create a uBR10000 line card with MC520U-D
5cable-mc520u-f create a uBR10000 line card with MC520U
ubr10k-clc-3g60 create a uBR10000 line card with MC3Gx60
ubr10k-clc-5x20s create a uBR10000 line card with MC520S
ubr10k-clc-mc2020v create a uBR10000 line card with MC20x20
Router(config)# card 8/0
ubr10k-clc-5x20s
Router(config)# int c8/0/0
Router(config-if)#
The following example shows how to preprovision a Cisco Wideband SIP:
Router# configure terminal
Router(config)# card 1 2jacket-1
The following example shows how to preprovision a Cisco Wideband SPA on a Cisco Wideband
SIP:
Router# configure terminal
Router(config)# card 1/0 24rfchannel-spa-1
The following example shows how to preprovision a Cisco SIP-600:
Router# configure terminal
Router(config)# card 3 4jacket-1
The following example shows how to preprovision a Cisco Wideband SPA on a Cisco SIP-600:
Router# configure terminal
Router(config)# card 3/0 24rfchannel-spa-1
The following example shows how to preprovision a Cisco 3 Gbps Wideband SPA on a Cisco
SIP-600:
Router# configure terminal
Router(config)# card 1/0 SPA-DOCSIS-HD-V1 1x10GE license 1
Cisco IOS Interface and Hardware Component Command Reference
124
cable bundle through clock mode
card
Cisco 10000 Series Router Examples
The following example preprovisions line card slot 2 to accept a 24-Port Channelized E1/T1 line
card operating in E1 mode:
Router(config)# card 2/
0 24che1t1-1
mode e1
The following example shows how to change the provisioning for line card slot 5 from the 1-Port
Gigabit Ethernet Half-Height line card to the 4-Port OC-3/STM-1 ATM line card.
Router(config)# hw-module subslot 5/0 shut
Aug 22 21:52:19.619 UTC: %IPCOIR-3-TIMEOUT: Timeout waiting for a response from slot 5/0.
Aug 22 21:52:19.619 UTC: %IPCOIR-2-CARD_UP_DOWN: Card in slot 5/0 is down. Notifying
1gigethernet-hh-1 driver.
Aug 22 21:52:21.627 UTC: %LINK-3-UPDOWN: Interface GigabitEthernet5/0/0, changed state to
down
Aug 22 21:52:22.627 UTC: %LINEPROTO-5-UPDOWN: Line protocol on Interface GigabitEthernet5/0/0,
changed state to down
Router(config)# no card 5/0 1gigethernet-hh-1
Aug 22 21:53:20.008 UTC: %C10K-3-DEACTIVATED: card in slot [5/0] disabled.
Router(config)# card 5/0 4oc3atm-1
[ Remove the 1-Port Gigabit Ethernet Half-Height line card and
insert the 4-Port OC-3/STM-1 ATM line card ]
Related Commands Command Description
show interface Displays the current configuration and status for a specified interface type.
Cisco IOS Interface and Hardware Component Command Reference
125
cable bundle through clock mode
card type (T1-E1)
card type (T1-E1)
To configure a T1 or E1 card type, use the cardtype command in global configuration mode. To deselect the
card type on non-SPA platforms, use the no form of this command. The no form of this command is not
available on the SPA platforms.
card type {t1|e1} slot [bay]
no card type {t1|e1} slot [bay]
Channelized T1/E1 Shared Port Adapters
card type {t1|e1} slot subslot
Syntax Description t1 Specifies T1 connectivity of 1.544 Mbps through the telephone switching network, using AMI or
B8ZS coding.
e1 Specifies a wide-area digital transmission scheme used predominantly in Europe that carries data
at a rate of 2.048 Mbps.
slot Chassis slot number.
Refer to the appropriate hardware manual for slot information. For SIPs, refer to the
platform-specific SPA hardware installation guide or the corresponding "Identifying Slots and
Subslots for SIPs and SPAs" topic in the platform-specific SPA software configuration guide.
bay (Optional) Card interface bay number in a slot (route switch processor [RSP] platform only). This
option is not available on other platforms.
subslot (Channelized T/E1 Shared Port Adapters Only) Secondary slot number on a SPA interface processor
(SIP) where a SPA is installed.
Refer to the platform-specific SPA hardware installation guide and the corresponding "Specifying
the Interface Address on a SPA" topic in the platform-specific SPA software configuration guide
for subslot information.
Command Default No default behavior or values
Command Modes
Global configuration (config)
Command History Release Modification
12.0(5)XE This command was introduced.
12.0(7)T This command was integrated into Cisco IOS Release 12.0(7)T.
12.3(1) This command was integrated into Cisco IOS Release 12.3(1) and support was added for
Cisco 2610XM, Cisco 2611XM, Cisco 2620XM, Cisco 2621XM, Cisco 2650XM, Cisco
2651XM, Cisco 2691, Cisco 3631, Cisco 3660, Cisco 3725, and Cisco 3745 platforms.
12.2S This command was integrated into Cisco IOS Release 12.2S.
Cisco IOS Interface and Hardware Component Command Reference
126
cable bundle through clock mode
card type (T1-E1)
Release Modification
12.2(18)SXE This command was integrated into Cisco IOS Release 12.2(18)SXE to support SPAs on the
Cisco 7600 series routers and Catalyst 6500 series switches.
12.0(31)S This command was integrated into Cisco IOS Release 12.0(31)S to support SPAs on Cisco
12000 series routers.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
XE 3.18SP This command was integrated into Cisco NCS 4200 Series.
Usage Guidelines Changes made using this command on non-SPA platforms, do not take effect unless the reload command is
used or the router is rebooted.
Channelized T1/E1 Shared Port Adapters
There is no card type when the SPA is inserted for first time. The user must configure this command before
they can configure individual ports.
The no form of this command is not available on the SPA platforms. To change an existing card type on SPA
platforms, perform the following steps:
1. Remove the SPA from its subslot.
2. Save the configuration.
3. Reboot the router.
4. Insert the new SPA into the subslot.
5. Configure the new card using this command.
Examples The following example configures T1 data transmission on slot 1 of the router:
Router(config)# card type t1 1
The following example configures all ports of an 8-Port Channelized T1/E1 SPA, seated in slot 5,
subslot 2, in T1 mode:
Router(config)# card type t1 5 2
Related Commands Command Description
controller Configures a T1 or E1 controller and enters controller configuration mode.
reload Reloads the operating system.
show controller Displays the controller state that is specific to controller hardware
show interface serial Displays the serial interface type and other information.
Cisco IOS Interface and Hardware Component Command Reference
127
cable bundle through clock mode
card type (T3-E3)
card type (T3-E3)
To configure a T3 or E3 card type, use the cardtype command in global configuration mode. To deselect the
card type, use the no form of this comand. The no form of this command is not supported on the 2-Port and
4-Port Clear Channel T3/E3 SPA on Cisco 12000 series routers.
T3 or E3 Controllers
card type {t3|e3} slot
no card type {t3|e3} slot
Clear Channel T3/E3 Shared Port Adapters
card type {t3|e3} slot subslot
no card type {t3|e3} slot subslot
Clear Channel T3/E3 Shared Port Adapters on Cisco 12000 Series Routers
card type {t3|e3} slot subslot
Syntax Description t3 Specifies T3 connectivity of 44210 kbps through the network, using B8ZS coding.
e3 Specifies a wide-area digital transmission scheme used predominantly in Europe that carries data
at a rate of 34010 kbps.
slot Slot number of the interface.
subslot (Clear Channel T3/E3 Shared Port Adapters Only) Secondary slot number on a SIP where a SPA
is installed.
Refer to the platform-specific SPA hardware installation guide and the corresponding "Specifying
the Interface Address on a SPA" topic in the platform-specific SPA software configuration guide
for subslot information.
Command Default No default behavior or values.
Command Modes
Global configuration (config)
Command History Release Modification
12.1(1)T This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and implemented on the
following platforms: Cisco 2650XM, Cisco 2651XM, Cisco 2691, Cisco 3660 series, Cisco
3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
12.3(1) This command was integrated into Cisco IOS Release 12.3(1) and support was added for
Cisco 2610XM, Cisco 2611XM, Cisco 2620XM, Cisco 2621XM, Cisco 2650XM, Cisco
2651XM, Cisco 2691, Cisco 3631, Cisco 3660, Cisco 3725, and Cisco 3745 platforms.
12.2S This command was integrated into Cisco IOS Release 12.2S.
Cisco IOS Interface and Hardware Component Command Reference
128
cable bundle through clock mode
card type (T3-E3)
Release Modification
12.2(25)S3 This command was integrated into Cisco IOS Release 12.2(25)S3 to support SPAs on the
Cisco 7304 routers.
12.2(18)SXE This command was integrated into Cisco IOS Release 12.2(18)SXE to support SPAs on the
Cisco 7600 series routers and Catalyst 6500 series switches.
12.0(31)S This command was integrated into Cisco IOS Release 12.0(31)S to support SPAs on the Cisco
12000 series routers.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines Usage guidelines vary slightly from platform to platform as follows:
T3 or E3 Controllers
Once a card type is issued, you enter the nocardtype command and then another cardtype command to
configure a new card type. You must save the configuration to the NVRAM and reboot the router in order
for the new configuration to take effect.
When the router comes up, the software comes up with the new card type. Note that the software will reject
the configuration associated with the old controller and old interface. You must configure the new controller
and serial interface and save it.
Clear Channel T3/E3 Shared Port Adapters
To change all the SPA ports from T3 to E3, or vice versa, you enter the nocardtype command and then another
cardtype command to configure a new card type.
When the router comes up, the software comes up with the new card type. Note that the software will reject
the configuration associated with the old controller and old interface. You must configure the new controller
and serial interface and save it.
Clear Channel T3/E3 Shared Port Adapters on Cisco 12000 Series Routers
The no form of this command is not available on the 2-Port and 4-Port Clear Channel T3/E3 SPA on Cisco
12000 series routers. To change an existing card type on Cisco 12000 series routers, perform the following
steps:
1. Remove the SPA from its subslot.
2. Save the configuration.
3. Reboot the router.
4. Insert the new SPA into the subslot.
5. Configure the new card using this command.
Examples The following example shows T3 data transmission configured in slot 1:
Router(config)# card type t3 1
The following example configures all ports of 2-Port and 4-Port Clear Channel T3/E3 SPA, seated
in slot 5, subslot 2, in T3 mode:
Cisco IOS Interface and Hardware Component Command Reference
129
cable bundle through clock mode
card type (T3-E3)
Router(config)# card type t3 5 2
Related Commands Command Description
controller Configures a T3 or E3 controller and enters controller configuration mode.
reload Reloads the operating system.
show interface serial Displays the serial interface type and other information.
Cisco IOS Interface and Hardware Component Command Reference
130
cable bundle through clock mode
card-protection
card-protection
Use this command to configure card protection that protects traffic when the interface module is out of service,
there is any software failure, or any hardware issues.
Card Protection Creation Commands:
card-protection CPGN
card-protection {primary | backup}
card-protection revertive time
Card Protection Maintenance Commands:
card-protection CPGN [manual {primary | backup} | force {primary | backup} | lockout ]
Use no card-protection CPGN [manual {primary | backup} | force {primary | backup} | lockout] command
to remove the configuration.
Syntax Description Syntax Description:
CPGN The card protection number 1 to 16 refers to the Card
Protection Group Number (CPGN).
primary Configures the primary card in card protection.
backup Configures the backup card in card protection.
revertive time (Optional) Configures card protection in revertive mode.
The value ranges from 30 seconds to 720 seconds.
manual Configures manual switch on primary or backup card
in card protection.
Traffic switches to selected card if there is no fault
condition on that card.
force Configures force switch on primary or backup card
in card protection.
Traffic switches to selected card, even if there is a
fault on the card.
lockout Configures lockout on backup card in card protection.
Prevents card protection switching and forces traffic
to remain on the primary card.
Command Default None
Command Modes Global configuration
Cisco IOS Interface and Hardware Component Command Reference
131
cable bundle through clock mode
card-protection
Command History Release Modification
XE Everest This command was integarted into the Cisco NCS 4200 Series and Cisco ASR 900 Series.
16.7.1
Usage Guidelines For the manual option, traffic switches to selected card if there is no fault condition on that card. It has lower
priority than alarm and card failure. For the force option, traffic switches to selected card if there is fault
condition. It has higher priority than manual, alarms and card failure. For the lockout option, it prevents card
protection switching and forces traffic to remain on the primary card. The revertive time option has the lowest
priority.
Examples enable
configure terminal
card-protection [1-16]
primary slot 0 bay 0
backup slot 0 bay 5
end
card-protection 4
card-protection [manual {backup|primary} | force {backup|primary} | lockout]
end
Related Commands Command Description
show card-protection CPGN detail Verifies the card protection configuration.
Cisco IOS Interface and Hardware Component Command Reference
132
cable bundle through clock mode
carrier-delay
carrier-delay
To modify the default carrier delay time on a main physical interface, use the carrier-delay command in
interface configuration or template configuration mode. To return to the default carrier delay time, use the no
form of this command.
Conventional Carrier Delay
carrier-delay {seconds|msec milliseconds}
no carrier-delay
Asymmetric Carrier Delay for SIP-200- and SIP-400-Based WAN Cards on Cisco ASR 1000 Series
Aggregation Services Routers
carrier-delay [{up|down}] {seconds|msec milliseconds}
no carrier-delay [{up|down}]
Syntax Description seconds For Conventional Carrier Delay:
• Specifies the carrier transition delay, in seconds. The range is from 0 to 60. The
default is 2.
For Asymmetric Carrier Delay:
• In SIP-200- and SIP-400-based WAN cards, seconds indicate the unit use for
configuration.
msec milliseconds For Conventional Carrier Delay:
• Specifies the carrier transition delay, in milliseconds. The range is from 0 to
1000.
For Asymmetric Carrier Delay:
• In SIP-200- and SIP-400-based WAN cards, msec milliseconds indicate the
unit use for configuration.
up (Optional) Indicates that the carrier-delay configuration is for up link.
down (Optional) Indicates that the carrier-delay configuration is for down link
Command Default The default carrier delay (conventional) is 2 seconds.
Template configuration (config-template)
Command Modes Interface configuration (config-if)
Command History Release Modification
10.1 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Cisco IOS Interface and Hardware Component Command Reference
133
cable bundle through clock mode
carrier-delay
Release Modification
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in
a specific 12.2SX release of this train depends on your feature set, platform,
and platform hardware.
12.2(33)SRD This command was modified. The up and down keywords were added.
12.2(33)SXI This command was modified. Support for the up and down keywords was
added.
Cisco IOS XE Release 2.3 This command was modified. Support for Cisco ASR 1000 Series Aggregation
Services Routers was added.
15.2(2)E This command was integrated into Cisco IOS Release 15.2(2)E. This command
is supported in template configuration mode.
Cisco IOS XE Release 3.6E This command was integrated into Cisco IOS XE Release 3.6E. This command
is supported in template configuration mode.
Cisco IOS XE Fuji 16.8.x The up and down keywords were added to the no form of the command
Usage Guidelines The default carrier transition delay is 10 milliseconds on all Ethernet interfaces. This enables the carrier-delay
time to ensure fast link detection.
Conventional Carrier Delay
If a link goes down and comes back before the carrier delay timer expires, the down state is effectively filtered,
and the rest of the software on the router is not aware that a link-down event has occurred. Therefore, a large
carrier delay timer results in fewer link-up/link-down events being detected. However, setting the carrier delay
time to 0 means that every link-up/link-down event is detected.
In most environments a lower carrier delay is better than a higher one. The exact value that you choose depends
on the nature of the link outages that you expect in your network and how long you expect those outages to
last.
If data links in your network are subject to short outages, especially if those outages last less than the time
required for your IP routing to converge, you should set a relatively long carrier delay value to prevent these
short outages from causing disruptions in your routing tables. If outages in your network tend to be longer,
you might want to set a shorter carrier delay so that the outages are detected sooner and the IP route convergence
begins and ends sooner.
The following restrictions apply to carrier delay configuration:
• The Fast Link and Carrier Delay features are mutually exclusive. If you configure one feature on an
interface, the other is disabled automatically.
• Administrative shutdown of an interface will force an immediate link-down event regardless of the carrier
delay configuration.
Asymmetric Carrier Delay
Cisco IOS releases that support the up and down keywords allow asymmetric carrier delay (ACD) configuration.
ACD allows you to configure separate delay times for link-up and link-down event notification on physical
interfaces that support ACD, such as the SIP-200- and SIP-400-based interfaces. With ACD, link-up and
link-down events can be notified with different delay times.
Cisco IOS Interface and Hardware Component Command Reference
134
cable bundle through clock mode
carrier-delay
The following restrictions apply to ACD configurations:
• You cannot configure ACD on an interface if conventional carrier delay (the carrier-delay command
without an up or down keyword) is configured on the interface.
• Link-down and link-up carrier delay times are configured in milliseconds, using the msec keyword, or
in seconds.
Asymmetric carrier delay is supported by the following Ethernet Shared Port Adapters (SPA)s on Cisco ASR
1000 Series Aggregation Services Routers:
• SPA-1X10GE-L-V2
• SPA-2X1GE-V2
• SPA-4X1FE-TX-V2
• SPA-5X1GE-V2
• SPA-8X1GE-V2
• SPA-8X1FE-TX-V2
• SPA-10X1GE-V2
Examples The following example shows how to change the carrier delay to 5 seconds:
Router(config)# interface serial2/3/0
Router(config-if)# carrier-delay 5
The following example shows how to change the carrier delay to 5 seconds for an interface template:
Device# configure terminal
Device(config)# template user-template1
Device(config-template)# carrier-delay 5
Device(config-template)# end
Asymmetric Carrier Delay
The following example shows how to configure a carrier delay of 8 seconds for link-up transitions
and 50 milliseconds for link-down transitions:
Router(config)# interface GigabitEthernet2/0/0
Router(config-if)# carrier-delay up 8
Router(config-if)# carrier-delay down msec 50
The following example shows the output of the show interfaces command after the carrier-delay
command is configured on the Gigabit Ethernet interface:
Router# show interfaces GigabitEthernet 0/1/0
GigabitEthernet0/1/0 is up, line protocol is up
Hardware is SPA-8X1GE-V2, address is 001a.3046.9410 (bia 001a.3046.9410)
MTU 1500 bytes, BW 1000000 Kbit/sec, DLY 10 usec,
Cisco IOS Interface and Hardware Component Command Reference
135
cable bundle through clock mode
carrier-delay
reliability 255/255, txload ½55, rxload ½55
Encapsulation ARPA, loopback not set
Keepalive not supported
Full Duplex, 1000Mbps, link type is auto, media type is 1000BaseBX10U
output flow-control is on, input flow-control is on
Asymmetric Carrier-Delay Up Timer is 4 sec
Asymmetric Carrier-Delay Down Timer is 500 msec
ARP type: ARPA, ARP Timeout 04:00:00
Last input never, output never, output hang never
Last clearing of "show interface" counters never
Input queue: 0/375/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue: 0/40 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts (0 IP multicasts)
0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 watchdog, 0 multicast, 0 pause input
0 packets output, 0 bytes, 0 underruns
0 output errors, 0 collisions, 1 interface resets
0 unknown protocol drops
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier, 0 pause output
0 output buffer failures, 0 output buffers swapped out
Cisco IOS Interface and Hardware Component Command Reference
136
cable bundle through clock mode
cem
cem
To enter circuit emulation (CEM) configuration mode, use the cem command in global configuration mode.
cem slot/port/channel
Syntax Description slot Slot number in which the Circuit Emulation over IP (CEoIP) network module (NM) is installed
on the networking device.
/ port Port number on the CEoIP NM. The slash mark is required between the slot argument and the
port argument.
/ channel Channel number that identifies the channel that you want to configure (T1/E1 only). The channel
number on a serial port is always 0. The slash mark is required between the port argument and
the channel argument.
Command Default CEM configuration mode is not available.
Command Modes Global configuration
Command History Release Modification
12.3(7)T This command was introduced.
XE 3.18SP This command was integrated on Cisco NCS 4200 Series.
XE Everest This command was integrated on Cisco NCS 4200 Series and Cisco ASR 900 Series
16.5.1 Routers.
Usage Guidelines Use this command to enter CEM configuration mode to allow the configuration of all CEM options.
Examples The following example shows how to enter CEM configuration mode:
Router(config)# cem 1/2/0
Router(config-cem)#
Related Commands Command Description
clear cem Clears CEM statistics.
show cem Displays CEM statistics.
Cisco IOS Interface and Hardware Component Command Reference
137
cable bundle through clock mode
cem-group
cem-group
To create a circuit emulation (CEM) channel from one or more time slots of a T1 or E1 line of an
NM-CEM-4TE1 network module, use the cem-group command in controller configuration mode. To remove
a CEM group and release the associated time slots, use the no form of this command.
cem-group group-number {unframed|timeslots time-slot-range [speed kbps]}
no cem-group group-number
cem-group group-number framed
Syntax Description For NCS 4200 Series:
cem-group cem-group-number cep
group-number Channel number to be used for this group of time slots.
• For T1 ports, the range is from 0 to 23.
• For E1 ports, the range is from 0 to 30.
• For 4xC37.94 interface, only 0 group-number is supported.
unframed Specifies that a single CEM channel is being created including all time slots and the framing
structure of the line.
framed Specifies that a single CEM channel is being created including all the timeslots and framing
configured.
timeslots Specifies that a list of time slots is to be used as specified by the time-slot-range argument.
time-slot-range List of the time slots to be included in the CEM channel. The list may include commas
and hyphens with no spaces between the numbers.
The range of time slots supported for 4xC37.94 interface is from 1 to 12.
speed (Optional) Specifies the speed of the channels by specifying the number of kbps of each
time slot to be used. This keyword applies only to T1 channels.
kbps (Optional) Speed of the channel, in kbps. Must be one of the following:
• 56 --Specifies a speed of 56 kbps where only the seven most significant bits (MSBs)
of each eight-bit time slot are used.
• 64 --Specifies a speed of 64 kbps where all eight bits of each eight-bit time slot are
used.
cep Configures Circuit Emulation Service over Packet (CEP) mode.
Command Default No CEM groups are defined.
Command Modes Controller configuration
Cisco IOS Interface and Hardware Component Command Reference
138
cable bundle through clock mode
cem-group
Command History Release Modification
12.3(7)T This command was introduced.
15.1(2)SNH This command was implemented on the Cisco ASR 901 Series Aggregation Services
Routers.
XE 3.18 SP Support for this command was introduced on NCS 4200 Series.
XE Everest This command was implemented on the Cisco ASR 920 Routers and Cisco NCS 4200
16.5.1 Series.
XE Fuji 16.8.x The framed keyword was introduced for Cisco ASR 900 Routers and Cisco NCS 4200
Series Routrers.
Usage Guidelines Use this command to create CEM channels on the T1 or E1 network module, NM-CEM-4TE1. A maximum
of 64 channels may be created on an NM-CEM-4TE1.
Examples The following example shows how to create circuit emulation group number 0 with a single CEM
channel including all time slots and the framing structure of the line on an NM-CEM-4TE1.
Router(config-controller)# cem-group 0
unframed
The following example shows how to create circuit emulation channel number 6 with T1 channel
time slots one through four, nine, and ten using all eight bits of each time slot on an NM-CEM-4TE1.
Router(config-controller)# cem-group 6 timeslots 1-4,9,10
speed 64
Examples For NCS 4200 Series routers, the following example shows the configuration of CEP:
enable
configure terminal
controller Mediatype 0/5/0
controller sonet 0/5/0
sts-1 1
mode unframed
cem-group 100 cep
end
Examples For 4-Ports C37.94 interface module, the following example shows the configuration:
enable
configure terminal
controller c3794 0/0/0
timeslots3
end
Examples To configure framed SAToP:
Cisco IOS Interface and Hardware Component Command Reference
139
cable bundle through clock mode
cem-group
enable
configure terminal
controller mediatype 0/5/0
mode sonet
controller sonet 0/5/0
cem-group0 framed
end
Related Commands Command Description
cem Enters circuit emulation configuration mode.
show cem circuit Displays the CEM statistics for the configured CEM circuits.
Cisco IOS Interface and Hardware Component Command Reference
140
cable bundle through clock mode
channel-group
channel-group
To configure serial WAN on a T1 or E1 interface, use the channel-group command in controller configuration
mode. To clear a channel group, use the no form of this command.
Cisco 2600 Series
channel-group channel-group-number timeslots range [speed {56|64}] [aim aim-slot-number]
no channel-group channel-group-number
Cisco 2611 (Cisco Signaling Link Terminal [SLT])
channel-group channel-number
no channel-group channel-number
Cisco ASR 901 Series, Cisco 2600XM Series, Cisco 2691, Cisco 3631, Cisco 3660, Cisco 3725, and Cisco
3745
channel-group channel-group-number {timeslots range [speed {56|64}]|unframed} [aim
aim-slot-number]
no channel-group [channel-group-number timeslots range]
Cisco AS5350 and Cisco AS5400 Series
channel-group channel-group-number
no channel-group channel-group-number
Cisco MC3810
channel-group channel-number timeslots range [speed {56|64}]
no channel-group [channel-number timeslots range]
Syntax Description channel-group-number Channel-group number on the Cisco 2600 series, Cisco 2600XM, Cisco 2691, Cisco
3631, Cisco 3660, Cisco 3725, and Cisco 3745 routers. When a T1 data line is
configured, channel-group numbers can be values from 0 to 23. When an E1 data
line is configured, channel-group numbers can be values from 0 to 30.
Valid values can be 0 or 1 on the Cisco AS5350 and Cisco AS5400.
timeslots range Specifies one or more time slots separated by commas, and spaces or ranges of time
slots belonging to the channel group separated by a dash. The first time slot is
numbered 1.
• For a T1 controller, the time slots range from 1 to 24.
• For an E1 controller, the time slots range from 1 to 31.
You can specify a time slot range (for example, 1-29), individual time slots separated
by commas (for example 1, 3, 5), or a combination of the two (for example 1-14, 15,
17-31). See the "Examples" section for samples of different timeslot ranges.
Cisco IOS Interface and Hardware Component Command Reference
141
cable bundle through clock mode
channel-group
speed {56|64} (Optional) Specifies the speed of the underlying DS0s in kilobits per second. Valid
values are 56 and 64.
The default line speed when configuring a T1 controller is 56 kbps on the Cisco 2600
series, Cisco 2600XM series, Cisco 2691, Cisco 3631, Cisco 3660, Cisco 3725, Cisco
3745, and Cisco MC3810.
The default line speed when configuring an E1 controller is 64 kbps on the Cisco
2600 series, Cisco 2600XM series, Cisco 2691, Cisco 3631, Cisco 3660, Cisco 3725,
Cisco 3745, and Cisco MC3810.
The line speed controls real-time (VBR-RT) traffic shaping, and the maximum burst
size (MBS) is 255 cells.
aim (Optional) Directs HDLC traffic from the T1/E1 interface to the
aim-slot-number AIM-ATM-VOICE-30 digital signaling processor (DSP) card on the Cisco 2600
series, Cisco 2600XM series, Cisco 2691, Cisco 3631, Cisco 3660, Cisco 3725, and
Cisco 3745.
channel-number Number of the channel. Valid values can be 0 or 1 on the Cisco SLT (Cisco 2611).
unframed Specifies the use of all 32 time slots for data. None of the 32 time slots is used for
framing signals on the Cisco ASR 901 Series, Cisco 2600XM series, Cisco 2691,
Cisco 3631, Cisco 3660, Cisco 3725, and Cisco 3745. This keyword is applicable to
E1 only.
Command Default The T1/E1 line is connected to the Motorola MPC-860x processor serial communication controller (SCC) or
network module with two voice or WAN interface card (VIC or WIC) slots and 0/1/2 FastEthernet ports
DSCC4 by default on Cisco 2600 series, Cisco 2600XM, Cisco 2691, Cisco 3631, Cisco 3660, Cisco 3725,
and Cisco 3745 routers.
There is no default behavior or values on the Cisco SLT (Cisco 2611).
The serial interface object encapsulation is set to HDLC on a network access server (NAS) (Cisco AS5350
and Cisco AS5400 series routers).
The default line speed is 56 kbps when a T1 controller is configured on the Cisco 2600 series, Cisco 2600XM
series, Cisco 2691, Cisco 3631, Cisco 3660, Cisco 3725, Cisco 3745, and the Cisco MC3810.
The default line speed is 64 kbps when an E1 controller is configured on the Cisco 2600 series, Cisco 2600XM
series, Cisco 2691, Cisco 3631, Cisco 3660, Cisco 3725, Cisco 3745, and the Cisco MC3810.
Command Modes
Controller configuration (config-controller)
Command History Release Modification
11.3MA This command was introduced on the Cisco MC3810.
12.0 This command was integrated into Cisco IOS Release 12.0 on the Cisco MC3810.
12.0(7)XE This command was implemented on the Catalyst 6000 family switches.
12.1(1)E This command was integrated into Cisco IOS Release 12.1(1)E.
Cisco IOS Interface and Hardware Component Command Reference
142
cable bundle through clock mode
channel-group
Release Modification
12.1(1)T This command was modified to accommodate two channel groups on a port on 1- and 2-port
T1/E1 multiflex voice or WAN interface cards on the Cisco 2600 and Cisco 3600 series routers.
12.1(3a)E3 The number of valid values for the kbpsargument was changed on the Cisco MC3810; see the
"Usage Guidelines" section for valid values.
12.2(11)T This command was implemented on the Cisco AS5350 and Cisco AS5400.
12.2(15)T The aim keyword was added for use on the Cisco 2600 series (including the Cisco 2691), Cisco
2600XM, Cisco 3660, Cisco 3725, and Cisco 3745.
12.3(1) The unframed keyword was added for use on the Cisco 2600XM series, Cisco 2691, Cisco
3631, Cisco 3660, Cisco 3725, and Cisco 3745.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX
release of this train depends on your feature set, platform, and platform hardware.
15.4(3)S This command was implemented on the Cisco ASR 901 Series Aggregation Services Router.
Usage Guidelines Use this command to direct HDLC traffic from the T1/E1 interface to the AIM-ATM-VOICE-30 DSP card.
A channel group is created using Advanced Integration Module (AIM) HDLC resources when a channel-group
command with the aim keyword is parsed during system initialization or when the command is entered during
configuration. You must specify the aim keyword under a T1/E1 controller port to direct HDLC traffic from
the T1/E1 interface to the AIM-ATM-VOICE-30 DSP card on the Cisco 2600 series, Cisco 2600XM series,
Cisco 2691, Cisco 3631, Cisco 3660, Cisco 3725, and Cisco 3745.
Note Neither the Cisco AS5400 series NAS nor the Cisco MC3810 is supported with the integrated voice and data
WAN on T1/E1 interfaces using the AIM-ATM-VOICE-30 module.
If previous channel-group commands are configured with the aim keyword, subsequent channel-group
commands without the aim keyword are rejected. Similarly, if a regular channel-group command is followed
by another channel-group command with the aim keyword implemented, the second command is rejected
on the Cisco 2600 and Cisco 2600XM.
A channel group using AIM HDLC resources is deleted only when a nochannel-group command is entered.
By default, thechannel-group command on a NAS sets the serial interface object encapsulation to HDLC.
You must override the default by entering the encapsulationss7 command for that serial interface object.
Once you override the default, encapsulation cannot be changed again for that object. The SS7 encapsulation
option is new to the Integrated Signaling Link Terminal feature and is available only for interface serial objects
created by thechannel-group command. The Integrated Signaling Link Terminal feature added SLT
functionality on Cisco AS5350 and Cisco AS5400 platforms.
A digital SS7 link can be deleted by entering the nochannel-groupchannel-group-number command on the
associated T1/E1 controller. The link must first be stopped using the noshutdown command. It is not necessary
to remove the channel ID association first.
Use the channel-group command in configurations where the router or access server must communicate with
a T1 or E1 fractional data line. The channel group number may be arbitrarily assigned and must be unique
Cisco IOS Interface and Hardware Component Command Reference
143
cable bundle through clock mode
channel-group
for the controller. The time-slot range must match the time slots assigned to the channel group. The service
provider defines the time slots that comprise a channel group.
Note Channel groups, channel-associated signaling (CAS) voice groups, DS0 groups, and time-division multiplexing
(TDM) groups all use group numbers. All group numbers configured for channel groups, CAS voice groups,
and TDM groups must be unique on the local Cisco MC3810 concentrator. For example, you cannot use the
same group number for a channel group and for a TDM group. Furthermore, on the Cisco MC3810, only one
channel group can be configured on a controller.
The channel group number can be 0 or 1 on the Cisco SLT (Cisco 2611).
The channel-group command also applies to Voice over Frame Relay, Voice over ATM, and Voice over
HDLC on the Cisco MC3810.
Examples The following example shows basic configuration directing HDLC traffic from the T1/E1 interface
to the AIM-ATM-VOICE-30 DSP card, starting in global configuration mode:
Router(config)# controller e1 1/0
Router(config-controller)# clock source internal
Router(config-controller)# channel-group 0 timeslots 1-31 aim 0
The following example explicitly sets the encapsulation type to PPP to override the HDLC default:
Router# configure terminal
Router(config)# controller t1 6/0
Router(config-controller)# channel-group 2 timeslots 3 aim 0
Router(config-controller)# exit
Router(config)# interface serial 6/0:2
Router(config-if)# encapsulation ppp
Router(config-if)# ip address 10.0.0.1 255.0.0.0
Router(config-if)# no shutdown
Router(config-if)# end
The following example shows how to explicitly set the encapsulation type to SS7 to override the
HDLC default using the Integrated Signaling Link Terminal feature. This example uses an 8PRI
DFC card inserted into slot 7, and DS0-timeslot 3 on trunk 5 of that card is used as an SS7 link:
Router# configure terminal
Router(config)# controller t1 7/5
Router(config-controller)# channel-group 2 timeslots 3
Router(config-controller)# exit
Router(config)# interface serial 7/5:2
Router(config-if)# encapsulation ss7
Router(config-if)# channel-id 0
Router(config-if)# no shutdown
Router(config-if)# end
The following example defines three channel groups. Channel-group 0 consists of a single time slot,
channel-group 8 consists of seven time slots and runs at a speed of 64 kbps per time slot, and
channel-group 12 consists of two time slots.
Router(config-controller)# channel-group 0 timeslots 1
Router(config-controller)# channel-group 8 timeslots 5,7,12-15,20 speed 64
Router(config-controller)# channel-group 12 timeslots 2
Cisco IOS Interface and Hardware Component Command Reference
144
cable bundle through clock mode
channel-group
The following example configures a channel group on controller T1 0 on a Cisco MC3810:
Router(config)# controller T1 0
Router(config-controller)# channel-group 10 timeslots 10-64
The following example configures a channel group on controller E1 1 and specifies that all time slots
are used for data:
controller e1 1
channel-group 1 unframed
Note SS7 digital F-link support for the 8PRI line card requires use of a third onboard TDM stream to route
trunk DS0 messages to the onboard MGCs.
Related Commands Command Description
framing Specifies the frame type for the T1 or E1 data line.
invert data Enables channel inversion.
linecode Specifies the line code type for the T1 or E1 line.
voice-card Configures a card with voice processing resources and enters voice card configuration
mode.
encapsulation Sets the encapsulation type.
Cisco IOS Interface and Hardware Component Command Reference
145
cable bundle through clock mode
channel-group (interface)
channel-group (interface)
To assign and configure an EtherChannel interface to an EtherChannel group, use the channel-group command
in interface configuration mode. To remove the channel-group configuration from the interface, use the no
form of this command.
channel-group channel-group-number mode {active|on|passive}
no channel-group channel-group-number
Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers
channel-group channel-group-number mode on
no channel-group channel-group-number
Cisco ASR 1000 Series Routers
channel-group channel-group-number mode {active|passive}
no channel-group
Cisco Catalyst Switches
channel-group channel-group-number mode {active|on|auto [non-silent]|desirable [non-silent]|passive}
no channel-group channel-group-number
Syntax Description channel-group-number Integer that identifies the channel-group. Valid values are from 1 to 256; the
maximum number of integers that can be used is 64.
• For Fast EtherChannel groups, the number is an integer from 1 to 4. This
number is the one previously assigned to the port-channel interface.
• On the Cisco ASR 1000 series router, valid values are from 1 to 64.
mode Specifies the EtherChannel mode of the interface.
active Enables Link Aggregation Control Protocol (LACP) unconditionally.
on Enables EtherChannel only.
auto Places a port into a passive negotiating state in which the port responds to Port
Aggregation Protocol (PAgP) packets that it receives but does not initiate PAgP
packet negotiation.
non-silent (Optional) Used with the auto or desirable mode when traffic is expected from
the other device.
desirable Places a port into an active negotiating state in which the port initiates negotiations
with other ports by sending PAgP packets.
passive Enables LACP only when an LACP device is detected.
Command Default No channel groups are assigned.
Command Modes Interface configuration (config-if)
Cisco IOS Interface and Hardware Component Command Reference
146
cable bundle through clock mode
channel-group (interface)
Command History Release Modification
11.1CA This command was introduced.
12.0(7)XE Support for this command was implemented on Cisco Catalyst 6000 series
switches.
12.1(3a)E3 The number of valid values for the numberargumentwas changed; see the “Usage
Guidelines” section for valid values.
12.2(2)XT This command was implemented on the Cisco 2600 series, Cisco 3600 series,
and Cisco 3700 series routers.
12.2(8)T Support for this command was implemented on the Cisco 2600 series, the Cisco
3600 series, and the Cisco 3700 series routers and integrated into Cisco IOS
Release 12.2(8)T .
12.2(14)SX Support for this command was implemented on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was integrated into Cisco
IOS Release 12.2(17d)SXB.
12.2(18)SXE This command was changed to support advanced QinQ translation on QinQ link
bundles using GE-WAN interfaces on an OSM-2+4GE-WAN+ OSM on Cisco
7600 series routers.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2 This command was integrated into Cisco IOS Release 12.2(31)SB2.
12.2(33)SRB Support for this command on the Cisco 7600 router was integrated into Cisco
IOS Release 12.2(33)SRB.
Cisco IOS XE Release 2.4 This command was integrated into Cisco IOS XE Release 2.4.
Usage Guidelines OSMs are not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 32.
IP Address for the Physical Interface
You do not have to disable the IP address that is assigned to a physical interface that is part of a channel group,
but Cisco highly recommends doing so.
Layer 2 and Layer 3 Port Channels
You can create both Layer 2 and Layer 3 port channels by entering the interface port-channel command or,
when the channel-group gets its first physical interface assignment. The port channels are not created at run
time, nor are they created dynamically.
You do not have to create a port-channel interface before assigning a physical interface to a channel group.
A port-channel interface is automatically created when the channel group gets its first physical interface, if it
is not already created.
Propagation of Configuration and Attribute Changes
Cisco IOS Interface and Hardware Component Command Reference
147
cable bundle through clock mode
channel-group (interface)
Any configuration or attribute changes you make to the port-channel interface are propagated to all interfaces
within the same channel group as the port channel. (for example, configuration changes are also propagated
to the physical interfaces that are not part of the port-channel, but are part of the channel group.)
The on Keyword
When you use the on keyword, a usable EtherChannel exists only when a port group in on mode is connected
to another port group in the on mode.
Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers
You do not have to create a port-channel interface before assigning a physical interface to a channel group.
A port-channel interface is created automatically when the channel group gets its first physical interface, if it
is not already created.
Cisco ASR 1000 Series Routers
The Cisco ASR 1000 series router has the following prerequisites and restriction:
• A port-channel must be created before member links are assigned to it.
• IP addresses must be disabled on member links before those links can be included in a port-channel.
• Fast Ethernet interfaces are not supported.
Cisco Catalyst Switches
The number of valid values for numberdepends on the software release. For software releases prior to Cisco
IOS Release 12.1(3a)E3, valid values are from 1 to 256; for Cisco IOS Release 12.1(3a)E3, 12.1(3a)E4, and
12.1(4)E1, valid values are from 1 to 64. Cisco IOS Release 12.1 E and later releases support a maximum of
64 values ranging from 1 to 256.
The channel-group number is global and is shared between all the channeling protocols. If a specific channel
number is used for the PAgP-enabled interfaces of a channel group, that same channel number cannot be used
for configuring a channel that has LACP-enabled interfaces or vice versa.
Entering the auto or desirable keyword enables PAgP on the specified interface; the command will be rejected
if it is issued on an LACP-enabled interface.
The active and passive keywords are valid on PAgP-disabled interfaces only.
You can change the mode for an interface only if it is the only interface that is designated to the specified
channel group.
The on keyword forces the bundling of the interface on the channel without any negotiation.
You can manually configure a switch with PAgP on one side and LACP on the other side in the on mode.
With the on mode, a usable EtherChannel exists only when a port group in on mode is connected to another
port group in on mode.
If you enter the channel group command on an interface that is added to a channel with a different protocol
than the protocol you are entering, the command is rejected.
If the interface belongs to a channel, the no form of this command is rejected.
All ports in the same channel group must use the same protocol; you cannot run two protocols on one channel
group.
PAgP and LACP are not compatible; both ends of a channel must use the same protocol.
Cisco IOS Interface and Hardware Component Command Reference
148
cable bundle through clock mode
channel-group (interface)
You can change the protocol at any time, but this change causes all existing EtherChannels to reset to the
default channel mode for the new protocol.
Configure all ports in an EtherChannel to operate at the same speed and duplex mode (full duplex only for
LACP mode).
All ports in a channel must be on the same DFC-equipped module. You cannot configure any of the ports to
be on other modules.
On systems that are configured with nonfabric-enabled modules and fabric-enabled modules, you can bundle
ports across all modules, but those bundles cannot include a DFC-equipped module port.
You do not have to create a port-channel interface before assigning a physical interface to a channel group.
A port-channel interface is created automatically when the channel group gets its first physical interface, if it
is not already created.
You do not have to disable the IP address that is assigned to a physical interface that is part of a channel group,
but it is highly recommended.
You can create both Layer 2 and Layer 3 port channels by entering the interface port-channel command or
when the channel group gets its first physical interface assignment. The port channels are not created at runtime
or dynamically.
Any configuration or attribute changes that you make to the port-channel interface are propagated to all
interfaces within the same channel group as the port channel (for example, configuration changes are also
propagated to the physical interfaces that are not part of the port channel but are part of the channel group).
When configuring Layer 2 EtherChannels, you cannot put Layer 2 LAN ports into manually created port-channel
logical interfaces.
Only the on mode is supported when using this command with GE-WAN ports on the OSM-2+4GE-WAN+
OSM to create QinQ link bundles for advanced QinQ translation. Also, you cannot use the channel-group
command on GE-WAN interfaces if MPLS is configured. You must remove all IP, MPLS, and other Layer
3 configuration commands before using the channel-group command with GE-WAN interfaces.
Note The GE-WAN interfaces on an OSM-2+4GE-WAN+ OSM behave slightly differently than other interfaces
if you want to move the interface from one group to another. To move most other interfaces, you can enter
the channel-group command again to delete the interface from the old group and move it to the new group.
For GE-WAN ports, however, you must manually remove the interface from the group by entering the no
channel-group command before assigning it to a new group.
Caution Do not enable Layer 3 addresses on the physical EtherChannel interfaces. Assigning bridge groups on the
physical EtherChannel interfaces causes loops in your network.
For a complete list of guidelines, see the “Configuring EtherChannel” section of the Cisco 7600 Series Router
Cisco IOS Software Configuration Guide.
Fast EtherChannel
Before you assign a Fast Ethernet interface to a Fast EtherChannel group, you must first create a port-channel
interface. To create a port-channel interface, use the interface port-channel global configuration command.
Cisco IOS Interface and Hardware Component Command Reference
149
cable bundle through clock mode
channel-group (interface)
If the Fast Ethernet interface has an IP address assigned, you must disable it before adding the Fast Ethernet
interface to the Fast EtherChannel. To disable an existing IP address on the Fast Ethernet interface, use the
no ip addresscommand in interface configuration mode.
The Fast EtherChannel feature allows multiple Fast Ethernet point-to-point links to be bundled into one logical
link to provide bidirectional bandwidth of up to 800 Mbps. Fast EtherChannel can be configured between
Cisco 7500 series routers and Cisco 7000 series routers with the 7000 Series Route Switch Processor (RSP7000)
and 7000 Series Chassis Interface (RSP7000CI) or between a Cisco 7500 series router or a Cisco 7000 series
router with the RSP7000 and RSP700CI and a Cisco Catalyst 5000 switch.
A maximum of four Fast Ethernet interfaces can be added to a Fast EtherChannel group.
Caution The port-channel interface is the routed interface. Do not enable Layer 3 addresses on the physical Fast Ethernet
interfaces. Do not assign bridge groups on the physical Fast Ethernet interfaces because it creates loops. Also,
you must disable spanning tree.
To display information about the Fast EtherChannel, use the show interfaces port-channelEXEC command.
For more guidelines see the “Configuring EtherChannel” section of the Cisco 7600 Series Router Cisco IOS
Software Configuration Guide and the “Configuring EtherChannel” section of the Catalyst 6500 Series Switch
Cisco IOS Software Configuration Guide
Examples This example shows how to add EtherChannel interface 1/0 to the EtherChannel group that is specified
by port-channel 1:
Router(config-if)#
channel-group 1 mode on
Router(config-if)#
The following example shows how to add interface Fast Ethernet 1/0 to the Fast EtherChannel group
specified by port-channel 1:
Router(config)#
interface port-channel 1
Router(config-if)#
exit
Router(config)#
interface fastethernet 1/0
Router(config-if)#
channel-group 1
Related Commands Command Description
interface Creates a port-channel virtual interface and puts the CLI in interface
configuration mode when the port-channel keyword is used.
ip address Sets a primary or secondary IP address on an interface.
show etherchannel Displays the EtherChannel information for a channel.
show interfaces port-channel Displays traffic that is seen by a specific port channel.
Cisco IOS Interface and Hardware Component Command Reference
150
cable bundle through clock mode
channel-protocol (interface)
channel-protocol (interface)
To enable Port Aggretation Control Protocol (PAgP) or Link Aggregation Control Protocol (LACP) on an
interface to manage channeling, use thechannel-protocol command in interface configuration mode. Use the
no form of this command to deselect the protocol.
channel-protocol {lacp|pagp}
no channel-protocol
Syntax Description lacp Specifies LACP to manage channeling.
pagp Specifies PAgP to manage channeling.
Command Default pagp
Command Modes Interface configuration
Command History Release Modification
10.2 This command was introduced.
12.1(11b)EX Support for this command was introduced on the Catalyst 6500 series switches.
12.1(12c)EA1 Support for this command was introduced on the Catalyst 2900 series switches.
12.1(13)E Support for this command on the Catalyst 6500 series switches was extended to Cisco IOS
Release 12.1(13)E. This command was changed to support the use of the nochannel-protocol
command (without arguments) to deselect the protocol.
12.1(13)EW Support for this command was introduced on the Catalyst 4500 series switches.
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Cisco IOS Release
12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is valid on multiple interfaces (for example, Fast Ethernet) and routers and switches including
the Cisco 2900, 4500/4000, 6500/6000, and 7600 series.
Examples The following example shows how to set the lacp.
(config-if)# channel-protocol lacp
Cisco IOS Interface and Hardware Component Command Reference
151
cable bundle through clock mode
channelized
channelized
To configure the T3/E3 controller for channelized mode, use the channelized command in controller
configuration mode. To configure the T3/E3 controller for unchannelized mode, use theno form of this
command.
channelized
no channelized
Syntax Description This command has no arguments or keywords.
Command Default The T3 controller is channelized.
The E3 controller is channelized.
Maximum transmission unit (MTU) size is set to 1500.
MTU size is set to 4470.
Command Modes Controller configuration
Command History Release Modification
12.0(14)S This command was introduced.
12.1(5a)E This command was integrated into Cisco IOS Release 12.1(5a)E.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.
12.2(31)SB This command was integrated into Cisco IOS Release 12.2(31)SB.
XE 3.18SP This command was integrated into Cisco NCS 4200 Series.
XE Everest This command was integrated into Cisco NCS 4200 Series.
16.5.1
Usage Guidelines Use the no channelized controller configuration command to configure the T3/E3 controller for unchannelized
mode for Cisco NCS 4200 Series. When you configure the PA-MC-2T3+ port adapter on a Cisco 7500 series
router with the no channelized command, the MTU size is set to 4470. In channelized mode, the default MTU
size is 1500. The change in MTU sizes will cause a memory recarve and CBus complex to occur, disrupting
all traffic on the router for several minutes.
The following message will be displayed when commands initiate switching between channelized and
unchannelized modes on a Cisco 7500 series router:
Change to subrate mode will cause cbus complex reset. Proceed? [yes/no]:
Y
Type Y for “yes” at the end of the warning. At the prompt, type ^Z to exit. You will exit configuration mode
and enter unchannelized mode.
Cisco IOS Interface and Hardware Component Command Reference
152
cable bundle through clock mode
channelized
Caution The no channelized command removes all channel groups from a channelized T3 interface. If you have already
configured channel groups, use this command with caution.
Examples
Cisco 7500 Series Router
The following example shows how to configure unchannelized mode on a PA-MC-2T3+ port adapter
in slot 1 of a Versatile Interface Processor version 2 (VIP2) or VIP4 in a Cisco 7500 series router:
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# controller T3 1/1/0
Router(config-controller)# no channelized
Change to subrate mode will cause cbus complex reset. Proceed? [yes/no]:
Y
^Z
Cisco 10000 Series Router
The following example eliminates the T1 interfaces to create a full-rate T3 interface:
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# controller T3 2/0/0
Router(config-controller)# no channelized
Router(config-controller)# exit
Router(config)#
Cisco NCS 4200 Series
The following example shows how to configure channelized controller as T3 interface.
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# controller T3 0/4/40
Router(config-controller)# channelized
The following example shows how to configure channelized controller as E3 interface.
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# controller E3 0/4/40
Router(config-controller)# channelized mode e1
Cisco IOS Interface and Hardware Component Command Reference
153
cable bundle through clock mode
class cem
class cem
To configure CEM interface parameters in a class that is applied to CEM interfaces together, use the class
cem command in global configuration mode. This command works in the same manner for CEM interfaces
as the pseudowire-class command does for xconnect.
class cem class name
Syntax Description Syntax Description
class name The name of a CEM interface parameters class.
Command Default CEM configuration mode is not available.
Command Modes Global configuration
Command History Release Modification
XE 3.18 SP Support for this command was introduced on NCS 4200 Series.
XE Everest This command was integrated into the Cisco NCS 4200 Series and Cisco ASR 900 Series
16.5.1 Routers.
Usage Guidelines The class cem command allows you to configure CEM interface parameters in a class that is applied to CEM
interfaces together. A class cem command includes the following configuration settings:
• dejitter-buffer dejitter-in-ms
• idle-pattern 8-bit-idle-pattern
• payload-size payload-size-in-ms
Note The rtp-present command cannot be configured from class cem and has to be configured from the interface
for NCS 4200 Series routers.
Note You can improve the performance of packet reordering on TDM/PWE connections by using the increasing
the size of the dejitter buffer using the dejitter-buffer parameter.
Examples The following example shows how to enter CEM interface parameters:
enable
configure terminal
class cem mycemclass
payload-size 512
dejitter-buffer 10
idle-pattern 0x55
Cisco IOS Interface and Hardware Component Command Reference
154
cable bundle through clock mode
class cem
exit
interface cem 0/0
no ip address
cem 0
cem class mycemclass
xconnect 10.10.10.10 200 encapsulation mpls
exit
Related Commands Command Description
clear cem Clears CEM statistics.
show cem Displays CEM statistics.
Cisco IOS Interface and Hardware Component Command Reference
155
cable bundle through clock mode
clear aim
clear aim
To clear the data compression Advanced Interface Module (AIM) daughter card registers and reset the hardware,
use the clearaim command in privileged EXEC mode.
clear aim element-number
Syntax Description element-number Number of AIM slot. AIM slots begin with 0.
Command Modes Privileged EXEC
Command History Release Modification
12.0(1)T This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The clearaimcommand is used to reset the data compression AIM hardware. This command is used if the
compression Advanced Interface Module (CAIM) hardware becomes “stuck” or hangs for some reason. The
CAIM registers are cleared, and the hardware is reset upon execution. All compression history is lost when
the CAIM is reset.
This command is supported only on Cisco 2600 series routers.
Examples The following example shows how to use the clearaim command. This command will reset the
hardware, flushing the buffers and history for all compression tasks currently under operation:
Router# clear aim 0
Router#
1w0d: %CAIM-6-SHUTDOWN: CompressionAim0 shutting down
1w0d: %CAIM-6-STARTUP: CompressionAim0 starting up
Related Commands Command Description
show pas caim Displays the IDPROM contents for each AIM board in the Cisco 2600 series routers.
test aim eeprom Tests the data compression AIM after it is installed in a Cisco 2600 series router.
Cisco IOS Interface and Hardware Component Command Reference
156
cable bundle through clock mode
clear cable-diagnostics tdr
clear cable-diagnostics tdr
To clear a specific interface or clear all interfaces that support Time Domain Reflectometry (TDR), use the
clearcable-diagnosticstdrcommand in privileged EXEC mode.
clear cable-diagnostics tdr [interface interface interface-number]
Syntax Description interface interface (Optional) Specifies the interface type; possible valid values are ethernet,
fastethernetgigabitethernet, and tengigabitethernet. See the “Usage Guidelines”
section for additional valid values.
interface-number Module and port number; see the “Usage Guidelines” section for valid values.
Command Default This command has no default settings.
Command Modes Privileged EXEC
Command History Release Modification
12.2(17a)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The valid values for interface include thege-wan, atm, and pos keywords that are supported on Cisco 7600
series routers that are configured with a Supervisor Engine 2.
See the Release Notes for Cisco IOS Release 12.2 SX on the Catalyst 6500 and Cisco 7600 Supervisor Engine
720, Supervisor Engine 32, and Supervisor Engine 2 for the list of modules that support TDR
Examples This example shows how to clear a specific interface:
Router# clear cable-diagnostics tdr interface gigabitethernet 4/1
Router#
Related Commands Command Description
show cable-diagnostics tdr Displays the test results for the TDR cable diagnostics.
test cable-diagnostics Tests the condition of 10-Gigabit Ethernet links or copper cables on 48-port
10/100/1000 BASE-T modules.
Cisco IOS Interface and Hardware Component Command Reference
157
cable bundle through clock mode
clear catalyst6000 traffic-meter
clear catalyst6000 traffic-meter
To clear the traffic meter counters, use the clear catalyst6000 traffic-metercommand in privileged EXEC
mode.
clear catalyst6000 traffic-meter
Syntax Description This command has no arguments or keywords.
Command Default This command has no default settings.
Command Modes Privileged EXEC
Command History Release Modification
12.2(17a)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Examples This example shows how to clear the traffic meter counters:
Router# clear catalyst6000 traffic-meter
Router#
Cisco IOS Interface and Hardware Component Command Reference
158
cable bundle through clock mode
clear cem
clear cem
To clear circuit emulation (CEM) statistics, use the clearcem command in privileged EXEC mode.
clear cem {slot|slot/port/channel|all}
Syntax Description slot Clears the statistics for all CEM channels on the card in the specified slot (if the card is a Circuit
Emulation over IP [CEoIP] card).
slot Specifies the slot of the CEM channel to clear.
/ port Specifies the port of the CEM channel to clear. The slash mark is required between the slot
argument and the port argument.
/ channel Specifies the CEM channel to clear. The slash mark is required between the port argument and
the channel argument.
all Clears the statistics for all CEM channels on the router.
Command Modes Privileged EXEC
Command History Release Modification
12.3(7)T This command was introduced.
Examples The following example shows how to clear CEM statistics for CEM channel number 10 on the card
installed in slot 1, port 1.
Router# clear cem 1/1/10
Related Commands Command Description
cem Enters CEM configuration mode.
show cem Displays CEM statistics.
Cisco IOS Interface and Hardware Component Command Reference
159
cable bundle through clock mode
clear controller
clear controller
To reset the T1 or E1 controller, use the clearcontrollercommand in user EXEC or privileged EXEC mode.
Cisco 7200 Series and Cisco 7500 Series Routers
clear controller {t1|e1} slot/port
Cisco AS5200 Series and Cisco AS5300 Series Routers
clear controller {t1|e1} number
Syntax Description t1 T1 controller.
e1 E1 controller.
slot / port Backplane slot number and port number on the interface. Refer to your hardware installation
manual for the specific slot and port numbers.
number Network interface module (NIM) number, in the range from 0 to 2.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
10.1 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples The following example resets the T1 controller at slot 4, port 0 on a Cisco 7500 series router:
Router# clear controller t1 4/0
The following example resets the E1 controller at NIM 0:
Router# clear controller e1 0
Related Commands Command Description
controller Configures a T1, E1, or J1 controller and enters controller configuration mode.
Cisco IOS Interface and Hardware Component Command Reference
160
cable bundle through clock mode
clear controller lex
clear controller lex
To reboot the LAN Extender chassis and restart its operating software, use the clearcontrollerlex command
in privileged EXEC mode.
clear controller lex number [prom]
Cisco 7500 Series
clear controller lex slot/port [prom]
Cisco 7200 Series and 7500 Series with a Packet over SONET Interface Processor
clear controller lex [type] slot/port
Cisco 7500 Series with Ports on VIP Cards
clear controller lex [type] slot/port-adapter/port
Syntax Description number Number of the LAN Extender interface corresponding to the LAN Extender to be rebooted.
prom (Optional) Forces a reload of the PROM image, regardless of any Flash image.
slot Number of the slot being configured. Refer to the appropriate hardware manual for slot and
port information.
port Number of the port being configured. Refer to the appropriate hardware manual for slot and
port information.
type (Optional) Specifies the interface type. See Table 4 under the clearcounters command for
keywords.
port-adapter Number of the port adapter being configured. Refer to the appropriate hardware manual for
information about port adapter compatibility.
Command Modes Privileged EXEC
Command History Release Modification
10.3 This command was introduced.
12.2(15)T This command is no longer supported in Cisco_IOS Mainline or Technology-based (T) releases.
It may continue to appear in Cisco_IOS 12.2S-family releases.
Usage Guidelines The clearcontrollerlex command halts operation of the LAN Extender and performs a cold restart.
Without the prom keyword, if an image exists in Flash memory, and that image has a newer software version
than the PROM image, and that image has a valid checksum, then this command runs the Flash image. If any
one of these three conditions is not met, this command reloads the PROM image.
With the prom keyword, this command reloads the PROM image, regardless of any Flash image.
Cisco IOS Interface and Hardware Component Command Reference
161
cable bundle through clock mode
clear controller lex
Examples The following example halts operation of the LAN Extender bound to LAN Extender interface 2 and
causes the LAN Extender to perform a cold restart from Flash memory:
Router#
clear controller lex 2
reload remote lex controller? [confirm] yes
The following example halts operation of the LAN Extender bound to LAN Extender interface 2 and
causes the LAN Extender to perform a cold restart from PROM:
Router#
clear controller lex 2 prom
reload remote lex controller? [confirm] yes
Cisco IOS Interface and Hardware Component Command Reference
162
cable bundle through clock mode
clear controller wanphy
clear controller wanphy
T o clear the triggered alarm counters for the Cisco 1-Port 10 Gigabit Ethernet LAN/WAN-PHY Shared Port
Adapter and reset it to zero, use the clearcontrollerwanphycommandin Privileged EXEC mode.
clear controller wanphy slot/subslot/port
Syntax Description slot The SIP slot number in which the Cisco 1-Port 10 Gigabit Ethernet LAN/WAN-PHY Shared Port
Adapter has been installed.
subslot The subslot number in which the Cisco 1-Port 10 Gigabit Ethernet LAN/WAN-PHY Shared Port
Adapter has been installed.
port The port number of the Cisco 1-Port 10 Gigabit Ethernet LAN/WAN-PHY Shared Port Adapter.
Note There is only 1 port (0) in the Cisco 1-Port 10 Gigabit Ethernet LAN/WAN-PHY Shared
Port Adapter.
Command Default No default values are available.
Command Modes Privileged EXEC Mode (EXEC)
Command History Release Modification
Cisco IOS XE Release 3.3.0S This command was introduced on the Cisco ASR 1000 Series Routers.
Usage Guidelines The clearcontrollerwanphycommand has been introduced on the Cisco ASR 1000 Series Router in Cisco
IOS XE Release 3.3.0S. This command is used to clear the counter of alarms generated, and reset it back to
zero.
Examples The following example shows the output of the showcontrollerswanphy command. The example
shows the alarm counter values for the line, path, and section alarms:
Router# show controllers wanphy 0/1/0
TenGigabitEthernet0/1/0
Mode of Operation: WAN Mode
SECTION
LOF = 1 LOS = 0 BIP(B1) = 22
LINE
AIS = 1 RDI = 0 FEBE = 0 BIP(B2) = 3099
PATH
AIS = 1 RDI = 0 FEBE = 4 BIP(B3) = 4
LOP = 0 NEWPTR = 0 PSE = 0 NSE = 0
WIS ALARMS
SER = 1 FELCDP = 0 FEAISP = 0
WLOS = 0 PLCD = 0
LFEBIP = 857 PBEC = 4
Active Alarms[All defects]: None
Active Alarms[Highest Alarms]: None
Alarm reporting enabled for: SF SWLOF B1-TCA B2-TCA PLOP WLOS
Rx(K1/K2): 00/00 Tx(K1/K2): 00/00
S1S0 = 00, C2 = 0x1A
Cisco IOS Interface and Hardware Component Command Reference
163
cable bundle through clock mode
clear controller wanphy
PATH TRACE BUFFER: STABLE
Remote J1 Byte : wert
BER thresholds: SD = 10e-6 SF = 10e-3
TCA thresholds: B1 = 10e-6 B2 = 10e-6 B3 = 10e-6
[Output is Cut]
The following example shows how to clear the alarm counter values and reset it back to zero:
Router# clear controller wanphy 0/1/0
The following example shows that the alarm counter values are cleared and have been reset to zero:
Router# show controllers wanphy 0/1/0
TenGigabitEthernet0/1/0
Mode of Operation: WAN Mode
SECTION
LOF = 0 LOS = 0 BIP(B1) = 0
LINE
AIS = 0 RDI = 0 FEBE = 0 BIP(B2) = 0
PATH
AIS = 0 RDI = 0 FEBE = 0 BIP(B3) = 0
LOP = 0 NEWPTR = 0 PSE = 0 NSE = 0
WIS ALARMS
SER = 0 FELCDP = 0 FEAISP = 0
WLOS = 0 PLCD = 0
LFEBIP = 0 PBEC = 0
Related Commands Command Description
show controllers wanphy Displays the SPA mode (LAN/WAN), alarms, and J1 byte string value.
Cisco IOS Interface and Hardware Component Command Reference
164
cable bundle through clock mode
clear controller vdsl
clear controller vdsl
To reset the VDSL line related counters, use the clearcontrollervdsl command in privileged EXEC mode.
clear controller vdsl slot/subslot/port number
Syntax Description vdsl VDSL2 controller.
slot Controller slot number.
subslot Controller subslot number.
port number Controller port number.
Command Default None.
Command Modes Privileged EXEC mode.
Command History Release Modification
15.0(1)M1 This command was first introduced.
Usage Guidelines None.
Examples The following example shows how to reset the VDSL line related counters.
Router#clear controller vdsl 0/2/0
Related Commands Command Description
show controller vdsl Displays VDSL controller related information.
Cisco IOS Interface and Hardware Component Command Reference
165
cable bundle through clock mode
clear counters
clear counters
To clear the interface counters, use the clearcounters command in user EXEC or privileged EXEC mode.
clear counters commandclear counters [interface-type interface-number]
Cisco 7200 Series and 7500 Series with a Packet over SONET Interface Processor
clear counters [interface-type] slot/port
Cisco 7500 Series with Ports on VIP Cards
clear counters [interface-type] slot/port-adapter/port
Cisco 7600 Series
clear counters [{interface interface-number|null interface-number|port-channel number|vlan vlan-id}]
Syntax Description interface-type (Optional) Specifies the interface type; one of the keywords listed in Table 1 .
interface -number (Optional) Specifies the interface number displayed with the showinterfaces
command.
slot Slot number. Refer to the appropriate hardware manual for slot and port
information.
port Port number. Refer to the appropriate hardware manual for slot and port
information.
port-adapter Port adapter number. Refer to the appropriate hardware manual for information
about port adapter compatibility.
interface (Optional) Interface type; possible valid values are ethernet,
fastethernetgigabitethernet, and tengigabitethernet. See the “Usage Guidelines”
section for additional valid values.
interface-number (Optional) Module and port number; see the “Usage Guidelines” section for valid
values.
null interface-number (Optional) Specifies the null interface; the valid value is 0.
port-channel number (Optional) Specifies the channel interface; valid values are a maximum of 64
values ranging from 1 to 256.
vlan vlan-id (Optional) Specifies the VLAN ID; valid values are from 1 to 4094.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
10.0 This command was introduced.
11.2F The virtual-access keyword was added.
Cisco IOS Interface and Hardware Component Command Reference
166
cable bundle through clock mode
clear counters
Release Modification
11.3 The following keywords were added or modified:
• vg-anylan keyword was added.
• posi keyword was changed to pos.
12.2(15)T The ethernet and serial keywords were removed because the LAN Extension feature is no
longer available in Cisco IOS software.
12.2(17a)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command clears all the current interface counters from the interface unless the optional arguments
interface-type and interface-numberare specified to clear only a specific interface type (serial, Ethernet, Token
Ring, and so on). The table below lists the command keywords and their descriptions.
Note This command does not clear counters retrieved using Simple Network Management Protocol (SNMP), but
only those seen with the showinterface command. However, variables seen with the showinterface command
that could affect routing, such as load and reliability, or non-cumulative variables, such as input or output
rates, are not cleared.
The interface-number argument designates the module and port number. Valid values for interface-number
depend on the specified interface type and the chassis and module that are used. For example, if you specify
a Gigabit Ethernet interface and have a 48-port 10/100BASE-T Ethernet module that is installed in a 13-slot
chassis, valid values for the module number are from 1 to 13 and valid values for the port number are from
1 to 48.
Table 5: clear counters Interface Type Keywords
Keyword Interface Type
async Asynchronous interface
bri ISDN BRI
dialer Dialer interface
ethernet Ethernet interface
fast-ethernet Fast Ethernet interface
fddi FDDI
hssi High-Speed Serial Interface (HSSI)
line Terminal line
Cisco IOS Interface and Hardware Component Command Reference
167
cable bundle through clock mode
clear counters
Keyword Interface Type
loopback Loopback interface
null Null interface
port-channel Port channel interface
pos Packet OC-3 interface
serial Synchronous serial interface
switch Switch interface
tokenring Token Ring interface
tunnel Tunnel interface (IEEE 02.5)
vg-anylan 100VG-AnyLAN port adapter
virtual-access Virtual-access interface (Refer to the Cisco IOS Dial Technologies Command Reference
for details on virtual templates.)
virtual-template Virtual-template interface (Refer to the Cisco IOS Dial Technologies Command
Reference for details on virtual templates.)
virtual-tokenring Virtual Token Ring interface
Examples The following example shows how to clear all interface counters:
Router#
clear counters
The following example shows how to clear the Packet OC-3 interface counters on a POSIP card in
slot 1 on a Cisco 7500 series router:
Router#
clear counters pos 1/0
The following example shows how to clear the interface counters on a Fast EtherChannel interface:
Router# clear counter port-channel 1
Clear “show interface” counters on all interfaces [confirm] Y
%CLEAR-5-COUNTERS: Clear counter on all interfaces by console 1
Related Commands Command Description
show interfaces Displays the statistical information specific to a serial interface.
show interfaces port-channel Displays the information about the Fast EtherChannel on Cisco 7500 series
routers and Cisco 7000 series routers with the RSP7000 and RSP7000CI.
show queueing interface Displays queuing information.
Cisco IOS Interface and Hardware Component Command Reference
168
cable bundle through clock mode
clear debug platform condition all
clear debug platform condition all
To remove the debug conditions applied to a platform, use the clear debug platform condition all command
in privileged EXEC mode.
clear debug platform condition all
Command Modes Privileged EXEC (#)
Command History Release Modification
Cisco IOS XE Release 3.10.0S This command was introduced on the Cisco ASR 1000 Series Aggregation
Services Routers.
The following example shows how to remove the conditional debugging applied to the platform.
Router# clear debug platform condition all
Cisco IOS Interface and Hardware Component Command Reference
169
cable bundle through clock mode
clear diagnostic event-log
clear diagnostic event-log
To clear the diagnostic event logs for a specific module or event type, use the
cleardiagnosticevent-logcommand in Priveleged exec mode.
clear diagnostic event-log {event-type {error|info|warning}|module {num|slot subslot|all}}
Syntax Description event-type error Specifies clearing error events.
event-type info Specifies clearing informative events.
event-type warning Specifies clearing warning events.
module num | slotsubslot Specifies clearing events for a specific module.
module all Specifies clearing all linecards.
Command Default This command has no default settings.
Command Modes Priveleged Exec mode(#)
Command History Release Modification
12.2(33)SXH This command was introduced on the Supervisor Engine 720.
Usage Guidelines The cleardiagnosticevent-log command clears all the events for all the modules.
The cleardiagnosticevent-logmodulenum command clears events only for a specific module.
The cleardiagnosticevent-logevent-typecommand clears only specific event types such as error, informative,
or warning events.
Examples This example shows how to clear error event logs:
Router# clear diagnostic event-log event-type error
This example shows how to clear event logs on module 3:
Router# clear diagnostic event-log module 3
This example shows how to clear error event logs on all the modules:
Router# clear diagnostic event-log module all
Related Commands Command Description
show diagnostic events Displays the diagnostic event log
Cisco IOS Interface and Hardware Component Command Reference
170
cable bundle through clock mode
clear dsip tracing
clear dsip tracing
To clear Distributed System Interconnect Protocol (DSIP) tracing statistics (trace logging), use the
cleardsiptracing command in privileged EXEC mode.
clear dsip tracing {counters|tracing} [{control|data|ipc}]
Syntax Description counters DSIP counters.
tracing DSIP tracing buffers.
control (Optional) Control counters or tracing buffers.
data (Optional) Data counters or tracing buffers.
ipc (Optional) Inter-process communication counters or tracing buffers.
Command Default If no option is specified, all control, data, and inter-process communication counters or tracing buffers are
cleared.
Command Modes Privileged EXEC
Command History Release Modification
11.3(2)AA This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use this command to clear the counters displayed with the showdsiptracing EXEC command.
Examples In the following example, the DSIP counters are cleared (including data, control, and ipc counters):
Router# clear dsip tracing
Related Commands Command Description
show dsip tracing Displays DSIP tracing buffer information.
show dsip version Displays DSIP version information.
Cisco IOS Interface and Hardware Component Command Reference
171
cable bundle through clock mode
clear facility-alarm
clear facility-alarm
To clear alarm conditions and reset the alarm contacts, use the clearfacility-alarmcommand in privileged
EXEC mode.
clear facility-alarm [{critical|major|minor|source pem {0|1}}]
Syntax Description critical (Optional) Clears all critical alarms.
major (Optional) Clears all major alarms.
minor (Optional) Clears all minor alarms.
source pem {0 | 1} (Optional--Cisco uBR10012 only) Clears all alarms for either the first or second Power
Entry Module (PEM).
Command Default If specified without any options, clears all facility alarms with the exception of:
• An alarm that illuminates the CRIT, MIN, or MAJ LED
• A visual alarm (DC lightbulb) that is wired to the DB-25 connector on a power supply
If specified without any options, clears all facility alarms.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.0(17)SL This command was introduced on the Cisco 10000 series router.
12.2(1)XF1 This command was introduced for the Cisco uBR10012 router.
12.2(16)BX This command was introduced on the PRE2.
12.2(31)SB2 This command was introduced on the PRE3 for the Cisco 10000 series router.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
Cisco IOS XE Release 2.1 This command was integrated into Cisco IOS XE Release 2.1 on the Cisco ASR
1000 Series Routers.
Usage Guidelines Cisco ASR 1000 Series Routers
The clear facility-alarm command clears audible alarms. A recurrence of the original alarm source after the
original alarm condition is removed restarts the audible alarm.
The clear facility-alarm command does not clear an alarm that illuminates the CRIT, MIN, or MAJ LED. This
command does not turn off a visual alarm (DC light bulb) that is wired to the DB-25 connector on a power
supply.
Cisco IOS Interface and Hardware Component Command Reference
172
cable bundle through clock mode
clear facility-alarm
To clear a CRIT, MIN, or MAJ alarm LED or a visual alarm, you must resolve the alarm condition. For
example, if a critical alarm LED is illuminated because an active SPA was removed without a graceful
deactivation of the SPA, the only way to resolve that alarm is to replace the SPA.
Cisco uBR10012 Universal Broadband Router
The clearfacility-alarm command clears the contacts to an external alarm panel. Only a recurrence of the
original alarm source after the original alarm condition is removed can restart the audible alarm. These alarms
are displayed by the showfacility-alarmstatuscommand.
The alarm LEDs remain lit on the Performance Routing Engine (PRE) as long as the alarm condition continues
and is not cleared by the clearfacility-alarm command. An alarm can only be removed from the list by
correcting the issue that is triggering the alarm.
Examples The following example shows how to clear all facility alarms on the router:
Router# clear facility-alarm
Clearing all alarms
The following example shows how to clear all critical facility alarms on the router:
Router# clear facility-alarm critical
Clearing critical alarms
The following example shows how to clear minor facility alarms only:
Router# clear facility-alarm minor
Clearing minor alarms
Cisco uBR10012 Universal Broadband Router
The following example shows how to clear all alarms for both PEM modules on a Cisco uBR10012
universal broadband router:
Router# clear facility-alarm source pem 0
Router# clear facility-alarm source pem 1
Related Commands Command Description
facility-alarm Sets the temperature thresholds at which the processor generates
a critical, major, or minor alarm to warn of potential equipment
damage.
facility-alarm critical exceed-action Allows automatic router shutdown.
shutdown
show facility-alarm Displays the status of a generated alarm.
Cisco IOS Interface and Hardware Component Command Reference
173
cable bundle through clock mode
clear hub
clear hub
To reset and reinitialize the hub hardware connected to an interface of a Cisco 2505 or Cisco 2507 router, use
the clearhubcommand in user EXEC or privileged EXEC mode.
clear hub commandclear hub ethernet number
Syntax Description ethernet Hub in front of an Ethernet interface.
number Hub number to clear, starting with 0. Because there is only one hub, this number is 0.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
10.3 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples The following example clears hub 0:
Router#
clear hub ethernet 0
Related Commands Command Description
hub Enables and configures a port on an Ethernet hub of a Cisco 2505 or Cisco 2507 router.
Cisco IOS Interface and Hardware Component Command Reference
174
cable bundle through clock mode
clear hub counters
clear hub counters
To set the hub counters on an interface of a Cisco 2505 or Cisco 2507 router to zero, use the clearhubcounters
command in user EXEC or privileged EXEC mode.
clear hub counters commandclear hub counters [ether number [port [end-port]]]
Syntax Description ether (Optional) Hub in front of an Ethernet interface.
number (Optional) Hub number for which to clear counters. Because there is currently only one hub, this
number is 0. If you specify the keyword ether, you must specify the number.
port (Optional) Port number on the hub. On the Cisco 2505 router, port numbers range from 1 to 8.
On the Cisco 2507 router, port numbers range from 1 to 16. If a second port number follows, this
port number indicates the end of a port range. If you do not specify a port number, counters for
all ports are cleared.
end-port (Optional) Ending port number of a range.
Command Default If no port numbers are specified, counters for all ports are cleared.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
10.3 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples The following example shows how to clear the counters displayed by a showhub command for all
ports on hub 0:
Router#
clear hub counters ether 0
Related Commands Command Description
show hub Displays information about the hub (repeater) on an Ethernet interface of a Cisco 2505 or Cisco
2507 router.
Cisco IOS Interface and Hardware Component Command Reference
175
cable bundle through clock mode
clear interface
clear interface
To reset the hardware logic on an interface, use the clearinterface command in user EXEC or privileged
EXEC mode.
clear interface commandclear interface {type number [name-tag]|range type number}
Cisco 7200 Series and Cisco 7500 Series with a Packet OC-3 Interface Processor
clear interface {type slot/port|range type number}
Cisco 7500 Series with Ports on VIP Cards
clear interface type slo t/port-adapter/port
Cisco 7500 Series
clear interface type slot/port [: channel-group]
Cisco 7500 Series with a CT3IP Port Adapter
clear interface type slot/port-adapter/port [: t1-channel]
Syntax Description type Interface type; it is one of the keywords listed in Table 1 .
number Port, connector, or interface card number.
name-tag (Optional for use with the Redundant Link Manager [RLM] feature) Logic name to
identify the server configuration so that multiple server configurations can be entered.
range Clears all the interfaces within the specified range.
slot Number of the slot being configured. Refer to the appropriate hardware manual for slot
and port information.
/ port Number of the port being configured. Refer to the appropriate hardware manual for slot
and port information.
port-adapter Number of the port adapter being configured. Refer to the appropriate hardware manual
for information about port adapter compatibility.
: channel-group (Optional) Channel number, on Cisco 7500 series routers that support channelized T1.
The range is from 0 to 23. This number is preceded by a colon.
: t1-channel (Optional) For the CT3IP port adapter, the T1 channel is a number between 1 and 28.
T1 channels on the CT3IP are numbered 1 to 28 rather than the more traditional
zero-based scheme (0 to 27) used with other Cisco products. This numbering scheme
ensures consistency with telco numbering schemes for T1 channels within channelized
T3 equipment.
Command Modes User EXEC (>) Privileged EXEC (#)
Cisco IOS Interface and Hardware Component Command Reference
176
cable bundle through clock mode
clear interface
Command History Release Modification
10.0 This command was introduced.
11.3 This command was modified. The following changes were made:
• The vg-anylan keyword was added
• The posi keyword was changed to pos
12.0(3)T This command was modified. The following optional argument was added for
the RLM feature:
• name-tag
15.0(1)M This command was modified in a release earlier than Cisco IOS Release
15.0(1)M. The range keyword was added.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in
a specific 12.2SX release of this train depends on your feature set, platform, and
platform hardware.
Cisco IOS XE Release 2.1 This command was implemented on the Cisco ASR 1000 Series Aggregation
Services Routers.
Usage Guidelines Under normal circumstances, you do not need to clear the hardware logic on interfaces.
This command clears all the current interface hardware logic unless the type and number arguments are
specified to clear only a specific interface type (serial, Ethernet, Token Ring, and so on). The table below lists
the command keywords and their descriptions.
Table 6: clear interface Type Keywords
Keyword Interface Type
acr Virtual Automatic Call Reconnect (ACR) interface
analysis-module Cisco network analysis service module
async Async interface
atm ATM interface
auto-template Auto-Template interface
bdi Bridge-Domain interface
bri ISDN BRI
bvi Bridge-Group Virtual interface
cdma-ix CDMA Ix interface
Cisco IOS Interface and Hardware Component Command Reference
177
cable bundle through clock mode
clear interface
Keyword Interface Type
container Container interface
ctunnel CTunnel interface
dialer Dialer interface
esconphy ESCON interface
ethernet Ethernet interface
fcpa Fiber Channel
fddi FDDI
filter Filter interface
filtergroup Filter Group interface
gigabitethernet Gigabit Ethernet IEEE 802.3z
gmpls MPLS interface
hssi High-Speed Serial Interface (HSSI)
lex Lex interface
longreachethernet Long-Reach Ethernet interface
loopback Loopback interface
lspvif LSP virtual interface
mfr Multilink Frame Relay bundle interface
multilink Multilink-group interface
multiservice Multiservice interface
null Null interface
port-channel Ethernet Channel of interfaces
portgroup Portgroup interface
pos Packet over SONET.
pos-channel POS Channel of interfaces
sbc Session Border Controller
serial Synchronous serial interface
service-engine Cisco service engine module
sslvpn-vif SSLVPN Virtual Interface
Cisco IOS Interface and Hardware Component Command Reference
178
cable bundle through clock mode
clear interface
Keyword Interface Type
switch Switch interface
sysclock Telecom-Bus Clock Controller
tokenring Token Ring interface
tunnel Tunnel interface
vasileft VasiLeft interface
vasiright VasiRight interface
vg-anylan 100VG-AnyLAN port adapter
vif PGM Multicast Host interface
virtual-dot11radio Virtual dot11 interface
virtual-ppp Virtual PPP interface
virtual-tokenring Virtual Token Ring interface
vlan Catalyst VLAN
vmi Virtual Multipoint interface
voabypassin VOA-Bypass-In interface
voabypassout VOA-Bypass-Out interface
voafilterin VOA-Filter-In interface
voafilterout VOA-Filter-Out interface
voain VOA-In interface
voaout VOA-Out interface
Examples The following example shows how to reset the interface logic on HSSI interface 1:
Router#
clear interface hssi 1
The following example shows how to reset the interface logic on Packet OC-3 interface 0 on the
POSIP in slot 1:
Router#
clear interface pos 1/0
The following example shows how to reset the interface logic on T1 0 on the CT3IP port adapter in
slot 9:
Cisco IOS Interface and Hardware Component Command Reference
179
cable bundle through clock mode
clear interface
Router#
clear interface serial 9/0/0:0
The following example shows how to reset the interface logic on Fast EtherChannel interface 1:
Router# clear interface port-channel 1
The following example shows how to reset demonstrates the use of the clearinterface command
with the RLM feature:
Router# clear interface loopback 1
Router#
02:48:52: rlm 1: [State_Up, rx ACTIVE_LINK_BROKEN] over link [10.1.1.1(Loopback1), 10.1.4.1]
02:48:52: rlm 1: link [10.1.1.2(Loopback2), 10.1.4.2] requests activation
02:48:52: rlm 1: link [10.1.1.1(Loopback1), 10.1.4.1] is deactivated
02:48:52: rlm 1: link [10.1.1.1(Loopback1), 10.1.4.1] = socket[10.1.1.1, 10.1.4.1]
02:48:52: rlm 1: [State_Recover, rx USER_SOCKET_OPENED] over link [10.1.1.1(Loopback1),
10.1.4.1] for user RLM_MGR
02:48:52: rlm 1: link [10.1.1.1(Loopback1), 10.1.4.1] is opened
02:48:52: rlm 1: link [10.1.1.1(Loopback1), 10.1.5.1] = socket[10.1.1.1, 10.1.5.1]
02:48:52: rlm 1: [State_Recover, rx USER_SOCKET_OPENED] over link [10.1.1.1(Loopback1),
10.1.5.1] for user RLM_MGR
02:48:52: rlm 1: link [10.1.1.1(Loopback1), 10.1.5.1] is opened
02:48:52: rlm 1: [State_Recover, rx START_ACK] over link [10.1.1.2(Loopback2), 10.1.4.2]
02:48:52: rlm 1: link [10.1.1.2(Loopback2), 10.1.4.2] is activated
02:48:52: rlm 1: [State_Up, rx LINK_OPENED] over link [10.1.1.1(Loopback1), 10.1.4.1]
Router# show rlm group 1 status
RLM Group 1 Status
User/Port: RLM_MGR/3000
Link State: Up Last Link Status Reported: Up_Recovered
Next tx TID: 4 Last rx TID: 0
Server Link Group[r1-server]:
link [10.1.1.1(Loopback1), 10.1.4.1] = socket[standby, 10.1.1.1, 10.1.4.1]
link [10.1.1.2(Loopback2), 10.1.4.2] = socket[active, 10.1.1.2, 10.1.4.2]
Server Link Group[r2-server]:
link [10.1.1.1(Loopback1), 10.1.5.1] = socket[opening, 10.1.1.1, 10.1.5.1]
link [10.1.1.2(Loopback2), 10.1.5.2] = socket[opening, 10.1.1.2, 10.1.5.2]
Router#
02:49:52: rlm 1: [State_Up, rx UP_RECOVERED_MIN_TIMEOUT]
02:49:52: rlm 1: link [10.1.1.1(Loopback1), 10.1.4.1] requests activation
02:49:52: rlm 1: [State_Switch, rx SWITCH_ACK] over link [10.1.1.1(Loopback1), 10.1.4.1]
02:49:52: rlm 1: link [10.1.1.2(Loopback2), 10.1.4.2] is deactivated
02:49:52: rlm 1: link [10.1.1.1(Loopback1), 10.1.4.1] is activated
Related Commands Command Description
interface Defines the IP addresses of the server, configures an interface type, and enters interface
configuration mode.
show rlm group Displays the status of the RLM group.
shutdown (RLM) Shuts down all of the links under the RLM group.
Cisco IOS Interface and Hardware Component Command Reference
180
cable bundle through clock mode
clear interface cem
clear interface cem
T o clear the cem channel, use the clearinterfacecemcommandin privilege exec mode.
clear interface cem slot/subslot/port
Syntax Description slot Slot number where the SIP is installed.
subslot Subslot number of the SIP where CEOPS SPA has been installed and circuit emulation has been
configured.
port Port number of the interface on the CEOPS SPA where circuit emulation has been configured.
Command Default No default behavior or values.
Command Modes Privilege Exec Mode (Exec)
Command History Release Modification
Cisco IOS XE Release 3.3.0S This command was introduced.
Usage Guidelines The clearinterfacecemcommand has been introduced on Cisco ASR 1000 Series Router in Cisco IOS XE
Release 3.3.0S. The clearinterfacecem command is used to clear the statistics information of the cem group.
Examples The following example shows how to clear the cem channel using the clear interface cem command:
Router# clear interface cem
Related Commands Command Description
show interfaces cem Displays the statistics of the cem group.
Cisco IOS Interface and Hardware Component Command Reference
181
cable bundle through clock mode
clear interface fastethernet
clear interface fastethernet
To reset the controller for a specified Fast Ethernet interface, use the clearinterfacefastethernet command
in privileged EXEC mode.
Cisco 4500 and Cisco 4700 Series
clear interface fastethernet interface-number
Cisco 7200 and Cisco 7500 Series
clear interface fastethernet slot/port
Cisco 7500 Series with a VIP
clear interface fastethernet slot/port-adapter/port
Syntax Description interface-number Port, connector, or interface card number. On a Cisco 4500 or Cisco 4700 Series router,
specifies the number of the network processor module (NPM). The numbers are assigned
at the factory at the time of installation or when added to a system.
slot Slot number. Refer to the appropriate hardware manual for slot and port information.
/ port Port number. Refer to the appropriate hardware manual for slot and port information.
/ port-adapter Port adapter number. Refer to the appropriate hardware manual for information about
port adapter compatibility.
Command Modes Privileged EXEC
Command History Release Modification
11.2 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples
Cisco 4500 Series
The following example resets the controller for Fast Ethernet interface 0 on a Cisco 4500:
Router#
clear interface fastethernet 0
Cisco 7200 and Cisco 7500 Series
The following example resets the controller for the Fast Ethernet interface located in slot 1, port 0
on a Cisco 7200 series router or Cisco 7500 series router:
Cisco IOS Interface and Hardware Component Command Reference
182
cable bundle through clock mode
clear interface fastethernet
Router#
clear interface fastethernet 1/0
Cisco 7500 SerieswithaVIP
The following example resets the controller for the Fast Ethernet interface located in slot 1, port
adapter 0, port 0 on a Cisco 7500 series router with a virtual interface processor (VIP):
Router#
clear interface fastethernet 1/0/0
Related Commands Command Description
clear counters Clears the interface counters.
show interfaces Displays statistics for all interfaces configured on the router or access server.
show interfaces serial Displays information about a serial interface.
Cisco IOS Interface and Hardware Component Command Reference
183
cable bundle through clock mode
clear interface gigabitethernet
clear interface gigabitethernet
To clear the hardware logic on a Gigabit Ethernet IEEE 802.3z interface, use the clearinterfacegigabitethernet
command in privileged EXEC mode.
clear interface gigabitethernet number
Syntax Description number Gigabit Ethernet interface number; see the “Usage Guidelines” section for valid values.
Command Default This command has no default settings.
Command Modes Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The number argument designates the module and port number. Valid values for number depend on the specified
interface type and the chassis and module that are used. For example, if you specify a Gigabit Ethernet interface
and have a 48-port 10/100BASE-T Ethernet module that is installed in a 13-slot chassis, valid values for the
module number are from 1 to 13 and valid values for the port number are from 1 to 48.
Examples This example shows how to clear the hardware logic on a Gigabit Ethernet IEEE 802.3z interface:
Router#
clear interface gigabitethernet 5
Router#
Related Commands Command Description
show interfaces status Displays the interface status or a list of interfaces in an error-disabled state on
LAN ports only.
Cisco IOS Interface and Hardware Component Command Reference
184
cable bundle through clock mode
clear interface serial
clear interface serial
To reset the statistical information specific to a serial interface, use the clearinterfaceserialcommand in user
EXEC or privileged EXEC mode.
clear interface serial dial-shelf/slot/t3-port : t1-num : chan-group
Syntax Description dial-shelf Dial shelf chassis in the Cisco AS5800 access server that contains the CT3 interface card.
/ slot Location of the CT3 interface card in the dial shelf chassis.
/ t3-port T3 port number. The only valid value is 0.
: t1-num T1 time slot in the T3 line. The value can be from 1 to 28.
: chan-group Channel group identifier.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
10.0 This command was introduced.
Usage Guidelines The clearinterfaceserialcommand clears the interface hardware. To reset the counters for an interface, use
the clearcounterscommand with the serial keyword specified. To confirm at the prompt, use the
showinterfacesserialcommand.
Examples The following example clears the interface hardware, disconnecting any active lines:
Router# clear interface serial 1/4/0:2:23
Related Commands Command Description
clear counters Clears the interface counters.
show interfaces Displays statistics for all interfaces configured on the router or access server.
show interfaces fastethernet Displays information about a fastethernet interface.
Cisco IOS Interface and Hardware Component Command Reference
185
cable bundle through clock mode
clear interface vlan
clear interface vlan
To clear the hardware logic on a virtual local area network (VLAN), use the clearinterfacevlan command in
privileged EXEC mode.
clear interface vlan vlan-id
Syntax Description vlan-id VLAN ID; valid values are from 1 to 4094.
Command Default This command has no default settings.
Command Modes Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on theSupervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Examples This example shows how to clear the hardware logic on a specific VLAN:
Router#
clear interface vlan 5
Router#
Related Commands Command Description
show interfaces status Displays the interface status or a list of interfaces in an error-disabled state on
LAN ports only.
Cisco IOS Interface and Hardware Component Command Reference
186
cable bundle through clock mode
clear ipc statistics
clear ipc statistics
To clear all interprocess communication (IPC) statistics, use the clearipcstatistics command in privileged
EXEC mode.
clear ipc statistics
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC
Command History Release Modification
12.2(15)T This command was introduced.
Usage Guidelines The clearipcstatisticscommand clears all the IPC statistics and is useful for troubleshooting issues with IPC
services.
Examples The following example shows how to clear all of the statistics used by IPC services. A showipcstatus
command is issued first to display the current IPC counters for a local IPC server. The
clearipcstatistics command is then entered to clear and reset the counters. A final showipcstatus
command is issued to show that all the counters, except those counters that show the packets sent
since the clearing, are reset to zero.
Router# show ipc status
IPC System Status
Time last IPC stat cleared : never
This processor is the IPC master server.
Do not drop output of IPC frames for test purposes.
1000 IPC Message Headers Cached.
Rx Side Tx Side
Total Frames 189 140
Total from Local Ports 189 70
Total Protocol Control Frames 70 44
Total Frames Dropped 0 0
Service Usage
Total via Unreliable Connection-Less Service 145 0
Total via Unreliable Sequenced Connection-Less Svc 0 0
Total via Reliable Connection-Oriented Service 44 70
IPC Protocol Version 0
Total Acknowledgements 70 44
Total Negative Acknowledgements 0 0
Device Drivers
Total via Local Driver 0 0
Total via Platform Driver 0 70
Total Frames Dropped by Platform Drivers 0 0
Reliable Tx Statistics
Re-Transmission 0
Re-Tx Timeout 0
Rx Errors Tx Errors
Unsupp IPC Proto Version 0 Tx Session Error 0
Corrupt Frame 0 Tx Seat Error 0
Duplicate Frame 0 Destination Unreachable 0
Out-of-Sequence Frame 0 Tx Test Drop 0
Cisco IOS Interface and Hardware Component Command Reference
187
cable bundle through clock mode
clear ipc statistics
Dest Port does Not Exist 0 Tx Driver Failed 0
Rx IPC Msg Alloc Failed 0 Ctrl Frm Alloc Failed 0
Unable to Deliver Msg 0
Buffer Errors Misc Errors
IPC Msg Alloc 0 IPC Open Port 0
Emer IPC Msg Alloc 0 No HWQ 0
IPC Frame PakType Alloc 0 Hardware Error 0
IPC Frame MemD Alloc 0
Tx Driver Errors
No Transport 0
MTU Failure 0
Dest does not Exist 0
Router# clear ipc statistics
Router# show ipc status
IPC System Status
Time last IPC stat cleared : 00:00:03
This processor is the IPC master server.
Do not drop output of IPC frames for test purposes.
1000 IPC Message Headers Cached.
Rx Side Tx Side
Total Frames 26 0
Total from Local Ports 26 0
Total Protocol Control Frames 0 0
Total Frames Dropped 0 0
Service Usage
Total via Unreliable Connection-Less Service 26 0
Total via Unreliable Sequenced Connection-Less Svc 0 0
Total via Reliable Connection-Oriented Service 0 0
IPC Protocol Version 0
Total Acknowledgements 0 0
Total Negative Acknowledgements 0 0
Device Drivers
Total via Local Driver 0 0
Total via Platform Driver 0 0
Total Frames Dropped by Platform Drivers 0 0
Reliable Tx Statistics
Re-Transmission 0
Re-Tx Timeout 0
Rx Errors Tx Errors
Unsupp IPC Proto Version 0 Tx Session Error 0
Corrupt Frame 0 Tx Seat Error 0
Duplicate Frame 0 Destination Unreachable 0
Out-of-Sequence Frame 0 Tx Test Drop 0
Dest Port does Not Exist 0 Tx Driver Failed 0
Rx IPC Msg Alloc Failed 0 Ctrl Frm Alloc Failed 0
Unable to Deliver Msg 0
Buffer Errors Misc Errors
IPC Msg Alloc 0 IPC Open Port 0
Emer IPC Msg Alloc 0 No HWQ 0
IPC Frame PakType Alloc 0 Hardware Error 0
IPC Frame MemD Alloc 0
Tx Driver Errors
No Transport 0
MTU Failure 0
Dest does not Exist 0
Related Commands Command Description
show ipc Displays IPC statistics.
Cisco IOS Interface and Hardware Component Command Reference
188
cable bundle through clock mode
clear lacp counters
clear lacp counters
To clear the statistics for all interfaces belonging to a specific channel group, use the clearlacpcounters
command in privileged EXEC mode.
clear lacp [channel-group] counters
Syntax Description channel-group (Optional) Channel group number; valid values are from 1 to 256.
Command Default None
Command Modes Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines If you do not specify a channel-group, all channel groups are cleared.
If you enter this command for a channel group that contains members in PAgP mode, the command is ignored.
Examples This example shows how to clear the statistics for a specific group:
Router# clear lacp 1 counters
Router#
Related Commands Command Description
show lacp Displays LACP information.
Cisco IOS Interface and Hardware Component Command Reference
189
cable bundle through clock mode
clear platform netint
clear platform netint
To clear the interrupt-throttling counters for the platform, use the clear platform netint command in privileged
EXEC mode.
clear platform netint
Syntax Description This command has no arguments or keywords.
Command Default This command has no default settings.
Command Modes Privileged EXEC
Command History Release Modification
12.2(17b)SXA Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release
12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Examples This example shows how to clear the interrupt-throttling counters for the platform:
Router#
clear platform netint
Router#
Related Commands Command Description
show platform netint Displays the platform network-interrupt information.
Cisco IOS Interface and Hardware Component Command Reference
190
cable bundle through clock mode
clear platform software vnic-if-nvtable
clear platform software vnic-if-nvtable
To clear the virtual router’s persistent interface database on the original VM and update the interface mapping
to the hypervisor, use the clear platform software vnic-if-nvtable command in EXEC mode.
clear platform software vnic-if-nvtable
Command Default No default.
Command Modes EXEC
Command History Release Modification
Cisco IOS XE This command was introduced on the Cisco CSR 1000V.
3.9S
Usage Guidelines When the Cisco CSR 1000V boots for the first time, the vNICs on the hypervisor are mapped to the Gigabit
Ethernet network interfaces on the router. The system maintains a database for mapping the interfaces, and
the mapping stays persistent as long as vNICs are not removed from the system.
The clear platform software vnic-if-nvtable command is used when you clone the Cisco CSR 1000V
configuration to a new VM. You enter the command on the cloned VM instance of the Cisco CSR 1000V so
that the Gigabit Ethernet router interfaces on the cloned VM map to new vNICs. If the interface mapping
from the original VM is not cleared on the cloned VM, then the Cisco CSR 1000V feature license may be
invalidated.
Use the show platform software vnic-if interface-mapping command to verify the updated interface mapping.
Example
The following example clears the Cisco CSR 1000V interface mapping to the vNICs on the hypervisor:
se-10-0-0-0(config)# clear platform software vnic-if-nvtable
Related Commands Command Description
show platform software vnic-if Displays the mapping between the virtual Network Interface Cards
interface-mapping ( vNICs) on the VM and the network interfaces on a virtual router.
Cisco IOS Interface and Hardware Component Command Reference
191
cable bundle through clock mode
clear rbscp
clear rbscp
To reset and restart a Rate Based Satellite Control Protocol (RBSCP) tunnel, use the clearrbscp command
in privileged EXEC mode.
clear rbscp [tunnel tunnel-number]
Syntax Description tunnel (Optional) Resets and restarts the RBSCP tunnel interface specified in the tunnel-numberargument.
If a tunnel interface is not specified, all RBSCP tunnels are reset and restarted.
• tunnel-number --Number of the tunnel interface in the range from 0 to 2147483647.
Command Modes Privileged EXEC
Command History Release Modification
12.3(7)T This command was introduced.
Usage Guidelines The clearrbscpcommand resets the tunnel interface to its initial state and this clears RBSCP statistical
information. Use this command for troubleshooting issues with RBSCP tunnels.
Examples The following example shows how to clear the RBSCP statistics. A showrbscpstatistics command
is issued first to display the current RBSCP counters for tunnel interface 0. The clearrbscpcommand
is then entered to reset and restart tunnel interface 0. All the counters for tunnel interface 0 are reset
to zero. A final showrbscpstatistics command is issued to show that all the counters, except those
counters that show the packets sent since the clearing, are reset to zero.
Router# show rbscp statistics tunnel 0
Tunnel0 is up, line protocol is up
RBSCP protocol statistics:
Init FWD-TSNs sent 15, received 11
TUNNEL-UPs sent 10, received 5
CLOSEDs sent 3, received 2
TSNs sent 40, resent 2, lost by sender 1
TSNs received 36 (duplicates 2)
FWD-TSNs sent 144 (heartbeats 2)
FWD-TSNs received 120 (ignored 1)
FWD-TSNs caused 3 packet drops, 0 whole window drops
SACKs sent 10, received 6 (ignored 1)
Recovered with RTX 1
Received with delay 2
Most released at once 5
Failed sends into the: tunnel 1, network 0
Dropped due to: excess delay 0, tmit queue full 0
Max on any queue: num packets: 12, num bytes: 0
Max outstanding: 0
Router# clear rbscp tunnel 0
Tunnel0: cleared statistics
Router# show rbscp statistics tunnel 0
Tunnel0 is up, line protocol is up
RBSCP protocol statistics:
Init FWD-TSNs sent 0, received 0
Cisco IOS Interface and Hardware Component Command Reference
192
cable bundle through clock mode
clear rbscp
TUNNEL-UPs sent 0, received 0
CLOSEDs sent 0, received 0
TSNs sent 0, resent 0, lost by sender 0
TSNs received 0 (duplicates 0)
FWD-TSNs sent 26 (heartbeats 0)
FWD-TSNs received 0 (ignored 0)
FWD-TSNs caused 0 packet drops, 0 whole window drops
SACKs sent 0, received 0 (ignored 0)
Recovered with RTX 0
Received with delay 0
Most released at once 0
Failed sends into the: tunnel 0, network 0
Dropped due to: excess delay 0, tmit queue full 0
Max on any queue: num packets: 0, num bytes: 0
Max outstanding: 0
Related Commands Command Description
show rbscp Displays RBSCP state and statistical information.
Cisco IOS Interface and Hardware Component Command Reference
193
cable bundle through clock mode
clear service-module serial
clear service-module serial
To reset an integrated CSU/DSU, use the clearservice-moduleserialcommand in privileged EXEC mode.
clear service-module serial number
Syntax Description number Number of the serial interface.
Command Modes Privileged EXEC
Command History Release Modification
11.2 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use this command only in severe circumstances (for example, when the router is not responding to a CSU/DSU
configuration command).
This command terminates all DTE and line loopbacks that are locally or remotely configured. It also interrupts
data transmission through the router for up to 15 seconds. The software performs an automatic software reset
in case of two consecutive configuration failures.
The CSU/DSU module is not reset with the clearinterface command.
Caution If you experience technical difficulties with your router and intend to contact customer support, refrain from
using this command. This command erases the router’s past CSU/DSU performance statistics. To clear only
the CSU/DSU performance statistics, issue the clearcounterscommand.
Examples The following example show how to reset the CSU/DSU on a router:
Router# clear service-module serial 0
Related Commands Command Description
clear counters Clears the interface counters.
test service-module Performs self-tests on an integrated CSU/DSU serial interface module, such as a
4-wire, 56/64-kbps CSU/DSU.
Cisco IOS Interface and Hardware Component Command Reference
194
cable bundle through clock mode
clear top counters interface report
clear top counters interface report
To clear the TopN reports, use the cleartopcountersinterfacereport command in privileged EXEC mode.
clear top counters interface report number
Syntax Description number (Optional) Number of ports to be displayed; valid values are from 1 to 5000 physical ports.
Command Default This command has no default settings.
Command Modes Privileged EXEC
Command History Release Modification
12.2(18)SXE Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is supported on Ethernet, Fast Ethernet, Gigabit Ethernet, and 10-Gigabit Ethernet ports only.
LAN ports on the OSMs are also supported.
The cleartopinterfacereport command clears all the completed reports. It does not clear the pending TopN
reports. When you specify a report number, the TopN task is cleared regardless of its status.
Examples This example shows how to clear all TopN tasks:
Router# clear top counters interface report 1000
04:00:06: %TOPN_COUNTERS-5-DELETED: TopN report 1 deleted by the console
04:00:06: %TOPN_COUNTERS-5-DELETED: TopN report 2 deleted by the console
04:00:06: %TOPN_COUNTERS-5-DELETED: TopN report 3 deleted by the console
04:00:06: %TOPN_COUNTERS-5-DELETED: TopN report 4 deleted by the console1/24/
Router#
This example shows the output if you attempt to clear a pending TopN task:
Router# clear top counters interface report 4
04:52:12: %TOPN_COUNTERS-5-KILLED: TopN report 4 killed by the sattili onvty0 (9.10.69.9)
Router#
Related Commands Command Description
collect top counters interface Lists the TopN processes and specific TopN reports.
show top counters interface report Displays TopN reports and information.
Cisco IOS Interface and Hardware Component Command Reference
195
cable bundle through clock mode
clock
clock
To configure the port clocking mode for the 1000BASE-T transceivers, use the clock command in interface
configuration mode. To return to the default settings,use the no form of this command.
clock {auto|active [prefer]|passive [prefer]}
no clock
Syntax Description auto Enables the automatic-clock configuration.
active Enables the active operation.
prefer (Optional) Negotiates the specified mode with the far end of the link.
passive Enables the passive operation.
Command Default auto
Command Modes Interface configuration
Command History Release Modification
12.2(17a)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is supported on the 1000BASE-T transceivers only.
If the clock mode of the near end of a link does not match the clock mode of the far end, the line protocol
does not come up.
The active and passive clock status is determined during the auto negotiation process before the transmission
link is established.
The clock command supports the following configurations:
• auto --Auto negotiates with the far end of the link but preference is given to the active-clock switch.
• active --Uses a local clock to determine transmitter-operation timing.
• passive --Recovers the clock from the received signal and uses the recovered clock to determine
transmitter-operation timing.
• active prefer --Auto negotiates with the far end of the link but preference is given to the active-clock
switch.
• passive prefer --Auto negotiates with the far end of the link but preference is given to the passive-clock
switch.
Enter the show running-config interface command to display the current clock mode.
Enter the show interfaces command to display the clock mode that is negotiated by the firmware.
Cisco IOS Interface and Hardware Component Command Reference
196
cable bundle through clock mode
clock
Examples This example shows how to enable the active-clock operation:
Router(config-if)# clock active
Router(config-if)#
Related Commands Command Description
show interfaces Displays traffic that is seen by a specific interface.
show running-config interface Displays the status and configuration of the module or Layer 2 VLAN.
Cisco IOS Interface and Hardware Component Command Reference
197
cable bundle through clock mode
clock destination
clock destination
To specify the IP address of a Precision Time Protocol clock destination, use the clockdestination command
in interface configuration mode. To remove a clock destination configuration, use the no form of this command.
clock destination clock-ip-address
no clock destination clock-ip-address
Syntax Description clock-ip-address IP address of the clock destination.
Command Default No default behavior or values.
Command Modes Clock port configuration (config-ptp-port)
Command History Release Modification
15.0(1)S This command was introduced.
Usage Guidelines If the clock port is set to master mode with unicast and negotiation is disabled, you can only configure a single
destination. If the clock port is set to master mode with unicast negotiation, you do not need to use this
command because the device uses negotiation to determine the IP address of PTP slave devices.
Examples The following example shows how to configure a PTP clock destination:
Device> enable
Device# configure terminal
Device(config)# ptp clock ordinary domain 0
Device(config-ptp-clk)# clock-port masterPort master
Device(config-ptp-port)# clock destination 192.168.1.2
Device(config-ptp-port)# end
Related Commands Command Description
clock source Specifies a PTP clock source.
Cisco IOS Interface and Hardware Component Command Reference
198
cable bundle through clock mode
clock mode
clock mode
To configure the clock mode of a serial circuit emulation (CEM) channel, use the clockmode command in
CEM configuration mode. To reset the clock mode to its default, use the no form of this command.
clock mode {normal|split}
no clock mode
Syntax Description normal Specifies normal mode, in which the DCE, whether it is a CEM over IP (CEoIP) data port or the
external data device, provides both the receive clock and the transmit clock to the DTE.
split Specifies split mode, in which the DCE, whether it is a CEoIP data port or the external device,
provides the receiver clock to the DTE and the DTE provides the transmit clock to the DCE.
Command Default The serial CEM channel clock defaults to normal mode.
Command Modes CEM configuration
Command History Release Modification
12.3(7)T This command was introduced.
Usage Guidelines This command applies only to serial ports.
Examples The following example shows how to configure the CEM clock for normal mode.
Router(config-cem)# clock mode normal
Related Commands Command Description
cem Enters circuit emulation configuration mode.
clock rate Configures the clock rate of a serial port.
clock source Configures the clock source of a serial port.
show cem Displays CEM statistics.
Cisco IOS Interface and Hardware Component Command Reference
199
cable bundle through clock mode
clock mode
Cisco IOS Interface and Hardware Component Command Reference
200
clock rate through cut-through
• clock rate, on page 203
• clock rate (interface ATM), on page 205
• clock rate (interface serial), on page 207
• clock rate network-clock, on page 210
• clock recovered adaptive/differential cem, on page 211
• clock source, on page 212
• clock source(10GE), on page 214
• clock source (AS5200), on page 216
• clock source (CEM), on page 217
• clock source (controller), on page 220
• clock source (CT3IP), on page 223
• clock source (interface), on page 225
• clock source (J1 controller), on page 227
• clock source (MC3810), on page 228
• clock source (SONET controller), on page 230
• clock source (T1 E1 controller), on page 231
• clock source (T1 E1 interface), on page 233
• clock source (T3 E3 controller), on page 235
• clock switchover, on page 236
• clock-port, on page 237
• cmt connect, on page 239
• cmt disconnect, on page 241
• compress, on page 243
• compress mppc, on page 248
• compress stac caim, on page 249
• connect (module), on page 251
• constellation, on page 254
• control-lead sampling-rate, on page 256
• control-lead state, on page 257
• controller, on page 259
• controller dsl, on page 262
• controller dwdm, on page 264
• controller e3, on page 265
Cisco IOS Interface and Hardware Component Command Reference
201
clock rate through cut-through
• controller mediatype, on page 266
• controller protection-group, on page 267
• controller sdh, on page 268
• controller sonet, on page 269
• controller sonet-acr, on page 271
• controller t1/e1, on page 272
• controller t3, on page 273
• copy flash lex, on page 275
• copy tftp lex, on page 276
• crc, on page 277
• crc bits 5, on page 278
• crc4, on page 279
• crc-threshold, on page 280
• ctunnel mode, on page 281
• cut-through, on page 283
Cisco IOS Interface and Hardware Component Command Reference
202
clock rate through cut-through
clock rate
clock rate
To configure the clock rate for the hardware connections on serial interfaces such as network interface modules
(NIMs) and interface processors to an acceptable bit rate, use the clockrate command in interface configuration
mode. To remove the clock rate if you change the interface from a DCE to a DTE device, use the no form of
this command. Using the no form of this command on a DCE interface sets the clock rate to the
hardware-dependent default value.
clock rate bps
no clock rate
Syntax Description bps Desired clock rate, in bits per second: 1200, 2400, 4800, 9600, 19200, 38400, 56000, 64000, 72000,
125000, 148000, 250000, 500000, 800000, 1000000, 1300000, 2000000, 4000000, or 8000000
For the synchronous serial port adapters (PA-8T-V35, PA-8T-X21, PA-8T-232, and PA-4T+), a
nonstandard clock rate can be used. You can enter any value from 300 to 8000000 bps. The clock rate
you enter is rounded (adjusted), if necessary, to the nearest value that your hardware can support except
for the following standard rates: 1200, 2400, 4800, 9600, 14400, 19200, 28800, 38400, 56000, 64000,
128000, or 2015232.
Command Default No clock rate is configured.
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
11.3 This command was modified to include nonstandard clock rates for the PA-8T-V35,
PA-8T-X21, PA-8T-232, and PA-4T+ synchronous serial port adapters.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Cable Length
Be aware that the fastest speeds might not work if your cable is too long, and that speeds faster than 148,000
bits per second are too fast for EIA/TIA-232 signaling. It is recommended that you only use the synchronous
serial EIA/TIA-232 signal at speeds up to 64,000 bits per second. To permit a faster speed, use EIA/TIA-449
or V.35.
Synchronous Serial Port Adapters
For the synchronous serial port adapters (PA-8T-V35, PA-8T-X21, PA-8T-232, and PA-4T+) on Cisco 7200
series routers, and on second-generation Versatile Interface Processors (VIP2s) in Cisco 7500 series routers,
the clock rate you enter is rounded (if needed) to the nearest value that your hardware can support. To display
the clock rate value for the port adapter, use the showrunning-configcommand.
Cisco IOS Interface and Hardware Component Command Reference
203
clock rate through cut-through
clock rate
If you plan to netboot your router over a synchronous serial port adapter interface and have a boot image prior
to Cisco IOS Release 11.1(9)CA that does not support nonstandard (rounded) clock rates for the port adapters,
you must use one of the following standard clock rates:
• 1200
• 2400
• 4800
• 9600
• 19200
• 38400
• 56000
• 64000
Examples The following example shows how to set the clock rate on the first serial interface to 64,000 bps:
Router(config)# interface serial 0
Router(config-if)# clock rate 64000
The following example shows how to set the clock rate on a synchronous serial port adapter in slot
5, port 0 to 1,234,567 bps. In this example, the clock rate is adjusted to 1,151,526 bps.
Router(config)# interface serial 5/0
Router(config-if)# clock rate 1234567
%Clockrate rounded to nearest value that your hardware can support.
The following example shows how to determine the exact clock rate that the serial interface was
rounded to by using theshowrunning-config command.
Router# show running-config
Building configuration...
.
.
.
!
interface Serial5/0
no ip address
clockrate 1151526
!
.
.
.
Cisco IOS Interface and Hardware Component Command Reference
204
clock rate through cut-through
clock rate (interface ATM)
clock rate (interface ATM)
To configure the clock rate between a WAN interface card (WIC) and the serial communication controllers
(SCCs) that are used by the WIC, use the clockrate command in interface ATM configuration mode. To
disable the clock rate setting, use the no form of this command.
clock rate [{aal2|aal5}] clock-rate-value
no clock rate [{aal2|aal5}] clock-rate-value
Syntax Description aal2 (Optional) Specifies the ATM adaptation layer 2 (AAL2) clock rate.
aal5 (Optional) Specifies the ATM adaptation layer 5 (AAL5) clock rate.
clock-rate-value Clock rate value, which can be changed as follows:
• aal2
--ForCisco1700seriesrouters,theminimumvalueforasymmetricdigitalsubscriberline(ADSL)an
For Cisco 2600 and Cisco 3600 series routers, the minimum value for ADSL and G.SHDSL is 1
for ADSL and G.SHDSL is 2.6 Mbps for both mainboard slots and network modules .
To make full use of the 2.3 Mbps bandwidth for Voice over ATM (VoATM) nonswitched trunk calls
AAL2 clock rate as 2.6 Mbps.
We recommend, however, that you keep the ADSL SCC clock rate for AAL2 at the default value of
Note You should change the AAL2 default value on Cisco 2600 and Cisco 3600 series routers o
AAL2 should remain at 1 Mbps for ADSL and G.SHDSL.
• aal5 --For Cisco 1700 series routers, the minimum value for ADSL and G.SHDSL is 4 Mbps. T
For Cisco 2600 and Cisco 3600 series routers, the minimum value for ADSL and G.SHDSL is 1 Mbp
G.SHDSL is 2.6 Mbps for both mainboard slots and network modules.
Note If you configure a clock rate that exceeds the maximum limit, the configuration will fail.
Command Default No clock rate is set
Command Modes Interface ATM configuration
Command History Release Modification
12.2(8)YN This command was introduced.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.
12.3(2)T This command was integrated into Cisco IOS Release 12.3(2)T for the following platforms:
Cisco 1721, Cisco 2610XM-2651XM, Cisco 2691, and Cisco 3660.
Usage Guidelines The communication between digital subscriber line (DSL) WICs and a host in a router occurs through a device
called the SCC. If a host wants to forward data or send any control traffic to a DSL WIC, it uses SCCs. In the
Cisco IOS Interface and Hardware Component Command Reference
205
clock rate through cut-through
clock rate (interface ATM)
same way, if a DSL WIC wants to forward incoming data from a line to the host, it also uses SCCs. Each
DSL WIC installed in the router uses two SCCs. One SCC (SCC-A) is used for AAL5 data traffic, and the
other SCC (SCC-B) is used for AAL2 and control traffic. The speed at which the SCC transfers data between
a host and a WIC depends on the clock rate with which it has been configured. You can configure this clock
rate on the basis of the DSL line rate. Even though the DSL upstream and downstream line rate may vary, the
clock rate between the SCC and the DSL WIC is the same for both the transmitting and receiving direction.
That is, the communication between the SCC and the DSL WIC is synchronous. Therefore, you need to
configure only one clock rate for an SCC that will be used for both transmitting and receiving between an
SCC and a DSL WIC.
We always recommend that you configure the SCC clock rate slightly higher than the DSL line rate to
accommodate overhead between the SCC and the DSL WIC. For an asynchronous DSL WIC (for example,
ADSL), the SCC clock rate depends on either the downstream or the upstream line rate, whichever is the
maximum rate. For a synchronous DSL WIC (for example, G.SHDSL), the bandwidth for upstream and
downstream is the same. Therefore, the SCC clock rate configuration can be based on either the upstream or
the downstream line rate.
Because the maximum line rate for G.SHDSL is 2.312 Mbps, the default SCC clock rate of 2.6 Mbps for
AAL5 and 1 Mbps for AAL2 should be sufficient. However, for ADSL, the clock rate may need to be configured
on the basis of the current line rate. If AAL2 is used for voice traffic, the AAL2 SCC must be configured to
the appropriate clock rate: 1 Mbps for ADSL and 2.6 Mbps for G.SHDSL.
The maximum data rate between an SCC and a DSL WIC depends primarily on the maximum clock rate that
the SCC can support. For example, on the Cisco 2600 series mainboard, which supports two DSL WICs, the
total SCC clock rate that can be configured for both WICs is 8 Mbps. Therefore, if only one DSL WIC is
present on the mainboard, AAL5 and AAL2 clock rates can be configured to 7 Mbps and 1 Mbps, respectively.
If two DSL WICs are supported on the mainboard, the total of 8 Mbps should be distributed among the four
SCCs.
Network module SCCs also pose similar limitations. That is, on the Cisco 2600 series, the total clock rate for
all four SCCs is 8 Mbps. The maximum AAL5 clock rate that may be configured on a network module is 5.3
Mbps. On the Cisco 1700 series, the maximum configurable SCC clock rate for both AAL5 and AAL2 is 8
Mbps.
If the clock rate is not configured, the SCC is reset to the default values.
The clock rate can be configured independently for each SCC. To verify the clock rate setting, use the
showrunning-config command.
Examples The following example shows how to set the clock rate to 2 Mbps for AAL5 and to 1.3 Mbps for
AAL2 for a Cisco 2600 or Cisco 3600 series router:
Router (config)# interface atm1/0
Router (config-if)# no ip address
Router (config-if)# no atm ilmi-keepalive
Router (config-if)# pvc 6/65
Router (config-if)# clock rate aal5 2000000
Router (config-if)# clock rate aal2 1300000
Router (config-if)# vbr-nrt 640 640 128
Router (config-if)# tx-ring-limit 3
Related Commands Command Description
show running-config Displays the current configuration.
Cisco IOS Interface and Hardware Component Command Reference
206
clock rate through cut-through
clock rate (interface serial)
clock rate (interface serial)
To configure the clock rate for the hardware connections on serial interfaces, such as network interface modules
(NIMs) and interface processors, to an acceptable bit rate, use the clockrate command in interface configuration
mode or Circuit Emulation Module (CEM) configuration mode. To remove the clock rate if you change the
interface from a DCE to a DTE device, use the no form of this command. Using the no form of this command
on a DCE interface sets the clock rate to the hardware-specific default value.
clock rate {linerate}
no clock rate
Syntax Description line Specifies that the clock source is the network.
Note This keyword is not supported on CEM serial interfaces.
rate Desired clock rate, in bits per second (bps): 1200, 2400, 4800, 9600, 19200, 38400, 56000, 64000,
72000, 125000, 148000, 250000, 500000, 800000, 1000000, 1300000, 2000000, 4000000, or 8000000
For some synchronous serial port adapters a nonstandard clock rate can be used. Refer to the hardware
documentation for specific supported Lvalues. You can enter any value from 300 to 8000000 bps.
The clock rate you enter is rounded (adjusted), if necessary, to the nearest value that your hardware
can support except for the following standard rates: 1200, 2400, 4800, 9600, 14400, 19200, 28800,
38400, 56000, 64000, 128000, or 2015232.
Command Default No clock rate is configured.
Command Modes Interface configuration CEM configuration in Circuit Emulation Module (CEM)
Command History Release Modification
10.0 This command was introduced.
11.3 This command was modified to include nonstandard clock rates for the PA-8T-V35,
PA-8T-X21, PA-8T-232, and PA-4T+ synchronous serial port adapters.
12.3(2)T This command was modified to include the line keyword.
12.4(5)M The value range for the rate argument was updated to support additional baud rates of 300,
600, 1792K, and 1920K bps on CEM Network Modules.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Using the no form of this command on a DCE interface sets the clock rate to the hardware-dependent default
value.
Cable Length
Cisco IOS Interface and Hardware Component Command Reference
207
clock rate through cut-through
clock rate (interface serial)
Be aware that the fastest speeds might not work if your cable is too long and that speeds faster than 148,000
bits per second are too fast for EIA/TIA-232 signaling. It is recommended that you use the synchronous serial
EIA/TIA-232 signal at speeds up to 64,000 bits per second only. To permit a faster speed, use EIA/TIA-449
or V.35.
Synchronous Serial Port Adapters
For the synchronous serial port adapters (PA-8T-V35, PA-8T-X21, PA-8T-232, and PA-4T+) on Cisco 7200
series routers and on second-generation Versatile Interface Processors (VIP2s) in Cisco 7500 series routers,
the clock rate that you enter is rounded (if needed) to the nearest value that your hardware can support. To
display the clock rate value for the port adapter, use the showrunning-configcommand.
If you plan to boot from a network (TFTP) server over a synchronous serial port adapter interface and have
a boot image prior to Cisco IOS Release 11.1(9)CA that does not support nonstandard (rounded) clock rates
for the port adapters, you must use one of the following standard clock rates:
1200, 2400, 4800, 9600, 19200, 38400, 56000, 64000
CEM Network Modules
The following clock rates are supported on CEM Network Modules:
200, 300, 400, 600, 800, 1200, 1800, 2400, 3200, 3600, 4800, 6400, 7200, 8000, 9600, 12000, 12800, 14400,
16000, 16800, 19200, 24000, 28800, 32000, 38400, 48000, 56000, 57600, 64000, 76800, 84000, 96000,
112000, 115200, 128000, 144000, 168000, 192000, 224000, 230400, 256000, 288000, 336000, 384000,
448000, 512000, 672000, 768000, 772000, 896000, 1024000, 1152000, 1344000, 1536000, 1544000, 1792000,
1920000, 2048000
Examples
Network as Clock Source Example
The following example shows how to set the clock rate to use the network as the clock source:
Router(config)# interface serial 0
Router(config-if)# clock rate line
Clock Rate on Synchronous Serial Port Example
The following example shows how to set the clock rate on a synchronous serial port adapter in slot
5, port 0 to 1,234,567 bps. In this example, the clock rate is adjusted to 1,151,526 bps.
Router(config)# interface serial 5/0
Router(config-if)# clock rate 1234567
%Clockrate rounded to nearest value that your hardware can support.
Clock Rate Rounded on Serial Enterface Example
The following example shows how to determine the exact clock rate that the serial interface was
rounded to by using theshowrunning-config command.
Router# show running-config
Building configuration...
.
Cisco IOS Interface and Hardware Component Command Reference
208
clock rate through cut-through
clock rate (interface serial)
.
.
!
interface Serial5/0
no ip address
clockrate 1151526
!
CEM Channel Example
This example shows the statistics for the current CEM configuration.
Router# show cem 4/1/0
cem info
cem 4/1/0 is up
Line state is up
Operational state is active
Near end ip address: 172.31.28.2, udp port: 15901
Far end ip address: 172.31.28.10, udp port: 15901
IP payload size: 512
IP dscp : 0x28
Idle pattern length: 8 , Idle Pattern: 0xFF
Payload compression is disabled
Data protection is disabled
Dejitter buffer size is 60 ms
Channel clock rate is 2048000 bps
Physical interface is E1 unframed
Ingress packets: 32505156, dropped: 0, overruns: 0
Egress packets: 32505158, dropped: 637, lost pkts: 0
Egress out of sequence pkts: 0
Egress overruns: 16, underruns: 244
Egress corrupt pkts rcvd: 0
30 second ingress rate 2050321 bits/sec, 500 packets/sec
30 second egress rate 2050184 bits/sec, 500 packets/sec
Tx interrupts: 32504249
Reorder queue flush: 0, visited: 0, max wait window: 0
Network jitter max: 8 ms, average: 1 ms, min: 0 ms
Adaptive clock ppm correction is 2 tracking
Event history: 0x00230058
Pkts dropped by burst limit: 0
Global stats for slot 4
************************
Egr free buf: 255
Egr host overruns: 0
Egr unknown dest count: 0
Last unknown dest ip : 0.0.0.0, port: 0
Last unknown dest src ip : 0.0.0.0, port: 0
Egr process switched: 0
Egr oos: 0
Egr unknown src count: 0, last unknown src ip: 0.0.0.0, port: 0
Ingr overruns: 0
NM cpu: 53.56 53.51 53.45 53.54
Related Commands Command Description
show running-config Displays the current configuration.
show cem Displays circuit emulation statistics.
Cisco IOS Interface and Hardware Component Command Reference
209
clock rate through cut-through
clock rate network-clock
clock rate network-clock
To configure the network clock rate (speed) for serial ports 0 or 1 in DCE mode, use the
clockratenetwork-clock command in interface configuration mode. To cancel the network clock rate value,
use the no form of this command.
clock rate network-clock rate
no clock rate network-clock rate
Syntax Description rate Network clock rate, in kbps per second. The range is from 56 to 2048. The value entered should be
a multiple of the value set for the network-clockbase-rate command. There is no default rate.
Command Default No clock rate is set.
Command Modes Interface configuration
Command History Release Modification
11.3(1)MA This command was introduced on the Cisco MC3810 multiservice access concentrator.
Usage Guidelines This command uses a synchronized clock on the serial port. The use of this command allows the clock on the
serial port to be synchronized with the clock source of controller T1 0.
To configure the clock rate for a serial port in DTE mode, use the clockrateline command.
Examples The following example shows how to configure the clock rate on serial port 1 in DCE mode:
Router(config)# interface serial 1
Router(config-if)# clock rate network-clock 2048
Related Commands Command Description
clock rate line Configures the line clock rate for serial ports 0 or 1 in DTE mode.
clock source (MC3810) Specifies the clock source of a DS1 link on the Cisco MC3810 multiservice
access concentrator.
network-clock base-rate Configures the network clock base rate for universal I/O serial ports 0 and 1 on
the Cisco MC3810 multiservice concentrator.
Cisco IOS Interface and Hardware Component Command Reference
210
clock rate through cut-through
clock recovered adaptive/differential cem
clock recovered adaptive/differential cem
To associate the clock recovered ID to the CEM group use the clock recovered adaptive or differential cem
command in recovered clock mode
This command is also applicable to Cisco ASR 900 Series Routers.
clock recovered clock id adaptive cem cem group no port-no
clock recovered clock id differential cem cem group no port-no
Command Default None
Command Modes Recovered clock mode
Command History Release Modification
XE 3.18SP This command was integrated into the Cisco NCS 4200 Series
XE Everest This command is introduced on the Cisco ASR 900 Series Routers.
16.5.1
Usage Guidelines This command is used to associate the clock recovered ID to the CEM group.
The following example shows how to associate the clock recovered ID to the CEM group.
recovered-clock 0 3
clock recovered 1 adaptive cem 0 1
The following example shows how to associate the clock recovered ID to the CEM group.
recovered-clock 0 3
clock recovered 1 differential cem 0 1
Table 7:
Related Commands
Command Description
recovered-clock Configures an associated clock ID with the
corresponding CEM circuit.
Cisco IOS Interface and Hardware Component Command Reference
211
clock rate through cut-through
clock source
clock source
To configure the clock source of a DS1 link, enter the clocksource command in interface configuration,
controller configuration, or ATM interface configuration mode. To restore the default line setting, use the no
form of this command.
clock source {line|internal|loop-timed}
no clock source
Syntax Description line Specifies that the T1/E1 link uses the recovered clock from the line. This is the default.
internal Specifies that the T1/E1 link uses the internal clock from the interface.
loop-timed Specifies that the T1/E1 interface takes the clock from the Rx (line) and uses it for Tx.
Command Default The default value is line.
Command Modes Interface configuration
Controller configuration for the Cisco MC3810 multiservice access concentrator.
ATM interface configuration for the Cisco 2600 and 3600 series routers.
Command History Release Modification
10.3 This command was introduced.
11.1 CA This command was modified to support the E1-G.703/G.704 serial port adapter,
PA-E3 serial port adapters, and Cisco 7200 series routers.
11.3 MA This command was introduced as a controller configuration command for the Cisco
MC3810.
12.0(5)T and 12.0(5)XK The command was introduced as an ATM interface configuration command for
the Cisco 2600 and 3600 series routers.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a
specific 12.2SX release of this train depends on your feature set, platform, and
platform hardware.
Usage Guidelines This command sets clocking for individual T1/E1 links.
Make sure that you specify the clock source correctly for each link, even if you are planning to specify that
a certain link will provide clocking for all the links in an IMA group. Because links may be taken in and out
of service, requiring that the system select another link for common clocking, any link in an IMA group may
provide the common clock.
If the ATM interface is part of an IMA group, you can use the loop-timed keyword to specify that the clock
source is the same as the IMA group clock source.
Cisco IOS Interface and Hardware Component Command Reference
212
clock rate through cut-through
clock source
Examples On a Cisco 2600 or 3600 series router, the following example specifies an internal clock source for
the link:
Router(config)# interface atm 0/2
Router(config-if)# clock source internal
Related Commands Command Description
ima clock-mode Sets the transmit clock mode for an ATM IMA group.
Cisco IOS Interface and Hardware Component Command Reference
213
clock rate through cut-through
clock source(10GE)
clock source(10GE)
To specify the clock source of a 10 Gigabit Ethernet (GE) line card, use the clocksource command in interface
configuration mode. To restore the clock source to its default setting, use the no form of this command.
clock source {internal|line|loop}
no clock source {internal|line|loop}
Syntax Description internal Uses the internal clock. This is the default.
line Recovers the clock from the line.
loop Uses local loop timing.
Command Default The default is internal.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SRD1 This command was introduced for the 7600-ES+ITU-2TG and 7600-ES+ITU-4TG.
Usage Guidelines When the clock source is internal, the port receive (Rx) clock is not eligible as the system clock source. The
port transmit (Tx) clock is synchronized to the system clock.
When the clock source is line, the port Rx clock is eligible as the system clock source. The port Tx clock is
synchronized to the system clock.
When the clock source is loop, the port Rx clock is not eligible as the system clock source. The port Tx clock
is synchronized to its own Rx clock.
Examples The following example shows how to specify line timing as the clock source:
Router(config)# interface TenGigabitEthernet 1/1
Router(config-if)# clock source line
The following example shows how to specify the internal clock on the interface provided by the
7600-ES+ITU-2TG or the 7600-ES+ITU-4TG:
Router(config)# interface TenGigabitEthernet 1/1
Router(config-if)# clocksourceinternal
Related Commands Command Description
network-clock select Selects a source for the network clock.
show network-clocks Displays the current configured and active network clock
sources.
Cisco IOS Interface and Hardware Component Command Reference
214
clock rate through cut-through
clock source(10GE)
Command Description
show platform hardware network-clocks Displays network clocks for an ES+ line card.
Cisco IOS Interface and Hardware Component Command Reference
215
clock rate through cut-through
clock source (AS5200)
clock source (AS5200)
To select the clock source for the time-division multiplexing (TDM) bus in a Cisco AS5200 access server,
use the clocksource command in interface configuration mode. To restore the clock source to its default
setting, use the no form of this command.
clock source {line {primary|secondary}|internal}
no clock source line {primary|secondary}
Syntax Description line Clock source on the active line.
primary Primary TDM clock source.
secondary Secondary TDM clock source.
internal Selects the free running clock (also known as internal clock) as the clock source.
Command Default The primary TDM clock source is from the T1 0 controller.
The secondary TDM clock source is from the T1 1 controller.
Command Modes Interface configuration
Command History Release Modification
11.2 This command was introduced.
12.2(13)T This command is no longer supported in Cisco IOS Mainline or Technology-based (T) releases.
It may continue to appear in 12.2S-Family releases.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines To use the clocking coming in from a T1 line, configure the clocksourcelineprimary command on the T1
interface that has the most reliable clocking. Configure the clocksourcelinesecondary command on the T1
interface that has the next best known clocking. With this configuration, the primary line clocking is backed
up to the secondary line if the primary clocking shuts down.
Examples The following example configures the Cisco AS5200 access server to use T1 controller 0 as the
primary clock source and T1 controller 1 as the secondary clock source:
Router(config)# controller t1 0
Router(config-controller)# clock source line primary
Router(config)# controller t1 1
Router(config-controller)# clock source line secondary
Cisco IOS Interface and Hardware Component Command Reference
216
clock rate through cut-through
clock source (CEM)
clock source (CEM)
To configure the clock source of a circuit emulation (CEM) network module port, use the clocksource
command in CEM configuration mode or controller configuration mode. To return to the default clock source,
use the no form of this command.
Cisco NM-CEM-4SER
clock source {internal|loop|adaptive}
no clock source {internal|loop|adaptive}
Cisco NM-CEM-4TE1
clock source {internal|line|adaptive channel-number [{closed-loop|open-loop|coarse}]}
no clock source {internal|line|adaptive channel-number [{closed-loop|open-loop|coarse}]}
Cisco NCS4200 Series
clock source {internal|line|recovered}
no clock source {internal|line|recovered}
Syntax Description internal Specifies that the clocks provided by the port to the attached CPE are derived from the
router’s TDM bus backplane clock (if one exists in the router) or from the onboard
oscillator on the network module. This is the default clock source for a Cisco
NM-CEM-4SER.
For Cisco NCS 4200 Series, internal is the default clock source for channelized mode.
loop (Cisco NM-CEM-4SER network module only) Specifies that the clock provided by the
port to the attached CPE is derived from the clock received on the same port from the
attached CPE.
line (Cisco NM-CEM-4TE1 network module only) Specifies that the port transmit clock is
derived from receive clock on the same port. This is the default clock source for a Cisco
NM-CEM-4TE1.
For Cisco NCS 4200 Series, line is the default clock source for un-channelized mode.
adaptive Specifies that the clocks provided by the port to the attached CPE are locally synthesized
on the basis of the average data content of the local dejitter buffer.
channel-number (Cisco NM-CEM-4TE1 network module only) Number of the channel whose dejitter
buffer is to be used to synthesize the transmit clock of the port.
closed-loop (Optional; Cisco NM-CEM-4TE1 network module only) Specifies that the adaptive clock
algorithm enhancements are used to improve the adaptive clock accuracy. The same clock
must be used in both directions for the closed loop mode. This keyword is supported in
Cisco IOS Release 12.4(2)T and later releases.
open-loop (Optional; Cisco NM-CEM-4TE1 network module only) Specifies that some of the
adaptive clock algorithm enhancements are used but the clocks do not have to be the
same in both directions. This is the default. This keyword is supported in Cisco IOS
Release 12.4(2)T and later releases.
Cisco IOS Interface and Hardware Component Command Reference
217
clock rate through cut-through
clock source (CEM)
coarse (Optional; Cisco NM-CEM-4TE1 network module only) Specifies that the original
adaptive clock algorithm without the enhancements is used. This keyword is supported
in Cisco IOS Release 12.4(2)T and later releases.
recovered Specifies the recovered clock number. This applies the recovered clock from a CEM
interface on a T1/E1 Controller.
Command Default The clock source defaults to internal.
The clock source defaults to line
Command Modes CEM configuration
Controller configuration
Controller configuration
Command History Release Modification
12.3(7)T This command was introduced.
12.4(2)T The closed-loop, open-loop, and coarse keywords were added.
XE 3.18SP This command was integrated in Cisco NCS 4200 Series.
XE Everest This command was integrated in Cisco NCS 4200 Series and Cisco ASR 900 Series
16.5.1 Routers.
Usage Guidelines When clock source internal is specified, the clocks provided by the network module are derived from either
of the following source:
• The router’s backplane TDM clock frequency (in any router equipped with a TDM backplane bus)
• The master oscillator on the network module (in any router not equipped with a TDM backplane bus)
When the adaptive keyword is specified, the clocks provided by the network module are derived from the
same source as in the clock source internal case. However, the derived frequency is further adjusted up or
down on the basis of the measured average fill of the egress dejitter buffer of the connection. If the dejitter
buffer is perceived to be slowly filling, the frequency is adjusted slightly upward. If the dejitter buffer is
perceived to be slowly depleting, the frequency is adjusted slightly downward.
Cisco NM-CEM-4SER
When the loop keyword is specified, the clock provided by the NM-CEM-4SER is the same as the clock
provided to the NM-CEM-4SER from the attached CPE. The specification of clock source loop is only valid
when the clockmodesplit command is specified. The clockmode command is used only during configuration
of the NM-CEM-4SER.
Cisco NM-CEM-4TE1
In Cisco IOS Release 12.4(2)T, the adaptive clocking algorithm is enhanced to provide better adaptive clock
accuracy. Three new keywords are used to specify the preferred mode:
• closed-loop --Specifies the closed loop mode. Taking advantage of the fact that a T1 or E1 link uses the
same clock in both directions, the adaptive clock algorithm enhancements are used to improve the adaptive
clock accuracy. The same clock must be used in both directions for the closed loop mode, and both ends
Cisco IOS Interface and Hardware Component Command Reference
218
clock rate through cut-through
clock source (CEM)
of the CEM must be running a Cisco IOS release that supports the enhanced adaptive clock algorithm.
Use the closed loop mode when clock accuracy is required, the master clock from the customer premises
equipment (CPE) is of good quality, and the clocks are the same in both directions of the T1 or E1 link.
Note Do not use the closed loop mode in applications where the clocks are different for the two directions of the
T1 or E1 link.
• open-loop --Specifies the open loop mode. Some of the adaptive clock algorithm is used, but this mode
does not require the clocks to be the same in both directions. This mode is compatible with previous
Cisco IOS releases and is the default mode if no keyword is specified. Use the open loop mode when
the master clock from the CPE is of good quality, but the clocks are not the same in both directions of
the T1 or E1 link.
• coarse --Specifies the coarse mode. The coarse mode uses the original adaptive clock algorithm and is
used when the stability of the master clock derived from the CPE is not guaranteed. This mode is
compatible with previous Cisco IOS releases.
Examples The following example shows how to configure the clock source for the serial CEM network module,
NM-CEM-4SER:
Router(config-cem)# clock source loop
The following example shows how to configure the clock source for the T1/E1 CEM network module,
NM-CEM-4TE1:
Router(config-controller)# clock source adaptive 6
The following example shows how to configure the clock source for an NM-CEM-4TE1 using the
closed-loop mode to improve the adaptive clock accuracy:
Router(config-controller)# clock source adaptive 5 closed-loop
The following example shows how to configure the clock source for the T1 or T3 CEM network
module:
Router(config-controller)# clock source recovered 1
Related Commands Command Description
cem Enters circuit emulation configuration mode.
clock mode Configures the clock mode on an NM-CEM-4SER network module.
show cem Displays CEM channel statistics.
Cisco IOS Interface and Hardware Component Command Reference
219
clock rate through cut-through
clock source (controller)
clock source (controller)
To set the T1 line clock source, use the clock source command in controller configuration mode. To restore
the clock source to its default setting, use the no form of this command.
Cisco 4400 Integrated Services Routers
clock source [{line {primary |secondary} | internal |network}]
no clock source
Cisco 7200 and Cisco 7500 Series Routers
clock source [{line {primary |secondary} |internal}]
no clock source
Cisco 10000 Series Router
clock source [{line |internal}]
no clock source
Syntax Description line (Optional) Specifies that the interface will clock its transmitted data from a clock recovered
from the line’s receive data stream. This is the default.
primary Specifies the source of primary line clocking. The default primary time-division multiplexing
(TDM) clock source is from the T0 controller.
secondary Specifies the source of secondary line clocking. The default secondary TDM clock source is
from the T1 controller.
internal (Optional) Specifies that the interface will clock its transmitted data from its internal clock.
network (Optional) Specifies that the master clock is from the module’s TDM switch. This is required
for voice applications.
Command Default Cisco 4400 Integrated Services Routers
The default clock source is line.
Cisco 7200 and Cisco 7500 Series Routers
The default clock source is line. The default primary TDM clock source is from the T0 controller. The default
secondary TDM clock source is from the T1 controller. The default clock for the interface’s transmitted data
is from a clock recovered from the line’s receive data stream from the PA-T3 serial port adapter.
Cisco 10000 Series Router
The default clock source is internal.
Command Modes Controller configuration
Command History Release Modification
10.3 This command was introduced.
Cisco IOS Interface and Hardware Component Command Reference
220
clock rate through cut-through
clock source (controller)
Release Modification
11.1CA This command was modified to include the T3 serial port adapter and PA-T3
serial port adapter.
12.2(31)SB This command was integrated into Cisco IOS Release 12.2(31)SB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in
a specific 12.2SX release of this train depends on your feature set, platform, and
platform hardware.
Cisco IOS XE Release This command was modified to include the network keyword.
3.9S
Usage Guidelines This command is available on Cisco 4000, Cisco 4400 ISR, Cisco 7000 series, Cisco 7200 series, Cisco 7500
series, and Cisco 10000 series routers. A T3 interface on a PA-T3 serial port adapter can clock its transmitted
data either from its internal clock or from a clock recovered from the line’s receive data stream.
Clocking on a T1 Line
To use the clocking coming in from a T1 line, configure the clock source line primary command on the
controller that has the most reliable clocking. Configure the clock source line secondary command on the
controller that has the next best known clocking. With this configuration, the primary line clocking is backed
up to the secondary line if the primary clocking shuts down.
Cisco 10000 Series Router
The clock source cannot be specified as line on both ends of the connection.
Cisco 4400 ISR Series
The following example sets the master clock to the TDM switch:
Device(config)# controller t1 0/1/0
Device(config-controller)# clock source network
Cisco 7200
The following example shows how to configure the Cisco 7200 to use the T0 controller as the primary
clocking source and the T1 controller as the secondary clocking source:
C7200(config)# controller t1 0
C7200(config-controller)# clock source line primary
C7200(config-controller)# exit
C7200(config)# controller t1 1
C7200(config-controller)# clock source line secondary
Cisco 10000 Series Router
The following example instructs the controller to use a line clock source:
Cisco IOS Interface and Hardware Component Command Reference
221
clock rate through cut-through
clock source (controller)
Device(config)# controller dsx3 4/0/6
Device(config-controller)# clock source line
Related Commands Command Description
framing Selects the frame type for the T1 or E1 data line.
linecode Selects the line code type for T1 or E1 line.
Cisco IOS Interface and Hardware Component Command Reference
222
clock rate through cut-through
clock source (CT3IP)
clock source (CT3IP)
To specify where the clock source is obtained for use by the Channelized T3 Interface Processor (CT3IP) in
Cisco 7500 series routers, use the clocksource command in controller configuration mode. To restore the
default clock source, use the no form of this command.
clock source {internal|line|loop-timed}
no clock source
Syntax Description internal Specifies that the internal clock source is used. This is the default.
line Specifies that the network clock source is used.
loop-timed Decouples the controller clock from the system-wide clock set with the network-clock-select
command. The loop-timed clock enables the Digital Voice Module (DVM) to connect to a
PBX and to connect the Multiflex Trunk Module (MFT) to a central office when both the PBX
and the central office function as DCE clock sources. This situation assumes that the PBX
also takes the clocking from the central office, thereby synchronizing the clocks on the DVM
and the MFT.
Command Default The internal clock source is used.
Command Modes Controller configuration
Command History Release Modification
11.3 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines If you do not specify the clocksourcecommand, the default internal clock source is used by the CT3IP.
You can also set the clock source for each T1 channel by using the t1clocksource controller configuration
command.
Note This command replaces the posinternal-clock command.
Examples The following example sets the clock source for the CT3IP to line:
Router(config)# controller t3 9/0/0
Router(config-controller)# clock source line
Cisco IOS Interface and Hardware Component Command Reference
223
clock rate through cut-through
clock source (CT3IP)
Related Commands Command Description
network-clock-select Specifies selection priority for the clock sources.
t1 clock source Specifies where the clock source is obtained for use by each T1 channel on the
CT3IP in Cisco 7500 series routers.
Cisco IOS Interface and Hardware Component Command Reference
224
clock rate through cut-through
clock source (interface)
clock source (interface)
To control the clock from which a G.703-E1 interface, an E1-G.703/G.704 serial port adapter, or a PA-E3
serial port adapter clocks its transmitted data, use the clocksource command in interface configuration mode.
To restore the default clock source, use the no form of this command.
Cisco ASR 901 Series Aggregation Services Routers
clock source {line|internal|loop}
no clock source
Cisco AS5300 Access Servers
clock source {line {primary|secondary}|internal}
no clock source line {primary|secondary}
Cisco ASR 901 Series Aggregation Services Routers
clock source {line|internal|loop}
no clock source
Syntax Description line Specifies that the interface will clock its transmitted data from a clock recovered from the line’s
receive data stream. This is the default.
internal Specifies that the interface will clock its transmitted data from its internal clock.
primary Specifies the primary time-division multiplexing (TDM) clock source.
loop Specifies that the system clock-selection process selects the clock source line as the interface.
For the transmit (Tx) clock, the interface uses the clock source received on the same interface.
loop Specifies that the system clock-selection process selects the clock source line as the interface.
For the transmit (Tx) clock, the interface uses the clock source received on the same interface.
Command Default Cisco 7000, Cisco 7200, and Cisco 7500 Series
The clock source is obtained from the receive data stream of the line.
Cisco AS5300 Access Servers
The primary TDM clock source is from the T0 controller. The secondary TDM clock source is from the T1
controller.
Cisco ASR 901 Series Aggregation Services Routers
The default clock source is internal.
Command Modes Interface configuration
Command History Release Modification
10.3 This command was introduced for the Cisco 4000 series, Cisco 7000 series w ith RSP7000,
and Cisco 7500 series routers with the G.703 E1 interface.
Cisco IOS Interface and Hardware Component Command Reference
225
clock rate through cut-through
clock source (interface)
Release Modification
11.1 CA This command was implemented on the TDM bus in a Cisco AS5200 or Cisco AS5300 access
server and was modified to support the E1-G.703/G.704 serial port adapter, PA-E3 serial port
adapters, and Cisco 7200 series routers.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
15.1(2)SNG This command was implemented on Cisco ASR 901 Series Aggregation Services Routers.
The loop keyword was added.
15.1(2)SNG This command was implemented on Cisco ASR 901 Series Aggregation Services Routers.
The loop keyword was added.
Usage Guidelines Cisco 7000, Cisco 7200, and Cisco 7500 Series
A G.703-E1 interface , E1-G.703/G.704 serial port adapter, or a PA-E3 serial port adapter can clock its
transmitted data from either its internal clock or from a clock recovered from the line’s receive data stream.
Cisco AS5300 Access Servers
To use the clocking coming in from a T1 line, configure the clocksourcelineprimary command on the
controller that has the most reliable clocking. Configure the clocksourcelinesecondary command on the
controller that has the next best known clocking. With this configuration, the primary line clocking is backed
up to the secondary line if the primary clocking shuts down.
Examples
Cisco 7000, Cisco 7200, and Cisco 7500 Series
The following example shows how to configure the G.703-E1 interface to clock its transmitted data
from its internal clock:
Router(config)# interface serial 0/1
Router(config-if)# clock source internal
Cisco ASR 901 Series Aggregation Services Routers
The following example shows how to use an internal clock source:
Router(config-if)# clock source internal
Cisco ASR 901 Series Aggregation Services Routers
The following example shows how to use an internal clock source:
Router(config-if)# clock source internal
Cisco IOS Interface and Hardware Component Command Reference
226
clock rate through cut-through
clock source (J1 controller)
clock source (J1 controller)
To configure the clock source for a J1 controller, use the clock source command in controller configuration
mode. To restore the clock source to its default setting, use the no form of this command.
clock source {line|internal}
no clock source
Syntax Description line The controller recovers the external clock from the line and provides the recovered clock to the
internal (system) clock generator. The line value is the default clock source.
internal The controller synchronizes itself to the internal (system) clock.
Command Default Clock source is line for the J1 controller.
Command Modes Controller configuration
Command History Release Modification
11.1 T This command was introduced.
12.2(8)T The command was introduced as a J1 controller configuration command for the Cisco 2600
and Cisco 3600 series.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines If multiple network modules are present in the router, then each J1 controller must be given a separate priority
by configuration of the network-clock-select command. The controller having the highest priority will drive
the internal clock.
Examples The following example configures the clock source for line:
Router(config)# controller j1 3/0
Router(config-controller)# clock source line
Related Commands Command Description
network-clock-select Sets the selection priority for a clock source.
Cisco IOS Interface and Hardware Component Command Reference
227
clock rate through cut-through
clock source (MC3810)
clock source (MC3810)
To specify the clock source of a DS1 link on the Cisco MC3810 multiservice access concentrator, use the
clocksource command in controller configuration mode. To restore the clock source to its default setting, use
the no form of this command.
clock source {line|internal|loop-timed}
no clock source
Syntax Description line Specifies that the DS1 link uses the recovered clock. The line value is the default clock source
used when the Multiflex Trunk (MFT) is installed.
internal Specifies that the DS1 link uses the internal clock. The internal value is the default clock
source used when the Digital Voice Module (DVM) is installed.
loop-timed Specifies that the T1/E1 controller will take the clock from the Rx (line) and use it for Tx.
This setting decouples the controller clock from the system-wide clock set with the
network-clock-select command. The loop-timed clock enables the DVM to connect to a PBX
and to connect the MFT to a central office when both the PBX and the central office function
as DCE clock sources. This situation assumes that the PBX also takes the clocking from the
central office, thereby synchronizing the clocks on the DVM and the MFT.
Command Default Line (when the MFT is installed) Internal (when the DVM is installed)
Command Modes Controller configuration
Command History Release Modification
11.1 This command was introduced.
12.2(13)T This command is no longer supported in Cisco IOS Mainline or Technology-based (T) releases.
It may continue to appear in 12.2S-Family releases.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command applies to Voice-over-Frame Relay, Voice-over-ATM, and Voice-over-HDLC on the Cisco
MC3810.
Note You cannot configure the clock source to the line setting for both T1/E1 controllers at the same time.
Examples The following example configures the clock source for the MFT to internal, and the clock source for
the DVM line on a Cisco MC3810 multiservice access concentrator:
Cisco IOS Interface and Hardware Component Command Reference
228
clock rate through cut-through
clock source (MC3810)
Router(config)# controller T1 0
Router(config-controller)# clock source internal
Router(config)# controller T1 1
Router(config-controller)# clock source line
Cisco IOS Interface and Hardware Component Command Reference
229
clock rate through cut-through
clock source (SONET controller)
clock source (SONET controller)
To specify the clock source of a SONET controller, use the clocksource command in controller configuration
mode. To restore the clock source to its default setting, use the no form of this command.
clock source {internal|line|loop}
no clock source
Syntax Description internal Specifies that the clock source uses the internal clock provided by the Route Switch Controller
(RSC). This is the default.
line Specifies that the clock source uses the primary system clock from the optical line and the
recovered clock will go through the RSC phased locked loop (PLL) circuitry. Can be used when
one or more STM-1 cards are installed.
loop Specifies that the clock source uses the primary system clock from the optical line and the same
recovered clock is used in the transmit (tx) direction without going through the RSC PLL circuitry.
Can be used when only one STM-1 card is installed.
Command Default Internal
Command Modes Controller configuration
Command History Release Modification
10.3 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples The following example shows how to specify line timing as the clock source on a SONET controller
of an STM-1 card in physical slot number 2 on a Cisco AS5850:
Router(config)# controller sonet 2/0
Router(config-controller)# clock source line
Cisco IOS Interface and Hardware Component Command Reference
230
clock rate through cut-through
clock source (T1 E1 controller)
clock source (T1 E1 controller)
To set clocking for individual T1 or E1 links, use the clocksource command in controller configuration mode.
To return to the default, use the no form of this command.
clock source {line [{primary|bits|independent}]|internal [independent]|free-running}
no clock source
Syntax Description line Specifies that the phase-locked loop (PLL) on this controller derives its clocking from the
external source to which the controller is connected, which is generally the telephone
company central office (CO).
primary (Optional) Specifies that the PLL on this controller derives its clocking from the external
source to which the controller is connected. This option also puts a second port, which is
generally connected to the PBX, into looped-time mode. Both ports are configured with
line, but only the port connected to the external source is configured with primary.
bits (Optional) Specifies that the controller will derive clocking from the Building Integrated
Timing Supply (BITS).
independent (Optional) Specifies that the port can operate on an independent clocking domain. Before
this capability was added, on a 2-port VWIC-MFT, if both ports were configured as
clocksourceline, the 2-port was really looped, which meant that it was getting the clock
from the first port. With independent clocking mode, this dependency no longer exists, so
the keyword independent means that both ports can be independently clocked.
internal Specifies that the clock is generated from the T1 or E1 controller's internal PLL.
free-running Specifies a free-running clock derived from the oscillator on the motherboard, which is used
only for testing and back-to-back connections.
Command Default The default is line.
Command Modes Controller configuration
Command History Release Modification
12.2(2)XB This command was introduced in controller configuration mode for Cisco 2600 series and Cisco
3660 routers.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T.
12.2(15)T This command was implemented on the Cisco 2691 and the Cisco 3700 series.
12.3(4)XD The bits keyword was added.
12.3(7)T The bits keyword was integrated into Cisco IOS Release 12.3(7)T.
12.3(14)T This command was integrated into Cisco IOS Release 12.3(14)T and the independentkeyword
was added.
Cisco IOS Interface and Hardware Component Command Reference
231
clock rate through cut-through
clock source (T1 E1 controller)
Usage Guidelines For a detailed discussion of clock sources on individual ports, refer to “Clock Sources on Digital T1/E1 Voice
Ports” in the Voice Configuration Library at the following URL:
http://www.cisco.com/en/US/products/ps6441/prod_configuration_guide09186a0080565f8a.html
Examples The following example shows the router providing clock source to two controllers:
Router(config)# controller E1 1/0
Router(config-controller)# framing crc
Router(config-controller)# linecoding hdb3
Router(config-controller)# clock source internal
Router(config-controller)# ds0-group timeslots 1-15 type e&m-wink-start
!
Router(config)# controller E1 1/1
Router(config-controller)# framing esf
Router(config-controller)# linecoding b8zs
Router(config-controller)# clock source internal
Router(config-controller)# ds0-group timeslots 1-15 type e&m-wink-start
The following example shows the digital voice hardware receiving clocking for the PLL from E1
1/0 and using this clock as a reference to clock E1 1/1. If controller E1 1/0 fails, the PLL internally
generates the clock reference to drive E1 1/1.
Router(config)# controller E1 1/0
Router(config-controller)# framing crc
Router(config-controller)# linecoding hdb3
Router(config-controller)# clock source line
Router(config-controller)# ds0-group timeslots 1-15 type e&m-wink-start
!
Router(config)# controller E1 1/1
Router(config-controller)# framing crc4
Router(config-controller)# linecoding hdb3
Router(config-controller)# clock source internal
Router(config-controller)# ds0-group timeslots 1-15 type e&m-wink-start
The following example shows the router being configured to receive clocking from the BITS.
Router(config)# network-clock-participate slot 1
Router(config)# network-clock-select 1 E1 1/1
Router(config)# controller E1 1/1
Router(config-controller)# clock source line bits
Related Commands Command Description
controller Configures a T1 or E1 controller and enters controller configuration mode.
Cisco IOS Interface and Hardware Component Command Reference
232
clock rate through cut-through
clock source (T1 E1 interface)
clock source (T1 E1 interface)
To configure the clock source of a DS1 link, use the clocksource command in interface configuration or ATM
interface configuration mode. To restore the default line setting, use the no form of this command.
clock source {line|internal|loop-timed}
no clock source
Syntax Description line Specifies that the T1/E1 link uses the recovered clock from the line. This is the default.
internal Specifies that the T1/E1 link uses the internal clock from the interface.
loop-timed Specifies that the T1/E1 interface takes the clock from the Rx (line) and uses it for Tx.
Command Default line
Command Modes Interface configuration ATM interface configuration for the Cisco 2600 and Cisco 3600 series routers
Command History Release Modification
10.3 This command was introduced.
11.1CA This command was modified to support the E1-G.703/G.704 serial port adapter, PA-E3 serial
port adapters, and Cisco 7200 series routers.
11.3MA This command was introduced as a controller configuration command for the Cisco MC3810.
12.0(5)XK The command was introduced as an ATM interface configuration command for the Cisco
2600 and Cisco 3600 series routers.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command sets clocking for individual T1/E1 links.
Make sure that you specify the clock source correctly for each link, even if you are planning to specify that
a certain link will provide clocking for all the links in an IMA group. Because links may be taken in and out
of service, requiring that the system select another link for common clocking, any link in an IMA group may
provide the common clock.
If the ATM interface is part of an IMA group, you can use the loop-timed keyword to specify that the clock
source is the same as the IMA group clock source.
Examples On a Cisco 2600 or Cisco 3600 series router, the following example specifies an internal clock source
for the link:
Router(config)# interface atm 0/2
Router(config-if)# clock source internal
Cisco IOS Interface and Hardware Component Command Reference
233
clock rate through cut-through
clock source (T1 E1 interface)
Related Commands Command Description
ima clock-mode Sets the transmit clock mode for an ATM IMA group.
Cisco IOS Interface and Hardware Component Command Reference
234
clock rate through cut-through
clock source (T3 E3 controller)
clock source (T3 E3 controller)
To specify where the clock source is obtained for use by a T3 or E3 controller, use the clocksource command
in controller configuration mode. To restore the default clock source, use the no form of this command.
clock source {internal|line}
no clock source
Syntax Description internal Specifies that the internal clock source is used. This is the default for T3.
line Specifies that the network clock source is used. This is the default for E3.
Command Default The internal clock source is used for T3 controllers. The line clock source is used for E3 controllers.
Command Modes Controller configuration
Command History Release Modification
12.2(11)YT This command was introduced on the following platforms: Cisco 2650XM, Cisco 2651XM,
Cisco 2691, Cisco 3660 series, Cisco 3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
Usage Guidelines If you do not specify the clock source command, the default clock source is used.
Configure the clocksourceline command if your telephone company or the remote data service unit provides
the master clock of the T3 or E3 connection.
Configure the clocksourceinternal command if your router provides the master clock of the T3 or E3
connection.
Note For a back-to-back connection between two T3 or E3 network modules, one controller must be configured
for internal clocking while the other controller must be configured for line clocking.
Examples The following example shows how to set the clock source to line:
Router(config)# controller t3 1/0
Router(config-controller)# clock source line
Related Commands Command Description
controller Configures a T1 or E1 controller and enters controller configuration mode.
Cisco IOS Interface and Hardware Component Command Reference
235
clock rate through cut-through
clock switchover
clock switchover
To specify the input lead state change that triggers the clock switching over from line to internal or from
internal to line, use the clock switchover command in Data Circuit Terminating Equipment (DCE) split mode.
To disable the command's effect, use the no form of this command.
clock switchover {rts|dtr|ll|rl} {off|on}
no clock switchover {rts|dtr|ll|rl} {off|on}
Syntax Description off | on On - clock switches over to internal clock when lead state is on; clock switches over to the
CPE-provided clock when lead state is off. Default value.
Off - clock switches over to internal clock when lead state is off; clock switches over to the
CPE-provided clock when lead state is on.
Command Default The default state is on.
Command Modes DCE split mode (off / on).
Command History Release Modification
12.4(20)YA This command was introduced.
12.4(22)T This command is integrated into Cisco IOS Release 12.4(22)T.
Usage Guidelines You can use the clock switchover command to switch the clock source over to internal clock. This is to provide
continuity of the CEM channel when disruption of the RxC cable from the CPE occurs.
Examples The following example shows how the clock switchover <input_lead> <off | on > command is used
to check the input lead state for the clock switchover feature:
Router(mode-prompt
)# clock switchover <dtr> <off | on>
Cisco IOS Interface and Hardware Component Command Reference
236
clock rate through cut-through
clock-port
clock-port
To specify the clocking mode of a Precision Time Protocol clock port, enter clock port configuration mode
using the clock-port command in the PTP clock configuration mode. To remove a clocking mode configuration,
use the no form of this command.
clock-port name {slave|master}[{profile g8265.1}]
no clock-port name {slave|master}
Syntax Description name Specifies a name for the clock port.
slave Sets the clock port to PTP slave mode; the port exchanges timing packets with a PTP
master device.
master Sets the clock port to PTP master mode; the port exchanges timing packets with PTP slave
devices.
profile g8265.1 (Optional) Sets the clock to use the ITU-T G.8265.1 recommendations for establishing
PTP sessions, determining the best master clock, handling synchronization status message
(SSM), and mapping PTP classes.
Command Default This command is disabled by default.
Command Modes PTP clock configuration (config-ptp-clk)
Command History Release Modification
15.0(1)S This command was introduced.
15.1(2)SNG This command was implemented on Cisco ASR 901 Series Aggregation Services
Routers.
Cisco IOS Release The profile g8265.1 keyword was added on Cisco ASR 901 Series Aggregation
3.8S Services Routers.
Usage Guidelines This command defines a new clock port and enters clock port configuration mode.
Cisco IOS XE Release 3.8S introduces support for telecom profiles, which allow you to configure a clock
that uses the ITU-T G.8265.1 recommendations for establishing PTP sessions, determining the best master
clock, handling SSM, and mapping PTP classes.
Examples The following example shows how to configure a PTP clock port:
Device> enable
Device# configure terminal
Device# ptp clock boundary domain 0
Device(config-ptp-clk)# clock-port slave slaveport
Device(config-ptp-port)# clock source 8.8.8.1
Device(config-ptp-port)# sync limit 1
Device(config-ptp-port)# announce timeout 4
Cisco IOS Interface and Hardware Component Command Reference
237
clock rate through cut-through
clock-port
Device(config-ptp-port)# delay-req interval 2
Device(config-ptp-port)# end
Related Commands Command Description
ptp clock Creates a PTP clock instance.
Cisco IOS Interface and Hardware Component Command Reference
238
clock rate through cut-through
cmt connect
cmt connect
To start the processes that perform the connection management (CMT) function and to allow the ring on one
fiber to be started, use the cmtconnect command in user EXEC or privileged EXEC mode.
cmt connect [fddi [{port|slot/port}] [{phy-a|phy-b}]]
Syntax Description fddi (Optional) Identifies this as a FDDI interface.
port (Optional) Port number . Refer to the appropriate hardware manual for slot and port information.
slot (Optional) Slot n umber. Refer to the appropriate hardware manual for slot and port information.
phy-a (Optional) Selects Physical Sublayer A.
phy-b (Optional) Selects Physical Sublayer B.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines In normal operation, the FDDI interface is operational once the interface is connected and configured. The
cmtconnect command allows the operator to start the processes that perform the CMT function.
The cmtconnect command is not needed in the normal operation of FDDI; this command is used mainly in
interoperability tests.
This command does not have a no form. To stop the CMT processes, use the cmtdisconnect command.
Examples The following examples demonstrate use of the cmtconnect command for starting the CMT processes
on the FDDI ring.
The following command starts all FDDI interfaces:
Router# cmt connect fddi
The following command starts both fibers on FDDI interface unit 0:
Router# cmt connect fddi 0
The following command on the Cisco 7200 series or Cisco 7500 series starts both fibers on FDDI
interface unit 0:
Router# cmt connect fddi 1/0
Cisco IOS Interface and Hardware Component Command Reference
239
clock rate through cut-through
cmt connect
The following command starts only Physical Sublayer A on FDDI interface unit 0:
Router# cmt connect fddi 0 phy-a
Related Commands Command Description
cmt disconnect Stops the CMT processes.
Cisco IOS Interface and Hardware Component Command Reference
240
clock rate through cut-through
cmt disconnect
cmt disconnect
To stop the processes that perform the connection management (CMT) function and to allow the ring on one
fiber to be stopped, use the cmtdisconnect command in user EXEC or privileged EXEC mode.
cmt disconnect [fddi [{port|slot/port}] [{phy-a|phy-b}]]
Syntax Description fddi (Optional) Identifies this as a FDDI interface.
port (Optional) Port n umber. Refer to the appropriate hardware manual for slot and port information.
slot (Optional) Slot number. Refer to the appropriate hardware manual for slot and port information.
phy-a (Optional) Selects Physical Sublayer A.
phy-b (Optional) Selects Physical Sublayer B.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines In normal operation, the FDDI interface is operational once the interface is connected and configured, and is
turned on using the noshutdown command in interface configuration mode. The cmtdisconnect command
allows the operator to stop the processes that perform the CMT function and allow the ring on one fiber to be
stopped.
The cmtdisconnect command is not needed in the normal operation of FDDI; this command is used mainly
in interoperability tests.
This command does not have a no form. To start the CMT processes, use the cmtconnect command.
Examples The following examples demonstrate use of the cmtdisconnect command for stopping the CMT
processes on the FDDI ring.
The following command stops all FDDI interfaces:
Router# cmt disconnect fddi
The following command stops both fibers on FDDI interface unit 0:
Router# cmt disconnect fddi 0
The following command on the Cisco 7200 series or Cisco 7500 series stops both fibers on FDDI
interface unit 0:
Cisco IOS Interface and Hardware Component Command Reference
241
clock rate through cut-through
cmt disconnect
Router# cmt disconnect fddi 1/0
The following command stops only Physical Sublayer A on the FDDI interface unit 0. This command
causes the FDDI media to go into a wrapped state so that the ring will be broken.
Router# cmt disconnect fddi 0 phy-a
The following command on the Cisco 7500 series stops only Physical Sublayer A on FDDI interface
unit 0 in slot 1. This command causes the FDDI media to go into a wrapped state so that the ring
will be broken.
Router# cmt disconnect fddi 1/0 phy-a
Related Commands Command Description
cmt connect Starts the CMT processes.
Cisco IOS Interface and Hardware Component Command Reference
242
clock rate through cut-through
compress
compress
To configure software compression for Link Access Procedure, Balanced (LAPB), PPP, and High-Level Data
Link Control (HDLC) encapsulations, use the compress command in interface configuration mode. To disable
compression, use the no form of this command.
compress {predictor|stac}
no compress {predictor|stac}
Cisco VIP2 Cards
compress {predictor|stac [{distributed|software}]}
no compress {predictor|stac [{distributed|software}]}
Cisco 7200 Series and Cisco 7500 Series
compress {predictor|stac [{csa slot|software}]}
no compress {predictor|stac [{csa slot|software}]}
PPP Encapsulation
compress [{predictor|stac|mppc [ignore-pfc]}]
no compress [{predictor|stac|mppc [ignore-pfc]}]
Syntax Description predictor Specifies that a predictor compression algorithm will be used on LAPB and PPP encapsulation.
Compression is implemented in the software installed in the router’s main processor.
stac Specifies that a Stacker ( LZS) compression algorithm will be used on LAPB, HDLC, and
PPP encapsulation. For all platforms except Cisco 7200 series and platforms that support the
Virtual Interface Processor 2 (VIP2), compression is implemented in the software installed
in the router’s main processor.
On Cisco 7200 series and on VIP2s in Cisco 7500 series, specifying the compressstac
command with no options causes the router to use the fastest available compression method
for PPP encapsulation only:
• If the router contains a compression service adapter (CSA), compression is performed
in the CSA hardware ( hardware compression).
• If a CSA is not available, compression is performed in the software installed on the VIP2
( distributed compression).
• If a VIP2 is not available, compression is performed in the router’s main processor (
software compression).
distributed (Optional) Specifies that compression is implemented in the software that is installed in a
VIP2. If the VIP2 is not available, compression is performed in the router’s main processor
(software compression).
software (Optional) Specifies that compression is implemented in the Cisco IOS software installed in
the router’s main processor.
csa slot (Optional) Specifies the CSA to use for a particular interface.
Cisco IOS Interface and Hardware Component Command Reference
243
clock rate through cut-through
compress
mppc (Optional) Specifies that the Microsoft Point-to-Point Compression (MPPC) compression
algorithm be used.
ignore-pfc (Optional) Specifies that the protocol field compression flag negotiated through Link Control
Protocol (LCP) will be ignored.
Command Default Compression is disabled.
Command Modes Interface configuration
Command History Release Modification
10.3 This command was introduced.
11.3P The following keywords were added:
• distributed
• software
• csa slot
11.3T The following keywords were added:
• mppc
• ignore-pfc
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Note This command replaces thecompresspredictor command.
Usage Guidelines Point-to-Point Compression
Compression reduces the size of frames through lossless data compression. You can configure point-to-point
software compression for all LAPB, PPP, and HDLC encapsulations. The compression algorithm used is a
predictor algorithm (the RAND compression algorithm), which uses a compression dictionary to predict what
the next character in the frame will be.
End-point devices must be configured to use the same compression method (predictor, Stacker or MPPC).
HDLC encapsulations supports the Stacker compression algorithm. PPP and LAPB encapsulations support
both predictor and Stacker compression algorithms.
MPPC Compression
The compress command using the mppc and ignore-pfc options support compression between Cisco routers
and access servers and Microsoft clients, such as Windows 95 and Windows NT. MPPC implements an
LZ-based compression algorithm that uses a compression dictionary to compress PPP packets. The ignore-pfc
Cisco IOS Interface and Hardware Component Command Reference
244
clock rate through cut-through
compress
keyword instructs the router to ignore the protocol field compression flag negotiated by LCP. For example,
the standard protocol field value for IP is 0x0021 when compression is disabled and 0x21 when compression
is enabled. When the ignore-pfc option is enabled, the router will continue to use the uncompressed value
(0x0021). Using the ignore-pfc option is helpful for some asynchronous driver devices that use an uncompressed
protocol field (0x0021), even though the pfc is negotiated between peers. If protocol rejects are displayed
when the debugpppnegotiation command is enabled, setting the ignore-pfc option may remedy the problem.
HDLC Encapsulations
For HDLC encapsulations, you can specify a Stacker compression algorithm by using the stac keyword. PPP
and LAPB encapsulations support both predictor and Stacker compression algorithms.
Public Data Network Connections
Compression requires that both ends of the serial link be configured to use compression. You should never
enable compression for connections to a public data network.
Cisco 7200 and Cisco 7500 Series
Using CSA hardware compression on Cisco 7200 series routers and Cisco 7500 series routers removes the
compression and decompression responsibilities from the VIP2 or the main processor installed in the router.
By using the compressstac command, the router determines the fastest compression method available on the
router.
On Cisco 7200 series routers and Cisco 7500 series routers, hardware compression on the compression service
adapter (CSA) is supported for PPP links. When using hardware compression on Cisco 7200 series routers
with multiple CSAs, you can optionally specify which CSA is used by the interface to perform compression.
If no CSA is specified, the router determines which CSA is used. On Cisco 7500 series routers, the router
uses the CSA on the same VIP2 as the interface.
System Performance
Caution When compression is performed in software installed in the router’s main processor, it might affect system
performance significantly. We recommend that you disable compression if the CPU load exceeds 40 percent.
To display the CPU load, use the showprocesscpu EXEC command.
If the majority of your traffic is already compressed files, we recommend that you not use compression. If
the files are already compressed, the additional processing time spent in attempting unsuccessfully to compress
them again will slow system performance.
The table below provides general guidelines for deciding which compression type to select.
Table 8: Compression Guidelines
Situation Compression Type to Use
Bottleneck is caused by the load on the router. Predictor
Bottleneck is the result of line bandwidth or hardware compression on the CSA Stacker
is available.
Most files are already compressed. None
Software compression makes heavy demands on the router’s processor. The maximum compressed serial line
rate depends on the type of Cisco router that you are using and which compression algorithm you specify.
Cisco IOS Interface and Hardware Component Command Reference
245
clock rate through cut-through
compress
The table below shows a summary of the compressed serial line rates for software compression. The maximums
shown in the table below apply to the “combined” serial compressed load on the router. For example, a Cisco
4000 series router could handle four 64-kbps lines using Stacker compression or one 256-kbps line. These
maximums also assume that there is very little processor load on the router aside from compression. Lower
these numbers when the router is required to do other processor-intensive tasks.
Table 9: Combined Compressed Serial Line Rates (Software Compression)
Compression Cisco 1000 Cisco 3000 Cisco 4000 Cisco 4500 Cisco 4700 Cisco 7000
Method Series Series Series Series Series Family
Stacker (kbps) 128 128 256 500 T1 256
Predictor (kbps) 256 256 500 T1 2xT1 500
Hardware compression can support a combined line rate of 16 Mbps.
Cisco recommends that you do not adjust the maximum transmission unit (MTU) for the serial interface and
the LAPB maximum bits per frame (N1) parameter.
Note The best performance data compression algorithms adjust their compression methodology as they identify
patterns in the data. To prevent data loss and support this adjustment process, the compression algorithm is
run over LAPB to ensure that everything is sent in order, with no missing data and no duplicate data.
Note For information on configuring Frame Relay compression, refer to the “Configuring Frame Relay” chapter
in the CiscoIOSWide-AreaNetworkingConfigurationGuide.
Examples The following example enables hardware compression and PPP encapsulation on serial interface
3/1/0.
Router(config)# interface serial 3/1/0
Router(config-if)# encapsulate ppp
Router(config-if)# compress stac
The following example enables predictor compression on serial interface 0 for a LAPB link:
Router(config)# interface serial 0
Router(config-if)# encapsulation lapb
Router(config-if)# compress predictor
Router(config-if)# mtu 1509
Router(config-if)# lapb n1 12072
The following example enables Stacker compression on serial interface 0 for a LAPB link. This
example does not set the MTU size and the maximum bits per frame (N1); we recommend that you
do not change those LAPB parameters for Stacker compression:
Router(config)# interface serial 0
Router(config-if)# encapsulation lapb
Router(config-if)# compress predictor
Cisco IOS Interface and Hardware Component Command Reference
246
clock rate through cut-through
compress
The following example configures BRI interface 0 to perform MPPC:
Router(config)# interface BRI0
Router(config-if)# ip unnumbered ethernet0
Router(config-if)# encapsulation ppp
Router(config-if)# isdn spid1 5551234
Router(config-if)# dialer map ip 172.21.71.74 5551234
Router(config-if)# dialer-group 1
Router(config-if)# compress mppc
The following example configures asynchronous interface 1 to implement MPPC and ignore the
protocol field compression flag negotiated by LCP:
Router(config)# interface async1
Router(config-if)# ip unnumbered ethernet0
Router(config-if)# encapsulation ppp
Router(config-if)# async default routing
Router(config-if)# async dynamic routing
Router(config-if)# async mode interactive
Router(config-if)# peer default ip address 172.21.71.74
Router(config-if)# compress mppc ignore-pfc
Related Commands Command Description
encapsulation Sets the encapsulation method used by the interface.
encapsulation x25 Specifies operation of a serial interface as an X.25 device.
exec Allows an EXEC process on a line.
show compress Displays compression statistics.
show processes Displays information about the active processes.
Cisco IOS Interface and Hardware Component Command Reference
247
clock rate through cut-through
compress mppc
compress mppc
To configure compression using the Microsoft Point-to-Point Compression (MPPC) algorithm on your data
compression Advanced Interface Module (AIM) for the Cisco 2600 series router, use the
compressmppccommand in interface configuration mode. To disable MPPC compression, use the no form
of this command.
compress mppc
no compress mppc
Syntax Description This command has no arguments or keywords.
Command Default Disabled
Command Modes Interface configuration
Command History Release Modification
12.0(1)T This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The MPPC compression algorithm is used to exchange compressed information with a Microsoft NT remote
access server.
When configuring PPP on a serial interface, you can use hardware compression on the data compression AIM
daughter card for MPPC if one is installed; otherwise you can use software compression.
Examples The following example shows how to configure the data compression AIM daughtercard for MPPC:
Router(config-if)# encapsulate ppp
Router(config-if)# compress mppc
Related Commands Command Description
clear aim Clears data compression AIM registers and resets the hardware.
compress stac caim Specifies the exact hardware compression resource preferred.
encapsulation Sets the encapsulation method used by the interface.
show compress Displays compression statistics.
show pas caim Displays debug information about the data compression AIM daughtercard.
show processes Displays information about the active processes.
Cisco IOS Interface and Hardware Component Command Reference
248
clock rate through cut-through
compress stac caim
compress stac caim
To specify the hardware compression, use the compressstaccaimcommand in interface configuration mode.
To disable compression, use the no form of this command.
compress stac caim interface-number
no compress stac caim interface-number
Syntax Description interface-number Interface on which compression is enabled. AIM interfaces begin with 0.
Command Default Disabled
Command Modes Interface configuration
Command History Release Modification
12.0(1)T This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Hardware Compression
If the router contains a data compression Advanced Interface Module (CAIM), compression is performed in
the CAIM hardware.
Using hardware compression in the AIM frees the main processor of the router for other tasks. You can also
configure the router to use the Compression Port Module to perform compression by using the distributed
option or to use the router's main processor by using the software option. If the Compression Port Module
compression is performed in the main processor of the router.
Software Compression
If the CAIM is not available, compression is performed in the main processor of the router.
When compression is performed by the software installed in the router's main memory, system performance
might be affected significantly. It is recommended that you disable compression in the main processor if the
router CPU load exceeds 40 percent. To display the CPU load, use the show process cpu command in EXEC
mode.
Examples The following example specifies that hardware compression should be activated for CAIM interface
0:
Router(config-if)# encapsulation ppp
Router(config-if)# compress stac caim 0
Cisco IOS Interface and Hardware Component Command Reference
249
clock rate through cut-through
compress stac caim
Related Commands Command Description
clear aim Clears data compression AIM registers and resets the hardware.
encapsulation Sets the encapsulation method used by the interface.
show compress Displays compression statistics.
show pas caim Displays debug information about the data compression AIM daughtercard.
show process cpu Displays information about the active processes on the router.
Cisco IOS Interface and Hardware Component Command Reference
250
clock rate through cut-through
connect (module)
connect (module)
To create a connection between two Gigabit Ethernet (GE) enhanced network modules (ENMs) or between
the GE port on an installed small-form-factor-pluggable (SFP) module and a GE ENM, or between the GE
port on a switch module (SM) and another SM GE port, on a Cisco 2900 series (Cisco 2901 ISRs do not
support the HIMI backplane feature.), 3800 series, or 3900 series Integrated Services Router (ISR), use the
connect command in global configuration mode. To deactivate a connection between two GE modules on a
Cisco 3800 series router, use the no form of this command.
connect connection-name module module1 channel-id1 module module2 channel-id2
no connect connection-name
To create a dedicated connection between two GE ENMs, or between the GE port on an SFP module and a
GE ENM, or between the GE port on a SM and another SM GE port, for the purpose of sending data on a
specified VLAN on a Cisco 3900 series or 2900 series (Cisco 2901 ISRs do not support vlan connect in
configuring the HIMI backplane feature.), use the connect command in global configuration mode with the
vlanvlan-id syntax. To deactivate a connection between two GE interfaces on a Cisco 3900 series router,
2900 series (Cisco 2901 ISRs do not support vlan connect in configuring the HIMI backplane feature.), use
the no form of this command.
connect connection-name module module1 vlan vlan-id module module2
no connect connection-name
Syntax Description connection-name Unique name for this connection.
module module1 First of the two GE interfaces on the router between which a connection will be created.
channel-id1
• Use the module1 argument to identify the GE port number. Use the syntax
GigabitEthernetslot/port , where slot is the slot number in which the ENM
resides, or 0 for the router onboard SFP GE port, and port is either the ENM port
number or 0 for the router onboard SFP GE port.
The following interfaces are valid:
• • On the Cisco 3825 and Cisco 3845 routers, the GE port in an installed SFP
module
• On the Cisco 3825 router, GE interfaces in ENM slots 1 and 2
• On the Cisco 3845 router, GE interfaces in ENM slots 2 and 4
• On the Cisco 2900 (Cisco 2901 ISRs do not support the HIMI backplane
feature.) series and the Cisco 3900 series routers, all interfaces and slots are
permissible providing your SM and ISM supports the HIMI backplane
feature.
• Use the channel-id1 argument to indicate the channel identifier on the interface
slots of module1. On Cisco 3800 series routers, there is only one channel identifier,
so this value must be 0.
Cisco IOS Interface and Hardware Component Command Reference
251
clock rate through cut-through
connect (module)
module module2 Second half of the two GE interfaces on the router between which a connection will
channel-id2 be created.
• Use the module2 argument to identify the GE port number. Use the syntax
GigabitEthernetslot/port , where slot is the slot number in which the ENM
resides, or 0 for the onboard SFP GE port, and port is either the ENM port number
or 0 for the onboard SFP GE port.
• Use the channel-id2 argument to indicate the channel identifier on the interface
slots of module2. On Cisco 3800 series and Cisco 3900 series routers, there is
only one channel identifier, so this value must be 0.
module module1 Specified vlan on two GE interfaces on the router.
vlan vlan-id
Note On the Cisco 2900 series (Cisco 2901 ISRs do not support vlan connect in
modulemodule2
configuring the HIMI backplane feature.) and Cisco 3900 series routers, if
your ISM or SM supports the HIMI backplane and VLAN connection, the
module interconnection between the GE port (with the exception of onboard
GE ports) on any slot is permitted at any given time.
Command Default There is no connection between GE ENMs.
Command Modes Global configuration (config)
Command History Release Modification
12.4(2)T This command was introduced.
15.0(1)M This command was modified to support the Cisco 3900 series and 2900 series (Cisco 2901 ISRs
do not support the HIMI backplane feature.) ISR release.
Usage Guidelines To create a connection between two GE modules on a Cisco 2900 (Cisco 2901 ISRs do not support the HIMI
backplane feature.), 3800, and 3900 series routers using the High-Speed Intrachassis Module Interconnect
(HIMI) feature, use the connectconnection-namemodule module1 channel-id1 module module2 channel-id2
command in global configuration mode:
Connections can be only established as follows:
• Between the GE port in an installed small-form-factor pluggable (SFP) module on the Cisco 3825 and
Cisco 3845 routers
• Between GE interfaces in NME slots 1 and 2 on the Cisco 3825 router
• Between GE interfaces in NME slots 2 and 4 on the Cisco 3845 router
Note A module interconnection between the GE port on an SFP module and an ENM slot or an ENM-to-ENM
cross-connection on the Cisco 3800 series routers is permitted at any time, but both types of connections
cannot exist at the same time.
Cisco IOS Interface and Hardware Component Command Reference
252
clock rate through cut-through
connect (module)
Note Connections between the onboard RJ-45 GE ports and ENM slots are not supported.
To create a connection between two GE SMs, to send data on a specified VLAN, on a VLAN on a Cisco 2900
(Cisco 2901 ISRs do not support the HIMI backplane feature.), and 3900, use the connect command with the
with the vlanvlan-id syntax.
If the connect command is successfully executed, the router enters connection configuration mode, which is
designated by the “config-module-conn” prompt. Once the router is in connection configuration mode, the
commands shown in the table below can be issued.
Table 10: Connection Configuration Mode Commands
Command Description
default Sets a command to its default values. Has no effect on the connect command functionality.
exit Exits connection configuration mode. After you exit connection configuration mode, the actual
connection establishment phase starts.
shutdown Shuts down the connection. This command effectively deactivates the connection.
no Negates a command or sets it to default. The noshutdown command reactivates a previously
shut down connection.
To establish a connection, after entering connection configuration mode, issue the exit command to return to
configuration mode. The connection will be established after you leave connection configuration mode.
Examples The following example illustrates the creation of a connection between the onboard port
GigabitEthernet0/0 and port GigabitEthernet4/0, which resides in ENM slot 4:
Router(config)# connect connection1 module GigabitEthernet0/0 0 module GigabitEthernet4/0
0
Router(config-module-conn)# exit
The following example shows the creation of a VLAN connection which is named VLAN 10 and a
second VLAN connection which is named VLAN 5.
Router(config)# connect connection1 module gi2/0 vlan 10 module gi3/0
Router(config-module-conn)# connect connection2 module gi3/0 vlan 5 module gi4/0
Router(config-module-conn)# exit
Related Commands Command Description
show connection Displays the status of interworking connections.
Cisco IOS Interface and Hardware Component Command Reference
253
clock rate through cut-through
constellation
constellation
To configure the constellation for the global navigation satellite system (GNSS) module on the Cisco ASR
903, Cisco ASR 907, and the Cisco ASR 920 routers, use the constellation command in the gnss mode. To
remove the constellation configuration, use the no form of this command.
constellation {auto|beidou|galileo|glonass|gps|qzss}
no constellation {auto|beidou|galileo|glonass|gps|qzss}
Syntax Description auto Enables auto locking to an available constellation.
beidou Enables detection and locking to the BeiDou constellation.
Note BeiDou and GLONAS constellations cannot be enabled simultaneously.
Note If the auto option is used, BeiDou will not be part of the selected
constellations.
galileo Enables detection and locking to the Galileo constellation.
glonas Enables detection and locking to the GLONAS constellation.
gps Enables detection and locking to the GPS constellation.
qzss Enables detection and locking to the QZSS constellation.
Command Default No default behavior or values.
Command Modes GNSS configuration (config-gnss)
Command History Release Modification
IOS-XE 3.17 This command was introduced on the Cisco ASR 903, Cisco ASR 907, and the Cisco ASR
920 routers.
Usage Guidelines BeiDou and GLONAS constellations cannot be enabled simultaneously. Also, if the auto option is used,
BeiDou will not be part of the selected constellations.
Irrespective of configured constellation, initially the GPS constellation is used for the Self-Survey mode and
the GNSS module switches to using the configured constellation in over-determined mode.
Examples The following example shows how to configure the constellations:
Router# configure terminal
Router(config)# gnss slot r0
Router(config-gnss)# constellation auto
Cisco IOS Interface and Hardware Component Command Reference
254
clock rate through cut-through
constellation
Related Commands Command Description
gnss Configures the GNSS on the router.
1pps Configures the pulse per second from the GNSS module.
anti-jam Enables or disables the anti-jam mode on the GNSS module.
default Resets the device to its default state.
exit Exists the GNSS sub mode.
Cisco IOS Interface and Hardware Component Command Reference
255
clock rate through cut-through
control-lead sampling-rate
control-lead sampling-rate
To configure the sampling rate of input control leads, use the control-leadsampling-rate command in CEM
configuration mode.
control-lead sampling-rate rate
Syntax Description rate Integer that specifies the number of samples per second. Range is from 0 to 20. Default is 0.
Command Default The input control lead sampling rate defaults to 0 (no sampling).
Command Modes CEM configuration
Command History Release Modification
12.3(7)T This command was introduced.
Usage Guidelines This command applies only to serial channels. This command does not have a no form; to disable control-lead
sampling, set the rate argument to 0.
Examples The following example shows how to configure the ingress control-lead sampling rate to 20 samples
per second on a serial CEM port.
Router(config-cem)# control-lead sampling-rate 20
Related Commands Command Description
cem Enters circuit emulation configuration mode.
clear cem Clears CEM channel statistics.
control-lead state Specifies the state of an output control lead.
show cem Displays CEM channel statistics.
Cisco IOS Interface and Hardware Component Command Reference
256
clock rate through cut-through
control-lead state
control-lead state
To specify the state of an output control lead, use the control-leadstate command in CEM configuration
mode. The choice of output lead depends on whether the port is DCE or DTE.
control-lead state {active|fail} output-lead {on|off|follow} [{local|remote} follow-lead]
Syntax Description active Active template configuration.
fail Failed template configuration.
output-lead Specifies the name of the output control lead. The choice of the control lead depends on whether
the port is DCE or DTE.
on Activates the lead.
off Deactivates the lead.
follow Specifies the control lead state to follow.
local (Optional) Specifies a local lead state.
remote (Optional) Specifies a remote lead state.
follow-lead (Optional) Specifies the local or remote input control lead for this control lead to follow. The
choice of the control lead depends on whether the port is DCE or DTE.
Command Default The default Active template that is activated depends on whether the port is DCE or DTE. The default Fail
template deactivates all signals. The table below shows the various control-lead default states.
Table 11: Control-Lead Default States
Lead Number DCE Name DTE Name Active Default Fail Default
1 CTS RTS On Off
2 DSR DTR On Off
3 DCD -- On Off
4 -- LL Off --
5 TM -- On Off
6 RI RL Off Off
Command Modes CEM configuration
Command History Release Modification
12.3(7)T This command was introduced.
Cisco IOS Interface and Hardware Component Command Reference
257
clock rate through cut-through
control-lead state
Usage Guidelines The state of each output control lead may be specified to assume a constant level (on or off) or to change on
the basis of the state of any input control lead, either at the local data port or at the remote data port.
This command applies only to serial ports. This command does not have a no form; to disable the control
lead, specify the off keyword.
Examples The following example shows how to specify the state of an output control lead.
Router(config-cem)# control-lead state active cts on
Related Commands Command Description
cem Enters circuit emulation configuration mode.
control-lead sampling-rate Configures the sampling rate of input control leads.
show cem Displays CEM channel statistics.
Cisco IOS Interface and Hardware Component Command Reference
258
clock rate through cut-through
controller
controller
To configure a T1, E1, J1, or BITS controller and enter controller configuration mode, use the controller
command in global configuration mode.
Cisco 2600 and 3600 Series Routers
controller {t1|e1|j1} slot/port
Cisco 7200 Series and Cisco 7500 Series Routers
controller {bits|t1|e1|shdsl} slot/port/subslot-number/port-number
Cisco AS5300 Access Servers
controller {t1|e1} number
Cisco ASR 901 Series Aggregation Services Routers
controller {bits|t1|e1|shdsl} slot/port/subslot-number/port-number
Cisco ASR 901 Series Aggregation Services Routers
controller {bits|t1|e1|shdsl} slot/port/subslot-number/port-number
Syntax Description shdsl T1 controller.
e1 E1 controller.
j1 J1 controller.
slot / port Backplane slot number and port number on the interface. Refer to your hardware installation
manual for the specific values and slot numbers.
port-number Network processor module (NPM) number, in the range 0 through 2.
dial-shelf Dial shelf chassis in the Cisco AS5800 access server that contains the interface card.
/ t3-port T3 port number. The only valid value is 0.
port-number Port number of the controller. Valid numbers are 0 and 1. A forward slash mark (/) is required
between the slot argument and the port argument.
port-number Port number of the controller. Valid numbers are 0 and 1. A forward slash mark (/) is required
between the slot argument and the port argument.
port-number Port number of the controller. Valid numbers are 0 and 1. A forward slash mark (/) is required
between the slot argument and the port argument.
port-number Port number of the controller. Valid numbers are 0 and 1. A forward slash mark (/) is required
between the slot argument and the port argument.
port-number Port number of the controller. Valid numbers are 0 and 1. A forward slash mark (/) is required
between the slot argument and the port argument.
Command Default No T1, E1, or J1 controller is configured.
Cisco IOS Interface and Hardware Component Command Reference
259
clock rate through cut-through
controller
Command Modes Global configuration (config)
Command History Release Modification
10.0 This command was introduced.
10.3 The e1 keyword was added.
12.0(3)T Support was added for dial shelves on Cisco AS5800 access servers.
12.2(7)XO The j1keyword was added for the Cisco 2600 and Cisco 3600 series.
15.1(2)SNG This command was implemented on Cisco ASR 901 Series Aggregation Services Routers. The
bits and shdsl keywords and the subslot-number and port-number arguments were added.
15.1(2)SNG This command was implemented on Cisco ASR 901 Series Aggregation Services Routers. The
bits and shdsl keywords and the subslot-number and port-number arguments were added.
Usage Guidelines T1 or E1 Fractional Data Lines
This command is used in configurations where the router or access server is intended to communicate with a
T1 or E1 fractional data line. Additional parameters for the T1 or E1 line must be configured for the controller
before the T1 or E1 circuits can be configured by means of the interface global configuration command.
To view the status of the controllers use the showcontrollers command.
Examples
Cisco 7500 Series Router As a T1 Controller
The following example configures the MIP in slot 4, port 0 of a Cisco 7500 series router as a T1
controller:
Router(config)# controller t1 4/0
Router(config-controller)#
Cisco AS5800 Access Server with Dial Shelf
The following example configures the T1 controller in shelf 1, slot 0, port 0:
Router(config)# controller t1 1/0/0:1
Router(config-controller)#
Cisco 3660 As a J1 Controller
The following example configures the Cisco IOS interface card in slot 3, port 0 of a Cisco 3660 as
a J1 controller:
Router(config)# controller j1 3/0
Router(config-controller)#
Cisco IOS Interface and Hardware Component Command Reference
260
clock rate through cut-through
controller
Related Commands Command Description
bert abort Resets the T1 or E1 controller.
interface serial Specifies a serial interface created on a channelized E1 or channelized
T1 controller (for ISDN PRI, CAS, or robbed-bit signaling).
interface serial Specifies a serial interface created on a channelized E1 or channelized
T1 controller (for ISDN PRI, CAS, or robbed-bit signaling).
show controllers content-engine Displays information about the E1 links supported by the NPM (Cisco
4000) or MIP (Cisco 7500 series).
show controllers j1 Displays information about the J1 link.
show controllers j1 Displays information about the J1 link.
show controllers t1 Displays the total number of calls and call durations on a T1 controller.
Cisco IOS Interface and Hardware Component Command Reference
261
clock rate through cut-through
controller dsl
controller dsl
To configure the digital subscriber line (DSL) controller and enter controller configuration mode, use the
controllerdsl command in global configuration mode. This command does not have a no form.
controller dsl slot/port
Syntax Description slot Slot number of the DSL controller. Valid numbers are 0 and 1.
/ port Port number of the DSL controller. Valid numbers are 0 and 1. The slash mark (/) is required
between the slot argument and the portargument.
Command Default No default behavior or values.
Command Modes Global configuration
Command History Release Modification
12.3(4)XD This command was introduced on Cisco 2600 series and Cisco 3700 series routers.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T on Cisco 2600 series and Cisco
3700 series routers.
12.3(11)T This command was implemented on Cisco 2800 and Cisco 3800 series routers.
12.3(14)T This command was implemented on Cisco 1800 series routers.
Usage Guidelines This command is used to enter controller configuration mode for the controller in the specified slot and port.
If the controller is present, it is automatically set to a default set of values, including customer premises
equipment (CPE) mode and annex A.
The central office (CO) and CPE sides of the link must be configured the same in order for a connection to
be made. This command is available only when the WIC-1SHDSL-V2 is installed.
Examples The following example shows how to enter DSL controller configuration mode on the controller in
slot 1 and port 0:
Router(config)# controller dsl
1/0
Router(config-controller)#
Related Commands Command Description
controller shdsl Configures the controller status.
debug xdsl application Displays status of the xDSL if the DSL does not activate as expected.
debug xdsl driver Displays status when the drivers are downloaded and installed.
Cisco IOS Interface and Hardware Component Command Reference
262
clock rate through cut-through
controller dsl
Command Description
debug xdsl eoc Displays the contents of the embedded operations channel messages.
debug xdsl error Displays the errors of xDSL process and firmware.
show controller dsl Displays the DSL controller status and the controller number.
Cisco IOS Interface and Hardware Component Command Reference
263
clock rate through cut-through
controller dwdm
controller dwdm
To configure a Dense Wavelength-Division Multiplexing (DWDM) controller, use the
controllerdwdmcommand in global configuration mode. This command does not have a no form.
controller dwdm slot/port
Syntax Description slot/port Number of the chassis slot that contains the interface, where:
• slot--Chassis slot number.
• /port--Port number.
Command Default No default behavior or values
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SRD1 This command was introduced on the Cisco 7600 series router.
Examples The following example shows how to configure a DWDM controller in slot 3:
Router(config)# controller dwdm 3/1
Related Commands Command Description
g709 fec Configures the FEC for the DWDM controller.
g709 odu threshold Configures thresholds for selected ODU BER alarms.
g709 otu threshold Configures thresholds for selected OTU BER alarms.
no g709 odu report Disables the logging of selected ODU alarms.
no g709 otu report Disables the logging of selected OTU alarms.
show controller dwdm Displays ITU-T G.709 alarms, alerts, and counters.
show platform dwdm alarm history Displays platform DWDM alarm history.
transport-mode Configures a transport mode.
Cisco IOS Interface and Hardware Component Command Reference
264
clock rate through cut-through
controller e3
controller e3
To configure an E3 controller and enter controller configuration mode, use the controllere3command in
global configuration mode.
controller e3 slot/port
Syntax Description slot/port Number of the slot and port being configured. Refer to the appropriate hardware manual for slot
and port information. The slash mark is required.
Command Default No E3 controller is configured.
Command Modes Global configuration
Command History Release Modification
11.1 This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and implemented on
the following platforms: Cisco 2650XM, Cisco 2651XM, Cisco 2691, Cisco 3660 series,
Cisco 3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
XE Everest This command was integrated into Cisco ASR 900 Series Routers and Cisco NCS 4200
16.5.1 Series.
Examples The following example shows the E3 controller configured in slot 0, port 0:
Router(config)# controller e3 0/0
Router(config-controller)#
Related Commands Command Description
controller t3 Configures a T3 controller and enters controller configuration mode.
show controllers e3 Displays information about E3 controllers.
show controllers t3 Displays information about T3 controllers.
Cisco IOS Interface and Hardware Component Command Reference
265
clock rate through cut-through
controller mediatype
controller mediatype
Use this command to configure MediaType controller.
mode sonet slot / bay / port
Syntax Description Syntax Description:
slot Physical slot number of the interface
bay Bay of the interface
port Mediatype port number
Command Default None
Command Modes Global configuration
Command History Release Modification
XE 3.18 SP Support for this command was introduced on the NCS 4200 Series.
XE Everest This command was integarted into the Cisco NCS 4200 Series and Cisco ASR 900 Series
16.5.1 Routers.
Usage Guidelines This command is used to configure the Mediatype controller mode. Configure the Mediatype controller mode
before configuring SONET controller and T3 controller.
Examples The following example shows how to configure Mediatype controller mode:
enable
configure terminal
controller MediaType 0/5/0
mode sonet
end
The following example shows how to set up port on the T3 interface module:
enable
configure terminal
controller MediaType 0/4/0
mode t3
end
Related Commands Command Description
controller sonet Configures the SONET mode.
show controller sonet Displays SONET controller configuration.
Cisco IOS Interface and Hardware Component Command Reference
266
clock rate through cut-through
controller protection-group
controller protection-group
Use this command to configure protection group controller.
controller protection-group group id
Syntax Description Syntax Description:
group id Identifier of the interface
Command Default None
Command Modes Controller configuration
Command History Release Modification
Cisco IOS XE Everest This command was introduced into the Cisco NCS 4200 Series and Cisco ASR
16.5.1 900 Series Routers.
Usage Guidelines The parameters used for protection group controller are executed after using this command.
Examples The following example shows how to configure protection group:
enable
configure terminal
protection-group 401 type STS48c
controller protection group 401
type STS48c
cem-group 19001 cep
end
Related Commands Command Description
show protection-group Verifies the protection group configuration.
Cisco IOS Interface and Hardware Component Command Reference
267
clock rate through cut-through
controller sdh
controller sdh
Use this command to configure a SDH controller and enter controller configuration mode.
controller sdh slot /bay /port
Syntax Description Syntax Description
slot Physical slot number. The slot is always 0 for Cisco
NCS 4200 Series.
bay Physical sub-slot or bay number. The range is 0-5.
port SDH port number. The port number is always 0
because only one STM-1 port is supported per
interface. The slash mark is required.
stm1 number The STM number ranges from 1 to 4.
Command Default The default port is 0.
Command Modes Global configuration
Command History Release Modification
XE Everest This command was integrated into the Cisco NCS 4200 Series and
16.6.1
Cisco ASR 900 Series.
Usage Guidelines This command does not have a no form because the SDH controller is created automatically when the STM-1
trunk card is detected.
Examples
enable
configure terminal
controller sdh 0/5/0
rate stm 4
aug mapping au-4
au-4 1
mode vc4
cem-group 100 cep
end
Related Commands Command Description
show running configuration Verifies controller SDH configuration.
Cisco IOS Interface and Hardware Component Command Reference
268
clock rate through cut-through
controller sonet
controller sonet
To configure a SONET controller and enter controller configuration mode, use the controllersonet command
in global configuration mode.
controller sonet slot/port
For Cisco NCS 4200 Series
controller sonet slot/subslot/port
Syntax Description bay Identifies the bay where the VCoP SSFP is inserted. On NCS4200 series bay value is 0 always.
slot Physical slot number. The slot number is in a range either from 0 to 5 or 8 to 13, depending on the
slot in which the STM-1 card resides. The slot is always 0 for Cisco NCS 4200 Series.
/subslot Physical sub-slot number. The range for sub-slot is 0-5.
/port SONET port number. The port number is always 0 because only one STM-1 port is supported per
interface. The slash mark is required. The range of port number for Cisco NCS 4200 Series is 8-14.
Command Default port : 0
Command Modes Global configuration
Command History Release Modification
12.0(14)S This command was introduced.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
XE 3.18SP This command was integrated into Cisco NCS 4200 Series.
XE Everest This command was integrated into Cisco NCS 4200 Series and Cisco ASR 920 Routers.
16.5.1
Usage Guidelines This command does not have a no form because the SONET controller is created automatically when the
STM-1 trunk card is detected by the Cisco AS5850. Use this command to specify which slot number the
STM-1 card is plugged into and to configure different attributes under controller configuration mode.
Examples The following example shows how to specify that the SONET controller is in slot number 2:
Router(config)# controller sonet 2/0
Router(config-controller)#
Examples The following example shows how to specify that the SONET controller for Cisco NCS 4200 Series
in slot number 0, sub-slot 0, and port as 8:
Cisco IOS Interface and Hardware Component Command Reference
269
clock rate through cut-through
controller sonet
Router(config)# controller SONET 0/0/8
Router(config-controller)#
Related Commands Command Description
show controllers sonet Displays information about SONET controllers.
Cisco IOS Interface and Hardware Component Command Reference
270
clock rate through cut-through
controller sonet-acr
controller sonet-acr
To configure a SONET Access Circuit Redundancy (ACR) virtual controller, and to enter the controller
configuration mode, use the controller sonet-acr command in global configuration mode.
controller sonet-acr controller unit number
Syntax Description controller unit number Specifies the controller unit number. The range is 1 to 255.
Command Default None
Command Modes
Global configuration
Command History Release Modification
15.1(01)S This command was introduced on the Cisco 7600 routers.
Usage Guidelines The controller sonet-acrcommandis used to configure channelized ATM, IMA and CEM timeslots. Before
you begin the SONET ACR virtual controller configuration, ensure that you configure the APS group ACR
and APS working by using the aps group acr acr-group numberand aps working circuit number
commandsrespectively.
Examples This example shows how to configure the controller sonet-acr:
Router(config)# Controller sonet 4/1/0
Router(config-controller)# aps group acr 1
Router(config-controller)# aps working 1
The above commands on the physical controller helps in creating a virtual sonet-acr controller
Router(config)#
controller sonet-acr 21
Related Commands Command Description
sts-1 Configures the Synchronous Transport Signal (level)-1 in the SONET hierarchy.
vtg Configures the (CESoPSN) CEM group.
mode vt-15 Configures the path operation mode.
Cisco IOS Interface and Hardware Component Command Reference
271
clock rate through cut-through
controller t1/e1
controller t1/e1
To configure a T1or E1 controller and enter controller configuration mode, use the controller command in
global configuration mode.
controller t1/e1 slot/bay/port
Syntax Description t1 Specifies T1 controller
e1 Specifies E1 controller
slot Specifies the slot number of the interface.
bay Specifies the bay number of the interface.
port Specifies the port number of the interface.
Command Default No T1 or E1controller is configured.
Command Modes Global configuration
Command History Release Modification
XE 3.18SP This command was introduced for Cisco NCS 4200 Series Routers.
XE Everest This command is implemented on Cisco NCS 4200 Series and Cisco ASR 903 Series
16.5.1 Router.
Usage Guidelines This command is used in configurations where the router or access server is intended to communicate with a
T1 or E1 fractional data line. Additional parameters for the T1 or E1 line must be configured for the controller
before the T1 or E1 circuits can be configured by means of the interface global configuration command.
Examples The following example shows how to configure T1 controller in slot 0, bay 1, port 1:
Router(config)# controller t1 0/1/1
Router(config-controller)#
Examples The following example shows how to configure E1 controller in slot 0, bay 1, port 1:
Router(config)# controller e1 0/1/1
Router(config-controller)#
Related Commands Command Description
show controller t1/e1 Displays the total number of calls and call durations on a T1/E1 controller.
Cisco IOS Interface and Hardware Component Command Reference
272
clock rate through cut-through
controller t3
controller t3
To configure the Channelized T3 Interface Processor (CT3IP) in Cisco 7500 series routers or the CT3 feature
board in Cisco AS5800 access servers, use the controllert3 command in global configuration mode. To delete
the defined controller, use the no form of this command.
Cisco 7500 Series
controller t3 slot/port-adapter/port
no controller t3 slot/port-adapter/port
Cisco AS5800 Access Server
controller t3 dial-shelf/slot/t3-port
no controller t3 dial-shelf/slot/t3-port
Cisco NCS 4200 Series
controller t3 slot/sub-slot/port
no controller t3 slot/sub-slot/port
Syntax Description slot Number of the slot being configured. Refer to the appropriate hardware manual for slot
and port information./
/ port-adapter Number of the port adapter being configured. Refer to the appropriate hardware manual
for information about port adapter compatibility.
/ port Number of the port being configured. Refer to the appropriate hardware manual for slot
and port information.
dial-shelf Dial shelf chassis in the Cisco AS5800 access server containing the CT3 interface card.
/ slot Location of the CT3 interface card in the dial shelf chassis.
/ sub-slot Sub-slot location of the T3 interface card in the dial shelf chassis.
/ t3-port T3 port number. The only valid value is 0.
Command Default No T3 controller is configured.
No default behavior or values.
No default behavior or values.
Command Modes Global configuration
Command History Release Modification
11.3 This command was introduced.
12.0(3)T This command was implemented on the Cisco AS5800 access server.
XE 3.18SP This command was implemented on the Cisco NCS 4200 Series.
Cisco IOS Interface and Hardware Component Command Reference
273
clock rate through cut-through
controller t3
Release Modification
XE Everest This command was implemented on the Cisco NCS 4200 Series and Cisco ASR 920
16.5.1 Routers.
Usage Guidelines This command is used to configure the CT3IP and the 28 T1 channels. After the T1 channels are configured,
continue to configure each T1 channel as a serial interface by using the interfaceserialglobal configuration
command
Examples
Cisco 7500 Series
The following example configures the CT3IP in slot 3:
Router(config)# controller t3 3/0/0
Cisco AS5800 Access Server
The following example configures the T3 controller in shelf 3, slot 0, port 0 and T1 time slot 1:
Router(config)# controller t3 3/0/0
Cisco NCS 4200 Series
The following example configures the T3 controller in slot 0, sub-slot 4, and port 40:
Router(config)# controller t3 0/4/40
Related Commands Command Description
controller Configures a T1, E1, or J1 controller and enters controller configuration mode.
interface Specifies a serial interface created on a channelized E1 or channelized T1 controller (for ISDN
PRI, CAS, or robbed-bit signaling).
Cisco IOS Interface and Hardware Component Command Reference
274
clock rate through cut-through
copy flash lex
copy flash lex
To download an executable image from Flash memory on the core router to a LAN Extender, use the
copyflashlex command in privileged EXEC mode.
copy flash lex number copy flash lex command
Syntax Description number Number of the LAN Extender interface to which to download an image from Flash memory.
Command Modes Privileged EXEC
Command History Release Modification
10.3 This command was introduced.
12.2(15)T This command is no longer supported in Cisco IOS Mainline or Technology-based (T) releases.
It may continue to appear in 12.2S-Family releases.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines If you attempt to download a version of the software older than what is currently running on the LAN Extender,
a warning message is displayed.
This command does not have a no form.
Examples The following example copies the executable image namexx to LAN Extender interface 0:
Router# copy flash lex 0
Name of file to copy? namexx
Address of remote host [255.255.255.255] <cr>
writing namexx !!!!!!!!!!!!!!!!!!!!!!!!!copy complete
Related Commands Command Description
copy tftp Downloads an executable image from a TFTP server to a LAN Extender.
lex
Cisco IOS Interface and Hardware Component Command Reference
275
clock rate through cut-through
copy tftp lex
copy tftp lex
To download an executable image from a TFTP server to the LAN Extender, use the copytftplex command
privileged EXEC mode.
copy tftp lex number copy tftp lex command
Syntax Description number Number of the LAN Extender interface to which to download an image.
Command Modes Privileged EXEC
Command History Release Modification
10.3 This command was introduced.
12.2(15)T This command is no longer supported in Cisco IOS Mainline or Technology-based (T) releases.
It may continue to appear in 12.2S-Family releases.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines If you attempt to download a version of the software older than what is currently running on the LAN Extender,
a warning message is displayed.
This command does not have a not form.
Examples The following example copies the file namexx from the TFTP server:
Router# copy tftp lex 0
Address or name of remote host (255.255.255.255]? 10.108.1.111
Name of file to copy? namexx
OK to overwrite software version 1.0 with 1.1 ?[confirm] YLoading namexx from
10.108.13.111!!!!!!!!!!!!!!!!!!!!!!!!!
[OK - 127825/131072 bytes]
Successful download to LAN Extender
Cisco IOS Interface and Hardware Component Command Reference
276
clock rate through cut-through
crc
crc
To set the length of the cyclic redundancy check (CRC), use thecrc command in interface configuration mode.
To set the CRC length to the default value, use the no form of this command.
crc commandcrc size-in-bits
no crc
Syntax Description size-in-bits CRC size in bits. Valid values are 16 and 32. The default is 16.
Command Default 16 bits
32 bits
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(31)SB This command was integrated into Cisco IOS Release 12.2(31)SB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines All interfaces use a 16-bit CRC by default, but also support a 32-bit CRC. CRC is an error-checking technique
that uses a calculated numeric value to detect errors in transmitted data. The designators 16 and 32 indicate
the length (in bits) of the frame check sequence (FCS). A CRC of 32 bits provides more powerful error
detection, but adds overhead. Both the sender and receiver must use the same setting.
CRC-16, the most widely used CRC rate throughout the United States and Europe, is used extensively with
WANs. CRC-32 is specified by IEEE 802 and as an option by some point-to-point transmission standards. It
is often used on Switched Multimegabit Data Service (SMDS) networks and LANs.
Examples The following example enables the 32-bit CRC on serial interface 3/0:
Router(config)# interface serial 3/0
Router(config-if)# crc 32
Cisco IOS Interface and Hardware Component Command Reference
277
clock rate through cut-through
crc bits 5
crc bits 5
To enable generation of CRC5 (per ITU Recommendation G.704 and G.703) to improve data integrity, use
the crcbits5command in interface configuration mode. To disable this function, use the no form of this
command.
crc bits 5 commandcrc bits 5
no crc bits 5
Syntax Description This command has no arguments or keywords.
Command Default CRC5 checking is disabled.
Command Modes Interface configuration
Command History Release Modification
11.1 CA This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command is available for the JT2 6.3-MHz serial port adapter (PA-2JT2) on the second-generation
Versatile Interface Processor (VIP2), in Cisco 7500 series routers, and in Cisco 7000 series routers with the
Cisco 7000 series Route Switch Processor (RSP7000) and the Cisco 7000 series Chassis Interface (RSP7000CI).
This command is useful for checking data integrity while operating in framed mode. CRC5 provides additional
protection for a frame alignment signal under noisy conditions. For data transmission at JT2 (6.312 Mbps),
the G.704 standard suggests 5 bits CRC. Refer to ITU Recommendation G.704 for a definition of CRC5.
You can also use the crc command to set the CRC size for the High-Level Data Link Control (HDLC)
controllers.
Examples The following example enables CRC5 generation on the PA-2JT2 port adapter and also sets the CRC
size to 32 bits:
Router(config)# interface serial 0/0
Router(config-if)# crc 32
Router(config-if)# crc bits 5
Related Commands Command Description
crc Sets the length of the CRC.
Cisco IOS Interface and Hardware Component Command Reference
278
clock rate through cut-through
crc4
crc4
To enable generation of CRC4 (per ITU Recommendation G.704 and G.703) to improve data integrity, use
the crc4command in interface configuration mode. To disable this function, use the no form of this command.
crc4
no crc4crc4 command
Syntax Description This command has no arguments or keywords.
Command Default Disabled
Command Modes Interface configuration
Command History Release Modification
10.3 This command was introduced.
11.1 CA This command was implemented on the Cisco 7200 series router and the E1-G.703/G.704
serial port adapter.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command applies to the Cisco 7200 series, Cisco 7000 series, and Cisco 7500 series routers. This command
is supported on the Fast Serial Interface Processor (FSIP) and the E1-G.703/G.704 serial port adapter.
This command is useful for checking data integrity while operating in framed mode. CRC4 provides additional
protection for a frame alignment signal under noisy conditions. For data transmission at E1 (2.048 Mbps),
the G.704 standard suggests 4 bits CRC. Refer to CCITT Recommendation G.704 for a definition of CRC4.
You can also use the crc command to set the CRC size for the High-Level Data Link Control (HDLC)
controllers.
Examples The following example enables CRC4 generation on the E1-G.703/G.704 serial port adapter and
also sets the CRC size to 32 bits:
Router(config)# interface serial 0/0
Router(config-if)# crc 32
Router(config-if)# crc4
Related Commands Command Description
crc Sets the length of the CRC.
Cisco IOS Interface and Hardware Component Command Reference
279
clock rate through cut-through
crc-threshold
crc-threshold
To define a severely errored second (SES) by specifying the number of cyclic redundancy check (CRC) errors
that occur in one second, use the crc-threshold command in controller configuration mode. To return to the
default value, use the no form of this command.
crc-threshold value
no crc-threshold
Syntax Description value Number of CRC errors in one second that results in the second being declared a severely errored
second (SES). Range is from 0 to 3000. Default is 320.
Command Default A default SES is defined by a value of 320 CRC errors per second.
Command Modes Controller configuration
Command History Release Modification
12.3(7)T This command was introduced.
Usage Guidelines On a T1 port, this command applies only if extended super frame (ESF) framing is used because the super
frame (SF) (also known as D4) frame structure does not include any CRC protection.
This command does not apply to an E1 port.
Examples The following example shows how to set the CRC threshold at 512 CRC errors in one second.
Router(config-controller)# crc-threshold 512
Cisco IOS Interface and Hardware Component Command Reference
280
clock rate through cut-through
ctunnel mode
ctunnel mode
To transport IPv4 and IPv6 packets over Connectionless Network Service (CLNS) tunnel (CTunnel), use the
ctunnelmode command in interface configuration mode. To return the ctunnel to the default cisco mode, use
the no form of this command.
ctunnel mode [{gre|cisco}]
no ctunnel mode
Syntax Description gre (Optional) Sets the ctunnel mode to Generic Routing Encapsulation (GRE) for transporting IPv6
packets over the CLNS network.
cisco (Optional) Returns the ctunnel mode to the default cisco.
Command Default Cisco encapsulation tunnel mode is the default.
Command Modes Interface configuration
Command History Release Modification
12.3(7)T This command was introduced.
12.2(25)S This command was integrated into Cisco IOS Release 12.2(25)S.
12.2(28)SB This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SXH This command was integrated into Cisco IOS Release 12.2(33)SXH.
Usage Guidelines GRE tunneling of IPv4 and IPv6 packets through CLNS-only networks enables Cisco ctunnels to interoperate
with networking equipment from other vendors. This feature provides compliance with RFC 3147, Generic
Routing Encapsulation over CLNS Networks, which should allow interoperation between Cisco equipment
and that of other vendors. in which the same standard is implemented.
RFC 3147 specifies the use of GRE when tunneling packets. The implementation of this feature does not
include support for GRE header fields such as those used to specify checksums, keys, or sequencing. Any
packets received which specify the use of these features will be dropped.
The default ctunnel mode continues to use the standard Cisco encapsulation. Both ends of the tunnel must be
configured with the same mode for it to work. If you want to tunnel ipv6 packets you must use the new gre
mode.
Examples The following example configures a CTunnel from one router to another and shows the CTunnel
destination set to 49.0001.1111.1111.1111.00. The ctunnel mode is set to gre to transport IPv6
packets.
interface ctunnel 301
ipv6 address 2001:0DB8:1111:2222::2/64
Cisco IOS Interface and Hardware Component Command Reference
281
clock rate through cut-through
ctunnel mode
ctunnel destination 49.0001.1111.1111.1111.00
ctunnel mode gre
Related Commands Command Description
clns routing Enables routing of CLNS packets.
ctunnel destination Specifies the destination for the CTunnel.
debug ctunnel Displays debug messages for the IP over a CLNS Tunnel feature.
interface ctunnel Creates a virtual interface to transport IP over a CLNS tunnel.
ip address Sets a primary or secondary IP address for an interface.
Cisco IOS Interface and Hardware Component Command Reference
282
clock rate through cut-through
cut-through
cut-through
To configure the interfaces on the PA-12E/2FE port adapter to use cut-through switching technology between
interfaces within the same bridge group, use the cut-throughcommand in interface configuration mode. To
return each interface to store-and-forward switching, use the noform of this command.
cut-through [{receive|transmit}]
no cut-through
Syntax Description receive (Optional) Selects cut-through switching technology on received data.
transmit (Optional) Selects cut-through switching technology on transmitted data.
Command Default Store-and-forward switching technology (that is, no cut-through)
Command Modes Interface configuration
Command History Release Modification
11.2P This command was introduced.’
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Cut-through mode allows switched packets to be transmitted after 64 bytes are received. The transmission of
the packets can start before the end of the packet arrives. This reduces the time spent in the switch, but allows
packets to be transmitted with bad cyclical redundancy checks (CRCs), because the transmission is initiated
before the CRC is received or checked. Store-and-forward mode waits for the entire packet to be received
before that packet is forwarded, but will check the CRC before starting transmission.
The PA-12E/2FE port adapter offloads Layer 2 switching from the host CPU by using store-and-forward or
cut-through switching technology between interfaces within the same VLAN on the PA-12E/2FE port adapter.
The PA-12E/2FE port adapter supports up to four VLANs (bridge groups).
Examples The following example configures interface 3/0 for cut-through switching:
Router(config)#
interface fastethernet 3/0
Router(config-if)#
bridge-group 10
Router(config-if)#
cut-through
Router(config-if)#
no shutdown
Router(config-if)# exit
Cisco IOS Interface and Hardware Component Command Reference
283
clock rate through cut-through
cut-through
Cisco IOS Interface and Hardware Component Command Reference
284
D through E
• data-protection, on page 287
• data-strobe, on page 288
• dce-terminal-timing enable, on page 289
• debug l2protocol-tunnel, on page 290
• debug platform link-dc, on page 291
• debug platform network-clock, on page 295
• debug platform software ucse, on page 296
• debug snmp tunnel-mib, on page 297
• default (CEM), on page 298
• default interface, on page 300
• define interface-range, on page 302
• dejitter-buffer, on page 304
• delay-asymmetry, on page 306
• delay (interface), on page 307
• delay-req interval, on page 308
• description (controller), on page 310
• description (interface configuration), on page 311
• diagnostic level, on page 312
• dial-tdm-clock, on page 314
• dot1q tunneling ethertype, on page 316
• down-when-looped, on page 318
• ds0-group (J1 controller), on page 320
• dsl-group, on page 322
• dsl-mode shdsl symmetric annex, on page 327
• dsu bandwidth, on page 330
• dsu mode, on page 333
• dte-invert-txc, on page 336
• duplex, on page 337
• dxi interface-dfa, on page 342
• dxs3mode, on page 344
• e2-clockrate, on page 345
• early-token-release, on page 346
• efm-grp, on page 347
Cisco IOS Interface and Hardware Component Command Reference
285
D through E
• eigrp interface, on page 348
• emulation-mode, on page 350
• encapsulation, on page 351
• end (satellite initial configuration), on page 355
• equipment loopback, on page 356
• errdisable detect cause, on page 357
• errdisable recovery, on page 359
• error throttling, on page 362
• esmc mode ql-disabled, on page 364
• esmc process, on page 365
• exit (satellite initial configuration), on page 366
Cisco IOS Interface and Hardware Component Command Reference
286
D through E
data-protection
data-protection
To enable data protection for a circuit emulation (CEM) channel, use the data-protectioncommand in CEM
configuration mode. To disable data protection, use the no form of this command.
data-protection
no data-protection
Syntax Description This command has no arguments or keywords.
Command Default Data protection is disabled for a CEM channel.
Command Modes CEM configuration
Command History Release Modification
12.3(7)T This command was introduced.
Examples The following example demonstrates how to enable data protection.
Router(config-cem)# data-protection
Related Commands Command Description
cem Enters circuit emulation configuration mode.
clear cem Clears CEM channel statistics.
show cem Displays CEM channel statistics.
Cisco IOS Interface and Hardware Component Command Reference
287
D through E
data-strobe
data-strobe
To specify an input control lead to be monitored as an indicator of valid data, use the data-strobe command
in CEM configuration mode. To disable the monitoring of an input control lead, use the no form of this
command.
data-strobe input-lead {on|off}
no data-strobe
Syntax Description input-lead Specifies the input lead. The choice of leads depends on whether the port is DCE or DTE.
on Enables packet creation when the lead is asserted.
off Enables packet creation when the lead is deactivated.
Command Default No input control lead is monitored.
Command Modes CEM configuration
Command History Release Modification
12.3(7)T This command was introduced.
Usage Guidelines Any input control signal on a serial data port may be configured as a “data strobe” to indicate to the
NM-CEM-4SER network module whether ingress data on the port should be encapsulated for transmission
or ignored. If the data-strobe command is specified with the on keyword, data packets are created and sent
when the input lead is asserted. If the data strobe is off (either intentionally or as a result of the failure of the
customer premises equipment [CPE]), no data packets are created, and this results in preservation of bandwidth
in the IP network.
This command applies only to serial ports.
Examples The following example demonstrates how to specify that packets are to be created and sent to the
far end only when the DTR input control lead is asserted.
Router(config-cem)# data-strobe dtr on
Related Commands Command Description
cem Enters circuit emulation configuration mode.
clear cem Clears CEM channel statistics.
control-lead sampling rate Configures the sampling rate of input control leads.
control-lead state Specifies the state of an output control lead.
show cem Displays CEM channel statistics.
Cisco IOS Interface and Hardware Component Command Reference
288
D through E
dce-terminal-timing enable
dce-terminal-timing enable
To prevent phase shifting of the data with respect to the clock when running the line at high speeds and long
distances, use the dce-terminal-timingenable command in interface configuration mode. If serial clock
transmit external (SCTE) terminal timing is not available from the DTE, use the noform of this command;
the DCE will use its own clock instead of SCTE from the DTE.
dce-terminal-timing enable
no dce-terminal-timing enable
Syntax Description This command has no arguments or keywords.
Command Default The DCE uses its own clock.
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines On the Cisco 4000 router, you can specify the serial Network Interface Module timing signal configuration.
When the board is operating as a DCE and the DTE provides terminal timing (SCTE or TT), the
dce-terminal-timingenable command causes the DCE to use SCTE from the DTE.
Examples The following example shows how to prevent phase shifting of the data with respect to the clock:
Router(config)# interface serial 0
Router(config-if)# dce-terminal-timing enable
Cisco IOS Interface and Hardware Component Command Reference
289
D through E
debug l2protocol-tunnel
debug l2protocol-tunnel
To configure the debugging option of Layer 2 Protocol Tunneling (L2PT), use the debugl2protocol-tunnel
command in EXEC mode.
debug l2protocol-tunnel [{error|event|misc|packet}]
Syntax Description error (Optional) Displays L2PT errors.
event (Optional) Displays L2PT events.
misc (Optional) Displays L2PT miscellaneous.
packet (Optional) Displays L2PT activities.
Command Default If you do not specify a debugging option, all options are enabled.
Command Modes User EXEC (>)
Command History Release Modification
15.2(2)T This command was introduced.
Examples The following example shows how to debug the l2protocol-tunnel command:
Router# debug l2protocol-tunnel error
Related Commands Command Description
l2protoco-tunnel Enables Layer 2 protocol tunneling for CDP, STP, or VTP packets on an interface.
show l2protocol-tunnel Displays information about L2PT ports.
Cisco IOS Interface and Hardware Component Command Reference
290
D through E
debug platform link-dc
debug platform link-dc
To display debugging messages for the link daughter card, use the debugplatformlink-dccommand in
privileged EXEC mode. To disable debugging output, use the no form of this command.
debug platform link-dc {dwdm|interface|interrupt|netclk|serdes|transceiver|wanphy}
no debug platform link-dc {dwdm|interface|interrupt|netclk|serdes|transceiver|wanphy}
Syntax Description dwdm OTN G.709/DWDM driver debug information.
interface Interface driver debug information.
interrupt Interrupt debug information.
netclk Network clocking debug information.
serdes Physical layer (PHY) and SerDes debug information.
transceiver Pluggable optics module information.
wanphy WAN PHY driver debug information.
Command Default Debugging is not enabled.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SRD This command was introduced.
Note This command applies only to the Cisco 7600 Series Ethernet Services Plus (ES+)
line card on the Cisco 7600 series router.
12.2(33)SRD1 This command added the dwdm and wanphy keywords.
Usage Guidelines Use this command with the remote command command or the attach command in privileged EXEC mode.
Examples The following examples show the output for both the debug platform link-dc tranceiver command
and the debug platform link-dc interrupt command. Notice that the show platform hardware transceiver
command shows the status for the port.
Router# remote command module 1 debug platform link-dc tranceiver
Link-DC transceiver debugging is on
Router# remote command module 1 debug platform link-dc interrupt
Link-DC interrupt debugging is on
Router# remote command module 1 show debug
x40g subsystem:
Link-DC transceiver debugging is on
Link-DC interrupt debugging is on
Router# remote command module 1 show platform hardware transceiver status 1
Show status info for port 1:
Cisco IOS Interface and Hardware Component Command Reference
291
D through E
debug platform link-dc
TenGigabitEthernet1/1:
State: Enabled
Environmental Information - raw values
Temperature: 7616
Tx voltage: 0 in units of 100uVolt
Tx bias: 28722 uA
Tx power: -2 dBm (5441 in units of 0.1 uW)
Rx power: 0 dBm (7712 in units of 0.1 uW)
(AUX1) Laser Temperature: 8704
(AUX2) +3.3V Supply Voltage: 32928
XFP TX is enabled.
XFP TX is soft enabled.
XFP is ready.
XFP is not power down.
XFP is not soft power down.
XFP doesn't have interrupt(s).
XFP is not LOS.
XFP data is ready.
XFP TX path is ready.
XFP TX laser is not in fault condition.
XFP TX path CDR is locked.
XFP RX path is ready.
XFP RX path CDR is locked.
No active alarms
No active warning
Router-dfc1#
*Aug 15 11:20:26.436 PDT: DFC1: TenGigabitEthernet1/1 XFP: show status
*Aug 15 11:20:26.436 PDT: DFC1: TenGigabitEthernet1/1 XFP: show environmental monitoring
*Aug 15 11:20:26.436 PDT: DFC1: pluggable optics read - addr: 50, offset: 60, len: 14,
dataptr: 2377A668
*Aug 15 11:20:26.448 PDT: DFC1: pluggable optics read - addr: 50, offset: 6E, len: 2,
dataptr: 21AA028E
*Aug 15 11:20:26.452 PDT: DFC1: pluggable optics read - addr: 50, offset: 50, len: 2,
dataptr: 2377A6A0
*Aug 15 11:20:26.456 PDT: DFC1: pluggable optics read - addr: 50, offset: 52, len: 2,
dataptr: 2377A6A2
Note The following console log is seen when both the debug platform link-dc tranceiver command and
the debug platform link-dc interrupt command are entered (as in the preceding example), and there
is a transceiver Rx loss of signal (LOS) event.
Router-dfc1#
*Aug 15 11:23:52.127 PDT: DFC1: x40g_link_dc_interrupt_handler: intr_status 0x8000
*Aug 15 11:23:52.127 PDT: DFC1: x40g_link_xphy_isr: xphy intr intr_st 0x80000
*Aug 15 11:23:52.127 PDT: DFC1: x40g_link_xphy_isr: xphy intr port 1
*Aug 15 11:23:52.127 PDT: DFC1: x40g_xphy_link_status_callout: port 1 link status 0
*Aug 15 11:23:52.131 PDT: DFC1: x40g_link_dc_interrupt_handler: intr_status 0x8000
*Aug 15 11:23:52.131 PDT: DFC1: x40g_link_xphy_isr: xphy intr intr_st 0x80000
*Aug 15 11:23:52.131 PDT: DFC1: x40g_link_xphy_isr: xphy intr port 1
*Aug 15 11:23:52.131 PDT: DFC1: x40g_xphy_link_status_callout: port 1 link status 1
*Aug 15 11:23:52.135 PDT: DFC1: x40g_link_dc_process: interrupt msg_id 6, msg_num 1
*Aug 15 11:23:52.135 PDT: DFC1: x40g_link_dc_interrupt_handler: intr_status 0x8000
*Aug 15 11:23:52.135 PDT: DFC1: x40g_link_xphy_isr: xphy intr intr_st 0x80000
*Aug 15 11:23:52.135 PDT: DFC1: x40g_link_xphy_isr: xphy intr port 1
*Aug 15 11:23:52.135 PDT: DFC1: x40g_xphy_link_status_callout: port 1 link status 0
*Aug 15 11:23:52.135 PDT: DFC1: x40g_link_dc_interrupt_handler: intr_status 0x4000
*Aug 15 11:23:52.135 PDT: DFC1: x40g_link_xcvr_isr: intr_st 0x2, start 0, end 4, type
2,port_offset 0x0
*Aug 15 11:23:52.135 PDT: DFC1: Link xcvr port 1: Rx LOS interrupt
*Aug 15 11:23:52.135 PDT: DFC1: x40g_link_dc_process: interrupt msg_id 2, msg_num 1
Cisco IOS Interface and Hardware Component Command Reference
292
D through E
debug platform link-dc
*Aug 15 11:23:52.135 PDT: DFC1: Port 2: transceiver Rx LOS event
*Aug 15 11:23:52.147 PDT: DFC1: x40g_link_dc_process: xcvr oir timer timeout
00:12:37: %LINEPROTO-DFC1-5-UPDOWN: Line protocol on Interface TenGigabitEthernet1/2, changed
state to down
*Aug 15 11:24:46.576 PDT: DFC1: x40g_link_dc_interrupt_handler: intr_status 0x4000
*Aug 15 11:24:46.576 PDT: DFC1: x40g_link_xcvr_isr: intr_st 0x2, start 0, end 4, type
2,port_offset 0x0
*Aug 15 11:24:46.576 PDT: DFC1: Link xcvr port 1: Rx LOS interrupt
*Aug 15 11:24:46.576 PDT: DFC1: x40g_link_dc_process: interrupt msg_id 2, msg_num 1
*Aug 15 11:24:46.576 PDT: DFC1: Port 2: transceiver Rx LOS recovered
*Aug 15 11:24:46.580 PDT: DFC1: x40g_link_dc_interrupt_handler: intr_status 0x8000
*Aug 15 11:24:46.580 PDT: DFC1: x40g_link_xphy_isr: xphy intr intr_st 0x80000
*Aug 15 11:24:46.580 PDT: DFC1: x40g_link_xphy_isr: xphy intr port 1
*Aug 15 11:24:46.580 PDT: DFC1: x40g_xphy_link_status_callout: port 1 link status 0
*Aug 15 11:24:46.584 PDT: DFC1: x40g_link_dc_interrupt_handler: intr_status 0x8000
*Aug 15 11:24:46.584 PDT: DFC1: x40g_link_xphy_isr: xphy intr intr_st 0x80000
*Aug 15 11:24:46.584 PDT: DFC1: x40g_link_xphy_isr: xphy intr port 1
*Aug 15 11:24:46.584 PDT: DFC1: x40g_xphy_link_status_callout: port 1 link status 1
*Aug 15 11:24:46.584 PDT: DFC1: x40g_link_dc_process: interrupt msg_id 6, msg_num 1
*Aug 15 11:24:46.600 PDT: DFC1: x40g_link_dc_process: xcvr oir timer timeout
00:13:31: %LINEPROTO-DFC1-5-UPDOWN: Line protocol on Interface TenGigabitEthernet1/2, changed
state to up
The following example shows the output for the debug platform link-dc dwdm command.
Router-dfc1# debug platform link-dc dwdm
Link-DC OTN G.709/DWDM debugging is on
*Jan 28 12:10:38.784 PDT: DFC1: Port 1: OTN Alarm Query, return ptr 228E877C
los 1, oof 0, lof 0, mfas 1, lom 0
otuAis 0, otuIae 0-0, otuBdi 0, otuTim 0
oduAis 0, oduBdi 0, oduLck 0, oduOci 0, oduPtim 0
*Jan 28 12:10:38.864 PDT: DFC1: x40g_link_pemaquid_pm_tick_timer_event(1): pm_tick timer
timeout
*Jan 28 12:10:39.364 PDT: DFC1: x40g_link_pemaquid_pm_tick_timer_event(1): pm_tick timer
timeout
*Jan 28 12:10:39.840 PDT: DFC1: Port 1: OTN Alarm Query, return ptr 228E877C
los 1, oof 0, lof 0, mfas 1, lom 0
otuAis 0, otuIae 0-0, otuBdi 0, otuTim 0
oduAis 0, oduBdi 0, oduLck 0, oduOci 0, oduPtim 0
The following example shows the output for the debug platform link-dc wanphy command.
Router-dfc1# debug platform link-dc wanphy
Link-DC WAN PHY debugging is on
*Jan 28 11:59:16.184 PDT: DFC1: Port 1 WIS alarms:
ser 0, plm_p_far 0, ais_p_far 0, lof 0, los 0
rdi 0, ais_l 0, lcd_p 0, plm_p 0, ais_p 0, lop 0
*Jan 28 11:59:17.184 PDT: DFC1: Port 1 WIS alarms:
ser 0, plm_p_far 0, ais_p_far 0, lof 0, los 0
rdi 0, ais_l 0, lcd_p 0, plm_p 0, ais_p 0, lop 0
*Jan 28 11:59:17.184 PDT: DFC1: Port 1 WIS counters: b1 0, b2 0, b3 0, fe_b2 0, fe_b3 0
*Jan 28 11:59:17.184 PDT: DFC1: Port 1 WIS J1RX: 0x0000000000000089.0x302E302E302E3000
...
*Jan 28 11:59:22.288 PDT: DFC1: Port 1 WIS alarms:
ser 0, plm_p_far 0, ais_p_far 0, lof 0, los 0
rdi 0, ais_l 0, lcd_p 0, plm_p 0, ais_p 0, lop 0
*Jan 28 11:59:22.288 PDT: DFC1: Port 1 WIS counters: b1 0, b2 0, b3 0, fe_b2 0, fe_b3 0
*Jan 28 11:59:22.288 PDT: DFC1: Port 1 WIS J1RX: 0x0000000000000089.0x302E302E302E3000
Cisco IOS Interface and Hardware Component Command Reference
293
D through E
debug platform link-dc
Related Commands Command Description
show platform hardware transceiver Displays transceiver information on a port.
Cisco IOS Interface and Hardware Component Command Reference
294
D through E
debug platform network-clock
debug platform network-clock
To debug issues related to the network clock, such as alarms, out-of-resource (OOR), and active-standby
sources not selected correctly, use the debug platform network-clock command in the privileged EXEC mode.
To disable debugging, use the nono form of this command. .
debug platform network-clock
no debug platform network-clock
Command Default This command has no arguments or keywords.
Command Modes Privileged EXEC (#)
Command History Release Modification
Cisco IOS XE Release 3.2 This command was integrated into Cisco ASR 1000 Series routers.
Cisco IOS Release 12.2(33)SRE This command was introduced on the Cisco 7600 Series routers.
Examples The following example shows how to debug the network clock:
Router(config)# debug platform network-clock
Cisco IOS Interface and Hardware Component Command Reference
295
D through E
debug platform software ucse
debug platform software ucse
To debug the Cisco UCS E-Series Server platform software and display debug messages, use the debug
platform software ucse command in privileged EXEC mode. To disable debug, use the no form of this
command.
debug platform software ucse {all|error|normal}
no debug platform software ucse {all|error|normal}
Syntax Description all Displays all platform debug messages.
error Displays error debug messages.
normal Displays normal debug messages.
Command Modes
Privileged EXEC (#)
Command History Release Modification
Cisco IOS XE Release 3.9S This command was introduced on the Cisco UCS E-Series Servers installed in
the Cisco 4400 Series Integrated Services Router (ISR).
Usage Guidelines After you use the debug platform software ucse all command, use the appropriate ucse command to display
debug messages.
Examples The following example shows how to display debug messages for the ucse subslot imc
password-reset command:
Router# debug platform software ucse all
Router#
Router# ucse subslot 2/0 imc password-reset
ucse2/0/0
Password reset command sent.
Router#
IMC ACK: UCSE password reset successful for IMC
ACK received for UCSE: Password Reset Command
Cisco IOS Interface and Hardware Component Command Reference
296
D through E
debug snmp tunnel-mib
debug snmp tunnel-mib
To enable the debugging for configuring the IP Tunnel Management Information Base (MIB) through Simple
Network Management Protocol (SNMP), use the debugsnmptunnel-mib command in privileged EXEC
mode. To disable debugging, use the no form of this command.
debug snmp tunnel-mib
no debug snmp tunnel-mib
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SRB This command was introduced.
12.4(15)T This command was integrated into Cisco IOS Release 12.4(15)T.
12.2(33)SB1 This command was integrated into Cisco IOS Release 12.2(33)SB1.
12.2(44)SG This command was integrated into Cisco IOS Release 12.2(44)SG.
Cisco IOS Release XE 2.1 This command was integrated into Cisco IOS Release XE 2.1.
Usage Guidelines Use the debugsnmptunnel-mib command to verify whether a tunnel is created or deleted.
Examples The following is sample output from the debugsnmptunnel-mib command. The output shows that
a tunnel is created through SNMP.
Router# debug snmp tunnel-mib
SNMP TUNNEL-MIB debugging is on
k_tunnelInetConfigEntry_get: Entering
k_tunnelInetConfigEntry_get: Exact search
tim_client_tunnel_endpoint_data_get: Entering
tim_client_tunnel_endpoint_data_get: Exact search
tim_client_tunnel_endpoint_data_get: No element found
k_tunnelInetConfigEntry_get: Client service failed
k_tunnelInetConfigEntry_test: Entering
k_tunnelInetConfigEntry_test: Completed
k_tunnelInetConfigEntry_set: Entering
tim_client_tunnel_endpoint_data_get: Entering
tim_client_tunnel_endpoint_data_get: Exact search
tim_client_tunnel_endpoint_data_get: No element found
k_tunnelInetConfigEntry_set: Calling tunnel create
tim_client_tunnel_create: Entering
tim_client_tunnel_create: Completed
Cisco IOS Interface and Hardware Component Command Reference
297
D through E
default (CEM)
default (CEM)
To reset channel options to their default values, use the defaultcommand in CEM configuration mode.
default {data-protection|dejitter-buffer|idle-pattern|ip dscp|ip tos|ip
precedence|payload-compression|payload-size|signaling}
Syntax Description data-protection Resets data protection to its default value.
dejitter-buffer Resets the dejitter buffer to its default value.
idle-pattern Resets the idle pattern to its default value.
ip dscp Resets the IP differentiated services code point (DSCP) field to its default value.
ip tos Resets the IP type of service (ToS) field to its default value.
ip precedence Resets the IP precedence field to its default value.
payload-compression Resets payload compression to its default value.
payload-size Resets payload size to its default value.
signaling Resets signaling to its default value.
Command Default The CEM channel options are set at their configured values.
Command Modes CEM configuration
Command History Release Modification
12.3(7)T This command was introduced for CEM configuration mode.
Examples The following example demonstrates how to reset CEM channel data protection to its default value.
Router(config-cem)# default data-protection
Related Commands Command Description
cem Enters circuit emulation configuration mode.
clear cem Clears CEM channel statistics.
data-protection Enables data protection.
dejitter-buffer Configures the dejitter buffer size.
idle-pattern Defines the idle pattern that the channel transmits when it goes down.
payload-compression Enables payload compression.
Cisco IOS Interface and Hardware Component Command Reference
298
D through E
default (CEM)
Command Description
payload-size Configures the payload size.
show cem Displays CEM channel statistics.
signaling Enables CAS signaling.
Cisco IOS Interface and Hardware Component Command Reference
299
D through E
default interface
default interface
To reset the configuration of an interface back to its default values, use the defaultcommand in global
configuration mode.
default interface-type interface-number
Syntax Description interface-type Type of interface. The interface types that are available to be reset to their default values
will vary depending on the available interface types on the networking device and the Cisco
IOS release that is installed on the device. Not all possible interface types are documented
here.
• async --Reconfigures the specified async interface to its default value.
• atm --Reconfigures the specified ATM interface to its default value.
• bvi --Reconfigures the specified bridge-group virtual interface to its default value.
• dialer --Reconfigures the specified dialer interface to its default value.
• ethernet --Reconfigures the specified Ethernet interface to its default value.
• fastethernet --Reconfigures the specified Fast Ethernet interface to its default value.
• fddi --Reconfigures the specified FDDI interface to its default value.
• gigabitethernet --Reconfigures the specified Gigabit Ethernet interface to its default
value.
• group-async --Reconfigures the specified group async interface to its default value.
• loopback --Reconfigures the specified loopback interface to its default value.
• null --Reconfigures the specified null interface to its default value.
• pos --Reconfigures the specified Packet over SONET (POS) interface to its default
value.
• serial --Reconfigures the specified serial interface to its default value.
• tunnel --Reconfigures the specified tunnel interface to its default value.
interface-number Number of the interface, slot, router shelf, unit, port, or port adaptor if appropriate for the
interface type. Slash marks may be required between elements of this argument.
Command Default Existing interface configuration values are not reset.
Command Modes Global configuration
Command History Release Modification
11.1 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Cisco IOS Interface and Hardware Component Command Reference
300
D through E
default interface
Release Modification
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The default command is a general-purpose command that is not limited to interfaces; it resets defaults based
on the command name that follows it. Use the default(interface) command when you need to remove any
configuration for a specified interface and reset the interface to its default values.
Examples The following example demonstrates how to reset serial interface 0 to its default values.
Router(config)# default serial 0
Related Commands Commands Description
interface Enters interface configuration mode.
Cisco IOS Interface and Hardware Component Command Reference
301
D through E
define interface-range
define interface-range
To create an interface-range macro, use the define interface-range command in global configuration mode.
To remove an interface-range macro, use the no form of this command.
define interface-range macro-name interface-range
Syntax Description macro-name Name of the interface-range macro.
interface-range Type of interface range.
• For a list of valid values, see the “Usage Guidelines”
section.
Command Default Interface-range macro is not configured.
Command Modes Global configuration (config)
Command History Release Modification
12.2(14)SX This command was introduced.
12.2(17d)SXB This command was integrated into Cisco IOS XE Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
15.1(2)SNG This command was implemented on the Cisco ASR 901 Series Aggregation Services Routers.
Usage Guidelines • The define interface-range command applies a particular configuration on multiple interfaces and creates
multiple logical, and sub interfaces.
• An interface range macro name can comprise up to 32 characters.
• An interface range for a macro can accept a maximum of five ranges. However, the subinterface range
for a macro accepts only one range.
• An interface range cannot span slots.
• Use the interface-type slot/first-interface last-interface format to enter the interface range.
• Valid values for the interface-type argument are as follows:
• atm —Supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2
• ethernet
• fastethernet
• ge-wan —Supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2
• gigabitethernet
• loopback
• port-channel interface-number —Valid values are from 1 to 256
• pos —Supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2
Cisco IOS Interface and Hardware Component Command Reference
302
D through E
define interface-range
• tengigabitethernet
• tunnel
• vlan vlan-id —Valid values are from 1 to 4094
Examples The following example shows how to create a multiple-interface macro:
Device(config)# define interface-range macro1 ethernet 1/2 - 5, fastethernet 5/5 - 10
The following example shows how to create multiple loopback interfaces:
Device(config)# define interface-range loopback1-10
Related Commands Command Description
interface range Executes a command on multiple ports at the same time.
Cisco IOS Interface and Hardware Component Command Reference
303
D through E
dejitter-buffer
dejitter-buffer
To configure the size of the dejitter buffer, use the dejitter-buffer command in CEM configuration mode.
To restore the dejitter buffer to its default size, use the no form of this command.
dejitter-buffer size
no dejitter-buffer
Syntax Description size Size, in milliseconds, of the dejitter buffer. The range is from 5 to 500. The default is 60. For Cisco
ASR 901 Series Aggregation Services Routers, the range is from 4 to 500; the default is 4.
Command Default The dejitter buffer defaults to 60 milliseconds. For Cisco ASR 901 Series Aggregation Services Routers, the
default is 4.
Command Modes CEM configuration
Command History Release Modification
15.1(2)SNG This command was implemented on Cisco ASR 901 Series Aggregation Services Routers.
15.1(2)SNG This command was implemented on Cisco ASR 901 Series Aggregation Services Routers.
Examples The following example shows how to set the dejitter buffer to 200 milliseconds.
Router(config-cem)# dejitter-buffer 200
The following example shows how to specify the size of the dejitter buffer to 10 milliseconds on the
Cisco ASR 901 Series Aggregation Services Router:
Router# configure terminal
Router(config)# interface cem 0/0
Router(config-if)# no ip address
Router(config-if)# cem 0
Router(config-if-cem)# dejitter-buffer 10
Router(config-if-cem)# xconnect 10.10.10.10 200 encapsulation mpls
Router(config-if-cem-xconn)# exit
Router(config-if-cem)# exit
Router(config-if)# exit
Router(config)# exit
Related Commands Command Description
cem Enters circuit emulation configuration mode.
clear cem Clears CEM channel statistics.
clear cem Clears CEM channel statistics.
clear cem Clears CEM channel statistics.
Cisco IOS Interface and Hardware Component Command Reference
304
D through E
dejitter-buffer
Command Description
show cem Displays CEM channel statistics.
Cisco IOS Interface and Hardware Component Command Reference
305
D through E
delay-asymmetry
delay-asymmetry
To perform the PTP asymmetry readjustment on a PTP node to compensate for the delay in the network, use
the delay-asymmetry command in the PTP clock configuration mode. To revert to default setting, use the
no form of this command.
delay-asymmetry asymmetry_compensation_offset
no delay-asymmetry asymmetry_compensation_offset
Syntax Description asymmetry_compensation_offset Asymetry value of the clock that defines if a one way delay of forward
or reverse path occurs.Value ranges from -500000000 to 500000000
nanoseconds.
Command Default The default asymmetry offset value is zero.
Command Modes PTP Clock Configuration (for default Telecom profile), Clock-Port Configuration (for G8275.1 Telecom
profile)
Command History Release Modification
Cisco IOS XE Gibraltar 16.10.1 This command was
introduced.
Usage Guidelines The asymmetry compensation offset value can be configured on default, G8275.1 Telecom profile.
The following example demonstrates how to configure the delay asymmetry for ports with default
Telecom profile.
Router# configure terminal
Router(config)#ptp clock
Router(config-ptp-clk)#clock-port sla slave
Router(config-ptp-port)#clock source 1.1.1.1 delay-asymmetry 300 nanoseconds
The following example demonstrates how to configure the delay asymmetry for ports with G8275.1
Telecom profile.
Router# configure terminal
Router(config)#ptp clock
Router(config-ptp-clk)#clock-port sla slave
Router(config-ptp-port)#delay-asymmetry 500
Related Commands Command Description
ptp clock Creates a Precision Time Protocol clock and specifies the clock mode.
clock-port Specifies the clocking mode of a Precision Time Protocol clock port.
Cisco IOS Interface and Hardware Component Command Reference
306
D through E
delay (interface)
delay (interface)
To set a delay value for an interface, use the delay command in interface configuration mode. To restore the
default delay value, use the no form of this command.
delay tens-of-microseconds
no delay
Syntax Description tens-of-microseconds Integer that specifies the delay in tens of microseconds for an interface or network
segment. To see the default delay, use the showinterfaces command.
Command Default Default delay values may be displayed with the showinterfacesEXEC command.
Command Modes Interface configuration (config-if) Virtual network interface (config-if-vnet)
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in
a specific 12.2SX release of this train depends on your feature set, platform,
and platform hardware.
Cisco IOS XE Release 3.2S This command was modified. Support was added for this command in virtual
network interface configuration mode.
Examples The following example shows how to set a delay of 30,000 microseconds on serial interface 3:
Router(config)# interface serial 3
Router(config-if)# delay 3000
Related Commands Command Description
show interfaces Displays the statistical information specific to a serial interface.
Cisco IOS Interface and Hardware Component Command Reference
307
D through E
delay-req interval
delay-req interval
To specify a recommended interval for Precision Time Protocol member devices to send delay request
messages, use the delay-reqinterval command in PTP clock port configuration mode. To remove a delay
request interval configuration, use the no form of this command.
delay-req interval interval-value unicast
no delay-req interval interval-value unicast
Syntax Description interval-value Specifies the length of the interval for delay request messages. The intervals are set using
log base 2 values, as follows:
• 4--1 packet every 16 seconds
• 3--1 packet every 8 seconds
• 2--1 packet every 4 seconds
• 1--1 packet every 2 seconds
• 0--1 packet every second
• -1--1 packet every 1/2 second, or 2 packets per second
• -2--1 packet every 1/4 second, or 4 packets per second
• -3--1 packet every 1/8 second, or 8 packets per second
• -4--1 packet every 1/16 seconds, or 16 packets per second.
• -5--1 packet every 1/32 seconds, or 32 packets per second.
• -6--1 packet every 1/64 seconds, or 64 packets per second.
The recommended value is -6.
unicast (Optional) Specifies that the device send PTP delay request messages using unicast mode.
Command Default The default value is -4 (16 packets per second).
Command Modes PTP clock-port configuration (config-ptp-port)
Command History Release Modification
15.0(1)S This command was introduced.
Usage Guidelines This configuration is only required when an interface is in PTP slave mode.
Examples The following example shows how to use the delay-req command:
Router# configure terminal
Router(config)# ptp clock ordinary domain 0
Cisco IOS Interface and Hardware Component Command Reference
308
D through E
delay-req interval
Router(config-ptp-clk)# clock-port slaveport slave
Router(config-ptp-port)# delay-req interval 2 unicast
Router(config-ptp-port)# end
Related Commands Command Description
clock-port Specifies the mode of a PTP clock port.
Cisco IOS Interface and Hardware Component Command Reference
309
D through E
description (controller)
description (controller)
To add a description to an E1 or T1 controller or the Channelized T3 Interface Processor (CT3IP) in Cisco
7500 series routers, use the descriptioncommand in controller configuration mode. To remove the description,
use the noform of this command.
description string
no description
Syntax Description string Comment or description (up to 80 characters) to help you remember what is attached to an interface.
Command Default No description is added.
Command Modes Controller configuration
Command History Release Modification
10.3 This command was introduced.
11.3 This command was modified to include the CT3IP controller.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The description command is meant solely as a comment to be put in the configuration to help you remember
what certain controllers are used for. The description affects the CT3IP and Multichannel Interface Processor
(MIP) interfaces only and appears in the output of the showcontrollere1, showcontrollert1,showcontrollert3,
andshowrunning-configEXEC commands.
Examples The following example shows how to add a description for a 3174 controller:
Router(config)# controller t1
Router(config-controller)# description 3174 Controller for test lab
Related Commands Command Description
show controllers e1 Displays information about the E1 links supported by the NPM (Cisco 4000) or MIP
(Cisco 7500 series).
show controllers t1 Displays information about the T1 links.
show controllers t3 Displays information about the CT3IP on Cisco 7500 series routers.
Cisco IOS Interface and Hardware Component Command Reference
310
D through E
description (interface configuration)
description (interface configuration)
To add a description to an interface configuration, use the description command in interface configuration
mode. To remove the description, use the noform of this command.
description string
no description
Syntax Description string Comment or a description to help you remember what is attached to this interface. This string is
limited to 238 characters.
Command Default No description is added.
Command Modes Interface configuration
Command History Release Modification
9.21 This command was introduced.
Usage Guidelines The description command is meant solely as a comment to be put in the configuration to help you remember
what certain interfaces are used for. The description appears in the output of the following EXEC
commands:morenvram:startup-config, showinterfaces, andmoresystem:running-config
Examples The following example shows how to add a description for a T1 interface:
interface serial 0
description Fractional T1 line to remote office -- 128 kbps
Related Commands Command Description
more nvram:startup-config Displays the startup configuration file contained in NVRAM or specified
by the CONFIG_FILE environment variable.
more system:running-config Displays the running configuration.
show interfaces Displays statistics for all interfaces configured on the router or access server.
Cisco IOS Interface and Hardware Component Command Reference
311
D through E
diagnostic level
diagnostic level
To turn on power-on diagnostic tests for the network service engines (NSEs) installed in a Cisco 7300 series
router, use the diagnostic level command in privileged EXEC configuration mode. There is no no form of
this command.
diagnostic level {power-on|bypass}
Syntax Description power-on Power-on diagnostic tests are performed at system bootup on the NSEs.
bypass No diagnostic tests are performed. This is the default.
Command Default No diagnostic tests are performed.
Command Modes Privileged EXEC
Command History Release Modification
12.1(10)EX2 This command was introduced.
12.2(18)S This command was introduced on Cisco 7304 routers running Cisco IOS Release 12.2 S.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use this command to enable power-on diagnostic tests to run on the installed NSEs of a Cisco 7300 series
router when the system is booted. It is recommended that you issue this command only if you are experiencing
problems with an NSE and are planning on rebooting the router. Issuing this command causes an increase in
the boot time.
Examples The following example shows how to enable diagnostic power-on tests:
diagnostic level power-on
The following sample output shows the output that is displayed upon system bootup after a power
cycle or router crash:
.
.
.
System Power On Diagnostics
DRAM Size ....................128 MB
Testing DRAM..................Passed
Level2 Cache .................Present
Testing Level2 Cache (256 KB)Passed
Level3 Cache .................Present
Testing Level3 Cache (1024 KB)Passed
System Power On Diagnostics Complete
Cisco IOS Interface and Hardware Component Command Reference
312
D through E
diagnostic level
Note This output is displayed when the system is booting, not when the command is issued.
Related Commands Command Description
debug redundancy Enables NSE redundancy debugging.
show c7300 Displays the types of cards (NSE and line cards) installed in a Cisco 7300 series
router.
show redundancy (7300) Displays redundancy information for the active and standby NSEs.
Cisco IOS Interface and Hardware Component Command Reference
313
D through E
dial-tdm-clock
dial-tdm-clock
To configure the clock source and priority of the clock source used by the time-division multiplexing (TDM)
bus on the dial shelf of the Cisco AS5800, use the dial-tdm-clock command in global configuration mode.
To return the clock source and priority to the default values, use the no form of this command.
dial-tdm-clock priority number {external {e1|t1} [120ohm]|freerun|trunk-slot slot port port}
[line {0|1}]
no dial-tdm-clock priority number {external {e1|t1} [120ohm]|freerun|trunk-slot slot port port}
[line {0|1}]
Syntax Description priority number Specifies the priority of the clock source. The range is from 1 to 50. Priority 1 is the
highest priority, and 50 is the lowest.
external Specifies the priority of an external clock source. The external clock source is connected
to the front panel of the Dial Shelf Controller (DSC) card.
e1 | t1} [120ohm] Specifies priority of the E1 (2.048 MHz) or T1 (1.54 MHz) external clock source. The
default value of the external coaxial cable impedance is 75 ohm. Specify the
120ohmoption if a 120 ohm coaxial cable is connected.
freerun Specifies the priority of the local oscillator clock source.
trunk-slot slot Specifies the priority of the trunk card to provide the clock source. The slot number is
from 0 to 5 (these are the only slots capable of providing clock sources).
port port Specifies the controller number on the trunk used to provide the clock source. The port
number is from 0 to 28. The T1 and E1 trunk cards each have 12 ports. The T3 trunk
card has 28 ports.
line {0 | 1 (Optional) Specifies the optical port. If the physical optical port is 0, theline value is
also 0.
Command Default If no clock sources are specified, the software selects the first available good clock source on a trunk port.
Command Modes Global configuration
Command History Release Modification
11.3(2)AA This command was introduced.
12.2(15)T The line keyword was added.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The TDM bus in the backplane on the dial shelf must be synchronized to the T1/E1 clocks on the trunk cards.
The DSC card on the dial shelf provides hardware logic to accept multiple clock sources as input and use one
Cisco IOS Interface and Hardware Component Command Reference
314
D through E
dial-tdm-clock
of them as the primary source to generate a stable, PPL synchronized output clock. The input clock can be
any of the following sources:
• Trunk port in slots 0 through 5 (up to 12 can be selected (two per slot)
• An external T1 or E1 clock source fed directly through a connector on the DSC card
• A free running clock from an oscillator in the clocking hardware on the DSC card
The clock commands are listed in the configuration file with the highest priority listed first.
If the current primary clock source is good, specifying another clock source of higher priority does not cause
the clock source to switch to the higher priority clock source. The new higher priority clock source is used as
a backup clock source. This prevents switching of the clock source as you enter multiple dial-tdm-clock
priority configuration commands in random order. Also, it is important not to disturb the existing clock source
as long as it is good. To force the new higher priority clock source to take over from a currently good primary
clock source, configure the new clock source and use the no dial-tdm-clock priority command to remove the
current primary clock source.
To display the current primary and backup clocks along with their priorities, use the
showdial-shelfclocksEXECcommand.
Examples In the following example, an external clock source is set at priority 1 and the trunk card in slot 4,
port 1 is set at priority 5:
Router(config)# dial-tdm-clock priority 1 external t1
Router(config)# dial-tdm-clock priority 5 trunk-slot 4 port 1
Router(config)# exit
Related Commands Command Description
show dial-shelf Displays information about the dial shelf, including clocking information.
Cisco IOS Interface and Hardware Component Command Reference
315
D through E
dot1q tunneling ethertype
dot1q tunneling ethertype
To define the Ethertype field type used by peer devices when implementing Q-in-Q VLAN tagging, use the
dot1qtunnelingethertypecommand in interface configuration mode. To remove the VLAN tag Ethertype,
use the no form of this command.
no dot1q tunneling ethertype{0x88A8 0x9100 0x9200}
no dot1q tunneling ethertype
Syntax Description 0x88A8 |0x9100|0x9200 Type of Ethertype field.
Command Default The Ethertype field used by peer devices when implementing Q-in-Q VLAN tagging is 0x8100.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.3(7)T This command was introduced.
12.3(7)XI1 This command was implemented on the Cisco 10000 series routers.
12.2(31)SB2 This command was integrated into Cisco IOS Release 12.2(31)SB2.
12.2(33)SRC This command was integrated into Cisco IOS Release 12.2(33)SRC.
Cisco IOS XE Release 2.2 This command was integrated into Cisco IOS XE Release 2.2.
Usage Guidelines Use the dot1qtunnelingethertype command if the peer switching devices are using an Ethertype field value
of 0x9100 or 0x9200. All Cisco switching devices use the default Ethertype field value of 0x88A8. The Cisco
10000 series router also supports the 0x9200 Ethertype field value.
Note On the Cisco 10000 series router, the Ethertype field for the outer VLAN ID can be changed, but the Ethertype
field for the inner VLAN ID cannot be changed.
This command is used with the IEEE 802.1Q-in-Q VLAN Tag Termination feature in which double VLAN
tagging is configured using the encapsulationdot1q command. 802.1Q double tagging allows a service
provider to use a single VLAN to support customers who have multiple VLANs.
Examples The following example shows how to configure an Ethertype field as 0x9100:
Router(config
)
# interface gigabitethernet 1/0/0
Router(config
-if)#
dot1q tunneling ethertype 0x9100
Cisco IOS Interface and Hardware Component Command Reference
316
D through E
dot1q tunneling ethertype
The following example shows how to configure an Ethertype field as 0x9200 on a Cisco 10000 series
router:
Router(config)# interface gigabitethernet 1/0/0
Router(config-if)# dot1q tunneling ethertype 0x9200
Related Commands Command Description
encapsulation dot1q Enables 802.1Q encapsulation of traffic on a specified subinterface or range of
subinterfaces.
interface Configures an interface and enters interface configuration mode.
Cisco IOS Interface and Hardware Component Command Reference
317
D through E
down-when-looped
down-when-looped
To configure an interface to inform the system that it is down when loopback is detected, use the
down-when-loopedcommand in interface configuration mode.
down-when-looped
Syntax Description This command has no arguments or keywords.
Command Default Disabled
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command is valid for High-Level Data Link Control (HDLC) or PPP encapsulation on serial and
High-Speed Serial Interface (HSSI) interfaces.
This command does not have a no form.
Note • This command cannot be enabled when default speed or 1000BaseT advertisement is enabled on the
GMII interface.
• 1000BaseT advertisement cannot be configured when down-when-looped is enabled.
Backup Interfaces
When an interface has a backup interface configured, it is often desirable that the backup interface be enabled
when the primary interface is either down or in loopback. By default, the backup is enabled only if the primary
interface is down. By using the down-when-looped command, the backup interface will also be enabled if
the primary interface is in loopback.
Testing an Interface with the Loopback Command
If testing an interface with the loopback command, or by placing the DCE into loopback, the
down-when-looped command should not be configured; otherwise, packets will not be transmitted out the
interface that is being tested.
Examples The following example shows how to configure interface serial 0 for HDLC encapsulation. The
interface is then configured to let the system know that it is down when in loopback mode.
Router(config)# interface serial0
Cisco IOS Interface and Hardware Component Command Reference
318
D through E
down-when-looped
Router(config-if)# encapsulation hdlc
Router(config-if)# down-when-looped
Related Commands Command Description
backup interface Configures an interface as a secondary or dial backup interface.
loopback (E3 controller) Diagnoses equipment malfunctions between an interface and a device.
Cisco IOS Interface and Hardware Component Command Reference
319
D through E
ds0-group (J1 controller)
ds0-group (J1 controller)
To configure channelized J1 time slots, use theds0-groupcommandincontroller configuration mode. To remove
the DS0 group, use theno form of this command.
ds0-group ds0-group-no timeslots timeslot-list type external-signaling
no ds0-group ds0-group-no timeslots timeslot-list type external-signaling
Syntax Description ds0-group-no Specifies the DS0 group number.
timeslots timeslot-list Specifies the DS0 time slot range of values from 1 to 31 for J1 interfaces.
Time slot 16 is reserved for signaling.
type external-signaling Specifies that the signaling traffic comes from an outside source. The signaling
method selection for type depends on the connection that you are making.
Command Default No DS0 group is defined.
Command Modes Controller configuration
Command History Release Modification
11.2 This command was originally the cas-group command.
12.0(1)T The cas-group command was introduced for the Cisco 3600 series.
12.0(5)XE The command was renamedds0-group on the Cisco AS5300 and on the Cisco 2600 and Cisco
3600 series.
12.0(7)T The command was integrated into the Cisco IOS Release 12.0(7)T.
12.2(8)T The command was introduced as a J1 configuration command for the Cisco 2600 and Cisco 3600
series.
Usage Guidelines The ds0-group command replaces the existing cas-group command. Making the command generic allows
flexibility and scalability. It is not restricted to channel associated signaling (CAS) or channel bundling.
The ds0-group command automatically creates a logical voice port that is numbered as follows on Cisco
2600 and Cisco 3600 series routers: slot/port:ds0-group-no. Although only one voice port is created for each
group, applicable calls are routed to any channel in the group.
Examples The following example is sample output from the showcontrollersj1command on the Cisco 3660
series after channelized J1 time slots have been configured:
Router(config-controller)# ds0-group 1 timeslots 1-15,17-31 type e&m-wink-start
Router(config-controller)# end
Router# show controllers j1
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(1), cp
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(2), cp
Cisco IOS Interface and Hardware Component Command Reference
320
D through E
ds0-group (J1 controller)
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(3), cp
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(4), cp
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(5), cp
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(6), cp
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(7), cp
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(8), cp
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(9), cp
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(10), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(11), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(12), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(13), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(14), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(15), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(17), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(18), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(19), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(20), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(21), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(22), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(23), p
*Mar 1 03:12:26.259: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(24), p
*Mar 1 03:12:26.263: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(25), p
*Mar 1 03:12:26.263: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(26), p
*Mar 1 03:12:26.263: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(27), p
*Mar 1 03:12:26.263: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(28), p
*Mar 1 03:12:26.263: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(29), p
*Mar 1 03:12:26.263: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(30), p
*Mar 1 03:12:26.263: %LINK-3-UPDOWN: Interface recEive and transMit3/0:0(31), p
Related Commands Command Description
ds0 busyout Busyouts one or more signal level 0s (DS0s).
Cisco IOS Interface and Hardware Component Command Reference
321
D through E
dsl-group
dsl-group
To create and configure a digital subscriber line (DSL) group, and enter config-controller-dsl-group mode,
or to automatically configure an ATM group, use the dsl-groupcommand in configuration controller mode.
To disable the DSL group, use the no form of this command.
dsl-group [pairs] [{[number] pairs link-number|auto [{default|exit|no|shdsl {4-wire|annex}}]}]
[efm-bond]
no dsl-group [pairs] [{[number] pairs link-number|auto [{default|exit|no|shdsl {4-wire|annex}}]}]
[efm-bond]
Syntax Description pairs (Optional) Defines the DSL wire pairs.
number (Optional) DSL group number. The DSL group number can be one of the following numbers:
•0
•1
efm-bond (Optional) Defines the DSL group as Ethernet First Mile (EFM) group bonding group.
Cisco IOS Interface and Hardware Component Command Reference
322
D through E
dsl-group
link-number (Optional) Link number of the pair. Link number options are limited to one of the following
choices, based on the hardware interface and the desired DSL group:
HWIC-4SHDSL-E
EFM-bond DSL Group
•0
•1
•2
•3
• Any combination of the numbers 0, 1, 2, and 3
1-Pair DSL Group
•0
•1
•2
•3
In the case of 1-pair DSL group (2-wire), only one pair needs to be configured.
HWIC-4SHDSL
IMA DSL Group
•0
•1
•2
•3
• Any combination of the numbers 0, 1, 2, and 3
Cisco IOS Interface and Hardware Component Command Reference
323
D through E
dsl-group
M-Pair DSL Group
• 0-1
• 0-2
• 0-3
2-Pair DSL Group
• 0-1
• 2-3
1-Pair DSL Group
•0
•1
•2
HWIC-2SHDSL
DSL Group 0
•0
• 0-1
DSL Group 1
•1
auto (Optional) Automatically assigns the Central Office’s (CO) wire configuration to an ATM
DSL group on the Customer Premise Equipment (CPE).
default (Optional) Sets a command to the default values.
exit (Optional) Exits DSL group command mode.
no (Optional) Negates a command or set its defaults.
shdsl (Optional) Configures the symmetric g.shdsl.
4-wire (Optional) Configures the 4-wire symmetric g.shdsl.
annex (Optional) Configures the annex symmetric g.shdsl.
Command Default No DSL group is defined or automatically configured.
Command Modes Configuration controller (config-controller)
Configuration controller DSL group (config-controller-dsl-group)
Cisco IOS Interface and Hardware Component Command Reference
324
D through E
dsl-group
Command History Release Modification
12.4(15)T This command was introduced for the Cisco HWIC-4SHDSL and HWIC-2SHDSL running on
the Cisco 1841 router and the Cisco 2800 and 3800 series access routers.
15.1(1)T This command was modified to support automatic configuration of Cisco HWIC-4SHDSL and
HWIC-2SHDSL running on the Cisco 1841 router and the Cisco 2800 and 3800 series access
routers.
Added dsl-grouppairslink-number [efm-bond] for the Cisco HWIC-4SHDSL-E.
15.1(1)T1 This command was modified. The auto configuration options default,exit,no, and shdslwere
added to the dsl-group.
Usage Guidelines Use the dsl-group command in configuration controller mode to define the DSL group, and manually configure
the DSL group from configuration controller DSL group mode. Use the dsl-groupauto command to
automatically adopt the Central Office (CO) wire configuration on an ATM DSL group. Use the dsl-grouppairs
to define the DSL group as Ethernet First Mile (EFM) group bonding group.
Note Automatic configuration is not supported on IMA groups.
Automatic configuration is limited to only one DSL group and ATM interface. After a group is automatically
configured, no other group can be created. All manually created groups must be deleted before creating an
automatic configuration group.
Examples The following example shows how to use the dsl-group command to create an IMA-DSL group and
enter configuration controller DSL group mode:
Router(config-controller)# dsl-group 1 pairs 0-1 ima
Router(config-controller-dsl-group)#
Sep 14 13:15:40.285:%HWIC_SHDSL-5-DSLGROUP_UPDOWN: SHDSL 0/2/0 dsl-group(1) state changed
to down.
Sep 14 13:15:42.285:%LINK-3-UPDOWN: Interface ATM0/2/IMA1, changed state to down
Sep 14 13:15:43.285:%LINEPROTO-5-UPDOWN: Line protocol on Interface ATM0/2/IMA1, changed
state to down
The following example shows how to use the dsl-group auto command to automatically adopt the
Central Office (CO) configuration on an ATM group:
Router(config-controller)# dsl-group auto
Router(config-controller-dsl-group-auto)#
*May 14 18:56:33.136: %HWIC_SHDSL-5-DSLGROUP_UPDOWN: SHDSL 0/0/0 dsl-group(0) state changed
to down.
*May 14 18:56:35.136: %LINK-3-UPDOWN: Interface ATM0/0/0, changed state to down
*May 14 18:56:36.136: %LINEPROTO-5-UPDOWN: Line protocol on Interface ATM0/0/0,
changed state to down
The following example shows how to configure a single-pair DSL group and enters the configuration
controller DSL group mode:
Router(config-controller)# dsl-group pairs 0
Router(config-controller-dsl-group)#
Cisco IOS Interface and Hardware Component Command Reference
325
D through E
dsl-group
The following example shows how to create a 4-pair EFM bonding group:
Router(config-controller)# dsl-group pairs 0-3 efm-bond
Router(config-controller-dsl-group)#
Related Commands Command Description
controller shdsl Configures a controller for SHDSL mode and enters configuration controller
mode.
ima group Defines physical links as IMA group members.
ima group clock-mode Sets the clock mode for an IMA group.
ima link Defines physical links in an IMA group.
shdsl 4-wire mode enhanced Defines the SHDSL to use enhanced mode in a 2-pair DSL group.
shdsl annex Defines the SHDSL G.991.2 standard.
shdsl rate Defines the SHDSL rate.
show controller shdsl Displays the status of the controller that is configured for SHDSL mode.
Cisco IOS Interface and Hardware Component Command Reference
326
D through E
dsl-mode shdsl symmetric annex
dsl-mode shdsl symmetric annex
To specify the operating mode of the digital subscriber line (DSL) controller, use the dsl-mode shdsl symmetric
annexcommand in controller configuration mode.
To specify the line coding type of the DSL controller, use the dsl-mode shdsl symmetric annex
codingcommand in controller configuration mode. To return the DSL to the default Annex A, use the no form
of the command.
dsl-mode shdsl symmetric annex mode [coding type]
no dsl-mode shdsl symmetric annex mode [coding type]
Syntax Description mode Sets the DSL operating mode. The valid values are:
• a : Supports Annex A of the G.991.2 standard for North America. This is the default.
• b : Supports Annex B of the G.991.2 standard for Europe.
• a-b : Supports Annex A or B. For CPE mode only. Not supported in CO mode. Selected when
the line trains.
• a-b-anfp : Supports Annex A or B-ANFP. For CPE mode only. Not supported in CO mode.
Selected when the line trains.
• b-anfp : Supports Annex B-ANFP.
• f: Supports Annex F, 2-wire mode, line 0 only.
• f-g: Supports Annex F-G, 2-wire mode, line 0 only.
• g: Supports Annex G, 2-wire mode, line 0 only.
coding TCPAM line coding.
Type The valid values are:
• 16bit-TCPAM: Sets the line coding to16 bit-TCPAM.
• 32bit-TCPAM: Sets the line coding to 32 bit-TCPAM.
• AUTO-TCPAM: Detects the central office coding type.
The annex defaults to A for North America.
Command Modes
Controller configuration (config-controller)
Command History Release Modification
12.3(4)XD This command was introduced on Cisco 2600 series and Cisco 3700 series routers.
12.3(4)XG This command was integrated into the Cisco IOS Release 12.3(4)XG on the Cisco 1700 series
routers.
Cisco IOS Interface and Hardware Component Command Reference
327
D through E
dsl-mode shdsl symmetric annex
Release Modification
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T on Cisco 2600 series, Cisco
3631, and Cisco 3700 series routers.
12.3(11)T Support for the following additional annex parameters was integrated into Cisco IOS Release
12.3(11)T to support Cisco 1700, Cisco 2600, Cisco 2800, Cisco 3700, and Cisco 3800 series
routers:
•b
• a-b
• a-b-anfp
• b-anfp
12.3(14)T This command was implemented on Cisco 1800 series routers.
12.4(15)T Support for the following additional annex parameters was integrated into Cisco IOS Release
12.X(X)T to support Cisco to support Cisco 1700, Cisco 2600, Cisco 2800, Cisco 3700, and
Cisco 3800 series routers:
•f
• f-g
•g
12.4(20)T Support for coding type parameters was added.
Usage Guidelines This command is used to configure the DSL controller interface to operate in a specified DSL mode and to
set regional operating parameters. The shdsl keyword is used to set the mode to SHDSL and configures
multirate, high-speed DSL per ITU G.991.2. The symmetric keyword configures the controller to symmetric
mode. The annex keyword configures the controller to use regional operating parameters. The regional
operating parameters default to North America. The coding keyword configures the controller Trellis Encoded
Pulse Amplitude Modulation (TCPAM) line coding type.
Examples The following example displays the use of the controller dsl 0/0commandto configure the controller
in the router configured on the central office (CO) side. Use the dsl-mode shdsl symmetric annex
bcommand to configure the controller for multirate, high-speed DSL with symmetric mode for
European operating parameters.
Router# configure terminal
Router(config)# controller dsl 0/0
Router(config-controller)# line-term co
Router(config-controller)# dsl-mode shdsl symmetric annex b
Router(config-controller)# mode atm
Router(config-controller)#
00:22:07: %CONTROLLER-5-UPDOWN: Controller DSL 0/0, changed state to down
Router(config-controller)# line-mode 4-wire
00:23:25: %CONTROLLER-5-UPDOWN: Controller DSL 0/0, changed state to up
00:23:31: %LINK-3-UPDOWN: Interface ATM0/0, changed state to up
00:23:32: %LINEPROTO-5-UPDOWN: Line protocol on Interface ATM0/0, changed state to up
Cisco IOS Interface and Hardware Component Command Reference
328
D through E
dsl-mode shdsl symmetric annex
The following example uses the dsl-mode shdsl symmetric annex command to configure the
controller for 2-wire line 0, annex F, AUTO-TCPAM line coding.
Router> enable
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# controller dsl 0
Router(config-controller)# line-mode 2-wire line-zero
Router(config-controller)# dsl-mode shdsl symmetric annex f coding ?
16bit-TCPAM 16bit-TCPAM line coding
32bit-TCPAM 32bit-TCPAM line coding
AUTO-TCPAM AUTO-TCPAM line coding
Router(config-controller)# dsl-mode shdsl symmetric annex f coding auto-tcpam
Router(config-controller)#
Router#
Related Commands Command Description
controller dsl Configures the DSL controller.
Cisco IOS Interface and Hardware Component Command Reference
329
D through E
dsu bandwidth
dsu bandwidth
To specify the maximum allowable bandwidth used by a T3 or E3 controller or the PA-T3 and PA-E3 port
adapters, use the dsubandwidthcommand in interface configuration mode. To return to the default bandwidth,
use the no form of this command.
dsu bandwidth kbps
no dsu bandwidth
Syntax Description kbps Maximum bandwidth, in kbps. Range is from 22 to 44736. Default values are as follows:
• 34,010 for E3 or PA-E3
• 44,210 for T3
• 44,736 for PA-T3
• 34,368 kbps for E3 on a Cisco_10000 Series Router
• 44,210 kbps for T3 on a Cisco_10000 Series Router
Command Default 34,010 kbps
44,210 kbps
44,736 kbps
34,368 kbps for E3
44,210 kbps for T3
Command Modes Interface configuration
Command History Release Modification
11.1CA This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and implemented on the
following platforms: Cisco 2650XM, Cisco 2651XM, Cisco 2691, Cisco 3660 series, Cisco
3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
12.2(31)SB This command was integrated into Cisco IOS Release 12.2(31)SB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Local and Remote Bandwidths
Cisco IOS Interface and Hardware Component Command Reference
330
D through E
dsu bandwidth
The local interface configuration must match the remote interface configuration. For example, if you reduce
the maximum bandwidth to 16,000 on the local port, you must also do the same on the remote port.
The dsubandwidthcommand reduces the bandwidth by padding the E3 and T3 frame.
Verifying DSU Bandwidth
To verify the data service unit (DSU) bandwidth configured on the interface, use the show interfaces serial
user EXEC command.
G.751 Framing
When G.751 framing is used, DSU bandwidth can be used to select a payload subrate from 34,010 kbps down
to 22 kbps. Before framing bypass can be used, a DSU bandwidth of 34,010 kbps must be configured.
Continuous Range of Bandwidth
Even though Cisco_IOS software allows you to configure a continuous range of bandwidths in subrate modes,
vendors support bandwidths only in quantums (for example, in an E3 digital link, bandwidth must be in
multiples of 358 kbps). Therefore, the software sets the user-configured bandwidth to the closest
vendor-supported bandwidth. Use the show interfaces serial slot/port command to display the actual bandwidth
that is configured.
Subrates
The user-configured subrate mode, subrate bandwidth, actual subrate bandwidth configured, and scramble
configuration are displayed near the end of the show interfaces serial command output.
DSU Modes and Vendor-Supported Bandwidths
The following table shows DSU modes and vendor-supported bandwidths.
Mode DSU Bandwidth Range Bandwidth Multiples
0 Digital Link or Cisco 358-34,010 kbps for E3 358 kbps
300-44,210 kbps for T3 300.746 kbps
1 ADC Kentrox T3/E3 IDSU 1000-34,010 kbps for E3 500 kbps
1500-44,210 kbps for T3 500 kbps
2 Larscom Access T45 3100-44,210 kbps 3158 kbps
3 Adtran T3SU 300 75-44,210 kbps 75.186 kbps
4 Verilink HDM 2182 1500-44,210 kbps 1579 kbps
Examples The following example sets the maximum allowable DSU bandwidth to 16,000 kbps on interface
1/0/0:
Router(config)# interface serial 1/0/0
Router(config-if)# dsu bandwidth 16000
The following example shows the user-configured subrate bandwidth and the actual configured
subrate bandwidth as displayed in the output of the show interfaces serial command:
Router# show interfaces serial
Serial1/0 is up, line protocol is up
Cisco IOS Interface and Hardware Component Command Reference
331
D through E
dsu bandwidth
Hardware is DSXPNM Serial
MTU 1500 bytes, BW 44210 Kbit, DLY 20000 usec,
reliability 253/255, txload 1/255, rxload 1/255
Encapsulation HDLC, crc 16, loopback not set
Keepalive not set
DTR is pulsed for 0 seconds on reset, Restart-Delay is 1637167 secs
Last input 04:59:04, output 04:59:04, output hang never
Last clearing of "show interface" counters 00:00:02
Input queue:0/75/0/0 (size/max/drops/flushes); Total output drops:0
Queueing strategy:fifo
Output queue :0/40 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 packets output, 0 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
0 carrier transitions
DSU mode 0, bandwidth 34010, real bandwidth 34010, scramble 0
Related Commands Command Description
show interfaces serial Displays information that is specific to the interface hardware.
Cisco IOS Interface and Hardware Component Command Reference
332
D through E
dsu mode
dsu mode
To specify the interoperability mode used by a T3 or E3 controller or the PA-T3 and PA-E3 port adapters,
use the dsumodecommand in interface configuration mode. To return to the default mode, use the no form
of this command.
dsu mode {0|1|2|3|4}
no dsu mode
Cisco 10000 Series Router
dsu mode {adtran|cisco|digital-link|kentrox|larscom|verilink-highbit|verilink-lowbit}
no dsu mode
Syntax Description 0 Sets the interoperability mode to 0. This is the default.
• Specify mode 0 to connect an E3 controller to another E3 controller or to a Digital
Link data service unit (DSU) DL3100.
• Specify mode 0 to connect a PA-E3 port adapter to another PA-E3 port adapter or
to a DL3100.
• Specify mode 0 to connect a PA-T3 port adapter to another PA-T3 port adapter or
to a DL3100.
1 Sets the interoperability mode to 1. Specify mode 1 to connect an E3 or T3 controller or
a PA-E3 or PA-T3 port adapter to a Kentrox DSU.
2 Sets the interoperability mode to 2. Specify mode 2 to connect a T3 controller or a PA-T3
port adapter to a Larscom DSU.
3 Sets the interoperability mode to 3. Specify mode 3 to connect a T3 controller to an
Adtran T3SU 300.
4 Sets the interoperability mode to 4. Specify mode 4 to connect a T3 controller to a Verilink
HDM 2182.
adtran Connects a T3 interface to an Adtran DSU.
cisco Connects an E3 or T3 interface to a Cisco DSU.
digital-link Connects an E3 or T3 interface to a Digital Link DSU.
kentrox Connects an E3 or T3 interface to a Kentrox DSU.
larscom Connects a T3 interface to a Larscom DSU.
verilink-highbit Connects a T3 interface to a Verilink High Bit DSU.
verilink-lowbit Connects a T3 interface to a Verilink Low Bit DSU.
Command Default 0
Cisco IOS Interface and Hardware Component Command Reference
333
D through E
dsu mode
cisco
Command Modes Interface configuration
Command History Release Modification
11.1CA This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and implemented on the
following platforms for E3 and T3 controllers: Cisco 2650XM, Cisco 2651XM, Cisco 2691,
Cisco 3660 series, Cisco 3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
12.2(31)SB This command was integrated into Cisco IOS Release 12.2(31)SB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Scrambling Support in DSU Mode 1
DSU mode 1 refers to Kentrox mode. If DSU mode is used on a T3 serial interface and the bandwidth is
greater than or equal to 35,000 bits per second (bps), the scrambling option is not supported. Likewise, if DSU
mode 1 is used for an E3 serial interface and the bandwidth is greater than or equal to 24,510 bps, scrambling
is not supported.
Match Local and Remote DSU Configurations
The local interface configuration must match the remote interface configuration. For example, if you define
the DSU interoperability mode as 1 on the local port, you must also do the same on the remote port.
Know the DSU Type
You must know what type of DSU is connected to the remote port to determine if it interoperates with an E3
or T3 controller or a PA-E3 or PA-T3 port adapter. The dsumode command enables and improves
interoperability with other DSUs.
Verify DSU Mode
To verify the DSU mode configured on the interface, use the showcontrollersserial or showinterfacesserial
user EXEC commands.
Cisco 10000 Series Router
Only Cisco, Digital Link, and Kentrox DSUs are supported on E3 interfaces.
Examples
Setting DSU Mode
The following example sets the DSU mode to 1 on interface 1/0/0:
Router(config)# interface serial 1/0/0
Router(config-if)# dsu mode 1
Cisco IOS Interface and Hardware Component Command Reference
334
D through E
dsu mode
Serial Interface in DSI Mode 1
The following example shows the configuration for a serial interface configured in DSU mode 1.
The bandwidth is set higher than that supported by the Kentrox firmware allows for scrambling.
therefore, the scrambling option is not supported in this configuration.
Router(config
)#
interface serial 1/0/0
Router(config-if)# mtu 4474
Router(config-if)# ip address 192.168.93.114 255.255.255.252
Router(config-if)# ip mtu 4470
Router(config-if)# dsu mode 1
Router(config-if)# dsu bandwidth 44210
Cisco 10000 Series Router
The following example sets the DSU mode to cisco:
Router(config)# interface serial 1/0/0
Router(config-if)# dsu mode cisco
Related Commands Command Description
show controllers Displays information about the controllers.
show interfaces Displays statistics for all interfaces configured on the router.
Cisco IOS Interface and Hardware Component Command Reference
335
D through E
dte-invert-txc
dte-invert-txc
To invert the transmit external clock (TXC) signal received from the DCE when the device is operating as a
DTE, use the dte-invert-txc command in interface configuration mode. If the DCE accepts serial clock transmit
external (SCTE) signal when the device is operating as a DTE, use the no form of this command.
dte-invert-txc
no dte-invert-txc
Syntax Description This command has no arguments or keywords.
Command Default The TXC signal is not inverted.
Command Modes Interface configuration
Command History Release Modification
9.1 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use this command if the DCE cannot receive SCTE from the DTE, the data is running at high speeds, and
the transmission line is long. The dte-invert-txc command prevents phase shifting of the data with respect
to the clock.
On the Cisco 4000 series, you can specify the serial Network Processor Module timing signal configuration.
When the board is operating as a DTE, the dte-invert-txc command inverts the TXC clock signal it gets from
the DCE that the DTE uses to transmit data.
If the DCE accepts SCTE from the DTE, use nodte-invert-txc.
Examples The following example inverts the TXC on serial interface 0:
Router(config)# interface serial 0
Router(config-if)# dte-invert-txc
Cisco IOS Interface and Hardware Component Command Reference
336
D through E
duplex
duplex
To configure the duplex operation on an interface, use the duplex command in interface configuration mode.
To return to the default configuration, use the no form of this command.
duplex {full |half |auto}
no duplex
Syntax Description full Specifies full-duplex operation.
half Specifies half-duplex operation.
auto Enables autonegotiation. The interface automatically operates at half-duplex or full-duplex mode
depending on environmental factors, such as the type of media and the transmission speeds for the
peer routers, hubs, and switches used in the network configuration.
Command Default Half-duplex mode is enabled.
For the 4-port 10/100 Fast Ethernet Shared Port Adapter (SPA) and the 2-port 10/100/1000 Gigabit Ethernet
SPA on the Cisco 7304 router, autonegotiation is enabled. The command is set to auto.
Command Modes Interface configuration (config-if)
Command History Release Modification
11.2(10)P This command was introduced.
12.2S This command was integrated into Cisco IOS Release 12.2S.
12.2(14)SX This command was implemented on the Supervisor Engine 720.
12.2(17d)SXB This command was integrated into Cisco IOS Release 12.2 SXB.
12.2(20)S2 This command was implemented on the 4-port 10/100 Fast Ethernet SPA and
the 2-port 10/100/1000 Gigabit Ethernet SPA on the Cisco 7304 router.
Cisco IOS XE Release This command was integrated into Cisco IOS XE Release 3.9S.
3.9S
15.2(02)SA This command was implemented on the Cisco ME 2600X Series Ethernet Access
Switches.
Usage Guidelines To use the autonegotiation capability (that is, to automatically detect speed and duplex modes), you must set
both the speed command and the duplex command to auto.
Cisco Cloud Services Router 1000V Series
Cisco Cloud Services Router 1000V Series does not support the duplex command.
Duplex Options and Interfaces
The table below lists the supported command options by interface type.
Cisco IOS Interface and Hardware Component Command Reference
337
D through E
duplex
Table 12: Supported Duplex Command Options
Interface Type Supported Syntax Default Setting Usage Guidelines
10/100-Mbps module duplex [half | full] See the “Usage Run the no duplex auto command
Guidelines” column. to set the speed to auto.
If the speed is set to 10 or 100,
without configuring the duplex
setting, the duplex is set to half.
100-Mbps fiber modules duplex [half | full] half
Gigabit Ethernet interfaces duplex full full
10-Mbps ports duplex [half | full] half
If the transmission speed on a 16-port RJ-45 Gigabit Ethernet port is set to 1000, the duplex mode is set to
full. If the transmission speed is changed to 10 or 100, the duplex mode stays at half duplex. You must configure
the correct duplex mode when the transmission speed is changed to 10 or 100 from 1000.
Gigabit Ethernet is full duplex only. You cannot change the mode on Gigabit Ethernet ports.
When manually configuring the interface speed to either 10 or 100-Mbps, you should also configure the duplex
mode on the interface.
Caution Changing the interface speed and duplex mode configuration might shut down and reenable the interface
during reconfiguration.
4-Port 10/100 Fast Ethernet SPA and 2-Port 10/100/1000 Gigabit Ethernet SPA on the Cisco 7304
Router
The duplex command is applied to the SPA interfaces that use the RJ-45 media. Gigabit Ethernet interfaces
using fiber media support full-duplex mode only and use the negotiation command to enable and disable
autonegotiation.
To enable the autonegotiation capability on an RJ-45 interface, you must set either the speed command or
the duplex command to auto. The default configuration is that both commands are set to auto.
Note For the Cisco AS5300, the duplex {full | half | auto} command syntax replaces the duplex
commands—half-duplex and full-duplex. Cisco 7600 series routers can automatically negotiate the interface
speed and the duplex mode only if one of the connected interfaces are configured to auto.
The table below describes the interface behavior for different combinations of the duplex and speed command
settings. The specified duplex command configured with the specified speed command produces the resulting
system action.
If you specify both duplex and speed settings other than auto on an RJ-45 interface, autonegotiation is disabled
for the interface.
Cisco IOS Interface and Hardware Component Command Reference
338
D through E
duplex
Note If you need to force an interface port to operate with certain settings and, therefore, need to disable
autonegotiation, you must be sure that the remote link is configured with compatible link settings for proper
transmission including the support of flow control on the link.
Note Every interface on a 4-port 10/100 Fast Ethernet SPA supports transmission of pause frames to stop packet
flow when the Modular Services Card (MSC) is full. You cannot disable flow control for an interface on the
4-port 10/100 Fast Ethernet SPA. Hence, the flow control support is not configurable, but it is advertised
during autonegotiation. If you disable autonegotiation, you must be sure that the remote device is configured
to support flow control because flow control is automatically enabled for all interfaces on the 4-port 10/100
Fast Ethernet SPA.
Table 13: Relationship Between duplex and speed Commands
duplex Command speed Command Resulting System Action
duplex auto speed auto Autonegotiates both speed and duplex modes. The interface
advertises the capability for the following link settings:
• 10 Mbps and half duplex
• 10 Mbps and full duplex
• 100 Mbps and half duplex
• 100 Mbps and full duplex
• 1000 Mbps and half duplex
• 1000 Mbps and full duplex
duplex auto speed 10 or speed Autonegotiates the duplex mode. The interface advertises the
100 or speed 1000 capability for the configured speed with the capability for both
half-duplex or full-duplex mode.
For example, if the speed 100 command is configured with duplex
auto, then the interface advertises the following capability:
• 100 Mbps and half duplex
• 100 Mbps and full duplex
Cisco IOS Interface and Hardware Component Command Reference
339
D through E
duplex
duplex Command speed Command Resulting System Action
duplex half or speed auto Autonegotiates the speed. The interface advertises the capability
duplex full for duplex mode for Fast Ethernet interfaces at a speed of 10-Mbps
and 100-Mbps, and Gigabit interfaces at 10-Mbps, 100-Mbps, and
1000-Mbps.
For example, if the duplex full command is configured with the
speed auto command, then the interface advertises the following
capability:
• 10 Mbps and full duplex
• 100 Mbps and full duplex
• 1000 Mbps and full duplex (Gigabit Ethernet interfaces only)
duplex half speed 10 Forces 10-Mbps speed and the half-duplex operation, and disables
autonegotiation on the interface.
duplex full speed 10 Forces a speed of 10-Mbps and the full-duplex operation, and
disables autonegotiation on the interface.
duplex half speed 100 Forces a speed of 100-Mbps and the half-duplex operation, and
disables autonegotiation on the interface.
duplex full speed 100 Forces a speed of 100-Mbps and the full-duplex operation, and
disables autonegotiation on the interface.
duplex half speed 1000 Forces a speed of 1000-Mbps and the half-duplex operation, and
disables autonegotiation on the interface (Gigabit Ethernet only).
duplex full speed 1000 Forces a speed of 1000-Mbps and the full-duplex operation, and
disables autonegotiation on the interface (Gigabit Ethernet only).
Examples The following example shows how to configure a full-duplex operation on a Cisco AS5300 router:
Device(config)# interface fastethernet 0
Device(config-if)# duplex full
The following example shows how to specify the advertisement of only half-duplex support and
either 10-Mbps or 100-Mbps capability during autonegotiation for the second interface (port 1) on
the SPA located in the bottom subslot (1) of the MSC that is installed in slot 2 of the Cisco 7304
router:
Device# configure terminal
Device(config)# interface fastethernet 2/1/1
Device(config-if)# duplex half
Device(config-if)# speed auto
With this configuration, the interface advertises the following capabilities during autonegotiation:
• 10 Mbps and half duplex
• 100 Mbps and half duplex
Cisco IOS Interface and Hardware Component Command Reference
340
D through E
duplex
Note Flow control support is always advertised when autonegotiation is enabled.
Related Commands Command Description
interface Configures an interface and enters interface configuration mode.
interface fastethernet Selects a particular Fast Ethernet interface for configuration.
interface gigabitethernet Selects a particular Gigabit Ethernet interface for configuration.
show controllers Displays information that is specific to the hardware on a module.
show controllers fastethernet Displays Fast Ethernet interface information, transmission statistics,
and errors, and the applicable MAC destination address and VLAN
filtering tables.
show controllers gigabitethernet Displays Gigabit Ethernet interface information, transmission statistics,
and errors, and the applicable MAC destination address and VLAN
filtering tables.
show interfaces Displays traffic that is seen by a specific interface.
show interfaces fastethernet Displays information about Fast Ethernet interfaces.
show interfaces gigabitethernet Displays information about Gigabit Ethernet interfaces.
speed Sets the port speed for a Fast Ethernet interface.
Cisco IOS Interface and Hardware Component Command Reference
341
D through E
dxi interface-dfa
dxi interface-dfa
To specify a map command for a point to point serial interface, use the Data Exchange Interface (dxi) command
dxiinterface-dfa in interface configuration mode. To deletct the map command, use the no form of this
command.
dxi interface-dfa vpi-number vci [{snap|mux}]
no dxi interface-dfa vpi-number vci
Syntax Description vpi-number ATM network virtual path identifier (VPI) of the permanent virtual circuit (PVC), in the range
from 0 to 15. The VPI is a 4-bit field in the header of the ATM DXI frame. The VPI value is
unique only on a single interface, not throughout the ATM network, because it has local
significance only.
Both vpi and vci cannot be specified as 0; if one is 0, the other cannot be 0.
vci ATM network virtual channel identifier (VCI) of this PVC, in the range from 0 to 63. The
VCI is a 6-bit field in the header of the ATM DXI frame. The VCI value is unique only on a
single interface, not throughout the ATM network, because it has local significance only.
Both vpi and vci cannot be specified as 0; if one is 0, the other cannot be 0.
snap (Optional) LLC/SNAP encapsulation based on the protocol used in the packet. This keyword
defines a PVC that can carry multiple network protocols. This is the default.
mux (Optional) Enables multiplex (mux) encapsulation.
Command Default No map command is specified.
Command Modes Interface configuration
Command Default No map definition is established.
Command Modes Interface configuration
Command History Release Modification
10.3 This command was introduced.
12.4 This command was integrated into Cisco IOS Release 12.4.
Examples The following example shows how to specify a map command.
Router(config)# interface serial 1
Router(config-if)# dxi interface-dfa 10
Related Commands Command Description
encapsulation atm-dxi Enables ATM-DXI encapsulation.
Cisco IOS Interface and Hardware Component Command Reference
342
D through E
dxi interface-dfa
Command Description
dxi pvc Configures multiprotocol or single protocol AMT-Data Exchange Interface (dxi)
encapsulation.
dxi map Maps a protocol address to a given virtual path identifier (VPI) and virtual channel
identifier (VCI).
show dxi pvc Displays the PVC statistics for a serial interface.
smds dxi Enables Data Exchange Interface (dxi) version 2.2 support.
dxi pvc Configures multiprotocol or single protocol AMT-Data Exchange Interface (dxi) encapsulation.
Cisco IOS Interface and Hardware Component Command Reference
343
D through E
dxs3mode
dxs3mode
To define the controller type as an E3 or T3 controller, use the dxs3mode command in controller configuration
mode. To remove the controller, use the no form of this command.
dxs3mode [{e3|t3}]
no dxs3mode [{e3|t3}]
Syntax Description e3 (Optional) Defines an E3 controller.
t3 (Optional) Defines a T3 controller.
Command Default t3
Command Modes Controller configuration
Command History Release Modification
12.2S This command was introduced.
Examples The following example defines a T3 controller:
Router(config
)
# controller dsx3 2/0/0
Router(config
-controller)
# dsx3mode t3
Related Commands Command Description
description Adds a description to identify particulars about a controller.
Cisco IOS Interface and Hardware Component Command Reference
344
D through E
e2-clockrate
e2-clockrate
To configure serial interface 0 for E2 (8 MHz full duplex) and to shut down the other three serial interfaces
(1 to 3), use the e2-clockrate command in interface configuration mode. To disable the full duplex E2, use
the no form of this command.
e2-clockrate
no e2-clockrate
Syntax Description This command has no arguments or keywords.
Command Default All interfaces are running.
Command Modes Interface configuration
Command History Release Modification
12.0(2)XD This command was introduced.
12.0(3)T This command was integrated into Cisco IOS Release 12.0(3)T.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The e2-clockrate command is an interface configuration command and is seen only with interfaceserial0.
When this command is used, serial interface 0 supports speeds up to E2 (8 MHz full duplex) and the other
three serial interfaces (1 to 3) are put in the “shutdown” state. Also, running this command displays the
following warning message:
Serial interface 0 is configured to support E2 rates and serial ports “1-3” are moved to
shutdown state
.
Examples The following example shows sample display output for the e2-clockrate EXEC command.
Router(config-if)#
e2-clockrate
Interface Serial 0 is configured to support clockrates up to E2 (8Mbps)
Interfaces serial 1-3 will not be operational
Related Commands Command Description
clock rate Configures the clock rate for the hardware connections on serial interfaces such as NIMs and
interface processors to an acceptable bit rate.
Cisco IOS Interface and Hardware Component Command Reference
345
D through E
early-token-release
early-token-release
To enable early token release on Token Ring interfaces, use the early-token-release command in interface
configuration mode. To disable this function, use the no form of this command.
early-token-release
no early-token-release
Syntax Description This command has no arguments or keywords.
Command Default Disabled
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Early token release is a method whereby the Token Ring interfaces can release the token back onto the ring
immediately after transmitting, rather than waiting for the frame to return. This feature helps increase the total
bandwidth of the Token Ring.
The Token Ring Interface Processor (TRIP) on the Cisco 7500 series routers and the Token Ring adapters on
the Cisco 7200 series routers all support early token release.
Examples The following example enables the use of early token release on Token Ring interface 1:
Router(config)# interface tokenring 1
Router(config-if)# early-token-release
The following example enables the use of early token release on the Token Ring interface processor
in slot 4 on port 1 on the Cisco 7500 series routers:
Router(config)# interface tokenring 4/1
Router(config-if)# early-token-release
Cisco IOS Interface and Hardware Component Command Reference
346
D through E
efm-grp
efm-grp
The efm-grp command is used to perform the necessary link operations (add, delete, and shutdown) of a single
link after the creation of efm-bonding group. To perform the link operations in the efm-grp command, enter
the config-controller-dsl-group mode. Use the no form of the command to shut down the related command.
efm-grp [{add|delete|shutdown}] link link number
no efm-grp [{add|delete|shutdown}] link link number
Syntax Description link number Designates the pairs link number.
add Adds a link to the efm-bonding group.
delete Deletes a link from the efm-bonding group
shutdown Shuts down a link in the efm-bonding group.
Command Default No default behavior or values.
Command Modes Config-controller-dsl-group (config-controller-dsl-group)
Command History Release Modification
15.1(1)T This command was introduced.
Usage Guidelines This command is used to add, delete, or shutdown a link in the efm-bond.
Examples The following example shows how efm-grp command is used.
Router(config-controller-dsl-group)# efm-grp ?
add Add a link to the EFM Bonding group
delete Delete a link from the EFM Bonding group
shutdown Shutdown a link in the EFM Bonding group
Router(config-controller-dsl-group)# efm-grp add ?
link EFM Bonding group link configuration
Router(config-controller-dsl-group)# efm-grp add link ?
<0-3> Link pair number
Related Commands Command Description
controller shdsl Configures a controller for SHDSL mode and enters config-controller mode.
shdsl annex Defines the SHDSL G.991.2 standard.
shdsl rate Defines the SHDSL rate.
show controller shdsl Displays the status of the controller that is configured for SHDSL mode.
Cisco IOS Interface and Hardware Component Command Reference
347
D through E
eigrp interface
eigrp interface
Note Effective with Cisco IOS Release 15.0(1)M, the eigrp interfacecommand is replaced by the dampening-change
command and the dampening-interval command. See the dampening-change and
dampening-intervalcommands for more information.
To set a threshold value to minimize hysteresis in a router-to-radio configuration, use the eigrp interface
command in interface configuration mode. To reset the hysteresis threshold to the default value, use the no
form of this command.
eigrp vmi-interface-number interface [dampening-change value] [dampening-interval value]
no eigrp vmi-interface-number interface [dampening-change value] [dampening-interval value]
Syntax Description vmi-interface-number The number assigned to the VMI interface.
dampening-change value (Optional) Value used to minimize the effect of frequent routing changes in
router-to-radio configurations. Percent interface metric must change to cause
update. Value range is 1 to 100.
dampening-interval value (Optional) Specifies the time interval in seconds to check the interface metrics
at which advertising of routing changes occurs. The default value is 30
seconds. Value range is 1 to 65535.
Command Default Default for change-based dampening is 50 percent of the computed metric.
Default for interval-based dampening is 30 seconds.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.4(15)XF This command was introduced.
12.4(15)T This command was integrated into Cisco IOS Release 12.4(15)T.
15.0(1)M This command was replaced. This command was replaced by the dampening-changecommand
and the dampening-interval command.
Usage Guidelines This command advertises routing changes for EIGRP traffic only.
The REPLY sent to any QUERY will always contain the latest metric information. Exceptions which will
result in immediate UPDATE being sent:
• A down interface
• A down route
• Any change in metric which results in the router selecting a new next hop
Cisco IOS Interface and Hardware Component Command Reference
348
D through E
eigrp interface
Change-based Dampening
The default value for the change tolerance will be 50% of the computed metric. It can be configured in the
range from 0 to 100 percent. If the metric change of the interface is not greater (or less) than the current metric
plus or minus the specified amount, the change will not result in a routing change, and no update will be sent
to other adjacencies.
Interval-based Dampening
The default value for the update intervals is 30 seconds. It can be configured in the range from 0 to 64535
seconds. If this option is specified, changes in routes learned though this interface, or in the interface metrics,
will not be advertised to adjacencies until the specified interval is met. When the timer expires, any changes
detected in any routes learned through the interface, or the metric reported by the interfaces will be sent out.
Examples
Change-based Dampening Example
The following example sets the threshold to 50 percent tolerance routing updates involving VMI
interfaces and peers:
interface vmi1
ip address 10.2.2.1 255.255.255.0
ipv6 address 2001:0DB1:2::1/96
ipv6 enable
eigrp 1 interface dampening-change 50
physical-interface Ethernet0/0
Interval-based Dampening Example
The following example sets the interval to 30 seconds at which updates occur for topology changes
that affect VMI interfaces and peers:
interface vmi1
ip address 10.2.2.1 255.255.255.0
ipv6 address 2001:0DB1:2::1/96
ipv6 enable
eigrp 1 interface dampening-interval 30
physical-interface Ethernet0/0
Related Commands Command Description
debug vmi Displays debugging output for virtual multipoint interfaces (VMIs)
interface vmi Creates a virtual multipoint interface (VMI) that can be configured and applied dynamically.
Cisco IOS Interface and Hardware Component Command Reference
349
D through E
emulation-mode
emulation-mode
To configure Configuration Circuit Emulation (CEM), use the emulation-mode command in unidirectional
mode.
emulation-mode {bidirectional|unidirectional {rx|tx}}
no emulation-mode
Syntax Description rx When the CEM is in rx-only mode, there is no data transmitted by that CEM. The CEM status shows
“active (rx-only)”.
tx The CEM in tx-only mode does not receive any data. There is no data sent to the IP side and the received
data is silently dropped at the CEM. The CEM status shows “active (tx-only)”.
Command Default Default mode is unidirectional mode.
Command Modes Configuration CEM mode (emulation-mode).
Command History Release Modification
12.4(20)YA This command was introduced.
Usage Guidelines You can use the emulation-mode command to configure the CEM in unidirectional mode. Once configured,
traffic will flow only in that direction through the CEM channel. The CEM status will show as “active (rx-only)”
or “active (tx-only)” depending on the configuration. To disable the command's effect, use the no form of
this command.
Examples The following example shows how the command configures the traffic in unidirectional mode:
Router(config-cem
)# emulation-mode unidirectional tx
The following example shows how the command configures the traffic in bidirectional mode:
Router(config-cem
)# emulation-mode bidirectional
Cisco IOS Interface and Hardware Component Command Reference
350
D through E
encapsulation
encapsulation
To set the encapsulation method used by the interface, use the encapsulation command in interface
configuration mode. To remove the encapsulation, use the no form of this command.
encapsulation encapsulation-type
no encapsulation encapsulation-type
Syntax Description encapsulation-type Encapsulation type; one of the following keywords:
• atm-dxi -- ATM Mode-Data Exchange Interface.
• bstun --Block Serial Tunnel.
• dot1q vlan-id [native]--Enables IEEE 802.1q encapsulation of traffic on a specified
subinterface in VLANs. The vlan-id argument is a virtual LAN identifier. The valid
range is from 1 to 1000. The optional native keyword sets the PVID value of the
port to the vlan-id value.
• frame-relay --Frame Relay (for serial interface).
• hdlc -- High-Level Data Link Control (HDLC) protocol for serial interface. This
encapsulation method provides the synchronous framing and error detection functions
of HDLC without windowing or retransmission. This is the default for synchronous
serial interfaces.
• isl vlan-id --Inter-Switch Link (ISL) (for VLANs).
• lapb --X.25 Link Access Procedure, Balanced. Data link layer protocol (LAPB)
DTE operation (for serial interface).
• ppp -- PPP (for serial interface).
• sde said --IEEE 802.10. The said argument is a security association identifier. This
value is used as the VLAN identifier. The valid range is from 0 to 0xFFFFFFFE.
• sdlc --IBM serial Systems Network Architecture (SNA).
• sdlc-primary --IBM serial SNA (for primary serial interface) .
• sdlc-secondary --IBM serial SNA (for secondary serial interface).
• slip --Specifies Serial Line Internet Protocol (SLIP) encapsulation for an interface
configured for dedicated asynchronous mode or dial-on-demand routing (DDR).
This is the default for asynchronous interfaces.
• smds --Switched Multimegabit Data Services (SMDS) (for serial interface).
• ss7 --Sets the encapsulation type to SS7 and overrides the serial interface objects
high-level data link control (HDLC) default.
Command Default The default depends on the type of interface. For example, synchronous serial interfaces default to HDLC
and asynchronous interfaces default to SLIP.
Cisco IOS Interface and Hardware Component Command Reference
351
D through E
encapsulation
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
10.3 The sde keyword was added to support IEEE 802.10
11.1 The isl keyword was added to support the Interswitch Link (ISL) Cisco protocol
for interconnecting multiple switches and routers, and for defining virtual LAN
(VLAN) topologies.
11.3(4)T The tr-isltrbrf-vlan keyword was added to support TRISL, a Cisco proprietary
protocol for interconnecting multiple routers and switches and maintaining VLAN
information as traffic goes between switches.
12.0(1)T The dot1q keyword was added to support IEEE 8021q standard for encapsulation
of traffic on a specified subinterface in VLANs.
12.1(3)T The native keyword was added.
12.2(11)T This command was modified to include the ss7 keyword in support of integrated
signaling link terminal capabilities.
12.2(13)T Support for IPv6 was added.
12.3(2)T The tr-isltrbrf-vlan keyword was removed because support for the TRISL
protocol is no longer available in Cisco IOS software.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in
a specific 12.2SX release of this train depends on your feature set, platform, and
platform hardware.
Cisco IOS XE Release 2.5 This command was updated. It was integrated into Cisco IOS XE Release 2.5.
Usage Guidelines SLIP and PPP
To use SLIP or PPP, the router or access server must be configured with an IP routing protocol or with the
iphost-routing command. This configuration is done automatically if you are using old-style slipaddress
commands. However, you must configure it manually if you configure SLIP or PPP via the interfaceasync
command.
On lines configured for interactive use, encapsulation is selected by the user when they establish a connection
with the slip or ppp EXEC command.
IP Control Protocol (IPCP) is the part of PPP that brings up and configures IP links. After devices at both
ends of a connection communicate and bring up PPP, they bring up the control protocol for each network
protocol that they intend to run over the PPP link such as IP or IPX. If you have problems passing IP packets
and the showinterface command shows that line is up, usethenegotiations command to see if and where the
negotiations are failing. You might have different versions of software running, or different versions of PPP,
in which case you might need to upgrade your software or turn off PPP option negotiations. All IPCP options
Cisco IOS Interface and Hardware Component Command Reference
352
D through E
encapsulation
as listed in RFC 1332, PPP Internet Protocol Control Protocol (IPCP) , are supported on asynchronous lines.
Only Option 2, TCP/IP header compression, is supported on synchronous interfaces.
PPP echo requests are used as keepalive packets to detect line failure. The nokeepalive command can be used
to disable echo requests. For more information about the nokeepalive command, refer to the chapter “IP
Services Commands” in the CiscoIOSIPCommandReference,Volume1of4:AddressingandServicesand to
thechapter“Configuring IP Services” in the CiscoIOSIPConfigurationGuide.
To use SLIP or PPP, the Cisco IOS software must be configured with an IP routing protocol or with the
iphost-routing command. This configuration is done automatically if you are using old-style slipaddress
commands. However, you must configure it manually if you configure SLIP or PPP via the interfaceasync
command.
Note Disable software flow control on SLIP and PPP lines before using the encapsulation command.
SS7
The SS7 encapsulation command is new with the Integrated SLT feature and is available only for interface
serial objects created by the channel-group command. For network access server (NAS) platforms, the
encapsulation for channel group serial interface objects defaults to HDLC. You must explicitly set the
encapsulation type to SS7 to override this default.
When encapsulation is set to SS7, the encapsulation command for that object is no longer available. A serial
SS7 link is deleted only when its associated dial feature card (DFC) card is removed. As with existing Cisco
26xx-based SLTs, you do not need to specify whether the SS7 link is to be used as an A-link or an F-link.
By itself this command does not select the correct encapsulation type. Therefore, once created, you must set
the encapsulation type to the new SS7 value, as well as assign a session channel ID to the link at the serial
interface command level. The configuration on a digital SS7 link can be saved (no shutdown) only when its
encapsulation is successfully set to SS7 and it has been assigned a channel identifier.
VLANs
Do not configure encapsulation on the native VLAN of an IEEE 802.1q trunk without the native keyword.
(Always use the native keyword when the vlan-id is the ID of the IEEE 802.1q native VLAN.)
For detailed information on use of this command with VLANs, refer to the Cisco IOS Switching Services
Configuration Guide and the Cisco IOS Switching Services Command Reference .
Examples The following example shows how to reset HDLC serial encapsulation on serial interface 1:
Router(config)# interface serial 1
Router(config-if)# encapsulation hdlc
The following example shows how to enable PPP encapsulation on serial interface 0:
Router(config)# interface serial 0
Router(config-if)# encapsulation ppp
The following example shows how to configure async interface 1 for PPP encapsulation:
Router(config)# interface async 1
Router(config-if)# encapsulation ppp
Cisco IOS Interface and Hardware Component Command Reference
353
D through E
encapsulation
To learn more about the virtual serial interface and check SS7 encapsulation, enter the show interfaces
serial slot/trunk:channel-group command in privileged EXEC mode, as in the following example:
Router# show interfaces serial 7/3:1
Serial7/3:1 is up, line protocol is down
Hardware is PowerQUICC Serial
MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec,
reliability 255/255, txload 4/255, rxload 1/255
Encapsulation SS7 MTP2, loopback not set
Keepalive set (10 sec)
Last input never, output 00:00:00, output hang never
Last clearing of "show interface" counters 03:53:40
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 26000 bits/sec, 836 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
11580159 packets output, 46320636 bytes, 0 underruns
0 output errors, 0 collisions, 1 interface resets
0 output buffer failures, 0 output buffers swapped out
2 carrier transitions
DCD=up DSR=down DTR=down RTS=down CTS=down
Related Commands Command Description
channel-group Assigns a channel group and selects the DSO time slots desired for SS7 links.
encapsulation x25 Specifies operation of a serial interface as an X.25 device.
keepalive Sets the keepalive timer for a specific interface.
ppp Starts an asynchronous connection using PPP.
ppp authentication Enables CHAP or PAP or both and specifies the order in which CHAP and PAP
authentication are selected on the interface.
ppp bap call Sets PPP BACP call parameters.
slip Starts a serial connection to a remote host using SLIP.
Cisco IOS Interface and Hardware Component Command Reference
354
D through E
end (satellite initial configuration)
end (satellite initial configuration)
To exit satellite initial configuration mode, save any new or changed parameters, and reset the Cisco IP VSAT
satellite WAN network module (NM-1VSAT-GILAT), use the end command in satellite initial configuration
mode.
end
Syntax Description This command has no arguments or keywords.
Command Default No default behavior or values
Command Modes Satellite initial configuration
Command History Release Modification
12.3(14)T This command was introduced.
Usage Guidelines The end command is identical to the exit command in satellite initial configuration mode.
When you enter the exit or end command to exit satellite initial configuration mode, the system automatically
saves any changed parameters to the NM-1VSAT-GILAT network module nonvolatile memory and resets
the NM-1VSAT-GILAT network module.
Examples The following example shows what appears when you enter the end or exitcommand after changing
one or more initial configuration parameters:
Router(sat-init-config)# end
Applying changed parameters to the satellite module.
Parameter update succeeded. Module is now resetting.
Router#
The following example shows what appears when you enter the end or exit command when no
parameters have been changed:
Router(sat-init-config)# end
Router#
Related Commands Command Description
apply Saves new or changed satellite initial configuration parameters and resets
the Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT).
exit (satellite initial Exits satellite initial configuration mode, saves any new or changed
configuration) parameters, and resets the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT).
Cisco IOS Interface and Hardware Component Command Reference
355
D through E
equipment loopback
equipment loopback
To run loopbacks in conjunction with remote equipment, use the equipmentloopbackcommand in controller
configuration mode. To terminate the loopback, use the no form of this command.
equipment [{customer|network}] loopback
no equipment [{customer|network}] loopback
Syntax Description customer (Optional) Enables the line card to respond to remote T3 loopback commands from the remote
T3 equipment.
network (Optional) Causes the line card to ignore remote T3 loopback commands.
Command Default No default behavior or values.
Command Modes Controller configuration
Command History Release Modification
12.2S This command was introduced
Examples The following example configures an equipment network loopback:
Router(config
)
# controller t3 1/0/0
Router(config
-controller)
# equipment network loopback
Related Commands Command Description
loopback Enables controller loopbacks.
Cisco IOS Interface and Hardware Component Command Reference
356
D through E
errdisable detect cause
errdisable detect cause
To enable error-disable detection, use the errdisable detect cause command in global configuration mode.
To disable error-disable detection, use the no form of this command.
errdisable detect cause
{all|bpduguard|dtp-flap|l2ptguard|link-flap|packet-buffer-error|pagp-flap|rootguard|udld}
no errdisable detect cause {all|bpduguard|dtp-flap|l2ptguard|link-flap|pagp-flap|rootguard|udld}
Syntax Description all Specifies error-disable detection for all error-disable causes.
bpduguard Specifies detection for the Bridge Protocol Data Unit (BPDU)-guard error-disable
cause.
dtp-flap Specifies detection for the Dynamic Trunking Protocol (DTP)-flap error-disable
cause.
l2ptguard Specifies detection for the Layer 2 Protocol Tunneling guard error-disable cause.
link-flap Specifies detection for the link flap error-disable cause.
packet-buffer-error Causes the packet buffer error to error-disable the affected port.
pagp-flap Specifies detection for the Port Aggregation Protocol (PAgP)-flap error-disable
cause.
rootguard Specifies detection for the root-guard error-disable cause.
udld Specifies detection for the Unidirectional Link Detection (UDLD) error-disable
cause.
Command Default Error-disable detection is enabled for all causes.
Command Modes Global configuration (config)
Command History Release Modification
15.0(1)M This command was introduced in a release earlier than Cisco IOS Release 15.0(1)M.
12.2(14)SX This command was modified. Support was added for the Supervisor Engine 720.
12.2(17b)SXA This command was modified. The packet-buffer-error keyword was added.
12.2(17d)SXB This command was modified. Support for this command on the Supervisor Engine 2 was
extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Cisco IOS Interface and Hardware Component Command Reference
357
D through E
errdisable detect cause
Usage Guidelines
Note Entering the no errdisable detect cause packet-buffer-error command allows you to detect the fault that
triggers a power cycle of the affected module.
A cause (bpduguard, dtp-flap, link-flap, pagp-flap, root-guard, udld) is defined as the reason why the
error-disable state occurred. When a cause is detected on an interface, the interface is placed in an error-disable
state (an operational state that is similiar to the link-down state).
You must enter the shutdown and then the no shutdown commands to recover an interface manually from
the error-disable state.
Examples The following example shows how to enable error-disable detection for the Layer 2 protocol-tunnel
guard error-disable cause:
Router(config)#
errdisable detect cause l2ptguard
Related Commands Command Description
show errdisable detect Displays the error-disable detection status.
show interfaces status Displays the interface status or a list of interfaces in an error-disable state on LAN
ports only.
shutdown Disables an interface.
Cisco IOS Interface and Hardware Component Command Reference
358
D through E
errdisable recovery
errdisable recovery
To configure recovery mechanism variables, use the errdisable recovery command in global configuration
mode. To return to the default state, use the no form of this command.
errdisable recovery {cause
{all|arp-inspection|bpduguard|channel-misconfig|dhcp-rate-limit|dtp-flap|gbic-invalid|l2ptguard|link-flap|pagp-flap|psecure-violation|security-violation|rootguard|udld|unicast-flood}|interval
seconds}
no errdisable recovery {cause
{all|arp-inspection|bpduguard|channel-misconfig|dhcp-rate-limit|dtp-flap|gbic-invalid|l2ptguard|link-flap|pagp-flap|psecure-violation|security-violation|rootguard|udld|unicast-flood}|interval
seconds}
Syntax Description cause Enables error-disable recovery from a specific cause.
all Enables the recovery timers for all error-disable causes.
arp-inspection Enables error-disable recovery from an Address Resolution Protocol (ARP) inspection
cause.
bpduguard Enables the recovery timer for the Bridge Protocol Data Unit (BPDU)-guard
error-disable cause.
channel-misconfig Enables the recovery timer for the channel-misconfig error-disable cause.
dhcp-rate-limit Enables the recovery timer for the Dynamic Host Configuration Protocol
(DHCP)-rate-limit error-disable cause.
dtp-flap Enables the recovery timer for the Dynamic Trunking Protocol (DTP)-flap
error-disable cause.
gbic-invalid Enables the recovery timer for the Gigabit Interface Converter (GBIC)-invalid
error-disable cause.
l2ptguard Enables the recovery timer for the Layer 2 Protocol Tunneling (L2PT) error-disable
cause.
link-flap Enables the recovery timer for the link-flap error-disable cause.
pagp-flap Enables the recovery timer for the Port Aggregation Protocol (PAgP)-flap error-disable
cause.
psecure-violation Enables the recovery timer for the psecure-violation error-disable cause.
security-violation Enables the automatic recovery of ports that were disabled because of 802.1X security
violations.
rootguard Enables the recovery timer for the root-guard error-disable cause.
udld Enables the recovery timer for the Unidirectional Link Detection (UDLD) error-disable
cause.
unicast-flood Enables the recovery timer for the unicast-flood error-disable cause.
Cisco IOS Interface and Hardware Component Command Reference
359
D through E
errdisable recovery
interval seconds Specifies the time, in seconds, to recover from a specified error-disable cause. The
range is from 30 to 86400. The default interval is 300.
Command Default The recovery mechanisms are disabled.
Command Modes Global configuration (config)
Command History Release Modification
15.0(1)M This command was introduced in a release earlier than Cisco IOS Release 15.0(1)M.
12.2(14)SX This command was modified. This command was implemented on the Supervisor Engine
720.
12.2(17d)SXB This command was modified. This command was implemented on the Supervisor Engine
2.
12.2(18)SXD This command was modified. The arp-inspection keyword was added.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines A cause (bpduguard, channel-misconfig, dhcp-rate-limit, dtp-flap, l2ptguard, link-flap, pagp-flap,
psecure-violation, security-violation, rootguard, udld, or unicast-flood) is defined as the reason why the
error-disable state occurred. When a cause is detected on an interface, the interface is placed in an error-disable
state (an operational state that is similar to the link-down state). If you do not enable error-disable recovery
for the cause, the interface stays in the error-disable state until a shutdown and no shutdown occur. If you
enable recovery for a cause, the interface is brought out of the error-disable state and allowed to retry operation
once all the causes have timed out.
You must enter the shutdown command and then the no shutdown command to manually recover an interface
from the error-disable state.
Note A separate line is required each time you want to enter the errdisable recovery cause command to add a new
reason for recovery; each new reason does not get appended to the original single line. This means you must
enter each new reason separately.
Examples This example shows how to enable the recovery timer for the BPDU-guard error-disable cause:
Router(config)#
errdisable recovery cause bpduguard
This example shows how to set the recovery timer to 300 seconds:
Router(config)#
errdisable recovery interval 300
Cisco IOS Interface and Hardware Component Command Reference
360
D through E
errdisable recovery
Related Commands Command Description
show errdisable recovery Displays the information about the error-disable recovery timer.
show interfaces status Displays the interface status or a list of interfaces in an error-disabled state on
LAN ports only.
shutdown Disables an interface.
Cisco IOS Interface and Hardware Component Command Reference
361
D through E
error throttling
error throttling
To stop receiving error data packets on multiple channel groups configured on all interfaces on the T1 controller
of a channelized T3 port adapter or on the E1 controller of a channelized E3 port adapter, use the
errorthrottling command in controller configuration mode. To continue receiving error data packets on all
channels on the T1 or E1 controller, use the no form of this command.
error throttling
no error throttling
Syntax Description This command has no arguments or keywords.
Command Default The errorthrottling command is enabled by default on a T3 or a E3 port adapter.
Command Modes Controller configuration (config-controller)
Command History Release Modification
12.2(19c) This command was introduced.
15.0(1)M3 This command was modified. This command can be enabled on E1 controllers.
12.2(33)SRD5 This command was integrated into Cisco IOS Release 12.2(33)SRD5.
Usage Guidelines Use the showcontrollerst3 command or showcontrollerse3 command to display whether the current router
configuration has error throttling enabled or disabled.
The errorthrottling command disables the T1 or E1 level clock in order to stop receiving error data packets
on a T1 or E1 controller.
When a T1 or a E1 has multiple channel groups configured over it, error throttling affects all the channels on
a T1 or a E1. If any single interface receives a burst of errors, over a short duration, such as 400 errors in 100
milliseconds (ms), the T1 or E1 clock is turned off for a period of 100 ms. When there is a high rate of errors,
the error rate is likely to continue for a long duration of time. Using error throttling to stop receiving the error
data packets reduces wasteful processing and discarding of error packets.
The noerrorthrottling command allows all the error data packets to be processed, dropped, and accounted
for on a T1 or a E1 controller. When the error rate is high, the CPU can become overloaded.
When the noerrorthrottling command is used to configure a T3 or a E3 port, the configuration applies to all
of the 28 associated T1 or E1 channels.
Examples The following example enables error throttling by disabling the T1 clock in order to stop receiving
error data packets on a T1 controller:
Router(config-controller)# error throttling
The following example uses the showcontrollerst3 command to display partial output showing that
error throttling is enabled on the T1 controller:
Router# show controllers t3 2/1/0
Cisco IOS Interface and Hardware Component Command Reference
362
D through E
error throttling
T3 2/1/0 is down. Hardware is 2CT3 single wide port adapter
CT3 H/W Version: 0.2.2, CT3 ROM Version: 1.0, CT3 F/W Version: 2.5.1
FREEDM version: 1, reset 0 resurrect 0
Applique type is Channelized T3
Transmitter is sending remote alarm.
Receiver has loss of signal.
FEAC code received: No code is being received
Framing is M23, Line Code is B3ZS, Clock Source is Internal
Rx-error throttling on T1's ENABLED
.
The following example uses the showcontrollerse3 command to display partial output showing that
error throttling is enabled on the E1 controller:
Router# show controller e3 5/0
*Mar 14 21:19:06.795: %SYS-5-CONFIG_I: Configured from console by console
E3 5/0 is up.
CE3 H/W Version : 3.1.0, CE3 ROM Version : 1.1, CE3 F/W Version : 1.2.1
Applique type is Channelized E3
Total available channels 128, used 4
No alarms detected. Line Code is HDB3, Clock Source is Line.
Rx-error throttling on E1's ENABLED
Data in current interval (564 seconds elapsed):
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation
0 P-bit Err Secs, 0 P-bit Severely Err Secs
0 Severely Err Framing Secs, 0 Unavailable Secs
0 Line Errored Secs, 0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
E3 5/0 E1 1
No alarms detected.
Framing is crc4, Clock Source is line, National bits are 0x1F.
Data in current interval (565 seconds elapsed):
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavail Secs
E3 5/0 E1 2
No alarms detected.
Framing is crc4, Clock Source is line, National bits are 0x1F.
Related Commands Command Description
show controllers e3 Displays information about E3 links, and displays hardware and software driver
information for the E3 controller.
show controllers t3 Displays information about T3 links, and displays hardware and software driver
information for the T3 controller.
Cisco IOS Interface and Hardware Component Command Reference
363
D through E
esmc mode ql-disabled
esmc mode ql-disabled
To disable the Ethernet synchronization message channel (ESMC) on an interface, use the esmc mode
ql-disabledcommand in interface configuration mode. To remove the quality level (QL) disabled mode and
get back to the default ql-enabled mode, use the no form of this command.
esmc mode ql-disabled
no esmc mode ql-disabled
Syntax Description This command has no arguments or keywords.
Command Default The ESMC mode is ql-enabled.
Command Modes Interface configuration (config-if)
Command History Release Modification
15.0(1)S This command was introduced.
15.1(2) SNI This command was introduced in Cisco ASR 901 Aggregation Services Router.
Cisco IOS XE Release 3.8S This command was integrated into Cisco IOS XE Release 3.8S.
Usage Guidelines You can use the esmc modeql-disabled command only if a synchronous Ethernet (SyncE) capable interface
is installed on the device. When this command is used no QL ESMC packets are sent during network clock
synchronization.
Examples The following example shows how to enable ESMC process:
Device(config-if)# esmc mode ql-disabled
Related Commands Command Description
esmc process Enables the ESMC process in a device.
show esmc Displays the enabled ESMCs in a device.
show interfaces accounting Displays the number of packets of each protocol type that have been sent
through all configured interfaces.
Cisco IOS Interface and Hardware Component Command Reference
364
D through E
esmc process
esmc process
To enable the Ethernet synchronization message channel (ESMC) process in a router, use the esmc
processcommand in global configuration mode. To disable the process, use the no form of this command.
esmc process
no esmc process
Syntax Description This command has no arguments or keywords.
Command Default The ESMC process is disabled.
Command Modes Global configuration (config)
Command History Release Modification
15.0(1)S This command was introduced.
15.1(2) SNI This command was introduced in Cisco ASR 901 Aggregation Services Router.
Cisco IOS XE Release 3.8S This command was integrated into Cisco IOS XE Release 3.8S.
Usage Guidelines You can use the esmc process command only if a synchronous Ethernet (SyncE) capable interface is installed
on the device. ESMC is the communication channel for conveying clock information in SyncE. You can use
the ESMC process in a SyncE to synchronize the clock frequency over an Ethernet port.
Examples The following example shows how to enable ESMC process:
Device(config)# esmc process
Related Commands Command Description
esmc mode ql-disabled Disables the ESMC on an interface.
show esmc Displays the enabled ESMCs in a device.
show interfaces accounting Displays the number of packets of each protocol type that have been sent
through all configured interfaces.
Cisco IOS Interface and Hardware Component Command Reference
365
D through E
exit (satellite initial configuration)
exit (satellite initial configuration)
To exit satellite initial configuration mode, save any new or changed parameters, and reset the Cisco IP VSAT
satellite WAN network module (NM-1VSAT-GILAT), use the exit command in satellite initial configuration
mode.
exit
Syntax Description This command has no arguments or keywords.
Command Default No default behavior or values
Command Modes Satellite initial configuration
Command History Release Modification
12.3(14)T This command was introduced.
Usage Guidelines The exitcommand is identical to the end command in satellite initial configuration mode.
When you enter the exit or end command to exit satellite initial configuration mode, the system automatically
saves any changed parameters to the NM-1VSAT-GILAT network module nonvolatile memory and resets
the NM-1VSAT-GILAT network module.
Examples The following example shows what appears when you enter the exit or endcommand after changing
one or more initial configuration parameters:
Router(sat-init-config)# exit
Applying changed parameters to the satellite module.
Parameter update succeeded. Module is now resetting.
Router#
The following example shows what appears when you enter the exit or endcommand when no
parameters have been changed:
Router(sat-init-config)# exit
Router#
Related Commands Command Description
apply Saves new or changed satellite initial configuration parameters and resets
the Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT).
end (satellite initial Exits satellite initial configuration mode, saves any new or changed
configuration) parameters, and resets the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT).
Cisco IOS Interface and Hardware Component Command Reference
366
F through H
• fabric buffer-reserve, on page 370
• fabric clear-block, on page 372
• fabric error-recovery fabric-switchover (virtual switch), on page 373
• fabric lcd-banner, on page 374
• fabric required, on page 376
• fabric switching-mode allow, on page 378
• fabric switching-mode force bus-mode, on page 381
• fabric timer, on page 383
• facility-alarm, on page 384
• facility-alarm critical exceed-action shutdown, on page 386
• facility-alarm detect, on page 387
• fddi burst-count, on page 389
• fddi c-min, on page 390
• fddi cmt-signal-bits, on page 391
• fddi duplicate-address-check, on page 393
• fddi encapsulate, on page 394
• fddi frames-per-token, on page 396
• fddi smt-frames, on page 397
• fddi tb-min, on page 398
• fddi tl-min-time, on page 399
• fddi token-rotation-time, on page 400
• fddi t-out, on page 401
• fddi valid-transmission-time, on page 402
• fdl, on page 403
• flowcontrol, on page 405
• frame-relay, on page 407
• framing, on page 409
• framing (CEM), on page 411
• framing (E3 controller), on page 413
• framing (SONET), on page 415
• framing (T1 E1 controller), on page 416
• framing (T3 controller), on page 418
• framing (T3-E3 interface), on page 420
Cisco IOS Interface and Hardware Component Command Reference
367
F through H
• full-duplex, on page 422
• g709 disable, on page 425
• g709 fec, on page 426
• g709 odu report, on page 427
• g709 odu overhead tti, on page 429
• g709 odu threshold, on page 430
• g709 otu report, on page 432
• g709 otu threshold, on page 434
• g709 tti-processing enable, on page 436
• gnss, on page 437
• gtp, on page 438
• half-duplex, on page 440
• half-duplex controlled-carrier, on page 442
• half-duplex timer, on page 444
• history (interface), on page 446
• hold-queue, on page 449
• hssi external-loop-request, on page 452
• hssi internal-clock, on page 453
• hub, on page 454
• hw-module boot, on page 455
• hw-module energywise level, on page 457
• hw-module fan-tray version, on page 459
• hw-module interface als restart, on page 461
• hw-module main-cpu qa error-recovery, on page 462
• hw-module mode, on page 464
• hw-module oversubscription, on page 466
• hw-module power-supply power-cycle, on page 467
• hw-module pxf stall-monitoring, on page 468
• hw-module reset, on page 469
• hw-module sec-cpu reset, on page 470
• hw-module shutdown, on page 472
• hw-module simulate link-up, on page 473
• hw-module slot, on page 474
• hw-module slot (6500), on page 477
• hw-module slot (7300), on page 480
• hw-module slot (7600), on page 482
• hw-module slot (ASR 1000 Series), on page 485
• hw-module slot image, on page 488
• hw-module slot subslot only, on page 489
• hw-module standby, on page 491
• hw-module subslot, on page 493
• hw-module subslot (4400), on page 495
• hw-module subslot ethernet vlan unlimited, on page 497
• hw-module subslot (LAN WAN), on page 499
• hw-module subslot service-engine session, on page 501
• hw-module subslot session, on page 503
Cisco IOS Interface and Hardware Component Command Reference
368
F through H
• hw-module subslot shutdown, on page 504
• hw-module subslot shutdown (4400), on page 506
Cisco IOS Interface and Hardware Component Command Reference
369
F through H
fabric buffer-reserve
fabric buffer-reserve
To reserve ASIC buffers, use the fabricbuffer-reserve command. in global configuration mode. To return
to the default settings, use the no form of this command.
fabric buffer-reserve [{high|low|mediumvalue}]
[default] fabric buffer-reserve queue
no fabric buffer-reserve
Syntax Description high (Optional) Reserves the high (0x5050) ASIC buffer spaces.
low (Optional) Reserves the low (0x3030) ASIC buffer spaces.
medium (Optional) Reserves the medium (0x4040) ASIC buffer spaces.
value (Optional) 16-bit value; valid values are from 0x0 to 0x5050.
default (Optional) Specifies the default queue setting.
queue Specifies the queue setting for the buffer reserve.
Command Default The default settings are as follows:
• Buffer reserve is set to 0x0.
• Two queues.
Command Modes Global configuration
Command History Release Modification
12.2(18)SXE Support for this command was introduced on the Supervisor Engine 720.
12.2(18)SXF This command was changed to add the queue keyword.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
Note Use this command only under the direction of Cisco TAC.
This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine
32.
The fabricbuffer-reservequeuecommand is supported on Cisco 7600 series routers that are configured with
the following modules:
• WS-X6748-GE-TX
• WS-X6724-SFP
Cisco IOS Interface and Hardware Component Command Reference
370
F through H
fabric buffer-reserve
• WS-X6748-SFP
• WS-X6704-10GE
Entering the defaultfabricbuffer-reservequeue command is the same as entering the
fabricbuffer-reservequeue command.
You can enter the fabricbuffer-reserve command to improve the system throughput by reserving ASIC
buffers.
This command is supported on the following modules:
• WS-X6704-10GE
• WS-X6748-SFP
• WS-X6748-GE-TX
• WS-X6724-SFP
Examples This example shows how to reserve the high (0x5050) ASIC buffer spaces:
Router(config)# fabric buffer-reserve high
Router(config)#
This example shows how to reserve the low (0x3030) ASIC buffer spaces:
Router(config)# fabric buffer-reserve low
Router(config)#
Cisco IOS Interface and Hardware Component Command Reference
371
F through H
fabric clear-block
fabric clear-block
To enable the clear-block congestion control for the fabric channels, use the fabricclear-block command in
global configuration mode. To disable the clear-block congestion control for the fabric channels, use the no
form of this command.
fabric clear-block
no fabric clear-block
Syntax Description This command has no arguments or keywords.
Command Default Disabled
Command Modes Global configuration
Command History Release Modification
12.2(17d)SXB1 Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
Note Do not enter the fabricclear-blockcommand unless TAC advises you to do so.
This command is supported only with Supervisor Engine 720 hardware revision 4.0 and later releases.
This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine
32.
Examples This example shows how to enable the clear-block congestion control for the fabric channels:
Router(config)# fabric clear-block
Router(config)#
This example shows how to disable the clear-block congestion control for the fabric channels:
Router(config)# no fabric clear-block
Router(config)#
Cisco IOS Interface and Hardware Component Command Reference
372
F through H
fabric error-recovery fabric-switchover (virtual switch)
fabric error-recovery fabric-switchover (virtual switch)
To enable a supervisor engine switchover when excessive fabric synchronization errors are detected on the
fabric-enabled module, use the fabricerror-recoveryfabric-switchover command in global configuration
mode. To disable the supervisor engine switchover for excessive fabric synchronization errors, use the no
form of this command.
fabric switch num error-recovery fabric-switchover
no fabric switch num error-recovery fabric-switchover
Syntax Description switch num Specifies the switch number; valid values are 1 and 2.
Command Default Excessive fabric synchronization errors initiate a supervisor engine switchover, and the configuration is not
saved to the configuration file.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SXH1 Support for this command was introduced.
Usage Guidelines When a fabric-capable switching module has fabric errors, a supervisor engine switchover is initiated.
You can use the nofabricerror-recoveryfabric-switchover command to avoid the supervisor engine
switchover. This command does not perform the supervisor engine switchover but powers down the module
that is experiencing the excessive fabric errors. This command is saved to the configuration file.
Examples The following example shows how to enable a supervisor engine switchover when excessive fabric
synchronization errors are detected on the fabric-enabled module:
Router(config)# fabric switch 2 error-recovery fabric-switchover
Router(config)#
The following example shows how to disable a supervisor engine switchover when excessive fabric
synchronization errors are detected on the fabric-enabled module:
Router(config)# no fabric switch 2 error-recovery fabric-switchover
Router(config)#
Related Commands Command Description
show fabric Displays the information about the crossbar fabric .
Cisco IOS Interface and Hardware Component Command Reference
373
F through H
fabric lcd-banner
fabric lcd-banner
To specify the message-of-the-day (MOTD) banner for display on the Switch Fabric Module, use the
fabriclcd-banner command in global configuration mode. To delete the MOTD banner, use the no form of
this command.
fabric lcd-banner d message d
no fabric lcd-banner
Syntax Description d Delimiting character; see the “Usage Guidelines” section for additional guidelines.
message Message text; see the “Usage Guidelines” section for additional guidelines.
Command Default No MOTD banner is specified.
Command Modes Global configuration
Command History Release Modification
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2 only.
This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 32
You cannot use the delimiting character in the banner message. The delimiter is a character of your choice--a
pound sign (#), for example.
You can replace tokens with the corresponding configuration argument.
Follow this command with one or more blank spaces and a delimiting character of your choice. Then enter
one or more lines of text, terminating the message with the second occurrence of the delimiting character.
This MOTD banner is useful for displaying messages that affect all users (such as impending system
shutdowns).
When you connect to the router, the MOTD banner appears before the login prompt. After you successfully
log in to the router, the EXEC banner or incoming banner is displayed, depending on the type of connection.
For a reverse Telnet login, the incoming banner is displayed. For all other connections, the router displays
the EXEC banner.
To customize the banner, use tokens in the form $(token) in the message text. Tokens display current Cisco
IOS configuration arguments, such as the router’s hostname and IP address.
The table below describes the command tokens.
Table 14: Command Tokens
Token Information Displayed in the Banner
$(hostname) Displays the router’s hostname.
Cisco IOS Interface and Hardware Component Command Reference
374
F through H
fabric lcd-banner
$(domain) Displays the router’s domain name.
$(line) Displays the VTY or TTY (async) line number.
$(line-desc) Displays the description that is attached to the line.
Examples This example shows how to set a MOTD banner for display on the Switch Fabric Module LCD
display; the pound sign (#) is used as a delimiting character:
Router(config)# fabric lcd-banner#
Building power will be off from 7:00 AM until 9:00 AM this coming Tuesday.
#
This example shows how to set a MOTD banner; the percent sign (%) is used as a delimiting character:
Router(config)# fabric lcd-banner%
Enter TEXT message. End with the character '%'.
You have entered $(hostname).$(domain) on line $(line) ($(line-desc)) %
When the MOTD banner is executed, you see the following (notice that the $(token) syntax is replaced
by the corresponding configuration argument):
You have entered company.ourdomain.com on line 5 (Dialin Modem)
Related Commands Command Description
banner exec Specifies and enables a message to be displayed when an EXEC process is created.
banner incoming Defines and enables a banner to be displayed when there is an incoming connection to
a terminal line from a host on the network.
banner login Defines and enables a customized banner to be displayed before the username and
password login prompts.
banner slip-ppp Allows customization of the banner that is displayed when a SLIP or PPP connection
is made.
exec-banner Reenables the display of EXEC and MOTD banners on the specified line or lines.
motd-banner Enables the display of MOTD banners on the specified line or lines.
Cisco IOS Interface and Hardware Component Command Reference
375
F through H
fabric required
fabric required
To prevent the Cisco 7600 series routers from coming online without a Switch Fabric Module, use the
fabricrequiredcommand in global configuration mode. To allow the Cisco 7600 series routers to come up
without a Switch Fabric Module, use the no form of this command.
fabric required
no fabric required
Syntax Description This command has no arguments or keywords.
Command Default A Switch Fabric Module is not required.
Command Modes Global configuration
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine
32.
If you enter the fabricrequired command, when you remove or power down the last Switch Fabric Module,
all modules except the supervisor engine, power down. When you insert or power on the first Switch Fabric
Module, the modules that were previously powered down power up if the Switch Fabric Module configuration
is not in conflict with other configurations.
If you enter the nofabricrequired command, the modules will also power on if a Switch Fabric Module is
not present and the configuration allows for it.
Examples This example shows how to prevent the Cisco 7600 series routers from coming online without a
Switch Fabric Module:
Router(config)#
fabric required
Router(config)#
This example shows how to allow the Cisco 7600 series routers to come up without a Switch Fabric
Module:
Router(config)#
no fabric required
Router(config)#
Cisco IOS Interface and Hardware Component Command Reference
376
F through H
fabric required
Related Commands Command Description
show fabric Displays the information about the crossbar fabric.
Cisco IOS Interface and Hardware Component Command Reference
377
F through H
fabric switching-mode allow
fabric switching-mode allow
To enable various switching modes in the presence of two or more fabric-enabled switching modules, use the
fabricswitching-modeallow command in global configuration mode. To disable the settings, use the no form
of this command.
fabric switching-mode allow {bus-mode|dcef-only|truncated [threshold [mod]]}
no fabric switching-mode allow {bus-mode|truncated [threshold]}
Syntax Description bus-mode Specifies a module to run in bus mode.
dcef-only Allows switching in distributed Cisco Express Forwarding (dCEF)-only mode.
truncated Specifies a module to run in truncated mode.
threshold mod (Optional) Specifies the number of fabric-enabled modules for truncated switching mode;
see the “Usage Guidelines” section for additional information.
Command Default The truncated mode is disabled.
Command Modes Global configuration (config)
Command History Release Modification
12.2(14)SX This command was introduced on the Supervisor Engine 720.
12.2(17d)SXB This command was modified. This command supports the Supervisor Engine 2.
12.2(18)SXD1 This command was modified. The dcef-only keyword was added on the Supervisor Engine
2.
12.2(18)SXE This command was modified. Support for OIR performance enhancement and the dcef-only
keyword was added on the Supervisor Engine 720.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SXH This command was modified. This command was introduced on the Supervisor Engine
720-10GE.
Usage Guidelines This command is not supported on Catalyst 6500 or Cisco 7600 series routers that are configured with a
Supervisor Engine 32.
Ethernet ports are not disabled when this command is entered on a Supervisor Engine 720-10GE. This command
is also supported with Supervisor Engine 720 starting with Release 12.2(33)SXI2. However, prior to Release
12.2(33)SXI2, if all the installed switching modules have Distributed Forwarding Cards (DFCs), enter the
fabricswitching-modeallowdcef-only command to disable the Ethernet ports on both supervisor engines.
Entering this command ensures that all modules are operating in dCEF-only mode and simplifies switchover
to the redundant supervisor engine.
With a Supervisor Engine 2 and Release 12.2(18)SXD1 and later releases, if all the installed switching modules
have DFCs, enter the fabricswitching-modeallowdcef-only command to disable the Ethernet ports on the
Cisco IOS Interface and Hardware Component Command Reference
378
F through H
fabric switching-mode allow
redundant supervisor engine. Entering this command ensures that all modules are operating in dCEF-only
mode.
Note The fabricswitching-modeallowdcef-only command is accepted only in stateful switchover (SSO) redundancy
mode.
Bus mode--Supervisor engines use this mode for traffic between nonfabric-enabled modules and for traffic
between a nonfabric-enabled module and a fabric-enabled module. In this mode, all traffic passes between
the local bus and the supervisor engine bus.
dCEF-only--Supervisor engines, both active and redundant, operate as nonfabric-capable modules with their
uplink ports relying on the Policy Feature Card (PFC) on the active supervisor engine for all forwarding
decisions. For the Supervisor 720-10G, the uplink ports on both the active and standby routers will remain
active. If all other modules are operating in dCEF-only mode, module Online Insertion and Removal (OIR)
is nondisruptive.
Note The system message “PSTBY-2-CHUNKPARTIAL: Attempted to destroy partially full chunk, chunk
0xB263638, chunk name: MET FREE POOL” is displayed on the Supervisor Engine if both the
fabricswitching-modeallowdcef-only and ipv6mfibhardware-switchinguplink commands are configured.
The router will ignore the command configured last.
Truncated mode--Supervisor engines use this mode for traffic between fabric-enabled modules when there
are both fabric-enabled and nonfabric-enabled modules installed. In this mode, line cards send a truncated
version of the traffic (the first 64 bytes of the frame) over the Catalyst bus.
Compact mode--Supervisor engines use this mode for all traffic when only fabric-enabled modules are installed.
In this mode, a compact version of the Desktop Bus (DBus) header is forwarded over the Catalyst bus, which
provides the best possible centralized forwarding performance.
A fabric-enabled module has an additional connection directly to the switch fabric. Fabric-enabled modules
forward packets in compressed mode, where only the header is sent to the Supervisor Engine and the full
packet is forwarded directly from one line card to another.
To prevent use of nonfabric-enabled modules or to prevent fabric-enabled modules from using bus mode,
enter the nofabricswitching-modeallowbus-mode command.
Caution Entering the nofabricswitching-modeallowbus-mode command removes power from any nonfabric-enabled
modules that are installed.
The fabricswitching-modeallow c ommand affects Supervisor engines that are configured with a minimum
of two fabric-enabled modules.
You can enter the fabricswitching-modeallowtruncated command to unconditionally allow truncated mode.
You can enter the nofabricswitching-modeallowtruncated command to allow truncated mode if the threshold
is met.
You can enter the nofabricswitching-modeallowbus-modecommand to prevent any module from running
in bus mode.
Cisco IOS Interface and Hardware Component Command Reference
379
F through H
fabric switching-mode allow
To return to the default truncated-mode threshold, enter the nofabricswitching-modeallowtruncatedthreshold
command.
The valid value for modis the threshold value.
Examples The following example shows how to specify truncated mode:
Router(config)#
fabric switching-mode allow truncated
Related Commands Command Description
ipv6 mfib hardware-switching uplink Configures MFIB hardware switching for IPv6 multicast packets
on a global basis.
show fabric Displays the information about the crossbar fabric.
Cisco IOS Interface and Hardware Component Command Reference
380
F through H
fabric switching-mode force bus-mode
fabric switching-mode force bus-mode
To force fabric-enabled modules into bus switching mode, use thefabricswitching-modeforcebus-mode
command in global configuration mode. To power cycle the module to truncated mode, use the no form of
this command.
fabric switching-mode force bus-mode
no fabric switching-mode force bus-mode
Syntax Description This command has no arguments or keywords.
Command Default This command has no default settings.
Command Modes Global configuration
Command History Release Modification
12.2(18)SXD5 Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine
32.
This command applies to the following modules:
• WS-SVC-FWM-1-K9--Firewall Services Module
• WS-SVC-IDS2-BUN-K9--Intrusion Detection Service Module 2
• WS-SVC-MWAM-1--Multiprocessor WAN Application Module
• WS-SVC-NAM-1--Network Analysis Module 1
• WS-SVC-NAM-2--Network Analysis Module 2
• WS-SVC-PSD-1--Persistent Storage Device Module
• WS-SVC-SSL-1-K9--SSL Module
• WS-SVC-WLAN-1-K9--Wireless LAN Service Module
After you enter the fabricswitching-modeforcebusmode or the
nofabricswitching-modeforcebusmodecommand, the fabric-enabled service modules power cycle immediately.
The mode change occurs as the modules come up after the power cycle.
Examples This example shows how to force fabric-enabled modules into flow-through switching mode:
Router(config)#
fabric switching-mode force bus-mode
Router(config)#
Cisco IOS Interface and Hardware Component Command Reference
381
F through H
fabric switching-mode force bus-mode
Related Commands Command Description
show fabric Displays the information about the crossbar fabric.
Cisco IOS Interface and Hardware Component Command Reference
382
F through H
fabric timer
fabric timer
To set the drop counter time-stamp and peak-utilization poll time in seconds, use the fabrictimercommand
in global configuration mode. To remove the drop counter time-stamp and peak-utilization poll time, use the
no form of this command.
fabric timer seconds
no fabric timer seconds
Syntax Description seconds Poll time in seconds for drop counter time-stamps and peak-utilization. Valid values are from 1
to 1800.
Command Default The internal default timer is set to 15 seconds.
Command Modes Global configuration (config)
Command History Release Modification
12.2(14)SXF This command was introduced on the Catalyst 6500 series switch.
12.2(5)SRB This command was implemented on the Supervisor Engine 720.
Examples The following example shows how to set the drop counter time-stamp and peak-utilization poll time
to 200 seconds:
Router(config)#
fabric timer 200
Related Commands Command Description
show fabric Displays the information about the crossbar fabric.
Cisco IOS Interface and Hardware Component Command Reference
383
F through H
facility-alarm
facility-alarm
To configure threshold temperatures for minor, major, and critical alarms, use the facility-alarm command
in global configuration mode. To disable alarms for the threshold and reset the threshold to the default value,
use the no form of this command.
Cisco 10000 Series Router
facility-alarm {core-temperature|outlet-temperature} {major|minor|critical} [temperature]
no facility-alarm {core-temperature|outlet-temperature} {major|minor|critical} [temperature]
Cisco 7200 Series Router
facility-alarm {core-temperature|intake-temperature} temperature
Syntax Description core-temperature Specifies that the alarm applies to the temperature of the internal core of the router.
The temperature sensor close to the router’s processor measures the core temperature.
outlet-temperature Specifies that the alarm applies to the air flow temperature.
Note This keyword is valid only on the Cisco 10000 series router for the PRE3.
major [temperature Specifies the alarm threshold temperature threshold in degrees C. The default value
is 53 degrees C.
Major alarms affect several subscribers that connect to the reporting node.
minor [temperature Specifies the alarm threshold temperature threshold in degrees C. The default value
is 45 degrees C.
Minor alarms affect a single or small number of subscribers who connect to the
reporting node.
critical [temperature Specifies the alarm threshold temperature threshold in degrees C. The default value
is 85 Celsius C.
Critical alarms affect most or all subscribers that connect to the reporting node.
temperature Temperature threshold in degrees C. The range is 30 to 70 degrees C.
Command Default If the command is not enabled, the default values are set.
Command Modes Global configuration (config)
Command History Release Modification
12.0(17)SL This command was introduced on the Cisco 10000 series router.
12.2(16)BX This command was introduced on the PRE2.
12.2(31)SB2 This command was introduced on the PRE3 for the Cisco 10000 series router.
15.0(1)M This command was integrated into a release earlier than Cisco IOS Release 15.0(1)M.
Cisco IOS Interface and Hardware Component Command Reference
384
F through H
facility-alarm
Usage Guidelines You can configure explicit threshold temperatures to override the defaults for major, minor, and critical alarms.
Temperature thresholds for each alarm type and location are automatically set based on determined values
that vary depending on the number and type of boards inserted in the chassis. In addition to the automatically
set thresholds, you can set thresholds for minor and major temperature alarms. You can also disable the minor
and major temperature alarms. You cannot, however, change the threshold for or disable critical alarms.
Cisco 10000 Series Router
On the PRE2, use the facility-alarmcore-temperature command. On the PRE3, use the
facility-alarmoutlet-temperature command.
The default value for a threshold temperature depends on the performance routing engine (PRE) installed in
the router as the following describes:
• Major alarm
• PRE2--The default value is 53.
• PRE3--The default value is 58.
• Minor alarm
• PRE2--The default value is 45.
• PRE3--The default value is 50.
• Critical alarm
• PRE2--The default value is 85.
• PRE3--The default value is 85.
Examples The following example sets a threshold temperature of 53 for major alarms on the PRE2:
Router> enable
Router# config terminal
Router(config)# facility-alarm core-temperature major 53
The following example sets a threshold temperature of 50 for minor alarms on the PRE3:
Router> enable
Router# config terminal
Router(config)# facility-alarm core-temperature minor 50
Related Commands Command Description
clear facility-alarm Clears alarm conditions and resets the alarm contacts.
show facility-alarm status Displays the current major, minor, and critical alarm status, if any, and displays
the configuration of the alarm thresholds.
Cisco IOS Interface and Hardware Component Command Reference
385
F through H
facility-alarm critical exceed-action shutdown
facility-alarm critical exceed-action shutdown
To allow automatic router shutdown, use the facility-alarm critical exceed-action shutdown command in global
configuration mode. To disable automatic router shutdown, use the no form of this command.
facility-alarm critical exceed-action shutdown
no facility-alarm critical exceed-action shutdown
Syntax Description This command has no arguments or keywords.
Command Default Automatic router shutdown is not enabled.
Command Modes Global configuration (config)
Command History Release Modification
Cisco IOS XE Release 2.1 This command was introduced on the Cisco ASR 1000 Series Routers.
Usage Guidelines If the facility-alarm critical exceed-action shutdown command is enabled, the router performs an automatic
shutdown under the following conditions:
• The internal temperature of the router or a power supply exceeds the temperature threshold.
• The voltage of an AC or DC power supply is out of tolerance.
Examples The following example enables automatic router shutdown:
Router(config)# facility-alarm critical exceed-action shutdown
Related Commands Command Description
show facility-alarm Displays the status of a generated alarm.
Cisco IOS Interface and Hardware Component Command Reference
386
F through H
facility-alarm detect
facility-alarm detect
To turn on the facility alarms, use the facility-alarmdetect command in global configuration mode. To turn
off the alarm, use the no form of this command.
facility-alarm detect {controller controller slot-number|interface type number|rps|temperature|fan}
no facility-alarm detect {controller T1 slot-number|interface type number|rps|temperature|fan}
Syntax Description controller Specifies the facility alarm for controllers.
controller slot-number Specifies the controller. The controller can be one of the following:
• E1 --The range of the slot value is from 1 to 7 and the range of the port is
from 0 to 7.
• T1 --The range of the slot value is from 1 to 7 and the range of the port is
from 0 to 7.
• T3 --The range of the slot value is from 1 to 7.
interface Specifies the facility alarm for interfaces.
type Interface type. For more information, use the question mark (?) online help function.
number Interface or subinterface number. For more information about the numbering syntax
for your networking device, use the question mark (?) online help function.
rps Specifies the facility alarm for the redundant power supply (RPS).
temperature Specifies the facility alarm for the environmental monitor temperature.
fan Specifies the facility alarm for the environmental monitor fans.
Command Default The facility alarm is turned off.
Command Modes Global configuration (config)
Command History Release Modification
15.0(1)M This command was introduced in a release earlier than Cisco IOS Release 15.0(1)M on the Cisco
5400-XM series routers.
Usage Guidelines Facility alarms monitor the following failure events:
• CT1/CE1/CT3 controller down
• Interface down
• RPS failure
• Trunk card failure
Cisco IOS Interface and Hardware Component Command Reference
387
F through H
facility-alarm detect
Cisco IOS software polls every second to detect the failure events that you have configured and turns on the
alarm when any one of the failure events is detected. By default, the facility alarm is off. Users have to
configure a facility alarm command to enable monitoring of the failure conditions.
Examples The following example shows how to turn on the facility alarm for RPS:
Router(config)# facility-alarm detect rps
Related Commands Command Description
show facility-alarm Displays the status of a generated alarm.
Cisco IOS Interface and Hardware Component Command Reference
388
F through H
fddi burst-count
fddi burst-count
To allow the FCI card to preallocate buffers to handle bursty FDDI traffic (for example, Network File System
[NFS] bursty traffic), use the fddiburst-count command in interface configuration mode. To revert to the
default value, use the no form of this command.
fddi burst-count number
no fddi burst-count
Syntax Description number Number of preallocated buffers in the range from 1 to 10. The default is 3.
Command Default 3 buffers
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command applies to the FCI card only.
Note The microcode software version should not be 128.45 or 128.43.
Examples The following example sets the number of buffers to 5:
Router(config)# interface fddi 0
Router(config-if)# fddi burst-count 5
Cisco IOS Interface and Hardware Component Command Reference
389
F through H
fddi c-min
fddi c-min
To set the C-Min timer on the pulse code modulation (PCM), use the fddic-min command in interface
configuration mode. To revert to the default value, use the no form of this command.
fddi c-min microseconds
no fddi c-min
Syntax Description microseconds Sets the timer value, in microseconds. The default is 1600.
Command Default 1600 microseconds
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command applies to the processor connection management (CMT) only. You need extensive knowledge
of the PCM state machine to tune this timer. Use this command when you run into PCM interoperability
problems.
Examples The following example sets the C-Min timer to 2000 microseconds:
Router(config)# interface fddi 0
Router(config-if)# fddi c-min 2000
Related Commands Command Description
fddi tb-min Sets the TB-Min timer in the PCM.
fddi tl-min-time Controls the TL-Min time (the minimum time to transmit a PHY line state before advancing
to the PCM state, as defined by the X3T9.5 specification).
fddi t-out Sets the t-out timer in the PCM.
Cisco IOS Interface and Hardware Component Command Reference
390
F through H
fddi cmt-signal-bits
fddi cmt-signal-bits
To control the information transmitted during the connection management (CMT) signaling phase, use the
fddicmt-signal-bitscommand in interface configuration mode.
fddi cmt-signal-bits signal-bits [{phy-a|phy-b}]
Syntax Description signal-bits A hexadecimal number preceded by 0x; for example, 0x208. The FDDI standard defines 10
bits of signaling information that must be transmitted, as follows:
• bit 0--Escape bit. Reserved for future assignment by the FDDI standards committee.
• bits 1 and 2--Physical type, as defined in the first table below.
• bit 3--Physical compatibility. Set if topology rules include the connection of a
physical-to-physical type at the end of the connection.
• bits 4 and 5--Link confidence test duration; set as defined in the second table below.
• bit 6--MAC available for link confidence test.
• bit 7--Link confidence test failed. The setting of bit 7 indicates that the link confidence
was failed by the Cisco end of the connection.
• bit 8--MAC for local loop.
• bit 9--MAC on physical output.
phy-a (Optional) Selects Physical Sublayer A. The default is 0x008 (hexadecimal) or 00 0000 1000
(binary). Bits 1 and 2 are set to 00 to select Physical A. Bit 3 is set to 1 to indicate “accept any
connection.”
phy-b (Optional) Selects Physical Sublayer B. The default is 0x20c (hexadecimal) or 10 0000 1100
(binary). Bits 1 and 2 are set to 10 to select Physical B. Bit 3 is set to 1 to indicate “accept any
connection.” Bit 9 is set to 1 to select MAC on output. The normal data flow on FDDI is input
on Physical A and output on Physical B.
Command Default • phy-a is set to 0x008 (hexadecimal) or 00 0000 1000 (binary). Bits 1 and 2 are set to 00 to select Physical
A. Bit 3 is set to 1 to indicate “accept any connection.”
• phy-b is set to 0x20c (hexadecimal) or 10 0000 1100 (binary). Bits 1 and 2 are set to 10 to select Physical
B. Bit 3 is set to 1 to indicate “accept any connection.” Bit 9 is set to 1 to select MAC on output. The
normal data flow on FDDI is input on Physical A and output on Physical B.
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Cisco IOS Interface and Hardware Component Command Reference
391
F through H
fddi cmt-signal-bits
Usage Guidelines If neither the phy-a nor phy-b keyword is specified, the signal bits apply to both physical connections.
Caution Use of the fddicmt-signal-bits configuration command is not recommended under normal operations. This
command is used when debugging specific CMT implementation issues.
The table below lists the physical types.
Table 15: FDDI Physical Type Bit Specifications
Bit Bit Physical Type
2 1
0 0 Physical A
1 0 Physical B
0 1 Physical S
1 1 Physical M
The table below lists the duration bits.
Table 16: FDDI Link Confidence Test Duration Bit Specification
Bit Bit Test Duration
5 4
0 0 Short test (default 50 milliseconds)
1 0 Medium test (default 500 milliseconds)
0 1 Long test (default 5 seconds)
1 1 Extended test (default 50 seconds)
This command does not have a no form.
Examples The following example sets the CMT signaling phase to signal bits 0x208 on both physical
connections:
Router(config)# interface fddi 0
Router(config-if)# fddi cmt-signal-bits 0x208
Cisco IOS Interface and Hardware Component Command Reference
392
F through H
fddi duplicate-address-check
fddi duplicate-address-check
To enable the duplicate address detection capability on the FDDI interface, use the fddiduplicate-address-check
command in interface configuration mode. To disable this function, use the no form of this command.
fddi duplicate-address-check
no fddi duplicate-address-check
Syntax Description This command has no arguments or keywords.
Command Default Disabled
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines If you use this command, the Cisco IOS software will detect a duplicate address if multiple stations are sharing
the same MAC address. If the software finds a duplicate address, it will shut down the interface.
Examples The following example enables duplicate address checking on the FDDI interface:
Router(config)# interface fddi 0
Router(config-if)# fddi duplicate-address-check
Cisco IOS Interface and Hardware Component Command Reference
393
F through H
fddi encapsulate
fddi encapsulate
To specify encapsulating bridge mode on the CSC-C2/FCIT interface card, use the fddiencapsulate command
in interface configuration mode. To turn off encapsulation bridging and return the FCIT interface to its
translational, nonencapsulating mode, use the noform of this command.
fddi encapsulate
no fddi encapsulate
Syntax Description This command has no arguments or keywords.
Command Default By default, the FDDI interface uses the SNAP encapsulation format defined in RFC 1042, Standard for the
Transmission of IP Datagrams Over IEEE 802 Networks . It is not necessary to define an encapsulation method
for this interface when using the CSC-FCI interface card.
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The nofddiencapsulate command applies only to CSC-C2/FCIT interfaces, because the CSC-FCI interfaces
are always in encapsulating bridge mode. The CSC-C2/FCIT interface card fully supports transparent and
translational bridging for the following configurations:
• FDDI to FDDI
• FDDI to Ethernet
• FDDI to Token Ring
The fddiencapsulate command puts the CSC-C2/FCIT interface into encapsulation mode when doing bridging.
In transparent mode, the FCIT interface interoperates with earlier versions of the CSC-FCI encapsulating
interfaces when performing bridging functions on the same ring.
Caution Bridging between dissimilar media presents several problems that can prevent communications from occurring.
These problems include bit-order translation (or usage of MAC addresses as data), maximum transfer unit
(MTU) differences, frame status differences, and multicast address usage. Some or all of these problems might
be present in a multimedia bridged LAN and might prevent communication from taking place. These problems
are most prevalent when bridging between Token Rings and Ethernets or between Token Rings and FDDI
nets. This is because of the different way Token Ring is implemented by the end nodes.
The following protocols have problems when bridged between Token Ring and other media: Novell IPX,
DECnet Phase IV, AppleTalk, VINES, XNS, and IP. Furthermore, the following protocols may have problems
when bridged between FDDI and other media: Novell IPX and XNS. We recommend that these protocols be
routed whenever possible.
Cisco IOS Interface and Hardware Component Command Reference
394
F through H
fddi encapsulate
Examples The following example sets FDDI interface 1 on the CSC-C2/FCIT interface card to encapsulating
bridge mode:
Router(config)# interface fddi 1
Router(config-if)# fddi encapsulate
Cisco IOS Interface and Hardware Component Command Reference
395
F through H
fddi frames-per-token
fddi frames-per-token
To specify the maximum number of frames that the FDDI interface transmits per token capture, use the
fddiframes-per-token command in interface configuration mode. To revert to the default value, use the no
form of this command.
fddi frames-per-token number
no fddi frames-per-token
Syntax Description number Maximum number of frames to transmit per token capture. Valid values are from 1 to 10. The
default is 3.
Command Default 3 frames
Command Modes Interface configuration
Command History Release Modification
11.2 P This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines Changing the value will increase or decrease the maximum number of frames that the FDDI interface can
transmit when it receives a token. Increasing the value does not necessarily mean more frames will be
transmitted on each token capture. This is heavily dependent on the traffic load of the specific interface.
When the interface captures a token, it transmits all of the frames that are queued in the interface’s transmit
ring, up to a maximum value specified by thefddiframes-per-token command.
If there are no frames ready for transmission, the token is passed on, and no frames are transmitted. If there
are less than the fddiframes-per-tokenvaluein the transmit ring, all frames in the transmit ring are transmitted
before the token is passed on. If there are more than the fddiframes-per-tokenvalue in the transmit ring, the
specified value is transmitted before the token is passed on. The remaining frames in the transmit ring remain
queued until the token is captured again.
Examples The following example shows how to configure the FDDI interface to transmit four frames per token
capture:
Router(config-if)# fddi frames-per-token 4
Cisco IOS Interface and Hardware Component Command Reference
396
F through H
fddi smt-frames
fddi smt-frames
To enable the Station Management (SMT) frame processing capability on the FDDI, use the fddismt-frames
command in interface configuration mode. To disable this function and prevent the Cisco IOS software from
generating or responding to SMT frames, use the no form of this command.
fddi smt-frames
no fddi smt-frames
Syntax Description This command has no arguments or keywords.
Command Default Enabled
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines Use the no form of this command to turn off SMT frame processing for diagnosing purposes. Use the
fddismt-frames command to reenable the feature.
Examples The following example disables SMT frame processing:
Router(config)# interface fddi 0
Router(config-if)# no fddi smt-frames
Cisco IOS Interface and Hardware Component Command Reference
397
F through H
fddi tb-min
fddi tb-min
To set the TB-Min timer in the physical connection management (PCM), use the fdditb-min command in
interface configuration mode. To revert to the default value, use the no form of this command.
fddi tb-min milliseconds
no fddi tb-min
Syntax Description milliseconds Number, in milliseconds, that sets the TB-Min timer value. The range is from 0 to 65535.
The default is 100.
Command Default milliseconds : 100
Command Modes Interface configuration
Command History Release Modification
10.3 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command applies to the processor connection management (CMT) only. Use this command when you
run into PCM interoperability problems.
Note You need extensive knowledge of the PCM state machine to tune this timer.
Examples The following example shows how to set the TB-Min timer to 200 ms:
Router(config)# interface fddi 0
Router(config-if)# fddi tb-min 200
Related Commands Command Description
fddi c-min Sets the C-Min timer on the PCM.
fddi tl-min-time Controls the TL-Min time (the minimum time to transmit a PHY line state before advancing
to the PCM state, as defined by the X3T9.5 specification).
fddi t-out Sets the t-out timer in the PCM.
Cisco IOS Interface and Hardware Component Command Reference
398
F through H
fddi tl-min-time
fddi tl-min-time
To control the TL-Min time (the minimum time to transmit a Physical Sublayer, or PHY line state, before
advancing to the next physical connection management [PCM] state, as defined by the X3T9.5 specification),
use the fdditl-min-time command in interface configuration mode.
fddi tl-min-time microseconds
Syntax Description microseconds Number, in microseconds, that specifies the time used during the connection management
(CMT) phase to ensure that signals are maintained for at least the value of TL-Min so that
the remote station can acquire the signal. The range is from 0 to 4294967295. The default
is 30.
Command Default microseconds : 30
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines Interoperability tests have shown that some implementations of the FDDI standard need more than 30
microseconds to sense a signal.
This command does not have a no form.
Examples The following example changes the TL-Min time from 30 microseconds to 100 microseconds:
Router(config)# interface fddi 0
Router(config-if)# fddi tl-min-time 100
The following example changes the TL-Min time from 30 microseconds to 100 microseconds on a
Cisco 7500 series router:
Router(config)# interface fddi 3/0
Router(config-if)# fddi tl-min-time 100
Related Commands Command Description
fddi c-min Sets the C-Min timer on the PCM.
fddi t-out Sets the t-out timer in the PCM.
Cisco IOS Interface and Hardware Component Command Reference
399
F through H
fddi token-rotation-time
fddi token-rotation-time
To control ring scheduling during normal operation and to detect and recover from serious ring error situations,
use the fdditoken-rotation-time command in interface configuration mode. To revert to the default value,
use the no form of this command.
fddi token-rotation-time microseconds
no fddi token-rotation-time
Syntax Description microseconds Number, in microseconds, that specifies the token rotation time (TRT). The range is from
4000 to 165000. The default is 5000.
Command Default microseconds : 5000
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The FDDI standard restricts the allowed time to be greater than 4000 microseconds and less than 165,000
microseconds. As defined in the X3T9.5 specification, the value remaining in the TRT is loaded into the token
holding timer (THT). Combining the values of these two timers provides the means to determine the amount
of bandwidth available for subsequent transmissions.
Examples The following example sets the rotation time to 24,000 microseconds:
Router(config)# interface fddi 0
Router(config-if)# fddi token-rotation-time 24000
The following example sets the rotation time to 24,000 microseconds on a Cisco 7500 series router:
Router(config)# interface fddi 3/0
Router(config-if)# fddi token-rotation-time 24000
Cisco IOS Interface and Hardware Component Command Reference
400
F through H
fddi t-out
fddi t-out
To set the timeout timer in the physical connection management (PCM), use the fddit-out command in
interface configuration mode. To revert to the default value, use the no form of this command.
fddi t-out milliseconds
no fddi t-out
Syntax Description milliseconds Number, in milliseconds, that sets the timeout timer. The range is from 0 to 65535. The default
is 100.
Command Default milliseconds : 100
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command applies to the processor connection management (CMT) only. Use this command when you
run into PCM interoperability problems.
Note You need extensive knowledge of the PCM state machine to tune this timer.
Examples The following example sets the timeout timer to 200 ms:
Router(config)# interface fddi 0
Router(config-if)# fddi t-out 200
Related Commands Command Description
fddi c-min Sets the C-Min timer on the PCM.
fddi tb-min Sets the TB-Min timer in the PCM.
fddi tl-min-time Controls the TL-Min time (the minimum time to transmit a PHY line state before
advancing to the PCM state, as defined by the X3T9.5 specification).
Cisco IOS Interface and Hardware Component Command Reference
401
F through H
fddi valid-transmission-time
fddi valid-transmission-time
To change the transmission valid timer (TVX) interval, use thefddivalid-transmission-time command in
interface configuration mode. To revert to the default value, use the no form of this command.
fddi valid-transmission-time microseconds fddi valid-transmission-time command
no fddi valid-transmission-time
Syntax Description microseconds Number, in microseconds, that specifies the TVX interval. The range is from 2500 to
2147483647. The default is 2500.
Command Default microseconds : 2500
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use this command to recover from a transient FDDI ring error by setting a longer transmission timer interval.
Examples The following example shows how to change the transmission timer interval to 3000 microseconds:
Router(config)# interface fddi 0
Router(config-if)# fddi valid-transmission-time 3000
The following example shows how to change the transmission timer interval to 3000 microseconds
on Cisco 7000 series routers or Cisco 7200 series routers:
Router(config)# interface fddi 3/0
Router(config-if)# fddi valid-transmission-time 3000
Cisco IOS Interface and Hardware Component Command Reference
402
F through H
fdl
fdl
To set the Facility Data Link (FDL) exchange standard for CSU controllers or to set the FDL exchange standard
for a T1 interface that uses the Extended Super Frame (ESF) framing format, use the fdl command in interface
configuration mode. To disable FDL support or to specify that there is no ESF FDL, use the no form of this
command.
Cisco 2600 Series and Cisco 3600 Series Routers
fdl {att|ansi|all|none}
no fdl {att|ansi|all|none}
Cisco 10000 Series Router
fdl {att|ansi}
no fdl {att|ansi}
Syntax Description att Specifies AT&T technical reference 54016 for ESF FDL exchange support.
ansi Specifies ANSI T1.403 for ESF FDL exchange support.
all Specifies both AT&T technical reference 54016 and ANSI T1.403 for ESF FDL exchange support.
none Specifies that there is no support for ESF FDL exchange.
Command Default ANSI T1.403 for ESF FDL exchange support
Command Modes
Interface configuration
Command History Release Modification
11.3 This command was introduced.
12.0(5)XK The none keyword was added, and the both keyword was changed to all.
12.0(5)T The none keyword was added, and the both keyword was changed to all.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB This command was integrated into Cisco IOS Release 12.2(31)SB.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command is available only for T1 links. This command sets the standard to be followed for FDL messaging
through a 4-kbps out-of-band channel that a service provider uses to check for errors on the facility.
You must use the same FDL exchange standard as your service provider. If the setting is not correct, the link
might not come up. You can configure a different standard on each T1 interface.
Cisco IOS Interface and Hardware Component Command Reference
403
F through H
fdl
Note When using a multiport T1 ATM IMA network module on a Cisco 2600 series or Cisco 3600 series router,
ESF framing and binary eight zero substitution (B8ZS) line encoding are supported. When using a multiport
E1 ATM IMA network module on a Cisco 2600 series or Cisco 3600 series router, CRC4 multiframe framing
and HDB3 line encoding are supported. These are the parameters specified by the ATM Forum, and they
cannot be changed.
Examples
Cisco 2600 and Cisco 3600 Series Routers
The following example shows how to specify the ANSI standard and the AT&T standard for FDL
exchange:
Router(config)# interface atm 0/2
Router(config-if)# fdl all
Cisco 10000 Series Router
The following example shows how to specify the AT&T standard for FDL exchange:
Router(config)# interface atm 1/0/0
Router(config-if)# fdl att
Cisco IOS Interface and Hardware Component Command Reference
404
F through H
flowcontrol
flowcontrol
To configure a port to send or receive pause frames, use the flowcontrol command in interface configuration
mode. To return to the default settings, use the no form of this command.
flowcontrol {send|receive} {desired|off|on}
no flowcontrol {send|receive} {desired|off|on}
Syntax Description send Specifies that a port sends pause frames.
receive Specifies that a port processes pause frames.
desired Obtains predictable results regardless of whether a remote port is set to on, off, or desired.
off Prevents a local port from receiving and processing pause frames from remote ports or from
sending pause frames to remote ports.
on Enables a local port to receive and process pause frames from remote ports or send pause frames
to remote ports.
Command Default Flow control is disabled.
Flow-control defaults depend upon port speed. The defaults are as follows:
• Gigabit Ethernet ports default to off for receive and desired for send.
• Fast Ethernet ports default to off for receive and on for send.
• On the 24-port 100BASE-FX and 48-port 10/100 BASE-TX RJ-45 modules, the default is off for receive
and off for send.
• You cannot configure how WS-X6502-10GE 10-Gigabit Ethernet ports respond to pause frames.
WS-X6502-10GE 10-Gigabit Ethernet ports are permanently configured to respond to pause frames.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(14)SX This command was introduced on the Supervisor Engine 720.
12.2(17d)SXB This command was implemented on the Supervisor Engine 2.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB.
Usage Guidelines The send and desired keywords are supported on Gigabit Ethernet ports only.
Pause frames are special packets that signal a source to stop sending frames for a specific period of time
because the buffers are full.
Cisco IOS Interface and Hardware Component Command Reference
405
F through H
flowcontrol
Gigabit Ethernet ports on the Catalyst 6500 series switches and on the Cisco 7600 series routers use flow
control to inhibit the transmission of packets to the port for a period of time; other Ethernet ports use flow
control to respond to flow-control requests.
If a Gigabit Ethernet port receive buffer becomes full, the port transmits a “pause” packet that tells remote
ports to delay sending more packets for a specified period of time. All Ethernet ports (1000 Mbps, 100 Mbps,
and 10 Mbps) can receive and act upon “pause” packets from other devices.
You can configure non-Gigabit Ethernet ports to ignore received pause frames (disable) or to react to them
(enable).
When used with the receivekeyword, the on and desired keywords have the same result.
All the Gigabit Ethernet ports on the Catalyst 6500 series switches and the Cisco 7600 series routers can
receive and process pause frames from remote devices.
To obtain predictable results, follow these guidelines:
• Use sendon only when remote ports are set to receiveon or receivedesired.
• Use sendoff only when remote ports are set to receiveoff or receivedesired.
• Use receiveon only when remote ports are set to sendon or senddesired.
• Use sendoff only when remote ports are set to receiveoff or receivedesired.
Examples These examples show how to configure the local port to not support any level of flow control by the
remote port:
Router# configure terminal
Router(config)# interface GigabitEthernet1/9 10.4.9.157 255.255.255.0
Router(config-if)# flowcontrol receive off
Router(config-if)# flowcontrol send off
Related Commands Command Description
show interfaces flowcontrol Displays flow-control information.
Cisco IOS Interface and Hardware Component Command Reference
406
F through H
frame-relay
frame-relay
To configure Frame Relay payload compression for each Frame Relay port, use the frame-relaycommand in
interface configuration mode. To terminate this form of payload compression over Frame Relay, use the no
form of this command.
frame-relay payload-compression frf9 stac caim [element-number]
no frame-relay payload-compression
Syntax Description payload-compression Packet-by-packet payload compression, using the Stacker method.
frf9 stac Enables FRF.9 compression using the Stacker method.
If the router contains a data compression Advanced Interface Module (AIM) for
the Cisco 2600 series router, compression is performed in the hardware (hardware
compression).
If the compression Advanced Interface Module (CAIM) is not available,
compression is performed in the software installed on the main processor of the
router (software compression).
caim element-number Enable the data compression AIM hardware compression daughtercard to do
compression, at the element numbered beginning with 0 and incrementing to
include all possible elements.
Command Default Disabled
Command Modes Interface configuration
Command History Release Modification
12.0(2)T This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use the frame-relaypayload-compression command to enable or disable payload compression on a
point-to-point interface or subinterface. Use the frame-relaymap command to enable or disable payload
compression on a multipoint interface or subinterface.
Shut down the interface before changing encapsulation types. Although this is not required, shutting down
the interface ensures the interface is reset for the new encapsulation.
Examples The following example shows Frame Relay configured to use payload compression with the frf9
stac algorithm for CAIM hardware compression, using the installed data compression AIM
daughtercard as the compression source:
Router(config-if)# frame-relay payload-compression frf9 stac caim 0
Cisco IOS Interface and Hardware Component Command Reference
407
F through H
frame-relay
Related Commands Command Description
compress stac caim Specifies the exact hardware compression resource preferred.
encapsulation frame-relay Enables Frame Relay encapsulation.
frame-relay interface-dlci Assigns a DLCI to a specified Frame Relay subinterface on the router or
access server.
frame-relay map Defines mapping between a destination protocol address and the DLCI used
to connect to the destination address.
show compress Displays compression statistics.
Cisco IOS Interface and Hardware Component Command Reference
408
F through H
framing
framing
To select the frame type for the T1 or E1 data line, use the framing command in controller configuration
mode.
T1 Lines
framing commandframing {sfadm|esfadm}
E1 Lines
framing {crc4adm|pcm30adm|clear e1}
Syntax Description sfadm Specifies super frame for the T1 channel.
esfadm Specifies extended super frame for the T1 channel.
crc4adm Specifies CRC4 framing mode for the E1 channel.
pcm30adm Specifies CRC4 disabled framing mode for the E1 channel.
clear e1 Specifies clear-e1 framing mode for the E1 channel.
Command Default Extended super frame (esf) for a T1 line CRC4 disabled framing (pcm30adm) for an E1 line
Command Modes Controller configuration
Command History Release Modification
11.3 This command was introduced.
12.0(5)XE The command was enhanced as an ATM interface configuration command.
12.0(7)XE1 This command was implemented on the Cisco 7100 series routers.
12.0(11)S This command was integrated into Cisco IOS Release 12.0(11)S.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use this command in configurations in which the router or access server is intended to communicate with T1
or E1 fractional data lines. The service provided determines which framing type is required for your T1 or
E1 circuit.
This command does not have a no form.
Examples The following example selects extended super frame as the T1 frame type:
Cisco IOS Interface and Hardware Component Command Reference
409
F through H
framing
Router(config)# controller t1 4/0
Router(config-controller)# framing esfadm
Related Commands Command Description
lbo Specifies the distance of the cable from the routers to the network equipment.
linecode Selects the line code type for a T1 or E1 line.
Cisco IOS Interface and Hardware Component Command Reference
410
F through H
framing (CEM)
framing (CEM)
To specify the framing format of a circuit emulation (CEM) T1 or E1 port, use the framing command in
controller configuration mode. To reset the framing format of the port to its default value, use the no form of
this command.
T1 Port
framing {sf|esf|unframed}
no framing
E1 Port
framing {crc4|no-crc4|unframed}
no framing
Syntax Description sf Specifies that the T1 port framing format is set to super frame (SF) format, also commonly known
as D4 framing format.
esf Specifies that the T1 port framing format is set to extended super frame (ESF) format. This is the
default for a T1 line.
crc4 Specifies that the E1 port framing format is set to the G.704 standard with the optional CRC4
mechanism defined in time slot 0 enabled. This is the default for a E1 line.
For Cisco NCS 4200 Series, crc4 is the default framing mode for E1 interface module.
no-crc4 Specifies that the E1 port framing format is set to the G.704 standard with the optional CRC4
mechanism defined in time slot 0 disabled.
unframed Specifies that no framing structure is sought (on the ingress data stream) or imposed (on the egress
data stream) on the T1 or E1 port.
For Cisco NCS 4200 Series, unframed is the default framing mode for T1 interface module.
Command Default The framing format of a T1 line defaults to esf. The framing format of an E1 line defaults to crc4. If an
unframed CEM channel is created on the port using the cem-group command, no framing structure is sought
or imposed.
Command Modes Controller configuration
Command History Release Modification
12.3(7)T This command was introduced to support circuit emulation.
XE 3.18SP This command was integrated in the Cisco NCS 4200 Series.
XE Everest This command was integrated in the Cisco NCS 4200 Series and Cisco ASR 903 Series
16.5.1 Router.
Usage Guidelines Framing must be configured to match the framing format used by the attached equipment.
Cisco IOS Interface and Hardware Component Command Reference
411
F through H
framing (CEM)
In order to change a line between unframed and any framed mode, you must first delete the CEM channels
defined in the line.
Examples The following example shows how to set the framing format of a CEM T1 port to be super frame
format.
Router(config-controller)# framing
sf
The following example shows how to set the framing format of a CEM E1 port to the G.704 standard
with the optional CRC4 mechanism defined in time slot 0 disabled.
Router(config-controller)# framing no-crc4
Examples The following example shows how to set the framing format of a CEM T1 port for Cisco NCS 4200
Series.
Router(config-controller)# framingunframed
Examples The following example shows how to set the framing format of a CEM E1 port for Cisco NCS 4200
Series and Cisco ASR 903 Series Router.
Router(config-controller)# framingcrc4
Related Commands Command Description
cem-group Creates CEM channels on T1 or E1 ports.
Cisco IOS Interface and Hardware Component Command Reference
412
F through H
framing (E3 controller)
framing (E3 controller)
To specify the type of framing used by the E3 controller, use the framingcommand in controller configuration
mode. To restore the default framing type, use the no form of this command.
framing {bypass|g751}
no framing
Syntax Description bypass Specifies that G.751 framing be bypassed.
g751 Specifies G.751 as the E3 framing type. This is the default.
Command Default G.751 framing
Command Modes Controller configuration
Command History Release Modification
11.1 CA This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and implemented on the
following platforms for E3: Cisco 2650XM, Cisco 2651XM, Cisco 2691, Cisco 3660 series,
Cisco 3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines If you do not specify the framing command, the default, g751, is used by the E3 controller to automatically
determine the framing type received from the far-end equipment.
Configure framing as G.751 when the E3 connection terminates remotely on a Digital Link or Kentrox data
service unit (DSU), or when needing a subrate on an E3 connection between two T3 or E3 network modules.
Note The local interface configuration must match the remote interface, or DSU, configuration.
When G.751 framing is used, DSU bandwidth can be used to select a payload subrate from 34,010 kbps down
to 22 kbps.
When framing bypass is used, DSU bandwidth of 34,010 kbps must be configured.
When G.751 framing is used, configuring the scramble command can prevent some payload data from being
mistakenly interpreted as G.751 framing bits by switches placed between the DSUs. By default, the no scramble
command is configured.
When framing bypass is used, the no scramble command must be configured.
Cisco IOS Interface and Hardware Component Command Reference
413
F through H
framing (E3 controller)
When G.751 framing is used, bit 11 of the G.751 frame is reserved for national use and is set to 1 by default.
Configure national bit 1 only when required for interoperability with your telephone company.
Examples The following example shows the framing for the E3 controller set to bypass:
Router(config)# controller e3 1/0
Router(config-controller)# framing bypass
Related Commands Command Description
scramble Specifies the type of framing used by the T1 channels on the CT3IP in Cisco 7500 series routers.
Cisco IOS Interface and Hardware Component Command Reference
414
F through H
framing (SONET)
framing (SONET)
To select the frame type of the frame received on an optical line, use the framingcommand in controller
configuration mode.
framing {sonet|sdh}
Syntax Description sonet Specifies the framing type as SONET.
sdh Specifies the framing type as Synchronous Digital Hierarchy (SDH).
Command Default SONET is the default for the PA-MC-STM-1 port adapter. SDH is the default for the STM-1 trunk card.
Command Modes Controller configuration
Command History Release Modification
12.0(14)S This command was introduced.
12.2(14)S This command was integrated into Cisco IOS Release 12.2(14)S.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T and support was added
for the STM-1 trunk card on the Cisco AS5850 platform.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
XE Everest This command was introduced on the Cisco ASR 920 Routers and Cisco NCS 4200 Series.
16.5.1
Usage Guidelines Use this command to configure the framing type of the SONET controller. The PA-MC-STM-1 port adapter
supports both the SONET and SDH framing modes. The STM-1 trunk feature card on the Cisco AS5850
supports only SDH framing.
This command does not have a no form.
Examples The following example shows how to configure the framing type on a SONET controller of an STM-1
card in physical slot number 2 on a Cisco AS5850:
Router(config)# controller sonet 2/0
Router(config-controller)# framing sonet
Related Commands Command Description
show controllers sonet Displays information about SONET controllers.
Cisco IOS Interface and Hardware Component Command Reference
415
F through H
framing (T1 E1 controller)
framing (T1 E1 controller)
To select the frame type for the T1 or E1 data line, use the framing command in controller configuration
mode. To return to the default, use the no form of the command.
T1 Lines
framing {sf|esf}
E1 Lines
framing {crc4|no-crc4} [australia]
T1 Shared Port Adapter
framing {sf|esf}
no framing {sf|esf}
E1 Shared Port Adapter
framing {crc4|no-crc4|unframed}
no framing {crc4|no-crc4|unframed}
Syntax Description sf Specifies super frame as the T1 frame type. This is the default.
esf Specifies extended super frame as the T1 frame type.
crc4 Specifies CRC4 as the E1 frame type. This is the default for Australia.
no-crc4 Specifies CRC4 disabled as the E1 frame type.
unframed Specifies unframed mode.
australia (Optional) Specifies the E1 frame type used in Australia.
Command Default sf on a T1 line
crc4 on an E1 line
Command Modes Controller configuration
Command History 12.2S This command was integrated into Cisco IOS Release 12.2S.
12.2(25)S3 This command was integrated into Cisco IOS Release 12.2(25)S3.
12.2(18)SXE This command was integrated into Cisco IOS Release 12.2(18)SXE to support SPAs on a
Cisco 7600 series router and Catalyst 6500 series switch.
12.0(31)S This command was integrated into Cisco IOS Release 12.0(31)S.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
15.1(2)SNH This command was implemented on the Cisco ASR 901 Series Aggregation Services Routers.
Cisco IOS Interface and Hardware Component Command Reference
416
F through H
framing (T1 E1 controller)
Usage Guidelines Use this command in configurations in which the router or access server is intended to communicate with T1
or E1 fractional data lines. The service provider determines the framing type required for your T1/E1 circuit.
To return to the default mode on a T1/E1 SPA, use the no form of this command. This command does not
have a no form for other T1/E1 lines.
Examples The following example selects extended super frame as the T1 frame type:
Router(config-controller)# framing esf
Related Commands Command Description
cablelength Specifies the distance of the cable from the routers to the network equipment.
linecode Selects the linecode type for T1 or E1 line.
Cisco IOS Interface and Hardware Component Command Reference
417
F through H
framing (T3 controller)
framing (T3 controller)
To choose framing mode on a T3 port, use the framingcommand in controller configuration mode. To return
to the default mode, use the no form of this command.
T3 Controllers
framing {c-bit|m23}
no framing
Channelized T3 Shared Port Adapters and the Cisco 7500 Series Routers with CT3IP Port Adapter
framing {c-bit|m23|auto-detect}
no framing
Syntax Description auto-detect Specifies detection of the framing type that it receives from the far-end equipment.
c-bit Specifies that C-bit framing is used as the T3 framing type.
m23 Specifies that M23 framing is used as the T3 framing type.
Command Default c-bit (for the 2-Port and 4-Port Channelized T3 SPA and most T3 controllers)
auto-detect (for the CT3IP in a Cisco 7500 series router)
Command Modes Controller configuration
Command History Release Modification
11.1CA This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and implemented on the
following platforms for T3: Cisco 2650XM, Cisco 2651XM, Cisco 2691, Cisco 3660 series,
Cisco 3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
12.2S This command was integrated into Cisco IOS Release 12.2S.
12.2(25)S3 This command was integrated into Cisco IOS Release 12.2(25)S3 to support SPAs on the
Cisco 7304 routers.
12.2(18)SXE This command was integrated into Cisco IOS Release 12.2(18)SXE to support SPAs on a
Cisco 7600 series router or Catalyst 6500 series switch.
12.0(31)S This command was integrated into Cisco IOS Release 12.0(31)S to support SPAs on the Cisco
12000 series routers.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines You can set the framing for each T1 channel by using the t1framingcontroller configuration command.
Cisco 7500 Series Routers with CT3IP Port Adapter
Cisco IOS Interface and Hardware Component Command Reference
418
F through H
framing (T3 controller)
Because the CT3IP supports the Application Identification Channel (AIC) signal, the setting for the framing
might be overridden by the CT3IP firmware.
Examples The following example sets the framing mode on a T3 interface.
Router# configure terminal
Router(config)# controller t1 6/0/0
Router(config-controller)# framing m23
The following example sets the framing for the CT3IP to C-bit:
Router(config)# controller t3 9/0/0
Router(config-controller)# framing c-bit
Related Commands Command Description
controller Configures a T1, E1, or T3 controller and enters controller configuration mode.
show controller Displays controller configuration.
t1 framing Specifies the type of framing used by the T1 channels.
Cisco IOS Interface and Hardware Component Command Reference
419
F through H
framing (T3-E3 interface)
framing (T3-E3 interface)
To choose framing mode on a T3 or E3 port, use the framingcommand in interface configuration mode. To
return to the default mode, use the no form of this command.
PA-T3 and T3 Shared Port Adapters
framing {bypass|c-bit|m13}
no framing {bypass|c-bit|m13}
PA-E3 and E3 Shared Port Adapters
framing {bypass|g751|g832}
no framing {bypass|g751|g832}
Syntax Description bypass Bypasses DS3 framing mode.
c-bit Enables DS3 C-bit framing mode.
m13 Enables DS3 M13 framing mode.
g751 Enables E3 G.751 framing mode.
g832 Enables E3 G.832 framing mode. The g832 keyword is not supported on Cisco 7304 routers with
the 4-Port Clear Channel T3/E3 SPA.
Command Default T3: C-bit framing
E3: g751 framing
Command Modes Interface configuration
Command History Release Modification
11.1 This command was introduced.
12.2S This command was integrated into Cisco IOS Release 12.2S.
12.2(25)S3 This command was integrated into Cisco IOS Release 12.2(25)S3 to support SPAs on the
Cisco 7304 routers.
12.2(18)SXE This command was integrated into Cisco IOS Release 12.2(18)SXE to support SPAs on a
Cisco 7600 series router and Catalyst 6500 series switch. The g832 keyword option was added
to the command.
12.0(31)S This command was integrated into Cisco IOS Release 12.0(31)S to support SPAs on the Cisco
12000 series routers.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The default framing is described in the ITU-T Recommendation G.751.
Cisco IOS Interface and Hardware Component Command Reference
420
F through H
framing (T3-E3 interface)
Note The International Telecommunication Union Telecommunication Standardization Sector (ITU-T) carries out
the functions of the former Consultative Committee for International Telegraph and Telephone (CCITT).
When the framing mode is bypass, the T3 frame data is not included in the T3 frame, just the data.
When the framing mode is bypass, the E3 frame data is not included in the E3 frame, just the data.
If you use the bypass keyword, scrambling must be set to the default (disabled), the DSU mode must be set
to the default (0), and the DSU bandwidth must be set to the default (44736).
The g832 keyword is not supported on Cisco 7304 routers with the 2-Port and 4-Port Clear Channel T3/E3
SPA.
Examples The following example sets the framing mode to bypass on interface 1/0/0:
Router(config)# interface serial 1/0/0
Router(config-if)# framing bypass
Related Commands Command Description
show controller serial Displays serial line statistics.
Cisco IOS Interface and Hardware Component Command Reference
421
F through H
full-duplex
full-duplex
To specify full-duplex mode on full-duplex single-mode and multimode port adapters, use the
full-duplexcommand in interface configuration mode. To restore the default half-duplex mode, use the no
form of this command.
full-duplex
no full-duplex
Syntax Description This command has no arguments or keywords.
Command Default Half-duplex; a Fast Ethernet Interface Processor (FEIP), and serial interfaces that are configured for
bisynchronous tunneling
Autonegotiation
Command Modes Interface configuration
Command History Release Modification
11.1 This command was introduced.
11.3 This command was modified to include information on FDDI full-duplex, single-mode, and
multimode port adapters.
12.2(31)SB This command was integrated into Cisco IOS Release 12.2(31)SB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use this command if the equipment on the other end is capable of full-duplex mode.
This command specifies full-duplex mode on full-duplex single-mode and multimode port adapters available
on the following networking devices:
• Cisco 7200 series routers
• Second-generation Versatile Interface Processors (VIP2s) in Cisco 7500 series routers
• FEIP ports
• Serial interface ports that uses bisynchronous tunneling
Refer to the CiscoProductCatalog for hardware compatibility information and for specific model numbers of
port adapters.
To enable half-duplex mode, use the nofull-duplex or half-duplex command.
Cisco IOS Interface and Hardware Component Command Reference
422
F through H
full-duplex
Note For the Cisco AS5300, the duplexfull| halfauto} command replaces the full-duplex and half-duplex
commands. You will get the following error messages if you try to use the full-duplex and half-duplex
commands on a Cisco AS5300: Router(config)# interfacefastethernet0 Router(config-if)# full-duplex Please
use duplex command to configure duplex mode Router(config-if)# Router(config-if)# half-duplex Please use
duplex command to configure duplex mode
Support for This Command
Use the question mark (?) command to find out which port adapters support this command. If the interface
does not support full-duplex, an informational message displayed, and no changes are made to the interface.
To determine if the interface supports full-duplex, use the showinterfacescommand. For example, the following
message is displayed if the interface does not support full-duplex:
% interface does not support full-duplex.
Use on FDDI
Full-duplex on the FDDI full-duplex port adapters allows an FDDI ring with exactly two stations to transform
the ring into a full-duplex, point-to-point topology. For the interface to operate in full-duplex mode, there
must be only two stations on the ring, the two stations must be capable of operating in full-duplex mode, and
both stations must complete a full-duplex autoconfiguration protocol. There is no FDDI token in full-duplex
mode. Refer to the CiscoProductCatalog for specific model numbers of port adapters.
Full-duplex autoconfiguration protocol allows an FDDI station to dynamically and automatically operate in
either half-duplex (or ring) or full-duplex mode, and ensures that the stations fall back to ring mode when a
configuration change occurs, such as a third station joining the ring.
After booting the router, the FDDI stations begin operation in half-duplex mode. While the station performs
the full-duplex autoconfiguration protocol, the station continues to provide data-link services to its users.
Under normal conditions, the transition between half-duplex mode and full-duplex mode is transparent to the
data-link users. The data-link services provided by full-duplex mode are functionally the same as the services
provided by half-duplex mode.
If you change the full-duplex configuration (for example, from disabled to enabled) on supported interfaces,
the interface resets.
Cisco 10000 Series Router
The Fast Ethernet line card responds only to 802.3x pause frames from another device when it autonegotiates
the duplex mode (the default). The line card does not support 802.3x flow control when you manually set
half-duplex or full-duplex mode.
Examples
Cisco 7200 Series Router
The following example configures full-duplex mode on the Cisco 7200 series routers:
Router(config)# interface fastethernet 0/1
Router(config-if)# full-duplex
Cisco IOS Interface and Hardware Component Command Reference
423
F through H
full-duplex
Full-Duplex Binary Synchronous
The following example specifies full-duplex binary synchronous communications (Bisync) mode:
Router(config)# interface serial 0
Router(config-if)# encapsulation bstun
Router(config-if)# full-duplex
Full-Duplex on FDDI Interface
The following example enables full-duplex mode on FDDI interface 0:
Router(config)# interface fddi 0/1/0
Router(config-if)# full-duplex
Related Commands Command Description
half-duplex Specifies half-duplex mode on an SDLC interface or on the FDDI full-duplex,
single-mode port adapter and FDDI full-duplex, multimode port adapter on the
Cisco 7200 series and Cisco 7500 series routers.
interface Configures an interface type and enters interface configuration mode.
interface fastethernet Selects a particular Fast Ethernet interface for configuration.
interface serial Specifies a serial interface created on a channelized E1 or channelized T1 controller
(for ISDN PRI, CAS, or robbed-bit signaling).
show interfaces Displays statistics for all interfaces configured on the router or access server.
show interfaces fddi Displays information about the FDDI interface.
Cisco IOS Interface and Hardware Component Command Reference
424
F through H
g709 disable
g709 disable
To disable the ITU-T G.709 wrapper, use the g709 disable command in DWDM configuration mode. To
enable the ITU-T G.709 wrapper, use the no form of this command.
g709 disable
no g709 disable
Syntax Description Syntax Description
This command has no keywords or arguments.
Command Default The G.709 wrapper is enabled.
Command Modes DWDM configuration
Command History Release Modification
XE 3.18SP Support for this command was introduced on NCS 4200 Series router.
Usage Guidelines To display the G.709 alarms and counters, use theshow controller dwdm g709 command.
Examples The G.709 wrapper is enabled by default. The following example shows how to disable the G.709
wrapper on an interface:
enable
configure terminal
controller dwdm 0/0/0
g709 disable
end
If you have disabled the G.709 wrapper using the g709 disable command, use the no g709 disable
command to re-enable it, as shown in the following example:
enable
configure terminal
controller dwdm 0/0/0
no g709 disable
end
Related Commands Command Description
show controller dwdm Displays DWDM controller configuration.
Cisco IOS Interface and Hardware Component Command Reference
425
F through H
g709 fec
g709 fec
To configure the forward error correction (FEC) mode for the DWDM controller, use the g709feccommand
in controller configuration mode. To return to the default state, use the no form of this command.
g709 fec {disable|enhanced|standard}
no g709 fec
Syntax Description disable Disables FEC.
enhanced Enables enhanced FEC mode.
standard Enables standard FEC mode.
Command Default Standard FEC mode is enabled by default.
Command Modes Controller configuration (config-controller)
Command History Release Modification
12.2(33)SRD1 This command was introduced on the Cisco 7600 series router.
Usage Guidelines The g709fec command can be used only when the DWDM controller is in the shutdown state.
Standard FEC is the default mode; therefore, if you use the nog709fec command, standard FEC is used.
Examples The following example shows how to configure standard FEC mode on a DWDM controller:
Router(config)# controller dwdm 1/3
Router(config-controller)# g709 fec standard
Related Commands Command Description
controller dwdm Configures a DWDM controller.
g709 odu threshold Configures thresholds for selected ODU BER alarms.
g709 otu threshold Configures thresholds for selected OTU BER alarms.
no g709 odu report Disables the logging of selected ODU alarms.
no g709 otu report Disables the logging of selected OTU alarms.
show controller dwdm Displays ITU-T G.709 alarms, alerts, and counters.
transport-mode Configures a transport mode.
Cisco IOS Interface and Hardware Component Command Reference
426
F through H
g709 odu report
g709 odu report
To enable the logging of selected optical channel data unit (ODU) alarms to the console for a DWDM controller,
use the g709odureportcommand in controller configuration mode. To disable logging, use the no form of
this command.
g709 odu report {ais|bdi|lck|oci|pm-tca|ptim|sd-ber|sf-ber|tim}
no g709 odu report {ais|bdi|lck|oci|pm-tca|ptim|sd-ber|sf-ber|tim}
Syntax Description ais Alarm indication signal reporting status.
bdi Backward defect indication reporting status.
lck Upstream connection locked reporting status.
oci Open connection indication error reporting status.
pm-tca Path monitoring BER TCA reporting status.
ptim Payload type identifier mismatch reporting status.
sd-ber Sets PM BER in excess of SD threshold reporting status.
sf-ber Sets PM BER in excess of SF threshold reporting status.
tim Sets Trace Identifier Mismatch reporting status.
Command Default Logging is enabled for all keywords.
Command Modes Controller configuration (config-controller)
Command History Release Modification
12.2(33)SRD1 This command was introduced on the Cisco 7600 series router.
Usage Guidelines This command can be used only when the DWDM conroller is in the shutdown state.
Examples The following example shows how to enable ODU reporting for OCI:
Router(config)# controller dwdm 1/2
Router(config-controller)# g709 odu report oci
Related Commands Command Description
controller dwdm Configures a DWDM controller.
g709 fec Configures the FEC for the DWDM controller.
g709 odu threshold Configures thresholds for selected ODU BER alarms.
Cisco IOS Interface and Hardware Component Command Reference
427
F through H
g709 odu report
Command Description
g709 otu threshold Configures thresholds for selected OTU BER alarms.
show controller dwdm Displays G.709 alarms, alerts, and counters.
show platform dwdm alarm history Displays platform DWDM alarm history.
Cisco IOS Interface and Hardware Component Command Reference
428
F through H
g709 odu overhead tti
g709 odu overhead tti
To configure the Trail Trace Identifier (TTI) level for an Optical Channel Data Unit (ODU), use the
g709oduoverheadtticommand in DWDM configuration mode. To return to the default, use the no form of
this command.
g709 odu overhead tti {expected|sent} {ascii|hex} tti-string
no g709 odu overhead tti {expected|sent} {ascii|hex} tti-string
Syntax Description expected Configures the expected TTI string.
sent Configures the transmit TTI string.
ascii Indicates that the string is in ASCII format.
hex Indicates that the string is in hexidecimal format.
tti-string The TTI level string. You can configure the TTI level string in ASCII string format or hexadecimal
format. The ASCII text string can be a maximum of 64 characters. The hexadecimal string length
must be an even number and can be a maximum of 128 bytes.
Command Default No TTI level string is configured.
Command Modes DWDM configuration.
Command History Release Modification
15.1(2)S This command was introduced on the Cisco 7600 Router.
Usage Guidelines To display the TTI strings, use the showcontrollerdwdmg709 command.
Examples The following example shows how to configure the expected TTI string:
Router(config)# controller dwdm 0/1/0/0
Router(config-dwdm)# g709 odu overhead tti expected ascii test_odu_5678
Related Commands Command Description
show controller dwdm Displays optical parameters, G.709 alarms and counters, and register and module
information for a DWDM controller.
Cisco IOS Interface and Hardware Component Command Reference
429
F through H
g709 odu threshold
g709 odu threshold
To configure thresholds for selected optical channel data unit (ODU) bit error rate (BER) alarms, use the
g709oduthresholdcommand in controller configuration mode. To return to the default state, use the no form
of this command.
g709 odu threshold {pm-tca bit-error-rate|sd-ber bit-error-rate|sf-ber bit-error-rate}
no g709 odu threshold {pm-tca bit-error-rate|sd-ber bit-error-rate|sf-ber bit-error-rate}
Syntax Description pm-tca Sets the path monitoring threshold crossing alert threshold.
sd-ber Sets the signal degrade bit error rate (BER) threshold.
sf-ber Sets the signal failure BER threshold.
bit-error-rate Specifies the BER threshold value in the range from 3 through 9. The threshold value is
interpreted as a negative exponent of 10 when determining the bit error rate. For example,
a value of 5 implies a bit error rate of 10 to the minus 5. The default BER threshold value
is 6.
Command Default sd-ber: 6
sf-ber: 3
pm-tca: 3
Command Modes Controller configuration (config-controller)
Command History Release Modification
12.2(33)SRD1 This command was introduced on the Cisco 7600 series router.
Usage Guidelines This command can be used only when the DWDM controller is in the shutdown state.
Examples The following example shows how to set the signal fail BER rate to 5:
Router(config)# controller dwdm 1/2
Router(config-controller)# g709 odu threshold sf-ber 5
Related Commands Command Description
controller dwdm Configures a DWDM controller.
g709 fec Configures the FEC for the DWDM controller
g709 otu threshold Configures thresholds for selected OTU BER alarms.
no g709 odu report Disables the logging of selected ODU alarms.
no g709 otu report Disables the logging of selected OTU alarms.
Cisco IOS Interface and Hardware Component Command Reference
430
F through H
g709 odu threshold
Command Description
show controller dwdm Displays ITU-T G.709 alarms, alerts, and counters.
transport-mode Configures a transport mode.
Cisco IOS Interface and Hardware Component Command Reference
431
F through H
g709 otu report
g709 otu report
To enable the logging of selected optical channel transport unit (OTU) alarms to the console for a DWDM
controller, use the g709otureportcommand in controller configuration mode. To disable logging, use the no
form of this command.
g709 otu report {ais|bdi|iae|lof|lom|los|sm-tca|tim|sd-ber|sf-ber}
no g709 otu report {ais|bdi|iae|lof|lom|los|sm-tca|tim|sd-ber|sf-ber}
Syntax Description ais Alarm indication signal reporting status.
bdi Backward defect indication reporting status.
iae Incoming alignment error reporting status.
lof OTU loss of frame reporting status.
lom Loss of multiple frame reporting status.
los Loss of signal reporting status.
sm-tca Section monitoring BER TCA reporting status.
tim Trace identifier mismatch reporting status.
sd-ber SM BER is in excess of the SD BER threshold
sf-ber SM BER is in excess of the SF BER threshold
Command Default Reporting is enabled for all keywords.
Command Modes Controller configuration (config-controller)
Command History Release Modification
12.2(33)SRD1 This command was introduced on the Cisco 7600 series router.
XE 3.18SP This command was introduced on the Cisco NCS 4200 Series router.
Usage Guidelines This command can be used only when the DWDM controller is in the shutdown state.
Examples The following example shows how to enable OTU reporting for IAE:
Router(config)# controller dwdm 1/2
Router(config-controller)# g709 otu report iae
Related Commands Command Description
controller dwdm Configures a DWDM controller.
Cisco IOS Interface and Hardware Component Command Reference
432
F through H
g709 otu report
Command Description
g709 fec Configures the FEC for the DWDM controller.
g709 odu threshold Configures thresholds for selected ODU BER alarms.
g709 otu threshold Configures thresholds for selected OTU BER alarms.
no g709 odu report Disables the logging of selected ODU alarms.
show controller dwdm Displays ITU-T G.709 alarms, alerts, and counters.
show platform dwdm alarm history Displays platform DWDM alarm history.
transport-mode Configures a transport mode.
Cisco IOS Interface and Hardware Component Command Reference
433
F through H
g709 otu threshold
g709 otu threshold
To configure thresholds for selected optical channel transport unit (OTU) bit error rate (BER) alarms, use the
g709otuthresholdcommand in controller configuration mode. To return to the default state, use the no form
of this command.
g709 otu threshold sm-tca| sd-ber| sf-ber bit-error-rate
no g709 otu threshold sm-tca| sd-ber| sf-ber bit-error-rate
Syntax Description sm-tca Sets the Section Monitoring Threshold Crossing Alert threshold.
sd-ber Sets the Signal Degrade Bit Error rate threshold.
sf-ber Sets the Signal Failure Bit Error Rate threshold.
bit-error-rate Sets the BER threshold value in the range from 3 through 9. The threshold value is interpreted
as a negative exponent of 10 when determining the bit error rate. For example, a value of 5
implies a bit error rate of 10 to the minus 5. The default BER threshold value is 3.
Command Default bit-error-rate: 3
Command Modes Controller configuration (config-controller)
Command History Release Modification
12.2(33)SRD1 This command was introduced on the Cisco 7600 series router.
XE 3.18 SP This command was introduced on the Cisco NCS 4200 Series router.
Usage Guidelines This command can be used only when the DWDM controller is in the shutdown state.
Examples The following example shows how to set the Section Monitoring Threshold Crossing Alert threshold
to 5:
Router(config)# controller dwdm 1/2
Router(config-controller)# g709 otu threshold sm-tca 5
Related Commands Command Description
controller dwdm Configures a DWDM controller.
g709 fec Configures the FEC for the DWDM controller.
g709 odu threshold Configures thresholds for selected ODU BER alarms.
no g709 odu report Disables the logging of selected ODU alarms.
no g709 otu report Disables the logging of selected OTU alarms.
Cisco IOS Interface and Hardware Component Command Reference
434
F through H
g709 otu threshold
Command Description
show controller dwdm Displays ITU-T G.709 alarms, alerts, and counters.
transport-mode Configures a transport mode.
Cisco IOS Interface and Hardware Component Command Reference
435
F through H
g709 tti-processing enable
g709 tti-processing enable
To configure Trail Trace Identifier (TTI), use the g709 tti-processing enable command in the controller
configuration mode.
g709 tti-processing enable {odu | otu}
Syntax Description Syntax Description
odu Configures TTI for selected ODU alarm.
otu Configures TTI for selected OTU alarm.
Command Modes Controller configuration
Command History Release Modification
15.6(02)SP Support for this command was introduced on NCS 4200 Series router.
Usage Guidelines The interface goes down in case of OTU TIM or ODU TIM alarms.
Examples The following example shows how to enter CEM interface parameters:
enable
configure terminal
controller dwdm 0/4/1
shutdown
g709 tti-processing enable odu
no shutdown
end
Related Commands Command Description
clear controller dwdm Displays the DWDM controller configuration.
Cisco IOS Interface and Hardware Component Command Reference
436
F through H
gnss
gnss
To enable the global navigation satellite system (GNSS) module on the Cisco ASR 903, Cisco ASR 907, and
the Cisco ASR 920 routers, use the gnss command in the global configuration mode.
gnss slot {r0r1}
Syntax Description slot Specifies the slot information.
r0 Indicates route processor slot 0.
r1 Indicates route processor slot 1.
Command Default No default behavior or values.
Command Modes Global configuration (config)
Command History Release Modification
IOS-XE 3.17 This command was introduced on the Cisco ASR 903, Cisco ASR 907, and the Cisco ASR
920 routers.
Usage Guidelines This command enables the GNSS module on the router. However, you must execute the no shutdown command
after the gnss command to ensure that the interface is administratively up.
Examples The following example shows how to enable the GNSS module and enter the GNSS mode:
Router# configure terminal
Router(config)# gnss slot r0
Router(config-gnss)# no shutdown
Related Commands Command Description
1pps Configures the pulse per second from the GNSS module.
anti-jam Enables or disables the anti-jam mode on the GNSS module.
constellation Configures the GNSS module based on the specified satellite constellations.
default Resets the device to its default state.
exit Exists the GNSS sub mode.
no Negates the command or sets the value of the command to its default values.
shutdown Enables GNSS module.
Cisco IOS Interface and Hardware Component Command Reference
437
F through H
gtp
gtp
To enables Enhanced Wireless Access Gateway (EWAG) General packet radio service (GPRS) Tunneling
Protocol (GTP) and enter EWAG GTP configuration mode, use the gtp command in global configuration
mode.
gtp
Syntax Description This command does not contain any keywords or arguments.
Command Default This command has no defaults.
Command Modes
Global configuration (config)
Command History Release Modification
Cisco IOS XE Release 3.8S This command was introduced.
Examples The following example shows how to enable GTP and configure parameters of an access point.
Device(config)# gtp
Device(config-gtp)# n3-request 3
Device(config-gtp)# interval t3-response 30
Device(config-gtp)# information-element rat-type wlan
Device(config-gtp)# interface local GigabitEthernet0/0/0
WARNING: same interface has already been configured
Device(config-gtp)# apn 1
Device(config-gtp-apn)# apn-name starent.com
Device(config-gtp-apn)# ip address ggsn 10.1.2.1
Device(config-gtp-apn)# dns-server 10.1.2.1
Device(config-gtp-apn)# dhcp-server 10.10.197.1
Device(config-gtp-apn)# dhcp-lease 6000
Device(config-gtp-apn)# tunnel mtu 1500
Device(config-gtp-apn)# end
Related Commands Command Description
apn Configures an ASCII regular
expression string to be matched
against the APN for GPRS load
balancing.
apn-name Configures access point name.
debug gtp Debugs information related to
EWAG GTP.
Cisco IOS Interface and Hardware Component Command Reference
438
F through H
gtp
Command Description
dns-server Specifies the DNS IP servers
available to a DHCP client.
dhcp-server Specifies a primary (and backup)
DHCP server to allocate IP
addresses to MS users entering a
particular PDN access point.
dhcp-lease Configures DHCP lease time in
seconds.
interval (EWAG) Configures message intervals.
information-element Configures information elements.
interface (EWAG) Configure EWAG interface.
ip address ggsn Configures GGSN IP address.
n3-request Specifies the maximum number of
times that the quota server attempts
to send a signaling request to the
CSG.
show gtp Displays information related to
EWAG GTP.
tunnel mtu Configures GTP tunnel parameters.
Cisco IOS Interface and Hardware Component Command Reference
439
F through H
half-duplex
half-duplex
To specify half-duplex mode on an Synchronous Data Link Control (SDLC) interface or on the FDDI
full-duplex, single-mode port adapter and FDDI full-duplex, multimode port adapter on the Cisco 7200 series
and Cisco 7500 series routers, use the half-duplex command in interface configuration mode. To reset the
interface to full-duplex mode, use the no form of this command.
half-duplex
no half-duplex
Syntax Description This command has no arguments or keywords.
Command Default Full-duplex mode is the default mode on an SDLC interface, the FDDI full-duplex, single-mode port adapter
and FDDI full-duplex, multimode port adapter on the Cisco 7200 series and Cisco 7500 series routers.
Command Modes Interface configuration
Command History Release Modification
11.1 This command was introduced.
11.3 This command was modified to include information on FDDI full-duplex, single-mode, and
multimode port adapters.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines SDLC Interfaces
The half-duplex command is used to configure an SDLC interface for half-duplex mode and is used on a
variety of port adapters. Use the question mark (?) command to find out which port adapters support this
command.
Note The half-duplexcommand replaces the sdlchdx and media-typehalf-duplex commands.
Note For the Cisco AS5300, the duplexfullhalfauto} command replaces the full-duplex and half-duplex commands.
You will get the following error messages if you try to use the full-duplex and half-duplex commands on a
Cisco AS5300: Router(config)# interfacefastethernet0 Router(config-if)# full-duplex Please use duplex
command to configure duplex mode Router(config-if)# Router(config-if)# half-duplex Please use duplex
command to configure duplex mode
Enabling Full-Duplex Mode
To enable full-duplex mode, use the nohalf-duplexorfull-duplexcommands.
Cisco IOS Interface and Hardware Component Command Reference
440
F through H
half-duplex
Note The media-typehalf-duplex command exists in Cisco IOS Release 11.0(5). As of Release 11.0(6), the keyword
half-duplex was removed from the media-type command. In Release 11.0(6), the functionality for specifying
half-duplex mode is provided by thehalf-duplex command.
Port Adapters
Refer to the CiscoProductCatalog for specific model numbers of port adapters.
Examples The following example configures an SDLC interface for half-duplex mode:
Router(config-if)# encapsulation sdlc-primary
Router(config-if)# half-duplex
Related Commands Command Description
full-duplex Specifies full-duplex mode on full-duplex single-mode and multimode port adapters.
Cisco IOS Interface and Hardware Component Command Reference
441
F through H
half-duplex controlled-carrier
half-duplex controlled-carrier
To place a low-speed serial interface in controlled-carrier mode, instead of constant-carrier mode, use the
half-duplexcontrolled-carriercommand in interface configuration mode. To return the interface to
constant-carrier mode, use the no form of this command.
half-duplex controlled-carrier
no half-duplex controlled-carrier
Syntax Description This command has no arguments or keywords.
Command Default Constant-carrier mode, where Data Carrier Detect (DCD) is held constant and asserted by the DCE half-duplex
interface.
Command Modes Interface configuration
Command History Release Modification
11.2 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command applies only to low-speed serial DCE interfaces in half-duplex mode. Configure a serial
interface for half-duplex mode by using the half-duplex command. Refer to the CiscoProductCatalog for
specific model numbers of networking devices which support serial interfaces.
Controlled-carrier operation means that the DCE interface has DCD deasserted in the quiescent state. When
the interface has something to transmit, it asserts DCD, waits a user-configured amount of time, then starts
the transmission. When the interface has finished transmitting, it waits a user-configured amount of time and
then deasserts DCD.
Examples The following examples place the interface in controlled-carrier mode and then back into
constant-carrier operation.
This example shows changing to controlled-carrier mode from the default of constant-carrier operation:
Router(config)# interface serial 2
Router(config-if)# half-duplex controlled-carrier
This example shows changing to constant-carrier operation from controlled-carrier mode:
Router(config)# interface serial 2
Router(config-if)# no half-duplex controlled-carrier
Cisco IOS Interface and Hardware Component Command Reference
442
F through H
half-duplex controlled-carrier
Related Commands Command Description
half-duplex Specifies half-duplex mode on an SDLC interface or single-mode and multimode port
adapters.
half-duplex timer Tunes half-duplex timers.
physical-layer Specifies the mode of a slow-speed serial interface on a router as either synchronous
or asynchronous.
Cisco IOS Interface and Hardware Component Command Reference
443
F through H
half-duplex timer
half-duplex timer
To tune half-duplex timers, use the half-duplextimer command in interface configuration mode. To return
to the default parameter values, use the no form of this command.
half-duplex timer {cts-delay value|cts-drop-timeout value|dcd-drop-delay value|dcd-txstart-delay
value|rts-drop-delay value|rts-timeout value|transmit-delay value}
no half-duplex timer {cts-delay value|cts-drop-timeout value|dcd-drop-delay value|dcd-txstart-delay
value|rts-drop-delay value|rts-timeout value|transmit-delay value}
Syntax Description cts-delay value Specifies the delay introduced by the DCE interface from the time it detects the
Request to Send (RTS) to the time it asserts Clear to Send (CTS) in response. The
range is dependent on the serial interface hardware. The default cts-delay value is 0
ms.
cts-drop-timeout Determines the amount of time a DTE interface waits for CTS to be deasserted after
value it has deasserted RTS. If CTS is not deasserted during this time, an error counter is
incremented to note this event. The range is from 0 to 1,140,000 ms (1140 seconds).
The default cts-drop-timeout value is 250 ms.
dcd-drop-delay Applies to DCE half-duplex interfaces operating in controlled-carrier mode (see the
value half-duplexcontrolled-carrier command). This timer determines the delay between
the end of transmission by the DCE and the deassertion of Data Carrier Detect (DCD).
The range is from 0 to 4400 ms (4.4 seconds). The default dcd-drop-delay value is
100 ms.
dcd-txstart-delay Applies to DCE half-duplex interfaces operating in controlled-carrier mode. This
value timer determines the time delay between the assertion of DCD and the start of data
transmission by the DCE interface. The range is from 0 to 1,140,000 ms (1140
seconds). The default dcd-txstart-delay value is 100 ms.
rts-drop-delay Specifies the time delay between the end of transmission by the DTE interface and
value deassertion of RTS. The range is from 0 to 1,140,000 ms (1140 seconds). The default
rts-drop-delay value is 3 ms.
rts-timeout value Determines the number of milliseconds the DTE waits for CTS to be asserted after
the assertion of RTS before giving up on its transmission attempt. If CTS is not
asserted in the specified amount of time, an error counter is incremented. The range
is dependent on the serial interface hardware. The default rts-timeout value is 3 ms.
transmit-delay Specifies the number of milliseconds a half-duplex interface will delay the start of
value transmission. In the case of a DTE interface, this delay specifies how long the interface
waits after something shows up in the transmit queue before asserting RTS. For a
DCE interface, this dictates how long the interface waits after data is placed in the
transmit queue before starting transmission. If the DCE interface is in
controlled-carrier mode, this delay shows up as a delayed assertion of DCD.
This timer enables the transmitter to be adjusted if the receiver is a little slow and is
not able to keep up with the transmitter. The range is from 0 to 4400 ms (4.4 seconds).
The defaulttransmit-delay value is 0 ms.
Cisco IOS Interface and Hardware Component Command Reference
444
F through H
half-duplex timer
Command Default The default cts-delay value is 0 ms. The default cts-drop-timeout value is 250 ms. The default dcd-drop-delay
value is 100 ms. The default dcd-txstart-delay value is 100 ms. The default rts-drop-delay value is 3 ms.
The default rts-timeout value is 3 ms. The defaulttransmit-delay value is 0 ms.
Command Modes Interface configuration
Command History Release Modification
11.3 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Tuning Half-Duplex Timers
The half-duplextimer command is used to tune half-duplex timers. With these timer tuning commands you
can adjust the timing of the half-duplex state machines to suit the particular needs of their half-duplex
installation.
You can configure more than one option using this command, but each option must be specified as a separate
command.
Note The half-duplextimercts-delay command replaces the sdlccts-delay command. The
half-duplextimerrts-timeout command replaces the sdlcrts-timeout command.
Value Ranges
The range of values for the cts-delay and rts-timeout keywords are dependent on the serial interface hardware.
Examples The following example set the cts-delay timer to 10 ms and the transmit-delay timer to 50 ms:
Router(config)# interface serial 2
Router(config-if)# half-duplex timer cts-delay 10
Router(config-if)# half-duplex timer transmit-delay 50
Related Commands Command Description
half-duplex controlled-carrier Places a low-speed serial interface in controlled-carrier mode, instead of
constant-carrier mode.
physical-layer Specifies the mode of a slow-speed serial interface on a router as either
synchronous or asynchronous.
Cisco IOS Interface and Hardware Component Command Reference
445
F through H
history (interface)
history (interface)
To enable an interface to maintain utilization history, use the history command in interface configuration
mode. To disable an interface, use the no form of this command.
history {bps|pps} [filter]
no history
Syntax Description bps Maintains history in bits per second.
pps Maintains history in packets per second.
filter (Optional) Interface counters. See the table below for details. Any number of counters can be used.
Command Default Interface utilization history is not maintained.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)XNE This command was introduced.
Usage Guidelines Once interface history is configured, the interface history histograms can be displayed using the show interface
history command.
Some of the interface counters are interface-type-specific and cannot be specified unless they apply to the
specific interface type being configured. Once interface history is configured, counters cannot be added or
removed without first removing the interface history configuration.
Significant processor memory is allocated to maintain the history information. For example, if two counters
are monitored, then approximately 4KB are used for the rate and counter history. If 20 counters are monitored,
then approximately 19KB are used.
The table below lists the interface counter options for the history (interface) command.
Table 17: Interface Counter Options For Interface History
Interface Counter Description
all Includes all interface counters in the history.
babbles Includes the Ethernet output babbles in the history.
crcs Includes CRC counter in the history.
deferred Includes the deferred Ethernet output in the history.
dribbles Includes dribble counter in the history.
excessive-collisions Includes Ethernet excessive output collisions in the history.
flushes Includes flushes counter in the history.
Cisco IOS Interface and Hardware Component Command Reference
446
F through H
history (interface)
Interface Counter Description
frame-errors Includes frame errors in the history.
giants Includes giants counter in the history.
ignored Includes ignored counter in the history.
input-broadcasts Includes input broadcasts in the history.
input-drops Includes input drops in the history.
input-errors Includes input errors in the history.
interface-resets Includes interface resets in the history.
late-collisions Includes Ethernet late output collisions in the history.
lost-carrier Includes Ethernet output lost carrier in the history.
multi-collisions Includes Ethernet multiple output collisions in the history.
multicast Includes Ethernet input multicast in the history.
no-carrier Includes Ethernet output no-carrier in the history.
output-broadcasts Includes output broadcasts in the history.
output-buffer-failures Includes output buffer failures in the history.
output-buffers-swapped-out Includes output buffers swapped out in the history.
output-drops Includes output drops in the history.
output-errors Includes output errors in the history.
output-no-buffer Includes output no buffer in the history.
overruns Includes overruns in the history.
pause-input Includes Ethernet input pause in the history.
pause-output Includes Ethernet output pause in the history.
runts Includes runts in the history.
single-collisions Includes Ethernet single output collisions in the history.
throttles Includes throttles in the history.
underruns Includes underruns in the history.
unknown-protocol-drops Includes unknown protocol drops in the history.
watchdog Includes Ethernet output watchdog in the history.
Cisco IOS Interface and Hardware Component Command Reference
447
F through H
history (interface)
Examples The following example shows how to configure the interface history command to maintain interface
utilization history in bits per second (bps) and also the input-drop history:
Device(config-if)# history bps input-drops
Related Commands Command Description
show interface history Displays information on the interface utilization.
Cisco IOS Interface and Hardware Component Command Reference
448
F through H
hold-queue
hold-queue
To limit the length of the IP output queue on an interface, use the hold-queue command in interface
configuration or template configuration mode. To restore the default values, use the no form of this command.
hold-queue length {in|out}
no hold-queue length {in|out}
Syntax Description length Integer that specifies the maximum number of packets in the queue. The range of valid values is
from 0 to 65535.
in Specifies the input queue. The default is 75 packets. For asynchronous interfaces, the default is 10
packets.
out Specifies the output queue. The default is 40 packets. For asynchronous interfaces, the default is
10 packets.
Command Default Input hold-queue limit is 75 packets. Output hold-queue limit is 40 packets. Asynchronous interfaces default
is 10 packets.
Command Modes Interface configuration (config-if)
Template configuration (config-template)
Command History Release Modification
10.0 This command was introduced.
11.1 The nohold-queuecommand was added.
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Cisco
IOS Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB.
15.1(2)T This command was modified. The length argument was added to the no form
of the command.
15.2(2)E This command was integrated into Cisco IOS Release 15.2(2)E. This command
is supported in template configuration mode.
Cisco IOS XE Release 3.6E This command was integrated into Cisco IOS XE Release 3.6E. This command
is supported in template configuration mode.
Usage Guidelines Defaults
Cisco IOS Interface and Hardware Component Command Reference
449
F through H
hold-queue
The default limits for this command prevent a malfunctioning interface from consuming an excessive amount
of memory. There is no fixed upper limit to a queue size.
Back-to-Back Routing Updates
The default of 10 packets allows the Cisco IOS software to queue a number of back-to-back routing updates.
This is the default for asynchronous interfaces only; other media types have different defaults.
Hold Queues and Priority Queueing
• The hold queue stores packets received from the network that are waiting to be sent to the client. Cisco
recommends that the queue length not exceed10 packets on asynchronous interfaces. For most other
interfaces, queue length should not exceed 100.
• The input hold queue prevents a single interface from flooding the network server with too many input
packets. Further input packets are discarded if the interface has too many input packets outstanding in
the system.
• If you are using priority output queueing, the length of the four output queues is set using the priority-list
global configuration command. The hold-queue command cannot be used to set an output hold queue
length in this situation.
• For slow links, use a small output hold-queue limit to prevent storing packets at a rate that exceeds the
transmission capability of the link.
• For fast links, use a large output hold-queue limit. A fast link may be busy for a short time (and require
the hold queue) but can empty the output hold queue quickly when capacity returns.
• You can display the current hold-queue setting and the number of packets that are discarded because of
hold-queue overflows by using the showinterfaces command in user EXEC mode.
Caution Increasing the hold queue can have detrimental effects on network routing and response times. For protocols
that use seq/ack packets to determine round-trip times, do not increase the output queue. Dropping packets
instead informs hosts to slow down transmissions to match available bandwidth. This is generally better than
having duplicate copies of the same packet within the network (which can happen with large hold queues).
Note When you use the no form of the hold-queue command, the length value (maximum number of packets in
the queue) need not necessarily be the same as the configured value.
Examples The following example shows how to set a small input queue on a slow serial line:
Router(config)# interface serial 0
Router(config-if)# hold-queue 30 in
The following example shows how to set an input value in an interface template:
Device# configure terminal
Device(config)# template user-template1
Device(config-template)# hold-queue 30 in
Device(config-template)# end
Cisco IOS Interface and Hardware Component Command Reference
450
F through H
hold-queue
Cisco uBR10012 Universal Broadband Router
The following example shows how to modify the input hold queue on a Gigabit Ethernet SPA:
Router# configure terminal
Router(config)#interface GigabitEthernet3/0/0
Router(config-if)#hold-queue 30 in
Related Commands Command Description
priority-list Establishes queueing priorities based on the protocol type.
show interfaces Displays statistics for all interfaces configured on the router or access server.
Cisco IOS Interface and Hardware Component Command Reference
451
F through H
hssi external-loop-request
hssi external-loop-request
To allow the router to support a CSU/DSU that uses the loopback circuit (LC) signal to request a loopback
from the router, use the hssiexternal-loop-request command in interface configuration mode. To disable this
function, use the no form of this command.
hssi external-loop-request
no hssi external-loop-request
Syntax Description This command has no arguments or keywords.
Command Default Disabled
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The HSA applique on the High-Speed Serial Interface (HSSI) contains an LED that indicates the loopback
circuit A (LA), loopback circuit B (LB), and LC signals that are transiting through the devices. The CSU/DSU
uses the LC signal to request a loopback from the router. The CSU/DSU may want to do this so that its own
network management diagnostics can independently check the integrity of the connection between the CSU/DSU
and the router.
Use this command to enable a two-way, internal, and external loopback request on the HSSI from the CSU/DSU.
Caution If your CSU/DSU does not support this function, it should not be enabled on the router. Not enabling this
function prevents spurious line noise from accidentally tripping the external loopback request line, which
would interrupt the normal data flow.
Examples The following example enables a CSU/DSU to use the LC signal to request a loopback from the
router:
Router(config-if)# hssi external-loop-request
Cisco IOS Interface and Hardware Component Command Reference
452
F through H
hssi internal-clock
hssi internal-clock
To convert the High-Speed Serial Interface (HSSI) into a clock master, use the hssiinternal-clock command
in interface configuration mode. To disable the clock master mode, use the no form of this command.
hssi internal-clock
no hssi internal-clock
Syntax Description This command has no arguments or keywords.
Command Default Disabled
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use this command in conjunction with the HSSI null-modem cable to connect two Cisco routers together with
HSSI. You must configure this command at both ends of the link, not just one.
Note HSSI network module provides full-duplex connectivity at SONET OC-1/STS-1 (51.840 Mhz), T3 (44.736
MHZ), and E3 (34.368 MHz) rates in conformance with the EIA/TIA-612 and EIA/TIA-613 specifications.
The actual rate of the interface depends on the external data service unit (DSU) and the type of service to
which it is connected.
Examples The following example shows how to convert the HSSI interface into a clock master:
Router(config-if)# hssi internal-clock
Cisco IOS Interface and Hardware Component Command Reference
453
F through H
hub
hub
To enable and configure a port on an Ethernet hub of a Cisco 2505 or Cisco 2507 router, use the hub command
in global configuration mode.
hub ethernet number port [end-port]
Syntax Description ethernet Indicates that the hub is in front of an Ethernet interface.
number Hub number, starting with 0. Because there is only one hub, this number is 0.
port Port number on the hub. On the Cisco 2505 router, port numbers range from 1 to 8. On the Cisco
2507 router, port numbers range from 1 to 16. If a second port number follows, then this port
number indicates the beginning of a port range.
end-port (Optional) Last port number of a range.
Command Default No hub ports are configured.
Command Modes Global configuration
Command History Release Modification
10.3 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command does not have a no form.
Examples The following example enables port 1 on hub 0:
Router# hub ethernet 0 1
Router(config-hub)# no shutdown
The following example enables ports 1 through 8 on hub 0:
Router# hub ethernet 0 1 8
Router(config-hub)# no shutdown
Related Commands Command Description
shutdown (hub) Shuts down a port on an Ethernet hub of a Cisco 2505 or Cisco 2507 router.
Cisco IOS Interface and Hardware Component Command Reference
454
F through H
hw-module boot
hw-module boot
To specify the boot options for the module through the power management bus control register, use the
hw-moduleboot command in privileged EXEC mode.
hw-module module num boot [value] {config-register|eobc|flash image|rom-monitor}
Syntax Description module num Specifies the number of the module to apply the command.
boot value (Optional) Literal value for the module's boot option; valid values are from 0 to 15. See
the “Usage Guidelines” section for additional information.
config-register Boots using the module’s config-register value.
eobc Boots using an image downloaded through EOBC.
flash image Specifies the image number in the module’s internal Flash memory for the module’s boot
option; valid values are 1 and 2.
rom-monitor Stays in ROM-monitor mode after the module resets.
Command Default This command has no default settings.
Command Modes Privileged EXEC
Command History Release Modification
12.2(18)SXF Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The valid values for the bootvalue argument are as follows:
0--Specifies the module’s config-register value.
1--Specifies the first image in the Flash memory.
2--Specifies the second image in the Flash memory.
3--Stays in ROM-monitor mode after the module reset.
4--Specifies the download image through EOBC.
Examples This example shows how to reload the module in slot 6 using the module’s config-register value:
Router# hw-module module 1 boot config-register
Router#
This example shows how to reload the module in slot 3 using an image downloaded through EOBC:
Router# hw-module module 1 boot eobc
Router#
Cisco IOS Interface and Hardware Component Command Reference
455
F through H
hw-module boot
Related Commands Command Description
showmodule Displays the module status and information for all modules in the chassis.
Cisco IOS Interface and Hardware Component Command Reference
456
F through H
hw-module energywise level
hw-module energywise level
Note Effective with Cisco IOS Releases 15.1(1)T and 15.0.1M(2), the hw-moduleenergywiselevel command is
not available in Cisco IOS software. For more information, see the Cisco 3900 Series, 2900 Series, and 1900
Series Software Configuration Guide .
To set the energywise level on the service module (SM), internal service module (ISM), or packet voice/data
module (PVDM), use the hw-moduleenergywiselevelcommand in privileged EXEC mode.
hw-module module-type slot-number energywise level level
Syntax Description module-type Specifies the type of module.
slot-number Specifies the slot, and if applicable, the sub slot number for the module.
energywise level Specifies the power level for each module.
level 0-10. 0 will shut the power. Any number between 1 to 10 will turn the power on.
Command Default The energywise level is 10.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines Use the hw-moduleenergywiselevelcommand in privileged EXEC mode to set the energywise level on the
SM, ISM, or PVDM on your router. Specify the slot, and if applicable, the sub slot number for the module.
The energywise levelsupported for the module is specified by the module. The following table provides a
definition for each energywise level:
Energywise Definition
Level
0 Shut
1 Hibernate
2 Sleep
3 Standby
4 Ready
5 Low
6 Frugal
Cisco IOS Interface and Hardware Component Command Reference
457
F through H
hw-module energywise level
Energywise Definition
Level
7 Medium
8 Reduced
9 High
10 Full
Note When the router reboots, the energywise level is set to energywise level 10 and will remain at energywise
level 10 till a different energywise level is applied.
Examples The following example shows how to set the energywise level at shut on an SM in slot 1.
Router#hw-module
sm 1
energywise level
0
The following example shows how to set the energywise level at full on an SM in slot 1.
Router#hw-module
sm 1
energywise level
10
Related Commands Command Description
show environment To display temperature, voltage, fan, and power supply information, use
the showenvironment command in user EXEC or privileged EXEC mode.
show platform To display the energywise levels supported on the module, and the current
hw-module-power and previous energywise level on the router, use the show platform
hw-module-power command in user EXEC or privileged EXEC mode.
Cisco IOS Interface and Hardware Component Command Reference
458
F through H
hw-module fan-tray version
hw-module fan-tray version
To set the fan-type (high or low power) version, use the hw-modulefan-trayversioncommand in privileged
EXEC mode.
hw-module fan-tray version [{1|2}]
Syntax Description 1 | (Optional) Specifies the version number; see the “Usage Guidelines” section for additional information.
2
Command Default This command has no default settings.
Command Modes Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines Before you install a high-capacity fan tray, enter the hw-modulefan-trayversion2 command to check for
configuration problems, such as power-supply compatbility and power sufficiency. If there are no problems,
a message is displayed to change the fan tray from version 1 to version 2. At this point, you can remove the
old fan tray and quickly insert the new high-capacity fan tray.
The hw-modulefan-trayversion2 command aplies to Cisco 7600 series routers configured with a Supervisor
Engine 2. This command is not required in systems configured with a Supervisor Engine 720 or a Supervisor
Engine 32.
This command is supported on the following chassis:
• WS-C6506
• WS-C6509
• WS-C6509-NEB/OSR7609
Set the version to 2 before installing higher power fan trays.
Set the version to 1 before downgrading to lower power fan trays.
Command confirmation does not change the fan power consumption or cooling capacity. It updates the
backplane IDPROM. The new values take effect the next time that you insert a fan.
When you execute the command, the software checks the configurations and prompts for confirmation. Any
illegal configurations (such as power-supply incompatibility) result in a warning being displayed and a
command failure.
Examples This example shows how to set the fan type for lower power fan trays:
Cisco IOS Interface and Hardware Component Command Reference
459
F through H
hw-module fan-tray version
Router#
hw-module fan-tray version 1
Related Commands Command Description
show environment cooling Displays information about the cooling parameter.
Cisco IOS Interface and Hardware Component Command Reference
460
F through H
hw-module interface als restart
hw-module interface als restart
To request a restart pulse when Automatic Laser Shutdown (ALS) restart mode is configured as manual, use
the hw-module interface TenGigabitEthernet als restart command in Privileged EXEC mode.
hw-module interface TenGigabitEthernet slot/port als restart
Syntax Description slot/port Number of the chassis slot that contains the interface, where:
• slot--Chassis slot number.
• /port--Port number.
• For a 7600-ES+ITU-2TG, the valid values for the port are
1, 2.
• For a 7600-ES+ITU-4TG, the valid values for the port are
1, 2, 3, 4.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SRD1 This command was introduced on the Cisco 7600 series router.
Examples The following example shows how to request an ALS restart pulse for the Ten Gigabit Ethernet
interface on slot 6 port number 2:
Router# hw-module interface TenGigabitEthernet 6/2 als restart
Related Commands Command Description
als Enables the ALS mode.
als restart mode Selects the ALS restart mode.
als restart pulse Select the ALS pulse mode.
show als Displays ALS status.
show controller dwdm Displays G.709 alarms, alerts, and counters.
transport-mode Configures a transport mode.
Cisco IOS Interface and Hardware Component Command Reference
461
F through H
hw-module main-cpu qa error-recovery
hw-module main-cpu qa error-recovery
To enable the recovery mechanism for a QA error condition on a Cisco 7500 series router, use the
hw-modulemain-cpuqaerror-recovery command in global configuration mode. To disable the recovery
mechanism for a QA error condition, use the no form of this command.
hw-module main-cpu qa error-recovery
no hw-module main-cpu qa error-recovery
Syntax Description This command has no arguments or keywords.
Command Default In Cisco IOS Release 12.0(24)S1, the recovery mechanism for a QA error condition is disabled; in all other
releases, it is enabled.
Command Modes Global configuration
Command History Release Modification
12.1(19)E This command was introduced.
12.0(24)S1 This command was integrated into Cisco IOS Release 12.0(24)S1.
12.2(15)T5 This command was integrated into Cisco IOS Release 12.2(15)T5.
12.2(18)S This command was integrated into Cisco IOS Release 12.2(18)S.
12.0(26)S This command was integrated into Cisco IOS Release 12.0(26)S.
12.3(6) This command was integrated into Cisco IOS Release 12.3(6).
Usage Guidelines QA errors are sometimes seen in heavy traffic situations and may indicate a hardware failure or a software
bug. In the case of a hardware failure, a Versatile Interface Processor (VIP) or a Route Switch Processor (RSP)
must be replaced. It is possible, however, to recover from a QA error and not see another error for months.
When the same buffer header is present in two different queues, the QA ASIC goes into an error condition
and triggers a QA error interrupt. The QA error interrupt causes the RSP to dump the QA diagnostics and
perform a cbus complex during which all the line cards are reloaded. Although the duplicate buffer header
condition does not always indicate a hardware failure, the downtime of up to 300 seconds creates a real problem
in the network.
The hw-modulemain-cpuqaerror-recovery command has been created to enable a recovery mechanism for
a QA error by allowing the router to remove the duplicate buffer header from the queue that shows the problem
and requeue the buffer header. By using the QA error recovery, the downtime is reduced to less than one
second under lab conditions. Three QA errors caused by buffer headers are permitted before the router performs
a cbus complex and reloads all the line cards.
After three QA errors caused by duplicate queued buffer headers occur, the cbus complex is initiated and the
line cards reload. Other QA errors, such as a null buffer header on any queue, can occur. Recovery is not
possible in these cases, and the QA error triggers a cbus complex and subsequent line-card reloads. The QA
error condition is specific to the Cisco 7500 series routers.
Cisco IOS Interface and Hardware Component Command Reference
462
F through H
hw-module main-cpu qa error-recovery
Examples The following example shows how to enable the QA error recovery mechanism when a Cisco IOS
Release 12.0(24)S1 image is used on a Cisco 7500 series router. In all other supported releases, the
QA error recovery mechanism is enabled by default.
Router(config)# hw-module main-cpu qa error-recovery
Related Commands Command Description
show controllers cbus Displays information about the cBus controller card.
Cisco IOS Interface and Hardware Component Command Reference
463
F through H
hw-module mode
hw-module mode
To configure the interface module from 10G to 5G mode, use the hw-module mode command in global
configuration mode.
hw-module slot / bay PIDmode mode
Syntax Description Syntax Description:
slot Physical slot number of the interface
bay Bay of the interface
PID Part number of the interface modules
mode Option to select the mode of the interface module
mode Selected mode of the Interface Module, for example
5G_CEM.
Command Default Default is 10G mode
Command Modes Global configuration
Command History Release Modification
XE Everest This command was introduced into the Cisco NCS 4200 Series and Cisco ASR 900 Series
16.5.1 Routers.
Usage Guidelines We recommend that you remove all the configurations before configuring 5G mode for the interface module.
Do not use the mode keyword if you want to configure 10G mode.
Note Only 4-port-only mode is supported on the 8-port 10 Gigabit Ethernet Interface Module (8x10GE) interface
module.
Examples The following example shows how to configure configure 5G mode from 10G mode:
enable
configure terminal
platform hw-module configuration
hw-module 0 / 3 PID mode 5G_CEM
end
The following example shows the configuration of 8-port 10 Gigabit Ethernet Interface Module
(8x10GE) interface module:
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Cisco IOS Interface and Hardware Component Command Reference
464
F through H
hw-module mode
Router(config)# platform hw-module configuration
Router(conf-plat-hw-conf)# hw-module 0/3 A900-IMA8Z mode ?
4-ports-only Four Ports
Router(conf-plat-hw-conf)#hw-module 0/3 A900-IMA8Z mode 4-ports-only
Interface configs would be defaulted before mode change?? [yes/no]: yes
Related Commands Command Description
show running-config | include mode Verifies if the interface module is configured in 5G mode.
Cisco IOS Interface and Hardware Component Command Reference
465
F through H
hw-module oversubscription
hw-module oversubscription
To administratively disable the oversubscribed ports (3, 4, 7, and 8) on a module, use the
hw-moduleoversubscription command. Use the no form of this command to enable the oversubscribed ports.
hw-module module num oversubscription
no hw-module module num oversubscription
Syntax Description module Applies the command to a specific module.
num
Command Default Oversubscription is enabled by default.
Command Modes Global configuration
Command History Release Modification
12.2(18)ZY Support for this command was introduced (Cisco 76700 series router).
12.2(18)SXF5 Support for this command was intruduced (Catalyst 6500 series switch).
Usage Guidelines This command is supported on the WS-X6708-10G-3C and the WS-X6708-10G-3CXL modules only.
When you disable the oversubscribed ports, the port is put into shutdown mode. In this mode, you cannot
enter the noshut command on the disabled ports. If you attempt to enter the noshut command on the disabled
ports, this message appears:
The current module is operating in non-oversubscription mode. To utilise this interface,
enable oversubscription mode for the module.
When you enter the showinterfaces command on the disabled ports, the output displays “disabled for
performance” to distinguish between the normal port shutdown and the shutdown for performance.
Examples This example shows how to administratively disable the oversubscribed ports on a module:
Router #
hw-module module 3 oversubscription
Router #
This example shows how to administratively enable the oversubscribed ports on a module:
Router #
no hw-module module 3 oversubscription
Router #
Related Commands Command Description
show interfaces Displays traffic that is seen by a specific interface.
Cisco IOS Interface and Hardware Component Command Reference
466
F through H
hw-module power-supply power-cycle
hw-module power-supply power-cycle
To power cycle the power supplies, use the hw-modulepower-supplypower-cyclecommand in privileged
EXEC mode.
hw-module power-supply {1|2} power-cycle
Syntax Description 1 | 2 Specifies the power supply to power cycle.
Command Default This command has no default settings.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(18)SXF Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines If you have redundant power supplies and you power cycle one of the power supplies, only that power supply
is power cycled. If you power cycle both power supplies, the system goes down and comes back up in 10
seconds.
If you only have one power supply and you power cycle that power supply, the system goes down and comes
back up in 10 seconds.
This command works only on routers with an 8700 watt power supply.
Examples This example shows how to power cycle a power supply:
Router# hw-module power-supply 2 power-cycle
Power-cycling the power supply may interrupt service.
Proceed with power-cycling? [confirm]
Power-cycling power-supply 1
22:10:23: %C6KPWR-SP-2-PSFAIL: power supply 1 output failed.
22:10:25: %C6KENV-SP-4-PSFANFAILED: the fan in power supply 1 has failed
22:10:33: %C6KPWR-SP-4-PSOK: power supply 1 turned on.
22:10:33: %C6KENV-SP-4-PSFANOK: the fan in power supply 1 is OK
Router#
Cisco IOS Interface and Hardware Component Command Reference
467
F through H
hw-module pxf stall-monitoring
hw-module pxf stall-monitoring
To enable the parallel express forwarding (PXF) stall monitor on the Cisco 10000 series router, and configure
the default threshold values for resetting the line card (LC) and the Hyper Transport Data Protocol (HTDP),
use the hw-modulepxfstall-monitoringcommand in the global configuration mode. To disable the PXF stall
monitor, use the no form of this command.
hw-module pxf stall-monitoring [{HT-Reset threshold-value|LC-Reset threshold-value}]
no hw-module pxf stall-monitoring [{HT-Reset threshold-value|LC-Reset threshold-value}]
Syntax Description HT-Reset threshold-value Specifies the threshold value for HTDP reset. The valid value ranges from 4
to 6. By default, the threshold value is set to 3.
LC-Reset threshold-value Specifies the threshold value for LC reset. The valid value ranges from 4 to
6. By default, the threshold value is set to 3.
Command Default None
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)XNE This command was introduced.
Usage Guidelines Initially, use the hw-modulepxfstall-monitoringcommand to enable the PXF stall monitor on the Cisco
10000 series router. Then use the hw-modulepxfstall-monitoringcommand again, to configure the threshold
values of LC and HTDP reset.
Examples The following example shows how to enable the PXF stall monitor, and configure the threshold
values of LC and HTDP reset, using the hw-modulepxfstall-monitoringcommand.
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# hw-module pxf stall-monitoring
Router(config)# hw-module pxf stall-monitoring HT-Reset 5
Router(config)# hw-module pxf stall-monitoring LC-Reset 4
Related Commands Command Description
show pxf stall-monitoring Displays the current configuration and the operating status of the PXF stall
monitor.
Cisco IOS Interface and Hardware Component Command Reference
468
F through H
hw-module reset
hw-module reset
To reset a module by turning the power off and then on, use the hw-module reset command in privileged
EXEC mode.
hw-module module num reset
Syntax Description module num Applies the command to a specific module; see the “Usage Guidelines” section for valid values.
Command Default This command has no default settings.
Command Modes Privileged EXEC
Command History Release Modification
12.2(14)SX This command was introduced on the Supervisor Engine 720.
12.2(17d)SXB This command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2 This command was integrated into Cisco IOS 12.2(31)SB2.
Usage Guidelines The num argument designates the module number. Valid values depend on the chassis that is used. For example,
if you have a 13-slot chassis, valid values for the module number are from 1 to 13.
Examples This example shows how to reload a specific module:
Router#
hw-module module 3 reset
Cisco IOS Interface and Hardware Component Command Reference
469
F through H
hw-module sec-cpu reset
hw-module sec-cpu reset
To reset and reload the standby Route Switch Processor (RSP) with the specified Cisco IOS image and to
execute the image, use the hw-modulesec-cpureset command in privileged EXEC mode.
hw-module sec-cpu reset
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.0(16)ST This command was introduced.
12.0(19)ST1 This command was enabled in privileged EXEC mode.
12.0(22)S This command was integrated into Cisco IOS Release 12.0(22)S.
12.2(4)XF This command was integrated into Cisco IOS Release 12.2(4)XF on the Cisco uBR10012
router.
12.2(14)S This command was integrated into Cisco IOS Release 12.2(14)S.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2 This command was integrated into Cisco IOS Release 12.2(31)SB2.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Before using this command, you must use the hw-moduleslotimageglobal configuration command to specify
a high availability Cisco IOS image to run on the standby RSP. After the high availability image is loaded in
the active RSP, use the hw-modulesec-cpureset command to reset and reload the standby RSP with the
specified Cisco IOS image and to execute the image. To load the standby RSP with the default micro-IOS
software contained in the active RSP image instead of a high availability Cisco IOS image, use the no form
of the hw-moduleslotimage command followed by the hw-modulesec-cpuresetcommand.
Examples The following example shows a Cisco 7513 router with the standby RSP loaded in slot 7. The standby
RSP is reset and reloaded with the rsp-pv-mz high availability Cisco IOS image. Both RSPs have
slot 0 flash memory cards.
Router(config)# hw-module slot 7 image slot0:rsp-pv-mz
Router(config)# end
Router# hw-module sec-cpu reset
Cisco IOS Interface and Hardware Component Command Reference
470
F through H
hw-module sec-cpu reset
Related Commands Command Description
hw-module slot image Specifies a high availability Cisco IOS image to run on an active or standby RSP.
Cisco IOS Interface and Hardware Component Command Reference
471
F through H
hw-module shutdown
hw-module shutdown
To shut down the module, use the hw-module shutdown command in privileged EXEC mode.
hw-module module num shutdown
Syntax Description module num Applies the command to a specific module; see the “Usage Guidelines” section for valid values.
Command Default This command has no default settings.
Command Modes Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is supported on the SSL Services Module and the NAM.
If you enter the hw-module shutdowncommand to shut down the module, you will have to enter the no power
enable module command and the power enable module command to restart (power down and then power
up) the module.
Examples This example shows how to shut down and restart the module:
Router# hw-module module 3 shutdown
Router# no power enable module 3
Router# power enable module 3
Cisco IOS Interface and Hardware Component Command Reference
472
F through H
hw-module simulate link-up
hw-module simulate link-up
To enable softlink on a specified module, use the hw-modulesimulatelink-upcommand in privileged EXEC
mode. For information on disabling softlink, refer to the “Usage Guidelines” section.
hw-module module num simulate link-up
Syntax Description module Applies the command to a specific module; see the “Usage Guidelines” section for valid values.
num
Command Default This command has no default settings.
Command Modes Privileged EXEC
Command History Release Modification
12.2(18)SXD Support for this command was introduced on the Supervisor Engine 720 and the Supervisor
Engine 2.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is supported on Ethernet modules only.
To disable softlink on a module, you must perform one of the following procedures:
• Enter the shutdown and then the noshutdowncommands on all the ports on the module.
• Enter the hw-moduleresetcommand.
When you apply this command to a module, the port LEDs on the module will glow green and simulate a
link-up condition. This command can be used for testing interface configurations without cabling to the
interface.
The num argument designates the module number. Valid values depend on the chassis that is used. For example,
if you have a 13-slot chassis, valid values for the module number are from 1 to 13.
Examples This example shows how to enable softlink on a module:
Router# hw-module module 3 simulate link-up
Router#
Related Commands Command Description
hw-module reset Resets a module by turning the power off and then on.
Cisco IOS Interface and Hardware Component Command Reference
473
F through H
hw-module slot
hw-module slot
T o enable the router shelf to restart a stopped Dial Shelf Controller (DSC) card, to stop a DSC card, or to
cause a shutdown, reset, or reload of any specified dial shelf feature board, use the hw-moduleslotcommand
in privliged EXEC mode and global configuration mode.
hw-module slot shelf-id/slot-number {reload|reset|shutdown {powered|unpowered}
[dual-wide]|start|stop}
Syntax Description shelf-id Number of the dial shelf. The default number for the dial shelf is 1.
/ slot-number Number of the slot in the shelf where the target feature board or DSC is installed. If the
start or stop keyword is used, the slot number must be either 12 or 13, because these
keywords apply only to DSCs.
reload Enables a remote reload of an individual feature board without having to use manual online
insertion and removal (OIR).
reset Resets a feature board.
shutdown Shuts down a feature board.
powered Shuts down the DSC and all of its interfaces and leaves them in an administratively down
state with power enabled.
unpowered Shuts down the DSC and all of its interfaces and leaves them in an administratively down
state without power.
dual-wide (Optional) Specifies the dual-wide port adapter (PA).
start Restarts the specified DSC.
stop Stops the specified DSC.
Command Default Shuts down the DSC and all of its interfaces and leaves them in an administratively down state with power
enabled.
Command Modes Global configuration (config) Privileged EXEC (#)
Command History Release Modification
11.3(6)AA The hw-module command was introduced.
12.1 • The hw-module command was expanded to become the hw-moduleslotcommand.
• The reload keyword was added to enable a remote reload of a feature board.
12.3(2)T Theresetand shutdown keywords were added.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Cisco IOS Interface and Hardware Component Command Reference
474
F through H
hw-module slot
Release Modification
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
12.2(31)SB This command was integrated into Cisco IOS Release 12.2(31)SB.
12.2(33)SB This command’s behavior was modified on the Cisco 10000 series router for the PRE3 and
PRE4, and the reload option was introduced on the router.
15.0(1)M This command was modified. The command became available in global configuration mode.
The powered, unpowered, and dual-wide keywords were added.
Usage Guidelines The stop form of this command is issued from the router shelf console instead of by pressing the attention
(ATTN) button on the target DSC. Confirmation of when the start or stop took place is displayed. Warnings
are issued and confirmation input is required if a stop command will result in a loss of service when backup
functionality is not available.
When a DSC card is stopped, removed, and then reinstalled, there is no need to restart the card (whether the
card is the original or a replacement) because a freshly installed card reboots as the backup DSC automatically.
However, if a DSC is stopped, either by using the ATTN button or by issuing the hw-moduleslotstop command,
it must be restarted by using the start form of the same command, or the DSC must be removed and reinstalled
in order to reboot.
Press the ATTN button on the DSCs to shut down a card manually before removing the card. This is equivalent
to issuing an hw-moduleslot command for that card at the router command prompt. Use the ATTN button to
shut down the card before it is swapped out or tested in place, or to restart it, if the card has not been removed
after having been shut down.
Tip The hw-module slot shelf-id/slot-numberreload form of this command is useful for simulating an OIR event
in the case of a feature board failure when physical access to the feature board card is restricted.
Entering the hw-module slot shelf-id/slot-numberreloadcommand initiates the feature board reload process
through power cycling. The hw-module slot shelf-id/slot-numberreload command cannot be used to reload
DSCs.
Use the reset form of this command to reset the specified feature card and drop all active calls.
Use the shutdown form of this command to shut down the specified feature card and drop all active calls.
Cisco 10000 Series Router Usage Guidelines,
In Cisco IOS Release 12.2(33)SB, when you enter the hw-moduleslotslot-numberreset command, the software
asks you to confirm the command.
In Cisco IOS Release 12.2(31)SB, the software does not ask you to confirm the hw-moduleslotslot-numberreset
command.
Examples The following example shows how to stop the DSC in slot 13 and start the other DSC in slot 12
(which was previously stopped):
Router# hw-module slot 1/13 stop
Router# hw-module slot 1/12 start
Cisco IOS Interface and Hardware Component Command Reference
475
F through H
hw-module slot
The following example shows how to reload the dial shelf feature board in slot 6:
Router# hw-module slot 1/6 reload
The following example shows how to reset the card in slot 3:
Router# hw-module slot 1/3 reset
The following example shows how to shut down the PRE card located in slot 3:
Router# hw-module slot 1/3 shutdown powered
Related Commands Command Description
debug redundancy Displays information used for troubleshooting dual (redundant) DSC cards.
show redundancy Displays current or historical status and related information on dual (redundant) DSC
cards.
Cisco IOS Interface and Hardware Component Command Reference
476
F through H
hw-module slot (6500)
hw-module slot (6500)
To enable ports on a module, use the hw-moduleslot command. To disable ports on a module, use the no
form of this command.
hw-module slot num {clear-block|oversubscription} [port-group num]
no hw-module slot num {clear-block|oversubscription} [port-group num]
Syntax Description slot num Applies the command to a specific module.
clear-block Drops the packets that are destined for jammed ports and continues delivering the packets
for other ports.
oversubscription Administratively disables the oversubscribed ports on a module. To enable oversubscription,
use the no form of this command.
port-group num (Optional) Applies the command to a specific port group on the module. The range depends
on the module type.
Command Default The default settings are as follows:
• Clear block is enabled by default.
• Oversubscription is enabled by default.
Command Modes Global configuration
Command History Release Modification
12.2(18)SXF5 Support for this command was introduced (Catalyst 6500 series switch).
12.2(33)SXH1 Support for these keywords and arguments were introduced:
• clear-block [ port-group num
• oversubscription [ port-group num
12.2(33)SXH2 This command was changed to support the following modules:
• WS-X6716-10G-3C
• WS-X6716-10G-3CXL
Usage Guidelines This command is supported on the following modules:
• WS-X6708-10G-3C--The port-group num and the clear-block keywords and argument are not supported.
• WS-X6708-10G-3CXL--The port-group num and the clear-block keywords and argument are not
supported.
• WS-X6716-10G-3C
Cisco IOS Interface and Hardware Component Command Reference
477
F through H
hw-module slot (6500)
• WS-X6716-10G-3CXL
When you disable the oversubscribed ports, the port is put into shutdown mode. In this mode, you cannot
enter the noshut command on the disabled ports. If you enter the noshut command on the disabled ports, this
message appears:
The current module is operating in non-oversubscription mode. To utilise this interface,
enable oversubscription mode for the module.
When you enable oversubscription for a port group, the port group is in mux mode. When you disable
oversubscription, the port group is in transparent mode. When a group is in transparent mode, the first port
in the group retains its administrative status and the remaining three ports are administratively shut down.
You cannot enter the shut, and then the noshut commands on the disabled ports. You can enter the shut, and
then the noshut commands on the enabled port in the group.
The port-group mappings for the WS-X6716-10G-3C and the WS-X6716-10G-3CXL modules are as follows:
• Group 1--Ports 1 to 4. Port 1 is enabled in transparent mode.
• Group 2--Ports 5 to 8. Port 5 is enabled in transparent mode.
• Group 3--Ports 9 to 12. Port 9 is enabled in transparent mode.
• Group 4--Ports 13 to 16. Port 13 is enabled in transparent mode.
For the WS-X6716-10G-3C and the WS-X6716-10G-3CXL modules in transparent mode, ports 2, 3, 4, 6, 7,
8, 10, 11, 12, 14, 15, 16 are disabled.
If you specify a slot number without a group number, all four groups are put into transparent/mux mode.
You cannot put the port group into oversubscription mode when any port in the port group is configured as
a virtual switch link (VSL). A warning message is displayed asking you to disable the VSL link before changing
to oversubscription mode.
When you enter the showinterfaces command on the disabled ports, the output displays “disabled for
performance” to distinguish between the normal port shutdown and the shutdown for performance.
Each 4-port group shares a common packet queue. If head-of-line blocking is enabled and one port of the four
ports receives a pause frame, all packets are blocked behind this packet until the packet is delivered to the
flow-controlled port. You can enter the hw-moduleslotclear-block [ port-group num] command to drop the
packets that are destined for the jammed port and continue to deliver the packets for other ports.
Examples This example shows how to administratively disable the oversubscribed ports on a module:
Router#
no hw-module slot 3 oversubscription
Router#
This example shows how to administratively disable the oversubscribed ports on a specific port
group:
Router#
no hw-module slot 3 oversubscription port-group 4
Router#
This example shows how to administratively enable the oversubscribed ports on a module:
Cisco IOS Interface and Hardware Component Command Reference
478
F through H
hw-module slot (6500)
Router#
hw-module slot 3 oversubscription
Router#
This example shows how to drop the packets that are destined for the jammed port and continue to
deliver the packets for other ports:
Router#
hw-module slot 3 clear-block port-group 4
Router#
Related Commands Command Description
show interfaces Displays traffic that is seen by a specific interface.
show hw-module slot Displays information for a SPA interface processor (SIP) or other module.
Cisco IOS Interface and Hardware Component Command Reference
479
F through H
hw-module slot (7300)
hw-module slot (7300)
To prepare a line card, MSC, or PCI port adapter carrier card for online removal, use thehw-moduleslot
command in privileged EXEC mode.
hw-module slot slot-number {stop|start}
Syntax Description slot-number Specifies the slot number of the line card, MSC, or PCI port adapter carrier card.
stop Stops traffic, turns on the OIR LED, shuts down all interfaces, and deactivates the line card,
MSC, or PCI port adapter carrier card.
start Restarts the line card and shuts off the OIR LED, putting the hardware back online.
Command Default No default behavior or values.
Command Modes Privileged EXEC
Command History Release Modification
12.1(9)EX This command was enabled on the Cisco 7304 router.
12.2(18)S This command was introduced on Cisco 7304 routers running Cisco IOS Release 12.2(18)S.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use the hw-moduleslotslot-numberstopcommand to stop traffic, turn on the green OIR LED, and shut down
all interfaces to remove a line card, MSC, or PCI port adapter carrier card from the Cisco 7304 router without
disrupting data flow. You should not remove hardware while traffic is still running.
The stop keyword stops traffic through interfaces and deactivates the hardware. When the OIR LED turns
green, the hardware has been deactivated and can be physically removed.
The hw-moduleslotslot-numberstartcommand restarts the line card, MSC, or PCI port adapter carrier card
and shuts off the OIR LED, putting the card back online.
Use the hw-moduleslotslot-numberstartcommand if you issue the hw-moduleslotslot-numberstop command,
did not remove the hardware, and now want to reactivate it. If you remove and then reinsert the hardware, the
hardware restarts without this command.
This command cannot be used for online removal of SPAs. For online removal of SPAs, use the
hw-modulesubslot command.
You can also use thiscommand to restore a line card, MSC, or PCI port adapter carrier card that has been
deactivated due to some failure.
Cisco IOS Interface and Hardware Component Command Reference
480
F through H
hw-module slot (7300)
Note Line cards, MSCs, and PCI port adapter carrier cards are automatically initialized after being inserted or after
a system bootup. You do not need to issue thehw-moduleslotslot-numberstart command.
Examples The following example shows how to deactivate the line card, MSC, or PCI port adapter carrier card
in slot 2. After entering this command and the green OIR LED turns on, you can remove the hardware
and insert a new piece of hardware:
Router# hw-module slot 2 stop
The following example shows how to reactivate a line card, MSC, or PCI port adapter carrier card
in slot 2. You only need to enter this command if you enter the hw-moduleslot slot-numberstop
command but do not remove the hardware and instead want to restart the hardware.
Router# hw-module slot 2 start
Related Commands Command Description
hw-module subslot Prepares a SPA for online removal.
show c7300 Displays the types of cards (NSE and line cards) installed in a Cisco 7304 router.
show diag Displays hardware information for any slot or the chassis.
show c7300 errorlog Displays error information on a Cisco 7304 series router.
show platform errorlog Displays error information for any installed card.
Cisco IOS Interface and Hardware Component Command Reference
481
F through H
hw-module slot (7600)
hw-module slot (7600)
To enable ports on a module, use the hw-module slot command in global configuration mode. To disable
the ports, use the no form of this command.
hw-module slot slot-number {memory test full|oversubscription|pos|process-max-time
number-of-seconds|rate-limit {fsol_rate fsol-rate|punt_rate punt-packet-rate}|srp|subslot subslot-number
only|mp-recovery-enable |ipv6-hbh-rl rate }
no hw-module slot slot-number {memory test full|oversubscription|pos|process-max-time
number-of-seconds|rate-limit {fsol_rate fsol-rate|punt_rate punt-packet-rate}|srp|subslot subslot-number
only|mp-recovery-enable |ipv6-hbh-rl rate }
Syntax Description slot-number Chassis slot number.
memory Specifies the memory settings of a module.
test Specifies the memory options available for testing.
full Performs a complete memory test on the Lower Circuit (LC).
oversubscription Administratively disables the oversubscribed ports on a module.
pos Converts a module to packet-over-SONET (POS) mode.
process-max-time Specifies the maximum time for which the process runs before it stops the
processor.
number-of-seconds Number of milliseconds before the processor suspends voluntarily.
rate-limit Limits the packets that are sent to the Route Processor (RP).
fsol_rate fsol-rate Limits the broadband and Ethernet Flow Point (EFP) First Sign of Life
(FSOL) packets, in bits per second (b/s). The default is 40000 b/s (or 50
packets per second for a 100-byte packet).
• This keyword is specific to the ES+ line card.
punt_rate punt-packet-rate Limits the Layer 4 and Port-Bundle Host Key (PBHK) packets, in bits per
second (b/s). The default is 1000000 b/s.
• This keyword is specific to the ES+ line card.
srp Converts a module to Spatial Reuse Protocol (SRP) mode.
subslot slot-number only Specifies the secondary slot number to enable a slot to support a single Shared
Port Adapter (SPA).
mp-recovery-enable Enables metropolis stuck recovery. This option is enabled by default. Use
the no form to disable this option.
Cisco IOS Interface and Hardware Component Command Reference
482
F through H
hw-module slot (7600)
ipv6-hbh-rl rate Specifies the policing rate-limit for the IPv6 Hop-by-Hop extension header
packets.
• For the SIP-400, you can configure a rate of up to 25600 packets per
second (PPS). The default police rate is 21.36 kpps.
• For the ES+ line cards, you can configure a rate of up to 100000 kbps.
The default police rate is 12000 kbps.
Command Default Ports are not enabled on a module.
Command Modes Global configuration (config)
Command History Release Modification
15.1(1)S This command was introduced.
15.2(4)S This command was modified. The mp-recovery-enable keyword was
added.
12.2(33)SRE6 This command was integrated into Cisco IOS Release 12.2(33)SRE6.
12.2(33)SRE7 This command was modified. The mp-recovery-enable keyword was
added.
15.3(1)S This command was modified. The ipv6-hbh-rl keyword was added.
Usage Guidelines • The FSOL queue is used by broadband FSOL and EFP FSOL.
• The punt queue is used by Layer 4 and PBHK packets.
• An increase in the number of either FSOL or punt rate limiters enables more packets to reach the RP.
This increase exerts more load on the RP CPU. Therefore, changing the default values of either FSOL
or punt rate limiters is not recommended.
• On the ES+ line cards, setting the police rate to 0 turns off the policing. On the SIP-400, the policing
does not stop but all the packets are dropped.
• For both the ES+ line cards and the SIP-400, when the policer is set from the line card console, the setting
remains effective even if the line card is moved to another chassis running the Cisco IOS Release 15.3(1)S
or later images.
• For the SIP-400, IPv6 HBH packets continue to go through the QoS policing configured on the line card.
For the ES+ line cards, IPv6 HBH packets bypass any QoS policing configured on the line card.
Examples The following example shows how to set the FSOL rate to 50000 b/s:
Device(config)# hw-module slot 2 rate-limit fsol_rate 50000
The following example shows how to set the punt rate to 70000 b/s:
Device(config)# hw-module slot 2 rate-limit punt_rate 70000
Cisco IOS Interface and Hardware Component Command Reference
483
F through H
hw-module slot (7600)
The following example shows how to set the rate limit for the IPv6 Hop-by-Hop extension header
packets to 777 kbps:
Device(config# hw-module slot 2 ipv6-hbh-rl 777
Related Commands Command Description
show hw-module slot Displays system information for a SPA interface processor (SIP) or a module.
Cisco IOS Interface and Hardware Component Command Reference
484
F through H
hw-module slot (ASR 1000 Series)
hw-module slot (ASR 1000 Series)
To start, stop, reload, or enable logging for an Embedded Services Processor (ESP), Route Processor (RP),
or Shared Port Adapter (SPA) Interface Processor (SIP) on a Cisco ASR 1000 Series Aggregation Services
Router, use the hw-moduleslot command in privileged EXEC or global configuration or diagnostic mode.
hw-module slot slot action
Syntax Description slot Slot on which logging action is to be taken. Options are as follows:
• number --the number of the SIP slot.
• f0 --The ESP in ESP slot 0.
• f1 --The ESP in ESP slot 1
• r0 --The RP in RP slot 0.
• r1 --The RP in RP slot 1.
action The action to take on the hardware in the specified slot. Options are as follows:
• logging onboard [disable| enable] --Disables or enables onboard logging of the
hardware.
• reload --Reloads the specified hardware.
• start --Starts the hardware if it has been stopped.
• stop --Stops the hardware if it is currently active.
Command Default The router sends and receives traffic by default, so this command is not necessary to enable any hardware on
a router. Onboard logging for all of the hardware is enabled by default.
Command Modes Diagnostic (diag) Privileged EXEC (#) Global configuration (config)
Command History Release Modification
Cisco IOS XE Release 2.1 This command was introduced.
Usage Guidelines The hw-moduleslot command does not have a no form.
To start, stop, or reload a SPA, use the hw-modulesubslotcommand.
The stop and reload options cannot be used on an active RP.
All traffic to hardware that has been set to stop using the stop option will be dropped until the hardware is
reenabled by either physically removing and reinserting the hardware, or entering the start option. After the
hardware is modified as appropriate or the start option is entered, the hardware has to reinitialize before it is
able to send and receive traffic. Note that in some cases reinitialization can take several minutes, and that the
reinitialization time required depends on the hardware and the system configuration.
Cisco IOS Interface and Hardware Component Command Reference
485
F through H
hw-module slot (ASR 1000 Series)
When a SIP is stopped, all traffic to all SPAs in the SIP is dropped. The SPAs in the SIP can begin receiving
traffic after the SIP is restarted using the start option and all SPAs and the SIP finish reinitializing.
Since this is a privileged EXEC-level command, this command setting cannot be saved to the startup
configuration and therefore the command setting cannot be maintained after a system reload. If you want the
hardware to stay in the stop state across system reloads, use the hw-moduleslotslotshutdown global
configuration command.
The reload option can be used to reload hardware for any reason; for example, to finish a software upgrade
that requires reloading of the hardware or to reload the hardware as part of a troubleshooting step.
The contents of onboard logging logs can be displayed using the showloggingonboardslot privileged EXEC
and diagnostic mode commands.
Enter the showloggingonboardslotslotstatus privileged EXEC or diagnostic command to see if onboard
logging is enabled or disabled for the hardware in a particular slot.
When the hw-moduleslotslotloggingonboarddisable command is entered, onboard logging for the specified
hardware component is disabled but the existing logs are preserved; if you want to erase the existing logs,
enter the clearloggingonboardslot command.
When the hw-moduleslot command is entered in global configuration mode (for ESP40 and SIP40 cards),
you have a link option that allows you to choose among a set of backplane enhanced serializer/deserializer
(SerDes) interconnect (ESI) links between ESP and a given SIP slot. The range of possible values for the link
depends on the type of ESP and SIP cards. Only a combination of ESP40 and SIP40 cards can have more than
two ESI links (link A and link B). All other cards have only link A. For example, a combination of ESP40
and SIP10 or ESP20 and SIP40 cards can have only one link (link A).
Examples The following example shows how to stop the RP in RP slot 0:
Router# hw-module slot r0 stop
The following example shows how to disable the onboard logging for the RP in RP slot 0. The output
of the showloggingonboardslotr0statuscommand is given both before and after onboard logging
is disabled to verify that onboard logging was properly disabled.
Router# show logging onboard slot r0 status
Status: Enabled
Router# hw-module slot r0 logging onboard disable
Router# show logging onboard slot r0 status
Status: Disabled
The following example shows how to display the available link options for ESP40 and SIP40 cards:
Router(config)# hw-module slot 0 qos input link ?
A ESI Link A
B ESI Link B
Related Commands Command Description
clear logging onboard slot Clears the data in an onboard slot log.
hw-module subslot Starts, stops, or reloads a SPA.
Cisco IOS Interface and Hardware Component Command Reference
486
F through H
hw-module slot (ASR 1000 Series)
Command Description
show logging onboard slot Displays the status of onboard logging, or the contents of an onboard logging
log.
Cisco IOS Interface and Hardware Component Command Reference
487
F through H
hw-module slot image
hw-module slot image
To specify a high availability Cisco IOS image to run on an active or standby Route Switch Processor (RSP),
use the hw-moduleslotimage command in global configuration mode. To remove a high availability Cisco
IOS image from the running configuration, use the no form of this command.
hw-module slot slot-number image file-spec
no hw-module slot slot-number image file-spec
Syntax Description slot-number Specifies the number of the RSP slot.
file-spec Specifies the flash memory card location to load the image into and the name of the image.
Command Default No high availability Cisco IOS images are specified to run on the active or standby RSPs.
Command Modes Global configuration
Command History Release Modification
12.0(16)ST This command was introduced.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T.
Examples The following example shows a Cisco 7513 router with the active RSP loaded in slot 6 and the
standby RSP loaded in slot 7. The rsp-pv-mz high availability Cisco IOS image is specified to run
on both the active and the standby RSP. Both RSPs have slot 0 flash memory cards.
Router(config)# hw-module slot 6 image slot0:rsp-pv-mz
Router(config)# hw-module slot 7 image slot0:rsp-pv-mz
Related Commands Command Description
hw-module sec-cpu reset Resets and reloads the standby RSP with the specified Cisco IOS image and
executes the image.
mode (HSA redundancy) Configures the redundancy mode.
redundancy Enters redundancy configuration mode.
Cisco IOS Interface and Hardware Component Command Reference
488
F through H
hw-module slot subslot only
hw-module slot subslot only
Note This command is deleted effective with Cisco IOS Release 12.2SXI.
To change the mode of the Cisco 7600 SSC-400 card to allocate full buffers to the specified subslot, use the
hw-moduleslotsubslotonly command in global configuration mode. If this command is not used, the total
amount of buffers available is divided between the two subslots on the Cisco 7600 SSC-400.
Note This command automatically generates a reset on the Cisco 7600 SSC-400. See Usage Guidelines below for
details.
hw-module slot slot subslot subslot only
Syntax Description slot Chassis slot number where the Cisco 7600 SSC-400 is located. Refer to the appropriate hardware
manual for slot information. For SIPs and SSCs, refer to the platform-specific SPA hardware
installation guide or the corresponding “Identifying Slots and Subslots for SIPs and SPAs” topic
in the platform-specific SPA software configuration guide.
subslot Secondary slot number on the SSC where the IPSec VPN SPA is installed.
Command Default No default behavior or values.
Command Modes Global configuration mode
Command History Release Modification
12.2(18)SXF2 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
12.2SXI This command was deleted.
Usage Guidelines Follow these guidelines and restrictions when configuring a Cisco 7600 SSC-400 and IPSec VPN SPAs using
the hw-moduleslotsubslotonlycommand:
• This command is useful when supporting IP multicast over GRE on the IPSec VPN SPA.
• When this command is executed, it automatically takes a reset action on the Cisco 7600 SSC-400 and
issues the following prompt to the console:
Module n will be reset? Confirm [n]:
Cisco IOS Interface and Hardware Component Command Reference
489
F through H
hw-module slot subslot only
The prompt will default to “N” (no). You must type “Y” (yes) to activate the reset action.
• When in this mode, if you manually plug in a second SPA, or if you attempt to reset the SPA (by entering
a nohw-modulesubslotshutdown command, for example), a message is displayed on the router console
which refers you to the customer documentation.
Examples The following example allocates full buffers to the SPA that is installed in subslot 0 of the SIP located
in slot 1 of the router and takes a reset action of the Cisco 7600 SSC-400.
Router(config)# hw-module slot 4 subslot 1 only
Module 4 will be reset? Confirm [no]: y
Note that the prompt will default to “N” (no). You must type “Y” (yes) to activate the reset action.
Related Commands Command Description
ip multicast-routing Enables IP multicast routing.
ip pim Enables Protocol Independent Multicast (PIM) on an interface.
Cisco IOS Interface and Hardware Component Command Reference
490
F through H
hw-module standby
hw-module standby
To reset the standby Route Processor (RP), use the hw-modulestandbycommand in privileged EXEC mode.
hw-module standby {reset|reload}
Syntax Description reset Resets the redundant RP.
reload Reloads the redundant RP.
Command Default No default behavior or values.
Command Modes Privileged EXEC
Command History Release Modification
12.1(10)EX2 This command was introduced.
12.2(18)S This command was introduced on Cisco 7304 routers running Cisco IOS Release 12.2(18)S.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use this command to reset or reload the standby RP. Use the reload keyword to cause the standby RP to
reload with an upgraded image. Use this option when the standby RP is operating normally. Use the
resetkeyword for a hard reset of the standby RP. Use this option if the standby RP is experiencing problems
and does not respond to the reload option.
Examples The following example shows how to reset the standby RP (NSE-100):
Router# hw-module standby reset
Proceed with reset of standby NSE? [confirm]y
The following example shows an attempt to reset a standby RP, which is down or experiencing some
other problem such as being hung.
Router# hw-module standby reload
Proceed with reload of standby NSE? [confirm]y
%Standby RP is not up
If there is a failure to reset a standby RP because it is in some fault condition, try performing a reload
of the RP.
The following example shows how to reload the standby RP:
Router# hw-module standby reload
Proceed with reload of standby NSE? [confirm]y
Cisco IOS Interface and Hardware Component Command Reference
491
F through H
hw-module standby
Related Commands Command Description
debug redundancy Enables RP redundancy debugging.
redundancy force-switchover Forces the standby RP to assume the role of the active RP.
show c7300 Displays the types of cards (RP and line cards) installed in a Cisco 7304
router.
show redundancy Displays redundancy information for the active and standby RPs.
Cisco IOS Interface and Hardware Component Command Reference
492
F through H
hw-module subslot
hw-module subslot
To restart, stop, or start a shared port adapter (SPA) and its interfaces, use the hw-modulesubslotcommand
in privileged EXEC mode.
hw-module subslot slot/subslot {reload [force]|start|stop [force]}
For ASR 900 Series Routers, hw-module slot / subslot [default | ether-mode 1G | ether-mode 10G]
Syntax Description
slot Physical slot number of the interface
subslot Subslot of the interface
default Default of all the interfaces of the interface module
ether-mode 1G Mode of the ethernet imterface module
ether-mode 10G Mode of the ethernet imterface module
Command Default The SPA and its interfaces are not started.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(25)S3 This command was introduced.
12.2(18)SXE This command was integrated into Cisco IOS Release 12.2(18)SXE on the
Cisco 7600 series router and Catalyst 6500 series switch.
12.0(31)S This command was integrated into Cisco IOS Release 12.0(31)S.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Cisco IOS XE Release 2.4 This commad was modified. The force keyword was added. This command
was integrated into Cisco IOS XE Release 2.4.
Cisco IOS XE 16.5.1 The keyword ether-mode 1G was introduced.
Everest
Usage Guidelines The hw-modulesubslot command stops and starts power to the SPA. This command is useful when you want
to restart all interfaces on a SPA. When the stop and reload keywords are used, you get a prompt to confirm.
Enter “y” or use the return key to confirm. Power to the SPA is now stopped or reloaded. If you use the force
keyword along with the reload keyword, you can proceed further without getting any prompt for confirmation.
The Excalibur and Ethernet Services cards do not have the reload option.
The command is recommended to restart a SPA under the following conditions:
• To restart a SPA after it has been powered off because of a failure.
• To recover from corrupted messaging between the Route Processor (RP) and the SIP.
Cisco IOS Interface and Hardware Component Command Reference
493
F through H
hw-module subslot
Examples The following command power cycles the SPA in subslot 1 of the SIP installed in chassis slot 1:
Router# hw-module subslot 1/1 reload
Proceed with reload of module? [confirm]
Related Commands Command Description
show hw-module subslot oir Displays the operational status of a SPA.
Cisco IOS Interface and Hardware Component Command Reference
494
F through H
hw-module subslot (4400)
hw-module subslot (4400)
To restart, stop, or start a module and its interfaces, use the hw-modulesubslot command in privileged EXEC
mode.
hw-module subslot slot/subslot {reload |start|stop }
Syntax Description reload Restarts the target subslot.
slot Specifies the chassis slot number where the module is installed.
Refer to the hardware installationg guide for more information on slots. For module and interfaces,
refer to the module-specific hardware installation guide.
start Activates the specified module.
stop Stops the specified module.
/ subslot Specifies the subslot number of the chassis where the module is installed.
Refer to the hardware installation guide for subslot information.
Command Default The modules and its interfaces are not activated.
Command Modes Privileged EXEC (#)
Command History Release Modification
Cisco IOS XE Release 3.9S This command was introduced.
Usage Guidelines The hw-module subslot command allows you to stop and start the power supply to a supported cisco services
or network interface module (NIM) on a Cisco 4400 Series Integrated Services Router (ISR). This functionality
is also referred as the online insertion and removal (OIR) and it is useful when you want to remove a module
from one of the subslots while another active module remains installed on your router.
Note If you are not planning to immediately replace a module, ensure that you install a blank filter plate in the
subslot.
The stop option allows you to gracefully deactivate a module and the module is rebooted when the start
command is executed. The reload option will stop or deactivate a specified module and restart it.
Examples The following command activates a module in subslot 1:
Router# hw-module subslot 1/1 start
Cisco IOS Interface and Hardware Component Command Reference
495
F through H
hw-module subslot (4400)
Related Commands Command Description
show hw-module subslot oir Displays the operational status of a module.
Cisco IOS Interface and Hardware Component Command Reference
496
F through H
hw-module subslot ethernet vlan unlimited
hw-module subslot ethernet vlan unlimited
To remove the restriction of a maximum of 8100 IEEE 802.1Q VLANs per Ethernet shared port adapter
(SPA), use the hw-modulesubslotethernetvlanunlimited command in global configuration mode. To disable
and return to a maximum limit of 8100 VLANs per SPA, use the no form of this command.
hw-module subslot slot/subslot ethernet vlan unlimited
no hw-module subslot slot/subslot ethernet vlan unlimited
Syntax Description slot / Specifies the chassis slot number where the SIP is installed.
subslot Specifies the slot of the SIP where the SPA is installed.
Command Default There is no default behavior or values. When this command is not configured, up to 8100 dot1q VLANs per
Ethernet SPA are supported.
Command Modes Global configuration (config)
Command History Release Modification
Cisco IOS XE Release 2.5 This command was introduced.
Usage Guidelines For any Ethernet SPA on the Cisco ASR 1000 Series aggregation services routers, the maximum number of
IEEE 802.1Q VLANs that can be configured per port is 4094. The default total maximum number of VLANs
per SPA is 8100.
The limit on this total maximum number of VLANs per SPA ( which means, the default of 8100 VLANs)
can be removed using the hw-modulesubslotethernetvlanunlimited command. However, the limit on the
maximum number of VLANs per Ethernet port or interface (i.e. 4094) still applies. Therefore, the new
maximum number of supported VLANs per SPA varies by the number of ports on the SPA multiplied by
4094. On the 5-Port Gigabit Ethernet SPA, you can configure up to 20,470 dot1q (or unambiguous QinQ)
VLANs. On an 8-Port Gigabit Ethernet SPA, you can configure up to 32752 dot1q (or unambiguous QinQ)
VLANs.
When the hw-modulesubslotethernetvlanunlimited command is configured, VLAN filtering, accounting,
and classification are no longer performed by the Ethernet SPA and all 802.1Q frames and QinQ frames are
processed by the Quantum Flow Processor (QFP) on the Cisco ASR1000 Series Router. Sending all of the
dot1q VLAN frames to the QFP (without filtering) may reduce the QFP packet switching performance.
The default classification of CoS bits 6-7 as high priority is still supported. However, other user-defined CoS
values for high and low priority classification using the plimqosinputmapcosqueue command are not supported
when this command is in use.
Examples The following example enables support for maximum per-port dot1q VLAN configuration for the
SPA located in the first subslot (0) of the SIP located in slot 1 of the Cisco ASR1000 Series Router:
Router(config)# hw-module subslot 1/0 ethernet vlan unlimited
Cisco IOS Interface and Hardware Component Command Reference
497
F through H
hw-module subslot ethernet vlan unlimited
Related Commands Command Description
show interfaces Displays statistics for all interfaces configured on the router.
Cisco IOS Interface and Hardware Component Command Reference
498
F through H
hw-module subslot (LAN WAN)
hw-module subslot (LAN WAN)
To configure the Cisco 1-Port 10 Gigabit Ethernet LAN/WAN-PHY Shared Port Adapter to run in either the
LAN mode or WAN mode, use the hw-modulesubslotslot/subslotenable{LAN|WAN}commandin Global
configuration mode.
hw-module subslot slot/subslot enable {LAN|WAN}
Syntax Description slot/subslot The slot and subslot number in which the Cisco 1-Port 10 Gigabit Ethernet LAN/WAN-PHY
Shared Port Adapter has been installed.
enable Enables the specified LAN or WAN operational mode on the SPA.
LAN Specifies the LAN mode of operation for theCisco 1-Port 10 Gigabit Ethernet LAN/WAN-PHY
Shared Port Adapter.
WAN Specifies the WAN mode of operation for the Cisco 1-Port 10 Gigabit Ethernet
LAN/WAN-PHY Shared Port Adapter.
Command Default By default, the Cisco 1-Port 10 Gigabit Ethernet LAN/WAN-PHY Shared Port Adapter operates in the WAN
mode when the SPA boots-up.
Command Modes Global configuration (config)
Command History Release Modification
Cisco IOS XE Release 3.3.0S This command was introduced on the Cisco ASR 1000 Series Routers.
Usage Guidelines By default, the Cisco 1-Port 10 Gigabit Ethernet LAN/WAN-PHY Shared Port Adapter initializes in the WAN
mode. The Cisco 1-Port 10 Gigabit Ethernet LAN/WAN-PHY Shared Port Adapter can operate in either the
LAN mode or the WAN mode. To change the LAN mode or WAN mode, execute the
hw-modulesubslotslot/subslotenable {LAN | WAN} command from the Global configuration mode.
Examples The following example shows how to enable the LAN mode on a Cisco 1-Port 10 Gigabit Ethernet
LAN/WAN-PHY Shared Port Adapter:
Router# config
Router(config)# hw-module subslot 2/1 enable LAN
The following example shows how to enable the WAN mode on a Cisco 1-Port 10 Gigabit Ethernet
LAN/WAN-PHY Shared Port Adapter:
Router# config
Router(config)# hw-module subslot 2/1 enable WAN
Cisco IOS Interface and Hardware Component Command Reference
499
F through H
hw-module subslot (LAN WAN)
Tip If the Cisco 1-Port 10 Gigabit Ethernet LAN/WAN-PHY Shared Port Adapter is working in LAN
mode, you can change the mode to WAN by either using the
hw-modulesusblotslot/subslotenableWAN command.
Related Commands Command Description
show controllers wanphy Displays the SPA mode (LAN mode or WAN mode), alarms, and the J1 byte
string value.
Cisco IOS Interface and Hardware Component Command Reference
500
F through H
hw-module subslot service-engine session
hw-module subslot service-engine session
To open a console session to access the Cisco WebEx Node SPA console, use the
hw-modulesubslotservice-enginesessioncommand in privileged EXEC mode.
hw-module subslot slot/subslot service-engine session
Syntax Description slot Specifies the chassis slot number for the Cisco ASR 1000 Series Router SIP.
/ subslot Specifies the secondary subslot number on a Cisco ASR 1000 Series Router SIP where a SPA
is installed.
Command Default No command default.
Command Modes Privileged EXEC (#)
Command History Release Modification
IOS XE Release 2.4 This command was introduced.
Usage Guidelines To open a console session on a Cisco WebEx Node SPA, the SPA must first be configured with a minimum
of the following commands:
• ip address
• service-engine ip address
• service-engine default-gateway
The service-engineipaddress command must be configured before the service-enginedefault-gateway
command.
Examples The following example shows how to access the console for a WebEx Node SPA located in slot 1/0,
and the change to the SPA console prompt (service-spa is the default hostname) when complete:
Router# hw-module subslot 1/0 service-engine session
MontaVista(R) Linux(R) Carrier Grade Edition 5.0 (custom)
Linux/mips64 2.6.21_mvlcge500-octeon-mips64_octeon_v2_be
Vegas Shell -- CGE 5.0 Version
Copyright (c) 1985-2008 by Cisco Systems, Inc.
All rights reserved.
service-spa#
Related Commands Command Description
service-engine default-gateway Defines a default gateway router IP address for the Cisco WebEx Node
SPA.
Cisco IOS Interface and Hardware Component Command Reference
501
F through H
hw-module subslot service-engine session
Command Description
service-engine ip address Selects and configures the internal interface for management traffic on
a Cisco WebEx Node SPA.
Cisco IOS Interface and Hardware Component Command Reference
502
F through H
hw-module subslot session
hw-module subslot session
To start or close a Cisco Integrated Management Controller (CIMC) session or host server module session,
use the hw-module subslot session command in privileged EXEC mode.
hw-module subslot slot/subslot session {imc|server}
Syntax Description slot/ Number of the router slot in which the server module is installed.
Note For the NIM E-Series NCE, the slot number is 0.
subslot Number of the subslot in which the server module is installed.
Note For Cisco UCS E-Series Servers and the SM E-Series NCE, the subslot
number is 0.
imc Starts a session with CIMC.
server Starts a session with the host server module.
Command Modes
Privileged EXEC (#)
Command History Release Modification
Cisco IOS XE Release 3.9S This command was introduced on the Cisco UCS E-Series Servers installed
in the Cisco 4400 Series Integrated Services Router (ISR).
Cisco IOS XE Release 3.15S This command was supported on an additional platform: the NIM E-Series
Network Compute Engine (NIM E-Series NCE) installed in a Cisco ISR 4000
series.
Usage Guidelines Only one active session is allowed on the CIMC or server module at any time.
Examples The following example shows how to start a CIMC session in an E-Series Server installed in a Cisco
ISR 4000 series:
Router# hardware-module subslot 1/0 session imc
The following example shows how to start a server module session in an E-Series Server installed
in a Cisco ISR 4000 series:
Router# hardware-module subslot 1/0 session server
Cisco IOS Interface and Hardware Component Command Reference
503
F through H
hw-module subslot shutdown
hw-module subslot shutdown
To disable a shared port adapter (SPA) with or without power, and save the configuration to the configuration
file, use the hw-modulesubslotshutdowncommand in global configuration mode. To re-enable the SPA, use
the no form of this command.
hw-module subslot slot/subslot shutdown [{powered|unpowered}]
no hw-module subslot slot/subslot shutdown [{powered|unpowered}]
Syntax Description slot Chassis slot number.
Refer to the appropriate hardware manual for slot information. For SIPs, refer to the
platform-specific SPA hardware installation guide or the corresponding "Identifying Slots
and Subslots for SIPs and SPAs" topic in the platform-specific SPA software configuration
guide.
/ subslot Secondary slot number on a SPA interface processor (SIP) where a SPA is installed.
Refer to the platform-specific SPA hardware installation guide and the corresponding
"Specifying the Interface Address on a SPA" topic in the platform-specific SPA software
configuration guide for subslot information.
powered (Optional) Shuts down the SPA and all of its interfaces, and leaves them in an administratively
down state with power enabled. This is the default state.
unpowered (Optional) Shuts down the SPA and all of its interfaces, and leaves them in an administratively
down state wihout power.
Command Default If this command is not used, nohw-modulesubslotshutdown is the default behavior. When
nohw-modulesubslot is configured, the SPA will be powered for normal operation.
If the hw-modulesubslotshutdown command is entered but neither powered or unpowered are specified in
the CLI, powered is the default behavior.
Command Modes Global configuration
Command History Release Modification
12.2(25)S3 This command was introduced.
12.2(18)SXE This command was integrated into Cisco IOS Release 12.2(18)SXE.
12.0(31)S This command was integrated into Cisco IOS Release 12.0(31)S.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines When you shut down a SPA using this command, you can choose to put it into one of two states:
• Powered state--(Default) Shuts down the SPA, but the SPA remains powered on. Use this option when
you plan to leave the SPA physically installed and cabled in the SPA. You might choose to do this if you
Cisco IOS Interface and Hardware Component Command Reference
504
F through H
hw-module subslot shutdown
want to install a SPA and configure it, but do not want it online or to start communicating with the remote
end of the connection.
• Unpowered state--Shuts down the SPA and removes power from the SPA. Use this option when you
plan to remove the SPA from the chassis.
This command is useful when a user wants all the interfaces on a SPA disabled but does not or cannot remove
the SPA. Unlike the hw-modulesubslotstop EXEC command on the Cisco 7304 router, this command is
saved in the configuration file and will keep the SPA disabled when other router events (such as a router
reload or OIR) attempt to restart the SPA. All other settings and configurations of the SPA will be maintained
even if the SPA itself is shutdown using this command.
As a general rule, you do not need to shut down a SPA if you are removing it and replacing it with the same
exact model of SPA in an online insertion and removal (OIR) operation. However, you should shut down a
SPA whenever you are replacing a SPA with a different model of SPA.
When you shut down a SPA using the hw-modulesubslotshutdowncommand, it remains shutdown even if
you reset the SPA or install a new SPA in that subslot. To begin using the card again, you must manually
re-enable the card using the nohw-modulesubslotshutdowncommand.
Note This is a global configuration command, not an EXEC command. On the Cisco 7304 router, another
hw-modulesubslot command is also available in EXEC mode, but that command is used for different purposes.
An important distinction between this command and the hw-modulesubslot command in EXEC mode on the
Cisco 7304 router is that this command is saved in the configuration.
Examples The following example shows how to disable the SPA in subslot 4/1 while leaving the SPA in the
SPA chassis. This command will be saved to the configuration file and no actions, outside of changing
this configuration, will re-enable the SPA:
Router(config)# hw-module subslot 4/1 shutdown unpowered
The following example shows how to configure the SPA to resume normal operation after the
unpowered option has been used to disable the SPA:
Router(config)# hw-module subslot 4/1 shutdown powered
No messages are provided on the console when you shut down or re-enable a SPA.
Related Commands Command Description
show hw-module subslot oir Displays the operational status of a SPA.
1
hw-module slot Deactivates or reactivates a carrier card that is installed in a router slot. This
command is entered in EXEC mode and is not saved to the configuration
file.
1
Refer to the Cisco 7300 Series Platform-Specific Commands publication.
Cisco IOS Interface and Hardware Component Command Reference
505
F through H
hw-module subslot shutdown (4400)
hw-module subslot shutdown (4400)
To disable a module with or without power, and save the configuration to the configuration file, use the
hw-module subslot shutdown command in global configuration mode. To re-activate the module, use the
no form of this command.
hw-module subslot slot /subslot shutdown [{powered|unpowered}]
no hw-module subslot slot /subslot shutdown [{ powered|unpowered }]
Syntax Description slot Specifies the chassis slot number where the module installed.
Refer to the hardware installation guide for more information on slots. For information on
modules and interfaces, refer to the module specific hardware installation guide.
/ subslot Specifies the subslot number of the chassis where the module is installed.
Refer to the hardware installation guide for subslot information.
powered (Optional) Shuts down the module and all of its interfaces, and leaves them in an
administratively down state with power enabled. This is the default state.
unpowered (Optional) Shuts down the module and all of its interfaces, and leaves them in an
administratively down state without power.
Command Default If this command is not used, no hw-module subslot shutdown is the default behavior. When no hw-module
subslot is configured, the module is powered on for normal operation.
If the hw-module subslot shutdown command is entered but neither powered or unpowered are specified
in the CLI, powered is the default behavior.
Command Modes Global configuration
Command History Release Modification
Cisco IOS XE Release 3.9S This command was introduced.
Usage Guidelines When you shut down a Cisco Services or Network Interface Module (NIM) using this command, you can
choose to put it into one of two states:
• Powered state--(Default) Shuts down the module, but the router remains powered on. Use this option
when you plan to leave the module physically installed and cabled into the router. You might choose to
do this if you want to install a module and configure it, but do not want it online or to start communicating
with the remote end of the connection.
• Unpowered state--Shuts down the module and removes power from the module. Use this option when
you plan to remove the module from the chassis.
If you choose to deactivate your module and its interfaces by executing the hw-module subslot shutdown
command in global configuration mode, you are able to change the configuration in such a way that no matter
how many times the router is rebooted, the module does not boot. This command is useful when you need to
shut down a module located in a remote location and ensure that it does not boot automatically when the router
Cisco IOS Interface and Hardware Component Command Reference
506
F through H
hw-module subslot shutdown (4400)
is rebooted. To begin using the interface again, you must manually re-enable the module using the no
hw-module subslot shutdown command.
Examples The following example shows how to disable the module in subslot 0/2 without removing the module
from the router :
Router(config)# hw-module subslot 0/2 shutdown unpowered
The following example shows how to configure a module to resume normal operation after the
unpowered option has been used to disable the module:
Router(config)# hw-module subslot 0/2 shutdown powered
Related Commands Command Description
show hw-module subslot oir Displays the operational status of a module.
hw-module subslot Deactivates or reactivates a module in a router slot. This command is entered
in EXEC mode and is not saved to the configuration file.
Cisco IOS Interface and Hardware Component Command Reference
507
F through H
hw-module subslot shutdown (4400)
Cisco IOS Interface and Hardware Component Command Reference
508
I through K
• id aa-group, on page 511
• id software group, on page 512
• id vsat, on page 513
• idle-pattern, on page 514
• ids-service-module monitoring, on page 515
• if-mgr delete, on page 516
• ignore (interface), on page 517
• ignore-dcd, on page 519
• ignore-error-duration, on page 520
• ignore-hw local-loopback, on page 521
• imc access-port, on page 522
• imc config file, on page 525
• imc dns, on page 526
• imc ip address default-gateway, on page 527
• imc ip address dhcp, on page 528
• imc ip dhcp, on page 529
• imc remote-manager, on page 530
• imc vlan, on page 531
• input, on page 532
• interface, on page 533
• interface analysis-module, on page 546
• interface content-engine, on page 547
• interface fastethernet, on page 548
• interface gigabitethernet, on page 549
• interface group-async, on page 550
• interface integrated-service-engine, on page 551
• interface ism, on page 552
• interface port-channel, on page 553
• interface pos, on page 554
• interface range, on page 555
• interface satellite, on page 559
• interface service-engine, on page 560
• interface sm, on page 561
Cisco IOS Interface and Hardware Component Command Reference
509
I through K
• interface vg-anylan, on page 562
• interface vmi, on page 563
• interface wlan-controller, on page 565
• international bit, on page 566
• inter-packet gap 6502-mode, on page 567
• invert data, on page 568
• invert rxclock, on page 570
• invert txclock, on page 571
• ip dscp, on page 572
• ip pxf, on page 573
• ip rbscp ack-split, on page 574
• ip verify unicast source reachable-via, on page 576
• ipc buffers, on page 582
• ipc header-cache, on page 583
• ipc holdq threshold, on page 584
• ipc master, on page 585
• ipc zone default, on page 586
• iphc-profile, on page 587
• keepalive, on page 591
Cisco IOS Interface and Hardware Component Command Reference
510
I through K
id aa-group
id aa-group
To configure the asynchronous acknowledgement group ID, use the idaa-groupcommand in satellite initial
configuration mode. To remove the ID configuration, use the no form of this command.
id aa-group number
no id aa-group
Syntax Description aa-group Asynchronous acknowledgement group ID.
number ID number in the range from 256 to 511.
Command Default No default behavior or values
Command Modes Satellite initial configuration
Command History Release Modification
12.3(14)T This command was introduced.
Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your satellite
service provider instructs you to perform the satellite initial configuration and provides all necessary parameter
values.
Examples The following example shows how to configure the asynchronous acknowledgement group
identification number:
Router(sat-init-config)# id aa-group 336
Cisco IOS Interface and Hardware Component Command Reference
511
I through K
id software group
id software group
To configure the operational software group identification number, use the idsoftwaregroupcommand in
satellite initial configuration mode. To remove the ID configuration, use the no form of this command.
id software group number
no id software group
Syntax Description number ID number in the range from 512 to 767.
Command Default No default behavior or values
Command Modes Satellite initial configuration
Command History Release Modification
12.3(14)T This command was introduced.
Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your satellite
service provider instructs you to perform the satellite initial configuration and provides all necessary parameter
values.
Examples The following example shows how to configure the operational software group identification number:
Router(sat-init-config)# id software group 598
Cisco IOS Interface and Hardware Component Command Reference
512
I through K
id vsat
id vsat
To configure the component physical address (CPA), use the idvsatcommand in satellite initial configuration
mode. To remove the CPA configuration, use the no form of this command.
id vsat number
no id vsat number
Syntax Description number CPA number in the range from 1280 to 32766.
Command Default No default behavior or values
Command Modes Satellite initial configuration
Command History Release Modification
12.3(14)T This command was introduced.
12.4(22)T The CPA number range was increased to 32766.
Usage Guidelines The CPA uniquely identifies the VSAT endpoint in the satellite network.
Note This command is typically used by an installation technician. Do not use this command unless your satellite
service provider instructs you to perform the satellite initial configuration and provides all necessary parameter
values.
Examples The following example shows how to configure the CPA number:
Router(sat-init-config)# id vsat 1284
Cisco IOS Interface and Hardware Component Command Reference
513
I through K
idle-pattern
idle-pattern
To define the idle pattern that a circuit emulation (CEM) channel transmits when the channel experiences an
underrun condition or to replace any missing packets, use the idle-patterncommand in CEM configuration
mode. To stop sending idle pattern data, use the no form of this command.
idle-pattern {pattern|length pattern1 [pattern2]}
no idle-pattern
Syntax Description pattern An 8-bit hexadecimal number. T1 and E1 channels require only this argument.
length Length, in bits, of the pattern. Serial cards require that you enter a value for length .
pattern1 Specifies (in hex notation) up to 32 bits of the least significant bits of the idle data pattern. Default
is 0xFF.
pattern2 (Optional) Specifies (in hex notation) the most significant bits of the idle data pattern. If the length
argument is 32 bits or less, this argument is not permitted.
Command Default For T1 or E1 channels, the default idle pattern is 0xFF. For serial channels, the default idle pattern is 0xFF
and 8 bits in length.
Command Modes CEM configuration
Command History Release Modification
12.3(7)T This command was introduced.
XE This command is integrated in Cisco NCS 4200 Series.
3.18SP
Usage Guidelines Idle pattern data is always sent in multiples of one entire packet payload. If a single packet is missing from
the arriving data stream it is replaced by an idle packet of the same payload size and composed of repetitions
of the specified idle pattern. If the CEM channel outbound (egress) buffer experiences an underrun condition,
identical idle packets are transmitted until the dejitter buffer is filled to at least half its total depth.
Examples The following example shows how to configure a 32-bit idle pattern for a serial CEM channel.
Router(config-cem)# idle-pattern 32 0x12345678
Related Commands Command Description
cem Enters circuit emulation configuration mode.
clear cem Clears CEM channel statistics.
show cem Displays CEM channel statistics.
Cisco IOS Interface and Hardware Component Command Reference
514
I through K
ids-service-module monitoring
ids-service-module monitoring
To enable Intrusion Detection System (IDS) monitoring on a specified interface, use the
ids-service-modulemonitoring command in interface configuration mode. To perform IDS monitoring, the
routing device must have a Cisco IDS network module installed. To disable IDS monitoring, use the no form
of this command.
ids-service-module monitoring
no ids-service-module monitoring
Syntax Description This command has no arguments or keywords.
Command Default IDS monitoring is not enabled.
Command Modes Interface configuration
Command History Release Modification
12.3(4)T This command was introduced.
Usage Guidelines Use the ids-service-modulemonitoring command to enable IDS monitoring on a specified interface or
subinterface. Both inbound and outbound packets on the specified interface are forwarded for monitoring.
The Cisco IDS network module is also referred to as the NM-CIDS.
Examples The following example shows how to configure Fast Ethernet interface 0/0 to copy network traffic
to the Cisco IDS network module and enable IDS monitoring:
Router(config)# interface FastEthernet0/0
Router(config-if)# ids-service-module monitoring
Related Commands Command Description
service-module ids-sensor Reboots, resets, enables console access to, shuts down, and monitors the status
of the Cisco IDS network module.
Cisco IOS Interface and Hardware Component Command Reference
515
I through K
if-mgr delete
if-mgr delete
To delete the unused interface identification numbers (ifIndex) from the system interface, use the if-mgrdelete
command in privileged EXEC mode.
if-mgr delete {ifindex-pool initial-ifindex number-of-ifindexes|interfaceType interface-name}
Syntax Description ifindex-pool Specifies the ifIndex pool to delete.
initial-ifindex Initial ifIndex value in the ifIndex pool. The range is from 1 to 3200.
number-of-ifindexes The number of ifIndexes to be deleted. The range is from 1 to 3200.
interfaceType Specifies the type of interface to which the ifIndex value is assigned.
interface-name Name of the interface to which the ifIndex is assigned.
Command Default The ifIndexes assigned for the specified system interface are deleted.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2 This command was introduced.
SXH
Usage Guidelines The ifIndex is a unique identification value associated with a physical or logical interface.
While specifying the ifIndex to be deleted, also provide the interface description (ifDescr) and the ifindex
value assigned to that interface.
Examples The following example shows how to delete the pool of unused ifIndexes:
Router# if-mgr delete ifindex-pool 2 5
Related Commands Command Description
show snmp mib ifmib ifindex Displays all SNMP ifIndex identification numbers for all system interfaces.
Cisco IOS Interface and Hardware Component Command Reference
516
I through K
ignore (interface)
ignore (interface)
To configure the serial interface to ignore the specified serial signals as the line up/down indicator, use the
ignorecommand in interface configuration mode. To restore the default, use the no form of this command.
DCE Asynchronous Mode
ignore [{dtr|rts}]
no ignore [{dtr|rts}]
DCE Synchronous Mode
ignore [{dtr|local-loopback|rts}]
no ignore [{dtr|local-loopback|rts}]
DTE Asynchronous Mode
ignore [{cts|dsr}]
no ignore [{cts|dsr}]
DTE Synchronous Mode
ignore [{cts|dcd|dsr}]
no ignore [{cts|dcd|dsr}]
Syntax Description dtr Specifies that the DCE ignores the Data Terminal Ready (DTR) signal.
rts Specifies that the DCE ignores the Request To Send (RTS) signal.
local-loopback Specifies that the DCE ignores the local loopback signal.
cts Specifies that the DTE ignores the Clear To Send (CTS) signal.
dsr Specifies that the DTE ignores the Data Set Ready (DSR) signal.
dcd Specifies that the DTE ignores the Data Carrier Detect (DCD) signal.
Command Default The no form of this command is the default. The serial interface monitors the serial signal as the line up/down
indicator.
Command Modes
Interface configuration
Command History Release Modification
12.2(15)ZJ This command was introduced on the following platforms: Cisco 2610XM, Cisco 2611XM,
Cisco 2620XM, Cisco 2621XM, Cisco 2650XM, Cisco 2651XM, Cisco 2691, Cisco 3631, Cisco
3660, Cisco 3725, and Cisco 3745 routers.
12.3(2)T This command was integrated into Cisco IOS Release 12.3(2)T.
Usage Guidelines Serial Interfaces in DTE Mode
Cisco IOS Interface and Hardware Component Command Reference
517
I through K
ignore (interface)
When the serial interface is operating in DTE mode, it monitors the DCD signal as the line up/down indicator.
By default, the attached DCE device sends the DCD signal. When the DTE interface detects the DCD signal,
it changes the state of the interface to up.
SDLC Multidrop Environments
In some configurations, such as a Synchronous Data Link Control (SDLC) multidrop environment, the DCE
device sends the DSR signal instead of the DCD signal, which prevents the interface from coming up. Use
this command to tell the interface to monitor the DSR signal instead of the DCD signal as the line up/down
indicator.
Examples The following example shows how to configure serial interface 0 to ignore the DCD signal as the
line up/down indicator:
Router(config)# interface serial 0
Router(config-if)# ignore dcd
Related Commands Command Description
debug serial lead-transition Activates the leads status transition debug capability for all capable ports.
show interfaces serial Displays information about a serial interface.
Cisco IOS Interface and Hardware Component Command Reference
518
I through K
ignore-dcd
ignore-dcd
To configure the serial interface to monitor the Data Set Ready (DSR) signal instead of the Data Carrier Detect
(DCD) signal as the line up/down indicator, use the ignore-dcd command in interface configuration mode.
To restore the default, use the no form of this command.
ignore-dcd
no ignore-dcd
Syntax Description This command has no arguments or keywords.
Command Default The serial interface, operating in DTE mode, monitors the DCD signal as the line up/down indicator.
Command Modes Interface configuration
Command History Release Modification
11.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command applies to Quad Serial NIM interfaces on the Cisco 4000 series routers and Hitachi-based
serial interfaces on the Cisco 2500 and Cisco 3000 series routers.
Serial Interfaces in DTE Mode
When the serial interface is operating in DTE mode, it monitors the DCD signal as the line up/down indicator.
By default, the attached DCE device sends the DCD signal. When the DTE interface detects the DCD signal,
it changes the state of the interface to up.
SDLC Multidrop Environments
In some configurations, such as an Synchronous Data Link Control (SDLC) multidrop environment, the DCE
device sends the DSR signal instead of the DCD signal, which prevents the interface from coming up. Use
this command to tell the interface to monitor the DSR signal instead of the DCD signal as the line up/down
indicator.
Examples The following example shows how to configure serial interface 0 to monitor the DSR signal as the
line up/down indicator:
Router(config)# interface serial 0
Router(config-if)# ignore-dcd
Cisco IOS Interface and Hardware Component Command Reference
519
I through K
ignore-error-duration
ignore-error-duration
To ignore initial train-up errors when the DSL controller is connected to DSLAMs with chipsets other than
Globespan, use theignore-error-duration command in controller configuration mode. To set the error duration
to the default of 0 seconds, use the no form of the command.
ignore-error-duration seconds
Syntax Description seconds Sets the time in seconds for which errors will be ignored during training of the line. Range is from
15 to 30 seconds.
Command Default 0 seconds
Command Modes Controller configuration
Command History Release Modification
12.3(4)XD This command was introduced on Cisco 2600 series and Cisco 3700 series routers.
12.3(4)XG This command was integrated into the Cisco IOS Release 12.3(4)XG on the Cisco 1700 series
routers.
12.3(7)T This command was implemented on Cisco 2600 series, Cisco 3631, and Cisco 3700 series routers.
12.3(11)T This command was implemented on Cisco 2800 and Cisco 3800 series routers.
12.3(14)T This command was implemented on Cisco 1800 series routers.
Usage Guidelines This command is used to ignore initial train-up errors when connected to DSLAMs with chipsets other than
Globespan. Use the time period of 15 to 30 seconds to allow the line to train without being affected by errors
that result because of the line training.
Examples The following example sets the time during which errors will be ignored to 15 seconds:
Router(config)# controller dsl
4/0
Router(config-controller)# ignore-error-duration
15
Related Commands Command Description
controller dsl Configures the DSL controller.
Cisco IOS Interface and Hardware Component Command Reference
520
I through K
ignore-hw local-loopback
ignore-hw local-loopback
To disable the monitoring of the (local-loopback) LL pin when in DCE mode, use the
ingnore-hwlocal-loopback command in interface configuration mode. To enable the monitoring of the LL
pin, use the no form of this command.
ignore-hw local-loopback
no ignore-hw local-loopback
Syntax Description This command has no arguments or keywords.
Command Default Enabled
Command Modes Interface configuration
Command History Release Modification
11.3 This command was introduced.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX
release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use this command if your system is experiencing spurious modem interrupts that momentarily cause the
interface to enter loopback mode. The end result of this behavior is the loss of Synchronous Data Link Control
(SDLC) Logical Link Control (SDLLC) sessions.
Note This command works only with the low-speed serial interfaces.
Examples The following example shows how to disable the monitoring of the LL pin when in DCE mode:
Router(config)# interface serial 2
Router(config-if)# ignore-hw local-loopback
Cisco IOS Interface and Hardware Component Command Reference
521
I through K
imc access-port
imc access-port
To configure Cisco Integrated Management Controller (CIMC) access through the server module's dedicated,
management, or host ports, use the imc access-port command in interface configuration mode or UCSE
configuration mode.
Cisco UCS E-Series Server Installed in Cisco 2900 and 3900 ISR G2 and the Cisco ISR 4451-X
imc access-port {dedicated|shared-lom [{GE1|GE2|GE3|console|failover [option]}]}
no imc access-port {dedicated|shared-lom [{GE1|GE2|GE3|console|failover [option]}]}
Cisco UCS E-Series Server Installed in the Cisco ISR 4451-X—Applicable Only with Cisco IOS XE
Release 3.9S
imc access-port {MGMT| [{GE0|GE1|GE2|GE3[failover-option]}]}
no imc access-port {MGMT| [{GE0|GE1|GE2|GE3[failover-option]}]}
Table 18: Cisco UCS E-Series Server Installed in Cisco 2900 and 3900 ISR G2 and the Cisco ISR 4451-X
Syntax Description
dedicated Configures CIMC access using the IMC dedicated port.
shared-lom Configures CIMC access using one of the following host ports:
• GE1
• GE2
• GE3
• console
• failover
Note If you enter failover, you must also enter one
additional parameter:
• GE1 GE1 [GE2] | [GE3] [GE2 GE3]
• GE2 GE2 GE3
Table 19: Cisco UCS E-Series Server Installed in the Cisco ISR 4451-X—Applicable Only with Cisco IOS XE Release 3.9S
MGMT Configures CIMC access using the Cisco UCS E-Series Server's management port.
Cisco IOS Interface and Hardware Component Command Reference
522
I through K
imc access-port
GE0, GE1, (Optional) Configures CIMC access using one of the following NIC interfaces:
GE2, GE3
• GE0—Cisco UCS E-Series Server's internal NIC interface connecting to the router's
UCSE slot/0/0 interface.
• GE1—Cisco UCS E-Series Server's internal NIC interface connecting to the router's
UCSE slot/0/1 interface.
• GE2—Cisco UCS E-Series Server's external NIC interface.
• GE3—Cisco UCS E-Series Server's external NIC interface. Applicable to double-wide
Cisco UCS E-Series Servers.
• failover-option—To configure failover, enter one additional parameter:
• GE2 backplane—Applicable to single-wide and double-wide Cisco UCS
E-Series Servers.
• GE3 backplane—Applicable to double-wide Cisco UCS E-Series Servers.
• GE2 GE3—Applicable to double-wide Cisco UCS E-Series Servers.
• GE3 GE2—Applicable to double-wide Cisco UCS E-Series Servers.
• GE2 GE3 backplane—Applicable to double-wide Cisco UCS E-Series Servers.
• GE3 GE2 backplane—Applicable to double-wide Cisco UCS E-Series Servers.
Command Modes
Interface configuration (config-if) for a Cisco UCS E-Series Server installed in Cisco 2900 and 3900 ISR G2.
UCSE configuration (config-ucse) for a Cisco UCS E-Series Server installed in the Cisco ISR 4451-X.
Command History Release Modification
Cisco IOS Release 15.2(4)M This command was introduced on the Cisco UCS E-Series Servers installed
in Cisco 2900 and 3900 Series Integrated Services Routers (ISR G2).
Cisco IOS XE Release 3.9S This command was implemented on Cisco UCS E-Series Servers installed in
the Cisco 4451-X Integrated Services Router (Cisco ISR 4451-X).
Cisco IOS XE Release 3.10S This command was modified so that all platforms—Cisco 2900 and 3900 ISR
G2 and the Cisco ISR 4451-X—use the same command.
Usage Guidelines If the Cisco UCS E-Series Server is installed in Cisco 2900 and 3900 ISR G2, use the imc access-port
command in interface configuration mode:
Router(config)# interface ucse 2/0
Router(config-if)#
If the Cisco UCS E-Series Server is installed in Cisco ISR 4451-X, use the imc access port command in
UCSE configuration mode:
Cisco IOS Interface and Hardware Component Command Reference
523
I through K
imc access-port
Router(config)# ucse subslot 1/0
Router(config-ucse)#
Examples The following example shows how to configure CIMC access using the dedicated port:
Router# configure terminal
Router(config)# interface ucse 2/0
Router(config-if)# imc ip address 10.0.0.2 255.0.0.0 default-gateway 10.0.0.1
Router(config-if)# imc access-port dedicated
Router(config-if)# no shut
Router(config-if)# end
Cisco UCS E-Series Server Installed in the Cisco ISR 4451-X—Applicable Only with Cisco IOS XE
Release 3.9S
The following example shows how to configure CIMC access using the MGMT port:
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# ucse subslot 1/0
Router(config-ucse)# imc access-port mgmt
Router(config-ucse)#
IMC ACK: Access ports received: MGMT
IMC ACK: UCSE access port operation successful.
Cisco IOS Interface and Hardware Component Command Reference
524
I through K
imc config file
imc config file
To store the name of a CIMC configuration file in the running configuration, use the imc config file command
from interface configuration mode .
imc config file file_name
no imc config file file_name
Syntax Description file_name The name of the CIMC configuration file that you want to store.
Command Modes
Interface configuration mode.
Command History Release Modification
15.2(4)M This command was introduced.
Usage Guidelines Use this command from interface configuration mode:
Router(config)# interface ucse slot/port
Examples The following example shows how to store a configuration CIMC file to the running configuration.
Note that there is no output after you issue the command:
Router(config)# interface ucse 2/0
Router(config-if)# imc config file flash0:my-imc-config
Cisco IOS Interface and Hardware Component Command Reference
525
I through K
imc dns
imc dns
To configure a domain name system (DNS) server for CIMC, use the imc dns command from interface
configuration mode.
imc dns
no imc dns
Syntax Description This command has no arguments.
Command Modes
Interface configuration mode.
Command History Release Modification
15.2(4)M This command was introduced.
Usage Guidelines Use this command from interface configuration mode:
Router(config)# interface ucse slot/port
Examples The following example shows how to configure the DNS server for CIMC:
Router(config)# interface ucse 2/0
Router(config-if)# imc dns
Cisco IOS Interface and Hardware Component Command Reference
526
I through K
imc ip address default-gateway
imc ip address default-gateway
To configure a static IP address for CIMC and the IP address of the default gateway router that CIMC must
use, use the imc ip address default-gateway command in interface configuration mode. To remove the static
IP address, use the no form of this command.
imc ip address ip-address subnet-mask default-gateway gateway-address
no imc ip address ip-address subnet-mask default-gateway gateway-address
Syntax Description ip-address IP address of CIMC.
subnet-mask Subnet mask to append to the IP address; must be in the same subnet as the host router.
gateway-address IP address of the default gateway router.
Command Modes
Interface configuration (config-if)
Command History Release Modification
15.2(4)M This command was introduced.
Usage Guidelines If you do not enable DHCP, you must specify a static IP address and subnet mask.
Examples The following example shows how to configure a static IP address for CIMC:
Router(config)# interface ucse 2/0
Router(config-if)# imc ip address 10.0.0.2 255.0.0.0 default-gateway 10.0.0.1
Cisco IOS Interface and Hardware Component Command Reference
527
I through K
imc ip address dhcp
imc ip address dhcp
To configure a DHCP IP address for CIMC, use the imc ip address dhcp command in interface configuration
mode. To remove the DHCP IP address, use the no form of the this command.
imc ip address dhcp
no imc ip address dhcp
Syntax Description This command has no arguments or keywords.
Command Modes
Interface configuration (config-if)
Command History Release Modification
15.2(4)M This command was introduced.
Examples The following example shows how to configure a DHCP IP address for CIMC:
Router(config)# interface ucse 2/0
Router(config-if)# imc ip address dhcp
Cisco IOS Interface and Hardware Component Command Reference
528
I through K
imc ip dhcp
imc ip dhcp
To configure a DHCP IP address for the Cisco Integrated Management Controller (CIMC), use the imc ip
dhcp command in UCSE configuration mode. To remove the DHCP IP address, use the no form of this
command.
imc ip dhcp
no imc ip dhcp
Syntax Description This command has no arguments or keywords.
Command Modes
UCSE configuration (config-ucse)
Command History Release Modification
Cisco IOS XE Release 3.9S This command was introduced on the Cisco UCS E-Series Servers installed in
the Cisco 4400 Series Integrated Services Router (ISR).
Examples The following example shows how to configure a dynamic IP address for CIMC:
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# ucse subslot 1/0
Router(config-ucse)# imc ip dhcp
Router(config-ucse)#
IMC ACK: DHCP enable received for IMC.
IMC ACK: UCSE setting DHCP enable for IMC successful.
Cisco IOS Interface and Hardware Component Command Reference
529
I through K
imc remote-manager
imc remote-manager
To configure the IP address of the remote manager, use the imc remote-manager command from interface
configuration mode .
imc remote-manager ip_address
no imc remote-manager
Syntax Description ip_address IP address of the remote manager.
Command Modes
Interface configuration mode.
Command History Release Modification
15.2(4)M This command was introduced.
Usage Guidelines Use this command from interface configuration mode:
Router(config)# interface ucse slot/port
Examples The following example shows how to configure the IP address of the remote manager:
Router(config)# interface ucse 2/0
Router(config-if)# imc remote-manager 10.0.0.0
Cisco IOS Interface and Hardware Component Command Reference
530
I through K
imc vlan
imc vlan
To enter VLAN configuration mode for the specified VLAN number, use the imc vlan command in interface
configuration mode. To remove the VLAN configuration, use the no form of this command.
imc vlan vlan-number
no imc vlan vlan-number
Syntax Description vlan-number IP address of the remote manager.
Command Modes
Interface configuration (config-if)
Command History Release Modification
15.2(4)M This command was introduced.
Examples The following example shows how to enter VLAN configuration mode in CIMC for a specified
VLAN:
Router(config)# interface ucse 2/0
Router(config-if)# interface vlan 40
Cisco IOS Interface and Hardware Component Command Reference
531
I through K
input
input
To enable Precision Time Protocol input clocking using a 1.544Mhz, 2.048Mhz, or 10Mhz timing interface
or phase using the 1PPS or RS-422 interface, use the input command in global configuration mode. To disable
PTP input, use the no form of this command.
input [1pps] slot/bay
no input [1pps] slot/bay
Syntax Description 1pps Configures the device to receive 1 pulse per second (1PPS) time of day messages using the RS422
port or 1PPS port. You can select 1PPS with or without selecting a timing port.
slot Slot of the 1PPS interface.
bay Bay of the 1PPS interface.
Command Default Precision Time Protocol input clocking is not enabled.
Command Modes Global configuration (config)
Command History Release Modification
12.2(31)SB2 This command was introduced.
15.0(1)S This command was integrated into Cisco IOS Release 15.0(1)S.
Usage Guidelines If you are using GPS to provide clock source to the device, configure this command in PTP master mode.
This command applies only to platforms that have a 1PPS port.
Examples The following example shows how to configure PTP input clocking:
Device> enable
Device# configure terminal
Device(config)# ptp clock ordinary domain 0
Device(config-ptp-clk)# input 1pps 3/1
Device(config-ptp-clk)# clock-port masterport master
Related Commands Command Description
output Enables output of time of day messages using the 1PPS interface.
Cisco IOS Interface and Hardware Component Command Reference
532
I through K
interface
interface
To configure an interface type and to enter interface configuration mode, use the interface command in the
appropriate configuration mode.
Standard Syntax
interface type number [name-tag]
Module-Specific and Platform-Specific Syntax
Analysis Module Network Module
interface analysis-module slot/unit
Content Engine Network Module
interface content-engine slot/unit
Cisco 830 Series
interface type [number]
Cisco 2600 Series
interface type slot/{port-adapter|port . subinterface-number}
Cisco 2600 Series on Voice Interfaces
interface type slot/voice-module-slot/voice-interface-slot
Cisco 3600 Series
interface type slot/{port|port . subinterface-number}
Cisco 3600 Series on Voice Interfaces
interface type slot/voice-module-slot/voice-interface-slot
Cisco 4400 Series Integrated Services Router (ISR)
interface type number
Cisco 7100 Series
interface type slot/{port-adapter|port . subinterface-number}
Cisco 7200 Series and Cisco 7500 Series with a Packet over SONET Interface Processor
interface type slot/port
Cisco 7200 VXR Router Used as a Router Shelf in a Cisco AS5800 Universal Access Server
interface type router-shelf/slot/port
Cisco 7500 Series with Channelized T1 or E1
interface serial slot/port : channel-group
Cisco 7500 Series with Ports on VIP Cards
interface type slot/port-adapter/port
Cisco IOS Interface and Hardware Component Command Reference
533
I through K
interface
Cisco 7600 Series
interface type number
Note: The number format varies depending on the network module or line card type and the router’s chassis
slot it is installed in. Refer to the appropriate hardware manual for numbering information
Cisco 7600 Series with Ports on Ethernet Service Cards
interface type slot/bay/port access
Note: The syntax may vary depending on the Ethernet service line card type. Refer to the appropriate hardware
manual for numbering information. For example, for the ES20 line card the syntax takes the following format:
Subinterface Syntax Forms in Global Configuration Mode
Cisco 7200 Series
interface type slot/port . subinterface-number [{multipoint|point-to-point}]
Cisco 7500 Series
interface type slot/port-adapter . subinterface-number [{multipoint|point-to-point}]
Cisco 7500 Series with Ports on VIP Cards
interface type slot/port-adapter/port . subinterface-number [{multipoint|point-to-point}]
Cisco ASR 901 Series Aggregation Services Routers
no interface type number
Shared Port Adapters
interface type slot/subslot/port [. subinterface-number]
Syntax Description type Type of interface to be configured. See the table below.
number Port, connector, or interface card number. On Cisco 830 series routers, the
numberargumentspecifies the ethernet interface number. On Cisco 4700 series routers,
the number argument specifies the network interface module (NIM) or network
processor module (NPM) number. The numbers are assigned at the factory at the
time of installation or when added to a system; they can be displayed with the
showinterfaces command. For Cisco ASR 901 Series Aggregation Services Routers,
the range is from 1 to 8.
name-tag (Optional) Specifies the logic name to identify the server configuration so that multiple
server configurations can be entered.
This optional argument is for use with the Redundant Link Manager (RLM) feature.
slot Chassis slot number.
Refer to the appropriate hardware manual for slot information. For SIPs, refer to the
platform-specific SPA hardware installation guide or the corresponding "Identifying
Slots and Subslots for SIPs and SPAs" topic in the platform-specific SPA software
configuration guide.
Cisco IOS Interface and Hardware Component Command Reference
534
I through K
interface
/ voice-module-slot Voice module slot number. The slash(/)is required.
Refer to the “Cisco 3700 Series Routers Voice Interface Numbering” section of the
“Understanding Interface Numbering and Cisco IOS Basics” chapter in the
platform-specific SPA software configuration guide.
/ voice-interface-slot Voice interface slot number. The slash(/)is required.
Refer to the “Cisco 3700 Series Routers Voice Interface Numbering” section of the
“Understanding Interface Numbering and Cisco IOS Basics” chapter in the
platform-specific SPA software configuration guide.
/ subslot Secondary slot number on a SIP where a SPA is installed. The slash (/) is required.
Refer to the platform-specific SPA hardware installation guide and the corresponding
"Specifying the Interface Address on a SPA" topic in the platform-specific SPA
software configuration guide for subslot information.
/ unit Number of the daughter card on the network module. For analysis module and content
engine (CE) network modules, always use 0. Theslash(/)is required.
/bay Card interface bay number in a slot. Theslash(/)is required.
Refer to the appropriate hardware manual for bay information.
/ port Port or interface number. Theslash(/)is required.
Refer to the appropriate hardware manual for port information. For SPAs, refer to
the corresponding “Specifying the Interface Address on a SPA” topics in the
platform-specific SPA software configuration guide.
router-shelf Router shelf number in a Cisco AS5800 universal access server. Refer to the
appropriate hardware manual for router shelf information.
: channel-group Channel group number. Cisco 7500 series routers specify the channel group number
in the range of 0 to 4 defined with the channel-group controller configuration
command.
/ port-adapter Port adapter number. Refer to the appropriate hardware manual for information about
port adapter compatibility. Theslash(/) is required.
. Subinterface number in the range 1 to 4294967293. The number that precedes the
subinterface-number period (.) must match the number to which this subinterface belongs.
access Creates an access interface for an IP subscriber. The access interface is configured
as a subinterface of the physical interface that the IP subscriber is connected to.
multipoint | (Optional) Specifies a multipoint or point-to-point subinterface. There is no default
point-to-point .
Command Default No interface types are configured.
Command Modes Global configuration (config)
RITE configuration (config-rite)
Cisco IOS Interface and Hardware Component Command Reference
535
I through K
interface
Note To use this command with the RLM feature, the networking device must be in interface configuration mode.
Command History Release Modification
10.0 This command was introduced for the Cisco 7000 series routers.
11.0 This command was implemented on the Cisco 4000 series routers.
12.0(3)T The optional name-tagargument was added for the RLM feature.
12.2(13)T The content-engine keyword was added.
12.2(15)T The lex keyword was removed because the LAN Extension feature is no longer
available in Cisco IOS software.
12.2(20)S2 This command was implemented for SPAs on the Cisco 7304 router.
12.3(4)T The serviceengine keyword was added. Support was added for the interface
command to be used in RITE configuration mode to support IP trfaffic export
profiles.
12.3(7)T The analysis-module keyword was added.
12.2(22)S Support for RITE configuration mode and IP traffic export profiles was added.
12.3(14)T The satellite keyword was added to support satellite interface configuration
on network modules.
12.2(18)SXE This command was implemented for SPAs on the Cisco 7600 series routers
and Catalyst 6500 series switches.
12.0(31)S This command was implemented for SPAs on the Cisco 12000 series routers.
12.2(18)SXF The tengigabitethernet keyword was added for support of the10 Gigabit
Ethernet interface type.
12.2(28)SB This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Cisco IOS XE 2.1 This command was implemented on Cisco ASR 1000 series routers.
15.1(2)SNG This command was implemented on Cisco ASR 901 Series Aggregation
Services Routers.
Cisco IOS XE Release 3.9S This command was implemented on Cisco 4400 Series ISR.
15.2(02)SA This command was implemented on Cisco ME 2600X Series Ethernet Access
Switches.
15.1(2)SNG This command was implemented on Cisco ASR 901 Series Aggregation
Services Routers.
Cisco IOS Interface and Hardware Component Command Reference
536
I through K
interface
Usage Guidelines This command does not have a no form except for Cisco ASR 901 Series Aggregation Services Routers.
The table below displays the keywords that represent the types of interfaces that can be configured with the
interface command. Replace the type argument with the appropriate keyword from the table.
Table 20: Interface Type Keywords
Keyword Interface Type
analysis-module Analysis module interface. The analysis module interface is a Fast Ethernet interface
on the router that connects to the internal interface on the Network Analysis Module
(NAM). This interface cannot be configured for subinterfaces or for speed, duplex
mode, and similar parameters. See the command-line interface (CLI) help for a list of
valid parameters.
async Port line used as an asynchronous interface.
atm ATM interface.
bri ISDN BRI. This interface configuration is propagated to each of the B channels. B
channels cannot be individually configured. The interface must be configured with
dial-on-demand commands in order for calls to be placed on that interface.
content-engine Content engine (CE) network module interface. The CE network module interface
cannot be configured for subinterfaces or for speed, duplex mode, and similar
parameters. See the command-line interface (CLI) help for a list of valid parameters.
Note The content-engine keyword was formerly documented as the
interfacecontent-engine command.
dialer Dialer interface.
ethernet Ethernet IEEE 802.3 interface.
fastethernet 100-Mbps Ethernet interface. In RITE configuration mode, specifies the outgoing
(monitored) interface for exported IP traffic.
Note The fastethernet keyword was formerly documented as the
interfacefastethernet command.
fddi FDDI interface.
gigabitethernet 1000-Mbps Ethernet interface.
Note The gigabitethernet keyword was formerly documented as the
interfacegigabitethernet command.
group-async Master asynchronous interface.
Note The group-async keyword was formerly documented as the
interfacegroup-async command.
hssi High-Speed Serial Interface (HSSI).
Cisco IOS Interface and Hardware Component Command Reference
537
I through K
interface
Keyword Interface Type
loopback Software-only loopback interface that emulates an interface that is always up. It is a
virtual interface supported on all platforms. The number argument is the number of
the loopback interface that you want to create or configure. There is no limit on the
number of loopback interfaces that you can create.
null Null interface.
port-channel Port channel interface.
Note The port-channel keyword was formerly documented as the
interfaceport-channel command.
pos Packet OC-3 interface on the Packet-over-SONET (POS) interface processor.
Note The pos keyword was formerly documented as the interfacepos command.
Satellite Satellite network module. Enters satellite configuration mode.
sdcc Section data communications channel interface.
serial Serial interface.
service-engine Network module (NM) or an Advanced Integration Module (AIM), this command
may be used for NMs and AIMs only. If your system does not have this hardware,
you will be unable to enter this command. The no form of this command (no interface
service-engine) is not available. The exit command can be used to exit interface
configuration mode.
switch Switch interface.
tengigabitethernet 10-Gigabit Ethernet interface.
tokenring Token Ring interface.
tunnel Tunnel interface; a virtual interface. The number argument is the number of the tunnel
interface that you want to create or configure. There is no limit on the number of tunnel
interfaces that you can create.
vg-anylan 100VG-AnyLAN port adapter.
Note The vg-anylan keyword was formerly documented as the
interfacevg-anylan command.
Creating an IP Traffic Export Profile
Ip traffic export is intended only for software switching platforms; distributed architectures are not supported.
After you configure an IP traffic export profile using the iptraffic-exportprofileglobal configuration command,
you must also include the interfacecommand after the iptraffic-exportprofilecommand; otherwise, the profile
will be unable to export the captured IP packets. If you do not use the interface command, you will receive
a warning that indicates that the profile is incomplete.
Subinterfaces
Cisco IOS Interface and Hardware Component Command Reference
538
I through K
interface
Subinterfaces can be configured to support partially meshed Frame Relay networks. Refer to the “Configuring
Serial Interfaces” chapter in the CiscoIOSInterfaceandHardwareComponentConfigurationGuide.
Using the analysis-module Keyword
The analysis module interface is used to access the NAM console for the initial configuration. After the NAM
IP parameters are configured, the analysis module interface is typically used only during NAM software
upgrades and while troubleshooting if the NAM Traffic Analyzer is inaccessible.
Visible only to the Cisco IOS software on the router, the analysis module interface is an internal Fast Ethernet
interface on the router that connects to the internal NAM interface. The analysis module interface is connected
to the router’s Peripheral Component Interconnect (PCI) backplane, and all configuration and management
of the analysis module interface must be performed from the Cisco IOS CLI.
Using the group-async Keyword
Using the group-async keyword, you create a single asynchronous interface with which other interfaces are
associated as members using the group-rangecommand. This one-to-many configuration allows you to
configure all associated member interfaces by entering one command on the group master interface, rather
than entering this command on each individual interface. You can create multiple group masters on a device;
however, each member interface can be associated only with one group.
Using the port-channel Keyword
The Fast EtherChannel feature allows multiple Fast Ethernet point-to-point links to be bundled into one logical
link to provide bidirectional bandwidth of up to 800 Mbps. You can configure the port-channel interface as
you would any Fast Ethernet interface.
After you create a port-channel interface, you assign upto four Fast Ethernet interfaces to it. For information
on how to assign a Fast Ethernet interface to a port-channel interface, refer to the channel-group command
in the interface configuration mode.
Caution The port-channel interface is the routed interface. Do not enable Layer 3 addresses on the physical Fast Ethernet
interfaces. Do not assign bridge groups on the physical Fast Ethernet interfaces because doing so creates loops.
Also, you must disable spanning tree.
Caution With Release 11.1(20)CC, the Fast EtherChannel supports Cisco Express Forwarding (CEF) and distributed
Cisco Express Forwarding (dCEF). We recommend that you clear all explicitiproute-cachedistributed
commands from the Fast Ethernet interfaces before enabling dCEF on the port-channel interface. Clearing
the route cache gives the port-channel interface proper control of its physical Fast Ethernet links. When you
enable CEF/dCEF globally, all interfaces that support CEF/dCEF are enabled. When CEF/dCEF is enabled
on the port-channel interface, it is automatically enabled on each of the Fast Ethernet interfaces in the channel
group. However, if you have previously disabled CEF/dCEF on the Fast Ethernet interface, CEF/dCEF is not
automatically enabled. In this case, you must enable CEF/dCEF on the Fast Ethernet interface.
As you work with the port-channelkeyword, consider the following points:
• Currently, if you want to use the Cisco Discovery Protocol (CDP), you must configure it only on the
port-channel interface and not on the physical Fast Ethernet interface.
• If you do not assign a static MAC address on the port-channel interface, the Cisco IOS software
automatically assigns a MAC address. If you assign a static MAC address and then later remove it, Cisco
IOS software automatically assigns a MAC address.
Cisco IOS Interface and Hardware Component Command Reference
539
I through K
interface
• The access keyword creates an ethernet channel access interface for an IP subscriber and is specific to
Cisco 7600 series routers only. For more information on access interface, see IP Subscriber Interfaces.
Using the vg-anylan Keyword
The 100VG-AnyLAN port adapter provides a single interface port that is compatible with and specified by
IEEE 802.12. The 100VG-AnyLAN port adapter provides 100 Mbps over Category 3 or Category 5 cable
with RJ-45 terminators and supports IEEE 802.3 Ethernet packets.
You configure the 100VG-AnyLAN port adapter as you would any Ethernet or Fast Ethernet interface. The
100VG-AnyLAN port adapter can be monitored with the IEEE 802.12 Interface MIB.
Cisco ASR 901 Series Aggregation Services Routers
The first EtherChannel interface configured becomes the bundled master for all EtherChannel interfaces in
the group. That is, the MAC address of the first EtherChannel interface is the MAC address for all EtherChannel
interfaces in the group. If the first EtherChannel interface is removed at any time, the second EtherChannel
interface becomes the bundled master by default.
Repeat this configuration on every EtherChannel port to be bundled into a Fast Ether Channel (FEC) or Gigabit
Ether Channel (GEC) group. This configuration must be present on all EtherChannel interfaces before the
EtherChannel group can be configured.
Cisco 4400 Series Integrated Services Router (ISR)
The Gigabit Ethernet interface allows you to perform management tasks on the router and is often referred
as the management interface port. You can use the Gigabit Ethernet interface to access the router via Telnet
and SSH to perform management tasks on the router. The interface is most useful before a router has begun
routing, or in troubleshooting scenarios when other forwarding interfaces are inactive. You can configure a
Gigabit Ethernet interface on your router using the interface GigabitEthernet0 command in Global
configuration mode.
Analysis Module Interface with NAM Router: Example
The following example configures an analysis module interface when the NAM router is in router
slot 1:
Router(config)# interface analysis-module 1/0
Asynchronous Group Master Interface: Example
The following example shows how to define asynchronous group master interface 0:
Router(config)# interface group-async 0
Content Engine Network Module Interface: Example
The following example configures an interface for a content engine network module in slot 1:
Router(config)# interface content-engine 1/0
Cisco IOS Interface and Hardware Component Command Reference
540
I through K
interface
Ethernet Interface on Cisco 830 Router: Example
The following example configures a new ethernet2interface on the LAN or on the WAN side of the
Cisco 830 series router.
c837# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
c837(config)# interface ethernet 2
Ethernet Port on Ethernet Interface Processor on Cisco 7500 Series Router: Example
The following example shows how to configure Ethernet port 4 on the Ethernet Interface Processor
(EIP) in slot 2 on the Cisco 7500 series router:
Router(config)# interface ethernet 2/4
Exporting IP Traffic (RITE): Example
The following example shows how to configure the profile “corp1,” which will send captured IP
traffic to host “00a.8aab.90a0” at the interface “FastEthernet 0/1.” This profile is also configured to
export one in every 50 packets and to allow incoming traffic only from the access control list
“ham_ACL.”
Router(config)# ip traffic-export profile corp1
Router(config-rite)# interface FastEthernet 0/1
Router(config-rite)# bidirectional
Router(config-rite)# mac-address 00a.8aab.90a0
Router(config-rite)# outgoing sample one-in-every 50
Router(config-rite)# incoming access-list ham_acl
Router(config-rite)# exit
Router(config)# interface FastEthernet 0/0
Router(config-if)# ip traffic-export apply corp1
Fast Ethernet Interface on Cisco 2600 Router: Example
The following example shows how to configure Fast Ethernet interface 0 on a Cisco 2600 series
router:
Router(config)# interface fastethernet0/0
or
Router(config)# interface fastethernet0/0.1
Fast Ethernet Interface on Cisco 3600 Router: Example
The following example shows how to configure Fast Ethernet interface 0 on a Cisco 3600 series
router:
Cisco IOS Interface and Hardware Component Command Reference
541
I through K
interface
Router(config)# interface fastethernet0/0
or
Router(config)# interface fastethernet0/0.1
Fast Ethernet Interface with ARPA Encapsulation on Cisco 4700 Router: Example
The following example shows how to configure Fast Ethernet interface 0 for standard ARPA
encapsulation (the default setting) on a Cisco 4700 series router:
Router(config)# interface fastethernet 0
Fast Ethernet Interface on Cisco 7100 Router: Example
The following example shows how to configure Fast Ethernet interface 0 on a Cisco 7100 series
router:
Router(config)# interface fastethernet0/0
or
Router(config)# interface fastethernet0/0.1
Fast Ethernet Interface on Cisco 12000 Router: Example
The following example shows how to configure Fast Ethernet interface 6 on a Cisco 12000 series
router:
Router(config)# interface fastethernet6/0
or
Router(config)# interface fastethernet6/0.1
Gigabit Ethernet Interface: Example
The following example shows how to configure the Gigabit Ethernet interface for slot 0, port 0:
Router(config)# interface gigabitethernet 0/0
Gigabit Ethernet Interface on Cisco 4400 Series ISR: Example
The following example shows how to configure the Gigabit Ethernet Interface. The Gigabit Ethernet
Interface or the management port is always GigabitEthernet0.
Router# config t
Cisco IOS Interface and Hardware Component Command Reference
542
I through K
interface
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# interface gigabitethernet0
Router(config-if)#
Gigabit Ethernet Interface on Cisco uBR10012 Router: Example
The following example shows how to specify the second interface (1) on a Gigabit Ethernet SPA
installed in the first subslot of a SIP (0) installed in chassis slot 3:
Router(config)# interface gigabitethernet 3/0/1
Loopback Interface: Example
The following example shows how to enable loopback mode and assign an IP network address and
network mask to the interface. The loopback interface established here will always appear to be up.
Router(config)# interface loopback 0
Router(config-if)# ip address 10.108.1.1 255.255.255.0
Packet over SONET Interface: Example
The following example shows how to specify the single Packet OC-3 interface on port 0 of the POS
OC-3 port adapter in slot 2:
Router(config)# interface pos 2/0
Partially Meshed Frame Relay Network: Example
The following example shows how to configure a partially meshed Frame Relay network. In this
example, subinterface serial 0.1 is configured as a multipoint subinterface with two associated Frame
Relay permanent virtual connections (PVCs), and subinterface serial 0.2 is configured as a
point-to-point subinterface.
Router(config)# interface serial 0
Router(config-if)# encapsulation frame-relay
Router(config-if)# exit
Router(config)# interface serial 0/0.1 multipoint
Router(config-if)# ip address 10.108.10.1 255.255.255.0
Router(config-if)# frame-relay interface-dlci 42 broadcast
Router(config-if)# frame-relay interface-dlci 53 broadcast
Router(config-if)# exit
Router(config)# interface serial 0/0.2 point-to-point
Router(config-if)# ip address 10.108.11.1 255.255.255.0
Router(config-if)# frame-relay interface-dlci 59 broadcast
Port Channel Interface: Example
The following example shows how to create a port-channel interface with a channel group number
of 1 and add two Fast Ethernet interfaces to port-channel 1:
Cisco IOS Interface and Hardware Component Command Reference
543
I through K
interface
Router(config)# interface port-channel 1
Router(config-if)# ip address 10.1.1.10 255.255.255.0
Router(config-if)# exit
Router(config)# interface fastethernet 1/0/0
Router(config-if)# channel-group 1
Router(config-if)# exit
Router(config)# interface fastethernet 4/0/0
Router(config-if)# channel-group 1
SDCC Interface on a POS Shared Port Adapter: Example
The following example configures the first interface (port 0) as a section data communications channel
(SDCC) interface on a POS SPA, where the SPA is installed in the top subslot (0) of the MSC, and
the MSC is installed in slot 4 of the Cisco 7304 router:
Router(config)# interface sdcc 4/3/0
Router(config-if)# ip address 10.1.9.2 255.255.255.0
Router(config-if)# logging event link-status
Router(config-if)# load-interval 30
Router(config-if)# no keepalive
Router(config-if)# no fair-queue
Router(config-if)# no cdp enable
Serial Interface with PPP Encapsulation: Example
The following example shows how to configure serial interface 0 with PPP encapsulation:
Router(config)# interface serial 0
Router(config-if)# encapsulation ppp
Shared Port Adapter Interface: Example
The following example configures the second interface (port 1) on a 4-Port 10/100 Fast Ethernet
SPA for standard ARPA encapsulation (the default setting), where the SPA is installed in the bottom
subslot (1) of the MSC, and the MSC is installed in slot 2 of the Cisco 7304 router:
Router(config)# interface fastethernet 2/1/1
T1 Serial Interface: Example
The following example shows how to configure circuit 0 of a T1 link for PPP encapsulation:
Router(config)# controller t1 4/1
Router(config-controller)# circuit 0 1
Router(config-controller)# exit
Router(config)# interface serial 4/1:0
Router(config-if)# ip address 10.108.13.1 255.255.255.0
Router(config-if)# encapsulation ppp
Cisco IOS Interface and Hardware Component Command Reference
544
I through K
interface
Token Ring Interface Processor: Example
The following example shows how to configure the Token Ring interface processor in slot 1 on port
0 of a Cisco 7500 series router:
Router(config)# interface tokenring 1/0
100VG-AnyLAN Interface: Example
The following example shows how to specify the 100VG-AnyLAN port adapter in the first port
adapter in slot 1:
Router(config)# interface vg-anylan 1/0/0
Related Commands Command Description
channel-group Defines the time slots that belong to each T1 or E1 circuit.
channel-group (Fast EtherChannel) Assigns a Fast Ethernet interface to a Fast EtherChannel group.
clear interface Resets the hardware logic on an interface.
controller Configures an E1, J1, T1, or T3 controller and enters controller
configuration mode.
group-range Creates a list of asynchronous interfaces that are associated with a
group interface on the same device.
ip traffic-export profile Create or edit an IP traffic export profile.
mac-address Sets the MAC layer address.
ppp Starts an asynchronous connection using PPP.
show controllers content-engine Displays controller information for CE network modules.
show interfaces Displays information about interfaces.
show interfaces Displays information about interfaces.
show interfaces content-engine Displays basic interface configuration information for a CE network
module.
shutdown (RLM) Shuts down all of the links under the RLM group.
slip Starts a serial connection to a remote host using SLIP.
Cisco IOS Interface and Hardware Component Command Reference
545
I through K
interface analysis-module
interface analysis-module
To configure the Analysis-Module interface on the router that connects to an installed Network Analysis
Module (NM-NAM), use the interfaceanalysis-module command in global configuration mode. This command
does not have a not form.
interface analysis-module slot/unit
Syntax Description slot Number of the router chassis slot for the network module.
/ unit Number of the daughter card on the network module. For NM-NAM, always use 0. The slash (/)
between the slot and unit arguments is required.
Command Default The interface is not configured.
Command Modes Global configuration
Command History Release Modification
12.3(4)XD This command was introduced on the following platforms: Cisco 2600XM series, Cisco 2691,
Cisco 3660, Cisco 3725, and Cisco 3745.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T.
12.3(8)T4 This command was implemented on the following platforms: Cisco 2811, Cisco 2821, and the
Cisco 2851 series.
12.3(11)T This command was made available on the Cisco 3800 series.
Usage Guidelines The Analysis-Module interface is a Fast Ethernet interface on the router that connects to the internal interface
on the Network Analysis Module (NM-NAM).
This type of interface cannot be configured for subinterfaces or for speed, duplex mode, and similar parameters.
See the command-line interface (CLI) help for a list of valid parameters.
The interfaceanalysis-modulecommand enters Analysis-Module interface configuration mode.
Examples The following example shows how to configure the Analysis-Module interface when the NM-NAM
is in router slot 1:
Router(config)# interface analysis-module 1/0
Related Commands Command Description
ip unnumbered Enables IP processing on an interface without assigning an explicit IP
address to the interface.
show interfaces analysis-module Displays status, traffic data, and configuration information about the
Analysis-Module interface.
Cisco IOS Interface and Hardware Component Command Reference
546
I through K
interface content-engine
interface content-engine
The interfacecontent-enginecommand is now documented as the content-enginekeyword of the interface
command. For more information, see the interfacecommand.
Cisco IOS Interface and Hardware Component Command Reference
547
I through K
interface fastethernet
interface fastethernet
The interfacefastethernetcommand is now documented as the fastethernetkeyword of the interface command.
For more information, see the interface command.
Cisco IOS Interface and Hardware Component Command Reference
548
I through K
interface gigabitethernet
interface gigabitethernet
The interfacegigabitethernetcommand is now documented as the gigabitethernetkeyword of the interface
command. For more information, see the interface command.
Cisco IOS Interface and Hardware Component Command Reference
549
I through K
interface group-async
interface group-async
The interfacegroup-asynccommand is now documented as the group-asynckeyword of the interface
command. For more information, see the interface command.
Cisco IOS Interface and Hardware Component Command Reference
550
I through K
interface integrated-service-engine
interface integrated-service-engine
To configure the Cisco wireless LAN controller network module (WLCM) interface with dot1q encapsulation
on the router, use the interfaceintegrated-service-engine command.
interface integrated-service-engine slot/unit
Syntax Description slot/unit Specifies the router slot and unit numbers for the WLCM.
Command Default None
Command Modes Global configuration
Command History Release Modification
12.4(15)T This command was introduced.
Examples The following example shows how to create dot1Q virtual LAN (VLAN) subinterfaces under the
interfaceintegrated-service-engine command:
Router(config)# interface integrated-service-engine
1/0
Router(config-if)# exit
Router(config)# interface integrated-service-engine
1/0.10
Router(config-subif)# encapsulation dot1q
10
If the interface doesn't support baby giant frames
maximum mtu of the interface has to be reduced by 4
bytes on both sides of the connection to properly
transmit or receive large packets. Please refer to
documentation on configuring IEEE 802.1Q vLANs.
Router(config-subif)# end
Related Commands show interfaces integrated-service-engine
Cisco IOS Interface and Hardware Component Command Reference
551
I through K
interface ism
interface ism
To configure an interface on the router that connects to an internal service module (ISM), use the interfaceism
command in global configuration mode. This command does not have a no form.
interface ism slot/port
Syntax Description slot Router slot in which the service module is installed. For internal service modules, always use 0.
/ port Port number of the module interface. Range: 0 or 1. The slash mark (/) is required.
Command Default The interface is not configured.
Command Modes Global configuration (config)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines This command enters interface configuration mode to configure the interface between the router and the ISM
or between the ISM and Multi-Gigabit Fabric (MGF).
Examples The following example shows how to enter interface configuration mode for the ISM:
Router(config)# interface ism 0/0
Related Commands Command Description
ip unnumbered Enables IP processing on an interface without assigning an explicit IP address
to the interface.
service-module ip address Specifies the IP address of the module side of the interface.
show interfaces ism Displays status, traffic data, and configuration information about the ISM
interface.
Cisco IOS Interface and Hardware Component Command Reference
552
I through K
interface port-channel
interface port-channel
The interfaceport-channel command is now documented as the port-channelkeyword of the interface
command. For more information, see the interface command.
Cisco IOS Interface and Hardware Component Command Reference
553
I through K
interface pos
interface pos
The interfacepos command is now documented as the poskeyword of the interface command. For more
information, see the interfacecommand.
Cisco IOS Interface and Hardware Component Command Reference
554
I through K
interface range
interface range
To execute commands on multiple subinterfaces at the same time, use the interfacerange command in global
configuration mode.
interface range {type number [[-interface number]] [,]... type number|macro word}
no interface range type number
Syntax Description type number Interface type and interface or subinterface number. For more information about the
numbering syntax for your networking device, use the question mark (?) online help
function.
• You can enter any number of interface type and numbers.
- interface-number (Optional) Ending interface number.
, Allows you to configure more interface types.
macro Specifies a macro keyword.
word Previously defined keyword, up to 32 characters long.
Command Default No interface range is set.
Command Modes Global configuration (config)
Command History Release Modification
12.0(7)XE This command was introduced.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.
12.2(2)DD This command was expanded to support subinterface ranges.
12.2(4)B This command was integrated into Cisco IOS Release 12.2(4)B.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T.
12.2(18)SX This command was integrated into Cisco IOS Release 12.2(18)SX.
12.2(33)SXH The create keyword was added to enable the creation of VLANs that operate within a specified
range of physical interfaces.
Usage Guidelines Configuration Changes
All configuration changes made to a range of subinterfaces are saved to NVRAM, but the range itself does
not get saved to NVRAM. Use the defineinterfacerange command to create and save a range.
You can enter the range in two ways:
• Specifying up to five interface ranges
Cisco IOS Interface and Hardware Component Command Reference
555
I through K
interface range
• Specifying a previously defined macro
You can specify either the interfaces or the name of a range macro. A range must consist of the same interface
type, and the interfaces within a range cannot span slots.
You cannot specify both the interfacerangeand macro keywords in the same command. After creating a
macro, the command does not allow you to enter additional ranges. Likewise, if you have already specified
an interface range, the command does not allow you to enter a macro.
The spaces around the hyphen in the interfacerange command syntax are required. For example, using a
Catalyst 6500 router, the command interfacerangefastethernet1-6is valid; the command
interfacerangefastethernet1-6is not valid.
VLANs
When you define a Catalyst VLAN, valid values are from 1 to 4094. The last VLAN number cannot exceed
4094.
You cannot use the interfacerange command to create switch virtual interfaces (SVIs) in that particular range.
You can use the interfacerange command only to configure existing VLAN SVIs within the range. To display
VLAN SVIs, enter the showrunning-config command. VLANs not displayed cannot be used in the
interfacerange command.
The commands entered under theinterfacerange command are applied to all existing VLAN SVIs within the
range.
You can enter the command interfacerangecreatevlanx-y to create all VLANs in the specified range that do
not already exist. If you are using discontiguous VLANs, you can use the interfacerangevlan command to
configure multiple SVIs without creating unneeded SVIs and wasting interface descriptor blocks (IDBs).
After specifying a VLAN range, you can continue using the interfacerange command to specify another
interface (ATM, FastEthernet, GigabitEthernet, loopback, port-channel, or tunnel).
Examples
interface range Fast Ethernet Examples
The following example shows how to use the interfacerange command to configure a Fast Ethernet
range:
Router(config)# interface range fastethernet 5/1 - 4
The following example configures the Fast Ethernet subinterfaces within the range 5/1.1 to 5/1.4
and applies the following VLAN IDs to those subinterfaces:
Fast Ethernet5/1.1 = VLAN ID 301 (vlan-id)
Fast Ethernet5/1.2 = VLAN ID 302 (vlan-id = 301 + 2 - 1 = 302)
Fast Ethernet5/1.3 = VLAN ID 303 (vlan-id = 301 + 3 - 1 = 303)
Fast Ethernet5/1.4 = VLAN ID 304 (vlan-id = 301 + 4 - 1 = 304)
Router(config)# interface range fastethernet 5/1 - 4
Router(config-if-range)# encapsulation dot1q 301
Router(config-if-range)# no shutdown
Router(config-if)#
*Oct 6 08:24:35: %LINK-3-UPDOWN: Interface FastEthernet5/1.1, changed state to up
*Oct 6 08:24:35: %LINK-3-UPDOWN: Interface FastEthernet5/1.2, changed state to up
*Oct 6 08:24:35: %LINK-3-UPDOWN: Interface FastEthernet5/1.3, changed state to up
Cisco IOS Interface and Hardware Component Command Reference
556
I through K
interface range
*Oct 6 08:24:35: %LINK-3-UPDOWN: Interface FastEthernet5/1.4, changed state to up
*Oct 6 08:24:36: %LINEPROTO-5-UPDOWN: Line protocol on Interface FastEthernet5/1.1, changed
state to up
*Oct 6 08:24:36: %LINEPROTO-5-UPDOWN: Line protocol on Interface FastEthernet5/1.2, changed
state to up
*Oct 6 08:24:36: %LINEPROTO-5-UPDOWN: Line protocol on Interface FastEthernet5/1.3, changed
state to up
*Oct 6 08:24:36: %LINEPROTO-5-UPDOWN: Line protocol on Interface FastEthernet5/1.4, changed
state to up
interface range Gigabit Ethernet Example
The following example shows how to set a Gigabit Ethernet range:
Router(config)# interface range gigabitethernet 1/1 - 6
interface range Loopback Example
The following example shows how to use the loopback interface:
Router(config)# interface range loopback 34567
interface range Tunnel Example
The following example shows how to use the tunnel interface:
Router(config)# interface range tunnel 55555
interface range Port Channel Example
The following example shows how to use the port-channel interface:
Router(config)# interface range port-channel 100
interface range VLAN Examples
The following example shows how to set a VLAN:
Router(config)# interface range vlan 123
The following example shows how to create a range of VLANs:
Router(config)# interface range create vlan 4
interface range macro Example
The following example shows how to execute a range macro:
Cisco IOS Interface and Hardware Component Command Reference
557
I through K
interface range
Router(config)# interface range macro macro1
Related Commands Command Description
define interface range Defines an interface range macro.
encapsulation dot1q Applies a unique VLAN ID to each subinterface within the range.
interface vlan Configures a VLAN interface.
Cisco IOS Interface and Hardware Component Command Reference
558
I through K
interface satellite
interface satellite
To enter satellite interface configuration mode, use the interfacesatellite command in global configuration
mode.
interface satellite slot/unit
Syntax Description slot Router chassis slot in which the network module is installed.
unit Interface number. For NM-1VSAT-GILAT network modules, always use 0.
Command Default No default behavior or values
Command Modes Global configuration
Command History Release Modification
12.3(14)T This command was introduced.
Examples The following example shows how to enter satellite interface configuration mode:
Router(config)# interface satellite 1/0
Router(config-if)#
Related Commands Command Description
service-module satellite status Displays status information related to the hardware and software on the
Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT),
including the initial configuration parameters.
show controllers satellite Displays controller information about the internal router interface that
connects to an installed Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT).
show interface satellite Displays general interface settings and traffic rates for the internal router
interface that connects to an installed Cisco IP VSAT satellite WAN network
module (NM-1VSAT-GILAT).
Cisco IOS Interface and Hardware Component Command Reference
559
I through K
interface service-engine
interface service-engine
To enter the interface configuration mode for a network module (NM) or an advanced Integration Module
(AIM), use the interfaceservice-engine command in global configuration mode.
interface service-engine slot/port
Syntax Description slot Interface slot number.
port Interface port number.
Command Default No default behavior or values.
Command Modes Global configuration
Command History Release Modification
12.2(15)ZJ This command was introduced for NMs.
12.3(4)T This command was integrated into Cisco IOS Release 12.3(4)T.
12.3(7)T Support was added for AIMs.
Usage Guidelines This command may only be used for NMs and AIMs. If your system does not have this hardware, then you
will be unable to enter this command.
The no form of this command (nointerfaceservice-engine) is not available. The exit command can be used
to exit the interface configuration mode.
Examples The following example shows the command for entering configuration mode for either a NM or AIM
located in slot 1, unit 1:
Router (config)# interface service-engine 1/1
Router (config-if)# exit
Cisco IOS Interface and Hardware Component Command Reference
560
I through K
interface sm
interface sm
To configure an interface on the router that connects to an SM-SRE service module, use the interfacesm
command in global configuration mode. This command does not have a no form.
interface sm slot/port
Syntax Description slot Router slot in which the service module is installed. Range: 1 to 4.
/ port Port number of the module interface. Range: 0 or 1. The slash mark (/) is required.
Command Default The interface is not configured.
Command Modes Global configuration (config)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines This command enters interface configuration mode to configure the interface between the router and the
service module or between the service module and Multi-Gigabit Fabric (MGF).
Examples The following example shows how to enter interface configuration mode for the service module:
Router(config)# interface sm 1/0
Related Commands Command Description
ip unnumbered Enables IP processing on an interface without assigning an explicit IP address
to the interface.
service-module ip address Specifies the IP address of the module side of the interface.
show interfaces sm Displays status, traffic data, and configuration information about the service
module interface.
Cisco IOS Interface and Hardware Component Command Reference
561
I through K
interface vg-anylan
interface vg-anylan
The interfacevg-anylan command is now documented as the vg-anylan keyword of the interface command.
For more information, see the interfacecommand.
Cisco IOS Interface and Hardware Component Command Reference
562
I through K
interface vmi
interface vmi
To create a virtual multipoint interface (VMI) that can be configured and applied dynamically, use
theinterfacevmi command in global configuration mode. To remove a VMI interface, use the no form of this
command.
interface vmi interface-number
no interface vmi interface-number
Syntax Description interface-number Number assigned to the VMI. The value range for VMI interface numbers is from 1 to
2147483647
Command Default No VMI is defined.
Command Modes Global configuration (config)
Command History Release Modification
12.4(15)XF This command was introduced.
12.4(15)T This command was integrated into Cisco IOS Release 12.4(15)T.
Usage Guidelines VMI Interface Aggregation Point
The VMI interface acts as an aggregation point for multiple PPPoE connections from one or more radios over
one or more physical interfaces.
OSPFv3 and EIGRP Route Advertisements
All OSPFv3, EIGRPv4, and EIGRPv6 route advertisements that are received over the PPPoE connections are
reported to the routing protocol as coming from a single interface, thus simplifying the routing protocol
topology table and providing scalability benefits of each of the routing protocols.
Examples The following example shows how to create a VMI interface:
interface vmi 1
ip address 10.2.1.1 255.255.255.0
no ip redirects
no ip split-horizon eigrp 1
load-interval 30
ipv6 address 2001:0DB8:1:1:FFFF:FFFF:FFFF:FFFE/64
ipv6 enable
no ipv6 redirects
ipv6 eigrp 1
no ipv6 split-horizon eigrp 1
physical-interface GigabitEthernet 0/0
end
Related Commands Command Description
debug vmi Displays debugging output for virtual multipoint interfaces (VMIs).
Cisco IOS Interface and Hardware Component Command Reference
563
I through K
interface vmi
Command Description
eigrp interface Sets a threshold value to minimize hysteresis in a router-to-radio configuration.
mode bypass Enables virtual multipoint interfaces (VMIs) to support multicast traffic.
physical Creates a physical subinterface to be associated with the virtual multipoint interfaces
interface (VMIs) on a router.
Cisco IOS Interface and Hardware Component Command Reference
564
I through K
interface wlan-controller
interface wlan-controller
To configure the Cisco Wireless Local Area Network (WLAN) controller network module interface with
dot1q encapsulation on the router, use the interfacewlan-controller command in global configuration mode.
interface wlan-controller slot/unit
Syntax Description slot/unit Specifies the router slot and unit numbers for the WLAN controller network module.
Command Default None
Command Modes Global configuration
Command History Release Modification
12.4(2)XA1 This command was introduced on the router software.
12.4(6)T This command was integrated into Cisco IOS Release 12.4(6)T.
Examples The following example shows how to create dot1Q virtual LAN (VLAN) subinterfaces under interface
wlan-controller:
Router(config)# interface wlan-controller 1/0
Router(config-if)# exit
Router(config)# interface wlan-controller 1/0.10
Router(config-subif)# encapsulation dot1q 10
If the interface doesn't support baby giant frames
maximum mtu of the interface has to be reduced by 4
bytes on both sides of the connection to properly
transmit or receive large packets. Please refer to
documentation on configuring IEEE 802.1Q vLANs.
Router(config-subif)# end
Cisco IOS Interface and Hardware Component Command Reference
565
I through K
international bit
international bit
To set the E3 international bit in the G.751 frame used by the PA-E3 port adapter, use the
internationalbitcommand in interface configuration mode. To return to the default international bit, use the
no form of this command.
international bit commandinternational bit {0|1} {0|1}
no international bit
Syntax Description 0 Sets either of the two required E3 international bits in the G.751 frame to 0. This is the default.
1 Sets either of the two required E3 international bits in the G.751 frame to 1.
Command Default The default value for each bit is 0.
Command Modes Interface configuration
Command History Release Modification
11.1 CA This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The internationalbit command sets bits 6 and 8, respectively, of set II in the E3 frame.
To verify the international bit configured on the interface, use the showcontrollersserial EXEC command.
Examples The following example sets the international bit to 1 1 on the PA-E3 port adapter in slot 1, port
adapter slot 0, interface 0:
Router(config)# interface serial 1/0/0
Router(config-if)# international bit 1 1
Related Commands Command Description
national bit (interface) Sets the E3 national bit in the G.751 frame used by the PA-E3 port adapter.
show controllers serial Displays information that is specific to the interface hardware.
Cisco IOS Interface and Hardware Component Command Reference
566
I through K
inter-packet gap 6502-mode
inter-packet gap 6502-mode
To set the Inter-Packet Gap (IPG) value, use the inter-packetgap6502-modecommand in interface configuration
mode. To return to the default setting, use the no form of this command.
inter-packet gap 6502-mode
no inter-packet gap 6502-mode
Syntax Description This command has no keywords or arguments.
Command Default All fragments from flows that are received from an ACE with Layer 4 ports and permit action are permitted.
All other fragments are dropped in the hardware. This action also applies to flows that are handled in the
software regardless of this command setting.
Command Modes Interface configuration
Command History Release Modification
12.2(18)SXF5 This command was introduced on the Supervisor Engine 720.
Usage Guidelines This command is supported only when a WS-X6704-10GE is connected to a WS-X6502-10GE. You enter
this command to change the IPG value of the WS-X6704-10GE to match the IPG value of the WS-X6502-10GE.
The default 6704 mode sets the IPG value to average 12. Based on packet size, the IPG between successive
packets ranges from 9 to 15.
The 6502 mode sets the IPG value to average 16. Based on packet size, the IPG between successive packets
ranges from 13 to 19.
Examples This example shows how to set the IPG to 6502 mode:
inter-packet gap 6502-mode
This example shows how to set the IPG to the default mode:
no inter-packet gap 6502-mode
Cisco IOS Interface and Hardware Component Command Reference
567
I through K
invert data
invert data
To invert the data stream, use the invertdata command in interface configuration mode. This command applies
only to the Cisco 7000 series routers with the RSP7000 and RSP7000CI, Cisco 7200 series routers, and Cisco
7500 series routers. To disable inverting the data stream, use the no form of this command.
invert data commandinvert data
no invert data
Syntax Description This command has no arguments or keywords.
Command Default Data is not inverted.
Command Modes Interface configuration
Command History Release Modification
11.1CA This command was introduced.
11.2P This command was integrated into Cisco IOS Release 11.2 P.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines T1 Line Without B8ZS Encoding
If the interface on the PA-8T and PA-4T+ synchronous serial port adapters and the PA-T3 and PA-2T3
synchronous serial port adapters is used to drive a dedicated T1 line that does not have B8ZS encoding (a
method to avoid 15 zeros), the data stream must be inverted (both transmitting and receiving data) either in
the connecting CSU/DSU or in the interface.
Inverting is a method of avoiding excessive zeroes that is superseded by the use of B8ZS encryption. This
option could be needed for use with legacy equipment that supports this option. By inverting the High-Level
Data Link Control (HDLC) data stream, the HDLC zero insertion algorithm becomes a ones insertion algorithm
that satisfies the T1 requirements. Be careful not to invert data both on the interface and on the CSU/DSU
because two data inversions will cancel each other out.
AMI Line Coding
If the interface on the CT3IP uses alternate mark inversion (AMI) line coding, you must also invert the data
on the T1 channel. For more information, see the t1linecodecontroller configuration command.
Examples The following example inverts data on serial interface 3/1/0:
Router(config)# interface serial 3/1/0
Router(config-if)# invert data
Cisco IOS Interface and Hardware Component Command Reference
568
I through K
invert data
Related Commands Command Description
t1 linecode Specifies the type of linecoding used by the T1 channels on the CT3IP in Cisco 7500 series
routers.
Cisco IOS Interface and Hardware Component Command Reference
569
I through K
invert rxclock
invert rxclock
To invert the phase of the receive (RX) clock signal on the universal I/O (UIO) serial interface that does not
use the T1/E1 interface, use the invertrxclock command in interface configuration mode. To disable the phase
inversion, use the no form of this command.
invert rxclock commandinvert rxclock
no invert rxclock
Syntax Description This command has no arguments or keywords.
Command Default The receive clock signal is not inverted.
Command Modes Interface configuration
Command History Release Modification
11.3 MA This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines When a delay occurs between a signal being sent and the signal being received it can indicate that the receive
clock signal is not appropriate for the interface rate. This command allows the receive clock signal to be
inverted to attempt to correct the delay.
Examples The following example inverts the receive clock signal on serial interface 1:
Router(config)# interface serial 1
Router(config-if)# invert rxclock
Cisco IOS Interface and Hardware Component Command Reference
570
I through K
invert txclock
invert txclock
To invert the transmit (TX) clock signal, use the inverttxclock command in interface configuration mode.
To return the TX clock signal to its initial state, use the no form of this command.
invert txclock
no invert txclock
Syntax Description This command has no arguments or keywords.
Command Default The transmit clock signal is not inverted.
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
11.3 The invert-transmit-clock command was replaced by the inverttxclock command.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Delays between the serial clock transmit external (SCTE) clock and data transmission indicate that the TX
clock signal might not be appropriate for the interface rate and length of cable being used. Different ends of
the wire can have variances that differ slightly. The inverttxclock command compensates for these variances.
This command replaces the invert-transmit-clock command.
Systems that use long cables or cables that are not transmitting the TxC signal (transmit echoed clock line,
also known as TXCE or SCTE clock) can experience high error rates when operating at the higher transmission
speeds. For example, if a PA-8T synchronous serial port adapter is reporting a high number of error packets,
a phase shift might be the problem. Inverting the clock might correct this shift.
When a PA-8T or PA-4T+ port adapter interface is DTE, the inverttxclockcommand inverts the TxC signal
it received from the remote DCE. When the PA-8T or PA-4T+ port adapter interface is DCE, this command
changes the signal back to its original phase.
Examples The following example inverts the TX clock signal on serial interface 3/0:
Router(config)# interface serial 3/0
Router(config-if)# invert txclock
Cisco IOS Interface and Hardware Component Command Reference
571
I through K
ip dscp
ip dscp
To enable the use of IP differentiated services code point (DSCP) for packets that originate from a circuit
emulation (CEM) channel, use the ipdscp command in CEM configuration mode. To disable the use of IP
DSCP, use the no form of this command.
ip dscp [dscp-value]
no ip dscp
Syntax Description dscp-value (Optional) Value placed in the DSCP field of IP packets that originate from a CEM channel.
Range is from 0 to 63. Default is 46.
Command Default IP DSCP is enabled for packets that originate from a CEM channel.
Command Modes CEM configuration
Command History Release Modification
12.3(7)T This command was introduced.
Usage Guidelines DSCP is mutually exclusive from both IP type of service (ToS) and IP precedence. Thus, if DSCP is configured,
the iptos command and the ipprecedence command are both unavailable at the command-line interface (CLI).
Examples The following example shows how to set the IP DSCP field value to 36.
Router(config-cem)# ip dscp 36
Related Commands Command Description
ip precedence Configures the IP precedence bits for the CEM channel.
ip tos Configures the IP ToS bits for the CEM channel.
Cisco IOS Interface and Hardware Component Command Reference
572
I through K
ip pxf
ip pxf
To manually enable the PXF processors, use the ippxf command in global configuration mode. To manually
disable the PXF processors, use the no form of this command.
ip pxf
no ip pxf
Syntax Description This command has no arguments or keywords.
Command Default The PXF processors are enabled by default.
Command Modes Global configuration
Command History Release Modification
12.1(9)EX This command was introduced.
12.2(18)S This command was introduced on Cisco 7304 routers running Cisco IOS Release 12.2(18)S.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The PXF processors are enabled by default. If they are ever disabled, you must enable them to take advantage
of IP packet switching and feature acceleration. The PXF processors should never be disabled except for very
short durations for debugging purposes.
Note You must also have IP Cisco Express Forwarding switching turned on for accelerated IP packet switching.
Examples The following example enables the PXF processors:
ip pxf
Related Commands Command Description
show c7300 pxf accounting Displays the number of packets entering or exiting the PXF processors.
show pxf accounting Displays the PXF accounting.
show c7300 pxf interfaces Displays the status of various interfaces known to the PXF processors.
show pxf interfaces Displays a list of PXF interfaces.
Cisco IOS Interface and Hardware Component Command Reference
573
I through K
ip rbscp ack-split
ip rbscp ack-split
To configure the TCP ACK splitting feature of the Rate-Based Satellite Control Protocol (RBSCP) on an
outgoing interface for packets that are permitted by a specified access list, use the iprbscpack-splitcommand
in interface configuration mode. To disable the feature on the interface, use the no form of this command.
ip rbscp ack-split size {access-list-nameaccess-list-number} out
no ip rbscp ack-split
Syntax Description size The number of TCP ACKs to send for every TCP ACK received. A sizeof 0 or
1 indicates that this feature is disabled (that is, no TCP ACK splitting will occur).
The range is 0 through 32.
access-list-name | Standard or extended IP access list name or number that controls which packets
access-list-number are subject to TCP ACK splitting. That is, the feature is applied to packets that
a permit statement allows; the feature is not applied to packets that a deny
statement filters.
out Specifies that this feature is applied to an outgoing interface.
Command Default Disabled (TCP ACK splitting is not required on an outgoing interface for packets that are permitted by a
specified acccess list).
Command Modes Interface configuration
Command History Release Modification
12.4(9)T This command was introduced.
Usage Guidelines This command enables TCP ACK splitting for outgoing packets that are permitted by the access list. TCP
ACK splitting is a software technique to improve performance for clear-text TCP traffic using acknowledgment
(ACK) splitting, in which a number of additional TCP ACKs are generated for each TCP ACK received.
TCP ACK splitting causes TCP to open the congestion window more quickly than usual, thus decreasing the
effect of long latencies. TCP will generally open the congestion window by one maximum transmission unit
(MTU) for each TCP ACK received. Opening the congestion window results in increased bandwidth becoming
available. Configure this feature only when the satellite link is not using all the available bandwidth. Encrypted
traffic cannot use TCP ACK splitting.
Caution Plan your network carefully so that no more than one Cisco IOS router in a given routing path has this feature
enabled. You do not want to recursively ACK-split traffic.
An interface can use only one instance of this feature at a time. Each instance of this feature can be used on
multiple interfaces.
If you configure this feature but it refers to a nonexistent access list, this is interpreted as having an access
list that denies all traffic from being processed by the Access-List-Based RBSCP feature, so the feature is
essentially disabled and the traffic goes through the normal switching path.
Cisco IOS Interface and Hardware Component Command Reference
574
I through K
ip rbscp ack-split
Examples In the following example, the access list performs TCP ACK splitting on packets going out Ethernet
interface 0 from a source at 172.22.18.5 to a destination at 172.23.27.4:
ip access-list extended satellite
permit tcp 172.22.18.5 172.23.27.4
exit
interface ethernet 0
ip rbscp ack-split 6 satellite out
Related Commands Command Description
debug ip rbscp Displays general error messages about access-list-based RBSCP.
debug ip rbscp ack-split Displays information about TCP ACK splitting done in conjunction with RBSCP.
Cisco IOS Interface and Hardware Component Command Reference
575
I through K
ip verify unicast source reachable-via
ip verify unicast source reachable-via
To enable Unicast Reverse Path Forwarding (Unicast RPF), use the ip verify unicast source reachable-via
command in interface configuration mode. To disable Unicast RPF, use the no form of this command.
ip verify unicast source reachable-via {any|rx [l2-src]} [allow-default] [allow-self-ping] [access-list]
no ip verify unicast source reachable-via
Syntax Description any Examines incoming packets to determine whether the source address is in the Forwarding
Information Base (FIB) and permits the packet if the source is reachable through any
interface (sometimes referred to as loose mode).
rx Examines incoming packets to determine whether the source address is in the FIB and
permits the packet only if the source is reachable through the interface on which the packet
was received (sometimes referred to as strict mode).
l2-src (Optional) Enables source IPv4 and source MAC address binding.
allow-default (Optional) Allows the use of the default route for RPF verification.
allow-self-ping (Optional) Allows a router to ping its own interface or interfaces.
Caution Use caution when enabling the allow-self-ping keyword. This keyword opens
a denial-of-service (DoS) hole.
access-list (Optional) Specifies a numbered access control list (ACL) in the following ranges:
• 1 to 99 (IP standard access list)
• 100 to 199 (IP extended access list)
• 1300 to 1999 (IP standard access list, expanded range)
• 2000 to 2699 (IP extended access list, expanded range)
Command Default Unicast RPF is disabled.
Source IPv4 and source MAC address binding is disabled.
Command Modes
Interface configuration (config-if)
Command History Release Modification
11.1(CC), This command was introduced. This command was not included in Cisco IOS Release 11.2
12.0 or 11.3.
12.1(2)T Added access control list (ACL) support using the access-list argument. Added per-interface
statistics on dropped or suppressed packets.
12.0(15)S This command replaced the ip verify unicast reverse-path command, and the following
keywords were added: allow-default, allow-self-ping, rx, and any.
Cisco IOS Interface and Hardware Component Command Reference
576
I through K
ip verify unicast source reachable-via
Release Modification
12.1(8a)E This command was integrated into Cisco IOS Release 12.1(8a)E.
12.2(14)S This command was integrated into Cisco IOS Release 12.2(14)S.
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command was introduced on the Supervisor Engine 2.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SRC This command was modified. The l2-src keyword was added to support the source IPv4 and
source MAC address binding feature on platforms that support the Cisco Express Forwarding
software switching path.
15.0(1)M This command was integrated into Cisco IOS Release 15.0(1)M.
Usage Guidelines Use the ip verify unicast source reachable-via interface command to mitigate problems caused by malformed
or forged (spoofed) IP source addresses that pass through a router. Malformed or forged source addresses can
indicate DoS attacks based on source IP address spoofing.
To use Unicast RPF, enable Cisco Express Forwarding or distributed Cisco Express Forwarding in the router.
There is no need to configure the input interface for Cisco Express Forwarding. As long as Cisco Express
Forwarding is running on the router, individual interfaces can be configured with other switching modes.
Note It is important for Cisco Express Forwarding to be configured globally on the router. Unicast RPF does not
work without Cisco Express Forwarding.
Note Unicast RPF is an input function and is applied on the interface of a router only in the ingress direction.
When Unicast RPF is enabled on an interface, the router examines all packets that are received on that interface.
The router checks to make sure that the source address appears in the FIB. If the rx keyword is selected, the
source address must match the interface on which the packet was received. If the any keyword is selected,
the source address must be present only in the FIB. This ability to "look backwards" is available only when
Cisco Express Forwarding is enabled on the router because the lookup relies on the presence of the FIB. Cisco
Express Forwarding generates the FIB as part of its operation.
Note If the source address of an incoming packet is resolved to a null adjacency, the packet will be dropped. The
null interface is treated as an invalid interface by the new form of the Unicast RPF command. The older form
of the command syntax did not exhibit this behavior.
Unicast RPF checks to determine whether any packet that is received at a router interface arrives on one of
the best return paths to the source of the packet. If a reverse path for the packet is not found, Unicast RPF can
drop or forward the packet, depending on whether an ACL is specified in the Unicast RPF command. If an
ACL is specified in the command, when (and only when) a packet fails the Unicast RPF check, the ACL is
Cisco IOS Interface and Hardware Component Command Reference
577
I through K
ip verify unicast source reachable-via
checked to determine whether the packet should be dropped (using a deny statement in the ACL) or forwarded
(using a permit statement in the ACL). Whether a packet is dropped or forwarded, the packet is counted in
the global IP traffic statistics for Unicast RPF drops and in the interface statistics for Unicast RPF.
If no ACL is specified in the ip verify unicast source reachable-via command, the router drops the forged
or malformed packet immediately, and no ACL logging occurs. The router and interface Unicast RPF counters
are updated.
Unicast RPF events can be logged by specifying the logging option for the ACL entries that are used by the
ip verify unicast source reachable-via command. Log information can be used to gather information about
the attack, such as source address, time, and so on.
Strict Mode RPF
If the source address is in the FIB and reachable only through the interface on which the packet was received,
the packet is passed. The syntax for this method is ip verify unicast source reachable-via rx.
Exists-Only (or Loose Mode) RPF
If the source address is in the FIB and reachable through any interface on the router, the packet is passed. The
syntax for this method is ip verify unicast source reachable-via any.
Because this Unicast RPF option passes packets regardless of which interface the packet enters, it is often
used on Internet service provider (ISP) routers that are "peered" with other ISP routers (where asymmetrical
routing typically occurs). Packets using source addresses that have not been allocated on the Internet, which
are often used for spoofed source addresses, are dropped by this Unicast RPF option. All other packets that
have an entry in the FIB are passed.
allow-default
Normally, sources found in the FIB but only by way of the default route will be dropped. Specifying the
allow-default keyword option will override this behavior. You must specify the allow-default keyword in
the command to permit Unicast RPF to successfully match on prefixes that are known through the default
route to pass these packets.
allow-self-ping
This keyword allows the router to ping its own interface or interfaces. By default, when Unicast RPF is enabled,
packets that are generated by the router and destined to the router are dropped, thereby, making certain
troubleshooting and management tasks difficult to accomplish. Issue the allow-self-ping keyword to enable
self-pinging.
Caution Caution should be used when enabling the allow-self-ping keyword because this option opens a potential
DoS hole.
Using RPF in Your Network
Use Unicast RPF strict mode on interfaces where only one path allows packets from valid source networks
(networks contained in the FIB). Also, use Unicast RPF strict mode when a router has multiple paths to a
given network, as long as the valid networks are switched through the incoming interfaces. Packets for invalid
networks will be dropped. For example, routers at the edge of the network of an ISP are likely to have
symmetrical reverse paths. Unicast RPF strict mode is applicable in certain multihomed situations, provided
that optional Border Gateway Protocol (BGP) attributes, such as weight and local preference, are used to
achieve symmetric routing.
Cisco IOS Interface and Hardware Component Command Reference
578
I through K
ip verify unicast source reachable-via
Note With Unicast RPF, all equal-cost "best" return paths are considered valid. This means that Unicast RPF works
in cases where multiple return paths exist, provided that each path is equal to the others in terms of the routing
cost (number of hops, weights, and so on) and as long as the route is in the FIB. Unicast RPF also functions
where Enhanced Internet Gateway Routing Protocol (EIGRP) variants are being used and unequal candidate
paths back to the source IP address exist.
Use Unicast RPF loose mode on interfaces where asymmetric paths allow packets from valid source networks
(networks contained in the FIB). Routers that are in the core of the ISP network have no guarantee that the
best forwarding path out of the router will be the path selected for packets returning to the router.
IP and MAC Address Spoof Prevention
In Release 15.0(1)M and later, you can use the l2-srckeyword to enable source IPv4 and source MAC address
binding. To disable source IPv4 and source MAC address binding, use the no form of the ip verify unicast
source reachable-viacommand.
If an inbound packet fails this security check, it will be dropped and the Unicast RPF dropped-packet counter
will be incremented. The only exception occurs if a numbered access control list has been specified as part
of the Unicast RPF command in strict mode, and the ACL permits the packet. In this case the packet will be
forwarded and the Unicast RPF suppressed-drops counter will be incremented.
Note The l2-src keyword cannot be used with the loose uRPF command, ip verify unicast source reachable-via
anycommand.
Not all platforms support the l2-src keyword. Therefore, not all the possible keyword combinations for strict
Unicast RPF in the following list will apply to your platform:
Possible keyword combinations for strict Unicast RPF include the following:
allow-default
allow-self-ping
l2-src
<ACL-number>
allow-default allow-self-ping
allow-default l2-src
allow-default <ACL-number>
allow-self-ping l2-src
allow-self-ping <ACL-number>
l2-src <ACL-number>
allow-default allow-self-ping l2-src
allow-default allow-self-ping <ACL-number>
allow-default l2-src <ACL-number>
allow-self-ping l2-src <ACL-number>
allow-default allow-self-ping l2-src <ACL-number>
Examples
Single-Homed ISP Connection with Unicast RPF
The following example uses a very simple single-homed ISP connection to demonstrate the concept
of Unicast RPF. In this example, an ISP peering router is connected through a single serial interface
Cisco IOS Interface and Hardware Component Command Reference
579
I through K
ip verify unicast source reachable-via
to one upstream ISP. Hence, traffic flows into and out of the ISP will be symmetric. Because traffic
flows will be symmetric, a Unicast RPF strict-mode deployment can be configured.
ip cef
! or "ip cef distributed" for Route Switch Processor+Versatile Interface Processor-
(RSP+VIP-) based routers.
!
interface Serial5/0/0
description - link to upstream ISP (single-homed)
ip address 192.168.200.225 255.255.255.252
no ip redirects
no ip directed-broadcasts
no ip proxy-arp
ip verify unicast source reachable-via
ACLs and Logging with Unicast RPF
The following example demonstrates the use of ACLs and logging with Unicast RPF. In this example,
extended ACL 197 provides entries that deny or permit network traffic for specific address ranges.
Unicast RPF is configured on interface Ethernet 0/1/1 to check packets arriving at that interface.
For example, packets with a source address of 192.168.201.10 arriving at interface Ethernet 0/1/1
are dropped because of the deny statement in ACL 197. In this case, the ACL information is logged
(the logging option is turned on for the ACL entry) and dropped packets are counted per-interface
and globally. Packets with a source address of 192.168.201.100 arriving at interface Ethernet 0/1/2
are forwarded because of the permit statement in ACL 197. ACL information about dropped or
suppressed packets is logged (the logging option is turned on for the ACL entry) to the log server.
ip cef distributed
!
int eth0/1/1
ip address 192.168.200.1 255.255.255.0
ip verify unicast source reachable-via rx 197
!
int eth0/1/2
ip address 192.168.201.1 255.255.255.0
!
access-list 197 deny ip 192.168.201.0 0.0.0.63 any log-input
access-list 197 permit ip 192.168.201.64 0.0.0.63 any log-input
access-list 197 deny ip 192.168.201.128 0.0.0.63 any log-input
access-list 197 permit ip 192.168.201.192 0.0.0.63 any log-input
access-list 197 deny ip host 0.0.0.0 any log-input
access-list 197 deny ip 172.16.0.0 0.255.255.255 any log-input
access-list 197 deny ip 10.0.0.0 0.255.255.255 any log-input
access-list 197 deny ip 172.16.0.0 0.15.255.255 any log-input
access-list 197 deny ip 192.168.0.0 0.0.255.255 any log-input
MAC Address Binding on Software Switching Platforms Like the Cisco 7200 Series Routers
The following example shows how to enable source IPv4 and source MAC address binding on
Ethernet 0/0:
Router# configure terminal
Router(config)# interface Ethernet0/0
Router(config-if)# ip address 10.0.0.1 255.255.255.0
Router(config-if)# ip verify unicast source reachable-via rx l2-src
Cisco IOS Interface and Hardware Component Command Reference
580
I through K
ip verify unicast source reachable-via
Related Commands Command Description
ip cef Enables Cisco Express Forwarding on the route processor card.
ip cef distributed Enables Cisco Express Forwarding on the line card.
Cisco IOS Interface and Hardware Component Command Reference
581
I through K
ipc buffers
ipc buffers
To resize the interprocessor communication (IPC) buffer pool, use the ipcbuffers command in global
configuration mode. To disable the configuration, use the no form of this command.
ipc buffers {max-free|min-free|permanent} buffers
no ipc buffers {max-free|min-free|permanent}
Syntax Description max-free buffers Specifies the maximum number of buffers that must be free. The range is from 8 to
10000.
min-free buffers Specifies the minimum number of buffers that must be free. The range is from 1 to
17.
permanent buffers Specifies the number of buffers that must be permanantly allocated for IPC apart
from the buffers that are dynamically allocated and freed. The range is from 2 to
5000.
Command Default The default buffer value is set by the platform during initialization.
Command Modes Global configuration (config)
Command History Release Modification
15.0(1)M This command was introduced in a release earlier than Cisco IOS Release
15.0(1)M.
Cisco IOS XE Release 2.1 This command was implemented on the Cisco ASR 1000 Series Aggregation
Services Routers.
Usage Guidelines You can use the ipcbuffers command when you would want to resize the buffer pool.
Examples The following example shows how to set the maximum number of free buffers to 10:
Router(config)# ipc buffers max-free 10
Related Commands Command Description
ipc holdq threshold Configures IPC holdq threshold values.
show ipc Displays IPC statistics.
Cisco IOS Interface and Hardware Component Command Reference
582
I through K
ipc header-cache
ipc header-cache
To resize the interprocess communication (IPC) permanent cache, use the ipcheader-cache command in
global configuration mode. To disable the configuration, use the no form of this command.
ipc header-cache permanent high-cache low-cache
no ipc header-cache permanent
Syntax Description permanent Specifies the permanent IPC cache.
high-cache Maximum permanent cache size. The range is from 1000 to 10000.
low-cache Lower cache watermark. The range is from 100 to 2000.
Command Default The default values are set by the platform during initialization.
Command Modes Global configuration (config)
Command History Release Modification
15.0(1)M This command was introduced in a release earlier than Cisco IOS Release
15.0(1)M.
Cisco IOS XE Release 2.1 This command was implemented on the Cisco ASR 1000 Series Aggregation
Services Routers.
Examples The following example shows how to set the maximum permanent cache value to 1000 and lower
cache value to 200 of an IPC server:
Router(config)# ipc header-cache permanent 1000 200
Related Commands Command Description
ipc holdq threshold Configures IPC holdq threshold values.
show ipc Displays IPC statistics.
Cisco IOS Interface and Hardware Component Command Reference
583
I through K
ipc holdq threshold
ipc holdq threshold
To configure interprocessor communication (IPC) holdq threshold values, use the ipcholdqthresholdcommand
in global configuration mode. To disable the configuration, use the no form of this command.
ipc holdq threshold {lower start-threshold|upper stop-threshold}
no ipc holdq threshold {lower|upper}
Syntax Description lower Specifies the lower threshold for IPC holdq.
start-threshold Threshold to start sending IPC messages. The range is from 10 to 2000.
upper Specifies the upper threshold for IPC holdq.
stop-threshold Threshold to stop sending IPC messages. The range is from 40 to 4000.
Command Default The default values threshold is set by the platform during initialization.
Command Modes Global configuration (config)
Command History Release Modification
15.0(1)M This command was introduced in a release earlier than Cisco IOS Release
15.0(1)M.
12.2(33)SXI This command was integrated into a release earlier than Cisco IOS Release
12.2(33)SXI.
Cisco IOS XE Release 2.1 This command was implemented on the Cisco ASR 1000 Series Aggregation
Services Routers.
Usage Guidelines The holdq OFF and ON thresholds are used to throttle the message sent based on the traffic at the driver. If
the number of messages to be processed by the driver has increased than the OFF threshold, then the messages
are not passed from the transport layer to the driver. The messages will be sent again once the count decreases
below the ON threshold.
You can use theipcholdqcommand when the driver message processing speed has decreased or increased to
a greater extent than the specifications.
Examples The following example shows how to configure a lower threshold value of 100 for IPC holdq:
Router(config)# ipc holdq threshold lower 100
Related Commands Command Description
ipc buffers Resizes the IPC buffer pool.
show ipc Displays IPC statistics.
Cisco IOS Interface and Hardware Component Command Reference
584
I through K
ipc master
ipc master
To configure the IP address of the interprocessor communication (IPC) master server, use the ipcmaster
command in global configuration mode. To disable the configuration, use the no form of this command.
ipc master {ip-address|self}
no ipc master
Syntax Description ip-address IP address of the master server.
self Assigns the host as the IPC master server.
Command Default IP address is not configured.
Command Modes Global configuration (config)
Command History Release Modification
15.0(1)M This command was introduced in a release earlier than Cisco IOS Release 15.0(1)M.
Examples The following example shows how to configure 192.0.2.1 as the IP address of the master server:
Router(config)# ipc master 192.0.2.1
Related Commands Command Description
ipc buffers Resizes the IPC buffer pool.
show ipc Displays IPC statistics.
Cisco IOS Interface and Hardware Component Command Reference
585
I through K
ipc zone default
ipc zone default
To enter interprocess communication (IPC) zone configuration mode, use the ipczonedefaultcommand in
global configuration mode. To remove a previously configured association, use the no form of this command.
ipc zone default
no ipc zone default
Syntax Description This command has no arguments or keywords.
Command Default The user is not in IPC zone configuration mode.
Command Modes Global configuration
Command History Release Modification
12.3(7)T This command was introduced.
Usage Guidelines The ipczonedefault command places the router into IPC zone configuration mode. In this mode, the user can
configure the default IPC zone.
The no form of the ipczonedefault command removes any previously configured association.
Examples The following example places the router into IPC zone configuration mode:
Router(config)# ipc zone default
Router(config-ipczone)#
Related Commands Command Description
show ipc Displays IPC statistics.
Cisco IOS Interface and Hardware Component Command Reference
586
I through K
iphc-profile
iphc-profile
To create an IP Header Compression (IPHC) profile and to enter IPHC-profile configuration mode, use the
iphc-profile command in global configuration mode. To attach an existing IPHC profile to an interface or
subinterface, use the iphc-profile command in interface configuration mode. To delete the IPHC profile, use
the no form of this command.
iphc-profile profile-name {ietf|van-jacobson}
no iphc-profile profile-name
Syntax Description profile-name Name of the IPHC profile to be created or attached. The IPHC profile name can be a
maximum of 32 characters. The name may not include quotation marks, white space, or
special characters.
ietf Specifies that the IPHC profile is for Internet Engineering Task Force (IETF) header
compression.
van-jacobson Specifies that the IPHC profile is for Van Jacobson header compression.
Command Default No IPHC profile is created or attached.
Command Modes Global configuration (to create an IPHC profile) Interface configuration (to attach an existing IPHC profile
to an interface or subinterface)
Command History Release Modification
12.4(9)T This command was introduced.
Usage Guidelines The iphc-profile command creates an IPHC profile used for enabling header compression and enters
IPHC-profile configuration mode (config-iphcp). An IPHC profile is a template within which you can configure
the type of header compression that you want to use, enable any optional features and settings for header
compression, and then apply the profile to an interface, a subinterface, or a Frame Relay permanent virtual
circuit (PVC).
Specifying the IPHC Profile Type
When you create an IPHC profile, you must specify the IPHC profile type by using either the ietf keyword
or the van-jacobson keyword. The IETF profile type conforms to and supports the standards established with
RFC 2507, RFC 2508, RFC 3544, and RFC 3545 and is typically associated with non-TCP header compression
(for example, RTP header compression). The Van Jacobson profile type conforms to and supports the standards
established with RFC 1144 and is typically associated with TCP header compression.
Note If you are using Frame Relay encapsulation, you must specify the ietfkeyword (not the van-jacobson keyword).
Considerations When Specifying the IPHC Profile Type
When specifying the IPHC profile type, consider whether you are compressing TCP traffic or non-TCP traffic
(that is, RTP traffic). Also consider the header compression format capabilities of the remote network link
Cisco IOS Interface and Hardware Component Command Reference
587
I through K
iphc-profile
that will receive traffic. The IPHC profile type that you specify directly affects the header compression format
used on the remote network links to which the IPHC profile is applied. Only TCP traffic is compressed on
remote network links using a Van Jacobson IPHC profile, whereas TCP and/or non-TCP traffic (for example,
RTP traffic) is compressed on remote network links using an IETF IPHC profile.
Note The header compression format in use on the router that you are configuring and the header compression
format in use on the remote network link must match.
Configurable Header Compression Features and Settings
The specific set of header compression features and settings that you can configure (that is, enable or modify)
is determined by the IPHC profile type that you specify (either IETF or Van Jacobson) when you create the
IPHC profile. Both sets are listed below.
If you specify Van Jacobson as the IPHC profile type, you can enable TCP header compression and set the
number of TCP contexts. The table below lists each available Van Jacobson IPHC profile type header
compression feature and setting and the command used to enable it.
Table 21: Van Jacobson IPHC Profile Type Header Compression Features and Settings
Command Feature or Setting
tcp Enables TCP header compression.
tcp contexts Sets the number of contexts available for TCP header compression.
If you specify IETF as the IPHC profile type, you can enable non-TCP header compression (that is, RTP
header compression), along with a number of additional features and settings. The table below lists each
available IETF IPHC profile type header compression feature and setting and the command or commands
used to enable it.
Table 22: IETF IPHC Profile Type Header Compression Features and Settings
Command Feature or Setting
feedback Enables the context-status feedback messages from the interface or
link.
maximum header Sets the maximum size of the compressed IP header.
non-tcp Enables non-TCP header compression.
non-tcp contexts Sets the number of contexts available for non-TCP header
compression.
rtp Enables RTP header compression.
recoverable-loss Enables Enhanced Compressed Real-Time Transport Protocol
(ECRTP) on an interface.
refresh max-period refresh Sets the context refresh (full-header refresh) options, such as the
max-time refresh rtp amount of time to wait before a full header is refreshed.
Cisco IOS Interface and Hardware Component Command Reference
588
I through K
iphc-profile
Command Feature or Setting
tcp Enables TCP header compression.
tcp contexts Sets the number of contexts available for TCP header compression.
For More Information About IPHC Profiles
For more information about using IPHC profiles to configure header compression, see the “Header
Compression” module and the “Configuring Header Compression Using IPHC Profiles” module of the Cisco
IOS Quality of Service Solutions Configuration Guide, Release 12.4T.
Examples In the following example, an IPHC profile called profile1 is created, and the Van Jacobson IPHC
profile type is specified.
Router> enable
Router# configure terminal
Router(config)# iphc-profile profile1 van-jacobson
Router(config-iphcp)# end
In the following example, a second IPHC profile called profile2 is created. For this IPHC profile,
the IETF IPHC profile type is specified.
Router> enable
Router# configure terminal
Router(config)# iphc-profile profile2 ietf
Router(config-iphcp)# end
In the following example, an existing IPHC profile called profile2 is attached to serial interface 3/0.
For this IPHC profile, the IPHC profile type (in this case, IETF) of profile2 is specified.
Router> enable
Router# configure terminal
Router(config)# interface serial 3/0
Router(config-if)# iphc-profile profile2 ietf
Router(config-iphcp)# end
Related Commands Command Description
feedback Enables the context-status feedback messages from the interface or link.
maximum header Specifies the maximum size of the compressed IP header.
non-tcp Enables non-TCP header compression within an IPHC profile.
non-tcp contexts Sets the number of contexts available for non-TCP header compression.
recoverable-loss Enables ECRTP on an interface.
refresh max-period Sets the number of packets sent between full-header refresh occurrences.
refresh max-time Sets the amount of time to wait before a full-header refresh occurrence.
refresh rtp Enables a context refresh occurrence for RTP header compression.
Cisco IOS Interface and Hardware Component Command Reference
589
I through K
iphc-profile
Command Description
rtp Enables RTP header compression within an IPHC profile.
show iphc-profile Displays configuration information for one or more IPHC profiles.
tcp Enables TCP header compression within an IPHC profile.
tcp contexts Set the number of contexts available for TCP header compression.
Cisco IOS Interface and Hardware Component Command Reference
590
I through K
keepalive
keepalive
To enable keepalive packets and to specify the number of times that the Cisco IOS software tries to send
keepalive packets without a response before bringing down the interface or before bringing down the tunnel
protocol for a specific interface, use the keepalive command in interface configuration mode. When the
keepalive function is enabled, a keepalive packet is sent at the specified time interval to keep the interface
active. To turn off keepalive packets entirely, use the no form of this command.
keepalive [period[{retries}] ]
no keepalive [period[{proto-up}]]
Syntax Description period (Optional) Integer value that represents the time interval, in seconds, between messages sent by
the Cisco IOS software to ensure that a network interface is alive.
• The valid range is from 0 to 32767 and the default value is 10.
retries (Optional) Number of times that the device will continue to send keepalive packets without a
response before bringing the interface down.
• The valid range is 2 to 244. If omitted, the value that was previously set is used; if no value
was specified, the default of 5 is used.
• If this command is used with a tunnel interface, this argument value specifies the number of
times that the device will continue to send keepalive packets without a response before bringing
down the tunnel interface protocol.
proto-up (Optional) Modifies the interface and protocol status to up even if the router is not connected to a
wire or the interface of the peer router is down.
Command Default The time interval between messages is10 seconds, and the number of retries is 3.
Command Modes Interface configuration (config-if)
Command History Release Modification
10.0 This command was introduced.
12.2(8)T This command was modified. The retries argument was added and made available on tunnel
interfaces.
12.2(13)T This command was modified. The default value for the retries argument was increased to 5.
12.2SX This command was added in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX
release of this train depends on your feature set, platform, and platform hardware.
15.1(4)M8 This command was modified. The proto-up keyword was added.
15.2(2)SNI This command was implemented on the Cisco ASR 901 Series Aggregation Services Routers.
15.3(1)S This command was integrated into Cisco IOS Release15.3(1)S.
Cisco IOS Interface and Hardware Component Command Reference
591
I through K
keepalive
Usage Guidelines The service intervalcommand must be enabled to run the no keepalivecommand.
Defaults for the keepalive Command
If you enter only the keepalive command with no arguments, default values for both arguments are used. If
you enter the keepalive command and the timeout parameter, the default number of retries (5) is used. If you
enter the nokeepalivecommand, keepalive packets are disabled on the interface. When the interface goes
down, the session continues without shutting down because the keepalive packets are disabled.
Keepalive Time Interval
You can configure the keepalive time interval, which is the frequency at which the Cisco IOS software sends
messages to itself (Ethernet and Token Ring) or to the other end (serial and tunnel), to ensure that a network
interface is alive. The interval is adjustable in 1-second increments down to 1 second. An interface is declared
down after five update intervals have passed without receiving a keepalive packet unless the retry value is set
higher. If you are running a Cisco IOS image prior to Cisco IOS Release 12.2(13)T, the default retry value is
3.
Note Ethernet interface drivers on some access platforms use the keepalive time as the interval to test for network
connectivity. By default, Ethernet link failure detection occurs between 1 and 9 seconds. Keepalive packets
are still transmitted on the interface during this time.
Setting the keepalive timer to a low value is very useful for rapidly detecting Ethernet interface failures
(transceiver cable disconnecting, cable not terminated, and so on).
Line Failure
A typical serial line failure involves losing the Carrier Detect (CD) signal. Because this sort of failure is
typically noticed within a few milliseconds, adjusting the keepalive timer for quicker routing recovery is
generally not useful.
Keepalive Packets with Tunnel Interfaces
Generic routing encapsulation (GRE) keepalive packets may be sent from both sides of a tunnel or from just
one side. If they are sent from both sides, the period and retry parameters can be different at each side of the
link. If you configure keepalives on only one side of the tunnel, the tunnel interface on the sending side might
perceive the tunnel interface on the receiving side to be down because the sending interface is not receiving
keepalives. From the receiving side of the tunnel, the link appears normal because no keepalives were enabled
on the second side of the link.
Dropped Packets
Keepalive packets are treated as ordinary packets, so it is possible that they will be dropped. To reduce the
chance that dropped keepalive packets will cause the tunnel interface to be taken down, increase the number
of retries.
Note When adjusting the keepalive timer for a very low bandwidth serial interface, large datagrams can delay the
smaller keepalive packets long enough to cause the line protocol to go down. You may need to experiment
to determine the best values to use for the timeout and the number of retry attempts.
GRE Tunnels with IPsec
Cisco IOS Interface and Hardware Component Command Reference
592
I through K
keepalive
When GRE is used with IPsec, the keepalives are encrypted like any other traffic. As with user data packets,
if the IKE and IPsec security associations are not already active on the GRE tunnel, the first GRE keepalive
packet will trigger IKE/IPsec initialization.
Examples The following example shows how to enable keepalive packets and set the keepalive interval to 3
seconds:
Router(config)# interface ethernet 0
Router(config-if)# keepalive 3
The following example shows how to enable keepalive packets, set the keepalive interval to 3 seconds,
and the retry value to 7 in a tunnel interface:
Router(config)# interface tunnel 1
Router(config-if)# keepalive 3 7
The following example shows how to bring up the interface of a router even if the peer router is
down.
Router(config)# interface tunnel 1
Router(config)# service internal
Router(config-if)# no keepalive proto-up
Related Commands Command Description
service internal Sets a primary or secondary IP address for an interface.
Cisco IOS Interface and Hardware Component Command Reference
593
I through K
keepalive
Cisco IOS Interface and Hardware Component Command Reference
594
l2 vfi manual through loopback PA-MC-8TE1 +
port adapter
• l2 vfi manual, on page 597
• l2protocol-tunnel, on page 599
• l2protocol-tunnel cos, on page 601
• l2protocol-tunnel drop-threshold, on page 602
• l2protocol-tunnel global drop-threshold, on page 604
• l2protocol-tunnel point-to-point, on page 605
• l2protocol-tunnel shutdown-threshold, on page 606
• l3vpn encapsulation ip, on page 608
• lacp active-port distribution automatic, on page 609
• lacp fast-switchover, on page 611
• lacp max-bundle, on page 613
• lacp port-priority, on page 615
• lacp rate, on page 617
• lacp system-priority, on page 618
• lbo, on page 620
• lex burned-in-address, on page 622
• lex input-address-list, on page 623
• lex input-type-list, on page 624
• lex priority-group, on page 625
• lex retry-count, on page 627
• lex timeout, on page 628
• license feature gnss, on page 629
• linecard-group y-cable, on page 630
• linecode, on page 631
• line-mode, on page 632
• line-mode bonding, on page 634
• line-mode single-wire line , on page 635
• line-rate, on page 636
• line-term, on page 638
• line-termination, on page 639
• link debounce, on page 640
Cisco IOS Interface and Hardware Component Command Reference
595
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
• link state group, on page 642
• link state track, on page 643
• li-slot rp rate, on page 644
• link-test, on page 645
• load-balancing, on page 646
• load-interval, on page 648
• local ip address, on page 650
• local-priority, on page 651
• local udp port, on page 652
• local-lnm, on page 653
• logging event, on page 654
• logging source-interface, on page 656
• logging event link-status (global configuration), on page 658
• logging event link-status (interface configuration), on page 660
• logging event subif-link-status, on page 661
• logging-events, on page 662
• logging-events (T1-E1 controller), on page 663
• loopback (CEM), on page 664
• loopback (DSL controller), on page 666
• loopback (E3 controller), on page 669
• loopback (interface), on page 670
• loopback (J1 controller ), on page 672
• loopback (PA-MC-8TE1+ port adapter), on page 673
Cisco IOS Interface and Hardware Component Command Reference
596
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
l2 vfi manual
l2 vfi manual
To create a Layer 2 virtual forwarding instance (VFI) and enter Layer 2 VFI manual configuration mode, use
the l2vfimanual command in global configuration mode. To remove the Layer 2 VFI, use the no form of this
command.
l2 vfi name manual
no l2 vfi name manual
Syntax Description name Name of a new or existing Layer 2 VFI .
Command Default The Layer 2 VFI is not configured.
Command Modes Global configuration (config)
Command History Release Modification
12.2(18)SXF This command was introduced on the Supervisor Engine 720.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
15.0(1)M This command was integrated into a release earlier than Cisco IOS Release
15.0(1)M.
Cisco IOS XE Release 3.7S This command was integrated into Cisco IOS XE Release 3.7S.
Usage Guidelines A VFI is a collection of data structures used by the data plane, software-based or hardware-based, to forward
packets to one or more virtual circuits (VC). It is populated and updated by both the control plane and the
data plane and also serves as the data structure interface between the control plane and the data plane.
Within the Layer 2 VFI manual configuration mode, you can configure the following parameters:
• VPN ID of a Virtual private LAN service (VPLS) domain
• Addresses of other PE routers in this domain
• Type of tunnel signaling and encapsulation mechanism for each peer
Within the Layer 2 VFI manual configuration mode, the following commands are available:
• vpn id vpn-id
• [no] neighborremote-router-id {encapsulation {l2tpv3 | mpls} | pw-classpw-name| no-split-horizon}
Examples This example shows how to create a Layer 2 VFI, enter Layer 2 VFI manual configuration mode,
and configure a VPN ID:
Router(config)# l2 vfi vfitest1 manual
Router(config-vfi)# vpn id 303
Cisco IOS Interface and Hardware Component Command Reference
597
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
l2 vfi manual
Related Commands Command Description
l2 vfi point-to-point Establishes a point-to-point Layer 2 VFI between two separate networks.
vpn id Configures a VPN ID in RFC 2685 format. You can change the value of the VPN
ID only after its configuration, and you cannot remove it.
neighbor Specifies the type of tunnel signaling and encapsulation mechanism for each peer.
Cisco IOS Interface and Hardware Component Command Reference
598
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
l2protocol-tunnel
l2protocol-tunnel
To enable the protocol tunneling on an interface and specify the type of protocol to be tunneled, use the
l2protocol-tunnel command in global or interface configuration mode. To disable protocol tunneling, use
the no form of this command.
Global Configuration
l2protocol-tunnel [{cos cos-value|global|mac-address}]
no l2protocol-tunnel
Interface Configuration
l2protocol-tunnel [{cdp|lldp|stp|vtp}]
no l2protocol-tunnel
Syntax Description cos cos-value (Optional) Specifies a class of service (CoS) value globally on all ingress Layer 2 protocol
tunneling ports.
global (Optional) Displays global settings.
mac-address (Optional) Displays L2PT MAC address.
cdp (Optional) Enables Cisco Discovery Protocol (CDP) tunneling.
lldp (Optional) Enables Link Layer Discovery Protocol (LLDP) tunneling.
stp (Optional) Enables Spanning Tree Protocol (STP) tunneling.
vtp (Optional) Enables VLAN Trunking Protocol (VTP) tunneling.
Command Default Disabled
Command Modes Global configuration (config)
Interface configuration (config-if)
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
15.2(2)T This command was modified. The lldp, cos, global, and mac-address keywords were added.
Usage Guidelines On all the service provider edge switches, you must enable PortFast BPDU filtering on the 802.1Q tunnel
ports by entering these commands:
Router(config-if)# spanning-tree bpdufilter enable
Router(config-if)# spanning-tree portfast
Cisco IOS Interface and Hardware Component Command Reference
599
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
l2protocol-tunnel
Note PortFast BPDU filtering is enabled automatically on tunnel ports.
If you do not specify a protocol, all protocols are tunneled.
You can configure protocol tunneling on VLAN and trunk interfaces.
You must enter the switchport command once without any keywords to configure the LAN port as a Layer
2 interface before you can enter additional switchport commands with keywords. This action is required only
if you have not entered the switchport command for the interface.
Examples This example shows how to enable a tunneling protocol on an interface:
Router> enable
Router# configure terminal
Router#(config)interface FastEthernet 0/0
Router(config-if)# l2protocol-tunnel cdp
This example shows how to disable a tunneling protocol on an interface:
Router> enable
Router# configure terminal
Router#(config)interface fastEthernet 4/0
Router(config-if)# no l2protocol-tunnel
Protocol tunneling disabled on interface fastEthernet 4/1
Related Commands Command Description
show l2protocol-tunnel Displays the protocols that are tunneled on an interface or on all interfaces.
switchport Modifies the switching characteristics of the Layer 2-switched interface.
Cisco IOS Interface and Hardware Component Command Reference
600
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
l2protocol-tunnel cos
l2protocol-tunnel cos
To specify a class of service (CoS) value globally on all ingress Layer-2 protocol tunneling ports, use the
l2protocol-tunnelcoscommand in global configuration mode. To return to the default , use the no form of
this command.
l2protocol-tunnel cos cos-value
no l2protocol-tunnel cos
Syntax Description cos-value CoS value; valid values are from 0 to 7.
Command Default The cos-value is 5
Command Modes Global configuration
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The cos-value is the CoS value that you assign to the PDUs on a Layer 2-protocol tunnel port before tunneling
the PDUs through the service-provider network.
You can specify a CoS value globally on all ingress Layer 2-protocol tunneling ports. Because the CoS value
applies to all ingress tunneling ports, all encapsulated PDUs that are sent out by the Cisco 7600 series router
have the same CoS value.
On all the service-provider edge switches, you must enable PortFast BPDU filtering on the 802.1Q tunnel
ports by entering these commands:
Router(config-if)# spanning-tree bpdufilter enable
Router(config-if)# spanning-tree portfast
Note PortFast BPDU filtering is enabled automatically on tunnel ports.
Examples This example shows how to specify a CoS value on all ingress Layer 2-protocol tunneling ports:
Router(config)# l2protocol-tunnel cos 6
Router(config)#
Related Commands Command Description
show l2protocol-tunnel Displays the protocols that are tunneled on an interface or on all interfaces.
Cisco IOS Interface and Hardware Component Command Reference
601
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
l2protocol-tunnel drop-threshold
l2protocol-tunnel drop-threshold
To specify the maximum number of packets that can be processed for the specified protocol on that interface
before being dropped, use the l2protocol-tunneldrop-threshold command in interface configuration mode.
To reset all the threshold values to 0 and disable the drop threshold, use the no form of this command.
l2protocol-tunnel drop-threshold [{cdp|stp|vtp}] packets
no l2protocol-tunnel drop-threshold [{cdp|stp|vtp}]
Syntax Description cdp (Optional) Specifies CDP packets.
stp (Optional) Specifies STP packets.
vtp (Optional) Specifies VTP packets.
packets Maximum number of packets; valid values are from 1 to 4096 packets.
Command Default Disabled
Command Modes Interface configuration
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines On all the service-provider edge switches, you must enable PortFast BPDU filtering on the 802.1Q tunnel
ports by entering these commands:
Router(config-if)# spanning-tree bpdufilter enable
Router(config-if)# spanning-tree portfast
Note PortFast BPDU filtering is enabled automatically on tunnel ports.
If you do not specify a protocol, the threshold applies to all protocols.
You can configure protocol tunneling on switch ports only. You must enter the switchport command once
without any keywords to configure the LAN port as a Layer 2 interface before you can enter additional
switchport commands with keywords. This action is required only if you have not entered the switchport
command for the interface.
Refer to the “Configuring IEEE 802.1Q Tunneling and Layer 2 Protocol Tunneling” chapter of the Cisco
7600 Series Router Cisco IOS Software Configuration Guide for additional information on setting the drop
threshold value.
Cisco IOS Interface and Hardware Component Command Reference
602
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
l2protocol-tunnel drop-threshold
Examples This example shows how to set the drop threshold:
Router(config-if)# switchport
Router(config-if)# l2protocol-tunnel drop-threshold 3000
Router(config-if)#
Related Commands Command Description
l2protocol-tunnel Enables the protocol tunneling on an interface and specifies the
type of protocol to be tunneled.
l2protocol-tunnel cos Specifies a CoS value globally on all ingress Layer-2 protocol
tunneling ports.
l2protocol-tunnel global Enables rate limiting at the software level.
drop-threshold
l2protocol-tunnel shutdown-threshold Specifies the maximum number of packets that can be processed
for the specified protocol on that interface in 1 second.
show l2protocol-tunnel Displays the protocols that are tunneled on an interface or on all
interfaces.
switchport Modifies the switching characteristics of the Layer 2-switched
interface.
Cisco IOS Interface and Hardware Component Command Reference
603
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
l2protocol-tunnel global drop-threshold
l2protocol-tunnel global drop-threshold
To enable rate limiting at the software level, use the l2protocol-tunnelglobaldrop-threshold command in
global configuration mode. To disable the software rate limiter on the Cisco 7600 series routers, use the no
form of this command.
l2protocol-tunnel global drop-threshold threshold
no l2protocol-tunnel global drop-threshold
Syntax Description threshold Maximum rate of incoming PDUs before excessive PDUs are dropped; valid values are from
100 to 20000 PDUs.
Command Default Global thresholds are not configured.
Command Modes Global configuration
Command History Release Modification
12.2(17a)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.
All three PDUs (normal BPDU, CDP, and VTP packets) that arrive on Layer 2-protocol tunnel-enabled ports
are rate limited. Rate limiting occurs in the ingress direction in Layer 2-protocol tunneling. If the rate of the
incoming PDUs exceeds the configured threshold , the excessive PDUs are dropped.
Examples This example shows how to enable rate limiting globally:
Router(config)# l2protocol-tunnel global drop-threshold 3000
Router(config)#
Related Commands Command Description
l2protocol-tunnel Enables the protocol tunneling on an interface and specifies the type
of protocol to be tunneled.
l2protocol-tunnel cos Specifies a CoS value globally on all ingress Layer-2 protocol
tunneling ports.
l2protocol-tunnel drop-threshold Specifies the maximum number of packets that can be processed for
the specified protocol on that interface before being dropped.
l2protocol-tunnel Specifies the maximum number of packets that can be processed for
shutdown-threshold the specified protocol on that interface in 1 second.
show l2protocol-tunnel Displays the protocols that are tunneled on an interface or on all
interfaces.
Cisco IOS Interface and Hardware Component Command Reference
604
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
l2protocol-tunnel point-to-point
l2protocol-tunnel point-to-point
To enable point-to-point protocol tunneling, use the l2protocol-tunnel point-to-point command in interface
configuration mode. To disable, use the no form of this command.
l2protocol-tunnel point-to-point [{pagp|lacp|udld}]
no l2protocol-tunnel point-to-point [{pagp|lacp|udld}]
Syntax Description pagp (Optional) Enables port aggregation on a point-to-point protocol tunneling.
lacp (Optional) Enables link aggregation on a point-to-point protocol tunneling.
udld (Optional) Enables a unidirectional link dectection on a point-to-point protocol tunneling.
Command Default If no keyword is selected, tunneling is enabled for all three protocols.
Command Modes Interface configuration (config-if)
Command History Release Modification
15.2(2)T This command was introduced.
Usage Guidelines To avoid a network failure, make sure that the network is a point-to-point topology before you enable tunneling
for PAgP, LACP, or UDLD packets.
Examples The following example shows how to enable link aggregation on a point-to-point protocol tunneling:
Router(config-if
)# l2protocol-tunnel point-to-point lacp
Related Commands Command Description
show l2protocol-tunnel Displays the enabled protocols and their values.
Cisco IOS Interface and Hardware Component Command Reference
605
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
l2protocol-tunnel shutdown-threshold
l2protocol-tunnel shutdown-threshold
To specify the maximum number of packets that can be processed for the specified protocol on that interface
in 1 second, use the l2protocol-tunnelshutdown-thresholdcommand in interface configuration mode. To
reset all the threshold values to 0 and disable the shutdown threshold, use the no form ofthis command.
l2protocol-tunnel shutdown-threshold [{cdp|stp|vtp}] packets
no l2protocol-tunnel shutdown-threshold [{cdp|stp|vtp}] packets
Syntax Description cdp (Optional) Specifies CDP tunneling.
stp (Optional) Specifies STP tunneling.
vtp (Optional) Specifies VTP tunneling.
packets Shutdown threshold; valid values are from 1 to 4096.
Command Default This command has no default settings.
Command Modes Interface configuration
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines When the number of packets is exceeded, the port is put in error-disabled state.
On all the service-provider edge switches, you must enable PortFast BPDU filtering on the 802.1Q tunnel
ports by entering these commands:
Router(config-if)# spanning-tree bpdufilter enable
Router(config-if)# spanning-tree portfast
Note PortFast BPDU filtering is enabled automatically on tunnel ports.
If you do not specify a protocol, the packets value applies to all protocols.
You can configure protocol tunneling on switch ports only. You must enter the switchport command once
without any keywords to configure the LAN port as a Layer 2 interface before you can enter additional
switchport commands with keywords. This action is required only if you have not entered the switchport
command for the interface.
Refer to the “Configuring IEEE 802.1Q Tunneling and Layer 2 Protocol Tunneling” chapter of the Cisco
7600 Series Router Cisco IOS Software Configuration Guide for additional information on setting the drop
threshold value.
Cisco IOS Interface and Hardware Component Command Reference
606
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
l2protocol-tunnel shutdown-threshold
Examples This example shows how to specify the maximum number of CDP packets that can be processed on
that interface in 1 second:
Router(config-if)# switchport
Router(config-if)# l2protocol-tunnel shutdown-threshold cdp 200
Router(config-if)#
Related Commands Command Description
l2protocol-tunnel Enables the protocol tunneling on an interface and specifies the type of protocol
to be tunneled.
show l2protocol-tunnel Displays the protocols that are tunneled on an interface or on all interfaces.
switchport Modifies the switching characteristics of the Layer 2-switched interface.
Cisco IOS Interface and Hardware Component Command Reference
607
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
l3vpn encapsulation ip
l3vpn encapsulation ip
To configure an L3VPN encapsulation profile, use the l3vpnencapsulationip command in global configuration
mode. To remove the encapsulation profile, use the no form of this command.
l3vpn encapsulation ip profile name
no l3vpn encapsulation ip profile name
Syntax Description profile name Name of the Layer 3 encapsulation profile.
Command Default The L3VPN encapsulation profile is not configured.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SRE This command was introduced.
Usage Guidelines When you use the l3vpnencapsulationip command you enter into L3VPN encapsulation configuration mode.
You can then specify the transport source mode and interface using thetransportipv4 command, set the GRE
key using the protocolgre command, and configure the L3VPN encapsulation profile.
Examples The following example shows how to configure an L3VPN encapsulation profile:
Router(config)# l3vpn encapsulation ip tunnelencap
Related Commands Command Description
show l3vpn encapsulation ip Displays the profile health and the underlying tunnel interface.
transport ipv4 Specifies IPv4 transport source mode and the transport source interface.
protocol gre Specifies GRE as the tunnel mode and sets the GRE key.
Cisco IOS Interface and Hardware Component Command Reference
608
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
lacp active-port distribution automatic
lacp active-port distribution automatic
To have an effective auto interleaved port priority distribution of active and bundled ports across different
slots that are part of the same port channel distributed EtherChannel (DEC) and multichassis EtherChannel
(MEC), use the lacp active-port distribution automaticcommand in port channel configuration mode.
lacp active-port distribution automatic
no lacp active-port distribution automatic
Syntax Description This command has no keywords or arguments.
Command Default Auto interleaved port priority is disabled.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SXI4 This command was introduced.
Usage Guidelines The auto interleaved port-priority feature automatically distributes active and bundled ports based on the
position of a port link when it comes up and is effective only if you configure it on the system that has the
higher LACP system priority.
The port priority per port that you configured continues to take precedence over a dynamic port number. You
need to perform a shutdown and no shutdown on the interface port channel to enable the auto interleaved port
priority feature on all ports.
Examples This example shows how to configure interleaved port priority:
Router(config)# interface port23
Router(config-if)# lacp active-port distribution automatic
Please shut/no shut the port-channel for configuration to take effect immediately.
Router(config-if)# shutdown
Router(config-if)# no shutdown
Router(config-if)# end
This example shows how to verify that interleaved port priority is configured:
Router# show running interface port23
Building configuration...
Current configuration : 81 bytes
!
interface Port-channel23
no switchport
no ip address
lacp max-bundle 4
lacp active-port distribution automatic
end
Router# show etherchannel 23 summary
Flags: D - down P - bundled in port-channel
I - stand-alone s - suspended
H - Hot-standby (LACP only)
R - Layer3 S - Layer2
Cisco IOS Interface and Hardware Component Command Reference
609
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
lacp active-port distribution automatic
U - in use N - not in use, no aggregation
f - failed to allocate aggregator
M - not in use, no aggregation due to minimum links not met
m - not in use, port not aggregated due to minimum links not met
u - unsuitable for bundling
d - default port
w - waiting to be aggregated
Number of channel-groups in use: 9
Number of aggregators: 9
Group Port-channel Protocol Ports
------+-------------+-----------+-----------------------------------------------
23 Po23(RU) LACP Gi1/1/21(P) Gi1/1/22(P) Gi1/1/23(P)
Gi1/1/24(P) Gi2/1/17(H) Gi2/1/18(H)
Gi2/1/19(H) Gi2/1/20(H)
Last applied Hash Distribution Algorithm: Fixed
Note The four active and bundled ports are from the same chassis and slot.
Related Commands Command Description
show etherchannel Displays EtherChannel information for a port channel.
Cisco IOS Interface and Hardware Component Command Reference
610
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
lacp fast-switchover
lacp fast-switchover
To enable Link Aggregation Control Protocol (LACP) 1:1 link redundancy, use the lacp fast-switchover
command in interface configuration mode. To dis able LACP 1:1 link redundancy, use the no form of this
command.
lacp fast-switchover
no lacp fast-switchover
Syntax Description This command has no arguments or keywords.
Command Default LACP 1:1 link redundancy is disabled by default.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SXH This command was introduced.
12.2(33)SRC This command was integrated into Cisco IOS Release 12.2(33)SRC.
12.2(33)SB Support for this command was implemented on the Cisco 10000 series router
and integrated into Cisco IOS Release 12.2(33)SB. The time allowed for a link
switchover was modified from the default of 2 seconds to 250 milliseconds.
Cisco IOS XE Release 2.5 This command was integrated into Cisco IOS XE Release 2.5
Usage Guidelines Prior to entering the lacp fast-switchover command, you must ensure the following:
• The port channel protocol type is LACP.
• The lacp max-bundle 1command has been entered on the port channel. The lacp fast-switchover
command will not affect the lacp max-bundle command.
When you enable LACP 1:1 link redundancy, based on the system priority and port priority, the port with the
higher system priority chooses the link as the active link and the other link as the standby link. When the
active link fails, the standby link is selected as the new active link without taking down the port channel.
When the original active link recovers, it reverts to its active link status. During this change-over, the port
channel is also up.
Note We recommend that you configure two ports only (one active and one hot-standby) in the bundle for optimum
performance.
You can enter this command on any port channels with different EtherChannel protocol types of LACP, Port
Aggregation Protocol (PAgP), or Fast EtherChannel (FEC).
Examples This example shows how to enable LACP 1:1 link redundancy:
Cisco IOS Interface and Hardware Component Command Reference
611
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
lacp fast-switchover
Router(config-if)# lacp fast-switchover
This example shows how to disable LACP 1:1 link redundancy:
Router(config-if)# no lacp fast-switchover
Related Commands Command Description
lacp max-bundle Assigns and configures an EtherChannel interface to an EtherChannel group.
show etherchannel Displays the EtherChannel information for a channel.
Cisco IOS Interface and Hardware Component Command Reference
612
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
lacp max-bundle
lacp max-bundle
To define the maximum number of active bundled Link Aggregation Control Protocol (LACP) ports allowed
in a port channel, use the lacp max-bundle command in interface configuration mode. To return to the default
settings, use the no form of this command.
lacp max-bundle max-bundles
no lacp max-bundle
Syntax Description max-bundles Maximum number of active bundled ports allowed in the port channel. Valid values are from
1 to 8. On the Cisco ASR 1000 series router, valid values are 1 to 4.
The default settings are as follows:
• Maximum of 8 bundled ports per port channel.
• Maximum of 8 bundled ports and 8 hot-standby ports per port channel if the port channels
on both sides of the LACP bundle are configured in the same way.
• On the Cisco 10000 series router, maximum of 8 bundled ports per port channel.
Command Default A maximum number of active bundled ports is not configured.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(18)SXD Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2 Support for this command was implemented on the Cisco 10000 series router
and integrated into Cisco IOS Release 12.2(31)SB2.
12.2(33)SRB Support for this command on the Cisco 7600 router was integrated into Cisco
IOS Release 12.2(33)SRB.
12.2(33)SB On the Cisco 10000 series router, the maximum number of bundled ports per
port channel was increased from 4 to 8.
Cisco IOS XE Release 2.4 This command was integrated into Cisco IOS XE Release 2.4.
12.2(33)SRE This command was integrated into Cisco IOS Release 12.2(33)SRE.
Usage Guidelines The value specified in the max-bundles argument determines the number of active links that are bundled in
the port channel. The remaining links are in hot-standby mode.
On the Cisco 10000 series router, this command requires a Performance Routing Engine 2 (PRE2) or PRE3.
Examples This example shows how to set 3 ports to bundle in port channel 2:
Cisco IOS Interface and Hardware Component Command Reference
613
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
lacp max-bundle
Router(config)# interface port-channel 2
Router(config-if)# lacp max-bundle 3
Router(config-if)#
Related Commands Command Description
interface port-channel Creates a port-channel virtual interface and puts the CLI in interface
configuration mode.
ip address Sets a primary or secondary IP address on an interface.
show etherchannel Displays the EtherChannel information for a channel.
show interfaces port-channel Displays traffic that is seen by a specific port channel.
Cisco IOS Interface and Hardware Component Command Reference
614
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
lacp port-priority
lacp port-priority
To set the priority for a physical interface, use the lacp port-priority command in interface configuration
mode. To return to the default setting, use the no form of this command.
lacp port-priority priority
no lacp port-priority
Syntax Description priority Integer from 1 to 65535 that indicates the priority for the physical interface. The default is 32768.
• On the Cisco ASR 1000 series router, the range is 0 to 65535.
Command Default The default port priority is set.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.1(13)EW This command was introduced on the Cisco Catalyst 4500 series switches.
12.2(14)SX Support for this command on the Supervisor Engine 720 was integrated into
Cisco IOS Release12.2(14)SX.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was integrated into Cisco
IOS Release12.2(17d) SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2 This command was integrated into Cisco IOS Release 12.2(31)SB2.
12.2(33)SRB Support for this command on the Cisco 7600 router was integrated into Cisco
IOS Release 12.2(33)SRB.
Cisco IOS XE Release 2.4 This command was integrated into Cisco IOS XE Release 2.4.
15.1(2)SNG This command was implemented on the Cisco ASR 901 Series Aggregation
Services Router.
Usage Guidelines You may assign a port priority to each port on a device running Link Aggregation Control Protocol (LACP).
You can specify the port priority by using the lacp port-priority command at the command-line interface
(CLI) or use the default port priority (32768) that is carried as part of the LACP protocol data unit (PDU)
exchanged with the partner. Port priority is used to decide which ports should be put in standby mode when
a hardware limitation or the lacp max-bundle command configuration prevents all compatible ports from
aggregating. Priority is supported only on port channels with LACP-enabled physical interfaces.
Note A high priority number means a low priority.
Cisco IOS Interface and Hardware Component Command Reference
615
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
lacp port-priority
Port priority together with port number form a port identifier.
To verify the configured port priority, issue the show lacp command.
Examples This example shows how to set a priority of 23700 for an interface:
Device> enable
Device# configure terminal
Device(config)# interface ethernet0/0
Device(config-if)# lacp port-priority 23700
Device(config-if)#
Related Commands Command Description
channel-group Assigns and configures an EtherChannel interface to an EtherChannel group.
debug lacp Enables debugging of LACP activities.
lacp max-bundle Defines the maximum number of active bundled LACP ports allowed in a port
channel.
lacp system-priority Sets the priority of the system.
show lacp Displays information about LACP activity on the device.
Cisco IOS Interface and Hardware Component Command Reference
616
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
lacp rate
lacp rate
To set the rate at which Link Aggregation Control Protocol (LACP) control packets are ingressed to an
LACP-supported interface, use the lacp rate command in interface configuration mode. To return to the
default settings, use the no form of this command.
lacp rate {normal|fast}
no lacp rate
Syntax Description normal Specifies that LACP control packets are ingressed at the normal rate, every 30 seconds after the
link is bundled.
fast Specifies that LACP control packets are ingressed at the fast rate, once every 1 second.
Command Default The default ingressed rate for control packets is 30 seconds after the link is bundled.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(18)SXF2 This command was introduced on the Catalyst 6500 series switch.
12.2(33)SRC This command was integrated into Cisco IOS Release 12.2(33)SRC.
Cisco IOS XE Release This command was implemented on Cisco ASR 1000 Series Aggregation
3.6S Services Routers in Cisco IOS XE Release 3.6S.
Usage Guidelines Use this command to modify the duration of a LACP timeout. The LACP timeout value is set on Cisco switches
to a value of 90 seconds. Using the lacp rate command, you can select the LACP timeout value for a switch
to be either 30 seconds or 1 second.
This command is supported only on LACP-enabled interfaces.
Examples This example shows how to specify the fast (1-second) ingress rate on interface Ethernet 0/1:
Router(config)# interface ethernet 0/1
Router(config-if)# lacp rate fast
Related Commands Command Description
show lacp Displays LACP information.
Cisco IOS Interface and Hardware Component Command Reference
617
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
lacp system-priority
lacp system-priority
To set the priority for a system, use the lacp system-priority command in global configuration mode. To
return to the default setting, use the no form of this command.
lacp system-priority priority
no lacp system-priority
Syntax Description priority Integer from 1 to 65535 that indicates the priority for the system. The default is 32768.
• On the Cisco ASR 1000 series router, the range is 0 to 65535.
Command Default The default system priority is set.
Command Modes Global configuration (config)
Command History Release Modification
12.1(13)EW This command was introduced on the Cisco Catalyst 4500 series switches.
12.2(14)SX Support for this command on the Supervisor Engine 720 was integrated into
Cisco IOS Release12.2(14)SX.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was integrated into Cisco
IOS Release12.2(17d) SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2 This command was integrated into Cisco IOS Release 12.2(31)SB2.
12.2(33)SRB Support for this command on the Cisco 7600 router was integrated into Cisco
IOS Release 12.2(33)SRB.
Cisco IOS XE Release 2.4 This command was integrated into Cisco IOS XE Release 2.4.
15.1(2)SNG This command was implemented on the Cisco ASR 901 Series Aggregation
Services Router.
Usage Guidelines You can assign a system priority to each device running Link Aggregation Control Protocol (LACP). You
can specify the system priority by using the lacp system-priority command at the command-line interface
(CLI) or use the default system priority (32768) that is carried as part of the LACP protocol data unit (PDU)
exchanged with the partner. System priority is used with the MAC address of the device to form the system
ID and also is used during negotiation with other systems. Priority is supported only on port channels with
LACP-enabled physical interfaces.
Note A high priority number means a low priority.
Cisco IOS Interface and Hardware Component Command Reference
618
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
lacp system-priority
To verify the configured system priority, issue the show lacp command.
Examples The following example shows how to set a system priority of 25500 for a device:
Router> enable
Router# configure terminal
Router(config)# lacp system-priority 25500
Related Commands Command Description
channel-group Assigns and configures an EtherChannel interface to an EtherChannel group.
debug lacp Enables debugging of LACP activities.
lacp port-priority Sets the priority of a port.
show lacp Displays information about LACP activity on the device.
Cisco IOS Interface and Hardware Component Command Reference
619
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
lbo
lbo
To set a cable length longer than 655 feet for a DS-1 link, use thelbocommand in interface configuration mode
on the interface for a T1 link. To delete the lbovalue, use the no form of this command.
lbo {long {gain26|gain36} {-15db|-22.5db|-7.5db|0db}|short {133|266|399|533|655}}
no lbo
Syntax Description long Specifies the long-haul mode where the gain and line build out must be configured.
gain26 Specifies the decibel pulse gain at 26 decibels. This is the default pulse gain.
gain36 Specifies the decibel pulse gain at 36 decibels.
-15db Specifies the decibel pulse rate at -15 decibels.
-22.5db Specifies the decibel pulse rate at -22.5 decibels.
-7.5db Specifies the decibel pulse rate at -7.5 decibels.
0db Specifies the decibel pulse rate at 0 decibels. This is the default.
short Specifies the short-haul mode where the cable length, in feet, must be configured.
133 Specifies a cable length from 0 to 133 feet.
266 Specifies a cable length from 134 to 266 feet.
399 Specifies a cable length from 267 to 399 feet.
533 Specifies a cable length from 400 to 533 feet.
655 Specifies a cable length from 534 to 655 feet.
Command Default gain26 and0db
Command Modes Interface configuration
Command History Release Modification
11.3MA This command was introduced as a Cisco MC3810 controller configuration command.
12.0(5)XE The command was introduced as an ATM interface command.
12.0(7)XE1 This command was implemented on Cisco 7100 series routers.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Cisco IOS Interface and Hardware Component Command Reference
620
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
lbo
Usage Guidelines This command is supported on T1 links only.
Each T1 port can operate in long-haul or short-haul mode. In long haul mode, the user must specify the gain
and the line build out. In short-haul mode, the user must specify the cable length in feet.
The transmit attenuation value is best obtained by experimentation. If the signal received by the far-end
equipment is too strong, reduce the transmit level by entering additional attenuation.
Examples On Cisco 7100 or Cisco 7200 series routers, the following example specifies a pulse gain of 36
decibels and a decibel pulse rate of -7.5 decibels:
Router(config)# interface atm 1/2
Router(config-if)# lbo long gain36 -7.5db
Cisco IOS Interface and Hardware Component Command Reference
621
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
lex burned-in-address
lex burned-in-address
To set the burned-in MAC address for a LAN Extender interface, use the lexburned-in-address command
in interface configuration mode. To clear the burned-in MAC address, use the no form of this command.
lex burned-in-address ieee-address
no lex burned-in-addresslex burned-in-address command
Syntax Description ieee-address 48-bit IEEE MAC address written as a dotted triplet of 4-digit hexadecimal numbers.
Command Default No burned-in MAC address is set.
Command Modes Interface configuration
Command History Release Modification
10.3 This command was introduced.
12.2(15)T This command is no longer supported in Cisco_IOS Mainline or Technology-based (T) releases.
It may continue to appear in Cisco_IOS 12.2S-family releases.
Usage Guidelines Use this command only on a LAN Extender interface that is not currently active (not bound to a serial interface).
Examples The following example sets the burned-in MAC address on LAN Extender interface 0:
Router(config)# interface serial 4
Router(config-if)# encapsulation ppp
Router(config)# interface lex 0
Router(config-if)# lex burned-in-address 0000.0c00.0001
Router(config-if) ip address 10.108.172.21 255.255.255.0
Cisco IOS Interface and Hardware Component Command Reference
622
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
lex input-address-list
lex input-address-list
To assign an access list that filters on MAC addresses, use the lexinput-address-list command in interface
configuration mode. To remove an access list from the interface, use the no form of this command.
lex input-address-list access-list-number
no lex input-address-listlex input-address-list command
Syntax Description access-list-number Number of the access list assigned with the access-list global configuration command.
It can be a number from 700 to 799.
Command Default No access lists are preassigned to a LAN Extender interface.
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(15)T This command is no longer supported in Cisco_IOS Mainline or Technology-based (T) releases.
It may continue to appear in Cisco_IOS 12.2S-family releases.
Usage Guidelines Use the lexinput-address-list command to filter the packets that are allowed to pass from the LAN Extender
to the core router. The access list filters packets on the basis of the source MAC address.
The LAN Extender interface does not process MAC-address masks. Therefore, you should omit the mask
from the access-list commands.
For LAN Extender interfaces, an implicit permit everything entry is automatically defined at the end of an
access list. Note that this default differs from other access lists, which have an implicit deny everything entry
at the end of each access list.
Examples The following example applies access list 710 to LAN Extender interface 0. This access list denies
all packets from MAC address 0800.0214.2776 and permits all other packets.
Router(config-if)# access-list 710 deny 0800.0214.2776
Router(config)# interface lex 0
Router(config-if)# lex input-address-list 710
Related Commands Command Description
access-list Configures the access list mechanism for filtering frames by protocol type or vendor code.
Cisco IOS Interface and Hardware Component Command Reference
623
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
lex input-type-list
lex input-type-list
To assign an access list that filters Ethernet packets by type code, use the lexinput-type-list command in
interface configuration mode. To remove an access list from an interface, use the no form of this command.
lex input-type-list access-list-number
no lex input-type-list lex input-type-list command
Syntax Description access-list-number Number of the access list that you assigned with the access-list command. It can be a
number in the range 200 to 299.
Command Default No access lists are preassigned to a LAN Extender interface.
Command Modes Interface configuration
Command History Release Modification
10.3 This command was introduced.
12.2(15)T This command is no longer supported in Cisco_IOS Mainline or Technology-based (T) releases.
It may continue to appear in Cisco_IOS 12.2S-family releases.
Usage Guidelines Filtering is done on the LAN Extender chassis.
The LAN Extender interface does not process masks. Therefore, you should omit the mask from the access-list
commands.
For LAN Extender interfaces, an implicit permit everything entry is automatically defined at the end of an
access list. Note that this default differs from other access lists, which have an implicit deny everything entry
at the end of each access list.
Examples The following example applies access list 220 to LAN Extender interface 0. This access list denies
all AppleTalk packets (packets with a type field of 0x809B) and permits all other packets.
Router(config-if)# access-list 220 deny 0x809B 0x0000
Router(config)# interface lex 0
Router(config-if)# lex input-type-list 220
Related Commands Command Description
access-list Configures the access list mechanism for filtering frames by protocol type or vendor code.
Cisco IOS Interface and Hardware Component Command Reference
624
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
lex priority-group
lex priority-group
To activate priority output queueing on the LAN Extender, use the lexpriority-group command in interface
configuration mode. To disable priority output queueing, use the no form of this command.
lex priority-group group
no lex priority-group
Syntax Description group Number of the priority group. It can be a number in the range 1 to 10.
Command Default Disabled
Command Modes Interface configuration
Command History Release Modification
10.3 This command was introduced.
12.2(15)T This command is no longer supported in Cisco_IOS Mainline or Technology-based (T) releases.
It may continue to appear in Cisco_IOS 12.2S-family releases.
Usage Guidelines To define queueing priorities, use the priority-listprotocol global configuration command. Note that you can
use only the following forms of this command:
priority-list
list
protocol
protocol
{
high
|
medium
|
normal
|
low
priority-list
list
protocol
bridge
{
high
|
medium
|
normal
|
low
}
Cisco IOS Interface and Hardware Component Command Reference
625
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
lex priority-group
list
list-number
If you specify a protocol that does not have an assigned Ethernet type code, such as x25, stun, or pad, it is
ignored and will not participate in priority output queueing.
Examples The following example activates priority output queueing on LAN Extender interface 0:
Router(config-if)# priority-list 5 protocol bridge medium list 701
Router(config-if)# lex interface 0
Router(config-if)# lex priority-group 5
Related Commands Command Description
priority-list protocol Establishes queueing priorities based on the protocol type.
Cisco IOS Interface and Hardware Component Command Reference
626
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
lex retry-count
lex retry-count
To define the number of times to resend commands to the LAN Extender chassis, use the lexretry-count
command in interface configuration mode. To return to the default value, use the no form of this command.
lex retry-count number
no lex retry-count number lex retry-count command
Syntax Description number Number of times to retry sending commands to the LAN Extender. It can be a number in the range
0 to 100. The default is 10.
Command Default 10 retries
Command Modes Interface configuration
Command History Release Modification
10.3 This command was introduced.
12.2(15)T This command is no longer supported in Cisco_IOS Mainline or Technology-based (T) releases.
It may continue to appear in Cisco_IOS 12.2S-family releases.
Usage Guidelines After the router has sent a command the specified number of times without receiving an acknowledgment
from the LAN Extender, it stops sending the command altogether.
Examples The following example resends commands 20 times to the LAN Extender:
Router(config-if)# lex interface 0
Router(config-if)# lex retry-count 20
Related Commands Command Description
lex timeout Defines the amount of time to wait for a response from the LAN Extender.
Cisco IOS Interface and Hardware Component Command Reference
627
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
lex timeout
lex timeout
To define the amount of time to wait for a response from the LAN Extender, use the lextimeout command
in interface configuration mode. To return to the default time, use the no form of this command.
lex timeout milliseconds
no lex timeout [milliseconds] lex timeout command
Syntax Description milliseconds Time, in milliseconds, to wait for a response from the LAN Extender before resending the
command. It can be a number in the range 500 to 60,000. The default is 2000 ms.
Command Default 2000 ms (2 seconds)
Command Modes Interface configuration
Command History Release Modification
10.3 This command was introduced.
12.2(15)T This command is no longer supported in Cisco_IOS Mainline or Technology-based (T) releases.
It may continue to appear in Cisco_IOS 12.2S-family releases.
Usage Guidelines The lextimeout command defines the amount of time that the router waits to receive an acknowledgment
after having sent a command to the LAN Extender.
Examples The following example causes unacknowledged packets to be resent at 4-second intervals:
Router(config-if)# lex interface 0
Router(config-if)# lex timeout 4000
Related Commands Command Description
lex retry-count Defines the number of times to resend commands to the LAN Extender chassis.
Cisco IOS Interface and Hardware Component Command Reference
628
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
license feature gnss
license feature gnss
To configure the license for the global navigation satellite system (GNSS) module on the Cisco ASR 920
routers, use the license feature gnss command in the global configuration mode. To remove the license, use
the no form of this command.
license feature gnss
no license feature gnss
Command Default No default behavior or values.
Command Modes Global configuration (config)
Command History Release Modification
IOS-XE 3.17 This command was introduced on the Cisco ASR 920 routers.
Usage Guidelines Only when the GNSS license is in use, the shutdown and no shutdown operations for the GNSS module can
be performed.
Examples The following example shows how to configure the GNSS license:
Router# configure terminal
Router(config)# license feature gnss
Related Commands Command Description
gnss Configures the GNSS on the router.
Cisco IOS Interface and Hardware Component Command Reference
629
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
linecard-group y-cable
linecard-group y-cable
To create a line card group for one-to-one line card redundancy, use the linecard-group y-cable command in
redundancy mode. To remove the line card redundancy group, use the no form of this command.
linecard-group linecard-groupId y-cable
no linecard-group linecard-groupId y-cable
Syntax Description linecard-groupId An unsigned integer in the range 0 to the (maximum number of chassis line card
subslots/2) -1.
y-cable The link protection type for the line card group.
Command Default No default behavior or values .
Command Modes Redundancy
Command History Release Modification
12.2(28)SB This command was introduced on the Cisco 10000 series router.
Usage Guidelines The no linecard-group y-cable command removes the line card redundancy group and frees the
linecard-groupIdfor reuse. The no linecard-group y-cable command succeeds only if there are no subslot
members in the line card redundancy group.
Examples The following example creates line card group number 1 for one-to-one line card redundancy:
Router(config)# redundancy
Router(config-red)# linecard-group 1 y-cable
Related Commands Command Description
member subslot Configures the redundancy role of a line card in the line card group.
redundancy Enters redundancy mode.
show redundancy linecard Displays information about a redundant line card or line card group.
Cisco IOS Interface and Hardware Component Command Reference
630
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
linecode
linecode
To select the line-code type for T1 or E1 lines, use the linecode command in controller configuration mode.
linecode {ami|b8zs|hdb3}
Syntax Description ami Specifies alternate mark inversion (AMI) as the line-code type. Valid for T1 or E1 controllers. This
is the default for T1 lines.
b8zs Specifies B8ZS as the line-code type. Valid for T1 controller only.
hdb3 Specifies high-density bipolar 3 (hdb3) as the line-code type. Valid for E1 controller only. This is
the default for E1 lines.
Command Default AMI is the default for T1 lines. High-density bipolar 3 is the default for E1 lines.
Command Modes Controller configuration
Command History Release Modification
10.3 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
XE 3.18SP This command was integrated into Cisco NCS 4200 Series.
XE Everest This command was integrated into Cisco NCS 4200 Series and Cisco ASR 900 Series
16.5.1 Routers.
Usage Guidelines Use this command in configurations in which the router or access server must communicate with T1 fractional
data lines. The T1 service provider determines which line-code type, either ami or b8zs, is required for your
T1 circuit. Likewise, the E1 service provider determines which line-code type, either ami or hdb3, is required
for your E1 circuit.
This command does not have a no form.
Examples The following example specifies B8ZS as the line-code type:
Router(config-controller)# linecode b8zs
Cisco IOS Interface and Hardware Component Command Reference
631
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
line-mode
line-mode
To configure the mode of the controller for the Symmetrical High-Speed Digital Subscriber Line (SHDSL)
port, use the line-mode command in controller configuration mode. To return to the default two-wire mode,
use the no form of this command.
line-mode [{2-wire|4-wire [{enhanced|standard}]|auto}]
no line-mode
Syntax Description 2-wire (Optional) Configures the controller to operate in two-wire mode.
4-wire (Optional) Configures the controller to operate in four-wire mode.
enhanced (Optional) Configures 4-wire mode to exchange handshake status on both wire pairs. This is the
default if the handshake mode is not specified.
standard (Optional) Configures 4-wire mode to exchange handshake status on the master wire pair only.
auto (Optional) Configures the controller to automatically operate in the mode to match the other line
termination. This mode is compatible with a remote host that is in one of the following modes:
• line-mode 2-wire line 0
• line-mode 2-wire line 1
• line-mode 4-wire enhanced
Command Default The default is two-wire mode if this command is omitted or if the 4-wire keyword is omitted.
Command Modes Controller configuration
Command History Release Modification
12.3(4)XD This command was introduced on Cisco 2600 series and Cisco 3700 series routers.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T on Cisco 2600 series and Cisco
3700 series routers.
12.3(11)T This command was implemented on Cisco 2800 and Cisco 3800 series routers.
12.3(14)T This command was implemented on Cisco 1800 series routers.
12.4(2)XA The enhanced and standard keywords were added to four-wire mode.
12.4(5)A Modified auto keyword to to disallow use of line-rate command
12.4(4)T Modified auto keyword to to disallow use of line-rate command
Usage Guidelines This command is used to configure the controller for two-wire or four-wire mode.
Cisco IOS Interface and Hardware Component Command Reference
632
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
line-mode
Note To operate in four-wire mode for SHDSL, the line-mode4-wirecommand must be set.
Note When the line-mode command is set to auto, the line-rate command is not available.
Examples
4-Wire Line Mode Example
The following example shows how to configure the controller mode of DSL on the controller in slot
4 and port 0 to operate in four-wire mode:
Router(config)# controller dsl 4/0
Router(config-controller)# line-mode
4-wire
CPE Line Mode Example
The following example configures the controller in slot 1 and port 0. The router is set to terminate
as CPE with the line mode automatically selecting between two-wire mode and four-wire mode.
Router(config)# controller dsl 1/0
Router(config-controller)# line-mode auto
Router(config-controller)# line-term cpe
Related Commands Command Description
line-rate Specifies a line rate for the DSL controller.
line-term Specifies a termination for a line.
Cisco IOS Interface and Hardware Component Command Reference
633
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
line-mode bonding
line-mode bonding
To enable bonding mode on a CPE, use the line-mode bonding command in controller configuration mode.
To disable the bonding mode, use the no form of this command.
line-mode bonding
no line-mode bonding
Syntax Description This command has no keywords or arguments.
Command Default Bonding is not the default mode.
Command Modes Controller configuration (config-controller)#
Command History Release Modification
15.4(4)T This command was introduced.
Usage Guidelines Use this command when a CPE is expected to operate in bonding mode.
Examples The following example shows how to enable bonding mode:
Router(config-controller)# line-mode bonding
The following example shows how to disable bonding mode:
Router(config-controller)# no line-mode bonding
Related Commands Command Description
line-mode single-wire line Enables single-wire (nonbonding) mode on a selected line.
Cisco IOS Interface and Hardware Component Command Reference
634
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
line-mode single-wire line
line-mode single-wire line
To enable single-wire (nonbonding) mode on a selected line, use the line-mode single-wire line command
in controller configuration mode. To disable the mode, use the no form of this command.
line-mode single-wire line line-number
or
line-mode single-wire line line-number [profile 30a]
no line-mode single-wire line line-number
Syntax Description line-number Line number. Valid values are either 1 or 0.
profile 30a Enables 30a profile on line 1. If profile 30a is not specified, profiles 8a to 17a are enabled on
that line.
Command Default By default, single-wire mode is enabled on line 0 with profiles from 8a to17a enabled.
Command Modes Controller configuration (config-controller)#
Command History Release Modification
15.4(4)T This command was introduced.
Usage Guidelines Use this command to configure either line 0 or line 1 in single-wire (non-bonding) mode.
Examples The following example shows how to enable 30a profile on line 1:
Router(config-controller)# line-mode single-wire line 1 profile 30a
Related Commands Command Description
line-mode bonding Changes the mode of a CPE to bonding.
Cisco IOS Interface and Hardware Component Command Reference
635
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
line-rate
line-rate
To specify a line rate for the DSL controller, use the line-rate command in controller configuration mode.
line-rate {autorate}
Syntax Description auto Allows the controller to select the rate. This option is available only in two-wire mode.
rate DSL line rate, in kbps. The line will train at the selected rate plus 8 kbps of DSL framing overhead.
The supported line rates are as follows:
• For two-wire mode:
• 192, 256, 320, 384, 448, 512, 576, 640, 704, 768, 832, 896, 960, 1024, 1088, 1152, 1216,
1280, 1344, 1408, 1472, 1536, 1600, 1664, 1728, 1792, 1856, 1920, 1984, 2048, 2112,
2176, 2240, and 2304
• For four-wire mode:
• 384, 512, 640, 768, 896, 1024, 1152, 1280, 1408, 1536, 1664, 1792, 1920, 2048, 2176,
2304, 2432, 2560, 2688, 2816, 2944, 3072, 3200, 3328, 3456, 3584, 3712, 3840, 3968,
4096, 4224, 4352, 4480, and 4608
Command Default No default behavior or values.
Command Modes Controller configuration
Command History Release Modification
12.3(4)XD This command was introduced on Cisco 2600 series and Cisco 3700 series routers.
12.3(4)XG This command was implemented on Cisco 1700 series routers.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T on Cisco 2600 series and Cisco
3700 series routers.
12.(11)T This command was implemented on Cisco 2800 and Cisco 3800 series routers.
12.3(14)T This command was implemented on Cisco 1800 series routers.
12.4(5)A Modified line-rate command to be disallowed when line-modecommand is set to auto.
12.4(4)T Modified line-rate command to be disallowed when line-modecommand is set to auto.
Usage Guidelines This command does not have a no form.
This command specifies the DSL line rate for the Symmetrical High-Speed Digital Subscriber Line (SHDSL)
port. Use this command to configure the line rate in two-wire or four-wire mode. The SHDSL rate is in kbps,
but the line trains at the selected rate plus two times the 8 kbps of DSL framing overhead.
Cisco IOS Interface and Hardware Component Command Reference
636
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
line-rate
Note Automatic rate mode (auto) is used only in two-wire mode. It is not available in four-wire mode.
Note If different DSL line rates are configured at opposite ends of the DSL uplink, the actual DSL line rate is always
the lower rate.
Note The maximum peak cell rate is 8 kbps less than the line rate.
Note When the line-mode command is set to auto, the line-rate command is not available.
Examples The following example displays the line-mode command selecting four-wire mode, which is different
from the previous line mode of the router as indicated by the router output, and then the line rate is
selected. The rate of 4608 is selected, and the output of the router is shown.
Router(config)# controller dsl 1/0
Router(config-controller)# line-mode
4-wire
Router(config-controller)#
*Jun 15 18:00:48.159: %CONTROLLER-5-UPDOWN: Controller DSL 1/0, changed state tn
*Jun 15 18:00:50.159: %LINK-3-UPDOWN: Interface ATM1/0, changed state to down
*Jun 15 18:00:51.159: %LINEPROTO-5-UPDOWN: Line protocol on Interface ATM1/0, cn
Router(config-controller)# line-rate
4608
Router(config-controller)#
*Jun 15 18:01:36.627: %CONTROLLER-5-UPDOWN: Controller DSL 1/0, changed state tn
*Jun 15 18:01:36.967: %CONTROLLER-5-UPDOWN: Controller DSL 1/0, changed state tn
Router(config-controller)# exit
Related Commands Command Description
line-mode Configures the mode of the controller.
line-term Specifies a termination for a line.
Cisco IOS Interface and Hardware Component Command Reference
637
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
line-term
line-term
To specify a termination for a line, use the line-term command in controller configuration mode.
line-term {co|cpe}
Syntax Description co Central office.
cpe Customer premises equipment. This is the default.
Command Default The default value is cpe.
Command Modes Controller configuration
Command History Release Modification
12.3(4)XD This command was introduced on Cisco 2600 series and Cisco 3700 series routers.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T on Cisco 2600 series and Cisco
3700 series routers.
12.3(11)T This command was implemented on Cisco 2800 and Cisco 3800 series routers.
12.3(14)T This command was implemented on Cisco 1800 series routers.
Usage Guidelines This command does not have a no form.
This command is used to configure the line termination for use as either the central office (CO) or the customer
premises equipment (CPE).
Examples The following example shows how to configure the controller in slot 1 and port 0. The router is set
to terminate as CPE with the line mode automatically selecting between two-wire mode and four-wire
mode.
Router(config)# controller dsl 1/0
Router(config-controller)# line-term
cpe
Router(config-controller)# line-mode
auto
No change in line mode
Related Commands Command Description
line-mode Configures the mode of the controller.
line-rate Specifies a line rate for the DSL controller.
Cisco IOS Interface and Hardware Component Command Reference
638
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
line-termination
line-termination
To set the line termination on an E1 controller, use the line-terminationcommand in controller configuration
mode. To return to the default line termination, use the no form of this command.
line-termination {75-ohm|120-ohm}
no line-termination
Syntax Description 75-ohm Specifies 75-ohm unbalanced termination.
120-ohm Specifies 120-ohm balanced termination. This is the default.
Command Default 120-ohms
Command Modes Controller configuration
Command History Release Modification
11.3(2)AA This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command applies only to E1 controllers. To determine the line termination setting for the controller, use
the showcontrollerse1command.
Examples In the following example, the line termination is set to 75 ohms for the E1 port located in shelf 6,
slot 0, port 0:
Router# configure terminal
Router(config)# controller e1 6/0/0
Router(config-controller)# line-termination 75-ohm
Router(config-controller)# end
Related Commands Command Description
show controllers e1 Displays information about the E1 links supported by the NPM (Cisco 4000) or MIP
(Cisco 7500 series).
Cisco IOS Interface and Hardware Component Command Reference
639
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
link debounce
link debounce
To enable the debounce timer on an interface, use the linkdebounce command in interface configuration
mode. To disable the timer, use the no form of this command.
link debounce [time time]
no link debounce
Syntax Description time time (Optional) Specifies the extended debounce timer; va lid values are from 100 to 5000
milliseconds.
Command Default The table below lists the debounce timer defaults.
Table 23: Port Debounce Timer Delay Time
Port Type Debounce Timer Disabled Debounce Timer Enabled
10BASE-FL ports 300 milliseconds 3100 milliseconds
10/100BASE-TX ports 300 milliseconds 3100 milliseconds
100BASE-FX ports 300 milliseconds 3100 milliseconds
10/100/1000BASE-TX ports 300 milliseconds 3100 milliseconds
1000BASE-TX ports 300 milliseconds 3100 milliseconds
Fiber Gigabit ports 10 milliseconds 100 milliseconds
10-Gigabit ports except WS-X6501-10GEX4 and 10 milliseconds 100 milliseconds
WS-X6502-10GE
WS-X6501-10GEX4 and WS-X6502-10GE 1000 milliseconds 3100 milliseconds
10-Gigabit ports
Command Modes Interface configuration
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17a)SX This command was changed to remove support for the following modules:
• WS-X6501-10GEX4
• WS-X6502-10GE
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Cisco IOS Interface and Hardware Component Command Reference
640
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
link debounce
Usage Guidelines The timetime keyword and argument are supported on Gigabit Ethernet and 10-Gigabit Ethernet interfaces
only.
The linkdebounce command is not supported on the following modules in releases prior to Release 2.2(17a)SX:
• WS-X6501-10GEX4
• WS-X6502-10GE
The debounce timer sets the amount of time that the firmware waits before it notifies the software that the
link is down. The debounce timer does not apply to linkup because the linkup is immediately notified by the
firmware.
The default debounce time applies when you enter the linkdebounce command with no arguments. For
example, when you enter the linkdebouncetime100 command, it is equivalent to entering the linkdebounce
command with no arguments and you will see the following link debounce entry in the configuration:
interface GigabitEthernet1/1
no ip address
link debounce
Enter the showinterfacesdebounce command to display the debounce configuration of an interface.
Examples This example shows how to configure the debounce timer on a Gigabit Ethernet fiber interface:
Router(config-if)# link debounce time 100
Router(config-if)#
Related Commands Command Description
show interfaces debounce Displays the status and configuration for the debounce timer.
Cisco IOS Interface and Hardware Component Command Reference
641
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
link state group
link state group
To configure the link state group, use the linkstategroup command in interface configuration mode.
link state group [number] {upstream|downstream}
Syntax Description number Specifies a link-state group. The acceptable range of group number is between 1 to 10 and
the default value is 1.
upstream Configures the interface as an upstream interface in the group.
downstream Configures the interface as a downstream interface in the group.
Command Default The default linkstategroupnumber is 1.
Command Modes Interface configuration (config-if)
Command History Release Modification
15.1(1)S This command was introduced.
Usage Guidelines Link State Ttracking (LST), also known as trunk failover, is a feature that binds the link state of multiple
interfaces. When you configure LST for the first time, add upstream interfaces to the link state group before
adding the downstream interface, otherwise the downstream interfaces would move into error-disable mode.
The maximum number of link state groups configurable is 10. These are the limitations:
• An interface can only be an upstream or downstream interface.
• An interface cannot be part of more than one link state tracking group.
Examples The following example shows how to configure the link state group number.
Router# configure terminal
Router(config)# link state track 1
Router(config)# interface gigabitethernet3/1
Router(config-if)# link state group 1 upstream
Router(config-if)# interface gigabitethernet3/3
Router(config-if)# link state group 1 upstream
Router(config-if)# interface gigabitethernet3/5
Router(config-if)# link state group 1 downstream
Router(config-if)# interface gigabitethernet3/7
Router(config-if)# link state group 1 downstream
Related Commands Command Description
link state track Configures the link-state track number.
show link state group Displays the link-state group information.
Cisco IOS Interface and Hardware Component Command Reference
642
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
link state track
link state track
To configure a link state tracking number, use the linkstatetrack command in global configuration mode.
To restore the default linkstatetracknumber, use the no form of this command.
link state track number
no link state track number
Syntax Description number Specifies the link state tracking number. The acceptable range is between 1 and 10 and the default
value is 1.
Command Default The default link state track number is 1.
Command Modes Global configuration (config)
Command History Release Modification
15.1(1)S This command was introduced.
Usage Guidelines Link State Ttracking (LST), also known as trunk failover, is a feature that binds the link state of multiple
interfaces. When you configure LST for the first time, add upstream interfaces to the link state group before
adding the downstream interface, otherwise the downstream interfaces would move into error-disable mode.
Examples The following example shows how to configure the link state tracking number.
Router# configure terminal
Router(config)# link state track 1
Related Commands Command Description
link state group Configures the link state group and the interface as either an upstream or
downstream interface in the group.
show link state group Displays the link state group information.
Cisco IOS Interface and Hardware Component Command Reference
643
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
li-slot rp rate
li-slot rp rate
To apply the user specified Packets Per Second (PPS) value when an Lawful Intercept (LI) is provisioned in
RP mode, use the li-slot rp rate command in global configuration mode. To disable the user specified value,
use the no form of this command .
li-slot rp rate pps
Syntax Description pps Packets per second (pps). The range is from 10 to 8500 for SUP720, 10 to 6000 for SUP32, and 10 to
12000 for RSP720.
Command Default No default behavior or values.
Command Modes Global configuration (config)
Command History Release Modification
15.0(1)S5 This command was introduced on the Cisco 7600 series routers.
Examples This example shows how to apply PPS value when an LI is provisioned in RP mode:
router# configure terminal
router(config)# li-slot rp rate 5000
Related Commands Command Description
show mls rate-limit Displays information about the configured rate limiters.
Cisco IOS Interface and Hardware Component Command Reference
644
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
link-test
link-test
To reenable the link-test function on a port on an Ethernet hub of a Cisco 2505 or Cisco 2507 router, use the
link-test command in hub configuration mode. To disable this function, use the no form of this command.
link-test commandlink-test
no link-test
Syntax Description This command has no arguments or keywords.
Command Default Enabled
Command Modes Hub configuration
Command History Release Modification
10.3 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command applies to a port on an Ethernet hub only. Disable this feature if a 10Base-T twisted-pair device
at the other end of the hub does not implement the link test function.
Examples The following example disables the link test function on hub 0, ports 1 through 3:
Router(config)#
hub ethernet 0 1 3
Router(config-hub)#
no link-test
Related Commands Command Description
hub Enables and configures a port on an Ethernet hub of a Cisco 2505 or Cisco 2507 router.
Cisco IOS Interface and Hardware Component Command Reference
645
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
load-balancing
load-balancing
To apply a load-balancing method to a Gigabit EtherChannel (GEC) interface, use the load-balancing command
in interface configuration mode. To reset to the default, use the no form of this command.
load-balancing {flow|vlan}
no load-balancing
Syntax Description flow Flow-based load balancing is used.
vlan VLAN-manual load balancing is used.
Command Default The port channel uses the global load-balancing configuration.
Command Modes Interface configuration (config-if)
Command History Release Modification
Cisco IOS XE Release 2.5 This command was introduced.
Usage Guidelines The load-balancing command sets the load-balancing method on a specific port channel. The load-balancing
method configured with this command takes precedence over the global configuration defined with the
port-channelload-balancingvlan-manual command.
If you do not explicitly configure load balancing either globally or on the port channel, the load-balancing
method on the port channel is set to flow-based.
Load balancing uses the concept of buckets to map traffic flows to the member links of the port channel. The
different traffic flows are mapped to the buckets and each bucket has one active member link associated with
it. All flows that are mapped to a bucket use the member link associated with that bucket.
There are two methods of load balancing on a GEC interface:
• VLAN-manual--All packets forwarded over the same VLAN subinterface are considered part of the
same flow and are mapped to the member link specified in the configuration.
• Flow-based--Traffic flows are mapped to different member links based on the packet header.
Examples This example shows how to set the load-balancing method to VLAN-manual:
Router(config)# interface port-channel 1
Router(config-if)# load-balancing vlan
Related Commands Command Description
interface port-channel Creates a port-channel virtual interface.
port-channel load-balancing vlan-manual Applies the VLAN-manual load-balancing method globally
to all GEC interfaces.
Cisco IOS Interface and Hardware Component Command Reference
646
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
load-balancing
Command Description
show interfaces port-channel etherchannel Displays the load-balancing bucket distribution currently in
use for a GEC interface.
show etherchannel load-balancing Displays the load-balancing method applied to GEC
interfaces.
Cisco IOS Interface and Hardware Component Command Reference
647
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
load-interval
load-interval
To change the length of time for which data is used to compute load statistics, use the load-interval command
in interface configuration, Frame Relay DLCI configuration, or template configuration modes. To revert to
the default setting, use the noform of this command.
load-interval seconds
no load-interval seconds
Syntax Description seconds Length of time for which data is used to compute load statistics. Value is a multiple of 30, from
30 to 600 (30, 60, 90, 120, and so on). The default is 300 seconds.
Command Default Enabled
Command Modes Interface configuration
Frame Relay DLCI configuration
Template configuration (config-template)
Command History Release Modification
10.3 This command was introduced.
12.2(4)T This command was made available in Frame Relay DLCI configuration mode.
12.2(18)SXF Support for this command was introduced on the Supervisor Engine 720.
12.2(28)SB This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
15.1(2)SNG This command was implemented on the Cisco ASR 901 Series Aggregation
Services Routers.
15.2(2)E This command was integrated into Cisco IOS Release 15.2(2)E. This command
is supported in template configuration mode.
Cisco IOS XE Release 3.6E This command was integrated into Cisco IOS XE Release 3.6E. This command
is supported in template configuration mode.
Usage Guidelines To make computations more reactive to short bursts of traffic, you can shorten the length of time over which
load averages are computed.
If the load interval is set to 30 seconds, new data is used for load calculations over a 30-second period. This
data is used to compute load statistics, including the input rate in bits and packets per second, the output rate
in bits and packets per second, the load, and reliability.
Load data is gathered every five seconds. This data is used for a weighted-average calculation in which recent
load data has more weight in the computation than older load data. If the load interval is set to 30 seconds,
the average is computed for the last 30 seconds of load data.
Cisco IOS Interface and Hardware Component Command Reference
648
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
load-interval
If you change the calculation interval from the default of five minutes to a shorter period of time, the input
and output statistics that are displayed by the show interface command or the show frame-relay pvc command
will be more current and will be based on more nearly instantaneous data, rather than reflecting the average
load over a longer period of time.
This command is often used for dial backup purposes to increase or decrease the likelihood of implementation
of a backup interface, but it can be used on any interface.
Examples
Interface Example
In the following example, the default average of five minutes is changed to a 30-second average. A
burst in traffic that would not trigger a dial backup for an interface configured with the default
five-minute interval might trigger a dial backup for this interface, which is set for the shorter 30-second
interval.
Router(config)# interface serial 0
Router(config-if)# load-interval 30
Frame Relay PVC Example
In the following example, the load interval is set to 60 seconds for a Frame Relay PVC with the
DLCI 100:
Router(config)# interface serial 1/1
Router(config-if)# frame-relay interface-dlci 100
Router(config-fr-dlci)# load-interval 60
Interface Template Example
In the following example, the load interval is set to 60 seconds in an interface template:
Device# configure terminal
Device(config)# template user-template1
Device(config-template)# load-interval 60
Device(config-template)# end
Related Commands Command Description
show interfaces Displays statistics for all interfaces configured on the router or access server.
Cisco IOS Interface and Hardware Component Command Reference
649
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
local ip address
local ip address
To define an IP address to identify a local circuit emulation (CEM) channel, use the localipaddresscommand
in CEM xconnect configuration mode.
local ip address ip-address
Syntax Description ip-address IP address of a regular or loopback interface in the local router. Default is 0.0.0.0
Command Default The default local IP address is 0.0.0.0 for a CEM channel.
Command Modes CEM xconnect configuration
Command History Release Modification
12.3(7)T This command was introduced.
Usage Guidelines This command does not have a no form. To remove a local IP address, either configure a new local IP address
or enter the noxconnect command to disable the connection and all its parameters.
The local IP address used to identify the local end of a CEM connection must be the same as the IP address
defined by the remote-ip-addressargument used in the xconnect command to identify the CEM channel at
the other end of the CEM connection.
Note If there are multiple CEM connections that originate from the same router, they may share the same local IP
address provided that each local IP address defines a unique UDP port number using thelocaludpport command.
Examples The following example demonstrates how to configure the IP address of the local endpoint of the
CEM over IP (CEoIP) connection.
Router(config-cem-xconnect)# local ip address 10.0.5.1
Related Commands Command Description
clear cem Clears CEM statistics.
local udp port Defines the UDP port at the local end of a CEM connection.
show cem Displays CEM statistics.
xconnect (CEM) Builds one end of a CEM connection and enters CEM xconnect configuration mode.
Cisco IOS Interface and Hardware Component Command Reference
650
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
local-priority
local-priority
To set the PTP clock's local priority.
Note This command is used only for the G.8275.1 telecom profile.
local-priority local-priority
Syntax Description local-priority Local priority value of the clock. The valid values are from 1 to 255.
Command Default The default local priority is 1.
Command Modes PTP Clock Configuration
Command History Release Modification
IOS-XE 3.18 This command was introduced.
Usage Guidelines The configured local priority is ignored on ports without the G.8275.1 or G.8275.2 profile.
Examples The following example demonstrates how to configure the local priority of the master-only ordinary
clock.
Router# configure terminal
Router(config)# ptp clock ordinary domain 24
Router(config-ptp-clk)# local-priority 1
Related Commands Command Description
ptp clock Creates a Precision Time Protocol clock and specifies the clock mode
.
priority1 Sets priority1.
priority2 Sets priority2.
show ptp clock dataset default Verifies the local priority of the PTP clock.
Cisco IOS Interface and Hardware Component Command Reference
651
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
local udp port
local udp port
To define the User Datagram Protocol (UDP) port of the local endpoint of a circuit emulation (CEM) connection,
use the localudpportcommand in CEM xconnect configuration mode.
local udp port port
Syntax Description port Number of the CEM local UDP port. Possible values are 0, 2141, and 15872 through 16383. The
default is 0.
Command Default The default local UDP port number is 0 for the local endpoint of a CEM connection.
Command Modes CEM xconnect configuration
Command History Release Modification
12.3(7)T This command was introduced.
Usage Guidelines This command does not have a no form. To remove a local UPD port number, either configure a new UPD
port number or enter the noxconnect command to disable the connection and all its parameters.
Examples The following example demonstrates how to configure the UDP port of the local endpoint of the
CEM over IP (CEoIP) connection.
Router(config-cem-xconnect)# local udp port 2141
Related Commands Command Description
remote udp port Defines the UDP port of the remote endpoint of a CEM connection.
show cem Displays CEM channel statistics.
xconnect (CEM) Builds one end of a CEM connection and enters CEM xconnect configuration mode.
Cisco IOS Interface and Hardware Component Command Reference
652
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
local-lnm
local-lnm
To enable Lanoptics Hub Networking Management of a PCbus Token Ring interface, use the local-lnm
command in interface configuration mode. To disable Lanoptics Hub Networking Management, use the no
form of this command.
local-lnm commandlocal-lnm
no local-lnm
Syntax Description This command has no arguments or keywords.
Command Default Management is not enabled.
Command Modes Interface configuration
Command History Release Modification
10.3 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The Token Ring interface on the AccessPro PC card can be managed by a remote LAN manager over the
PCbus interface. At present, the Lanoptics Hub Networking Management software running on an IBM
compatible PC is supported.
Examples The following example enables Lanoptics Hub Networking Management:
Router(config-if)# local-lnm
Cisco IOS Interface and Hardware Component Command Reference
653
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
logging event
logging event
To enable notification of interface, subinterface, and Frame Relay data link connection identifier (DLCI) data
link status changes, use the loggingevent command in interface configuration mode. To disable notification,
use the no form of this command.
logging event {dlci-status-change|link-status|subif-link-status [ignore-bulk]}
no logging event {dlci-status-change|link-status|subif-link-status [ignore-bulk]}
Syntax Description dlci-status-change Enables notification of Frame Relay DLCI status changes.
Note This option is supported only when the encapsulation on the interface is
Frame Relay.
link-status Enables notification of interface data link status changes.
subif-link-status Enables notification of subinterface data link status changes.
ignore-bulk Suppresses link status messages for subinterfaces when they are caused by a state
change of the main interface.
Command Default For system images, notification of interface, subinterface, and Frame Relay DLCI data link status changes is
enabled by default.
For boot images, notification of Frame Relay subinterface and DLCI data link status changes is disabled by
default. Notification of interface data link status changes is enabled by default.
Command Modes Interface configuration
Command History Release Modification
12.0 This command was introduced.
12.2(32)S The ignore-bulk keyword was integrated into the Cisco IOS Release 12.2(32)S.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.3(7)T The ignore-bulk keyword was integrated into Cisco IOS Release 12.3(7)T.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples The following example shows how to enable notification of subinterface link status changes:
Router(config-if)# logging event subif-link-status
The following are examples of Frame Relay DLCI and subinterface status change notification
messages filtered by the loggingevent command:
00:16:22: %FR-5-DLCICHANGE: Inteface Serial3/0/0:1 - DLCI 105 state changed to INACTIVE
Cisco IOS Interface and Hardware Component Command Reference
654
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
logging event
00:16:22: %LINEPROTO-5-UPDOWN: Line protocol on Interface Serial3/0/0:1.5, changed state
to down
Cisco IOS Interface and Hardware Component Command Reference
655
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
logging source-interface
logging source-interface
To specify the source IPv4 or IPv6 address of system logging packets, use the loggingsource-interface
command in global configuration mode . To remove the source designation, use the no form of this command.
logging source-interface type number
no logging source-interface
Syntax Description type number Interface type and number.
Command Default The wildcard interface address is used.
Command Modes Global configuration (config)
Command History Release Modification
11.2 This command was introduced.
12.4(4)T This command was modified. IPv6 support was added.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX. Support in a specific 12.2SX
release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command can be configured on the Virtual Routing and Forwarding (VRF) and non-VRF interfaces.
Normally, a syslog message contains the IPv4 or IPv6 address of the interface used to leave the router. The
loggingsource-interface command configures the syslog packets contain the IP or IPv6 address of a particular
interface, regardless of which interface the packet uses to exit the router.
When no specific interface is configured, a wildcard interface address of 0.0.0.0 (for IPv4) or :: (for IPv6) is
used, and the IP socket selects the best outbound interface.
Examples In the following example, the user specifies that the IP address of Ethernet interface 0 is the source
IP address for all syslog messages:
Router(config)# logging source-interface ethernet 0
The following example specifies that the IP address for Ethernet interface 2/1 is the source IP address
for all syslog messages:
Router(config)# logging source-interface ethernet 2/1
The following sample output displays that the loggingsource-interface command is configured on
a VRF source interface:
Router# show running interface loopback49
Building configuration...
Current configuration : 84 bytes
Cisco IOS Interface and Hardware Component Command Reference
656
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
logging source-interface
!
interface Loopback49
ip vrf forwarding black
ip address 49.0.0.1 255.0.0.0
end
Router# show running | includes logging
logging source-interface Loopback49 vrf black
logging host 130.0.0.1 vrf black
Related Commands Command Description
logging Logs messages to a syslog server host.
Cisco IOS Interface and Hardware Component Command Reference
657
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
logging event link-status (global configuration)
logging event link-status (global configuration)
To change the default or set the link-status event messaging during system initialization, use the logging event
link-status command in global configuration mode. To disable the link-status event messaging, use the no
form of this command.
logging event link-status {default|boot}
no logging event link-status {default|boot}
Syntax Description default Enables system logging of interface state-change events on all interfaces in the system.
boot Enables system logging of interface state-change events on all interfaces in the system during system
initialization.
Command Default Interface state-change messages are not sent.
Command Modes Global configuration
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines You do not have to enter the logging event link-status boot command to enable link-status messaging during
system initialization. The logging event link-status default command logs system messages even during
system initialization.
If you enter both the logging event link-status default and the no logging event link-status bootcommands,
the interface state-change events are logged after all modules in the Cisco 7600 series router come online after
system initialization. The logging event link-status default and the no logging event link-status boot
commands are saved and retained in the running configuration of the system.
When both the logging event link-status default and the no logging event link-status bootcommands are
present in the running configuration and you want to display the interface state-change messages during system
initialization, enter the logging event link-status boot command.
Examples This example shows how to enable the system logging of the interface state-change events on all
interfaces in the system:
Router(config)# logging event link-status default
Router(config)#
This example shows how to enable the system logging of interface state-change events on all interfaces
during system initialization:
Router(config)# logging event link-status boot
Router(config)#
Cisco IOS Interface and Hardware Component Command Reference
658
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
logging event link-status (global configuration)
This example shows how to disable the system logging of interface state-change events on all
interfaces:
Router(config)# no logging event link-status default
Router(config)#
This example shows how to disable the system logging of interface state-change events during system
initialization:
Router(config)# no logging event link-status boot
Router(config)#
Related Commands Command Description
show running-config Displays the status and configuration of the module or Layer 2 VLAN.
Cisco IOS Interface and Hardware Component Command Reference
659
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
logging event link-status (interface configuration)
logging event link-status (interface configuration)
To enable link-status event messaging on an interface, use the logging event link-status command in interface
configuration mode. To disable link-status event messaging, use the no form of this command.
logging event link-status [{bchan|dchan|nfas}]
no logging event link-status [{bchan|dchan|nfas}]
Syntax Description bchan (Optional) Logs B-channel status messages. This keyword is available only for integrated services
digital network (ISDN) serial interfaces.
dchan (Optional) Logs D-channel status messages. This keyword is available only for ISDN serial
interfaces.
nfas (Optional) Logs non-facility associated signaling (NFAS) D-channel status messages. This keyword
is available only for ISDN serial interfaces.
Command Default Interface state-change messages are not sent.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(14)SX This command was introduced on the Supervisor Engine 720.
12.2(17d)SXB This command was modified to support the Supervisor Engine 2.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines To enable system logging of interface state-change events on a specific interface, enter the logging event
link-status command.
Examples The following example shows how to enable link-status event messaging on an interface:
Router(config-if)# logging event link-status
This example shows how to disable link-status event messaging on an interface:
Router(config-if)# no logging event link-status
Cisco IOS Interface and Hardware Component Command Reference
660
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
logging event subif-link-status
logging event subif-link-status
To enable the link-status event messaging on a subinterface, use the logging event subif-link-status command
in interface configuration mode. To disable the link-status event messaging on a subinterface, use the no form
of this command.
logging event subif-link-status
no logging event subif-link-status
Syntax Description This command has no arguments or keywords.
Command Default Subinterface state-change messages are not sent.
Command Modes Interface configuration
Command History Release Modification
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine
720.
To enable system logging of interface state-change events on a specific subinterface, enter the logging event
subif-link-status command.
To enable system logging of interface state-change events on a specific interface, enter the logging event
link-status command.
To enable system logging of interface state-change events on all interfaces in the system, enter the logging
event link-status command.
Examples This example shows how to enable the system logging of the interface state-change events on a
subinterface:
Router(config-if)# logging event subif-link-status
Router(config-if)#
This example shows how to disable the system logging of the interface state-change events on a
subinterface:
Router(config-if)# no logging event subif-link-status
Router(config-if)#
Related Commands Command Description
show running-config Displays the status and configuration of the module or Layer 2 VLAN.
Cisco IOS Interface and Hardware Component Command Reference
661
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
logging-events
logging-events
to print typical T3 controller Up and Down messages on a Channelized T3 Port Adapter,use the
logging-eventscommandin T3 controller configuration
mode.UsethenoformofthiscommandtodisableprintingoftheT3controllerUpandDownmessages.
logging-events [detail]
[no] logging-events
Syntax Description detail (Optional) Enables printing the reason code when a T3 controller changes from the Up to Down
state.
Command Default The logging-eventscommandisthedefault.
Command Modes T3 controller configuration
Command History Release Modification
12.2(19c) This command was introduced.
Usage Guidelines When the no logging-events command disables printing of the T3 controller Up and Down messages,
these messages will neither appear on the console nor in the logs.
Examples The following example uses the logging-events [detail] command to show the Out-of-Frame (OOF)
reason code when the T3 controller changes from an Up state to a Down state:
Router(config-controller)# logging-events detail
*Jun 19 17:47:50: %CONTROLLER-5-DOWNDETAIL: Controller T3 4/1, changed state to down due
to OOF
Related Commands Command Description
t1 logging-events Prints the typical T1 controller Up and Down messages on a channelized T3 port
adapter.
Cisco IOS Interface and Hardware Component Command Reference
662
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
logging-events (T1-E1 controller)
logging-events (T1-E1 controller)
To show the controller state change and alarms on a controller, use the logging-eventscommand in controller
configuration mode. To turn off controller state change reporting, use the no form of the command.
logging-events detail
no logging-events
Syntax Description detail Alarm along with the controller state change.
Command Default Logging-events is the default.
Command Modes Controller configuration
Command History Release Modification
12.2(18)SXE This command was introduced to support SPAs on the Cisco 7600 series router and Catalyst
6500 series switch.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines Use the logging-eventscommand to show the state change and alarms on a controller on an 8-Port Channelized
T1/E1 Serial SPA.
Examples The following shows enabling the logging-events command.
Router(config)#contr e1 2/1/0
Router(config-controller)# logging-events
Related Commands Command Description
controller Configures a T1, E1, or T3 controller and enters controller configuration mode.
show controller Displays controller configuration.
Cisco IOS Interface and Hardware Component Command Reference
663
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
loopback (CEM)
loopback (CEM)
To set the loopback method for testing a T1, E1, serial CEM interface, and VCoP Smart SFP, use the loopback
command in controller configuration or CEM configuration mode. To remove any existing loopback, use the
no form of this command.
Cisco NM-CEM-4SER
loopback {local|network}
no loopback
Cisco NM-CEM-4TE1
loopback {local {payload|line}|network}
no loopback
Cisco IOS XE Release 3.18SP
loopback {diag|local|{payload|line}}
no loopback
Cisco IOS XE Release 3.18.1SP
loopback {local | network {payload|line}}
no loopback
Syntax Description diag Loops the outgoing transmit signal back to the receive signal. This is done using the diagnostic
loopback feature in the interface module’s framer.
local Places the interface into local loopback mode and creates a loopback wherein information received
from the locally-attached customer premises equipment (CPE) is transmitted back to the
locally-attached CPE.
• payload --(Used only if a local loopback is specified for a T1/E1 channel) Creates a loopback
of only the data in individual time slots. In this mode, framing bits are terminated and then
regenerated instead of being looped back. This mode is not available if the port is configured
for framingunframed.
• line --(Used only if a local loopback is specified for a T1/E1 channel) Creates a full physical
layer loopback of all bits, including data and framing bits.
network Creates a loopback wherein data received over the network from the remote CPE is transmitted
back to the remote CPE.
Command Default No loopback is configured for a CEM interface.
Command Modes CEM configuration
Controller configuration
Controller configuration
Controller configuration
Cisco IOS Interface and Hardware Component Command Reference
664
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
loopback (CEM)
Command History Release Modification
12.3(7)T This command was introduced.
XE 3.18SP This command was integrated in Cisco NCS 4200 Series.
XE 3.18.1SP This command was integrated in Cisco 900 Series Router.
Cisco IOS XE Everest This command was integrated in Cisco ASR 903 Series Router and Cisco NCS
16.5.1 4200 Series.
Usage Guidelines Use this command to create a loopback for a CEM interface. You can use a loopback to test for equipment
malfunction caused by the interface.
The NM-CEM-4TE1 does not respond to loopback requests initiated by the CPE, locally attached or remote,
using the extended super frame (ESF) Facility Data Link (FDL) mechanism or by any other mechanism.
The NM-CEM-4SER does not respond to any form of loopback request initiated by the locally attached or
remote CPE on the Local Loop (LL) or Remote Loop (RL) control leads. Nor does the NM-CEM-4SER
respond to any form of loopback request initiated by the locally attached or remote CPE using in-band loopback
codes.
Examples The following example shows how to create a loopback on a CEM T1/E1 interface so that data
received from a remote CPE is transmitted back to the remote CPE on the network.
Router(config-controller)# loopback network
The following example shows how to create a loopback of data in individual time slots on a CEM
T1/E1 interface. Data received from a locally attached CPE will be sent back to the locally attached
CPE.
Router(config-controller)# loopback local payload
The following example shows how to create a loopback on a serial CEM channel so that data received
from a remote CPE is transmitted back to the remote CPE on the network.
Router(config-cem)# loopback network
The following example shows how to set a loopback on the T1 interfaces for loopback diag.
Router(config-controller)# loopback diag
The following example shows how to set a loopback on the C37.94 interface for loopback local.
Router(config-controller)# loopback local line
Related Commands Command Description
cem Enters circuit emulation configuration mode.
controller Enters controller configuration mode.
Cisco IOS Interface and Hardware Component Command Reference
665
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
loopback (DSL controller)
loopback (DSL controller)
To test the controller and configure the core loopback, use the loopback(DSLController)command in controller
configuration mode. To remove the loopback interface, use the no form of this command.
loopback {analog|digital}
no loopback
Syntax Description analog Loops the circuit at the analog hybrid to verify the analog loopback hardware to the analog hybrid.
digital Loops the circuit at the framer to verify the hardware to the framer.
Command Default No default behavior or values.
Command Modes Controller configuration
Command History Release Modification
12.3(4)XD This command was introduced on Cisco 2600 series and Cisco 3700 series routers.
12.3(4)XG This command was integrated into Cisco IOS Release 12.3(4)XG on the Cisco 1700 series routers.
12.3(7)T This command was integrated in Cisco IOS Release 12.3(7)T on Cisco 2600 series, Cisco 3631,
and Cisco 3700 series routers.
12.3(11)T This command was integrated into Cisco IOS Release 12.3(11)T on Cisco 2800 series and Cisco
3800 series routers.
12.3(14)T This command was integrated into Cisco IOS Release 12.3(14)T on Cisco 1800 series routers.
Usage Guidelines Analog and digital loopbacks are local loopbacks. Digital loopbacks loop the circuit at the framer to verify
the hardware to the framer, and analog loopbacks loop the circuit at the analog hybrid to verify the analog
loopback hardware to the analog hybrid. The controller must be shut down before loopback can be configured.
Examples If the controller is still up, the router will prompt you to turn the controller off as shown in this
example:
Router(config-controller)# loopback
analog
Please shut down the xDSL controller
Router(config-controller)# loopback
digital
Please shut down the xDSL controller
The following example shows the configuration of a loopback digital interface:
Router(config-controller)# loopback digital
Please shut down the xDSL controller
Router(config-controller)# shutdown
Cisco IOS Interface and Hardware Component Command Reference
666
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
loopback (DSL controller)
Router(config-controller)#
00:59:50: %CONTROLLER-5-UPDOWN: Controller DSL 0/0, changed state to
administratively down
Router(config-controller)#
Router(config-controller)# loopback digital
Router(config-controller)# no shutdown
Apr 23 06:59:01.435: DSL 0/0 controller Link up! line rate: 4608 Kbps
o
00:59:59: %CONTROLLER-5-UPDOWN: Controller DSL 0/0, changed state to up
Router(config-controller)#end
Router# show controllers dsl 0/0
DSL 0/0 controller UP
Local Digital loopback is running
Globespan xDSL controller chipset
DSL mode: SHDSL Annex B
Frame mode: Utopia
Configured Line rate: 4608Kbps
Line Re-activated 4 times after system bootup
LOSW Defect alarm: ACTIVE
CRC per second alarm: ACTIVE
Line termination: CO
FPGA Revision: 0xA7
Line 0 statistics
Current 15 min CRC: 679
Current 15 min LOSW Defect: 8
Current 15 min ES: 5
Current 15 min SES: 5
Current 15 min UAS: 397
Previous 15 min CRC: 0
Previous 15 min LOSW Defect: 0
Previous 15 min ES: 0
Previous 15 min SES: 0
Previous 15 min UAS: 0
Line 1 statistics
Current 15 min CRC: 577
Current 15 min LOSW Defect: 8
Current 15 min ES: 7
Current 15 min SES: 4
Current 15 min UAS: 411
Previous 15 min CRC: 0
Previous 15 min LOSW Defect: 0
Previous 15 min ES: 0
Previous 15 min SES: 0
Previous 15 min UAS: 0
Line-0 status
Chipset Version: 1
Firmware Version: A29733
Modem Status: un checked mode, Status 83
Last Fail Mode: No Failure status:0x0
Line rate: 2312 Kbps
Framer Sync Status: In Sync
Rcv Clock Status: In the Range
Loop Attenuation: 0.0 dB
Transmit Power: 13.5 dB
Receiver Gain: 936.8420 dB
SNR Sampling: 16.960 dB
Line-1 status
Chipset Version: 1
Firmware Version: A29733
Modem Status: un checked mode, Status 83
Last Fail Mode: No Failure status:0x0
Line rate: 2312 Kbps
Framer Sync Status: In Sync
Rcv Clock Status: In the Range
Cisco IOS Interface and Hardware Component Command Reference
667
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
loopback (DSL controller)
Loop Attenuation: 0.0 dB
Transmit Power: 13.5 dB
Receiver Gain: 936.8420 dB
SNR Sampling: 16.3590 dB
Dying Gasp: Present
Related Commands Command Description
show interfaces loopback Displays information about the loopback interface.
Cisco IOS Interface and Hardware Component Command Reference
668
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
loopback (E3 controller)
loopback (E3 controller)
To loop an entire E3 line toward the line and back toward the router, use the loopbackcommand in controller
configuration mode. To remove the loop, use the no form of this command.
loopback {local|network {line|payload}}
no loopback
Syntax Description local Loops the data back toward the router and sends an AIS signal out toward the
network. This is the default.
network line payload Sets the loopback toward the network either before going through the framer
(line) or after going through the framer (payload).
Command Default local
Command Modes Controller configuration
Command History Release Modification
11.3 This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and implemented on the
following platforms for E3: Cisco 2650XM, Cisco 2651XM, Cisco 2691, Cisco 3660 series,
Cisco 3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
Usage Guidelines Use this command for troubleshooting purposes. To verify that a loopback is configured on the interface, use
the showcontrollerse3EXEC command. Note that line loopback is available only in C-bit parity mode.
Examples The following example shows how to configure the controller located in slot 1, port 0 for a local
loopback:
Router(config)# controller e3 1/0
Router(config-controller)# loopback local
Related Commands Command Description
show controllers e3 Displays information about the E3 controllers.
Cisco IOS Interface and Hardware Component Command Reference
669
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
loopback (interface)
loopback (interface)
To diagnose equipment malfunctions between the interface and device, use the loopbackcommand in interface
configuration mode. To disable the test, use the no form of this command.
loopback
no loopback
Syntax Description This command has no arguments or keywords.
Command Default Disabled
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Loopback on HSSI Cards
On High-Speed Serial Interface (HSSI) cards, the loopback function configures a two-way internal and external
loop on the HSA applique of the specific interface.
Loopback on MCI and SCI Serial Interface Cards
On MCI and SCI serial interface cards, the loopback functions when a CSU/DSU or equivalent device is
attached to the router or access server. Theloopback command loops the packets through the CSU/DSU to
configure a CSU loop, when the device supports this feature.
Loopback on MCI and MEC Ethernet Cards
On the MCI and MEC Ethernet cards, the interface receives back every packet it sends when the loopback
command is enabled. Loopback operation has the additional effect of disconnecting network server functionality
from the network.
Loopback on CSC-FCI FDDI Cards
On the CSC-FCI FDDI card, the interface receives back every packet it sends when the loopback command
is enabled. Loopback operation has the additional effect of disconnecting network server functionality from
the network.
Loopback on Token Ring Interface Cards
On all Token Ring interface cards (except the 4-megabit CSC-R card), the interface receives back every packet
it sends when the loopback command is enabled. Loopback operation has the additional effect of disconnecting
network server functionality from the network.
Active Loopback Interfaces
To show interfaces currently in loopback operation, use the showinterfacesloopback EXEC command.
Cisco IOS Interface and Hardware Component Command Reference
670
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
loopback (interface)
Note Loopback does not work on an X.21 DTE because the X.21 interface definition does not include a loopback
definition.
Examples The following example configures the loopback test on Ethernet interface 4:
Router(config)# interface ethernet 4
Router(config-if)# loopback
Related Commands Command Description
down-when-looped Configures an interface to inform the system it is down when loopback is
detected.
show interfaces loopback Displays information about the loopback interface.
Cisco IOS Interface and Hardware Component Command Reference
671
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
loopback (J1 controller )
loopback (J1 controller )
To set the loopback method for testing the J1 interface, use the loopback command in controller configuration
mode. To turn off loopback, use the no form of this command. This command should be used for testing
purposes only.
loopback {local|line|isolation}
no loopback {local|line|isolation}
Syntax Description local Places the interface into local loopback mode.
line Places the interface into external loopback mode at the line level.
isolation Places the interface into both local and line loopback mode.
Command Default No loopback is configured.
Command Modes Controller configuration
Command History Release Modification
11.3 MA This command was implemented on the Cisco MC3810.
12.0(5)T and 12.0(7)XR The command was implemented on the Cisco 2600 and Cisco 3600 series.
12.0(5)XE The command was implemented on the Cisco 7200 and Cisco 7500 series.
12.1(1)T The command was implemented on the Cisco 2600 series.
12.2(8)T The command was implemented on the Cisco 2600 and Cisco 3600 series.
Examples The following example establishes a loopback of the incoming J1 signal on controller J1 3/0:
Router(config)# controller j1 3/0
Router(config-controller)# loopback line
Cisco IOS Interface and Hardware Component Command Reference
672
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
loopback (PA-MC-8TE1+ port adapter)
loopback (PA-MC-8TE1+ port adapter)
To enable loopback testing of data for the PA-MC-8TE1+ port adapter, use the loopback command in interface
configuration mode. To disable loopback testing, use the no form of this command.
loopback [{internal|line}]
no loopback [{internal|line}]
Syntax Description internal (Optional) Loops any data received at the PA-MC-8TE1+ port adapter’s network interface back
into the PA-MC-8TE1+ port adapter.
line (Optional) Loops any data received at the PA-MC-8TE1+ port adapter’s network interface back
into the network.
Command Default Loopback mode is not enabled.
Command Modes Interface configuration
Command History Release Modification
12.2(13)T This command was introduced.
Examples In the following example, a loopback is set for the PA-MC-8TE1+ port adapter in slot 2:
Router(config)# interface 2/0
Router(config-if)# loopback line
Cisco IOS Interface and Hardware Component Command Reference
673
l2 vfi manual through loopback PA-MC-8TE1 + port adapter
loopback (PA-MC-8TE1+ port adapter)
Cisco IOS Interface and Hardware Component Command Reference
674
loopback T1 interface through nrzi-encoding
• loopback (T1 interface), on page 677
• loopback (T3/E3 controller), on page 680
• loopback (T3-E3 interface), on page 682
• loopback applique, on page 684
• loopback dte, on page 685
• loopback line, on page 686
• loopback remote (interface), on page 688
• loopback remote (T1/T3/SDH/SONET Controller), on page 691
• loopback (SONET), on page 694
• mac-address-table learning, on page 695
• mac-address (virtual switch), on page 697
• mac-address-table secure, on page 699
• main-fiber port, on page 703
• max-reserved-bandwidth, on page 704
• mdix auto, on page 707
• mdl, on page 708
• media-type, on page 710
• media-type auto-failover, on page 712
• member subslot, on page 713
• microcode reload controller, on page 717
• mls exclude protocol, on page 718
• mls ip delete-threshold, on page 719
• mls ip directed-broadcast, on page 720
• mls ipx, on page 722
• mls verify, on page 723
• mobility, on page 725
• mode, on page 727
• mode (ATM T1 E1 controller), on page 730
• mode (HSA redundancy), on page 733
• mode (RSC redundancy), on page 735
• mode (T1 E1 controller), on page 736
• mode bypass, on page 739
• mode c-12, on page 741
Cisco IOS Interface and Hardware Component Command Reference
675
loopback T1 interface through nrzi-encoding
• mode ct3, on page 743
• mode download, on page 744
• mode e3, on page 745
• mode sonet, on page 746
• mode sts-nc, on page 747
• mode t3/e3, on page 748
• mode two-way, on page 749
• mode vc-1x, on page 750
• mode vc-4, on page 751
• mode vc4-Nc, on page 752
• mode vt-15, on page 753
• mode t3, on page 754
• mode tug-3, on page 755
• modem dtr-delay, on page 756
• monitoring, on page 757
• mop enabled, on page 759
• mop sysid, on page 760
• mtu, on page 761
• national bit (controller), on page 764
• national bit (interface), on page 765
• national reserve, on page 766
• negotiation, on page 767
• neighbor (VPLS), on page 769
• network-clock (BITS), on page 771
• network-clock clear lockout, on page 774
• network-clock hold-off global, on page 776
• network-clock input-source, on page 777
• network-clock set lockout, on page 778
• network-clock synchronization ssm option, on page 780
• network-clock synchronization automatic, on page 782
• network-clock synchronization mode QL-enabled, on page 783
• network-clock quality-level, on page 784
• no channelized, on page 787
• nrzi-encoding, on page 789
Cisco IOS Interface and Hardware Component Command Reference
676
loopback T1 interface through nrzi-encoding
loopback (T1 interface)
loopback (T1 interface)
To loop individual T1 channels on the CT3IP in Cisco 7000 series routers that have the RSP7000 and
RSP7000CI and in Cisco 7500 series routers, use the loopbackcommand in interface configuration mode. To
remove the loopback, use the no form of this command.
loopback [{local|network {line|payload}|remote {line {fdl {ansi|bellcore}|inband}|payload [fdl]
[ansi]}}]
no loopback
Syntax Description local (Optional) Loops the router output data back toward the router at the T1 framer and
sends an alarm indication signal (AIS) signal out toward the network.
network line | (Optional) Loops the data back toward the network before the T1 framer and
payload automatically sets a local loopback at the High-Level Data Link Control (HDLC)
controllers (line), or loops the payload data back toward the network at the T1
framer and automatically sets a local loopback at the HDLC controllers (payload).
remote linefdl (Optional) Sends a repeating, 16-bit Extended Superframe (ESF) data link code
{ansi|bellcore word (00001110 11111111 for FDL ANSI and 00010010 11111111 for FDL
Bellcore) to the remote end requesting that it enter into a network line loopback.
Specify the ansi keyword to enable the remote line Facility Data Link (FDL) ANSI
bit loopback on the T1 channel, per the ANSI T1.403 specification. Specify the
bellcore keyword to enable the remote SmartJack loopback on the T1 channel, per
the TR-TSY-000312 specification.
remote line inband (Optional) Sends a repeating, 5-bit inband pattern (00001) to the remote end
requesting that it enter into a network line loopback.
remote payload [fdl] (Optional) Sends a repeating, 16-bit ESF data link code word (00010100 11111111)
[ansi] to the remote end requesting that it enter into a network payload loopback. Enables
the remote payload FDL ANSI bit loopback on the T1 channel.
You can optionally specify fdl and ansi, but it is not necessary.
Command Default No loopback is configured.
Command Modes Interface configuration
Command History Release Modification
11.1 CA This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use this command for troubleshooting purposes.
Cisco IOS Interface and Hardware Component Command Reference
677
loopback T1 interface through nrzi-encoding
loopback (T1 interface)
To better diagnose T1 provisioning problems, you can place the remote CSU or remote SmartJack into
loopback. The loopbackremotelinefdl interface configuration command allows you to place either the CSU
or the SmartJack into loopback:
• ansi --Places the CSU into loopback, per the ANSI T1.403 Specification.
• bellcore --Places the SmartJack into loopback, per the TR-TSY-000312 Specification.
When both are configured, transmission of loss of frame (LOF) indication (yellow alarm) takes priority over
transmission of some facilities data link (FDL) messages.
If the remote loopback appears not to be working, use the show controllers t3 command to determine if the
given T1 is currently attempting to transmit a LOF indication (yellow alarm):
Router#
show controllers t3 0/0/0:2
T3 0/0/0 is up.
CT3 H/W Version: 5, CT3 ROM Version: 1.2, CT3 F/W Version: 2.5.9
Mx H/W version: 2, Mx ucode ver: 1.34
T1 2 is down, speed: 1536 kbs, non-inverted data
timeslots: 1-24
FDL per AT&T 54016 spec.
Transmitter is sending LOF Indication.
Receiver is getting AIS.
If the transmitter is sending a LOF indication, as in the previous example, stop the transmission of the LOF
indication (yellow alarm) with the no t1 yellow generation configuration command as shown in the following
example:
Router(config)# controllers t3 0/0/0
Router(config-controller)# no t1 2 yellow generation
Router(config-controller)# Ctrl-D
To verify that the transmission of the LOF indication (yellow alarm) has stopped, use the show controllers t3
command:
Router# show controllers t3 0/0/0:2
T3 0/0/0 is up.
CT3 H/W Version: 5, CT3 ROM Version: 1.2, CT3 F/W Version: 2.5.9
Mx H/W version: 2, Mx ucode ver: 1.34
T1 2 is down, speed: 1536 kbs, non-inverted data
timeslots: 1-24
FDL per AT&T 54016 spec.
Receiver is getting AIS.
Framing is ESF, Line Code is B8ZS, Clock Source is Internal.
Yellow Alarm Generation is disabled
Then retry the remote loopback command. When diagnosis is complete, remember to reenable the LOF
indication (yellow alarm).
You can also loopback all the T1 channels by using theloopback(CT3IP) interface configuration command.
Examples The following example configures T1 channel 5 for a local loopback:
Router(config)# interface serial 3/0/0:5
Router(config-if)# loopback local
Cisco IOS Interface and Hardware Component Command Reference
678
loopback T1 interface through nrzi-encoding
loopback (T1 interface)
Related Commands Command Description
loopback (T3 controller) Loops the entire T3 (all 28 T1 channels) on the CT3IP in Cisco 7500 series
routers.
t1 yellow generation Enables detection and generation of yellow alarms for a T1 channel on the
CT3IP in Cisco 7500 series routers.
Cisco IOS Interface and Hardware Component Command Reference
679
loopback T1 interface through nrzi-encoding
loopback (T3/E3 controller)
loopback (T3/E3 controller)
To loop the entire T3 (all 28 T1 channels) line on the T3 controller or E3 (all 16 E1 channels) in Cisco NCS
4200 Series or on the CT3IP in Cisco 7500 series routers, use the loopback command in controller configuration
mode. To remove the loop, use the no form of this command.
loopback {local|network {line|payload}|remote}
no loopback
Syntax Description local Loops the data back toward the router and sends an alarm indication signal (AIS)
out toward the network.
network line Sets the loopback toward the network either before going through the framer (line)
payload or after going through the framer (payload).
remote Sends a far-end alarm control (FEAC) request to the remote end requesting that it
enter into a network line loopback. FEAC requests (and therefore remote loopbacks)
are possible only when the T3 is configured for C-bit framing. The M23 format
does not support remote loopbacks.
Command Default No loops are configured on the T3/E3 line.
Command Modes Controller configuration
Command History Release Modification
11.3 This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and implemented on
the following platforms for T3: Cisco 2650XM, Cisco 2651XM, Cisco 2691, Cisco 3660
series, Cisco 3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
XE 3.18SP This command was integrated into Cisco NCS 4200 Series.
XE Everest This command was integrated into Cisco NCS 4200 Series and Cisco ASR 900 Series
16.5.1 Routers.
Usage Guidelines Use this command for troubleshooting purposes. To verify that a loopback is configured on the interface, use
the showcontrollersT3/E3EXEC command. Note that remote loopback is available only in C-bit parity mode.
You can also loopback each T1/E1 channel by using theloopback interface configuration command for T1/E1.
For more information, refer to the “Troubleshooting the T3 and T1 Channels” section in the “Configuring
Serial Interfaces” chapter of the CiscoIOSInterfaceandHardwareComponentConfigurationGuide.
Cisco IOS Interface and Hardware Component Command Reference
680
loopback T1 interface through nrzi-encoding
loopback (T3/E3 controller)
Examples The following example configures the T3/E3 or CT3IP for a local loopback:
Router(config)# controller t3/e3 3/0/0
Router(config-controller)# loopback local
Related Commands Command Description
framing Selects the frame type for the T1 or E1 data line.
loopback (interface) Places the specified module in loopback mode.
loopback remote (interface) Loops packets through a CSU/DSU, over a DS3 link or a channelized T1
link, to the remote CSU/DSU and back.
show controllers t3/e3 Displays information about the T3/E3 controllers.
Cisco IOS Interface and Hardware Component Command Reference
681
loopback T1 interface through nrzi-encoding
loopback (T3-E3 interface)
loopback (T3-E3 interface)
To loopback at various points in the transmit and receive path, use the loopbackcommand in interface
configuration mode. To stop the loopback, use the no form of this command.
PA-T3 Port Adapter
loopback {dte|local|network {line|payload}|remote}
no loopback
PA-E3 Port Adapter
loopback {dte|local|network {line|payload}}
no loopback
T3/E3 Shared Port Adapters
loopback {dte|local|dual|network {line|payload}|remote}
no loopback {dte|local|dual|network {line|payload}|remote}
Syntax Description dte Loopback after the line interface unit (LIU) towards the terminal.
local Loopback after going through the framer toward the terminal.
dual Sets both local loopback and network line loopback. The dual keyword is not
supported on Cisco 7304 routers with the 2-Port and 4-Port Channelized T3
SPA.
network line | payload Sets the loopback toward the network before going through the framer (line)
or after going through the framer (payload).
remote Sends FEAC to set remote in loopback.
Command Default No loopback by default.
Command Modes Interface configuration
Command History Release Modification
11.1 This command was introduced.
11.3 This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and implemented on the
following platforms for E3: Cisco 2650XM, Cisco 2651XM, Cisco 2691, Cisco 3660 series,
Cisco 3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
12.2S This command was integrated into Cisco IOS Release 12.2S.
12.2(25)S3 This command was integrated into Cisco IOS Release 12.2(25)S3 to support SPAs on the
Cisco 7304 routers.
Cisco IOS Interface and Hardware Component Command Reference
682
loopback T1 interface through nrzi-encoding
loopback (T3-E3 interface)
Release Modification
12.2(18)SXE This command was integrated into Cisco IOS Release 12.2(18)SXE to support SPAs on the
Cisco 7600 series routers and Catalyst 6500 series switches. The dual keyword was added.
12.0(31)S This command was integrated into Cisco IOS Release 12.0(31)S to support SPAs on Cisco
12000 series routers.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines Use the loopback command to diagnose problems on the local port, between the framer and the line interface
unit (LIU) level.
To verify that a loopback is configured on the interface, use the showinterfacesserial or
showinterfacesloopback command.
The dual keyword is not supported on Cisco 7304 routers with the 2-Port and 4-Port Channelized T3 SPA.
Examples The following example configures the serial interface located in slot 3/0/0 for a local loopback:
Router(config)# interface serial 3/0/0
Router(config-if)# loopback local
The following example creates a loopback on slot 5, bay 0 after the LIU towards the terminal.
Router# configure terminal
Router(config)# interface serial 5/0/0
Router(config-if)# loopback dte
Related Commands Command Description
show controllers serial Displays information that is specific to the interface hardware.
show interfaces loopback Displays information about the loopback interface.
show interfaces serial Displays information about a serial interface.
Cisco IOS Interface and Hardware Component Command Reference
683
loopback T1 interface through nrzi-encoding
loopback applique
loopback applique
To configure an internal loop on the High-Speed Serial Interface (HSSI) applique, use the loopbackapplique
command in interface configuration mode. To remove the loop, use the no form of this command.
loopback applique commandloopback applique
no loopback applique
Syntax Description This command has no arguments or keywords.
Command Default No loops are configured on the HSSI applique.
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
Usage Guidelines This command loops the packets within the applique to provide a way to test communication within the router
or access server. It is useful for sending pings to yourself to check functionality of the applique.
To show a specific interface that is currently in loopback operation, use the showinterfacesloopback EXEC
command.
Examples The following example configures the loopback test on the HSSI applique:
Router(config)# interface serial 1
Router(config-if)# loopback applique
Related Commands Command Description
show interfaces loopback Displays information about the loopback interface.
Cisco IOS Interface and Hardware Component Command Reference
684
loopback T1 interface through nrzi-encoding
loopback dte
loopback dte
To loop packets back to the DTE from the CSU/DSU, when the device supports this function, use the
loopbackdtecommand in interface configuration mode. To remove the loop, use the no form of this command.
loopback dte commandloopback dte
no loopback dte
Syntax Description This command has no arguments or keywords.
Command Default No loops are configured.
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command is useful for testing the DTE-to-DCE cable.
This command is used to test the performance of the integrated CSU/DSU. Packets are looped from within
the CSU/DSU back to the serial interface of the router. Send a test ping to see if the packets successfully
looped back. To cancel the loopback test, use the noloopbackdte command.
When using the 4-wire 56/64-kbps CSU/DSU module, an out-of-service signal is transmitted to the remote
CSU/DSU.
To show a specific interface that is currently in loopback operation, use theshowinterfacesloopback EXEC
command.
Examples The following example configures the loopback test on the DTE interface:
Router(config)# interface serial 0
Router(config-if)# loopback dte
Related Commands Command Description
show interfaces loopback Displays information about the loopback interface.
Cisco IOS Interface and Hardware Component Command Reference
685
loopback T1 interface through nrzi-encoding
loopback line
loopback line
To loop packets completely through the CSU/DSU to configure the CSU loop, use the loopbackline command
in interface configuration mode. To remove the loop, use the no form of this command.
loopback line [payload]
no loopback line [payload]
Syntax Description payload (Optional) Configures a loopback point at the DSU and loops data back to the network on an
integrated CSU/DSU.
Command Default No loops are configured.
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command is useful for testing the DCE device ( CSU/DSU) itself. When the loopbackline command is
configured on the 2-wire 56-kbps CSU/DSU module or the 4-wire 56/64-kbps CSU/DSU modules, the network
data loops back at the CSU and the router data loops back at the DSU. If the CSU/DSU is configured for
switched mode, you must have an established connection to perform a payload-line loopback. To loop the
received data through the minimum amount of CSU/DSU circuitry, issue the loopbackline command.
When you issue the loopbacklinepayload command on an integrated CSU/DSU module, the router cannot
transmit data through the serial interface for the duration of the loopback. Choosing the DSU as a loopback
point loops the received-network data through the maximum amount of CSU/DSU circuitry. Data is not looped
back to the serial interface. An active connection is required when operating in switched mode for payload
loopbacks.
If you enable the loopbackline command on the fractional T1/T1 module, the CSU/DSU performs a
full-bandwidth loopback through the CSU portion of the module and data transmission through the serial
interface is interrupted for the duration of the loopback. No reframing or corrections of bipolar violation errors
or cyclic redundancy check (CRC) errors are performed. When you configure the
loopbacklinepayloadcommand on the FT1/T1 module, the CSU/DSU performs a loopback through the DSU
portion of the module. The loopbacklinepayloadcommand reframes the data link, regenerates the signal, and
corrects bipolar violations and Extended Super Frame CRC errors.
When performing a T1-line loopback with Extended Super Frame, communication over the facilities data link
is interrupted, but performance statistics are still updated. To show interfaces currently in loopback operation,
use the showservice-moduleEXEC command.
To show interfaces that are currently in loopback operation on other routers, use the showinterfacesloopback
EXEC command.
Cisco IOS Interface and Hardware Component Command Reference
686
loopback T1 interface through nrzi-encoding
loopback line
Examples The following example configures the loopback test on the DCE device:
Router(config)# interface serial 1
Router(config-if)# loopback line
The following example shows how to configure a payload loopback on a Cisco 2524 or Cisco 2525
router:
Router1(config-if)# loopback line payload
Loopback in progress
Router1(config-if)# no loopback line
The following example shows the output on a Cisco 2524 or Cisco 2525 router when you loop a
packet in switched mode without an active connection:
Router1(config-if)# service-module 56k network-type switched
Router1(config-if)# loopback line payload
Need active connection for this type of loopback
% Service module configuration command failed: WRONG FORMAT.
Related Commands Command Description
show interfaces loopback Displays information about the loopback interface.
show service-module Displays the performance report for an integrated CSU/DSU.
Cisco IOS Interface and Hardware Component Command Reference
687
loopback T1 interface through nrzi-encoding
loopback remote (interface)
loopback remote (interface)
To loop packets through a CSU/DSU, over a DS3 link or a channelized T1 link, to the remote CSU/DSU and
back, use the loopbackremotecommand in interface configuration mode. To remove the loopback, use the
no form of this command.
FT1/T1 CSU/DSU Modules
loopback remote {full|payload|smart-jack} [{0in1|1in1|1in2|1in5|1in8|3in24|qrw|user-pattern
24-bit-binary-value}]
no loopback remote {full|payload|smart-jack}
2- and 4-Wire, 56/64-kbps CSU/DSU Modules
loopback remote [{2047|511|stress-pattern pattern-number}]
no loopback remote
Syntax Description full Transmits a full-bandwidth line loopback request to a remote device, which is used
for testing.
payload Transmits a payload line loopback request to a remote device, which is used for
testing the line and remote DSU.
smart-jack Transmits a loopback request to the remote smart jack, which some service providers
attach on the line before the customer premises equipment (CPE). You cannot put
the local smart jack into loopback.
0in1 (Optional) Transmits an all-zeros test pattern used for verifying B8ZS line encoding.
The remote end might report a loss of signal when using alternate mark inversion
(AMI) line coding.
1in1 (Optional) Transmits an all-ones test pattern used for signal power measurements.
1in2 (Optional) Transmits an alternating ones-and-zeroes test pattern used for testing
bridge taps.
1in5 (Optional) Transmits the industry-standard test-pattern loopback request.
1in8 (Optional) Transmits a test pattern used for stressing timing recovery of repeaters.
3in24 (Optional) Transmits a test pattern used for testing the ones density tolerance on
AMI lines.
qrw (Optional) Transmits a quasi-random word test pattern, which is a random signal
that simulates user data.
user-pattern (Optional) Transmits a test pattern that you define. Enter a binary string up to 24
24-bit-binary-value bits long. For the fixed patterns such 0in1 and 1in1, the T1 framing bits are jammed
on top of the test pattern; for the user-pattern, the pattern is simply repeated in
the time slots.
2047 (Optional) Transmits a pseudorandom test pattern that repeats after 2047 bits.
511 (Optional) Transmits a pseudo random test pattern that repeats after 511 bits.
Cisco IOS Interface and Hardware Component Command Reference
688
loopback T1 interface through nrzi-encoding
loopback remote (interface)
stress-pattern (Optional) Transmits a DDS stress pattern available only on the 4-wire 56/64-kbps
pattern-number CSU/DSU module. You may enter a stress pattern from 1 to 4. A 1 pattern sends
100 bytes of all 1s and then 100 bytes of all 0s to test the stress clocking of the
network. A 2 pattern sends 100 bytes of a 0x7e pattern and then 100 bytes of all
0s. A 3 pattern sends continuous bytes of a 0x46 pattern. A 4 pattern sends
continuous bytes of a 0x02 pattern.
Command Default No remote loopback interface is configured.
Command Modes Interface configuration
Command History Release Modification
11.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command is used for testing the data communication channels along with or without remote CSU/DSU
circuitry. The loopback is usually performed at the line port, rather than the DTE port, of the remote CSU/DSU.
For a multiport interface processor connected to a network via a channelized T1 link, the loopbackremote
interface configuration command applies if the remote interface is served by a DDS line (56 kbps or 64 kbps)
and if the device at the remote end is a CSU/DSU. In addition, the CSU/DSU at the remote end must react to
latched DDS CSU loopback codes. Destinations that are served by other types of lines or that have CSU/DSUs
that do not react to latched DDS CSU codes cannot participate in an interface remote loopback. Latched DDS
CSU loopback code requirements are described in AT&T specification TR-TSY-000476, “OTGR Network
Maintenance Access and Testing.”
For the integrated FT1/T1 CSU/DSU module, the loopbackremotefull command sends the loopup code to
the remote CSU/DSU. The remote CSU/DSU performs a full-bandwidth loopback through the CSU portion
of the module. Theloopbackremotepayload command sends the loopup code on the configured time slots,
while maintaining the D4-extended super frame. The remote CSU/DSU performs the equivalent of a loopback
line payload request. The remote CSU/DSU loops back only those time slots that are configured on the remote
end. This loopback reframes the data link, regenerates the signal, and corrects bipolar violations and extended
super frame CRC errors. The loopbackremotesmart-jackcommand sends a loopup code to the remote smart
jack. You cannot put the local smart jack into loopback.
Failure to loopup or initiate a remote loopback request could be caused by enabling the
noservice-modulet1remote-loopback command or having an alternate remote-loopback code configured on
the remote end. When the loopback is terminated, the result of the pattern test is displayed.
For the 2- and 4-wire, 56/64-kbps CSU/DSU module, an active connection is required before a loopup can
be initiated while in switched mode. When transmitting V.54 loopbacks, the loopback mode is initiated on
the remote device using V.54 messages. Failure to loopup or initiate a remote loopback request could be
caused by enabling the noservice-module56kremote-loopback command.
To display interfaces that are currently in loopback operation, use the showinterfacesloopback EXEC
command.
Cisco IOS Interface and Hardware Component Command Reference
689
loopback T1 interface through nrzi-encoding
loopback remote (interface)
Examples
Example for Remote Loopback Test
The following example configures a remote loopback test:
Router(config)# interface serial 0
Router(config-if)# loopback remote
Example of Full-Bandwidth Line Loopback
The following example configures the remote device into full-bandwidth line loopback while
specifying the qrw test pattern over the T1 CSU/DSU module on a Cisco 2524 or Cisco 2525 router:
Router(config)# interface serial 0
Router(config-if)# loopback remote full qrw
Router(config-if)#
%LINEPROTO-5-UPDOWN: Line protocol on Interface Serial0, changed state to down
%LINK-3-UPDOWN: Interface Serial0, changed state to down
%SERVICE_MODULE-5-LOOPUPREMOTE: Unit 0 - Remote unit placed in loopback
Example of Loopback Stress Pattern
The following example transmits a remote loopback stress pattern over the 4-wire, 56/64-kbps
CSU/DSU module, which tests the stress clocking of the network:
Router(config-if)# loopback remote stress-pattern 1
Router(config-if)#
%LINEPROTO-5-UPDOWN: Line protocol on Interface Serial1, changed state to down
%LINK-3-UPDOWN: Interface Serial1, changed state to down
%SERVICE_MODULE-5-LOOPUPREMOTE: Unit 1 - Remote unit placed in loopback
Related Commands Command Description
clear service-module serial Resets an integrated CSU/DSU.
loopback dte Loops packets back to the DTE device from the CSU/DSU.
loopback line Loops packets completely through the CSU/DSU to configure the
CSU loop.
service-module 56k remote-loopback Enables the acceptance of a remote loopback request on a serial
interface on a 2- or 4-wire, 56/64-kbps CSU/DSU module.
service-module t1 remote-loopback Specifies whether the fractional T1/T1 CSU/DSU module enters
loopback mode when it receives a loopback code on the line.
show interfaces loopback Displays information about the loopback interface.
show service-module serial Displays the performance report for an integrated CSU/DSU.
Cisco IOS Interface and Hardware Component Command Reference
690
loopback T1 interface through nrzi-encoding
loopback remote (T1/T3/SDH/SONET Controller)
loopback remote (T1/T3/SDH/SONET Controller)
To put the far-end T1 or T3 interfaces into a loopback use the loopback remote command in the global
configuration mode.The remote loopback setting loops back the far-end at line or payload, using inband
bit-orientated CDE (IBOC) or the extended super frame (ESF) loopback codes to communicate the request
to the far-end.
T1 Controller
loopback remote {esf | {line {csu} | payload} iboc {fac1 | fac2 | csu}}
T3 Controller
loopback remote {line | payload}
Syntax Description esf line csu Remote line CSU loopback through FDL. This is the default option.
esf payload Remote payload loopback through FDL.
iboc fac1 Remote inband line facility1 loopback.
iboc fac2 Remote inband line facility2 loopback.
iboc csu Remote inband line CSU loopback.
Command Default Loopback remote is disabled.
Command Modes Global configuration mode
Command History Release Modification
IOS XE Fuji Release 16.8.1 This command was introduced.
Usage Guidelines Loopback testing is one of the troubleshooting methods which is an effective way to isolate the failing links.
When the loopback is configured, all the data sent is received back. If the same data is not received then it is
declared as link failure. In the similar way, remote loopback is configured to troubleshoot the link failure
between two nodes.
Examples The following example shows how to set T1 loopback remote iboc fac1 for DS1:
Router(config)# controller t1 0/0/1
Router(config-controller)#loopback remote iboc fac1
exit
The following example shows how to set T3 loopback remote line for DS3:
Router(config)# controller t3 0/0/1
Router(config-controller)#loopback remote line
exit
Cisco IOS Interface and Hardware Component Command Reference
691
loopback T1 interface through nrzi-encoding
loopback remote (T1/T3/SDH/SONET Controller)
The following example shows how to set T3 loopback remote payload for OCX in sonet:
Router(config)# controller sonet 0/0/1
Router(config-controller)#sts 1
Router(config-ctrlr-sts1)#mode t3
Router(config-ctrlr-sts1)#t3 loopback remote payload
The following example shows how to set T1 loopback remote esf line csu for OCX in SDH:
Router(config)#controller sdh 0/4/7
Router(config-controller)#au-4 1
Router(config-ctrlr-tug3)#tug-3 3
Router(config-ctrlr-tug3)#mode vc1x
Router(config-ctrlr-tug3)#tug-2 1 payload vc11
Router(config-ctrlr-tug2-vcx)#t1 1 loopback remote esf line csu
Related Commands Commands URL
card type http://www.cisco.com/c/en/us/td/docs/ios-xml/ios/
interface/command/ir-cr-book/
ir-c1.html#wp2336574570
cem-group http://www.cisco.com/c/en/us/td/docs/ios-xml/ios/
interface/command/ir-cr-book/
ir-c1.html#wp2440628600
payload-size dejitter-buffer https://www.cisco.com/c/en/us/td/docs/ios-xml/ios/
interface/command/ir-cr-book/
ir-o1.html#wp3946673156
class cem https://www.cisco.com/c/en/us/td/docs/ios-xml/ios/
interface/command/ir-cr-book/
ir-c1.html#wp2169323859
controller t1/e1 https://www.cisco.com/c/en/us/td/docs/ios-xml/ios/
interface/command/ir-cr-book/
ir-c2.html#wp1472647421
xconnect http://www.cisco.com/c/en/us/td/docs/ios-xml/ios/
interface/command/ir-cr-book/
ir-t2.html#wp8578094790
linecode http://www.cisco.com/c/en/us/td/docs/ios-xml/ios/
interface/command/ir-cr-book/
ir-l1.html#wp2312535965
framing http://www.cisco.com/c/en/us/td/docs/ios-xml/ios/
interface/command/ir-cr-book/
ir-f1.html#wp2853515177
clock source http://www.cisco.com/c/en/us/td/docs/ios-xml/ios/
interface/command/ir-cr-book/
ir-c2.html#wp6081785140
Cisco IOS Interface and Hardware Component Command Reference
692
loopback T1 interface through nrzi-encoding
loopback remote (T1/T3/SDH/SONET Controller)
Commands URL
cable length http://www.cisco.com/c/en/us/td/docs/ios-xml/ios/
interface/command/ir-cr-book/
ir-c1.html#wp2492964151
bert pattern http://www.cisco.com/c/en/us/td/docs/ios-xml/ios/
interface/command/ir-cr-book/
ir-a1.html#wp3620978929
channelized http://www.cisco.com/c/en/us/td/docs/ios-xml/ios/
interface/command/ir-cr-book/
ir-c1.html#wp7026926390
loopback http://www.cisco.com/c/en/us/td/docs/ios-xml/ios/
interface/command/ir-cr-book/
ir-l1.html#wp1033903426
show controller t1 http://www.cisco.com/c/en/us/td/docs/ios-xml/ios/
interface/command/ir-cr-book/
ir-s3.html#wp2149471094
show controller e1 http://www.cisco.com/c/en/us/td/docs/ios-xml/ios/
interface/command/ir-cr-book/
ir-s2.html#wp1632676058
Cisco IOS Interface and Hardware Component Command Reference
693
loopback T1 interface through nrzi-encoding
loopback (SONET)
loopback (SONET)
To set the loopback method for testing an interface, use the loopback command in the controller configuration
mode. To reset to the default, use the no form of this command.
loopback [local | network {line | payload}]
Syntax Description local The name of a CEM interface parameters class.
network {line | payload Sets the loopback toward the network before going through the framer (line) or
after going through the framer (payload).
Command Default No loopback is configured.
Command Modes Controller configuration
Command History Release Modification
3.18 SP Support for this command was introduced on NCS 4200 Series.
Usage Guidelines You can use a loopback test on lines to detect and distinguish equipment malfunctions caused by the line. If
correct data transmission is not possible when an interface is in loopback mode, the interface is the source of
the problem.
Examples The following example shows the configuration of VT 1.5-T1 loopback :
enable
configure terminal
controller MediaType 0/5/0
mode sonet
controller sonet 0/5/0
loopback local
sts-1 1
mode ct3
vtg 1 t1 1 loopback line
end
Related Commands Command Description
controller sonet Configures the SONET mode.
show controller sonet Displays SONET controller configuration.
Cisco IOS Interface and Hardware Component Command Reference
694
loopback T1 interface through nrzi-encoding
mac-address-table learning
mac-address-table learning
To enable MAC-address learning, use the mac-address-tablelearningcommand in global configuration mode.
To disable learning, use the no form of this command.
mac-address-table learning{vlanvlan-id|interfaceinterface slot/port}{module[module
num]}
no mac-address-table learning{vlanvlan-id|interfaceinterface slot/port}{module[module
num]}
Syntax Description default (Optional) Returns to the default settings.
vlan vlan-id Specifies the VLAN to apply the per-VLAN learning of all MAC addresses; valid
values are from 1 to 4094.
interface Specifies per-interface based learning of all MAC addresses.
interface slot / port Interface type, the slot number, and the port number.
module num (Optional) Specifies the module number.
Command Default If you configure a VLAN on a port in a module, all the supervisor engines and Distributed Forwarding Cards
(DFCs) in the Cisco 7600 series router are enabled to learn all the MAC addresses on the specified VLAN.
Command Modes Global configuration (config)
Command History Release Modification
12.2(18)SXE Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines You can use the modulenum keyword and argument to specify supervisor engines or DFCs only.
You can use the vlanvlan-id keyword and argument on switch-port VLANs only. You cannot use the
vlanvlan-id keyword and argument to configure learning on routed interfaces.
You can use the interfaceinterfaceslot/port keyword and arguments on routed interfaces, supervisor engines,
and DFCs only. You cannot use the interfaceinterfaceslot/port keyword and arguments to configure learning
on switch-port interfaces or non-DFC modules.
Examples This example shows how to enable MAC-address learning on a switch-port interface on all modules:
Router(config)# mac-address-table learning vlan 100
Router(config)#
This example shows how to enable MAC-address learning on a switch-port interface on a specified
module:
Cisco IOS Interface and Hardware Component Command Reference
695
loopback T1 interface through nrzi-encoding
mac-address-table learning
Router(config)# mac-address-table learning vlan 100 module 4
Router(config)#
This example shows how to disable MAC-address learning on a specified switch-port interface for
all modules:
Router(config)# no mac-address-table learning vlan 100
Router(config)#
This example shows how to enable MAC-address learning on a routed interface on all modules:
Router(config)# mac-address-table learning vlan 100
Router(config)#
This example shows how to enable MAC-address learning on a routed interface for a specific module:
Router(config)# mac-address-table learning interface FastEthernet 3/48 module 4
Router(config)#
This example shows how to disable MAC-address learning for all modules on a specific routed
interface:
Router(config)# no mac-address-table learning interface FastEthernet 3/48
Router(config)#
Related Commands Command Description
show mac-address-table learning Displays the MAC-address learning state.
Cisco IOS Interface and Hardware Component Command Reference
696
loopback T1 interface through nrzi-encoding
mac-address (virtual switch)
mac-address (virtual switch)
To specify a Media Access Control (MAC) address to use as the common router MAC address for interfaces
on the active and standby chassis, use the mac-address virtual switch configuration submode command. To
return to the default setting, use the no form of this command.
mac-address {mac-address|use-virtual}
Syntax Description mac-address MAC address in hexadecimal format.
use-virtual Specifies the MAC address range reserved for the virtual switch system (VSS).
Command Default The router MAC address is derived from the backplane of the active chassis.
Command Modes Virtual switch configuration submode (config-vs-domain)
Command History Release Modification
12.2(33)SXH2 Support for this command was introduced.
Usage Guidelines When a virtual switch comes up, the router MAC address is derived from the backplane of the active chassis
and is used as the common router MAC address for interfaces on both the active and the standby chassis.
Between switchovers, this MAC address is maintained on the new active switch. You can enter the
mac-addressmac-addresscommand to specify a MAC address to use or the mac-addressuse-virtual to use
the MAC address range reserved for the VSS.
The MAC address range reserved for the VSS is derived from a reserved pool of addresses with the domain
ID encoded in the leading 6 bits of the last octet and trailing 2 bits of the previous octet of the mac-address.
The last two bits of the first octet is allocated for protocol mac-address which is derived by adding the protocol
ID (0 to 3) to the router MAC address.
Note You must reload the virtual switch for the new router MAC address to take effect. If the MAC address you
configured is different from the current MAC address, the following message is displayed: Configured Router
mac address is different from operational value. Change will take effect after config is saved and switch is
reloaded.
Examples The following example shows how to specify the MAC address to use in hexadecimal format:
Router(config)# switch virtual domain test-mac-address
Router(config-vs-domain)# mac-address 0000.0000.0000
Router(config-vs-domain)#
The following example shows how to specify the MAC address range reserved for the VSS:
Router(config)# switch virtual domain test-mac-address
Router(config-vs-domain)# mac-address use-virtual
Router(config-vs-domain)#
Cisco IOS Interface and Hardware Component Command Reference
697
loopback T1 interface through nrzi-encoding
mac-address (virtual switch)
Related Commands Command Description
switch virtual domain Assigns a switch number and enters virtual switch domain configuration submode.
Cisco IOS Interface and Hardware Component Command Reference
698
loopback T1 interface through nrzi-encoding
mac-address-table secure
mac-address-table secure
To add secure addresses to the MAC address table, use the mac-address-tablesecure command in global
configuration mode. To remove secure entries from the MAC address table, use the no form of this command.
Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers
no mac-address-table secure hw-address vlan vlan-id
Catalyst Switches
mac-address-table secure hw-address [atm slot/portvlan vlan-id]
no mac-address-table secure hw-address [vlan vlan-id]
Cisco 860 Series Integrated Services Routers (ISRs) and Cisco 880 Series ISRs
mac-address-table secure [{H.H.H|maximum maximum addresses}]
no mac-address-table secure [{H.H.H|maximum maximum addresses}]
Syntax Description hw -address MAC address that is added to the table.
interface Port to which packets destined for hw-address are forwarded.
fa Specifies FastEthernet.
gi Specifies Gigabit Ethernet.
H.H.H (Optional) Specifies 48-bit hardware address.
slot (Optional) The slot (slot 1 or slot 2) to which to add dynamic addresses.
port (Optional) Port interface number. The ranges are based on type of Ethernet switch
network module used:
• 0 to 15 for NM-16ESW
• 0 to 35 for NM-36ESW
• 0 to 1 for GigabitEthernet
atm slot / port (Optional) Add secure addresses to the ATM module in slot 1 or 2. The port is always
0 for an ATM interface.
maximum maximum (Optional) Applies only to Cisco 860 series and Cisco 880 series ISRs. Range is
addresses 1-200.
Cisco IOS Interface and Hardware Component Command Reference
699
loopback T1 interface through nrzi-encoding
mac-address-table secure
vlan vlan -id Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers
The interface and vlan parameters together specify a destination to which packets
destined for hw-address are forwarded.
The vlan keyword is optional if the port is a static-access VLAN port. In this case,
the VLAN assigned to the port is assumed to be that of the port associated with the
MAC address. This keyword is required for multi-VLAN and trunk ports.
The value of vlan-id is the ID of the VLAN to which secure entries are added. Valid
IDs are 1 to 1005; do not enter leading zeroes.
Catalyst Switches
(Optional) The interface and vlan parameters together specify a destination to which
packets destined for hw-address are forwarded.
The vlan keyword is optional if the port is a static-access VLAN port. In this case,
the VLAN assigned to the port is assumed to be that of the port associated with the
MAC address. This keyword is required for multi-VLAN and trunk ports.
The value of vlan-id is the ID of the VLAN to which secure entries are added. Valid
IDs are 1 to 1005; do not enter leading zeroes.
Command Default Secure addresses are not added to the MAC address table.
Command Modes
Global configuration (config)
Command History Release Modification
11.2(8)SA This command was introduced.
11.2(8)SA3 The vlan keyword was added.
11.2(8)SA5 The atm keyword was added.
12.2(2)XT This command was implemented on Cisco 2600 series, Cisco 3600 series, and Cisco 3700
series routers.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T, on Cisco 2600 series, Cisco
3600 series, and Cisco 3700 series routers.
12.2(11)T This command was integrated into Cisco IOS Release 12.2(11)T.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
12.4(20)T This command with the H.H.H and maximum keyword was added for Cisco Series 860 ISRs
and Cisco Series 880 ISRs.
Usage Guidelines Cisco 860 Series ISRs, Cisco 880 Series ISRs, Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series
Routers
Cisco IOS Interface and Hardware Component Command Reference
700
loopback T1 interface through nrzi-encoding
mac-address-table secure
Secure addresses can be assigned to only one port at a time. Therefore, if a secure address table entry for the
specified MAC address and VLAN already exists on another port, it is removed from that port and assigned
to the specified one.
If the maximum number is more than the MAC addresses statically specified by using the H.H.H keyword,
the switch learns the MAC address automatically up to the specified maximum. If the maximum number is
less than the number of MAC addresses already specified statically, then an error message displays.
Usage Guidelines Catalyst Switches
Secure addresses can be assigned to only one port at a time. Therefore, if a secure address table entry for the
specified MAC address and VLAN already exists on another port, it is removed from that port and assigned
to the specified one.
Dynamic-access ports cannot be configured with secure addresses.
Cisco 860 Series ISRs, Cisco 880 Series ISRs
The following example shows how to allow ten devices on Fast Ethernet port 2:
Router(config)#
mac-address-table secure maximum 10 ?
FastEthernet FastEthernet IEEE 802.3
Router(config)#
mac-address-table secure maximum 10 f ?
<0-4> FastEthernet interface number
Router(config)#
mac-address-table secure maximum 10 f 2
Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers
The following example shows how to add a secure MAC address to VLAN 6 of port fa1/1:
Router(config)# mac-address-table secure 00c0.00a0.03fa fa1/1 vlan 6
Catalyst Switches
The following example shows how to add a secure MAC address to VLAN 6 of port fa1/1:
Switch(config)# mac-address-table secure 00c0.00a0.03fa fa1/1 vlan 6
The following example shows how to add a secure MAC address to ATM port 2/1:
Switch(config)# mac-address-table secure 00c0.00a0.03fa atm 2/1
Related Commands Command Description
clear mac -address-table Deletes entries from the MAC address table.
mac -address-tableaging-time Sets the length of time that a dynamic entry remains in the MAC address
table after the entry is used or updated.
mac -address-tabledynamic Adds dynamic addresses to the MAC address table.
Cisco IOS Interface and Hardware Component Command Reference
701
loopback T1 interface through nrzi-encoding
mac-address-table secure
Command Description
mac -address-tablestatic Adds static addresses to the MAC address table.
show mac -address-table Displays the MAC address table.
Cisco IOS Interface and Hardware Component Command Reference
702
loopback T1 interface through nrzi-encoding
main-fiber port
main-fiber port
To specify the port number to use for the optical link connection on the SDH/STM-1 trunk card on a Cisco
AS5850, use the main-fiberport command in controller configuration mode.
main-fiber port {0|1}
Syntax Description 0 Specifies use of port 0 as the optical link connection. This is the default.
1 Specifies use of port 1 as the optical link connection.
Command Default Port 0
Command Modes Controller configuration
Command History Release Modification
12.2(15)T This command was introduced.
Usage Guidelines Use themain-fiber controller configuration command if you need to use optical port 1 during installation of
the SDH/STM-1 trunk card on a Cisco AS5850 or if you suspect some problem with optical port 0.
This command does not have a no form. To restore the default value, use the main-fiberport0command.
Examples The following example selects port 1 as the port with the optical connection:
Router(config)# controller sonet 1/0
Router(config-controller)# main-fiber port 1
Cisco IOS Interface and Hardware Component Command Reference
703
loopback T1 interface through nrzi-encoding
max-reserved-bandwidth
max-reserved-bandwidth
To change the percent of interface bandwidth allocated for Resource Reservation Protocol (RSVP), class-based
weighted fair queueing (CBWFQ), low latency queueing (LLQ), IP RTP Priority, Frame Relay IP RTP Priority,
and Frame Relay PVC Interface Priority Queueing (PIPQ), use the max-reservedbandwidth command in
interface configuration mode. To restore the default value, use the no form of this command.
max-reserved-bandwidth percent
no max-reserved-bandwidth
Syntax Description percent Percent of interface bandwidth allocated for RSVP, CBWFQ, LLQ, IP RTP Priority, Frame Relay
IP RTP Priority, and Frame Relay PIPQ.
Command Default 75 percent on all supported platforms except the Cisco 7500 series routers, which do not have this restriction.
Command Modes Interface configuration
Command History Release Modification
12.0(5)T This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The sum of all bandwidth allocation on an interface should not exceed 75 percent of the available bandwidth
on an interface. The remaining 25 percent of bandwidth is used for overhead, including Layer 2 overhead,
control traffic, and best-effort traffic.
If you need to allocate more than 75 percent for RSVP, CBWFQ, LLQ, IP RTP Priority, Frame Relay IP RTP
Priority, and Frame Relay PIPQ, you can use the max-reserved-bandwidth command. The percent argument
specifies the maximum percentage of the total interface bandwidth that can be used.
If you do use the max-reserved-bandwidth command, make sure that not too much bandwidth is taken away
from best-effort and control traffic.
Examples In the following example, the policy map called policy1 is configured for three classes with a total
of 8 Mbps configured bandwidth, as shown in the output from the showpolicy-map command:
Router# show policy-map policy1
Policy Map policy1
Weighted Fair Queueing
Class class1
Bandwidth 2500 (kbps) Max Threshold 64 (packets)
Class class2
Bandwidth 2500 (kbps) Max Threshold 64 (packets)
Class class3
Bandwidth 3000 (kbps) Max Threshold 64 (packets)
Cisco IOS Interface and Hardware Component Command Reference
704
loopback T1 interface through nrzi-encoding
max-reserved-bandwidth
When you enter the service-policycommand in an attempt to attach the policy map on a 10-Mbps
Ethernet interface, an error message such as the following is produced:
I/f Ethernet1/1 class class3 requested bandwidth 3000 (kbps) Available only 2500 (kbps)
The error message is produced because the default maximum configurable bandwidth is 75 percent
of the available interface bandwidth, which in this example is 7.5 Mbps. To change the maximum
configurable bandwidth to 80 percent, use the max-reserved-bandwidth command in interface
configuration mode, as follows:
max-reserved-bandwidth 80
service output policy1
end
To verify that the policy map was attached, enter the showpolicy-mapinterface command:
Router# show policy-map interface e1/1
Ethernet1/1 output :policy1
Weighted Fair Queueing
Class class1
Output Queue:Conversation 265
Bandwidth 2500 (kbps) Packets Matched 0 Max Threshold 64 (packets)
(discards/tail drops) 0/0
Class class2
Output Queue:Conversation 266
Bandwidth 2500 (kbps) Packets Matched 0 Max Threshold 64 (packets)
(discards/tail drops) 0/0
Class class3
Output Queue:Conversation 267
Bandwidth 3000 (kbps) Packets Matched 0 Max Threshold 64 (packets)
(discards/tail drops) 0/0
Virtual Template Configuration Example
The following example configures a strict priority queue in a virtual template configuration with
CBWFQ. The max-reserved-bandwidth command changes the maximum bandwidth allocated
between CBWFQ and IP RTP Priority from the default (75 percent) to 80 percent.
multilink virtual-template 1
interface virtual-template 1
ip address 172.16.1.1 255.255.255.0
no ip directed-broadcast
ip rtp priority 16384 16383 25
service-policy output policy1
ppp multilink
ppp multilink fragment-delay 20
ppp multilink interleave
max-reserved-bandwidth 80
end
interface Serial0/1
bandwidth 64
ip address 10.1.1.2 255.255.255.0
no ip directed-broadcast
encapsulation ppp
ppp multilink
end
Cisco IOS Interface and Hardware Component Command Reference
705
loopback T1 interface through nrzi-encoding
max-reserved-bandwidth
Note To make the virtual access interface function properly, do not configure the bandwidth command
on the virtual template. Configure it on the actual interface, as shown in the example.
Related Commands Command Description
bandwidth (policy-map class) Specifies or modifies the bandwidth allocated for a class belonging to a
policy map.
ip rtp priority Reserves a strict priority queue for a set of RTP packet flows belonging
to a range of UDP destination ports.
service-policy Attaches a policy map to an input interface or VC, or an output interface
or VC, to be used as the service policy for that interface or VC.
show policy-map Displays the configuration of all classes comprising the specified service
policy map or all classes for all existing policy maps.
show policy-map interface Displays the configuration of all classes configured for all service policies
on the specified interface or displays the classes for the service policy for
a specific PVC on the interface.
Cisco IOS Interface and Hardware Component Command Reference
706
loopback T1 interface through nrzi-encoding
mdix auto
mdix auto
To enable automatic media-dependent interface with crossover detection, use the mdixauto command in
interface configuration mode. To turn automatic detection off, use the no form of this command.
mdix auto
no mdix auto
Syntax Description This command has no arguments or keywords.
Command Default Enabled
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(17a)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is supported on all 10/100 and 10/100/1000 modules except for the following modules:
• WS-X6248-RJ45
• WS-X6248-TELCO
• WS-X6348-RJ-45
• WS-X6348-RJ-21
• WS-X6148-RJ-45
• WS-X6148-RJ-21
Examples This example shows how to enable automatic media-dependent interface with crossover detection:
Router(config-if)# mdix auto
Router(config-if)
This example shows how to disable automatic media-dependent interface with crossover detection:
Router(config-if) no mdix auto
Router(config-if)
Related Commands Command Description
show interfaces Displays the status and traffic statistics for the interfaces in the chassis.
Cisco IOS Interface and Hardware Component Command Reference
707
loopback T1 interface through nrzi-encoding
mdl
mdl
To configure the Maintenance Data Link (MDL) message defined in the ANSI T1.107a-1990 specification,
use the mdl command in controller configuration mode. To remove the message, use the no form of this
command.
mdl {transmit {path|idle-signal|test-signal}|string {eic|lic|fic|unit|pfi|port|generator} string}
no mdl {transmit {path|idle-signal|test-signal}|string {eic|lic|fic|unit|pfi|port|generator} string}
Syntax Description transmit path Enables transmission of the MDL Path message.
transmit idle-signal Enables transmission of the MDL Idle Signal message.
transmit test-signal Enables transmission of the MDL Test Signal message.
string eic string Specifies the Equipment Identification Code; can be up to 10 characters.
string lic string Specifies the Location Identification Code; can be up to 11 characters.
string fic string Specifies the Frame Identification Code; can be up to 10 characters.
string unit string Specifies the Unit Identification Code; can be up to 6 characters.
string pfi string Specifies the Path Facility Identification Code sent in the MDL Path message;
can be up to 38 characters.
string port string Specifies the Port number string sent in the MDL Idle Signal message; can be
up to 38 characters.
string generator string Specifies the Generator number string sent in the MDL Test Signal message;
can be up to 38 characters.
Command Default No MDL message is configured.
Command Modes Controller configuration
Command History Release Modification
11.3 This command was introduced.
12.1(13)EX This command was introduced on the Cisco 7304 router.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and implemented on the
following platforms: Cisco 2650XM, Cisco 2651XM, Cisco 2691, Cisco 3660 series, Cisco
3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
12.2(18)S This command was introduced on Cisco 7304 routers running Cisco IOS Release 12.2(18)S.
12.2(25)S3 This command was integrated into Cisco IOS Release 12.2(25)S3 to support SPA on the
Cisco 7304 routers.
Cisco IOS Interface and Hardware Component Command Reference
708
loopback T1 interface through nrzi-encoding
mdl
Release Modification
12.2(18)SXE This command was integrated into Cisco IOS Release 12.2(18)SXE to support SPAs on the
Cisco 7600 series routers and Catalyst 6500 series switches.
12.0(31)S This command was integrated into Cisco IOS Release 12.0(31)S to support SPAs on the Cisco
12000 series routers.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines Use the mdl command to send messages in maintenance data link in T3 c-bit framing mode.
Note MDL is supported only when the DS3 framing is C-bit parity.
Examples The following example shows the mdl commands on a T3 controller in slot 1, port 0:
Router(config)# controller t3 1/0
Router(config-controller)# clock source line
Router(config-controller)# mdl string eic ID
Router(config-controller)# mdl string fic Building B
Router(config-controller)# mdl string unit ABC
Router(config-controller)# mdl string pfi Facility Z
Router(config-controller)# mdl string port Port 7
Router(config-controller)# mdl transmit path
Router(config-controller)# mdl transmit idle-signal
Related Commands Command Description
controller Configures a T1, E1, or T3 controller and enters controller configuration mode.
show controllers serial Displays serial line statistics.
show controllers t3 Displays information about T3 controllers.
Cisco IOS Interface and Hardware Component Command Reference
709
loopback T1 interface through nrzi-encoding
media-type
media-type
To specify the physical connection on an interface, use the media-type command in interface configuration
mode. To restore the default value, use the no form of this command.
media-type {aui|10baset|100baset|mii|rj45|gbic}
no media-type {aui|10baset|100baset|mii}
Syntax Description aui Selects an AUI 15-pin physical connection. This is the default on Cisco 4000 series routers.
10baset Selects an R-J45 10BASE-T physical connection.
100baset Specifies an RJ-45 100BASE-T physical connection. This is the default on Cisco 7000 series
and Cisco 7200 series routers.
mii Specifies a media-independent interface.
rj45 Specifies an RJ-45 physical connection. This is the default on Cisco 7304 series routers.
gbic Specifies a Gigabit Interface Converter (GBIC) or small-form factor pluggable (SFP) physical
connection for fiber media.
Command Default An AUI 15-pin physical connection is the default setting on Cisco 4000 series routers. A 100BASE-T physical
connection is the default setting on Cisco 7000 series and Cisco 7200 series routers. An RJ-45 physical
connection is the default setting on Cisco 7304 series routers
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.1E Support for Gigabit Ethernet was added with the gbic keyword.
12.2(14)S This command was integrated into Cisco IOS Release 12.2(14)S.
12.2(20)S2 This command was implemented on the 2-Port 10/100/1000 Gigabit Ethernet SPA on the
Cisco 7304 router.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines To specify the physical connection on an interface, use the following interface configuration:
• Ethernet network interface module configuration on Cisco 4000 series routers
• Fast Ethernet Interface Processor (FEIP) on Cisco 7000 series, 7200 series, and 7500 series routers
• Full-duplex or half-duplex mode on a serial interface
Cisco IOS Interface and Hardware Component Command Reference
710
loopback T1 interface through nrzi-encoding
media-type
Use the media-typeinterface configuration command to modify the default physical media connection type
from rj45 to gbic to configure a Gigabit Ethernet interface to support fiber media using a GBIC or SFP optical
transceiver.
RJ-45 is the only media type supported by the 4-Port 10/100 Fast Ethernet SPA on the Cisco 7304 router, so
the media-typecommand does not apply.
Examples
RJ-45 10BASE-T Example
The following example selects an RJ-45 10BASE-T physical connection on Ethernet interface 1:
Router(config)# interface ethernet 1
Router(config-if)# media-type 10baset
Fast Ethernet on a Cisco 7000 or Cisco 7200 Series Example
The following example specifies a media-independent interface physical connection to Fast Ethernet
slot 0, port 1 on the Cisco 7000 or Cisco 7200 series:
Router(config)# interface fastethernet 0/1
Router(config-if)# media-type mii
Cisco 7500 Series Example
The following example specifies a media-independent interface physical connection to Fast Ethernet
slot 0, port adapter 1, port 1 on the Cisco 7500 series:
Router(config)# interface fastethernet 0/1/1
Router(config-if)# media-type mii
Gigabit Ethernet with SPA on a Cisco 7304 Router Example
The following example configures the second interface (port 1) on a 2-Port 10/100/1000 Gigabit
Ethernet SPA for a fiber SFP, where the SPA is installed in the bottom subslot (1) of the MSC, and
the MSC is installed in slot 2 of the Cisco 7304 router:
Related Commands Command Description
show interfaces gigabitethernet Displays information about the Gigabit Ethernet interfaces.
Cisco IOS Interface and Hardware Component Command Reference
711
loopback T1 interface through nrzi-encoding
media-type auto-failover
media-type auto-failover
To assign primary and secondary failover media on the GE-SFP port enter the media-typeauto-failover
command in interface configuration mode. To automatically detect which media is connected, use the no form
of this command.
media-type {sfp|rj45} auto-failover
no media-type
Syntax Description sfp Designates the SFP port as the primary media.
rj45 Designates the RJ45 port as the primary media
auto-failover Configures the port with the primary media for automatic failover from SFP to RJ45 or
vice-versa when the system goes down, reloads, and is unable to bring up primary media.
Command Default No media-type. The primary media is not configured.
Command Modes Interface configuration (config-if)
Command History Release Modification
15.0 (1) This command was introduced.
M
Examples The following example shows how to configure the primary media as RJ45 and the secondary failover
media as SFP:
Router(config-if)# media-type rj45 auto-failover
The following example shows how to configure the primary media as SFP and the secondary failover
media as RJ45:
Router(config-if)# media-type sfp auto-failover
The following example shows how to configure the router to automatically detect which media is
connected:
Router(config-if)# no media-type
Related Commands Command Description
media-type sfp Specifies an SFP physical connection.
media-type rj45 Specifies an RJ-45 physical connection.
Cisco IOS Interface and Hardware Component Command Reference
712
loopback T1 interface through nrzi-encoding
member subslot
member subslot
To configure the redundancy role of a line card, use the member subslot command in line card redundancy
group mode.
member subslot slot/subslot {primary|secondary}
no member subslot slot/subslot {primary|secondary}
Cisco uBR10012 Universal Broadband Routers
member subslot slot/subslot {
protect [config slot/subslot | rf-power [rf-connector rfconnector-value] {hccp-delta diff-pwr |
hccp-override override-pwr}] | working [rfsw-slot slot-value] | revertive | reverttime value}
no member subslot slot/subslot {
protect [config slot/subslot | rf-power [rf-connector rfconnector-value] {hccp-delta diff-pwr |
hccp-override override-pwr}] | working [rfsw-slot slot-value] | revertive | reverttime value}
Syntax Description slot Chassis line card slot number.
subslot Chassis line card subslot number.
primary | secondary Configures the redundancy role of the line card.
• primary --Active line card.
• secondary --Standby line card.
protect Specifies the protect slot in the line card group.
config slot/subslot (Optional) Specifies the appropriate working interface configuration that is used
for the protect interface when a switchover occurs.
rf-power (Optional) Specifies the RF power output level on an integrated upconverter.
rf-connector (Optional) Specifies the RF connector in the protect line card. The default value
rfconnector-value is all.
hccp-delta diff-pwr When using N+1 Hotstandby Connection-to-Connection Protocol (HCCP)
redundancy, the protect interface adds the diff-pwr value to the current power
value of the working interface when a switchover occurs. This allows the router
to accommodate relative differences between the RF power levels in working
and protect interfaces. The valid value for diff-pwr ranges from –12 to +12 dBmV.
Cisco IOS Interface and Hardware Component Command Reference
713
loopback T1 interface through nrzi-encoding
member subslot
hccp-override When using N+1 HCCP redundancy, the protect interface uses the override power
override-pwr value instead of the power value of the working interface when a switchover
occurs. This allows the router to accommodate absolute differences between the
RF power levels in working and protect interfaces. The valid value for
override-pwr ranges from 45 to 63 dBmV.
Note The official range for acceptable power levels in the DOCSIS
specification is 50 to 61 dBmV. Cisco cable interfaces exceed the
DOCSIS standard, but power levels outside the DOCSIS standards
should be used only in lab and test environments.
working Specifies the working slot in the line card group.
rfsw-slot slot-value (Optional) Specifies the RF switch slot for the working line card.
revertive Specifies the revert operation on the protect card.
reverttime value Specifies the time interval for the revert operation in minutes. If you specify the
time interval as 30 minutes, the protect card switches back to the protect mode
after 30 minutes.
Command Default None
Command Modes Line card redundancy group
Command History Release Modification
12.2(28)SB This command was introduced on the Cisco 10000 series routers.
12.2(28)BC This command was integrated into Cisco IOS Release 12.3(23)BC.
12.2(28)SCA Support for the following keywords was removed in Cisco IOS Release 12.2(33)SCA and
later releases:
• revertive
• reverttime
Note Use the revertive command in line card redundancy group mode to enable the
revert operation on a protect card in Cisco IOS Release 12.2(33)SCA and later
releases.
12.2(28)SCC4 Support for the following keywords was added in Cisco IOS Release 12.2(33)SCC4 for Cisco
uBR10012 routers:
• rf-power
• rf-connector
• hccp-delta
• hccp-override
12.2(28)SCE The config option of the command was made the default. When more than one working line
cards are configured, the config option is automatically applied to the first working card.
Cisco IOS Interface and Hardware Component Command Reference
714
loopback T1 interface through nrzi-encoding
member subslot
Usage Guidelines The primary line card must be the first line card configured and must occupy subslot 1. The secondary line
card must be the second line card configured and must occupy subslot 0. Only one primary line card and one
secondary line card can be configured.
Note Configuration changes to the working line card cause the upstream links on the protect line card to flap. This
is applicable only to Cisco uBR10012 routers.
Examples The following example creates line card group number 1 for one-to-one line card redundancy. It also
specifies the line card in subslot 1 as the primary (active) line card, and the line card in subslot 0 as
the secondary (standby) line card:
Router(config)# redundancy
Router(config-red)# linecard-group 1 y-cable
Router(config-red-lc)# member subslot 2/1 primary
Router(config-red-lc)# member subslot 2/0 secondary
Note The rest of the examples listed here are only applicable to Cisco uBR10012 routers.
The following example shows how to configure a protect interface to add 3 dBmV to the current
working RF power level when a switchover occurs:
Router# configure terminal
Router(config)# redundancy
Router(config-red)# linecard-group 1 cable
Router(config-red-lc)# member subslot 5/1 protect rf-power hccp-delta 3
The following example shows how to configure a protect interface to use an RF power level of 48
dBmV instead of the current working RF power level when a switchover occurs:
Router# configure terminal
Router(config)# redundancy
Router(config-red)# linecard-group 1 cable
Router(config-red-lc)# member subslot 5/1 protect rf-power hccp-override 48
The following example shows how to configure a rf-connector 3 on a protect interface to add 5 dBmV
to the current working RF power level when a switchover occurs:
Router# configure terminal
Router(config)# redundancy
Router(config-red)# linecard-group 1 cable
Router(config-red-lc)# member subslot 5/1 protect rf-power rf-connector 3 hccp-delta 5
Related Commands Command Description
linecard-group Creates a line card group for one-to-one line card redundancy.
Cisco IOS Interface and Hardware Component Command Reference
715
loopback T1 interface through nrzi-encoding
member subslot
Command Description
redundancy Enters redundancy mode.
show redundancy linecard Displays information about a redundant line card or line card group.
Cisco IOS Interface and Hardware Component Command Reference
716
loopback T1 interface through nrzi-encoding
microcode reload controller
microcode reload controller
To reload the firmware and field programmable gate array (FPGA) without reloading the Cisco IOS image,
use the microcode reload controller command in privileged EXEC mode.
microcode reload controller {t1| e1| j1} x/y
Syntax Description t1 T1
e1 E1
j1 J1 controller.
x / y Controller slot and unit numbers. The slash must be typed.
Command Default No microcode reload activity is initiated.
Command Modes
Privileged EXEC
Command History Release Modification
12.1(2)XH This command was introduced on the Cisco 2600 series and Cisco 3600 series.
12.1(3)T This command was integrated into Cisco IOS Release 12.1(3)T.
12.2(8)T The j1 keyword was added.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Loopbacks in the running configuration are restored after this command is entered. If the controller is in a
looped state before this command is issued, the looped condition is dropped. You have to reinitiate the
loopbacks from the remote end by entering the no loopcommand from the controller configuration.
Examples The following example shows how to start the microcode reload activity:
Router# microcode reload controller j1 3/0
TDM-connections and network traffic will be briefly disrupted.
Proceed with reload microcode?[confirm]
Router#
*Mar 3 209.165.200.225: clk_src_link_up_down: Status of this CLK does not matter
*Mar 3 209.165.200.226: clk_src_link_up_down: Status of this CLK does not matter
*Mar 3 209.165.200.227: %CONTROLLER-5-UPDOWN: Controller J1 3/0, changed state to)
*Mar 3 209.165.200.227: clk_src_link_up_down: Status of this CLK does not matter
*Mar 3 209.165.200.228: clk_src_link_up_down: Status of this CLK does not matter
*Mar 3 209.165.200.229: %CONTROLLER-5-UPDOWN: Controller J1 3/0, changed state top
*Mar 3 209.165.200.229: clk_src_link_up_down: Status of this CLK does not matter
*Mar 3 209.165.200.229: clk_src_link_up_down: Status of this CLK does not matter
Cisco IOS Interface and Hardware Component Command Reference
717
loopback T1 interface through nrzi-encoding
mls exclude protocol
mls exclude protocol
To specify the interface protocol to exclude from shortcutting, use the mlsexcludeprotocolcommand in global
configuration mode. To remove a prior entry, use the no form of this command.
mls exclude protocol {both|tcp|udp} port port-number
no mls exclude
Syntax Description both Specifies both UDP and TCP.
tcp Excludes TCP interfaces from shortcutting.
udp Specifies UDP interfaces from shortcutting.
port port-number Specifies the port number; valid values are from 1 to 65535.
Command Default This command has no default settings.
Command Modes Global configuration
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Examples This example shows how to configure MLS to exclude UDP on port 69:
Router(config)#
mls exclude protocol udp port 69
Router(config)#
Related Commands Command Description
show mls ip multicast Displays the MLS IP information.
show mls ipx Displays MLS IPX information.
Cisco IOS Interface and Hardware Component Command Reference
718
loopback T1 interface through nrzi-encoding
mls ip delete-threshold
mls ip delete-threshold
To delete the configured access control list (ACL) thresholds, use the mlsipdelete-threshold comman d in
global configuration mode.
mls ip delete-threshold acl-num
Syntax Description acl-num Reflective ACL number; valid values are from 1 to 10000.
Command Default This command has no default settings.
Command Modes Global configuration
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.
The mlsipdelete-threshold command is active only when you enable the mlsipreflexivendr-entrytcam
command.
Examples This example shows how to delete an ACL threshold:
Router(config)# mls ip delete-threshold 223
Router(config)#
Related Commands Command Description
mls ip install-threshold Installs the configured ACL thresholds.
mls ip reflexive ndr-entry tcam Enables the shortcuts in TCAM for the reflexive TCP/UDP entries when
installed by the NDR.
Cisco IOS Interface and Hardware Component Command Reference
719
loopback T1 interface through nrzi-encoding
mls ip directed-broadcast
mls ip directed-broadcast
To enable the hardware switching of the IP-directed broadcasts, use the mlsipdirected-broadcast command
in interface configuration mode. To return to the default settings, use the no form of this command.
mls ip directed-broadcast {exclude-router|include-router}
no mls ip directed-broadcast
Syntax Description exclude-router Forwards the IP-directed broadcast packet in the hardware to all hosts in the VLAN except
the router.
include-router Forwards the IP-directed broadcast packet in the hardware to all hosts in the VLAN
including the router.
Command Default Disabled
Command Modes Interface configuration
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The exclude-router and include-router keywords both support hardware switching, but exclude-router does
not send a copy of the hardware-switched packets to the router. If you enter the include-router keyword, the
router does not forward the IP-directed broadcast packet again.
In the default mode, IP-directed broadcast packets are not hardware forwarded; they are handled at the process
level by the MSFC. The MSFC decision to forward or not forward the packet is dependent on the
ipdirected-broadcast command configuration.
There is no interaction between the ipdirected-broadcast command and the mlsipdirected-broadcast
command. The ipdirected-broadcast command involves software forwarding, and the
mlsipdirected-broadcast command involves hardware forwarding.
MLS IP-directed broadcast supports a secondary interface address.
Any packets that hit the CPU are not forwarded unless you add the ipdirected-broadcast command to the
same interface.
You can configure the MLS IP-directed broadcasts on a port-channel interface but not on the physical interfaces
on the port-channel interface. If you want to add a physical interface to a port-channel group, the physical
interface cannot have the MLS IP-directed broadcast configuration. You have to first remove the configuration
manually and then add the physical interface to the channel group. If a physical interface is already part of a
channel group, the CLI will not accept the mlsipdirected-broadcast configuration command on that physical
interface.
Cisco IOS Interface and Hardware Component Command Reference
720
loopback T1 interface through nrzi-encoding
mls ip directed-broadcast
Examples This example shows how to forward the IP-directed broadcast packet in the hardware to all hosts in
the VLAN with the exception of the router:
Router(config-if)#
mls ip directed-broadcast exclude-router
Router(config-if)#
This example shows how to forward the IP-directed broadcast packet in the hardware to all hosts in
the VLAN:
Router(config-if)#
mls ip directed-broadcast include-router
Router(config-if)#
Related Commands Command Description
show mls cef adjacency Displays information about the MLS-hardware Layer 3-switching adjacency
node.
Cisco IOS Interface and Hardware Component Command Reference
721
loopback T1 interface through nrzi-encoding
mls ipx
mls ipx
To enable Multilayer Switching (MLS) Internetwork Packet Exchange (IPX) on the interface, use the
mlsipxcommand in interface configuration mode. To disable IPX on the interface, use the no form of this
command.
mls ipx
no mls ipx
Syntax Description This command has no arguments or keywords.
Command Default Multicast is disabled.
Command Modes Interface configuration
Command History Release Modification
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine
720.
Examples This example shows how to enable MLS IPX on an interface:
Router(config-if)#
mls ipx
Router(config-if)#
Related Commands Command Description
mls rp ipx (interface configuration mode) Allows the external systems to enable MLS IPX on the
interface.
show mls ipx Displays MLS IPX information.
Cisco IOS Interface and Hardware Component Command Reference
722
loopback T1 interface through nrzi-encoding
mls verify
mls verify
To enable Layer 3 error checking in the hardware, use the mlsverify command in global configuration mode.
To disable Layer 3 error checking in the hardware, use the no form of this command.
mls verify {ip|ipx} {checksum|length {consistent|minimum}}
no mls verify {ip|ipx} {checksum|length {consistent|minimum}}
Syntax Description ip Specifies the IP-checksum errors.
ipx Specifies the IPX checksum errors.
checksum Enables the checksum-error check.
length consistent Enables the length-consistency check in Layer 2.
length minimum Enables the minimum-length packet check in Layer 2.
consistent Specifies the length-consistency check in Layer 2.
minimum Enables the minimum-length packet check in Layer 2.
Command Default checksum
Command Modes Global configuration
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB This command was changed to include the minimum keyword on the Supervisor Engine
720. Support for this command on the Supervisor Engine 2 was extended to Release
12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The minimum-length packets are the packets with an IP header length or IP total length field that is smaller
than 20 bytes.
When entering the minimum keyword, follow these guidelines:
• When enabling the IP "too short" check using the mls verify ip length minimum command, valid IP
packets with with an IP protocol field of ICMP(1), IGMP(2), IP(4), TCP(6), UDP(17), IPv6(41), GRE(47),
or SIPP-ESP(50) will be hardware switched. All other IP protocol fields are software switched.
Caution Using optimized access-list logging (OAL) and the mls verify ip length minimum command together can
cause routing protocol neighbor flapping as they are incompatible
Cisco IOS Interface and Hardware Component Command Reference
723
loopback T1 interface through nrzi-encoding
mls verify
• When entering the nomlsverifyiplengthminimum command, minimum-length packets are hardware
switched. The packets that have IP protocol = 6 (TCP) are sent to the software.
Examples This example shows how to enable Layer 3 error checking in the hardware:
Router(config
)# mls verify ip checksum
Router(config)#
This example shows how to disable Layer 3 error checking in the hardware:
Router(config
)# no mls verify ip checksum
Router(config)#
Cisco IOS Interface and Hardware Component Command Reference
724
loopback T1 interface through nrzi-encoding
mobility
mobility
To configure the wireless mGRE tunnels, use the mobility command in interface configuration mode. To
return to the default settings, use the no form of this command.
mobility {network-id id|tcp adjust-mss}
mobility [{trust|broadcast}]
Syntax Description network-id id Specifies the wireless network ID for the mGRE tunnel; valid values are from 1 to 4095.
tcp adjust-mss Adjusts the MSS value in TCP SYN and TCP ACK on the access points automatically.
trust (Optional) Specifies the trusted network.
broadcast (Optional) Specifies that the mGRE tunnel convert the NBMA to the BMA.
Command Default Untrusted network
Command Modes Interface configuration
Command History Release Modification
12.2(18)SXD Support for this command was introduced on the Supervisor Engine 720.
12.2(18)SXD3 This command was changed to include the tcpadjust-mss keywords.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is supported on Cisco 7600 series routers that are configured with a WLSM only.
The tcpadjust-mss keywords are supported on mGRE tunnel interfaces only.
You can enter the iptcpadjust-mssvalue command to change the TCP MSS to a lower value.
A trusted network can use DHCP or a static IP address. An untrusted network supports only DHCP clients.
Examples This example shows how to specify the network identification number for the mGRE tunnel:
Router(config-if)# mobility network-id 200
Router(config-if)#
This example shows how to specify the trusted network:
Router(config-if)# mobility trust
Router(config-if)#
This example shows how to specify that the mGRE tunnel convert the NBMA to the BMA:
Router(config-if)# mobility broadcast
Router(config-if)#
Cisco IOS Interface and Hardware Component Command Reference
725
loopback T1 interface through nrzi-encoding
mobility
This example shows how to adjust the MSS value in TCP SYN and TCP ACK on the access points
automatically:
Router(config-if)# mobility tcp adjust-mss
Router(config-if)#
Related Commands Command Description
ip tcp adjust-mss Adjusts the MSS value of TCP SYN packets going through a router.
show mobility Displays information about the Layer 3 mobility and the wireless network.
Cisco IOS Interface and Hardware Component Command Reference
726
loopback T1 interface through nrzi-encoding
mode
mode
To set the redundancy mode, use the mode command in redundancy configuration mode.
Syntax for 12.2S Release
mode {rpr|rpr-plus|sso}
Syntax for Cisco IOS XE Release 2.5 and Later Releases
mode {rpr|sso}
Syntax for 12.2XNE Release
mode sso
Syntax Description rpr Specifies Route Processor Redundancy (RPR) mode.
rpr-plus Specifies Route Processor Redundancy Plus (RPR+) mode.
sso Specifies stateful switchover (SSO) mode.
Command Default • The default is SSO mode if the system is not configured for redundancy and the active and standby
supervisor engines have the same image.
• The default is RPR mode if different versions are installed.
• If redundancy is enabled, the default is the mode that you have configured.
• The default is RPR+ mode if the system is not configured for redundancy and the active and standby
supervisor engines have the same image.
• The default is RPR mode if different versions are installed.
• If redundancy is enabled, the default is the mode that you have configured.
• The default is SSO mode if the system is not configured for redundancy and the active and standby
supervisor engines have the same image.
• The default is RPR mode if different versions are installed.
• The default is SSO mode if the system is not configured for redundancy and the active and standby
supervisor engines have the same image.
• The default is RPR mode if different versions are installed.
Command Modes Redundancy configuration (config-red)
Command History Release Modification
12.2(14)SX This command was introduced on the Supervisor Engine 720.
12.2(17b)SXA This command was modified. Support was added for SSO mode and the default
mode change.
Cisco IOS Interface and Hardware Component Command Reference
727
loopback T1 interface through nrzi-encoding
mode
Release Modification
12.2(17d)SXB This command was modified. Support was added for multicast and unicast traffic.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)XNE This command was modified. This command was implemented on the Cisco
10000 router.
Cisco IOS XE Release 2.5 This command was modified. This command was implemented on the Cisco
ASR 1000 Series Routers.
Usage Guidelines Cisco IOS Release 12.2S and 7600 Series Routers
SSO is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.
On releases prior to Release 12.2(17d)SXB, single router mode (SRM) with SSO redundancy does not support
stateful switchover for multicast traffic. When a switchover occurs, all multicast hardware switching entries
are removed and are then re-created and reinstalled in the hardware by the newly active multilayer switch
feature card (MSFC).
SRM/SSO is supported in the following releases only:
• Release 12.2(17b)SXA and subsequent rebuilds.
• Release 12.2(17d)SXB and subsequent rebuilds.
Nonstop forwarding (NSF) with SSO redundancy mode supports IPv4. NSF with SSO redundancy mode does
not support IPv6, Internetwork Packet Exchange (IPX), and Multiprotocol Label Switching (MPLS).
If you have configured MPLS on the Cisco 7600 series routers with redundant supervisor engines, you must
configure the Cisco 7600 series router in RPR mode. The switch should not be running in the default mode
of SSO.
Enter the redundancy command in global configuration mode to enter redundancy configuration mode. You
can enter the mode command within redundancy configuration mode.
Follow these guidelines when configuring your system for RPR+ mode:
• You must install compatible images on the active and standby supervisor engines to support RPR+ mode
and SSO mode.
• Both supervisor engines must run the same Cisco IOS software version.
• Any modules that are not online at the time of a switchover are reset and reloaded on a switchover.
• The Forwarding Information Base (FIB) tables are cleared on a switchover. As a result, routed traffic is
interrupted until route tables reconverge.
The standby supervisor engine reloads on any change of mode and begins to work in the current mode. When
you use this command to force the standby supervisor engine to run as a Distributed Forwarding Card (DFC)
card, the uplink ports in the standby engine continue to be in use and are not disabled.
Cisco IOS Release XE Release 2.5 and ASR 1000 Series Routers
For Cisco ASR 1002 and 1004 routers, RRP and stateful switchover can be used to switch between Cisco IOS
processes. RPR and SSO need to be configured by the user, however, because a second Cisco IOS process is
not available by default on Cisco ASR 1002 and 1004 routers. Enter the redundancy command in global
Cisco IOS Interface and Hardware Component Command Reference
728
loopback T1 interface through nrzi-encoding
mode
configuration mode to enter redundancy configuration mode. You can enter the mode command within
redundancy configuration mode.
The Cisco ASR 1006 Router supports a second Route Processor. The second Cisco IOS process can run only
on the standby Route Processor. This means that hardware redundancy is available and RPR and SSO do not
need to be configured by the user because a second Cisco IOS process is available by default on the Cisco
ASR 1006 router.
RPR+ mode is not supported on the Cisco ASR 1000 Series Routers.
Cisco IOS Release 12.2XNE and 1000 Series Routers
Enter the redundancy command in global configuration mode to enter redundancy configuration mode. You
can enter the mode command within redundancy configuration mode.
RPR mode is not supported on the Cisco 10000 router.
Examples This example shows how to set the redundancy mode to RPR+:
Router(config)# redundancy
Router(config-red)# mode rpr-plus
This example shows how to set the redundancy mode to SSO:
Router(config)# redundancy
Router(config-red)# mode sso
Related Commands Command Description
redundancy Enters redundancy configuration mode.
redundancy force-switchover Forces a switchover from the active to the standby supervisor engine.
route-converge-interval Configures the time interval after which the old FIB entries are purged.
show redundancy Displays RF information.
show running-config Displays the status and configuration of the module or Layer 2 VLAN.
Cisco IOS Interface and Hardware Component Command Reference
729
loopback T1 interface through nrzi-encoding
mode (ATM T1 E1 controller)
mode (ATM T1 E1 controller)
To set the DSL controller into ATM mode and create an ATM interface or to set the T1 or E1 controller into
T1 or E1 mode and create a logical T1/E1 controller, use the mode command in controller configuration
mode. To disable the current mode and prepare to change modes, use the no form of this command.
Cisco 1800, Cisco 2800, Cisco 3700, Cisco 3800 Series
mode atm
no mode atm
Cisco 1700 Series, Cisco 2600XM
mode {atm|t1|e1}
no mode {atm|t1|e1}
Cisco IAD2430
mode {atm [aim aim-slot]|cas|t1|e1}
no mode {atm [aim aim-slot]|cas|t1|e1}
Syntax Description atm Sets the controller into ATM mode and creates an ATM interface (ATM 0). When ATM mode
is enabled, no channel groups, DS0 groups, PRI groups, or time-division multiplexing (TDM)
groups are allowed, because ATM occupies all the DS0s on the T1/E1 trunk.
When you set the controller to ATM mode, the controller framing is automatically set to extended
super frame (ESF) for T1 or cyclic redundancy check type 4 (CRC4) for E1. The line code is
automatically set to binary 8-zero substitution (B8ZS) for T1 or high-density bipolar C (HDBC)
for E1. When you remove ATM mode by entering the nomodeatm command, ATM interface 0
is deleted.
Note The modeatm command without the aim keyword uses software to perform ATM
segmentation and reassembly (SAR). This is supported on Cisco 2600 series WIC slots
only; it is not supported on network module slots.
aim (Optional) The configuration on this controller uses the Advanced Integration Module (AIM) in
the specified slot for ATM SAR. The aim keyword does not apply to the Cisco IAD2430 series
IAD.
aim-slot (Optional) AIM slot number on the router chassis:
• Cisco 2600 series--0.
• Cisco 3660--0 or 1.
cas (Cisco 2600 series WIC slots only) Channel-associated signaling (CAS) mode. The T1 or E1 in
this WIC slot is mapped to support T1 or E1 voice (that is, it is configured in a DS0 group or a
PRI group).
CAS mode is supported on both controller 0 and controller 1.
On the Cisco IAD2430 series IAD, CAS mode is not supported.
Cisco IOS Interface and Hardware Component Command Reference
730
loopback T1 interface through nrzi-encoding
mode (ATM T1 E1 controller)
t1 Sets the controller into T1 mode and creates a T1 interface.
When you set the controller to T1 mode, the controller framing is automatically set to ESF for
T1. The line code is automatically set to B8ZS for T1.
e1 Sets the controller into E1 mode and creates an E1 interface.
When you set the controller to E1 mode, the controller framing is automatically set to CRC4 for
E1. The line code is automatically set to HDB3 for E1.
Command Default The controller mode is disabled.
Command Modes Controller configuration
Command History Release Modification
11.3 MA This command was introduced on the Cisco MC3810.
12.1(5)XM Support for this command was extended to the merged SGCP/MGCP software.
12.2(2)T This command was integrated into Cisco IOS Release 12.2(2)T.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T for the Cisco IAD2420.
12.2(2)XB Support was extended to the Cisco 2600 series and Cisco 3660. The keyword aim and the
argument aim-slot were added. The parenthetical modifier for the command was changed from
“Voice over ATM” to “T1/E1 controller.”
12.2(15)T This command was implemented on the Cisco 2691 and the Cisco 3700 series.
12.3(4)XD This command was integrated into Cisco IOS Release 12.3(4)XD on Cisco 2600 series and Cisco
3700 series routers to configure DSL Frame mode and to add T1/E1 Framed support.
12.3(4)XG This command was integrated into Cisco IOS Release 12.3(4)XG on the Cisco 1700 series
routers.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T on Cisco 2600 series and Cisco
3700 series routers.
12.3(11)T This command was implemented on Cisco 2800 and Cisco 3800 series routers.
12.3(14)T This command was implemented on Cisco 1800 series routers.
Usage Guidelines When a DSL controller is configured in ATM mode, the mode must be configured identically on both the CO
and CPE sides. Both sides must be set to ATM mode.
Note If using the nomodeatm command to leave ATM mode, the router must be rebooted immediately to clear the
mode.
When configuring a DSL controller in T1 or E1 mode, the mode must be configured identically on the CPE
and CO sides.
Cisco IOS Interface and Hardware Component Command Reference
731
loopback T1 interface through nrzi-encoding
mode (ATM T1 E1 controller)
Examples
ATM Mode Example
The following example configures ATM mode on the DSL controller.
Router(config)# controller
dsl
3/0
Router(config-controller)# mode atm
T1 Mode Example
The following example configures T1 mode on the DSL controller.
Router(config)# controller
dsl
3/0
Router(config-controller)# mode t1
Related Commands Command Description
channel-group Configures a list of time slots for voice channels on controller T1 0 or E1 0.
tdm-group Configures a list of time slots for creating clear channel groups (pass-through) for
time-division multiplexing (TDM) cross-connect.
Cisco IOS Interface and Hardware Component Command Reference
732
loopback T1 interface through nrzi-encoding
mode (HSA redundancy)
mode (HSA redundancy)
To configure the redundancy mode, use the modecommand in redundancy configuration mode. To configure
the default redundancy mode, use the noform of this command.
mode {hsa|rpr|rpr-plus}
no mode {hsa|rpr|rpr-plus}
Syntax Description hsa Selects High System Availability (HSA) redundancy mode. This is the default.
rpr Selects Route Processor Redundancy (RPR) mode.
rpr-plus Selects Route Processor Redundancy Plus (RPR+) redundancy mode.
Command Default HSA redundancy mode
Command Modes Redundancy configuration
Command History Release Modification
12.0(16)ST This command was introduced.
12.0(19)ST1 The rpr-pluskeyword was added.
12.0(22)S This command was integrated into Cisco IOS Release 12.0(22)S.
12.2(14)S This command was integrated into Cisco IOS Release 12.2(14)S.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
Usage Guidelines The mode selected by the mode command in redundancy configuration mode must be fully supported by the
image that has been installed in both the active and standby Route Switch Processors (RSPs). A high availability
image must be installed in the RSPs before RPR+ can be configured. Use thehw-moduleslotimagecommand
to specify a high availability image to run on the standby RSP.
If the mode cannot be set on both RSPs, HSA is the default mode. A Cisco 7507 or Cisco 7513 router that
has only one RSP installed operates in single Route Processor mode.
Examples The following example enters redundancy configuration mode and sets RPR+ as the redundancy
mode for a Cisco 7500 series router.
Router(config)# redundancy
Router(config-r)# mode rpr-plus
Router(config-r)# end
Related Commands Command Description
hw-module sec-cpu reset Resets and reloads the standby RSP with the specified Cisco IOS image
and executes the image.
Cisco IOS Interface and Hardware Component Command Reference
733
loopback T1 interface through nrzi-encoding
mode (HSA redundancy)
Command Description
hw-module slot image Specifies a high availability Cisco IOS image to run on an active or standby
RSP.
redundancy Enters redundancy configuration mode.
redundancy force-switchover Switches control of a router from the active RSP to the standby RSP.
show redundancy Displays the current redundancy mode.
Cisco IOS Interface and Hardware Component Command Reference
734
loopback T1 interface through nrzi-encoding
mode (RSC redundancy)
mode (RSC redundancy)
To choose between classic-split mode (maximum throughput with no load sharing) and handover-split mode
(maximum availability with load sharing), use the mode command in redundancy configuration mode. To
reset to the default mode, use the no form of this command.
mode {classic-split|handover-split}
no mode
Syntax Description classic-split Nonredundant mode in which slots are split in a fixed 6/6 pattern between the two
route-switch-controller (RSC) cards, and no handover occurs. This is the default.
handover-split Redundant mode in which, if one RSC fails, the peer RSC takes over control of the failed
RSC’s resources (slots and cards).
Command Default Classic-split mode
Command Modes Redundancy configuration
Command History Release Modification
12.2(2)XB1 This command was introduced.
12.2(11)T This command was integrated into Cisco IOS Release 12.2(11)T.
Usage Guidelines You must be connected to an RSC card on your Cisco AS5850 to use this command.
Examples The following example selects handover-split mode:
Router(config)# redundancy
Router(config-r)#
mode handover-split
Related Commands Command Description
show chassis Displays, for a router with two RSCs, information about mode
(handover-split or classic-split), RSC configuration, and slot ownership.
show chassis clocks Displays all configured clock sources, even those from non-owned cards.
This is because only one RSC can provide the master clock, and it may
need to have backup clock sources configured from all cards present,
regardless of ownership.
show context Displays information about specified slots.
show redundancy debug-log Displays up to 256 redundancy-related debug entries.
Cisco IOS Interface and Hardware Component Command Reference
735
loopback T1 interface through nrzi-encoding
mode (T1 E1 controller)
mode (T1 E1 controller)
To set the T1 or E1 controller into asynchronous transfer mode (ATM) and create an ATM interface, to set
the T1 or E1 controller into T1 or E1 mode and create a logical T1 or E1 controller, or to set the T1 or E1
controller into channel-associated signaling (CAS) mode, use the mode command in controller configuration
mode. To disable the current mode and prepare to change modes, use the noform of this command.
mode {atm [aim aim-slot]|cas|t1|e1}
no mode {atm [aim aim-slot]|cas|t1|e1}
Syntax Description atm Sets the controller into ATM mode and creates an ATM interface (ATM 0). When ATM mode
is enabled, no channel groups, DS0 groups, PRI groups, or time-division multiplexing (TDM)
groups are allowed, because ATM occupies all the DS0s on the T1/E1 trunk.
When you set the controller to ATM mode, the controller framing is automatically set to extended
super frame (ESF) for T1 or cyclic redundancy check type 4 (CRC4) for E1. The line code is
automatically set to binary 8-zero substitution (B8ZS) for T1 or high-density bipolar C (HDB3)
for E1. When you remove ATM mode by entering the no mode atm command, ATM interface
0 is deleted.
On the Cisco MC3810, ATM mode is supported only on controller 0 (T1 or E1 0).
Note The mode atm command without the aim keyword uses software to perform ATM
segmentation and reassembly (SAR). This is supported on Cisco 2600 series WIC slots
only and is not supported on network module slots.
aim (Optional) The configuration on this controller uses the Advanced Integration Module (AIM) in
the specified slot for ATM SAR. The aim keyword does not apply to the Cisco MC3810 and the
Cisco IAD2420 series IAD.
aim-slot (Optional) AIM slot number on the router chassis. For the Cisco 2600 series, the AIM slot number
is 0; for the Cisco 3660, the AIM slot number is 0 or 1.
cas (CAS mode on Cisco 2600 series WIC slots only) The T1 or E1 in this WIC slot is mapped to
support T1 or E1 voice (it is configured in a DS0 group or a PRI group).
CAS mode is supported on both controller 0 and controller 1.
t1 (Cisco 2600XM series using the G.SHDSL WIC only) Sets the controller into T1 mode and creates
a T1 interface.
When you set the controller to T1 mode, the controller framing is automatically set to ESF for
T1. The line code is automatically set to B8ZS for T1.
e1 (Cisco 2600XM series using the G.SHDSL WIC only) Sets the controller into E1 mode and creates
an E1 interface.
When you set the controller to E1 mode, the controller framing is automatically set to CRC4 for
E1. The line code is automatically set to HDB3 for E1.
Command Default No controller mode is configured.
Cisco IOS Interface and Hardware Component Command Reference
736
loopback T1 interface through nrzi-encoding
mode (T1 E1 controller)
Command Modes
Controller configuration
Command History Release Modification
11.3 MA This command was introduced on the Cisco MC3810.
12.1(5)XM Support for this command was extended to Simple Gateway Control Protocol (SGCP) and
Media Gateway Control Protocol (MGCP).
12.2(2)T This command was integrated into Cisco IOS Release 12.2(2)T and implemented on the Cisco
7200 series.
12.2(2)XB Support was extended to the Cisco 2600 series and Cisco 3660. The aimkeyword and the
aim-slot argument were added. The parenthetical modifier for the command was changed from
"Voice over ATM" to "T1/E1 controller."
12.2(8)T This command was implemented on the Cisco IAD2420 series.
12.2(11)T This command was implemented on the Cisco AS5300 and Cisco AS5850.
12.2(15)T This command was implemented on the Cisco 2691 and the Cisco 3700 series.
12.3(4)XD Support was extended on Cisco 2600 series and Cisco 3700 series routers to configure DSL
Frame mode and to add T1/E1 Framed support.
12.3(7)T The support that was added in Cisco IOS Release 12.3(4)XD was integrated into Cisco IOS
Release 12.3(7)T.
Usage Guidelines This command has the following platform-specific usage guidelines:
• Cisco 2600 series, Cisco 3660 routers, or Cisco 3700 series that use an AIM for ATM processing must
use the mode atm aimaim-slot command.
• Cisco 2600 series routers that use an AIM for DSP processing and specify DS0 groups must use the
mode cas command if they are using WIC slots for voice. This command does not apply if network
modules are being used.
• Cisco 3660 routers or Cisco 3700 series that use an AIM only for DSP resources should not use this
command.
• On Cisco 2600 series routers that use WIC slots for voice, the mode atm command without the aim
keyword specifies software ATM segmentation and reassembly. When the aim keyword is used with
the mode atm command, the AIM performs ATM segmentation and reassembly.
• Cisco MC3810 routers cannot use the aim keyword.
• Cisco MC3810 routers with digital voice modules (DVMs) use some DS0s exclusively for different
signaling modes. The DS0 channels have the following limitations when mixing different applications
(such as voice and data) on the same network trunk:
• On E1 controllers, DS0 16 is used exclusively for either CAS or common channel signaling (CCS),
depending on which mode is configured.
• On T1 controllers, DS0 24 is used exclusively for CCS.
Cisco IOS Interface and Hardware Component Command Reference
737
loopback T1 interface through nrzi-encoding
mode (T1 E1 controller)
• Cisco MC3810--When no mode is selected, channel groups and clear channels (data mode) can be created
using the channel group and tdm-group commands, respectively.
• Cisco MC3810 is not supported in the AIM-ATM, AIM-VOICE-30, and AIM-ATM-VOICE-30 on the
Cisco 2600 Series, Cisco 3660, and Cisco 3700 Series feature.
• On Cisco 2600 series and Cisco 3700 series routers when configuring a DSL controller in ATM mode,
the mode must be set to the same mode on both the CO and CPE sides. Both sides must be set to ATM
mode.
• If the no mode atm command is used to leave ATM mode, the router must be rebooted immediately
to clear the mode.
• On Cisco 2600 series and Cisco 3700 series routers when configuring a DSL controller in T1 or E1 mode,
the mode must be configured identically on the CO and CPE sides.
Examples The following example configures ATM mode on controller T1 0. This step is required for Voice
over ATM.
Router(config)# controller
T1 0
Router(config-controller)# mode atm
The following example configures ATM mode on controller T1 1/ 0 on a Cisco 2600 series router
using an AIM in slot 0 for ATM segmentation and reassembly:
Router(config)# controller
t1 1/0
Router(config-controller)# mode atm aim 0
The following example configures CAS mode on controller T1 1 on a Cisco 2600 series router:
Router(config)# controller
T1 1
Router(config-controller)# mode cas
The following example configures ATM mode on the DSL controller.
Router(config)# controller
dsl 3/0
Router(config-controller)# mode atm
The following example configures T1 mode on the DSL controller.
Router(config)# controller
dsl
3/0
Router(config-controller)# mode t1
Related Commands Command Description
channel-group Defines the time slots for voice channels on controller T1 0 or E1 0.
tdm-group Configures a list of time slots for creating clear channel groups (pass-through) for TDM
cross-connect.
Cisco IOS Interface and Hardware Component Command Reference
738
loopback T1 interface through nrzi-encoding
mode bypass
mode bypass
To enable Virtual Multipoint Interfaces (VMI) to support multicast traffic, use the modebypass command in
interface configuration mode. To return the interface to the default mode of aggregate, use the no form of this
command.
mode [{aggregate|bypass}]
no mode bypass
Syntax Description aggregate Sets the mode to aggregate. All virtual-access interfaces created by PPPoE sessions are logically
aggregated under the VMI.
bypass Sets the mode to bypass.
Command Default No mode
Command Modes Interface configuration
Command History Release Modification
12.4(15)XF This command was introduced.
12.4(15)T This command was integrated into Cisco IOS Release 12.4(15)T to support multicast traffic on
Virtual Multipoint Interfaces (VMIs).
Usage Guidelines Use the mode bypass command when you need to support multicast traffic in router-to-radio configurations.
Aggregate Mode
The default mode for operation of the VMI is aggregate mode. In aggregate mode, all of the virtual-access
interfaces created by PPPoE sessions are logically aggregated under the VMI. As such, applications above
Layer 2, such as, EIGRP and OSPFv3, should be defined on the VMI interface only. Packets sent to the VMI
will be correctly forwarded to the correct virtual-access interface.
Bypass Mode
Using bypass mode is recommended for multicast applications.
In bypass mode, the virtual-access interfaces are directly exposed to applications running above Layer2. In
bypass mode, definition of a VMI is still required because the VMI will continue to manage presentation of
cross-layer signals, such as, neighbor up, neighbor down, and metrics. However, applications will still be
aware on the actual underlying virtual-access interfaces and send packets to them directly.
Using bypass mode can cause databases in the applications to be larger because knowledge of more interfaces
are required for normal operation.
After you enter the modebypass command, Cisco recommends that you copy the running configuration to
NVRAM. because the default mode of operation for VMI is to logically aggregate the virtual-access interfaces.
Examples The following example sets the interface mode to bypass:
Cisco IOS Interface and Hardware Component Command Reference
739
loopback T1 interface through nrzi-encoding
mode bypass
Router# enable
Router# configure terminal
Router(config)# interface vmi1
Router(config-if)# mode bypass
Related Commands Command Description
interface vmi Creates a VMI interface.
Cisco IOS Interface and Hardware Component Command Reference
740
loopback T1 interface through nrzi-encoding
mode c-12
mode c-12
To configure the mode of an E1 line that has been mapped to a TUG-3, use the mode c-12 command in
configuration controller tug3 mode.To configure the mode of an E1 line that has been mapped to a AU-3, use
the mode c-12 command in configuration controller au3 mode. To disable the mode configuration, use the
no form of this command.
mode c-12
no mode c-12m
Syntax Description This command has no arguments or keywords
Command Default Disabled
Command Modes Configuration controller tug3 (for an E1 line mapped to a TUG-3) Configuration controller au3 (for an E1
line mapped to an AU-3)
Command History Release Modification
12.0(14)S This command was introduced.
12.1(7)E This command was integrated into Cisco IOS Release 12.1(7)E, and support was added for
Cisco 7200 VXR routers and Catalyst 6000 family switches.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T.
12.2(14)S This command was integrated into Cisco IOS Release 12.2(14)S.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines You can configure each of the TUG-3s or AU-3s of a PA-MC-STM-1 to carry a set of TU-12s (E1s mapped
into TU-12s). The modec-12command configures the mode of operation of a TUG-3 or AU-3 and specifies
that the TUG-3 or AU-3 is divided into 21 TU-12s, each carrying an E1.
Examples The following example configures the AUG-mapping of the SONET controller to AU-3 and specifies
the mode of AU-3 1 to c-12 on a Cisco 7500 series router:
Router(config)# controller sonet 1/0/0
Router(config-controller)# aug mapping au-3
Router(config-controller)# au3 1
Router(config-ctrlr-au3)# mode c-12
The following example configures the AUG-mapping of the SONET controller to AU-4 and specifies
the mode of TUG-3 1 of AU-4 1 to c-12 on a Cisco 7200 VXR router or a Catalyst 6000 family
switch:
Router(config)# controller sonet 1/0
Cisco IOS Interface and Hardware Component Command Reference
741
loopback T1 interface through nrzi-encoding
mode c-12
Router(config-controller)# aug mapping au-4
Router(config-controller)# au-4 1 tug-3 1
Router(config-ctrlr-tug3)# mode c-12
Cisco IOS Interface and Hardware Component Command Reference
742
loopback T1 interface through nrzi-encoding
mode ct3
mode ct3
Use this command to configure channelized T3 mode.
mode ct3
Syntax Description Syntax Description:
There are no keywords for this command.
Command Default None
Command Modes Controller configuration
Command History Release Modification
XE 3.18 SP Support for this command was introduced on NCS 4200 Series.
Examples The following example shows how to configure DS1 CT3 SAToP mode:
Router> enable
Router#configure terminal
Router(config)# controller MediaType 0/5/0
Router(config-ctr)# mode sonet
Router(config-ctr-sonet)# controller sonet 0/5/0
Router(config-ctr-sonet)# rate oc12
Router(config-ctr-sonet)# sts-1 1
Router(config-ctr-sonet)# mode ct3
Router(config-ctr-sonet)# t1 1 cem-group 100 unframed
Router(config-ctr-sonet)# t1 1 framing unframed
Router(config)# interface cem 0/5/0
Router(config-if)#cem 100
Router(config-if)#xconnect 2.2.2.2 10 encapsulation mpls
Router(config-if)#end
Related Commands Command Description
controller sonet Configures the SONET mode.
show controller sonet Displays SONET controller configuration.
show controller t3 Displays T3 controller configuration.
Cisco IOS Interface and Hardware Component Command Reference
743
loopback T1 interface through nrzi-encoding
mode download
mode download
To enable operational code download mode for the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT), use the modedownloadcommand in satellite initial configuration mode. To disable
operational code download mode, use the no form of this command.
mode download
no mode download
Syntax Description This command has no arguments or keywords.
Command Default Operational code download mode is enabled.
Command Modes Satellite initial configuration
Command History Release Modification
12.3(14)T This command was introduced.
Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your satellite
service provider instructs you to perform the satellite initial configuration and provides all necessary parameter
values.
Examples The following example shows how to disable operational code download mode:
Router(sat-init-config)# no mode download
Cisco IOS Interface and Hardware Component Command Reference
744
loopback T1 interface through nrzi-encoding
mode e3
mode e3
Use this command to configure E3 mode.
mode e3
Syntax Description Syntax Description
None
Command Default None
Command Modes Controller configuration
Command History Release Modification
XE Everest This command was integrated into the Cisco NCS 4200 Series and
16.6.1
Cisco ASR 900 Series.
Usage Guidelines You can change the mode of a controller only when there are no subinterfaces defined for the controller.
Examples
enable
configure terminal
controller sdh 0/5/0
rate stm4
au-4 1
mode tug-3
tug-3 1
mode e3
cem-group 100 unframed
end
Related Commands Command Description
show running configuration Verifies mode E3 configuration.
Cisco IOS Interface and Hardware Component Command Reference
745
loopback T1 interface through nrzi-encoding
mode sonet
mode sonet
Use this command to configure SONET controller configuration mode.
mode sonet
Syntax Description Syntax Description:
This command has no arguments or keywords.
Command Default This command is disabled by default; no AIS is sent.
Command Modes Controller configuration
Command History Release Modification
XE 3.18 SP Support for this command was introduced on NCS 4200 Series.
Usage Guidelines This command is used to configure the SONET controller mode.
Examples The following example shows how to configure SONET mode:
enable
configure terminal
controller MediaType 0/5/0
mode sonet
end
Related Commands Command Description
controller mediatype Configures the mediatype controller.
controller sonet Displays information about Synchronous Optical Network (SONET) controllers.
show controller sonet Displays SONET controller configuration.
Cisco IOS Interface and Hardware Component Command Reference
746
loopback T1 interface through nrzi-encoding
mode sts-nc
mode sts-nc
To configure the concatenated signals in the SONET network, use the mode sts-nc command. The concatenated
signals are obtained by "gluing" together the payloads of the constituent signals, and they come in fixed sizes.
In SONET, these are called STS-Nc Synchronous Payload Envelopes (SPEs), where N = 3X and X is restricted
to the values 1, 4, 16, 64, or 256..
mode sts-nc
Syntax Description Syntax Description
This command has no keywords or arguments.
Command Default None
Command Modes Controller configuration
Command History Release Modification
XE 3.18 Support for this command was introduced on NCS 4200 Series.
SP
Usage Guidelines The command is used to concatenate continuous STS into a bundle. supported modes are STS-3c, STS-12c,
STS-48c, STS-192c.
Examples The following example shows the configuration of STS-Nc - contiguous concatenation:
enable
configure terminal
controller MediaType 0/5/0
mode sonet
controller sonet 0/5/0
rate oc12
sts-1 1-3 mode sts-3c
end
Related Commands Command Description
controller sonet Configures the SONET mode.
show controller sonet Displays SONET controller configuration.
Cisco IOS Interface and Hardware Component Command Reference
747
loopback T1 interface through nrzi-encoding
mode t3/e3
mode t3/e3
To set the T3/E3 controller in T3/E3 mode and create a logical T3/E3 controller, use the mode command in
controller configuration mode.
mode t3.e3
Syntax Description t3/e3 To set the T3/E3controller into T3/E3 mode and create a logical T3/E3 controller, use the mode
command in controller configuration mode.
Command Default The controller mode is disabled.
Command Modes Controller configuration
Command History
Command History Release Modification
XE 3.18SP This command was introduced.
Usage Guidelines Use this command to enable the port in T3 mode. When the port is enabled for T3, it can be used for clear
channel mode or channelized T3 mode based on configuration.
Examples The following example shows how to create the local loopback on the controller :
Router(config-controller)# mode t3/e3
Related Commands Command Description
controller media-type Enters controller configuration mode.
Cisco IOS Interface and Hardware Component Command Reference
748
loopback T1 interface through nrzi-encoding
mode two-way
mode two-way
To enable two-way operational mode for the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT), use the modetwo-waycommand in satellite initial configuration mode. To revert to
one-way operational mode, use the no form of this command.
mode two-way
no mode two-way
Syntax Description This command has no arguments or keywords.
Command Default Two-way mode is enabled.
Command Modes Satellite initial configuration
Command History Release Modification
12.3(14)T This command was introduced.
Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your satellite
service provider instructs you to perform the satellite initial configuration and provides all necessary parameter
values.
Examples The following example shows how to specify two-way operational mode:
Router(sat-init-config)# mode two-way
The following example shows how to specify one-way operational mode:
Router(sat-init-config)# no mode two-way
Cisco IOS Interface and Hardware Component Command Reference
749
loopback T1 interface through nrzi-encoding
mode vc-1x
mode vc-1x
Use this command to configure mode VC-1x mode.
mode vc-1x
Syntax Description Syntax Description
None
Command Default None
Command Modes Controller configuration
Command History Release Modification
XE Everest This command was integrated into the Cisco NCS 4200 Series and
16.6.1
Cisco ASR 900 Series.
Usage Guidelines When you configure mode VC-1x, seven TUG-2 payloads are created. TUG-2 payloads can be of two types,
VC-11 and VC-12. Default for TUG-2 payload mode is VC-11. TUG-2 payload VC-11 can be configured as
VC or T1 and the range is 1 to 4. TUG-2 payload VC-12 can be configured as VC or E1 and the range is 1 to
3.
Examples
enable
configure terminal
controller sdh 0/5/0
rate stm1
no ais-shut
alarm-report all
clock source internal
overhead s1s0 0
aug mapping au-4
au-4 1
clock source internal
mode tug-3
tug-3 1
mode VC1x
tug-2 1 payload VC11
tug-2 2 payload VC11
tug-2 3 payload VC11
tug-2 4 payload VC11
tug-2 5 payload VC11
tug-2 6 payload VC11
tug-2 7 payload VC11
end
Related Commands Command Description
show running configuration Verifies mode vc-1z configuration.
Cisco IOS Interface and Hardware Component Command Reference
750
loopback T1 interface through nrzi-encoding
mode vc-4
mode vc-4
Use this command to configure mode VC4 CEP.
mode vc-4
Syntax Description Syntax Description
None
Command Default None
Command Modes Controller configuration
Command History Release Modification
XE Everest This command was integrated into the Cisco NCS 4200 Series and Cisco ASR 900 Series.
16.6.1
Usage Guidelines CEP mode is used to encapsulate SDH payload envelopes (SPEs) like VC11, VC12, VC4, or VC4-Nc over
PSN. In this mode, the bytes from the corresponding SPE are sent out as they arrive on the TDM line. The
interface is considered as a continuous framed bit stream. The packetization of the stream is done according
to IETF RFC 4842. The supported ports are STM1, STM4, STM16, and STM64.
Examples
enable
configure terminal
controller sdh 0/5/0
rate stm 4
aug mapping au-4
au-4 1
mode vc4
cem-group 100 cep
end
Related Commands Command Description
show running configuration Verifies mode VC-4 configuration.
Cisco IOS Interface and Hardware Component Command Reference
751
loopback T1 interface through nrzi-encoding
mode vc4-Nc
mode vc4-Nc
Use this command to configure mode VC-4 Nc under AU-4.
mode vc4-Nc
Syntax Description Syntax Description
None
Command Default None
Command Modes Controller configuration
Command History Release Modification
XE Everest This command was integrated into the Cisco NCS 4200 Series and
16.6.1
Cisco ASR 900 Series.
Usage Guidelines CEP mode is used to encapsulate SDH payload envelopes (SPEs) like VC11, VC12, VC4, or VC4-Nc over
PSN. In this mode, the bytes from the corresponding SPE are sent out as they arrive on the TDM line. The
interface is considered as a continuous framed bit stream. The packetization of the stream is done according
to IETF RFC 4842. The supported ports are STM1, STM4, STM16, and STM64.
Examples
enable
configure terminal
controller sdh 0/5/0
au-4 1-4 mode vc4-4c
cem-group 100 cep
end
Related Commands Command Description
show running configuration Verifies
configuration.
Cisco IOS Interface and Hardware Component Command Reference
752
loopback T1 interface through nrzi-encoding
mode vt-15
mode vt-15
To configure the path operation mode, use the mode vt-15 command in controller configuration STS mode.
mode vt-15
Syntax Description vt-15 Specifies the mode of operation.
Command Default None
Command Modes
Controller configuration STS
Command History Release Modification
15.1(01)S This command was introduced on the Cisco 7600 routers.
Examples This example shows how to configure the mode vt-15:
Router(config)# controller sonet-acr 1
Router(config-controller)#
sts-1 2
Router(config-ctrlr-sts1)# mode vt-15
Related Commands Command Description
sts-1 Configures the Synchronous Transport Signal (STS) (level)-1 in the SONET
hierarchy.
vtg Configures the (CESoPSN) CEM group.
controller sonet-acr Configures the SONET Access Circuit Redundancy (ACR) virtual controller.
Cisco IOS Interface and Hardware Component Command Reference
753
loopback T1 interface through nrzi-encoding
mode t3
mode t3
Use this command to configure T3 mode.
mode t3
Syntax Description Syntax Description
None
Command Default None
Command Modes Controller configuration
Command History Release Modification
XE Everest This command was integrated into the Cisco NCS 4200 Series and
16.6.1
Cisco ASR 900 Series.
Usage Guidelines You can change the mode of a controller only when there are no subinterfaces defined for the controller.
Examples
enable
configure terminal
controller sdh 0/5/0
rate stm4
au-4 1
mode tug-3
tug-3 1
mode t3
cem-group 100 unframed
end
Related Commands Command Description
show running configuration Verifies
configuration.
Cisco IOS Interface and Hardware Component Command Reference
754
loopback T1 interface through nrzi-encoding
mode tug-3
mode tug-3
Use this command to configure mode Tributary Unit group type 3 (TUG-3) number that has been mapped to
an AU-4.
mode tug-3
Syntax Description Syntax Description
None
Command Default None
Command Modes Controller configuration
Command History Release Modification
XE Everest This command was integrated into the Cisco NCS 4200 Series and
16.6.1
Cisco ASR 900 Series.
Usage Guidelines An AUG of an STM-1 can be derived from either AU-3s or an AU-4. Use the aug mapping au-4 configuration
controller command to map the AUG to a TUG-3. Configuring the au-4 command enables you to enter
configuration controller tug3 command mode and creates a serial interface.
Mode TUG-3 creates three TUG-3 paths. TUG-3 range is 1 to 3.
Examples
enable
configure terminal
controller sdh 0/5/0
rate stm4
au-4 1
mode tug-3
end
Related Commands Command Description
show running configuration Verifies TUG-3
configuration.
Cisco IOS Interface and Hardware Component Command Reference
755
loopback T1 interface through nrzi-encoding
modem dtr-delay
modem dtr-delay
To control the time that a data terminal ready (DTR) signal is held down when a line clears, use the
modemdtr-delay command in line configuration mode. To restore the default hold down time, use the no
form of this command.
modem dtr-delay seconds
no modem dtr-delay seconds
Syntax Description seconds Number of seconds. The default is 5.
Command Default The default DTR signal hold down time is 5 seconds.
Command Modes Line configuration
Command History Release Modification
12.1 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use this command to reduce the time that a DTR signal is held down after an asynchronous line clears and
before the DTR signal is raised again to accept new calls. Incoming calls may be rejected in heavily loaded
systems even when modems are unused because the default DTR hold down interval may be too long.
Themodemdtr-delay command is designed for lines used for an unframed asynchronous session such as
Telnet. Lines used for a framed asynchronous session such as PPP should use the pulse-time interface
command.
Examples The following example shows how to specify a DTR hold down interval of 2 seconds:
Router(config)# line 7
Router(config-line)# modem dtr-delay 2
Related Commands Command Description
pulse-time Enables pulsing DTR signal intervals on serial interfaces.
Cisco IOS Interface and Hardware Component Command Reference
756
loopback T1 interface through nrzi-encoding
monitoring
monitoring
To enable monitoring of all optical transceivers and to specify the time period for monitoring the transceivers,
use the monitoringcommand in transceiver type configuration mode. To disable the monitoring, use the no
form of this command.
monitoring [interval seconds]
no monitoring [interval]
Syntax Description interval seconds (Optional) Specifies the time interval for monitoring optical transceivers; valid range
is 300 to 3600, in seconds, and the default interval time is 600.
Command Default The interval time is 600 seconds.
Command Modes Transceiver type configuration (config-xcvr-type)
Command History Release Modification
12.2(18)SXE This command was introduced.
12.2(33)SXH This command was modified. Theinterval keyword was added.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
15.2(2)SNI This command was implemented on the Cisco ASR 901 Series Aggregation Services Routers.
Usage Guidelines You need digital optical monitoring (DOM) feature and transceiver module compatibility information to
configure the monitoring command. Refer to the compatibility matrix to get the lists of Cisco platforms and
minimum required software versions to support Gigabit Ethernet transceiver modules.
Gigabit Ethernet Transceivers transmit and receive Ethernet frames at a rate of a gigabit per second, as defined
by the IEEE 802.3-2008 standard. Cisco's Gigabit Ethernet Transceiver modules support Ethernet applications
across all Cisco switching and routing platforms. These pluggable transceivers offer a convenient and cost
effective solution for the adoption in data center, campus, metropolitan area access and ring networks, and
storage area networks.
The monitoring command helps you to enable DOM feature and to evaluate threshold violations for all
transceiver types. The intervalkeyword enables you to change the default polling interval.For example, if
you set the interval as 1500 seconds, this setting causes a delay (of 1500 seconds) for the trap to be sent out
by the Simple Network Management Protocol (SNMP) manager running on Cisco IOS software.
Examples This example shows how to enable monitoring of optical transceivers and set the interval time for
monitoring to 1500 seconds:
Router# configure terminal
Router(config)# transceiver type all
Router(config-xcvr-type)# monitoring interval 1500
This example shows how to disable monitoring for all transceiver types:
Cisco IOS Interface and Hardware Component Command Reference
757
loopback T1 interface through nrzi-encoding
monitoring
Router(config-xcvr-type)# no monitoring
Related Commands Command Description
transceiver type all Enables monitoring on all transceivers.
Cisco IOS Interface and Hardware Component Command Reference
758
loopback T1 interface through nrzi-encoding
mop enabled
mop enabled
To enable an interface to support the Maintenance Operation Protocol ( MOP), use the mopenabled command
in interface configuration mode. To disable MOP on an interface, use the no form of this command.
mop enabled
no mop enabled
Syntax Description This command has no arguments or keywords.
Command Default Enabled on Ethernet interfaces and disabled on all other interfaces.
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples The following example enables MOP for serial interface 0:
Router(config)# interface serial 0
Router(config-if)# mop enabled
Related Commands Command Description
mop retransmit-timer Configures the length of time that the Cisco IOS software waits before sending
boot requests again to a MOP server.
mop retries Configures the number of times the Cisco IOS software will send boot requests
again to a MOP server.
mop sysid Enables an interface to send out periodic MOP system identification messages.
Cisco IOS Interface and Hardware Component Command Reference
759
loopback T1 interface through nrzi-encoding
mop sysid
mop sysid
To enable an interface to send out periodic Maintenance Operation Protocol (MOP) system identification
messages, use the mopsysid command in interface configuration mode. To disable MOP message support on
an interface, use the no form of this command.
mop sysid
no mop sysid
Syntax Description This command has no arguments or keywords.
Command Default Enabled
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines You can still run MOP without having the background system ID messages sent. This command lets you use
the MOP remote console, but does not generate messages used by the configurator.
Examples The following example enables serial interface 0 to send MOP system identification messages:
Router(config)# interface serial 0
Router(config-if)# mop sysid
Related Commands Command Description
mop device-code Identifies the type of device sending MOP sysid messages and request program messages.
mop enabled Enables an interface to support the MOP.
Cisco IOS Interface and Hardware Component Command Reference
760
loopback T1 interface through nrzi-encoding
mtu
mtu
To adjust the maximum packet size or maximum transmission unit (MTU) size, use the mtu command in
interface configuration mode, connect configuration mode, or xconnect subinterface configuration mode. To
restore the MTU value to its original default value, use the no form of this command.
mtu bytes mtu command
no mtu
Syntax Description bytes MTU size, in bytes.
Command Default The table below lists default MTU values according to media type.
Table 24: Default Media MTU Values
Media Type Default MTU (Bytes)
Ethernet 1500
Serial 1500
Token Ring 4464
ATM 4470
FDDI 4470
HSSI (HSA) 4470
Command Modes Interface configuration (config-if) Connect configuration (xconnect-conn-config) xconnect subinterface
configuration (config-if-xconn)
Command History Release Modification
10.0 This command was introduced.
12.0(26)S This command was modified. This command was updated to support the connect
configuration mode for Frame Relay Layer 2 interworking.
12.2(14)SX This command was integrated into Cisco IOS Release 12.2(14)SX. Support for
this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB This command was modified. Support for this command was introduced on the
Supervisor Engine 2.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.4(11)T This command was integrated into Cisco IOS Release 12.4(11)T.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB.
Cisco IOS Interface and Hardware Component Command Reference
761
loopback T1 interface through nrzi-encoding
mtu
Release Modification
Cisco IOS XE Release 2.4 This command was integrated into Cisco IOS XE Release 2.4. This command
supports the xconnect subinterface configuration mode.
Usage Guidelines Each interface has a default maximum packet size or MTU size. This number generally defaults to the largest
size possible for that interface type. On serial interfaces, the MTU size varies but cannot be set to a value less
than 64 bytes.
Note The connect configuration mode is used only for Frame Relay Layer 2 interworking.
Changing the MTU Size
Changing the MTU size is not supported on a loopback interface.
Changing the MTU size on a Cisco 7500 series router results in the recarving of buffers and resetting of all
interfaces. The following message is displayed: RSP-3-Restart:cbus complex .
You can configure native Gigabit Ethernet ports on the Cisco 7200 series router to a maximum MTU size of
9216 bytes. The MTU values range from 1500 to 9216 bytes. The MTU values can be configured to any range
that is supported by the corresponding main interface.
Protocol-Specific Versions of the mtu Command
Changing the MTU value with the mtu interface configuration command can affect values for the
protocol-specific versions of the command (the ipmtu command, for example). If the value specified with
the ipmtu interface configuration command is the same as the value specified with the mtu interface
configuration command, and you change the value for the mtu interface configuration command, the ipmtu
value automatically matches the new mtu interface configuration command value. However, changing the
values for the ipmtu configuration commands has no effect on the value for the mtu interface configuration
command.
ATM and LANE Interfaces
ATM interfaces are not bound by what is configured on the major interface. By default, the MTU on a
subinterface is equal to the default MTU (4490 bytes). A client is configured with the range supported by the
corresponding main interface. The MTU can be changed on subinterfaces, but it may result in recarving of
buffers to accommodate the new maximum MTU on the interface.
VRF-Aware Service Infrastructure Interfaces
The mtu command does not support the VRF-Aware Service Infrastructure (VASI) type interface.
Cisco 7600 Valid MTU Values
On the Cisco 7600 platform, the following valid values are applicable:
• For the SVI ports: from 64 to 9216 bytes
• For the GE-WAN+ ports: from 1500 to 9170 bytes
• For all other ports: from 1500 to 9216 bytes
You can receive jumbo frames on access subinterfaces also. The MTU values can be configured to any range
that is supported by the corresponding main interface. If you enable the jumbo frames, the default is 64 bytes
for the SVI ports and 9216 bytes for all other ports. The jumbo frames are disabled by default.
Cisco IOS Interface and Hardware Component Command Reference
762
loopback T1 interface through nrzi-encoding
mtu
Cisco uBR10012 Universal Broadband Router
While configuring the interface MTU size on a Gigabit Ethernet SPA on a Cisco uBR10012 router, consider
the following guidelines:
• The default interface MTU size accommodates a 1500-byte packet, plus 22 additional bytes to cover the
following overhead:
• Layer 2 header--14 bytes
• Dot1Q header--4 bytes
• CRC--4 bytes
• If you are using MPLS, be sure that the mplsmtu command is configured with a value less than or equal
to the interface MTU.
• If you are using MPLS labels, you should increase the default interface MTU size to accommodate the
number of MPLS labels. Each MPLS label adds 4 bytes of overhead to a packet.
Note For the Gigabit Ethernet SPAs on the Cisco uBR10012 router, the default MTU size is 1500 bytes. When the
interface is being used as a Layer 2 port, the maximum configurable MTU is 9000 bytes.
Examples The following example shows how to specify an MTU of 1000 bytes:
Router(config)# interface serial 1
Router(config-if)# mtu 1000
Cisco uBR10012 Universal Broadband Router
The following example shows how to specify an MTU size on a Gigabit Ethernet SPA on the Cisco
uBR10012 router:
Router(config)# interface GigabitEthernet3/0/0
Router(config-if)# mtu 1800
Related Commands Command Description
encapsulation smds Enables SMDS service on the desired interface.
ip mtu Sets the MTU size of IP packets sent on an interface.
Cisco IOS Interface and Hardware Component Command Reference
763
loopback T1 interface through nrzi-encoding
national bit (controller)
national bit (controller)
To set the E3 national bit in the G.751 frame used by the E3 controller, use the national bit command in
controller configuration mode. To return to the default E3 controller national bit, use the no form of this
command.
national bit {0|1}
no national bit
Syntax Description 0 Sets the E3 national bit in the G.751 frame to 0.
1 Sets the E3 national bit in the G.751 frame to 1. This is the default.
Command Default The default value is 1.
Command Modes Controller configuration
Command History Release Modification
11.1 CA This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and implemented on the
following platforms: Cisco 2650XM, Cisco 2651XM, Cisco 2691, Cisco 3660 series, Cisco
3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
Usage Guidelines When G.751 framing is used, bit 11 of the G.751 frame is reserved for national use and is set to 1 by default.
Configure national bit 1 only when required for interoperability with your telephone company.
To verify the national bit configured on the interface, use the showcontrollersserial EXEC command.
Examples The following example sets the national bit to 1 on an E3 controller in slot 1, port 0:
Router(config)# controller e3 1/0
Router(config-controller)# national bit 1
Related Commands show controllers serial Displays information that is specific to the interface hardware.
Cisco IOS Interface and Hardware Component Command Reference
764
loopback T1 interface through nrzi-encoding
national bit (interface)
national bit (interface)
To set the E3 national bit in the G.751 frame used by the PA-E3 port adapter, use the nationalbitcommand
in interface configuration mode. To return to the default E3 interface national bit, use the no form of this
command.
national bit {0|1}
no national bit
Syntax Description 0 Sets the E3 national bit in the G.751 frame to 0. This is the default.
1 Sets the E3 national bit in the G.751 frame to 1.
Command Default The default value is 0.
Command Modes Interface configuration
Command History Release Modification
11.1 This command was introduced.
CA
Usage Guidelines The nationalbit command sets bit 12 in the E3 frame.
To verify the national bit configured on the interface, use the showcontrollersserial EXEC command.
Examples The following example sets the national bit to 1 on the PA-E3 port adapter in slot 1, port adapter slot
0, interface 0:
Router(config)# interface serial 1/0/0
Router(config-if)# national bit 1
Related Commands Command Description
international bit Sets the E3 international bit in the G.751 frame used by the PA-E3 port adapter.
show controllers serial Displays information that is specific to the interface hardware.
Cisco IOS Interface and Hardware Component Command Reference
765
loopback T1 interface through nrzi-encoding
national reserve
national reserve
To set the E1 national bit, use thenationalreservecommand in interface configuration mode. To return to the
default E1 national bit, use theno form of this command.
national reserve {0|1} {0|1} {0|1} {0|1} {0|1} {0|1}
no national reserve
Syntax Description 0 Sets any of the six required E1 national bits in the G.751 frame to 0.
1 Sets any of the six required E1 national bits in the G.751 frame to 1. This is the default.
Command Default 111111
Command Modes Interface configuration
Command History Release Modification
12.0(5)XE This command was introduced.
12.0(7)XE1 This command was implemented on the Cisco 7100 series routers.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command applies only for E1. This command not only sets the national reserve bits but also sets the
international bit as well. The far left digit represents the international bit. All six digits must be present for
the pattern to be valid.
Examples On Cisco 7100 series routers, the following example sets the E1 national bit on interface 1 on the
port adapter in slot 0 to no scrambling:
Router(config)# interface atm 1/0
Router(config-if)# national reserve 011011
Cisco IOS Interface and Hardware Component Command Reference
766
loopback T1 interface through nrzi-encoding
negotiation
negotiation
To enable advertisement of speed, duplex mode, and flow control on a Gigabit Ethernet interface, use
thenegotiationcommand in interface configuration mode. To disable automatic negotiation, use the
nonegotiationauto command.
negotiation {forced|auto}
no negotiation auto
Syntax Description forced Disables flow control and configures the Gigabit Ethernet interface in 1000/full-duplex mode.
This keyword is not supported on the 2-port 10/100/1000 Gigabit Ethernet shared port adapter
(SPA) on the Cisco 7304 router.
auto Enables the autonegotiation protocol to configure the speed, duplex, and automatic flow control
of the Gigabit Ethernet interface. This is the default.
Command Default Autonegotiation is enabled.
Command Modes Interface configuration (config-if)
Command History Release Modification
11.1CC This command was introduced.
12.0(7)S This command was modified. The forced keyword was added.
12.0(6)T This command was modified. The forced keyword was added.
12.1(3a)E This command was integrated into Cisco IOS Release 12.1E and implemented on the Cisco
7200-I/O-GE+E controller.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.
12.2(20)S2 This command was implemented on the 2-port 10/100/1000 Gigabit Ethernet SPA on the
Cisco 7304 router. The forced keyword is not supported.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB.
Usage Guidelines The negotiationcommand is applicable to the Gigabit Ethernet interface of the Cisco 7200-I/O-GE+E and
interfaces on the 2-port 10/100/1000 Gigabit Ethernet SPA that are using fiber media. The
negotiationautocommand is used instead of the duplex and speed commands (which are used on Ethernet
and Fast Ethernet interfaces, and interfaces on the 2-port 10/100/1000 Gigabit Ethernet SPA that are using
RJ-45 media) to automatically configure the duplex and speed settings of the interfaces.
Cisco IOS Interface and Hardware Component Command Reference
767
loopback T1 interface through nrzi-encoding
negotiation
The negotiationforced command is used to configure the Gigabit Ethernet interface of the Cisco
7200-I/O-GE+E to be 1000/full-duplex only and to disable flow control. The negotiationforced command
is not supported by the 2-port 10/100/1000 Gigabit Ethernet SPA.
The Gigabit Ethernet interface of the Cisco 7200-I/O-GE+E and the interfaces on the 2-port 10/100/1000
Gigabit Ethernet SPA that are using fiber media are restricted to 1000 Mbps/full-duplex only. Autonegotiation
advertises and negotiates only to these values.
The nonegotiationauto command is used to disable the autonegotiation in the Cisco 3800 series routers. If
the speed is set to 1000 Mbps and full-duplex is set for the Gigabit Ethernet interface in small form-factor
pluggable (SFP) mode, then the autonegotiation is disabled (forced mode) using the nonegotiationauto
command.
However, for RJ-45 media the autonegotiation is always enabled for fixed speed and duplex setting. For SFP
mode of operation, the autonegotiation can be disabled by using the nonegotiationauto command.
Cisco uBR10012 Universal Broadband Router
Autonegotiation is enabled by default and can be disabled on the 5-port Gigabit Ethernet SPA. During
autonegotiation, advertisement for flow control, speed, and duplex occurs. If autonegotiation is disabled on
one end of a link, it must be disabled on the other end of the link. If one end of a link has autonegotiation
disabled and the other end of the link does not, the link does not come up properly on both ends. Flow control
is always negotiated when autonegotiation is enabled.
Note Autonegotiation is not supported on the 1-port 10-Gigabit Ethernet SPA in Cisco IOS Release 12.2(33)SCB.
Examples The following example shows how to enable the second interface (port 1) on a 2-port 10/100/1000
Gigabit Ethernet SPA for autonegotiation, where the SPA is installed in the bottom subslot (1) of
the modular services card (MSC), and the MSC is installed in slot 2 of the Cisco 7304 router:
Router(config)# interface gigabitethernet 2/1/1
Router(config-if)# media-type gbic
Router(config-if)# negotiation auto
The following example shows how to disable the second interface (port 1) on a 2-port 10/100/1000
Gigabit Ethernet SPA for autonegotiation, where the SPA is installed in the bottom subslot (1) of
the MSC, and the MSC is installed in slot 2 of the Cisco 7304 router:
Router(config)# interface gigabitethernet 2/1/1
Router(config-if)# no negotiation auto
Related Commands Command Description
show interfaces gigabitethernet Displays information about the Gigabit Ethernet interfaces.
Cisco IOS Interface and Hardware Component Command Reference
768
loopback T1 interface through nrzi-encoding
neighbor (VPLS)
neighbor (VPLS)
To specify the type of tunnel signaling and encapsulation mechanism for each Virtual Private LAN Service
(VPLS) peer, use the neighbor command in L2 VFI manual configuration mode. To disable a split horizon,
use the no form of this command.
neighbor remote-router-id vc-id {encapsulation encapsulation-type|pw-class pw-name}
[no-split-horizon]
no neighbor remote-router-id [vc-id]
Syntax Description remote-router-id Remote peer router identifier. The remote router ID can be any IP address, as long as
it is reachable.
vc-id 32-bit identifier of the virtual circuit between the routers.
encapsulation Specifies tunnel encapsulation.
encapsulation-type Specifies the tunnel encapsulation type; valid values are l2tpv3 and mpls.
pw-class Specifies the pseudowire class configuration from which the data encapsulation type is
taken.
pw-name Name of the pseudowire class.
no-split-horizon (Optional) Disables the Layer 2 split horizon forwarding in the data path.
Command Default Split horizon is enabled.
Command Modes L2 VFI manual configuration (config-vfi)
Command History Release Modification
12.2(18)SXF This command was introduced on the Supervisor Engine 720.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SRB This command was modified. This command was updated so that the remote
router ID need not be the LDP router ID of the peer.
Cisco IOS XE Release XE 3.7S This command was integrated into Cisco IOS XE Release XE 3.7S.
Usage Guidelines In a full-mesh VPLS network, keep split horizon enabled to avoid looping.
With the introduction of VPLS Autodiscovery, the remote router ID no longer needs to be the LDP router ID.
The address that you specify can be any IP address on the peer, as long as it is reachable. When VPLS
Autodiscovery discovers peer routers for the VPLS, the peer router addresses might be any routable address.
Examples This example shows how to specify the tunnel encapsulation type:
Cisco IOS Interface and Hardware Component Command Reference
769
loopback T1 interface through nrzi-encoding
neighbor (VPLS)
Device(config-vfi)# l2 vfi vfi-1 manual
Device(config-vfi)# vpn 1
Device(config-vfi)# neighbor 172.16.10.2 4 encapsulation mpls
This example shows how to disable the Layer 2 split horizon in the data path:
Device(config-vfi)# l2 vfi vfi-1 manual
Device(config-vfi)# vpn 1
Device(config-vfi)# neighbor 172.16.10.2 4 encapsulation mpls no-split-horizon
Related Commands Command Description
l2 vfi Creates a Layer 2 VFI.
manual
Cisco IOS Interface and Hardware Component Command Reference
770
loopback T1 interface through nrzi-encoding
network-clock (BITS)
network-clock (BITS)
To configure BITS port signaling types, use the network-clockcommand in global configuration mode. To
disable the BITS port signaling types, use the no form of this command.
network-clock slot slot bits number {2m|e1 [crc4]|j1 [esf]|t1 [{d4|esf
[{133ft|266ft|399ft|533ft|655ft}]}]}
no network-clock slot slot bits number {2m|e1 [crc4]|j1 [esf]|t1 [{d4|esf
[{133ft|266ft|399ft|533ft|655ft}]}]}
Syntax Description slot Selects the slot.
slot Specifies backplane slot number.
bits Specifies BITS port signaling types.
number Specifies the BITS port number starting from 0.
2m Specifies 2.048 MHz square wave signal type.
e1 Specifies E1 signal type.
j1 Specifies Japan J1 signal type.
t1 Specifies T1 signal type.
crc4 E1 CRC4 framing mode.
esf T1 ESF framing mode.
d4 T1 D4 framing mode.
133ft Line Build-Out Select 0 to 133 feet.
266ft Line Build-Out Select 0 to 266 feet.
399ft Line Build-Out Select 0 to 399 feet.
533ft Line Build-Out Select 0 to 533 feet.
655ft Line Build-Out Select 0 to 655 feet.
Command Default T1, ESF, 133ft
Command Modes Global configuration
Command History Release Modification
12.2(33)SRD1 This command was introduced on the Cisco series 7600 router for the 76-ES+XT-2TG3CXL
and 76-ES+XT-4TG3CXL.
Cisco IOS Interface and Hardware Component Command Reference
771
loopback T1 interface through nrzi-encoding
network-clock (BITS)
Usage Guidelines For 76-ES+XT-2TG3CXL and 76-ES+XT-4TG3CXL line cards, the BITS port number is always 0 because
there is only one BITS port.
Examples The following example shows how to configure the BITS port and 10GE interface as clock sources:
Router(config)# network-clock select 2 slot 1 ?
bits Network clock source is bits interface
global Configure the source as global
local Configure the source as local
<cr>
Router(config)# network-clock select 2 slot 1 bits 0 ?
global Configure the source as global
local Configure the source as local
<cr>
Router(config)# network-clock select 3 ?
controller Select the controller that should source the clock
interface Select the interface that should source the clock
slot Select the slot that should source the clock
system Select the system clock as source
Router(config)# network-clock select 3 interface TenGigabitEthernet 1/1
The following example shows how to configure the BITS port signal type and framing mode:
Router(config)# network-clock slot 1 bits 0 ?
2m 2.048MHz square wave signal type
e1 E1 signal type
j1 Japan J1 signal type
t1 T1 signal type
Router(config)# network-clock slot 1 bits 0 t1 ?
d4 T1 D4 framing mode
esf T1 ESF framing mode
Router(config)# network-clock slot 1 bits 0 t1 d4 ?
133ft Line Build-Out Select 0 to 133 feet
266ft Line Build-Out Select 133 to 266 feet
399ft Line Build-Out Select 266 to 399 feet
533ft Line Build-Out Select 399 to 533 feet
655ft Line Build-Out Select 533 to 655 feet
Router(config)# network-clock slot 1 bits 0 j1 ?
esf J1 ESF framing mode
Router(config)# network-clock slot 1 bits 0 e1 ?
crc4 E1 CRC4 framing mode
Router(config)# network-clock slot 1 bits 0 2m ?
<cr>
Related Commands Command Description
show network-clocks Displays the current configured and active network clock sources.
Cisco IOS Interface and Hardware Component Command Reference
772
loopback T1 interface through nrzi-encoding
network-clock (BITS)
Command Description
show platform hardware network-clocks Displays network clocks for an ES+ line card.
Cisco IOS Interface and Hardware Component Command Reference
773
loopback T1 interface through nrzi-encoding
network-clock clear lockout
network-clock clear lockout
To clear the lock-out on a clock source, use the network-clock clear lockout command in the privileged EXEC
mode.
Cisco 7600 Series Routers
network-clock clear lockout interface slot/card/port|external slot/card/port 2048K|e1 {cas|crc4|fas}
Cisco ASR 1000 Series Routers
network-clock clear lockout external {slot/card/port|R0|R1} T1 {d4|esf|sf}
Syntax Description external Specifies external interface (BITS/SSU/GPS).
slot/card/port Slot number/Card number/Port number.
R0 Specifies the network synchronization mcprp RP0 bits for source slot.
R1 Specifies the network synchronization mcprp RP1 bits for source slot.
T1 Specifies the T1 signal mode input.
d4 Specifies the D4 super frame signal mode.
esf Specifies the extended super frame signal mode.
sf Specifies the super frame signal mode.
2048k Specifies the option 1 2048KHz on the BITS/SSU port.
e1 Specifies the E1 signal mode.
cas Specifies the E1 Channel Associated Signal (CAS) mode.
crc4 Specifies the E1 with crc4 signal mode.
fas Specifies the E1 Frame Alignment Signal mode.
Command Default No default values are available.
Command Modes Privileged EXEC (#)
Command History Release Modification
Cisco IOS XE Release 3.2.0S This command was integrated into Cisco ASR 1000 Series routers.
Cisco IOS Release 12.2(33)SRE This command was introduced on the Cisco 7600 Series routers.
Examples The following example shows how to clear the lock out on a clock source:
Cisco IOS Interface and Hardware Component Command Reference
774
loopback T1 interface through nrzi-encoding
network-clock clear lockout
C7600(config)# network-clock clear lockout external 0/0/0 e1 2048k
ASR1000(config)# network-clock clear lockout external 0/0/0 t1 esf
Cisco IOS Interface and Hardware Component Command Reference
775
loopback T1 interface through nrzi-encoding
network-clock hold-off global
network-clock hold-off global
To configure the hold-off time, use the network-clock hold-off global command in the global configuration
mode.
network-clock hold-off timer global
Syntax Description timer Hold-off time, in milliseconds. The range is from 50 to 10000. The default is 300. If you do not want
the hold off time, set the timer value to 0.
global Configures the hold-off timer globally.
Command Default The default value is 300 milliseconds on Cisco ASR 901 Series Aggregation Services Routers.
Command Modes Global configuration (config)
Command History Release Modification
Cisco IOS XE Release 3.2.0S This command was integrated into Cisco ASR 1000 Series routers.
Cisco IOS Release 12.2(33)SRE This command was introduced on the Cisco 7600 Series routers.
15.1(2)SNG This command was implemented on Cisco ASR 901 Series Aggregation
Services Routers.
Usage Guidelines The hold-off timer can also be configured in the interface configuration mode. It displays a warning message
for values below 300 milliseconds and above 1800 milliseconds.
Examples The following example shows how to configure the hold-off timer in the global configuration mode:
Router(config)# network-clock hold-off 50 global
Cisco IOS Interface and Hardware Component Command Reference
776
loopback T1 interface through nrzi-encoding
network-clock input-source
network-clock input-source
To assign a controller to be the primary or secondary clock source use the network-clock input-sourcepriority
command. To set the controller to be a primary clock source, set the value of priority for the input source to
be low value, such as 2, (a low value indicates a high priority). To remove the clock source, use the no form
of this command
network-clock input-source priority controller t1/e1slot/bay/port
no network-clock input-source priority controller t1/e1 slot/bay/port
Syntax Description
network-clock input-source priority The network-clock input-source priority command selects the
configured controller clock as the backplane clock source.
controller t1/e1 Sets the controller into T1 or E1 signal mode.
priority Sets the controller to be a primary clock source.
slot/bay/port Specifies slot, bay and port number
Command Modes Global configuration
Command History Release Modification
XE 3.18SP Support for this command was introduced on NCS 4200 Series.
XE Everest This command was introduced on the Cisco ASR 900 Series Routers and Cisco NCS 4200
16.5.1 Series.
Usage Guidelines This command is used to assign controller to be the primary or secondary clock source.
Examples
enable
configure terminal
network-clock input-source 1controller E1/T10/5/0
Cisco IOS Interface and Hardware Component Command Reference
777
loopback T1 interface through nrzi-encoding
network-clock set lockout
network-clock set lockout
To lock out a clock source, use the network-clock set lockout command in the privileged EXEC mode. On
the Cisco ASR 901 Series Aggregation Services Routers, use the network-clock clear lockout command
to remove the lockout in global configuration mode.
Cisco 7600 Series Routers
{network-clock set lockout internal slot/card/port|external slot/card/port 2048K|e1 {cas|crc4|fas}}
Cisco ASR 1000 Series Routers
network-clock set lockout external {slot/card/port|R0|R1} T1 {d4|esf|sf}
Cisco ASR 901 Cisco ASR 901 Series Aggregation Services Routers
network-clock set lockout {interface interface-name slot/port |external slot/card/port}
network-clock clear lockout
Syntax Description external Specifies external interface (BITS/SSU/GPS).
slot/card/port Slot number/card number/port number.
R0 Specifies the network synchronization mcprp RP0 bits for the source slot.
R1 Specifies the network synchronization mcprp RP1 bits for the source slot.
T1 Specifies the T1 signal mode input.
d4 Specifies the D4 super frame signal mode.
esf Specifies the extended super frame signal mode.
sf Specifies the super frame signal mode.
2048k Specifies the option 1 2048KHz on the BITS/SSU port.
e1 Specifies the E1 signal mode.
cas Specifies the E1 Channel Associated Signal (CAS) mode.
crc4 Specifies the E1 with crc4 signal mode.
fas Specifies the E1 Frame Alignment Signal mode.
interface Specifies the interface.
interface-name Specifies the interface name.
Command Default No default values are available.
Command Modes • Global configuration (config)
• Privileged EXEC (#)
Cisco IOS Interface and Hardware Component Command Reference
778
loopback T1 interface through nrzi-encoding
network-clock set lockout
Command History Release Modification
Cisco IOS XE Release 3.2.0S This command was integrated into Cisco ASR 1000 Series routers.
Cisco IOS Release 12.2(33)SRE This command was introduced on the Cisco 7600 Series routers.
15.1(2)SNG This command was implemented on Cisco ASR 901 Series Aggregation
Services Routers. The interface-name argument was added.
Usage Guidelines The network-clock set lockout command locks out a clock source. A locked out clock source is not selected
for SyncE.
To clear the lock-out on a source, use the network-clock clear lockout command.
Note Lock-out takes precedence over force switch, and force switch overrides the manual switch.
Examples The following example shows how to lock out a clock source:
C7600(config)# network-clock set lockout external 2/0/0 e1 cas
ASR1000(config)# network-clock set lockout external R0 t1 esf
This example shows how to lockout the clock source on a Cisco ASR 901 Series Aggregation Services
Router.
Router(config)# network-clock set lockout interface GigabitEthernet 0/1
Cisco IOS Interface and Hardware Component Command Reference
779
loopback T1 interface through nrzi-encoding
network-clock synchronization ssm option
network-clock synchronization ssm option
To configure the equipment to work in a synchronization network, use the network-clock synchronization
ssm option command in the global configuration mode. To unconfigure the network-clock synchronization
option, use the no form of this command.
network-clock synchronization ssm option option_id {1|2 {GEN1|GEN2}}
no network-clock synchronization ssm option option_id {1|2 {GEN1|GEN2}}
Syntax Description option_id The option_id can have the following values:
• 1 - Refers to the synchronization networks design for Europe. This is the default value.
(E1 framings are compatible with this option).
• 2 - Refers to the synchronization networks design for the U.S. (T1 framings are compatible
with this option).
GEN1 If option 2 is configured, then it specifies the generation ID as 1.
GEN2 If option 2 is configured, then it specifies the generation ID as 2.
Command Default No default values are available.
Cisco ASR 901 Series Aggregation Services Routers
Option 1.
Command Modes Global configuration (config)
Command History Release Modification
Cisco IOS XE Release 3.2S This command was integrated into Cisco ASR 1000 Series routers.
Cisco IOS Release 12.2(33)SRE This command was introduced on the Cisco 7600 Series routers.
15.1(2)SNG This command was implemented on Cisco ASR 901 Series Aggregation
Services Routers.
Usage Guidelines Network-clock configurations that are not common between options need to be configured again.
On Cisco ASR 901 Series Aggregation Services Routers, the default value for the option_id keyword is 1. If
you set the value to 2, you must specify the generation ID.
Examples The following example shows how the network-clocksynchronizationssmoption command is used
to configure the equipment to work in a synchronization network:
Router> enable
Router# configure terminal
Router(config)# network-clock synchronization automatic
Router(config)# network-clock synchronization ssm option 2 GEN1
Cisco IOS Interface and Hardware Component Command Reference
780
loopback T1 interface through nrzi-encoding
network-clock synchronization ssm option
Related Commands Command Description
network-clock eec Configures the clocking system hardware with the desired parameters.
Cisco IOS Interface and Hardware Component Command Reference
781
loopback T1 interface through nrzi-encoding
network-clock synchronization automatic
network-clock synchronization automatic
To enable the network clock synchronization selection process, use the network-clock synchronization
automatic command in the global configuration mode. To disable the network clock synchronization selection
process, use the no form of this command.
network-clock synchronization automatic
no network-clock synchronization automatic
Syntax Description This command has no arguments or keywords.
Command Default No default values are available.
Command Modes Global configuration (config)
Command History Release Modification
Cisco IOS XE Release 3.2.0S This command was integrated into Cisco ASR 1000 Series routers.
Cisco IOS Release 12.2(33)SRE This command was introduced on the Cisco 7600 Series routers.
Usage Guidelines This command disables the Cisco-specific network-clock process, and turns on G.781-based automatic clock
synchronization selection process.
Examples The following example shows how the network-clock synchronization automatic command is used
to enable the network clock synchronization selection process:
Router(config)# network-clock synchronization automatic
Cisco IOS Interface and Hardware Component Command Reference
782
loopback T1 interface through nrzi-encoding
network-clock synchronization mode QL-enabled
network-clock synchronization mode QL-enabled
To configure the automatic selection process for the QL-enabled mode, use the network-clock synchronization
mode QL-enabled command in the global configuration mode.
network-clock synchronization mode QL-enabled
Syntax Description This command has no arguments or keywords.
Command Default No default values are available.
Command Modes Global configuration (config)
Command History Release Modification
Cisco IOS XE Release 3.2.0S This command was integrated into Cisco ASR 1000 Series routers.
Cisco IOS Release 12.2(33)SRE This command was introduced on the Cisco 7600 Series routers.
15.1(2)SNH This command was introduced in Cisco ASR 901 Aggregation Services
Routers.
Usage Guidelines The automatic selection process for the QL-enabled mode is successful only if the Synchronous Ethernet
interfaces are capable of sending Synchronization Status Messages (SSM).
Examples The following example shows how to configure network clock synchronization (QL-enabled mode)
in the global configuration mode:
Router(config)# network-clock synchronization mode QL-enabled
Cisco IOS Interface and Hardware Component Command Reference
783
loopback T1 interface through nrzi-encoding
network-clock quality-level
network-clock quality-level
To configure the Quality Level (QL) value for the Synchronization Status Messages (SSM) on a BITS port,
use the network-clock quality-level command in the global configuration mode.
Cisco 7600 Series Routers
{network-clock quality-level {rx|tx} {QL-PRC|QL-SSU-A|QL-SSU-B|QL-SEC|QL-DNU} external
slot/card/port 2048K|e1 {cas|crc4|fas}}
Cisco ASR 1000 Series Routers
network-clock quality-level {rx|tx}
{QL-PRS|QL-STU|QL-ST2|QL-TNC|QL-ST3|QL-ST3E|QL-SMC|QL-ST4|QL-DUS} external
{slot/card/port|R0|R1} T1 {d4|esf|sf}
Syntax Description rx Specifies the received QL. The following values are available on Cisco ASR 1000 Series
routers for the QL receive:
• QL-PRS
• QL-STU
• QL-ST2
• QL-ST3
• QL-SMC
• QL-ST4
• QL-DUS
The following values are available on Cisco 7600 Series routers for the QL receive:
• QL-PRC
• QL-SSU-A
• QL-SSU-B
• QL-SEC
• QL-DNU
Cisco IOS Interface and Hardware Component Command Reference
784
loopback T1 interface through nrzi-encoding
network-clock quality-level
tx Specifies the trasmitted QL. The following values are available on Cisco ASR 1000 Series
routers for the QL transmit:
• QL-PRS
• QL-STU
• QL-ST2
• QL-ST3
• QL-SMC
• QL-ST4
• QL-DUS
The following values are available on Cisco 7600 Series routers for the QL transmit:
• QL-PRC
• QL-SSU-A
• QL-SSU-B
• QL-SEC
• QL-DNU
external Specifies the external interface (BITS/SSU/GPS).
slot /card/port Slot number/Card number/Port number.
R0 Specifies the network synchronization RP0 bits for source slot.
R1 Specifies the network synchronization RP1 bits for source slot.
T1 Specifies the T1 signal mode output.
d4 Specifies the D4 super frame signal mode.
esf Specifies the extended super frame signal mode.
sf Specifies the super frame signal mode.
2048k Specifies the option 1 2048KHz on the BITS/SSU port.
e1 Specifies the E1 signal mode.
cas Specifies the E1 Channel Associated Signal (CAS) mode.
crc4 Specifies the E1 with crc4 signal mode.
fas Specifies the E1 Frame Alignment Signal mode.
Command Default No default values are available.
Cisco IOS Interface and Hardware Component Command Reference
785
loopback T1 interface through nrzi-encoding
network-clock quality-level
Command Modes Global configuration (config)
Command History Release Modification
Cisco IOS XE Release 3.2.0S This command was integrated into Cisco ASR 1000 Series routers.
Cisco IOS Release 12.2(33)SRE This command was introduced on the Cisco 7600 Series routers.
Examples The following example shows how to configure network-clock quality-level command in the global
configuration mode:
C7600(config)# network-clock quality-level rx ql-prc external 0/0/0 e1 cas
ASR1000(config)# network-clock quality-level tx QL-ST2 external R0 t1 sf
Cisco IOS Interface and Hardware Component Command Reference
786
loopback T1 interface through nrzi-encoding
no channelized
no channelized
To configure the T3 controller for unchannelized mode, use thenochannelizedconfiguration controller
command. To configure channelized mode, use the channelizedform of this command.
channelized
no channelized
Syntax Description This command has no arguments or keywords.
Command Default MTU size is set to 4470.
Command Modes Configuration controller
Command History Release Modification
12.0(14)S This command was introduced.
12.1(5a)E This command was integrated into Cisco IOS Release 12.1(5a)E.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.
12.2(14)S This command was integrated into Cisco IOS Release 12.2(14)S.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use the no channelized configuration controller command to configure the T3 controller for unchannelized
mode. When you configure the PA-MC-2T3+ on a Cisco 7500 series router with the no channelized command,
the MTU size is set to 4470. In channelized mode, the default MTU size is 1500. The change in MTU sizes
will cause a memory recarve and CBus complex to occur, disrupting all traffic on the router for several minutes.
The following message will be displayed when switching between channelized and unchannelized modes on
a Cisco 7500 series router:
Change to subrate mode will cause cbus complex reset. Proceed? [yes/no]:
Y
Type Y for “yes” at the end of the warning. At the prompt, type ^Z to exit. You will exit configuration mode
and enter unchannelized mode.
Examples The following example configures unchannelized mode on a PA-MC-2T3+ in port adapter slot 1 of
a VIP2 or VIP4 in a Cisco 7500 series router:
configure terminal
controller T3 1/1/0
no channelized
Cisco IOS Interface and Hardware Component Command Reference
787
loopback T1 interface through nrzi-encoding
no channelized
Change to subrate mode will cause cbus complex reset. Proceed? [yes/no]: Y
^Z
Cisco IOS Interface and Hardware Component Command Reference
788
loopback T1 interface through nrzi-encoding
nrzi-encoding
nrzi-encoding
To enable nonreturn-to-zero inverted (NRZI) line-coding format, use the nrzi-encodingcommand in interface
configuration mode. To disable this capability, use the no form of this command.
nrzi-encoding [mark]
no nrzi-encoding
Syntax Description mark (Optional) Specifies that NRZI mark encoding is required on the PA-8T and PA-4T+ synchronous
serial port adapters on Cisco 7200 and Cisco 7500 series routers . If the mark keyword is not
specified, NRZI space encoding is used.
Command Default Disabled
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
11.3 The mark keyword was added for the Cisco 7200 series routers and Cisco 7500 series routers.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines All FSIP, PA-8T, and PA-4T+ interface types support nonreturn-to-zero (NRZ) and NRZI format. This is a
line-coding format that is required for serial connections in some environments. NRZ encoding is most
common. NRZI encoding is used primarily with EIA/TIA-232 connections in IBM environments.
Examples The following example configures serial interface 1 for NRZI encoding:
Router(config)# interface serial 1
Router(config-if)# nrzi-encoding
The following example configures serial interface 3/1/0 for NRZI mark encoding:
Router(config)# interface serial 3/1/0
Router(config-if)# nrzi-encoding mark
Cisco IOS Interface and Hardware Component Command Reference
789
loopback T1 interface through nrzi-encoding
nrzi-encoding
Cisco IOS Interface and Hardware Component Command Reference
790
O through R
• outbound data-pid, on page 794
• outbound data-rate, on page 795
• outbound frequency, on page 796
• outbound id, on page 797
• outbound modulation-type, on page 798
• outbound sync ip address, on page 799
• outbound viterbi-rate, on page 800
• output, on page 801
• overhead c2, on page 803
• overhead j0, on page 804
• overhead j1, on page 806
• overhead tunnel, on page 808
• overhead s1s0, on page 810
• password (satellite initial configuration), on page 811
• payload-compression, on page 812
• payload-size dejitter-buffer, on page 813
• payload-size, on page 815
• physical-interface, on page 820
• physical-layer, on page 821
• platform console, on page 823
• platform cwan acl software-switched, on page 824
• platform enable controller mediaType , on page 825
• platform hardware throughput level, on page 826
• platform ip features sequential, on page 829
• platform punt-keepalive, on page 831
• platform scp retry interval, on page 833
• platform smart-sfp, on page 834
• platform time-source, on page 836
• platform trace boottime process forwarding-manager module interfaces, on page 838
• pm fec threshold, on page 840
• pm optics report, on page 841
• pm otn report, on page 842
• pm optics threshold, on page 845
Cisco IOS Interface and Hardware Component Command Reference
791
O through R
• pm otn threshold, on page 846
• port (interface), on page 847
• port access-map, on page 848
• port-channel hash-distribution, on page 850
• port-channel load-balance, on page 851
• port-channel load-balance (interface), on page 854
• port-channel load-balance mpls, on page 856
• port-channel load-balance weighted rebalance, on page 858
• port-channel load-balancing vlan-manual, on page 859
• port-channel load-defer, on page 861
• port-channel min-links, on page 863
• port-channel per-module load-balance, on page 864
• port-channel port load-defer, on page 865
• port-channel standalone-disable, on page 867
• pos ais-shut, on page 868
• pos delay triggers, on page 869
• pos flag, on page 872
• pos flag s1-byte rx-communicate, on page 874
• pos flag s1-byte tx, on page 875
• pos framing, on page 876
• pos report, on page 877
• pos scramble-atm, on page 879
• pos threshold, on page 881
• power inline, on page 883
• power enable, on page 888
• power inline, on page 889
• power redundancy-mode, on page 894
• ppp link, on page 895
• ppp loopback no-backoff, on page 897
• ppp multilink mrru, on page 899
• pri-group, on page 903
• priority1, on page 904
• priority2, on page 905
• proactive enable, on page 906
• proactive rvrt-threshold, on page 907
• proactive rvrt-window, on page 908
• proactive trig-threshold , on page 909
• protection-group, on page 911
• protection-group [working | protect], on page 912
• protocol gre, on page 913
• ptp clock, on page 914
• pulse-time, on page 915
• rate, on page 917
• recovered-clock, on page 919
• redundancy, on page 920
• redundancy all-active replicate, on page 925
Cisco IOS Interface and Hardware Component Command Reference
792
O through R
• redundancy force-switchover, on page 926
• redundancy handover, on page 929
• redundancy stateful, on page 931
• remote command, on page 932
• remote-span, on page 934
• remote login, on page 935
• reset (alarm-interface), on page 937
• retry, on page 938
• ring-speed, on page 939
• rj45-auto-detect-polarity, on page 940
Cisco IOS Interface and Hardware Component Command Reference
793
O through R
outbound data-pid
outbound data-pid
Note Effective with Cisco IOS Release 12.4(2)T, this command is superseded by the outboundpidmanagement
command. The outbounddata-pid command is still available, but use of the outboundpidmanagement
command is recommended.
To specify the outbound data packet identification (PID) number, use the outbounddata-pid command in
satellite initial configuration mode. To remove the PID number configuration, use the no form of this command.
outbound data-pid number
no outbound data-pid
Syntax Description number Packet identification (PID) number in the range from 1 to 8190.
Command Default No default behavior or values
Command Modes Satellite initial configuration
Command History Release Modification
12.3(14)T This command was introduced.
12.4(2)T This command was superseded by theoutboundpidmanagement command.
Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your satellite
service provider instructs you to perform the satellite initial configuration and provides all necessary parameter
values.
Examples The following example shows how to specify the outbound data PID number:
Router(sat-init-config)# outbound data-pid 3000
Cisco IOS Interface and Hardware Component Command Reference
794
O through R
outbound data-rate
outbound data-rate
To specify the VSAT data rate, use the outbounddata-rate command in satellite initial configuration mode.
To remove the data rate configuration, use the no form of this command.
outbound data-rate rate
no outbound data-rate
Syntax Description rate VSAT data rate in the range from 250000 to 73000000 bits per second.
Command Default No default behavior or values
Command Modes Satellite initial configuration
Command History Release Modification
12.3(14)T This command was introduced.
Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your satellite
service provider instructs you to perform the satellite initial configuration and provides all necessary parameter
values.
Examples The following example shows how to specify the VSAT data rate:
Router(sat-init-config)# outbound data-rate 450000
Cisco IOS Interface and Hardware Component Command Reference
795
O through R
outbound frequency
outbound frequency
To specify the VSAT outbound frequency, use the outboundfrequency command in satellite initial
configuration mode. To remove the outbound frequency configuration, use the no form of this command.
outbound frequency frequency
no outbound frequency
Syntax Description frequency VSAT outbound frequency in the range from 950000 to 2150000 kilohertz.
Command Default No default behavior or values
Command Modes Satellite initial configuration
Command History Release Modification
12.3(14)T This command was introduced.
Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your satellite
service provider instructs you to perform the satellite initial configuration and provides all necessary parameter
values.
Examples The following example shows how to configure the VSAT outbound frequency:
Router(sat-init-config)# outbound frequency 950000
Cisco IOS Interface and Hardware Component Command Reference
796
O through R
outbound id
outbound id
To specify the VSAT outbound ID, use the outboundidcommand in satellite initial configuration mode. To
remove the outbound ID configuration, use the no form of this command.
outbound id number
no outbound id
Syntax Description number ID number in the range from 0 to 255.
Command Default No default behavior or values
Command Modes Satellite initial configuration
Command History Release Modification
12.3(14)T This command was introduced.
Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your satellite
service provider instructs you to perform the satellite initial configuration and provides all necessary parameter
values.
Examples The following example shows how to configure the VSAT outbound ID:
Router(sat-init-config)# outbound id 95
Cisco IOS Interface and Hardware Component Command Reference
797
O through R
outbound modulation-type
outbound modulation-type
To specify the VSAT modulation type, use the outboundmodulation-type command in satellite initial
configuration mode. To remove the VSAT modulation type configuration, use the no form of this command.
outbound modulation-type {DVB|TURBO_QPSK|8PSK}
no outbound modulation-type
Syntax Description DVB Digital Video Broadcasting for satellite.
TURBO_QPSK Turbo-coded quadrature Phase Shift Keying.
8PSK Phase Shift Keying.
Command Default No default behavior or values
Command Modes Satellite initial configuration
Command History Release Modification
12.3(14)T This command was introduced.
Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your satellite
service provider instructs you to perform the satellite initial configuration and provides all necessary parameter
values.
Examples The following example shows how to configure the VSAT modulation type:
Router(sat-init-config)# outbound modulation-type DVB
Cisco IOS Interface and Hardware Component Command Reference
798
O through R
outbound sync ip address
outbound sync ip address
To specify the outbound synchronization IP address, use the outboundsyncipaddress command in satellite
initial configuration mode. To remove the outbound synchronization IP address configuration, use the no
form of this command.
outbound sync ip address address
no outbound sync ip address
Syntax Description address Outbound synchronization IP address.
Command Default No default behavior or values
Command Modes Satellite initial configuration
Command History Release Modification
12.3(14)T This command was introduced.
Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your satellite
service provider instructs you to perform the satellite initial configuration and provides all necessary parameter
values.
Examples The following example shows how to configure the outbound synchronization IP address:
Router(sat-init-config)# outbound sync ip address 10.2.2.2
Cisco IOS Interface and Hardware Component Command Reference
799
O through R
outbound viterbi-rate
outbound viterbi-rate
To specify the VSAT Viterbi code rate, use the outboundviterbi-rate command in satellite initial configuration
mode. To return to the default rate, use the no form of this command.
outbound viterbi-rate rate
no outbound viterbi-rate
Syntax Description rate Viterbi code rate. It can be one of the following values:
• 1/2
• 1/4
• 2/3
• 3/4
• 3/4(2.05)
• 3/4(2.1)
• 3/4(2.6)
• 5/6
• 6/7
• 7/8
• 8/9
Command Default No default behavior or values
Command Modes Satellite initial configuration
Command History Release Modification
12.3(14)T This command was introduced.
Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your satellite
service provider instructs you to perform the satellite initial configuration and provides all necessary parameter
values.
Examples The following example shows how to configure the VSAT Viterbi code rate:
Router(sat-init-config)# outbound viterbi-rate 3/4(2.6)
Cisco IOS Interface and Hardware Component Command Reference
800
O through R
output
output
To enable out put of time of day messages using a 1PPS interface, use the output command in global
configuration mode. To disable PTP output, use the no form of this command.
output 1pps slot/bay [offset offset-value [negative]] [pulse-width pulse-amount {ns|us|ms}]
no output 1pps slot/bay [offset offset-value [negative]] [pulse-width pulse-amount {ns|us|ms}]
Syntax Description 1pps Configures the device to send 1 packet per second (1PPS) time of day messages using the
RS422 port or 1PPS port. You can select 1PPS output with or without selecting a timing
port.
slot Slot of the 1PPS interface.
bay Bay of the 1PPS interface.
offset (Optional) Specifies an offset to compensate for a known phase error such as network
asymmetry.
offset-value Amount of offset in nanoseconds. The range is from 0 to 500,000,000.
negative Specifies a negative offset 1PPS output value.
pulse-width (Optional) Specifies a pulse width value.
pulse-amount Amount of the pulse width. The range is from 1 to 4096. For 1PPS output using the RS422
port, you must specify a value of at least 2 ms.
ns Specifies a pulse width value in nanoseconds.
us Specifies a pulse width value in microseconds.
ms Specifies a pulse width value in milliseconds.
Command Default Time of day message output is not enabled.
Command Modes Global configuration (config)
Command History Release Modification
12.2(31)SB2 This command was introduced.
15.0(1)S This command was integrated into Cisco IOS Release 15.0(1)S.
15.1(2)SNG This command was implemented on the Cisco ASR 901 Series Aggregation Services Router.
Usage Guidelines If you want to provide output frequency clock, configure this command in PTP slave mode. This command
only applies to platforms that have 1PPS ports.
Examples The following example shows how to configure output clocking:
Cisco IOS Interface and Hardware Component Command Reference
801
O through R
output
Device> enable
Device# configure terminal
Device(config)# ptp clock ordinary domain 0
Device(config-ptp-clk)# output 1pps 3/0 offset 10 pulse-width 1000 ms
Device(config-ptp-clk)# end
The following example shows the time of day (ToD) configuration on the 1588V2 slave and
corresponding output:
Device> enable
Device# config terminal
Device(config)# ptp clock ordinary domain 0
Device(config-ptp-clk)# tod 3/3 cisco
Device(config-ptp-clk)# output 1pps 0 250 ns
Device(config-ptp-clk)# clock-port SLAVE slave
Related Commands Command Description
input Enables PTP input clocking using the 1.544 Mhz, 2.048 Mhz, or 10 Mhz timing interface or
phase using the 1PPS or RS-422 interface.
Cisco IOS Interface and Hardware Component Command Reference
802
O through R
overhead c2
overhead c2
To set the SONET path overhead bytes in the frame header to a specific standards requirement or to ensure
interoperability with equipment from another vendor, use the overhead command in SONET path configuration
mode. To remove the setting of the SONET path overhead bytes from the configuration file and restore the
system to its default condition, use the no form of this command.
overhead c2 value
no overhead c2 value
Syntax Description Syntax Description
c2 value Configures the C2 byte in the Path OverHead (POH) to indicate the contents of the payload inside
the frame. C2 byte is to communicate the payload type that the SONET Framing OverHead (FOH)
encapsulates.
Command Modes Controller configuration
Command History Release Modification
XE 3.18SP Support for this command was introduced on NCS 4200 Series.
XE Everest This command was introduced on the Cisco ASR 920 Routers and Cisco NCS 4200 Series.
16.5.1
Usage Guidelines This command is used to configure C2 flag as the path overhead.
Examples The following example shows the configuration of C2 flag:
enable
configure terminal
controller MediaType 0/5/0
mode sonet
controller sonet 0/5/0
sts-1 1
overhead c2 10
end
Related Commands Command Description
controller sonet Configures the SONET mode.
show controller sonet Displays SONET controller configuration.
Cisco IOS Interface and Hardware Component Command Reference
803
O through R
overhead j0
overhead j0
To specify the Regenerator Section (RS) Trace identifier (J0), use the overheadj0 command in controller
configuration mode. To restore the default value, use the no form of this command.
overhead j0 {transmit|receive} string
no overhead j0 {transmit|receive} string
Syntax Description For NCS 4200 Series:
overhead j0 {expected | tx} [length number | tracebuffer string]
transmit Specifies that the string argument is sent on the transmit line.
receive Specifies that the configured string argument is matched with the string received from
a peer.
string Value in the range from 0 to 255 that is converted into character format and embedded
in a 16-byte frame. The default is 1.
expected Configures the expected trace identifier of the controller.
tx Configures the packets transmitted.
length number Specifies the length of the expected trace identifier.
tracebuffer string Configures the SONET path trace buffer. Enters the ACSII text for the controller.
Command Default The default value is 1, and no peer authentication is performed.
Command Modes Controller configuration
Command History Release Modification
12.0(17)S This command was introduced.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T, and the transmit and receive
keywords were added.
XE 3.18SP Support for this command was introduced on NCS 4200 Series.
Usage Guidelines RS trace is a maintenance feature of SONET. One byte (J0) of the Section overhead associated with each
SONET frame is used to carry information identifying the transmitting equipment.
Use this command for peer authentication and continuity testing between two STM-1 optical peers. If the
authentication string sent by the originating peer does not match the configured string on the receiving peer,
the SONET controller will not come up on the receiving peer. Alarm logs on the originating peer will show
that it has RS-Trace Identifier Mismatch (RS-TIM).
For NCS 4200 Series, use this command to configure line and section overhead of SONET line.
Cisco IOS Interface and Hardware Component Command Reference
804
O through R
overhead j0
Examples The following example shows how to configure J0 overhead in both the transmit and receive directions
on a STM-1 trunk card:
Router(config)# controller sonet 2/0
Router(config-controller)# overhead j0 transmit 22
Router(config-controller)# overhead j0 receive 34
The following example shows how to set the RS Trace identifier to 82:
Router(config-controller)# overhead j0 transmit 82
Examples For NCS 4200 Series, the following example shows how to configure line and section overhead:
enable
configure terminal
controller Mediatype 0/5/0
controller sonet 0/5/0
overhead j0 tx length 1-byte
end
Related Commands Command Description
controller sonet Configures the SONET mode.
show controller sonet Displays SONET controller configuration.
Cisco IOS Interface and Hardware Component Command Reference
805
O through R
overhead j1
overhead j1
To configure the message length and the message text of the High Order Path Trace identifier (J1), use the
overheadj1 command in controller configuration or path configuration mode. To restore the default value,
use the no form of this command.
overhead j1 length {16|64} {transmit-message|receive-message} string
no overhead j1 length {16|64} {transmit-message|receive-message} string
Syntax Description For NCS 4200 Series, use the following command:
overhead j1 [expected | tx] [length | message]
length Specifies the length of the authentication string argument.
16 Specifies that the length of the authentication stringis 16 characters. The STM-1 trunk
card supports a string length of 16.
64 Specifies that the length of the authentication stringis 64 characters.
transmit-message Specifies that the string argument is sent on the transmit line.
receive-message Specifies that the configured string argument is matched with the string received from
a peer.
string Combination of characters and numbers for the specified length value.
tx Configures the packets transmitted.
expected Configures the expected trace identifier of the controller.
Command Default The default message length is 16 for SDH framing and 64 for SONET framing. No peer authentication is
performed.
Command Modes Controller configuration
Path configuration
Command History Release Modification
12.0(17)S This command was introduced.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T, and the transmit-message and
receive-message keywords were added.
Usage Guidelines Path trace is a maintenance feature of SONET/SDH. One byte (J1) of the Path overhead associated with each
path in the SONET/SDH frame is used to carry information identifying the originating Path Terminating
Equipment (PTE).
Where you configure the Path Trace identifier depends on the framing (SDH or SONET) and the AUG
mapping. In SDH with AU-4 mapping, the Path Trace identifier is configured at the SONET controller level.
In SDH with AU-3 mapping or in SONET framing, the Path Trace identifier is configured at the path level.
Cisco IOS Interface and Hardware Component Command Reference
806
O through R
overhead j1
In accordance with SONET and SDH standard requirements, the Path Trace message you enter is manipulated
as follows:
• If you select a message length of 16, the actual message length can be up to 15 characters. An additional
byte, prepended to the message, contains the result of a CRC7 calculated on the message. If the actual
message text is fewer than 15 characters, the message text is padded to its full length with NULL
characters.
• If you select a message length of 64 and the actual message text is fewer than 62 characters, the message
text is padded with NULL characters. The last two byte positions, 63 and 64, are always CR/LF
(0x0D/0x0A).
Use this command for peer authentication and continuity testing between two STM-1 optical peers. If the
authentication string sent by the originating peer does not match the configured string on the receiving peer,
the Path (and all E1 controllers within the path) will not come up on the receiving peer. Alarm logs on the
originating peer will show that it has High Order Path-Trace Identifier Mismatch (HP-TIM).
Examples The following example shows J1 configuration in SDH framing with AU-4 AUG mapping. The
overheadj1command sets the message length to 16, and specifies the message text as metro_SF:
Router(config-controller)# au-4 1
Router(config-ctrlr-au4)# overhead j1 length 16 transmit-message metro_SF
The following example shows J1 configuration in SDH framing with AU-3 AUG mapping. The
overheadj1 command sets the message length to 16, and specifies the message text as metro_LA:
Router(config)# controller sonet 4/0Router(config-controller)# au-3 3
Router(config-ctrlr-au3)# overhead j1 length 16 receive-message metro_L
The following example shows J1 configuration in SONET framing in STS-1 mode. The overheadj1
command sets the message length to 64, and specifies the message text:
Router(config)# controller sonet 4/0
Router(config-controller)# sts-1 3
Router(config-ctrlr-sts1)# overhead j1 length 64 transmit-message metro_washington
gsr_0057/4/3
The following example shows how to configure j1 overhead in both the transmit and receive directions:
Router(config)# controller sonet 2/0
Router(config-controller)# overhead j1 length 2 transmit-message 22
Router(config-controller)# overhead j1 length 2 receive-message 34
Examples For NCS 4200 Series, the following example shows the configuration of J1 flag:
enable
configure terminal
controller sonet 0/5/0
sts-1 1
overhead j1 message word
end
Cisco IOS Interface and Hardware Component Command Reference
807
O through R
overhead tunnel
overhead tunnel
To configure a transparent overhead tunnel on SDH or SONET controller, use the overhead tunnel command
in the controller mode. To remove the tunnel from SDH or SONET controller, use the no form of this command.
For SONET
overhead tunnel {all | sdcc | ldcc | k1k2 | loh | soh } cem-group cem-id unframed
For SDH
overhead tunnel {all | ms-dcc | rs-dcc | k1k2 | loh | soh } cem-group cem-id unframed
Syntax Description Syntax Description
all Specify to include all section and line headers.
sdcc Specify to include D1, D2, and D3 section header bytes for SONET.
ms-dcc Specify to include D1, D2, and D3 section header bytes for SDH.
ldcc Specify to include D4 to D12 line header bytes for SONET.
rs-dcc Specify to include D4 to D12 line header bytes for SDH.
k1k2 Specify to include K1 and K2 line header bytes.
loh Specify to include K1, K2, and D4 to D12, E2 line header bytes.
soh Specify to include E1, F1, D1, D2, and D3 line header bytes.
cem-id Specify CEM ID configured for the CEM group.
Command Default None
Command Modes Configuration mode
Command History Release Modification
Cisco IOS XE 16.9.x Support for this command was introduced on ASR 900 Series.
Usage Guidelines Before creating transparent overhead tunnel, ensure that you perform the following steps:
• Set mode under STS path before enabling overhead tunnel.
• Mode and TOH type should be same on both PEs in an end-to-end setup.
For more information on prerequisites for transparent overhead tunnel, see 1-Port OC-192 or 8-Port Low Rate
CEM Interface Module Configuration Guide, Cisco IOS XE Everest 16.8.x (Cisco ASR 900 Series).
Examples The following example shows how to configure transparent overhead tunnel on the SONET controller:
router(config)#controller sonet 0/7/7
Cisco IOS Interface and Hardware Component Command Reference
808
O through R
overhead tunnel
router(config-controller)#overhead tunnel SDCC cem-group100 unframed
router(config-controller)#end
To configure transparent overhead tunnel pseudowire, use the following commands:
router(config)#interface cem 0/7/7
router(config-if)#cem 100
router(config-if)#xconnect 203.0.113.1 130 encapsulation MPLS
router(config-controller)#end
Related Commands Command Description
show cem circuit interface cem interface-name Displays CEM interface configured for transparent
overhead tunnel.
Cisco IOS Interface and Hardware Component Command Reference
809
O through R
overhead s1s0
overhead s1s0
To set the SONET path overhead bytes in the frame header to a specific standards requirement or to ensure
interoperability with equipment from another vendor, use the overhead command in SONET path configuration
mode. To remove the setting of the SONET path overhead bytes from the configuration file and restore the
system to its default condition, use the no form of this command.
overhead s1s0 value
no overhead s1s0 value
Syntax Description Syntax Description
s1s0 value Sets the SS bits value of the H1 byte in the SONET line overhead.
For SONET mode, use 0 (this is the default).
Command Modes Controller configuration
Command History Release Modification
XE 3.18SP Support for this command was introduced on NCS 4200 Series.
Usage Guidelines Use the overhead command to set the SONET overhead bytes in the frame header to a specific standards
requirement. This command is used to configure line and section overhead.
Examples The following example shows the configuration of overhead s1s0:
enable
configure terminal
controller MediaType 0/5/0
mode sonet
controller sonet 0/5/0
overhead s1s0 2
overhead j0 tx-length 1-byte
end
Related Commands Command Description
controller sonet Configures the SONET mode.
show controller sonet Displays SONET controller configuration.
Cisco IOS Interface and Hardware Component Command Reference
810
O through R
password (satellite initial configuration)
password (satellite initial configuration)
To define or to change the password of the NM-1VSAT-GILAT network module required to enter satellite
initial configuration mode, use the password command in the satellite initial configuration mode.
password password
Syntax Description password A string of up to 32 alphanumeric characters.
Command Default The factory-supplied default password is active.
Command Modes Satellite initial configuration.
Command History Release Modification
12.4(11)XJ2 This command was introduced.
12.4(15)T This command was integrated into Cisco IOS Release 12.4(15)T.
Usage Guidelines The NM-1VSAT-GILAT network module has a factory-supplied unique default password to enter satellite
initial configuration mode for initial configuration. During this configuration, the password command is used
to set a user-defined password for subsequent entries to satellite initial configuration mode. The user-defined
password consists of up to 32 alphanumeric characters.
Examples The following example shows how to enter a user-defined password:
Router(sat-init-config)# password vsatuser
Cisco IOS Interface and Hardware Component Command Reference
811
O through R
payload-compression
payload-compression
To enable payload compression, use the payload-compressioncommand in CEM configuration mode. To
disable payload compression, use the no form of this command.
payload-compression
no payload-compression
Syntax Description This command has no arguments or keywords.
Command Default Payload compression is disabled by default.
Command Modes CEM configuration
Command History Release Modification
12.3(7)T This command was introduced.
Usage Guidelines Payload compression can be enabled only for a maximum of 3 Mbps per network module.
Examples The following example demonstrates how to enable payload compression.
Router(config-cem)# payload-compression
Related Commands Command Description
cem Enters circuit emulation configuration mode.
payload-size Configures payload size.
show cem Displays CEM statistics.
Cisco IOS Interface and Hardware Component Command Reference
812
O through R
payload-size dejitter-buffer
payload-size dejitter-buffer
To configure the size of payload and dejitter-buffer of a circuit emulation (CEM) over MPLS, use the
payload-size dejitter-buffer command in CEM configuration mode. To restore the default the size, use the
no form of this command.
payload-size size dejitter-buffer size
no payload-size size dejitter-buffer size
size The payload-size is the integer that defines the number of bytes per packet.
Range of payload-size is from 64 to 1312. Range for dejitter-buffer size from 1 to 256 milliseconds.
For T1, the valid values of payload size are 32 to 512. The default payload-size is 192 bytes and
dejitter-buffer size is 5 milliseconds.
For T3 clear channel, the default payload-size is 1024 bytes and dejitter-buffer size is 5 milliseconds.
For T3 channelized, the default payload-size is 192 bytes and dejitter-buffer size is 5 milliseconds.
For E1, the valid values of payload size are 64 to 1312. The default payload-size is 256 bytes and
dejitter-buffer size is 5 milliseconds.
Command Default The dejitter-buffer defaults to 5 milliseconds.
Command Modes CEM configuration
Command History
Command History Release Modification
XE 3.18SP This command was introduced.
XE Everest This command was implemented on the Cisco ASR 900 Series Routers and Cisco NCS
16.5.1 4200 Series.
Usage Guidelines Use this command to configure the size of each CEoIP packet. Smaller sizes reduce delay but diminish
efficiency.
Note The payload size must be a multiple of the number of time slots and 16. The payload size you enter will
automatically change to match the above requirement, and a console message will inform you the change.
When you select a value of payload-size, the acceptable range of dejitter-buffer is displayed.
Examples The following example shows how to set the payload size as 1024 and dejitter buffer to 10
milliseconds.
Router(config-controller)# payload-size 1024 dejitter-buffer 10
Cisco IOS Interface and Hardware Component Command Reference
813
O through R
payload-size dejitter-buffer
Related Commands Command Description
cem Enters circuit emulation configuration mode.
Cisco IOS Interface and Hardware Component Command Reference
814
O through R
payload-size
payload-size
To configure the payload size of a circuit emulation (CEM) over IP (CEoIP) packet, use the
payload-sizecommand in CEM configuration mode. To restore the default payload size, use the no form of
this command.
payload-size size
no payload-size
Syntax Description size Integer that defines the number of bytes per CEoIP packet. Range is from 1 to 1312.
The maximum configurable payload size is as follows:
• 1312 bytes if data protection is not enabled
• 656 bytes if data protection is enabled
The minimum configurable payload size for an unframed T1 or E1 channel is 256 bytes.
The minimum configurable payload size for a framed T1 or E1 channel is as follows:
• 56 bytes if the data rate is less than or equal to 256,000 kbps
• 128 bytes if the data rate is greater than 256,000 kbps and less than or equal to 512,000 kbps
• 256 bytes if the data rate is greater than 512,000 kbps
The minimum configurable payload size for a serial channel is as follows:
• 1 byte if the data rate is less than or equal to 2400 kbps
• 4 bytes if the data rate is greater than 2400 kbps but less than or equal to 9600 kbps
• 16 bytes if the data rate is greater than 9600 kbps but less than or equal to 32,000 kbps
• 32 bytes if the data rate is greater than 32,000 kbps but less than or equal to 64,000 kbps
• 64 bytes if the data rate is greater than 64,000 kbps but less than or equal to 256,000 kbps
• 128 bytes if the data rate is greater than 256,000 kbps but less than or equal to 512,000 kbps
• 256 bytes if the data rate is greater than 512,000 kbps
Note For T1 and E1, the integer must be a multiple of the number of time slots and 16.
For Cisco ASR 901 Series Aggregation Services Routers, the value specifies the size of the payload
for packets on a structured CEM channel. Valid values are 32 to 512. The default payload size for a
T1 channel is 192 bytes and for an E1 channel is 256 bytes.
The default payload size is calculated by multiplying 8 by the number of timeslots and then multiplying
the result by 1 ms packetization delay.
Command Default The default payload size for a serial channel is 32 bytes. Defaults for T1 and E1 channels are shown in the
tables below.
Cisco IOS Interface and Hardware Component Command Reference
815
O through R
payload-size
Table 25: Default Payload Size for N*64-kbps T1/E1 Channels
Number of Time Slots Channel Data Rate (kbps) Default Payload Size (bytes)
1 64 64
2 128 64
3 192 96
4 256 64
5 320 160
6 384 144
7 448 224
8 512 128
9 576 288
10 640 320
11 704 352
12 768 288
13 832 416
14 896 336
15 960 480
16 1024 256
Unframed T1 1544 512
Unframed E1 2048 512
17 1088 544
18 1152 576
19 1216 608
20 1280 560
21 1344 672
22 1408 528
23 1472 736
24 1536 528
25 1600 800
Cisco IOS Interface and Hardware Component Command Reference
816
O through R
payload-size
Number of Time Slots Channel Data Rate (kbps) Default Payload Size (bytes)
26 1664 624
27 1728 864
28 1792 560
29 1856 928
30 1920 720
31 1984 992
Table 26: Default Payload Size for N*56-kbps T1 Channels
Number of Time Slots Channel Data Rate (kbps) Default Payload Size (bytes)
1 56 56
2 112 56
3 168 168
4 224 56
5 280 280
6 336 168
7 392 168
8 448 168
9 504 504
10 560 280
11 616 616
12 672 336
13 728 728
14 784 280
15 840 840
16 896 336
17 952 952
18 1008 1008
19 1064 1064
Cisco IOS Interface and Hardware Component Command Reference
817
O through R
payload-size
Number of Time Slots Channel Data Rate (kbps) Default Payload Size (bytes)
20 1120 560
21 1176 672
22 1232 616
23 1288 1288
24 1344 672
Cisco ASR 901 Series Aggregation Services Routers
The default payload size for a structured CEM channel depends on the number of timeslots that constitute the
channel.
Command Modes • CEM configuration (config-if-cem)
• CEM circuit configuration (config-if-cem)
Command History Release Modification
15.1(2)SNG This command was implemented on Cisco ASR 901 Series Aggregation Services Routers.
15.1(2)SNG This command was implemented on Cisco ASR 901 Series Aggregation Services Routers.
Usage Guidelines Use this command to configure the size of each CEoIP packet. Smaller sizes reduce delay but diminish
efficiency.
Note The payload size must be a multiple of the number of time slots and 16. The payload size entered by the user
will be automatically changed to match the above requirement, and a console message will inform the user
of this change.
The Cisco ASR 901 series router only supports a payload size of 486 (625 packets per second) or 243 (1250
packets per second).
Examples The following example shows how to configure a payload size of 224.
Router(config-cem)# payload-size 224
Related Commands Command Description
cem Enters circuit emulation configuration mode.
payload-compression Enables payload compression.
payload-compression Enables payload compression.
Cisco IOS Interface and Hardware Component Command Reference
818
O through R
payload-size
Command Description
payload-compression Enables payload compression.
show cem Displays CEM channel statistics.
Cisco IOS Interface and Hardware Component Command Reference
819
O through R
physical-interface
physical-interface
To create a physical subinterface and to associate it with the Virtual Multipoint Interface (VMI) on a router,
use the physical-interface command in interface configuration mode. To return to the default mode, use the
no form of this command.
physical-interface interface-type/slot
no physical-interface interface-type/slot
Syntax Description interface-type Type of interface or subinterface.
/ slot Slot in which the interface is present.
Command Default No physical interface exists.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.4(15)XF This command was introduced.
12.4(15)T This command was integrated into Cisco IOS Release 12.4(15)T to support VMIs in Mobile
Adhoc Router-to-Radio Networks.
12.4(24)T This command was modified. This command supports the subinterfaces and VLANS associated
with an interface.
Usage Guidelines The physical-interface command supports the subinterfaces and VLANs associated with an interface. This
command also allows VMI interface to operate over encapsulated interfaces, if required. Only one physical
interface can be assigned to a VMI interface. Because there is very high number of VMI interfaces that can
be used, assign a new VMI for each physical interface.
Examples The following example shows how to create a physical subinterface:
Router(config)# interface vmi1
Router(config-if)# physical-interface FastEthernet0/1
Related Commands Command Description
debug vmi Displays debugging output for VMIs.
eigrp interface Sets a threshold value to minimize hysteresis in a router-to-radio configuration.
interface vmi Creates a VMI interface.
mode bypass Enables VMIs to support multicast traffic
Cisco IOS Interface and Hardware Component Command Reference
820
O through R
physical-layer
physical-layer
To specify the mode of a slow-speed serial interface on a router as either synchronous or asynchronous, use
the physical-layer command in interface configuration mode. To return the interface to the default mode of
synchronous, use the no form of this command.
physical-layer {sync|async}
no physical-layer
Syntax Description sync Places the interface in synchronous mode. This is the default.
async Places the interface in asynchronous mode.
Command Default Synchronous mode
Command Modes Interface configuration
Command History Release Modification
11.2 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command applies only to low-speed serial interfaces available on Cisco 2520 through Cisco 2523 series
routers.
In synchronous mode, low-speed serial interfaces support all interface configuration commands available for
high-speed serial interfaces, except the following two commands:
• half-duplex timer cts-delay
• half-duplex timer rts-timeout
When placed in asynchronous mode, low-speed serial interfaces support all commands available for standard
asynchronous interfaces.
When you enter this command, it does not appear in the output of moresystem:running-config and
morenvram:startup-config commands because the command is a physical-layer command.
Examples The following example shows how to change a low-speed serial interface from synchronous to
asynchronous mode:
Router(config)# interface serial 2
Router(config-if)# physical-layer async
Cisco IOS Interface and Hardware Component Command Reference
821
O through R
physical-layer
Related Commands Command Description
more Displays a specified file.
Cisco IOS Interface and Hardware Component Command Reference
822
O through R
platform console
platform console
To select the console that is used to access the virtual router interface, use the platform console command in
global configuration mode.
platform console {serial |virtual}
Syntax Description serial Specifies that the virtual router is accessed using the virtual serial port on the ESXi host.
virtual Specifies that the virtual router is accessed using the VMware VM console.
Command Default No default.
Command Modes Global configuration (config)
Command History Release Modification
Cisco IOS XE 3.8S (Controlled Availability) This command was introduced on the Cisco CSR 1000V Cloud
Services Router.
Usage Guidelines During the first-time installation and bootup of the virtual router, you choose whether to access the virtual
router using the VM console or the virtual serial port on the ESXi host. The default setting is to use the VM
console.
This command is used for changing the console access to the virtual router after first-time installation and
bootup. After you enter the command, you must reload or power-cycle the router in order for the new setting
to take effect.
Examples
The following example configures the virtual router to be accessed through the VM console:
Router> enable
Router# configure terminal
Router(config)# platform console virtual
Router(config)# end
Router# copy system:running-config nvram:startup-config
Router# reload
The following example configures the virtual router to be accessed through the virtual serial port:
Router> enable
Router# configure terminal
Router(config)# platform console serial
Router(config)# end
Router# copy system:running-config nvram:startup-config
Router# reload
Cisco IOS Interface and Hardware Component Command Reference
823
O through R
platform cwan acl software-switched
platform cwan acl software-switched
To allow ACLs to be applied to packets that are software-switched between WAN cards and the route processor,
use the platformcwanaclsoftware-switchedcommand in global configuration mode. To have ACLs applied
only to packets that are hardware-switched between WAN cards and the route processor, use the no form of
this command.
platform cwan acl software-switched {egress|ingress}
no platform cwan acl software-switched {egress|ingress}
Syntax Description egress Allows ACLs to be applied to software-switched egress WAN packets.
ingress Allows ACLs to be applied to software-switched ingress WAN packets.
Command Default ACLs are not applied to packets that are software-switched between WAN cards and the route processor.
ACLs are applied only to packets that are hardware-switched between WAN cards and the route processor.
Command Modes Global configuration (config)
Command History Release Modification
12.2(50)SY This command was introduced.
12.2(33)SXI2 This command was integrated into Cisco IOS Release 12.2(33)SXI2.
Usage Guidelines By default, software-switched WAN packets are not subjected to ACL lookup in the ACL TCAM and are
therefore not affected by hardware-only features. As a result, VACL capture will fail for software-switched
WAN packets. The platformcwanaclsoftware-switchedcommand allows ACLs to be applied to ingress or
egress software-switched WAN packets.
When you use the platformcwanaclsoftware-switchedcommand to allow VACL capture, these limitations
apply:
Note The platformcwanaclsoftware-switchedcommand is ignored by the SIP-600. Ingress software-switched
packets on the SIP-600 are not subjected to ACL lookups, and VACL features are not supported.
Examples This example shows how to enable ACLs for software-switched ingress WAN packets:
Router(config)#
platform cwan acl software-switched ingress
Related Commands Command Description
show platform acl software-switched Displays whether ACLs are enabled for software-switched WAN
packets.
Cisco IOS Interface and Hardware Component Command Reference
824
O through R
platform enable controller mediaType
platform enable controller mediaType
Use this command to to enable a particular license type on the controller port. Providing a particular license
type is mandatory to enable the license on the IM.
platform enable controller Mediatype <slot/bay/port> <port rate>
Syntax Description Syntax Description:
slot Physical slot number of the interface
bay Bay of the interface
port Mediatype port number
port rate Rate configured on the port
Command Default None
Command Modes Global configuration
Command History Release Modification
XE Everest This command was integarted into the Cisco NCS 4200 Series, Cisco ASR 900 Series,
16.7.1 and Cisco ASR 920 Routers.
Usage Guidelines License enabling is allowed when the license with the same rate is configured on the port. The configuration
fails if the license with a different rate is configured on the port.
Examples The following example shows how to enable the license:
enable
configure terminal
platform enable controller MediaType 0/4/16 oc3
controller MediaType 0/4/16
mode sonet
exit
controller sonet 0/4/16
rate oc3
exit
Related Commands Command Description
show license detail Verifies the license configuration.
Cisco IOS Interface and Hardware Component Command Reference
825
O through R
platform hardware throughput level
platform hardware throughput level
To change the maximum throughput level on the virtual router, use the platform hardware throughput level
command in global configuration mode. To return the platform throughput level to the default value, use the
no form of this command.
Cisco IOS XE Release 3.9S:
platform hardware throughput level {10000 | 25000 |50000 |eval-only}
Cisco IOS XE Release 3.10S and Later:
platform hardware throughput level MB {10 | 100 |1000 |25 |250 |50 |500}
Syntax Description Cisco IOS XE Release 3.9S:
10000 Sets the maximum throughput to
10,000 Kbps (10 Mbps).
25000 Sets the maximum throughput to
25,000 Kbps (25 Mbps).
50000 Sets the maximum throughput to
50,000 Kbps (50 Mbps).
eval-only Specifies to use the maximum
throughput for the evaluation
license only.
Cisco IOS XE Release 3.10S:
10 Sets the maximum throughput to
10 Mbps.
100 Sets the maximum throughput to
100 Mbps.
1000 Sets the maximum throughput to 1
Gbps.
25 Sets the maximum throughput to
25 Mbps.
250 Sets the maximum throughput to
250 Mbps.
50 Sets the maximum throughput to
50 Mbps.
500 Sets the maximum throughput to
500 Mbps.
Cisco IOS Interface and Hardware Component Command Reference
826
O through R
platform hardware throughput level
Command Default The default maximum throughput level is determined by the installed base license.
Command Modes Global configuration (config)
Command History Release Modification
Cisco IOS XE Release This command was introduced on the Cisco CSR 1000V Series Cloud Services
3.9S Router.
Cisco IOS XE 3.10S The command was updated to change the keywords to units in Mbps, and support
for maximum throughput values of 100 Mbps, 250 Mbps, 500 Mbps, and 1 Gbps
was added.
Usage Guidelines The Cisco CSR 1000V requires the installation of base licenses that set the maximum throughput of the
platform.
Depending on the configuration and the licenses installed, you may need to manually increase or decrease the
maximum throughput level on the Cisco CSR 1000V. The maximum throughput on the router before the
license is activated, or if the license is invalidated, is 2.5 Mbps. When you install the base subscription license
and accept the EULA, the maximum throughput on the Cisco CSR 1000V will increase to the level allowed
by the license.
You may need to manually change the maximum throughput level in the following cases:
• If you are using an evaluation license. When the evaluation license is first installed, the maximum
throughput is limited to 2.5 Mbps before the license is activated. You must accept the EULA and enter
the platform hardware throughput levelcommand to increase the maximum throughput. When the
60-day evaluation license expires, the maximum throughput level reverts to 2.5 Mbps.
• If you want to reduce the maximum throughput level from the maximum permitted by the installed
licenses. For example, if you have the 50-Mbps license installed and you want to reduce the maximum
throughput to 25 Mbps. You must enter the platform hardware throughput level command to reduce
the maximum throughput.
• If you previously changed the maximum throughput using the platform hardware throughput level
command. When you enter the command, it becomes part of the configuration file. You must enter the
command again to change the maximum throughput level.
When changing the maximum throughput level, you do not need to reboot the Cisco CSR 1000V for the
change to take effect. If you try to increase the throughput level higher than what the installed license supports,
you will receive an error message.
Example
The following example changes the maximum throughput level to 500 Mbps:
Router(config)# platform hardware throughput level MB 500
The following example changes the maximum throughput level to the default level supported by the
installed license:
Cisco IOS Interface and Hardware Component Command Reference
827
O through R
platform hardware throughput level
Router(config)# no platform hardware throughput level
Related Commands Command Description
show platform hardware throughput level Displays the current maximum throughput level for a virtual
router.
Cisco IOS Interface and Hardware Component Command Reference
828
O through R
platform ip features sequential
platform ip features sequential
To enable Internet Protocol (IP) precedence-based or differentiated services code point (DSCP)-based egress
quality of service (QoS) filtering to use any IP precedence or DSCP policing or marking changes made by
ingress policy feature card (PFC) QoS, use the platformipfeaturessequential command in interface
configuration mode. To return to the default settings, use the no form of this command.
platform ip features sequential [access-group {ip-acl-nameip-acl-number}]
no platform ip features sequential [access-group {ip-acl-nameip-acl-number}]
Syntax Description access-group ip-acl-name (Optional) Specifies the name of the ACL that is used to specify the match
criteria for the recirculation packets.
access-group ip-acl-number (Optional) Specifies the number of the ACL that is used to specify the match
criteria for the recirculation packets; valid values are from 1 to 199 and
from 1300 to 2699.
Command Default IP precedence-based or DSCP-based egress QoS filtering uses received IP precedence or DSCP values and
does not use any IP precedence or DSCP changes made by ingress QoS as the result of policing or marking.
Command Modes
Interface configuration (config-if)
Command History Release Modification
12.2(50)SY This command was introduced.
12.2(18)SXE Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
Caution If the switch is operating in PFC3A mode with egress ACL support for remarked DSCP configured, when
the PFC3 processes traffic to apply ingress PFC QoS, it applies ingress PFC QoS filtering and ingress PFC
QoS, and incorrectly applies any egress QoS filtering and egress PFC QoS configured on the ingress interface,
which results in unexpected behavior if QoS filtering is configured on an interface where egress ACL support
for remarked DSCP is enabled. This problem does not occur in other PFC3 modes.
The enhanced egress-QoS filtering enables the IP precedence-based or DSCP-based egress-QoS filtering to
use any IP precedence or DSCP policing or marking changes made by ingress QoS.
The nonenhanced egress-QoS filtering behavior is the normal Cisco 7600 series router or the Catalyst 6500
series switch behavior when QoS is applied in the hardware.
The PFC3 provides egress PFC QoS only for Layer 3-switched and routed traffic on egress Layer 3 interfaces
(either LAN ports configured as Layer 3 interfaces or VLAN interfaces).
Cisco IOS Interface and Hardware Component Command Reference
829
O through R
platform ip features sequential
You configure enhanced egress QoS filtering on ingress Layer 3 interfaces (either LAN ports configured as
Layer 3 interfaces or VLAN interfaces).
To enable enhanced egress QoS filtering only for the traffic filtered by a specific standard, extended named,
or extended numbered IP ACL, enter the IP ACL name or number.
If you do not enter an IP ACL name or number, enhanced egress QoS filtering is enabled for all IP ingress IP
traffic on the interface.
Note When you configure enhanced egress-QoS filtering, the PFC3A processes traffic to apply ingress PFC QoS.
The PFC3A applies ingress-QoS filtering and Cisco 7600 series router or the Catalyst 6500 series switch
hardware ingress QoS. The PFC3A incorrectly applies any egress-QoS filtering and Cisco 7600 series router
or the Catalyst 6500 series switch hardware egress QoS that is configured on the ingress interface.
Note If you configure enhanced egress-QoS filtering on an interface that uses Layer 2 features to match the IP
precedence or DSCP as modified by ingress-QoS marking, the packets are redirected or dropped and prevented
from being processed by egress QoS.
Note If you enable enhanced egress-QoS filtering, the hardware acceleration of NetFlow-based features such as
reflexive ACL, NAT, and TCP intercept are disabled.
To verify configuration, use the showrunning-configinterface command.
Examples The following example shows how to enable enhanced egress-QoS filtering:
Router(config-if)# platform ip features sequential
Router(config-if)#
The following example shows how to disable enhanced egress-QoS filtering:
Router(config-if)# no platform ip features sequential
Router(config-if)#
Related Commands Command Description
show running-config interface Displays the contents of the currently running configuration file.
Cisco IOS Interface and Hardware Component Command Reference
830
O through R
platform punt-keepalive
platform punt-keepalive
To enable the Punt-Keepalive feature and monitor the status of the punt path between the forwarding processor
(FP) and the route processor (RP), use the platform punt-keepalive command in the global configuration
mode. To disable the Punt-Keepalive feature, use the no form of this command.
platform punt-keepalive{disable-kernel-core|settings{fatal-count fatal-count|transmit-interval
transmit-interval|warning-count warning-count}}
no platform punt-keepalive
Syntax Description disable-kernel-core Disables Linux kernel crash generation and IOS Daemon (IOSD) crash
generation.
settings Specifies the keepalive parameters.
fatal-count fatal-count Specifies the upper limit of consecutive keepalive warnings for triggering
system failures. The range is from 15 to 60.
Linux kernel crash generation and IOSD crash generation occur when the
fatal count reaches the upper limit.
transmit-interval Specifies the keepalive transmit interval, in seconds. The range is from 2
transmit-interval to 30. The default is 2.
warning-count warning-count Specifies the upper limit of consecutive keepalive message failures for
reporting warnings. The range is from 10 to 60.
Linux kernel crash generation and IOSD crash generation occur when the
warnings reach the upper limit.
Command Default The Punt-Keepalive feature is enabled, and the Kernel core crash and IOSD crash generation are enabled.
Command Modes Global configuration (config)
Command History Release Modification
Cisco IOS XE Release 3.5S This command was introduced.
Usage Guidelines The platform punt-keepalive command is available only if all the following conditions are met:
• Device is in an active state.
• FP is present and is online.
• System reload is not in progress.
The punt-keepalive process checks the status of the device and the FP every 30 seconds. However, when the
status for the device changes from standby to active, or when the FP goes online, the device waits for another
30 seconds before sending the first keepalive message. Disabling the Linux kernel crash generation and IOS
Daemon (IOSD) crash generation allows the system to settle down after the occurrence of critical events.
Cisco IOS Interface and Hardware Component Command Reference
831
O through R
platform punt-keepalive
IOSD or Kernel driver code can cause a keepalive failure; a keepalive failure can force IOSD crash generation
and Linux kernel crash generation. The crash generation type depends on the chassis and the operating mode.
The following table describes the relationship between chassis, operation mode, and type of crash generation.
Table 27: Relationship Between Chassis, Operation Mode, and Type of Crash Generation
Chassis Operation Mode Redundancy Status Type of Crash Generation
Cisco ASR 1002 Single IOSD - IOSD core
Cisco ASR 1002-F Kernel core
Cisco ASR 1001 Dual IOSD Not Hot IOSD core
ASR 1004 Kernel core
IOSD core Dual IOSD Hot IOSD core
Kernel core
Cisco ASR 1006 Single or Dual RP Any IOSD core
Cisco ASR 1013 Kernel core
Kernel core crash generation takes approximately five minutes. Disable kernel core crash generation for a
faster reboot of the system.
Examples The following example shows how to disable kernel core crash generation and IOSD crash generation
by using the platform punt-keepalive command:
Device(config)# platform punt-keepalive disable-kernel-core
Related Commands Command Description
show platform Displays information about platform punt-keepalive command settings.
software
infrastructure
punt-keepalive
Cisco IOS Interface and Hardware Component Command Reference
832
O through R
platform scp retry interval
platform scp retry interval
To enable Switch-Module Configuration Protocol (SCP) fast retry and set the fast-retry interval, use the
platformscpretryinterval command in global configuration mode. To disable SCP fast retry, use the no form
of this command.
platform scp retry interval timeout-value
no platform scp retry interval
Syntax Description timeout-value Fast retry interval; valid values are from 200 to 2000 milliseconds.
Command Default 2000 milliseconds
Command Modes Global configuration
Command History Release Modification
12.2(18)SXD Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
Note Use this command under the direction of the Cisco TAC only.
Examples This example shows how to enable SCP fast retry and set the fast-retry interval:
Router(config)# platform scp retry interval 600
Router(config)#
Cisco IOS Interface and Hardware Component Command Reference
833
O through R
platform smart-sfp
platform smart-sfp
To configure the Gigabit Ethernet or TenGig Ethernet as VCoP smart SFP on OC3 or OC12 or DS3 mode,
use the platform smart-sfp interface command in SONET/PDH configuration mode. To remove the VCoP
smart SFP, use the no form of this command.
platform smart-sfp interface gig/tengigslot/bay/port typeOC3/OC12/DS3
no platform smart-sfp
Syntax Description Syntax Description
platform Specifies a platform keyword.
smart sfp Specifies a smart sfp keyword. SFP stands for Small Form-Factor Pluggable.
interface Specifies a interface keyword.
gig/tengig Specifies the Gigabit Ethernet or TenGig Ethernet port where VCoP is inserted.
slot Slot number of the controller. A forward slash mark (/) is required between the slot argument
and the bay argument.
bay Bay number of the controller. A forward slash mark (/) is required.
port Port number of the controller. A forward slash mark (/) is required between the bay argument
and the port argument.
type Type of the interface to be configured. The interface type can be OC3/OC12/ DS3.
Command Modes Global configuration
Command History Release Modification
XE 3.18SP Support for this command was introduced on the Cisco NCS 4200 Series.
XE Everest This command was introduced to support DS3 mode of VCoP Smart SFP for Cisco NCS
16.5.1 4200 Series and Cisco ASR 920 Routers.
Usage Guidelines This command is used to identify the VCoP OC-n/DS3 smart SFP inserted in the Cisco NCS 4200 Series.
This command is used to configure VCoP OC-n smart SFP type i.e. OC3 or OC12 and DS3 mode. Before
executing this command for a particular port, the configuration on that port must be deleted or set as default.
This command sets the Gig port as the smart SFP port for configuring the CEP for the given port number.
Examples The following example shows how to configure VCoP smart SFP on Gig and TenGig ports.
Configruing VCoP smart SFP on OC3 mode
For Gigabit port:
Router(config)# configure terminal
Router(config)# platform smart-sfp interface GigabitEthernet 0/0/8 type OC-3
Cisco IOS Interface and Hardware Component Command Reference
834
O through R
platform smart-sfp
For TenGig port:
Router(config)# configure terminal
Router(config)# platform smart-sfp interface TenGig 0/0/8 type OC-3
Configruing VCoP smart SFP on OC12 mode
For Gigabit port:
Router(config)# configure terminal
Router(config)# platform smart-sfp interface GigabitEthernet 0/0/8 type OC-12
For TenGig port:
Router(config)# configure terminal
Router(config)# platform smart-sfp interface TenGig 0/0/8 type OC-12
Configruing VCoP smart SFP on T3 mode
For Gigabit port:
Router(config)# configure terminal
Router(config)# platform smart-sfp interface GigabitEthernet 0/0/8 type ds3
For TenGig port:
Router(config)# configure terminal
Router(config)# platform smart-sfp interface TenGig 0/0/8 type ds3
Related Commands Command Description
show cem circuit Displays the circuit emulation (CEM) statistics for the configured CEM circuits.
show controller Displays SONET/T3 controller configuration.
Cisco IOS Interface and Hardware Component Command Reference
835
O through R
platform time-source
platform time-source
To initiate Time of Day (ToD) synchronization on a line card, use the platformtime-source command in
global configuration mode. To disable the platform time-source, use the no form of this command.
platform time-source {ntp|ptp}
no platform time-source
Syntax Description ntp Configures Network Time Protocol (NTP) clock source
ptp Configures Precision Time Protocol (PTP) clock source
Command Default The platformtime-source command is not enabled.
Command Modes Global configuration
Command History Release Modification
15.1(2)S This command was introduced on the Cisco 7600 routers.
Cisco IOS XE Release This command is integrated on the Cisco ASR 900 Series Routers. The ptp
3.12 keyword is not supported on the Cisco ASR 900 Series Routers.
Usage Guidelines Cisco 7600 Router
Either the 2-Port Gigabit Synchronous Ethernet SPA (PTP) or NTP module on the Route Processor is used
to initiate the ToD synchroniztion. The NTP ToD information is converted into PTP format and then
synchronized to all the ES+ Linecards.
Cisco ASR 900 Series Routers
This command is used to enable or disable NTP clock (Time of Day) synchronization on the ethernet ports.
The ports will use NTP ToD value to timestamp Y.1731 DM packets.
Example
This example shows how to configure platform time-source on the Cisco ASR 900 Series Router.
Router (config)# platform time-source ntp
Examples This example shows how to configure the platform time-source on the Cisco 7600 Router.
Router (config)#platform time-source ptp 1 master top 6/0/2 slave lo0
or
Router (config)#platform time-source ntp
Cisco IOS Interface and Hardware Component Command Reference
836
O through R
platform time-source
Related Commands Command Description
show platform time-source This command displays the configuration details of the platform time-source.
Cisco IOS Interface and Hardware Component Command Reference
837
O through R
platform trace boottime process forwarding-manager module interfaces
platform trace boottime process forwarding-manager module
interfaces
To enable Forwarding Manager Route Processor and Embedded Service Processor trace messages for the RP
forwarding manager process during bootup, use the
platformtraceboottimeprocessforwarding-managermoduleinterfacescommand in the Global configuration
mode. To disable debug messages, use the no form of this command.
platform trace boottime slot slot bay bay process forwarding-manager module interfaces level
level
no platform trace boottime slot slot bay bay process forwarding-manager module interfaces
Syntax Description slot Shared Port Adapter (SPA) Interprocessor, Embedded Service Processor or Route Processor
slot.
Valid options are:
• R0 --Route Processor slot 0
• R1 --Route Processor slot 1
bay Chassis bay to be configured.
Valid options are:
•0
•1
level level Selects the trace level. The trace level determines the amount of information that is to be stored
about a module in the trace buffer or file.
Valid options are:
• max --Provides the maximum possible message.
• notice messages --Provides notice messages.
Command Default The default tracing level for every module on the Cisco ASR 1000 Series Routers is Notice.
Command Modes Global configuration (config)
Command History Release Modification
Cisco IOS XE Release 3.2S This command was introduced on the Cisco ASR 1000 Routers.
Usage Guidelines Trace-level settings are leveled that is every setting contains all the messages from the lower setting plus the
messages from its own setting. For instance, setting the trace level to 3 (error) ensures that the trace file
contains all the output for the 0 (emergencies), 1 (alerts), 2 (critical), and 3 (error) settings. Setting the trace
level to 4 (warning) ensures that all the trace output for a specific module is included in that trace file.
Cisco IOS Interface and Hardware Component Command Reference
838
O through R
platform trace boottime process forwarding-manager module interfaces
All trace levels cannot be configured by users. Specifically, the alert, critical, and notice tracing levels cannot
be set by users. To trace these messages, set the trace level to a higher level, which collects these messages.
When setting the trace levels, it is also important to remember that the setting is not done in a configuration
mode. As a result of this, trace level settings are returned to their defaults after every router reload.
Caution Setting tracing of a module to the debug level or higher can have a negative performance impact. Setting
tracing to the debug level or higher should be done with discretion.
Caution Setting a large number of modules to high tracing levels can severely degrade performance. If a high level of
tracing is needed in a specific context, it is almost always preferable to set a single module on a higher tracing
level rather than setting multiple modules to high tracing levels.
Examples In the following example, the trace level for the forwarding processor module in the Forwarding
Manager of the ESP processor in slot R0 is set to the informational tracing level (max):
Router(config)# platform trace boottime slot R0 bay 1 process forwarding-manager
forwarding-manager level max
Related Commands Command Description
show platform software trace level Displays trace levels for specified modules.
show platform software trace message Displays trace messages.
Cisco IOS Interface and Hardware Component Command Reference
839
O through R
pm fec threshold
pm fec threshold
To configure performance monitoring thresholds on the FEC layer, use the pmfecthresholdcommand in
DWDM configuration mode. To disable the performance monitoring threshold, use the no form of this
command.
pm {15-min|24-hour} fec threshold {ec-bits|uc-words} threshold
nopm {15-min|24-hour} fec threshold {ec-bits|uc-words} threshold
Syntax Description 15-min Configures the performance monitoring thresholds for 15-minute intervals.
24-hour Configures performance monitoring thresholds for 24-hour intervals.
ec-bits Bit errors corrected (BIEC). Indicates the number of bit errors corrected in the DWDM trunk
line during the performance monitoring time interval.
uc-words Uncorrectable Words. Indicates the number of uncorrectable words detected in the DWDM
trunk line during the performance monitoring time interval.
threshold Threshold for the performance monitoring parameter.
Command Default No threshold is configured.
Command Modes DWDM configuration.
Command History Release Modification
15.1(3)S This command was introduced on the Cisco 7600 series routers.
Examples The following example shows how to configure an FEC layer performance monitoring threshold for
uncorrectable words:
Router(config)# controller dwdm 0/0
Router(config-controller)# pm 15-min fec threshold uc-words 900 enable
Related Commands Command Description
show controller dwdm pm fec Displays performance measurement information for the FEC layer.
Cisco IOS Interface and Hardware Component Command Reference
840
O through R
pm optics report
pm optics report
To enable threshold crossing alert (TCA) generation on the optics layer, use the pmopticsreportcommand
in DWDM configuration mode. To disable TCA reporting, use the no form of this command.
pm {15-min|24-hour} optics report {lbc|opr|opt} {max-tca|min-tca} enable
nopm {15-min|24-hour} optics report {lbc|opr|opt} {max-tca|min-tca} enable
Syntax Description 15-min Configures TCA generation for 15-minute intervals.
24-hour Configures TCA generation for 24-hour intervals.
lbc Laser bias current.
opr Optical power on the unidirectional port.
opt Transmit optical power in dBm.
max-tca Indicates that the maximum value of the parameter is compared against the threshold to determine
if a TCA should be generated.
min-tca Indicates that the minimum value of the parameter is compared against the threshold to determine
if a TCA should be generated.
enable Enables TCA generation for the specified parameter on the DWDM controller.
Command Default TCA reporting is not enabled.
Command Modes DWDM configuration.
Command History Release Modification
15.1(3)S This command was introduced on the Cisco 7600 series routers.
Examples The following example shows how to enable TCA reporting on the optics layer reporting for the
maximum OPT:
Router(config)# controller dwdm 0/0
Router(config-controller)# pm 15-min optics report opt max-tca enable
Related Commands Command Description
show controller dwdm pm optics Displays performance measurement information for the optics layer.
Cisco IOS Interface and Hardware Component Command Reference
841
O through R
pm otn report
pm otn report
To enable threshold crossing alert (TCA) generation on the optical transport network (OTN) layer, use the
pmotnreportcommand in DWDM configuration mode. To disable TCA reporting, use the no form of this
command.
pm {15-min|24-hour} otn report otn-parameter enable
nopm {15-min|24-hour} otn report otn-parameter enable
Syntax Description 15-min Configures TCA generation for 15-minute intervals.
24-hour Configures TCA generation for 24-hour intervals.
otn-parameter Specific parameter for which to configure the threshold. OTN parameters can be as follows:
• bbe-pm-fe --Far-end path monitoring background block errors (BBE-PM). Indicates the
number of background block errors recorded in the optical transport network (OTN) path
during the performance monitoring time interval.
• bbe-pm-ne --Near-end path monitoring background block errors (BBE-PM).
• bbe-sm-fe --Far-end section monitoring background block errors (BBE-SM). Indicates
the number of background block errors recorded in the OTN section during the
performance monitoring time interval.
• bbe-sm-ne --Near-end section monitoring background block errors (BBE-SM).
• bber-pm-fe --Far-end path monitoring background block errors ratio (BBER-PM).
Indicates the background block errors ratio recorded in the OTN path during the
performance monitoring time interval.
• bber-pm-ne --Near-end path monitoring background block errors ratio (BBER-PM).
• bber-sm-fe --Far-end section monitoring background block errors ratio (BBER-SM).
Indicates the background block errors ratio recorded in the OTN section during the
performance monitoring time interval.
• bber-sm-ne --Near-end section monitoring background block errors ratio (BBER-SM)
• es-pm-fe --Far-end path monitoring errored seconds (ES-PM). Indicates the errored
seconds recorded in the OTN path during the performance monitoring time interval.
• es-pm-ne --Near-end path monitoring errored seconds (ES-PM).
• es-sm-fe --Far-end section monitoring errored seconds (ES-SM). Indicates the errored
seconds recorded in the OTN section during the performance monitoring time interval.
• es-sm-ne --Near-end section monitoring errored seconds (ES-SM).
• esr-pm-fe --Far-end path monitoring errored seconds ratio (ESR-PM). Indicates the
errored seconds ratio recorded in the OTN path during the performance monitoring time
interval.
Cisco IOS Interface and Hardware Component Command Reference
842
O through R
pm otn report
• esr-pm-ne --Near-end path monitoring errored seconds ratio (ESR-PM).
• esr-sm-fe --Far-end section monitoring errored seconds ratio (ESR-SM). Indicates the
errored seconds ratio recorded in the OTN section during the performance monitoring
time interval.
• esr-sm-ne --Near-end section monitoring errored seconds ratio (ESR-SM).
• fc-pm-fe --Far-end path monitoring failure counts (FC-PM). Indicates the failure counts
recorded in the OTN path during the performance monitoring time interval.
• fc-pm-ne --Near-end path monitoring failure counts (FC-PM).
• fc-sm-fe --Far-end section monitoring failure counts (FC-SM). Indicates the failure
counts recorded in the OTN section during the performance monitoring time interval.
• fc-sm-ne --Near-end section monitoring failure counts (FC-SM).
• ses-pm-fe --Far-end path monitoring severely errored seconds (SES-PM). Indicates the
severely errored seconds recorded in the OTN path during the performance monitoring
time interval.
• ses-pm-ne --Far-end path monitoring severely errored seconds (SES-PM).
• ses-sm-fe --Far-end section monitoring severely errored seconds (SES-SM). Indicates
the severely errored seconds recorded in the OTN section during the performance
monitoring time interval.
• ses-sm-ne --Near-end section monitoring severely errored seconds (SES-SM).
• sesr-pm-fe --Far-end path monitoring severely errored seconds ratio (SESR-PM).
Indicates the severely errored seconds ratio recorded in the OTN path during the
performance monitoring time interval.
• sesr-pm-ne --Near-end path monitoring severely errored seconds ratio (SESR-PM).
• sesr-sm-fe --Far-end section monitoring severely errored seconds ratio (SESR-SM).
Indicates the severely errored seconds ratio recorded in the OTN section during the
performance monitoring time interval.
• sesr-sm-ne --Near-end section monitoring severely errored seconds ratio (SESR-SM).
• uas-pm-fe --Far-end path monitoring unavailable seconds (UAS-PM). Indicates the
unavailable seconds recorded in the OTN path during the performance monitoring time
interval.
• uas-pm-ne --Near-end path monitoring unavailable seconds (UAS-PM).
• uas-sm-fe --Far-end section monitoring unavailable seconds (UAS-SM). Indicates the
unavailable seconds recorded in the OTN section during the performance monitoring
time interval.
• uas-sm-ne --Near-end section monitoring unavailable seconds (UAS-SM).
enable Enables TCA generation for the specified parameter on the DWDM controller.
Command Default TCA generation is not enabled.
Cisco IOS Interface and Hardware Component Command Reference
843
O through R
pm otn report
Command Modes DWDM configuration.
Command History Release Modification
15.1(3)S This command was introduced on the Cisco 7600 series routers.
Examples The following example shows how to enable TCA generation on the OTN layer reporting for the
path monitoring errored seconds ratio (ESR-PM):
Router(config)# controller dwdm 0/0
Router(config-controller)# pm 15-min otn report esr-pm-fe enable
Related Commands Command Description
show controller dwdm pm otn Displays performance measurement information for the OTN layer.
Cisco IOS Interface and Hardware Component Command Reference
844
O through R
pm optics threshold
pm optics threshold
To configure performance monitoring thresholds on the optics layer, use the pmopticsthresholdcommand
in DWDM configuration mode. To disable the performance monitoring threshold, use the no form of this
command.
pm {15-min|24-hour} optics threshold {lbc|opr|opt} {max|min} threshold
nopm {15-min|24-hour} optics threshold {lbc|opr|opt} {max|min} threshold
Syntax Description 15-min Configures performance monitoring thresholds for 15-minute intervals.
24-hour Configures performance monitoring thresholds for 24-hour intervals.
lbc Laser bias current.
opr Optical power on the unidirectional port.
opt Transmits optical power in dBm.
max Indicates that the threshold is for the maximum value of the parameter.
min Indicates that the threshold is for the minimum value of the parameter.
threshold Threshold for the performance monitoring parameter.
Command Default No thresholds are configured.
Command Modes DWDM configuration.
Command History Release Modification
15.1(3)S This command was introduced on the Cisco 7600 series routers.
Examples The following example shows how to configure an optics layer performance monitoring threshold
for maximum OPT:
Router(config)# controller dwdm 0/0
Router(config-controller)# pm 15-min optics threshold opt max 700
Related Commands Command Description
show controller dwdm pm optics Displays performance measurement information for the optics layer.
Cisco IOS Interface and Hardware Component Command Reference
845
O through R
pm otn threshold
pm otn threshold
To configure performance monitoring thresholds on the optical transport network (OTN) layer, use the
pmotnthresholdcommand in DWDM configuration mode. To disable TCA reporting, use the no form of this
command.
pm {15-min|24-hour} otn threshold otn-parameter threshold
nopm {15-min|24-hour} otn threshold otn-parameter threshold
Syntax Description 15-min Configures performance monitoring thresholds for 15-minute intervals.
24-hour Configures performance monitoring thresholds for 24-hour intervals.
otn-parameter Specific parameter for which to configure the threshold. OTN parameters can be as described
in the pmotnreport command.
threshold Threshold for the performance monitoring parameter.
Command Default No thresholds are configured.
Command Modes DWDM configuration.
Command History Release Modification
15.1(3)S This command was introduced on the Cisco 7600 series routers.
Examples The following example shows how to configure an OTN layer performance monitoring threshold
for path monitoring errored seconds ratio (ESR-PM):
Router(config)# controller dwdm 0/0
Router(config-controller)# pm 15-min otn threshold esr-pm-ne 800
Related Commands Command Description
show controller dwdm pm otn Displays performance measurement information for the OTN layer.
Cisco IOS Interface and Hardware Component Command Reference
846
O through R
port (interface)
port (interface)
To enable an interface on a PA-4R-DTR port adapter to operate as a concentrator port, use the portcommand
in interface configuration mode. To restore the default station mode, use the no form of this command.
port
no port
Syntax Description This command has no arguments or keywords.
Command Default Station mode
Command Modes Interface configuration
Command History Release Modification
11.3(3)T This command was introduced.
Usage Guidelines By default, the interfaces of the PA-4R-DTR operate as Token Ring stations. Station mode is the typical
operating mode. Use this command to enable an interface to operate as a concentrator port.
Examples The following example configures the PA-4R-DTR ports to operate in concentrator mode on a Cisco
7000 series router:
Router(config)# interface tokenring 3/0/0
Router(config-if)# port
Cisco IOS Interface and Hardware Component Command Reference
847
O through R
port access-map
port access-map
To create a port access map or enter port access-map command mode, use the portaccess-map command in
global configuration mode. To remove a mapping sequence or the entire map, use the no form of this command.
port access-map name [seq#]
no port access-map name [seq#]
Syntax Description name Port access-map tag.
seq# (Optional) Map sequence number; valid values are 0 to 65535.
Command Default This command has no default settings.
Command Modes Global configuration
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.
If you enter the sequence number of an existing map sequence, you enter port access-map mode. If you do
not specify a sequence number, a number is automatically assigned. You can enter one match clause and one
action clause per map sequence.
If you enter the noportaccess-mapname [seq#] command without entering a sequence number, the whole
map is removed.
Once you enter port access-map mode, the following commands are available:
• action -- Specifies the packet action clause; see the action command section.
• default -- Sets a command to its defaults.
• end -- Exits from configuration mode.
• exit -- Exits from the port access-map configuration mode.
• match -- Specifies the match clause; see the match command section.
• no -- Negates a command or sets its defaults.
Examples This example shows how to enter port access-map mode:
Router(config)# port access-map ted
Router(config-port-map)#
Cisco IOS Interface and Hardware Component Command Reference
848
O through R
port access-map
Related Commands Command Description
action Sets the packet action clause.
match Specifies the match clause by selecting one or more ACLs for a VLAN access-map sequence.
Cisco IOS Interface and Hardware Component Command Reference
849
O through R
port-channel hash-distribution
port-channel hash-distribution
To set the hash distribution algorithm method, use the port-channel hash-distribution command in global
configuration mode. To return to the default settings, use the no or default form of this command.
port-channel hash-distribution {adaptive|fixed}
{no|default} port-channel hash-distribution
Syntax Description adaptive Specifies selective distribution of the bundle select register among the port-channel members.
fixed Specifies fixed distribution of the bundle select register among the port-channel members.
default Specifies the default setting.
Command Default The hash distribution algorithm method is set to fixed.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SXH This command was introduced.
12.2(33)SRC This command was integrated into Cisco IOS Release 12.2(33)SRC.
Usage Guidelines The EtherChannel load distribution algorithm uses the bundle select register in the port ASIC to determine
the port for each outgoing packet. When you use the adaptive algorithm, it does not require the bundle select
register to be changed for existing member ports. When you use the fixed algorithm and you either add or
delete a port from the EtherChannel, the switch updates the bundle select register for each port in the
EtherChannel. This update causes a short outage on each port.
Note When you change the algorithm, the change is applied at the next member link event. Example events include
link down, up, addition, deletion, no shutdown, and shutdown. When you enter the command to change the
algorithm, the command console issues a warning that the command does not take effect until the next member
link event.
Examples The following example shows how to set the hash distribution algorithm method to adaptive:
Router(config)# port-channel hash-distribution adaptive
Cisco IOS Interface and Hardware Component Command Reference
850
O through R
port-channel load-balance
port-channel load-balance
To set the load distribution method among the ports in a bundle, use the port-channelload-balance command
in global configuration mode. To reset the load distribution to the default settings, use the no form of this
command.
port-channel load-balance method module slot
no port-channel load-balance
Syntax Description method Load distribution method; see the “Usage Guidelines” section for a list of valid values.
module Specifies the module on which the load-distribution method is set. This keyword is supported
only on DFC systems.
slot Number of the slot in the module.
Command Default The defaultmethod is src-dst-ip.
Command Modes Global configuration (config)
Command History Release Modification
12.2(14)SX This command was introduced on the Supervisor Engine 720.
12.2(17d)SXB This command was modified to support the Supervisor Engine 2.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SXH This command was modified. The following keywords were added:
dst-mixed-ip-port,src-dst-mixed-ip-port,src-mixed-ip-port,andexcludevlan.
• These keywords are supported on systems that are in PFC3C or PFC3CXL mode
(PFC3C or PFC3CXL with no DFC3A or DFC3B/BXL) only.
• The excludevlankeyword is added only for IP-related load balance options.
Usage Guidelines Valid method values are as follows:
• dst-ip --Loads distribution on the destination IP address. Option to exclude VLAN in the distribution is
provided using the excludevlankeyword along with this method.
• dst-mac --Loads distribution on the destination MAC address.
• dst-mixed-ip-port --Loads distribution on the destination IP address and TCP or User Datagram Protocol
(UDP) port. Option to exclude VLAN in the distribution is provided using the excludevlankeyword
along with this method.
• dst-port --Loads distribution on the destination port.
• src-dst-ip --Loads distribution on the source transfer or XOR-destination IP address. Option to exclude
VLAN in the distribution is provided using the excludevlankeyword along with this method.
Cisco IOS Interface and Hardware Component Command Reference
851
O through R
port-channel load-balance
• src-dst-mac --Loads distribution on the source XOR-destination MAC address.
• src-dst-mixed-ip-port --Loads distribution on the source XOR-destination IP address and the TCP or
UDP port. Option to exclude VLAN in the distribution is provided using the excludevlankeyword along
with this method.
• src-dst-port --Loads distribution on the source XOR-destination port.
• src-ip --Loads distribution on the source IP address. Option to exclude VLAN in the distribution is
provided using the excludevlankeyword along with this method.
• src-mac --Loads distribution on the source MAC address.
• src-mixed-ip-port --Loads distribution on the source IP address and the TCP or UDP port. Option to
exclude VLAN in the distribution is provided using the excludevlankeyword along with this method.
• src-port --Loads distribution on the source port.
The port-channelload-balancemethodmoduleslot command is supported on DFC systems only.
The port-channelper-moduleload-balance command allows you to enable or disable port-channel
load-balancing on a per-module basis. You can enter the port-channelload-balancemethodmoduleslot
command to specify the load-balancing method on a specific module after you have entered the
port-channelper-moduleload-balancecommand.
The following keywords are supported on systems that are in PFC3C or PFC3CXL mode (PFC3C or PFC3CXL
with no DFC3A or DFC3B/BXL) only:
• dst-mixed-ip-port
• src-dst-mixed-ip-port
• src-mixed-ip-port
Note If you change the load-balancing method, EtherChannel ports on DFC-equipped switching modules or an
active supervisor engine in a dual supervisor engine configuration will flap.
Examples The following example shows how to set the load-distribution method to dst-ip:
Router(config)#
port-channel load-balance dst-ip
The following example shows how to set the load-distribution method on a specific module:
Router(config)#
port-channel load-balance dst-ip module 2
The following example shows how to set the load-distribution method excluding the VLAN option:
Router(config)#
port-channel load-balance dst-ip exclude vlan
Cisco IOS Interface and Hardware Component Command Reference
852
O through R
port-channel load-balance
Related Commands Command Description
interface port-channel Creates a port-channel virtual interface and enters interface configuration
mode.
port-channel load-balance mpls Sets the load distribution method among the ports in the bundle for
MPLS packets.
show etherchannel Displays the EtherChannel information for a channel.
Cisco IOS Interface and Hardware Component Command Reference
853
O through R
port-channel load-balance (interface)
port-channel load-balance (interface)
To configure a member link for load balancing, a default service instance weight, or weighted load balancing
on port-channel member links, use the port-channel load-balance command in interface configuration mode.
To cause the default weight to revert to 1 and to disable weighted load balancing, use the no form of this
command.
port-channel load-balance {link link-id|weighted {default weight weight|link {alllink-id}|rebalance
{disableweight}}}
no port-channel load-balance {link link-id|weighted {default weight|link|rebalance}}
Syntax Description link Configures a member link for egress load balancing.
link-id Integer from 1 to 16 that identifies the member link.
• When used with the weighted keyword, the link-id is a comma-delimited list of
member link IDs to use for weighted load balancing.
weighted Configures weighted load balancing on the port channel.
default weight Configures a default weight for a service instance.
weight Integer from 1 to 10000 that is the weight value. The default is 1.
• When used with the rebalance keyword, this value is the threshold weight used to
trigger automatic rebalancing. The default is 4.
all Configures load balancing across all active member links.
rebalance Sets or disables the automatic rebalance threshold.
disable Disables automatic rebalancing.
Command Default Service instance weight and weighted load balancing are not configured.
Command Modes Interface configuration (config-if)
Command History Release Modification
15.0(1)S This command was introduced.
Usage Guidelines When weighted load balancing enabled, the weight configured using this command is inherited by all service
instances on the port channel that have not been specifically configured with a weight.
Configuring a default weight is optional; the default weight value is 1.
Use of the weightedand link keywords is required to enable weighted load balancing on a port channel. When
the all keyword is configured, traffic is distributed across all active member links in the port channel. When
one or more member links is specified, traffic is distributed across only those member links. To allow for
out-of-order configuration, link IDs not yet assigned to member links may be specified. Issuing this command
Cisco IOS Interface and Hardware Component Command Reference
854
O through R
port-channel load-balance (interface)
with the weighted and link keywords more than once under the same port-channel interface results in
overwriting the command settings previously configured.
If this command is configured with a list of link IDs and the member link corresponding to one of those link
IDs is later configured with a different ID, a warning is displayed on the console that notifies the user that the
action will affect the current load-balancing activity.
When the disable keyword is configured, automatic rebalancing is not performed and the operator must
manually invoke rebalancing by issuing the port-channel load-balance weighted rebalancecommand in
privileged EXEC mode.
When the disable keyword is not configured, either the configured or a default weight is used to automatically
rebalance service instances. Automatic rebalancing occurs when the average absolute deviation (AAD) of the
current distribution exceeds the configured threshold and when the resulting AAD of the rebalanced distribution
is less than the current AAD. If automatic rebalancing does not result in a lower AAD, the rebalancing is not
done, even if the current AAD exceeds the threshold.
The AAD calculation is (1/n )*Sum(|w(i ) - m|) for all n member links where:
n = number of member links
m = mean of member link weights (sum of all Ethernet service instance weights divided by n )
w (i ) = sum of Ethernet service instance weights on member link i
Two conditions cause the port-channel load-balancecommand to fail:
• An invalid weight is configured.
• An invalid link ID is provided.
Examples The following example shows how to configure port-channel load balancing for all port-channel
member links:
Router(config)# interface port-channel1
Router(config-if)# port-channel load-balance weighted link all
Cisco IOS Interface and Hardware Component Command Reference
855
O through R
port-channel load-balance mpls
port-channel load-balance mpls
To set the load-distribution method among the ports in the bundle for Multiprotocol Label Switching (MPLS)
packets, use the port-channel load-balance mplscommand in global configuration mode. To reset the load
distribution to the default settings, use the no form of this command.
port-channel load-balance mpls {label|label-ip}
no port-channel load-balance mpls
Syntax Description label Specifies using the MPLS label to distribute packets; see the “Usage Guidelines” section for
additional information.
label-ip Specifies using the MPLS label or the IP address to distribute packets; see the “Usage Guidelines”
section for additional information.
Command Default label-ip
Command Modes Global configuration
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.
If you select label, these guidelines apply:
• With only one MPLS label, the last MPLS label is used.
• With two or more MPLS labels, the last two labels (up to the fifth label) are used.
If you select label-ip, these guidelines apply:
• With IPv4 and three or fewer labels, the source IP address XOR-destination IP address is used to distribute
packets.
• With four or more labels, the last two labels (up to the fifth label) are used.
• With non-IPv4 packets, the distribution method is the same as the label method.
Examples This example shows how to set the load-distribution method to label-ip:
Router(config)#
port-channel load-balance mpls label-ip
Router(config)#
Cisco IOS Interface and Hardware Component Command Reference
856
O through R
port-channel load-balance mpls
Related Commands Command Description
interface port-channel Creates a port-channel virtual interface and enters interface configuration mode.
show etherchannel Displays the EtherChannel information for a channel.
Cisco IOS Interface and Hardware Component Command Reference
857
O through R
port-channel load-balance weighted rebalance
port-channel load-balance weighted rebalance
To perform a rebalancing of all port-channel interfaces configured with weighted load balancing, use the
port-channel load-balance weighted rebalance command in privileged EXEC mode.
port-channel load-balance weighted rebalance [interface port-channel number]
Syntax Description interface (Optional) Specifies a port channel enabled for weighted load balancing.
port-channel (Optional) Specifies an Ethernet channel of interfaces.
number (Optional) Integer from 1 to 564 that identifies the port-channel interface.
Command Default Load rebalancing is not performed.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)S This command was introduced.
Usage Guidelines If a port-channel interface is specified, only that interface is rebalanced; otherwise all port channels with
weighted load balancing enabled are rebalanced.
This command may be used when automatic rebalancing is disabled via the port-channel load-balance
weighted rebalance disable command or when a rebalancing of service instances is desired prior to reaching
the automatic rebalance threshold.
If the specified interface is not a port channel enabled for weighted load balancing, the port-channel
load-balance weighted rebalancecommand has no effect on load balancing on that interface.
Examples The following example shows how to force a rebalancing of service instances, based on their assigned
weights, for all port channels with weighted load balancing enabled:
Router# port-channel load-balance weighted rebalance
Related Commands Command Description
port-channel load-balance (interface) Configures a member link for load balancing, a default service
instance weight, or weighted load balancing on port-channel member
links.
Cisco IOS Interface and Hardware Component Command Reference
858
O through R
port-channel load-balancing vlan-manual
port-channel load-balancing vlan-manual
To apply the VLAN-manual load-balancing method globally to all Gigabit EtherChannel (GEC) interfaces,
use the port-channelload-balancingvlan-manualcommand in global configuration mode. To reset to the
default, use the no form of this command.
port-channel load-balancing vlan-manual
no port-channel load-balancing
Syntax Description This command has no arguments or keywords.
Command Default Flow-based load balancing is enabled.
Command Modes Global configuration (config)
Command History Release Modification
Cisco IOS XE Release 2.1 This command was introduced.
Cisco IOS XE Release 2.5 This command was modified. The default was changed from no load balancing
is enabled to flow-based load balancing.
Usage Guidelines The port-channelload-balancingvlan-manual command applies the VLAN-manual load-balancing method
globally to all port channels on the router. If you do not use this command to explicitly set the global
load-balancing method to VLAN-manual, the load-balancing method is set to flow-based.
The load-balancing method enabled on a port channel with the load-balancingcommand takes precedence
over this command.
Load balancing uses the concept of buckets to map traffic flows to the member links of a port channel. The
different traffic flows are mapped to the buckets and each bucket has one active member link associated with
it. All flows that are mapped to a bucket use the member link associated with that bucket.
There are two methods of load balancing on a GEC interface:
• VLAN-manual--All packets forwarded over the same VLAN subinterface are considered part of the
same flow and are mapped to the member link specified in the configuration.
• Flow-based--Traffic flows are mapped to different member links based on the packet header.
Examples This example shows how to set the load-balancing method to VLAN-manual:
Router(config)# port-channel
load-balancing vlan-manual
Related Commands Command Description
interface port-channel Creates a port-channel virtual interface.
load-balancing Applies a load-balancing method to a GEC interface.
Cisco IOS Interface and Hardware Component Command Reference
859
O through R
port-channel load-balancing vlan-manual
Command Description
show interfaces port-channel etherchannel Displays the load-balancing bucket distribution currently in
use for a GEC interface.
show etherchannel load-balancing Displays the load-balancing method applied to GEC interfaces.
Cisco IOS Interface and Hardware Component Command Reference
860
O through R
port-channel load-defer
port-channel load-defer
To configure the port load share deferral interval for all port channels, use the port-channelload-defer
command in global configuration mode. To reset the port defer interval to the default setting, use the no form
of this command.
port-channel load-defer seconds
no port-channel load-defer seconds
Syntax Description seconds Sets the time interval in seconds by which load sharing will be deferred on the switch. Valid range
is from 1 to 1800 seconds. The default deferal interval is 120 seconds
Command Default The port defer interval is 120 seconds.
Command Modes Global configuration (config)
Command History Release Modification
12.2(33)SXH This command was introduced.
12.2(50)SY This command was introduced. Added the seconds variable for use in Cisco IOS Release
12.2(50)SY.
Usage Guidelines To reduce data loss following a stateful switchover (SSO), port load share deferral can be enabled by entering
the port-channelportload-defer command on a port channel of a switch that is connected by a multichassis
EtherChannel (MEC) to a virtual switching system (VSS). Port load share deferral temporarily prevents the
switch from forwarding data traffic to MEC member ports on a failed chassis of the VSS while the VSS
recovers from the SSO.
The load share deferral interval is determined by a single global timer configurable by the
port-channelload-defer command. After an SSO switchover, a period of several seconds to several minutes
can be required for the reinitialization of line cards and the reestablishment of forwarding tables, particularly
multicast topologies.
The valid range of seconds is 1 to 1800 seconds; the default is 120 seconds.
Examples This example shows how to set the global port deferral interval to 60 seconds:
Router(config)#
port-channel load-defer 60
Router(config)#
This example shows how to verify the configuration of the port deferral interval on a port channel:
Router# show etherchannel 50 port-channel
Port-channels in the group:
----------------------
Port-channel: Po50 (Primary Aggregator)
------------
Age of the Port-channel = 0d:00h:22m:20s
Cisco IOS Interface and Hardware Component Command Reference
861
O through R
port-channel load-defer
Logical slot/port = 46/5 Number of ports = 3
HotStandBy port = null
Port state = Port-channel Ag-Inuse
Protocol = LACP
Fast-switchover = disabled
Load share deferral = enabled defer period = 60 sec
time left = 57 sec
Router#
Related Commands Command Description
interface port-channel Creates a port channel virtual interface and enters interface configuration
mode.
port-channel port load-defer Enables the port load share deferral feature on a port channel.
show etherchannel Displays the EtherChannel information for a channel.
Cisco IOS Interface and Hardware Component Command Reference
862
O through R
port-channel min-links
port-channel min-links
To specify that a minimum number of bundled ports in an EtherChannel is required before the channel can
be active, use the port-channelmin-links command in interface configuration mode. To return to the default
settings, use the no form of this command.
port-channel min-links min-num
no port-channel min-links
Syntax Description min-num Minimum number of bundled ports in a channel that is required before the channel can be active;
valid values are from 2 to 8.
Command Default min-num is 1
Command Modes Interface configuration
Command History Release Modification
12.2(18)SXF Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is supported on LACP (802.3ad) ports only. More than one LACP secondary-port channel can
belong to the same channel group. This command is applied to all port channels in the same group.
If fewer links than the specified number are available, the port-channel interface does not become active.
Use the showrunning-config command to verify the configuration.
Examples This example shows how to specify that a minimum number of bundled ports in an EtherChannel is
required before the channel can be active:
Router(config-if)#
port-channel min-links 3
Router(config-if)#
Related Commands Command Description
show running-config Displays the status and configuration of the module or Layer 2 VLAN.
Cisco IOS Interface and Hardware Component Command Reference
863
O through R
port-channel per-module load-balance
port-channel per-module load-balance
To enable load balance on a per-module basis among the ports in a bundle, use the port-channel per-module
load-balance command in global configuration mode. To return to the default settings, use the no form of this
command.
port-channel per-module load-balance
no port-channel per-module load-balance
Syntax Description This command has no arguments or keywords.
Command Default The load balance method is not enabled per module.
Command Modes Global configuration (config)
Command History Release Modification
12.2(18)ZY This command was introduced.
12.2(33)SXH This command was integrated into Cisco IOS Release 12.2(33)SXH.
Usage Guidelines The port-channelper-moduleload-balance command allows you to enable or disable port-channel load
balancing on a per-module basis. You can use the port-channelload-balancemodulecommand to specify the
load balancing method on a specific module after you have entered the port-channelper-moduleload-balance
command.
Examples The following example shows how to enable load balancing on a per-module basis:
Router(config)# port-channel per-module load-balance
Related Commands Command Description
port-channel hash-distribution Sets the hash distribution algorithm method among the ports in a bundle.
port-channel load-balance Sets the load balance method among the ports in a bundle.
Cisco IOS Interface and Hardware Component Command Reference
864
O through R
port-channel port load-defer
port-channel port load-defer
To enable the temporary deferral of port load sharing during the connection or reconnection of a port channel,
use the port-channelportload-defer command in interface configuration mode. To disable the deferral of
port load sharing on a port channel, use the no form of this command.
port-channel port load-defer
no port-channel port load-defer
Syntax Description This command has no keywords or arguments.
Command Default The port load share deferral feature is not enabled on a port channel .
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SXH This command was introduced.
12.2(50)SY This command was introduced.
Usage Guidelines To reduce data loss following a stateful switchover (SSO), a port load share deferral can be enabled on a port
channel of a switch that is connected by a multichassis EtherChannel (MEC) to a virtual switching system
(VSS). The load share deferral interval prevents the switch from forwarding data traffic to MEC member ports
on a failed chassis of the VSS while the VSS recovers from the SSO.
When load share deferral is enabled on a port channel, the assignment of a member port’s load share is delayed
for a period that is configurable globally by the port-channelload-defer command. During the deferral period,
the load share of a deferred member port is set to 0. In this state, the deferred port is capable of receiving data
and control traffic, and of sending control traffic, but the port is prevented from sending data traffic over the
MEC to the VSS. Upon expiration of the global deferral timer, the deferred member port exits the deferral
state and the port assumes its normal configured load share.
Load share deferral is applied only if at least one other member port of the port channel is currently active
with a nonzero load share. If a port enabled for load share deferral is the first member bringing up the
EtherChannel, the deferral feature does not apply and the port will forward traffic immediately.
The load share deferral interval is determined by a single global timer configurable from 1 to 1800 seconds
by the port-channelload-defer command. The default interval is 120 seconds. After an SSO switchover, a
period of several seconds to several minutes can be required for the reinitialization of line cards and the
reestablishment of forwarding tables, particularly multicast topologies.
Examples This example shows how to enable the load share deferral feature on port channel 50 of a switch that
is an MEC peer to a VSS:
Router(config)#
interface port-channel 50
Router(config-if)#
port-channel port load-defer
This will enable the load share deferral feature on this port-channel.
Cisco IOS Interface and Hardware Component Command Reference
865
O through R
port-channel port load-defer
The port-channel should connect to a Virtual Switch (VSS).
Do you wish to proceed? [yes/no]:
yes
Router(config-if)#
This example shows how to verify the state of the port deferral feature on a port channel:
Router# show etherchannel 50 port-channel
Port-channels in the group:
----------------------
Port-channel: Po50 (Primary Aggregator)
------------
Age of the Port-channel = 0d:00h:22m:20s
Logical slot/port = 46/5 Number of ports = 3
HotStandBy port = null
Port state = Port-channel Ag-Inuse
Protocol = LACP
Fast-switchover = disabled
Load share deferral = enabled defer period = 120 sec time left = 57 sec
Router#
Related Commands Command Description
interface port-channel Creates a port channel virtual interface and enters interface configuration mode.
port-channel load-defer Configures the global port load share deferral time interval for port channels.
show etherchannel Displays the EtherChannel information for a channel.
Cisco IOS Interface and Hardware Component Command Reference
866
O through R
port-channel standalone-disable
port-channel standalone-disable
To disable the EtherChannel standalone option in a port channel, use the port-channel standalone-disable
command in interface configuration mode. To enable this option, use the no form of this command.
port-channel standalone-disable
no port-channel standalone-disable
Syntax Description This command has no arguments or keywords.
Command Default The EtherChannel standalone option is enabled.
Command Modes Interface configuration (config-if)
Command History Release Modification
12.2(33)SXI3 This command was introduced.
15.1(1)SG This command was integrated into Cisco IOS Release
15.1(1)SG.
Cisco IOS XE Release 3.3SG This command was integrated into Cisco IOS XE
Release 3.3SG.
Usage Guidelines The port-channel standalone-disable command is supported on the Catalyst 6000 series switches. This
command can be used only when the port-channel protocol type is Link Aggregation Control Protocol (LACP).
This command enables you to change the current behavior when a physical port cannot bundle an LACP
EtherChannel.
Examples The following example shows how to disable the EtherChannel standalone option in a port channel:
Device(config-if)# port-channel standalone-disable
Related Commands Command Description
show etherchannel Displays the EtherChannel information for a channel.
Cisco IOS Interface and Hardware Component Command Reference
867
O through R
pos ais-shut
pos ais-shut
To send the line alarm indication signal (LAIS) when the Packet-over-SONET (POS) interface is placed in
any administrative shutdown state, use the pos ais-shut command in interface configuration mode.
pos ais-shut
Syntax Description This command has no arguments or keywords.
Command Default No LAIS is sent.
Command Modes Interface configuration
Command History Release Modification
11.1CC This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines In Automatic Protection Switching (APS) environments, LAIS can be used to force a protection switch. This
command forces an APS switch when the interface is placed in the administrative shutdown state.
For more information on APS, refer to the “Configuring Serial Interfaces” chapter in the Cisco IOS Interface
and Hardware Component Configuration Guide.
This command does not have a no form.
Examples The following example forces the alarm indication on POS OC-3 interface 0 in slot 3:
Router(config)# interface pos 3/0
Router(config-if)# shutdown
Router(config-if)# pos ais-shut
Cisco IOS Interface and Hardware Component Command Reference
868
O through R
pos delay triggers
pos delay triggers
To enable a POS alarm trigger delay, or to enable path level alarms as triggers to bring the POS line card
protocol to down, use the pos delay triggers command in POS interface configuration mode. To disable POS
alarm trigger delays, use the no form of this command.
pos delay triggers [{line ms|path ms}]
no pos delay triggers [{line ms|path ms}]
Syntax Description line Specifies the delay for SONET line level triggers. The following alarms are considered line level
triggers: section loss of signal, section loss of frame, line alarm indication signal. SONET line level
triggers bring the line protocol down by default
path Specifies that SONET path level alarms should trigger the line protocol to go down.
ms Specifies the time, in milliseconds, that POS trigger should wait before setting the line protocol to
down. If no ms value is entered, the default value of 100 ms is used.
Command Default POS line level alarm triggers are enabled by default. If a POS line level alarm trigger occurs and no
configuration changes have been made using theposdelaytriggerslinemscommand, the line protocol is set to
down immediately with no delay.
POS path level alarm triggers are disabled by default. A path level alarm will not set the line protocol to down
unless the posdelaytriggerspath command has been entered.
If no ms value is entered but posdelaytriggersline command is configured, the default ms value for line level
triggers is 100 ms.
If no ms value is entered and posdelaytriggerspath is enabled, the default ms value is set at 100 ms for path
level triggers.
Command Modes POS interface configuration
Command History Release Modification
12.1(12c)EX1 This command was introduced for Cisco 7304 routers.
12.2(18)S This command was introduced on Cisco 7304 routers running Cisco IOS Release 12.2S.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command was integrated into Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
12.4 This command was integrated into Cisco IOS Release 12.4 Mainline. This command supports
Cisco 7200 Series, Cisco 7304 Series, and Cisco 7600 Series routers.
12.4(24)T This command was integrated into a release earlier than Cisco IOS Release 12.4(24)T. This
command supports Cisco 7200 Series, Cisco 7304 Series, and Cisco 7600 Series routers.
Usage Guidelines A trigger is an alarm that, when asserted, causes the line protocol to go down.
Cisco IOS Interface and Hardware Component Command Reference
869
O through R
pos delay triggers
When one or more triggers are asserted, the line protocol of the interface goes down. The POS Alarm Trigger
Delay feature provides the option to delay triggering of the line protocol of the interface from going down
when an alarm triggers the line protocol to go down. For instance, if you configure the POS alarm delay for
150 ms, the line protocol will not go down for 150 ms after receiving the trigger. If the trigger alarm stays up
for more than 150 ms, the link is brought down as it is now. If the trigger alarm clears before 150 ms, the line
protocol is not brought down.
By default, the following line and section alarms are triggers for the line protocol to go down:
• Section loss of signal
• Section loss of frame
• Line alarm indication signal
For line and section alarm triggers, the line protocol of the POS card is brought down immediately if a trigger
is received and no POS alarm trigger delay is specified. The delay can be set anywhere from 50 to 10000 ms.
If POS alarm triggering is configured but no ms value is entered, the POS alarm trigger delay is 100 ms.
The following path alarms are not triggers by default. These path alarms, however, can be configured as
triggers:
• Path alarm indication signal
• Path remote defect indication
The POS Alarm Trigger Delay feature can be used to configure these alarms as triggers, as well as to configure
the exact POS alarm trigger delay for these triggers. The default delay values for these triggers, if no value is
specified, is also 100 ms.
Examples In the following configuration example, the POS line card will wait 50 ms after receiving a line level
trigger before setting the line protocol to down. If the alarm that began the line level trigger clears
during that 50 ms, the line protocol will remain up. If the alarm that began the line trigger remains
after that 50 ms, the line protocol will go down.
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# interface pos 1/0
Router(config-if)# pos delay triggers line 50
In the following configuration example, the POS line card will wait 110 ms after receiving a path
trigger before setting the line protocol to down. If the alarm that began the path trigger clears during
that 110 ms, the line protocol will remain up. If the alarm that began the path trigger remains after
110 ms, the line protocol will go down.
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# interface pos 1/0
Router(config-if)# pos delay triggers path 110
In the following example, the showcontrollersposslot/interface-numberdetail command is used to
verify the POS alarm trigger delay. In this particular example, the delay is 100 ms (italicized for
emphasis below) for both line level triggers and path level triggers.
Router# show controllers pos 4/0 detail
Cisco IOS Interface and Hardware Component Command Reference
870
O through R
pos delay triggers
POS4/0
SECTION
LOF = 0 LOS = 0 BIP(B1) = 22
LINE
AIS = 0 RDI = 0 FEBE = 21 BIP(B2) = 38
PATH
AIS = 0 RDI = 1 FEBE = 25 BIP(B3) = 31
PLM = 0 UNEQ = 0 TIM = 0 TIU = 0
LOP = 0 NEWPTR = 4 PSE = 2 NSE = 3
Active Defects:None
Active Alarms: None
Alarm reporting enabled for:SF SLOS SLOF B1-TCA B2-TCA PLOP B3-TCA
Line triggers delayed 100 ms
Path triggers delayed 100 ms
...
Related Commands Command Description
show controllers pos slot / interface-number Shows the content of POS controllers, including the amount
detail of delay for line triggers.
Cisco IOS Interface and Hardware Component Command Reference
871
O through R
pos flag
pos flag
To set the SONET overhead bytes in the frame header to meet a specific standards requirement or to ensure
interoperability with the equipment of another vendor, use the posflagcommand in interface configuration
mode. To remove the setting of the SONET overhead bytes, use the no form of this command.
pos flag commandpos flag {c2|j0|s1s0} value
no pos flag {c2|j0|s1s0} value
Syntax Description c2 value Path signal identifier used to identify the payload content type. The default value is 0xCF.
j0 value Section trace byte (formerly the C1 byte). For interoperability with Synchronous Digital
Hierarchy (SDH) equipment in Japan, use the value 0x1. The byte value can be 0 to 255.
sls0 value S1 and S0 bits (bits 5 and 6 of the H1 #1 payload pointer byte). Use the following values to
tell the SONET transmission equipment the SS bit:
• For OC-3c, use 0 (this is the default).
• For AU-4 container in SDH, use 2.
The S1 and S0 bits can be 0 to 3. Values 1 and 3 are undefined. The default value is 0.
Command Default The default c2 value is 0xCF. The default sls0 value is 0.
Command Modes Interface configuration
Command History Release Modification
11.2 GS This command was introduced to support the Cisco 12000 series Internet routers.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use the following values to tell the SONET transmission equipment the payload type:
• For PPP, or High-Level Data Link Control (HDLC) when required, use 0xCF (this is the default).
• For ATM, use 0x13.
• For other equipment, use any nonzero value.
• The byte value can be 0 to 255.
Examples The following example sets the path signal identifier used to identify the payload content type to
ATM on the pos interface in slot 9:
Router(config)# interface pos 9/0
Cisco IOS Interface and Hardware Component Command Reference
872
O through R
pos flag
Router(config-if)# pos flag c2 0x13
Router(config-if)# end
Cisco IOS Interface and Hardware Component Command Reference
873
O through R
pos flag s1-byte rx-communicate
pos flag s1-byte rx-communicate
To direct the router to switch to internal clocking when it receives an S1 SONET overhead byte with a value
of 0xF, use the pos flag s1-byte rx-communicate command in interface configuration mode. To disable this
capability, use the no form of this command.
pos flag s1-byte rx-communicate
no pos flag s1-byte rx-communicate
Command Default Disabled
Command Modes Interface configuration
Command History Release Modification
12.2(28)SB This command was introduced on the Cisco 10000 series router.
Usage Guidelines The pos flag s1-byte rx-communicate command directs the router to switch the clock source to internal when
it receives an S1 SONET overhead byte with a value of 0xF. When the S1 SONET overhead byte changes
from 0xF to any other value, the clock source reverts back to the clock source specified in the user configuration.
The S1 SONET overhead byte is ignored by the receiving router unless the pos flag s1-byte rx-communicate
command is issued.
Examples The following example directs the router to switch to internal clocking when it receives an S1 SONET
overhead byte with a value of 0xF:
pos flag s1-byte rx-communicate
Related Commands Command Description
pos flag Assigns values for specific elements of the frame header. This command is typically
used to meet a standards requirement or to ensure interoperability with another vendor's
equipment.
pos flag s1-byte tx Controls the transmission of the S1 SONET overhead byte.
Cisco IOS Interface and Hardware Component Command Reference
874
O through R
pos flag s1-byte tx
pos flag s1-byte tx
To control the transmission of the S1 SONET overhead byte, use the pos flag s1-byte tx command in interface
configuration mode.
pos flag s1-byte tx value
Syntax Description value Set the S1 SONET overhead byte to a value in the range of 0x0 to 0xF.
Command Default The default is 0x0.
Command Modes Interface configuration
Command History Release Modification
12.2(28)SB This command was introduced on the Cisco 10000 series router.
Usage Guidelines In most situations, the default value for the S1 SONET overhead byte does not need to be changed. Refer to
the SONET standards for information about the possible values for the S1 SONET overhead byte and the
definition of each value.
Examples The following example sets the S1 SONET overhead byte to 0xF:
pos flag s1-byte tx 0xF
Related Commands Command Description
pos flag Assigns values for specific elements of the frame header. This command
is typically used to meet a standards requirement or to ensure
interoperability with another vendor's equipment.
pos flag s1-byte Directs the router to switch to internal clocking when it receives an S1
rx-communicate SONET overhead byte with a value of 0xF.
Cisco IOS Interface and Hardware Component Command Reference
875
O through R
pos framing
pos framing
To specify the framing used on the POS (Packet-over-SONET) interface, use the posframing command in
interface configuration mode. To return to the default SONET STS-3c framing mode, use the no form of this
command.
pos framing commandpos framing {sdh|sonet}
no pos framing
Syntax Description sdh Selects SDH STM-1 framing. This framing mode is typically used in Europe.
sonet Selects SONET STS-3c framing. This is the default.
Command Default SONET STS-3c framing
Command Modes Interface configuration
Command History Release Modification
11.2 This command was introduced.
11.3 This command was modified to change the posiframing-sdh command to posframing-sdh.
11.2GS The command syntax was changed from posframing-sdh to posframing.
The sonet keyword was added.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples The following example configures the interface for SDH STM-1 framing:
Router(config)# interface pos 3/0
Router(config-if)# pos framing sdh
Router(config-if)# no shutdown
Related Commands Command Description
clock source (interface) Controls the clock used by a G.703-E1 interface.
interface Configures an interface type, and enters interface configuration mode.
Cisco IOS Interface and Hardware Component Command Reference
876
O through R
pos report
pos report
To permit selected SONET alarms to be logged to the console for a POS (Packet-over-SONET) interface, use
the posreportcommand in interface configuration mode. To disable logging of select SONET alarms, use the
no form of this command.
pos report commandpos report
{b1-tca|b2-tca|b3-tca|lais|lrdi|pais|plop|prdi|rdool|sd-ber|sf-ber|slof|slos}
no pos report {b1-tca|b2-tca|b3-tca|lais|lrdi|pais|plop|prdi|rdool|sd-ber|sf-ber|slof|slos}
Syntax Description b1-tca Reports B1 bit-error rate (BER) threshold crossing alarm (TCA) errors.
b2-tca Reports B2 BER crossing TCA errors.
b3-tca Reports B3 BER crossing TCA errors.
lais Reports line alarm indication signal errors.
lrdi Reports line remote defect indication errors.
pais Reports path alarm indication signal errors.
plop Reports path loss of pointer errors.
prdi Reports path remote defect indication errors.
rdool Reports receive data out of lock errors.
sd-ber Reports signal degradation BER errors.
sf-ber Reports signal failure BER errors.
slof Reports section loss of frame errors.
slos Reports section los of signal errors.
Command Default The following alarms are reported by default:
• b1-tca
• b2-tca
• b3-tca
• plop
• sf-ber
• slof
• slos
Command Modes Interface configuration
Cisco IOS Interface and Hardware Component Command Reference
877
O through R
pos report
Command History Release Modification
11.1CC This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Reporting an alarm means that the alarm can be logged to the console. Just because an alarm is permitted to
be logged does not guarantee that it is logged. SONET alarm hierarchy rules dictate that only the most severe
alarm of an alarm group is reported. Whether an alarm is reported or not, you can view the current state of a
defect by checking the “Active Defects” line from the showcontrollersposcommand output. A defect is a
problem indication that is a candidate for an alarm.
For B1, the bit interleaved parity error report is calculated by comparing the BIP-8 code with the BIP-8 code
extracted from the B1 byte of the following frame. Differences indicate that section level bit errors have
occurred.
For B2, the bit interleaved parity error report is calculated by comparing the BIP-8/24 code with the BIP-8
code extracted from the B2 byte of the following frame. Differences indicate that line level bit errors have
occurred.
For B3, the bit interleaved parity error report is calculated by comparing the BIP-8 code with the BIP-8 code
extracted from the B3 byte of the following frame. Differences indicate that path level bit errors have occurred.
PAIS is sent by line terminating equipment (LTE) to alert the downstream path terminating equipment (PTE)
that it has detected a defect on its incoming line signal.
PLOP is reported as a result of an invalid pointer (H1, H2) or an excess number of new data flag (NDF)
enabled indications.
SLOF is detected when a severely error framing (SEF) defect on the incoming SONET signal persists for 3
milliseconds.
SLOS is detected when an all-zeros pattern on the incoming SONET signal lasts 19 plus or minus 3
microseconds or longer. This defect might also be reported if the received signal level drops below the specified
threshold.
To determine the alarms that are reported on the interface, use the showcontrollersposcommand.
Examples The following example enables reporting of SD-BER and LAIS alarms on the interface:
Router(config)# interface pos 3/0/0
Router(config-if)# pos report sd-ber
Router(config-if)# pos report lais
Router(config-if)# end
Related Commands Command Description
interface Configures an interface type, and enters interface configuration mode.
show controllers pos Displays information about the POS controllers.
Cisco IOS Interface and Hardware Component Command Reference
878
O through R
pos scramble-atm
pos scramble-atm
To enable SONET payload scrambling on a POS (Packet-over-SONET) interface, use the
posscramble-atmcommand in interface configuration mode. To disable scrambling, use the no form of this
command.
pos scramble-atm commandpos scramble-atm
no pos scramble-atm
Syntax Description This command has no arguments or keywords.
Command Default Scrambling is disabled.
Command Modes Interface configuration
Command History Release Modification
11.1CA This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines SONET payload scrambling applies a self-synchronous scrambler (x43+1) to the Synchronous Payload
Envelope (SPE) of the interface to ensure sufficient bit transition density. Both ends of the connection must
use the same scrambling algorithm. When enabling POS scrambling on a VIP2 POSIP on the Cisco 7500
series router that has a hardware revision of 1.5 or higher, you can specify CRC 16 only (that is, CRC 32 is
currently not supported).
To determine the hardware revision of the POSIP, use the showdiag command.
To determine whether scrambling is enabled on the interface, use the showinterfacepos command or the
showrunning-config command.
Note SONET payload scrambling is enabled with the posscramble-atm command. SONET payload scrambling
applies a self-synchronous scrambler (x43+1) to the Synchronous Payload Envelope (SPE) of the interface
to ensure sufficient bit transition density. Both sides of the connection must be configured using the
posscramble-atm command. Currently, when connecting to a Cisco 7500 series router and using the
posscramble-atm command, you must specify the crc16 command rather than the crc32 command.
Examples The following example enables scrambling on the interface:
Router(config)# interface pos 3/0
Router(config-if)# pos scramble-atm
Router(config-if)# no shutdown
Router(config-if)# end
Cisco IOS Interface and Hardware Component Command Reference
879
O through R
pos scramble-atm
Related Commands Command Description
crc Sets the length of the CRC on an FSIP or HIP of the Cisco 7500 series routers or on
a 4-port serial adapter of the Cisco 7200 series routers.
interface Configures an interface type, and enters interface configuration mode.
show diag Displays hardware information for the router.
show interfaces pos Displays information about the Packet OC-3 interface in Cisco 7500 series routers.
Cisco IOS Interface and Hardware Component Command Reference
880
O through R
pos threshold
pos threshold
To set the bit-error rate (BER) threshold values of the specified alarms for a POS (Packet-Over-SONET)
interface, use the posthresholdcommand in interface configuration mode. To return to the default setting, use
the no form of this command.
pos threshold {b1-tca|b2-tca|b3-tca|sd-ber|sf-ber} rate
no pos threshold {b1-tca|b2-tca|b3-tca|sd-ber|sf-ber} rate
Syntax Description b1-tca B1 BER threshold crossing alarm. The default rate is 6.
b2-tca B2 BER threshold crossing alarm. The default rate is 6.
b3-tca B3 BER threshold crossing alarm. The default rate is 6.
sd-ber Signal degrade BER threshold. The default rate is 6.
sf-ber Signal failure BER threshold. The default rate is 3 (10e-3).
rate Bit-error rate from 3 to 9 (10-n).
Command Default The default rate is 6 for b1-tca, b2-tca, b3-tca, and sd-ber. The default rateis 3 (10e-3) for sf-ber.
Command Modes Interface configuration
Command History Release Modification
11.1CC This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines For B1, the bit interleaved parity error report is calculated by comparing the BIP-8 code with the BIP-8 code
extracted from the B1 byte of the following frame. Differences indicate that section level bit errors have
occurred.
For B2, the bit interleaved parity error report is calculated by comparing the BIP-8/24 code with the BIP-8
code extracted from the B2 byte of the following frame. Differences indicate that line level bit errors have
occurred.
For B3, the bit interleaved parity error report is calculated by comparing the BIP-8 code with the BIP-8 code
extracted from the B3 byte of the following frame. Differences indicate that path level bit errors have occurred.
SF-BER and SD-BER are sourced from B2 BIP-8 error counts (as is B2-TCA). However, SF-BER and SD-BER
feed into the automatic protection switching (APS) machine and can lead to a protection switch (if APS is
configured).
B1-TCA, B2-TCA, and B3-TCA do nothing more than print a log message to the console (if reports for them
are enabled).
Cisco IOS Interface and Hardware Component Command Reference
881
O through R
pos threshold
To determine the BER thresholds configured on the interface, use the showcontrollersposcommand.
Examples The following example configures thresholds on the interface:
Router(config)# interface pos 3/0/0
Router(config-if)# pos threshold sd-ber 8
Router(config-if)# pos threshold sf-ber 4
Router(config-if)# pos threshold b1-tca 4
Router(config-if)# end
Related Commands Command Description
interface Configures an interface type, and enters interface configuration mode.
pos report Permits selected SONET alarms to be logged to the console for a POS interface.
show controllers pos Displays information about the POS controllers.
Cisco IOS Interface and Hardware Component Command Reference
882
O through R
power inline
power inline
To determine how inline power is applied to the device on the specified switch port, use the powerinline
command in interface configuration mode. To return the setting to its default, use the no form of this command.
power inline {auto [max max-milliwatts]|never|police|static [max max-milliwatts]}
no power inline [police]
Cisco Integrated Services Routers Generation 2 (ISR G2) with Cisco Gigabit EtherSwitch enhanced
high-speed WAN interface cards (EHWICs)
power inline {auto|never|port max max-milliwatts}
no power inline {auto|never|port max max-milliwatts}
Cisco 4451-X Integrated Services Router
power inline
auto |[ max max-milliwatts ]|never |redundant
no power inline
auto |[ max max-milliwatts ]|never |redundant
Syntax Description auto Turns on the device discovery protocol and applies power to the device, if
found.
max max-milliwatts (Optional) Specifies the maximum amount of power, in milliwatts, that a device
connected to a port can consume. Range: 4000 to 16800. Default: 15400.
never Turns off the device discovery protocol and stops supplying power to the
device.
police Turns on inline power policing; optional if entering the no form of the
command. Default is disabled.
static Allocates power from the system power pool to a port.
port max max-milliwatts Specifies the maximum power allocated to the port. The maximum power can
be set between 4,000 to 20,000 milliwatts.
redundant Puts the inline power supply in redundant mode (default mode). (For boost
mode, use the no form of the command; for example, no power inline
redundant.)
Command Default Power is applied when a telephone is detected on the port (auto).max-milliwatts is 15400 milliwatts. Inline
power policing is disabled.
Power is applied when a telephone is detected on the port (auto). The maximum power limit is 20000 milliwatts.
Inline power policing is disabled.
Command Modes Interface configuration (config-if)
Cisco IOS Interface and Hardware Component Command Reference
883
O through R
power inline
Command History Release Modification
12.0(5)XU This command was introduced.
12.2(2)XT This command was integrated to support switchport creation on Cisco 2600
series, Cisco 3600 series, and Cisco 3700 series routers.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T to support
switchport creation .
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17b)SXA This command was changed to include the static and maxmax-milliwatts
keywords and arguments.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Cisco
IOS Release 12.2(17d)SXB.
12.2(33)SXH This command was changed to include the police keyword .
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SXH2 This command was changed to increase the max-watts maximum to 16800
milliwatts for the WS-F6K-48-AF and the WS-F6K-GE48-AF modules. The
default setting remains 15400 milliwatts. See the “Usage Guidelines” section
for additional information.
15.1(2)T This command was modified. The portmaxkeyword and max-milliwatts argument
were added.
Cisco IOS XE Release This command was integrated into Cisco IOS XE Release 3.9S.
3.9S
Usage Guidelines The policekeyword appears if you have a WS-F6K-48-AF or other inline power daughter card that supports
power monitoring and inline power policing.
Inline power is supported only on switch ports that are connected to an IP phone. Before you enable inline
power on a switch port, you must enter the switchport command.
The following information applies to WS-F6K-48-AF and WS-F6K-GE48-AF inline power cards:
• In Cisco IOS Release 12.2(33)SXH2 and later releases, the configurable range of maximum power using
the max keyword is 4000 to 16800 milliwatts. For earlier releases, the configurable range for maximum
power is 4000 to 15400 milliwatts. For all releases, if no maximum power level is configured, the default
maximum power is 15400 milliwatts.
Note To support a large number of inline-powered ports using power levels above 15400 milliwatts on an inline
power card, we recommend using the static keyword so that the power budget is deterministic.
• In Cisco IOS Release 12.2(33)SXH2 and later releases, when you enter the auto keyword and CDP is
enabled on the port, an inline-powered device that supports CDP can negotiate a power level up to 16800
milliwatts unless a lower maximum power level is configured. For earlier releases, the inline-powered
Cisco IOS Interface and Hardware Component Command Reference
884
O through R
power inline
device can negotiate a power level up to 15400 milliwatts or the configured maximum power level, if it
is configured lower than 15400 milliwatts.
Cisco ISR G2 with Cisco Gigabit EHWICs
• The portmaxkeyword and max-milliwatts argument are available only on the Firebee cards with
Power-over-Ethernet (PoE).
Examples The following example shows how to set the inline power to the off mode on a switch port:
Router(config)# interface fastethernet5/1
Router(config-if)# switchport
Router(config-if)# power inline never
The following example shows how to allocate power from the system power pool to a switch port:
Router(config)# interface fastethernet5/1
Router(config-if)# switchport
Router(config-if)# power inline static max 15000
The following example shows how to turn on inline power policing to a switch port:
Router(config)# interface gigabitethernet6/3
Router(config-if)# switchport
Router(config-if)# power inline police
Cisco ISR G2 with Cisco Gigabit EtherSwitch EHWICs
The following example shows how to turn on inline power to a switch port:
Router(config)# interface gigabitethernet
0/1/3
Router(config-if)#
power inline
auto{!-condition!}
The following example shows how to set maximum inline power to a switch port:
Router(config)# interface
gigabitethernet
0/1/3
The following example shows how to disable inline power to the switch port:
Router(config)# interface
gigabitethernet
0/1/3
Router(config-if)# power inline
never{!-condition!}
Cisco IOS Interface and Hardware Component Command Reference
885
O through R
power inline
Cisco 4451-X Integrated Service Router
The following example shows auto option for power inline command configured on the front panel
Gigabit Ethernet port.
Router(config)# interface gigabitEthernet 0/0/0
Router(config-if)# power inline auto
In this example, an attempt is made to configure the inline power to be in boost mode by using the
no form of the power inline redundant command. The inline power mode is not changed to boost
mode because that requires a total power available in redundant mode of 1000W.
Router# show power
Main PSU :
Configured Mode : Boost
Current runtime state same : Yes
Total power available : 2000 Watts
POE Module :
Configured Mode : Boost
Current runtime state same : Yes
Total power available : 1000 Watts
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# no power inline redundant
*Jan 31 03:42:40.947: %PLATFORM_POWER-6-MODEMISMATCH: Inline power not in Boost mode
Router(config)# exit
*Jan 31 03:36:13.111: %SYS-5-CONFIG_I: Configured from console by console
Router# show power
Main PSU :
Configured Mode : Boost
Current runtime state same : Yes
Total power available : 1450 Watts
POE Module :
Configured Mode : Boost
Current runtime state same : No
Total power available : 500 Watts
In this example, power for the main power supply is configured to be in boost mode by using the no
form of the power main redundant command. This sets the power for the main power supply in
boost mode to be 1450 W and the inline power in redundant mode as 500W.
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# no power main redundant
Router(config)#
*Jan 31 03:35:22.284: %PLATFORM_POWER-6-MODEMATCH: Inline power is in Redundant mode
Router(config)#
Router(config)# exit
Router#
*Jan 31 03:36:13.111: %SYS-5-CONFIG_I: Configured from console by console
Router# show power
Main PSU :
Configured Mode : Boost
Current runtime state same : Yes
Total power available : 1450 Watts
POE Module :
Configured Mode : Redundant
Current runtime state same : Yes
Total power available : 500 Watts
Router#
Cisco IOS Interface and Hardware Component Command Reference
886
O through R
power inline
Related Commands Command Description
show power inline Displays the power status for the specified port or for all ports.
switchport priority extend Determines how the telephone connected to the specified port handles priority
traffic received on its incoming port.
switchport voice vlan Configures the voice VLAN on the port.
Cisco IOS Interface and Hardware Component Command Reference
887
O through R
power enable
power enable
To turn on power for the modules, use the power enablecommand in global configuration mode. To power
down a module, use the no form of this command.
power enable module slot
no power enable module slot
Syntax Description module slot Specifies a module slot number; see the “Usage Guidelines” section for valid values.
Command Default Enabled
Command Modes Global configuration
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(18)SXD This command was changed to allow you to disable power to empty slots.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines When you enter the no power enable module slot command to power down a module, the module’s
configuration is not saved.
When you enter the no power enable module slot command to power down an empty slot, the configuration
is saved.
The slot argument designates the module number. Valid values for slotdepend on the chassis that is used. For
example, if you have a 13-slot chassis, valid values for the module number are from 1 to 13.
Examples This example shows how to turn on the power for a module that was previously powered down:
Router(config)#
power enable module 5
Router(config)#
This example shows how to power down a module:
Router(config)#
no power enable module 5
Router(config)#
Related Commands Command Description
show power Displays information about the power status.
Cisco IOS Interface and Hardware Component Command Reference
888
O through R
power inline
power inline
To determine how inline power is applied to the device on the specified switch port, use the powerinline
command in interface configuration mode. To return the setting to its default, use the no form of this command.
power inline {auto [max max-milliwatts]|never|police|static [max max-milliwatts]}
no power inline [police]
Cisco Integrated Services Routers Generation 2 (ISR G2) with Cisco Gigabit EtherSwitch enhanced
high-speed WAN interface cards (EHWICs)
power inline {auto|never|port max max-milliwatts}
no power inline {auto|never|port max max-milliwatts}
Cisco 4451-X Integrated Services Router
power inline
auto |[ max max-milliwatts ]|never |redundant
no power inline
auto |[ max max-milliwatts ]|never |redundant
Syntax Description auto Turns on the device discovery protocol and applies power to the device, if
found.
max max-milliwatts (Optional) Specifies the maximum amount of power, in milliwatts, that a device
connected to a port can consume. Range: 4000 to 16800. Default: 15400.
never Turns off the device discovery protocol and stops supplying power to the
device.
police Turns on inline power policing; optional if entering the no form of the
command. Default is disabled.
static Allocates power from the system power pool to a port.
port max max-milliwatts Specifies the maximum power allocated to the port. The maximum power can
be set between 4,000 to 20,000 milliwatts.
redundant Puts the inline power supply in redundant mode (default mode). (For boost
mode, use the no form of the command; for example, no power inline
redundant.)
Command Default Power is applied when a telephone is detected on the port (auto).max-milliwatts is 15400 milliwatts. Inline
power policing is disabled.
Power is applied when a telephone is detected on the port (auto). The maximum power limit is 20000 milliwatts.
Inline power policing is disabled.
Command Modes Interface configuration (config-if)
Cisco IOS Interface and Hardware Component Command Reference
889
O through R
power inline
Command History Release Modification
12.0(5)XU This command was introduced.
12.2(2)XT This command was integrated to support switchport creation on Cisco 2600
series, Cisco 3600 series, and Cisco 3700 series routers.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T to support
switchport creation .
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17b)SXA This command was changed to include the static and maxmax-milliwatts
keywords and arguments.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Cisco
IOS Release 12.2(17d)SXB.
12.2(33)SXH This command was changed to include the police keyword .
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SXH2 This command was changed to increase the max-watts maximum to 16800
milliwatts for the WS-F6K-48-AF and the WS-F6K-GE48-AF modules. The
default setting remains 15400 milliwatts. See the “Usage Guidelines” section
for additional information.
15.1(2)T This command was modified. The portmaxkeyword and max-milliwatts argument
were added.
Cisco IOS XE Release This command was integrated into Cisco IOS XE Release 3.9S.
3.9S
Usage Guidelines The policekeyword appears if you have a WS-F6K-48-AF or other inline power daughter card that supports
power monitoring and inline power policing.
Inline power is supported only on switch ports that are connected to an IP phone. Before you enable inline
power on a switch port, you must enter the switchport command.
The following information applies to WS-F6K-48-AF and WS-F6K-GE48-AF inline power cards:
• In Cisco IOS Release 12.2(33)SXH2 and later releases, the configurable range of maximum power using
the max keyword is 4000 to 16800 milliwatts. For earlier releases, the configurable range for maximum
power is 4000 to 15400 milliwatts. For all releases, if no maximum power level is configured, the default
maximum power is 15400 milliwatts.
Note To support a large number of inline-powered ports using power levels above 15400 milliwatts on an inline
power card, we recommend using the static keyword so that the power budget is deterministic.
• In Cisco IOS Release 12.2(33)SXH2 and later releases, when you enter the auto keyword and CDP is
enabled on the port, an inline-powered device that supports CDP can negotiate a power level up to 16800
milliwatts unless a lower maximum power level is configured. For earlier releases, the inline-powered
Cisco IOS Interface and Hardware Component Command Reference
890
O through R
power inline
device can negotiate a power level up to 15400 milliwatts or the configured maximum power level, if it
is configured lower than 15400 milliwatts.
Cisco ISR G2 with Cisco Gigabit EHWICs
• The portmaxkeyword and max-milliwatts argument are available only on the Firebee cards with
Power-over-Ethernet (PoE).
Examples The following example shows how to set the inline power to the off mode on a switch port:
Router(config)# interface fastethernet5/1
Router(config-if)# switchport
Router(config-if)# power inline never
The following example shows how to allocate power from the system power pool to a switch port:
Router(config)# interface fastethernet5/1
Router(config-if)# switchport
Router(config-if)# power inline static max 15000
The following example shows how to turn on inline power policing to a switch port:
Router(config)# interface gigabitethernet6/3
Router(config-if)# switchport
Router(config-if)# power inline police
Cisco ISR G2 with Cisco Gigabit EtherSwitch EHWICs
The following example shows how to turn on inline power to a switch port:
Router(config)# interface gigabitethernet
0/1/3
Router(config-if)#
power inline
auto{!-condition!}
The following example shows how to set maximum inline power to a switch port:
Router(config)# interface
gigabitethernet
0/1/3
The following example shows how to disable inline power to the switch port:
Router(config)# interface
gigabitethernet
0/1/3
Router(config-if)# power inline
never{!-condition!}
Cisco IOS Interface and Hardware Component Command Reference
891
O through R
power inline
Cisco 4451-X Integrated Service Router
The following example shows auto option for power inline command configured on the front panel
Gigabit Ethernet port.
Router(config)# interface gigabitEthernet 0/0/0
Router(config-if)# power inline auto
In this example, an attempt is made to configure the inline power to be in boost mode by using the
no form of the power inline redundant command. The inline power mode is not changed to boost
mode because that requires a total power available in redundant mode of 1000W.
Router# show power
Main PSU :
Configured Mode : Boost
Current runtime state same : Yes
Total power available : 2000 Watts
POE Module :
Configured Mode : Boost
Current runtime state same : Yes
Total power available : 1000 Watts
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# no power inline redundant
*Jan 31 03:42:40.947: %PLATFORM_POWER-6-MODEMISMATCH: Inline power not in Boost mode
Router(config)# exit
*Jan 31 03:36:13.111: %SYS-5-CONFIG_I: Configured from console by console
Router# show power
Main PSU :
Configured Mode : Boost
Current runtime state same : Yes
Total power available : 1450 Watts
POE Module :
Configured Mode : Boost
Current runtime state same : No
Total power available : 500 Watts
In this example, power for the main power supply is configured to be in boost mode by using the no
form of the power main redundant command. This sets the power for the main power supply in
boost mode to be 1450 W and the inline power in redundant mode as 500W.
Router# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# no power main redundant
Router(config)#
*Jan 31 03:35:22.284: %PLATFORM_POWER-6-MODEMATCH: Inline power is in Redundant mode
Router(config)#
Router(config)# exit
Router#
*Jan 31 03:36:13.111: %SYS-5-CONFIG_I: Configured from console by console
Router# show power
Main PSU :
Configured Mode : Boost
Current runtime state same : Yes
Total power available : 1450 Watts
POE Module :
Configured Mode : Redundant
Current runtime state same : Yes
Total power available : 500 Watts
Router#
Cisco IOS Interface and Hardware Component Command Reference
892
O through R
power inline
Related Commands Command Description
show power inline Displays the power status for the specified port or for all ports.
switchport priority extend Determines how the telephone connected to the specified port handles priority
traffic received on its incoming port.
switchport voice vlan Configures the voice VLAN on the port.
Cisco IOS Interface and Hardware Component Command Reference
893
O through R
power redundancy-mode
power redundancy-mode
To set the power-supply redundancy mode, use the power redundancy-mode command in global configuration
mode.
power redundancy-mode {combined|redundant}
Syntax Description combined Specifies no redundancy (combine power-supply outputs).
redundant Specifies redundancy (either power supply can operate the system).
Command Default redundant
Command Modes Global configuration
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Examples This example shows how to set the power supplies to the no-redundancy mode:
Router(config)#
power redundancy-mode combined
Router(config)#
This example shows how to set the power supplies to the redundancy mode:
Router(config)#
power redundancy-mode redundant
Router(config)#
Related Commands Command Description
show power Displays information about the power status.
Cisco IOS Interface and Hardware Component Command Reference
894
O through R
ppp link
ppp link
To generate the Point-to-Point Protocol (PPP) Link Control Protocol (LCP) down and keepalive-failure link
traps or enable calls to the interface-reset vector, use the ppplinkcommand in interface configuration mode.
To disable the PPP LCP down and keepalive-failure link traps or calls to the interface-reset vector, use the
no form of this command.
ppp link {reset|trap}
no ppp link {reset|trap}
Syntax Description reset Specifies calls to the interface reset vector.
trap Specifies the PPP LCP down and keepalive-failure link traps.
Command Default The defaults are as follows:
• The calls are sent to the interface-reset vector.
• The traps are sent when the LCP goes down.
Command Modes Interface configuration
Command History Release Modification
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine
720.
The noppplinktrap command disables the sending of the link traps when the LCP goes down.
In the event that the PPP calls the interface-reset vector while the LCP is configured or closed, Up/Down
status messages will display on the console. If a leased-line configuration is up but the peer is not responding,
PPP may call the interface-reset vector once per minute. This situation may result in the Up/Down status
messages on the console. Use the noppplinkresetcommand to disable calls to the interface-reset vector. PPP
will continue to attempt to negotiate with the peer, but the interface will not be reset between each attempt.
Examples This example shows how to enable calls to the interface-reset vector:
Router(config-if)#
ppp link reset
Router(config-if)#
This example shows how to disable calls to the interface-reset vector:
Router(config-if)#
no ppp link reset
Router(config-if)#
Cisco IOS Interface and Hardware Component Command Reference
895
O through R
ppp link
This example shows how to generate the PPP LCP down/keepalive-failure link traps:
Router(config-if)#
ppp link trap
Router(config-if)#
This example shows how to disable the sending of the link traps when the LCP goes down:
Router(config-if)#
no ppp link trap
Router(config-if)#
Cisco IOS Interface and Hardware Component Command Reference
896
O through R
ppp loopback no-backoff
ppp loopback no-backoff
To enable continuous Link Control Protocol (LCP) negotiation of loopback links with PPP sessions, use the
ppp loopback no-backoff command in interface configuration mode. To restrict negotiation of loopback
links with PPP sessions to ten LCP Configure Request (CONFREQ) messages, use the no form of this
command.
ppp loopback no-backoff
no ppp loopback no-backoff
Command Default Loopback links with PPP sessions disconnect after ten LCP CONFREQ messages are sent for negotiation.
Command Modes Interface configuration (config-if)
Command History Release Modification
Cisco IOS XE Release 3.10.1S This command was introduced.
Usage Guidelines A circuit loopback indicates wiring issues in a device or faults with external switching equipment. The default
functionality of the PPP protocol is to check for loopbacks and disconnect the session link when a loopback
is detected. The PPP protocol includes a mechanism that detects a circuit loopback; that is, it detects a situation
when a circuit feeds back upon itself, which results in the device reading its own output on that link. The first
phase of loopback detection occurs during LCP negotiation when the circuit is being established. If you enable
keepalives on a link, the second phase of loopback detection occurs after the connection is established.
Note Loopback detection depends upon successful negotiation of the LCP magic number during link establishment.
LCP magic numbers are used in PPP to avoid frame loopbacks.
Use the ppp loopback no-backoff command when it becomes essential to prevent disconnection of session
links whenever a loopback is detected. This ensures that the link does not go down and that there is a continuous
attempt to establish connection. Link negotiations continue until a unique LCP magic number is received.
The no form of this command restores the default behavior in which the loopback links with PPP sessions
disconnect after only ten LCP CONFREQ messages are sent for negotiation.
Example
The following example shows how to enable the ppp loopback no-backoff command on a serial
interface:
Device> enable
Device# configure terminal
Device(config)# interface Serial1/0/0:1
Device(config-if)# no ip address
Device(config-if)# encapsulation ppp
Device(config-if)# ppp loopback no-backoff
Device(config-if)# end
Cisco IOS Interface and Hardware Component Command Reference
897
O through R
ppp loopback no-backoff
Related Commands Command Description
encapsulation ppp Enables PPP on an interface.
no ip address Removes an IP address or disables IP processing.
ppp loopback ignore Disables PPP loopback detection.
Cisco IOS Interface and Hardware Component Command Reference
898
O through R
ppp multilink mrru
ppp multilink mrru
To configure the maximum receive reconstructed unit (MRRU) value negotiated on a Multilink PPP (MLP)
bundle, use the pppmultilinkmrrucommand in interface configuration mode. To remove the configured
MRRU, use the no form of this command.
ppp multilink mrru [{local|remote}] bytes
no ppp multilink mrru [{local|remote}] bytes
Syntax Description local (Optional) Configures the local MRRU value.
remote (Optional) Configures the minimum value that the software will accept from the peer when it
advertises its MRRU.
bytes MRRU value, in bytes. Valid value range is 128 to 16384.
Command Default The default values for the local MRRU are the value of the multilink group interface maximum transmission
unit (MTU) for multilink group members, and 1524 bytes for all other interfaces.
Command Modes Interface configuration
Command History Release Modification
12.3(7)T This command was introduced.
12.0(28)S This command was integrated into Cisco IOS Release 12.0(28)S.
12.2(27)SB This command was integrated into Cisco IOS Release 12.2(27)SB.
12.2(28)S This command was integrated into Cisco IOS Release 12.2(28)S.
12.2(31)SB This command was integrated into Cisco IOS Release 12.2(31)SB.
12.2(33)SRB1 This command was integrated into Cisco IOS Release 12.2(33)SRB1.
12.2(33)SRC This command was integrated into Cisco IOS Release 12.2(33)SRC.
15.2(2)SNI This command was implemented on the Cisco ASR 901 Series Aggregation Services Routers.
Usage Guidelines This command allows the MRRU value to be configured on MLP interfaces and member links. This command
is useful for interfaces running an application such as IP Security (IPsec), where the addition of the IPsec
header causes the packet to exceed the 1500-byte MTU of a typical IP packet.
When using a large-bundle interface MTU size, you must ensure that the individual frames-per-fragment size
passed to the link interfaces is not greater than the link interface MTU setting or the peer MRRU setting. This
size limit can be achieved in one of the following two ways:
• Configure the link interface MTU setting appropriately.
• Configure fragmentation such that the link MTU settings will never be violated.
Cisco IOS Interface and Hardware Component Command Reference
899
O through R
ppp multilink mrru
When MLP is configured, several physical interfaces can constitute one logical connection to the peer. To
represent the logical connection, software provides a logical interface, often called the bundle interface. This
interface will have the IP address, for instance, and the MTU setting of the interface that IP uses when it is
deciding whether to fragment an IP datagram that needs to be forwarded. The physical interfaces forward
individual MLP fragments or frames that are given to them by the bundle interface.
The result of having to decide whether to fragment a packet is that, whereas with simple PPP the interface
MTU must not exceed the peer’s MRRU, with MLP the MTU size of the bundle interface must not exceed
the MRRU setting of the peer.
The MRRU settings on both sides need not be equal, but the “must not exceed” rule just specified must be
followed; otherwise a system might send several fragments that, when reconstructed as a frame, will be too
large for the peer’s receive buffer.
Once you configure the MRRU on the bundle interface, you enable the router to receive large reconstructed
MLP frames. You may want to configure the bundle MTU so that the router can send large MLP frames,
although it is not strictly necessary. The maximum recommended value for the bundle MTU is the value of
the peer’s MTU. The software will automatically reduce the bundle interface MTU if necessary to avoid
violating the peer’s MRRU.
When the bundle interface MTU is tuned to a higher number, then depending upon the fragmentation
configuration, the link interface may be given larger frames to send. There are two possible solutions to this
problem, as follows:
• Ensure that fragmentation is performed such that fragments are sized less than the link interface MTU
(refer to the command pages for the pppmultilinkfragmentdisable and pppmultilinkfragmentdelay
commands for more information about packet fragments).
• Configure the MTUs of the link interfaces such that they can send the larger frames.
Note Be careful when configuring MLP MRRU negotiation in a virtual private dialup network (VPDN) environment
when an L2TP network server (LNS) is not running Cisco IOS Release 12.3(7)T. The software performs strict
matching on the MRRU values in earlier versions of Cisco IOS software.
Examples The following example shows how to configure MRRU negotiation on a virtual template with
synchronous serial interfaces. The example also applies to asynchronous serial interfaces.
multilink virtual-template 1
!
interface virtual-template 1
ip address 10.13.1.1 255.255.255.0
mtu 1600
!
interface serial 0/0
ppp multilink
ppp multilink mrru local 1600
mtu 1600
!
interface serial 0/1
ppp multilink
ppp multilink mrru local 1600
mtu 1600
Cisco IOS Interface and Hardware Component Command Reference
900
O through R
ppp multilink mrru
The following example shows how to configure MRRU negotiation on multilink groups:
interface multilink 10
ip address 10.13.1.1 255.255.255.0
ppp multilink mrru local 1600
mtu 1600
!
interface serial 0/0
ppp multilink
multilink-group 10
mtu 1600
!
interface serial 0/1
ppp multilink
multilink-group 10
mtu 1600
The following example shows how to configure MRRU negotiation on dialer interfaces:
Note Dialer interfaces are not supported on the Cisco 7600 series router.
interface dialer 1
ip address 10.13.1.1 255.255.255.0
encapsulation ppp
dialer remote-name 2610-2
dialer idle-timeout 30 inbound
dialer string 5550101
dialer pool 1
dialer-group 1
no cdp enable
ppp multilink
ppp multilink mrru local 1600
Related Commands Command Description
encapsulation ppp Sets the PPP encapsulation method.
interface dialer Defines a dialer rotary group.
mtu Adjusts the maximum packet size or MTU size.
multilink virtual-template Specifies a virtual template from which the specified MLP bundle
interface can clone its interface parameters.
ppp multilink Enables MLP on an interface.
ppp multilink fragment delay Specifies a maximum time for the transmission of a packet fragment on
an MLP bundle.
ppp multilink fragment disable Disables packet fragmentation.
ppp multilink fragmentation Sets the maximum number of fragments a packet will be segmented into
before being sent over the bundle.
Cisco IOS Interface and Hardware Component Command Reference
901
O through R
ppp multilink mrru
Command Description
ppp multilink group Restricts a physical link to joining only a designated multilink-group
interface.
ppp multilink interleave Enables MLP interleaving.
Cisco IOS Interface and Hardware Component Command Reference
902
O through R
pri-group
pri-group
To specify ISDN PRI on a channelized E1 or T1 card on a Cisco 7500 series router, use the pri-group command
in controller configuration mode. To remove the ISDN PRI, use the no form of this command.
pri-group commandpri-group [timeslots range]
no pri-group
Syntax Description timeslots range (Optional) Specifies a single range of values from 1 to 23.
Command Default Disabled
Command Modes Controller configuration
Command History Release Modification
11.0 This command was introduced.
12.2(13)T This command is no longer supported in Cisco IOS Mainline or Technology-based releases.
It may conintue to appear in Cisco IOS 12.2S-family releases.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines When you configure ISDN PRI, you must first specify an ISDN switch type for PRI and an E1 or T1 controller.
Examples The following example specifies ISDN PRI on T1 slot 1, port 0:
Router# isdn switch-type primary-4ess
Router(config)# controllers t1 1/0
Router(config-controller)# framing esf
Router(config-controller)# linecode b8zs
Router(config-controller)# pri-group timeslots 2-6
Related Commands Command Description
controller Configures a T1 or E1 controller and enters controller configuration mode.
interface serial Specifies a serial interface created on a channelized E1 or channelized T1 controller
(for ISDN PRI, CAS, or robbed-bit signaling).
isdn switch-type (PRI) Specifies the central office switch type on the ISDN PRI interface.
Cisco IOS Interface and Hardware Component Command Reference
903
O through R
priority1
priority1
To set a preference level for a Precision Time Protocol clock, use the priority1 command in PTP clock
configuration mode. To remove a priority1 configuration, use the no form of this command.
priority1 priorityvalue
no priority1 priorityvalue
Syntax Description priorityvalue Number value of the preference level. The range is from 0 to 255; lower values indicate a
higher precedence. The default value is 128.
Command Default The default preference level is 128.
Command Modes PTP clock configuration (config-ptp-clk)
Command History Release Modification
15.0(1)S This command was introduced.
15.1(2)SNG This command was implemented on the Cisco ASR 901 Series Aggregation Services Router.
Usage Guidelines Slave devices use the priority1 value when selecting a master clock. The priority1 value has precedence over
the priority2 value.
Examples The following example shows how to configure a ptp priority1 value:
Device> enable
Device# configure terminal
Device# ptp clock ordinary domain 0
Device(config-ptp-clk)# priority1 128
Device(config-ptp-clk)# end
Related Commands Command Description
priority2 Sets the PTP priority2 value.
Cisco IOS Interface and Hardware Component Command Reference
904
O through R
priority2
priority2
To set a set a secondary preference level for a Precision Time Protocol clock, use the priority2 command in
PTP clock configuration mode. To remove a priority2 configuration, use the no form of this command.
priority2 priorityvalue
no priority2 priorityvalue
Syntax Description priorityvalue The number value of the preference level. The range is from 0 to 255; lower values indicate
a higher precedence. The default value is 128.
Command Default The default preference level is 128.
Command Modes PTP clock configuration (config-ptp-clk)
Command History Release Modification
15.0(1)S This command was introduced.
15.1(2)SNG This command was implemented on the Cisco ASR 901 Series Aggregation Services Router.
Usage Guidelines Slave devices use the priority2 value to select a master clock; the priority2 value is only considered when the
device cannot use priority1 and other clock attributes to select a clock.
Examples The following example shows how to configure the ptp priority2 value:
Device> enable
Device# configure terminal
Device# ptp clock ordinary domain 0
Device(config-ptp-clk)# priority2 128
Device(config-ptp-clk)# end
Related Commands Command Description
priority1 Sets the PTP priority1 value.
Cisco IOS Interface and Hardware Component Command Reference
905
O through R
proactive enable
proactive enable
To enable automatic triggering of Forward Error Correction-Fast Re-Route (FEC-FRR), use the proactive
enable command in DWDM configuration mode. To disable automatic triggering, use the no form of this
command.
proactive enable
This command has no arguments or keywords.
Command Modes DWDM Controller (config-controller)
Command History Release Modification
15.2(1)S This command was introduced on the Cisco 7600 series routers.
Usage Guidelines
Examples This example shows how to enable automatic triggering of Forward Error Correction-Fast Re-Route
(FEC-FRR):
Router# configure terminal
Router(config)# controller dwdm 0/1
Router(config-controller)# proactive enable
Related Commands Command Description
proactive trig-threshold Configures the trigger threshold of Forward Error Correction-Fast Re-Route
(FEC-FRR).
proactive trig-window Configures the trigger window (in milliseconds) in which Fast Re-Route may be
triggered.
proactive rvrt-threshold Configures the revert threshold to trigger reverting from the Forward Error
Correction-Fast Re-Route (FEC-FRR) route back to the original route.
proactive rvrt-window Configures the revert window in which reverting from the Forward Error
Correction-Fast Re-Route (FEC-FRR) route back to the original route is triggered.
Cisco IOS Interface and Hardware Component Command Reference
906
O through R
proactive rvrt-threshold
proactive rvrt-threshold
To configure the revert threshold to trigger reverting from the Forward Error Correction-Fast Re-Route
(FEC-FRR) route back to the original route, use the proactive rvrt-threshold command in DWDM
configuration mode. To remove the revert threshold, use the no form of this command.
proactive rvrt-threshold x-coeff y-power
no proactive rvrt-threshold x-coeff y-power
Syntax Description x-coeff Bit error rate coefficient (x of xE-y). The range is 1 to 9.
y-power Bit error rate exponent (y of xE-y). The range is 3 to 9.
Command Default Standard FEC mode: 1E-5
Enhanced FEC Mode: 1E-4
Command Modes DWDM Controller (config-controller)
Command History Release Modification
15.2(1)S This command was introduced on the Cisco 7600 series routers.
Examples This example shows how to configure the revert threshold for FEC-FRR:
Router>enable
Router# configure terminal
Ruter(config)# controller dwdm 0/1
Router(config-controller)# proactive rvrt-threshold 1 6
Related Commands Command Description
proactive enable Enables automatic triggering of Forward Error Correction-Fast Re-Route
(FEC-FRR).
proactive trig-threshold Configures the trigger threshold of Forward Error Correction-Fast Re-Route
(FEC-FRR).
proactive trig-window Configures the trigger window in which Fast Re-Route may be triggered.
proactive rvrt-window Configures the revert window in which reverting from the Forward Error
Correction-Fast Re-Route (FEC-FRR) route back to the original route is triggered.
Cisco IOS Interface and Hardware Component Command Reference
907
O through R
proactive rvrt-window
proactive rvrt-window
To configure the revert window in which reverting from the Forward Error Correction-Fast Re-Route
(FEC-FRR) route back to the original route is triggered, use the proactive rvrt-window command in DWDM
configuration mode. To remove the revert window, use the no form of this command.
proactive rvrt-window window
no proactive rvrt-window window
Syntax Description window The length of time (in milliseconds) of the window in which reverting from FEC-FRR may be
triggered. The range is 2000 to 100000.
Command Default The default value of time is 2000.
Command Modes DWDM configuration (config-controller)
Command History Release Modification
15.2(1)S This command was introduced on the Cisco 7600 series routers.
Examples This example shows how to configure the window in which reverting from FEC-FRR may be
triggered:
Router# configure terminal
Router(config)# controller dwdm 0/1
Router(config-controller)# proactive rvrt-window 20345
Related Commands Command Description
proactive enable Enables automatic triggering of Forward Error Correction-Fast Re-Route
(FEC-FRR).
proactive trig-threshold Configures the trigger threshold of Forward Error Correction-Fast Re-Route
(FEC-FRR).
proactive trig-window Configures the trigger window (in milliseconds) in which Fast Re-Route may be
triggered.
proactive rvrt-threshold Configures the revert threshold to trigger reverting from the Forward Error
Correction-Fast Re-Route (FEC-FRR) route back to the original route.
Cisco IOS Interface and Hardware Component Command Reference
908
O through R
proactive trig-threshold
proactive trig-threshold
To configure the trigger threshold of Forward Error Correction-Fast Re-Route (FEC-FRR), use the proactive
trig-threshold command in DWDM configuration mode. To remove the trigger threshold, use theno form
of this command.
proactive trig-threshold x-coeff y-power
no proactive trig-threshold x-coeff y-power
Syntax Description x-coeff Bit error rate coefficient (x of xE-y). The range is 1 to 9. Default is 1.
y-power Bit error rate exponent (y of xE-y). The range is 3 to 9.
Command Default Standard FEC mode: 6E-5
Enhanced FEC Mode: 6E-4
Command Modes
DWDM Controller (config-controller)
Command History Release Modification
15.2(1)S This command was introduced on the Cisco 7600 series routers.
Examples This example shows how to configure the trigger threshold of Forward Error Correction-Fast Re-Route
(FEC-FRR).
Router# configure terminal
Router(config)# controller dwdm 0/1
Router(config-controller)#proactive trig-threshold 1 9
Related Commands Command Description
proactive enable Enables automatic triggering of
Forward Error Correction-Fast
Re-Route (FEC-FRR).
proactive trig-window Configures the trigger window (in
milliseconds) in which Fast
Re-Route may be triggered.
proactive rvrt-threshold Configures the revert threshold to
trigger reverting from the Forward
Error Correction-Fast Re-Route
(FEC-FRR) route back to the
original route.
Cisco IOS Interface and Hardware Component Command Reference
909
O through R
proactive trig-threshold
Command Description
proactive rvrt-window Configures the revert window in
which reverting from the Forward
Error Correction-Fast Re-Route
(FEC-FRR) route back to the
original route is triggered.
Cisco IOS Interface and Hardware Component Command Reference
910
O through R
protection-group
protection-group
Use this command to configure virtual protection group interface.
protection-group group id type STS48c
Syntax Description Syntax Description:
group id Identifier for the interface that is created
type Protection group type
It can be STS, STS3c, STS12c, and STS48c
Command Default None
Command Modes Controller configuration
Command History Release Modification
Cisco IOS XE Everest Support for this command was introduced for the Cisco NCS 4200 Series and
16.5.1 Cisco ASR 900 Series Routers.
Usage Guidelines This command is used for configuring protection group parameters.
Examples The following example shows how to configure protection group:
enable
configure terminal
protection-group 401 type STS48c
controller protection group 401
type STS48c
cem-group 19001 cep
end
Related Commands Command Description
show protection-group Verifies the protection group configuration.
Cisco IOS Interface and Hardware Component Command Reference
911
O through R
protection-group [working | protect]
protection-group [working | protect]
Use this command to configure protection group roles.
protection-group group id [working | protect]
Syntax Description Syntax Description:
group id Identifier for the interface that is created
working The working interface for protection group
protect The protect interface for protection group
Command Default None
Command Modes Controller configuration
Command History Release Modification
Cisco IOS XE Everest Support for this command was introduced for the Cisco NCS 4200 Series and
16.5.1 Cisco ASR 900 Series Routers.
Usage Guidelines Define the role either working interface or protect interface in the protection group.
Examples The following example shows how to configure UPSR work path protection:
enable
configure terminal
controller mediatype 0/3/6
mode sonet
controller sonet 0/3/6
rate oc48
sts-1 1-48 mode sts-48c
protection-group 401 working
end
Related Commands Command Description
show protection-group Verifies the protection group configuration.
Cisco IOS Interface and Hardware Component Command Reference
912
O through R
protocol gre
protocol gre
To specify GRE as the tunnel mode and to set the GRE key for configuring the L3VPN encapsulation profile,
use the protocolgre command in L3 VPN encapsulation configuration mode. To remove the transport source,
use the no form of this command.
protocol gre [key gre key]
no protocol [gre]
Syntax Description key (Optional) Specifies the key for GRE tunnel interface.
gre key (Optional) The GRE key value. The range is from 0 to 4294967295.
Command Default The tunnel mode and GRE key are not specified.
Command Modes L3VPN Encapsulation Configuration (config-l3vpn-encap-ip)
Command History Release Modification
12.2(33)SRE This command was introduced.
Examples The following example shows how to specify GRE as the tunnel mode and to set the GRE key:
Router(config-l3vpn-encap-ip)# protocol gre key 500
Related Commands Command Description
l3vpn encapsulation ip Configures the L3VPN encapsulation profile.
transport ipv4 Specifies IPv4 transport source mode and the transport source interface.
show l3vpn encapsulation ip Displays the profile health and the underlying tunnel interface.
Cisco IOS Interface and Hardware Component Command Reference
913
O through R
ptp clock
ptp clock
To create a Precision Time Protocol clock and specify the clock mode, use the ptpclock command in the
global configuration mode. To remove a ptp clock configuration, use the no form of this command.
ptp clock {ordinary|transparent} boundary domain domain
no ptp clock {ordinary|transparent} boundary domain domain
Syntax Description ordinary Sets the PTP clock to ordinary clocking mode.
transparent Sets the PTP clock to transparent clock mode; the router modifies outgoing PTP sync and
delay-request messages to account for residence time using the correction field in the follow-up
message.
boundary Sets the PTP clock to boundary clock mode; the router participates in selecting the best master
clock and can act as the master clock if no better clocks are detected.
domain The PTP clocking domain number. Valid values are from 0 to 127.
Command Default No default behavior or values.
Command Modes Global configuration (config)
Command History Release Modification
15.0(1)S This command was introduced.
Usage Guidelines This command creates a new PTP clock and enters clock configuration mode.
Examples The following example shows how to configure a PTP clock and enter clock configuration mode:
Router# configure terminal
Router# ptp clock ordinary domain 0
Router(config-ptp-clk)#
Related Commands Command Description
clock-port Specifies the mode of a PTP clock port.
Cisco IOS Interface and Hardware Component Command Reference
914
O through R
pulse-time
pulse-time
To enable pulsing data terminal ready (DTR) signal intervals on the serial interfaces, use the pulse-time
command in interface configuration mode. To restore the default interval, use the no form of this command.
pulse-time[{msecseconds}]
no pulse-time
Syntax Description msec (Optional) Specifies the use of milliseconds for the DTR signal interval.
seconds Integer that specifies the DTR signal interval in seconds. If the msec keyword is configured, the
DTR signal interval is specified in milliseconds. The default is 0.
Command Default 0 seconds
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.1(5)T The optional msec keyword was added to configure the interval in milliseconds.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines When the serial line protocol goes down (for example, because of loss of synchronization), the interface
hardware is reset and the DTR signal is held inactive for at least the specified interval. This function is useful
for handling encrypting or other similar devices that use the toggling of the DTR signal to resynchronize.
Use the optional msec keyword to specify the DTR signal interval in milliseconds. A signal interval set to
milliseconds is recommended on High-Speed Serial Interfaces (HSSIs).
Cisco IOS Interface and Hardware Component Command Reference
915
O through R
pulse-time
Note Whenever the pulse-time command is configured for the synchronous serial interface, do one of the following
after every interface state transition. This ensures that the DTR is pulsed down for the configured interval:
• In exec mode, issue the clear interface serial x/y/[z] command.
• In config mode of the serial interface, issue a shutdown, followed by no shutdown.
If you do not clear/reset the interface with one of these procedures, the pulse-time command will have no
effect.
Optionally, you can automate this procedure using an EEM or Tcl script. The following example EEM script
clears the serial interface after a disconnection:
event manager applet CLEAR_INIT_S000
event syslog pattern "Line protocol on Interface Serial0/0/0, changed state to down"
action 2.0 cli command "enable"
action 2.1 cli command "clear int Serial0/0/0"
action 3.0 syslog msg "clear int Serial0/0/0"
Examples The following example enables DTR pulse signals for 3 seconds on serial interface 2:
Router(config)# interface serial 2
Router(config-if)# pulse-time 3
The following example enables DTR pulse signals for 150 milliseconds on HSSI interface 2/1/0:
Router(config)# interface hssi 2/1/0
Router(config-if)# pulse-time msec 150
Cisco IOS Interface and Hardware Component Command Reference
916
O through R
rate
rate
Use this command to enable the rate for SONET and SDH ports.
For SONET:
rate [OC3 | OC12 | OC48 | OC192
For SDH:
rate [STM-1 | STM-4 | STM-16 | STM-64
Syntax Description Syntax Description:
OC3 Configures OC-3 port.
OC12 Configures OC-12 port.
OC-48 Configures OC-48 port.
OC-192 Configures OC-192 port.
STM-1 Configures STM-1 port.
STM-4 Configures STM-4 port.
STM-16 Configures STM-16 port.
STM-64 Configures STM-64 port.
Command Default None
Command Modes Controller configuration
Command History Release Modification
XE 3.18SP Support for this command was introduced on NCS 4200 Series for SONET.
XE Everest This command was integrated into the Cisco NCS 4200 Series and Cisco ASR 900 Series
16.6.1 for SDH.
Usage Guidelines Configuration of this command is mandatory.
Examples The following example shows how to configure Mediatype controller mode:
enable
configure terminal
controller MediaType 0/5/0
mode sonet
controller sonet 0/5/0
rate oc3
end
Cisco IOS Interface and Hardware Component Command Reference
917
O through R
rate
To configure mode VC4 CEP:
enable
configure terminal
controller sdh 0/5/0
rate stm 4
aug mapping au-4
au-4 1
mode vc4
cem-group 100 cep
end
Related Commands Command Description
controller sonet Configures the SONET mode.
show controller sonet Displays SONET controller configuration.
Cisco IOS Interface and Hardware Component Command Reference
918
O through R
recovered-clock
recovered-clock
To configure an associated clock ID with the corresponding CEM circuit, use the recovered-clock command
in global configuration mode.
recovered-clock bay slot
Syntax Description bay Identifies the bay where the CEM circuit is inserted. On NCS4200 series bay value is 0
always.
slot Physical slot number. The slot number is in a range either from 0 to 5 or 8 to 13, depending
on the slot in which the STM-1 card resides. The slot is always 0 for Cisco NCS 4200 Series.
The physical slot ranges from 0 to 5 for Cisco ASR 900 Series Routers. The value of physical
slot supported for Cisco ASR 920 Routers is 1.
Command Default None
Command Modes Global configuration
Command History Release Modification
XE 3.18SP This command was integrated into Cisco NCS 4200
Series
XE Everest 16.5.1 This command was integrated into Cisco NCS 4200
Series. This command was introduced into Cisco ASR
900 Series routers.
Usage Guidelines This command will be used when the clock needs to be recovered by the same CEM circuit.
The following example shows how to configure an associated clock ID with the corresponding CEM
circuit.
recovered-clock 0 3
clock recovered 1 differential cem 0 1
Related Commands Command Description
clock recovered adaptive/differential cem Associates the clock recovered ID to the CEM group.
Cisco IOS Interface and Hardware Component Command Reference
919
O through R
redundancy
redundancy
To enter redundancy configuration mode, use the redundancycommand in global configuration mode. This
command does not have a no form.
redundancy
Syntax Description This command has no arguments or keywords.
Command Default None
Command Modes Global configuration (config)
Command History Release Modification
12.1(5)XV1 This command was introduced on the Cisco AS5800 universal access server.
12.2(4)XF This command was introduced for the Cisco uBR10012 router.
12.2(11)T This command was integrated into Cisco IOS Release 12.2(11)T.
12.0(9)SL This command was integrated into Cisco IOS Release 12.0(9)SL.
12.0(16)ST This command was implemented on the Cisco 7500 series Internet routers.
12.2(14)S This command was integrated into Cisco IOS Release 12.2(14)S.
12.2(14)SX Support for this command was added for the Supervisor Engine 720.
12.2(18)S This command was implemented on the Cisco 7500 series Internet routers.
12.2(20)S This command was implemented on the Cisco 7304 router.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.3(7)T This command was implemented on the Cisco 7500 series Internet routers.
12.2(8)MC2 This command was implemented on the MWR 1900 Mobile Wireless Edge Router (MWR).
12.3(11)T This command was implemented on the MWR 1900 MWR.
12.3BC This command was integrated into Cisco IOS Release 12.3BC.
12.0(22)S This command was implemented on the Cisco 10000 series Internet routers.
12.2(18)SXE2 This command was integrated into Cisco IOS Release 12.2(18)SXE2.
12.2(28)SB This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(44)SQ This command was integrated into Cisco IOS Release 12.2(44)SQ. Support for the Cisco
RF Gateway 10 was added.
Cisco IOS Interface and Hardware Component Command Reference
920
O through R
redundancy
Release Modification
12.2(33) SRE This command was modified. The interchassis subconfiguration mode was added.
Usage Guidelines Use the redundancy command to enter redundancy configuration mode, where you can define aspects of
redundancy such as shelf redundancy for the Cisco AS5800 universal access server.
Cisco 10000 Series Router
Before configuring line card redundancy, install the Y-cables. Before deconfiguring redundancy, remove the
Y-cables.
The following restrictions apply to line card redundancy on the Cisco 10000 series router:
• Port-level redundancy is not supported.
• Redundant cards must occupy the two subslots within the same physical line card slot.
• The line card that will act as the primary line card must be the first line card configured, and it must
occupy subslot 1.
Cisco 7600 Series Router
From redundancy configuration mode, you can enter the main CPU submode to manually synchronize the
configurations that are used by the two supervisor engines.
From the main CPU submode, you can use the auto-sync command to use all the redundancy commands that
are applicable to the main CPU.
To select the type of redundancy mode, use the mode command.
Nonstop forwarding (NSF) with stateful switchover (SSO) redundancy mode supports IPv4. NSF with SSO
redundancy mode does not support IPv6, Internetwork Packet Exchange (IPX), and Multiprotocol Label
Switching (MPLS).
After you enter redundancy configuration mode, you can use the interchassis command to specify the
redundancy group number and enter interchassis redundancy mode. In the interchassis redundancy configuration
mode, you can do the following:
• Specify a backbone interface for the redundancy group using the backbone command.
• Exit from interchassis configuration mode using the exit command.
• Specify the IP address of the remote redundancy group member using the member ip command.
• Specify the multichassis LACP (mLACP) node ID, system MAC address, and system priority using the
node-id, system-mac, and system-priority commands.
• Define the peer monitoring method using the monitor command.
Cisco uBR10012 Universal Broadband Router
After you enter redundancy configuration mode, you can use the main-cpu command to enter main-CPU
redundancy configuration mode, which allows you to specify which files are synchronized between the active
and standby Performance Routing Engine (PRE) modules.
Cisco RF Gateway 10
At the redundancy configuration mode, you can do the following:
Cisco IOS Interface and Hardware Component Command Reference
921
O through R
redundancy
• Set a command to its default mode using the default command.
• Exit from a redundancy configuration using the exit command.
• Enter the line card group redundancy configuration using the linecard-group command.
• Enter main-CPU redundancy configuration mode using the main-cpu command, which allows you to
specify which files are synchronized between the active and standby Supervisor cards.
• Configure the redundancy mode for the chassis using the mode command.
• Enforce a redundancy policy using the policy command.
Examples The following example shows how to enable redundancy mode:
Router(config)# redundancy
Router(config-red)#
The following example shows how to assign the configured router shelf to the redundancy pair
designated as 25. This command must be issued on both router shelves in the redundant router-shelf
pair:
Router(config)# redundancy
Router(config-red)# failover group-number 25
Cisco 10000 Series Router
The following example shows how to configure two 4-port channelized T3 half eight line cards that
are installed in line card slot 2 for one-to-one redundancy:
Router(config)# redundancy
Router(config-r)# linecard-group 1 y-cable
Router(config-r-lc)# member subslot 2/1 primary
Router(config-r-lc)# member subslot 2/0 secondary
Cisco 7600 Series Router
The following example shows how to enter the main CPU submode:
Router(config)#
redundancy
Router(config-r)#
main-cpu
Router(config-r-mc)#
Cisco uBR10012 Universal Broadband Router
The following example shows how to enter redundancy configuration mode and display the commands
that are available in that mode on the Cisco uBR10012 router:
Router# configure terminal
Cisco IOS Interface and Hardware Component Command Reference
922
O through R
redundancy
Router(config)# redundancy
Router(config-r)# ?
Redundancy configuration commands:
associate Associate redundant slots
exit Exit from redundancy configuration mode
main-cpu Enter main-cpu mode
no Negate a command or set its defaults
The following example shows how to enter redundancy configuration mode and displays its associated
commands on the Cisco RFGW-10 chassis:
Router# configure terminal
Router(config)# redundancy
Router(config-r)#?
Redundancy configuration commands:
default Set a command to its defaults
exit Exit from redundancy configuration mode
linecard-group Enter linecard redundancy submode
main-cpu Enter main-cpu mode
mode redundancy mode for this chassis
no Negate a command or set its defaults
policy redundancy policy enforcement
The following example shows how to enter redundancy configuration mode and its associated
commands in the interchassis mode:
Router# configure terminal
Router(config)# redundancy
Router(config-r)#?
Redundancy configuration commands:
exit Exit from redundancy configuration mode
interchassis Enter interchassis mode
no Negate a command or set its defaults
Router(config-r)# interchassis group 100
R1(config-r-ic)# ?
Interchassis redundancy configuration commands:
backbone specify a backbone interface for the redundancy group
exit Exit from interchassis configuration mode
member specify a redundancy group member
mlacp mLACP interchassis redundancy group subcommands
monitor define the peer monitoring method
no Negate a command or set its defaults
Related Commands Command Description
associate slot Logically associates slots for APS processor redundancy.
auto-sync Enables automatic synchronization of the configuration files in NVRAM.
clear redundancy history Clears the redundancy event history log.
linecard-group y-cable Creates a line card group for one-to-one line card redundancy.
Cisco IOS Interface and Hardware Component Command Reference
923
O through R
redundancy
Command Description
main-cpu Enters main-CPU redundancy configuration mode for synchronization of
the active and standby PRE modules or Supervisor cards.
member subslot Configures the redundancy role of a line card.
mode (redundancy) Configures the redundancy mode of operation.
redundancy force-switchover Switches control of a router from the active RP to the standby RP.
show redundancy Displays information about the current redundant configuration and recent
changes in states or displays current or historical status and related
information on planned or logged handovers.
In the redundancy configuration of Cisco ASR 920 Series Routers, the
commands related to MR-APS feature are only supported.
Cisco IOS Interface and Hardware Component Command Reference
924
O through R
redundancy all-active replicate
redundancy all-active replicate
To enable all-active pseudowire redundancy mode with traffic replication, use the redundancy all-active
replicate command in global or interface configuration mode. To disable this functionality, use the no form
of this command.
redundancy all-activereplicate
no redundancy all-activereplicate
Syntax Description replicate Replicates the pseudowire state on the router.
Command Default No default behavior or values.
Command Modes Global configuration (config)
Interface configuration (config-if)
Command History Release Modification
Cisco IOS XE Release 3.18.1SP This command was introduced on the Cisco ASR 900 Series Routers.
Usage Guidelines The redundancy all-active replicate command maintains the working ad protect pseudowires in a pseudowire
redundancy configuration with MR-APS configuration to remain in the UP state.
Examples The following example shows the configuration at global level:
pseudowire-class 2G-PW
encapsulation mpls
status peer topology dual-homed
controller E1 0/1
framing unframed
cem-group 8 unframed
The following examples shows the configuration at interface level:
interface CEM0/1
no ip address
cem 8
xconnect 10.10.10.1 8 encapsulation mpls pw-class 2G-PW
backup peer 10.10.10.2 8 pw-class 2G-PW
redundancy all-active replicate
Related Commands Command Description
pseudowire class Configures the pseudowire class on the router.
template typepseudowire Configures the pseudowire template on the router.
Cisco IOS Interface and Hardware Component Command Reference
925
O through R
redundancy force-switchover
redundancy force-switchover
To force the standby Route Processor (RP) or Supervisor card to assume the role of the active RP or Supervisor
card, use the redundancy force-switchover command in privileged EXEC mode.
redundancy force-switchover [main-cpu]
Syntax Description main-cpu (Optional) Forces switchover to the main CPU.
Command Default No default behavior or values.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.0(16)ST This command was introduced.
12.1(10)EX2 This command was integrated into Cisco IOS Release 12.1(10)EX2.
12.0(17)ST This command was implemented on the Cisco 12000 series routers.
12.0(22)S This command replaces the force-failovercommand on the Cisco 10000 series routers.
12.2(14)SX Support for this command was added for the Supervisor Engine 720.
12.2(18)S This command was implemented on the Cisco 7500 series routers.
12.2(20)S Support was added for the Cisco 7304 router.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Cisco IOS Release
12.2(17d)SXB.
12.2(28)SB This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SCA This command was integrated into Cisco IOS Release 12.2(33)SCA.
12.2(44)SQ This command was integrated into Cisco IOS Release 12.2(44)SQ. Support for the Cisco
RF Gateway 10 was added.
Usage Guidelines Use the redundancy force-switchover command to switch control of a router from the active RP or Supervisor
card to the standby RP or Supervisor card. Both the active and standby RPs or Supervisor cards must have a
high availability Cisco IOS image installed and must be configured for Route Processor Redundancy (RPR)
mode before the redundancy force-switchover command can be used. Before the system switches over, it
verifies that the standby RP or Supervisor card is ready to take over.
Cisco IOS Interface and Hardware Component Command Reference
926
O through R
redundancy force-switchover
When you use the redundancy force-switchovercommand and the current running configuration is different
from the startup configuration, the system prompts you to save the running configuration before the switchover
is performed.
Note All line cards will reset in RPR mode on a switchover.
Note Before using this command in Cisco 7600 series routers, refer to the “Performing a Fast Software Upgrade”
section of the Cisco 7600 Series Router Cisco IOS Software Configuration Guide for additional information.
On Cisco 7600 series routers, the redundancy force-switchover command conducts a manual switchover to
the redundant supervisor engine. The redundant supervisor engine becomes the new active supervisor engine
running the new Cisco IOS image. The modules are reset and the module software is downloaded from the
new active supervisor engine.
The active and redundant supervisor engines do not reset on a Route Processor Redundancy Plus (RPR+)
switchover. The old active supervisor engine reboots with the new image and becomes the redundant supervisor
engine.
Beginning with Cisco IOS Release 12.2(33)SCA, you can force a Performance Routing Engine (PRE)
switchover using the redundancy force-switchover main-cpu command from either the primary or standby
PRE. If you force a switchover from the active PRE, both PREs synchronize and the active PRE reloads
normally. When you force a switchover from the standby PRE, a crash dump of the active PRE occurs for
troubleshooting purposes. Forcing a switchover from the standby PRE should only be done if you cannot
access the active PRE.
Examples The following example shows a switchover from the active RP to the standby RP on a Cisco 7513
router with RPR configured:
Router# configure terminal
Router(config)# hw-module slot 7 image slot0:rsp-pv-mz
Router(config)# hw-module slot 6 image slot0:rsp-pv-mz
Router(config)# slave auto-sync config
Router(config)# redundancy
Router(config-r)# mode rpr
Router(config-r)# end
Router# copy running-config startup-config
Router# redundancy force-switchover
The following example shows how to perform a manual switchover from the active to the standby
RP when the running configuration is different from the startup configuration:
Router# redundancy force-switchover
System configuration has been modified. Save? [yes/no]:y
Building configuration...
...
...
[OK]
Proceed with switchover to standby NSE? [confirm]y
00:07:35:%SYS-5-SWITCHOVER:Switchover requested
Cisco IOS Interface and Hardware Component Command Reference
927
O through R
redundancy force-switchover
The following example shows how to perform a manual switchover from the active to the standby
RP when the running configuration is the same as the startup configuration:
Router# redundancy force-switchover
Proceed with switchover to standby NSE? [confirm]
00:07:35:%SYS-5-SWITCHOVER:Switchover requested
Cisco RF Gateway 10
The following example shows how to perform a manual switchover from the active to the standby
RP when the running configuration is different from the startup configuration:
Router# redundancy force-switchover
System configuration has been modified. Save? [yes/no]:y
Building configuration...
...
...
[OK]
Proceed with switchover to standby NSE? [confirm]y
00:07:35:%SYS-5-SWITCHOVER:Switchover requested
The following example shows how to perform a manual switchover from the active to the standby
RP when the running configuration is the same as the startup configuration:
Router# redundancy force-switchover
Proceed with switchover to standby NSE? [confirm]
00:07:35:%SYS-5-SWITCHOVER:Switchover requested
Related Commands Command Description
clear redundancy history Clears the redundancy event history log.
hw-module sec-cpu reset Resets and reloads the standby RP with the specified Cisco IOS image and
executes the image.
hw-module slot image Specifies a high availability Cisco IOS image to run on an active or standby
RP.
mode (HSA redundancy) Configures the High System Availability (HSA) redundancy mode.
mode (redundancy) Configures the redundancy mode of operation.
redundancy Enters redundancy configuration mode.
show redundancy Displays current active and standby Performance Routing Engine (PRE)
redundancy status.
Cisco IOS Interface and Hardware Component Command Reference
928
O through R
redundancy handover
redundancy handover
To hand over control of resources (slots and cards) from a route-switch-controller (RSC) card to its peer RSC
card, use the redundancyhandover command in privileged EXEC mode.
redundancy handover {cancel|{peer-resources|shelf-resources} [busyout-period mins] [at hh :
mm [{day month|month day} year]]}
Syntax Description cancel Any pending handover is canceled.
peer-resources Resources to be handed over are those on the side of the peer RSC. This
parameter applies only when the system is in extraload.
shelf-resources Resources to be handed over are those on the side of the RSC from which
the command is run.
busyout-period mins (Optional) Time period for which all slots in the selected resources are to
be busied out before handover. If time options are omitted, handover or
busyout period begins immediately.
at hh : mm day month year (Optional) Time of the handover or start of the busyout period, in 24-hour
time format; hour and minute are required; day, month, and year are optional.
Command Default Control remains with the assigned RSC.
Command Modes Privileged EXEC
Command History Release Modification
12.2(2)XB1 This command was introduced.
12.2(11)T This command was integrated into Cisco IOS Release 12.2(11)T.
Usage Guidelines To use this command, you must have two RSC cards installed on your Cisco AS5850 and you must be
connected to one of them in handover-split mode. This command can be run from either RSC and can specify
that slots be handed over to the peer RSC.
After handover and subsequent restoration of the failed RSC, connect to the active RSC and use this command
to return control of cards to the previously failed but now restored RSC.
Note that when you enter the command with the shelf-resources option, the RSC reloads.
Examples The following example hands over control, to the peer RSC, of the slots and cards on the corresponding
side of the chassis. Note the prompt to confirm clearing of calls, handover, and reload on the last
line.
Router# redundancy handover shelf-resources busyout-period 10 at 22:00 3 Sep 2005
Newly entered handover schedule:
Busyout period at 22:00:00 PDT Sat Sep 3 2005 for a duration of 10 minutes
Cisco IOS Interface and Hardware Component Command Reference
929
O through R
redundancy handover
Handover pending at 22:10:00 PDT Sat Sep 3 2005
Clear calls, handover and reload as specified above? y
Related Commands Command Description
show redundancy debug-log Displays up to 256 relevant debug entries.
show redundancy handover Displays details of any pending handover (that is, a handover command
that was entered previously and is not yet completed).
show redundancy history Displays logged handover events.
Cisco IOS Interface and Hardware Component Command Reference
930
O through R
redundancy stateful
redundancy stateful
To configure stateful failover for tunnels using IP Security (IPSec), use the redundancystatefulcommand in
crypto map configuration mode. To disable stateful failover for tunnel protection, use the no form of this
command.
redundancy standby-group-name stateful
no redundancy standby-group-name stateful
Syntax Description standby-group-name Refers to the name of the standby group as defined by Hot Standby Router Protocol
(HSRP) standby commands. Both routers in the standby group are defined by this
argument and share the same virtual IP (VIP) address.
Command Default Stateful failover is not enabled for IPSec tunnels.
Command Modes Crypto map configuration
Command History Release Modification
12.3(11)T This command was introduced.
Usage Guidelines The redundancystatefulcommand uses an existing IPSec profile (which is specified via the
cryptoipsecprofilecommand) to configure IPSec stateful failover for tunnel protection. (You do not configure
the tunnel interface as you would with a crypto map configuration.) IPSec stateful failover enables you to
define a backup IPSec peer (secondary) to take over the tasks of the active (primary) router if the active router
is deemed unavailable.
The tunnel source address must be a VIP address, and it must not be an interface name.
Examples The following example shows how to configure stateful failover for tunnel protection:
crypto ipsec profile peer-profile
redundancy HA-out stateful
interface Tunnel1
ip unnumbered Loopback0
tunnel source 209.165.201.3
tunnel destination 10.0.0.5
tunnel protection ipsec profile peer-profile
!
interface Ethernet0/0
ip address 209.165.201.1 255.255.255.224
standby 1 ip 209.165.201.3
standby 1 name HA-out
Related Commands Command Description
crypto ipsec profile Defines the IPSec parameters that are to be used for IPSec encryption between two
routers and enters crypto map configuration mode.
Cisco IOS Interface and Hardware Component Command Reference
931
O through R
remote command
remote command
To execute a Cisco 7600 series router command directly on the switch console or a specified module without
having to log into the Cisco 7600 series router first, use the remote command command in privileged EXEC
mode.
remote command {module num|standby-rp|switch} command
Syntax Description module num Specifies the module to access; see the “Usage Guidelines” section for valid values.
standby-rp Specifies the standby route processor.
switch Specifies the active switch processor.
command Command to be executed.
Command Default This command has no default settings.
Command Modes Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(18)SXD The standby-rp keyword was added.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The module num keyword and argument designate the module number. Valid values depend on the chassis
that is used. For example, if you have a 13-slot chassis, valid values are from 1 to 13. The module num
keyword and argument are supported on DFC-equipped modules and the standby supervisor engine only.
When you execute the remote command switchcommand, the prompt changes to Switch-sp#.
This command is supported on DFC-equipped modules and the supervisor engine only.
This command does not support command completion, but you can use shortened forms of the command (for
example, entering sh for show).
Examples This example shows how to execute the show calendar command from the standby route processor:
Router#
remote command standby-rp show calendar
Switch-sp#
09:52:50 UTC Mon Nov 12 2001
Router#
Cisco IOS Interface and Hardware Component Command Reference
932
O through R
remote command
Related Commands Command Description
remote login Accesses the Cisco 7600 series router console or a specific module.
Cisco IOS Interface and Hardware Component Command Reference
933
O through R
remote-span
remote-span
To configure a virtual local area network (VLAN) as a remote switched port analyzer (RSPAN) VLAN, use
the remote-span command in config-VLAN mode. To remove the RSPAN designation, use the no form of
this command.
remote-span
no remote-span
Syntax Description This command has no arguments or keywords.
Command Default This command has no default settings.
Command Modes Config-VLAN mode
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is not supported in the VLAN database mode.
You can enter the show vlan remote-span command to display the RSPAN VLANs in the Cisco 7600 series
router.
Examples This example shows how to configure a VLAN as an RSPAN VLAN:
Router(config-vlan)# remote-span
Router(config-vlan)
This example shows how to remove the RSPAN designation:
Router(config-vlan)# no remote-span
Router(config-vlan)
Related Commands Connect Description
show vlan remote-span Displays a list of RSPAN VLANs.
Cisco IOS Interface and Hardware Component Command Reference
934
O through R
remote login
remote login
To access the Cisco 7600 series router console or a specific module, use the remote login command in
privileged EXEC mode.
remote login {module num|standby-rp|switch}
Syntax Description module num Specifies the module to access; see the “Usage Guidelines” section for valid values.
standby-rp Specifies the standby route processor.
switch Specifies the active switch processor.
Command Default This command has no default settings.
Command Modes Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(18)SXD This command was changed to include the standby-rp keyword.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
Caution When you enter the attach or remote login command to access another console from your switch, if you
enter global or interface configuration mode commands, the switch might reset.
The module num keyword and argument designate the module number. Valid values depend on the chassis
that is used. For example, if you have a 13-slot chassis, valid values are from 1 to 13. The module num
keyword and argument are supported on DFC-equipped modules and the standby supervisor engine only.
When you execute the remote login module num command, the prompt changes to Router-dfcx# or Switch-sp#,
depending on the type of module to which you are connecting.
When you execute the remote login standby-rp command, the prompt changes to Router-sdby#.
When you execute the remote login switch command, the prompt changes to Switch-sp#.
The remote login module num command is identical to the attach command.
There are two ways to end the session:
• You can enter the exit command as follows:
Switch-sp# exit
Cisco IOS Interface and Hardware Component Command Reference
935
O through R
remote login
[Connection to Switch closed by foreign host]
Router#
• You can press Ctrl-C three times as follows:
Switch-sp# ^C
Switch-sp# ^C
Switch-sp# ^C
Terminate remote login session? [confirm] y
[Connection to Switch closed by local host]
Router#
Examples This example shows how to perform a remote login to a specific module:
Router# remote login module 1
Trying Switch ...
Entering CONSOLE for Switch
Type "^C^C^C" to end this session
Switch-sp#
This example shows how to perform a remote login to the Cisco 7600 series router processor:
Router# remote login switch
Trying Switch ...
Entering CONSOLE for Switch
Type "^C^C^C" to end this session
Switch-sp#
This example shows how to perform a remote login to the standby route processor:
Router# remote login standby-rp
Trying Switch ...
Entering CONSOLE for Switch
Type "^C^C^C" to end this session
Router-sdby#
Related Commands Command Description
attach Connects to a specific module from a remote location.
Cisco IOS Interface and Hardware Component Command Reference
936
O through R
reset (alarm-interface)
reset (alarm-interface)
To reset the CPU in the alarm interface controller (AIC), use the resetcommand in alarm-interface mode.
reset
Syntax Description This command has no arguments or keywords.
Command Default No default behavior or values
Command Modes Alarm-interface
Command History Release Modification
12.2(2)XG This command was introduced on the Cisco 2600 series and Cisco 3600 series.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T.
Usage Guidelines A change in the AIC IP configuration might not take effect until the next time the card is started. Use the reset
command to restart the card. This command does not have a no form.
Examples The following example shows a message that might be returned after the reset command is entered:
Router(alarm-aic)# reset
Selected card in slot 1 restarted
Related Commands Command Description
alarm-interface Enters alarm-interface mode and configures the AIC.
Cisco IOS Interface and Hardware Component Command Reference
937
O through R
retry
retry
To define the amount of time that must elapse before a connection is attempted to a failed server, use the retry
command in interface configuration mode. To change the connection-reassignment threshold and client
threshold to the default settings, use the no form of this command.
retry retry-value
no retry
Syntax Description retry-value Amount of time, in seconds, that must elapse after the detection of a server failure before a
new connection is attempted to the server; valid values are from 1 to 3600.
Command Default retry-value is 60
Command Modes real server configuration submode
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Examples This example shows how to specify a retry timer of 30 seconds:
Router(config)# ip slb serverfarm serverfarm-name
Router(config-slb-sfarm)# real 10.1.1.1
Cisco-7600(config-slb-real)# retry 30
This example shows how to revert to the default value:
Cisco-7600(config-slb-real)# no
retry
Router(config-if)#
Related Commands Command Description
faildetect numconns Specifies the conditions that indicate a server failure.
inservice (real server) Enables the real server for use by the IOS SLB feature.
maxconns Limits the number of active connections to the real server.
Cisco IOS Interface and Hardware Component Command Reference
938
O through R
ring-speed
ring-speed
To set the ring speed for the CSC-1R and CSC-2R Token Ring interfaces, use the ring-speed command in
interface configuration mode.
ring-speed commandring-speed speed
Syntax Description speed Integer that specifies the ring speed, either 4 for 4-Mbps operation or 16 for 16-Mbps operation .
The default is 16.
Command Default 16-Mbps operation
Caution Configuring a ring speed that is wrong or incompatible with the connected Token Ring causes the ring to
beacon, which makes the ring nonoperational.
Command Modes Interface configuration
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command does not have a no form.
Examples The following example shows how to sets the ring speed to 4 Mbps on a Token Ring interfaces:
Router(config)# interface tokenring 0
Router(config-if)# ring-speed 4
Cisco IOS Interface and Hardware Component Command Reference
939
O through R
rj45-auto-detect-polarity
rj45-auto-detect-polarity
To enable or disable polarity detection for 10 Mbps full-duplex links, use the rj45-auto-detect-polarity
command in interface configuration mode.
rj45-auto-detect-polarity {enable|disable}
Syntax Description enable Enables polarity detection on the RJ45 interface.
disable Disables polarity detection on the RJ45 interface.
Command Default Polarity detection is disabled for 10 Mbps, full duplex links.
Command Modes Interface configuration (config-if)
Command History Release Modification
15.0(1)M3 This command was introduced.
Usage Guidelines This command is available only for 10 Mbps, full-duplex links. The polarity detection feature helps to detect
reversed polarity and provide correction; however, there is a risk of cyclic redundancy check (CRC) errors if
polarity detection is enabled.
The polarity detection feature is disabled by default. Use the rj45-auto-detect-polarityenableto enable polarity
detection.
It is recommended to leave polarity detection disabled.
Examples The following example shows how to enable polarity detection on the RJ45 interface:
router(config-if)# rj45-auto-detect-polarity enable
Related Commands Command Description
media-type auto-failover Assigns the RJ45 or the SFP port as the primary and secondary failover media.
Cisco IOS Interface and Hardware Component Command Reference
940
scramble through service-module t1 lbo
• scramble, on page 944
• serial restart-delay, on page 946
• server ip address, on page 947
• service alarm persistency interval, on page 948
• service declassify, on page 949
• service-engine default-gateway, on page 952
• service-engine hostname, on page 954
• service-engine ip address, on page 956
• service-engine nameserver, on page 958
• service-engine wma-passcode, on page 960
• service-engine wma-token, on page 962
• service-engine wma-url, on page 964
• service single-slot-reload-enable, on page 966
• service-module, on page 967
• service-module 56k clock rate, on page 969
• service-module 56k clock source, on page 971
• service-module 56k data-coding, on page 972
• service-module 56k network-type, on page 973
• service-module 56k remote-loopback, on page 975
• service-module 56k switched-carrier, on page 976
• service-module analysis-module reload, on page 978
• service-module analysis-module reset, on page 979
• service-module analysis-module session, on page 980
• service-module analysis-module shutdown, on page 982
• service-module analysis-module status, on page 984
• service-module backup interface, on page 985
• service-module backup mode, on page 986
• service-module content-engine reload, on page 988
• service-module content-engine reset, on page 989
• service-module content-engine session, on page 990
• service-module content-engine shutdown, on page 992
• service-module content-engine status, on page 993
• service-module external ip address, on page 995
Cisco IOS Interface and Hardware Component Command Reference
941
scramble through service-module t1 lbo
• service-module heartbeat-reset disable, on page 996
• service-module ids-sensor, on page 997
• service-module integrated-service-engine default-boot, on page 999
• service-module integrated-service-engine reload, on page 1000
• service-module integrated-service-engine reset, on page 1001
• service-module integrated-service-engine session, on page 1003
• service-module integrated-service-engine shutdown, on page 1005
• service-module integrated-service-engine status, on page 1006
• service-module integrated-service-engine statistics, on page 1008
• service-module ip address, on page 1009
• service-module ip default-gateway, on page 1013
• service-module ip redundancy , on page 1014
• service-module ism default-boot, on page 1015
• service-module ism heartbeat-reset, on page 1016
• service-module ism install, on page 1018
• service-module ism install abort, on page 1020
• service-module ism reload, on page 1021
• service-module ism reset, on page 1022
• service-module ism session, on page 1023
• service-module ism shutdown, on page 1025
• service-module ism statistics, on page 1026
• service-module ism status, on page 1027
• service-module ism uninstall, on page 1028
• service-module mgf ip address, on page 1029
• service-module mgf ip default-gateway, on page 1030
• service-module mgf ipv6 address, on page 1031
• service-module routing redistribute, on page 1032
• service-module satellite backup, on page 1033
• service-module satellite configuration, on page 1034
• service-module satellite cw-mode, on page 1036
• service-module satellite status, on page 1038
• service-module service-engine, on page 1045
• service-module sm default-boot, on page 1046
• service-module sm heartbeat-reset, on page 1047
• service-module sm install, on page 1049
• service-module sm install abort, on page 1051
• service-module sm reload, on page 1052
• service-module sm reset, on page 1053
• service-module sm session, on page 1054
• service-module sm shutdown, on page 1056
• service-module sm statistics, on page 1057
• service-module sm status, on page 1058
• service-module sm uninstall, on page 1059
• service-module t1 cablelength short, on page 1060
• service-module t1 clock source, on page 1061
• service-module t1 data-coding, on page 1062
Cisco IOS Interface and Hardware Component Command Reference
942
scramble through service-module t1 lbo
• service-module t1 fdl, on page 1063
• service-module t1 framing, on page 1064
• service-module t1 lbo, on page 1065
Cisco IOS Interface and Hardware Component Command Reference
943
scramble through service-module t1 lbo
scramble
scramble
To enable scrambling (encryption) of the payload on a T3 or E3 controller or on the PA-T3 and PA-E3 port
adapters, use the scramble command in interface configuration mode. To disable scrambling, use the no form
of this command.
scramble
no scramble
Syntax Description This command has no arguments or keywords.
Command Default Scrambling is disabled.
Command Modes Interface configuration
Command History Release Modification
11.1CA This command was introduced.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and implemented on the
following platforms: Cisco 2650XM, Cisco 2651XM, Cisco 2691, Cisco 3660 series, Cisco
3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines T3/E3 scrambling is used to assist clock recovery on the receiving end. Scrambling is designed to randomize
the pattern of 1s and 0s carried in the physical layer frame. Randomizing the digital bits can prevent continuous,
nonvariable bit patterns--in other words, long strings of all 1s or all 0s. Several physical layer protocols rely
on transitions between 1s and 0s to maintain clocking.
Scrambling can prevent some bit patterns from being mistakenly interpreted as alarms by switches placed
between the Data Service Units (DSUs).
The local interface configuration must match the remote interface configuration. For example, if you enable
scrambling on the local port, you must also do the same on the remote port.
To verify that scrambling is configured on the interface, use the showcontrollersserialor the
showinterfacesserialcommands.
For T3 controllers, all the DSU modes support scrambling except Clear mode.
For E3 controllers, only Kentrox mode supports scrambling.
Examples The following example enables scrambling on the PA-E3 port adapter in slot 1, port adapter slot 0,
interface 0:
Cisco IOS Interface and Hardware Component Command Reference
944
scramble through service-module t1 lbo
scramble
Router(config)# interface serial 1/0/0
Router(config-if)# scramble
The following example enables scrambling on the controller in slot 1, port 0:
Router(config)# interface serial 1/0
Router(config-if)# scramble
Related Commands Command Description
show controllers serial Displays information that is specific to the serial controllers.
show interfaces serial Displays information that is specific to the interface hardware.
Cisco IOS Interface and Hardware Component Command Reference
945
scramble through service-module t1 lbo
serial restart-delay
serial restart-delay
To set the amount of time that the router waits before trying to bring up a serial interface when it goes down,
use the serialrestart-delay command in interface configuration mode. To restore the default, use the no form
of the command.
serial restart-delay count
no serial restart-delay
Syntax Description count Frequency, in milliseconds, at which the hardware is reset. Range is from 0 to 900. Default is 0.
Command Default 0 milliseconds
Command Modes Interface configuration (config-if)
Command History Release Modification
11.2 P This command was introduced.
12.2(4)T The count value was changed to set time in milliseconds rather than in seconds.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
15.1(2)S This command was integrated into Cisco IOS Release 15.1(2)S.
Usage Guidelines The router resets the hardware each time the serial restart timer expires. This command is often used with the
dial backup feature and with the pulse-time command, which sets the amount of time to wait before redialing
when a DTR dialed device fails to connect.
When thecountvalue is set to the default of 0, the hardware is not reset when it goes down. In this way, if the
interface is used to answer a call, it does not cause DTR to drop, which can cause a communications device
to disconnect.
Examples The following example shows how to set the restart delay on serial interface 0 to 0:
Router(config)# interface serial 0
Router(config-if)# serial restart-delay 0
Related Commands Command Description
pulse-time Enables pulsing DTR signal intervals on the serial interfaces.
show interfaces serial Displays information about a serial interface.
Cisco IOS Interface and Hardware Component Command Reference
946
scramble through service-module t1 lbo
server ip address
server ip address
To configure a static IP address for the Cisco E-Series Server, use the server ip address command in interface
configuration mode.
server ip address [ip_address subnet_mask]
no server ip address
Syntax Description ip_address Configures a static IP address for the Cisco E-Series Server.
subnet_mask The subnet mask associated with the IP address.
Command Modes
Interface configuration (config-if)
Command History Release Modification
15.2(4)M This command was introduced.
Usage Guidelines Use this command from interface configuration mode:
Router(config)# interface ucse slot/port
Examples The following example shows how to configure a static IP address for the Cisco E-Series Server:
Router(config)# interface ucse 2/0
Router(config-if)# server ip address 10.0.0.2 100.1.1.31
Cisco IOS Interface and Hardware Component Command Reference
947
scramble through service-module t1 lbo
service alarm persistency interval
service alarm persistency interval
To configure alarm history that helps in defining the periodicity or the interval at which the alarm entries are
saved in the designated file., use the service alarm persistency interval command.
Syntax Description Syntax Description
service alarm persistency Configures the alarm history helps in defining the periodicity or the interval
interval value at which the alarm entries are saved in the designated file. When alarm
history is configured, two log files are created in bootflash:tracelogs.
Command Default This default is 20 seconds.
Command Modes Global configuration
Command History Release Modification
XE 3.18 SP Support for this command was introduced on NCS 4200 Series.
XE Everest This command was integrated on the Cisco NCS 4200 Series and Cisco ASR 900 Series
16.5.1 Routers.
Examples The following example shows the configuration of alarm history:
enable
configure terminal
service alarm persistency interval 20-600
end
Related Commands Command Description
show process | include persis Verifies the validity of the process during alarm history configuration.
Cisco IOS Interface and Hardware Component Command Reference
948
scramble through service-module t1 lbo
service declassify
service declassify
To enable the declassification function to monitor the auxiliary (AUX) port Clear To Send (CTS) pin, use the
servicedeclassify command in global configuration mode. To disable, use the no form of this command.
service declassify [{erase-flash|erase-nvram|erase-all}]
no service declassify [{erase-flash|erase-nvram|erase-all}]
Syntax Description erase-flash (Optional) Erases all files in the Flash memory file system when declassification is invoked.
erase-nvram (Optional) Erases all files in the NVRAM file system when declassification is invoked.
erase-all (Optional) Scrubs and erases all files on the router when declassification is invoked.
Note The servicedeclassify command is supported on the Cisco 3200 series routers only.
Command Default Zeroization is disabled.
Command Modes Global configuration
Command History Release Modification
12.3(8)YD This command was introduced.
12.4(2)T This command was integrated into Cisco IOS Release 12.4(2)T.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The network interfaces are shut down when declassification is invoked.
No command-line interface (CLI) command invokes the declassification process. Declassification is invoked
by using an external signal that appears on the AUX port of the router. When declassification is complete,
the ROMMON prompt appears on the console.
The output that appears on the console when declassification is initiated depends on what options have been
configured. Because of the complex interactions between the declassification process and the logging process
during declassification, it is not possible to document exactly what appears on the screen.
Examples The following example shows the console output when declassification is invoked:
The erase-all Keyword
The output on the console when the erase-all keyword is used resembles the following:
Cisco IOS Interface and Hardware Component Command Reference
949
scramble through service-module t1 lbo
service declassify
Router# service declassify erase-all
*Mar 5 17:44:28.347:
Declassification initiated...
*Mar 5 17:44:30.647: %LINK-5-CHANGED: Interface FastEthernet0/0, changed state to
administratively down
*Mar 5 17:44:31.647: %LINEPROTO-5-UPDOWN: Line protocol on Interface FastEthernet0/0,
changed state to down
System Bootstrap, Version 12.2(1r) [hftseng-MRC_RM 100], DEVELOPMENT SOFTWARE
Copyright (c) 1994-2002 by cisco Systems, Inc.
C3200 platform with 131072 Kbytes of main memory
rommon 1 >
Note If the servicedeclassifyerase-all command is configured and the Flash file system is erased, error
recovery actions must be initiated to load a bootable image on the router. The startup configuration
file is also erased; the router boots from the factory default configuration the next time it is booted.
The erase-flash Keyword
The output on the console when the erase-flash keyword is used resembles the following:
Router# service declassify erase-flash
*Mar 1 00:01:30.091:
Declassification initiated...
*Mar 1 00:01:34.347: %LINK-5-CHANGED: Interface FastEthernet0/0, changed state to
administratively down
*Mar 1 00:01:35.371: %LINEPROTO-5-UPDOWN: Line protocol on Interface FastEthernet0/0,
changed state to down
System Bootstrap, Version 12.2(1r) [hftseng-MRC_RM 100], DEVELOPMENT SOFTWARE
Copyright (c) 1994-2002 by cisco Systems, Inc.
C3200 platform with 131072 Kbytes of main memory
rommon 1 >
Note The Flash file system is erased and there will not be a bootable image for the router in the Flash file
system if the servicedeclassifyerase-flash command is configured. Error recovery actions must be
initiated to load a bootable image. The startup configuration file is not erased if the
servicedeclassifyerase-flash command is configured. When the router is booted, it is configured
using its startup configuration file in NVRAM.
The erase-nvram Keyword
The output on the console when the erase-nvram keyword is used resembles the following:
Router# service declassify erase-nvram
System Bootstrap, Version 12.2(1r) [hftseng-MRC_RM 100], DEVELOPMENT SOFTWARE
Copyright (c) 1994-2002 by cisco Systems, Inc.
C3200 platform with 131072 Kbytes of main memory
rommon 1 >
Cisco IOS Interface and Hardware Component Command Reference
950
scramble through service-module t1 lbo
service declassify
Note If the servicedeclassifyerase-nvram command is configured, the Flash file system is not erased.
The bootable image in the Flash file system remains, and the router can be booted. The startup
configuration file is erased; because the router has no configuration file, it boots from the default
configuration
Related Commands Command Description
show declassify Displays the state of the servicedeclassify command.
Cisco IOS Interface and Hardware Component Command Reference
951
scramble through service-module t1 lbo
service-engine default-gateway
service-engine default-gateway
To define a default gateway router IP address for the Cisco WebEx Node SPA in a Cisco ASR 1000 Series
Router, use the service-enginedefault-gatewaycommand in interface configuration mode. To remove the
default-gateway IP address, use the no form of this command.
service-engine default-gateway gateway-ip-address
no service-engine default-gateway gateway-ip-address
Syntax Description gateway-ip-address IP address of the router default gateway.
Command Default No gateway IP address is configured.
Command Modes Interface configuration (config-if)
Command History Release Modification
IOS XE Release 2.4 This command was introduced.
Usage Guidelines The service-enginedefault-gateway command specifies the IP address for the default gateway router to be
used for the Cisco WebEx Node SPA.
A service-engine interface on the Cisco WebEx Node SPA has two IP addresses:
• Router-side IP address--Configured with the ipaddresscommand. The IP address on the router side acts
like a gateway to the WebEx services running on the SPA side. This router-side IP address must match
the IP address configured in the service-enginedefault-gateway command.
• Internal SPA interface IP address--Configured with theservice-engineipaddresscommand.
You must configure the service-engineipaddress command before configuring the default gateway.
Note Before you can configure the Cisco WebEx Node SPA, you must shut down the service-engine interface using
the shutdown interface configuration command. To activate the service-engine interface, use the noshutdown
command.
Examples The following example defines the gateway on IP address 10.200.72.17 as the default router for the
SPA in slot 1/0/0, which corresponds to the IP address configured on the router side in
theipaddresscommand:
Router(config) interface Service-Engine1/0/0
Router(config-if) shutdown
Router(config-if) ip address 10.200.72.17 255.255.255.252
Router(config-if) service-engine ip address 10.200.72.18 255.255.255.252
Router(config-if) service-engine default-gateway 10.200.72.17
Cisco IOS Interface and Hardware Component Command Reference
952
scramble through service-module t1 lbo
service-engine default-gateway
Related Commands Command Description
service-engine hostname Specifies or modifies the hostname or domain name associated
with a Cisco WebEx Node SPA.
service-engine ip address Selects and configures the internal interface for management traffic
on a Cisco WebEx Node SPA.
service-engine nameserver Specifies the primary and secondary domain name server used by
the Cisco WebEx Node SPA.
service-engine wma-passcode Configures the name and key that are used for authentication on
a Cisco WebEx Node SPA.
service-engine wma-token Configures an encrypted token on a Cisco WebEx Node SPA.
service-engine wma-url Specifies the URL to which the Cisco WebEx Node SPA must
connect to enable WebEx meetings.
show hw-module subslot service-engine Displays the Cisco WebEx Node SPA application status.
status
Cisco IOS Interface and Hardware Component Command Reference
953
scramble through service-module t1 lbo
service-engine hostname
service-engine hostname
To specify or modify the hostname or domain name associated with a Cisco WebEx Node SPA on a Cisco
ASR 1000 Series Router, use the service-enginehostnamecommand in interface configuration mode. To
remove the hostname and domain name association, use the no form of this command.
service-engine hostname module-side-hostname module-side-domain-name
no service-engine hostname module-side-hostname module-side-domain-name
Syntax Description module-side-hostname Name of the hostname associated with a Cisco WebEx Node SPA.
module-side-domain- name Name of the domain associated with a Cisco WebEx Node SPA
Command Default No hostname or domain name is configured.
Command Modes Interface configuration (config-if)
Command History Release Modification
IOS XE Release 2.4 This command was introduced.
Usage Guidelines The service-enginehostnamecommand specifies the hostname and domain names given to a Cisco WebEx
Node SPA. It is an optional configuration and is only used if a Domain Name System (DNS) entry was created
for the IP address assigned to the SPA.
To display the configured hostname and domain name for a Cisco WebEx Node SPA, use the
showhw-modulesubslotservice-enginestatus command.
Note Before you can configure the Cisco WebEx Node SPA, you must shut down the service-engine interface using
the shutdown interface configuration command. To activate the service-engine interface, use the noshutdown
command.
Examples The following example shows how to specify the hostname and domain name for a Cisco WebEx
Node SPA:
Router(config)# interface service-engine 1/0
Router(config-if)# shutdown
Router(config-if)# service-engine hostname wma-spa-1 cisco.com
Related Commands Command Description
service-engine default-gateway Defines a default gateway router IP address for the Cisco WebEx
Node SPA.
service-engine ip address Selects and configures the internal interface for management traffic
on a Cisco WebEx Node SPA.
Cisco IOS Interface and Hardware Component Command Reference
954
scramble through service-module t1 lbo
service-engine hostname
Command Description
service-engine hostname Specifies or modifies the hostname or domain name associated
with a Cisco WebEx Node SPA.
service-engine nameserver Specifies the primary and secondary domain name server used by
the Cisco WebEx Node SPA.
service-engine wma-passcode Configures the name and key that are used for authentication on
a Cisco WebEx Node SPA.
service-engine wma-token Configures an encrypted token on a Cisco WebEx Node SPA.
service-engine wma-url Specifies the URL to which the Cisco WebEx Node SPA must
connect to enable WebEx meetings.
show hw-module subslot service-engine Displays the Cisco WebEx Node SPA application status.
status
Cisco IOS Interface and Hardware Component Command Reference
955
scramble through service-module t1 lbo
service-engine ip address
service-engine ip address
To select and configure the internal interface for management traffic for the WebEx Node SPA on a Cisco
ASR 1000 Series Router, use the service-engineipaddresscommand in interface configuration mode. To
delete the IP address associated with this interface, use the no form of this command.
service-engine ip address module-side-ip-address subnet-mask
no service-engine ip address module-side-ip-address subnet-mask
Syntax Description module-side-ip-address Specifies the IP address of the internal network module-side interface.
subnet-mask Specifies the subnet mask to append to the IP address.
Command Default No IP address is configured.
Command Modes Interface configuration (config-if)
Command History Release Modification
IOS XE Release 2.4 This command was introduced.
Usage Guidelines A service-engine interface on the Cisco WebEx Node SPA has two IP addresses:
• Router-side IP address--Configured with the ipaddresscommand. The IP address on the router side acts
like a gateway to the WebEx services running on the SPA side. This router-side IP address must match
the IP address configured in the service-enginedefault-gateway command.
• Internal SPA interface IP address--Configured with theservice-engineipaddresscommand.
To successfully configure the service-engine IP address, consider the following guidelines:
• The router-side IP address must be configured using the ipaddress command.
• The service-engine IP address must be on the same subnet as the router-side IP address for the
service-engine interface (configured using the ipaddresscommand.)
• The service-engineipaddresscommand must be configured before you configure the
service-enginedefault-gateway command.
Note Before you can configure the Cisco WebEx Node SPA, you must shut down the service-engine interface using
the shutdown interface configuration command. To activate the service-engine interface, use the noshutdown
command.
Examples The following example shows how to define an IP address for the internal SPA-side interface on the
WebEx Node SPA in slot 1 using the service-engineipaddresscommand. The example shows the
service-engine IP address on the same subnet as the router-side IP address that is configured with
the ipaddress command:
Cisco IOS Interface and Hardware Component Command Reference
956
scramble through service-module t1 lbo
service-engine ip address
Router(config) interface Service-Engine1/0/0
Router(config-if) shutdown
Router(config-if) ip address 10.200.72.17 255.255.255.252
Router(config-if) service-engine ip address 10.200.72.18 255.255.255.252
Router(config-if) service-engine default-gateway 10.200.72.17
Related Commands Command Description
service-engine default-gateway Defines a default gateway router IP address for the Cisco WebEx
Node SPA.
service-engine hostname Specifies or modifies the hostname or domain name associated
with a Cisco WebEx Node SPA.
service-engine nameserver Specifies the primary and secondary domain name server used
by the Cisco WebEx Node SPA.
service-engine wma-passcode Configures the name and key that are used for authentication on
a Cisco WebEx Node SPA.
service-engine wma-token Configures an encrypted token on a Cisco WebEx Node SPA.
service-engine wma-url Specifies the URL to which the Cisco WebEx Node SPA must
connect to enable WebEx meetings.
show hw-module subslot service-engine Displays the Cisco WebEx Node SPA application status.
status
Cisco IOS Interface and Hardware Component Command Reference
957
scramble through service-module t1 lbo
service-engine nameserver
service-engine nameserver
To specify the primary and secondary Domain Name System (DNS) used by the Cisco WebEx Node SPA in
a Cisco ASR 1000 Series Router, use the service-enginenameservercommand in interface configuration
mode. To remove a DNS name server from the list, use the no form of this command.
service-engine nameserver name-server1-ip-address name-server2-ip-address
no service-engine nameserver name-server1-ip-address name-server2-ip-address
Syntax Description name-server1-ip- address IP address of the primary DNS name server for the WebEx Node SPA.
name-server2-ip- address IP address of a secondary DNS name server for the WebEx Node SPA.
Command Default No name servers are configured.
Command Modes Interface configuration (config-if)
Command History Release Modification
IOS XE Release 2.4 This command was introduced.
Usage Guidelines
Note Before you can configure the Cisco WebEx Node SPA, you must shut down the service-engine interface using
the shutdown interface configuration command. To activate the service-engine interface, use the noshutdown
command.
Examples The following example shows how to specify the hosts at 192.168.2.111 and 192.168.2.112 as the
primary and secondary name servers for the WebEx Node SPA in slot 1/0:
Router(config)# interface service-engine 1/0
Router(config-if)# shutdown
Router(config-if)# service-engine nameserver 192.168.2.111
192.168.2.112
Related Commands Command Description
service-engine default-gateway Defines a default gateway router IP address for the Cisco WebEx
Node SPA.
service-engine hostname Specifies or modifies the hostname or domain name associated
with a Cisco WebEx Node SPA.
service-engine ip address Selects and configures the internal interface for management
traffic on a Cisco WebEx Node SPA.
Cisco IOS Interface and Hardware Component Command Reference
958
scramble through service-module t1 lbo
service-engine nameserver
Command Description
service-engine wma-passcode Configures the name and key that are used for authentication on
a Cisco WebEx Node SPA.
service-engine wma-token Configures an encrypted token on a Cisco WebEx Node SPA.
service-engine wma-url Specifies the URL to which the Cisco WebEx Node SPA must
connect to enable WebEx meetings.
show hw-module subslot service-engine Displays the Cisco WebEx Node SPA application status.
status
Cisco IOS Interface and Hardware Component Command Reference
959
scramble through service-module t1 lbo
service-engine wma-passcode
service-engine wma-passcode
To configure the name and key that is used for authentication for a Cisco WebEx Node SPA in a Cisco ASR
1000 Series Router, use the service-enginewma-passcode command in interface configuration mode. To
disable this function, use the no form of this command.
service-engine wma-passcode name-string key-string
no service-engine wma-passcode
Syntax Description name-string Specifies the authentication name for the WebEx Node SPA.
key-string Specifies the authentication passcode for the WebEx Node SPA.
Command Default The name and key used for authentication for a Cisco WebEx Node SPA is disabled.
Command Modes Interface configuration (config-if)
Command History Release Modification
IOS XE Release 2.4 This command was introduced.
Usage Guidelines The service-enginewma-passcodecommand is used to configure the Cisco WebEx Node SPA name and
passcode key to identify the node. Both the passcode and the token (configured using the
service-enginewma-token command) are used together for authentication of the Cisco WebEx Node SPA.
Before you can configure this command, you must first provision the Cisco WebEx Node SPA at the WebEx
Data Center. The value of the passcode string provisioned in the Cisco WebEx Node Management System
for the SPA must match the value of the passcode string configured in the
service-enginewma-passcodecommand. For more information, refer to the “Configuring the Cisco WebEx
Node for ASR 1000 Series” chapter of the Cisco ASR 1000 Series Aggregation Services Routers SIP and
SPA Software Configuration Guide .
Note Before you can configure the Cisco WebEx Node SPA, you must shut down the service-engine interface using
the shutdown interface configuration command. To activate the service-engine interface, use the noshutdown
command.
Once you configure the service-enginewma-passcode command and enter the key-string into the running
configuration, the key-string is encrypted. Therefore, you cannot successfully copy the passcode from the
running configuration or a backup version of your configuration file to running-configuration. The
service-enginewma-passcode command must be re-entered.
Examples The following example defines the authentication SPA name and passcode for the Cisco WebEx
Node SPA in slot 1/0:
Router(config)# interface service-engine 1/0
Router(config-if)# shutdown
Router(config-if)# service-engine wma-passcode wma-spa-1 spa1pass
Cisco IOS Interface and Hardware Component Command Reference
960
scramble through service-module t1 lbo
service-engine wma-passcode
Related Commands Command Description
service-engine default-gateway Defines a default gateway router IP address for the Cisco WebEx
Node SPA.
service-engine ip address Selects and configures the internal interface for management traffic
on a Cisco WebEx Node SPA.
service-engine hostname Specifies or modifies the hostname or domain name associated
with a Cisco WebEx Node SPA.
service-engine nameserver Specifies the primary and secondary domain name server used by
the Cisco WebEx Node SPA.
service-engine wma-token Configures an encrypted token on a Cisco WebEx Node SPA.
service-engine wma-url Specifies the URL to which the Cisco WebEx Node SPA must
connect to enable WebEx meetings.
show hw-module subslot service-engine Displays the Cisco WebEx Node SPA application status.
status
Cisco IOS Interface and Hardware Component Command Reference
961
scramble through service-module t1 lbo
service-engine wma-token
service-engine wma-token
To configure an encrypted token for a Cisco WebEx Node SPA in a Cisco ASR 1000 Series Router, use the
service-enginewma-tokencommand in interface configuration mode. To disable this function, use the no
form of this command.
service-engine wma-token token-string
no service-engine wma-token
Syntax Description token-string Specifies the encrypted token for the WebEx Node SPA.
Command Default The encrypted token for a Cisco WebEx Node SPA is disabled.
Command Modes Interface configuration (config-if)
Command History Release Modification
IOS XE Release 2.4 This command was introduced.
Usage Guidelines The service-enginewma-tokencommand is used to configure an encrypted token for the Cisco WebEx Node
SPA. Both the token and the passcode (configured using the service-enginewma-passcodecommand) are
used together for authentication of the Cisco WebEx Node SPA.
Before you can configure this command, you must first provision the Cisco WebEx Node SPA at the WebEx
Data Center. The value of the token string provisioned in the Cisco WebEx Node Management System for
the SPA must match the value of the passcode string configured in the service-enginewma-tokencommand.
For more information, refer to the “Configuring the Cisco WebEx Node for ASR 1000 Series” chapter of the
Cisco ASR 1000 Series Aggregation Services Routers SIP and SPA Software Configuration Guide .
Note Before you can configure the Cisco WebEx Node SPA, you must shut down the service-engine interface using
the shutdown interface configuration command. To activate the service-engine interface, use the
noshutdowncommand.
Examples The following example specifies the token for the Cisco WebEx Node SPA in slot 1/0:
Router(config)# interface service-engine 1/0
Router(config-if)# shutdown
Router(config-if)# service-engine wma-token 123456789
Related Commands Command Description
service-engine default-gateway Defines a default gateway router IP address for the Cisco WebEx
Node SPA.
service-engine ip address Selects and configures the internal interface for management traffic
on a Cisco WebEx Node SPA.
Cisco IOS Interface and Hardware Component Command Reference
962
scramble through service-module t1 lbo
service-engine wma-token
Command Description
service-engine hostname Specifies or modifies the hostname or domain name associated
with a Cisco WebEx Node SPA.
service-engine nameserver Specifies the primary and secondary domain name server used by
the Cisco WebEx Node SPA.
service-engine wma-passcode Configures the name and key that are used for authentication on
a Cisco WebEx Node SPA.
service-engine wma-url Specifies the URL to which the Cisco WebEx Node SPA must
connect to enable WebEx meetings.
show hw-module subslot service-engine Displays the Cisco WebEx Node SPA application status.
status
Cisco IOS Interface and Hardware Component Command Reference
963
scramble through service-module t1 lbo
service-engine wma-url
service-engine wma-url
To specify the URL to which the Cisco WebEx Node SPA in a Cisco ASR 1000 Series Router must connect
to enable WebEx meetings, use the service-enginewma-urlcommand in interface configuration mode. To
disable this function, use the no form of this command.
service-engine wma-url url-string
no service-engine wma-url
Syntax Description url-string Specifies the URL to connect to the WebEx MediaTone Center.
Command Default No URL string is configured.
Command Modes Interface configuration (config-if)
Command History Release Modification
IOS XE Release 2.4 This command was introduced.
Usage Guidelines Theservice-enginewma-url command is used to configure the URL that enables connectivity to the WebEx
Data Center.
Before you can configure this command, you must first provision the Cisco WebEx Node SPA at the WebEx
Data Center. The URL string provisioned in the Cisco WebEx Node Management System for the SPA must
match the value of the URL configured in the service-enginewma-urlcommand. For more information, refer
to the “Configuring the Cisco WebEx Node for ASR 1000 Series” chapter of the Cisco ASR 1000 Series
Aggregation Services Routers SIP and SPA Software Configuration Guide .
Note Before you can configure the Cisco WebEx Node SPA, you must shut down the service-engine interface using
the shutdown interface configuration command. To activate the service-engine interface, use the noshutdown
command.
Examples The following example specifies the URL to which the Cisco WebEx Node SPA in slot 1/0 must
connect:
Router(config)# interface service-engine 1/0
Router(config-if)# shutdown
Router(config-if)# service-engine wma-url https://spa.webex.com
Related Commands Command Description
service-engine default-gateway Defines a default gateway router IP address for the Cisco WebEx
Node SPA.
service-engine ip address Selects and configures the internal interface for management
traffic on a Cisco WebEx Node SPA.
Cisco IOS Interface and Hardware Component Command Reference
964
scramble through service-module t1 lbo
service-engine wma-url
Command Description
service-engine hostname Specifies or modifies the hostname or domain name associated
with a Cisco WebEx Node SPA.
service-engine nameserver Specifies the primary and secondary domain name server used
by the Cisco WebEx Node SPA.
service-engine wma-passcode Configures the name and key that are used for authentication on
a Cisco WebEx Node SPA.
service-engine wma-token Configures an encrypted token on a Cisco WebEx Node SPA.
show hw-module subslot service-engine Displays the Cisco WebEx Node SPA application status.
status
Cisco IOS Interface and Hardware Component Command Reference
965
scramble through service-module t1 lbo
service single-slot-reload-enable
service single-slot-reload-enable
To enable single line card reloading for all line cards in the Cisco 7500 series router, use the
servicesingle-slot-reload-enablecommand in global configuration mode. To disable single line card reloading
for the line cards in the Cisco 7500 series router, use the no form of this command.
service single-slot-reload-enable
no service single-slot-reload-enable
Syntax Description This command has no arguments or keywords.
Command Default Single line card reloading is disabled.
Command Modes Global configuration
Command History Release Modification
12.0(13)S This command was introduced.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples In the following example, single line card reloading is enabled for all lines cards on the Cisco 7500
series router:
Router(config)# service single-slot-reload-enable
Related Commands Command Description
show diag Displays hardware information for a networking device.
show running-config Displays configuration information.
Cisco IOS Interface and Hardware Component Command Reference
966
scramble through service-module t1 lbo
service-module
service-module
To set service module parameters, use the service-modulecommandinprivilegedEXEC mode.
service-module GigabitEthernet interface-number {heartbeat-reset
{disable|enable}|password-reset|reload|reset|session [clear]|shutdown [no-confirm]|statistics
[clear]|status}
Syntax Description GigabitEthernet interface-number Specifies the Gigabit Ethernet interface number.
heartbeat-reset Specifies the heartbeat failure to reset the service module.
disable Disables the heartbeat reset.
enable Enables the heartbeat reset.
password-reset Specifies the password reset for the service module.
reload Reloads the service module.
reset Resets the service module hardware.
session Specifies the service module session.
clear (Optional) Clears the existing service module session when used with
the session keyword. Clears the service module statistics when used
with the statistics keyword.
shutdown Shuts down the service module.
no-confirm (Optional) Configures the system not to confirm before the shutdown.
statistics Specifies service module statistics.
status Specifies service module status information.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced in a release earlier than Cisco IOS Release 15.0(1)M.
Usage Guidelines Use this command with the reset keyword only to recover from the shutdown or failed state. Use the shutdown
keyword for online removal of a service module. When you shut down a service module on switch modules,
the line protocol on the GigabitEthernet interface goes down. If the line protocol does not go down, first shut
down the interface using the shutdown command in interface configuration mode and then shut down the
service module using the service-moduleGigabitEthernetinterface-numbershutdown command.
Examples The following example shows how to disable the heartbeat reset:
Cisco IOS Interface and Hardware Component Command Reference
967
scramble through service-module t1 lbo
service-module
Router# service-module GigabitEthernet 1/0 heartbeat-reset disable
The following example shows the status of the service module:
Router# service-moduleGigabitEthernet1/0status
Service Module is Cisco GigabitEthernet1/0
Service Module supports session via TTY line 66
Service Module is Shutdown
Service Module reset on error is disabled
Service Module heartbeat-reset is enabled
Service Module status is not available
The following example shows how to shut down an interface before shutting down the service module:
Router(config)# interface GigabitEthernet 1/0
Router(config-if)# shutdown
The following example shows how to shut down a service module:
Router# service-module GigabitEthernet 1/0 shutdown
Related Commands Command Description
show interfaces sm Displays basic interface configuration information for service modules.
shutdown (interface) Disables an interface.
Cisco IOS Interface and Hardware Component Command Reference
968
scramble through service-module t1 lbo
service-module 56k clock rate
service-module 56k clock rate
To configure the network line speed for a serial interface on a 4-wire, 56/64-kbps CSU/DSU module, use the
service-module56kclockratecommand in interface configuration mode. To enable a network line speed of
56 kbps, which is the default, use the no form of this command.
service-module 56k clock rate commandservice-module 56k clock rate speed
no service-module 56k clock rate speed
Syntax Description speed Network line speed in kbps. The default speed is 56 kbps. Choose from one of the following optional
speeds:
• 2.4 -- 2.4 kbps
• 4.8 -- 4.8 kbps
• 9.6 -- 9.6 kbps
• 19.2 -- 19.2 kbps
• 38.4 -- 38.4 kbps
• 56 -- 56 kbps (default)
• 64 -- 64 kbps
• auto --Automatic line speed mode. Configure this option if your line speed is constantly
changing.
Command Default 56 kbps
Command Modes Interface configuration
Command History Release Modification
11.2 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The 56-kbps line speed is available in switched mode, which is enabled using the
service-module56knetwork-type interface configuration command on the 4-wire CSU/DSU. If you have a
2-wire CSU/DSU module, the default is automatically set to switched mode.
The 64-kbps line speed cannot be used with back-to-back digital data service (DDS) lines. The subrate line
speeds are determined by the service provider.
The autokeyword enables the CSU/DSU to decipher current line speed from the sealing current running on
the network. Use the auto keyword only when transmitting over telco DDS lines and the clocking source is
taken from the line.
Cisco IOS Interface and Hardware Component Command Reference
969
scramble through service-module t1 lbo
service-module 56k clock rate
Examples The following example displays two routers connected in back-to-back DDS mode. However, notice
that at first the configuration fails because the auto option is used. Later in the example the correct
matching configuration is issued, which is 38.4 kbps.
Router1(config)# interface serial 0
Router1(config-if)# service-module 56k clock source internal
Router1(config-if)# service-module 56k clock rate 38.4
Router2(config-if)# service-module 56k clock rate auto
Router1# ping 10.1.1.2
Type escape sequence to abort.
Sending 5, 100-byte ICMP Echos to 10.1.1.2, timeout is 2 seconds:
.....
Success rate is 0 percent (0/5)
Router2(config-if)# service-module 56k clock rate 38.4
Router1# ping 10.1.1.2
Type escape sequence to abort.
Sending 5, 100-byte ICMP Echos to 10.1.1.2, timeout is 2 seconds:
!!!!!
Success rate is 100 percent (5/5), round-trip min/avg/max = 52/54/56 ms
When transferring from DDS mode to switched mode, you must set the correct clock rate, as shown
in the following example:
Router2(config-if)# service-module 56k network-type dds
Router2(config-if)# service-module 56k clock rate 38.4
Router2(config-if)# service-module 56k network-type switched
% Have to use 56k or auto clock rate for switched mode
% Service module configuration command failed: WRONG FORMAT.
Router2(config-if)# service-module 56k clock rate auto
% WARNING - auto rate will not work in back-to-back DDS.
Router2(config-if)# service-module 56k network-type switched
Related Commands Command Description
service-module 56k clock source Sets up the clock source on a serial interface for a 4-wire, 56/64-kbps
CSU/DSU module.
service-module 56k network-type Sends packets in switched dial-up mode or DDS mode using a serial
interface on a 4-wire, 56/64-kbps CSU/DSU module.
Cisco IOS Interface and Hardware Component Command Reference
970
scramble through service-module t1 lbo
service-module 56k clock source
service-module 56k clock source
To set up the clock source on a serial interface for a 4-wire, 56/64-kbps CSU/DSU module, use the
service-module56kclocksourcecommand in interface configuration mode. To specify that the clocking come
from the line, use the no form of this command.
service-module 56k clock source commandservice-module 56k clock source {line|internal}
no service-module 56k clock source {line|internal}
Syntax Description line Uses the clocking provided by the active line coming in to the router. This is the default.
internal Uses the internal clocking provided by the hardware module.
Command Default Line clock
Command Modes Interface configuration
Command History Release Modification
11.1 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines In most applications, the CSU/DSU should be configured with the clocksourceline command. For back-to-back
configurations, configure one CSU/DSU with the clocksourceinternal command and the other with
clocksourceline command.
Examples The following example configures internal clocking and transmission speed at 38.4 kbps.
Router(config)# interface serial 0
Router(config-if)# service-module 56k clock source internal
Router(config-if)# service-module 56k clock rate 38.4
Related Commands Command Description
clock source (interface) Controls the clock used by a G.703-E1 interface.
service-module 56k clock rate Configures the network line speed for a serial interface on a 4-wire,
56/64-kbps CSU/DSU module.
Cisco IOS Interface and Hardware Component Command Reference
971
scramble through service-module t1 lbo
service-module 56k data-coding
service-module 56k data-coding
To prevent application data from replicating loopback codes when operating at 64 kbps on a 4-wire CSU/DSU,
use the service-module56kdata-coding command in interface configuration mode. To enable normal
transmission, use the no form of this command.
service-module 56k data-coding {normal|scrambled}
no service-module 56k data-coding {normal|scrambled}
Syntax Description normal Specifies normal transmission of data. This is the default.
scrambled Scrambles bit codes or user data before transmission. All control codes such as out-of-service
and out-of-frame are avoided.
Command Default Normal data transmission
Command Modes Interface configuration
Command History Release Modification
11.2 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Enable the scrambled configuration only in 64-kbps digital data service (DDS) mode. If the network type is
set to switched, the configuration is refused.
If you transmit scrambled bit codes, both CSU/DSUs must have this command configured for successful
communication.
Examples The following example s crambles bit codes or user data before transmission :
Router(config)# interface serial 0
Router(config-if)# service-module 56k clock rate 64
Router(config-if)# service-module 56k data-coding scrambled
Related Commands Command Description
service-module 56k clock rate Configures the network line speed for a serial interface on a 4-wire,
56/64-kbps CSU/DSU module.
Cisco IOS Interface and Hardware Component Command Reference
972
scramble through service-module t1 lbo
service-module 56k network-type
service-module 56k network-type
To transmit packets in switched dial-up mode or digital data service (DDS) mode using a serial interface on
a 4-wire, 56/64-kbps CSU/DSU module, use the service-module56knetwork-typecommand in interface
configuration mode. To transmit from a dedicated leased line in DDS mode, use the no form of this command.
service-module 56k network-type {dds|switched}
no service-module 56k network-type {dds|switched}
Syntax Description dds Transmits packets in DDS mode or through a dedicated leased line. The default is DDS enabled
for the 4-wire CSU/DSU.
switched Transmits packets in switched dial-up mode. On a 2-wire, switched 56-kbps CSU/DSU module,
this is the default and only setting.
Command Default DDS is enabled for the 4-wire CSU/DSU. Switched is enabled for the 2-wire CSU/DSU.
Command Modes Interface configuration
Command History Release Modification
11.2 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines In switched mode, you need additional dialer configuration commands to configure dial-out numbers. Before
you enable the service-module56knetwork-typeswitched command, both CSU/DSUs must use a clock
source coming from the line and have the clock rate configured to auto or 56 kbps. If the clock rate is not set
correctly, this command will not be accepted.
The 2-wire and 4-wire, 56/64-kbps CSU/DSU modules use V.25 bis dial commands to interface with the
router. Therefore, the interface must be configured using thedialerin-band command. Data terminal ready
(DTR) dial is not supported.
Note Any loopbacks in progress are terminated when switching between modes.
Examples The following example configures transmission in switched dial-up mode :
Router(config)# interface serial 0
Router(config
-if)#
service-module 56k clock rate auto
Router(config
-if)#
Cisco IOS Interface and Hardware Component Command Reference
973
scramble through service-module t1 lbo
service-module 56k network-type
service-module 56k network-type switched
Router(config
-if)#
dialer in-band
Router(config
-if)#
dialer string 5550111
Router(config
-if)#
dialer-group 1
Related Commands Command Description
dialer in-band Specifies that DDR is to be supported.
service-module 56k clock rate Configures the network line speed for a serial interface on a 4-wire,
56/64-kbps CSU/DSU module.
service-module 56k clock source Sets up the clock source on a serial interface for a 4-wire,
56/64-kbps CSU/DSU module.
service-module 56k switched-carrier Selects a service provider to use with a 2- or 4-wire, 56/64-kbps
dial-up serial line.
Cisco IOS Interface and Hardware Component Command Reference
974
scramble through service-module t1 lbo
service-module 56k remote-loopback
service-module 56k remote-loopback
To enable the acceptance of a remote loopback request on a serial interface on a 2- or 4-wire, 56/64-kbps
CSU/DSU module, use the service-module56kremote-loopback command in interface configuration mode.
To disable the module from entering loopback, use the no form of this command.
service-module 56k remote-loopback commandservice-module 56k remote-loopback
no service-module 56k remote-loopback commandservice-module 56k remote-loopback
Syntax Description This command has no arguments or keywords.
Command Default Enabled
Command Modes Interface configuration
Command History Release Modification
11.2 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The noservice-module56kremote-loopback command prevents the local CSU/DSU from being placed into
loopback by remote devices on the line. The line provider is still able to put the module into loopback by
reversing sealing current. Unlike the T1 module, the 2- or 4-wire, 56/64-kbps CSU/DSU module can still
initiate remote loopbacks with the no form of this command configured.
Examples The following example enables transmitting and receiving remote loopbacks:
Router(config)# interface serial 0
Router(config
-if)
# service-module 56k remote-loopback
Related Commands Command Description
loopback remote (interface) Loops packets through a CSU/DSU, over a DS3 link or a channelized T1
link, to the remote CSU/DSU and back.
Cisco IOS Interface and Hardware Component Command Reference
975
scramble through service-module t1 lbo
service-module 56k switched-carrier
service-module 56k switched-carrier
To select a service provider to use with a 2- or 4-wire, 56/64-kbps dial-up serial line, use the
service-module56kswitched-carrier command in interface configuration mode. To enable the default service
provider, use the no form of this command.
service-module 56k switched-carrier {att|sprint|other}
no service-module 56k switched-carrier {att|sprint|other}
Syntax Description att AT&T or other digital network service provider. This is the default on the 4-wire, 56/64-kbps
CSU/DSU module.
sprint Sprint or other service provider whose network requires echo cancelers. This is the default on the
2-wire, switched 56-kbps CSU/DSU module.
other Any other service provider.
Command Default ATT is enabled on the 4-wire, 56/64-kbps CSU/DSU module. Sprint is enabled on the 2-wire, switched
56-kbps CSU/DSU module.
Command Modes Interface configuration
Command History Release Modification
11.2 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines On a Sprint network, echo-canceler tones are sent during call setup to prevent the echo cancelers from damaging
digital data. The transmission of echo-canceler tones may increase call setup times by 8 seconds on the 4-wire
module. Having echo cancellation enabled does not affect data traffic.
This configuration command is ignored if the network type is DDS.
Examples The following example configures AT&T as a service provider :
Router(config)# interface serial 0
Router(config
-if)
# service-module 56k network-type switched
Router(config
-if)
# service-module 56k switched-carrier att
Cisco IOS Interface and Hardware Component Command Reference
976
scramble through service-module t1 lbo
service-module 56k switched-carrier
Related Commands Command Description
service-module 56k network-type Sends packets in switched dial-up mode or DDS mode using a serial
interface on a 4-wire, 56/64-kbps CSU/DSU module.
Cisco IOS Interface and Hardware Component Command Reference
977
scramble through service-module t1 lbo
service-module analysis-module reload
service-module analysis-module reload
To perform a graceful halt and reboot of the Network Analysis Module (NAM) software on the NM-NAM
network module, use the service-moduleanalysis-modulereload command in privileged EXEC mode.
service-module analysis-module slot/unit reload
Syntax Description slot Number of the router chassis slot for the network module.
/ unit Number of the daughter card on the network module. For the NM-NAM, always use 0. The slash
mark is required between the slot argument and the unitargument.
Command Modes Privileged EXEC
Command History Release Modification
12.3(4)XD This command was introduced on the following platforms: Cisco 2600XM series, Cisco 2691,
Cisco 3660, Cisco 3725, and Cisco 3745.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T.
12.3(8)T4 This command was implemented on the following platforms: Cisco 2811, Cisco 2821, and Cisco
2851.
12.3(11)T This command was implemented on the Cisco 3800 series.
Usage Guidelines The service-moduleanalysis-modulereloadcommand is the Cisco IOS equivalent of the reboot NAM CLI
command. These commands can be used to initiate the NAM software upgrade process or to access the NAM
helper image.
Examples The following example shows how to gracefully halt and reboot the NAM application software:
Router# service-module analysis-module 1/0 reload
Do you want to proceed with reload?[confirm]
Trying to reload Service Module Analysis-Module1/0.
Related Commands Command Description
service-module analysis-module reset Resets the hardware on the NM-NAM.
service-module analysis-module shutdown Gracefully halts the operating system on the NM-NAM.
service-module analysis-module status Displays hardware and software status information about
the NM-NAM.
Cisco IOS Interface and Hardware Component Command Reference
978
scramble through service-module t1 lbo
service-module analysis-module reset
service-module analysis-module reset
To reset the hardware on the Network Analysis Module (NM-NAM), use the
service-moduleanalysis-modulereset command in privileged EXEC mode.
service-module analysis-module slot/unit reset
Syntax Description slot Number of the router chassis slot for the network module.
/ unit Number of the daughter card on the network module. For the NM-NAM, always use 0. The slash
mark is required between the slot argument and the unitargument.
Command Modes Privileged EXEC
Command History Release Modification
12.3(4)XD This command was introduced on the following platforms: Cisco 2600XM series, Cisco 2691,
Cisco 3660, Cisco 3725, and Cisco 3745.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T.
12.3(8)T4 This command was implemented on the following platforms: Cisco 2811, Cisco 2821, and Cisco
2851.
12.3(11)T This command was implemented on the Cisco 3800 series.
Usage Guidelines Use the service-moduleanalysis-modulereset command to bring up the NM-NAM after it has been shut
down using the service-moduleanalysis-moduleshutdown command.
Examples The following example shows how to reset the hardware on the NM-NAM:
Router# service-module analysis-module 1/0 reset
Use reset only to recover from shutdown or failed state
Warning:May lose data on the hard disc!
Do you want to reset?[confirm]
Trying to reset Service Module Analysis-Module1/0.
Related Commands Command Description
service-module analysis-module reload Gracefully halts and reboots the software on the NM-NAM.
service-module analysis-module shutdown Gracefully halts the operating system on the NM-NAM.
service-module analysis-module status Displays hardware and software status information about
the NM-NAM.
Cisco IOS Interface and Hardware Component Command Reference
979
scramble through service-module t1 lbo
service-module analysis-module session
service-module analysis-module session
To access the Network Analysis Module (NAM) console from the router, use the
service-moduleanalysis-modulesession command in privileged EXEC mode.
service-module analysis-module slot/unit session [clear]
Syntax Description slot Number of the router chassis slot for the network module.
/ unit Number of the daughter card on the network module. For the NM-NAM, always use 0. The slash
mark is required between the slot argument and the unitargument.
clear (Optional) Clears the NAM console line.
Command Default The router cannot access the NAM console.
Command Modes Privileged EXEC
Command History Release Modification
12.3(4)XD This command was introduced on the following platforms: Cisco 2600XM series, Cisco 2691,
Cisco 3660, Cisco 3725, and Cisco 3745.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T.
12.3(8)T4 This command was implemented on the following platforms: Cisco 2811, Cisco 2821, and Cisco
2851.
12.3(11)T This command was implemented on the Cisco 3800 series.
Usage Guidelines When entered without the clear keyword, this command opens a NAM console session from the router.
Examples
Opening a NAM console Session
The following example shows how to open a NAM console session when the NM-NAM is installed
in router slot 2:
Router# service-module analysis-module 2/0 session
Trying 10.1.1.1, 2065 ... Open
<Press Return>
Cisco Network Analysis Module (NM-NAM)
nam1.cisco.com login: root
Password: <password>
Terminal type: vt100
Cisco Network Analysis Module (NM-NAM) Console, 3.2(0.9)
Copyright (c) 1999-2003 by Cisco Systems, Inc.
Cisco IOS Interface and Hardware Component Command Reference
980
scramble through service-module t1 lbo
service-module analysis-module session
WARNING! Default password has not been changed!
[email protected]#
Clearing the NAM Console Line
The following example shows how to clear the NAM console line when the NM-NAM is installed
in router slot 1:
Router# service-module analysis-module 1/0 session clear
[confirm]
[OK]
Related Commands Command Description
ssh Starts an encrypted session with a remote networking device.
telnet Logs in to a host that supports Telnet.
Cisco IOS Interface and Hardware Component Command Reference
981
scramble through service-module t1 lbo
service-module analysis-module shutdown
service-module analysis-module shutdown
To gracefully halt the operating system on the Network Analysis Module (NM-NAM), use the
service-moduleanalysis-moduleshutdown command in privileged EXEC mode.
service-module analysis-module slot/unit shutdown [no-confirm]
Syntax Description slot Number of the router chassis slot for the network module.
/ unit Number of the daughter card on the network module. For the NM-NAM, always use 0. The
slash mark is required between the slot argument and the unitargument.
no-confirm (Optional) No confirmation message appears before shutdown.
Command Modes Privileged EXEC
Command History Release Modification
12.3(4)XD This command was introduced on the following platforms: Cisco 2600XM series, Cisco 2691,
Cisco 3660, Cisco 3725, and Cisco 3745.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T.
12.3(8)T4 This command was implemented on the following platforms: Cisco 2811, Cisco 2821, and Cisco
2851.
12.3(11)T This command was implemented on the Cisco 3800 series.
Usage Guidelines The service-moduleanalysis-moduleshutdown command properly brings down the operating system of the
Network Analysis Module (NM-NAM) to protect the network module’s hard drive. When the operating system
has been shut down, the NM-NAM can be removed from the router.
At the confirmation prompt, press Enter to confirm the action or n to cancel.
If you enter the no-confirm keyword, the confirmation prompt does not appear.
Examples
Gracefully Halt the Operating System with Confirmation
The following example shows how to gracefully halt the operating system of the NM-NAM in slot
1:
Router# service-module analysis-module 1/0 shutdown
Shutdown is used for Online removal of Service Module.
Do you want to proceed with shutdown?[confirm]
Use service module reset command to recover from shutdown.
Cisco IOS Interface and Hardware Component Command Reference
982
scramble through service-module t1 lbo
service-module analysis-module shutdown
Gracefully Halt the Operating System -- No Confirmation
The following example shows how to gracefully halt the operating system of the NM-NAM in slot
2 without any user confirmation:
Router# service-module analysis-module 2/0 shutdown no-confirm
Use service module reset command to recover from shutdown.
Related Commands Command Description
service-module analysis-module reload Gracefully halts and reboots the software on the NM-NAM.
service-module analysis-module reset Resets the hardware on the NM-NAM.
service-module analysis-module status Displays hardware and software status information about the
NM-NAM.
Cisco IOS Interface and Hardware Component Command Reference
983
scramble through service-module t1 lbo
service-module analysis-module status
service-module analysis-module status
To display hardware and software status information about the Network Analysis Module (NM-NAM), use
the service-moduleanalysis-modulestatus command in privileged EXEC mode.
service-module analysis-module slot/unit status
Syntax Description slot Number of the router chassis slot for the network module.
/ unit Number of the daughter card on the network module. For the NM-NAM, always use 0. The slash
mark is required between the slot argument and the unitargument.
Command Modes Privileged EXEC
Command History Release Modification
12.3(4)XD This command was introduced on the following platforms: Cisco 2600XM series, Cisco 2691,
Cisco 3660, Cisco 3725, and Cisco 3745.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T.
12.3(8)T4 This command was implemented on the following platforms: Cisco 2811, Cisco 2821, and Cisco
2851.
12.3(11)T This command was implemented on the Cisco 3800 series.
Usage Guidelines Use the service-moduleanalysis-modulestatus command to:
• Display the NAM software release version.
• Check the NAM status (steady or down).
Examples The command in the following example displays information about the NM-NAM in router slot 1:
Router# service-module analysis-module 1/0 status
Service Module is Cisco Analysis-Module1/0
Service Module supports session via TTY line 33
Service Module is in Steady state
Getting status from the Service Module, please wait...
Cisco Network Analysis Module (NM-NAM), version 3.2(0.8)
Related Commands Command Description
show controllers analysis-module Displays controller information for the analysis module interface.
show interfaces analysis-module Displays status, traffic data, and configuration information about the
analysis module interface.
Cisco IOS Interface and Hardware Component Command Reference
984
scramble through service-module t1 lbo
service-module backup interface
service-module backup interface
To configure an interface as a secondary or dial backup to the satellite interface, use the
servicemodulebackupinterface command in satellite interface configuration mode. To remove the backup
interface configuration, use the no form of this command.
service module backup interface interface
no service module backup interface interface
Syntax Description interface Interface type and number.
Command Default No default behavior or values
Command Modes Satellite interface configuration
Command History Release Modification
12.3(14)T This command was introduced.
Examples The following example shows how to set interface async 1 as the backup to the satellite link:
Router(config-if)# service-module backup interface async1
Related Commands Command Description
service-module backup mode Sets the terrestrial backup mode for the Cisco IP VSAT satellite WAN
network module (NM-1VSAT-GILAT).
Cisco IOS Interface and Hardware Component Command Reference
985
scramble through service-module t1 lbo
service-module backup mode
service-module backup mode
To set the terrestrial dial backup mode for the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT), use the service-modulebackupmode command in satellite interface configuration
mode. To return to the router (default) dial backup mode, use the no form of this command.
service-module backup mode [{hub|router}]
no service-module backup mode
Syntax Description hub Hub dial backup mode.
router Router dial backup mode.
Command Default Router dial backup mode
Command Modes Satellite interface configuration
Command History Release Modification
12.3(14)T This command was introduced.
Usage Guidelines Hub Dial Backup Mode
Hub dial backup mode maintains TCP connections during transitions between primary and backup links. Note,
however, that hub dial backup mode provides backup for the satellite link , but not for the NM-1VSAT-GILAT
network module hardware, the router satellite interface, or other router interfaces. If the satellite link goes
down (for example, because of rain fade) in hub dial backup mode, the NM-1VSAT-GILAT network module
connects to the hub using dial-on-demand routing (DDR). Common DDR backup links use ISDN BRIs,
modems on auxiliary ports, and T1/E1 lines.
The NM-1VSAT-GILAT network module always encapsulates packets using a satellite backbone protocol
before sending the packets over the satellite link. In hub dial backup mode, the NM-1VSAT-GILAT network
module continues to encapsulate the packets using the satellite backbone protocol before sending the packets
over the dial backup link to the hub; this is how hub dial backup mode maintains TCP connections during
transitions between the primary satellite link and the dial backup link. Therefore, hub dial backup mode works
only when the NM-1VSAT-GILAT network module itself is functioning properly.
Router Dial Backup Mode
If the satellite link goes down in router dial backup mode, the router uses DDR to send data out a different
interface. Unlike hub dial backup mode, router dial backup mode does these things:
• Tears down and reestablishes TCP connections during transitions between primary and backup links
• Does not require that the NM-1VSAT-GILAT network module work properly while the backup link is
in use
Examples The following example shows how to specify hub backup mode:
Router(config-if)# service-module backup mode hub
Cisco IOS Interface and Hardware Component Command Reference
986
scramble through service-module t1 lbo
service-module backup mode
The following example shows how to specify router backup mode:
Router(config-if)# service-module backup mode router
Related Commands Command Description
service-module backup interface Specifies the interface to use to back up the satellite interface.
Cisco IOS Interface and Hardware Component Command Reference
987
scramble through service-module t1 lbo
service-module content-engine reload
service-module content-engine reload
To perform a graceful halt and reboot of a content engine (CE) network module operating system, use the
service-modulecontent-enginereload command in privileged EXEC mode.
service-module content-engine slot/unit reload
Syntax Description slot Number of the router chassis slot for the network module.
/ unit Number of the daughter card on the network module. For CE network modules, always use 0. The
slash mark is required between the slot argument and the unitargument.
Command Modes Privileged EXEC
Command History Release Modification
12.2(11)YT This command was introduced.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.
Usage Guidelines At the confirmation prompt, press Enter to confirm the action or n to cancel.
Examples The following example gracefully halts and reboots the CE network module operating system in slot
1:
Router# service-module content-engine 1/0 reload
Do you want to proceed with reload?[confirm]
Related Commands Command Description
interface content-engine Configures an interface for a CE network module and enters
interface configuration mode.
service-module content-engine reset Resets the hardware on a CE network module.
service-module content-engine shutdown Gracefully halts a CE network module.
show controllers content-engine Displays controller information for CE network modules.
show interfaces content-engine Displays basic interface configuration information for a CE
network module.
Cisco IOS Interface and Hardware Component Command Reference
988
scramble through service-module t1 lbo
service-module content-engine reset
service-module content-engine reset
To reset the hardware on a content engine (CE) network module, use the service-modulecontent-enginereset
command in privileged EXEC mode.
service-module content-engine slot/unit reset
Syntax Description slot Number of the router chassis slot for the network module.
/ unit Number of the daughter card on the network module. For CE network modules, always use 0. The
slash mark is required between the slot argument and the unitargument.
Command Modes Privileged EXEC
Command History Release Modification
12.2(11)YT This command was introduced.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.
Usage Guidelines At the confirmation prompt, press Enter to confirm the action or n to cancel.
Note Use the service-modulecontent-enginereset command only to recover from a shutdown or failed state because
you may lose data.
Examples The following example resets the hardware on the CE network module in slot 1:
Router# service-module content-engine 1/0 reset
Use reset only to recover from shutdown or failed state
Warning: May lose data on the hard disc!
Do you want to reset?[confirm]
Related Commands Command Description
interface content-engine Configures an interface for a CE network module and enters
interface configuration mode.
service-module content-engine reload Performs a graceful halt and reboot of a CE network module
operating system.
service-module content-engine shutdown Gracefully halts a CE network module.
show controllers content-engine Displays controller information for CE network modules.
show interfaces content-engine Displays basic interface configuration information for a CE
network module.
Cisco IOS Interface and Hardware Component Command Reference
989
scramble through service-module t1 lbo
service-module content-engine session
service-module content-engine session
To access a content engine (CE) network module console and begin a configuration session, use the
service-modulecontent-enginesession command in privileged EXEC mode.
service-module content-engine slot/unit session [clear]
Syntax Description slot Number of the router chassis slot for the network module.
/ unit Number of the daughter card on the network module. For CE network modules, always use 0. The
slash mark is required between the slot argument and the unitargument.
clear (Optional) Clears the CE configuration session.
Command Modes Privileged EXEC
Command History Release Modification
12.2(11)YT This command was introduced.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.
Usage Guidelines Only one session at a time is allowed into the content engine from the internal CE network-module-side
interface. This interface provides console access to the CE network module from the router command-line
interface (CLI) by initiating a reverse Telnet connection that uses the IP address of the CE interface and the
terminal (TTY) line associated with the CE network module. The TTY line number is calculated using the
formula (n*32) + 1, where n is the number of the chassis slot that contains the CE network module. The CE
interface must be up before you can use this command.
Once a session is started, you can perform any CE configuration task. You first access the CE console in a
user-level shell. To access the privileged EXEC command shell, where most commands are available, use the
enable command. Note that this is a Cisco Application and Content Networking System (ACNS) software
command, not a Cisco IOS software command.
CE configuration tasks are described in the documentation for Cisco Application and Content Networking
Software, Release 4.2. Initial CE configuration tasks are covered in the Cisco Content Delivery Networking
Products Getting Started Guide, section 6, “Perform an Initial Startup Configuration.”
After you finish CE configuration and exit the CE console session, use this command with the clear keyword
to clear the session. At the confirmation prompt, press Enter to confirm the action or n to cancel.
Examples The following example shows a CE session being opened for a CE network module in slot 2:
Router# service-module content-engine 2/0 session
Trying 10.10.10.1, 2129 ... Open
CE-netmodule con now available
Press RETURN to get started!
CE-netmodule> enable
CE-netmodule#
Cisco IOS Interface and Hardware Component Command Reference
990
scramble through service-module t1 lbo
service-module content-engine session
The following example clears the session that had been used to configure the CE in the network
module in slot 1:
Router# service-module content-engine 1/0 session clear
[confirm]
[OK]
Related Commands Command Description
interface content-engine Configures an interface for a CE network module and enters interface
configuration mode.
show controllers content-engine Displays controller information for CE network modules.
show interfaces content-engine Displays basic interface configuration information for a CE network
module.
Cisco IOS Interface and Hardware Component Command Reference
991
scramble through service-module t1 lbo
service-module content-engine shutdown
service-module content-engine shutdown
To gracefully halt a content engine (CE) network module, use the service-modulecontent-engineshutdown
command in privileged EXEC mode.
service-module content-engine slot/unit shutdown
Syntax Description slot Number of the router chassis slot for the network module.
/ unit Number of the daughter card on the network module. For CE network modules, always use 0. The
slash mark is required between the slot argument and the unitargument.
Command Modes Privileged EXEC
Command History Release Modification
12.2(11)YT This command was introduced.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.
Usage Guidelines At the confirmation prompt, press Enter to confirm the action or n to cancel.
The service-modulecontent-engineshutdown command brings down the operating system of the specified
content engine network module in an orderly fashion to protect the network module’s hard drive. When the
system has been shut down, the network module can be removed from the router.
Examples The following example gracefully halts the CE network module in slot 1:
Router# service-module content-engine 1/0 shutdown
Shutdown is used for Online removal of Service Module.
Do you want to proceed with shutdown?[confirm]
Use service module reset command to recover from shutdown.
Related Commands Command Description
interface content-engine Configures an interface for a CE network module and enters
interface configuration mode.
service-module content-engine reload Performs a graceful halt and reboot of a CE network module
operating system.
service-module content-engine reset Resets the hardware on a CE network module.
show controllers content-engine Displays controller information for CE network modules.
show interfaces content-engine Displays basic interface configuration information for a CE
network module.
Cisco IOS Interface and Hardware Component Command Reference
992
scramble through service-module t1 lbo
service-module content-engine status
service-module content-engine status
To display configuration information related to the hardware and software on the content engine (CE) side of
a CE network module, use the service-modulecontent-enginestatuscommand in privileged EXEC mode.
service-module content-engine slot/unit status
Syntax Description slot Number of the router chassis slot for the network module.
/ unit Number of the daughter card on the network module. For CE network modules, always use 0. The
slash mark is required between the slot argument and the unitargument.
Command Modes Privileged EXEC
Command History Release Modification
12.2(11)YT This command was introduced.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.
Usage Guidelines Use the service-modulecontent-enginestatus command to:
• Display the CE network module software release version.
• Check the CE network module status (steady or down).
• Display hardware information for the CE network module including CPU, memory, interface, and disk
drive information.
Examples The following example displays information for a CE network module in router slot 1:
Router# service-module content-engine 1/0 status
Service Module is Cisco Content-Engine1/0
Service Module supports session via TTY line 33
Service Module is in Steady state
Getting status from the Service Module, please wait..
Application and Content Networking Software (ACNS)
Copyright (c) 1999-2002 by Cisco Systems, Inc.
Application and Content Networking Software Release 4.2.2 (build b3 May 6 2002)
Version: ce2636-sw-<unknown-version>
Compiled 18:03:40 May 6 2002 by engineer
Compile Time Options: PP
System was restarted on Mon Jan 7 20:30:37 1980.
The system has been up for 8 minutes, 30 seconds.
Core CPU is GenuineIntel Pentium III (Coppermine) (rev 8) running at 498MHz.
246 Mbytes of Physical memory.
2 FastEthernet interfaces
1 Console interface
List of disk drives:
disk00: Normal (h00 c00 i00 l00) 19075MB( 18.6GB)
Cisco IOS Interface and Hardware Component Command Reference
993
scramble through service-module t1 lbo
service-module content-engine status
Related Commands Command Description
interface content-engine Configures an interface for a CE network module and enters interface
configuration mode.
show controllers content-engine Displays controller information for CE network modules.
show interfaces content-engine Displays basic interface configuration information for a CE network
module.
Cisco IOS Interface and Hardware Component Command Reference
994
scramble through service-module t1 lbo
service-module external ip address
service-module external ip address
To define the IP address for the external LAN interface on a content engine (CE) network module, use the
service-moduleexternalipaddresscommand in content-engine interface configuration mode. To delete the
IP address associated with this interface, use the no form of this command.
service-module external ip address external-ip-addr subnet-mask
no service-module external ip address
Syntax Description external-ip-addr IP address of the external LAN interface on a CE network module.
subnet-mask Subnet mask to append to the IP address.
Command Default No default behavior or values
Command Modes Content-engine interface configuration
Command History Release Modification
12.2(11)YT This command was introduced.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.
Examples The following example defines an IP address for the external LAN interface on the CE network
module in slot 1:
Router(config)# interface content-engine 1/0
Router(config-if)# service-module external ip address
172.18.12.28 255.255.255.0
Router(config-if)# exit
Related Commands Command Description
interface content-engine Configures an interface for a CE network module and enters interface
configuration mode.
show controllers content-engine Displays controller information for CE network modules.
show interfaces content-engine Displays basic interface configuration information for a CE network
module.
Cisco IOS Interface and Hardware Component Command Reference
995
scramble through service-module t1 lbo
service-module heartbeat-reset disable
service-module heartbeat-reset disable
To disable the service module from being reset when the heartbeat is lost, use the service-module heartbeat-reset
disable command in configuration interface mode. To allow a reset of the service module when no heartbeat
is received, use the no form of this command.
service-module heartbeat-reset disable
no service-module heartbeat-reset disable
Syntax Description This command has no arguments or keywords.
Command Default Heartbeat reset is enabled.
Command Modes Configuration interface (config-if)
Command History Release Modification
15.1(4)M This command was introduced.
Usage Guidelines With the existing IOS code, if no heartbeat is received from a service module after a period of time, the IOS
resets the service module. For some applications, this reset function should be disabled because it blocks
normal operations.
This command, being a configuration mode command, persists through router reloads.
Alternatively, the service-module ism heartbeat-reset disable command and the service-module sm
heartbeat-reset disable command can prevent Cisco IOS software from rebooting the internal service module
(ISM) and the SM-SRE service module, respectively, when the heartbeat is lost. However, both these commands
are EXEC mode commands and they are lost when the router reboots.
Examples The following example shows how to disable the heartbeat reset:
Router(config)# interface sm 1/0
Router(config-if)# service-module heartbeat-reset disable
Related Commands Command Description
service-module Sets service module parameters.
service-module ism heartbeat-reset Prevents Cisco IOS software from rebooting the ISM when the
heartbeat is lost.
service-module sm heartbeat-reset Prevents Cisco IOS software from rebooting the SM-SRE service
module when the heartbeat is lost.
Cisco IOS Interface and Hardware Component Command Reference
996
scramble through service-module t1 lbo
service-module ids-sensor
service-module ids-sensor
To reboot, reset, enable console access to, shutdown, and monitor the status of the Cisco Intrusion Detection
System (IDS) network module, use the service-moduleids-sensor command in privileged EXEC mode.
service-module ids-sensor slot/port {reload|reset|session|shutdown|status}
Syntax Description slot Number of the router chassis slot for the network module.
/ port Port number of the network module. For Cisco IDS network modules, always use 0. The slash
mark is required between the slot argument and the unitargument.
reload Performs a graceful halt and reboot of the operating system on a Cisco IDS network module.
reset Resets the hardware on the Cisco IDS network module. This command is usually used to recover
from a shutdown.
session Enables console access to the Cisco IDS network module from the router.
shutdown Shuts down the IDS applications that are running on a Cisco IDS network module.
status Provides information on the status of the Cisco IDS software.
Command Modes Privileged EXEC
Command History Release Modification
12.3(4)T This command was introduced.
Usage Guidelines If a confirmation prompt is displayed, press Enter to confirm the action or n to cancel.
The Cisco IDS network module is also referred to as the NM-CIDS.
Examples The following example gracefully halts and reboots the operating system on the Cisco IDS network
module in slot 1:
Router# service-module ids-sensor 1/0 reload
Do you want to proceed with reload?[confirm]
The following example resets the hardware on the Cisco IDS network module in slot 1. A warning
is displayed.
Router# service-module ids-sensor 1/0 reset
Use reset only to recover from shutdown or failed state
Warning: May lose data on the hard disk!
Do you want to reset?[confirm]
Caution Hard-disk drive data loss occurs only if you issue the reset command without first shutting down the
Cisco IDS network module. You can use the reset command safely in other situations.
Cisco IOS Interface and Hardware Component Command Reference
997
scramble through service-module t1 lbo
service-module ids-sensor
The following example enables console access to the Cisco IDS network module operating system
in slot 1:
Router# service-module ids-sensor 1/0 session
The following example shuts down IDS applications that are running on the Cisco IDS network
module in slot 1:
Router# service-module ids-sensor 1/0 shutdown
Trying 10.10.10.1, 2129 ... Open
%SERVICEMODULE-5-SHUTDOWN2:Service module IDS-Sensor1/0 shutdown complete
The following example shows the status of the Cisco IDS software:
Router# service-module ids-sensor 1/0 status
Service Module is Cisco IDS-Sensor1/0
Service Module supports session via TTY line 33
Service Module is in Steady state
Getting status from the Service Module, please wait...
Service Module Version information received, Major ver = 1, Minor ver= 1
Cisco Systems Intrusion Detection System Network Module
Software version: 4.1(1)S42(0.3)
Model: NM-CIDS
Memory: 254676 KB
Related Commands Command Description
ids-service-module monitoring Enables IDS monitoring on a specified interface.
Cisco IOS Interface and Hardware Component Command Reference
998
scramble through service-module t1 lbo
service-module integrated-service-engine default-boot
service-module integrated-service-engine default-boot
To configure the integrated-service-engine (ISE) network module to use the default BIOS and bootloader,
use the service-module integrated-service-engine default-boot command in privileged EXEC mode.
service-module integrated-service-engine slot/unit default-boot
Syntax Description slot Number of the router chassis slot for the network module.
unit Number of daughter cards on the network module, if included. For ISE network modules, always use
0.
Command Default None
Command Modes Privileged EXEC
Command History Release Modification
12.4(9)T This command was introduced for the ISE network module.
Examples After a downtime event or failed upgrade, use the service-module
integrated-service-engineslot/unitdefault-boot command to configure the network module to use
the primary BIOS and primary bootloader to perform startup routines.
The following is sample output from the integrated-service-engineslot/unitdefault-boot command
for a port adapter in chassis slot 2 on a Cisco router:
Router# service-module integrated-service-engine 2/0 default-boot
clear Clear Default Boot
set Set Default Boot
Router# service-module integrated-service-engine 2/0 default-boot clear
Router# service-module integrated-service-engine 2/0 default-boot set
Cisco IOS Interface and Hardware Component Command Reference
999
scramble through service-module t1 lbo
service-module integrated-service-engine reload
service-module integrated-service-engine reload
To perform a graceful shutdown and reboot of the integrated-service-engine (ISE) network module operating
system, use the service-moduleintegrated-service-enginereload command in privileged EXEC mode.
service-module integrated-service-engine slot/unit reload
Syntax Description slot Number of the router chassis slot for the network module.
/ unit Number of the daughter card on the network module. For ISE network modules, always use 0. The
slash mark (/) is required between the slot argument and the unitargument.
Command Default None
Command Modes Privileged EXEC
Command History Release Modification
12.4(9)T This command was introduced for ISE network modules.
Usage Guidelines At the confirmation prompt, press Enter to confirm the action or n to cancel.
Examples The following example gracefully shuts down and reboots the ISE network module’s operating
system in slot 1:
Router# service-module integrated-service-engine 1/0 reload
Do you want to proceed with reload?[confirm]
Related Commands Command Description
interface integrated-service-engine Configures an interface for ISE network modules and enters
interface configuration mode.
service-module integrated-service-engine reset Resets the hardware on ISE network modules.
service-module integrated-service-engine Gracefully shuts down ISE network modules.
shutdown
show diag Displays controller information for ISE network modules.
show interfaces integrated-service-engine Displays basic interface configuration information for ISE
network modules.
Cisco IOS Interface and Hardware Component Command Reference
1000
scramble through service-module t1 lbo
service-module integrated-service-engine reset
service-module integrated-service-engine reset
To reset the integrated-service-engine (ISE) network module hardware, use the
service-moduleintegrated-service-enginereset command in privileged EXEC mode.
service-module integrated-service-engine slot/unit reset
Syntax Description slot Number of the router chassis slot for the network module.
/ unit Number of the daughter card on the network module. For ISE network modules, always use 0. The
slash mark (/) is required between the slot argument and the unitargument.
Command Default None
Command Modes Privileged EXEC
Command History Release Modification
12.4(9)T This command was introduced for ISE network modules.
Usage Guidelines At the confirmation prompt, press Enter to confirm the action or n to cancel.
Caution Because you may lose data, use the service-moduleintegrated-service-enginereset command only to recover
from a shutdown or failed state.
Examples The following example resets the hardware on the ISE network module in slot 1:
Router# service-module integrated-service-engine 1/0 reset
Use reset only to recover from shutdown or failed state
Warning: May lose data on the hard disk!
Do you want to reset?[confirm]
Related Commands Command Description
interface integrated-service-engine Configures an interface for ISE network modules and enters
interface configuration mode.
service-module integrated-service-engine Performs a graceful shutdown and reboot on the ISE network
reload module operating system.
service-module integrated-service-engine Gracefully shuts down ISE network modules.
shutdown
show diag Displays controller information for ISE network modules.
Cisco IOS Interface and Hardware Component Command Reference
1001
scramble through service-module t1 lbo
service-module integrated-service-engine reset
Command Description
show interfaces integrated-service-engine Displays basic interface configuration information for ISE
network modules.
Cisco IOS Interface and Hardware Component Command Reference
1002
scramble through service-module t1 lbo
service-module integrated-service-engine session
service-module integrated-service-engine session
To begin a configuration session with an integrated-service-engine (ISE) network module through a console
connection, use the service-moduleintegrated-service-enginesession command in privileged EXEC mode.
service-module integrated-service-engine slot/unit session [clear]
Syntax Description slot Number of the router chassis slot for the network module.
/ unit Number of the daughter card on the network module. For ISE network modules, always use 0. The
slash mark (/) is required between the slot argument and the unitargument.
clear (Optional) Clears the ISE configuration session.
Command Default None
Command Modes Privileged EXEC
Command History Release Modification
12.4(9)T This command was introduced for ISE network modules.
Usage Guidelines Only one session at a time is allowed into the network module from the internal ISE network-module-side
interface.
After starting a session, you can perform any ISE configuration task. You first access the ISE console in a
user-level shell. To access the privileged EXEC command shell, where most commands are available, use the
enable command.
After you finish ISE configuration and exit the ISE console session, use this command with the clear keyword
to clear the session. At the confirmation prompt, press Enter to confirm the action or n to cancel.
Examples The following example shows an ISE session being opened for an ISE network module in slot 2:
Router# service-module integrated-service-engine 2/0 session
Trying 10.10.10.1, 2129 ... Open
ISE-netmodule con now available
Press RETURN to get started!
ISE-netmodule> enable
ISE-netmodule#
The following example clears the session that had been used to configure the ISE in the network
module in slot 2:
Router# service-module integrated-service-engine 1/0 session clear
[confirm]
[OK]
Cisco IOS Interface and Hardware Component Command Reference
1003
scramble through service-module t1 lbo
service-module integrated-service-engine session
Related Commands Command Description
enable Enters prviledged EXEC mode.
interface Configures an interface and enters interface configuration mode.
show diag Displays controller information for a network module.
show interface integrated-service engine Displays basic interface configuration information for network
modules.
Cisco IOS Interface and Hardware Component Command Reference
1004
scramble through service-module t1 lbo
service-module integrated-service-engine shutdown
service-module integrated-service-engine shutdown
To gracefully shut down an integrated-service-engine (ISE) network module, use the
service-moduleintegrated-service-engineshutdown command in privileged EXEC mode.
service-module integrated-service-engine slot/unit shutdown
Syntax Description slot Number of the router chassis slot for the network module.
/ unit Number of the daughter card on the network module. For ISE network modules, always use 0. The
slash mark (/) is required between the slot argument and the unitargument.
Command Default None
Command Modes Privileged EXEC
Command History Release Modification
12.4(9)T This command was introduced for ISE network modules.
Usage Guidelines At the confirmation prompt, press Enter to confirm the action or n to cancel.
The service-moduleintegrated-service-engineshutdown command brings down the operating system of the
specified integrated-service-engine network module in an orderly fashion to protect the hard drive. When the
system has been shut down, the module can be removed from the router.
Examples The following example gracefully shuts down the ISE network module in slot 1:
Router# service-module integrated-service-engine 1/0 shutdown
Shutdown is used for Online removal of Service Module.
Do you want to proceed with shutdown?[confirm]
Use service module reset command to recover from shutdown.
Related Commands Command Description
interface integrated-service-engine Configures an interface for ISE network modules and enters
interface configuration mode.
service-module integrated-service-engine Performs a graceful shut down and reboot of an ISE network
reload module operating system.
service-module integrated-service-engine Resets the hardware on ISE network modules.
reset
show diag Displays controller information for ISE network modules.
show interfaces integrated-service-engine Displays basic interface configuration information for ISE
network modules.
Cisco IOS Interface and Hardware Component Command Reference
1005
scramble through service-module t1 lbo
service-module integrated-service-engine status
service-module integrated-service-engine status
To display configuration information related to the hardware and software on the integrated-service-engine
(ISE) side of a network module, use the service-moduleintegrated-service-enginestatuscommand in privileged
EXEC mode.
service-module integrated-service-engine slot/unit status
Syntax Description slot Number of the router chassis slot for the network module.
/ unit Number of the daughter card on the network module. For ISE network modules, always use 0. The
slash mark (/) is required between the slot argument and the unitargument.
Command Default None
Command Modes Privileged EXEC
Command History Release Modification
12.4(9)T This command was introduced for ISE network modules.
Usage Guidelines Use the service-moduleintegrated-service-enginestatus command to
• Display the ISE network module’s software release version
• Check the ISE network module status (steady or down)
• Display hardware information for the ISE network module, including CPU, memory, interface, and disk
drive information
Examples The following example displays information for an ISE network module in router slot 1:
Router# service-module integrated-service-engine 1/0 status
Service Module is Cisco integrated-service-engine1/0
Service Module supports session via TTY line 33
Service Module is in Steady state
Getting status from the Service Module, please wait..
Application and Content Networking Software (ACNS)
Copyright (c) 1999-2002 by Cisco Systems, Inc.
Application and Content Networking Software Release 4.2.2 (build b3 May 6 2002)
Version: ce2636-sw-<unknown-version>
Compiled 18:03:40 May 6 2002 by engineer
Compile Time Options: PP
System was restarted on Mon Jan 7 20:30:37 1980.
The system has been up for 8 minutes, 30 seconds.
Core CPU is GenuineIntel Pentium III (Coppermine) (rev 8) running at 498MHz.
246 Mbytes of Physical memory.
2 FastEthernet interfaces
1 Console interface
List of disk drives:
disk00: Normal (h00 c00 i00 l00) 19075MB( 18.6GB)
Cisco IOS Interface and Hardware Component Command Reference
1006
scramble through service-module t1 lbo
service-module integrated-service-engine status
Related Commands Command Description
interface integrated-service-engine Configures an interface for ISE network modules and enters
interface configuration mode.
show diag Displays controller information for ISE network modules.
show interfaces integrated-service-engine Displays basic interface configuration information for ISE network
modules.
Cisco IOS Interface and Hardware Component Command Reference
1007
scramble through service-module t1 lbo
service-module integrated-service-engine statistics
service-module integrated-service-engine statistics
To display reset and reload information for an integrated-service-engine (ISE) network module and its Cisco
IOS software, use the service-moduleintegrated-service-enginestatisticscommand in EXEC mode.
service-module integrated-service-engine slot/port statistics
Syntax Description module Designates a specific ISE network module installed in the router.
slot Designates the slot where the selected ISE network module is installed in the router.
Command Default none
Command Modes User EXEC
Privileged EXEC
Command History Release Modification
12.4(9)T This command was introduced for ISE network modules.
Examples The following example displays information for an ISE network module in an access router for slot
2:
Router# service-module integrated-service-engine 2/0 statistics
Module Reset Statistics:
CLI reset count = 1
CLI reload count = 0
Registration request timeout reset count = 0
Error recovery timeout reset count = 0
Module registration count = 2
The last IOS initiated event was a cli reset at *13:34:33.847 UTC Sun Dec 18 2005
Cisco IOS Interface and Hardware Component Command Reference
1008
scramble through service-module t1 lbo
service-module ip address
service-module ip address
To define the IP address for the internal network-module-side interface on a content engine network module
(NM-CE-BP), Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT), Cisco cable modem
high-speed WAN interface card (HWIC-CABLE-D-2, HWIC-CABLE-E/J-2), or the Cisco Services Ready
Engine (Cisco SRE) modules (SM-SRE-XXX-K9, ISM-SRE-XXX-K9) use the service-moduleipaddress
command in content-engine interface configuration mode, satellite interface configuration mode, content-engine
configuration mode, or service-module interface configuration mode. To delete the IP address associated with
this interface, use the no form of this command.
service-module ip address nm-side-ip-addr subnet-mask ["string" ]
no service-module ip address ["string" ]
Syntax Description nm-side-ip-addr IP address of the internal network-module-side interface on a CE network module
(NM-CE-BP), Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT),
or Cisco cable modem high-speed WAN interface card (HWIC-CABLE-D-2,
HWIC-CABLE-E/J-2).
subnet-mask Subnet mask to append to the IP address.
string (Optional) Name of the virtual interface on the module side that will be assigned the IP
address. The string must be in quotes. This argument is available on Cisco SRE modules
only.
Command Default The well-known diagnostic IP address of 192.168.100.1, is supported on all physical interfaces associated
with the cable modem to CPE interface (CMCI).
Command Modes Content-engine interface configuration Satellite interface configuration Cable-modem interface configuration
Service-module interface configuration
Command History Release Modification
12.2(11)YT This command was introduced for the CE network module.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.
12.3(14)T This command was implemented for the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT).
12.4(6)XE This command was implemented for the Cisco cable modem high-speed WAN interface card
(HWIC-CABLE-D-2, HWIC-CABLE-E/J-2).
15.1(4)M The optional string argument was added on Cisco SRE modules only.
Usage Guidelines Content Engine Network Module (NM-CE-BP)
There are no usage guidelines for this command.
Cisco IP VSAT Satellite WAN Network Module (NM-1VSAT-GILAT)
Cisco IOS Interface and Hardware Component Command Reference
1009
scramble through service-module t1 lbo
service-module ip address
For the NM-1VSAT-GILAT network module, the service-moduleipaddress command is typically not used.
The NM-1VSAT-GILAT network module IP address is automatically configured when you enter the ipaddress
command in satellite interface configuration mode to configure the IP address and subnet mask of the router
satellite interface with these conditions:
• The IP address leaves a remainder of 2 when the last octet is divided by 4.
• The subnet mask has /30 or fewer masking bits.
If you use this method to configure the IP address for the router satellite interface, the system automatically
configures the IP address and subnet mask on the NM-1VSAT-GILAT network module with these results:
• The IP address is 1 less than the IP address you configured for the router satellite interface.
• The subnet mask is /30.
You can override the automatically configured IP address and mask by manually entering the
service-moduleipaddress command.
Note The automatically configured IP address does not appear in the router configuration, because the
service-moduleipaddress command is considered to be set to its default value. Similarly, if you manually
configure an IP address and subnet mask that are identical to the automatically configured IP address and
subnet mask, the service-moduleipaddress command does not appear in the router configuration.
Cisco Cable Modem High-Speed WAN Interface Card (HWIC-CABLE-D-2, HWIC-CABLE-E/J-2)
There are no usage guidelines for this command.
Cisco SRE Modules (SM-SRE-XXX-K9, ISM-SRE-XXX-K9)
In Cisco IOS Release 15.1(4)M and later releases, the Cisco SRE modules support an optional “string”
argument to this command to allow for multiple IP addresses to be configured on the module side. The
application running on the SRE module can accept or reject the applied configuration.
Examples This section provides the following examples:
Content Engine Network Module (NM-CE-BP) Example
The following example shows how to define an IP address for the internal network-module-side
interface on the CE network module in slot 1:
Router(config)# interface content-engine 1/0
Router(config-if)# service-module ip address 172.18.12.26 255.255.255.0
Router(config-if)# exit
Cisco IOS Interface and Hardware Component Command Reference
1010
scramble through service-module t1 lbo
service-module ip address
Cisco IP VSAT Satellite WAN Network Module (NM-1VSAT-GILAT) Example--Manually Configuring
the IP Address
In the following example, the router satellite interface is assigned an IP address (10.0.0.7), the last
octet of which does not leave a remainder of 2 when divided by 4. The system displays a message
to manually configure the IP address for the NM-1VSAT-GILAT network module. Notice that the
IP addresses for both the router satellite interface and the NM-1VSAT-GILAT network module
appear in the running configuration.
Router(config)# interface satellite 1/0
Router(config-if)# ip address 10.0.0.7 255.255.255.0
%VSAT-6-PIMINCOMPADDR:The IP address configured on Satellite1/0
requires a manually configured IP address for the satellite module
Router(config-if)# service-module ip address 10.0.0.6 255.255.255.0
Router(config-if)# end
Router# show running-config | begin Satellite
interface Satellite 1/0
ip address 10.0.0.7 255.255.255.0
service-module ip address 10.0.0.6 255.255.255.0
Cisco IP VSAT Satellite WAN Network Module (NM-1VSAT-GILAT) Example--Using the Automatically
Configured IP Address
In the following example, the router satellite interface IP address is configured as 10.0.0.6. Because
the last octet of the IP address leaves a remainder of 2 when divided by 4, the system automatically
configures the IP address for the NM-1VSAT-GILAT network module.
Although the NM-1VSAT-GILAT network module IP address and mask do not appear in the router
configuration, you know that the IP address is 1 less than the IP address of the router satellite interface
and has a subnet mask of /30. In this case, the NM-1VSAT-GILAT network module is automatically
configured with the following IP address and mask: 10.0.0.5 255.255.255.252.
!
interface Satellite 1/0
ip address 10.0.0.6 255.255.255.0
!
Cisco IP VSAT Satellite WAN Network Module (NM-1VSAT-GILAT) Example--Overriding the
Automatically Configured IP Address
In the following example, the router satellite interface IP address is configured as 10.0.0.6. Because
the last octet of the IP address leaves a remainder of 2 when divided by 4, the system automatically
configures the IP address and mask for the NM-1VSAT-GILAT network module as 10.0.0.5
255.255.255.252.
Nevertheless, the NM-1VSAT-GILAT network module IP address and mask are manually configured
as 10.0.0.1 255.255.255.0 to override the automatically derived IP address and mask. Notice that the
IP addresses for both the router satellite interface and the NM-1VSAT-GILAT network module
appear in the running configuration.
Cisco IOS Interface and Hardware Component Command Reference
1011
scramble through service-module t1 lbo
service-module ip address
!
interface Satellite 1/0
ip address 10.0.0.6 255.255.255.0
service-module ip address 10.0.0.1 255.255.255.0
!
Cisco Cable Modem High-Speed WAN Interface Cards (HWIC-CABLE-D-2, HWIC-CABLE-E/J-2)
Example
The following example shows how to define an IP address for the cable modem interface in slot 0:
Router(config)# interface cable-modem 0
Router(config-if)# service-module ip address 172.18.12.26 255.255.255.0
Router(config-if)# exit
Cisco SRE Module (ISM-SRE-XXX-K9, SM-SRE-XXX-K9) Example
The following example shows how to define an IP address for the service module interface in slot
3:
Router(config)# interface SM 3/0
Router(config-if)# service-module ip address 172.18.12.26 255.255.255.0
Router (config-if)# service-module ip address 172.18.12.27 255.255.255.0 “VirtualMachine1”
Router (config-if)# service-module ip address 172.18.12.28 255.255.255.0 “VirtualMachine2”
Router(config-if)# exit
Related Commands Command Description
show controllers content-engine Displays controller information for CE network modules.
show controllers satellite Displays controller information about the internal router interface that
connects to an installed Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT).
show interfaces satellite Displays general interface settings and traffic rates for the internal router
interface that connects to an installed Cisco IP VSAT satellite WAN
network module (NM-1VSAT-GILAT).
show interfaces content-engine Displays basic interface configuration information for a CE network
module.
Cisco IOS Interface and Hardware Component Command Reference
1012
scramble through service-module t1 lbo
service-module ip default-gateway
service-module ip default-gateway
To define a default gateway (router) for a content engine (CE) network module, use the
service-moduleipdefault-gatewaycommand in content-engine interface configuration mode. To remove the
default gateway from the CE configuration, use the no form of this command.
service-module ip default-gateway gw-ip-addr
no service-module ip default-gateway
Syntax Description gw-ip-addr IP address of the default gateway.
Command Default No default behavior or values
Command Modes Content-engine interface configuration
Command History Release Modification
12.2(11)YT This command was introduced.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.
Examples The following example configures a default gateway for the CE network module in slot 1:
Router(config)# interface content-engine
1/0
Router(config-if)# service-module ip default-gateway
172.18.12.1
Router(config-if)# exit
Related Commands Command Description
interface content-engine Configures an interface for a CE network module and enters interface
configuration mode.
show controllers content-engine Displays controller information for CE network modules.
show interfaces content-engine Displays basic interface configuration information for a CE network
module.
Cisco IOS Interface and Hardware Component Command Reference
1013
scramble through service-module t1 lbo
service-module ip redundancy
service-module ip redundancy
To link the primary HSRP interface status to that of the satellite interface, use the service-module ip
redundancy command in satellite interface configuration mode. To remove the link between the primary
HSRP interface status and the satellite interface status, use the no form of this command.
service-module ip redundancy group-name
no service-module ip redundancy group-name
Syntax Description group-name Name of the hot standby group. This name must match the hot standby group name configured
for the primary HSRP interface, which is typically an Ethernet interface.
Command Default HSRP is disabled.
Command Modes Satellite interface configuration (config-if)
Command History Release Modification
12.3(14)T This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use the service-module ip redundancy command only when you have two Cisco IP VSAT satellite WAN
network modules (NM-1VSAT-GILAT) on separate HSRP-redundant routers that connect to the same outdoor
unit (ODU).
This command enables the satellite interface to spoof the line protocol UP state.
Examples The following example shows how to link the primary HSRP interface status to that of the satellite
interface:
Router (config-if)# service-module ip redundancy grp-hsrp
Related Commands Command Description
standby ip Activates HSRP.
standby name Configures the name of the hot standby group.
standby preempt Enables preemption on the router and optionally configures a preemption delay.
standby track Configures an interface so that the hot standby priority changes based on the availability
of other interfaces.
Cisco IOS Interface and Hardware Component Command Reference
1014
scramble through service-module t1 lbo
service-module ism default-boot
service-module ism default-boot
To configure the internal service module (ISM) to use the default BIOS and bootloader, use the
service-moduleismdefault-boot command in privileged EXEC mode.
service-module ism slot/port default-boot
Syntax Description slot Router slot in which the service module is installed. For internal service modules, always use 0.
/ port Port number of the module interface. Always use 0. The slash mark (/) is required.
Command Default The default BIOS and bootloader are not used by the ISM.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines After a downtime event or failed upgrade, use this command to configure the service module to use the primary
BIOS and primary bootloader to perform startup routines.
Examples The following is sample output for an ISM:
Router# service-module ism 0/0 default-boot
clear Clear Default Boot
set Set Default Boot
Router# service-module ism 0/0 default-boot clear
Router# service-module ism 0/0 default-boot set
Cisco IOS Interface and Hardware Component Command Reference
1015
scramble through service-module t1 lbo
service-module ism heartbeat-reset
service-module ism heartbeat-reset
To prevent Cisco IOS software from rebooting the internal service module (ISM) when the heartbeat is lost,
use the service-moduleismheartbeat-reset command in privileged EXEC mode.
service-module ism slot/port heartbeat-reset {disable|enable}
Syntax Description slot Number of the router slot in which the service module is installed. For internal service modules,
always use 0.
/ port Port number of the module interface. Always use 0. The slash mark (/) is required.
disable Disables reset of the ISM if the heartbeat is lost.
enable Enables reset of the ISM if the heartbeat is lost.
Command Default ISM is reset when heartbeat is lost.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines When the ISM is booted in fail-safe mode or is undergoing an upgrade, this command prevents a reboot during
the process.
When the ISM heartbeat is lost, the router applies a fail-open or fail-close configuration option to the module,
stops sending traffic to the module, and sets the module to error state. The router performs a hardware reset
on the ISM and monitors it until the heartbeat is reestablished.
Examples The following example shows how to disable the ISM from being reset if the heartbeat is lost:
Router# service-module ism 0/0 heartbeat-reset disable
You can display the status of the heartbeat reset feature with the service-moduleismstatuscommand:
Router# service-module ism 0/0 status
Service Module is Cisco IDS-Sensor 0/0
Service Module supports session via TTY line 194
Service Module heartbeat-reset is enabled <=====
Related Commands Command Description
interface ism Configures an interface for an ISM and enters interface configuration
mode.
service-module ism reload Performs a graceful shutdown and reboot of the ISM.
Cisco IOS Interface and Hardware Component Command Reference
1016
scramble through service-module t1 lbo
service-module ism heartbeat-reset
Command Description
service-module ism reset Resets the ISM hardware.
service-module ism shutdown Performs a graceful shutdown of the ISM.
service-module ism status Displays configuration information related to the hardware and software
on an ISM.
Cisco IOS Interface and Hardware Component Command Reference
1017
scramble through service-module t1 lbo
service-module ism install
service-module ism install
To use Cisco SRE to install an application on a internal service module (Cisco ISM-SRE), use the
service-moduleisminstallcommand in privileged EXEC configuration mode.
service-module ism slot/port install url url [script filename] [argument "string"] [force]
Syntax Description slot/port Location of the services engine module in the router. For internal service modules, the slot
and port number must be 0.
url url Address of FTP or HTTP server, as defined in RFC 2396, on which application packages and
Tcl scripts are located.
script (Optional) Changes name of Tcl script to be run from default value to script specified by
filename argument.
filename Name of Tcl script.
argument (Optional) Installer will not present options for the variable specified in the string argument.
“ string ” Alphanumeric characters of variable to be passed directly to the Tcl script via the command
line. Variable must be enclosed in quotation marks (“ ”)
force (Optional) Tcl script automatically proceeds with install without prompting for user input.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines This command uses a common module-dependent bootloader to install a Linux-based application, such as
Cisco Unity Express or Cisco AXP, on an internal service module (Cisco ISM-SRE).
The slash mark (/) is required between the slot argument and the port argument.
You can only issue one instance of this command at a time on a router. You cannot use this command to install
an application on two or more services engine modules in the same router at a time.
The Tcl script to be run must reside in the same FTP or HTTP server and directory as the application packages
to be installed. If a credential is required, the user name and password must be imbedded in the url as shown
in the following example:
Router# service-module ism 0/0 install url ftp://username:[email protected]/axp
If two or more of the optional keyword/argument combinations are used with this command, they must be
issued in the order presented in the command syntax. For example, you cannot use the force keyword before
the script orargument keywords, nor the argument keyword before the script keyword, when you issue this
command.
Use the scriptfilename keyword/argument combination with this command to specify that the Cisco IOS
software use some Tcl script other than the default installer during the installation.
Cisco IOS Interface and Hardware Component Command Reference
1018
scramble through service-module t1 lbo
service-module ism install
Use the argument“string” keyword/argument combination with this command to manually provide variables
during installation process and bypass the user interaction feature of the installer. The variable must include
the left and right quotation marks (“ ”).
Use the force keyword with this command to install an application without prompting for user input. If you
use this keyword and if the application requires you to provide certain variables during the installation, you
should also use the argument“string” keyword/argument combination to manually provide the required
variables because the force keyword will direct the installer to bypass all user interaction during the installation.
To stop the install while the Tcl script is being downloaded, use the service-moduleisminstallabortcommand.
This command cannot be used once the actual installation begins.
Examples The following example shows how to use this command to run the “help.sre” Tcl script rather than
the default installation Tcl script:
Router# service-module ism 0/0 install url ftp://server.com/cue script help.sre
Router#
The following example shows how to direct the installer to use the specified language variable for
US English instead of prompting you with language options for Cisco Unity Express:
Router# service-module ism 0/0 install url ftp://server.com/cue argument “lang=en_us”
Router#
The following example shows the messages displayed on the module console during a successful
installation using Cisco SRE:
Feb 6 19:09:22.526 EDT: %SM_INSTALL-6-INST_PROG: Service-Module-ISM 0/0 PROGRESSING:
Validating package signature ...1 .
Feb 6 19:09:23.058 EDT: %SM_INSTALL-6-INST_PROG: Service-Module-ISM 0/0 PROGRESSING: Parsing
package manifest files ...1 .
Feb 6 19:09:44.742 EDT: %SM_INSTALL-6-INST_PROG: Service-Module-ISM 0/0 PROGRESSING:
Starting payload download1 .
Feb 6 19:09:52.022 EDT: %SM_INSTALL-6-INST_PROG: Service-Module-ISM 0/0 PROGRESSING:
Performing Hot install ...1 .
Install successful on Service-Module-ISM 0/0 Feb 6 19:10:28.826 EDT: %SM_INSTALL-6-INST_SUCC:
Service-Module-ISM 0/0 SUCCESS: install-completed .
Related Commands Command Description
service-module ism install abort Stops the install process and returns to the boot-loader prompt.
service-module ism uninstall Uses Cisco SRE to uninstall an SRE-supported application on an
SRE-enabled services engine module.
Cisco IOS Interface and Hardware Component Command Reference
1019
scramble through service-module t1 lbo
service-module ism install abort
service-module ism install abort
To abort the Cisco SRE install process on a Cisco ISM-SRE, use the service-moduleisminstallabortcommand
in privileged EXEC configuration mode.
service-module ism slot/port install abort [force]
Syntax Description slot/port Location of the services engine module in the router. For internal service modules, the slot and port
number must be 0.
force (Optional) Tcl script automatically stops the installation without prompting for confirmation.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines This command stops the installation during the downloading portion of the process only. You cannot use this
command to stop the process once the actual installation has begun.
Use the force keyword with this command to stop the process without first prompting for confirmation.
Examples The following example shows how to use this command to stop an application installation without
first prompting for confirmation:
Router# service-module ism 0/0 install abort force
.
.
.
boot-loader>
Related Commands Command Description
service-module ism install Uses Cisco SRE to install an SRE-supported application on an SRE-enabled
services engine module.
Cisco IOS Interface and Hardware Component Command Reference
1020
scramble through service-module t1 lbo
service-module ism reload
service-module ism reload
To perform a graceful shutdown and reboot of the internal service module (ISM) operating system, use the
service-moduleismreload command in privileged EXEC mode.
service-module ism slot/port reload
Syntax Description slot Router slot in which the service module is installed. For internal service modules, always use 0.
/ port Port number of the module interface. Always use 0. The slash mark (/) is required.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced for ISMs.
Usage Guidelines At the confirmation prompt, press Enter to confirm the action or n to cancel.
Examples The following example shows how to gracefully shut down and reboot the ISM operating system:
Router# service-module ism 0/0 reload
Do you want to proceed with reload?[confirm]
Related Commands Command Description
interface ism Configures an interface for an ISM and enters interface configuration
mode.
service-module ism reset Resets the ISM hardware.
service-module ism shutdown Gracefully shuts down the ISM.
show diag Displays controller information for ISMs.
show interfaces ism Displays basic interface configuration information for ISMs.
Cisco IOS Interface and Hardware Component Command Reference
1021
scramble through service-module t1 lbo
service-module ism reset
service-module ism reset
To reset the internal service module (ISM) hardware, use the service-moduleismreset command in privileged
EXEC mode.
service-module ism slot/port reset
Syntax Description slot Router slot in which the service module is installed. For internal service modules, always use 0.
/ port Port number of the module interface. Always use 0. The slash mark (/) is required.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced for ISMs.
Usage Guidelines At the confirmation prompt, press Enter to confirm the action or n to cancel.
Caution Because you may lose data, use the service-moduleismreset command only to recover from a shutdown or
failed state.
Examples The following example shows how to reset the ISM hardware:
Router# service-module ism 0/0 reset
Use reset only to recover from shutdown or failed state
Warning: May lose data on the the NVRAM, nonvolatile file system or unsaved configuration!
Do you want to reset?[confirm]
Related Commands Command Description
interface ism Configures an interface for an ISM and enters interface configuration
mode.
service-module ism reload Performs a graceful shutdown and reboot of the ISM operating system.
service-module ism shutdown Gracefully shuts down the ISM.
show diag Displays controller information for ISMs.
show interfaces ism Displays basic interface configuration information for ISMs.
Cisco IOS Interface and Hardware Component Command Reference
1022
scramble through service-module t1 lbo
service-module ism session
service-module ism session
To begin a configuration session for an internal service module (ISM) through a console connection, use the
service-moduleismsession command in privileged EXEC mode.
service-module ism slot/port session [clear]
Syntax Description slot Router slot in which the service module is installed. For internal service modules, always use 0.
/ port Port number of the module interface. Always use 0. The slash mark (/) is required.
clear (Optional) Clears the ISM configuration session.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines Only one session at a time is allowed into the service module from the ISM interface.
After starting a session, you can perform any ISM configuration task. You first access the ISM console in a
user-level shell. To access the privileged EXEC command shell, where most commands are available, use the
enable command.
After you finish configuration tasks and exit the ISM console session, use this command with the clear
keyword to clear the session. At the confirmation prompt, press Enter to confirm the action or n to cancel.
Examples The following example shows a session being opened for an ISM:
Router# service-module ism 0/0 session
Trying 10.10.10.1, 2129 ... Open
ISE-netmodule con now available
Press RETURN to get started!
ISE-netmodule> enable
ISE-netmodule#
The following example clears the session that had been used to configure the ISM in slot 0:
Router# service-module ism 0/0 session clear
[confirm]
[OK]
Related Commands Command Description
enable Enters privileged EXEC mode.
Cisco IOS Interface and Hardware Component Command Reference
1023
scramble through service-module t1 lbo
service-module ism session
Command Description
interface Configures an interface and enters interface configuration mode.
show diag Displays controller information for a service module.
show interface ism Displays basic interface configuration information for service modules.
Cisco IOS Interface and Hardware Component Command Reference
1024
scramble through service-module t1 lbo
service-module ism shutdown
service-module ism shutdown
To gracefully shut down an internal service module (ISM), use the service-moduleismshutdown command
in privileged EXEC mode.
service-module ism slot/port shutdown
Syntax Description slot Router slot in which the service module is installed. For internal service modules, always use 0.
/ port Port number of the module interface. Always use 0. The slash mark (/) is required.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines At the confirmation prompt, press Enter to confirm the action or n to cancel.
This command brings down the operating system of the specified ISM in an orderly fashion to protect the
hard drive. When the system has been shut down, the module can be removed from the router.
Examples The following example shows how to gracefully shut down the ISM:
Router# service-module ism 0/0 shutdown
Do you want to proceed with shutdown?[confirm]
Use service module reset command to recover from shutdown.
WARNING: Confirm that the service-module status shows 'is Shutdown' before removing the
module or powering off the system !
Related Commands Command Description
interface ism Configures an interface for an ISM and enters interface configuration mode.
service-module ism reload Performs a graceful shut down and reboot of the ISM operating system.
service-module ism reset Resets the hardware on the ISM.
show diag Displays controller information for ISMs.
show interfaces ism Displays basic interface configuration information for ISMs.
Cisco IOS Interface and Hardware Component Command Reference
1025
scramble through service-module t1 lbo
service-module ism statistics
service-module ism statistics
To display reset and reload information for an internal service module (ISM) and its Cisco IOS software, use
the service-moduleismstatisticscommand in EXEC mode.
service-module ism slot/port statistics
Syntax Description slot Router slot in which the service module is installed. For internal service modules, always use 0.
/ port Port number of the module interface. Always use 0. The slash mark (/) is required.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Examples The following example displays information for an ISM:
Router# service-module ism 0/0 statistics
Module Reset Statistics:
CLI reset count = 0
CLI reload count = 0
Registration request timeout reset count = 0
Error recovery timeout reset count = 0
Module registration count = 1
Related Commands Command Description
interface ism Configures an interface for an ISM and enters interface configuration
mode.
service-module ism reload Performs a graceful shutdown and reboot of the ISM operating system.
service-module ism reset Resets the ISM hardware.
service-module ism shutdown Gracefully shuts down the ISM.
show interfaces ism Displays basic interface configuration information for ISMs.
Cisco IOS Interface and Hardware Component Command Reference
1026
scramble through service-module t1 lbo
service-module ism status
service-module ism status
To display configuration information related to the hardware and software on an internal service module
(ISM), use the service-moduleismstatuscommand in privileged EXEC mode.
service-module ism slot/port status
Syntax Description slot Router slot in which the service module is installed. For internal service modules, always use 0.
/ port Port number of the module interface. Always use 0. The slash mark (/) is required.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines Use this command to:
• Display the ISMs software release version
• Check the ISM status (steady or down)
• Display hardware information for the ISM, including CPU, memory, and interface information
Examples The following example displays information for an ISM:
Router# service-module ism 0/0 status
Service Module is Cisco ISM0/0
Service Module supports session via TTY line 323
Service Module is in Steady state
Service Module heartbeat-reset is enabled
Getting status from the Service Module, please wait..
Cisco Foundation Software 1.0
FNDN Running on ISM
No install/uninstall in progress
Related Commands Command Description
interface ism Configures an interface for an ISM and enters interface configuration mode.
show diag Displays controller information for service modules.
show interfaces ism Displays basic interface configuration information for ISMs.
Cisco IOS Interface and Hardware Component Command Reference
1027
scramble through service-module t1 lbo
service-module ism uninstall
service-module ism uninstall
To use Cisco SRE to uninstall an application on an internal service module (Cisco ISM-SRE), use the
service-moduleismuninstallcommand in privileged EXEC configuration mode.
service-module ism slot/port uninstall [force]
Syntax Description slot / port Location of the services engine module in the router. For internal service modules, the slot
and port number must be 0.
force (Optional) Tcl script automatically proceeds with uninstall without prompting for confirmation.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines This command completely erases the disk or compact flash on the SRE-enabled services engine module and
removes the application keys. It does not remove application licenses.
The slash mark (/) is required between the slot argument and the portargument.
You can only issue one instance of this command at a time on a router. You cannot use this command to
uninstall an application on two or more services engine modules in the same router at a time.
Use the force keyword with this command to uninstall an application without first prompting for confirmation.
Examples The following example shows how to use this command to uninstall an application without first
prompting for confirmation:
Router# service-module ism 0/0 uninstall force
Router#
Related Commands Command Description
service-module ism install Uses Cisco SRE to install an SRE-supported application on an SRE-enabled
services engine module.
Cisco IOS Interface and Hardware Component Command Reference
1028
scramble through service-module t1 lbo
service-module mgf ip address
service-module mgf ip address
To place the service module (Cisco SM-SRE or Cisco ISM-SRE) on a subnet, use the
service-modulemgfipaddresscommand in interface configuration mode.
service-module mgf ip address ip-address subnet-mask [vlan vlan-id]
Syntax Description ip-address IP address of the module’s MGF interface.
subnet-mask Subnet mask to append to the IP address.
vlan vlan-id (Optional) Number of the VLAN to be assigned. The valid range is from 2 to 4094.
Command Default Service module is not placed on a subnet.
Command Modes Interface configuration (config-if)
Command History Release Modification
15.1(3)T This command was introduced.
Usage Guidelines Use this command without the vlanvlan-idargument to configure the IP address on the module side for the
default VLAN (VLAN 1). Use this command with the vlanvlan-idargument to configure the IP address on
the module side for VLANs other than VLAN 1.
Examples The following example assigns IP addresses to the default VLAN of the port and VLAN 20:
Router(config)# interface sm 1/0
Router(config-if)# service-module mgf ip address 192.0.2.0
Router(config-if)# service-module mgf ip address 192.0.2.1 vlan 20
Cisco IOS Interface and Hardware Component Command Reference
1029
scramble through service-module t1 lbo
service-module mgf ip default-gateway
service-module mgf ip default-gateway
To define a default gateway (router) for a service module (Cisco SRE SM or Cisco SRE ISM), use the
service-modulemgfipdefault-gatewaycommand in interface configuration mode.
service-module mgf ip default-gateway gateway-ip-address [vlan vlan-id]
Syntax Description gateway-ip-address IP address of the module’s default gateway.
vlan vlan-id (Optional) Number of the VLAN to be assigned. The valid range is from 2 to 4094.
Command Default Default gateway is not defined for a service module.
Command Modes Interface configuration (config-if)
Command History Release Modification
15.1(3)T This command was introduced.
Usage Guidelines Use this command without the vlanvlan-idargument to configure the default gateway on the module side for
the default VLAN (VLAN 1). Use this command with the vlanvlan-idargument to configure the default
gateway on the module side for VLANs other than VLAN 1.
Examples The following example assigns 192.0.2.0 as the default gateway for VLAN 1:
Router(config)# interface sm 2/0
Router(config-if)# service-module mgf ip default-gateway 192.0.2.0
Cisco IOS Interface and Hardware Component Command Reference
1030
scramble through service-module t1 lbo
service-module mgf ipv6 address
service-module mgf ipv6 address
To place the service module (Cisco SM-SRE or Cisco ISM-SRE) on a subnet, use the
service-modulemgfipv6addresscommand in interface configuration mode.
service-module mgf ipv6 address ipv6-address [vlan vlan-id]
Syntax Description ipv6-address IPv6 address of the module’s MGF interface.
vlan-id (Optional) Number of the VLAN to be assigned. The valid range is from 2 to 4094.
Command Default IPv6 address is not configured on the service module.
Command Modes Interface configuration (config-if)
Command History Release Modification
15.1(3)T This command was introduced.
Usage Guidelines Use this command without the vlanvlan-idargument to configure the IPv6 address on the module side for the
default VLAN (VLAN 1). Use this command with the vlanvlan-idargument to configure the IPv6 address on
the module side for VLANs other than VLAN 1.
Examples The following example assigns IPv6 addresses to the default VLAN of the port and VLAN 20:
Router(config)# interface sm 2/0
Router(config-if)# service-module mgf ipv6 address 2001:0DB8::/48
Router(config-if)# service-module mgf ipv6 address 2001:0DB8::/48 vlan 20
Cisco IOS Interface and Hardware Component Command Reference
1031
scramble through service-module t1 lbo
service-module routing redistribute
service-module routing redistribute
To enable the router to send its routing database to the satellite network central hub, use the
service-moduleroutingredistribute command in satellite interface configuration mode. To prevent the router
from sending its routing database over the satellite network, use the no form of this command.
service-module routing redistribute
no service-module routing redistribute
Syntax Description This command has no arguments or keywords.
Command Default The router is enabled to send its routing database to the hub.
Command Modes Satellite interface configuration
Command History Release Modification
12.3(14)T This command was introduced.
Usage Guidelines The service-moduleroutingredistribute command is used on a VSAT router, that is, an earthbound modular
access router equipped with a Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT) that
connects to a satellite network. When VSAT route updates are enabled, the NM-1VSAT-GILAT network
module uses Router Blade Configuration Protocol (RBCP) messages to communicate VSAT routing table
changes to the hub.
Entering the noservice-moduleroutingredistribute command is useful when you do not want the hub to be
aware of all the routes known by the VSAT router, such as when Network Address Translation (NAT) is
configured on the router.
The hub must learn the remote VSAT routing database for the satellite network to function properly. Therefore,
if you enter the noservice-moduleroutingredistribute command, then one of the following actions is required:
• You use RIPv2 as the only routing protocol on your VSAT router. The hub can understand and track
RIPv2 route updates.
• On the hub router, configure static routes to the VSAT router networks.
Examples The following example shows how to prevent the VSAT router from sending its routing database to
the satellite network central hub:
Router(config-if)# no service-module routing redistribute
Cisco IOS Interface and Hardware Component Command Reference
1032
scramble through service-module t1 lbo
service-module satellite backup
service-module satellite backup
To test the hub dial backup connection for the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT), use the service-modulesatellitebackup command in privileged EXEC mode.
service module satellite slot/unit backup {initiate|terminate}
Syntax Description slot Router chassis slot in which the network module is installed.
unit Interface number. For NM-1VSAT-GILAT network modules, always use 0.
initiate Initiates a hub dial backup connection.
terminate Terminates a hub dial backup connection.
Command Default No default behavior or values.
Command Modes Privileged EXEC
Command History Release Modification
12.3(14)T This command was introduced.
Usage Guidelines The service-modulesatellitebackup command is used only when you configure hub dial backup for the Cisco
IP VSAT satellite WAN network module (NM-1VSAT-GILAT).
Normally, the hub dial backup connection comes up only when the satellite link goes down (for example,
because of a rain-fade event). The service-modulesatellitebackup command allows you to artificially bring
down the satellite link to test the hub dial backup connection.
Examples The following example shows how to initiate a satellite backup test:
Router# service-module satellite 1/0 backup initiate
The following example shows how to terminate a running satellite backup test:
Router# service-module satellite 1/0 backup terminate
Related Commands Command Description
service-module backup interface Specifies the interface to use to back up the satellite interface on the
Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT).
service-module backup mode Sets the terrestrial backup mode for the Cisco IP VSAT satellite WAN
network module (NM-1VSAT-GILAT).
Cisco IOS Interface and Hardware Component Command Reference
1033
scramble through service-module t1 lbo
service-module satellite configuration
service-module satellite configuration
To enter satellite initial configuration mode, use the service-modulesatelliteconfigurationcommand in user
EXEC or privileged EXEC mode.
service-module satellite slot/unit configuration
Syntax Description slot Router chassis slot in which the network module is installed.
unit Interface number. For NM-1VSAT-GILAT network modules, always use 0.
Command Default No default behavior or values.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.3(14)T This command was introduced.
Usage Guidelines You need a password from your satellite service provider to enter satellite initial configuration mode.
The parameters that you configure in satellite initial configuration mode are saved directly to the network
module and do not appear in the router configuration, even though you configure the parameters through the
Cisco IOS CLI.
To view the parameter values that were configured in satellite initial configuration mode, use one of the
following commands:
• show command in satellite initial configuration mode
• service-module satellite slot /0 status command in privileged EXEC mode
Note This command is typically used by an installation technician. Do not use this command unless your satellite
service provider instructs you to perform the satellite initial configuration and provides all necessary parameter
values.
Examples The following example shows how to enter satellite initial configuration mode:
Router> service-module satellite 1/0 configuration
Password: <mypassword>
Reminder:changing any parameters will result in a software reset of the module.
Router(sat-init-config)>
Cisco IOS Interface and Hardware Component Command Reference
1034
scramble through service-module t1 lbo
service-module satellite configuration
Related Commands Command Description
end (satellite initial Exits satellite initial configuration mode, saves any new or changed
configuration) parameters, and resets the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT).
exit (satellite initial Exits satellite initial configuration mode, saves any new or changed
configuration) parameters, and resets the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT).
service-module satellite status Displays status information related to the hardware and software on the
Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT),
including the initial configuration parameters.
show (satellite initial Displays the initial configuration parameters for the Cisco IP VSAT
configuration) satellite WAN network module (NM-1VSAT-GILAT).
Cisco IOS Interface and Hardware Component Command Reference
1035
scramble through service-module t1 lbo
service-module satellite cw-mode
service-module satellite cw-mode
To enable or disable continuous wave mode, use the service-modulesatellitecw-mode command in satellite
interface configuration mode.
service-module satellite slot/unit cw-mode {off|on frequency frequency [time time]}
Syntax Description slot Router chassis slot in which the network module is installed.
unit Interface number. For NM-1VSAT-GILAT network modules, always use 0.
off Disables continuous wave mode.
on Enables continuous wave mode.
frequency frequency Frequency, in kilohertz, in the range from 900000 to 1650000.
time time Length of time, in seconds, that continuous wave mode is enabled. The time
argument is a number in the range from 60 to 1800.
Command Default Continuous wave mode is disabled.
If the time is not specified, continuous wave mode continues until turned off.
Command Modes Privileged EXEC
Command History Release Modification
12.3(14)T This command was introduced.
12.4(2)T A password challenge was added to the command-line interface when continuous wave mode is
enabled.
Usage Guidelines Continuous wave mode can be enabled only when the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT) is in boot mode.
When continuous wave mode is enabled, the NM-1VSAT-GILAT network module transmits unmodulated
carrier waves that can be used for dish antenna orientation adjustments and for signal quality measurements.
Note This command is typically used by an installation technician. Do not use this command unless your satellite
service provider instructs you to do so.
Note You need a password from your satellite service provider to enable continuous wave mode.
Cisco IOS Interface and Hardware Component Command Reference
1036
scramble through service-module t1 lbo
service-module satellite cw-mode
Examples The following example shows how to enable continuous wave mode for 2 minutes, at 900000
kilohertz:
Router# service-module satellite 1/0 cw-mode on frequency 900000 time 120
Password: <mypassword>
CW mode obtained.
The following example shows how to disable continuous wave mode:
Router# service-module satellite 1/0 cw-mode off
CW mode released.
The following example shows the message that appears when you try to enable continuous wave
mode while the NM-1VSAT-GILAT network module is not in boot mode:
Router# service-module satellite 1/0 cw-mode on frequency 900000 time 120
Password <mypassword>
% CW mode NOT obtained! Valid during boot mode only.
Cisco IOS Interface and Hardware Component Command Reference
1037
scramble through service-module t1 lbo
service-module satellite status
service-module satellite status
To display status information related to the hardware and software on the Cisco IP VSAT satellite WAN
network module (NM-1VSAT-GILAT), including the initial configuration parameters, use
theservice-modulesatellitestatus command in privileged EXEC mode.
service-module satellite slot/unit status [log]
Syntax Description slot Router chassis slot in which the network module is installed.
unit Interface number. For NM-1VSAT-GILAT network modules, always use 0.
log Extends the output to include the last ring of messages from the firmware and the last crash dump
available from the NM-1VSAT-GILAT network module.
Command Default No default behavior or values.
Command Modes Privileged EXEC
Command History Release Modification
12.3(14)T This command was introduced.
Usage Guidelines Use the service-modulesatellitestatus command to troubleshoot the Cisco IP VSAT satellite WAN network
module (NM-1VSAT-GILAT).
Examples See the table below for service-modulesatellitestatus command output field descriptions.
This section provides the following examples:
Normal Operation Example
The following example shows that the link to the hub (backbone status) is up, as is expected in normal
working conditions:
Router# service-module satellite 2/0 status
Getting status from the satellite module, please wait..
Software Versions, OS:14.2.2, RSP:1.5.1.3, MBC:1.0.0.5
HW Version:00008100
CPA Number:6204, HPS CPA:1, HSP Link:2
AA Group: 258, SW Group: 512, Download: YES
Service Module Uptime:00:06:40, Router Uptime:1 day, 20 hours, 26 minutes
Current router clocktime:*03:11:22.641 UTC Tue Dec 2 2003
Oper Mode:OPERATIONAL
, In Dial Backup:NO, Standby:NO, One-Way:NO
RBCP Received Packets:44, RBCP Sent Packets:41
Bit Error Rate:0e-0, Signal to Noise Ratio:12.4453
IP Address/Mask:10.22.1.1/255.255.255.252
Service Module MAC:00:A0:AC:00:20:60
RX Lock:LOCKED, Sync Lock:LOCKED
Cisco IOS Interface and Hardware Component Command Reference
1038
scramble through service-module t1 lbo
service-module satellite status
BackBone Status:UP
, Two-Way Mode:YES, DA/RA Mode:RA
Outbound Modulation Type:DVB, OB Code Rate:3/4
Outbound Unicast Packets:61, OB Multicast Packets:23547
Outbound ID:2, OB PID:514, OB Freq:1201000, OB Bit Rate:30000000
Outbound Sync IP address: 172.22.0.3
Inbound Start Freq:1201176, IB Stop Freq:1209336
Inbound Data Rate:307200, IB Freq Offset:0
Inbound Packets:3553
BackBone Hub Link Status:UP
BackBone Received Packets:1, BB Sent:3552
BackBone Received Retransmitted:0, BB Sent Retrans:0
Service Module Eth RX:3550, TX:47110
Service Module Eth Multicast RX:1, Multicast TX:23563
Bufs Configured:5000, Bufs Free:4951
Internal Software State parameters:
Service Module SW State Var:3
General IOS FSM:LINK_UP, HSRP FSM:ACTIVE, HSRP VSAT Mode:ACTIVE
Lost Beats Total:0, Lost Beats This Retry:0
VOIP DA calls:
NONE
Boot Mode Example
The following example shows that the NM-1VSAT-GILAT network module is in boot mode after
a software reset, so that the link to the hub (backbone status) is down:
Router# service-module satellite 1/0 status
Getting status from the satellite module, please wait..
Software Versions, OS:0.0.0, RSP:1.0.0.5, MBC:0.0.0.0
HW Version:001D1757
CPA Number:6204, HPS CPA:0, HSP Link:2
AA Group: 258, SW Group: 512, Download: YES
Service Module Uptime:00:00:14, Router Uptime:1 day, 20 hours, 19 minutes
Current router clocktime:*03:04:38.017 UTC Tue Dec 2 2003
Oper Mode:BOOT
, In Dial Backup:NO, Standby:NO, One-Way:NO
RBCP Received Packets:1, RBCP Sent Packets:8
Bit Error Rate:0e-0, Signal to Noise Ratio:12.4453
IP Address/Mask:172.27.1.54/255.255.255.252
Service Module MAC:00:A0:AC:00:20:60
RX Lock:LOCKED, Sync Lock:NOT LOCKED
BackBone Status:DOWN
, Two-Way Mode:YES, DA/RA Mode:RA
Outbound Modulation Type:DVB, OB Code Rate:3/4
Outbound Unicast Packets:0, OB Multicast Packets:0
Outbound ID:2, OB PID:514, OB Freq:1201000, OB Bit Rate:30000000
Outbound Sync IP address: 172.22.0.3
Inbound Start Freq:1201176, IB Stop Freq:1209336
Inbound Data Rate:307200, IB Freq Offset:0
COUNTERS OMITTED. Not available at this time.
Internal Software State parameters:
Service Module SW State Var:3
General IOS FSM:LINK_DOWN, HSRP FSM:ACTIVE, HSRP VSAT Mode:ACTIVE
Lost Beats Total:0, Lost Beats This Retry:0
VOIP DA calls:
NONE
Cisco IOS Interface and Hardware Component Command Reference
1039
scramble through service-module t1 lbo
service-module satellite status
Software Reset Example
The following example shows what appears during the beginning stages of a software reset:
Router# service-module satellite 2/0 status
Getting status from the satellite module, please wait..
% Satellite2/0 card is busy. Status is not available. Try later.
Hub Dial Backup Example
The following example shows that the hub dial backup link is being used instead of the satellite link.
Note, however, that hub dial backup keeps the backbone status up. In hub dial backup mode, the
NM-1VSAT-GILAT network module connects to the hub over a specified dial backup link and
maintains TCP connections.
Router# service-module satellite 1/0 status
Getting status from the satellite module, please wait..
Software Versions, OS:14.2.3, RSP:1.5.1.3, MBC:1.0.0.5
HW Version:00008100
CPA Number:3201, HPS CPA:1, HSP Link:2
AA Group: 258, SW Group: 512, Download: YES
Service Module Uptime:02:09:38, Router Uptime:2 hours, 10 minutes
Current router clocktime:*19:28:20.195 UTC Wed Apr 7 2004
Oper Mode:OPERATIONAL, In Dial Backup:YES
, Standby:NO, One-Way:NO
RBCP Received Packets:31511, RBCP Sent Packets:31358
Bit Error Rate:0e-0, Signal to Noise Ratio:12.4453
IP Address/Mask:10.0.0.100/255.255.255.0
Service Module MAC:00:A0:AC:00:20:66
RX Lock:LOCKED, Sync Lock:NOT LOCKED
BackBone Status:UP
, Two-Way Mode:YES, DA/RA Mode:RA
Outbound Modulation Type:DVB, OB Code Rate:3/4
Outbound Unicast Packets:39944, OB Multicast Packets:45612
Outbound ID:2, OB PID:514, OB Freq:1201000, OB Bit Rate:30000000
Outbound Sync IP address: 172.22.0.3
Inbound Start Freq:1201176, IB Stop Freq:1209336
Inbound Data Rate:307200, IB Freq Offset:0
Inbound Packets:8281
BackBone Hub Link Status:UP
BackBone Received Packets:37894, BB Sent:39162
BackBone Received Retransmitted:1, BB Sent Retrans:12
Service Module Eth RX:37840, TX:129000
Service Module Eth Multicast RX:202, Multicast TX:45970
Bufs Configured:5000, Bufs Free:4949
Internal Software State parameters:
Service Module SW State Var:3
General IOS FSM:LINK_UP, HSRP FSM:N/A, HSRP VSAT Mode:N/A
Lost Beats Total:0, Lost Beats This Retry:0
VoIP Example
The following example shows the status of VoIP calls. Note that dedicated access (DA) mode is in
use, and you can see the bandwidth (26 kilobits per second) being used on the DA channels.
Cisco IOS Interface and Hardware Component Command Reference
1040
scramble through service-module t1 lbo
service-module satellite status
Router# service-module satellite 1/0 status
Getting status from the satellite module, please wait..
Software Versions, OS:14.2.3, RSP:1.5.1.3, MBC:1.0.0.5
HW Version:00008100
CPA Number:6202, HPS CPA:1, HSP Link:2
AA Group: 258, SW Group: 512, Download: YES
Service Module Uptime:00:34:53, Router Uptime:2 days, 21 hours, 23 minutes
Current router clocktime:*08:33:51.301 UTC Mon Feb 16 2004
Oper Mode:OPERATIONAL, In Dial Backup:NO, Standby:NO, One-Way:NO
RBCP Received Packets:335, RBCP Sent Packets:332
Bit Error Rate:0e-0, Signal to Noise Ratio:12.4453
IP Address/Mask:10.2.0.2/255.255.0.0
Service Module MAC:00:A0:AC:00:20:67
RX Lock:LOCKED, Sync Lock:LOCKED
BackBone Status:UP, Two-Way Mode:YES, DA/RA Mode:DA
Outbound Modulation Type:DVB, OB Code Rate:3/4
Outbound Unicast Packets:758, OB Multicast Packets:139823
Outbound ID:2, OB PID:514, OB Freq:1201000, OB Bit Rate:30000000
Outbound Sync IP address: 172.22.0.3
Inbound Start Freq:1201176, IB Stop Freq:1209336
Inbound Data Rate:307200, IB Freq Offset:0
Inbound Packets:346
BackBone Hub Link Status:UP
BackBone Received Packets:335, BB Sent:288
BackBone Received Retransmitted:0, BB Sent Retrans:0
Service Module Eth RX:356, TX:280163
Service Module Eth Multicast RX:1, Multicast TX:139918
Bufs Configured:5000, Bufs Free:4951
Internal Software State parameters:
Service Module SW State Var:3
General IOS FSM:LINK_UP, HSRP FSM:N/A, HSRP VSAT Mode:N/A
Lost Beats Total:0, Lost Beats This Retry:0
VOIP DA calls:
Call ID BW (kb)
Dst Port Src Port Dest Addr
======== ======= ======== ======== ==============
16075 26
18310 16866 162.0.0.2
Firmware Debug Log Example
The following example includes the firmware debug message log:
Router# service-module satellite 1/0 status log
Getting status from the satellite module, please wait..
Software Versions, OS:14.2.3, RSP:1.5.1.3, MBC:1.0.0.5
HW Version:00008100
CPA Number:1203, HPS CPA:1, HSP Link:2
AA Group: 258, SW Group: 512, Download: YES
Service Module Uptime:19:01:32, Router Uptime:1 week, 4 days, 16 hours,
15 minutes
Current router clocktime:*15:12:45.310 UTC Mon May 13 2002
Oper Mode:OPERATIONAL, In Dial Backup:NO, Standby:NO, One-Way:NO
RBCP Received Packets:9279, RBCP Sent Packets:9276
Bit Error Rate:0e-0, Signal to Noise Ratio:12.4453
IP Address/Mask:14.0.0.6/255.255.255.0
Cisco IOS Interface and Hardware Component Command Reference
1041
scramble through service-module t1 lbo
service-module satellite status
Service Module MAC:00:A0:AC:00:20:72
RX Lock:LOCKED, Sync Lock:LOCKED
BackBone Status:UP, Two-Way Mode:YES, DA/RA Mode:RA
Outbound Modulation Type:DVB, OB Code Rate:3/4
Outbound Unicast Packets:11099797, OB Multicast Packets:429401
Outbound ID:2, OB PID:514, OB Freq:1201000, OB Bit Rate:30000000
Outbound Sync IP address: 172.22.0.3
Inbound Start Freq:1201176, IB Stop Freq:1209336
Inbound Data Rate:307200, IB Freq Offset:0
Inbound Packets:674619
BackBone Hub Link Status:UP
BackBone Received Packets:11084921, BB Sent:93899
BackBone Received Retransmitted:352, BB Sent Retrans:2
Service Module Eth RX:10001424, TX:18532485
Service Module Eth Multicast RX:2615, Multicast TX:431486
Bufs Configured:5000, Bufs Free:1240
Internal Software State parameters:
Service Module SW State Var:3
General IOS FSM:LINK_UP, HSRP FSM:N/A, HSRP VSAT Mode:N/A
Lost Beats Total:4, Lost Beats This Retry:0
VOIP DA calls:
NONE
Last forced reset log from card
===============================
bb 01 e3 a3 28 00 00 10 00 01 ff 6f f0 00 00 10
00 00 2a aa 00 4f f9 5f c4 00 00 01 2a ff ff ff
ff 00 00 80 00 01 ff 6f f0 00 00 00 00 01 ff 76
b0 01 e3 a3 28 00 00 90 02 00 00 00 00 00 00 00
13 00 18 84 1c 00 00 00 00 01 e3 a3 28 00 2b 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 2b 00 00 01 ff 76 b0 00 2a a2 80 00 00 88
88 00 00 90 02 00 0a 7f 58 00 00 00 00 00 00 00
00 40 00 00 43 20 00 00 00 00 00 00 00 01 ff 76
b0 00 00 00 00 01 ff 70 20 ff ff ff
The table below describes the significant fields shown in the displays.
Table 28: service-module satellite status Field Descriptions
Field Description
Software Versions HW Version Software (not Cisco IOS) and hardware versions on the NM-1VSAT-GILAT
network module. Useful for technical support.
CPA Number HPS CPA HSP VSAT-to-hub link parameters.
Link AA Group SW Group
Download
Oper Mode Operational mode; one of the following values:
• OPERATIONAL--Boot complete and running operational code.
• BOOT HOLD--Held in boot mode.
• BOOT--In boot mode after a reset.
• IDLE--Transitional state.
• UNKNOWN--Indicates an error.
Cisco IOS Interface and Hardware Component Command Reference
1042
scramble through service-module t1 lbo
service-module satellite status
Field Description
In Dial Backup YES indicates that the satellite link is down and that the hub dial backup
connection is in use.
NO means that the hub dial backup connection is not in use or not configured.
Note This field does not indicate whether router dial backup mode is
in use.
Standby YES indicates that the router in which the NM-1VSAT-GILAT network
module is installed is in standby mode for Hot Standby Router Protocol
(HSRP).
NO indicates that the router in which the NM-1VSAT-GILAT network
module is installed is either in active mode for HSRP, or HSRP is not
configured.
One-Way YES indicates one-way operational mode.
NO indicates two-way operational mode.
RBCP Received Packets RBCP Number of sent and received Router Blade Configuration Protocol (RBCP)
Sent Packets packets.
IP Address/Mask IP address and subnet mask of the NM-1VSAT-GILAT network module.
RX Lock Sync Lock Corresponds to the following LEDs on the NM-1VSAT-GILAT network
module faceplate:
• RX LOCK--Indicates whether or not the DVB (outbound) receiver is
locked.
• SYNC--Indicates whether or not the NM-1VSAT-GILAT network
module is synchronized with the hub timing.
For both fields:
• LOCKED indicates that the initial connection to the hub was successful.
This means that the dish antenna is positioned correctly and the satellite
initial configuration parameters are valid.
• NOT LOCKED indicates that the NM-1VSAT-GILAT network module
is in a transitional state during the boot process. If NOT LOCKED does
not eventually become LOCKED, then the satellite initial configuration
parameters are incorrect, there is a hardware problem, or the satellite
signal has faded because of rain-fade or obstruction.
BackBone Status Backbone link to the hub, either fully established (UP) or not fully established
(DOWN).
Corresponds to the ON LINE LED on the NM-1VSAT-GILAT network
module faceplate.
Cisco IOS Interface and Hardware Component Command Reference
1043
scramble through service-module t1 lbo
service-module satellite status
Field Description
Two-Way Mode YES indicates two-way operational mode.
NO indicates one-way operational mode.
DA/RA Mode Indicates whether the satellite link is operating in random access (RA) or
dedicated access (DA) mode. DA mode is required for VoIP calls.
Outbound Modulation Type Satellite initial configuration parameters:
OB Code Rate • Outbound modulation type
Outbound ID • Outbound Viterbi code rate
OB PID • Outbound VSAT ID
OB Freq • Outbound packet identifier (PID)
OB Bit Rate
• Outbound frequency
Outbound Sync IP address
• Outbound data rate
• Outbound synchronization IP address
Internal Software State Internal states that are useful for technical support.
parameters
VOIP DA calls Information about VoIP calls, which use DA mode.
Note This field appears only on routers that run VoIP-enabled Cisco
IOS software images.
Last forced reset log from card Debug information used by technical support.
Related Commands Command Description
show (satellite initial Displays the initial configuration parameters for the Cisco IP VSAT
configuration) satellite WAN network module (NM-1VSAT-GILAT).
show controllers satellite Displays controller information about the internal router interface that
connects to an installed Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT).
show interfaces satellite Displays general interface settings and traffic rates for the internal router
interface that connects to an installed Cisco IP VSAT satellite WAN
network module (NM-1VSAT-GILAT).
Cisco IOS Interface and Hardware Component Command Reference
1044
scramble through service-module t1 lbo
service-module service-engine
service-module service-engine
To enter the Cisco Unity Express command environment using a network module (NM) or an advanced
Integration Module (AIM) card module, use the service-moduleservice-engine command in privileged EXEC
mode.
service-module service-engine slot/port session
Syntax Description slot Slot number of the NM or AIM.
port Port number of the NM or AIM.
Command Default No default behavior or values.
Command Modes Privileged EXEC
Command History Release Modification
12.2(15)ZJ This command was introduced for NMs.
12.3(4)T This command was integrated into Cisco IOS Release 12.3(4)T.
12.3(7)T Support was added for AIMs.
Usage Guidelines This command may only be used for NMs and AIMs running Cisco Unity Express. If your system does not
have this hardware, then you will be unable to enter this command.
The no form of this command (nointerfaceservice-engine) is not available. You can enter the exit command
to return to the router.
Examples The following example shows the command for enabling Cisco Unity Express command environment
using either a NM or AIM located in slot 4, port 0:
Router# service-module service-engine 4/0 session
Router# Trying 172.18.106.66, 2129 ... Open
Cisco IOS Interface and Hardware Component Command Reference
1045
scramble through service-module t1 lbo
service-module sm default-boot
service-module sm default-boot
To configure the SM-SRE service module to use the default BIOS and bootloader, use the
service-modulesmdefault-boot command in privileged EXEC mode.
service-module sm slot/port default-boot
Syntax Description slot Router slot in which the service module is installed. Range: 1 to 4.
/ port Port number of the module interface. Always use 0. The slash mark (/) is required.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines After a downtime event or failed upgrade, use this command to configure the service module to use the primary
BIOS and primary bootloader to perform startup routines.
Examples The following is sample output for a service module:
Router# service-module sm 1/0 default-boot
clear Clear Default Boot
set Set Default Boot
Router# service-module sm 1/0 default-boot clear
Router# service-module sm 1/0 default-boot set
Cisco IOS Interface and Hardware Component Command Reference
1046
scramble through service-module t1 lbo
service-module sm heartbeat-reset
service-module sm heartbeat-reset
To prevent Cisco IOS software from rebooting the SM-SRE service module when the heartbeat is lost, use
the service-modulesmheartbeat-reset command in privileged EXEC mode.
service-module sm slot/port heartbeat-reset {disable|enable}
Syntax Description slot Number of the router slot in which the service module is installed. Range: 1 to 4.
/ port Port number of the module interface. Always use 0. The slash mark (/) is required.
disable Disables reset of the service module if the heartbeat is lost.
enable Enables reset of the service module if the heartbeat is lost.
Command Default Service module is reset when heartbeat is lost.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines When the service module is booted in failsafe mode or is undergoing an upgrade, this command prevents a
reboot during the process.
When the service module heartbeat is lost, the router applies a fail-open or fail-close configuration option to
the module, stops sending traffic to the module, and sets the module to error state. The router performs a
hardware reset on the service module and monitors it until the heartbeat is reestablished.
Examples The following example shows how to disable the service module from being reset if the heartbeat is
lost:
Router# service-module sm 1/0 heartbeat-reset disable
You can display the status of the heartbeat reset feature with the service-modulesmstatuscommand:
Router# service-module sm 1/0 status
Service Module is Cisco IDS-Sensor 1/0
Service Module supports session via TTY line 194
Service Module heartbeat-reset is enabled <=====
Related Commands Command Description
interface sm Configures an interface for a service module and enters interface
configuration mode.
service-module sm reload Performs a graceful shutdown and reboot of the service module.
Cisco IOS Interface and Hardware Component Command Reference
1047
scramble through service-module t1 lbo
service-module sm heartbeat-reset
Command Description
service-module sm reset Resets the service module hardware.
service-module sm shutdown Performs a graceful shutdown of the service module.
service-module sm status Displays configuration information related to the hardware and software
on a service module.
Cisco IOS Interface and Hardware Component Command Reference
1048
scramble through service-module t1 lbo
service-module sm install
service-module sm install
To use Cisco SRE to install an application on a service module (Cisco SM-SRE), use the
service-modulesminstallcommand in privileged EXEC configuration mode.
service-module sm slot/port install url url [script filename] [argument "string"] [force]
Syntax Description slot / port Location of the services engine module in the router. For service modules, the slot number
is 1 to 4 and the port number must be 0.
url url Address of FTP or HTTP server, as defined in RFC 2396, on which application packages and
Tcl scripts are located.
script (Optional) Changes name of Tcl script to be run from default value to script specified by
filename argument.
filename Name of Tcl script.
argument (Optional) Installer will not present options for the variable specified in the string argument.
string Alphanumeric characters of variable to be passed directly to the Tcl script via the command
line. Variable must be enclosed in quotation marks (“ ”)
force (Optional) Tcl script automatically proceeds with install without prompting for user input.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines This command uses a common module-dependent bootloader on Cisco SRE to install a Linux-based application,
such as Cisco Unity Express or Cisco AXP, on a service module (Cisco SM-SRE).
The slash mark (/) is required between the slot argument and the port argument.
You can only issue one instance of this command at a time on a router. You cannot use this command to install
an application on two or more services engine modules in the same router at a time.
The Tcl script to be run must reside in the same FTP or HTTP server and directory as the application packages
to be installed. If a credential is required, the user name and password must be imbedded in the url as shown
in the following example:
Router# service-module sm 1/0 install url ftp://username:[email protected]/axp
If two or more of the optional keyword/argument combinations are used with this command, they must be
issued in the order presented in the command syntax. For example, you cannot use the force keyword before
the script orargument keywords nor the argument keyword before the script keyword when you issue this
command.
Use the scriptfilename keyword/argument combination with this command to specify that the Cisco IOS
software use some Tcl script other than the default installer during the installation.
Cisco IOS Interface and Hardware Component Command Reference
1049
scramble through service-module t1 lbo
service-module sm install
Use the argument“string” keyword/argument combination with this command to manually provide variables
during installation process and bypass the user interaction feature of the installer. The variable must include
the left and right quotation marks (“ ”).
Use the force keyword with this command to install an application without prompting for user input. If you
use this keyword and if the application requires you to provide certain variables during the installation, you
should also use the argument“string” keyword/argument combination to manually provide the required
variables because the force keyword will direct the installer to bypass all user interaction during the installation.
To stop the install while the Tcl script is being downloaded, use the service-modulesminstallabort command.
This command cannot be used once the actual installation begins.
Examples The following example shows how to use this command to run a “help.sre” Tcl script rather than the
default installation Tcl script:
Router# service-module sm 1/0 install url ftp://server.com/cue script help.sre
Router#
The following example shows how to direct the installer to use the specified language variable for
US English instead of prompting you with language options for Cisco Unity Express:
Router# service-module sm 1/0 install url ftp://server.com/cue argument “lang=en_us”
Router#
The following example shows the messages displayed on the module console during a successful
installation using Cisco SRE:
Feb 6 19:09:22.526 EDT: %SM_INSTALL-6-INST_PROG: Service-Module-SM 1/0 PROGRESSING:
Validating package signature ...1 .
Feb 6 19:09:23.058 EDT: %SM_INSTALL-6-INST_PROG: Service-Module-SM 1/0 PROGRESSING: Parsing
package manifest files ...1 .
Feb 6 19:09:44.742 EDT: %SM_INSTALL-6-INST_PROG: Service-Module-SM 1/0 PROGRESSING: Starting
payload download1 .
Feb 6 19:09:52.022 EDT: %SM_INSTALL-6-INST_PROG: Service-Module-SM 1/0 PROGRESSING:
Performing Hot install ...1 .
Install successful on Service-Module-SM 1/0 Feb 6 19:10:28.826 EDT: %SM_INSTALL-6-INST_SUCC:
Service-Module-SM 1/0 SUCCESS: install-completed .
Related Commands Command Description
service-module sm install abort Stops the install and returns to the boot-loader prompt.
service-module sm uninstall Uses Cisco SRE to uninstall an SRE-supported application on an
SRE-enabled services engine module.
Cisco IOS Interface and Hardware Component Command Reference
1050
scramble through service-module t1 lbo
service-module sm install abort
service-module sm install abort
To abort the Cisco SRE install process on a Cisco SM-SRE, use the service-modulesminstallabortcommand
in privileged EXEC configuration mode.
service-module sm slot/port install abort [force]
Syntax Description slot/port Location of the services engine module in the router. For service modules, the slot number is 1 to
4 and the port number must be 0.
force (Optional) Tcl script automatically stops the installation without prompting for confirmation.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines This command stops the installation during the downloading portion of the process only and returns the console
to the boot-loader prompt. You cannot use this command to stop the process once the actual installation has
begun.
Use the force keyword with this command to stop the process without first prompting for confirmation.
Examples The following example shows how to use this command to stop an application installation without
first prompting for confirmation:
Router# service-module sm 4/0 install abort force
.
.
.
boot-loader>
Related Commands Command Description
service-module sm install Uses Cisco SRE to install an SRE-supported application on an SRE-enabled
services engine module.
Cisco IOS Interface and Hardware Component Command Reference
1051
scramble through service-module t1 lbo
service-module sm reload
service-module sm reload
To perform a graceful shutdown and reboot of the SM-SRE service module operating system, use the
service-modulesmreload command in privileged EXEC mode.
service-module sm slot/port reload
Syntax Description slot Router slot in which the service module is installed. Range: 1 to 4.
/ port Port number of the module interface. Always use 0. The slash mark (/) is required.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines At the confirmation prompt, press Enter to confirm the action or n to cancel.
Examples The following example shows how to gracefully shut down the module and reboot the operating
system:
Router# service-module sm 1/0 reload
Do you want to proceed with reload?[confirm]
Related Commands Command Description
interface sm Configures an interface for a service module and enters interface
configuration mode.
service-module sm reset Resets the service module hardware.
service-module sm shutdown Gracefully shuts down the service module.
show diag Displays controller information for service modules.
show interfaces sm Displays basic interface configuration information for service modules.
Cisco IOS Interface and Hardware Component Command Reference
1052
scramble through service-module t1 lbo
service-module sm reset
service-module sm reset
To reset the SM-SRE service module hardware, use the service-modulesmreset command in privileged EXEC
mode.
service-module sm slot/port reset
Syntax Description slot Router slot in which the service module is installed. Range: 1 to 4.
/ port Port number of the module interface. Always use 0. The slash mark (/) is required.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines At the confirmation prompt, press Enter to confirm the action or n to cancel.
Caution Because you may lose data, use the service-modulesmreset command only to recover from a shutdown or
failed state.
Examples The following example shows how to reset the service module hardware:
Router# service-module sm 1/0 reset
Use reset only to recover from shutdown or failed state
Warning: May lose data on the the NVRAM, nonvolatile file system or unsaved configuration!
Do you want to reset?[confirm]
Related Commands Command Description
interface sm Configures an interface for a service module and enters interface
configuration mode.
service-module sm reload Performs a graceful shutdown and reboot of the service module operating
system.
service-module sm shutdown Gracefully shuts down the service module.
show diag Displays controller information for service modules.
show interfaces sm Displays basic interface configuration information for service modules.
Cisco IOS Interface and Hardware Component Command Reference
1053
scramble through service-module t1 lbo
service-module sm session
service-module sm session
To begin a configuration session for an SM-SRE service module through a console connection, use the
service-modulesmsession command in privileged EXEC mode.
service-module sm slot/port session [clear]
Syntax Description slot Router slot in which the service module is installed. Range: 1 to 4.
/ port Port number of the module interface. Always use 0. The slash mark (/) is required.
clear (Optional) Clears the service module configuration session.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines Only one session at a time is allowed into the service module from the service module interface.
After starting a session, you can perform any service module configuration task. You first access the service
module console in a user-level shell. To access the privileged EXEC command shell, where most commands
are available, use the enable command.
After you finish configuration tasks and exit the service module console session, use this command with the
clear keyword to clear the session. At the confirmation prompt, press Enter to confirm the action or n to
cancel.
Examples The following example shows a session being opened for an SM-SRE:
Router# service-module sm 1/0 session
Trying 10.10.10.1, 2129 ... Open
SE-Module con now available
Press RETURN to get started!
SE-Module> enable
The following example clears the session that had been used to configure the SM-SRE in slot 1:
Router# service-module sm 1/0 session clear
[confirm]
[OK]
Related Commands Command Description
enable Enters privileged EXEC mode.
Cisco IOS Interface and Hardware Component Command Reference
1054
scramble through service-module t1 lbo
service-module sm session
Command Description
interface Configures an interface and enters interface configuration mode.
show diag Displays controller information for a service module.
show interface sm Displays basic interface configuration information for service modules.
Cisco IOS Interface and Hardware Component Command Reference
1055
scramble through service-module t1 lbo
service-module sm shutdown
service-module sm shutdown
To gracefully shut down an SM-SRE service module, use the service-modulesmshutdown command in
privileged EXEC mode.
service-module sm slot/port shutdown
Syntax Description slot Router slot in which the service module is installed. Range: 1 to 4.
/ port Port number of the module interface. Always use 0. The slash mark (/) is required.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines At the confirmation prompt, press Enter to confirm the action or n to cancel.
This command brings down the operating system of the specified service module in an orderly fashion to
protect the hard drive. When the system is shut down, the module can be removed from the router.
Examples The following example shows how to gracefully shut down the service module:
Router# service-module sm 1/0 shutdown
Do you want to proceed with shutdown?[confirm]
Use service module reset command to recover from shutdown.
WARNING: Confirm that the service-module status shows 'is Shutdown' before removing the
module or powering off the system !
Related Commands Command Description
interface sm Configures an interface for an SM-SRE and enters interface configuration
mode.
service-module sm reload Performs a graceful shut down and reboot of the SM-SRE operating system.
service-module sm reset Resets the hardware on the SM-SRE.
show diag Displays controller information for service modules.
show interfaces sm Displays basic interface configuration information for SM-SREs.
Cisco IOS Interface and Hardware Component Command Reference
1056
scramble through service-module t1 lbo
service-module sm statistics
service-module sm statistics
To display reset and reload information for an SM-SRE service module and its Cisco IOS software, use the
service-modulesmstatisticscommand in EXEC mode.
service-module sm slot/port statistics
Syntax Description slot Router slot in which the service module is installed. Range: 1 to 4.
/ port Port number of the module interface. Always use 0. The slash mark (/) is required.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Examples The following example displays information for a service module in slot 1:
Router# service-module sm 1/0 statistics
Module Reset Statistics:
CLI reset count = 0
CLI reload count = 0
Registration request timeout reset count = 1
Error recovery timeout reset count = 1
Module registration count = 1
Related Commands Command Description
interface sm Configures an interface for an SM-SRE and enters interface configuration
mode.
service-module sm reload Performs a graceful shutdown and reboot of the SM-SRE operating system.
service-module sm reset Resets the SM-SRE hardware.
service-module sm shutdown Gracefully shuts down the SM-SRE.
show interfaces sm Displays basic interface configuration information for SM-SREs.
Cisco IOS Interface and Hardware Component Command Reference
1057
scramble through service-module t1 lbo
service-module sm status
service-module sm status
To display configuration information related to the hardware and software on an SM-SRE service module,
use the service-modulesmstatuscommand in privileged EXEC mode.
service-module sm slot/port status
Syntax Description slot Router slot in which the service module is installed. Range: 1 to 4.
/ port Port number of the module interface. Always use 0. The slash mark (/) is required.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines Use this command to:
• Display the SM-SREs software release version
• Check the SM-SRE status (steady or down)
• Display hardware information for the SM-SRE, including CPU, memory, and interface information
Examples The following example displays information for an SM-SRE:
Router# service-module sm 1/0 status
Service Module is Cisco SM1/0
Service Module supports session via TTY line 67
Service Module is in Steady state
Service Module heartbeat-reset is enabled
Getting status from the Service Module, please wait..
Cisco Foundation Software 1.0
FNDN Running on SM
No install/uninstall in progress
Related Commands Command Description
interface sm Configures an interface for an SM-SRE and enters interface configuration mode.
show diag Displays controller information for service modules.
show interfaces sm Displays basic interface configuration information for SM-SREs.
Cisco IOS Interface and Hardware Component Command Reference
1058
scramble through service-module t1 lbo
service-module sm uninstall
service-module sm uninstall
To use Cisco SRE to uninstall an application on a service module (Cisco SM-SRE), use the
service-modulesmuninstallcommand in privileged EXEC configuration mode.
service-module sm slot/port uninstall [force]
Syntax Description slot / port Location of the services engine module in the router. For service modules, the slot number
is 1 to 4 and port number must be 0.
force (Optional) Tcl script automatically proceeds with uninstall without prompting for confirmation.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines This command completely erases the disk or compact flash of the SRE-enabled services engine module and
removes the application keys. It does not remove application licenses.
The slash mark (/) is required between the slot argument and the port argument.
You can only issue one instance of this command at a time on a router. You cannot use this command to
uninstall an application on two or more services engine modules in a router at a time.
Use the force keyword with this command to uninstall an appliction without first prompting for confirmation.
Examples The following example shows how to use this command to uninstall an application without first
prompting for confirmation:
Router# service-module
sm uninstall 1/0 force
Router#
Related Commands Command Description
service-module sm install Uses Cisco SRE to install an SRE-supported application on an SRE-enabled
services engine module.
Cisco IOS Interface and Hardware Component Command Reference
1059
scramble through service-module t1 lbo
service-module t1 cablelength short
service-module t1 cablelength short
To set transmission attenuation for shorter cable lengths, use the service-modulet1cablelengthshort command
in interface configuration mode. To disable transmission attenuation for shorter cable lengths, use the no form
of this command.
service-module t1 cablelength short {110ft|220ft|330ft|440ft|550ft|660ft}
no service-module t1 cablelength short
Syntax Description 110ft Sets a cable length from 0 to 110 feet.
220ft Sets a cable length from 111 to 220 feet.
330ft Sets a cable length from 221 to 330 feet.
440ft Sets a cable length from 331 to 440 feet.
550ft Sets a cable length from 441 to 550 feet.
660ft Sets a cable length from 551 to 660 feet.
Command Default No default behavior or values
Command Modes Interface configuration
Command History Release Modification
12.2(15)ZL This command was introduced.
12.3(2)T This command was integrated into Cisco IOS Release 12.3(2)T.
Usage Guidelines This command is intended only for the Version 2 card, WIC-1-DSU-T1 V2, as part of the service-modulet1
configuration options.
Use this command to configure the transmission (tx) attenuation for cables whose length is shorter than or
equal to 660 feet. The related command, service-modulet1lbo, is used to define the line-build-out values for
cable lengths longer than 660ft. At any time, only one, either the short configuration or the lbo configuration,
can exist. They cannot co-exist. The configuration of one command will cause the effect of the other command
to cease and only the new command will be in effect.
Examples The following example shows how to set the short cablelength to 220 feet.
Router(config)# interface serial 0/0
Router(config-if)# service-module t1 cablelength short 220ft
Related Commands Command Description
service-module t1 lbo Configures the CSU line-build-out (lbo) on a fractional T1/T1 DSU/CSU module.
Cisco IOS Interface and Hardware Component Command Reference
1060
scramble through service-module t1 lbo
service-module t1 clock source
service-module t1 clock source
To specify the clock source for the fractional T1/T1 CSU/DSU module, use the service-modulet1clocksource
command in interface configuration mode. To return to the default line clock, use the no form of this command.
service-module t1 clock source {internal|line}
no service-module t1 clock source
Syntax Description internal Specifies the CSU/DSU internal clock.
line Specifies the line clock. This is the default.
Command Default Line clock
Command Modes Interface configuration
Command History Release Modification
11.2 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples The following example sets an internal clock source on serial line 0:
Router(config)# interface serial 0
Router(config
-if)
# service-module t1 clock source internal
Related Commands Command Description
service-module 56k clock source Sets up the clock source on a serial interface for a 4-wire, 56/64-kbps
CSU/DSU module.
Cisco IOS Interface and Hardware Component Command Reference
1061
scramble through service-module t1 lbo
service-module t1 data-coding
service-module t1 data-coding
To guarantee the ones density requirement on an alternate mark inversion (AMI) line using the fractional
T1/T1 module, use the service-modulet1data-codingcommand in interface configuration mode. To enable
normal data transmission, use thenoform of this command.
service-module t1 data-coding {inverted|normal}
no service-module t1 data-coding
Syntax Description inverted Inverts bit codes by changing all 1 bits to 0 bits and all 0 bits to 1 bits.
normal Requests that no bit codes be inverted before transmission. This is the default.
Command Default Normal transmission
Command Modes Interface configuration
Command History Release Modification
11.2 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Data inversion is used to guarantee the ones density requirement on an AMI line when using bit-oriented
protocols such as High-Level Data Link Control (HDLC), PPP, X.25, and Frame Relay. If the time slot speed
is set to 56 kbps, this command is rejected because line density is guaranteed when transmitting at 56 kbps.
Use this command with the 64-kbps line speed.
If you transmit inverted bit codes, both CSU/DSUs must have this command configured for successful
communication.
Examples The following example inverts bit codes using a time slot speed of 64 kbps:
Router(config)# interface serial 0
Router(config
-if)
# service-module t1 timeslots all speed 64
Router(config
-if)
# service-module t1 data-coding inverted
Related Commands Command Description
service-module t1 linecode Selects the linecode for the fractional T1/T1 module.
service-module t1 timeslots Defines time slots that constitute a fractional T1/T1 (FT1/T1) channel.
Cisco IOS Interface and Hardware Component Command Reference
1062
scramble through service-module t1 lbo
service-module t1 fdl
service-module t1 fdl
To set the facilities data link (FDL) parameter to either ATT or ANSI, use theservice-modulet1fdl command
in interface configuration mode. To ignore the FDL parameter, use the no form of this command.
service-module t1 fdl {ansi|att}
no service-module t1 fdl
Syntax Description ansi Sets the FDL parameter to ANSI.
att Sets the FDL parameter to ATT.
Command Default Determined by the telephone company
Command Modes Interface configuration
Command History Release Modification
11.2 P This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The default is noservice-modulet1fdl. The ansi or att options are determined by your service provider or
telephone company.
Examples The following example sets the FDL parameter to ANSI:
Router(config)# interface serial 0
Router(config
-if)
# service-module t1 fdl ansi
Cisco IOS Interface and Hardware Component Command Reference
1063
scramble through service-module t1 lbo
service-module t1 framing
service-module t1 framing
To select the frame type for a line using the fractional T1/T1 (FT1/T1) module, use the
service-modulet1framing command in interface configuration mode. To revert to the default, Extended Super
Frame, use the noform of this command.
service-module t1 framing commandservice-module t1 framing {esf|sf}
no service-module t1 framing commandservice-module t1 framing {esf|sf}
Syntax Description esf Specifies extended super frame (ESF) as the T1 frame type. This is the default.
sf Specifies D4 super frame (SF) as the T1 frame type.
Command Default esf
Command Modes Interface configuration
Command History Release Modification
11.2 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use this command in configurations in which the router communicates with FT1/T1 data lines. The service
provider determines which framing type, either esf or sf, is required for your circuit.
Examples The following example enables Super Frame as the FT1/T1 frame type:
Router(config
-if)
# service-module t1 framing sf
Cisco IOS Interface and Hardware Component Command Reference
1064
scramble through service-module t1 lbo
service-module t1 lbo
service-module t1 lbo
To configure the CSU line-build-out (LBO) on a fractional T1/T1 CSU/DSU module, use the
service-modulet1lbocommand in interface configuration mode. To disable line-build-out, use the noform of
this command.
service-module t1 lbo {-15 db|-7.5 db|none}
no service-module t1 lbo {-15 db|-7.5 db|none}
Syntax Description -15 db Decreases outgoing signal strength by 15 dB.
-7.5 db Decreases outgoing signal strength by 7.5 dB.
none Transmits packets without decreasing outgoing signal strength.
Command Default Disabled
Command Modes Interface configuration
Command History Release Modification
11.2 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use this command to decrease the outgoing signal strength to an optimum value for a fractional T1 line
receiver. The ideal signal strength should be -15 dB to -22 dB, which is calculated by adding the phone
company loss, cable length loss, and line build out.
You may use this command in back-to-back configurations, but it is not needed on most actual T1 lines.
Examples The following example sets the LBO to -7.5 dB:
Router(config)# interface serial 0
Router(config
-if)
# service-module t1 lbo -7.5 db
Cisco IOS Interface and Hardware Component Command Reference
1065
scramble through service-module t1 lbo
service-module t1 lbo
Cisco IOS Interface and Hardware Component Command Reference
1066
service-module t1 linecode through show
controllers satellite
• service-module t1 linecode, on page 1069
• service-module t1 remote-alarm-enable, on page 1070
• service-module t1 remote-loopback, on page 1071
• service-module t1 timeslots, on page 1073
• service-module wlan-ap bootimage, on page 1075
• service-module wlan-ap reload, on page 1077
• service-module wlan-ap reset, on page 1079
• service-module wlan-ap session, on page 1081
• service-module wlan-ap statistics, on page 1083
• service-module wlan-ap status, on page 1084
• session slot, on page 1085
• set ip df, on page 1086
• set platform hardware qfp active feature ipsec event-monitor, on page 1088
• shdsl annex, on page 1089
• shdsl rate, on page 1092
• shelf-id, on page 1095
• show (satellite initial configuration), on page 1097
• show alarm-interface, on page 1099
• show alarm-profile, on page 1101
• show als, on page 1102
• show aps, on page 1104
• show asic-version, on page 1106
• show c7300, on page 1107
• show c7300 errorlog, on page 1110
• show c7300 pxf accounting, on page 1113
• show c7300 pxf interfaces, on page 1115
• show c7300 slot, on page 1117
• show cable bundle, on page 1119
• show cable-diagnostics tdr, on page 1120
• show card-protection CPGN detail, on page 1122
• show catalyst6000, on page 1123
Cisco IOS Interface and Hardware Component Command Reference
1067
service-module t1 linecode through show controllers satellite
• show cem, on page 1125
• show cem circuit, on page 1128
• show chassis, on page 1132
• show class cem, on page 1134
• show compress, on page 1136
• show controllers c3794, on page 1138
• show controller dsl, on page 1139
• show controller vdsl, on page 1143
• show controllers analysis-module, on page 1148
• show controllers cbus, on page 1151
• show controllers content-engine, on page 1158
• show controllers dsx3, on page 1161
• show controller dwdm, on page 1164
• show controllers e1, on page 1166
• show controllers e3, on page 1171
• show controllers ethernet, on page 1176
• show controllers fastethernet, on page 1179
• show controllers fddi, on page 1190
• show controllers gigabitethernet, on page 1191
• show controllers integrated-service-engine, on page 1203
• show controllers ism, on page 1204
• show controllers j1, on page 1207
• show controllers lex, on page 1210
• show controllers mci, on page 1212
• show controllers pcbus, on page 1214
• show controllers pos, on page 1215
• show controllers satellite, on page 1223
Cisco IOS Interface and Hardware Component Command Reference
1068
service-module t1 linecode through show controllers satellite
service-module t1 linecode
service-module t1 linecode
To select the line code for the fractional T1/T1 module, use the service-modulet1linecodecommand in
interface configuration mode. To select the default, the B8ZS line code, use theno form of this command.
service-module t1 linecode {ami|b8zs}
no service-module t1 linecode {ami|b8zs}
Syntax Description ami Specifies alternate mark inversion (AMI) as the line code.
b8zs Specifies binary 8 zero substitution (B8ZS) as the line code. This is the default.
Command Default The default line code is B8ZS.
Command Modes Interface configuration
Command History Release Modification
11.2 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Configuring B8ZS is a method of ensuring the ones density requirement on a T1 line by substituting intentional
bipolar violations in bit positions four and seven for a sequence of eight zero bits. When the CSU/DSU is
configured for AMI, you must guarantee the ones density requirement in your router configuration using the
service-modulet1data-codinginverted command or the service-modulet1timeslotsspeed56command.
Your T1 service provider determines which line code, either amior b8zs, is required for your T1 circuit.
Examples The following example specifies AMI as the line code:
Router(config)# interface serial 0
Router(config
-if)
# service-module t1 linecode ami
Related Commands Command Description
service-module t1 data-coding Guarantees the ones density requirement on an AMI line using the
fractional T1/T1 module.
service-module t1 timeslots Defines time slots that constitute a fractional T1/T1 (FT1/T1) channel.
Cisco IOS Interface and Hardware Component Command Reference
1069
service-module t1 linecode through show controllers satellite
service-module t1 remote-alarm-enable
service-module t1 remote-alarm-enable
To generate remote alarms (yellow alarms) at the local CSU/DSU or detect remote alarms sent from the remote
CSU/DSU, use the service-modulet1remote-alarm-enablecommand in interface configuration mode. To
disable remote alarms, use theno form of this command.
service-module t1 remote-alarm-enable
no service-module t1 remote-alarm-enable
Syntax Description This command has no arguments or keywords.
Command Default Remote alarms are disabled.
Command Modes Interface configuration
Command History Release Modification
11.2 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Remote alarms are transmitted by the CSU/DSU when it detects an alarm condition, such as a red alarm (loss
of frame) or blue alarm (unframed ones). The receiving CSU/DSU then knows that there is an error condition
on the line.
With D4 Super Frame configured, a remote alarm condition is transmitted by setting the bit 2 of each time
slot to zero. For received user data that has the bit 2 of each time slot set to zero, the CSU/DSU interprets the
data as a remote alarm and interrupts data transmission, which explains why remote alarms are disabled by
default. With Extended Super Frame configured, the remote alarm condition is signalled out of band in the
facilities data link.
You can see if the FT1/T1 CSU/DSU is receiving a remote alarm (yellow alarm) by issuing the
showservice-moduleserial command.
Examples The following example enables remote alarm generation and detection:
Router(config)# interface serial 0
Router(config
-if)
# service-module t1 remote-alarm-enable
Related Commands Command Description
service-module t1 framing Selects the frame type for a line using the fractional T1/T1 (FT1/T1) module.
show service-module serial Displays performance statistics for an integrated CSU/DSU.
Cisco IOS Interface and Hardware Component Command Reference
1070
service-module t1 linecode through show controllers satellite
service-module t1 remote-loopback
service-module t1 remote-loopback
To specify that the fractional T1/T1 DSU/CSU module enters loopback mode when it receives a loopback
code on the line, use the service-modulet1remote-loopback command in interface configuration mode. To
disable remote loopbacks, use the no form of this command.
service-module t1 remote-loopback {full|payload v54}
no service-module t1 remote-loopback {full|payload v54}
Syntax Description full Configures the remote loopback code used to transmit or accept CSU loopback requests.
payload Configures the loopback code used by the local CSU/DSU to generate or detect payload-loopback
commands.
v54 Industry standard loopback code. Use this keyword for CSU/DSUs that may not support the
Accunet loopup standards. This keyword is used only with a payload request, not a full request.
Use the fullkeyword to enable the standard loopup codes, which use a 1-in-5 pattern for loopup and a 1-in-3
pattern for loopdown. Use the payloadv54keywords to enable the v54 pseudo-random loopup codes for loopup
and v54 pseudo-random loopdown codes for loopdown.
Command Default Full and payload loopbacks with standard loopup codes
Command Modes Interface configuration
Command History Release Modification
11.2 This command was introduced.
12.3(2)T The provision for an alternate loopback code was removed.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The no form of this command disables loopback requests. For example, the
noservice-modulet1remote-loopbackfull command ignores all full-bandwidth loopback transmissions and
requests.
Configuring the no form of the command might not prevent telco line providers from looping your router in
extended super frame (esf) mode because fractional T1/T1 lines use facilities data link messages to initiate
loopbacks.
To have the loopback remote commands on the FT1/T1 CSU/DSU module function successfully, you need
to enable the service-modulet1remote-loopback command.
Cisco IOS Interface and Hardware Component Command Reference
1071
service-module t1 linecode through show controllers satellite
service-module t1 remote-loopback
Note Use the fullkeyword to enable the standard loopup codes, which use a 1-in-5 pattern for loopup and a 1-in-3
pattern for loopdown. Use the payloadv54keywords to enable the v54 pseudorandom codes for loopup and
v54 pseudorandom codes for loopdown.
Examples The following example shows how to configure two routers connected back-to-back through a
fractional T1/T1 line to enter loopback mode:
Router(config)# interface serial 0/0
Router(config-if)# service-module t1 remote-loopback full
Router(config-if)# loopback remote full
!
%SERVICE_MODULE-5-LOOPUPREMOTE: Unit Serial0/0 - Remote unit placed in loopback
Router(config-if)# no loopback remote
%SERVICE_MODULE-5-LOOPDOWNREMOTE: Unit Serial0/0 - Remote loopback test cancelled
The following example shows how to configure two routers connected back-to-back through a
fractional T1/T1 line to enter loopback mode and generate or detect payload-loopback commands:
Router(config-if)# service-module t1 remote-loopback payload v54
Router(config-if)# loopback remote payload
%%SERVICE_MODULE-5-LOOPUPREMOTE: Unit Serial0/0 - Remote unit placed in loopback
Related Commands Command Description
loopback remote (interface) Loops packets through a DSU/CSU to a remote DSU/CSU and back over
a channelized T1 link.
Cisco IOS Interface and Hardware Component Command Reference
1072
service-module t1 linecode through show controllers satellite
service-module t1 timeslots
service-module t1 timeslots
To define time slots that constitute a fractional T1/T1 (FT1/T1) channel , use the
service-modulet1timeslotscommand in interface configuration mode. To resume the default setting (all
FT1/T1 time slots transmit at 64 kbps), use the no form of this command.
service-module t1 timeslots {range|all} [speed {56|64}]
no service-module t1 timeslots {range|all}
Syntax Description range The DS0 time slots that constitute the FT1/T1 channel. The range is from 1 to 24, where the first
time slot is numbered 1 and the last time slot is numbered 24. Specify this field by using a series of
subranges separated by commas.
all Selects all FT1/T1 time slots.
speed (Optional) Specifies the time slot speed.
56 (Optional) 56 kbps.
64 (Optional) 64 kbps. This is the default.
Command Default 64 kbps is the default for all time slots.
Command Modes Interface configuration
Command History Release Modification
11.2 This command was introduced.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX
release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command specifies which time slots are used in fractional T1 operation and determines the amount of
bandwidth available to the router in each FT1/T1 channel.
The time-slot range must match the time slots assigned to the channel group. Your service provider defines
the time slots that comprise a channel group.
To use the entire T1 line, enable the service-modulet1timeslotsallcommand.
Examples The following example displays a series of time-slot ranges and a speed of 64 kbps:
Router(config
-if)
# service-module t1 timeslots 1-10,15-20,22 speed 64
Cisco IOS Interface and Hardware Component Command Reference
1073
service-module t1 linecode through show controllers satellite
service-module t1 timeslots
Related Commands Command Description
service-module t1 data-coding Guarantees the ones density requirement on an AMI line using the
fractional T1/T1 module.
service-module t1 linecode Selects the linecode for the fractional T1/T1 module.
Cisco IOS Interface and Hardware Component Command Reference
1074
service-module t1 linecode through show controllers satellite
service-module wlan-ap bootimage
service-module wlan-ap bootimage
To configure the boot image on the service module, use the service-module wlan-ap bootimage command
in privileged EXEC mode.
service-module wlan-ap interface number bootimage [{autonomous|unified}]
Syntax Description interface number The interface number for the wireless device. Always use 0.
autonomous Autonomous software image.
unified Upgrade image with Lightweight Access Point Protocol (LWAPP).
Command Default Autonomous software image
Command Modes Privileged EXEC
Command History Release Modification
12.4(20) T This command was introduced for wireless-enabled Cisco 880 Series and Cisco 890 Series
Integrated Services Routers.
Usage Guidelines When running the advanced IP services feature set on either Cisco 880 Series routers or Cisco 890 Series
routers, use the service-module wlan-ap 0 bootimage unified commandto enable the Cisco unified software
upgrade image on the embedded wireless access point. After enabling the unified image, use the service-module
wlan-ap 0 reload command to perform a graceful shutdown and reboot of the access point.
Note The service-module wlan-ap 0 bootimagecommand does not support recovery images on the embedded
access point. Use the service-module wlan-ap 0 reload command to shutdown and reboot the access point.
Cisco 880 Series and Cisco 890 Series routers with embedded access point running the unified software image
require DHCP to obtain an IP address for the access point. An IP address is needed to communicate with the
Wireless LAN Controller (WLC) and to download its image upon boot up. The host router can provide DHCP
server functionality through the DHCP pool to reach the WLC, and setup option 43 for the controller IP
address in the DHCP pool configuration.
Use the following guideline to setup a DHCP pool on the host router.
ip dhcp pool embedded-ap-pool
network 60.0.0.0 255.255.255.0
default router 60.0.0.1
option 43 hex f104.0a0a.0a0f /* Single WLC IP address (10.10.10.15) in HEX format */
int vlan 1 /* Default Vlan */
ip address 60.0.0.1 255.255.255.0
int Wlan-GigabitEthernet0 /* internal switch-port to AP */
switchport access vlan 1
Examples The following example upgrades the embedded access point image from autonomous to unified.
Cisco IOS Interface and Hardware Component Command Reference
1075
service-module t1 linecode through show controllers satellite
service-module wlan-ap bootimage
Router#configure terminal
Router(config)#service-module wlan-ap 0 bootimage unified
*Jan 18 05:31:58.172: %WLAN_AP_SM-6-UNIFIED_IMAGE: Embedded AP will change boot image to
mini-IOS also called LWAPP recovery Please check router config to ensure connectivity between
WLC and AP. Use service-module wlan-ap 0 reload to bootup mini-IOS image on AP
Router(config)#end
Router#
*Jan 18 05:32:04.136: %SYS-5-CONFIG_I: Configured from console by console
Router#service-module wlan-ap 0 reload
Reload will save AP config....
Do you want to proceed with reload?[confirm] Trying to reload Service Module wlan-ap0.
Router#
Service Module saved config, start reset.
Received reload request from router
Saving configuration...
Building configuration...
Related Commands Command Description
interface wlan-ap Enters wireless interface configuration mode to configure an interface.
service-module wlan-ap reload Performs a graceful shutdown and reboot of the service module.
service-module wlan-ap reset Resets the service module hardware.
Cisco IOS Interface and Hardware Component Command Reference
1076
service-module t1 linecode through show controllers satellite
service-module wlan-ap reload
service-module wlan-ap reload
To perform a graceful shutdown and reboot of the service module use the service-module wlan-ap reload
command in privileged EXEC mode.
service-module wlan-ap interface number reload
Syntax Description interface number The interface number for the wireless device. Always use 0.
Command Default None
Command Modes Privileged EXEC
Command History Release Modification
12.4(20)T This command was introduced for wireless-enabled Cisco 860, 880, and 890 Integrated Services
Routers.
Usage Guidelines Autonomous Mode
At the confirmation prompt, press Enter to confirm the action, or press n to cancel.
Note When running in autonomous mode, the reload command saves the configuration before rebooting. If the
attempt is unsuccessful, the following message displays: Failed to save service module configuration.
Unified Mode
The service module reload command is usually handled by the Wireless LAN Controller (WLC).
Note When running in Unified mode, the reload command will produce the following message: The embedded
wireless device is in Unified mode. Reload/reset is normally handled by WLC controller. Still want to proceed?
[yes]
Examples The following examples show a graceful shut down and reboot of the service module:
Autonomous Mode
Router# service-module wlan-ap0 reload
Do you want to proceed with reload?[confirm]
Router# reload
Do you want to reload the internal AP ? [yes/no]:
Do you want to save the configuration of the AP ? [yes/no]:
System configuration has been modified. Save [yes/no]:
Proceed with reload? [confirm]
Cisco IOS Interface and Hardware Component Command Reference
1077
service-module t1 linecode through show controllers satellite
service-module wlan-ap reload
Unified Mode
Router# service-module wlan-ap0 reload
The embedded AP is in Unified mode. Reload/reset is normally handled by WLC controller.
Still want to proceed? [yes]
Router# reload
The embedded AP is in Unified mode. Reload/reset is normally handled by WLC controller.
Do you want to reload the internal AP [yes/no]:
System configuration has been modified. Save [yes/no]:
Proceed with reload [Confirm]
Related Commands Command Description
interface wlan-ap Enters wireless interface configuration mode to configure an interface.
service-module wlan-ap reset Resets the service module hardware.
Cisco IOS Interface and Hardware Component Command Reference
1078
service-module t1 linecode through show controllers satellite
service-module wlan-ap reset
service-module wlan-ap reset
To reset the service module hardware, software, and configuration, use the service-module wlan-ap reset
command in privileged EXEC mode.
service-module wlan-ap interface number reset [{bootloader|default-config}]
Syntax Description interface number The interface number for the wireless device. Always use 0.
bootloader Resets the wireless device to the bootloader for manual image recovery.
default-config Resets the wireless device to the factory default configuration.
Command Default None
Command Modes Privileged EXEC
Command History Release Modification
12.4(20)T This command was introduced for wireless-enabled Cisco 860, 880, and 890 Integrated Services
Routers.
Usage Guidelines At the confirmation prompt, press Enter to confirm the action, or press n to cancel.
Caution Because you may lose data, use the service-module wlan-ap reset command only to recover from a shutdown
or failed state.
Examples The following example resets a wireless device on a router that is operating in either autonomous
mode or LWAPP mode:
Autonomous Mode
Router# service-module wlan-ap0 reset
Use reset only to recover from shutdown or failed state.
LWAPP Mode
Router# service-module wlan-ap0 reset
The embedded device is in LWAPP mode. Reload/reset is normally handled by WLC controller.
Still want to proceed? [yes]
Cisco IOS Interface and Hardware Component Command Reference
1079
service-module t1 linecode through show controllers satellite
service-module wlan-ap reset
Resetting the Factory Default Configuration on the Wireless Device
The following example resets the wireless device to the default configuration.
Router#service-module wlan-ap 0 reset default-config
Router#
Recovering the Image on the Wireless Device
The following example resets the wireless device down to the bootloader level for manual image
recovery.
Router#service-module wlan-ap0 reset bootloader
Router#
Related Commands Command Description
interface wlan-ap Enters wireless interface configuration mode to configure an interface.
service-module wlan-ap reload Performs a graceful shutdown and reboot of the service module.
Cisco IOS Interface and Hardware Component Command Reference
1080
service-module t1 linecode through show controllers satellite
service-module wlan-ap session
service-module wlan-ap session
To begin a configuration session with a service module through a console connection use the service-module
wlan-ap session command in privileged EXEC mode.
service-module wlan-ap interface number session [{clear|disconnect}]
Syntax Description interface number The interface number for the wireless device. Always use 0.
clear (Optional) Clears the wireless device configuration session.
Command Default None
Command Modes Privileged EXEC
Command History Release Modification
12.4(20)T This command was introduced for wireless-enabled Cisco 860, 880, and 890 Integrated Services
Routers.
Usage Guidelines Only one session is allowed at a time into the wireless device from a router console-port connection. After
starting a session, perform configuration tasks on the wireless device. You first access the router in a user-level
shell. To access the privileged EXEC command shell, where most commands are available, use the enable
command.
When you finish configuring the device, and would like to exit the console session, type Ctrl-Shift 6x to return
to the router’s console. Type service-module wlan-ap session clear or disconnect to close the session with
the device. At the confirmation prompt, press Enter twiceto confirm the action or n to cancel.
Note If you do not clear or disconnect the session on the service module, it will remain open in the background
after you return to the router's console prompt. When the session is open in the background, pressing Enter
will toggle you back to the wireless device prompt.
Examples The following example shows a session being opened on a service-module in an ISR:
Router# service-module wlan-ap 0 session
Trying 1.2.3.4, 2002 ... Open
AP#
The following example clears the session on the service-module in the ISR:
Router#service-module wlan-ap 0 session clear
[confirm]
[OK]
Cisco IOS Interface and Hardware Component Command Reference
1081
service-module t1 linecode through show controllers satellite
service-module wlan-ap session
Related Commands Command Description
enable Enters privileged EXEC mode.
interface wlan-ap Enters wireless interface configuration mode to configure an interface.
Cisco IOS Interface and Hardware Component Command Reference
1082
service-module t1 linecode through show controllers satellite
service-module wlan-ap statistics
service-module wlan-ap statistics
To display reset and reload information for a service module and its operating system software, use the
service-module wlan-ap statisticscommand in privileged EXEC mode.
service-module wlan-ap interface number statistics
Syntax Description interface number The interface number for the wireless device. Always use 0.
Command Default none
Command Modes Privileged EXEC
Command History Release Modification
12.4(20)T This command was introduced for wireless-enabled Cisco 860, 880, and 890 Integrated Services
Routers.
Examples The following example displays information for wireless-enabled Cisco ISRs:
Router#service-module wlan-ap 0 statistics
Module Reset Statistics:
CLI reset count = 0
CLI reload count = 1
Registration request timeout reset count = 0
Error recovery timeout reset count = 0
Module registration count = 10
The last IOS initiated event was a cli reload at *04:27:32.041 UTC Fri Mar 8 2007
Related Commands Command Description
interface wlan-ap Enters wireless interface configuration mode and configures a wireless
device.
service-module wlan-ap reset Resets the wireless device.
service-module wlan-ap reload Performs a graceful shutdown and reboot on the wireless device.
Cisco IOS Interface and Hardware Component Command Reference
1083
service-module t1 linecode through show controllers satellite
service-module wlan-ap status
service-module wlan-ap status
To display configuration information related to hardware and software on the service module, use the
service-module wlan-ap statuscommand in privileged EXEC mode.
service-module wlan-ap interface number status
Syntax Description interface number The interface number for the wireless device. Aways use 0.
Command Default None
Command Modes Privileged EXEC
Command History Release Modification
12.4(20)T This command was introduced for wireless-enabled Cisco 860, 880, and 890 Integrated Services
Routers.
Usage Guidelines Use the service-module wlan-ap status command to
• Display the wireless device’s software release version
• Check the wireless device’s status (steady or down)
• Display hardware information for the wireless device, including image, memory, interface, and system
uptime
Examples The following example displays information for the wireless device on a Cisco Integrated Services
Router:
Router#service-module wlan-ap 0 status
Service Module is Cisco wlan-ap0
Service Module supports session via TTY line 2
Service Module is in Steady state
Service Module reset on error is disabled
Getting status from the Service Module, please wait..
Image path = flash:c8xx_19xx_ap-k9w7-mx.acregr/c8xx_19xx_ap-k9w7-mx.acre
gr
System uptime = 0 days, 4 hours, 28 minutes, 5 seconds
Router#d was introduced for embedded wireless LAN access points on Cisco 860 and 880 Series
Integrated Services Routers.
Related Commands Command Description
interface wlan-ap Enters wireless service module's console interface.
Cisco IOS Interface and Hardware Component Command Reference
1084
service-module t1 linecode through show controllers satellite
session slot
session slot
To open a session with a module (for example, the Multilayer Switch Module (MSM), Network Analysis
Module (NAM), or Asynchronous Transfer Mode (ATM)), use the sessionslot command in EXEC mode.
session slot mod processor processor-id
Syntax Description mod Slot number.
processor processor-id Specifies the processor ID.
Command Default This command has no default settings.
Command Modes EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines To end the session, enter the quit command.
This command allows you to use the module-specific CLI.
Examples This example shows how to open a session with an MSM (module 4):
Router# session slot 4 processor 2
Router#
Cisco IOS Interface and Hardware Component Command Reference
1085
service-module t1 linecode through show controllers satellite
set ip df
set ip df
To change the Don’t Fragment (DF) bit value in the IP header, use the setipdf command in route-map
configuration mode. To disable changing the DF bit value, use the no form of this command.
set ip df {0|1}
no set ip df {0|1}
Syntax Description 0 Sets the DF bit to 0 (clears the DF bit ) and allows packet fragmentation.
1 Sets the DF bit to 1 which prohibits packet fragmentation.
Command Default The DF bit value is not changed in the IP header.
Command Modes Route-map configuration
Command History Release Modification
12.1(6) This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Using Path MTU Discovery (PMTUD) you can determine an MTU value for IP packets that avoids
fragmentation. If ICMP messages are blocked by a router, the path MTU is broken and packets with the DF
bit set are discarded. Use the setipdf command to clear the DF bit and allow the packet to be fragmented and
sent. Fragmentation can slow the speed of packet forwarding on the network but access lists can be used to
limit the number of packets on which the DF bit will be cleared.
Note Some IP transmitters (notably some versions of Linux) may set the identification field in the IP header (IPid)
to zero when the DF bit is set. If the router should clear the DF bit on such a packet and if that packet should
subsequently be fragmented, then the IP receiver will probably be unable to correctly reassemble the original
IP packet.
Examples The following example shows how to clear the DF bit to allow fragmentation. In this example a
router is blocking ICMP messages and breaking the path MTU. Using policy routing both the inbound
and outbound packets on interface serial 0 will have their DF bit set to 0 which allows fragmentation.
interface serial 0
ip policy route-map clear-df-bit
route-map clear-df-bit permit 10
match ip address 111
set ip df 0
access-list 111 permit tcp any any
Cisco IOS Interface and Hardware Component Command Reference
1086
service-module t1 linecode through show controllers satellite
set ip df
Related Commands Command Description
ip tcp path-mtu-discovery Enables Path MTU Discovery.
route-map Defines a route map to control where packets are output.
Cisco IOS Interface and Hardware Component Command Reference
1087
service-module t1 linecode through show controllers satellite
set platform hardware qfp active feature ipsec event-monitor
set platform hardware qfp active feature ipsec event-monitor
To set the threshold for IP Security (IPsec) crypto failure, use the set platform hardware qfp active feature
ipsec event-monitor type <failure type> count command in the user EXEC mode. To reset the IPsec crypto
failure threshold, use the clear form of this command.
set platform hardware qfp active feature ipsec event-monitor type {decrypt failed|encrypt
failed|replay} count value
clear set platform hardware qfp active feature ipsec event-monitor type {decrypt failed|encrypt
failed|replay} count value
Syntax Description type Sets the type of event monitor failure. The following options are available:
• decrypt failed
• encrypt failed
• replay
count Sets the monitored event threshold count.
value The value of the monitored event threshold count. The range is from 1 to 4294967295. The default
value is 0.
Command Default The event monitor is not enabled.
Command Modes User EXEC (#)
Command History Release Modification
Cisco IOS 12.2 XN This command was introduced on the Cisco ASR 1000 Series Aggregation Services
Routers.
The following example shows how to set the threshold for IPsec crypto failure:
Device> set platform hardware qfp active feature ipsec event-monitor type replay count 1
Cisco IOS Interface and Hardware Component Command Reference
1088
service-module t1 linecode through show controllers satellite
shdsl annex
shdsl annex
To define the single-pair high-bit-rate digital subscriber line (SHDSL) G.991.2 standard, use the
shdslannexcommand in config controller DSL group mode.
shdsl annex {annexstandard}
Cisco IOS Interface and Hardware Component Command Reference
1089
service-module t1 linecode through show controllers satellite
shdsl annex
Syntax Description standard Defines the standard for the selected type of DSL group. The following annex standards are
supported:
•A
• A-B-F-G
• A-F
• B (Default annexure)
• B-G
•F
•G
IMA Group
•A
• A-B
•B
M-PAIR Group
•A
• A-B
•B
• F {coding 16 | 32}
• F-G {coding 16 | 32}
• G {coding 16 | 32}
1-PAIR and 2-PAIR Group
•A
• A-B
•B
• F {coding 16 | 32}
• F-G {coding 16 | 32}
• G {coding 16 | 32}
Command Default SHDSL annex B
Command Modes Config controller DSL group
Cisco IOS Interface and Hardware Component Command Reference
1090
service-module t1 linecode through show controllers satellite
shdsl annex
Command History Release Modification
12.4(15)T This command was introduced for the Cisco HWIC-4SHDSL and HWIC-2SHDSL running on
the Cisco 1841 router and on the Cisco 2800 and 3800 series access routers.
15.1(1)T This command was modified. The argument annex was introduced for the Cisco HWIC-4SHDSL-E
Usage Guidelines Use the dsl-group command to create a DSL group, and then use the shdsl annex command to define the
G.991.2 standard for the DSL group.
Examples The following example uses the shdsl annex command to define the annex standard for a 2-Pair DSL
group on a Cisco HWIC-4SHDSL:
Router(config-controller-dsl-group)# shdsl annex ?
A Annex A of G.991.2 standard
A-B Annex A/B of G.991.2 standard
B Annex B of G.991.2 standard
F Annex F of G.991.2 standard
F-G Annex F/G of G.991.2 standard
G Annex G of G.991.2 standard
Router(config-controller-dsl-group)# shdsl annex g ?
coding 16-TCPAM or 32-TCPAM line coding
Router(config-controller-dsl-group)# shdsl annex g coding ?
16-TCPAM 16-TCPAM line coding
32-TCPAM 32-TCPAM line coding
Router(config-controller-dsl-group)# shdsl annex g coding 16 ?
<cr>
Example
Router(config-controller-dsl-group)#shdsl annex ?
A Annex A of G.991.2 standard
A-B-F-G Annex A/B/F/G of G.991.2 standard
A-F Annex A/F of G.991.2 standard
B Annex B of G.991.2 standard
B-G Annex B/G of G.991.2 standard
F Annex F of G.991.2 standard
G Annex G of G.991.2 standard
Router(config-controller-dsl-group)#shdsl annex f ?
coding 16-TCPAM, 32-TCPAM line coding or auto-TCPAM line coding
The above TCPAM configurations are valid only in case the termination is "co". In case the termination
is CPE, user will see the following output
Router(config-controller-dsl-group)#shdsl annex f ?
<cr>
Related Commands Command Description
dsl-group Creates a DSL group and enters config controller DSL group mode.
shdsl rate Defines the SHDSL rate.
Cisco IOS Interface and Hardware Component Command Reference
1091
service-module t1 linecode through show controllers satellite
shdsl rate
shdsl rate
To define the single-pair high-bit-rate digital subscriber line (SHDSL) rate, use the shdslratecommand in
config-controller-dsl-group mode.
shdsl rate {number|auto}
Syntax Description number SHDSL rate for the digital subscriber line (DSL) group.
DSL Group with 1 Pair
Annex A & B--192-2304 kbps
Annex F & G (32 TC-PAM)--768-5696 kbps
Annex F & G (16 TC-PAM)--2304-3840 kbps
DSL Group with 2 Pairs
Annex A & B--384-4608 kbps
Annex F & G (32 TC-PAM)--1536-11392 kbps
Annex F & G (16 TC-PAM)-- 4608-7680 kbps
DSL Group with 3 Pairs
Annex A & B--576-6912 kbps
Annex F & G (32 TC-PAM)--2304-12288 kbps
Annex F & G (16 TC-PAM)-- 6912-11520 kbps
DSL Group with 4 Pairs
Annex A & B--768-9216 kbps
Annex F & G (32 TC-PAM)--3072-16384 kbps
Annex F & G (16 TC-PAM)-- 9216-15360 kbps
Cisco IOS Interface and Hardware Component Command Reference
1092
service-module t1 linecode through show controllers satellite
shdsl rate
Data rates supported for each Annex and TC-PAM 2-wire configuration. For EFM bonding
configuration with multiple links, multiply the data rate ranges by the number of links in the EFM
bonding group.
2-wire, 16-TCPAM
Annex A--192 - 2304 kbps
Annex B--192 - 2304 kbps
Annex F--2304 - 3840 kbps
Annex G--2304 - 3840 kbps
Annex A & F--192 - 3840 kbps
Annex B & G--192 - 3840 kbps
A & B & F & G--192 - 3840 kbps
2-wire, 32-TCPAM
Annex F--768 - 5696 kbps
Annex G--768 - 5696 kbps
Annex A & F--768 - 5696 kbps
Annex B & G--768 - 5696 kbps
Annex A & B & F & G--768 - 5696 kbps
2-wire Auto-TCPAM
Annex A--192 - 2304 kbps
Annex B--192 - 2304 kbps
Annex F--768 - 5696 kbps
Annex G--768 - 5696 kbps
Annex A & F--192 - 5696 kbps
Annex B & G--192 - 5696 kbps
Annex A & B & F & G--192 - 5696 kbps
auto Sets this SHDSL rate to automatic mode.
Command Default The command default is the maximum annex rate for the selected DSL group.
Command Modes Config controller DSL group
Command History Release Modification
12.4(15)T This command was introduced for the Cisco HWIC-4SHDSL and HWIC-2SHDSL running on
the Cisco 1841 router and on the Cisco 2800 and 3800 series access routers.
15.1(1)T This command was modified. Support for the for the Cisco HWIC-4SHDSL-E is added.
Cisco IOS Interface and Hardware Component Command Reference
1093
service-module t1 linecode through show controllers satellite
shdsl rate
Usage Guidelines Use the dsl-group command to create a DSL group, and then use the shdsl annex command to define the
G.991.2 standard for the newly created DSL group. Define the SHDSL line rate with the shdsl rate command.
Examples The following example defines the SHDSL line rate for DSL group 1, pairs 0-1 (2 pairs) on a Cisco
HWIC-4SHDSL:
Router(config-controller)# dsl-group 1 pairs 0-1 ima
Router(config-controller-dsl-group)#
Sep 22 14:53:46.481: %HWIC_SHDSL-5-DSLGROUP_UPDOWN: SHDSL 0/2/0 dsl-group(1) state changed
to down.
Sep 22 14:53:48.481: %LINK-3-UPDOWN: Interface ATM0/2/IMA1, changed state to down
Sep 22 14:53:49.481: %LINEPROTO-5-UPDOWN: Line protocol on Interface ATM0/2/IMA1, changed
state to down
Router(config-controller-dsl-group)# shdsl annex ?
A Annex A of G.991.2 standard
A-B Annex A/B of G.991.2 standard
B Annex B of G.991.2 standard
Router(config-controller-dsl-group)# shdsl annex b ?
<cr>
Router(config-controller-dsl-group)# shdsl rate auto
<384-4608> DSL Rate in kbps(line will train at the rate + 16kbps overhead)
auto auto rate mode
The following example shows adaptive rate configurations.
Router(config-controller-dsl-group)#shdsl rate ?
<768-9216> DSL Rate (excluding DSL overhead) in kbps
auto auto rate mode
Router(config-controller-dsl-group)#shdsl rate 1024
Router(config-controller-dsl-group)#shdsl rate auto ?
current Current SNR Margin
snext Self Near end cross talk
Router(config-controller-dsl-group)#shdsl rate auto current ?
<0 - 10> 0dB to 10dB
Router(config-controller-dsl-group)#shdsl rate auto snext ?
<-10 - 10> -10dB to 10dB
Related Commands Command Description
dsl-group Creates a DSL group and enters config controller DSL group mode.
shdsl annex Defines the G.991.2 standard for a DSL group.
Cisco IOS Interface and Hardware Component Command Reference
1094
service-module t1 linecode through show controllers satellite
shelf-id
shelf-id
To change the shelf number assigned to the router shelf or dial shelf on the Cisco AS5800, use the shelf-id
command in global configuration mode. To return the shelf numbers to the default value, use the no form of
this command.
shelf-id number {router-shelf|dial-shelf}
no shelf-id number
Syntax Description number Number to assign to the shelf. Range is from 0 to 9999.
router-shelf Specified number to the router shelf.
dial-shelf Specified number to the dial shelf.
Command Default The default shelf number for the router shelf is 0.
The default shelf number for the dial shelf is 1, or one number higher than the specified router shelf number.
Command Modes Global configuration
Command History Release Modification
11.3(2)AA This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The shelf number is used to distinguish between cards on the router shelf and cards on the dial shelf.
Caution You must reload the Cisco AS5800 for the shelf number to take effect. The shelf numbers are part of the
interface names. When you reload the Cisco AS5800, all NVRAM interface configuration information is lost.
You can specify the shelf number through the setup facility during initial configuration of the Cisco AS5800.
This is the recommended method to specify shelf numbers.
To display the shelf numbers, use the showrunning-config command. If a shelf number has been changed,
the pending change is shown in the output of the showversion command (for example, the dial-shelf ID is
87; will change to 2 on reload).
Examples In the following example, the dial shelf is assigned the number 456:
Router(config)# shelf-id 456 dial-shelf
Router(config)# exit
Cisco IOS Interface and Hardware Component Command Reference
1095
service-module t1 linecode through show controllers satellite
shelf-id
Related Commands Command Description
show version Displays the configuration of the system hardware, the software version, the names and
sources of configuration files, and the boot images.
Cisco IOS Interface and Hardware Component Command Reference
1096
service-module t1 linecode through show controllers satellite
show (satellite initial configuration)
show (satellite initial configuration)
To display the initial configuration parameters for the Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT), use the show command in satellite initial configuration mode.
show
Syntax Description This command has no arguments or keywords.
Command Default No default behavior or values
Command Modes Satellite initial configuration
Command History Release Modification
12.3(14)T This command was introduced.
Usage Guidelines This command is typically used by an installation technician. Do not use this command unless your satellite
service provider instructs you to perform the satellite initial configuration and provides all necessary parameter
values.
You can view the satellite initial configuration parameters by entering the service-modulesatelliteslot/0status
command in privileged EXEC mode.
Examples The following example shows the satellite initial configuration parameters for the Cisco IP VSAT
satellite WAN network module (NM-1VSAT-GILAT):
Router(sat-init-config)# show
!
! Initial Configuration Parameters:
!
id aa-group 298
id software group 598
id vsat 6201
mode download
mode two-way
outbound data-pid 514
outbound data-rate 15000000
outbound frequency 1201000
outbound id 2
outbound modulation-type DVB
outbound sync ip address 172.16.0.3
outbound viterbi-rate 1/2
!
!
Router(sat-init-config)#
Cisco IOS Interface and Hardware Component Command Reference
1097
service-module t1 linecode through show controllers satellite
show (satellite initial configuration)
Related Commands Command Description
service-module satellite status Displays status information related to the hardware and software on the
Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT),
including the initial configuration parameters.
Cisco IOS Interface and Hardware Component Command Reference
1098
service-module t1 linecode through show controllers satellite
show alarm-interface
show alarm-interface
To display the alarm interface controller (AIC) configuration setting and the information sent to the Cisco
IOS software by the AIC, use the showalarm-interface command in privileged EXEC mode.
show alarm-interface [slot-number] [summary]
Syntax Description slot-number (Optional) Slot number in which the AIC was placed.
summary (Optional) Selects the summary format for the output message.
Command Default Displays verbose message output and displays all AICs in all slot numbers on the router.
Command Modes Privileged EXEC
Command History Release Modification
12.2(2)XG This command was introduced on the Cisco 2600 series and Cisco 3600 series.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T.
Examples The following is sample output from the showalarm-interfacesummary command:
Router# show alarm-interface 5 summary
Alarm Interface Card in Slot 5:
Configured IP address:10.2.130.102
Status: KEEPALIVE TIMER EXPIRED
Alarm Interface Card in Slot 5:
Configured IP address:10.2.130.102
Status:KEEPALIVE TIMER EXPIRED
The following is an example of a verbose showalarm-interfacedisplay:
Router# show alarm-interface 4
Alarm Interface Card in Slot 4:
Configured IP address: 10.10.10.2
Status: RUNNING
Timer expires in < 11 min.
Reported version: 00 00 00 01
Expected version: 00 00 00 01
Last Self Test result: READY
Last Start-Up message:
----------
<AIC>: Hardware Version 1, Revision A Software Version 2, Revision A 1.0.1 Installed and
running, POST passed.
----------
Last Status severity: 0
Last Status message:
----------
Status
----------
The table below describes significant fields shown in this output.
Cisco IOS Interface and Hardware Component Command Reference
1099
service-module t1 linecode through show controllers satellite
show alarm-interface
Table 29: show alarm-interface Field Descriptions
Field Description
Alarm Interface Card in Slot Card type and slot number.
Configured IP address Configured IP address
Status AIC card status. Can be one of the following:
• HARDWARE DETECTED
• RUNNING
• HARDWARE NOT PRESENT
• KEEPALIVE TIMER EXPIRED
Timer expires in Current value of the KEEPALIVE TIMER, or states if the timer has been
disabled. This line is only active when the status line reads HARDWARE
DETECTED or RUNNING.
Used in troubleshooting to detect operational failures of the AIC.
Reported version Active software version number.
Comparing the reported version to the expected version may reveal possible
incompatibilities between the AIC’s software and the IOS image.
Expected version Expected software version number.
Comparing the reported version to the expected version may reveal possible
incompatibilities between the AIC’s software and the IOS image.
Last Self Test result Result of the AIC’s power on self-test (POST).
Last Start-Up message Startup messages.
<AIC> AIC. Includes version and activity information.
Last Status severity Rates the severity of the status message. Any number other than 0 indicates a
need for intervention. The number 1 indicates the most severe condition.
Last Status message Last status message.
Related Commands Command Description
alarm-interface Enters the alarm interface mode and configures the AIC.
Cisco IOS Interface and Hardware Component Command Reference
1100
service-module t1 linecode through show controllers satellite
show alarm-profile
show alarm-profile
To verify the alarm profile configured for chassis, use the show alarm-profile command.
Syntax Description Syntax Description:
There are no keywords.
Command Default There is no default.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
Cisco IOS XE 16.8.1 Support for this command was introduced on ASR 900 Series.
Examples Router# show alarm profile
Alarm profile CHASSIS:
SONET/SDH:
Alarm Name Severity Syslog
Section Loss of Frame Failure CRITICAL Enabled
Line Alarm Indication Signal INFO Enabled
Line Remote Failure Indication INFO Enabled
Path Alarm Indication Signal INFO Enabled
Path Remote Failure Indication INFO Enabled
Path Loss of Pointer INFO Enabled
DS1:
Alarm Name Severity Syslog
Receiver has loss of signal CRITICAL Enabled
Receiver has loss of frame INFO Enabled
Receiver has remote alarm INFO Enabled
DS3:
Alarm Name Severity Syslog
Receiver has loss of signal MAJOR Enabled
DS1 Alarm Indication Signal MINOR Enabled
DS1 Loss Of Frame INFO Enabled
DS1 Remote Alarm Indication INFO Enabled
Cisco IOS Interface and Hardware Component Command Reference
1101
service-module t1 linecode through show controllers satellite
show als
show als
To display Automatic Laser Shutdown (ALS) status, use the show als command in privileged EXEC mode.
show als {all|interface slot/port}
Syntax Description all Displays ALS status for all interfaces.
interface Displays ALS status for the selected interface .
slot/port Number of the chassis slot that contains the interface, where:
• slot--Chassis slot number.
• /port--Port number.
Command Default No default behavior or values
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SRD1 This command was introduced on the Cisco 7600 series routers.
Examples The following example shows the ALS status for the selected interface:
Router# show als interface t2/1
TenGigabitEthernet2/1
Mode ALS_MODE_MANUAL
Pulse Width 100 sec
Pulse Interval 150 sec
Current state ALS_STATE_NORMAL
The following example shows the ALS status for all interfaces:
Router# show als all
TenGigabitEthernet2/1
Mode ALS_MODE_MANUAL
Pulse Width 100 sec
Pulse Interval 150 sec
Current state ALS_STATE_NORMAL
TenGigabitEthernet2/2
Mode ALS_MODE_AUTOMATIC
Pulse Width 100 sec
Pulse Interval 300 sec
Current state ALS_STATE_NORMAL
Related Commands Command Description
als Enables the ALS mode.
Cisco IOS Interface and Hardware Component Command Reference
1102
service-module t1 linecode through show controllers satellite
show als
Command Description
als restart Requests an ALS restart mode.
als restart mode Selects the ALS restart mode.
als restart pulse Select the ALS pulse mode.
hw-module als restart Requests a restart pulse.
Cisco IOS Interface and Hardware Component Command Reference
1103
service-module t1 linecode through show controllers satellite
show aps
show aps
To display information about the current automatic protection switching (APS) feature, use the showaps
command in privileged EXEC mode.
show aps commandshow aps
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC
Command History Release Modification
11.1CC This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples The following is sample output from the showapscommand on a router configured with a working
interface. In this example, POS interface 0/0/0 is configured as a working interface in group 1, and
the interface is selected (that is, active).
Router1# show aps
POS0/0/0 working group 1 channel 1 Enabled Selected
The following is sample output from the showapscommand on a router configured with a protect
interface. In this example, POS interface 2/0/0 is configured as a protect interface in group 1, and
the interface is not selected (the ~ indicates that the interface is not active). The output also shows
that the working channel is located on the router with the IP address 10.1.6.1 and that the interface
is currently selected (that is, active).
Router2# show aps
POS2/0/0 protect group 1 channel 0 bidirectional ~Selected
Rx_K1= 0, Rx_K2= 0 Tx_K1= 0 Tx_K2= 5
Working channel 1 at 10.1.6.1 Enabled
For the K1 field (8 bits), the first 4 bits indicate the channel number that has made the request, and
the last 4 bits map to the requests (local or external) listed in the table below. For the K2 field (8
bits), the first 4 bits indicate the channel number bridged onto the protect line, the next bit is the
architecture used, and the last 3 bits indicate the mode of operation or non-APS use listed in the table
below.
Table 30: K1 Bit Descriptions
Bits (Hexadecimal) Description
K1 bits 8765 K1 bits 8 through 5: Channel number that made the request.
K1 bits 4321 K1 bits 4 through 1: Type of request.
Cisco IOS Interface and Hardware Component Command Reference
1104
service-module t1 linecode through show controllers satellite
show aps
Bits (Hexadecimal) Description
1111 (0xF) Lockout of protection request.
1110 (0xE) Forced switch request.
1101 (0xD) Signal failure (SF)--high priority request.
1100 (0xC) Signal failure (SF)--low priority request.
1011 (0xB) Signal degradation (SD)--high priority request.
1010 (0xA) Signal degradation (SD)--low priority request.
1001 (0x9) Not used.
1000 (0x8) Manual switch request.
0111 (0x7) Not used.
0110 (0x6) Wait to restore request.
0101 (0x5) Not used.
0100 (0x4) Exercised request.
0011 (0x3) Not used.
0010 (0x2) Reverse request.
0001 (0x1) Do not revert request.
0000 (0x0) No request.
Cisco IOS Interface and Hardware Component Command Reference
1105
service-module t1 linecode through show controllers satellite
show asic-version
show asic-version
To display the application-specific integrated circuit (ASIC) version for a specific module, use the
showasic-version command in EXEC mode.
show asic-version slot number
Syntax Description slot The slot that the ASIC is installed in.
number Module number.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Cisco 7600 series routers.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines In the showasic-versioncommand output, the ASIC types are as follows:
• Lyra--Layer 2 forwarding engine
• Medusa--Crossbar and bus fabric interface
• Polaris--Layer 3 CEF engine
• Pinnacle--4-port Gigabit Ethernet interface
• Titan--Packet rewrite and replication engine
• Vela--Constellation bus interface
Examples This example shows how to display the ASIC type and version for a specific module:
Router# show asic-version slot 1
Module in slot 1 has 3 type(s) of ASICs
ASIC Name Count Version
ASIC1 (2.0)
ASIC2 (2.0)
ASIC3 1 (0.1)
Router#
Related Commands Command Description
show module Displays the module status and information.
Cisco IOS Interface and Hardware Component Command Reference
1106
service-module t1 linecode through show controllers satellite
show c7300
show c7300
To display the types and status of cards installed in a Cisco 7304 router, use the showc7300command in
privileged EXEC mode.
show c7300
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC
Command History Release Modification
12.1(9)EX This command was introduced.
12.1(10)EX The output of this command was enhanced to include information about Field-Programmable
Gate Array (FPGA) images.
12.1(10)EX2 The output of this command was enhanced to include information about a standby route
processor (RP).
12.2(18)S This command was integrated into Cisco IOS Release 12.2(18)S.
12.2(20)S Support was added for the Cisco 7304 router.
12.2(20)S2 Support was added for modular services cards (MSCs) and shared port adapters (SPAs) on
the Cisco 7304 router.
12.2(28)SB This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command displays the types and status of cards installed in a Cisco 7304 router (such as network services
engines [NSEs], RPs, line cards, MSCs, and SPAs), and information about incompatible FPGA images. When
the bundled and current FPGA images are compatible, they are not displayed.
This command also displays whether your system is in compliance with line card configuration guidelines.
For NSEs and line cards, empty slots are not displayed in the output. However, for SPAs, several status values
are reported, including an empty subslot, which is reported as “missing.”
If your system contains an unsupported line card or RP with no matching bundled FPGA image in Cisco IOS
software, then this command displays “None” instead of the bundled FPGA version number.
Use this command to display information about the status of the active and standby NSEs.
Examples The following example displays information about a Cisco 7304 router that has current FPGA images:
Router# show c7300
Slot Card Type Status Insertion time
Cisco IOS Interface and Hardware Component Command Reference
1107
service-module t1 linecode through show controllers satellite
show c7300
---- --------- ------ --------------
0,1 NSE-100 Active 00:13:16 ago
4 1OC48-POS Active 00:01:43 ago
System is compliant with hardware configuration guidelines.
All the FPGAs in the system are up-to-date
Network IO Interrupt Throttling:
throttle count=3, timer count=3
active=0, configured=1
netint usec=3999, netint mask usec=200
The following example displays information about a Cisco 7304 router that has incompatible FPGA
images that need to be updated. If your system contains an unsupported line card or RP with no
matching bundled FPGA image in Cisco IOS software, “None” is displayed instead of a bundled
FPGA version number.
Router# show c7300
Slot Card Type Status Insertion time
---- --------- ------ --------------
0,1 NSE-100 Active 00:02:26 ago
4 6T3 Active 00:02:23 ago
5 6T3 Active 00:02:23 ago
System is compliant with hardware configuration guidelines.
%WARNING:The following FPGAs in the system may need an update.
Slot Card Type Current FPGA Bundled FPGA
---- --------- ------------ ------------
0 NSE-100 (MB) 0.12 None
Network IO Interrupt Throttling:
throttle count=0, timer count=0
active=0, configured=1
netint usec=3999, netint mask usec=200
The following example displays sample output information about the redundancy status of the NSEs
installed in the system. In the following example, the active RP is the NSE-100 installed in slot 0
and slot 1. The standby is the NSE-100 installed in slot 2 and slot 3.
Router# show c7300
Slot Card Type Status Insertion time
---- --------- ------ --------------
0,1 NSE-100 Active 00:02:03 ago
2,3 NSE-100 Standby 00:02:03 ago
4 4OC3-POS Active 00:01:59 ago
5 6T3 Active 00:01:59 ago
System is compliant with hardware configuration guidelines.
Network IO Interrupt Throttling:
throttle count=0, timer count=0
active=0, configured=1
netint usec=3999, netint mask usec=200
The following example displays information about a Cisco 7304 router with an NSE-100, MSC-100s,
and 4-Port 10/100 Fast Ethernet SPAs:
Router# show c7300
Slot Card Type Status Insertion time
---- --------- ------ --------------
0,1 NSE100 Active 00:45:29 ago
2 7304-MSC-100 Active 00:44:36 ago
3 7304-MSC-100 Active 00:44:36 ago
4 7304-MSC-100 Active 00:44:36 ago
5 7304-MSC-100 Active 00:14:39 ago
The FPGA versions for the cards listed above are current
Shared Port Adapter information:
Cisco IOS Interface and Hardware Component Command Reference
1108
service-module t1 linecode through show controllers satellite
show c7300
Slot/Subslot SPA Type Status Insertion time
------------ -------- ------ --------------
2/0 SPA-4FE-7304 ok 00:44:36 ago
2/1 SPA-4FE-7304 ok 00:44:36 ago
3/0 SPA-4FE-7304 ok 00:44:35 ago
3/1 not present missing never
4/0 SPA-4FE-7304 ok 00:44:35 ago
4/1 SPA-4FE-7304 ok 00:44:35 ago
5/0 SPA-4FE-7304 ok 00:14:36 ago
5/1 SPA-4FE-7304 ok 00:14:36 ago
Network IO Interrupt Throttling:
throttle count=1, timer count=1
active=0, configured=1
netint usec=3999, netint mask usec=200
The table below provides a description for each of the possible status fields for SPAs.
Table 31: SPA Status Field Descriptions
Status Field for SPAs Description
booting SPA is initializing.
failed SPA is powered off due to five automatic recovery failures.
FW mismatch An FPGA version mismatch with the Cisco IOS software has been detected for the
SPA.
missing SPA is not present in the MSC subslot.
not allowed online SPA is not supported.
ok SPA is operational.
stopped SPA is deactivated by the hw-modulesubslotstopcommand.
unknown SPA is in unrecognizable state.
Related Commands Command Description
show c7300 errorlog Displays error information about a Cisco 7304 router.
show diag Displays hardware information for any slot or the chassis.
show redundancy (7300) Displays redundancy information for the active and standby NSEs.
show version Displays the configuration of the system hardware, the number of each interface
type installed, the Cisco IOS software version, the names and sources of
configuration files, and the boot images. Displays the configuration of the ROM
monitor.
Cisco IOS Interface and Hardware Component Command Reference
1109
service-module t1 linecode through show controllers satellite
show c7300 errorlog
show c7300 errorlog
To display error information on a Cisco 7304 router running pre-Cisco IOS Release 12.2(25)S software, use
the showc7300errorlogcommand in privileged EXEC mode.
show c7300 errorlog [{slot slot-number|all}]
Syntax Description slot (Optional) Displays error information for the hardware in a slot.
slot-number (Optional) Specifies the slot location of the hardware to display error information.
all (Optional) Displays error information for all hardware in all slots.
Command Default No default behavior or values.
Command Modes Privileged EXEC
Command History Release Modification
12.1(9)EX This command was introduced.
12.2(18)S This command was introduced on Cisco 7304 routers running Cisco IOS Release 12.2 S.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Each line card in a Cisco 7304 router has a serial channel connecting to the processor. There are two serial
channel controllers on each serial channel, one for the line card side and one for the processor side. Each serial
channel has four serial links labeled as SL0, SL1, SL2 and SL3. This command displays a set of error counters
for each serial link.
Use this command to display board-level errors. If you are investigating controller or interface errors, use the
showcontroller andshowinterface commands.
Examples The following example displays error information about a line card in slot 2 on a Cisco 7304 router:
Router# show c7300 errorlog slot 2
Backplane serial channel controller (Santa Ana):
LC 2, LC Santa Ana, channel A, error counters:
SL0 SL1 SL2 SL3
Reframe: [ 0 0 0 0 ]
Overrun: [ 0 0 0 0 ]
Underrun: [ 0 0 0 0 ]
OOB: [ 0 0 0 0 ]
Disparity: [ 0 0 0 0 ]
Missing_Ctrl_Code: [ 0 0 0 0 ]
Chip access errors: [ 0 0 0 0 ]
LC 2, NSE Santa Ana 0, channel A, error counters:
SL0 SL1 SL2 SL3
Reframe: [ 0 0 0 0 ]
Cisco IOS Interface and Hardware Component Command Reference
1110
service-module t1 linecode through show controllers satellite
show c7300 errorlog
Overrun: [ 0 0 0 0 ]
Underrun: [ 0 0 0 0 ]
OOB: [ 0 0 0 0 ]
Disparity: [ 0 0 0 0 ]
Missing_Ctrl_Code: [ 0 0 0 0 ]
Chip access errors: [ 0 0 0 0 ]
The following example displays error information about all hardware in all of the slots on a Cisco
7304 router:
Router# show c7300 errorlog slot all
Backplane serial channel controller (Santa Ana):
LC 2, LC Santa Ana, channel A, error counters:
SL0 SL1 SL2 SL3
Reframe: [ 0 0 0 0 ]
Overrun: [ 0 0 0 0 ]
Underrun: [ 0 0 0 0 ]
OOB: [ 0 0 0 0 ]
Disparity: [ 0 0 0 0 ]
Missing_Ctrl_Code: [ 0 0 0 0 ]
Chip access errors: [ 0 0 0 0 ]
LC 2, NSE Santa Ana 0, channel A, error counters:
SL0 SL1 SL2 SL3
Reframe: [ 0 0 0 0 ]
Overrun: [ 0 0 0 0 ]
Underrun: [ 0 0 0 0 ]
OOB: [ 0 0 0 0 ]
Disparity: [ 0 0 0 0 ]
Missing_Ctrl_Code: [ 0 0 0 0 ]
Chip access errors: [ 0 0 0 0 ]
Backplane serial channel controller (Santa Ana):
LC 3, LC Santa Ana, channel A, error counters:
SL0 SL1 SL2 SL3
Reframe: [ 0 0 0 0 ]
Overrun: [ 0 0 0 0 ]
Underrun: [ 0 0 0 0 ]
OOB: [ 0 0 0 0 ]
Disparity: [ 0 0 0 0 ]
Missing_Ctrl_Code: [ 0 0 0 0 ]
Chip access errors: [ 0 0 0 0 ]
LC 3, NSE Santa Ana 0, channel A, error counters:
SL0 SL1 SL2 SL3
Reframe: [ 0 0 0 0 ]
Overrun: [ 0 0 0 0 ]
Underrun: [ 0 0 0 0 ]
OOB: [ 0 0 0 0 ]
Disparity: [ 0 0 0 0 ]
Missing_Ctrl_Code: [ 0 0 0 0 ]
Chip access errors: [ 0 0 0 0 ]
The table below describes the significant fields shown in the display.
Table 32: show c7300 errorlog Field Descriptions
Field Description
Reframe A data frame on a serial link does not align to the designated framing boundary.
Overrun: Packets are stored in a FIFO buffer when the serial link is overloaded.
Underrun: A serial link looks for packets in an empty FIFO buffer.
Cisco IOS Interface and Hardware Component Command Reference
1111
service-module t1 linecode through show controllers satellite
show c7300 errorlog
Field Description
OOB: Out of band error. An undefined serial link control character is received.
Disparity: A running disparity error occurs on the link.
Missing_Ctrl_Code: Missing Control Code. An incorrect number of control codes are received.
Chip access errors: Access to the serial channel device fails.
Related Commands Command Description
show c7300 Displays the types of hardware currently installed in a Cisco 7304 router.
show diag Displays hardware information for any slot or the chassis.
show platform errorlog Displays error information.
show version Displays the configuration of the system hardware, the number of each interface
type installed, the Cisco IOS software version, the names and sources of
configuration files, and the boot images. Displays the configuration of the ROM
monitor.
Cisco IOS Interface and Hardware Component Command Reference
1112
service-module t1 linecode through show controllers satellite
show c7300 pxf accounting
show c7300 pxf accounting
To display the number and types of packets entering or exiting the PXF processors, use the
showc7300pxfaccounting command in privileged EXEC mode.
show c7300 pxf accounting
Syntax Description This command has no arguments or keywords.
Command Default No default behavior or values.
Command Modes Privileged EXEC
Command History Release Modification
12.1(9)EX This command was introduced.
12.2(14)SZ This command was modified to showpxfaccounting for the Cisco 7304 router. All Cisco IOS
releases prior to 12.2(14)SZ that support the Cisco 7304 still require that
showc7300pxfaccounting be entered to gather PXF accounting output.
12.2(18)S This command was introduced on Cisco 7304 routers running Cisco IOS Release 12.2S.
12.2(20)S The c7300 keyword was removed. Entering showpxfaccounting could get the information
previously gathered by entering the showc7300pxfaccounting command.
Usage Guidelines Use the showc7300pxfaccounting command to display the number of packets entering and exiting the PXF
processors.
The c7300 keyword was removed from this command in Cisco IOS Release 12.2(20)S. Theshowpxfaccounting
command can be used in post-Cisco IOS Release 12.2(20)S releases to gather information previously gathered
by entered the showc7300pxfaccounting command.
Examples The following example displays output of theshowc7300pxfaccounting command:
Router# show c7300 pxf accounting
PXF Utilization:14 %
PXF Packet Counters:
Ingress from GE : 0 Egress to GE : 8
Ingress from LCs: 24783520 Egress to LCs: 18387770
Ingress from RP : 10 Egress to RP : 2
Priority queue : 12 Default queue: 18387787
Drop Packet Counters:
ACL input deny Drop: 6395752
The table below describes the significant fields shown in the display.
Table 33: show c7300 pxf accounting Field Descriptions
Field Description
Ingress from GE: Packets coming into the PXF processors from the Gigabit Ethernet ports.
Cisco IOS Interface and Hardware Component Command Reference
1113
service-module t1 linecode through show controllers satellite
show c7300 pxf accounting
Field Description
Egress to GE: Packets going to the Gigabit Ethernet ports from the PXF processors.
Ingress from LCs Packets coming in to the PXF processors from line card ports.
Ingress from RP Packets coming in to the PXF processors from the Route Processor.
Drop Packet Counters: Packets dropped by the PXF processors.
ACL input deny Drop: Packets dropped because of the implicit deny all at the end of all ACLs.
Related Commands Command Description
ip pxf Manually enables the PXF processor.
show pxf accounting Displays the number and types of packets entering or exiting the PXF
processors.
show c7300 pxf interfaces Displays the status of various interfaces know to the PXF processors.
Cisco IOS Interface and Hardware Component Command Reference
1114
service-module t1 linecode through show controllers satellite
show c7300 pxf interfaces
show c7300 pxf interfaces
Note Effective with Cisco IOS Release 12.2(20)S, the showc7300pxfinterfaces command is replaced by the
showpxfinterfaces command. See the showpxfinterfaces command for for information.
To display the status of various interfaces known to the Parallel Express Forwarding (PXF) processors, use
the showc7300pxfinterfacescommand in privileged EXEC mode.
show c7300 pxf interfaces {interface-index|all}
Syntax Description interface-index A number that represents an interface known to the PXF processors. Valid values are 0 to
32767.
all Specifies all PXF interfaces.
Command Default No default behaviors or values.
Command Modes Privileged EXEC
Command History Release Modification
12.1(9)EX This command was introduced.
12.2(14)SZ This command was modified to showpxfinterfaces for the Cisco 7304 router. All Cisco IOS
releases prior to 12.2(14)SZ that support the Cisco 7304 still require that
showc7300pxfinterfaces be entered to gather PXF interface information.
12.2(18)S This command was introduced on Cisco 7304 routers running Cisco IOS Release 12.2S.
12.2(20)S This command was replaced by the show pxf interfaces command.
Examples The following example shows how to display information about PXF interface 1:
Router# show c7300 pxf interfaces 1
PXF-If: 00001 Gi0/0 (Up, Punting to RP - no ip route-cache)
Features: in=iACL [0x11], out=None [0x0]
The following example shows how to display information about all PXF interfaces:
Router# show c7300 pxf interfaces
all
PXF-If: 00001 Gi0/0 (Up, Punting to RP - no ip route-cache)
Features: in=iACL [0x11], out=None [0x0]
PXF-If: 00002 Gi0/1 (Down, Punting to RP - no ip route-cache)
Features: in=None [0x1], out=None [0x0]
PXF-If: 00007 In Use, Reserved
PXF-If: 00024 PO2/0 (Up, Punting to RP - no ip route-cache)
Features: in=None [0x1], out=None [0x0]
PXF-If: 00025 PO2/1 (Down, Punting to RP - no ip route-cache)
Cisco IOS Interface and Hardware Component Command Reference
1115
service-module t1 linecode through show controllers satellite
show c7300 pxf interfaces
Features: in=None [0x1], out=None [0x0]
PXF-If: 00026 PO2/2 (Down, Punting to RP - no ip route-cache)
Features: in=None [0x1], out=None [0x0]
PXF-If: 00027 PO2/3 (Down, Punting to RP - no ip route-cache)
Features: in=None [0x1], out=None [0x0]
The table below describes the significant fields shown in the display.
Table 34: show c7300 pxf interfaces Field Descriptions
Field Description
PXF-IF: Internal PXF interface number. This is a unique number assigned by PXF.
Gi 0/0 or PO2/3 Type of interface.
Features: Ingress and egress features on the PXF interface.
in= Ingress features.
iACL Input Access Control Lists is configured on this interface.
[0x11] Hexadecimal value of features flag for input features on this interface.
out= Egress features.
[0x0] Hexadecimal value of feature flag for output features on this interface.
(Up, Punting to RP) Interface status. Interface is up and packets are being sent to the Route Processor.
(Down, Punting to RP) Interface status. Interface is down and packets are being sent to the Route Processor.
- no ip route-cache Reason packets are being sent to the Route Processor. In this display, packets are
being sent to the Route Processor because the user has entered the noiproute-cache
command and CEF is not enabled on the interface. Entering the following commands
causes packets to be sent to the Route Processor:
• no ip cef
• no ip routing
• no ip route-cache
Other reasons may be displayed:
• lineproto down--The line is down.
• unsupported feature--Packets from a feature that is not supported by PXF.
Related Commands Command Description
ip pxf Manually enables the PXF processors.
show c7300 pxf accounting Displays the number of packets entering or exiting the PXF processors.
show pxf interfaces Displays the status of various interfaces known to the PXF processors.
Cisco IOS Interface and Hardware Component Command Reference
1116
service-module t1 linecode through show controllers satellite
show c7300 slot
show c7300 slot
To display various output useful for technical support purposes, enter the showc7300slotcommand in privileged
EXEC mode.
show c7300 slot {slot-number|all}
Syntax Description slot-number Displays various information for the hardware in a particular slot. This information is useful
for technical support purposes only.
all Displays various information for all of the hardware in all of the router slots. This information
is useful for technical support purposes only.
Command Default No default behavior or values.
Command Modes Privileged EXEC
Command History Release Modification
12.2(20)S This command replaces the show platform slot command.
Usage Guidelines This command should not be used. The output gathered from this command is useful for technical support
purposes only.
Examples The following example shows how to display information about the hardware in slot 4 of Cisco 7304
router:
Router# show c7300 slot 4
Slot 4 Details
Card Name: OC12-POS
Card Present: Yes
Slot Card Type: 0x377
Saved Slot Card Type (Persistent after the OIR): 0x377
Slot State (4): Activated
Slot Previous State (4): Activated
Slot Return (Transient) State (3): Analyzing
Current Event to the OIR FSM: Idle (0)
Current External Event to the OIR FSM: Idle (0)
Slot Flags (0x100000):
FPGA Checked
Slot Ready: Yes
Slot Retry Count: 0
Slot Structure Address: 0x446FAED0
Slot Sync Data Address : 0x446FB318
Slot 4 Line Card Plugin Details
Line Card Type: OC12-POS (0x377)
Number of Ports: 1
Line Card Plugin Address: 0x45E123C0
Line Card Compatible S/W Version: 0.0 (0x0)
Line Card H/W Version: 02.03 (0x203)
Line Card FPGA Version: 00.20 (0x14)
Minimum Line Card H/W Version required by the S/W: 00.00 (0x0)
Minimum Line Card FPGA Version required by the S/W: 00.01 (0x1)
Cisco IOS Interface and Hardware Component Command Reference
1117
service-module t1 linecode through show controllers satellite
show c7300 slot
Slot 4 Line Card Devices:
Line Card Common Devices
Device#0: EEPROM
Plugin Address 0x433BB830, C2W Control Structure Address 0x433C1138
Card Bus (4): Address 0x50, Frequency 0x13, Slot 4
Device#1: CPLD
Plugin Address 0x433BF9E0, C2W Control Structure Address 0x433C1198
Card Bus (4): Address 0x30, Frequency 0x13, Slot 4
Device#2: FPGA Flash
Plugin Address 0x433BFC30, C2W Control Structure Address 0x433C11F8
Card Bus (4): Address 0x30, Frequency 0x13, Slot 4
(Output removed for readability)
Related Commands Command Description
show platform slot Displays various output useful for technical support purposes.
Cisco IOS Interface and Hardware Component Command Reference
1118
service-module t1 linecode through show controllers satellite
show cable bundle
show cable bundle
To display the forwarding table for the specified interface, use the showcablebundle command in privileged
EXEC mode.
show cable bundle bundle-number forwarding-table
Syntax Description bundle-number Specifies the bundle identifier. Valid range is from 1 to 255.
forwarding-table Displays the forwarding table for the specified interface.
Command Modes Privileged EXEC
Command History Release Modification
12.0(7)XR This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples In the following example, a cable bundle of 25 is specified:
Router# show cable bundle 25 forwarding-table
MAC address Interface
0050.7366.17ab Cable3/0
0050.7366.1803 Cable3/0
0050.7366.1801 Cable3/0
The table below describes the significant fields shown in the display.
Table 35: show cable bundle Field Descriptions
Field Description
MAC address Media Access Control ID for each interface in the bundle.
Interface The cable interface slot and port number.
Related Commands Command Description
cable bundle Creates an interface bundle.
Cisco IOS Interface and Hardware Component Command Reference
1119
service-module t1 linecode through show controllers satellite
show cable-diagnostics tdr
show cable-diagnostics tdr
To display the test results for the Time Domain Reflectometry (TDR) cable diagnostics, use the
showcable-diagnosticstdrcommand in privileged EXEC mode.
show cable-diagnostics tdr interface interface interface-number
Syntax Description interface interface Specifies the interface type; valid values arefastethernet and gigabitethernet.
interface-number Module and port number.
Command Default This command has no default settings.
Command Modes Privileged EXEC
Command History Release Modification
12.2(17a)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(18)SXD The output was changed as follows:
• The Local Pair field was changed to the Pair field. The local pair designations were
changed as follows:
• Pair A to Pair 1-2
• Pair B to Pair 3-4
• Pair C to Pair 5-6
• Pair D to Pair 7-8
• The Remote Pair field was removed.
• The Channel field was added to display the pair designation and are as follows:
• Pair A
• Pair B
• Pair C
• Pair D
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The showcable-diagnosticstdr command is supported on specific modules. See the Release Notes for Cisco
IOS Release 12.2 SX on the Catalyst 6500 and Cisco 7600 Supervisor Engine 720, Superivsor Engine 32,
and Supervisor Engine 2 for the list of the modules that support TDR.
In the event of an open or shorted cable, the accuracy of length of where the cable is open or shorted is plus
or minus 2 meters.
The pair length can be displayed in meters (m), centimeters (cm), or kilometers (km).
If the TDR test has not been run on the port, the following message is displayed:
Cisco IOS Interface and Hardware Component Command Reference
1120
service-module t1 linecode through show controllers satellite
show cable-diagnostics tdr
TDR test was never run on Gi2/12
Examples This example shows how to display the information about the TDR test:
Router# show cable-diagnostics tdr interface gigabitethernet 8/1
TDR test last run on: February 25 11:18:31
Interface Speed Pair Cable length Distance to fault Channel Pair status
--------- ----- ---- ------------------- ------------------- ------- ------------
Gi8/1 1000 1-2 1 +/- 6 m N/A Pair B Terminated
3-4 1 +/- 6 m N/A Pair A Terminated
5-6 1 +/- 6 m N/A Pair C Terminated
7-8 1 +/- 6 m N/A Pair D Terminated
The table below describes the fields in the showcable-diagnosticstdrcommand output.
Table 36: show cable-diagnostics tdr Command Output Fields
Field Description
Interface Interface tested.
Speed Current line speed.
Pair Local pair name.
Cable Length Cable length and accuracy. The accuracy unit is displayed in meters (m), centimeters (cm),
or kilometers (km).
Channel Pair designation.
Pair status Pair status displayed is one of the following:
• Terminated--The link is up.
• Shorted--A short is detected on the cable.
• Open--An opening is detected on the cable.
• Not Completed--The test on the port failed.
• Not Supported--The test on the port is not supported.
• Broken--The pair is bad--either open or shorted.
• ImpedanceMis--The impedance is mismatched.
• InProgress--The diagnostic test is in progress.
Related Commands Command Description
clear cable-diagnostics tdr Clears a specific interface or clear all interfaces that support TDR.
test cable-diagnostics Tests the condition of 10-Gigabit Ethernet links or copper cables on 48-port
10/100/1000 BASE-T modules.
Cisco IOS Interface and Hardware Component Command Reference
1121
service-module t1 linecode through show controllers satellite
show card-protection CPGN detail
show card-protection CPGN detail
To verify card protection configuration, use the show card-protection CPGN detail command.
Syntax Description Syntax Description:
There are no keywords.
Command Default There is no default.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
XE Everest This command was integarted into the Cisco NCS 4200 Series and Cisco ASR 900 Series.
16.7.1
Example:
Examples #show card-protection 4 detail
Working(0/1: ):
Number of LOS Alarms:0
ok,Active
1:1, non-revertive
Protect(0/2: ):
Number of LOS Alarms:0
ok,Inactive
1:1, non-revertive
Revert Timer : (Not Started)
Last switchover reason: Serdes
Cisco IOS Interface and Hardware Component Command Reference
1122
service-module t1 linecode through show controllers satellite
show catalyst6000
show catalyst6000
To display the information about the chassis, use the show catalyst6000 command in user EXEC or privileged
EXEC mode.
show catalyst6000 {all|chassis-mac-address|switching-clock|traffic-meter}
Syntax Description all Displays the MAC-address ranges and the current and peak traffic-meter reading.
chassis-mac-address Displays the MAC-address range.
switching-clock Displays the failure recovery mode of the switching clock.
traffic-meter Displays the percentage of the backplane (shared bus) utilization.
Command Default The default is all
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SXI The output of the show catalyst6000 traffic-meter command was changed to include traffic
monitor status information.
Usage Guidelines If you enter the switching-clock keywords, the output displays whether switching of the redundant clock
sources on the backplane is allowed if the active clock source fails.
There are either 64 or 1024 MAC addresses that are available to support the software features. You can enter
the show catalyst6000 chassis-mac-address command to display the MAC-address range on your chassis.
In Cisco IOS Release 12.2(33)SXI and later releases, the traffic monitor status information is displayed in the
output. In earlier releases, only the current and peak traffic-meter readings are displayed.
Examples This example shows how to display the MAC-address ranges and the current and peak traffic-meter
readings:
Router>
show catalyst6000 all
chassis MAC addresses: 64 addresses from 0001.6441.60c0 to 0001.6441.60ff
traffic meter = 0% Never cleared
peak = 0% reached at 08:14:38 UTC Wed Mar 19 2003
switching-clock: clock switchover and system reset is allowed
Router>
This example shows how to display the MAC-address ranges:
Cisco IOS Interface and Hardware Component Command Reference
1123
service-module t1 linecode through show controllers satellite
show catalyst6000
Router#
show catalyst6000 chassis-mac-address
chassis MAC addresses: 1024 addresses from 00d0.004c.1800 to 00d0.004c.1c00
Router#
The following example shows how to display the current and peak traffic-meter readings and the
traffic monitor status:
Router
>
show catalyst6000 traffic-meter
traffic meter = 0% Never cleared
peak = 0% reached at 10:54:49 UTC Wed Mar 19 2008
---=== Traffic Utilization Monitor Status ===---
State Interval Threshold MsgCount LastMsgTime
-----------------------------------------------------------------------------
Backplane Off 60s 80% 0 --
Fpoe#0 In Off 60s 80% 0 --
out Off 60s 80% 0 --
Fpoe#1 In Off 60s 80% 0 --
out Off 60s 80% 0 --
Fpoe#2 In Off 60s 80% 0 --
out Off 60s 80% 0 --
Fpoe#3 In Off 60s 80% 0 --
out Off 60s 80% 0 --
Fpoe#4 In Off 60s 80% 0 --
out Off 60s 80% 0 --
.
.
.
Fpoe#19 In Off 60s 80% 0 --
out Off 60s 80% 0 --
Router
>
This example shows how to display the failure recovery mode of the switching clock:
Router> show catalyst6000 switching-clock
switching-clock: clock switchover and system reset is allowed
Router>
Related Commands Command Description
monitor traffic-utilbackplane Enables the backplane traffic utilization monitor or sets the traffic monitor
interval.
monitor traffic-util fpoe Sets the fabric channel traffic utilization monitor to generate SYSLOG
messages.
show environment alarm Displays the information about the environmental alarm.
show fm summary Displays a summary of FM Information.
show environment status Displays the information about the operational FRU status.
Cisco IOS Interface and Hardware Component Command Reference
1124
service-module t1 linecode through show controllers satellite
show cem
show cem
To display circuit emulation (CEM) statistics, use the showcem command in privileged EXEC mode.
show cem {slot /port /channel|summary}
Syntax Description slot Slot number where the Circuit Emulation over IP (CEoIP) network module (NM) is installed
on the networking device.
/ port Port number on the CEoIP NM. The slash mark is required between the slot argument and the
port argument.
/ channel Channel number that identifies the channel that you want to configure (T1/E1 only). The channel
number on a serial port is always 0. The slash mark is required between the port argument and
the channel argument.
summary Displays summary CEM statistics.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.3(7)T This command was introduced.
12.4(2)T This command was modified. Output was modified to support enhanced adaptive clocking.
Examples The following example shows a summary of some of the configuration parameters of the CEM
channels.
Router# show cem summary
cem summary
cem 1/0/1 is up
Line state is up
Operational state is active
Near end ip address: 192.168.55.130, udp port: 15904
Far end ip address: 192.168.55.136, udp port: 15903
IP payload size: 144
IP dscp : 0x2E Idle pattern length: 8 , Idle Pattern: 0x55
Payload compression is disabled
Data protection is enabled
Dejitter buffer size is 120 ms
Channel clock rate is 512000 bps
CEIP header CRC is disabled
Signaling is enabled, onh:0x0 offh:0xF delay:2000 ms
Failure activation time is 2000 ms
Failure deactivation time is 2000 ms
Physical interface is T1 channelized
Ingress packets: 5044607, dropped: 0, overruns: 0, max_ipt: 3
Egress packets: 5039268, dropped: 0, lost pkts: 52792
Egress late pkts: 222
Egress overruns: 0, underruns: 0, ur_delay: 0, ur2pkt: 0
Egress pkts dropped by burst control: 0
Egress corrupt pkts rcvd: 0
Cisco IOS Interface and Hardware Component Command Reference
1125
service-module t1 linecode through show controllers satellite
show cem
cem info
30 second ingress rate 513523 bits/sec, 445 packets/sec
30 second egress rate 513100 bits/sec, 445 packets/sec
Tx interrupts: 5035243
Reorder queue flush: 3, visited: 6, max wait window: 4
Pkt-to-pkt jitter max: 141 ms, average: 2 ms, min: 0 ms
Dejitter buffer level max: 118 ms, min: 4 ms
Event history: 0x01830000 Pkts dropped by PCI burst limit: 0
The table below describes the significant fields shown in the display.
Table 37: show cem summary Field Descriptions
Field Description
CEM Displays the slot, port, and channel number of a CEM channel.
Current State Displays the current state of a CEM channel. The state can be one of the following:
• up--The channel is receiving valid packets from a source CEM channel.
• down--The channel is receiving no packets (for example, the dejitter buffer
is empty).
• shutdown--The CEM channel has been administratively shut down.
Line State Displays the current line state of a CEM channel. The line state can be one of the
following:
• up--The line is ready.
• down--The line is down. A T1 or E1 line is down when the line is experiencing
a physical-layer failure, such as loss of signal (LOS), loss of multiframe
alignment (OOF), or alarm indication signal (AIS). A serial line is down when
no cable is attached to the port.
Cisco IOS Interface and Hardware Component Command Reference
1126
service-module t1 linecode through show controllers satellite
show cem
Field Description
Operational State Displays the current operational state of a CEM channel. The operational state can
be one of the following:
• config-incomplete--The channel is in a config-incomplete state when any of
the following conditions exist:
• An xconnect is not defined.
• A local IP address is not defined.
• A local UDP port is not defined.
• A remote UDP port is not defined.
• The CEM channel is administratively shut down.
• enabled--If none of the conditions for the config-incomplete state exists, but
the CEM channel is receiving no packets from the remote side, the CEM
channel is in an enabled state.
• config-mismatch--If packets are arriving from the remote side but with a
different payload size, data protection setting, or compression setting, the
channel is in the config-mismatch state.
• active--The CEM channel is active if none of the conditions outlined above
exist.
Payload Size Payload size configured for the CEM channel, in bytes.
Payload Compression Displays whether payload compression is enabled or disabled for the CEM channel.
Data protection Displays whether data protection is enabled or disabled for the CEM channel.
MAX_IPT Maximum time between two consecutive ingress packets
Egress late packets Number of packets that arrive too late to be queued to the dejitter buffer. A packet
identified as late packet is discarded and substituted with an idle pattern.
ur_delay Delay in milliseconds from the last packet received to the occurrence of an underrun.
ur2pkt Delay in milliseconds from the occurrence of an underrun to the reception of the
next packet.
pkt-to-pkt-jitter max Maximum time between two consecutive egress packets
Dejitter buffer level max Maximum recorded level of the dejitter buffer in milliseconds.
Related Commands Commands Description
cem Enters circuit emulation configuration mode.
clear cem Clears CEM statistics.
Cisco IOS Interface and Hardware Component Command Reference
1127
service-module t1 linecode through show controllers satellite
show cem circuit
show cem circuit
To display the circuit emulation (CEM) statistics for the configured CEM circuits, use
theshowcemcircuitcommand in privileged EXEC mode.
show cem circuit [{cem-group-id|interface {CEM|Virtual-CEM} slot/subslot/port
cem-group-id|detail|summary}]
Syntax Description cem-group-id The group ID specified while creating the CEM group.
interface Displays detailed statistics for a CEM group configured on the specified CEM interface.
CEM Circuit emulation interface for the data traffic.
Virtual-CEM Virtual CEM interface created when out-of-band clock recovery is performed on a CEoP
SPA.
slot Slot where SIP-400 is installed.
/ subslot Slot where CEoP SPA is installed. The slash character is required between theslot argument
and the subslot argument.
/ port Port on the CEoP SPA.The slash character is required between the subslot argument and
the port argument.
detail Displays detailed statistics for all CEM groups.
summary Displays a summary of CEM groups, as well as their operational modes.
Command Modes Privileged EXEC(#)
Command History Release Modification
12.2(33)SRB This command was introduced.
15.1(2)SNG This command was implemented on Cisco ASR 901 Series Aggregation
Services Routers.
Cisco IOS XE Everest This command was implemented on the Cisco ASR 900 Series Routers, Cisco
16.5.1 ASR 920 Routers and Cisco NCS 4200 Series.
15.1(2)SNG This command was implemented on Cisco ASR 901 Series Aggregation
Services Routers.
Examples The following is sample output from the show cem circuit command:
Router# show cem circuit
CEM Int. ID Ctrlr Admin Circuit AC
--------------------------------------------------------------
CEM0/0 0 UP UP Enabled UP
CEM0/1 1 UP UP Enabled UP
CEM0/2 2 UP UP Enabled UP
Cisco IOS Interface and Hardware Component Command Reference
1128
service-module t1 linecode through show controllers satellite
show cem circuit
CEM0/3 3 UP UP Enabled UP
CEM0/4 4 UP UP Enabled UP
CEM0/5 5 UP UP Enabled UP
Router# show cem circuit 5
CEM0/5, ID: 5, Line: UP, Admin: UP, Ckt: Enabled
Controller state: up
Idle Pattern: 0xFF, Idle cas: 0x8
Dejitter: 4, Sample Rate: 1, Payload Size: 192
Framing: Framed, (DS0 channels: 1-24)
CEM Defects Set
None
Signalling: No CAS
RTP: No RTP
Ingress Pkts: 527521938 Dropped: 0
Egress Pkts: 527521938 Dropped: 0
CEM Counter Details
Input Errors: 0 Output Errors: 0
Pkts Missing: 0 Pkts Reordered: 0
Misorder Drops: 0 JitterBuf Underrun: 0
Error Sec: 0 Severly Errored Sec: 0
Unavailable Sec: 0 Failure Counts: 0
Pkts Malformed: 0
The following example shows output of the showcemcircuitcommand with the detail keyword.
Router# show cem circuit detail
CEM2/0/0, ID: 0, Line: UP, Admin: UP, Ckt: ACTIVE
Controller state: up, T1/E1 state: up
Idle Pattern: 0xFF, Idle CAS: 0x8
Dejitter: 5 (In use: 0)
Payload Size: 120
Framing: Framed (DS0 channels: 1-15)
CEM Defects Set
Excessive Pkt Loss Rate Packet Loss
Signalling: No CAS
RTP: No RTP
Ingress Pkts: 715207 Dropped: 0
Egress Pkts: 0 Dropped: 0
CEM Counter Details
Input Errors: 0 Output Errors: 0
Pkts Missing: 715234 Pkts Reordered: 0
Misorder Drops: 0 JitterBuf Underrun: 1
Error Sec: 0 Severly Errored Sec: 0
Unavailable Sec: 716 Failure Counts: 1
Pkts Malformed: 0 JitterBuf Overrun: 0
CEM2/0/0, ID: 1, Line: UP, Admin: UP, Ckt: ACTIVE
Controller state: up, T1/E1 state: up
Idle Pattern: 0xFF, Idle CAS: 0x8
Dejitter: 5 (In use: 0)
Payload Size: 128
Framing: Framed (DS0 channels: 16-31)
CEM Defects Set
Excessive Pkt Loss Rate Packet Loss
Signalling: No CAS
RTP: No RTP
Ingress Pkts: 2306 Dropped: 0
Egress Pkts: 0 Dropped: 0
CEM Counter Details
Input Errors: 0 Output Errors: 0
Pkts Missing: 2306 Pkts Reordered: 0
Misorder Drops: 0 JitterBuf Underrun: 1
Error Sec: 0 Severly Errored Sec: 0
Cisco IOS Interface and Hardware Component Command Reference
1129
service-module t1 linecode through show controllers satellite
show cem circuit
Unavailable Sec: 0 Failure Counts: 1
Pkts Malformed: 0 JitterBuf Overrun: 0
The table below describes significant fields shown in the showcemcircuit command display.
Table 38: show cem circuit Field Descriptions
Field Description
CEM Displays the slot, port, and channel number of a CEM channel.
ID Displays the value assigned to the CEM group while creating the CEM group.
Controller State Displays the current state of the controller that represents the CEoP SPA.
Idle Pattern Specifies the idle pattern that is transmitted on the physical link for any CEM packets
that are lost or dropped.
Idle CAS Specifies the default Channel Associated Signalling (CAS) pattern that is transmitted
in the CAS bits of the outgoing T1/E1 frames.
Dejitter Specifies the size of the dejitter buffer used to compensate for variable network delays
experienced by CEM packets.
Payload Size Specifies the number of payload bytes encapsulated into a single CEM packet.
Framing Specifies whether the CEM group is framed (CESoPSN) or unframed (SAToP).
CEM Defects Set Lists the defects that are currently active for the specified CEM group.
CEM Counter Details Lists the various counters for the CEM group.
Pkts Missing Specifies the total number of missing packets on the CEM group.
Pkts Reordered Specifies the number of packets that are arrived out of order on the egress node of
the CEM pseudowire and successfully reordered by the CEoP SPA.
Pkts Malformed Specifies the number of CEM packets that are detected as malformed and dropped.
Misorder Drops Specifies the number of packets that are dropped because they arrived out of order
and could not be reordered.
JitterBuf Underrun Specifies the number of times the CEoP SPA searches the dejitter buffer for a CEM
packet and fails.
JitterBuf Overrun Specifies the number of times a CEM packet arrived from the pseudowire is not
accommodated in the dejitter buffer because the buffer is full.
Error Sec Specifies the number of seconds in which any missing packet, reorder packet, jitter
buffer underrun, misorder dropped packet, or malformed packet is detected.
Severly Errored Sec Specifies the number of seconds in which more than one percent of the received CEM
packets are lost.
Unavailable Sec Specifies the number of seconds for which the CEM circuit is down due to a fault
condition.
Cisco IOS Interface and Hardware Component Command Reference
1130
service-module t1 linecode through show controllers satellite
show cem circuit
Field Description
Failure Counts Specifies the number of times the CEM circuit entered into the packet loss state.
Cisco IOS Interface and Hardware Component Command Reference
1131
service-module t1 linecode through show controllers satellite
show chassis
show chassis
To display processor and memory information, use the showchassis command in privileged EXEC mode.
show chassis [{clocks|slot slot-number [detail]|split|detail}]
Syntax Description clocks (Optional) Displays trunk (T1/E1) clock information.
slot slot-number (Optional) Displays slot-specific information.
split (Optional) Displays split-related data.
detail (Optional) Displays slot information
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(2)XB1 This command was introduced on the Cisco AS5850 universal gateway.
12.2(11)T This command was integrated into Cisco IOS Release 12.2(11)T.
15.0(1)M This command was modified in a release earlier than Cisco IOS Release 15.0(1)M. The detail
keyword was added. The clocks and split keywords were removed.
Usage Guidelines You must enter this command from one of the route-switch-controller (RSC) cards.
Use the showchassis command to display additional output relevant to handover-split mode. Command output
shows the RSC card to be configured with all slots of the entire chassis, regardless of configured ownership.
Slots owned by the peer RSC are shown in the ignore state, properly configured and ready to go.
Examples The following example shows output for a system in handover-split mode. Each RSC is shown to
be configured with all slots in the entire chassis, regardless of whether the RSC actually owns the
slot. Slots that are not owned by an RSC are shown to be in the ignore state. The RSC from which
the command is entered owns slots 0 to 5, but has configured for it all slots (0 to 5 and 8 to 13--all
slots except those in which the RSCs are inserted). Entries for slots 8 and 10 show the designator
“ignore.”
Router# show chassis
System is in handover-split mode, RSC in slot 6.
!
Slots owned: 0 1 2 3 4 5
Slots configured: 0 1 2 3 4 5 8 9 10 11 12 13
Slots owned by other: 8 9 10 11 12 13
Slot Board CPU DRAM I/O Memory State Elapsed
Type Util Total (free) Total (free) Time
5 UP324 0%/0% 26814176( 20%) 33554432( 45%) Up 01:02:54
8 CT3_UP216 0( 0%) 0( 0%) Ignore 01:05:19
10 UP324 0( 0%) 0( 0%) Ignore 01:05:19
The following example shows output for a system in classic-split mode. The RSC from which the
command is entered owns slots 0 to 5, and has configured for it only those same slots 0 to 5.
Cisco IOS Interface and Hardware Component Command Reference
1132
service-module t1 linecode through show controllers satellite
show chassis
Router# show chassis
System is in classic-split mode, RSC in slot 6.
Slots owned: 0 1 2 3 4 5
Slots configured: 0 1 2 3 4 5
Slots owned by other: 8 9 10 11 12 13
The following example shows details for the card in slot 0:
Router# show chassis slot 0
Slot: 0, Type: 24 E1 Ports (700)
CPU utilization: 0%/0% (5 secs); 0% (1 min); 0% (5 mins)
Memory: Total(b) Used(b) Free(b) Lowest(b) Largest(b)
Processor 59304928 16307688 42997240 42817836 42819352
I/O 67108864 8200288 58908576 58515056 58515004
State: IOS up; elapsed time in state: 13:28:35
Flags:
FB_FLAGS_PRESENT
FB_FLAGS_LINECARD
FB_FLAGS_ANALYZED
FB_FLAGS_CHECKPOINT
Inserted: 13:39:30 ago
Last update: 00:00:08 ago
The table below describes significant fields shown in this output.
Table 39: show chassis Fields Descriptions
Field Description
Slot Slot number.
Type Card type.
CPU utilization CPU usage in percentages.
Memory Current processor and I/O memory values.
State Current state of slot and time in hours, minutes, and seconds that the slot has spent in current
state.
Flags Displays a sequence of flag states that the slot has been through.
Inserted Time in hours, minutes, and seconds since the slot was inserted into the chassis.
Last Update Time in hours, minutes, and seconds since the last update message was sent.
Related Commands Command Description
show dial-shelf Displays information about dial shelves.
Cisco IOS Interface and Hardware Component Command Reference
1133
service-module t1 linecode through show controllers satellite
show class cem
show class cem
T o display the cem parameters configured for CEM class, use the showclasscemcommandin privilege exec
mode. A CEM class helps in configuring parameters in a template and applying parameters at the CEM
interface level on a CEOPS SPA.
show class cem [{name|all|detail}]
Syntax Description name Indicates the class name, specific to which the CEM parameter details are displayed.
all Displays the CEM parameter configuration details for all the classes.
detail Displays CEM parameters configured and additionally provides the circuits and interfaces inheriting
the respective class.
Command Default No default behavior or values.
Command Modes Privilege Exec Mode (Exec)
Command History Release Modification
Cisco IOS XE Release 3.3.0S This command was introduced.
Usage Guidelines The showclasscemcommand has been introduced on Cisco ASR 1000 Series Router in Cisco IOS XE Release
3.3. The showclasscemname command is used to view the CEM parameters configured for a specific classname.
To view the CEM parameters configured for all the CEM classes, use the showclasscemall command. To
view the circuits and interfaces inheriting the class and the CEM parameters configured, use the
showclasscemdetail command from privilege exec mode.
Examples The following example shows the command output for class parameters configured for a specific
class name:
Router# show class cem cemqos
Class: DUMMY, Dummy mode: user-defined, Dummy Pattern: 0x77
Class: 0/2/0
Dejitter: 320, Payload Size: 960
The following example shows the command output providing details of parameters configured for
all the classes and additionally shows the interfaces and circuits inheriting the class:
Router# show class cem detail
Class: DUMMY, Dummy mode: user-defined, Dummy Pattern: 0x77
Circuits inheriting this Class:
None
Interfaces inheriting this Class:
None
Class: 0/2/0
Dejitter: 320, Payload Size: 960
Circuits inheriting this Class:
None
Cisco IOS Interface and Hardware Component Command Reference
1134
service-module t1 linecode through show controllers satellite
show class cem
Interfaces inheriting this Class:
None
The following example shows the command output providing details of parameters configured for
all the classes:
Router# show class cem all
Class: cemqos , Dummy mode: last-frame
Dejitter: 20, Payload Size: 256
Router#show inter
Router#show interfaces cem 0/1/0
CEM0/1/0 is up, line protocol is up
Hardware is Circuit Emulation Interface
MTU 1500 bytes, BW 155520 Kbit/sec, DLY 0 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation CEM, loopback not set
Keepalive not supported
Last input never, output never, output hang never
Last clearing of "show interface" counters never
Input queue: 0/375/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue: 0/0 (size/max)
5 minute input rate 1022000 bits/sec, 745 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
2851672 packets input, 215070144 bytes, 0 no buffer
Received 0 broadcasts (0 IP multicasts)
0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 packets output, 0 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 unknown protocol drops
Related Commands Command Description
clear interface cem Clears the cem channel.
Cisco IOS Interface and Hardware Component Command Reference
1135
service-module t1 linecode through show controllers satellite
show compress
show compress
To display compression statistics, use the showcompress command in user EXEC or privileged EXEC mode.
show compressshow compress command
Syntax Description This command has no arguments or keywords.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
10.0 This command was introduced.
11.3 An example for hardware compression was added as implemented in the Canadian Standards
Association (CSA) hardware.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples The following is a sample output from the showcompress command when software compression is
used on the router:
Router# show compress
Serial0
uncompressed bytes xmt/rcv 10710562/11376835
1 min avg ratio xmt/rcv 2.773/2.474
5 min avg ratio xmt/rcv 4.084/3.793
10 min avg ratio xmt/rcv 4.125/3.873
no bufs xmt 0 no bufs rcv 0
resets 0
The table below describes the fields shown in the display.
Table 40: show compress Field Descriptions--Software Compression
Field Description
Serial0 Name and number of the interface.
uncompressed bytes xmt/rcv Total number of uncompressed bytes sent and received.
1 min avg ratio xmt/rcv Static compression ratio for bytes sent and received, averaged over 1, 5, and
10 minutes.
5 min avg ratio xmt/rcv
10 min avg ratio xmt/rcv
no bufs xmt Number of times buffers were not available to compress data being sent.
no bufs rcv Number of times buffers were not available to uncompress data being received.
Cisco IOS Interface and Hardware Component Command Reference
1136
service-module t1 linecode through show controllers satellite
show compress
Field Description
resets Number of resets (for example, line errors could cause resets).
The following is a sample output from the showcompress command when hardware compression
is enabled (that is, compression is implemented in the CSA hardware):
Router# show compress
Serial6/1
Hardware compression enabled
CSA in slot3 in use
Compressed bytes sent: 402 bytes 0 Kbits/sec ratio: 4.092
Compressed bytes recv: 390 bytes 0 Kbits/sec ratio: 3.476
restarts:1
last clearing of counters: 1278 seconds
The table below describes the fields shown in the display. The information displayed by the
showcompress command is the same for hardware and distributed compression. For Cisco 7200
series routers with multiple CSAs, an additional line is displayed indicating the CSA in use.
Table 41: show compress Field Descriptions--Hardware or Distributed Compression
Field Description
Serial6/1 Name and number of the interface.
Hardware compression enabled Type of compression.
CSA in slot3 in use Identifies the CSA that is performing compression service.
Compressed bytes sent Total number of compressed bytes sent including the kilobits per second.
Compressed bytes recv Total number of compressed bytes received including the kilobits per
second.
ratio Compression ratio for bytes sent and received since the link last came up
or since the counters were last cleared.
restarts Number of times the compression process restarted or reset.
last clearing of counters Duration since the last time the counters were cleared with the
clearcounterscommand.
Related Commands Command Description
compress Configures compression for LAPB, PPP, and HDLC encapsulations.
Cisco IOS Interface and Hardware Component Command Reference
1137
service-module t1 linecode through show controllers satellite
show controllers c3794
show controllers c3794
To display information about configuration of C37.94 controller, use the show controllers c3794 command
in global configuration mode.
Cisco 900 Series Routers
controllers c3794 slot/sub-slot/port
Syntax Description c3794 Controller type
slot Backplane slot number. The slot number for C37.94 controller is always 0.
sub-slot Physical sub-slot number. The range for sub-slot is 0-5.
port Port number of the controller. Valid numbers are 0 and 3. A forward slash mark (/) is required
between the slot argument and the port argument.
Command Modes Global configuration
Command History Release Modification
3.18.1SP This command was introduced.
Usage Guidelines This command displays controller status. The information displayed is generally useful for diagnostic tasks
performed by technical support personnel only. The command is used to display:
• Number of channels configured
• Number of channels received from tele-protection equipment
• Loss of Signal, if any
• Number of times LOS was set and cleared
• Path of Yellow, if any
• Number of times yellow alarm was set and cleared
Examples The following is sample output from the showcontrollers c3794 command on the Cisco 900 Series
Router:
Router# show controllers c3794
C3794 0/0/0 - (A900-IMA4C3794) is up
Configured Channels: 12
Peer Channels : 12
Alarm : Nil
Sending Y-Alarm to Peer Device : No
Receiving Y-Alarm from Peer Device : No
Cisco IOS Interface and Hardware Component Command Reference
1138
service-module t1 linecode through show controllers satellite
show controller dsl
show controller dsl
To display the DSL controller status and the statistics of a DSL port, use the showcontrollerdsl command in
privileged EXEC mode.
show controller dsl slot/port
Syntax Description slot Slot number of the DSL controller.
/ port Port number of the DSL controller. The slash (/) character is required and must be entered when
specifying the slot and port arguments.
Command Modes Privileged EXEC
Command History Release Modification
12.3(4)XD This command was introduced on Cisco 2600 series and Cisco 3700 series routers.
12.3(4)XG This command was integrated into Cisco IOS Release 12.3(4)XG on the Cisco 1700 series routers.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T on Cisco 2600 series, Cisco
3631, and Cisco 3700 series routers.
12.3(11)T This command was implemented on Cisco 2800 and Cisco 3800 series routers.
12.3(14)T This command was implemented on Cisco 1800 series routers.
Usage Guidelines This command is used to display the controller mode of the controller in the specified slot and port and to
display the statistics. Use this command in troubleshooting. Use the Cisco IOS help to find the valid slot and
port numbers.
Examples
Display for DSL Controller Configured in ATM 4-Wire Mode
The following example displays the status and statistics of the DSL controller in slot 1 and port 0
configured in ATM 4-wire mode:
Router# show controller dsl 1/0
DSL 1/0 controller UP
Globespan xDSL controller chipset
DSL mode:SHDSL Annex B
Frame mode:Utopia
Configured Line rate:4608Kbps
Line Re-activated 0 times after system bootup
LOSW Defect alarm:ACTIVE
CRC per second alarm:ACTIVE
Line termination:CO
FPGA Revision:0xAD
Line 0 statistics
Current 15 min CRC:0
Current 15 min LOSW Defect:0
Current 15 min ES:0
Cisco IOS Interface and Hardware Component Command Reference
1139
service-module t1 linecode through show controllers satellite
show controller dsl
Current 15 min SES:0
Current 15 min UAS:41
Previous 15 min CRC:0
Previous 15 min LOSW Defect:0
Previous 15 min ES:0
Previous 15 min SES:0
Previous 15 min UAS:0
Line 1 statistics
Current 15 min CRC:0
Current 15 min LOSW Defect:0
Current 15 min ES:0
Current 15 min SES:0
Current 15 min UAS:30
Previous 15 min CRC:0
Previous 15 min LOSW Defect:0
Previous 15 min ES:0
Previous 15 min SES:0
Previous 15 min UAS:0
Line-0 status
Chipset Version: 1
Firmware Version: A29733
Modem Status: Data, Status 1
Last Fail Mode: No Failure status:0x0
Line rate: 2312 Kbps
Framer Sync Status:In Sync
Rcv Clock Status:In the Range
Loop Attenuation: 0.600 dB
Transmit Power: 8.5 dB
Receiver Gain: 21.420 dB
SNR Sampling: 39.3690 dB
Line-1 status
Chipset Version: 1
Firmware Version: A29733
Modem Status: Data, Status 1
Last Fail Mode: No Failure status:0x0
Line rate: 2312 Kbps
Framer Sync Status:In Sync
Rcv Clock Status:In the Range
Loop Attenuation: 0.600 dB
Transmit Power: 8.5 dB
Receiver Gain: 21.420 dB
SNR Sampling: 39.1570 dB
Dying Gasp:Present
Display for DSL Controller Configured in T1 Mode
This example shows the display of a DSL controller that has been configured in T1 mode.
Router# show controller dsl 0/0
DSL 0/0 controller UP
SLOT 0:Globespan xDSL controller chipset
Line Mode:Two Wire
DSL mode:SHDSL Annex A
Frame mode:T1
Line Re-activated 0 times after system bootup
LOSW Defect alarm:ACTIVE
CRC per second alarm:ACTIVE
Line termination:CPE
FPGA Revision:0xA9
Current 15 min CRC:5
Current 15 min LOSW Defect:0
Cisco IOS Interface and Hardware Component Command Reference
1140
service-module t1 linecode through show controllers satellite
show controller dsl
Current 15 min ES:1
Current 15 min SES:0
Current 15 min UAS:570
Previous 15 min CRC:0
Previous 15 min LOSW Defect:0
Previous 15 min ES:0
Previous 15 min SES:0
Previous 15 min UAS:0
Line-0 status
Chipset Version: 1
Firmware Version: A29733
Modem Status: Data, Status 1
Last Fail Mode: No Failure status:0x0
Line rate: 1552 Kbps
Framer Sync Status:In Sync
Rcv Clock Status:In the Range
Loop Attenuation: 0.7800 dB
Transmit Power: 7.5 dB
Receiver Gain: 22.5420 dB
SNR Sampling: 35.6120 dB
Dying Gasp:Present
Annex Display When Line Is Trained
The following example shows the DSL controller annex display when the line is trained:
Router# show controller dsl 1/0
DSL 1/0 controller UP
SLOT 0: Globespan xDSL controller chipset
DSL mode: SHDSL Trained with Annex B-ANFP
Annex Display When Line Is Not Trained
The following example shows the DSL controller annex display when the line is not trained:
Router# show controller dsl 1/0
DSL 1/0 controller DOWN
SLOT 0: Globespan xDSL controller chipset
DSL mode: Not trained
The following table describes the significant fields of the showcontrollerdsl command.
Table 42: show controller dsl Field Descriptions
Field Description
DSL ... controller ... Describes the status of the controller in the indicated slot number.
DSL mode Displays the DSL mode of the controller.
Frame mode Displays the frame mode of the controller.
Configured Line rate Displays the line rate.
LOSW Defect alarm Displays the status of the LOSW alarm.
Cisco IOS Interface and Hardware Component Command Reference
1141
service-module t1 linecode through show controllers satellite
show controller dsl
Field Description
CRC per second alarm Displays the status of the CRC per second alarm.
Line termination Displays how the line is terminated.
Chipset Version Displays the version of the chipset.
Firmware Version Displays the version of the firmware.
Modem Status Displays the status of the modem.
Last Fail Mode Displays the last fail mode.
Line rate Displays the line rate.
Framer Sync Status Displays the framer synchronization status.
Rcv Clock Status Displays the revision clock status.
Loop Attenuation Displays the loop attenuation.
Transmit Power Displays the transmit power.
Receiver Gain Displays the receiver gain.
SNR Sampling Displays the signal-to-noise ratio sampling.
Related Commands Command Description
controller dsl Configures the controller status and the controller number.
Cisco IOS Interface and Hardware Component Command Reference
1142
service-module t1 linecode through show controllers satellite
show controller vdsl
show controller vdsl
To display VDSL controller related information, use the showcontrollervdsl command in privileged EXEC
mode.
show controller vdsl slot/subslot/portnumber [bit-alloc | brief | console | crash | datapath | delt-data| detailed
| gain-nsc | ipc | regs]
Syntax Description slot/subslot/port number Slot, subslot, and port number on the VDSL interface.
bit-alloc (Optional) Displays bit allocation NSC information.
brief (Optional) Displays brief information only.
console (Optional) Displays the console buffer.
crash (Optional) Displays slave CPU crash log.
datapath (Optional) Displays total datapath information.
delt-data (Optional) Displays the results of the delt command.
detailed (Optional) Displays all detailed information.
gain-nsc (Optional) Displays gain NSC information.
ipc (Optional) Displays ipc statistics.
regs (Optional) Displays the registers.
Command Default No default behavior or values
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)M1 This command was introduced.
Examples The following example shows output for this command:
router# show controller vdsl 0/0/0
Controller VDSL 0/0/0 is UP
Daemon Status: Up
XTU-R (DS) XTU-C (US)
Chip Vendor ID: 'BDCM' 'BDCM'
Chip Vendor Specific: 0x0000 0x0000
Chip Vendor Country: 0xB500 0xB500
Modem Vendor ID: 'CSCO' 'BDCM'
Modem Vendor Specific: 0x4602 0x0000
Modem Vendor Country: 0xB500 0xB500
Serial Number Near: FHH1327000CCISCO00000000
Serial Number Far:
Cisco IOS Interface and Hardware Component Command Reference
1143
service-module t1 linecode through show controllers satellite
show controller vdsl
Modem Version Near: 12.4(20090721:202255) [rahuld-t
Modem Version Far: 0x0000
Modem Status: TC Sync (Showtime!)
DSL Config Mode: AUTO
Trained Mode: G.993.2 (VDSL2)
TC Mode: PTM
DELT configuration: disabled
DELT state: not running
Trellis: ON OFF
Line Attenuation: 0.0 dB 0.0 dB
Signal Attenuation: 0.0 dB 0.0 dB
Noise Margin: 8.3 dB 8.2 dB
Attainable Rate: 78548 kbits/s 37743 kbits/s
Actual Power: 10.3 dBm 8.8 dBm
Per Band Status: D1 D2 D3 U0 U1 U2 U3
Line Attenuation(dB): 0.1 0.9 N/A 2.2 3.5 8.5 N/A
Signal Attenuation(dB): 0.1 0.9 N/A N/A 3.1 7.8 N/A
Noise Margin(dB): 8.3 8.2 N/A N/A 8.2 N/A N/A
Total FECS: 0 0
Total ES: 0 4
Total SES: 0 4
Total LOSS: 0 0
Firmware Source File Name (version)
-------- ------ -------------------
VDSL embedded VDSL_LINUX_DEV_01212008 (1)
Modem FW Version: 090706_1252-4.02L.01.AvC011b.d21j1
Modem PHY Version: AvC011b.d21j1
DS Channel1 DS Channel0 US Channel1 US Channel0
Speed (kbps): 0 72607 0 37425
Reed-Solomon EC: 0 0 0 0
CRC Errors: 0 0 0 0
The table below describes the significant fields of the showcontrollervdsl command.
Table 43: show controller vdsl Field Descriptions
Field Description
Daemon Status Current state of the VDSL daemon, the application that controls the VDSL2 line
and the modem state. The VDSL2 daemon can transition through the following
states: Reload, Start, Boot Init, Boot Code Download, Firmware Download, DSL
Mgmt Task Init, Admin State Check, Configuration, Establishing Link, DSL Line
Ready, and Up.
The VDSL2 daemon is in the “Up” state when the line reaches showtime.
Chip Vendor ID Identification code for the chipset vendor, made up of four ASCII characters. For
example, BDCM stands for Broadcom.
Chip Vendor Specific Chipset vendor-specific code made up of four hexadecimal digits as specified in
ITU standard. This field is used for ITU standard modes exclusively.
Chip Vendor Country Country code where the vendor is located. This field is used for ITU standard
modes exclusively.
Modem Vendor ID Identification code for the modem equipment vendor, made up of four ASCII
characters. For example, CSCO stands for Cisco.
Modem Vendor Specific Modem equipment vendor specific code made up of four hexadecimal digits.
Cisco IOS Interface and Hardware Component Command Reference
1144
service-module t1 linecode through show controllers satellite
show controller vdsl
Field Description
Modem Vendor Country Country code where the modem system vendor is located. This field is used for
ITU standard modes exclusively.
Serial Number Near Serial identification number, which is made up of 11 characters for serial number,
8 characters for platform id, and 11 characters for the version.
For example, FOC135145AS 3925-CHA 15.1(2.10)T
The 11 characters for the serial number include the modem equipment serial
number, modem equipment model, and modem equipment firmware version.
Serial Number Far Serial identification number of the DSLAM is displayed if it is available from the
DSLAM.
Modem Version Near Modem equipment software version information. It is the IOS version string.
Modem Version Far Software version of the DSLAM is displayed if it is available from the DSLAM.
Modem Status Current state of the VDSL2 modem. It can be one of the following states: Line
NOT initialized, Line Exception, Idle Request, Silent Request, Line Silent,
Handshake, Line FullInit, Discovery, Training, Analysis, Exchange, No Sync, TC
Sync (Showtime!), Fast Retrain, Low Power L2, Loop Diagnostics Active, Loop
Diagnostics Data Exchange, Loop Diagnostics Data Request, Loop Diagnostics
Complete, Resync, Test, Test Loop, Test Reverb, Test Medley, Low Power L3,
or Unknown.
DSL Config Mode VDSL2 line configuration mode. For the HWIC-1VDSL, only Auto mode is
supported.
Trained Mode ITU-T mode in which the VDSL2 line trained up. For the HWIC-1VDSL only
G.993.2 (VDSL2) mode is supported.
TC Mode Layer 2 mode for the VDSL line. For HWIC-1VDSL, only PTM mode is supported.
DELT configuration Dual Ended Loop Test configuration status, if the feature is enabled.
DELT state Actual State of Dual Ended Loop Test. The values can be one of the following:
Successful, Failed, Not Running, In Progress, or Unknown.
Trellis Actual State of Dual Ended Loop Test. The values can be one of the following:
Successful, Failed, Not Running, In Progress, or Unknown.
Line Attenuation Aggregate value of Line Attenuation across the subcarriers of all VDSL2 bands.
Signal Attenuation Aggregate value of Signal Attenuation across the subcarriers of all VDSL2 bands.
Noise Margin Aggregate value of Signal-to-Noise Ratios (SNR) values across the subcarriers
of all VDSL2 bands.
Attainable Rate Maximum net data rate, in bits, currently attainable by the CPE receiver and
DSLAM transmitter.
Cisco IOS Interface and Hardware Component Command Reference
1145
service-module t1 linecode through show controllers satellite
show controller vdsl
Field Description
Actual Power Measured total output power when the line is trained up. When the line is down,
the last measured power is given.
Line Attenuation (dB) For a band in the downstream direction, it is the measured difference in the total
power transmitted by the DSLAM (xTU-C) and the total power received by the
CPE (xTU-R) over all sub-carriers of that band during initialization.
For a band in the upstream direction, it is the measured difference in the total
power transmitted by the xTU-R and the total power received by the xTU-C over
all sub-carriers of that band during initialization.
Signal Attenuation (dB) For a band in the downstream direction, it is the measured difference in the total
power transmitted by the DSLAM(xTU-C) and the total power received by the
CPE(xTU-R) over all sub-carriers of that band during Showtime.
For a band in the upstream direction, it is the measured difference in the total
power transmitted by the xTU-R and the total power received by the xTU-C over
all sub-carriers of that band during Showtime
Noise Margin (dB) SNR Margin is the maximum increase of the noise power (in dB) received at the
xTU (xTU-R for a band in the downstream direction and xTU-C for a band in the
upstream direction), such that the Bit Error Rate (BER) requirements are met for
all bearer channels received at the xTU.
Total FECS Cumulative count during which there is at least one Forward Error Correction
(FEC) event on the VDSL2 line.
Total ES Cumulative count during which there is at least one Errored Second (ES) event
on the VDSL2 line.
Total SES Cumulative count during which there is at least one Severely Errored Second
(SES) event on the VDSL2 line.
Total LOSS Cumulative count, in seconds, during which there is at least one Loss of Signal
(LOS) event on the VDSL2 line.
Modem FW Version Comprehensive firmware version information for the modem, which includes the
Operating System version, the VDSL2 PHY version, and the VDSL2 driver version.
Modem PHY Version Modem firmware Version information, which includes the VDSL2 PHY and the
VDSL2 driver.
Speed (kbps) Actual trained line rate as measured in kbps.
Reed-Solomon EC Number of VDSL2 superframes that have at least one Reed-Solomon correction
action in one of its data frames. Reed-Solomon ECs do not affect service
performance.
CRC Errors Number of superframes that have an incorrect CRC. CRC errors do affect service
performance.
Cisco IOS Interface and Hardware Component Command Reference
1146
service-module t1 linecode through show controllers satellite
show controller vdsl
Related Commands Command Description
clear controller vdsl Resets the VDSL line related counters.
Cisco IOS Interface and Hardware Component Command Reference
1147
service-module t1 linecode through show controllers satellite
show controllers analysis-module
show controllers analysis-module
To display controller information for the analysis module interface, use the showcontrollersanalysis-module
command in user EXEC or privileged EXEC mode.
show controllers analysis-module slot/unit
Syntax Description slot Number of the router chassis slot for the network module.
/ unit Number of the daughter card on the network analysis module (NAM). For NAM, always use 0.
The slash (/) between the slot and unit arguments is required.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.3(4)XD This command was introduced on the following platforms: Cisco 2600XM series, Cisco 2691,
Cisco 3660, Cisco 3725, and Cisco 3745.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T.
12.3(8)T4 This command was implemented on the following platforms: Cisco 2811, Cisco 2821, and Cisco
2851.
12.3(11)T This command was implemented on the Cisco 3800 series.
Usage Guidelines The output from this command is generally useful for diagnostic tasks performed by technical support only.
Nevertheless, you can use the displayed HARDWARE STATISTICS information to obtain the receive and
transmit packet statistics that are collected by the hardware controller during packet processing.
Examples The following example shows how to display controller information for the analysis module interface
when the NAM is installed in router slot 2:
Router# show controllers analysis-module 2/0
Interface Analysis-Module2/0
Hardware is Intel 82559 FastEthernet
IDB: 64AD5AB0, FASTSEND: 609A0494, MCI_INDEX: 0
INSTANCE=0x64AD7278
Rx Ring entries = 64
Rx Shadow = 0x64AD741C
Rx Ring = 0x F7C9FE0
Rx Ring Head = 32
Rx Ring Last = 31
Rx Buffer Descr = 0x F7CA420
Rx Buffer Descr Head = 32
Rx Buffer Descr Last = 31
Rx Shadow (malloc) = 0x64AD741C
Rx Ring (malloc) = 0x4F7C9FE0
Rx Buffer Descr (malloc) = 0x4F7CA420
Tx Ring entries = 128
Tx Shadow = 0x64AD754C
Cisco IOS Interface and Hardware Component Command Reference
1148
service-module t1 linecode through show controllers satellite
show controllers analysis-module
Tx Shadow Head = 117
Tx Shadow Tail = 117
Tx Shadow Free = 128
Tx Ring = 0x F7CA860
Tx Head = 19
Tx Last = 18
Tx Tail = 19
Tx Count = 0
Tx Buffer Descr = 0x F7CB8A0
Tx Buffer Descr Head = 0
Tx Buffer Descr Tail = 0
Tx Shadow (malloc) = 0x64AD754C
Tx Ring (malloc) = 0x4F7CA860
Tx Buffer Descr (malloc) = 0x4F7CB8A0
CONTROL AND STATUS REGISTERS (CSR)=0x3E000000
SCB Intr Mask = 00
SCB CU/RU Cmd = 00
SCB Intr Status = 00
SCB CU Status = 01
SCB RU Status = 04
SCB General Ptr = 00000000
PORT = 00000000
EEPROM = 0008
FLASH = 0002
MDI = 1821782D
Rx Byte Count = 00000608
PMDR = 80
FC Cmd = 00
FC Threshold = 03
Early Rx = 00
General Status = 07
General Control = 00
PHY REGISTERS
Register 0x00: 1000 782D 02A8 0154 0501 45E1 0003 0000
Register 0x08: 0000 0000 0000 0000 0000 0000 0000 0000
Register 0x10: 0203 0000 0001 0000 0000 0000 0000 0000
Register 0x18: 0001 0000 8B10 0000 0000 0000 0000 0000
HARDWARE STATISTICS
Rx good frames: 800
Rx CRC: 0
Rx alignment: 0
Rx resource: 0
Rx overrun: 0
Rx collision detects: 0
Rx short: 0
Tx good frames: 614125
Tx maximum collisions: 0
Tx late collisions: 0
Tx underruns: 0
Tx lost carrier sense: 164
Tx deferred: 0
Tx single collisions: 0
Tx multiple collisions: 0
Tx total collisions: 0
FC Tx pause: 0
FC Rx pause: 0
FC Rx unsupported: 0
INTERRUPT STATISTICS
CX = 613298
FR = 805
CNA = 0
RNR = 0
MDI = 0
SWI = 0
Cisco IOS Interface and Hardware Component Command Reference
1149
service-module t1 linecode through show controllers satellite
show controllers analysis-module
FCP = 0
Receive All Multicasts = enabled
Receive Promiscuous = disabled
Loopback Mode = disabled
The table below describes the significant fields shown in the display.
Table 44: show controllers analysis-module Field Descriptions
Field Description
Hardware is Description of the chip being used.
IDB, FASTSEND Address in router memory of the Interface Descriptor Block (IDB) and
the fastsend routine.
INSTANCE Device-specific data stored in router memory that lists the memory
locations and current indexes of receive (Rx) and transmit (Tx) rings in
router I/O memory.
CONTROL AND STATUS Control and status registers that are physically located on the chip itself
REGISTERS (CSR) and that are accessed by the CPU over the Peripheral Component
Interconnect (PCI) bus.
PHY REGISTERS Contents of the PHY registers. PHY is a device that interfaces the
physical Ethernet line and that is located between the chip and the
physical line.
HARDWARE STATISTICS Receive (Rx) and transmit (Tx) traffic statistics collected by the chip.
INTERRUPT STATISTICS Transmit (Tx), Receive (Rx), control, software, and flow control interrupt
statistics collected by the chip.
Related Commands Command Description
service-module analysis-module status Displays hardware and software status information about the
NM-NAM.
show interfaces analysis-module Displays status, traffic data, and configuration information about
the analysis module interface.
Cisco IOS Interface and Hardware Component Command Reference
1150
service-module t1 linecode through show controllers satellite
show controllers cbus
show controllers cbus
To display all information under the cBus controller card including the capabilities of the card and reports
controller-related failures, use the showcontrollerscbus command in privileged EXEC mode on the Cisco
7500 series routers.
show controllers cbus
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
12.4(16) The showcontrollerscbus command output display was modified to allow users to monitor
IPC buffer limits when debugcbusipc is enabled. The showcontrollerscbus command output
display on the 7500 will now have a new line added under each VIP slot that begins with
ipcacc. The status line indicates the current ipc accumulator value and its initial limit assigned.
Examples
Cisco 7500 Series Router with VIP2 Card Example
The following is a partial output from the showcontrollerscbus command on a Cisco 7500 series
router with one Versatile Interface Processor version 2 (VIP2) card. This example does not show
output from additional interface processors that are usually installed in a Cisco 7500 series router.
Router# show controllers cbus
MEMD at 40000000, 2097152 bytes (unused 2752, recarves 1, lost 0)
RawQ 48000100, ReturnQ 48000108, EventQ 48000110
BufhdrQ 48000138 (2849 items), LovltrQ 48000150 (42 items, 1632 bytes)
IpcbufQ 48000158 (32 items, 4096 bytes)
3570 buffer headers (48002000 - 4800FF10)
pool0: 15 buffers, 256 bytes, queue 48000140
pool1: 368 buffers, 1536 bytes, queue 48000148
pool2: 260 buffers, 4544 bytes, queue 48000160
pool3: 4 buffers, 4576 bytes, queue 48000168
slot1: VIP2, hw 2.2, sw 200.50, ccb 5800FF30, cmdq 48000088, vps 8192
software loaded from system
FLASH ROM version 255.255
Fast Ethernet1/0/0, addr 0000.0c41.6c20 (bia 0000.0c41.6c20)
gfreeq 48000148, lfreeq 480001D0 (1536 bytes), throttled 0
rxlo 4, rxhi 30, rxcurr 0, maxrxcurr 0
txq 48001A00, txacc 48001A02 (value 0), txlimit 20
Ethernet1/1/0, addr 0000.0c41.6c28 (bia 0000.0c41.6c28)
gfreeq 48000148, lfreeq 480001D8 (1536 bytes), throttled 0
rxlo 4, rxhi 30, rxcurr 0, maxrxcurr 0
Cisco IOS Interface and Hardware Component Command Reference
1151
service-module t1 linecode through show controllers satellite
show controllers cbus
txq 48001A08, txacc 48001A0A (value 0), txlimit 20
Ethernet1/1/1, addr 0000.0c41.6c29 (bia 0000.0c41.6c29)
gfreeq 48000148, lfreeq 480001E0 (1536 bytes), throttled 0
rxlo 4, rxhi 30, rxcurr 0, maxrxcurr 0
txq 48001A10, txacc 48001A12 (value 0), txlimit 20
Ethernet1/1/2, addr 0000.0c41.6c2a (bia 0000.0c41.6c2a)
gfreeq 48000148, lfreeq 480001E8 (1536 bytes), throttled 0
rxlo 4, rxhi 30, rxcurr 0, maxrxcurr 0
txq 48001A18, txacc 48001A1A (value 0), txlimit 20
Ethernet1/1/3, addr 0000.0c41.6c2b (bia 0000.0c41.6c2b)
gfreeq 48000148, lfreeq 480001F0 (1536 bytes), throttled 0
rxlo 4, rxhi 30, rxcurr 0, maxrxcurr 0
txq 48001A20, txacc 48001A22 (value 0), txlimit 20
Ethernet1/1/4, addr 0000.0c41.6c2c (bia 0000.0c41.6c2c)
gfreeq 48000148, lfreeq 480001F8 (1536 bytes), throttled 0
rxlo 4, rxhi 30, rxcurr 0, maxrxcurr 0
txq 48001A28, txacc 48001A2A (value 0), txlimit 20
Ethernet1/1/5, addr 0000.0c41.6c2d (bia 0000.0c41.6c2d)
gfreeq 48000148, lfreeq 48000200 (1536 bytes), throttled 0
rxlo 4, rxhi 30, rxcurr 0, maxrxcurr 0
txq 48001A30, txacc 48001A32 (value 0), txlimit 20
Ethernet1/1/6, addr 0000.0c41.6c2e (bia 0000.0c41.6c2e)
gfreeq 48000148, lfreeq 48000208 (1536 bytes), throttled 0
rxlo 4, rxhi 30, rxcurr 0, maxrxcurr 0
txq 48001A38, txacc 48001A3A (value 0), txlimit 20
Ethernet1/1/7, addr 0000.0c41.6c2f (bia 0000.0c41.6c2f)
gfreeq 48000148, lfreeq 48000210 (1536 bytes), throttled 0
rxlo 4, rxhi 30, rxcurr 0, maxrxcurr 0
txq 48001A40, txacc 48001A42 (value 0), txlimit 20
Packet-Over_SONET Interface Processor Example
The following is a partial output from the showcontrollerscbus command for a Packet-Over-SONET
Interface Processor (POSIP) in slot 0; its single Packet OC-3 interface is Posi0/0.
Router# show controllers cbus
slot0: POSIP, hw 2.1, sw 200.01, ccb 5800FF30, cmdq 48000080, vps 8192
software loaded from flash slot0:rsp_posip.new
FLASH ROM version 160.4, VPLD version 2.2
Posi0/0, applique is SONET
gfreeq 48000148, lfreeq 48000158 (4480 bytes), throttled 0
rxlo 4, rxhi 226, rxcurr 0, maxrxcurr 186
txq 48000160, txacc 48000082 (value 150), txlimit 150
Multichannel Interface Processor Example
The following is partial output from the showcontrollerscbus command for a Multichannel Interface
Processor (MIP). Not all of the 23 channels defined on serial interface 1/0 are shown.
Router# show controllers cbus
slot1: MIP, hw 1.1, sw 205.03, ccb 5800FF40, cmdq 48000088, vps 8192
software loaded from system
T1 1/0, applique is Channelized T1
gfreeq 48000130, lfreeq 480001B0 (1536 bytes), throttled 0
rxlo 4, rxhi 360, rxcurr 0, maxrxcurr 3
Serial1/0:0, txq 480001B8, txacc 48000082 (value 3), txlimit 3
Serial1/0:1, txq 480001B8, txacc 4800008A (value 3), txlimit 3
Serial1/0:2, txq 480001B8, txacc 48000092 (value 3), txlimit 3
Cisco IOS Interface and Hardware Component Command Reference
1152
service-module t1 linecode through show controllers satellite
show controllers cbus
Serial1/0:3, txq 480001B8, txacc 4800009A (value 3), txlimit 3
Serial1/0:4, txq 480001B8, txacc 480000A2 (value 3), txlimit 3
Serial1/0:5, txq 480001B8, txacc 480000AA (value 3), txlimit 3
Serial1/0:6, txq 480001B8, txacc 480000B2 (value 3), txlimit 3
Serial1/0:7, txq 480001B8, txacc 480000BA (value 3), txlimit 3
The table below describes significant fields in the per-slot part of these displays.
Table 45: show controllers cbus Command--Per-Slot Field Descriptions
Field Description
slot1 Slot location of the specific interface processor (in this case
Packet-over-SONET Interface Processor).
hw Version number of the card.
sw Version number of the card’s internal software (in ROM).
software loaded from Source device and file name from which the router software was loaded.
FLASH ROM version VPLD Version of Flash ROM.
version
Pos1/0, applique is SONET Location of the specific interface and the hardware applique type (in this case
a Packet OC-3 interface).
gfreeq Location of the global free queue that is shared among similar interfaces.
lfreeq Location of the local free queue, which is a private queue of MEMD buffers.
throttled Number of times input packet processing has been throttled on this interface.
rxlo Minimum number of MEMD buffers held on local free queue. When idle,
the interface returns buffers from its local queue to the global free queue until
only this number of buffers remain in the local queue.
rxhi Maximum number of MEMD buffers that the interface can remove from the
global free queue in order to populate its local queue.
rxcurr Number of MEMD buffers currently on the local free queue.
maxrxcurr Maximum number of MEMD buffers that were enqueued on the local free
queue.
txq Address of the transmit queue.
txacc Address of the transmit queue accumulator.
txlimit Maximum number of buffers allowed in the transmit queue.
Cisco 7500 Series Router Example
The following is sample output from the showcontrollerscbus command on a Cisco 7500 series
router:
Cisco IOS Interface and Hardware Component Command Reference
1153
service-module t1 linecode through show controllers satellite
show controllers cbus
Router# show controllers cbus
cBus 1, controller type 3.0, microcode version 2.0
128 Kbytes of main memory, 32 Kbytes cache memory
40 1520 byte buffers, 14 4484 byte buffers
Restarts: 0 line down, 0 hung output, 0 controller error
HSCI 1, controller type 10.0, microcode version 129.3
Interface 6 - Hssi0, electrical interface is Hssi DTE
5 buffer RX queue threshold, 7 buffer TX queue limit, buffer size 1520
ift 0004, rql 2, tq 0000 0000, tql 7
Transmitter delay is 0 microseconds
MEC 3, controller type 5.1, microcode version 130.6
Interface 18 - Ethernet2, station address 0000.0c02.a03c (bia 0000.0c02.a03c)
10 buffer RX queue threshold, 7 buffer TX queue limit, buffer size 1520
ift 0000, rql 10, tq 0000 0000, tql 7
Transmitter delay is 0 microseconds
Interface 19 - Ethernet3, station address 0000.0c02.a03d (bia 0000.0c02.a03d)
10 buffer RX queue threshold, 7 buffer TX queue limit, buffer size 1520
ift 0000, rql 10, tq 0000 0000, tql 7
Transmitter delay is 0 microseconds
The table below describes the fields shown in the following lines of output.
cBus 1, controller type 3.0, microcode version 2.0
128 Kbytes of main memory, 32 Kbytes cache memory
40 1520 byte buffers, 14 4484 byte buffers
Restarts: 0 line down, 0 hung output, 0 controller error
Table 46: show controllers cbus Field Descriptions--Part 1
Field Description
cBus 1 Card type and number (varies depending on card).
controller type 3.0 Version number of the card.
microcode version 2.0 Version number of the card’s internal software (in ROM).
128 Kbytes of main memory Amount of main memory on the card.
32 Kbytes cache memory Amount of cache memory on the card.
40 1520 byte buffers Number of buffers of this size on the card.
14 4484 byte buffers Number of buffers of this size on the card.
Restarts Count of restarts for the following conditions:
• 0 line down • Communication line down
• 0 hung output • Output unable to transmit
• 0 controller error • Internal error
The table below describes the fields shown in the following lines of output:
HSCI 1, controller type 10.0, microcode version 129.3
Interface 6 - Hssi0, electrical interface is Hssi DTE
5 buffer RX queue threshold, 7 buffer TX queue limit, buffer size 1520
Cisco IOS Interface and Hardware Component Command Reference
1154
service-module t1 linecode through show controllers satellite
show controllers cbus
ift 0004, rql 2, tq 0000 0000, tql 7
Transmitter delay is 0 microseconds
Table 47: show controllers cbus Field Descriptions--Part 2
Field Description
HSCI 1 Card type and number (varies depending on card).
controller type 10.0 Version number of the card.
microcode version 129.3 Version number of the card’s internal software (in ROM).
Interface 6 Physical interface number.
Hssi 0 Logical name for this interface.
electrical interface is Hssi DTE Self-explanatory.
5 buffer RX queue threshold Maximum number of buffers allowed in the receive queue.
7 buffer TX queue limit Maximum number of buffers allowed in the transmit queue.
buffer size 1520 Size of the buffers on this card (in bytes).
ift 0004 Interface type code:
• 0 = EIP
• 1 = FSIP
• 4 = HIP
• 5 = TRIP
• 6 = FIP
• 7 = AIP
rql 2 Receive queue limit. Current number of buffers allowed for the receive
queue. It is used to limit the number of buffers used by a particular
inbound interface. When equal to 0, all of that interface’s receive
buffers are in use.
tq 0000 0000 Transmit queue head and tail pointers.
tql 7 Transmit queue limit. Current number of buffers allowed for transmit
queue. It limits the maximum cBus buffers allowed to sit on a particular
interface’s transmit queue.
Transmitter delay is 0 microseconds Transmitter delay between the packets.
Cisco IOS Interface and Hardware Component Command Reference
1155
service-module t1 linecode through show controllers satellite
show controllers cbus
ATM Interface Processor Example
The following is a sample output from the showcontrollerscbus command for an ATM Interface
Processor (AIP) installed in IP slot 4. The running AIP microcode is Version 170.30, the physical
layer interface module (PLIM) type is 4B/5B, and the available bandwidth is 100 Mbps:
Router# show controllers cbus
Switch Processor 5, hardware version 11.1, microcode version 170.46
Microcode loaded from system
512 Kbytes of main memory, 128 Kbytes cache memory
60 1520 byte buffers, 91 4496 byte buffers
Restarts: 0 line down, 0 hung output, 0 controller error
AIP 4, hardware version 1.0, microcode version 170.30
Microcode loaded from system
Interface 32 - ATM4/0, PLIM is 4B5B(100Mbps)
15 buffer RX queue threshold, 36 buffer TX queue limit, buffer size 4496
ift 0007, rql 12, tq 0000 0620, tql 36
Transmitter delay is 0 microseconds
Service Provider MultiChannel Interface Processor Example
The following is sample output from the showcontrollerscbus command for the Service Provider
MultiChannel Interface Processor (SMIP):
Router# show controllers cbus
SMIP 2, hardware version 1.0, microcode version 10.0
Microcode loaded from system
Interface 16 - T1 2/0, electrical interface is Channelized T1
10 buffer RX queue threshold, 14 buffer TX queue limit, buffer size 1580 ift 0001, rql
7, tq 0000 05B0, tql 14
Transmitter delay is 0 microseconds
Per-Slot Limits on IPC Example
The following example shows the current value of the IPC accumulator used for RSP-to-VIP
communication along with the initial value of the IPC accumulator assigned to that particular VIP.
The IPC accumulator shows the buffers for IPC packets and is analogous to the tx accumulator used
for data packets.
Router# show controllers cbus
MEMD at E0000000, 2097152 bytes (unused 2880, recarves 1, lost/qaerror recoveries 0/0)
RawQ E8000100, ReturnQ E8000108, EventQ E8000110, IpcackQ E8000118, VIP_CrashinfoQ E8000128
IpcSlaveackQ E8000120
BufhdrQ E8000150 (2893 items), LovltrQ E8000168 (64 items, 2016 bytes)
IpcbufQ E8000178 (32 items, 4096 bytes)
IpcbufQ_classic E8000170 (8 items, 4096 bytes)
3569 buffer headers (E8002000 - E800FF00)
pool0: 9 buffers, 256 bytes, queue E8000158
pool1: 298 buffers, 1536 bytes, queue E8000160
pool2: 261 buffers, 4544 bytes, queue E8000180
pool3: 4 buffers, 4576 bytes, queue E8000188
slot1: VIP2 R5K, hw 2.00, sw 22.20, ccb F800FF20, cmdq E8000088, vps 8192
software loaded from system
Copyright (c) 1986-2005 by Cisco Systems, Inc.
Cisco IOS Interface and Hardware Component Command Reference
1156
service-module t1 linecode through show controllers satellite
show controllers cbus
ROM Monitor version 115.0
ipcacc E8000082 (value 17), ipclimit 36
FastEthernet1/0/0, addr 0050.0b35.5820 (bia 0050.0b35.5820)
gfreeq E8000160, lfreeq E8000190 (1536 bytes)
rxlo 4, rxhi 123, rxcurr 0, maxrxcurr 0
txq E8001A00, txacc E8001A02 (value 0), txlimit 33
ATM1/1/0, applique is OC3 (155000Kbps)
gfreeq E8000180, lfreeq E8000198 (4544 bytes)
rxlo 4, rxhi 261, rxcurr 0, maxrxcurr 0
txq E8001A08, txacc E8001A0A (value 0), txlimit 174
slot2: VIP4-50 RM5271, hw 2.01, sw 22.20, ccb F800FF30, cmdq E8000090, vps 8192
software loaded from system
Copyright (c) 1986-2005 by Cisco Systems, Inc.
ROM Monitor version 103.0
ipcacc E800008A (value 36), ipclimit 36
ATM2/0/0, applique is SONET (155000Kbps)
show controllers cbus Display With a Filter Applied to Customize the Display
The following example shows the IPC statistics. The showcontrollerscbus command output display
on the 7500 includes a line under the entry for each VIP slot that begins with ipcacc. The status line
indicates the current IPC accumulator value and its initial limit assigned.
Router# show controllers cbus | include ipc|slot
slot1: VIP2 R5K, hw 2.00, sw 22.20, ccb F800FF20, cmdq E8000088, vps 8192
ipcacc E8000082 (value 6), ipclimit 36
slot2: VIP4-50 RM5271, hw 2.01, sw 22.20, ccb F800FF30, cmdq E8000090, vps 8192
ipcacc E800008A (value 36), ipclimit 36
slot3: VIP2 R5K, hw 2.00, sw 22.20, ccb F800FF40, cmdq E8000098, vps 8192
ipcacc E8000092 (value 6), ipclimit 36
When the IPC acc reaches 10% of the IpcbufQ limit, a rate-limited warning message will be displayed
if the debugcbusipc comamnd is enabled:
%RSP-6-IPC_STUCK: Ipcacc for slot 1 has reached 7% of its Ipclimit
Cisco IOS Interface and Hardware Component Command Reference
1157
service-module t1 linecode through show controllers satellite
show controllers content-engine
show controllers content-engine
To display controller information for content engine (CE) network modules, use the
showcontrollerscontent-engine command in privileged EXEC mode.
show controllers content-engine slot/unit
Syntax Description slot Number of the router chassis slot for the network module.
/ unit Number of the daughter card on the network module. For CE network modules, always use 0. The
slash (/) character is required when specifying the slot and unit arguments.
Command Modes Privileged EXEC
Command History Release Modification
12.2(11)YT This command was introduced.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.
Examples The following example displays controller information for the CE network module in router slot 1:
Router# show controllers content-engine 1/0
Interface Content-Engine1/0
Hardware is Intel 82559 FastEthernet
IDB: 82A92DC4, FASTSEND: 8021B488, MCI_INDEX: 0
INSTANCE=0x82A94534
Rx Ring entries = 64
Rx Shadow = 0x82A947A0
Rx Ring = 0x 3CB5160
Rx Ring Head = 14
Rx Ring Last = 13
Rx Buffer Descr = 0x 3CB55A0
Rx Buffer Descr Head = 14
Rx Buffer Descr Last = 13
Rx Shadow (malloc) = 0x82A947A0
Rx Ring (malloc) = 0x 3CB5160
Rx Buffer Descr (malloc) = 0x 3CB55A0
Tx Ring entries = 128
Tx Shadow = 0x82A948D0
Tx Shadow Head = 79
Tx Shadow Tail = 79
Tx Shadow Free = 128
Tx Ring = 0x 3CB59E0
Tx Head = 81
Tx Last = 80
Tx Tail = 81
Tx Count = 0
Tx Buffer Descr = 0x 3CB6A20
Tx Buffer Descr Head = 0
Tx Buffer Descr Tail = 0
Tx Shadow (malloc) = 0x82A948D0
Tx Ring (malloc) = 0x 3CB59E0
Tx Buffer Descr (malloc) = 0x 3CB6A20
Cisco IOS Interface and Hardware Component Command Reference
1158
service-module t1 linecode through show controllers satellite
show controllers content-engine
CONTROL AND STATUS REGISTERS (CSR)=0x40800000
SCB Intr Mask = 00
SCB CU/RU Cmd = 00
SCB Intr Status = 00
SCB CU/RU Status = 50
SCB General Ptr = 00000000
PORT = 00000000
EEPROM = 0008
FLASH = 0002
MDI = 1821782D
Rx Byte Count = 00000608
PMDR = 80
FC Cmd = 00
FC Threshold = 03
Early Rx = 00
General Status = 05
General Control = 00
PHY REGISTERS
Register 0x00: 1000 782D 02A8 0154 0441 45E1 0001 0000
Register 0x08: 0000 0000 0000 0000 0000 0000 0000 0000
Register 0x10: 0401 0000 0001 0000 0000 0000 0000 0000
Register 0x18: 0000 0000 8000 0000 0000 0000 0000 0000
HARDWARE STATISTICS
Rx good frames: 14
Rx CRC: 0
Rx alignment: 0
Rx resource: 0
Rx overrun: 0
Rx collision detects: 0
Rx short: 0
Tx good frames: 79
Tx maximum collisions: 0
Tx late collisions: 0
Tx underruns: 0
Tx lost carrier sense: 0
Tx deferred: 0
Tx single collisions: 0
Tx multiple collisions: 0
Tx total collisions: 0
FC Tx pause: 0
FC Rx pause: 0
FC Rx unsupported: 0
INTERRUPT STATISTICS
CX = 613298
FR = 805
CNA = 0
RNR = 0
MDI = 0
SWI = 0
FCP = 0
Receive All Multicasts = enabled
Receive Promiscuous = disabled
Loopback Mode = disabled
The table below describes the significant fields shown in the display.
Table 48: show controllers content-engine Field Descriptions
Field Description
Hardware Description of the chip being used.
Cisco IOS Interface and Hardware Component Command Reference
1159
service-module t1 linecode through show controllers satellite
show controllers content-engine
Field Description
IDB, FASTSEND Address in router memory of the Interface Descriptor Block (IDB) and
the fastsend routine.
INSTANCE Device-specific data stored in router memory that lists the memory
locations and current indices of receive (Rx) and transmit (Tx) rings in
router I/O memory.
CONTROL AND STATUS Control and status registers that are physically located on the chip itself
REGISTERS (CSR) and that are accessed by the CPU over the protocol control information
(PCI) bus.
PHY REGISTERS Contents of the physical layer (PHY) registers. A PHY module is a device
that interfaces the physical Ethernet line and that is located between the
chip and the physical line.
HARDWARE STATISTICS Receive (Rx) and transmit (Tx) traffic statistics collected by the chip.
INTERRUPT STATISTICS Transmit (Tx), Receive (Rx), control, software, and flow control interrupt
statistics collected by the chip.
Related Commands Command Description
interface content-engine Configures an interface for a CE network module and enters interface
configuration mode.
show interfaces content-engine Displays basic interface configuration information for a CE network
module.
Cisco IOS Interface and Hardware Component Command Reference
1160
service-module t1 linecode through show controllers satellite
show controllers dsx3
show controllers dsx3
To display digital signal level 3 cross connect (dsx3) information and to display hardware and software driver
information for the dsx3 controller, use the showcontrollersdsx3command in privileged EXEC mode.
show controllers dsx3 shelf /slot/port
Syntax Description shelf Shelf chassis in the Cisco 10000 series router that contains the dsx3 interface card.
/slot Location of the dsx3 interface card in the shelf chassis.
/port Port number.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(31)SB This command was introduced in a release earlier to Cisco IOS Release 12.2(31)SB.
12.2(33)SB This command’s behavior was modified on the Cisco 10000 series router for the PRE3 and
PRE4.
Examples The following is a sample output show the show controller dsx3 command for 8E3DS3 card:
Router# show controllers dsX3 3/0/0
DSX3 3/0/0 is down. Hardware is C10K ET line card
ET H/W Version : 0.0.0, ET ROM Version : 0.0, ET F/W Version : 0.0.0
Applique type is Subrate T3/E3
Receiver has loss of signal.
MDL transmission is disabled
FEAC code received: No code is being received
Framing is C-BIT Parity (Configured)
Line Code is B3ZS, Clock Source is Internal
DSU mode is cisco, DSU bandwidth is 44210
equipment customer loopback
Data in current interval (75 seconds elapsed):
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
75 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
0 AIS Defect Secs, 75 LOS Defect Secs
0 Near-end path failures
0 Far-end path failures, 0 FERF Defect Secs
0 CP-bit Far-End Unavailable Secs, 0 Far-End Coding Violations
0 Far-End Errored Secs, 0 Far-End Severely Errored Secs
The table below describes the significant fields shown in the display.
Cisco IOS Interface and Hardware Component Command Reference
1161
service-module t1 linecode through show controllers satellite
show controllers dsx3
Table 49: show controllers dsx3 Field Descriptions--Cisco 10000 series router
Field Description
AIS The alarm indication signal (AIS).
dsx3 3/0/0 is down dsx3 controller connected to this Cisco 10000 series router in shelf 3, slot 0,
port 0 is down. The controller’s state can be up, down, or administratively down.
Loopback conditions are shown by Locally Looped or Remotely Looped.
Applique type Describes the type of controller.
No alarms detected Any alarms detected by the controller are displayed here. Possible alarms are
as follows:
• Receiver has loss of frame (LOF).
• Receiver has loss of signal (LOS).
• Receiver has no alarms.
• Receiver has remote alarm.
• Receiver is getting AIS.
• Transmitter is sending alarm indication signal (AIS).
• Transmitter is sending remote alarm.
MDL transmission Maintenance Data Link status (either enabled or disabled). Used for carrying
performance information and control signals across the network toward the
far-end dsx3 unit.
FEAC code received Whether a far-end alarm code request is being received. Possible values are as
follows:
• Common Eqpt. Failure (NSA)
• DS1 Eqpt. Failure (NSA)
• DS1 Eqpt. Failure
• DS3 AIS Received
• DS3 Eqpt. Failure (NSA)
• DS3 Eqpt. Failure (SA)
• DS3 IDLE Received
• DS3 LOS/HBER
• DS3 Out-of-Frame
• Multiple DS1 LOS/HBER
• No code is being received
• Single DS1 LOS/HBER
Cisco IOS Interface and Hardware Component Command Reference
1162
service-module t1 linecode through show controllers satellite
show controllers dsx3
Field Description
Framing Standard dsx3 framing type: M23, C-bit, or Auto-detect.
Line Code Standard dsx3 line-coding format. In the example, the line-coding format is
bipolar 3-zero substitution (B3ZS).
Clock Source The source of the synchronization signal (clock): Line or Internal. In this
example, the line is providing the clock signal.
Data in current interval Summary statistics for dsx3 signal quality for the current time interval of 900
(seconds elapsed) seconds (15 minutes). In this example, the statistics are for current partial
interval. Statistics roll into the 24-hour accumulation buffer every 15 minutes.
The oldest 15-minute period falls off the back of the 24-hour accumulation
buffer.
Line Code Violations Count of both Bipolar Violations (BPVs) and Excessive Zeros (EXZs) that
occur over the accumulation period. An EXZ increments the line code violations
(LCVs) by one, regardless of the length of the zero string.
P-bit Coding Violation P-bit parity error event. A P-bit parity error event is the occurrence of a received
P-bit code on the DS3 M-frame that is not identical to the corresponding locally
calculated code. Referred to as PCV.
C-bit Coding Violation Count of coding violations reported via the C-bits. For C-bit parity, it is the
count of CP-bit parity errors that occur during the accumulation interval. Referred
to as CCV.
P-bit Err Secs Number of seconds with one or more PCVs, one or more out-of-frame defects,
or a detected incoming AIS. This gauge is not incremented when unavailable
seconds are counted.
P-bit Severely Err Secs Number of seconds with 44 or more PCVs, one or more out-of-frame defects,
or a detected incoming AIS. This gauge is not incremented when unavailable
seconds are counted.
Severely Err Framing Secs Number of a seconds with one or more out-of-frame defects or a detected
incoming AIS.
Unavailable Secs Number of seconds during which the interface was not available in this interval.
Referred to as UAS.
Line Errored Secs Number of seconds in this interval during which one or more code violations
or one or more LOS defects occurred. Referred to as LES.
C-bit Errored Secs Number of seconds with one or more C-bit code violations (CCV), one or more
out-of-frame defects, or a detected incoming AIS. This gauge is not incremented
when UASs are counted. Referred to as CES.
C-bit Severely Errored Secs Number of seconds with 44 or more CCVs, one or more out-of-frame defects,
or a detected incoming AIS. This gauge is not incremented when UASs are
counted.
Cisco IOS Interface and Hardware Component Command Reference
1163
service-module t1 linecode through show controllers satellite
show controller dwdm
show controller dwdm
To display ITU-T G.709 alarms, alerts, and counters for a dense wavelength division multiplexing (DWDM)
controller, use the showcontrollerdwdmcommand in privileged EXEC mode.
show controller dwdm slot/port [g709]
Syntax Description slot Chassis slot number of the DWDM controller.
/ port Port number of the DWDM controller.
g709 (Optional) Displays G.709 information.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SRD1 This command was introduced on the Cisco 7600 series routers.
Examples The following is sample output from the showcontrollerdwdmcommand. The output fields are
self-explanatory.
Router# show controller dwdm 2/3
Controller dwdm 2/3, is up (operational state)
G709 status : Enabled
OTU
LOS = 5 LOF = 5 LOM = 0
AIS = 0 BDI = 1 BIP = 0
TIM = 0 IAE = 4 BEI = 0
ODU
AIS = 0 BDI = 0 TIM = 0
OCI = 0 LCK = 0 PTIM = 5
BIP = 0 BEI = 0
FEC Mode: FEC
EC(current second) = 13539920
EC = 1750575661 UC = 1356085
pre-FEC BER = 121981.2578E-8
Q = 2.9677 Q Margin = 0.5052 dBQ
Detected Alarms: NONE
Asserted Alarms: NONE
Detected Alerts: NONE
Asserted Alerts: NONE
Alarm reporting enabled for: LOS LOF LOM OTU-AIS OTU-IAE OTU-BDI OTU-TIM ODU-AIS ODU-OCI
ODU-LCK ODU-BDI ODU-PTIM ODU-TIM
Alert reporting enabled for: OTU-SM-TCA ODU-SD-BER ODU-SF-BER ODU-PM-TCA
Cisco IOS Interface and Hardware Component Command Reference
1164
service-module t1 linecode through show controllers satellite
show controller dwdm
BER thresholds: ODU-SF = 10e-3 ODU-SD = 10e-6
TCA thresholds: SM = 10e-3 PM = 10e-3
Related Commands Command Description
show platform dwdm alarm history Displays platform DWDM alarm history.
Cisco IOS Interface and Hardware Component Command Reference
1165
service-module t1 linecode through show controllers satellite
show controllers e1
show controllers e1
To display information about E1 links, use the showcontrollerse1command in privileged EXEC mode.
Cisco 4000 Series Routers
show controllers e1 controller-number
Cisco 7500 Series Routers and Cisco ASR 901 Series Routers
show controllers e1 [slot/port]
Cisco AS5000 Series Access Servers
show controllers e1 {controller-number|clock|firmware-status|monitor|timeslots timeslot-range}
Cisco Series
show controllers e1 [slot/bay/port]
Syntax Description controller-number Controller number.
slot / port (Optional) Backplane slot number and port number on the interface. Refer to
the hardware manuals for your controller type to determine specific slot and
port numbers.
slot / bay / port Slot number, interface module number in which the slot is inserted, and port
number (Cisco series routers).
clock Displays primary clock change history.
firmware-status Displays system crash history.
monitor Displays primary monitor change history.
timeslots timeslot-range Displays DS0 information. Time slot range is 1 through 31 for the E1 controller.
Command Modes Privileged EXEC
Command History Release Modification
10.0 This command was introduced.
11.2 This command was implemented on additional router platforms.
12.1(3)T This command was implemented on additional access server platforms.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
15.4(3)S This command was implemented on the Cisco ASR 901 Series Aggregation Services
Router.
Cisco IOS Interface and Hardware Component Command Reference
1166
service-module t1 linecode through show controllers satellite
show controllers e1
Release Modification
XE Everest This command was implemented on the Cisco ASR 900 Series Routers and Cisco NCS
16.5.1 4200 Series.
XE Fuji 16.8.x This command output was modified on the Cisco Series Routers to display far-end counters
for performance monitoring.
Usage Guidelines This command displays controller status that is specific to the controller hardware. The information displayed
is generally useful for diagnostic tasks performed by technical support personnel only.
The Network Processor Module (NPM) on the Cisco 4000 series router or MultiChannel Interface Processor
(MIP) on a Cisco 7500 series router can query the port adapters to determine their current status. Issue a
showcontrollerse1 command to display statistics about the E1 link.
On a Cisco 7500 series router, if you specify a slot and port number each 15-minute period will be displayed.
On the Cisco 5000 series access servers use the showcontrollerse1timeslots command to display the CAS
and ISDN PRI channel state in detail. This command shows whether the DS0 channels of a controller are in
idle, in-service, maintenance, or busyout states. Enter the commands to display statistics about the E1 links.
Examples The following is sample output from the showcontrollerse1 command on the Cisco 7500 series
router:
Router# show controllers e1
e1 0/0 is up.
Applique type is Channelized E1 - unbalanced
Framing is CRC4, Line Code is HDB3
No alarms detected.
Data in current interval (725 seconds elapsed):
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs
Total Data (last 24 hours)
0 Line Code Violations, 0 Path Code Violations,
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins,
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs
The following is sample output from the showcontrollerse1command including the board identifier
type:
Router#
show controllers e1
E1 4/1 is up.
No alarms detected.
Framing is CRC4, Line Code is hdb3
Data in current interval (0 seconds elapsed):
0 Line Code Violations, 0 Path Code Violations 0 Slip Secs, 0 Fr Loss Secs,
0 Line Err Secs, 0 Degraded Mins 0 Errored Secs, 0 Bursty Err Secs,
0 Severely Err Secs, 0 Unavail Secs
Total Data (last 79 15 minute intervals):
0 Line Code Violations, 0 Path Code Violations, 0 Slip Secs, 0 Fr Loss Secs,
0 Line Err Secs, 0 Degraded Mins, 0 Errored Secs, 0 Bursty Err Secs,
0 Severely Err Secs, 0 Unavail Secs
The table below describes the significant fields shown in the display.
Cisco IOS Interface and Hardware Component Command Reference
1167
service-module t1 linecode through show controllers satellite
show controllers e1
Table 50: show controllers e1 Field Descriptions
Field Description
e1 0/0 is up The E1 controller 0 in slot 0 is operating. The controller’s state can be up, down,
or administratively down. Loopback conditions are shown by (Locally Looped)
or (Remotely Looped).
Applique type The applique type is shown and will indicate balanced or unbalanced.
Framing is Displays the current framing type.
Linecode is Displays the current linecode type.
No alarms detected Any alarms detected by the controller are displayed here. Possible alarms are as
follows:
• Transmitter is sending remote alarm.
• Transmitter is sending AIS.
• Receiver has loss of signal.
• Receiver is getting AIS.
• Receiver has loss of frame.
• Receiver has remote alarm.
• Receiver has no alarms.
Data in current interval Displays the current accumulation period, which rolls into the 24-hour
(725 seconds elapsed) accumulation every 15 minutes. Accumulation period is from 1 to 900 seconds.
The oldest 15-minute period falls off the back of the 24-hour accumulation buffer.
Line Code Violations Indicates the occurrence of either a Bipolar Violation (BPV) or Excessive Zeros
(EXZ) error event.
Path Code Violations Indicates a frame synchronization bit error in the D4 and E1-no-CRC formats,
or a cyclic redundancy check (CRC) error in the Extended Superframe (ESF)
and E1-CRC formats.
Slip Secs Indicates the replication or deletion of the payload bits of a DS1 frame. A slip
might be performed when there is a difference between the timing of a
synchronous receiving terminal and the received signal.
Fr Loss Secs Indicates the number of seconds an Out Of Frame (OOF) error is detected.
Line Err Secs Line Errored Seconds (LES) is a second in which one or more Line Code Violation
errors are detected.
Degraded Mins A Degraded Minute is one in which the estimated error rate exceeds 1E-6 but
does not exceed 1E-3.
Cisco IOS Interface and Hardware Component Command Reference
1168
service-module t1 linecode through show controllers satellite
show controllers e1
Field Description
Errored Secs In ESF and E1 CRC links, an Errored Second is a second in which one of the
following are detected: one or more Path Code Violations; one or more Out of
Frame defects; one or more Controlled Slip events; a detected AIS defect.
For SF and E1 no-CRC links, the presence of Bipolar Violations also triggers an
Errored Second.
Bursty Err Secs A second with fewer than 320 and more than 1 Path Coding Violation error, no
Severely Errored Frame defects and no detected incoming AIS defects. Controlled
slips are not included in this parameter.
Severely Err Secs For ESF signals, a second with one of the following errors: 320 or more Path
Code Violation errors; one or more Out of Frame defects; a detected AIS defect.
For E1-CRC signals, a second with one of the following errors: 832 or more Path
Code Violation errors; one or more Out of Frame defects.
For E1-nonCRC signals, a second with 2048 Line Code Violations or more.
For D4 signals, a count of 1-second intervals with Framing Errors, or an Out of
Frame defect, or 1544 Line Code Violations.
Unavail Secs A count of the total number of seconds on the interface.
The following is sample output from the showcontrollerse1timeslots command on a Cisco access
server. The information displayed is self-explanatory.
Router# show controllers e1 timeslots 1
SERVICE STATES CAS CHANNEL STATES
insvc = In Service down = Down
outofsvc = Out of Service idle = Idle
maint = Maintenance connected = Call Connected
signaling = Signaling
static-bo = Static Busyout
dynamic-bo = Dynamic Busyout
ISDN CHANNEL STATES
idle = Available
proposed = Negotiating
busy = Unavailable
reserved = Reserved
restart = Restart Pending
maint_pend = Maintenance Pending
reassigned = Reassigned
prop'd_1tr6= Net may change channel #
Series Router
The following is sample output from the show controllers e1 command on the Cisco series routers:
Router# show controllers e1 0/2/1
E1 0/2/1 is up.
Hardware is -48T3E3-CE
No alarms detected.
MDL transmission is disabled
FEAC code received: No code is being received
Cisco IOS Interface and Hardware Component Command Reference
1169
service-module t1 linecode through show controllers satellite
show controllers e1
Framing is C-BIT Parity, Line Code is B3ZS, Cablelength Short less than 225ft
BER thresholds: SF = 10e-10 SD = 10e-10
Clock Source is internal
Equipment customer loopback
Data in current interval (240 seconds elapsed):
Near End
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavailable Secs
0 Path Failures, 0 SEF/AIS Secs
Far End
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavailable Secs
0 Path Failures
Data in Interval 1:
Near End
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 14 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 15 Unavailable Secs
1 Path Failures, 0 SEF/AIS Secs
Far End Data
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 4 Fr Loss Secs, 2 Line Err Secs, 0 Degraded Mins
4 Errored Secs, 0 Bursty Err Secs, 4 Severely Err Secs, 0 Unavailable Secs
0 Path Failures
Total Data (last 1 15 minute intervals):
Near End
0 Line Code Violations, 0 Path Code Violations,
0 Slip Secs, 0 Fr Loss Secs, 14 Line Err Secs, 0 Degraded Mins,
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 15 Unavailable Secs
1 Path Failures, 0 SEF/AIS Secs
Far End
0 Line Code Violations, 0 Path Code Violations,
0 Slip Secs, 4 Fr Loss Secs, 2 Line Err Secs, 0 Degraded Mins,
4 Errored Secs, 0 Bursty Err Secs, 4 Severely Err Secs, 0 Unavailable Secs
0 Path Failures
Examples
Cisco IOS Interface and Hardware Component Command Reference
1170
service-module t1 linecode through show controllers satellite
show controllers e3
show controllers e3
To display information about an E3 controller, use theshowcontrollerse3command in user EXEC or privileged
EXEC mode.
show controllers e3 slot/port [{brief|tabular}]
Series
show controllers e3 [slot/bay/port]
Syntax Description slot Slot number. Refer to the appropriate hardware manual for slot information.
/ port Port number. Refer to the appropriate hardware manual for port information.
brief (Optional) Displays a list of configurations only.
tabular (Optional) Displays a list of configurations and MIB information in a tabular format.
slot / bay / port Slot number, interface module number in which the slot is inserted, and port number
(Cisco series routers).
Command Modes User EXEC Privileged EXEC
Command History Release Modification
11.1 CC This command was introduced on the E3 controller.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and implemented on the
following platforms: Cisco 2650XM, Cisco 2651XM, Cisco 2691, Cisco 3660 series, Cisco
3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
XE Fuji This command output was modified on the Cisco ASR 900 Series and Cisco NCS 4200 Series
16.8.x Routers to display far-end counters for performance monitoring.
Examples The following are samples of output from the showcontrollerse3command:
Router# show controllers e3 2/0
E3 2/0 is down.
Applique type is Subrate E3
Transmitter is sending remote alarm.
Receiver has loss of signal.
Framing is G751, Clock Source is Internal.
Data in current interval (450 seconds elapsed):
0 C-bit Coding Violation
0 P-bit Err Secs, 0 P-bit Severely Err Secs
0 Severely Err Framing Secs, 450 Unavailable Secs
0 Line Errored Secs, 0-C-bit Errored Secs, 0 C-bit Severely Errored Secs
Data in Interval 1:
0 C-bit Coding Violation
0 P-bit Err Secs, 0 P-bit Severely Err Secs
Cisco IOS Interface and Hardware Component Command Reference
1171
service-module t1 linecode through show controllers satellite
show controllers e3
0 Severely Err Framing Secs, 900 Unavailable Secs
0 Line Errored Secs, 0-C-bit Errored Secs, 0 C-bit Severely Errored Secs
Total Data (last 1 15 minute intervals):
0 C-bit Coding Violation
0 P-bit Err Secs, 0 P-bit Severely Err Secs
0 Severely Err Framing Secs, 900 Unavailable Secs
0 Line Errored Secs, 0-C-bit Errored Secs, 0 C-bit Severely Errored Secs
Router# show controllers e3 2/0 brief
E3 2/0 is down.
Applique type is Subrate E3
Transmitter is sending remote alarm.
Receiver has loss of signal.
Framing is G571, Clock Source is Internal.
Router# show controllers e3 2/0 tabular
E3 2/0 is down.
Applique type is Subrate E3
Transmitter is sending remote alarm.
Receiver has loss of signal.
Framing is G571, Clock Source is Internal.
INTERNAL LCV PCV CCV PES PSES SEFS UAS LES CES CSES
18:10-18:21 0 0 0 0 0 0 680 0 0 0
17:55-18:10 0 0 0 0 0 0 900 0 0 0
Total 0 0 0 0 0 0 900 0 0 0
The table below describes the significant fields shown in the display.
Table 51: show controllers e3 Field Descriptions
Field Description
E3 2/0 is down The E3 controller in slot 0 shows the state in which it is operating. The controller’s
state can be up, down, or administratively down. Loopback conditions are shown
by (Locally Looped) or (Remotely Looped).
Applique type Controller type.
Description User-specified information about the E3 controller.
No alarms detected (not Any alarms detected by the controller are displayed here. Possible alarms are as
shown in display) follows:
• Transmitter is sending remote alarm.
• Transmitter is sending alarm indication signal (AIS).
• Receiver has loss of signal.
• Receiver is getting AIS.
• Receiver has loss of frame.
• Receiver has remote alarm.
• Receiver has no alarms.
Linecode is (not shown in Line coding format on the E3.
display)
Framing Framing type.
Cisco IOS Interface and Hardware Component Command Reference
1172
service-module t1 linecode through show controllers satellite
show controllers e3
Field Description
Clock Source User-specified clock source (Line or Internal).
Data in current interval Shows the current accumulation period, which rolls into the 24-hour accumulation
(450 seconds elapsed) every 15 minutes. Accumulation period is from 1 to 900 seconds. The oldest
15-minute period falls off the back of the 24-hour accumulation buffer.
PCV Path coding violation (PCV) error event is a frame synchronization bit error in
the E1-no-CRC formats or a cyclic redundancy check (CRC) error in the E1-CRC
formats.
CCV C-bit coding violation (CCV) error event for C-bit parity. This is the count of
coding violations reported via the C-bits occurring in the accumulation interval.
PES P-bit errored seconds (PES) is a second with one or more PCVs, one or more
out-of-frame defects, or a detected incoming AIS. This gauge is not incremented
when unavailable seconds are counted.
PSES P-bit severely errored seconds (PSES) is a second with 44 or more PCVs, one
or more out-of-frame defects, or a detected incoming AIS. This gauge is not
incremented when unavailable seconds are counted.
SEFS Severely errored framing seconds (SEFS) is a second with one or more
out-of-frame defects or a detected incoming AIS.
UAS Unavailable seconds (UAS) are calculated by counting the number of seconds
for which the interface is unavailable. For more information, refer to RFC 1407.
LES Line errored seconds (LES) is a second in which one or more code violations or
one or more LOS defects occurred.
CES C-bit errored seconds (CES) is a second with one or more out-of-frame defects
or a detected incoming AIS. This gauge is not incremented when UASs are
counted.
CSES C-bit severely errored seconds (CSES) is a second with one or more out-of-frame
defects or a detected incoming AIS. This gauge is not incremented when UASs
are counted.
Total Displays the last 15-minute accumulation period.
Series Router
The following is sample output from the show controllers e3 command on the Cisco series routers:
Router# show controllers e3 0/4/40
E3 0/4/40 is up.
Hardware is -48T3E3-CE
Applique type is Clear Channel e3
No alarms detected.
MDL transmission is disabled
FEAC code received: No code is being received
Cisco IOS Interface and Hardware Component Command Reference
1173
service-module t1 linecode through show controllers satellite
show controllers e3
Framing is C-BIT Parity, Line Code is B3ZS, Cablelength Short less than 225ft
BER thresholds: SF = 10e-10 SD = 10e-10
Clock Source is internal
Equipment customer loopback
Data in current interval (240 seconds elapsed):
Near End
0 Line Code Violations, 0 P-bit Coding Violations
0 C-bit Coding Violations, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
0 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
0 Severely Errored Line Secs, 0 Path Failures
0 AIS Defect Secs, 0 LOS Defect Secs
Far End
0 Errored Secs, 0 Severely Errored Secs
0 C-bit Unavailable Secs, 0 Path Failures
0 Code Violations, 0 Service Affecting Secs
Data in Interval 1:
Near End
0 Line Code Violations, 0 P-bit Coding Violations
0 C-bit Coding Violations, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
20 Unavailable Secs, 20 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
20 Severely Errored Line Secs, 1 Path Failures
0 AIS Defect Secs, 20 LOS Defect Secs
Far End
0 Errored Secs, 0 Severely Errored Secs
0 C-bit Unavailable Secs, 0 Path Failures
0 Code Violations, 0 Service Affecting Secs
Total Data (last 1 15 minute intervals):
Near End
0 Line Code Violations, 0 P-bit Coding Violations,
0 C-bit Coding Violations, 0 P-bit Err Secs,
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs,
20 Unavailable Secs, 20 Line Errored Secs,
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
20 Severely Errored Line Secs, 1 path failures
0 AIS Defect Secs, 20 LOS Defect Secs
Far End
0 Errored Secs, 0 Severely Errored Secs
0 C-bit Unavailable Secs, 0 Path Failures
0 Code Violations, 0 Service Affecting Secs
E1 1 is up
timeslots:
FDL per AT&T 54016 spec.
No alarms detected.
Framing is ESF, Clock Source is Internal
Data in current interval (250 seconds elapsed):
Near End
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavailable Secs, 0 Stuffed Secs
0 Path Failures, 0 SEF/AIS Secs
Far End
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavailable Secs 0 Path Failures
Data in Interval 1:
Near End
0 Line Code Violations, 0 Path Code Violations
Cisco IOS Interface and Hardware Component Command Reference
1174
service-module t1 linecode through show controllers satellite
show controllers e3
0 Slip Secs, 2 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
2 Errored Secs, 0 Bursty Err Secs, 2 Severely Err Secs
0 Unavailable Secs, 0 Stuffed Secs
1 Path Failures, 2 SEF/AIS Secs
Far End
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 2 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
3 Errored Secs, 0 Bursty Err Secs, 3 Severely Err Secs
0 Unavailable Secs 0 Path Failures
Total Data (last 1 15 minute intervals):
Near End
0 Line Code Violations,0 Path Code Violations,
0 Slip Secs, 2 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins,
2 Errored Secs, 0 Bursty Err Secs, 2 Severely Err Secs
0 Unavailable Secs, 0 Stuffed Secs
1 Path Failures, 2 SEF/AIS Secs
Far End
0 Line Code Violations,0 Path Code Violations
0 Slip Secs, 2 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins,
3 Errored Secs, 0 Bursty Err Secs, 3 Severely Err Secs
0 Unavailable Secs, 0 Path Failures
Examples
Cisco IOS Interface and Hardware Component Command Reference
1175
service-module t1 linecode through show controllers satellite
show controllers ethernet
show controllers ethernet
To display the hardware information specific to the Ethernet interface on Cisco 2500 and Cisco 4000 series
routers, use the showcontrollersethernet command in user EXEC or privileged EXEC mode.
show controllers ethernet interface-number
Syntax Description interface-number Interface number of the Ethernet interface.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples The following is sample output from the showcontrollersethernet command on Cisco 4000 series
routers:
Router# show controllers ethernet 0
LANCE unit 0, NIM slot 1, NIM type code 4, NIM version 1
Media Type is 10BaseT, Link State is Up, Squelch is Normal
idb 0x4060, ds 0x5C80, regaddr = 0x8100000
IB at 0x600D7AC: mode=0x0000, mcfilter 0000/0001/0000/0040
station address 0000.0c03.a14f default station address 0000.0c03.a14f
buffer size 1524
RX ring with 32 entries at 0xD7E8
Rxhead = 0x600D8A0 (12582935), Rxp = 0x5CF0(23)
00 pak=0x60336D0 ds=0x6033822 status=0x80 max_size=1524 pak_size=98
01 pak=0x60327C0 ds=0x6032912 status=0x80 max_size=1524 pak_size=98
02 pak=0x6036B88 ds=0x6036CDA status=0x80 max_size=1524 pak_size=98
03 pak=0x6041138 ds=0x604128A status=0x80 max_size=1524 pak_size=98
04 pak=0x603FAA0 ds=0x603FBF2 status=0x80 max_size=1524 pak_size=98
05 pak=0x600DC50 ds=0x600DDA2 status=0x80 max_size=1524 pak_size=98
06 pak=0x6023E48 ds=0x6023F9A status=0x80 max_size=1524 pak_size=1506
07 pak=0x600E3D8 ds=0x600E52A status=0x80 max_size=1524 pak_size=1506
08 pak=0x6020990 ds=0x6020AE2 status=0x80 max_size=1524 pak_size=386
09 pak=0x602D4E8 ds=0x602D63A status=0x80 max_size=1524 pak_size=98
10 pak=0x603A7C8 ds=0x603A91A status=0x80 max_size=1524 pak_size=98
11 pak=0x601D4D8 ds=0x601D62A status=0x80 max_size=1524 pak_size=98
12 pak=0x603BE60 ds=0x603BFB2 status=0x80 max_size=1524 pak_size=98
13 pak=0x60318B0 ds=0x6031A02 status=0x80 max_size=1524 pak_size=98
14 pak=0x601CD50 ds=0x601CEA2 status=0x80 max_size=1524 pak_size=98
15 pak=0x602C5D8 ds=0x602C72A status=0x80 max_size=1524 pak_size=98
16 pak=0x60245D0 ds=0x6024722 status=0x80 max_size=1524 pak_size=98
17 pak=0x6008328 ds=0x600847A status=0x80 max_size=1524 pak_size=98
18 pak=0x601EB70 ds=0x601ECC2 status=0x80 max_size=1524 pak_size=98
19 pak=0x602DC70 ds=0x602DDC2 status=0x80 max_size=1524 pak_size=98
20 pak=0x60163E0 ds=0x6016532 status=0x80 max_size=1524 pak_size=98
21 pak=0x602CD60 ds=0x602CEB2 status=0x80 max_size=1524 pak_size=98
Cisco IOS Interface and Hardware Component Command Reference
1176
service-module t1 linecode through show controllers satellite
show controllers ethernet
22 pak=0x6037A98 ds=0x6037BEA status=0x80 max_size=1524 pak_size=98
23 pak=0x602BE50 ds=0x602BFA2 status=0x80 max_size=1524 pak_size=98
24 pak=0x6018988 ds=0x6018ADA status=0x80 max_size=1524 pak_size=98
25 pak=0x6033E58 ds=0x6033FAA status=0x80 max_size=1524 pak_size=98
26 pak=0x601BE40 ds=0x601BF92 status=0x80 max_size=1524 pak_size=98
27 pak=0x6026B78 ds=0x6026CCA status=0x80 max_size=1524 pak_size=98
28 pak=0x6024D58 ds=0x6024EAA status=0x80 max_size=1524 pak_size=74
29 pak=0x602AF40 ds=0x602B092 status=0x80 max_size=1524 pak_size=98
30 pak=0x601FA80 ds=0x601FBD2 status=0x80 max_size=1524 pak_size=98
31 pak=0x6038220 ds=0x6038372 status=0x80 max_size=1524 pak_size=98
TX ring with 8 entries at 0xDA20, tx_count = 0
tx_head = 0x600DA58 (12582919), head_txp = 0x5DC4 (7)
tx_tail = 0x600DA58 (12582919), tail_txp = 0x5DC4 (7)
00 pak=0x000000 ds=0x600CF12 status=0x03 status2=0x0000 pak_size=118
01 pak=0x000000 ds=0x602126A status=0x03 status2=0x0000 pak_size=60
02 pak=0x000000 ds=0x600CF12 status=0x03 status2=0x0000 pak_size=118
03 pak=0x000000 ds=0x600CF12 status=0x03 status2=0x0000 pak_size=118
04 pak=0x000000 ds=0x600CF12 status=0x03 status2=0x0000 pak_size=118
05 pak=0x000000 ds=0x600CF12 status=0x03 status2=0x0000 pak_size=118
06 pak=0x000000 ds=0x600CF12 status=0x03 status2=0x0000 pak_size=118
07 pak=0x000000 ds=0x6003ED2 status=0x03 status2=0x0000 pak_size=126
0 missed datagrams, 0 overruns, 2 late collisions, 2 lost carrier events
0 transmitter underruns, 0 excessive collisions, 0 tdr, 0 babbles
0 memory errors, 0 spurious initialization done interrupts
0 no enp status, 0 buffer errors, 0 overflow errors
10 one_col, 10 more_col, 22 deferred, 0 tx_buff
0 throttled, 0 enabled
Lance csr0 = 0x73
Statistics:
Rx Bytes 58419 Tx Bytes 17975
Rx Good Packets 676 Tx Good Packets 154
Rx Multicast 603
Rx Broadcast 64
Rx Bad Pkt Errors 0 Tx Bad Pkt Errors 0
Rx FCS Errors 0 Tx FCS Errors 0
Rx Runt Errors 0 Tx Runt Errors 0
Rx Oversize Errors 0 Tx Oversize Errors 0
Rx Length Errors 0 Tx Collisions 0
Rx Code Errors 0 Tx Late Collisions 0
Rx Dribble Errors 0 Tx Excessive Collisions 0
Tx Abort Errors 0
The table below describes the significant fields shown in the display.
Table 52: show controllers ethernet Field Description
Field Description
Rx Bytes Number of packets received without any error on the interface.
Tx Bytes Number of packets transmitted without any error on the interface.
Rx Good Packets Number of packets received without any error on the interface.
Tx Good Packets Number of packets transmitted without any error on the interface.
Rx Multicast Number of multicast packets received on the interface.
Rx Broadcast Number of broadcast packets received on the interface.
Rx Bad Pkt Errors Number of bad frames received on the interface.
Cisco IOS Interface and Hardware Component Command Reference
1177
service-module t1 linecode through show controllers satellite
show controllers ethernet
Field Description
Rx FCS Errors Number of valid size frames with Frame Check Sequence (FCS) errors, but not with
framing errors.
Rx Runt Errors Frames received on the interface that are smaller than the minimum IEEE 802.3 frame
size (64 bytes for Ethernet).
Rx Oversize Errors Number of oversize packets received on the interface.
Rx Length Errors Number of packets received on the interface with errors in the length of the packet.
Tx Collisions Number of collision events on the interface. This is applicable only in the half-duplex
mode.
Rx Code Errors Number of packets received on the interface with the code error signal.
Tx Late Collisions Number of late collisions.
Rx Dribble Errors Number of packets received with the dribble error. When a packet does not contain
an integral number of bytes, it is a dribble error .
Excessive Collisions Number of frames dropped in the transmit direction due to excessive collision. This
is applicable only in the half-duplex mode.
Tx Abort Errors Number of packets that were aborted during transmission.
Related Commands Command Description
show controllers Displays information specific to the hardware on a line card.
Cisco IOS Interface and Hardware Component Command Reference
1178
service-module t1 linecode through show controllers satellite
show controllers fastethernet
show controllers fastethernet
To display information about initialization block, transmit ring, receive ring, Fast Ethernet interface information,
applicable MAC destination address and VLAN filtering tables, and errors for the Fast Ethernet controller
chip, use the showcontrollersfastethernet command in user EXEC or privileged EXEC mode.
Standard Syntax
show controllers fastethernet number
Cisco 7200 Series
show controllers fastethernet slot/port
Cisco 7500 Series
show controllers fastethernet slot/port-adaptor/port
Shared Port Adapter
show controllers fastethernet slot/sub-slot/port{[detail]}
Syntax Description number Port, connector, or interface card number. On a Cisco 4500 or Cisco 4700 router, specifies
the network processor module (NPM) number. The numbers are assigned at the factory
at the time of installation or when added to a system.
slot Slot number. Refer to the appropriate hardware manual for slot information.
/ port Port number. Refer to the appropriate hardware manual for port information.
/ port-adapter Port adapter number. Refer to the appropriate hardware manual for information about port
adapter compatibility.
subslot (Optional) Secondary slot number on a jacket card where a SPA is installed.
detail Specifies display of additional low-level diagnostic information.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
11.2 This command was introduced.
12.2S This command was integrated into Cisco IOS Release 12.2S.
12.2(20)S2 This command was implemented on the 4-Port 10/100 Fast Ethernet SPA on the Cisco 7304
router and introduced a new address format and output.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Cisco IOS Interface and Hardware Component Command Reference
1179
service-module t1 linecode through show controllers satellite
show controllers fastethernet
Release Modification
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The output from this command is generally useful for diagnostic tasks performed by technical support.
Shared Port Adapter Usage Guidelines
The output from the showcontrollersfastethernetcommand for the 4-Port 10/100 Fast Ethernet SPA provides
several different sections of information and statistics that are organized according to the internal hardware
devices and the various paths in the flow of data on the SPA. The following sections are provided:
Several areas of the output are generally useful for diagnostic tasks performed by Cisco Systems technical
support personnel only.
Examples The following is a sample output from the showcontrollersfastethernet command on a Cisco 4500
series router:
Router# show controllers fastethernet 0
DEC21140 Slot 0, Subunit 0
dec21140_ds=0x60001234, registers=0x3c001000, ib=0x42301563, ring entries=256
rxring=0x40235878, rxr shadow=0x64528745, rx_head=0, rx_tail=10
txring=0x43562188, txr shadow=0x65438721, tx_head=17, tx_tail=34, tx_count=17
DEC21140 Registers
CSR0=0x23457667, CSR3=0x12349878, CSR4=0x34528745, CSR5=0x76674565
CSR6=0x76453676, CSR7=0x76456574, CSR8=0x25367648, CSR9=0x87253674
CSR11=0x23456454, CSR12=0x76564787, CSR15=0x98273465
DEC21140 PCI registers
bus_no=0, device_no=0
CFID=0x12341234, CFCS=0x76547654, CFRV=0x87658765, CFLT=0x98769876
CBIO=0x12344321, CBMA=0x23454321, CFIT=0x34567654, CFDA=0x76544567
MII registers
Register 0x00: 0x1234 0x1234 0x2345 0x3456 0x4567 0x5678 0x6789 0x7890
Register 0x08: 0x9876 0x8765 0x7654 0x6543 0x5432 0x4321 0x3210 0x2109
Register 0x10: 0x1234 0x2345 0x3456 0x4567 0x5678 0x6789 0x7890
Register 0x18: 0x9876 0x8765 0x7654 0x6543 0x5432 0x4321
DEC21140 statistics
filtered_in_sw=1000, throttled=10, enabled=10
rx_fifo_overflow=10, rx_no_enp=12, rx_late_collision=18
rx_watchdog=15, rx_process_stopped=15, rx_buffer_unavailable=1500
tx_jabber_timeout=10, tx_carrier_loss=2, tx_deffered=15
tx_no_carrier=1, tx_late_collision=10, tx_excess_coll=10
tx_process_stopped=1, fata_tx_err=0
The following is a sample output from the showcontrollersfastethernet command on a Cisco AS5300
router:
Router# show controller fastethernet 0
DEC21140
Setup Frame
(0 ) 00e0.1e3e.c179
(1 ) 0100.0ccc.cccc
(2 ) 0900.2b00.000f
(3 ) 0900.2b02.0104
(4 ) 0300.0000.0001
dec21140_ds=0x60BD33B8, registers=0x3C210000, ib=0x4002F75C, ring entries=32
rxring=0x4002F844, rxr shadow=0x60F14B58, rx_head=6, rx_tail=6
txring=0x4002FA6C, txr shadow=0x60F14BF8, tx_head=10, tx_tail=10, tx_count=0
Cisco IOS Interface and Hardware Component Command Reference
1180
service-module t1 linecode through show controllers satellite
show controllers fastethernet
tx_size=32, rx_size=32
PHY link up
DEC21140 Registers:
CSR0=0xFE024480, CSR3=0x4002F844, CSR4=0x4002FA6C, CSR5=0xFC660000
CSR6=0x322C2002, CSR7=0xFFFFA241, CSR8=0xE0000000, CSR9=0xFFFDC3FF
CSR11=0xFFFE0000, CSR12=0xFFFFFF09, CSR15=0xFFFFFEC8
DEC21140 PCI registers:
bus_no=2, device_no=0
CFID=0x00091011, CFCS=0x82800005, CFRV=0x02000021, CFLT=0x0000FF00
CBIO=0x3C210001, CBMA=0x00000000, CFIT=0x28140100, CFDA=0x00000000
MII registers:
Register 0x00: 0000 784D 2000 5C01 0001 0000 0000 0000
Register 0x08: 0000 0000 0000 0000 0000 0000 0000 0000
Register 0x10: 0000 0000 0000 0000 0000 0001 8060
Register 0x18: 8020 0840 0000 3000 A3B9
throttled=7, enabled=7
rx_fifo_overflow=0, rx_no_enp=0, late_collision=0
rx_watchdog=0, rx_process_stopped=0, rx_buffer_unavailable=0
tx_jabber_timeout=0, tx_carrier_loss=1, tx_deferred=0
tx_no_carrier=1, tx_late_collision=0, tx_excess_coll=0
tx_process_stopped=0, fatal_tx_err=0
overflow_resets=0
0 missed datagrams, 0 overruns
0 transmitter underruns, 0 excessive collisions
0 single collisions, 0 multiple collisions
0 dma memory errors, 0 CRC errors
0 alignment errors, 0 runts, 0 giants
The following is a sample output from the showcontrollersfastethernet command on a Cisco 7200
series router:
Router# show controllers fastethernet 0/0
Interface Fast Ethernet0/0
Hardware is DEC21140
dec21140_ds=0x60895888, registers=0x3C018000, ib=0x4B019500
rx ring entries=128, tx ring entries=128
rxring=0x4B019640, rxr shadow=0x60895970, rx_head=0, rx_tail=0
txring=0x4B019EC0, txr shadow=0x60895B98, tx_head=77, tx_tail=77, tx_count=0
CSR0=0xFFFA4882, CSR3=0x4B019640, CSR4=0x4B019EC0, CSR5=0xFC660000
CSR6=0xE20CA202, CSR7=0xFFFFA241, CSR8=0xFFFE0000, CSR9=0xFFFDD7FF
CSR11=0xFFFE0000, CSR12=0xFFFFFF98, CSR15=0xFFFFFEC8
DEC21140 PCI registers:
bus_no=0, device_no=6
CFID=0x00091011, CFCS=0x02800006, CFRV=0x02000012, CFLT=0x0000FF00
CBIO=0x7C5AFF81, CBMA=0x48018000, CFIT=0x0000018F, CFDA=0x0000AF00
MII registers:
Register 0x00: 2000 780B 2000 5C00 01E1 0000 0000 0000
Register 0x08: 0000 0000 0000 0000 0000 0000 0000 0000
Register 0x10: 0000 0000 0000 0000 0000 0000 8040
Register 0x18: 8000 0000 0000 3800 A3B9
throttled=0, enabled=0, disabled=0
rx_fifo_overflow=0, rx_no_enp=0, rx_discard=0
tx_underrun_err=0, tx_jabber_timeout=0, tx_carrier_loss=1
tx_no_carrier=1, tx_late_collision=0, tx_excess_coll=0
tx_collision_cnt=0, tx_deferred=0, fatal_tx_err=0, mult_ovfl=0
HW addr filter: 0x60895FC0, ISL Enabled
Entry= 0: Addr=0100.0CCC.CCCC
Entry= 1: Addr=0300.0000.0001
Entry= 2: Addr=0100.0C00.0000
Entry= 3: Addr=FFFF.FFFF.FFFF
Entry= 4: Addr=FFFF.FFFF.FFFF
Entry= 5: Addr=FFFF.FFFF.FFFF
Entry= 6: Addr=FFFF.FFFF.FFFF
Cisco IOS Interface and Hardware Component Command Reference
1181
service-module t1 linecode through show controllers satellite
show controllers fastethernet
Entry= 7: Addr=FFFF.FFFF.FFFF
Entry= 8: Addr=FFFF.FFFF.FFFF
Entry= 9: Addr=FFFF.FFFF.FFFF
Entry=10: Addr=FFFF.FFFF.FFFF
Entry=11: Addr=FFFF.FFFF.FFFF
Entry=12: Addr=FFFF.FFFF.FFFF
Entry=13: Addr=FFFF.FFFF.FFFF
Entry=14: Addr=FFFF.FFFF.FFFF
Entry=15: Addr=0060.3E28.6E00
Shared Port Adapter Examples
The following is sample output from the showcontrollersfastethernet command for the first interface
(port 0) on a 4-Port 10/100 Fast Ethernet SPA that is located in the top subslot (0), of the MSC that
is installed in slot 4 on a Cisco 7304 router:
Router# show controllers fastethernet 4/0/0
Interface FastEthernet4/0/0
Hardware is SPA-4FE-7304
Connection mode is auto-negotiation
Interface state is up, link is up
Configuration is Auto Speed, Auto Duplex
Selected media-type is RJ45
Promiscuous mode is off, VLAN filtering is enabled
MDI crossover status: MDI
Auto-negotiation configuration and status:
Auto-negotiation is enabled and is completed
Speed/duplex is resolved to 100 Mbps, full duplex
Advertised capabilities: 10M/HD 10M/FD 100M/HD 100M/FD Pause capable (Asymmetric)
Partner capabilities: 10M/HD 10M/FD 100M/HD 100M/FD Pause capable
MAC counters:
Input: packets = 15, bytes = 1776
FIFO full/reset removed = 0, error drop = 0
Output: packets = 18, bytes = 2622
FIFO full/reset removed = 0, error drop = 0
Total pause frames: transmitted = 0, received = 0
FPGA counters:
Input: Total (good & bad) packets: 15, TCAM drops: 4
Satisfy (host-backpressure) drops: 0, CRC drops: 0
PL3 RERRs: 0
Output: EOP (SPI4) errors: 0
SPA carrier card counters:
Input: packets = 11, bytes = 1476, drops = 0
Output: packets = 18, bytes = 2550, drops = 0
Egress flow control status: XON
Per bay counters:
General errors: input = 0, output = 0
SPI4 errors: ingress dip4 = 0, egress dip2 = 0
SPA Error counters:
SPI4 TX out of frame error = 2 (00:02:31 ago)
SPI4 TX Train valid error = 1 (00:02:11 ago)
SPI4 TX DIP4 error = 1 (00:01:30 ago)
SPI4 RX out of frame error = 1 (00:00:36 ago)
SPI4 RX DIP2 error = 1 (00:00:13 ago)
MAC destination address filtering table:
Table entries: Total = 512, Used = 4, Available = 508
Index MAC destination address Mask
----- ----------------------- --------------
1 0007.0ed3.ba80 ffff.ffff.ffff
2 ffff.ffff.ffff ffff.ffff.ffff
3 0100.0000.0000 0100.0000.0000
Cisco IOS Interface and Hardware Component Command Reference
1182
service-module t1 linecode through show controllers satellite
show controllers fastethernet
4 0100.0ccc.cccc ffff.ffff.ffff
VLAN filtering table:
Number of VLANs configured on this interface = 0
Table entries: Total = 1024, Used = 2, Available = 1022
Index VLAN identifier Enabled Tunnel
----- --------------- ------- ------
1 0 No No
2 0 Yes No
Platform details:
PXF tif number: 0x10
The table below describes the fields shown in the interface configuration section of the display. This
section is useful for verifying the status of autonegotiation and configured parameters on the link,
and the amount of traffic being handled by the interface.
Table 53: show controllers Command Field Descriptions--Interface Section
Field Description
Interface Name of the interface.
Hardware Type of hardware.
Connection mode Indicator of autonegotiation used to establish the connection.
Link State of the link.
Configuration Configuration of the speed and duplex operation on the interface.
Selected media-type Interface port media type. RJ-45 is the only type supported on the 4-Port 10/100
Fast Ethernet SPA.
Promiscuous mode State of promiscuous mode (on or off). When promiscuous mode is on, the SPA
disables MAC destination address and VLAN filtering. When promiscuous mode
is off, the SPA enables MAC destination address and VLAN filtering.
VLAN filtering Status of ternary content addressable memory (TCAM) filtering of VLANs
(enabled or disabled). By default, the SPA always enables VLAN filtering.
The SPA disables VLAN filtering if the TCAM table is full, or if the SPA is
operating in promiscuous mode.
Note VLAN filtering is not enabled or disabled using any command-line
interface (CLI) command.
MDI crossover status State of the media dependent interface (MDI) for the PHY device on the specified
interface. The possible values are MDI for straight-through cables or media
dependent interface crossover (MDI-X) for crossover cables.
Auto-negotiation State of autonegotiation (enabled or disabled) on the interface and its current
status.
Speed/duplex is resolved Results of autonegotiated parameter values (speed and duplex) currently being
to used on the link.
Cisco IOS Interface and Hardware Component Command Reference
1183
service-module t1 linecode through show controllers satellite
show controllers fastethernet
Field Description
Advertised capabilities List of the possible combinations of speed and duplex modes (in speed/duplex
format) and flow control that the local interface has advertised it supports to the
remote device:
• For speed--10M is 10 Mbps, and 100M is 100 Mbps.
• For duplex--HD is half duplex, and FD is full duplex.
• For flow control--“Pause capable (Asymmetric)” means that the SPA
advertises support of the PAUSE flow control bit and the ASM_DIR
(asymmetric) flow control bit.
Partner capabilities List of the possible combinations of speed and duplex modes (in speed/duplex
format) and flow control that the remote device has advertised it supports to the
local interface:
• For speed--10M is 10 Mbps, and 100M is 100 Mbps.
• For duplex--HD is half duplex, and FD is full duplex.
• For flow control--“Pause capable” means that the remote device supports
implementation of the PAUSE flow control bit; “Pause capable
(Asymmetric)” means that the remote device supports implementation of
the PAUSE flow control bit and the ASM_DIR (asymmetric) flow control
bit.
The table below describes the fields shown in the MAC counters section of the display. This section
is useful for verifying the status of packets processed by the MAC device for the interface. This
information is useful for Cisco Systems technical support personnel.
Table 54: show controllers Command Field Descriptions--MAC Counters Section
Field Description
Input: packets, bytes Total number of packets and bytes received by the MAC device for the
interface since it was activated or cleared.
You can clear these counters using the clearcounters privileged EXEC
command.
Input: FIFO full/reset removed Total number of packets removed by the MAC device due to a first-in,
first-out (FIFO) overflow condition in the input buffer for the interface.
Input: error drop Total number of input packets with errors that are dropped by the MAC
device for the interface.
Output: packets, bytes Total number of packets and bytes transmitted by the MAC device for the
interface since it was activated or cleared.
You can clear these counters using the clearcounters privileged EXEC
command.
Cisco IOS Interface and Hardware Component Command Reference
1184
service-module t1 linecode through show controllers satellite
show controllers fastethernet
Field Description
Output: FIFO full/reset Total number of packets removed by the MAC device due to a first-in,
removed first-out (FIFO) overflow condition in the output buffer for the interface.
Output: error drop Total number of output packets with errors that are dropped by the MAC
device for the interface.
Total pause frames Total number of Ethernet 802.3x pause frames transmitted and received by
the MAC device for flow control on the interface.
The table below describes the fields shown in the FPGA counters section of the display. This section
is useful for verifying the status of packets processed by the FPGA device for the interface. This
information is useful for Cisco Systems technical support personnel.
Table 55: show controllers Command Field Descriptions--FPGA Counters Section
Field Description
Input: Total (good & bad) Total number of packets received by the FPGA device in the ingress direction
packets for the interface.
Input: TCAM drops Total number of packets dropped by the FPGA device in the ingress direction
for the interface due to a ternary content addressable memory (TCAM) lookup
failure. This counter increments when the interface receives a frame with a
destination MAC address or VLAN identifier that is not present in the TCAM
table.
Input: Satisfy Total number of packets dropped by the FPGA device in the ingress direction
(host-backpressure) drops for the interface due to back-pressure from the MSC.
Input: CRC drops Total number of packets dropped by the FPGA device in the ingress direction
for the interface due to cyclic redundancy check (CRC) errors.
Input: PL3 RERRs Total number of packets with errors received for the interface by the FPGA
device in the ingress direction over the System Packet Interface Level 3 (SPI3)
(also called PL3) path from the MAC device to the FPGA device.
Output: EOP (SPI4) errors Total number of packets with end-of-packet (EOP) errors received by the
FPGA device in the egress direction for the interface over the System Packet
Interface Level 4 (SPI4) path from the MSC to the FPGA device.
The table below describes the fields shown in the SPA carrier card counters section of the display.
This section is useful for verifying the status of packets processed by the MSC for the interface. This
information is useful for Cisco Systems technical support personnel.
Table 56: show controllers Command Field Descriptions--SPA Carrier Card Counters Section
Field Description
Input: packets, bytes, drops Total number of packets, bytes, and packet drops that have occurred on the
SPI4 path from the FPGA device to the MSC.
Cisco IOS Interface and Hardware Component Command Reference
1185
service-module t1 linecode through show controllers satellite
show controllers fastethernet
Field Description
Output: packets, bytes, Total number of packets, bytes, and packet drops that have occurred on the
drops SPI4 path from the MSC to the FPGA device.
Egress flow control status Status of flow control between the MSC and the Route Processor (RP). The
possible values are:
• XON--A control frame has been sent by the MSC to the RP to indicate
that the MSC is ready to accept data.
• XOFF--A control frame has been sent by the MSC to the RP to indicate
congestion on the MSC. The MSC cannot accept any more data from the
RP during this condition.
General errors Total number of errors (such as parity) on the MSC in the ingress and egress
direction.
SPI4 errors: ingress dip4 Total number of 4-bit Diagonal Interleaved Parity (DIP4) errors in the ingress
direction on the SPI4 path from the FPGA device to the MSC.
DIP4 is a parity algorithm where a 4-bit odd parity is computed diagonally
over control and data words.
SPI4 errors: egress dip2 Total number of 2-bit Diagonal Interleaved Parity (DIP2) errors in the egress
direction on the SPI4 path from the FPGA device to the MSC.
DIP2 is a parity algorithm where a 2-bit odd parity is computed diagonally
over status words.
The table below describes the fields shown in the SPA error counters section of the display. This
section appears only when one of the SPI4 transmit or receive errors occurs on the interface. This
information is useful for Cisco Systems technical support personnel.
Note None of the SPA SPI4 error counters appear in showcontrollersfastethernet command output until
at least one of those types of SPI4 errors occurs.
All of the errors in the SPA error counters section are subject to the SPA automatic recovery process
when certain thresholds are reached. For more information about this process on the Cisco 7304
router, refer to the “Understanding SPA Automatic Recovery” section of the Cisco 7304 Router
Modular Services Card and Shared Port Adapter Software Configuration Guide
Cisco IOS Interface and Hardware Component Command Reference
1186
service-module t1 linecode through show controllers satellite
show controllers fastethernet
Table 57: show controllers Command Field Descriptions--SPA Error Counters Section
Field Description
SPI4 TX out of frame error Number of SPI4 out-of-frame errors (events) detected in the transmit direction
= 2 (00:02:31 ago) (toward the network), from the MSC to the SPA FPGA device. The time stamp
indicates how long ago (in hours:minutes:seconds) from the current system time,
that the last error was detected.
This error indicates a loss of synchronization between the synchronization block
and the data received on the SPI4 path. When synchronization is reacquired, the
error no longer occurs.
SPI4 TX Train valid error Number of times that a low-level synchronization problem was detected in the
= 1 (00:02:11 ago) transmit direction (toward the network), from the MSC to the SPA FPGA device.
The time stamp indicates how long ago (in hours:minutes:seconds) from the
current system time, that the last error was detected.
SPI4 TX DIP4 error = 1 Number of 4-bit Diagonal Interleaved Parity (DIP4) errors in the transmit
(00:01:30 ago) direction (toward the network), from the MSC to the SPA FPGA device. The
time stamp indicates how long ago (in hours:minutes:seconds) from the current
system time, that the last error was detected.
DIP4 is a parity algorithm where a 4-bit odd parity is computed diagonally over
control and data words.
SPI4 RX out of frame error Number of SPI4 out-of-frame errors (events) detected in the receive direction
= 1 (00:00:36 ago) (from the network), from the SPA FPGA device to the MSC. The time stamp
indicates how long ago (in hours:minutes:seconds) from the current system time,
that the last error was detected.
This error indicates a loss of synchronization between the synchronization block
and the data received on the SPI4 path. When synchronization is reacquired, the
error no longer occurs.
SPI4 RX DIP2 error = 1 Number of 2-bit Diagonal Interleaved Parity (DIP2) errors in the receive direction
(00:00:13 ago) (from the network), from the SPA FPGA device to the MSC. The time stamp
indicates how long ago (in hours:minutes:seconds) from the current system time,
that the last error was detected.
DIP2 is a parity algorithm where a 2-bit odd parity is computed diagonally over
status words.
The table below describes the fields shown in the MAC destination address filtering table section of
the display. This section is useful for verifying the multicast destination addresses that are in the
TCAM table and permitted by the interface. This information is useful for Cisco Systems technical
support personnel.
Cisco IOS Interface and Hardware Component Command Reference
1187
service-module t1 linecode through show controllers satellite
show controllers fastethernet
Table 58: show controllers Command Field Descriptions--MAC Destination Address Filtering Table Section
Field Description
Table entries: Total, Total number of MAC destination address entries possible in the TCAM table for
Used, Available the interface, the number of table entries currently used by the interface, and the
number of table entries that remain available.
The 4-Port 10/100 Fast Ethernet SPA supports a 512-entry MAC filtering table for
each supported interface (2048 entries total on the card).
Index Table entry identifier.
MAC destination MAC destination address (multicast) permitted by the interface and used in the
address TCAM lookup table for packet filtering.
The multicast MAC entries typically come from routing protocols [such as Open
Shortest Path First (OSPF) and Enhanced IGRP (EIGRP)], and other protocols
including the Hot Standby Router Protocol (HSRP).
When the router reloads, three addresses appear by default in the MAC filtering
table: the unicast address of the local interface, the Ethernet broadcast address, and
the Ethernet multicast address.
Mask Mask for the corresponding destination address. The SPA uses the bits that are set
in the mask to look up the address in the TCAM table.
The table below describes the fields shown in the VLAN filtering table section of the display. This
section is useful for verifying the VLANs that are in the TCAM table and are permitted by the
interface. This information is useful for Cisco Systems technical support personnel.
Table 59: show controllers Command Field Descriptions--VLAN Filtering Table Section
Field Description
Number of VLANs Number of VLANs that are configured on the interface.
configured on this
If the number of VLANs configured on the interface is 1022 or less, then the VLAN
interface
filtering table also shows an index entry for every VLAN ID. The number of VLANs
configured on the interface can be 0, while the number of used table entries reports
2, because the SPA always uses two entries to provide valid matching criteria for
promiscuous mode and non-VLAN packets.
Table entries: Total, Total number of VLAN entries possible in the TCAM filtering table for the interface,
Used, Available the number of table entries currently used by the interface (two are always in use by
default), and the number of table entries that remain available.
The 4-Port 10/100 Fast Ethernet SPA supports a 1024-entry VLAN filtering table for
each supported interface (4096 entries total on the card).
Index Table entry identifier.
VLAN identifier Number of the VLAN. Two VLAN ID 0 entries always appear in the table and represent
the local interface port for handling of promiscuous mode and non-VLAN packets.
Other VLAN entries appear in this table when VLANs are configured on the interface.
Cisco IOS Interface and Hardware Component Command Reference
1188
service-module t1 linecode through show controllers satellite
show controllers fastethernet
Field Description
Enabled Status of the VLAN ID for TCAM filtering, with the following possible values:
• No--The entry is disabled for filtering.
• Yes--The entry is enabled for filtering.
The TCAM filter uses the “first-match” rule to filter packets that the SPA receives
against entries in the table. The matching assessment begins at the top of the table
with the VLAN ID 0 entries.
Note The SPA always supports two VLAN ID 0 entries. The first VLAN ID 0
entry of the TCAM table is used for promiscuous mode. It has a value of
“No,” meaning it is disabled, whenever promiscuous mode is disabled for
the interface. The second VLAN ID 0 entry is used for filtering of
non-VLAN packets.
Tunnel Status of tunneling for the interface, with the following possible values:
• No--Tunneling is disabled and the SPA performs MAC destination address
filtering.
• Yes--Tunneling is enabled and the SPA does not perform MAC destination
address filtering.
Note If promiscuous mode is enabled, then the first VLAN ID 0 entry shows
tunnel = Yes. All other VLAN ID entries show tunnel = No.
The table below describes the fields shown in the Platform details section of the display.
Table 60: show controllers Command Field Descriptions--Platform Details Section
Field Description
PXF tif number Number of the interface (in hexadecimal format) used for PXF on the network services
engine (NSE) or by the Hyper Transport (HT) FPGA device on the network processing
engine (NPE).
Related Commands Command Description
show interfaces fastethernet Displays information about the Fast Ethernet interfaces.
Cisco IOS Interface and Hardware Component Command Reference
1189
service-module t1 linecode through show controllers satellite
show controllers fddi
show controllers fddi
To display all information under the FDDI Interface Processor ( FIP) on the Cisco 7200 series and Cisco 7500
series routers, use the showcontrollersfddi command in user EXEC or privileged EXEC mode.
show controllers fddi
Syntax Description This command has no arguments or keywords.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command reflects the internal state of the chips and information that the system uses for bridging and
routing that is specific to the interface hardware. The information displayed is generally useful for diagnostic
tasks performed by technical support personnel only.
Examples The following is sample output from the showcontrollersfddi command:
Router# show controllers fddi
Fddi2/0 - hardware version 2.2, microcode version 1.2
Phy-A registers:
cr0 4, cr1 0, cr2 0, status 3, cr3 0
Phy-B registers:
cr0 4, cr1 4, cr2 0, status 3, cr3 0
FORMAC registers:
irdtlb 71C2, irdtneg F85E, irdthtt F5D5, irdmir FFFF0BDC
irdtrth F85F, irdtmax FBC5, irdtvxt 5959, irdstmc 0810
irdmode 6A20, irdimsk 0000, irdstat 8060, irdtpri 0000
FIP registers
ccb: 002C cmd: 0006 fr: 000F mdptr: 0000 mema: 0000
icb: 00C0 arg: 0003 app: 0004 mdpg: 0000 af: 0603
clm: E002 bcn: E016 clbn: 0198 rxoff: 002A en: 0001
clmbc: 8011 bcnbc: 8011 robn: 0004 park: 0000 fop: 8004
txchn: 0000 pend: 0000 act: 0000 tail: 0000 cnt: 0000
state: 0003 check: 0000 eof: 0000 tail: 0000 cnt: 0000
rxchn: 0000 buf0: 0534 nxt0: 0570 eof: 0000 tail: 0000
eofch: 0000 buf1: 051C nxt1: 0528 pool: 0050 err: 005C
head: 0984 cur: 0000 t0: 0030 t1: 0027 t2: 000F
tail: 0984 cnt: 0001 t3: 0000 rxlft: 000B used: 0000
txq_s: 0018 txq_f: 0018 Aarm: 0000 Barm: 1388 fint: 8004
Total LEM: phy-a 6, phy-b 13
The last line of output indicates how many times the specific PHY encountered an “UNKNOWN
LINE STATE” event on the fiber.
Cisco IOS Interface and Hardware Component Command Reference
1190
service-module t1 linecode through show controllers satellite
show controllers gigabitethernet
show controllers gigabitethernet
To display initialization block information, transmit ring, receive ring, transmission statistics and errors, and
applicable MAC destination address and VLAN filtering tables for Gigabit Ethernet interface controllers, use
the showcontrollersgigabitethernetcommand in privileged EXEC mode.
Standard Syntax
show controllers gigabitethernet slot/port
Shared Port Adapters
show controllers gigabitethernet slot/subslot/port [detail]
Syntax Description slot (Optional) Chassis slot number.
Refer to the appropriate hardware manual for slot information. For MSCs, refer to the
platform-specific SPA hardware installation guide or the corresponding “Identifying Slots and
Subslots for MSCs and SPAs” topic in the platform-specific SPA software configuration guide.
/ subslot (Optional) Secondary slot number on a MSC where a SPA is installed.
Refer to the platform-specific SPA hardware installation guide and the corresponding “Specifying
the Interface Address on a SPA” topic in the platform-specific SPA software configuration guide
for subslot information.
/ port (Optional) Port or interface number.
Refer to the appropriate hardware manual for port information. For SPAs, refer to the
corresponding “Specifying the Interface Address on a SPA" topics in the platform-specific SPA
software configuration guide.
detail Specifies display of additional low-level diagnostic information.
Command Default No default behavior or values.
Command Modes Privileged EXEC
Command History Release Modification
11.1CC This command was introduced.
12.1(3a)E Support for the Cisco 7200-I/O-GE+E controller was introduced.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.
12.2S This command was integrated into Cisco IOS Release 12.2S.
12.2(20)S2 This command was implemented on the 2-Port 10/100/1000 Gigabit Ethernet SPA on the
Cisco 7304 router with a new address format and output.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Cisco IOS Interface and Hardware Component Command Reference
1191
service-module t1 linecode through show controllers satellite
show controllers gigabitethernet
Release Modification
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
15.2(02)SA This command was implemented on the Cisco ME 2600X Series Ethernet Access Switches.
Usage Guidelines This command is used to display hardware and software information about the Gigabit Ethernet interface.
The I/O controller is always found in slot 0.
Shared Port Adapter Usage Guidelines
The output from the showcontrollersgigabitethernetcommand for the 2-Port 10/100/1000 Gigabit Ethernet
SPA provides several different sections of information and statistics that are organized according to the internal
hardware devices and the various paths in the flow of data on the SPA. Several areas of the output are generally
useful for diagnostic tasks performed by technical support only.
Examples The following is sample output from the showcontrollersgigabitethernetcommand:
Router# show controllers gigabitethernet 0/0
Interface GigabitEthernet0/0 (idb 0x627D8344)
Hardware is i82543 (Livengood) A1
network connection mode is AUTO
network link is up
loopback type is none
SERDES is enabled (TBI mode), GBIC is enabled
GBIC type is 1000BaseSX
idb->lc_ip_turbo_fs=0x604A82B0, ip_routecache=0x1(dfs=0/mdfs=0), max_mtu=1524
i82543_ds=0x627DA094, registers=0x3C100000, curr_intr=0
rx cache size=2000, rx cache end=1744, rx_nobuffer=0
i82543 MAC registers:
CTRL =0x0ACC0004, STATUS=0x00000FAB, CTRL_X=0x000048E0, IMS =0x00000096
RCTL =0x0042803A, RDBAL =0x2000E000, RDBAH =0x00000000, RDLEN =0x00001000
RDH =0x000000CB, RDT =0x000000CA, RDTR =0x00000000
TCTL =0x000400FA, TDBAL =0x20010000, TDBAH =0x00000000, TDLEN =0x00001000
TDH =0x00000057, TDT =0x00000057, TIPG =0x00600806
ETT =0x00000000, TXDMAC=0x00000001
TXCW =0xC00001A0, RXCW =0xDC004120, FCRTH =0x0000AFF0, FCRTL =0x80001200
FCAH =0x00000100, FCAL =0x00C28001, FCT =0x00008808, FCTTV =0x00000080
RDFH =0x00000BFA, RDFT =0x00000BFA, RDFPC =0x00000000
TDFH =0x00001EBA, TDFT =0x00001EBA, TDFPC =0x00000000
RX is normal, enabled TX is normal, enabled
Device status = full-duplex, link up
AN status = done(RF:0 , PAUSE:2 ), bit sync OK, rx idle stream, rx invalid
symbols, rx idle char
GBIC registers:
Register 0x00: 01 00 01 00 00 00 01 00
Register 0x08: 00 00 00 00 0D 00 00 00
Register 0x10: 32 1E 00 00 4D 65 74 68
Register 0x18: 6F 64 65 20 45 6C 65 63
Register 0x20: 2E 20 20 20 00 00 00 00
Register 0x28: 4D 47 42 43 2D 32 30 2D
Register 0x30: 34 2D 31 2D 53 20 20 20
Register 0x38: 31 30 30 30 00 00 00 55
Register 0x40: 00 0A 00 00 41 4A 42 48
Register 0x48: 47 30 36 30 20 20 20 20
Register 0x50: 20 20 20 20 30 30 30 33
Register 0x58: 32 30 20 20 00 00 00 61
PartNumber:MGBC-20-4-1-S
Cisco IOS Interface and Hardware Component Command Reference
1192
service-module t1 linecode through show controllers satellite
show controllers gigabitethernet
PartRev:G
SerialNo:AJBHG060
Options: 0
Length(9um/50um/62.5um):000/500/300
Date Code:000320
Gigabit Ethernet Codes: 1
PCI configuration registers:
bus_no=0, device_no=8
DeviceID=0x1001, VendorID=0x8086, Command=0x0156, Status=0x0230
Class=0x02/0x00/0x00, Revision=0x01, LatencyTimer=0xFC, CacheLineSize=0x20
BaseAddr0=0x48100000, BaseAddr1=0x00000000, MaxLat=0x00, MinGnt=0xFF
SubsysDeviceID=0x1001, SubsysVendorID=0x8086
Cap_Ptr=0x000000DC Retry/TRDY Timeout=0x00000000
PMC=0x00220001 PMCSR=0x00000000
I82543 Internal Driver Variables:
rxring(256)=0x2000E000, shadow=0x627DA3F0, head=203, rx_buf_size=512
txring(256)=0x20010000, shadow=0x627DA81C, head=87, tail=87
chip_state=2, pci_rev=1
tx_count=0, tx_limited=0
rx_overrun=0, rx_seq=0, rx_no_enp=0, rx_discard=0
throttled=0, enabled=0, disabled=0
reset=17(init=1, check=0, restart=3, pci=0), auto_restart=18
link_reset=0, tx_carrier_loss=1, fatal_tx_err=0
isl_err=0, wait_for_last_tdt=0
HW addr filter:0x627DB048, ISL disabled, Promiscuous mode on
Entry= 0: Addr=0000.C000.4000
(All other entries are empty)
i82543 Statistics
CRC error 0 Symbol error 7
Missed Packets 0 Single Collision 0
Excessive Coll 0 Multiple Coll 0
Late Coll 0 Collision 0
Defer 0 Receive Length 0
Sequence Error 0 XON RX 0
XON TX 0 XOFF RX 0
OFF TX 0 FC RX Unsupport 0
Packet RX (64) 11510 Packet RX (127) 17488
Packet RX (255) 1176 Packet RX (511) 7941
Packet RX (1023) 738 Packet RX (1522) 18
Good Packet RX 38871 Broadcast RX 0
Multicast RX 0 Good Packet TX 5208
Good Octets RX.H 0 Good Octets RX.L 5579526
Good Octets TX.H 0 Good Octets TX.L 513145
RX No Buff 0 RX Undersize 0
RX Fragment 0 RX Oversize 0
RX Octets High 0 RX Octets Low 5579526
TX Octets High 0 TX Octets Low 513145
TX Packet 5208 RX Packet 38871
TX Broadcast 1796 TX Multicast 330
Packet TX (64) 1795 Packet TX (127) 3110
Packet TX (255) 0 Packet TX (511) 300
Packet TX (1023) 3 Packet TX (1522) 0
TX Underruns 0 TX No CSR 0
RX Error Count 0 RX DMA Underruns 0
RX Carrier Ext 0
TCP Segmentation 0 TCP Seg Failed 0
Shared Port Adapter Examples
The following is sample output from the showcontrollersgigabitethernet command for the first
RJ-45 interface (port 0) in a 2-Port 10/100/1000 Gigabit Ethernet SPA located in the top subslot (0)
Cisco IOS Interface and Hardware Component Command Reference
1193
service-module t1 linecode through show controllers satellite
show controllers gigabitethernet
of the MSC that is installed in slot 5 on a Cisco 7304 router. This output also shows the SPA Error
counters section that appears only if one of the types of SPI4 errors occurs on the interface:
Router# show controllers gigabitethernet 0/0
Interface GigabitEthernet5/0/0
Hardware is SPA-2GE-7304
Connection mode is auto-negotiation
Interface state is up, link is up
Configuration is Auto Speed, Auto Duplex
Selected media-type is RJ45
Promiscuous mode is off, VLAN filtering is enabled
MDI crossover status: MDIX
Auto-negotiation configuration and status:
Auto-negotiation is enabled and is completed
Speed/duplex is resolved to 1000 Mbps, full duplex
Advertised capabilities: 10M/HD 10M/FD 100M/HD 100M/FD 1000M/HD 1000M/FD
Pause capable (Asymmetric)
Partner capabilities: 10M/HD 10M/FD 100M/HD 100M/FD 1000M/FD Pause capable
MAC counters:
Input: packets = 0, bytes = 0
FIFO full/reset removed = 0, error drop = 0
Output: packets = 1, bytes = 64
FIFO full/reset removed = 0, error drop = 0
Total pause frames: transmitted = 0, received = 0
FPGA counters:
Input: Total (good & bad) packets: 0, TCAM drops: 0
Satisfy (host-backpressure) drops: 0, CRC drops: 0
PL3 RERRs: 0
Output: EOP (SPI4) errors: 0
SPA carrier card counters:
Input: packets = 0, bytes = 0, drops = 0
Output: packets = 1, bytes = 60, drops = 0
Egress flow control status: XON
Per bay counters:
General errors: input = 0, output = 0
SPI4 errors: ingress dip4 = 0, egress dip2 = 0
SPA Error counters:
SPI4 TX out of frame error = 2 (00:02:31 ago)
SPI4 TX Train valid error = 1 (00:02:11 ago)
SPI4 TX DIP4 error = 1 (00:01:30 ago)
SPI4 RX out of frame error = 1 (00:00:36 ago)
SPI4 RX DIP2 error = 1 (00:00:13 ago)
MAC destination address filtering table:
Table entries: Total = 1024, Used = 3, Available = 1021
Index MAC destination address Mask
----- ----------------------- --------------
1 00b0.64ff.5aa0 ffff.ffff.ffff
2 ffff.ffff.ffff ffff.ffff.ffff
3 0100.0000.0000 0100.0000.0000
VLAN filtering table:
Number of VLANs configured on this interface = 0
Table entries: Total = 2048, Used = 2, Available = 2046
Index VLAN identifier Enabled Tunnel
----- --------------- ------- ------
1 0 No No
2 0 Yes No
Platform details:
PXF tif number: 0x10
The following is sample output from the showcontrollersgigabitethernet command for the first
fiber interface (port 0) in a 2-Port 10/100/1000 Gigabit Ethernet SPA located in the bottom subslot
(1) of the MSC that is installed in slot 4 on a Cisco 7304 router:
Cisco IOS Interface and Hardware Component Command Reference
1194
service-module t1 linecode through show controllers satellite
show controllers gigabitethernet
Router# show controllers gigabitethernet 4/1/0
Interface GigabitEthernet4/1/0
Hardware is SPA-2GE-7304
Connection mode is auto-negotiation
Interface state is up, link is up
Configuration is Auto Speed, Auto Duplex
Selected media-type is GBIC, GBIC type is 1000BaseSX
SFP is present, LOS: no, Tx fault: no, Security check status: Pass
Promiscuous mode is off, VLAN filtering is enabled
MDI configuration is automatic crossover, status is MDI
Auto-negotiation configuration and status:
Auto-negotiation is enabled and is completed
Speed/duplex is resolved to 1000 Mbps, full duplex
Advertised capabilities: 1000BaseX/FD Pause capable (Asymmetric)
Partner capabilities: 1000BaseX/FD Pause capable(Asymmetric)
MAC counters:
Input: packets = 213, bytes = 21972
FIFO full/reset removed = 0, error drop = 0
Output: packets = 216, bytes = 22932
FIFO full/reset removed = 0, error drop = 0
Total pause frames: transmitted = 0, received = 0
FPGA counters:
Input: Total (good & bad) packets: 213, TCAM drops: 183
Satisfy (host-backpressure) drops: 0, CRC drops: 0
PL3 RERRs: 0
Output: EOP (SPI4) errors: 0
SPA carrier card counters:
Input: packets = 30, bytes = 10140, drops = 0
Output: packets = 216, bytes = 22068, drops = 0
Egress flow control status: XON
Per bay counters:
General errors: input = 0, output = 0
SPI4 errors: ingress dip4 = 0, egress dip2 = 0
MAC destination address filtering table:
Table entries: Total = 1024, Used = 4, Available = 1020
Index MAC destination address Mask
----- ----------------------- --------------
1 0007.0ed3.ba88 ffff.ffff.ffff
2 ffff.ffff.ffff ffff.ffff.ffff
3 0100.0000.0000 0100.0000.0000
4 0100.0ccc.cccc ffff.ffff.ffff
VLAN filtering table:
Number of VLANs configured on this interface = 0
Table entries: Total = 2048, Used = 2, Available = 2046
Index VLAN identifier Enabled Tunnel
----- --------------- ------- ------
1 0 No No
2 0 Yes No
Platform details:
PXF tif number: 0x14
This table describes the fields shown in the interface configuration section of the display. This section
is useful for verifying the status of autonegotiation and configured parameters on the link, and the
amount of traffic being handled by the interface.
Table 61: show controllers Command Field Descriptions--Interface Section
Field Description
Interface Name of the interface.
Hardware Type of hardware.
Cisco IOS Interface and Hardware Component Command Reference
1195
service-module t1 linecode through show controllers satellite
show controllers gigabitethernet
Field Description
Connection mode Indicator of autonegotiation used to establish the connection.
Link State of the link.
Configuration Configuration of the speed and duplex operation on the interface.
Selected media-type Interface port media type: RJ45 or Gigabit Interface Converter (GBIC).
GBIC type is GBIC interface type: 1000BaseSX, 1000BaseLX, or 1000BaseZX
SFP is Indicates presence of an SFP optical transceiver.
LOS Indicates whether or not the SFP detects a loss of signal (LOS).
Tx fault Indicates whether or not the SFP detects a transmission fault.
Security check status Indicates whether or not the SFP passes the security check. The SPA enables a
security check by default to verify whether a Cisco-approved SFP is inserted. If
the SFP is not a Cisco-approved device, the link is brought down.
Promiscuous mode State of promiscuous mode (on or off). When promiscuous mode is on, the SPA
disables MAC destination address and VLAN filtering. When promiscuous mode
is off, the SPA enables MAC destination address and VLAN filtering.
VLAN filtering Status of ternary content addressable memory (TCAM) filtering of VLANs
(enabled or disabled). By default, the SPA always enables VLAN filtering.
The SPA disables VLAN filtering if the TCAM table is full, or if the SPA is
operating in promiscuous mode.
Note VLAN filtering is not enabled or disabled using any command-line
interface (CLI) command.
MDI crossover status State of the media dependent interface (MDI) for the PHY device on the specified
interface. The possible values are MDI for straight-through cables or media
dependent interface crossover (MDI-X) for crossover cables.
Auto-negotiation State of autonegotiation (enabled or disabled) on the interface and its current
status.
Speed/duplex is resolved Results of autonegotiated parameter values (speed and duplex) currently being
to used on the link.
Advertised capabilities List of the possible combinations of speed and duplex modes (in speed/duplex
format) and flow control that the local interface has advertised it supports to the
remote device:
• For speed--10M is 10 Mbps, 100M is 100 Mbps, and 1000M is 1000 Mbps.
• For duplex--HD is half duplex, and FD is full duplex.
• For flow control--“Pause capable (Asymmetric)” means that the SPA
advertises support of the PAUSE flow control bit and the ASM_DIR
(asymmetric) flow control bit.
Cisco IOS Interface and Hardware Component Command Reference
1196
service-module t1 linecode through show controllers satellite
show controllers gigabitethernet
Field Description
Partner capabilities List of the possible combinations of speed and duplex modes (in speed/duplex
format) and flow control that the remote device has advertised it supports to the
local interface:
• For speed--10M is 10 Mbps, 100M is 100 Mbps, and 1000M is 1000 Mbps.
• For duplex--HD is half duplex, and FD is full duplex.
• For flow control--“Pause capable” means that the remote device supports
implementation of the PAUSE flow control bit; “Pause capable
(Asymmetric)” means that the remote device supports implementation of
the PAUSE flow control bit and the ASM_DIR (asymmetric) flow control
bit.
This table describes the fields shown in the MAC counters section of the display. This section is
useful for verifying the status of packets processed by the MAC device for the interface. This
information is useful for Cisco Systems technical support personnel.
Table 62: show controllers Command Field Descriptions--MAC Counters Section
Field Description
Input: packets, bytes Total number of packets and bytes received by the MAC device for the
interface since it was activated or cleared.
You can clear these counters using the clearcounters privileged EXEC
command.
Input: FIFO full/reset removed Total number of packets removed by the MAC device due to a first-in, first-out
(FIFO) overflow condition in the input buffer for the interface.
Input: error drop Total number of input packets with errors that are dropped by the MAC device
for the interface.
Output: packets, bytes Total number of packets and bytes transmitted by the MAC device for the
interface since it was activated or cleared.
You can clear these counters using the clearcounters privileged EXEC
command.
Output: FIFO full/reset Total number of packets removed by the MAC device due to a first-in, first-out
removed (FIFO) overflow condition in the output buffer for the interface.
Output: error drop Total number of output packets with errors that are dropped by the MAC
device for the interface.
SPI3: disabled port drop Total number of packets dropped by the MAC device at the System Packet
Interface Level 3 (SPI3) path between the MAC device and FPGA device
due to a disabled port condition.
SPI3: sync error drop Total number of packets dropped by the MAC device at the SPI3 path between
the MAC device and FPGA device due to a sync error (synchronization bits
altered) condition.
Cisco IOS Interface and Hardware Component Command Reference
1197
service-module t1 linecode through show controllers satellite
show controllers gigabitethernet
Field Description
SPI3: short packet drop Total number of packets dropped by the MAC device at the SPI3 path between
the MAC device and FPGA device due to a short packet (packet length is
less than 64 bytes) condition.
SPI3: parity error drop Total number of packets dropped by the MAC device at the path between
the MAC device and FPGA device due to a parity error (parity bit is altered
during data transmission) condition.
Total pause frames Total number of Ethernet 802.3x pause frames transmitted and received by
the MAC device for flow control on the interface.
This table describes the fields shown in the FPGA counters section of the display. This section is
useful for verifying the status of packets processed by the FPGA device for the interface. This
information is useful for Cisco Systems technical support personnel.
Table 63: show controllers Command Field Descriptions--FPGA Counters Section
Field Description
Input: Total (good & bad) Total number of packets received by the FPGA device in the ingress direction
packets for the interface.
Input: TCAM drops Total number of packets dropped by the FPGA device in the ingress direction
for the interface due to a ternary content addressable memory (TCAM) lookup
failure. This counter increments when the interface receives a frame with a
destination MAC address or VLAN identifier that is not present in the TCAM
table.
Input: Satisfy Total number of packets dropped by the FPGA device in the ingress direction
(host-backpressure) drops for the interface due to back-pressure from the MSC.
Input: CRC drops Total number of packets dropped by the FPGA device in the ingress direction
for the interface due to cyclic redundancy check (CRC) errors.
Input: PL3 RERRs Total number of packets with errors received for the interface by the FPGA
device in the ingress direction over the SPI3 (PL3) path from the MAC device
to the FPGA device.
Output: EOP (SPI4) errors Total number of packets with end-of-packet (EOP) errors received by the
FPGA device in the egress direction for the interface over the System Packet
Interface Level 4 (SPI4) path from the MSC to the FPGA device.
The following table describes the fields shown in the SPA carrier card counters section of the display.
This section is useful for verifying the status of packets processed by the MSC for the interface. This
information is useful for Cisco Systems technical support personnel.
Cisco IOS Interface and Hardware Component Command Reference
1198
service-module t1 linecode through show controllers satellite
show controllers gigabitethernet
Table 64: show controllers Command Field Descriptions--SPA Carrier Card Counters Section
Field Description
Input: packets, bytes, drops Total number of packets, bytes, and packet drops that have occurred on the
SPI4 path from the FPGA device to the MSC.
Output: packets, bytes, Total number of packets, bytes, and packet drops that have occurred on the
drops SPI4 path from the MSC to the FPGA device.
Egress flow control status Status of flow control between the MSC and the Route Processor (RP). The
possible values are:
• XON--A control frame has been sent by the MSC to the RP to indicate
that the MSC is ready to accept data.
• XOFF--A control frame has been sent by the MSC to the RP to indicate
congestion on the MSC. The MSC cannot accept any more data from the
RP during this condition.
General errors Total number of errors (such as parity) on the MSC in the ingress and egress
direction.
SPI4 errors: ingress dip4 Total number of 4-bit Diagonal Interleaved Parity (DIP4) errors in the ingress
direction on the SPI4 path from the FPGA device to the MSC.
DIP4 is a parity algorithm where a 4-bit odd parity is computed diagonally
over control and data words.
SPI4 errors: egress dip2 Total number of 2-bit Diagonal Interleaved Parity (DIP2) errors in the egress
direction on the SPI4 path from the FPGA device to the MSC.
DIP2 is a parity algorithm where a 2-bit odd parity is computed diagonally
over status words.
The following table describes the fields shown in the SPA error counters section of the display. This
section appears only when one of the SPI4 transmit or receive errors occurs on the interface. This
information is useful for Cisco Systems technical support personnel.
Note None of the SPA SPI4 error counters appear in showcontrollersgigabitethernet command output
until at least one of those types of SPI4 errors occurs.
All of the errors in the SPA error counters section are subject to the SPA automatic recovery process
when certain thresholds are reached. For more information about this process on the Cisco 7304
router, refer to the “Understanding SPA Automatic Recovery” section of the Cisco 7304 Router
Modular Services Card and Shared Port Adapter Software Configuration Guide .
Cisco IOS Interface and Hardware Component Command Reference
1199
service-module t1 linecode through show controllers satellite
show controllers gigabitethernet
Table 65: show controllers Command Field Descriptions--SPA Error Counters Section
Field Description
SPI4 TX out of frame error Number of SPI4 out of frame errors (events) detected in the transmit direction
= (hh:mm:ss ago) (toward the network), from the MSC to the SPA FPGA device. The time stamp
indicates how long ago (in hours:minutes:seconds) from the current system time,
that the last error was detected.
This error indicates a loss of synchronization between the synchronization block
and the data received on the SPI4 path. When synchronization is reacquired, the
error no longer occurs.
SPI4 TX Train valid error Number of times that a low-level synchronization problem was detected in the
= (hh:mm:ss ago) transmit direction (toward the network), from the MSC to the SPA FPGA device.
The time stamp indicates how long ago (in hours:minutes:seconds) from the
current system time, that the last error was detected.
SPI4 TX DIP4 error = Number of 4-bit Diagonal Interleaved Parity (DIP4) errors in the transmit
(hh:mm:ss ago) direction (toward the network), from the MSC to the SPA FPGAdevice. The
time stamp indicates how long ago (in hours:minutes:seconds) from the current
system time, that the last error was detected.
DIP4 is a parity algorithm where a 4-bit odd parity is computed diagonally over
control and data words.
SPI4 RX out of frame Number of SPI4 out of frame errors (events) detected in the receive direction
error = (hh:mm:ss ago) (from the network), from the SPA FPGA device to theMSC. The time stamp
indicates how long ago (in hours:minutes:seconds) from the current system time,
that the last error was detected.
This error indicates a loss of synchronization between the synchronization block
and the data received on the SPI4 path. When synchronization is reacquired, the
error no longer occurs.
SPI4 RX DIP2 error = Number of 2-bit Diagonal Interleaved Parity (DIP2) errors in the receive direction
(hh:mm:ss ago) (from the network), from theSPA FPGA device to the MSC. The time stamp
indicates how long ago (in hours:minutes:seconds) from the current system time,
that the last error was detected.
DIP2 is a parity algorithm where a 2-bit odd parity is computed diagonally over
status words.
The following table describes the fields shown in the MAC destination address filtering table section
of the display. This section is useful for verifying the multicast destination addresses that are in the
TCAM table and permitted by the interface. This information is useful for Cisco Systems technical
support personnel.
Cisco IOS Interface and Hardware Component Command Reference
1200
service-module t1 linecode through show controllers satellite
show controllers gigabitethernet
Table 66: show controllers Command Field Descriptions--MAC Destination Address Filtering Table Section
Field Description
Table entries: Total, Total number of MAC destination address entries possible in the TCAM table for
Used the interface, and the number of table entries currently used by the interface.
The 2-Port 10/100/1000 Gigabit Ethernet SPA supports a 512-entry MAC filtering
table for each supported interface (1024 entries total on the card).
Index Table entry identifier.
MAC destination MAC destination address (multicast) permitted by the interface and used in the
address TCAM lookup table for packet filtering.
The multicast MAC entries typically come from routing protocols [such as Open
Shortest Path First (OSPF) and Enhanced IGRP (EIGRP)], and other protocols
including the Hot Standby Router Protocol (HSRP).
When the router reloads, three addresses appear by default in the MAC filtering
table: the unicast address of the local interface, the Ethernet broadcast address, and
the Ethernet multicast address.
Mask Mask for the corresponding destination address. The SPA uses the bits that are set
in the mask to look up the address in the TCAM table.
The following table describes the fields shown in the VLAN filtering table section of the display.
This section is useful for verifying the VLANs that are in the TCAM table and are permitted by the
interface. This information is useful for Cisco Systems technical support personnel.
Table 67: show controllers Command Field Descriptions--VLAN Filtering Table Section
Field Description
Number of VLANs Number of VLANs that are configured on the interface.
configured on this
If the number of VLANs configured on the interface is 1022 or less, then the VLAN
interface
filtering table also shows an index entry for every VLAN ID. The number of VLANs
configured on the interface can be 0, while the number of used table entries reports
2, because the SPA always uses two entries to provide valid matching criteria for
promiscuous mode and non-VLAN packets.
Table entries: Total, Total number of VLAN entries possible in the TCAM filtering table for the interface,
Used, Available the number of table entries currently used by the interface (two are always in use by
default), and the number of table entries that remain available.
The 2-Port 10/100/1000 Gigabit Ethernet SPA supports a 1024-entry VLAN filtering
table for each supported interface (2048 entries total on the card).
Index Table entry identifier.
VLAN identifier Number of the VLAN. Two VLAN ID 0 entries always appear in the table and represent
the local interface port for handling of promiscuous mode and non-VLAN packets.
Other VLAN entries appear in this table when VLANs are configured on the interface.
Cisco IOS Interface and Hardware Component Command Reference
1201
service-module t1 linecode through show controllers satellite
show controllers gigabitethernet
Field Description
Enabled Status of the VLAN ID for TCAM filtering, with the following possible values:
• No--The entry is disabled for filtering.
• Yes--The entry is enabled for filtering.
The TCAM filter uses the “first-match” rule to filter packets that the SPA receives
against entries in the table. The matching assessment begins at the top of the table
with the VLAN ID 0 entries.
Note The SPA always supports two VLAN ID 0 entries. The first VLAN ID 0
entry of the TCAM table is used for promiscuous mode. It has a value of
“No,” meaning it is disabled, whenever promiscuous mode is disabled for
the interface. The second VLAN ID 0 entry is used for filtering of
non-VLAN packets.
Tunnel Status of tunneling for the interface, with the following possible values:
• No--Tunneling is disabled and theSPA performs MAC destination address
filtering.
• Yes--Tunneling is enabled and the SPA does not perform MAC destination
address filtering.
Note If promiscuous mode is enabled, then the first VLAN ID 0 entry shows
tunnel = Yes. All other VLAN ID entries show tunnel = No.
The following table describes the fields shown in the platform details section of the display.
Table 68: show controllers Command Field Descriptions--Platform Details Section
Field Description
PXF tif number Number of the interface (in hexadecimal format) used for PXF on the network services
engine (NSE) or by the Hyper Transport (HT) FPGA device on the network processing
engine (NPE).
Related Commands Command Description
show interfaces gigabitethernet Displays software and hardware information about a Gigabit Ethernet
interface.
Cisco IOS Interface and Hardware Component Command Reference
1202
service-module t1 linecode through show controllers satellite
show controllers integrated-service-engine
show controllers integrated-service-engine
To show the Cisco wireless LAN controller network module (WLCM) on the router, use the
showcontrollersintegrated-service-engine command in privileged EXEC mode.
show controllers integrated-service-engine slot/unit
Syntax Description slot/unit Specifies the router slot and unit numbers for the WLCM.
Command Default None
Command Modes Privileged EXEC
Command History Release Modification
12.4(15)T This command was introduced.
Examples The following example shows how to display interface information for the WLCM:
Router# show controllers integrated-service-engines
1/0
Interface integrated-service-engine 1/0
Hardware is Intel 82559 FastEthernet
IDB: 67796B08, FASTSEND: 60E073CC, MCI_INDEX: 0
INSTANCE=0x67797BE8
Rx Ring entries = 64
Rx Shadow = 0x67797ED0
Rx Ring = 0x2DCC1840
Rx Ring Head = 5
Rx Ring Last = 4
Rx Buffer Descr = 0x2DCC3040
Rx Buffer Descr Head = 5
Rx Buffer Descr Last = 4
(cont...)
Receive All Multicasts = enabled
Receive Promiscuous = disabled
Loopback Mode = disabled
Module Reset Statistics:
CLI reset count = 0
CLI reload count = 0
Registration request timeout reset count = 0
Error recovery timeout reset count = 0
Module registration count = 1
Cisco IOS Interface and Hardware Component Command Reference
1203
service-module t1 linecode through show controllers satellite
show controllers ism
show controllers ism
To display controller information for the internal service module interface, use the showcontrollersism
command in user EXEC or privileged EXEC mode.
show controllers ism slot/port
Syntax Description slot Router slot in which the service module is installed. For internal service modules, always use 0.
/ port Port number of the module interface. Always use 0. The slash mark (/) is required.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines The output from this command is generally useful for diagnostic tasks performed by technical support only.
You can, however, use the displayed hardware statistics to obtain the receive and transmit packet statistics
that are collected by the hardware controller during packet processing.
Examples The following example shows how to display information for the ISM installed in the router:
Router# show controllers ism 0/0
Interface ISM0/0
Hardware is PSE2
HWIDB: 0x01395BF0 INSTANCE: 0x11E75280, FASTSEND: 0x040D6C44
Init flags: 0x23
FPGA registers
----------------
Base address: 0xE2000000 Revision: 0x09030416
FPGA type: 0x72676D69 FPGA_error_val: 0x00000000
Cfg MSI mask: 0x00000008 Rx_buffer_size: 0x00000600
Frame statistics: (polling enabled)
-----------------------------------
tx_frame_cnt: 677 rx_frame_cnt: 333
tx_byte_cnt: 104953 rx_byte_cnt: 35076
tx_pause_frame_cnt: 0 rx_pause_frame_cnt: 0
rx_unicast_filtered_cnt: 0 rx_multicast_filtered_cnt: 8
rx_undersize_pkts: 0 rx_oversize_pkts: 0
tx_64_byte_pkts: 435 rx_64_byte_pkts: 217
tx_65_to_127_byte_pkts: 17 rx_65_to_127_byte_pkts: 8
tx_128_to_255_byte_pkts: 4 rx_128_to_255_byte_pkts: 108
tx_256_to_511_byte_pkts: 221 rx_256_to_511_byte_pkts: 0
tx_512_to_1023_byte_pkts: 0 rx_512_to_1023_byte_pkts: 0
tx_1024_to_1518_byte_pkts: 0 rx_1024_to_1518_byte_pkts: 0
rx_congestion_drop_cnt: 0 rx_mtusize_drop_cnt: 0
rx_bad_cnt: 0
Interrupt statistics
--------------------
ge_tx_interrupt: 569 ge_rx_interrupt: 326
Cisco IOS Interface and Hardware Component Command Reference
1204
service-module t1 linecode through show controllers satellite
show controllers ism
txbd_seq_err: 0 txbd_done_err: 0
rxbd_done_err: 0 isl_inner_crc_err: 0
pcie_busmstr_dsbld_err: 0 pcie_tgt_abort_err: 0
pcie_mst_abort_err: 0 spi_done_event: 0
rx_empty_pak: 0 rx_sw_usage_err: 0
ing_buf_adrs_err: 0 pcie_null_ptr_err: 0
uart_tx_intr: 58 uart_rx_intr: 9036
uart_break_detected: 0 uart_framing_err: 0
uart_bad_egr_adrs: 0 uart_egr_overflow: 0
i2c_errs: misc/nack/tmo: 0/0/0
TX ring
-------
Tx Ring txr_head/txr_tail: 167/167
Tx Shadow txs_head/txs_tail/txs_free: 167/167/256
Tx Ring(txr): 0x3CF84800 Tx Shadow (malloc): 0x11E75500
Tx Limited: 0 Tx Count: 0 hold_pak 0x00000000
RX rings
--------
size: 256 max_spin_size 32 head: 70
Rx Ring(rxr): 0x3CF84000 rxr_malloc: 0x3CF84000
Rx Shadow(rxs): 0x13969F4 rxs_malloc: 0x13969F4
Software MAC Address Filter (hash:length/addr/mask/hits)
--------------------------------------------------------
000: 0 ffff.ffff.ffff 0000.0000.0000 2
039: 0 001e.4a97.646d 0000.0000.0000 0
192: 0 0180.c200.0002 0000.0000.0000 0
192: 1 0100.0ccc.cccc 0000.0000.0000 106
197: 0 0180.c200.0007 0000.0000.0000 0
Software filtered frames: 0
Unicast overflow mode: 0
Multicast overflow mode: 1
Promiscuous mode: 0
HW MAC Address Filter
---------------------
Unicast Addr0: 001E.4A97.646D
Unicast Addr1: 0000.0000.0100
Unicast Addr2: 0000.0000.0100
Unicast Addr3: 0000.0000.0100
Unicast Addr4: 0000.0000.0100
Unicast HW Filter Count : 1
Multicast Hash b63_32: 0x2000001
Multicast Hash b32_00: 0x00
HW unicast filter enabled: Yes
HW multicast filter enabled: Yes
FPGA upgrade info
-----------------
Golden area fpga version: 00000000
Upgrade area fpga version: 09030416
IOS bundled fpga version: 09030416
The table below describes the significant fields shown in the display.
Cisco IOS Interface and Hardware Component Command Reference
1205
service-module t1 linecode through show controllers satellite
show controllers ism
Table 69: show controllers analysis-module Field Descriptions
Field Description
Hardware Description of the chip being used.
IDB, FASTSEND Address in router memory of the Interface Descriptor Block (IDB) and
the fastsend routine.
INSTANCE Device-specific data stored in router memory that lists the memory
locations and current indexes of receive (Rx) and transmit (Tx) rings in
router I/O memory.
CONTROL AND STATUS Control and status registers that are physically located on the chip itself
REGISTERS (CSR) and that are accessed by the CPU over the Peripheral Component
Interconnect (PCI) bus.
PHY REGISTERS Contents of the PHY registers. PHY is a device that interfaces the
physical Ethernet line and that is located between the chip and the
physical line.
HARDWARE STATISTICS Receive (Rx) and transmit (Tx) traffic statistics collected by the chip.
INTERRUPT STATISTICS Transmit (Tx), Receive (Rx), control, software, and flow control interrupt
statistics collected by the chip.
Related Commands Command Description
service-module ism status Displays hardware and software status information about the ISM.
show interfaces ism Displays status, traffic data, and configuration information about the ISM
interface.
Cisco IOS Interface and Hardware Component Command Reference
1206
service-module t1 linecode through show controllers satellite
show controllers j1
show controllers j1
To display statistics about the J1 link, use the showcontrollersj1command in privileged EXEC mode.
show controllers j1 slot/port
Syntax Description slot / port Backplane slot and port number on the controller.
Command Modes Privileged EXEC
Command History Release Modification
12.2(8)T The command was introduced on the J1 controller for the Cisco 2600 and Cisco 3600 series.
Examples The following is sample output from the showcontrollersj1command on the Cisco 3660:
Router# show controllers j1 3/0
J1 3/0 is up.
Applique type is Channelized J1 - TTC2M
No alarms detected.
Version info Firmware: 20010530, FPGA: 1
Framing is J1-TTC2M MF, Line Code is CMI, Clock Source is Line.
Data in current interval (344 seconds elapsed):
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs
Total Data (last 24 hours)
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins,
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs
The table below describes the fields shown in the display.
Table 70: show controllers j1 Field Descriptions
Field Description
j1 3/0 is up. The J1 controller 3 in slot 0 is operating. The controller’s state can be up, down,
or administratively down.
Applique type The applique type is shown and is always Channelized.
Cisco IOS Interface and Hardware Component Command Reference
1207
service-module t1 linecode through show controllers satellite
show controllers j1
Field Description
No alarms detected Any alarms detected by the controller are displayed here. Possible alarms are
as follows:
• Transmitter is sending remote alarm.
• Transmitter is sending AIS.
• Receiver has loss of signal.
• Receiver is getting AIS.
• Receiver has loss of frame.
• Receiver has remote alarm.
• Receiver has no alarms.
Version Indicates date of compilation.
Framing is Shows the current framing type which is always J1-TTC2M MF.
Linecode is Shows the current line encoding type which is always coded mark inversion
(CMI).
Clock Source Shows the current clock source type.
Data in current interval (344 Shows the current accumulation period, which rolls into the 24-hour
seconds elapsed) accumulation every 15 minutes. Accumulation period is from 1 to 900 seconds.
The oldest 15-minute period falls off the back of the 24-hour accumulation
buffer.
Slip Secs Indicates the replication or deletion of the payload bits of a DS1 frame. A slip
might be performed when there is a difference between the timing of a
synchronous receiving terminal and the received signal.
Fr Loss Secs Indicates the number of seconds an Out of Frame (OOF) error is detected.
Line Err Secs Line errored seconds (LES) is a second in which one or more line code violation
errors are detected.
Degraded Mins A degraded minute is one in which the estimated error rate exceeds 1E-6 but
does not exceed 1E-3.
Errored Secs An errored second is a second in which one of the following are detected:
• One or more path code violations.
• One or more out of rame defects.
• One or more controlled slip events.
• A detected alarm indication signal (AIS) defect.
Cisco IOS Interface and Hardware Component Command Reference
1208
service-module t1 linecode through show controllers satellite
show controllers j1
Field Description
Bursty Err Secs A second with fewer than 320 and more than 1 path coding violation error, no
severely errored frame defects, and no detected incoming AIS defects.
Controlled slips are not included in this parameter.
Severely Err Secs A severely err sec is a second with one of the following errors: 320 or more
path code violation errors; one or more out of frame defects; a detected AIS
defect.
Unavail Secs A count of the total number of seconds where the controller did not get a clock.
Cisco IOS Interface and Hardware Component Command Reference
1209
service-module t1 linecode through show controllers satellite
show controllers lex
show controllers lex
To show hardware and software information about the LAN Extender chassis, use the showcontrollerslex
command in EXEC mode.
show controllers lex [number]
Cisco 7500 Series
show controllers lex [slot/port]
Syntax Description number (Optional) Number of the LAN Extender interface about which to display information.
slot (Optional) Number of the slot being configured. Refer to the appropriate hardware manual for
slot and port information.
port (Optional) Number of the port being configured. Refer to the appropriate hardware manual for
slot and port information.
Command Modes EXEC
Command History Release Modification
11.0 This command was introduced.
12.2(15)T This command is no longer supported in Cisco IOS Mainline or Technology-based releases.
It may conintue to appear in Cisco IOS 12.2S-family releases.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use the showcontrollerslex command to display information about the hardware revision level, software
version number, Flash memory size, serial number, and other information related to the configuration of the
LAN Extender.
Examples The following is a sample output from the showcontrollerslex command:
Router# show controllers lex 0
Lex0:
FLEX Hardware revision 1
FLEX Software version 255.0
128K bytes of flash memory
Serial number is 123456789
Station address is 0000.4060.1100
The following is a sample output from the showcontrollerslex command when the LAN Extender
interface is not bound to a serial interface:
Router#
Cisco IOS Interface and Hardware Component Command Reference
1210
service-module t1 linecode through show controllers satellite
show controllers lex
show controllers lex 1
Lex1 is not bound to a serial interface
The table below describes the fields shown in the preceding output.
Table 71: show controllers lex Field Descriptions
Field Description
Lex0: Number of the LAN Extender interface.
FLEX Hardware revision Revision number of the Cisco 1000 series LAN Extender chassis.
FLEX Software version Revision number of the software running on the LAN Extender chassis.
128K bytes of Flash memory Amount of Flash memory in the LAN Extender.
Serial number Serial number of the LAN Extender chassis.
Station address MAC address of the LAN Extender chassis.
Cisco IOS Interface and Hardware Component Command Reference
1211
service-module t1 linecode through show controllers satellite
show controllers mci
show controllers mci
To display all information under the Multiport Communications Interface (MCI) card or the Serial
Communications Interface (SCI) card, use the showcontrollersmci command in privileged EXEC mode.
show controllers mci
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command displays information that the system uses for bridging and routing that is specific to the interface
hardware. The information displayed is generally useful for diagnostic tasks performed by technical support
personnel.
The interface type is queried only at startup. If the hardware changes subsequent to initial startup, the wrong
type is reported. This has no adverse effect on the operation of the software. For instance, if a DCE cable is
connected to a dual-mode V.35 applique after the unit has been booted, the display presented for the
showinterfaces command incorrectly reports attachment to a DTE device although the software recognizes
the DCE interface and behaves accordingly.
Examples The following is sample output from the showcontrollersmci command:
Router# show controllers mci
MCI 0, controller type 1.1, microcode version 1.8
128 Kbytes of main memory, 4 Kbytes cache memory
22 system TX buffers, largest buffer size 1520
Restarts: 0 line down, 0 hung output, 0 controller error
Interface 0 is Ethernet0, station address 0000.0c00.d4a6
15 total RX buffers, 11 buffer TX queue limit, buffer size 1520
Transmitter delay is 0 microseconds
Interface 1 is Serial0, electrical interface is V.35 DTE
15 total RX buffers, 11 buffer TX queue limit, buffer size 1520
Transmitter delay is 0 microseconds
High speed synchronous serial interface
Interface 2 is Ethernet1, station address aa00.0400.3be4
15 total RX buffers, 11 buffer TX queue limit, buffer size 1520
Transmitter delay is 0 microseconds
Interface 3 is Serial1, electrical interface is V.35 DCE
15 total RX buffers, 11 buffer TX queue limit, buffer size 1520
Transmitter delay is 0 microseconds
High speed synchronous serial interface
The table below describes significant fields shown in the display.
Cisco IOS Interface and Hardware Component Command Reference
1212
service-module t1 linecode through show controllers satellite
show controllers mci
Table 72: show controllers mci Field Descriptions
Field Description
MCI 0 Card type and unit number (varies depending on card).
controller type 1.1 Version number of the card.
microcode version 1.8 Version number of the card’s internal software (in ROM).
128 Kbytes of main memory Amount of main memory on the card.
4 Kbytes cache memory Amount of cache memory on the card.
22 system TX buffers Number of buffers that hold packets to be transmitted.
largest buffer size 1520 Largest size of these buffers (in bytes).
Restarts Count of restarts for the following conditions:
• 0 line down • Communication line down
• 0 hung output • Output unable to transmit
• 0 controller error • Internal error
Interface 0 is Ethernet0 Names of interfaces, by number.
electrical interface is V.35 DTE Line interface type for serial connections.
15 total RX buffers Number of buffers for received packets.
11 buffer TX queue limit Maximum number of buffers in transmit queue.
Transmitter delay is 0 microseconds Delay between outgoing frames.
Station address 0000.0c00.d4a6 Hardware address of the interface.
Related Commands Command Description
tx-queue-limit Controls the number of transmit buffers available to a specified interface on the MCI and
SCI cards.
Cisco IOS Interface and Hardware Component Command Reference
1213
service-module t1 linecode through show controllers satellite
show controllers pcbus
show controllers pcbus
To display all information about the bus interface, use the showcontrollerspcbus command in privileged
EXEC mode.
show controllers pcbus
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC
Command History Release Modification
11.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command is valid on LanOptics Branchcard or Stacknet 2000 products only.
Examples The following is sample output from the showcontrollerspcbus command:
Router# show controllers pcbus
PCbus unit 0, Name = PCbus0 Hardware is ISA PCbus shared RAM
IDB at 0x3719B0, Interface driver data structure at 0x3735F8
Control/status register at 0x2110008, Shared memory at 0xC000000
Shared memory is initialized
Shared memory interface control block :
Magic no = 0x41435A56 (valid) Version = 1.0
Shared memory size = 64K bytes, Interface is NOT shutdown
Interface state is up, line protocol is up
Tx buffer : (control block at 0xC000010)
Start offset = 0x30, Size = 0x7FE8, Overflows = 1
GET_ptr = 0x4F6C, PUT_ptr = 0x4F6C, WRAP_ptr = 0x3BB0
Rx buffer : (control block at 0xC000020)
Start offset = 0x8018, Size 0x7FE8, Overflows = 22250698
GET_ptr = 0x60, PUT_ptr = 0x60, WRAP_ptr = 0x7FD0
Interrupts received = 567
Cisco IOS Interface and Hardware Component Command Reference
1214
service-module t1 linecode through show controllers satellite
show controllers pos
show controllers pos
To display information about the Packet over SONET (POS) controllers, use the showcontrollerspos command
in privileged EXEC mode.
Cisco 7500 Series Routers
show controllers pos [slot/port-adapter/port] [{details|pm [time-interval]}]
Cisco 12000 Series Routers
show controllers pos [slot/port] [{details|pm [time-interval]}]
POS Shared Port Adapters
show controllers pos [slot/subslot/port [/sub_int]] [{alarm|details|pm [time-interval]}]
Syntax Description slot / (Optional) Cisco 7500 Series Routers
port-adapter /
Number of the chassis slot that contains the POS interface (for example, 2/0/0), where:
port
• slot --Chassis slot number.
• / port-adapter-- Port adapter number.
• / port-- Port or interface number.
Refer to the appropriate hardware manual for slot and port information, and port adapter
compatibility.
slot / port (Optional) Cisco 12000 Series Routers
Number of the chassis slot that contains the POS interface (for example, 4/0), where:
• slot --Chassis slot number.
• / port-- Port or interface number.
Refer to the appropriate hardware manual for slot and port information.
Cisco IOS Interface and Hardware Component Command Reference
1215
service-module t1 linecode through show controllers satellite
show controllers pos
slot / subslot / (Optional) POS Shared Port Adapters
port / sub_int
Number of the chassis slot that contains the POS interface (for example 4/3/0), where:
• slot --Chassis slot number.
Refer to the appropriate hardware manual for slot information. For SIPs, refer to the
platform-specific SPA hardware installation guide or the corresponding “Identifying
Slots and Subslots for SIPs and SPAs” topic in the platform-specific SPA software
configuration guide.
• / subslot-- Secondary slot number on a SPA interface processor (SIP) where a
SPA is installed.
Refer to the platform-specific SPA hardware installation guide and the corresponding
“Specifying the Interface Address on a SPA” topic in the platform-specific SPA software
configuration guide for subslot information.
• / port --Port or interface number.
For SPAs, refer to the corresponding “Specifying the Interface Address on a SPA”
topics in the platform-specific SPA software configuration guide.
• / sub_int -- (Optional) Subinterface number.
alarm (Optional) Displays SONET/SDH alarm event counters.
details (Optional) In addition to the normal information displayed by the showcontrollerspos
command, the details keyword provides a hexadecimal and ASCII “dump” of the path
trace buffer.
pm (Optional) Displays SONET performance monitoring statistics accumulated for a
24-hour period in 15-minute intervals.
time-interval (Optional) Number of the SONET MIB 15-minute time interval in the range from 1
to 96. If the time-intervalargument is not specified, the performance monitoring statistics
for the current time interval are displayed.
Command Default If you do not specify any slot addressing, information for all installed POS interfaces is displayed.
Command Modes Privileged EXEC
Command History Release Modification
11.1CC This command was introduced.
12.2S This command was integrated into Cisco IOS Release 12.2S.
12.2(25)S3 This command was integrated into Cisco IOS Release 12.2(25)S3 to support SPAs on the
Cisco 7304 router. The command was modified to support a new addressing format for SPAs
on the Cisco 7304 router.
12.2(18)SXE This command was integrated into Cisco IOS Release 12.2(18)SXE to support SPAs on the
Cisco 7600 series routers and Catalyst 6500 series switches.
Cisco IOS Interface and Hardware Component Command Reference
1216
service-module t1 linecode through show controllers satellite
show controllers pos
Release Modification
12.0(31)S This command was integrated into Cisco IOS Release 12.0(31)S to support SPAs on the Cisco
12000 series routers.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The showcontrollerspos command with the pm keyword displays SONET performance monitoring statistics
accumulated at 15-minute intervals, and these statistics can be queried using Simple Network Management
Protocol (SNMP) tools. The performance monitoring statistics are collected according to the RFC 1595
specification.
The information that this command displays is generally useful only for diagnostic tasks performed by Cisco
Systems technical support personnel.
Examples
Example of the show controllers pos Command on the Cisco 7500 Series Router
The following is sample output from the showcontrollerspos command on a Cisco 7500 series
router:
Router# show controllers pos
POS2/0/0
SECTION
LOF = 0 LOS = 2335 BIP(B1) = 77937133
LINE
AIS = 2335 RDI = 20 FEBE = 3387950089 BIP(B2) = 1622825387
PATH
AIS = 2340 RDI = 66090 FEBE = 248886263 BIP(B3) = 103862953
LOP = 246806 NEWPTR = 11428072 PSE = 5067357 NSE = 4645
Active Defects: B2-TCA B3-TCA
Active Alarms: None
Alarm reporting enabled for: B1-TCA
APS
COAPS = 12612784 PSBF = 8339
State: PSBF_state = False
Rx(K1/K2): 00/CC Tx(K1/K2): 00/00
S1S0 = 03, C2 = 96
CLOCK RECOVERY
RDOOL = 64322060
State: RDOOL_state = True
PATH TRACE BUFFER: UNSTABLE
Remote hostname :
Remote interface:
Remote IP addr :
Remote Rx(K1/K2): ../.. Tx(K1/K2): ../..
BER thresholds: SF = 10e-3 SD = 10e-8
TCA thresholds: B1 = 10e-7 B2 = 10e-3 B3 = 10e-6
The table below describes the fields shown in this display.
Table 73: show controllers pos Field Descriptions
Field Description
POSx/y/z Slot number of the POS interface.
Cisco IOS Interface and Hardware Component Command Reference
1217
service-module t1 linecode through show controllers satellite
show controllers pos
Field Description
LOF Section loss of frame is detected when a severely error framing (SEF) defect on
the incoming SONET signal persist for 3 milliseconds.
LOS Section loss of signal is detected when an all-zeros pattern on the incoming
SONET signal lasts 19 plus or minus 3 microseconds or longer. This defect might
also be reported if the received signal level drops below the specified threshold.
BIP(B1)/BIP(B2)/BIP(B3) Bit interleaved parity (BIP).
For B1, the BIP error report is calculated by comparing the BIP-8 code with the
BIP-8 code extracted from the B1 byte of the following frame. Differences indicate
that section-level bit errors have occurred.
For B2, the BIP error report is calculated by comparing the BIP-8/24 code with
the BIP-8 code extracted from the B2 byte of the following frame. Differences
indicate that line-level bit errors have occurred.
For B3, the BIP error report is calculated by comparing the BIP-8 code with the
BIP-8 code extracted from the B3 byte of the following frame. Differences indicate
that path-level bit errors have occurred.
AIS Alarm indication signal.
A line alarm indication signal is sent by the section terminating equipment (STE)
to alert the downstream line terminating equipment (LTE) that a loss of signal
(LOS) or loss of frame (LOF) defect has been detected on the incoming SONET
section.
A path alarm indication signal is sent by the LTE to alert the downstream path
terminating equipment (PTE) that it has detected a defect on its incoming line
signal.
RDI Remote defect indication.
A line remote defect indication is reported by the downstream LTE when it detects
LOF, LOS, or AIS.
A path remote defect indication is reported by the downstream PTE when it
detects a defect on the incoming signal.
FEBE Far end block errors.
Line FEBE (accumulated from the M0 or M1 byte) is reported when the
downstream LTE detects BIP(B2) errors.
Path FEBE (accumulated from the G1 byte) is reported when the downstream
PTE detects BIP(B3) errors.
LOP Path loss of pointer is reported as a result of an invalid pointer (H1, H2) or an
excess number of new data flag (NDF)-enabled indications.
NEWPTR Inexact count of the number of times that the SONET framer has validated a new
SONET pointer value (H1, H2).
Cisco IOS Interface and Hardware Component Command Reference
1218
service-module t1 linecode through show controllers satellite
show controllers pos
Field Description
PSE Inexact count of the number of times that the SONET framer has detected a
positive stuff event in the received pointer (H1, H2).
NSE Inexact count of the number of times that the SONET framer has detected a
negative stuff event in the received pointer (H1, H2).
Active Defects List of all currently active SONET defects.
Active Alarms List of current alarms as enforced by Sonet Alarm Hierarchy.
Alarm reporting enabled List of alarms for which you enabled reporting with the posreport interface
for command.
APS Automatic protection switching.
COAPS An inexact count of the number of times that a new APS value has been detected
in the K1, K2 bytes.
PSBF An inexact count of the number of times that a protection switching byte failure
has been detected (no three consecutive SONET frames contain identical K1
bytes).
PSBF_state Protection switching byte failure state.
Rx(K1/K2)/Tx(K1/K2) Contents of the received and transmitted K1 and K2 bytes.
S1S0 The two S bits received in the last H1 byte.
C2 The value extracted from the SONET path signal label byte (C2).
CLOCK RECOVERY The SONET clock is recovered using information in the SONET overhead.
RDOOL is an inexact count of the number of times that Receive Data Out Of
Lock has been detected, which indicates that the clock recovery phased lock loop
is unable to lock to the receive stream.
PATH TRACE BUFFER SONET path trace buffer is used to communicate information regarding the
remote host name, interface name and number, and IP address. This is a
Cisco-proprietary use of the J1 (path trace) byte.
BER thresholds List of the bit error rate (BER) thresholds that you configured with the
posthreshold interface command.
TCA thresholds List of the threshold crossing alarms (TCAs) that you configured with
theposthreshold interface command.
Example of the show controllers pos Command on a POS Shared Port Adapter
The following is sample output from the showcontrollerspos command on a Cisco 7600 series router
for POS interface 4/3/0 (which is the interface for port 0 of the SPA in subslot 3 of the SIP in chassis
slot 4):
Cisco IOS Interface and Hardware Component Command Reference
1219
service-module t1 linecode through show controllers satellite
show controllers pos
Router# show controllers pos 4/3/0
POS4/3/0
SECTION
LOF = 0 LOS = 0 BIP(B1) = 65535
LINE
AIS = 0 RDI = 0 FEBE = 65535 BIP(B2) = 16777215
PATH
AIS = 0 RDI = 0 FEBE = 65535 BIP(B3) = 65535
PLM = 0 UNEQ = 0 TIM = 0 TIU = 0
LOP = 0 NEWPTR = 3 PSE = 0 NSE = 0
Active Defects: None
Active Alarms: None
Alarm reporting enabled for: SF SLOS SLOF B1-TCA B2-TCA PLOP B3-TCA
Framing: SONET
APS
COAPS = 1 PSBF = 0
State: PSBF_state = False
Rx(K1/K2): 00/00 Tx(K1/K2): 00/00
Rx Synchronization Status S1 = 00
S1S0 = 00, C2 = CF
Remote aps status (none); Reflected local aps status (none)
CLOCK RECOVERY
RDOOL = 0
State: RDOOL_state = False
PATH TRACE BUFFER: STABLE
Remote hostname : woodson
Remote interface: POS3/0/0
Remote IP addr : 0.0.0.0
Remote Rx(K1/K2): 00/00 Tx(K1/K2): 00/00
BER thresholds: SF = 10e-3 SD = 10e-6
TCA thresholds: B1 = 10e-6 B2 = 10e-6 B3 = 10e-6
Clock source: internal
The table below describes the fields shown in this display.
Example of the show controllers pos alarm Command on the Cisco 7600 Series Router
The following is sample output from the showcontrollersposalarm command that displays
SONET/SDH alarm event counters on a Cisco 7600 series router:
Router# show controllers pos3/2/0 alarm
POS3/2/0
Alarm Event Statistics:
SECTION
LOF = 0 LOS = 0 B1-TCA = 0
LINE
AIS = 0 RDI = 0 RDOOL = 0
SF = 0 SD = 0 B2-TCA = 0
PATH
AIS = 0 RDI = 0 LOP = 0 B3-TCA = 0
PLM = 0 UNEQ = 0
Example of the show controllers pos pm Command on the Cisco 12000 Series Router
The following is sample output from the showcontrollerspospm command that displays performance
monitoring statistics on a Cisco 12000 series router:
Cisco IOS Interface and Hardware Component Command Reference
1220
service-module t1 linecode through show controllers satellite
show controllers pos
Router# show controllers pos 1/0 pm
POS1/0
Medium is SONET
Line coding is RZ, Line type is LONG SM
Data in current interval (516 seconds elapsed)
SECTION ( NO DEFECT )
515 Errored Secs, 515 Severely Err Secs
0 Coding Violations, 515 Sev Err Framing Secs
LINE ( NO DEFECT )
0 Errored Secs, 0 Severely Err Secs
0 Coding Violations, 0 Unavailable Secs
FAR END LINE
0 Errored Secs, 0 Severely Err Secs
0 Coding Violations, 0 Unavailable Secs
PATH ( NO DEFECT )
0 Errored Secs, 0 Severely Err Secs
0 Coding Violations, 0 Unavailable Secs
FAR END PATH
0 Errored Secs, 0 Severely Err Secs
0 Coding Violations, 0 Unavailable Secs
The table below describes the fields shown in the display.
Table 74: show controllers pos pm Field Descriptions
Field Description
POSx/y Slot number of the POS interface.
Line coding Shows the current line encoding type, either return to zero (RZ) or nonreturn to
zero (NRZ).
Line type Line type for this interface. Optical line types can be either long range (LONG) or
short range (SHORT), and either single mode (SM) or multimode (MM).
Data in current interval Shows the current accumulation period, which rolls into the 24-hour accumulation
every 15 minutes. Accumulation period is from 1 to 900 seconds. The oldest
15-minute period falls off the back of the 24-hour accumulation buffer.
Errored Secs An errored second is a second in which one of the following is detected:
• One or more coding violations.
• One or more incoming defects (for example, a severely errored frame [SEF]
defect, an LOS defect, an AIS defect, or an LOP defect).
Severely Err Secs A severely errored second (SES) is a second with one of the following errors:
• A certain number of coding violations. The number is dependent on the line
rate and the BER.
• A certain number of incoming defects.
Coding Violations Number of coding violations for the current interval. Coding violations are defined
as BIP errors that are detected in the incoming signal. The coding violations counter
is incremented for each BIP error detected.
Sev Err Framing Secs Severely errored framing seconds (SEFS) are seconds with one or more SEF defects.
Cisco IOS Interface and Hardware Component Command Reference
1221
service-module t1 linecode through show controllers satellite
show controllers pos
Field Description
Unavailable Secs Total number of seconds for which the interface is unavailable. The interface is
considered to be unavailable after a series of ten consecutive SESs.
Related Commands Command Description
pos report Permits selected SONET alarms to be logged to the console for a POS interface.
pos threshold Sets the BER threshold values of specified alarms for a POS interface.
Cisco IOS Interface and Hardware Component Command Reference
1222
service-module t1 linecode through show controllers satellite
show controllers satellite
show controllers satellite
To display controller information about the internal router interface that connects to an installed Cisco IP
VSAT satellite WAN network module (NM-1VSAT-GILAT), use the showcontrollerssatellite command in
user EXEC or privileged EXEC mode.
show controllers satellite slot/unit
Syntax Description slot Router chassis slot in which the network module is installed.
unit Interface number. For NM-1VSAT-GILAT network modules, always use 0.
Command Default No default behavior or values.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.3(14)T This command was introduced.
Usage Guidelines The output from this command is generally useful for diagnostic tasks performed by technical support.
The showcontrollerssatellite command displays information about initialization block, transmit ring, receive
ring, and errors for the Fast Ethernet controller chip in the internal router interface that connects to an installed
Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT).
Examples The following example shows how to display controller information about the internal router interface
that connects to an installed NM-1VSAT-GILAT network module:
Router# show controllers satellite
2/0
Interface Satellite2/0
Hardware is Intel 82559 FastEthernet
IDB:640B6584, FASTSEND:60A585E0, MCI_INDEX:0
INSTANCE=0x640B7D84
Rx Ring entries = 64
Rx Shadow = 0x640B8054
Rx Ring = 0x 70FEE80
Rx Ring Head = 51
Rx Ring Last = 50
Rx Buffer Descr = 0x 70FF2C0
Rx Buffer Descr Head = 51
Rx Buffer Descr Last = 50
Rx Shadow (malloc) = 0x640B8054
Rx Ring (malloc) = 0x 70FEE80
Rx Buffer Descr (malloc) = 0x 70FF2C0
Tx Ring entries = 128
Tx Shadow = 0x640B8184
Tx Shadow Head = 78
Tx Shadow Tail = 78
Tx Shadow Free = 128
Tx Ring = 0x 70FF700
Cisco IOS Interface and Hardware Component Command Reference
1223
service-module t1 linecode through show controllers satellite
show controllers satellite
Tx Head = 80
Tx Last = 79
Tx Tail = 80
Tx Count = 0
Tx Buffer Descr = 0x 7100740
Tx Buffer Descr Head = 0
Tx Buffer Descr Tail = 0
Tx Shadow (malloc) = 0x640B8184
Tx Ring (malloc) = 0x 70FF700
Tx Buffer Descr (malloc) = 0x 7100740
CONTROL AND STATUS REGISTERS (CSR)=0x3E000000
SCB Intr Mask = 00
SCB CU/RU Cmd = 00
SCB Intr Status = 00
SCB CU Status = 01
SCB RU Status = 04
SCB General Ptr = 00000000
PORT = 00000000
EEPROM = 0008
FLASH = 0002
MDI = 1821780D
Rx Byte Count = 00000608
PMDR = 80
FC Cmd = 00
FC Threshold = 03
Early Rx = 00
General Status = 03
General Control = 00
PHY REGISTERS
Register 0x00: 2000 780D 02A8 0154 0081 0000 0000 0000
Register 0x08: 0000 0000 0000 0000 0000 0000 0000 0000
Register 0x10: 0202 0000 0001 0005 0000 0000 0000 0000
Register 0x18: 0000 0000 8B10 0000 0010 0000 0000 0000
HARDWARE STATISTICS
Rx good frames: 420979
Rx CRC: 0
Rx alignment: 0
Rx resource: 0
Rx overrun: 0
Rx collision detects: 0
Rx short: 0
Tx good frames: 653125
Tx maximum collisions: 0
Tx late collisions: 0
Tx underruns: 0
Tx lost carrier sense: 9
Tx deferred: 86
Tx single collisions: 1
Tx multiple collisions:1
Tx total collisions: 3
FC Tx pause: 0
FC Rx pause: 0
FC Rx unsupported: 0
INTERRUPT STATISTICS
CX = 653136
FR = 420979
CNA = 0
RNR = 0
MDI = 0
SWI = 0
FCP = 0
Receive All Multicasts = enabled
Receive Promiscuous = disabled
Loopback Mode = disabled
Cisco IOS Interface and Hardware Component Command Reference
1224
service-module t1 linecode through show controllers satellite
show controllers satellite
The table below describes the significant fields shown in the display.
Table 75: show controllers satellite Field Descriptions
Field Description
Hardware Description of the chip being used.
IDB Address in router memory of the Interface Descriptor Block (IDB).
FASTSEND Fastsend routine.
INSTANCE Device-specific data stored in router memory that lists the memory
locations and current indices of receive (Rx) and transmit (Tx) rings in
router I/O memory.
CONTROL AND STATUS Control and status registers that are physically located on the chip itself
REGISTERS (CSR) and that are accessed by the CPU over the protocol control information
(PCI) bus.
PHY REGISTERS Contents of the physical layer (PHY) registers of the PHY module, which
is an internal device that interfaces between the internal physical Ethernet
line and the external physical line.
HARDWARE STATISTICS Receive (Rx) and transmit (Tx) traffic statistics collected by the chip.
INTERRUPT STATISTICS Receive (Rx), transmit (Tx), control, software, and flow control interrupt
statistics collected by the chip.
Related Commands Command Description
service-module satellite status Displays status information related to the hardware and software on the
Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT),
including the initial configuration parameters.
show interfaces satellite Displays general interface settings and traffic rates for the internal router
interface that connects to an installed Cisco IP VSAT satellite WAN
network module (NM-1VSAT-GILAT).
Cisco IOS Interface and Hardware Component Command Reference
1225
service-module t1 linecode through show controllers satellite
show controllers satellite
Cisco IOS Interface and Hardware Component Command Reference
1226
show controllers serial through show hw-module
slot proc cpu
• show cem circuit, on page 1229
• show controllers serial, on page 1230
• show controllers serial bert, on page 1238
• show controllers sm, on page 1240
• show controllers sonet, on page 1243
• show controllers t1, on page 1256
• show controllers t1 bert, on page 1263
• show controllers T1-E1 errors, on page 1265
• show controllers t3, on page 1266
• show controllers t3 bert, on page 1289
• show controllers token, on page 1291
• show controllers vg-anylan, on page 1294
• show controllers wanphy, on page 1296
• show controllers wlan-controller, on page 1298
• show counters interface, on page 1301
• show diag, on page 1304
• show diagnostic bootup level, on page 1342
• show diagnostic content module, on page 1343
• show diagnostic cns, on page 1347
• show diagnostic description module, on page 1348
• show diagnostic events, on page 1350
• show diagnostic result slot, on page 1353
• show diagnostic simulation failure, on page 1355
• show diagnostic health, on page 1356
• show diagnostic ondemand settings, on page 1358
• show diagnostic result module, on page 1359
• show diagnostic sanity, on page 1362
• show diagnostic schedule module, on page 1366
• show diagnostic status, on page 1368
• show dsc clock, on page 1370
• show dsi, on page 1372
Cisco IOS Interface and Hardware Component Command Reference
1227
show controllers serial through show hw-module slot proc cpu
• show dsip, on page 1379
• show dsip clients, on page 1382
• show dsip nodes, on page 1384
• show dsip ports, on page 1386
• show dsip queue, on page 1389
• show dsip tracing, on page 1390
• show dsip transport, on page 1392
• show dsip version, on page 1395
• show dtp interface, on page 1397
• show eobc, on page 1400
• show errdisable detect, on page 1403
• show errdisable recovery, on page 1404
• show esmc, on page 1405
• show etherchannel, on page 1407
• show etherchannel load-balancing, on page 1416
• show fabric, on page 1418
• show fm features, on page 1422
• show fm inband-counters, on page 1424
• show gnss, on page 1425
• show gtp, on page 1427
• show hspw-aps-icrm, on page 1430
• show hub, on page 1431
• show hw-module all fpd, on page 1435
• show hw-module slot (6500), on page 1439
• show hw-module slot align, on page 1441
• show hw-module slot fpd, on page 1442
• show hw-module slot logging, on page 1445
• show hw-module slot proc cpu, on page 1447
Cisco IOS Interface and Hardware Component Command Reference
1228
show controllers serial through show hw-module slot proc cpu
show cem circuit
show cem circuit
To display information about the circuit state, administrative state, the CEM ID of the circuit, and the interface
on which it is configured, use the show cem circuit command. If cross connect is configured under the circuit,
the command output also includes information about the attachment circuit status.
Syntax Description Syntax Description
Command Default There is no default.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
XE 3.18 SP Support for this command was introduced on Cisco NCS 4200 Series.
XE Everest This command was integrated into the Cisco NCS 4200 Series and Cisco ASR 900 Series
16.5.1 Routers.
Usage Guidelines The show cem circuit command allows you to display information about the circuit state, administrative
state, the CEM ID of the circuit, and the interface on which it is configured.
Examples The following example shows the detailed information about a particular circuit.:
Router# show cem circuit 0
CEM0/1/2, ID: 0, Line: UP, Admin: UP, Ckt: ACTIVE
Controller state: up, T1/E1 state: up
Idle Pattern: 0xFF, Idle CAS: 0x8
Dejitter: 5 (In use: 0)
Payload Size: 192
Framing: Unframed
CEM Defects Set
None
Signalling: No CAS
RTP: No RTP
Ingress Pkts: 11060 Dropped: 0
Egress Pkts: 11061 Dropped: 0
CEM Counter Details
Input Errors: 0 Output Errors: 0
Pkts Missing: 0 Pkts Reordered: 0
Misorder Drops: 0 JitterBuf Underrun: 0
Error Sec: 0 Severly Errored Sec: 0
Unavailable Sec: 0 Failure Counts: 0
Pkts Malformed: 0 JitterBuf Overrun: 0
Cisco IOS Interface and Hardware Component Command Reference
1229
show controllers serial through show hw-module slot proc cpu
show controllers serial
show controllers serial
To display serial controller statistics, use the showcontrollersserialcommand in privileged EXEC mode.
Standard Syntax
show controllers serial [slot/port]
Cisco 7000 Series Routers with the RSP7000 and RSP7000CI and Cisco 7500 Series Routers
show controllers serial [slot/port-adapter/port]
T3/E3 Shared Port Adapters and 2-Port and 4-Port Channelized T3 SPA in Unchannelized Mode
show controllers serial [slot/subslot/port]
Channelized T3 Shared Port Adapters
show controllers serial [slot/subslot/port/t1-number]
Syntax Description slot (Optional) Chassis slot number.
Refer to the appropriate hardware manual for slot information. For SIPs, refer to the
platform-specific SPA hardware installation guide or the corresponding “Identifying Slots
and Subslots for SIPs and SPAs” topic in the platform-specific SPA software configuration
guide.
port-adapter (Optional) On Cisco 7500 series routers and Cisco 7000 series routers with the RSP7000
and RSP7000CI, the location of the port adapter on a Versatile Interface Processor (VIP).
The value can be 0 or 1.
/ subslot (Optional) Secondary slot number on a SIP where a SPA is installed.
Refer to the platform-specific SPA hardware installation guide and the corresponding
“Specifying the Interface Address on a SPA” topic in the platform-specific SPA software
configuration guide for subslot information.
/ port (Optional) Port or interface number.
Refer to the appropriate hardware manual for port information. For SPAs, refer to the
corresponding “Specifying the Interface Address on a SPA” topics in the platform-specific
SPA software configuration guide.
t1-number (Optional) Logical T1 number in channelized mode.
For SPAs, refer to the corresponding “Specifying the Interface Address on a SPA” topics in
the platform-specific SPA software configuration guide.
Command Default No default behavior or values
Command Modes Privileged EXEC
Command History Release Modification
10.0 This command was introduced.
Cisco IOS Interface and Hardware Component Command Reference
1230
show controllers serial through show hw-module slot proc cpu
show controllers serial
Release Modification
11.1CA This command was modified to include support for the PA-E3 and PA-T3 port adapters.
12.2S This command was integrated into Cisco IOS Release 12.2S.
12.2(25)S3 This command was integrated into Cisco IOS Release 12.2(25)S3.
12.2(18)SXE This command was integrated into Cisco IOS Release 12.2(18)SXE and introduced a new
output for interfaces on the serial SPAs on the Cisco 7600 series routers and Catalyst 6500
series switches.
12.0(31)S This command was integrated into Cisco IOS Release 12.0(31)S.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The output from the showcontrollersserialcommand provides error and alarm information that is useful in
troubleshooting line problems.
The information displayed is generally useful for diagnostic tasks performed by Cisco Systems technical
support personnel only. For the PA-E3 or PA-T3 port adapters, the showcontrollersserial command also
displays configuration information such as the framing, clock source, bandwidth limit, whether scrambling
is enabled, the national bit, the international bits, and DSU mode configured on the interface. Also displayed
are the performance statistics for the current interval and last 15-minute interval and whether any alarms exist.
Examples
Example of the show controllers serial Command on the Cisco 4000 Series Router
The following is sample output from the showcontrollersserial command on the Cisco 4000:
Router# show controllers serial
MK5 unit 0, NIM slot 1, NIM type code 7, NIM version 1
idb = 0x6150, driver structure at 0x34A878, regaddr = 0x8100300
IB at 0x6045500: mode=0x0108, local_addr=0, remote_addr=0
N1=1524, N2=1, scaler=100, T1=1000, T3=2000, TP=1
buffer size 1524
DTE V.35 serial cable attached
RX ring with 32 entries at 0x45560 : RLEN=5, Rxhead 0
00 pak=0x6044D78 ds=0x6044ED4 status=80 max_size=1524 pak_size=0
01 pak=0x60445F0 ds=0x604474C status=80 max_size=1524 pak_size=0
02 pak=0x6043E68 ds=0x6043FC4 status=80 max_size=1524 pak_size=0
03 pak=0x60436E0 ds=0x604383C status=80 max_size=1524 pak_size=0
04 pak=0x6042F58 ds=0x60430B4 status=80 max_size=1524 pak_size=0
05 pak=0x60427D0 ds=0x604292C status=80 max_size=1524 pak_size=0
06 pak=0x6042048 ds=0x60421A4 status=80 max_size=1524 pak_size=0
07 pak=0x60418C0 ds=0x6041A1C status=80 max_size=1524 pak_size=0
08 pak=0x6041138 ds=0x6041294 status=80 max_size=1524 pak_size=0
09 pak=0x60409B0 ds=0x6040B0C status=80 max_size=1524 pak_size=0
10 pak=0x6040228 ds=0x6040384 status=80 max_size=1524 pak_size=0
11 pak=0x603FAA0 ds=0x603FBFC status=80 max_size=1524 pak_size=0
12 pak=0x603F318 ds=0x603F474 status=80 max_size=1524 pak_size=0
13 pak=0x603EB90 ds=0x603ECEC status=80 max_size=1524 pak_size=0
14 pak=0x603E408 ds=0x603E564 status=80 max_size=1524 pak_size=0
15 pak=0x603DC80 ds=0x603DDDC status=80 max_size=1524 pak_size=0
16 pak=0x603D4F8 ds=0x603D654 status=80 max_size=1524 pak_size=0
17 pak=0x603CD70 ds=0x603CECC status=80 max_size=1524 pak_size=0
18 pak=0x603C5E8 ds=0x603C744 status=80 max_size=1524 pak_size=0
Cisco IOS Interface and Hardware Component Command Reference
1231
show controllers serial through show hw-module slot proc cpu
show controllers serial
19 pak=0x603BE60 ds=0x603BFBC status=80 max_size=1524 pak_size=0
20 pak=0x603B6D8 ds=0x603B834 status=80 max_size=1524 pak_size=0
21 pak=0x603AF50 ds=0x603B0AC status=80 max_size=1524 pak_size=0
22 pak=0x603A7C8 ds=0x603A924 status=80 max_size=1524 pak_size=0
23 pak=0x603A040 ds=0x603A19C status=80 max_size=1524 pak_size=0
24 pak=0x60398B8 ds=0x6039A14 status=80 max_size=1524 pak_size=0
25 pak=0x6039130 ds=0x603928C status=80 max_size=1524 pak_size=0
26 pak=0x60389A8 ds=0x6038B04 status=80 max_size=1524 pak_size=0
27 pak=0x6038220 ds=0x603837C status=80 max_size=1524 pak_size=0
28 pak=0x6037A98 ds=0x6037BF4 status=80 max_size=1524 pak_size=0
29 pak=0x6037310 ds=0x603746C status=80 max_size=1524 pak_size=0
30 pak=0x6036B88 ds=0x6036CE4 status=80 max_size=1524 pak_size=0
31 pak=0x6036400 ds=0x603655C status=80 max_size=1524 pak_size=0
TX ring with 8 entries at 0x45790 : TLEN=3, TWD=7
tx_count = 0, tx_head = 7, tx_tail = 7
00 pak=0x000000 ds=0x600D70C status=0x38 max_size=1524 pak_size=22
01 pak=0x000000 ds=0x600D70E status=0x38 max_size=1524 pak_size=2
02 pak=0x000000 ds=0x600D70E status=0x38 max_size=1524 pak_size=2
03 pak=0x000000 ds=0x600D70E status=0x38 max_size=1524 pak_size=2
04 pak=0x000000 ds=0x600D70E status=0x38 max_size=1524 pak_size=2
05 pak=0x000000 ds=0x600D70E status=0x38 max_size=1524 pak_size=2
06 pak=0x000000 ds=0x600D70E status=0x38 max_size=1524 pak_size=2
07 pak=0x000000 ds=0x6000000 status=0x38 max_size=1524 pak_size=0
XID/Test TX desc at 0xFFFFFF, status=0x30, max_buffer_size=0, packet_size=0
XID/Test RX desc at 0xFFFFFF, status=0x0, max_buffer_size=0, packet_size=0
Status Buffer at 0x60459C8: rcv=0, tcv=0, local_state=0, remote_state=0
phase=0, tac=0, currd=0x00000, curxd=0x00000
bad_frames=0, frmrs=0, T1_timeouts=0, rej_rxs=0, runts=0
0 missed datagrams, 0 overruns, 0 bad frame addresses
0 bad datagram encapsulations, 0 user primitive errors
0 provider primitives lost, 0 unexpected provider primitives
0 spurious primitive interrupts, 0 memory errors, 0 tr
%LINEPROTO-5-UPDOWN: Linansmitter underruns
mk5025 registers: csr0 = 0x0E00, csr1 = 0x0302, csr2 = 0x0704
csr3 = 0x5500, csr4 = 0x0214, csr5 = 0x0008
Example of the show controllers serial Command for a PA-E3 Serial Port Adapter
The following is sample output from the showcontrollersserial command for a PA-E3 serial port
adapter installed in slot 2:
Router# show controllers serial 2/0
M1T-E3 pa: show controller:
PAS unit 0, subunit 0, f/w version 2-55, rev ID 0x2800001, version 2
idb = 0x6080D54C, ds = 0x6080F304, ssb=0x6080F4F4
Clock mux=0x30, ucmd_ctrl=0x0, port_status=0x1
Serial config=0x8, line config=0x1B0202
maxdgram=4474, bufpool=128Kb, 256 particles
rxLOS inactive, rxLOF inactive, rxAIS inactive
txAIS inactive, rxRAI inactive, txRAI inactive
line state: up
E3 DTE cable, received clockrate 50071882
base0 registers=0x3D000000, base1 registers=0x3D002000
mxt_ds=0x608BA654, rx ring entries=128, tx ring entries=256
rxring=0x4B01F480, rxr shadow=0x6081081C, rx_head=26
txring=0x4B01F960, txr shadow=0x60810E48, tx_head=192, tx_tail=192, tx_count=0
throttled=0, enabled=0, disabled=0
rx_no_eop_err=0, rx_no_stp_err=0, rx_no_eop_stp_err=0
rx_no_buf=0, rx_soft_overrun_err=0, dump_err= 1
tx_underrun_err=0, tx_soft_underrun_err=0, tx_limited=0
tx_fullring=0, tx_started=11504
Cisco IOS Interface and Hardware Component Command Reference
1232
show controllers serial through show hw-module slot proc cpu
show controllers serial
Framing is g751, Clock Source is Line, Bandwidth limit is 34010.
Scrambling is enabled
National Bit is 0, International Bits are: 0 0
DSU mode 1
Data in current interval (213 seconds elapsed):
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation
0 P-bit Err Secs, 0 P-bit Severely Err Secs
0 Severely Err Framing Secs, 0 Unavailable Secs
0 Line Errored Secs, 0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
Total Data (last 24 hours)
0 Line Code Violations, 0 P-bit Coding Violation,
0 C-bit Coding Violation,
0 P-bit Err Secs, 0 P-bit Severely Err Secs,
0 Severely Err Framing Secs, 0 Unavailable Secs,
0 Line Errored Secs, 0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
No alarms detected.
Example of the show controllers serial Command for a PA-T3 Serial Port Adapter
The following is sample output from the showcontrollersserial command that shows serial port
1/0/0 on a 1-port PA-T3 serial port adapter installed on a VIP2 in chassis slot 1:
Router# show controllers serial 2/0/1
Serial1/0/0 -
Mx T3(1) HW Revision 0x3, FW Revision 2.55
Framing is c-bit, Clock Source is Line
Bandwidth limit is 35000, DSU mode 1, Cable length is 50
Data in current interval (325 seconds elapsed):
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation
0 P-bit Err Secs, 0 P-bit Sev Err Secs
0 Sev Err Framing Secs, 0 Unavailable Secs
0 Line Errored Secs, 0 C-bit Errored Secs, 0 C-bit Sev Err Secs
Total Data (last 24 hours)
0 Line Code Violations, 0 P-bit Coding Violation,
0 C-bit Coding Violation,
0 P-bit Err Secs, 0 P-bit Sev Err Secs,
0 Sev Err Framing Secs, 0 Unavailable Secs,
0 Line Errored Secs, 0 C-bit Errored Secs, 0 C-bit Sev Err Secs
No alarms detected.
Example of the show controllers serial Command for a Channelized T3 SPA
The following is sample output from the showcontrollersserialcommand for a 2-port or 4-Port CT3
SPA located in slot 3 of a Cisco 7304 router:
Router# show controllers serial
Serial3/1/0 -
Framing is c-bit, Clock Source is Internal
Bandwidth limit is 44210, DSU mode 0, Cable length is 10
rx FEBE since last clear counter 0, since reset 0
Data in current interval (0 seconds elapsed):
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation
0 P-bit Err Secs, 0 P-bit Sev Err Secs
0 Sev Err Framing Secs, 0 Unavailable Secs
0 Line Errored Secs, 0 C-bit Errored Secs, 0 C-bit Sev Err Secs
Cisco IOS Interface and Hardware Component Command Reference
1233
show controllers serial through show hw-module slot proc cpu
show controllers serial
0 Severely Errored Line Secs
0 Far-End Errored Secs, 0 Far-End Severely Errored Secs
0 CP-bit Far-end Unavailable Secs
0 Near-end path failures, 0 Far-end path failures
0 Far-end code violations, 0 FERF Defect Secs
0 AIS Defect Secs, 0 LOS Defect Secs
Transmitter is sending AIS.
Receiver has loss of signal.
Serial3/1/3 -
Framing is c-bit, Clock Source is Line
Bandwidth limit is 44210, DSU mode 0, Cable length is 10
rx FEBE since last clear counter 0, since reset 0
Data in current interval (757 seconds elapsed):
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation
0 P-bit Err Secs, 0 P-bit Sev Err Secs
0 Sev Err Framing Secs, 0 Unavailable Secs
0 Line Errored Secs, 0 C-bit Errored Secs, 0 C-bit Sev Err Secs
0 Severely Errored Line Secs
0 Far-End Errored Secs, 0 Far-End Severely Errored Secs
0 CP-bit Far-end Unavailable Secs
0 Near-end path failures, 0 Far-end path failures
0 Far-end code violations, 0 FERF Defect Secs
0 AIS Defect Secs, 0 LOS Defect Secs
No alarms detected.
The table below describes the fields shown in the showcontrollersserial output.
Note The fields appearing in the output will vary depending on card type, controller configuration, and
the status of the controller line.
Table 76: show controllers serial Field Descriptions
Field Description
Serial Name of the serial controller.
Framing Framing type.
Clock source Source of the synchronization signal (clock).
Bandwidth limit The allowable bandwidth for the controller.
DSU mode The Data Service Unit (DSU) interoperability mode.
Cable length The distance to the first repeater.
rx FEBE since last clear Number of received far-end block errors.
counter
Note Line far-end block error (accumulated from the M0 or M1 byte)
is reported when the downstream LTE detects BIP(B2) errors.
Path far-end block error (accumulated from the G1 byte) is
reported when the downstream PTE detects BIP(B3) errors.
rx FEBE since last reset Number of received far-end block errors.
Cisco IOS Interface and Hardware Component Command Reference
1234
show controllers serial through show hw-module slot proc cpu
show controllers serial
Field Description
Line Code Violations Number of Bipolar Violation (BPV) errors or Excessive Zeros (EXZ) errors.
P-bit Coding Violations Number of P-bit errors encountered between source and destination.
C-bit coding violations Number of C-bit errors encountered between source and destination.
P-bit Err Secs (PES) Number of seconds with P-bit errors.
Note A PES is a second with one or more PCVs or one or more Out
of Frame defects or a detected incoming AIS. This gauge is not
incremented when UASs are counted.
P-bit Sev Err Secs (PSES) Number of seconds with P-bit severe errors.
Note A PSES is a second with 44 or more PCVs or one or more Out
of Frame defects or a detected incoming AIS. This gauge is not
incremented when UASs are counted.
Sev Err Framing Secs The number of 1-second intervals in which either a Remote Alarm Indication
was received or a Loss Of Frame condition occurred.
Unavailable Secs The number of 1-second intervals in which the controller was down.
Line Errored Secs The number of 1-second intervals in which a Line Code Violation occurred.
C-bit Errored Secs (CES) Number of seconds with C-bit errors.
Note A CES is a second with one or more CCVs or one or more Out
of Frame defects or a detected incoming AIS. This count is only
for the SYNTRAN and C-bit Parity DS3 applications. This gauge
is not incremented when UASs are counted.
C-bit Sev Err Secs (CSES) Number of seconds with severe C-bit errors.
Note A CSES is a second with 44 or more CCVs or one or more Out
of Frame defects or a detected incoming AIS. This count is only
for the SYNTRAN and C-bit Parity DS3 applications. This gauge
is not incremented when UASs are counted.
Cisco IOS Interface and Hardware Component Command Reference
1235
show controllers serial through show hw-module slot proc cpu
show controllers serial
Field Description
Severely Errored Line Secs For ESF signals, this is a second in which one of the following defects is
detected:
• 320 or more Path Code Violation errors.
• One or more Out of Frame defects.
• An AIS defect.
For E1-CRC signals, this is a second with one of the following errors:
• 832 or more Path Code Violation errors.
• One or more Out of Frame defects.
For E1-nonCRC signals, this is a second with 2048 or more Line Code
Violations.
Far-End Errored Secs Number of seconds of far-end failures.
Far-End Severely Errored Secs The number of 1-second intervals in which either a Remote Alarm Indication
was received or a Loss Of Frame condition occurred.
P-bit Unavailable Secs Number of seconds the interface is unavailable because of P-bit errors.
CP-bit Unavailable Secs Number of seconds the interface is unavailable because of CP-bit errors.
CP-bit Far-end Unavailable Number of seconds the interface is unavailable because of CP-bit errors
Secs from the far-end device.
Near-end path failures Indicates the number of failures at the near end of the path, or device, during
the specified trace period.
Far-end path failures Indicates the number of failures at the remote (or far) end of the path, or
device, during the specified trace period.
Far-end code violations Indicates a frame synchronization bit error in the D4 and E1-no CRC formats,
or a CRC error in the Extended Superframe (ESF) and E1-CRC formats has
occurred on the remote, or far-end device.
FERF Defect Secs Number of far-end receive failures detected per second.
AIS Defect Secs Number of alarm indication signals per second.
LOS Defect Secs Number of loss of signal alarms per second.
Path Code Violations Indicates a frame synchronization bit error in the D4 and E1-no CRC formats,
or a CRC error in the Extended Superframe (ESF) and E1-CRC formats.
Slip Secs Indicates the replication or deletion of the payload bits of a domestic trunk
interface (DS1) frame. A slip might happen when there is a difference
between the timing of a synchronous receiving terminal and the received
signal.
Cisco IOS Interface and Hardware Component Command Reference
1236
show controllers serial through show hw-module slot proc cpu
show controllers serial
Field Description
Fr Loss Secs Indicates the number of seconds an Out of Frame (OOF) error is detected.
Line Err Secs Line Errored Seconds (LES) is a second in which one or more Line Code
Violation errors are detected.
Degraded Mins A degraded minute is one in which the estimated error rate exceeds 1E-6
but does not exceed 1E-3.
Errored Secs In ESF and E1-CRC links, an errored second is a second in which one of
the following defects is detected:
• One or more Path Code Violations.
• One or more Controlled Slip events.
Note For SF and E1 no-CRC links, the presence of Bipolar Violations
also triggers an errored second.
Bursty Err Secs A second with more than one but fewer than 320 Path Coding Violation
errors, no Severely Errored Frame defects, and no detected incoming AIS
defects. Controlled slips are not included in this parameter.
Cisco IOS Interface and Hardware Component Command Reference
1237
show controllers serial through show hw-module slot proc cpu
show controllers serial bert
show controllers serial bert
To view the BERT statistics for a completed or in-progress BERT test, enter the showcontrollersserialbert
in user EXEC or EXEC privileged mode.
show controllers serial slot/interface-number bert
Syntax Description slot Specifies the slot where the serial interface is located.
interface-number Specifies the number of the serial interface.
Command Default None
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.1(12c)EX1 This command was introduced for Cisco 7304 routers.
12.2(18)S This command was introduced on Cisco 7304 routers running Cisco IOS Release 12.2S.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command is used to view the results of a user-initiated BERT test.
Examples In the following example, the showcontrollersserialbertcommand is used to view a BERT test that
is still in progress:
Router#
show controllers serial 6/0 bert
Interface Serial6/0 (DS3 port 1)
BERT information:
State :enabled (sync'd)
Pattern :2^23
Interval :10 minutes
Time remaining :00:01:44
Total errors :0
Time this sync :00:08:10
Errors this sync :0
Sync count :1
In the following example, the showcontrollersserialbertcommand is used to view a BERT test that
is complete:
Router# show controllers serial 6/0 bert
Interface Serial6/0 (DS3 port 1)
BERT information:
State :enabled (sync'd)
Pattern :2^23
Cisco IOS Interface and Hardware Component Command Reference
1238
show controllers serial through show hw-module slot proc cpu
show controllers serial bert
Interval :10 minutes
Time remaining :00:09:44
Total errors :0
Time this sync :00:00:10
Errors this sync :0
Sync count :1
Related Commands Command Description
Inserts intention errors into a BERT test.
bert errors
bert pattern Begins a BERT test.
Cisco IOS Interface and Hardware Component Command Reference
1239
show controllers serial through show hw-module slot proc cpu
show controllers sm
show controllers sm
To display controller information for the service module interface, use the showcontrollerssm command in
user EXEC or privileged EXEC mode.
show controllers sm slot/port
Syntax Description slot Router slot in which the service module is installed. Range: 1 to 4.
/ port Port number of the module interface. Always use 0. The slash mark (/) is required.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines The output from this command is generally useful for diagnostic tasks performed by technical support only.
You can, however, use the displayed hardware statistics to obtain the receive and transmit packet statistics
that are collected by the hardware controller during packet processing.
Examples The following example shows how to display information for the SM-SRE installed in the router:
Router# show controllers sm 1/0
Interface SM1/0
Hardware is PSE2
HWIDB: 0x11E3C8C8 INSTANCE: 0x01323100, FASTSEND: 0x040D6C44
Init flags: 0x23
FPGA registers
----------------
Base address: 0xE4000000 Revision: 0x09030416
FPGA type: 0x316B6278 FPGA_error_val: 0x00000000
Cfg MSI mask: 0x00000008 Rx_buffer_size: 0x00000600
Frame statistics: (polling enabled)
-----------------------------------
tx_frame_cnt: 177 rx_frame_cnt: 28
tx_byte_cnt: 45154 rx_byte_cnt: 2113
tx_pause_frame_cnt: 0 rx_pause_frame_cnt: 0
rx_unicast_filtered_cnt: 0 rx_multicast_filtered_cnt: 8
rx_undersize_pkts: 0 rx_oversize_pkts: 0
tx_64_byte_pkts: 38 rx_64_byte_pkts: 17
tx_65_to_127_byte_pkts: 17 rx_65_to_127_byte_pkts: 8
tx_128_to_255_byte_pkts: 6 rx_128_to_255_byte_pkts: 3
tx_256_to_511_byte_pkts: 116 rx_256_to_511_byte_pkts: 0
tx_512_to_1023_byte_pkts: 0 rx_512_to_1023_byte_pkts: 0
tx_1024_to_1518_byte_pkts: 0 rx_1024_to_1518_byte_pkts: 0
rx_congestion_drop_cnt: 0 rx_mtusize_drop_cnt: 0
rx_bad_cnt: 0
Interrupt statistics
--------------------
ge_tx_interrupt: 171 ge_rx_interrupt: 20
Cisco IOS Interface and Hardware Component Command Reference
1240
show controllers serial through show hw-module slot proc cpu
show controllers sm
txbd_seq_err: 0 txbd_done_err: 0
rxbd_done_err: 0 isl_inner_crc_err: 0
pcie_busmstr_dsbld_err: 0 pcie_tgt_abort_err: 0
pcie_mst_abort_err: 0 spi_done_event: 0
rx_empty_pak: 0 rx_sw_usage_err: 0
ing_buf_adrs_err: 0 pcie_null_ptr_err: 0
uart_tx_intr: 13 uart_rx_intr: 27169
uart_break_detected: 1 uart_framing_err: 0
uart_bad_egr_adrs: 0 uart_egr_overflow: 0
i2c_errs: misc/nack/tmo: 0/0/0
TX ring
-------
Tx Ring txr_head/txr_tail: 178/178
Tx Shadow txs_head/txs_tail/txs_free: 178/178/256
Tx Ring(txr): 0x3C631800 Tx Shadow (malloc): 0x01323380
Tx Limited: 0 Tx Count: 0 hold_pak 0x00000000
RX rings
--------
size: 256 max_spin_size 32 head: 20
Rx Ring(rxr): 0x3C631000 rxr_malloc: 0x3C631000
Rx Shadow(rxs): 0x11E3D6CC rxs_malloc: 0x11E3D6CC
Software MAC Address Filter (hash:length/addr/mask/hits)
--------------------------------------------------------
000: 0 ffff.ffff.ffff 0000.0000.0000 3
007: 0 001e.4a97.644d 0000.0000.0000 0
192: 0 0180.c200.0002 0000.0000.0000 0
192: 1 0100.0ccc.cccc 0000.0000.0000 0
197: 0 0180.c200.0007 0000.0000.0000 0
Software filtered frames: 0
Unicast overflow mode: 0
Multicast overflow mode: 1
Promiscuous mode: 0
HW MAC Address Filter
---------------------
Unicast Addr0: 001E.4A97.644D
Unicast Addr1: 0000.0000.0100
Unicast Addr2: 0000.0000.0100
Unicast Addr3: 0000.0000.0100
Unicast Addr4: 0000.0000.0100
Unicast HW Filter Count : 1
Multicast Hash b63_32: 0x2000001
Multicast Hash b32_00: 0x00
HW unicast filter enabled: Yes
HW multicast filter enabled: Yes
FPGA upgrade info
-----------------
Golden area fpga version: 00000000
Upgrade area fpga version: 09030416
IOS bundled fpga version: 09030416
The table below describes the significant fields shown in the display.
Cisco IOS Interface and Hardware Component Command Reference
1241
show controllers serial through show hw-module slot proc cpu
show controllers sm
Table 77: show controllers analysis-module Field Descriptions
Field Description
Hardware Description of the chip being used.
IDB, FASTSEND Address in router memory of the Interface Descriptor Block (IDB) and
the fastsend routine.
INSTANCE Device-specific data stored in router memory that lists the memory
locations and current indexes of receive (Rx) and transmit (Tx) rings in
router I/O memory.
CONTROL AND STATUS Control and status registers that are physically located on the chip itself
REGISTERS (CSR) and that are accessed by the CPU over the Peripheral Component
Interconnect (PCI) bus.
PHY REGISTERS Contents of the PHY registers. PHY is a device that interfaces the
physical Ethernet line and that is located between the chip and the
physical line.
HARDWARE STATISTICS Receive (Rx) and transmit (Tx) traffic statistics collected by the chip.
INTERRUPT STATISTICS Transmit (Tx), Receive (Rx), control, software, and flow control interrupt
statistics collected by the chip.
Related Commands Command Description
service-module sm status Displays hardware and software status information about the SM-SRE.
show interfaces sm Displays status, traffic data, and configuration information about the SM-SRE
interface.
Cisco IOS Interface and Hardware Component Command Reference
1242
show controllers serial through show hw-module slot proc cpu
show controllers sonet
show controllers sonet
To display information about Synchronous Optical Network (SONET) controllers, use the showcontrollerssonet
command in user EXEC or privileged EXEC mode with the appropriate parameters for the operating mode
of the channelized line.
show controllers sonet[{slot/bay/port
slot/bay/porst.ts1-number/t1-numberslot/bay/porvt.tg1-number/sts1-number/t1-numberslot/bay/porat.u-3-number/tug-2-number/t1-numberslot/bay/porat.u-4-number/tug-3-number/tug-2-number/e1-line-numberslot/bay/porat.u-4-number/vc3-numberslot/bay/port:interface-numbert3
slot/bay/port:t1-line-number}][{bert|brief|tabular}]
Cisco Series
show controllers sonet [slot/bay/port]
Syntax Description slot / bay / port (Optional) Slot, bay, and port number. The slash mark is required
between the slot argument, the bay argument, and the port
argument.
Note This form of the syntax is used only for the
synchronous transport module-1 (STM-1) trunk card
on a Cisco AS5850 universal gateway.
slot / bay / port . sts1 - number (Optional) Slot and port number of a T1 line under SONET
/ t1 - number framing in CT3 mode.
slot / bay / port . vtg1 - number (Optional) Slot and port number of a T1 line under SONET
/ sts1 - number / t1 - number framing in VT-15 mode.
slot / bay / port . au-3-number / (Optional) Slot and port number of a T1 line under synchronous
tug-2-number / t1-number digital hierarchy (SDH) framing with administrative unit type
3 (AU-3) administrative unit group (AUG) mapping.
slot / bay / port . au - 4 - (Optional) Slot and port number of an E1 line under SDH
number / tug - 3 - number / tug framing with AU-4 AUG mapping.
- 2 - number / e1 - line - number
slot / bay / port . au - 4 - (Optional) Slot and port number of a DS3/E3 interface under
number / vc3 - number SDH framing with AU-4 mapping.
slot / bay / port : interface - (Optional) Slot and port number of a DS3/E3 interface under
number SONET framing or SDH framing with AU-3 mapping.
t3 slot / bay / port : t1 - line - (Optional) Displays information for a T1 line under SF or ESF
number format framing.
bert (Optional) Displays bit error rate test (BERT) information.
brief (Optional) Displays summary information about SONET
controllers.
tabular (Optional) Displays SONET controller information in a tabular
format.
Cisco IOS Interface and Hardware Component Command Reference
1243
show controllers serial through show hw-module slot proc cpu
show controllers sonet
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
12.0(21)S This command was introduced on Cisco 12000 series Internet routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T, and support
was added for the STM-1 trunk card on the Cisco AS5850 platform.
12.3(11)T This command was modified to support SONET APS on the Cisco AS5850
platform.
Cisco IOS XE Release 3.1 This command was modified to display the Detected Alarms and
Asserted/Active Alarms fields.
Cisco IOS XE Everest This command was implemented on the Cisco ASR 900 Series Rotuters and
16.5.1 Cisco NCS 4200 Series.
XE Fuji 16.8.x This command output was modified on the Cisco Series Routers to display
far-end counters for performance monitoring.
Usage Guidelines You can enter the showcontrollerssonet command at any time during a BERT.
Examples The following is sample output from the showcontrollerssonetcommand on a T1 line under SONET
framing in VT-15 mode. (The table below describes the lines in the BERT portion of the output.)
Router# show controllers sonet
4/0.1/1/1 brief
OC3.STS1 4/0.1 is up. Hardware is GSR 2 port STM1/OC3 (channelized)
Applique type is VT1.5 in STS-1
STS-1 1, VTG 1, T1 1 (VT1.5 1/1/1) is up
timeslots: 1-24
FDL per AT&T 54016 spec.
No alarms detected.
Framing is ESF, Clock Source is Internal
BERT test result (running)
Test Pattern : 2^20-QRSS, Status : Sync, Sync Detected : 1
Interval : 5 minute(s), Time Remain : 4 minute(s)
Bit Errors (since BERT started): 0 bits,
Bits Received (since BERT started): 112 Mbits
Bit Errors (since last sync): 0 bits
Bits Received (since last sync): 112 Mbits
Table 78: show controllers sonet Line Descriptions
Field Description
BERT test result (running) Indicates the current state of the test. In this case, “running”
indicates that the test is still active. If the test is complete, “done”
is displayed.
Test Pattern : 2^20-QRSS, Status : Sync, Indicates the test pattern that you selected for the test (2^20-QRSS),
Sync Detected : 1 the current synchronization state (Sync), and the number of times
that synchronization was detected during this test (1).
Cisco IOS Interface and Hardware Component Command Reference
1244
show controllers serial through show hw-module slot proc cpu
show controllers sonet
Field Description
Interval : 5 minute(s), Time Remain : 4 Indicates the time allocated for the test to run and the time remaining
minute(s) for the test to run.
For a BERT that you terminate before the time expires, this line
indicates the time the test would have taken to run and the time
remaining for the test to run had you not terminated it. “unable to
complete” is displayed to indicate that you interrupted the test.
Bit Errors (since BERT started): 0 bits Shows the bit errors that were detected versus the total number of
Bits Received (since BERT started): 112 test bits that were received since the test started and since the last
Mbits Bit Errors (since last sync): 0 bits synchronization was detected.
Bits Received (since last sync): 112
Mbits
The following is sample output from the showcontrollerssonetcommand for an E1 line under SDH
framing with AU-4 AUG mapping.
Router# show controllers sonet 3/0.1/1/3/5
SONET 3/0 is up. (Configured for Locally Looped) Hardware is GSR 2 port
STM1/OC3 (channelized)
Applique type is Channelized OCx interface
Clock Source is Line, AUG mapping is AU4.
Medium info:
Type: SDH, Line Coding: NRZ, Line Type: Short SM
Regenerator Section:
LOF = 0 LOS = 0 BIP(B1) = 0
Multiplex Section:
AIS = 0 RDI = 0 REI = 0 BIP(B2) = 0
Active Defects: None
Active Alarms: None
Alarm reporting enabled for: SF SLOS SLOF B1-TCA B2-TCA B3-TCA
BER thresholds: SF = 10e-3 SD = 10e-6
TCA thresholds: B1 = 10e-6 B2 = 10e-6 B3 = 10e-6
High Order Path:
PATH 1:
AIS = 0 RDI = 0 REI = 15 BIP(B3) = 11
LOP = 0 PSE = 4 NSE = 0 NEWPTR = 1
LOM = 0 PLM = 0 UNEQ = 0
Active Defects: None
S1S0 = 02, C2 = 02
PATH TRACE BUFFER : STABLE
CRC-7: 0xF2 OK
52 6F 75 74 65 72 33 2F 30 2F 31 00 00 00 00 Router3/0/1....
STM1.AU4 3/0.1 is up. Hardware is GSR 2 port STM1/OC3 (channelized)
Applique type is C12 in TUG-3 in AU-4
AU-4 1, TUG-3 1, TUG-2 1, E1 1 (C-12 1/1/1/1) is up
timeslots: 1-31
No alarms detected.
Framing is crc4, Clock Source is Internal
BERT test result (running)
Test Pattern : 2^15, Status : Sync, Sync Detected : 1
Cisco IOS Interface and Hardware Component Command Reference
1245
show controllers serial through show hw-module slot proc cpu
show controllers sonet
Interval : 5 minute(s), Time Remain : 5 minute(s)
Bit Errors (since BERT started): 0 bits,
Bits Received (since BERT started): 95 Mbits
Bit Errors (since last sync): 0 bits
Bits Received (since last sync): 95 Mbits
Data in current interval (708 seconds elapsed):
0 Line Code Violations, 1 Path Code Violations
0 Slip Secs, 1 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
1 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavail Secs, 0 Stuffed Secs
Data in Interval 1:
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavail Secs, 0 Stuffed Secs
Data in Interval 2:
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavail Secs, 0 Stuffed Secs
Data in Interval 3:
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 1 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
1 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavail Secs, 0 Stuffed Secs
Total Data (last 3 15 minute intervals):
0 Line Code Violations,0 Path Code Violations,
0 Slip Secs, 1 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins,
1 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavail Secs, 0 Stuffed Secs
The following is sample output from the showcontrollerssonetcommand when AUG mapping is
AU-3 and the tabular keyword is specified.
Router# show controllers sonet
2/0.1/1/1 tabular
SONET 2/0/0 is up.
Channelized OC-3/STM-1 SMI PA
H/W Version : 0.2.3, ROM Version : 1.2
FREEDM version : 2, F/W Version : 0.14.0
SONET 2/0/0 E1 1/1/1 is down
Transmitter is sending LOF Indication (RAI).
Receiver has loss of frame.
Framing is crc4, Clock Source is internal, National bits are 0x1F.
INTERVAL LCV PCV CSS SEFS LES DM ES BES SES UAS SS
17:26-17:29 0 0 0 0 0 0 0 0 0 173 0
17:11-17:26 0 0 0 0 0 0 0 0 0 471 0
16:56-17:11 0 0 0 0 0 0 0 0 0 0 0
16:41-16:56 0 0 0 0 0 0 0 0 0 0 0
16:26-16:41 0 0 0 0 0 0 0 0 0 216 0
16:11-16:26 0 0 0 0 0 0 0 0 0 225 0
Total 0 0 0 0 0 0 0 0 0 912 0
The following is partial sample output from the showcontrollerssonet command using an STM-1
card in the Cisco AS5850.
Router# show controllers sonet 3/0
SONET 3/0 is down.
Applique type is Channelized Sonet/SDH
Clock Source is Internal, AUG mapping is AU4.
Medium info:
Type: SDH, Line Coding: NRZ, Line Type: Short SM
Regenerator Section Status:
Cisco IOS Interface and Hardware Component Command Reference
1246
show controllers serial through show hw-module slot proc cpu
show controllers sonet
LOS
Multiplex Section Status:
Higher Order Path Status:
Path# 1 has no defects
Lower Order Path Status:
VC-12 1/1/1/1 has no defects
VC-12 1/1/1/2 has no defects
VC-12 1/1/1/3 has no defects
VC-12 1/1/2/1 has no defects
VC-12 1/1/2/2 has no defects
VC-12 1/1/2/3 has no defects
VC-12 1/1/3/1 has no defects
VC-12 1/1/3/2 has no defects
VC-12 1/1/3/3 has no defects
VC-12 1/1/4/1 has no defects
VC-12 1/1/4/2 has no defects
VC-12 1/1/4/3 has no defects
VC-12 1/1/5/1 has no defects
VC-12 1/1/5/2 has no defects
VC-12 1/1/5/3 has no defects
VC-12 1/1/6/1 has no defects
VC-12 1/1/6/2 has no defects
.
.
.
VC-12 1/3/5/3 has no defects
VC-12 1/3/6/1 has no defects
VC-12 1/3/6/2 has no defects
VC-12 1/3/6/3 has no defects
VC-12 1/3/7/1 has no defects
VC-12 1/3/7/2 has no defects
VC-12 1/3/7/3 has no defects
Data in current interval (20 seconds elapsed):
Regenerator Section:
0 CVs, 20 ESs, 20 SESs, 0 SEFSs
Multiplex Section:
0 CVs, 0 ESs, 0 SESs, 0 UASs
Higher Order Path:
Path# 1: 0 CVs, 0 ESs, 0 SESs, 20 UASs
Lower Order Path:
VC-12 1/1/1/1: 0 CVs, 0 ESs, 0 SESs, 20 UASs
VC-12 1/1/1/2: 0 CVs, 0 ESs, 0 SESs, 20 UASs
VC-12 1/1/1/3: 0 CVs, 0 ESs, 0 SESs, 20 UASs
VC-12 1/1/2/1: 0 CVs, 0 ESs, 0 SESs, 20 UASs
VC-12 1/1/2/2: 0 CVs, 0 ESs, 0 SESs, 20 UASs
VC-12 1/1/2/3: 0 CVs, 0 ESs, 0 SESs, 20 UASs
.
.
.
VC-12 1/3/5/3: 0 CVs, 0 ESs, 0 SESs, 20 UASs
VC-12 1/3/6/1: 0 CVs, 0 ESs, 0 SESs, 20 UASs
VC-12 1/3/6/2: 0 CVs, 0 ESs, 0 SESs, 20 UASs
VC-12 1/3/6/3: 0 CVs, 0 ESs, 0 SESs, 20 UASs
VC-12 1/3/7/1: 0 CVs, 0 ESs, 0 SESs, 20 UASs
VC-12 1/3/7/2: 0 CVs, 0 ESs, 0 SESs, 20 UASs
VC-12 1/3/7/3: 0 CVs, 0 ESs, 0 SESs, 20 UASs
The table below describes the significant fields shown in the display.
Cisco IOS Interface and Hardware Component Command Reference
1247
show controllers serial through show hw-module slot proc cpu
show controllers sonet
Table 79: show controllers sonet STM-1 Field Descriptions
Field Description
SONET 3/0 The SONET controller in slot 3 shows the state in which it is operating. The controller’s
state can be up, down, or administratively down. Loopback conditions are shown by (Locally
Looped) or (Remotely Looped).
Applique type Controller type.
Clock Source User-specified clock source (Line or Internal).
AUG mapping Indicates type of administrative unit group (AUG) mapping.
Line Coding Shows the current line encoding type, either return to zero (RZ) or non return to zero (NRZ).
Line Type Line type for this interface. Optical line types can be either long range (LONG) or short
range (SHORT), and either single mode (SM) or multimode (MM).
VC-12 Indicates the number of the virtual circuit (VC) and whether the VC has reported any defects.
CVs Number of coding violation (CV) error events.
ESs An errored second (ES) is a second in which one of the following is detected:
• One or more path code violations.
• One or more out of frame defects.
• One or more controlled slip events.
• A detected alarm indication signal (AIS) defect.
SESs Severely errored seconds (SESs) are seconds with one or more out-of-frame defects or a
detected incoming AIS. This gauge is not incremented when UASs are counted.
SEFSs Severely errored framing seconds (SEFSs) are seconds with one or more out-of-frame defects
or a detected incoming AIS.
UASs Unavailable seconds (UASs) are calculated by counting the number of seconds for which
the interface is unavailable.
The following is partial output from the showcontrollerssonetcommand using an STM-1 card in
the Cisco AS5850 with SONET APS configured.
Router# show controllers sonet 1/0
SONET 1/0 is up.
Applique type is Channelized Sonet/SDH
Clock Source is Line, AUG mapping is AU4.
MSP 1+1 bi-directional enabled
Protection fiber (Port 0), No Alarm, traffic in-use
Working fiber (Port 1), No Alarm, traffic not in-use
Local request: No Request
Remote request: No Request
Medium info:
Type: SDH, Line Coding: NRZ, Line Type: Short SM
Regenerator Section Status:
Cisco IOS Interface and Hardware Component Command Reference
1248
show controllers serial through show hw-module slot proc cpu
show controllers sonet
No alarms detected.
Multiplex Section Status:
No alarms detected.
No BER failure/degrade detected
B2 BER_SF threshold power : 3
B2 BER_SD threshold power : 6
Higher Order Path Status:
Path# 1 has no defects
Lower Order Path Status:
VC-12 1/1/1/1 has no defects
VC-12 1/1/1/2 has no defects
VC-12 1/1/1/3 has no defects
.
.
.
The table below describes the significant fields shown in the display that are different from the fields
described in the table above.
Table 80: show controllers sonet STM-1 APS Field Descriptions
Field Description
MSP 1+1 Indicates whether the SDH multiplex section protection (MSP) is bidirectional
or unidirectional.
Protection fiber Indicates the port location of the protect fiber, whether an alarm has been
detected, and whether traffic is flowing through the port.
Working fiber Indicates the port location of the working fiber, whether an alarm has been
detected, and whether traffic is flowing through the port.
Local request Indicates whether a local request to switch fibers has been received. If a
request has been received, the type of request (forced, lockout, or manual)
is indicated.
Remote request Indicates whether a remote request to switch fibers has been received. If a
request has been received, the type of request (forced, lockout, or manual)
is indicated.
No alarms detected Alarms detected by the controller are displayed here. The possible alarms
are as follows:
• Transmitter is sending remote alarm.
• Transmitter is sending alarm indication signal (AIS).
• Receiver has loss of signal.
• Receiver is getting AIS.
• Receiver has loss of frame.
• Receiver has remote alarm.
• Receiver has no alarms.
No BERT failure/degrade No bit error rate (BER) failures or degrades detected.
detected
Cisco IOS Interface and Hardware Component Command Reference
1249
show controllers serial through show hw-module slot proc cpu
show controllers sonet
Field Description
B2 BER_SF threshold power BER signal failure (SF) threshold configured with the b2sf-ber controller
command.
B2 BER_SD threshold power BER signal degrade (SD) threshold configured with the b2sd-ber controller
command.
The following is a sample output from the showcontrollerssonetcommand using the CHOCX card.
Router# show controllers sonet 0/0/0
SONET 0/0/0 is down.
Hardware is SPA-1XCHOC12/DS0
Applique type is Channelized Sonet/SDH
Clock Source is Line
Medium info:
Type: Sonet, Line Coding: NRZ,
SECTION:
LOS = 1 LOF = 0 BIP(B1) = 0
SONET/SDH Section Tables
INTERVAL CV ES SES SEFS
18:51-18:54 0 182 182 182 LINE:
AIS = 0 RDI = 0 REI = 0 BIP(B2) = 0
Active Defects: None
Detected Alarms: PRDI B3-TCA
Asserted/Active Alarms: PRDI B3-TCA
Alarm reporting enabled for: PLOP LOM B3-TCA
BER thresholds: SF = 10e-3 SD = 10e-6
TCA thresholds: B1 = 10e-6 B2 = 10e-6
The table below describes the significant fields shown in the display.
Table 81: show controllers sonet CHOCX Card Field Descriptions
Field Description
Applique type The controller type.
Clock Source The user-specified clock source (line or internal).
Active Defects List of active SONET defects.
Detected Alarms List of alarms detected by the controllers.
Asserted/Active Alarms List of resultant active alarms after SONET alarm hierarchy is enforced on detected
alarms.
BER thresholds BER threshold values of the specified alarms.
TCA thresholds Threshold crossing alarm (TCA) values of the specified alarms.
The following is sample output from the showcontrollerssonetcommand using a shared port adapter
(SPA), SPA-1XCHOC12/DS0 on a Cisco 7600 series router. SPAs such as the SPA-1XCHSTM1/OC3,
SPA-1xCE-OC3/STM1, and SPA-1xCHOC12/OC3 are also used on a Cisco 7600 series router to
get output on the SONET controller.
Cisco IOS Interface and Hardware Component Command Reference
1250
show controllers serial through show hw-module slot proc cpu
show controllers sonet
Router# show controllers sonet 3/0/0.2/1
SONET 3/0/0 is up.
Hardware is SPA-1XCHOC12/DS0
Applique type is Channelized Sonet/SDH
Clock Source is Line, AUG mapping is AU4.
Medium info:
Type: SDH, Line Coding: NRZ,
Regenerator Section:
LOS = 0 LOF = 0 BIP(B1) = 0
SONET/SDH Section Tables
INTERVAL CV ES SES SEFS
16:07-16:12 0 0 0 0
Multiplex Section:
AIS = 0 RDI = 0 REI = 358160 BIP(B2) = 0
Active Defects: None
Detected Alarms: None
Asserted/Active Alarms: None
Alarm reporting enabled for: SLOS SLOF SF B1-TCA B2-TCA
BER thresholds: SF = 10e-3 SD = 10e-6
TCA thresholds: B1 = 10e-6 B2 = 10e-6
Rx: S1S0 = 00
K1 = 00, K2 = 00
J0 = 19
Tx: S1S0 = 02
K1 = 00, K2 = 00
J0 = 01
SONET/SDH Line Tables
INTERVAL CV ES SES UAS
16:08-16:14 0 0 0 0
PATH 4:
AIS = 0 RDI = 0 REI = 0 BIP(B3) = 0
LOP = 0 PSE = 0 NSE = 0 NEWPTR = 0
LOM = 0 PLM = 0 UNEQ = 0
Active Defects: None
Detected Alarms: None
Asserted/Active Alarms: None
Alarm reporting enabled for: PLOP LOM B3-TCA
TCA threshold: B3 = 10e-6
Rx: C2 = 02
Tx: C2 = 02
The table below describes the significant fields shown in the display.
Table 82: show controllers sonet SPA Field Descriptions
Field Description
Applique type The controller type.
Clock Source The user-specified clock source (line or internal).
Active Defects List of active SONET defects.
Detected Alarms List of alarms detected by the controllers.
Asserted/Active Alarms List of resultant active alarms after SONET alarm hierarchy is enforced on detected
alarms.
Cisco IOS Interface and Hardware Component Command Reference
1251
show controllers serial through show hw-module slot proc cpu
show controllers sonet
Field Description
BER thresholds BER threshold values of the specified alarms.
TCA thresholds TCA values of the specified alarms.
Related Commands Command Description
xconnect Configures a pseudowire for transporting data over the network.
Series Router
The following is sample output from the show controllers sonet command on the Cisco series
routers:
Router# show controllers sonet 0/3/3
SONET 0/3/3 is up. ======> this is the controller/port
status.
Hardware is asr900
Port configured rate: OC3 =======> this is the rate the port is configured
on it.
Applique type is Channelized Sonet / SDH
Clock Source is Line ===> the clocking config
Medium info:
Type: Sonet, Line Coding: NRZ,
SECTION:
LOS = 0 LOF = 0 =======> the section level alarm
counter (from last clear counters)
SONET/SDH Section Tables
INTERVAL CV ES SES SEFS
05:50-05:58 0 0 0 0 ===> PMON for the
port
LINE:
AIS = 0 RDI = 0 REI = 0 BIP(B2) = 0 =======> the line level
alarm counter (from last clear counters)
Active Defects: None
Detected Alarms: None
Asserted/Active Alarms: None =========> present active
alarms on the port.
Alarm reporting enabled for: SLOS SLOF SF B2-TCA
BER thresholds: SF = 10e-3 SD = 10e-6 ====> ber thresholds
TCA thresholds: B2 = 10e-6
Rx: S1S0 = 00
K1 = 00, K2 = 00 ===> k1k2 values
J0 = 00
RX S1 = 00
Tx: S1S0 = 00
K1 = 00, K2 = 00
J0 = 00
High Order Path:
PATH 1:
Clock Source is internal ====> path level clock
AIS = 0 RDI = 0 REI = 0 BIP(B3) = 0 ======> path layer alarms counter
LOP = 0 PSE = 0 NSE = 0 NEWPTR = 0
LOM = 0 PLM = 0 UNEQ = 0
Active Defects: None
Detected Alarms: None
Asserted/Active Alarms: None ======> present alarms on the path.
Cisco IOS Interface and Hardware Component Command Reference
1252
show controllers serial through show hw-module slot proc cpu
show controllers sonet
Alarm reporting enabled for: PLOP LOM B3-TCA
TCA threshold: B3 = 10e-6
Rx: C2 = 00 =====> rx and tx C2 byte..
Tx: C2 = 02
PATH TRACE BUFFER : UNSTABLE
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ====> path trace of the path
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
SONET Path Tables
INTERVAL CV ES SES UAS
05:58-05:58 0 0 0 0
PATH 2:
Clock Source is internal
AIS = 0 RDI = 0 REI = 0 BIP(B3) = 0
LOP = 0 PSE = 0 NSE = 0 NEWPTR = 0
LOM = 0 PLM = 0 UNEQ = 0
Active Defects: None
Detected Alarms: None
Asserted/Active Alarms: None
Alarm reporting enabled for: PLOP LOM B3-TCA
TCA threshold: B3 = 10e-6
Rx: C2 = 00
Tx: C2 = 00
PATH TRACE BUFFER : UNSTABLE
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
SONET/SDH Path Tables
INTERVAL CV ES SES UAS
05:58-05:58 0 0 0 0
OC3.STS1 0/3/3.1 is up. ======> present status of the path
Hardware is
Applique type is VT1.5 =====> mode of the path
STS-1 1, VTG 1, T1 1 (VT1.5 1/1/1) is down ====> status of the SPE (t1)
VT Receiver has no alarm.
Receiver is getting AIS. ===> alarm of the SPE (t1)
Framing is unframed, Clock Source is Internal =====> framing of the T1, clock of the t1
Data in current interval (0 seconds elapsed):
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavail Secs, 0 Stuffed Secs
STS-1 1, VTG 1, T1 2 (VT1.5 1/1/2) is down
VT Receiver has no alarm.
Receiver is getting AIS.
Series Router
The following is sample output from the show controllers sonet tabular command on the Cisco
series routers:
Router# show controllers sonet 0/2/0
SONET 0/2/0 is up.
Hardware is -1T8S-10CS
Port configured rate: OC3
Applique type is Channelized Sonet
Clock Source is Internal
Medium info:
Type: Sonet, Line Coding: NRZ,
Cisco IOS Interface and Hardware Component Command Reference
1253
show controllers serial through show hw-module slot proc cpu
show controllers sonet
Alarm Throttling: OFF
SECTION:
LOS = 0 LOF = 0 BIP(B1) = 0
SONET Section Tables
INTERVAL CV ES SES SEFS
12:00-12:07 0 0 0 0
11:45-12:00 15 1 0 0
Total of Data in Current and Previous Intervals
11:45-12:07 15 1 0 0
LINE:
AIS = 0 RDI = 0 REI = 0 BIP(B2) = 0
Active Defects: None
Detected Alarms: None
Asserted/Active Alarms: None
Alarm reporting enabled for: SLOS SLOF LAIS SF SD LRDI B1-TCA B2-TCA
BER thresholds: SF = 10e-3 SD = 10e-6
TCA thresholds: B1 = 10e-6 B2 = 10e-6
Rx: S1S0 = 00
K1 = 00, K2 = 00
J0 = 00
RX S1 = 00
Tx: S1S0 = 00
K1 = 00, K2 = 00
J0 = 04
Tx J0 Length : 64
Tx J0 Trace :
52 6F 75 74 65 72 20 20 20 20 20 20 20 20 20 20 Router
20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20 20 20 20 20 20 20 20 20 20 20 20 20 20 00 00 ..
Expected J0 Length : 64
Expected J0 Trace :
52 6F 75 74 65 72 20 20 20 20 20 20 20 20 20 20 Router
20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20 20 20 20 20 20 20 20 20 20 20 20 20 20 00 00 ..
Rx J0 Length : 64
Rx J0 Trace :
01 01 01 01 01 01 01 01 01 01 01 01 01 01 01 01 ................
01 01 01 01 01 01 01 01 01 01 01 01 01 01 01 01 ................
01 01 01 01 01 01 01 01 01 01 01 01 01 01 01 01 ................
01 01 01 01 01 01 01 01 01 01 01 01 01 01 01 00 ................
SONET Line Tables
INTERVAL CV ES SES UAS CVFE ESFE SESFE UASFE
12:00-12:07 0 0 0 0 0 0 0 0
11:45-12:00 48 1 0 0 53 1 0 0
Total of Data in Current and Previous Intervals
11:45-12:07 48 1 0 0 53 1 0 0
High Order Path:
PATH 2:
Clock Source is internal
AIS = 0 RDI = 0 REI = 0 BIP(B3) = 0
LOP = 1 PSE = 0 NSE = 0 NEWPTR = 0
LOM = 0 PLM = 0 UNEQ = 1
Active Defects: None
Detected Alarms: PLOP
Asserted/Active Alarms: PLOP
Alarm reporting enabled for: PAIS PRDI PUNEQ PLOP PPLM LOM B3-TCA
TCA threshold: B3 = 10e-6
Rx: C2 = 00
Tx: C2 = 04
Tx J1 Length : 64
Tx J1 Trace
52 6F 75 74 65 72 20 30 2F 32 2F 30 2E 32 00 00 Router 0/2/0.2..
Cisco IOS Interface and Hardware Component Command Reference
1254
show controllers serial through show hw-module slot proc cpu
show controllers sonet
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
Expected J1 Length : 64
Expected J1 Trace
52 6F 75 74 65 72 20 30 2F 32 2F 30 2E 32 00 00 Router 0/2/0.2..
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
PATH TRACE BUFFER : UNSTABLE
Rx J1 Length : 0
Rx J1 Trace
SONET Path Tables
INTERVAL CV ES SES UAS CVFE ESFE SESFE UASFE
12:00-12:07 0 0 0 409 0 0 0 0
11:45-12:00 0 0 0 900 0 0 0 0
Total of Data in Current and Previous Intervals
11:45-12:07 0 0 0 1309 0 0 0 0
Related Commands
Cisco IOS Interface and Hardware Component Command Reference
1255
show controllers serial through show hw-module slot proc cpu
show controllers t1
show controllers t1
To display information about the T1 links and to display the hardware and software driver information for
the T1 controller, use the showcontrollerst1 command in privileged EXEC mode.
Standard Syntax
show controllers t1 number [bert]
Cisco 7500 Series
show controllers t1 [slot/port] [bert]
Cisco AS5800 Access Servers
show controllers t1 dial-shelf/slot/t3-port:t1-num [bert]
Cisco Series
show controllers t1 [slot/bay/port]
Syntax Description number Network processor number (NPM)) number, in the range 0 through 2.
slot / port (Optional) Backplane slot number and port number on the interface. Refer to your
hardware installation manual for the specific slot and port numbers.
slot / bay / port Slot number, interface module number in which the slot is inserted, and port number
(Cisco series routers).
dial-shelf Dial shelf chassis in the Cisco AS5800 access server that contains the CT3 interface
card.
/ slot Location of the CT3 interface card in the dial shelf chassis.
/ t3-port T3 port number. The only valid value is 0.
: t1-num T1 time slot in the T3 line. The value can be from 1 to 28.
bert (Optional) Type bert to get a specific display for the bit-error rate testing (BERT)
results. Otherwise, the display will include all other non-BERT information.
Command Modes Privileged EXEC
Command History Release Modification
11.0 This command was introduced.
12.0(2)XD The keyword bert was added.
12.0(3)T This command was implemented on the Cisco AS5800 access server.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Cisco IOS Interface and Hardware Component Command Reference
1256
show controllers serial through show hw-module slot proc cpu
show controllers t1
Release Modification
XE Everest This command was implemented on the Cisco ASR 900 Series and Cisco NCS 4200 Series
16.5.1 Routers.
XE Fuji 16.8.x This command output was modified on the Cisco Series Routers to display far-end counters
for performance monitoring.
Usage Guidelines This command displays controller status that is specific to the controller hardware. The information displayed
is generally useful for diagnostic tasks performed by technical support personnel. Use the
showcontrollerst1bert command to display the results of the BERT feature.
The NPM or MultiChannel Interface Processor (MIP) can query the port adapters to determine their current
status. Issue a showcontrollerst1 command to display statistics about the T1 link.
If you specify a slot and port number, each 15-minute period will be displayed.
Cisco 7500 Series Routers
The following is sample output from the showcontrollerst1 command on the Cisco 7500 series
routers:
Router# show controllers t1
T1 4/1 is up.
No alarms detected.
Framing is ESF, Line Code is AMI, Clock Source is line
Data in current interval (10 seconds elapsed):
0 Line Code Violations, 0 Path Code Violations 0 Slip Secs, 0 Fr Loss Secs,
0 Line Err Secs, 0 Degraded Mins 0 Errored Secs, 0 Bursty Err Secs,
0 Severely Err Secs, 0 Unavail Secs
Total Data (last 79 15 minute intervals):
0 Line Code Violations, 0 Path Code Violations, 0 Slip Secs, 0 Fr Loss Secs,
0 Line Err Secs, 0 Degraded Mins, 0 Errored Secs, 0 Bursty Err Secs,
0 Severely Err Secs, 0 Unavail Secs
The table below describes the fields shown in the display.
Table 83: show controllers t1 Field Descriptions--Cisco 7500 Series
Field Description
T1 4/1 is up The T1 controller 1 in slot 4 is operating. The controller’s state can be up, down,
or administratively down. Loopback conditions are shown by (Locally Looped)
or (Remotely Looped).
Cisco IOS Interface and Hardware Component Command Reference
1257
show controllers serial through show hw-module slot proc cpu
show controllers t1
Field Description
No alarms detected Any alarms detected by the controller are displayed here. Possible alarms are as
follows:
• Transmitter is sending remote alarm.
• Transmitter is sending AIS.
• Receiver has loss of signal.
• Receiver is getting AIS.
• Receiver has loss of frame.
• Receiver has remote alarm.
• Receiver has no alarms.
Data in current interval Shows the current accumulation period, which rolls into the 24-hour accumulation
(10 seconds elapsed) every 15 minutes. Accumulation period is from 1 to 900 seconds. The oldest
15-minute period falls off the back of the 24-hour accumulation buffer.
Line Code Violations Indicates the occurrence of either a Bipolar Violation (BPV) or Excessive Zeros
(EXZ) error event.
Path Code Violations Indicates a frame synchronization bit error in the D4 and E1-no-CRC formats, or
a CRC error in the ESF and E1-CRC formats.
Slip Secs Indicates the replication or deletion of the payload bits of a DS1 frame. A slip
may be performed when there is a difference between the timing of a synchronous
receiving terminal and the received signal.
Fr Loss Secs Indicates the number of seconds an out-of-frame error is detected.
Line Err Secs Line Errored Seconds (LES) is a second in which one or more Line Code Violation
errors are detected.
Degraded Mins Degraded Minute is one in which the estimated error rate exceeds 1E-6 but does
not exceed 1E-3.
Errored Secs In ESF and E1-CRC links, an Errored Second is a second in which one of the
following are detected: one or more Path Code Violations; one or more
out-of-frame defects; one or more Controlled Slip events; a detected AIS defect.
For D4 and E1-no-CRC links, the presence of Bipolar Violations also triggers an
Errored Second.
Bursty Err Secs Second with fewer than 320 and more than 1 Path Coding Violation error, no
Severely Errored Frame defects and no detected incoming AIS defects. Controlled
slips are not included in this parameter.
Cisco IOS Interface and Hardware Component Command Reference
1258
show controllers serial through show hw-module slot proc cpu
show controllers t1
Field Description
Severely Err Secs For ESF signals, a second with one of the following errors: 320 or more Path
Code Violation errors; one or more out-of-frame defects; a detected AIS defect.
For E1-CRC signals, a second with one of the following errors: 832 or more Path
Code Violation errors; one or more out-of-frame defects.
For E1-no-CRC signals, a second with 2048 Line Code Violations or more.
For D4 signals, a count of 1-second intervals with Framing Errors, or an
Out-of-Frame defect, or 1544 Line Code Violations.
Unavail Secs Count of the total number of seconds on the interface.
Cisco AS5800 Access Server
The following example shows the status of the T1 controllers connected to the Cisco AS5800 access
servers:
Router# show controllers t1 1/0/0:1
T1 1/0/0:1 is up.
No alarms detected.
Framing is ESF, Line Code is AMI, Clock Source is Line.
Data in current interval (770 seconds elapsed):
5 Line Code Violations, 8 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 7 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 7 Unavail Secs
Total Data (last 81 15 minute intervals):
7 Line Code Violations, 4 Path Code Violations,
6 Slip Secs, 20 Fr Loss Secs, 2 Line Err Secs, 0 Degraded Mins,
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 2 Unavail Secs
T1 1/0/1:5 is down.
Transmitter is sending remote alarm.
Receiver has loss of frame.
Framing is SF, Line Code is AMI, Clock Source is Line.
Data in current interval (770 seconds elapsed):
50 Line Code Violations, 5 Path Code Violations
0 Slip Secs, 7 Fr Loss Secs, 7 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 7 Unavail Secs
Total Data (last 81 15 minute intervals):
27 Line Code Violations, 22 Path Code Violations,
0 Slip Secs, 13 Fr Loss Secs, 13 Line Err Secs, 0 Degraded Mins,
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 13 Unavail Secs
The table below describes the fields shown in the display.
Table 84: show controllers t1 Field Descriptions--Cisco AS5800 Access Server
Field Description
T1 ... is up Status of T1 line.
No alarms detected Access server received no alarms.
Framing is ... Standard T1 framing type. In this example, the framing is Extended
Super Frame (ESF).
Cisco IOS Interface and Hardware Component Command Reference
1259
show controllers serial through show hw-module slot proc cpu
show controllers t1
Field Description
Line Code is ... Standard T1 line-coding format. In this example, the line-coding format
is Alternate Mark Inversion (AMI).
Clock Source is ... Source of the synchronization signal (clock). In this example, the line
is providing the clock signal.
Data in current interval ... Summary statistics for T1 signal quality for the current time interval of
900 seconds. In this example, the statistics are for current partial interval
(770 seconds of 900 seconds).
Line Code Violations Number of T1 line code violations for the current interval.
Path Code Violations Number of T1 path code violations for the current interval.
Slip Secs Number of seconds in this interval during which a frame misalignment
occurred.
Fr Loss Secs Number of seconds in this interval during which frame loss occurred.
Line Err Secs Number of seconds in this interval during which line errors occurred.
Degraded Mins Number of minutes in this interval during which the signal quality was
degraded.
Errored Secs Number of seconds in this interval during which an error was reported.
Bursty Err Secs Number of bursty error seconds in this interval.
Severely Err Secs Number of severely errored seconds in this interval.
Unavail Secs Number of unavailable seconds in this interval.
Total Data (last ... 15 minute Summary statistics for T1 signal quality for 15-minute intervals. Every
intervals) 24 hours (96 intervals) the counters in this data block clear.
Using the bert Keyword
The following is sample output from the showcontrollerst1bert command displaying the BERT
status for all ports:
Router#
show controllers t1 bert
Controller T1 0 Profile default : The Test was aborted by User
Controller T1 0 Profile 2 : Test Never Ran
Controller T1 1 Profile 3 : Test Never Ran
Controller T1 1 Profile 3 : Test Failed with a BER of 10^-2
Controller T1 2 Profile 3 : Current running, BER 0
Controller T1 2 Profile 2 : Passed with a BER of 0
Controller T1 3 Profile default : Test Never Ran
Controller T1 3 Profile 2 : Test Never Ran
Controller T1 4 Profile default : Test Never Ran
Controller T1 4 Profile 2 : Test Never Ran
Controller T1 5 Profile default : Test Never Ran
Cisco IOS Interface and Hardware Component Command Reference
1260
show controllers serial through show hw-module slot proc cpu
show controllers t1
Controller T1 5 Profile 2 : Test Never Ran
Controller T1 6 Profile default : Test Never Ran
Controller T1 6 Profile 2 : Test Never Ran
Controller T1 7 Profile default : Test Never Ran
Controller T1 7 Profile 2 : Test Never Ran
The following is sample output from the showcontrollerst1bert command with only one T1 port,
port 0.
Router#
show controllers t1 0 bert
Controller T1 0 Profile default : The Test was aborted by User
Controller T1 0 Profile 2 : Test Never Ran
Series Router
The following is sample output from the show controllers t1 command on the Cisco series routers:
Router# show controllers t1 0/2/1
T1 0/2/1 is down.
Applique type is -48T1E1-CE
Cablelength is short 110
No alarms detected.
alarm-trigger is not set
Soaking time: 3, Clearance time: 10
AIS State:Clear LOS State:Clear LOF State:Clear
Framing is ESF, FDL is ansi, Line Code is B8ZS, Clock Source is Line.
BER thresholds: SF = 10e-3 SD = 10e-6
Data in current interval (230 seconds elapsed):
Near End
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavailable Secs
0 Path Failures, 0 SEF/AIS Secs
Far End
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavailable Secs
0 Path Failures
Data in Interval 1:
Near End
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 14 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 15 Unavailable Secs
1 Path Failures, 0 SEF/AIS Secs
Far End Data
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 4 Fr Loss Secs, 2 Line Err Secs, 0 Degraded Mins
4 Errored Secs, 0 Bursty Err Secs, 4 Severely Err Secs, 0 Unavailable Secs
0 Path Failures
Total Data (last 1 15 minute intervals):
Near End
0 Line Code Violations, 0 Path Code Violations,
0 Slip Secs, 0 Fr Loss Secs, 14 Line Err Secs, 0 Degraded Mins,
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 15 Unavailable Secs
1 Path Failures, 0 SEF/AIS Secs
Far End
0 Line Code Violations, 0 Path Code Violations,
0 Slip Secs, 4 Fr Loss Secs, 2 Line Err Secs, 0 Degraded Mins,
Cisco IOS Interface and Hardware Component Command Reference
1261
show controllers serial through show hw-module slot proc cpu
show controllers t1
4 Errored Secs, 0 Bursty Err Secs, 4 Severely Err Secs, 0 Unavailable Secs
0 Path Failures
Cisco IOS Interface and Hardware Component Command Reference
1262
show controllers serial through show hw-module slot proc cpu
show controllers t1 bert
show controllers t1 bert
To get the results of the bit-error rate testing (BERT) run for all ports, use the showcontrollerst1bertcommand
in privileged EXEC mode.
show controllers type [controller-number] [bert]
Syntax Description type Specify either T1 or E1 facility.
controller-number (Optional) Select a specific controller/port numbers. The range is 0 to 7. If not selected,
the display will show all ports.
bert (Optional) Type bert to get a specific display for the BERT results. Otherwise, the
display will include all other non-BERT information.
Command Default No default behavior or values.
Command Modes Privileged EXEC
Command History Release Modification
12.0(2)XD This command was introduced.
12.0(3)T This command was modified.
12.2(15)T This command is no longer supported in Cisco IOS Mainline or Technology-based releases.
It may conintue to appear in Cisco IOS 12.2S-family releases.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use the showcontrollers command to display the results of the BERT feature.
Examples The following example shows how the showcontrollers command is used to display the BERT status
for all ports:
Router#
show controllers t1 bert
Controller T1 0 Profile default : The Test was aborted by User
Controller T1 0 Profile 2 : Test Never Ran
Controller T1 1 Profile 3 : Test Never Ran
Controller T1 1 Profile 3 : Test Failed with a BER of 10^-2
Controller T1 2 Profile 3 : Current running, BER 0
Controller T1 2 Profile 2 : Passed with a BER of 0
Controller T1 3 Profile default : Test Never Ran
Controller T1 3 Profile 2 : Test Never Ran
Controller T1 4 Profile default : Test Never Ran
Controller T1 4 Profile 2 : Test Never Ran
Controller T1 5 Profile default : Test Never Ran
Cisco IOS Interface and Hardware Component Command Reference
1263
show controllers serial through show hw-module slot proc cpu
show controllers t1 bert
Controller T1 5 Profile 2 : Test Never Ran
Controller T1 6 Profile default : Test Never Ran
Controller T1 6 Profile 2 : Test Never Ran
Controller T1 7 Profile default : Test Never Ran
Controller T1 7 Profile 2 : Test Never Ran
The following example shows how the output display was limited to that of only one T1 port, port
0.
Router#
show controllers t1 0 bert
Controller T1 0 Profile default : The Test was aborted by User
Controller T1 0 Profile 2 : Test Never Ran
Cisco IOS Interface and Hardware Component Command Reference
1264
show controllers serial through show hw-module slot proc cpu
show controllers T1-E1 errors
show controllers T1-E1 errors
To show the last nineteen alarms on a controller, use the showcontrollerscommand in privileged EXEC mode.
show controllers {t1|e1} slot subslot port errors
Syntax Description slot Chassis slot number.
Refer to the appropriate hardware manual for slot information. For SIPs, refer to the
platform-specific SPA hardware installation guide or the corresponding “Identifying Slots and
Subslots for SIPs and SPAs” topic in the platform-specific SPA software configuration guide.
subslot Secondary slot number on a SPA interface processor (SIP) where a SPA is installed.
Refer to the platform-specific SPA hardware installation guide and the corresponding “Specifying
the Interface Address on a SPA” topic in the platform-specific SPA software configuration guide
for subslot information.
port Interface number on a SPA.
t1 Clear-channel T1 with integrated data service units (DSUs).
e1 Clear-channel E1 with integrated data service units (DSUs).
Command Modes Privileged EXEC mode
Command History Release Modification
12.2(18)SXE This command was introduced in Cisco IOS Release 12.2(18)SXE to support SPAs on the
Cisco 7600 series router and Catalyst 6500 series switch.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines Use the showcontrollerscommand to show the last nineteen alarms on a controller on a 8-Port T1/E1 SPA.
Examples The following example displays the alarms on an E1 interface.
Router# #show controllers e1 10/2/4 errors
E1 10/2/4:Alarm Log Information
present alarm:NONE
Alarm:OOF 03:54:17 - 03:54:22
Alarm:OOF 03:53:34 - 03:54:07
Related Commands Command Description
controller Configures a T1, E1, or T3 controller and enters controller configuration mode.
show controller Displays controller configuration.
Cisco IOS Interface and Hardware Component Command Reference
1265
show controllers serial through show hw-module slot proc cpu
show controllers t3
show controllers t3
To display information about T3 links and to display hardware and software driver information for the T3
controller, use the showcontrollerst3command in privileged EXEC mode.
Cisco 2650XM, Cisco 2651XM, Cisco 2691, Cisco 3660 Series, Cisco 3725, and Cisco 3745 Routers
show controllers t3 slot/port [{brief|tabular}]
Cisco 7200 Series Routers
show controllers t3 [bay/port [/t1-channel]] [{brief|errors|tabular|remote performance
[{brief|tabular}]}]
Cisco 7500 Series Routers
show controllers t3 [slot/bay/port [/t1-channel]] [{brief|errors|tabular|remote performance
[{brief|tabular}]}]
Cisco AS5800 Access Servers and Cisco 10000 Series Routers
show controllers t3 dial-shelf/slot/t3-port
Cisco Series
show controllers t3 [slot/bay/port]
Cisco Series
show controllers t3 [slot/bay/port path]
Note This is applicable to 48-Port T3/E3 CEM Interface Module and 1 port OC-48/STM-16 or 4 port OC-12/OC-3
/ STM-1/STM-4 + 12 port T1/E1 + 4 port T3/E3 CEM Interface Module.
Syntax Description slot Slot number. Refer to the appropriate hardware manual for slot information.
/ port Port number. Refer to the appropriate hardware manual for port information.
slot / bay / port Slot number, interface module number in which the slot is inserted, and port number
(Cisco series routers).
/ bay (Optional) The port adaptor bay number. Refer to the appropriate hardware manual
for bay information
/ t1-channel (Optional) Number from 1 to 28 that represents the T1 channel for the Channelized
T3 Interface Processor (CT3IP) on Cisco 7200 series and Cisco 5200 series routers.
dial-shelf Dial shelf chassis in the Cisco AS5800 access server that contains the CT3 interface
card.
/ slot Location of the CT3 interface card in the dial shelf chassis.
/ t3-port T3 port number.
Cisco IOS Interface and Hardware Component Command Reference
1266
show controllers serial through show hw-module slot proc cpu
show controllers t3
brief (Optional) Displays a subset of information.
errors (Optional) Displays a history of alarm events that causes a T3 controller or a T1
controller of a T3 to transition from an Up state to a Down state. The history size
is 18 events.
tabular (Optional) Displays information in a tabular format.
remote performance (Optional) Displays the far-end ANSI performance monitor information when
enabled on the T1 channel with the t1fdlansi controller configuration command.
path Defines the path (sts-1/vc3) information to which the DS3 (T3 or E3) is mapped.
Command Modes Privileged EXEC (#)
Command History Release Modification
11.3 This command was introduced.
12.0(3)T This command was implemented on the Cisco AS5800 access server.
12.2(11)YT This command was integrated into Cisco IOS Release 12.2(11)YT and implemented on
the following platforms: Cisco 2650XM, Cisco 2651XM, Cisco 2691, Cisco 3660 series,
Cisco 3725, and Cisco 3745 routers.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
12.2(19c) This command was modified to display error throttling and alarm conditions that cause
the T3 controller to enter a failure state.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
12.2(31)SB This command was integrated in Cisco IOS Release 12.2(31)SB.
12.2(33)SB This command’s behavior was modified on the Cisco 10000 series router for the PRE3
and PRE4.
XE Everest This command was implemented on the Cisco ASR 900 Series Routers and Cisco NCS
16.5.1 4200 Series.
XE Fuji 16.8.x This command output was modified on the Cisco Series Routers to display far-end counters
for performance monitoring.
XE Fuji 16.8.x The path keyword is introduced in Cisco IOS XE Fuji 16.8.x release for Cisco ASR 900
Series Routers and Cisco NCS 4200 Series Routers for 48-Port T3/E3 CEM Interface
Module and 1 port OC-48/STM-16 or 4 port OC-12/OC-3 / STM-1/STM-4 + 12 port
T1/E1 + 4 port T3/E3 CEM Interface Module.
Usage Guidelines Cisco 7500 Series Routers
Cisco IOS Interface and Hardware Component Command Reference
1267
show controllers serial through show hw-module slot proc cpu
show controllers t3
This command displays controller status that is specific to the controller hardware. The information displayed
is generally useful for diagnostic tasks performed by technical support personnel only.
When you use the errors keyword, this command displays history that identifies which alarm events caused
a T3 or T1 controller of a T3 to go down for the Cisco 7500 and Cisco 7200 series routers.
Note T1 channels on the CT3IP are numbered 1 to 28 rather than the more traditional zero-based numbering scheme
(0 to 27) used with other Cisco products. This is to ensure consistency with telco numbering schemes for T1
channels within channelized T3 equipment.
The showcontrollerst3command also displays Maintenance Data Link (MDL) information (received strings)
if MDL is configured and framing is set to C-bit.
Cisco 10000 Series Router Usage Guidelines
In releases prior to Cisco IOS Release 12.2(33)SB, when you configure the t1 loopback remote command on
the local router, the command also displays in the running configuration file of the far-end router. This is due
to the Route Processor (RP) updating an incorrect parameter when it receives the loopback event message
from the line card for loopback requests from the far end.
In Cisco IOS Release 12.2(33)SB, the RP updates the correct parameter and the show controllers command
correctly displays the loopback CLI commands applied on the local end and displays the loopback events and
status received from the line card in response to loopback requests from the far end.
This change in behavior affects the following line cards and is documented in the CSCsm84447 caveat:
• 4-port channelized STM1
• 1-port channelized OC-12
• 6-port channelized T3
• 4-port half-height channelized T3
In Cisco IOS Release 12.2(33)SB, the output from the show controller command includes line code information
for the 6-port channelized T3 line card and the 8-port E3/DS3 line card. However, because SONET line cards
do not have a direct physical link at the T3 or E3 level, the output from the show controller t3 command does
not include line code information.
In Cisco IOS Release 12.2(31)SB, the output from the show controller command displays line code information.
The output of the show controller t3 command for SONET-based T3 also includes line code information.
Examples
Cisco 7200 Series Routers
The following is partial output from the showcontrollerst3 errors command for Cisco IOS Release
12.2(19c) for a specific T1 controller of a T3 on a Cisco 7200 series router with a bay/port of 4/1,
displaying the T1 1 alarm event of OOF:
Router# show controllers t3 4/1/1 errors
T3 4/1: Error Log Information
present alarm: NONE
Error: AIS
17:28:08-17:29:18
T1 1 Error Log Information
Cisco IOS Interface and Hardware Component Command Reference
1268
show controllers serial through show hw-module slot proc cpu
show controllers t3
present alarm: OOF
Since 17:30:55
Error: OOF
17:30:09-17:30:46
The following is partial output from the showcontrollerst3 errors command from Cisco IOS Release
12.2(19c) for a T3 controller on a Cisco 7200 series router with a bay/port of 4/1, displaying a history
of all alarm events on all 28 T1 channels:
Router# show controllers t3 4/1 errors
T3 4/1: Error Log Information
present alarm: NONE
Error: AIS
17:28:08-17:29:18
T1 1 Error Log Information
present alarm: OOF
Since 17:30:55
Error: OOF
17:30:09-17:30:46
T1 2 Error Log Information
present alarm: NONE
T1 3 Error Log Information
present alarm: NONE
T1 4 Error Log Information
present alarm: NONE
T1 5 Error Log Information
present alarm: NONE
T1 6 Error Log Information
present alarm: NONE
T1 7 Error Log Information
present alarm: NONE
T1 8 Error Log Information
present alarm: NONE
T1 9 Error Log Information
present alarm: NONE
T1 10 Error Log Information
present alarm: NONE
T1 11 Error Log Information
present alarm: NONE
.
.
.
.Cisco 7500 Series Routers
The following is partial output from the showcontrollerst3 errors command from Cisco IOS Release
12.2(19c) for a T3 controller with a slot/bay/port of 1/4/1, displaying a history of all alarm events
on all 28 T1 channels:
Router# show controllers t3 1/4/1 errors
T3 1/4/1: Error Log Information
present alarm: NONE
Error: AIS
17:28:08-17:29:18
T1 1 Error Log Information
present alarm: OOF
Since 17:30:55
Error: OOF
17:30:09-17:30:46
T1 2 Error Log Information
Cisco IOS Interface and Hardware Component Command Reference
1269
show controllers serial through show hw-module slot proc cpu
show controllers t3
present alarm: NONE
T1 3 Error Log Information
present alarm: NONE
T1 4 Error Log Information
present alarm: NONE
T1 5 Error Log Information
present alarm: NONE
T1 6 Error Log Information
present alarm: NONE
T1 7 Error Log Information
present alarm: NONE
.
.
.
The following is partial output from the showcontrollerst3 errors command from Cisco IOS Release
12.2(19c) for a specific T1 controller of a T3 on a Cisco 7200 series router with a bay/port of 4/1,
displaying the T1 1 alarm event of OOF:
Router# show controllers t3 4/1/1 errors
T3 4/1: Error Log Information
present alarm: NONE
Error: AIS
17:28:08-17:29:18
T1 1 Error Log Information
present alarm: OOF
Since 17:30:55
Error: OOF
17:30:09-17:30:46
.
.
.
The table below describes the error field shown in the display.
Table 85: show controllers t3 Error Field Description
Field Description
AIS alarm indication signal. In a T1 transmission, an all-ones signal transmitted in lieu of the normal
signal to maintain transmission continuity and to indicate to the receiving terminal that there is a
transmission fault that is located either at, or upstream from, the transmitting terminal.
RAI remote alarm indication. Indicates a yellow alarm from the remote end of the T1 transmission.
OOF out of frame. An OOF defect is detected when any three or more errors in sixteen or fewer consecutive
F-bits occur.
LOS loss of signal. A loss of signal occurs when n consecutive zeros is detected on an incoming signal.
NONE No error is detected.
The following is partial output from the showcontrollerst3 command from Cisco IOS Release
12.2(19c):
Router# show controllers t3 2/1/0
T3 2/1/0 is down. Hardware is 2CT3 single wide port adapter
CT3 H/W Version:0.2.2, CT3 ROM Version:1.0, CT3 F/W Version:2.5.1
FREEDM version:1, reset 0 resurrect 0
Cisco IOS Interface and Hardware Component Command Reference
1270
show controllers serial through show hw-module slot proc cpu
show controllers t3
Applique type is Channelized T3
Transmitter is sending remote alarm.
Receiver has loss of signal.
FEAC code received:No code is being received
Framing is M23, Line Code is B3ZS, Clock Source is Internal
Rx-error throttling on T1's ENABLED
Rx throttle total 0, equipment customer loopback
Data in current interval (545 seconds elapsed):
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
545 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
Data in Interval 1:
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
900 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
Data in Interval 2:
<snip>
The following is partial output from the showcontrollerst3 command from Cisco IOS Release
12.2(19c) for the T1 channel of the T3 controller:
Router# show controllers t3 2/1/0
T3 2/1/0 is down. Hardware is 2CT3 single wide port adapter
CT3 H/W Version:0.2.2, CT3 ROM Version:1.0, CT3 F/W Version:2.5.1
FREEDM version:1, reset 0 resurrect 0
T1 1 is down
timeslots:1-24
FDL per AT&T 54016 spec.
Receiver has loss of signal.
Framing is ESF, Clock Source is Internal
Data in current interval (0 seconds elapsed):
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavail Secs, 0 Stuffed Secs
The following is partial output from the showcontrollerst3 command:
Router# show controllers t3 3/0/0
T3 3/0/0 is up.
CT3 H/W Version: 4, CT3 ROM Version: 0.116, CT3 F/W Version: 0.10.0
Mx H/W version: 2, Mx ucode ver: 1.24
Applique type is Channelized T3
No alarms detected.
FEAC code received: No code is being received
Framing is M23, Line Code is B3ZS, Clock Source is Internal.
Ext1: LOS, Ext2: LOS, Ext3: LOS, Test: OK
Data in current interval (39 seconds elapsed):
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation
0 P-bit Err Secs, 0 P-bit Severely Err Secs
0 Severely Err Framing Secs, 0 Unavailable Secs
0 Line Errored Secs, 0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
Total Data (last 1 15 minute intervals):
0 Line Code Violations, 0 P-bit Coding Violation,
0 C-bit Coding Violation,
0 P-bit Err Secs, 0 P-bit Severely Err Secs,
Cisco IOS Interface and Hardware Component Command Reference
1271
show controllers serial through show hw-module slot proc cpu
show controllers t3
0 Severely Err Framing Secs, 0 Unavailable Secs,
0 Line Errored Secs, 0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
.
.
.
T1 1 is down, speed: 1536 kbs, non-inverted data
timeslots: 1-24
FDL per ANSI T1.403 and AT&T 54016 spec.
Configured for FDL Remotely Line Looped
No alarms detected.
Framing is ESF, LineCode is B8ZS, Clock Source is Internal.
BERT test result (running)
Test Pattern: All 0’s, Status: Sync, Sync Detected: 1
Interval: 4 minute(s), Tim Remain: 4 minute(s)
Bit Errors (Sync BERT Started): 0 bits
Bit Errors (Sync last Sync): 0 bits, Bits Received: 7 Mbits
The following is partial output from the showcontrollerst3brief command:
Router# show controllers t3 3/0/0 brief
T3 3/0/0 is up.
CT3 H/W Version: 4, CT3 ROM Version: 0.116, CT3 F/W Version: 0.10.0
Mxt H/W version: 2, Mxt ucode ver: 1.24
Applique type is Channelized T3
No alarms detected.
FEAC code received: No code is being received
Framing is M23, Line Code is B3ZS, Clock Source is Internal.
Ext1: LOS, Ext2: LOS, Ext3: LOS, Test: OK
T1 1 is up, speed: 1536 kbs, non-inverted data
timeslots: 1-24
FDL per ANSI T1.403 and AT&T 54016 spec.
Configured for FDL Remotely Line Looped
No alarms detected.
Framing is ESF, LineCode is B8ZS, Clock Source is Internal.
BERT test result (done)
Test Pattern: All 0’s, Status: Not Sync, Sync Detected: 1
Interval: 4 minute(s), Tim Remain: 0 minute(s)
Bit Errors(Sync BERT Started): 0 bits
Bit Errors(Sync last Sync): 0 bits, Bits Received: 368 Mbits
.
.
.
The following is partial output from the showcontrollerst3tabular command:
Router# show controllers t3 3/0/0 tabular
T3 3/0/0 is up.
CT3 H/W Version: 4, CT3 ROM Version: 1.2, CT3 F/W Version: 2.1.0
Mx H/W version: 2, Mx ucode ver: 1.25
Applique type is Channelized T3
No alarms detected.
MDL transmission is disabled
FEAC code received: No code is being received
Framing is C-BIT Parity, Line Code is B3ZS, Clock Source is Internal.
Ext1: AIS, Ext2: LOS, Ext3: LOS, Test: LOS
INTERVAL LCV PCV CCV PES PSES SEFS UAS LES CES CSES
08:56-09:11 0 0 0 0 0 0 0 0 0 0
08:41-08:56 0 0 0 0 0 0 0 0 0 0
08:26-08:41 0 0 0 0 0 0 0 0 0 0
Total 0 0 0 0 0 0 0 0 0 0
.
Cisco IOS Interface and Hardware Component Command Reference
1272
show controllers serial through show hw-module slot proc cpu
show controllers t3
.
.
T1 2 is up, speed: 1536 kbs, non-inverted data
timeslots: 1-24
FDL per AT&T 54016 spec.
No alarms detected.
Framing is ESF, Line Code is B8ZS, Clock Source is Internal.
INTERVAL LCV PCV CSS SELS LES DM ES BES SES UAS SS
08:56-09:11 0 0 0 0 0 0 0 0 0 0 0
08:41-08:56 0 0 0 0 0 0 0 0 0 0 0
08:26-08:41 0 0 0 0 0 0 0 0 0 0 0
Total 0 0 0 0 0 0 0 0 0 0 0
The following output shows a controller with a high number of errors on the line, thus showing a
throttle count (RX throttles).
Router# show controllers t3 6/0/0 tabular
T1 2 is up
timeslots: 1-24
FDL per AT&T 54016 spec.
No alarms detected.
Framing is ESF, Clock Source is Line, Rx throttles 47
INTERVAL LCV PCV CSS SELS LES DM ES BES SES UAS SS
07:48-07:53 0 0 0 0 0 0 0 0 0 0
The following is partial output from the showcontrollerst3remoteperformance command. This
information is available if thet1fdlansi controller configuration command is enabled for a T1 channel
on a CT3IP.
Router# show controllers t3 3/0/0 remote performance
T3 3/0/0 is up.
CT3 H/W Version: 4, CT3 ROM Version: 0.116, CT3 F/W Version: 20.2.0
Mx H/W version: 2, Mx ucode ver: 1.25
T1 1 - Remote Performance Data
Data in current interval (356 seconds elapsed):
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavail Secs
Data in Interval 1:
1 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
2 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavail Secs
Data in Interval 2:
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavail Secs
Total Data (last 2 15 minute intervals):
1 Path Code Violations
1 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins,
2 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavail Secs
.
.
.
The table below describes the fields shown in the display.
Cisco IOS Interface and Hardware Component Command Reference
1273
show controllers serial through show hw-module slot proc cpu
show controllers t3
Table 86: show controllers t3 Field Descriptions--Cisco 7500 Series
Field Description
T3 3/0/0 is up T3 controller in slot 3 is operating. The controller’s state can be up, down, or
administratively down. Loopback conditions are shown by (Locally Looped) or
(Remotely Looped).
CT3 H/W Version Version number of the hardware.
CT3 ROM Version Version number of the ROM.
CT3 F/W Version Version number of the firmware.
Mx H/W version Hardware version number of the HDLC controller chip.
Mx ucode ver Microcode version of the HDLC controller chip.
Applique type Controller type.
No alarms detected Any alarms detected by the controller are displayed here. Possible alarms are as
follows:
• Transmitter is sending remote alarm.
• Transmitter is sending AIS.
• Receiver has loss of signal.
• Receiver is getting AIS.
• Receiver has loss of frame.
• Receiver has remote alarm.
• Receiver has no alarms.
MDL transmission Status of the Maintenance Data Link (either enabled or disabled).
Cisco IOS Interface and Hardware Component Command Reference
1274
show controllers serial through show hw-module slot proc cpu
show controllers t3
Field Description
FEAC code received Whether or not a far-end alarm code request is being received. Possible values
are as follows:
• DS3 Eqpt. Failure (SA)
• DS3 LOS/HBER
• DS3 Out-of-Frame
• DS3 AIS Received
• DS3 IDLE Received
• DS3 Eqpt. Failure (NSA)
• Common Eqpt. Failure (NSA)
• Multiple DS1 LOS/HBER
• DS1 Eqpt. Failure
• Single DS1 LOS/HBER
• DS1 Eqpt. Failure (NSA)
• No code is being received
Framing Framing type on the CT3IP. Values are M23, C-Bit, and Auto-detect.
Line Code Line coding format on the CT3IP.
Clock Source Clock source on the CT3IP. Values are internal or line.
RX-error throttling Indicates that error throttling is enabled. The error throttling command disables
the T1 level clock in order to stop receiving error data packets on a T1 controller.
If any single interface receives a burst of errors over a short duration, such as
400 errors in 100 milliseconds, the T1 clock will be turned off for a period of
100 milliseconds.
RX throttles The presence of the throttle count indicates that there are many input errors on
lines. On the CT3 PA, the T1 is throttled when there are a number of input errors
on an interface (400 errors in 100 milliseconds). The T1 is throttled even if one
of the interfaces on it sees continuous errors. The 1-second periodic process
checks for throttled interfaces and unthrottles them back.
Cisco IOS Interface and Hardware Component Command Reference
1275
show controllers serial through show hw-module slot proc cpu
show controllers t3
Field Description
BERT test result BERT test information is available if the t1bert controller configuration
command is enabled for the T1 channel on the CT3IP. The BERT results include
the following information:
• Test Pattern--Type of test pattern selected.
• Status--Status of the test.
• Sync Detected--Number of times the pattern synch is detected (that is, the
number of times the pattern goes from No Sync to Sync).
• Interval--Duration selected.
• Tim Remain--Time remaining on the BERT test.
• Bit Errors (Sync BERT Started)--Number of bit errors during the BERT
test.
• Bit Errors (Sync last Sync)--Number of bit errors since the last pattern sync
was detected.
• Bits Received--Total bits received.
When the T1 channel has a BERT test running, the line state is DOWN. Also,
when the BERT test is running and the Status field is Not Sync, the information
in the total bit errors field is not valid. When the BERT test is done, the Status
field is not relevant.
Data in current interval (39 Shows the current accumulation period, which rolls into the 24-hour accumulation
seconds elapsed) every 15 minutes. Accumulation period is from 1 to 900 seconds. The oldest
15-minute period falls off the back of the 24-hour accumulation buffer.
Line Code Violations Line Code Violations (LCVs) is a count of both Bipolar Violations (BPVs) and
Excessive Zeros (EXZs) that occur over the accumulation period. An EXZ
increments the LCV by one regardless of the length of the zero string.
P-bit Coding Violation For all DS3 applications, a P-bit coding violation (PCV) error event is a P-bit
parity error event. A P-bit parity error event is the occurrence of a received P-bit
code on the DS3 M-frame that is not identical to the corresponding locally
calculated code.
C-bit Coding Violation For C-bit parity and SYNTRAN DS3 applications, the C-bit coding violation
(CCV) is the count of coding violations reported via the C-bits. For C-bit parity,
it is the count of CP-bit parity errors that occur during the accumulation interval.
For SYNTRAN, it is a count of CRC-9 errors that occur during the accumulation
interval.
P-bit Err Secs P-bit errored seconds (PES) is a second with one or more PCVs, one or more
out-of-frame defects, or a detected incoming AIS. This gauge is not incremented
when unavailable seconds are counted.
Cisco IOS Interface and Hardware Component Command Reference
1276
show controllers serial through show hw-module slot proc cpu
show controllers t3
Field Description
P-bit Severely Err Secs P-bit severely errored seconds (PSES) is a second with 44 or more PCVs, one
or more out-of-frame defects, or a detected incoming AIS. This gauge is not
incremented when unavailable seconds are counted.
Severely Err Framing Secs Severely errored framing seconds (SEFS) is a second with one or more
out-of-frame defects or a detected incoming AIS.
Unavailable Secs The number of unavailable seconds (UAS) is calculated by counting the number
of seconds for which the interface is unavailable. For more information, refer
to RFC 1407, DS3 MIB Variables .
Line Errored Secs Line errored seconds (LES) is a second in which one or more code violations
or one or more LOS defects occurred.
C-bit Errored Secs C-bit errored seconds (CES) is a second with one or more C-bit code violations
(CCV), one or more out-of-frame defects, or a detected incoming AIS. This
gauge is not incremented when UASs are counted.
C-bit Severely Errored C-bit severely errored seconds (CSES) is a second with 44 or more CCVs, one
Secs or more out-of-frame defects, or a detected incoming AIS. This gauge is not
incremented when UASs are counted.
Total Data (last 1 15 Shows the last 15-minute accumulation period.
minute intervals)
T1 1 is up T1 channel is operating. The channel’s state can be up, down, or administratively
down. Loopback conditions are shown by (Locally Looped) or (Remotely
Looped).
speed Speed of the T1 channel, in kbps.
non-inverted data Indicates if the T1 channel is configured for inverted data.
timeslots Time slots assigned to the T1 channel.
FDL per ANSI T1.403 and Performance monitoring is via Facility Data Link per ANSI T1.403 and AT&T
AT&T 54016 spec. standard specification number 54016.
No alarms detected Any alarms detected by the T1 controller are displayed here. Possible alarms
are as follows:
• Transmitter is sending remote alarm.
• Transmitter is sending AIS.
• Receiver has loss of signal.
• Receiver is getting AIS.
• Receiver has loss of frame.
• Receiver has remote alarm.
• Receiver has no alarms.
Cisco IOS Interface and Hardware Component Command Reference
1277
show controllers serial through show hw-module slot proc cpu
show controllers t3
Field Description
Framing Type of framing used on the T1 channel. Values are ESF or SF.
Line Code Type of line coding used on the T1 channel. Values are B8ZS or AMI.
Clock Source Clock source on the T1 channel. Values are internal or line.
Path Code Violations Path coding violation (PCV) error event is a frame synchronization bit error in
the D4 and E1-no-CRC formats or a CRC error in the ESF and E1-CRC formats.
Slip Secs Controlled slip second (CSS) is a 1-second interval that contains one or more
controlled slips.
Fr Loss Secs Frame loss seconds (SELS) is the number of seconds for which an out-of-frame
error is detected.
Line Err Secs Line errored seconds (LES) is a second in which one or more line code violation
errors are detected.
Degraded Mins Degraded minute (DM) is a minute in which the estimated error rate exceeds
1E-6 but does not exceed 1E-3. For more information, refer to RFC 1406,
Definitions of Managed Objects for DS1 and E1 Interface Types .
Errored Secs Errored seconds (ES) is a second with one or more path coding violations, one
or more out-of-frame defects, or one or more controlled slip events or a detected
AIS defect.
Bursty Err Secs Bursty errored seconds (BES) is a second with fewer than 320 and more than
one path coding violation error events, no severely errored frame defects, and
no detected incoming AIS defects. Controlled slips are not included in this
parameter.
Severely Err Secs Severely errored seconds (SES) is a second with 320 or more path code violation
errors events, one or more out-of-frame defects, or a detected AIS defect.
Unavailable Secs Number of seconds during which the interface was not available in this interval.
Referred to as UAS.
Stuffed Secs Stuffed seconds (SS) is a second in which one more bit stuffings take place. This
happens when the Pulse Density Enforcer detects a potential violation in the
output stream and inserts a 1 to prevent it. Such bit stuffings corrupt user data
and indicate that the network is configured incorrectly. This counter can be used
to help diagnose this situation.
Cisco AS5800 Access Servers
The following example shows the summary status of the T3 controller located in shelf 1, slot 4, port
0:
Router# show controllers t3 1/4/0 brief
T3 1/4/0 is up.
Applique type is Channelized T3
Cisco IOS Interface and Hardware Component Command Reference
1278
show controllers serial through show hw-module slot proc cpu
show controllers t3
No alarms detected.
MDL transmission is disabled
FEAC code received: Multiple DS1 LOS/HBER
Framing is C-BIT Parity, Line Code is B3ZS, Clock Source is Line.
Data in current interval (491 seconds elapsed):
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
0 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
Total Data (last 80 15 minute intervals):
3 Line Code Violations, 4 P-bit Coding Violation,
2 C-bit Coding Violation, 0 P-bit Err Secs,
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs,
2 Unavailable Secs, 0 Line Errored Secs,
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
The following example shows the detailed status of the T3 controller connected to the Cisco AS5800
in shelf 1, slot 4, port 0. Notice that the detailed information shows the last eighty-six 15-minute
time periods.
Router# show controllers t3 1/4/0
T3 1/4/0 is up.
Applique type is Channelized T3
No alarms detected.
MDL transmission is disabled
FEAC code received: Multiple DS1 LOS/HBER
Framing is C-BIT Parity, Line Code is B3ZS, Clock Source is Line.
Data in current interval (91 seconds elapsed):
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
0 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
Data in Interval 1:
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
0 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
Data in Interval 2:
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
0 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
Data in Interval 3:
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
0 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
Data in Interval 4:
0 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
0 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
.
.
.
Cisco IOS Interface and Hardware Component Command Reference
1279
show controllers serial through show hw-module slot proc cpu
show controllers t3
Data in Interval 86:
3 Line Code Violations, 4 P-bit Coding Violation
2 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
2 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
Total Data (last 86 15 minute intervals):
3 Line Code Violations, 4 P-bit Coding Violation,
2 C-bit Coding Violation, 0 P-bit Err Secs,
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs,
2 Unavailable Secs, 0 Line Errored Secs,
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
The table below describes the fields shown in the display.
Table 87: show controllers t3 Field Descriptions--Cisco AS5800
Field Description
T3 1/4/0 is up T3 controller connected to this Cisco AS5800 access server in shelf 1, slot 4,
port 0 is up. The controller’s state can be up, down, or administratively down.
Loopback conditions are shown by Locally Looped or Remotely Looped.
Applique type Describes the type of controller.
No alarms detected Any alarms detected by the controller are displayed here. Possible alarms are
as follows:
• Transmitter is sending remote alarm.
• Transmitter is sending alarm indication signal (AIS).
• Receiver has loss of signal (LOS).
• Receiver is getting AIS.
• Receiver has loss of frame (LOF).
• Receiver has remote alarm.
• Receiver has no alarms.
MDL transmission Maintenance Data Link status (either enabled or disabled). Used for carrying
performance information and control signals across the network toward the
far-end T3 unit. It is the counterpart of Facility Data Link (FDL) in a T1 link.
Cisco IOS Interface and Hardware Component Command Reference
1280
show controllers serial through show hw-module slot proc cpu
show controllers t3
Field Description
FEAC code received Whether or not a far-end alarm code request is being received. Possible values
are as follows:
• DS3 Eqpt. Failure (SA)
• DS3 LOS/HBER
• DS3 Out-of-Frame
• DS3 AIS Received
• DS3 IDLE Received
• DS3 Eqpt. Failure (NSA)
• Common Eqpt. Failure (NSA)
• Multiple DS1 LOS/HBER
• DS1 Eqpt. Failure
• Single DS1 LOS/HBER
• DS1 Eqpt. Failure (NSA)
• No code is being received
Framing Standard T3 framing type: M23, C-Bit, or Auto-detect.
Line Code Standard T3 line-coding format. In this example, the line-coding format is
bipolar 3-zero substitution (B3ZS).
Clock Source The source of the synchronization signal (clock): line or internal. In this example,
the line is providing the clock signal.
Data in current interval (... Summary statistics for T3 signal quality for the current time interval of 900
seconds elapsed) seconds (15 minutes). In this example, the statistics are for current partial
interval. Statistics roll into the 24-hour accumulation buffer every 15 minutes.
The oldest 15-minute period falls off the back of the 24-hour accumulation
buffer.
Line Code Violations Count of both Bipolar Violations (BPVs) and Excessive Zeros (EXZs) that
occur over the accumulation period. An EXZ increments the Line Code
Violations (LCVs) by one regardless of the length of the zero string.
P-bit Coding Violation P-bit parity error event. A P-bit parity error event is the occurrence of a received
P-bit code on the DS3 M-frame that is not identical to the corresponding locally
calculated code. Referred to as PCV.
C-bit Coding Violation Count of coding violations reported via the C-bits. For C-bit parity, it is the
count of CP-bit parity errors that occur during the accumulation interval.
Referred to as CCV.
Cisco IOS Interface and Hardware Component Command Reference
1281
show controllers serial through show hw-module slot proc cpu
show controllers t3
Field Description
P-bit Err Secs Number of seconds with one or more PCVs, one or more out-of-frame defects,
or a detected incoming AIS. This gauge is not incremented when unavailable
seconds are counted.
P-bit Severely Err Secs Number of seconds with 44 or more PCVs, one or more out-of-frame defects,
or a detected incoming AIS. This gauge is not incremented when unavailable
seconds are counted.
Severely Err Framing Secs Number of a seconds with one or more out-of-frame defects or a detected
incoming AIS.
Unavailable Secs Number of seconds during which the interface was not available in this interval.
Referred to as UAS.
Line Errored Secs Number of seconds in this interval during which one or more code violations
or one or more LOS defects occurred. Referred to as LES.
C-bit Errored Secs Number of seconds with one or more C-bit code violations (CCV), one or more
out-of-frame defects, or a detected incoming AIS. This gauge is not incremented
when UASs are counted. Referred to as CES.
C-bit Severely Errored Secs Number of seconds with 44 or more CCVs, one or more out-of-frame defects,
or a detected incoming AIS. This gauge is not incremented when UASs are
counted.
Total Data (last ... 15 Summary statistics for T3 signal quality for 15-minute intervals. Every 24 hours
minute intervals) (96 intervals) the counters in this data block clear.
Cisco 10000 Series Router Examples
The following examples from the show controller t3 command show the information that displays
when the router is running Cisco IOS Release 12.2(33)SB and Cisco IOS Release 12.2(31)SB:
Cisco IOS Release 12.2(33)SB --No Line Code Information (CHSTM1 and 1CHOC12 Cards)
Router# show controllers t3 2/0/0.1
T3 2/0/0.1 is up. Hardware is C10K CHSTM1 line card
Applique type is Channelized T3
Controller is in channelized mode
No alarms detected.
MDL transmission is disabled
FEAC code received: No code is being received
Framing is C-BIT Parity (Detected), Clock Source is Internal
equipment customer loopback
Data in current interval (155 seconds elapsed):
290738 P-bit Coding Violation
290736 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
34 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
31 AIS Defect Secs, 0 FERF Defect Secs
Cisco IOS Interface and Hardware Component Command Reference
1282
show controllers serial through show hw-module slot proc cpu
show controllers t3
1 Near-end path failures, 0 Far-end path failures
0 CP-bit Far-End Unavailable Secs, 107 Far-End Coding Violations
2 Far-End Errored Secs, 1 Far-End Severely Errored Secs
Cisco IOS Release 12.2(31)SB --Line Code Information (CHSTM1 and 1CHOC12 Cards)
Router# show controllers t3 2/0/0.1
T3 2/0/0.1 is up. Hardware is C10K CHSTM1 line card
Applique type is Channelized T3
Controller is in channelized mode
No alarms detected.
MDL transmission is disabled
FEAC code received: No code is being received
Framing is C-BIT Parity (Detected), Clock Source is Internal
equipment customer loopback
Data in current interval (155 seconds elapsed):
290738 P-bit Coding Violation
290736 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
34 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
Cisco IOS Release 12.2(33)SB3-- CHSTM1 and 1CHOC12 Cards
Router# show controllers t3 2/0/0.1
T3 2/0/0.1 is up. Hardware is C10K CHSTM1 line card
Applique type is Channelized T3
Controller is in channelized mode
No alarms detected.
MDL transmission is disabled
FEAC code received: No code is being received
Framing is C-BIT Parity (Detected), Clock Source is Internal
equipment customer loopback
Data in current interval (155 seconds elapsed):
290738 P-bit Coding Violation
290736 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
34 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
31 AIS Defect Secs, 0 FERF Defect Secs
1 Near-end path failures, 0 Far-end path failures
0 CP-bit Far-End Unavailable Secs, 107 Far-End Coding Violations
2 Far-End Errored Secs, 1 Far-End Severely Errored Secs
Cisco IOS Release 12.2(33)SB3 --4HHCT3 and 6CHT3 Cards
Router# show controllers t3 8/0/0
T3 8/0/0 is down. Hardware is C10K Half Height CT3 line card
Applique type is Channelized T3
Controller is in channelized mode
Receiver has loss of signal.
MDL transmission is disabled
FEAC code received: No code is being received
Framing is C-BIT Parity (Configured)
Cisco IOS Interface and Hardware Component Command Reference
1283
show controllers serial through show hw-module slot proc cpu
show controllers t3
Line Code is B3ZS, Clock Source is Internal
equipment customer loopback
Data in current interval (617 seconds elapsed):
6120 Line Code Violations, 0 P-bit Coding Violation
0 C-bit Coding Violation, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
25 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
0 AIS Defect Secs, 25 LOS Defect Secs
1 Near-end path failures
0 Far-end path failures, 0 FERF Defect Secs
24 CP-bit Far-End Unavailable Secs, 4771 Far-End Coding Violations
0 Far-End Errored Secs, 0 Far-End Severely Errored Secs
The table below describes the significant fields shown in the display.
Table 88: show controllers t3 Field Descriptions--Cisco 10000 series router
Field Description
AIS Alarm indication signal.
T3 2/0/0.1 is up T3 controller connected to this Cisco 10000 series router in shelf 2, slot 0, port
0.1 is up. The controller’s state can be up, down, or administratively down.
Loopback conditions are shown by Locally Looped or Remotely Looped.
T3 8/0/0 is down T3 controller connected to this Cisco 10000 series router in shelf 8, slot 0, port
0 is down. The controller’s state can be up, down, or administratively down.
Loopback conditions are shown by Locally Looped or Remotely Looped.
Applique type Describes the type of controller.
No alarms detected Any alarms detected by the controller are displayed here. Possible alarms are
as follows:
• Receiver has loss of frame (LOF).
• Receiver has loss of signal (LOS).
• Receiver has no alarms.
• Receiver has remote alarm.
• Receiver is getting AIS.
• Transmitter is sending alarm indication signal (AIS).
• Transmitter is sending remote alarm.
MDL transmission Maintenance Data Link status (either enabled or disabled). Used for carrying
performance information and control signals across the network toward the
far-end T3 unit. It is the counterpart of Facility Data Link (FDL) in a T1 link.
Cisco IOS Interface and Hardware Component Command Reference
1284
show controllers serial through show hw-module slot proc cpu
show controllers t3
Field Description
FEAC code received Whether a far-end alarm code request is being received. Possible values are as
follows:
• Common Eqpt. Failure (NSA)
• DS1 Eqpt. Failure (NSA)
• DS1 Eqpt. Failure
• DS3 AIS Received
• DS3 Eqpt. Failure (NSA)
• DS3 Eqpt. Failure (SA)
• DS3 IDLE Received
• DS3 LOS/HBER
• DS3 Out-of-Frame
• Multiple DS1 LOS/HBER
• No code is being received
• Single DS1 LOS/HBER
Framing Standard T3 framing type: M23, C-bit, or Auto-detect.
Line Code Standard T3 line-coding format. In this example, the line-coding format is bipolar
3-zero substitution (B3ZS).
Clock Source The source of the synchronization signal (clock): Line or Internal. In this
example, the line is providing the clock signal.
Data in current interval Summary statistics for T3 signal quality for the current time interval of 900
(617 seconds elapsed) seconds (15 minutes). In this example, the statistics are for current partial interval.
Statistics roll into the 24-hour accumulation buffer every 15 minutes. The oldest
15-minute period falls off the back of the 24-hour accumulation buffer.
Line Code Violations Count of both Bipolar Violations (BPVs) and Excessive Zeros (EXZs) that occur
over the accumulation period. An EXZ increments the line code violations
(LCVs) by one, regardless of the length of the zero string.
P-bit Coding Violation P-bit parity error event. A P-bit parity error event is the occurrence of a received
P-bit code on the DS3 M-frame that is not identical to the corresponding locally
calculated code. Referred to as PCV.
C-bit Coding Violation Count of coding violations reported via the C-bits. For C-bit parity, it is the
count of CP-bit parity errors that occur during the accumulation interval. Referred
to as CCV.
P-bit Err Secs Number of seconds with one or more PCVs, one or more out-of-frame defects,
or a detected incoming AIS. This gauge is not incremented when unavailable
seconds are counted.
Cisco IOS Interface and Hardware Component Command Reference
1285
show controllers serial through show hw-module slot proc cpu
show controllers t3
Field Description
P-bit Severely Err Secs Number of seconds with 44 or more PCVs, one or more out-of-frame defects,
or a detected incoming AIS. This gauge is not incremented when unavailable
seconds are counted.
Severely Err Framing Secs Number of a seconds with one or more out-of-frame defects or a detected
incoming AIS.
Unavailable Secs Number of seconds during which the interface was not available in this interval.
Referred to as UAS.
Line Errored Secs Number of seconds in this interval during which one or more code violations or
one or more LOS defects occurred. Referred to as LES.
C-bit Errored Secs Number of seconds with one or more C-bit code violations (CCV), one or more
out-of-frame defects, or a detected incoming AIS. This gauge is not incremented
when UASs are counted. Referred to as CES.
C-bit Severely Errored Number of seconds with 44 or more CCVs, one or more out-of-frame defects,
Secs or a detected incoming AIS. This gauge is not incremented when UASs are
counted.
Series Router
The following is a sample output from the show controllers t3 command on the Cisco series routers:
Router# show controllers t3 0/4/40
T3 0/4/40 is up.
Hardware is -48T3E3-CE
Applique type is Clear Channel T3
No alarms detected.
MDL transmission is disabled
FEAC code received: No code is being received
Framing is C-BIT Parity, Line Code is B3ZS, Cablelength Short less than 225ft
BER thresholds: SF = 10e-10 SD = 10e-10
Clock Source is internal
Equipment customer loopback
Data in current interval (240 seconds elapsed):
Near End
0 Line Code Violations, 0 P-bit Coding Violations
0 C-bit Coding Violations, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
0 Unavailable Secs, 0 Line Errored Secs
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
0 Severely Errored Line Secs, 0 Path Failures
0 AIS Defect Secs, 0 LOS Defect Secs
Far End
0 Errored Secs, 0 Severely Errored Secs
0 C-bit Unavailable Secs, 0 Path Failures
0 Code Violations, 0 Service Affecting Secs
Data in Interval 1:
Near End
0 Line Code Violations, 0 P-bit Coding Violations
0 C-bit Coding Violations, 0 P-bit Err Secs
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs
20 Unavailable Secs, 20 Line Errored Secs
Cisco IOS Interface and Hardware Component Command Reference
1286
show controllers serial through show hw-module slot proc cpu
show controllers t3
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
20 Severely Errored Line Secs, 1 Path Failures
0 AIS Defect Secs, 20 LOS Defect Secs
Far End
0 Errored Secs, 0 Severely Errored Secs
0 C-bit Unavailable Secs, 0 Path Failures
0 Code Violations, 0 Service Affecting Secs
Total Data (last 1 15 minute intervals):
Near End
0 Line Code Violations, 0 P-bit Coding Violations,
0 C-bit Coding Violations, 0 P-bit Err Secs,
0 P-bit Severely Err Secs, 0 Severely Err Framing Secs,
20 Unavailable Secs, 20 Line Errored Secs,
0 C-bit Errored Secs, 0 C-bit Severely Errored Secs
20 Severely Errored Line Secs, 1 path failures
0 AIS Defect Secs, 20 LOS Defect Secs
Far End
0 Errored Secs, 0 Severely Errored Secs
0 C-bit Unavailable Secs, 0 Path Failures
0 Code Violations, 0 Service Affecting Secs
T1 1 is up
timeslots:
FDL per AT&T 54016 spec.
No alarms detected.
Framing is ESF, Clock Source is Internal
Data in current interval (250 seconds elapsed):
Near End
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavailable Secs, 0 Stuffed Secs
0 Path Failures, 0 SEF/AIS Secs
Far End
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs
0 Unavailable Secs 0 Path Failures
Data in Interval 1:
Near End
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 2 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
2 Errored Secs, 0 Bursty Err Secs, 2 Severely Err Secs
0 Unavailable Secs, 0 Stuffed Secs
1 Path Failures, 2 SEF/AIS Secs
Far End
0 Line Code Violations, 0 Path Code Violations
0 Slip Secs, 2 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
3 Errored Secs, 0 Bursty Err Secs, 3 Severely Err Secs
0 Unavailable Secs 0 Path Failures
Total Data (last 1 15 minute intervals):
Near End
0 Line Code Violations,0 Path Code Violations,
0 Slip Secs, 2 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins,
2 Errored Secs, 0 Bursty Err Secs, 2 Severely Err Secs
0 Unavailable Secs, 0 Stuffed Secs
1 Path Failures, 2 SEF/AIS Secs
Far End
0 Line Code Violations,0 Path Code Violations
0 Slip Secs, 2 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins,
3 Errored Secs, 0 Bursty Err Secs, 3 Severely Err Secs
0 Unavailable Secs, 0 Path Failures
Use show controller t3 0/1/20 path to verify DS3 CEP configuration:
Cisco IOS Interface and Hardware Component Command Reference
1287
show controllers serial through show hw-module slot proc cpu
show controllers t3
rtr2#show controller t3 0/1/20 path
T3 0/1/20 PATH 1.
Asynchronous Mapping for DS3 into STS-1
TX : TDM to PSN direction
RX : PSN to TDM direction
Clock Source is internal
AIS = 0 RDI = 0 REI = 349 BIP(B3) = 22
LOP = 0 PSE = 0 NSE = 0 NEWPTR = 0
LOM = 0 PLM = 0 UNEQ = 0
Active Defects: None
Detected Alarms: None
Asserted/Active Alarms: None
Alarm reporting enabled for: None
TCA threshold: B3 = 10e-6
Rx: C2 = FF
Tx: C2 = 01
Tx J1 Length : 64
Tx J1 Trace
72 74 72 32 20 30 2F 31 2F 32 30 2E 31 00 00 00 rtr2 0/1/20.1...
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
Expected J1 Length : 64
Expected J1 Trace
72 74 72 32 20 30 2F 31 2F 32 30 2E 31 00 00 00 rtr2 0/1/20.1...
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
PATH TRACE BUFFER : UNSTABLE
Rx J1 Length : 64
Rx J1 Trace
72 73 70 32 20 30 2F 35 2F 31 32 2E 31 00 00 00 rsp2 0/5/12.1...
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
rtr2#
Note The verification output does not provide the alarm details.
Cisco IOS Interface and Hardware Component Command Reference
1288
show controllers serial through show hw-module slot proc cpu
show controllers t3 bert
show controllers t3 bert
To display BER test statistics, use the show controllers t3 bert command in user EXEC or privileged EXEC
mode.
show controllers t3 slot/subslot/port [/t1-number] bert
Syntax Description slot Chassis line card slot number.
subslot Chassis line card subslot number.
port Interface number on the line card.
t1-number (Optional) Logical T1 interface number.
bert Displays BER test statistics.
Command Modes User EXEC
Privileged EXEC
Command History Release Modification
12.2(28)SB This command was introduced on the Cisco 10000 series routers.
Examples The following example shows BER test statistics for an unchannelized T3 interface:
Router# show controllers t3 6/1/0 bert
T3 6/1/0 is up.
BERT test result (done)
Test Pattern : 2^15, Status : Not Sync, Sync Detected : 1
Interval : 5 minute(s), Time Remain : 0 minute(s)
Bit Errors (since BERT started): 0 bits,
Bits Received (since BERT started): 13025 Mbits
Bit Errors (since last sync): 0 bits
Bits Received (since last sync): 13025 Mbits
The following example shows BER test statistics for a channelized T3 interface:
Router# show controllers t3 6/1/0 bert
T3 6/1/0 is up.
BERT test result (running)
Test Pattern : 2^15, Status : Sync, Sync Detected : 1
Interval : 3 minute(s), Time Remain : 1 minute(s)
Bit Errors (since BERT started): 0 bits,
Bits Received (since BERT started): 5493 Mbits
Bit Errors (since last sync): 0 bits
Bits Received (since last sync): 5493 Mbits
The following example shows BER test statistics for a T1 interface:
Cisco IOS Interface and Hardware Component Command Reference
1289
show controllers serial through show hw-module slot proc cpu
show controllers t3 bert
Router# show controllers t3 6/1/1/1 bert
T3 6/1/1/1 is up. Hardware is C10K Half Height CT3 line card
T1 1
BERT test result (running)
Test Pattern : 2^15, Status : Sync, Sync Detected : 1
Interval : 5 minute(s), Time Remain : 5 minute(s)
Bit Errors (since BERT started): 0 bits,
Bits Received (since BERT started): 36 Mbits
Bit Errors (since last sync): 0 bits
Bits Received (since last sync): 36 Mbits
Related Commands Command Description
bert Configures a BER test for an unchannelized or channelized T3 interface.
t1 bert pattern Configures a BER test for a T1 interface.
Cisco IOS Interface and Hardware Component Command Reference
1290
show controllers serial through show hw-module slot proc cpu
show controllers token
show controllers token
To display information about memory management and error counters on the Token Ring Interface Processor
(TRIP) for the Cisco 7500 series routers, use the showcontrollerstoken command in privileged EXEC mode.
show controllers token
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC
Command History Release Modification
10.0 This command was introduced.
11.3(3)T The information was modified to include the PA-4R-FDX full-duplex Token Ring port adapter.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Depending on the card being used, the output can vary. This command also displays information that is
proprietary to Cisco Systems. Thus, the information that the showcontrollerstoken command displays is of
primary use to Cisco technical personnel. Information that is useful to users can be obtained with the
showinterfacestokenring command, which is described later in this chapter.
Examples The following is sample output for the PA-4R-DTR from the showcontrollerstokencommand. In
this example, the current operating mode is classic Token Ring station.
Router# show controllers token
Interface TokenRing4/0 state: up
Data from IDB:
Current MAC address: 0008.2a36.1a04, Burned in MAC address: 0008.2a36.1a04
Group address: 80000000
Functional address: 08000000, enables: CDP
Ring mode: 0000, enables:
Last Ring Status: none
Stats: soft: 0/0, hard: 0/0, sig loss: 0/0, throttle: 0/0
tx beacon: 0/0, wire fault 0/0, recovery: 0/0
only station: 0/0, remote removal: 0/0
Interface failures: 0
Current operating mode:
Classic token ring station
MAC state: inserted
Duplex: half
Access protocol: TKP
Ring speed: 16 Mbps
Ring monitor role: Standby monitor
Internal controller data:
MAC microcode version: 0.240
Hawkeye ASIC revision: 0
Node address: 0008.2a36.1a04
Functional address: 08000000, Group address: 80000000
Cisco IOS Interface and Hardware Component Command Reference
1291
show controllers serial through show hw-module slot proc cpu
show controllers token
Hawkeye ASIC registers:
last hisr: 0004h, himr: 00002ABFh, inpace: 0000h
utility: 6316h, txphthre: 1010h, rxtxdmathre: 2828h
dmactrl: 0000E004h, earlyrxthre: 0000h, llcstop: 0000h
reset: 0000h
txhidescstart: 4B0A45C0h, txlodescstart: 00000000h
rxdescstart: 4B0A4180h, srbctrl: 0038h, descipoll: 0100h
congestcnt: 0000h
Hawkeye transmit error counts:
Underrun: 0/0
Hawkeye receive error counts:
Out of descriptors: 0/0, Giants: 0/0
Corrupted frames: 0/0, CRC errors: 0/0
FIFO overflow: 0/0
Device driver ring buffer data:
Transmit ring:
Descriptors outstanding (curr/max): 0/256
Head pointer: 7 Tail pointer: 7
Receive ring:
Ring size: 64 descriptors
Head pointer: 7
Internal controller soft error counts:
Line errors: 0/0, Internal errors: 0/0
Burst errors: 0/0, ARI/FCI errors: 0/0
Abort errors: 0/0, Lost frame errors: 0/0
Copy errors: 0/0, Receiver congestion: 0/0
Token errors: 0/0, Frequency errors: 0/0
Internal controller SMT state:
Adapter MAC: 0008.2a36.1a04, Physical drop: 00000000
NAUN address: 0060.3ebb.0a21, NAUN drop: 00000000
Last beacon src: 0000.0000.0000, Last poll: 0060.3ebb.0a21
Last MVID: 0006, Last attn code: 0000
Txmit priority: 0007, Auth funct class: FFFF
Monitor error: 0000, Front end errors: 0000
Correlator: 0000, Soft error timer: 00C8
Local ring: 0000, Ring status: 0000
Beacon rcv type: 0000, Beacon txmit type: 0000
Last beacon type:0000, Bcn station NAUN: 0000.0000.0000
Beacon drop: 00000000, Phantom support: 0000
Access prot req: 0000, Access prot resp: 0000
Policy flags: 0110, Protocol event state:000D
Ctrl ring state: 0001, Protocol join state: 0000
Reserved: 0000, Protocol mon state: 0000
The table below describes the significant fields shown in the display.
Table 89: show controllers token Field Descriptions
Field Description
Tokenring4/0 Interface processor type, slot, and port.
Cisco IOS Interface and Hardware Component Command Reference
1292
show controllers serial through show hw-module slot proc cpu
show controllers token
Field Description
Last Ring Status Last abnormal ring condition. Can be any of the following:
• Signal Loss
• HW Removal
• Remote Removal
• Counter Overflow
• Only station
• Ring Recovery
Current operating mode Operating mode. Can be one of the following:
• Classic token ring station (standard half-duplex Token Ring station)
• DTR station (full-duplex Token Ring station)
• DTR concentrator (concentrator port)
MAC state The MAC state indicates the state of the Token Ring MAC layer protocol. Can be
one of the following:
• Not inserted (not connected to any ring)
• Inserting (currently entering a ring)
• Inserted (connected to an active Token ring)
Related Commands Command Description
show interfaces tokenring Displays information about the Token Ring interface and the state of
source-route bridging.
show source-bridge Displays the current source bridge configuration and miscellaneous statistics.
Cisco IOS Interface and Hardware Component Command Reference
1293
show controllers serial through show hw-module slot proc cpu
show controllers vg-anylan
show controllers vg-anylan
To display the controller information for the 100VG-AnyLAN port adapter on Cisco 7200 series routers and
Cisco 7500 series routers, use the showcontrollersvg-anylan command in user EXEC or privileged EXEC
mode.
Cisco 7200 Series
show controllers vg-anylan slot/port
Cisco 7500 Series with VIP Cards
show controllers vg-anylan slot/port-adapter/port
Syntax Description slot Slot number. Refer to the appropriate hardware manual for slot and port information.
/ port Port number. Refer to the appropriate hardware manual for slot and port information.
/ port-adapter Port adapter number. Refer to the appropriate hardware manual for information about port
adapter compatibility.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
11.3 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The information displayed is generally useful for diagnostic tasks performed by technical support personnel
only.
Examples The following is sample output from the showcontrollersvg-anylan command:
Router# show controllers vg-anylan 3/0
Interface VG-AnyLAN3/0
Hardware is MC68852
mc68852_ds=0x60A4C930, registers=0x3C300000, ib=0x4B056240
rx ring entries=31, tx ring entries=31
rxring=0x4B056340, rxr shadow=0x60A4CA08, rx_head=0, rx_tail=0
txring=0x4B057180, txr shadow=0x60A4D07C, tx_head=0, tx_tail=2,
tx_count=2,
MC68852 Registers:
hw_id: 5048, hw_id & page: 7053, opr1=0x26, opr2=0x2C, opr3=0x00
Page 0 - Performance:
isr=0x3400, imr=0x0A0A, flreg=0x0000
xfrct=0xC07E0080, rxcnt=0, txcnt=1F
Page 1 - MAC Address/Hash Table:
addrlow= 6009B9, addrhigh=9B1809B9,hash bytes=06 00 20 00 00 00 00 00
Page 2 - Hardware Mapping:
mmmsw=0x3785, mmlsw=0x0000, bmreg =0x04
Cisco IOS Interface and Hardware Component Command Reference
1294
show controllers serial through show hw-module slot proc cpu
show controllers vg-anylan
Page 4 - LAN Configuration:
tccnf1=0x00, tccnf2=0x01
vccnf=0x99, vtrrg=0x0020, valow1=0x0000, valow2=0x0000
maccr1=0xBE, maccr2=0x00, maccr3=0x04, maccr4=0x03
Page 5 - MMU Registers:
rx mem stop addr=0xFF03, tx mem stop addr=0xFF07
MC68852 PCI registers:
bus_no=6, device_no=0
CFID=0x0005101A, CFCS=0x02800005, CFRV=0x02000000, CFLT=0x0000F800
CBIO=0x00006001, CBMA=0x00000000, CFIT=0x20080100, CFDA=0x0000000C
Actel Hardware CAM Control Registers:
CAM DEVICE BASE: 0x3C300800 Register Address: 0x3C300C00
CSR: 0x8000 CAMCR: 0xFFFF
USAR: 0000 MSAR: 0000 LSAR: 0000
FIFOCR: 0x8000 WRMASK: 0x0080
COMPARAND REG: 0000.0000.0000
PERSISTENT SOURCE: 0x0 PERSISTENT DEST: 0xFD010000
ACTEL CAM PCI registers:
bus_no=6, device_no=1
CFID=0x555511AA, CFCS=0x04800003, CFRV=0xF0F0F001, CFLT=0x00000000
CBIO=0x00006800, CBMA=0x00000000, CFIT=0x00000000, CFDA=0x00000000
pak_to_host=0x0, filtered_pak=0
throttled=0, enabled=0, disabled=0
tx_carrier_loss=0
fatal_tx_err=0, mult_ovfl=0
Cisco IOS Interface and Hardware Component Command Reference
1295
show controllers serial through show hw-module slot proc cpu
show controllers wanphy
show controllers wanphy
T o display the SPA mode (LAN mode or WAN mode), alarms, and the J1 byte string value, use the
showcontrollerswanphycommandin Privileged EXEC mode.
show controllers wanphy slot/subslot/port
Syntax Description slot The SIP slot number in which the Cisco 1-Port 10 Gigabit Ethernet LAN/WAN-PHY Shared Port
Adapter has been installed.
subslot The subslot number in which the Cisco 1-Port 10 Gigabit Ethernet LAN/WAN-PHY Shared Port
Adapter has been installed.
port The port number of the Cisco 1-Port 10 Gigabit Ethernet LAN/WAN-PHY Shared Port Adapter.
Note There is only 1 port (0) in the Cisco 1-Port 10 Gigabit Ethernet LAN/WAN-PHY Shared
Port Adapter.
Command Default No default values are available.
Command Modes Privileged EXEC Mode (EXEC)
Command History Release Modification
Cisco IOS XE Release 3.3.0S This command was introduced on the Cisco ASR 1000 Series Routers.
Usage Guidelines The showcontrollerwanphycommand has been introduced on the Cisco ASR 1000 Series Router in Cisco
IOS XE Release 3.3.0S. This command is used to display:
• LAN or WAN mode of operation in which the SPA is currently working
• Configured alarms and active alarms (if any)
• Remote J1 byte string value passed to check the connectivity from local SPA to the remote SPA
• SF-BER and SD-BER threshold values
Examples The following example shows the output of showcontrollerswanphy command:
Router# show controllers wanphy 0/1/0
TenGigabitEthernet0/1/0
Mode of Operation: WAN Mode
SECTION
LOF = 0 LOS = 0 BIP(B1) = 0
LINE
AIS = 0 RDI = 0 FEBE = 0 BIP(B2) = 0
PATH
AIS = 0 RDI = 0 FEBE = 0 BIP(B3) = 0
LOP = 0 NEWPTR = 0 PSE = 0 NSE = 0
WIS ALARMS
SER = 0 FELCDP = 0 FEAISP = 0
Cisco IOS Interface and Hardware Component Command Reference
1296
show controllers serial through show hw-module slot proc cpu
show controllers wanphy
WLOS = 0 PLCD = 0
LFEBIP = 0 PBEC = 0
Active Alarms[All defects]: SWLOF LAIS PAIS SER
Active Alarms[Highest Alarms]: SWLOF
Alarm reporting enabled for: SF SWLOF B1-TCA B2-TCA PLOP WLOS
Rx(K1/K2): 00/00 Tx(K1/K2): 00/00
S1S0 = 00, C2 = 0x1A
PATH TRACE BUFFER: UNSTABLE
Remote J1 Byte :
BER thresholds: SD = 10e-6 SF = 10e-3
TCA thresholds: B1 = 10e-6 B2 = 10e-6 B3 = 10e-6
Related Commands Command Description
clear controller wanphy Clears the counter of alarms generated, and resets it back to zero.
Cisco IOS Interface and Hardware Component Command Reference
1297
show controllers serial through show hw-module slot proc cpu
show controllers wlan-controller
show controllers wlan-controller
To show the Cisco Wireless Local Area Network (WLAN) controller network module on the router, use the
showcontrollerswlan-controller command in privileged EXEC mode.
show controllers wlan-controller slot/unit
Syntax Description slot/unit Specifies the router slot and unit numbers for the WLAN controller network module.
Command Default None
Command Modes Privileged EXEC
Command History Release Modification
12.4(2)XA1 This command was introduced on the router software.
12.4(6)T This command was integrated into Cisco IOS Release 12.4(6)T.
Examples The following example shows how to display interface information for the WLAN controller network
module:
Router# show controllers wlan-controllers 1/0
Interface wlan-controller1/0
Hardware is Intel 82559 FastEthernet
IDB: 67796B08, FASTSEND: 60E073CC, MCI_INDEX: 0
INSTANCE=0x67797BE8
Rx Ring entries = 64
Rx Shadow = 0x67797ED0
Rx Ring = 0x2DCC1840
Rx Ring Head = 5
Rx Ring Last = 4
Rx Buffer Descr = 0x2DCC3040
Rx Buffer Descr Head = 5
Rx Buffer Descr Last = 4
Rx Shadow (malloc) = 0x67797ED0
Rx Ring (malloc) = 0x2DCC1840
Rx Buffer Descr (malloc) = 0x2DCC3040
Tx Ring entries = 128
Tx Shadow = 0x67798008
Tx Shadow Head = 13
Tx Shadow Tail = 13
Tx Shadow Free = 128
Tx Ring = 0x2DCFAA40
Tx Head = 15
Tx Last = 14
Tx Tail = 15
Tx Count = 0
Tx Buffer Descr = 0x2DCF9080
Tx Buffer Descr Head = 0
Tx Buffer Descr Tail = 0
Tx Shadow (malloc) = 0x67798008
Tx Ring (malloc) = 0x2DCFAA40
Cisco IOS Interface and Hardware Component Command Reference
1298
show controllers serial through show hw-module slot proc cpu
show controllers wlan-controller
Tx Buffer Descr (malloc) = 0x2DCF9080
CONTROL AND STATUS REGISTERS (CSR)=0x4B000000
SCB Intr Mask = 00
SCB CU/RU Cmd = 00
SCB Intr Status = 00
SCB CU Status = 01
SCB RU Status = 04
SCB General Ptr = 00000000
PORT = 00000000
EEPROM = 0008
FLASH = 0002
MDI = 1821782D
Rx Byte Count = 00000608
PMDR = 80
FC Cmd = 00
FC Threshold = 03
Early Rx = 00
General Status = 07
General Control = 00
PHY REGISTERS
Register 0x00: 1000 782D 02A8 0154 0501 45E1 0003 0000
Register 0x08: 0000 0000 0000 0000 0000 0000 0000 0000
Register 0x10: 0203 0000 0001 0000 0000 0000 0000 0000
Register 0x18: 0001 0000 8B10 0000 0000 0000 0000 0000
HARDWARE STATISTICS
Rx good frames: 69
Rx CRC: 0
Rx alignment: 0
Rx resource: 0
Rx overrun: 0
Rx collision detects: 0
Rx short: 0
Tx good frames: 13
Tx maximum collisions: 0
Tx late collisions: 0
Tx underruns: 0
Tx lost carrier sense: 0
Tx deferred: 0
Tx single collisions: 0
Tx multiple collisions: 0
Tx total collisions: 0
FC Tx pause: 0
FC Rx pause: 0
FC Rx unsupported: 0
INTERRUPT STATISTICS
CX = 468239
FR = 2393445
CNA = 0
RNR = 0
MDI = 0
SWI = 0
FCP = 0
Receive All Multicasts = enabled
Receive Promiscuous = disabled
Loopback Mode = disabled
Module Reset Statistics:
CLI reset count = 0
Cisco IOS Interface and Hardware Component Command Reference
1299
show controllers serial through show hw-module slot proc cpu
show controllers wlan-controller
CLI reload count = 0
Registration request timeout reset count = 0
Error recovery timeout reset count = 0
Module registration count = 1
Cisco IOS Interface and Hardware Component Command Reference
1300
show controllers serial through show hw-module slot proc cpu
show counters interface
show counters interface
To display the information about the interface counter, use the showcountersinterface command in user
EXEC or privileged EXEC mode.
show counters interface type mod/port [delta]
Syntax Description type Interface type; possible valid values are ethernet, fastethernet, gigabitethernet,
tengigabitethernet, port-channel, pos, atm, null, tunnel, and ge-wan
mod / port Module and port number.
delta (Optional) Displays the interface counters values since the last clearcounters command.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(18)SXE This command was changed to support the delta keyword on the Supervisor Engine 720
only.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The showcountersinterface command is not supported on SVIs.
The showcountersinterfacedeltacommand displays a detailed list of the last-saved counter values.
Examples This example shows how to display the information about the interface counter:
Router# show counters interface fastethernet 5/2
64 bit counters:
0. rxHCTotalPkts = 1
1. txHCTotalPkts = 1
2. rxHCUnicastPkts = 0
3. txHCUnicastPkts = 0
4. rxHCMulticastPkts = 0
5. txHCMulticastPkts = 0
6. rxHCBroadcastPkts = 1
7. txHCBroadcastPkts = 1
8. rxHCOctets = 78
9. txHCOctets = 78
10. rxTxHCPkts64Octets = 0
11. rxTxHCPkts65to127Octets = 2
12. rxTxHCPkts128to255Octets = 0
13. rxTxHCPkts256to511Octets = 0
14. rxTxHCpkts512to1023Octets = 0
Cisco IOS Interface and Hardware Component Command Reference
1301
show controllers serial through show hw-module slot proc cpu
show counters interface
15. rxTxHCpkts1024to1518Octets = 0
16. txHCTrunkFrames = 0
17. rxHCTrunkFrames = 0
18. rxHCDropEvents = 0
32 bit counters:
0. rxCRCAlignErrors = 0
1. rxUndersizedPkts = 0
2. rxOversizedPkts = 0
3. rxFragmentPkts = 0
4. rxJabbers = 0
5. txCollisions = 0
6. ifInErrors = 0
7. ifOutErrors = 0
8. ifInDiscards = 0
9. ifInUnknownProtos = 0
10. ifOutDiscards = 0
11. txDelayExceededDiscards = 0
12. txCRC = 0
13. linkChange = 1
14. wrongEncapFrames = 0
All Port Counters
1. InPackets = 1
2. InOctets = 78
3. InUcastPkts = 0
4. InMcastPkts = 0
5. InBcastPkts = 1
6. OutPackets = 1
7. OutOctets = 78
8. OutUcastPkts = 0
9. OutMcastPkts = 0
10. OutBcastPkts = 1
11. AlignErr = 0
12. FCSErr = 0
13. XmitErr = 0
14. RcvErr = 0
15. UnderSize = 0
16. SingleCol = 0
17. MultiCol = 0
18. LateCol = 0
19. ExcessiveCol = 0
20. CarrierSense = 0
21. Runts = 0
22. Giants = 0
23. InDiscards = 0
24. OutDiscards = 0
25. InErrors = 0
26. OutErrors = 0
27. TrunkFramesTx = 0
28. TrunkFramesRx = 0
29. WrongEncap = 0
30. Broadcast_suppression_discards = 0
31. Multicast_suppression_discards = 0
32. Unicast_suppression_discards = 0
33. rxTxHCPkts64Octets = 0
34. rxTxHCPkts65to127Octets = 2
35. rxTxHCPkts128to255Octets = 0
36. rxTxHCPkts256to511Octets = 0
37. rxTxHCpkts512to1023Octets = 0
38. rxTxHCpkts1024to1518Octets = 0
39. DropEvents = 0
40. CRCAlignErrors = 0
41. UndersizedPkts = 0
42. OversizedPkts = 0
43. FragmentPkts = 0
Cisco IOS Interface and Hardware Component Command Reference
1302
show controllers serial through show hw-module slot proc cpu
show counters interface
44. Jabbers = 0
45. Collisions = 0
46. DelayExceededDiscards = 0
47. bpduOutlost = 0
48. qos0Outlost = 0
49. qos1Outlost = 0
50. qos2Outlost = 0
51. qos3Outlost = 0
52. bpduCbicOutlost = 0
53. qos0CbicOutlost = 0
54. qos1CbicOutlost = 0
55. qos2CbicOutlost = 0
56. qos3CbicOutlost = 0
57. bpduInlost = 0
58. qos0Inlost = 0
59. qos1Inlost = 0
60. qos2Inlost = 0
61. qos3Inlost = 0
62. qos4Inlost = 0
63. qos5Inlost = 0
64. qos6Inlost = 0
65. qos7Inlost = 0
66. pqueInlost = 0
67. Overruns = 0
68. maxIndex = 0
Router#
This example shows how to display the values for the interface counters since the last clearcounters
command:
Router# show counters interface gigabitethernet 5/2 delta
Time since last clear
---------------------
1d08h
64 bit counters:
0. rxHCTotalPkts = 508473
1. txHCTotalPkts = 2366
2. rxHCUnicastPkts = 411611
3. txHCUnicastPkts = 193
4. rxHCMulticastPkts = 81868
5. txHCMulticastPkts = 2155
6. rxHCBroadcastPkts = 14994
7. txHCBroadcastPkts = 18
8. rxHCOctets = 36961992
.
.
.
Router#
Related Commands Command Description
clear counters Clears the interface counters.
Cisco IOS Interface and Hardware Component Command Reference
1303
show controllers serial through show hw-module slot proc cpu
show diag
show diag
To display hardware and diagnostic information for a networking device, line card, processor, jacket card,
chassis, or network module, use the show diag command in privileged EXEC mode.
show diag [slot-number] [{details|summary}]
Cisco 7304 Router
show diag [{slot-number|chassis|subslot slot/subslot}] [{details|summary}]
Shared Port Adapters
show diag [subslot slot/subslot] [{details|summary}]
Network Module
show diag [slot-number]
Cisco 10000 Series Router
show diag [slot/subslot] [{details|summary}] [crashdump]
Cisco uBR10012 Universal Broadband Router
show diag [{slot/subslot|slot/subslot/port|summary}]
Cisco uBR7225VXR and Cisco uBR7246VXR Universal Broadband Routers
show diag slot
Cisco ASR 1000 Series Aggregation Services Routers
show diag [{all|chassis|slot|subslot}] eeprom
Cisco 4400 Series Integrated Services Router
show diag [{all|chassis|slot|subslot}] eeprom
Syntax Description slot-number (Optional) Slot number of the interface. If a slot number is not specified, diagnostic
information for all slots is displayed.
details (Optional) Displays more details than the normal show diag output.
summary (Optional) Displays a summary (one line per slot) of the chassis.
chassis (Optional) Specifies the display of diagnostic information about the backplane, power
supplies, and fan modules.
Cisco IOS Interface and Hardware Component Command Reference
1304
show controllers serial through show hw-module slot proc cpu
show diag
subslot slot / (Optional) Shared Port Adapters
subslot
Specifies the display of diagnostic information about the shared port adapter (SPA),
where:
• slot --Chassis slot number.
See the appropriate hardware manual for slot information. For SPA interface processor
(SIP), refer to the platform-specific SPA hardware installation guide or the corresponding
“Identifying Slots and Subslots for SIPs and SPAs” topic in the platform-specific SPA
software configuration guide.
• subslot --Secondary slot number on a SIP where a SPA is installed.
See the platform-specific SPA hardware installation guide and the corresponding
“Specifying the Interface Address on a SPA” topic in the platform-specific SPA software
configuration guide for subslot information.
(Optional) Specifies subslot location information for the connected network modules
and interfaces.
slot / subslot/port (Optional) Cisco uBR10012 Universal Broadband Router
Displays diagnostic information about the specified line card, where:
• slot --Slot number of the line card in the uBR10012 router. The range is 0 to 8.
• subslot --Subslot of the half-height line card in the uBR10012 router. The value t
is either 0 or 1.
• port --Port number on the cable interface. Valid values are 0 to 4 (depending on
the cable interface).
slot (Optional) Cisco uBR7225VXR and Cisco uBR7246VXR Universal Broadband
Routers
Displays diagnostic information about the specified line card, where:
• slot --Slot number of the line card in the Cisco uBR7225VXR or Cisco
uBR7246VXR router.
Cisco uBR7246VXR router: The range is 3 to 6.
Cisco uBR7225VXR router: The range is 1 to 2.
all (Optional) Displays all diagnostic information related to EEPROM.
Command Modes Privileged EXEC (#)
Command History Release Modification
11.1CA This command was introduced.
11.2 This command was integrated into Cisco IOS Release 11.2.
Cisco IOS Interface and Hardware Component Command Reference
1305
show controllers serial through show hw-module slot proc cpu
show diag
Release Modification
11.2P This command output was modified for the PA-12E/2FE port adapter, PA-E3
port adapter, and PA-T3 port adapter.
11.2GS This command was implemented on the Cisco 12000 series Internet router.
11.3 XA This command was integrated in Cisco IOS Release 11.3 XA.
12.0 This command was implemented on the Cisco AS5300.
12.0(5)XQ This command was implemented on the Cisco 1750 router.
12.0(7)T This command was integrated into Cisco IOS Release 12.0(7)T.
12.1(9)EX This command was introduced on the Cisco 7300 series routers, and the
slot-number argument and chassis keyword were added.
12.1(10)EX This command was enhanced to display information about Field-Programmable
Gate Array (FPGA) image versions on installed NSEs and line cards on Cisco
7304 routers.
12.2(11)YZ Support was added for the 7300-CC-PA.
12.2(8)T This command was implemented for AIC and WIC cards on the Cisco 2600
series routers and the Cisco 3600 series routers.
12.2(13)T This command was implemented for the AIM-VPN/EPII and AIM-VPN/HPII
cards on the Cisco 2691, Cisco 3660, Cisco 3725, and Cisco 3745 routers.
12.2(15)ZJ This command was implemented for the AIM-VPN/BPII card on the Cisco
2610XM, Cisco 2611XM, Cisco 2620XM, Cisco 2621XM, Cisco 2650XM,
and Cisco 2651XM routers.
12.2(18)S This command was integrated into Cisco IOS Release 12.2(18)S and
implemented on the Cisco 7304 router.
12.3(4)T Support for the AIM-VPN/BPII card on the Cisco 2600XM series was
integrated into Cisco IOS Release 12.3(4)T.
12.2(20)S2 This command was integrated into Cisco IOS Release 12.2(20)S2 and the
subslotslotsubslotkeyword and arguments were added to support SPAs on the
Cisco 7304 router.
12.0(31)S This command was integrated into Cisco IOS Release 12.0(31)S and the
subslotslotsubslotkeyword and arguments were added to support SIPs and
SPAs on the Cisco 12000 series Internet router.
12.4(4)T This command was implemented for the HWIC-1ADSL and HWIC-1ADSLI
interface cards on the following platforms: Cisco 1800 (modular) series, Cisco
2800 series, and Cisco 3800 series routers.
12.4(9)T This command was implemented for the NME-AON-K9= enhanced network
module on the following platforms: Cisco 2811, Cisco 2821, Cisco 2851, Cisco
3725, and Cisco 3745 routers.
Cisco IOS Interface and Hardware Component Command Reference
1306
show controllers serial through show hw-module slot proc cpu
show diag
Release Modification
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support
in a specific 12.2SX release of this train depends on your feature set, platform,
and platform hardware.
12.2(33)SB This command was enhanced with a crashdump option to enable you to display
crashdump files collected on the SIP. This was implemented on the Cisco
10000 series router for the PRE3 and PRE4.
12.2(33)SCC The output for this command was modified to display the diagnostic mode for
the Cisco uBR10-MC5X20H cable interface line card on the uBR10012 router,
when the field diagnostic image is loaded.
12.2(33)SCD This command was modified. Support was added for the Cisco uBR7225VXR
and Cisco uBR7246VXR routers.
12.2(33)XNE This command was modified. The all keyword was added.
12.2(33)SCG This command was modified. The output was modified to display all hardware
and EEPROM information, including PID and PCB information for the Cisco
uBR10-MC5X20H cable interface line card on the Cisco uBR10012 router.
IOS XE 3.9S This command was integrated into Cisco IOS XE Release 3.9S.
Usage Guidelines Use this command to determine the type of hardware installed in your router and to show detailed hardware
information and EEPROM version information.
This command displays information for the motherboard, WAN interface cards (WICs), voice interface cards
(VICs), high-speed WICs (HWICs), ATM interface cards (AICs), advanced integration modules (AIMs), port
adapters, shared port adapters (SPAs), modular services cards (MSCs), SPA interface processors (SIPs), and
enhanced network modules (NME).
For the Cisco 7304 router, this command applies to NEs, line cards, MSCs, and SPAs.
• To display hardware information for an NSE, line card, or MSC in the specified slot, use the
slot-numberargument. For MSCs, using this argument displays information about the MSC and each of
its installed SPAs.
• To display hardware information about the backplane, power supplies, and fan modules, use the chassis
keyword.
Shared Port Adapter Usage Guidelines
• To display hardware information for an MSC or SIP only in a specified slot, use the slot-numberargument.
• To display hardware information for a SPA only, use the show diag subslotslot/subslotversion of this
command.
Cisco 10000 Series Router Usage Guidelines
The crashdump keyword of the show diag command enables you to display any crashdump files collected
on the SIP. The SIP stores the crashdump files by a reference number from 1 to 60.
Cisco IOS Interface and Hardware Component Command Reference
1307
show controllers serial through show hw-module slot proc cpu
show diag
To view a crashdump file, do the following:
1. Determine the most recent crashdump number:
1. Enter the show diag slot/subslot command.
2. Look for the latest crashdump number in the following section of the command output:
Number of crashdumps : output number
3. Enter the following command to view the crashdump file:
show diag slot/subslot crashdump number
Note The subslot value is always zero for the SIP.
Cisco uBR10012 Router Usage Guidelines
• In the command syntax, the argument slot/subslot refers to a half-height line-card on the Cisco
uBR10012 Router.
• This command applies to all cable interface line cards. The output for this command additionally
displays the diagnostic mode when the Cisco uBR10-MC5X20H line card is enabled with the Field
Diagnostic image.
Examples
1-Port T3 Serial Port Adapter: Example
The following is a sample output from the show diag command for a 1-port T3 serial port adapter
in chassis slot 1 on a Cisco 7200 series router:
Router# show diag 1
Slot 1:
Physical slot 1, ~physical slot 0xE, logical slot 1, CBus 0
Microcode Status 0x4
Master Enable, LED, WCS Loaded
Board is analyzed
Pending I/O Status: None
EEPROM format version 1
VIP2 controller, HW rev 2.4, board revision D0
Serial number: 04372053 Part number: 73-1684-03
Test history: 0x00 RMA number: 00-00-00
Flags: cisco 7000 board; 7500 compatible
EEPROM contents (hex):
0x20: 01 15 02 04 00 42 B6 55 49 06 94 03 00 00 00 00
0x30: 68 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
Slot database information:
Flags: 0x4 Insertion time: 0x14A8 (5d02h ago)
Controller Memory Size: 16 MBytes DRAM, 1024 KBytes SRAM
PA Bay 0 Information:
T3 Serial PA, 1 ports
Cisco IOS Interface and Hardware Component Command Reference
1308
show controllers serial through show hw-module slot proc cpu
show diag
EEPROM format version 1
HW rev FF.FF, Board revision UNKNOWN
Serial number: 4294967295 Part number: 255-65535-255
Cisco 12000 Series Internet Router: Example
The following is a sample output from the show diag command on a Cisco 12000 series Internet
router:
Router# show diag 3
SLOT 3 (RP/LC 3 ): 4 Port Packet Over SONET OC-3c/STM-1 Multi Mode
MAIN: type 33, 00-0000-00 rev 70 dev 0
HW config: 0x01 SW key: 00-00-00
PCA: 73-2147-02 rev 94 ver 2
HW version 1.0 S/N 04499695
MBUS: MBUS Agent (1) 73-2146-05 rev 73 dev 0
HW version 1.1 S/N 04494882
Test hist: 0x00 RMA#: 00-00-00 RMA hist: 0x00
DIAG: Test count: 0x05000001 Test results: 0x00000000
MBUS Agent Software version 01.27 (RAM) using CAN Bus A
ROM Monitor version 00.0D
Fabric Downloader version used 00.0D (ROM version is 00.0D)
Board is analyzed
Board State is Line Card Enabled (IOS RUN )
Insertion time: 00:00:10 (00:04:51 ago)
DRAM size: 33554432 bytes
FrFab SDRAM size: 67108864 bytes
ToFab SDRAM size: 16777216 bytes
The following is a sample output from the show diag command with the summary keyword:
Router# show diag summary
SLOT 0 (RP/LC 0 ): Route Processor
SLOT 2 (RP/LC 2 ): 4 Port Packet Over SONET OC-3c/STM-1 Single Mode
SLOT 4 (RP/LC 4 ): 4 Port Packet Over SONET OC-3c/STM-1 Single Mode
SLOT 7 (RP/LC 7 ): 4 Port Packet Over SONET OC-3c/STM-1 Single Mode
SLOT 9 (RP/LC 9 ): 4 Port Packet Over SONET OC-3c/STM-1 Single Mode
SLOT 11 (RP/LC 11): 4 Port Packet Over SONET OC-3c/STM-1 Single Mode
SLOT 16 (CSC 0 ): Clock Scheduler Card
SLOT 17 (CSC 1 ): Clock Scheduler Card
SLOT 18 (SFC 0 ): Switch Fabric Card
SLOT 19 (SFC 1 ): Switch Fabric Card
SLOT 20 (SFC 2 ): Switch Fabric Card
SLOT 24 (PS A1 ): AC Power Supply
SLOT 26 (PS B1 ): AC Power Supply
SLOT 28 (TOP FAN ): Blower Module
SLOT 29 (BOT FAN ): Blower Module
The following is a sample output from the show diag command with the details keyword:
Router# show diag 4 details
SLOT 4 (RP/LC 4): 4 Port Packet Over SONET OC-3c/STM-1 Single Mode
MAIN: type 33, 800-2389-01 rev 71 dev 16777215
HW config: 0x00 SW key: FF-FF-FF
PCA: 73-2275-03 rev 75 ver 3
HW version 1.1 S/N 04529465
Cisco IOS Interface and Hardware Component Command Reference
1309
show controllers serial through show hw-module slot proc cpu
show diag
MBUS: MBUS Agent (1) 73-2146-06 rev 73 dev 0
HW version 1.1 S/N 04541395
Test hist: 0xFF RMA#: FF-FF-FF RMA hist: 0xFF
DIAG: Test count: 0x05000001 Test results: 0x00000000
EEPROM contents (hex):
00: 01 00 01 00 49 00 08 62 06 03 00 00 00 FF FF FF
10: 30 34 35 34 31 33 39 35 FF FF FF FF FF FF FF FF
20: 01 01 00 00 00 00 00 FF FF FF FF FF FF FF FF FF
30: A5 FF A5 A5 A5 A5 FF A5 A5 A5 A5 A5 A5 A5 A5 A5
40: 00 21 01 01 00 49 00 08 E3 03 05 03 00 01 FF FF
50: 03 20 00 09 55 01 01 FF FF FF 00 FF FF FF FF FF
60: 30 34 35 32 39 34 36 35 FF FF FF FF FF FF FF FF
70: FF FF FF FF FF FF FF FF 05 00 00 01 00 00 00 00
MBUS Agent Software version 01.24 (RAM)
Fabric Downloader version 00.0D
Board is analyzed
Flags: 0x4
Board State is Line Card Enabled (IOS RUN)
Insertion time: 00:00:10 (00:04:51 ago)
DRAM size: 33554432 bytes
FrFab SDRAM size: 67108864 bytes
ToFab SDRAM size: 16777216 bytes
ATM SAR AIM in a Cisco 3660: Example
The following is a sample output from the show diag command for one ATM Segmentation and
Reassembly (SAR) AIM in a Cisco 3660 router:
Router# show diag 0
3660 Chassis type: ENTERPRISE
c3600 Backplane EEPROM:
Hardware Revision : 1.0
Top Assy. Part Number : 800-04740-02
.
.
.
ATM AIM: 1
ATM AIM module with SAR only (no DSPs)
Hardware Revision : 1.0
Top Assy. Part Number : 800-03700-01
Board Revision : A0
Deviation Number : 0-0
Fab Version : 02
PCB Serial Number : JAB9801ABCD
NM-AIC-64 Installed in a Cisco 2611: Example
The following is a sample output from the show diag command for a Cisco 2611 router with the
NM-AIC-64 installed.
Router# show diag
Cisco IOS Interface and Hardware Component Command Reference
1310
show controllers serial through show hw-module slot proc cpu
show diag
Slot 0:
C2611 2E Mainboard Port adapter, 2 ports
Port adapter is analyzed
Port adapter insertion time unknown
EEPROM contents at hardware discovery:
Hardware Revision : 2.3
PCB Serial Number : JAD044808SG (1090473337)
Part Number : 73-2840-13
RMA History : 00
RMA Number : 0-0-0-0
Board Revision : C0
Deviation Number : 0-0
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 00 92 41 02 03 C1 18 4A 41 44 30 34 34
0x10: 38 30 38 53 47 20 28 31 30 39 30 34 37 33 33 33
0x20: 37 29 82 49 0B 18 0D 04 00 81 00 00 00 00 42 43
0x30: 30 80 00 00 00 00 FF FF FF FF FF FF FF FF FF FF
0x40: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x50: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
Slot 1:
NM_AIC_64 Port adapter, 3 ports
Port adapter is analyzed
Port adapter insertion time unknown
EEPROM contents at hardware discovery:
Hardware Revision : 1.0
Part Number : 74-1923-01
Board Revision : 02
PCB Serial Number : DAN05060012
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 02 55 41 01 00 82 4A 07 83 01 42 30 32
0x10: C1 8B 44 41 4E 30 35 30 36 30 30 31 32 FF FF FF
0x20: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x30: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x40: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x50: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
The table below describes significant fields shown in the display.
Table 90: show diag (AIC) Field Descriptions
Field Description
C2611 2E Mainboard Port adapter, 2 ports Line card type; number of ports available.
Port adapter is analyzed The system has identified the port adapter.
Port adapter insertion time Elapsed time since insertion.
Hardware Revision Version number of the port adapter.
PCB Serial Number Serial number of the printed circuit board.
Part Number Part number of the port adapter.
Cisco IOS Interface and Hardware Component Command Reference
1311
show controllers serial through show hw-module slot proc cpu
show diag
Field Description
RMA History Counter that indicates how many times the port adapter has been
returned and repaired.
RMA Number Return material authorization number, which is an administrative
number assigned if the port adapter needs to be returned for repair.
Board Revision Revision number (signifying a minor revision) of the port adapter.
Deviation Number Revision number (signifying a minor deviation) of the port
adapter.
EEPROM format version Version number of the EEPROM format.
EEPROM contents (hex) Dumps of EEPROM programmed data.
AIM-VPN in a Cisco 2611XM: Example
The following example shows how to obtain hardware information about an installed AIM-VPN on
the Cisco 2611XM router.
Router# show diag 0
Encryption AIM 1:
Hardware Revision :1.0
Top Assy. Part Number :800-03700-01
Board Revision :A0
Deviation Number :0-0
Fab Version :02
PCB Serial Number :JAB9801ABCD
RMA Test History :00
RMA Number :0-0-0-0
RMA History :00
EEPROM format version 4
EEPROM contents (hex):
0x00:04 FF 40 03 0B 41 01 00 C0 46 03 20 00 0E 74 01
0x10:42 41 30 80 00 00 00 00 02 02 C1 8B 4A 41 42 39
0x20:38 30 31 41 42 43 44 03 00 81 00 00 00 00 04 00
0x30:FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x40:FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x50:FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x60:FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
Cisco IOS Interface and Hardware Component Command Reference
1312
show controllers serial through show hw-module slot proc cpu
show diag
0x70:FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
The table below describes significant fields shown in the display.
Table 91: show diag (AIM-VPN) Field Descriptions
Field Description
Hardware Revision Version number of the port adapter.
Top Assy. Part Number Part number of the port adapter.
Board Revision Revision number (signifying a minor revision) of the port adapter.
Deviation Number Revision number (signifying a minor deviation) of the port adapter.
PCB Serial Number Serial number of the printed circuit board.
RMA Number Return material authorization number, which is an administrative number assigned
if the port adapter needs to be returned for repair.
RMA History Counter that indicates how many times the port adapter has been returned and
repaired.
EEPROM format version Version number of the EEPROM format.
EEPROM contents (hex) Dumps of EEPROM programmed data.
MSC-100 on the Cisco 7304 Router: Example
The following is a sample output from the show diag slot-number version of the command for an
MSC-100 located in slot number 4 on a Cisco 7304 router. Information about the MSC is followed
by information for its associated SPAs:
Router# show diag 4
Slot 4:
7304-MSC-100 SPA Carrier Card Line Card
Line Card state: Active
Insertion time: 00:08:49 ago
Bandwidth points: 4000000
EEPROM contents at hardware discovery:
Hardware Revision : 0.18
Boot Time out : 0000
PCB Serial Number : CSJ07288905
Part Number : 73-8789-01
Board Revision : A0
Fab Version : 02
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Deviation Number : 0-0
Product Number : 7304-MSC-100
Top Assy. Part Number : 68-1163-04
Manufacturing Test Data : 00 00 00 00 00 00 00 00
Field Diagnostics Data : 00 00 00 00 00 00 00 00
Calibration Data : Minimum: 0 dBmV, Maximum: 0 dBmV
Cisco IOS Interface and Hardware Component Command Reference
1313
show controllers serial through show hw-module slot proc cpu
show diag
Calibration values :
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 04 50 41 00 12 46 00 00 C1 8B 43 53 4A
0x10: 30 37 32 38 38 39 30 35 82 49 22 55 01 42 41 30
0x20: 02 02 03 00 81 00 00 00 00 04 00 80 00 00 00 00
0x30: CB 94 37 33 30 34 2D 4D 53 43 2D 31 30 30 20 20
0x40: 20 20 20 20 20 20 87 44 04 8B 04 C4 08 00 00 00
0x50: 00 00 00 00 00 C5 08 00 00 00 00 00 00 00 00 C8
0x60: 09 00 00 00 00 00 00 00 00 00 C7 7C F6 44 3F 30
0x70: 00 00 00 00 00 00 00 00 00 00 00 00 02 EE FF C8
0x80: C8 37 26 05 DC 64 28 1E 37 26 09 C4 64 32 28 32
0x90: DD 0C E4 64 32 28 43 24 2E E0 AA 82 64 F4 24 00
0xA0: 00 00 00 00 00 00 F0 2E FF FF FF FF FF FF FF FF
0xB0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0xC0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0xD0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0xE0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0xF0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x100: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x110: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x120: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x130: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x140: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x150: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x160: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x170: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x180: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x190: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x1A0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x1B0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x1C0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x1D0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x1E0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x1F0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
FPGA information:
Current FPGA version : 00.23
IOS bundled FPGA version : 00.23
CPLD version : 01.02
Subslot 4/1:
Shared port adapter: SPA-4FE-7304, 4 ports
State: ok
Insertion time: 00:15:13 ago
Bandwidth: 400000 kbps
EEPROM contents:
NSE-100 on the Cisco 7304 Router: Example
The following example displays diagnostic information about the NSE-100 in slot 0 of a Cisco 7304
router:
Router# show diag 0
Slot 0/1:
NSE Card state:Primary
Insertion time:00:03:47 ago
C7300 NSE Mainboard EEPROM:
Hardware Revision :2.3
Cisco IOS Interface and Hardware Component Command Reference
1314
show controllers serial through show hw-module slot proc cpu
show diag
PCB Serial Number :CAB0532JYYT
Part Number :73-5198-02
Board Revision :A0
Fab Version :02
RMA Test History :00
RMA Number :0-0-0-0
RMA History :00
Deviation Number :0-0
Product Number :7300-NSE-100
Top Assy. Part Number :68-1002-02
Manufacturing Test Data :00 00 00 00 00 00 00 00
Field Diagnostics Data :00 00 00 00 00 00 00 00
Calibration Data :Minimum:0 dBmV, Maximum:0 dBmV
Calibration values :
EEPROM format version 4
EEPROM contents (hex):
0x00:04 FF 40 02 8B 41 02 03 C1 8B 43 41 42 30 35 33
0x10:32 4A 59 59 54 82 49 14 4E 02 42 41 30 02 02 03
0x20:00 81 00 00 00 00 04 00 80 00 00 00 00 CB 94 37
0x30:33 30 30 2D 4E 53 45 2D 31 30 30 20 20 20 20 20
0x40:20 20 20 87 44 03 EA 02 C4 08 00 00 00 00 00 00
0x50:00 00 C5 08 00 00 00 00 00 00 00 00 C8 09 00 00
0x60:00 00 00 00 00 00 00 C7 7C F6 44 3F 30 F6 44 3F
0x70:30 F6 44 3F 30 00 00 00 00 07 08 64 32 28 37 26
0x80:09 C4 5A 32 28 32 DD 0C E4 5A 2D 23 43 24 13 88
0x90:64 32 28 65 BA 2E E0 AA 82 64 F4 24 00 00 00 00
0xA0:00 00 00 EF 1C FF FF FF FF FF FF FF FF FF FF FF
0xB0:FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0xC0:FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0xD0:FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0xE0:FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0xF0:FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
C7300 NSE Daughterboard EEPROM:
Hardware Revision :2.0
PCB Serial Number :CAB0533K3PP
Part Number :73-5673-03
Board Revision :A0
Fab Version :03
RMA Test History :00
RMA Number :0-0-0-0
RMA History :00
Deviation Number :0-0
Product Number :7300-NSE-100
Top Assy. Part Number :68-1002-02
Manufacturing Test Data :00 00 00 00 00 00 00 00
Field Diagnostics Data :00 00 00 00 00 00 00 00
Calibration Data :Minimum:0 dBmV, Maximum:0 dBmV
Calibration values :
EEPROM format version 4
EEPROM contents (hex):
0x00:04 FF 40 02 8C 41 02 00 C1 8B 43 41 42 30 35 33
0x10:33 4B 33 50 50 82 49 16 29 03 42 41 30 02 03 03
0x20:00 81 00 00 00 00 04 00 80 00 00 00 00 CB 94 37
0x30:33 30 30 2D 4E 53 45 2D 31 30 30 20 20 20 20 20
0x40:20 20 20 87 44 03 EA 02 C4 08 00 00 00 00 00 00
0x50:00 00 C5 08 00 00 00 00 00 00 00 00 C8 09 00 00
0x60:00 00 00 00 00 00 00 C7 7C F6 44 3F 30 00 00 00
0x70:00 00 00 00 00 00 00 00 00 06 72 64 1E 1C 37 26
0x80:07 08 64 32 28 37 26 00 00 00 00 00 00 00 00 00
0x90:00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xA0:00 00 00 FB BA FF FF FF FF FF FF FF FF FF FF FF
0xB0:FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
Cisco IOS Interface and Hardware Component Command Reference
1315
show controllers serial through show hw-module slot proc cpu
show diag
0xC0:FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0xD0:FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0xE0:FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0xF0:FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
FPGA information:
Current NSE MB FPGA version :0.3
IOS bundled NSE MB FPGA version :0.12
Current NSE DB FPGA version :0.3
IOS bundled NSE DB FPGA version :0.10
Fault History Buffer:
7300 Software (C7300-IS-M), Experimental Version 12.1(20011206:191841) [user-ws1 179]
Compiled Tue 29-Jan-02 08:10 by
Signal = 22, Code = 0x0, Uptime 00:00:48
$0 :FFFFFFFF, AT :47001098, v0 :10020028, v1 :0000006F
a0 :A0000000, a1 :00000005, a2 :00000001, a3 :10020028
t0 :00000028, t1 :3401E101, t2 :34018100, t3 :FFFF00FF
t4 :40332E68, t5 :43204650, t6 :70646174, t7 :69707065
s0 :FFFFFFFF, s1 :FFFFFFFF, s2 :FFFFFFFF, s3 :FFFFFFFF
s4 :FFFFFFFF, s5 :FFFFFFFF, s6 :FFFFFFFF, s7 :FFFFFFFF
t8 :00000000, t9 :00000000, k0 :3041D001, k1 :30410000
gp :FFFFFFFF, sp :41AA8F20, s8 :FFFFFFFF, ra :4036B6A4
EPC :4036B69C, SREG :3401E103, Cause :FFFFFFFF
Error EPC :FFFFFFFF, BadVaddr :FFFFFFFF
ROMMON Last Error Info:
count:19, reason:reset
pc:0x4020BFBC, error address:0x00000000
Stack Trace:
FP:0x00000000, PC:0x00000000
FP:0x00000000, PC:0x00000000
Shared Port Adapters on the Cisco 7304 Router: Example
The following is a sample output from the show diag subslot command for a 4-Port 10/100 Fast
Ethernet SPA located in the bottom subslot (1) of the MSC that is installed in slot 4 on a Cisco 7304
router:
Router# show diag subslot 4/1
Subslot 4/1:
Shared port adapter: SPA-4FE-7304, 4 ports
Info: hw-ver=0x100, sw-ver=0x0 fpga-ver=0x0
State: ok
Insertion time: 23:20:42 ago
Bandwidth: 400000 kbps
EEPROM contents:
Hardware Revision : 1.0
Boot Time out : 0190
PCB Serial Number : JAB073204G5
Part Number : 73-8717-03
73/68 Level Revision : 01
Fab Version : 02
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Deviation Number : 0
Product Number : SPA-4FE-7304
Product Version Id : V01
Top Assy. Part Number : 68-2181-01
73/68 Level Revision : A0
Cisco IOS Interface and Hardware Component Command Reference
1316
show controllers serial through show hw-module slot proc cpu
show diag
CLEI Code : CNS9420AAA
Base MAC Address : 0000.0000.0000
MAC Address block size : 1024
Manufacturing Test Data : 00 00 00 00 00 00 00 00
Field Diagnostics Data : 00 00 00 00 00 00 00 00
Field Diagnostics Data : 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00
Calibration Data : Minimum: 0 dBmV, Maximum: 0 dBmV
Calibration values :
Power Consumption : 160000mW max
Mode 1 : 0mW
Mode 2 : 0mW
Mode 3 : 0mW
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 04 35 41 01 00 46 01 90 C1 8B 4A 41 42
0x10: 30 37 33 32 30 34 47 35 82 49 22 0D 03 8A 30 31
0x20: 20 20 02 02 03 00 81 00 00 00 00 04 00 88 00 00
0x30: 00 00 CB 94 53 50 41 2D 34 46 45 2D 37 33 30 34
0x40: 20 20 20 20 20 20 20 20 89 56 30 31 20 87 44 08
0x50: 85 01 8A 41 30 20 20 C6 8A 43 4E 53 39 34 32 30
0x60: 41 41 41 CF 06 00 00 00 00 00 00 43 04 00 C4 08
0x70: 00 00 00 00 00 00 00 00 C5 08 00 00 00 00 00 00
0x80: 00 00 F4 00 64 00 00 00 00 00 00 00 00 00 00 00
0x90: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xA0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xB0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xC0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xD0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xE0: 00 00 00 00 00 00 00 00 00 C8 09 00 00 00 00 00
0xF0: 00 00 00 00 D7 08 3E 80 00 00 00 00 00 00 F3 00
0x100: 41 01 08 F6 48 43 34 F6 49 44 35 02 31 04 B0 B4
0x110: A0 8C 00 00 05 DC 64 46 32 00 00 07 08 64 46 32
0x120: 00 00 09 C4 64 46 32 00 00 0C E4 64 46 32 00 00
0x130: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 FE 02
0x140: F2 A6 FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x150: CC A0 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x160: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x170: 00 00 D4 A0 00 00 00 00 00 00 00 00 00 00 00 00
0x180: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x190: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1A0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1B0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1C0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1D0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1E0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1F0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
FPGA version:
Software version : 04.17
Hardware version : 04.17
Cisco IOS Interface and Hardware Component Command Reference
1317
show controllers serial through show hw-module slot proc cpu
show diag
The following is a sample output from the show diag subslot command for a 2-Port 10/100/1000
Gigabit Ethernet SPA located in the top subslot (0) of the MSC that is installed in slot 4 on a Cisco
7304 router:
Router# show diag subslot 4/0
Subslot 4/0:
Shared port adapter: SPA-2GE-7304, 2 ports
Info: hw-ver=0x17, sw-ver=0x0 fpga-ver=0x0
State: ok
Insertion time: 00:08:47 ago
Bandwidth: 2000000 kbps
EEPROM contents:
Hardware Revision : 0.23
Boot Time out : 0190
PCB Serial Number : JAB073406YH
Part Number : 73-8792-02
73/68 Level Revision : 01
Fab Version : 02
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Deviation Number : 0
Product Number : SPA-2GE-7304
Product Version Id : V01
Top Assy. Part Number : 68-2181-01
73/68 Level Revision : A0
CLEI Code : CNS9420AAA
Base MAC Address : 0000.0000.0000
MAC Address block size : 1024
Manufacturing Test Data : 00 00 00 00 00 00 00 00
Field Diagnostics Data : 00 00 00 00 00 00 00 00
Field Diagnostics Data : 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00
Calibration Data : Minimum: 0 dBmV, Maximum: 0 dBmV
Calibration values :
Power Consumption : 160000mW max
Mode 1 : 0mW
Mode 2 : 0mW
Mode 3 : 0mW
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 04 36 41 00 17 46 01 90 C1 8B 4A 41 42
0x10: 30 37 33 34 30 36 59 48 82 49 22 58 02 8A 30 31
0x20: 20 20 02 02 03 00 81 00 00 00 00 04 00 88 00 00
0x30: 00 00 CB 94 53 50 41 2D 32 47 45 2D 37 33 30 34
0x40: 20 20 20 20 20 20 20 20 89 56 30 31 20 87 44 08
0x50: 85 01 8A 41 30 20 20 C6 8A 43 4E 53 39 34 32 30
0x60: 41 41 41 CF 06 00 00 00 00 00 00 43 04 00 C4 08
Cisco IOS Interface and Hardware Component Command Reference
1318
show controllers serial through show hw-module slot proc cpu
show diag
0x70: 00 00 00 00 00 00 00 00 C5 08 00 00 00 00 00 00
0x80: 00 00 F4 00 64 00 00 00 00 00 00 00 00 00 00 00
0x90: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xA0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xB0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xC0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xD0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xE0: 00 00 00 00 00 00 00 00 00 C8 09 00 00 00 00 00
0xF0: 00 00 00 00 D7 08 3E 80 00 00 00 00 00 00 F3 00
0x100: 41 01 08 F6 48 43 34 F6 49 44 35 02 31 03 E8 B4
0x110: A0 8C 37 26 05 DC 64 46 32 37 26 07 08 64 46 32
0x120: 37 26 09 C4 64 46 32 32 DD 0C E4 64 46 32 43 24
0x130: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 FE 02
0x140: EF E2 FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x150: CC A0 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x160: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x170: 00 00 D4 A0 00 00 00 00 00 00 00 00 00 00 00 00
0x180: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x190: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1A0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1B0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1C0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1D0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1E0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x1F0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
FPGA version:
Software version : 04.17
Hardware version : 04.17
Shared Port Adapter on a Cisco 12000 Series Internet Router: Example
The following is a sample output from the show diag subslot command for the 1-Port
OC-192c/STM-64c POS/RPR XFP SPA in subslot 1 of the SIP located in chassis slot 1 on a Cisco
12000 series Internet router:
Router# show diag subslot 1/1
SUBSLOT 1/1 (SPA-OC192POS-XFP): 1-port OC192/STM64 POS/RPR XFP Optics Shared Port Adapter
Product Identifier (PID) : SPA-OC192POS-XFP
Version Identifier (VID) : V01
PCB Serial Number : PRTA1304061
Top Assy. Part Number : 68-2190-01
Top Assy. Revision : A0
Hardware Revision : 2.0
CLEI Code : UNASSIGNED
Insertion Time : 00:00:10 (13:14:17 ago)
Operational Status : ok
The table below describes the significant fields shown in the display.
Table 92: show diag subslot Field Descriptions for Cisco 12000 Series Internet Routers
Field Description
Product Identifier (PID) Product number of the SPA.
Version Identifier (VID) Version number of the SPA.
PCB Serial Number Serial number of the printed circuit board.
Cisco IOS Interface and Hardware Component Command Reference
1319
show controllers serial through show hw-module slot proc cpu
show diag
Field Description
Top Assy. Part Number Part number of the SPA.
Top Assy. Revision Revision number (signifying a minor revision) of the SPA.
Hardware Revision Revision number (signifying a minor revision) of the SPA hardware.
CLEI Code Common Language Equipment Identification number.
Insertion Time Time when the SPA was installed, and elapsed time between that insertion time
and the current time.
Operational Status Current status of the SPA. For more information about the status field descriptions,
refer to the show hw-module subslot oir command.
The following is a sample output from the show diag subslot detailscommand for the 1-Port
OC-192c/STM-64c POS/RPR XFP SPA in subslot 1 of the SIP located in chassis slot 1 on a Cisco
12000 series Internet router:
Router# show diag subslot 1/1 details
SUBSLOT 1/1 (SPA-OC192POS-XFP): 1-port OC192/STM64 POS/RPR XFP Optics Shared Port Adapter
EEPROM version : 4
Compatible Type : 0xFF
Controller Type : 1100
Hardware Revision : 2.0
Boot Timeout : 400 msecs
PCB Serial Number : PRTA1304061
PCB Part Number : 73-8546-01
PCB Revision : A0 Fab Version : 01
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Deviation Number : 0
Product Identifier (PID) : SPA-OC192POS-XFP
Version Identifier (VID) : V01
Top Assy. Part Number : 68-2190-01
Top Assy. Revision : A0 IDPROM Format Revision : 36
System Clock Frequency : 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00
CLEI Code : UNASSIGNED
Base MAC Address : 00 00 00 00 00 00
MAC Address block size : 0
Manufacturing Test Data : 00 00 00 00 00 00 00 00
Field Diagnostics Data : 00 00 00 00 00 00 00 00
Calibration Data : Minimum: 0 dBmV, Maximum: 0 dBmV
Calibration values :
Power Consumption : 11000 mWatts (Maximum)
Environment Monitor Data : 03 30 04 B0 46 32 07 08
46 32 09 C4 46 32 0C E4
46 32 13 88 46 32 07 08
46 32 EB B0 50 3C 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 FE 02 F6 AC
Processor Label : 00 00 00 00 00 00 00
Platform features : 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
Cisco IOS Interface and Hardware Component Command Reference
1320
show controllers serial through show hw-module slot proc cpu
show diag
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00
Asset ID :
Asset Alias :
Insertion Time : 00:00:10 (13:14:24 ago)
Operational Status : ok
SPA Interface Processor on a Cisco 12000 Series Internet Router: Example
The following is a sample output from the show diag command for a SIP located in chassis slot 2
on a Cisco 12000 series Internet router:
Router# show diag 2
SLOT 2 (RP/LC 2 ): Modular 10G SPA Interface Card
MAIN: type 149, 800-26270-01 rev 84
Deviation: 0
HW config: 0x00 SW key: 00-00-00
PCA: 73-9607-01 rev 91 ver 1
Design Release 1.0 S/N SAD08460678
MBUS: Embedded Agent
Test hist: 0x00 RMA#: 00-00-00 RMA hist: 0x00
DIAG: Test count: 0x00000000 Test results: 0x00000000
FRU: Linecard/Module: 12000-SIP-650
FRU: Linecard/Module: 12000-SIP-650
Processor Memory: MEM-LC5-1024=(Non-Replaceable)
Packet Memory: MEM-LC5-PKT-256=(Non-Replaceable)
L3 Engine: 5 - ISE OC192 (10 Gbps)
MBUS Agent Software version 1.114 (RAM) (ROM version is 3.4)
ROM Monitor version 255.255
Fabric Downloader version used 3.7 (ROM version is 255.255)
Primary clock is CSC 1
Board is analyzed
Board State is Line Card Enabled (IOS RUN )
Insertion time: 1d00h (2d08h ago)
Processor Memory size: 1073741824 bytes
TX Packet Memory size: 268435456 bytes, Packet Memory pagesize: 32768 bytes
RX Packet Memory size: 268435456 bytes, Packet Memory pagesize: 32768 bytes
0 crashes since restart
SPA Information:
subslot 2/0: SPA-OC192POS-XFP (0x44C), status is ok
subslot 2/1: Empty
subslot 2/2: Empty
subslot 2/3: Empty
ADSL HWICs: Example
The following is a sample output from the show diag command for a Cisco 2811 router with
HWIC-1ADSL installed in slot 1 and HWIC-1ADSLI installed in slot 2. Each HWIC has a
daughtercard as part of its assembly. The command results below give the output from the HWIC
followed by the output from its daughtercard.
Router# show diag 0
Slot 0:
C2811 Motherboard with 2FE and integrated VPN Port adapter, 2 ports
Port adapter is analyzed
Cisco IOS Interface and Hardware Component Command Reference
1321
show controllers serial through show hw-module slot proc cpu
show diag
Port adapter insertion time unknown
Onboard VPN : v2.2.0
EEPROM contents at hardware discovery:
PCB Serial Number : FOC09052HHA
Hardware Revision : 2.0
Top Assy. Part Number : 800-21849-02
Board Revision : B0
Deviation Number : 0
Fab Version : 06
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Processor type : 87
Hardware date code : 20050205
Chassis Serial Number : FTX0908A0B0
Chassis MAC Address : 0013.1ac2.2848
MAC Address block size : 24
CLEI Code : CNMJ7N0BRA
Product (FRU) Number : CISCO2811
Part Number : 73-7214-09
Version Identifier : NA
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF C1 8B 46 4F 43 30 39 30 35 32 48 48 41 40
0x10: 03 E7 41 02 00 C0 46 03 20 00 55 59 02 42 42 30
0x20: 88 00 00 00 00 02 06 03 00 81 00 00 00 00 04 00
0x30: 09 87 83 01 31 F1 1D C2 8B 46 54 58 30 39 30 38
0x40: 41 30 42 30 C3 06 00 13 1A C2 28 48 43 00 18 C6
0x50: 8A 43 4E 4D 4A 37 4E 30 42 52 41 CB 8F 43 49 53
0x60: 43 4F 32 38 31 31 20 20 20 20 20 20 82 49 1C 2E
0x70: 09 89 20 20 4E 41 D9 02 40 C1 FF FF FF FF FF FF
WIC Slot 1:
ADSL over POTS
Hardware Revision : 7.0
Top Assy. Part Number : 800-26247-01
Board Revision : 01
Deviation Number : 0
Fab Version : 07
PCB Serial Number : FHH093600D4
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Product (FRU) Number : HWIC-1ADSL
Version Identifier : V01
CLEI Code :
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 04 C8 41 07 00 C0 46 03 20 00 66 87 01
0x10: 42 30 31 88 00 00 00 00 02 07 C1 8B 46 48 48 30
0x20: 39 33 36 30 30 44 34 03 00 81 00 00 00 00 04 00
0x30: CB 94 48 57 49 43 2D 31 41 44 53 4C 20 20 20 20
0x40: 20 20 20 20 20 20 89 56 30 31 20 D9 02 40 C1 C6
0x50: 8A FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
EM Slot 0:
ADSL over POTS non-removable daughtercard
Hardware Revision : 5.0
Part Number : 73-9307-05
Board Revision : 03
Deviation Number : 0
Fab Version : 05
PCB Serial Number : FHH0936006E
Cisco IOS Interface and Hardware Component Command Reference
1322
show controllers serial through show hw-module slot proc cpu
show diag
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Fab Part Number : 28-6607-05
Manufacturing Test Data : 00 00 00 00 00 00 00 00
Field Diagnostics Data : 00 00 00 00 00 00 00 00
Connector Type : 01
Version Identifier : V01
Product (FRU) Number :
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 04 7A 41 05 00 82 49 24 5B 05 42 30 33
0x10: 88 00 00 00 00 02 05 C1 8B 46 48 48 30 39 33 36
0x20: 30 30 36 45 03 00 81 00 00 00 00 04 00 85 1C 19
0x30: CF 05 C4 08 00 00 00 00 00 00 00 00 C5 08 00 00
0x40: 00 00 00 00 00 00 05 01 89 56 30 31 20 FF FF FF
0x50: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
WIC Slot 2:
ADSL over ISDN
Hardware Revision : 7.0
Top Assy. Part Number : 800-26248-01
Board Revision : 01
Deviation Number : 0
Fab Version : 07
PCB Serial Number : FHH093600DA
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Product (FRU) Number : HWIC-1ADSLI
Version Identifier : V01
CLEI Code :
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 04 C9 41 07 00 C0 46 03 20 00 66 88 01
0x10: 42 30 31 88 00 00 00 00 02 07 C1 8B 46 48 48 30
0x20: 39 33 36 30 30 44 41 03 00 81 00 00 00 00 04 00
0x30: CB 94 48 57 49 43 2D 31 41 44 53 4C 49 20 20 20
0x40: 20 20 20 20 20 20 89 56 30 31 20 D9 02 40 C1 C6
0x50: 8A FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
EM Slot 0:
ADSL over ISDN non-removable daughtercard
Hardware Revision : 5.0
Part Number : 73-9308-05
Board Revision : 03
Deviation Number : 0
Fab Version : 05
PCB Serial Number : FHH0936008M
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Fab Part Number : 28-6607-05
Manufacturing Test Data : 00 00 00 00 00 00 00 00
Field Diagnostics Data : 00 00 00 00 00 00 00 00
Connector Type : 01
Version Identifier : V01
Product (FRU) Number :
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 04 7B 41 05 00 82 49 24 5C 05 42 30 33
Cisco IOS Interface and Hardware Component Command Reference
1323
show controllers serial through show hw-module slot proc cpu
show diag
0x10: 88 00 00 00 00 02 05 C1 8B 46 48 48 30 39 33 36
0x20: 30 30 38 4D 03 00 81 00 00 00 00 04 00 85 1C 19
0x30: CF 05 C4 08 00 00 00 00 00 00 00 00 C5 08 00 00
0x40: 00 00 00 00 00 00 05 01 89 56 30 31 20 FF FF FF
0x50: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
NME-AON-K9= Installed in a Cisco 3845: Example
The following is a sample output from the show diag command for an integrated-service-engine
port adapter in slot 2 on a Cisco 3845 router:
Slot 2:
Integrated Service Engine Port adapter, 1 port
Port adapter is analyzed
Port adapter insertion time unknown
EEPROM contents at hardware discovery:
Hardware Revision : 1.0
Top Assy. Part Number : 800-28152-01
Board Revision : 03
Deviation Number : 0
Fab Version : 01
PCB Serial Number : FOC101430NK
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Version Identifier : NA
CLEI Code : TDB
Product (FRU) Number : NME-AON-K9
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 05 5B 41 01 00 C0 46 03 20 00 6D F8 01
0x10: 42 30 33 88 00 00 00 00 02 01 C1 8B 46 4F 43 31
0x20: 30 31 34 33 30 4E 4B 03 00 81 00 00 00 00 04 00
0x30: 89 4E 41 00 00 D9 02 40 C1 C6 8A 54 44 42 00 00
0x40: 00 00 00 00 00 CB 88 4E 4D 45 2D 52 56 50 4E FF
0x50: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
The table below describes the significant fields shown in the display.
Table 93: show diag subslot Field Descriptions for Cisco 3845 Series Routers
Field Description
Hardware Revision Revision number (signifying a minor revision) of the SPA hardware.
Top Assy. Part Number Part number of the SPA.
Product Identifier (PID) Product number of the SPA.
Board Revision Revision number of the circuit board in the module.
Deviation Number Deviation number of the module.
Fab Version Fabrication version of the module.
Cisco IOS Interface and Hardware Component Command Reference
1324
show controllers serial through show hw-module slot proc cpu
show diag
Field Description
PCB Serial Number Serial number of the printed circuit board.
Top Assy. Revision Revision number (signifying a minor revision) of the SPA.
RMA Test History History of RMA testing.
RMA Number RMA number of the module.
RMA History History of RMA on this module.
Version Identifier Nonapplicable to this module.
CLEI Code Common Language Equipment Identification number. (nonapplicable on this
module)
Product (FRU) Number Product identification number.
EEPROM Format Version Version of EEPROM format.
EEPROM Contents Contents of EEPROM output.
Cisco uBR10012 and ubR7200 Series Broadband Routers
The following is a sample output from the show diag command displaying diagnostic information
for the cable clock card:
router# show diag
Clockcard:
National clock card with T1 controller
EEPROM contents at hardware discovery:
Hardware Revision :1.1
Part Number :800-05867-02
Board Revision :11
Deviation Number :0-0
Fab Version :02
PCB Serial Number :CAB04046NXV
RMA Test History :00
RMA Number :0-0-0-0
RMA History :00
EEPROM format version 4
EEPROM contents (hex):
0x00:04 FF 40 01 AC 41 01 01 C0 46 03 20 00 16 EB 02
0x10:42 31 31 80 00 00 00 00 02 02 C1 8B 43 41 42 30
0x20:34 30 34 36 4E 58 56 03 00 81 00 00 00 00 04 00
The table below describes the fields displayed by the show diag command.
Table 94: show diag Field Descriptions for Cisco uBR10012 and uBR7200 Series Routers
Field Description
National clock card with T1 controller The system has identified the cable clock card.
Cisco IOS Interface and Hardware Component Command Reference
1325
show controllers serial through show hw-module slot proc cpu
show diag
Field Description
EEPROM contents at hardware discovery EEPROM programmed data present when the system identified
the clock card.
Hardware Revision Version number of the card.
Part Number Part number of the card.
Board Revision Revision number (signifying a minor revision) of the card.
Deviation Number Revision number (signifying a minor deviation) of the card.
Fab Version Manufacturing fabrication version number.
PCB Serial Number Serial number of the printed circuit board.
RMA Test History Counter indicating how many times diagnostics have been
performed on this card.
RMA Number Return material authorization number, which is an administrative
number assigned if the card needs to be returned for repair.
RMA History Counter indicating how many times the card has been returned
and repaired.
EEPROM format version Version number of the EEPROM format.
EEPROM contents (hex) Dumps of EEPROM programmed data.
The following is a sample output from the show diag command displaying revision-level information
for the cable line card (slot 6):
Router# show diag
Slot 6:
MC11 port adapter, 1 port
Port adapter is analyzed
Port adapter insertion time 02:37:10 ago
Hardware Revision : 1.2
Part Number : 800-02455-02
Board Revision : 03
Deviation Number : 0-3
Fab Version : 03
PCB Serial Number : 00004500239
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Calibration Data : Minimum: -8 dBmV, Maximum: 8 dBmV
Calibration values : 0x5D43 0x3F05 0x1794
Unknown Field (type 0083): 83 FF FF FF
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 00 F1 41 01 02 C0 46 03 20 00 09 97 02
0x10: 42 30 33 80 00 00 00 03 02 03 C1 8B 30 30 30 30
0x20: 34 35 30 30 32 33 39 03 00 81 00 00 00 00 04 00
0x30: C8 09 F8 08 03 5D 43 3F 05 17 94 83 83 FF FF FF
0x40: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
Cisco IOS Interface and Hardware Component Command Reference
1326
show controllers serial through show hw-module slot proc cpu
show diag
0x50: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
The table below describes the fields displayed by the show diag command for the cable line card
(slot 6).
Table 95: show diag Field Descriptions for Cable Line Card
Field Description
MC11 port adapter Line card type.
Port adapter is analyzed The system has identified the Cisco CMTS port adapter.
Port adapter insertion time Elapsed time since insertion.
Hardware Revision Version number of the Cisco CMTS port adapter.
Part Number In the Cisco CMTS, the part number of the port adapter.
Board Revision Revision number (signifying a minor revision) of the Cisco CMTS port adapter.
Deviation Number Revision number (signifying a minor deviation) of the Cisco CMTS port adapter.
Fab Version Manufacturing fabrication version number.
PCB Serial Number Serial number of the printed circuit board.
RMA Test History Counter indicating how many times diagnostics have been performed on this
port adapter.
RMA Number Return material authorization number, which is an administrative number
assigned if port adapter needs to be returned for repair.
RMA History Counter indicating how many times the port adapter has been returned and
repaired.
Calibration Data Input power calibration range.
Calibration values Upstream port gain calibration constant.
Unknown Field (type) Unrecognized EEPROM fields.
EEPROM format version Version number of the EEPROM format.
EEPROM contents (hex) Dumps of EEPROM programmed data.
Tip In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp
to show commands using the exec prompt timestamp command in line configuration mode.
The following is a sample output displaying information on the Cisco Ethernet SPA:
Router# show diag 1/0
Cisco IOS Interface and Hardware Component Command Reference
1327
show controllers serial through show hw-module slot proc cpu
show diag
SPA Information:
bay 1/0 SPA-5X1GE-V2 ok
SW Version 1.0
Expected Switchover Action: NO INFORMATION
Product Identifier (PID) : SPA-5X1GE-V2
Version Identifier (VID) : V02
PCB Serial Number : JAE1224L5DQ
Top Assy. Part Number : 68-2616-02
Top Assy. Revision : B0
Hardware Revision : 1.2
CLEI Code : CNUIAWYAAA
No Transceiver in slot 1 subslot 0 port 1 .
No Transceiver in slot 1 subslot 0 port 2 .
No Transceiver in slot 1 subslot 0 port 3 .
No Transceiver in slot 1 subslot 0 port 4 .
ETHERNET SPA Information: // Output displaying the additional Ethernet SPA inforamtion//
slot/bay 1/0:
SPA-5X1GE-V2 card, 5 ports
Card is half slot size
Card is analyzed
Card detected 00:10:29 ago
Card uptime: Not Supported
Card idle time: Not Supported
Voltage status:
Nominal 3300mV, Current 3314mV
Nominal 2500mV, Current 2527mV
Nominal 1500mV, Current 1524mV
Nominal 1200mV, Current 1209mV
EERPOM contents, slot/bay 1/0:
Controller Type : 1290
Hardware Revision : 1.2
Boot Timeout : 400 msecs
PCB Serial Number : JAE1224L5DQ
PCB Part Number : 73-10421-02
PCB Revision : B0
Fab Version : 01
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Deviation Number : 0
Product Identifier (PID) : SPA-5X1GE-V2
Version Identifier (VID) : V02
Top Assy. Part Number : 68-2616-02
Top Assy. Revision : B0
IDPROM Format Revision : 36
System Clock Frequency : 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00
CLEI Code : CNUIAWYAAA
Base MAC Address : 00 00 00 00 00 00
MAC Address block size : 0
Manufacturing Test Data : 00 00 00 00 00 00 00 00
Field Diagnostics Data : 00 00 00 00 00 00 00 00
Calibration Data : Minimum: 0 dBmV, Maximum: 0 dBmV
Calibration values :
Power Consumption : 13100 mWatts (Maximum)
Cisco IOS Interface and Hardware Component Command Reference
1328
show controllers serial through show hw-module slot proc cpu
show diag
Environment Monitor Data : 03 30 0C E4 46 32 09 C4
46 32 05 DC 46 32 04 B0
46 32 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 FE 02 F9 9B
Processor Label : 00 00 00 00 00 00 00
Platform features : 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00
Asset ID :
Asset Alias :
SPA Information: //Output displaying the Ethernet SPA summary information.//
bay 1/1 SPA-1X10GE-L-V2 ok
SW Version 1.0
Expected Switchover Action: NO INFORMATION
Product Identifier (PID) : SPA-1X10GE-L-V2
Version Identifier (VID) : V02
PCB Serial Number : JAE1209A3LA
Top Assy. Part Number : 68-2614-02
Top Assy. Revision : B0
Hardware Revision : 1.2
CLEI Code : IPUIA5VRAA
No Transceiver in slot 1 subslot 1 port 0 .
ETHERNET SPA Information: //Output displaying the additional Ethernet SPA information//
slot/bay 1/1:
SPA-1XTENGE-XFP-V2 card, 1 ports
Card is half slot size
Card is analyzed
Card detected 00:10:33 ago
Card uptime: Not Supported
Card idle time: Not Supported
Voltage status:
Nominal 3300mV, Current 3307mV
Nominal 2500mV, Current 2524mV
Nominal 1500mV, Current 1518mV
Nominal 1200mV, Current 1212mV
Nominal 1800mV, Current 1807mV
Nominal 1200mV, Current 1223mV
Nominal 1800mV, Current 1797mV
Nominal 5000mV, Current 4990mV
Nominal -5200mV, Current -5233mV
EERPOM contents, slot/bay 1/1:
Controller Type : 1292
Hardware Revision : 1.2
Boot Timeout : 400 msecs
PCB Serial Number : JAE1209A3LA
PCB Part Number : 73-10419-02
PCB Revision : A0
Fab Version : 02
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Deviation Number : 0
Cisco IOS Interface and Hardware Component Command Reference
1329
show controllers serial through show hw-module slot proc cpu
show diag
Product Identifier (PID) : SPA-1X10GE-L-V2
Version Identifier (VID) : V02
Top Assy. Part Number : 68-2614-02
Top Assy. Revision : B0
IDPROM Format Revision : 36
System Clock Frequency : 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00
CLEI Code : IPUIA5VRAA
Base MAC Address : 00 00 00 00 00 00
MAC Address block size : 0
Manufacturing Test Data : 00 00 00 00 00 00 00 00
Field Diagnostics Data : 00 00 00 00 00 00 00 00
Calibration Data : Minimum: 0 dBmV, Maximum: 0 dBmV
Calibration values :
Power Consumption : 17400 mWatts (Maximum)
Environment Monitor Data : 03 30 0C E4 46 32 09 C4
46 32 05 DC 46 32 04 B0
46 32 07 08 46 32 04 B0
46 32 07 08 46 32 13 88
46 32 EB B0 46 32 00 00
00 00 00 00 00 00 00 00
00 00 FE 02 F4 3B
Processor Label : 00 00 00 00 00 00 00
Platform features : 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00
Asset ID :
Asset Alias :
The following is a sample output displaying the Cisco Wideband SPA information:
Router# show diag 1/0
SPA Information:
bay 1/2 SPA-24XDS-SFP ok
SW Version 1.0
Expected Switchover Action: NO INFORMATION
Product Identifier (PID) : SPA-24XDS-SFP
Version Identifier (VID) : V01
PCB Serial Number : CAT11105RXX
Top Assy. Part Number : 68-2562-03
Top Assy. Revision : B0
Hardware Revision : 1.0
CLEI Code : IPUIA1JRAA
The Transceiver in slot 1 subslot 2 port 0 is ENABLED.
The Transceiver in slot 1 subslot 2 port 1 is ENABLED.
Wideband Information: //Output displaying the Wideband SPA information for slot/bay 1/2//
slot/bay 1/2:
24rfchannel-spa-1 card, 1 port + 1 redundant port
Card is half slot size
Card is analyzed
Card detected 00:07:51 ago
Card uptime: Not Supported
Card idle time: Not Supported
Voltage status: 3.3V (+3.286) NOMINAL 2.5V (+2.490) NOMINAL
1.2V (+1.196) NOMINAL 1.8V (+1.816) FIXED
Cisco IOS Interface and Hardware Component Command Reference
1330
show controllers serial through show hw-module slot proc cpu
show diag
EEPROM contents, slot/bay 1/2:
Controller Type : 1198
Hardware Revision : 1.0
Boot Timeout : 500 msecs
PCB Serial Number : CAT11105RXX
PCB Part Number : 73-9597-03
PCB Revision : A0
Fab Version : 03
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Deviation Number : 90114
Product Identifier (PID) : SPA-24XDS-SFP
Version Identifier (VID) : V01
Top Assy. Part Number : 68-2562-03
Top Assy. Revision : B0
IDPROM Format Revision : 36
System Clock Frequency : 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00
CLEI Code : IPUIA1JRAA
Base MAC Address : 00 1A A1 32 79 72
MAC Address block size : 1
Manufacturing Test Data : 00 00 00 00 00 00 00 00
Field Diagnostics Data : 00 00 00 00 00 00 00 00
Calibration Data : Minimum: 0 dBmV, Maximum: 0 dBmV
Calibration values :
Power Consumption : 14000 mWatts (Maximum)
Environment Monitor Data : 03 30 0C E4 46 32 09 C4
46 32 00 00 00 00 04 B0
46 32 00 00 00 00 07 08
46 32 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 FE 02 FA 6D
Processor Label : 00 00 00 00 00 00 00
Platform features : 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00
Asset ID :
Asset Alias :
The following is a sample output from the show diag command for a Cisco uBR10-MC5X20H
cable line card on a Cisco uBR10012 router using Cisco IOS Release 12.2(33)SCG:
Router# show diag 6/0
Slot/Subslot 6/0:
5cable-mc520h-d card, 5 ports
Card is half slot size
Card is analyzed
Card detected 00:01:18 ago
Card uptime 0 days, 0 hours, 1 minutes, 42 seconds
Card idle time N/A
Voltage status: 5V Nominal 3.3V Nominal 2.5V Nominal EEPROM contents,
slot 6/0:
Controller Type : 1159
Cisco IOS Interface and Hardware Component Command Reference
1331
show controllers serial through show hw-module slot proc cpu
show diag
Hardware Revision : 5.0
Top Assy. Part Number : 800-25212-05
Board Revision : B0
Product Identifier (PID) : UBR10-MC5X20H-D
CLEI Code : IPUCAHEBAA
Deviation Number : 0
Fab Version : 05
PCB Serial Number : CAT10505HA9
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Version Identifier (VID) : V01
LCMON version, slot 6/0
IOS (tm) 7200 Software (UBR10KCLC-LC-M), Experimental Version
12.3(20060207:230254) [xxxxx-after_520h 103]
Compiled Thu 09-Feb-06 11:59 by xxxxx
Reset due to: power-on
Operational Image version, slot 6/0
Cisco IOS Software, 10000 Software (UBR10KCLC-LCK8-M), Version 12.2(32.9.8)SCG,
EXPERIMENTAL IMAGE ENGINEERING C10K_WEEKLY BUILD, synced to V122_32_8_SCG
Compiled Mon 02-Jul-12 17:20 by xxxxx
SW Version 1.0
Code MD5 D41D8CD98F00B204E9800998ECF8427E
FPGA MD5 00000000000000000000000000000000
Expected Switchover Action: NO INFORMATION
The table below describes the significant fields shown in the display.
Table 96: show diag Field Descriptions for Cable Line Card
Field Description
Hardware Revision Version number of the card.
Top Assy. Part Number Part number of the port adapter.
Board Revision Revision number (signifying a minor revision) of the Cisco CMTS
port adapter.
CLEI Code Common language equipment identifier codes that are used by
Telcordia licenses to uniquely identify the telecommunication
equipment in their network.
Deviation Number Revision number (signifying a minor deviation) of the Cisco CMTS
port adapter.
Fab Version Manufacturing fabrication version number.
PCB Serial Number Serial number of the printed circuit board.
RMA Test History Counter indicating how many times diagnostics have been performed
on this port adapter.
RMA Number Return material authorization number, which is an administrative
number assigned if port adapter needs to be returned for repair.
Cisco IOS Interface and Hardware Component Command Reference
1332
show controllers serial through show hw-module slot proc cpu
show diag
Field Description
RMA History Counter indicating how many times the port adapter has been returned
and repaired.
Cisco uBR7225VXR and Cisco uBR7246VXR Universal Broadband Routers: Example
The following is a sample output from the show diag command for a Cisco uBR-MC88V cable
interface line card, on a Cisco uBR7246VXR universal broadband router. The output shows that the
diagnostic mode on the line card is enabled.
Router# show diag5
Slot 5:
DOCSIS Modem Card (Universal) 8 Down/8 Up (F-connector) with
Integrated Up-converter Port adapter, 2 ports
Port adapter is analyzed
Port adapter insertion time 3w1d ago
EEPROM contents at hardware discovery:
Controller Type : 1653
PCB Serial Number : CSJ12514210
Hardware Revision : 6.5
Top Assy. Part Number : 800-17733-09
Top Assy. Revision : A0
Product Identifier (PID) : UBR-MC88V
Version Identifier (VID) : V04
CLEI Code : IPUIA5XRAA
Deviation Number : 0
Fab Version : 06
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Licensing Transaction ID : 8
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 06 75 C1 8B 43 53 4A 31 32 35 31 34 32
0x10: 31 30 41 06 05 C0 46 03 20 00 45 45 09 8D 41 30
0x20: 20 20 CB 89 55 42 52 2D 4D 43 38 38 55 89 56 30
0x30: 34 20 C6 8A 49 50 55 49 41 35 58 52 41 41 88 00
0x40: 00 00 00 02 06 03 00 81 00 00 00 00 04 00 8B 00
0x50: 00 00 08 D9 03 40 C1 CB FF FF FF FF FF FF FF FF
0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x80: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x90: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xA0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xB0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xC0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xD0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xE0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0xF0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
License : 8X8
Calibration Data
Cisco IOS Interface and Hardware Component Command Reference
1333
show controllers serial through show hw-module slot proc cpu
show diag
Number of US points: 8
Number of freqs : 3
measured gain
US freq(kHz) 0db 1db 2db 4db 8db
16db
0 5000 34.8876 33.8322 32.7126 30.6040 26.4336
18.4096
1 5000 34.8876 33.9016 32.7126 30.6342 26.6766
18.4096
2 5000 35.3706 34.3750 33.3282 31.3718 27.2786
19.0466
3 5000 35.3706 34.3750 33.3282 31.3626 27.1574
19.0466
4 5000 35.7702 34.8876 33.8322 31.3902 27.3962
19.3112
5 5000 35.3706 34.3750 33.3282 31.3532 26.9278
18.7344
6 5000 35.8262 34.8876 33.8322 31.3992 27.5134
19.3112
7 5000 34.8876 33.8322 32.7126 30.6242 26.5632
18.4096
measured gain
US freq(kHz) 0db 1db 2db 4db 8db
16db
0 30000 32.1330 31.3626 30.5834 28.2632 24.0922
15.8262
1 30000 32.7126 31.3992 30.6142 28.5760 24.4296
16.2078
2 30000 33.3282 32.0502 31.3532 29.1476 24.9126
16.6738
3 30000 33.3282 32.0502 31.3436 29.0630 24.8932
16.6240
4 30000 33.3282 32.0502 31.3532 29.2424 25.0476
17.0212
5 30000 32.7126 32.0502 30.6440 28.8658 24.5942
16.6240
6 30000 33.3282 32.7126 31.3718 29.4198 25.2018
17.0212
7 30000 32.7126 31.3810 30.6040 28.4732 24.2630
16.2078
measured gain
US freq(kHz) 0db 1db 2db 4db 8db
16db
0 65000 29.8170 29.0630 28.0608 26.0302 21.8206
13.8322
1 65000 30.6142 29.6032 28.5760 26.5632 22.2546
13.9016
2 65000 31.3532 29.8276 29.1596 27.1574 22.8458
14.8876
3 65000 31.3340 29.8062 28.9646 26.9278 22.6460
14.3750
4 65000 31.3532 29.8170 29.1476 27.0630 22.8458
14.8876
5 65000 30.6342 29.7842 28.7668 26.6926 22.4660
14.3750
6 65000 31.3718 30.5938 29.4198 27.2936 23.0430
14.8876
7 65000 30.6142 29.5240 28.5632 26.4336 22.2546
13.9016
The table below describes significant fields shown in the display.
Cisco IOS Interface and Hardware Component Command Reference
1334
show controllers serial through show hw-module slot proc cpu
show diag
Table 97: show diag Field Descriptions for Cisco uBR7225VXR and Cisco uBR7246VXR Series Routers
Field Description
Controller Type Line card type.
PCB Serial Number Serial number of the printed circuit board.
Hardware Revision Version number of the port adapter.
Top Assy. Part Number Part number of the port adapter.
Top Assy. Revision Revision number (signifying a minor revision) of the port adapter.
Product Identifier (PID) Cisco product ID.
Version Identifier (VID) Used to track the version of the customer orderable PID.
CLEI Code Common language equipment identifier codes that are used by Telcordia licenses
to uniquely identify the telecommunication equipment in their network.
Deviation Number Revision number (signifying a minor deviation) of the port adapter.
Fab Version Version number (signifying a major version) of the port adapter.
RMA Test History Counter indicating the number of times the port adapter has been returned and
repaired.
RMA Number Return material authorization number. An administrative number assigned when
the port adapter is returned for repair.
RMA History Counter indicating the number of times the port adapter has been returned and
repaired.
Licensing Transaction ID License transaction identifier.
EEPROM contents (hex) Dumps of EEPROM programmed data.
License License type.
Calibration Data Calibration data of upstream VGA chips.
Number of US points Number of physical upstream channels supported by the port adapter.
Number of freqs Number of upstream frequencies used in the upstream calibration process (5, 30,
and 65 MHz).
Cisco ASR 1000 Series Aggregation Services Routers: Example
The following is a sample output from the show diag command for a Cisco ASR 1000 Series Router.
Router# show diag all eeprom
MIDPLANE EEPROM data:
Cisco IOS Interface and Hardware Component Command Reference
1335
show controllers serial through show hw-module slot proc cpu
show diag
Product Identifier (PID) : ASR1006
Version Identifier (VID) : V01
PCB Serial Number : NWG122200GZ
Top Assy. Part Number : 68-2584-05
Hardware Revision : 1.0
Asset ID :
CLEI Code : COMUD00ARA
Power/Fan Module P0 EEPROM data:
Product Identifier (PID) : ASR1006-PWR-AC
Version Identifier (VID) : V01
PCB Serial Number : ART1226Q00L
Hardware Revision : 3.0
Asset ID :
CLEI Code : COUPACBBAA
Power/Fan Module P1 EEPROM data:
Product Identifier (PID) : ASR1006-PWR-AC
Version Identifier (VID) : V01
PCB Serial Number : ART1226Q00Q
Hardware Revision : 3.0
Asset ID :
CLEI Code : COUPACBBAA
Slot R0 EEPROM data:
Product Identifier (PID) : ASR1000-RP1
Version Identifier (VID) : V03
PCB Serial Number : JAE12056VBZ
Top Assy. Part Number : 68-2625-08
Hardware Revision : 1.0
CLEI Code : COUCAENCAC
Slot R1 EEPROM data:
Product Identifier (PID) : ASR1000-RP1
Version Identifier (VID) : V03
PCB Serial Number : JAE1225MQIY
Top Assy. Part Number : 68-2625-08
Hardware Revision : 1.0
CLEI Code : COUCAENCAC
Slot F0 EEPROM data:
Product Identifier (PID) : ASR1000-ESP10
Version Identifier (VID) : V03
PCB Serial Number : JAE1228OBVV
Top Assy. Part Number : 68-2633-10
Hardware Revision : 1.1
CLEI Code : COUCAERCAC
Slot F1 EEPROM data:
Product Identifier (PID) : ASR1000-ESP10
Version Identifier (VID) : V03
PCB Serial Number : JAE1227NNN1
Top Assy. Part Number : 68-2633-10
Hardware Revision : 1.1
CLEI Code : COUCAERCAC
Slot 0 EEPROM data:
Product Identifier (PID) : ASR1000-SIP10
Version Identifier (VID) : V03
PCB Serial Number : JAE1224L050
Top Assy. Part Number : 68-2629-07
Hardware Revision : 1.0
CLEI Code : COUCAEPCAC
Cisco IOS Interface and Hardware Component Command Reference
1336
show controllers serial through show hw-module slot proc cpu
show diag
Slot 1 EEPROM data is not initialized
Slot 2 EEPROM data is not initialized
SPA EEPROM data for subslot 0/0:
Product Identifier (PID) : SPA-2X1GE-V2
Version Identifier (VID) : V01
PCB Serial Number : JAE1227NK77
Top Assy. Part Number : 68-2707-02
Top Assy. Revision : B0
Hardware Revision : 1.0
CLEI Code : CNUIANBAAA
SPA EEPROM data for subslot 0/1:
Product Identifier (PID) : SPA-2XOC3-POS
Version Identifier (VID) : V01
PCB Serial Number : JAE1225M5AO
Top Assy. Part Number : 68-2168-01
Top Assy. Revision : J0
Hardware Revision : 1.0
CLEI Code : IPUIAFMRAA
SPA EEPROM data for subslot 0/2 is not available
SPA EEPROM data for subslot 0/3 is not available
SPA EEPROM data for subslot 1/0 is not available
SPA EEPROM data for subslot 1/1 is not available
SPA EEPROM data for subslot 1/2 is not available
SPA EEPROM data for subslot 1/3 is not available
SPA EEPROM data for subslot 2/0 is not available
SPA EEPROM data for subslot 2/1 is not available
SPA EEPROM data for subslot 2/2 is not available
SPA EEPROM data for subslot 2/3 is not available
The table below describes significant fields shown in the display.
Table 98: show diag Field Descriptions for Cisco ASR 1000 Series Routers
Field Description
Asset ID Power or fan module identifier.
CLEI Code Common language equipment identifier codes that are used by licensees to uniquely
identify the telecommunication equipment in their network.
Hardware Revision Version number of the port adapter.
PCB Serial Number Serial number of the printed circuit board.
Product Identifier (PID) Cisco product ID.
Top Assy. Part Number Part number of the port adapter.
Top Assy. Revision Revision number (signifying a minor revision) of the port adapter.
Version Identifier (VID) Used to track the version of the customer orderable PID.
Cisco IOS Interface and Hardware Component Command Reference
1337
show controllers serial through show hw-module slot proc cpu
show diag
Cisco 4400 Series Integrated Services Router: Example
The following is a sample output fromshow diag all eeprom detail for Cisco 4400 Series Integrated
Services Router.
Router# show diag all eeprom detail
MIDPLANE EEPROM data:
EEPROM version : 4
Compatible Type : 0xFF
PCB Serial Number : FOC15520B7L
Controller Type : 1902
Hardware Revision : 1.0
PCB Part Number : 73-13854-02
Top Assy. Part Number : 800-36894-01
Board Revision : 05
Deviation Number : 123968
Fab Version : 02
Product Identifier (PID) : ISR4451/K9
Version Identifier (VID) : V01
CLEI Code : TDBTDBTDBT
Processor type : D0
Chassis Serial Number : FGL1601129D
Chassis MAC Address : 30f7.0d53.c7e0
MAC Address block size : 144
Manufacturing Test Data : 00 00 00 00 00 00 00 00
Asset ID : P1B-R2C
Power/Fan Module P0 EEPROM data:
EEPROM version 4:
Compatible Type :
0xFF
Controller Type :
1509
Unknown Field (type 00DF):
1.85.1.236.1
Deviation Number 0:
PCB Serial Number :
DCA1547X037
RMA Test History :
00
RMA Number :
0-0-0-0
RMA History :
00
Version Identifier (VID) :
XXX
Product Identifier (PID) :
XXX-XXXX-XX
CLEI Code :
0000000000
Environment Monitor Data :
41 01 C2 42 00 05 F8 00
50 01 F4 1B 58 03 E8 1F
4A 05 DC 21 34 07 D0 21
FC 09 C4 22 60 0B B8 22
92 0D AC 22 D8 0F A0 22
F8 11 94 22 F6 13 88 23
3C 15 7C 23 28 17 70 23
00 19 64 22 D8 1B 58 22
C4 1D 4C 22 BA 1F 40 22
A6 21 34 22 9C 23 28 22
92 25 1C 22 88 27 10 22
60
Board Revision : P0
Power/Fan Module P1 EEPROM data is not initialized
Power/Fan Module P2 EEPROM data is not initialized
Slot R0 EEPROM data:
EEPROM version : 4
Compatible Type : 0xFF
Cisco IOS Interface and Hardware Component Command Reference
1338
show controllers serial through show hw-module slot proc cpu
show diag
PCB Serial Number : FOC15520B7L
Controller Type : 1902
Hardware Revision : 1.0
PCB Part Number : 73-13854-02
Top Assy. Part Number : 800-36894-01
Board Revision : 05
Deviation Number : 123968
Fab Version : 02
Product Identifier (PID) : ISR4451/K9
Version Identifier (VID) : V01
CLEI Code : TDBTDBTDBT
Processor type : D0
Chassis Serial Number : FGL1601129D
Chassis MAC Address : 30f7.0d53.c7e0
MAC Address block size : 144
Manufacturing Test Data : 00 00 00 00 00 00 00 00
Asset ID : P1B-R2C
Asset ID :
Slot F0 EEPROM data:
EEPROM version : 4
Compatible Type : 0xFF
Controller Type : 3567
Hardware Revision : 4.1
PCB Part Number : 73-12387-01
MAC Address block size : 15
Chassis MAC Address : aabb.ccdd.eeff
Product Identifier (PID) : ISR4451-FP
Version Identifier (VID) : V00
PCB Serial Number : FP123456789
Asset ID :
Slot 0 EEPROM data:
EEPROM version : 4
Compatible Type : 0xFF
Controller Type : 1612
Hardware Revision : 4.1
PCB Part Number : 73-12387-01
MAC Address block size : 15
Chassis MAC Address : aabb.ccdd.eeff
Product Identifier (PID) : ISR4451-NGSM
Version Identifier (VID) : V00
PCB Serial Number : NGSM1234567
Asset ID :
Slot 1 EEPROM data:
EEPROM version : 4
Compatible Type : 0xFF
Controller Type : 1612
Hardware Revision : 4.1
PCB Part Number : 73-12387-01
MAC Address block size : 15
Chassis MAC Address : aabb.ccdd.eeff
Product Identifier (PID) : ISR4451-NGSM
Version Identifier (VID) : V00
PCB Serial Number : NGSM1234567
Asset ID :
Slot 2 EEPROM data:
EEPROM version : 4
Compatible Type : 0xFF
Controller Type : 1612
Hardware Revision : 4.1
PCB Part Number : 73-12387-01
Cisco IOS Interface and Hardware Component Command Reference
1339
show controllers serial through show hw-module slot proc cpu
show diag
MAC Address block size : 15
Chassis MAC Address : aabb.ccdd.eeff
Product Identifier (PID) : ISR4451-NGSM
Version Identifier (VID) : V00
PCB Serial Number : NGSM1234567
Asset ID :
SPA EEPROM data for subslot 0/0:
EEPROM version : 5
Compatible Type : 0xFF
Controller Type : 1902
Hardware Revision : 2.2
Boot Timeout : 400 msecs
PCB Serial Number : JAB092709EL
PCB Part Number : 73-8700-01
PCB Revision : A0
Fab Version : 01
RMA Test History : 00
RMA Number : 0-0-0-0
RMA History : 00
Deviation Number : 78409
Product Identifier (PID) : ISR4451-4X1GE
Version Identifier (VID) : V01
Top Assy. Part Number : 68-2236-01
Top Assy. Revision : A0
IDPROM Format Revision : 36
System Clock Frequency : 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00
CLEI Code : CNUIAHSAAA
Base MAC Address : 00 00 00 00 00 00
MAC Address block size: 0
Manufacturing Test Data
: 00 00 00 00 00 00 00 00
Field Diagnostics Data: 00 00 00 00 00 00 00 00
Calibration Data : Minimum: 0 dBmV, Maximum: 0 dBmV
Calibration values
:
Power Consumption : 13100 mWatts (Maximum)
Environment Monitor Data
: 03 30 0C E4 46 32 09 C4
46 32 05 DC 46 32 05 DC
46 32 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 FE 02 F9 6E
Processor Label : 00 00 00 00 00 00 00
Platform features : 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00
00 00 00 00 00 00 00
Asset ID :
Asset Alias :
SPA EEPROM data for subslot 0/1 is not available
SPA EEPROM data for subslot 0/2 is not available
SPA EEPROM data for subslot 0/3 is not available
SPA EEPROM data for subslot 0/4 is not available
SPA EEPROM data for subslot 1/0 is not available
SPA EEPROM data for subslot 1/1 is not available
SPA EEPROM data for subslot 1/2 is not available
Cisco IOS Interface and Hardware Component Command Reference
1340
show controllers serial through show hw-module slot proc cpu
show diag
SPA EEPROM data for subslot 1/3 is not available
SPA EEPROM data for subslot 1/4 is not available
SPA EEPROM data for subslot 2/0 is not available
SPA EEPROM data for subslot 2/1 is not available
SPA EEPROM data for subslot 2/2 is not available
SPA EEPROM data for subslot 2/3 is not available
SPA EEPROM data for subslot 2/4 is not available
Related Commands Command Description
dsl operating-mode (ADSL) Modifies the operating mode of the
digital subscriber line for an ATM
interface.
show c7300 Displays the types of hardware
(processors, line cards, jacket cards,
and so on) installed in the Cisco 7304
router slots, including the bundled
Flash, and current FPGA versions.
show c7300 errorlog Displays error information on a Cisco
7304 router.
show dsl interface atm Shows all ADSL-specific information
for a specified ATM interface.
showcontrollers fastethernet Displays Fast Ethernet interface
information, transmission statistics and
errors, and applicable MAC destination
address and VLAN filtering tables.
show controllers gigabitethernet Displays Gigabit Ethernet interface
information, transmission statistics and
errors, and applicable MAC destination
address and VLAN filtering tables.
show controllers integrated-service-engine Displays controller information for
integrated-service-engine network
modules.
showinterfaces integrated-service-engine Displays basic interface configuration
information for
integrated-service-engine network
modules.
Cisco IOS Interface and Hardware Component Command Reference
1341
show controllers serial through show hw-module slot proc cpu
show diagnostic bootup level
show diagnostic bootup level
To display the coverage level for the configured bootup diagnostics, use the
showdiagnosticbootuplevelcommand in user EXEC or privileged EXEC mode.
show diagnostic bootup level
Syntax Description This command has no arguments or keywords.
Command Default This command has no default settings.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
12.2(14)SX This command was introduced for the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command displays the bootup diagnostic level configured on the switch. The bootup diagnostic level
determines which diagnostic tests will be performed when the device boots. The following bootup diagnostic
levels can be displayed in the output of this command:
Level Explanation
Bypass The device performs no bootup diagnostic tests.
Complete The device performs all diagnostic tests marked with attribute M (Minimal) or C (Complete) in
the output of the showdiagnosticcontentmodule command.
Minimal The device performs all diagnostic tests marked with attribute M (Minimal) in the output of the
showdiagnosticcontentmodule command.
Examples This example shows how to display the configured bootup diagnostic level:
Router# show diagnostic bootup level
Current Bootup Diagnostic Level = Complete
Related Commands Command Description
diagnostic bootup level Sets the bootup diagnostic level.
show diagnostic content module Displays the available diagnostic tests.
Cisco IOS Interface and Hardware Component Command Reference
1342
show controllers serial through show hw-module slot proc cpu
show diagnostic content module
show diagnostic content module
To display information about available tests, including test ID, test attributes, and supported coverage test
levels for each test and for all modules, use the showdiagnosticcontentmodulecommand in user EXEC or
privileged EXEC mode.
show diagnostic content module {alllistslot|slot/subslot}
Syntax Description all Displays information about available tests for all modules.
list List of modules in the following format:
• Entries are separated by a comma, for example, 1,4,6-10.
• Ranges are specified with a hyphen, for example, 1-4,6-10.
slot Single module by slot number.
slot / subslot Single submodule by slot number and subslot or bay within the module.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
12.2(14)SX This command was introduced for the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SXI4 This command was integrated into Cisco IOS Release 12.2(33)SXI4. A health-monitoring
(HM) test, TestAclFpgaMonitor, was introduced for ABA cards.
Usage Guidelines For each available diagnostic test, a set of attributes is displayed as a series of characters in the Attributes
field of the command output. An asterisk (*) in the character location indicates that the attribute is not applicable
to the test. The following set of attributes is displayed:
Character Attribute Description
1 M The test runs when the bootup diagnostic level is set to either Minimal or Complete.
C The test runs when the bootup diagnostic level is set to Complete.
2 B The test runs when the diagnosticstartplatformtestbasic command is entered.
3 P The test runs on a port, not the entire device (per-port test).
V The test runs on the entire device (per-device test).
Cisco IOS Interface and Hardware Component Command Reference
1343
show controllers serial through show hw-module slot proc cpu
show diagnostic content module
Character Attribute Description
4 D The test disrupts the network traffic (disruptive test).
N The test can be run when the system is online without disrupting the network traffic
(nondisruptive test).
5 S If the card under test is a standby card, only the standby card runs the test. The test
does not run from the active card. If the card under test is an active card, the active
card runs the test on itself.
6 X The test is not an HM test.
7 F The monitoring interval of the test cannot be modified by the user (fixed monitoring
test).
8 E The user cannot disable the test (always enabled test).
9 A Monitoring is active for this test.
I Monitoring is inactive for this test.
10 R The test cycles power to the line cards and reloads the supervisor engine.
11 K The test resets the line card after completion.
12 T The test shuts down all ports and reloads the supervisor engine.
If a test is configured to run periodically, the interval will be displayed in the Test Interval field of the command
output in the format ddd hh:mm:ss.ms, indicating days, hours, minutes, seconds, and milliseconds. For example,
the test interval of a test that will run every 15 minutes will be displayed as 000 00:15:00.00. The test interval
of a test that will run every 14 days will be displayed as 014 00:00:00.00.
If a test failure is determined by multiple errors rather than a single error, the error threshold will be displayed
in the Threshold field of the command output.
You can use the showdiagnosticdescriptionmodulecommand to see a detailed description of a diagnostic
test.
Examples The following example shows how to display the test suite, the monitoring interval, and test attributes
for module 5:
Router# show diagnostic content module 5
Module 5: Supervisor Engine 2T 10GE w/ CTS (Active)
Diagnostics test suite attributes:
M/C/* - Minimal bootup level test / Complete bootup level test / NA
B/* - Basic ondemand test / NA
P/V/* - Per port test / Per device test / NA
D/N/* - Disruptive test / Non-disruptive test / NA
S/* - Only applicable to standby unit / NA
X/* - Not a health monitoring test / NA
F/* - Fixed monitoring interval test / NA
E/* - Always enabled monitoring test / NA
A/I - Monitoring is active / Monitoring is inactive
R/* - Power-down line cards and need reload supervisor / NA
K/* - Require resetting the line card after the test has completed / NA
Cisco IOS Interface and Hardware Component Command Reference
1344
show controllers serial through show hw-module slot proc cpu
show diagnostic content module
T/* - Shut down all ports and need reload supervisor / NA
Test Interval Thre-
ID Test Name Attributes day hh:mm:ss.ms shold
==== ================================== ============ =============== =====
1) TestScratchRegister -------------> ***N****A*** 000 00:00:30.00 5
2) TestSPRPInbandPing --------------> ***N****A*** 000 00:00:15.00 10
3) TestTransceiverIntegrity --------> **PD****I*** not configured n/a
4) TestActiveToStandbyLoopback -----> M*PDSX**I*** not configured n/a
5) TestLoopback --------------------> M*PD*X**I*** not configured n/a
6) TestTxPathMonitoring ------------> M**N****A*** 000 00:00:02.00 10
7) TestNewIndexLearn ---------------> M**N****I*** 000 00:00:15.00 10
8) TestDontConditionalLearn --------> M**N****I*** 000 00:00:15.00 10
9) TestBadBpduTrap -----------------> M**D*X**I*** not configured n/a
10) TestMatchCapture ----------------> M**D*X**I*** not configured n/a
11) TestProtocolMatchChannel --------> M**D*X**I*** not configured n/a
12) TestFibDevices ------------------> M**N****I*** 000 00:00:15.00 10
13) TestIPv4FibShortcut -------------> M**N****I*** 000 00:00:15.00 10
14) TestL3Capture2 ------------------> M**D*X**I*** not configured n/a
15) TestIPv6FibShortcut -------------> M**N****I*** 000 00:00:15.00 10
16) TestMPLSFibShortcut -------------> M**N****I*** 000 00:00:15.00 10
17) TestNATFibShortcut --------------> M**N****I*** 000 00:00:15.00 10
18) TestAclPermit -------------------> M**D*X**I*** not configured n/a
19) TestAclDeny ---------------------> M**D*X**I*** not configured n/a
20) TestQoSTcam ---------------------> M**D*X**I*** not configured n/a
21) TestL3VlanMet -------------------> M**D*X**I*** not configured n/a
22) TestIngressSpan -----------------> M**D*X**I*** not configured n/a
23) TestEgressSpan ------------------> M**D*X**I*** not configured n/a
24) TestNetflowInlineRewrite --------> C*PD*X**I*** not configured n/a
25) TestTrafficStress ---------------> ***D*X**I**T not configured n/a
26) TestFibTcamSSRAM ----------------> ***D*X**IR** not configured n/a
27) TestAsicMemory ------------------> ***D*X**IR** not configured n/a
28) TestAclQosTcam ------------------> ***D*X**IR** not configured n/a
29) TestNetflowTcam -----------------> ***D*X**IR** not configured n/a
30) ScheduleSwitchover --------------> ***D*X**I*** not configured n/a
31) TestFirmwareDiagStatus ----------> M**N****I*** 000 00:00:15.00 10
32) TestAsicSync --------------------> ***N****A*** 000 00:00:15.00 10
33) TestUnusedPortLoopback ----------> **PN****A*** 000 00:01:00.00 10
34) TestErrorCounterMonitor ---------> ***N****A*** 000 00:00:30.00 10
35) TestPortTxMonitoring ------------> **PN****A*** 000 00:01:15.00 5
36) TestL3HealthMonitoring ----------> ***N**FEA*** 000 00:00:05.00 10
37) TestCFRW ------------------------> M*VN*X**I*** not configured n/a
38) TestRwEngineOverSubscription ----> ***N****I*** 000 00:00:01.00 10
39) TestAclFpgaMonitor --------------> ***N****A*** 000 00:00:00.80 1
40) TestNVRAMBatteryMonitor ---------> ***N**F*A*** 000 01:00:00.00 72
Note The HM test, TestAclFpgaMonitor, is applicable only for Aphrodite, Berytos, and Anteros (ABA)
cards. This test is run to monitor the access control list (ACL) ternary content addressable memory
(TCAM) reply status.
Note The HM test TestNVRAMBatteryMonitor monitors the NVRAM battery status and is applicable
only to the Supervisor Engine 2T.
The table below describes the significant fields shown in the display.
Cisco IOS Interface and Hardware Component Command Reference
1345
show controllers serial through show hw-module slot proc cpu
show diagnostic content module
Table 99: show diagnostic content module Field Descriptions
Field Description
ID Unique identifier of the diagnostic test.
Test Name Name of the diagnostic test.
Attributes Health state of the diagnostic.
Test Interval Periodic interval at which the test is run.
Threshold Maximum number of consecutive test failures required by the diagnostic test to take recovery
action.
Related Commands Command Description
diagnostic bootup level Sets the bootup diagnostic level.
diagnostic monitor Configures the HM diagnostic testing.
diagnostic ondemand Configures the on-demand diagnostics.
diagnostic schedule test Sets the scheduling of test-based diagnostic testing for a specific
module or schedules a supervisor engine switchover.
show diagnostic description module Describes the diagnostic tests.
Cisco IOS Interface and Hardware Component Command Reference
1346
show controllers serial through show hw-module slot proc cpu
show diagnostic cns
show diagnostic cns
To display the information about the CNS subject, use the show diagnostic cns command in user EXEC or
privileged EXEC mode.
show diagnostic cns {publish|subscribe}
Syntax Description publish Displays the subject with which the diagnostic results is published.
subscribe Displays the subscribed subjects.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.
The CNS subsystem communicates with remote network applications through the CNS-event agent and
follows the publish and subscribe model. An application sets itself up to receive events by subscribing to the
approprate event subject name.
Examples This example shows how to display the subject with which the diagnostic results is published:
Router# show diagnostic cns publish
Subject: cisco.cns.device.diag_results
This example shows how to display the subscribed subject:
Router# show diagnostic cns subscribe
Subject: cisco.cns.device.diag_get_results
Related Commands Command Description
diagnostic cns Configures the CNS diagnostics.
Cisco IOS Interface and Hardware Component Command Reference
1347
show controllers serial through show hw-module slot proc cpu
show diagnostic description module
show diagnostic description module
To display a detailed description of a diagnostic test available on a module, use the
showdiagnosticdescriptionmodulecommand in user EXEC or privileged EXEC mode.
show diagnostic description module {slot|slot/subslot} test {all|test-id|test-name}
Syntax Description slot Specifies a module by slot number.
slot/subslot Specifies a submodule by slot number and subslot or bay within the module.
all Displays descriptions of all available tests.
test-id Test identification number. See the Usage Guidelines for a list of tests.
test-name Test name. See the Usage Guidelines for a list of tests.
Command Default This command has no default settings.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
12.2(14)SX This command was introduced for the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines You can display detailed descriptions of diagnostic tests by specifying the test ID, the test name, or the
allkeyword in this command. The test ID and test name for available diagnostic tests are displayed in the
output of the showdiagnosticcontentmodulecommand.
Examples This example shows how to display the description of TestIPv6FibShortcut on module 1:
Router# show diagnostic description module 1 test TestIPv6FibShortcut
TestIPv6FibShortcut :
This test verifies the IPv6 FIB forwarding of the layer 3 forwarding
engine. One diagnostic IPv6 FIB and an adjacency entry are installed
and a diagnostic IPv6 packet is sent to make sure it is forwarded
accordingly based on rewritten MAC and VLAN information.
This example shows how to display the description of test number 15 on module 1:
Router# show diagnostic description module 1 test 15
TestIPv6FibShortcut :
This test verifies the IPv6 FIB forwarding of the layer 3 forwarding
engine. One diagnostic IPv6 FIB and an adjacency entry are installed
and a diagnostic IPv6 packet is sent to make sure it is forwarded
accordingly based on rewritten MAC and VLAN information.
Cisco IOS Interface and Hardware Component Command Reference
1348
show controllers serial through show hw-module slot proc cpu
show diagnostic description module
Related Commands Command Description
show diagnostic content module Displays the available diagnostic tests.
Cisco IOS Interface and Hardware Component Command Reference
1349
show controllers serial through show hw-module slot proc cpu
show diagnostic events
show diagnostic events
To display the diagnostic event log, use the showdiagnosticeventscommand in user EXEC or privileged
EXEC mode.
show diagnostic events [{event-type event-type|module {allslotslot/subslot}}]
Cisco ASR 1000 Series Aggregation Services Routers
show diagnostic events [{event-type event-type|slot {number|all}}]
Syntax Description event-type event-type (Optional) Displays events of a specified type, where event-type values are error,
info, and warning.
module (Optional) Displays the event log for a module, where:
• all --Displays the event log for all modules.
• slot --Chassis slot location of the module.
• slot / subslot --Subslot or bay location of the submodule.
slot {number | all} (Optional--Cisco ASR 1000 Series Routers) Displays the event log for the
specified hardware slots, where:
• number --Chassis slot location of the hardware, such as R0 for route
processor 0.
• all --Displays the event log for hardware in all supported slots.
Command Default When no optional keywords are specified, the showdiagnosticevents command displays all events for all
hardware module or slot locations.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
12.2(14)SX This command was introduced for the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release
12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Cisco IOS XE Release 2.6 This command was integrated into Cisco IOS XE Release 2.6.
Usage Guidelines If you do not enter a module keyword and argument for the showdiagnosticevents command, the event log
for all modules is displayed.
On the Cisco ASR 1000 Series Aggregation Services Routers, if no optional keywords are entered, the event
log for all supported slots is displayed.
Cisco IOS Interface and Hardware Component Command Reference
1350
show controllers serial through show hw-module slot proc cpu
show diagnostic events
The following fields are displayed in the command output:
Field Description
Time Stamp Date and time of the diagnostic event, in the format MM:DD hh:mm:ss.mss.
ET Type of event (I=Info, W=Warning, E=Error).
Card Module associated with the event.
Event Message Event description.
Examples The following example shows how to display the diagnostic event log for events of type Info:
Router# show diagnostic events event-type info
Diagnostic events (storage for 500 events, 14 events recorded)
Number of events matching above criteria = 10
Event Type (ET):I - Info, W - Warning, E - Error
Time Stamp ET [Card] Event Message
------------------ -- --------------------------------------------------------
08/26 15:51:04.335 I [1] TestIndexLearn Passed
08/26 15:51:04.335 I [1] Diagnostics Passed
08/26 15:51:15.511 I [8] TestLoopback Passed
08/26 15:51:15.511 I [8] Diagnostics Passed
08/26 16:15:02.247 I [1] TestDontLearn Passed
08/26 16:15:02.247 I [1] Diagnostics Passed
08/26 16:15:12.683 I [8] TestNetflowInlineRewrite Passed
08/26 16:15:12.683 I [8] Diagnostics Passed
08/26 16:15:42.207 I [2] TestActiveToStandbyLoopback Passed
08/26 16:15:42.207 I [2] Diagnostics Passed
The following example shows the results of all events for the predefined TestErrorCounterMonitor
test on route processor 0 on a Cisco ASR 1000 Aggregation Services Router:
Router# show diagnostic events slot R0
Diagnostic events (storage for 10 events, 10 events recorded)
Number of events matching above criteria = 10
Event Type (ET): I - Info, W - Warning, E - Error
Time Stamp ET [Card] Event Message
------------------ -- ------ --------------------------------------------------
10/13 04:29:00.384 E [R0] TestErrorCounterMonitor Failed
10/13 04:29:05.501 E [R0] TestErrorCounterMonitor Failed
10/13 04:29:10.607 E [R0] TestErrorCounterMonitor Failed
10/13 04:29:15.730 E [R0] TestErrorCounterMonitor Failed
10/13 04:29:20.835 E [R0] TestErrorCounterMonitor Failed
10/13 04:29:25.939 E [R0] TestErrorCounterMonitor Failed
10/13 04:29:31.044 E [R0] TestErrorCounterMonitor Failed
10/13 04:29:36.149 E [R0] TestErrorCounterMonitor Failed
10/13 04:29:41.252 E [R0] TestErrorCounterMonitor Failed
10/13 04:29:46.356 E [R0] TestErrorCounterMonitor Failed
Related Commands Command Description
diagnostic event-log size Modifies the diagnostic event log size dynamically.
diagnostic monitor Configures the health-monitoring diagnostic testing.
Cisco IOS Interface and Hardware Component Command Reference
1351
show controllers serial through show hw-module slot proc cpu
show diagnostic events
Command Description
diagnostic ondemand Configures the on-demand diagnostics.
diagnostic schedule test Sets the scheduling of test-based diagnostic testing for a specific module or
schedule a supervisor engine switchover.
diagnostic start Runs the specified diagnostic test.
diagnostic stop Stops the testing process.
Cisco IOS Interface and Hardware Component Command Reference
1352
show controllers serial through show hw-module slot proc cpu
show diagnostic result slot
show diagnostic result slot
To display diagnostic test results for supported hardware slot locations, use the showdiagnosticresultslot
command in privileged EXEC configuration mode.
show diagnostic result slot [{number [{detail|failure [detail]|test testid [detail]|xml}]|all
[{detail|failure [detail]}]}]
Syntax Description number (Optional) Slot location of the hardware for which you want diagnostic test results, such as
R0 for route processor slot 0.
detail (Optional) Displays additional detailed information for the specified diagnostic test.
failure (Optional) Displays only failed diagnostic test results.
test test-id (Optional) Displays diagnostic test results for one or more specific tests, where test-id is one
of the following:
• Name of a diagnostic test.
• Number of a diagnostic test.
• Range of diagnostic test numbers (startrange-endrange).
• List of diagnostic test numbers or range of numbers, separated by commas.
• all --Keyword specifying all diagnostic tests.
xml (Optional) Displays diagnostic text results in Extensible Markup Language (XML) format.
all (Optional) Displays diagnostic test results for all supported hardware locations.
Command Default If you do not specify any options, the command displays diagnostic test results for all supported hardware
slot locations.
Command Modes Privileged EXEC (#)
Command History Release Modification
Cisco IOS XE Release 2.6 This command was introduced.
Usage Guidelines If a test does not exist for the hardware, “Diagnostic is not available ” is shown.
In the command output, the possible testing results are as follows:
• Passed (.)
• Failed (F)
• Unknown (U)
Cisco IOS Interface and Hardware Component Command Reference
1353
show controllers serial through show hw-module slot proc cpu
show diagnostic result slot
Examples The following example shows a passed diagnostic test (indicated by a “.”) called
TestErrorCounterMonitor on route processor slot 0, and no supported diagnostic tests on slot F0 and
slot 0:
Router# show diagnostic result slot all
Current bootup diagnostic level: minimal
slot R0: ASR1000-RP1 SerialNo : JAE1218GSMR
Overall Diagnostic Result for slot R0 : PASS
Diagnostic level at card bootup: minimal
Test results: (. = Pass, F = Fail, U = Untested)
1) TestErrorCounterMonitor ---------> .
Diagnostic[slot F0]: Diagnostic is not available.
Diagnostic[slot 0]: Diagnostic is not available.
The following example shows detailed information about the diagnostic test on the hardware in slot
R0:
Router# show diagnostic result slot R0 detail
Current bootup diagnostic level: minimal
slot R0: ASR1000-RP1 SerialNo : JAE1224L2QP
Overall Diagnostic Result for slot R0 : PASS
Diagnostic level at card bootup: minimal
Test results: (. = Pass, F = Fail, U = Untested)
___________________________________________________________________________
1) TestErrorCounterMonitor ---------> .
Error code ------------------> 0 (DIAG_SUCCESS)
Total run count -------------> 871
Last test testing type ------> Health Monitoring
Last test execution time ----> Oct 13 2009 03:15:47
First test failure time -----> Oct 13 2009 02:02:32
Last test failure time ------> Oct 13 2009 03:10:09
Last test pass time ---------> Oct 13 2009 03:15:47
Total failure count ---------> 10
Consecutive failure count ---> 0
___________________________________________________________________________
Cisco IOS Interface and Hardware Component Command Reference
1354
show controllers serial through show hw-module slot proc cpu
show diagnostic simulation failure
show diagnostic simulation failure
To display a list of simulated test failures installed by the user for a module, use the
showdiagnosticsimulationfailure command in user EXEC or privileged EXEC mode.
show diagnostic simulation failure [{all|module {alllist slot |slot/subslot}}]
Syntax Description all (Optional) Displays the diagnostic simulation failure for all modules.
module (Optional) Specifies the module number.
list A list of modules in the following format:
• Entries are separated by a comma, for example, 1,4,6-10.
• Ranges are specified with a hyphen, for example, 1-4,6-10.
slot Specifies a single module by slot number.
slot / subslot Specifies a single submodule by slot number and subslot or bay within the module.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
12.2(14)SX This command was introduced on the Supervisor Engine 720.
12.2(17d)SXB This command was implemented on the Supervisor Engine 2.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines If you do not enter a module keyword and argument for this command, information for all modules is displayed.
A diagnostic test configured for failure simulation is identified in the output of this command by its test ID
number. You can use the showdiagnosticdescriptionmodulecommand to see the name and detailed description
of a diagnostic test.
Examples The following example shows how to display the simulated test failures installed by the user on
module 1:
Router# show diagnostic simulation failure module 1
Module 1:
Test #17: Simulation = Always Fail
Related Commands Command Description
show diagnostic description module Describes the diagnostic tests.
test diagnostic simulation Configures simulated diagnostic test conditions.
Cisco IOS Interface and Hardware Component Command Reference
1355
show controllers serial through show hw-module slot proc cpu
show diagnostic health
show diagnostic health
To display the output for the health checks performed, use the showdiagnostichealthcommand in user EXEC
or privileged EXEC mode.
show diagnostic health
Syntax Description This command has no arguments or keywords.
Command Default This command has no default settings.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
12.2(33)SXI This command was introduced.
Usage Guidelines The command output displays the following system health check information:
• CPU and memory utilization
• Displays warning if the CPU utilization in the last five minutes is greater than 70%
• Displays total, free, and reserved memory statistics
• EARL recovery patch occurrences, shown as a log
• Nonzero ASIC error registers on all modules using the output listing of TestErrorCounterMonitor
• Nonzero port level error counters for all ports
Examples This example shows how to display the output for the health checks performed:
Router# show diagnostic health
CPU utilization for the past 5 mins is greater than 70%
five minutes: 81%
EARL reset history:
Module 1 : WS-SUP32-GE-3B EARL patch log -
Num. of times patch applied : 0
Num. of times patch requested : 0
Non-zero port counters for 1/8 -
13. linkChange = 338702
Non-zero port counters for 1/9 -
0. rxCRCAlignErrors = 2
3. rxFragmentPkts = 9
6. ifInErrors = 30
13. linkChange = 1
Current bootup diagnostic level: minimal
Test results: (. = Pass, F = Fail, U = Untested)
36) TestErrorCounterMonitor ---------> F
Error code ------------------> 1 (DIAG_FAILURE)
Total run count -------------> 29
Last test execution time ----> Mar 16 2008 19:04:02
First test failure time -----> Mar 16 2008 19:03:21
Last test failure time ------> Mar 16 2008 19:04:02
Cisco IOS Interface and Hardware Component Command Reference
1356
show controllers serial through show hw-module slot proc cpu
show diagnostic health
Last test pass time ---------> Mar 16 2008 19:03:19
Total failure count ---------> 4
Consecutive failure count ---> 4
Error Records as following.
ID -- Asic Identification
IN -- Asic Instance
PO -- Asic Port Number
RE -- Register Identification
RM -- Register Identification More
EG -- Error Group
DV -- Delta Value
CF -- Consecutive Failure
TF -- Total Failure
ID IN PO RE RM DV EG CF TF
---------------------------------------------------------------
26 0 0 338 255 256 2 13 13
26 0 0 344 255 256 2 13 13
26 0 0 358 255 256 2 13 13
System Memory: 524288K total, 353225K used, 171063K free, 1000K kernel reserved
Lowest(b) : 171020288
Process kernel, type POSIX, PID = 1
0K total, 0K text, 0K data, 0K stack, 0K dynamic
Process sbin/chkptd.proc, type POSIX, PID = 16386
2296K total, 1988K text, 120K data, 12K stack, 176K dynamic
65536 heapsize, 55356 allocated, 8084 free
Related Commands Command Description
diagnostic monitor Configures the health-monitoring diagnostic testing.
Cisco IOS Interface and Hardware Component Command Reference
1357
show controllers serial through show hw-module slot proc cpu
show diagnostic ondemand settings
show diagnostic ondemand settings
To display the settings for the on-demand diagnostics, use the showdiagnosticondemandsettingscommand
in user EXEC or privileged EXEC mode.
show diagnostic ondemand settings
Syntax Description This command has no arguments or keywords.
Command Default This command has no default settings.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
12.2(14)SX This command was introduced for the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The command output shows the number of test iterations to be performed and the action to be taken on a test
failure. Possible actions are:
• continue--Continue the ondemand tests until the test failure limit is reached.
• stop--Stop the ondemand tests immediately if a test fails.
Examples This example shows how to display the settings for the on-demand diagnostics:
Router# show diagnostic ondemand settings
Test iterations = 1
Action on test failure = continue
Related Commands Command Description
diagnostic ondemand Configures the on-demand diagnostics.
Cisco IOS Interface and Hardware Component Command Reference
1358
show controllers serial through show hw-module slot proc cpu
show diagnostic result module
show diagnostic result module
To display the diagnostic test results for a module, use the showdiagnosticresultcommand in user EXEC or
privileged EXEC mode.
show diagnostic result module {alllistslot|slot/subslot} [{detail|failure [detail]|test test-id
[detail]|xml}]
Syntax Description all Displays diagnostic test results for all modules.
list A list of modules in the following format:
• Entries are separated by a comma, for example, 1,4,6-10.
• Ranges are specified with a hyphen, for example, 1-4,6-10.
slot Specifies a single module by slot number.
slot/subslot Specifies a single submodule by slot number and subslot or bay within the module.
detail (Optional) Displays the detailed test results.
failure (Optional) Displays the failed test results.
test test-id (Optional) Displays the test results only for the specified test. See the Usage Guidelines for
a list of tests.
xml (Optional) Displays the test results in XML form.
Command Default This command has no default settings.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
12.2(14)SX This command was introduced for theSupervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines In the command output, the possible testing results are as follows:
• Passed (.)
• Failed (F)
• Unknown (U)
To display only the results of failed diagnostic tests, use the failurekeyword.
Cisco IOS Interface and Hardware Component Command Reference
1359
show controllers serial through show hw-module slot proc cpu
show diagnostic result module
To display the results of a specific diagnostic test, specify the test-id number using the testtest-idkeyword
and argument. The test-id numbers for available diagnostic tests are displayed in the output of the
showdiagnosticcontentmodulecommand.
You can use the showdiagnosticdescriptionmodulecommand to see a detailed description of a diagnostic
test.
Examples This example shows how to display a summary of all diagnostic test results for the module in slot
3:
Router# show diagnostic result module 3
Current bootup diagnostic level:complete
Module 3:
Overall Diagnostic Result for Module 8 :PASS
Diagnostic level at card bootup:complete
Test results:(. = Pass, F = Fail, U = Untested)
1) TestLoopback :
Port 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
----------------------------------------------------------------------------
. . . . . . . . . . . . . . . . . . . . . . . .
Port 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48
----------------------------------------------------------------------------
. . . . . . . . . . . . . . . . . . . . . . . .
2) TestNewLearn --------------------> .
3) TestIndexLearn ------------------> .
4) TestDontLearn -------------------> .
5) TestConditionalLearn ------------> .
6) TestDontLearn -------------------> .
7) TestConditionalLearn ------------> .
8) TestBadBpdu ---------------------> .
9) TestTrap ------------------------> .
10) TestMatch -----------------------> .
11) TestCapture ---------------------> .
12) TestProtocolMatch ---------------> .
13) TestChannel ---------------------> .
14) TestIPFibShortcut ---------------> .
15) TestDontShortcut ----------------> .
16) TestL3Capture2 ------------------> .
17) TestL3VlanMet -------------------> .
18) TestIngressSpan -----------------> .
19) TestEgressSpan ------------------> .
20) TestAclPermit -------------------> .
21) TestAclDeny ---------------------> .
22) TestNetflowInlineRewrite:
Port 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
----------------------------------------------------------------------------
. . . . . . . . . . . . . . . . . . . . . . . .
Port 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48
----------------------------------------------------------------------------
. . . . . . . . . . . . . . . . . . . . . . . .
This example shows how to display the detailed test results for the module in slot 1:
Router# show diagnostic result module 1 detail
Current bootup diagnostic level:complete
Module 1:
Overall Diagnostic Result for Module 1 :PASS
Diagnostic level at card bootup:complete
Test results:(. = Pass, F = Fail, U = Untested)
___________________________________________________________________________
1) TestDummy -----------------------> .
Cisco IOS Interface and Hardware Component Command Reference
1360
show controllers serial through show hw-module slot proc cpu
show diagnostic result module
Error code ------------------> 0 (DIAG_SUCCESS)
Total run count -------------> 90
Last test execution time ----> Dec 10 2002 12:34:30
First test failure time -----> Dec 10 2002 11:57:39
Last test failure time ------> Dec 10 2002 12:34:10
Last test pass time ---------> Dec 10 2002 11:34:30
Total failure count ---------> 65
Consecutive failure count ---> 0
___________________________________________________________________________
2) TestLoopback:
Port 1 2
----------
. .
Error code ------------------> 0 (DIAG_SUCCESS)
Total run count -------------> 1
Last test execution time ----> Dec 10 2002 12:37:18
First test failure time -----> n/a
Last test failure time ------> n/a
Last test pass time ---------> Dec 10 2002 12:37:18
Total failure count ---------> 0
Consecutive failure count ---> 0
.
.
.
[...continues...]
Related Commands Command Description
show diagnostic content module Displays the available diagnostic tests.
show diagnostic description module Describes the diagnostic tests.
Cisco IOS Interface and Hardware Component Command Reference
1361
show controllers serial through show hw-module slot proc cpu
show diagnostic sanity
show diagnostic sanity
To display sanity check results, use the show diagnostic sanity command in privileged EXEC mode.
show diagnostic sanity
Syntax Description This command has no arguments or keywords.
Command Default Displays information for all the Gigabit Ethernet WAN interfaces in the Cisco 7600 series router.
Command Modes Privileged EXEC
Command History Release Modification
12.2(18)SXE Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The sanity check runs a set of predetermined checks on the configuration with a possible combination of
certain system states to compile a list of warning conditions. The checks are designed to look for anything
that seems out of place and are intended to serve as an aid to maintaining the system sanity.
The following is a list of the checks that are run and the action taken when the condition is found:
• Checks whether the default gateways are reachable. If so, the system stops pinging.
• If a port auto-negotiates to half duplex, the system flags it.
Trunking Checks
• If a trunk port has the mode set to “on,” the system flags it.
• If a port is trunking and mode is auto, the system flags it.
• If a trunk port is not trunking and the mode is desirable, the system flags it.
• If a trunk port negotiates to half duplex, the system flags it.
Channeling Checks
• If a port has channeling mode set to on, the system flags it.
• If a port is not channeling and the mode is set to desirable, the system flags it.
• If a VLAN has a Spanning-Tree root of 32K (root is not set), the system flags it.
Spanning-Tree VLAN Checks
• If a VLAN has a max age on the Spanning-Tree root that is different than the default, the system flags
it.
• If a VLAN has a fwd delay on the Spanning-Tree root that is different than the default, the system flags
it.
• If a VLAN has a fwd delay on the bridge that is different than the default, the system flags it.
Cisco IOS Interface and Hardware Component Command Reference
1362
show controllers serial through show hw-module slot proc cpu
show diagnostic sanity
• If a VLAN has a fwd delay on the bridge that is different than the default, the system flags it.
• If a VLAN has a hello time on the bridge that is different than the default, the system flags it.
Spanning-Tree Port Checks
• If a port has a port cost that is different than the default, the system flags it.
• If a port has a port priority that is different than the default, the system flags it.
UDLD Checks
• If a port has UDLD disabled, the system flags it.
• If a port had UDLD shut down, the system flags it.
• If a port had a UDLD undetermined state, the system flags it.
Assorted Port Checks
• If a port had receive flow control disabled, the system flags it.
• If a trunk port had PortFast enabled, the system flags it.
• If a inline power port has any of the following states:
• denied
• faulty
• other
• off
The system flags it.
• If a port has a native VLAN mismatch, the system flags it.
• If a port has a duplex mismatch, the system flags it.
Bootstring and Config Register Checks
• The config register on the primary supervisor engine (and on the secondary supervisor engine if present)
must be one of the following values: 0x2 , 0x102, or 0x2102.
• The system verifies the bootstring on the primary supervisor engine (and on the secondary supervisor
engine if present). The system displays a message if the bootstring is empty.
• The system verifies that every file is specified in the bootstring. The system displays a message if the
file is absent or shows up with a wrong checksum.
If only device : is specified as a filename, then the system verifies that the first file is on the device.
Assorted Checks
• The system displays a message if IGMP snooping is disabled.
• The system displays a message if any of the values of the snmp community access strings
{RO,RW,RW-ALL} is the same as the default.
• The system displays a message if any of the modules are in states other than “Ok.”
Cisco IOS Interface and Hardware Component Command Reference
1363
show controllers serial through show hw-module slot proc cpu
show diagnostic sanity
• The system displays a message that lists all the tests that failed (displayed as an “F”) in the show test all
command.
• The system displays a message if *fast is not configured on the switch anywhere.
• The system displays a message if there is enough room for the crashinfo file on the bootflash:.
• The system displays a message if multicast routing is enabled globally but is not applied to all interfaces.
• The system displays a message if IGMP snooping is disabled and RGMP is enabled.
Examples This example displays samples of the messages that could be displayed with the show diagnostic
sanity command:
Router# show diagnostic sanity
Pinging default gateway 10.6.141.1 ....
Type escape sequence to abort.
Sending 5, 100-byte ICMP Echos to 10.6.141.1, timeout is 2 seconds:
..!!.
Success rate is 0 percent (0/5)
IGMP snooping disabled please enable it for optimum config.
IGMP snooping disabled but RGMP enabled on the following interfaces,
please enable IGMP for proper config :
Vlan1, Vlan2, GigabitEthernet1/1
Multicast routing is enabled globally but not enabled on the following
interfaces:
GigabitEthernet1/1, GigabitEthernet1/2
A programming algorithm mismatch was found on the device bootflash:
Formatting the device is recommended.
The bootflash: does not have enough free space to accomodate the crashinfo file.
Please check your confreg value : 0x0.
Please check your confreg value on standby: 0x0.
The boot string is empty. Please enter a valid boot string .
Could not verify boot image "disk0:" specified in the boot string on the
slave.
Invalid boot image "bootflash:asdasd" specified in the boot string on the
slave.
Please check your boot string on the slave.
UDLD has been disabled globally - port-level UDLD sanity checks are
being bypassed.
OR
[
The following ports have UDLD disabled. Please enable UDLD for optimum
config:
Fa9/45
The following ports have an unknown UDLD link state. Please enable UDLD
on both sides of the link:
Fa9/45
]
The following ports have portfast enabled:
Fa9/35, Fa9/45
The following ports have trunk mode set to on:
Fa4/1, Fa4/13
The following trunks have mode set to auto:
Fa4/2, Fa4/3
The following ports with mode set to desirable are not trunking:
Fa4/3, Fa4/4
The following trunk ports have negotiated to half-duplex:
Fa4/3, Fa4/4
The following ports are configured for channel mode on:
Fa4/1, Fa4/2, Fa4/3, Fa4/4
Cisco IOS Interface and Hardware Component Command Reference
1364
show controllers serial through show hw-module slot proc cpu
show diagnostic sanity
The following ports, not channeling are configured for channel mode
desirable:
Fa4/14
The following vlan(s) have a spanning tree root of 32768:
1
The following vlan(s) have max age on the spanning tree root different from
the default:
1-2
The following vlan(s) have forward delay on the spanning tree root different
from the default:
1-2
The following vlan(s) have hello time on the spanning tree root different
from the default:
1-2
The following vlan(s) have max age on the bridge different from the
default:
1-2
The following vlan(s) have fwd delay on the bridge different from the
default:
1-2
The following vlan(s) have hello time on the bridge different from the
default:
1-2
The following vlan(s) have a different port priority than the default
on the port FastEthernet4/1
1-2
The following ports have recieve flow control disabled:
Fa9/35, Fa9/45
The following inline power ports have power-deny/faulty status:
Gi7/1, Gi7/2
The following ports have negotiated to half-duplex:
Fa9/45
The following vlans have a duplex mismatch:
Fas 9/45
The following interafaces have a native vlan mismatch:
interface (native vlan - neighbor vlan)
Fas 9/45 (1 - 64)
The value for Community-Access on read-only operations for SNMP is the same
as default. Please verify that this is the best value from a security point
of view.
The value for Community-Access on write-only operations for SNMP is the same
as default. Please verify that this is the best value from a security point
of view.
The value for Community-Access on read-write operations for SNMP is the same
as default. Please verify that this is the best value from a security point
of view.
Please check the status of the following modules:
8,9
Module 2 had a MINOR_ERROR.
The Module 2 failed the following tests:
TestIngressSpan
The following ports from Module2 failed test1:
1,2,4,48
Cisco IOS Interface and Hardware Component Command Reference
1365
show controllers serial through show hw-module slot proc cpu
show diagnostic schedule module
show diagnostic schedule module
To display the current scheduled diagnostic tasks, use the showdiagnosticschedulemodulecommand in user
EXEC or privileged EXEC mode.
show diagnostic schedule module {alllistslot|slot/subslot}
Syntax Description all Displays the current scheduled diagnostic tasks for all modules.
list A list of modules in the following format:
• Entries are separated by a comma, for example, 1,4,6-10.
• Ranges are specified with a hyphen, for example, 1-4,6-10.
slot Specifies a single module by slot number.
slot/subslot Specifies a single submodule by slot number and subslot or bay within the module.
Command Default This command has no default settings.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
12.2(14)SX This command was introduced for the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines A scheduled diagnostic test is identified in the output of this command by its test ID number. With the test
ID number, you can see the name and detailed description of the diagnostic test by using the
showdiagnosticdescriptionmodulecommand.
Examples This example shows how to display the current scheduled diagnostic tasks for the module in slot 1:
Router# show diagnostic schedule module 1
Current Time = 07:55:30 UTC Fri August 2 2002
Diagnostic for Module 1:
Schedule #1:
To be run on January 3 2003 23:32
Test ID(s) to be executed:1.
Schedule #2:
To be run daily 14:45
Test ID(s) to be executed:2.
Schedule #3:
To be run weekly Monday 3:33
Test ID(s) to be executed:all.
Cisco IOS Interface and Hardware Component Command Reference
1366
show controllers serial through show hw-module slot proc cpu
show diagnostic schedule module
Related Commands Command Description
diagnostic schedule test Sets the scheduling of test-based diagnostic testing for a specific
module or schedule a supervisor engine switchover.
show diagnostic description module Describes the diagnostic tests.
Cisco IOS Interface and Hardware Component Command Reference
1367
show controllers serial through show hw-module slot proc cpu
show diagnostic status
show diagnostic status
To display the currently running diagnostics tests, use the showdiagnosticstatuscommand in user EXEC or
privileged EXEC mode.
show diagnostic status
Syntax Description This command has no arguments or keywords.
Command Default This command has no default settings.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
12.2(14)SX This command was introduced for the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines For each installed module, the following fields are displayed in the command output:
Field Description
Card The slot number of the module associated with the event
Description A description of the module
Current Running Test The diagnostic test running on the module
Run by The diagnostic test category that initiated the running test. The categories are:
• BU--This test is running as a part of the bootup diagnostics
• HM--This test is running as a part of the health monitoring diagnostics
• OD--This was initiated as an ondemand diagnostic test
• SCH--This test is running as a scheduled diagnostic test
Examples This example shows how to display the currently running diagnostics tests:
Router# show diagnostic status
<BU> - Bootup Diagnostics, <HM> - Health Monitoring Diagnostics, <OD> - OnDemand Diagnostics,
<SCH> - Scheduled Diagnostics
====== ================================= =============================== ======
Card Description Current Running Test Run by
------ --------------------------------- ------------------------------- ------
3 CEF720 48 port 10/100/1000mb Ethe TestLoopback <OD>
5 Supervisor Engine 720 (Hot) TestScratchRegister <HM>
6 Supervisor Engine 720 (Active) N/A N/A
Cisco IOS Interface and Hardware Component Command Reference
1368
show controllers serial through show hw-module slot proc cpu
show diagnostic status
8 CEF720 8 port 10GE with DFC N/A N/A
====== ================================= =============================== ======
Related Commands Command Description
diagnostic start Runs the specified diagnostic test.
diagnostic stop Stops the testing process.
show diagnostic content module Displays the available diagnostic tests.
show diagnostic description module Describes the diagnostic tests.
Cisco IOS Interface and Hardware Component Command Reference
1369
show controllers serial through show hw-module slot proc cpu
show dsc clock
show dsc clock
To display information about the dial shelf controller clock, use the showdscclockcommand in privileged
EXEC mode with the line card execute (execute-on) command.
execute-on {slot slot-number|all} show dsc clock
Syntax Description execute-on Executes commands remotely on a line card.
slot slot-number Displays information for a specific slot. Slot number (12 or 13) must be occupied by a
DSC card.
all Executes the command on all line cards.
Command Modes EXEC
Command History Release Modification
11.3(2)AA This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines You must use the showdscclock command from the router using the execute-on command.
Examples The following is sample output from the showdscclock command:
Router# execute-on slot 12
show dsc clock
Router#
Primary Clock:
--------------
Slot: 3, Port 1, Line 0, Priority = 3 up since 00:37:56
Time elapsed since last failure of the primary = 00:38:59
Backup clocks:
Source Slot Port Line Priority Status State
--------------------------------------------------------------
Trunk 1 2 0 10 Good Configured
All feature boards present are getting good clock from DSC
The table below describes the significant fields shown in the display.
Table 100: show dcs clock Field Descriptions
Field Description
Primary clock The clock designated as the master timing clock.
Cisco IOS Interface and Hardware Component Command Reference
1370
show controllers serial through show hw-module slot proc cpu
show dsc clock
Field Description
Priority The order in which a clock is designated to back up the primary clock or the next higher
priority clock in case of its failure.
Backup Source The clock signal source, such as a trunk, internal clock, or external generator.
Feature board An application-specific card in the dial shelf, such as a line card.
Trunk The trunk line connected to the ISP or central office.
Status Whether the clock source is capable of providing a synch source signal.
State Whether the clock source is connected and assigned a priority.
Related Commands Command Description
execute-on Executes commands remotely on a line card.
Cisco IOS Interface and Hardware Component Command Reference
1371
show controllers serial through show hw-module slot proc cpu
show dsi
show dsi
To display information about the dial shelf interconnect (DSI) port adapter parameters, use the showdsi
command in privileged EXEC mode with the line card execute (execute-on) command.
execute-on {slot slot-number|all} show dsi
Syntax Description execute-on Executes commands remotely on a line card.
slot slot-number Displays information for a specific slot. Slot number (12 or 13) must be occupied by a
DSC card.
all Executes the command on all line cards.
Command Modes Privileged EXEC
Command History Release Modification
11.3(2)AA This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The dial shelf interconnect (DSI) port adapter connects the Cisco 5814 dial shelf to the Cisco 7206 router
shelf. The DSI port adapter allows data transfers between the dial shelf and the router shelf. Data is converted
into packets by the feature cards, transmitted to a hub on the dial shelf controller card, and from there sent to
the router shelf. Conversely, packets from the router shelf are sent to the dial shelf controller card, where they
are transmitted over the backplane to the modem and trunk cards. The show dsi command is used to show
information about the dial shelf interconnect hardware, interface, physical link, PCI registers, and address
filters.
Examples The following is sample output from the showdsicommand:
Router# execute-on slot 1 show dsi
DSI-Tx-FastEthernet0 is up, line protocol is up
Hardware is DEC21140A, address is 0008.26b7.b008 (bia 0008.26b7.b008)
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec, rely 255/255, load 1/255
Encapsulation ARPA, loopback not set, keepalive set (10 sec)
Half-duplex, 100Mb/s, 100BaseTX/FX
ARP type: ARPA, ARP Timeout 04:00:00
Last input 01:17:09, output 00:00:00, output hang never
Last clearing of "show interface" counters never
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
6 packets input, 596 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 watchdog, 0 multicast
Cisco IOS Interface and Hardware Component Command Reference
1372
show controllers serial through show hw-module slot proc cpu
show dsi
0 input packets with dribble condition detected
6170 packets output, 813483 bytes, 0 underruns
0 output errors, 0 collisions, 1 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out
DSI-Rx-FastEthernet1 is up, line protocol is up
Hardware is DEC21140A, address is 0008.26b7.b008 (bia 0008.26b7.b008)
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec, rely 255/255, load 1/255
Encapsulation ARPA, loopback not set, keepalive set (10 sec)
Full-duplex, 100Mb/s, 100BaseTX/FX
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:00:00, output never, output hang never
Last clearing of "show interface" counters never
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
6280 packets input, 362493 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 watchdog, 0 multicast
0 input packets with dribble condition detected
0 packets output, 0 bytes, 0 underruns
0 output errors, 0 collisions, 1 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out
Interface DSI-Tx-FastEthernet0
Hardware is DEC21140A
dec21140_ds=0x604C9FC4, registers=0x3C000000, ib=0x1912E00
rx ring entries=128, tx ring entries=256
rxring=0x1912F00, rxr shadow=0x604CA16C, rx_head=6, rx_tail=0
txring=0x1913740, txr shadow=0x604CA398, tx_head=138, tx_tail=138, tx_count=0
PHY link up
CSR0=0xFE024882, CSR3=0x1912F00, CSR4=0x1913740, CSR5=0xFC660000
CSR6=0x320CA002, CSR7=0xFFFFA261, CSR8=0xE0000000, CSR9=0xFFFDC3FF
CSR11=0xFFFE0000, CSR12=0xFFFFFF09, CSR15=0xFFFFFEC8
DEC21140 PCI registers:
bus_no=0, device_no=1
CFID=0x00091011, CFCS=0x02800006, CFRV=0x02000022, CFLT=0x0000FF00
CBIO=0x00000001, CBMA=0x48000000, CFIT=0x28140100, CFDA=0x00000000
MII registers:
Register 0x00: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Register 0x08: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Register 0x10: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Register 0x18: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
throttled=0, enabled=0, disabled=0
rx_fifo_overflow=0, rx_no_enp=0, rx_discard=0
tx_underrun_err=0, tx_jabber_timeout=0, tx_carrier_loss=0
tx_no_carrier=0, tx_late_collision=0, tx_excess_coll=0
tx_collision_cnt=0, tx_deferred=0, fatal_tx_err=0, tbl_overflow=0
HW addr filter: 0x604CABC4, ISL Disabled
Entry= 0: Addr=FFFF.FFFF.FFFF
Entry= 1: Addr=FFFF.FFFF.FFFF
Entry= 2: Addr=FFFF.FFFF.FFFF
Entry= 3: Addr=FFFF.FFFF.FFFF
Entry= 4: Addr=FFFF.FFFF.FFFF
Entry= 5: Addr=FFFF.FFFF.FFFF
Entry= 6: Addr=FFFF.FFFF.FFFF
Entry= 7: Addr=FFFF.FFFF.FFFF
Entry= 8: Addr=FFFF.FFFF.FFFF
Entry= 9: Addr=FFFF.FFFF.FFFF
Entry=10: Addr=FFFF.FFFF.FFFF
Cisco IOS Interface and Hardware Component Command Reference
1373
show controllers serial through show hw-module slot proc cpu
show dsi
Entry=11: Addr=FFFF.FFFF.FFFF
Entry=12: Addr=FFFF.FFFF.FFFF
Entry=13: Addr=FFFF.FFFF.FFFF
Entry=14: Addr=FFFF.FFFF.FFFF
Entry=15: Addr=0008.26B7.B008
Interface DSI-Rx-FastEthernet1
Hardware is DEC21140A
dec21140_ds=0x604DDA4C, registers=0x3C000800, ib=0x1A01FC0
rx ring entries=128, tx ring entries=256
rxring=0x1A020C0, rxr shadow=0x604DDBF4, rx_head=55, rx_tail=0
txring=0x1A02900, txr shadow=0x604DDE20, tx_head=2, tx_tail=2, tx_count=0
PHY link up
CSR0=0xFE024882, CSR3=0x1A020C0, CSR4=0x1A02900, CSR5=0xFC660000
CSR6=0x320CA202, CSR7=0xFFFFA261, CSR8=0xE0000000, CSR9=0xFFFDC3FF
CSR11=0xFFFE0000, CSR12=0xFFFFFF09, CSR15=0xFFFFFEC8
DEC21140 PCI registers:
bus_no=0, device_no=2
CFID=0x00091011, CFCS=0x02800006, CFRV=0x02000022, CFLT=0x0000FF00
CBIO=0x00000001, CBMA=0x48000800, CFIT=0x28140100, CFDA=0x00000000
MII registers:
Register 0x00: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Register 0x08: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Register 0x10: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Register 0x18: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
throttled=0, enabled=0, disabled=0
rx_fifo_overflow=0, rx_no_enp=0, rx_discard=0
tx_underrun_err=0, tx_jabber_timeout=0, tx_carrier_loss=0
tx_no_carrier=0, tx_late_collision=0, tx_excess_coll=0
tx_collision_cnt=0, tx_deferred=0, fatal_tx_err=0, tbl_overflow=0
HW addr filter: 0x604DE64C, ISL Disabled
Entry= 0: Addr=FFFF.FFFF.FFFF
Entry= 1: Addr=FFFF.FFFF.FFFF
Entry= 2: Addr=FFFF.FFFF.FFFF
Entry= 3: Addr=FFFF.FFFF.FFFF
Entry= 4: Addr=FFFF.FFFF.FFFF
Entry= 5: Addr=FFFF.FFFF.FFFF
Entry= 6: Addr=FFFF.FFFF.FFFF
Entry= 7: Addr=FFFF.FFFF.FFFF
Entry= 8: Addr=FFFF.FFFF.FFFF
Entry= 9: Addr=FFFF.FFFF.FFFF
Entry=10: Addr=FFFF.FFFF.FFFF
Entry=11: Addr=FFFF.FFFF.FFFF
Entry=12: Addr=FFFF.FFFF.FFFF
Entry=13: Addr=FFFF.FFFF.FFFF
Entry=14: Addr=FFFF.FFFF.FFFF
Entry=15: Addr=0008.26B7.B008
The table below describes the significant fields shown in the display.
Table 101: show dsi Field Descriptions
Field Description
FastEthernet0 ... is up ... Indicates whether the interface hardware is currently active and if it has been taken
is administratively down down by an administrator.
line protocol is Indicates whether the software processes that handle the line protocol consider the
line usable or if it has been taken down by an administrator.
Hardware Hardware type (for example, MCI Ethernet, SCI,2 CBus3 Ethernet) and address.
Cisco IOS Interface and Hardware Component Command Reference
1374
show controllers serial through show hw-module slot proc cpu
show dsi
Field Description
Internet address Internet address followed by subnet mask.
MTU Maximum Transmission Unit of the interface.
BW Bandwidth of the interface in kilobits per second.
DLY Delay of the interface in microseconds.
rely Reliability of the interface as a fraction of 255 (255/255 is 100% reliability),
calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes.
Encapsulation Encapsulation method assigned to interface.
ARP type: Type of Address Resolution Protocol assigned.
loopback Indicates whether loopback is set or not.
keepalive Indicates whether keepalives are set or not.
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by an interface. Useful for knowing when a dead interface failed.
output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by the interface. Useful for knowing when a dead interface failed.
output hang Number of hours, minutes, and seconds (or never) since the interface was last reset
because of a transmission that took too long. When the number of hours in any of
the “last” fields exceeds 24 hours, the number of days and hours is printed. If that
field overflows, asterisks are printed.
Last clearing Time at which the counters that measure cumulative statistics (such as number of
bytes transmitted and received) shown in this report were last reset to zero. Note
that variables that might affect routing (for example, load and reliability) are not
cleared when the counters are cleared. *** indicates the elapsed time is too large
to be displayed. 0:00:00 indicates the counters were cleared more than 231ms (and
less than 232ms) ago.
Output queue, input Number of packets in output and input queues. Each number is followed by a slash,
queue, drops the maximum size of the queue, and the number of packets dropped due to a full
queue.
5 minute input rate, 5 Average number of bits and packets transmitted per second in the last 5 minutes.
minute output rate If the interface is not in promiscuous mode, it senses network traffic it sends and
receives (rather than all network traffic).
The 5-minute input and output rates should be used only as an approximation of
traffic per second during a given 5-minute period. These rates are exponentially
weighted averages with a time constant of 5 minutes. A period of four time
constants must pass before the average will be within two percent of the
instantaneous rate of a uniform stream of traffic over that period.
Cisco IOS Interface and Hardware Component Command Reference
1375
show controllers serial through show hw-module slot proc cpu
show dsi
Field Description
packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the error free
packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the
main system. Compare with ignored count. Broadcast storms on Ethernets and
bursts of noise on serial lines are often responsible for no input buffer events.
Received ... broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the medium’s
minimum packet size. For instance, any Ethernet packet that is less than 64 bytes
is considered a runt.
giants Number of packets that are discarded because they exceed the medium’s maximum
packet size. For example, any Ethernet packet that is greater than 1518 bytes is
considered a giant.
input errors Includes runts, giants, no buffer, CRC, frame, overrun, and ignored counts. Other
input-related errors can also cause the input errors count to be increased, and some
datagrams may have more than one error; therefore, this sum may not balance with
the sum of enumerated input error counts.
CRC Cyclic redundancy checksum generated by the originating LAN station or far-end
device does not match the checksum calculated from the data received. On a LAN,
this usually indicates noise or transmission problems on the LAN interface or the
LAN bus itself. A high number of CRCs is usually the result of collisions or a
station transmitting bad data.
frame Number of packets received incorrectly having a CRC error and a noninteger
number of octets. On a LAN, this is usually the result of collisions or a
malfunctioning Ethernet device.
overrun Number of times the receiver hardware was unable to hand received data to a
hardware buffer because the input rate exceeded the receiver’s ability to handle
the data.
ignored Number of received packets ignored by the interface because the interface hardware
ran low on internal buffers. These buffers are different than the system buffers
mentioned previously in the buffer description. Broadcast storms and bursts of
noise can cause the ignored count to be increased.
abort Number of packets whose receipt was aborted.
watchdog Number of times watchdog receive timer expired. It happens when receiving a
packet with length greater than 2048.
multicast Number of multicast packets received.
Cisco IOS Interface and Hardware Component Command Reference
1376
show controllers serial through show hw-module slot proc cpu
show dsi
Field Description
input packets with Dribble bit error indicates that a frame is slightly too long. This frame error counter
dribble condition is incremented just for informational purposes; the router accepts the frame.
detected
packets output Total number of messages transmitted by the system.
bytes Total number of bytes, including data and MAC encapsulation, transmitted by the
system.
underruns Number of times that the transmitter has been running faster than the router can
handle. This may never be reported on some interfaces.
output errors Sum of all errors that prevented the final transmission of datagrams out of the
interface being examined. Note that this may not balance with the sum of the
enumerated output errors, as some datagrams may have more than one error, and
others may have errors that do not fall into any of the specifically tabulated
categories.
collisions Number of messages retransmitted due to an Ethernet collision. This is usually
the result of an overextended LAN (Ethernet or transceiver cable too long, more
than two repeaters between stations, or too many cascaded multiport transceivers).
A packet that collides is counted only once in output packets.
interface resets Number of times an interface has been completely reset. This can happen if packets
queued for transmission were not sent within several seconds. On a serial line, this
can be caused by a malfunctioning modem that is not supplying the transmit clock
signal, or by a cable problem. If the system notices that the carrier detect line of
a serial interface is up, but the line protocol is down, it periodically resets the
interface in an effort to restart it. Interface resets can also occur when an interface
is looped back or shut down.
restarts Number of times a Type 2 Ethernet controller was restarted because of errors.
babbles The transmit jabber timer expired.
late collision Number of late collisions. Late collision happens when a collision occurs after
transmitting the preamble.
deferred Deferred indicates that the chip had to defer while ready to transmit a frame because
the carrier was asserted.
lost carrier Number of times the carrier was lost during transmission.
no carrier Number of times the carrier was not present during the transmission.
output buffer failures Number of failed buffers and number of buffers swapped out.
2
SCI = Single Cell Input
3
CBus = Command Bus
Cisco IOS Interface and Hardware Component Command Reference
1377
show controllers serial through show hw-module slot proc cpu
show dsi
Command Description
execute-on Executes commands on a line card.
show dsip Displays all information about the DSIP.
show version Displays the configuration of the system hardware, the software version, the names and
sources of configuration files, and the boot images.
Cisco IOS Interface and Hardware Component Command Reference
1378
show controllers serial through show hw-module slot proc cpu
show dsip
show dsip
To display all information about the Distributed System Interconnect Protocol (DSIP) on a Cisco AS5800,
use the showdsipcommand in EXEC mode.
show dsip
Syntax Description This command has no arguments or keywords.
Command Modes EXEC
Command History Release Modification
11.3(2)AA This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Your Cisco AS5800 universal access server uses a protocol used by the Cisco 7206 router shelf to communicate
back and forth with the Cisco 5814 dial shelf controller card(s) and feature cards. Although dial shelf
interconnect (DSI) configuration is transparent to the user, there are several show commands to help you view
your setup, and debug commands to help you troubleshoot your system.
To display a subset of this information, use theshowdsipclients, showdsipnodes, showdsipports,
showdsipqueue,showdsiptracing, showdsiptransport, and showdsipversion commands.
Examples The following is sample output from the showdsipcommand. For a description of the fields shown
in the sample output, refer to the individual showdsipcommands listed in the “Usage Guidelines”
section.
Router# show dsip
DSIP Transport Statistics:
IPC : input msgs=8233, bytes=699488; output msgs=8233, bytes=483558
total consumed ipc msgs=682; total freed ipc msgs = 682
transmit contexts in use = 11, free = 245, zombie = 0, invalid = 0
ipc getmsg failures = 0, ipc timeouts=0
core getbuffer failures=0, api getbuffer failures=0
dsip test msgs rcvd = 2770, sent = 0
CNTL: input msgs=1112, bytes=91272; output msgs=146, bytes=8760
getbuffer failures=0
DATA: input msgs=0, bytes=0; output msgs=426, bytes=5112
DSIP Private Buffer Pool Hits = 0
DSIP Registered Addresses:
Shelf0 : Master: 00e0.b093.2238, Status=local
Shelf1 : Slot1 : 0007.5387.4808, Status=remote
Shelf1 : Slot5 : 0007.5387.4828, Status=remote
Shelf1 : Slot6 : 0007.5387.4830, Status=remote
Shelf1 : Slot7 : 0007.5387.4838, Status=remote
Cisco IOS Interface and Hardware Component Command Reference
1379
show controllers serial through show hw-module slot proc cpu
show dsip
Shelf1 : Slot8 : 0007.5387.4840, Status=remote
Shelf1 : Slot9 : 0007.5387.4848, Status=remote
Shelf1 : Slot11: 0007.5387.4858, Status=remote
Shelf1 : Slot12: 0007.4b67.8260, Status=remote
DSIP Clients:
-------------
ID Name
0 Console
1 Clock
2 Modem
3 Logger
4 Trunk
5 Async data
6 TDM
7 Dial shelf manager
8 Environment Mon
9 DSIP Test
Dsip Local Ports:
----------------
Client:Portname Portid In-Msgs Bytes Last-i/p
Console:Master 10004 0 0 never
Clock:Master 10005 29 3464 00:00:40
Modem:Master 10006 90 70162 00:23:44
Logger:Master 10007 0 0 never
Trunk:Master 10008 1765 140480 00:00:08
Async data:Master 10009 0 0 never
TDM:Master 1000A 7 112 00:24:19
Dial shelf manager:Master 1000B 28 4752 00:00:36
DSIP Test:Master 1000C 2922 2922 00:00:00
Dsip Remote Ports:
-----------------
Client:Portname Portid Out-Msgs Bytes Last-o/p Last-act
Clock:Slave1 101005F 1 24 00:24:21 00:24:21
Trunk:Slave1 1010061 12 1776 00:24:21 00:24:21
Modem:Slave5 1050050 96 2148 00:23:56 00:24:19
Modem:Slave6 1060050 105 2040 00:24:00 00:24:22
Modem:Slave7 1070050 106 2188 00:23:56 00:24:20
Modem:Slave8 1080050 112 2212 00:24:13 00:24:35
Modem:Slave9 1090050 115 2224 00:24:09 00:24:35
Modem:Slave11 10B0050 107 2192 00:24:09 00:24:32
Clock:Slave12 10C000D 1 24 00:24:37 00:24:37
Dial shelf manager:Slave12 10C000E 28 4752 00:00:49 00:24:35
DSIP Test:Slave12 10C000F 0 0 never 00:24:35
DSIP ipc queue:
---------------
There are 0 IPC messages waiting for acknowledgement in the transmit queue.
There are 0 messages currently in use by the system.
DSIP ipc seats:
---------------
There are 9 nodes in this IPC realm.
ID Type Name Last Last
Sent Heard
10000 Local IPC Master 0 0
1060000 DSIP Seat:Slave6 10 10
10C0000 DSIP Seat:Slave12 2963 13
1080000 DSIP Seat:Slave8 10 10
1090000 DSIP Seat:Slave9 10 10
1010000 DSIP Seat:Slave1 16 16
1070000 DSIP Seat:Slave7 10 10
10B0000 DSIP Seat:Slave11 10 10
1050000 DSIP Seat:Slave5 10 10
Cisco IOS Interface and Hardware Component Command Reference
1380
show controllers serial through show hw-module slot proc cpu
show dsip
DSIP version information:
------------------------
Local DSIP major version = 3, minor version = 2
All DS slots are running DSIP versions compatible with RS
Local Clients Registered Versions:
------------------------------------
Client Name Major Version Minor Version
Console 3 2
Clock 1 1
Modem 0 0
Logger No version No version
Trunk No version No version
Async data No version No version
TDM No version No version
DSIP Test No version No version
Mismatched Remote Client Versions:
-----------------------------------
Related Commands Command Description
show dsip clients Lists the clients registered with DSIP on a system.
show dsip nodes Displays information about the processors running the DSIP.
show dsip ports Displays information about local and remote ports.
show dsip queue Displays the number of messages in the retransmit queue waiting for
acknowledgment.
show dsip tracing Displays DSIP tracing buffer information.
show dsip transport Displays information about the DSIP transport statistics for the control/data and IPC
packets and registered addresses.
show dsip version Displays DSIP version information.
show version Displays the configuration of the system hardware, the software version, the names
and sources of configuration files, and the boot images.
Cisco IOS Interface and Hardware Component Command Reference
1381
show controllers serial through show hw-module slot proc cpu
show dsip clients
show dsip clients
To display information about Distributed System Interconnect Protocol (DSIP) clients, use the
showdsipclientscommand in EXEC mode.
show dsip clients
Syntax Description This command has no arguments or keywords.
Command Modes EXEC
Command History Release Modification
11.3(2)AA This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use this command to see whether a client is actually registered with DSIP and using its services.
Consider the following example: a client “Trunk” seems to be defunct on a particular node with absolutely
no input/output activity. The command show dsip ports does not show any Trunk port among its local ports
though all other client ports show up. The problem might be that the Trunk client did not even register with
DSIP. To confirm this, use the show dsip clients command.
Examples The following is sample output from the showdsipclientscommand. This command lists the clients.
Router# show dsip clients
ID Name
0 Console
1 Clock
2 Modem
3 Logger
4 Trunk
5 Async data
6 TDM
7 Dial shelf manager
8 Environment Mon
9 DSIP Test
Related Commands Command Description
show dsip nodes Displays information about the processors running the DSIP.
show dsip ports Displays information about local and remote ports
show dsip queue Displays the number of messages in the retransmit queue waiting for
acknowledgment.
Cisco IOS Interface and Hardware Component Command Reference
1382
show controllers serial through show hw-module slot proc cpu
show dsip clients
Command Description
show dsip tracing Displays DSIP tracing buffer information.
show dsip transport Displays information about the DSIP transport statistics for the control/data and IPC
packets and registered addresses.
show dsip version Displays DSIP version information.
Cisco IOS Interface and Hardware Component Command Reference
1383
show controllers serial through show hw-module slot proc cpu
show dsip nodes
show dsip nodes
To display information about the processors running the Distributed System Interconnect Protocol (DSIP),
use the showdsipnodescommand in EXEC mode.
show dsip nodes
Syntax Description This command has no arguments or keywords.
Command Modes EXEC
Command History Release Modification
11.3(2)AA This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Use show dsip nodes to see the nodes (slots) connected by DSIP and the node specific sequence numbers.
The former information is also available from show dsip transport. The sequence numbers are useful for
support engineers while debugging a problem.
Examples The following is sample output from the showdsipnodes command:
Router# show dsip nodes
DSIP ipc nodes:
---------------
There are 9 nodes in this IPC realm.
ID Type Name Last Last
Sent Heard
10000 Local IPC Master 0 0
1130000 DSIP Dial Shelf:Slave12 12 12
1080000 DSIP Dial Shelf:Slave1 1 1
10A0000 DSIP Dial Shelf:Slave3 1 1
10C0000 DSIP Dial Shelf:Slave5 1 1
10D0000 DSIP Dial Shelf:Slave6 1 1
10E0000 DSIP Dial Shelf:Slave7 1 1
10F0000 DSIP Dial Shelf:Slave8 1 1
1100000 DSIP Dial Shelf:Slave9 1 1
The table below describes the significant fields shown in the display.
Cisco IOS Interface and Hardware Component Command Reference
1384
show controllers serial through show hw-module slot proc cpu
show dsip nodes
Table 102: show dsip nodes Field Descriptions
Field Description
ID DSIP uses Cisco’s IPC (Inter Process Communication) module for nondata related
(client control messages etc.) traffic. A seat or node is a computational element, such
as a processor, that can be communicated with using IPC services. A seat is where
entities and IPC ports reside. The IPC maintains a seat table which contains the seatids
of all the seats in the system. Normally this seatid is a function of the slot number.
Type Local: Local node.
DSIP: Remote DSIP node.
Name Each seat (node) has a name to easily identify it. There is only one master node and
rest are slave nodes. The master node name is “IPC Master” and the slave node name
is “Seat:Slave X”, where “X” is the slot number of the node.
Last Sent/Last Heard Each node maintains two sequence numbers for the last sent and last heard.
Last Sent Whenever a message is sent out, the “last sent” counter is updated.
Last Heard Whenever a message is received from a remote node, “last heard” is updated.
Related Commands Command Description
show dsip clients Lists the clients registered with DSIP on a system.
show dsip ports Displays information about local and remote ports
show dsip queue Displays the number of messages in the retransmit queue waiting for
acknowledgment.
show dsip tracing Displays DSIP tracing buffer information.
show dsip transport Displays information about the DSIP transport statistics for the control/data and IPC
packets and registered addresses.
show dsip version Displays DSIP version information.
Cisco IOS Interface and Hardware Component Command Reference
1385
show controllers serial through show hw-module slot proc cpu
show dsip ports
show dsip ports
To display information about local and remote ports, use the showdsipportscommand in EXEC mode.
show dsip ports [{local|remote [slot]}]
Syntax Description local (Optional) Displays information for local ports. The local port is the port created at a seat’s local
end.
remote (Optional) Displays information for remote ports. The remote port is the port residing on a remote
seat to which DSIP IPC based connection is open.
slot (Optional) Specifies a slot number to display information for a specific card on the dial shelf.
Command Modes EXEC
Command History Release Modification
11.3(2)AA This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines The DSIP communication going through the IPC stack uses ports. The creation of a port returns a 32-bit port
ID which is the endpoint for communication between two IPC clients.
The show dsip ports command is used to check clients that are up and running:
• To see the local ports that are created and the activity on them.
• To see the remote ports which are connected and to see the activity on them.
If no options are specified, information is displayed for both local and remote ports.
Examples The following is sample output from the showdsipports command:
Router# show dsip ports
Dsip Local Ports:
----------------
Client:Portname Portid In-Msgs Bytes Last-i/p
Console:Master 10004 0 0 never
Clock:Master 10005 16 1800 00:00:05
Modem:Master 10006 90 70162 00:10:08
Logger:Master 10007 0 0 never
Trunk:Master 10008 792 62640 00:00:03
Async data:Master 10009 0 0 never
TDM:Master 1000A 7 112 00:10:44
Dial shelf manager:Master 1000B 15 2256 00:00:27
DSIP Test:Master 1000C 1294 1294 00:00:00
Cisco IOS Interface and Hardware Component Command Reference
1386
show controllers serial through show hw-module slot proc cpu
show dsip ports
Dsip Remote Ports:
-----------------
Client:Portname Portid Out-Msgs Bytes Last-o/p Last-act
Clock:Slave1 101005F 1 24 00:10:46 00:10:46
Trunk:Slave1 1010061 12 1776 00:10:46 00:10:46
Modem:Slave5 1050050 96 2148 00:10:21 00:10:44
Modem:Slave6 1060050 105 2040 00:10:25 00:10:48
Modem:Slave7 1070050 106 2188 00:10:21 00:10:45
Modem:Slave8 1080050 112 2212 00:10:25 00:10:47
Modem:Slave9 1090050 115 2224 00:10:39 00:11:05
Modem:Slave11 10B0050 107 2192 00:10:39 00:11:02
Clock:Slave12 10C000D 1 24 00:11:07 00:11:07
Dial shelf manager:Slave12 10C000E 15 2256 00:00:45 00:11:05
DSIP Test:Slave12 10C000F 0 0 never 00:11:05
The table below describes the significant fields shown in the display.
Table 103: show dsip ports Field Descriptions
Field Description
Client:Portname Client name and port name. Port Name. The port names can be determined because they
are based on a uniform naming convention that includes the following elements:
• Client name
• Master/slave status
• Slot number
Any client can derive the port name of the other client it wants to talk to once it knows its
physical location, using the following formula:
Master/Slave Status Port Name Syntax
Master Client-Name:Master,for example, Console:Master
Slave Client-Name:SlaveSlot, for example, Clock:Slave1
Portid Port ID. The Port ID is a 32-bit identifier comprised of seatid and the port-number. The
IPC maintains a seat table which contains the seatids of all the seats in the system. A seat
is where clients and ports reside.
The seat ID is a function of the slot number. Port number is the sequential number of the
port that is being created on a particular seat, for example: 0,1, 2, etc.
In-Msgs/ The total number of input messages that were received on a particular port.
Out-Msgs The total number of output messages that were sent to a particular remote port.
Bytes(in/out) The total number of bytes that were received on a particular port or sent to a remote port.
The number of bytes on this port up to the time of the execution of the show command.
Last-i/p Elapsed time since the last input was received on a local port.
Last-o/p Elapsed time since the last message was sent to a particular remote port.
Last-act Elapsed time since the connection to a remote port was opened.
Cisco IOS Interface and Hardware Component Command Reference
1387
show controllers serial through show hw-module slot proc cpu
show dsip ports
Related Commands Command Description
show dsip clients Lists the clients registered with DSIP on a system.
show dsip nodes Displays information about the nodes (slots) connected by DSIP on a system.
show dsip queue Displays the number of messages in the retransmit queue waiting for
acknowledgment.
show dsip tracing Displays DSIP tracing buffer information.
show dsip transport Displays information about the DSIP transport statistics for the control/data and IPC
packets and registered addresses.
show dsip version Displays DSIP version information.
show version Displays the configuration of the system hardware, the software version, the names
and sources of configuration files, and the boot images.
Cisco IOS Interface and Hardware Component Command Reference
1388
show controllers serial through show hw-module slot proc cpu
show dsip queue
show dsip queue
To display the number of IPC messages in the transmission queue waiting for acknowledgment, use the
showdsipqueuecommand in EXEC mode.
show dsip queue
Syntax Description This command has no arguments or keywords.
Command Modes EXEC
Command History Release Modification
11.3(2)AA This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines IPC is inter-process communication. Processes communicate by exchanging messages held in queue buffers.
Use the show dsip queue to display the status of these queue buffers.
Examples The following is sample output from the showdsipqueuecommand when the system is operating
correctly:
Router# show dsip queue
DSIP ipc queue:
---------------
There are 0 IPC messages waiting for acknowledgment in the transmit queue.
There are 0 messages currently in use by the system.
Related Commands Command Description
show dsip clients Lists the clients registered with DSIP on a system.
show dsip nodes Displays information about the nodes (slots) connected by DSIP on a system.
show dsip ports Displays information about local and remote ports.
show dsip tracing Displays DSIP tracing buffer information.
show dsip transport Displays information about the DSIP transport statistics for the control/data and IPC
packets and registered addresses.
show dsip version Displays DSIP version information.
show version Displays the configuration of the system hardware, the software version, the names
and sources of configuration files, and the boot images.
Cisco IOS Interface and Hardware Component Command Reference
1389
show controllers serial through show hw-module slot proc cpu
show dsip tracing
show dsip tracing
To display Distributed System Interconnect Protocol (DSIP) tracing buffer information, use the
showdsiptracingcommand in EXEC mode.
show dsip tracing [{control|data|ipc}] [{slot|entries entry-number [slot]}]
Syntax Description control (Optional) Displays the control tracing buffer.
data (Optional) Displays the data tracing buffer.
ipc (Optional) Displays the inter-process communication tracing buffer.
slot (Optional) Specifies a specific slot number on the dial shelf. Slot number can range
from 0 to 14.
entries entry-number (Optional) Specifies the number of entries to trace. Entries can be 1 to 500.
Command Modes EXEC
Command History Release Modification
11.3(2)AA This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This feature allows logging of DSIP media header information. Use the showdsiptracingcommand to obtain
important information of the various classes of DSIP packets (Control/Data/IPC) coming in. You must first
use the debugdsiptracing command then use the showdsiptracingcommand to display the logged contents.
To clear the information, use the cleardsiptracing command.
Examples The following is sample output from the showdsiptracingcommand:
Router# debug dsip tracing
DSIP tracing debugging is on
Router#
Router# show dsip tracing
Dsip Control Packet Trace:
----------------------------------------------------------------------------
Dest:00e0.b093.2238 Src:0007.5387.4808 Type:200B SrcShelf:1 SrcSlot:1 MsgType:0 MsgLen:82
Timestamp: 00:00:03
----------------------------------------------------------------------------
Dest:00e0.b093.2238 Src:0007.5387.4838 Type:200B SrcShelf:1 SrcSlot:7 MsgType:0 MsgLen:82
Timestamp: 00:00:03
----------------------------------------------------------------------------
Dest:00e0.b093.2238 Src:0007.4b67.8260 Type:200B SrcShelf:1 SrcSlot:12 MsgType:0 MsgLen:82
Timestamp: 00:00:03
----------------------------------------------------------------------------
Dest:00e0.b093.2238 Src:0007.5387.4858 Type:200B SrcShelf:1 SrcSlot:11 MsgType:0 MsgLen:82
Cisco IOS Interface and Hardware Component Command Reference
1390
show controllers serial through show hw-module slot proc cpu
show dsip tracing
Timestamp: 00:00:03
----------------------------------------------------------------------------
Dest:00e0.b093.2238 Src:0007.5387.4848 Type:200B SrcShelf:1 SrcSlot:9 MsgType:0 MsgLen:82
Timestamp: 00:00:03
The table below describes the significant fields shown in the display.
Table 104: show dsip tracing Field Descriptions
Field Description
Dest The destination MAC address in the DSIP packet.
Src The source MAC address in the DSIP packet.
Type There are three types of DSIP packets:
• Control--0x200B
• IPC--0x200C
• Data--0x200D
SrcShelf The source shelf ID of the DSIP packet.
SrcSlot The source slot of the DSIP packet.
MsgType Used to further demultiplex Data packets. Not used for Control and IPC type packets.
MsgLen Length of the message excluding the DSIP header.
Timestamp Time elapsed since the packet was received.
Related Commands Command Description
clear dsip tracing Clears DSIP tracing logs.
debug dsip tracing Enables DSIP trace logging for use with the show dsip tracing commands.
show dsip clients Lists the clients registered with DSIP on a system.
show dsip nodes Displays information about the nodes (slots) connected by DSIP on a system.
show dsip ports Displays information about local and remote ports.
show dsip queue Displays the number of messages in the retransmit queue waiting for
acknowledgment.
show dsip transport Displays information about the DSIP transport statistics for the control/data and IPC
packets and registered addresses.
show dsip version Displays DSIP version information.
Cisco IOS Interface and Hardware Component Command Reference
1391
show controllers serial through show hw-module slot proc cpu
show dsip transport
show dsip transport
To display information about the Distributed System Interconnect Protocol (DSIP) transport statistics for the
control/data and IPC packets and registered addresses, use the showdsiptransportcommand in EXEC mode.
show dsip transport
Syntax Description This command has no arguments or keywords.
Command Modes EXEC
Command History Release Modification
11.3(2)AA This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples The following is sample output from the showdsiptransportcommand:
Router# show dsip transport
DSIP Transport Statistics:
IPC : input msgs=4105, bytes=375628; output msgs=4105, bytes=248324
total consumed ipc msgs=669; total freed ipc msgs = 669
transmit contexts in use = 11, free = 245, zombie = 0, invalid = 0
ipc getmsg failures = 0, ipc timeouts=0
core getbuffer failures=0, api getbuffer failures=0
dsip test msgs rcvd = 1200, sent = 0
CNTL: input msgs=488, bytes=40104; output msgs=68, bytes=4080
getbuffer failures=0
DATA: input msgs=0, bytes=0; output msgs=426, bytes=5112
DSIP Private Buffer Pool Hits = 0
DSIP Registered Addresses:
Shelf0 : Master: 00e0.b093.2238, Status=local
Shelf1 : Slot1 : 0007.5387.4808, Status=remote
Shelf1 : Slot5 : 0007.5387.4828, Status=remote
Shelf1 : Slot6 : 0007.5387.4830, Status=remote
Shelf1 : Slot7 : 0007.5387.4838, Status=remote
Shelf1 : Slot8 : 0007.5387.4840, Status=remote
Shelf1 : Slot9 : 0007.5387.4848, Status=remote
Shelf1 : Slot11: 0007.5387.4858, Status=remote
Shelf1 : Slot12: 0007.4b67.8260, Status=remote
Router#
The table below describes the significant fields shown in the display:
Cisco IOS Interface and Hardware Component Command Reference
1392
show controllers serial through show hw-module slot proc cpu
show dsip transport
Table 105: show dsip transport Field Descriptions
Field Description
DSIP Transport Statistics: There are basically three kinds of communication channels between the DSIP
modules running on two processors:
1. IPC: DSIP IPC-based reliable/best-effort channel.
2. CNTL: Control packet channel for DSIP modules to communicate between
themselves. For example, keepalive messages and initial handshake
messages between two DSIP modules are exchanged over this channel.
3. DATA: DSIP fast data packet channel.
input msgs/output msgs The number of input/output packets on a particular channel.
bytes The number of input bytes received or sent on a particular channel.
total consumed ipc msgs The total number of IPC messages consumed so far from the IPC buffer pool.
total freed ipc msgs The total number of IPC messages returned to the IPC buffer pool so far.
transmit contexts in use DSIP for each active reliable connection to a remote port keeps a transmit
context. This context holds all the important information pertaining to the
remote connection, such as, destination portid, port name, number of message
and bytes sent to that port etc. This is created when first time a connection is
opened to a remote port and is reused for all subsequent communication to that
port.
free Free transmit context is available.
zombie When DSIP tears down a connection to a remote slot, all the transmit contexts
to that slot should return to the free pool. But instead of immediately returning
to the free pool, all such contexts first end up on a zombie queue, spend their
last few seconds here and then eventually return to the free queue.
invalid Each transmit context has a magic number. While returning contexts to the free
queue, if any transmit context is found to be corrupted, it is marked as invalid
and is not returned to the free queue.
ipc getmsg failures Number of times we failed to get an ipc message.
ipc timeouts The retry timeouts of the reliable DSIP transport stack.
core getbuffer failures The number of times DSIP transport layer has failed to allocate buffers for the
IPC transport.
aip getbuffer failures The number of times DSIP transport has failed to allocate buffers while
preparing to transmit data received from the clients.
dsip test msgs received/sent The DSIP test messages received and sent by invoking received/sent the “DSIP
Test” client.
Cisco IOS Interface and Hardware Component Command Reference
1393
show controllers serial through show hw-module slot proc cpu
show dsip transport
Field Description
DSIP Private Buffer Pool DSIP by default gets all its buffers from the public buffer pools. If for some
Hits reason, it runs out of those buffers, it falls back on a DSIP private pool. This
number indicates the number of times DSIP has used this fallback pool.
DSIP Registered Addresses The MAC addresses of nodes (slots) participating in DSIP communication
including the local node. The master sees N slaves whereas slave sees only
master (excluding themselves). The information is presented in the following
form:
ShelfX: Master | SlotY : MACAddress : Status= local | remote
Related Commands Command Description
show dsip clients Lists the clients registered with DSIP on a system.
show dsip nodes Displays information about the nodes (slots) connected by DSIP on a system.
show dsip ports Displays information about local and remote DSIP ports.
show dsip queue Displays the number of messages in the retransmit queue waiting for acknowledgment.
show dsip tracing Displays DSIP tracing buffer information.
show dsip version Displays DSIP version information.
show version Displays the configuration of the system hardware, the software version, the names
and sources of configuration files, and the boot images.
Cisco IOS Interface and Hardware Component Command Reference
1394
show controllers serial through show hw-module slot proc cpu
show dsip version
show dsip version
To display Distributed System Interconnect Protocol (DSIP) version information, use the
showdsipversioncommand in EXEC mode.
show dsip version
Syntax Description This command has no arguments or keywords.
Command Modes EXEC
Command History Release Modification
11.3(2)AA This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples The following is sample output from the showdsipversioncommand:
Router# show dsip version
DSIP version information:
------------------------
Local DSIP major version = 5, minor version = 2
All feature boards are running DSIP versions compatible with router shelf
Local Clients Registered Versions:
------------------------------------
Client Name Major Version Minor Version
Console 52
Clock 1 1
Modem 0 0
Logger No version No version
Trunk No version No version
Async data No version No version
TDM No version No version
DSIP Test No version No version
Mismatched Remote Client Versions:
-----------------------------------
DSIP is version-controlled software that should be identified and kept current.
Related Commands Command Description
show dsip clients Lists the clients registered with DSIP on a system.
show dsip nodes Displays information about the nodes (slots) connected by DSIP on a system.
Cisco IOS Interface and Hardware Component Command Reference
1395
show controllers serial through show hw-module slot proc cpu
show dsip version
Command Description
show dsip ports Displays information about local and remote DSIP ports.
show dsip queue Displays the number of messages in the retransmit queue waiting for
acknowledgment.
show dsip tracing Displays DSIP tracing buffer information.
show dsip transport Displays information about the DSIP transport statistics for the control/data and IPC
packets and registered addresses.
show version Displays the configuration of the system hardware, the software version, the names
and sources of configuration files, and the boot images.
Cisco IOS Interface and Hardware Component Command Reference
1396
show controllers serial through show hw-module slot proc cpu
show dtp interface
show dtp interface
To display the desktop publishing (DTP) interface details, use theshowdtpinterfacecommand in user EXEC
or privileged EXEC mode.
show dtp interface [type number]
Syntax Description type Interface type. For more information, use the question mark (?) online help function.
number Interface or subinterface number. For more information about the numbering syntax for your
networking device, use the question mark (?) online help function.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
12.4(22)T This command was introduced in a release earlier than Cisco IOS Release 12.4(22)T.
Examples The following is sample output from the showdtpinterface command:
Router# show dtp interface gigabitEthernet 0/0
DTP Interface Information:
TOS/TAS/TNS: ACCESS/UNKNOWN/ACCESS
TOT/TAT/TNT: UNKNOWN/UNKNOWN/UNKNOWN
Neighbor address 1: 000000000000
Neighbor address 2: 000000000000
Hello timer expiration ms/state: 0/STOPPED
Access timer expiration ms/state: 0/STOPPED
Negotiation timer expiration ms/state: 0/STOPPED
Multidrop timer expiration ms/state: 0/STOPPED
FSM state: S1:OFF
# times multi & trunk: 0
Enabled: 0
In STP: 0
The following is sample output from the showdtpinterface command on a Catalyst 3000 series
router:
Router# show dtp interface
DTP information for GigabitEthernet0/1:
TOS/TAS/TNS: ACCESS/AUTO/ACCESS
TOT/TAT/TNT: NATIVE/NEGOTIATE/NATIVE
Neighbor address 1: 000000000000
Neighbor address 2: 000000000000
Hello timer expiration (sec/state): 3/RUNNING
Access timer expiration (sec/state): never/STOPPED
Negotiation timer expiration (sec/state): never/STOPPED
Multidrop timer expiration (sec/state): never/STOPPED
FSM state: S2:ACCESS
# times multi & trunk 0
Enabled: yes
In STP: no
Statistics
Cisco IOS Interface and Hardware Component Command Reference
1397
show controllers serial through show hw-module slot proc cpu
show dtp interface
----------
112868 packets received (0 good)
112868 packets dropped
0 nonegotiate, 0 bad version, 112868 domain mismatches,
0 bad TLVs, 0 bad TAS, 0 bad TAT, 0 bad TOT, 0 other
225650 packets output (225650 good)
112825 native, 112825 software encap isl, 0 isl hardware native
0 output errors
0 trunk timeouts
1 link ups, last link up on Mon Mar 01 1993, 00:01:16
0 link downs
The table below describes the significant fields shown in the display.
Table 106: show dtp interface Field Descriptions
Field Description
TOS Indicates the Operational Trunk state of the port, except when the port is in the
Negotiation phase. In the Negotiation phase, the status is either Trunk or Access.
TAS Indicates the Trunk Admin state of the port, which is one of the following:
ON/OFF/AUTO/DESIRABLE.
TNS Indicates the Trunk Admin state to be sent in DTP packets when the port is in S3 or
S5 DTP negotiation state.
TAT Indicates the Trunk Admin (Encapsulation) Type of the port which is one of the
following: Negotiation/Native/ISL/DOT1Q
TOT Indicates the Trunk Operation Type or current Operational Encapsulation Type of the
port, which is one of the following: Native/ISL/DOT1Q.
TNT Indicates the Trunk Operational Type to be sent in DTP packets when the port is in
either S3 or S5 DTP negotiation state.
Neighbor address Indicates the MAC address of the neighbor connected or the Neighbor Port MAC
1/2 Address 1/2 in case of multi-neighbors on the same port.
Hello timer Indicates that a DTP advertisement is sent after the timer expires. The timer keeps
running as long as DTP is enabled and the port is capable of negotiating. The time
interval during negotiation is 1 second, and 30 seconds when the port is in spanning
tree protocol (STP) or has reached a final DTP state.
Access timer This timer is started when the port is in Trunk state, participates in STP (state S6), and
the mode is AUTO/DESIRABLE. When the timer expires, the port is set to Access
state. The interval for this timer is “10 * Hello Timer.” The interval gets reset/restarted
whenever the port (which is in S6 state) receives a DTP packet and confirms its present
state.
Negotiation timer This timer is started when the port enters into an S3 or S5 DTP negotiation state. When
the timer expires, the DTP state of the port moves into either Trunk/Non-Trunk.
The time interval is 3 seconds and the timer is restarted if the received DTP packet
changes the Trunk state or type.
Cisco IOS Interface and Hardware Component Command Reference
1398
show controllers serial through show hw-module slot proc cpu
show dtp interface
Field Description
Multidrop timer This timer is started when the port (which is in Trunk/AUTO/DESIRABLE mode)
detects multiple neighbors. The port is then configured as Access port or S4 state.
When the timer expires the port moves to negotiation or S2 state. After 3 seconds, port
stays in S4 state and manual intervention is needed to move it to Trunk state.
The interval for this timer is “10 * Hello Timer” and it gets reset or restarted whenever
the port receives a DTP packet from multiple neighbors.
FSM state Indicates the Finite State Machine State or DTP port state. There are 5 FSM states as
follows:
• S1: OFF: Physical port is not in the operational state. There is no data packet
transmission or receipt.
• S2: ACCESS: Port state is non-Trunk and is added to the STP.
• S3: NT-DTP: Port state is in negotiation phase. The port is not added to the STP
and there is no data packet transmission or receipt.
• S4: ACCESS-M: Port state is non-Trunk and is added to the STP. Port receives
the DTP packets from multiple neighbors.
• S5: T-DTP: Port is in ISL/.1Q Trunk mode. Port is not added to the STP and there
is no data packet transmission or receipt.
• S6: TRUNK: Port state is ISL/.1Q Trunk mode and is added to the STP.
Note In DTP, once the final state is negotiated, the port added to the STP is either
in Trunk or Access state.
# times multi & Indicates the presence of multi-neighbors and their count.
trunk
Enabled/Disabled Indicates if DTP is enabled or disabled
In STP Indicates if the port is added to the STP or not.
Related Commands Command Description
show interfaces trunk Displays interface trunking information.
Cisco IOS Interface and Hardware Component Command Reference
1399
show controllers serial through show hw-module slot proc cpu
show eobc
show eobc
To display the information about the Ethenet out-of-band channel (EOBC) interface, use the showeobc
command in user EXEC or privileged EXEC mode.
show eobc
Syntax Description This command has no arguments or keywords.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Examples This example shows how to display the information about the EOBC interface:
Router>
show eobc
EOBC0/0 is up, line protocol is up
Hardware is DEC21143, address is 0000.2100.0000 (bia 0000.2100.0000)
MTU 0 bytes, BW 100000 Kbit, DLY 100 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive not set
Unknown duplex, Unknown Speed, MII
ARP type: ARPA, ARP Timeout 04:00:00
Last input never, output 00:00:00, output hang never
Last clearing of "show interface" counters never
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 25/2147483647, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
172196 packets input, 11912131 bytes
Received 0 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 watchdog, 0 multicast
0 input packets with dribble condition detected
172144 packets output, 11363476 bytes, 0 underruns
0 output errors, 0 collisions, 1 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out
Interface EOBC0/0
Hardware is DEC21143
dec21140_ds=0x618FB938, registers=0x3C018000, ib=0x38A9180
rx ring entries=128, tx ring entries=256, af setup failed=0
rxring=0x38A9280, rxr shadow=0x618FBB20, rx_head=28, rx_tail=0
txring=0x38A9AC0, txr shadow=0x618FBD4C, tx_head=72, tx_tail=72, tx_count=0
Cisco IOS Interface and Hardware Component Command Reference
1400
show controllers serial through show hw-module slot proc cpu
show eobc
PHY link up
CSR0=0xF8024882, CSR1=0xFFFFFFFF, CSR2=0xFFFFFFFF, CSR3=0x38A9280
CSR4=0x38A9AC0, CSR5=0xF0660000, CSR6=0x320CA002, CSR7=0xF3FFA261
CSR8=0xE0000000, CSR9=0xFFFDC3FF, CSR10=0xFFFFFFFF, CSR11=0x0
CSR12=0xC6, CSR13=0xFFFF0000, CSR14=0xFFFFFFFF, CSR15=0x8FF80000
DEC21143 PCI registers:
bus_no=0, device_no=6
CFID=0x00191011, CFCS=0x02800006, CFRV=0x02000041, CFLT=0x0000FF00
CBIO=0x20000801, CBMA=0x48018000, CFIT=0x28140120, CFDD=0x00000400
MII registers:
Register 0x00: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Register 0x08: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Register 0x10: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Register 0x18: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
throttled=0, enabled=0, disabled=0
rx_fifo_overflow=0, rx_no_enp=0, rx_discard=0
tx_underrun_err=0, tx_jabber_timeout=0, tx_carrier_loss=0
tx_no_carrier=0, tx_late_collision=0, tx_excess_coll=0
tx_collision_cnt=0, tx_deferred=0, fatal_tx_err=0, tbl_overflow=0
HW addr filter: 0x38D2EE0, ISL Disabled
Entry= 0: Addr=0000.0000.0000
Entry= 1: Addr=0000.0000.0000
Entry= 2: Addr=0000.0000.0000
Entry= 3: Addr=0000.0000.0000
Entry= 4: Addr=0000.0000.0000
Entry= 5: Addr=0000.0000.0000
Entry= 6: Addr=0000.0000.0000
Entry= 7: Addr=0000.0000.0000
Entry= 8: Addr=0000.0000.0000
Entry= 9: Addr=0000.0000.0000
Entry=10: Addr=0000.0000.0000
Entry=11: Addr=0000.0000.0000
Entry=12: Addr=0000.0000.0000
Entry=13: Addr=0000.0000.0000
Entry=14: Addr=0000.0000.0000
Entry=15: Addr=0000.2100.0000
Router>
This example shows how to display the information about the EOBC interface but excludes lines
that contain the word output:
Router>
show eobc
| exclude output
EOBC0/0 is up, line protocol is up
Hardware is DEC21143, address is 0000.2100.0000 (bia 0000.2100.0000)
MTU 0 bytes, BW 100000 Kbit, DLY 100 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive not set
Unknown duplex, Unknown Speed, MII
ARP type: ARPA, ARP Timeout 04:00:00
Last clearing of "show interface" counters never
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 25/2147483647, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
175919 packets input, 12196443 bytes
Received 0 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 watchdog, 0 multicast
0 input packets with dribble condition detected
0 babbles, 0 late collision, 0 deferred
Cisco IOS Interface and Hardware Component Command Reference
1401
show controllers serial through show hw-module slot proc cpu
show eobc
0 lost carrier, 0 no carrier
Interface EOBC0/0
Hardware is DEC21143
dec21140_ds=0x618FB938, registers=0x3C018000, ib=0x38A9180
rx ring entries=128, tx ring entries=256, af setup failed=0
rxring=0x38A9280, rxr shadow=0x618FBB20, rx_head=7, rx_tail=0
txring=0x38A9AC0, txr shadow=0x618FBD4C, tx_head=209, tx_tail=209, tx_count=0
PHY link up
CSR0=0xF8024882, CSR1=0xFFFFFFFF, CSR2=0xFFFFFFFF, CSR3=0x38A9280
CSR4=0x38A9AC0, CSR5=0xF0660000, CSR6=0x320CA002, CSR7=0xF3FFA261
CSR8=0xE0000000, CSR9=0xFFFDC3FF, CSR10=0xFFFFFFFF, CSR11=0x0
CSR12=0xC6, CSR13=0xFFFF0000, CSR14=0xFFFFFFFF, CSR15=0x8FF80000
DEC21143 PCI registers:
bus_no=0, device_no=6
CFID=0x00191011, CFCS=0x02800006, CFRV=0x02000041, CFLT=0x0000FF00
CBIO=0x20000801, CBMA=0x48018000, CFIT=0x28140120, CFDD=0x00000400
MII registers:
Register 0x00: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Register 0x08: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Register 0x10: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
Register 0x18: FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF
throttled=0, enabled=0, disabled=0
rx_fifo_overflow=0, rx_no_enp=0, rx_discard=0
tx_underrun_err=0, tx_jabber_timeout=0, tx_carrier_loss=0
tx_no_carrier=0, tx_late_collision=0, tx_excess_coll=0
tx_collision_cnt=0, tx_deferred=0, fatal_tx_err=0, tbl_overflow=0
HW addr filter: 0x38D2EE0, ISL Disabled
Entry= 0: Addr=0000.0000.0000
Entry= 1: Addr=0000.0000.0000
Entry= 2: Addr=0000.0000.0000
Entry= 3: Addr=0000.0000.0000
Entry= 4: Addr=0000.0000.0000
Entry= 5: Addr=0000.0000.0000
Entry= 6: Addr=0000.0000.0000
Entry= 7: Addr=0000.0000.0000
Entry= 8: Addr=0000.0000.0000
Entry= 9: Addr=0000.0000.0000
Entry=10: Addr=0000.0000.0000
Entry=11: Addr=0000.0000.0000
Entry=12: Addr=0000.0000.0000
Entry=13: Addr=0000.0000.0000
Entry=14: Addr=0000.0000.0000
Entry=15: Addr=0000.2100.0000
Router>
Related Commands Command Description
show environment alarm Displays the information about the environmental alarm.
show environment status Displays the information about the operational FRU status.
Cisco IOS Interface and Hardware Component Command Reference
1402
show controllers serial through show hw-module slot proc cpu
show errdisable detect
show errdisable detect
To display the error-disable detection status, use the show errdisable detect command in user EXEC or
privileged EXEC mode.
show errdisable detect
Syntax Description This command has no arguments or keywords.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17b)SXA This command was changed to include packet-buffer error status information.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release
12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Examples This example shows how to display the error-disable detection status:
Router>
show errdisable detect
ErrDisable Reason Detection status
----------------- ----------------
udld Enabled
bpduguard Enabled
rootguard Enabled
packet-buffer-err Enabled
pagp-flap Enabled
dtp-flap Enabled
link-flap Enabled
Router#
Related Commands Command Description
errdisable detect cause Enables the error-disable detection.
Cisco IOS Interface and Hardware Component Command Reference
1403
show controllers serial through show hw-module slot proc cpu
show errdisable recovery
show errdisable recovery
To display the information about the error-disable recovery timer, use the show errdisable recovery command
in EXEC mode.
show errdisable recovery
Syntax Description This command has no arguments or keywords.
Command Default This command has no default settings.
Command Modes EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Examples This example shows how to display the information about the error-disable recovery timer:
Router#
show errdisable recovery
ErrDisable Reason Timer Status
----------------- --------------
udld Enabled
bpduguard Enabled
rootguard Enabled
pagp-flap Enabled
dtp-flap Enabled
link-flap Enabled
Timer interval:300 seconds
Interfaces that will be enabled at the next timeout:
Interface Errdisable reason Time left(sec)
--------- ----------------- --------------
Fa9/4 link-flap 279
Related Commands Command Description
errdisable recovery Configures the recovery mechanism variables.
show interfaces status Displays the interface status or a list of interfaces in an error-disabled state on
LAN ports only.
Cisco IOS Interface and Hardware Component Command Reference
1404
show controllers serial through show hw-module slot proc cpu
show esmc
show esmc
To display the Ethernet synchronization message channel (ESMC) processes on a device, use the show esmc
command in privileged EXEC mode.
show esmc [{detail|interface type number}]
Syntax Description detail (Optional) Provides a detailed display of ESMC processes.
interface type number (Optional) Specifies the interface type and interface number. For more information,
use the question mark (?) online help function.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.0(1)S This command was introduced.
15.1(2) SNI This command was introduced into Cisco ASR 901 Aggregation Services
Router.
Cisco IOS XE Release 3.8S This command was integrated into Cisco IOS XE Release 3.8S.
Examples The following example shows the ESMC processes enabled on a device:
Device# show esmc detail
Interface: GigabitEthernet0/0/0
Administrative configurations:
Mode: Synchronous
ESMC TX: Enable
ESMC RX : Enable
QL RX configured : NA
QL TX configured : NA
Operational status:
Port status: UP
QL Receive: QL-SSU-B
ESMC Information rate : 1 packet/second
ESMC Expiry: 5 second
The table below describes the significant fields shown in the display.
Table 107: show esmc Field Descriptions
Field Description
Mode Synchronous or asynchronous mode of packet transmission.
ESMC TX Option for transmitting ESMC data.
ESMC RX Option for receiving ESMC data.
Cisco IOS Interface and Hardware Component Command Reference
1405
show controllers serial through show hw-module slot proc cpu
show esmc
Field Description
QL RX configured Quality level receive configuration.
QL TX configured Quality level transmit configuration.
ESMC Information rate Rate at which ESMC information Protocol Data Unit (PDU) is transmitted in packet
per second.
ESMC Expiry Duration in which the ESMC receipt is expired.
Related Commands Command Description
esmc mode ql-disabled Disables the ESMC on an interface.
esmc process Enables the ESMC process in a device.
show interfaces accounting Displays the number of packets of each protocol type that have been sent
through all configured interfaces.
Cisco IOS Interface and Hardware Component Command Reference
1406
show controllers serial through show hw-module slot proc cpu
show etherchannel
show etherchannel
To display EtherChannel information for a channel, use the showetherchannel command in privileged EXEC
mode.
Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers
show etherchannel [channel-group] {port-channel|brief|detail|summary|port|load-balance}
Cisco Catalyst Switches
show etherchannel [channel-group] {port-channel|brief|detail|summary|port|load-balance|protocol}
[expression]
Syntax Description channel -group (Optional) Number of the channel group. If you do not specify a value for the channel
-group argument, all channel groups are displayed.
port -channel Displays port channel information.
brief Displays a summary of EtherChannel information.
detail Displays detailed EtherChannel information.
summary Displays a one-line summary per channel group.
port Displays EtherChannel port information.
load -balance Displays load-balance information.
protocol Displays the enabled protocol.
expression (Optional) Expression in the output to use as a reference point.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.0(7)XE This command was introduced on Cisco Catalyst 6000 family switches.
12.1(3a)E3 This command was modified. The number of valid values for the channel -group argument
were changed.
12.1(5c)EX This command was modified. The number of valid values for the channel-group argument
were changed.
12.2(2)XT This command was modified to support switchport creation on Cisco 2600 series, Cisco 3600
series, and Cisco 3700 series routers.
12.2(14)SX This command was implemented on the Supervisor Engine 720.
12.2(17a)SX1 This command was modified. The output of the showetherchannelload-balance command
was changed to include IPv6 information. The display was changed to include Multiprotocol
Label Switching (MPLS) information.
Cisco IOS Interface and Hardware Component Command Reference
1407
show controllers serial through show hw-module slot proc cpu
show etherchannel
Release Modification
12.2(17d)SXB This command was modified to support the Supervisor Engine 2.
12.2(8)T This command was modified to support switchport creation.
12.2(33)SXH This command was modified. The output of the showetherchannelport-channel and the
showetherchanneldetailcommands was changed to include Link Aggregation Control
Protocol (LACP) fast switchover status. The number of valid values for the channel -group
argument was changed.
12.2(33)SRC This command was modified. The output of the showetherchannelport-channel and the
showetherchanneldetailcommands was changed to show the status of the LACP Single
Fault Direct Load Balance Swap feature, to show the last applied hash distribution algorithm,
and to include LACP fast switchover status.
12.2(33)SXI3 This command was modified. The output of the showetherchannelsummary,
showetherchannelport-channel, and showetherchanneldetail commands was changed to
show the standalone disable option.
Usage Guidelines Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers
The channel-group argument supports six EtherChannels and eight ports in each channel.
If you do not specify a value for the channel-group argument, all channel groups are displayed.
Cisco Catalyst Switches
The number of valid values for the channel-group argument depends on the software release. For software
releases prior to Cisco IOS Release 12.1(3a)E3, valid values are from 1 to 256; for Cisco IOS Release
12.1(3a)E3, 12.1(3a)E4, and 12.1(4)E1, valid values are from 1 to 64. Cisco IOS Release 12.1(5c)EX and
later support a maximum of 64 values ranging from 1 to 256. Cisco IOS Release 12.2(33)SXH supports a
maximum of 64 values ranging fro m 1 to 282.
If you do not specify a value for the channel-group argument, all channel groups are displayed.
In the output, the Passive port list field is displayed for Layer 3 port channels only. This field means that the
physical interface, which is still not up, is configured to be in the channel group (and indirectly in the only
port channel in the channel group).
The channel-groupvalues from 257 to 282 are supported on the Catalyst 6500 series Cisco Services Module
(CSM) and the Catalyst 6500 series Firewall Services Module (FWSM) only.
In the output, the Passive port list field is displayed for Layer 3 port channels only. This field means that the
physical interface, which is still not up, is configured to be in the channel group (and indirectly is the only
port channel in the channel group).
If the interface is configured as part of the channel in ON mode, theshowetherchannelprotocol command
displays Protocol: - (Mode ON).
In the output of the showetherchannelsummary command, the following conventions apply:
• In the column that displays the protocol that is used for the channel, if the channel mode is ON, a hyphen
(-) is displayed.
• For LACP, multiple aggregators are supported. For example, if two different bundles are created, Po1
indicates the primary aggregator, and Po1A and Po1B indicates the secondary aggregators.
Cisco IOS Interface and Hardware Component Command Reference
1408
show controllers serial through show hw-module slot proc cpu
show etherchannel
In the output of the showetherchannelload-balance command, the following conventions apply:
• For EtherChannel load balancing of IPv6 traffic, if the traffic is bridged onto an EtherChannel (for
example, it is a Layer 2 channel and traffic in the same VLAN is bridged across it), the traffic is always
load balanced by the IPv6 addresses or src, dest, or src-dest, depending on the configuration. For this
reason, the switch ignores the MAC/IP/ports for bridged IPv6 traffic. If you configure src-dst-mac, the
src-dst-ip(v6) address is displayed. If you configure src-mac, the src-ip(v6) address is displayed.
• IPv6 traffic that is routed over a Layer 2 or a Layer 3 channel is load balanced based on MAC addresses
or IPv6 addresses, depending on the configuration. The MAC/IP and the src/dst/src-dst are supported,
but load balancing that is based on Layer 4 ports is not supported. If you use the port keyword, the IPv6
addresses or either src, dst, or src-dst, is displayed.
Examples
Protocol Information
The following example shows how to display the enabled protocol:
Router# show etherchannel protocol
Channel-group listing:
-----------------------
Group: 12
----------
Protocol: PAgP
Group: 24
----------
Protocol: - (Mode ON)
Router#
Port Channel Information for a Specific Group
The following example shows how to display port channel information for a specific group:
Router# show etherchannel 12 port-channel
Group: 12
----------
Port-channels in the group:
----------------------
Port-channel: Po1
------------
Age of the Port-channel = 143h:01m:12s
Logical slot/port = 14/1 Number of ports = 2
GC = - HotStandBy port = null
Port state = Port-channel Ag-Inuse
Protocol = LACP
Fast-switchover = enabled
Ports in the Port-channel:
Index Load Port EC state
------+------+------+------------
0 55 Fa4/1 active
1 AA Fa4/2 active
Time since last port bundled: 16h:28m:58s Fa4/1
Time since last port Un-bundled: 16h:29m:00s Fa4/4
The following example shows that direct load swapping is enabled.
Cisco IOS Interface and Hardware Component Command Reference
1409
show controllers serial through show hw-module slot proc cpu
show etherchannel
Router# show etherchannel 15 port-channel
Port-channels in the group:
Port-channel: Po15 (Primary Aggregator)
Age of the Port-channel = 0d:18h:16m:49s
Logical slot/port = 14/7 Number of ports = 1
HotStandBy port = null
Port state = Port-channel Ag-Inuse
Protocol = LACP
! The following line of output is added with support
of the LACP Single Fault Direct Load Swapping feature. !
Direct Load Swap = enabled
Ports in the Port-channel:
Index Load Port EC state No of bits
------+------+------+------------------+-----------
0 FF Fa4/1 Active 8
Time since last port bundled: 0d:00h:06m:12s Fa4/1
Load Balancing
The following examples show how to display load-balancing information:
Router#
show etherchannel load-balance
Source XOR Destination mac address
Router#
show etherchannel load-balance
EtherChannel Load-Balancing Configuration:
dst-mac
mpls label-ip
EtherChannel Load-Balancing Addresses Used Per-Protocol:
Non-IP: Destination MAC address
IPv4: Destination MAC address
IPv6: Destination MAC address (routed packets)
Destination IP address (bridged packets)
MPLS: Label or IP
Summary Information for a Specific Group
The following example shows how to display a summary of information for a specific group:
Router#
show etherchannel 1 brief
Group state = L3
Ports: 2 Maxports = 8
port-channels: 1 Max port-channels = 1
Partner’s information:
The following example shows the hash distribution algorithm that was last applied:
Router# show etherchannel
10 summary
Flags: D - down P - bundled in port-channel
I - stand-alone s - suspended
H - Hot-standby (LACP only)
R - Layer3 S - Layer2
U - in use N - not in use, no aggregation
f - failed to allocate aggregator
Cisco IOS Interface and Hardware Component Command Reference
1410
show controllers serial through show hw-module slot proc cpu
show etherchannel
<snip>
Group Port-channel Protocol Ports
------+-------------+-----------+-----------------------------------------------
10 Po10(RU) LACP Gi3/7(P) Gi3/9(P)
! The following line of output is added with support
of the EtherChannel Load Distribution feature. !
Last applied Hash Distribution Algorithm: Fixed
Router#
Detailed Information for a Specific Group
The following example shows how to display detailed information for a specific group:
Router#
show etherchannel 12 detail
Group state = L2
Ports: 1 Maxports = 8
Port-channels: 1 Max Port-channels = 1
Protocol: PAgP
Fast-switchover = enabled
Ports in the group:
-------------------
Port: Fa5/2
------------
Port state = Down Not-in-Bndl
Channel group = 12 Mode = Desirable-Sl Gcchange = 0
Port-channel = null GC = 0x00000000 Pseudo port-channel = Po1
2
Port index = 0 Load = 0x00 Protocol = PAgP
Flags: S - Device is sending Slow LACPDUs F - Device is sending fast LACPDUs
A - Device is in active mode P - Device is in passive mode
Local information:
LACP Port Admin Oper Port Port
Port Flags State Priority Key Key Number State
Fa4/1 SA bndl 32768 100 100 0xc1 0x75
Partner’s information:
Partner Partner Partner
Port System ID Port Number Age Flags
Fa4/1 8000,00b0.c23e.d861 0x81 14s SP
LACP Partner Partner Partner
Port Priority Oper Key Port State
32768 128 0x81
Age of the port in the current state: 16h:27m:42s
Port-channels in the group:
----------------------
Port-channel: Po12
------------
Age of the Port-channel = 04d:02h:52m:26s
Logical slot/port = 14/1 Number of ports = 0
GC = 0x00000000 HotStandBy port = null
Port state = Port-channel Ag-Not-Inuse
Protocol = PAgP
Note When LACP 1:1 redundancy is configured, the showetherchanneldetail command also displays
fast-switchover status information.
Cisco IOS Interface and Hardware Component Command Reference
1411
show controllers serial through show hw-module slot proc cpu
show etherchannel
One-Line Summary per Channel Group
The following example shows how to display a one-line summary per channel group:
Router#
show etherchannel summary
U-in use I-in port-channel S-suspended D-down i-stand-alone d-default
Group Port-channel Ports
----- ------------ ----------------------------------------------------------
1 Po1(U) Fa5/4(I) Fa5/5(I)
2 Po2(U) Fa5/6(I) Fa5/7(I)
255 Fa5/9(i)
256 Fa5/8(i)
Port Information for All Groups
The following example shows how to display EtherChannel port information for all ports and all
groups:
Router#
show etherchannel port
Channel-group listing:
-----------------------
Group: 1
----------
Ports in the group:
-------------------
Port: Fa5/4
------------
Port state = EC-Enbld Down Not-in-Bndl Usr-Config
Channel group = 1 Mode = Desirable Gcchange = 0
Port-channel = null GC = 0x00000000 Psudo-agport = Po1
Port indx = 0 Load = 0x00
Flags: S - Device is sending Slow hello. C - Device is in Consistent state.
A - Device is in Auto mode. P - Device learns on physical port.
Timers: H - Hello timer is running. Q - Quit timer is running.
S - Switching timer is running. I - Interface timer is running.
Local information:
Hello Partner PAgP Learning Group
Port Flags State Timers Interval Count Priority Method Ifindex
Fa5/4 d U1/S1 1s 0 128 Any 0
Age of the port in the current state: 02h:40m:35s
Port: Fa5/5
------------
Port state = EC-Enbld Down Not-in-Bndl Usr-Config
Channel group = 1 Mode = Desirable Gcchange = 0
Port-channel = null GC = 0x00000000 Psudo-agport = Po1
Port indx = 0 Load = 0x00
Flags: S - Device is sending Slow hello. C - Device is in Consistent state.
A - Device is in Auto mode. P - Device learns on physical port.
Timers: H - Hello timer is running. Q - Quit timer is running.
S - Switching timer is running. I - Interface timer is running.
Cisco IOS Interface and Hardware Component Command Reference
1412
show controllers serial through show hw-module slot proc cpu
show etherchannel
Port Information for a Specific Group
The following example shows how to display the information about the EtherChannel port for a
specific group:
Router#
show etherchannel 1 port
Channel-group listing:
-----------------------
Group: 1
----------
Ports in the group:
-------------------
Port: Fa5/4
------------
Port state = EC-Enbld Down Not-in-Bndl Usr-Config
Channel group = 1 Mode = Desirable Gcchange = 0
Port-channel = null GC = 0x00000000 Psudo-agport = Po1
Port index = 0 Load = 0x00 Protocol = LACP
Flags: S - Device is sending Slow LACPDUs F - Device is sending fast LACPDUs
A - Device is in active mode P - Device is in passive mode
Local information:
LACP Port Admin Oper Port Port
Port Flags State Priority Key Key Number State
Fa5/4 SA bndl 32768 100 100 0xc1 0x75
Partner’s information:
Partner Partner Partner
Port System ID Port Number Age Flags
Fa5/4 8000,00b0.c23e.d861 0x81 14s SP
LACP Partner Partner Partner
Port Priority Oper Key Port State
32768 128 0x81
Age of the port in the current state: 04d:02h:57m:38s
Port Channel Information for the Standalone Disabled Option
The following example shows the showetherchannelsummary command output with a port in
suspended state:
Router# show etherchannel 42 summary
Flags: D - down P - bundled in port-channel
I - stand-alone s - suspended
H - Hot-standby (LACP only)
R - Layer3 S - Layer2
U - in use f - failed to allocate aggregator
M - not in use, minimum links not met
u - unsuitable for bundling
w - waiting to be aggregated
Number of channel-groups in use: 8
Number of aggregators: 8
Group Port-channel Protocol Ports
------+-------------+-----------+-----------------------------------------------
2 Po42(SU) LACP Fa1/17(s) Fa1/18(P) Fa1/19(P) Fa1/20(P)
The following example shows the showetherchannelport-channel command output with the status
of Standalone Disable option:
Router# show etherchannel 42 port-channel
Cisco IOS Interface and Hardware Component Command Reference
1413
show controllers serial through show hw-module slot proc cpu
show etherchannel
Port-channels in the group:
----------------------
Port-channel: Po42 (Primary Aggregator)
------------
Age of the Port-channel = 0d:21h:28m:22s
Logical slot/port = 14/42 Number of ports = 3
HotStandBy port = null
Port state = Port-channel Ag-Inuse
Protocol = LACP
Fast-switchover = disabled
Load share deferral = disabled
Standalone Disable = enabled
Ports in the Port-channel:
Index Load Port EC state No of bits
------+------+------------+------------------+-----------
2 49 Fa1/18 Active 3
1 92 Fa1/19 Active 3
3 24 Fa1/20 Active 2
Time since last port bundled: 0d:03h:37m:07s Fa1/18
Time since last port Un-bundled: 0d:03h:34m:27s Fa1/17
Last applied Hash Distribution Algorithm: Fixed
The following example shows the showetherchanneldetail command output with the status of
Standalone Disable option:
Router# show etherchannel 42 detail
Group state = L2
Ports: 4 Maxports = 16
Port-channels: 1 Max Port-channels = 16
Protocol: LACP
Minimum Links: 2
Standalone Disable: enabled
Ports in the group:
-------------------
Port: Fa1/17
------------
Port state = Up Cnt-bndl Suspend Not-in-Bndl
Channel group = 42 Mode = Active Gcchange = -
Port-channel = null GC = - Pseudo port-channel = Po2
Port index = 0 Load = 0x00 Protocol = LACP
Flags: S - Device is sending Slow LACPDUs F - Device is sending fast LACPDUs.
A - Device is in active mode. P - Device is in passive mode.
Local information:
LACP port Admin Oper Port Port
Port Flags State Priority Key Key Number State
Fa1/17 FP susp 1 0x2 0x2 0x112 0x82
Partner's information:
Partner Partner LACP Partner Partner Partner Partner Partner
Port Flags State Port Priority Admin Key Oper Key Port Number Port State
Fa1/17 FP susp 1 0x0 0x2 0x312 0x36
Age of the port in the current state: 0d:03h:44m:04s
Port: Fa1/18
------------
Port state = Up Mstr In-Bndl
Channel group = 42 Mode = Active Gcchange = -
Port-channel = Po2 GC = - Pseudo port-channel = Po2
Port index = 2 Load = 0x49 Protocol = LACP
Flags: S - Device is sending Slow LACPDUs F - Device is sending fast LACPDUs.
A - Device is in active mode. P - Device is in passive mode.
Local information:
LACP port Admin Oper Port Port
Port Flags State Priority Key Key Number State
Cisco IOS Interface and Hardware Component Command Reference
1414
show controllers serial through show hw-module slot proc cpu
show etherchannel
Fa1/18 SA bndl 2 0x2 0x2 0x113 0x3D
Partner's information:
Partner Partner LACP Partner Partner Partner Partner Partner
Port Flags State Port Priority Admin Key Oper Key Port Number Port State
Fa1/18 SA bndl 2 0x0 0x2 0x313 0x3D
Age of the port in the current state: 0d:03h:43m:24s
Port-channels in the group:
Port-channel: Po42 (Primary Aggregator)
Age of the Port-channel = 0d:21h:34m:45s
Logical slot/port = 14/42 Number of ports = 3
HotStandBy port = null
Port state = Port-channel Ag-Inuse
Protocol = LACP
Fast-switchover = disabled
Load share deferral = disabled
Standalone Disable = enabled
Ports in the Port-channel:
Index Load Port EC state No of bits
------+------+------------+------------------+-----------
2 49 Fa1/18 Active 3
1 92 Fa1/19 Active 3
3 24 Fa1/20 Active 2
Time since last port bundled: 0d:03h:43m:30s Fa1/18
Time since last port Un-bundled: 0d:03h:40m:50s Fa1/17
Last applied Hash Distribution Algorithm: Fixed
Related Commands Command Description
channel-group Assigns and configures an EtherChannel interface to an EtherChannel group.
channel-protocol Sets the protocol that is used on an interface to manage channeling.
interface port-channel Accesses or creates the IDB port channel.
Cisco IOS Interface and Hardware Component Command Reference
1415
show controllers serial through show hw-module slot proc cpu
show etherchannel load-balancing
show etherchannel load-balancing
To display the load-balancing method applied to Gigabit EtherChannel (GEC) interfaces, use the
showetherchannelload-balancing command in user EXEC or privileged EXEC mode.
show etherchannel load-balancing
Syntax Description This command has no arguments or keywords.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
Cisco IOS XE Release 2.1 This command was introduced.
Cisco IOS XE Release 2.5 This command was modified. Information about the port-channel configuration
and flow-based load balancing was added to the output.
Usage Guidelines The showetherchannelload-balancing command shows which load-balancing method is applied to the port
channels of a GEC interface, both at the global level and for each port channel.
There are two methods of load balancing on a GEC interface:
• VLAN-manual--All packets forwarded over the same VLAN subinterface are considered part of the
same flow and are mapped to the member link specified in the configuration.
• Flow-based--Traffic flows are mapped to different member links based on the packet header.
Examples The following example shows output from this command for a port channel configured with
VLAN-manual load balancing:
Router# show etherchannel load-balancing
EtherChannel Load-Balancing Method:
Global LB Method: vlan-manual
Port-Channel: LB Method
Port-channel1 : vlan-manual
The table below describes the significant fields shown in the display.
Table 108: show etherchannel load-balancing Field Descriptions
Field Description
Global LB Method Load balancing method set globally for all port channels with the
port-channelload-balancingvlan-manual command.
Port Channel LB Method Load balancing method set for the specific port channels with the
load-balancingcommand. This configuration takes precedence over the global
configuration.
Cisco IOS Interface and Hardware Component Command Reference
1416
show controllers serial through show hw-module slot proc cpu
show etherchannel load-balancing
Related Commands Command Description
load-balancing Applies a load-balancing method to a GEC interface.
port-channel load-balancing vlan-manual Applies the VLAN-manual load-balancing method globally
to all GEC interfaces.
show interfaces port-channel etherchannel Displays the load-balancing bucket distribution currently in
use for a GEC interface.
Cisco IOS Interface and Hardware Component Command Reference
1417
show controllers serial through show hw-module slot proc cpu
show fabric
show fabric
To display the information about the crossbar fabric, use the showfabric command in EXEC mode.
show fabric [active]
show fabric {channel-counters|errors|status} [{slot|all}]
show fabric switching-mode [module {slot|all}]
show fabric utilization [{slot|all}]
Syntax Description active (Optional) Displays the redundancy status for the Switch Fabric Module.
channel-counters Displays the fabric channel-counter information.
errors Displays the errors that are associated with the crossbar fabric; see the “Usage
Guidelines” section for additional information.
status Displays the current status of the fabric channel.
slot (Optional) Number of the slot.
all (Optional) Displays the information for all modules using the crossbar fabric.
switching-mode Displays the module switching mode; see the “Usage Guidelines” section for additional
information.
module slot (Optional) Displays the switching mode for the specified slot.
module all (Optional) Displays the switching mode for all installed modules.
utilization Displays the percentage utilization for each fabric channel.
Command Default This command has no default settings.
Command Modes EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine
32.
If you specify slot, the information is displayed for the specified slot. If you specify all, the information for
all slots using the crossbar fabric is displayed. If you do not specify slot or all, the display is the same as if
you entered all.
To display all the related crossbar fabric information, enter the showfabric command without keywords.
Cisco IOS Interface and Hardware Component Command Reference
1418
show controllers serial through show hw-module slot proc cpu
show fabric
A fabric channel is each connection between a module and the crossbar fabric module. Each module can have
zero, one, or two fabric channels. The more fabric channels that a module has, the more overall bandwidth is
available to the module.
The following errors are associated with the crossbar fabrics:
• Synchronization errors--General errors are the most common types of errors.
• Heartbeat errors--The supervisor engine sends out periodic heartbeat packets to each module using the
crossbar fabric. If any of these modules or the crossbar fabric fail to detect heartbeat packets for a period
of time, this error is reported.
• CRC errors--All packets crossing the crossbar fabric are CRC protected. If any of the ASICs between a
module and the crossbar fabric module detect a CRC error, this error is reported.
The three types of fabric switching modes are as follows:
• Bus--Packets that travel across the traditional backplane and that are shared by all modules to be switched
by the supervisor engine. Modules without the crossbar fabric connectors are restricted to this mode. The
48-port 10/100TX RJ-45 module is an example of this module type.
• Crossbar--Packets with headers only that travel across the traditional backplane to be switched by the
supervisor engine and that travel across the crossbar fabric. The 16-port Gigabit Ethernet GBIC switching
module is an example of this module type.
• dCEF--Packets that are switched by the module and that travel across the crossbar fabric. The 16-port
Gigabit Ethernet GBIC switching module and the 16-port Gigabit Ethernet module are examples of this
module type. The 16-port Gigabit Ethernet GBIC switching module can be in any of these three modes,
but the 16-port Gigabit Ethernet module can only be in dCEF mode.
The threshold information is shown only when you enter the nofabricswitching-modeallowtruncated
command.
In the showfabricswitching-mode command output, the possible global switching modes are as follows:
• Flow-through (Bus)--Mode that the switch uses for traffic between nonfabric-enabled modules and for
traffic between a nonfabric-enabled module and a fabric-enabled module. In this mode, all traffic passes
between the local bus and the supervisor engine bus.
• Truncated--Mode that the switch uses for traffic between fabric-enabled modules when both fabric-enabled
and nonfabric-enabled modules are installed. In this mode, the switch sends a truncated version of the
traffic (the first 64 bytes of the frame) over the switch fabric channel.
• Compact--Mode that the switch uses for all traffic when only fabric-enabled modules are installed. In
this mode, a compact version of the DBus header is forwarded over the switch fabric channel, which
provides the best possible performance.
In the showfabricswitching-mode command output , depending on the supervisor engine installed, the
following messages appear:
• With a Supervisor Engine 2, this message is included in the output:
An enabled Switch Fabric is not required for the system to operate
• With a Supervisor Engine 720, this message is included in the output:
Cisco IOS Interface and Hardware Component Command Reference
1419
show controllers serial through show hw-module slot proc cpu
show fabric
Fabric module is not required for system to operate
Examples This example shows how to display the redundancy status of the Switch Fabric Module:
Router# show fabric active
Active fabric card in slot 5
No backup fabric card in the system
Router#
This example shows how to display the channel-counter information:
Router# show fabric channel-counters
slot channel rxErrors txErrors txDropped
1 0 0 0 0
Router#
This example shows how to display the errors that are associated with the crossbar fabric:
Router# show fabric errors
Module errors:
slot channel crc hbeat sync DDR sync
1 0 0 0 0 0
8 0 0 0 0 0
8 0 0 0 0 0
9 0 0 0 0 0
Fabric errors:
slot channel sync buffer timeout
1 0 0 0 0
8 0 0 0 0
8 0 0 0 0
9 0 0 0 0
Router#
This example shows how to display the module switching mode:
Router# show fabric switching-mode
Global switching mode is Truncated
An enabled Switch Fabric is not required for the system to operate
Modules are allowed to operate in bus mode
Truncated mode is not allowed unless threshold is met
Threshold for truncated mode operation is 2 SFM-capable cards
Module Slot Switching Mode
1 Bus
2 Crossbar
3 Crossbar
4 Bus
5 No Interfaces
7 DCEF
9 DCEF
Router#
This example shows how to display the fabric-channel status:
Router# show fabric status
slot channel speed module fabric
status status
1 0 8G OK OK
5 0 8G OK Up- Timeout
6 0 20G OK Up- BufError
Cisco IOS Interface and Hardware Component Command Reference
1420
show controllers serial through show hw-module slot proc cpu
show fabric
8 0 8G OK OK
8 1 8G OK OK
9 0 8G Down- DDRsync OK
Router#
This example shows how to display the percentage utilizations for all fabric-enabled channels:
Router# show fabric utilization all
slot channel Ingress % Egress %
1 0 0 0
crc hbeat sync sync
1 0 0 0 0 0
Router#
Cisco IOS Interface and Hardware Component Command Reference
1421
show controllers serial through show hw-module slot proc cpu
show fm features
show fm features
To display the information about the feature manager, use the showfmfeatures command in user EXEC or
privileged EXEC mode.
show fm features
Syntax Description This command has no arguments or keywords.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Examples This example shows how to display the information about the feature manager:
Router>
show fm features
Designated MSFC:1 Non-designated MSFC:1
Redundancy Status:designated
Interface:FastEthernet2/10 IP is enabled
hw[EGRESS] = 1, hw[INGRESS] = 1
hw_force_default[EGRESS] = 0, hw_force_default[INGRESS] = 0
mcast = 0
priority = 2
reflexive = 0
inbound label:1
protocol:ip
feature #:1
feature id:FM_IP_ACCESS
ACL:106
outbound label:2
protocol:ip
feature #:1
feature id:FM_IP_ACCESS
ACL:106
Interface:FastEthernet2/26 IP is enabled
hw[EGRESS] = 1, hw[INGRESS] = 0
hw_force_default[EGRESS] = 0, hw_force_default[INGRESS] = 1
mcast = 0
priority = 2
reflexive = 0
inbound label:24
protocol:ip
feature #:1
feature id:FM_IP_ACCESS
ACL:113
outbound label:3
Cisco IOS Interface and Hardware Component Command Reference
1422
show controllers serial through show hw-module slot proc cpu
show fm features
protocol:ip
feature #:1 feature
id:FM_IP_WCCP
Service ID:0
Service Type:0
Interface:Vlan55 IP is enabled
hw[EGRESS] = 1, hw[INGRESS] = 1
hw_force_default[EGRESS] = 0, hw_force_default[INGRESS] = 0
mcast = 0
priority = 2
reflexive = 0
inbound label:4
protocol:ip
feature #:1
feature id:FM_IP_ACCESS
ACL:111
Interface:Vlan101 IP is enabled
hw[EGRESS] = 1, hw[INGRESS] = 1
hw_force_default[EGRESS] = 0, hw_force_default[INGRESS] = 0
mcast = 0
priority = 2
reflexive = 0
inbound label:5
protocol:ip
feature #:1
feature id:FM_IP_ACCESS
ACL:101
outbound label:6
protocol:ip
feature #:1
feature id:FM_IP_ACCESS
ACL:101
Router>
This example shows how to display the lines of feature manager information starting with the line
that begins with Redundancy:
Router>
show fm features | begin Redundancy
Redundancy Status: designated
Router>
Related Commands Command Description
show fm summary Displays a summary of FM Information.
Cisco IOS Interface and Hardware Component Command Reference
1423
show controllers serial through show hw-module slot proc cpu
show fm inband-counters
show fm inband-counters
To display the number of inband packets that are sent by the Multilayer Switching Feature Card (MSFC) for
server load balancing (SLB) and Web Cache Coprocessor Protocol (WCCP), use the showfminband-counters
command in privileged EXEC mode.
show fm inband-counters
Syntax Description This command has no arguments or keywords.
Command Default This command has no default settings.
Command Modes Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The output display for the showfminband-counters command includes the number of SLB inband packets
that are sent by the MSFC and the number of WCCP inband packets that are sent by the MSFC.
If CBAC is configured, the command output displays the number of packets that are sent for CBAC by the
MSFC.
Examples This example shows how to display the number of SLB and WCCP inband packets that are sent by
the MSFC:
Router# show fm inband-counters
Inband Packets Sent
Slot WCCP SLB
1 0 0
2 0 0
3 0 0
4 0 0
5 0 0
6 0 0
7 0 0
8 0 0
9 0 0
10 0 0
11 0 0
12 0 0
13 0 0
Router#
Cisco IOS Interface and Hardware Component Command Reference
1424
show controllers serial through show hw-module slot proc cpu
show gnss
show gnss
To display the output of the GNSS configuration, use the show gnss command in privileged EXEC mode.
show gnss [{location | satellite | status | time | device}]
Syntax Description location (Optional) Displays the location of the GNSS module.
satellite (Optional) Displays the satellites configured or detected by the GNSS module.
status (Optional) Displays the status of the GNSS module.
time (Optional) Displays the time on the GNSS module.
device (Optional) Displays the hardware information of the active GNSS module.
Command Modes Privileged EXEC (#)
Command History Release Modification
Cisco IOS XE Release 3.17 This command was introduced.
Usage Guidelines Use this command to verify the GNSS configuration.
Examples The following examples show the output generated by this command:
Router# show gnss
Current GNSS Location:
LOC: 12:56.183600 N 77:41.768000 E 819.10 m
Router# show gnss satellite all
All Satellites Info:
SV PRN No Channel No Acq Flg Ephemeris Flg SV Type Sig Strength
----------------------------------------------------------------------------------
21 0 1 1 0 47
14 1 1 1 0 48
18 2 1 1 0 49
22 3 1 1 0 46
27 4 1 1 0 44
24 5 1 1 0 44
31 6 1 1 0 47
Router# show gnss status
GNSS status:
GNSS device: detected
Lock status: Power-up
Receiver Status: Auto
Clock Progress: Phase Locking
Cisco IOS Interface and Hardware Component Command Reference
1425
show controllers serial through show hw-module slot proc cpu
show gnss
Survey progress: 100
Satellite count: 7
Holdover Duration: 0
PDOP: 1.01 TDOP: 1.00
HDOP: 0.71 VDOP: 0.72
Minor Alarm: ANTENNA_OPEN NOT_DISCIPLINING_OSC
Major Alarm: None
Router# show gnss time
Current GNSS Time:
Time: 2015/11/30 10:20:33 UTC Offset: 17
Router# show gnss device
GNSS device:
Serial number: FOC2130ND5X
Firmware version: 1.4
Firmware update progress: NA
Authentication: Passed
In the show gnss device command output, serial number and authentication information is
shown only for pluggable GNSS module like Cisco ASR 903. It is not shown for Cisco ASR 920.
Cisco IOS Interface and Hardware Component Command Reference
1426
show controllers serial through show hw-module slot proc cpu
show gtp
show gtp
To display information related to Enhanced Wireless Access Gateway (EWAG) General Packet Radio Service
(GPRS) Tunneling Protocol (GTP), use the show gtp command in privileged EXEC mode.
show gtp {apn [statistics] {apn-index|all}|mcsa statistics|parameters|path {all|[{statistics}]
remote-address path-address [{vrf vrf-name}]}|pdp-context {all|apn apn-index|imsi imsi-value
[{detail}]|ms-address end-user-address [{vrf vrf-name}] [{detail}]|msisdn msisdn-value [{detail}]|teid-u
user-teid [{detail}]}|statistics|tunnel interface type}
Syntax Description apn Displays Access Point Name
(APN) information.
apn-index Index of the APN.
all Displays information about all
APNs.
statistics (Optional) Displays information
about APN counters.
mcsa statistics Displays statistical information
about Mobile Client Service
Abstraction (MCSA) counters.
parameters Displays information about GTP
parameters.
path Displays information about GTP
path.
all Displays information about all GTP
paths.
statistics Displays statistics related to a path.
remote-address path-address Displays GTP path for a specified
path address.
vrf vrf-name Specifies the virtual routing and
forwarding (VRF) containing the
IP address.
pdp-context Displays information about GTP
Packet Data Protocol (PDP) data
structures.
all Displays information about all
PDPs.
apn apn_index Displays information about PDPs
for the specified APN.
Cisco IOS Interface and Hardware Component Command Reference
1427
show controllers serial through show hw-module slot proc cpu
show gtp
imsi imsi_value Displays information about PDPs
for the specified International
Mobile Subscriber Identity (IMSI)
value.
detail Displays information about PDPs
for the specified IMSI value in
detail.
ms-address end-user-address Displays information about PDPs
for a specified end-user IPv4
address.
teid-u user-teid Displays information about PDPs
for a specified Tunnel Endpoint
Identifier (TEID) user.
statistics Displays information about GTP
counters.
tunnel interface type Displays information about GTP
tunnels.
Command Default This command has no defaults.
Command Modes
Previliged EXEC (#)
Command History Release Modification
Cisco IOS Release XE 3.8S This command was introduced.
Usage Guidelines
Examples The following is sample output of show gtp apn command:
Device# show gtp apn 1
apn_index : 1 apn_name = starent.com
GGSN Addr : 10.1.2.1
Primary DNS : 10.1.2.1
DHCP Addr : 10.10.197.1 DHCP Lease: 6000
Tunnel MTU : 1500
Number of active PDPs in this APN : 0
Default GW Prefix Length Name MAC Address PDP Count
The table below describes the significant fields shown in the display.
Cisco IOS Interface and Hardware Component Command Reference
1428
show controllers serial through show hw-module slot proc cpu
show gtp
Table 109: show gtp apn Field Descriptions
Field Description
apn_index Index of the APN.
apn_name Name of the APN.
GGSN Addr Gateway GPRS Support Node (GGSN) IP address of the APN.
Primary DNS Primary Domain Name System (DNS) Address of the APN.
DHCP Addr DHCP Address of the APN
Tunnel MTU Maximum Transmission unit of a tunnel.
DHCP Lease DHCP lease time in seconds.
Number of active PDPs in this APN Number of active PDPs in the APN.
Related Commands Command Description
debug gtp Debugs EWAG GTP.
gtp Enables EWAG GTP.
Cisco IOS Interface and Hardware Component Command Reference
1429
show controllers serial through show hw-module slot proc cpu
show hspw-aps-icrm
show hspw-aps-icrm
To view information about hot standby pseudowires (HSPW), use the showhspw-aps-icrm command in
privileged EXEC mode.
show hspw-aps-icrm {group group-id|all}
Syntax Description group Specifies the HSPW Automatic Protection Switching (APS) group.
group-id HSPW APS group identifier.
all Displays all the HSPW APS and inter chassis redundancy manager (ICRM) groups.
Command Modes Privileged EXEC (#)
Command History Release Modification
Cisco IOS 15.2(1)S This command was introduced.
Cisco IOS XE 3.11S This command was integrated into Cisco IOS XE Release 3.11S.
Usage Guidelines Use this command to display information about a particular HSPW APS group or all HSPW APS and ICRM
groups.
The following is sample output from the show hspw-aps-icrm command when group group-id is
used to display information about a particular HSPW APS group:
Router# show hspw-aps-icrm group 100
ICRM group id 100, Flags : My core isolated No,Peer core isolated No,
State Connect
APS Group id 1 hw_if_index 33 APS valid:Yes
Total aps grp attached to ICRM group 100 is 1
Displaying Information About All HSPW APS and ICRM Groups
The following is sample output from the show hspw-aps-icrm command when all is used to display
information about all the HSPW APS and ICRM groups:
Router# show hspw-aps-icrm all
ICRM group id 100, Flags : My core isolated No,Peer core isolated No,
State Connect
APS Group id 1 hw_if_index 33 APS valid:Yes
Total aps grp attached to ICRM group 100 is 1 ICRM group count
attached to MR-APS HSPW feature is 1
Related Commands Command Description
show aps Displays information about the current APS feature on the router.
Cisco IOS Interface and Hardware Component Command Reference
1430
show controllers serial through show hw-module slot proc cpu
show hub
show hub
To display information about the hub (repeater) on an Ethernet interface of a Cisco 2505 or Cisco 2507 router,
use the showhub command in user EXEC or privileged EXEC mode.
show hub commandshow hub [ethernet number [port [end-port]]]
Syntax Description ethernet (Optional) Indicates that this is an Ethernet hub.
number (Optional) Hub number, starting with 0. Because there is currently only one hub, this number is
0.
port (Optional) Port number on the hub. On the Cisco 2505 router, port numbers range from 1 to 8.
On the Cisco 2507 router, port numbers range from 1 to 16. If a second port number follows,
this port number indicates the beginning of a port range.
end-port (Optional) Ending port number of a range.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
10.3 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines If you do not specify a port or port range for the showhub command, the command displays all ports (for
example, ports 1 through 16 on a Cisco 2507 router) by default. Therefore, the showhub, showhubethernet0,
and showhubethernet0116 commands produce the same result.
If no ports are specified, the command displays some additional data about the internal port. The internal port
is the hub’s connection to Ethernet interface 0 inside the box. Ethernet interface 0 still exists; physical access
to the interface is via the hub.
Examples
Information for a Specific Port
The following is sample output from the showhub command for hub 0, port 2 only:
Router# show hub ethernet 0 2
Port 2 of 16 is administratively down, link state is down
0 packets input, 0 bytes
0 errors with 0 collisions
(0 FCS, 0 alignment, 0 too long,
0 short, 0 runts, 0 late,
0 very long, 0 rate mismatches)
0 auto partitions, last source address (none)
Last clearing of "show hub" counters never
Cisco IOS Interface and Hardware Component Command Reference
1431
show controllers serial through show hw-module slot proc cpu
show hub
Repeater information (Connected to Ethernet0)
2792429 bytes seen with 18 collisions, 1 hub resets
Version/device ID 0/1 (0/1)
Last clearing of "show hub" counters never
Information for All Ports
The following is sample output from the showhub command for hub 0, all ports:
Router# show hub ethernet 0
Port 1 of 16 is administratively down, link state is up
2458 packets input, 181443 bytes
3 errors with 18 collisions
(0 FCS, 0 alignment, 0 too long,
0 short, 3 runts, 0 late,
0 very long, 0 rate mismatches)
0 auto partitions, last source address was 0000.0cff.e257
Last clearing of "show hub" counters never
.
.
.
Port 16 of 16 is down, link state is down
0 packets input, 0 bytes
0 errors with 0 collisions
(0 FCS, 0 alignment, 0 too long,
0 short, 0 runts, 0 late,
0 very long, 0 rate mismatches)
0 auto partitions, last source address (none)
Last clearing of "show hub" counters never
Repeater information (Connected to Ethernet0)
2792429 bytes seen with 18 collisions, 1 hub resets
Version/device ID 0/1 (0/1)
Last clearing of "show hub" counters never
Internal Port (Connected to Ethernet0)
36792 packets input, 4349525 bytes
0 errors with 14 collisions
(0 FCS, 0 alignment, 0 too long,
0 short, 0 runts, 0 late,
0 very long, 0 rate mismatches)
0 auto partitions, last source address (none)
Last clearing of "show hub" counters never
The table below describes significant fields shown in the display.
Table 110: show hub Field Descriptions
Field Description
Port ... of ... is administratively Port number out of total ports; indicates whether the interface hardware is
down currently active or down because of the following:
• The link-state test failed.
• The MAC address mismatched when source address configured.
• It has been taken down by an administrator.
Cisco IOS Interface and Hardware Component Command Reference
1432
show controllers serial through show hw-module slot proc cpu
show hub
Field Description
link state is up Indicates whether port has been disabled by the link-test function. If the
link-test function is disabled by the user, nothing will be shown here.
packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the
error-free packets received by the system.
errors Sum of FCS, alignment, too long, short, runts, very long, and rate
mismatches.
collisions Number of messages retransmitted due to Ethernet collisions.
FCS Counter for the number of frames detected on the port with an invalid frame
check sequence.
alignment Counter for the number of frames of valid length (64 to 1518 bytes) that
have been detected on the port with an FCS error and a framing error.
too long Counter for the number of frames that exceed the maximum valid packet
length of 1518 bytes.
short Counter for the number of instances when activity is detected with duration
less than 74 to 82 bit times.
runts Number of packets that are discarded because they are smaller than the
medium’s minimum packet size. For example, any Ethernet packet that is
less than 64 bytes is considered a runt.
late Counter for the number of instances when a collision is detected after 480
to 565 bit times in the frame.
very longs Counter for the number of times the transmitter is active in excess of 4 to
7.5 milliseconds.
rate mismatches Counter for the number of occurrences when the frequency, or data rate of
incoming signal is noticeably different from the local transmit frequency.
auto partitions Counter for the number of instances where the repeater has partitioned the
port from the network.
last source address Source address of last packet received by this port. Indicates “none” if no
packets have been received since power on or a hub reset.
Last clearing of “show hub” Elapsed time since the clearhubcounters command was entered. Indicates
counters “never” if counters have never been cleared.
Repeater information Indicates that the following information is about the hub connected to the
(Connected to Ethernet0) Ethernet interface shown.
... bytes seen with ... collisions, Hub resets is the number of times the hub has been reset by network
... hub resets management software or by the clearhub command.
Cisco IOS Interface and Hardware Component Command Reference
1433
show controllers serial through show hw-module slot proc cpu
show hub
Field Description
Version/device ID 0/1 (0/1) Hub hardware version. IMR+ version device of daughter board.
Internal Port (Connected to Set of counters for the internal AUI port connected to the Ethernet interface.
Ethernet0)
Related Commands Command Description
hub Enables and configures a port on an Ethernet hub of a Cisco 2505 or Cisco 2507 router.
Cisco IOS Interface and Hardware Component Command Reference
1434
show controllers serial through show hw-module slot proc cpu
show hw-module all fpd
show hw-module all fpd
To display the current versions of all field-programmable devices (FPDs) for all of the supported card types
on a router, enter the showhw-moduleallfpd command in privileged EXEC mode.
show hw-module all fpd
Syntax Description This command has no arguments or keywords.
Command Default No default behavior or values.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(18)SXE This command was introduced.
12.0(31)S This command was integrated into Cisco IOS Release 12.0(31)S.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.4(4)XD This command was integrated into Cisco IOS Release 12.4(4)XD.
12.4(11)T This command was integrated into Cisco IOS Release 12.4(11)T.
12.2(31)SB2 This command was integrated into Cisco IOS Release 12.2(31)SB2.
12.4(15)T Added an example for the PA-MC-T3-EC port adapter.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB.
Cisco IOS XE Release This command was implemented on Cisco 4400 Series ISRs in Cisco IOS XE
3.9S Release 3.9S
Usage Guidelines Other than the FPD version information, the output for this command can also contain useful FPD-related
notes.
For more information about FPD upgrades on SPA interface processors (SIPs) and shared port adapters (SPAs),
see the Cisco 7600 Series Router SIP, SSC, and SPA Software Configuration Guide.
In Cisco IOS Release 12.2(33)SCB, the FPD image upgrade is supported only for the SPAs inserted in the
SIP-600 jacket card on a Cisco uBR10012 router.
Examples
Cisco 7200 VXR
The following example shows an FPD image file version that requires an upgrade (indicated by the
asterisk) for the NPE-G2 network processing engine in the Cisco 7200 VXR router:
Router# show hw-module all fpd
==== ====================== ====== =============================================
H/W Field Programmable Current Min. Required
Cisco IOS Interface and Hardware Component Command Reference
1435
show controllers serial through show hw-module slot proc cpu
show hw-module all fpd
Slot Card Type Ver. Device: ID-Name Version Version
==== ====================== ====== ================== =========== ==============
npe NPE-G2 1.5 1-NPEG2 I/O FPGA 0.18 0.20 *
---- ---------------------- ------ ------------------ ----------- --------------
0 VSA 0.0 1-VSA 0.10 0.10
==== ====================== ====== =============================================
NOTES:
- FPD images that are required to be upgraded are indicated with a '*'
character in the Minimal Required Version field.
- The following FPD image package file is required for the upgrade:
c7200-fpd-pkg.124-4.XD.pkg
The following example shows that all FPDs for the port adapter have the minimum required version.
For the NPE-400, the “###” characters in the ID-Name, Current Version, and Min, Required Version
fields indicate that FPD does not apply to the NPE-400.
Router# show hw-module all fpd
==== ====================== ====== =============================================
H/W Field Programmable Current Min. Required
Slot Card Type Ver. Device: ''ID-Name'' Version Version
==== ====================== ====== ================== =========== ==============
npe NPE-400 1.1 ############ #.# #.#
---- ---------------------- ------ ------------------ ----------- --------------
1 PA-MC-1T3-EC 1.0 1-ToySurprise FPGA 1.2 1.1
2-Subrate FPGA 1.4 1.4
3-Rommon/IPL 2.0 2.0
==== ====================== ====== =============================================
Cisco 7600 Series
The following example shows FPD image file versions for all SIPs and SPAs in the Cisco 7600 series
router:
Router# show hw-module all fpd
==== ====================== ====== =============================================
H/W Field Programmable Current Min. Required
Slot Card Type Ver. Device: ID-Name Version Version
==== ====================== ====== ================== =========== ==============
4 7600-SIP-200 0.132 1-I/O FPGA 0.19 0.18
2-EOS FPGA 0.22 0.22
3-PEGASUS TX FPGA 0.121 0.121
4-PEGASUS RX FPGA 0.13 0.13
5-ROMMON 1.1 1.1
---- ---------------------- ------ ------------------ ----------- --------------
4/0 SPA-4XOC3-ATM 1.0 1-I/O FPGA 0.121 0.121
---- ---------------------- ------ ------------------ ----------- --------------
4/1 SPA-8XCHT1/E1 0.117 1-ROMMON 2.12 2.12
2-I/O FPGA 0.22 0.22
---- ---------------------- ------ ------------------ ----------- --------------
4/3 SPA-4XCT3/DS0 0.253 1-ROMMON 2.12 2.12
2-I/O FPGA 0.21 0.21
3-T3 SUBRATE FPGA 0.15 0.15
==== ====================== ====== =============================================
The following example shows FPD image file versions that require an upgrade (indicated by the
asterisk) for two SIPs in the Cisco 7600 series router. The SIPs are disabled due to the version
mismatch.
Router# show hw-module all fpd
Cisco IOS Interface and Hardware Component Command Reference
1436
show controllers serial through show hw-module slot proc cpu
show hw-module all fpd
==== ====================== ====== =============================================
H/W Field Programmable Current Min. Required
Slot Card Type Ver. Device: ID-Name Version Version
==== ====================== ====== ================== =========== ==============
1 7600-SIP... <DISABLED> 0.550 1-I/O FPGA 1.1 1.1
2-EOS FPGA 1.211 1.211
3-PEGASUS TX FPGA 1.129 1.129
4-PEGASUS RX FPGA 1.3 1.3
5-ROMMON 1.1 1.2 *
---- ---------------------- ------ ------------------ ----------- --------------
4 7600-SIP... <DISABLED> 0.550 1-I/O FPGA 1.1 1.1
2-EOS FPGA 1.211 1.211
3-PEGASUS TX FPGA 1.129 1.129
4-PEGASUS RX FPGA 1.3 1.3
5-ROMMON 1.1 1.2 *
==== ====================== ====== =============================================
NOTES:
- FPD images that are required to be upgraded are indicated with a '*'
character in the Minimal Required Version field.
- The following FPD image package file is required for the upgrade:
c7600-fpd-pkg.122-18.SXE.pkg
Cisco uBR10012 Universal Broadband Router
The following example shows the FPD versions on SPAs that meet the minimum requirements in
the Cisco uBR10012 router:
Router# show hw-module all fpd
==== ====================== ====== =============================================
H/W Field Programmable Current Min. Required
Slot Card Type Ver. Device: ID-Name Version Version
==== ====================== ====== ================== =========== ==============
1/0 SPA-24XDS-SFP 1.0 1-Modena BLAZE FPG 1285.1444 1285.1444
---- ---------------------- ------ ------------------ ----------- --------------
1/1 SPA-24XDS-SFP 1.0 1-Modena BLAZE FPG 1285.1444 1285.1444
---- ---------------------- ------ ------------------ ----------- --------------
1/2 SPA-24XDS-SFP 1.0 1-Modena BLAZE FPG 1285.1444 1285.1444
---- ---------------------- ------ ------------------ ----------- --------------
1/3 SPA-5X1GE-V2 1.2 1-5xGE V2 I/O FPGA 1.10 1.10
---- ---------------------- ------ ------------------ ----------- --------------
3/0 SPA-24XDS-SFP 1.0 1-Modena BLAZE FPG 1285.1444 1285.1444
---- ---------------------- ------ ------------------ ----------- --------------
3/1 SPA-24XDS-SFP 1.0 1-Modena BLAZE FPG 1285.1444 1285.1444
---- ---------------------- ------ ------------------ ----------- --------------
3/2 SPA-24XDS-SFP 1.0 1-Modena BLAZE FPG 1285.1444 1285.1444
---- ---------------------- ------ ------------------ ----------- --------------
3/3 SPA-1X10GE-L-V2 1.2 1-10GE V2 I/O FPGA 1.9 1.9
==== ====================== ====== =============================================
Example: Cisco 4400 Series ISRs
will be added later
Cisco IOS Interface and Hardware Component Command Reference
1437
show controllers serial through show hw-module slot proc cpu
show hw-module all fpd
Related Commands Command Description
show hw-module slot fpd Displays the current versions of all FPDs for a SIP in the specified slot
location and for all of the SPAs installed in that SIP or any FPD-capable
cards.
show hw-module subslot fpd Displays the current versions of all FPDs for a particular SPA or all of the
active SPAs on a router.
Cisco IOS Interface and Hardware Component Command Reference
1438
show controllers serial through show hw-module slot proc cpu
show hw-module slot (6500)
show hw-module slot (6500)
To display information for a SPA interface processor (SIP) or a module, use the showhw-moduleslot command
in privileged EXEC configuration mode.
show hw-module slot slot {clear-block|oversubscription|port-group-mapping}
Syntax Description slot Specifies the chassis slot number. See the appropriate hardware manual for slot
information. For SIPs, refer to the platform-specific SPA hardware installation
guide or the corresponding “Identifying Slots and Subslots for SIPs and SPAs”
topic in the platform-specific SPA software configuration guide.
clear-block Displays the clearing of the head-of-line blocking status.
oversubscription Displays the oversubscription mode of each port-group.
port-group-mapping Displays the port group mapping.
Command Default None
Command Modes Privileged EXEC
Command History Release Modification
12.2(18)SXF5 Support for this command was introduced (Catalyst 6500 series switch).
12.(33)SXH1 This command was changed to add the oversubscription and the port-group-mapping
keywords (Catalyst 6500 series switch).
12.2(33)SXH2 This command was changed to support the following modules:
• WS-X6716-10G-3C
• WS-X6716-10G-3CXL
Usage Guidelines This command is supported on the following modules:
• WS-X6708-10G-3C--The port-groupmapping and the clear-block keywords are not supported.
• WS-X6708-10G-3CXL--The port-group num and the clear-block keywords and argument are not
supported.
• WS-X6716-10G-3C
• WS-X6716-10G-3CXL
The port-group mappings for the WS-X6716-10G-3C and the WS-X6716-10G-3CXL modules are as follows:
• Group 1--Ports 1 to 4. Port 1 is enabled in transparent mode.
• Group 2--Ports 5 to 8. Port 5 is enabled in transparent mode.
• Group 3--Ports 9 to 12. Port 9 is enabled in transparent mode.
Cisco IOS Interface and Hardware Component Command Reference
1439
show controllers serial through show hw-module slot proc cpu
show hw-module slot (6500)
• Group 4--Ports 13 to 16. Port 13 is enabled in transparent mode.
For the WS-X6716-10G-3C and the WS-X6716-10G-3CXL modules in transparent mode, ports 2, 3, 4, 6, 7,
8, 10, 11, 12, 14, 15, 16 are disabled.
Examples This example shows how to display the current configuration status for the four port-groups:
Router# show hw-module slot 2 clear-block
Port-group Clear-block
1 Enabled
2 Disabled
3 Disabled
4 Enabled
Router#
This example shows how to display the port group mapping of each port group:
Router# show hw-module slot 2 port-group-mapping
Port-group Ports
1 1, 2, 3, 4
2 5, 6, 7, 8
3 9, 10, 11, 12
4 13, 14, 15, 16
This example shows how to display the oversubscription mode of each port group:
Router# show hw-module slot 3 oversubscription
Port-group oversubscription mode
1 Enabled
2 Disabled
3 Enabled
4 Disabled
Router#
Related Commands Command Description
hw-module oversubscription Administratively enables or disables the oversubscribed ports on a module.
Cisco IOS Interface and Hardware Component Command Reference
1440
show controllers serial through show hw-module slot proc cpu
show hw-module slot align
show hw-module slot align
To display alignment data for a SPA interface processor (SIP) or other module, use the
showhw-moduleslotalign command in privileged EXEC configuration mode.
show hw-module slot slot align [cpu {0|1}]
Syntax Description slot Chassis slot number.
Refer to the appropriate hardware manual for slot information. For SIPs, refer to the
platform-specific SPA hardware installation guide or the corresponding “Identifying Slots and
Subslots for SIPs and SPAs” topic in the platform-specific SPA software configuration guide.
cpu 0 |1 (Optional) Number of the CPU (0 or 1) for which you want to display data.
Command Default No default behavior or values
Command Modes Privileged EXEC
Command History Release Modification
12.2(18)SXE Thiscommand was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The number of CPUs available varies by the type of SIP. Although the Cisco 7600 SIP-200 has two CPUs,
you can display alignment data for the first CPU (CPU 0) only.
Examples The following example shows that there has not been any alignment data for the SIP installed in slot
2 of the router:
Router# show hw-module slot 2 align
No alignment data has been recorded.
No spurious memory references have been recorded.
Cisco IOS Interface and Hardware Component Command Reference
1441
show controllers serial through show hw-module slot proc cpu
show hw-module slot fpd
show hw-module slot fpd
To display the current versions of all field-programmable devices (FPDs) for a SIP in the specified slot location
and for all of the SPAs installed in that SIP, or to display the current versions of any FPD-capable cards, enter
the showhw-moduleslotfpd command in privileged EXEC mode.
Cisco 7200 VXR
show hw-module slot {slot|npe} fpd
Cisco 7304, Cisco 7600 Series, Cisco 12000 Series
show hw-module slot slot fpd
Syntax Description slot Chassis slot number.
Refer to the appropriate hardware manual for slot information. For SIPs, refer to the platform-specific
SPA hardware installation guide or the corresponding “Identifying Slots and Subslots for SIPs and
SPAs” topic in the platform-specific SPA software configuration guide. For slot numbering in the Cisco
7200 VXR router, refer to the Cisco 7200 VXR Installation and Configuration Guide .
npe NPE-G2 network processing engine in the Cisco 7200 VXR router.
Command Default No default behavior or values
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(18)SXE This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.4(4)XD This command was integrated into Cisco IOS Release 12.4(4)XD, and the npe keyword was
added.
12.4(11)T This command was integrated into Cisco IOS Release 12.4(11)T.
12.2(31)SB2 This command was integrated into Cisco IOS Release 12.2(31)SB2.
Usage Guidelines Use the showhw-moduleslotfpd command to show the FPD image version information for a particular SIP
and all of its installed SPAs, or to display the current versions of FPD-capable cards in the Cisco 7200 VXR
router. To display FPD information for all of the supported card types on a router, use the
showhw-moduleallfpd command.
Other than the FPD version information, the output for this command can also contain useful FPD-related
notes.
For more information about FPD upgrades on SPA interface processors (SIPs) and shared port adapters (SPAs),
see the Cisco 7600 Series Router SIP, SSC, and SPA Software Configuration Guide.
Cisco IOS Interface and Hardware Component Command Reference
1442
show controllers serial through show hw-module slot proc cpu
show hw-module slot fpd
Examples
Cisco 7200 VXR
The following example shows that the FPD version on the NPE-G2 meets the minimum FPD version
requirements:
Router# show hw-module slot npe fpd
==== =================== ====== =============================================
H/W Field Programmable Current Min. Required
Slot Card Type Ver. Device: "ID-Name" Version Version
==== =================== ====== ================== =========== ==============
npe NPE-G2 1.3 1-NPEG2 I/O FPGA 0.19 0.1
==== =================== ====== =============================================
The following example shows FPD information for the VPN Services Adapter (VSA) in slot 0:
Router# show hw-module slot 0 fpd
==== =================== ====== =============================================
H/W Field Programmable Current Min. Required
Slot Card Type Ver. Device: "ID-Name" Version Version
==== =================== ====== ================== =========== ==============
0 VSA 0.0 1-VSA 0.9 0.8
==== =================== ====== =============================================
Cisco 7600 Series
The following example shows that the FPD versions on the SIP installed in chassis slot 4, and each
of its installed SPAs, meet the minimum FPD version requirements:
Router# show hw-module slot 4 fpd
==== ====================== ====== =============================================
H/W Field Programmable Current Min. Required
Slot Card Type Ver. Device: "ID-Name" Version Version
==== ====================== ====== ================== =========== ==============
4 7600-SIP-200 0.550 1-I/O FPGA 1.1 1.1
2-EOS FPGA 1.211 1.211
3-PEGASUS TX FPGA 1.129 1.129
4-PEGASUS RX FPGA 1.3 1.3
5-ROMMON 1.2 1.2
---- ---------------------- ------ ------------------ ----------- --------------
4/0 SPA-2XT3/E3 1.0 1-ROMMON 2.12 2.12
2-I/O FPGA 0.24 0.24
3-E3 FPGA 0.6 0.6
4-T3 FPGA 0.14 0.14
---- ---------------------- ------ ------------------ ----------- --------------
4/1 SPA-4XOC3-POS 0.209 1-I/O FPGA 3.4 3.4
---- ---------------------- ------ ------------------ ----------- --------------
4/2 SPA-8XCHT1/E1 0.117 1-ROMMON 2.12 2.12
2-I/O FPGA 1.2 1.2
==== ====================== ====== =============================================
Related Commands Command Description
show hw-module all fpd Displays the current versions of all FPDs for all of the supported card types
on a router.
Cisco IOS Interface and Hardware Component Command Reference
1443
show controllers serial through show hw-module slot proc cpu
show hw-module slot fpd
Command Description
show hw-module subslot fpd Displays the current versions of all FPDs for a particular SPA or all of the
active SPAs on a router.
Cisco IOS Interface and Hardware Component Command Reference
1444
show controllers serial through show hw-module slot proc cpu
show hw-module slot logging
show hw-module slot logging
To display logging information for a SPA interface processor (SIP) or other module, use the
showhw-moduleslotlogging command in privileged EXEC configuration mode.
show hw-module slot slot logging [cpu {0|1}]
Syntax Description slot Chassis slot number.
Refer to the appropriate hardware manual for slot information. For SIPs, refer to the
platform-specific SPA hardware installation guide or the corresponding “Identifying Slots and
Subslots for SIPs and SPAs” topic in the platform-specific SPA software configuration guide.
cpu 0 |1 (Optional) Number of the CPU (0 or 1) for which you want to display data.
Command Default No default behavior or values
Command Modes Privileged EXEC
Command History Release Modification
12.2(18)SXE Thiscommand was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The number of CPUs available varies by the type of SIP. Although the Cisco 7600 SIP-200 has two CPUs,
you can display alignment data for the first CPU (CPU 0) only.
Examples The following example shows logging information and messages for the SIP installed in slot 2 of
the router:
Router# show hw-module slot 2 logging
Syslog logging: enabled (0 messages dropped, 2 messages rate-limited, 0 flushes,
0 overruns)
Console logging: level debugging, 90 messages logged
Monitor logging: level debugging, 0 messages logged
Buffer logging: level debugging, 92 messages logged
Exception Logging: size (4096 bytes)
Count and timestamp logging messages: disabled
Log Buffer (8192 bytes):
00:00:01: hyp_dev_attach
00:00:01: hyp_dev_init
00:00:01: hyp_init
00:00:01: hyp_dev_disable_intr
00:00:01: hyp_mx_sub_core_reset
00:00:01: hyp_mx_sub_core_unreset
00:00:01: hyp_mx_slv_reset
00:00:01: hyp_mx_slv_unreset
00:00:01: hyp_reg_config
00:00:01: hyp_fi_fr_reg_config
00:00:01: hyp_set_oper_mode
00:00:01: hyp_dev_enable_intr
00:00:03: Initializing rate limit function ===!!!
Cisco IOS Interface and Hardware Component Command Reference
1445
show controllers serial through show hw-module slot proc cpu
show hw-module slot logging
00:00:04: Currently running ROMMON from ROM F2
SLOT 2/0: 00:00:04: %SYS-5-RESTART: System restarted --
Cisco Internetwork Operating System Software
IOS (tm) cwlc Software (sip1-DW-M), Experimental Version 12.2(20040824:180829) [
dperez-pikespeak_3 174]
Copyright (c) 1986-2004 by cisco Systems, Inc.
Compiled Wed 01-Sep-04 13:54 by dperez
00:00:05: hyp_init
00:00:05: hyp_dev_disable_intr
00:00:05: hyp_mx_sub_core_reset
00:00:05: hyp_mx_sub_core_unreset
00:00:05: hyp_mx_slv_reset
00:00:05: hyp_mx_slv_unreset
00:00:05: hyp_reg_config
00:00:05: hyp_fi_fr_reg_config
00:00:05: hyp_set_oper_mode
00:00:05: hyp_dev_enable_intr
SLOT 2/0: 00:00:05: %HYPERION-5-BUS_MODE_CHANGE: The System Switching Bus Mode c
hanged to Compact mode
00:00:05:
00:00:05: hyp_fabric_intf_cnfg
00:00:05: Fabric Information
00:00:05: ==================
00:00:05: Speed = 8G
00:00:05: Channel mode = Mode2-SSA/SSO
00:00:05: Channel = Secondary
00:00:05: hyp_rbh_reg_clear
00:00:05: Serial Secondary Channel SYNC SUCCESS!
SLOT 2/0: 00:00:05: %SCP-5-ENABLE: Module enabled
00:00:05: hyp_fabric_intf_cnfg
00:00:05: hyp_fpoe_chan_init
00:00:05: sip_hyp_check_sync_100ms:Opened SSA DDR
00:00:05: sip_hyp_check_sync_100ms:Opened n/w DDR
SLOT 2/0: 00:00:08: %SCP-5-ONLINE: Module online
00:00:09: % FPD_MGMT[65535]: Sending FPD version check request
00:00:09: % FPD_MGMT[65535]: Change FPD upgrade state to FPD_STATE_UPGRADE_IN_PR
OGRESS
00:00:09: % FPD_MGMT[65535]: Change FPD upgrade state to FPD_STATE_NO_UPGRADE_NE
EDED
SLOT 2/0: 00:00:09: %SIPSPA-6-OIR: Bay 3 SPA Power changed to On
SLOT 2/0: 00:00:10: %SIPSPA-6-OIR: Bay 3 SPA OK changed to On
00:00:10: % FPD_MGMT[3]: Sending FPD version check request
00:00:10: % FPD_MGMT[3]: Change FPD upgrade state to FPD_STATE_UPGRADE_IN_PROGRE
SS
00:00:10: % FPD_MGMT[3]: Change FPD upgrade state to FPD_STATE_NO_UPGRADE_NEEDED
SLOT 2/0: 00:00:13: %SCC-2-PROTO_HW: Module (2/3) is a registered proto-type for
Cisco Lab use only, and not certified for live network operation.
SLOT 2/0: 00:00:15: %LINK-3-UPDOWN: Interface POS2/3/0, changed state to down
Cisco IOS Interface and Hardware Component Command Reference
1446
show controllers serial through show hw-module slot proc cpu
show hw-module slot proc cpu
show hw-module slot proc cpu
To display CPU utilization for each process on a SPA interface processor (SIP) or other module, use the
showhw-moduleslotproccpucommand in privileged EXEC configuration mode.
show hw-module slot slot proc cpu [cpu {0|1}]
Syntax Description slot Chassis slot number.
Refer to the appropriate hardware manual for slot information. For SIPs, refer to the
platform-specific SPA hardware installation guide or the corresponding “Identifying Slots and
Subslots for SIPs and SPAs” topic in the platform-specific SPA software configuration guide.
cpu 0 |1 (Optional) Number of the CPU (0 or 1) for which you want to display data.
Command Default No default behavior or values
Command Modes Privileged EXEC
Command History Release Modification
12.2(18)SXE Thiscommand was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The number of CPUs available varies by the type of SIP. Although the Cisco 7600 SIP-200 has two CPUs,
you can display alignment data for the first CPU (CPU 0) only.
Examples The following example shows CPU utilization per process for the SIP installed in slot 2 of the router:
Router# show hw-module slot 2 proc cpu
CPU utilization for five seconds: 0%/0%; one minute: 0%; five minutes: 0%
PID Runtime(ms) Invoked uSecs 5Sec 1Min 5Min TTY Process
1 0 1 0 0.00% 0.00% 0.00% 0 Chunk Manager
2 0 255569 0 0.00% 0.00% 0.00% 0 Load Meter
3 4 1884015 0 0.00% 0.00% 0.00% 0 CEF process
4 86532 129737 666 0.08% 0.00% 0.00% 0 Check heaps
5 0 743 0 0.00% 0.00% 0.00% 0 Pool Manager
6 0 2 0 0.00% 0.00% 0.00% 0 Timers
7 0 1 0 0.00% 0.00% 0.00% 0 AAA_SERVER_DEADT
8 0 2 0 0.00% 0.00% 0.00% 0 AAA high-capacit
9 0 2 0 0.00% 0.00% 0.00% 0 Serial Backgroun
10 0 255598 0 0.00% 0.00% 0.00% 0 ENVM Background
11 0 21298 0 0.00% 0.00% 0.00% 0 IPC Dynamic Cach
12 56 21300 2 0.00% 0.00% 0.00% 0 PROCMIB LC Proce
13 0 1 0 0.00% 0.00% 0.00% 0 IPC BackPressure
14 0 1277836 0 0.00% 0.00% 0.00% 0 IPC Periodic Tim
15 0 1277836 0 0.00% 0.00% 0.00% 0 IPC Deferred Por
16 0 13 0 0.00% 0.00% 0.00% 0 IPC Seat Manager
17 0 1 0 0.00% 0.00% 0.00% 0 SERIAL A'detect
18 2820 39 72307 0.00% 0.00% 0.00% 0 SMART
19 0 1 0 0.00% 0.00% 0.00% 0 Critical Bkgnd
20 4 383354 0 0.00% 0.00% 0.00% 0 Net Background
Cisco IOS Interface and Hardware Component Command Reference
1447
show controllers serial through show hw-module slot proc cpu
show hw-module slot proc cpu
21 0 36 0 0.00% 0.00% 0.00% 0 Logger
22 8 1277832 0 0.00% 0.00% 0.00% 0 TTY Background
23 0 1277846 0 0.00% 0.00% 0.00% 0 Per-Second Jobs
24 0 22041 0 0.00% 0.00% 0.00% 0 Per-minute Jobs
25 0 2 0 0.00% 0.00% 0.00% 0 SCP Multicast
26 0 1 0 0.00% 0.00% 0.00% 0 Inode Table Dest
27 0 4 0 0.00% 0.00% 0.00% 0 LC to RP defere
28 8 428 18 0.00% 0.00% 0.00% 0 CWLC IFCOM Proce
29 0 1 0 0.00% 0.00% 0.00% 0 IPC RTTYC Messag
30 0 2 0 0.00% 0.00% 0.00% 0 INTR MGR PROCESS
31 0 2 0 0.00% 0.00% 0.00% 0 EFC queue monito
32 0 1 0 0.00% 0.00% 0.00% 0 LC interrupt, J1
33 0 1 0 0.00% 0.00% 0.00% 0 SIP interrupt, P
34 0 2 0 0.00% 0.00% 0.00% 0 SDCC Input
35 0 1 0 0.00% 0.00% 0.00% 0 CWAN LTL manager
36 0 8 0 0.00% 0.00% 0.00% 0 SIP SWBus Sync P
37 0 1 0 0.00% 0.00% 0.00% 0 CWSLC Bus Stall
38 0 1 0 0.00% 0.00% 0.00% 0 VIP Encap IPC Ba
39 0 1 0 0.00% 0.00% 0.00% 0 CWPA Bridging Ra
40 0 255568 0 0.00% 0.00% 0.00% 0 CPU Monitor
41 0 1 0 0.00% 0.00% 0.00% 0 MLP Input
42 592 42648 13 0.00% 0.00% 0.00% 0 SPA OIR 2/0
43 644 42644 15 0.00% 0.00% 0.00% 0 SPA OIR 2/1
44 572 42644 13 0.00% 0.00% 0.00% 0 SPA OIR 2/2
45 1088 42697 25 0.00% 0.00% 0.00% 0 SPA OIR 2/3
46 0 1 0 0.00% 0.00% 0.00% 0 LC FPD Upgrade P
47 0 2 0 0.00% 0.00% 0.00% 0 AAA Dictionary R
48 0 2 0 0.00% 0.00% 0.00% 0 AAA Server
49 0 1 0 0.00% 0.00% 0.00% 0 AAA ACCT Proc
50 0 1 0 0.00% 0.00% 0.00% 0 ACCT Periodic Pr
51 0 2 0 0.00% 0.00% 0.00% 0 ATMLS task
52 0 127785 0 0.00% 0.00% 0.00% 0 LC Process for u
53 0 3 0 0.00% 0.00% 0.00% 0 IP Hdr Comp Proc
54 140 12778349 0 0.00% 0.00% 0.00% 0 SSA FABLINK Proc
55 0 255568 0 0.00% 0.00% 0.00% 0 HYP ACCU FAB COU
56 0 1 0 0.00% 0.00% 0.00% 0 SCP async: CWAN-
57 0 2 0 0.00% 0.00% 0.00% 0 CWTLC SSO Proces
58 3272 85294 38 0.00% 0.00% 0.00% 0 SCP Hybrid proce
59 1004 12717003 0 0.00% 0.00% 0.00% 0 CEF LC IPC Backg
60 8 1653487 0 0.00% 0.00% 0.00% 0 CEF LC Stats
61 0 1 0 0.00% 0.00% 0.00% 0 CEF MQC IPC Back
62 0 1 0 0.00% 0.00% 0.00% 0 TFIB LC cleanup
63 0 3 0 0.00% 0.00% 0.00% 0 Any Transport ov
64 0 7 0 0.00% 0.00% 0.00% 0 HQF Shaper Backg
65 8 319458609 0 0.00% 0.00% 0.00% 0 HQF Input Shaper
66 0 2 0 0.00% 0.00% 0.00% 0 LOCAL AAA
67 0 2 0 0.00% 0.00% 0.00% 0 AAA Cached Serve
68 0 90366 0 0.00% 0.00% 0.00% 0 CEF Scanner
69 0 3 0 0.00% 0.00% 0.00% 0 RADIUS TEST CMD
70 0 2 0 0.00% 0.00% 0.00% 0 AAA SEND STOP EV
71 0 4 0 0.00% 0.00% 0.00% 0 IPv6 CEF process
72 0 1 0 0.00% 0.00% 0.00% 0 SONET alarm time
73 0 1 0 0.00% 0.00% 0.00% 0 Net Input
74 0 255571 0 0.00% 0.00% 0.00% 0 Compute load avg
75 16 80 200 0.08% 0.00% 0.00% 1 console_rpc_serv
Cisco IOS Interface and Hardware Component Command Reference
1448
show hw-module slot tech-support through show
interfaces vg-anylan
• show hw-module slot tech-support, on page 1451
• show hw-module subslot, on page 1464
• show hw-module subslot fpd, on page 1469
• show hw-module subslot oir, on page 1473
• show hw-module subslot service-engine status, on page 1477
• show hw-module subslot transceiver, on page 1479
• show hw-programmable, on page 1484
• show icc, on page 1486
• show interfaces cem, on page 1488
• show interface history, on page 1490
• show interface sdcc, on page 1493
• show interfaces, on page 1498
• show interfaces accounting, on page 1539
• show interfaces analysis-module, on page 1541
• show interfaces bdi, on page 1546
• show interfaces capabilities, on page 1548
• show interfaces content-engine, on page 1551
• show interfaces counters nonzero, on page 1557
• show interfaces ctunnel, on page 1559
• show interfaces debounce, on page 1563
• show interfaces description, on page 1565
• show interfaces ethernet, on page 1567
• show interfaces fastethernet, on page 1573
• show interfaces fddi, on page 1582
• show interfaces flowcontrol, on page 1591
• show interfaces gigabitethernet, on page 1594
• show interfaces hssi, on page 1602
• show interfaces integrated-service-engine, on page 1608
• show interfaces ism, on page 1610
• show interfaces lex, on page 1615
• show interfaces loopback, on page 1620
Cisco IOS Interface and Hardware Component Command Reference
1449
show hw-module slot tech-support through show interfaces vg-anylan
• show interfaces port-channel, on page 1624
• show interfaces port-channel etherchannel, on page 1630
• show interfaces pos, on page 1633
• show interfaces private-vlan mapping, on page 1639
• show interfaces satellite, on page 1641
• show interfaces serial, on page 1649
• show interfaces sm, on page 1671
• show interfaces status, on page 1676
• show interfaces summary, on page 1679
• show interfaces switchport, on page 1682
• show interfaces switchport backup, on page 1684
• show interfaces tokenring, on page 1686
• show interfaces transceiver, on page 1692
• show interfaces transceiver details, on page 1700
• show interfaces transceiver slot, on page 1703
• show interfaces transceiver slot details, on page 1704
• show interfaces transceiver subslot, on page 1706
• show interfaces transceiver subslot details, on page 1707
• show interfaces <interface> transceiver, on page 1709
• show interfaces <interface> transceiver detail, on page 1711
• show interfaces trunk, on page 1714
• show interfaces tunnel, on page 1717
• show interfaces ucse, on page 1722
• show interfaces unidirectional, on page 1724
• show interfaces vg-anylan, on page 1725
Cisco IOS Interface and Hardware Component Command Reference
1450
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module slot tech-support
show hw-module slot tech-support
To display system information for a SPA interface processor (SIP) or other module to troubleshoot a problem,
use the showhw-moduleslottech-supportcommand in privileged EXEC configuration mode.
show hw-module slot slot tech-support [cpu {0|1}]
Syntax Description slot Chassis slot number.
Refer to the appropriate hardware manual for slot information. For SIPs, refer to the
platform-specific SPA hardware installation guide or the corresponding “Identifying Slots and
Subslots for SIPs and SPAs” topic in the platform-specific SPA software configuration guide.
cpu 0 |1 (Optional) Number of the CPU (0 or 1) for which you want to display data.
Command Default No default behavior or values
Command Modes Privileged EXEC
Command History Release Modification
12.2(18)SXE Thiscommand was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines Use the showhw-moduleslottech-support command to gather information about the SIP or other module to
troubleshoot a problem. Certain error messages request that you gather this information and have it available
when reporting a problem to Cisco Systems technical support personnel.
The showhw-moduleslottech-supportcommand runs a collection of different show commands to gather
information about your system environment and configuration.
The number of CPUs available varies by the type of SIP. Although the Cisco 7600 SIP-200 has two CPUs,
you can display alignment data for the first CPU (CPU 0) only.
Examples The following example shows system information for the SIP installed in slot 5 of the router:
Router# show hw-module slot 5 tech-support
------------------ show version ------------------
Cisco Internetwork Operating System Software
IOS (tm) cwlc Software (sip2-DW-M), Version 12.2(PIKESPEAK_INTEG_041013) INTERIM SOFTWARE
Synced to V122_18_S6, 12.2(18)S6 on v122_18_s_throttle, Weekly 12.2(18.6.4)SX
Technical Support: http://www.cisco.com/techsupport
Copyright (c) 1986-2004 by cisco Systems, Inc.
Compiled Wed 13-Oct-04 06:55 by kchristi
Image text-base: 0x40010FC0, data-base: 0x40680000
ROM: System Bootstrap, Version 12.2(20040716:151531) [tawei-pike1 1.1dev(0.1)] DEVELOPMENT
SOFTWARE
ROM: cwlc Software (sip2-DW-M), Version 12.2(PIKESPEAK_INTEG_041013) INTERIM SOFTWARE
SIP-400-5 uptime is 19 hours, 38 minutes
System returned to ROM by power-on
Running default software
Cisco IOS Interface and Hardware Component Command Reference
1451
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module slot tech-support
cisco CWAN Modular Service Card (SIP-400) (SB-1) processor with 245760K/16383K bytes of
memory.
SB-1 CPU at 400Mhz, Implementation 0x401, Rev 0.3, 256KB L2 Cache
Last reset from power-on
4 ATM network interface(s)
Configuration register is 0x0
------------------ show running-config ------------------
Building configuration...
Current configuration : 13 bytes
!
!
!
!
end
------------------ show stacks ------------------
Minimum process stacks:
Free/Size Name
5080/6000 SCP Find Master process
8448/12000 Init
5528/6000 IPC Zone Manager
5264/6000 SCP Hybrid Registration process
4616/6000 IPC delayed init
5056/6000 SIP2 FPD Process
8120/12000 Exec
6920/12000 console_rpc_server_action
7536/12000 RFSS_server_action
Interrupt level stacks:
Level Called Unused/Size Name
1 1 7896/9000 Level 1 Interrupt
2 116555 6136/9000 Level 2 Interrupt
3 289 7760/9000 Level 3 Interrupt
4 24915 8392/9000 Level 4 Interrupt
5 67 8424/9000 Level 5 Interrupt
7 17683668 8568/9000 NMI Interrupt Handler
------------------ show interfaces ------------------
ATM5/0/0 is administratively down, line protocol is down
Hardware is SPA-4XOC3-ATM, address is 0000.0000.0000 (bia 0000.0000.0000)
MTU 4470 bytes, sub MTU 0, BW 149760 Kbit, DLY 0 usec,
reliability 0/255, txload 1/255, rxload 1/255
Encapsulation ATM, loopback not set
Last input never, output never, output hang never
Last clearing of "show interface" counters never
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue: 0/40 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts (0 IP multicast)
0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 packets output, 0 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
ATM5/0/1 is administratively down, line protocol is down
Hardware is SPA-4XOC3-ATM, address is 0000.0000.0000 (bia 0000.0000.0000)
MTU 4470 bytes, sub MTU 0, BW 149760 Kbit, DLY 0 usec,
reliability 0/255, txload 1/255, rxload 1/255
Encapsulation ATM, loopback not set
Last input never, output never, output hang never
Last clearing of "show interface" counters never
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue: 0/40 (size/max)
Cisco IOS Interface and Hardware Component Command Reference
1452
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module slot tech-support
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts (0 IP multicast)
0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 packets output, 0 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
ATM5/0/2 is administratively down, line protocol is down
Hardware is SPA-4XOC3-ATM, address is 0000.0000.0000 (bia 0000.0000.0000)
MTU 4470 bytes, sub MTU 0, BW 149760 Kbit, DLY 0 usec,
reliability 0/255, txload 1/255, rxload 1/255
Encapsulation ATM, loopback not set
Last input never, output never, output hang never
Last clearing of "show interface" counters never
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue: 0/40 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts (0 IP multicast)
0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 packets output, 0 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
ATM5/0/3 is administratively down, line protocol is down
Hardware is SPA-4XOC3-ATM, address is 0000.0000.0000 (bia 0000.0000.0000)
MTU 4470 bytes, sub MTU 0, BW 149760 Kbit, DLY 0 usec,
reliability 0/255, txload 1/255, rxload 1/255
Encapsulation ATM, loopback not set
Last input never, output never, output hang never
Last clearing of "show interface" counters never
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue: 0/40 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts (0 IP multicast)
0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 packets output, 0 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
------------------ show controllers ------------------
Shared Port Adapter SPA-4XOC3-ATM[5/0]
4xOC3 ATM SPA revision 1
SAR is Azanda Katana SAR/TM, rev B, manf_id 0x1B2, base 0xB8300000
object 0x43D9DF90, port 0x43A332E8, list_elems 0x43A3C7D0
hash_tbl 0x41EEF0A0, vc_tbl 0x4276C2F0, fid_tbl 0x441145A0
shp_prof 0x42996990
vc_count 0/16384 (curr/max), fid_count 12/65536 (curr/max), max_bids 1048576
Device level stats:
s4p3_abort 0 s4p3_pty_errs 0
cor_ecc_errs 0 lut_pty_errs 0
uncor_ecc_errs 0 hdrap_pty_errs 0
mem_bad_errs 0
pfq2mem_rels 0 null_rel 0
mem2pfq_rels 0 null_dq 0
mem_nq 0 pre_pfq_drops 0
dbs_dq_cnt 0 post_pfq_drops 0
Cisco IOS Interface and Hardware Component Command Reference
1453
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module slot tech-support
no_fid_drops 0 tot_free_bufs 1048575
bid_nulls 0 bufs_inuse 0
sch_cells 0 sch_cells_out 0
sch_blocked 0 sch_eop 0
sch_empty 0 cbwfq_merge_in 0
cbwfq_merge_out 0
Backpressure status:
SEG input FIFO: not full
LUT RAS PFQ DBS
lo hi lo hi lo hi lo hi
Port 0 RX - - - - - - - -
Port 0 TX - - - - - - - -
Port 1 RX - - - - - - - -
Port 1 TX - - - - - - - -
Port 2 RX - - - - - - - -
Port 2 TX 1 1 - - - - - -
Port 3 RX - - - - - - - -
Port 3 TX 1 1 - - - - - -
Port 0 Stats:
rx_paks 0 tx_paks 0
rx_cells 0 tx_cells 0
rx_bytes 0 tx_bytes 0
pm_rx_paks 0 pm_tx_paks 0
pm_rx_bytes 0 pm_tx_bytes 0
rx_wred_tail_dr 0 tx_wred_tail_dr 0
rx_wred_prob_dr 0 tx_wred_prob_dr 0
rx_buf_thr_lo 62260 tx_buf_thr_lo 186778
rx_bufs_inuse_l 0 tx_bufs_inuse_l 0
rx_buf_thr_hi 3276 tx_buf_thr_hi 9830
rx_bufs_inuse_h 0 tx_bufs_inuse_h 0
rx_crc32_errs 0 rx_crc10_errs 0
rx_no_vcd 0
Port 1 Stats:
rx_paks 0 tx_paks 0
rx_cells 0 tx_cells 0
rx_bytes 0 tx_bytes 0
pm_rx_paks 0 pm_tx_paks 0
pm_rx_bytes 0 pm_tx_bytes 0
rx_wred_tail_dr 0 tx_wred_tail_dr 0
rx_wred_prob_dr 0 tx_wred_prob_dr 0
rx_buf_thr_lo 62260 tx_buf_thr_lo 186778
rx_bufs_inuse_l 0 tx_bufs_inuse_l 0
rx_buf_thr_hi 3276 tx_buf_thr_hi 9830
rx_bufs_inuse_h 0 tx_bufs_inuse_h 0
rx_crc32_errs 0 rx_crc10_errs 0
rx_no_vcd 0
Port 2 Stats:
rx_paks 0 tx_paks 0
rx_cells 0 tx_cells 0
rx_bytes 0 tx_bytes 0
pm_rx_paks 0 pm_tx_paks 0
pm_rx_bytes 0 pm_tx_bytes 0
rx_wred_tail_dr 0 tx_wred_tail_dr 0
rx_wred_prob_dr 0 tx_wred_prob_dr 0
rx_buf_thr_lo 62260 tx_buf_thr_lo 186778
rx_bufs_inuse_l 0 tx_bufs_inuse_l 0
rx_buf_thr_hi 3276 tx_buf_thr_hi 9830
rx_bufs_inuse_h 0 tx_bufs_inuse_h 0
rx_crc32_errs 0 rx_crc10_errs 0
rx_no_vcd 0
Port 3 Stats:
rx_paks 0 tx_paks 0
rx_cells 0 tx_cells 0
rx_bytes 0 tx_bytes 0
Cisco IOS Interface and Hardware Component Command Reference
1454
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module slot tech-support
pm_rx_paks 0 pm_tx_paks 0
pm_rx_bytes 0 pm_tx_bytes 0
rx_wred_tail_dr 0 tx_wred_tail_dr 0
rx_wred_prob_dr 0 tx_wred_prob_dr 0
rx_buf_thr_lo 62260 tx_buf_thr_lo 186778
rx_bufs_inuse_l 0 tx_bufs_inuse_l 0
rx_buf_thr_hi 3276 tx_buf_thr_hi 9830
rx_bufs_inuse_h 0 tx_bufs_inuse_h 0
rx_crc32_errs 0 rx_crc10_errs 0
rx_no_vcd 0
Flow utilization summary
blks unsh t_rt t_lb t_lf rt_lf shap root drain | Total
# free : 24568 0 1023 8184 0 8191 15355 8191 0 | 65512
flow int red dfl queue size sent packet drops
id vcd gqid use prt dir pro clr curr avg max paks bufm giant to/ab pl/crc
0001 0 0000 shap 1 tx 18 4 0 1 35940 0 0 0 0 0
0002 0 0000 shap 3 tx 18 4 0 1 35940 0 0 0 0 0
0003 0 0000 shap 5 tx 18 4 0 1 35940 0 0 0 0 0
0004 0 0000 shap 7 tx 18 4 0 1 35940 0 0 0 0 0
FFF8 0 0000 unsh 11 rx 18 4 0 1 35940 0 0 0 0 0
FFF9 0 0000 unsh 13 rx 18 4 0 1 35940 0 0 0 0 0
FFFA 0 0000 unsh 15 rx 18 4 0 1 35940 0 0 0 0 0
FFFB 0 0000 unsh 17 rx 18 4 0 1 35940 0 0 0 0 0
FFFC 0 0000 unsh 10 rx 21 0 0 1 0 0 0 0 0 0
FFFD 0 0000 unsh 12 rx 21 0 0 1 0 0 0 0 0 0
FFFE 0 0000 unsh 14 rx 21 0 0 1 0 0 0 0 0 0
FFFF 0 0000 unsh 16 rx 21 0 0 1 0 0 0 0 0 0
KATM FPGA: rev 0.90, base 0xB8000000, obj 0x42994748
packets cells errors
port rx tx rx tx rx tx
0 0 0 0 0 0 0
1 0 0 0 0 0 0
2 0 0 0 0 0 0
3 0 0 0 0 0 0
PM5379 ATM Framer: Type:0, Rev:1, base 0xB8100000, obj 0x41EEA2B0
Cells CRC errs
port rx tx rx
0 0 0 0
1 0 0 0
2 0 0 0
3 0 0 0
ATM5/0/0:
ID: SFP
Extended ID: 4
Xcvr Type: OC3 SR-1/STM1 MM (1)
Connector: LC
Vendor name: OCP
Product Identifier (PID): TRP-03BCS
State: Enabled
ATM5/0/0:
Phased Initialization
Phase Reached: 4
Phase Exit Code: Success 0
Phase Read Offset: 256
Socket Verification
Compatibility: Compatibility passed
Security: Security passed
------------------ show memory statistics ------------------
Head Total(b) Used(b) Free(b) Lowest(b) Largest(b)
Processor 4145B860 230311840 118715296 111596544 106212312 48534600
I/O F000000 16776736 3090304 13686432 13686432 13685880
------------------ show process memory ------------------
Total: 247088544, Used: 121805424, Free: 125283120
PID TTY Allocated Freed Holding Getbufs Retbufs Process
Cisco IOS Interface and Hardware Component Command Reference
1455
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module slot tech-support
0 0 17899632 57040 17017720 0 0 *Init*
0 0 1256 145000 1256 0 0 *Sched*
0 0 0 0 0 0 0 *Neutrino*
0 0 5233000 4617848 589152 606508 0 *Dead*
1 0 0 0 6968 0 0 Chunk Manager
2 0 192 192 3960 0 0 Load Meter
3 0 0 0 6960 0 0 SCP async: CWAN-
4 0 0 0 6960 0 0 Check heaps
5 0 25984 169280 9584 15748 51748 Pool Manager
6 0 192 192 6960 0 0 Timers
7 0 0 0 6976 0 0 AAA_SERVER_DEADT
8 0 192 192 6968 0 0 AAA high-capacit
9 0 192 192 6960 0 0 Serial Backgroun
10 0 0 0 6960 0 0 ENVM Background
11 0 0 0 6960 0 0 IPC Dynamic Cach
12 0 145256 384 23968 31200 0 PROCMIB LC Proce
13 0 0 0 6960 0 0 IPC BackPressure
14 0 7040 0 6960 0 0 IPC Periodic Tim
15 0 0 0 6968 0 0 IPC Deferred Por
16 0 123536 352 25416 12756 0 IPC Seat Manager
17 0 0 0 6960 0 0 SERIAL A'detect
18 0 992944 993024 6960 0 0 SMART
19 0 0 0 6960 0 0 Critical Bkgnd
20 0 14080 0 13120 0 0 Net Background
21 0 192 192 12960 0 0 Logger
22 0 26384 448 9960 0 0 TTY Background
23 0 0 0 6960 0 0 Per-Second Jobs
24 0 0 0 6960 0 0 Per-minute Jobs
25 0 0 152 6960 0 0 SCP Multicast
26 0 0 0 3960 0 0 Inode Table Dest
27 0 0 0 6976 0 0 LC to RP defere
28 0 192 192 6960 0 0 CWLC IFCOM Proce
29 0 0 0 6968 0 0 IPC RTTYC Messag
30 0 192 192 12960 0 0 INTR MGR PROCESS
31 0 0 0 6960 0 0 ixp_exmem_reuse_
32 0 14456 14296 7120 0 0 spnpc_dowork
33 0 0 0 6960 0 0 Spi4 Timer
34 0 0 0 6968 0 0 LC interrupt, J1
35 0 0 0 6976 0 0 SIP interrupt, P
36 0 0 0 12960 0 0 SDCC Input
37 0 192 192 12960 0 0 SDCC Periodic
38 0 192 192 12960 0 0 SDCC IO
39 0 0 0 6960 0 0 CWAN LTL manager
40 0 0 0 6960 0 0 msg_handler_proc
41 0 2620112 2620112 6960 0 0 Cardmgr Periodic
42 0 0 0 6960 0 0 SIP SWBus Sync P
43 0 0 0 6960 0 0 NP doorbell proc
44 0 10432 5344 6960 2268 0 CardMgr Events
45 0 1905448 3592 1787560 0 0 INP Reload
46 0 0 0 6960 0 0 ipc_handler_proc
47 0 0 0 6960 0 0 NP doorbell proc
48 0 2270440 2328 2158576 2268 0 ENP Reload
49 0 0 0 6960 0 0 ipc_handler_proc
50 0 0 0 6960 0 0 SIP2 Bus Stall
51 0 1504729392 1504768488 200528 0 0 ifnpc_dowork
52 0 0 0 6960 0 0 hmi_dowork
53 0 7000 7000 6960 0 0 cwanlc_npc_dowor
54 0 0 0 6968 0 0 VIP Encap IPC Ba
55 0 554366168 457784816 96580296 12756 0 SPA OIR 5/0
56 0 0 0 12960 0 0 SPA OIR 5/1
57 0 0 0 12960 0 0 SPA OIR 5/2
58 0 0 0 12960 0 0 SPA OIR 5/3
59 0 27281752 27281752 6960 0 0 LC FPD Upgrade P
60 0 0 0 6960 0 0 spa_env_monitor
Cisco IOS Interface and Hardware Component Command Reference
1456
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module slot tech-support
61 0 192 192
6960 0 0 AAA Dictionary R
62 0 192 192
6960 0 0 AAA Server
63 0 0 0
6960 0 0 AAA ACCT Proc
64 0 0 0
6960 0 0 ACCT Periodic Pr
65 0 192 192
6960 0 0 ATMLS task
66 0 0 0
6968 0 0 AToM NP CLIENT B
67 0 0 0
6968 0 0 TTFIB NP CLIENT
68 0 0 0
6960 0 0 SSA FABLINK Proc
69 0 0 0
6968 0 0 HYP ACCU FAB COU
70 0 327264 0
327264 0 0 CEF process
71 0 192 192
6960 0 0 CWTLC SSO Proces
72 0 192 192
6960 0 0 SCP Hybrid proce
73 0 0 0
12960 0 0 ATM NP CLIENT PR
74 0 0 0
12968 0 0 BRIDGING NP CLIE
75 0 0 0
6960 0 0 fr_npc_dowork
76 0 192 192
6968 0 0 fastblk backgrou
77 0 0 0
6960 0 0 hnpc_dowork
78 0 0 0
12968 0 0 SIP2 BRIDGE PROC
79 0 192 192
12960 0 0 QoS NP Client
80 0 2355016 1220392
2338776 12756 0 CEF LC IPC Backg
81 0 112519984 111381200
72720 0 0 CEF LC Stats
82 0 0 0
6960 0 0 CEF MQC IPC Back
83 0 0 0
6960 0 0 TFIB LC cleanup
84 0 192 192
6984 0 0 Any Transport ov
85 0 192 192
6960 0 0 LOCAL AAA
86 0 192 192
6960 0 0 AAA Cached Serve
87 0 192 192
6960 0 0 RADIUS TEST CMD
88 0 192 192
6960 0 0 AAA SEND STOP EV
89 0 168 0
7128 0 0 CEF Scanner
90 0 0 0
6968 0 0 SIP ATM cmd hand
91 0 0 0
6968 0 0 SONET alarm time
92 0 0 0
6960 0 0 Net Input
93 0 192 192
6960 0 0 Compute load avg
94 1 90632 89968
18392 0 0 console_rpc_serv
121804560 Total
------------------ show process cpu ------------------
CPU utilization for five seconds: 2%/0%; one minute: 2%; five minutes: 2%
PID Runtime(ms) Invoked uSecs 5Sec 1Min 5Min TTY Process
1 0 1 0 0.00% 0.00% 0.00% 0 Chunk Manager
2 4 14151 0 0.00% 0.00% 0.00% 0 Load Meter
3 0 1 0 0.00% 0.00% 0.00% 0 SCP async: CWAN-
4 9816 7180 1367 0.16% 0.01% 0.00% 0 Check heaps
5 0 23 0 0.00% 0.00% 0.00% 0 Pool Manager
6 0 2 0 0.00% 0.00% 0.00% 0 Timers
7 0 1 0 0.00% 0.00% 0.00% 0 AAA_SERVER_DEADT
8 0 2 0 0.00% 0.00% 0.00% 0 AAA high-capacit
9 0 2 0 0.00% 0.00% 0.00% 0 Serial Backgroun
10 840 14179 59 0.00% 0.00% 0.00% 0 ENVM Background
11 0 1180 0 0.00% 0.00% 0.00% 0 IPC Dynamic Cach
12 72 1182 60 0.00% 0.00% 0.00% 0 PROCMIB LC Proce
13 0 1 0 0.00% 0.00% 0.00% 0 IPC BackPressure
14 36 70728 0 0.00% 0.00% 0.00% 0 IPC Periodic Tim
15 44 70728 0 0.00% 0.00% 0.00% 0 IPC Deferred Por
16 12 19 631 0.00% 0.00% 0.00% 0 IPC Seat Manager
17 0 1 0 0.00% 0.00% 0.00% 0 SERIAL A'detect
18 2956 38 77789 0.00% 0.00% 0.00% 0 SMART
19 0 1 0 0.00% 0.00% 0.00% 0 Critical Bkgnd
20 36 14355 2 0.00% 0.00% 0.00% 0 Net Background
21 0 61 0 0.00% 0.00% 0.00% 0 Logger
22 240 70728 3 0.00% 0.00% 0.00% 0 TTY Background
23 1387988 138571 10016 2.04% 1.01% 1.04% 0 Per-Second Jobs
24 4808 1218 3947 0.00% 0.01% 0.00% 0 Per-minute Jobs
25 0 2 0 0.00% 0.00% 0.00% 0 SCP Multicast
26 0 1 0 0.00% 0.00% 0.00% 0 Inode Table Dest
Cisco IOS Interface and Hardware Component Command Reference
1457
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module slot tech-support
27 0 3 0 0.00% 0.00% 0.00% 0 LC to RP defere
28 0 26 0 0.00% 0.00% 0.00% 0 CWLC IFCOM Proce
29 0 1 0 0.00% 0.00% 0.00% 0 IPC RTTYC Messag
30 0 2 0 0.00% 0.00% 0.00% 0 INTR MGR PROCESS
31 0 11 0 0.00% 0.00% 0.00% 0 ixp_exmem_reuse_
32 4 62 64 0.00% 0.00% 0.00% 0 spnpc_dowork
33 0 1 0 0.00% 0.00% 0.00% 0 Spi4 Timer
34 0 1 0 0.00% 0.00% 0.00% 0 LC interrupt, J1
35 0 1 0 0.00% 0.00% 0.00% 0 SIP interrupt, P
36 0 1 0 0.00% 0.00% 0.00% 0 SDCC Input
37 0 2 0 0.00% 0.00% 0.00% 0 SDCC Periodic
38 0 2 0 0.00% 0.00% 0.00% 0 SDCC IO
39 0 1 0 0.00% 0.00% 0.00% 0 CWAN LTL manager
40 1208 14154 85 0.00% 0.00% 0.00% 0 msg_handler_proc
41 148 70730 2 0.00% 0.00% 0.00% 0 Cardmgr Periodic
42 0 6 0 0.00% 0.00% 0.00% 0 SIP SWBus Sync P
43 0 5 0 0.00% 0.00% 0.00% 0 NP doorbell proc
44 0 5 0 0.00% 0.00% 0.00% 0 CardMgr Events
45 1400 26 53846 0.00% 0.00% 0.00% 0 INP Reload
46 0 379 0 0.00% 0.00% 0.00% 0 ipc_handler_proc
47 0 5 0 0.00% 0.00% 0.00% 0 NP doorbell proc
48 2224 25 88960 0.00% 0.00% 0.00% 0 ENP Reload
49 16 1200 13 0.00% 0.00% 0.00% 0 ipc_handler_proc
50 0 1 0 0.00% 0.00% 0.00% 0 SIP2 Bus Stall
51 214912 53129 4045 0.00% 0.00% 0.00% 0 ifnpc_dowork
52 0 4 0 0.00% 0.00% 0.00% 0 hmi_dowork
53 0 31 0 0.00% 0.00% 0.00% 0 cwanlc_npc_dowor
54 0 1 0 0.00% 0.00% 0.00% 0 VIP Encap IPC Ba
55 18532 487255 38 0.00% 0.00% 0.00% 0 SPA OIR 5/0
56 84 2372 35 0.00% 0.00% 0.00% 0 SPA OIR 5/1
57 80 2368 33 0.00% 0.00% 0.00% 0 SPA OIR 5/2
58 84 2368 35 0.00% 0.00% 0.00% 0 SPA OIR 5/3
59 2432 32 76000 0.00% 0.00% 0.00% 0 LC FPD Upgrade P
60 3112 138447 22 0.00% 0.00% 0.00% 0 spa_env_monitor
61 0 2 0 0.00% 0.00% 0.00% 0 AAA Dictionary R
62 0 2 0 0.00% 0.00% 0.00% 0 AAA Server
63 0 1 0 0.00% 0.00% 0.00% 0 AAA ACCT Proc
64 0 1 0 0.00% 0.00% 0.00% 0 ACCT Periodic Pr
65 0 2 0 0.00% 0.00% 0.00% 0 ATMLS task
66 0 7185 0 0.00% 0.00% 0.00% 0 AToM NP CLIENT B
67 16 7185 2 0.00% 0.00% 0.00% 0 TTFIB NP CLIENT
68 8 707134 0 0.00% 0.00% 0.00% 0 SSA FABLINK Proc
69 0 14150 0 0.00% 0.00% 0.00% 0 HYP ACCU FAB COU
70 7140 103916 68 0.00% 0.00% 0.00% 0 CEF process
71 0 2 0 0.00% 0.00% 0.00% 0 CWTLC SSO Proces
72 328 4423 74 0.00% 0.00% 0.00% 0 SCP Hybrid proce
73 4 77777 0 0.00% 0.00% 0.00% 0 ATM NP CLIENT PR
74 324 70733 4 0.00% 0.00% 0.00% 0 BRIDGING NP CLIE
75 12 7182 1 0.00% 0.00% 0.00% 0 fr_npc_dowork
76 4 707140 0 0.00% 0.00% 0.00% 0 fastblk backgrou
77 40 2 20000 0.00% 0.00% 0.00% 0 hnpc_dowork
78 0 1 0 0.00% 0.00% 0.00% 0 SIP2 BRIDGE PROC
79 416 7079 58 0.00% 0.00% 0.00% 0 QoS NP Client
80 3300 726380 4 0.00% 0.00% 0.00% 0 CEF LC IPC Backg
81 628 93426 6 0.00% 0.00% 0.00% 0 CEF LC Stats
82 0 1 0 0.00% 0.00% 0.00% 0 CEF MQC IPC Back
83 0 1 0 0.00% 0.00% 0.00% 0 TFIB LC cleanup
84 0 2 0 0.00% 0.00% 0.00% 0 Any Transport ov
85 0 2 0 0.00% 0.00% 0.00% 0 LOCAL AAA
86 0 2 0 0.00% 0.00% 0.00% 0 AAA Cached Serve
87 0 3 0 0.00% 0.00% 0.00% 0 RADIUS TEST CMD
88 0 2 0 0.00% 0.00% 0.00% 0 AAA SEND STOP EV
89 128 5003 25 0.00% 0.00% 0.00% 0 CEF Scanner
90 0 1 0 0.00% 0.00% 0.00% 0 SIP ATM cmd hand
Cisco IOS Interface and Hardware Component Command Reference
1458
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module slot tech-support
91 0 1 0 0.00% 0.00% 0.00% 0 SONET alarm time
92 0 1 0 0.00% 0.00% 0.00% 0 Net Input
93 16 14775 1 0.00% 0.00% 0.00% 0 Compute load avg
94 92 502 183 0.00% 0.09% 0.02% 1 console_rpc_serv
------------------ show process cpu history ------------------
2222222223333322222222222222222222111112222222222222222222
100
90
80
70
60
50
40
30
20
10
0....5....1....1....2....2....3....3....4....4....5....5....
0 5 0 5 0 5 0 5 0 5
CPU% per second (last 60 seconds)
1 1 1 1
2222222222332222222222242432432222222222222222222222222222
100
90
80
70
60
50
40
30
20
10 * * * *
0....5....1....1....2....2....3....3....4....4....5....5....
0 5 0 5 0 5 0 5 0 5
CPU% per minute (last 60 minutes)
* = maximum CPU% # = average CPU%
1 9
4222222222222222229
100 *
90 *
80 *
70 *
60 *
50 *
40 *
30 *
20 *
10 * *
0....5....1....1....2....2....3....3....4....4....5....5....6....6....7.
0 5 0 5 0 5 0 5 0 5 0 5 0
CPU% per hour (last 72 hours)
* = maximum CPU% # = average CPU%
------------------ show file systems ------------------
File Systems:
Size(b) Free(b) Type Flags Prefixes
- - opaque rw system:
- - opaque rw null:
- - opaque ro tar:
* 64097280 40606720 disk rw disk0:
------------------ show disk0: all ------------------
-#- --length-- -----date/time------ path
Cisco IOS Interface and Hardware Component Command Reference
1459
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module slot tech-support
number of file 8
inode path is 1 idprom-oc12-atm-superspa
fullpath is disk0:/idprom-oc12-atm-superspa
1 1152 Jun 09 2004 13:03:38 idprom-oc12-atm-superspa
inode path is 2 idprom-4oc3-atm-superspa
fullpath is disk0:/idprom-4oc3-atm-superspa
2 1152 Jun 09 2004 05:51:34 idprom-4oc3-atm-superspa
inode path is 3 bonham_brd_rev2_rev19.hex
fullpath is disk0:/bonham_brd_rev2_rev19.hex
3 2626407 Aug 24 2004 11:04:42 bonham_brd_rev2_rev19.hex
inode path is 4 sip2-dw-mz.b2-testt
fullpath is disk0:/sip2-dw-mz.b2-testt
4 5895640 Aug 26 2004 05:09:08 sip2-dw-mz.b2-testt
inode path is 5 sip2-dw-mz.hp-depth
fullpath is disk0:/sip2-dw-mz.hp-depth
5 5897476 Aug 12 2004 04:40:38 sip2-dw-mz.hp-depth
inode path is 6 viking1.jbc
fullpath is disk0:/viking1.jbc
6 2678150 Jun 09 2004 12:48:32 viking1.jbc
inode path is 7 sip2-dw-mz.hpd
fullpath is disk0:/sip2-dw-mz.hpd
7 5916716 Aug 25 2004 10:25:14 sip2-dw-mz.hpd
inode path is 8 sip2iofpga_promlatest_rev78.hex
fullpath is disk0:/sip2iofpga_promlatest_rev78.hex
8 468975 Aug 24 2004 10:56:54 sip2iofpga_promlatest_rev78.hex
40606720 bytes available (23490560 bytes used)
******** ATA Flash Card Geometry/Format Info ********
ATA CARD GEOMETRY
Number of Heads: 4
Number of Cylinders 984
Sectors per Cylinder 32
Sector Size 512
Total Sectors 125952
ATA CARD FORMAT
Number of FAT Sectors 246
Sectors Per Cluster 2
Number of Clusters 62595
Number of Data Sectors 125817
Base Root Sector 595
Base FAT Sector 103
Base Data Sector 627
------------------ show scp status ------------------
Rx 29169, Tx 29165, Sap 3 scp_my_addr 0x4
Id Sap Channel name current/peak/retry/dropped/total time(queue/process/ack)
-- ---- ------------------- -------------------------------- ----------------------
0 0 SCP Unsolicited:0 0/ 2/ 0/ 0/ 4421 0/ 0/ 76
1 23 SCP async: CWAN-NMP 0/ 0/ 0/ 0/ 0 0/ 0/ 0
------------------ show inventory ------------------
------------------ show region ------------------
Region Manager:
Start End Size(b) Class Media Name
0x0F000000 0x0FFFFDFF 16776704 Iomem R/W iomem
0x40000000 0x4EFFFFFF 251658240 Local R/W main
0x40010FC0 0x4067FFE7 6746152 IText R/O main:text
0x40680000 0x40CE977F 6723456 IData R/W main:data
0x40CE9780 0x4145B85F 7807200 IBss R/W main:bss
0x4145B860 0x4EFFFFFF 230311840 Local R/W main:heap
0x80000000 0x8EFFFFFF 251658240 Local R/W main:(main_k0)
0xA0000000 0xAEFFFFFF 251658240 Local R/W main:(main_k1)
------------------ show buffers ------------------
Buffer elements:
500 in free list (500 max allowed)
595460 hits, 0 misses, 0 created
Public buffer pools:
Cisco IOS Interface and Hardware Component Command Reference
1460
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module slot tech-support
Small buffers, 104 bytes (total 37, permanent 25, peak 39 @ 19:39:17):
35 in free list (20 min, 60 max allowed)
310581 hits, 48 misses, 110 trims, 122 created
0 failures (0 no memory)
Middle buffers, 600 bytes (total 15, permanent 15, peak 21 @ 19:39:19):
14 in free list (10 min, 30 max allowed)
20386 hits, 2 misses, 6 trims, 6 created
0 failures (0 no memory)
Big buffers, 1536 bytes (total 6, permanent 5, peak 8 @ 19:39:21):
6 in free list (5 min, 10 max allowed)
16375 hits, 1 misses, 11 trims, 12 created
0 failures (0 no memory)
VeryBig buffers, 4520 bytes (total 50, permanent 50):
50 in free list (40 min, 300 max allowed)
0 hits, 0 misses, 0 trims, 0 created
0 failures (0 no memory)
Large buffers, 5024 bytes (total 0, permanent 0):
0 in free list (0 min, 5 max allowed)
0 hits, 0 misses, 0 trims, 0 created
0 failures (0 no memory)
Huge buffers, 18024 bytes (total 1, permanent 1):
1 in free list (0 min, 2 max allowed)
0 hits, 0 misses, 0 trims, 0 created
0 failures (0 no memory)
Interface buffer pools:
IPC buffers, 4096 bytes (total 85, permanent 16, peak 85 @ 00:00:36):
12 in free list (10 min, 30 max allowed)
251678 hits, 23 fallbacks, 0 trims, 69 created
0 failures (0 no memory)
Header pools:
SDCC Packet Header buffers, 0 bytes (total 2048, permanent 2048):
0 in free list (2048 min, 2048 max allowed)
2048 hits, 0 misses
2048 max cache size, 2048 in cache
0 hits in cache, 0 misses in cache
Particle Clones:
2048 clones, 0 hits, 0 misses
Public particle pools:
GLOBAL buffers, 512 bytes (total 862, permanent 862):
0 in free list (0 min, 862 max allowed)
862 hits, 0 misses
862 max cache size, 862 in cache
0 hits in cache, 0 misses in cache
COMM buffers, 512 bytes (total 32, permanent 32):
0 in free list (0 min, 32 max allowed)
32 hits, 0 misses
32 max cache size, 32 in cache
0 hits in cache, 0 misses in cache
Private particle pools:
SB-FIFO5/0/1 buffers, 512 bytes (total 1000, permanent 1000):
0 in free list (0 min, 1000 max allowed)
1000 hits, 0 fallbacks
1000 max cache size, 744 in cache
261 hits in cache, 0 misses in cache
14 buffer threshold, 0 threshold transitions
EOBC0/0 buffers, 512 bytes (total 2000, permanent 2000):
0 in free list (0 min, 2000 max allowed)
2000 hits, 0 misses
2000 max cache size, 1744 in cache
79803 hits in cache, 0 misses in cache
14 buffer threshold, 0 threshold transitions
Ingress ESF Engine buffers, 1028 bytes (total 21, permanent 21):
0 in free list (21 min, 21 max allowed)
21 hits, 0 misses
Cisco IOS Interface and Hardware Component Command Reference
1461
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module slot tech-support
21 max cache size, 0 in cache
21 hits in cache, 0 misses in cache
Egress ESF Engine buffers, 1028 bytes (total 21, permanent 21):
0 in free list (21 min, 21 max allowed)
21 hits, 0 misses
21 max cache size, 0 in cache
21 hits in cache, 0 misses in cache
------------------ show platform hardware version ------------------
Product Number: '7600-MSC-400'
Baseboard Serial Number: 'SAD073101T6'
Manufacturing Assembly Revision: 'A01'
Baseboard Revision: 0.14
Daughtercard Serial Number: ''
CPU Manufacturer: 0x4 (Broadcom)
CPU SOC Type: BCM1125H 400 Mhz rev 0x21 wafer 0x1
CPU Revision: 0.3
Super Santa Ana: 0x0
PM PLD: 0x5
IOFPGA version: 0x00051
type: 0x0 format 0x2 loaded from Upgrade (C1) region
ROMMON (major.minor.dev.build) = 1.1.0.1
Bonham version: 0x019
type: rev2-or-higher-bb
Gldfgr version: 0x10014
Oddjob version: 0x10010
Hyperion: 0x2
Config PLD: 0x6
Ingress ESF Engine : Type 0.0 rev 0.2, 1400 MHz
SRAM clocks: 140/200/200/200 MHz
DRAM clock: 400 MHz
Egress ESF Engine : Type 0.0 rev 0.2, 1400 MHz
SRAM clocks: 200/200/140/200 MHz
DRAM clock: 400 MHz
------------------ show platform hardware iofpga ------------------
CPU base address: 0xB1000000
0000: type_and_version: 0x00000251
0004: global_intr_en: 0x100D1021
0008: global_intr_stat: 0x00000008
000C: reset_reason_reg: 0x00000001
0010: cpu_resets: 0x00000000
0014: device_reset: 0x00000040
0018: watchdog: 0x00003D96
001C: who_am_i: 0x00002200
0020: rommon_sel: 0x00000001
0024: led_reg: 0x0000001F
0028: iofpga_ctrl: 0x00000400
002C: earl_control: 0x0000000F
0030: iobus_intr_en: 0x0000000F
0034: iobus_intr_stat: 0x00000000
0038: iobus_deadman: 0x00000015
003C: iobus_last_addr: 0x00000000
0040: iobus_last_data: 0x00000000
0044: iobus_tran_stat: 0x00000000
0048: test_pins_reg: 0x00000000
0058: pld_jtag: 0xCAFEBABE
SIP2 base addr: 0xB1000400
0000: spa_ctrl: 0x00000923
0004: spa_intr_en: 0x7E07222F
0008: spa_intr_stat: 0x01000000
000C: spa_stat: 0x0000222C
0010: spabus_deadman: 0x0000002A
0014: spabus_tran_stat: 0x0800021C
0018: spabus_last_read: 0x00070001
001C: spabus_last_par: 0x00003531
Cisco IOS Interface and Hardware Component Command Reference
1462
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module slot tech-support
0020: spa_test: 0xAB2B2B29
0024: spd_ctrl: 0x00000007
0028: scratchpad: 0x00000000
002C: ha_state: 0x00000001
0030: spa0_debounce: 0x0000000A
0034: spa1_debounce: 0x0000000A
0038: spa2_debounce: 0x0000000A
003C: spa3_debounce: 0x0000000A
0044: ha_sanity: 0x00000007
0040: spa_sonet_clk: 0x200AD500
0048: spa_sonet_clk_ie: 0x00000000
004C: spa_sonet_clk_is: 0x1FFFFFFC
0050: spa_sonet_clk_div[0]: 0x0000097E
0054: spa_sonet_clk_div[1]: 0x0000097E
0058: spa_sonet_clk_div[2]: 0x0000097E
005C: spa_sonet_clk_div[3]: 0x0000097E
Cisco IOS Interface and Hardware Component Command Reference
1463
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module subslot
show hw-module subslot
To display diagnostic information about internal hardware devices for a SPA, use the show hw-module
subslot command in privileged EXEC configuration mode.
To display diagnostic information about modules and interfaces on a Cisco 4400 Series ISR, use the show
hw-module subslot command in privileged EXEC mode.
show hw-module subslot [slot/subslot] {brief|config|counters|errors|registers|status} device port
Cisco 4400 Series Integrated Services Router (ISR)
show hw-module subslot [slot/subslot]
all|attribute|entity|fpd|oir|sensors|subblock
Syntax Description slot (Optional) Chassis slot number or module interface slot number.
Refer to the appropriate hardware manual for slot information. For SIPs, refer to the
platform-specific SPA hardware installation guide or the corresponding "Identifying Slots
and Subslots for SIPs and SPAs" topic in the platform-specific SPA software configuration
guide.
For more information on slots for the Cisco 4400 Series ISR, refer to hardware installation
guide.
/subslot (Optional) Secondary slot number on a SIP where a SPA is installed.
Refer to the platform-specific SPA hardware installation guide and the corresponding
"Specifying the Interface Address on a SPA" topic in the platform-specific SPA software
configuration guide for subslot information.
For more information on subslots for the Cisco 4400 Series ISR, refer to hardware
installation guide.
allsubslot Selects all supported modules and displays diagnostic and register information related to
the modules including:
• attribute--Detailed module attribute information
• entity--MIB details of an entity¹.
• fpd--Field programmable devices (fpd) information
• oir--Online insertion and removal (oir) summary
• sensors--Environmental sensor summary
• subblock--Internal data structure related to the supported module¹
• tech-support--Subslot information for technical support
Cisco IOS Interface and Hardware Component Command Reference
1464
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module subslot
brief config | Specifies the display of diagnostic and register information related to the following areas:
counters
• brief--Reserved for future.
errors |
registers status • config--Displays information related to configuration of the specified internal hardware
device.
• counters--Displays statistics related to the processing by the specified internal
hardware device.
• errors--Reserved for future.
• registers--Displays register information for the specified internal hardware device.
• status--Displays status information for the specified internal hardware device.
device Specifies the internal hardware device or path on the SPA for which you want to display
diagnostic information, including the field programmable gate array (FPGA) device, MAC
device, PHY device, or System Packet Interface Level 4 (SPI4) path from the MSC to the
FPGA device.
port (Optional) Port or interface number.
Refer to the appropriate hardware manual for port information. For SPAs, refer to the
corresponding “Specifying the Interface Address on a SPA” topics in the platform-specific
SPA software configuration guide.
Command Default No default behavior or values
Command Modes Privileged EXEC
Command History Release Modification
12.2(20)S2 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support
in a specific 12.2SX release of this train depends on your feature set, platform,
and platform hardware.
Cisco IOS XE Release 3.9S This command was implemented on Cisco 4400 Series ISR and integrated into
Cisco IOS XE Release 3.9 S.
Usage Guidelines Use the show hw-module subslot command to obtain diagnostic information about an interface on the SPA.
The counters keyword displays a subset of the statistics that are also provided by the show controllers
fastethernet command for the specified SPA device.
Use the show hw-module subslot command in Cisco 4400 Series ISRs to obtain diagnostic information
related to all supported Cisco services modules and network interface modules(NIM). You can use the show
hw-module subslot all oir command to verify the operation and proper activation of a module after an online
insertion or removal.
Cisco IOS Interface and Hardware Component Command Reference
1465
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module subslot
Show hw-module subslot all oir Example
The following sample output from the show hw-module subslot all oir command verifies activation
and proper operation of all supported modules on the router:
Router#show hw-module subslot all oir
Module Model Operational Status
-------------- ------------------ -------------------------
subslot 0/1 NIM-8MFT-T1/E1 ok
subslot 1/0 SM-X T1/E1 ok
Examples The following examples provide sample output for several versions of the show hw-module subslot
command for a SPA located in the top subslot (0) of the MSC that is installed in slot 4 on a Cisco
7304 router.
show hw-module subslot config fpga Example
The following shows sample output from the show hw-module subslot config command for the
FPGA device on the first interface (port 0):
Router# show hw-module subslot 4/0 config fpga 0
FPGA RX Config
RX FIFO parity select is even
RX CRC check is enabled
RX SHIM header insertion is disabled
RX Flow control is enabled
RX CRC strip is enabled
RX TCAM LKUP is enabled
FPGA TX Config
TX FIFO parity select is even
TX CRC generation is enabled
TX Padding is enabled
show hw-module subslot config phy Example
The following shows sample output from the show hw-module subslot config command for the
PHY device on the first interface (port 0):
Router# show hw-module subslot 4/0 config phy 0
PHY version: identifier1 = 0x141, identifier2 = 0xCD2
PHY Configuration:
control (reg 0) = 0x3100
PHY state: not in reset, not powered down, not isoloated
speed: 100 Mbps, duplex: full
auto-negotiation enabled, loopback disabled, collision test disabled
phy specific control (reg 16) = 0x78
force link good: no
MDI cross-over mode: automatic crossover
Tx FIFO depth: +/- 16 bits, Rx FIFO depth: +/- 16 bits
never assert CRS on transmit, energy detect: off
Cisco IOS Interface and Hardware Component Command Reference
1466
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module subslot
enable extended distance: no, 125 clock: low
MAC interface power: always up, SQE test: disabled
polarity reversal: enabled, jabber function: enabled
extended phy specific control (reg 20) = 0xCE2
line loopback: disabled, detect lost lock: no, enabled RCLK
master downshift counter: 4, slave downshift counter: 0
default MAC interface speed: 1000 Mbps
fiber auto-negotiation disabled
add delay to RX_CLK for RXD outputs: yes
add delay to GTX_CLK for TXD latching: yes
auto-negotiation advertisement for 10/100 (reg 4) = 0xDE1
10Base-Tx half-duplex: yes, full-duplex: yes
100Base-Tx half-duplex: yes, full-duplex: yes
pause frame support: yes, asymmetric pause: yes
set remote fault bit: no, advertise next page: no
show hw-module subslot counters fpga Example
The following shows sample output from the show hw-module subslot counters command for the
FPGA device on the first interface (port 0):
Note This information is also available using the show controllers fastethernet command.
Router# show hw-module subslot 4/0 counters fpga 0
Input: Total (good & bad) packets: 5734
TCAM drops: 4908
Satisfy (host-backpressure) drops: 0
CRC drops: 0
PL3 RERRs: 0
Output: EOP (SPI4) errors: 0
show hw-module subslot status mac Example
The following shows sample output from the show hw-module subslot command for MAC device
status on the first interface (port 0):
Router# show hw-module subslot 4/0 status mac 0
Status registers:
speed = 100 Mbps, duplex = full, interface mode = copper
spi3 side loopback is disabled, line side loopback is disabled
padding is disabled, crc add is disabled
force duplex is enabled
Rx FIFO status:
Read pointer = 0xCDE, Write pointer = 0xCDE
Occupancy of FIFO in 8 byte locations = 0
Reset is not set
Overflow event did not occur
Tx FIFO status:
Read pointer = 0x498, Write pointer = 0x498
Occupancy of FIFO in 8 byte locations = 0
Overflow event did not occur
Underflow event did not occur
Out of sequence event did not occur
Cisco IOS Interface and Hardware Component Command Reference
1467
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module subslot
show hw-module subslot status phy Example
The following shows sample output from the show hw-module subslot command for PHY device
status on the first interface (port 0):
Router# show hw-module subslot 4/0 status phy 0
PHY Status:
status (reg 1) = 0x7949
link is down, auto-negotiation is not complete
remote fault not detected, jabber not detected
phy specific status (reg 17) = 0x4100
link is down (real-time), speed/duplex not resolved
speed: 100 Mbps, duplex: half
page not received, cable length is 80 - 110m
MDI cross-over status: MDI, downshift status: no
energy detect status: active
transmit pause: disabled, receive pause: disabled
polarity: normal, jabber: no
phy specific extended status (reg 27) = 0x848B
Fiber/ copper auto selection disabled, copper link
Serial interface auto-negotiation bypass disabled
Serial interface auto-negotiation bypass status:
Link came up because regular fiber autoneg completed
Interrupt polarity is active low
receive error count: 0x0
Related Commands Command Description
hw-module subslot service-engine Opens a session on the Cisco WebEx Node SPA console.
session
service-engine default-gateway Defines a default gateway router IP address for the Cisco WebEx
Node SPA.
service-engine ip address Selects and configures the internal interface for management traffic
on a Cisco WebEx Node SPA.
service-engine hostname Specifies or modifies the hostname or domain name associated
with a Cisco WebEx Node SPA.
service-engine nameserver Specifies the primary and secondary domain name server used by
the Cisco WebEx Node SPA.
service-engine wma-passcode Configures the name and that are used for authentication on a Cisco
WebEx Node SPA.
service-engine wma-token Configures an encrypted token on a Cisco WebEx Node SPA.
service-engine wma-url Specifies the URL to which the Cisco WebEx Node SPA must
connect to enable WebEx meetings.
Cisco IOS Interface and Hardware Component Command Reference
1468
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module subslot fpd
show hw-module subslot fpd
To display the current versions of all field-programmable devices (FPDs) for a particular SPA or all of the
active SPAs on a router, use the showhw-modulesubslotfpd command in privileged EXEC mode.
Cisco 7304 Router
show hw-module subslot [slot/subslot] fpd
Cisco 7600 Series Routers, Catalyst 6500 Series Switches, Cisco 12000 Series Routers, and Cisco
uBR10012 Universal Broadband Router
show hw-module subslot {slot/subslot|all} fpd
Syntax Description slot Chassis slot number.
Refer to the platform-specific SPA hardware installation guide and the corresponding “Identifying
Slots and Subslots for SIPs and SPAs” topic in the platform-specific SPA software configuration
guide.
subslot Secondary slot number on a SPA interface processor (SIP) where a SPA is installed.
Refer to the platform-specific SPA hardware installation guide and the corresponding “Specifying
the Interface Address on a SPA” topic in the platform-specific SPA software configuration guide
for subslot information.
all Specifies display of FPD information for all SPAs in the system.
Note The all keyword is not supported for SPAs on the Cisco 7304 router.
Command Default For the Cisco 7304 router, if no location is specified, the output for this command will show information for
all supported card types on the router.
For the Cisco 7600 series routers, Catalyst 6500 series switches, and Cisco 12000 series routers, there is no
default behavior or values.
For more information about FPD upgrades on shared port adapters (SPAs), refer to the Cisco 7600 Series
Router SIP, SSC, and SPA Software Configuration Guide.
Command Modes Privileged EXEC
Command History Release Modification
12.2(20)S2 This command was introduced.
12.2(18)SXE The all keyword was added in Cisco IOS Release 12.2(18)SXE on the Cisco 7600 series
routers and Catalyst 6500 series switches.
12.0(31)S This command was integrated into Cisco IOS Release 12.0(31)S and introduced on Cisco
12000 series routers.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SCB This command was integrated into Cisco IOS Release 12.2(33)SCB.
Cisco IOS Interface and Hardware Component Command Reference
1469
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module subslot fpd
Usage Guidelines Other than the FPD version information, the output for this command may also contain useful FPD-related
notes.
Cisco 7304 Router
The all keyword is not supported on the Cisco 7304 router. The slot/subslot arguments are optional, and if
you do not specify them, the command displays FPD information for all supported card types on the router.
Cisco 7600 Series Routers, Catalyst 6500 Series Switches, 12000 Series Routers, and Cisco uBR10012
Universal Broadband Router
If you do not use the all keyword, then you must specify the slot/subslot arguments to select the location of
a particular card. There is no default behavior for this command on the Cisco 7600 series routers.
Examples
Displaying FPD Information for a Particular SPA Example
This example shows the output when using the slot/subslot arguments to identify a particular SPA.
This SPA meets the minimum FPD requirements with that particular Cisco IOS release.
Router#
show hw-module subslot 4/0 fpd
==== ====================== ====== =============================================
H/W Field Programmable Current Min. Required
Slot Card Description Ver. Device: "ID-Name" Version Version
==== ====================== ====== ================== =========== ==============
4/0 SPA-4XOC3-ATM 1.0 1-I/O FPGA 0.121 0.121
==== ====================== ====== =============================================
Cisco uBR10012 Universal Broadband Router
The following example shows the output when using the slot/subslot arguments to identify a particular
SPA on a Cisco uBR10012 router:
Router#
show hw-module subslot 3/1 fpd
==== ====================== ====== =============================================
H/W Field Programmable Current Min. Required
Slot Card Type Ver. Device: "ID-Name" Version Version
==== ====================== ====== ================== =========== ==============
3/1 SPA-24XDS-SFP 1.0 1-Modena BLAZE FPG 1285.1444 1285.1444
==== ====================== ====== =============================================
Displaying FPD Information for all SPAs in the System Example
This example shows FPD image file versions for all SPAs in the system:
Router# show hw-module subslot all fpd
==== ====================== ====== =============================================
H/W Field Programmable Current Min. Required
Slot Card Type Ver. Device: "ID-Name" Version Version
==== ====================== ====== ================== =========== ==============
4/0 SPA-4XOC3-ATM 1.0 1-I/O FPGA 0.121 0.121
---- ---------------------- ------ ------------------ ----------- --------------
4/1 SPA-8XT1/E1 0.143 1-ROMMON 2.12 2.12
Cisco IOS Interface and Hardware Component Command Reference
1470
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module subslot fpd
2-I/O FPGA 0.22 0.22
---- ---------------------- ------ ------------------ ----------- --------------
4/3 SPA-4XOC3-POS 0.100 1-I/O FPGA 3.4 3.4
---- ---------------------- ------ ------------------ ----------- --------------
7/0 SPA-8XCHT1/E1 0.117 1-ROMMON 2.12 2.12
2-I/O FPGA 0.22 0.22
---- ---------------------- ------ ------------------ ----------- --------------
7/1 SPA-4XOC3-ATM 0.205 1-I/O FPGA 0.121 0.121
==== ====================== ====== =============================================
Cisco uBR10012 Universal Broadband Router
The following example shows FPD image file versions for all SPAs on a Cisco uBR10012 router:
Router#
show hw-module subslot all fpd
==== ====================== ====== =============================================
H/W Field Programmable Current Min. Required
Slot Card Type Ver. Device: "ID-Name" Version Version
==== ====================== ====== ================== =========== ==============
3/0 SPA-24XDS-SFP 1.0 1-Modena BLAZE FPG 1285.1444 1285.1444
---- ---------------------- ------ ------------------ ----------- --------------
3/1 SPA-24XDS-SFP 1.0 1-Modena BLAZE FPG 1285.1444 1285.1444
---- ---------------------- ------ ------------------ ----------- --------------
3/2 SPA-1X10GE-L-V2 1.2 1-10GE V2 I/O FPGA 1.9 1.9
---- ---------------------- ------ ------------------ ----------- --------------
3/3 SPA-5X1GE-V2 1.2 1-5xGE V2 I/O FPGA 1.10 1.10
==== ====================== ====== =============================================
Displaying Information for all SPAs in the System Example (Cisco 7304 only)
The all keyword is not supported on the Cisco 7304 router.
To display all FPD image file versions for all SPAs on a Cisco 7304 router, enter the
showhw-modulesubslotfpd command without specifying a slot and subslot. The following example
shows all FPD image file versions on a Cisco 7304 router:
Router# show hw-module subslot fpd
==== ====================== ====== =============================================
H/W Field Programmable Current Min. Required
Slot Card Description Ver. Device:"ID-Name" Version Version
==== ====================== ====== ================== =========== ==============
2/0 SPA-4FE-7304 0.32
1-Data & I/O FPG
A 4.13 4.13
---- ---------------------- ------ ------------------ ----------- --------------
2/1 SPA-2GE-7304 0.15
1-Data & I/O FPG
A 4.13 4.13
==== ====================== ======
=============================================
Cisco IOS Interface and Hardware Component Command Reference
1471
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module subslot fpd
Related Commands Command Description
show hw-module all fpd Displays the current versions of all FPDs for all of the supported card types on
a router.
show hw-module slot fpd Displays the current versions of all FPDs for a SIP in the specified slot location
on a router, and for all of the SPAs installed in that SIP.
Cisco IOS Interface and Hardware Component Command Reference
1472
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module subslot oir
show hw-module subslot oir
To display the operational status of a shared port adapter (SPA), use the showhw-modulesubslotoir command
in privileged EXEC configuration mode.
show hw-module subslot {slot/subslot|all} oir [internal]
Syntax Description slot Chassis slot number.
Refer to the appropriate hardware manual for slot information. For SIPs, refer to the
platform-specific SPA hardware installation guide or the corresponding “Identifying Slots and
Subslots for SIPs and SPAs” topic in the platform-specific SPA software configuration guide.
/ subslot Secondary slot number on a SPA interface processor (SIP) where a SPA is installed.
Refer to the platform-specific SPA hardware installation guide and the corresponding “Specifying
the Interface Address on a SPA” topic in the platform-specific SPA software configuration guide
for subslot information.
all Displays OIR status for all supported card types in the system.
internal (Optional) Displays detailed diagnostic information. This option is intended for internal diagnostic
use with Cisco Systems technical support personnel.
Command Default No default behavior or values
Command Modes Privileged EXEC
Command History Release Modification
12.2(25)S3 This command was introduced.
12.2(18)SXE Thiscommand was integrated into Cisco IOS Release 12.2(18)SXE.
12.0(31)S This command was integrated into Cisco IOS Release 12.0(31)S.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines Use the showhw-modulesubslotoir command to obtain operational status information about one or all SPAs.
To display information for a specific SPA, specify the slot number of the SIP and the subslot number of the
SPA about which you want information.
To display information for all SPAs in the router, do not specify the slot/subslot arguments and use the all
keyword. If no location is specified, the output for this command will show information for all SPAs in the
router.
The optional internal keyword displays detailed diagnostic information that is recommended only for use
with Cisco Systems technical support personnel.
Examples The following example shows the operational status of all of the SPAs installed in a router where
two of the SPAs are in an out-of-service condition:
Cisco IOS Interface and Hardware Component Command Reference
1473
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module subslot oir
Router# show hw-module subslot all oir
Module Model Operational Status
-------------- ------------------ -------------------------
subslot 4/0 SPA-4XOC3-POS booting
subslot 4/1 SPA-4XOC3-ATM out of service(FPD upgrade failed)
subslot 4/2 SPA-4XOC3-POS ok
subslot 4/3 SPA-1XTENGE-XFP out of service(SPA unrecognized)
The table below describes the possible values for the Operational Status field in the output.
Note The following status descriptions are not applicable to every SPA and can be platform-specific.
Table 111: Operational Status Field Descriptions
Operational Description
Status
admin down SPA is administratively disabled by the hw-modulesubslotshutdown global configuration
command.
booting SPA is initializing.
missing SPA is not present in the SIP subslot.
ok SPA is operational.
out of service The SPA is out of service for one of the following reasons:
(reason )
Note The following reasons are not applicable to every SPA and can be
platform-specific.
• Analyze failed--Failed to create a SPA data structure, most likely due to a memory
allocation problem.
• Authentication failed--A SPA has failed hardware validation.
• Data structure create error--Failed to create a SPA data structure, most likely due to a
memory allocation problem.
• Event corrupt--A SPA online insertion and removal (OIR) event has been corrupted.
This could be caused by a corrupted message between the SIP and the Route Processor
(RP) or some other software or hardware problem.
• Event sequence error--A SPA OIR event was received out of sequence. This could be
caused by a corrupted message between the SIP and the Route Processor (RP) or some
other software or hardware problem.
• Fail code not set--Failure code could not be read from a SPA OIR event message. This
could be caused by a corrupted message between the SIP and the RP or some other
software or hardware problem.
• Failed too many times--A SPA is disabled because it has failed more than the allowable
limit on the platform.
Cisco IOS Interface and Hardware Component Command Reference
1474
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module subslot oir
Operational Description
Status
• FPD upgrade failed--A field-programmable device, such as the Field-Programmable
Gate Array (FPGA), failed to automatically upgrade.
• H/W signal deasserted--The SPA_OK or PWR_OK hardware signal indicating that the
SPA is accessible is no longer asserted.
• Heartbeat failed--Occurs when intelligent SPAs encounter heartbeat failures.
• Incompatible FPD--An FPGA version mismatch with the Cisco IOS software has been
detected for the SPA.
• Init timeout--Time limit has been reached during initialization of a SPA.
• Read SPA type failed--A read from the hardware for the SPA type failed.
• Reload request--A SPA reload is in progress from the hw-modulesubslotreload
command.
• SPA h/w error--The SPA software driver has detected a hardware error.
• SPA ready timeout--A timeout ocurred on the RP while waiting for the SPA to become
operational.
• SPA type mismatch--Occurs when you have preconfigured a SPA of one type, but have
inserted a SPA of a different type.
Note This reason code only applies to those platforms that support pre-configuration.
This is not applicable to a Cisco 7600 series router or Catalyst 6500 series switch.
• SPA unrecognized--SPA is not supported by the Cisco IOS software release.
• Start failed--Failed to start interfaces on SPA.
• Unexpected inserted event--The SPA OIR software has received a SPA insertion event
when the OIR software considered the SPA already present.
• Wait h/w ok timeout--A timeout occurred while waiting for the SPA_OK and PWR_OK
hardware signals to be asserted.
• Wait start timeout--A timeout occurred on the SIP while waiting for permission from
the RP to bring up the SPA.
stopped SPA has been gracefully deactivated using the hw-modulesubslotstop privileged EXEC
command on the Cisco 7304 router.
The following example shows the operational status of all of the SPAs installed in a router where all
SPAs are running successfully:
Router# show hw-module subslot all oir
Module Model Operational Status
------------- -------------------- ------------------------
subslot 1/1 SPA-2XOC3-ATM ok
subslot 4/0 SPA-2XT3/E3 ok
Cisco IOS Interface and Hardware Component Command Reference
1475
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module subslot oir
subslot 4/1 SPA-4XOC3-POS ok
subslot 4/2 SPA-8XCHT1/E1 ok
The following example shows sample output when using the optional internal keyword:
Router# show hw-module subslot 4/0 oir internal
WARNING: This command is not intended for production use
and should only be used under the supervision of
Cisco Systems technical support personnel.
sm(spa_oir_tsm subslot 4/0 TSM), running yes, state ready
Admin Status: admin enabled, Operational Status: ok(1)
Last reset Reason: manual
TSM Context:
configured_spa_type 0x483
soft remove fail code 0x0(none)
last_fail_code 0x110E(SPA unrecognized)
fail_count 0
timed_fail_count 0, failed_spa_type 0x483
recovery_action 6
associated_fail_code 0x110E(SPA unrecognized)
sequence numbers: next from tsm 4, last to tsm 2
flags 0x0
Subslot:
spa type 0x483, active spa type 0x483
subslot flags 0x0, plugin flags 0x0
TSM Parameters:
wait_psm_ready_timeout 360000 ms, init_timeout 240000 ms
short_recovery_delay 5000 ms, long_recovery_delay 120000 ms
ok_up_time 1200000 ms, bad_fail_count 10
fail_time_period 600000 ms, max_fail_count 5
does not support pre-configuration
SPA OIR state machine audit statistics
In-sync poll-count qry-fail resp-fail restarts fail-count
subslot 4/0 yes 1 0 0 0 0
Related Commands Command Description
hw-module subslot reload Restarts a SPA and its interfaces.
hw-module subslot shutdown Shuts down a SPA with or without power.
Cisco IOS Interface and Hardware Component Command Reference
1476
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module subslot service-engine status
show hw-module subslot service-engine status
To display the Cisco WebEx Node SPA application status on a Cisco ASR 1000 Series Router, use the
showhw-modulesubslotservice-enginestatuscommand in privileged EXEC mode.
show hw-module subslot slot/subslot service-engine status
Syntax Description slot Specifies the chassis slot number for the Cisco ASR 1000 Series Router SIP.
/ subslot Specifies the secondary subslot number on a Cisco ASR 1000 Series Router SIP where a SPA
is installed.
Command Default No default behavior or values.
Command Modes Privileged EXEC (#)
Command History Release Modification
IOS XE Release 2.4 Thiscommand was introduced.
Usage Guidelines Use the showhw-modulesubslotservice-enginestatuscommand to obtain information about the Cisco WebEx
Node SPA application status. This includes configuration information sent from the Route Processor (RP)
and the operation status of the application.
Examples The following example provides sample output for the
showhw-modulesubslotservice-enginestatuscommand for a Cisco WebEX Node SPA located in
the top subslot (0) of the SIP that is installed in slot 0 on a Cisco ASR 1000 Series Router:
Related Commands Command Description
hw-module subslot service-engine Opens a session on the Cisco WebEx Node SPA console.
session
service-engine default-gateway Defines a default gateway router IP address for the Cisco WebEx
Node SPA.
service-engine ip address Selects and configures the internal interface for management traffic
on a Cisco WebEx Node SPA.
service-engine hostname Specifies or modifies the hostname or domain name associated
with a Cisco WebEx Node SPA.
service-engine nameserver Specifies the primary and secondary domain name server used by
the Cisco WebEx Node SPA.
service-engine wma-passcode Configures the name and that are used for authentication on a
Cisco WebEx Node SPA.
Cisco IOS Interface and Hardware Component Command Reference
1477
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module subslot service-engine status
Command Description
service-engine wma-token Configures an encrypted token on a Cisco WebEx Node SPA.
service-engine wma-url Specifies the URL to which the Cisco WebEx Node SPA must
connect to enable WebEx meetings.
Cisco IOS Interface and Hardware Component Command Reference
1478
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module subslot transceiver
show hw-module subslot transceiver
To display the information about an optical transceiver installed in a shared port adapter (SPA), use the
showhw-modulesubslottransceiver command in privileged EXEC configuration mode.
show hw-module subslot slot/subslot transceiver port {idprom [{brief|detail|dump}]|status}
Syntax Description slot Chassis slot number.
Refer to the appropriate hardware manual for slot information. For SIPs, refer to the
platform-specific SPA hardware installation guide or the corresponding “Identifying Slots and
Subslots for SIPs and SPAs” topic in the platform-specific SPA software configuration guide.
/ subslot Secondary slot number on a SPA interface processor (SIP) where a SPA is installed.
Refer to the platform-specific SPA hardware installation guide and the corresponding “Specifying
the Interface Address on a SPA” topic in the platform-specific SPA software configuration guide
for subslot information.
port Port or interface number.
Refer to the platform-specific SPA hardware installation guide and the corresponding “Specifying
the Interface Address on a SPA” topic in the platform-specific SPA software configuration guide
for subslot information.
idprom Displays detailed hardware information for the specified transceiver.
brief (Optional) Displays summary hardware information for the specified transceiver.
detail (Optional) Displays detailed hardware information for the specified transceiver.
dump (Optional) Displays register information for the specified transceiver.
status Displays operational status for the specified transceiver.
Command Default No default behavior or values
Command Modes Privileged EXEC
Command History Release Modification
12.2(18)SXE Thiscommand was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines Use the showhw-modulesubslottransceiver command to obtain hardware information or operational status
for optical devices installed in a SPA.
Cisco Systems qualifies the small form-factor pluggable (SFP) optics modules that can be used with SPAs.
Cisco IOS Interface and Hardware Component Command Reference
1479
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module subslot transceiver
Note The SPAs will only accept the SFP modules listed as supported in this document. An SFP check is run every
time an SFP module is inserted into a SPA and only SFP modules that pass this check will be usable.
If a transceiver has not been qualified by Cisco Systems for use with a SPA, the
showhw-modulesubslottransceiverstatus command reports the following message:
The transceiver in slot 4 subslot 0 port 2
is not a Cisco supplied component. In the current configuration
third party transceivers are not serviced.
If a transceiver has not been qualified by Cisco Systems for use with a SPA,
theshowhw-modulesubslottransceiveridprom command reports the following message:
Transceiver is not a Cisco supplied part: the system cannot read the IDPROM
Examples
Example of the show hw-module subslot transceiver idprom Command for an OC-3 Transceiver
The following example shows hardware IDPROM information for an OC-3, short reach, multimode
transceiver installed in the first interface port (0) of the SPA located in subslot 2 of the SIP installed
in chassis slot 7:
Router# show hw-module subslot 7/2 transceiver 0 idprom
IDPROM for transceiver POS7/2/0:
Description = SFP optics (type 3)
Transceiver Type: = OC3 SR-1/STM1 MM (1)
Product Indentifier (PID) = TRP-03BCS
Vendor Revision =
Serial Number (SN) 2169298 =
Vendor Name OCP =
Vendor OUI (IEEE company ID) 00.00.00 (0)=
Device State Enabled. =
CLEI code =
^@^@^Cc#}0^Ll5
Cisco part number =
hc?z^B<@^E^R^@
Date code (yy/mm/dd) 03/04/21 =
Connector type LC. =
Encoding 8B10B =
4b5b
NRZ
Nominal bitrate = OC3/STM1 (200 Mbits/s)
Minimum bit rate as % of nominal bit rate = 68 % of 200 Mbits/s
Maximum bit rate as % of nominal bit rate = 71 % of 200 Mbits/s
Example of the show hw-module subslot transceiver idprom Command for an OC-12 Transceiver
The following example shows hardware IDPROM information for an OC-12, short reach, multimode
transceiver installed in the first interface port (0) of the SPA located in subslot 0 of the SIP installed
in chassis slot 7:
Router# show hw-module subslot 7/0 transceiver 0 idprom
IDPROM for transceiver POS7/0/0:
Description = SFP optics (type 3)
Cisco IOS Interface and Hardware Component Command Reference
1480
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module subslot transceiver
Transceiver Type: = OC12 SR-1/STM4 MM (8)
Product Indentifier (PID) = TRP-12BCS
Vendor Revision =
Serial Number (SN) 2177091 =
Vendor Name OCP =
Vendor OUI (IEEE company ID) 00.00.00 (0) =
Device State Enabled. =
CLEI code ^@^@^CdZ+{N^\^X =
Cisco part number pk:c^F^K^@ =
Date code (yy/mm/dd) 03/05/07 =
Connector type LC. =
Encoding 8B10B =
4b5b
NRZ
Nominal bitrate = OC12/STM4 (600 Mbits/s)
Minimum bit rate as % of nominal bit rate = 92 % of 600 Mbits/s
Maximum bit rate as % of nominal bit rate = 13 % of 600 Mbits/s
Example of the show hw-module subslot transceiver idprom brief Command
The following example shows the operational status of the transceiver installed in the first interface
port (0) of the SPA located in subslot 2 of the SIP installed in chassis slot 3:
Router# show hw-module subslot 3/2 transceiver 0 idprom brief
IDPROM for transceiver POS3/2/0:
Description = SFP optics (type 3)
Transceiver Type: = OC12 SR-1/STM4 MM (8)
Product Indentifier (PID) = TRP-12BCS
Vendor Revision =
Serial Number (SN) = 2569567
Vendor Name = CISCO-OCP
Vendor OUI (IEEE company ID) = 00.00.00 (0)
Device State = Enabled.
CLEI code = ^@^@^C4] ^@T(.
Cisco part number = T^W;L^YkcQ7^@
Date code (yy/mm/dd) = 04/03/24
Connector type = LC.
Encoding = 8B10B
4b5b
NRZ
Nominal bitrate = OC12/STM4 (600 Mbits/s)
Minimum bit rate as % of nominal bit rate = 92 % of 600 Mbits/s
Maximum bit rate as % of nominal bit rate = 13 % of 600 Mbits/s
Example of the show hw-module subslot transceiver idprom detail Command
The following example shows the detail form of the command for the transceiver installed in the
sixth interface port (5) of the SPA located in subslot 0 of the SIP installed in chassis slot 4:
Router# show hw-module subslot 4/0 transceiver 5 idprom detail
IDPROM for transceiver GigabitEthernet4/0/6:
Description = SFP optics (type 3)
Transceiver Type: = GE SX (19)
Product Indentifier (PID) = FTRJ8519P1BNL-C3
Vendor Revision = A1
Serial Number (SN) = FNS0821K2J5
Vendor Name = CISCO-FINISAR
Cisco IOS Interface and Hardware Component Command Reference
1481
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module subslot transceiver
Vendor OUI (IEEE company ID) = 00.90.65 (36965)
CLEI code = CNUIAAMAAA
Cisco part number = 10-1954-01
Device State = Enabled.
Date code (yy/mm/dd) = 04/05/19
Connector type = LC.
Encoding = 8B10B
NRZ
Nominal bitrate = 2xFC (2100 Mbits/s)
Minimum bit rate as % of nominal bit rate = not specified
Maximum bit rate as % of nominal bit rate = not specified
Link reach for 9u fiber (km) = SX(550/270m) (0)
1xFC-MM(500/300m) (0)
2xFC-MM(300/150m) (0)
ESCON-MM(2km) (0)
Link reach for 9u fiber (m) = SX(550/270m) (0)
1xFC-MM(500/300m) (0)
2xFC-MM(300/150m) (0)
ESCON-MM(2km) (0)
Link reach for 50u fiber (m) = 2xFC-MM(300/150m) (30)
Link reach for 62.5u fiber (m) = 2xFC-MM(300/150m) (15)
Nominal laser wavelength = 850 nm.
DWDM wavelength fraction = 850.0 nm.
Supported options = Tx disable
Tx fault signal
Loss of signal (standard implementation)
Supported enhanced options = Alarms for monitored parameters
Diagnostic monitoring = Digital diagnostics supported
Diagnostics are externally calibrated
Rx power measured is "Averagepower"
Transceiver temperature operating range = -5 C to 85 C (extended)
Minimum operating temperature = -20 C
Maximum operating temperature = 90 C
High temperature alarm threshold = +109.000 C
High temperature warning threshold = +103.000 C
Low temperature warning threshold = -13.000 C
Low temperature alarm threshold = -29.000 C
High voltage alarm threshold = 3.9000 Volts
High voltage warning threshold = 3.7000 Volts
Low voltage warning threshold = 2.9000 Volts
Low voltage alarm threshold = 2.7000 Volts
High laser bias current alarm threshold = 15.000 mAmps
High laser bias current warning threshold = 12.000 mAmps
Low laser bias current warning threshold = 2.000 mAmps
Low laser bias current alarm threshold = 1.000 mAmps
High transmit power alarm threshold = 0.7424 mWatts
High transmit power warning threshold = 0.7424 mWatts
Low transmit power warning threshold = 0.959 mWatts
Low transmit power alarm threshold = 0.619 mWatts
High receive power alarm threshold = 5.9324 mWatts
High receive power warning threshold = 3.7416 mWatts
Low receive power warning threshold = 0.751 mWatts
Low receive power alarm threshold = 0.478 mWatts
External Calibration constant: Rx power4 = 0.000
External Calibration constant: Rx power3 = 0.000
External Calibration constant: Rx power2 = 0.000
External Calibration constant: Rx power1 = 0.212
External Calibration constant: Rx power0 = -1.4294966868
External Calibration: bias current slope = 1.000
External Calibration: bias current offset = 0
Cisco IOS Interface and Hardware Component Command Reference
1482
show hw-module slot tech-support through show interfaces vg-anylan
show hw-module subslot transceiver
Example of the show hw-module subslot transceiver status Command
The following example shows the operational status of the transceiver installed in the third interface
port (2) of the SPA located in subslot 0 of the SIP installed in chassis slot 4:
Router# show hw-module subslot 4/0 transceiver 2 status
The Transceiver in slot 4 subslot 0 port 2 is enabled.
Module temperature = +41.617 C
Transceiver Tx supply voltage = 3292.0 uVolts
Transceiver Tx bias current = 4840 uAmps
Transceiver Tx power = 349.2 uWatts
Transceiver Rx optical power = 0.5 uWatts
Cisco IOS Interface and Hardware Component Command Reference
1483
show hw-module slot tech-support through show interfaces vg-anylan
show hw-programmable
show hw-programmable
To display the current Complex Programmable Logic Device (CPLD) or Field-Programmable Gate Array
(FPGA) version in a particular line card on a Cisco ASR 1000 Series Router, use the showhw-programmable
command in Privileged EXEC configuration mode.
show hw-programmable {all|R0|R1|F0|F1|0..5}
Syntax Description all This selects all line card types in a Cisco ASR 1000 Series Router.
R0 RP slot 0. In the Cisco ASR 1006 Routers and Cisco ASR 1013 Routers, it is the lower RP slot.
In Cisco ASR 1002 and Cisco ASR 1004, it is the only slot.
R1 RP slot 1. This is only in the Cisco ASR 1006 and Cisco ASR 1013 Routers. It is the higher RP slot.
F0 This is the embedded services processor (ESP) slot 0. In the Cisco ASR 1006 Routers and Cisco ASR
1013 Routers, it is the lower ESP slot.
In Cisco ASR 1002 and Cisco ASR 1004, it is the only slot.
F1 This is the embedded services processor (ESP) slot 2. This is only in the Cisco ASR 1006 and Cisco
ASR 1013 Routers. It is the higher ESP slot.
0..5 This is one of the SIP carrier card slots. Select a slot number zero (0) through five (5).
Note A CPLD upgrade cannot be performed in slot 5 in the ASR100-SIP10. Move the CPLD
card to another slot.
Command Default None
Command Modes Privileged EXEC (#)
Command History Release Modification
3.1S This command was introduced in Cisco IOS XE Release 3.1S.
Usage Guidelines This command displays the current CPLD and FPGA versions in a particular card by examining the contents
of the hw-programmable package file.
For procedures on performing a CPLD upgrade, see the Upgrading Field Programmable Hardware Devices
for Cisco ASR 1000 Series Routers document.
Examples The following example displays the current CPLD and FPGA versions in slot R0 of the router:
Router# show hw-programmable r0
Hw-programmable versions
Slot CPLD version FPGA version
-----------------------------------------------------------
R0 10021901 08112501
Cisco IOS Interface and Hardware Component Command Reference
1484
show hw-module slot tech-support through show interfaces vg-anylan
show hw-programmable
The following example displays all CPLD and FPGA versions, including RP, ESP, and SIP carrier
card:
Router# show hw-programmable all
Hw-programmable versions
Slot CPLD version FPGA version
-----------------------------------------------------------
R0 10021901 08112501
R1 N/A N/A
F0 1001270D 09081902
F1 1003190E 10040702
1 07091401 N/A
2 07091401 N/A
3 07091401 N/A
4 07091401 N/A
5 07091401 N/A
Related Commands Command Description
upgrade hw-programmable Performs a Complex Programmable Logic Device (CPLD) or
Field-Programmable Gate Array (FPGA) upgrade on a Cisco ASR
1000 Series Router.
show upgrade hw-programmable Displays the progress of the line card-field upgradeable device
progress (LC-FPD) on a Cisco ASR 1000 Series Router.
show upgrade hw-programmable Displays the names and versions of individual files in the
hw_programmable package file.
Cisco IOS Interface and Hardware Component Command Reference
1485
show hw-module slot tech-support through show interfaces vg-anylan
show icc
show icc
To display the information about the interface controller card (ICC) counter and status, use the showicc
command in user EXEC or privileged EXEC mode.
show icc {counters|flowcontrol|mcast|status}
Syntax Description counters Displays the counter information.
flowcontrol Displays the flow control information.
mcast Displays the multicast information.
status Displays the status information.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Examples This example shows how to display the information about the ICC counter:
Router>
show icc counters
total tx RPC packets to slot 1 LCP = 0
detail by request id: (<request-id>=<number-of-packets>)
2 =0 7 =0 8 =0 10=0
11=0 12=0 14=0 17=0
18=0 19=0 20=0
total rx RPC packets from slot 1 LCP = 0
detail by request id: (<request-id>=<number-of-packets>)
2 =5 7 =7 8 =11 10=4
11=1 12=2 14=1 17=67
18=7 19=159 20=29
total tx MCAST-SP packets to slot 1 LCP = 0
detail by request id: (<request-id>=<number-of-packets>)
6 =0 7 =0 8 =0 9 =0
12=0 14=0
total rx MCAST-SP packets from slot 1 LCP = 0
detail by request id: (<request-id>=<number-of-packets>)
6 =1 7 =1 8 =1 9 =1
12=41 14=67
total tx L3-MGR packets to slot 1 LCP = 0
detail by request id: (<request-id>=<number-of-packets>)
1 =0 2 =0 3 =0
total rx L3-MGR packets from slot 1 LCP = 0
Cisco IOS Interface and Hardware Component Command Reference
1486
show hw-module slot tech-support through show interfaces vg-anylan
show icc
detail by request id: (<request-id>=<number-of-packets>)
1 =1 2 =2 3 =1
Router#
This example shows how to display the information about the ICC status:
Router>
show icc status
Class Name Msgs Pending Max Pending Total Sent
----- ---------------- ------------ ----------- ----------
2 RPC 0 3 403
3 MSC 0 1 1
5 L3-MGR 0 4 4173
13 TCAM-API 0 10 26
Router#
Related Commands Command Description
show interfaces Displays the status and statistics for the interfaces in the chassis.
Cisco IOS Interface and Hardware Component Command Reference
1487
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces cem
show interfaces cem
T o display the statistics of the cem group, use the showinterfacescemcommandin privilege exec mode.
show interfaces cem slot/subslot/port
Syntax Description slot Slot number where the SIP is installed.
subslot Subslot number of the SIP where CEOPS SPA has been installed and circuit emulation has been
configured.
port Port number of the interface on the CEOPS SPA where circuit emulation has been configured.
Command Default No default behavior or values
Command Modes Privilege Exec Mode (Exec)
Command History Release Modification
Cisco IOS XE Release 3.3.0S This command was introduced.
Usage Guidelines The showinterfacescemcommand has been introduced on Cisco ASR 1000 Series Router in Cisco IOS XE
Release 3.3.0S. The command output provides details regarding the various CEM groups configured and the
various time slots to which the groups are attached.
Examples The following example shows the command output of the show interfaces cem command:
Router# show interfaces cem 0/1/0
CEM0/1/0 is up, line protocol is up
Hardware is Circuit Emulation Interface
MTU 1500 bytes, BW 155520 Kbit/sec, DLY 0 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation CEM, loopback not set
Keepalive not supported
Last input never, output never, output hang never
Last clearing of "show interface" counters never
Input queue: 0/375/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue: 0/0 (size/max)
5 minute input rate 64000 bits/sec, 250 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
1779066 packets input, 56930112 bytes, 0 no buffer
Received 0 broadcasts (0 IP multicasts)
0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 packets output, 0 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 unknown protocol drops
0 output buffer failures, 0 output buffers swapped out
Cisco IOS Interface and Hardware Component Command Reference
1488
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces cem
Related Commands Command Description
clear interface cem Clears the cem channel.
Cisco IOS Interface and Hardware Component Command Reference
1489
show hw-module slot tech-support through show interfaces vg-anylan
show interface history
show interface history
To display histograms of interface utilization, use the showinterfacehistory command in privileged EXEC
mode.
show interface [type number] history [{all|60sec|60min|72hour}] [{both|input|output}]
Syntax Description type (Optional) Interface type.
number (Optional) Port number of the interface.
all (Optional) Specifies the histograms representing the last 60 seconds, the last 60 minutes, and the
last 72 hours of interface utilization.
60sec (Optional) Specifies the histograms representing the last 60 seconds of interface utilization.
60min (Optional) Specifies the histograms representing the last 60 minutes of interface utilization.
72hour (Optional) Specifies the histograms representing the last 72 hours of interface utilization.
both (Optional) Specifies both the input histograms and the output histograms.
input (Optional) Specifies the input histograms.
output (Optional) Specifies the output histograms.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)XNE This command was introduced.
Usage Guidelines The showinterfacehistory command displays histograms of interface utilization. The y-axis represents the
input or output rate in packets per second, kilobits per second, or megabits per second. Kilobits per second is
used when the bandwidth of the interface is less than one gigabit per second. Megabits per second is used for
more than one gigabit per second.
The x-axis represents time in units of seconds, minutes or hours with the most current time at the left side of
the histogram. There are three histograms available: the last 60 seconds, the last 60 minutes, and the last 72
hours.
The interface counters specified in the history(interface) command are displayed under the x-axis of each
histogram. Each counter has a five-character identification as listed in the command. The identification is
displayed at the beginning of each counter line. The number in the column indicates that the counter incremented
by that amount during the specified interval. When the counter exceeds a single digit, the values are displayed
vertically.
Examples The following example shows the histogram output of interface history:
Router# show interface gigabitethernet 0/1 history 60min
Cisco IOS Interface and Hardware Component Command Reference
1490
show hw-module slot tech-support through show interfaces vg-anylan
show interface history
5689688755455324777665666876546
10
9 *
8 ** ** *
7 *# ##* *** #*
6 *###### ####* **###* *
5 ########## *# ############* *
4 ############# *#############**
3 ############## ###############*
2 ###############################
1 ###############################
0....5....1....1....2....2....3....3....4....4....5....5....6
0 5 0 5 0 5 0 5 0 5 0
3333333333333333333333333333331
Mlcst 556555555565555555555565535555700000000000000000000000000000
22322111111 121221211211
57149774766867 133175814422022
iDrop 425727636924219265454496840996600000000000000000000000000000
GigabitEthernet0/1 input rate(mbits/sec) (last 60 minutes)
* = maximum # = average
5677678656555434767665666866545
10
9
8 * *
7 ** *# * * *
6 *#####* * ##*** ***##*
5 *#########*** #####*######* *
4 #############* *#############**
3 #############**###############*
2 ###############################
1 ###############################
0....5....1....1....2....2....3....3....4....4....5....5....6
0 5 0 5 0 5 0 5 0 5 0
Unkno 000000000000000000000000000000000000000000000000000000000000
oDrop 000000000000000000000000000000000000000000000000000000000000
GigabitEthernet0/1 output rate(mbits/sec) (last 60 minutes)
* = maximum # = average
The input rate histogram shows that the input rate peaked at 9 Mbps and 4 minutes prior to the
command execution. During that one-minute interval, there were 35 input multicast packets and 247
input drops. The counter values in the histogram should be read vertically.
The output rate histogram shows that the output rate reached 8 Mbps twice; once 7 minutes prior
and the second time 26 minutes prior to the command execution. There were no unknown protocol
drops and no output drops during the last 60 minutes.
The table below describes the significant fields shown in the display.
Table 112: show interface history Field Descriptions
Field Description
Mlcst Ethernet input multicast.
iDrop Input drops.
Unkno Unknown protocol drops.
oDrop Output drops.
Cisco IOS Interface and Hardware Component Command Reference
1491
show hw-module slot tech-support through show interfaces vg-anylan
show interface history
Related Commands Command Description
history (interface) Enables an interface to maintain utilization history.
Cisco IOS Interface and Hardware Component Command Reference
1492
show hw-module slot tech-support through show interfaces vg-anylan
show interface sdcc
show interface sdcc
To display configuration information and statistics for a sections data communications channel (SDCC)
interface, use the showinterfacesdcc command in privileged EXEC mode.
show interface sdcc slot/subslot/port
Syntax Description slot Chassis slot number.
Refer to the appropriate hardware manual for slot information. For SIPs, refer to the
platform-specific SPA hardware installation guide or the corresponding “Identifying Slots and
Subslots for SIPs and SPAs” topic in the platform-specific SPA software configuration guide.
/ subslot Secondary slot number on a SPA interface processor (SIP) where a SPA is installed.
Refer to the platform-specific SPA hardware installation guide and the corresponding “Specifying
the Interface Address on a SPA” topic in the platform-specific SPA software configuration guide
for subslot information.
/ port (Optional) Port or interface number.
Refer to the appropriate hardware manual for port information. For SPAs, refer to the
corresponding “Specifying the Interface Address on a SPA” topics in the platform-specific SPA
software configuration guide.
Command Default No default behavior or values
Command Modes Privileged EXEC
Command History Release Modification
12.2(11)BC3 This command was introduced.
12.2(25)S3 This command was integrated into Cisco IOS Release 12.2(25)S3 to support POS SPAs on
the Cisco 7304 router.
12.2(18)SXE This command was integrated into Cisco IOS Release 12.2(18)SXE to support POS SPAs on
the Cisco 7600 series routers and Catalyst 6500 series switches.
12.0(31)S This command was integrated into Cisco IOS Release 12.0(31)S to support POS SPAs on
the Cisco 12000 series routers.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Examples
Cisco 7600 Series Router and Catalyst 6500 Series Switch Example
The following command displays configuration information and statistics for SDCC interface 7/0/0:
Router# show interface sdcc 7/0/0
SDCC7/0/0 is up, line protocol is up
Cisco IOS Interface and Hardware Component Command Reference
1493
show hw-module slot tech-support through show interfaces vg-anylan
show interface sdcc
Hardware is SDCC
Internet address is 10.11.11.10/8
MTU 1500 bytes, BW 192 Kbit, DLY 20000 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation HDLC, crc 16, loopback not set
Keepalive not set
Last input 00:00:38, output 00:00:38, output hang never
Last clearing of "show interface" counters 00:00:48
Input queue:0/75/0/0 (size/max/drops/flushes); Total output drops:0
Queueing strategy:fifo
Output queue:0/40 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
5 packets input, 520 bytes, 0 no buffer
Received 0 broadcasts (0 IP multicast)
0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
5 packets output, 520 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
0 carrier transitions
Cisco 12000 Series Router Example
The following is sample output from the showinterfacesdcccommand on a Cisco 12000 series router
for POS interface 1/1/0 (which is the interface for port 0 of the SPA in subslot 1 of the SIP in chassis
slot 1):
Router# show interface sdcc 1/1/0
SDCC1/1/0 is administratively down, line protocol is down
Hardware is SDCC
MTU 1500 bytes, BW 192 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation HDLC, crc 32, loopback not set
Keepalive set (10 sec)
Last input never, output never, output hang never
Last clearing of "show interface" counters 00:01:55
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 packets output, 0 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
0 carrier transitions
The table below describes the significant fields shown in these displays.
Table 113: show interface sdcc Field Descriptions
Field Description
SDCCx/y/z is up, line Indicates whether the interface hardware is currently active and can transmit and
protocol is up receive or whether it has been taken down by an administrator.
Cisco IOS Interface and Hardware Component Command Reference
1494
show hw-module slot tech-support through show interfaces vg-anylan
show interface sdcc
Field Description
Hardware is. . . Hardware type:
• SDCC-- Section Data Communications Channel
Internet address is Internet address and subnet mask.
MTU Maximum transmission unit of the interface.
BW Bandwidth of the interface, in kilobits per second.
DLY Delay of the interface, in microseconds.
rely Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes. The calculation uses the
value from the bandwidth interface configuration command.
Encapsulation Encapsulation method assigned to interface.
crc Cyclic redundancy check size (16 or 32 bits).
Loopback Indicates whether loopback is set.
Keepalive Indicates whether keepalives are set.
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by an interface and processed locally on the router. Useful for knowing
when a dead interface failed. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
(Last) output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by an interface. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
(Last) output hang Number of hours, minutes, and seconds (or never) since the interface was last
reset because of a transmission that took too long. When the number of hours in
any of the “last” fields exceeds 24 hours, the number of days and hours is printed.
If that field overflows, asterisks are printed.
Last clearing Time at which the counters that measure cumulative statistics (such as number
of bytes transmitted and received) shown in this report were last reset to zero.
Note that variables that might affect routing (for example, load and reliability)
are not cleared when the counters are cleared.
*** indicates the elapsed time is too large to be displayed.
0:00:00 indicates the counters were cleared more than 2231 ms (and less than
232 ms) ago.
Queueing strategy First-in, first-out (FIFO) queueing strategy (other queueing strategies you might
see are priority-list, custom-list, and weighted fair).
Cisco IOS Interface and Hardware Component Command Reference
1495
show hw-module slot tech-support through show interfaces vg-anylan
show interface sdcc
Field Description
Output queue, drops input Number of packets in output and input queues. Each number is followed by a
queue, drops slash, the maximum size of the queue, and the number of packets dropped because
a queue was full.
5 minute input rate 5 Average number of bits and packets received or transmitted per second in the last
minute output rate 5 minutes.
packets input Total number of error-free packets received by the system.
bytes (input) Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the
main system. Compare with ignored count. Broadcast storms on Ethernets and
bursts of noise on serial lines are often responsible for no input buffer events.
broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the medium.
giants Number of packets that are discarded because they exceed the maximum packet
size of the medium.
throttles Not supported for POS interfaces.
parity Report of the parity errors on the interface.
input errors Total number of no buffer, runts, giants, CRCs, frame, overrun, ignored, and
abort counts. Other input-related errors can also increment the count, so that this
sum might not balance with the other counts.
CRC Cyclic redundancy checksum generated by the originating LAN station or far-end
device does not match the checksum calculated from the data received. On a
LAN, this usually indicates noise or transmission problems on the LAN interface
or the LAN bus itself. A high number of CRCs is usually the result of collisions
or a station transmitting bad data. On a serial link, CRCs usually indicate noise,
gain hits or other transmission problems on the data link.
frame Number of packets received incorrectly having a CRC error and a noninteger
number of octets. On a serial line, this is usually the result of noise or other
transmission problems.
overrun Number of times the serial receiver hardware was unable to hand received data
to a hardware buffer because the input rate exceeded the receiver’s ability to
handle the data.
ignored Number of received packets ignored by the interface because the interface
hardware ran low on internal buffers. These buffers are different than the system
buffers mentioned previously in the buffer description. Broadcast storms and
bursts of noise can cause the ignored count to be incremented.
Cisco IOS Interface and Hardware Component Command Reference
1496
show hw-module slot tech-support through show interfaces vg-anylan
show interface sdcc
Field Description
abort Illegal sequence of one bits on the interface.
packets output Total number of messages transmitted by the system.
bytes (output) Total number of bytes, including data and MAC encapsulation, transmitted by
the system.
underruns Number of times that the far-end transmitter has been running faster than the
near-end router’s receiver can handle.
output errors Sum of all errors that prevented the final transmission of datagrams out of the
interface being examined. Note that this might not balance with the sum of the
enumerated output errors, as some datagrams can have more than one error, and
others can have errors that do not fall into any of the specifically tabulated
categories.
collisions Not supported for POS interfaces.
interface resets Number of times an interface has been completely reset. This can happen if
packets queued for transmission were not sent within a certain interval. If the
system notices that the carrier detect line of an interface is up, but the line protocol
is down, it periodically resets the interface in an effort to restart it. Interface resets
can also occur when an unrecoverable interface processor error occurred, or when
an interface is looped back or shut down.
output buffer failures Not supported for POS interfaces.
output buffers swapped Not supported for POS interfaces.
out
carrier transitions Number of times the carrier detect signal of the interface has changed state.
Cisco IOS Interface and Hardware Component Command Reference
1497
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
show interfaces
To display statistics for all interfaces configured on the router or access server, use the show interfaces
command in privileged EXEC mode.
Cisco 2500 Series, Cisco 2600 Series, Cisco 4700 Series, and Cisco 7000 Series
show interfaces [type number] [first] [last] [accounting]
Catalyst 6500 Series, Cisco 7200 Series and Cisco 7500 Series with a Packet over SONET Interface
Processor
show interfaces [type slot/port] [{accounting|counters protocol
status|crb|dampening|description|dot1ad|etherchannel [module
number]|fair-queue|irb|mac-accounting|mpls-exp|precedence|random-detect|rate-limit|stats|summary|switching|utilization
{type number}}]
Cisco 7500 Series with Ports on VIPs
show interfaces [type slot/port-adapter/port]
Cisco 7600 Series
show interfaces [{type number|null interface-number|vlan vlan-id}]
Channelized T3 Shared Port Adapters
show interfaces serial [slot/subslot/port/t1-num : channel-group]
Shared Port Adapters
show interfaces type [slot/subslot/port [/sub-int]]
Syntax Description type (Optional) Interface type. Allowed values for type can be atm, async,
auto-template, bvi, bri0, ctunnel, container, dialer, e1, esconPhy, ethernet,
fastethernet, fcpa, fddi, filter, filtergroup, gigabitethernet, ge-wan, hssi,
longreachethernet, loopback, mfr, multilink, module,null, posport-channel,
, port-group, pos-channel, sbc, sdcc, serial, sysclock, t1, tengigabitethernet,
token, tokenring, tunnel, vif, vmi, virtual-access, virtual-ppp, virtual-template,
virtual-tokenring. voaBypassIn, voaBypassOut, voaFilterIn, voaFilterOut,
voaIn, voaOut.
Note The type of interfaces available is based on the type of router used.
number (Optional) Port number on the selected interface.
first last (Optional) For Cisco 2500 series routers, ISDN Basic Rate Interfae (BRI) only.
The first argument can be either 1 or 2. The last argument can only be 2, indicating
B channels 1 and 2.
D-channel information is obtained by using the command without the optional
arguments.
accounting (Optional) Displays the number of packets of each protocol type that have been
sent through the interface.
Cisco IOS Interface and Hardware Component Command Reference
1498
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
counters protocol status (Optional) Displays the current status of the protocol counters enabled.
crb (Optional) Displays interface routing or bridging information.
dampening (Optional) Displays interface dampening information.
description (Optional) Displays the interface description.
etherchannel (Optional) Displays interface Ether Channel information.
[modulenumber]
• module --The module keyword limits the display to interfaces available on
the module.
fair-queue (Optional) Displays interface Weighted Fair Queueing (WFQ) information.
irb (Optional) Displays interface routing or bridging information.
mac-accounting (Optional) Displays interface MAC accounting information.
mpls-exp (Optional) Displays interface Multiprotocol Label Switching (MPLS) experimental
accounting information.
precedence (Optional) Displays interface precedence accounting information.
random-detect (Optional) Displays interface Weighted Random Early Detection (WRED)
information.
rate-limit (Optional) Displays interface rate-limit information.
stats (Optional) Displays interface packets and octets, in and out, by using switching
path.
summary (Optional) Displays an interface summary.
switching (Optional) Displays interface switching.
null interface-number (Optional) Specifies the null interface, that is 0.
slot (Optional) Slot number.
Refer to the appropriate hardware manual for slot information.
/ port (Optional) Port number.
Refer to the appropriate hardware manual for port information.
/ port-adapter (Optional) Port adapter number. Refer to the appropriate hardware manual for
information about port adapter compatibility.
Cisco IOS Interface and Hardware Component Command Reference
1499
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
slot / subslot / port (Optional) Channelized T3 Shared Port Adapters
/ t1-num :
Number of the chassis slot that contains the channelized T3 Shared Port Adapters
channel-group
(SPA) (for example, 5/0/0:23), where:
• slot --(Optional) Chassis slot number.
For SPA interface processors (SIPs), refer to the platform-specific SPA hardware
installation guide or the corresponding “Identifying Slots and Subslots for SIPs
and SPAs” topic in the platform-specific SPA software configuration guide.
• / subslot-- (Optional) Secondary slot number on a SIP where a SPA is
installed.
Refer to the platform-specific SPA hardware installation guide and the
corresponding “Specifying the Interface Address on a SPA” topic in the
platform-specific SPA software configuration guide for subslot information.
• / port --(Optional) Port or interface number.
For SPAs, refer to the corresponding “Specifying the Interface Address on a SPA”
topic in the platform-specific SPA software configuration guide.
• / t1-num-- (Optional) T1 time slot in the T3 line. The value can be from 1
to 28.
• : channel-group-- (Optional) Number 0-23 of the DS0 link on the T1
channel.
[slot/subslot/port/sub-int]] (Optional) Shared Port Adapters
Number of the chassis slot that contains the SPA interface (for example, 4/3/0),
where:
• slot --(Optional) Chassis slot number.
For SIPs, refer to the platform-specific SPA hardware installation guide or the
corresponding “Identifying Slots and Subslots for SIPs and SPAs” topic in the
platform-specific SPA software configuration guide.
• / subslot-- (Optional)Secondary slot number on a SIP where a SAP is
installed.
Refer to the platform-specific SPA hardware installation guide and the
corresponding “Specifying the Interface Address on a SPA” topic in the
platform-specific SPA software configuration guide for subslot information.
• / port --(Optional) Port or interface number.
For SPAs, refer to the corresponding “Specifying the Interface Address on a SPA”
topics in the platform-specific SPA software configuration guide.
• / sub-int -- (Optional) Subinterface number (for those SPAs that support
subinterface configuration).
vlan vlan-id (Optional) Specifies the VLAN ID; valid values are from 1 to 4094.
Cisco IOS Interface and Hardware Component Command Reference
1500
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Command Modes User EXEC (>)
Privileged EXEC (#)
Command History Release Modification
10.0 This command was introduced.
12.0(3)T This command was modified to include support for flow-based WRED .
12.0(4)T This command was modified to include enhanced display information for dialer
bound interfaces.
12.0(7)T This command was modified to include dialer as an interface type and to reflect
the default behavior.
12.2(14)S This command was integrated into Cisco IOS Release 12.2(14)S.
12.2(20)S2 This command was integrated into Cisco IOS Release 12.2(20)S2 and introduced
a new address format and output for SPA interfaces on the Cisco 7304 router.
The subslot argument was introduced.
12.2(25)S3 This command was integrated into Cisco IOS Release 12.2(25)S3.
12.2(14)SX This command was modified. Support for this command was added for the
Supervisor Engine 720.
12.2(17d)SXB This command was modified. Support for this command on the Supervisor
Engine 2 was extended to Cisco IOS Release 12.2SX. The uplink dual-mode
port information was updated.
12.2(18)SXE This command was integrated into Cisco IOS Release 12.2(18)SXE to support
SPAs on the Cisco 7600 series routers and Catalyst 6500 series switches.
2.2(33)SXJ01 This command was integrated into Cisco IOS Release 12.2(33)SXJ01.
12.0(31)S This command was integrated into Cisco IOS Release 12.0(31)S to support SPAs
on the Cisco 12000 series routers, and the tengigabitethernet interface type
was added. 10-Gigabit Ethernet interfaces were introduced with the release of
the 1-Port 10-Gigabit Ethernet SPA.
12.2(18)SXF This command was integrated into Cisco IOS Release 12.2(18)SXF.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SRB1 This command was updated to display operational status for Gigabit Ethernet
interfaces that are configured as primary and backup interfaces (Cisco 7600
series routers).
12.2(31)SB This command was integrated in Cisco IOS Release 12.2(31)SB.
12.2(33)SB This command was modified. The default value of the command was modified
on the Cisco 10000 series router for the PRE3 and PRE4.
Cisco IOS Interface and Hardware Component Command Reference
1501
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Release Modification
Cisco IOS XE Release 2.5 This command was implemented on Cisco ASR 1000 Series Aggregation Services
Routers.
12.2(50)SY This command was integrated in Cisco IOS Release 12.2(50)SY and the dot1ad
keyword was added.
15.1(01)SY This command was integrated in Cisco IOS Release 15.1(50)SY.
Usage Guidelines Display Interpretation
The show interfaces command displays statistics for the network interfaces. The resulting output varies,
depending on the network for which an interface has been configured. The resulting display on the Cisco 7200
series routers shows the interface processors in slot order. If you add interface processors after booting the
system, they will appear at the end of the list, in the order in which they were inserted.
Information About Specific Interfaces
The number argument designates the module and port number. If you use the show interfaces command on
the Cisco 7200 series routers without the slot/port arguments, information for all interface types will be shown.
For example, if you type show interfaces you will receive information for all Ethernet, serial, Token Ring,
and FDDI interfaces. Only by adding the type slot/port argument you can specify a particular interface.
Cisco 7600 Series Routers
Valid values for the number argument depend on the specified interface type and the chassis and module that
are used. For example, if you specify a Gigabit Ethernet interface and have a 48-port 10/100BASE-T Ethernet
module that is installed in a 13-slot chassis, valid values for the module number are from 1 to 13 and valid
values for the port number are from 1 to 48.
The port channels from 257 to 282 are internally allocated and are supported on the Content Switching Module
(CSM) and the Firewall Services Module (FWSM) only.
Statistics are collected on a per-VLAN basis for Layer 2-switched packets and Layer 3-switched packets.
Statistics are available for both unicast and multicast traffic. The Layer 3-switched packet counts are available
for both ingress and egress directions. The per-VLAN statistics are updated every 5 seconds.
In some cases, you might see a difference in the duplex mode that is displayed between the show interfaces
command and the show running-configcommands. In this case, the duplex mode that is displayed in the
show interfaces command is the actual duplex mode that the interface is running. The show interfaces
command shows the operating mode for an interface, and the show running-config command shows the
configured mode for an interface.
If you do not enter any keywords, all counters for all modules are displayed.
Command Variations
You will use the show interfaces command frequently while configuring and monitoring devices. The various
forms of the show interfaces commands are described in detail in the sections that follow.
Dialer Interfaces Configured for Binding
If you use the show interfaces command on dialer interfaces configured for binding, the display will report
statistics on each physical interface bound to the dialer interface; see the following examples for more
information.
Removed Interfaces
Cisco IOS Interface and Hardware Component Command Reference
1502
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
If you enter a show interfaces command for an interface type that has been removed from the router or access
server, interface statistics will be displayed accompanied by the following text: “Hardware has been removed.”
Weighted Fair Queueing Information
If you use the show interfaces command on a router or access server for which interfaces are configured to
use weighted fair queueing through the fair-queue interface command, additional information is displayed.
This information consists of the current and high-water mark number of flows.
Cisco 10000 Series Router
In Cisco IOS Release 12.2(33)SB, when a multilink PPP (MLP) interface is down/down, its default bandwidth
rate is the sum of the serial interface bandwidths associated with the MLP interface.
In Cisco IOS Release 12.2(31)SB, the default bandwidth rate is 64 Kbps.
Examples The following is sample output from the show interfaces command. Because your display will
depend on the type and number of interface cards in your router or access server, only a portion of
the display is shown.
Note If an asterisk (*) appears after the throttles counter value, it means that the interface was throttled at
the time the command was run.
Router# show interfaces
Ethernet 0 is up, line protocol is up
Hardware is MCI Ethernet, address is 0000.0c00.750c (bia 0000.0c00.750c)
Internet address is 10.108.28.8, subnet mask is 255.255.255.0
MTU 1500 bytes, BW 10000 Kbit, DLY 100000 usec, rely 255/255, load 1/255
Encapsulation ARPA, loopback not set, keepalive set (10 sec)
ARP type: ARPA, ARP Timeout 4:00:00
Last input 0:00:00, output 0:00:00, output hang never
Last clearing of "show interface" counters 0:00:00
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 0 bits/sec, 0 packets/sec
Five minute output rate 2000 bits/sec, 4 packets/sec
1127576 packets input, 447251251 bytes, 0 no buffer
Received 354125 broadcasts, 0 runts, 0 giants, 57186* throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
5332142 packets output, 496316039 bytes, 0 underruns
0 output errors, 432 collisions, 0 interface resets, 0 restarts
.
.
.
Example with Custom Output Queueing
The following example shows partial sample output when custom output queueing is enabled:
Router# show interfaces
Last clearing of “show interface” counters 0:00:06
Input queue: 0/75/0 (size/max/drops); Total output drops: 21
Output queues: (queue #: size/max/drops)
0: 14/20/14 1: 0/20/6 2: 0/20/0 3: 0/20/0 4: 0/20/0 5: 0/20/0
6: 0/20/0 7: 0/20/0 8: 0/20/0 9: 0/20/0 10: 0/20/0
.
Cisco IOS Interface and Hardware Component Command Reference
1503
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
.
.
When custom queueing is enabled, the drops accounted for in the output queues result from bandwidth
limitation for the associated traffic and lead to queue length overflow. Total output drops include
drops on all custom queues and the system queue. Fields are described with the weighted fair queueing
output in the table below.
Example Including Weighted-Fair-Queueing Output
For each interface on the router or access server configured to use weighted fair queueing, the show
interfaces command displays the information beginning with Inputqueue: in the following display:
Router# show interfaces
Ethernet 0 is up, line protocol is up
Hardware is MCI Ethernet, address is 0000.0c00.750c (bia 0000.0c00.750c)
Internet address is 10.108.28.8, subnet mask is 255.255.255.0
MTU 1500 bytes, BW 10000 Kbit, DLY 100000 usec, rely 255/255, load 1/255
Encapsulation ARPA, loopback not set, keepalive set (10 sec)
ARP type: ARPA, ARP Timeout 4:00:00
Last input 0:00:00, output 0:00:00, output hang never
Last clearing of “show interface” counters 0:00:00
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 0 bits/sec, 0 packets/sec
Five minute output rate 2000 bits/sec, 4 packets/sec
1127576 packets input, 447251251 bytes, 0 no buffer
Received 354125 broadcasts, 0 runts, 0 giants, 57186* throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
5332142 packets output, 496316039 bytes, 0 underruns
0 output errors, 432 collisions, 0 interface resets, 0 restarts
Input queue: 0/75/0 (size/max/drops); Total output drops: 0
Output queue: 7/64/0 (size/threshold/drops)
Conversations 2/9 (active/max active)
The table below describes the input queue and output queue fields shown in the preceding two
displays.
Table 114: Weighted-Fair-Queueing Output Field Descriptions
Field Description
Input Queue
size Current size of the input queue.
max Maximum size of the queue.
drops Number of messages discarded in this interval.
Total output drops Total number of messages discarded in this session.
Output Queue
size Current size of the output queue.
threshold Congestive-discard threshold. Number of messages in the queue after which
new messages for high-bandwidth conversations are dropped.
Cisco IOS Interface and Hardware Component Command Reference
1504
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Field Description
drops Number of dropped messages.
Conversations: active Number of currently active conversations.
Conversations: max active Maximum number of concurrent conversations allowed.
Example with Accounting Option
To display the number of packets of each protocol type that have been sent through all configured
interfaces, use the show interfaces accounting command. When you use the accounting option,
only the accounting statistics are displayed.
Note Except for protocols that are encapsulated inside other protocols, such as IP over X.25, the accounting
option also shows the total bytes sent and received, including the MAC header. For example, it totals
the size of the Ethernet packet or the size of a packet that includes High-Level Data Link Control
(HDLC) encapsulation.
Per-packet accounting information is kept for the following protocols:
• AppleTalk
• Address Resolution Protocol (ARP) (for IP, Frame Relay, Switched Multimegabit Data Service
(SMDS))
• Connectionless Network Service (CLNS)
• Digital Equipment Corporation (DEC) Maintenance Operations Protocol (MOP)
The routers use MOP packets to advertise their existence to Digital Equipment Corporation machines
that use the MOP. A router periodically broadcasts MOP packets to identify itself as a MOP host.
This results in MOP packets being counted, even when DECnet is not being actively used.
• DECnet
• HP Probe
• IP
• LAN Manager (LAN Network Manager and IBM Network Manager)
• Novell
• Serial Tunnel Synchronous Data Link Control (SDLC)
• Spanning Tree
• SR Bridge
• Transparent Bridge
Cisco IOS Interface and Hardware Component Command Reference
1505
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Example with DWRED
The following is sample output from the show interfaces command when distributed WRED
(DWRED) is enabled on an interface. Notice that the packet drop strategy is listed as “VIP-based
weighted RED.”
Router# show interfaces hssi 0/0/0
Hssi0/0/0 is up, line protocol is up
Hardware is cyBus HSSI
Description: 45Mbps to R1
Internet address is 10.200.14.250/30
MTU 4470 bytes, BW 45045 Kbit, DLY 200 usec, rely 255/255, load 1/255
Encapsulation HDLC, loopback not set, keepalive set (10 sec)
Last input 00:00:02, output 00:00:03, output hang never
Last clearing of "show interface" counters never
Queueing strategy: fifo
Packet Drop strategy: VIP-based weighted RED
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
1976 packets input, 131263 bytes, 0 no buffer
Received 1577 broadcasts, 0 runts, 0 giants
0 parity
4 input errors, 4 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
1939 packets output, 130910 bytes, 0 underruns
0 output errors, 0 applique, 3 interface resets
0 output buffers copied, 0 interrupts, 0 failures
Example with ALC
The following is sample output from the show interfaces command for serial interface 2 when Airline
Control (ALC) Protocol is enabled:
Router# show interfaces serial 2
Serial2 is up, line protocol is up
Hardware is CD2430
MTU 1500 bytes, BW 115 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation ALC, loopback not set
Full-duplex enabled.
ascus in UP state: 42, 46
ascus in DOWN state:
ascus DISABLED:
Last input never, output never, output hang never
Last clearing of “show interface” counters never
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 packets output, 0 bytes, 0 underruns
0 output errors, 0 collisions, 3 interface resets
0 output buffer failures, 0 output buffers swapped out
DCD=down DSR=down DTR=down RTS=down CTS=down
Cisco IOS Interface and Hardware Component Command Reference
1506
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Example with SDLC
The following is sample output from the show interfaces command for an SDLC primary interface
supporting the SDLC function:
Router# show interfaces
Serial 0 is up, line protocol is up
Hardware is MCI Serial
MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation SDLC-PRIMARY, loopback not set
Timers (msec): poll pause 100 fair poll 500. Poll limit 1
[T1 3000, N1 12016, N2 20, K 7] timer: 56608 Last polled device: none
SDLLC [ma: 0000.0C01.14--, ring: 7 bridge: 1, target ring: 10
largest token ring frame 2052]
SDLC addr C1 state is CONNECT
VS 6, VR 3, RCNT 0, Remote VR 6, Current retransmit count 0
Hold queue: 0/12 IFRAMEs 77/22 RNRs 0/0 SNRMs 1/0 DISCs 0/0
Poll: clear, Poll count: 0, chain: p: C1 n: C1
SDLLC [largest SDLC frame: 265, XID: disabled]
Last input 00:00:02, output 00:00:01, output hang never
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 517 bits/sec, 30 packets/sec
Five minute output rate 672 bits/sec, 20 packets/sec
357 packets input, 28382 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
926 packets output, 77274 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets, 0 restarts
2 carrier transitions
The table below shows the fields relevant to all SDLC connections.
Table 115: show interfaces Field Descriptions When SDLC Is Enabled
Field Description
Timers (msec) List of timers in milliseconds.
poll pause, fair poll, Poll limit Current values of these timers.
T1, N1, N2, K Current values for these variables.
The table below shows other data given for each SDLC secondary interface configured to be attached
to this interface.
Table 116: SDLC Field Descriptions
Field Description
addr Address of this secondary interface.
Cisco IOS Interface and Hardware Component Command Reference
1507
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Field Description
State Current state of this connection. The possible values follow:
• BOTHBUSY--Both sides have told each other that they are temporarily unable
to receive any more information frames.
• CONNECT--A normal connect state exists between this router and this
secondary.
• DISCONNECT--No communication is being attempted to this secondary.
• DISCSENT--This router has sent a disconnect request to this secondary and
is awaiting its response.
• ERROR--This router has detected an error, and is waiting for a response from
the secondary acknowledging this.
• SNRMSENT--This router has sent a connect request (SNRM) to this secondary
and is awaiting its response.
• THEMBUSY--This secondary has told this router that it is temporarily unable
to receive any more information frames.
• USBUSY--This router has told this secondary that it is temporarily unable to
receive any more information frames.
VS Sequence number of the next information frame this station sends.
VR Sequence number of the next information frame from this secondary that this station
expects to receive.
RCNT Number of correctly sequenced I-frames received when the Cisco IOS software
was in a state in which it is acceptable to receive I-frames.
Remote VR Last frame transmitted by this station that has been acknowledged by the other
station.
Current retransmit Number of times the current I-frame or sequence of I-frames has been retransmitted.
count
Hold queue Number of frames in hold queue/Maximum size of hold queue.
IFRAMEs, RNRs, Sent and received count for these frames.
SNRMs, DISCs
Poll “Set” if this router has a poll outstanding to the secondary; “clear” if it does not.
Poll count Number of polls, in a row, given to this secondary at this time.
chain Shows the previous (p) and next (n) secondary address on this interface in the
round-robin loop of polled devices.
Cisco IOS Interface and Hardware Component Command Reference
1508
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Sample show interfaces accounting Display
The following is sample output from the show interfaces accounting command:
Router# show interfaces accounting
Interface TokenRing0 is disabled
Ethernet0
Protocol Pkts In Chars In Pkts Out Chars Out
IP 873171 735923409 34624 9644258
Novell 163849 12361626 57143 4272468
DEC MOP 0 0 1 77
ARP 69618 4177080 1529 91740
Interface Serial0 is disabled
Ethernet1
Protocol Pkts In Chars In Pkts Out Chars Out
IP 0 0 37 11845
Novell 0 0 4591 275460
DEC MOP 0 0 1 77
ARP 0 0 7 420
Interface Serial1 is disabled
Interface Ethernet2 is disabled
Interface Serial2 is disabled
Interface Ethernet3 is disabled
Interface Serial3 is disabled
Interface Ethernet4 is disabled
Interface Ethernet5 is disabled
Interface Ethernet6 is disabled
Interface Ethernet7 is disabled
Interface Ethernet8 is disabled
Interface Ethernet9 is disabled
Fddi0
Protocol Pkts In Chars In Pkts Out Chars Out
Novell 0 0 183 11163
ARP 1 49 0 0
When the output indicates that an interface is “ disabled,” the router has received excessive errors
(over 5000 in a keepalive period).
Example with Flow-Based WRED
The following is sample output from the show interfaces command issued for the serial interface 1
for which flow-based WRED is enabled. The output shows that there are 8 active flow-based WRED
flows, that the maximum number of flows active at any time is 9, and that the maximum number of
possible flows configured for the interface is 16:
Router# show interfaces serial 1
Serial1 is up, line protocol is up
Hardware is HD64570
Internet address is 10.1.2.1/24
MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec,
Reliability 255/255, txload 237/255, rxload 1/255
Encapsulation HDLC, loopback not set
Keepalive not set
Last input 00:00:22, output 00:00:00, output hang never
Last clearing of "show interface" counters 00:17:58
Input queue: 0/75/0 (size/max/drops); Total output drops: 2479
Queueing strategy: random early detection(RED)
flows (active/max active/max): 8/9/16
Cisco IOS Interface and Hardware Component Command Reference
1509
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
mean queue depth: 27
drops: class random tail min-th max-th mark-prob
0 946 0 20 40 1/10
1 488 0 22 40 1/10
2 429 0 24 40 1/10
3 341 0 26 40 1/10
4 235 0 28 40 1/10
5 40 0 31 40 1/10
6 0 0 33 40 1/10
7 0 0 35 40 1/10
rsvp 0 0 37 40 1/10
30 second input rate 1000 bits/sec, 2 packets/sec
30 second output rate 119000 bits/sec, 126 packets/sec
1346 packets input, 83808 bytes, 0 no buffer
Received 12 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
84543 packets output, 9977642 bytes, 0 underruns
0 output errors, 0 collisions, 6 interface resets
0 output buffer failures, 0 output buffers swapped out
0 carrier transitions
DCD=up DSR=up DTR=up RTS=up CTS=up
Example with DWFQ
The following is sample output from the show interfaces command when distributed weighted fair
queueing (DWFQ) is enabled on an interface. Notice that the queueing strategy is listed as “VIP-based
fair queueing.”
Router# show interfaces fastethernet 1/1/0
Fast Ethernet 1/1/0 is up, line protocol is up
Hardware is cyBus Fast Ethernet Interface, address is 0007.f618.4448 (bia 00e0)
Description: pkt input i/f for WRL tests (to pagent)
Internet address is 10.0.2.70/24
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec, rely 255/255, load 1/255
Encapsulation ARPA, loopback not set, keepalive not set, fdx, 100BaseTX/FX
ARP type: ARPA, ARP Timeout 04:00:00
Last input never, output 01:11:01, output hang never
Last clearing of "show interface" counters 01:12:31
Queueing strategy: VIP-based fair queueing
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
30 second input rate 0 bits/sec, 0 packets/sec
30 second output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 watchdog, 0 multicast
0 input packets with dribble condition detected
1 packets output, 60 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffers copied, 0 interrupts, 0 failures
Example with DNIS Binding
When the show interfaces command is issued on an unbound dialer interface, the output looks as
follows:
Cisco IOS Interface and Hardware Component Command Reference
1510
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Router# show interfaces dialer 0
Dialer0 is up (spoofing), line protocol is up (spoofing)
Hardware is Unknown
Internet address is 10.1.1.2/8
MTU 1500 bytes, BW 64 Kbit, DLY 20000 usec, rely 255/255, load 3/255
Encapsulation PPP, loopback not set
DTR is pulsed for 1 seconds on reset
Last input 00:00:34, output never, output hang never
Last clearing of “show interface” counters 00:05:09
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 1000 bits/sec, 0 packets/sec
18 packets input, 2579 bytes
14 packets output, 5328 bytes
But when the show interfaces command is issued on a bound dialer interface, you will get an
additional report that indicates the binding relationship. The output is shown here:
Router# show interfaces dialer 0
Dialer0 is up, line protocol is up
Hardware is Unknown
Internet address is 10.1.1.2/8
MTU 1500 bytes, BW 64 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation PPP, loopback not set
DTR is pulsed for 1 seconds on reset
Interface is bound to BRI0:1
Last input 00:00:38, output never, output hang never
Last clearing of “show interface” counters 00:05:36
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
38 packets input, 4659 bytes
34 packets output, 9952 bytes
Bound to:
BRI0:1 is up, line protocol is up
Hardware is BRI
MTU 1500 bytes, BW 64 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation PPP, loopback not set, keepalive not set
Interface is bound to Dialer0 (Encapsulation PPP)
LCP Open, multilink Open
Last input 00:00:39, output 00:00:11, output hang never
Last clearing of “show interface” counters never
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
78 packets input, 9317 bytes, 0 no buffer
Received 65 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
93 packets output, 9864 bytes, 0 underruns
0 output errors, 0 collisions, 7 interface resets
0 output buffer failures, 0 output buffers swapped out
4 carrier transitions
At the end of the Dialer0 output, the show interfaces command is executed on each physical interface
bound to it.
The following is sample output from the show interfaces dialer stats command:
Router# show interfaces dialer 0 stats
Cisco IOS Interface and Hardware Component Command Reference
1511
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Dialer0
Switching path Pkts In Chars In Pkts Out Chars Out
Processor 0 0 6 1694
Route cache 2522229 610372530 720458 174343542
Total 2522229 610372530 720464 174345236
Example with BRI
In this example, the physical interface is the B1 channel of the BRI0 link. This example also illustrates
that the output under the B channel keeps all hardware counts that are not displayed under any logical
or virtual access interface. The line in the report that states “Interface is bound to Dialer0
(Encapsulation LAPB)” indicates that the B interface is bound to Dialer0 and the encapsulation
running over this connection is Link Access Procedure, Balanced (LAPB), not PPP, which is the
encapsulation configured on the D interface and inherited by the B channel.
Router# show interfaces bri0:1
BRI0:1 is up, line protocol is up
Hardware is BRI
MTU 1500 bytes, BW 64 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation PPP, loopback not set, keepalive not set
Interface is bound to Dialer0 (Encapsulation LAPB)
LCP Open, multilink Open
Last input 00:00:31, output 00:00:03, output hang never
Last clearing of “show interface” counters never
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 1 packets/sec
5 minute output rate 0 bits/sec, 1 packets/sec
110 packets input, 13994 bytes, 0 no buffer
Received 91 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
135 packets output, 14175 bytes, 0 underruns
0 output errors, 0 collisions, 12 interface resets
0 output buffer failures, 0 output buffers swapped out
8 carrier transitions
Any protocol configuration and states should be displayed from the Dialer0 interface.
Example with a Fast Ethernet SPA on a Cisco 7304 Router
The following is sample output from the show interfaces fastethernet command for the second
interface (port 1) in a 4-Port 10/100 Fast Ethernet SPA located in the bottom subslot (1) of the
Modular Service Cards (MSC) that is installed in slot 2 on a Cisco 7304 router:
Router# show interfaces fastethernet 2/1/1
FastEthernet2/1/1 is up, line protocol is up
Hardware is SPA-4FE-7304, address is 00b0.64ff.5d80 (bia 00b0.64ff.5d80)
Internet address is 192.168.50.1/24
MTU 9216 bytes, BW 100000 Kbit, DLY 100 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive set (10 sec)
Full-duplex, 100Mb/s, 100BaseTX/FX
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:00:22, output 00:00:02, output hang never
Last clearing of "show interface" counters never
Cisco IOS Interface and Hardware Component Command Reference
1512
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue: 0/40 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
5 packets input, 320 bytes
Received 1 broadcasts (0 IP multicast)
0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 watchdog
0 input packets with dribble condition detected
8 packets output, 529 bytes, 0 underruns
0 output errors, 0 collisions, 2 interface resets
0 babbles, 0 late collision, 0 deferred
2 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out
Example for an Interface with an Asymmetric Receiver and Transmitter Rates
Router# show interfaces e4/0
Ethernet4/0 is up, line protocol is up
Hardware is AmdP2, address is 000b.bf30.f470 (bia 000b.bf30.f470)
Internet address is 10.1.1.9/24
MTU 1500 bytes, BW 10000 Kbit, RxBW 5000 Kbit, DLY 1000 usec,
reliability 255/255, txload 1/255, rxload 254/255
Encapsulation ARPA, loopback not set
Keepalive set (10 sec)
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:00:00, output 00:00:01, output hang never
Last clearing of "show interface" counters 00:03:36
Input queue: 34/75/0/819 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue: 0/40 (size/max)
30 second input rate 7138000 bits/sec, 14870 packets/sec
30 second output rate 0 bits/sec, 0 packets/sec
3109298 packets input, 186557880 bytes, 0 no buffer
Received 217 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 input packets with dribble condition detected
22 packets output, 1320 bytes, 0 underruns
11 output errors, 26 collisions, 0 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out
The table below describes the significant fields shown in the display.
Table 117: show interfaces fastethernet Field Descriptions--Fast Ethernet SPA
Field Description
Fast Ethernet...is up ...is Indicates whether the interface hardware is currently active and if it has been
administratively down taken down by an administrator.
line protocol is Indicates whether the software processes that handle the line protocol consider
the line usable or if it has been taken down by an administrator.
Hardware Hardware type (for example, SPA-4FE-7304) and MAC address.
Cisco IOS Interface and Hardware Component Command Reference
1513
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Field Description
Description Alphanumeric string identifying the interface. This appears only if the description
interface configuration command has been configured on the interface.
Internet address Internet address followed by subnet mask.
MTU Maximum transmission unit of the interface. The default is 1500 bytes for the
4-Port 10/100 Fast Ethernet SPA.
BW Bandwidth of the interface in kilobits per second.
RxBW Receiver bandwidth of the interface, in kilobits per second. This value is displayed
only when an interface has asymmetric receiver and transmitter rates.
DLY Delay of the interface in microseconds.
reliability Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
txload, rxload Load on the interface (in the transmit “tx” and receive “rx” directions) as a fraction
of 255 (255/255 is completely saturated), calculated as an exponential average
over 5 minutes.
Encapsulation Encapsulation method assigned to the interface.
loopback Indicates whether loopback is set.
Keepalive Indicates whether keepalives are set, and the time interval.
Half-duplex, Full-duplex Indicates the duplex mode for the interface.
100Mb/s, 10Mb/s Speed of the interface in megabits per second.
100BaseTX/FX Media protocol standard.
ARP type: Type of ARP assigned and the timeout period.
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by an interface and processed locally on the router. Useful for knowing
when a dead interface failed.
This field is not updated by fast-switched traffic.
output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by the interface. Useful for knowing when a dead interface failed.
output hang Number of hours, minutes, and seconds (or never) since the interface was last
reset because of a transmission that took too long. When the number of hours in
any of the “last” fields exceeds 24 hours, the number of days and hours is
displayed. If that field overflows, asterisks are printed.
Note This field does not apply to SPA interfaces.
Cisco IOS Interface and Hardware Component Command Reference
1514
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Field Description
Last clearing Time at which the counters that measure cumulative statistics (such as number
of bytes transmitted and received) shown in this report were last reset to zero.
Note that variables that might affect routing (for example, load and reliability)
are not cleared when the counters are cleared.
A series of asterisks (***) indicates the elapsed time is too large to be displayed.
0:00:00 indicates the counters were cleared more than 231 ms (and less than 232
ms) ago.
Input queue Packet statistics on the input queue reported as:
(size/max/drops/flushes)
• Size--Number of packets in the input queue.
• Max--Maximum size of the queue.
• Drops--Number of packets dropped because of a full input queue.
• Flushes--Number of packets dropped as part of selective packet discard
(SPD). SPD implements a selective packet drop policy on the router’s IP
process queue. Therefore, it applies only to process-switched traffic.
Total output drops Total number of packets dropped because of a full output queue.
Queueing strategy Type of Layer 3 queueing active on this interface. The default is first-in, first-out
(FIFO).
Output queue (size/max) Number of packets in the output queue (size), and the maximum size of the queue
(max).
5 minute input rate, 5 Average number of bits and packets transmitted per second in the last 5 minutes.
minute output rate If the interface is not in promiscuous mode, it senses network traffic it sends and
receives (rather than all network traffic).
The 5-minute input and output rates should be used only as an approximation of
traffic per second during a given 5-minute period. These rates are exponentially
weighted averages with a time constant of 5 minutes. A period of four time
constants must pass before the average will be within two percent of the
instantaneous rate of a uniform stream of traffic over that period.
packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
Received...broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the medium. For instance, any Ethernet packet that is smaller than
64 bytes is considered a runt.
Cisco IOS Interface and Hardware Component Command Reference
1515
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Field Description
giants Number of packets that are discarded because they exceed the maximum packet
size of the medium. For example, any Ethernet packet that is larger than 1536
bytes is considered a giant.
Note For the 4-Port 10/100 Fast Ethernet SPA, the default is that a giant is
any packet greater than 1536 bytes. However, if you modify the
maximum transmission unit (MTU) for the interface, this counter
increments when you exceed the specified MTU for the interface.
throttles Number of times the receiver on the port was disabled, possibly because of buffer
or processor overload.
input errors Includes runts, giants, no buffer, cyclic redundancy check (CRC), frame, overrun,
and ignored counts. Other input-related errors can also cause the input errors
count to be increased, and some datagrams may have more than one error;
therefore, this sum may not balance with the sum of enumerated input error counts.
CRC Cyclic redundancy check generated by the originating LAN station or far-end
device does not match the checksum calculated from the data received. On a
LAN, this usually indicates noise or transmission problems on the LAN interface
or the LAN bus itself. A high number of CRCs is usually the result of collisions
or a station transmitting bad data.
frame Number of packets received incorrectly having a CRC error and a noninteger
number of octets. On a LAN, this is usually the result of collisions or a
malfunctioning Ethernet device.
overrun Number of times the receiver hardware was unable to hand received data to a
hardware buffer because the input rate exceeded the receiver’s ability to handle
the data.
ignored Number of received packets ignored by the interface because the interface
hardware ran low on internal buffers. These buffers are different than the system
buffers. Broadcast storms and bursts of noise can cause the ignored count to be
increased.
watchdog Number of times the watchdog receive timer expired. Expiration happens when
receiving a packet with a length greater than 2048 bytes.
input packets with dribble Dribble bit error indicates that a frame is slightly too long. This frame error counter
condition detected is incremented for informational purposes only; the router accepts the frame.
packets output Total number of messages transmitted by the system.
bytes Total number of bytes, including data and MAC encapsulation, transmitted by
the system.
underruns Number of times that the transmitter has been running faster than the router can
handle.
Cisco IOS Interface and Hardware Component Command Reference
1516
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Field Description
output errors Sum of all errors that prevented the final transmission of datagrams out of the
interface being examined. Note that this may not balance with the sum of the
enumerated output errors, because some datagrams may have more than one error
and others may have errors that do not fall into any of the specifically tabulated
categories.
collisions Number of messages retransmitted because of an Ethernet collision. This is usually
the result of an overextended LAN (Ethernet or transceiver cable too long, more
than two repeaters between stations, or too many cascaded multiport transceivers).
A packet that collides is counted only once in output packets.
interface resets Number of times an interface has been completely reset. This can happen if packets
queued for transmission were not sent within several seconds. Interface resets
can occur when an interface is looped back or shut down.
babbles Transmit jabber timer expired.
late collision Number of late collisions. Late collision happens when a collision occurs after
transmitting the preamble.
deferred Number of times that the interface had to defer while ready to transmit a frame
because the carrier was asserted.
lost carrier Number of times the carrier was lost during transmission.
no carrier Number of times the carrier was not present during the transmission.
Note This field does not apply to SPA interfaces.
output buffer failures, These counters are not used by the 4-Port 10/100 Fast Ethernet SPA on the Cisco
output buffers swapped 7304 router.
out
Example with a Gigabit Ethernet SPA on a Cisco 7304 Router
The following is sample output from the show interfaces gigabitethernet command for the first
interface (port 0) in a 2-Port 10/100/1000 Gigabit Ethernet SPA located in the top subslot (0) of the
MSC that is installed in slot 4 on a Cisco 7304 router:
Router# show interfaces gigabitethernet 4/0/0
GigabitEthernet4/0/0 is up, line protocol is down
Hardware is SPA-2GE-7304, address is 00b0.64ff.5a80 (bia 00b0.64ff.5a80)
MTU 1500 bytes, BW 1000000 Kbit, DLY 10 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive set (10 sec)
Half-duplex, 1000Mb/s, link type is auto, media type is RJ45
output flow-control is unsupported, input flow-control is unsupported
ARP type: ARPA, ARP Timeout 04:00:00
Last input never, output 00:00:09, output hang never
Last clearing of "show interface" counters never
Cisco IOS Interface and Hardware Component Command Reference
1517
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue: 0/40 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts (0 IP multicast)
0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 watchdog, 0 multicast, 0 pause input
109 packets output, 6540 bytes, 0 underruns
0 output errors, 0 collisions, 2 interface resets
0 babbles, 0 late collision, 0 deferred
1 lost carrier, 0 no carrier, 0 PAUSE output
0 output buffer failures, 0 output buffers swapped out
Example with Gigabit Ethernet SPAs Configured as Primary and Backup Interfaces on a Cisco 7600
Router
The following examples show the additional lines included in the display when the command is
issued on two Gigabit Ethernet interfaces that are configured as a primary interface (gi3/0/0) and as
a backup interface (gi3/0/11) for the primary:
Router# show interfaces gigabitEthernet 3/0/0
GigabitEthernet3/0/0 is up, line protocol is up (connected)
Hardware is GigEther SPA, address is 0005.dc57.8800 (bia 0005.dc57.8800)
Backup interface GigabitEthernet3/0/11, failure delay 0 sec, secondary disable delay 0
sec,
.
.
.
Router# show interfaces gigabitEthernet 3/0/11
GigabitEthernet3/0/11 is standby mode, line protocol is down (disabled)
.
.
.
The table below describes the fields shown in the display for Gigabit Ethernet SPA interfaces.
Table 118: show interfaces gigabitethernet Field Descriptions--Gigabit Ethernet SPA
Field Description
GigabitEthernet...is up ...is Indicates whether the interface hardware is currently active and if it has been
administratively down taken down by an administrator.
line protocol is Indicates whether the software processes that handle the line protocol consider
the line usable or if it has been taken down by an administrator.
Hardware Hardware type (for example, SPA-2GE-7304) and MAC address.
Backup interface Identifies the backup interface that exists for this, the primary interface.
Cisco IOS Interface and Hardware Component Command Reference
1518
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Field Description
Failure and secondary The period of time (in seconds) to delay bringing up the backup interface when
delay the primary goes down, and bringing down the backup after the primary becomes
active again. On the Cisco 7600 router, the delay must be 0 (the default) to ensure
that there is no delay between when the primary goes down and the backup comes
up, and vice versa.
Standby mode Indicates that this is a backup interface and that it is currently operating in standby
mode.
Description Alphanumeric string identifying the interface. This appears only if the description
interface configuration command has been configured on the interface.
Internet address Internet address followed by subnet mask.
MTU Maximum transmission unit of the interface. The default is 1500 bytes for the
2-Port 10/100/1000 Gigabit Ethernet SPA.
BW Bandwidth of the interface in kilobits per second.
DLY Delay of the interface in microseconds.
reliability Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
txload, rxload Load on the interface (in the transmit “tx” and receive “rx” directions) as a fraction
of 255 (255/255 is completely saturated), calculated as an exponential average
over 5 minutes.
Encapsulation Encapsulation method assigned to the interface.
loopback Indicates whether loopback is set.
Keepalive Indicates whether keepalives are set, and the time interval.
Half-duplex, Full-duplex Indicates the duplex mode for the interface.
1000Mb/s, 100Mb/s, Speed of the interface in megabits per second.
10Mb/s
link type Specifies whether autonegotiation is being used on the link.
media type Interface port media type: RJ45, SX, LX, or ZX.
100BaseTX/FX Media protocol standard.
ARP type: Type of ARP assigned and the timeout period.
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by an interface and processed locally on the router. Useful for knowing
when a dead interface failed.
This field is not updated by fast-switched traffic.
Cisco IOS Interface and Hardware Component Command Reference
1519
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Field Description
output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by the interface. Useful for knowing when a dead interface failed.
output hang Number of hours, minutes, and seconds (or never) since the interface was last
reset because of a transmission that took too long. When the number of hours in
any of the “last” fields exceeds 24 hours, the number of days and hours is
displayed. If that field overflows, asterisks are printed.
Note This field does not apply to SPA interfaces.
Last clearing Time at which the counters that measure cumulative statistics (such as number
of bytes transmitted and received) shown in this report were last reset to zero.
Note that variables that might affect routing (for example, load and reliability)
are not cleared when the counters are cleared.
A series of asterisks (***) indicates the elapsed time is too large to be displayed.
0:00:00 indicates the counters were cleared more than 231 ms (and less than 232
ms) ago.
Input queue Packet statistics on the input queue reported as:
(size/max/drops/flushes)
• Size--Number of packets in the input queue.
• Max--Maximum size of the queue.
• Drops--Number of packets dropped because of a full input queue.
• Flushes--Number of packets dropped as part of SPD. SPD implements a
selective packet drop policy on the router’s IP process queue. Therefore, it
applies only to process-switched traffic.
Total output drops Total number of packets dropped because of a full output queue.
Queueing strategy Type of Layer 3 queueing active on this interface. The default is FIFO.
Output queue (size/max) Number of packets in the output queue (size), and the maximum size of the queue
(max).
5 minute input rate, 5 Average number of bits and packets transmitted per second in the last 5 minutes.
minute output rate If the interface is not in promiscuous mode, it senses network traffic it sends and
receives (rather than all network traffic).
The 5-minute input and output rates should be used only as an approximation of
traffic per second during a given 5-minute period. These rates are exponentially
weighted averages with a time constant of 5 minutes. A period of four time
constants must pass before the average will be within two percent of the
instantaneous rate of a uniform stream of traffic over that period.
packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
Cisco IOS Interface and Hardware Component Command Reference
1520
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Field Description
Received...broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the medium. For instance, any Ethernet packet that is smaller than
64 bytes is considered a runt.
giants Number of packets that are discarded because they exceed the maximum packet
size of the medium. For example, any Ethernet packet that is larger than 1536
bytes is considered a giant.
Note For the 2-Port 10/100/1000 Gigabit Ethernet SPA, the default is that
a giant is any packet greater than 1536 bytes. However, if you modify
the MTU for the interface, this counter increments when you exceed
the specified MTU for the interface.
throttles Number of times the receiver on the port was disabled, possibly because of buffer
or processor overload.
input errors Includes runts, giants, no buffer, CRC, frame, overrun, and ignored counts. Other
input-related errors can also cause the input errors count to be increased, and
some datagrams may have more than one error; therefore, this sum may not
balance with the sum of enumerated input error counts.
CRC Cyclic redundancy check generated by the originating LAN station or far-end
device does not match the checksum calculated from the data received. On a
LAN, this usually indicates noise or transmission problems on the LAN interface
or the LAN bus itself. A high number of CRCs is usually the result of collisions
or a station transmitting bad data.
frame Number of packets received incorrectly having a CRC error and a noninteger
number of octets. On a LAN, this is usually the result of collisions or a
malfunctioning Ethernet device.
overrun Number of times the receiver hardware was unable to hand received data to a
hardware buffer because the input rate exceeded the receiver’s ability to handle
the data.
ignored Number of received packets ignored by the interface because the interface
hardware ran low on internal buffers. These buffers are different than the system
buffers. Broadcast storms and bursts of noise can cause the ignored count to be
increased.
watchdog Number of times the watchdog receive timer expired. Expiration happens when
receiving a packet with a length greater than 2048 bytes.
input packets with dribble Dribble bit error indicates that a frame is slightly too long. This frame error
condition detected counter is incremented for informational purposes only; the router accepts the
frame.
packets output Total number of messages transmitted by the system.
Cisco IOS Interface and Hardware Component Command Reference
1521
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Field Description
bytes Total number of bytes, including data and MAC encapsulation, transmitted by
the system.
underruns Number of times that the transmitter has been running faster than the router can
handle.
output errors Sum of all errors that prevented the final transmission of datagrams out of the
interface being examined. Note that this may not balance with the sum of the
enumerated output errors, because some datagrams may have more than one
error and others may have errors that do not fall into any of the specifically
tabulated categories.
collisions Number of messages retransmitted because of an Ethernet collision. This is
usually the result of an overextended LAN (Ethernet or transceiver cable too
long, more than two repeaters between stations, or too many cascaded multiport
transceivers). A packet that collides is counted only once in output packets.
interface resets Number of times an interface has been completely reset. This can happen if
packets queued for transmission were not sent within several seconds. Interface
resets can occur when an interface is looped back or shut down.
babbles Transmit jabber timer expired.
late collision Number of late collisions. Late collision happens when a collision occurs after
transmitting the preamble.
deferred Number of times that the interface had to defer while ready to transmit a frame
because the carrier was asserted.
lost carrier Number of times the carrier was lost during transmission.
no carrier Number of times the carrier was not present during the transmission.
Note This field does not apply to SPA interfaces.
output buffer failures, These counters are not used by the 2-Port 10/100/1000 Gigabit Ethernet SPA on
output buffers swapped the Cisco 7304 router.
out
Example with a Packet over SONET/SDH (POS) SPA on a Cisco 7600 Series Router and Catalyst 6500
Series Switch
The following is sample output from the show interfaces pos command on a Cisco 7600 series router
or Catalyst 6500 series switch for POS interface 4/3/0 (which is the interface for port 0 of the SPA
in subslot 3 of the SIP in chassis slot 4):
Router# show interfaces pos 4/3/0
POS4/3/0 is up, line protocol is up (APS working - active)
Hardware is Packet over SONET
Internet address is 10.0.0.1/8
Cisco IOS Interface and Hardware Component Command Reference
1522
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
MTU 4470 bytes, BW 622000 Kbit, DLY 100 usec, rely 255/255, load 1/255
Encapsulation HDLC, crc 16, loopback not set
Keepalive not set
Scramble disabled
Last input 00:00:34, output 04:09:06, output hang never
Last clearing of "show interface" counters never
Queueing strategy:fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Available Bandwidth 622000 kilobits/sec
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
782 packets input, 226563 bytes, 0 no buffer
Received 0 broadcasts, 1 runts, 0 giants, 0 throttles
0 parity
1 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
271 packets output, 28140 bytes, 0 underruns
0 output errors, 0 applique, 2 interface resets
0 output buffer failures, 0 output buffers swapped out
2 carrier transitions
The table below describes the significant fields shown in this display.
Table 119: show interfaces pos Field Descriptions--POS SPA
Field Description
POS4/3/0 is up, line Indicates whether the interface hardware is currently active and can transmit and
protocol is up receive or whether it has been taken down by an administrator.
Hardware is. . . Hardware type:
• For POSIP--cyBus Packet over SONET
• For POS SPAs--Packet over SONET
Internet address is Internet address and subnet mask.
MTU Maximum transmission unit of the interface.
BW Bandwidth of the interface, in kilobits per second.
DLY Delay of the interface, in microseconds.
rely Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes. The calculation uses the
value from the bandwidth interface configuration command.
Encapsulation Encapsulation method assigned to the interface.
Loopback Indicates whether loopbacks are set.
Keepalive Indicates whether keepalives are set.
Cisco IOS Interface and Hardware Component Command Reference
1523
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Field Description
Scramble Indicates whether SONET payload scrambling is enabled. SONET scrambling is
disabled by default. For the POS SPAs on the Cisco 12000 series routers,
scrambling is enabled by default.
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by an interface and processed locally on the router. Useful for knowing
when a dead interface failed. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
(Last) output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by an interface. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
(Last) output hang Number of hours, minutes, and seconds (or never) since the interface was last
reset because of a transmission that took too long. When the number of hours in
any of the “last” fields exceeds 24 hours, the number of days and hours is printed.
If that field overflows, asterisks are printed.
Last clearing Time at which the counters that measure cumulative statistics (such as number
of bytes transmitted and received) shown in this report were last reset to zero.
Note that variables that might affect routing (for example, load and reliability)
are not cleared when the counters are cleared.
*** indicates the elapsed time is too large to be displayed.
0:00:00 indicates the counters were cleared more than 2231 ms (and less than 232
ms) ago.
Queueing strategy FIFO queueing strategy (other queueing strategies you might see are priority-list,
custom-list, and weighted fair).
Output queue, drops input Number of packets in output and input queues. Each number is followed by a
queue, drops slash, the maximum size of the queue, and the number of packets dropped because
a queue was full.
5 minute input rate 5 Average number of bits and packets received or transmitted per second in the last
minute output rate 5 minutes.
packets input Total number of error-free packets received by the system.
bytes (input) Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the
main system. Compare with number of packets ignored. Broadcast storms on
Ethernets and bursts of noise on serial lines are often responsible for no input
buffer events.
broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the medium.
Cisco IOS Interface and Hardware Component Command Reference
1524
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Field Description
giants Number of packets that are discarded because they exceed the maximum packet
size of the medium.
throttles Not supported for POS interfaces.
parity Report of the parity errors on the interface.
input errors Total number of no buffer, runts, giants, CRCs, frame, overrun, ignored, and abort
counts. Other input-related errors can also increment the count, so that this sum
might not balance with the other counts.
CRC Cyclic redundancy checksum generated by the originating LAN station or far-end
device does not match the checksum calculated from the data received. On a LAN,
this usually indicates noise or transmission problems on the LAN interface or the
LAN bus itself. A high number of CRCs is usually the result of collisions or a
station transmitting bad data. On a serial link, CRCs usually indicate noise, gain
hits, or other transmission problems on the data link.
frame Number of packets received incorrectly having a CRC error and a noninteger
number of octets. On a serial line, this is usually the result of noise or other
transmission problems.
overrun Number of times the serial receiver hardware was unable to hand received data
to a hardware buffer because the input rate exceeded the receiver’s ability to
handle the data.
ignored Number of received packets ignored by the interface because the interface hardware
ran low on internal buffers. These buffers are different than the system buffers
mentioned previously in the buffer description. Broadcast storms and bursts of
noise can cause the ignored count to be incremented.
abort Illegal sequence of one bits on the interface.
packets output Total number of messages transmitted by the system.
bytes (output) Total number of bytes, including data and MAC encapsulation, transmitted by
the system.
underruns Number of times that the far-end transmitter has been running faster than the
near-end router’s receiver can handle.
output errors Sum of all errors that prevented the final transmission of datagrams out of the
interface being examined. Note that this might not balance with the sum of the
enumerated output errors, because some datagrams can have more than one error,
and others can have errors that do not fall into any of the specifically tabulated
categories.
applique Indicates an unrecoverable error has occurred on the POSIP applique. The system
then invokes an interface reset.
Cisco IOS Interface and Hardware Component Command Reference
1525
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Field Description
interface resets Number of times an interface has been completely reset. This can happen if packets
queued for transmission were not sent within a certain interval. If the system
notices that the carrier detect line of an interface is up, but the line protocol is
down, it periodically resets the interface in an effort to restart it. Interface resets
can also occur when an unrecoverable interface processor error occurred, or when
an interface is looped back or shut down.
output buffer failures Not supported for POS interfaces.
output buffers swapped Not supported for POS interfaces.
out
carrier transitions Number of times the carrier detect signal of the interface has changed state.
Example with a POS SPA on a Cisco 12000 Series Router
The following is sample output from the show interfaces pos command on a Cisco 12000 series
router for POS interface 1/1/0 (which is the interface for port 0 of the SPA in subslot 1 of the SIP in
chassis slot 1):
Router# show interfaces pos 1/1/0
POS1/1/0 is up, line protocol is up
Hardware is Packet over SONET
Internet address is 10.41.41.2/24
MTU 4470 bytes, BW 9952000 Kbit, DLY 100 usec, rely 255/255, load 1/255
Encapsulation HDLC, crc 32, loopback not set
Keepalive not set
Scramble enabled
Last input 00:00:59, output 00:00:11, output hang never
Last clearing of "show interface" counters 00:00:14
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Available Bandwidth 9582482 kilobits/sec
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants, 0 throttles
0 parity
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
1 packets output, 314 bytes, 0 underruns
0 output errors, 0 applique, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
0 carrier transitions
Example of Displaying Traffic for a Specific Interface on a Cisco CSR 1000v Series Cloud Services
Router
For each interface on the router, the show interfaces command displays information about the link.
In the following example, for the line starting with Full Duplex, the interface port media type is:
Virtual, not a physical media type such as RJ45. This shows that the interface belongs to a cloud
Cisco IOS Interface and Hardware Component Command Reference
1526
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
services router (Cisco CSR 1000v Series Cloud Services Router (CSR 1000v) or Cisco Integrated
Services Router (ISRv)).
Router# show interfaces GigabitEthernet1
GigabitEthernet1 is up, line protocol is up
Hardware is CSR vNIC, address is 000d.3a16.20f1 (bia 000d.3a16.20f1)
Internet address is 12.0.0.4/24
MTU 1500 bytes, BW 1000000 Kbit/sec, DLY 10 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive set (10 sec)
Full Duplex, 1000Mbps, link type is auto, media type is Virtual
Example with a POS SPA SDCC Interface on a Cisco 12000 Series Router
The following is sample output from the show interfaces sdcccommand on a Cisco 12000 series
router for POS interface 1/1/0 (which is the interface for port 0 of the SPA in subslot 1 of the SIP in
chassis slot 1):
Router# show interfaces sdcc 1/1/0
SDCC1/1/0 is administratively down, line protocol is down
Hardware is SDCC
MTU 1500 bytes, BW 192 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation HDLC, crc 32, loopback not set
Keepalive set (10 sec)
Last input never, output never, output hang never
Last clearing of "show interface" counters 00:01:55
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 packets output, 0 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
0 carrier transitions
The table below describes the significant fields shown in the display.
Table 120: show interfaces sdcc Field Descriptions--POS SPA
Field Description
SDCC1/1/0 is Indicates whether the interface hardware is currently active and can transmit and
administratively down, receive or whether it has been taken down by an administrator.
line protocol is down
Hardware is. . . Hardware type is SDCC--Section Data Communications Channel.
Internet address is Internet address and subnet mask.
MTU Maximum transmission unit of the interface.
Cisco IOS Interface and Hardware Component Command Reference
1527
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Field Description
BW Bandwidth of the interface, in kilobits per second.
DLY Delay of the interface, in microseconds.
rely Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes. The calculation uses the
value from the bandwidth interface configuration command.
Encapsulation Encapsulation method assigned to the interface.
crc Cyclic redundancy check size (16 or 32 bits).
Loopback Indicates whether loopback is set.
Keepalive Indicates whether keepalives are set.
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by an interface and processed locally on the router. Useful for knowing
when a dead interface failed. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
(Last) output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by an interface. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
(Last) output hang Number of hours, minutes, and seconds (or never) since the interface was last
reset because of a transmission that took too long. When the number of hours in
any of the “last” fields exceeds 24 hours, the number of days and hours is printed.
If that field overflows, asterisks are printed.
Last clearing Time at which the counters that measure cumulative statistics (such as number
of bytes transmitted and received) shown in this report were last reset to zero.
Note that variables that might affect routing (for example, load and reliability)
are not cleared when the counters are cleared.
*** indicates the elapsed time is too large to be displayed.
0:00:00 indicates the counters were cleared more than 2231 ms (and less than
232 ms) ago.
Queueing strategy FIFO queueing strategy (other queueing strategies you might see are priority-list,
custom-list, and weighted fair).
Output queue, drops input Number of packets in output and input queues. Each number is followed by a
queue, drops slash, the maximum size of the queue, and the number of packets dropped because
a queue was full.
5 minute input rate 5 Average number of bits and packets received or transmitted per second in the
minute output rate last 5 minutes.
Cisco IOS Interface and Hardware Component Command Reference
1528
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Field Description
packets input Total number of error-free packets received by the system.
bytes (input) Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the
main system. Compare with number of packets ignored. Broadcast storms on
Ethernets and bursts of noise on serial lines are often responsible for no input
buffer events.
broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the medium.
giants Number of packets that are discarded because they exceed the maximum packet
size of the medium.
throttles Not supported for POS interfaces.
parity Report of the parity errors on the interface.
input errors Total number of no buffer, runts, giants, CRCs, frame, overrun, ignored, and
abort counts. Other input-related errors can also increment the count, so that this
sum might not balance with the other counts.
CRC Cyclic redundancy checksum generated by the originating LAN station or far-end
device does not match the checksum calculated from the data received. On a
LAN, this usually indicates noise or transmission problems on the LAN interface
or the LAN bus itself. A high number of CRCs is usually the result of collisions
or a station transmitting bad data. On a serial link, CRCs usually indicate noise,
gain hits, or other transmission problems on the data link.
frame Number of packets received incorrectly having a CRC error and a noninteger
number of octets. On a serial line, this is usually the result of noise or other
transmission problems.
overrun Number of times the serial receiver hardware was unable to hand received data
to a hardware buffer because the input rate exceeded the receiver’s ability to
handle the data.
ignored Number of received packets ignored by the interface because the interface
hardware ran low on internal buffers. These buffers are different than the system
buffers mentioned previously in the buffer description. Broadcast storms and
bursts of noise can cause the ignored count to be incremented.
abort Illegal sequence of one bits on the interface.
packets output Total number of messages transmitted by the system.
bytes (output) Total number of bytes, including data and MAC encapsulation, transmitted by
the system.
Cisco IOS Interface and Hardware Component Command Reference
1529
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Field Description
underruns Number of times that the far-end transmitter has been running faster than the
near-end router’s receiver can handle.
output errors Sum of all errors that prevented the final transmission of datagrams out of the
interface being examined. Note that this might not balance with the sum of the
enumerated output errors, because some datagrams can have more than one error,
and others can have errors that do not fall into any of the specifically tabulated
categories.
collisions Not supported for POS interfaces.
interface resets Number of times an interface has been completely reset. This can happen if
packets queued for transmission were not sent within a certain interval. If the
system notices that the carrier detect line of an interface is up, but the line protocol
is down, it periodically resets the interface in an effort to restart it. Interface resets
can also occur when an unrecoverable interface processor error occurred, or when
an interface is looped back or shut down.
output buffer failures Not supported for POS interfaces.
output buffers swapped Not supported for POS interfaces.
out
carrier transitions Number of times the carrier detect signal of the interface has changed state.
Example with a T3/E3 Shared Port Adapter
The following example shows the interface serial statistics on the first port of a T3/E3 SPA installed
in subslot 0 of the SIP located in chassis slot 5:
Router# show interfaces serial 5/0/0
Serial5/0/0 is up, line protocol is up
Hardware is SPA-4T3E3
Internet address is 10.1.1.2/24
MTU 4470 bytes, BW 44210 Kbit, DLY 200 usec,
reliability 255/255, txload 234/255, rxload 234/255
Encapsulation HDLC, crc 16, loopback not set
Keepalive set (10 sec)
Last input 00:00:05, output 00:00:00, output hang never
Last clearing of "show interface" counters never
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue: 0/40 (size/max)
5 minute input rate 40685000 bits/sec, 115624 packets/sec
5 minute output rate 40685000 bits/sec, 115627 packets/sec
4653081241 packets input, 204735493724 bytes, 0 no buffer
Received 4044 broadcasts (0 IP multicast)
0 runts, 0 giants, 0 throttles
0 parity
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
4652915555 packets output, 204728203520 bytes, 0 underruns
0 output errors, 0 applique, 4 interface resets
0 output buffer failures, 0 output buffers swapped out
2 carrier transitions
Cisco IOS Interface and Hardware Component Command Reference
1530
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
The table below describes the fields shown in the show interfaces serial output for a T3/E3 SPA.
Note The fields appearing in the ouput will vary depending on card type, interface configuration, and the
status of the interface.
Table 121: show interfaces serial Field Descriptions--T3/E3 SPA
Field Description
Serial Name of the serial interface.
line protocol is If the line protocol is up, the local router has received keepalive packets from the
remote router. If the line protocol is down, the local router has not received keepalive
packets form the remote router.
Hardware is Designates the specific hardware type of the interface.
Internet address is The IP address of the interface.
MTU The maximum packet size set for the interface.
BW Bandwidth in kilobits per second.
DLY Interface delay in microseconds.
reliability Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
txload Transmit load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes.
rxload Receive load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes.
Encapsulation Encapsulation method.
crc CRC size in bits.
loopback Indicates whether loopback is set.
keepalive Indicates whether keepalives are set.
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by an interface and processed locally on the router. Useful for knowing
when a dead interface failed. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
Last output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by an interface. Useful for knowing when a dead interface failed. This
counter is updated only when packets are process-switched, not when packets are
fast-switched.
Cisco IOS Interface and Hardware Component Command Reference
1531
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Field Description
output hang Number of hours, minutes, and seconds (or never) since the interface was last reset
because of a transmission that took too long. When the number of hours in any of
the “last” fields exceeds 24 hours, the number of days and hours is printed. If that
field overflows, asterisks are printed.
Last clearing of show Time at which the counters that measure cumulative statistics (such as number of
interface counters bytes transmitted and received) shown in this report were last reset to zero. Note
that variables that might affect routing (for example, load and reliability) are not
cleared when the counters are cleared.
*** indicates the elapsed time is too large to be displayed.
0:00:00 indicates the counters were cleared more than 231 milliseconds (and less
than 232 ms) ago.
Input queue Packet statistics on the input queue reported as:
• Size--Current size of the input queue.
• Max--Maximum size of the input queue.
• Drops--Packets dropped because the queue was full.
• Flushes--Number of times that data on queue has been discarded.
Total output drops Total number of dropped packets.
Queueing strategy FIFO queueing strategy (other queueing strategies you might see are priority-list,
custom-list, and weighted fair).
Output queue Number of packets in the output queue (size), and the maximum size of the queue
(max).
5-minute input rate Average number of bits and packets received per second in the last 5 minutes. If
the interface is not in promiscuous mode, it senses network traffic it sends and
receives (rather than all network traffic).
The 5-minute input and output rates should be used only as an approximation of
traffic per second during a given 5-minute period. These rates are exponentially
weighted averages with a time constant of 5 minutes. A period of four time constants
must pass before the average will be within two percent of the instantaneous rate
of a uniform stream of traffic over that period.
5-minute output rate Average number of bits and packets transmitted per second in the last 5 minutes.
If the interface is not in promiscuous mode, it senses network traffic it sends and
receives (rather than all network traffic).
The 5-minute input and output rates should be used only as an approximation of
traffic per second during a given 5-minute period. These rates are exponentially
weighted averages with a time constant of 5 minutes. A period of four time constants
must pass before the average will be within two percent of the instantaneous rate
of a uniform stream of traffic over that period.
Cisco IOS Interface and Hardware Component Command Reference
1532
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Example with a 1-Port 10-Gigabit Ethernet SPA on a Cisco 12000 Series Router
The following is sample output from the show interfaces tengigabitethernet command for the only
interface (port 0) in a 1-Port 10 Gigabit Ethernet SPA located in the top subslot (0) of the carrier
card that is installed in slot 7 on a Cisco 12000 series router:
Router# show interfaces tengigabitethernet 7/0/0
TenGigabitEthernet7/0/0 is up, line protocol is up (connected)
Hardware is TenGigEther SPA, address is 0000.0c00.0102 (bia 000f.342f.c340)
Internet address is 10.1.1.2/24
MTU 1500 bytes, BW 10000000 Kbit, DLY 10 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive not supported
Full-duplex, 10Gb/s
input flow-control is on, output flow-control is on
ARP type: ARPA, ARP Timeout 04:00:00
Last input never, output 00:00:10, output hang never
Last clearing of "show interface" counters 20:24:30
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue: 0/40 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
L2 Switched: ucast: 0 pkt, 0 bytes - mcast: 0 pkt, 0 bytes
L3 in Switched: ucast: 0 pkt, 0 bytes - mcast: 0 pkt, 0 bytes mcast
L3 out Switched: ucast: 0 pkt, 0 bytes mcast: 0 pkt, 0 bytes
237450882 packets input, 15340005588 bytes, 0 no buffer
Received 25 broadcasts (0 IP multicasts)
0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 watchdog, 0 multicast, 0 pause input
0 input packets with dribble condition detected
1676 packets output, 198290 bytes, 0 underruns
0 output errors, 0 collisions, 4 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier, 0 PAUSE output
0 output buffer failures, 0 output buffers swapped out
The table below describes the significant fields shown in the display.
Table 122: show interfaces tengigabitethernet Field Descriptions--10-Gigabit Ethernet SPA
Field Description
TenGigabitEthernet...is up Indicates whether the interface hardware is currently active and if it has been
...is administratively down taken down by an administrator.
line protocol is Indicates whether the software processes that handle the line protocol consider
the line usable or if it has been taken down by an administrator.
Hardware Hardware type and MAC address.
Description Alphanumeric string identifying the interface. This appears only if the
description interface configuration command has been configured on the
interface.
Internet address Internet address followed by subnet mask.
Cisco IOS Interface and Hardware Component Command Reference
1533
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Field Description
MTU Maximum transmission unit of the interface.
BW Bandwidth of the interface in kilobits per second.
DLY Delay of the interface in microseconds.
reliability Reliability of the interface as a fraction of 255 (255/255 is 100 percent
reliability), calculated as an exponential average over 5 minutes.
txload, rxload Load on the interface (in the transmit “tx” and receive “rx” directions) as a
fraction of 255 (255/255 is completely saturated), calculated as an exponential
average over 5 minutes.
Encapsulation Encapsulation method assigned to the interface.
loopback Indicates whether loopback is set.
Keepalive Indicates whether keepalives are set, and the time interval.
Half-duplex, Full-duplex Indicates the duplex mode for the interface.
10Gb/s Speed of the interface in Gigabits per second.
input flow control ... Specifies if input flow control is on or off.
ARP type: Type of ARP assigned and the timeout period.
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by an interface and processed locally on the router. Useful for knowing
when a dead interface failed.
This field is not updated by fast-switched traffic.
output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by the interface. Useful for knowing when a dead interface failed.
output hang Number of hours, minutes, and seconds (or never) since the interface was last
reset because of a transmission that took too long. When the number of hours
in any of the “last” fields exceeds 24 hours, the number of days and hours is
displayed. If that field overflows, asterisks are printed.
Last clearing Time at which the counters that measure cumulative statistics (such as number
of bytes transmitted and received) shown in this report were last reset to zero.
Note that variables that might affect routing (for example, load and reliability)
are not cleared when the counters are cleared.
A series of asterisks (***) indicates the elapsed time is too large to be displayed.
0:00:00 indicates the counters were cleared more than 231 ms (and less than
232 ms) ago.
Cisco IOS Interface and Hardware Component Command Reference
1534
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Field Description
Input queue Packet statistics on the input queue reported as:
(size/max/drops/flushes)
• Size--Number of packets in the input queue.
• Max--Maximum size of the queue.
• Drops--Number of packets dropped because of a full input queue.
• Flushes--Number of packets dropped as part of SPD. SPD implements a
selective packet drop policy on the router’s IP process queue. Therefore,
it applies only to process-switched traffic.
Total output drops Total number of packets dropped because of a full output queue.
Queueing strategy Type of Layer 3 queueing active on this interface. The default is FIFO.
Output queue (size/max) Number of packets in the output queue (size), and the maximum size of the
queue (max).
5 minute input rate, 5 Average number of bits and packets transmitted per second in the last 5 minutes.
minute output rate If the interface is not in promiscuous mode, it senses network traffic it sends
and receives (rather than all network traffic).
The 5-minute input and output rates should be used only as an approximation
of traffic per second during a given 5-minute period. These rates are
exponentially weighted averages with a time constant of 5 minutes. A period
of four time constants must pass before the average will be within two percent
of the instantaneous rate of a uniform stream of traffic over that period.
L2 Switched Provides statistics about Layer 2 switched traffic, including unicast and multicast
traffic.
L3 in Switched Provides statistics about received Layer 3 traffic.
L3 out Switched Provides statistics about sent Layer 3 traffic.
packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
Received...broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the medium.
giants Number of packets that are discarded because they exceed the maximum packet
size of the medium.
throttles Number of times the receiver on the port was disabled, possibly because of
buffer or processor overload.
Cisco IOS Interface and Hardware Component Command Reference
1535
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Field Description
input errors Includes runts, giants, no buffer, CRC, frame, overrun, and ignored counts.
Other input-related errors can also cause the input errors count to be increased,
and some datagrams may have more than one error; therefore, this sum may
not balance with the sum of enumerated input error counts.
CRC Cyclic redundancy check generated by the originating LAN station or far-end
device does not match the checksum calculated from the data received. On a
LAN, this usually indicates noise or transmission problems on the LAN interface
or the LAN bus itself. A high number of CRCs is usually the result of collisions
or a station transmitting bad data.
frame Number of packets received incorrectly having a CRC error and a noninteger
number of octets. On a LAN, this is usually the result of collisions or a
malfunctioning Ethernet device.
overrun Number of times the receiver hardware was unable to hand received data to a
hardware buffer because the input rate exceeded the receiver’s ability to handle
the data.
ignored Number of received packets ignored by the interface because the interface
hardware ran low on internal buffers. These buffers are different than the system
buffers. Broadcast storms and bursts of noise can cause the ignored count to be
increased.
watchdog Number of times the watchdog receive timer expired.
multicast Number of multicast packets.
pause input Number of pause packets received.
input packets with dribble Dribble bit error indicates that a frame is slightly too long. This frame error
condition detected counter is incremented for informational purposes only; the router accepts the
frame.
packets output Total number of messages transmitted by the system.
bytes Total number of bytes, including data and MAC encapsulation, transmitted by
the system.
underruns Number of times that the transmitter has been running faster than the router can
handle.
output errors Sum of all errors that prevented the final transmission of datagrams out of the
interface being examined. Note that this may not balance with the sum of the
enumerated output errors, because some datagrams may have more than one
error and others may have errors that do not fall into any of the specifically
tabulated categories.
collisions Number of messages retransmitted because of an Ethernet collision. This is
usually the result of an overextended LAN (Ethernet or transceiver cable too
long, more than two repeaters between stations, or too many cascaded multiport
transceivers). A packet that collides is counted only once in output packets.
Cisco IOS Interface and Hardware Component Command Reference
1536
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Field Description
interface resets Number of times an interface has been completely reset. This can happen if
packets queued for transmission were not sent within several seconds. Interface
resets can occur when an interface is looped back or shut down.
babbles Transmit jabber timer expired.
late collision Number of late collisions. Late collision happens when a collision occurs after
transmitting the preamble.
deferred Number of times that the interface had to defer while ready to transmit a frame
because the carrier was asserted.
lost carrier Number of times the carrier was lost during transmission.
no carrier Number of times the carrier was not present during the transmission.
pause output Number of pause packets transmitted.
output buffer failures, Number of output butters failures and output buffers swapped out.
output buffers swapped out
Displaying Traffic for a Specific Interface Example
This example shows how to display traffic for a specific interface:
Router# show interfaces GigabitEthernet1/1
GigabitEthernet0/1 is up, line protocol is up
Hardware is BCM1125 Internal MAC, address is 0016.9de5.d9d1 (bia 0016.9de5.d9d1)
Internet address is 172.16.165.40/27
MTU 1500 bytes, BW 100000 Kbit/sec, DLY 100 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive set (10 sec)
Full-duplex, 100Mb/s, media type is RJ45
output flow-control is XON, input flow-control is XON
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:00:11, output 00:00:08, output hang never
Last clearing of "show interface" counters never
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue: 0/40 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
10 packets input, 2537 bytes, 0 no buffer
Received 10 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 watchdog, 46 multicast, 0 pause input
0 input packets with dribble condition detected
18 packets output, 3412 bytes, 0 underruns
0 output errors, 0 collisions, 1 interface resets
7 unknown protocol drops
0 babbles, 0 late collision, 0 deferred
2 lost carrier, 0 no carrier, 0 pause output
0 output buffer failures, 0 output buffers swapped out
Cisco IOS Interface and Hardware Component Command Reference
1537
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces
Note The unknown protocol drops field displayed in the above example refers to the total number of
packets dropped due to unknown or unsupported types of protocol. This field occurs on several
platforms such as the Cisco 3725, 3745, 3825, and 7507 series routers.
This example shows how to display traffic for a FlexWAN module:
Router# show interfaces pos 6/1/0.1
POS6/1/0.1 is up, line protocol is up
Hardware is Packet over Sonet
Internet address is 10.1.2.2/24
MTU 4470 bytes, BW 155000 Kbit, DLY 100 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation FRAME-RELAY <<<+++ no packets info after this line
Arches#sh mod 6
Mod Ports Card Type Model Serial No.
--- ----- -------------------------------------- ------------------ -----------
6 0 2 port adapter FlexWAN WS-X6182-2PA SAD04340JY3
Mod MAC addresses Hw Fw Sw Status
--- ---------------------------------- ------ ------------ ------------ -------
6 0001.6412.a234 to 0001.6412.a273 1.3 12.2(2004022 12.2(2004022 Ok
Mod Online Diag Status
--- -------------------
6 Pass
Router#
Related Commands Command Description
fair-queue Enables WFQ.
interface Configures an interface type and enters interface configuration mode.
show controllers fastethernet Displays Fast Ethernet interface information, transmission statistics
and errors, and applicable MAC destination address and VLAN filtering
tables.
show controllers gigabitethernet Displays Gigabit Ethernet interface information, transmission statistics
and errors, and applicable MAC destination address and VLAN filtering
tables.
show controllers pos Displays information about the POS controllers.
show controllers serial Displays controller statistics.
Cisco IOS Interface and Hardware Component Command Reference
1538
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces accounting
show interfaces accounting
To display the number of packets of each protocol type that have been sent through all configured interfaces,
use the showinterfacesaccounting command in user EXEC or privileged EXEC mode.
show interfaces [{interface type number|null interface-number|vlan vlan-id}] accounting
Syntax Description interface (Optional) Interface type; possible valid values are ethernet, fastethernet,
gigabitethernet, tengigabitethernet, pos, and port-channel, atm, and ge-wan.
type number (Optional) Module and port number; see the “Usage Guidelines” section for valid
values.
null interface-number (Optional) Specifies the null interface; the valid value is 0.
vlan vlan-id (Optional) Specifies the VLAN ID; valid values are from 1 to 4094.
Command Modes User EXEC
Privileged EXEC (#)
Command History Release Modification
12.2(17a)SX1 This command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release
12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SRC Support for IPv6 was added.
12.2(33)SB This command was integrated into Cisco IOS Release 12.2(33)SB.
Cisco IOS XE Release 2.1 This command was integrated into Cisco IOS XE Release 2.1.
15.4(2)S This command was integrated into Cisco IOS Release 15.4(2)S.
Usage Guidelines
Note The Pkts Out and Chars Out fields display IPv6 packet counts only. The Pkts In and Chars In fields display
both IPv4 and IPv6 packet counts, except for tunnel interfaces. For tunnel interfaces, the IPv6 input packets
are counted as IPv6 packets only.
Due to hardware limitations on the ASIC, PFC IPv4 and IPv6 packets cannot be differentiated in the Pkts In
and Chars In fields for IP count the IPv6 and IPv4 packets that are hardware forwarded. The Pkts In and Chars
In fields for IPv6 only count software-forwarded packets. The IP Pkts Out and Chars Out fields show IPv4
packets, and the IPv6 Pkts Out and Chars Out fields show IPv6 packets.
Cisco IOS Interface and Hardware Component Command Reference
1539
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces accounting
The interface-number argument designates the module and port number. Valid values for interface-number
depend on the specified interface type and the chassis and module that are used. For example, if you specify
a Gigabit Ethernet interface and have a 48-port 10/100BASE-T Ethernet module that is installed in a 13-slot
chassis, valid values for the module number are from 1 to 13 and valid values for the port number are from
1 to 48.
The port channels from 257 to 282 are internally allocated and are supported on the CSM and the FWSM
only.
If you do not enter any keywords, all counters for all modules are displayed.
Examples This example shows how to display the number of packets of each protocol type that have been sent
through all configured interfaces:
Device# show interfaces gigabitethernet 5/2 accounting
GigabitEthernet5/2
Protocol Pkts In Chars In Pkts Out Chars Out
IP 50521 50521000 0 0
DEC MOP 0 0 1 129
CDP 0 0 1 592
IPv6 11 834 96 131658
The table below describes the significant fields shown in the display.
Table 123: show interfaces accounting Command Output Fields
Field Description
Protocol Protocol that is operating on the interface.
Pkts In For IP it is the number of IPv4 software switched, IPv4 and IPv6 hardware switched packets
received for the specified protocol.
For IPv6 it is the number of IPv6 software switched packets received for the specified protocol.
Chars In For IP it is the number of IPv4 software switched, IPv4 and IPv6 hardware switched characters
received for the specified protocol.
For IPv6 it is the number of IPv6 software switched characters received for the specified protocol.
Pkts Out For IP it is the number of IPv4 sofware and hardware switched packets transmitted for the
specified protocol.
For IPv6 it is the number of IPv6 sofware and hardware switched packets transmitted for the
specified protocol.
Chars Out For IP it is the number of IPv4 software and hardware switched characters transmitted for the
specified protocol.
For IPv6 it is the number of IPv6 software and hardware switched characters transmitted for the
specified protocol.
Related Commands Command Description
show interfaces Displays the status and statistics for the interfaces in the chassis.
Cisco IOS Interface and Hardware Component Command Reference
1540
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces analysis-module
show interfaces analysis-module
To display status, traffic data, and configuration information about the analysis module interface, use the
showinterfacesanalysis-module command in user EXEC or privileged EXEC mode.
show interfaces analysis-module slot/unit
Syntax Description slot Number of the router chassis slot for the network module.
/ unit Number of the daughter card on the network analysis module (NAM). For NAM, always use 0.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.3(4)XD This command was introduced on the following platforms: Cisco 2600XM series, Cisco 2691,
Cisco 3660, Cisco 3725, and Cisco 3745.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T.
12.3(8)T4 This command was implemented on the following platforms: Cisco 2811, Cisco 2821, and Cisco
2851.
12.3(11)T This command was implemented on the Cisco 3800 series.
Usage Guidelines The analysis module interface is a Fast Ethernet interface on the router that connects to the internal interface
on the Network Analysis Module (NM-NAM).
Examples The command in the following example displays status, traffic data, and configuration information
about the analysis module interface when the NM-NAM is installed in slot 2 of a Cisco 3745.
Router# show interfaces analysis-module 2/0
Network-Analyzer2/0 is up, line protocol is up
Hardware is I82559FE, address is 0001.a535.0920 (bia 0001.a535.0920)
Internet address is 10.1.1.1/24
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive set (10 sec)
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:00:26, output 00:00:00, output hang never
Last clearing of "show interface" counters never
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 4682
Queueing strategy: fifo
Output queue: 0/60 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 36000 bits/sec, 22 packets/sec
905 packets input, 38190 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 input packets with dribble condition detected
671863 packets output, 96101624 bytes, 0 underruns
Cisco IOS Interface and Hardware Component Command Reference
1541
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces analysis-module
0 output errors, 0 collisions, 1 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out
The table below describes the significant fields shown in the display.
Table 124: show interfaces analysis-module Field Descriptions
Field Description
Network-Analyzer Indicates whether the analysis module interface hardware is currently active. The
analysis module interface is the router-side interface for the internal Ethernet segment
between the router and the NAM network module.
If the analysis module interface hardware is operational, the output states that the
“Network-Analyzer 1/0 is up.” If the interface has been taken down by an
administrator, the output states that the “Network-Analyzer 1/0 is administratively
down.”
line protocol is Indicates whether the software processes that handle the line protocol consider the
line usable or whether the line has been taken down by an administrator.
Hardware is...address is Hardware type and address.
MTU Maximum transmission unit (MTU) of the analysis module interface.
BW Bandwidth of the interface, in kbps.
DLY Delay of the interface, in microseconds.
reliability Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
txload Transmit load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes.
rxload Receive load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes.
Encapsulation Encapsulation method assigned to the interface.
loopback Indicates whether or not loopback is set.
Keepalive Indicates whether or not keepalives are set and the interval between keepalives if
they have been set.
ARP type...ARP Type of Address Resolution Protocol (ARP) assigned and length of timeout.
Timeout
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by the interface and processed locally on the router. This field is useful
for detecting when a dead interface failed.
Note This field is not updated by fast-switched traffic.
Cisco IOS Interface and Hardware Component Command Reference
1542
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces analysis-module
Field Description
output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by the interface. This field is useful for detecting when a dead interface
failed.
output hang Number of hours, minutes, and seconds (or never) since the interface was last reset
because a transmission took too long. When the number of hours in any of the “last”
fields exceeds 24 hours, the number of days and hours is printed. If that field
overflows, asterisks are printed.
Last clearing Time at which the counters that measure cumulative statistics (such as number of
bytes transmitted and received) shown in this report were last reset to zero. Note
that variables that might affect routing (for example, load and reliability) are not
cleared when the counters are cleared.
Asterisks (***) indicate that the elapsed time is too large to be displayed.
Input queue Number of packets in the input queue. Each number is followed by a slash, the
maximum size of the queue, the number of packets dropped because of a full queue,
and the number of times that queued packets have been discarded.
Total output drops Number of packets in the output queue that have been dropped because of a full
queue.
Queueing strategy Queueing strategy applied to the interface, which is configurable under the interface.
The default is FIFO (first-in, first-out).
Output queue Number of packets in the output queue, and the maximum size of the queue. Each
number is followed by a slash.
5 minute input rate, 5 Average number of bits and packets transmitted per second in the last 5 minutes.
minute output rate If the interface is not in promiscuous mode, it senses network traffic that it sends
and receives (rather than all network traffic).
The 5-minute input and output rates should be used only as an approximation of
traffic per second during a given 5-minute period. These rates are exponentially
weighted averages with a time constant of 5 minutes. A period of four time constants
must pass before the average will be within 2 percent of the instantaneous rate of
a uniform stream of traffic over that period.
Note The 5-minute period referenced in this output is a load interval that is
configurable under the interface. The default value is 5 minutes.
packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the
main system. Compare with ignored count. Broadcast storms on Ethernets and
bursts of noise on serial lines are often responsible for no input buffer events.
Received...broadcasts Number of broadcasts received.
Cisco IOS Interface and Hardware Component Command Reference
1543
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces analysis-module
Field Description
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the medium. For instance, any Ethernet packet that is less than 64
bytes is considered a runt.
giants Number of packets that are discarded because they exceed the maximum packet
size of the medium. For example, any Ethernet packet that is greater than 1518
bytes is considered a giant.
throttles Number of times that the interface requested another interface within the router to
slow down.
input errors Errors that include runts, giants, no buffer, cyclic redundancy checksum (CRC),
frame, overrun, and ignored counts. Other input-related errors can also cause the
input errors count to be increased, and some datagrams may have more than one
error; therefore, this sum may not balance with the sum of enumerated input error
counts.
CRC Errors created when the CRC generated by the originating LAN station or far-end
device does not match the checksum calculated from the data received. On a LAN,
this usually indicates noise or transmission problems on the LAN interface or the
LAN bus itself. A high number of CRCs is usually the result of collisions or a station
that is transmitting bad data.
frame Number of packets received incorrectly that have a CRC error and a noninteger
number of octets. On a LAN, this is usually the result of collisions or a
malfunctioning Ethernet device.
overrun Number of times that the receiver hardware was unable to hand received data to a
hardware buffer because the input rate exceeded the receiver’s ability to handle the
data.
ignored Number of received packets that were ignored by the interface because the interface
hardware ran low on internal buffers. These buffers are different from system buffer
space described. Broadcast storms and bursts of noise can cause the ignored count
to increase.
input packets with Number of packets with dribble condition. Dribble bit error indicates that a frame
dribble condition is slightly too long. This frame error counter is incremented just for informational
detected purposes; the router accepts the frame.
packets output Total number of messages that have been transmitted by the system.
bytes Total number of bytes, including data and MAC encapsulation, that have been
transmitted by the system.
underruns Number of times that the transmitter has run faster than the router could handle.
This may never be reported on some interfaces.
Cisco IOS Interface and Hardware Component Command Reference
1544
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces analysis-module
Field Description
output errors Sum of all errors that prevented the final transmission of datagrams out of the
interface that is being examined. Note that this may not balance with the sum of
the enumerated output errors, because some datagrams may have more than one
error, and others may have errors that do not fall into any of the specifically tabulated
categories.
collisions Number of messages that have been retransmitted because of an Ethernet collision.
This is usually the result of an overextended LAN (Ethernet or transceiver cable
too long, more than two repeaters between stations, or too many cascaded multiport
transceivers). A packet that collides is counted only once in output packets.
interface resets Number of times an interface has been completely reset. This can happen if packets
that were queued for transmission were not sent within several seconds. On a serial
line, this can be caused by a malfunctioning modem that is not supplying the transmit
clock signal or by a cable problem. If the system notices that the carrier detect line
of a serial interface is up, but the line protocol is down, it periodically resets the
interface in an effort to restart it. Interface resets can also occur when an interface
is looped back or shut down.
babbles Count of frames greater than 1518 bytes that have been transmitted, indicating that
the transmitter has been on the interface longer than the time necessary to transmit
the largest frame.
late collision Number of late collisions. A collision becomes a late collision when it occurs after
the preamble has been transmitted.
deferred Deferred indicates that the chip, while ready to transmit a frame, had to defer because
the carrier was asserted.
lost carrier Number of times that the carrier was lost during transmission.
no carrier Number of times that the carrier was not present during the transmission.
output buffer failures, Number of failed buffers and number of buffers swapped out.
output buffers swapped
out
Related Commands Command Description
show controllers analysis-module Displays controller information for the analysis module interface.
Cisco IOS Interface and Hardware Component Command Reference
1545
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces bdi
show interfaces bdi
To display statistics for bridge domain interfaces (BDI) configured on the router, use the show interfaces
command in privileged EXEC mode.
show interfaces [type number]
Syntax Description number (Optional) Port number on the selected interface.
accounting (Optional) Displays the number of packets of each protocol type that have been sent through
the interface.
controller (Optional) Displays the interface status, configuration and controller status.
counters (Optional) Displays the current status of the protocol counters enabled.
crb (Optional) Displays interface routing or bridging information.
dampening (Optional) Displays interface dampening information.
description (Optional) Displays the interface description.
etherchannel (Optional) Displays interface Ether Channel information.
history (Optional) Displays the interface history.
irb (Optional) Displays interface routing or bridging information.
mac-accounting (Optional) Displays interface MAC accounting information.
mpls-exp (Optional) Displays interface Multiprotocol Label Switching (MPLS) experimental
accounting information.
precedence (Optional) Displays interface precedence accounting information.
random-detect (Optional) Displays interface Weighted Random Early Detection (WRED) information.
rate-limit (Optional) Displays interface rate-limit information.
stats (Optional) Displays interface packets and octets, in and out, by using switching path.
summary (Optional) Displays an interface summary.
Command Default This command has no default settings.
Command Modes
User EXEC (>)
Privileged EXEC (#)
Cisco IOS Interface and Hardware Component Command Reference
1546
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces bdi
Command History Release Modification
Cisco IOS XE Release 3.2S This command was introduced on Cisco ASR 1000 Series Aggregation Services
Routers.
Examples The following example shows BDI configuration output:
Router# show interfaces BDI3
asr2#sh int bdi3
BDI3 is up, line protocol is up
Hardware is BDI, address is cafe.aaaa.0003 (bia 0024.14ab.86bf)
Internet address is 197.1.3.12/24
MTU 1500 bytes, BW 1000000 Kbit/sec, DLY 10 usec,
reliability 255/255, txload 8/255, rxload 8/255
Encapsulation QinQ VLAN, outer ID 1, inner ID 2, loopback not set
Keepalive not supported
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:19:15, output 00:03:59, output hang never
Last clearing of "show interface" counters 00:17:36
Input queue: 0/375/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue: 0/40 (size/max)
5 minute input rate 32947000 bits/sec, 73545 packets/sec
5 minute output rate 32877000 bits/sec, 73391 packets/sec
78126222 packets input, 4375068432 bytes, 0 no buffer
Received 0 broadcasts (0 IP multicasts)
0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
78126268 packets output, 4375071092 bytes, 0 underruns
0 output errors, 0 interface resets
0 unknown protocol drops
.
.
The following example shows the BDI interface summary:
Router#show interfaces bdi 3 summary
*: interface is up
IHQ: pkts in input hold queue IQD: pkts dropped from input queue
OHQ: pkts in output hold queue OQD: pkts dropped from output queue
RXBS: rx rate (bits/sec) RXPS: rx rate (pkts/sec)
TXBS: tx rate (bits/sec) TXPS: tx rate (pkts/sec)
TRTL: throttle count
Interface IHQ IQD OHQ OQD RXBS L
--------------------------------------------------------------------------------
BDI3 0 0 0 0 0 0
Cisco IOS Interface and Hardware Component Command Reference
1547
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces capabilities
show interfaces capabilities
To display the interface capabilities for a module, an interface, or all interfaces, use the
showinterfacescapabilities command in user EXEC or privileged EXEC mode.
show interfaces [interface interface-number] capabilities [module number]
Syntax Description interface (Optional) Interface type; possible valid values are ethernet, fastethernet,
gigabitethernet, tengigabitethernet, pos, atm, and port-channel, and ge-wan.
interface-number Module and port number; see the “Usage Guidelines” section for valid values.
module number (Optional) Specifies the module number; see the “Usage Guidelines” section for valid
values.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(18)SXE This output was changed to include information about the following on the Supervisor Engine
720 only:
• Port security
• dot1x
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The pos, atm, and ge-wan keywords are supported on Cisco 7600 series routers that are configured with a
Supervisor Engine 2
The interface-numberargument designates the module and port number. Valid values for interface-number
depend on the chassis and module that are used. For example, if you have a 48-port 10/100BASE-T Ethernet
module that is installed in a 13-slot chassis, valid values for the slot number are from 2 to 13 and valid values
for the port number are from 1 to 48.
The port-channel values are from 0 to 282; values from 257 to 282 are supported on the CSM and the FWSM
only.
Examples This example shows how to display the interface capabilities for a module:
Router> show interfaces capabilities module 6
FastEthernet6/1
Dot1x: yes
Model: WS-X6248-RJ-45
Cisco IOS Interface and Hardware Component Command Reference
1548
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces capabilities
Type: 10/100BaseTX
Speed: 10,100,auto
Duplex: half,full
Trunk encap. type: 802.1Q,ISL
Trunk mode: on,off,desirable,nonegotiate
Channel: yes
Broadcast suppression: percentage(0-100)
Flowcontrol: rx-(off,on),tx-(none)
Membership: static
Fast Start: yes
QOS scheduling: rx-(1q4t), tx-(2q2t)
CoS rewrite: yes
ToS rewrite: yes
Inline power: no
SPAN: source/destination
UDLD yes
Link Debounce: yes
Link Debounce Time: no
Ports on ASIC: 1-12
Port-Security: yes
Router#
This example shows how to display the interface capabilities for an interface:
Router? show interfaces fastethernet 4/1 capabilities
FastEthernet4/1
Model: WS-X6348-RJ-45
Type: 10/100BaseTX
Speed: 10,100,auto
Duplex: half,full
Trunk encap. type: 802.1Q,ISL
Trunk mode: on,off,desirable,nonegotiate
Channel: yes
Broadcast suppression: percentage(0-100)
Flowcontrol: rx-(off,on),tx-(none)
Fast Start: yes
QOS scheduling: rx-(1q4t), tx-(2q2t)
CoS rewrite: yes
ToS rewrite: yes
Inline power: no
SPAN: source/destination
This example shows how to display the port-channel interface capabilities:
Router> show interfaces port-channel 12 capabilities
Port-channel12
Model: NO IDPROM
Type: unknown
Speed: 10,100,1000,auto
Duplex: half,full
Trunk encap. type: 802.1Q,ISL
Trunk mode: on,off,desirable,nonegotiate
Channel: yes
Broadcast suppression: percentage(0-100)
Flowcontrol: rx-(off,on),tx-(none)
Fast Start: yes
QOS scheduling: rx-(1q4t), tx-(1q4t)
CoS rewrite: yes
ToS rewrite: yes
Inline power: no
SPAN: source/destination
Router#
Cisco IOS Interface and Hardware Component Command Reference
1549
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces capabilities
Related Commands Command Description
show interfaces Displays the status and statistics for the interfaces in the chassis.
Cisco IOS Interface and Hardware Component Command Reference
1550
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces content-engine
show interfaces content-engine
To display basic interface configuration information for a content engine (CE) network module, use the
showinterfacescontent-engine command in privileged EXEC mode.
show interfaces content-engine slot/unit
Syntax Description slot Number of the router chassis slot for the network module.
unit Number of the daughter card on the network module. For CE network modules, always use 0.
Command Modes Privileged EXEC
Command History Release Modification
12.2(11)YT This command was introduced.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.
Usage Guidelines The output for this command contains the basic configuration for the interface, as well as the number of
packets transmitted, output rate, and so forth.
Examples The following example displays interface status and data for the CE network module in slot 1 for
Cisco 2600 series routers (except the Cisco 2691). Note that the bandwidth is 10 Mbps.
Router# show interfaces content-engine 1/0
Content-Engine1/0 is up, line protocol is up
Hardware is I82559FE, address is 0006.280e.10b0 (bia 0006.280e.10b0)
MTU 1500 bytes, BW 10000 Kbit, DLY 1000 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive set (10 sec)
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:00:50, output 00:00:04, output hang never
Last clearing of "show interface" counters never
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue :0/40 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
13 packets input, 5835 bytes, 0 no buffer
Received 13 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 input packets with dribble condition detected
71 packets output, 6285 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out
The following example displays interface status and data for a CE network module in slot 3 of a
Cisco 2691. This example shows the 100-Mbps bandwidth of a Cisco 2691 and all the other supported
routers except the remainder of the Cisco 2600 series.
Cisco IOS Interface and Hardware Component Command Reference
1551
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces content-engine
Router# show interfaces content-engine 3/0
Content-Engine3/0 is up, line protocol is up
Hardware is I82559FE, address is 0004.9a0b.4b30 (bia 0004.9a0b.4b30)
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive set (10 sec)
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:00:41, output 00:00:04, output hang never
Last clearing of "show interface" counters never
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue :0/40 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
14 packets input, 6176 bytes, 0 no buffer
Received 14 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 input packets with dribble condition detected
109 packets output, 16881 bytes, 0 underruns
0 output errors, 0 collisions, 1 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out
The table below describes the significant fields shown in the display.
Table 125: show interfaces content-engine Field Descriptions
Field Description
Content-Engine Indicates whether the CE interface hardware is currently active. If the CE interface
hardware is operational, the output states that “Content-Engine slot/port is up.” If
it has been taken down by an administrator, the output states that “Content-Engine
slot/port is administratively down.”
line protocol Indicates whether the software processes that handle the line protocol consider the
line usable or whether the line has been taken down by an administrator.
Hardware...address Hardware type and address.
MTU Maximum transmission unit (MTU) of the content engine interface.
BW Bandwidth of the interface, in kilobits per second.
DLY Delay of the interface, in microseconds.
reliability Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
txload Transmit load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes.
rxload Receive load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes.
Encapsulation Encapsulation method assigned to the interface.
Cisco IOS Interface and Hardware Component Command Reference
1552
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces content-engine
Field Description
loopback Indicates whether loopback is set.
Keepalive Indicates whether keepalives are set and the interval between keepalives if they
have been set.
ARP type...Timeout Type of Address Resolution Protocol (ARP) assigned and length of timeout.
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by the interface and processed locally on the router. This field is useful
for detecting when a dead interface failed.
Note This field is not updated by fast-switched traffic.
output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by the interface. This field is useful for detecting when a dead interface
failed.
output hang Number of hours, minutes, and seconds (or never) since the interface was last reset
because a transmission took too long. When the number of hours in any of the “last”
fields exceeds 24 hours, the number of days and hours is printed. If that field
overflows, asterisks are printed.
Last clearing Time at which the counters that measure cumulative statistics (such as number of
bytes transmitted and received) shown in this report were last reset to zero. Note
that variables that might affect routing (for example, load and reliability) are not
cleared when the counters are cleared.
Asterisks (***) indicate that the elapsed time is too large to be displayed.
A time of all zeroes (0:00:00) indicates that the counters were cleared more than
231 ms (and less than 232 ms) ago.
Input queue Number of packets in the input queue. Each number is followed by a slash, the
maximum size of the queue, the number of packets dropped because of a full queue,
and the number of times that queued packets have been discarded.
Total output drops Number of packets in the output queue that have been dropped because of a full
queue.
Queueing strategy Queueing strategy applied to the interface, which is configurable under the interface.
The default is FIFO.
Output queue Number of packets in the output queue. Each number is followed by a slash, the
maximum size of the queue, and the number of packets dropped because of a full
queue.
Cisco IOS Interface and Hardware Component Command Reference
1553
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces content-engine
Field Description
5 minute input rate, 5 Average number of bits and packets transmitted per second in the last 5 minutes.
minute output rate If the interface is not in promiscuous mode, it senses network traffic that it sends
and receives (rather than all network traffic).
The 5-minute input and output rates should be used only as an approximation of
traffic per second during a given 5-minute period. These rates are exponentially
weighted averages with a time constant of 5 minutes. A period of four time constants
must pass before the average will be within 2 percent of the instantaneous rate of
a uniform stream of traffic over that period.
Note The 5-minute period referenced in this output is a load interval that is
configurable under the interface. The default value is 5 minutes.
packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the
main system. Compare with ignored count. Broadcast storms on Ethernets and bursts
of noise on serial lines are often responsible for no input buffer events.
Received...broadcasts Number of broadcasts received.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the medium. For instance, any Ethernet packet that is less than 64
bytes is considered a runt.
giants Number of packets that are discarded because they exceed the maximum packet
size of the medium. For example, any Ethernet packet that is greater than 1518 bytes
is considered a giant.
throttles Number of times that the interface requested another interface within the router to
slow down.
input errors Errors that include runts, giants, no buffer, cyclic redundancy check (CRC), frame,
overrun, and ignored counts. Other input-related errors can also cause the input
errors count to be increased, and some datagrams may have more than one error;
therefore, this sum may not balance with the sum of enumerated input error counts.
CRC Errors created when the CRC generated by the originating LAN station or far-end
device does not match the checksum calculated from the data received. On a LAN,
this usually indicates noise or transmission problems on the LAN interface or the
LAN bus itself. A high number of CRCs is usually the result of collisions or a station
that is transmitting bad data.
frame Number of packets received incorrectly that have a CRC error and a non integer
number of octets. On a LAN, this is usually the result of collisions or a
malfunctioning Ethernet device.
Cisco IOS Interface and Hardware Component Command Reference
1554
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces content-engine
Field Description
overrun Number of times that the receiver hardware was unable to hand received data to a
hardware buffer because the input rate exceeded the receiver’s ability to handle the
data.
ignored Number of received packets that were ignored by the interface because the interface
hardware ran low on internal buffers. These buffers are different from system buffer
space described. Broadcast storms and bursts of noise can cause the ignored count
to increase.
input packets with Number of packets with dribble condition. Dribble bit error indicates that a frame
dribble condition is slightly too long. This frame error counter is incremented just for informational
detected purposes; the router accepts the frame.
packets output Total number of messages that have been transmitted by the system.
bytes Total number of bytes, including data and MAC encapsulation, that have been
transmitted by the system.
underruns Number of times that the transmitter has run faster than the router could handle.
This may never be reported on some interfaces.
output errors Sum of all errors that prevented the final transmission of datagrams out of the content
engine that is being examined. Note that this may not balance with the sum of the
enumerated output errors, because some datagrams may have more than one error,
and others may have errors that do not fall into any of the specifically tabulated
categories.
collisions Number of messages that have been retransmitted because of an Ethernet collision.
This is usually the result of an overextended LAN (Ethernet or transceiver cable
too long, more than two repeaters between stations, or too many cascaded multiport
transceivers). A packet that collides is counted only once in output packets.
interface resets Number of times an interface has been completely reset. This can happen if packets
that were queued for transmission were not sent within several seconds. On a serial
line, this can be caused by a malfunctioning modem that is not supplying the transmit
clock signal or by a cable problem. If the system notices that the carrier detect line
of a serial interface is up, but the line protocol is down, it periodically resets the
interface in an effort to restart it. Interface resets can also occur when an interface
is looped back or shut down.
babbles Count of frames greater than 1518 bytes that have been transmitted, indicating that
the transmitter has been on the interface longer than the time necessary to transmit
the largest frame.
late collision Number of late collisions. A collision becomes a late collision when it occurs after
the preamble has been transmitted.
deferred Deferred indicates that the chip, while ready to transmit a frame, had to defer because
the carrier was asserted.
lost carrier Number of times that the carrier was lost during transmission.
Cisco IOS Interface and Hardware Component Command Reference
1555
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces content-engine
Field Description
no carrier Number of times that the carrier was not present during the transmission.
output buffer failures, Number of failed buffers and number of buffers swapped out.
output buffers swapped
out
Related Commands Command Description
interface content-engine Configures an interface for a CE network module and enters interface
configuration mode.
show controllers content-engine Displays controller information for CE network modules.
Cisco IOS Interface and Hardware Component Command Reference
1556
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces counters nonzero
show interfaces counters nonzero
To get the counter information for ports which have non zero values, use the showinterfacescountersnonzero
command in user EXEC or privileged EXEC mode.
show interfaces counters nonzero [module number]
Syntax Description module (Optional) Limits display to interfaces on module.
number The module number has a range from 1 to 6.
Command Default This command has no default settings.
Command Modes EXEC (>) Privileged EXEC (#)
Command History Release Modification
12.2(18)SXF This command was introduced for Cisco IOS Release 12.2(18)SXF.
12.2(32)SX This command was integrated into Cisco IOS Release 12.2(32)SX.
12.2(33)SXH This command was integrated into Cisco IOS Release 12.2(33)SXH.
12.2(32)XJC This command was integrated into Cisco IOS Release 12.2(32)XJC.
Usage Guidelines Use the showinterfacescountersnonzero command to get the counter information for ports which have non
zero values.
Examples The following example shows the output of showinterfacescountersnonzero command. The output
is displayed only if any one of the counters is non zero. The counters are checked for all the ports
present in the router.
Router#sh interfaces counters nonzero
Port InOctets InUcastPkts InMcastPkts InBcastPkts
Fa3/1 110519159 253605 1276951 574
Gi6/2 120329657 213823 1294339 67009
Port OutOctets OutUcastPkts OutMcastPkts OutBcastPkts
Fa3/1 15950485 142 41048 1
Gi6/2 15475538 431 41036 6
Port Last-Clear-Counters
Gi1/1 never
Gi1/2 never
Gi1/3 never
Gi1/4 never
Gi1/5 never
Gi1/6 never
Gi1/7 never
Gi1/8 never
Fa3/1 never
Fa3/2 never
Fa3/3 never
Cisco IOS Interface and Hardware Component Command Reference
1557
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces counters nonzero
Fa3/4 never
Router#
Related Commands Command Description
show interfaces counters Displays the traffic seen by the physical interface.
Cisco IOS Interface and Hardware Component Command Reference
1558
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces ctunnel
show interfaces ctunnel
To display information about an IP over Connectionless Network service (CLNS) tunnel (CTunnel), use the
showinterfacesctunnel command in privileged EXEC mode.
show interfaces ctunnel interface-number [accounting]
Syntax Description interface-number Virtual interface number.
accounting (Optional) Displays the number of packets of each protocol type that have been sent
through the interface.
Command Modes Privileged EXEC
Command History Release Modification
12.1(5)T This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines For the showinterfacesctunnel command, all output that relates to a physical medium is irrelevant and should
be ignored because the CTunnel is a virtual interface.
Examples The following is sample output from the showinterfacesctunnel command:
Router# show interfaces ctunnel 1
CTunnel1 is up, line protocol is up
Hardware is CTunnel
Internet address is 10.0.0.1/24
MTU 1514 bytes, BW 9 Kbit, DLY 500000 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation TUNNEL, loopback not set
Keepalive set (10 sec)
Tunnel destination 49.0001.2222.2222.2222.cc
Last input never, output 00:00:05, output hang never
Last clearing of “show interface” counters never
Queueing strategy: fifo
Output queue 0/0, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
1 packets output, 104 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
The table below describes the significant fields shown in the display.
Cisco IOS Interface and Hardware Component Command Reference
1559
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces ctunnel
Table 126: show interfaces ctunnel Field Descriptions
Field Description
CTunnel is {up | down | Interface is currently active (up) or inactive (down). Shows interface is
administratively down} administratively down if disabled.
line protocol is {up | down} Shows line protocol up if a valid route is available to the CLNS tunnel
(CTunnel) destination. Shows line protocol down if no route is available, or
if the route would be recursive.
Hardware Type of interface, in this instance CTunnel.
Internet address IP address of the interface.
MTU Maximum transmission unit of the interface.
BW Bandwidth, as specified by the user, that is available on the link.
DLY Delay of the interface, in microseconds.
Encapsulation Encapsulation method is always TUNNEL for tunnels.
Loopback Shows whether loopback is set or not.
Keepalive Shows whether keepalives are set or not.
Tunnel destination The NSAP address of the tunnel destination. The N-Selector part of the
displayed NSAP address is set by the router and cannot be changed.
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by an interface. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
Last clearing Time at which the counters that measure cumulative statistics (such as
number of bytes transmitted and received) shown in this report were last
reset to zero. Note that variables that might affect routing (for example, load
and reliability) are not cleared when the counters are cleared.
*** indicates that the elapsed time is too large to be displayed.
0:00:00 indicates that the counters were cleared more than 231 ms (and less
than 232 ms) ago.
Queueing strategy Type of queueing active on this interface.
Output queue, drops Input Number of packets in output and input queues. Each number is followed by
queue, drops a slash, the maximum size of the queue, and the number of packets dropped
because of a full queue.
Cisco IOS Interface and Hardware Component Command Reference
1560
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces ctunnel
Field Description
Five minute input rate, Five Average number of bits and packets transmitted per second in the last 5
minute output rate minutes.
The 5-minute input and output rates should be used only as an approximation
of traffic per second during a given 5-minute period. These rates are
exponentially weighted averages with a time constant of 5 minutes. A period
of 4 time constants must pass before the average will be within 2 percent of
the instantaneous rate of a uniform stream of traffic over that period.
packets input Total number of error-free packets received by the system.
bytes Total number of bytes in the error-free packets received by the system.
no buffer Number of received packets discarded because there was no memory buffer
available.
broadcasts Total number of broadcast or multicast packets received by the interface.
runts This field does not apply to the CTunnel virtual interface.
giants This field does not apply to the CTunnel virtual interface.
throttles This field does not apply to the CTunnel virtual interface.
input errors This field does not apply to the CTunnel virtual interface.
CRC This field does not apply to the CTunnel virtual interface.
frame This field does not apply to the CTunnel virtual interface.
overrun This field does not apply to the CTunnel virtual interface.
ignored This field does not apply to the CTunnel virtual interface.
abort This field does not apply to the CTunnel virtual interface.
packets output Total number of messages transmitted by the system.
bytes Total number of bytes transmitted by the system.
underruns This field does not apply to the CTunnel virtual interface.
output errors This field does not apply to the CTunnel virtual interface.
collisions This field does not apply to the CTunnel virtual interface.
interface resets Number of times an interface has been reset. The interface may be reset
manually by the administrator or automatically by the system when an
internal error occurs.
output buffer failures Number of buffer failures.
output buffers swapped out Number of output buffer allocation failures.
Cisco IOS Interface and Hardware Component Command Reference
1561
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces ctunnel
Related Commands Command Description
show interfaces Displays the statistical information specific to interfaces.
Cisco IOS Interface and Hardware Component Command Reference
1562
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces debounce
show interfaces debounce
To display the status and configuration for the debounce timer, use the showinterfacesdebounce command
in user EXEC or privileged EXEC mode.
show interfaces [{interface interface-number|null interface-number|vlan vlan-id}] debounce [module
num]
Syntax Description interface (Optional) Interface type; possible valid values are ethernet, fastethernet,
gigabitethernet, tengigabitethernet, port-channel, pos, atm, and ge-wan.
interface-number (Optional) Module and port number; see the “Usage Guidelines” section for valid
values.
null interface-number (Optional) Specifies the null interface; the valid value is 0.
vlan vlan-id (Optional) Specifies the VLAN; valid values are from 1 to 4094.
module num (Optional) Limits the display to interfaces on the specified module.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The pos, atm, and ge-wan keywords are supported on Cisco 7600 series routers that are configured with a
Supervisor Engine 2.
The debounce timer is not supported on the 10-Gigabit Ethernet module (WSX-6502-10GE).
The interface-number argument designates the module and port number. Valid values for interface-number
depend on the specified interface type and the chassis and module that are used. For example, if you specify
a Gigabit Ethernet interface and have a 48-port 10/100BASE-T Ethernet module that is installed in a 13-slot
chassis, valid values for the module number are from 1 to 13 and valid values for the port number are from
1 to 48.
The port-channel values are from 0 to 282; values from 257 to 282 are supported on the CSM and the FWSM
only.
Examples This example shows how to display the debounce configuration of an interface:
Router> show interfaces GigabitEthernet 1/1 debounce
Port Debounce time Value
Cisco IOS Interface and Hardware Component Command Reference
1563
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces debounce
Gi1/1 enable 100
Router>
Related Commands Command Description
link debounce Enables the debounce timer on an interface.
Cisco IOS Interface and Hardware Component Command Reference
1564
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces description
show interfaces description
To display a description and a status of an interface, use the showinterfacesdescription command in user
EXEC or privileged EXEC mode.
show interfaces [interface] description
Syntax Description interface (Optional) Interface type; for a list of valid values, see the “Usage Guidelines” section .
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines When you enter the interface value, these formats can be used:
• card-type slot /first-port - last-port
• card-type slot /first-port - last-port
You can define a single port range per command entry. If you specify a range of ports, the range must consist
of the same slot and port type. When you define a range, you must enter a space before and after the hyphen
(-) as follows:
show interfaces gigabitethernet7/1 - 7 counters broadcast
Possible valid values for card-type are ethernet, fastethernet, gigabitethernet, tengigabitethernet,
port-channel, pos, atm, and ge-wan
The pos, atm, and ge-wan keywords are supported on Cisco 7600 series routers that are configured with a
Supervisor Engine 2.
The port-channel values are from 0 to 282; values from 257 to 282 are supported on the CSM and the FWSM
only.
Examples This example shows how to display the information for all interfaces:
Router> show interfaces description
Interface Status Protocol Description
PO0/0 admin down down First POS interface
PO0/1 admin down down
Gi1/0 up up GigE to server farm
Router>
Cisco IOS Interface and Hardware Component Command Reference
1565
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces description
Related Commands Command Description
description Includes a specific description about the DSP interface.
Cisco IOS Interface and Hardware Component Command Reference
1566
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces ethernet
show interfaces ethernet
To display information about an Ethernet interface on the router, use the showinterfacesethernet command
in privileged EXEC mode.
Standard Syntax
show interfaces ethernet [number] [accounting]
Cisco 7200 and 7500 Series
show interfaces:ethernet accounting optionshow interfaces ethernet [slot/port] [accounting]
Cisco 7500 Series with Ports on VIPs
show interfaces ethernet [slot/port-adapter/port]
Catalyst 6500 Series Switches
show interfaces ethernet [vlan vlan]
Syntax Description number (Optional) Port number on the selected interface.
accounting (Optional) Displays the number of packets of each protocol type that have been sent through
the interface.
slot (Optional) Slot number. Refer to the appropriate hardware manual for slot and port
information.
/ port (Optional) Port number. Refer to the appropriate hardware manual for slot and port
information.
/ port-adapter (Optional) Port adapter number. Refer to the appropriate hardware manual for information
about port adapter compatibility.
vlan vlan (Optional) Specifies a VLAN. Limits the display of switch port information to the specified
VLAN. Range: 1 to 4094.
Command Modes Privileged EXEC
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
12.2(33)SXI This command was changed to add the optional vlanvlan keyword and argument.
Usage Guidelines If you do not provide values for the numberargument (or slot, port, and port-adapter arguments), the command
displays statistics for all network interfaces. The optional keyword accounting displays the number of packets
of each protocol type that have been sent through the interface.
Cisco IOS Interface and Hardware Component Command Reference
1567
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces ethernet
Cisco IOS Release 12.2(33)SXI and later releases allow you to limit the display of switch port information
to the specified VLAN.
Examples The following is sample output from the showinterfacesethernetcommand for Ethernet interface
0:
Router# show interfaces ethernet 0
Ethernet0 is up, line protocol is up
Hardware is Lance, address is 0060.3ef1.702b (bia 0060.3ef1.702b)
Internet address is 172.21.102.33/24
MTU 1500 bytes, BW 10000 Kbit, DLY 1000 usec, rely 255/255, load 1/255
Encapsulation ARPA, loopback not set, keepalive set (10 sec)
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:00:20, output 00:00:06, output hang never
Last clearing of "show interface" counters never
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
115331 packets input, 27282407 bytes, 0 no buffer
Received 93567 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 input packets with dribble condition detected
143782 packets output, 14482169 bytes, 0 underruns
0 output errors, 1 collisions, 5 interface resets
0 babbles, 0 late collision, 7 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out
The table below describes significant fields shown in the display.
Table 127: show interfaces ethernet Field Descriptions
Field Description
Ethernet ... is up ... is Indicates whether the interface hardware is currently active and if it has been taken
administratively down down by an administrator. “Disabled” indicates the router has received over 5000
errors in a keepalive interval, which is 10 seconds by default.
line protocol is {up | Indicates whether the software processes that handle the line protocol believe the
down | administratively interface is usable (that is, whether keepalives are successful) or if it has been taken
down} down by an administrator.
Hardware Hardware type (for example, MCI Ethernet, SCI, cBus Ethernet) and address.
Internet address Internet address followed by subnet mask.
MTU Maximum transmission unit of the interface.
BW Bandwidth of the interface, in kilobits per second.
DLY Delay of the interface, in microseconds.
rely Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
Cisco IOS Interface and Hardware Component Command Reference
1568
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces ethernet
Field Description
load Load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes.
Encapsulation Encapsulation method assigned to interface.
ARP type: Type of Address Resolution Protocol assigned.
loopback Indicates whether loopback is set or not.
keepalive Indicates whether keepalives are set or not.
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by an interface and processed locally on the router. Useful for knowing
when a dead interface failed. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
Last output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by an interface. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by the interface. Useful for knowing when a dead interface failed.
output hang Number of hours, minutes, and seconds (or never) since the interface was last reset
because of a transmission that took too long. When the number of hours in any of
the “last” fields exceeds 24 hours, the number of days and hours is printed. If that
field overflows, asterisks are printed.
Last clearing Time at which the counters that measure cumulative statistics (such as number of
bytes transmitted and received) shown in this report were last reset to zero. Note
that variables that might affect routing (for example, load and reliability) are not
cleared when the counters are cleared.
*** indicates the elapsed time is too large to be displayed.
0:00:00 indicates the counters were cleared more than 231 ms (and less than 232
ms) ago.
Output queue, input Number of packets in output and input queues. Each number is followed by a slash,
queue, drops the maximum size of the queue, and the number of packets dropped because of a
full queue.
5 minute input rate, 5 Average number of bits and packets transmitted per second in the last five minutes.
minute output rate If the interface is not in promiscuous mode, it senses network traffic it sends and
receives (rather than all network traffic).
The five-minute input and output rates should be used only as an approximation
of traffic per second during a given five-minute period. These rates are exponentially
weighted averages with a time constant of five minutes. A period of four time
constants must pass before the average will be within two percent of the
instantaneous rate of a uniform stream of traffic over that period.
packets input Total number of error-free packets received by the system.
Cisco IOS Interface and Hardware Component Command Reference
1569
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces ethernet
Field Description
bytes input Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
no buffers Number of received packets discarded because there was no buffer space in the
main system. Compare with ignored count. Broadcast storms on Ethernet networks
and bursts of noise on serial lines are often responsible for no input buffer events.
Received ... broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the medium. For instance, any Ethernet packet that is less than 64
bytes is considered a runt.
giants Number of packets that are discarded because they exceed the maximum packet
size of the medium. For example, any Ethernet packet that is greater than 1518
bytes is considered a giant.
input error Includes runts, giants, no buffer, CRC, frame, overrun, and ignored counts. Other
input-related errors can also cause the input errors count to be increased, and some
datagrams may have more than one error; therefore, this sum may not balance with
the sum of enumerated input error counts.
CRC Cyclic redundancy checksum generated by the originating LAN station or far-end
device does not match the checksum calculated from the data received. On a LAN,
this usually indicates noise or transmission problems on the LAN interface or the
LAN bus itself. A high number of CRCs is usually the result of collisions or a
station transmitting bad data.
frame Number of packets received incorrectly having a CRC error and a noninteger
number of octets. On a LAN, this is usually the result of collisions or a
malfunctioning Ethernet device.
overrun Number of times the receiver hardware was unable to hand received data to a
hardware buffer because the input rate exceeded the receiver’s ability to handle
the data.
ignored Number of received packets ignored by the interface because the interface hardware
ran low on internal buffers. These buffers are different than the system buffers
mentioned previously in the buffer description. Broadcast storms and bursts of
noise can cause the ignored count to be increased.
input packets with Dribble bit error indicates that a frame is slightly too long. This frame error counter
dribble condition is incremented just for informational purposes; the router accepts the frame.
detected
packets output Total number of messages transmitted by the system.
bytes Total number of bytes, including data and MAC encapsulation, transmitted by the
system.
underruns Number of times that the transmitter has been running faster than the router can
handle. This may never be reported on some interfaces.
Cisco IOS Interface and Hardware Component Command Reference
1570
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces ethernet
Field Description
output errors Sum of all errors that prevented the final transmission of datagrams out of the
interface being examined. Note that this may not balance with the sum of the
enumerated output errors, as some datagrams may have more than one error, and
others may have errors that do not fall into any of the specifically tabulated
categories.
collisions Number of messages transmitted because of an Ethernet collision. A packet that
collides is counted only once in output packets.
interface resets Number of times an interface has been completely reset. This can happen if packets
queued for transmission were not sent within several seconds. On a serial line, this
can be caused by a malfunctioning modem that is not supplying the transmit clock
signal, or by a cable problem. If the system notices that the carrier detect line of a
serial interface is up, but the line protocol is down, it periodically resets the interface
in an effort to restart it. Interface resets can also occur when an interface is looped
back or shut down.
restarts Number of times a Type 2 Ethernet controller was restarted because of errors.
babbles The transmit jabber timer expired.
late collision Number of late collisions. Late collision happens when a collision occurs after
transmitting the preamble. The most common cause of late collisions is that your
Ethernet cable segments are too long for the speed at which you are transmitting.
deferred Deferred indicates that the chip had to defer while ready to transmit a frame because
the carrier was asserted.
lost carrier Number of times the carrier was lost during transmission.
no carrier Number of times the carrier was not present during the transmission.
output buffer failures Number of failed buffers and number of buffers swapped out.
Example on Cisco 7500 Series Routers
The following sample output illustrates the showinterfacesethernet command on a Cisco 7500 series
router:
Router# show interfaces ethernet 4/2
Ethernet4/2 is up, line protocol is up
Hardware is cxBus Ethernet, address is 0000.0c02.d0ce (bia 0000.0c02.d0ce)
Internet address is 10.108.7.1, subnet mask is 255.255.255.0
MTU 1500 bytes, BW 10000 Kbit, DLY 1000 usec, rely 255/255, load 1/255
Encapsulation ARPA, loopback not set, keepalive set (10 sec)
ARP type: ARPA, ARP Timeout 4:00:00
Last input 0:00:00, output 0:00:09, output hang never
Last clearing of “show interface” counters 0:56:40
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 3000 bits/sec, 4 packets/sec
Five minute output rate 0 bits/sec, 0 packets/sec
4961 packets input, 715381 bytes, 0 no buffer
Cisco IOS Interface and Hardware Component Command Reference
1571
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces ethernet
Received 2014 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
567 packets output, 224914 bytes, 0 underruns
0 output errors, 168 collisions, 0 interface resets, 0 restarts
0 babbles, 2 late collision, 7 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out
Example with Accounting Option
The following is sample output from the showinterfacesethernet command with the accounting
option on a Cisco 7500 series router:
Router# show interfaces ethernet 4/2 accounting
Ethernet4/2
Protocol Pkts In Chars In Pkts Out Chars Out
IP 7344 4787842 1803 1535774
Appletalk 33345 4797459 12781 1089695
DEC MOP 0 0 127 9779
ARP 7 420 39 2340
The table below describes the fields shown in the display.
Table 128: show interfaces ethernet Field Descriptions--Accounting
Field Description
Protocol Protocol that is operating on the interface.
Pkts In Number of packets received for that protocol.
Chars In Number of characters received for that protocol.
Pkts Out Number of packets transmitted for that protocol.
Chars Out Number of characters transmitted for that protocol.
Catalyst 6500 Series Switches
The following is sample output from the showinterfacesethernetcommand for VLAN 2:
Router# show interfaces ethernet vlan 2
Cisco IOS Interface and Hardware Component Command Reference
1572
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces fastethernet
show interfaces fastethernet
To display information about the Fast Ethernet interfaces, use the showinterfacesfastethernet command in
user EXEC or privileged EXEC mode.
Standard Syntax
show interfaces fastethernet [number]
Cisco 7200 and Cisco 7500 Series
show interfaces fastethernet [slot/port]
Cisco 7500 Series with a VIP
show interfaces fastethernet [slot/port-adapter/port]
Syntax Description number (Optional) Port, connector, or interface card number. On a Cisco 4700 series routers, specifies
the network interface module (NIM) or NPM number. The numbers are assigned at the factory
at the time of installation or when added to a system.
slot (Optional) Slot number. Refer to the appropriate hardware manual for slot and port
information.
port (Optional) Port number. Refer to the appropriate hardware manual for slot and port
information.
port-adapter (Optional) Port adapter number. Refer to the appropriate hardware manual for information
about port adapter compatibility.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
11.2 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples The following is sample output from the showinterfacesfastethernet command on a Cisco 4700
series router:
Router# show interfaces fastethernet 0
Fast Ethernet0 is up, line protocol is up
Hardware is DEC21140, address is 0000.0c0c.1111 (bia 0002.eaa3.5a60)
Internet address is 10.0.0.1 255.0.0.0
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec, rely 255/255, load 1/255
Encapsulation ARPA, loopback not set, keepalive not set, hdx, 100BaseTX
ARP type: ARPA, ARP Timeout 4:00:00
Last input never, output 0:00:16, output hang 0:28:01
Last clearing of “show interface” counters 0:20:05
Cisco IOS Interface and Hardware Component Command Reference
1573
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces fastethernet
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 1786161921 ignored, 0 abort
0 watchdog, 0 multicast
0 input packets with dribble condition detected
67 packets output, 8151 bytes, 0 underruns
0 output errors, 0 collisions, 1 interface resets, 0 restarts
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out
The following is sample output from the showinterfacesfastethernet command on a Cisco AS5300
access server:
Router# show interfaces fastethernet 0
Fast Ethernet0 is up, line protocol is up
Hardware is DEC21140AD, address is 00e0.1e3e.c179 (bia 00e0.1e3e.c179)
Internet address is 10.17.30.4/16
MTU 1500 bytes, BW 10000 Kbit, DLY 1000 usec, rely 255/255, load 1/255
Encapsulation ARPA, loopback not set, keepalive set (10 sec)
Half-duplex, 10Mb/s, 100BaseTX/FX
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:00:00, output 00:00:03, output hang never
Last clearing of "show interface" counters never
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/120, 8 drops
5 minute input rate 2000 bits/sec, 3 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
158773 packets input, 17362631 bytes, 4 no buffer
Received 158781 broadcasts, 0 runts, 0 giants, 7 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 watchdog, 0 multicast
0 input packets with dribble condition detected
6299 packets output, 622530 bytes, 0 underruns
1 output errors, 0 collisions, 3 interface resets
0 babbles, 0 late collision, 0 deferred
1 lost carrier, 1 no carrier
0 output buffer failures, 0 output buffers swapped out
The following shows information specific to the first Fast Ethernet Interface Processor (FEIP) port
in slot 0 on a Cisco 7500 series router:
Router# show interfaces fastethernet 0/1
Fast Ethernet0/1 is administratively down, line protocol is down
Hardware is cxBus Fast Ethernet, address is 0000.0c35.dc16 (bia 0000.0c35.dc16)
Internet address is 10.1.0.64 255.255.0.0
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec, rely 255/255, load 1/255
Encapsulation ARPA, loopback not set, keepalive not set, half-duplex, RJ45 (or MII)
ARP type: ARPA, ARP Timeout 4:00:00
Last input never, output 2:03:52, output hang never
Last clearing of "show interface" counters never
Output queue 0/40, 0 drops; input queue 0/75, 1 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 watchdog, 0 multicast
0 input packets with dribble condition detected
5 packets output, 805 bytes, 0 underruns
Cisco IOS Interface and Hardware Component Command Reference
1574
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces fastethernet
0 output errors, 0 collisions, 4 interface resets, 0 restarts
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out
The table below describes the fields shown in these displays.
Table 129: show interfaces fastethernet Field Descriptions
Field Description
Fast Ethernet0 is ... is up Indicates whether the interface hardware is currently active and if it has been taken
...is administratively down by an administrator.
down
line protocol is Indicates whether the software processes that handle the line protocol consider the
line usable or if it has been taken down by an administrator.
Hardware Hardware type (for example, MCI Ethernet, SCI, cBus Ethernet) and address.
Internet address Internet address followed by subnet mask.
MTU Maximum transmission unit of the interface.
BW Bandwidth of the interface, in kilobits per second.
DLY Delay of the interface, in microseconds.
rely Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes.
Encapsulation Encapsulation method assigned to interface.
ARP type Type of Address Resolution Protocol assigned.
loopback Indicates whether loopback is set or not.
keepalive Indicates whether keepalives are set or not.
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by an interface and processed locally on the router. Useful for knowing
when a dead interface failed. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by the interface. Useful for knowing when a dead interface failed. This
counter is updated only when packets are process-switched, not when packets are
fast-switched.
output hang Number of hours, minutes, and seconds (or never) since the interface was last reset
because of a transmission that took too long. When the number of hours in any of
the “last” fields exceeds 24 hours, the number of days and hours is printed. If that
field overflows, asterisks are printed.
Cisco IOS Interface and Hardware Component Command Reference
1575
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces fastethernet
Field Description
Last clearing Time at which the counters that measure cumulative statistics (such as number of
bytes transmitted and received) shown in this report were last reset to zero. Note
that variables that might affect routing (for example, load and reliability) are not
cleared when the counters are cleared.
*** indicates the elapsed time is too large to be displayed.
0:00:00 indicates the counters were cleared more than 231 ms (and less than 232
ms) ago.
Output queue, input Number of packets in output and input queues. Each number is followed by a slash,
queue, drops the maximum size of the queue, and the number of packets dropped because of a
full queue.
5 minute input rate, 5 Average number of bits and packets transmitted per second in the last 5 minutes.
minute output rate If the interface is not in promiscuous mode, it senses network traffic it sends and
receives (rather than all network traffic).
The 5-minute input and output rates should be used only as an approximation of
traffic per second during a given 5-minute period. These rates are exponentially
weighted averages with a time constant of 5 minutes. A period of four time constants
must pass before the average will be within two percent of the instantaneous rate
of a uniform stream of traffic over that period.
packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the
main system. Compare with ignored count. Broadcast storms on Ethernets and
bursts of noise on serial lines are often responsible for no input buffer events.
Received ... broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the medium. For instance, any Ethernet packet that is less than 64
bytes is considered a runt.
giants Number of packets that are discarded because they exceed the maximum packet
size of the medium. For example, any Ethernet packet that is greater than 1518
bytes is considered a giant.
input errors Includes runts, giants, no buffer, CRC, frame, overrun, and ignored counts. Other
input-related errors can also cause the input errors count to be increased, and some
datagrams may have more than one error; therefore, this sum may not balance with
the sum of enumerated input error counts.
CRC Cyclic redundancy checksum generated by the originating LAN station or far-end
device does not match the checksum calculated from the data received. On a LAN,
this usually indicates noise or transmission problems on the LAN interface or the
LAN bus itself. A high number of CRCs is usually the result of collisions or a
station transmitting bad data.
Cisco IOS Interface and Hardware Component Command Reference
1576
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces fastethernet
Field Description
frame Number of packets received incorrectly having a CRC error and a noninteger
number of octets. On a LAN, this is usually the result of collisions or a
malfunctioning Ethernet device.
overrun Number of times the receiver hardware was unable to hand received data to a
hardware buffer because the input rate exceeded the receiver’s ability to handle
the data.
ignored Number of received packets ignored by the interface because the interface hardware
ran low on internal buffers. These buffers are different than the system buffers
mentioned previously in the buffer description. Broadcast storms and bursts of
noise can cause the ignored count to be increased.
abort Number of packets whose receipt was aborted.
watchdog Number of times watchdog receive timer expired. It happens when receiving a
packet with length greater than 2048.
multicast Number of multicast packets received.
input packets with Dribble bit error indicates that a frame is slightly too long. This frame error counter
dribble condition is incremented just for informational purposes; the router accepts the frame.
detected
packets output Total number of messages transmitted by the system.
bytes Total number of bytes, including data and MAC encapsulation, transmitted by the
system.
underruns Number of times that the transmitter has been running faster than the router can
handle. This may never be reported on some interfaces.
output errors Sum of all errors that prevented the final transmission of datagrams out of the
interface being examined. Note that this may not balance with the sum of the
enumerated output errors, as some datagrams may have more than one error, and
others may have errors that do not fall into any of the specifically tabulated
categories.
collisions Number of messages retransmitted because of an Ethernet collision. A packet that
collides is counted only once in output packets.
interface resets Number of times an interface has been completely reset. This can happen if packets
queued for transmission were not sent within several seconds. On a serial line, this
can be caused by a malfunctioning modem that is not supplying the transmit clock
signal, or by a cable problem. If the system notices that the carrier detect line of a
serial interface is up, but the line protocol is down, it periodically resets the interface
in an effort to restart it. Interface resets can also occur when an interface is looped
back or shut down.
restarts Number of times a Type 2 Ethernet controller was restarted because of errors.
babbles The transmit jabber timer expired.
Cisco IOS Interface and Hardware Component Command Reference
1577
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces fastethernet
Field Description
late collision Number of late collisions. Late collision happens when a collision occurs after
transmitting the preamble. The most common cause of late collisions is that your
Ethernet cable segments are too long for the speed at which you are transmitting.
deferred Deferred indicates that the chip had to defer while ready to transmit a frame because
the carrier was asserted.
lost carrier Number of times the carrier was lost during transmission.
no carrier Number of times the carrier was not present during the transmission.
output buffer failures Number of failed buffers and number of buffers swapped out.
The following example of the showinterfacesfastethernetcommand shows all the information
specific to the first PA-12E/2FE interface port (interface port 0) in port adapter slot 3:
Router# show interfaces fastethernet 3/0
Fast Ethernet3/0 is up, line protocol is up
Hardware is TSWITCH, address is 00e0.f7a4.5130 (bia 00e0.f7a4.5130)
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec, rely 255/255, load 1/255
Encapsulation ARPA, loopback not set, keepalive set (10 sec)
Half-duplex, 100BaseTX
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:05:30, output 00:00:00, output hang never
Last clearing of “show interface” counters never
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
312 packets input, 18370 bytes, 0 no buffer
Received 216 broadcasts, 0 runts, 0 giants, 0 throttles
3 input errors, 0 CRC, 0 frame, 0 overrun, 3 ignored, 0 abort
0 input packets with dribble condition detected
15490 packets output, 1555780 bytes, 0 underruns
2 output errors, 0 collisions, 2 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
2 output buffer failures, 0 output buffers swapped out
The table below describes the fields shown in this display.
Table 130: show interfaces fastethernet Field Descriptions--PA-12E/2FE
Field Description
Fast Ethernet... is up ...is Indicates whether the interface hardware is currently active and if it has been taken
administratively down down by an administrator.
line protocol is Indicates whether the software processes that handle the line protocol consider the
line usable or if it has been taken down by an administrator.
Hardware Hardware type (for example, MCI Ethernet, SCI, cBus Ethernet) and address.
Internet address Internet address followed by subnet mask.
MTU Maximum transmission unit of the interface.
Cisco IOS Interface and Hardware Component Command Reference
1578
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces fastethernet
Field Description
BW Bandwidth of the interface, in kilobits per second.
DLY Delay of the interface, in microseconds.
rely Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes.
Encapsulation Encapsulation method assigned to interface.
ARP type Type of Address Resolution Protocol assigned.
loopback Indicates whether loopback is set or not.
keepalive Indicates whether keepalives are set or not.
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by an interface and processed locally on the router. Useful for knowing
when a dead interface failed. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by the interface. Useful for knowing when a dead interface failed.
output hang Number of hours, minutes, and seconds (or never) since the interface was last reset
because of a transmission that took too long. When the number of hours in any of
the “last” fields exceeds 24 hours, the number of days and hours is printed. If that
field overflows, asterisks are printed.
Last clearing Time at which the counters that measure cumulative statistics (such as number of
bytes transmitted and received) shown in this report were last reset to zero. Note
that variables that might affect routing (for example, load and reliability) are not
cleared when the counters are cleared.
*** indicates the elapsed time is too large to be displayed.
0:00:00 indicates the counters were cleared more than 231 ms (and less than 232
ms) ago.
Output queue, input Number of packets in output and input queues. Each number is followed by a slash,
queue, drops the maximum size of the queue, and the number of packets dropped because of a
full queue.
Cisco IOS Interface and Hardware Component Command Reference
1579
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces fastethernet
Field Description
5 minute input rate, 5 Average number of bits and packets transmitted per second in the last 5 minutes.
minute output rate If the interface is not in promiscuous mode, it senses network traffic it sends and
receives (rather than all network traffic).
The 5-minute input and output rates should be used only as an approximation of
traffic per second during a given 5-minute period. These rates are exponentially
weighted averages with a time constant of 5 minutes. A period of four time constants
must pass before the average will be within two percent of the instantaneous rate
of a uniform stream of traffic over that period.
packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the
main system. Compare with ignored count. Broadcast storms on Ethernets and
bursts of noise on serial lines are often responsible for no input buffer events.
Received ... broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the medium. For instance, any Ethernet packet that is less than 64
bytes is considered a runt.
giants Number of packets that are discarded because they exceed the maximum packet
size of the medium. For example, any Ethernet packet that is greater than 1518
bytes is considered a giant.
throttles Number of times the receiver on the port was disabled, possibly because of buffer
or processor overload.
input errors Includes runts, giants, no buffer, CRC, frame, overrun, and ignored counts. Other
input-related errors can also cause the input errors count to be increased, and some
datagrams may have more than one error; therefore, this sum may not balance with
the sum of enumerated input error counts.
CRC Cyclic redundancy checksum generated by the originating LAN station or far-end
device does not match the checksum calculated from the data received. On a LAN,
this usually indicates noise or transmission problems on the LAN interface or the
LAN bus itself. A high number of CRCs is usually the result of collisions or a
station transmitting bad data.
frame Number of packets received incorrectly having a CRC error and a noninteger
number of octets. On a LAN, this is usually the result of collisions or a
malfunctioning Ethernet device.
overrun Number of times the receiver hardware was unable to hand received data to a
hardware buffer because the input rate exceeded the receiver’s ability to handle
the data.
Cisco IOS Interface and Hardware Component Command Reference
1580
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces fastethernet
Field Description
ignored Number of received packets ignored by the interface because the interface hardware
ran low on internal buffers. These buffers are different than the system buffers
mentioned previously in the buffer description. Broadcast storms and bursts of
noise can cause the ignored count to be increased.
abort Number of packets whose receipt was aborted.
input packets with Dribble bit error indicates that a frame is slightly too long. This frame error counter
dribble condition is incremented for informational purposes; the router accepts the frame.
detected
packets output Total number of messages transmitted by the system.
bytes Total number of bytes, including data and MAC encapsulation, transmitted by the
system.
underruns Number of times that the transmitter has been running faster than the router can
handle. This may never be reported on some interfaces.
output errors Sum of all errors that prevented the final transmission of datagrams out of the
interface being examined. Note that this may not balance with the sum of the
enumerated output errors, as some datagrams may have more than one error, and
others may have errors that do not fall into any of the specifically tabulated
categories.
collisions Number of messages retransmitted because of an Ethernet collision. A packet that
collides is counted only once in output packets.
interface resets Number of times an interface has been completely reset. This can happen if packets
queued for transmission were not sent within several seconds. On a serial line, this
can be caused by a malfunctioning modem that is not supplying the transmit clock
signal, or by a cable problem. If the system notices that the carrier detect line of a
serial interface is up, but the line protocol is down, it periodically resets the interface
in an effort to restart it. Interface resets can also occur when an interface is looped
back or shut down.
babbles Transmit jabber timer expired.
late collision Number of late collisions. Late collision happens when a collision occurs after
transmitting the preamble. The most common cause of late collisions is that your
Ethernet cable segments are too long for the speed at which you are transmitting.
deferred Deferred indicates that the chip had to defer while ready to transmit a frame because
the carrier was asserted.
lost carrier Number of times the carrier was lost during transmission.
no carrier Number of times the carrier was not present during the transmission.
Cisco IOS Interface and Hardware Component Command Reference
1581
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces fddi
show interfaces fddi
To display information about the FDDI interface, use the showinterfacesfddicommand in user EXEC or
privileged EXEC mode.
Standard Syntax
show interfaces fddi number [accounting]
Cisco 7000 and Cisco 7200 Series
show interfaces:fddi accounting optionshow interfaces fddi [slot/port] [accounting]
Cisco 7500 Series
show interfaces fddi [slot/port-adapter/port] [accounting]
Syntax Description number Port number on the selected interface.
accounting (Optional) Displays the number of packets of each protocol type that have been sent through
the interface.
slot (Optional) Slot number. Refer to the appropriate hardware manual for slot and port
information.
port (Optional) Port number. Refer to the appropriate hardware manual for slot and port
information.
port-adapter (Optional) Port adapter number. Refer to the appropriate hardware manual for information
about port adapter compatibility.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
10.0 This command was introduced.
11.3 This command was modified to include support for FDDI full-duplex, single- and multimode
port adapters (PA-F/FD-SM and PA-F/FD-MM).
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples The following is a sample partial display of FDDI-specific data from the showinterfacesfddi command
on a Cisco 7500 series router:
Router# show interfaces fddi 3/0/0
Fddi3/0/0 is up, line protocol is up
Hardware is cxBus Fddi, address is 0000.0c02.adf1 (bia 0000.0c02.adf1)
Internet address is 10.108.33.14, subnet mask is 255.255.255.0
Cisco IOS Interface and Hardware Component Command Reference
1582
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces fddi
MTU 4470 bytes, BW 100000 Kbit, DLY 100 usec, rely 255/255, load 1/255
Encapsulation SNAP, loopback not set, keepalive not set
ARP type: SNAP, ARP Timeout 4:00:00
Phy-A state is active, neighbor is B, cmt signal bits 008/20C, status ILS
Phy-B state is active, neighbor is A, cmt signal bits 20C/008, status ILS
ECM is in, CFM is thru, RMT is ring_op
Token rotation 5000 usec, ring operational 21:32:34
Upstream neighbor 0000.0c02.ba83, downstream neighbor 0000.0c02.ba83
Last input 0:00:05, output 0:00:00, output hang never
Last clearing of “show interface” counters 0:59:10
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 69000 bits/sec, 44 packets/sec
Five minute output rate 0 bits/sec, 1 packets/sec
113157 packets input, 21622582 bytes, 0 no buffer
Received 276 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
4740 packets output, 487346 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets, 0 restarts
0 transitions, 2 traces, 3 claims, 2 beacons
The following is sample output from the showinterfacesfddicommand for the full-duplex FDDI
port adapter on a Cisco 7500 series router:
Router# show interfaces fddi 0/1/0
Fddi0/1/0 is up, line protocol is up
Hardware is cxBus FDDI, address is 0060.3e33.3608 (bia 0060.3e33.3608)
Internet address is 10.1.1.1/24
MTU 4470 bytes, BW 100000 Kbit, DLY 100 usec, rely 255/255, load 1/255
Encapsulation SNAP, loopback not set, keepalive not set
ARP type: SNAP, ARP Timeout 04:00:00
FDX supported, FDX enabled, FDX state is operation
Phy-A state is maintenance, neighbor is Unknown, status HLS
Phy-B state is active, neighbor is A, status SILS
ECM is in, CFM is c_wrap_b, RMT is ring_op,
Requested token rotation 5000 usec, negotiated 4997 usec
Configured tvx is 2500 usec
LER for PortA = 0A, LER for PortB = 0A ring operational 00:02:45
Upstream neighbor 0060.3e73.4600, downstream neighbor 0060.3e73.4600
Last input 00:00:12, output 00:00:13, output hang never
Last clearing of “show interface” counters never
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
62 packets input, 6024 bytes, 0 no buffer
Received 18 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
71 packets output, 4961 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
3 transitions, 0 traces, 100 claims, 0 beacon
The table below describes thefields shown in the display.
Table 131: show interfaces fddi Field Descriptions
Field Description
Fddi is {up | down | Gives the interface processor unit number and tells whether the interface hardware is
administratively currently active and can transmit and receive or if it has been taken down by an
down administrator.
Cisco IOS Interface and Hardware Component Command Reference
1583
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces fddi
Field Description
line protocol is {up Indicates whether the software processes that handle the line protocol consider the
| down} interface usable.
Hardware Provides the hardware type, followed by the hardware address.
Internet address IP address, followed by subnet mask.
MTU Maximum transmission unit of the interface.
BW Bandwidth of the interface, in kilobits per second.
DLY Delay of the interface, in microseconds.
rely Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely saturated), calculated
as an exponential average over 5 minutes.
Encapsulation Encapsulation method assigned to interface.
loopback Indicates whether or not loopback is set.
keepalive Indicates whether or not keepalives are set.
ARP type Type of Address Resolution Protocol assigned.
FDX Displays full-duplex information. Values are: not supported or supported. When the
value is supported, the display indicates whether full-duplex is enabled or disabled.
When enabled, the state of the FDX negotiation process is displayed. The negotiation
states only relate to the full-duplex negotiation process. You must also ensure that the
interface is up and working by looking at other fields in the showinterfacesfddi
command such as line protocol and RMT. Negotiation states are:
• idle--Interface is working but not in full-duplex mode yet. If persistent, it could
mean that the interface did not meet all negotiation conditions (for example, there
are more than two stations in the ring).
• request--Interface is working but not in full-duplex mode yet. If persistent, it could
mean that the remote interface does not support full-duplex or full-duplex is not
enabled on the interface.
• confirm--Transient state.
• operation--Negotiations completed successfully, and both stations are operating
in full-duplex mode.
Phy-{A | B} Lists the state the Physical A or Physical B connection is in; one of the following: off,
active, trace, connect, next, signal, join, verify, or break.
Cisco IOS Interface and Hardware Component Command Reference
1584
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces fddi
Field Description
neighbor State of the neighbor:
• A--Indicates that the connection management (CMT) process has established a
connection with its neighbor. The bits received during the CMT signaling process
indicate that the neighbor is a Physical A type dual attachment station (DAS) or
concentrator that attaches to the primary ring IN and the secondary ring OUT
when attaching to the dual ring.
• S--Indicates that the CMT process has established a connection with its neighbor
and that the bits received during the CMT signaling process indicate that the
neighbor is one Physical type in a single attachment station (SAS).
• B--Indicates that the CMT process has established a connection with its neighbor
and that the bits received during the CMT signaling process indicate that the
neighbor is a Physical B dual attachment station or concentrator that attaches to
the secondary ring IN and the primary ring OUT when attaching to the dual ring.
• M--Indicates that the CMT process has established a connection with its neighbor
and that the bits received during the CMT signaling process indicate that the
router’s neighbor is a Physical M-type concentrator serving as a Master to a
connected station or concentrator.
• unk--Indicates that the network server has not completed the CMT process and,
as a result, does not know about its neighbor. See the section “Setting Bit Control”
for an explanation of the bit patterns.
cmt signal bits Shows the transmitted/received CMT bits. The transmitted bits are 0x008 for a Physical
A type and 0x20C for Physical B type. The number after the slash (/) is the received
signal bits. If the connection is not active, the received bits are zero (0); see the line
beginning Phy-B in the display. This applies to FIP interfaces only.
Cisco IOS Interface and Hardware Component Command Reference
1585
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces fddi
Field Description
status Status value displayed is the actual status on the fiber. The FDDI standard defines the
following values:
• LSU--Line State Unknown, the criteria for entering or remaining in any other line
state have not been met.
• NLS--Noise Line State is entered upon the occurrence of 16 potential noise events
without satisfying the criteria for entry into another line state.
• MLS--Master Line State is entered upon the receipt of eight or nine consecutive
HQ or QH symbol pairs.
• ILS--Idle Line State is entered upon receipt of four or five idle symbols.
• HLS--Halt Line State is entered upon the receipt of 16 or 17 consecutive H
symbols.
• QLS--Quiet Line State is entered upon the receipt of 16 or 17 consecutive Q
symbols or when carrier detect goes low.
• ALS--Active Line State is entered upon receipt of a JK symbol pair when carrier
detect is high.
• OVUF--Elasticity buffer Overflow/Underflow. The normal states for a connected
Physical type are ILS or ALS. If the report displays the QLS status, this indicates
that the fiber is disconnected from Physical B, or that it is not connected to another
Physical type, or that the other station is not running.
ECM is... ECM is the SMT entity coordination management, which overlooks the operation of
CFM and PCM. The ECM state can be one of the following:
• out--Router is isolated from the network.
• in--Router is actively connected to the network. This is the normal state for a
connected router.
• trace--Router is trying to localize a stuck beacon condition.
• leave--Router is allowing time for all the connections to break before leaving the
network.
• path_test--Router is testing its internal paths.
• insert--Router is allowing time for the optical bypass to insert.
• check--Router is making sure optical bypasses switched correctly.
• deinsert--Router is allowing time for the optical bypass to deinsert.
Cisco IOS Interface and Hardware Component Command Reference
1586
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces fddi
Field Description
CFM is... Contains information about the current state of the MAC connection. The Configuration
Management state can be one of the following:
• isolated--MAC is not attached to any Physical type.
• wrap_a--MAC is attached to Physical A. Data is received on Physical A and
transmitted on Physical A.
• wrap_b--MAC is attached to Physical B. Data is received on Physical B and
transmitted on Physical B.
• wrap_s--MAC is attached to Physical S. Data is received on Physical S and
transmitted on Physical S. This is the normal mode for a single attachment station
(SAS).
• thru--MAC is attached to Physical A and B. Data is received on Physical A and
transmitted on Physical B. This is the normal mode for a dual attachment station
(DAS) with one MAC. The ring has been operational for 1 minute and 42 seconds.
RMT is... RMT (Ring Management) is the SMT MAC-related state machine. The RMT state can
be one of the following:
• isolated--MAC is not trying to participate in the ring. This is the initial state.
• non_op--MAC is participating in ring recovery, and ring is not operational.
• ring_op--MAC is participating in an operational ring. This is the normal state
while the MAC is connected to the ring.
• detect--Ring has been nonoperational for longer than normal. Duplicate address
conditions are being checked.
• non_op_dup--Indications have been received that the address of the MAC is a
duplicate of another MAC on the ring. Ring is not operational.
• ring_op_dup--Indications have been received that the address of the MAC is a
duplicate of another MAC on the ring. Ring is operational in this state.
• directed--MAC is sending beacon frames notifying the ring of the stuck condition.
• trace--Trace has been initiated by this MAC, and the RMT state machine is waiting
for its completion before starting an internal path test.
token rotation Token rotation value is the default or configured rotation value as determined by the
fdditoken-rotation-time command. This value is used by all stations on the ring. The
default is 5000 microseconds. For FDDI full-duplex, this indicates the value in use
prior to entering full-duplex operation.
negotiated Actual (negotiated) target token rotation time.
ring operational When the ring is operational, the displayed value will be the negotiated token rotation
time of all stations on the ring. Operational times are displayed by the number of
hours:minutes:seconds the ring has been up. If the ring is not operational, the message
“ring not operational” is displayed.
Cisco IOS Interface and Hardware Component Command Reference
1587
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces fddi
Field Description
Configured tvx Transmission timer.
LER Link error rate.
Upstream | Displays the canonical MAC address of outgoing upstream and downstream neighbors.
downstream If the address is unknown, the value will be the FDDI unknown address (0x00 00 f8
neighbor 00 00 00).
Last input Number of hours, minutes, and seconds since the last packet was successfully received
by an interface and processed locally on the router. Useful for knowing when a dead
interface failed. This counter is updated only when packets are process-switched, not
when packets are fast-switched.
output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by an interface. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
output hang Number of hours, minutes, and seconds (or never) since the interface was last reset
because of a transmission that took too long. When the number of hours in any of the
“last” fields exceeds 24 hours, the number of days and hours is printed. If that field
overflows, asterisks are printed.
Last clearing Time at which the counters that measure cumulative statistics (such as number of bytes
transmitted and received) shown in this report were last reset to zero. Note that variables
that might affect routing (for example, load and reliability) are not cleared when the
counters are cleared.
*** indicates the elapsed time is too large to be displayed.
0:00:00 indicates the counters were cleared more than 231 ms (and less than 232 ms)
ago.
Queueing strategy First-in, first-out queueing strategy (other queueing strategies you might see are
priority-list, custom-list, and weighted fair).
Output queue, input Number of packets in output and input queues. Each number is followed by a slash,
queue, drops the maximum size of the queue, and the number of packets dropped because of a full
queue.
5 minute input rate Average number of bits and packets transmitted per second in the last 5 minutes.
5 minute output rate
The five-minute input and output rates should be used only as an approximation of
traffic per second during a given 5-minute period. These rates are exponentially
weighted averages with a time constant of 5 minutes. A period of four time constants
must pass before the average will be within two percent of the instantaneous rate of a
uniform stream of traffic over that period.
packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the error-free packets
received by the system.
Cisco IOS Interface and Hardware Component Command Reference
1588
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces fddi
Field Description
no buffer Number of received packets discarded because there was no buffer space in the main
system. Compare with ignored count. Broadcast storms on Ethernet networks and
bursts of noise on serial lines are often responsible for no input buffer events.
broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the media.
giants Number of packets that are discarded because they exceed the maximum packet size
of the medium.
CRC Cyclic redundancy checksum generated by the originating LAN station or far-end
device does not match the checksum calculated from the data received. On a LAN,
this usually indicates noise or transmission problems on the LAN interface or the LAN
bus itself. A high number of CRCs is usually the result of collisions or a station
transmitting bad data.
frame Number of packets received incorrectly that have a CRC error and a noninteger number
of octets. On a LAN, this is usually the result of collisions or a malfunctioning Ethernet
device. On an FDDI LAN, this also can be the result of a failing fiber (cracks) or a
hardware malfunction.
overrun Number of times the serial receiver hardware was unable to hand received data to a
hardware buffer because the input rate exceeded the receiver’s ability to handle the
data.
ignored Number of received packets ignored by the interface because the interface hardware
ran low on internal buffers. These buffers are different from the system buffers
mentioned previously in the buffer description. Broadcast storms and bursts of noise
can cause the ignored count to be increased.
packets output Total number of messages transmitted by the system.
bytes Total number of bytes, including data and MAC encapsulation, transmitted by the
system.
underruns Number of transmit aborts (when the router cannot feed the transmitter fast enough).
output errors Sum of all errors that prevented the final transmission of datagrams out of the interface
being examined. Note that this might not balance with the sum of the enumerated
output errors, because some datagrams can have more than one error, and others can
have errors that do not fall into any of the specifically tabulated categories.
collisions Because an FDDI ring cannot have collisions, this statistic is always zero.
interface resets Number of times an interface has been reset. The interface may be reset by the
administrator or automatically when an internal error occurs.
restarts Should always be zero for FDDI interfaces.
Cisco IOS Interface and Hardware Component Command Reference
1589
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces fddi
Field Description
output buffer Number of no resource errors received on the output.
failures
output buffers Number of packets swapped to DRAM.
swapped out
transitions The number of times the ring made a transition from ring operational to ring
nonoperational, or vice versa. A large number of transitions indicates a problem with
the ring or the interface.
traces Trace count applies to both the FCI, FCIT, and FIP. Indicates the number of times this
interface started a trace.
claims Pertains to FCIT and FIP only. Indicates the number of times this interface has been
in claim state.
beacons Pertains to FCIT and FIP only. Indicates the number of times the interface has been
in beacon state.
The following is sample output that includes the accounting option. When you use the accounting
option, only the accounting statistics are displayed.
Router# show interfaces fddi 3/0 accounting
Fddi3/0
Protocol Pkts In Chars In Pkts Out Chars Out
IP 7344 4787842 1803 1535774
Appletalk 33345 4797459 12781 1089695
DEC MOP 0 0 127 9779
ARP 7 420 39 2340
The table below describes thefields shown in the display.
Table 132: show interfaces fddi Field Descriptions--Accounting
Field Description
Protocol Protocol that is operating on the interface.
Pkts In Number of packets received for that protocol.
Chars In Number of characters received for that protocol.
Pkts Out Number of packets transmitted for that protocol.
Chars Out Number of characters transmitted for that protocol.
Cisco IOS Interface and Hardware Component Command Reference
1590
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces flowcontrol
show interfaces flowcontrol
To display flow-control information, use the showinterfacesflowcontrol command in user EXEC or privileged
EXEC mode.
show interfaces [interface [mod]] flowcontrol [{module number|vlan vlan}]
Syntax Description interface (Optional) Interface type; possible valid values are ethernet,
fastethernet, gigabitethernet, tengigabitethernet, port-channel,
vlan , pos, atm, and ge-wan
Note The show interfaces vlan vlan flowcontrol command
displays the interface VLAN information.
mod (Optional) Module and port number.
module number (Optional) Specifies the module number; see the “Usage Guidelines”
section for valid values.
vlan (Optional) Limits the display of switch port information to the
specified VLAN. Range: 1 to 4094
Note The show interfaces
flowcontrol vlan vlan
command limits the display
to interfaces on the
specified VLAN.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SXI This command was changed to add the optional vlanvlan keyword and argument.
Usage Guidelines The pos, atm, and ge-wan keywords are supported on systems that are configured with a Supervisor Engine
2
The modargument designates the module and port number. Valid values for mod depend on the chassis and
module that are used. For example, if you have a 48-port 10/100BASE-T Ethernet module that is installed in
a 13-slot chassis, valid values for the slot number are from 1 to 13 and valid values for the port number are
from 1 to 48.
Cisco IOS Interface and Hardware Component Command Reference
1591
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces flowcontrol
The modulenumber keyword and argument designate the module number and limit the display to interfaces
on the module. Valid values depend on the chassis that is used. For example, if you have a 13-slot chassis,
valid values for the module number are from 1 to 13.
The port-channel values are from 0 to 282; values from 257 to 282 are supported on the CSM and the FWSM
only.
Cisco IOS Release 12.2(33)SXI and later releases allow you to limit the display of switch port information
to the specified VLAN.
Examples This example shows how to display flow-control information for all interfaces:
Router> show interfaces flowcontrol
Port Send FlowControl Receive FlowControl RxPause TxPause
admin oper admin oper
----- -------- -------- -------- -------- ------- -------
Gi1/1 desired off off off 0 0
Gi1/2 desired off off off 0 0
Gi3/1 on on on on 0 0
.
.
.
Gi8/2 desired off off off 0 0
Gi8/3 desired off off off 0 0
Gi8/4 desired off off off 0 0
Router>
This example shows how to display flow-control information for a specific interface:
Router> show interfaces gigabitethernet 8/2 flowcontrol
Port Send FlowControl Receive FlowControl RxPause TxPause
admin oper admin oper
----- -------- -------- -------- -------- ------- -------
Gi8/2 desired off off off 0 0
Router>
This example shows how to limit the display flow-control information for interfaces on a specific
VLAN:
Router> show interfaces flowcontrol vlan 22
Router>
The table below describes the fields that are shown in the example.
Table 133: show port flowcontrol Command Output Fields
Field Description
Port Interface type and module and port number.
Send admin Flow-control operation for admin state. Possible settings: on indicates that the local port is
allowed to send pause frames to remote ports; off indicates that the local port is prevented
from sending pause frames to remote ports; desired indicates predictable results whether a
remote port is set to receiveon, receiveoff, or receivedesired.
Cisco IOS Interface and Hardware Component Command Reference
1592
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces flowcontrol
Field Description
Send oper Current flow-control operation. Possible settings: on indicates that the local port is allowed
to send pause frames to remote ports; off indicates that the local port is prevented from
sending pause frames to remote ports; desired indicates predictable results whether a remote
port is set to receiveon, receiveoff, or receivedesired.
Receive admin Flow-control operation for admin state. Possible settings: on indicates that the local port is
allowed to process pause frames that a remote port sends; off indicates that the local port is
prevented from sending pause frames to remote ports; desired indicates predictable results
whether a remote port is set to sendon, sendoff, or senddesired.
Receive oper Current flow-control operation. Possible settings: on indicates that the local port is allowed
to process pause frames that a remote port sends; off indicates that the local port is prevented
from sending pause frames to remote ports; desired indicates predictable results whether a
remote port is set to sendon, sendoff, or senddesired.
RxPause Number of pause frames that are received.
TxPause Number of pause frames that are transmitted.
Related Commands Command Description
flowcontrol Configures a port to send or receive pause frames.
Cisco IOS Interface and Hardware Component Command Reference
1593
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces gigabitethernet
show interfaces gigabitethernet
To check the status of and configuration settings on a router that supports Gigabit Ethernet Shared Port
Adapters (SPA), use the show interfaces gigabitethernet command in the privileged EXEC mode.
Cisco 7200 Series Router
show interfaces gigabitethernet slot/port
Cisco ASR 1000 Series Aggregation Services Router
show interfaces gigabitethernet slot/subslot/port
Syntax Description slot Chassis slot number. (Refer to the appropriate hardware manual for slot information. For SPA
Interface Processors (SIPs), refer to the platform-specific SPA hardware installation guide or the
platform-specific SPA software configuration guide.)
subslot Secondary slot number on a SIP in which a SPA is installed. ( Refer to the platform-specific SPA
hardware installation guide or the platform-specific SPA software configuration guide for subslot
information.)
port Port number or interface number. (Refer to the appropriate hardware manual for port information.
For SPAs, refer to the platform-specific SPA software configuration guide.)
Command Modes Privileged EXEC (#)
Command History Release Modification
11.1CC This command was introduced.
12.1(3A)E The command was modified to support Cisco 7200-I/O-GE+E Controller.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.
12.2(14)S This command was integrated into Cisco IOS Release 12.2(14)S.
12.2(20)S2 This command was integrated into Cisco IOS Release 12.2(20)S2. It was modified
to include a new address format and output for the interfaces on the 2-port
10/100/1000 Gigabit Ethernet SPA on the Cisco 7304 Routers. The subslot
argument was also added.
12.0(31)S This command was integrated into Cisco IOS Release 12.0(31)S to support the
Gigabit Ethernet SPAs on the Cisco 12000 Series Routers.
12.2(18)SXF This command was integrated into Cisco IOS Release 12.2(18)SXF to support
the Gigabit Ethernet SPAs on the Cisco 7600 Series Routers and the Cisco Catalyst
6500 Series Switches.
Cisco IOS XE Release 2.1 This command was implemented on the Cisco ASR 1000 Series Aggregation
Services Routers.
Cisco IOS Interface and Hardware Component Command Reference
1594
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces gigabitethernet
Usage Guidelines This command is used in Cisco 7200-I/O-GE+E Controller and the Cisco ASR 1000 Series Aggregation
Services Routers to display the configuration status of a Gigabit Ethernet interface.
Note On Cisco 7200-I/O-GE+E Controller, slot 0 is always reserved for the Gigabit Ethernet port on the I/O
controller.
Cisco 7200-I/O-GE+E Controller Example
The following is sample output from the show interfaces gigabitethernet command:
Router# show interfaces gigabitethernet 5/1
GigabitEthernet5/1 is up, line protocol is up
Hardware is C6k 1000Mb 802.3, address is 0015.c620.b580 (bia 0015.c620.b580)
MTU 1500 bytes, BW 1000000 Kbit, DLY 10 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive set (10 sec)
Full-duplex, 1000Mb/s
input flow-control is off, output flow-control is off
Clock mode is auto
ARP type: ARPA, ARP Timeout 04:00:00
Last input never, output never, output hang never
Last clearing of "show interface" counters never
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue: 0/40 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts (0 IP multicasts)
0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 watchdog, 0 multicast, 0 pause input
0 input packets with dribble condition detected
0 packets output, 0 bytes, 0 underruns
0 output errors, 0 collisions, 1 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier, 0 pause output
0 output buffer failures, 0 output buffers swapped out
Cisco ASR 1000 Series Aggregation Services Router Example
The following is sample output from the show interfaces gigabitethernet command:
Router# show interface gigabitethernet 0/0/0
GigabitEthernet0/0/0 is up, line protocol is up
Hardware is SPA-2X1GE-V2, address is 001f.6c25.c400 (bia 001f.6c25.c400)
Description: Connected to CE28_C2811 GE 0/0/0
Internet address is 192.168.128.43/24
MTU 2000 bytes, BW 1000000 Kbit/sec, DLY 10 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive not supported
Full Duplex, 1000Mbps, link type is auto, media type is SX
output flow-control is on, input flow-control is on
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:00:46, output 00:09:07, output hang never
Cisco IOS Interface and Hardware Component Command Reference
1595
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces gigabitethernet
Last clearing of "show interface" counters never
Input queue: 0/375/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue: 0/40 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
673295 packets input, 70811204 bytes, 0 no buffer
Received 1 broadcasts (0 IP multicasts)
0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 watchdog, 104296 multicast, 0 pause input
1310016 packets output, 99574303 bytes, 0 underruns
0 output errors, 0 collisions, 2 interface resets
0 unknown protocol drops
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier, 0 pause output
0 output buffer failures, 0 output buffers swapped out
Gigabit Ethernet SPA Example
The following is sample output from the show interfaces gigabitethernet command for the first
interface port 0 in a 2-port 10/100/1000 Gigabit Ethernet SPA located in the top subslot 0 of the
MSC that is installed in slot 4 on a Cisco 7304 Router:
Router# show interfaces gigabitethernet 4/0/0
GigabitEthernet4/0/0 is up, line protocol is down
Hardware is SPA-2GE-7304, address is 00b0.64ff.5a80 (bia 00b0.64ff.5a80)
MTU 1500 bytes, BW 1000000 Kbit, DLY 10 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive set (10 sec)
Half-duplex, 1000Mb/s, link type is auto, media type is RJ45
output flow-control is unsupported, input flow-control is unsupported
ARP type: ARPA, ARP Timeout 04:00:00
Last input never, output 00:00:09, output hang never
Last clearing of "show interface" counters never
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue: 0/40 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts (0 IP multicast)
0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 watchdog, 0 multicast, 0 pause input
109 packets output, 6540 bytes, 0 underruns
0 output errors, 0 collisions, 2 interface resets
0 babbles, 0 late collision, 0 deferred
1 lost carrier, 0 no carrier, 0 PAUSE output
0 output buffer failures, 0 output buffers swapped out
Note There will be variations in the output of the show interfaces command, depending on the platform,
type of interface, and other features that you might have configured, such as Quality of Service (QoS).
Therefore, some additional output fields might appear in your show interfaces command output.
For more information about these fields, see the show interfaces command description in the Cisco
IOS Interface and Hardware Component Command Reference document at: http://www.cisco.com/
en/US/docs/ios-xml/ios/interface/command/ir-s4.html#wp2987586133
Cisco IOS Interface and Hardware Component Command Reference
1596
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces gigabitethernet
The following table describes the significant fields shown in the displays:
Table 134: show interfaces gigabitethernet Field Descriptions
Field Description
GigabitEthernet...is up Indicates whether the interface hardware is currently active or if it has been taken
...is administratively down by an administrator.
down
line protocol is Indicates whether the software processes that handle the line protocol consider
the line usable, or if it has been taken down by an administrator.
Hardware Hardware type, for example, SPA-2GE-7304, and MAC address.
Description Alphanumeric string identifying the interface. It is displayed only if the description
interface configuration command has been configured on the interface.
Internet address Internet address followed by the subnet mask.
MTU Maximum transmission unit of the interface. The default is 1500 bytes for the
2-port 10/100/1000 Gigabit Ethernet SPA.
BW Bandwidth of the interface, in kilobits, per second.
DLY Delay in the interface, in microseconds.
reliability Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
txload, rxload Load on the interface (in the transmit “tx” and receive “rx” directions) as a fraction
of 255 (255/255 is completely saturated), calculated as an exponential average
over 5 minutes.
Encapsulation Encapsulation method assigned to the interface.
loopback Indicates whether or not loopback is set.
Keepalive Indicates whether or not keepalives are set, and the time interval.
Half-duplex, Full-duplex Indicates the duplex mode of the interface.
1000Mb/s, 100Mb/s, Speed of the interface, in megabits, per second.
10Mb/s
link type Specifies whether or not auto negotiation is being used on the link.
media type Interface port media type: RJ45, SX, LX, or ZX.
ARP type Type of Address Resolution Protocol (ARP) assigned, and the timeout period.
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by the interface and processed locally on a router. Useful for knowing
when a dead interface failed.
This field is not updated by fast-switched traffic.
Cisco IOS Interface and Hardware Component Command Reference
1597
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces gigabitethernet
Field Description
output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by the interface. Useful for knowing when a dead interface failed.
output hang Number of hours, minutes, and seconds (or never) since the interface was last
reset because of a transmission that took too long. When the number of hours in
any of the “last” fields exceeds 24 hours, the number of days and hours is
displayed. If that field overflows, asterisks are displayed.
Note This field does not apply to the SPA interfaces.
Last clearing Time at which the counters that measure cumulative statistics (such as number of
bytes transmitted and received) shown in the report were last reset to zero. Note
that variables that might affect routing (for example, load and reliability) are not
cleared when the counters are cleared.
A series of asterisks (***) indicates that the elapsed time is too large to be
displayed.
0:00:00 indicates that the counters were cleared more than 231 ms (and less than
232 ms) ago.
Input queue Packet statistics on the input queue are reported as:
(size/max/drops/flushes)
• Size—Number of packets in the input queue.
• Max—Maximum size of the queue.
• Drops—Number of packets dropped because of a full input queue.
• Flushes—Number of packets dropped as part of selective packet discard
(SPD). SPD implements a selective packet drop policy on a router’s IP process
queue. Therefore, it only applies to process-switched traffic.
Total output drops Total number of packets dropped because of a full output queue.
Queueing strategy Type of Layer 3 queueing active on this interface. The default is first-in, first-out
(FIFO).
Output queue (size/max) Number of packets in the output queue (size), and the maximum size of the queue
(max).
5 minute input rate, 5 Average number of bits and packets transmitted per second in the last 5 minutes.
minute output rate If the interface is not in the promiscuous mode, it senses the network traffic it
sends and receives (rather than all the network traffic).
The 5-minute input and output rates should be used only as an approximation of
traffic per second during a given 5-minute period. These rates are exponentially
weighted averages with a time constant of 5 minutes. A period of four time
constants must pass before the average can be within two percent of the
instantaneous rate of a uniform stream of traffic over that period.
packets input Total number of error-free packets received by the system.
Cisco IOS Interface and Hardware Component Command Reference
1598
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces gigabitethernet
Field Description
bytes Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
Received...broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the medium. For instance, any Ethernet packet that is smaller than
64 bytes is considered a runt.
giants Number of packets that are discarded because they exceed the maximum packet
size of the medium. For example, any Ethernet packet that is larger than 1536
bytes is considered a giant.
Note In the 2-port 10/100/1000 Gigabit Ethernet SPA, the default is that a
giant is any packet greater than 1536 bytes. However, if you modify
the maximum transmission unit (MTU) for the interface, this counter
increments when you exceed the specified MTU for the interface.
throttles Number of times the receiver on the port was disabled, possibly because of buffer
or processor overload.
input errors Includes runts, giants, no buffer, cyclic redundancy check (CRC), frame, overrun,
oversubscription counters, and ignored counts. Other input-related errors can also
cause the input errors count to be increased, and some datagrams may have more
than one error. Therefore, this sum may not balance with the sum of enumerated
input error counts.
Note The oversubscription counters are included only on the Cisco ASR
1000 Series Aggregation Services Routers.
CRC Cyclic redundancy check generated by the originating LAN station or far-end
device does not match the checksum calculated from the data received. On a LAN,
this usually indicates noise or transmission problems on the LAN interface or the
LAN bus itself. A high number of CRCs is usually the result of collisions or a
station transmitting bad data.
frame Number of packets received incorrectly having a CRC error and a noninteger
number of octets. On a LAN, this is usually the result of collisions or a
malfunctioning Ethernet device.
overrun Number of times the receiver hardware was unable to hand the received data to
a hardware buffer because the input rate exceeded the receiver’s ability to handle
the data. The overrun also includes the interface oversubscription counters.
Note The interface oversubscription counters are included only on the Cisco
ASR 1000 Series Aggregation Services Routers.
ignored Number of received packets ignored by the interface because the interface hardware
is running low on internal buffers. These buffers are different from the system
buffers. Broadcast storms and bursts of noise may cause the ignored count to be
increased.
Cisco IOS Interface and Hardware Component Command Reference
1599
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces gigabitethernet
Field Description
watchdog Number of times the watchdog receive timer expires. Expiration occurs when
receiving a packet with a length that is greater than 2048 bytes.
input packets with Dribble bit error indicates that a frame is slightly longer than usual. This frame
dribble condition error counter is incremented for informational purposes only; the router accepts
detected the frame.
packets output Total number of messages transmitted by the system.
bytes Total number of bytes, including data and MAC encapsulation, transmitted by
the system.
underruns Number of times the transmitter has been running faster than the speed a router
can handle.
output errors Sum of all the errors that prevented the final transmission of datagrams out of the
interface being examined. Note that this may not balance with the sum of the
enumerated output errors because some datagrams may have more than one error
and others may have errors that do not fall into any of the specifically tabulated
categories.
collisions Number of messages retransmitted because of an Ethernet collision. This is usually
the result of an overextended LAN, for example, an Ethernet or transceiver cable
that is too long, more than two repeaters between stations, or too many cascaded
multiport transceivers. A packet that collides is counted only once in output
packets.
interface resets Number of times an interface is completely reset. This may occur if packets that
are queued for transmission were not sent within several seconds. Interface resets
may occur when an interface is looped back or shut down.
babbles Transmit jabber timer expired.
late collision Number of late collisions. Late collision occurs when a collision takes place after
the preamble is transmitted.
deferred Number of times the interface had to defer while ready to transmit a frame because
the carrier was asserted.
lost carrier Number of times the carrier was lost during transmission.
no carrier Number of times the carrier was not present during the transmission.
Note This field does not apply to SPA interfaces.
output buffer failures, These counters are not used by the 2-port 10/100/1000 Gigabit Ethernet SPA on
output buffers swapped the Cisco 7304 Routers.
out
Cisco IOS Interface and Hardware Component Command Reference
1600
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces gigabitethernet
Related Commands Command Description
show controllers gigabitethernet Displays Gigabit Ethernet interface information, transmission statistics
and errors, and applicable MAC destination address and VLAN
filtering tables.
show interfaces Displays the statistics for the interfaces configured on a router, switch,
or access server.
Cisco IOS Interface and Hardware Component Command Reference
1601
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces hssi
show interfaces hssi
To display information about the high-speed serial interface (HSSI), use the showinterfaceshssicommand in
privileged EXEC mode.
Standard Syntax
show interfaces hssi number [accounting]
Cisco 7500 Series
show interfaces hssi [slot/port] [accounting]
Syntax Description number Port number on the selected interface.
accounting (Optional) Displays the number of packets of each protocol type that have been sent through
the interface.
slot (Optional) Slot number. Refer to the appropriate hardware manual for slot and port information.
port (Optional) Port number. Refer to the appropriate hardware manual for slot and port information.
Command Modes Privileged EXEC
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples The following is sample output from the showinterfaceshssi command when HSSI is enabled:
Router# show interfaces hssi 0
HSSI 0 is up, line protocol is up
Hardware is cBus HSSI
Internet address is 10.136.67.190, subnet mask is 255.255.255.0
MTU 4470 bytes, BW 45045 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation HDLC, loopback not set, keepalive set (10 sec)
Last input 0:00:03, output 0:00:00, output hang never
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 0 bits/sec, 0 packets/sec
Five minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
0 parity, 0 rx disabled
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
17 packets output, 994 bytes, 0 underruns
0 output errors, 0 applique, 4 interface resets, 0 restarts
2 carrier transitions
The table below describes significant fields shown in the display.
Cisco IOS Interface and Hardware Component Command Reference
1602
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces hssi
Table 135: show interfaces hssi Field Descriptions
Field Description
HSSI is {up | down | Indicates whether the interface hardware is currently active (whether carrier detect
administratively down} is present) and whether it has been taken down by an administrator. “Disabled”
indicate that the router has received over 5000 errors in a keepalive interval, which
is 10 seconds by default.
line protocol is {up | Indicates whether the software processes that handle the line protocol consider the
down | administratively line usable (that is, whether keepalives are successful).
down}
Hardware Specifies the hardware type.
Internet address Lists the Internet address followed by subnet mask.
MTU Maximum transmission unit of the interface.
BW Bandwidth of the interface, in kilobits per second.
DLY Delay of the interface, in microseconds.
rely Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes.
Encapsulation Encapsulation method assigned to interface.
loopback Indicates whether loopback is set and type of loopback test.
keepalive Indicates whether keepalives are set or not.
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by an interface and processed locally on the router. Useful for knowing
when a dead interface failed. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
Last output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by an interface. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
output hang Number of hours, minutes, and seconds (or never) since the interface was last reset
because of a transmission that took too long. When the number of hours in any of
the “last” fields exceeds 24 hours, the number of days and hours is printed. If that
field overflows, asterisks are printed.
Cisco IOS Interface and Hardware Component Command Reference
1603
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces hssi
Field Description
Last clearing Time at which the counters that measure cumulative statistics (such as number of
bytes transmitted and received) shown in this report were last reset to zero. Note
that variables that might affect routing (for example, load and reliability) are not
cleared when the counters are cleared.
*** indicates the elapsed time is too large to be displayed.
0:00:00 indicates the counters were cleared more than 231 ms (and less than 232
ms) ago.
Output queue, drops Number of packets in output and input queues. Each number is followed by a slash,
Input queue, drops the maximum size of the queue, and the number of packets dropped because of a
full queue.
Five minute input rate, Average number of bits and packets transmitted per second in the last 5 minutes.
Five minute output rate
packets input Total number of error-free packets received by the system.
bytes input Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the
main system. Compare with ignored count. Broadcast storms on Ethernet networks
and bursts of noise on serial lines are often responsible for no input buffer events.
broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the medium.
giants Number of packets that are discarded because they exceed the maximum packet
size of the medium.
parity Report of the parity errors on the HSSI.
rx disabled Indicates that the HSSI could not find a free buffer on the ciscoBus controller to
reserve for use for the HSSI receiver. When this happens, the HSSI shuts down its
receiver and waits until a buffer is available. Data is not lost unless a packet comes
in and overflows the HSSI FIFO. Usually, the receive disables are frequent but do
not last for long, and the number of dropped packets is less than the count in the
“rx disabled” field. A receive disabled condition can happen in systems that are
under heavy traffic load and that have shorter packets. In this situation, the number
of buffers available on the ciscoBus controller is at a premium. One way to alleviate
this problem is to reduce the maximum transmission unit (MTU) on the HSSI
interface from 4500 (FDDI size) to 1500 (Ethernet size). Doing so allows the
software to take the fixed memory of the ciscoBus controller and divide it into a
larger number of smaller buffers, rather than a small number of large buffers. Receive
disables are not errors, so they are not included in any error counts.
Cisco IOS Interface and Hardware Component Command Reference
1604
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces hssi
Field Description
input errors Sum of all errors that prevented the receipt of datagrams on the interface being
examined. This may not balance with the sum of the enumerated output errors,
because some datagrams may have more than one error and others may have errors
that do not fall into any of the specifically tabulated categories.
CRC Cyclic redundancy checksum (CRC) generated by the originating LAN station or
far-end device does not match the checksum calculated from the data received. On
a LAN, this usually indicates noise or transmission problems on the LAN interface
or the LAN bus itself. A high number of CRCs is usually the result of collisions or
a station transmitting bad data. On a serial link CRCs usually indicate noise, gain
hits, or other transmission problems on the data link. CRC errors are also reported
when a far-end abort occurs, and when the idle flag pattern is corrupted. This makes
it possible to get CRC errors even when there is no data traffic.
frame Number of packets received incorrectly having a CRC error and a noninteger number
of octets. On a serial line, this is usually the result of noise or other transmission
problems.
overrun Number of times the serial receiver hardware was unable to hand received data to
a hardware buffer because the input rate exceeded the ability of the receiver to
handle the data.
ignored Number of received packets ignored by the interface because the interface hardware
ran low on internal buffers. These buffers are different than the system buffers
mentioned previously in the buffer description. Broadcast storms and bursts of noise
can cause the ignored count to be increased.
abort Number of packets whose receipt was aborted.
packets output Total number of messages transmitted by the system.
bytes output Total number of bytes, including data and MAC encapsulation, transmitted by the
system.
underruns Number of times that the far-end transmitter has been running faster than the near-end
router receiver can handle.
congestion drop Number of messages discarded because the output queue on an interface grew too
long. This can happen on a slow, congested serial link.
output errors Sum of all errors that prevented the final transmission of datagrams out of the
interface being examined. Note that this may not balance with the sum of the
enumerated output errors, because some datagrams may have more than one error,
and others may have errors that do not fall into any of the specifically tabulated
categories.
applique Indicates that an unrecoverable error has occurred on the High-System Availability
(HSA) applique. The system then invokes an interface reset.
Cisco IOS Interface and Hardware Component Command Reference
1605
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces hssi
Field Description
interface resets Number of times that an interface has been completely reset. This can happen if
packets queued for transmission were not sent within several seconds time. On a
serial line, this can be caused by a malfunctioning modem that is not supplying the
transmit clock signal or by a cable problem. If the system notices that the carrier
detect line of a serial interface is up, but the line protocol is down, it periodically
resets the interface in an effort to restart it. Interface resets can also occur when an
interface is looped back or shut down.
restarts Number of times that the controller was restarted because of errors.
carrier transitions Number of times that the carrier detect signal of the interface has changed state.
Indicates modem or line problems if the carrier detect line is changing state often.
The following is sample output from the showinterfaceshssi command on a Cisco 7500 series router:
Router# show interfaces hssi 1/0
Hssi1/0 is up, line protocol is up
Hardware is cxBus HSSI
Internet address is 10.108.38.14, subnet mask is 255.255.255.0
MTU 1500 bytes, BW 45045 Kbit, DLY 1000000 usec, rely 255/255, load 1/255
Encapsulation HDLC, loopback not set, keepalive set (10 sec)
Last input 0:00:00, output 0:00:08, output hang never
Last clearing of "show interface" counters never
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 1000 bits/sec, 2 packets/sec
Five minute output rate 0 bits/sec, 0 packets/sec
630573548 packets input, 2077237628 bytes, 0 no buffer
Received 2832063 broadcasts, 0 runts, 0 giants
0 parity, 1970 rx disabled
113 input errors, 20 CRC, 93 frame, 0 overrun, 0 ignored, 0 abort
629721628 packets output, 1934313295 bytes, 0 underruns
0 output errors, 0 applique, 62 interface resets, 0 restarts
309 carrier transitions
The following is sample output from the showinterfaceshssi command with the accounting option
on a Cisco 7500 series router:
Router# show interfaces hssi 1/0 accounting
HIP1/0
Protocol Pkts In Chars In Pkts Out Chars Out
IP 7344 4787842 1803 1535774
Appletalk 33345 4797459 12781 1089695
DEC MOP 0 0 127 9779
ARP 7 420 39 2340
The table below describes thefields shown in the display.
Table 136: show interfaces hssi Field Descriptions--Accounting
Field Description
Protocol Protocol that is operating on the interface.
Pkts In Number of packets received for that protocol.
Chars In Number of characters received for that protocol.
Cisco IOS Interface and Hardware Component Command Reference
1606
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces hssi
Field Description
Pkts Out Number of packets transmitted for that protocol.
Chars Out Number of characters transmitted for that protocol.
Cisco IOS Interface and Hardware Component Command Reference
1607
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces integrated-service-engine
show interfaces integrated-service-engine
To show the Cisco wireless LAN controller network module (WLCM) interfaces on the router, use the
showinterfacesintegrated-service-engine command in privileged EXEC mode.
show interfaces integrated-service-engine slot/unit
{aaa|accounting|counters|crb|dampening|description|etherchannel|irb|mac-accounting|mpls-exp|precedence|pruning|rate-limit|stats|status|summary|switching|switchport|trunk}
Syntax Description slot/unit Specifies the router slot and unit numbers.
aaa Shows the dot11 aaa information.
accounting Shows the interface accounting information.
counters Shows the interface counters.
crb Shows the interface routing and bridging information.
dampening Shows the interface dampening information.
description Shows the interface description.
etherchannel Shows the interface Ethernet channel information.
irb Shows the interface routing and bridging information.
mac-accounting Shows the interface MAC accounting information.
mpls-exp Shows the interface MPLS experimental accounting information.
precedence Shows the interface precedence accounting information.
pruning Shows the interface trunk VTP pruning information.
rate-limit Shows the interface rate-limit information.
stats Shows the interface in and out packets and octets by switching path.
status Shows the interface line status.
summary Shows the interface summary.
switching Shows the interface switching.
switchport Shows the interface switchport information.
trunk Shows the interface trunk information.
Command Default None
Command Modes Privileged EXEC
Cisco IOS Interface and Hardware Component Command Reference
1608
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces integrated-service-engine
Command History Release Modification
12.4(15)T This command was introduced.
Examples The following example shows how to read the interface information about the WLCM in the router:
Router# show interfaces integrated-service-engine
1/0
integrated-service-engine 1/0 is up, line protocol is up
Hardware is I82559FE, address is 0005.9a3d.7450 (bia 0005.9a3d.7450)
Internet address is 30.0.0.1/24
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation 802.1Q Virtual LAN, Vlan ID 1., loopback not set
Keepalive set (10 sec)
Full-duplex, 100Mb/s, 100BaseTX/FX
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:00:05, output 00:00:03, output hang never
Last clearing of "show interface" counters never
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue: 0/40 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
2400779 packets input, 143127299 bytes
Received 2349587 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 watchdog
0 input packets with dribble condition detected
468232 packets output, 106333102 bytes, 0 underruns
0 output errors, 0 collisions, 3 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 1 no carrier
0 output buffer failures, 0 output buffers swapped out
Related Commands interface integrated-service-engine
Cisco IOS Interface and Hardware Component Command Reference
1609
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces ism
show interfaces ism
To display status, traffic data, and configuration information about the internal service module (ISM) interface,
use the showinterfacesism command in user EXEC or privileged EXEC mode.
show interfaces ism slot/port
Syntax Description slot Router slot in which the service module is installed. For internal service modules, always use 0.
/ port Port number of the module interface. The slash mark (/) is required.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines The ISM interface is the Gigabit Ethernet interface on the router that connects to the ISM.
Examples The following example displays status, traffic data, and configuration information about the interface
to the ISM installed in the router.
Router# show interfaces ism 0/0
ISM0/0 is up, line protocol is up
Hardware is PSE2, address is 001e.4a97.646d (bia 001e.4a97.646d)
Internet address is 20.0.0.1/24
MTU 1500 bytes, BW 1000000 Kbit/sec, DLY 10 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive set (10 sec)
Full-duplex, 1000Mb/s, media type is internal
output flow-control is XON, input flow-control is XON
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:00:11, output 00:00:11, output hang never
Last clearing of "show interface" counters never
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue: 0/60 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
329 packets input, 34641 bytes, 0 no buffer
Received 109 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 watchdog, 0 multicast, 0 pause input
0 input packets with dribble condition detected
241 packets output, 79646 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 unknown protocol drops
0 unknown protocol drops
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier, 0 pause output
0 output buffer failures, 0 output buffers swapped out
Cisco IOS Interface and Hardware Component Command Reference
1610
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces ism
The table below describes the significant fields shown in the display.
Table 137: show interfaces ism Field Descriptions
Field Description
Hardware, address Hardware type and address.
MTU Maximum transmission unit (MTU) of the service module interface.
BW Bandwidth of the interface, in kbps.
DLY Delay of the interface, in microseconds.
reliability Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
txload Transmit load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes.
rxload Receive load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes.
Encapsulation Encapsulation method assigned to the interface.
loopback Indicates whether or not loopback is set.
Keepalive Indicates whether or not keepalives are set and the interval between keepalives if
they have been set.
ARP type...ARP Type of Address Resolution Protocol (ARP) assigned and length of timeout.
Timeout
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by the interface and processed locally on the router. This field is useful
for detecting when a dead interface failed.
Note This field is not updated by fast-switched traffic.
output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by the interface. This field is useful for detecting when a dead interface
failed.
output hang Number of hours, minutes, and seconds (or never) since the interface was last reset
because a transmission took too long. When the number of hours in any of the “last”
fields exceeds 24 hours, the number of days and hours is printed. If that field
overflows, asterisks are printed.
Last clearing Time at which the counters that measure cumulative statistics (such as number of
bytes transmitted and received) shown in this report were last reset to zero. Note
that variables that might affect routing (for example, load and reliability) are not
cleared when the counters are cleared.
Asterisks (***) indicate that the elapsed time is too large to be displayed.
Cisco IOS Interface and Hardware Component Command Reference
1611
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces ism
Field Description
Input queue Number of packets in the input queue. Each number is followed by a slash, the
maximum size of the queue, the number of packets dropped because of a full queue,
and the number of times that queued packets have been discarded.
Total output drops Number of packets in the output queue that have been dropped because of a full
queue.
Queueing strategy Queueing strategy applied to the interface, which is configurable under the interface.
The default is FIFO (first-in, first-out).
Output queue Number of packets in the output queue, and the maximum size of the queue. Each
number is followed by a slash.
5 minute input rate, 5 Average number of bits and packets transmitted per second in the last 5 minutes.
minute output rate If the interface is not in promiscuous mode, it senses network traffic that it sends
and receives (rather than all network traffic).
The 5-minute input and output rates should be used only as an approximation of
traffic per second during a given 5-minute period. These rates are exponentially
weighted averages with a time constant of 5 minutes. A period of four time constants
must pass before the average will be within 2 percent of the instantaneous rate of
a uniform stream of traffic over that period.
Note The 5-minute period referenced in this output is a load interval that is
configurable under the interface. The default value is 5 minutes.
packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the
main system. Compare with ignored count. Broadcast storms on Ethernets and
bursts of noise on serial lines are often responsible for no input buffer events.
Received...broadcasts Number of broadcasts received.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the medium. For instance, any Ethernet packet that is less than 64
bytes is considered a runt.
giants Number of packets that are discarded because they exceed the maximum packet
size of the medium. For example, any Ethernet packet that is greater than 1518
bytes is considered a giant.
throttles Number of times that the interface requested another interface within the router to
slow down.
Cisco IOS Interface and Hardware Component Command Reference
1612
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces ism
Field Description
input errors Errors that include runts, giants, no buffer, cyclic redundancy checksum (CRC),
frame, overrun, and ignored counts. Other input-related errors can also cause the
input errors count to be increased, and some datagrams may have more than one
error; therefore, this sum may not balance with the sum of enumerated input error
counts.
CRC Errors created when the CRC generated by the originating LAN station or far-end
device does not match the checksum calculated from the data received. On a LAN,
this usually indicates noise or transmission problems on the LAN interface or the
LAN bus itself. A high number of CRCs is usually the result of collisions or a
station that is transmitting bad data.
frame Number of packets received incorrectly that have a CRC error and a noninteger
number of octets. On a LAN, this is usually the result of collisions or a
malfunctioning Ethernet device.
overrun Number of times that the receiver hardware was unable to hand received data to a
hardware buffer because the input rate exceeded the receiver’s ability to handle the
data.
ignored Number of received packets that were ignored by the interface because the interface
hardware ran low on internal buffers. These buffers are different from system buffer
space described. Broadcast storms and bursts of noise can cause the ignored count
to increase.
input packets with Number of packets with dribble condition. Dribble bit error indicates that a frame
dribble condition is slightly too long. This frame error counter is incremented just for informational
detected purposes; the router accepts the frame.
packets output Total number of messages that have been transmitted by the system.
bytes Total number of bytes, including data and MAC encapsulation, that have been
transmitted by the system.
underruns Number of times that the transmitter has run faster than the router could handle.
This may never be reported on some interfaces.
output errors Sum of all errors that prevented the final transmission of datagrams out of the
interface that is being examined. Note that this may not balance with the sum of
the enumerated output errors, because some datagrams may have more than one
error, and others may have errors that do not fall into any of the specifically tabulated
categories.
collisions Number of messages that have been retransmitted because of an Ethernet collision.
This is usually the result of an overextended LAN (Ethernet or transceiver cable
too long, more than two repeaters between stations, or too many cascaded multiport
transceivers). A packet that collides is counted only once in output packets.
Cisco IOS Interface and Hardware Component Command Reference
1613
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces ism
Field Description
interface resets Number of times an interface has been completely reset. This can happen if packets
that were queued for transmission were not sent within several seconds. On a serial
line, this can be caused by a malfunctioning modem that is not supplying the transmit
clock signal or by a cable problem. If the system notices that the carrier detect line
of a serial interface is up, but the line protocol is down, it periodically resets the
interface in an effort to restart it. Interface resets can also occur when an interface
is looped back or shut down.
babbles Count of frames greater than 1518 bytes that have been transmitted, indicating that
the transmitter has been on the interface longer than the time necessary to transmit
the largest frame.
late collision Number of late collisions. A collision becomes a late collision when it occurs after
the preamble has been transmitted.
deferred Deferred indicates that the chip, while ready to transmit a frame, had to defer because
the carrier was asserted.
lost carrier Number of times that the carrier was lost during transmission.
no carrier Number of times that the carrier was not present during the transmission.
output buffer failures, Number of failed buffers and number of buffers swapped out.
output buffers swapped
out
Related Commands Command Description
show controllers ism Displays controller information for the service module interface.
Cisco IOS Interface and Hardware Component Command Reference
1614
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces lex
show interfaces lex
To display statistics about a LAN Extender interface, use the showinterfaceslex command in EXEC mode.
show interfaces lex commandshow interfaces lex number [{ethernet|serial}]
Syntax Description number Number of the LAN Extender interface that resides on the core router about which to display
statistics.
ethernet (Optional) Displays statistics about the Ethernet interface that resides on the LAN Extender
chassis.
serial (Optional) Displays statistics about the serial interface that resides on the LAN Extender chassis.
Command Modes EXEC
Command History Release Modification
10.3 This command was introduced.
12.2(15)T This command is no longer supported in Cisco IOS Mainline or Technology-based releases.
It may conintue to appear in Cisco IOS 12.2S-family releases.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines To display statistics about the LAN Extender interface on the core router, use the showinterfaceslex command
without any keywords.
Administratively, the physical serial interface that connects the core router to the LAN Extender is completely
hidden. The showinterfacesserialcommand will show only that the serial interface is present. However, it
will not report any statistics about the traffic passing over the physical line. All statistics are report by the
showinterfaceslex command.
Examples The following is sample output from the showinterfaceslex command, showing the LAN Extender
interface on the host router. Note the “Bound to ...” field, which is displayed only on a LAN Extender
interface.
Router# show interfaces lex 0
Lex0 is up, line protocol is up
Hardware is Lan Extender, address is 0204.0301.1526 (bia 0000.0000.0000)
MTU 1500 bytes, BW 10000 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation ARPA, loopback not set
ARP type: ARPA, ARP Timeout 4:00:00
Bound to Serial3
Last input never, output never, output hang never
Last clearing of "show interface" counters never
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 1000 bits/sec, 0 packets/sec
Cisco IOS Interface and Hardware Component Command Reference
1615
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces lex
Five minute output rate 0 bits/sec, 0 packets/sec
1022 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
2070 packets output, 23663 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets, 0 restarts
The following is sample output from the showinterfaceslex command when you specify the ethernet
keyword:
Router# show interfaces lex 0 ethernet
Lex0-Ethernet0 is up, line protocol is up
Hardware is LAN-Extender, address is 0000.0c01.1526 (bia 0000.0c01.1526)
Last input 6w3d, output 6w3d
Last clearing of "show interface" counters 0:02:30
Output queue 40/50, 60 drops; input queue 10/40, 2 drops
Five minute input rate 0 bits/sec, 0 packets/sec
Five minute output rate 0 bits/sec, 0 packets/sec
3916 packets input, 960303 bytes, 3 no buffer
Received 2 broadcasts, 3 runts, 3 giants
2 input errors, 1 CRC, 1 frame, 1 overrun, 3 ignored, 2 abort
2500 packets output, 128288 bytes, 1 underruns
1 output errors, 1 collisions, 0 interface resets, 0 restarts
The following is sample output from the showinterfaceslex command when you specify the serial
keyword:
Router# show interfaces lex 0 serial
Lex0-Serial0 is up, line protocol is up
Hardware is LAN-Extender
Last input 6w3d, output 6w3d
Last clearing of "show interface" counters 0:03:05
Input queue: 5/15/4 (size/max/drops); Total output drops: 450
Output queue: high 25/35/90, medium 70/80/180, normal 40/50/120, low 10/20/60
Five minute input rate 0 bits/sec, 0 packets/sec
Five minute output rate 0 bits/sec, 0 packets/sec
1939 packets input, 30998 bytes, 6 no buffer
Received 4 broadcasts, 6 runts, 6 giants
4 input errors, 2 CRC, 2 frame, 2 overrun, 6 ignored, 4 abort
1939 packets output, 219535 bytes, 2 underruns
2 output errors, 2 collisions, 0 interface resets, 0 restarts
2 carrier transitions
The table below describes the fields shown in the preceding displays.
Table 138: show interfaces lex Field Descriptions
Field Description
Lex0 is up, line protocol Indicates whether the logical LAN Extender interface on the core router is currently
is up active (that is, whether carrier detect is present), inactive, or has been taken down
by an administrator.
Lex0-Ethernet0 is up, Indicates whether the physical Ethernet and serial interfaces on the LAN Extender
line protocol is up chassis are currently active (that is, whether carrier detect is present) and whether
Lex0-Serial0 is up, line it has been taken down by an administrator.
protocol is up
Hardware is Hardware type of the interfaces on the LAN Extender.
LAN-Extender
Cisco IOS Interface and Hardware Component Command Reference
1616
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces lex
Field Description
address is ... Logical MAC address of the interface.
bia Burned-in MAC address of the interface. The LAN Extender interface does not
have a burned in address; hence it appears as all zeroes.
MTU Maximum transmission unit size of the interface.
BW Value of the bandwidth parameter that has been configured for the interface (in
kilobits per second). The bandwidth parameter is used to compute IGRP metrics
only. If the interface is attached to a serial line with a line speed that does not
match the default (1536 or 1544 for T1 and 56 for a standard synchronous serial
line), use the bandwidth command to specify the correct line speed for this serial
line.
DLY Delay of the interface in microseconds.
rely Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes.
Encapsulation Encapsulation method assigned to interface.
ARP type Type of Address Resolution Protocol assigned.
ARP Timeout Number of hours, minutes, and seconds an ARP cache entry will stay in the cache.
Bound to ... Number of the serial interface to which the logical LAN Extender interface is
bound.
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by an interface and processed locally on the router. Useful for knowing
when a dead interface failed. This counter is updated only when packets are process
switched, not when packets are fast switched.
output Number of hours, minutes, and seconds (or never) since the last packet was
successfully transmitted by an interface. This counter is updated only when packets
are process switched, not when packets are fast switched.
output hang Number of hours, minutes, and seconds (or never) since the interface was last
reset because of a transmission that took too long. When the number of hours in
any of the “last” fields exceeds 24 hours, the number of days and hours is printed.
If that field overflows, asterisks are printed.
Cisco IOS Interface and Hardware Component Command Reference
1617
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces lex
Field Description
Last clearing of “show Time at which the counters that measure cumulative statistics (such as number of
interface” counters bytes transmitted and received) shown in this report were last reset to zero. Note
that variables that might affect routing (for example, load and reliability) are not
cleared when the counters are cleared.
*** indicates the elapsed time is too large to be displayed.
0:00:00 indicates the counters were cleared more than 231 ms (and less than 232
ms) ago.
Output queue, drops Number of packets in output and input queues. Each number is followed by a
input queue, drops slash, the maximum size of the queue, and the number of packets dropped because
of a full queue.
Five minute input rate Average number of bits and packets transmitted per second in the last 5 minutes.
Five minute output rate
The 5-minute input and output rates should be used only as an approximation of
traffic per second during a given 5-minute period. These rates are exponentially
weighted averages with a time constant of 5 minutes. A period of four time
constants must pass before the average will be within two percent of the
instantaneous rate of a uniform stream of traffic over that period.
packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the
main system. Compare with ignored count. Broadcast storms on Ethernet networks
and bursts of noise on serial lines are often responsible for no input buffer events.
Received ... broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the medium.
giants Number of packets that are discarded because they exceed the maximum packet
size of the medium.
input errors Total number of no buffer, runts, giants, CRCs, frame, overrun, ignored, and abort
counts. Other input-related errors can also increment the count, so that this sum
might not balance with the other counts.
CRC Cyclic redundancy checksum generated by the originating station or far-end device
does not match the checksum calculated from the data received. On a serial link,
CRCs usually indicate noise, gain hits, or other transmission problems on the data
link.
frame Number of packets received incorrectly having a CRC error and a noninteger
number of octets. On a serial line, this is usually the result of noise or other
transmission problems.
Cisco IOS Interface and Hardware Component Command Reference
1618
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces lex
Field Description
overrun Number of times the serial receiver hardware was unable to hand received data
to a hardware buffer because the input rate exceeded the receiver’s ability to handle
the data.
ignored Number of received packets ignored by the interface because the interface hardware
ran low on internal buffers. Broadcast storms and bursts of noise can cause the
ignored count to be increased.
abort Illegal sequence of one bits on a serial interface. This usually indicates a clocking
problem between the serial interface and the data link equipment.
input packets with Does not apply to a LAN Extender interface.
dribble condition
detected
packets output Total number of messages transmitted by the system.
bytes Total number of bytes, including data and MAC encapsulation, transmitted by the
system.
underruns Number of times that the transmitter has been running faster than the router can
handle. This might never be reported on some interfaces.
output errors Sum of all errors that prevented the final transmission of datagrams out of the
interface being examined. Note that this might not balance with the sum of the
enumerated output errors, as some datagrams may have more than one error, and
others may have errors that do not fall into any of the specifically tabulated
categories.
collisions Number of messages retransmitted because of an Ethernet collision. Some collisions
are normal. However, if your collision rate climbs to around 4 or 5 percent, you
should consider verifying that there is no faulty equipment on the segment and/or
moving some existing stations to a new segment. A packet that collides is counted
only once in output packets.
interface resets Number of times an interface has been completely reset. This can happen if packets
queued for transmission were not sent within several seconds’ time. On a serial
line, this can be caused by a malfunctioning modem that is not supplying the
transmit clock signal, or by a cable problem. If the system notices that the carrier
detect line of a serial interface is up, but the line protocol is down, it periodically
resets the interface in an effort to restart it. Interface resets can also occur when
an interface is looped back or shut down.
restarts Number of times the controller was restarted because of errors.
Cisco IOS Interface and Hardware Component Command Reference
1619
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces loopback
show interfaces loopback
To display information about the loopback interface, use the showinterfacesloopbackcommand in privileged
EXEC mode.
show interfaces loopback commandshow interfaces loopback [number] [accounting]
Syntax Description number (Optional) Port number on the selected interface.
accounting (Optional) Displays the number of packets of each protocol type that have been sent through
the interface.
Command Modes Privileged EXEC
Command History Release Modification
10.0 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples The following is sample output from the showinterfacesloopback command:
Router# show interfaces loopback 0
Loopback0 is up, line protocol is up
Hardware is Loopback
MTU 1500 bytes, BW 1 Kbit, DLY 50 usec, rely 255/255, load 1/255
Encapsulation UNKNOWN, loopback not set, keepalive set (10 sec)
Last input never, output never, output hang never
Last clearing of "show interface" counters never
Output queue 0/0, 0 drops; input queue 0/75, 0 drops
Five minute input rate 0 bits/sec, 0 packets/sec
Five minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 packets output, 0 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets, 0 restarts
The following is sample output when the accounting keyword is included:
Router# show interfaces loopback 0 accounting
Loopback0
Protocol Pkts In Chars In Pkts Out Chars Out
No traffic sent or received on this interface.
The table below describes significant fields shown in the displays.
Cisco IOS Interface and Hardware Component Command Reference
1620
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces loopback
Table 139: show interfaces loopback Field Descriptions
Field Description
Loopback is {up | down Indicates whether the interface hardware is currently active (whether carrier detect
| administratively down} is present), is currently inactive, or has been taken down by an administrator.
line protocol is {up | Indicates whether the software processes that handle the line protocol consider
down | administratively the line usable (that is, whether keepalives are successful).
down}
Hardware Hardware is Loopback.
MTU Maximum transmission unit of the interface.
BW Bandwidth of the interface, in kilobits per second.
DLY Delay of the interface, in microseconds.
rely Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes.
Encapsulation Encapsulation method assigned to interface.
loopback Indicates whether loopback is set and type of loopback test.
keepalive Indicates whether keepalives are set or not.
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by an interface and processed locally on the router. Useful for knowing
when a dead interface failed. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
Last output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by an interface. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
output hang Number of hours, minutes, and seconds (or never) since the interface was last
reset because of a transmission that took too long. When the number of hours in
any of the “last” fields exceeds 24 hours, the number of days and hours is printed.
If that field overflows, asterisks are printed.
Last clearing Time at which the counters that measure cumulative statistics (such as number of
bytes transmitted and received) shown in this report were last reset to zero. Note
that variables that might affect routing (for example, load and reliability) are not
cleared when the counters are cleared.
*** indicates the elapsed time is too large to be displayed.
0:00:00 indicates the counters were cleared more than 231 ms (and less than 232
ms) ago.
Cisco IOS Interface and Hardware Component Command Reference
1621
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces loopback
Field Description
Output queue, drops; Number of packets in output and input queues. Each number is followed by a
Input queue, drops slash, the maximum size of the queue, and the number of packets dropped because
of a full queue.
Five minute input rate, Average number of bits and packets transmitted per second in the last 5 minutes.
Five minute output rate
packets input Total number of error-free packets received by the system.
bytes input Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the
main system. Compare with ignored count. Broadcast storms on Ethernet networks
and bursts of noise on serial lines are often responsible for no input buffer events.
broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the medium.
giants Number of packets that are discarded because they exceed the maximum packet
size of the medium.
input errors Sum of all errors that prevented the receipt of datagrams on the interface being
examined. This may not balance with the sum of the enumerated output errors,
because some datagrams may have more than one error and others may have errors
that do not fall into any of the specifically tabulated categories.
CRC Cyclic redundancy checksum generated by the originating LAN station or far-end
device does not match the checksum calculated from the data received. On a LAN,
this usually indicates noise or transmission problems on the LAN interface or the
LAN bus itself. A high number of CRCs is usually the result of collisions or a
station transmitting bad data. On a serial link, CRCs usually indicate noise, gain
hits, or other transmission problems on the data link. CRC errors are also reported
when a far-end abort occurs, and when the idle flag pattern is corrupted. This
makes it possible to get CRC errors even when there is no data traffic.
frame Number of packets received incorrectly having a CRC error and a noninteger
number of octets. On a serial line, this is usually the result of noise or other
transmission problems.
overrun Number of times the serial receiver hardware was unable to hand received data
to a hardware buffer because the input rate exceeded the receiver’s ability to handle
the data.
ignored Number of received packets ignored by the interface because the interface hardware
ran low on internal buffers. These buffers are different than the system buffers
mentioned previously in the buffer description. Broadcast storms and bursts of
noise can cause the ignored count to be increased.
abort Number of packets whose receipt was aborted.
Cisco IOS Interface and Hardware Component Command Reference
1622
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces loopback
Field Description
packets output Total number of messages transmitted by the system.
bytes output Total number of bytes, including data and MAC encapsulation, transmitted by the
system.
underruns Number of times that the far-end transmitter has been running faster than the
near-end router’s receiver can handle. This may never happen (be reported) on
some interfaces.
output errors Sum of all errors that prevented the final transmission of datagrams out of the
interface being examined. Note that this may not balance with the sum of the
enumerated output errors, as some datagrams may have more than one error, and
others may have errors that do not fall into any of the specifically tabulated
categories.
collisions Loopback interface does not have collisions.
interface resets Number of times an interface has been completely reset. This can happen if packets
queued for transmission were not sent within several seconds time. On a serial
line, this can be caused by a malfunctioning modem that is not supplying the
transmit clock signal, or by a cable problem. If the system notices that the carrier
detect line of a serial interface is up, but the line protocol is down, it periodically
resets the interface in an effort to restart it. Interface resets can also occur when
an interface is looped back or shut down.
restarts Number of times the controller was restarted because of errors.
Protocol Protocol that is operating on the interface.
Pkts In Number of packets received for that protocol.
Chars In Number of characters received for that protocol.
Pkts Out Number of packets transmitted for that protocol.
Chars Out Number of characters transmitted for that protocol.
Cisco IOS Interface and Hardware Component Command Reference
1623
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces port-channel
show interfaces port-channel
To display the information about the Fast EtherChannel on Cisco 7000 series routers with the RSP7000 and
RSP7000CI, Cisco 7200 series routers, and Cisco 7500 series routers, use the showinterfacesport-channel
command in user EXEC or privileged EXEC mode.
show interfaces port-channel commandshow interfaces port-channel [channel-number]
Syntax Description channel-number (Optional) Port channel number. Range is from 1 to 4.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
11.1 CA This command was introduced.
12.1(5)T This command was integrated into Cisco IOS Release 12.1(5)T.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
15.2(02)SA This command was implemented on the Cisco ME 2600X Series Ethernet Access Switches.
Examples The following is sample output from the showinterfacesport-channel command:
Note By default the hardware type is set to Fast EtherChannel.The default MTU is set to 1500 bytes. The
maximum MTU size that can be configured on the native Gigabit Ethernet ports on the Cisco 7200
series router is 9216. The range of configurable MTU value is from 1500 to 9216.
Router# show interfaces port-channel 1
Port-channel1 is up, line protocol is up
Hardware is FEChannel, address is 0000.0ca8.6220 (bia 0000.0000.0000)
MTU 1500 bytes, BW 400000 Kbit, DLY 100 usec, rely 255/255, load 1/255
Encapsulation ARPA, loopback not set, keepalive not set, fdx
ARP type: ARPA, ARP Timeout 04:00:00
No. of active members in this channel: 4
Member 0 : Fast Ethernet1/0/0
Member 1 : Fast Ethernet1/1/0
Member 2 : Fast Ethernet4/0/0
Member 3 : Fast Ethernet4/1/0
Last input 01:22:13, output never, output hang never
Last clearing of “show interface” counters never
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
223 packets input, 11462 bytes, 0 no buffer
Received 1 broadcasts, 0 runts, 0 giants
Cisco IOS Interface and Hardware Component Command Reference
1624
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces port-channel
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 watchdog, 0 multicast
0 input packets with dribble condition detected
192 packets output, 13232 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out
The following sample output from the showinterfacesport-channel shows Gigabit EtherChannel
as hardware type and the MTU value as 9216:
Router# show interface port-channel 1
Port-channel1 is up, line protocol is up
Hardware is GEChannel
, address is 0001.c929.c41b (bia 0001.c929.c41b)
MTU 9216 bytes
, BW 1000000 Kbit, DLY 10 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive set (10 sec)
Unknown duplex, Unknown Speed, media type is unknown media type
output flow-control is unsupported, input flow-control is unsupported
ARP type: ARPA, ARP Timeout 04:00:00
No. of active members in this channel: 1
Member 0 : GigabitEthernet0/1 , Full-duplex, 1000Mb/s
No. of Non-active members in this channel: 0
Last input 00:00:04, output never, output hang never
Last clearing of "show interface" counters never
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue: 0/40 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
95 packets input, 34383 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 watchdog, 0 multicast, 0 pause input
0 input packets with dribble condition detected
1 packets output, 77 bytes, 0 underruns
2 output errors, 0 collisions, 0 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier, 0 pause output
0 output buffer failures, 0 output buffers swapped out
The table below describes significant fields shown in the display.
Table 140: show interfaces port-channel Field Descriptions
Field Description
Port-channel1 is up, line Indicates if the interface hardware is currently active and can transmit and receive
protocol is up or if it has been taken down by an administrator.
Hardware is Hardware type (Fast EtherChannel).
address is Address being used by the interface.
MTU Maximum transmission unit of the interface.
BW Bandwidth of the interface, in kilobits per second.
Cisco IOS Interface and Hardware Component Command Reference
1625
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces port-channel
Field Description
DLY Delay of the interface, in microseconds.
rely Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes. The calculation uses the
value from the bandwidth interface configuration command.
Encapsulation Encapsulation method assigned to the interface.
loopback Indicates if loopbacks are set.
keepalive Indicates if keepalives are set.
fdx Indicates the interface is operating in full-duplex mode.
ARA type ARP type on the interface.
ARP timeout Number of hours, minutes, and seconds an ARP cache entry will stay in the
cache.
No. of active members in Number of Fast Ethernet interfaces that are currently active (not down) and part
this channel: 4 of the Fast EtherChannel group.
Member 0: Fast Specific Fast Ethernet interface that is part of the Fast EtherChannel group.
Ethernet1/0/0
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by an interface and processed locally on the router. Useful for knowing
when a dead interface failed. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by an interface. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
output hang Number of hours, minutes, and seconds (or never) since the interface was last
reset because of a transmission that took too long. When the number of hours in
any of the “last” fields exceeds 24 hours, the number of days and hours is printed.
If that field overflows, asterisks are printed.
last clearing Time at which the counters that measure cumulative statistics (such as number
of bytes transmitted and received) shown in this report were last reset to zero.
Variables that might affect routing (for example, load and reliability) are not
cleared when the counters are cleared.
*** indicates the elapsed time is too large to be displayed.
0:00:00 indicates the counters were cleared more than 231 ms (and less than 232
ms)) ago.
Cisco IOS Interface and Hardware Component Command Reference
1626
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces port-channel
Field Description
Queueing strategy First-in, first-out queueing strategy (other queueing strategies you might see are
priority-list, custom-list, and weighted fair).
Output queue, drops input Number of packets in output and input queues. Each number is followed by a
queue, drops slash, the maximum size of the queue, and the number of packets dropped because
a queue was full.
5 minute input rate 5 Average number of bits and packets received or transmitted per second in the
minute output rate last 5 minutes.
packets input Total number of error-free packets received by the system.
bytes (input) Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the
main system. Compare with ignored count. Broadcast storms on Ethernets and
bursts of noise on serial lines are often responsible for no input buffer events.
broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the medium.
giants Number of packets that are discarded because they exceed the maximum packet
size of the medium.
input errors Total number of no buffer, runts, giants, CRCs, frame, overrun, ignored, and
abort counts. Other input-related errors can also increment the count, so that this
sum might not balance with the other counts.
CRC Cyclic redundancy checksum generated by the originating LAN station or far-end
device does not match the checksum calculated from the data received. On a
LAN, this usually indicates noise or transmission problems on the LAN interface
or the LAN bus itself. A high number of CRCs is usually the result of collisions
or a station transmitting bad data. On a serial link, CRCs usually indicate noise,
gain hits or other transmission problems on the data link.
frame Number of packets received incorrectly having a CRC error and a noninteger
number of octets. On a serial line, this is usually the result of noise or other
transmission problems.
overrun Number of times the serial receiver hardware was unable to hand received data
to a hardware buffer because the input rate exceeded the receiver’s ability to
handle the data.
ignored Number of received packets ignored by the interface because the interface
hardware ran low on internal buffers. These buffers are different than the system
buffers mentioned previously in the buffer description. Broadcast storms and
bursts of noise can cause the ignored count to be incremented.
abort Illegal sequence of ones bit on the interface.
Cisco IOS Interface and Hardware Component Command Reference
1627
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces port-channel
Field Description
watchdog Number of times watchdog receive timer expired. It happens when receiving a
packet with length greater than 2048.
multicast Number of multicast packets received.
input packets with dribble Dribble bit error indicates that a frame is slightly too long. This frame error
condition detected counter is incremented just for informational purposes; the router accepts the
frame.
packets output Total number of messages transmitted by the system.
bytes (output) Total number of bytes, including data and MAC encapsulation, transmitted by
the system.
underruns Number of times that the far-end transmitter has been running faster than the
near-end router’s receiver can handle.
output errors Sum of all errors that prevented the final transmission of datagrams out of the
interface being examined. Note that this might not balance with the sum of the
enumerated output errors, as some datagrams can have more than one error, and
others can have errors that do not fall into any of the specifically tabulated
categories.
collisions Number of messages retransmitted because of an Ethernet collision. A packet
that collides is counted only once in output packets.
interface resets Number of times an interface has been completely reset. This can happen if
packets queued for transmission were not sent within a certain interval. If the
system notices that the carrier detect line of an interface is up, but the line protocol
is down, it periodically resets the interface in an effort to restart it. Interface resets
can also occur when an unrecoverable interface processor error occurred, or when
an interface is looped back or shut down.
babbles The transmit jabber timer expired.
late collision Number of late collisions. Late collision happens when a collision occurs after
transmitting the preamble. The most common cause of late collisions is that your
Ethernet cable segments are too long for the speed at which you are transmitting.
deferred Deferred indicates that the chip had to defer while ready to transmit a frame
because the carrier was asserted.
lost carrier Number of times the carrier was lost during transmission.
no carrier Number of times the carrier was not present during the transmission.
output buffer failures Number of times that a packet was not output from the output hold queue because
of a shortage of MEMD shared memory.
output buffers swapped Number of packets stored in main memory when the output queue is full;
out swapping buffers to main memory prevents packets from being dropped when
output is congested. The number is high when traffic is bursty.
Cisco IOS Interface and Hardware Component Command Reference
1628
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces port-channel
Related Commands Command Description
interface multilink Specifies a Fast EtherChannel and enters interface configuration mode.
Cisco IOS Interface and Hardware Component Command Reference
1629
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces port-channel etherchannel
show interfaces port-channel etherchannel
To display the load-balancing bucket distribution currently in use for a Gigabit EtherChannel (GEC) interface,
use the showinterfacesport-channeletherchannel command in user EXEC or privileged EXEC mode.
show interfaces port-channel channel-number etherchannel
Syntax Description channel-number Port-channel group number. Range: 1 to 64.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
Cisco IOS XE Release 2.1 This command was introduced.
Cisco IOS XE Release 2.5 This command was modified. Information about flow-based load balancing was
added to the output.
Usage Guidelines The showinterfacesport-channeletherchannel command shows the bucket-to-member link mappings for
load balancing on the GEC interface.
Load balancing uses the concept of buckets to map traffic flows to the member links of a port channel. The
different traffic flows are mapped to buckets and each bucket has one active member link associated with it.
All traffic flows that are mapped to a bucket use the member link assigned to the bucket.
There are two methods of load balancing on a GEC interface:
• VLAN-manual--All packets forwarded over the same VLAN subinterface are considered part of the
same flow and are mapped to the member link specified in the configuration.
• Flow-based--Traffic flows are mapped to different member links based on the packet header.
Examples The following example shows output from this command for a port channel with VLAN-manual
load balancing configured:
Router# show interfaces port-channel 2 etherchannel
All IDBs List contains 3 configured interfaces
Port: GigabitEthernet2/1/6 (index: 0)
Port: GigabitEthernet2/1/7 (index: 1)
Port: GigabitEthernet2/1/0 (index: 2)
Active Member List contains 1 interfaces
Port: GigabitEthernet2/1/0
Passive Member List contains 2 interfaces
Port: GigabitEthernet2/1/6
VLAN 1 (Pri, Ac, D, P) VLAN 50 (Sec, St, D, P)
Port: GigabitEthernet2/1/7
VLAN 1 (Sec, St, D, P) VLAN 50 (Pri, Ac, C, P)
Load-Balancing method applied: vlan-manual
Bucket Information for VLAN Manual LB:
Cisco IOS Interface and Hardware Component Command Reference
1630
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces port-channel etherchannel
Bucket 0 (p=GigabitEthernet2/1/6, s=GigabitEthernet2/1/6) active GigabitEthernet2/1/6
Bucket 1 (p=GigabitEthernet2/1/6, s=GigabitEthernet2/1/7) active GigabitEthernet2/1/6
Bucket 2 (p=GigabitEthernet2/1/6, s=GigabitEthernet2/1/0) active GigabitEthernet2/1/0
Bucket 4 (p=GigabitEthernet2/1/7, s=GigabitEthernet2/1/6) active GigabitEthernet2/1/7
Bucket 5 (p=GigabitEthernet2/1/7, s=GigabitEthernet2/1/7) active GigabitEthernet2/1/7
Bucket 6 (p=GigabitEthernet2/1/7, s=GigabitEthernet2/1/0) active GigabitEthernet2/1/0
Bucket 8 (p=GigabitEthernet2/1/0, s=GigabitEthernet2/1/6) active GigabitEthernet2/1/0
Bucket 9 (p=GigabitEthernet2/1/0, s=GigabitEthernet2/1/7) active GigabitEthernet2/1/0
Bucket 10 (p=GigabitEthernet2/1/0, s=GigabitEthernet2/1/0) active GigabitEthernet2/1/0
The following example shows output for a port channel with flow-based load balancing configured:
Router(config)# show interfaces port-channel 2 etherchannel
All IDBs List contains 3 configured interfaces
Port: GigabitEthernet2/1/6 (index: 0)
Port: GigabitEthernet2/1/7 (index: 1)
Port: GigabitEthernet2/1/0 (index: 2)
Active Member List contains 1 interfaces
Port: GigabitEthernet2/1/0
Passive Member List contains 2 interfaces
Port: GigabitEthernet2/1/6
Port: GigabitEthernet2/1/7
Load-Balancing method applied: flow-based
Bucket Information for Flow-Based LB:
Interface: Buckets
GigabitEthernet2/1/0:
Bucket 0 , Bucket 1 , Bucket 2 , Bucket 3
Bucket 4 , Bucket 5 , Bucket 6 , Bucket 7
Bucket 8 , Bucket 9 , Bucket 10, Bucket 11
Bucket 12, Bucket 13, Bucket 14, Bucket 15
The table below describes the significant fields shown in the display.
Table 141: show interfaces port-channel etherchannel Field Descriptions
Field Description
Active Member List List of active physical interfaces in the GEC bundle.
Passive Member List List of passive (backup) physical interfaces in the GEC bundle.
Load-Balancing method applied The load-balancing method configured on the interface, either flow-based
or vlan-manual.
Bucket Information Lists the bucket information across the active member links.
Cisco IOS Interface and Hardware Component Command Reference
1631
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces port-channel etherchannel
Related Commands Command Description
load-balancing Applies a load-balancing method to a GEC interface.
port-channel load-balancing vlan-manual Applies the VLAN-manual load-balancing method globally
to all GEC interfaces.
show etherchannel load-balancing Displays the load-balancing method applied to GEC interfaces.
Cisco IOS Interface and Hardware Component Command Reference
1632
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces pos
show interfaces pos
To display configuration information and statistics for a Packet over SONET (POS) interface, use the
showinterfacespos command in user EXEC or privileged EXEC configuration mode.
Cisco 7000 and Cisco 7500 Series with VIPs
show interfaces pos commandshow interfaces pos [slot/port-adapter/port]
POS Shared Port Adapters
show interfaces pos [slot/subslot/port [/sub_int]]
Syntax Description slot / (Optional) Cisco 7000 or Cisco 7500 Series Routers
port-adapter /
Number of the chassis slot that contains the POS interface (for example, 2/0/0), where:
port
• slot --Chassis slot number.
• / port-adapter-- Port adapter number.
• / port-- Port or interface number.
Refer to the appropriate hardware manual for slot and port information, and port adapter
compatibility.
slot / subslot / (Optional) POS Shared Port Adapters
port / sub_int
Number of the chassis slot that contains the POS interface (for example 4/3/0), where:
• slot --Chassis slot number.
Refer to the appropriate hardware manual for slot information. For SIPs, refer to the
platform-specific SPA hardware installation guide or the corresponding “Identifying
Slots and Subslots for SIPs and SPAs” topic in the platform-specific SPA software
configuration guide.
• / subslot-- Secondary slot number on a SPA interface processor (SIP) where a
SPA is installed.
Refer to the platform-specific SPA hardware installation guide and the corresponding
“Specifying the Interface Address on a SPA” topic in the platform-specific SPA software
configuration guide for subslot information.
• / port --Port or interface number.
For SPAs, refer to the corresponding “Specifying the Interface Address on a SPA” topics
in the platform-specific SPA software configuration guide.
• / sub_int -- (Optional) Subinterface number.
Command Modes User EXEC Privileged EXEC
Cisco IOS Interface and Hardware Component Command Reference
1633
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces pos
Command History Release Modification
11.2 The showinterfaceposi command was introduced.
11.3 The name of the command was modified from showinterfaceposito showinterfacespos, and
the sample output was updated.
12.2(25)S3 This command was integrated into Cisco IOS Release 12.2(25)S3 to support SPAs on the
Cisco 7304 router. The command was modified to support a new addressing format for SPAs.
12.2(18)SXE This command was integrated into Cisco IOS Release 12.2(18)SXE to support SPAs on the
Cisco 7600 series routers and Catalyst 6500 series switches.
12.0(31)S This command was integrated into Cisco IOS Release 12.0(31)S to support SPAs on the Cisco
12000 series routers.
Examples
Cisco 7513 Example
The following is sample output from the showinterfacespos command on a Cisco 7513 router with
one Packet OC-3 Interface Processor (POSIP):
Router# show interfaces pos 2/0/0
POS2/0/0 is up, line protocol is up
Hardware is cyBus Packet over Sonet
Description: PRI-T1 net to zippy (4K) to Pac-Bell
Internet address is 10.1.1.1/27
MTU 4470 bytes, BW 1000 Kbit, DLY 40000 usec, rely 255/255, load 1/255
Encapsulation HDLC, loopback not set, keepalive set (3 sec)
Last input 00:00:00, output 00:00:00, output hang never
Last clearing of “show interface” counters 00:23:09
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 1 packets/sec
5 minute output rate 1000 bits/sec, 1 packets/sec
1046 packets input, 54437 bytes, 0 no buffer
Received 485 broadcasts, 0 runts, 0 giants, 0 parity
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
4013 packets output, 1357412 bytes, 0 underruns
0 output errors, 0 applique, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
0 carrier transitions
Cisco 7600 Series Router and Catalyst 6500 Series Switch POS Shared Port Adapter Example
The following is sample output from the showinterfacespos command on a Cisco 7600 series router
or Catalyst 6500 series switch for POS interface 4/3/0 (which is the interface for port 0 of the SPA
in subslot 3 of the SIP in chassis slot 4):
Router# show interfaces pos 4/3/0
POS4/3/0 is up, line protocol is up (APS working - active)
Hardware is Packet over SONET
Internet address is 10.0.0.1/8
MTU 4470 bytes, BW 622000 Kbit, DLY 100 usec, rely 255/255, load 1/255
Cisco IOS Interface and Hardware Component Command Reference
1634
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces pos
Encapsulation HDLC, crc 16, loopback not set
Keepalive not set
Scramble disabled
Last input 00:00:34, output 04:09:06, output hang never
Last clearing of "show interface" counters never
Queueing strategy:fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Available Bandwidth 622000 kilobits/sec
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
782 packets input, 226563 bytes, 0 no buffer
Received 0 broadcasts, 1 runts, 0 giants, 0 throttles
0 parity
1 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
271 packets output, 28140 bytes, 0 underruns
0 output errors, 0 applique, 2 interface resets
0 output buffer failures, 0 output buffers swapped out
2 carrier transitions
Cisco 12000 Series Router POS Shared Port Adapter Example
The following is sample output from the showinterfacespos command on a Cisco 12000 series router
for POS interface 1/1/0 (which is the interface for port 0 of the SPA in subslot 1 of the SIP in chassis
slot 1):
Router# show interfaces pos 1/1/0
POS1/1/0 is up, line protocol is up
Hardware is Packet over SONET
Internet address is 10.41.41.2/24
MTU 4470 bytes, BW 9952000 Kbit, DLY 100 usec, rely 255/255, load 1/255
Encapsulation HDLC, crc 32, loopback not set
Keepalive not set
Scramble enabled
Last input 00:00:59, output 00:00:11, output hang never
Last clearing of "show interface" counters 00:00:14
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Available Bandwidth 9582482 kilobits/sec
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants, 0 throttles
0 parity
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
1 packets output, 314 bytes, 0 underruns
0 output errors, 0 applique, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
0 carrier transitions
The table below describes the significant fields shown in these displays.
Table 142: show interfaces pos Field Descriptions
Field Description
POSx/y/z is up, line Indicates whether the interface hardware is currently active and can transmit and
protocol is up receive or whether it has been taken down by an administrator.
Cisco IOS Interface and Hardware Component Command Reference
1635
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces pos
Field Description
Hardware is. . . Hardware type:
• For POSIP-- cyBus Packet over Sonet
• For POS SPAs--Packet over SONET
Internet address is Internet address and subnet mask.
MTU Maximum transmission unit of the interface.
BW Bandwidth of the interface, in kilobits per second.
DLY Delay of the interface, in microseconds.
rely Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes. The calculation uses the
value from the bandwidth interface configuration command.
Encapsulation Encapsulation method assigned to interface.
Loopback Indicates whether loopbacks are set.
Keepalive Indicates whether keepalives are set.
Scramble Indicates whether or not SONET payload scrambling is enabled. SONET
scrambling is disabled by default. For the POS SPAs on the Cisco 12000 series
routers, scrambling is enabled by default.
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by an interface and processed locally on the router. Useful for knowing
when a dead interface failed. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
(Last) output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by an interface. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
(Last) output hang Number of hours, minutes, and seconds (or never) since the interface was last
reset because of a transmission that took too long. When the number of hours in
any of the “last” fields exceeds 24 hours, the number of days and hours is printed.
If that field overflows, asterisks are printed.
Cisco IOS Interface and Hardware Component Command Reference
1636
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces pos
Field Description
Last clearing Time at which the counters that measure cumulative statistics (such as number
of bytes transmitted and received) shown in this report were last reset to zero.
Note that variables that might affect routing (for example, load and reliability)
are not cleared when the counters are cleared.
*** indicates the elapsed time is too large to be displayed.
0:00:00 indicates the counters were cleared more than 2231 ms (and less than 232
ms) ago.
Queueing strategy First-in, first-out (FIFO) queueing strategy (other queueing strategies you might
see are priority-list, custom-list, and weighted fair).
Output queue, drops input Number of packets in output and input queues. Each number is followed by a
queue, drops slash, the maximum size of the queue, and the number of packets dropped because
a queue was full.
5 minute input rate 5 Average number of bits and packets received or transmitted per second in the last
minute output rate 5 minutes.
packets input Total number of error-free packets received by the system.
bytes (input) Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the
main system. Compare with ignored count. Broadcast storms on Ethernets and
bursts of noise on serial lines are often responsible for no input buffer events.
broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the medium.
giants Number of packets that are discarded because they exceed the maximum packet
size of the medium.
throttles Not supported for POS interfaces.
parity Report of the parity errors on the interface.
input errors Total number of no buffer, runts, giants, CRCs, frame, overrun, ignored, and abort
counts. Other input-related errors can also increment the count, so that this sum
might not balance with the other counts.
CRC Cyclic redundancy checksum generated by the originating LAN station or far-end
device does not match the checksum calculated from the data received. On a LAN,
this usually indicates noise or transmission problems on the LAN interface or the
LAN bus itself. A high number of CRCs is usually the result of collisions or a
station transmitting bad data. On a serial link, CRCs usually indicate noise, gain
hits or other transmission problems on the data link.
Cisco IOS Interface and Hardware Component Command Reference
1637
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces pos
Field Description
frame Number of packets received incorrectly having a CRC error and a noninteger
number of octets. On a serial line, this is usually the result of noise or other
transmission problems.
overrun Number of times the serial receiver hardware was unable to hand received data
to a hardware buffer because the input rate exceeded the receiver’s ability to
handle the data.
ignored Number of received packets ignored by the interface because the interface hardware
ran low on internal buffers. These buffers are different than the system buffers
mentioned previously in the buffer description. Broadcast storms and bursts of
noise can cause the ignored count to be incremented.
abort Illegal sequence of one bits on the interface.
packets output Total number of messages transmitted by the system.
bytes (output) Total number of bytes, including data and MAC encapsulation, transmitted by
the system.
underruns Number of times that the far-end transmitter has been running faster than the
near-end router’s receiver can handle.
output errors Sum of all errors that prevented the final transmission of datagrams out of the
interface being examined. Note that this might not balance with the sum of the
enumerated output errors, as some datagrams can have more than one error, and
others can have errors that do not fall into any of the specifically tabulated
categories.
applique Indicates an unrecoverable error has occurred on the POSIP applique. The system
then invokes an interface reset.
interface resets Number of times an interface has been completely reset. This can happen if packets
queued for transmission were not sent within a certain interval. If the system
notices that the carrier detect line of an interface is up, but the line protocol is
down, it periodically resets the interface in an effort to restart it. Interface resets
can also occur when an unrecoverable interface processor error occurred, or when
an interface is looped back or shut down.
output buffer failures Not supported for POS interfaces.
output buffers swapped Not supported for POS interfaces.
out
carrier transitions Number of times the carrier detect signal of the interface has changed state.
Related Commands Command Description
interface Configures an interface type and enters interface configuration mode.
Cisco IOS Interface and Hardware Component Command Reference
1638
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces private-vlan mapping
show interfaces private-vlan mapping
To display the information about the private virtual local area network (PVLAN) mapping for VLAN SVIs,
use the showinterfacesprivate-vlanmapping command in user EXEC or privileged EXEC mode.
show interfaces [interface interface-number] private-vlan mapping [active]
Syntax Description interface (Optional) Interface type; possible valid values are ethernet, fastethernet,
gigabitethernet, tengigabitethernet, pos, atm, and ge-wan.
interface-number (Optional) Module and port number; see the “Usage Guidelines” section for valid values.
active (Optional) Displays the active interfaces only.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The pos, atm, and ge-wan keywords are supported on Cisco 7600 series routers that are configured with a
Supervisor Engine 2.
This command displays SVI information only.
The interface-numberargument designates the module and port number. Valid values for interface-number
depend on the chassis and module that are used. For example, if you have a 48-port 10/100BASE-T Ethernet
module that is installed in a 13-slot chassis, valid values for the slot number are from 1 to 13 and valid values
for the port number are from 1 to 48.
Examples This example shows how to display the information about the PVLAN mapping:
Router# show interfaces private-vlan mapping
Interface Secondary VLAN Type
--------- -------------- -----------------
vlan2 301 community
vlan2 302 community
Router#
Related Commands Command Description
private-vlan Configures PVLANs and the association between a PVLAN and a secondary
VLAN.
Cisco IOS Interface and Hardware Component Command Reference
1639
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces private-vlan mapping
Command Description
private-vlan mapping Creates a mapping between the primary and the secondary VLANs so that both
VLANs share the same primary VLAN SVI.
Cisco IOS Interface and Hardware Component Command Reference
1640
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces satellite
show interfaces satellite
To display general interface settings and traffic rates for the internal router interface that connects to an
installed Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT), use the showinterfacessatellite
command in user EXEC or privileged EXEC mode.
Syntax:
show interfaces satellite slot / unit
Syntax Description slot Router chassis slot in which the network module is installed.
unit Interface number. For NM-1VSAT-GILAT network modules, always use 0.
Command Default No default behavior or values.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.3(14)T This command was introduced.
Usage Guidelines The showinterfacessatellite command shows these items:
• Basic configuration information for the internal router interface that connects to an installed Cisco IP
VSAT satellite WAN network module (NM-1VSAT-GILAT)
• Traffic statistics, including the number of packets transmitted, input and output rate, and errors
• Interface and line protocol status (up or down), with the following exceptions:
• Line Protocol Status Exception - Hub Dial Backup Mode
• Line Protocol Status Exception - Hot Standby Router Protocol (HSRP) Standby Mode
Line Protocol Status Exception--Hub Dial Backup Mode
If you configure hub dial backup mode on the satellite interface, then the showinterfacessatellite command
always displays Line Protocol Up status, even when the line protocol is down. To view the actual line protocol
status, enter the showcontrollerssatellite command or the service-modulesatelliteslot/0status command in
privileged EXEC mode.
Line Protocol Status Exception--Hot Standby Router Protocol (HSRP) Standby Mode
If the router is in a hot standby group and is in standby mode, then the showinterfacessatellite command
displays “line protocol is up (standby)”, even though a link to the hub is not established from the standby
router. To view the actual line protocol status, enter the showcontrollerssatellite command or the
service-modulesatelliteslot/0status command in privileged EXEC mode.
Examples For output field descriptions, see the table below.
This section provides the following examples:
Cisco IOS Interface and Hardware Component Command Reference
1641
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces satellite
Normal Operation or Hub Dial Backup Mode Example
In the following example, the satellite interface is up and the line protocol is up.
If you configure hub dial backup for the NM-1VSAT-GILAT network module, the line protocol
appears to be up even if the satellite link is actually down. To view the actual line protocol status
while hub dial backup mode is configured, use the showcontrollerssatellite command or the
service-modulesatelliteslot/0status command instead.
Router# show interfaces satellite 2/0
Satellite2/0 is up
, line protocol is up
Hardware is I82559FE, address is 0008.e35f.7370 (bia 0008.e35f.7370)
Internet address is 10.22.1.2/24
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive not set
ARP type:ARPA, ARP Timeout 04:00:00
Last input 00:00:02, output 00:00:00, output hang never
Last clearing of "show interface" counters never
Input queue:0/75/0/0 (size/max/drops/flushes); Total output drops:0
Queueing strategy:fifo
Output queue:0/40 (size/max)
5 minute input rate 13000 bits/sec, 6 packets/sec
5 minute output rate 8000 bits/sec, 9 packets/sec
419433 packets input, 108329352 bytes, 0 no buffer
Received 11792 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 input packets with dribble condition detected
650568 packets output, 73969720 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out
Satellite Backup for a Terrestrial Link--Standby Mode Example
In the following example, the satellite interface is in standby mode because the primary terrestrial
link is up:
Router# show interfaces satellite 1/0
Satellite1/0 is standby mode
, line protocol is down
Hardware is I82559FE, address is 00e0.f7ff.f310 (bia 00e0.f7ff.f310)
Internet address is 10.0.0.1/24
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive not set
ARP type:ARPA, ARP Timeout 04:00:00
Last input 00:00:00, output 00:00:03, output hang never
Last clearing of "show interface" counters 00:00:04
Input queue:0/75/0/0 (size/max/drops/flushes); Total output drops:0
Queueing strategy:fifo
Cisco IOS Interface and Hardware Component Command Reference
1642
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces satellite
Output queue:0/40 (size/max)
30 second input rate 13000 bits/sec, 6 packets/sec
30 second output rate 0 bits/sec, 0 packets/sec
30 packets input, 7474 bytes, 0 no buffer
Received 1 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 input packets with dribble condition detected
1 packets output, 82 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out
Hot Standby Router Protocol (HSRP)--Standby Mode Example
In the following example, homogeneous HSRP is configured on two routers, each of which contains
an NM-1VSAT-GILAT network module that connects to the same dish antenna (ODU). The following
output from the standby router shows that the line protocol is “up (standby),” even though the satellite
link on the standby router is actually down. To view the actual line protocol status, use the
showcontrollerssatellite command or the service-modulesatelliteslot/0status command.
Router# show interfaces satellite 2/0
Satellite2/0 is up
, line protocol is up (standby)
Hardware is I82559FE, address is 0008.e35f.7370 (bia 0008.e35f.7370)
Internet address is 10.22.1.2/24
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive not set
ARP type:ARPA, ARP Timeout 04:00:00
Last input 00:00:02, output 00:00:00, output hang never
Last clearing of "show interface" counters never
Input queue:0/75/0/0 (size/max/drops/flushes); Total output drops:0
Queueing strategy:fifo
Output queue:0/40 (size/max)
5 minute input rate 13000 bits/sec, 6 packets/sec
5 minute output rate 8000 bits/sec, 9 packets/sec
419433 packets input, 108329352 bytes, 0 no buffer
Received 11792 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 input packets with dribble condition detected
650568 packets output, 73969720 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier
0 output buffer failures, 0 output buffers swapped out
The table below describes the significant fields shown in the display.
Cisco IOS Interface and Hardware Component Command Reference
1643
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces satellite
Table 143: show interfaces satellite Field Descriptions
Field Description
Satellite2/0 is... State of the interface hardware:
• up • Currently active.
• down • Has been taken down by an administrator.
• standby mode • In HSRP standby mode when two HSRP-redundant
NM-1VSAT-GILAT network modules (in separate routers) connect
to one dish antenna (ODU).
line protocol is State of the backbone link to the hub: up or down. See the following
exceptions:
Hardware is Hardware type (for example, Fast Ethernet) and address.
Internet address Internet address followed by subnet mask.
MTU Maximum transmission unit of the interface.
BW Bandwidth of the interface, in kilobits per second.
DLY Delay of the interface, in microseconds.
reliability Reliability of the interface as a fraction of 255 (255/255 is 100 percent
reliability), calculated as an exponential average over 5 minutes.
txload and rxload Transmitted and received load on the interface as a fraction of 255 (255/255
is completely saturated), calculated as an exponential average over 5
minutes.
Encapsulation Encapsulation method assigned to the interface.
loopback Indicates whether loopback is set or not.
keepalive Indicates whether keepalives are set or not.
ARP type Type of Address Resolution Protocol assigned.
Last input Number of hours, minutes, and seconds since the last packet was
successfully received by an interface and processed locally on the router.
Useful for knowing when a dead interface failed. This counter is updated
only when packets are process-switched, not when packets are
fast-switched.
output Number of hours, minutes, and seconds since the last packet was
successfully transmitted by the interface. Useful for knowing when a dead
interface failed. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
Cisco IOS Interface and Hardware Component Command Reference
1644
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces satellite
Field Description
output hang Number of hours, minutes, and seconds (or never) since the interface was
last reset because of a transmission that took too long. When the number
of hours in any of the “last” fields exceeds 24 hours, the number of days
and hours is printed. If that field overflows, asterisks are printed.
Last clearing Time at which the counters that measure cumulative statistics (such as
number of bytes transmitted and received) shown in this report were last
reset to zero. Note that variables that might affect routing (for example,
load and reliability) are not cleared when the counters are cleared.
*** indicates the elapsed time is too large to be displayed.
0:00:00 indicates the counters were cleared more than 2 31 ms (and less
than 2 32 ms) ago.
Input queue Input queue information:
• Size--Number of packets in the input queue
• Max--Maximum size of the queue
• Drops--Number of packets discarded because of a full queue
• Flushes--Number of times data on queue has been discarded
Total output drops Total number of output packets dropped.
Queueing strategy First-in, first-out queueing strategy (other queueing strategies you might
see are priority-list, custom-list, and weighted fair).
Output queue Number of packets in the output queue and the maximum size of the queue,
5 minute input rate Average number of bits and packets transmitted per second in the last 5
minutes.
5 minute output rate
The 5-minute input and output rates should be used only as an
approximation of traffic per second during a given 5-minute period. These
rates are exponentially weighted averages with a time constant of 5 minutes.
A period of four time constants must pass before the average will be within
two percent of the instantaneous rate of a uniform stream of traffic over
that period.
packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the
error-free packets received by the system.
no buffer Number of received packets discarded because there was no buffer space
in the main system. Compare with ignored count. Broadcast storms on
Ethernet networks and bursts of noise on serial lines are often responsible
for no input buffer events.
broadcasts Total number of broadcast or multicast packets received by the interface.
Cisco IOS Interface and Hardware Component Command Reference
1645
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces satellite
Field Description
runts Number of packets that are discarded because they are smaller than the
minimum packet size of the media.
giants Number of packets that are discarded because they exceed the maximum
packet size of the media.
throttles Number of times that the interface requested another interface within the
router to slow down.
input errors Includes runts, giants, no buffer, CRC, frame, overrun, and ignored counts.
Other input-related errors can also cause the input errors count to be
increased, and some datagrams may have more than one error; therefore,
this sum may not balance with the sum of enumerated input error counts.
CRC Cyclic redundancy checksum generated by the originating LAN station or
far-end device does not match the checksum calculated from the data
received. On a LAN, this usually indicates noise or transmission problems
on the LAN interface or the LAN bus itself. A high number of CRCs is
usually the result of collisions or a station transmitting bad data.
frame Number of packets received incorrectly having a CRC error and a
noninteger number of octets. On a LAN, this is usually the result of
collisions or a malfunctioning Ethernet device.
overrun Number of times the receiver hardware was unable to hand received data
to a hardware buffer because the input rate exceeded the receiver’s ability
to handle the data.
ignored Number of received packets ignored by the interface because the interface
hardware ran low on internal buffers. These buffers are different from the
system buffers mentioned previously in the buffer description. Broadcast
storms and bursts of noise can increase the ignored count.
input packets with dribble Dribble bit error indicates that a frame is slightly too long. This frame error
condition detected counter is incremented just for informational purposes; the router accepts
the frame.
packets output Total number of messages transmitted by the system.
bytes Total number of bytes, including data and MAC encapsulation, transmitted
by the system.
underruns Number of times that the transmitter has been running faster than the router
can handle. This may never be reported on some interfaces.
output errors Sum of all errors that prevented the final transmission of datagrams out of
the interface being examined. Note that this may not balance with the sum
of the enumerated output errors, because some datagrams may have more
than one error, and others may have errors that do not fall into any of the
specifically tabulated categories.
Cisco IOS Interface and Hardware Component Command Reference
1646
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces satellite
Field Description
collisions Number of messages retransmitted because of an Ethernet collision. A
packet that collides is counted only once in output packets.
interface resets Number of times an interface has been completely reset. This can happen
if packets queued for transmission were not sent within several seconds.
On a serial line, this can be caused by a malfunctioning modem that is not
supplying the transmit clock signal, or by a cable problem. If the system
notices that the carrier detect line of a serial interface is up, but the line
protocol is down, it periodically resets the interface in an effort to restart
it. Interface resets can also occur when an interface is looped back or shut
down.
babbles Indicates that the transmit jabber timer expired.
Note This field applies to the
router internal interface
that connects to the
installed Cisco IP
VSAT satellite WAN
network module
(NM-1VSAT-GILAT).
This field typically
does not apply to the
external satellite
interface.
late collision Number of late collisions. Late collision happens when a collision occurs
after the preamble has been transmitted. The most common cause of late
collisions is that your Ethernet cable segments are too long for the speed
at which you are transmitting.
deferred Deferred indicates that the chip had to defer transmission while ready to
transmit a frame, because the carrier was asserted.
lost carrier Number of times the carrier was lost during transmission.
no carrier Number of times the carrier was not present during the transmission.
output buffer failures Number of failed buffers.
output buffers swapped out Number of buffers swapped out.
Related Commands Command Description
service-module satellite status Displays status information related to the hardware and software on the
Cisco IP VSAT satellite WAN network module (NM-1VSAT-GILAT),
including the initial configuration parameters.
Cisco IOS Interface and Hardware Component Command Reference
1647
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces satellite
Command Description
show controllers satellite Displays controller information about the internal router interface that
connects to an installed Cisco IP VSAT satellite WAN network module
(NM-1VSAT-GILAT).
Cisco IOS Interface and Hardware Component Command Reference
1648
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces serial
show interfaces serial
To display information about a serial interface, use theshowinterfacesserial command in privileged EXEC
mode. When using Frame Relay encapsulation, use the showinterfacesserial command in user EXEC or
privileged EXEC mode to display information about the multicast data-link connection identifier (DLCI), the
DLCIs used on the interface, and the DLCI used for the Local Management Interface ( LMI).
Cisco 4000 Series
show interfaces serial accounting commandshow interfaces serial [number [: channel-group]]
[accounting]
Cisco 7200 Series
show interfaces serial [slot/port] [accounting]
Cisco 7000 and Cisco 7500 Series with the RSP7000, RSP7000CI, or Ports on VIPs
show interfaces serial [slot/port-adapter/port]
Cisco 7500 Series
show interfaces serial [slot/port [: channel-group]] [accounting]
Cisco 7500 Series with a CT3IP
show interfaces serial [slot/port-adapter/port] [: t1-channel] [{accounting|crb}]
Cisco AS5350 and Cisco AS5400 Universal Gateways
show interfaces serial slot/port
Cisco AS5800 Access Servers
show interfaces serial dial-shelf/slot/t3-port : t1-num : chan-group
Syntax Description number (Optional) Number of the port being displayed.
: channel-group (Optional) On the Cisco 4000 series with a Network Management Processor (NPM) or
the Cisco 7500 series routers with a MultiChannel Interface Processor (MIP), specifies
the T1 channel-group number in the range of 0 to 23 defined with the channel-group
controller configuration command.
accounting (Optional) Displays the number of packets of each protocol type that have been sent
through the interface.
slot (Optional) Number of the slot being displayed. Refer to the appropriate hardware manual
for slot and port information.
/ port (Optional) Number of the port being displayed. Refer to the appropriate hardware manual
for slot and port information.
/ port-adapter (Optional) Number of the port adapter being displayed. Refer to the appropriate hardware
manual for information about port adapter compatibility.
Cisco IOS Interface and Hardware Component Command Reference
1649
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces serial
: t1-channel (Optional) T1 channel number. For the CT3IP, the T1 channel is a number between 1
and 28.
T1 channels on the CT3IP are numbered 1 to 28 rather than the more traditional
zero-based scheme (0 to 27) used with other Cisco products. This scheme ensures
consistency with telco numbering schemes for T1 channels within channelized T3
equipment.
crb (Optional) Displays interface routing and bridging information.
dial-shelf Dial shelf chassis in the Cisco AS5800 access server that contains the CT3 interface
card.
slot Location of the CT3 interface card in the dial shelf chassis.
t3-port T3 port number. The only valid value is 0.
: t1-num T1 time slot in the T3 line. The value can be from 1 to 28.
: chan-group Channel group identifier.
Command Modes User EXEC (when Frame Relay encapsulation is used) Privileged EXEC
Command History Release Modification
10.0 This command was introduced on the Cisco 4000 series routers.
11.0 This command was implemented on the Cisco 7000 series routers.
11.1CA This command was modified to include sample output for the PA-2JT2, PA-E3, and PA-T3
serial port adapters.
11.3 This command was modified to include the CT3IP.
12.0(3)T This command was implemented on the Cisco AS5800 access servers.
12.0(4)T This command was modified to include enhanced display information for dialer bound
interfaces.
12.2(11)T This command was implemented on the Cisco AS5350 and Cisco AS5400.
12.2(13)T This command was modified to display information about Frame Relay interface queueing
and fragmentation.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines Frame Relay
Use this command to determine the status of the Frame Relay link. This display also indicates Layer 2 status
if switched virtual circuits (SVCs) are configured.
Channel Groups as Virtual Serial Interfaces
Cisco IOS Interface and Hardware Component Command Reference
1650
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces serial
To find out about channel groups configured as virtual serial interfaces, to verify that the router has High-Level
Data Link Control (HDLC) encapsulation on the interface, and to verify that the interface sees the loopback,
use the showinterfacesserial command in privileged EXEC mode.
Examples
Example of Synchronous Serial Interface
The following is sample output from the showinterfacesserial command for a synchronous serial
interface:
Router# show interfaces serial
Serial 0 is up, line protocol is up
Hardware is MCI Serial
Internet address is 192.168.10.203, subnet mask is 255.255.255.0
MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation HDLC, loopback not set, keepalive set (10 sec)
Last input 0:00:07, output 0:00:00, output hang never
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 0 bits/sec, 0 packets/sec
Five minute output rate 0 bits/sec, 0 packets/sec
16263 packets input, 1347238 bytes, 0 no buffer
Received 13983 broadcasts, 0 runts, 0 giants
2 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 2 abort
1 carrier transitions
22146 packets output, 2383680 bytes, 0 underruns
0 output errors, 0 collisions, 2 interface resets, 0 restarts
The table below describes significant fields shown in the display.
Table 144: show interfaces serial Field Descriptions--Synchronous Serial Interface
Field Description
Serial ... is {up | down} Indicates whether the interface hardware is currently active (whether carrier detect
... is administratively is present), is currently inactive, or has been taken down by an administrator.
down
line protocol is {up | Indicates whether the software processes that handle the line protocol consider
down} the line usable (that is, whether keepalives are successful) or whether the line has
been taken down by an administrator.
Hardware is Specifies the hardware type.
Internet address is Specifies the Internet address and subnet mask.
MTU Maximum transmission unit of the interface.
BW Indicates the value of the bandwidth parameter that has been configured for the
interface (in kbps). If the interface is attached to a serial line with a line speed that
does not match the default (1536 or 1544 kbps for T1 and 56 kbps for a standard
synchronous serial line), use the bandwidthcommand to specify the correct line
speed for this serial line.
DLY Delay of the interface, in microseconds.
Cisco IOS Interface and Hardware Component Command Reference
1651
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces serial
Field Description
rely Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes.
Encapsulation Encapsulation method assigned to interface.
loopback Indicates whether or not loopback is set.
keepalive Indicates whether or not keepalives are set.
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by an interface and processed locally on the router. Useful for knowing
when a dead interface failed. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
Last output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by an interface. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
output hang Number of hours, minutes, and seconds (or never) since the interface was last
reset because of a transmission that took too long. When the number of hours in
any of the “last” fields exceeds 24 hours, the number of days and hours is printed.
If that field overflows, asterisks are printed.
Output queue, drops Number of packets in output and input queues. Each number is followed by a
input queue, drops slash, the maximum size of the queue, and the number of packets dropped because
of a full queue.
5 minute input rate 5 Average number of bits and packets transmitted per second in the last 5 minutes.
minute output rate
The 5-minute input and output rates should be used only as an approximation of
traffic per second during a given 5-minute period. These rates are exponentially
weighted averages with a time constant of 5 minutes. A period of four time
constants must pass before the average will be within two percent of the
instantaneous rate of a uniform stream of traffic over that period.
packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the
main system. Compare with ignored count. Broadcast storms on Ethernet networks
and bursts of noise on serial lines are often responsible for no input buffer events.
Received... broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the medium.
Cisco IOS Interface and Hardware Component Command Reference
1652
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces serial
Field Description
giants Number of packets that are discarded because they exceed the maximum packet
size of the medium.
input errors Total number of no buffer, runts, giants, CRCs, frame, overrun, ignored, and abort
counts. Other input-related errors can also increment the count, so that this sum
might not balance with the other counts.
CRC Cyclic redundancy checksum generated by the originating station or far-end device
does not match the checksum calculated from the data received. On a serial link,
CRCs usually indicate noise, gain hits, or other transmission problems on the data
link.
frame Number of packets received incorrectly having a CRC error and a noninteger
number of octets. On a serial line, this is usually the result of noise or other
transmission problems.
overrun Number of times the serial receiver hardware was unable to hand received data
to a hardware buffer because the input rate exceeded the receiver’s ability to handle
the data.
ignored Number of received packets ignored by the interface because the interface hardware
ran low on internal buffers. Broadcast storms and bursts of noise can cause the
ignored count to be increased.
abort Illegal sequence of one bits on a serial interface. This usually indicates a clocking
problem between the serial interface and the data link equipment.
carrier transitions Number of times the carrier detect signal of a serial interface has changed state.
For example, if data carrier detect (DCD) goes down and comes up, the carrier
transition counter will increment two times. Indicates modem or line problems if
the carrier detect line is changing state often.
packets output Total number of messages transmitted by the system.
bytes output Total number of bytes, including data and MAC encapsulation, transmitted by the
system.
underruns Number of times that the transmitter has been running faster than the router can
handle. This might never be reported on some interfaces.
output errors Sum of all errors that prevented the final transmission of datagrams out of the
interface from being examined. Note that this might not balance with the sum of
the enumerated output errors because some datagrams can have more than one
error, and others can have errors that do not fall into any of the specifically
tabulated categories.
collisions Number of messages retransmitted because of an Ethernet collision. Some collisions
are normal. However, if your collision rate climbs to around 4 or 5 percent, you
should consider verifying that there is no faulty equipment on the segment and/or
moving some existing stations to a new segment. A packet that collides is counted
only once in output packets.
Cisco IOS Interface and Hardware Component Command Reference
1653
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces serial
Field Description
interface resets Number of times an interface has been completely reset. This can happen if packets
queued for transmission were not sent within several seconds’ time. On a serial
line, this can be caused by a malfunctioning modem that is not supplying the
transmit clock signal or by a cable problem. If the system notices that the carrier
detect line of a serial interface is up, but the line protocol is down, it periodically
resets the interface in an effort to restart it. Interface resets can also occur when
an interface is looped back or shut down.
restarts Number of times the controller was restarted because of errors.
alarm indications, remote Number of CSU/DSU alarms and number of occurrences of receive loss of frame
alarms, rx LOF, rx LOS and receive loss of signal.
BER inactive, NELR Status of G.703-E1 counters for bit-error rate (BER) alarm, near-end loop remote
inactive, FELR inactive (NELR), and far-end loop remote (FELR). Note that you cannot set the NELR or
FELR.
Example of PA-2JT2 Serial Interface
The following is sample output from the showinterfacesserial command for a PA-2JT2 serial
interface:
Router# show interfaces serial 3/0/0
Serial3/0/0 is up, line protocol is up
Hardware is cyBus Serial
Internet address is 10.0.0.1/8
MTU 1500 bytes, BW 6312 Kbit, DLY 20000 usec, rely 255/255, load 26/255
Encapsulation HDLC, loopback not set, keepalive not set
Last input 00:04:31, output 00:04:31, output hang never
Last clearing of “show interface” counters 00:06:07
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 162000 bits/sec, 8 packets/sec
5 minute output rate 162000 bits/sec, 8 packets/sec
20005 packets input, 20080520 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
20005 packets output, 20080520 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
0 carrier transitions
0 cv errors, 0 crc5 errors, 0 frame errors
rxLOS inactive, rxLOF inactive, rxPAIS inactive
rxAIS inactive, rxRAI inactive, rxHBER inactive
The table below describes significant fields shown in the display that are different from the fields
described in the table above.
Cisco IOS Interface and Hardware Component Command Reference
1654
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces serial
Table 145: show interfaces serial Field Descriptions--PA-2JT2
Field Description
Last clearing of “show interface” Time the counters were last cleared.
counters
Queueing strategy First-in, first-out queueing strategy (other queueing strategies that you
might see are priority-list, custom-list, and weighted fair).
output buffer failures Number of “no resource” errors received on the output.
output buffers swapped out Number of packets swapped to DRAM.
carrier transitions Number of times the carrier detect signal of a serial interface has changed
state. For example, if data carrier detect (DCD) goes down and comes
up, the carrier transition counter will increment two times. Indicates
modem or line problems if the carrier detect line is changing state often.
cv errors B8ZS/B6ZS (zero suppression) coding violation counter.
crc5 errors CRC-5 error counter.
frame errors Framing error counter.
rxLOS Receive loss of signal alarm. Values are active or inactive.
rxLOF Receive loss of frame alarm. Values are active or inactive.
rxPAIS Receive loss of payload alarm indication signal (AIS). Values are active
or inactive.
rxAIS Receive loss of physical AIS. Values are active or inactive.
rxRAI Receive remote AIS. Values are active or inactive.
rxHBER Receive high bit-error rate alarm. Values are active or inactive.
Example of PA-E3 Serial Port Adapter
The following is sample output from the showinterfacesserial command for a PA-E3 serial port
adapter installed in chassis slot 2:
Router# show interfaces serial 2/0
Serial2/0 is up, line protocol is up
Hardware is M1T-E3 pa
Internet address is 172.17.1.1/24
MTU 4470 bytes, BW 34010 Kbit, DLY 200 usec, rely 128/255, load 1/255
Encapsulation HDLC, loopback not set, keepalive not set
Last input 1w0d, output 00:00:48, output hang never
Last clearing of “show interface” counters 1w0d
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
Cisco IOS Interface and Hardware Component Command Reference
1655
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces serial
20 packets input, 2080 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants, 0 parity
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
11472 packets output, 3824748 bytes, 0 underruns
0 output errors, 0 applique, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
0 carrier transitions
rxLOS inactive, rxLOF inactive, rxAIS inactive
txAIS inactive, rxRAI inactive, txRAI inactive
Table 3 describes significant fields shown in the display that are different from the fields described
in Table 1.
Table 146: show interfaces serial Field Descriptions--PA-E3
Field Description
Last clearing of “show interface” Time the counters were last cleared.
counters
Queueing strategy First-in, first-out queueing strategy (other queueing strategies that you
might see are priority-list, custom-list, and weighted fair).
parity Number of the parity errors on the interface.
applique Indicates that an unrecoverable error has occurred on the E3 applique.
The router then invokes an interface reset.
output buffer failures Number of “no resource” errors received on the output.
output buffers swapped out Number of packets swapped to DRAM.
rxLOS, rxLOF, rxAIS Receive loss of signal, loss of frame, and alarm indication signal status.
Values are inactive or active.
txAIS, rxRAI, txRAI Transmit alarm indication signal, receive remote alarm indicator, and
transmit remote alarm indicator status. Values are inactive or active.
When the router receives an LOS, LOF, or AIS, the txRAI is active.
When the remote router receives an LOS, LOF, or AIS, the rxRAI is
active.
Example of 1-Port PA-T3 Serial Port Adapter Installed in a VIP2
The following is sample output from the showinterfacesserial command for a 1-port PA-T3 serial
port adapter installed in a VIP2 in chassis slot 1, in port adapter slot 0:
Router# show interfaces serial 1/0/0
Serial1/0/0 is up, line protocol is up
Hardware is cyBus PODS3 Serial
Internet address is 172.18.1.1/24
MTU 4470 bytes, BW 44736 Kbit, DLY 200 usec, rely 255/255, load 1/255
Encapsulation HDLC, loopback not set, keepalive set (10 sec)
Last input 00:00:05, output 00:00:02, output hang never
Last clearing of “show interface” counters 5d02h
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 27269 drops
Cisco IOS Interface and Hardware Component Command Reference
1656
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces serial
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
79039 packets input, 14195344 bytes, 0 no buffer
Received 84506 broadcasts, 0 runts, 0 giants
0 parity
9574 input errors, 6714 CRC, 0 frame, 1 overrun, 0 ignored, 2859 abort
62472 packets output, 13751644 bytes, 0 underruns
0 output errors, 0 applique, 10 interface resets
0 output buffer failures, 0 output buffers swapped out
16 carrier transitions
rxLOS inactive, rxLOF inactive, rxAIS inactive
txAIS inactive, rxRAI inactive, txRAI inactive
The table below describes significant fields shown in the display that are different from the fields
described in the tables above.
Table 147: show interfaces serial Field Descriptions--PA-T3
Field Description
Last clearing of “show interface” Time the counters were last cleared.
counters
Queueing strategy First-in, first-out queueing strategy (other queueing strategies that you
might see are priority-list, custom-list, and weighted fair).
parity Number of the parity errors on the interface.
applique Indicates that an unrecoverable error has occurred on the T3 applique.
The router then invokes an interface reset.
output buffer failures Number of “no resource” errors received on the output.
output buffers swapped out Number of packets swapped to DRAM.
rxLOS, rxLOF, rxAIS Receive loss of signal, loss of frame, and alarm indication signal status.
Values are inactive or active.
txAIS, rxRAI, txRAI Transmit alarm indication signal, receive remote alarm indicator, and
transmit remote alarm indicator status. Values are inactive or active.
When the router receives an LOS, LOF, or AIS, the txRAI is active.
When the remote router receives an LOS, LOF, or AIS, the rxRAI is
active.
Example of CT3IP Serial Interface
The following is sample output from the showinterfacesserial command for the CT3IP serial interface:
Router# show interfaces serial 3/0/0:25
Serial3/0/0:25 is up, line protocol is up
Hardware is cyBus T3
Internet address is 10.25.25.2/24
MTU 1500 bytes, BW 1536 Kbit, DLY 20000 usec, rely 255/255, load 12/255
Encapsulation HDLC, loopback not set, keepalive not set
Last input 00:19:01, output 00:11:49, output hang never
Last clearing of “show interface” counters 00:19:39
Cisco IOS Interface and Hardware Component Command Reference
1657
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces serial
Input queue: 0/75/0 (size/max/drops); Total output drops: 0
Queueing strategy: weighted fair
Output queue: 0/64/0 (size/threshold/drops)
Conversations 0/1 (active/max active)
Reserved Conversations 0/0 (allocated/max allocated)
5 minute input rate 69000 bits/sec, 90 packets/sec
5 minute output rate 71000 bits/sec, 90 packets/sec
762350 packets input, 79284400 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
150 input errors, 0 CRC, 0 frame, 150 overrun, 0 ignored, 0 abort
763213 packets output, 80900472 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
0 carrier transitions no alarm present
Timeslot(s) Used:1-24, Transmitter delay is 0 flags, transmit queue length 5
non-inverted data
The table below describes significant fields relevant to the CT3IP shown in the display that are
different from the fields described in the tables above.
Table 148: show interfaces serial Field Descriptions--CT3IP
Field Description
Timeslot(s) Used Number of time slots assigned to the T1 channel.
Transmitter delay Number of idle flags inserted between each HDLC frame.
transmit queue length Number of packets allowed in the transmit queue.
non-inverted data Indicates whether or not the interface is configured for inverted data.
Example of an HDLC Synchronous Serial Interface on a Cisco 7500 Series Router
The following is sample output from the showinterfacesserial command for an HDLC synchronous
serial interface on a Cisco 7500 series router:
Router# show interfaces serial 1/0
Serial1/0 is up, line protocol is up
Hardware is cxBus Serial
Internet address is 172.19.190.203, subnet mask is 255.255.255.0
MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation HDLC, loopback not set, keepalive set (10 sec)
Last input 0:00:07, output 0:00:00, output hang never
Last clearing of “show interface” counters 2w4d
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 0 bits/sec, 0 packets/sec
Five minute output rate 0 bits/sec, 0 packets/sec
16263 packets input, 1347238 bytes, 0 no buffer
Received 13983 broadcasts, 0 runts, 0 giants
2 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 2 abort
22146 packets output, 2383680 bytes, 0 underruns
0 output errors, 0 collisions, 2 interface resets, 0 restarts
1 carrier transitions
The tables above describes significant fields shown in the display.
Cisco IOS Interface and Hardware Component Command Reference
1658
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces serial
Example of HDLC Encapsulation
The following example displays High-Level Data Link Control (HDLC) encapsulation on serial
interface 0:
Router# show interfaces serial 0
Serial0 is up, line protocol is up (looped)
Hardware is HD64570
Internet address is 10.1.1.1, subnet mask is 255.255.255.0
MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation HDLC, loopback set, keepalive set (10 sec)
The tables above describes significant fields shown in the display.
Example of a G.703 Interface with Framing
The following is sample output from the showinterfacesserial command for a G.703 interface on
which framing is enabled:
Router# show interfaces serial 2/3
Serial2/3 is up, line protocol is up
Hardware is cxBus Serial
Internet address is 10.4.4.1, subnet mask is 255.255.255.0
MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation HDLC, loopback not set, keepalive not set
Last input 0:00:21, output 0:00:21, output hang never
Last clearing of “show interface” counters never
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 0 bits/sec, 0 packets/sec
Five minute output rate 0 bits/sec, 0 packets/sec
53 packets input, 7810 bytes, 0 no buffer
Received 53 broadcasts, 0 runts, 0 giants
2 input errors, 2 CRC, 0 frame, 0 overrun, 0 ignored, 2 abort
56 packets output, 8218 bytes, 0 underruns
0 output errors, 0 collisions, 2 interface resets, 0 restarts
1 carrier transitions
2 alarm indications, 333 remote alarms, 332 rx LOF, 0 rx LOS
RTS up, CTS up, DTR up, DCD up, DSR up
BER inactive, NELR inactive, FELR inactive
The tables above describes significant fields shown in the display.
Example with Frame Relay Encapsulation
When using Frame Relay encapsulation, use the showinterfacesserialcommand to display information
on the multicast data-link connection identifier (DLCI), the DLCI of the interface, and the DLCI
used for the local management interface (LMI).
The multicast DLCI and the local DLCI can be set using the frame-relaymulticast-dlci and
frame-relaylocal-dlci configuration commands. The status information is taken from the LMI, when
active.
The following is sample output from the showinterfacesserial command when Frame Relay
encapsulation and LMI are enabled:
Cisco IOS Interface and Hardware Component Command Reference
1659
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces serial
Router# show interfaces serial
Serial 2 is up, line protocol is up
Hardware type is MCI Serial
Internet address is 172.20.122.1, subnet mask is 255.255.255.0
MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation FRAME-RELAY, loopback not set, keepalive set (10 sec)
multicast DLCI 1022, status defined, active
source DLCI 20, status defined, active
LMI DLCI 1023, LMI sent 10, LMI stat recvd 10, LMI upd recvd 2
Last input 7:21:29, output 0:00:37, output hang never
Output queue 0/100, 0 drops; input queue 0/75, 0 drops
Five minute input rate 0 bits/sec, 0 packets/sec
Five minute output rate 0 bits/sec, 0 packets/sec
47 packets input, 2656 bytes, 0 no buffer
Received 5 broadcasts, 0 runts, 0 giants
5 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 57 abort
518 packets output, 391205 bytes
0 output errors, 0 collisions, 0 interface resets, 0 restarts
1 carrier transitions
In this display, the multicast DLCI has been changed to 1022 using the frame-relaymulticast-dlci
interface configuration command.
The display shows the statistics for the LMI as the number of status inquiry messages sent (LMI
sent), the number of status messages received (LMI recvd), and the number of status updates received
(upd recvd). Refer to the Frame Relay Interface specification for additional explanations of this
output.
Example with Frame Relay Queueing and Fragmentation at the Interface
The default mode for Frame Relay interfaces on serial SPAs is transparent mode. When FRF.12
configuration is applied to these SPA interfaces, then the SPA interface mode changes to end-to-end.
With end-to-end configuration on CEs, L2VPN cloud on GSR PEs can transparently forward the
FRF.12 fragments to remote CE by default. In case of L2VPN on Cisco 12000 series Internet router,
FRF.12 configuration should not be applied on the main or sub-interfaces of SPA interfaces. Otherwise
the FRF.12 fragments get dropped in ingress interface on SPA on the ingress PE.
For L3VPN to work on Cisco 12000 series Internet router, FRF.12 configuration needs to be applied
to the L3VPN SPA interface (main or sub-interface). L3VPN will not work without FRF.12
configuration.
L2VPN requires the SPA interface to be in transparent mode. L3VPN requires the SPA interface to
be in end-to-end mode. At physical interface level, either L2VPN or L3VPN works at a time. Both
L2VPN and L3VPN will not work simultaneously on a single physical interface. FRF.12 configuration
applied on a L3VPN sub-interface, changes the mode of the entire physical interface to end-to-end
and all L2VPN sub-interface traffic on this physical interface gets dropped.
If L2VPN circuits are already present on a SPA interface and FRF.12 configuration is applied on
this interface, then the following error message will be displayed to indicate FRF.12 fragment drops
on L2VPN circuits.
SLOT 3:2d08h: %GLCFR-3-FR_MODE: (bflc_fr_xdr_cmd_vc_status)FRF12 fragments will be
dropp
The following is sample output from the showinterfacesserial command when low-latency queueing
and FRF.12 end-to-end fragmentation are configured on a Frame Relay interface:
Cisco IOS Interface and Hardware Component Command Reference
1660
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces serial
Router# show interfaces serial 3/2
Serial3/2 is up, line protocol is up
Hardware is M4T
MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation FRAME-RELAY, crc 16, loopback not set
Keepalive set (10 sec)
LMI enq sent 0, LMI stat recvd 0, LMI upd recvd 0, DTE LMI up
LMI enq recvd 0, LMI stat sent 0, LMI upd sent 0
LMI DLCI 1023 LMI type is CISCO frame relay DTE
Fragmentation type: end-to-end, size 80, PQ interleaves 0
Broadcast queue 0/64, broadcasts sent/dropped 0/0, interface broadcasts 0
Last input 2d15h, output 2d15h, output hang never
Last clearing of "show interface" counters 00:01:31
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: weighted fair
Output queue: 0/1000/64/0 (size/max total/threshold/drops)
Conversations 0/0/256 (active/max active/max total)
Reserved Conversations 0/0 (allocated/max allocated)
Available Bandwidth 1094 kilobits/sec
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 packets output, 0 bytes, 0 underruns
0 output errors, 0 collisions, 1 interface resets
0 output buffer failures, 0 output buffers swapped out
1 carrier transitions DCD=up DSR=up DTR=up RTS=up CTS=up
The table below describes significant fields shown in the display that are different from the fields
described in the tables above.
Table 149: show interfaces serial Field Descriptions--Frame Relay Interface Queueing and Fragmentation
Field Description
txload Interface load in the transmit direction.
rxload Interface load in the receive direction.
crc Length the cyclic redundancy check (CRC) used on the interface.
LMI enq sent Number of Frame Relay status inquiry messages sent.
LMI stat recvd Number of Frame Relay status request messages received.
LMI upd recvd Number of single PVC asynchronous status messages received.
DTE LMI up LMI peers are synchronized.
LMI enq recvd Number of Frame Relay status inquiry messages received.
LMI stat sent Number of Frame Relay status request messages sent.
LMI upd sent Number of single PVC asynchronous status messages sent.
Fragmentation type Type of fragmentation: end-to-end, Cisco, or VoFR
Cisco IOS Interface and Hardware Component Command Reference
1661
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces serial
Field Description
size Fragmentation size.
PQ interleaves Number of priority queue frames that have interleaved data fragments.
Broadcast queue Number on queue/queue depth.
broadcasts sent/dropped Number of broadcasts sent and dropped.
interface broadcasts Number of broadcasts sent on interface.
Input queue size--Current size of the input queue. max--Maximum size of the queue.
drops--Number of messages discarded. flushes--Number of times that data on
queue has been discarded.
Queueing strategy Type of queueing configured on the interface.
Output queue size--Current size of the output queue. max total--Maximum number of frames
that can be queued. threshold--Congestive-discard threshold. Number of
messages in the queue after which new messages for high-bandwidth
conversations are dropped. drops--Number of dropped messages.
Conversations active--Number of currently active conversations. max active--Maximum number
of conversations that have ever occurred at one time. max total--Maximum
number of active conversations allowed.
throttles Number of times the receiver on the port was disabled, possibly because of
processor or buffer overload.
output buffer failures Number of “no resource” errors received on the output.
output buffers swapped out Number of packets swapped to DRAM.
Example with ANSI LMI
For a serial interface with the ANSI Local Management Interface (LMI) enabled, use the
showinterfacesserialcommand to determine the LMI type implemented. The following is sample
output from the showinterfacesserialcommand for a serial interface with the ANSI LMI enabled:
Router# show interfaces serial
Serial 1 is up, line protocol is up
Hardware is MCI Serial
Internet address is 172.18.121.1, subnet mask is 255.255.255.0
MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation FRAME-RELAY, loopback not set, keepalive set
LMI DLCI 0, LMI sent 10, LMI stat recvd 10
LMI type is ANSI Annex D
Last input 0:00:00, output 0:00:00, output hang never
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 0 bits/sec, 1 packets/sec
Five minute output rate 1000 bits/sec, 1 packets/sec
261 packets input, 13212 bytes, 0 no buffer
Cisco IOS Interface and Hardware Component Command Reference
1662
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces serial
Received 33 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
238 packets output, 14751 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets, 0 restarts
Notice that the showinterfacesserialoutput for a serial interface with ANSI LMI shown in this display
is very similar to that for encapsulation set to Frame Relay, as shown in the previous display. The
table below describes the few differences that exist.
Table 150: show interfaces serial Field Descriptions--ANSI LMI
Field Description
LMI DLCI 0 Identifies the DLCI used by the LMI for this interface. The default is 1023.
LMI sent 10 Number of LMI packets that the router sent.
LMI type is ANSI Annex D Indicates that the interface is configured for the ANSI-adopted Frame Relay
specification T1.617 Annex D.
Example with LAPB Encapsulation
Use the showinterfacesserialcommand to display operation statistics for an interface that uses Link
Access Procedure, Balanced (LAPB) encapsulation. The following is partial sample output from the
showinterfacesserial command for a serial interface that uses LAPB encapsulation:
Router# show interfaces serial 1
LAPB state is SABMSENT, T1 3000, N1 12056, N2 20, k7,Protocol ip
VS 0, VR 0, RCNT 0, Remote VR 0, Retransmissions 2
IFRAMEs 0/0 RNRs 0/0 REJs 0/0 SABMs 3/0 FRMRs 0/0 DISCs 0/0
The table below shows the fields relevant to all LAPB connections.
Table 151: show interfaces serial Field Descriptions--LAPB
Field Description
LAPB state is State of the LAPB protocol.
T1 3000, N1 12056, ... Current parameter settings.
Protocol Protocol encapsulated on a LAPB link; this field is not present on interfaces
configured for multiprotocol LAPB or X.25 encapsulations.
VS Modulo 8 frame number of the next outgoing information frame.
VR Modulo 8 frame number of the next information frame expected to be received.
RCNT Number of received information frames that have not yet been acknowledged.
Remote VR Number of the next information frame that the remote device expects to receive.
Retransmissions Count of current retransmissions because of expiration of T1.
Cisco IOS Interface and Hardware Component Command Reference
1663
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces serial
Field Description
Window is closed No more frames can be transmitted until some outstanding frames have been
acknowledged. This message should be displayed only temporarily.
IFRAMEs Count of information frames in the form of sent/received.
RNRs Count of Receiver Not Ready frames in the form of sent/received.
REJs Count of Reject frames in the form of sent/received.
SABMs Count of Set Asynchronous Balanced Mode commands in the form of sent/received.
FRMRs Count of Frame Reject frames in the form of sent/received.
DISCs Count of Disconnect commands in the form of sent/received.
Example with PPP Encapsulation
The output for an interface configured for synchronous PPP encapsulation differs from the standard
showinterfacesserial output. An interface configured for PPP might include the following information:
Router# show interfaces serial 1
lcp state = OPEN
ncp ipcp state = OPEN ncp osicp state = NOT NEGOTIATED
ncp ipxcp state = NOT NEGOTIATED ncp deccp state = NOT NEGOTIATED
ncp bridgecp state = NOT NEGOTIATED ncp atalkcp state = NOT NEGOTIATED
The table below show the fields relevant to PPP connections.
Table 152: show interfaces serial Field Descriptions--PPP Encapsulation
Field Description
lcp state Link Control Protocol.
ncp ipcp state Network Control Protocol Internet Protocol Control Protocol.
ncp osicp state Network Control Protocol OSI (CLNS) Control Protocol.
ncp ipxcp state Network Control Protocol IPX (Novell) Control Protocol.
ncp deccp state Network Control Protocol DECnet Control Protocol.
ncp bridgecp state Network Control Protocol Bridging Control Protocol.
ncp atalkcp state Network Control Protocol AppleTalk Control Protocol.
Example with SDLC Connections
Use the showinterfacesserialcommand to display the Synchronous Data Link Control (SDLC)
information for a given SDLC interface. The following is sample output from the
showinterfacesserialcommand for an SDLC primary interface that supports the SDLLC function:
Cisco IOS Interface and Hardware Component Command Reference
1664
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces serial
Router# show interfaces serial
Serial 0 is up, line protocol is up
Hardware is MCI Serial
MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation SDLC-PRIMARY, loopback not set
Timers (msec): poll pause 100 fair poll 500. Poll limit 1
[T1 3000, N1 12016, N2 20, K 7] timer: 56608 Last polled device: none
SDLLC [ma: 0000.0C01.14--, ring: 7 bridge: 1, target ring: 10
largest token ring frame 2052]
SDLC addr C1 state is CONNECT
VS 6, VR 3, RCNT 0, Remote VR 6, Current retransmit count 0
Hold queue: 0/12 IFRAMEs 77/22 RNRs 0/0 SNRMs 1/0 DISCs 0/0
Poll: clear, Poll count: 0, chain: p: C1 n: C1
SDLLC [largest SDLC frame: 265, XID: disabled]
Last input 00:00:02, output 00:00:01, output hang never
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 517 bits/sec, 30 packets/sec
Five minute output rate 672 bits/sec, 20 packets/sec
357 packets input, 28382 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
926 packets output, 77274 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets, 0 restarts
2 carrier transitions
The table below shows the fields relevant to all SDLC connections.
Table 153: show interfaces serial Field Descriptions--SDLC Enabled
Field Description
Timers (msec): poll pause, fair poll, Poll Current values of these timers for the primary SDLC interface.
limit
T1, N1, N2, K Values for these parameters for the primary SDLC interface.
The table below shows other data given for each SDLC secondary interface configured to be attached
to the serial interface.
Table 154: SDLC Secondary Interface Descriptions
Field Description
addr Address of this SDLC secondary interface.
Cisco IOS Interface and Hardware Component Command Reference
1665
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces serial
Field Description
state is Current state of this connection, which is one of the following:
• DISCONNECT--No communication is being attempted to this secondary.
• CONNECT--A normal connect state exists between this router and this
secondary.
• DISCSENT--This router has sent a disconnect request to this secondary and
is awaiting its response.
• SNRMSENT--This router has sent a connect request (SNRM) to this secondary
and is awaiting its response.
• THEMBUSY--This secondary has told this router that it is temporarily unable
to receive any more information frames.
• USBUSY--This router has told this secondary that it is temporarily unable to
receive any more information frames.
• BOTHBUSY--Both sides have told each other that they are temporarily unable
to receive any more information frames.
• ERROR--This router has detected an error and is waiting for a response from
the secondary acknowledging this.
VS Sequence number of the next information frame that this station sends.
VR Sequence number of the next information frame from this secondary that this station
expects to receive.
Remote VR Last frame transmitted by this station that has been acknowledged by the other
station.
Current retransmit Number of times the current I-frame or sequence of I-frames has been retransmitted.
count:
Hold Queue Number of frames in hold queue and maximum size of hold queue.
IFRAMEs, RNRs, Sent/received count for these frames.
SNRMs, DISCs
Poll “Set” if this router has a poll outstanding to the secondary; “clear” if it does not.
Poll Count Number of polls in a row that have been given to this secondary at this time.
Chain Shows the previous (p) and next (n) secondary address on this interface in the
roundrobinloop of polled devices.
Cisco IOS Interface and Hardware Component Command Reference
1666
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces serial
Example with SDLLC
Use the showinterfacesserialcommand to display the SDLLC statistics for SDLLC-configured
interfaces. The following is sample output from the showinterfacesserialcommand for a serial
interface configured for SDLLC:
Router# show interfaces serial
Serial 0 is up, line protocol is up
Hardware is MCI Serial
MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation SDLC-PRIMARY, loopback not set
Timers (msec): poll pause 100 fair poll 500. Poll limit 1
[T1 3000, N1 12016, N2 20, K 7] timer: 56608 Last polled device: none
SDLLC [ma: 0000.0C01.14--, ring: 7 bridge: 1, target ring: 10
largest token ring frame 2052]
SDLC addr C1 state is CONNECT
VS 6, VR 3, RCNT 0, Remote VR 6, Current retransmit count 0
Hold queue: 0/12 IFRAMEs 77/22 RNRs 0/0 SNRMs 1/0 DISCs 0/0
Poll: clear, Poll count: 0, chain: p: C1 n: C1
SDLLC [largest SDLC frame: 265, XID: disabled]
Last input 00:00:02, output 00:00:01, output hang never
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 517 bits/sec, 30 packets/sec
Five minute output rate 672 bits/sec, 20 packets/sec
357 packets input, 28382 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
926 packets output, 77274 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets, 0 restarts
6608 Last polled device: none
SDLLC [ma: 0000.0C01.14--, ring: 7 brid2 carrier transitions
Most of the output shown in the display is generic to all SDLC-encapsulated interfaces and is described
in the CiscoIOS Bridging and IBM Networking Command Reference , Volume 2 of 2: IBM Networking
. The table below shows the parameters specific to SDLLC.
Table 155: SDLLC Parameter Descriptions
Field Description
SDLLC ma Lists the MAC address configured for this interface. The last byte is shown as “--”
to indicate that it is filled in with the SDLC address of the connection.
ring, bridge, target ring Lists the parameters as configured by the sdllctraddrcommand.
largest token ring frame Shows the largest Token Ring frame that is accepted on the Logical Link control,
type 2 (LLC2) side of the connection.
largest SDLC frame Shows the largest SDLC frame that is accepted and will be generated on the SDLC
side of the connection.
XID Enabled or disabled: Shows whether XID processing is enabled on the SDLC side
of the connection. If enabled, it will show the XID value for this address.
Cisco IOS Interface and Hardware Component Command Reference
1667
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces serial
Example with X.25
The following is partial sample output from the showinterfacesserialcommand for a serial X.25
interface:
Router# show interfaces serial 1
X25 address 000000010100, state R1, modulo 8, idle 0, timer 0, nvc 1
Window size: input 2, output 2, Packet size: input 128, output 128
Timers: T20 180, T21 200, T22 180, T23 180, TH 0
Channels: Incoming-only none, Two-way 1-1024, Outgoing-only none
(configuration on RESTART: modulo 8,
Window size: input 2 output 2, Packet size: input 128, output 128
Channels: Incoming-only none, Two-way 5-1024, Outgoing-only none)
RESTARTs 3/2 CALLs 1000+2/1294+190/0+0/ DIAGs 0/0
The stability of the X.25 protocol requires that some parameters not be changed without a restart of
the protocol. Any change to these parameters is held until a restart is sent or received. If any of these
parameters changes, information about the router configuration at restart will be displayed as well
as the values that are currently in effect.
The table below describes significant fields shown in the display.
Table 156: show interfaces serial Field Descriptions--X.25 Enabled
Field Description
X25 address Address used to originate and accept calls.
state State of the interface. Possible values follow:
• R1 is the normal ready state.
• R2 is the DTE restarting state.
• R3 is the DCE restarting state.
If the state is R2 or R3, the interface is awaiting acknowledgment of a Restart
packet.
modulo Modulo value; determines the packet sequence numbering scheme used.
idle Number of minutes for which the Cisco IOS software waits before closing idle
virtual circuits that it originated or accepted.
timer Value of the interface timer, which is zero unless the interface state is R2 or R3.
nvc Default maximum number of simultaneous virtual circuits permitted to and from
a single host for a particular protocol.
Window size: input, output Default window sizes (in packets) for the interface. The x25facility interface
configuration command can be used to override these default values for the
switched virtual circuits originated by the router.
Packet size: input, output Default maximum packet sizes (in bytes) for the interface. The x25facility
interface configuration command can be used to override these default values
for the switched virtual circuits originated by the router.
Cisco IOS Interface and Hardware Component Command Reference
1668
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces serial
Field Description
Timers: Values of the X.25 timers:
• T10 through T13 for a DCE device
• T20 through T23 for a DTE device
TH Packet acknowledgment threshold (in packets). This value determines how many
packets are received before an explicit acknowledgment is sent. The default
value (0) sends an explicit acknowledgment only when the incoming window
is full.
Channels: Incoming-only, Displays the virtual circuit ranges for this interface.
Two-way, Outgoing-only
RESTARTs Shows Restart packet statistics for the interface using the format Sent/Received.
CALLs Successful calls sent + failed calls/calls received + calls failed/calls forwarded
+ calls failed. Calls forwarded are counted as calls sent.
DIAGs Diagnostic messages sent and received.
Example with Accounting Option
The following example illustrates the showinterfacesserial command with the accounting option
on a Cisco 7500 series routers:
Router# show interfaces serial 1/0 accounting
Serial1/0
Protocol Pkts In Chars In Pkts Out Chars Out
IP 7344 4787842 1803 1535774
Appletalk 33345 4797459 12781 1089695
DEC MOP 0 0 127 9779
ARP 7 420 39 2340
The table below describes thefields shown in the display.
Table 157: show interfaces serial Field Descriptions--Accounting
Field Description
Protocol Protocol that is operating on the interface.
Pkts In Number of packets received for that protocol.
Chars In Number of characters received for that protocol.
Pkts Out Number of packets transmitted for that protocol.
Chars Out Number of characters transmitted for that protocol.
Cisco IOS Interface and Hardware Component Command Reference
1669
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces serial
Example with Cisco AS5800 Access Server
The following example shows the activity that occurred on the serial interface in shelf 1, slot 4, port
0 for time slot 2 in group 23:
Router# show interfaces serial 1/4/0:2:23
Serial1/4/0:2:23 is up, line protocol is up (spoofing)
Hardware is DS-T1
MTU 1500 bytes, BW 64 Kbit, DLY 20000 usec, rely 255/255, load 1/255
Encapsulation HDLC, loopback not set
Last input 00:00:01, output 00:00:01, output hang never
Last clearing of "show interface" counters 22:24:30
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
5274 packets input, 20122 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
5274 packets output, 30836 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 output buffer failures, 0 output buffers swapped out
2 carrier transitions no alarm present
Timeslot(s) Used:24, subrate: 64Kb/s, transmit delay is 0 flags
The table below describes the significant fields shown in thedisplay that are different from the fields
described in the tables above.
Table 158: show interfaces serial Command Field Descriptions--Cisco AS5800
Field Description
Last clearing of “show interface” Time at which the counters that measure cumulative statistics (such
counters as number of bytes transmitted and received) were last reset to zero.
Queueing strategy Displays the type of queueing configured for this interface. In the
example output, the type of queueing configured is FIFO.
throttles Number of times that the receiver on the port was disabled, possibly
because of buffer or processor overload.
output buffer failures Number of times that the output buffer has failed.
output buffer swapped out Number of times that the output buffer has been swapped out.
Timeslot(s) Used Number of time slots assigned to the T1 channel.
subrate Bandwidth of each time slot.
transmit delay is ... Number of idle flags inserted between each frame.
Related Commands Command Description
show controllers serial Displays information about the virtual serial interface.
Cisco IOS Interface and Hardware Component Command Reference
1670
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces sm
show interfaces sm
To display status, traffic data, and configuration information about the SM-SRE service module interface, use
the showinterfacessm command in user EXEC or privileged EXEC mode.
show interfaces sm slot/port
Syntax Description slot Router slot in which the service module is installed. Range: 1 to 4.
/ port Port number of the module interface. The slash mark (/) is required.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
15.0(1)M This command was introduced.
Usage Guidelines The service module interface is the Gigabit Ethernet interface on the router that connects to the SM-SRE.
Examples The following example displays status, traffic data, and configuration information about the interface
to the SM-SRE installed in the router.
Router# show interfaces sm 1/0
SM1/0 is up, line protocol is up
Hardware is PSE2, address is 001e.4a97.644d (bia 001e.4a97.644d)
Internet address is 30.0.0.1/24
MTU 1500 bytes, BW 1000000 Kbit/sec, DLY 10 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation ARPA, loopback not set
Keepalive set (10 sec)
Full-duplex, 1000Mb/s, media type is internal
output flow-control is XON, input flow-control is XON
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:00:13, output 00:00:04, output hang never
Last clearing of "show interface" counters never
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue: 0/60 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
22 packets input, 1398 bytes, 0 no buffer
Received 3 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 watchdog, 0 multicast, 0 pause input
0 input packets with dribble condition detected
134 packets output, 42720 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets
0 unknown protocol drops
0 unknown protocol drops
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 0 no carrier, 0 pause output
0 output buffer failures, 0 output buffers swapped out
Cisco IOS Interface and Hardware Component Command Reference
1671
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces sm
The table below describes the significant fields shown in the display.
Table 159: show interfaces sm Field Descriptions
Field Description
Hardware, address Hardware type and address.
MTU Maximum transmission unit (MTU) of the service module interface.
BW Bandwidth of the interface, in kbps.
DLY Delay of the interface, in microseconds.
reliability Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
txload Transmit load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes.
rxload Receive load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes.
Encapsulation Encapsulation method assigned to the interface.
loopback Indicates whether or not loopback is set.
Keepalive Indicates whether or not keepalives are set and the interval between keepalives if
they have been set.
ARP type...ARP Type of Address Resolution Protocol (ARP) assigned and length of timeout.
Timeout
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by the interface and processed locally on the router. This field is useful
for detecting when a dead interface failed.
Note This field is not updated by fast-switched traffic.
output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by the interface. This field is useful for detecting when a dead interface
failed.
output hang Number of hours, minutes, and seconds (or never) since the interface was last reset
because a transmission took too long. When the number of hours in any of the “last”
fields exceeds 24 hours, the number of days and hours is printed. If that field
overflows, asterisks are printed.
Last clearing Time at which the counters that measure cumulative statistics (such as number of
bytes transmitted and received) shown in this report were last reset to zero. Note
that variables that might affect routing (for example, load and reliability) are not
cleared when the counters are cleared.
Asterisks (***) indicate that the elapsed time is too large to be displayed.
Cisco IOS Interface and Hardware Component Command Reference
1672
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces sm
Field Description
Input queue Number of packets in the input queue. Each number is followed by a slash, the
maximum size of the queue, the number of packets dropped because of a full queue,
and the number of times that queued packets have been discarded.
Total output drops Number of packets in the output queue that have been dropped because of a full
queue.
Queueing strategy Queueing strategy applied to the interface, which is configurable under the interface.
The default is FIFO (first-in, first-out).
Output queue Number of packets in the output queue, and the maximum size of the queue. Each
number is followed by a slash.
5 minute input rate, 5 Average number of bits and packets transmitted per second in the last 5 minutes.
minute output rate If the interface is not in promiscuous mode, it senses network traffic that it sends
and receives (rather than all network traffic).
The 5-minute input and output rates should be used only as an approximation of
traffic per second during a given 5-minute period. These rates are exponentially
weighted averages with a time constant of 5 minutes. A period of four time constants
must pass before the average will be within 2 percent of the instantaneous rate of
a uniform stream of traffic over that period.
Note The 5-minute period referenced in this output is a load interval that is
configurable under the interface. The default value is 5 minutes.
packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the
main system. Compare with ignored count. Broadcast storms on Ethernets and
bursts of noise on serial lines are often responsible for no input buffer events.
Received...broadcasts Number of broadcasts received.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the medium. For instance, any Ethernet packet that is less than 64
bytes is considered a runt.
giants Number of packets that are discarded because they exceed the maximum packet
size of the medium. For example, any Ethernet packet that is greater than 1518
bytes is considered a giant.
throttles Number of times that the interface requested another interface within the router to
slow down.
Cisco IOS Interface and Hardware Component Command Reference
1673
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces sm
Field Description
input errors Errors that include runts, giants, no buffer, cyclic redundancy checksum (CRC),
frame, overrun, and ignored counts. Other input-related errors can also cause the
input errors count to be increased, and some datagrams may have more than one
error; therefore, this sum may not balance with the sum of enumerated input error
counts.
CRC Errors created when the CRC generated by the originating LAN station or far-end
device does not match the checksum calculated from the data received. On a LAN,
this usually indicates noise or transmission problems on the LAN interface or the
LAN bus itself. A high number of CRCs is usually the result of collisions or a
station that is transmitting bad data.
frame Number of packets received incorrectly that have a CRC error and a noninteger
number of octets. On a LAN, this is usually the result of collisions or a
malfunctioning Ethernet device.
overrun Number of times that the receiver hardware was unable to hand received data to a
hardware buffer because the input rate exceeded the receiver’s ability to handle the
data.
ignored Number of received packets that were ignored by the interface because the interface
hardware ran low on internal buffers. These buffers are different from system buffer
space described. Broadcast storms and bursts of noise can cause the ignored count
to increase.
input packets with Number of packets with dribble condition. Dribble bit error indicates that a frame
dribble condition is slightly too long. This frame error counter is incremented just for informational
detected purposes; the router accepts the frame.
packets output Total number of messages that have been transmitted by the system.
bytes Total number of bytes, including data and MAC encapsulation, that have been
transmitted by the system.
underruns Number of times that the transmitter has run faster than the router could handle.
This may never be reported on some interfaces.
output errors Sum of all errors that prevented the final transmission of datagrams out of the
interface that is being examined. Note that this may not balance with the sum of
the enumerated output errors, because some datagrams may have more than one
error, and others may have errors that do not fall into any of the specifically tabulated
categories.
collisions Number of messages that have been retransmitted because of an Ethernet collision.
This is usually the result of an overextended LAN (Ethernet or transceiver cable
too long, more than two repeaters between stations, or too many cascaded multiport
transceivers). A packet that collides is counted only once in output packets.
Cisco IOS Interface and Hardware Component Command Reference
1674
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces sm
Field Description
interface resets Number of times an interface has been completely reset. This can happen if packets
that were queued for transmission were not sent within several seconds. On a serial
line, this can be caused by a malfunctioning modem that is not supplying the transmit
clock signal or by a cable problem. If the system notices that the carrier detect line
of a serial interface is up, but the line protocol is down, it periodically resets the
interface in an effort to restart it. Interface resets can also occur when an interface
is looped back or shut down.
babbles Count of frames greater than 1518 bytes that have been transmitted, indicating that
the transmitter has been on the interface longer than the time necessary to transmit
the largest frame.
late collision Number of late collisions. A collision becomes a late collision when it occurs after
the preamble has been transmitted.
deferred Deferred indicates that the chip, while ready to transmit a frame, had to defer because
the carrier was asserted.
lost carrier Number of times that the carrier was lost during transmission.
no carrier Number of times that the carrier was not present during the transmission.
output buffer failures, Number of failed buffers and number of buffers swapped out.
output buffers swapped
out
Related Commands Command Description
show controllers sm Displays controller information for the service module interface.
Cisco IOS Interface and Hardware Component Command Reference
1675
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces status
show interfaces status
To display the interface status or a list of interfaces in an error-disabled state on local area network (LAN)
ports only, use the showinterfacesstatus command in user EXEC or privileged EXEC mode.
show interfaces [interface interface-number] status [{err-disabled|module number|vlan vlan}]
Syntax Description interface (Optional) Interface type; possible valid values are ethernet, fastethernet,
gigabitethernet, tengigabitethernet, pos, atm, and ge-wan.
interface-number (Optional) Module and port number; see the “Usage Guidelines” section for valid values.
err-disabled (Optional) Displays the LAN ports in an error-disabled state.
module number (Optional) Specifies the module number; see the “Usage Guidelines” section for valid
values.
vlan vlan (Optional) Specifies a VLAN. Limits the display of switch port information to the
specified VLAN. Range: 1 to 4094.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17b)SXA This command was changed to include the packet-buffer error status in the
showinterfacesstatuserr-disabled output.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
This command was changed to include the type string of the receive-only transceivers.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SXI This command was changed to add the optional vlanvlan keyword and argument.
Usage Guidelines The interface-numberargument designates the module and port number. Valid values for interface-number
depend on the chassis and module that are used. For example, if you have a 48-port 10/100BASE-T Ethernet
module that is installed in a 13-slot chassis, valid values for the slot number are from 1 to 13 and valid values
for the port number are from 1 to 48.
This command is supported on LAN ports only.
The modulenumber keyword and argument designate the module number and limit the display to the interfaces
on the module. Valid values depend on the chassis that is used. For example, if you have a 13-slot chassis,
valid values for the module number are from 1 to 13.
To find out if an interface is inactive, enter the showinterfacesstatus command. If the interface is inactive,
the Status field displays “inactive.” If the port is not inactive, the Status field displays “none.”
Cisco IOS Interface and Hardware Component Command Reference
1676
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces status
To find the packet and byte count, you can enter the showinterfacescounters command or the show
interfacesinterfaceinterface-number status command. The showinterfacescounters command is the preferred
command to use. In some cases, the packet and byte count of the show interfacesinterfaceinterface-number
status command is incorrect.
Examples This example shows how to display the status of all LAN ports:
Router>
show interfaces status
Port Name Status Vlan Duplex Speed Type
Gi1/1 disabled routed full 1000 missing
Gi1/2 notconnect 1 full 1000 unknown (4)
Fa5/1 disabled routed auto auto 10/100BaseTX
.
.
.
Port Name Status Vlan Duplex Speed Type
Fa5/18 disabled 1 auto auto 10/100BaseTX
Fa5/19 disabled 1 auto auto 10/100BaseTX
Gi7/1 disabled 1 full 1000 WDM-RXONLY
Gi7/2 disabled 1 full 1000 No Transceiver
Router>
This example shows how to display the packet and byte count of a specific LAN port:
Router
> show interfaces fastethernet 5/2 status
FastEthernet5/2
Switching path Pkts In Chars In Pkts Out Chars Out
Processor 17 1220 20 2020
Route cache 0 0 0 0
Distributed cache 17 1220 206712817 2411846570
Total 34 2440 206712837 2411848590
Router>
This example shows how to display the status of LAN ports in an error-disabled state:
Router>
show interfaces status
err-disabled
Port Name Status Reason
Fa9/4 notconnect link-flap
informational error message when the timer expires on a cause
--------------------------------------------------------------
5d04h:%PM-SP-4-ERR_RECOVER:Attempting to recover from link-flap err-disable state on Fa9/4
Router>
Catalyst 6500 Series Switches
The following shows how to display the showinterfacesstatusfor VLAN 2:
Router# show interfaces status vlan 2
Cisco IOS Interface and Hardware Component Command Reference
1677
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces status
Related Commands Command Description
errdisable detect cause Enables the error-disable detection.
show errdisable recovery Displays the information about the error-disable recovery timer.
Cisco IOS Interface and Hardware Component Command Reference
1678
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces summary
show interfaces summary
To display a summary of statistics for one interface or for all interfaces that are configured on a networking
device, use the show interfaces summary command in privileged EXEC mode. For Cisco 7600 series
routers, the command can also be used in user EXEC mode.
show interfaces summary
Cisco 7600 Series
show interfaces [type number] summary [vlan]
Syntax Description type (Optional) Interface type; possible valid values are ethernet, fastethernet, gigabitethernet,
tengigabitethernet, pos, atm, and ge-wan.
number (Optional) Module and port number of the specified interface.
vlan (Optional) Displays the total number of VLAN interfaces .
Command Default This command has no default settings.
Command Modes Privileged EXEC. User EXEC (Cisco 7600 series only)
Command History Release Modification
12.2 This command was introduced.
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command was introduced on the Supervisor Engine 2.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
IOS XE Release This command was integrated into Cisco IOS XE Release 3.9S.
3.9S
Usage Guidelines Cisco 7600 Series
On a Cisco 7600 series router, you can display summary information for a single interface by specifying the
interface type and number. Separate counters for subinterfaces are not maintained and are not displayed in
the output.
Examples The following is sample output from the show interfaces summary command:
Router# show interfaces summary
*: interface is up
IHQ: pkts in input hold queue IQD: pkts dropped from input queue
OHQ: pkts in output hold queue OQD: pkts dropped from output queue
RXBS: rx rate (bits/sec) RXPS: rx rate (pkts/sec)
TXBS: tx rate (bits/sec) TXPS: tx rate (pkts/sec)
TRTL: throttle count
Interface IHQ IQD OHQ OQD RXBS RXPS TXBS TXPS TRTL
Cisco IOS Interface and Hardware Component Command Reference
1679
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces summary
----------------------------------------------------------------------
* FastEthernet0/0 0 0 0 0 0 0 0 0 0
Serial0/0 0 0 0 0 0 0 0 0 0
FastEthernet0/1 0 0 0 0 0 0 0 0 0
Serial0/1 0 0 0 0 0 0 0 0 0
NOTE:No separate counters are maintained for subinterfaces
Hence Details of subinterface are not shown.
This example shows how to display the total number of VLAN interfaces on a Cisco 7600 series
router:
Router# show interfaces summary vlan
Total number of Vlan interfaces: 7
Vlan interfaces configured:
1,5,20,2000,3000-3001,4000
Router#
This example shows how to display the total number of VLAN interfaces on a Cisco 7600 series
router:
Router# show interfaces summary vlan
Total number of Vlan interfaces: 7
Vlan interfaces configured:
1,5,20,2000,3000-3001,4000
Router#
This example shows how to display a summary of the interfaces on a Cisco 4400 Series Integrated
Services Router.
#show interfaces summary
*: interface is up
IHQ: pkts in input hold queue IQD: pkts dropped from input queue
OHQ: pkts in output hold queue OQD: pkts dropped from output queue
RXBS: rx rate (bits/sec) RXPS: rx rate (pkts/sec)
TXBS: tx rate (bits/sec) TXPS: tx rate (pkts/sec)
TRTL: throttle count
Interface IHQ IQD OHQ OQD RXBS RXPS
TXBS TXPS TRTL
-----------------------------------------------------------------------------------------------------------------
GigabitEthernet0/0/0 0 0 0 0 0 0
0 0 0
GigabitEthernet0/0/1 0 0 0 0 0 0
0 0 0
GigabitEthernet0/0/2 0 0 0 0 0 0
0 0 0
GigabitEthernet0/0/3 0 0 0 0 0 0
0 0 0
* Serial1/0/0 0 0 0 0 0 0
0 0 0
* GigabitEthernet0 0 0 0 0 31000 60
0 0 0
Cisco IOS Interface and Hardware Component Command Reference
1680
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces summary
Related Commands Command Description
show interfaces Displays the statistical information specific to interfaces.
show interfaces atm Displays information about the ATM interfaces.
show interfaces ethernet Displays information about the Ethernet interfaces.
show interfaces fastethernet Displays information about the Fast Ethernet interfaces.
show interfaces serial Displays information about the serial interfaces.
Cisco IOS Interface and Hardware Component Command Reference
1681
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces switchport
show interfaces switchport
To display the administrative and operational status of a switching (nonrouting) port, use the
showinterfacesswitchport command in user EXEC or privileged EXEC mode.
show interfaces [interface interface-number] switchport [brief] [module number]
Syntax Description interface (Optional) Interface type; possible valid values are ethernet, fastethernet,
gigabitethernet, tengigabitethernet, pos, atm, and ge-wan.
interface-number (Optional) Module and port number; see the “Usage Guidelines” section for valid values.
brief (Optional) Displays a brief summary of information.
module number (Optional) Limits the display to interfaces on a specified module; see the “Usage
Guidelines” section for valid values.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17a)SX The Administrative Trunking Encapsulation field was changed to dot1q EtherType.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(18)SXE This command was changed to include the brief keyword on the Supervisor Engine 720
only.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The interface-number designates the module and port number. Valid values depend on the chassis and module
that are used. For example, if you have a 48-port 10/100BASE-T Ethernet module that is installed in a 13-slot
chassis, valid values for the slot number are from 1 to 13 and valid values for the port number are from 1 to
48.
Examples This example shows how to display switch-port information using the include output modifier:
Router>
show interfaces switchport
| include VLAN
Name: Fa5/6
Access Mode VLAN: 200 (VLAN0200)
Trunking Native Mode VLAN: 1 (default)
Trunking VLANs Enabled: ALL
Pruning VLANs Enabled: ALL
.
.
Cisco IOS Interface and Hardware Component Command Reference
1682
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces switchport
.
Router>
This example shows how to display the configurations of two multiple VLAN access ports:
Router>
show interfaces switchport
Name: Fa5/1
Switchport: Enabled
Administrative Mode: access
Operational Mode: access
Dot1q Ethertype: 0x8200
Operational Trunking Encapsulation: dot1q
Negotiation of Trunking: off
Access Mode VLAN: 100
Voice VLAN: 102
Trunking Native Mode VLAN: 1 (default)
Administrative private-vlan host-association: none
Administrative private-vlan mapping: 900 ((Inactive)) 901 ((Inactive))
Operational private-vlan: none
Trunking VLANs Enabled: ALL
Pruning VLANs Enabled: 2-1001
Capture Mode Disabled
Capture VLANs Allowed: ALL
Name: Fa5/2
Switchport: Enabled
Administrative Mode: access
Operational Mode: down
Dot1q Ethertype: 0x8200
Operational Trunking Encapsulation: native
Negotiation of Trunking: Off
Access Mode VLAN: 100
Voice VLAN: 103 ((inactive))
Trunking Native Mode VLAN: 1 (default)
.
.
.
This example shows how to display a brief summary of information:
Router> show interfaces switchport
brief module 3
Port Status Op.Mode Op.Encap Channel-id Vlan
Fa3/1 connected access native -- 1
Fa3/7 disabled -- dot1q Po26 1
Fa3/13 connected access native -- 666
Router>
Related Commands Command Description
show interfaces Displays the status and statistics for the interfaces in the chassis.
Cisco IOS Interface and Hardware Component Command Reference
1683
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces switchport backup
show interfaces switchport backup
To display Flexlink pairs, use the showinterfacesswitchportbackup command in user EXEC or privileged
EXEC mode.
show interfaces [interface interface-number] switchport backup
Syntax Description interface (Optional) Interface type; possible valid values are ethernet, fastethernet,
gigabitethernet, tengigabitethernet, pos, atm, and ge-wan.
interface-number (Optional) Module and port number; see the “Usage Guidelines” section for valid values.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(18)SXF Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The interface-number designates the module and port number. Valid values depend on the chassis and module
that are used. For example, if you have a 48-port 10/100BASE-T Ethernet module that is installed in a 13-slot
chassis, valid values for the slot number are from 1 to 13 and valid values for the port number are from 1 to
48.
Examples This example shows how to display all Flexlink pairs:
Router> show interfaces switchport backup
Switch Backup Interface Pairs:
Active Interface Backup Interface State
------------------------------------------------------------------------
FastEthernet3/1 FastEthernet4/1 Active Up/Backup Standby
FastEthernet5/1 FastEthernet5/2 Active Down/Backup Up
FastEthernet3/2 FastEthernet5/4 Active Standby/Backup Up
Po1 Po2 Active Down/Backup Down
Router>
This example shows how to display a specific Flexlink port:
Router> show interfaces fastethernet 4/1 switchport backup
Switch Backup Interface Pairs:
Active Interface Backup Interface State
------------------------------------------------------------------------
FastEthernet3/1 FastEthernet4/1 Active Up/Backup Standby
Router>
Cisco IOS Interface and Hardware Component Command Reference
1684
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces switchport backup
Related Commands Command Description
switchport backup Configures an interface as a Flexlink backup interface.
Cisco IOS Interface and Hardware Component Command Reference
1685
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces tokenring
show interfaces tokenring
To display information about the Token Ring interface and the state of source route bridging, use the
showinterfacestokenring command in privileged EXEC mode.
Standard Syntax
show interfaces tokenring number [accounting]
Cisco 7200 and Cisco 7500 Series
show interfaces tokenring slot/port [accounting]
Cisco 7500 Series with Ports on VIPs
show interfaces tokenring [slot/port-adapter/port]
Syntax Description number Interface port line number.
accounting (Optional) Displays the number of packets of each protocol type that have been sent through
the interface.
slot On the Cisco 7000 series routers, slot location of the interface processor. On the Cisco
7000, the value can be 0, 1, 2, 3, or 4. On the Cisco 7010, the value can be 0, 1, or 2.
On the Cisco 7200 series routers, slot location of the port adapter; the value can be 1, 2,
3, 4, 5, or 6.
/ port Port number on the interface. On the Cisco 7000 series routers this argument is required,
and the values can be 0, 1, 2, or 3.
(Optional) For the VIP, this argument is optional, and the port value can be 0, 1, 2, or 3
for 4-port Token Ring interfaces.
On the Cisco 7200 series routers, the number depends on the type of port adapter installed.
/ port-adapter (Optional) On the Cisco 7000 series and Cisco 7500 series routers, specifies the ports on
a VIP. The value can be 0 or 1.
Command Modes Privileged EXEC
Command History Release Modification
10.0 This command was introduced.
11.3(3)T The information was modified to include the PA-4R-FDX full-duplex Token Ring port adapter.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Cisco IOS Interface and Hardware Component Command Reference
1686
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces tokenring
Usage Guidelines If you do not provide values for the slot and portarguments, the command displays statistics for all the network
interfaces. The optional accounting keyword displays the number of packets of each protocol type that have
been sent through the interface.
Examples The following is sample output from the showinterfacestokenring command:
Router# show interfaces tokenring
TokenRing 0 is up, line protocol is up
Hardware is 16/4 Token Ring, address is 5500.2000.dc27 (bia 0000.3000.072b)
Internet address is 10.136.230.203, subnet mask is 255.255.255.0
MTU 8136 bytes, BW 16000 Kbit, DLY 630 usec, rely 255/255, load 1/255
Encapsulation SNAP, loopback not set, keepalive set (10 sec)
ARP type: SNAP, ARP Timeout 4:00:00
Ring speed: 16 Mbps
Single ring node, Source Route Bridge capable
Group Address: 0x00000000, Functional Address: 0x60840000
Last input 0:00:01, output 0:00:01, output hang never
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 0 bits/sec, 0 packets/sec
Five minute output rate 0 bits/sec, 0 packets/sec
16339 packets input, 1496515 bytes, 0 no buffer
Received 9895 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
32648 packets output, 9738303 bytes, 0 underruns
0 output errors, 0 collisions, 2 interface resets, 0 restarts
5 transitions
The table below describes the significant fields shown in the displays.
Table 160: show interfaces tokenring Field Descriptions
Field Description
Token Ring is {up | down} Interface is either currently active and inserted into ring (up) or inactive and not
inserted (down).
On the Cisco 7500 series routers, gives the interface processor type, slot number,
and port number.
Token Ring is Reset Hardware error has occurred.
Token Ring is Initializing Hardware is up, in the process of inserting the ring.
Token Ring is Hardware has been taken down by an administrator.
Administratively Down
line protocol is {up | down Indicates whether the software processes that handle the line protocol believe
| administratively down} the interface is usable (that is, whether keepalives are successful).
Hardware Hardware type. “Hardware is Token Ring” indicates that the board is a CSC-R
board. “Hardware is 16/4 Token Ring” indicates that the board is a CSC-R16
board. Also shows the address of the interface.
Internet address Lists the Internet address followed by subnet mask.
MTU Maximum transmission unit of the interface.
Cisco IOS Interface and Hardware Component Command Reference
1687
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces tokenring
Field Description
BW Bandwidth of the interface, in kilobits per second.
DLY Delay of the interface, in microseconds.
rely Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes.
Encapsulation Encapsulation method assigned to interface.
loopback Indicates whether loopback is set or not.
keepalive Indicates whether keepalives are set or not.
ARP type Type of Address Resolution Protocol assigned.
Ring speed Speed of Token Ring--4 or 16 Mbps.
{Single ring | multiring Indicates whether a node is enabled to collect and use source routing information
node} (RIF) for routable Token Ring protocols.
Group Address Interface’s group address, if any. The group address is a multicast address; any
number of interfaces on the ring may share the same group address. Each interface
may have at most one group address.
Functional Address: Bit-significant group address. Each “on” bit represents a function performed by
the station.
Ethernet Transit OUI: The Organizational Unique Identifier (OUI) code to be used in the encapsulation
of Ethernet Type II frames across Token Ring backbone networks.
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by an interface and processed locally on the router. Useful for knowing
when a dead interface failed. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
Last output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by an interface. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
output hang Number of hours, minutes, and seconds (or never) since the interface was last
reset because of a transmission that took too long. When the number of hours in
any of the “last” fields exceeds 24 hours, the number of days and hours is printed.
If that field overflows, asterisks are printed.
Cisco IOS Interface and Hardware Component Command Reference
1688
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces tokenring
Field Description
Last clearing Time at which the counters that measure cumulative statistics (such as number
of bytes transmitted and received) shown in this report were last reset to zero.
Note that variables that might affect routing (for example, load and reliability)
are not cleared when the counters are cleared.
*** indicates the elapsed time is too large to be displayed.
0:00:00 indicates the counters were cleared more than 231 ms (and less than 232
ms) ago.
Output queue, drops Input Number of packets in output and input queues. Each number is followed by a
queue, drops slash, the maximum size of the queue, and the number of packets dropped because
of a full queue.
Five minute input rate, Average number of bits and packets transmitted per second in the last 5 minutes.
Five minute output rate
The 5-minute input and output rates should be used only as an approximation
of traffic per second during a given 5-minute period. These rates are exponentially
weighted averages with a time constant of 5 minutes. A period of four time
constants must pass before the average will be within two percent of the
instantaneous rate of a uniform stream of traffic over that period.
packets input Total number of error-free packets received by the system.
bytes input Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the
main system. Compare with ignored count. Broadcast storms on Ethernet
networks and bursts of noise on serial lines are often responsible for no input
buffer events.
broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the medium.
giants Number of packets that are discarded because they exceed the of them medium
maximum packet size.
CRC Cyclic redundancy checksum generated by the originating LAN station or far-end
device does not match the checksum calculated from the data received. On a
LAN, this usually indicates noise or transmission problems on the LAN interface
or the LAN bus itself. A high number of CRCs is usually the result of a station
transmitting bad data.
frame Number of packets received incorrectly having a CRC error and a noninteger
number of octets.
overrun Number of times the serial receiver hardware was unable to hand received data
to a hardware buffer because the input rate exceeded the receiver’s ability to
handle the data.
Cisco IOS Interface and Hardware Component Command Reference
1689
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces tokenring
Field Description
ignored Number of received packets ignored by the interface because the interface
hardware ran low on internal buffers. These buffers are different than the system
buffers mentioned previously in the buffer description. Broadcast storms and
bursts of noise can cause the ignored count to be increased.
packets output Total number of messages transmitted by the system.
bytes output Total number of bytes, including data and MAC encapsulation, transmitted by
the system.
underruns Number of times that the far-end transmitter has been running faster than the
near-end router’s receiver can handle. This may never be reported on some
interfaces.
output errors Sum of all errors that prevented the final transmission of datagrams out of the
interface being examined. Note that this may not balance with the sum of the
enumerated output errors, as some datagrams may have more than one error,
and others may have errors that do not fall into any of the specifically tabulated
categories.
collisions Since a Token Ring cannot have collisions, this statistic is nonzero only if an
unusual event occurred when frames were being queued or dequeued by the
system software.
interface resets Number of times an interface has been reset. The interface may be reset by the
administrator or automatically when an internal error occurs.
restarts Should always be zero for Token Ring interfaces.
transitions Number of times the ring made a transition from up to down, or vice versa. A
large number of transitions indicates a problem with the ring or the interface.
The following is sample output from the showinterfacestokenring command on a Cisco 7500 series
routers:
Router# show interfaces tokenring 2/0
TokenRing2/0 is administratively down, line protocol is down
Hardware is cxBus Token Ring, address is 0000.3040.8b4a (bia 0000.3040.8b4a)
MTU 8136 bytes, BW 16000 Kbit, DLY 630 usec, rely 255/255, load 1/255
Encapsulation SNAP, loopback not set, keepalive set (10 sec)
ARP type: SNAP, ARP Timeout 4:00:00
Ring speed: 0 Mbps
Single ring node, Source Route Transparent Bridge capable
Ethernet Transit OUI: 0x0000F8
Last input never, output never, output hang never
Last clearing of “show interface” counters never
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
Five minute input rate 0 bits/sec, 0 packets/sec
Five minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 packets output, 0 bytes, 0 underruns
Cisco IOS Interface and Hardware Component Command Reference
1690
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces tokenring
0 output errors, 0 collisions, 1 interface resets, 0 restarts
1 transitions
The following example on the Cisco 7500 series routers includes the accounting option. When you
use the accounting option, only the accounting statistics are displayed.
Router# show interfaces tokenring 2/0 accounting
TokenRing2/0
Protocol Pkts In Chars In Pkts Out Chars Out
IP 7344 4787842 1803 1535774
Appletalk 33345 4797459 12781 1089695
DEC MOP 0 0 127 9779
ARP 7 420 39 2340
The table below describes thefields shown in the display.
Table 161: show interfaces tokenring Field Descriptions--Accounting
Field Description
Protocol Protocol that is operating on the interface.
Pkts In Number of packets received for that protocol.
Chars In Number of characters received for that protocol.
Pkts Out Number of packets transmitted for that protocol.
Chars Out Number of characters transmitted for that protocol.
Cisco IOS Interface and Hardware Component Command Reference
1691
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces transceiver
show interfaces transceiver
To display information about the optical transceivers that have digital optical monitoring (DOM) enabled,
use the showinterfacestransceiver command in privileged EXEC mode.
Catalyst 6500 Series Switches and Cisco 7600 Series Routers
show interfaces [interface interface-number] transceiver [{threshold violations|properties}]
[{detail|module number}]
Cisco 7200 VXR
show interfaces [interface interface-number] transceiver
Cisco ASR 901 Routers
show interfaces [interface interface-number] transceiver [{threshold {table |violations} |detail
|supported-list}]
Cisco ASR 1000 Routers
show interfaces transceiver
Syntax Description interface (Optional) Interface type; possible valid values are gigabitethernet and
tengigabitethernet.
interface-number Module and port number; see the “Usage Guidelines” section for valid
values.
threshold violations (Optional) Displays information about the interface transceiver threshold
violations.
properties (Optional) Displays information about the port speed and duplex
autonegotiation status.
detail (Optional) Displays detailed information about the interface transceiver.
module number (Optional) Specifies the module number; see the “Usage Guidelines” section
for valid values.
threshold {table | (Optional) Displays information about the transceiver threshold.
violations}
• table—Displays the alarm and warning threshold table.
• violations—Displays the alarm and warning threshold violations.
supported-list (Optional) Displays a list of all supported DOM transceivers.
Command Default This command has no default settings.
Command Modes Privileged EXEC (#)
Cisco IOS Interface and Hardware Component Command Reference
1692
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces transceiver
Command History Release Modification
12.2(17d)SXB2 Support for this command was introduced on the Supervisor Engine 720
and the Supervisor Engine 2.
12.2(18)SXE This command was changed to support DOM for GBICs and XENPAKs.
12.4(15)T This command was integrated into Cisco IOS Release 12.4(15)T for the
Cisco 7200 VXR with the NPE-G2 network processing engine.
12.2(33)SXI This command was changed to display the port speed and duplex
autonegotiation status
15.2(2)SNI This command was implemented on the Cisco ASR 901 Series Aggregation
Services Routers.
Cisco IOS XE Gibraltar 16.10.1 This command was implemenred on the Cisco ASR 1000 Series Aggregation
Services Routers.
Usage Guidelines After a transceiver is inserted, the software waits approximately 10 seconds before reading the diagnostic
monitoring information. If you enter the showinterfacestransceiver command before the software has read
the diagnostic monitoring information, the following message is displayed:
Waiting for diagnostic monitoring information to settle down.
Please try again after a few seconds.
Wait a few seconds and re-enter the showinterfacestransceiver command.
The interfaceinterface-number arguments are supported on interfaces that have a transceiver that has diagnostic
monitoring enabled and the transceiver is in a module that supports the reading of diagnostic monitoring
information. The transceiver periodically polls operating conditions such as temperature and power levels.
The show interfaces transceiver command allows the router to display these operating conditions while the
transceiver is in service.
Examples This example shows how to display transceiver information:
Router# show interfaces transceiver
If device is externally calibrated, only calibrated values are printed.
++ : high alarm, + : high warning, - : low warning, -- : low alarm.
NA or N/A: not applicable, Tx: transmit, Rx: receive.
mA: milliamperes, dBm: decibels (milliwatts).
Optical Optical
Temperature Voltage Current Tx Power Rx Power
Port (Celsius) (Volts) (mA) (dBm) (dBm)
------- ----------- ------- -------- -------- --------
Gi1/1 40.6 5.09 0.4 -25.2 N/A
Gi2/1 35.5 5.05 0.1 -29.2 N/A
Gi2/2 49.5 3.30 0.0 7.1 -18.7
This example shows how to display detailed transceiver information:
Router# show interfaces transceiver detail
mA: milliamperes, dBm: decibels (milliwatts), NA or N/A: not applicable.
++ : high alarm, + : high warning, - : low warning, -- : low alarm.
A2D readouts (if they differ), are reported in parentheses.
The threshold values are calibrated.
Cisco IOS Interface and Hardware Component Command Reference
1693
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces transceiver
High Alarm High Warn Low Warn Low Alarm
Temperature Threshold Threshold Threshold Threshold
Port (Celsius) (Celsius) (Celsius) (Celsius) (Celsius)
------- ------------------ ---------- --------- --------- ---------
Gi1/1 48.1 100.0 100.0 0.0 0.0
Gi1/2 34.9 100.0 100.0 0.0 0.0
Gi2/1 43.5 70.0 60.0 5.0 0.0
Gi2/2 39.1 70.0 60.0 5.0 0.0
High Alarm High Warn Low Warn Low Alarm
Voltage Threshold Threshold Threshold Threshold
Port (Volts) (Volts) (Volts) (Volts) (Volts)
------- --------------- ---------- --------- --------- ---------
Gi1/1 3.30 6.50 6.50 N/A N/A
Gi1/2 3.30 6.50 6.50 N/A N/A
Gi2/1 5.03 5.50 5.25 4.75 4.50
Gi2/2 5.02 5.50 5.25 4.75 4.50
High Alarm High Warn Low Warn Low Alarm
Current Threshold Threshold Threshold Threshold
Port (milliamperes) (mA) (mA) (mA) (mA)
------- ----------------- ---------- --------- --------- ---------
Gi1/1 0.0 130.0 130.0 N/A N/A
Gi1/2 1.7 130.0 130.0 N/A N/A
Gi2/1 50.6 + 60.0 40.0 10.0 5.0
Gi2/2 25.8 60.0 40.0 10.0 5.0
Optical High Alarm High Warn Low Warn Low Alarm
Transmit Power Threshold Threshold Threshold Threshold
Port (dBm) (dBm) (dBm) (dBm) (dBm)
------- ----------------- ---------- --------- --------- ---------
Gi1/1 8.1 ++ 8.1 8.1 N/A N/A
Gi1/2 -9.8 8.1 8.1 N/A N/A
Gi2/1 -16.7 -- 3.4 3.2 -0.3 -0.5
Gi2/2 0.8 3.4 3.2 -0.3 -0.5
Optical High Alarm High Warn Low Warn Low Alarm
Receive Power Threshold Threshold Threshold Threshold
Port (dBm) (dBm) (dBm) (dBm) (dBm)
------- ----------------- ---------- --------- --------- ---------
Gi1/1 N/A 8.1 8.1 N/A N/A
Gi1/2 -30.9 8.1 8.1 N/A N/A
Gi2/1 N/A 5.9 -6.7 -28.5 -28.5
Gi2/2 N/A 5.9 -6.7 -28.5 -28.5
This example shows how to display the threshold violations for all the transceivers on a Cisco 7600
series router:
Router# show interfaces transceiver threshold violations
Rx: Receive, Tx: Transmit.
DDDD: days, HH: hours, MM: minutes, SS: seconds
Time since Last Known
Time in slot Threshold Violation Type(s) of Last Known
Port (DDDD:HH:MM:SS) (DDDD:HH:MM:SS) Threshold Violation(s)
------- --------------- ---------------------- ----------------------
Gi1/1 0000:00:03:41 Not applicable Not applicable
Gi2/1 0000:00:03:40 0000:00:00:30 Tx bias high warning
50.5 mA > 40.0 mA
0000:00:00:30 Tx power low alarm
-17.0 dBm < -0.5 dBm
Gi2/2 0000:00:03:40 Not applicable Not applicable
This example shows how to display the threshold violations for all the transceivers on a Catalyst
6500 series switch:
Router# show interfaces transceiver threshold violations
Rx: Receive, Tx: Transmit.
Cisco IOS Interface and Hardware Component Command Reference
1694
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces transceiver
DDDD: days, HH: hours, MM: minutes, SS: seconds
Time since Last Known
Time in slot Threshold Violation Type(s) of Last Known
Port (DDDD:HH:MM:SS) (DDDD:HH:MM:SS) Threshold Violation(s)
------- --------------- ---------------------- ----------------------
Gi1/1 0000:00:03:41 Not applicable Not applicable
Gi2/1 0000:00:03:40 0000:00:00:30 Tx bias high warning
50.5 mA > 40.0 mA
0000:00:00:30 Tx power low alarm
-17.0 dBm < -0.5 dBm
Gi2/2 0000:00:03:40 Not applicable Not applicable
Router#
This example shows how to display the threshold violations for all transceivers on a specific module:
Router# show interfaces transceiver threshold violations module 2
lo: low, hi: high, warn: warning
DDDD: days, HH: hours, MM: minutes, SS: seconds
Time since Last Known
Time in slot Threshold Violation Type(s) of Last Known
Port (DDDD:HH:MM:SS) (DDDD:HH:MM:SS) Threshold Violation
------- -------------- ---------------------- ----------------------
Gi2/1 0000:00:03:40 0000:00:00:30 Tx bias high warning
50.5 mA > 40.0 mA
0000:00:00:30 Tx power low alarm
-17.0 dBm < -0.5 dBm
Gi2/2 0000:00:03:40 Not applicable Not applicable
This example shows how to display violations for the transceiver on a specific interface:
Router# show interfaces Gi2/1 transceiver threshold violations
Rx: Receive, Tx: Transmit.
DDDD: days, HH: hours, MM: minutes, SS: seconds
Time since Last Known
Time in slot Threshold Violation Type(s) of Last Known
Port (DDDD:HH:MM:SS) (DDDD:HH:MM:SS) Threshold Violation(s)
------- --------------- ---------------------- ----------------------
Gi2/1 0000:00:03:40 0000:00:00:30 Tx bias high warning
50.5 mA > 40.0 mA
0000:00:00:30 Tx power low alarm
-17.0 dBm < -0.5 dBm
This example shows how to display the port speed and duplex autonegotiation status:
Router# show interfaces transceiver properties module 1
Name : Fa1/1
Administrative Speed Negotiation: Enable
Administrative Duplex Negotiation: Enable
Name : Fa1/2
Administrative Speed Negotiation: Disable
Administrative Duplex Negotiation: Enable
Name : Fa1/2
Administrative Speed Negotiation: Disable
Administrative Duplex Negotiation: Disable
Router#
This example shows how to use the show transceiver command on ASR 1000
The Transceiver in slot 1 subslot 0 port 0 is enabled.
Module temperature = +33.238 C [Range: +0.000 to +70.000 C]
Transceiver Tx supply voltage = 3.2942 Volts [Range: 3.1350 to 3.4650 Volts]
Transceiver Tx power = -4.1 dBm
Transceiver Rx optical power = -6.2 dBm
Cisco IOS Interface and Hardware Component Command Reference
1695
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces transceiver
Tx power Network Lane[00] = -2.3 dBm (0.5824 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[01] = -2.1 dBm (0.6178 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[02] = -2.0 dBm (0.6359 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[03] = -1.9 dBm (0.6531 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[04] = -2.4 dBm (0.5821 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[05] = -2.0 dBm (0.6319 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[06] = -2.0 dBm (0.6268 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[07] = -1.9 dBm (0.6511 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[08] = -2.2 dBm (0.6076 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[09] = -2.1 dBm (0.6153 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[10] = -40.0 dBm (0.0 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[11] = -40.0 dBm (0.0 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[12] = -40.0 dBm (0.0 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[13] = -40.0 dBm (0.0 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[14] = -40.0 dBm (0.0 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[15] = -40.0 dBm (0.0 in units of mW) [Range:-7.6 to -0.5 dBm]
Rx power Network Lane[00] = -4.3 dBm (0.3697 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[01] = -3.7 dBm (0.4309 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[02] = -5.3 dBm (0.2959 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[03] = -3.2 dBm (0.4826 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[04] = -6.6 dBm (0.2175 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[05] = -4.0 dBm (0.4012 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[06] = -3.9 dBm (0.4062 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[07] = -4.7 dBm (0.3423 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[08] = -3.5 dBm (0.4444 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[09] = -3.1 dBm (0.4895 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[10] = -40.0 dBm (0.0 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[11] = -40.0 dBm (0.0 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[12] = -40.0 dBm (0.0 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[13] = -40.0 dBm (0.0 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[14] = -40.0 dBm (0.0 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[15] = -40.0 dBm (0.0 in units of mW) [Range:-9.5 to 2.4 dBm]
Bias Current Network Lane[00] = 6.216 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[01] = 5.756 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[02] = 6.304 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[03] = 6.224 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[04] = 6.194 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[05] = 6.84 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[06] = 6.196 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[07] = 6.222 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[08] = 6.208 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[09] = 5.556 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[10] = 0.0 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[11] = 0.0 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[12] = 0.0 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[13] = 0.0 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[14] = 0.0 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[15] = 0.0 (in units of mA) [Range:0.0 to 43.520 mA]
IDPROM for transceiver HundredGigE1/0/0:
Description = CPAK optics (type 131)
Transceiver Type: = CPAK 100GE SR10 (313)
Product Identifier (PID) = CPAK-100G-SR10
Vendor Revision = 01
Serial Number (SN) = FBN181720831
Vendor Name = CISCO
Vendor OUI (IEEE company ID) = 00.00.0C (12)
CLEI code = WOTRC5PBAA
Cisco part number = 800-41495-
Device State = Enabled.
Date code (yyyy/mm/dd) = 2014/04/24
Connector type = MPO.
Encoding = NRZ, Non-PSK.
Bit Rate = 111.8 Gbps
Maximum Bit Rate Network Lane = 11.2 Gbits/s
Cisco IOS Interface and Hardware Component Command Reference
1696
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces transceiver
Maximum Bit Rate Host Lane = 11.2 Gbits/s
The Transceiver in slot 1 subslot 1 port 0 is enabled.
Module temperature = +43.578 C [Range: 0 to 70 C]
Transceiver Tx supply voltage = 3287.5 mVolts [Range: 3135.0 to 3465.0 mVolts]
Transceiver Tx bias current = 7710 uAmps [Range: 5000 to 10800 uAmps]
Transceiver Tx power = -2.0 dBm [Range: -7.3 to -1.3 dBm]
Transceiver Rx optical power = -2.0 dBm [Range:-9.9 to -1.0 dBm]
IDPROM for transceiver TenGigabitEthernet1/1/0:
Description = SFP+ optics (type 130)
Transceiver Type: = SFP+ 10GBASE-SR (273)
Product Identifier (PID) = SFP-10G-SR
Vendor Revision = A
Serial Number (SN) = FNS173814XB
Vendor Name = CISCO-FINISAR
Vendor OUI (IEEE company ID) = 00.90.65 (36965)
CLEI code = COUIA8NCAA
Cisco part number = 10-2415-03
Device State = Enabled.
Date code (yy/mm/dd) = 13/09/17
Connector type = LC.
Encoding = 64B66B
Nominal bitrate = 10GE (10300 Mbits/s)
Minimum bit rate as % of nominal bit rate = not specified
Maximum bit rate as % of nominal bit rate = not specified
Cisco ASR 901 Routers
show interfaces [interface interface-number] transceiver [{threshold {table |violations}
|detail |supported-list}]
Cisco 7200 VXR
This example shows static information and current status information for the transceiver. The static
information is a description of the transceiver and its physical capabilities, which is provided by the
manufacturer in EEPROM. The status information shows current operating conditions, as well as
alarm and warning threshold ranges.
Alarms indicate conditions that might be associated with a non-operational link and are cause for
immediate action. Warnings indicate conditions outside the normally guaranteed ranges but are not
necessarily causes of immediate link failures. Certain warnings can also be defined by the manufacturer
as end-of-life indicators, such as higher than expected bias currents in a constant power control loop.
In this example, the fiber optic cable is disconnected and the appropriate alarms and warnings are
displayed.
Router# show interfaces g0/3 transceiver
Static information
ID: SFP transceiver
Extended ID: 4
Connector: LC
SONET compliance: unspecified
Gigabit Ethernet compliance: 1000BASE-SX
Fibre Channel link length: unspecified
Fibre Channel transmitter technology: unspecified
Fibre Channel transmission media: unspecified
Fibre Channel speed: unspecified
Encoding: 8B10B
Bit Rate: 1300 Mbps
50 micron-multimode fiber supported length: 550 m
Cisco IOS Interface and Hardware Component Command Reference
1697
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces transceiver
62.5 micron-multimode fiber supported length: 270 m
Upper bit rate limit: unspecified
Lower bit rate limit: unspecified
Date code (yyyy/mm/dd): 2005/03/21
Vendor PN: FTRJ8519P1BNL-C6
Vendor revision number: A
Vendor serial number: FNS0913D1HL
Transceiver status information
Diagnostics calibration is external
Temperature 36 (+/-3 Celsius)
Voltage in transceiver 3320000 uV (+/- 10 mV)
TX bias 260 uA (+/- 100uA)
TX power 700 nW / -31 dBm (+/- 3dBm)
RX power (No signal detected: fiber might be bad or disconnected).
UDI(PID + VID + SN):FNS0913D1HL
Alarms
TX power low
TX bias low
RX power low
Warnings
TX power low
TX bias low
RX power low
Alarm Thresholds:
high low
Temperature 109 C -29 C
Voltage 3900000 uV 2700000 uV
TX bias 15000 uA 1000 uA
TX power 629700 nW /-2 dBm 49800 nW / -13 dBm
RX power 1258900 nW / 0 dBm 10000 nW / -20 dBm
Warning Thresholds:
high low
Temperature 103 C -13 C
Voltage 3700000 uV 2900000 uV
TX bias 12000 uA 2000 uA
TX power 629700 nW / -2 dBm 78800 nW / -11 dBm
RX power 794000 nW / -1 dBm 15800 nW / -18 dBm
The table below describes the significant fields shown in the display.
Table 162: show interfaces transceiver Field Descriptions
Field Description
Diagnostics calibration Indicates whether diagnostic information (temperature, voltage, bias, and power)
is calibrated internally or externally. Internal calibration means that measurements
are calibrated over vendor-specified operating temperature and voltage. External
calibration means that measurements are raw analog/digital values and are converted
to common units of measure, such as volts and amperes, using calibration constants
stored in EEPROM.
Temperature Internally-measured transceiver temperature.
Voltage in transceiver Internally-measured supply voltage.
TX bias Measured transmitter laser bias current.
TX power Measured coupled transmit output power.
RX power Measured received optical power.
Cisco IOS Interface and Hardware Component Command Reference
1698
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces transceiver
Field Description
UDI Unique device identifier.
Cisco IOS Interface and Hardware Component Command Reference
1699
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces transceiver details
show interfaces transceiver details
The show interfaces transceiver details command displays combined results of show hw-mod subslot
transceiver idprom brief and show hw-mod sub transceiver idprom dump commands. The output also
includes error optics information from the line card console and information is displayed for all the transceivers
in the router. The output also includes alarm status if CPAK transceivers are installed in the router..
show interfaces transceiverdetails
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC (#)
Command History Release Modification
Cisco IOS XE Gibraltar 16.10.1 This command was introduced.
Examples The following is the sample output from the show interfaces transceiver details command:.
Router# show interfaces transceiver details
IDPROM for transceiver HundredGigE1/0/0:
Description = CPAK optics (type 131)
Transceiver Type: = CPAK 100GE SR10 (313)
Product Identifier (PID) = CPAK-100G-SR10
Vendor Revision = 01
Serial Number (SN) = FBN181720831
Vendor Name = CISCO
Vendor OUI (IEEE company ID) = 00.00.0C (12)
CLEI code = WOTRC5PBAA
Cisco part number = 800-41495-
Device State = Enabled.
Date code (yyyy/mm/dd) = 2014/04/24
Connector type = MPO.
Encoding = NRZ, Non-PSK.
Bit Rate = 111.8 Gbps
Maximum Bit Rate Network Lane = 11.2 Gbits/s
Maximum Bit Rate Host Lane = 11.2 Gbits/s
Phased Initialization
Phase Reached: 5
Phase Exit Code: Success 0
Phase Read Offset: 0x80
Socket Verification
Compatibility: Compatibility passed
Security: Security passed
Idprom Contents (hex)
(CPAK NVR1 Table - addr 0x8000-0x807F)
000: 01 21 09 03 00 00 00 00 1E AA
010: 4A 38 38 00 0A 00 0A 01 83 40
020: 86 60 00 00 00 04 40 50 26 17
030: 14 46 00 43 49 53 43 4F 20 20
040: 20 20 20 20 20 20 20 20 20 00
050: 00 0C 38 30 30 2D 34 31 34 39
060: 35 2D 30 31 20 20 20 20 46 42
070: 4E 31 38 31 37 32 30 38 33 31
080: 20 20 20 20 32 30 31 34 30 34
090: 32 34 00 00 57 4F 54 52 43 35
Cisco IOS Interface and Hardware Component Command Reference
1700
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces transceiver details
100: 50 42 41 41 6E 5A 00 05 02 03
110: 0C 03 0F 20 01 01 08 00 FE 01
120: 00 00 00 02 03 00 00 FC
Threshold Data (hex)
CPAK NVR2 Table - address 0x8080-0x80FF
000: 4B 00 46 00 00 00 FB 00 8A 00
010: 87 5A 7A 76 77 E2 00 00 00 00
020: 00 00 00 00 00 00 00 00 00 00
030: 00 00 00 00 00 00 00 00 00 00
040: 13 88 11 94 05 DC 03 E8 45 76
050: 22 D0 06 C9 03 66 5A 00 55 00
060: 00 00 FB 00 88 71 43 E2 04 62
070: 02 32 00 00 00 00 00 00 00 00
080: 00 00 00 00 00 00 00 00 00 00
090: 00 00 00 00 00 00 00 00 00 00
100: 00 00 00 00 00 00 00 00 00 00
110: 00 00 00 00 00 00 00 00 00 00
120: 00 00 00 00 00 00 00 93
Vendor Idprom Contents (hex)
Vendor Cisco NVR1 Table - address 0x8400-0x847F
000: 02 00 00 00 00 00 00 00 00 00
010: 00 00 00 00 00 00 43 49 53 43
020: 4F 20 20 20 20 20 20 20 20 20
030: 20 20 43 50 41 4B 2D 31 30 30
040: 47 2D 53 52 31 30 20 20 56 45
050: 53 31 07 46 42 4E 31 38 31 37
060: 32 30 38 33 38 30 30 2D 34 31
070: 34 39 35 2D 30 31 30 31 20 20
080: 00 00 00 00 00 00 00 00 00 00
090: 00 32 38 2D 31 31 30 32 30 2D
100: 30 34 00 00 00 00 00 00 00 00
110: 00 00 00 00 00 00 00 00 00 00
120: 00 00 00 00 00 00 00 1B
Vendor Idprom Contents 2 (hex)
Vendor CISCO NVR2 Table - address 0x8480-0x84FF
000: 00 00 00 00 00 00 00 00 00 00
010: 00 00 00 00 00 00 00 00 00 00
020: 00 00 00 00 00 00 00 00 00 00
030: 00 00 41 46 45 30 34 30 46 52
040: 20 20 20 20 20 20 20 20 41 46
050: 45 30 34 42 47 55 20 20 20 20
060: 20 20 20 20 00 00 00 00 00 00
070: 00 00 00 00 00 00 00 00 00 00
080: 53 52 31 34 34 30 31 30 37 39
090: 2D 30 36 20 20 20 00 00 00 00
100: 00 00 00 00 00 00 00 00 00 00
110: 00 00 00 00 00 00 00 00 00 00
120: 00 00 00 00 00 00 00 38
Module State Register: 0x0020
Module General Control Register: 0x0000
Global Alarm Status: 0x0000
Network Lanes Alarm and Warning Status: 0x0000
Network Lanes Fault Status Summary: 0x0000
Host Lanes Fault Status Summary: 0x0000
Module Fault and Warning, General Status Summary: 0x0002
Module Fault and Warning, Fault Status Summary: 0x0000
Fault and Warning status, Alarms and Warning 1: 0x0000
Multimode fiber supported length = 100 m
Enhanced options implemented:
Host Lane PRBS Supported
Enhanced options 2 implemented:
none
Diagnostic monitoring implemented:
Transmitted power measurement type
Cisco IOS Interface and Hardware Component Command Reference
1701
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces transceiver details
Received power measurement type
Diagnostic monitoring capability 1:
Transceiver temperature monitor
Transceiver power supply voltage monitor
Diagnostic monitoring capability 2:
Network Lane laser temperature monitor
Network Lane laser bias current monitor
Network Lane laser output power monitor
Network Lane received power monitor
Cisco IOS Interface and Hardware Component Command Reference
1702
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces transceiver slot
show interfaces transceiver slot
The show interfaces transceiver slot command displays combined results of show hw-module subslot
transceiver status and show hw-module subslot transceiver idprom brief commands along with the threshold
range details. The output is displayed for the transceivers in a specific slot on the router.
show interfaces transceiver slot[{slot-number}]
Syntax Description slot-number Chassis slot-number.
Command Modes Privileged EXEC(#)
Command History Release Modification
Cisco IOS XE Gibraltar 16.10.1 This command was introduced.
Examples The following is sample output from the show interfaces transceiver slot comman::
Router# show interfaces transceiver slot 2The Transceiver in slot 2 subslot 0 port 0 is
enabled.
Module temperature = +31.714 C [Range: -5 C to 85 C (extended)]
Transceiver Tx supply voltage = 3331.8 mVolts [Range: 3140.0 to 3470.0 mVolts]
Transceiver Tx bias current = 3112 uAmps [Range: 2400 to 11900 uAmps]
Transceiver Tx power = -5.8 dBm [Range: -9.5 to -3.0 dBm]
Transceiver Rx optical power = -7.4 dBm [Range: -17.0 to 0.0 dBm]
IDPROM for transceiver GigabitEthernet2/0/0:
Description = SFP or SFP+ optics (type 3)
Transceiver Type: = GE SX (19)
Product Identifier (PID) = GLC-SX-MMD
Vendor Revision = 001
Serial Number (SN) = AGJ1825R57R
Vendor Name = CISCO
Vendor OUI (IEEE company ID) = 00.17.6A (5994)
CLEI code = WOTRB9VBAA
Cisco part number = 10-2626-01
Device State = Enabled.
Date code (yy/mm/dd) = 14/06/17
Connector type = LC.
Encoding = 8B10B (1)
Nominal bitrate = GE (1300 Mbits/s)
Minimum bit rate as % of nominal bit rate = not specified
Maximum bit rate as % of nominal bit rate = not specified
Cisco IOS Interface and Hardware Component Command Reference
1703
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces transceiver slot details
show interfaces transceiver slot details
The show interfaces transceiver slot details command displays combined results of show hw-mod subslot
transceiver idprom brief and show hw-mod sub transceiver idprom dump commands. The output also
includes error optics information from the line card console and information is displayed for all the transceivers
in a specific slot. The output also includes alarm details for the CPAK transceivers installed on the router.
show interfaces transceiver slot[{slot-number}]details
Syntax Description slot-number Chassis slot-number.
Command Modes Privileged EXEC(#)
Command History Release Modification
Cisco IOS XE Gibraltar 16.10.1 This command was introduced.
Examples The following is sample output from the show interfaces transceiver slot details comman::
Router# show interfaces transceiver slot 2 details
IDPROM for transceiver GigabitEthernet2/0/0:
Description = SFP or SFP+ optics (type 3)
Transceiver Type: = GE SX (19)
Product Identifier (PID) = GLC-SX-MMD
Vendor Revision = 001
Serial Number (SN) = AGJ1825R57R
Vendor Name = CISCO
Vendor OUI (IEEE company ID) = 00.17.6A (5994)
CLEI code = WOTRB9VBAA
Cisco part number = 10-2626-01
Device State = Enabled.
Date code (yy/mm/dd) = 14/06/17
Connector type = LC.
Encoding = 8B10B (1)
Nominal bitrate = GE (1300 Mbits/s)
Minimum bit rate as % of nominal bit rate = not specified
Maximum bit rate as % of nominal bit rate = not specified
Phased Initialization
Phase Reached: 5
Phase Exit Code: Success 0
Phase Read Offset: 0x100
Socket Verification
Compatibility: Compatibility passed
Security: Security passed
SFP IDPROM Page 0xA0:
000: 03 04 07 00 00 00 01 00 00 00
010: 00 01 0D 00 00 00 37 1B 00 00
020: 43 49 53 43 4F 20 20 20 20 20
030: 20 20 20 20 20 20 00 00 17 6A
040: 53 46 42 52 2D 35 37 31 36 50
050: 5A 20 20 20 20 20 30 30 31 20
060: 03 52 00 3E 00 1A 00 00 41 47
070: 4A 31 38 32 35 52 35 37 52 20
080: 20 20 20 20 31 34 30 36 31 37
090: 20 20 68 F0 03 3A 00 00 06 BC
100: 13 7F 4C 09 FD 98 52 53 B6 88
Cisco IOS Interface and Hardware Component Command Reference
1704
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces transceiver slot details
110: B7 DF 55 30 D9 00 00 00 00 00
120: 00 00 00 00 5A 53 74 66 00 00
130: 00 00 00 00 00 00 00 00 00 00
140: 00 00 00 00 00 00 00 00 00 00
150: 00 00 00 00 00 00 00 00 00 00
160: 00 00 00 00 00 00 00 00 00 00
170: 00 00 00 00 00 00 00 00 00 00
180: 00 00 00 00 00 00 00 00 00 00
190: 00 00 00 00 00 00 00 00 00 00
200: 00 00 00 00 00 00 00 00 00 00
210: 00 00 00 00 00 00 00 00 00 00
220: 00 00 00 00
SFP IDPROM Page 0xA2:
000: 5A 00 F6 00 55 00 FB 00 8D CC
010: 74 04 87 8C 7A A8 18 E7 03 E8
020: 17 3E 04 B0 27 10 01 BF 13 94
030: 04 62 4D F0 00 4F 27 10 00 C7
040: 00 00 00 00 00 00 00 00 00 00
050: 00 00 00 00 00 00 00 00 00 00
060: 00 00 00 00 00 00 00 00 3F 80
070: 00 00 00 00 00 00 01 00 00 00
080: 01 00 00 00 01 00 00 00 01 00
090: 00 00 68 00 00 52 1A 1B 82 C1
100: 00 01 00 01 00 01 00 00 00 0F
110: 82 00 05 40 00 00 05 40 00 00
120: 00 00 00 00 00 00 00 01 57 4F
130: 54 52 42 39 56 42 41 41 31 30
140: 2D 32 36 32 36 2D 30 31 56 30
150: 31 20 88 FB 55 00 00 00 00 7C
160: 00 00 00 00 00 00 00 00 00 00
170: 00 00 00 00 00 00 00 00 00 00
180: 00 00 00 00 00 00 00 00 00 00
190: AA AA 47 4C 43 2D 53 58 2D 4D
200: 4D 44 20 20 20 20 20 20 20 20
210: 20 20 00 00 00 00 00 00 00 00
220: 00 00 00 F9 00 00 00 00 00 00
230: 00 00 00 00 00 00 00 00 00 00
240: 00 00 00 00 00 00 00 00 FF FF
250: FF FF 00 00 00 00
Link reach for 9u fiber (km) = SX(550/270m) (0)
1xFC-MM(500/300m) (0)
2xFC-MM(300/150m) (0)
ESCON-MM(2km) (0)
Link reach for 9u fiber (m) = SX(550/270m) (0)
1xFC-MM(500/300m) (0)
2xFC-MM(300/150m) (0)
ESCON-MM(2km) (0)
Link reach for 50u fiber (m) = SX(550/270m) (55)
LX(5km/550m) (55)
LX(10km/550m) (55)
Nominal laser wavelength = 850 nm.
DWDM wavelength fraction = 850.0 nm.
Supported options = Tx disable
Tx fault signal
Loss of signal (standard implementation)
Supported enhanced options = Alarms for monitored parameters
Software Tx disable
Software Tx fault monitoring
Software Rx LOS monitoring
Diagnostic monitoring = Digital diagnostics supported
Diagnostics are internally calibrated
Rx power measured is "Average power"
Cisco IOS Interface and Hardware Component Command Reference
1705
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces transceiver subslot
show interfaces transceiver subslot
The show interfaces transceiver subslot command displays results of show hw-module subslot transceiver
status and show hw-module subslot transceiver idprom brief command along with threshold range details.
The output is displayed for the transceivers in a specific subslot.
show interfaces transceiver subslot[{subslot-number}]
Syntax Description subslot-number Secondary slot number on a SIP where a SPA is installed..
Command Modes Privileged EXEC(#)
Command History Release Modification
Cisco IOS XE Gibraltar 16.10.1 This command was introduced.
Examples The following is sample output from the show interfaces transceiver subslot command:
Router# show interfaces transceiver subslot 2/0
The Transceiver in slot 2 subslot 0 port 0 is enabled.
Module temperature = +31.714 C [Range: -5 C to 85 C (extended)]
Transceiver Tx supply voltage = 3331.8 mVolts [Range: 3140.0 to 3470.0 mVolts]
Transceiver Tx bias current = 3112 uAmps [Range: 2400 to 11900 uAmps]
Transceiver Tx power = -5.8 dBm [Range: -9.5 to -3.0 dBm]
Transceiver Rx optical power = -7.4 dBm [Range: -17.0 to 0.0 dBm]
IDPROM for transceiver GigabitEthernet2/0/0:
Description = SFP or SFP+ optics (type 3)
Transceiver Type: = GE SX (19)
Product Identifier (PID) = GLC-SX-MMD
Vendor Revision = 001
Serial Number (SN) = AGJ1825R57R
Vendor Name = CISCO
Vendor OUI (IEEE company ID) = 00.17.6A (5994)
CLEI code = WOTRB9VBAA
Cisco part number = 10-2626-01
Device State = Enabled.
Date code (yy/mm/dd) = 14/06/17
Connector type = LC.
Encoding = 8B10B (1)
Nominal bitrate = GE (1300 Mbits/s)
Minimum bit rate as % of nominal bit rate = not specified
Maximum bit rate as % of nominal bit rate = not specified
Cisco IOS Interface and Hardware Component Command Reference
1706
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces transceiver subslot details
show interfaces transceiver subslot details
The show interfaces transceiver subslot details command displays combined results of show hw-mod
subslot idprom brief and show hw-mod subslot idprom dump commands. The output also includes error
optics information from the line card console and information for all the transceivers in a specific subslot.
The output also includes alarm details for the CPAK transceivers installed on the router.
show interfaces transceiver subslot[{subslot-number}]details
Syntax Description subslot-number Secondary slot number on a SIP where a SPA is installed..
Command Modes Privileged EXEC(#)
Command History Release Modification
Cisco IOS XE Gibraltar 16.10.1 This command was introduced.
Examples The following is sample output from the show interfaces transceiver subslot details command:
Router# show interfaces transceiver subslot 2/0 details
IDPROM for transceiver GigabitEthernet2/0/0:
Description = SFP or SFP+ optics (type 3)
Transceiver Type: = GE SX (19)
Product Identifier (PID) = GLC-SX-MMD
Vendor Revision = 001
Serial Number (SN) = AGJ1825R57R
Vendor Name = CISCO
Vendor OUI (IEEE company ID) = 00.17.6A (5994)
CLEI code = WOTRB9VBAA
Cisco part number = 10-2626-01
Device State = Enabled.
Date code (yy/mm/dd) = 14/06/17
Connector type = LC.
Encoding = 8B10B (1)
Nominal bitrate = GE (1300 Mbits/s)
Minimum bit rate as % of nominal bit rate = not specified
Maximum bit rate as % of nominal bit rate = not specified
Phased Initialization
Phase Reached: 5
Phase Exit Code: Success 0
Phase Read Offset: 0x100
Socket Verification
Compatibility: Compatibility passed
Security: Security passed
SFP IDPROM Page 0xA0:
000: 03 04 07 00 00 00 01 00 00 00
010: 00 01 0D 00 00 00 37 1B 00 00
020: 43 49 53 43 4F 20 20 20 20 20
030: 20 20 20 20 20 20 00 00 17 6A
040: 53 46 42 52 2D 35 37 31 36 50
050: 5A 20 20 20 20 20 30 30 31 20
060: 03 52 00 3E 00 1A 00 00 41 47
070: 4A 31 38 32 35 52 35 37 52 20
080: 20 20 20 20 31 34 30 36 31 37
090: 20 20 68 F0 03 3A 00 00 06 BC
100: 13 7F 4C 09 FD 98 52 53 B6 88
Cisco IOS Interface and Hardware Component Command Reference
1707
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces transceiver subslot details
110: B7 DF 55 30 D9 00 00 00 00 00
120: 00 00 00 00 5A 53 74 66 00 00
130: 00 00 00 00 00 00 00 00 00 00
140: 00 00 00 00 00 00 00 00 00 00
150: 00 00 00 00 00 00 00 00 00 00
160: 00 00 00 00 00 00 00 00 00 00
170: 00 00 00 00 00 00 00 00 00 00
180: 00 00 00 00 00 00 00 00 00 00
190: 00 00 00 00 00 00 00 00 00 00
200: 00 00 00 00 00 00 00 00 00 00
210: 00 00 00 00 00 00 00 00 00 00
220: 00 00 00 00
SFP IDPROM Page 0xA2:
000: 5A 00 F6 00 55 00 FB 00 8D CC
010: 74 04 87 8C 7A A8 18 E7 03 E8
020: 17 3E 04 B0 27 10 01 BF 13 94
030: 04 62 4D F0 00 4F 27 10 00 C7
040: 00 00 00 00 00 00 00 00 00 00
050: 00 00 00 00 00 00 00 00 00 00
060: 00 00 00 00 00 00 00 00 3F 80
070: 00 00 00 00 00 00 01 00 00 00
080: 01 00 00 00 01 00 00 00 01 00
090: 00 00 68 00 00 52 1A 1B 82 C1
100: 00 01 00 01 00 01 00 00 00 0F
110: 82 00 05 40 00 00 05 40 00 00
120: 00 00 00 00 00 00 00 01 57 4F
130: 54 52 42 39 56 42 41 41 31 30
140: 2D 32 36 32 36 2D 30 31 56 30
150: 31 20 88 FB 55 00 00 00 00 7C
160: 00 00 00 00 00 00 00 00 00 00
170: 00 00 00 00 00 00 00 00 00 00
180: 00 00 00 00 00 00 00 00 00 00
190: AA AA 47 4C 43 2D 53 58 2D 4D
200: 4D 44 20 20 20 20 20 20 20 20
210: 20 20 00 00 00 00 00 00 00 00
220: 00 00 00 F9 00 00 00 00 00 00
230: 00 00 00 00 00 00 00 00 00 00
240: 00 00 00 00 00 00 00 00 FF FF
250: FF FF 00 00 00 00
Link reach for 9u fiber (km) = SX(550/270m) (0)
1xFC-MM(500/300m) (0)
2xFC-MM(300/150m) (0)
ESCON-MM(2km) (0)
Link reach for 9u fiber (m) = SX(550/270m) (0)
1xFC-MM(500/300m) (0)
2xFC-MM(300/150m) (0)
ESCON-MM(2km) (0)
Link reach for 50u fiber (m) = SX(550/270m) (55)
LX(5km/550m) (55)
LX(10km/550m) (55)
Nominal laser wavelength = 850 nm.
DWDM wavelength fraction = 850.0 nm.
Supported options = Tx disable
Tx fault signal
Loss of signal (standard implementation)
Supported enhanced options = Alarms for monitored parameters
Software Tx disable
Software Tx fault monitoring
Software Rx LOS monitoring
Diagnostic monitoring = Digital diagnostics supported
Diagnostics are internally calibrated
Rx power measured is "Average power"
Cisco IOS Interface and Hardware Component Command Reference
1708
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces <interface> transceiver
show interfaces <interface> transceiver
The show interfaces <interface> transceiver command displays combined results of show hw-module
subslot transceiver status and show hw-module subslot transceiver idprom brief commands along with
threshold range details. The output is displayed for a specific interface on the router.
show interfaces[{interface-typeslot/subslot/port}] transceiver
Syntax Description interface-type Interface type; possible valid values are pos, atm, ethernet, fastethernet, gigabitethernet,
tengigabitethernet, fortygigabitethernet, hundredGigE.
slot Number of the router slot.
subslot Secondary slot number on a SIP where a SPA is installed.
port Port number
Command Modes Privileged EXEC(#)
Command History Release Modification
Cisco IOS XE Gibraltar 16.10.1 This command was introduced.
Examples The following is sample output from the show interfaces <interface> transceiver command:
Router# show interfaces hundredGigE 1/0/0 transceiver
The Transceiver in slot 1 subslot 0 port 0 is enabled.
Module temperature = +33.238 C [Range: +0.000 to +70.000 C]
Transceiver Tx supply voltage = 3.2967 Volts [Range: 3.1350 to 3.4650 Volts]
Transceiver Tx power = -4.1 dBm
Transceiver Rx optical power = -6.1 dBm
Tx power Network Lane[00] = -2.3 dBm (0.5823 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[01] = -2.1 dBm (0.6182 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[02] = -2.0 dBm (0.6332 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[03] = -1.9 dBm (0.6522 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[04] = -2.3 dBm (0.5827 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[05] = -2.0 dBm (0.6324 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[06] = -2.0 dBm (0.6251 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[07] = -1.9 dBm (0.6519 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[08] = -2.2 dBm (0.6070 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[09] = -2.1 dBm (0.6148 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[10] = -40.0 dBm (0.0 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[11] = -40.0 dBm (0.0 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[12] = -40.0 dBm (0.0 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[13] = -40.0 dBm (0.0 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[14] = -40.0 dBm (0.0 in units of mW) [Range:-7.6 to -0.5 dBm]
Tx power Network Lane[15] = -40.0 dBm (0.0 in units of mW) [Range:-7.6 to -0.5 dBm]
Rx power Network Lane[00] = -4.3 dBm (0.3675 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[01] = -3.6 dBm (0.4325 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[02] = -5.3 dBm (0.2963 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[03] = -3.1 dBm (0.4851 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[04] = -6.6 dBm (0.2183 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[05] = -4.0 dBm (0.4015 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[06] = -3.9 dBm (0.4109 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[07] = -4.6 dBm (0.3431 in units of mW) [Range:-9.5 to 2.4 dBm]
Cisco IOS Interface and Hardware Component Command Reference
1709
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces <interface> transceiver
Rx power Network Lane[08] = -3.5 dBm (0.4448 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[09] = -3.1 dBm (0.4895 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[10] = -40.0 dBm (0.0 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[11] = -40.0 dBm (0.0 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[12] = -40.0 dBm (0.0 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[13] = -40.0 dBm (0.0 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[14] = -40.0 dBm (0.0 in units of mW) [Range:-9.5 to 2.4 dBm]
Rx power Network Lane[15] = -40.0 dBm (0.0 in units of mW) [Range:-9.5 to 2.4 dBm]
Bias Current Network Lane[00] = 6.262 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[01] = 5.756 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[02] = 6.304 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[03] = 6.178 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[04] = 6.194 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[05] = 6.84 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[06] = 6.198 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[07] = 6.176 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[08] = 6.160 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[09] = 5.556 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[10] = 0.0 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[11] = 0.0 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[12] = 0.0 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[13] = 0.0 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[14] = 0.0 (in units of mA) [Range:0.0 to 43.520 mA]
Bias Current Network Lane[15] = 0.0 (in units of mA) [Range:0.0 to 43.520 mA]
IDPROM for transceiver HundredGigE1/0/0:
Description = CPAK optics (type 131)
Transceiver Type: = CPAK 100GE SR10 (313)
Product Identifier (PID) = CPAK-100G-SR10
Vendor Revision = 01
Serial Number (SN) = FBN181720831
Vendor Name = CISCO
Vendor OUI (IEEE company ID) = 00.00.0C (12)
CLEI code = WOTRC5PBAA
Cisco part number = 800-41495-
Device State = Enabled.
Date code (yyyy/mm/dd) = 2014/04/24
Connector type = MPO.
Encoding = NRZ, Non-PSK.
Bit Rate = 111.8 Gbps
Maximum Bit Rate Network Lane = 11.2 Gbits/s
Maximum Bit Rate Host Lane = 11.2 Gbits/s
Cisco IOS Interface and Hardware Component Command Reference
1710
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces <interface> transceiver detail
show interfaces <interface> transceiver detail
The show interfaces <interface> transceiver details command displays combined results of show hw-mod
subslot transceiver idprom brief and show hw-mod sub transceiver idprom dump commands for a specific
interface on the router. The output also includes error optics information from the line card console and alarm
status, if CPAK transceivers are installed in the router.
show interfaces[{interface-typeslot/subslot/port}] transceiver detail
Syntax Description interface-type Interface type; possible valid values are pos, atm, ethernet, fastethernet, gigabitethernet,
tengigabitethernet, fortygigabitethernet, hundredGigE.
slot Number of the router slot.
subslot Secondary slot number on a SIP where a SPA is installed.
port Port number
Command Modes Privileged EXEC(#)
Command History Release Modification
Cisco IOS XE Gibraltar 16.10.1 This command was introduced.
Examples The following is sample output from the show interfaces <interface> transceiver detail command:
Router# show interfaces hundredGigE 1/0/0 transceiver
IDPROM for transceiver HundredGigE1/0/0:
Description = CPAK optics (type 131)
Transceiver Type: = CPAK 100GE SR10 (313)
Product Identifier (PID) = CPAK-100G-SR10
Vendor Revision = 01
Serial Number (SN) = FBN181720831
Vendor Name = CISCO
Vendor OUI (IEEE company ID) = 00.00.0C (12)
CLEI code = WOTRC5PBAA
Cisco part number = 800-41495-
Device State = Enabled.
Date code (yyyy/mm/dd) = 2014/04/24
Connector type = MPO.
Encoding = NRZ, Non-PSK.
Bit Rate = 111.8 Gbps
Maximum Bit Rate Network Lane = 11.2 Gbits/s
Maximum Bit Rate Host Lane = 11.2 Gbits/s
Phased Initialization
Phase Reached: 5
Phase Exit Code: Success 0
Phase Read Offset: 0x80
Socket Verification
Compatibility: Compatibility passed
Security: Security passed
Idprom Contents (hex)
(CPAK NVR1 Table - addr 0x8000-0x807F)
000: 01 21 09 03 00 00 00 00 1E AA
010: 4A 38 38 00 0A 00 0A 01 83 40
Cisco IOS Interface and Hardware Component Command Reference
1711
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces <interface> transceiver detail
020: 86 60 00 00 00 04 40 50 26 17
030: 14 46 00 43 49 53 43 4F 20 20
040: 20 20 20 20 20 20 20 20 20 00
050: 00 0C 38 30 30 2D 34 31 34 39
060: 35 2D 30 31 20 20 20 20 46 42
070: 4E 31 38 31 37 32 30 38 33 31
080: 20 20 20 20 32 30 31 34 30 34
090: 32 34 00 00 57 4F 54 52 43 35
100: 50 42 41 41 6E 5A 00 05 02 03
110: 0C 03 0F 20 01 01 08 00 FE 01
120: 00 00 00 02 03 00 00 FC
Threshold Data (hex)
CPAK NVR2 Table - address 0x8080-0x80FF
000: 4B 00 46 00 00 00 FB 00 8A 00
010: 87 5A 7A 76 77 E2 00 00 00 00
020: 00 00 00 00 00 00 00 00 00 00
030: 00 00 00 00 00 00 00 00 00 00
040: 13 88 11 94 05 DC 03 E8 45 76
050: 22 D0 06 C9 03 66 5A 00 55 00
060: 00 00 FB 00 88 71 43 E2 04 62
070: 02 32 00 00 00 00 00 00 00 00
080: 00 00 00 00 00 00 00 00 00 00
090: 00 00 00 00 00 00 00 00 00 00
100: 00 00 00 00 00 00 00 00 00 00
110: 00 00 00 00 00 00 00 00 00 00
120: 00 00 00 00 00 00 00 93
Vendor Idprom Contents (hex)
Vendor Cisco NVR1 Table - address 0x8400-0x847F
000: 02 00 00 00 00 00 00 00 00 00
010: 00 00 00 00 00 00 43 49 53 43
020: 4F 20 20 20 20 20 20 20 20 20
030: 20 20 43 50 41 4B 2D 31 30 30
040: 47 2D 53 52 31 30 20 20 56 45
050: 53 31 07 46 42 4E 31 38 31 37
060: 32 30 38 33 38 30 30 2D 34 31
070: 34 39 35 2D 30 31 30 31 20 20
080: 00 00 00 00 00 00 00 00 00 00
090: 00 32 38 2D 31 31 30 32 30 2D
100: 30 34 00 00 00 00 00 00 00 00
110: 00 00 00 00 00 00 00 00 00 00
120: 00 00 00 00 00 00 00 1B
Vendor Idprom Contents 2 (hex)
Vendor CISCO NVR2 Table - address 0x8480-0x84FF
000: 00 00 00 00 00 00 00 00 00 00
010: 00 00 00 00 00 00 00 00 00 00
020: 00 00 00 00 00 00 00 00 00 00
030: 00 00 41 46 45 30 34 30 46 52
040: 20 20 20 20 20 20 20 20 41 46
050: 45 30 34 42 47 55 20 20 20 20
060: 20 20 20 20 00 00 00 00 00 00
070: 00 00 00 00 00 00 00 00 00 00
080: 53 52 31 34 34 30 31 30 37 39
090: 2D 30 36 20 20 20 00 00 00 00
100: 00 00 00 00 00 00 00 00 00 00
110: 00 00 00 00 00 00 00 00 00 00
120: 00 00 00 00 00 00 00 38
Module State Register: 0x0020
Module General Control Register: 0x0000
Global Alarm Status: 0x0000
Network Lanes Alarm and Warning Status: 0x0000
Network Lanes Fault Status Summary: 0x0000
Host Lanes Fault Status Summary: 0x0000
Module Fault and Warning, General Status Summary: 0x0002
Module Fault and Warning, Fault Status Summary: 0x0000
Cisco IOS Interface and Hardware Component Command Reference
1712
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces <interface> transceiver detail
Fault and Warning status, Alarms and Warning 1: 0x0000
Multimode fiber supported length = 100 m
Enhanced options implemented:
Host Lane PRBS Supported
Enhanced options 2 implemented:
none
Diagnostic monitoring implemented:
Transmitted power measurement type
Received power measurement type
Diagnostic monitoring capability 1:
Transceiver temperature monitor
Transceiver power supply voltage monitor
Diagnostic monitoring capability 2:
Network Lane laser temperature monitor
Network Lane laser bias current monitor
Network Lane laser output power monitor
Network Lane received power monitor
Cisco IOS Interface and Hardware Component Command Reference
1713
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces trunk
show interfaces trunk
To display the interface-trunk information, use the showinterfacestrunk command in user EXEC or privileged
EXEC mode.
show interfaces [interface interface-number] trunk [{module number|vlan vlan}]
Syntax Description interface (Optional) Interface type; possible valid values are ethernet, fastethernet,
gigabitethernet, tengigabitethernet, pos, atm, and ge-wan.
interface-number (Optional) Module and port number; see the “Usage Guidelines” section for valid values.
module number (Optional) Specifies the module number; see the “Usage Guidelines” section for valid
values.
vlan vlan (Optional) Limits the display of switch port information to the specified VLAN. Range:
1 to 4094.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SXI This command was changed to add the optional vlanvlan keyword and argument.
Usage Guidelines The pos, atm, and ge-wan keywords are supported on systems that are configured with a Supervisor Engine
2.
If you do not specify a keyword, only information for trunking ports is displayed.
The interface-number designates the module and port number. Valid values depend on the chassis and module
that are used. For example, if you have a 48-port 10/100BASE-T Ethernet module that is installed in a 13-slot
chassis, valid values for the slot number are from 1 to 13 and valid values for the port number are from 1 to
48.
The modulenumber keyword and argument designate the module number and limit the display to interfaces
on the module. Valid values depend on the chassis that is used. For example, if you have a 13-slot chassis,
valid values for the module number are from 1 to 13.
Examples This example shows how to display the interface-trunk information for module 5:
Router#
show interfaces trunk module 5
Port Mode Encapsulation Status Native vlan
Cisco IOS Interface and Hardware Component Command Reference
1714
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces trunk
Fa5/1 routed negotiate routed 1
Fa5/2 routed negotiate routed 1
Fa5/3 routed negotiate routed 1
Fa5/4 routed negotiate routed 1
Fa5/5 routed negotiate routed 1
Fa5/6 off negotiate not-trunking 10
Fa5/7 off negotiate not-trunking 10
Fa5/8 off negotiate not-trunking 1
Fa5/9 desirable n-isl trunking 1
Fa5/10 desirable negotiate not-trunking 1
Fa5/11 routed negotiate routed 1
Fa5/12 routed negotiate routed 1
.
.
.
Fa5/48 routed negotiate routed 1
Port Vlans allowed on trunk
Fa5/1 none
Fa5/2 none
Fa5/3 none
Fa5/4 none
Fa5/5 none
Fa5/6 none
Fa5/7 none
Fa5/8 200
Fa5/9 1-1005
Fa5/10 none
Fa5/11 none
Fa5/12 none
.
.
.
Fa5/48 none
Port Vlans allowed and active in management domain
Fa5/1 none
Fa5/2 none
Fa5/3 none
Fa5/4 none
Fa5/5 none
Fa5/6 none
Fa5/7 none
Fa5/8 200
Fa5/9 1-6,10,20,50,100,152,200,300,303-305,349-351,400,500,521,524,570,801-8
02,850,917,999,1002-1005
Fa5/10 none
Fa5/11 none
Fa5/12 none
.
.
.
Fa5/48 none
Port Vlans in spanning tree forwarding state and not pruned
Fa5/1 none
Fa5/2 none
Fa5/3 none
Fa5/4 none
Fa5/5 none
Fa5/6 none
Fa5/7 none
Fa5/8 200
Fa5/9 1-6,10,20,50,100,152,200,300,303-305,349-351,400,500,521,524,570,801-8
02,850,917,999,1002-1005
Fa5/10 none
Fa5/11 none
Cisco IOS Interface and Hardware Component Command Reference
1715
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces trunk
.
.
.
Fa5/48 none
Router#
This example shows how to display the trunking information for active trunking ports:
Router#
show interfaces trunk
Port Mode Encapsulation Status Native vlan
Fa5/9 desirable n-isl trunking 1
Port Vlans allowed on trunk
Fa5/9 1-1005
Port Vlans allowed and active in management domain
Fa5/9 1-6,10,20,50,100,152,200,300,303-305,349-351,400,500,521,524,570,801-8
02,850,917,999,1002-1005
Port Vlans in spanning tree forwarding state and not pruned
Fa5/9 1-6,10,20,50,100,152,200,300,303-305,349-351,400,500,521,524,570,801-8
02,850,917,999,1002-1005
Router#
This example shows how to limit the display information for interfaces on a specific VLAN:
Router> show interfaces trunk vlan 22
Router>
Related Commands Command Description
show interfaces Displays the status and statistics for the interfaces in the chassis.
Cisco IOS Interface and Hardware Component Command Reference
1716
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces tunnel
show interfaces tunnel
To display tunnel interface information, use the showinterfacestunnel command in privileged EXEC mode.
show interfaces tunnel number [accounting]
Syntax Description number Port line number.
accounting (Optional) Displays the number of packets of each protocol type that have been sent through
the interface.
Command Modes Privileged EXEC
Command History Release Modification
10.0 This command was introduced.
12.2(14)S This command was integrated into Cisco IOS Release 12.2(14)S.
12.2(28)SB This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.4(11)T Support was added to display traffic information when the tunnelroute-via
command is present in the configuration file.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support
in a specific 12.2SX release of this train depends on your feature set, platform,
and platform hardware.
Cisco IOS XE Release 3.11S This command was integrated into Cisco IOS XE Release 3.11S. The output
was modified to display information about tunnel entropy calculation.
Examples The following is sample output from the showinterfacestunnel command.
Device# show interfaces tunnel 4
Tunnel4 is up, line protocol is down
Hardware is Routing Tunnel
MTU 1500 bytes, BW 9 Kbit, DLY 500000 usec, rely 255/255, load 1/255
Encapsulation TUNNEL, loopback not set, keepalive set (10 sec)
Tunnel source 0.0.0.0, destination 0.0.0.0
Tunnel protocol/transport GRE/IP, key disabled, sequencing disabled
Tunnel Entropy Calculation Enabled (24-bit Key)
Last input never, output never, output hang never
Last clearing of “show interface” counters never
Output queue 0/0, 0 drops; input queue 0/75, 0 drops
Five minute input rate 0 bits/sec, 0 packets/sec
Five minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
Cisco IOS Interface and Hardware Component Command Reference
1717
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces tunnel
0 packets output, 0 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets, 0 restarts
Device# show interfaces tunnel 0 | include route-via
Tunnel route-via feature is on [Ethernet0, preferred]
Device# show interfaces tunnel 0 | include route-via
Tunnel route-via feature is on [Ethernet0, mandatory]
The table below describes significant fields shown in the display.
Table 163: show interfaces tunnel Field Descriptions
Field Description
Tunnel is {up | down} Interface is currently active and inserted into ring (up) or inactive and not inserted
(down).
On the Cisco 7500 series routers, gives the interface processor type, slot number,
and port number.
line protocol is {up | Shows line protocol up if a valid route is available to the tunnel destination. Shows
down | administratively line protocol down if no route is available or if the route would be recursive.
down}
Hardware Specifies the hardware type.
MTU Maximum transmission unit of the interface.
BW Bandwidth of the interface, in kilobits per second.
DLY Delay of the interface, in microseconds.
rely Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability),
calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes.
Encapsulation Encapsulation method is always TUNNEL for tunnels.
loopback Indicates whether loopback is set or not.
keepalive Indicates whether keepalives are set or not.
Tunnel source IP address used as the source address for packets in the tunnel.
destination IP address of the host destination.
Tunnel protocol Tunnel transport protocol (the protocol that the tunnel is using). This is based on
the tunnelmodecommand, which defaults to GRE.
key ID key for the tunnel interface, unless disabled.
Tunnel Entropy Achieves load balancing of tunnel packets in a network.
Calculation
Cisco IOS Interface and Hardware Component Command Reference
1718
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces tunnel
Field Description
sequencing Indicates whether the tunnel interface drops datagrams that arrive out of order.
Can be disabled.
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by an interface and processed locally on the router. Useful for knowing
when a dead interface failed. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by an interface. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
output hang Number of hours, minutes, and seconds (or never) since the interface was last
reset because of a transmission that took too long. When the number of hours in
any of the “last” fields exceeds 24 hours, the number of days and hours is printed.
If that field overflows, asterisks are printed.
Last clearing Time at which the counters that measure cumulative statistics (such as number of
bytes transmitted and received) shown in this report were last reset to zero. Note
that variables that might affect routing (for example, load and reliability) are not
cleared when the counters are cleared.
*** indicates the elapsed time is too large to be displayed.
0:00:00 indicates that the counters were cleared more than 231 ms (and less than
232 ms) ago.
Output queue, drops Number of packets in output and input queues. Each number is followed by a
Input queue, drops slash, the maximum size of the queue, and the number of packets dropped because
of a full queue.
Five minute input rate, Average number of bits and packets transmitted per second in the last 5 minutes.
Five minute output rate
The 5-minute input and output rates should be used only as an approximation of
traffic per second during a given 5-minute period. These rates are exponentially
weighted averages with a time constant of 5 minutes. A period of four time
constants must pass before the average will be within two percent of the
instantaneous rate of a uniform stream of traffic over that period.
packets input Total number of error-free packets received by the system.
bytes Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the
main system. Compare with ignored count. Broadcast storms on Ethernet networks
and bursts of noise on serial lines are often responsible for no input buffer events.
broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of them medium.
Cisco IOS Interface and Hardware Component Command Reference
1719
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces tunnel
Field Description
giants Number of packets that are discarded because they exceed the maximum packet
size of the medium.
CRC Number of cyclic redundancy checksums generated by the originating LAN station
or far-end device that do not match the checksum calculated from the data received.
On a LAN, this usually indicates noise or transmission problems on the LAN
interface or the LAN bus itself. A high number of CRCs is usually the result of a
station transmitting bad data.
frame Number of packets received incorrectly having a CRC error and a noninteger
number of octets.
overrun Number of times the serial receiver hardware was unable to hand received data to
a hardware buffer because the input rate exceeded the receiver’s ability to handle
the data.
ignored Number of received packets ignored by the interface because the interface hardware
ran low on internal buffers. These buffers are different than the system buffers
mentioned previously in the buffer description. Broadcast storms and bursts of
noise can cause the ignored count to be increased.
abort Illegal sequence of one bits on a serial interface. This usually indicates a clocking
problem between the serial interface and the data link equipment.
packets output Total number of messages transmitted by the system.
bytes Total number of bytes, including data and MAC encapsulation, transmitted by the
system.
underruns Number of times that the far-end transmitter has been running faster than the
near-end router’s receiver can handle. This may never be reported on some
interfaces.
output errors Sum of all errors that prevented the final transmission of datagrams out of the
interface being examined. Note that this may not balance with the sum of the
enumerated output errors, because some datagrams may have more than one error,
and others may have errors that do not fall into any of the specifically tabulated
categories.
collisions Number of messages retransmitted because of an Ethernet collision. Some collisions
are normal. However, if your collision rate climbs to around 4 or 5 percent, you
should consider verifying that there is no faulty equipment on the segment and/or
moving some existing stations to a new segment. A packet that collides is counted
only once in output packets.
interface resets Number of times an interface has been reset. The interface may be reset by the
administrator or automatically when an internal error occurs.
restarts Number of times that the controller was restarted because of errors.
preferred If the route is not available, forwards the traffic using any available route.
Cisco IOS Interface and Hardware Component Command Reference
1720
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces tunnel
Field Description
mandatory Drops the traffic if the route is not available.
Related Commands Command Description
show interfaces Displays statistics for all interfaces configured on the router or access server.
show ip route Displays the current state of the routing table.
Cisco IOS Interface and Hardware Component Command Reference
1721
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces ucse
show interfaces ucse
To display Cisco UCS E-Series Server interface statistics, use the show interfaces ucse command in privileged
EXEC mode.
show interfaces ucse slot/subslot/ucse-interface
[{accounting|controller|counters|crb|dampening|description|etherchannel|history|irb|mac-accounting|monitor|mpls-exp|precedence|stats|summary|switchport}]
Syntax Description slot/ Number of the router slot in which the server module is installed.
Note For the NIM E-Series NCE, the slot number is 0.
subslot Number of the subslot in which the server module is installed.
Note For Cisco UCS E-Series Servers and the SM E-Series NCE, the subslot number
is 0.
ucse-interface Number of the UCSE interface.
Note For Cisco UCS E-Series Servers, the UCSE interface number can be 0 or 1.
accounting (Optional) Displays the number of packets of each protocol type that have been sent
through the interface.
controller (Optional) Displays the interface, configuration, and controller status.
counters (Optional) Displays the interface counters.
crb (Optional) Displays interface routing or bridging information.
dampening (Optional) Displays interface dampening information.
description (Optional) Displays the interface description.
etherchannel (Optional) Displays interface Ether Channel information.
history (Optional) Displays interface history.
irb (Optional) Displays interface routing or bridging information.
mac-accounting (Optional) Displays interface MAC accounting information.
monitor (Optional) Displays interface continuously.
mpls-exp (Optional) Displays interface Multiprotocol Label Switching (MPLS) experimental
accounting information.
precedence (Optional) Displays interface precedence accounting information.
stats (Optional) Displays the switching path, the packets in and packets out, and the characters
in and characters out.
summary (Optional) Displays the interface summary.
Cisco IOS Interface and Hardware Component Command Reference
1722
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces ucse
switchport (Optional) Displays the switch port interface information.
Command Modes
Privileged EXEC (#)
Command History Release Modification
Cisco IOS XE Release 3.9S This command was introduced on the Cisco UCS E-Series Servers installed
in the Cisco 4400 Series Integrated Services Router (ISR).
Cisco IOS XE Release 3.15S This command was supported on an additional platform: the NIM E-Series
Network Compute Engine (NIM E-Series NCE) installed in a Cisco ISR 4000
Series.
Examples The following example provides sample output from the show interfaces ucse slot/0/0 switchport
command in an E-Series Server installed in a Cisco ISR 4000 series:
Router# show interfaces ucse 1/0/0 switchport
Name: ucse 1/0/0
Switchport: Enabled
Administrative mode: trunk
Operational Mode: trunk
Administrative Trunking Encapsulation: dot1q
Operational Trunking Encapsulation: native
Negotiation of Trunking: Disabled
Trunking Native Mode VLAN: 2352
Trunking VLANs Enabled: 1-2349,2450-4094
Voice VLAN: none
Cisco IOS Interface and Hardware Component Command Reference
1723
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces unidirectional
show interfaces unidirectional
To display the operational state of an interface with a receive-only transceiver, use the
showinterfacesunidirectional command in user EXEC or privileged EXEC mode.
show interfaces [interface interface-number] unidirectional [module number]
Syntax Description interface (Optional) Interface type; possible valid values are gigabitethernet and
tengigabitethernet
interface-number (Optional) Module and port number; see the “Usage Guidelines” section for valid values.
module number (Optional) Specifies the module number; see the “Usage Guidelines” section for valid
values.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(18)SXE Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines If you do not specify a keyword, only information for trunking ports is displayed.
The interface-number designates the module and port number. Valid values depend on the chassis and module
that are used. For example, if you have a 48-port 10/100BASE-T Ethernet module that is installed in a 13-slot
chassis, valid values for the slot number are from 2 to 13 and valid values for the port number are from 1 to
48.
The modulenumber keyword and argument designate the module number and limit the display to interfaces
on the module. Valid values depend on the chassis that is used. For example, if you have a 13-slot chassis,
valid values for the module number are from 2 to 13.
Examples This example shows how to display the operational state of an interface with a receive-only transceiver:
Router# show interfaces gigabitethernet 5/2 unidirectional
Unidirectional configuration mode: send only
Unidirectional operational mode: receive only
CDP neighbour unidirectional configuration mode: off
Router#
Related Commands Command Description
show interfaces status Displays the interface status or a list of interfaces in an error-disabled state on
LAN ports only.
unidirectional Configures the software-based UDE.
Cisco IOS Interface and Hardware Component Command Reference
1724
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces vg-anylan
show interfaces vg-anylan
To display the information about the 100VG-AnyLAN port adapter on Cisco 7200 series routers and Cisco
7500 series routers, use the showinterfacesvg-anylan command in user EXEC or privileged EXEC mode.
Cisco 7200 Series
show interfaces vg-anylan [slot/port]
Cisco 7500 Series with VIPs
show interfaces vg-anylan [slot/port-adapter/port]
Syntax Description slot (Optional) Slot number. Refer to the appropriate hardware manual for slot and port
information.
port (Optional) Port number. Refer to the appropriate hardware manual for slot and port
information.
port-adapter (Optional) Port adapter number. Refer to the appropriate hardware manual for information
about port adapter compatibility.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
11.3 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples The following is sample output from the showinterfacesvg-anylan command:
Router# show interfaces vg-anylan 3/0/0
VG-AnyLAN3/0/0 is up, line protocol is up
Hardware is cyBus VG-AnyLAN Interface
Frame type is 802.3, address is 0060.3e64.2460 (bia 0060.3e64.2460)
Internet address is 10.1.1.5/16
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec, rely 255/255, load 1/255
Encapsulation ARPA, loopback not set, keepalive set (10 sec)
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:00:26, output 00:00:09, output hang never
Last clearing of “show interface” counters never
Queueing strategy: fifo
Output queue 0/40, 0 drops; input queue 0/75, 0 drops
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
5316 packets input, 857349 bytes, 0 no buffer
Received 5310 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 input packets with dribble condition detected
7920 packets output, 754259 bytes, 0 underruns
Cisco IOS Interface and Hardware Component Command Reference
1725
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces vg-anylan
0 output errors, 0 collisions, 2 interface resets
0 output buffer failures, 0 output buffers swapped out
0 vg alignment error, 0 vg balance error
0 vg invalid ipm error, 0 vg symbol error
0 vg skew error, 0 vg frame delimit error
0 vg high priority packets, 0 vg high priority octets
0 output errors, 0 collisions, 2 interface resets
0 output buffer failures, 0 output buffers swapped out
0 vg alignment error, 0 vg balance error
0 vg invalid ipm error, 0 vg symbol error
0 vg skew error, 0 vg frame delimit error
0 vg high priority packets, 0 vg high priority octets
The table below describes significant fields shown in the display.
Table 164: show interfaces vg-anylan Field Descriptions
Field Description
VG-AnyLAN3/0/0 is up, Indicates if the interface hardware is currently active and can transmit and
line protocol is up receive or if it has been taken down by an administrator.
Hardware is cyBus Hardware type.
VG-AnyLAN
Frame type is 803.2 Currently the frame type supported is 803.2.
Internet address Internet address and subnet mask.
MTU Maximum transmission unit of the interface.
BW Bandwidth of the interface, in kilobits per second.
DLY Delay of the interface, in microseconds.
rely Reliability of the interface as a fraction of 255 (255/255 is 100 percent
reliability), calculated as an exponential average over 5 minutes.
load Load on the interface as a fraction of 255 (255/255 is completely saturated),
calculated as an exponential average over 5 minutes. The calculation uses the
value from the bandwidth interface configuration command.
Encapsulation Encapsulation method assigned to the interface.
loopback Indicates if loopbacks are set.
keepalive Indicates if keepalives are set.
ARA type ARP type on the interface.
Last input Number of hours, minutes, and seconds since the last packet was successfully
received by an interface and processed locally on the router. Useful for knowing
when a dead interface failed. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
Cisco IOS Interface and Hardware Component Command Reference
1726
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces vg-anylan
Field Description
output Number of hours, minutes, and seconds since the last packet was successfully
transmitted by an interface. This counter is updated only when packets are
process-switched, not when packets are fast-switched.
output hang Number of hours, minutes, and seconds (or never) since the interface was last
reset because of a transmission that took too long. When the number of hours
in any of the “last” fields exceeds 24 hours, the number of days and hours is
printed. If that field overflows, asterisks are printed.
last clearing Time at which the counters that measure cumulative statistics (such as number
of bytes transmitted and received) shown in this report were last reset to zero.
Variables that might affect routing (for example, load and reliability) are not
cleared when the counters are cleared.
*** indicates the elapsed time is too large to be displayed.
0:00:00 indicates the counters were cleared more than 231 ms (and less than
232 ms) ago.
Queueing strategy First-in, first-out queueing strategy (other queueing strategies that you might
see are priority-list, custom-list, and weighted fair).
Output queue, drops input Number of packets in output and input queues. Each number is followed by a
queue, drops slash, the maximum size of the queue, and the number of packets dropped
because a queue was full.
5 minute input rate 5 Average number of bits and packets received or transmitted per second in the
minute output rate last 5 minutes.
packets input Total number of error-free packets received by the system.
bytes (input) Total number of bytes, including data and MAC encapsulation, in the error-free
packets received by the system.
no buffer Number of received packets discarded because there was no buffer space in the
main system. Compare with ignored count. Broadcast storms on Ethernet
networks and bursts of noise on serial lines are often responsible for no input
buffer events.
broadcasts Total number of broadcast or multicast packets received by the interface.
runts Number of packets that are discarded because they are smaller than the minimum
packet size of the medium.
giants Number of packets that are discarded because they exceed the maximum packet
size of the medium.
input errors Total number of no buffer, runts, giants, CRCs, frame, overrun, ignored, and
abort counts. Other input-related errors can also increment the count, so that
this sum might not balance with the other counts.
Cisco IOS Interface and Hardware Component Command Reference
1727
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces vg-anylan
Field Description
CRC Cyclic redundancy checksum generated by the originating LAN station or
far-end device does not match the checksum calculated from the data received.
On a LAN, this usually indicates noise or transmission problems on the LAN
interface or the LAN bus itself. A high number of CRCs is usually the result of
collisions or a station transmitting bad data. On a serial link, CRCs usually
indicate noise, gain hits or other transmission problems on the data link.
frame Number of packets received incorrectly having a CRC error and a noninteger
number of octets. On a serial line, this is usually the result of noise or other
transmission problems.
overrun Number of times the serial receiver hardware was unable to hand received data
to a hardware buffer because the input rate exceeded the receiver’s ability to
handle the data.
ignored Number of received packets ignored by the interface because the interface
hardware ran low on internal buffers. These buffers are different than the system
buffers mentioned previously in the buffer description. Broadcast storms and
bursts of noise can cause the ignored count to be incremented.
abort Illegal sequence of one bits on the interface.
input packets with dribble Dribble bit error indicates that a frame is slightly too long. This frame error
condition detected counter is incremented just for informational purposes; the router accepts the
frame.
packets output Total number of messages transmitted by the system.
bytes (output) Total number of bytes, including data and MAC encapsulation, transmitted by
the system.
underruns Number of times that the far-end transmitter has been running faster than the
near-end router’s receiver can handle.
output errors Sum of all errors that prevented the final transmission of datagrams out of the
interface being examined. Note that this might not balance with the sum of the
enumerated output errors, as some datagrams can have more than one error,
and others can have errors that do not fall into any of the specifically tabulated
categories.
collisions Number of messages retransmitted because of an Ethernet collision. A packet
that collides is counted only once in output packets.
interface resets Number of times an interface has been completely reset. This can happen if
packets queued for transmission were not sent within a certain interval. If the
system notices that the carrier detect line of an interface is up, but the line
protocol is down, it periodically resets the interface in an effort to restart it.
Interface resets can also occur when an unrecoverable interface processor error
occurred, or when an interface is looped back or shut down.
output buffer failures Number of times that a packet was not output from the output hold queue
because of a shortage of MEMD shared memory.
Cisco IOS Interface and Hardware Component Command Reference
1728
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces vg-anylan
Field Description
output buffers swapped out Number of packets stored in main memory when the output queue is full;
swapping buffers to main memory prevents packets from being dropped when
output is congested. The number is high when traffic is bursty.
vg alignment error Number of nonoctets received.
vg balance error Number of incorrect balanced symbols received.
vg invalid ipm error Number of packets received with an invalid packet marker (IPM).
vg symbol error Number of symbols received that were not correctly decoded.
vg skew error Number of skews between four pairs of twisted-pair wire that exceeded the
allowable skew.
vg frame delimit error Number of start-of-frame errors or false-start errors received.
vg high priority packets Number of high-priority packets received.
vg high priority octets Number of high-priority octets received.
Related Commands Command Description
interface vg-anylan Specifies the interface on a 100VG-AnyLAN port adapter and enters interface
configuration mode on Cisco 7200 series routers and Cisco 7500 series routers.
Cisco IOS Interface and Hardware Component Command Reference
1729
show hw-module slot tech-support through show interfaces vg-anylan
show interfaces vg-anylan
Cisco IOS Interface and Hardware Component Command Reference
1730
show interfaces vlan mapping through show scp
• show interfaces vlan mapping, on page 1734
• show interfaces wlan-controller, on page 1735
• show ip interface, on page 1736
• show ipc, on page 1745
• show ipc hog-info, on page 1751
• show ipv6 ospf interface, on page 1753
• show l2protocol-tunnel, on page 1759
• show l3-mgr, on page 1763
• show l3vpn encapsulation ip, on page 1765
• show lacp, on page 1766
• show link state group, on page 1772
• show mac-address-table dynamic, on page 1773
• show mls asic, on page 1777
• show mls ip, on page 1778
• show mls ipx, on page 1781
• show mobility, on page 1783
• show module, on page 1785
• show msfc, on page 1788
• show network-clocks, on page 1792
• show pagp, on page 1795
• show pas caim, on page 1797
• show pas eswitch address, on page 1808
• show pas i82543 interface, on page 1809
• show pas isa controller, on page 1814
• show pas isa interface, on page 1815
• show pas vam controller, on page 1818
• show pas vam interface, on page 1819
• show pas y88e8k interface, on page 1823
• show pci aim, on page 1825
• show platform, on page 1826
• show platform acl software-switched, on page 1838
• show platform atom disp-tbl backup, on page 1839
• show platform atom disp-tbl local-vc-label, on page 1840
Cisco IOS Interface and Hardware Component Command Reference
1731
show interfaces vlan mapping through show scp
• show platform atom imp-tbl backup, on page 1841
• show platform atom imp-tbl remote-vc-label, on page 1842
• show platform atom tbl-summary, on page 1843
• show platform condition, on page 1844
• show platform diag, on page 1845
• show platform discover-devices, on page 1849
• show platform dwdm alarm history, on page 1852
• show platform hardware capacity, on page 1854
• show platform hardware capacity rewrite-engine, on page 1861
• show platform hardware interface, on page 1865
• show platform hardware network-clocks, on page 1869
• show platform hardware pp active interface all, on page 1871
• show platform hardware qfp active feature cef-mpls urpf, on page 1872
• show platform hardware qfp active feature cef-mpls prefix ip, on page 1873
• show platform hardware qfp active feature cef-mpls prefix mpls, on page 1875
• show platform hardware qfp active feature multicast, on page 1877
• show platform hardware qfp active infrastructure punt, on page 1884
• show platform hardware qfp active interface if-name statistics, on page 1888
• show platform hardware qfp statistics drop, on page 1891
• show platform hardware qfp interface, on page 1894
• show platform hardware slot, on page 1900
• show platform hardware throughput level, on page 1910
• show platform hardware subslot, on page 1911
• show platform hardware subslot (4400), on page 1913
• show platform hardware transceiver, on page 1916
• show platform isg memory, on page 1918
• show platform mgf, on page 1919
• show platform slot r0 pcie status, on page 1922
• show platform software agent iomd, on page 1923
• show platform software memory, on page 1925
• show platform software mount, on page 1931
• show platform software infrastructure punt-keepalive, on page 1935
• show platform software interface summary, on page 1937
• show platform software process list, on page 1939
• show platform software process memory, on page 1949
• show platform software ptp foreign-master, on page 1954
• show platform software status control-processor, on page 1956
• show platform software punt-policer, on page 1960
• show platform process slot, on page 1961
• show platform software tech-support, on page 1963
• show platform software vnic-if interface-mapping, on page 1965
• show platform time-source, on page 1967
• show plim fpga, on page 1968
• show policy-map interface, on page 1970
• show power, on page 2017
• show power inline, on page 2021
Cisco IOS Interface and Hardware Component Command Reference
1732
show interfaces vlan mapping through show scp
• show process | include persis, on page 2023
• show protection-group, on page 2024
• show ptp clock dataset, on page 2025
• show ptp clock dataset parent, on page 2027
• show ptp clock dataset time-properties, on page 2029
• show ptp clock running, on page 2031
• show ptp port dataset foreign-master, on page 2033
• show ptp port dataset port, on page 2035
• show pxf cpu access-lists, on page 2037
• show pxf cpu iedge, on page 2043
• show pxf cpu qos, on page 2044
• show pxf dma, on page 2046
• show pxf max-logical-interfaces, on page 2049
• show qm-sp port-data, on page 2050
• show rbscp, on page 2052
• show redundancy, on page 2056
• show redundancy (HSA redundancy), on page 2063
• show redundancy interchassis, on page 2064
• show redundancy interlink, on page 2065
• show rpc, on page 2067
• show running configuration | include mode, on page 2069
• show scp, on page 2070
Cisco IOS Interface and Hardware Component Command Reference
1733
show interfaces vlan mapping through show scp
show interfaces vlan mapping
show interfaces vlan mapping
To display the status of a virtual local area network (VLAN) mapping on a port, use the
showinterfacesvlanmapping command in user EXEC or privileged EXEC mode.
show interfaces interface interface-number vlan mapping
Syntax Description interface Interface type; possible valid values are ethernet, fastethernet, gigabitethernet,
tengigabitethernet, pos, atm, and ge-wan.
interface-number Module and port number; see the “Usage Guidelines” section for valid values.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(17b)SXA Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The pos, atm, and ge-wan keywords are supported on Cisco 7600 series routers that are configured with a
Supervisor Engine 2.
The interface-number designates the module and port number. Valid values depend on the chassis and module
that are used. For example, if you have a 48-port 10/100BASE-T Ethernet module that is installed in a 13-slot
chassis, valid values for the slot number are from 1 to 13 and valid values for the port number are from 1 to
48.
Examples This example shows how to list all of the VLAN mappings that are configured on a port and indicate
whether such mappings are enabled or disabled on the port:
Router# show interfaces gigabitethernet 5/2 vlan mapping
State: enabled
Original VLAN Translated VLAN
------------- ---------------
1649 755
Router#
Related Commands Command Description
show vlan mapping Registers a mapping of an 802.1Q VLAN to an ISL VLAN.
switchport vlan mapping enable Enables VLAN mapping per switch port.
Cisco IOS Interface and Hardware Component Command Reference
1734
show interfaces vlan mapping through show scp
show interfaces wlan-controller
show interfaces wlan-controller
To show the Cisco Wireless Local Area Network (WLAN) controller network module interfaces on the router,
use the showinterfaceswlan-controller command in privileged EXEC mode.
show interfaces wlan-controller slot/unit
Syntax Description slot/unit Specifies the router slot and unit numbers for the WLAN controller network module.
Command Default None
Command Modes Privileged EXEC
Command History Release Modification
12.4(2)XA1 This command was introduced on the router software.
12.4(6)T This command was integrated into Cisco IOS Release 12.4(6)T.
Examples The following example shows how to read the hardware information about the interface WLAN
controller in the router:
Router# show interfaces wlan-controller 1/0
wlan-controller1/0 is up, line protocol is up
Hardware is I82559FE, address is 0005.9a3d.7450 (bia 0005.9a3d.7450)
Internet address is 30.0.0.1/24
MTU 1500 bytes, BW 100000 Kbit, DLY 100 usec,
reliability 255/255, txload 1/255, rxload 1/255
Encapsulation 802.1Q Virtual LAN, Vlan ID 1., loopback not set
Keepalive set (10 sec)
Full-duplex, 100Mb/s, 100BaseTX/FX
ARP type: ARPA, ARP Timeout 04:00:00
Last input 00:00:05, output 00:00:03, output hang never
Last clearing of "show interface" counters never
Input queue: 0/75/0/0 (size/max/drops/flushes); Total output drops: 0
Queueing strategy: fifo
Output queue: 0/40 (size/max)
5 minute input rate 0 bits/sec, 0 packets/sec
5 minute output rate 0 bits/sec, 0 packets/sec
2400779 packets input, 143127299 bytes
Received 2349587 broadcasts, 0 runts, 0 giants, 0 throttles
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
0 watchdog
0 input packets with dribble condition detected
468232 packets output, 106333102 bytes, 0 underruns
0 output errors, 0 collisions, 3 interface resets
0 babbles, 0 late collision, 0 deferred
0 lost carrier, 1 no carrier
0 output buffer failures, 0 output buffers swapped out
Cisco IOS Interface and Hardware Component Command Reference
1735
show interfaces vlan mapping through show scp
show ip interface
show ip interface
To display the usability status of interfaces configured for IP, use the show ip interface command in privileged
EXEC mode.
show ip interface [type number] [brief]
Syntax Description type (Optional) Interface type.
number (Optional) Interface number.
brief (Optional) Displays a summary of the usability status information for each interface.
Command Default The full usability status is displayed for all interfaces configured for IP.
Command Modes Privileged EXEC (#)
Command History Release Modification
10.0 This command was introduced.
12.0(3)T The command output was modified to show the status of the ip wccp redirect
out and ip wccp redirect exclude add in commands.
12.2(14)S The command output was modified to display the status of NetFlow on a
subinterface.
12.2(15)T The command output was modified to display the status of NetFlow on a
subinterface.
12.3(6) The command output was modified to identify the downstream VPN routing
and forwarding (VRF) instance in the output.
12.3(14)YM2 The command output was modified to show the usability status of interfaces
configured for Multiprocessor Forwarding (MPF) and implemented on the Cisco
7301 and Cisco 7206VXR routers.
12.2(14)SX This command was implemented on the Supervisor Engine 720.
12.2(17d)SXB This command was integrated into Cisco IOS 12.2(17d)SXB on the Supervisor
Engine 2, and the command output was changed to include NDE for hardware
flow status.
12.4(4)T This command was integrated into Cisco IOS Release 12.4(4)T.
12.2(28)SB This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2 The command output was modified to display information about the Unicast
Reverse Path Forwarding (RPF) notification feature.
Cisco IOS Interface and Hardware Component Command Reference
1736
show interfaces vlan mapping through show scp
show ip interface
Release Modification
12.4(20)T The command output was modified to display information about the Unicast
RPF notification feature.
12.2(33)SXI2 This command was modified. The command output was modified to display
information about the Unicast RPF notification feature.
Cisco IOS XE Release 2.5 This command was modified. This command was implemented on the Cisco
ASR 1000 Series Aggregation Services Routers.
Cisco IOS XE Release This command was implemented on Cisco 4400 Series ISRs.
3.9S
Usage Guidelines The Cisco IOS software automatically enters a directly connected route in the routing table if the interface is
usable (which means that it can send and receive packets). If an interface is not usable, the directly connected
routing entry is removed from the routing table. Removing the entry lets the software use dynamic routing
protocols to determine backup routes to the network, if any.
If the interface can provide two-way communication, the line protocol is marked "up." If the interface hardware
is usable, the interface is marked "up."
If you specify an optional interface type, information for that specific interface is displayed. If you specify
no optional arguments, information on all the interfaces is displayed.
When an asynchronous interface is encapsulated with PPP or Serial Line Internet Protocol (SLIP), IP fast
switching is enabled. A show ip interface command on an asynchronous interface encapsulated with PPP or
SLIP displays a message indicating that IP fast switching is enabled.
You can use the show ip interface brief command to display a summary of the router interfaces. This command
displays the IP address, the interface status, and other information.
The show ip interface brief command does not display any information related to Unicast RPF.
Examples The following example shows configuration information for interface Gigabit Ethernet 0/3. In this
example, the IP flow egress feature is configured on the output side (where packets go out of the
interface), and the policy route map named PBRNAME is configured on the input side (where packets
come into the interface).
Router# show running-config interface gigabitethernet 0/3
interface GigabitEthernet0/3
ip address 10.1.1.1 255.255.0.0
ip flow egress
ip policy route-map PBRNAME
duplex auto
speed auto
media-type gbic
negotiation auto
end
The following example shows interface information on Gigabit Ethernet interface 0/3. In this example,
MPF is enabled, and both Policy Based Routing (PBR) and NetFlow features are not supported by
MPF and are ignored.
Router# show ip interface gigabitethernet 0/3
Cisco IOS Interface and Hardware Component Command Reference
1737
show interfaces vlan mapping through show scp
show ip interface
GigabitEthernet0/3 is up, line protocol is up
Internet address is 10.1.1.1/16
Broadcast address is 255.255.255.255
Address determined by setup command
MTU is 1500 bytes
Helper address is not set
Directed broadcast forwarding is disabled
Outgoing access list is not set
Inbound access list is not set
Proxy ARP is enabled
Local Proxy ARP is disabled
Security level is default
Split horizon is enabled
ICMP redirects are always sent
ICMP unreachables are always sent
ICMP mask replies are never sent
IP fast switching is enabled
IP fast switching on the same interface is disabled
IP Flow switching is disabled
IP CEF switching is enabled
IP Feature Fast switching turbo vector
IP VPN Flow CEF switching turbo vector
IP multicast fast switching is enabled
IP multicast distributed fast switching is disabled
IP route-cache flags are Fast, CEF
Router Discovery is disabled
IP output packet accounting is disabled
IP access violation accounting is disabled
TCP/IP header compression is disabled
RTP/IP header compression is disabled
Policy routing is enabled, using route map PBR
Network address translation is disabled
BGP Policy Mapping is disabled
IP Multi-Processor Forwarding is enabled
IP Input features, "PBR",
are not supported by MPF and are IGNORED
IP Output features, "NetFlow",
are not supported by MPF and are IGNORED
The following example identifies a downstream VRF instance. In the example, "Downstream VPN
Routing/Forwarding "D"" identifies the downstream VRF instance.
Router# show ip interface virtual-access 3
Virtual-Access3 is up, line protocol is up
Interface is unnumbered. Using address of Loopback2 (10.0.0.8)
Broadcast address is 255.255.255.255
Peer address is 10.8.1.1
MTU is 1492 bytes
Helper address is not set
Directed broadcast forwarding is disabled
Outgoing access list is not set
Inbound access list is not set
Proxy ARP is enabled
Local Proxy ARP is disabled
Security level is default
Split horizon is enabled
ICMP redirects are always sent
ICMP unreachables are always sent
ICMP mask replies are never sent
IP fast switching is enabled
IP fast switching on the same interface is enabled
IP Flow switching is disabled
IP CEF switching is enabled
Cisco IOS Interface and Hardware Component Command Reference
1738
show interfaces vlan mapping through show scp
show ip interface
IP Feature Fast switching turbo vector
IP VPN CEF switching turbo vector
VPN Routing/Forwarding "U"
Downstream VPN Routing/Forwarding "D"
IP multicast fast switching is disabled
IP multicast distributed fast switching is disabled
IP route-cache flags are Fast, CEF
Router Discovery is disabled
IP output packet accounting is disabled
IP access violation accounting is disabled
TCP/IP header compression is disabled
RTP/IP header compression is disabled
Policy routing is disabled
Network address translation is disabled
WCCP Redirect outbound is disabled
WCCP Redirect inbound is disabled
WCCP Redirect exclude is disabled
BGP Policy Mapping is disabled
The following example shows the information displayed when Unicast RPF drop-rate notification
is configured:
Router# show ip interface ethernet 2/3
Ethernet2/3 is up, line protocol is up
Internet address is 10.0.0.4/16
Broadcast address is 255.255.255.255
Address determined by non-volatile memory
MTU is 1500 bytes
Helper address is not set
Directed broadcast forwarding is disabled
Outgoing access list is not set
Inbound access list is not set
Proxy ARP is enabled
Local Proxy ARP is disabled
Security level is default
Split horizon is enabled
ICMP redirects are always sent
ICMP unreachables are always sent
ICMP mask replies are never sent
IP fast switching is disabled
IP Flow switching is disabled
IP CEF switching is disabled
IP Null turbo vector
IP Null turbo vector
IP multicast fast switching is disabled
IP multicast distributed fast switching is disabled
IP route-cache flags are No CEF
Router Discovery is disabled
IP output packet accounting is disabled
IP access violation accounting is disabled
TCP/IP header compression is disabled
RTP/IP header compression is disabled
Probe proxy name replies are disabled
Policy routing is disabled
Network address translation is disabled
WCCP Redirect outbound is disabled
WCCP Redirect inbound is disabled
WCCP Redirect exclude is disabled
BGP Policy Mapping is disabled
Cisco IOS Interface and Hardware Component Command Reference
1739
show interfaces vlan mapping through show scp
show ip interface
Unicast RPF Information
Input features: uRPF
IP verify source reachable-via RX, allow default
0 verification drops
0 suppressed verification drops
0 verification drop-rate
Router#
The following example shows how to display the usability status for a specific VLAN:
Router# show ip interface vlan 1
Vlan1 is up, line protocol is up
Internet address is 10.0.0.4/24
Broadcast address is 255.255.255.255
Address determined by non-volatile memory
MTU is 1500 bytes
Helper address is not set
Directed broadcast forwarding is disabled
Outgoing access list is not set
Inbound access list is not set
Proxy ARP is enabled
Local Proxy ARP is disabled
Security level is default
Split horizon is enabled
ICMP redirects are always sent
ICMP unreachables are always sent
ICMP mask replies are never sent
IP fast switching is enabled
IP fast switching on the same interface is disabled
IP Flow switching is disabled
IP CEF switching is enabled
IP Fast switching turbo vector
IP Normal CEF switching turbo vector
IP multicast fast switching is enabled
IP multicast distributed fast switching is disabled
IP route-cache flags are Fast, CEF
Router Discovery is disabled
IP output packet accounting is disabled
IP access violation accounting is disabled
TCP/IP header compression is disabled
RTP/IP header compression is disabled
Probe proxy name replies are disabled
Policy routing is disabled
Network address translation is disabled
WCCP Redirect outbound is disabled
WCCP Redirect inbound is disabled
WCCP Redirect exclude is disabled
BGP Policy Mapping is disabled
Sampled Netflow is disabled
IP multicast multilayer switching is disabled
Netflow Data Export (hardware) is enabled
The table below describes the significant fields shown in the display.
Cisco IOS Interface and Hardware Component Command Reference
1740
show interfaces vlan mapping through show scp
show ip interface
Table 165: show ip interface Field Descriptions
Field Description
Virtual-Access3 is up Shows whether the interface hardware is usable (up). For an interface
to be usable, both the interface hardware and line protocol must be
up.
Broadcast address is Broadcast address.
Peer address is Peer address.
MTU is MTU value set on the interface, in bytes.
Helper address Helper address, if one is set.
Directed broadcast forwarding Shows whether directed broadcast forwarding is enabled.
Outgoing access list Shows whether the interface has an outgoing access list set.
Inbound access list Shows whether the interface has an incoming access list set.
Proxy ARP Shows whether Proxy Address Resolution Protocol (ARP) is enabled
for the interface.
Security level IP Security Option (IPSO) security level set for this interface.
Split horizon Shows whether split horizon is enabled.
ICMP redirects Shows whether redirect messages will be sent on this interface.
ICMP unreachables Shows whether unreachable messages will be sent on this interface.
ICMP mask replies Shows whether mask replies will be sent on this interface.
IP fast switching Shows whether fast switching is enabled for this interface. It is
generally enabled on serial interfaces, such as this one.
IP Flow switching Shows whether Flow switching is enabled for this interface.
IP CEF switching Shows whether Cisco Express Forwarding switching is enabled for
the interface.
Downstream VPN Shows the VRF instance where the PPP peer routes and AAA per-user
Routing/Forwarding "D" routes are being installed.
IP multicast fast switching Shows whether multicast fast switching is enabled for the interface.
IP route-cache flags are Fast Shows whether NetFlow is enabled on an interface. Displays "Flow
init" to specify that NetFlow is enabled on the interface. Displays
"Ingress Flow" to specify that NetFlow is enabled on a subinterface
using the ip flow ingresscommand. Shows "Flow" to specify that
NetFlow is enabled on a main interface using the ip route-cache flow
command.
Cisco IOS Interface and Hardware Component Command Reference
1741
show interfaces vlan mapping through show scp
show ip interface
Field Description
Router Discovery Shows whether the discovery process is enabled for this interface. It
is generally disabled on serial interfaces.
IP output packet accounting Shows whether IP accounting is enabled for this interface and what
the threshold (maximum number of entries) is.
TCP/IP header compression Shows whether compression is enabled.
WCCP Redirect outbound is disabled Shows the status of whether packets received on an interface are
redirected to a cache engine. Displays "enabled" or "disabled."
WCCP Redirect exclude is disabled Shows the status of whether packets targeted for an interface will be
excluded from being redirected to a cache engine. Displays "enabled"
or "disabled."
Netflow Data Export (hardware) is NetFlow Data Expert (NDE) hardware flow status on the interface.
enabled
The table below describes the significant fields shown in the display.
Display a Summary of Interfaces on Cisco 4400 Series ISR: Example
The following is a sample out of the show ip interface brief command displaying a summary of the
interfaces and their status on the device.
Router#show ip interface brief
Interface IP-Address OK? Method Status Protocol
GigabitEthernet0/0/0 unassigned YES NVRAM down down
GigabitEthernet0/0/1 unassigned YES NVRAM down down
GigabitEthernet0/0/2 unassigned YES NVRAM down down
GigabitEthernet0/0/3 unassigned YES NVRAM down down
Serial1/0/0 unassigned YES unset down down
GigabitEthernet0 unassigned YES NVRAM up up
Display a Summary of the Usability Status: Example
The following example shows how to display a summary of the usability status information for each
interface:
Router# show ip interface brief
Interface IP-Address OK? Method Status Protocol
Ethernet0 10.108.00.5 YES NVRAM up up
Ethernet1 unassigned YES unset administratively down down
Loopback0 10.108.200.5 YES NVRAM up up
Serial0 10.108.100.5 YES NVRAM up up
Serial1 10.108.40.5 YES NVRAM up up
Serial2 10.108.100.5 YES manual up up
Serial3 unassigned YES unset administratively down down
Cisco IOS Interface and Hardware Component Command Reference
1742
show interfaces vlan mapping through show scp
show ip interface
Table 166: show ip interface brief Field Descriptions
Field Description
Interface Type of interface.
IP-Address IP address assigned to the interface.
OK? "Yes" means that the IP Address is valid. "No" means that the IP Address is not valid.
Method The Method field has the following possible values:
• RARP or SLARP--Reverse Address Resolution Protocol (RARP) or Serial Line Address
Resolution Protocol (SLARP) request.
• BOOTP--Bootstrap protocol.
• TFTP--Configuration file obtained from the TFTP server.
• manual--Manually changed by the command-line interface.
• NVRAM--Configuration file in NVRAM.
• IPCP--ip address negotiated command.
• DHCP--ip address dhcp command.
• unset--Unset.
• other--Unknown.
Status Shows the status of the interface. Valid values and their meanings are:
• up--Interface is up.
• down--Interface is down.
• administratively down--Interface is administratively down.
Protocol Shows the operational status of the routing protocol on this interface.
Related Commands Command Description
ip address Sets a primary or secondary IP address for an interface.
ip vrf autoclassify Enables VRF autoclassify on a source interface.
match ip source Specifies a source IP address to match to required route maps that have been set up
based on VRF connected routes.
route-map Defines the conditions for redistributing routes from one routing protocol into another
or to enable policy routing.
set vrf Enables VPN VRF selection within a route map for policy-based routing VRF selection.
Cisco IOS Interface and Hardware Component Command Reference
1743
show interfaces vlan mapping through show scp
show ip interface
Command Description
show ip arp Displays the ARP cache, in which SLIP addresses appear as permanent ARP table
entries.
show route-map Displays static and dynamic route maps.
Cisco IOS Interface and Hardware Component Command Reference
1744
show interfaces vlan mapping through show scp
show ipc
show ipc
To display interprocess communication (IPC) statistics, use the showipc command in privileged EXEC mode.
show ipc {nodes|ports [open]|queue|status [cumulative]|zones}
Syntax Description nodes Displays participating nodes.
ports Displays local and registered IPC ports.
open (Optional) Displays local IPC ports that have been opened by the current seat (node).
queue Displays information about the IPC retransmission queue and the IPC message queue.
status Displays the status of the local IPC server.
cumulative (Optional) Displays cumulative totals for the status counters of the local IPC server since the
router was rebooted.
zones Displays information about the IPC zones and seats.
Command Modes Privileged EXEC
Command History Release Modification
12.1(12c)EW This command was introduced.
12.2(15)T The cumulative keyword was added.
12.3(7)T The zones keyword was added.
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to 12.2(17d)SXB.
12.2(28)SB This command was integrated into Cisco IOS Release 12.2(28)SB.
Usage Guidelines The Cisco IOS version of IPC provides a reliable ordered delivery of messages using an underlying
platform driver transport or User Datagram Protocol (UDP) transport protocol.
Nodes
A node (referred to as a seat) is an intelligent element like a processor that can communicate using IPC services.
A seat is where entities and ports reside. A seat manager performs all the interprocessor communications by
receiving messages from the network and forwarding the messages to the appropriate port.
Ports
IPC communication endpoints (ports) receive and queue received IPC messages.
Queue
Cisco IOS Interface and Hardware Component Command Reference
1745
show interfaces vlan mapping through show scp
show ipc
Use the queue keyword to display information about the IPC retransmission queue and the IPC message
queue.
Status
Use thestatus keyword to display the IPC statistics that have been generated since a clearipcstatistics command
was entered. The showipcstatus command with the cumulative keyword displays the IPC statistics that have
been gathered since the router was rebooted, regardless of how many times the statistics have been cleared.
Zones
The IPC zone manager allows more than one group of IPC seats to exist to enable direct communication
between line cards and the route processor. Use thezones keyword to display the IPC zone and seat information.
Examples The following is sample output from the showipccommand with the nodeskeyword displaying the
participating seats (nodes):
Router# show ipc nodes
There are 6 nodes in this IPC realm.
ID Type Name Last Last
Sent Heard
0.10000 Local IPC Master 0 0
0.1060000 RSP-CY RSP IPC card slot 6 9 79
0.1050000 RSP-CY RSP IPC card slot 5 21 22
0.1080000 RSP-CY RSP IPC card slot 8 21 22
1.10000 Local IPC Master: -Zone#1 0 0
2.10000 Local IPC Master: -Zone#2
The table below describes the significant fields shown in the display.
Table 167: show ipc nodes Field Descriptions
Field Description
ID Port ID, which consists of a zone ID followed by the seat ID.
Type Type of seat (node).
Name Seat name.
Last Sent Sequence number of the message that was last sent.
Last Heard Sequence number of the in-sequence message that was last heard.
The following is sample output from the showipccommand with the portskeyword displaying the
local and registered IPC ports:
Router# show ipc ports
There are 11 ports defined.
Port ID Type Name (current/peak/total)
1.10000.1 unicast IPC Master:Zone
1.10000.2 unicast IPC Master:Echo
1.10000.3 unicast IPC Master:Control
1.10000.4 unicast Remote TTY Server Port
1.10000.5 unicast GALIOS RF :Active
index = 0 seat_id = 0x2020000 last sent = 0 heard = 1635 0/1/1635
1.10000.6 unicast GALIOS RED:Active
Cisco IOS Interface and Hardware Component Command Reference
1746
show interfaces vlan mapping through show scp
show ipc
index = 0 seat_id = 0x2020000 last sent = 0 heard = 2 0/1/2
2.2020000.3 unicast GALIOS IPC:Card 2:Control
2.2020000.4 unicast GALIOS RFS :Standby
2.2020000.5 unicast Slave: Remote TTY Client Port
2.2020000.6 unicast GALIOS RF :Standby
2.2020000.7 unicast GALIOS RED:Standby
RPC packets: current/peak/total 0/1/17
The table below describes the significant fields shown in the display.
Table 168: show ipc ports Field Descriptions
Field Description
Port ID Port ID, which consists of a zone ID followed by the seat ID.
Type Type of port.
Name Port name.
current/peak/total Displays information about the number of messages held by this IPC session.
The following is sample output from the showipccommand with the queuekeyword displaying
information about the IPC retransmission queue and the IPC message queue:
Router# show ipc queue
There are 0 IPC messages waiting for acknowledgement in the transmit queue.
There are 0 IPC messages waiting for a response.
There are 0 IPC messages waiting for additional fragments.
There are 0 IPC messages currently on the IPC inboundQ.
There are 0 messages currently in use by the system.
The following is sample output from the showipccommand with the statuskeyword displaying
information about the local IPC server:
Router# show ipc status
IPC System Status
Time last IPC stat cleared : never
This processor is the IPC master server.
Do not drop output of IPC frames for test purposes.
1000 IPC Message Headers Cached.
Rx Side Tx Side
Total Frames 189 140
Total from Local Ports 189 70
Total Protocol Control Frames 70 44
Total Frames Dropped 0 0
Service Usage
Total via Unreliable Connection-Less Service 145 0
Total via Unreliable Sequenced Connection-Less Svc 0 0
Total via Reliable Connection-Oriented Service 44 70
IPC Protocol Version 0
Total Acknowledgements 70 44
Total Negative Acknowledgements 0 0
Device Drivers
Total via Local Driver 0 0
Total via Platform Driver 0 70
Total Frames Dropped by Platform Drivers 0 0
Reliable Tx Statistics
Re-Transmission 0
Cisco IOS Interface and Hardware Component Command Reference
1747
show interfaces vlan mapping through show scp
show ipc
Re-Tx Timeout 0
Rx Errors Tx Errors
Unsupp IPC Proto Version 0 Tx Session Error 0
Corrupt Frame 0 Tx Seat Error 0
Duplicate Frame 0 Destination Unreachable 0
Out-of-Sequence Frame 0 Tx Test Drop 0
Dest Port does Not Exist 0 Tx Driver Failed 0
Rx IPC Msg Alloc Failed 0 Ctrl Frm Alloc Failed 0
Unable to Deliver Msg 0
Buffer Errors Misc Errors
IPC Msg Alloc 0 IPC Open Port 0
Emer IPC Msg Alloc 0 No HWQ 0
IPC Frame PakType Alloc 0 Hardware Error 0
IPC Frame MemD Alloc 0
Tx Driver Errors
No Transport 0
MTU Failure 0
Dest does not Exist 0
The table below describes the significant fields shown in the display.
Table 169: show ipc status Field Descriptions
Field Description
Time last IPC stat cleared Displays the time, in dd:hh:mm (or never), since the IPC statistics were last
cleared.
This processor is Shows whether the processor is the IPC master or an IPC slave.
IPC Message Headers Cached Number of message headers available in the IPC message cache.
Rx Side Information about IPC messages received.
Tx Side Information about IPC messages sent.
Service Usage Number of IPC messages received or sent via connectionless or
connection-oriented protocols.
IPC Protocol Version 0 Number of acknowledgements and negative acknowledgements received or
sent by the system.
Device Drivers Number of IPC messages received or sent using the underlying device drivers.
Reliable Tx Statistics Number of IPC messages that were retransmitted or that timed out on
retransmission using a reliable connection-oriented protocol.
Rx Errors Number of IPC messages received that displayed various internal frame or
delivery errors.
Tx Errors Number of IPC messages sent that displayed various transmission errors.
Buffer Errors Number of message allocation failures from the IPC message cache, IPC
emergency message cache, IPC frame allocation cache, and IPC frame
memory allocation cache.
Misc Errors Various miscellaneous errors that relate to the IPC open queue, to the
hardware queue, or to other hardware failures.
Cisco IOS Interface and Hardware Component Command Reference
1748
show interfaces vlan mapping through show scp
show ipc
Field Description
Tx Driver Errors Number of messages that relate to IPC transmission driver failures including
messages to or from a destination without a valid transport entity from the
seat; number of messages dropped because the packet size is larger than the
maximum transmission unit (MTU); and number of messages without a valid
destination address.
The following example shows how to display cumulative IPC counters for the local IPC server. Note
that the recent IPC clearing has not cleared the IPC counters because the cumulative keyword displays
the IPC statistics that have been generated since the router was rebooted.
Router# show ipc status cumulative
IPC System Status
Time last IPC stat cleared : 00:00:05
This processor is the IPC master server.
Do not drop output of IPC frames for test purposes.
1000 IPC Message Headers Cached.
Rx Side Tx Side
Total Frames 3473 184
Total from Local Ports 3473 92
Total Protocol Control Frames 92 54
Total Frames Dropped 0 0
Service Usage
Total via Unreliable Connection-Less Service 2449 0
Total via Unreliable Sequenced Connection-Less Svc 970 0
Total via Reliable Connection-Oriented Service 54 92
IPC Protocol Version 0
Total Acknowledgements 0 0
Total Negative Acknowledgements 0 0
Device Drivers
Total via Local Driver 0 0
Total via Platform Driver 0 92
Total Frames Dropped by Platform Drivers 0 0
Reliable Tx Statistics
Re-Transmission 0
Re-Tx Timeout 0
Rx Errors Tx Errors
Unsupp IPC Proto Version 0 Tx Session Error 0
Corrupt Frame 0 Tx Seat Error 0
Duplicate Frame 0 Destination Unreachable 0
Out-of-Sequence Frame 0 Tx Test Drop 0
Dest Port does Not Exist 0 Tx Driver Failed 0
Rx IPC Msg Alloc Failed 0 Ctrl Frm Alloc Failed 0
Unable to Deliver Msg 0
Buffer Errors Misc Errors
IPC Msg Alloc 0 IPC Open Port 0
Emer IPC Msg Alloc 0 No HWQ 0
IPC Frame PakType Alloc 0 Hardware Error 0
IPC Frame MemD Alloc 0
Tx Driver Errors
No Transport 0
MTU Failure 0
Dest does not Exist 0
The following is sample output from the showipccommand with the zoneskeyword displaying
information about the IPC zones and seats:
Router# show ipc zones
There are 3 Zones in this IPC realm.
Cisco IOS Interface and Hardware Component Command Reference
1749
show interfaces vlan mapping through show scp
show ipc
Zone ID Seat ID Name
0 10000 IPC Default Zone
1 10000 IPC TEST ZONE#1
2 10000 IPC TEST ZONE#2
The table below describes the significant fields shown in the display.
Table 170: show ipc zones Field Descriptions
Field Description
Zone ID Zone number.
Seat ID Seat number.
Name Zone name.
Related Commands Command Description
clear ipc statistics Clears and resets the IPC statistics.
Cisco IOS Interface and Hardware Component Command Reference
1750
show interfaces vlan mapping through show scp
show ipc hog-info
show ipc hog-info
To provide information about interprocess communication (IPC) messages that consume excessive CPU, use
the showipchog-infocommand in privileged EXEC mode.
show ipc hog-info
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC
Command History Release Modification
12.2(15)T This command was introduced.
12.2(28)SB This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The Cisco IOS version of IPC provides a reliable ordered delivery of messages using an underlying platform
driver transport or User Datagram Protocol (UDP) transport protocol.
The show ipc hog-info command displays information about IPC messages that are being processed when a
CPUHOG error occurs, indicating that the client processing an IPC message is using too much CPU, or when
an IPC message callback exceeds 200 milliseconds.
Examples The following example shows that the IPC process has had a CPUHOG error or the message callback
exceeded the 200-millisecond threshold:
Router# show ipc hog-info
Time last IPC process hogged CPU: 00:05:09
IPC Messages Processed:
Source Destination Name Message-Type Time-taken
(0x) (msec)
1030000 10000.14 ISSU Process: Active Por 0 864
1030000 10000.D RF : Active 0 0
In the following example, the show ipc status command shows a counter incrementing whenever a
callback exceeds 200 milliseconds:
Router# show ipc status
IPC System Status
Time last IPC stat cleared : never
This processor is the IPC master server.
Do not drop output of IPC frames for test purposes.
1000 IPC Message Headers Cached.
Rx Side Tx Side
Total Frames 9501 3973
Total from Local Ports 14328 3258
Total Protocol Control Frames 1628 713
Total Frames Dropped 0 0
Service Usage
Total via Unreliable Connection-Less Service 7865 0
Cisco IOS Interface and Hardware Component Command Reference
1751
show interfaces vlan mapping through show scp
show ipc hog-info
Total via Unreliable Sequenced Connection-Less Svc 0 0
Total via Reliable Connection-Oriented Service 831 1629
IPC Protocol Version 0
Total Acknowledgments 1628 713
Total Negative Acknowledgments 0 0
Device Drivers
Total via Local Driver 12 12
Total via Platform Driver 9478 1619
Total Frames Dropped by Platform Drivers 0 0
Total Frames Sent when media is quiesced 0
Reliable Tx Statistics
Re-Transmission 0
Re-Tx Timeout 0
Rx Errors Tx Errors
Unsupp IPC Proto Version 0 Tx Session Error 0
Corrupt Frame 0 Tx Seat Error 0
Duplicate Frame 0 Destination Unreachable 0
Rel Out-of-Seq Frame 0 Unrel Out-of-Seq Frame 0
Dest Port does Not Exist 0 Tx Driver Failed 0
Rx IPC Msg Alloc Failed 0 Rx IPC Frag Dropped 0
Rx IPC Transform Errors 0 Tx IPC Transform Errors 0
Unable to Deliver Msg 0 Tx Test Drop 0
Ctrl Frm Alloc Failed 0 Rx Msg Callback Hog 11
Buffer Errors Misc Errors
IPC Msg Alloc 0 IPC Open Port 0
Emer IPC Msg Alloc 0 No HWQ 0
IPC Frame PakType Alloc 0 Hardware Error 0
IPC Frame MemD Alloc 0 Invalid Messages 0
Tx Driver Errors
No Transport 0
MTU Failure 0
Dest does not Exist 0
Related Commands Command Description
show ipc Displays IPC statistics.
Cisco IOS Interface and Hardware Component Command Reference
1752
show interfaces vlan mapping through show scp
show ipv6 ospf interface
show ipv6 ospf interface
To display Open Shortest Path First (OSPF)-related interface information, use the showipv6ospfinterface
command in user EXEC or privileged mode.
show ipv6 ospf [process-id] [area-id] interface [type number] [brief]
Syntax Description process-id (Optional) Internal identification. It is locally assigned and can be any positive integer. The
number used here is the number assigned administratively when the OSPF routing process
is enabled.
area-id (Optional) Displays information about a specified area only.
type number (Optional) Interface type and number.
brief (Optional) Displays brief overview information for OSPF interfaces, states, addresses and
masks, and areas on the router.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.0(24)S This command was introduced.
12.2(15)T This command was integrated into Cisco IOS Release 12.2(15)T.
12.2(18)S This command was integrated into Cisco IOS Release 12.2(18)S.
12.3(4)T Command output is changed when authentication is enabled.
12.2(28)SB This command was integrated into Cisco IOS Release 12.2(28)SB.
12.2(25)SG This command was integrated into Cisco IOS Release 12.2(25)SG.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.4(9)T Command output is changed when encryption is enabled.
12.2(33)SRB The brief keyword was added.
12.4(15)XF Output displays were modified so that VMI PPPoE interface-based local state
values are displayed in the command output when a VMI interface is specified.
12.4(15)T This command was integrated into Cisco IOS Release 12.4(15)T
12.2(33)SXH This command was integrated into Cisco IOS Release 12.2(33)SXH.
Cisco IOS XE Release 2.1 Command output was updated to display graceful restart information.
12.2(33)SRE This command was modified. It was integrated into Cisco IOS Release
12.2(33)SRE.
Cisco IOS Interface and Hardware Component Command Reference
1753
show interfaces vlan mapping through show scp
show ipv6 ospf interface
Release Modification
15.1(1)SY This command was was modified. It was integrated into Cisco IOS Release
15.1(1)SY.
Examples
show ipv6 ospf interface Standard Output Example
The following is sample output from the showipv6ospfinterface command:
Router# show ipv6 ospf interface
ATM3/0 is up, line protocol is up
Link Local Address 2001:0DB1:205:5FFF:FED3:5808, Interface ID 13
Area 1, Process ID 1, Instance ID 0, Router ID 172.16.3.3
Network Type POINT_TO_POINT, Cost: 1
Transmit Delay is 1 sec, State POINT_TO_POINT,
Timer intervals configured, Hello 10, Dead 40, Wait 40, Retransmit 5
Hello due in 00:00:06
Index 1/2/2, flood queue length 0
Next 0x0(0)/0x0(0)/0x0(0)
Last flood scan length is 12, maximum is 12
Last flood scan time is 0 msec, maximum is 0 msec
Neighbor Count is 1, Adjacent neighbor count is 1
Adjacent with neighbor 172.16.4.4
Suppress hello for 0 neighbor(s)
FastEthernet0/0 is up, line protocol is up
Link Local Address 2001:0DB1:205:5FFF:FED3:5808, Interface ID 3
Area 1, Process ID 1, Instance ID 0, Router ID 172.16.3.3
Network Type BROADCAST, Cost: 1
Transmit Delay is 1 sec, State BDR, Priority 1
Designated Router (ID) 172.16.6.6, local address 2001:0DB1:205:5FFF:FED3:6408
Backup Designated router (ID) 172.16.3.3, local address 2001:0DB1:205:5FFF:FED3:5808
Timer intervals configured, Hello 10, Dead 40, Wait 40, Retransmit 5
Hello due in 00:00:05
Index 1/1/1, flood queue length 0
Next 0x0(0)/0x0(0)/0x0(0)
Last flood scan length is 12, maximum is 12
Last flood scan time is 0 msec, maximum is 0 msec
Neighbor Count is 1, Adjacent neighbor count is 1
Adjacent with neighbor 172.16.6.6 (Designated Router)
Suppress hello for 0 neighbor(s)
The table below describes the significant fields shown in the display.
Table 171: show ipv6 ospf interface Field Descriptions
Field Description
ATM3/0 Status of the physical link and operational status of protocol.
Link Local Address Interface IPv6 address.
Area 1, Process ID 1, Instance ID 0, Router The area ID, process ID, instance ID, and router ID of the area
ID 172.16.3.3 from which this route is learned.
Network Type POINT_TO_POINT, Cost: Network type and link-state cost.
1
Cisco IOS Interface and Hardware Component Command Reference
1754
show interfaces vlan mapping through show scp
show ipv6 ospf interface
Field Description
Transmit Delay Transmit delay, interface state, and router priority.
Designated Router Designated router ID and respective interface IP address.
Backup Designated router Backup designated router ID and respective interface IP address.
Timer intervals configured Configuration of timer intervals.
Hello Number of seconds until the next hello packet is sent out this
interface.
Neighbor Count Count of network neighbors and list of adjacent neighbors.
Cisco IOS Release 12.2(33)SRB Example
The following is sample output of the showipv6ospfinterface command when the brief keyword is
entered.
Router# show ipv6 ospf interface brief
Interface PID Area Intf ID Cost State Nbrs F/C
VL0 6 0 21 65535 DOWN 0/0
Se3/0 6 0 14 64 P2P 0/0
Lo1 6 0 20 1 LOOP 0/0
Se2/0 6 6 10 62 P2P 0/0
Tu0 1000 0 19 11111 DOWN 0/0
OSPF with Authentication on the Interface Example
The following is sample output from the showipv6ospfinterface command with authentication
enabled on the interface:
Router# show ipv6 ospf interface
Ethernet0/0 is up, line protocol is up
Link Local Address 2001:0DB1:A8BB:CCFF:FE00:6E00, Interface ID 2
Area 0, Process ID 1, Instance ID 0, Router ID 10.10.10.1
Network Type BROADCAST, Cost:10
MD5 Authentication SPI 500, secure socket state UP (errors:0)
Transmit Delay is 1 sec, State BDR, Priority 1
Designated Router (ID) 10.11.11.1, local address 2001:0DB1:A8BB:CCFF:FE00:6F00
Backup Designated router (ID) 10.10.10.1, local address
2001:0DB1:A8BB:CCFF:FE00:6E00
Timer intervals configured, Hello 10, Dead 40, Wait 40, Retransmit 5
Hello due in 00:00:01
Index 1/1/1, flood queue length 0
Next 0x0(0)/0x0(0)/0x0(0)
Last flood scan length is 1, maximum is 1
Last flood scan time is 0 msec, maximum is 0 msec
Neighbor Count is 1, Adjacent neighbor count is 1
Adjacent with neighbor 10.11.11.1 (Designated Router)
Suppress hello for 0 neighbor(s)
Cisco IOS Interface and Hardware Component Command Reference
1755
show interfaces vlan mapping through show scp
show ipv6 ospf interface
OSPF with Null Authentication Example
The following is sample output from the showipv6ospfinterface command with null authentication
configured on the interface:
Router# show ipv6 ospf interface
Ethernet0/0 is up, line protocol is up
Link Local Address 2001:0DB1:A8BB:CCFF:FE00:6E00, Interface ID 2
Area 0, Process ID 1, Instance ID 0, Router ID 10.10.10.1
Network Type BROADCAST, Cost:10
Authentication NULL
Transmit Delay is 1 sec, State BDR, Priority 1
Designated Router (ID) 10.11.11.1, local address 2001:0DB1:A8BB:CCFF:FE00:6F00
Backup Designated router (ID) 10.10.10.1, local address
2001:0DB1:A8BB:CCFF:FE00:6E00
Timer intervals configured, Hello 10, Dead 40, Wait 40, Retransmit 5
Hello due in 00:00:03
Index 1/1/1, flood queue length 0
Next 0x0(0)/0x0(0)/0x0(0)
Last flood scan length is 1, maximum is 1
Last flood scan time is 0 msec, maximum is 0 msec
Neighbor Count is 1, Adjacent neighbor count is 1
Adjacent with neighbor 10.11.11.1 (Designated Router)
Suppress hello for 0 neighbor(s)
OSPF with Authentication for the Area Example
The following is sample output from the showipv6ospfinterface command with authentication
configured for the area:
Router# show ipv6 ospf interface
Ethernet0/0 is up, line protocol is up
Link Local Address 2001:0DB1:A8BB:CCFF:FE00:6E00, Interface ID 2
Area 0, Process ID 1, Instance ID 0, Router ID 10.10.10.1
Network Type BROADCAST, Cost:10
MD5 Authentication (Area) SPI 1000, secure socket state UP (errors:0)
Transmit Delay is 1 sec, State BDR, Priority 1
Designated Router (ID) 10.11.11.1, local address 2001:0DB1:A8BB:CCFF:FE00:6F00
Backup Designated router (ID) 10.10.10.1, local address
FE80::A8BB:CCFF:FE00:6E00
Timer intervals configured, Hello 10, Dead 40, Wait 40, Retransmit 5
Hello due in 00:00:03
Index 1/1/1, flood queue length 0
Next 0x0(0)/0x0(0)/0x0(0)
Last flood scan length is 1, maximum is 1
Last flood scan time is 0 msec, maximum is 0 msec
Neighbor Count is 1, Adjacent neighbor count is 1
Adjacent with neighbor 10.11.11.1 (Designated Router)
Suppress hello for 0 neighbor(s)
OSPF with Dynamic Cost Example
The following display shows sample output from the showipv6ospfinterface command when the
OSPF cost dynamic is configured.
Router1# show ipv6 ospf interface serial 2/0
Cisco IOS Interface and Hardware Component Command Reference
1756
show interfaces vlan mapping through show scp
show ipv6 ospf interface
Serial2/0 is up, line protocol is up
Link Local Address 2001:0DB1:A8BB:CCFF:FE00:100, Interface ID 10
Area 1, Process ID 1, Instance ID 0, Router ID 172.1.1.1
Network Type POINT_TO_MULTIPOINT, Cost: 64 (dynamic), Cost Hysteresis: 200
Cost Weights: Throughput 100, Resources 20, Latency 80, L2-factor 100
Transmit Delay is 1 sec, State POINT_TO_MULTIPOINT,
Timer intervals configured, Hello 30, Dead 120, Wait 120, Retransmit 5
Hello due in 00:00:19
Index 1/2/3, flood queue length 0
Next 0x0(0)/0x0(0)/0x0(0)
Last flood scan length is 0, maximum is 0
Last flood scan time is 0 msec, maximum is 0 msec
Neighbor Count is 0, Adjacent neighbor count is 0
Suppress hello for 0 neighbor(s)
OSPF Graceful Restart Example
The following display shows sample output from the showipv6ospfinterface command when the
OSPF graceful restart feature is configured:
Router# show ipv6 ospf interface
Ethernet0/0 is up, line protocol is up
Link Local Address FE80::A8BB:CCFF:FE00:300, Interface ID 2
Area 0, Process ID 1, Instance ID 0, Router ID 10.3.3.3
Network Type POINT_TO_POINT, Cost: 10
Transmit Delay is 1 sec, State POINT_TO_POINT,
Timer intervals configured, Hello 10, Dead 40, Wait 40, Retransmit 5
Graceful Restart p2p timeout in 00:00:19
Hello due in 00:00:02
Graceful Restart helper support enabled
Index 1/1/1, flood queue length 0
Next 0x0(0)/0x0(0)/0x0(0)
Last flood scan length is 1, maximum is 1
Last flood scan time is 0 msec, maximum is 0 msec
Neighbor Count is 1, Adjacent neighbor count is 1
Adjacent with neighbor 10.1.1.1
Suppress hello for 0 neighbor(s)
Example of an Enabled Protocol
The following display shows that the OSPF interface is enabled for Bidirectional Forwarding Detection
(BFD):
Router# show ipv6 ospf interface
Serial10/0 is up, line protocol is up
Link Local Address FE80::A8BB:CCFF:FE00:6500, Interface ID 42
Area 1, Process ID 1, Instance ID 0, Router ID 10.0.0.1
Network Type POINT_TO_POINT, Cost: 64
Transmit Delay is 1 sec, State POINT_TO_POINT, BFD enabled
Timer intervals configured, Hello 10, Dead 40, Wait 40, Retransmit 5
Hello due in 00:00:07
Index 1/1/1, flood queue length 0
Next 0x0(0)/0x0(0)/0x0(0)
Last flood scan length is 1, maximum is 1
Last flood scan time is 0 msec, maximum is 0 msec
Neighbor Count is 1, Adjacent neighbor count is 1
Adjacent with neighbor 10.1.0.1
Suppress hello for 0 neighbor(s)
Cisco IOS Interface and Hardware Component Command Reference
1757
show interfaces vlan mapping through show scp
show ipv6 ospf interface
Related Commands Command Description
show ipv6 ospf graceful-restart Displays OSPFv3 graceful restart information.
Cisco IOS Interface and Hardware Component Command Reference
1758
show interfaces vlan mapping through show scp
show l2protocol-tunnel
show l2protocol-tunnel
To display the protocols that are tunneled on an interface or on all interfaces, use the showl2protocol-tunnel
command.
show l2protocol-tunnel [{interface interface mod/port|summary|vlan vlan}]
Syntax Description interface interface-id (Optional) Specifies the interface type; possible valid values are ethernet,
FastEthernet, gigabitethernet, tengigabitethernet, pos, atm, and ge-wan
mod/port Module and port number.
summary (Optional) Displays a summary of a tunneled port.
vlanvlan (Optional) Limits the display to interfaces on the specified VLAN. Valid values are
from 1 to 4094.
Command Modes EXEC (>)
Privileged EXEC (#)
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17a)SX The showl2protocol-tunnelsummary command output was changed to display the following
information:
• Global drop-threshold setting
• Up status of a Layer 2-protocol interface tunnel
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to the 12.2 SX release.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SXI This command was changed to add the optional vlanvlan keyword and argument.
15.2(2)T This command was integrated into Cisco IOS Release 15.2(2)T.
Usage Guidelines After enabling Layer 2 protocol tunneling on an access or IEEE 802.1Q tunnel port by using the
l2protocol-tunnel interface configuration command, you can configure some or all of these parameters:
• Protocol type to be tunneled
• Shutdown threshold
• Drop threshold
The showl2protocol-tunnel command displays only the ports that have protocol tunneling enabled.
Cisco IOS Interface and Hardware Component Command Reference
1759
show interfaces vlan mapping through show scp
show l2protocol-tunnel
The showl2protocol-tunnelsummary command displays the ports that have protocol tunneling enabled,
regardless of whether the port is down or currently configured as a trunk.
Examples The following example is an output from the show l2protocol-tunnel command:
Router# show l2protocol-tunnel
COS for Encapsulated Packets: 5
Drop Threshold for Encapsulated Packets: 0
Port Protocol Shutdown Drop Threshold Encapsulation Decapsulation Drop
Threshold Counter Counter Counter
Fa0/3 --- ---- ---- ---- ---- ----
--- ---- ---- ---- ---- ----
--- ---- ---- ---- ---- ----
pagp ---- ---- 0 242500
lacp ---- ---- 24268 242640
udld ---- ---- 0 897960
Fa0/4 --- ---- ---- ---- ---- ----
--- ---- ---- ---- ---- ----
--- ---- ---- ---- ---- ----
pagp 1000 ---- 24249 242700
lacp ---- ---- 24256 242660
udld ---- ---- 0 1344820
Gi0/3 cdp ---- ---- 134482 1344820
--- ---- ---- ---- ---- ----
--- ---- ---- ---- ---- ----
pagp 1000 ---- 0 242500
Cisco IOS Interface and Hardware Component Command Reference
1760
show interfaces vlan mapping through show scp
show l2protocol-tunnel
lacp 500 ---- 0 485320
udld 300 ---- 44899 448980
Gi0/3 cdp ---- ---- 134482 1344820
--- ---- ---- ---- ---- ----
--- ---- ---- ---- ---- ----
pagp ---- 1000 0 242700
lacp ---- ---- 0 485220
udld 300 ---- 44899 448980
This example shows how to display a summary of Layer 2-protocol tunnel ports:
Router# show l2protocol-tunnel summary
COS for Encapsulated Packets:5
Drop Threshold for Encapsulated Packets:0
Port Protocol Shutdown Drop Status
Threshold Threshold
(cdp/stp/vtp) (cdp/stp/vtp)
------- ----------- ---------------- ---------------- ----------
Fa9/1 --- stp --- ----/----/---- ----/----/---- down
Fa9/9 cdp stp vtp ----/----/---- ----/----/---- up
Fa9/47 --- --- --- ----/----/---- 1500/1500/1500 down(trunk)
Fa9/48 cdp stp vtp ----/----/---- ----/----/---- down(trunk)
This example shows how to display Layer 2-protocol tunnel information on interfaces for a specific
VLAN:
Router# show l2protocol-tunnel vlan 1
COS for Encapsulated Packets: 5
Drop Threshold for Encapsulated Packets: 0
Protocol Drop Counter
-------- -------------
cdp 0
lldp 0
stp 0
vtp 0
Port Protocol Thresholds Counters
Shutdown Drop Encap Decap Drop
------------------- -------- --------- --------- --------- --------- ---------
Related Commands Command Description
debug l2protocol-tunnel Displays the debugging options for L2PT.
l2protocol-tunnel Enables the protocol tunneling on an interface and specifies the
type of protocol to be tunneled.
Cisco IOS Interface and Hardware Component Command Reference
1761
show interfaces vlan mapping through show scp
show l2protocol-tunnel
Command Description
l2protocol-tunnel drop-threshold Specifies the maximum number of packets that can be processed
for the specified protocol on that interface before being dropped.
l2protocol-tunnel global drop-threshold Enables rate limiting at the software level.
l2protocol-tunnel shutdown-threshold Specifies the maximum number of packets that can be processed
for the specified protocol on that interface in 1 second.
Cisco IOS Interface and Hardware Component Command Reference
1762
show interfaces vlan mapping through show scp
show l3-mgr
show l3-mgr
To display the information about the Layer 3 manager , use the showl3-mgr command in user EXEC or
privileged EXEC mode.
show l3-mgr status
show l3-mgr {interface interface interface-number|null interface-number|port-channel number|vlan
vlan-id|status}
Syntax Description status Displays information about the global variable.
interface Displays information about the Layer 3 manager .
interface Interface type; possible valid values are ethernet, fastethernet, gigabitethernet,
tengigabitethernet, pos, atm, and ge-wan.
interface-number Module and port number; see the “Usage Guidelines” section for valid values.
null interface-number Specifies the null interface; the valid value is 0.
port-channel number Specifies the channel interface; valid values are a maximum of 64 values ranging
from 1 to 282.
vlan vlan-id Specifies the VLAN; valid values are from 1 to 4094.
status Displays status information about the Layer 3 manager.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The interface-number argument designates the module and port number. Valid values for interface-number
depend on the specified interface type and the chassis and module that are used. For example, if you specify
a Gigabit Ethernet interface and have a 48-port 10/100BASE-T Ethernet module that is installed in a 13-slot
chassis, valid values for the module number are from 1 to 13 and valid values for the port number are from
1 to 48.
The port-channelnumbervalues from 257 to 282 are supported on the CSM and the FWSM only.
Examples This example shows how to display the status of the Layer 3 manager:
Router#
Cisco IOS Interface and Hardware Component Command Reference
1763
show interfaces vlan mapping through show scp
show l3-mgr
show l3-mgr status
l3_mgr_state: 2
l3_mgr_req_q.count: 0
l3_mgr_req_q.head: 0
l3_mgr_req_q.tail: 0
l3_mgr_max_queue_count: 1060
l3_mgr_shrunk_count: 0
l3_mgr_req_q.ip_inv_count: 303
l3_mgr_req_q.ipx_inv_count: 0
l3_mgr_outpak_count: 18871
l3_mgr_inpak_count: 18871
l3_mgr_max_pending_pak: 4
l3_mgr_pending_pak_count: 0
nde enable statue: 0
current nde addr: 0.0.0.0
Router#
This example shows how to display the information about the Layer 3 manager for a specific interface:
Router#
show l3-mgr interface fastethernet 5/40
vlan: 0
ip_enabled: 1
ipx_enabled: 1
bg_state: 0 0 0 0
hsrp_enabled: 0
hsrp_mac: 0000.0000.0000
state: 0
up: 0
Router#
Cisco IOS Interface and Hardware Component Command Reference
1764
show interfaces vlan mapping through show scp
show l3vpn encapsulation ip
show l3vpn encapsulation ip
To display the L3VPN encapsulation profile health and the underlying tunnel interface, use the
showl3vpnencapsulationip command in privileged EXEC mode.
show l3vpn encapsulation ip [profile name]
Syntax Description profile name (Optional) Name of the Layer 3 encapsulation profile.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(33)SRE This command was introduced.
Examples The following is a sample output from the showl3vpnencapsulationip command:
Router# show l3vpn encapsulation ip tunnelencap
Profile: tunnelencap
transport ipv4 source Loopback0
protocol gre key 500
Tunnel Tunnel0 Created [OK]
Tunnel Linestate
Tunnel Transport Source Loopback0
Cisco IOS Interface and Hardware Component Command Reference
1765
show interfaces vlan mapping through show scp
show lacp
show lacp
To display Link Aggregation Control Protocol (LACP) and multi-chassis LACP (mLACP) information, use
the show lacp command in either user EXEC or privileged EXEC mode.
show lacp {channel-group-number {counters|internal [detail]|neighbor [detail]}|multi-chassis
[load-balance] {group number|port-channel number}|sys-id}
Cisco ASR 901 Series Aggregation Services Router
show lacp {channel-group-number {counters|internal [detail]|neighbor [detail]|sys-id}}
Syntax Description channel-group- number (Optional) Number of the channel group. The following are valid values:
• Cisco IOS 12.2 SB and Cisco IOS XE 2.4 Releases--from 1 to 64
• Cisco IOS 12.2 SR Releases--from 1 to 308
• Cisco IOS 12.2 SX Releases--from 1 to 496
• Cisco IOS 15.1S Releases—from 1 to 564
• Cisco ASR 901 Series Aggregation Services Router—from 1 to 8
counters Displays information about the LACP traffic statistics.
internal Displays LACP internal information.
neighbor Displays information about the LACP neighbor.
detail (Optional) Displays detailed internal information when used with the internal
keyword and detailed LACP neighbor information when used with the neighbor
keyword.
multi-chassis Displays information about mLACP.
load-balance Displays mLACP load balance information.
group Displays mLACP redundancy group information,
number Integer value used with the group and port-channel keywords.
• Values from 1 to 4294967295 identify the redundancy group.
• Values from 1 to 564 identify the port-channel interface.
port-channel Displays mLACP port-channel information.
sys-id Displays the LACP system identification. It is a combination of the port priority
and the MAC address of the device
Command Modes User EXEC (>) Privileged EXEC (#)
Cisco IOS Interface and Hardware Component Command Reference
1766
show interfaces vlan mapping through show scp
show lacp
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Cisco
IOS Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(31)SB2 This command was integrated into Cisco IOS Release 12.2(31)SB2.
12.2(33)SRB Support for this command on the Cisco 7600 router was integrated into Cisco
IOS Release 12.2(33)SRB.
Cisco IOS XE Release 2.4 This command was integrated into Cisco IOS XE Release 2.4.
12.2(33)SRE This command was modified. The multi-chassis, group, and
port-channelkeywords and number argument were added.
15.1(3)S This command was modified. The load-balance keyword was added.
15.1(2)SNG This command was implemented on the Cisco ASR 901 Series Aggregation
Services Router.
Usage Guidelines Use the show lacp command to troubleshoot problems related to LACP in a network.
If you do not specify a value for the argument channel-group-number, all channel groups are displayed. Values
in the range of 257 to 282 are supported on the CSM and the FWSM only.
Examples
show lacp sys-id Example
This example shows how to display the LACP system identification using the show lacp
sys-idcommand:
Device> show lacp sys-id
8000,AC-12-34-56-78-90
The system identification is made up of the system priority and the system MAC address. The first
two bytes are the system priority, and the last six bytes are the globally administered individual MAC
address that is associated to the system.
LACP Statistics for a Specific Channel Group Examples
This example shows how to display the LACP statistics for a specific channel group:
Device# show lacp 1 counters
LACPDUs Marker LACPDUs
Port Sent Recv Sent Recv Pkts Err
---------------------------------------------------
Channel group: 1
Cisco IOS Interface and Hardware Component Command Reference
1767
show interfaces vlan mapping through show scp
show lacp
Fa4/1 8 15 0 0 3 0
Fa4/2 14 18 0 0 3 0
Fa4/3 14 18 0 0 0
Fa4/4 13 18 0 0 0
The output displays the following information:
• The LACPDUs Sent and Recv columns display the LACPDUs that are sent and received on
each specific interface.
• The LACPDUs Pkts and Err columns display the marker-protocol packets.
The following example shows output from a show lacpchannel-group-numbercounterscommand:
Device1# show lacp 5 counters
LACPDUs Marker Marker Response LACPDUs
Port Sent Recv Sent Recv Sent Recv Pkts Err
---------------------------------------------------------------------
Channel group: 5
Gi5/0/0 21 18 0 0 0 0 0
The following table describes the significant fields shown in the display.
Table 172: show lacp channel-group-number counters Field Descriptions
Field Description
LACPDUs Sent Recv Number of LACP PDUs sent and received.
Marker Sent Recv Attempts to avoid data loss when a member link is removed from an LACP
bundle.
Marker Response Sent Recv Cisco IOS response to the Marker protocol.
LACPDUs Pkts Err Number of LACP PDU packets transmitted and the number of packet errors.
The following example shows output from a show lacp internalcommand:
Device1# show lacp 5 internal
Flags: S - Device is requesting Slow LACPDUs
F - Device is requesting Fast LACPDUs
A - Device is in Active mode P - Device is in Passive mode
Channel group 5
LACP port Admin Oper Port Port
Port Flags State Priority Key Key Number State
Gi5/0/0 SA bndl 32768 0x5 0x5 0x42 0x3D
The following table describes the significant fields shown in the display.
Table 173: show lacp internal Field Descriptions
Field Description
Flags Meanings of each flag value, which indicates a device activity.
Port Port on which link bundling is configured.
Cisco IOS Interface and Hardware Component Command Reference
1768
show interfaces vlan mapping through show scp
show lacp
Field Description
Flags Indicators of device activity.
State Activity state of the port. States can be any of the following:
• Bndl--Port is attached to an aggregator and bundled with other ports.
• Susp--Port is in suspended state, so it is not attached to any aggregator.
• Indep--Port is in independent state (not bundled but able to switch data traffic).
This condition differs from the previous state because in this case LACP is not
running on the partner port.
• Hot-sby--Port is in hot standby state.
• Down--Port is down.
LACP port Priority Priority assigned to the port.
Admin Key Defines the ability of a port to aggregate with other ports.
Oper Key Determines the aggregation capability of the link.
Port Number Number of the port.
Port State State variables for the port that are encoded as individual bits within a single octet with
the following meaning:
• bit0: LACP_Activity
• bit1: LACP_Timeout
• bit2: Aggregation
• bit3: Synchronization
• bit4: Collecting
• bit5: Distributing
• bit6: Defaulted
• bit7: Expired
Internal Information About a Specific Channel Group Example
This example shows how to display internal information for the interfaces that belong to a specific
channel:
Device# show lacp 1 internal
Flags: S - Device sends PDUs at slow rate. F - Device sends PDUs at fast rate.
A - Device is in Active mode. P - Device is in Passive mode.
Channel group 1
LACPDUs LACP Port Admin Oper Port Port
Cisco IOS Interface and Hardware Component Command Reference
1769
show interfaces vlan mapping through show scp
show lacp
Port Flags State Interval Priority Key Key Number State
Fa4/1 saC bndl 30s 32768 100 100 0xc1 0x75
Fa4/2 saC bndl 30s 32768 100 100 0xc2 0x75
Fa4/3 saC bndl 30s 32768 100 100 0xc3 0x75
Fa4/4 saC bndl 30s 32768 100 100 0xc4 0x75
Device#
The following table describes the significant fields shown in the display.
Table 174: show lacp internal Field Descriptions
Field Description
State Current state of the port; allowed values are as follows:
• bndl--Port is attached to an aggregator and bundled with other ports.
• susp--Port is in a suspended state; it is not attached to any aggregator.
• indep--Port is in an independent state (not bundled but able to switch data traffic.
In this case, LACP is not running on the partner port).
• hot-sby--Port is in a hot-standby state.
• down--Port is down.
LACPDUs Interval Interval setting.
LACP Port Priority Port-priority setting.
Admin Key Defines the ability of a port to aggregate with other ports.
Oper Key Determines the aggregation capability of the link.
Port Number Port number.
Port State Activity state of the port.
• See the Port State description in the show lacp internal Field Descriptions table
for state variables.
Information About LACP Neighbors for a Specific Port Example
This example shows how to display the information about the LACP neighbors for a specific port
channel:
Device# show lacp 1 neighbors
Flags: S - Device sends PDUs at slow rate. F - Device sends PDUs at fast rate.
A - Device is in Active mode. P - Device is in Passive mode.
Channel group 1 neighbors
Partner Partner
Port System ID Port Number Age Flags
Fa4/1 8000,00b0.c23e.d84e 0x81 29s P
Fa4/2 8000,00b0.c23e.d84e 0x82 0s P
Fa4/3 8000,00b0.c23e.d84e 0x83 0s P
Fa4/4 8000,00b0.c23e.d84e 0x84 0s P
Cisco IOS Interface and Hardware Component Command Reference
1770
show interfaces vlan mapping through show scp
show lacp
Port Admin Oper Port
Priority Key Key State
Fa4/1 32768 200 200 0x81
Fa4/2 32768 200 200 0x81
Fa4/3 32768 200 200 0x81
Fa4/4 32768 200 200 0x81
Device#
The following table describes the significant fields shown in the display.
Table 175: show lacp neighbors Field Descriptions
Field Description
Port Port on which link bundling is configured.
Partner System ID Peer’s LACP system identification (sys-id). It is a combination of the system priority
and the MAC address of the peer device.
Partner Port Number Port number on the peer device
Age Number of seconds since the last LACP PDU was received on the port.
Flags Indicators of device activity.
Port Priority Port priority setting.
Admin Key Defines the ability of a port to aggregate with other ports.
Oper Key Determines the aggregation capability of the link.
Port State Activity state of the port.
See the Port State description in the show lacp internal Field Descriptions table for
state variables.
If no PDUs have been received, the default administrative information is displayed in braces.
Related Commands Command Description
clear lacp counters Clears the statistics for all interfaces belonging to a specific channel group.
lacp port-priority Sets the priority for the physical interfaces.
lacp system-priority Sets the priority of the system.
Cisco IOS Interface and Hardware Component Command Reference
1771
show interfaces vlan mapping through show scp
show link state group
show link state group
To display the link-state group information., use the showlinkstategroup command in user EXEC or privileged
EXEC mode .
show link state group detail
Syntax Description detail Displays the detailed information about the group.
Command Modes Privileged EXEC (#)
Command History Release Modification
15.1(1)S This command was introduced.
Usage Guidelines Link State Ttracking (LST), also known as trunk failover, is a feature that binds the link state of multiple
interfaces. When you configure LST for the first time, add upstream interfaces to the link state group before
adding the downstream interface, otherwise the downstream interfaces would move into error-disable mode.
The maximum number of link state groups configurable is 10.
Examples The following example displays the link-state group information:
Router# enable
Router# show link state group 1
Link State Group: 1 Status: Enabled, Down
Router> show link state group detail
(Up):Interface up (Dwn):Interface Down (Dis):Interface disabled
Link State Group: 1 Status: Enabled, Down
Upstream Interfaces : Gi3/5(Dwn) Gi3/6(Dwn)
Downstream Interfaces : Gi3/1(Dis) Gi3/2(Dis) Gi3/3(Dis) Gi3/4(Dis)
Link State Group: 2 Status: Enabled, Down
Upstream Interfaces : Gi3/15(Dwn) Gi3/16(Dwn) Gi3/17(Dwn)
Downstream Interfaces : Gi3/11(Dis) Gi3/12(Dis) Gi3/13(Dis) Gi3/14(Dis)
(Up):Interface up (Dwn):Interface Down (Dis):Interface disabled
Related Commands Command Description
link state track Configures the link state tracking number.
link state group Configures the link state group and interface, as either an upstream or downstream
interface in the group.
Cisco IOS Interface and Hardware Component Command Reference
1772
show interfaces vlan mapping through show scp
show mac-address-table dynamic
show mac-address-table dynamic
To display dynamic MAC address table entries only, use the showmac-address-tabledynamic command in
privileged EXEC mode.
Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers
show mac-address-table dynamic [{address mac-addr|interface interface type slot/number |vlan
vlan}]
Catalyst Switches
show mac-address-table dynamic [{address mac-addr|detail|interface interface numberprotocol
protocol |module number|vlan vlan}][{begin|exclude|includeexpression}]
Catalyst 6500 Series Switches
show mac-address-table dynamic [{address mac-addr|interface interface interface-number
[{all|module number}]|module num|vlan vlan-id [{all|module number}]}]
Syntax Description address mac -address (Optional) Specifies a 48-bit MAC address; valid format is H.H.H.
detail (Optional) Specifies a detailed display of MAC address table information.
interface type number (Optional) Specifies an interface to match; valid type values are FastEthernet and
GigabitEthernet, valid number values are from 1 to 9.
interface type (Optional) Specifies an interface to match; valid type values are FastEthernet and
GigabitEthernet.
slot (Optional) Adds dynamic addresses to module in slot 1 or 2.
port (Optional) Port interface number ranges based on type of Ethernet switch network
module used:
• 0 to 15 for NM-16ESW
• 0 to 35 for NM-36ESW
• 0 to 1 for GigabitEthernet
protocol protocol (Optional) Specifies a protocol. See the “Usage Guidelines” section for keyword
definitions.
module number (Optional) Displays information about the MAC address table for a specific
Distributed Forwarding Card (DFC) module.
vlan vlan (Optional) Displays entries for a specific VLAN; valid values are from 1 to 1005.
begin (Optional) Specifies that the output display begin with the line that matches the
expression.
exclude (Optional) Specifies that the output display exclude lines that match the expression.
Cisco IOS Interface and Hardware Component Command Reference
1773
show interfaces vlan mapping through show scp
show mac-address-table dynamic
include (Optional) Specifies that the output display include lines that match the specified
expression.
expression Expression in the output to use as a reference point.
all (Optional) Specifies that the output display all dynamic MAC-address table entries.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.0(7)XE This command was introduced on Catalyst 6000 series switches.
12.2(2)XT This command was implemented on Cisco 2600 series, Cisco 3600 series, and Cisco 3700
series routers.
12.2(8)T This command was integrated into Cisco IOS Release 12.2(8)T on Cisco 2600 series, Cisco
3600 series, and Cisco 3700 series routers.
12.2(11)T This command was integrated into Cisco IOS Release 12.2(11)T.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(14)SX Support for this command was introduced on the Catalyst 6500 series switch.
12.2(33)SXH This command was changed to support the all keyword on the Catalyst 6500 series switch.
Usage Guidelines Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers
The showmac-address-tabledynamic command output for an EtherChannel interface changes the port-number
designation (for example, 5/7) to a port-group number.
Catalyst Switches
The keyword definitions for the protocol argument are:
• ip --Specifies IP protocol
• ipx --Specifies Internetwork Packet Exchange (IPX) protocols
• assigned --Specifies assigned protocol entries
• other --Specifies other protocol entries
The showmac-address-tabledynamic command output for an EtherChannel interface changes the port-number
designation (for example, 5/7) to a port-group number.
Catalyst 6500 Series Switches
The mac-addressis a 48-bit MAC address and the valid format is H.H.H.
The optional modulenum keyword and argument are supported only on DFC modules. The modulenumkeyword
and argument designate the module number.
Examples The following examples show how to display all dynamic MAC address entries. The fields shown
in the various displays are self-explanatory.
Cisco IOS Interface and Hardware Component Command Reference
1774
show interfaces vlan mapping through show scp
show mac-address-table dynamic
Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers
Router# show mac-address-table dynamic
Non-static Address Table:
Destination Address Address Type VLAN Destination Port
------------------- ------------ ---- --------------------
000a.000a.000a Dynamic 1 FastEthernet4/0
002a.2021.4567 Dynamic 2 FastEthernet4/0
Catalyst Switches
Router# show mac-address-table dynamic
vlan mac address type protocol qos ports
-----+---------------+--------+---------+---+--------------------------------
200 0010.0d40.37ff dynamic ip -- 5/8
1 0060.704c.73ff dynamic ip -- 5/9
4095 0000.0000.0000 dynamic ip -- 15/1
1 0060.704c.73fb dynamic other -- 5/9
1 0080.1c93.8040 dynamic ip -- 5/9
4092 0050.f0ac.3058 dynamic ip -- 15/1
1 00e0.4fac.b3ff dynamic other -- 5/9
The following example shows how to display dynamic MAC address entries with a specific protocol
type (in this case, assigned).
Router# show mac-address-table dynamic protocol assigned
vlan mac address type protocol qos ports
-----+---------------+--------+---------+---+--------------------------------
4092 0000.0000.0000 dynamic assigned -- Router
4092 0050.f0ac.3059 dynamic assigned -- Router
1 0010.7b3b.0978 dynamic assigned -- Fa5/9
Router#
The following example shows the detailed output for the previous example.
Router# show mac-address-table dynamic protocol assigned detail
MAC Table shown in details
========================================
Type Always Learn Trap Modified Notify Capture Protocol Flood
-------+------------+----+--------+------+-------+--------+-----+
QoS bit L3 Spare Mac Address Age Byte Pvlan Xtag SWbits Index
-----------------+--------+--------------+--------+-----+----+------+-----
DYNAMIC NO NO YES NO NO assigned NO
Bit Not On 0 0000.0000.0000 255 4092 0 0 0x3
DYNAMIC NO NO YES NO NO assigned NO
Bit Not On 0 0050.f0ac.3059 254 4092 0 0 0x3
DYNAMIC NO NO YES NO NO assigned NO
Bit Not On 0 0010.7b3b.0978 254 1 0 0 0x108
Router#
Cisco IOS Interface and Hardware Component Command Reference
1775
show interfaces vlan mapping through show scp
show mac-address-table dynamic
Catalyst 6500 Series Switches
This example shows how to display all the dynamic MAC-address entries for a specific VLAN.
Router# show mac-address-table dynamic vlan 200 all
Legend: * - primary entry
age - seconds since last seen
n/a - not aevailable
vlan mac address type learn age ports
------+----------------+--------+-----+----------+--------------------------
200 0010.0d40.37ff dynamic NO 23 Gi5/8
Router#
This example shows how to display all the dynamic MAC-address entries.
Router# show mac-address-table dynamic
Legend: * - primary entry
age - seconds since last seen
n/a - not applicable
vlan mac address type learn age ports
------+----------------+--------+-----+----------+--------------------------
* 10 0010.0000.0000 dynamic Yes n/a Gi4/1
* 3 0010.0000.0000 dynamic Yes 0 Gi4/2
* 1 0002.fcbc.ac64 dynamic Yes 265 Gi8/1
* 1 0009.12e9.adc0 static No - Router
Router#
Related Commands Command Description
show mac -address-tableaddress Displays MAC address table information for a specific MAC
address.
show mac -address-tableaging-time Displays the MAC address aging time.
show mac -address-tablecount Displays the number of entries currently in the MAC address table.
show mac -address-tabledetail Displays detailed MAC address table information.
show mac -address-tableinterface Displays the MAC address table information for a specific interface.
show mac -address-tablemulticast Displays multicast MAC address table information.
show mac -address-tableprotocol Displays MAC address table information based on protocol.
show mac -address-tablestatic Displays static MAC address table entries only.
show mac -address-tablevlan Displays the MAC address table information for a specific VLAN.
Cisco IOS Interface and Hardware Component Command Reference
1776
show interfaces vlan mapping through show scp
show mls asic
show mls asic
To display the application-specific integrated circuit (ASIC) version, use the showmlsasic command in user
EXEC or privileged EXEC mode.
show mls asic
Syntax Description This command has no arguments or keywords.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Examples This example shows how to display the ASIC versions on a Supervisor Engine 2:
Router#
show mls asic
Cafe version: 2
Centauri version: 1
Perseus version: 0/0
Titan version: 1
Router#
This example shows how to display the ASIC versions on a Supervisor Engine 720:
Router#
show mls asic
Earl in Module 2
Tycho - ver:1 Cisco-id:1C8 Vendor-id:49
Router#
Related Commands Command Description
show mls df-table Displays information about the DF table.
show mls ip Displays the Multilayer Switching (MLS) IP information.
show mls ipx Displays the Multilayer Switching (MLS) IPX information.
show mls qos Displays Multilayer Switching (MLS) quality of service (QoS) information
show mls statistics Displays the Multilayer Switching (MLS) statistics for the Internet Protocol (IP)
Cisco IOS Interface and Hardware Component Command Reference
1777
show interfaces vlan mapping through show scp
show mls ip
show mls ip
To display the Multilayer Switching (MLS) IP information, use the showmlsip command in user EXEC or
privileged EXEC mode.
show mls ip [{any|destination {hostnameip-address}|detail|flow {tcp|udp}|{vlan vlan-id|macd
destination-mac-address|macs source-mac-address|module number|source
{hostnameip-address}}|count|static}]
show mls ip {ipv6|mpls}
Syntax Description any (Optional) Displays any MLS IP information.
destination hostname (Optional) Displays the entries for a specific destination hostname.
destination ip-address (Optional) Displays the entries for a specific destination IP address.
detail (Optional) Specifies a detailed output.
flow (Optional) Specifies the flow type.
tcp | udp Selects the flow type.
vlan vlan-id (Optional) Specifies the virtual local area network (VLAN) ID; valid
values are from 1 to 4094.
macd destination-mac-address (Optional) Specifies the destination MAC address.
macs source- mac-address (Optional) Specifies the source Media Access Control (MAC) address.
module number (Optional) Displays the entries that are downloaded on the specified
module; see the “Usage Guidelines” section for valid values.
source hostname (Optional) Displays the entries for a specific source address.
source ip-address (Optional) Displays the entries for a specific source IP address.
count (Optional) Displays the total number of MLS entries.
static (Optional) Displays the total number of static entries.
ipv6 Displays the total number of IPv6 entries.
mpls Displays the total number of MPLS entries.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
Cisco IOS Interface and Hardware Component Command Reference
1778
show interfaces vlan mapping through show scp
show mls ip
Release Modification
12.2(17a)SX This command is supported on releases prior to Release 12.2(17a)SX only.
12.2(17b)SXA On Cisco 7600 series routers that are configured with a Supervisor Engine 720, this command
is replaced by the show mls netflow ip command.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release
12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines The static, ipv6 and mpls keywords are not supported on Cisco 7600 series routers that are configured with
a Supervisor Engine 2.
The interface-number argument designates the module and port number. Valid values for interface-number
depend on the specified interface type and the chassis and module that are used. For example, if you specify
a Gigabit Ethernet interface and have a 48-port 10/100BASE-T Ethernet module that is installed in a 13-slot
chassis, valid values for the module number are from 1 to 13 and valid values for the port number are from
1 to 48. This definition also applies to the modulenumber keyword and argument.
When you view the output, note that a colon (:) is used to separate the fields.
Examples This example shows how to display any MLS IP information:
Router#
show mls ip
any
Displaying Netflow entries in Supervisor Earl
DstIP SrcIP Prot:SrcPort:DstPort Src i/f:AdjPtr
--------------------------------------------------------------------
Pkts Bytes Age LastSeen Attributes
---------------------------------------------------
0.0.0.0 0.0.0.0 0 :0 :0 0 : 0x0
82 3772 1329 20:46:03 L3 - Dynamic
Router#
This example shows how to display MLS information on a specific IP address:
Router#
show mls ip
destination 172.20.52.122
Displaying Netflow entries in Supervisor Earl
DstIP SrcIP Dst i/f:DstMAC Pkts Bytes
-----------------------------------------------------------------------
SrcDstPorts SrcDstEncap Age LastSeen
----------------------------------------
172.20.52.122 0.0.0.0 5 : 00e0.4fac.b3ff 684 103469
Fa5/9,Fa5/9 ARPA,ARPA 281 07:17:02
Number of Entries Found = 1
Router#
This example shows how to display MLS information on a specific flow type:
Router# show mls ip
flow udp
Cisco IOS Interface and Hardware Component Command Reference
1779
show interfaces vlan mapping through show scp
show mls ip
Displaying Netflow entries in Supervisor Earl
DstIP SrcIP Prot:SrcPort:DstPort Src i/f:AdjPtr
--------------------------------------------------------------------
Pkts Bytes Age LastSeen Attributes
---------------------------------------------------
0.0.0.0 0.0.0.0 0 :0 :0 0 : 0x0
78 3588 1259 20:44:53 L3 - Dynamic
Router#
This example shows how to display detailed MLS information:
Router#
show mls ip
detail
Displaying Netflow entries in Supervisor Earl
DstIP SrcIP Prot:SrcPort:DstPort Src i/f:AdjPtr
--------------------------------------------------------------------
Pkts Bytes Age LastSeen Attributes
---------------------------------------------------
Mask Pi R CR Xt Prio Dsc IP_EN OP_EN Pattern Rpf FIN_RDT FIN/RST
----+--+-+--+--+----+---+-----+-----+-------+---+-------+-------
Ig/acli Ig/aclo Ig/qosi Ig/qoso Fpkt Gemini MC-hit Dirty Diags
-------+-------+-------+-------+----+------+------+-----+------
QoS Police Count Threshold Leak Drop Bucket Use-Tbl Use-Enable
-----------+------------+---------+-----------+----+-------+-------+----------+
127.0.0.19 127.0.0.16 udp :68 :67 1009: 0x0
72 3312 1170 20:43:24 L3 - Dynamic
0 1 0 0 1 0 0 1 1 0 0 0 0
0 0 0 0 0 0 0 0 0
0x0 0 0 0 NO 64 NO NO
Router#
Related Commands Command Description
show mls asic display the application-specific integrated circuit (ASIC) version
show mls df-table Displays information about the DF table.
show mls ipx Displays the Multilayer Switching (MLS) IPX information.
show mls qos Displays Multilayer Switching (MLS) quality of service (QoS) information
show mls statistics Displays the Multilayer Switching (MLS) statistics for the Internet Protocol (IP)
Cisco IOS Interface and Hardware Component Command Reference
1780
show interfaces vlan mapping through show scp
show mls ipx
show mls ipx
To display Multilayer Switching (MLS) Internetwork Packet Exchange (IPX) information, use the showmlsipx
command in user EXEC or privileged EXEC mode.
show mls ipx [{destination ipx-network|interface interface interface-number|vlan vlan-id|macd
destination-mac-address|macs source-mac-address|module number|source hostnameipx-network}]
[{detail|count}]
Syntax Description destination ipx-network (Optional) Displays the entries for a specific destination network address.
interface (Optional) Specifies the interface.
interface (Optional) Interface type; possible valid values are ethernet, fastethernet,
gigabitethernet, tengigabitethernet, pos, atm, and ge-wan.
interface-number (Optional) Module and port number; see the “Usage Guidelines” section
for valid values.
vlan vlan-id (Optional) Specifies the virtual local area network (VLAN) ID; valid
values are from 1 to 4094.
macd destination-mac-address (Optional) Specifies the destination Media Access Control (MAC)
address.
macs source- mac-address (Optional) Specifies the source MAC address.
module number (Optional) Displays the entries that are downloaded on the specified slot;
see the “Usage Guidelines” section for valid values.
source hostname (Optional) Displays the entries for a specific source address.
source ipx-network (Optional) Displays the entries for a specific destination network address.
detail (Optional) Displays the detailed list of entries.
count (Optional) Displays the total number of MLS entries.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine
720 with a PFC2.
Cisco IOS Interface and Hardware Component Command Reference
1781
show interfaces vlan mapping through show scp
show mls ipx
When you enter the ipx-network value, the format is N.H.H.H.
When you enter the destination-mac-address value, the format for the 48-bit MAC address is H.H.H.
The interface-number argument designates the module and port number. Valid values for interface-number
depend on the specified interface type and the chassis and module used. For example, if you specify a Gigabit
Ethernet interface and have a 48-port 10/100BASE-T Ethernet module installed in a 13-slot chassis, valid
values for the module number are from 1 to 13 and valid values for the port number are from 1 to 48. These
valid values also apply when entering the modulenumber keyword and argument.
Examples This example shows how to display MLS IPX information:
Router#
show mls ipx
DstNet-DstNode SrcNet Dst i/f:DstMAC Pkts Bytes
-----------------------------------------------------------------------
SrcDstPorts SrcDstEncap Age LastSeen
----------------------------------------
Number of Entries Found = 0
Router#
This example shows how to display the total number of MLS entries:
Router#
show mls ipx
count
Number of shortcuts = 66
Router#
Related Commands Command Description
mls ipx Enables MLS IPX on the interface.
show mls asic display the application-specific integrated circuit (ASIC) version
show mls df-table Displays information about the DF table.
show mls ip Displays the Multilayer Switching (MLS) IP information.
show mls qos Displays Multilayer Switching (MLS) quality of service (QoS) information
show mls statistics Displays the Multilayer Switching (MLS) statistics for the Internet Protocol (IP)
Cisco IOS Interface and Hardware Component Command Reference
1782
show interfaces vlan mapping through show scp
show mobility
show mobility
To display information about the Layer 3 mobility and the wireless network, use the showmobility command
in privileged EXEC mode.
show mobility {ap [ip-address]|mn [ip ip-address]|mac mac-address|network network-id|status}
Syntax Description ap Displays information about the access point.
ip-address (Optional) IP address.
mn Displays information about the mobile node.
ip ip-address (Optional) Displays information about the IP database thread.
mac mac-address Displays information about the MAC database thread.
network network-id Displays information for a specific wireless network ID.
status Displays status information.
Command Modes Privileged EXEC
Command History Release Modification
12.2(18)SXD This command was introduced on the Supervisor Engine 720.
12.2(18)SXD3 The output of this command was changed to include the TCP adjust-mss status.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines This command is supported on Cisco 7600 series routers that are configured with a WLSM only.
Examples This example shows how to display information about the access point:
Router# show mobility
ap
AP IP Address AP Mac Address Wireless Network-ID
--------------- -------------- -------------------
10.1.1.2 000d.29a2.a852 101 102 109 103
This example shows how to display information about the access points for a specific network ID:
Router# show mobility
ap 172.16.1.2 detail
IP Address : 172.16.1.2
MAC Address : 000d.29a2.a852
Participating Wireless Tunnels: 101, 102, 109, 103
Registered Mobile Nodes on AP {172.16.1.2, 000d.29a2.a852} :
MN Mac Address MN IP Address AP IP Address Wireless Network-ID
-------------- --------------- --------------- -------------------
000a.8afa.85c9 10.1.3.11 172.16.1.2 103
Cisco IOS Interface and Hardware Component Command Reference
1783
show interfaces vlan mapping through show scp
show mobility
000d.bdb7.83f7 10.1.2.11 172.16.1.2 102
000d.bdb7.83fb 10.1.1.11 172.16.1.2 101
Router# show mobility
network-id 101
Wireless Network ID : 101
Wireless Tunnel Source IP Address : 10.1.1.1
Wireless Network Properties : Trusted
Wireless Network State : Up
Registered Access Point on Wireless Network 101:
AP IP Address AP Mac Address Wireless Network-ID
--------------- -------------- -------------------
176.16.1.2 000d.29a2.a852 101 102 109 103
Registered Mobile Nodes on Wireless Network 101:
MN Mac Address MN IP Address AP IP Address Wireless Network-ID
-------------- --------------- --------------- -------------------
000d.bdb7.83fb 10.1.1.11 176.16.1.2 101
Router# show mobility
status
WLAN Module is located in Slot: 4 (HSRP State: Active) LCP
Communication status : up
MAC address used for Proxy ARP: 0030.a349.d800
Number of Wireless Tunnels : 1
Number of Access Points : 2
Number of Mobile Nodes : 0
Wireless Tunnel Bindings:
Src IP Address Wireless Network-ID Flags
--------------- ------------------- -------
10.1.1.1 101 B
Flags: T=Trusted, B=IP Broadcast enabled, A=TCP Adjust-mss enabled
Related Commands Command Description
mobility Configures the wireless mGRE tunnels.
Cisco IOS Interface and Hardware Component Command Reference
1784
show interfaces vlan mapping through show scp
show module
show module
To display the module status and information, use the show module command in user EXEC or privileged
EXEC mode.
show module [{mod-num|all|provision|version}]
Syntax Description mod -num (Optional) Number of the module.
all (Optional) Displays the information for all modules.
provision (Optional) Displays the status about the module provisioning.
version (Optional) Displays the version information.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines In the Mod Sub-Module fields, the show module command displays the supervisor engine number but appends
the uplink daughter card’s module type and information.
Entering the show module command with no arguments is the same as entering the show module all command.
Examples This example shows how to display information for all modules on a Cisco 7600 series router that
is configured with a Supervisor Engine 720:
Router#
show module
Mod Ports Card Type Model Serial No.
--- ----- -------------------------------------- ------------------ -----------
1 48 CEF720 48 port 10/100/1000mb Ethernet WS-X6748-GE-TX SAL0843557C
2 48 48-port 10/100/1000 RJ45 EtherModule WS-X6148A-GE-45AF SAL1109HZW9
3 48 48-port 10/100/1000 RJ45 EtherModule WS-X6148A-GE-45AF SAL1114KYZ7
4 48 48 port 10/100 mb RJ45 WS-X6348-RJ-45 SAL0543DGZ1
6 2 Supervisor Engine 720 (Active) WS-SUP720-3B SAL1016KASS
7 48 48-port 10/100 mb RJ45 WS-X6148-45AF SAL08321X1H
8 4 CEF720 4 port 10-Gigabit Ethernet WS-X6704-10GE SAL08528ADQ
9 48 48-port 100FX SFP Ethernet Module WS-X6148-FE-SFP SAD090208MB
Mod MAC addresses Hw Fw Sw Status
--- ---------------------------------- ------ ------------ ------------ -------
1 0012.005c.86e0 to 0012.005c.870f 2.1 12.2(14r)S5 12.2(33)SXH Ok
2 001b.0ce4.9fb0 to 001b.0ce4.9fdf 2.2 8.4(1) 8.7(0.22)SXH Ok
Cisco IOS Interface and Hardware Component Command Reference
1785
show interfaces vlan mapping through show scp
show module
3 001b.534f.0540 to 001b.534f.056f 2.2 8.4(1) 8.7(0.22)SXH Ok
4 0007.4f6c.69f8 to 0007.4f6c.6a27 5.0 5.4(2) 8.7(0.22)SXH Ok
6 0017.9441.44cc to 0017.9441.44cf 5.2 8.4(2) 12.2(33)SXH Ok
7 0011.bb0e.c260 to 0011.bb0e.c28f 1.1 5.4(2) 8.7(0.22)SXH Ok
8 0012.da89.a43c to 0012.da89.a43f 2.0 12.2(14r)S5 12.2(33)SXH Ok
9 0030.f273.baf0 to 0030.f273.bb1f 3.0 8.4(1) 8.7(0.22)SXH Ok
Mod Sub-Module Model Serial Hw Status
---- --------------------------- ------------------ ----------- ------- -------
1 Centralized Forwarding Card WS-F6700-CFC SAL08363HL6 2.0 Ok
2 IEEE Voice Daughter Card WS-F6K-48-AF SAL1108HRB1 2.3 Ok
3 IEEE Voice Daughter Card WS-F6K-48-AF SAL1114KV3P 2.3 Ok
4 Inline Power Module WS-F6K-VPWR 1.0 Ok
6 Policy Feature Card 3 WS-F6K-PFC3B SAL1015K00Q 2.3 Ok
6 MSFC3 Daughterboard WS-SUP720 SAL1016KBY3 2.5 Ok
7 IEEE Voice Daughter Card WS-F6K-FE48-AF SAL08311GGL 1.1 Ok
8 Centralized Forwarding Card WS-F6700-CFC SAL0902040K 2.0 Ok
Mod Online Diag Status
---- -------------------
1 Bypass
2 Bypass
3 Bypass
4 Bypass
6 Bypass
7 Bypass
8 Bypass
9 Bypass
Router#
This example shows how to display information for a specific module:
Router#
show module 2
Mod Ports Card Type Model Serial No.
--- ----- -------------------------------------- ------------------ -----------
5 2 Supervisor Engine 720 (Active) WS-SUP720-BASE SAD0644030K
Mod MAC addresses Hw Fw Sw Status
--- ---------------------------------- ------ ------------ ------------ -------
5 00e0.aabb.cc00 to 00e0.aabb.cc3f 1.0 12.2(2003012 12.2(2003012 Ok
Mod Sub-Module Model Serial Hw Status
--- --------------------------- --------------- --------------- ------- -------
5 Policy Feature Card 3 WS-F6K-PFC3 SAD0644031P 0.302 Ok
5 MSFC3 Daughtercard WS-SUP720 SAD06460172 0.701
Mod Online Diag Status
--- -------------------
5 Not Available
Router#
This example shows how to display version information:
Router#
show module version
Mod Port Model Serial # Versions
--- ---- ------------------ ----------- --------------------------------------
2 0 WS-X6182-2PA Hw : 1.0
Fw : 12.2(20030125:231135)
Sw : 12.2(20030125:231135)
4 16 WS-X6816-GBIC SAD04400CEE Hw : 0.205
WS-F6K-DFC3A SAD0641029Y Hw : 0.501
Fw : 12.2(20020828:202911)
Sw : 12.2(20030125:231135)
6 2 WS-X6K-SUP3-BASE SAD064300GU Hw : 0.705
Fw : 7.1(0.12-Eng-02)TAM
Cisco IOS Interface and Hardware Component Command Reference
1786
show interfaces vlan mapping through show scp
show module
Sw : 12.2(20030125:231135)
Sw1: 8.1(0.45)KIS
WS-X6K-SUP3-PFC3 SAD064200VR Hw : 0.701
Fw : 12.2(20021016:001154)
Sw : 12.2(20030125:231135)
WS-F6K-PFC3 SAD064300M7 Hw : 0.301
9 48 WS-X6548-RJ-45 SAD04490BAC Hw : 0.301
Fw : 6.3(1)
Sw : 7.5(0.30)CFW11
Router#
This example shows how to display module provisioning information:
Router# show module provision
Module Provision
1 dynamic
2 dynamic
3 dynamic
4 dynamic
5 dynamic
6 dynamic
7 dynamic
8 dynamic
9 dynamic
10 dynamic
11 dynamic
12 dynamic
13 dynamic
Router#
Related Commands Command Description
show interfaces Displays the status and statistics for the interfaces in the chassis.
show environment alarm Displays the information about the environmental alarm.
show fm summary Displays a summary of FM Information.
show environment status Displays the information about the operational FRU status.
Cisco IOS Interface and Hardware Component Command Reference
1787
show interfaces vlan mapping through show scp
show msfc
show msfc
To display Multilayer Switching Feature Card (MSFC) information, use the show msfc command in user
EXEC or privileged EXEC mode.
show msfc {buffers|eeprom|fault|netint|tlb}
Syntax Description buffers Displays buffer-allocation information.
eeprom Displays the internal information.
fault Displays fault information.
netint Displays network-interrupt information.
tlb Displays information about the TLB registers.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Examples These examples display the show msfc command output:
Router# show msfc buffers
Reg. set Min Max
TX 640
ABQ 640 16384
0 0 40
1 6715 8192
2 0 0
3 0 0
4 0 0
5 0 0
6 0 0
7 0 0
Threshold = 8192
Vlan Sel Min Max Cnt Rsvd
1016 1 6715 8192 0 0
Router#
Router# show msfc eeprom
RSFC CPU IDPROM:
IDPROM image:
(FRU is 'Cat6k MSFC 2 daughterboard')
IDPROM image block #0:
hexadecimal contents of block:
Cisco IOS Interface and Hardware Component Command Reference
1788
show interfaces vlan mapping through show scp
show msfc
00: AB AB 01 90 13 22 01 00 00 02 60 03 00 EA 43 69 ....."....`...Ci
10: 73 63 6F 20 53 79 73 74 65 6D 73 00 00 00 00 00 sco Systems.....
20: 00 00 57 53 2D 46 36 4B 2D 4D 53 46 43 32 00 00 ..WS-F6K-MSFC2..
30: 00 00 00 00 00 00 53 41 44 30 36 32 31 30 30 36 ......SAD0621006
40: 37 00 00 00 00 00 00 00 00 00 37 33 2D 37 32 33 7.........73-723
50: 37 2D 30 33 00 00 00 00 00 00 41 30 00 00 00 00 7-03......A0....
60: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
70: 00 00 00 02 00 03 00 00 00 00 00 09 00 05 00 01 ................
80: 00 03 00 01 00 01 00 02 00 EA FF DF 00 00 00 00 ................
block-signature = 0xABAB, block-version = 1,
block-length = 144, block-checksum = 4898
*** common-block ***
IDPROM capacity (bytes) = 256 IDPROM block-count = 2
FRU type = (0x6003,234)
OEM String = 'Cisco Systems'
Product Number = 'WS-F6K-MSFC2'
Serial Number = 'SAD06210067'
Manufacturing Assembly Number = '73-7237-03'
Manufacturing Assembly Revision = 'A0'
Hardware Revision = 2.3
Manufacturing bits = 0x0 Engineering bits = 0x0
SNMP OID = 9.5.1.3.1.1.2.234
Power Consumption = -33 centiamperes RMA failure code = 0-0-0-0
*** end of common block ***
IDPROM image block #1:
hexadecimal contents of block:
00: 60 03 01 62 0A C2 00 00 00 00 00 00 00 00 00 00 `..b............
10: 00 00 00 00 00 01 00 23 00 08 7C A4 CE 80 00 40 .......#..|....@
20: 01 01 00 01 00 00 00 00 00 00 00 00 00 00 00 00 ................
30: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
40: 14 01 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
50: 10 00 4B 3C 41 32 80 80 80 80 80 80 80 80 80 80 ..K<A2..........
60: 80 80 ..
block-signature = 0x6003, block-version = 1,
block-length = 98, block-checksum = 2754
*** linecard specific block ***
feature-bits = 00000000 00000000
hardware-changes-bits = 00000000 00000001
card index = 35
mac base = 0008.7CA4.CE80
mac_len = 64
num_processors = 1
epld_num = 1
epld_versions = 0001 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 00
00 0000 0000
port numbers:
pair #0: type=14, count=01
pair #1: type=00, count=00
pair #2: type=00, count=00
pair #3: type=00, count=00
pair #4: type=00, count=00
pair #5: type=00, count=00
pair #6: type=00, count=00
pair #7: type=00, count=00
sram_size = 4096
sensor_thresholds =
sensor #0: critical = 75 oC, warning = 60 oC
sensor #1: critical = 65 oC, warning = 50 oC
sensor #2: critical = -128 oC (sensor not present), warning = -128 oC (senso
r not present)
sensor #3: critical = -128 oC (sensor not present), warning = -128 oC (senso
r not present)
sensor #4: critical = -128 oC (sensor not present), warning = -128 oC (senso
r not present)
Cisco IOS Interface and Hardware Component Command Reference
1789
show interfaces vlan mapping through show scp
show msfc
sensor #5: critical = -128 oC (sensor not present), warning = -128 oC (senso
r not present)
sensor #6: critical = -128 oC (sensor not present), warning = -128 oC (senso
r not present)
sensor #7: critical = -128 oC (sensor not present), warning = -128 oC (senso
r not present)
*** end of linecard specific block ***
End of IDPROM image
Router#
Router# show msfc fault
Reg. set Min Max
TX 640
ABQ 640 16384
0 0 40
1 6715 8192
2 0 0
3 0 0
4 0 0
5 0 0
6 0 0
7 0 0
Threshold = 8192
Vlan Sel Min Max Cnt Rsvd
1016 1 6715 8192 0 0
Router#
Router# show msfc netint
Network IO Interrupt Throttling:
throttle count=0, timer count=0
active=0, configured=1
netint usec=3999, netint mask usec=400
Router#
Router# show msfc tlb
Mistral revision 3
TLB entries : 37
Virt Address range Phy Address range Attributes
0x10000000:0x1001FFFF 0x010000000:0x01001FFFF CacheMode=2, RW, Valid
0x10020000:0x1003FFFF 0x010020000:0x01003FFFF CacheMode=2, RW, Valid
0x10040000:0x1005FFFF 0x010040000:0x01005FFFF CacheMode=2, RW, Valid
0x10060000:0x1007FFFF 0x010060000:0x01007FFFF CacheMode=2, RW, Valid
0x10080000:0x10087FFF 0x010080000:0x010087FFF CacheMode=2, RW, Valid
0x10088000:0x1008FFFF 0x010088000:0x01008FFFF CacheMode=2, RW, Valid
0x18000000:0x1801FFFF 0x010000000:0x01001FFFF CacheMode=0, RW, Valid
0x19000000:0x1901FFFF 0x010000000:0x01001FFFF CacheMode=7, RW, Valid
0x1E000000:0x1E1FFFFF 0x01E000000:0x01E1FFFFF CacheMode=2, RW, Valid
0x1E880000:0x1E881FFF 0x01E880000:0x01E881FFF CacheMode=2, RW, Valid
0x1FC00000:0x1FC7FFFF 0x01FC00000:0x01FC7FFFF CacheMode=2, RO, Valid
0x30000000:0x3001FFFF 0x070000000:0x07001FFFF CacheMode=2, RW, Valid
0x40000000:0x407FFFFF 0x000000000:0x0007FFFFF CacheMode=3, RO, Valid
0x40800000:0x40FFFFFF 0x000800000:0x000FFFFFF CacheMode=3, RO, Valid
0x41000000:0x417FFFFF 0x001000000:0x0017FFFFF CacheMode=3, RO, Valid
0x41800000:0x419FFFFF 0x001800000:0x0019FFFFF CacheMode=3, RO, Valid
0x41A00000:0x41A7FFFF 0x001A00000:0x001A7FFFF CacheMode=3, RO, Valid
0x41A80000:0x41A9FFFF 0x001A80000:0x001A9FFFF CacheMode=3, RO, Valid
0x41AA0000:0x41ABFFFF 0x001AA0000:0x001ABFFFF CacheMode=3, RO, Valid
0x41AC0000:0x41AC7FFF 0x001AC0000:0x001AC7FFF CacheMode=3, RO, Valid
0x41AC8000:0x41ACFFFF 0x001AC8000:0x001ACFFFF CacheMode=3, RO, Valid
0x41AD0000:0x41AD7FFF 0x001AD0000:0x001AD7FFF CacheMode=3, RO, Valid
0x41AD8000:0x41AD9FFF 0x001AD8000:0x001AD9FFF CacheMode=3, RO, Valid
0x41ADA000:0x41ADBFFF 0x001ADA000:0x001ADBFFF CacheMode=3, RW, Valid
0x41ADC000:0x41ADDFFF 0x001ADC000:0x001ADDFFF CacheMode=3, RW, Valid
0x41ADE000:0x41ADFFFF 0x001ADE000:0x001ADFFFF CacheMode=3, RW, Valid
0x41AE0000:0x41AFFFFF 0x001AE0000:0x001AFFFFF CacheMode=3, RW, Valid
0x41B00000:0x41B7FFFF 0x001B00000:0x001B7FFFF CacheMode=3, RW, Valid
0x41B80000:0x41BFFFFF 0x001B80000:0x001BFFFFF CacheMode=3, RW, Valid
Cisco IOS Interface and Hardware Component Command Reference
1790
show interfaces vlan mapping through show scp
show msfc
0x41C00000:0x41DFFFFF 0x001C00000:0x001DFFFFF CacheMode=3, RW, Valid
0x41E00000:0x41FFFFFF 0x001E00000:0x001FFFFFF CacheMode=3, RW, Valid
0x42000000:0x43FFFFFF 0x002000000:0x003FFFFFF CacheMode=3, RW, Valid
0x44000000:0x45FFFFFF 0x004000000:0x005FFFFFF CacheMode=3, RW, Valid
0x46000000:0x47FFFFFF 0x006000000:0x007FFFFFF CacheMode=3, RW, Valid
0x06E00000:0x06FFFFFF 0x006E00000:0x006FFFFFF CacheMode=2, RW, Valid
0x07000000:0x077FFFFF 0x007000000:0x0077FFFFF CacheMode=2, RW, Valid
0x07800000:0x07FFFFFF 0x007800000:0x007FFFFFF CacheMode=2, RW, Valid
Router#
Related Commands Command Description
show environment alarm Displays the information about the environmental alarm.
show fm summary Displays a summary of FM Information.
show environment status Displays the information about the operational FRU status.
Cisco IOS Interface and Hardware Component Command Reference
1791
show interfaces vlan mapping through show scp
show network-clocks
show network-clocks
To display the current configured and active network clock sources, use theshownetwork-clocks command
in privileged EXEC mode.
show network-clocks
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC
Command History Release Modification
11.1 This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
12.2(33)SRD1 This command was introduced to display BITS clock information for the 7600-ES+ITU-2TG
and 7600-ES+ITU-4TG.
Usage Guidelines On the Cisco MC3810, this command applies to Voice over Frame Relay, Voice over ATM, and Voice over
HDLC. The Cisco MC3810 has a background task that verifies whether a valid clocking configuration exists
every 120 seconds. If this task detects an error, you will be reminded every 120 seconds until the error is
corrected. A clocking configuration error may be generated for various reasons. Using the shownetwork-clocks
command, you can display the clocking configuration status.
On the Cisco 7600 series routers, this command applies to the following:
• The clock source from the POS SPAs on the SIP-200 and the SIP-400.
• The 24-Port Channelized T1/E1 ATM CEoP SPA and the 1-Port Channelized OC-3 STM1 ATM CEoP
SPA on the SIP-400.
• The 7600-ES+ITU-2TG and 7600-ES+ITU-4TG line cards.
Examples The following is sample output from the shownetwork-clocks EXEC command:
Router# show network-clocks
Priority 1 clock source: ATM3/0/0
Priority 2 clock source: System clock
Priority 3 clock source: System clock
Priority 4 clock source: System clock
Current clock source:ATM3/0/0, priority:1
The following is sample output from the shownetwork-clocks command on the Cisco MC3810:
Router# show network-clocks
Priority 1 clock source(inactive config): T1 0
Priority 1 clock source(active config) : T1 0
Cisco IOS Interface and Hardware Component Command Reference
1792
show interfaces vlan mapping through show scp
show network-clocks
Clock switch delay: 10
Clock restore delay: 10
T1 0 is clocking system bus for 9319 seconds.
Run Priority Queue: controller0
In this display, inactive configuration is the new configuration that has been established. Active
configuration is the run-time configuration. Should an error be made in the new configuration, the
inactive and active configurations will be different. In the previous example, the clock priority
configuration is valid, and the system is being clocked as indicated.
The following is another sample output from the shownetwork-clocks command:
Router# show network-clocks
Priority 1 clock source(inactive config) : T1 0
Priority 2 clock source(inactive config) : T1 1
Priority 1 clock source(active config) : T1 0
Clock switch delay: 10
Clock restore delay: 10
T1 0 is clocking system bus for 9319 seconds.
Run Priority Queue: controller0
In this display, the new clocking configuration has an error for controller T1 1. This is indicated by
checking differences between the last valid configuration (active) and the new proposed configuration
(inactive). The error may result from hardware (the system controller board or MFT) unable to support
this mode, or controller T1 1 is currently configured as “clock source internal.”
Since the active and inactive configurations are different, the system will periodically display the
warning message about the wrong configuration.
The following is another sample output from the shownetwork-clocks command for the
7600-ES+ITU-2TG or 7600-ES+ITU-4TG:
Router# show network-clocks
Active source = Slot 1 BITS 0
Active source backplane reference line = Primary Backplane Clock
Standby source = Slot 9
Standby source backplane reference line = Secondary Backplane Clock
(Standby source not driving backplane clock currently)
All Network Clock Configuration
---------------------------------
Priority Clock Source State Reason
1 POS3/0/1 Valid but not present
2 Slot 1 BITS 0 Valid
3 Slot 9 Valid
Current operating mode is Revertive
Current OOR Switchover mode is Switchover
There are no slots disabled from participating in network clocking
BITS Port Configuration
-------------------------
Slot Port Signal Type/Mode Line Build-Out Select
1 0 T1 ESF DSX-1 (533 to 655 feet)
Related Commands Command Description
clock source Specifies the interface clock source type.
network-clock Configures BITS port signaling types.
Cisco IOS Interface and Hardware Component Command Reference
1793
show interfaces vlan mapping through show scp
show network-clocks
Command Description
network-clock select Selects a source of network clock.
network-clock-select (ATM) Establishes the sources and priorities of the requisite clocking
signals for an ATM-CES port adapter.
show platform hardware network-clocks Displays network clocks for an ES+ line card.
Cisco IOS Interface and Hardware Component Command Reference
1794
show interfaces vlan mapping through show scp
show pagp
show pagp
To display port-channel information, use the show pagp command in user EXEC or privileged EXEC mode.
show pagp [group-number] {counters|internal|neighbor|pgroup}
Syntax Description group-number (Optional) Channel-group number; valid values are a maximum of 64 values from 1 to 282.
counters Displays the traffic information.
internal Displays the internal information.
neighbor Displays the neighbor information.
pgroup Displays the active port channels.
Command Default This command has no default settings.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines You can enter any show pagp command to display the active port-channel information. To display the
nonactive information, enter the show pagp command with a group.
The port-channel numbervalues from 257 to 282 are supported on the CSM and the FWSM only.
Examples This example shows how to display information about the PAgP counters:
Router#
show pagp
counters
Information Flush
Port Sent Recv Sent Recv
--------------------------------------
Channel group: 1
Fa5/4 2660 2452 0 0
Fa5/5 2676 2453 0 0
Channel group: 2
Fa5/6 289 261 0 0
Fa5/7 290 261 0 0
Channel group: 1023
Fa5/9 0 0 0 0
Channel group: 1024
Fa5/8 0 0 0 0
Router#
Cisco IOS Interface and Hardware Component Command Reference
1795
show interfaces vlan mapping through show scp
show pagp
This example shows how to display internal PAgP information:
Router# show pagp
1 internal
Flags: S - Device is sending Slow hello. C - Device is in Consistent state.
A - Device is in Auto mode.
Timers: H - Hello timer is running. Q - Quit timer is running.
S - Switching timer is running. I - Interface timer is running.
Channel group 1
Hello Partner PAgP Learning
Port Flags State Timers Interval Count Priority Method
Fa5/4 SC U6/S7 30s 1 128 Any
Fa5/5 SC U6/S7 30s 1 128 Any
Router#
This example shows how to display PAgP-neighbor information for all neighbors:
Router# show pagp
neighbor
Flags: S - Device is sending Slow hello. C - Device is in Consistent state.
A - Device is in Auto mode. P - Device learns on physical port.
Channel group 1 neighbors
Partner Partner Partner Partner Group
Port Name Device ID Port Age Flags Cap.
Fa5/4 JAB031301 0050.0f10.230c 2/45 2s SAC 2D
Fa5/5 JAB031301 0050.0f10.230c 2/46 27s SAC 2D
Channel group 2 neighbors
Partner Partner Partner Partner Group
Port Name Device ID Port Age Flags Cap.
Fa5/6 JAB031301 0050.0f10.230c 2/47 10s SAC 2F
Fa5/7 JAB031301 0050.0f10.230c 2/48 11s SAC 2F
Channel group 1023 neighbors
Partner Partner Partner Partner Group
Port Name Device ID Port Age Flags Cap.
Channel group 1024 neighbors
Partner Partner Partner Partner Group
Port Name Device ID Port Age Flags Cap.
Router#
Related Commands Command Description
pagp learn-method Learns the input interface of the incoming packets.
pagp port-priority Selects a port in hot standby mode.
Cisco IOS Interface and Hardware Component Command Reference
1796
show interfaces vlan mapping through show scp
show pas caim
show pas caim
To show debug information about the data compression Advanced Interface Module (CAIM) daughter card,
use the showpascaimcommand in user EXEC or privileged EXEC mode.
show pas caim {rings|dma|coprocessor|stats|cnxt_table|page_table} element-number
Syntax Description rings element-number Displays current content of the Direct Memory Access (DMA) ring buffer.
dma element-number Displays registers of the Jupiter DMA controller.
coprocessor element-number Displays registers of the Hifn 9711 compression coprocessor.
stats element-number Displays statistics that describes operation of the data compression
Advanced Interface Module (AIM).
cnxt_table element-number Displays the context of the specific data compression AIM element.
page_table element-number Displays the page table for each CAIM element.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.0(2)T This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command displays performance statistics that describe the operation of the CAIM. This command is
primarily intended for engineering debug, but it can also be useful to Cisco support personnel and to Cisco
customers in troubleshooting network problems. The table below lists the output values for this command.
Table 176: show pas caim Output Values and Descriptions
Value Description
uncomp paks in Number of packets containing uncompressed data input to the CAIM for compression.
comp paks out Number of packets containing uncompressed data that were successfully compressed.
comp paks in Number of packets containing compressed data input to the CAIM for compression.
uncomp paks out Number of packets containing compressed data that were successfully decompressed.
Cisco IOS Interface and Hardware Component Command Reference
1797
show interfaces vlan mapping through show scp
show pas caim
Value Description
uncomp bytes in / Summarizes the compression performance of the CAIM. The “uncomp bytes in” statistic
comp bytes out gives the total number of uncompressed bytes submitted to the CAIM for compression.
The “Comp bytes out” statistic gives the resulting number of compressed bytes output
by the CAIM. If one forms the ratio of “uncomp bytes in” to “comp bytes out”, one
obtains the average compression ratio achieved by the CAIM.
comp bytes in / Summarizes the decompression performance of the CAIM. The “comp bytes in” statistic
uncomp bytes out gives the total number of compressed bytes submitted to the CAIM for decompression.
The “uncomp bytes out” statistic gives the resulting number of uncompressed bytes
output by the CAIM. The average decompression ratio achieved can be computed as
the ratio of “uncomp bytes out” to “comp bytes in”.
Note that each packet submitted for compression or decompression has a small header
at the front which is always clear data and hence never compressed nor decompressed.
The “comp bytes in / uncomp bytes out” and “uncomp bytes in / comp bytes out”
statistics do not include this header.
uncomp paks/sec in A time average of the number of packets per second containing uncompressed data
submitted as input to the CAIM for compression. It is computed as the ratio of the
“uncomp paks in” statistic to the “seconds since last clear” statistic.
comp paks/sec out A time average of the number of packets per second containing uncompressed data
which were successfully compressed by the CAIM. It is computed as the ratio of the
“comp paks out” statistic to the “seconds since last clear” compressed by the CAIM.
It is computed as the ratio of the “comp paks out” statistic to the “seconds since last
clear” statistic.
comp paks/sec in A time average of the number of packets per second containing compressed data
submitted as input to the CAIM for decompression. It is computed as the ratio of the
“comp paks in” statistic to the “seconds since last clear” statistic.
uncomp paks/sec A time average of the number of packets per second containing compressed data which
out were successfully decompressed by the CAIM. It is computed as the ratio of the
“uncomp paks out” statistic to the “seconds since last clear” statistic.
Note that the “uncomp paks/sec in”, “comp paks/sec out”, “comp paks/sec in”, and
“uncomp paks/sec out” statistics are averages over the entire time since the last “clear
count” command was issued. This means that as time progresses, these statistics become
averages over an ever larger time interval. As time progresses, these statistics become
ever less sensitive to current prevailing conditions. Note also that the “uncomp paks
in”, “comp paks out”, “comp paks in”, and “uncomp paks out” statistics are 32-bit
counters and can roll over from 0xffff ffff to 0. When they do so, the “uncomp paks/sec
in”, “comp paks/sec out”, “comp paks/sec in”, and “uncomp paks/sec out” statistics
can be rendered meaningless. It is therefore recommend that one issue a “clear count”
command before sampling these statistics.
uncomp bits/sec in A time average of the number of bits per second of uncompressed data which were
submitted to the CAIM for compression. It is computed as the ratio of the “uncomp
bytes in” statistic, times 8, to the “seconds since last clear” statistic.
Cisco IOS Interface and Hardware Component Command Reference
1798
show interfaces vlan mapping through show scp
show pas caim
Value Description
comp bits/sec out A time average of the number of bits per second of uncompressed data which were
successfully compressed by the CAIM. It is computed as the ratio of the “comp bytes
out” statistic, times 8, to the “seconds since last clear” statistic.
comp bits/sec in A time average of the number of bits per second of compressed data which were
submitted to the CAIM for decompression. It is computed as the ratio of the “comp
bytes in” statistic, times 8, to the “seconds since last clear” statistic.
uncomp bits/sec out A time average of the number of bits per second of compressed data which were
successfully decompressed by the CAIM. It is computed as the ratio of the “uncomp
bytes in” statistic, times 8, to the “seconds since last clear” statistic.
Note again that these “bits/sec” statistics are time averages over the “seconds since
last clear” statistics, and therefore become less and less sensitive to current conditions
as time progresses. Also, these “bits/sec” statistics are computed from 32-bit counters,
and when the counters roll over from the maximum 32-bit value to 0, the “bits/sec”
statistics become inaccurate. It is again recommended that one issue the “clear count”
command before sampling the “bits/sec” statistics.
The remaining
statistics summarize
operational state and
error conditions
encountered by the
CAIM, and have the
following
interpretations:
holdq Gives the number of packets occupying the “hold queue” of the CAIM. The hold queue
is a holding area, or “overflow” area, for packets to be processed by the CAIM.
Normally, the CAIM is fast enough that no overflow into the hold queue occurs, and
so normally this statistic should show zero.
hw_enable Flag indicating if the CAIM is disabled or not. Zero implies disabled; one implies
enabled. The CAIM can become disabled if certain fatal hardware error conditions are
detected. It can be reenabled by issuing the clearaimelement-number command.
src_limited Flag indicating if the CAIM is in “source limited” mode. In source limited mode, the
CAIM can only process a single command at a time. In non source limited mode, the
CAIM can process several commands at a time using a pipeline built into the 9711
coprocessor. Note that the normal mode of operation is “non-source limited”, and there
is no command to place the CAIM in “source limited” mode. Hence, this statistic should
always read zero.
num cnxts Gives the number of “contexts” which are currently open on the CAIM. Each interface
configured for compression opens two contexts, one for each direction of data transfer.
no data Counts the number of times in which the CAIM performed either a compress or
decompression operation, and the output data length was reported with a length of
zero. In normal operation, this statistic should always read zero. A nonzero value is an
indication of a malfunctioning CAIM.
Cisco IOS Interface and Hardware Component Command Reference
1799
show interfaces vlan mapping through show scp
show pas caim
Value Description
drops Counts the total number of times in which the CAIM was forced to drop a packet it
was asked to compress or decompress. This can happen for a number of reasons, and
the remaining statistics summarize these reasons. This statistic indicates that the CAIM
is being overloaded with requests for compression/decompression.
nobuffers Counts the total number of times the CAIM needed to allocate memory for buffers but
could not obtain memory. The CAIM allocates memory for buffers for holding the
results of compression or decompression operations. In normal operation, there is
plenty of memory available for holding CAIM results. This statistic, if nonzero, indicates
that there is a significant backup in memory, or perhaps a memory leak.
enc adj errs Each packet compressed or decompressed involves an adjustment of the encapsulation
of the packet between the LZS-DCP, FRF9, or MPPC encapsulation used to transport
compressed packets to the standard encapsulation used to transport clear data. This
statistic counts the number of times this encapsulation adjustment failed. In normal
operation, this statistic should be zero. A nonzero value indicates that we are short in
a specific memory resource referred to as “paktypes”, and that packets are being dropped
because of this shortage.
fallbacks Number of times the data compression AIM card could not use its pre-allocated buffers
to store compression results and had to “fallback” to using a common buffer pool.
no replace Each time a compression or decompression operation is completed and the resultant
data fill up a buffer, the CAIM software allocates a new buffer to replace the buffer
filled. If no buffers are available, then the packet involved in this operation is dropped
and the old buffer reused. This statistic thus represents the number of times such an
allocation failure occurred. In normal operation there is plenty of memory available
for these buffers. A nonzero value for this statistic is thus a serious indication of a
memory leak or other backup in buffer usage somewhere in the system.
num seq errs This statistic is incremented when the CAIM produces results in a different order than
that in which the requests were submitted. Packets involved in such errors are dropped.
A nonzero value in this statistic indicates a serious malfunction in the CAIM.
num desc errs Incremented when the CAIM reports error in a compression or decompression operation.
Such errors are most likely bus errors, and they indicate a serious malfunction in the
CAIM.
cmds complete Reports the number of compression/decompression commands completed. This statistic
should steadily increase in normal operation (assuming that the CAIM is continuously
being asked to perform compression or decompression). If this statistic is not steadily
increasing or decreasing when a steady stream of compression/decompression is
expected, this is an indication of a malfunctioning CAIM.
bad reqs Reports the number of compression/decompression requests that the CAIM software
determined it could not possibly handle. This occurs only if a severely scattered packet
(with more than 64 “particles”, or separate buffers of data) is handed to the CAIM to
compress or decompress. This statistic should not increment during normal operation.
A nonzero value indicates a software bug.
Cisco IOS Interface and Hardware Component Command Reference
1800
show interfaces vlan mapping through show scp
show pas caim
Value Description
dead cntxts Number of times a packet was successfully compressed or decompressed, only to find
that the software “context”, or stream sourcing the packet, was no longer around. In
such a case the packet is dropped. This statistic can be incremented at times when a
serial interface is administratively disabled. If the timing is right, the CAIM may be
right in the middle of operating on a packet from that interface when the disable takes
effect. When the CAIM operation completes, it finds that the interface has been disabled
and all “compression contexts” pertaining to that interface have been deleted. Another
situation in which this can occur is when a Frame Relay DLC goes down. This is a
normal and tolerable. If this statistic is incrementing when no such situations exist, it
is an indication of a software bug.
no paks If a packet to be compressed or decompressed overflows into the hold queue, then it
must undergo an operation called “reparenting”. This involves the allocation of a
“paktype” structure for the packet. If no paktype structures are available, then the
packet is dropped and this statistic is incremented. A nonzero value of this statistic
indicates that the CAIM is being overtaxed, that is, it is being asked to
compress/decompress at a rate exceeding its capabilities.
enq errors Closely related to the “no paks” statistic. The hold queue for the CAIM is limited in
length, and if the hold queue grows to this length, no further packets may be placed
on it. A nonzero value of this statistic therefore also indicates that the CAIM is being
overtaxed.
rx pkt drops Contains the total number of packets dropped because of “no paks” or “enq errors”,
which were destined to be decompressed.
tx pkt drops Contains the total number of packets dropped because of “no paks” or “enq errors”,
which were destined to be compressed
dequeues Indicates the total number of packets which were removed from the CAIM hold queue
when the CAIM became available for servicing its hold queue.
requeues Indicates the total number of packets that were removed from the hold queue, only to
find that the necessary CAIM resources were not available (it is not possible to
determine whether CAIM resources are available until the packet is dequeued). Such
packets are requeued onto the hold queue, with order in the queue preserved.
drops disabled Indicates the total number of packets which were submitted for compression or
decompression, but that were dropped because the CAIM was disabled.
clears Indicates the number of times the CAIM was reset using the
clearaimelement-numbercommand.
# ints Indicates the number of interrupts serviced by the CAIM software. This statistic should
steadily increase (assuming that the CAIM workload is steady). If this statistic is not
incremented when expected, it indicates a severe CAIM malfunction.
Cisco IOS Interface and Hardware Component Command Reference
1801
show interfaces vlan mapping through show scp
show pas caim
Value Description
# purges Indicates the total number of times the compression history for a session had to be
purged. This statistic is incremented a couple of times at startup. Thereafter, any increase
in this statistic is an indication that the other side of the serial link detected bad data
or gaps in the compressed packets being passed to it, and hence signalled a request to
purge compression history in order to get back in synchronization. This can indicate
that the CAIM is being overtaxed or that the serial interface is overtaxed and being
forced to drop output packets.
no cnxts Indicates the total number of times a request was issued to open a context, but the
CAIM could not support any more contexts. Recall that two contexts are required for
each interface configured for compression.
bad algos Indicates the total number of times a request was issued to open a context for a
compression algorithm not supported by the CAIM. Recall that the CAIM supports
the LZS and MPPC algorithms only.
no crams Indicates the total number of times a request was issued to open a context but there
was insufficient compression DRAM to open another context. The CAIM software is
set up to run out of contexts before it runs out of compression DRAM, so this statistic
should always be zero.
bad paks Indicates the total number of times a packet was submitted for compression or
decompression to the CAIM, but the packet had an invalid size.
# opens Indicates the total number of times a context was opened.
# closes Indicates the total number of times a context was closed.
# hangs Indicates the total number of times a CAIM appeared hung up, necessitating a clear of
the CAIM.
Examples The showpascaimringselement-number command displays the current state of the DMA ring buffers
maintained by the CAIM software. These rings feed the CAIM with data and commands. It is intended
for an engineering debug of the compression AIM. It produces the following output:
Router# show pas caim rings 0
CAIM Command Ring: 0x01A2BC00 Stack: 0x01A2BE40 Shadow: 0x80F88BAC
Head: 0021 Tail: 0021 Count: 0000
CAIM Source Ring: 0x01A2C900 Shadow: 0x80F88BAC
Head: 0021 Tail: 0021 Num: 0000
CAIM Results Ring: 0x01A2C280 Stack: 0x01A2C4C0
Head=021 Tail=021
CAIM Dest Ring: 0x01A2CB40 Shadow: 0x80F892D8 Head=021 Tail=000
Desc: 0x01A2CBE8 flags: 0x8000060C dptr: 0x019E7EB8 part: 0x80F84BE0
Desc: 0x01A2CBF0 flags: 0x8000060C dptr: 0x019FC63C part: 0x80F85240
.
.
.
The table below describes the significant fields shown in the display.
Cisco IOS Interface and Hardware Component Command Reference
1802
show interfaces vlan mapping through show scp
show pas caim
Table 177: show pas caim rings Field Descriptions
Field Description
CAIM Command Ring Feeds commands to the CAIM.
command ring address Address of the command ring.
Command Ring Stack Ring that feeds additional commands to the CAIM.
command ring stack address Address of the command ring stack.
Command Ring Shadow Software ring that stores additional information about each
command.
command ring shadow address Address of the command ring shadow.
Command Ring Head Index into the Source Ring, specifying where the next entry will
be extracted from.
Command Ring Tail Index into the Source Ring, specifying where the next entry will
be inserted.
CAIM Source Ring Feeds information about input data to the CAIM.
source ring address Address of the source ring.
Source Ring Shadow Ring that contains additional information about each source buffer.
source ring shadow address Address of the source ring shadow.
Source Ring Head Specifies where the next entry will be extracted from.
Source Ring Tail Specifies where the next entry will be inserted.
CAIM Results Ring Receives information about each CAIM command as it is
completed.
results ring address Address of the results ring.
Results Ring Stack Ring that receives additional information about each completed
command.
results ring stack address Address of the results ring stack.
Results Ring Head Specifies where the next entry will be extracted from.
Results Ring Tail Specifies where the next entry will be inserted.
CAIM Dest Ring Holds information about the buffers available to the CAIM for
output data.
dest ring address Address of the dest ring.
Dest Ring Shadow Ring that holds additional information about each output buffer.
Cisco IOS Interface and Hardware Component Command Reference
1803
show interfaces vlan mapping through show scp
show pas caim
Field Description
dest ring shadow address Address of the dest ring shadow.
Dest Ring Head Index into the Source Ring, specifying where the next entry will
be extracted from.
Dest Ring Tail Index into the Source Ring, specifying where the next entry will
be inserted.
The remaining fields describe each output
data buffer.
dest Address of a so-called descriptor, used by the Jupiter DMA engine.
flags Contains flags describing attributes of the buffer.
dptr Displays the actual address of the output buffer.
part Displays the address of the corresponding particle type structure,
a software-defined structure that describes a buffer when it is a
component of a network data buffer.
The show pas caim dma element-numbercommand displays the registers of the Jupiter DMA
Controller. These registers control the operation of the Jupiter DMA Controller. This command is
intended for Engineering debug of the CAIM. You can find detailed descriptions of the various fields
in the Jupiter DMA Controller specification. It produces the following output:
Router# show pas caim dma 0
Jupiter DMA Controller Registers: (0x40200000
Cmd Ring: 0x01A2BCA8 Src Ring: 0x01A2C9A8
Res Ring: 0x01A2C328 Dst Ring: 0x01A2CBE8
Status/Cntl: present: 0x80808084 last int: 0x80808084
Inten: 0x10100000 config: 0x00100003
Num DMA ints: 143330469
The show pas caim compressor element-number command displays the registers of the Hifn 9711
compression coprocessor. These registers control the operation of the Hifn 9711 part. This command
is intended for engineering to debug the CAIM. Detailed descriptions of the various fields may be
found in the Hifn 9711 data book. It produces the following output:
Router# show pas caim compressor 0
Hifn9711 Data Compression Coprocessor Registers (0x40201000):
Config: 0x000051D4 Inten: 0x00000E00
Status: 0x00004000 FIFO status: 0x00004000
FIFO config: 0x00000101
The table below describes the fields shown in the preceding display.
Table 178: show pas caim compressor Field Descriptions
Field Description
Hifn9711 Data Compression Coprocessor Controls the operation of the Hifn 9711 part.
Registers
Cisco IOS Interface and Hardware Component Command Reference
1804
show interfaces vlan mapping through show scp
show pas caim
Field Description
registers address Address of the registers in the address space of the processor.
Config Displays the current contents of the 9711 configuration register.
Inten Displays the contents of the 9711 interrupt enable register.
Status Displays the contents of the 9711 status register.
FIFO status Contents of the 9711 FIFO Status register.
FIFO config Contents of the 9711 FIFO Config register.
The show pas caim cnxt_table element-number command displays the context table for the specified
CAIM element. The context table is a table of information concerning each compression context. It
produces the following output:
Router# show pas caim cnxt_table 0
CAIM0 Context Table
Context: 0x8104F320 Type: Compr Algo: Stac
Hdrlen: 0006 History: 0x0000
Callback: 0x8011D68C Shutdown: x8011EBE4 Purge: N
Comp_db: 0x81034BC0 idb: 0x81038084 ds: 0x8104E514
Context: 0x8104F340 Type: Decomp Algo: Stac
Hdrlen: 0002 History: 0x0000
Callback: 0x8011E700 Shutdown: x8011EBE4 Purge: N
Comp_db: 0x81034BC0 idb: 0x81038084 ds: 0x8104E514
The table below describes the fields shown in the preceding display.
Table 179: show pas caim cnxt_table Fields Descriptions
Field Description
Context Numeric internal reference for the compression context.
Type Gives the type of context:
• Compr--compression context
• Decomp--decompression context
Algo Gives the compression algorithm used:
• Stac
• Mppc
Hdrlen Gives the number of bytes in the compression header for each compressed packet.
History Gives the 16-KB page number in compression RAM for the context.
Callback Gives an internal numeric reference for a control structures or procedure to facilitate debugging.
Shutdown Gives an internal numeric reference for a control structures or procedure to facilitate debugging.
Cisco IOS Interface and Hardware Component Command Reference
1805
show interfaces vlan mapping through show scp
show pas caim
Field Description
Comp_db Gives an internal numeric reference for a control structures or procedure to facilitate debugging.
idb Gives an internal numeric reference for a control structures or procedure to facilitate debugging.
idb Gives an internal numeric reference for a control structures or procedure to facilitate debugging.
Purge Indicates whether the compression context has been flagged to have its history purged.
The show pas caim page_table element-number command displays the page table for the selected
CAIM element. The page table is a table of entries describing each page in compression RAM. It
produces the following output:
Router# show pas caim page_table 0
CAIM0 Page Table
Page 0x0000 Comp cnxt: 8104F320 Decmp cnxt: 8104F340 Algo: Stac
The table below describes the fields shown in the preceding display.
Table 180: show pas caim page_table Field Descriptions
Field Description
Page 16 KB page number of the page.
Comp cnxt Contains an internal numeric reference to the context structures using this page.
Decmp cnxt Contains an internal numeric reference to the context structures using this page.
Algo Gives the compression algorithm used:
• Stac
• Mppc
The following example shows statistics of an active data compression AIM session:
Router# show pas caim stats 0
CompressionAim0
ds:0x80F56A44 idb:0x80F50DB8
422074 uncomp paks in --> 422076 comp paks out
422071 comp paks in --> 422075 uncomp paks out
633912308 uncomp bytes in--> 22791798 comp bytes out
27433911 comp bytes in --> 633911762 uncomp bytes out
974 uncomp paks/sec in--> 974 comp paks/sec out
974 comp paks/sec in --> 974 uncomp paks/sec out
11739116 uncomp bits/sec in--> 422070 comp bits/sec out
508035 comp bits/sec in --> 11739106 uncomp bits/sec out
433 seconds since last clear
holdq: 0 hw_enable: 1 src_limited: 0 num cnxts: 4
no data: 0 drops: 0 nobuffers: 0 enc adj errs: 0 fallbacks: 0
no Replace: 0 num seq errs: 0 num desc errs: 0 cmds complete: 844151
Bad reqs: 0 Dead cnxts: 0 No Paks: 0 enq errs: 0
rx pkt drops: 0 tx pkt drops: 0 dequeues: 0 requeues: 0
drops disabled: 0 clears: 0 ints: 844314 purges: 0
no cnxts: 0 bad algos: 0 no crams: 0 bad paks: 0
# opens: 0 # closes: 0 # hangs: 0
Cisco IOS Interface and Hardware Component Command Reference
1806
show interfaces vlan mapping through show scp
show pas caim
Related Commands Command Description
show compress Displays compression statistics.
Cisco IOS Interface and Hardware Component Command Reference
1807
show interfaces vlan mapping through show scp
show pas eswitch address
show pas eswitch address
To display the Layer 2 learned addresses for an interface, use the showpaseswitchaddress command in user
EXEC or privileged EXEC mode.
show pas eswitch address commandshow pas eswitch address [{ethernet|fastethernet}] [slot/port]
Syntax Description ethernet | fastethernet (Optional) Type of interface.
slot (Optional) Slot number of the interface.
port (Optional) Interface number.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
11.2P This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples The following sample output shows that the first PA-12E/2FE interface (listed below as port 0) in
port adapter slot 3 has learned the Layer 2 address 00e0.f7a4.5100 for bridge group 30 (listed below
as BG 30):
Router# show pas eswitch address fastethernet 3/0
U 00e0.f7a4.5100, AgeTs 56273 s, BG 30 (vLAN 0), Port 0
Cisco IOS Interface and Hardware Component Command Reference
1808
show interfaces vlan mapping through show scp
show pas i82543 interface
show pas i82543 interface
To display interface information that is specific to Fast Ethernet or Gigabit Ethernet port adapters with an
Intel 82543 processor on Cisco 7200 series routers, use the showpasi82543interfacecommand in privileged
EXEC mode.
show pas i82543 interface {fastethernet|gigabitethernet} slot/port
[{multicast-table|receive-address|statistics}]
Syntax Description fastethernet Displays i82543-specific information for Fast Ethernet interfaces.
gigabitethernet Displays i82543-specific information for Gigabit Ethernet interfaces.
slot Slot number.
/ port Port number. The slash mark is required between the slot argument and the port argument.
multicast-table (Optional) Displays i82543-specific multicast address table information.
Note In Cisco IOS Release 12.2 S, this keyword is MTA.
receive-address (Optional) Displays the contents of the receive address registers on the i82543 chip.
statistics (Optional) Displays i82543-specific statistical information.
Command Modes Privileged EXEC(#)
Command History Release Modification
12.2(20)S This command was introduced on Cisco 7200 series routers.
12.1(20)E This command was integrated into Cisco IOS Release 12.1(20)E on Cisco 7200 series routers.
12.0(27)S This command was integrated into Cisco IOS Release 12.0(27)S on Cisco 7200 series routers.
12.3(7)T This command was integrated into Cisco IOS Release 12.3(7)T on Cisco 7200 series routers.
Usage Guidelines Use the showpasi82543interface command with the statistics keyword to determine what types of packets
are being processed. Similar statistical information is displayed by the showcontrollersfastethernet and
showcontrollersgigabitethernet commands.
Note We recommend that the multicast-table and receive-address keywords for this command be used only under
the supervision of a Cisco engineer because of the cryptic output.
Examples The following sample output shows the contents of the multicast address table present on the i82543
processor.
Cisco IOS Interface and Hardware Component Command Reference
1809
show interfaces vlan mapping through show scp
show pas i82543 interface
Router# show pas i82543 interface fastethernet 6/0 multicast-table
Multicast Table Entry #0 = 0x10000
Multicast Table Entry #1 = 0x1
Multicast Table Entry #84 = 0x8000
The following sample output shows the contents of the Receive Address High (RAH) and Receive
Address Low (RAL) registers on the i82543 processor.
Router# show pas i82543 interface fastethernet 6/0 receive-address
#1 RAH 0x8000A8FC RAL 0x67B60900
#3 RAH 0x0003FFFF RAL 0xFF45F75B
#5 RAH 0x0003FFFF RAL 0xCBEE539A
#7 RAH 0x0003FFFF RAL 0x5ABDADEB
#9 RAH 0x0003FFFF RAL 0x365B5ACF
#11 RAH 0x0003FFFF RAL 0xB2D9B0CE
#13 RAH 0x0003FFFF RAL 0x12A91CF6
#15 RAH 0x0003FFFF RAL 0xEF4A3125
#17 RAH 0x0003FFFF RAL 0x1A07EB7D
#19 RAH 0x0003FFFF RAL 0xFF9B6EF8
#21 RAH 0x0003FFFF RAL 0xB7C2AFC9
#23 RAH 0x0003FFFF RAL 0x14F4FB0A
#25 RAH 0x0003FFFF RAL 0xC60D6706
#27 RAH 0x0003FFFF RAL 0x5E9DE230
#29 RAH 0x0003FFFF RAL 0x5FEF9FBE
#31 RAH 0x0003FFFF RAL 0xBBCCC57E
The following sample output shows packet statistics of the i82543 processor.
Router# show pas i82543 interface fastethernet 6/0 statistics
i82543 (Livengood) Statistics
CRC error 0 Symbol error 0
Missed Packets 0 Single Collision 0
Excessive Coll 0 Multiple Coll 0
Late Coll 0 Collision 0
Defer 0 Receive Length 0
Sequence Error 0 XON RX 0
XON TX 0 XOFF RX 0
XOFF TX 0 FC RX Unsupport 0
Packet RX (64) 0 Packet RX (127) 0
Packet RX (255) 0 Packet RX (511) 0
Packet RX (1023) 0 Packet RX (1522) 0
Good Packet RX 348 Broadcast RX 0
Multicast RX 319 Good Packet TX 0
Good Octets RX.H 0 Good Octets RX.L 0
Good Octets TX.H 0 Good Octets TX.L 0
RX No Buff 0 RX Undersize 0
RX Fragment 0 RX Oversize 0
RX Octets High 0 RX Octets Low 0
TX Octets High 0 TX Octets Low 0
TX Packet 0 RX Packet 348
TX Broadcast 0 TX Multicast 0
Packet TX (64) 0 Packet TX (127) 0
Packet TX (255) 0 Packet TX (511) 0
Packet TX (1023) 0 Packet TX (1522) 0
TX Underruns 0 TX No CRS 0
RX Error Count 0 RX DMA Underruns 0
RX Carrier Ext 0
TCP Segmentation 0 TCP Seg Failed 0
The table below describes significant fields shown in the display.
Cisco IOS Interface and Hardware Component Command Reference
1810
show interfaces vlan mapping through show scp
show pas i82543 interface
Table 181: show pas i82543 interface statistics Field Descriptions
Field Description
CRC error Cyclic redundancy checksum (CRC) generated by the originating LAN station or
far-end device does not match the checksum calculated from the data received. On a
LAN, this usually indicates noise or transmission problems on the LAN interface or
the LAN bus itself. A high number of CRCs is usually the result of collisions or a
station transmitting bad data.
Symbol error Number of symbol errors between reads.
Missed Packets Indicates whether the software processes that handle the line protocol believe that the
interface is usable (that is, whether keepalives are successful) or if it has been taken
down by an administrator.
Single Collision Number of times that a transmit operation encountered a single collision.
Excessive Coll This counter is incremented after a transmit operation has encountered more than 16
collisions.
Multiple Coll Number of times that a transmit operation encountered more than 1 collision, but less
than 16 collisions.
Late Coll Number of late collisions. A late collision happens when a collision occurs after
transmitting the preamble. The most common cause of late collisions is Ethernet cable
segments that are too long for the speed at which you are transmitting.
Collision Number of messages transmitted because of an Ethernet collision. A packet that
collides is counted only once in output packets.
Defer Defer indicates that the chip had to defer while ready to transmit a frame because the
carrier was asserted.
Receive Length Number of receive length error events. A receive length error occurs if an incoming
packet passes the filter criteria but is either oversized or undersized. Packets less than
64 bytes are undersized. Packets over 1522 bytes are oversized if LongPacketEnable
(LPE) is 0. If LPE is 1, a packet is considered oversized if it exceeds 16,384 bytes.
Sequence Error Number of sequence error events.
XON RX Number of XON packets received.
XON TX Number of XON packets transmitted.
XOFF RX Number of XOFF packets received.
XOFF TX Number of XOFF packets transmitted.
FC RX Unsupport Number of unsupported flow control frames received.
Packet RX Number of received packets of the following lengths in bytes: 64, 127, 255, 511, 1023,
1522.
Good Packet RX Number of received packets without errors.
Cisco IOS Interface and Hardware Component Command Reference
1811
show interfaces vlan mapping through show scp
show pas i82543 interface
Field Description
Broadcast RX Number of broadcast packets received.
Multicast RX Number of multicast packets received.
Good Packet TX Number of transmitted packets without errors.
Good Octets Number of good (without errors) octets received (RX) or transmitted (TX).
RX No Buff Number of times that frames were received when there were no available buffers in
host memory to store those frames. The packet will be received if there is space in
FIFO memory.
RX Undersize Number of received frames that passed through address filtering and were less than
the minimum size of 64 bytes (from destination address through CRC, inclusively),
but that contained a valid CRC.
RX Fragment Number of received frames that passed through address filtering and were less than
the minimum size of 64 bytes (from destination address through CRC, inclusively),
but that contained a bad CRC.
RX Oversize Number of received frames that passed through address filtering and were greater
than the maximum size.
RX Octets Total number of octets received.
TX Octets Total number of octets transmitted.
TX Packet Number of transmitted packets.
RX Packet Number of received packets.
TX Broadcast Number of broadcast packets transmitted.
TX Multicast Number of multicast packets transmitted.
Packet TX Number of transmitted packets of the following lengths in bytes: 64, 127, 255, 511,
1023, 1522.
TX Underruns Number of times that the transmitter has been running faster than the router can handle.
This may never be reported on some interfaces.
TX No CRS Number of successful packet transmissions in which Carrier Sense (CRS) input from
the physical layer was not asserted within one slot time of start of transmission.
RX Error Count Number of receive packets in which RX_ER was asserted by the physical layer.
RX DMA Underruns Number of receive direct memory access (DMA) underruns observed by the DMA.
RX Carrier Ext Number of packets received in which the carrier extension error was signalled across
the gigabit medium independent interface (GMII) interface.
TCP Segmentation Number of TCP segmentation offload transmissions to the hardware.
Cisco IOS Interface and Hardware Component Command Reference
1812
show interfaces vlan mapping through show scp
show pas i82543 interface
Field Description
TCP Seg Failed Number of TCP segmentation offload transmissions to the hardware that failed to
transmit all data in the TCP segmentation context payloads.
Related Commands Commands Description
show compress Displays compression statistics.
show controllers fastethernet Displays information about Fast Ethernet controllers.
show controllers gigabitethernet Displays information about Gigabit Ethernet controllers.
show interfaces Displays information about interfaces.
Cisco IOS Interface and Hardware Component Command Reference
1813
show interfaces vlan mapping through show scp
show pas isa controller
show pas isa controller
To show controller information that is specific to the Virtual Private Network (VPN) accelerator controller
when an Integrated Services Adapter (ISA) is installed, use the showpasisacontrollerEXEC command.
show pas isa controller
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC
Command History Release Modification
12.1(5)T This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples The following is sample output from the showpasisacontroller command:
Router# show pas isa controller
Interface ISA5/1 :
Encryption Mode = IPSec
Addresses of Rings and instance structure:
High Priority Rings
TX: 0x4B0E97C0 TX Shadow:0x62060E00
RX: 0x4B0EB840 RX Pool:0x4B0EBC80 RX Pool Shadow:0x62068E58
Low Priority Rings
TX: 0x4B0EA800 TX Shadow:0x62066E2C
RX: 0x4B0EC0C0, RX Shadow:0x62069284
Instance Structure address:0x620603D8
Firmware write head/tail offset:0x4B0EC900
Firmware read head/tail offset:0x3EA00000
Related Commands Command Description
show pas isa interface Displays interface status information that is specific to the VPN accelerator card.
Cisco IOS Interface and Hardware Component Command Reference
1814
show interfaces vlan mapping through show scp
show pas isa interface
show pas isa interface
To display interface information that is specific to the Virtual Private Network (VPN) accelerator card when
an Integrated Services Adapter (ISA) is installed, use the showpasisainterfacecommand in privileged EXEC
mode.
show pas isa interface
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC
Command History Release Modification
12.1(5)T This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Examples The following is sample output from the showpasisainterface command:
Router# show pas isa interface
Interface ISA5/1 :
Statistics of packets and bytes through this interface:
2876894 packets in 2910021 packets out
420 paks/sec in 415 paks/sec out
2327 Kbits/sec in 2408 Kbits/sec out
632 commands out 632 commands acknowledged
low_pri_pkts_sent 1911 low_pri_pkts_rcvd: 1911
invalid_sa: 260 invalid_flow: 33127
invalid_dh: 0 ah_seq_failure: 0
ah_spi_failure: 0 esp_auth_failure: 0
esp_seq_failure: 0 esp_spi_failure: 0
esp_protocol_absent: 0 ah_protocol_absent: 0
bad_key_group: 0 no_shared_secret: 0
no_skeyids: 0 pad_size_error: 0
cmd_ring_full: 0 bulk_ring_full: 990
bad_peer_pub_len: 0 authentication_failure: 0
fallback: 1606642 no_particle: 0
6922 seconds since last clear of counters
The table below describes the significant fields shown in the display.
Table 182: show pas isa interface Field Descriptions
Field Description
packets in/out Number of data packets received from, or sent to, the Integrated Service Adapter
(ISA).
Cisco IOS Interface and Hardware Component Command Reference
1815
show interfaces vlan mapping through show scp
show pas isa interface
Field Description
paks/sec in/out Number of packets received in, or sent out, with the total number of seconds that
the ISA is active.
Kbits/sec in/out Number of kilobits (Kbits) received in, or sent out, with the total number of
seconds that the ISA is active.
commands out Number of commands going to the ISA. Examples of commands include setting
up encryption sessions and retrieving statistics or status from the ISA.
commands acknowledged Number of commands returning from the ISA. Examples of commands include
setting up encryption sessions and retrieving statistics or status from the ISA.
low_pri_pkts_sent This is a summary counter for number of Internet Key Exchange (IKE) and IPSec
commands submitted to ISA.
low_pri_pkts_rcvd This is a summary counter for number of IKE & IPSEC command responses
received from ISA.
invalid_sa Reference to an unusable security association key pair.
invalid_flow An invalid packet using an IPSec key is received for encryption or decryption.
Example: session has expired.
invalid_dh Reference to an unusable Diffie-Hellman( DH) key pair.
ah_seq_failure Unacceptably late Authentication Header (AH) header received.
ah_spi_failure SPI specified in the AH header does not match the SPI associated with the IPSec
AH key.
esp_auth_failure Number of ESP packets received with authentication failures.
esp_seq_failure Unacceptably late ESP packet received.
esp_spi_failure SPI specified in the ESP header does not match the SPI associated with the IPSec
ESP key.
esp_protocol_absent Packet is missing expected ESP header.
ah_protocol_absent Packet is missing expected AH header.
bad_key_group Unsupported key group requested during a Diffie-Hellman generation.
no_shared_secret Attempting to use a Diffie-Hellman shared secret that is not generated.
no_skeyids Attempting to use a shared secret that is not generated.
pad_size_error The length of the ESP padding is greater than the length of the entire packet.
cmd_ring_full New IKE setup messages are not queued for processing until the previous queued
requests are processed.
Cisco IOS Interface and Hardware Component Command Reference
1816
show interfaces vlan mapping through show scp
show pas isa interface
Field Description
bulk_ring_full New packets requiring IPSec functionality are not queued to the ISA until the
ISA completes the processing of existing requests.
bad_peer_pub_len Length of peer's DH public key does not match the length specified for the
negotiated DH key group.
authentication_failure Authentication failed.
fallback The number of instances when the driver is successful in getting a replacement
buffer from the global pool.
no_particle The number of instances when the driver was unable to get a replacement buffer
from the driver pool and the global (fallback) pool.
Related Commands Command Description
show pas isa controller Displays controller status information that is specific to the VPN accelerator card.
Cisco IOS Interface and Hardware Component Command Reference
1817
show interfaces vlan mapping through show scp
show pas vam controller
show pas vam controller
To display controller information that is specific to the VPN Acceleration Module (VAM), use the
showpasvamcontroller command in privileged EXEC mode.
show pas vam controller
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC
Command History Release Modification
12.1(9)E This command was introduced.
12.2(9)YE This command was integrated into Cisco IOS Release 12.2(9)YE.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.
Examples The following is sample output from theshowpasvamcontrollercommand:
Router# show pas vam controller
Encryption Mode = IPSec
Addresses of Rings and instance structure:
Low Priority Queue:
OMQ=0xF2CB2E0, OMQ Shadow = 0x630E6638, {1, 1, 0, 256}
PKQ=0xF2CF320, PKQ Shadow = 0x630EBE64, {232, 232, 0, 256}
ERQ=0xF2D3360, ERQ Shadow = 0x630F1690, {0, 0, 0, 256}
High Priority Rings:
TX: 0x0F2D73A0 TX Shadow:0x630F6EBC, {6, 6, queued=0}
RX: 0x7F2D93E0 {13, 0, 256}
RX Pool:0x7F2DA420 RX Pool Shadow:0x630FCAE8, {6, 0, 255}
Instance Structure address:0x630E5898
Misc registers:
mini-omq=0xF2DB460, shdw=0x63102714
Group0=0x3D800000, Group1=0x3D801000
IndexReg = 0xDFFE700
Heartbeat info:<Addr, Value> = <0xF2DB520, 0x2A55A>
Running default HSP (addr=0x629D36AC, size=294268)
Related Commands Command Description
show pas vam interface Displays interface status information specific to the VPN accelerator module.
Cisco IOS Interface and Hardware Component Command Reference
1818
show interfaces vlan mapping through show scp
show pas vam interface
show pas vam interface
To display interface information that is specific to the VPN Acceleration Module (VAM), use the
showpasvaminterface command in privileged EXEC mode.
show pas vam interface
Syntax Description This command has no arguments or keywords.
Command Modes Privileged EXEC
Command History Release Modification
12.1(9)E This command was introduced.
12.2(9)YE This command was integrated into Cisco IOS Release 12.2(9)YE.
12.2(13)T This command was integrated into Cisco IOS Release 12.2(13)T.
Usage Guidelines Enter theshowpasvaminterface command to see if the VAM is currently processing crypto packets.
Examples The following is sample output from the showpasvaminterface command:
Router# show pas vam interface
Interface VAM 2/1 :
ds: 0x621CE0D8 idb:0x621C28DC
Statistics of packets and bytes that through this interface:
1110 packets in 1110 packets out
123387 bytes in 100979 bytes out
0 paks/sec in 0 paks/sec out
0 Kbits/sec in 0 Kbits/sec out
3507 commands out 3507 commands acknowledged
ppq_full_err : 0 ppq_rx_err : 0
cmdq_full_err : 0 cmdq_rx_err : 0
no_buffer : 0 fallback : 0
dst_overflow : 0 nr_overflow : 0
sess_expired : 0 pkt_fragmented : 0
out_of_mem : 0 access_denied : 0
invalid_fc : 0 invalid_param : 0
invalid_handle : 0 output_overrun : 0
input_underrun : 0 input_overrun : 0
key_invalid : 0 packet_invalid : 0
decrypt_failed : 0 verify_failed : 0
attr_invalid : 0 attr_val_invalid : 0
attr_missing : 0 obj_not_wrap : 0
bad_imp_hash : 0 cant_fragment : 0
out_of_handles : 0 compr_cancelled : 0
rng_st_fail : 0 other_errors : 0
3420 seconds since last clear of counters
The table below describes the significant fields shown in the display.
Cisco IOS Interface and Hardware Component Command Reference
1819
show interfaces vlan mapping through show scp
show pas vam interface
Table 183: show pas vam interface Field Descriptions
Field Description
packets in/out Number of data packets received from, or sent to, the VAM.
bytes in/out Number of data bytes received from, or sent to, the VAM.
paks/sec in/out Number of packets received in, or sent out, with the total number of seconds that
the VAM is active.
Kbits/sec in/out Number of kilobits (Kbits) received in, or sent out, with the total number of
seconds that the VAM is active.
commands out Number of commands going to the VAM. Examples of commands include setting
up encryption sessions and retrieving statistics or status from the VAM.
commands acknowledged Number of commands returning from the VAM. Examples of commands include
setting up encryption sessions and retrieving statistics or status from the VAM.
ppq_full_err Number of packets dropped because of a lack of space in the packet processing
queues for the VAM. This usually means that input traffic has reached VAM
maximum throughput possible.
ppq_rx_err Summary counter for all errors related to packet processing.
cmdq_full_err Number of commands dropped because of a lack of space in the command
processing queues for the VAM. This error indicates that the input tunnel setup
rate has reached the VAM maximum setup rate. The Internet Key Exchange (IKE)
process retries the tunnel creation and deletion when commands are dropped by
VAM.
cmdq_rx_err Summary counter for all errors related to command processing (for example, IKE,
or IPSec session creation or deletion).
no_buffer Errors related to the VAM running out of buffers. May occur with large packets.
Although VAM buffers cannot be tuned, try tuning buffers for other interfaces.
fallback Internal VAM buffer pool is completely used up and VAM has to fallback to
global buffer pool. This may cause minor performance impact, however, packets
are still processed so this error can be ignored.
dst_overflow Counter that is incremented when the VAM has completed an operation, but there
is no available space into which to place the result.
nr_overflow Counter that is incremented when the VAM has completed an operation, but there
is no available space into which to place the result.
sess_expired Counter that is incremented if the session used to encrypt or decrypt the packet
has expired because of time or space limit.
pkt_fragmented Counter that is incremented when the input packet has to be fragmented after
encryption. This counter should always be 0 as fragmentation by VAM is disabled.
out_of_mem Counter that is incremented when the VAM runs out of memory.
Cisco IOS Interface and Hardware Component Command Reference
1820
show interfaces vlan mapping through show scp
show pas vam interface
Field Description
access_denied Counter that is incremented when the VAM is requested to perform an operation
on an object that can not be modified.
invalid_fc Counter that is incremented when the VAM has received a request that is illegal
for the specified object type.
invalid_param Counter that is incremented when the VAM has received invalid parameters within
a command.
invalid_handle Counter that is incremented when the VAM receives a request for an operation
to be performed on an object that does not exist.
output_overrun Counter that is incremented when the space allocated for a response is not large
enough to hold the result posted by the VAM.
input_underrun Counter that is incremented when the VAM receives a packet for which it finds
a premature end to the data, for example, a truncated packet.
input_overrun Counter that is incremented when the VAM receives a buffer that is too large for
the requested operation.
key_invalid Counter that is incremented when the VAM receives a request for an operation
on a key where the key is invalid or of the wrong type.
packet_invalid Counter that is incremented when the VAM receives a packet whose body is badly
formed.
decrypt_failed Counter that is incremented when the VAM receives a packet that cannot be
decrypted because the decrypted data was not properly formatted (for example,
padding is wrong).
verify_failed Counter that is incremented when the VAM receives a packet which could not
be verified because the verification of a signature or authentication value failed.
attr_invalid Counter that is incremented when the VAM receives a packet which specifies an
attribute that is not correct for the specified object or operation.
attr_val_invalid Counter that is incremented when the VAM encounters errors during packet or
command processing. The packets or commands are dropped in such cases.
attr_missing Counter that is incremented when the VAM receives an operation request for
which the value of a required attribute is missing.
obj_not_wrap Counter that is incremented when the VAM receives an operation request to
retrieve an object that is hidden or unavailable for export beyond the FIPS
boundary of the VPN Module.
bad_imp_hash Counter that is incremented when the VAM sees a hash miscompare on unwrap.
cant_fragment Counter that is incremented when the VAM determines a need to fragment a
packet, but cannot fragment because the “don’t fragment” bit is set. This counter
should always be zero because the fragmentation on the VAM is disabled.
Cisco IOS Interface and Hardware Component Command Reference
1821
show interfaces vlan mapping through show scp
show pas vam interface
Field Description
out_of_handles Counter that is incremented when the VAM has run out of available space for
objects of the requested type.
comp_cancelled Due to the operation of the compression algorithm, some data patterns cannot be
compressed. Usually data that has already been compressed or data that does not
have a sufficient number of repetitive patterns cannot be compressed and a
compress operation would actually result in expansion of the data.
There are certain known data patterns which do not compress. In these cases, the
compression engine cancels the compression of the data and returns the original,
uncompressed data without an IPPCP header.
These counters are useful to determine if the content of the traffic on the network
is actually benefiting from compression. If a large percentage of the network
traffic is already compressed files, these counters may indicate that compression
on these streams are not improving the performance of the network.
rng_st_fail Counter that is incremented when the VAM detects a Random Number Generator
self test failure.
pkt_replay_err Counter that is incremented when a replay error is detected by the VAM.
other_errors Counter that is incremented when the VAM encounters a packet or command
error that is not listed in other error categories. An example could be if the packet
IP header checksum is incorrect.
Related Commands Command Description
show pas vam controller Displays controller status information that is specific to the VPN accelerator
module.
Cisco IOS Interface and Hardware Component Command Reference
1822
show interfaces vlan mapping through show scp
show pas y88e8k interface
show pas y88e8k interface
To display the y88e8k Port Adaptor Information (pas) message details of a Gigabit Ethernet interface, use
the showpasy88e8kinterface command in User EXEC or privileged EXEC mode.
show pas y88e8k interface type number {registers|rx_ring|statistics|tx_ring}
Syntax Description type (Optional) Displays the interface type.
number (Optional) Displays the interface number.
registers Displays register values.
rx -ring Displays the receive ring entries of the interface.
statistics Displays the y88e8k chip statistics values.
tx -ring Displays the transmit ring entries of the interface.
Command Modes User EXEC (>) Privileged EXEC (#)
Command History Release Modification
12.4(22)T This command was introduced in a release earlier than Cisco IOS Release 12.4(22)T.
Examples The following is sample output from the showpasy88e8kinterface command:
Router# show pas y88e8k interface gigabit ethernet 1/0 rx-ring
Rx Ring:
--------
ring size = 128, particle size = 2048
ring head = 0, tail = 127
Ring entries:
rxr next_desc_addr buf_ctrl buf_addr_lo frame_sw rxr_shadow data_start
data_bytes
0 0x642AE918 0x2DD9F020 0xC8550800 0x0DDA3180 0x00000000 0x64525440 0x2DDA3180 0
1 0x642AE938 0x2DD9F040 0xC8550800 0x0DDA3A00 0x00000000 0x64525480 0x2DDA3A00 0
2 0x642AE958 0x2DD9F060 0xC8550800 0x0DDA4280 0x00000000 0x645254C0 0x2DDA4280 0
3 0x642AE978 0x2DD9F080 0xC8550800 0x0DDA4B00 0x00000000 0x64525500 0x2DDA4B00 0
4 0x642AE998 0x2DD9F0A0 0xC8550800 0x0DDA5380 0x00000000 0x64525540 0x2DDA5380 0
5 0x642AE9B8 0x2DD9F0C0 0xC8550800 0x0DDA5C00 0x00000000 0x64525580 0x2DDA5C00 0
6 0x642AE9D8 0x2DD9F0E0 0xC8550800 0x0DDA6480 0x00000000 0x645255C0 0x2DDA6480 0
7 0x642AE9F8 0x2DD9F100 0xC8550800 0x0DDA6D00 0x00000000 0x64525600 0x2DDA6D00 0
8 0x642AEA18 0x2DD9F120 0xC8550800 0x0DDA7580 0x00000000 0x64525640 0x2DDA7580 0
9 0x642AEA38 0x2DD9F140 0xC8550800 0x0DDA7E00 0x00000000 0x64525680 0x2DDA7E00 0
10 0x642AEA58 0x2DD9F160 0xC8550800 0x0DDA8680 0x00000000 0x645256C0 0x2DDA8680 0
11 0x642AEA78 0x2DD9F180 0xC8550800 0x0DDA8F00 0x00000000 0x64525700 0x2DDA8F00 0
12 0x642AEA98 0x2DD9F1A0 0xC8550800 0x0DDA9780 0x00000000 0x64525740 0x2DDA9780 0
13 0x642AEAB8 0x2DD9F1C0 0xC8550800 0x0DDAA000 0x00000000 0x64525780 0x2DDAA000 0
.
.
.
127 0x642AF8F8 0x2DD9F000 0xC8550800 0x0DDE6900 0x00000000 0x64527400 0x2DDE6900
0
Cisco IOS Interface and Hardware Component Command Reference
1823
show interfaces vlan mapping through show scp
show pas y88e8k interface
Table 1 describes the significant fields shown in the display.
Table 184: show pas y88e8k interface Field Descriptions
Field Description
ring size Displays the size of the ring. This is based on the bandwidth of the interface or virtual circuit
(VC) and is a power of two.
particle size Displays the particle size on the receive and transmit paths, in bytes.
ring head Displays the head of the ring.
tail Displays the tail of the ring.
rxr Displays the Rx ring pointer.
next_desc_addr Displays next Rx buffer descriptor address.
buf_ctrl Displays the buffer control.
buf_addr_lo Displays the buffer address.
frame_sw Displays the Frame status word.
rxr_shadow Displays the Rx ring shadow.
data_start Displays the start of data in the particle.
data_bytes Displays the number of bytes consumed for data storage.
Related Commands Command Description
tx-ring-limit Limits the number of packets that can be used on a transmission ring on the DSL WIC or
interface.
Cisco IOS Interface and Hardware Component Command Reference
1824
show interfaces vlan mapping through show scp
show pci aim
show pci aim
To show the IDPROM contents for each compression Advanced Interface Module (AIM) daughter card in
the Cisco 2600 router, use the showpciaimcommand in user EXEC or privileged EXEC mode.
show pci aim
Syntax Description This command has no arguments or keywords.
Command Modes User EXEC Privileged EXEC
Command History Release Modification
12.0(1)T This command was introduced.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2SX This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific
12.2SX release of this train depends on your feature set, platform, and platform hardware.
Usage Guidelines This command shows the IDPROM contents for each compression AIM daughtercard present in the system,
by AIM slot number (currently 0, since that is the only daughtercard installed for Cisco IOS Release 12.0(1)T).
The IDPROM is a small PROM built into the AIM board used to identify it to the system. It is sometimes
referred to as an EEPROM because it is implemented using electronically erasable PROM.
Examples The following example shows the IDPROM output for the installed compression AIM daughter card:
Router# show pci aim
AIM Slot 0: ID 0x012D
Hardware Revision : 1.0
EEPROM format version 4
EEPROM contents (hex):
0x00: 04 FF 40 01 2D 41 01 00 FF FF FF FF FF FF FF FF
0x10: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x20: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x30: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x40: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x50: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
0x70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF
Related Commands Command Description
clear aim Clears data compression AIM registers and resets the hardware.
test aim eeprom Tests the data compression AIM after it is installed in a Cisco 2600 series router.
Cisco IOS Interface and Hardware Component Command Reference
1825
show interfaces vlan mapping through show scp
show platform
show platform
To display platform information, use the show platform command in privileged EXEC mode.
show platform {buffers|copp rate-limit
{arp|dhcp|atm-oam|ethernet-oam|icmp|igmp|pppoe-discovery|atom ether-vc|all}|np copp [ifnum]
[detail]|dma|eeprom|fault|hardware capacity|hardware pfc
mode|internal-vlan|interrupts|netint|software ipv6-multicast connected|stats|tech-support {ipmulticast
[vrf vrf-name] group-ip-addr src-ip-addr|unicast [vrf vrf-name] destination-ip-addr destination-mask
[global]}|tlb|vfi dot1q-transparency|vlans}
Cisco 4400 Series Integrated Services Routers
show platform
Cisco ASR 1000 Series Aggregation Services Routers
show platform
Syntax Description buffers Displays buffer-allocation information.
copp rate-limit Displays Cisco Control Plane Policing (CoPP) rate-limit information on
the Cisco 7600 SIP-400.
arp Specifies Address Resolution Protocol (ARP) packet traffic.
dhcp Specifies Dynamic Host Configuration Protocol (DHCP) packet traffic.
atm-oam Specifies ATM Operation, Administration, and Maintenance (OAM)
packet traffic.
ethernet-oam Specifies Ethernet OAM packet traffic.
icmp Specifies Internet Connection Management Protoocol Rate limiter.
igmp Specifies Internet Group Management Potocol Rate limiter.
pppoe-discovery Specifies Point-to-Point Protocol over Ethernet (PPPoE) discovery packet
information.
atom ether-vc Shows whether IP or routed mode interworking is configured.
all Displays rate-limit information for all protocols.
np copp Displays debug information for a given CoPP session ID or for all CoPP
sessions.
ifnum (Optional) A session ID.
detail (Optional) Shows full rate-limited values.
dma Displays Direct Memory Access (DMA) channel information.
eeprom Displays CPU EEPROM information.
Cisco IOS Interface and Hardware Component Command Reference
1826
show interfaces vlan mapping through show scp
show platform
fault Displays the fault date.
hardware capacity Displays the capacities and utilizations for hardware resources; see the
show platform hardware capacity command.
hardware pfc mode Displays the type of installed Policy Feature Card (PFC).
internal-vlan Displays the internal VLAN.
interrupts Displays m8500 interrupt counters.
netint Displays the platform network-interrupt information.
software ipv6-multicast connected Displays all the IPv6 subnet Access Control List (ACL) entries on the
Route Processor (RP); see the show platform software ipv6-multicast
command.
stats Displays Constellation WAN (CWAN) statistics.
tech-support ipmulticast Displays IP multicast-related information for Technical Assistance Center
(TAC).
vrf vrf-name (Optional) Displays the Virtual Private Network (VPN) routing and
forwarding (VRF) instance.
group-ip-addr Group IP address.
src-ip-addr Source IP address.
unicast Displays IP unicast-related information for TAC.
destination-ip-addr Destination IP address.
destination-mask Destination mask.
global (Optional) Displays global output.
tlb Displays information about the translation look-aside buffer (TLB)
register.
vfi Displays CWAN virtual forwarding instance (VFI) commands.
dot1q-transparency Displays the dot1q transparency setting.
vlans Displays hidden VLAN-to-WAN interface mapping.
Command Modes Privileged EXEC (#)
Command History Release Modification
12.2(14)SX Support for this command was introduced on the Supervisor Engine 720.
Cisco IOS Interface and Hardware Component Command Reference
1827
show interfaces vlan mapping through show scp
show platform
Release Modification
12.2(17d)SXB Support for this command on the Supervisor Engine 2 was extended to Cisco
IOS Release 12.2(17d)SXB. This command was changed to include the
hardware pfc modekeywords.
12.2(18)SXD This command was modified to include the software ipv6-multicast
connectedkeywords.
12.2(33)SRA This command was integrated into Cisco IOS Release 12.2(33)SRA.
12.2(33)SRC This command was modified to include additional keywords to support CoPP
enhancements on the Cisco 7600 SIP-400 on the Cisco 7600 series router.
Cisco IOS XE Release 2.1 This command was integrated into Cisco IOS XE Release 2.1.
12.2(33)SRD This command was modified. The atom ether-vc keyword was added.
Cisco IOS XE Release This command was integrated into Cisco IOS XE Release 3.9S.
3.9S
Usage Guidelines This command is similar to the show msfc command.
This command can be used to verify the existence of a second Cisco IOS process on a single Cisco ASR 1000
RP on a Cisco ASR 1002 router or Cisco ASR 1004 router.
When this command is used with the atom ether-vc keyword, it is used on the line-card console.
Examples The following sample output from the show platform buffers command displays buffer-allocation
information:
Router# show platform
buffers
Reg. set Min Max
TX 640
ABQ 640 16384
0 0 40
1 6715 8192
2 0 0
3 0 0
4 0 0
5 0 0
6 0 0
7 0 0
Threshold = 8192
Vlan Sel Min Max Cnt Rsvd
1019 1 6715 8192 0 0
Router#
Cisco ISR 4400 Series Routers
The following example displays online status information for the Cisco ISR 4400 Front Panel Gigabit
Ethernet port (ISR4451-4X1GE), Cisco SSD Carrier Card Network Interface Module (NIM-SSD),
Cisco IOS Interface and Hardware Component Command Reference
1828
show interfaces vlan mapping through show scp
show platform
Cisco SM-1T3/E3 Service Module (SM-1T3/E3), and Cisco 4th Generation T1/E1 Voice and WAN
Network Interface Module (NIM 8MFT-T1/E1)
Router# show platform
Chassis type: ISR4452/K9
Slot Type
You might also like
- Best Practices For Catalyst 6500/6000 Series and Catalyst 4500/4000 Series Switches Running Cisco IOS SoftwareNo ratings yetBest Practices For Catalyst 6500/6000 Series and Catalyst 4500/4000 Series Switches Running Cisco IOS Software100 pages
- BRKCRS-3146 - Advanced VPC Operation and Troubleshooting100% (1)BRKCRS-3146 - Advanced VPC Operation and Troubleshooting71 pages
- Supercharged Point-to-Multipoint (PTMP) : Wi-Fi 6E-Based, 8x8, Beamforming, A6 Access Point100% (1)Supercharged Point-to-Multipoint (PTMP) : Wi-Fi 6E-Based, 8x8, Beamforming, A6 Access Point2 pages
- JUNOS-to-Cisco IOS-XR Command Reference PDFNo ratings yetJUNOS-to-Cisco IOS-XR Command Reference PDF4 pages
- UBR Process - Vendor Team - Rev 3 - 7 Aug 2012No ratings yetUBR Process - Vendor Team - Rev 3 - 7 Aug 201228 pages
- Troubleshooting Case Study: RADULKO Transport: CCNP TSHOOT: Maintaining and Troubleshooting IP NetworksNo ratings yetTroubleshooting Case Study: RADULKO Transport: CCNP TSHOOT: Maintaining and Troubleshooting IP Networks30 pages
- IPCisco Cisco Juniper Alcatel Nokia Huawei CheatSheet PDFNo ratings yetIPCisco Cisco Juniper Alcatel Nokia Huawei CheatSheet PDF9 pages
- Atndcsg-6675 - Tdm-Mulchen-Centro-Bi788-Master Vlan-PsNo ratings yetAtndcsg-6675 - Tdm-Mulchen-Centro-Bi788-Master Vlan-Ps63 pages
- Cisco IOS Command Line Interface TutorialNo ratings yetCisco IOS Command Line Interface Tutorial12 pages
- Basic Cisco Router - Switch Configuration StepsNo ratings yetBasic Cisco Router - Switch Configuration Steps6 pages
- Troubleshooting Mpls Networks: Session Rst-3605No ratings yetTroubleshooting Mpls Networks: Session Rst-360546 pages
- L2VPN Services Over Segment Routing For Traffic Engineering PolicyNo ratings yetL2VPN Services Over Segment Routing For Traffic Engineering Policy50 pages
- Cisco IOS XR Advanced System Command Reference For The Cisco CRS Router, Release 4.2.xNo ratings yetCisco IOS XR Advanced System Command Reference For The Cisco CRS Router, Release 4.2.x604 pages
- Cisco Catalyst QoS Simplified PresentationNo ratings yetCisco Catalyst QoS Simplified Presentation58 pages
- Csa Xe 3 13s Asr 920 Book1g 10G Ports PDFNo ratings yetCsa Xe 3 13s Asr 920 Book1g 10G Ports PDF16 pages
- BRKSPG 2904 ASR 9000IOS XR Hardware Architecture QOS EVC IOS XR Configuration and Troubleshooting 2014 Milan 2 HoursNo ratings yetBRKSPG 2904 ASR 9000IOS XR Hardware Architecture QOS EVC IOS XR Configuration and Troubleshooting 2014 Milan 2 Hours165 pages
- Enable Password Breaking: Restart The Router and Press CTRL+Break Immediately To Get The Router in Monitor ModeNo ratings yetEnable Password Breaking: Restart The Router and Press CTRL+Break Immediately To Get The Router in Monitor Mode10 pages
- STP Notes Part 1 Cheat Sheet Network WalksNo ratings yetSTP Notes Part 1 Cheat Sheet Network Walks1 page
- Cisco IOS Interface and Hardware Component Command Reference PDFNo ratings yetCisco IOS Interface and Hardware Component Command Reference PDF2,744 pages
- Book-Level PDF Cisco IOS Interface Command Reference, Release 12.2 TNo ratings yetBook-Level PDF Cisco IOS Interface Command Reference, Release 12.2 T636 pages
- Office 365: A Guide For Tech and Business LeadersNo ratings yetOffice 365: A Guide For Tech and Business Leaders10 pages
- Joint Design of Radio and Transport For PDFNo ratings yetJoint Design of Radio and Transport For PDF11 pages
- Google Chrome Developer Tools - The Chromium ProjectsNo ratings yetGoogle Chrome Developer Tools - The Chromium Projects2 pages
- Download Modern Operating Systems 5th Edition Andrew S. Tanenbaum ebook All Chapters PDF100% (2)Download Modern Operating Systems 5th Edition Andrew S. Tanenbaum ebook All Chapters PDF51 pages
- CP-101 Computing Fundamentals: Romana FarhanNo ratings yetCP-101 Computing Fundamentals: Romana Farhan65 pages
- Overview of Computer Software and Programming LanguageNo ratings yetOverview of Computer Software and Programming Language44 pages
- Downloaded From:: Computer Science (New)No ratings yetDownloaded From:: Computer Science (New)4 pages
- Deltav Virtualization: Deltav Distributed Control System WhitepaperNo ratings yetDeltav Virtualization: Deltav Distributed Control System Whitepaper18 pages
