Table Of Contents
Cable Commands: show ch through show cr
show checkpoint
show controllers cable
show controllers cable upstream spectrum
show controllers cable-modem
show controllers cable-modem bpkm
show controllers cable-modem classifiers
show controllers cable-modem cmcert
show controllers cable-modem crypto des
show controllers cable-modem filters
show controllers cable-modem lookup-table
show controllers cable-modem mac
show controllers cable-modem manuf-cert
show controllers cable-modem phs
show controllers cable-modem phy
show controllers cable-modem qos
show controllers cable-modem service-flows
show controllers cable-modem tuner
show controllers clock-reference
show controllers jacket
show controllers modular-cable
show controllers usb
show cops servers
show cpd
show cr10k-rp cable
show cr10k-rp controller
show cr10k-rp queue
show cr10k-rp slots
show crypto ca certificates
show crypto ca trustpoints
show crypto engine accelerator ring
show crypto engine accelerator sa-database
show crypto engine accelerator statistic
show crypto engine brief
show crypto engine configuration
show crypto engine connections
show crypto ipsec client ezvpn
Cable Commands: show ch through show cr
Revised: March 30, 2009, OL-15510-09
New Commands
Command
|
Cisco IOS Software Release
|
show cr10k-rp cable
|
12.2(33)SCA
|
show cr10k-rp controller
|
12.2(33)SCA
|
show cr10k-rp queue
|
12.2(33)SCA
|
show cr10k-rp slots
|
12.2(33)SCA
|
Modified Commands
Command
|
Cisco IOS Software Release
|
show controllers cable
|
12.3(23)BC
|
show controllers modular-cable
|
12.3(23)BC5
|
show controllers jacket
|
12.2(33)SCB
|
show cr10k-rp controller
|
12.2(33)SCB
|
show cr10k-rp queue
|
12.2(33)SCB
|
show controllers modular-cable
|
12.3(23)BC6
|
Obsolete Commands
Command
|
Effective Cisco IOS Release
|
show controllers cable upstream spectrum
|
12.3(21)BC
|
show cr10k-rp
|
12.2(33)SCB
|
show cr10k-rp service-flow ds
|
12.2(33)SCB
|
show checkpoint
To display information about the Checkpoint Facility (CF) subsystem on a Cisco CMTS, use the show checkpoint command in privileged EXEC mode.
show checkpoint {clients | statistics}
Syntax Description
clients
|
Displays a list of current checkpoint clients.
|
statistics
|
Displays the current status for checkpoint operations.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(11)BC3
|
This command was introduced to support High Availability (HA) redundancy operations.
|
Usage Guidelines
The Checkpoint Facility (CF) subsystem manages the passing of messages from the Active to Standby interfaces. It also handles sequencing and throttling, as needed during redundancy operations. Checkpoint clients, such as line cards and other subsystems, register with the CF subsystem so that they can update the Protect card or standby processor with state changes as necessary.
The show checkpoint command displays information about the clients (other processes on the CMTS that are sending checkpoint messages) and run-time status for checkpoint operations.
Examples
The following shows typical output for the show checkpoint clients command:
Router# show checkpoint clients
Check Point List of Clients
Client Name Client ID Msg Send Msg len Bundling
-----------------------------------------------------------
The following shows typical output for the show checkpoint statistics command:
Router# show checkpoint statistics
Number of chkpt messages currently in hold queue 0
CHKPT MAX MTU size = 1422
CHKPT Pending msg timer = 100 ms
Related Commands
Command
|
Description
|
hccp authentication
|
Changes the minimum time between frequency hops.
|
hccp check version
|
Exits bypass version mode, and returns to normal HCCP operation.
|
hccp ds-switch
|
Specifies the downstream upconverter module for a Working CMTS or Protect CMTS (deprecated command).
|
hccp protect
|
Allows you to configure a Cisco CMTS to be a Protect CMTS for a specified Working CMTS in a 1+1 redundancy environment.
|
hccp working
|
Allows you to designate a Cisco CMTS to be a Working CMTS in a 1+1 redundancy environment.
|
show hccp
|
Displays information for all cable interfaces on which one or more HCCP groups and authentication modes have been configured.
|
show hccp interface
|
Displays group information for a specific cable interface on which one or more groups and authentication modes have been configured.
|
show controllers cable
To display information about the interface controllers for a cable interface on the Cisco CMTS router, use the show controllers cable command in user EXEC or privileged EXEC mode.
show controllers cable {slot/port | slot/subslot/port} [downstream | upstream [port] | [mem-stat]
[memory] [proc-cpu]] [tech-support]
Syntax Description
slot/port
|
Identifies the cable interface and downstream port on the Cisco uBR7100 series and Cisco uBR7200 series routers.
On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
|
slot/subslot/port
|
Identifies the cable interface on the Cisco uBR10012 router. The following are the valid values:
• slot—5 to 8
• subslot—0 or 1
• port—0 to 4 (depending on the cable interface)
|
downstream
|
(Optional) Displays downstream interface status.
|
upstream
|
(Optional) Displays upstream interface status.
|
port
|
(Optional) Specifies the desired upstream port. Valid values start with 0 for the first upstream port on the cable interface line card.
|
mem-stat
|
(Optional) Displays the output from the show memory statistics command to display a summary of memory statistics for a Broadband Processing Engine (BPE) cable interface line card.
|
memory
|
(Optional) Displays the output from the show memory command to display a summary of memory statistics, including the memory as it is allocated per process, for a Broadband Processing Engine (BPE) cable interface line card.
|
proc-cpu
|
(Optional) Displays the output from the show processes cpu command to display the processor status for a Broadband Processing Engine (BPE) cable interface line card.
|
tech-support
|
(Optional) Cisco IOS Release 12.3(9a)BC adds the optional tech-support keyword. This change allows users with large numbers of online cable modems to collect the necessary line card information without consuming the console session for a long period of time.
|
Command Modes
User EXEC, Privileged EXEC (#)
Command History
Release
|
Modification
|
11.3 NA
|
This command was introduced.
|
12.0(2)XC
|
This command was modified to show a number of additional fields.
|
12.1(5)EC1
|
Support was added for the Cisco uBR7100 series router, including information about the Cisco uBR7100 series integrated upconverter.
|
12.2(1)XF1
|
Support was added for the Cisco uBR10012 router.
|
12.0(16)SC2, 12.1(10)EC1, 12.2(4)BC1b
|
The algorithm for calculating the SNR value was enhanced for a more accurate value.
|
12.2(15)CX
|
Support was added for the Cisco uBR-MC28U/X cable interface line card, including the display of the number of packets dropped because they were for a Service Flow ID (SFID) of 0.
|
12.2(15)BC2b
|
The mem-stat, memory, and proc-cpu options were added to obtain processor information from the onboard processor on Broadband Processing Engine (BPE) cable interface line cards, such as the Cisco uBR-MC16U/X, Cisco uBR-MC28U/X, and Cisco uBR10-MC5X20S/U cards.
|
12.3(9a)BC
|
Adds the optional tech-support keyword to optimize the collection of line card information without consuming the console session for a long period of time.
|
12.3(17a)BC
|
Added support for Dynamic Channel Change (DCC) for Load Balancing on the Cisco CMTS.
|
12.3(17a)BC2
|
Added support for the Cisco uBR10-MC5X20H interface line cards.
|
12.3(23)BC
|
The downstream option displays status and characteristics of modular cable interfaces associated with the Cisco uBR10-MC5x20 line card MAC domain host interface.
|
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
The mem-stat, memory, and proc-cpu keywords execute the related command on the processor that runs on added to obtain the relevant information from the onboard processor on Broadband Processing Engine (BPE) cable interface line cards, such as the Cisco uBR-MC16U/X, Cisco uBR-MC28U/X, and Cisco uBR10-MC5X20S/U/H cards. This allows you to obtain information that is specific for that particular cable interface card, as opposed to having to run these commands on the entire router.
Note
The mem-stat, memory, and proc-cpu options are not available for cable interface line cards that do not contain an onboard processor (for example, the Cisco uBR-MC16C card).
Dynamic Channel Change (DCC) Support for Load Balancing
The following commands and fields illustrate the show controllers command used with DCC:
Router# show controllers cx/y upstream | i DCC
DCC: 0 REQs n2 RSPs 0 ACKs
Router# show controllers cx/y downstream| i DCC
DCC: n1 REQs 0 RSPs n3 ACKs
n4 Successful DCCs n5 DCC Failures
DCC end of transaction counts:
DCC unknown cause(e1) offline(e2) if down(e3) no cm(e4)
DCC no resource(e5) no retries(e6) reject(e7) unknown state (e8)
DCC rebuild err (e9) T15 timeout(e10) reinit MAC (e11) dcc succeeds(e12)
The fields in this example are as follows:
•
n1—The number of DCC REQ messages traversing an interface, nonzero on downstream.
•
n2—The number of DCC RSP messages traversing an interface, nonzero on upstream.
•
n3—The number of DCC ACK messages traversing an interface, nonzero on downstream.
•
n4—The number of successful DCC transactions, nonzero on downstream direction.
•
n5—The number of failed DCC transactions, nonzero only on downstream direction
The above counters are DOCSIS specific DCC counters, which can also be collected via SNMP MIB.
The following summary illustrates classified DCC transaction end counts originated from the interface with the above show controllers command example.
•
e1—The number of DCC transactions ended with unknown causes.
•
e2—The number of DCC transactions ended due to modem's going offline.
•
e3—The number of DCC transactions ended due to interface down.
•
e4—The number of DCC transactions ended due to nonexistent cm.
•
e5—The number of DCC transactions ended due to insufficient resource on target.
•
e6—The number of DCC transactions ended due to exhausted DCC-REQ retries.
•
e7—The number of DCC transactions ended due to rejected DCC-REQ.
•
e8—The number of DCC transactions ended due to unknown DCC state.
•
e9—The number of DCC transactions ended due to failure to assign cm on the target.
•
e10—The number of DCC transactions ended due to T15 time out.
•
e11—The number of DCC transactions ended due to CM MAC reinitialization.
•
e12—The number of DCC transactions ended successfully.
This command is subject to the restrictions and prerequisites described in the "Configuring Load Balancing and Dynamic Channel Change (DCC) on the Cisco CMTS" feature document on Cisco.com.
Examples
The following abbreviated example illustrates the initial information for the tech-support option for the Cisco uBR10012 router on which Cisco IOS Release 12.3(9a)BC is installed:
Router# show controllers c8/1/0 tech-support
------------------ show version ------------------
Cisco Internetwork Operating System Software
IOS (tm) 7200 Software (UBR10KCLC-LC-M), Experimental Version 12.3(20040708:1441
55) [bguckel-geo_cable-l2 102]
Copyright (c) 1986-2004 by cisco Systems, Inc.
Compiled Mon 19-Oct-04 11:28 by bguckel
Image text-base: 0x60008EB8, data-base: 0x60CB0000
ROM: System Bootstrap, Version 12.2(20011031:221132) [maheshj-cr10k-rommon 15],
BOOTLDR: 7200 Software (UBR10KCLC-LC-M), Experimental Version 12.2(20011107:2331
03) [janez-v122_2_xf_throttle.Nov5A 101]
clc_8_1 uptime is 1 week, 9 hours, 54 minutes
System returned to ROM by power-on
System restarted at 08:59:44 UTC Wed Jul 21 2004
cisco uBR10K CLC (NPE-CLC) processor (revision A) with 196608K/65536K bytes of m
R7000 CPU at 262MHz, Implementation 39, Rev 2.1, 256KB L2 Cache
6 slot midplane, Version 1.0
The following is sample output for the downstream connection for slot 3 on port 0 on Cisco CMTS router from the show controllers cable downstream command:
CMTS01# show controllers cable 3/0 downstream
Cable 3/0 Downstream is up
Frequency not set, Channel Width 6 MHz, 64-QAM, Symbol Rate 5.056941 Msps
FEC ITU-T J.83 Annex A, R/S Interleave I=12, J=17
Table 100 describes the fields displayed by the show controllers cable downstream command.
Table 100 show controllers cable downstream Field Descriptions
Field
|
Description
|
Cable
|
Slot number/port number indicating the location of the Cisco cable interface line card.
|
Downstream is up
|
Indicates that the RF downstream interface is enabled.
|
Frequency
|
Transmission frequency of the RF downstream. (This information may not match the current transmission frequency, which is external on CMTS platforms that use an external upconverter.)
|
Channel Width
|
Indicates the width of the RF downstream channel.
|
QAM
|
Indicates the modulation scheme.
|
Symbol Rate
|
Indicates the transmission rate (in number of symbols per second).
|
FEC ITU-T
|
Indicates the Motion Picture Experts Group (MPEG) framing standard.
|
Annex
|
Indicates the annex for the RF downstream channel.
|
R/S Interleave I/J
|
Indicates Reed Solomon framing based on ITU S.83-B.
|
For cable interfaces that include an integrated upconverter, the show controllers cable command includes the frequency and power settings for the integrated upconverter. The following example shows typical output for the show controllers cable command that includes the information for the integrated upconverter:
ubr7100# show controllers cable 1/0
Cable1/0 Upconverter is Enabled Output is Enabled
Model: 74-2094-01 Serial Number: 0WAV04480010 CLEI Code: CLEI#
HW Rev: PC2D0107 SW Rev: 007, NVRAM Rev: 006 ECI number 123456
Downstream Frequency 525.0000 MHz
IF Power 0.3 dBmv RF Power 51.0 dBmv
The following is typical output for a downstream on the Cisco uBR-MC28U cable interface line card, or other cable interface card with integrated upconverter:
ubr7246vxr# show controllers cable 6/0 downstream
Hardware is MC28U (F-connector) with Integrated Up-converter
Primary rommon version is: 11.4
Secondary rommon version is: 6553.5
Current rommon is Primary
Output queue: 0/1000/64/0 (size/max total/threshold/drops)
H/W Spectrum Management Information:
BCM3138 Chip State: 1 1 1 1, Serial Port State 1, Busy Count: 0 25 0 0
Spectrum Management IPC Statistics:
Pkts: 48413, Lock Errs: 0, MB not Empty: 0, No Buffs: 0
Pkts: 46097, Timeout: 1, Unexpected: 0, No Buffs: 0, Lock Errs: 0
Inuse band lower=0 upper=0 CNR=56
candidate band lower=0 upper=0 Mod=0
Inuse band lower=0 upper=0 CNR=52
candidate band lower=0 upper=0 Mod=0
Inuse band lower=0 upper=0 CNR=55
candidate band lower=0 upper=0 Mod=0
Inuse band lower=23000 upper=26200 CNR=55
candidate band lower=23000 upper=26200 Mod=0
Cable6/0 Upconverter is Enabled Output is Enabled
Model: 74-2094-05 Serial Number: 0WAV06530029 CLEI Code: FFFFFFFFFF
HW Rev: PC2D0108 SW Rev: 010, NVRAM Rev: 006 ECI number FFFFFF
Downstream Frequency 471.0000 MHz
Table 101 describes the fields related to the integrated upconverter that are displayed by the show controllers cable downstream command.
Table 101 show controllers cable downstream upconverter Field Descriptions
Field
|
Description
|
Downstream Frequency
|
Indicates the center frequency (in MHz) for which the integrated upconverter has been configured.
|
IF Power
|
Indicates the power level (in dBmV) of the signal that the integrated upconverter is receiving from the cable interface line card in the Cisco uBR7100 series router.
|
RF Power
|
Indicates the power level (in dBmV) of the RF output signal that the integrated upconverter is transmitting on the DS0 RF port.
|
The following is a sample output of the show controllers cable downstream command on for slot 8, subslot 0 and port 0 on Cisco CMTS router:
ubr10012# show controllers c8/0/0 downstream
Cable8/0/0 Downstream is up
Frequency 453.0000 MHz, Channel Width 6 MHz, 64-QAM, Symbol Rate 5.056941 Msps
FEC ITU-T J.83 Annex B, R/S Interleave I=32, J=4
Downstream channel ID: 191
DSA: 0 REQs 0 RSPs 0 ACKs
0 Successful DSAs 0 DSA Failures
DSC: 0 REQs 0 RSPs 0 ACKs
0 Successful DSCs 0 DSC Failures
0 Successful DSDs 0 DSD Failures
DCC: 0 REQs 0 RSPs 0 ACKs
0 Successful DCCs 0 DCC Failures
DCC end of transaction counts:
DCC unknown cause(0) offline(0) if down(0) no cm(0)
DCC no resource(0) no retries(0) reject(0) unknown state (0)
DCC rebuild err (0) T15 timeout(0) wrong channel(0) reinit MAC (0)
Local total modems 800, modems active 800, total DS flows 801
NB DS Mo3/0/1:0, STATE: UP
Frequency 555.0000 MHz 64-QAM, ANNEX B, R/S Interleave I=32, J=4
Bandwidth (Kbps): 4315, Load Percent: 0
Channel ID: 48, US MAP: 0x0037
Total modems: 4, modems active : 4, total DS flows: 5
NB DS Mo3/0/1:1, STATE: UP
Frequency 561.0000 MHz 64-QAM, ANNEX B, R/S Interleave I=32, J=4
Bandwidth (Kbps): 4315, Load Percent: 0
Channel ID: 49, US MAP: 0x0037
Total modems: 2, modems active : 2, total DS flows: 3
NB DS Mo3/0/1:2, STATE: UP
Frequency 567.0000 MHz 64-QAM, ANNEX B, R/S Interleave I=32, J=4
Bandwidth (Kbps): 4315, Load Percent: 0
Channel ID: 50, US MAP: 0x0037
Total modems: 1, modems active : 1, total DS flows: 2
NB DS Mo3/0/1:3, STATE: UP
Frequency 573.0000 MHz 64-QAM, ANNEX B, R/S Interleave I=32, J=4
Bandwidth (Kbps): 13485, Load Percent: 0
Channel ID: 51, US MAP: 0x0037
Total modems: 3, modems active : 3, total DS flows: 4
The following is sample output from the show controllers cable upstream command for a Cisco CMTS router with a cable interface card located in slot 4, port 0:
CMTS01# show controllers cable 4/0 upstream 2
Cable4/0 Upstream 2 is administratively down
Frequency 5.008 MHz, Channel Width 0.200 MHz, QPSK Symbol Rate 0.160 Msps
SNR measurement - 27.2340 dB
Nominal Input Power Level 5 dBmV, Tx Timing Offset 0
Ranging Backoff Start 16, Ranging Backoff End 16, Tx Backoff Start 16
Tx Backoff End 16, Modulation Profile Group 1
part_id=0x3137, rev_id=0x01, rev2_id=0xFF
nb_agc_thr=0x0000, nb_agc_nom=0x0000
Request Load Reg Size=0x0E
Minislot Size in number of Timebase Ticks is = 8
Minislot Size in Symbols =8
Minislot Size in Bytes = 2
DES Ctrl Reg#0 = C00C0C43, Reg#1 = 0
The following example shows typical output for a cable interface line card that includes onboard hardware-based spectrum management capabilities (such as the Cisco uBR-MC16S and Cisco uBR-MC28U/X cards):
Router# show controllers cable 3/0 upstream 3
Cable6/0 Upstream 3 is up
Frequency 24.600 MHz, Channel Width 3.200 MHz, 64-QAM Symbol Rate 2.560 Msps
This upstream is mapped to physical port 3
Spectrum Group 14, Last Frequency Hop Data Error: NO(0)
MC28U CNR measurement - better than 50 db
Nominal Input Power Level 0 dBmV, Tx Timing Offset 2815
Ranging Backoff automatic (Start 0, End 3)
Ranging Insertion Interval automatic (60 ms)
Tx Backoff Start 0, Tx Backoff End 4
Modulation Profile Group 241
part_id=0x3138, rev_id=0x02, rev2_id=0x00
nb_agc_thr=0x0000, nb_agc_nom=0x0000
Request Load Reg Size=0x0E
Minislot Size in number of Timebase Ticks is = 2
Minislot Size in Symbols = 32
Bandwidth Requests = 0x23C800
Piggyback Requests = 0x489FB8
Minislots Requested= 0x4499EBE
Minislots Granted = 0x6C67B7
Minislot Size in Bytes = 24
Map Advance (Dynamic) : 2454 usecs
Multicast/Broadcast RateLimit Dropped Pkts : 0
For Broadband Processing Engine (BPE) cards, and other cable interfaces that include onboard upconverters, the show controllers cable command also displays information about the upconverter's status and configuration. The following excerpt from the command output shows the information that is displayed for the Cisco uBR10-MC5X20S cable interface line card:
Router# show controllers cable 5/1/4
Cable5/1/4 Upconverter is Enabled Output is Enabled
Model: 74-2094-04 Serial Number: 0WAV0649000L CLEI Code: FFFFFFFFFF
HW Rev: PC2D0108 SW Rev: 010, NVRAM Rev: 006 ECI number FFFFFF
Downstream Frequency 255.0000 MHz
Table 102 describes the fields shown in the show controllers cable upstream display.
Table 102 show controllers cable upstream Command Field Descriptions
Field
|
Description
|
Cable
|
Slot number/port number indicating the location of the Cisco cable interface line card.
|
Upstream is up/administratively down
|
Indicates the administrative state of the upstream (whether it is shutdown or not).
|
Channel Width
|
Indicates the width of the RF upstream channel.
|
QPSK Symbol Rate
|
Indicates the modulation technique for upstream transmission.
|
Spectrum Group 4
|
Indicates the spectrum group associated with this slot and port.
|
Frequency
|
Transmission frequency of the RF upstream channel.
Note Cisco cable interface line cards always program the upstream's center frequency in 16 KHz increments, and this is the frequency displayed by the lines added to the router's configuration and by the show controllers cable upstream command. For example, if you use the cable upstream frequency command to specify a center frequency of 27 MHz (cable upstream x frequency 27000000), the actual center frequency will be 27.008 MHz, which is the next highest 16 KHz boundary.
|
SNR measurement
|
Estimate for the overall signal-to-noise ratio (SNR) for cable interfaces that do not include onboard hardware-based spectrum management. For most cable interface line cards, this value reflects the Modulation Error Rate (MER) value for the upstream (as calculated according to the IEEE 802.14 PHY layer specifications). The MER is sometimes incorrectly referred to as the carrier-to-noise ratio (CNR), and the SNR value is generally lower than the CNR value.
Note In Cisco IOS Release 12.1(10)EC1 and Cisco IOS Release 12.2(4)BC1b, the algorithm for calculating the SNR estimate was refined for a more accurate value. Depending on the plant characteristics, the new SNR estimate could be up to 6 dB lower than the values shown in earlier software releases. This value is only an estimate—for the most accurate value, use a spectrum analyzer.
|
<card-name> CNR measurement
|
Estimate for the overall carrier-to-noise ratio (CNR) for the upstream for cable interfaces that include onboard hardware-based spectrum management (such as the Cisco uBR-MC16S or Cisco uBR10-MC5X20S). When the CNR measurement exceeds 40 dB, this line states "better than 40 dB." As a general rule, the CNR is greater than the SNR value.
Note This value is only an estimate—for the most accurate value, use a spectrum analyzer or use the show controllers cable upstream spectrum command. For individual cable modems, you can also use the show cable modem cnr command.
|
Nominal Input Power level
|
Indicates the desired power level coming into the receiver.
|
Tx Timing Offset
|
Indicates the largest ranging offset reported by CMs on the upstream.
|
Ranging Backoff Start/End
|
Indicates how many ranging slots (expressed as an exponent of 2) to back off before resending the ranging bursts after an upstream collision. These values are configured using the cable upstream range-backoff start end command.
|
Ranging Backoff Automatic
|
Start and End Ranging Backoff exponents, which are set automatically, using the cable upstream range-backoff automatic command.
Note These counters are not accurately updated on the Cisco uBR10-MC5X20S cable interface line card, which should manually configure ranging backoff instead.
|
Tx Backoff Start
|
Indicates the starting exponential backoff value for data collisions.
|
Tx Backoff End
|
Indicates the ending exponential backoff value for data collisions.
|
Modulation Profile Group
|
A set of burst profiles defining an upstream range.
|
part_id=
|
The part number of the PHY chip. FFFF means the PHY chip is turned off.
|
rev_id=
|
The PHY chip revision number.
|
rev2_id=
|
The PHY chip subrevision number.
|
nb_agc_thr=
|
Threshold used to control gain.
|
nb_agc_nom=
|
Used to accelerate convergence of input power level.
|
Range Load Reg Size=
|
Size, indicated by number of symbols, for range request bursts.
|
Request Load Reg Size=
|
Size, indicated by number of symbols, for request bursts.
|
Minislot Size in number of Timebase Ticks is
|
Size in tick units of upstream minislot. A tick is 6.25 microseconds.
|
Minislot Size in Symbols
|
Size in symbols of the upstream minislot.
|
Bandwidth Requests
|
Number of successful bandwidth requests received in the contention minislots.
|
Piggyback Requests
|
Number of successful bandwidth requests piggybacked with regular data transmissions.
|
Invalid BW Requests
|
Number of invalid bandwidth (BW) requests. (An example of an invalid bandwidth request is a modem using a nonexistent service identifier (SID) to request bandwidth.
|
Minislots Requested
|
Total number of minislots requested.
|
Minislots Granted
|
Total number of minislots granted.
|
Minislot Size in Bytes
|
Size of the minislot in bytes.
|
UCD Count
|
Number of Upstream Channel Descriptors (UCDs) sent for this upstream.
|
DES Ctrl Reg # =
|
Interval data encryption standard (DES) controller register dump.
|
Null Modem RateLimit Dropped Pkts
|
(Cisco uBR-MC16U/X, Cisco uBR-MC28U/X only) Number of packets that were dropped because they had a Service Flow ID (SFID) of 0, which typically happens because the packets were dropped due to rate-limiting on their original service flow.
|
Additional Information for Broadband Processing Engine (BPE) Cable Interface Line Cards
|
JIB Version
|
Revision of the JIB circuitry, which is the custom processor onboard the BPE cards that handles the MAC-layer processing.
|
Upconverter is Enabled Output is Enabled
|
Status of the upconverter and whether it is currently outputting a signal. If this field shows that the output is disabled, use the no cable downstream rf-shutdown command to reenable it.
|
Downstream Frequency
|
Configured frequency, in MHz, for the integrated upconverter (if present).
|
RF Power
|
Current RF power, in dBmV, as measured by the upconverter on the cable interface line card. The upconverter's circuitry is accurate to a few tenths of a dBmV, but might vary +/- 1 dBmV depending on the transient noise that is occuring when the power is measured.
|

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.
Related Commands
Command
|
Description
|
cable downstream frequency
|
Configures the downstream center frequency on the integrated upconverter.
|
cable downstream rf-power
|
Configures the desired RF output power on the integrated upconverter.
|
cable spectrum-group (global configuration)
|
Creates spectrum groups, which contain one or more upstream frequencies.
|
cable upstream frequency
|
Specifies that the upstream should be set to either a specific center frequency or be set dynamically.
|
show controllers cable upstream spectrum
|
Displays the noise levels for a particular CM or displays the background noise for an entire upstream (Cisco uBR-MC16 line card only).
|
show interface cable sid
|
Displays information about interface controllers for a specific cable access router card slot.
|
show controllers cable upstream spectrum
To display the noise levels for a particular CM or to display the background noise for an entire upstream on the Cisco uBR-MC16 line card, use the show controllers cable upstream spectrum command in user EXEC or privileged EXEC mode.
show controllers cable {slot/port | slot/subslot/port} upstream n spectrum [ ip-address |
mac-address ] start-freq end-freq res-freq
Syntax Description
slot/port
|
Identifies the cable interface and downstream port on the Cisco uBR7100 series and Cisco uBR7200 series routers.
On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
|
slot/subslot/port
|
Identifies the cable interface on the Cisco uBR10012 router. The following are the valid values:
• slot = 5 to 8
• subslot = 0 or 1
• port = 0 to 4 (depending on the cable interface)
|
n
|
Port number for the desired upstream (0 to 5).
|
ip-address
|
(Optional) IP address, in dotted decimal notation, for a CM on the specified upstream.
|
mac-address
|
(Optional) MAC address, in dotted hexadecimal notation, for a CM on the specified upstream.
|
start-freq
|
Starting frequency for the frequency range that is being reported (5 to 42 MHz; can also be specified as 5000 to 42000 KHz or 5000000 to 42000000 Hz).
|
end-freq
|
Ending frequency for the frequency range that is being reported (5 to 42 MHz).
Note The ending frequency must be greater than the starting frequency and must be specified using the same units as the starting frequency (MHz, KHz, Hz).
|
res-freq
|
Resolution frequency to determine the number of data points for the report (12 to 37000 KHz).
Note The resolution frequency must be specified in the same units as the starting and ending frequency (MHz, KHz, Hz). To use a resolution value less than 1 MHz, you must specify the other parameters in either Hz or KHz.
|
Command Modes
User EXEC, Privileged EXEC
Command History
Release
|
Modification
|
12.1(7)CX1
|
This command was introduced for Cisco CMTS routers using the Cisco uBR-MC16S cable interface line card.
|
12.2(8)BC2
|
Support was added for the Cisco uBR10012 router and the Cisco uBR-LCP2-MC16S cable interface line card.
|
12.3(21)BC
|
This command is obsolete.
|
Usage Guidelines
Cisco IOS Release 12.3(9a)BC adds the tech-support keyword to the show controllers cable command. This change allows users with large numbers of online cable modems to collect the necessary line card information without consuming the console session for a long period of time.
Additional and related improvements are also available for the show cable tech-support command.
For all supported releases, the show controllers cable upstream spectrum command displays the power in dBmV for a given frequency range for the specified upstream. The frequency range can cover any portion of the DOCSIS upstream frequency range (5 to 42 MHz), and the frequency range can be divided into a resolution as small as 12 KHz.
If a CM is specified by its IP address or MAC address, the power information for that particular CM is given. If no IP or MAC address is given, the command displays the background noise for the entire upstream. All displays use historical averaging of data collected at the time the command is used; historical information is not saved.
Note
Cisco cable interface line cards always program the upstream's center frequency in 16-KHz increments, and this is the frequency displayed by the show controller cable upstream command. For example, if you use the cable upstream frequency command to specify a center frequency of 27 MHz (cable upstream x frequency 27000000), the actual center frequency will be 27.008 MHz, which is the next-highest 16-KHz boundary.
Tip
By default, the show controller cable upstream command displays its output to the router's console port. To display the command's output when logged in during a Telnet session over an Ethernet port, use the terminal monitor command before giving the show controller cable upstream command.
Examples
The following example shows the show controllers cable upstream command displaying the power information for a particular CM on upstream 5 of cable interface slot 3/0. The power information is displayed over the entire upstream (5-42 MHz), with a resolution of 5 MHz:
MAC Address IP Address I/F MAC Prim RxPwr Timing Num BPI
State Sid (db) Offset CPEs Enbld
00d0.ba77.7595 10.20.114.34 C3/0/U5 online 1 0.25 2740 1 yes
00d0.ba77.7621 10.20.114.17 C3/0/U5 online 2 0.25 2740 2 yes
00d0.ba77.7533 10.20.114.55 C3/0/U5 online 3 0.25 2740 1 yes
Router# show controllers cable 3/0 upstream 5 spectrum 10.20.114.34 5 42 5
02:16:49: Spectrum DATA(@0x4B060004) for u5: 4995-41991KHz(resolution 4992KHz, sid 1):
02:16:49: Freq(KHz) dBmV Chart
02:16:49: 4995 : -5 *************************
02:16:49: 9987 : -7 ************************
02:16:49: 14979: -24 ****************
02:16:49: 19971: -35 **********
02:16:49: 24963: -39 ********
02:16:49: 29955: -35 **********
02:16:49: 34947: -37 *********
Note
The output for each frequency range includes a time-stamp, the ending frequency for each range (in KHz), the historical average power level for that range (in dBmV), and a series of asterisks that provides a graphical representation of the noise floor level for the signal (a stronger signal is indicated by more asterisks).
The following example shows a partial display of the background noise data for upstream 4 of cable interface slot 6/0. The command covers the entire upstream spectrum (5-42 MHz) at the minimum resolution of 12 KHz.
Router# show controller cable 6/0 upstream 4 spectrum 5000 42000 12
02:15:54: Spectrum DATA(@0x4B060004) for u5: 4995-41991KHz(resolution 12KHz, sid 1):
02:15:54: Freq(KHz) dBmV Chart
02:15:54: 8271 : -46 *****
02:15:54: 8283 : -45 *****
02:15:54: 8307 : -48 ****
02:15:54: 8319 : -45 *****
02:15:54: 8331 : -41 *******
02:15:54: 8343 : -39 ********
02:15:54: 8355 : -39 ********
02:15:54: 8367 : -40 ********
02:15:54: 8379 : -43 ******
02:15:54: 8391 : -44 ******
02:15:54: 8403 : -33 ***********
02:15:54: 8415 : -32 ************
02:15:54: 8427 : -30 *************
02:15:54: 8439 : -27 **************
02:15:54: 8451 : -28 **************
02:15:54: 8463 : -36 **********
02:15:54: 8475 : -40 ********
02:15:54: 8487 : -37 *********
02:15:54: 8499 : -40 ********
02:15:54: 8511 : -39 ********
02:15:54: 8523 : -28 **************
02:15:54: 8535 : -29 *************
02:15:54: 8547 : -27 **************
02:15:54: 8559 : -29 *************
02:15:54: 8571 : -40 ********
02:15:54: 8583 : -36 **********
02:15:54: 8595 : -28 **************
02:15:54: 8607 : -30 *************
02:15:54: 11247: -40 ********
02:15:54: 11259: -44 ******
02:15:54: 11271: -44 ******
02:15:54: 11283: -46 *****
02:15:54: 11295: -46 *****
02:15:54: 11307: -42 *******
02:15:54: 11319: -46 *****
02:15:54: 11331: -48 ****
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.
Related Commands
Command
|
Description
|
cable modulation-profile
|
Creates a cable modulation profile.
|
cable upstream hop-priority
|
Determines the order of the corrective actions to be taken when ingress noise exceeds the allowable value for an upstream.
|
cable upstream modulation-profile
|
Configures an upstream for one modulation profile (static profile) or two modulation profiles (Dynamic Upstream Modulation).
|
show cable hop
|
Displays the current hop period and threshold for an upstream, along with other statistics.
|
show cable modem cnr
|
Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.
|
show cable modulation-profile
|
Displays the cable modulation profiles that have been created.
|
show controllers cable
|
Displays detailed statistics for the cable interface.
|
show controllers cable-modem
To display high-level controller information for the router's cable interface, use the show controllers cable-modem command in privileged EXEC mode.
Cisco uBR904, uBR905, uBR924, uBR925 cable access routers, Cisco CVA122 Cable Voice Adapter
show controllers cable-modem number [all]
Syntax Description
number
|
Identifies the cable interface (always 0).
|
all
|
(Optional) Displays detailed, multi-page output, including chip-level settings, transmit and receive ring contents, and MAC-layer and PHY-layer registers and buffers.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.3(4)NA
|
This command was introduced for the Cisco uBR904 cable access router.
|
12.0(4)XI1
|
Support was added for the Cisco uBR924 cable access router.
|
12.1(3)XL
|
Support was added for the Cisco uBR905 cable access router.
|
12.1(5)XU1
|
Support was added for the Cisco CVA122 Cable Voice Adapter.
|
12.2(2)XA
|
Support was added for the Cisco uBR925 cable access router.
|
Usage Guidelines
The show controllers cable-modem display begins with information from the first few registers of the Broadcom BCM3300 chip. Next is buffer information for the receive, receive MAC message, buffer descriptor, and packet descriptor rings. Then comes MIB statistics from the BCM3300 chip, DMA base registers to indicate where the rings start, global control and status information, and finally interrupts for the interrupt code.
When using this command, be sure to check the tx_count and the tx_head and tx_tail values for the buffer descriptor (TX BD) and packet descriptor (TX PD) rings. The tx_count should be greater than 0, and the tx_head and tx_tail values should not be equal. If these values do not change for several minutes, it could indicate that there are packets stuck on the ring. This condition is often caused by the CMTS not giving grants.
Examples
The following shows typical output for the show controllers cable-modem command:
Router# show controllers cable-modem 0
BCM3300 unit 0, idb 0x200EB4, ds 0x82D4748, regaddr = 0x800000, reset_mask 0x80
station address 0010.7b43.aa01 default station address 0010.7b43.aa01
MAC State is ranging_2_state, Prev States = 7
MAC mcfilter 01E02F00 data mcfilter 01000000
DS: BCM 3116 Receiver: Chip id = 2
US: BCM 3037 Transmitter: Chip id = 30B4
Rx: tuner_freq 699000000, symbol_rate 5055849, local_freq 11520000
snr_estimate 33406, ber_estimate 0, lock_threshold 26000
QAM in lock, FEC in lock, qam_mode QAM_64
Tx: tx_freq 20000000, power_level 0x3E, symbol_rate 1280000
DHCP: TFTP server = 4.0.0.32, TOD server = 4.0.0.188
Security server = 0.0.0.0, Timezone Offset = 0.0.4.32
RX data PDU ring with 32 entries at 0x201D40
rx_head = 0x201D78 (7), rx_p = 0x831BE04 (7)
00 pak=0x8326318 buf=0x225626 status=0x80 pak_size=0
01 pak=0x83241A0 buf=0x21DE5A status=0x80 pak_size=0
02 pak=0x83239C0 buf=0x21C22A status=0x80 pak_size=0
03 pak=0x8328C70 buf=0x22EA22 status=0x80 pak_size=0
04 pak=0x8325F28 buf=0x22480E status=0x80 pak_size=0
05 pak=0x8327CB0 buf=0x22B1C2 status=0x80 pak_size=0
06 pak=0x8323BB8 buf=0x21C936 status=0x80 pak_size=0
RX MAC message ring with 8 entries at 0x201E80
rx_head_mac = 0x201E88 (1), rx_p_mac = 0x831BE80 (1)
00 pak=0x8326120 buf=0x224F1A status=0x80 pak_size=0
01 pak=0x8324590 buf=0x21EC72 status=0x80 pak_size=0
02 pak=0x8323FA8 buf=0x21D74E status=0x80 pak_size=0
03 pak=0x8326EE8 buf=0x22806E status=0x80 pak_size=0
04 pak=0x8328E68 buf=0x22F12E status=0x80 pak_size=0
05 pak=0x8327AB8 buf=0x22AAB6 status=0x80 pak_size=0
06 pak=0x8328880 buf=0x22DC0A status=0x80 pak_size=0
07 pak=0x8326CF0 buf=0x227962 status=0xA0 pak_size=0
TX BD ring with 8 entries at 0x201FB8, tx_count = 0
tx_head = 0x201FD8 (4), head_txp = 0x831BF20 (4)
tx_tail = 0x201FD8 (4), tail_txp = 0x831BF20 (4)
00 pak=0x000000 buf=0x200000 status=0x00 pak_size=0
01 pak=0x000000 buf=0x200000 status=0x00 pak_size=0
02 pak=0x000000 buf=0x200000 status=0x00 pak_size=0
03 pak=0x000000 buf=0x200000 status=0x00 pak_size=0
04 pak=0x000000 buf=0x200000 status=0x00 pak_size=0
05 pak=0x000000 buf=0x200000 status=0x00 pak_size=0
06 pak=0x000000 buf=0x200000 status=0x00 pak_size=0
07 pak=0x000000 buf=0x200000 status=0x20 pak_size=0
TX PD ring with 8 entries at 0x202038, tx_count = 0
tx_head_pd = 0x202838 (4)
tx_tail_pd = 0x202838 (4)
00 status=0x00 bd_index=0x0000 len=0x0000 hdr_len=0x0000
01 status=0x00 bd_index=0x0001 len=0x0000 hdr_len=0x0000
02 status=0x00 bd_index=0x0002 len=0x0000 hdr_len=0x0000
03 status=0x00 bd_index=0x0003 len=0x0000 hdr_len=0x0000
04 status=0x00 bd_index=0x0004 len=0x0000 hdr_len=0x0000
05 status=0x00 bd_index=0x0005 len=0x0000 hdr_len=0x0000
06 status=0x00 bd_index=0x0006 len=0x0000 hdr_len=0x0000
07 status=0x20 bd_index=0x0007 len=0x0000 hdr_len=0x0000
DS fifo full = 0, Rerequests = 0
DS mac msg overruns = 0, DS data overruns = 0
Qualified maps = 348, Qualified syncs = 73
CRC fails = 0, HDR chk fails = 0
Data pdus = 0, Mac msgs = 423
ds_data_bd_base=0x001D40, ds_mac_bd_base=0x001E80
ds_data_dma_ctrl=0x98, ds_mac_dma_ctrl=0xD8
ds_dma_data_index=0x0007, ds_dma_msg_index=0x0000
us_bd_base=0x001FB8, us_pd_base=0x002038
us_dma_ctrl=0x80, us_dma_tx_start=0x00
Global control and status:
irq_pend=0x0008, irq_mask=0x00F7
The following shows an excerpt from the display for the all option:
Router# show controllers cable-modem 0 all
BCM MAC/PHY: Chip id = BCM3300 Revision A (1)
BCM3220 unit 0, idb 0x81068880, ds 0x8106B8A0, regaddr = 0x10100000, reset_mask 0x80
station address 0006.53b6.57bd default station address 0006.53b6.57bd
MAC mcfilter 01E02F00 data mcfilter 00000000
RX data PDU ring with 32 entries at 0x10030F00
rx_head = 0x10030F78 (15), rx_p = 0x8106B8F8 (15)
00 pak=0x810798C0 buf=0x10044F56 status=0x80 pak_size=0
01 pak=0x81079BB4 buf=0x1004575E status=0x80 pak_size=0
Rx: tuner_freq 645000000, symbol_rate 5056000, local_freq 11520000
snr_estimate 345(TenthdB), ber_estimate 0, lock_threshold 23000
QAM in lock, FEC in lock, qam_mode QAM_64 (Annex B)
Tx: tx_freq 27984000, symbol rate 16 (2560000 sym/sec)
power_level: 29.75 dBmV (current)
30 (gain in US AMP units)
5 (BCM3300 attenuation in .4 dB units)
IF AGC=0x2010 (8208) RF AGC=0x3753 (14163)
Combined AGC = 22371 (band = 1)
Estimated Downstream Power: 7.9 dBmV
Note
The show controllers cable-modem 0 all command displays extensive information about the current state of the modem and its MAC-layer and PHY-layer registers and buffers. You need to open a capture buffer on your terminal or Telnet software to log this information before you give this command.
Table 0-103 describes the significant fields shown by the show controllers cable-modem command. For more information, see the Broadcom documentation for the BCM3300 chip.
Table 0-103 show controllers cable-modem Field Descriptions
Field
|
Description
|
BCM3300 unit
|
Unit number of this BCM3300 chip.
|
idb
|
Interface description block number.
|
ds
|
Downstream channel.
|
regaddr
|
Indicates the start of the BCM3300 registers.
|
reset_mask
|
Indicates the bit to hit when resetting the chip.
|
station address
|
MAC address of this router's cable interface.
|
default station address
|
Default MAC address assigned by the factory for this router.
|
PLD VERSION
|
PLD version of the BCM3300 chip.
|
MAC State
|
Current MAC state of the router.
|
Prev States
|
Number of states that have previously existed since initialization.
|
MAC mcfilter
|
MAC control filter for MAC messages.
|
data mcfilter
|
MAC control filter for data.
|
DS
|
Downstream Broadcom receiver chip number and ID.
|
US
|
Upstream Broadcom transmitter chip number and ID.
|
Tuner: status
|
Current status of the tuner.
|
Rx: tuner_freq
|
Downstream frequency (in Hz) that the router searched for and found.
|
symbol_rate
|
Downstream frequency in symbols per second.
|
local_freq
|
Frequency on which the transmitter and the tuner communicate.
|
snr_estimate
|
Estimate of signal-to-noise ratio (SNR) in dB multiplied by 1000.
|
ber_estimate
|
Estimate of bit error rate (always 0).
|
lock_threshold
|
Minimum signal-to-noise ratio (SNR) that the router will accept as a valid lock.
|
qam_mode
|
The modulation scheme used in the downstream direction.
|
Tx: tx_freq
|
Upstream frequency sent to the router by the CMTS in the UCD message.
|
power_level
|
Transmit power level as set in the hardware, expressed as a hexadecimal value. The units are unique to the hardware used. Use the show controllers cable-modem mac state command to see the power level in dBmV.
|
symbol_rate
|
Upstream frequency in symbols per second.
|
TFTP server
|
IP address of the TFTP server at the CMTS.
|
TOD server
|
IP address of the time-of-day server at the CMTS.
|
Security server
|
IP address of the security server at the CMTS.
|
Timezone Offset
|
Correction received from the DHCP server to synchronize the router time clock with the CMTS.
|
Config filename
|
Name of the file stored on the cable company's TFTP server that contains operational parameters for the router.
|
buffer size
|
Size in bytes of the BCM3300 message buffers.
|
RX data PDU ring:
|
Indicates the memory location of the beginning of buffer information for the receive data ring.
|
rx_head
|
Indicates current head buffer descriptor.
|
rx_p
|
Indicates current head packet descriptor.
|
RX MAC message ring:
|
Indicates the memory location of the beginning of buffer information for the receive MAC message ring.
|
rx_head_mac
|
Indicates current head buffer descriptor.
|
rx_p_mac
|
Indicates current head packet descriptor.
|
TX BD ring:
|
Indicates the memory location of the beginning of buffer information for the transmit buffer descriptor ring.
|
tx_count
|
If tx_count is 0, or if tx_head and tx_tail are equal and there is no change for a period of time, it means there are packets stuck on the ring. This condition may be caused by the CMTS not giving grants.
|
tx_head
|
Indicates current head transmit packet descriptor.
|
head_txp
|
The next packet descriptor to get used, along with its index.When head_txp and tail_txp are the same, the transmit queue is empty.
|
tx_tail
|
Indicates current tail transmit packet descriptor.
|
tail_txp
|
The next packet descriptor to get sent, along with its index. When head_txp and tail_txp are the same, the transmit queue is empty.
|
TX PD ring:
|
Indicates the memory location of the beginning of buffer information for the transmit packet descriptor ring.
|
tx_head_pd
|
Indicates current head packet descriptor.
|
tx_tail_pd
|
Indicates current tail packet descriptor.
|
ehdr
|
Extended MCNS header.
|
MIB Statistics
|
DS fifo full
|
Number of times the downstream input first-in first-out (FIFO) buffer became full on the router.
|
rerequests
|
Number of times a bandwidth request generated by the router was not responded to by the CMTS.
|
DS mac msg overruns
|
Number of times the router's DMA controller had a downstream MAC message and there were no free MAC message buffer descriptors to accept the message.
|
DS data overruns
|
Number of times the router's DMA controller had downstream data and there were no free data PDU buffer descriptors to accept the data.
|
Qualified maps
|
Number of times a MAP message passed all filtering requirements and was received by the router.
|
Qualified syncs
|
Number of times a timestamp message was received by the router.
|
CRC fails
|
Number of times a MAC message failed a cyclic redundancy check (CRC).
|
HDR chk fails
|
Number of times a MAC header failed its 16-bit CRC check. The MAC header CRC is a 16-bit Header Check Sequence (HCS) field that ensures the integrity of the MAC header even in a collision environment.
|
Data pdus
|
Total number of data protocol data units (PDUs) of all types received by the router.
|
Mac msgs
|
Number of MAC messages received by the router.
|
Valid hdrs
|
Number of valid headers received by the router, including PDU headers, MAC headers, and headers only.
|
Global control and status:
|
Used to reset the BCM3300 chip.
|
interrupts:
|
Hexadecimal values of the pending IRQ interrupt and IRQ mask.
|

Tip
In Cisco IOS Release 12.2(8)T and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Related Commands
show controllers cable-modem bpkm
To display information about the Baseline Privacy Interface (BPI) or BPI Plus (BPI+) key management (BPKM) exchange between the router and the CMTS, use the show controllers cable-modem bpkm command in privileged EXEC mode.
Cisco uBR904, Cisco uBR905, Cisco uBR924, and Cisco uBR925 cable access routers, and Cisco CVA122 Cable Voice Adapter
show controllers cable-modem number bpkm
Syntax Description
number
|
Identifies the cable interface (always 0).
|
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.3(4)NA
|
This command was introduced for the Cisco uBR904 cable access router.
|
12.0(4)XI1
|
Support was added for the Cisco uBR924 cable access router.
|
12.1(3)XL
|
Support was added for the Cisco uBR905 cable access router.
|
12.1(5)XU1
|
Support was added for the Cisco CVA122 Cable Voice Adapter.
|
12.2(2)XA
|
Support was added for the Cisco uBR925 cable access router.
|
12.2(15)CZ
|
Support for DOCSIS 1.1 and BPI+ operation was added for the Cisco uBR905 and Cisco uBR925 cable access routers, and the Cisco CVA122 Cable Voice Adapter.
|
Usage Guidelines
Baseline privacy key management exchanges take place only when both the router and the CMTS are running code images that support Baseline Privacy Interface (BPI) or BPI Plus (BPI+) encryption, and the privacy class of service is enabled via the configuration file that is downloaded to the router. Baseline privacy code images for the router contain k1, k8, or k9 in the code image name.
Examples
The following shows typical output for the show controllers cable-modem bpkm command for DOCSIS 1.0 BPI operation when the CMTS does not have baseline privacy enabled:
Router# show controllers cable-modem 0 bpkm
CM Baseline Privacy Key Management
configuration (in seconds):
authorization wait time: 10
reauthorization wait time: 10
authorization grace time: 600
authorization rej wait time: 60
kek state: STATE_B_AUTH_WAIT
tek state: No resources assigned
Table 104 describes the fields shown in the display.
Table 104 show controllers cable-modem bpkm Field Descriptions
Field
|
Description
|
authorization wait time
|
The number of seconds the router waits for a reply after sending the Authorization Request message to the CMTS.
|
reauthorization wait time
|
The number of seconds the router waits for a reply after it has sent an Authorization Request message to the CMTS in response to a reauthorization request or an Authorization Invalid message from the CMTS.
|
authorization grace time
|
The number of seconds before the current authorization is set to expire that the grace timer begins, signaling the router to begin the reauthorization process.
|
operational wait time
|
The number of seconds the Traffic Exchange Key (TEK) state machine waits for a reply from the CMTS after sending its initial Key Request for its SID's keying material.
|
rekey wait time
|
The number of seconds the TEK state machine waits for a replacement key for this Service ID (SID) after the TEK grace timer has expired and the request for a replacement key has been made.
|
tek grace time
|
The number of seconds before the current TEK is set to expire that the TEK grace timer begins, signaling the TEK state machine to request a replacement key.
|
authorization rej wait time
|
Number of seconds the router waits before sending another Authorization Request message to the CMTS after it has received an Authorization Reject message.
|
kek state
|
The current state of the key encryption key that the CMTS uses to encrypt the traffic encryption keys it sends to the router. See Table 106 for the possible values.
|
tek state
|
The current state of the traffic encryption key state machine for the specified SID. See Table 106 for the possible values.
|
The following shows typical output for the show controllers cable-modem bpkm command for DOCSIS 1.1 BPI+ operation when baseline privacy is enabled:
Router# show controllers cable-modem 0 bpkm
CM Baseline Privacy Key Management
Privacy Version: BPI+ (PLUS)
30819F30 0D06092A 864886F7 0D010101 05000381 8D003081 89028181 00E560B2
4F6777A1 731AF856 CE936615 BF513F15 44CE2D02 95167EAD 139FE25C C1E7D4E5
99B34020 D96608B2 A87C0AA1 C171B265 3E87FF7F F70FD3B1 AE96F0EE B2E75172
6B06F661 EA631817 0D317D6F 22FC733B F150E65F 44AE535A 5FB0532F 14519F3B
80A9D442 05D7B7EF 58A5993C 49BB5028 9A3A980A 36AEDC53 E762FA4D 63020301 01
keks: even 4184D17A0C0AEDA3 odd C07A8454DBAA7F1B
4E0A5108 A8451B24 BAC3A8CA D8DF459F 6D37448D
5D04EEDD 43129682 F7A474EA 4E9F888B 5EC18478
hmac downstream key even:
7B6595D6 75B435FB 2FA7204D 2F203CB1 FBA80950
E15FC10B 7F1BAFE8 6295315F E91FE97C F0DE3A73
configuration (in seconds):
authorization wait time: 5
reauthorization wait time: 30
authorization grace time: 60
authorization rej wait time: 60
kek state: STATE_C_AUTHORIZED
tek state: STATE_D_OPERATIONAL
keys: even 1730E9E1F0B1C4C, odd 23021AE604610E38
ivectors: even 16FB0175256819FD, odd B802057107302F8
Table 105 describes the fields shown in the display for BPI+ operation.
Table 105 show controllers cable-modem bpkm Field Descriptions (BPI+)
Field
|
Description
|
Privacy Version
|
Whether BPI or BPI+ is being run.
|
public key
|
The Diffie-Hellman public key that the router uses to establish a BPI+ session with the CMTS.
|
keks
|
The odd and even values for the key encryption key (KEK).
|
hmac upstream keys
|
The odd and even values for the hash message authentication code (HMAC) key used in upstream key requests.
|
hmac downstream keys
|
The odd and even values for the HMAC message authentication key used in downstream key replies, key rejects, and invalid TEK messages.
|
authorization wait time
|
The number of seconds the router waits for a reply after sending the Authorization Request message to the CMTS.
|
reauthorization wait time
|
The number of seconds the router waits for a reply after it has sent an Authorization Request message to the CMTS in response to a reauthorization request or an Authorization Invalid message from the CMTS.
|
authorization grace time
|
The number of seconds before the current authorization is set to expire that the grace timer begins, signaling the router to begin the reauthorization process.
|
operational wait time
|
The number of seconds the TEK state machine waits for a reply from the CMTS after sending its initial Key Request for its SID's keying material.
|
rekey wait time
|
The number of seconds the TEK state machine waits for a replacement key for this SID after the TEK grace timer has expired and the request for a replacement key has been made.
|
tek grace time
|
The number of seconds before the current TEK is set to expire that the TEK grace timer begins, signaling the TEK state machine to request a replacement key.
|
authorization rej wait time
|
Number of seconds the router waits before sending another Authorization Request message to the CMTS after it has received an Authorization Reject message.
|
sa map wait time
|
Number of seconds the router waits for a response after sending a Security Association (SA) map request before timing out and resending the request.
|
sa map retries
|
Number of times the router attempts an SA map request before it rejects the attempt to create a new downstream service flow.
|
kek state
|
The current state of the key encryption key that the CMTS uses to encrypt the traffic encryption keys it sends to the router. See Table 106 for the possible values.
|
tek state
|
The current state of the traffic encryption key state machine for the specified SID. See Table 106 for the possible values.
|
Table 106 describes the valid values for the kek state and tek state fields:
Table 106 State Values for KEK and TEK State Fields
State
|
Description
|
Key Encryption Key (KEK) States
|
STATE_A_START
|
The router is still completing the DOCSIS provisioning process. If this state persists, it indicates that BPI/BPI+ encryption was not enabled for the router in its DOCSIS configuration file.
|
STATE_B_AUTH_WAIT
|
DOCSIS provisioning has been completed, and the router has sent an authorization request to the CMTS and is waiting for a reply. If this state persists, it indicates that the CMTS has not enabled BPI/BPI+ operations.
|
STATE_C_AUTHORIZED
|
The router has received a valid authorized reply from the CMTS, completing the KEK exchange, and allowing the TEK exchange to begin.
|
STATE_D_REAUTH_WAIT
|
The router sent a reauthorization request and is waiting for the reply from the CMTS. A reauthorization request can be sent if the initial request is rejected, or when existing keys have expired and must be reacquired.
|
STATE_E_AUTH_REJ_WAIT
|
The router has received a nonpermanent authorization reject response from the CMTS and is waiting for the timeout period before sending another request.
|
STATE_F_SILENT
|
The router has received a permanent authorization reject response from the CMTS and has been placed in silent mode, in which it does not pass traffic but does accept SNMP management requests. (Valid only for BPI+ operations.)
|
Traffic Encryption Key (TEK) States
|
STATE_A_START
|
The router is still completing the DOCSIS provisioning process, or is still performing the KEK key exchange. If this state persists, it indicates that KEK authorization failed, or that BPI/BPI+ encryption was not enabled for the router in its DOCSIS configuration file.
|
STATE_B_OP_WAIT
|
The router has successfully completed the KEK key exchange, has sent a key request to the CMTS, and is waiting for a reply.
|
STATE_C_OP_REAUTH_WAIT
|
The router has sent a reauthorization request and is waiting for a reply, or the TEK key has been declared invalid. BPI/BPI+ encryption has not yet begun. If this state persists, it indicates that the TEK key exchange has failed.
|
STATE_D_OPERATIONAL
|
The router has completed the TEK key exchange, and BPI or BPI+ encryption is operational between the router and the CMTS.
|
STATE_E_REKEY_WAIT
|
The existing TEK keys have expired, and the router has requested a key update from the CMTS.
|
STATE_F_REKEY_REAUTH_WAIT
|
The router has requested a key update from the CMTS and is waiting for a reply. BPI/BPI+ encryption can continue using the existing keys until they expire.
|

Tip
In Cisco IOS Release 12.2(8)T and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Related Commands
Command
|
Description
|
show controllers cable-modem
|
Displays high-level controller information about the cable interface.
|
show controllers cable-modem crypto des
|
Displays information about the DES engine registers.
|
show controllers cable-modem filters
|
Displays the registers in the MAC hardware that are used for filtering received frames.
|
show controllers cable-modem lookup-table
|
Displays the mini-slot lookup table inside the cable interface.
|
show controllers cable-modem mac
|
Displays detailed MAC-layer information for the cable interface.
|
show controllers cable-modem phy
|
Displays the contents of the registers used in the downstream physical hardware for the cable interface.
|
show controllers cable-modem tuner
|
Displays the settings for the upstream and downstream tuners used by the cable interface.
|
show controllers cable-modem classifiers
To display the DOCSIS 1.1 classifiers currently in use on the router, use the show controllers cable-modem classifiers command in privileged EXEC mode.
Cisco uBR905 and uBR925 cable access routers, Cisco CVA122 Cable Voice Adapter
show controllers cable-modem number classifiers [classifier-id | summary]
Syntax Description
number
|
Identifies the cable interface (always 0).
|
classifier-id
|
(Optional) Displays information for a specific classifier. The valid range is 1 to 65535.
|
summary
|
(Optional) Displays a brief summary of all classifiers.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(15)CZ
|
This command was introduced for the Cisco uBR905 and Cisco uBR925 cable access routers, and the Cisco CVA122 Cable Voice Adapter.
|
Usage Guidelines
This command displays the classifiers that are currently defined for both the upstream and downstream. The information shown corresponds to the Quality of Service classifier parameters that are listed in Appendix C of the DOCSIS 1.1 specification.
Examples
The following example shows typical output for both upstream and downstream classifiers on the show controllers cable-modem classifiers command:
Router# show controllers cable-modem 0 classifiers
Upstream Packet Classifiers parameters
Service Flow Reference: 1
Source Mask: 255.255.255.255
Destination Address: 0.0.0.0
Destination Mask: 255.255.255.255
Destination Port Start: 0
Destination Port End: 65535
Destination MAC address: 0:0:0:0:0:0:0:0:0:0:0:0
Source MAC address: 0:0:0:0:0:0
Downstream Packet Classifiers parameters
Service Flow Reference: 6
Source Mask: 255.255.255.255
Destination Address: 0.0.0.0
Destination Mask: 255.255.255.255
Destination Port Start: 0
Destination Port End: 65535
Source MAC address: 0:0:0:0:0:0
Downstream Packet Classifiers parameters
Service Flow Reference: 7
Source Mask: 255.255.255.255
Destination Address: 0.0.0.0
Destination Mask: 255.255.255.255
Destination MAC address: 0:0:0:0:0:0:0:0:0:0:0:0
Source MAC address: 0:0:0:0:0:0
Downstream Packet Classifiers parameters
Service Flow Reference: 8
Source Mask: 255.255.255.255
Destination Address: 0.0.0.0
Destination Mask: 255.255.255.255
Destination Port Start: 0
Destination Port End: 65535
Destination MAC address: 0:0:0:0:0:0:0:0:0:0:0:0
Source MAC address: 0:0:0:0:0:0
The following shows the typical display for the summary option:
Router# show controllers cable-modem 0 classifiers summary
SFID SF Classifier Classifier Rule State
The following shows the detailed information that is displayed for a specific classifier:
Router# show controllers cable-modem 0 classifiers 4
Upstream Packet Classifiers parameters
Service Flow Reference: 1
Source Mask: 255.255.255.255
Destination Address: 6.0.0.1
Destination Mask: 255.255.255.255
Destination Port Start: 0
Destination Port End: 65535
Destination MAC address: 0:0:0:0:0:0:0:0:0:0:0:0
Source MAC address: 0:0:0:0:0:0
Table 107 describes the fields shown in the display.
Table 107 show controllers cable-modem classifiers Field Descriptions
Field
|
Description
|
Classifier Reference, Classifier Ref
|
The reference ID to uniquely identify the classifier in the DOCSIS configuration file and MAC management messages.
|
Classfier ID
|
The ID used to uniquely identify the classifier in each service flow.
|
Service Flow Reference, SF Ref
|
The reference ID that uniquely identifies the service flow.
|
Service Flow ID, SFID
|
The ID that uniquely identifies the service flow.
|
Rule Priority
|
The priority assigned to the classifier, 0 to 255, with a higher value indicating a higher priority.
|
Activation State, State
|
Whether the classifier is activate (1) or inactive (0).
|
Dynsrv Change Action
|
The action taken for this classifier in dynamic service change messages:
• 0 = Add the classifier.
• 1 = Replace the classifier.
• 2 = Delete the classifier.
|
SID
|
The service ID (SID) associated with this classifier.
|
IP Classifiers
|
ToS
|
The matching Type of Service (Tos) low byte, high byte, and masking value.
|
Protocol
|
The matching IP protocol type, as given in RFC 1700. A value of 256 matches any IP protocol, and a value of 257 matches TCP and UDP traffic.
|
Source Address and Source Mask
|
The matching IP source address, where the source address is ANDed with the source mask to specify the valid range of source addresses.
|
Destination Address and Destination Mask
|
The matching IP destination address, where the destination address is ANDed with the destination mask to specify the valid range of destination addresses.
|
Source Port Start and Source Port End
|
The low end and high end matching source TCP/UDP port values.
|
Destination Port Start and Destination Port End
|
The low end and high end matching destination TCP/UDP port values.
|
LLC Classifiers
|
Destination MAC address
|
The six-byte matching MAC destination address and six-byte mask. The first six bytes (address) are ANDed with the last six bytes (mask) to specify the valid range of MAC destination addresses.
|
Source MAC address
|
The six-byte matching MAC source address.
|
Ether Type
|
The one-byte Ethernet protocol type and two-byte matching layer 3 protocol ID in the Ether frame. The first byte can have the following values, which control the meaning of the following two bytes:
• 0x00 = no matching Ethernet protocol is required.
• 0x01 = Ethertype DIX or SNAP frames that match the two-byte packet type.
• 0x02 = non-SNAP IEEE 802.2 encapsulation frames that match the eight-bit packet type.
• 0x03 = MAC Management Messages with a type field between the two bytes, except that RNG_RSP, REG_REQ, REG_RSP, and REG_ACK frames are always matched.
• 0x04 = matches all data PDU packets, regardless of the two-byte protocol ID.
|
Related Commands
Command
|
Description
|
show controllers cable-modem phs
|
Displays the currently defined parameters for Payload Header Suppression (PHS) for the router.
|
show controllers cable-modem reg-rsp
|
Displays the information contained in the registration response (REG-RSP) message that the CMTS sent the router.
|
show controllers cable-modem service-flows
|
Displays the parameters for each of the service flows defined on the router's upstream and downstream.
|
show controllers cable-modem cmcert
To display the router's public key X.509 certificate, use the show controllers cable-modem cmcert command in privileged EXEC mode.
Cisco uBR905 and Cisco uBR925 cable access routers, and Cisco CVA122 Cable Voice Adapter
show controllers cable-modem number cmcert
Syntax Description
number
|
Identifies the cable interface (always 0).
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(15)CZ
|
This command was introduced on the Cisco uBR905 and Cisco uBR925 cable access routers, and the Cisco CVA122 Cable Voice Adapter.
|
Usage Guidelines
This command displays the router's X.509 DOCSIS cable-modem certificate, which uniquely identifies the router during the BPI+ negotiation process. This command shows the individual X.509 components of the certificate, starting with the DOCSIS restricted X.501 Distinguished Name and ending with the 1024-bit public key.
Tip
This command displays the certificate that is burned into the router at the factory and is not normally changed. The show controllers cable-modem manuf-cert command displays the manufacturer's certificate that is incorporated into the Cisco IOS image that the router is currently running. Upgrading the Cisco IOS image could also update the manufacturer's certificate.
Examples
The following example shows the starting lines and ending lines of typical output for the show controllers cable-modem cmcert command:
Router# show controllers cable-modem 0 cmcert
INT(10): 62 E0 07 47 00 00 00 00 FA 62
OID(9):SHA Signature 1.2.840.113549.1.1.5
OID(3):Organization 2.5.4.10
1w3d: PRT(13):Cisco Systems
OID(3):Organization Unit 2.5.4.11
OID(3):Common Name 2.5.4.3
1w3d: PRT(49):Cisco Cable Modem Root Certificate Authority R
1w3d: C7 9A A8 5C BD F3 30 5A E5 B6 66 1F 1E 3A C9 2E
1w3d: 04 5D B5 57 3E 75 ED A3 0A AB B6 5D 73 87 E9 BE
1w3d: ED 1A 68 7B B3 08 DA 0F E9 AA 05 28 E2 61 1B 3D
Note
You must manually enter a return to redisplay the router prompt after the certificate has been displayed.
Related Commands
show controllers cable-modem crypto des
To display information about the Data Encryption Standard (DES) engine registers, use the show controllers cable-modem des command in privileged EXEC mode.
Cisco uBR904, uBR905, uBR924, uBR925 cable access routers, Cisco CVA122 Cable Voice Adapter
show controllers cable-modem number crypto des
Syntax Description
number
|
Identifies the cable interface (always 0).
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.3(4)NA
|
This command was introduced, as show controllers cable-modem des, for the Cisco uBR904 cable access router.
|
12.0(4)XI1
|
Support was added for the Cisco uBR924 cable access router.
|
12.1(3)XL
|
Support was added for the Cisco uBR905 cable access router.
|
12.1(5)XU1
|
Support was added for the Cisco CVA122 Cable Voice Adapter.
|
12.2(2)XA
|
Support was added for the Cisco uBR925 cable access router.
|
12.2(X)BC
|
This command was renamed to show controllers cable-modem crypto des.
|
Examples
The following shows typical output for the show controllers cable-modem crypto des command.
Router# show controllers cable-modem 0 crypto des
sid_1=0x0000, sid_2=0x0000, sid_3=0x0000, sid_4=0x0000
ds_des_sid_enable=0x80, ds_des_ctrl=0x2E
ds_unencrypted_length=0x0C
pb_req_bytes_to_minislots=0x10
us_des_ctrl=0x00, us_des_sid_1= 0x1234
ds_unencrypted_length=0x0C
Table 108 describes the significant fields shown in the display. For more information, see the Broadcom documentation for the BCM3300 chip.
Table 108 show controllers cable-modem crypto des Field Descriptions
Field
|
Description
|
ds_des_key_table
|
Displays a table showing the downstream DES keys.
|
ds_des_cbc_iv_table
|
Displays a table showing the downstream DES Cipher Block Chaining (CBC) mode information.
|
ds_des_sid_table
|
Displays a table showing the SID values to be enabled for DES encryption.
|
ds_des_sid_enable
|
Identifies which SID entries in the SID table are enabled for encryption. In the above example, none of the entries are enabled for encryption.
|
ds_des_ctrl
|
Control register that identifies the operating mode of the downstream DES engine.
|
ds_des_sv
|
Displays the DES security version register; the range of the version field in the Baseline Privacy Interface (BPI) extended headers that will be accepted by the hardware. High byte is upper limit, low byte is lower limit. The router will accept versions 0 to 15.
|
ds_unencrypted_length
|
Specifies the number of bytes that will be unencrypted at the beginning of the MAC frame. 0x0C means the first 12 bytes are not encrypted, which is what the DOCSIS Baseline Privacy specification calls for.
|
us_des_key_table
|
Displays a table showing upstream DES keys.
|
us_des_cbc_iv_table
|
Displays a table of upstream DES CBC mode information.
|
us_des_ctrl
|
Control register that controls the operating mode of the upstream DES engine. The value 0x24 means that the upstream is configured to enable decryption and to use CBC mode.
|

Tip
In Cisco IOS Release 12.2(8)T and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Related Commands
Command
|
Description
|
show controllers cable-modem
|
Displays high-level controller information about the cable interface.
|
show controllers cable-modem bpkm
|
Displays information about the baseline privacy key management exchange between the cable interface and the CMTS.
|
show controllers cable-modem filters
|
Displays the registers in the MAC hardware that are used for filtering received frames.
|
show controllers cable-modem lookup-table
|
Displays the mini-slot lookup table for the cable interface.
|
show controllers cable-modem mac
|
Displays detailed MAC-layer information for the cable interface.
|
show controllers cable-modem phy
|
Displays the contents of the registers used in the downstream physical hardware for the cable interface.
|
show controllers cable-modem tuner
|
Displays the settings for the upstream and downstream tuners used by the cable interface.
|
show controllers cable-modem filters
To display the registers in the MAC hardware that are used for filtering received frames, use the show controllers cable-modem filters command in privileged EXEC mode.
Cisco uBR904, uBR905, uBR924, uBR925 cable access routers, Cisco CVA122 Cable Voice Adapter
show controllers cable-modem number filters
Syntax Description
number
|
Identifies the cable interface (always 0).
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.3(4)NA
|
This command was introduced for the Cisco uBR904 cable access router.
|
12.0(4)XI1
|
Support was added for the Cisco uBR924 cable access router.
|
12.1(3)XL
|
Support was added for the Cisco uBR905 cable access router.
|
12.1(5)XU1
|
Support was added for the Cisco CVA122 Cable Voice Adapter.
|
12.2(2)XA
|
Support was added for the Cisco uBR925 cable access router.
|
Usage Guidelines
Some of the filtering parameters are MAC hardware addresses, Service IDs (SIDs), and upstream channel IDs.
Examples
The following shows typical MAC and SID filter information displayed by the show controllers cable-modem filters command:
Router# show controllers cable-modem 0 filters
downstream mac message processing:
filter_1=0010.7b43.aa01, filter_2=0000.0000.0000
filter_3=0000.0000.0000, filter_4=0000.0000.0000
ds_mac_da_filter_ctrl=0x71, ds_mac_msg_sof=0x0000
sid_1=0x0000, sid_2=0x0000, sid_3=0x0000, sid_4=0x0000
ds_mac_filter_ctrl=0x00, us_channel_id=0x0000
ds_pid=0x0000, mac_msg_proto_ver=FF 00
downstream data processing:
filter_1 0010.7b43.aa01, filter_2 0000.0000.0000
filter_3 0000.0000.0000, filter_4 0000.0000.0000
ds_data_da_filter_ctrl=0x61, ds_pdu_sof=0xDEAD
us_ctrl_status=0x04, Minislots per request=0x01
map[0]=0 map[1]=0 map[2]=0 map[3]=0
bytes_per_minislot_exp=0x04
us_map_parser_minislot_adv=0x03, ticks_per_minislot=0x08, maint_xmit=0x0001
sid_1=0x0000, sid_2=0x0000, sid_3=0x0000, sid_4=0x0000
max_re_req=0x0010, rang_fifo=0x00
Table 109 describes the fields shown in the display. For more information, see the Broadcom documentation for the BCM3300 chip.
Table 109 show controllers cable-modem filters Field Descriptions
Field
|
Description
|
ds_mac_da_filters
|
MAC address of the cable interface and the MAC address of any Ethernet MAC it is bridging.
|
ds_mac_da_filter_ctrl
|
Downstream MAC filter control for data.
|
ds_mac_msg_sof
|
Downstream MAC message start of frame.
|
ds_mac_da_mc
|
Downstream MAC control filter for data.
|
map_parser_sids
|
Service IDs used for upstream bandwidth allocation.
|
ds_mac_filter_ctrl
|
Downstream MAC filter control for MAC messages.
|
us_channel_id
|
Upstream channel ID.
|
ds_pid
|
Downstream packet ID.
|
mac_msg_proto_ver
|
Version of the MAC management protocol in use.
|
reg_rang_req_sid
|
Service ID (SID) field of the ranging request message.
|
ds_data_da_filter_table
|
Downstream data processing filter table.
|
ds_data_da_filter_ctrl
|
Downstream data processing filter control.
|
ds_pdu_sof
|
Downstream PDU start of frame.
|
ds_data_da_mc
|
Downstream data processing MAC control.
|
us_ctrl_status
|
Upstream control status.
|
Minislots per request
|
Length of each registration request in mini-slots.
|
burst_maps
|
Maps the burst profiles saved in the BCM3037 registers to interval usage codes (IUCs).
|
bytes_per_minislot_exp
|
Number of bytes per expansion mini-slot.
|
ticks_per_minislot
|
Number of time ticks (6.25-microsecond intervals) in each upstream mini-slot.
|
maint_xmit
|
Number of initial maintenance transmit opportunities.
|
us_sid_table
|
Upstream service ID table.
|
max_re_req
|
Maximum number of registration re-requests allowed.
|
rang_fifo
|
Number of ranging requests that can be held in the first-in-first-out (FIFO) buffer.
|

Tip
In Cisco IOS Release 12.2(8)T and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Related Commands
Command
|
Description
|
show controllers cable-modem
|
Displays high-level controller information about the cable interface.
|
show controllers cable-modem bpkm
|
Displays information about the baseline privacy key management exchange between the cable interface and the CMTS.
|
show controllers cable-modem crypto des
|
Displays information about the Data Encryption Standard (DES) engine registers.
|
show controllers cable-modem lookup-table
|
Displays the mini-slot lookup table for the cable interface.
|
show controllers cable-modem mac
|
Displays detailed MAC-layer information for the cable interface.
|
show controllers cable-modem phy
|
Displays the contents of the registers used in the downstream physical hardware for the cable interface.
|
show controllers cable-modem tuner
|
Displays the settings for the upstream and downstream tuners used for the cable interface.
|
show controllers cable-modem lookup-table
To display the mini-slot lookup table for the router's cable interface, use the show controllers cable-modem lookup-table command in privileged EXEC mode.
Cisco uBR904, uBR905, uBR924, uBR925 cable access routers, Cisco CVA122 Cable Voice Adapter
show controllers cable-modem number lookup-table
Syntax Description
number
|
Identifies the cable interface (always 0).
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.3(4)NA
|
This command was introduced for the Cisco uBR904 cable access router.
|
12.0(4)XI1
|
Support was added for the Cisco uBR924 cable access router.
|
12.1(3)XL
|
Support was added for the Cisco uBR905 cable access router.
|
12.1(5)XU1
|
Support was added for the Cisco CVA122 Cable Voice Adapter.
|
12.2(2)XA
|
Support was added for the Cisco uBR925 cable access router.
|
Usage Guidelines
This command displays the details of the lookup table. The driver uses this table to convert the size of the packets that the router wants to transmit into a bandwidth request to the CMTS in mini-slots. The contents of this table are affected by the upstream symbol rate that is negotiated between the CMTS and the cable access router.
Use this table to look up the packet size and determine how many mini-slots will be needed.
Examples
The following shows a typical mini-slot lookup table as displayed by the show controllers cable-modem lookup-table command:
Router# show controllers cable-modem 0 lookup-table
Max Burst Size (minislots) = 0x6
Max Burst Length (bytes) = 0x4B
PHY Overhead Lookup Table:
000: 01 06 06 06 06 06 06 06 06 06 06 06 06 06 06 06
010: 06 06 06 06 06 06 06 06 06 06 06 06 06 06 06 06
020: 06 06 06 06 06 06 06 06 06 06 06 06 06 06 06 06
030: 06 06 06 06 06 06 06 06 06 06 06 06 06 06 06 06
040: 06 06 06 06 06 06 06 06 06 06 06 06 10 10 10 10
050: 10 10 10 10 10 10 10 10 10 10 10 10 10 10 10 10
060: 10 10 10 10 10 10 10 10 10 10 10 10 10 10 10 10
070: 10 10 10 10 10 10 10 10 10 10 10 10 10 10 10 10
080: 10 10 10 10 10 10 10 10 10 10 10 10 10 10 10 10
090: 10 10 10 10 10 10 10 10 10 10 10 10 10 10 10 10
0A0: 10 10 10 10 10 10 10 10 10 10 10 10 10 10 10 10
0B0: 10 10 10 10 10 10 10 10 10 10 10 10 10 10 10 10
0C0: 10 10 10 10 10 10 10 10 10 10 10 10 10 10 10 10
0D0: 10 10 10 10 10 10 10 10 10 10 10 10 10 1F 1F 1F
0E0: 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F
0F0: 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F
100: 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F
110: 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F
120: 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F
130: 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F
140: 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F
150: 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F
160: 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F
170: 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F
180: 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F
190: 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F
1A0: 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F 1F
1B0: 1F 1F 1F 1F 1F 1F 1F 1F 1F 2D 2D 2D 2D 2D 2D 2D
1C0: 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D
1D0: 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D
1E0: 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D
1F0: 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D
200: 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D
210: 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D
220: 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D
230: 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D
240: 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D
250: 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D
260: 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D
270: 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D
280: 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D 2D
290: 2D 2D 2D 2D 2D 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C
2A0: 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C
2B0: 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C
2C0: 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C
2D0: 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C
2E0: 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C
2F0: 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C
300: 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C
310: 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C
320: 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C
330: 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C
340: 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C
350: 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C
360: 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C 3C
370: 3C 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B
380: 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B
390: 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B
3A0: 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B
3B0: 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B
3C0: 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B
3D0: 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B
3E0: 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B
3F0: 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B
400: 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B
410: 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B
420: 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B
430: 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B
440: 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 4B 5A 5A 5A
450: 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A
460: 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A
470: 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A
480: 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A
490: 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A
4A0: 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A
4B0: 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A
4C0: 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A
4D0: 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A
4E0: 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A
4F0: 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A
500: 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A
510: 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A 5A
520: 5A 5A 5A 5A 5A 5A 5A 5A 5A 68 68 68 68 68 68 68
530: 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68
540: 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68
550: 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68
560: 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68
570: 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68
580: 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68
590: 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68
5A0: 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68
5B0: 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68
5C0: 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68
5D0: 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68
5E0: 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68
5F0: 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68 68
600: 68 68 68 68 68 77 77 77 77 77 77 77 77 77 77 77
610: 77 77 77 77 77 77 77 77 77 77 77 77 77 77 77 77
620: 77 77 77 77 77 77 77 77 77 77 77 77 77 77 77 77
630: 77 77 77 77 77 77 77 77 77 77 77 77 77 77 77 77
PHY Reverse Lookup Table:
00: 0000 0000 0000 0000 0000 0000 004B 0000
08: 0000 0000 0000 0000 0000 0000 0000 0000
10: 00DC 00DC 00DC 00DC 00DC 00DC 00DC 00DC
18: 00DC 00DC 00DC 00DC 00DC 00DC 00DC 01B8
20: 01B8 01B8 01B8 01B8 01B8 01B8 01B8 01B8
28: 01B8 01B8 01B8 01B8 01B8 0294 0294 0294
30: 0294 0294 0294 0294 0294 0294 0294 0294
38: 0294 0294 0294 0294 0370 0370 0370 0370
40: 0370 0370 0370 0370 0370 0370 0370 0370
48: 0370 0370 0370 044C 044C 044C 044C 044C
50: 044C 044C 044C 044C 044C 044C 044C 044C
58: 044C 044C 0528 0528 0528 0528 0528 0528
60: 0528 0528 0528 0528 0528 0528 0528 0528
68: 0604 0604 0604 0604 0604 0604 0604 0604
70: 0604 0604 0604 0604 0604 0604 0604 06E0
78: 06E0 06E0 06E0 06E0 06E0 06E0 06E0 06E0
80: 06E0 06E0 06E0 06E0 06E0 06E0 07BC 07BC
88: 07BC 07BC 07BC 07BC 07BC 07BC 07BC 07BC
90: 07BC 07BC 07BC 07BC 07BC 0898 0898 0898
98: 0898 0898 0898 0898 0898 0898 0898 0898
A0: 0898 0898 0898 0974 0974 0974 0974 0974
A8: 0974 0974 0974 0974 0974 0974 0974 0974
B0: 0974 0974 0A50 0A50 0A50 0A50 0A50 0A50
B8: 0A50 0A50 0A50 0A50 0A50 0A50 0A50 0A50
C0: 0A50 0B2C 0B2C 0B2C 0B2C 0B2C 0B2C 0B2C
C8: 0B2C 0B2C 0B2C 0B2C 0B2C 0B2C 0B2C 0B2C
D0: 0C08 0C08 0C08 0C08 0C08 0C08 0C08 0C08
D8: 0C08 0C08 0C08 0C08 0C08 0C08 0CE4 0CE4
E0: 0CE4 0CE4 0CE4 0CE4 0CE4 0CE4 0CE4 0CE4
E8: 0CE4 0CE4 0CE4 0CE4 0CE4 0DC0 0DC0 0DC0
F0: 0DC0 0DC0 0DC0 0DC0 0DC0 0DC0 0DC0 0DC0
F8: 0DC0 0DC0 0DC0 0DC0 0E9C 0E9C 0E9C 0E9C
Tip
In Cisco IOS Release 12.2(8)T and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Related Commands
Command
|
Description
|
show controllers cable-modem
|
Displays high-level controller information about the cable interface.
|
show controllers cable-modem bpkm
|
Displays information about the baseline privacy key management exchange between the cable interface and the CMTS.
|
show controllers cable-modem crypto des
|
Displays information about the Data Encryption Standard (DES) engine registers.
|
show controllers cable-modem filters
|
.Displays the registers in the MAC hardware that are used for filtering received frames.
|
show controllers cable-modem mac
|
Displays detailed MAC-layer information for the cable interface.
|
show controllers cable-modem phy
|
Displays the contents of the registers used in the downstream physical hardware of the cable interface.
|
show controllers cable-modem tuner
|
Displays the settings for the upstream and downstream tuners used by the cable interface.
|
show controllers cable-modem mac
To display detailed MAC-layer information for the router's cable interface, use the show controllers cable-modem mac command in privileged EXEC mode.
Cisco uBR904, uBR905, uBR924, uBR925 cable access routers, Cisco CVA122 Cable Voice Adapter
show controllers cable-modem number mac {errors | hardware | log | resets | state}
Syntax Description
number
|
Identifies the cable interface (always 0).
|
errors
|
Displays a log of the error events that are reported to SNMP. This keyword enables you to look at the error events without accessing a MIB.
|
hardware
|
Displays all MAC hardware registers.
|
log
|
Displays a history of MAC log messages, up to 1023 entries. This is the same output that is displayed when using the debug cable-modem mac log command.
|
resets
|
Extracts all of the reset causes out of the MAC log file and summarizes them in a mini report.
|
state
|
Displays a summary of the MAC state.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.3(4)NA
|
This command was introduced for the Cisco uBR904 cable access router.
|
12.0(4)XI1
|
Support was added for the Cisco uBR924 cable access router.
|
12.1(3)XL
|
Support was added for the Cisco uBR905 cable access router.
|
12.1(5)XU1
|
Support was added for the Cisco CVA122 Cable Voice Adapter.
|
12.2(2)XA
|
Support was added for the Cisco uBR925 cable access router.
|
12.2(15)CZ
|
Support for DOCSIS 1.1 and BPI+ operation was added to the state option for the Cisco uBR905 and Cisco uBR925 cable access routers, and the Cisco CVA122 Cable Voice Adapter.
|
Usage Guidelines
MAC log messages are written to a circular log file even when debugging is not turned on. These messages include timestamps, events, and information pertinent to these events. Use the show controllers cable-modem mac log command to view MAC log messages.
If the router interface fails to come up or resets periodically, the MAC log will capture what happened. For example, if an address is not obtained from the DHCP server, an error is logged, initialization starts over, and the router scans for a downstream frequency.
The most useful keywords for troubleshooting a router are log, errors, and resets. See the following examples for typical outputs for these options.
Examples
The following shows a typical display of the MAC log file for a cable interface that has successfully registered with the CMTS:
Router# show controllers cable-modem 0 mac log
00:14:24: 864.124 CMAC_LOG_DRIVER_INIT_IDB_RESET 0x080B7430
00:14:24: 864.128 CMAC_LOG_LINK_DOWN
00:14:24: 864.132 CMAC_LOG_RESET_FROM_DRIVER
00:14:24: 864.134 CMAC_LOG_STATE_CHANGE wait_for_link_up_state
00:14:24: 864.138 CMAC_LOG_LINK_UP
00:14:24: 864.142 CMAC_LOG_STATE_CHANGE ds_channel_scanning_state
00:14:24: 864.270 CMAC_LOG_WILL_SEARCH_DS_FREQUENCY_BAND
81/453000000/855000000/6000000
00:14:24: 864.276 CMAC_LOG_WILL_SEARCH_DS_FREQUENCY_BAND
82/93000000/105000000/6000000
00:14:24: 864.280 CMAC_LOG_WILL_SEARCH_DS_FREQUENCY_BAND
83/111025000/117025000/6000000
00:14:24: 864.286 CMAC_LOG_WILL_SEARCH_DS_FREQUENCY_BAND
84/231012500/327012500/6000000
00:14:24: 864.290 CMAC_LOG_WILL_SEARCH_DS_FREQUENCY_BAND
85/333025000/333025000/6000000
00:14:24: 864.294 CMAC_LOG_WILL_SEARCH_DS_FREQUENCY_BAND
86/339012500/399012500/6000000
00:14:24: 864.300 CMAC_LOG_WILL_SEARCH_DS_FREQUENCY_BAND
87/405000000/447000000/6000000
00:14:24: 864.304 CMAC_LOG_WILL_SEARCH_DS_FREQUENCY_BAND
88/123012500/129012500/6000000
00:14:24: 864.310 CMAC_LOG_WILL_SEARCH_DS_FREQUENCY_BAND
89/135012500/135012500/6000000
00:14:24: 864.314 CMAC_LOG_WILL_SEARCH_DS_FREQUENCY_BAND
90/141000000/171000000/6000000
00:14:24: 864.320 CMAC_LOG_WILL_SEARCH_DS_FREQUENCY_BAND
91/219000000/225000000/6000000
00:14:24: 864.324 CMAC_LOG_WILL_SEARCH_DS_FREQUENCY_BAND
92/177000000/213000000/6000000
00:14:24: 864.330 CMAC_LOG_WILL_SEARCH_DS_FREQUENCY_BAND
93/55752700/67753300/6000300
00:14:24: 864.334 CMAC_LOG_WILL_SEARCH_DS_FREQUENCY_BAND
94/79753900/85754200/6000300
00:14:24: 864.340 CMAC_LOG_WILL_SEARCH_DS_FREQUENCY_BAND
95/175758700/211760500/6000300
00:14:24: 864.344 CMAC_LOG_WILL_SEARCH_DS_FREQUENCY_BAND
96/121756000/169758400/6000300
00:14:24: 864.348 CMAC_LOG_WILL_SEARCH_DS_FREQUENCY_BAND
97/217760800/397769800/6000300
00:14:24: 864.354 CMAC_LOG_WILL_SEARCH_DS_FREQUENCY_BAND
98/73753600/115755700/6000300
00:14:24: 864.358 CMAC_LOG_WILL_SEARCH_DS_FREQUENCY_BAND
99/403770100/997799800/6000300
00:14:24: 864.364 CMAC_LOG_WILL_SEARCH_SAVED_DS_FREQUENCY 213000000
00:14:25: 865.450 CMAC_LOG_UCD_MSG_RCVD 1
00:14:25: %LINK-3-UPDOWN: Interface cable-modem0, changed state to up
00:14:26: 866.200 CMAC_LOG_DS_64QAM_LOCK_ACQUIRED 213000000
00:14:26: 866.204 CMAC_LOG_DS_CHANNEL_SCAN_COMPLETED
00:14:26: 866.206 CMAC_LOG_STATE_CHANGE wait_ucd_state
00:14:26: %LINEPROTO-5-UPDOWN: Line protocol on Interface cable-modem0, changed state to
down
00:14:27: 867.456 CMAC_LOG_UCD_MSG_RCVD 1
00:14:29: 869.470 CMAC_LOG_UCD_MSG_RCVD 1
00:14:29: 869.472 CMAC_LOG_ALL_UCDS_FOUND
00:14:29: 869.476 CMAC_LOG_STATE_CHANGE wait_map_state
00:14:29: 869.480 CMAC_LOG_UCD_NEW_US_FREQUENCY 20000000
00:14:29: 869.484 CMAC_LOG_SLOT_SIZE_CHANGED 8
00:14:29: 869.564 CMAC_LOG_FOUND_US_CHANNEL 1
00:14:31: 871.484 CMAC_LOG_UCD_MSG_RCVD 1
00:14:31: 871.692 CMAC_LOG_MAP_MSG_RCVD
00:14:31: 871.694 CMAC_LOG_INITIAL_RANGING_MINISLOTS 40
00:14:31: 871.696 CMAC_LOG_STATE_CHANGE ranging_1_state
00:14:31: 871.700 CMAC_LOG_RANGING_OFFSET_SET_TO 9610
00:14:31: 871.704 CMAC_LOG_POWER_LEVEL_IS 32.0 dBmV (commanded)
00:14:31: 871.708 CMAC_LOG_STARTING_RANGING
00:14:31: 871.710 CMAC_LOG_RANGING_BACKOFF_SET 0
00:14:31: 871.714 CMAC_LOG_RNG_REQ_QUEUED 0
00:14:32: 872.208 CMAC_LOG_RNG_REQ_TRANSMITTED
00:14:32: 872.216 CMAC_LOG_RNG_RSP_MSG_RCVD
00:14:32: 872.218 CMAC_LOG_RNG_RSP_SID_ASSIGNED 16
00:14:32: 872.222 CMAC_LOG_ADJUST_RANGING_OFFSET 2853
00:14:32: 872.224 CMAC_LOG_RANGING_OFFSET_SET_TO 12463
00:14:32: 872.228 CMAC_LOG_ADJUST_TX_POWER 8
00:14:32: 872.230 CMAC_LOG_POWER_LEVEL_IS 34.0 dBmV (commanded)
00:14:32: 872.234 CMAC_LOG_STATE_CHANGE ranging_2_state
00:14:32: 872.238 CMAC_LOG_RNG_REQ_QUEUED 16
00:14:32: 872.848 CMAC_LOG_RNG_REQ_TRANSMITTED
00:14:32: 872.852 CMAC_LOG_RNG_RSP_MSG_RCVD
00:14:32: 872.856 CMAC_LOG_RANGING_SUCCESS
00:14:32: 872.874 CMAC_LOG_STATE_CHANGE dhcp_state
00:14:33: 873.386 CMAC_LOG_DHCP_ASSIGNED_IP_ADDRESS 188.188.1.62
00:14:33: 873.388 CMAC_LOG_DHCP_TFTP_SERVER_ADDRESS 4.0.0.32
00:14:33: 873.392 CMAC_LOG_DHCP_TOD_SERVER_ADDRESS 4.0.0.32
00:14:33: 873.396 CMAC_LOG_DHCP_SET_GATEWAY_ADDRESS
00:14:33: 873.398 CMAC_LOG_DHCP_TZ_OFFSET 60
00:14:33: 873.402 CMAC_LOG_DHCP_CONFIG_FILE_NAME platinum.cm
00:14:33: 873.406 CMAC_LOG_DHCP_ERROR_ACQUIRING_SEC_SVR_ADDR
00:14:33: 873.410 CMAC_LOG_DHCP_COMPLETE
00:14:33: 873.536 CMAC_LOG_STATE_CHANGE establish_tod_state
00:14:33: 873.546 CMAC_LOG_TOD_REQUEST_SENT
00:14:33: 873.572 CMAC_LOG_TOD_REPLY_RECEIVED 3140961992
00:14:33: 873.578 CMAC_LOG_TOD_COMPLETE
00:14:33: 873.582 CMAC_LOG_STATE_CHANGE
security_association_state
00:14:33: 873.584 CMAC_LOG_SECURITY_BYPASSED
00:14:33: 873.588 CMAC_LOG_STATE_CHANGE configuration_file_state
00:14:33: 873.592 CMAC_LOG_LOADING_CONFIG_FILE platinum.cm
00:14:34: %LINEPROTO-5-UPDOWN: Line protocol on Interface cable-modem0, changed state to
up
00:14:34: 874.728 CMAC_LOG_CONFIG_FILE_PROCESS_COMPLETE
00:14:34: 874.730 CMAC_LOG_STATE_CHANGE registration_state
00:14:34: 874.734 CMAC_LOG_REG_REQ_MSG_QUEUED
00:14:34: 874.744 CMAC_LOG_REG_REQ_TRANSMITTED
00:14:34: 874.754 CMAC_LOG_REG_RSP_MSG_RCVD
00:14:34: 874.756 CMAC_LOG_COS_ASSIGNED_SID 1/16
00:14:34: 874.760 CMAC_LOG_RNG_REQ_QUEUED 16
00:14:34: 874.768 CMAC_LOG_REGISTRATION_OK
:14:34: 874.770 CMAC_LOG_REG_RSP_ACK_MSG_QUEUED 0
00:14:34: 874.774 CMAC_LOG_STATE_CHANGE establish_privacy_state
00:14:34: 874.778 CMAC_LOG_PRIVACY_NOT_CONFIGURED
00:14:34: 874.780 CMAC_LOG_STATE_CHANGE maintenance_state
00:14:34: 874.784 CMAC_LOG_REG_RSP_ACK_MESSAGE_EVENT
00:14:34: 874.788 CMAC_LOG_REG_RSP_ACK_MSG_SENT
The following example gives the typical error messages that appear in the MAC log when the DHCP server cannot not be reached:
Router# show controllers cable-modem 0 mac log
00:14:32: 872.874 CMAC_LOG_STATE_CHANGE dhcp_state
00:14:33: 873.386 CMAC_LOG_RNG_REQ_TRANSMITTED
00:14:33: 873.388 CMAC_LOG_RNG_RSP_MSG_RCVD
00:14:33: 873.386 CMAC_LOG_RNG_REQ_TRANSMITTED
00:14:33: 873.392 CMAC_LOG_RNG_RSP_MSG_RCVD
00:14:33: 873.396 CMAC_LOG_WATCHDOG_TIMER
00:14:33: 873.398 CMAC_LOG_RESET_DHCP_WATCHDOG_EXPIRED
00:14:33: 873.402 CMAC_LOG_STATE_CHANGE reset_interface_state
00:14:33: 873.406 CMAC_LOG_DHCP_PROCESS_KILLED
In this situation, use the MAC error display also contains information indicating that the DHCP server could not be reached:
Router# show controllers cable-modem 0 mac errors
497989.804 D01.0 Discover sent no Offer received. No available DHCP Server.
498024.046 D01.0 Discover sent no Offer received. No available DHCP Server.
498058.284 D01.0 Discover sent no Offer received. No available DHCP Server.
The following is a typical display of the MAC error log information, which is the same information that is also available using SNMP:
Router# show controllers cable-modem 0 mac errors
74373.574 R02.0 No Ranging Response received. T3 time-out.
74374.660 R02.0 No Ranging Response received. T3 time-out.
74375.508 R02.0 No Ranging Response received. T3 time-out.
74375.748 R02.0 No Ranging Response received. T3 time-out.
74375.748 R03.0 Ranging Request Retries exhausted.
74376.112 R02.0 No Ranging Response received. T3 time-out.
74376.354 R02.0 No Ranging Response received. T3 time-out.
74376.778 R02.0 No Ranging Response received. T3 time-out.
74377.442 R02.0 No Ranging Response received. T3 time-out.
This output indicates that the router acquired a downstream lock, successfully read a UCD, and successfully read a MAP. However, it was unable to communicate with the CMTS after ranging through all upstream transmit power levels. The router will try to communicate with the CMTS 16 times, and if cannot receive a response from the CMTS, it will reset the cable interface to try to find a better downstream frequency.
The show controllers cable-modem 0 mac resets command shows only the entries in the MAC log that begin with the field CMAC_LOG_RESET. These fields provide you with a summary of the most recent reasons why the cable interface was reset.
Reset messages and brief explanations are included in the following examples. However, the reset messages do not commonly occur.
The following example shows the errors that are logged when the configuration file downloaded from the TFTP server could not be read, typically because the file might not exist, or because the file might have incorrect permissions.
Router# show controllers cable-modem 0 mac resets
62526.114 CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
62564.368 CMAC_LOG_RESET_T4_EXPIRED
62677.178 CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
62717.462 CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
62757.746 CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
62796.000 CMAC_LOG_RESET_T4_EXPIRED
62908.808 CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
62949.092 CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
62989.380 CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
63029.662 CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
63069.944 CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
63110.228 CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
63148.484 CMAC_LOG_RESET_T4_EXPIRED
63261.296 CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
The following example shows that the DHCP server could not be reached, or that it took too long to respond.
Router# show controllers cable-modem 0 mac resets
497989.804 CMAC_LOG_RESET_DHCP_WATCHDOG_EXPIRED
498024.046 CMAC_LOG_RESET_DHCP_WATCHDOG_EXPIRED
498058.284 CMAC_LOG_RESET_DHCP_WATCHDOG_EXPIRED
The following example indicates that an event in the cable interface driver caused the interface to reset. This often occurs because a shutdown command was just issued on the interface.
Router# show controllers cable-modem 0 mac resets
527986.444 CMAC_LOG_RESET_FROM_DRIVER
528302.042 CMAC_LOG_RESET_FROM_DRIVER
528346.600 CMAC_LOG_RESET_FROM_DRIVER
528444.494 CMAC_LOG_RESET_FROM_DRIVER
Table 110 describes the status messages that can appear in the show controllers cable-modem mac resets command.
Table 110 show controllers cable-modem mac resets Field Descriptions
Message
|
Description
|
CMAC_LOG_RESET_CONFIG_FILE_PARSE_FAILED
|
The format of the DOCSIS configuration file acquired from the TFTP server is not acceptable.
|
CMAC_LOG_RESET_LOSS_OF_SYNC
|
Synchronization with the CMTS has been lost (SYNC messages are not being received).
|
CMAC_LOG_RESET_T4_EXPIRED
|
The maintenance ranging opportunities for this router are not being received from the CMTS.
|
CMAC_LOG_RESET_DHCP_WATCHDOG_EXPIRED
|
The DHCP server took too long to respond.
|
CMAC_LOG_RESET_TOD_WATCHDOG_EXPIRED
|
The Time-of-Day (ToD) server took too long to respond.
|
CMAC_LOG_RESET_PRIVACY_WATCHDOG_EXPIRED
|
The baseline privacy exchange with the CMTS took too long.
|
CMAC_LOG_RESET_CHANGE_US_WATCHDOG_EXPIRED
|
The router was unable to transmit a response to a UCC-REQ message.
|
CMAC_LOG_RESET_SECURITY_WATCHDOG_EXPIRED
|
A "full security" exchange with the CMTS took too long.
|
CMAC_LOG_RESET_CONFIG_FILE_WATCHDOG_EXPIRED
|
The TFTP server took too long to respond.
|
CMAC_LOG_RESET_ALL_FREQUENCIES_SEARCHED
|
All downstream frequencies to be searched have been searched.
Note This message indicates that downstream frequencies were found, but the router failed to acquire a downstream lock.
|
CMAC_LOG_RESET_T2_EXPIRED
|
Initial ranging opportunities are not being received.
|
CMAC_LOG_RESET_T3_RETRIES_EXHAUSTED
|
The CMTS failed too many times to respond to a RNG-REQ message.
Note After 16 T3 timeouts, the router will reset the cable interface.
|
CMAC_LOG_RESET_RANGING_ABORTED
|
The CMTS commanded the router to abort the ranging process.
|
CMAC_LOG_RESET_NO_MEMORY
|
The router has run out of memory.
|
CMAC_LOG_RESET_CANT_START_PROCESS
|
The router was unable to start an internal process necessary to complete ranging and registration.
|
CMAC_LOG_RESET_CONFIG_FILE_READ_FAILED
|
The reading of the configuration file from the TFTP server failed.
Note The file might not exist, or it might have incorrect permissions.
|
CMAC_LOG_RESET_AUTHENTICATION_FAILURE
|
The router failed authentication as indicated in a REG-RSP message from the CMTS.
|
CMAC_LOG_RESET_SERVICE_NOT_AVAILABLE
|
The CMTS has failed the router's registration because a required or requested class of service is not available.
|
CMAC_LOG_RESET_T6_RETRIES_EXHAUSTED
|
The CMTS failed too many times to respond to a REG-REQ message.
|
CMAC_LOG_RESET_MAINTENANCE_WATCHDOG_DRIVER
|
The router MAC layer failed to detect a change in the interface driver.
|
CMAC_LOG_RESET_NET_ACCESS_MISSING
|
The Network Access parameter is missing from the DOCSIS configuration file.
|
CMAC_LOG_RESET_FAILED_WRITE_ACCESS_CONTROL
|
The router was unable to set the Write Access Control for an SNMP parameter as specified by the DOCSIS configuration file.
|
CMAC_LOG_RESET_DHCP_FAILED
|
The DHCP server did not respond with all the required values. The required values are: IP address, network mask, TFTP server IP address, TOD server IP address, DOCSIS configuration file name, and time zone offset.
|
CMAC_LOG_RESET_CANT_START_DS_TUNER_PRCESS
|
The router was unable to start the internal process used to manage the downstream tuner.
|
CMAC_LOG_RESET_TOO_MANY_DS_LOCKS_LOST
|
Downstream QAM/FEC lock has been lost too many times.
|
CMAC_LOG_RESET_NO_SEND_TO_DS_TUNER_PROCESS
|
The router MAC-layer process was unable to communicate with the downstream tuner management process.
|
CMAC_LOG_RESET_DS_TUNER_WATCHDOG
|
The downstream tuner process failed to report its continuing operation for a long period of time.
|
CMAC_LOG_RESET_UNABLE_TO_SET_MIB_OBJECT
|
The router was unable to set an SNMP parameter as specified by the DOCSIS configuration file.
|
CMAC_LOG_RESET_MIB_OBJECT_PROCESS_WATCHDOG
|
The internal MIB object took too long to process the entries in the DOCSIS configuration file.
|
The following example is a typical display for the show controllers cable-modem 0 mac hardware command. The most interesting bit is the station address (hardware address). The MIB statistics reflect the MAC hardware counters for various events, but these counters are typically reset every few seconds, so their contents are not accurate in this display.
Router# show controllers cable-modem 0 mac hardware
BCM3300 unit 0, idb 0x200EB4, ds 0x82D4748, regaddr = 0x800000, reset_mask
station address 0010.7b43.aa01 default station address 0010.7b43.aa01
MAC mcfilter 01E02F00 data mcfilter 01000000
RX data PDU ring with 32 entries at 0x201D40
rx_head = 0x201D40 (0), rx_p = 0x82D4760 (0)
00 pak=0x82DF844 buf=0x227F1A status=0x80 pak_size=0
01 pak=0x82E0BF4 buf=0x22C56A status=0x80 pak_size=0
02 pak=0x82DF454 buf=0x22710A status=0x80 pak_size=0
03 pak=0x82DF64C buf=0x227812 status=0x80 pak_size=0
04 pak=0x82E0024 buf=0x229B3A status=0x80 pak_size=0
05 pak=0x82DBF2C buf=0x21B332 status=0x80 pak_size=0
06 pak=0x82DFE2C buf=0x229432 status=0x80 pak_size=0
07 pak=0x82E0FE4 buf=0x22D37A status=0x80 pak_size=0
08 pak=0x82DF064 buf=0x2262FA status=0x80 pak_size=0
09 pak=0x82DEC74 buf=0x2254EA status=0x80 pak_size=0
10 pak=0x82DEA7C buf=0x224DE2 status=0x80 pak_size=0
11 pak=0x82DE884 buf=0x2246DA status=0x80 pak_size=0
12 pak=0x82DE68C buf=0x223FD2 status=0x80 pak_size=0
13 pak=0x82DE494 buf=0x2238CA status=0x80 pak_size=0
14 pak=0x82DE29C buf=0x2231C2 status=0x80 pak_size=0
15 pak=0x82DE0A4 buf=0x222ABA status=0x80 pak_size=0
16 pak=0x82DDEAC buf=0x2223B2 status=0x80 pak_size=0
17 pak=0x82DDCB4 buf=0x221CAA status=0x80 pak_size=0
18 pak=0x82DDABC buf=0x2215A2 status=0x80 pak_size=0
19 pak=0x82DD8C4 buf=0x220E9A status=0x80 pak_size=0
20 pak=0x82DD6CC buf=0x220792 status=0x80 pak_size=0
21 pak=0x82DD4D4 buf=0x22008A status=0x80 pak_size=0
22 pak=0x82DD2DC buf=0x21F982 status=0x80 pak_size=0
23 pak=0x82DD0E4 buf=0x21F27A status=0x80 pak_size=0
24 pak=0x82DCEEC buf=0x21EB72 status=0x80 pak_size=0
25 pak=0x82DCCF4 buf=0x21E46A status=0x80 pak_size=0
26 pak=0x82DCAFC buf=0x21DD62 status=0x80 pak_size=0
27 pak=0x82DC904 buf=0x21D65A status=0x80 pak_size=0
28 pak=0x82DC70C buf=0x21CF52 status=0x80 pak_size=0
29 pak=0x82DC514 buf=0x21C84A status=0x80 pak_size=0
30 pak=0x82DC31C buf=0x21C142 status=0x80 pak_size=0
31 pak=0x82DC124 buf=0x21BA3A status=0xA0 pak_size=0
RX MAC message ring with 8 entries at 0x201E80
rx_head_mac = 0x201EB0 (6), rx_p_mac = 0x82D480C (6)
00 pak=0x82E0DEC buf=0x22CC72 status=0x80 pak_size=0
01 pak=0x82E021C buf=0x22A242 status=0x80 pak_size=0
02 pak=0x82E060C buf=0x22B052 status=0x80 pak_size=0
03 pak=0x82E11DC buf=0x22DA82 status=0x80 pak_size=0
04 pak=0x82DFC34 buf=0x228D2A status=0x80 pak_size=0
05 pak=0x82E09FC buf=0x22BE62 status=0x80 pak_size=0
06 pak=0x82DEE6C buf=0x225BF2 status=0x80 pak_size=0
07 pak=0x82DFA3C buf=0x228622 status=0xA0 pak_size=0
TX BD ring with 8 entries at 0x201FB8, tx_count = 0
tx_head = 0x201FB8 (0), head_txp = 0x82D4888 (0)
tx_tail = 0x201FB8 (0), tail_txp = 0x82D4888 (0)
00 pak=0x000000 buf=0x200000 status=0x00 pak_size=0
01 pak=0x000000 buf=0x200000 status=0x00 pak_size=0
02 pak=0x000000 buf=0x200000 status=0x00 pak_size=0
03 pak=0x000000 buf=0x200000 status=0x00 pak_size=0
04 pak=0x000000 buf=0x200000 status=0x00 pak_size=0
05 pak=0x000000 buf=0x200000 status=0x00 pak_size=0
06 pak=0x000000 buf=0x200000 status=0x00 pak_size=0
07 pak=0x000000 buf=0x200000 status=0x20 pak_size=0
TX PD ring with 8 entries at 0x202038, tx_count = 0
tx_head_pd = 0x202038 (0)
tx_tail_pd = 0x202038 (0)
00 status=0x00 bd_index=0x0000 len=0x0000 hdr_len=0x0000
01 status=0x00 bd_index=0x0001 len=0x0000 hdr_len=0x0000
02 status=0x00 bd_index=0x0002 len=0x0000 hdr_len=0x0000
03 status=0x00 bd_index=0x0003 len=0x0000 hdr_len=0x0000
04 status=0x00 bd_index=0x0004 len=0x0000 hdr_len=0x0000
05 status=0x00 bd_index=0x0005 len=0x0000 hdr_len=0x0000
06 status=0x00 bd_index=0x0006 len=0x0000 hdr_len=0x0000
07 status=0x20 bd_index=0x0007 len=0x0000 hdr_len=0x0000
DS fifo full = 0, Rerequests = 0
DS mac msg overruns = 0, DS data overruns = 0
Qualified maps = 0, Qualified syncs = 0
CRC fails = 0, HDR chk fails = 0
Data pdus = 0, Mac msgs = 0
ds_data_bd_base=0x001D40, ds_mac_bd_base=0x001E80
ds_data_dma_ctrl=0x98, ds_mac_dma_ctrl=0x98
ds_dma_data_index=0x0000, ds_dma_msg_index=0x0000
us_bd_base=0x001FB8, us_pd_base=0x002038
us_dma_ctrl=0x00, us_dma_tx_start=0x00
global control and status:
irq_pend=0x0018, irq_mask=0x00E7
loop_enable=0x00, minislot_divisor=0x00
K0_ctrl=0x06, K1_ctrl=0x07, acq_threshhold=0x01
err_threshhold=0x04, timeout_threshold=0xFF
nco_bias=0x4F7004F7, ranging_offset=0x00000000
ts_err=0x00, sync_valid=0x00, delta_F=0x00
dynamic_ctrl=0x09, static_ctr=0x9F, autonomous=0x01
irq_ack=0x00, spi_cmd=0x51, spi_addr=0x11
spi_data= FF/00/00/00/00/00/00
01 19 1D 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
01 19 1D 03 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
01 19 1D 04 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
Table 111 describes the MIB statistics shown in the display for this command.
Table 111 MIB Statistics Field Descriptions
Field
|
Description
|
DS fifo full
|
Number of times the downstream receive buffer on the router has become full.
|
Rerequests
|
Number of registration requests sent by the router to the CMTS.
|
DS mac msg overruns
|
Number of times the DMA controller has had a downstream MAC message and there were no free MAC message buffer descriptors to accept the message.
|
DS data overruns
|
Number of times the DMA controller has had downstream data and there were no free data PDU buffer descriptors to accept the data.
|
Qualified maps
|
Number of valid MAP messages received by the router.
|
Qualified syncs
|
Number of times the router has received synchronization with the downstream channel.
|
CRC fails
|
Number of cyclic redundancy checks (CRCs) generated by the far-end device that did not match the checksums calculated from the message portions of the packets received.
|
HDR check fails
|
Number of cyclic redundancy checks (CRCs) generated by the far-end device that did not match the checksums calculated from the MAC headers of the packets received. The MAC header CRC is a 16-bit Header Check Sequence (HCS) field that ensures the integrity of the MAC header even in a collision environment.
|
Data pdus
|
Total number of data PDUs (protocol data units) of all types received by the cable interface.
|
Mac msgs
|
Number of MAC messages received by the cable interface.
|
Valid hdrs
|
Number of valid MAC headers received by the cable interface.
|
Below the MIB statistics in the show controllers cable-modem 0 mac hardware display, the BCM3300 registers section shows the DMA locations of the indicated processing routines of the Broadcom 3220 MAC chip within the router.
The following is typical output from the show controllers cable-modem mac state command that summarizes the state of the cable MAC layer and provides a list of downstream search frequency bands and the order in which they are searched. The normal operational state of the interface is the maintenance_state. If the cable MAC layer is in the wait_for_link_up_state, the information shown in the display corresponds to the last time the interface was up.
Router# show controller cable-modem 0 mac state
MAC State: maintenance_state
Privacy Established: TRUE
Privacy Version: BPI+ (PLUS)
DOCSIS Operating Mode: DOCSIS 1.1
Snmp Operating Mode: Co-existence Mode
88 453000000 855000000 6000000
89 93000000 105000000 6000000
90 111250000 117250000 6000000
91 231012500 327012500 6000000
92 333015000 333015000 6000000
93 339012500 399012500 6000000
94 405000000 447000000 6000000
95 123015000 129015000 6000000
96 135012500 135012500 6000000
97 141000000 171000000 6000000
98 219000000 225000000 6000000
99 177000000 213000000 6000000
US Power Level: 34.0 (dBmV)
Preamble Pattern: CC CC CC CC CC CC CC CC CC CC CC CC CC CC 0D 0D
A9 17 D9 C3 52 2F B3 86 A4 5F 67 0D 48 BE CE 1A
91 7D 9C 35 22 FB 38 6A 45 F6 70 D4 8B EC E1 A9
17 D9 C3 52 2F B3 86 A4 5F 67 0D 48 BE CE 1A 91
F3 F3 F3 F3 F3 F3 F3 F3 F3 F3 F3 F3 F3 F3 F3 F3
F3 F3 F3 F3 F3 F3 F3 F3 F3 F3 F3 F3 33 F7 33 F7
88 84 04 4C C4 84 C0 0C 44 08 08 CC 8C 0C 80 48
88 40 44 CC 48 4C 00 C4 40 80 8C C8 C0 C8 04 88
Preamble Value Offset: 56
FEC Codeword Info Bytes: 16
FEC Codeword Info Bytes: 34
FEC Codeword Info Bytes: 34
Preamble Value Offset: 48
FEC Codeword Info Bytes: 75
SNMP MIB Object: 0000000000000000000000000000000000000000000000000000
Auth. Reject Wait Time: 60
Max Downstream Rate: 4000000
Max Upstream Rate: 2000000
Min Upstream Rate: 100000
Ranging Backoff Start: 0 (at initial ranging)
Ranging Backoff End: 4 (at initial ranging)
Data Backoff Start: 0 (at initial ranging)
Data Backoff End: 4 (at initial ranging)
TFTP Server IP Address: 223.255.254.254
Time Server IP Address: 188.188.1.5
Config File Name: muck/ebuell/tftp/cm_conf
Log Server IP Address: 0.0.0.0
Piggyback when Ccat On: Disabled
Max Sids: 4 Sids In Use: 1
SFid Sid State Type rxtx Parm State Idb
Table 112 describes the fields shown in the display.
Table 112 show controller cable-modem mac state Field Descriptions
Field
|
Description
|
MAC State
|
Current operational state of the MAC layer of the router.
|
Ranging SID
|
Service ID used for ranging requests.
|
Registered
|
Indicates whether or not the router is currently registered with the CMTS.
|
Privacy Established
|
Indicates whether or not keys for baseline privacy have been exchanged between the router and the CMTS, establishing privacy.
|
Privacy Version
|
Indicates whether the router is using BPI or BPI+ baseline privacy.
|
DOCSIS Operating Mode
|
Indicates the DOCSIS revision that the router has been provisioned for (DOCSIS 1.0 or DOCSIS 1.1).
|
Snmp Operating Mode
|
Indicates the current SNMP operating mode:
• Co-existence Mode—SNMPv3 co-existence model
• NmAccess Mode—SNMPv2 model
|
Mac Resets
|
Number of times the router reset or initialized this interface.
|
Sync lost
|
Number of times the router lost synchronization with the downstream channel.
|
Invalid Maps
|
Number of times the router received invalid MAP messages.
|
Invalid UCDs
|
Number of times the router received invalid upstream channel descriptor (UCD) messages.
|
Invalid Rng Rsp
|
Number of times the router received invalid ranging response messages.
|
Invalid Reg Rsp
|
Number of times the router received invalid registration response messages.
|
T1 Timeouts
|
Number of timeouts caused by the router not receiving a valid UCD from the CMTS within the specified time.
|
T2 Timeouts
|
Number of timeouts caused by the router not receiving a maintenance broadcast for ranging opportunities from the CMTS within a specified time.
|
T3 Timeouts
|
Number of timeouts caused by the router not receiving a response within a specified time from the CMTS to a RNG-REQ message during initial maintenance.
|
T4 Timeouts
|
Number of timeouts caused by the router not receiving a response within a specified time from the CMTS to a periodic maintenance request.
|
Range Aborts
|
Number of times the ranging process was aborted by the CMTS.
|
DS ID
|
Identifier of the downstream channel on which this MAC management message has been transmitted. This identifier is arbitrarily chosen by the CMTS and is only unique within the MAC-sublayer domain.
|
DS Frequency
|
Downstream frequency acquired by the router during its last initialization sequence.
|
DS Symbol Rate
|
Downstream frequency in symbols per second.
|
DS QAM Mode
|
Downstream modulation scheme being used by the router.
|
DS Search
|
Frequency bands scanned by the router when searching for a downstream channel. The router's default frequency bands correspond to the North American EIA CATV channel plan for 6 MHz channel slots between 90 MHz and 858 MHz.
|
US ID
|
Identifier of the upstream channel to which this MAC management message refers. This identifier is arbitrarily chosen by the CMTS and is only unique within the MAC-sublayer domain.
|
US Frequency
|
Transmission frequency used by the router in the upstream direction.
|
US Power Level
|
Transmit power level of the router in the upstream direction.
|
US Symbol Rate
|
Upstream frequency in symbols per second.
|
Ranging Offset
|
Delay correction (in increments of 6.25 microseconds/64) applied by the router to the CMTS upstream frame time derived at the router. Used to synchronize the upstream transmissions in the time division multiple access (TDMA) scheme, this value is roughly equal to the round-trip delay of the router from the CMTS.
|
Mini-Slot Size
|
Size T of the mini-slot for this upstream channel in units of the timebase tick of 6.25 microseconds. Allowable values are 2, 4, 8, 16, 32, 64, or 128.
|
Change Count
|
Incremented by 1 by the CMTS whenever any of the values of this channel descriptor change. If the value of this count in a subsequent upstream channel descriptor (UCD) remains the same, the router can quickly decide that the remaining fields have not changed, and may be able to disregard the remainder of the message.
|
Preamble Pattern
|
Byte pattern used for the preamble.
|
Burst Descriptor:
|
A compound type/length/value (TLV) encoding that defines, for each type of upstream usage interval, the physical-layer characteristics that are to be used during that interval. Each burst descriptor is given an identifying number.
|
Interval Usage Code
|
Each upstream transmit burst belongs to a class which is given a number called the interval usage code (IUC). Bandwidth MAP messages are used by IUC codes to allocate upstream time slots. The following types are currently defined:
1. Request: bandwidth request slot
2. Request/Data: bandwidth request or data slot
3. Initial Maintenance: initial link registration contention slot
4. Station Maintenance: link keep-alive slot
5. Short Data Grant: short data burst slot
6. Long Data Grant: long data burst slot
|
Modulation Type
|
Upstream modulation format. (1 = QPSK; 2 = 16-QAM)
|
Differential Encoding
|
Indicates whether or not differential encoding is used. (1 = yes; 2 = no)
|
Preamble Length
|
Length of the preamble in bits. This value must be an integral number of symbols—a multiple of 2 for QPSK; a multiple of 4 for 16-QAM.
|
FEC Error Correction
|
Length of the forward error correction in bytes. The range is 0 to 10 bytes; a value of 0 implies no forward error correction.
|
FEC Codeword Info Bytes
|
Number of information bytes in the FEC codeword.
|
Scrambler Seed
|
15-bit seed value loaded at the beginning of each burst after the register has been cleared. Not used if scrambler is off.
|
Maximum Burst Size
|
Maximum number of mini-slots that can be transmitted during this burst type. When the interval type is Short Data Grant, this value must be greater than 0. If this value is 0, the burst size is limited elsewhere.
|
Guard Time Size
|
Amount of time in symbols between the center of the last symbol of a burst and the center of the first symbol of the preamble of an immediately following burst in an upstream transmission from the router to the CMTS.
|
Last Codeword Length
|
Indicates whether or not the length of the last codeword is fixed or shortened. (1 = fixed; 2 = shortened)
|
Scrambler on/off
|
Indicates whether or not a scrambler is enabled in the upstream modulator. (1 = on; 2 = off)
|
Network Access
|
Indicates whether or not the router has access to the HFC network.
|
Concatenation
|
Indicates whether DOCSIS 1.1 concatenation is enabled or disabled.
|
Maximum CPEs
|
Maximum number of CPEs supported for this cable modem.
|
Vendor ID
|
Unique identifier specifying the CM manufacturer.
|
Auth. Wait Timeout
|
Number of seconds the router waits for a reply after sending the Authorization Request message to the CMTS.
|
Reauth. Wait Timeout
|
Number of seconds the router waits for a reply after it has sent an Authorization Request message to the CMTS in response to a reauthorization request or an Authorization Invalid message from the CMTS.
|
Auth. Grace Time
|
Number of seconds before the current authorization is set to expire that the grace timer begins, signaling the router to begin the reauthorization process.
|
Op. Wait Timeout
|
Number of seconds the TEK state machine waits for a reply from the CMTS after sending its initial Key Request for its SID's keying material.
|
Retry Wait Timeout
|
Number of seconds the TEK state machine waits for a replacement key for this SID after the TEK grace timer has expired and the request for a replacement key has been made.
|
TEK Grace Time
|
Number of seconds before the current TEK is set to expire that the TEK grace timer begins, signaling the TEK state machine to request a replacement key.
|
Auth. Reject Wait Time
|
Number of seconds the router waits before sending another Authorization Request message to the CMTS after it has received an Authorization Reject message.
|
Assigned SID
|
Service ID assigned by the CMTS for the corresponding service class.
|
Max Downstream Rate
|
Maximum downstream rate in bits per second that the CMTS is permitted to forward to CPE unicast MAC addresses learned or configured as mapping to this router. This rate does not include MAC packets addressed to broadcast or multicast MAC addresses.
|
Max Upstream Rate
|
Maximum upstream rate in bits per second that the router is permitted to forward to the RF network. This rate includes packet PDU data packets addressed to broadcast or multicast addresses.
|
Upstream Priority
|
Relative priority assigned to this service class for data transmission in the upstream channel. Higher numbers indicate higher priority.
|
Min Upstream Rate
|
Date rate in bits per second that will be guaranteed to this service class on the upstream channel.
|
Max Upstream Burst
|
Maximum transmit burst in bytes allowed for this service class on the upstream channel.
|
Privacy Enable
|
Indicates whether or not Baseline Privacy is enabled for this service class.
|
Ranging Backoff Start
|
Initial back-off window for initial ranging contention, expressed as a power of 2. Valid values are from 0 to 15.
|
Ranging Backoff End
|
Final back-off window for initial ranging contention, expressed as a power of 2. Valid values are from 0 to 15.
|
Data Backoff Start
|
Initial back-off window for contention data and requests, expressed as a power of 2. Valid values are from 0 to 15.
|
Data Backoff End
|
Final back-off window for contention data and requests, expressed as a power of 2. Valid values are from 0 to 15.
|
IP Address
|
IP address of the cable interface.
|
Net Mask
|
Subnet mask of the cable interface.
|
TFTP Server IP Address
|
IP address of the CMTS TFTP server.
|
Time Server IP Address
|
IP address of the CMTS Time-of-Day (TOD) server.
|
Config File Name
|
Name of the configuration file that is downloaded from the TFTP server to provide the router with operational parameters.
|
Time Zone Offset
|
Correction received from the DHCP server to synchronize the router time clock with the CMTS.
|
Log Server IP Address
|
Displays the IP address for a syslog server, if any has been defined.
|
Drop Ack Enabled
|
Indicates whether the TCP drop acknowledge feature is enabled or disabled.
|
Piggyback when Ccat On
|
Indicates whether the piggybacking of data onto request packets is enabled when concatenation is also enabled.
|
Mac Sid Status
|
Displays the service IDs currently in use.
|

Tip
In Cisco IOS Release 12.2(8)T and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Related Commands
Command
|
Description
|
show controllers cable-modem
|
Displays high-level controller information about the cable interface.
|
show controllers cable-modem bpkm
|
Displays information about the baseline privacy key management exchange between the cable interface and the CMTS.
|
show controllers cable-modem crypto des
|
Displays information about the Data Encryption Standard (DES) engine registers.
|
show controllers cable-modem filters
|
Displays the registers in the MAC hardware that are used for filtering received frames.
|
show controllers cable-modem lookup-table
|
Displays the mini-slot lookup table for the cable interface.
|
show controllers cable-modem phy
|
Displays the contents of the registers used in the downstream physical hardware for the cable interface.
|
show controllers cable-modem tuner
|
Displays the settings for the upstream and downstream tuners used by the cable interface.
|
show controllers cable-modem manuf-cert
To display the manufacturer's X.509 certificate for the router, use the show controllers cable-modem manuf-cert command in privileged EXEC mode.
Cisco uBR905 and Cisco uBR925 cable access routers, and Cisco CVA122 Cable Voice Adapter
show controllers cable-modem number manuf-cert
Syntax Description
number
|
Identifies the cable interface (always 0).
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(15)CZ
|
This command was introduced on the Cisco uBR905 and Cisco uBR925 cable access routers, and the Cisco CVA122 Cable Voice Adapter.
|
Usage Guidelines
This command displays the manufacturing certificate for Cisco Systems, which the Secure Software Download procedure uses to authenticate the software that the router downloads. This command shows the individual X.509 components of the certificate, starting with the DOCSIS restricted X.501 Distinguished Name and ending with the 1024-bit public key.
Tip
This command displays the certificate that is incorporated into the Cisco IOS image that the router is currently running. Upgrading the Cisco IOS image could also update the manufacturer's certificate. The show controllers cable-modem cmcert command displays the cable-modem certificate that is that is burned into the router at the factory and is not normally changed.
Examples
The following example shows the starting lines and ending lines of typical output for the show controllers cable-modem manuf-cert command:
Router# show controllers cable-modem 0 manuf-cert
Cisco Manufacturing Certificate:
INT(16): 0B F5 94 FD 7B 4E E0 79 90 83 5C A9 A4 BE A0 3E
OID(9):SHA Signature 1.2.840.113549.1.1.5
OID(3):Organization 2.5.4.10
1w3d: PRT(48):Data Over Cable Service Interface Specification
OID(3):Organization Unit 2.5.4.11
1w3d: PRT(12):Cable Modems
1w3d: E1 13 05 10 3C F1 F1 A0 CE 43 74 30 9C 59 F5 70
1w3d: 4B C2 71 8E 79 AC 19 3D AB 94 1E B0 BE BC 15 D8
1w3d: AD A4 79 F5 58 CA 04 25 62 A9 F8 3F E7 40 64 E2
1w3d: 65 B0 D0 53 65 FF F1 12 FF 1B CD DE 1D 47 A2 6E
Note
You must manually enter a return to redisplay the router prompt after the certificate has been displayed.
Related Commands
show controllers cable-modem phs
To display the payload header suppression (PHS) configuration on the router's cable interface, use the show controllers cable-modem phs command in privileged EXEC mode.
Cisco uBR905, uBR925 cable access routers, Cisco CVA122 Cable Voice Adapter
show controllers cable-modem number phs [rule-index]
Syntax Description
number
|
Identifies the cable interface (always 0).
|
rule-index
|
(Optional) Displays information for a specific PHS rule index. The valid range is 1 to 255.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(15)CZ
|
This command was introduced for the Cisco uBR905 and Cisco uBR924 cable access routers, and the Cisco CVA122 Cable Voice Adapter.
|
Usage Guidelines
This command displays the PHS parameters that are currently in use for both the upstream and downstream. The information shown corresponds to the PHS parameters that are listed in Appendix C of the DOCSIS 1.1 specification.
Examples
The following shows an excerpt from typical output from the show controllers cable-modem phs command:
Router# show controllers cable-modem 0 phs
PHS Service Flow Reference: 1
PHS Dynsrv Change Action: 0
PHS Mask: 0x00 0x00 0x00 0x03 0xC0
PHS Service Flow Reference: 1
PHS Dynsrv Change Action: 0
PHS Mask: 0x00 0x00 0x00 0x03 0xC0
PHS Service Flow Reference: 1
PHS Dynsrv Change Action: 0
PHS Mask: 0x00 0x00 0x00 0x03 0xC0
Downstream PHS Parameters
PHS Service Flow Reference: 2
PHS Dynsrv Change Action: 0
PHS Fields: 0x08 0x00 0x45 0x00 0x00 0x56 0x00 0x00 0x00 0x00 0x3B
0x00 0x6D 0xA7 0x01 0x0A 0x28 0x03 0x00 0x00 0x00 0x00
Downstream PHS Parameters
PHS Service Flow Reference: 4
PHS Dynsrv Change Action: 0
PHS Fields: 0x08 0x00 0x45 0x00 0x00 0x56 0x00 0x00 0x00 0x00 0x3B
0x00 0x6D 0xA7 0x00 0x00 0x00 0x00 0x01 0x0A 0x28 0x42
The following shows a typical display for a specific PHS rule:
Router# show controllers cable-modem 0 phs 3
Downstream PHS Parameters
PHS Service Flow Reference: 6
PHS Service Flow ID: 1915
PHS Dynsrv Change Action: 0
PHS Fields: 0x08 0x00 0x45 0x00 0x00 0x56 0x00 0x00 0x00 0x00 0x3B
0x00 0x6D 0xA7 0x08 0x00 0x00 0x01 0x0C 0x00 0x00 0x01 0xAB 0xAB 0xAB 0xAB 0xAB 0xAB 0xAB
0xAB 0xAB 0xAB 0xAB 0xAB
PHS Mask: 0xF0 0x00 0x01 0xFF 0xAB
Table 113 describes the fields shown in the display.
Table 113 show controllers cable-modem phs Field Descriptions
Field
|
Description
|
PHS Classifier Refer
|
The reference ID for the classifier using this PHS rule.
|
PHS Classifier ID
|
The ID for the classifier using this PHS rule.
|
PHS Service Flow Reference
|
The reference ID for the service flow using this PHS rule.
|
PHS Service Flow ID
|
The ID for the service flow using this PHS rule.
|
PHS Dynsrv Change Action
|
The action taken in a dynamic service change request for this PHS rule:
• 0 = Add the PHS rule.
• 1 = Set the PHS rule.
• 2 = Delete the PHS rule.
• 3 = Delete all PHS rules.
|
PHS Fields
|
The bytes of the headers that must be suppressed and restored during PHS operation. For the upstream, this includes the PDU bytes starting with the first byte after the MAC header checksum. For the downstream, this includes the PDU bytes starting with the 13th byte after the MAC header checksum.
|
PHS Index
|
The index that references the suppressed byte string in the PHS Fields. The index is unique per service flow in the upstream direction and unique per the cable modem in the downstream direction.
|
PHS Mask
|
The mask used to interpret the bytes in the PHS Fields, where each bit indicates whether the corresponding byte in the PHS Fields should be suppressed (0 = do not suppress, 1 = suppress).
|
PHS Classifier Size
|
The total number of bytes in the header to be suppressed.
|
PHS Classifier Verification
|
Indicates whether the header bytes are to be verified before suppression (0 = verify, 1 = do not verify).
|

Tip
In Cisco IOS Release 12.2(8)T and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Related Commands
show controllers cable-modem phy
To display the contents of the registers used in the downstream physical hardware of the router's cable interface, use the show controllers cable-modem phy command in privileged EXEC mode.
Cisco uBR904, uBR905, uBR924, uBR925 cable access routers, Cisco CVA122 Cable Voice Adapter
show controllers cable-modem number phy {receive | transmit}
Syntax Description
number
|
Identifies the cable interface (always 0).
|
receive
|
Displays all receiver registers in the downstream physical hardware.
|
transmit
|
Displays all transmitter registers in the upstream physical hardware.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.3(4)NA
|
This command was introduced for the Cisco uBR904 cable access router.
|
12.0(4)XI1
|
Support was added for the Cisco uBR924 cable access router.
|
12.1(3)XL
|
Support was added for the Cisco uBR905 cable access router.
|
12.1(5)XU1
|
Support was added for the Cisco CVA122 Cable Voice Adapter.
|
12.2(2)XA
|
Support was added for the Cisco uBR925 cable access router.
|
Usage Guidelines
To understand the output from this command, consult the Broadcom specifications for the BCM3116 and BCM3037 chips.
Examples
The following is typical output from the show controllers cable-modem phy command:
Router# show controllers cable-modem 0 phy receive
BCM3116 Receiver Registers: Chip ID = C2C1
rstctl= frzctl=20 qamctl=1B lmsctl=0B tpctl=00 fmtctl=24
ffectl=3F irqsts=09 irqmask=00 stoscm=9E rstctr=00 frzctl2=46
dvctl=30 idepth=55 eqlctl=00 tstctl=02 berctl=00 clkset=00
FFC coefficient registers:
F0=0067FFBC F1=FF880080 F2=00C1FEFB F3=FF75019D
F4=00C5FD89 F5=FF6D0485 F6=FC95F690 F7=2D280000
DFE coefficient registers:
D00=0636031E D01=FBDD0314 D02=0077FD39 D03=001B00C6
D04=0024FF74 D05=0015007E D06=000CFFC4 D07=FFC0004B
D08=0044FFF6 D09=FFE00019 D10=00190005 D11=FFD3FFAD
D12=FFD3FFE0 D13=001A000A D14=FFF3FFED D15=0008FFFD
D16=FFFC0024 D17=0023FFDF D18=0029FFFF D19=000D001E
D20=00020017 D21=00250001 D22=0007FFF4 D23=FFF60014
ldsft=B0EE ldsnre=0098AF ldif=0D004E ldbbi=00000000
ldbbq=00000000 ldali=032E00 ldaii=E62AF2 ldbrfo=705A05
ldbri=F9CDC200 lddrfo=007E7D lddri=007EF0
FEC correctable error count: 0
FEC uncorrectable error count: 0
The following example shows typical output for the physical transmit registers:
Router# show controllers cable-modem 0 phy transmit
BCM3037 Transmitter Registers:
part_id = 3037 rev_id = 01
test_mode = 00 test_input = 00
test_misc = 2009 rst = 00
power = 0000 power_2 = 00
tx_oen_bdly = 14 tx_oen_edly = C8
prbs_cfg = 00C000 baud = 1A36E3
burst = 0000 if_freq = 200000
burst config 0 : prbs_init = FFFFFF rs = 343E
pream_len = 0018 offset = 0000
burst config 1 : prbs_init = FFFFFE rs = 033B
pream_len = 0000 offset = 0000
burst config 2 : prbs_init = FFFFFE rs = 033B
pream_len = 0000 offset = 0000
burst config 3 : prbs_init = FFFFFE rs = 033B
burst config 4 : prbs_init = FFFFFE rs = 033B
pream_len = 0000 offset = 0000
burst config 5 : prbs_init = FFFFFE rs = 033B
pream_len = 0000 offset = 0000
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
CC CC CC CC CC 0D 0D CC CC CC CC CC CC CC CC 0D
04 25 01 01 01 01 02 01 02 03 02 00 40 04 02 00
40 05 01 00 06 01 10 07 02 01 52 08 01 01 09 01
08 0A 01 01 0B 01 02 04 25 03 01 01 01 02 01 02
03 02 00 50 04 02 00 30 05 01 00 06 01 22 07 02
01 52 08 01 00 09 01 30 0A 01 01 0B 01 02 04 25
04 01 01 01 02 01 02 03 02 00 40 04 02 00 40 05
01 00 06 01 22 07 02 01 52 08 01 00 09 01 30 0A
Tip
In Cisco IOS Release 12.2(8)T and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Related Commands
Command
|
Description
|
show controllers cable-modem
|
Displays high-level controller information about the cable interface.
|
show controllers cable-modem bpkm
|
Displays information about the baseline privacy key management exchange between the cable interface and the CMTS.
|
show controllers cable-modem crypto des
|
Displays information about the Data Encryption Standard (DES) engine registers.
|
show controllers cable-modem filters
|
Displays the registers in the MAC hardware that are used for filtering received frames.
|
show controllers cable-modem lookup-table
|
Displays the mini-slot lookup table inside the cable interface.
|
show controllers cable-modem mac
|
Displays detailed MAC-layer information for the cable interface.
|
show controllers cable-modem tuner
|
Displays the settings for the upstream and downstream tuners used by the cable interface.
|
show controllers cable-modem qos
To display detailed information about the Quality of Service (QoS) configuration for the router, use the show controllers cable-modem qos command in privileged EXEC mode.
Cisco uBR905, Cisco uBR924, and Cisco uBR925 cable access routers, and Cisco CVA122 Cable Voice Adapter
show controllers cable-modem number qos [details]
Syntax Description
number
|
Identifies the cable interface (always 0).
|
details
|
(Optional) Displays detailed information, including classifier information.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.0(7)XR and 12.1(1)T
|
This command was introduced for the Cisco uBR924 cable access router.
|
12.1(3)XL
|
Support was added for the Cisco uBR905 cable access router.
|
12.1(5)XU1
|
Support was added for the Cisco CVA122 Cable Voice Adapter.
|
12.2(2)XA
|
Support was added for the Cisco uBR925 cable access router.
|
12.2(15)CZ
|
Support for DOCSIS 1.1 and BPI+ operation was added for the Cisco uBR905 and Cisco uBR925 cable access routers, and the Cisco CVA122 Cable Voice Adapter. The details option was also added.
|
Usage Guidelines
When the cable modem is operating in DOCSIS 1.0 or DOCSIS 1.0+ mode, this command displays the four possible stream queues, the Service ID (SID) associated with each queue (if the queue is currently in use), and whether the SID is the primary SID, a secondary (static) SID, or a dynamic (on demand) SID. The display also shows the packets and bytes that have been transmitted and received on each stream.
When the cable modem is operating in DOCSIS 1.1 mode, this command also displays the modem's capabilities and packet classifiers.
Examples
The following example shows typical output for a DOCSIS 1.0 or DOCSIS 1.0+ cable modem for the QoS statistics for each of the router's four queues:
Router# show controllers cable-modem 0 qos
Queue SID SID SFID TX TX RX RX
Type Pkts Bytes Pkts Bytes
0 2 Primary 0 11377 2721985 12320 983969
1 52 Dynamic 52 116 13608 105 14300
In Cisco IOS Release 12.2(15)CZ and later releases, the QoS statistics include information about the DOCSIS 1.1 operations, including the type of service flow and packet classifiers being used for each queue. The following is a typical default display:
Router# show controllers cable-modem 0 qos
Queue SID SF SF SFID TX TX RX RX
Type Name Pkts Bytes Pkts Bytes
0 565 Primary BE 675 200 34606 518 120321
1 1443 Dynamic UGS 1911 0 0 0 0
2 1444 Dynamic UGS_AD 1912 0 0 0 0
3 1445 Dynamic RTP 1913 0 0 0 0
Queue Concat Capabilities
The following shows a typical display with the details option:
Router# show controllers cable-modem 0 qos details
Queue SID SF SF SFID TX TX RX RX
Type Name Pkts Bytes Pkts Bytes
0 565 Primary BE 675 200 34606 529 123351
1 1443 Dynamic UGS 1911 0 0 0 0
2 1444 Dynamic UGS_AD 1912 0 0 0 0
3 1445 Dynamic RTP 1913 0 0 0 0
Queue Concat Capabilities
Class id SFID Pri valid Match SIDT
PHS: Active Index: 1 Size: 34 Suppressed Size: 13
SFID: 1912 Classifier Id: 2
Verify: TRUE Packets: 0 Bytes Suppressed: 0
PHS: Active Index: 1 Size: 34 Suppressed Size: 13
SFID: 1911 Classifier Id: 3
Verify: TRUE Packets: 0 Bytes Suppressed: 0
PHS: Active Index: 1 Size: 34 Suppressed Size: 13
SFID: 675 Classifier Id: 4
Verify: TRUE Packets: 0 Bytes Suppressed: 0
Downstream Payload Header Suppression
PHS: Active Index: 1 Size: 34 Suppressed Size: 14 (index = 1)
SFID: 676 Classifier Id: 8
Verify: TRUE Packets: 0 Bytes Suppressed: 0
PHS: Active Index: 2 Size: 34 Suppressed Size: 14 (index = 2)
SFID: 1914 Classifier Id: 7
Verify: TRUE Packets: 0 Bytes Suppressed: 0
PHS: Active Index: 3 Size: 34 Suppressed Size: 14 (index = 3)
SFID: 1915 Classifier Id: 6
Verify: TRUE Packets: 0 Bytes Suppressed: 0
Table 114 describes the significant fields shown in the display for a DOCSIS 1.0 or DOCSIS 1.0+ cable modem:
Table 114 show controllers cable-modem qos Field Descriptions
Field
|
Description
|
Queue
|
One of the four possible service flow queues that exist in the router.
|
SID
|
Service identifier, a 14-bit integer assigned by the CMTS to each active upstream service flow.
|
SID Type
|
The type of SID:
• Primary—The service flow used for best-effort data traffic and MAC maintenance messages.
• Secondary—Secondary static service flows that are created at power-on provisioning for voice calls when dynamic SIDs are not active.
• Dynamic—Secondary service flows that are created for on-demand voice calls when using dynamic SIDs.
|
SFID
|
Service flow identifier, a 32-bit integer assigned by the CMTS to each service flow on the router.
|
TX Pkts
|
Number of packets the router has transmitted on this service flow.
|
TX Bytes
|
Number of bytes the router has transmitted on this service flow.
|
RX Pkts
|
Number of packets the router has received on this service flow.
|
RX Bytes
|
Number of bytes the router has received on this service flow.
|
Queue/SF Type
|
Identifies the type of service flow being used for each queue.
|
In Cisco IOS Release 12.2(15)CZ and later releases, the QoS statistics include information about the DOCSIS 1.1 operations, including the type of service flow and packet classifiers being used for each queue:
Router# show controllers cable-modem 0 qos
Queue SID SID SFID TX TX RX RX Capabilities
Type Pkts Bytes Pkts Bytes cbr cc fr nbr
0 1 Primary 3 40 5740 2780 209346 F T T F
1 56 Dynamic 91 1782 160140 0 0 T T T T
2 58 Dynamic 93 690 61946 0 0 T T T T
Class id SFID Pri valid Match SIDT
Packet Classifier Details
Classifier id = 1 SFID = 91
UDP/TCP source range: 18416 to 18416
UDP/TCP dest range: 16740 to 16740
Classifier id = 2 SFID = 93
UDP/TCP source range: 16796 to 16796
UDP/TCP dest range: 19138 to 19138
Downstream Payload Header Suppression
Table 115 describes the fields shown in the display for a DOCSIS 1.1 cable modem.
Table 115 show controllers cable-modem qos Field Descriptions (DOCSIS 1.1)
Field
|
Description
|
Queue
|
One of the four possible service flow queues that exist in the router.
|
SID
|
Service Identifier, a 14-bit integer assigned by the CMTS to each active upstream service flow.
|
SID Type
|
The type of SID:
• Primary—The service flow used for best-effort data traffic and MAC maintenance messages.
• Secondary—Secondary static service flows that are created at power-on provisioning for voice calls when dynamic SIDs are not active.
• Dynamic—Secondary service flows that are created for on-demand voice calls when using dynamic SIDs.
|
SFID
|
Service Flow Identifier, a 32-bit integer assigned by the CMTS to each service flow on the router.
|
TX Pkts
|
Number of packets the router has transmitted on this service flow.
|
TX Bytes
|
Number of bytes the router has transmitted on this service flow.
|
RX Pkts
|
Number of packets the router has received on this service flow.
|
RX Bytes
|
Number of bytes the router has received on this service flow.
|
Capabilities
|
These four fields describe whether the following features are enabled.
|
cbr
|
Indicates whether committed bit rate traffic (CBR) is supported (T) or not (F). This could indicate either UGS or UGS-AD service flows.
|
cc
|
Indicates whether concatenation is supported (T) or not (F).
|
fr
|
Indicates whether DOCSIS fragmentation is supported (T) or not (F).
|
nbr
|
Indicates the Not Broadcast status, depending on whether the classifier supports broadcasts (F) or not (T).
|
Queue/SF Type
|
Identifies the type of service flow being used for each queue.
|
Packet Classifiers
|
Describes the classifiers defined on the router.
|
Class id
|
ID used to uniquely identify the classifier in each service flow.
|
SFID
|
ID that uniquely identifies the service flow.
|
Pri
|
Traffic Priority parameter that was assigned to this classifier. If no value was set, the priority defaults to 0 (lowest priority).
|
valid
|
A 13-bit bitmask showing which Type/Length/Value (TLV) fields were set on the classifier. The following shows the meaning of each bit, with the least significant bit on the far right. The bit is set to 1 if the corresponding TLV was set for the classifier:
• 0x0001—IP Type of Service Range and Mask
• 0x0002—IP Protocol
• 0x0004—IP Source Address
• 0x0008—IP Source Mask
• 0x0010—IP Destination Address
• 0x0020—IP Destination Mask
• 0x0040—TCP/UDP Source Port Start and TCP/UDP Source Port End
• 0x0080—TCP/UDP Destination Port Start and TCP/UDP Destination Port End
• 0x0100—Destination MAC Address
• 0x0200—Source MAC Address
• 0x0400—Ethertype/DSAP/MacType
• 0x0800—IEEE 802.1P User_Priority
• 0x1000—IEEE 802.1Q VLAN_ID
For example, a value of D6 translates to the bit-mask "1101 0110", which indicates that the following fields were set for the classifier: IP Protocol, IP Source Address, IP Destination Address, and the TCP/UDP Source and Destination Port values.
|
Match
|
Number of packets matching the classifier.
|
SIDT
|
Address for the classifier in the internal SID table (SIDT).
|
Packet Classifier Details
|
Describes each packet classifier in detail.
|
Classifier ID
|
ID used to uniquely identify the classifier in each service flow.
|
SFID
|
ID that uniquely identifies the service flow.
|
IP source
|
The matching IP source address.
|
IP dest
|
The matching IP destination address.
|
UDP/TCP source range
|
The low-end and high-end matching source TCP/UDP port values.
|
UDP/TCP dest range
|
The low-end and high-end matching destination TCP/UDP port values.
|
IP Protocol
|
The matching IP protocol type, as given in RFC 1700. A value of 256 matches any IP protocol, and a value of 257 matches TCP and UDP traffic.
|
PHS
|
Indicates whether Payload Header Suppression (PHS) is active or inactive.
|
Downstream Payload Header Suppression
|
Indicates that PHS is being used on the downstream.
|

Tip
In Cisco IOS Release 12.2(8)T and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Related Commands
Command
|
Description
|
show controllers cable-modem mac
|
Displays detailed MAC-layer information for the router's cable interface.
|
show controllers cable-modem service-flows
To display the service flows that are configured on the router, use the show controllers cable-modem service-flows command in privileged EXEC mode.
Cisco uBR905, uBR925 cable access routers, Cisco CVA122 Cable Voice Adapter
show controllers cable-modem number service-flows [sfid | summary]
Syntax Description
number
|
Identifies the cable interface (always 0).
|
sfid
|
(Optional) Displays detailed information for a specific service flow, as identified by its service flow ID (SFID). The valid range for sfid is 1 to 2147483647.
|
summary
|
(Optional) Displays a summary report of all service flows.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(15)CZ
|
This command was introduced for the Cisco uBR905 and Cisco uBR924 cable access routers, and the Cisco CVA122 Cable Voice Adapter.
|
Usage Guidelines
This command displays the Quality of Service (QoS) parameters that make up each of the service flows that are defined on the router for the upstream and downstream. The information shown corresponds to the QoS parameters that are listed in Appendix C of the DOCSIS 1.1 specification.
Examples
The following example shows typical output for the default form of the show controllers cable-modem service-flows command.
Router# show controllers cable-modem 0 service-flows
Upstream Flow Scheduler Parameters
QoS Max Sustained Traffic Rate: 0
QoS Max Traffic Burst: 1522
QoS Min Reserved Traffic Rate: 0
QoS Min Reserved Rate Pkt Size: 0
QoS Timeout For Active Param: 0
Qos Timeout For Admitted Param: 200
Max Concatenated Burst: 0
Request/Transmission Policy: 0x0
Nominal Polling Interval: 0
Unsolicited Grant Size: 0
Nominal Grant Interval: 0
Tolerated Grant Jitter: 0
IP TOS Overwrite: 0xFF 0x0
Downstream Flow Scheduler Parameters
QoS Max Sustained Traffic Rate: 0
QoS Max Traffic Burst: 1522
QoS Min Reserved Traffic Rate: 64000
QoS Min Reserved Rate Pkt Size: 0
QoS Timeout For Active Param: 0
Qos Timeout For Admitted Param: 200
Downstream Flow Scheduler Parameters
QoS Max Sustained Traffic Rate: 10000
QoS Max Traffic Burst: 1522
QoS Min Reserved Traffic Rate: 8000
QoS Min Reserved Rate Pkt Size: 0
QoS Timeout For Active Param: 0
Qos Timeout For Admitted Param: 200
Downstream Flow Scheduler Parameters
QoS Max Sustained Traffic Rate: 30000
QoS Max Traffic Burst: 1522
QoS Min Reserved Traffic Rate: 28000
QoS Min Reserved Rate Pkt Size: 0
QoS Timeout For Active Param: 0
Qos Timeout For Admitted Param: 200
The following example shows typical output for the summary option of the show controllers cable-modem service-flows command.
Router# show controllers cable-modem 0 service-flows summary
Sfid Sid Sf Sf Service Direction
13 6 Primary 2 - upstream
14 N/A Primary 1 - downstream
The following example shows typical output for the show controllers cable-modem service-flows command, when displaying information for individual service flows:
Router# show controllers cable-modem 0 service-flows 3
Upstream Flow Scheduler Parameters
QoS Max Sustained Traffic Rate: 0
QoS Max Traffic Burst: 1522
QoS Min Reserved Traffic Rate: 0
QoS Min Reserved Rate Pkt Size: 0
QoS Timeout For Active Param: 0
Qos Timeout For Admitted Param: 200
Max Concatenated Burst: 0
Request/Transmission Policy: 0x0
Nominal Polling Interval: 0
Unsolicited Grant Size: 0
Nominal Grant Interval: 0
Tolerated Grant Jitter: 0
IP TOS Overwrite: 0xFF 0x0
Router# show controllers cable-modem 0 service-flows 4
Downstream Flow Scheduler Parameters
QoS Max Sustained Traffic Rate: 0
QoS Max Traffic Burst: 1522
QoS Min Reserved Traffic Rate: 64000
QoS Min Reserved Rate Pkt Size: 0
QoS Timeout For Active Param: 0
Qos Timeout For Admitted Param: 200
Table 116 describes the significant fields shown by this command. The information shown corresponds to the QoS parameters that are listed in Appendix C of the DOCSIS 1.1 specification.
Table 116 show controllers cable-modem service-flows Field Descriptions
Field
|
Description
|
Flow Type, Sf type
|
Identifies whether the type of service-flow:
• Primary—The primary service-flow for the upstream or downstream.
• Static—A permanent secondary service-flow.
• Dynamic—A dynamically created secondary service-flow.
|
Flow Reference, Sf Ref
|
The service flow reference ID that is used to establish the Service Flow ID.
|
Service Flow ID, Sfid
|
The ID that unique identifies this service flow on the upstream or downstream.
|
Service ID, Sid
|
The service identifier (SID) that the CMTS assigns to the service flow.
|
QoS Set Type
|
The QoS parameter set type for the service flow. This is a three-bit value, where bit 0 is set for the Provisioned Set, bit 1 is set for the Admitted Set, and bit 2 is set for the Active Set. Multiple bits can be set to produce the following possible values:
• 0 = Set Active and Admitted Sets to null.
• 1 = Apply to Provisioned Set only.
• 2 = Perform admission control and apply to Admitted Set only.
• 3 = Perform admission control and apply to Provisioned and Admitted Sets.
• 4 = Check against Admitted set in separate Service Flow encoding, perform admission control if needed, activate this service flow, and apply to Active Set.
• 5 = Perform admission control, apply to Provisioned and Active Sets, and activate this service flow.
• 6 = Perform admission control, activate this service flow, and apply to Admitted and Active Sets.
• 7 = Perform admission control, activate this service flow, and apply to Provisioned, Admitted, and Active Sets.
|
QoS Traffic Priority
|
The priority assigned to the service flow (0 to 7, where 7 is the highest priority).
|
QoS Max Sustained Traffic Rate
|
The maximum traffic rate, in bits, for a token-bucket rate limit for packets.
|
QoS Max Traffic Burst
|
The maximum size of a single packet on this service flow.
|
QoS Min Reserved Traffic Rate
|
The minimum rate, in bits per second, for traffic on this service flow.
|
QoS Min Reserved Rate Pkt Size
|
The minimum packet size, in bytes, for which the minimum rate can be sustained on this service flow.
|
QoS Timeout For Active Param
|
The maximum time, in seconds, that resources on a service flow can remain unused before the CMTS sets the flow's Admitted and Active Sets to null. A value of 0 indicates no timeout period.
|
Qos Timeout For Admitted Param
|
The maximum time, in seconds, that Admitted resources on a service flow can remain without being activated. After this timeout period, the CMTS will release Admitted resources on a service flow and retain only the activated ones.
|
Max Concatenated Burst
|
The maximum burst size, in bytes, for concatenated traffic on the service flow. A value of 0 indicates no limit.
|
Scheduling Type
|
The type of service used on the upstream for grant requests:
• 1 = Undefined
• 2 = Best effort
• 3 = Non-real-time polling service (NRTPS)
• 4 = Real-time polling service (RTPS)
• 5 = Unsolicited grant service with activity detection (UGS-AD)
• 6 = Unsolicited grant service (UGS)
|
Request/Transmission Policy
|
The allowable means of grant request and transmission on the upstream. This value is a 9-bit mask where the bits have the following meanings when set to 1:
• Bit 0 = Do not use broadcast request opportunities.
• Bit 1 = Do not use priority request multicast request opportunities.
• Bit 2 = Do not use Request/Data grants for requests.
• Bit 3 = Do not use Request/Data grants for data.
• Bit 4 = Do not piggyback data on grant requests.
• Bit 5 = Do not use concatenation.
• Bit 6 = Do not use DOCSIS fragmentation.
• Bit 7 = Do not use payload header suppression (PHS).
• Bit 8 = UGS service flows must drop packets that do not fit.
See Table 117 for the possible values of each bit for each of the supported flow types.
|
Nominal Polling Interval
|
The interval, in microseconds, between successive unicast grant requests for the service flow on the upstream.
|
Tolerated Poll Jitter
|
The maximum amount of time, in microseconds, that a unicast request interval may be delayed from the typical polling schedule.
|
Unsolicited Grant Size
|
The size of unsolicited grants, in bytes.
|
Nominal Grant Interval
|
The interval, in microseconds, between successive data grant opportunities for th |