Cisco IOS CMTS Cable Command Reference
Cable Commands: show ch through show cr

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

 CHKPT on ACTIVE server.

Client Name    Client ID     Msg Send     Msg len  Bundling
                            (number of)   (Total)
-----------------------------------------------------------
CHKPT DevTest         3         0           0             On
CHKPT EXAMPLE         2         0           0             On
CR10K RP CHKPT       20         0           0             On


Router# 

The following shows typical output for the show checkpoint statistics command:

Router# show checkpoint statistics 

             Check Point Status

 CHKPT on ACTIVE server.

Number of chkpt messages currently in hold queue 0
CHKPT MAX MTU size = 1422
IPC MAX MTU size = 4096
CHKPT Pending msg timer  = 100 ms

Router# 

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],
DEVELOPMENT SOFTWARE
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
Running default software

cisco uBR10K CLC (NPE-CLC) processor (revision A) with 196608K/65536K bytes of m
emory.
Processor board ID
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 

Interface Cable1/0
Hardware is IMC11
 BCM3210 revision=0x56B2
 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 

Interface Cable6/0
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 
Late input drops = 0
Output queue: 0/1000/64/0 (size/max total/threshold/drops)
JIB version 372
 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:
   Tx Statistics
      Pkts: 48413, Lock Errs: 0, MB not Empty: 0, No Buffs: 0
   Rx Statistics
      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
  RF Power 54.9 dBmv

Router# 

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
  Dynamic Services Stats:
  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
  DSD:  0 REQs  0 RSPs
  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) 
  DCC dcc succeeds(0) 
  DCC wcm(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
   Network Delay 550 (usec)
   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
   Network Delay 550 (usec)
   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
   Network Delay 550 (usec)
   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
   Network Delay 550 (usec)
   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
  Spectrum Group 4
  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
  Range Load Reg Size=0x58
  Request Load Reg Size=0x0E
  Minislot Size in number of Timebase Ticks is = 8
  Minislot Size in Symbols =8
  Bandwidth Requests = 0x0
  Piggyback Requests = 0x0
  Invalid BW Requests= 0x0
  Minislots Requested= 0x0
  Minislots Granted  = 0x0
  Minislot Size in Bytes = 2
  UCD Count = 0
  DES Ctrl Reg#0 = C00C0C43, Reg#1 = 0

Router# 

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
  Concatenation is enabled
  Fragmentation is enabled
  part_id=0x3138, rev_id=0x02, rev2_id=0x00
  nb_agc_thr=0x0000, nb_agc_nom=0x0000
  Range Load Reg Size=0x58
  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
  Invalid BW Requests= 0x0
  Minislots Requested= 0x4499EBE
  Minislots Granted  = 0x6C67B7
  Minislot Size in Bytes = 24
  Map Advance (Dynamic) : 2454 usecs
  UCD Count = 429798
  ATDMA mode enabled
Multicast/Broadcast RateLimit Dropped Pkts : 0

Router#  

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 

Interface Cable5/1/4
Hardware is MC520S
JIB version 66
 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
  RF Power 49.8 dBmv

...

Router# 

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:

Router# show cable modem 

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  *********
02:16:49:
Router# 

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: 4995 :    -100
02:15:54: 5007 :    -67
02:15:54: 5019 :    -67
02:15:54: 5031 :    -67
02:15:54: 5043 :    -64
02:15:54: 5055 :    -64
02:15:54: 5067 :    -61
...
02:15:54: 8199 :    -67
02:15:54: 8211 :    -61
02:15:54: 8223 :    -64
02:15:54: 8235 :    -57
02:15:54: 8247 :    -49  ***
02:15:54: 8259 :    -52  **
02:15:54: 8271 :    -46  *****
02:15:54: 8283 :    -45  *****
02:15:54: 8295 :    -52  **
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  ****
02:15:54: 11343:    -53  *
02:15:54: 11355:    -55
02:15:54: 11367:    -54  *
02:15:54: 11379:    -57
02:15:54: 11391:    -61
02:15:54: 11403:    -60
02:15:54: 11415:    -60
02:15:54: 11427:    -60
02:15:54: 11439:    -61
02:15:54: 11451:    -57
02:15:54: 11463:    -58
02:15:54: 11475:    -67
02:15:54: 11487:    -58
...

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 
BCM Cable interface 0:
BCM3300 unit 0, idb 0x200EB4, ds 0x82D4748, regaddr = 0x800000, reset_mask 0x80
station address 0010.7b43.aa01  default station address 0010.7b43.aa01
PLD VERSION: 32
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
Tuner: status=0x00
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
      Config filename =
buffer size 1600
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
    ehdr: 01 06 02 74 34 11 
    01 status=0x00 bd_index=0x0001 len=0x0000 hdr_len=0x0000
    ehdr: 01 06 02 74 34 11 
    02 status=0x00 bd_index=0x0002 len=0x0000 hdr_len=0x0000
    ehdr: 01 06 02 74 34 11 
    03 status=0x00 bd_index=0x0003 len=0x0000 hdr_len=0x0000
    ehdr: 01 06 02 74 34 11 
    04 status=0x00 bd_index=0x0004 len=0x0000 hdr_len=0x0000
    ehdr: 01 06 02 74 34 11 
    05 status=0x00 bd_index=0x0005 len=0x0000 hdr_len=0x0000
    ehdr: 01 06 02 74 34 11 
    06 status=0x00 bd_index=0x0006 len=0x0000 hdr_len=0x0000
    ehdr: 01 06 02 74 34 11 
    07 status=0x20 bd_index=0x0007 len=0x0000 hdr_len=0x0000
    ehdr: 01 06 02 74 34 11 
MIB Statistics
  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
  Valid hdrs = 423
BCM3300 Registers:
downstream dma:
  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
upstream dma:
  us_bd_base=0x001FB8, us_pd_base=0x002038
  us_dma_ctrl=0x80, us_dma_tx_start=0x00
Global control and status:
  global_ctrl_status=0x00
interrupts:
  irq_pend=0x0008, irq_mask=0x00F7
Router#

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

buffer size 1856
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 

...

Tuner: status=0x00
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

Platform check 8400000

Router# 

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

Command
Description

show controllers cable-modem bpkm

Displays information about the baseline privacy key management exchange between the router and the CMTS.

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 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 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
      operational wait time:      1
      rekey wait time:            1
      tek grace time:             600
      authorization rej wait time: 60
  kek state:    STATE_B_AUTH_WAIT
  sid 4:
      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)
  public key:
      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
  hmac upstream key even:
      4E0A5108 A8451B24 BAC3A8CA D8DF459F 6D37448D
  hmac upstream key odd:
      5D04EEDD 43129682 F7A474EA 4E9F888B 5EC18478
  hmac downstream key even:
      7B6595D6 75B435FB 2FA7204D 2F203CB1 FBA80950
  hmac downstream key odd:
      E15FC10B 7F1BAFE8 6295315F E91FE97C F0DE3A73
  configuration (in seconds): 
      authorization wait time:    5
      reauthorization wait time:  30
      authorization grace time:   60
      operational wait time:      2
      rekey wait time:            2
      tek grace time:             60
      authorization rej wait time: 60
      sa map wait time:       1
      sa map retries:         4
  kek state:     STATE_C_AUTHORIZED
  kek life:      86450 sec
  sid 2:
      tek state: STATE_D_OPERATIONAL
      tek life:  21654 sec
      keys:      even 1730E9E1F0B1C4C, odd 23021AE604610E38
      ivectors:  even 16FB0175256819FD, odd B802057107302F8
      sequence:  12
 DSA map List 

Router# 

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
  Classifier Reference:    1
  Classifier ID:            2
  Service Flow Reference:  1
  Service Flow ID:         101
  Rule Priority:           0
  Activation State:        1
  Dynsrv Change Action:    0
  SID:                     90
IP classifiers:
  ToS:                     0x1 0x3 0xFF 
  Protocol:                258
  Source Address:          0.0.0.0
  Source Mask:             255.255.255.255
  Destination Address:     0.0.0.0
  Destination Mask:        255.255.255.255
  Source Port Start:       65
  Source Port End:         65
  Destination Port Start:  0
  Destination Port End:    65535
LLC Classifiers:
  Destination MAC address: 0:0:0:0:0:0:0:0:0:0:0:0
Source MAC address:      0:0:0:0:0:0
  Ether Type:              0x0 0x0 0x0 

Downstream Packet Classifiers parameters
  Classifier Reference:    1
  Classifier ID:           1
  Service Flow Reference:  6
  Service Flow id:         5
  Rule Priority:           22
  Activation State:        1
  Dynsrv Change Action:    0
  SID:                     0

IP classifiers
  Tos:                     0x1 0x3 0xFF 
  Protocol:                258
  Source Address:          0.0.0.0
  Source Mask:          255.255.255.255
  Destination Address:     0.0.0.0
  Destination Mask:     255.255.255.255
  Source Port Start:       0
  Source Port End:         65535
  Destination Port Start:  0
  Destination Port End:    65535
LLC Classifiers
 Source MAC address:      0:0:0:0:0:0
  Ether Type:              0x0 0x0 0x0 

Downstream Packet Classifiers parameters
  Classifier Reference:    2
  Classifier ID:           2
  Service Flow Reference:  7
  Service Flow id:         6
  Rule Priority:           23
  Activation State:        1
  Dynsrv Change Action:    0
  SID:                     0

IP classifiers
  Tos:                     0x5 0x5 0xD 
  Protocol:                258
  Source Address:          0.0.0.0
  Source Mask:          255.255.255.255
  Destination Address:     0.0.0.0
  Destination Mask:     255.255.255.255
  Source Port Start:       0
  Source Port End:         65535
LLC Classifiers
  Destination MAC address: 0:0:0:0:0:0:0:0:0:0:0:0
  Source MAC address:      0:0:0:0:0:0
  Ether Type:              0x0 0x0 0x0 

Downstream Packet Classifiers parameters
  Classifier Reference:    3
  Classifier ID:           3
  Service Flow Reference:  8
  Service Flow id:         7
  Rule Priority:           24
  Activation State:        1
  Dynsrv Change Action:    0
  SID:                     0

IP classifiers
  Tos:                     0x8 0xFF 0xF8 
  Protocol:                258
  Source Address:          0.0.0.0
  Source Mask:          255.255.255.255
  Destination Address:     0.0.0.0
Destination Mask:     255.255.255.255
  Source Port Start:       0
  Source Port End:         65535
  Destination Port Start:  0
  Destination Port End:    65535
LLC Classifiers
  Destination MAC address: 0:0:0:0:0:0:0:0:0:0:0:0
  Source MAC address:      0:0:0:0:0:0
  Ether Type:              0x0 0x0 0x0
Router# 

The following shows the typical display for the summary option:

Router# show controllers cable-modem 0 classifiers summary 

SFID  SF    Classifier  Classifier  Rule      State
      Ref   ID          Ref         priority        
675   1     4           10          0         active    
676   2     8           11          0         active    
1911  3     3           12          0         active    
1914  4     7           13          0         active    
1912  5     2           14          0         active    
1915  6     6           15          0         active    
1913  7     1           16          0         active    
1916  8     5           17          0         active    

Router#

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
  Classifier Reference:    10
  Classfier ID:            4
  Service Flow Reference:  1
  Service Flow ID:         675
  Rule Priority:           0
  Activation State:        1
  Dynsrv Change Action:    0
  SID:                     565
IP classifiers:
  ToS:                     0x0 0x0 0x0 
  Protocol:                258
  Source Address:          12.0.0.1
  Source Mask:             255.255.255.255
  Destination Address:     6.0.0.1
  Destination Mask:        255.255.255.255
  Source Port Start:       0
  Source Port End:         65535
  Destination Port Start:  0
  Destination Port End:    65535
LLC Classifiers:
  Destination MAC address: 0:0:0:0:0:0:0:0:0:0:0:0
  Source MAC address:      0:0:0:0:0:0
  Ether Type:              0x0 0x0 0x0 

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 

Cable Modem Certificate: 
SEQ(878)
    SEQ(727)
        Context-specific [A0](3)
            INT(1):2
            END
        INT(10): 62 E0 07 47 00 00 00 00 FA 62 
1w3d:         SEQ(13)
            OID(9):SHA Signature 1.2.840.113549.1.1.5
1w3d:             NULL
            END
        SEQ(114)
            SET(11)
                SEQ(9)
                    OID(3):Country 2.5.4.6
1w3d:                     PRT(2):US
                    END
                END
            SET(22)
                SEQ(20)
                    OID(3):Organization 2.5.4.10
1w3d:                     PRT(13):Cisco Systems
                    END
                END
            SET(15)
                SEQ(13)
                    OID(3):Organization Unit 2.5.4.11
1w3d:                     PRT(6):DOCSIS
                    END
                END
            SET(58)
                SEQ(56)
                    OID(3):Common Name 2.5.4.3
1w3d:                     PRT(49):Cisco Cable Modem Root Certificate Authority R
                    END
                END

...

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
1w3d:     END

Router# 

Note You must manually enter a return to redisplay the router prompt after the certificate has been displayed.


Related Commands

Command
Description

show controllers cable-modem manuf-cert

Displays the manufacturer's X.509 certificate for the router.


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 
downstream des:
  ds_des_key_table:
    key 0: even 0, odd 0
    key 1: even 0, odd 0
    key 2: even 0, odd 0
    key 3: even 0, odd 0
  ds_des_cbc_iv_table:
    iv  0: even 0, odd 0
    iv  1: even 0, odd 0
    iv  2: even 0, odd 0
    iv  3: even 0, odd 0
  ds_des_sid_table:
    sid_1=0x0000, sid_2=0x0000, sid_3=0x0000, sid_4=0x0000
  ds_des_sid_enable=0x80, ds_des_ctrl=0x2E
  ds_des_sv=0x0F00
  ds_unencrypted_length=0x0C
upstream des:
  us_des_key_table:
    key 0: even 0, odd 0
    key 1: even 0, odd 0
    key 2: even 0, odd 0
    key 3: even 0, odd 0
  us_des_cbc_iv_table:
    iv  0: even 0, odd 0
    iv  1: even 0, odd 0
    iv  2: even 0, odd 0
    iv  3: even 0, odd 0
  pb_req_bytes_to_minislots=0x10
  us_des_ctrl=0x00, us_des_sid_1= 0x1234
  ds_unencrypted_length=0x0C

Router#

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:
  ds_mac_da_filters:
    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
  ds_mac_da_mc=01E02F00
  map_parser_sids:
    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
  reg_rang_req_sid=0x0000
downstream data processing:
  ds_data_da_filter_table:
    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
  ds_data_da_mc=01000000
upstream processing:
  us_ctrl_status=0x04, Minislots per request=0x01
  burst_maps:
    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
  us_sid_table:
    sid_1=0x0000, sid_2=0x0000, sid_3=0x0000, sid_4=0x0000
  max_re_req=0x0010, rang_fifo=0x00
Router# 

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
Router# 

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 
00 
: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

Router#

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

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

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
Router# 

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 
Router# 

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 
Router# 

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 

PLD VERSION: 32
BCM3300 unit 0, idb 0x200EB4, ds 0x82D4748, regaddr = 0x800000, reset_mask
0x80
station address 0010.7b43.aa01  default station address 0010.7b43.aa01
MAC mcfilter 01E02F00  data mcfilter 01000000
buffer size 1600
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
    ehdr:  00 00 00 2E FF FF
    01 status=0x00 bd_index=0x0001 len=0x0000 hdr_len=0x0000
    ehdr:  00 00 00 2E FF FF
    02 status=0x00 bd_index=0x0002 len=0x0000 hdr_len=0x0000
    ehdr:  00 00 00 2E FF FF
    03 status=0x00 bd_index=0x0003 len=0x0000 hdr_len=0x0000
    ehdr:  00 00 00 2E FF FF
    04 status=0x00 bd_index=0x0004 len=0x0000 hdr_len=0x0000
    ehdr:  00 00 00 2E 00 00
    05 status=0x00 bd_index=0x0005 len=0x0000 hdr_len=0x0000
    ehdr:  00 00 00 2E 00 00
    06 status=0x00 bd_index=0x0006 len=0x0000 hdr_len=0x0000
    ehdr:  00 00 00 00 00 00
    07 status=0x20 bd_index=0x0007 len=0x0000 hdr_len=0x0000
    ehdr:  00 00 00 00 00 00
MIB Statistics
  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
  Valid hdrs = 0
BCM3300 Registers:
downstream dma:
  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
upstream dma:
  us_bd_base=0x001FB8, us_pd_base=0x002038
  us_dma_ctrl=0x00, us_dma_tx_start=0x00
global control and status:
  global_ctrl_status=0x00
interrupts:
  irq_pend=0x0018, irq_mask=0x00E7
timing recovery circuit:
  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
  timeout_err=0x00
spi:
  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
burst profiles:
  profile 0:
             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
  profile 1:
             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
  profile 2:
             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
  profile 3:
             00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
             00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
             00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
             00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

Router# 

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
Ranging SID:                5
Registered:                 TRUE
Privacy Established:        TRUE
Privacy Version:            BPI+ (PLUS)
DOCSIS Operating Mode:      DOCSIS 1.1

Snmp Operating Mode:        Co-existence Mode

MIB Values:
  Mac Resets:       0
  Sync lost:        0
  Invalid Maps:     0
  Invalid UCDs:     0
  Invalid Rng Rsp:  0
  Invalid Reg Rsp:  0
  T1 Timeouts:      0
  T2 Timeouts:      0
  T3 Timeouts:      4
  T4 Timeouts:      0
  Range Aborts:     0

DS ID:                      1
DS Frequency:               663000000
DS Symbol Rate:             5056941
DS QAM Mode                 64QAM
DS Search:
  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 ID:                      1
US Frequency:               20000000
US Power Level:             34.0 (dBmV)
US Symbol Rate:             1280000
Ranging Offset:             12460
Mini-Slot Size:             8
Change Count:               4
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
Burst Descriptor  0:
  Interval Usage Code:      1
  Modulation Type:          1
  Differential Encoding:    2
  Preamble Length:          64
  Preamble Value Offset:    56
  FEC Error Correction:     0
  FEC Codeword Info Bytes:  16
  Scrambler Seed:           338
  Maximum Burst Size:       1
  Guard Time Size:          8
  Last Codeword Length:     1
  Scrambler on/off:         1
Burst Descriptor  1:
  Interval Usage Code:      3
  Modulation Type:          1
  Differential Encoding:    2
  Preamble Length:          128
  Preamble Value Offset:    0
  FEC Error Correction:     5
  FEC Codeword Info Bytes:  34
  Scrambler Seed:           338
  Maximum Burst Size:       0
  Guard Time Size:          48
  Last Codeword Length:     1
  Scrambler on/off:         1
Burst Descriptor  2:
  Interval Usage Code:      4
  Modulation Type:          1
  Differential Encoding:    2
  Preamble Length:          128
  Preamble Value Offset:    0
  FEC Error Correction:     5
  FEC Codeword Info Bytes:  34
  Scrambler Seed:           338
  Maximum Burst Size:       0
  Guard Time Size:          48
  Last Codeword Length:     1
  Scrambler on/off:         1
Burst Descriptor  3:
  Interval Usage Code:      5
  Modulation Type:          1
  Differential Encoding:    2
  Preamble Length:          72
  Preamble Value Offset:    48
  FEC Error Correction:     5
  FEC Codeword Info Bytes:  75
  Scrambler Seed:           338
  Maximum Burst Size:       0
  Guard Time Size:          8
  Last Codeword Length:     1
  Scrambler on/off:         1
Config File:
  Network Access:           TRUE
  Concatenation:            Disabled
  Maximum CPEs:             8
  SNMP MIB Object:          0000000000000000000000000000000000000000000000000000
  Vendor ID:                0.240.30
    Baseline Privacy:
    Auth. Wait Timeout:     10
    Reauth. Wait Timeout:   10
    Auth. Grace Time:       600
    Op. Wait Timeout:       1
    Retry Wait Timeout:     1
    TEK Grace Time:         600
    Auth. Reject Wait Time: 60
  COS  1:
    Assigned SID:           5
    Max Downstream Rate:    4000000
    Max Upstream Rate:      2000000
    Upstream Priority:      7
    Min Upstream Rate:      100000
    Max Upstream Burst:     12
    Privacy Enable:         TRUE
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)
IP Address:                 0.0.0.0
Net Mask:                   0.0.0.0

TFTP Server IP Address:     223.255.254.254
Time Server IP Address:     188.188.1.5
Config File Name:           muck/ebuell/tftp/cm_conf
Time Zone Offset:           -28800
Log Server IP Address:      0.0.0.0

Drop Ack Enabled:           TRUE
Piggyback when Ccat On:     Disabled

Mac Sid Status
Max Sids: 4  Sids In Use: 1
 SFid      Sid      State   Type     rxtx Parm State    Idb

   5         2        2       2       F4      7       811C24B0

Router# 

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: 
SEQ(819)
    SEQ(539)
        Context-specific [A0](3)
            INT(1):2
            END
        INT(16): 0B F5 94 FD 7B 4E E0 79 90 83 5C A9 A4 BE A0 3E
1w3d:         SEQ(13)
            OID(9):SHA Signature 1.2.840.113549.1.1.5
1w3d:             NULL
            END
        SEQ(151)
            SET(11)
                SEQ(9)
                    OID(3):Country 2.5.4.6
1w3d:                     PRT(2):US
                    END
                END
            SET(57)
                SEQ(55)
                    OID(3):Organization 2.5.4.10
1w3d:                     PRT(48):Data Over Cable Service Interface Specification
                    END
                END
            SET(21)
                SEQ(19)
                    OID(3):Organization Unit 2.5.4.11
1w3d:                     PRT(12):Cable Modems
                    END
                END

...

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
1w3d:     END

Router# 

Note You must manually enter a return to redisplay the router prompt after the certificate has been displayed.


Related Commands

Command
Description

show controllers cable-modem cmcert

Displays the router's public key X.509 certificate.


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 

Upstream PHS Parameters

PHS Parameters
  PHS Classifier Refer:           2
  PHS Classifier ID:              1
  PHS Service Flow Reference:     1
  PHS Service Flow ID:            3
  PHS Dynsrv Change Action:       0
  PHS Fields:                     
  PHS Index:                      1
  PHS Mask:                       0x00 0x00 0x00 0x03 0xC0 
  PHS Size:                       0
  PHS Verification:               0

Upstream PHS Parameters

PHS Parameters
  PHS Classifier Refer:           2
  PHS Classifier ID:              1
  PHS Service Flow Reference:     1
  PHS Service Flow ID:            3
  PHS Dynsrv Change Action:       0
  PHS Fields:                     
  PHS Index:                      1
  PHS Mask:                       0x00 0x00 0x00 0x03 0xC0 
  PHS Size:                       0
  PHS Verification:               0

Upstream PHS Parameters

PHS Parameters
  PHS Classifier Refer:           2
  PHS Classifier ID:              1
  PHS Service Flow Reference:     1
  PHS Service Flow ID:            3
  PHS Dynsrv Change Action:       0
  PHS Fields:                     
  PHS Index:                      1
  PHS Mask:                       0x00 0x00 0x00 0x03 0xC0 
  PHS Size:                       0
  PHS Verification:               0

...

Downstream PHS Parameters

PHS Parameters
  PHS Classifier Refer:           1
  PHS Classifier ID:              2
  PHS Service Flow Reference:     2
  PHS Service Flow ID:            4
  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 
  PHS Index:                      1
  PHS Mask:                       0x00 0x03 0xC0 
  PHS Size:                       22
  PHS Verification:               0

Downstream PHS Parameters

PHS Parameters
  PHS Classifier Refer:           3
  PHS Classifier ID:              3
  PHS Service Flow Reference:     4
  PHS Service Flow ID:            10
  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 
  PHS Index:                      2
  PHS Mask:                       0x00 0x00 0x3C 
  PHS Size:                       0
  PHS Verification:               0

Router# 

The following shows a typical display for a specific PHS rule:

Router# show controllers cable-modem 0 phs 3 

Downstream PHS Parameters

PHS Parameters
  PHS Classifier Refer:           15
  PHS Classifier ID:              6
  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 Index:                      3
  PHS Mask:                       0xF0 0x00 0x01 0xFF 0xAB 
  PHS Size:                       34
  PHS Verification:               0

Router#

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

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 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
  tunset=00  tunctl=03
 
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
Bit Error Rate Count: 0
Router# 

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
port        = 6F         pll         = F7
map         = 66         mod         = 28
tx_oen_bdly = 14         tx_oen_edly = C8
prbs_cfg    = 00C000     baud        = 1A36E3
burst       = 0000       if_freq     = 200000
dac         = 37         tx_config   = 00
 
burst config 0 : prbs_init    = FFFFFF   rs      = 343E
                 fec          = 00       qam     = 01
                 pream_len    = 0018     offset  = 0000
burst config 1 : prbs_init    = FFFFFE   rs      = 033B
                 fec          = 1C       qam     = 65
                 pream_len    = 0000     offset  = 0000
burst config 2 : prbs_init    = FFFFFE   rs      = 033B
                 fec          = 1D       qam     = 65
                 pream_len    = 0000     offset  = 0000
burst config 3 : prbs_init    = FFFFFE   rs      = 033B
                 fec          = 1E       qam     = 65
burst config 4 : prbs_init    = FFFFFE   rs      = 033B
                 fec          = 1F       qam     = 65
                 pream_len    = 0000     offset  = 0000
burst config 5 : prbs_init    = FFFFFE   rs      = 033B
                 fec          = 0F       qam     = 66
                 pream_len    = 0000     offset  = 0000
Eq Coeff:
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
 
Preamble values:
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

Router# 

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
2       0       NA      0       0       0               0       0
3       0       NA      0       0       0               0       0

Router# 

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
        packets cbr cc fr nbr

0       2       F  T  T  F

1       0       T  T  T  T

2       0       T  T  T  T

3       0       F  T  T  T

Router#

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
        packets cbr cc fr nbr

0       2       F  T  T  F

1       0       T  T  T  T

2       0       T  T  T  T

3       0       F  T  T  T

Packet Classifiers 

Class id   SFID   Pri     valid    Match     SIDT
   1       1913    0        14       0      811EDDE8
   2       1912    0        14       0      811EDBB8
   3       1911    0        14       0      811ED988
   4       675    0        14       0      811ED758
PHS: Inactive
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

Router# 

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
3       0       NA      0       0       0       0       0        F  F  F  F


Queue    SF Type
0        BE 
1        BE 
2        UGS_AD
3        NA


Packet Classifiers 

Class id   SFID   Pri     valid    Match     SIDT
   1       91    0        D6       1782      80D2754C
   2       93    0        D6       691       80D275C0

Packet Classifier Details

Classifier id = 1    SFID =  91
IP source: 10.188.1.88
IP dest: 10.188.1.66
UDP/TCP source range: 18416   to  18416
UDP/TCP dest range: 16740   to  16740
IP Protocol: 17
PHS: Inactive

Classifier id = 2    SFID =  93
IP source: 10.188.1.88
IP dest: 10.188.1.66
UDP/TCP source range: 16796   to  16796
UDP/TCP dest range: 19138   to  19138
IP Protocol: 17
PHS: Inactive

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
Flow Type: Primary
  Flow Reference:                 1
  Service Flow ID:                3
  Service ID:                     2
  QoS Set Type:                   7
  QoS Traffic Priority:           0
  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
  Scheduling Type:                0x2
  Request/Transmission Policy:    0x0
  Nominal Polling Interval:       0
  Tolerated Poll Jitter:          0
  Unsolicited Grant Size:         0
  Nominal Grant Interval:         0
  Tolerated Grant Jitter:         0
  Grants Per Interval:            0
  IP TOS Overwrite:               0xFF 0x0

Downstream Flow Scheduler Parameters
Flow Type: Primary 
  Flow Reference:                 5
  Service Flow ID:                4
  Service ID:                     0
  QoS Set Type:                   7
  QoS Traffic Priority:           0
  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
  Max DS Latency:                 0

Downstream Flow Scheduler Parameters
Flow Type: Static
  Flow Reference:                 6
  Service Flow ID:                5
  Service ID:                     0
  QoS Set Type:                   7
  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
  Max DS Latency:                 0

Downstream Flow Scheduler Parameters
Flow Type: Static
  Flow Reference:                 8
  Service Flow ID:                7
  Service ID:                     0
  QoS Set Type:                   7
  QoS Traffic Priority:           0
  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
  Max DS Latency:                 0

Router# 

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
             type      Ref   Class name 
13     6     Primary   2     -                    upstream 
14     N/A   Primary   1     -                    downstream 

Router# 

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
Flow Type: Primary
  Flow Reference:                 1
  Service Flow ID:                3
  Service ID:                     2
  QoS Set Type:                   7
  QoS Traffic Priority:           0
  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
  Scheduling Type:                0x2
  Request/Transmission Policy:    0x0
  Nominal Polling Interval:       0
  Tolerated Poll Jitter:          0
  Unsolicited Grant Size:         0
  Nominal Grant Interval:         0
  Tolerated Grant Jitter:         0
  Grants Per Interval:            0
  IP TOS Overwrite:               0xFF 0x0

Router# show controllers cable-modem 0 service-flows 4 

Downstream Flow Scheduler Parameters
Flow Type: Primary 
  Flow Reference:                 5
  Service Flow ID:                4
  Service ID:                     0
  QoS Set Type:                   7
  QoS Traffic Priority:           0
  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
  Max DS Latency:                 0

Router# 

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