Cisco IOS CMTS Cable Command Reference
Cable Commands: show cable m to show cable u

Table Of Contents

Cable Commands: show cable m through show cable u

show cable mac-domain cable forwarding

show cable mac-domain cgd-associations

show cable mac-domain downstream-service-group

show cable mac-domain rcc

show cable mac-domain upstream-service-group

show cable metering-status

show cable modem

show cable modem access-group

show cable modem auth-profile

show cable modem calls

show cable modem classifiers

show cable modem cnr

show cable modem connectivity

show cable modem counters

show cable modem cpe

show cable modem docsis device-class

show cable modem docsis version

show cable modem domain-name

show cable modem errors

show cable modem extended-power

show cable modem flap

show cable modem ipv6

show cable modem mac

show cable modem maintenance

show cable modem offline

show cable modem partial-mode

show cable modem phy

show cable modem primary-channel

show cable modem primary-channel summary total

show cable modem privacy

show cable modem qos

show cable modem registered

show cable modem remote-query

show cable modem rf-adapt

show cable modem rogue

show cable modem service-type-id

show cable modem service-flow

show cable modem summary

show cable modem summary wb-rf

show cable modem type

show cable modem unregistered

show cable modem vendor

show cable modem voice

show cable modem wideband

show cable modem wideband primary-channel

show cable modem wideband rcs-status

show cable modulation-profile

show cable multicast authorization

show cable multicast db

show cable multicast debug

show cable multicast dsid

show cable multicast qos

show cable multicast statistics failure

show cable noise

show cable privacy

show cable qos enforce-rule

show cable qos permission

show cable qos profile

show cable rate-adapt

show cable rate-limit-ccf

show cable redundancy

show cable rf-adapt

show cable rf-status

show cable rsvp flow-db

show cable service-class

show cable service-voice downstream-type

show cable signal-quality

show cable spectrum-analysis

show cable spectrum-group

show cable subscriber-usage

show cable tech-support

show cable urm

show cable us-sg


Cable Commands: show cable m through show cable u


Revised: December 2011, OL-15510-14

New Commands

Command
Cisco IOS Software Release

show cable mac-domain cable forwarding

12.3(23)BC

show cable mac-domain cgd-associations

12.3(23)BC

show cable modem domain-name

12.2(33)SCA

show cable modem ipv6

12.2(33)SCA

show cable modem voice

12.3(23)BC

show cable modem primary-channel

12.3(23)BC

show cable modem type

12.2(33)SCA

show cable modem wideband primary-channel

12.3(23)BC

show cable rate-adapt

12.3(23)BC2

show cable service-voice downstream-type

12.3(23)BC

show cable mac-domain rcc

12.2(33)SCB

show cable rf-status

12.2(33)SCB

show cable rsvp flow-db

12.2(33)SCB

show cable modem auth-profile

12.2(33)SCB

show cable modem service-type-id

12.2(33)SCB

show cable modem summary wb-rf

12.2(33)SCB

show cable modem wideband rcs-status

12.2(33)SCB

show cable multicast authorization

12.2(33)SCB

show cable multicast db

12.2(33)SCB

show cable multicast dsid

12.2(33)SCB

show cable multicast qos

12.2(33)SCB

show cable modem service-flow

12.2(33)SCB1

show cable mac-domain upstream-service-group

12.2(33)SCC

show cable rate-limit-ccf

12.2(33)SCC

show cable signal-quality

12.2(33)SCC

show cable spectrum-analysis

12.2(33)SCC

show cable us-sg

12.2(33)SCC

show cable modem partial-mode

12.2(33)SCD2

show cable multicast debug

12.2(33)SCE

show cable urm

12.2(33)SCE

show cable modem rf-adapt

12.2(33)SCF

show cable multicast statistics failure

12.2(33)SCF

show cable rf-adapt

12.2(33)SCF

show cable modem extended-power

12.2(33)SCF2


Modified Commands

Command
Cisco IOS Software Release

show cable mac-domain downstream-service-group

12.3(23)BC

show cable modem

12.3(23)BC, 12.2(33)SCA

show cable modem calls

12.2(33)SCA

show cable modem classifiers

12.2(33)SCA

show cable modem cnr

12.2(33)SCA

show cable modem connectivity

12.2(33)SCA

show cable modem counters

12.2(33)SCA

show cable modem cpe

12.2(33)SCA

show cable modem docsis device-class

12.2(33)SCA

show cable modem errors

12.2(33)SCA

show cable modem flap

12.2(33)SCA

show cable modem mac

12.2(33)SCA

show cable modem maintenance

12.2(33)SCA

show cable modem offline

12.2(33)SCA

show cable modem phy

12.2(33)SCA

show cable modem qos

12.2(33)SCA

show cable modem registered

12.2(33)SCA

show cable modem rogue

12.2(33)SCA

show cable modem remote-query

12.3(23)BC

show cable modem phy

12.2(33)SCA

show cable modem

12.2(33)SCB

show cable mac-domain cgd-associations

12.2(33)SCB

show cable mac-domain downstream-service-group

12.2(33)SCB

show cable modem wideband

12.2(33)SCB

show cable modem wideband rcs-status

12.2(33)SCB

show cable qos enforce-rule

12.2(33)SCB

show cable rate-adapt

12.2(33)SCB

show cable modem service-flow

12.3(23)BC7

show cable modem

12.2(33)SCC

show cable modem cnr

12.2(33)SCC

show cable modem flap

12.2(33)SCC

show cable modem phy

12.2(33)SCC

show cable modem qos

12.2(33)SCC

show cable multicast dsid

12.2(33)SCC

show cable service-class

12.2(33)SCC

show cable mac-domain downstream-service-group

12.2(33)SCD

show cable mac-domain cgd-associations

12.2(33)SCD

show cable mac-domain rcc

12.2(33)SCD

show cable modem

12.2(33)SCD

show cable multicast dsid

12.2(33)SCD

show cable modem

12.2(33)SCD2

show cable modem docsis version

12.2(33)SCD2

show cable qos enforce-rule

12.2(33)SCD2

show cable modem service-flow

12.2(33)SCE

show cable multicast db

12.2(33)SCE

show cable multicast qos

12.2(33)SCE

show cable privacy

12.2(33)SCE

show cable mac-domain cable forwarding

12.2(33)SCF

show cable modem

12.2(33)SCF

show cable modem access-group

12.2(33)SCF

show cable modem calls

12.2(33)SCF

show cable modem cnr

12.2(33)SCF

show cable modem connectivity

12.2(33)SCF

show cable modem counters

12.2(33)SCF

show cable modem docsis version

12.2(33)SCF

show cable modem domain-name

12.2(33)SCF

show cable modem errors

12.2(33)SCF

show cable modem flap

12.2(33)SCF

show cable modem ipv6

12.2(33)SCF

show cable modem mac

12.2(33)SCF

show cable modem maintenance

12.2(33)SCF

show cable modem offline

12.2(33)SCF

show cable modem phy

12.2(33)SCF

show cable modem primary channel

12.2(33)SCF

show cable modem qos service-class

12.2(33)SCF

show cable modem registered

12.2(33)SCF

show cable modem rogue

12.2(33)SCF

show cable modem summary

12.2(33)SCF

show cable modem type

12.2(33)SCF

how cable modem unregistered

12.2(33)SCF

show cable modem vendor

12.2(33)SCF

show cable modem wideband

12.2(33)SCF

show cable multicast db

12.2(33)SCF

show cable modem

12.2(33)SCE4

show cable modem service-flow

12.2(33)SCF2

show cable service-class

12.2(33)SCF2


show cable mac-domain cable forwarding

To display all the interfaces (wideband and modular) and statistics belonging to the Mac domain, use the show cable mac-domain cable forwarding command in privileged EXEC mode.

show cable mac-domain cable slot/subslot/port forwarding

Syntax Description

slot

Specifies the chassis slot number of the cable interface line card. Valid values are 5 to 8.

subslot

Specifies the secondary slot number of the cable interface line card. Valid subslots are 0 or 1.

port

Specifies the port number. Valid values are 0 to 4 (depending on the cable interface).

forwarding

Displays the forwarding statistics for the cable line cards.


Command Default

No default behavior or values.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.3(23)BC

This command was introduced.

12.2(33)SCA

This command is integrated in Cisco IOS Release 12.2(33)SCA.


Usage Guidelines

The show cable mac-domain cable forwarding command does not support wideband and modular interfaces. However, if wideband and modular interfaces belong to the Mac domain, the interfaces are listed in the output with the interface state.

Starting with Cisco IOS Release 12.2(33)SCF, for a chassis loaded with the UBR-MC20X20V or uBR-MC3GX60V line cards, and legacy uBR-MC5X20 line cards, the show cable mac-domain cable forwarding command shall not display the legacy downstream information for the UBR-MC20X20V and the uBR-MC3GX60V line cards.

Examples

The following is sample output of the show cable mac-domain cable forwarding command on the cable interface at 8/0/0:

Router# show cable mac-domain cable 8/0/0 forwarding
Interface            Output            Interface     Reserved/    Interface
Name           Packets   Rate          Bandwidth     Reservable   State
               (bytes)   (bits/sec)     (Kbps)       Bandwidth
------------------------------------------------------------------------------
Ca8/0/0         201358            0        26000     6500/19500         UP
Mo1/0/0:0       344340            0         4160     1040/3120          UP
Mo1/0/0:1       252132            0         7800     1950/5850          UP
Mo1/0/0:2       252132            0         7800     1950/5850          UP
Wi1/0/0:0       198916            0         7803     1951/5852          UP
Wi1/0/0:1         1152            0        10404     2601/7803          UP

Table 63 describes the significant fields shown in the display.

Table 1 show cable mac-domain cable forwarding Field Descriptions 

Field
Description

Interface Name

The name of the interface belonging to Mac domain.

Output Packets/Rate

The cumulative packets output and output rate.

Interface Bandwidth

The total interface bandwidth allocated.

Reserved/Reservable Bandwidth

The total reserved and available bandwidth.

Interface State

Indicates whether the interface is up or down.


show cable mac-domain cgd-associations

To display a summary of the Channel Grouping Domain (CGD) associations for all cable MAC domains, use the show cable mac-domain cgd-associations command in privileged EXEC mode.

Cisco uBR10012 Router

show cable mac-domain cable slot/subslot/port cgd-associations

Cisco uBR7225VXR and Cisco uBR7246VXR Routers

show cable mac-domain cable slot/port cgd-associations

Syntax Description

cable slot/subslot/port

Identifies the cable interface on the Cisco uBR10012 router.

slot—Slot where the line card resides. The valid range is from 5 to 8.

subslot—Subslot where the line card resides. Available slots are 0 or 1.

port—Downstream controller number on the line card. Valid port values are from 0 to 4.

cable slot/port

Identifies the cable interface on the Cisco uBR7246VXR or Cisco uBR7225VXR router.

slot—Slot where the line card resides.

Cisco uBR7246VXR router: The valid range is from 3 to 6.

Cisco uBR7225VXR router: The valid range is from 1 to 2.

port—Downstream port number on the line card. The valid port value is 0 or 1.


Command Default

None

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.3(23)BC

This command was introduced for the Cisco uBR10012 router.

12.2(33)SCB

This command was integrated into Cisco IOS Release 12.2(33)SCB.


Usage Guidelines

The show cable mac-domain cgd-associations command displays the following information for each cable MAC domain:

Shared port adapter (SPA) downstream channels that have been added to each MAC domain.

Upstream channels associated with each SPA downstream channel and the downstream channels of the integrated cable interface line card.

If the All column in the command output indicates Y, then this indicates that all upstream channels associated with the line card downtream channels or SPA downstream channels are configured using the upstream cable connector command. If all upstream channels are not configured, then this column will not display.

The SPA downsteam channels that are currently active.

A SPA downstream channel is active when the corresponding modular cable interface, which represents the SPA downstream channel, and its line protocol are up. A SPA downstream channel that is considered active is an operational primary downstream channel in the cable MAC domain.


Note For more information on Channel Grouping Domains, refer to the Cisco DOCSIS 3.0 Downstream Solution Design and Implementation Guide, Release 2.0.


Examples

Cisco IOS Release 12.3(23)BC

The following is a sample output of the show cable mac-domain cgd-associations command for the cable interface at slot 6, subslot 0, and port 0:

Router# show cable mac-domain c6/0/0 cgd-associations
CGD Host  SPA   DS Channels             Upstreams (All)   Active Remote DS
Ca6/0/0         Local                   1            Y
          1/0/0 0-1                     0

Cisco IOS Release 12.2(33)SCB

The following is a sample output of the show cable mac-domain cgd-associations command for the cable interface at slot 7, subslot 0, and port 0:

Router# show cable mac-domain Cable7/0/0 cgd-associations
CGD Host  Resource  DS Channels            Upstreams (AllUS)   Active Remote DS
Ca7/0/0   7/0/0     0                      0
          3/1/0     0-2                    0
                                                               0-2

Related Commands

Command
Description

show cable mac-domain downstream-service-group

Displays MAC Domain Downstream Service Group information for the primary downstream channel.


show cable mac-domain downstream-service-group

To display MAC Domain Downstream Service Group information for a primary downstream channel, use the show cable mac-domain downstream-service-group command in privileged EXEC mode.

Cisco uBR7225VXR and Cisco uBR7246VXR Universal Broadband Routers

show cable mac-domain cable slot/port downstream-service-group

Cisco uBR10012 Universal Broadband Router

show cable mac-domain cable slot/subslot/port downstream-service-group

Syntax Description

slot

Slot where the line card resides.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR7225VXR router—The valid range is from 1 to 2.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

The subslot used for the cable interface line card. Valid values are 0 or 1.

port

The downstream port used as a primary downstream channel. Valid values are from 0 to 4 (depending on the cable interface).


Command Default

No default behavior or values

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.3(21)BC

This command was introduced for the Cisco uBR10012 router.

12.3(23)BC

This command displays the MAC Domain Downstream Service Group information for primary downstream channels from the SPA as well as the Cisco uBR10-MC5X20 line card.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA.

12.2(33)SCD

This command was modified. Support was added for Cisco uBR7225VXR and Cisco uBR7246VXR routers.


Usage Guidelines

Use the show cable mac-domain downstream-service-group command to display MAC Domain Downstream Service Group (MD-DS-SG) information for the specified primary downstream channel.

For each fiber node, a traditional DOCSIS downstream channel on a Cisco uBR10-MC5X20 cable interface line card is used to carry MAC management and signaling messages, and the associated traditional DOCSIS upstream channel is used for return data traffic and signaling. The traditional DOCSIS downstream channel used in this way for a MAC domain is called the primary downstream channel.


Note Beginning in Cisco IOS Release 12.3(23)BC, either an RF channel from the SPA or a Cisc uBR10-MC5X20 downstream channel can serve as a primary channel in a fiber node. Changes in Cisco IOS Release 12.3(23)BC apply to Cisco IOS Release 12.2(33)SCB and do not apply to Cisco IOS Release 12.2(33)SCA.


Examples

The following two examples display show cable mac-domain downstream-service-group output for the primary downstream channel on the cable interface at slot/subslot/port 5/0/0:

Cisco IOS Release 12.3(21)BC

Router# show cable mac-domain cable5/0/0 downstream-service-group 
Primary  MD-DS-SG         RF                                                            
IF       Id        SPA    Chan                                                          
C5/0/0   1         1/0/0  0 - 1

Cisco IOS Release 12.3(23)BC

Router# show cable mac-domain cable5/0/0 downstream-service-group 
Cable    MD-DS-SG         RF       Local         Remote
IF       Id        SPA    Chan     Primary Chan  Primary Chan
C5/0/0   1         1/0/0  00-01    Yes

In the preceding examples, the MD-DS-SG with ID 1 is used for RF channels 0 and 1 on the Wideband SPA located in slot/subslot/bay 1/0/0.

Cisco IOS Release 12.2(33)SCB

The following example shows a sample output of the show cable mac-domain downstream-service-group command for the primary downstream channel on the cable interface at slot/subslot/port 7/0/0:

Router# show cable mac-domain Cable7/0/0 downstream-service-group
Cable    MD-DS-SG              RF
IF       Id        Resource    Chan     Primary Chan
C7/0/0   1         3/1/0       00-02    0 1 2
                   7/0/0       00       0

Cisco IOS Release 12.2(33)SCD

The following example shows a sample output of the show cable mac-domain downstream-service-group command for the primary downstream channel on the cable interface at slot/port 5/0:

Router# show cable mac-domain cable 5/0 downstream-service-group
Cable    MD-DS-SG              RF
IF       Id        Resource    Chan     Primary Chan
C5/0     1         5/0         00-03    0

Related Commands

Command
Description

show cable modem

Displays information for registered and unregistered cable modems (including wideband cable modems).

show cable modem wideband

Displays information for registered and unregistered wideband cable modems.


show cable mac-domain rcc

To display runtime receive channel configuration (RCC) on a cable line card interface, use the show cable mac-domain rcc command in privileged EXEC mode.

Cisco uBR7225VXR and Cisco uBR7246VXR Universal Broadband Routers

show cable mac-domain cable slot/port rcc

Cisco uBR10012 Universal Broadband Router

show cable mac-domain cable slot/subslot/port rcc

Syntax Description

slot

Slot where the line card resides.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR7225VXR router—The valid range is from 1 to 2.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

Specifies the secondary slot number of the cable interface line card. Valid subslots are 0 or 1.

port

Specifies the port number. Valid values are 0 to 4 (depending on the cable interface).


Command Default

No default behavior or values.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCB

This command was introduced.

12.2(33)SCD

This command was modified. Support was added for Cisco uBR7225VXR and Cisco uBR7246VXR routers.


Examples

The following is a sample output of the show cable mac-domain rcc command on the cable interface at slot/subslot/port 8/0/0:

Router# show cable mac-domain cable 8/0/0 rcc
RCC-ID   RCP                 RCs MD-DS-SG CMs   WB/RCC-TMPL
1        00 00 00 00 00      2   0        0     WB (101)
2        00 10 00 00 03      3   2        0     RCC-TMPL (1)

The following is a sample output of the show cable mac-domain rcc command on the cable interface at slot/port 5/0:

Router# show cable mac-domain cable 5/0 rcc
RCC-ID   RCP                 RCs MD-DS-SG CMs   WB/RCC-TMPL
1        00 00 00 00 00      3   0        3     WB (25)

Table 2 describes the significant fields shown in the display.

Table 2 show cable mac-domain rcc Field Descriptions

Field
Description

RCC-ID

RCC index per MAC domain. The RCC ID refers to the RCC ID output from the show cable modem wideband command.

RCP

The receive channel profile associated with the RCC object.

RCs

Total number of DS channels.

MD-DS-SG

Indicates the MAC domain DS service group for which the RCC is generated.

CM

Total number of CMs associated with the RCC object.

WB/RCC-TMPL

Indicates the wideband interface or the RCC template.



Note A zero value in the RCP or MD-DS-SG field indicates that the RCC is generated directly through a wideband interface configuration and not through any RCC templates.


Related Commands

Command
Description

show interface rf-status

Displays the logical up and down state for each of the configured RF channels for a wideband interface.


show cable mac-domain upstream-service-group

To display runtime statistics of the MAC domain upstream service group on a cable interface line card, use the show cable mac-domain upstream-service-group command in privileged EXEC mode.

show cable mac-domain cable slot/subslot/port upstream-service-group

Syntax Description

slot

Chassis slot number of the cable interface line card. The valid range is from 0 to 8.

subslot

Secondary slot number of the cable interface line card. Valid values are 0 or 1.

port

Port number. The valid range is from 0 to 4 (depending on the cable interface).

upstream-service-group

Specifies the upstream service group number.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCC

This command was introduced.


Usage Guidelines

This command displays privacy information of a particular CM, identified by its IP address or MAC address.

Examples

The following is a sample output of the show cable mac-domain upstream-service-group command on the cable interface line card at slot/subslot/port 7/1/0:

Router# show cable mac-domain cable 7/1/0 upstream-service-group
Cable MD 7/1/0
US-SG-ID  : 1         US-Chan : U0,1,2,3,4
Primary-DS: 5/1/0:0   US-SG-ID: 1
  MDD US-List   : U0,1,2,3
  MDD Ambiguity : U0,1,2,3
Primary-DS: 3/0/0:0   US-SG-ID: 1
  MDD US-List   : U0,1,2,3,4
  MDD Ambiguity : U0,1,2,3,4
Primary-DS: 3/0/0:1   US-SG-ID: 1
  MDD US-List   : U0,1,2,3,4
  MDD Ambiguity : U0,1,2,3,4
Primary-DS: 3/0/0:2   US-SG-ID: 1
  MDD US-List   : U0,1,2,3,4
  MDD Ambiguity : U0,1,2,3,4
Primary-DS: 3/0/0:3   US-SG-ID: 1
  MDD US-List   : U0,1,2,3,4
  MDD Ambiguity : U0,1,2,3,4

Table 3 describes the significant fields shown in the display.

Table 3 show cable mac-domain upstream-service-group Field Descriptions 

Field
Description

US-SG-ID

Upstream service group ID.

US-chan

Total number of upstream channels on the cable interface line card.

Primary-DS

The primary downstream interface.

MDD US-List

MAC management message: MDD TLV type 7 content, upstream active channel list.

MDD Ambiguity

MAC management message: MDD TLV type 8 content, upstream ambiguity resolution channel list.


Related Commands

Command
Description

show interface rf-status

Displays the logical up and down states for each of the configured RF channels on a wideband interface.


show cable metering-status

To display information about the most recent successful usage-based billing operation, use the show cable metering-status command in privileged EXEC mode.

show cable metering-status [verbose]

Syntax Description

verbose

(Optional) Displays the information in a more readable format.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(9a)BC

This command was introduced.

12.2(33)SCB

SAMIS over Internet Protocol Detail Record (IPDR) was introduced.


Usage Guidelines

The show cable metering-status command displays information about the most recent successful usage-based billing operation. If usage-based billing is configured for File mode, this command displays the device and file name for the record that was last written. If usage-based billing is configured for Streaming mode, this command displays the IP address and port number for the external server to which the billing record was sent.


Note This command displays the status of the last successful billing record operation. If a failure occurred, the CMTS sends an SNMP trap to the SNMP manager with that information.


Examples

The following example shows a typical output for the show cable metering-status command when usage-based billing is configured to write the billing records to a local file system:

Router# show cable metering-status 
destination                       complete-time   flow cpe  status
                                                  aggr supp 
disk0:R7519-UBR7246-200308-004428 Jun 12 09:33:05  No    No  success

The following example shows a typical output for the show cable metering-status command when usage-based billing is configured to stream the billing records to an external server:

Router# show cable metering-status 
destination                       complete-time   flow cpe  status
                                                  aggr supp 
10.11.37.2 :1234                  Jun 12 09:33:05  No   No  success

The following example shows a typical output for the verbose form of the show cable metering-status command:

Router# show cable metering-status verbose 
Destination            : disk0:R7519-UBR7246-20000308-004428
Complete Time          : Jun 12 09:33:05
Flow Aggregate         : Yes
Cpe list suppression   : Yes
Status of last export  : success 

The following example shows a typical output for the show cable metering-status command when usage-based billing is configured to use the Internet Protocol Detail Record (IPDR) Exporter to stream the billing records to an external server:

Router# show cable metering-status
destination                       complete-time   flow cpe  status
                                                  aggr supp 
IPDR_Session1								 Jun 12 09:33:05  N/A N/A success

The following example shows a typical output for the verbose form of the show cable metering-status command when usage-based billing is configured to use the IPDR Exporter to stream the billing records to an external server:

Router# show cable metering-status verbose 
Last export status
Destination            : IPDR_Session1
Complete Time          : Jun 12 09:36:05
Status of last export  : success 

The following example shows the error message that is displayed when you enter the show cable metering-status command but not have enabled usage-based billing:

Router# show cable metering-status 
CMTS Metering collection not enabled

The following example shows if the SAMIS report failed, the output displays the details of the failure:

Router# show cable metering-status verbose
Load for five secs: 0%/0%; one minute: 1%; five minutes: 0%
Time source is NTP, .19:24:53.955 PDT Fri Jun 11 2010
Last export status
Destination            : 20.1.0.2:5959
Complete Time          : Jun11 19:24:40
Flow Aggregate         : No
Full records           : Yes
Cpe list suppression   : No
Source interface       : GigabitEthernet0/1
Status of last export  : write-error (bulk-data)

Table 4 describes the fields displayed by the show cable metering-status command.

Table 4 show cable metering-status Field Descriptions 

Field
Description

destination, Destination

Destination for the billing records. This is a file system device name and file name, if records are being written to a local file system, or an IP address and TCP port number, if records are being streamed to an external server.

complete_time, Complete Time

Date and time when the last billing record was written to a local file or streamed to an external server.

flow aggr, Flow Aggregate

Indicates whether traffic counters are aggregated in the billing records, so that one total is recorded for the upstream service flows and downstream service flows for each CM.

cpe suppress, CPE list suppression

Indicates whether CPE IP addresses are included or suppressed in the billing records:

Yes = CPE addresses are suppressed and are not included in the billing records.

No = CPE addresses are included in the billing records.

status, Status of last export

Indicates the status of the last billing operation:

success—The billing records were successfully written to the filesystem (file mode) or transferred to the billing collection server (streaming mode).

connect-failed—The CMTS was able to open the proper socket connection to the server but could not connect to the server.

data-incomplete—A failure occurred during the file write or the streaming to the collection server, and the records that were written might be incomplete.

disk-full—The billing records could not be written because the filesystem does not have sufficient free space.

no-memory—The processor had insufficient memory to collect the billing records.

open-failure—The transfer failed because the CMTS could not open a new file on the filesystem (file mode) or open a socket to the destination IP address and port (streaming mode).

unknown—An unknown error occurred.

write-error (data-type)—The operating system reported an error when attempting to write the billing records (file mode), or the send to the destination socket failed (streaming mode).

The value of data-type could be file-header, file-end, bulk-data, sflog, bulk-data, ipdr-data, ipdr-sflog, or ipdr-file.


Related Commands

Command
Description

cable metering destination

Enables usage-based billing and streams the billing records to an external server.

cable metering filesystem

Enables usage-based billing and writes the billing records to a file on a local file system.

cable metering source-interface

Enables debugging of usage-based billing operations.

snmp-server enable traps cable

Enables the sending of Simple Network Management Protocol (SNMP) traps for cable-related events.


show cable modem

To display information for the registered and unregistered CMs, use the show cable modem command in privileged EXEC mode.

show cable modem [ip-address | mac-address | cable {slot/port | slot/subslot/port} [upstream port [logical-channel-index]] | name fqdn] queue [verbose] [cm-status]

Cisco IOS Release 12.2(33)SCE and later releases

show cable modem [ip-address | mac-address | cable {slot/cable-interface-index | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] [verbose] [cm-status]

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

verbose

Displays detailed information for the CMs.

cm-status

Displays CM status events.

queue

Displays the downstream hierarchical queueing framework (HQF) queue information for a cable modem.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.


Command Modes

Privileged EXEC (#)

Command History

This table includes the following release-specific history entries:

BC Release

C Release

E Release

N Release

SC Release

T Release

X Release

BC Release
Modification

12.2(15)BC1

Additional lines were added to the show cable modem verbose displays, for one or all cable modems, to show information about the dynamic shared-secret feature. Cable modems that fail the dynamic secret authentication checks and then come online are marked with an exclamation point (!), so that this situation can be investigated.

12.2(4)BC1

Support was added for the Cisco uBR10012 router.

12.2(8)BC2

The output for the Online State field was updated for the cable tftp-enforce command. A pound sign (#) appears next to the state value when a CM was allowed to come online without attempting to download a DOCSIS configuration file through the cable interface with the Cisco CMTS.

12.2(15)BC1c

The verbose option displays whether dynamic service change requests (DSX) are allowed from cable modems.

12.2(15)BC2

Two new states—cc(r1) and cc(r2)—have been added to the CM MAC state field (see Table 23) to indicate the CM status when it has been instructed to change channels and is ranging to obtain a new downstream or upstream channel.

Also, three new states—online(pkd), online(ptd), and expire(pkd)—were added to clarify the BPI state when network access has been disabled in the CM's DOCSIS configuration file.

In addition, the show cable modem verbose command now displays the total amount of time that a CM has been online since last registering.

12.3(13a)BC

New initialization states were added for the MAC State Field:

init(d)—The Cisco CMTS has seen DHCPDISCOVER

init(io)—The Cisco CMTS has seen DHCPOFFER

init(dr)—The Cisco CMTS has seen DHCPREQUEST

init(i)—The Cisco CMTS has seen DHCPACK

init(o)—The Cisco CMTS has seen first TFTP packet for TFTP request for cable modem configuration file

init(t)—The Cisco CMTS has seen the TOD request

See Table 23 for additional information.

12.3(21)BC

All cable bundles are now automatically converted and configured to be in a virtual bundle, and standalone cable interfaces must be manually configured to be in a virtual bundle to operate properly. Previously, new virtual interface bundles and bundle members required reconfiguration, and there could also be standalone interfaces not part of a bundle at all.

12.3(23)BC

The verbose option displays additional information about the cable modem. The following fields have been added to the output of this option:

Host Interface

Primary Downstream

Wideband Capable

Voice Enabled

DS Change Times

C Release
Modification

12.1(4)CX

Support was added for the Cisco uBR10012 router.

12.2(15)CX

The verbose option displays the sysDescr field for each cable modem, when the cable modem remote-query command has been configured. Other fields have also been added to support DOCSIS 2.0 (ATDMA) operation.

E Release
Modification

12.1(10)EC1

Adds an exclamation point to CMs that have exceeded the maximum delay/timing offset specified by the cable map-advance command.

12.1(11b)EC1

The output for the Online State field was updated for the cable tftp-enforce command. A pound sign (#) appears next to the state value when a CM was allowed to come online without attempting to download a DOCSIS configuration file through the cable interface with the Cisco CMTS.

12.1(20)EC1

The three new states—online(pkd), online(ptd), and expire(pkd)—were added to the Cisco IOS Release 12.1 EC train.

N Release
Modification

11.3(5)NA

The output was reorganized and the Receive Power field was added.

SC Release
Modification

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

The output column spacing and headings were changed, including some of the following changes:

"BPI Enb" has been changed to "BPI"

"DIP" output field was added to indicate support of dual IP for both IPv4 and IPv6 addressing.

The following new initialization states were added to show initialization of CMs and CPEs supporting IPv6:

init6(s)—CMTS router has seen SOLICIT message.

init6(a)—CMTS router has seen ADVERTISE message.

init6(r)—CMTS router has seen REQUEST message.

init6(i)—CMTS router has seen REPLY message.

init6(o)—CMTS router has seen version 6 TFTP request.

init6(t)—CMTS router has seen version 6 TOD request.

12.2(33)SCB

A new keyword, cm-status, was added to display CM status events.

12.2(33)SCC

This command was modified with the following changes:

The command output displays the CM attribute bitmasks.

The command output provides basic receive-statistics for all event code types of the specified CM.

12.2(33)SCD

This command was modified. The cm-status keyword was added to display the CM status events and the queue keyword was added to display downstream HQF queue information on the Cisco uBR7225VXR and Cisco uBR7246VXR routers.

12.2(33)SCD2

This command was modified. The command output was modified to display the cable modems that are in upstream and downstream partial service mode.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCE4

This command was modified. The command output displays online time of the modem since the last counter reset, along with the total time online.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added. The show cable modem verbose command output was modified to display the downstream channel information for the cable modems.

T Release
Modification

2.1(1a)T1

The output of this command was enhanced to show that the Cisco CMTS has detected an unstable return path for a particular CM and has compensated with a power adjustment. An asterisk (*) appears in the power adjustment field for a modem when a power adjustment has been made; an exclamation point (!) appears when the CM has reached its maximum power transmit level and cannot increase its power level further.

12.0(7)T

The detail option was replaced with the verbose option.

X Release
Modification

11.3XA

This command was introduced.

12.0(4)XI

The output was expanded to show the primary service identifier (SID) and the customer premises equipment (CPE) count.

12.0(7)XR

The output of this command was enhanced to show that the Cisco CMTS has detected an unstable return path for a particular CM and has compensated with a power adjustment. An asterisk (*) appears in the power adjustment field for a modem when a power adjustment has been made; an exclamation point (!) appears when the CM has reached its maximum power transmit level and cannot increase its power level further.


Usage Guidelines

This command displays information for all CMs, for all CMs attached to a specific CMTS cable interface, or for a particular CM, identified by its IP address, MAC address, or its domain name. The output is sorted by the cable interface and the CM MAC address.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.



Tip Several options in the show cable modem command do not pause the screen to display the information page by page, even if the terminal length command has been used to set the page size of your terminal. Paging and pausing the display could result in outdated or stale information for CMs, and thus produce an incorrect snapshot of the current CM state of the system. To capture or review this information, use your terminal program's capture buffer to save the information to a file, and then review it offline.



Tip You can also specify the MAC address or IP address for a CPE device, and the Cisco CMTS will display the information for the CM that is associated with that CPE device in its internal database.



Note If the CPE IP address is no longer associated with a cable modem, the show cable modem command might not display information about the cable modem. To display the IP address of the CPE device for the cable modem, use the clear cable host ip-address command to clear the IP address of the modem from the router database, and then enter the ping docsis mac-address command, which resolves the MAC address by sending the DOCSIS ping to the CM.


Refer to the following document on Cisco.com for additional information about cable interface bundling and virtual interface bundling on the Cisco CMTS:

Cable Interface Bundling and Virtual Interface Bundling on the Cisco CMTS

Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.

Operation of the show cable modem Commands with Different Cable Interface Line Cards

The show cable modem commands display the most current information for standard cable interface line cards. If the card itself is down, the show cable modem commands still show whatever information is appropriate (such as offline cable modems and flap list information).

The show cable modem commands function slightly different when used on routers that are using Broadband Processing Engine (BPE) cable interface line cards (such as the Cisco uBR-MC16U/X, Cisco uBR-MC28U/X, or Cisco uBR10-MC5X20S/U/H). When BPE cards are the only cable interface cards installed, the show cable modem commands do not display any output until at least one BPE card is up and communicating with the router processor. If the BPE cards are not yet up, the show cable modem command does not display any output.

Examples

Example of the show cable modem Command Output for all CMs

The following sample output from the show cable modem command shows the default CM displays for individual CMs.

Router# show cable modem 
MAC Address    IP Address      I/F     MAC         Prim RxPwr Timing Num  BPI
                                       State       Sid  (db)  Offset CPEs Enbld
0010.7b6b.58c1 0.0.0.0         C4/0/U5 offline     5   -0.25  2285   0    yes
0010.7bed.9dc9 0.0.0.0         C4/0/U5 offline     6   -0.75  2290   0    yes
0010.7bed.9dbb 0.0.0.0         C4/0/U5 offline     7    0.50  2289   0    yes
0010.7b6b.58bb 0.0.0.0         C4/0/U5 offline     8    0.00  2290   0    yes
0010.7bb3.fcd1 10.20.113.2     C5/0/U5 online      1    0.00  1624   0    yes
0010.7bb3.fcdd 0.0.0.0         C5/0/U5 init(r1)    2   -20.00 1624   0    no 
0010.7b43.aa7f 0.0.0.0         C5/0/U5 init(r2)    3    7.25  1623   0    no 

Example of the show cable modem Command for a Specified MAC Address

Router# show cable modem 0010.7bb3.fcd1 
MAC Address    IP Address      I/F     MAC         Prim RxPwr Timing Num  BPI
                                       State       Sid  (db)  Offset CPEs Enbld
0010.7bb3.fcd1 10.20.113.2     C5/0/U5 online      1    0.00  1624   0    Y

Example of the show cable modem Command for all CMs on a Cisco uBR10012 Router

The following shows a typical display for a Cisco uBR10012 router:


Note The asterisk(*) in the Primary SID (Prim Sid) field indicates that the modem has service flows with zero blaze index in Cisco IOS Release 12.3(23)BC.
In Cisco IOS Release 12.2(33)SCB and later, the asterisk that may appear in the Primary SID field does not signify anything.


Router# show cable modem 
MAC Address    IP Address      I/F       MAC         Prim RxPwr  Timing  Num BPI
                                         State       Sid  (db)   Offset  CPE Enb
0010.9507.01db 144.205.151.130 C5/1/0/U5 online(pt)  1     0.25    938   1    N 
0080.37b8.e99b 144.205.151.131 C5/1/0/U5 online      2     -0.25   1268  0    N 
0002.fdfa.12ef 144.205.151.232 C6/1/0/U0 online(pt)  13    -0.25   1920  1    N 
0002.fdfa.137d 144.205.151.160 C6/1/0/U0 online      *16    -0.50   1920  1    N 
0003.e38f.e9ab 144.205.151.237 C6/1/0/U0 online      3     -0.50   1926  1    N 
0003.e3a6.8173 144.205.151.179 C6/1/1/U2 offline     *4     0.50    1929  0    N 
0003.e3a6.8195 144.205.151.219 C6/1/1/U2 online(pt)  22    -0.50   1929  1    N 
0006.28dc.37fd 144.205.151.244 C6/1/1/U2 online(pt)  61    0.00    1925  2    N 
0006.28e9.81c9 144.205.151.138 C6/1/1/U2 online(pt)  2    !0.75    1925  1    N 
0006.28f9.8bbd 144.205.151.134 C6/1/1/U2 #online     25    -0.25   1924  1    N 
0006.28f9.9d19 144.205.151.144 C6/1/1/U2 online(pt)  28    0.25    1924  1    N 
0010.7bed.9b6d 144.205.151.228 C6/1/1/U2 online(pt)  59    0.25    1554  1    N 
0002.fdfa.12db 144.205.151.234 C7/0/0/U0 online      15    -0.75   1914  1    N 
0002.fdfa.138d 144.205.151.140 C7/0/0/U5 online      4     0.00    1917  1    N 
0003.e38f.e85b 144.205.151.214 C7/0/0/U5 online      17   *0.25    1919  1    N 
0003.e38f.f4cb 144.205.151.238 C7/0/0/U5 online(pt)  16    0.00   !2750  1    N 
0003.e3a6.7fd9 144.205.151.151 C7/0/0/U5 online      1     0.25    1922  0    N 
0020.4005.3f06 144.205.151.145 C7/0/0/U0 online(pt)  2     0.00    1901  1    N 
0020.4006.b010 144.205.151.164 C7/0/0/U5 online(pt)  3     0.00    1901  1    N 
0050.7302.3d83 144.205.151.240 C7/0/0/U0 online(pt)  18    -0.25   1543  1    N 
00b0.6478.ae8d 144.205.151.254 C7/0/0/U5 online(pt)  44    0.25    1920  21   N 
00d0.bad3.c0cd 144.205.151.149 C7/0/0/U5 online      19    0.25    1543  1    N 
00d0.bad3.c0cf 144.205.151.194 C7/0/0/U0 online      13    0.00    1546  1    N 
00d0.bad3.c0d5 144.205.151.133 C7/0/0/U0 online      12   *0.50    1546  1    N 

Example of show cable modem Command When no CMs are Online

The following example shows sample output when the cable interface line cards are up, but no cable modems are yet online:

Router# show cable modem 
MAC Address    IP Address      I/F       MAC         Prim RxPwr  Timing  Num BPI
                                         State       Sid  (db)   Offset  CPE Enb

Example of show cable modem Command When no Cable Interface Line Cards are Up

The following example shows sample output when the Cisco CMTS router contains only Broadband Processing Engine (BPE) cable interface line cards and none of the cable interface line cards are up:

Router# show cable modem 

Example of show cable modem verbose Command for a Specified MAC Address

The following example shows sample output for the verbose option for a particular CM:

Router# show cable modem 0010.7bb3.fcd1 verbose 
MAC Address                         : 00C0.7bb3.fcd1
IP Address                          : 10.20.113.2
Prim Sid                            : 1
QoS Profile Index                   : 6
Interface                           : C5/0/U5
sysDescr                            : Vendor ABC DOCSIS 2.0 Cable Modem
Upstream Power                      : 0 dBmV (SNR = 33.25 dBmV)
Downstream Power                    : 0 dBmV (SNR = ----- dBmV)
Timing Offset                       : 1624
Initial Timing Offset               : 2812
Received Power                      : 0.25
MAC Version                         : DOC1.0
Qos Provisioned Mode                : DOC1.0
Enable DOCSIS2.0 Mode               : Y
Phy Operating Mode                  : atdma 
Capabilities                        : {Frag=N, Concat=N, PHS=N, Priv=BPI}
Sid/Said Limit                      : {Max Us Sids=0, Max Ds Saids=0}
Optional Filtering Support          : {802.1P=N, 802.1Q=N}
Transmit Equalizer Support          : {Taps/Symbol= 0, Num of Taps= 0}
Number of CPE IPs                   : 0(Max CPEs = 1)
CFG Max-CPE                         : 1
Flaps                               : 373(Jun 1  13:11:01)
Errors                              : 0 CRCs, 0 HCSes
Stn Mtn Failures                    : 0 aborts, 3 exhausted
Total US Flows                      : 1(1 active)
Total DS Flows                      : 1(1 active)
Total US Data                       : 1452082 packets, 171344434 bytes
Total US Throughput                 : 0 bits/sec, 0 packets/sec
Total DS Data                       : 1452073 packets, 171343858 bytes
Total DS Throughput                 : 0 bits/sec, 0 packets/sec
Active Classifiers                  : 0 (Max = NO LIMIT) 
DSA/DSX messages                    : reject all 
Dynamic Secret                      : A3D1028F36EBD54FDCC2F74719664D3F
Total Time Online                   : 16:16 

Note The "Number of CPES" field shows the value set for the CM, not the value for the CMTS that is set by the cable modem max-cpe command. In Cisco IOS Release 12.2(15)BC1 and later releases, the verbose display also includes information about the dynamic shared-secret feature (see the cable dynamic-secret command).



Note An asterisk (*) in the Receive Power column indicates that a power adjustment has been made for that CM. An exclamation point (!) in the Receive Power column indicates that the CM has reached its maximum power transmit level and cannot increase its power level further. An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command.

A pound sign (#) in the MAC State column indicates that the cable tftp-enforce mark-only command has been used for the CM to attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so (Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases).



Tip The show cable modem command displays the CM timing offset in DOCSIS ticks, while other commands, such as cable map-advance, display the offset in microseconds. Use the following method to convert microseconds to DOCSIS ticks: ticks = microseconds*64/6.25.


Example of the Updated show cable modem verbose Command for a Specified MAC Address in Cisco IOS Release 12.3(23)BC

The following example shows sample output for the verbose option for a particular CM for the Cisco IOS Release 12.3(23)BC with new output fields:

Router# show cable modem 0000.39b9.ac51 verbose 
MAC Address                         : 0000.39b9.ac51
IP Address                          : 55.1.176.11
Prim Sid                            : 7
QoS Profile Index                   : 5
Host Interface                      : C8/0/0/U5
Primary Downstream                  : Mo3/0/1:3 (RfId : 27)
Wideband Capable                    : N
sysDescr                            : Toshiba PacketCable 1.0 EMTA ; <<HW_REV: 13.0.0; 
VENDOR: Toshiba Corporation; BOOTR: 2.2; SW_REV: 6.1.318; MODEL: PCX3000>>
Upstream Power                      : 29.00 dBmV (SNR = 16.07 dB)
Downstream Power                    : 14.90 dBmV (SNR = 34.30 dB)
Timing Offset                       : 1774  
Initial Timing Offset               : 1774
Curr US Timing Adjust               : 272
Prev US Timing Adjust               : 0
Received Power                      :  0.00 dBmV
MAC Version                         : DOC1.1
QoS Provisioned Mode                : DOC1.0
Enable DOCSIS2.0 Mode               : Y
Phy Operating Mode                  : tdma
Capabilities                        : {Frag=N, Concat=Y, PHS=N, Priv=}
Sid/Said Limit                      : {Max US Sids=0, Max DS Saids=0}
Optional Filtering Support          : {802.1P=N, 802.1Q=N}
Transmit Equalizer Support          : {Taps/Symbol= 0, Num of Taps= 0}
Number of CPE IPs                   : 0(Max CPE IPs = 17)
CFG Max-CPE                         : 3
Flaps                               : 7(Sep 16 20:04:13)
Errors                              : 0 CRCs, 0 HCSes
Stn Mtn Failures                    : 0 aborts, 0 exhausted
Total US Flows                      : 1(1 active)
Total DS Flows                      : 1(1 active)
Total US Data                       : 3399 packets, 1956063 bytes
Total US Throughput                 : 0 bits/sec, 0 packets/sec
Total DS Data                       : 125 packets, 10704 bytes
Total DS Throughput                 : 0 bits/sec, 0 packets/sec
Active Classifiers                  : 0 (Max = NO LIMIT) 
CM Upstream Filter Group            : 10
DSA/DSX messages                    : permit all
Voice Enabled                       : NO
DS Change Times                     : 0
Total Time Online                   : 7d22h

Note In Cisco IOS Release 12.3(23)BC, the output for this command does not display information about dynamic shared secret.


Example of show cable modem Command for a CM or CPE With a Specified IPv6 Address

The following example shows sample output for the show cable modem command for a CM with the IPv6 address of 2001:ODBA:4321:600:980D:E743:174F:1E48.


Note The IP Address field shows "---" because the IPv6 address is too long for the size of the output field. To view a complete IPv6 address for a device, use the verbose form of the command.


Router# show cable modem 2001:ODBA:4321:600:980D:E743:174F:1E48
                                                                             B D
MAC Address    IP Address      I/F       MAC         Prim  RxPwr  Timing Num P I
                                         State       Sid   (dBmv) Offset CPE I P
0019.474a.ccd0 ---            C5/0/1/U0 w-online     38    0.00  1580    0   N

Example of the show cable modem verbose Command Output That Shows CM Attribute Masks in Cisco IOS Release 12.2(33)SCC

The following example shows the sample output for the verbose option for a particular CM in Cisco IOS Release 12.2(33)SCC:

Router# show cable modem 001a.c3ff.ce9e verbose 
MAC Address                        : 0019.474a.d396
IP Address                         : 10.10.2.4
IPv6 Address                       : ---
Dual IP                            : N
Prim Sid                           : 1
Host Interface                     : C5/0/0/U2
MD-DS-SG / MD-US-SG                : 1 / N/A
MD-CM-SG                           : 0x100
Primary Downstream                 : C5/0/0 (RfId : 240)
Wideband Capable                   : Y
RCP Index                          : 2
RCP ID                             : 00 10 18 33 81
Multi-Transmit Channel Mode        : N
Upstream Channel                   : US2
Ranging Status                     : sta
Upstream Power (dBmV)              : 0.00
Upstream SNR (dB)                  : 36.12
Received Power (dBmV)              : 0.00
Timing Offset             (97.6 ns): 1018
Initial Timing Offset              : 1018
Rng Timing Adj Moving Avg(0.381 ns): 0
Rng Timing Adj Lt Moving Avg       : 0
Rng Timing Adj Minimum             : 0
Rng Timing Adj Maximum             : 0
Pre-EQ Good                        : 0
Pre-EQ Scaled                      : 0
Pre-EQ Impulse                     : 0
Pre-EQ Direct Loads                : 0
Good Codewords rx                  : 457865
Corrected Codewords rx             : 0
Uncorrectable Codewords rx         : 0
Phy Operating Mode                 : tdma
sysDescr                           :
Downstream Power                   : 0.00 dBmV (SNR = ----- dB)
MAC Version                        : DOC2.0
QoS Provisioned Mode               : DOC1.1
Enable DOCSIS2.0 Mode              : Y
Modem Status                       : {Modem= online(pt), Security=assign(tek)}
Capabilities                       : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities              : {Priv=BPI+, EAE=N, Key_len=56}
L2VPN Capabilities                 : {L2VPN=N, eSAFE=N}
Sid/Said Limit                     : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support         : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support         : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs                  : 0(Max CPE IPs = 16)
CFG Max-CPE                        : 1
Flaps                              : 0()
Errors                             : 0 CRCs, 0 HCSes
Stn Mtn Failures                   : 0 aborts, 0 exhausted
Total US Flows                     : 1(1 active)
Total DS Flows                     : 1(1 active)
Total US Data                      : 12937 packets, 1079852 bytes
Total US Throughput                : 0 bits/sec, 0 packets/sec
Total DS Data                      : 6226 packets, 459372 bytes
Total DS Throughput                : 0 bits/sec, 0 packets/sec
LB group ID assigned (index)       : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID                       : 0
LB policy ID in config file        : 0
LB priority                        : 0
Tag                                :
Required DS Attribute Mask         : 0x0
Forbidden DS Attribute Mask        : 0x0
Required US Attribute Mask         : 0x0
Forbidden US Attribute Mask        : 0x0
Service Type ID                    :
Service Type ID in config file     :
Active Classifiers                 : 0 (Max = NO LIMIT)
CM Upstream Filter Group           : 0
CM Downstream Filter Group         : 0
CPE Upstream Filter Group          : 0
CPE Downstream Filter Group        : 0
DSA/DSX messages                   : permit all
Voice Enabled                      : NO
DS Change Times                    : 0
Boolean Services                   : 2
Number of Multicast DSIDs Support  : 16
MDF Capability Mode                : 0
IGMP/MLD Version                   : IGMPv2
FCType10 Forwarding Support        : N
Features Bitmask                   : 0x0
Total Time Online                  : 7d4h18m
CFG Max IPv6 CPE Prefix             : 1024 (-1 used)

Example of the show cable modem Command Output for a Cable Modem Operating in the MTC Mode

The following example shows the sample output for the verbose option for a particular CM operating in the MTC mode in Cisco IOS Release 12.2(33)SCC:

Router# show cable modem 0014.f831.d596 verbose

MAC Address                        : 001e.6bfa.f02e
IP Address                         : 30.10.0.6
IPv6 Address                       : ---
Dual IP                            : N
Prim Sid                           : 5
Host Interface                     : C5/1/0/UB
MD-DS-SG / MD-US-SG                : 1 / 1
MD-CM-SG                           : 0xF0101
Primary Wideband Channel ID        : 48
Primary Downstream                 : Mo3/0/0:0 (RfId : 120)
Wideband Capable                   : Y
RCP Index                          : 3
RCP ID                             : 00 10 00 00 04
Multi-Transmit Channel Mode        : Y
Upstream Channel                   : US1        US2        US3        US4
Ranging Status                     : sta        sta        sta        sta
Upstream Power (dBmV)              : 0.00       0.00       0.00       0.00
Upstream SNR (dB)                  : 36.12      36.12      36.12      33.1
Received Power (dBmV)              : 0.00       1.00       0.00       -0.75
Reported Transmit Power (dBmV)     : 45.00      45.00      45.00      54.75
Peak Transmit Power (dBmV)         : 51.00      51.00      56.00      56.00
Minimum Transmit Power (dBmV)      : 24.00      24.00      21.00      18.00
Timing Offset             (97.6 ns): 2312       2281       2282       2282
Initial Timing Offset              : 2314       2058       2058       2058
Rng Timing Adj Moving Avg(0.381 ns): 7          4          0          -94
Rng Timing Adj Lt Moving Avg       : 63         30         11         -144
Rng Timing Adj Minimum             : -512       -256       -256       -512
Rng Timing Adj Maximum             : 256        57088      57344      57344
Pre-EQ Good                        : 0          0          0          0
Pre-EQ Scaled                      : 0          0          0          0
Pre-EQ Impulse                     : 0          0          0          0
Pre-EQ Direct Loads                : 0          0          0          0
Good Codewords rx                  : 5012       4996       4992       4990
Corrected Codewords rx             : 0          0          0          0
Uncorrectable Codewords rx         : 0          0          0          0
Phy Operating Mode                 : atdma*     atdma*     tdma*      tdma*
sysDescr                           :
Downstream Power                   : 0.00 dBmV (SNR = ----- dB)
MAC Version                        : DOC3.0
QoS Provisioned Mode               : DOC1.1
Enable DOCSIS2.0 Mode              : Y
Modem Status                       : {Modem= w-online, Security=disabled}
Capabilities                       : {Frag=N, Concat=N, PHS=Y}
Security Capabilities              : {Priv=, EAE=Y, Key_len=}
L2VPN Capabilities                 : {L2VPN=N, eSAFE=N}
Sid/Said Limit                     : {Max US Sids=8, Max DS Saids=24}
Optional Filtering Support         : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support         : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs                  : 0(Max CPE IPs = 16)
CFG Max-CPE                        : 4
Flaps                              : 0()
Errors                             : 0 CRCs, 0 HCSes
Stn Mtn Failures                   : 0 aborts, 0 exhausted
Total US Flows                     : 2(2 active)
Total DS Flows                     : 1(1 active)
Total US Data                      : 6 packets, 1557 bytes
Total US Throughput                : 0 bits/sec, 0 packets/sec
Total DS Data                      : 0 packets, 0 bytes
Total DS Throughput                : 0 bits/sec, 0 packets/sec
LB group ID assigned (index)       : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID                       : 0
LB policy ID in config file        : 0
LB priority                        : 0
Tag                                :
Required DS Attribute Mask         : 0x0
Forbidden DS Attribute Mask        : 0x0
Required US Attribute Mask         : 0x0
Forbidden US Attribute Mask        : 0x0
Service Type ID                    :
Service Type ID in config file     :
Active Classifiers                 : 0 (Max = NO LIMIT)
CM Upstream Filter Group           : 0
CM Downstream Filter Group         : 0
CPE Upstream Filter Group          : 0
CPE Downstream Filter Group        : 0
DSA/DSX messages                   : permit all
Voice Enabled                      : NO
DS Change Times                    : 0
Boolean Services                   : 2
Number of Multicast DSIDs Support  : 24
MDF Capability Mode                : 2
IGMP/MLD Version                   : IGMPv3
FCType10 Forwarding Support        : Y
Features Bitmask                   : 0x0
Total Time Online                  : 1d16h
CM Initialization Reason           : NO_PRIM_SF_USCHAN
CFG Max IPv6 CPE Prefix             : 16 (-1 used)

Note An asterisk (*) in the Phy Operating Mode row indicates the type of PHY-layer modulation that the CM (operating in the MTC mode) is using: tdma or atdma.


Example of the show cable modem verbose Command Output in Cisco IOS Release 12.2(33)SCE4

The following example shows the sample output for the verbose option for a particular CM in Cisco IOS Release 12.2(33)SCE4:

Router# show cable modem 001a.c3ff.ce9e verbose 
MAC Address                        : 0014.e84f.1630
IP Address                         : 50.6.9.4       
IPv6 Address                       : ---                                    
Dual IP                            : N
Prim Sid                           : 1
Host Interface                     : C6/1/0/U0
MD-DS-SG / MD-US-SG                : N/A / N/A
MD-CM-SG                           : 0x2D0000
Primary Downstream                 : C6/1/0 (RfId : 600)
Wideband Capable                   : N
RCP Index                          : 0
RCP ID                             : 00 00 00 00 00
Downstream Channel DCID RF Channel : 73    6/1/0
Multi-Transmit Channel Mode        : N
Upstream Channel                   : US0       
Ranging Status                     : sta       
Upstream Power (dBmV)              : 0.00      
Upstream SNR (dB)                  : 31.26     
Received Power (dBmV)              : 0.50      
Timing Offset             (97.6 ns): 1237      
Initial Timing Offset              : 1237      
Rng Timing Adj Moving Avg(0.381 ns): 503       
Rng Timing Adj Lt Moving Avg       : 402       
Rng Timing Adj Minimum             : 0         
Rng Timing Adj Maximum             : 1024      
Pre-EQ Good                        : 0         
Pre-EQ Scaled                      : 0         
Pre-EQ Impulse                     : 0         
Pre-EQ Direct Loads                : 0         
Good Codewords rx                  : 429       
Corrected Codewords rx             : 0         
Uncorrectable Codewords rx         : 0         
Phy Operating Mode                 : tdma      
sysDescr                           : 
Downstream Power                   : 0.00 dBmV (SNR = ----- dB)
MAC Version                        : DOC2.0
QoS Provisioned Mode               : DOC1.1
Enable DOCSIS2.0 Mode              : Y
Modem Status                       : {Modem= online, Security=disabled}
Capabilities                       : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities              : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities                 : {L2VPN=N, eSAFE=N}
Sid/Said Limit                     : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support         : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support         : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs                  : 0(Max CPE IPs = 16)
CFG Max-CPE                        : 1
Flaps                              : 0()
Errors                             : 0 CRCs, 0 HCSes
Stn Mtn Failures                   : 0 aborts, 0 exhausted
Total US Flows                     : 2(2 active)
Total DS Flows                     : 2(2 active)
Total US Data                      : 20 packets, 6786 bytes
Total US Throughput                : 0 bits/sec, 0 packets/sec
Total DS Data                      : 11255 packets, 720320 bytes
Total DS Throughput                : 5119 bits/sec, 9 packets/sec
LB group ID assigned (index)       : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID                       : 0
LB policy ID in config file        : 0
LB priority                        : 0
Tag                                : 
Required DS Attribute Mask         : 0x0
Forbidden DS Attribute Mask        : 0x0
Required US Attribute Mask         : 0x0
Forbidden US Attribute Mask        : 0x0
Service Type ID                    : 
Service Type ID in config file     : 
Active Classifiers                 : 0 (Max = NO LIMIT) 
CM Upstream Filter Group           : 30
CM Downstream Filter Group         : 29
CPE Upstream Filter Group          : 1
CPE Downstream Filter Group        : 1
DSA/DSX messages                   : permit all
Voice Enabled                      : NO
DS Change Times                    : 0
Boolean Services                   : 0
Number of Multicast DSIDs Support  : 0
MDF Capability Mode                : 0
IGMP/MLD Version                   : IGMPv2
FCType10 Forwarding Support        : N
Features Bitmask                   : 0x0
Total Time Online                  : 18:53   (18:53    since last counter reset)
!From Cisco IOS Release 12.2(33)SCE4 onwards, the command output shows online time of the 
!modem since the last counter reset.
CFG Max IPv6 CPE Prefix            : 16 (-1 used)

Example of the show cable modem verbose Command in Cisco IOS Release 12.2(33)SCF

The following is a sample output of the show cable modem verbose command in Cisco IOS Release 12.2(33)SCF:

Router# show cable modem 10.1.0.2 verbose
MAC Address                        : 001e.6bfb.0a60
IP Address                         : 10.1.0.2
IPv6 Address                       : ---
Dual IP                            : N
Prim Sid                           : 43
Host Interface                     : C7/0/0/UB
MD-DS-SG / MD-US-SG                : 1 / 1
MD-CM-SG                           : 0x3C0101
Primary Wideband Channel ID        : 897 (Wi7/0/0:0)
Primary Downstream                 : In7/0/0:0 (RfId : 720)
Wideband Capable                   : Y
RCP Index                          : 3
RCP ID                             : 00 10 00 00 04
Multi-Transmit Channel Mode        : Y
Upstream Channel                   : US0        US1        US2
Ranging Status                     : sta        sta        sta
Upstream SNR (dB)                  : 33.1       33.1       33.1
Upstream Data SNR (dB)             : 22.78      22.78      22.78
Received Power (dBmV)              : 0.50       0.00       0.00
Reported Transmit Power (dBmV)     : 51.00      51.00      51.00
Peak Transmit Power (dBmV)         : 51.00      51.00      51.00
Minimum Transmit Power (dBmV)      : 24.00      24.00      24.00
Timing Offset             (97.6 ns): 1302       1303       1303

The following example is a sample output of the show cable modem verbose command that displays the downstream channel information for a specific CM identified by its IP address:

Router# show cable modem 80.62.0.4 verbose
MAC Address                        : 0018.6832.0eb2
IP Address                         : 80.62.0.4
IPv6 Address                       : ---
Dual IP                            : N
Prim Sid                           : 13
Host Interface                     : C6/1/0/U0
MD-DS-SG / MD-US-SG                : 3 / N/A
MD-CM-SG                           : 0x2D0300
Primary Downstream                 : In6/1/0:0 (RfId : 600)
Wideband Capable                   : N
RCP Index                          : 0
RCP ID                             : 00 00 00 00 00
Downstream Channel DCID RF Channel : 193   6/1/0:0
Multi-Transmit Channel Mode        : N
Upstream Channel                   : US0
Ranging Status                     : sta
Upstream Power (dBmV)              : 0.00
Upstream SNR (dB)                  : 36.12
Upstream Data SNR (dB)             : --
Received Power (dBmV)              : 0.00
Timing Offset             (97.6 ns): 1192
Initial Timing Offset              : 1192
Rng Timing Adj Moving Avg(0.381 ns): -1
Rng Timing Adj Lt Moving Avg       : -7
Rng Timing Adj Minimum             : -256
Rng Timing Adj Maximum             : 0
Pre-EQ Good                        : 0
Pre-EQ Scaled                      : 0
Pre-EQ Impulse                     : 0
Pre-EQ Direct Loads                : 0
Good Codewords rx                  : 42
Corrected Codewords rx             : 0
Uncorrectable Codewords rx         : 0
Phy Operating Mode                 : tdma
sysDescr                           :
Downstream Power                   : 0.00 dBmV (SNR = ----- dB)
MAC Version                        : DOC2.0
QoS Provisioned Mode               : DOC1.1
Enable DOCSIS2.0 Mode              : Y
Modem Status                       : {Modem= online, Security=disabled}
Capabilities                       : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities              : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities                 : {L2VPN=N, eSAFE=N}
Sid/Said Limit                     : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support         : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support         : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs                  : 0(Max CPE IPs = 16)
CFG Max-CPE                        : 1
Flaps                              : 0()
Errors                             : 0 CRCs, 0 HCSes
Stn Mtn Failures                   : 0 aborts, 0 exhausted
Total US Flows                     : 2(2 active)
Total DS Flows                     : 2(2 active)
Total US Data                      : 9 packets, 4545 bytes
Total US Throughput                : 0 bits/sec, 0 packets/sec
Total DS Data                      : 9 packets, 3114 bytes
Total DS Throughput                : 0 bits/sec, 0 packets/sec
LB group ID assigned (index)       : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID                       : 0
LB policy ID in config file        : 0
LB priority                        : 0
Tag                                :
Required DS Attribute Mask         : 0x0
Forbidden DS Attribute Mask        : 0x0
Required US Attribute Mask         : 0x0
Forbidden US Attribute Mask        : 0x0
Service Type ID                    :
Service Type ID in config file     :
Active Classifiers                 : 0 (Max = NO LIMIT)
CM Upstream Filter Group           : 0
CM Downstream Filter Group         : 0
CPE Upstream Filter Group          : 0
CPE Downstream Filter Group        : 0
DSA/DSX messages                   : permit all
Voice Enabled                      : NO
DS Change Times                    : 0
Boolean Services                   : 0
Number of Multicast DSIDs Support  : 0
MDF Capability Mode                : 0
IGMP/MLD Version                   : IGMPv2
FCType10 Forwarding Support        : N
Features Bitmask                   : 0x0
Total Time Online                  : 4d14h
CFG Max IPv6 CPE Prefix            : 16 (-1 used)

The following example is a sample output of the show cable modem verbose command that displays the downstream channel information for a specific cable interface:

Router# show cable modem Cable 6/1/0 verbose
MAC Address                        : 0018.6832.0eb2
IP Address                         : 80.62.0.4
IPv6 Address                       : ---
Dual IP                            : N
Prim Sid                           : 13
Host Interface                     : C6/1/0/U0
MD-DS-SG / MD-US-SG                : 3 / N/A
MD-CM-SG                           : 0x2D0300
Primary Downstream                 : In6/1/0:0 (RfId : 600)
Wideband Capable                   : N
RCP Index                          : 0
RCP ID                             : 00 00 00 00 00
Downstream Channel DCID RF Channel : 193   6/1/0:0
Multi-Transmit Channel Mode        : N
Upstream Channel                   : US0
Ranging Status                     : sta
Upstream Power (dBmV)              : 0.00
Upstream SNR (dB)                  : 36.12
Upstream Data SNR (dB)             : --
Received Power (dBmV)              : 0.00
Timing Offset             (97.6 ns): 1192
Initial Timing Offset              : 1192
Rng Timing Adj Moving Avg(0.381 ns): 0
Rng Timing Adj Lt Moving Avg       : 0
Rng Timing Adj Minimum             : 0
Rng Timing Adj Maximum             : 256
Pre-EQ Good                        : 0
Pre-EQ Scaled                      : 0
Pre-EQ Impulse                     : 0
Pre-EQ Direct Loads                : 0
Good Codewords rx                  : 66
Corrected Codewords rx             : 0
Uncorrectable Codewords rx         : 0
Phy Operating Mode                 : tdma
sysDescr                           :
Downstream Power                   : 0.00 dBmV (SNR = ----- dB)
MAC Version                        : DOC2.0
QoS Provisioned Mode               : DOC1.1
Enable DOCSIS2.0 Mode              : Y
Modem Status                       : {Modem= online, Security=disabled}
Capabilities                       : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities              : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities                 : {L2VPN=N, eSAFE=N}
Sid/Said Limit                     : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support         : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support         : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs                  : 0(Max CPE IPs = 16)
CFG Max-CPE                        : 1
Flaps                              : 1(Mar 22 22:39:59)
Errors                             : 0 CRCs, 0 HCSes
Stn Mtn Failures                   : 0 aborts, 1 exhausted
Total US Flows                     : 2(2 active)
Total DS Flows                     : 2(2 active)
Total US Data                      : 2 packets, 1010 bytes
Total US Throughput                : 0 bits/sec, 0 packets/sec
Total DS Data                      : 2 packets, 692 bytes
Total DS Throughput                : 0 bits/sec, 0 packets/sec
LB group ID assigned (index)       : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID                       : 0
LB policy ID in config file        : 0
LB priority                        : 0
Tag                                :
Required DS Attribute Mask         : 0x0
Forbidden DS Attribute Mask        : 0x0
Required US Attribute Mask         : 0x0
Forbidden US Attribute Mask        : 0x0
Service Type ID                    :
Service Type ID in config file     :
Active Classifiers                 : 0 (Max = NO LIMIT)
CM Upstream Filter Group           : 0
CM Downstream Filter Group         : 0
CPE Upstream Filter Group          : 0
CPE Downstream Filter Group        : 0
DSA/DSX messages                   : permit all
Voice Enabled                      : NO
DS Change Times                    : 0
Boolean Services                   : 0
Number of Multicast DSIDs Support  : 0
MDF Capability Mode                : 0
IGMP/MLD Version                   : IGMPv2
FCType10 Forwarding Support        : N
Features Bitmask                   : 0x0
Total Time Online                  : 1d2h33m
CFG Max IPv6 CPE Prefix            : 16 (-1 used)
MAC Address                        : 0018.6832.069e
IP Address                         : 80.62.0.3
IPv6 Address                       : ---
Dual IP                            : N
Prim Sid                           : 15
Host Interface                     : C6/1/0/U0
MD-DS-SG / MD-US-SG                : 3 / N/A
MD-CM-SG                           : 0x2D0300
Primary Downstream                 : In6/1/0:0 (RfId : 600)
Wideband Capable                   : N
RCP Index                          : 0
RCP ID                             : 00 00 00 00 00
Downstream Channel DCID RF Channel : 193   6/1/0:0
Multi-Transmit Channel Mode        : N
Upstream Channel                   : US0
Ranging Status                     : sta
Upstream Power (dBmV)              : 0.00
Upstream SNR (dB)                  : 36.12
Upstream Data SNR (dB)             : --
Received Power (dBmV)              : 0.50
Timing Offset             (97.6 ns): 1196
Initial Timing Offset              : 1196
Rng Timing Adj Moving Avg(0.381 ns): -39
Rng Timing Adj Lt Moving Avg       : -92
Rng Timing Adj Minimum             : -256
Rng Timing Adj Maximum             : 0
Pre-EQ Good                        : 0
Pre-EQ Scaled                      : 0
Pre-EQ Impulse                     : 0
Pre-EQ Direct Loads                : 0
Good Codewords rx                  : 54
Corrected Codewords rx             : 0
Uncorrectable Codewords rx         : 0
Phy Operating Mode                 : tdma
sysDescr                           :
Downstream Power                   : 0.00 dBmV (SNR = ----- dB)
MAC Version                        : DOC2.0
QoS Provisioned Mode               : DOC1.1
Enable DOCSIS2.0 Mode              : Y
Modem Status                       : {Modem= online, Security=disabled}
Capabilities                       : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities              : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities                 : {L2VPN=N, eSAFE=N}
Sid/Said Limit                     : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support         : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support         : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs                  : 0(Max CPE IPs = 16)
CFG Max-CPE                        : 1
Flaps                              : 3(Mar 20 09:22:20)
Errors                             : 0 CRCs, 0 HCSes
Stn Mtn Failures                   : 0 aborts, 1 exhausted
Total US Flows                     : 2(2 active)
Total DS Flows                     : 2(2 active)
Total US Data                      : 13 packets, 6565 bytes
Total US Throughput                : 0 bits/sec, 0 packets/sec
Total DS Data                      : 13 packets, 4498 bytes
Total DS Throughput                : 0 bits/sec, 0 packets/sec
LB group ID assigned (index)       : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID                       : 0
LB policy ID in config file        : 0
LB priority                        : 0
Tag                                :
Required DS Attribute Mask         : 0x0
Forbidden DS Attribute Mask        : 0x0
Required US Attribute Mask         : 0x0
Forbidden US Attribute Mask        : 0x0
Service Type ID                    :
Service Type ID in config file     :
Active Classifiers                 : 0 (Max = NO LIMIT)
CM Upstream Filter Group           : 0
CM Downstream Filter Group         : 0
CPE Upstream Filter Group          : 0
CPE Downstream Filter Group        : 0
DSA/DSX messages                   : permit all
Voice Enabled                      : NO
DS Change Times                    : 0
Boolean Services                   : 0
Number of Multicast DSIDs Support  : 0
MDF Capability Mode                : 0
IGMP/MLD Version                   : IGMPv2
FCType10 Forwarding Support        : N
Features Bitmask                   : 0x0
Total Time Online                  : 6d12h
CFG Max IPv6 CPE Prefix            : 16 (-1 used)

The following example is a sample output of the show cable modem verbose command that displays the downstream channel information for all CMs:

Router# show cable modem verbose
MAC Address                        : 0006.2854.740b
IP Address                         : 0.0.0.0
IPv6 Address                       : ---
Dual IP                            : N
Prim Sid                           : 12
QoS Profile Index                  : 2
Host Interface                     : C6/1/0/U0
MD-DS-SG / MD-US-SG                : 3 / N/A
MD-CM-SG                           : 0x2D0300
Primary Downstream                 : In6/1/0:0 (RfId : 600)
Wideband Capable                   : N
RCP Index                          : 0
RCP ID                             : 00 00 00 00 00
Downstream Channel DCID RF Channel : 193   6/1/0:0
Multi-Transmit Channel Mode        : N
Upstream Channel                   :
Ranging Status                     :
Upstream Power (dBmV)              :
Upstream SNR (dB)                  :
Upstream Data SNR (dB)             :
Received Power (dBmV)              :
Timing Offset             (97.6 ns):
Initial Timing Offset              :
Rng Timing Adj Moving Avg(0.381 ns):
Rng Timing Adj Lt Moving Avg       :
Rng Timing Adj Minimum             :
Rng Timing Adj Maximum             :
Pre-EQ Good                        :
Pre-EQ Scaled                      :
Pre-EQ Impulse                     :
Pre-EQ Direct Loads                :
Good Codewords rx                  :
Corrected Codewords rx             :
Uncorrectable Codewords rx         :
Phy Operating Mode                 :
sysDescr                           :
Downstream Power                   : 0.00 dBmV (SNR = ----- dB)
MAC Version                        : DOC1.0
QoS Provisioned Mode               : DOC1.0
Enable DOCSIS2.0 Mode              : Y
Modem Status                       : {Modem= offline, Security=disabled}
Capabilities                       : {Frag=N, Concat=N, PHS=N}
Security Capabilities              : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities                 : {L2VPN=N, eSAFE=N}
Sid/Said Limit                     : {Max US Sids=0, Max DS Saids=0}
Optional Filtering Support         : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support         : {Taps/Symbol= 0, Num of Taps= 0}
Number of CPE IPs                  : 0(Max CPE IPs = 16)
CFG Max-CPE                        : 16
Flaps                              : 8218(Mar 22 03:17:15)
Errors                             : 0 CRCs, 0 HCSes
Stn Mtn Failures                   : 0 aborts, 222 exhausted
Total US Flows                     : 1(1 active)
Total DS Flows                     : 1(1 active)
Total US Data                      : 454 packets, 32291 bytes
Total US Throughput                : 0 bits/sec, 0 packets/sec
Total DS Data                      : 0 packets, 0 bytes
Total DS Throughput                : 0 bits/sec, 0 packets/sec
LB group ID assigned (index)       : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID                       : 0
LB policy ID in config file        : 0
LB priority                        : 0
Tag                                :
Required DS Attribute Mask         : 0x0
Forbidden DS Attribute Mask        : 0x0
Required US Attribute Mask         : 0x0
Forbidden US Attribute Mask        : 0x0
Service Type ID                    :
Service Type ID in config file     :
Active Classifiers                 : 0 (Max = NO LIMIT)
CM Upstream Filter Group           : 0
CM Downstream Filter Group         : 0
CPE Upstream Filter Group          : 0
CPE Downstream Filter Group        : 0
DSA/DSX messages                   : permit all
Voice Enabled                      : NO
DS Change Times                    : 0
Boolean Services                   : 0
Number of Multicast DSIDs Support  : 0
MDF Capability Mode                : 0
IGMP/MLD Version                   : IGMPv2
FCType10 Forwarding Support        : N
Features Bitmask                   : 0x0
Total Time Online                  : 00:00
CFG Max IPv6 CPE Prefix            : 16 (-1 used)
MAC Address                        : 0018.6832.0eb2
IP Address                         : 80.62.0.4
IPv6 Address                       : ---
Dual IP                            : N
Prim Sid                           : 13
Host Interface                     : C6/1/0/U0
MD-DS-SG / MD-US-SG                : 3 / N/A
MD-CM-SG                           : 0x2D0300
Primary Downstream                 : In6/1/0:0 (RfId : 600)
Wideband Capable                   : N
RCP Index                          : 0
RCP ID                             : 00 00 00 00 00
Downstream Channel DCID RF Channel : 193   6/1/0:0
Multi-Transmit Channel Mode        : N
Upstream Channel                   : US0
Ranging Status                     : sta
Upstream Power (dBmV)              : 0.00
Upstream SNR (dB)                  : 36.12
Upstream Data SNR (dB)             : --
Received Power (dBmV)              : 0.00
Timing Offset             (97.6 ns): 1192
Initial Timing Offset              : 1192
Rng Timing Adj Moving Avg(0.381 ns): -1
Rng Timing Adj Lt Moving Avg       : -7
Rng Timing Adj Minimum             : -256
Rng Timing Adj Maximum             : 0
Pre-EQ Good                        : 0
Pre-EQ Scaled                      : 0
Pre-EQ Impulse                     : 0
Pre-EQ Direct Loads                : 0
Good Codewords rx                  : 42
Corrected Codewords rx             : 0
Uncorrectable Codewords rx         : 0
Phy Operating Mode                 : tdma
sysDescr                           :
Downstream Power                   : 0.00 dBmV (SNR = ----- dB)
MAC Version                        : DOC2.0
QoS Provisioned Mode               : DOC1.1
Enable DOCSIS2.0 Mode              : Y
Modem Status                       : {Modem= online, Security=disabled}
Capabilities                       : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities              : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities                 : {L2VPN=N, eSAFE=N}
Sid/Said Limit                     : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support         : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support         : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs                  : 0(Max CPE IPs = 16)
CFG Max-CPE                        : 1
Flaps                              : 0()
Errors                             : 0 CRCs, 0 HCSes
Stn Mtn Failures                   : 0 aborts, 0 exhausted
Total US Flows                     : 2(2 active)
Total DS Flows                     : 2(2 active)
Total US Data                      : 9 packets, 4545 bytes
Total US Throughput                : 0 bits/sec, 0 packets/sec
Total DS Data                      : 9 packets, 3114 bytes
Total DS Throughput                : 0 bits/sec, 0 packets/sec
LB group ID assigned (index)       : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID                       : 0
LB policy ID in config file        : 0
LB priority                        : 0
Tag                                :
Required DS Attribute Mask         : 0x0
Forbidden DS Attribute Mask        : 0x0
Required US Attribute Mask         : 0x0
Forbidden US Attribute Mask        : 0x0
Service Type ID                    :
Service Type ID in config file     :
Active Classifiers                 : 0 (Max = NO LIMIT)
CM Upstream Filter Group           : 0
CM Downstream Filter Group         : 0
CPE Upstream Filter Group          : 0
CPE Downstream Filter Group        : 0
DSA/DSX messages                   : permit all
Voice Enabled                      : NO
DS Change Times                    : 0
Boolean Services                   : 0
Number of Multicast DSIDs Support  : 0
MDF Capability Mode                : 0
IGMP/MLD Version                   : IGMPv2
FCType10 Forwarding Support        : N
Features Bitmask                   : 0x0
Total Time Online                  : 4d14h
CFG Max IPv6 CPE Prefix            : 16 (-1 used)

Example of the show cable modem Command Output on the Cisco uBR7225VXR and Cisco uBR7246VXR Routers

The following example shows the sample output for the cm-status option in Cisco IOS Release 12.2(33)SCD on a Cisco uBR7246VXR router:

Router# show cable modem cm-status

I/F MAC Address Event TID Count Error Dups Time

C5/0 001e.6bfb.29a6 Seq out-of-range 1 1 0 1 Jan 18 09:00:19

C7/0   001c.ea2b.79b2 MDD timeout      0     0     1     0     Jan 11 11:29:22
                      QAM failure      0     0     1     0     Jan 11 11:29:02
                      MDD recovery     0     0     1     0     Jan 11 11:30:20
                      QAM recovery     0     0     1     0     Jan 11 11:30:13
C7/0   001c.ea2b.78b0 MDD timeout      0     0     1     0     Jan 11 11:29:16
                      QAM failure      0     0     1     0     Jan 11 11:28:53
                      MDD recovery     0     0     1     0     Jan 11 11:29:59
                      QAM recovery     0     0     1     0     Jan 11 11:29:46

The following example shows the sample output of the queue option for a particular CM in Cisco IOS Release 12.2(33)SCD:

Router# show cable modem 40.3.192.2 queue 
* idx/gqid Len/Limit Deqs      Drops     CIR       MIR/PR     ForwInt  SFID
             pkts    pkts      pkts      kbps       kbps
BE Queues:
    3/43     0/128   103       0         0           0/0      In5/1:1 Ca5/1:22
CIR Queues:
Low Latency Queues:

Example of the show cable modem Command Output for Partial Service Mode

The following example shows the sample output of the show cable modem command that displays the cable modems that are in upstream (indicated by "p" under I/F) and downstream partial service mode (indicated by "p-online" under MAC State):

Router# show cable modem
                                                                               D
MAC Address    IP Address     I/F         MAC           Prim RxPwr  Timing Num I
                                          State         Sid  (dBmv) Offset CPE P
0016.9252.9ac0 2.99.81.4      C7/0/0/U0   online(pt)    1    0.00   1332   0   N
000f.2172.229d 2.99.81.36     C7/0/0/U3   online(pt)    2    0.50   1778   0   N
001e.6bfb.33a0 2.99.81.14     C7/0/0/p    p-online(pt)  3    -0.50  1424   0   N
0022.cef4.3d9a 2.99.81.23     C7/0/0/p    p-online(pt)  4    0.00   1438   0   N
0019.474a.c456 2.99.81.18     C7/0/0/U3   online(pt)    5    0.00   1336   0   N
001e.6bfb.194e 2.99.81.32     C7/0/0/p    p-online(pt)  6    -0.50  1422   0   N
00e0.6f8b.a888 2.99.81.31     C7/0/0/U3   online(pt)    7    0.50   1427   0   N
001e.6bfb.1538 2.99.81.38     C7/0/0/p    p-online(pt)  8    0.00   1423   0   N
001e.6bfb.0d22 2.99.81.29     C7/0/0/p    p-online(pt)  9    0.00   1738   0   N
001e.6bfb.1a7e 2.99.81.30     C7/0/0/p    p-online(pt)  10   0.00   1738   0   N
0019.474a.c418 2.99.81.75     C7/0/0/U1   online(pt)    11   0.00   1335   0   N
001e.6bfa.f58a 2.99.81.9      C7/0/0/p    p-online(pt)  12   0.00   1737   0   N
0022.cef4.3fa2 2.99.81.24     C7/0/0/p    p-online(pt)  13   0.00   1438   0   N
001e.6bfb.1b72 2.99.81.10     C7/0/0/p    p-online(pt)  14   -0.50  1425   0   N
0019.474a.c330 2.99.81.34     C7/0/0/U0   online(pt)    15   0.00   1028   0   N
0023.be50.e578 2.99.81.17     C7/0/0/UB   p-online(pt)  16   0.00   1805   0   N
0025.2e2d.784a 2.99.81.28     C7/0/0/UB   p-online(pt)  17   0.50   1798   0   N
0025.2e2d.748c 2.99.81.26     C7/0/0/UB   p-online(pt)  18   0.00   1798   0   N
001e.6bfa.f070 2.99.81.37     C7/0/0/U3   online(pt)    20   0.50   1735   0   N
0019.474a.c422 2.99.81.20     C8/0/0/U1   online(pt)    1    0.50   1340   0   N
0019.474a.c466 2.99.81.21     C8/0/0/U1   online(pt)    2    0.00   1334   0   N
001e.6bfb.2e96 2.99.81.33     C8/0/0/UB   w-online(pt)  3    0.00   1738   0   N

Table 5 describes the significant fields shown in the display:

Table 5 show cable modem Field Descriptions 

Field
Description

MAC Address

MAC address for the CM.

IP Address

IP address that the DHCP server has assigned to the CM.

IPv6 Address

IPv6 address that the DHCP server has assigned to the CM.

Dual IP

Support of dual IP for both IPv4 and IPv6 addressing.

I/F, Interface

Cable interface line card providing the upstream for this CM.

sysDescr

Vendor and model of the cable modem, as reported by the cable modem. This field displays a value only when the cable modem remote-query command is configured.

Upstream Power

Downstream Power

Upstream and Downstream Power fields are displayed only if the CM remote-query feature has been enabled using the cable modem remote-query command. Upstream Power displays the CM transmit level in dBmV, and Downstream Power displays the dBmV level received at the CM, as measured by the CMTS.

MAC State

Current state of the MAC layer.

Prim SID

Primary SID assigned to this CM.

Host Interface

Host interface name.

Primary Wideband Channel ID

Bonding group ID of the wideband interface assigned to the CM.

MD-DS-SG

MAC Domain Downstream Service Group, the downstream channels of a single MAC domain that reach the cable modem.

DSID

Downstream Service Identifier.

Primary Downstream

Primary downstream channel assigned to the CM.

Wideband Capable

Cable modem is wideband-capable or not.

Downstream Channel DCID RF Channel

Downstream channel and channel ID used by a CM.

Multi-Transmit Channel Mode

Cable modem is in MTC mode or not.

Upstream SNR

Upstream signal-to-noise ratio (SNR) for a particular cable modem (CM), in decibels (dB).

Upstream SM MER (dB)

Upstream station maintenance (SM) modulation error ratio (MER) for a particular cable modem, in decibels (dB).

Upstream Data MER (dB)

Upstream modulation error ratio (MER) for a particular cable modem, in decibels (dB). This field is displayed only when RF adaptation is enabled.

RxPwr, Received Power

Average power in dBmV for the upstream channel symbol rate for the CM. With default settings, 0 dBmV is considered optimal, but a range of -1 to 1 dBmV is allowable. When CMs exceed this range, older Cisco IOS releases supported a drop to as low as -2 dBmV. Recent Cisco IOS releases support a drop to as low as -4 dBmV.

This field supports a resolution of 0.25 dBmV, but the dB resolution level for CMs and for the Cisco CMTS are slightly higher—approximately 1.0 and 1.4 dB.

Note An asterisk (*) in the RxPwr column indicates that a power adjustment has been made for that CM. An exclamation point (!) indicates that the CM has reached its maximum power transmit level and cannot increase its power level further.

Timing Offset and Initial Timing Offset

Timing offset for the CM, in ticks, as recognized on the CMTS. (A tick, as used here, is 6.25/64 microseconds.) This is the delay between when a particular cable modem is scheduled to make a transmission and when the CMTS actually receives it.

Note An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command.

Note The timing offset shown here is typically smaller than the TX Time Offset value shown by the show cable modem remote-query command, because the latter value is the offset as recognized on the CM (which will include any internal delay between when the CM software begins the transmission and when the bits actually appear on the local cable interface).

Reported Transmit Power (dBmV)

Reported Transmit Power level by the cable modem for each upstream channel. This applies only to the cable modems operating in the MTC mode.

Peak Transmit Power (dBmV)

This is the maximum transmit power level that the cable modem in the MTC mode could transmit at for the upstream channel.

Minimum Transmit Power (dBmV)

This is the minimum transmit power level that the cable modem in the MTC mode could transmit at for the upstream channel.

Rng Timing Adj Moving Avg(0.381 ns):
Rng Timing Adj Lt Moving Avg:
Rng Timing Adj Minimum:
Rng Timing Adj Maximum:

A Cisco CMTS router tracking variables to see relative timing offset adjustments.

Pre-EQ Good :
Pre-EQ Scaled :
Pre-EQ Impulse:
Pre-EQ Direct Loads

Equalizer statistics counter.

Good Codewords rx

Good code words for a particular upstream channel. This counter is reset during interface reset.

Corrected Codewords rx

Correctable code words for a particular upstream channel. This counter is reset during interface reset.

Uncorrectable Codewords rx

Uncorrectable code words for a particular upstream channel. This counter is reset during interface reset.

sysDescr

Identifies the vendor and model of the cable modem, as reported by the cable modem. This field displays a value only when the cable modem remote-query.

Num CPEs, CFG Max-CPE

Indicates the number of CPE devices for which the CM is providing services.

Number of CPE IPs

Indicates the maximum number of IP addresses assigned to CPE devices behind this CM, as configured by the cable max-hosts command.

Ver, MAC Version

Displays the maximum supported version of DOCSIS that the CM supports (DOCSIS 1.0, DOCSIS 1.1, DOCSIS 2.0).

QoS Prov, QoS Provisioned Mode

Displays the version of DOCSIS that the CM currently is provisioned for (DOCSIS 1.0, DOCSIS 1.1, DOCSIS 2.0).

Enable DOCSIS 2.0 Mode

Indicates that the cable modems are allowed to come online when in mixed-mode environments such as DOCSIS 1.0 TDMA, DOCSIS 1.1 TDMA and DOCSIS 2.0 ATDMA. This value is set to Y by default, unless the TLV 39 has been set to disabled (0) in the CM's Registration Request message or in the DOCSIS configuration file.

Phy Operating Mode

Indicates the type of PHY-layer modulation that the CM is using: tdma or atdma. Also indicates the TDMA/ATDMA/SCDA mode that the cable modem is operating on a specific channel.

Modem Status

Indicates the overall modem state and the security state of the primary SID.

BPI Enbld, BPI

Indicates whether or not Baseline Privacy Interface (BPI) or BPI Plus (BPI+) encryption is enabled for the CM.

DIP

Dual IP flag. Identifies whether or not ("Y" or "N") the CM or CPE supports both IPv4 and IPv6 addressing.

Capabilities

Indicates what the CM reported as its capabilities in its Registration Request message: DOCSIS fragmentation, concatenation, packet header suppression (PHS), and BPI encryption.

Security Capabilities

Indicates the privacy mode used by the CM (BPI or BPI+), early authentication and encryption (EAE) support, and the Key Length.

Optional Filtering Support

Indicates whether 802.1P or 802.1Q packet filtering is enabled for this CM.

Transmit Equalizer Support

Number of taps being used for transmit equalization.

Flaps

Number of flaps reported by this CM, with the date and time of the last flap within the parentheses.

Errors

Number of frame CRC and HCS errors reported for this CM.

Stn Mtn Failures

Number of station maintenance (cable keepalive) messages that the CMTS sent to this CM but did not receive any reply.

Total US Flows

Total number of upstream service flows, with the number of active service flows within the parentheses.

Total DS Flows

Total number of downstream service flows, with the number of active service flows within the parentheses.

Total US Data

Total data this CM has transmitted on the upstream, in packets and bytes.

Total US Throughput

Calculated throughput for this CM on the upstream, if available.

Total DS Data

Total data this CM has received on the downstream, in packets and bytes.

Total DS Throughput

Calculated throughput for this CM on the downstream, if available.

Active Classifiers

Current number of active classifiers for this CM, with the maximum number of allowable classifiers for this CM within the parentheses.

CM Required Attribute

Indicates the current required attribute-mask value.

CM Forbidden Attribute

Indicates the current forbidden attribute-mask value.

DSA/DSX messages

Indicates whether dynamic service changes (DSX) from the cable modem are permitted (permit all) or disallowed (reject all).

Voice Enabled

Indicates whether the CM is voice-enabled.

Number of Multicast DSIDs Support

Indicates the total number of supported multicast DSIDs.

FCType10 Forwarding Support

Indicates FCType10 Forwarding Support.

Dynamic Secret

Dynamically-generated shared secret (a 16-byte hexadecimal value) that was used in the cable modem's previous registration cycle. If the cable modem is currently offline, this field shows all zeroes.

Note This field displays a value only when the cable dynamic-secret command has been used on the CMTS interface.

Total Time Online

Amount of time in days, hours, and minutes that this CM has been continuously online since it last registered with the CMTS. This field begins incrementing whenever the CM enters one of the online(x) MAC states, and is reset to 0 whenever the CM enters any other MAC state.

Event

Event type.

TID

Transaction identifier.

Count

Number of valid messages received.

Dups

Number of duplicate messages received.

Time

Time when last valid event was received.

Len/Limit Pkts

Queue length and limit in packets.

Deqs Pkts

Dequeue packets.

Drops Pkts

Dropped packets.

CIR Kbps

Committed information rate.

MIR/PR Kbps

Maximum information and peak rate.

Forwint

Forwarding interface.

SFID

Service flow identifier.

BE Queues

Best effort queues.

CIR Queues

Committed information rate queues.

Low Latency Queues

Low latency queues.


Table 23 shows the possible values for the MAC state field:

Table 6 Descriptions for the MAC State Field 1

MAC State Value
Description
Ranging Status Conditions for Devices Using IPv4 Addressing

init(r1)

The CM sent initial ranging.

init(r2)

The CM is ranging. The CMTS received initial ranging from the Cm and has sent RF power, timing offset, and frequency adjustments to the CM.

init(rc)

Ranging has completed.

Note If a CM appears to be stuck in this state, it could be that the CM is able to communicate successfully on the cable network, but that the upstream is at capacity and does not have any additional bandwidth to allow the CM to finish registration and come online. Either manually move one or more CMs to other upstreams, or enable load balancing on the upstream using the cable load-balance group commands.

Early Authentication and Encryption

assign(epk)

BPI is enabled and KEK is assigned.

assign(ept)

BPI is enabled and TEK is assigned. The registration messages will be encrypted.

Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing

If early authentication and encryption is used, the letter `s' is appended to these states to indicate secure registration.

init(d)

The DHCP request was received, as DHCPDISCOVER. This also indicates that the first IP broadcast packet has been received from the CM.

init(dr)

The DHCP request has been sent to the cable modem.

init(i)

The cable modem has received the DHCPOFFER reply (DHCPACK) from the DHCP server that has assigned an IP address to the modem, but the modem has not yet replied with a DHCPREQUEST message requesting that particular IP address, nor has it sent an IP packet with that IP address.

Note If a CM appears to be stuck in this state, the CM has likely received the DHCPOFFER reply from the DHCP server, but this reply might have contained one or more invalid options for that particular CM.

init(io)

The Cisco CMTS has seen the DHCP offer as sent to the cable modem from the DHCP server that has assigned an IP address to the modem.

init(o)

The CM has begun to download the option file (DOCSIS configuration file) using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP response. If the CM remains in this state, it indicates that the download has failed.

init(t)

Time-of-day (TOD) exchange has started.

Registration and Provisioning Status Conditions for Devices Using IPv6 Addressing

If early authentication and encryption is used, the letter `s' is appended to these states to indicate secure registration.

init6(s)

The Cisco CMTS router has seen the DHCPv6 SOLICIT message from the CM.

init6(a)

The Cisco CMTS router has seen the ADVERTISE message from the DHCPv6 server to the CM.

init6(r)

The Cisco CMTS router has seen the REQUEST response from the CM to the DHCPv6 server.

init6(i)

The Cisco CMTS router has seen the REPLY message from the DHCPv6 server to the CM.

init6(o)

The Cisco CMTS router has seen the REQEST message from the CM to the TFTP server.

init6(t)

The Cisco CMTS router has seen the REQUEST message from the CM to the TOD server.

Non-error Status Conditions

cc(r1)

The CM had registered and was online, but has received a Downstream Channel Change (DCC) or Upstream Channel Change (UCC) request message from the CMTS. The CM has begun moving to the new channel, and the CMTS has received the CM's initial ranging on the new downstream or upstream channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

cc(r2)

This state should normally follow cc(r1) and indicates that the CM has finished its initial ranging on the new channel, and is currently performing continuous ranging on the new channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

offline

The CM is considered offline (disconnected or powered down).

resetting

The CM is being reset and will shortly restart the ranging and registration process.

online

The CM has registered and is enabled to pass data on the network.

online(d)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. The CM does not forward traffic to or from the CPE devices, but the CMTS can continue to communicate with the CM using DOCSIS messages and IP traffic (such as SNMP commands).

Note If BPI was enabled in the DOCSIS configuration file sent to the CM, assume that the CM is using BPI encryption, unless other messages show that the BPI negotiation and key assignments have failed.

online(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and KEK is assigned.

Note This state is equivalent to the online(d) and online(pk) states.

online(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note This state is equivalent to the online(d) and online(pt) states.

online(pk)

The CM registered, BPI is enabled and KEK is assigned.

online(pt)

The CM registered, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note If network access was disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) instead of online(pt) even when BPI encryption is enabled and operational.

expire(epk)

Early authentication and encryption is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

expire(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pk) states.

expire(ept)

Early authentication and encryption is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

expire(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pt) states.

Error Status Conditions

reject(m)

The CM attempted to register but registration was refused due to a bad Message Integrity Check (MIC) value. This also could indicate that the shared secret in the DOCSIS configuration file does not match the value configured on the CMTS with the cable shared-secret command.

In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases, this could also indicate that the cable tftp-enforce command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so.

reject(c)

The CM attempted to register, but registration was refused due to a a number of possible errors:

The CM attempted to register with a minimum guaranteed upstream bandwidth that would exceed the limits imposed by the cable upstream admission-control command.

The CM has been disabled because of a security violation.

A bad class of service (COS) value in the DOCSIS configuration file.

The CM attempted to create a new COS configuration but the CMTS is configured to not permit such changes.

The CM failed the timestamp check for its DOCSIS configuration file. (This could indicate a possible theft-of-service attempt, or a problem with the synchronization of the clocks on the CM and CMTS.)

reject(epk)

Early authentication and encryption is enabled, KEK key assignment is rejected, and the modem has not been authenticated.

reject(pk)

KEK key assignment is rejected, and the modem has not been authenticated.

reject(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because KEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pk) states.

reject(ept)

Early authentication and encryption is enabled, TEK key assignment is rejected, and BPI encryption has not been established.

reject(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because TEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pt) states.

reject(ts)

The CM attempted to register, but registration failed because the TFTP server timestamp in the CM registration request did not match the timestamp maintained by the CMTS. This might indicate that the CM attempted to register by replaying an old DOCSIS configuration file used during a prior registration attempt.

reject(ip)

The CM attempted to register, but registration failed because the IP address in the CM request did not match the IP address that the TFTP server recorded when it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.

reject(na)

The CM attempted to register, but registration failed because the CM did not send a Registration-Acknowledgement (REG-ACK) message in reply to the Registration-Response (REG-RSP) message sent by the CMTS. A Registration-NonAcknowledgement (REG-NACK) is assumed.

1 The CM MAC state field can also be retrieved using SNMP by getting the value of the cdxCmtsCmStatusValue object in the CISCO-DOCS-EXT-MIB.

1 The following symbols appended to the modem state indicate a special condition:

1 An exclamation mark (!) indicates that the cable dynamic-secret command is used with either the mark or reject keyword and the cable modem has failed the dynamic secret authentication check.

1 An ampersand (&) indicates that the cable modem has registered using a self-signed certificate. This is inherently not secure and can be avoided by negating the cable privacy accept-self-signed-certificate command.

1 A hash sign (#) indicates that the cable modem is using an unknown configuration file. To solve this problem, use the cable dynamic-secret command with the reject keyword. This will reject registration for CMs with DOCSIS configuration files.


1 In Cisco IOS Releases 12.1(20)EC, 12.2(15)BC1, and earlier releases, when network access is disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) even if BPI encryption fails.




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 modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem access-group

Displays the access groups for the CMs on a particular cable interface.

show cable modem calls

Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.

show cable modem classifiers

Displays information about the classifiers for a particular CM.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem counters

Displays downstream and upstream traffic counters for one or more CMs.

show cable modem cpe

Displays the CPE devices accessing the cable interface through a particular CM.

show cable modem domain-name

Updates the cable-specific DNS cache and display the domain name for specified CMs and CPE behind a CM on a Cisco CMTS router.

show cable modem errors

Displays error statistics for one or more CMs.

show cable modem flap

Displays flap list statistics for one or more CMs.

show cable modem ipv6

Displays IPv6 information for specified CMs and CPE behind a CM on a Cisco CMTS router.

show cable modem mac

Displays MAC layer information for one or more CMs.

show cable modem maintenance

Displays station maintenance (SM) error statistics for one or more CMs.

show cable modem offline

Displays a list of the CMs that are marked as offline with the Cisco CMTS.

show cable modem partial-mode

Displays information about the cable modems that are in upstream and downstream partial service mode.

show cable modem phy

Displays the DOCSIS PHY layer information for one or more CMs.

show cable modem qos

Displays quality of service (QoS) and service flow information for a particular CM.

show cable modem registered

Displays a list of the CMs that are marked as registered with the Cisco CMTS.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show cable modem summary

Displays a summary of CMs on one or more cable interfaces.

show cable modem unregistered

Displays a list of the CMs that are marked as unregistered with the Cisco CMTS.

show cable modem vendor

Displays the vendor name or Organizational Unique Identifier (OUI) for the CMs on each cable interface.

show cable modulation-profile

Displays modulation profile group information.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem access-group

To display the access groups for the CMs on a particular cable interface, use the show cable modem access-group command in privileged EXEC mode.

Cisco uBR7100 series and Cisco uBR7200 series routers:

show cable modem [ip-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | mac-address] access-group

Cisco uBR10012 routers:

show cable modem cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] access-group

Syntax Description

ip-address

(Optional) Access-group information displayed for the CM with the specified IP address. (Cisco uBR7100 series and Cisco uBR7200 series routers only.)

mac-address

(Optional) Access-group information displayed for the CM with the specified MAC address. (Cisco uBR7100 series and Cisco uBR7200 series routers only.)

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using this specific upstream. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports on the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

access-group

Displays the access groups for the CMs and their associated hosts and other customer premises equipment (CPE) devices.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

11.3XA

This command was introduced.

12.2(4)BC1

Support for this command was added for the Cisco uBR10012 router, but only to display access groups on a per-interface basis.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

This command displays information only for CMs. To display information for both CMs and their associated hosts and other customer premises equipment (CPE) devices, use the show cable device access-group command. To display information only for hosts, use the show cable host access-group command.

If an SNMP manager is requesting information about CM or CPE devices at the same time that this command is given, the command displays the following error message:

No information is available, please try later.

Wait until the SNMP retrieval is done and retry the CLI command.


Note Also see the information about this command's behavior in a Hot Standby Connection-to-Connection Protocol (HCCP) configuration.


Examples

The following example shows sample output for the show cable modem access-group command on a Cisco uBR7200 series router for a particular CM:

Router# show cable modem 0010.7bb3.fcd1 access-group 
MAC Address    IP Address      Access-group
0010.7bb3.fcd1 10.20.113.2     34 
Upstream Power     : 42 dBmV (SNR = 10 dBmV)
Downstream Power   : 15 dBmV (SNR = 15 dBmV)
Router# 

Note The upstream and downstream power fields will be displayed only if the CM remote-query feature has been enabled using the cable modem remote-query command.


The following example shows sample output for the show cable modem access-group command for a particular cable interface on a Cisco uBR10012 router:

Router# show cable modem c8/1/0 access-group 
MAC Address    IP Address      Access-group
0050.7366.1243 22.1.1.11       1 
0002.b970.0027 23.1.1.10       1 
0006.5314.858d 22.1.1.10       N/A 
Router# 

Table 0-7 describes the fields that are shown in the show cable modem access-group display:

Table 0-7 Descriptions for the show cable modem access-group Fields 

Field
Description

MAC Address

The MAC address for the CM.

IP Address

The IP address that the DHCP server has assigned to the CM.

Access-group

Displays the access group name or number in use (if any) for this CM.



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 modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable device access-group

Displays a list of CMs and their CPE devices, along with their access groups.

show cable host access-group

Displays a list of hosts and other CPE devices, along with their access groups.

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem calls

Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.

show cable modem classifiers

Displays information about the classifiers for a particular CM.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem cpe

Displays the CPE devices accessing the cable interface through a particular CM.

show cable modem errors

Displays error statistics for one or more CMs.

show cable modem flap

Displays flap list statistics for one or more cable modems.

show cable modem maintenance

Displays station maintenance (SM) error statistics for one or more cable modems.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show cable modulation-profile

Displays modulation profile group information.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem auth-profile

To display the multicast authorization profile, and profile group information for a particular IP address or MAC address, use the show cable modem auth-profile command in privileged EXEC mode.

show cable modem [ip-address | mac-address] [auth-profile]

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a CM that is displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a CM that is displayed. You can also specify the MAC address for a CPE device behind a CM, and information for that CM will be displayed.

auth-profile

(Optional) Displays the multicast authorization profile, and profile group information.


Command Default

None

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCB

This command was introduced.


Usage Guidelines

Use this command to display the multicast authorization profile, and the profile group information.

Examples

The following sample output of the show cable modem auth-profile command shows the multicast authorization profile and profile group display for a particular ip-address or mac-address.

Router# show cable modem 30.17.2.23 auth-profile
Multicast Profile Information for 0025.2e34.4377
IP: 30.17.2.121
Multicast Profile Group #           : default
Router#

Related Commands

Command
Description

show cable multicast authorization

Displays the list of defined multicast authorization profiles and all CMs associated with corresponding profiles.

show cable multicast dsid

Displays the entire multicast downstream service identifier (DSID) database content.

show cable multicast qos

Displays the configuration information for MQoS (Group-Config, Group-QoS-Config, Group-Encryption-Config).


show cable modem calls

To display voice call information for a particular CM, use the show cable modem calls command in privileged EXEC mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] calls

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] calls

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

calls

Display voice call information for a CM.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.3(13a)BC1

Support for voice call information was added to the show cable modem command.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

Using the keyword options, you can display IPv6 information by IP address (IPv4 or IPv6) of a particular CM, for all CMs associated with a specified cable interface, by MAC address of a CM, or by domain name of a CM.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


This command supports PacketCable and PacketCable MultiMedia (PCMM) information. Additional information for voice call support with PacketCable and PacketCable MultiMedia (PCMM) is available in the feature document PacketCable and PacketCable Multimedia for the Cisco CMTS available on Cisco.com:

Examples

The following example shows sample output for the default calls option for a particular CM:

Router# show cable modem calls
Cable Modem Call Status Flags:
H: Active high priority calls
R: Recent high priority calls
V: Active voice calls (including high priority)
MAC Address    IP Address      I/F       Prim  CMCallStatus  LatestHiPriCall
                                         Sid                    (min:sec)
000f.66f8.a121 10.8.130.63     C4/0/U0   175   HV                   -

Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable calls

Displays voice call history information and status for the PacketCable Emergency 911 Services Listing and History feature.

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem classifiers

Displays information about the classifiers for a particular CM.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem errors

Displays error statistics for one or more CMs.

show cable modem flap

Displays flap list statistics for one or more cable modems.

show cable modem maintenance

Displays station maintenance (SM) error statistics for one or more cable modems.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show cable modulation-profile

Displays modulation profile group information.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem classifiers

To display information about the classifiers for a particular CM, use the show cable modem classifiers command in privileged EXEC mode.

show cable modem {ip-address | mac-address} [name fqdn] classifiers [cache | verbose]

Syntax Description

ip-address

Specifies the IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, classifier information for that CM is displayed.

mac-address

Displays classifier information for the CM with the specified MAC address. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

cache

(Optional) Displays the classifiers in the cache maintained for each CM. (This cache is based on IP header field values and speeds up classifier lookups and reduces per-packet processing overhead.)

verbose

(Optional) Displays detailed information for the CM classifiers.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

11.3 NA

This command was introduced.

12.1(4)CX and 12.2(4)BC1

The number of matches field was added to this command, and the command was restricted to display information for a single CM at a time.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.


Usage Guidelines

This command displays classifier information for a particular CM, identified either by its IP address, MAC address, or domain name.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.



Note For information about this command's behavior in a Hot Standby Connection-to-Connection Protocol (HCCP) configuration, see the "Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration" section of the show cable modem command.


Examples

The following example shows sample output for the default classifiers option for a particular CM:

Router# show cable modem 10.4.0.81 classifiers 
CfrId  SFID     CM Mac Address  Direction  State    Priority  Matches
6431   26120    0000.399f.a44f  upstream   active   128       -
6429   26054    0000.399f.a44f  upstream   active   128       -
6432   26121    0000.399f.a44f  downstream active   128       1182
6430   26055    0000.399f.a44f  downstream active   128       3934
Router# 

Table 8 describes the fields that are shown in the show cable modem classifiers display:

Table 8 Descriptions for the show cable modem classifiers Fields 

Field
Description

CfrID

Classifier ID for the classifier that is being displayed.

SFID

Service flow ID (SFID) for this classifier.

CM MAC Address

MAC address for the CM.

Direction

Identifies whether this classifier applies to the downstream or the upstream direction.

State

Classifier activation state: active or inactive.

Priority

Classifier rule priority value for this classifier.

Matches

Number of packets that have been matched to this service flow.



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 modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem calls

Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem errors

Displays error statistics for one or more CMs.

show cable modem flap

Displays flap list statistics for one or more cable modems.

show cable modem maintenance

Displays station maintenance (SM) error statistics for one or more cable modems.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modulation-profile

Displays modulation profile group information.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem cnr

To display information about the upstream carrier-to-noise ratio (CNR) or signal-to-noise ratio (SNR) for a particular cable modem (CM), use the show cable modem command in privileged EXEC mode.

show cable modem {ip-address | mac-address | name fqdn} cnr

Syntax Description

ip-address

IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a customer premise equipment (CPE) device behind a CM, classifier information for that CM is displayed.

mac-address

Classifier information for the CM with the specified MAC address. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

name fqdn

Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable domain name system (DNS) cache on the Cisco CMTS router.


Command Modes

Privileged EXEC (#)

Command History

This table includes the following release-specific history entries:

BC Release

CX Release

SC Release

BC Release
Modification

12.2(4)BC2

The command was changed to its current form of show cable modem cnr.

12.2(8)BC2

Support was added for the Cisco uBR-LCP2-MC16S cable interface line card on the Cisco uBR10012 router.

12.2(11)BC3

Support was added for the Cisco uBR10-MC5X20S cable interface line cards on the Cisco uBR10012 router.

12.2(15)BC1

If a cable modem is offline, its CNR value is now shown as "-----".

12.2(15)BC2

Support was added for the Cisco uBR-MC16U/X and Cisco uBR-MC5X20U cable interface line cards.

12.3(17a)BC2

Support was added for the Cisco uBR-MC5X20H cable interface line card.

CX Release
Modification

12.1(7)CX1

This command was introduced (in the form of show cable modem snr) for Cisco uBR7200 series routers using the Cisco uBR-MC16S cable interface line card.

12.2(15)CX

Support was added for the Cisco uBR-MC28U/X cable interface line cards on the Cisco uBR7246VXR router.

SC Release
Modification

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

The following new initialization states were added to show initialization of CMs and CPEs supporting IPv6:

init6(s)—Cisco CMTS router has seen SOLICIT message.

init6(a)—Cisco CMTS router has seen ADVERTISE message.

init6(r)—Cisco CMTS router has seen REQUEST message.

init6(i)—Cisco CMTS router has seen REPLY message.

init6(o)—Cisco CMTS router has seen version 6 TFTP request.

init6(t)—Cisco CMTS router has seen version 6 TOD request.

12.2(33)SCC

The output of this command was modified to show the CNR and SNR information for multiple upstream connections providing service to a single CM.

12.2(33)SCF

The output of this command was modified to show expected power level, received carrier power level, and CNR information for all the upstream channels providing services to a CM. The SNR information is no longer displayed in the output of this command.


Usage Guidelines

The show cable modem cnr command displays information on the current CNR value for cable modems that are using interfaces on the following cable line cards:

Cisco uBR-MC16U/X

Cisco uBR-MC28U/X

Cisco uBR10-MC5X20S/U/H

Cisco uBR-E-28U

Cisco uBR-E-16U

For cable modems on all other interfaces, this command displays information about the current SNR value of the modem.

In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the Cisco CMTS router before any domain name can be used as part of a cable command.

Starting Cisco IOS Release 12.2(33)SCF, carrier-to-noise plus interference ratio (CNiR [CNR]) can be measured for all upstream channels irrespective of whether spectrum management is enabled or not for the upstream channels. Therefore, the output of the show cable modem cnr command displays only the CNR (CNiR) values for all the upstream channels for a specific cable modem.

Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address cnr command might not show a particular cable modem until the Cisco CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address cnr command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when the HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond with a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


Tip In Cisco IOS Release 12.1(12)EC, Cisco IOS 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.


Examples

The following example is a sample output of the show cable modem cnr command for a CM:

Router# show cable modem 10.20.114.34 cnr 
MAC Address    IP Address      I/F         MAC         Prim  snr/cnr
                                           State       Sid   (db)
00d0.ba77.7595 10.20.114.34    Cable3/0/U5 online      1     45.00

The following example is a sample output of the show cable modem cnr command after an HCCP switchover. The CNR value is missing until traffic is sent to the cable modem (in this case using the ping command).

Router# show cable modem 10.10.10.46 cnr 
MAC Address    IP Address      I/F         MAC         Prim  snr/cnr 
                                           State       Sid   (db)
0002.fd22.aadf 10.10.10.46     C5/1/0/U5   online      1970  ----- 
Router# ping 10.10.10.46 
Router# show cable modem 10.10.10.46 cnr 
MAC Address    IP Address      I/F         MAC         Prim  snr/cnr 
                                           State       Sid   (db)
0002.fd22.aadf 10.10.10.46     C5/1/0/U5   online      1970  42.00 

The following example is a sample output of the show cable modem cnr command for all upstream ports providing service to a specified cable modem in Cisco IOS Release 12.2(33)SCC:

Router# show cable modem 0014.f8c1.fd1a cnr
MAC Address    IP Address      I/F         MAC         SID   snr/cnr
                                           State             (dB)
0014.f8c1.fd1a 10.10.4.1       C5/0/1/U0   online        1        33
001e.6bfb.119a 9.9.9.2         C5/0/1/U1   online        2        33
001e.6bfb.0f9e 9.9.9.3         C5/0/1/U2   online        3        33
0019.474a.d4c4 9.9.9.4         C5/0/1/U3   online        4        33

The following example is a sample output of the show cable modem cnr command for an upstream port providing service to a specified cable modem in Cisco IOS Release 12.2(33)SCF:

Router# show cable modem 0022.cea4.f0fa cnr
MAC Address    IP Address     I/F         MAC          Prim ExPwr  RxPwr  cnr
                                          State        Sid  (dBmv) (dBmv) (dB)
0022.cea4.f0fa 10.10.1.62     C8/1/14/U3  w-online     78   0.0    -0.50  23

Table 9 describes the significant fields shown in the display:

Table 9 show cable modem cnr Field Descriptions 

Field
Description

MAC Address

MAC address of the CM.

IP Address

IP address that the DHCP server has assigned to the CM.

I/F

Cable interface line card providing the upstream for this CM.

MAC State

Current state of the MAC layer (see Table 23).

Prim Sid

Primary Sid assigned to this CM.

In Cisco IOS Release 12.2(33)SCC, this field is renamed to SID and represents multiple upstream connections with unique SIDs providing service to a single CM.

ExPwr (dBmv)

Expected carrier power level, in decibel millivolts (dBmv).

RxPwr (dBmv)

Received carrier power level, in decibel millivolts (dBmv).

snr/cnr (db)

The current upstream CNR or SNR for this particular CM, in decibels (dB). In Cisco IOS Release 12.2(15)BC1 and later releases, this field shows "-----" for offline cable modems.

Note You can also use the show controllers cable command to display the SNR or CNR for a cable interface line card, but this value is only an estimate because it uses a random sampling of modems to determine the average for the card at any particular time. The CNR value shown by the show controllers cable command can therefore appear to fluctuate compared to the individual values shown by the show cable modem cnr command.


Table 23 shows the possible values for the MAC state field.

Table 10 MAC State Field Descriptions 1

MAC State Value
Description
Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing

init(r1)

CM sent initial ranging.

init(r2)

CM is ranging. The Cisco CMTS received initial ranging from the CM and has sent RF power, timing offset, and frequency adjustments to the CM.

init(rc)

Ranging has completed.

Note If a CM appears to be stuck in this state, it could be that the CM is able to communicate successfully on the cable network, but that the upstream is at capacity and does not have any additional bandwidth to allow the CM to finish registration and come online. Either manually move one or more CMs to other upstreams, or enable load balancing on the upstream using the cable load-balance group commands.

init(d)

DHCP request was received, as DHCPDISCOVER. This also indicates that the first IP broadcast packet has been received from the CM.

init(dr)

Cable modem has broadcast a DHCP REQUEST packet back to the DHCP server.

init(i)

Cable modem has received the DHCPOFFER reply (DHCPACK) from the DHCP server that has assigned an IP address to the modem, but the modem has not yet replied with a DHCPREQUEST message requesting that particular IP address, nor has it sent an IP packet with that IP address.

Note If a CM appears to be stuck in this state, the CM has likely received the DHCPOFFER reply from the DHCP server, but this reply might have contained one or more invalid options for that particular CM.

init(io)

Cisco CMTS learns the DHCP offer that is sent to the cable modem from the DHCP server, which has assigned an IP address to the modem.

init(o)

CM has begun to download the option file (DOCSIS configuration file) using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP response. If the CM remains in this state, it indicates that the download has failed.

init(t)

Time-of-day (ToD) exchange has started.

resetting

CM is being reset and will shortly restart the registration process.

 

init6(s)

Cisco CMTS router learns the DHCPv6 SOLICIT message from the CM.

init6(a)

Cisco CMTS router learns the ADVERTISE message from the DHCPv6 server to the CM.

init6(r)

Cisco CMTS router learns the REQUEST response from the CM to the DHCPv6 server.

init6(i)

Cisco CMTS router learns the REPLY message from the DHCPv6 server to the CM.

init6(o)

Cisco CMTS router learns the REQUEST message from the CM to the TFTP server.

init6(t)

Cisco CMTS router learns the REQUEST message from the CM to the ToD server.

Non-error Status Conditions

cc(r1)

CM had registered and was online, but has received a Downstream Channel Change (DCC) or Upstream Channel Change (UCC) request message from the Cisco CMTS. The CM has begun moving to the new channel, and the Cisco CMTS has received the initial ranging of the CM on the new downstream or upstream channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

cc(r2)

This state should normally follow cc(r1) and indicates that the CM has finished its initial ranging on the new channel, and is currently performing continuous ranging on the new channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

offline

CM is considered offline (disconnected or powered down).

online

CM has registered and is enabled to pass data on the network.

online(d)

CM is registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. The CM does not forward traffic to or from the CPE devices, but the Cisco CMTS can continue to communicate with the CM using DOCSIS messages and IP traffic (such as SNMP commands).

Note If BPI was enabled in the DOCSIS configuration file sent to the CM, assume that the CM is using BPI encryption unless other messages show that the BPI negotiation and key assignments have failed.

online(pkd)

CM is registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and KEK is assigned.

Note This state is equivalent to the online(d) and online(pk) states.

online(ptd)

CM is registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note This state is equivalent to the online(d) and online(pt) states.

online(pk)

CM is registered, BPI is enabled and KEK is assigned.

online(pt)

CM is registered, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note If network access was disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) instead of online(pt) even when BPI encryption is enabled and operational.

Note If an exclamation point (!) appears in front of one of the online states, it indicates that the cable dynamic-secret command has been used with either the mark or reject option, and that the cable modem has failed the dynamic secret authentication check.

expire(pk)

CM is registered, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

expire(pkd)

CM is registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pk) states.

expire(pt)

CM is registered, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

expire(ptd)

CM is registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pt) states.

Error Status Conditions

reject(m)

CM attempted to register but registration was refused due to a bad Message Integrity Check (MIC) value. This also could indicate that the shared secret in the DOCSIS configuration file does not match the value configured on the Cisco CMTS with the cable shared-secret command.

In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases, this could also indicate that the cable tftp-enforce command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so.

reject(c)

CM attempted to register, but registration was refused due to a a number of possible errors:

CM attempted to register with a minimum guaranteed upstream bandwidth that would exceed the limits imposed by the cable upstream admission-control command.

CM has been disabled because of a security violation.

Bad class of service (CoS) value in the DOCSIS configuration file.

CM attempted to create a new CoS configuration but the Cisco CMTS is configured to not permit such changes.

CM failed the timestamp check for its DOCSIS configuration file. (This could indicate a possible theft-of-service attempt, or a problem with the synchronization of the clocks on the CM and Cisco CMTS.)

reject(pk)

KEK key assignment is rejected, BPI encryption has not been established.

reject(pkd)

CM is registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because KEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pk) states.

reject(pt)

TEK key assignment is rejected, BPI encryption has not been established.

reject(ptd)

CM is registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because TEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pt) states.

Note In Cisco IOS Release 12.1(20)EC, Cisco IOS Release 12.2(15)BC1, and earlier releases, when network access is disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) even if BPI encryption fails. Use the show cable modem mac-address command to confirm whether BPI is enabled or disabled for a particular cable modem.

reject(ts)

CM attempted to register, but registration failed because the TFTP server timestamp in the CM registration request did not match the timestamp maintained by the CMTS. This might indicate that the CM attempted to register by replaying an old DOCSIS configuration file used during a prior registration attempt.

reject(ip)

CM attempted to register, but registration failed because the IP address in the CM request did not match the IP address that the TFTP server recorded when it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.

reject(na)

CM attempted to register, but registration failed because the CM did not send a Registration-Acknowledgement (REG-ACK) message in reply to the Registration-Response (REG-RSP) message sent by the Cisco CMTS. A Registration-NonAcknowledgement (REG-NACK) is assumed.

1 The CM MAC state field can also be retrieved using SNMP by getting the value of the cdxCmtsCmStatusValue object in the CISCO-DOCS-EXT-MIB.


Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modulation-profile

Displays modulation profile group information.

show cable modem remote-query

Displays information collected by the remote-query feature.

show controllers cable

Displays information about the interface controllers for a cable interface on the Cisco CMTS router.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem connectivity

To display connectivity statistics for one or more CMs, use the show cable modem connectivity command in privileged EXEC mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] connectivity

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] connectivity

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using this specific upstream. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports on the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.1(4)CX and 12.2(4)BC1

This command was introduced (and the connectivity option was removed from the show interface cable sid command).

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

This command displays connectivity information for all CMs, for all CMs attached to a specific CMTS cable interface, or for a particular CM, as identified by its IP address or MAC address.

Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.



Note The show cable modem connectivity command replaces the connectivity option for the show interface cable sid command, because the connectivity statistics are better managed on a per-modem basis than on a per-SID basis.


Examples

The following example shows sample output for the show cable modem connectivity command for all online CMs:

Router# show cable modem connectivity 
Prim  1st time    Times  %online     Online time            Offline time
Sid   online      Online          min     avg     max     min     avg     max
1     Apr 28 2003 1      99.67   00:00   1d1h9m  1d1h9m  05:38   04:58   05:38  
2     Apr 28 2003 1      99.66   00:00   1d1h8m  1d1h8m  05:46   05:02   05:46  
3     Apr 28 2003 1      99.69   00:00   1d1h7m  1d1h7m  05:18   04:34   05:18  

The following example shows sample output for the show cable modem connectivity command for all online CMs for a particular cable interface:

Router# show cable modem c8/1/0 connectivity 
Prim  1st time    Times  %online     Online time            Offline time
Sid   online      Online          min     avg     max     min     avg     max
1     Apr 28 2003 1      99.67   00:00   1d1h12m 1d1h12m 05:38   04:58   05:38  
2     Apr 28 2003 1      99.66   00:00   1d1h11m 1d1h11m 05:46   05:02   05:46  
3     Apr 28 2003 1      99.69   00:00   1d1h11m 1d1h11m 05:18   04:34   05:18  

The following example shows sample output for the show cable modem connectivity command for a particular CM:

Router# show cable modem 0010.7bb3.fcd1 connectivity 
Prim  1st time    Times  %online     Online time            Offline time
Sid   online      Online          min     avg     max     min     avg     max
1     May 30 2000 4      99.85   48:20   11h34m  1d2h23m 00:01   00:59   03:00 

Table 11 describes the information shown in the show cable modem connectivity displays:

Table 11 Descriptions for the show cable modem connectivity Fields 

Field
Description

Prim SID

The primary SID assigned to this CM.

1st time online

First time at which the modem with this SID connected.

Times online

Number of times the modem with this SID connected.

% online

Percentage of time the modem with this SID has been connected.

Online time

The minimum, average, and maximum number of days, hours, and minutes the modem with this SID has been connected.

Note A CM is considered online when it has completed the registration process and has communicated with the DHCP, TFTP, and TOD servers.

Offline time

The minimum, average, and maximum number of days, hours, and minutes the modem with this SID has been disconnected.

Note A CM is considered offline after it has missed 16 consecutive station maintenance messages.



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 modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem calls

Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem flap

Displays flap list statistics for one or more cable modems.

show cable modem maintenance

Displays station maintenance (SM) error statistics for one or more cable modems.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show cable modulation-profile

Displays modulation profile group information.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem counters

To display downstream and upstream traffic counters for one or more cable modems (CMs), use the show cable modem counters command in privileged EXEC mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] counters

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] counters

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

counters

Displays downstream and upstream traffic counters for one or more cable modems.


Defaults

Displays counter information for all CMs.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.1(4)CX and 12.2(4)BC1

This command was introduced.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


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.



Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


Examples

The following example shows sample output for the show cable modems counters command for all CMs:

Router# show cable modem counters 
MAC Address    US Packets   US Bytes   DS Packets   DS Bytes
0050.7366.1243 29           2126       29           2126      
0002.b970.0027 1811         116174     29           2126      
0006.5314.858d 329154       21071059   134607       9961268   
Router# 

The following example shows sample output for the show cable modems counters command for all CMs on a particular cable interface:

Router# show cable modem c8/1/0 counters 
MAC Address    US Packets   US Bytes   DS Packets   DS Bytes
0050.7366.1243 29           2126       29           2126      
0002.b970.0027 1811         116174     29           2126      
0006.5314.858d 329154       21071059   134607       9961268   
Router# 

The following example shows sample output for the show cable modems counters command for a particular CM, as identified by its MAC address:

Router# show cable modem 0010.7bb3.fcd1 counters 
MAC Address    US Packets   US Bytes   DS Packets   DS Bytes
0010.7bb3.fcd1 1452082      171344434  1452073      171343858 
Router# 

The following example shows sample output for the show cable modems counters command for a particular CM, as identified by its IP address:

Router# show cable modem 23.1.1.10 counters 
MAC Address    US Packets   US Bytes   DS Packets   DS Bytes
0002.b970.0027 1811         116174     29           2126      
Router# 

Table 12 describes the fields shown in the show cable modem counters displays:

Table 12 Descriptions for the show cable modem counters Fields 

Field
Description

MAC Address

MAC address for the CM.

US Packets

Number of packets this CM has transmitted on the upstream.

US Bytes

Number of bytes this CM has transmitted on the upstream.

DS Packets

Number of packets this CM has received on the downstream.

DS Bytes

Number of byte this CM has received on the downstream.


Related Commands

Command
Description

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem access-group

Displays the access groups for the CMs on a particular cable interface.

show cable modem calls

Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.

show cable modem classifiers

Displays information about the classifiers for a particular CM.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem cpe

Displays the CPE devices accessing the cable interface through a particular CM.

show cable modem qos

Displays quality of service (QoS) and service flow information for a particular CM.

show cable modem registered

Displays a list of the CMs that are marked as registered with the Cisco CMTS.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show cable modem unregistered

Displays a list of the CMs that are marked as unregistered with the Cisco CMTS.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem cpe

To display the customer premise equipment (CPE) devices accessing the cable interface through a particular cable modem (CM), use the show cable modem cpe command in privileged EXEC mode.

show cable modem {ip-address | mac-address | name fqdn} cpe

Syntax Description

ip-address

Displays the CPE devices for the CM with the specified IPv4 or IPv6 address.

mac-address

Displays the CPE devices for the CM with the specified MAC address.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

11.3XA

This command was introduced.

12.1(4)CX and 12.2(4)BC1

The command was simplified to display only the IP and MAC addresses for the CPE devices.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.


Usage Guidelines

This command lists the CPE devices that are accessing the cable network through a particular CM. You can identify the CM either by its IP address or by its MAC address.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


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.


Examples

The following example shows sample output for the show cable modem cpe command, listing the CPE devices by their MAC and IP addresses:

Router# show cable modem 0019.474a.c14a cpe     
IP address        MAC address      Dual IP
50.3.37.3        0005.0052.2c1d      Y

Table 22 describes the significant fields shown in the display.

Table 13 show cable modem cpe Field Descriptions 

Field
Description

IP Address

IP address acquired by the CPE.

MAC Address

MAC address of the CPE.

Dual IP

Dual IP flag. Identifies whether or not ("Y" or "N") the CPE supports both IPv4 and IPv6 addressing.


Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem calls

Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.

show cable modem classifiers

Displays information about the classifiers for a particular CM.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem errors

Displays error statistics for one or more CMs.

show cable modem flap

Displays flap list statistics for one or more cable modems.

show cable modem maintenance

Displays station maintenance (SM) error statistics for one or more cable modems.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modulation-profile

Displays modulation profile group information.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem docsis device-class

To display the DOCSIS device-class information for cable modems (CMs) on all or specified cable interfaces and upstreams, use the show cable modem docsis device-class command in privileged EXEC configuration mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem docsis device-class [summary [cable slot/subslot [cable slot/subslot] [upstream port1 port2]]] [total]

show cable modem cable slot/subslot docsis version summary

Cisco uBR10012 Router

show cable modem docsis device-class [summary [cable slot/subslot/port [cable slot/subslot/port] [upstream port1 port2]]] [total]

show cable modem cable slot/subslot/port docsis version summary

Syntax Description

summary

(Optional) Displays a summary of DOCSIS device class information for CMs on all or specified cable interfaces on the CMTS router.

cable slot/subslot [cable slot/subslot]

(Optional) Specifies a single cable interface, or a range of cable interfaces on a Cisco uBR7100 or Cisco uBR7200 series router, whose CMs you want to display information about, where:

slot—Specifies the chassis slot number of the cable interface line card.

subslot—Specifies the downstream port number.

Valid values for these arguments are dependent on your CMTS router and cable interface line card. Refer to the hardware documentation for your router chassis and cable interface line card for supported slot and port numbering.

cable slot/subslot/port [cable slot/subslot/port]

(Optional) Specifies a single cable interface, or a range of cable interfaces on a Cisco uBR10012 router, whose CMs you want to display information about, where:

slotSpecifies the chassis slot number of the cable interface line card. Valid slots are 5 to 8.

subslot—Specifies the secondary slot number of the cable interface line card. Valid subslots are 0 or 1.

port—Specifies the downstream port number. Valid ports are 0 to 4, depending on the cable interface line card.

upstream port1 port2

(Optional) Specifies a specific upstream port, or a range of upstream ports on the specified cable interface(s), whose CMs you want to display information about, where:

port1—Specify only port1 if you want to display information about a single upstream. When used with the port2 argument, specifies the beginning of a range of upstream ports, and port1 must be a lower-numbered port than port2.

port2—Specifies the end of a range of upstream ports, and port2 must be a higher-numbered port than port1.

total

(Optional) Displays a total of DOCSIS device-class information for the CMs connected to all interfaces, or to the specified cable interfaces.


Command Default

The default form of the command (show cable modem docsis device-class without any options) provides DOCSIS device class information for all CMs on the CMTS router.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.3(21)BC

This command was introduced.

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

This command displays a summary of DOCSIS device-class information for all CMs for a single cable interface, or for a range of cable interfaces, and optionally specified upstreams on those cable interfaces.

Examples

The following example shows typical output for the default form of the show cable modem docsis device-class command on a Cisco uBR100012 router:

Router# show cable modem docsis device-class
MAC Address    I/F       MAC            Prim  Reg      Device Class     Reg 
                         State          Sid   Ver  -------------------- Priv
0030.80bc.22b9 C3/0/U0   online(pt)     1     1.0  CM                   BPI 
0000.cadb.04b2 C3/0/U0   online(pt)     2     1.1  eCM eMTA             BPI+
0000.cadb.0512 C3/0/U0   online(pt)     3     1.1  eCM eMTA eSTB        BPI+
0003.e38f.f5c7 C3/0/U1   online(pt)     4     1.0  CM                   BPI 
0000.cadb.0bae C3/0/U1   online(pt)     5     1.1  eCM           ePS    BPI+
0010.7b6b.77ed C3/0/U2   online         6     1.0  CM                       
0000.cadb.0356 C4/0/U0   online(pt)     1     1.1  eCM eMTA             BPI+
0000.cadb.02a6 C4/0/U0   init(d)        2     n/a  <unavailable>                 
0000.cadb.2f7a C4/0/U1   online(pt)     3     2.0  eCM      eSTB        BPI+
0000.cadb.2952 C4/0/U2   online(pt)     4     1.1  eCM      eSTB ePS    BPI+
0000.cadb.0236 C4/0/U2   init(d)        6     n/a  <unavailable>                 
0003.e3a6.850d C4/0/U3   online(pt)     7     1.1  eCM eMTA      ePS    BPI+ 
0003.e3a6.85ad C4/0/U3   online(pt)     8     1.0  CM                   BPI

The following example shows sample output for the show cable modem docsis device-class command for a particular cable interface, in chassis slot 3 and subslot 0:

Router# show cable modem cable3/0 docsis device-class
MAC Address    I/F       MAC            Prim  Reg      Device Class     Reg 
                         State          Sid   Ver  -------------------- Priv
0030.80bc.22b9 C3/0/U0   online(pt)     1     1.0  CM                   BPI 
0000.cadb.04b2 C3/0/U0   online(pt)     2     1.1  eCM eMTA             BPI+
0000.cadb.0512 C3/0/U0   online(pt)     3     1.1  eCM eMTA eSTB        BPI+
0003.e38f.f5c7 C3/0/U1   online(pt)     4     1.0  CM                   BPI 
0000.cadb.0bae C3/0/U1   online(pt)     5     1.1  eCM           ePS    BPI+
0010.7b6b.77ed C3/0/U2   online         6     1.0  CM                       

Table 14 show cable modem docsis device-class Field Descriptions

Field
Description

MAC Address

The MAC address of the CM.

I/F

The cable interface line card providing the upstream for this CM.

MAC State

The current state of the MAC layer.

Prim Sid

The primary SID assigned to this CM.

Reg Ver

Displays the maximum supported version of DOCSIS that the CM supports. The possible values are: DOCSIS 1.0, DOCSIS 1.1, DOCSIS 2.0, and DOCSIS 3.0. Shows "n/a" if the modem is not online.

Device Class

Displays the device-class information for the PacketCable device. The modem can report its device-class type during registration. The possible values are:

CM or eCM—A standalone cable modem or embedded CM.

ePS—Embedded Portal Services

eMTA—Embedded Multimedia Terminal Adapter

eSTB—Embedded Set Top Box

unavailable—The CM has not reported its device class.

Reg Priv

Indicates whether Baseline Privacy Interface (BPI) or BPI Plus (BPI+) encryption is enabled for the CM.


Examples for Summary and Total Options

The following example shows the corresponding display for the show cable modem docsis device-class total command:

Router# show cable modem docsis device-class total  
              Online  unrep CM    eCM   eMTA  eSTB  ePS
Total:        13      2     4     7     4     3     3     

The following example shows sample output for the show cable modem docsis device-class summary form of the command on a Cisco CMTS router:

Router# show cable modem docsis device-class summary
                          DOCSIS Device Class
                      ----------------------------
Interface     Online  unrep CM    eCM   eMTA  eSTB  ePS
Cable3/0/U0   3       0     1     2     2     1     0     
Cable3/0/U1   2       0     1     1     0     0     1     
Cable3/0/U2   1       0     1     0     0     0     0     
Cable4/0/U0   2       1     0     1     1     0     0     
Cable4/0/U1   1       0     0     1     0     1     0     
Cable4/0/U2   2       1     0     1     0     1     1     
Cable4/0/U3   2       0     1     1     1     0     1     

The following example shows sample output for the show cable modem docsis device-class summary command with the total option on a Cisco CMTS router:

Router# show cable modem docsis device-class summary total
                          DOCSIS Device Class
                      ----------------------------
Interface     Online  unrep CM    eCM   eMTA  eSTB  ePS
Cable3/0/U0   3       0     1     2     2     1     0     
Cable3/0/U1   2       0     1     1     0     0     1     
Cable3/0/U2   1       0     1     0     0     0     0     
Cable4/0/U0   2       1     0     1     1     0     0     
Cable4/0/U1   1       0     0     1     0     1     0     
Cable4/0/U2   2       1     0     1     0     1     1     
Cable4/0/U3   2       0     1     1     1     0     1     
Total:        13      2     4     7     4     3     3     

The following example shows sample output for the show cable modem docsis device-class summary total command for all enabled upstreams on a specific cable interface line card on a Cisco CMTS router:

Router# show cable modem docsis device-class summary cable 3/0 total
                          DOCSIS Device Class
                      ----------------------------
Interface     Online  unrep CM    eCM   eMTA  eSTB  ePS
Cable3/0/U0   3       0     1     2     2     1     0     
Cable3/0/U1   2       0     1     1     0     0     1     
Cable3/0/U2   1       0     1     0     0     0     0     
Total:        6       0     3     3     2     1     1     

The following example shows sample output for the show cable modem docsis device-class summary total command for a range of interfaces on a Cisco CMTS router:

Router# show cable modem docsis device-class summary cable 3/0 cable 4/0 total
                          DOCSIS Device Class
                      ----------------------------
Interface     Online  unrep CM    eCM   eMTA  eSTB  ePS
Cable3/0/U0   3       0     1     2     2     1     0     
Cable3/0/U1   2       0     1     1     0     0     1     
Cable3/0/U2   1       0     1     0     0     0     0     
Cable4/0/U0   2       1     0     1     1     0     0     
Cable4/0/U1   1       0     0     1     0     1     0     
Cable4/0/U2   2       1     0     1     0     1     1     
Cable4/0/U3   2       0     1     1     1     0     1     
Total:        13      2     4     7     4     3     3     

The following example shows sample output for the show cable modem docsis device-class summary total command for a range of interfaces and upstreams on a CMTS router:

Router# show cable modem docsis device-class summary cable 3/0 cable 4/0 upstream 0 2 
total
                          DOCSIS Device Class
                      ----------------------------
Interface     Online  unrep CM    eCM   eMTA  eSTB  ePS
Cable3/0/U0   3       0     1     2     2     1     0     
Cable3/0/U1   2       0     1     1     0     0     1     
Cable3/0/U2   1       0     1     0     0     0     0     
Cable4/0/U0   2       1     0     1     1     0     0     
Cable4/0/U1   1       0     0     1     0     1     0     
Cable4/0/U2   2       1     0     1     0     1     1     
Total:        11      2     3     6     3     3     2     

The following example shows sample output for the show cable modem docsis device-class summary total command for a range of upstreams on an interface:

Router# show cable modem docsis device-class summary cable3/0 upstream 0 1 total        
                          DOCSIS Device Class
                      ----------------------------
Interface     Online  unrep CM    eCM   eMTA  eSTB  ePS
Cable3/0/U0   3       0     1     2     2     1     0     
Cable3/0/U1   2       0     1     1     0     0     1     
Total:        5       0     2     3     2     1     1     

The following example shows sample output for the show cable modem docsis device-class summary command for all enabled upstreams on a specific cable interface line card:

Router# show cable modem cable3/0 docsis device-class summary
                          DOCSIS Device Class
                      ----------------------------
Interface     Online  unrep CM    eCM   eMTA  eSTB  ePS
Cable3/0/U0   3       0     1     2     2     1     0     
Cable3/0/U1   2       0     1     1     0     0     1     
Cable3/0/U2   1       0     1     0     0     0     0     
Total:        6       0     3     3     2     1     1     

Table 15 show cable modem docsis device-class summary Field Descriptions

Field
Description

Interface

Name of the cable interface and associated upstreams on the Cisco CMTS router.

Online

Total number of CMs currently online on this cable interface.

unrep

Total number of CMs on this interface for which the device-class information is unreported or unavailable.

CM

Total number of CMs on this interface that have a reported device class as a standalone cable modem.

eCM

Total number of CMs on this interface that have reported the device class as an embedded cable modem.

eMTA

Total number of CMs on this interface that have reported the device class as an embedded multimedia terminal adapter.

eSTB

Total number of CMs on this interface that have reported the device class as an embedded set-top box.

ePS

Total number of CMs on this interface that have reported the device class as embedded portal services.

Total

The total number of all CMs reported online and for a given DOCSIS device class across all cable interfaces on the Cisco CMTS router.


Related Commands

Command
Description

show cable modem docsis version

Displays the DOCSIS version information for CMs on one or more cable interfaces and upstreams.


show cable modem docsis version

To display the DOCSIS version information for cable modems (CMs) on one or more cable interfaces and upstreams, use the show cable modem docsis version command in privileged EXEC configuration mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem docsis version [summary [cable {slot/port | slot/cable-interface-index} [cable {slot/port | slot/cable-interface-index}] [upstream port1 port2 [logical-channel-index]]]] [total]

show cable modem cable {slot/port | slot/cable-interface-index} docsis version summary

Cisco uBR10012 Router

show cable modem docsis version [summary [cable {slot/subslot/port | slot/subslot/cable-interface-index} [cable {slot/subslot/port | slot/subslot/cable-interface-index}] [upstream port1 port2 [logical-channel-index]]]] [total]

show cable modem cable {slot/subslot/port | slot/subslot/cable-interface-index} docsis version summary

Syntax Description

summary

(Optional) Displays a summary of DOCSIS device class information for CMs on all or specified cable interfaces on the CMTS router.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port1 port2

(Optional) Specifies a specific upstream port, or a range of upstream ports on the specified cable interface(s), whose cable modems you want to display information about, where:

port1—Specify only port1 if you want to display information about a single upstream. When used with the port2 argument, specifies the beginning of a range of upstream ports, and port1 must be a lower-numbered port than port2.

port2—Specifies the end of a range of upstream ports, and port2 must be a higher-numbered port than port1.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

total

(Optional) Displays a total of DOCSIS device-class information for the CMs connected to all interfaces, or to the specified cable interfaces.

docsis version summary

Displays the DOCSIS version information for cable modems on one or more cable interfaces and upstreams.


Command Default

The default form of the command (show cable modem docsis version without any options) provides DOCSIS version information for all CMs on the CMTS router.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.3(23)BC

This command was introduced.

12.2(33)SCB

This command was integrated into Cisco IOS Release 12.2(33)SCB.

12.3(23)BC7

The output for the show cable modem docsis version summary total forms of the command were modified.

12.2(33)SCD2

This command was modified. The command output was modified to display the cable modems that are in upstream and downstream partial service mode.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

This command displays a summary of DOCSIS version information for all CMs for a single cable interface or upstream, or for a range of cable interfaces or upstreams.

Examples

Examples: show cable modem docsis version Command

The following example shows typical output for the default form of the show cable modem docsis version command on a Cisco uBR10012 router:

Router# show cable modem docsis version
MAC Address    I/F       MAC            Prim  Reg QoS  US Phy DS Chl
                         State          Sid   Ver Prov Mode   Mode
0018.6852.800a C5/1/0/U3 w-online(pt)   166   2.0 1.1  tdma   WB    
0018.6852.7f92 C5/1/0/U1 w-online(pt)   167   2.0 1.1  tdma   WB    
0014.bfbe.3ea6 C5/1/0/U0 w-online(pt)   168   2.0 1.1  tdma   WB    
0018.6852.8022 C5/1/0/U2 w-online(pt)   169   2.0 1.1  tdma   WB    
0018.6852.7fa0 C5/1/0/U0 w-online(pt)   170   2.0 1.1  tdma   WB    
0018.6852.8016 C5/1/0/U3 w-online(pt)   171   2.0 1.1  tdma   WB    
0018.6852.8008 C5/1/0/U2 w-online(pt)   172   2.0 1.1  tdma   WB    
0018.6852.800e C5/1/0/U1 w-online(pt)   173   2.0 1.1  tdma   WB    
0018.6852.8000 C5/1/0/U1 w-online(pt)   174   2.0 1.1  tdma   WB    
0002.8a8c.ed06 C5/1/1/U0 online(pt)     79    2.0 1.1  tdma   NB    
0018.6852.801c C5/1/1/U0 w-online(pt)   80    2.0 1.1  tdma   WB    
0018.6852.8006 C5/1/1/U0 w-online(pt)   81    2.0 1.1  tdma   WB    
00e0.6f2c.6a4e C5/1/1/U0 online(pt)     82    1.1 1.1  tdma   NB    
0011.ae02.a63c C5/1/3/U0 online(pt)     37    2.0 1.1  tdma   NB    
0011.ae00.c514 C5/1/3/U0 online(pt)     38    2.0 1.1  tdma   NB    

The following example shows sample output for the show cable modem docsis version command for a particular cable interface on a Cisco uBR10012 router:

Router# show cable modem cable 5/1/0 docsis version        
MAC Address    I/F       MAC            Prim  Reg QoS  US Phy DS Chl
                         State          Sid   Ver Prov Mode   Mode
0018.6852.800a C5/1/0/U3 w-online(pt)   166   2.0 1.1  tdma   WB    
0018.6852.7f92 C5/1/0/U1 w-online(pt)   167   2.0 1.1  tdma   WB    
0014.bfbe.3ea6 C5/1/0/U0 w-online(pt)   168   2.0 1.1  tdma   WB    
0018.6852.8022 C5/1/0/U2 w-online(pt)   169   2.0 1.1  tdma   WB    
0018.6852.7fa0 C5/1/0/U0 w-online(pt)   170   2.0 1.1  tdma   WB    
0018.6852.8016 C5/1/0/U3 w-online(pt)   171   2.0 1.1  tdma   WB    
0018.6852.8008 C5/1/0/U2 w-online(pt)   172   2.0 1.1  tdma   WB    
0018.6852.800e C5/1/0/U1 w-online(pt)   173   2.0 1.1  tdma   WB    
0018.6852.8000 C5/1/0/U1 w-online(pt)   174   2.0 1.1  tdma   WB    

Table 16 describes the significant fields shown in the display.

Table 16 show cable modem docsis version Field Descriptions

Field
Description

MAC Address

The MAC address of the CM.

I/F

The cable interface line card providing the upstream for this CM.

MAC State

The current state of the MAC layer.

Prim Sid

The primary SID assigned to this CM.

Reg Ver

Displays the maximum supported version of DOCSIS that the CM supports. The possible values are: 1.0, 1.1, 2.0, and 3.0. Shows "n/a" if the modem is not online.

QoS Prov

Displays the version of DOCSIS that the CM currently is provisioned and registered for. The possible values are: 1.0, 1.1, 2.0, and 3.0. Shows "n/a" if the modem is not online.

US Phy Mode

Displays the DOCSIS operating mode for the CM, with the following possible values:

tdma—DOCSIS 1.X, Time Division Multiple Access (TDMA)-only mode

atdma—DOCSIS 2.0 Advanced Time Division Multiple Access (A-TDMA) mode

scdma—DOCSIS 2.0 Synchronous Code Division Multiple Access (SCDMA) mode

Note This field is the same as that returned by the docsIfCmtsCmStatusModulationType object in the DOCS-IF-MIB.

DS Chl Mode

Displays the downstream channel mode for the CM, with the following possible values:

NB—Narrowband

WB—Wideband


Examples: show cable modem version docsis version total Command

The following example shows the corresponding display for the show cable modem docsis version total command:

Router# show cable modem docsis version total
Total Registered CMs:   15
Total Unregistered CMs: 0
Total DOCSIS 3.0 Operating/Capable/Registered CMs: 0/0/0
Total DOCSIS 2.0 Operating/Capable/Registered CMs: 0/14/14
Total DOCSIS 1.1 Operating/Capable/Registered CMs: 15/15/1
Total DOCSIS 1.0 Operating/Capable/Registered CMs: 0/15/0
Total v1.1 US QoS operating CMs: 15
Total V1.0 US QoS operating CMs: 0
Total Wide Band US operating CMs: 0
Total scdma US Phy operating CMs: 0
Total atdma US Phy operating CMs: 0
Total tdma US Phy operating CMs:  15
Total Wide Band DS operating CMs:   11
Total Narrow Band DS operating CMs: 4

Beginning in Cisco IOS Release 12.2(33)SCD2, the output of the show cable modem docsis version total command was modified to display the cable modems that are in partial service mode as shown in the following example:

Router# show cable modem docsis version total
Total Registered CMs:   35
Total Unregistered CMs: 1
Total DOCSIS 3.0 Operating/Capable/Registered CMs: 21/22/22
Total DOCSIS 2.0 Operating/Capable/Registered CMs: 0/34/12
Total DOCSIS 1.1 Operating/Capable/Registered CMs: 35/35/1
Total DOCSIS 1.0 Operating/Capable/Registered CMs: 0/35/0
Total v1.1 US QoS operating CMs: 35
Total V1.0 US QoS operating CMs: 0
Total Wide Band US operating CMs: 21
Total Wide Band US partial-mode CMs: 9
Total scdma US Phy operating CMs: 0
Total atdma US Phy operating CMs: 0
Total tdma US Phy operating CMs:  14
Total Wide Band DS operating CMs:   22
Total Wide Band DS partial-mode CMs: 12
Total Narrow Band DS operating CMs: 13

Table 17 describes the fields shown in the show cable modem docsis version total command display.

Table 17 show cable modem docsis version total Field Descriptions

Field
Description

Total Registered CMs

Total number of cable modems currently online in a CMTS router.

Total Unregistered CMs

Total number of cable modems that are either offline and not currently communicating with the CMTS router, or that are attempting to come online but are not yet registered.

Total DOCSIS x.y Operating/Capable/Registered CMs: a/b/c

Total number of cable modems (in a/b/c format) for the specified DOCSIS version (x.y) that have the following status:

Operating—Total number (a) of CMs currently operating in the specified DOCSIS version.

Capable—Total number (b) of CMs that can operate in the specified DOCSIS version, but might not be operating in that version.

Registered—Total number (c) of CMs that are currently registered in the specified DOCSIS version.

Total Vx.y US QoS operating CMs

Total number of cable modems whose upstreams are currently operating in a specified DOCSIS version (x.y) quality of service (QoS).

Total Wide Band US operating CMs

Total number of cable modems with upstreams currently operating in wideband channel mode.

Total Wide Band US partial-mode CMs

Total number of cable modems with upstreams currently operating in partial wideband channel mode.

Total mode US Phy operating CMs

Total number of cable modems with upstreams currently operating in a particular wideband channel mode, where mode is:

scdma—DOCSIS 2.0 Synchronous Code Division Multiple Access (SCDMA) mode

atdma—DOCSIS 2.0 Advanced Time Division Multiple Access (A-TDMA) mode

tdma—DOCSIS 1.X, Time Division Multiple Access (TDMA) mode

Total Wide Band DS operating CMs

Total number of cable modems with downstreams operating in wideband channel mode.

Total Wide Band DS partial-mode CMs

Total number of cable modems with downstreams operating in partial wideband channel mode.

Total Narrow Band DS operating CMs

Total number of cable modems with downstreams operating in narrowband channel mode.


Examples: show cable modem docsis version summary Command

The following example shows typical output for the default form of the show cable modem docsis version summary command on a Cisco uBR10012 router:

Router# show cable modem docsis version summary
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C5/1/0/U0 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U1 3      0    3    0    0     3    0     0    0    0    3     3    0    
C5/1/0/U2 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U3 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/1/U0 4      0    3    1    0     4    0     0    0    0    4     2    2    
C5/1/3/U0 2      0    2    0    0     2    0     0    0    0    2     0    2    

Beginning in Cisco IOS Release 12.2(33)SCD2, the output of the show cable modem docsis version summary command was modified to display the cable modems that are in full or partial service mode as shown in the following example:

Router# show cable modem docsis version summary
                                Cable Modem DOCSIS Version Summary
                  DOCSIS Registered   US QoS     US Phy Mode    DOCSIS Mode
                 ------------------- --------- -------------- ----------------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 scdm atdm tdma UP  WB   WP  NB
C7/0/0/UB 12     12   0    0    0    12   0    0    0    0    9   12   12  0
C7/0/0/U0 2      0    2    0    0    2    0    0    0    2    0   0    0   2
C7/0/0/U1 1      0    1    0    0    1    0    0    0    1    0   0    0   1
C7/0/0/U3 4      0    4    0    0    4    0    0    0    4    0   0    0   4
C8/0/0/UB 9      9    0    0    0    9    0    0    0    0    0   9    0   0
C8/0/0/U0 1      1    0    0    0    1    0    0    0    1    0   1    0   0
C8/0/0/U1 5      0    4    1    0    5    0    0    0    5    0   0    0   5
C8/0/0/U3 1      0    1    0    0    1    0    0    0    1    0   0    0   1

The following example shows typical output for the show cable modem docsis version summary command with the total option on a Cisco uBR10012 router:

Router# show cable modem docsis version summary total
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C5/1/0/U0 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U1 3      0    3    0    0     3    0     0    0    0    3     3    0    
C5/1/0/U2 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U3 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/1/U0 4      0    3    1    0     4    0     0    0    0    4     2    2    
C5/1/3/U0 2      0    2    0    0     2    0     0    0    0    2     0    2    
Total:    15     0    14   1    0     15   0     0    0    0    15    11   4    

Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem docsis version summary total command was modified as shown in the following example:

Router# show cable modem docsis version summary total
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C5/1/0/U0 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U1 3      0    3    0    0     3    0     0    0    0    3     3    0    
C5/1/0/U2 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U3 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/1/U0 4      0    3    1    0     4    0     0    0    0    4     2    2    
C5/1/3/U0 2      0    2    0    0     2    0     0    0    0    2     0    2    
-----------------------------------------------------------------------------
Total:    15     v3.0: 0              v1.1: 15     WB  : 0            WB: 11
                 v2.0: 14             v1.0: 0      scdm: 0            NB: 4
                 v1.1: 1                           atdm: 0
                 v1.0: 0                           tdma: 15
-----------------------------------------------------------------------------

Beginning in Cisco IOS Release 12.2(33)SCD2, the output of the show cable modem docsis version summary total command was modified to display the cable modems that are in full or partial service mode as shown in the following example:

Router# show cable modem docsis version summary total
                                Cable Modem DOCSIS Version Summary
                  DOCSIS Registered   US QoS     US Phy Mode    DOCSIS Mode
                 ------------------- --------- -------------- ----------------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 scdm atdm tdma UP  WB   WP  NB
C7/0/0/UB 12     12   0    0    0    12   0    0    0    0    9   12   12  0
C7/0/0/U0 2      0    2    0    0    2    0    0    0    2    0   0    0   2
C7/0/0/U1 1      0    1    0    0    1    0    0    0    1    0   0    0   1
C7/0/0/U3 4      0    4    0    0    4    0    0    0    4    0   0    0   4
C8/0/0/UB 9      9    0    0    0    9    0    0    0    0    0   9    0   0
C8/0/0/U0 1      1    0    0    0    1    0    0    0    1    0   1    0   0
C8/0/0/U1 5      0    4    1    0    5    0    0    0    5    0   0    0   5
C8/0/0/U3 1      0    1    0    0    1    0    0    0    1    0   0    0   1
-----------------------------------------------------------------------------
Total:    35     v3.0: 22             v1.1: 35     UB  : 21           WB: 22
                                                   UP  : 9            WP: 12
                 v2.0: 12             v1.0: 0      scdm: 0            NB: 13
                 v1.1: 1                           atdm: 0
                 v1.0: 0                           tdma: 14
-----------------------------------------------------------------------------

Examples: show cable modem docsis version summary cable total Command

The following example shows sample output for the show cable modem docsis version summary cable total command for all enabled upstreams on a specific cable interface line card on a Cisco uBR10012 router:

Router# show cable modem docsis version summary cable 5/1/0 total
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C5/1/0/U0 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U1 3      0    3    0    0     3    0     0    0    0    3     3    0    
C5/1/0/U2 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U3 2      0    2    0    0     2    0     0    0    0    2     2    0    
Total:    9      0    9    0    0     9    0     0    0    0    9     9    0    

Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem docsis version summary cable total command was modified as shown in the following example:

Router# show cable modem docsis version summary cable 5/1/0 total
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C5/1/0/U0 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U1 3      0    3    0    0     3    0     0    0    0    3     3    0    
C5/1/0/U2 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U3 2      0    2    0    0     2    0     0    0    0    2     2    0    
-----------------------------------------------------------------------------
Total:    9      v3.0: 0              v1.1: 9      WB  : 0            WB: 9
                 v2.0: 9              v1.0: 0      scdm: 0            NB: 0
                 v1.1: 0                           atdm: 0 
                 v1.0: 0                           tdma: 9
-----------------------------------------------------------------------------

The following example shows sample output for the show cable modem docsis version summary cable total command for a range of interfaces on the Cisco uBR10012 router:

Router# show cable modem docsis version summary cable 5/1/0 cable 5/1/3 total
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C5/1/0/U0 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U1 3      0    3    0    0     3    0     0    0    0    3     3    0    
C5/1/0/U2 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U3 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/1/U0 4      0    3    1    0     4    0     0    0    0    4     2    2    
C5/1/3/U0 2      0    2    0    0     2    0     0    0    0    2     0    2    
Total:    15     0    14   1    0     15   0     0    0    0    15    11   4    

Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem docsis version summary cable total command for a range of interfaces was modified as shown in the following example:

Router# show cable modem docsis version summary cable 5/1/0 cable 5/1/3 total
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C5/1/0/U0 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U1 3      0    3    0    0     3    0     0    0    0    3     3    0    
C5/1/0/U2 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U3 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/1/U0 4      0    3    1    0     4    0     0    0    0    4     2    2    
C5/1/3/U0 2      0    2    0    0     2    0     0    0    0    2     0    2    
-----------------------------------------------------------------------------
Total:    15     v3.0: 0              v1.1: 15     WB  : 0            WB: 11
                 v2.0: 14             v1.0: 0      scdm: 0            NB: 4
                 v1.1: 1                           atdm: 0
                 v1.0: 0                           tdma: 15
-----------------------------------------------------------------------------

The following example shows sample output for the show cable modem docsis version summary cable upstream total command for a range of interfaces and upstreams on the Cisco uBR10012 router:

Router# show cable modem docsis version summary cable 5/1/0 cable 5/1/3 upstream 0 3 total
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C5/1/0/U0 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U1 3      0    3    0    0     3    0     0    0    0    3     3    0    
C5/1/0/U2 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U3 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/1/U0 4      0    3    1    0     4    0     0    0    0    4     2    2    
C5/1/3/U0 2      0    2    0    0     2    0     0    0    0    2     0    2    
Total:    15     0    14   1    0     15   0     0    0    0    15    11   4    

Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem docsis version summary cable upstream total command for a range of interfaces and upstreams was modified as shown in the following example:

Router# show cable modem docsis version summary cable 5/1/0 cable 5/1/3 upstream 0 3 total
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C5/1/0/U0 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U1 3      0    3    0    0     3    0     0    0    0    3     3    0    
C5/1/0/U2 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U3 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/1/U0 4      0    3    1    0     4    0     0    0    0    4     2    2    
C5/1/3/U0 2      0    2    0    0     2    0     0    0    0    2     0    2    
-----------------------------------------------------------------------------
Total:    15     v3.0: 0              v1.1: 15     WB  : 0            WB: 11
                 v2.0: 14             v1.0: 0      scdm: 0            NB: 4
                 v1.1: 1                           atdm: 0
                 v1.0: 0                           tdma: 15
-----------------------------------------------------------------------------

The following example shows sample output for the show cable modem docsis version summary cable upstream total command for a range of upstreams in an interface on the Cisco uBR10012 router:

Router# show cable modem docsis version summary cable 5/1/0 upstream 0 3 total
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C5/1/0/U0 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U1 3      0    3    0    0     3    0     0    0    0    3     3    0    
C5/1/0/U2 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U3 2      0    2    0    0     2    0     0    0    0    2     2    0    
Total:    9      0    9    0    0     9    0     0    0    0    9     9    0    

Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem docsis version summary cable upstream total command for a range of upstreams was modified as shown in the following example:

Router# show cable modem docsis version summary cable 5/1/0 upstream 0 3 total
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C5/1/0/U0 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U1 3      0    3    0    0     3    0     0    0    0    3     3    0    
C5/1/0/U2 2      0    2    0    0     2    0     0    0    0    2     2    0    
C5/1/0/U3 2      0    2    0    0     2    0     0    0    0    2     2    0   
-----------------------------------------------------------------------------
Total:    9      v3.0: 0              v1.1: 9      WB  : 0            WB: 9
                 v2.0: 9              v1.0: 0      scdm: 0            NB: 0
                 v1.1: 0                           atdm: 0
                 v1.0: 0                           tdma: 9
----------------------------------------------------------------------------- 

The following example shows sample output for the show cable modem cable docsis version summary command for all enabled upstreams on a specific cable interface line card on a Cisco uBR10012 router:

Router# show cable modem cable 8/0/1 docsis version summary
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C8/0/1/U0 4      0    2    1    1     0    4     0    0    0    4     0    4

Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem cable docsis version summary command for a range of upstreams was modified as shown in the following example:

Router# show cable modem cable 8/0/1 docsis version summary
                              Cable Modem DOCSIS Version Summary
                  DOCSIS Registered    US QoS        US Phy Mode      DS Mode
                 -------------------  ---------  -------------------  -------
Interface Online v3.0 v2.0 v1.1 v1.0  v1.1 v1.0  WB   scdm atdm tdma  WB   NB
C8/0/1/U0 4      0    2    1    1     0    4     0    0    0    4     0    4

Table 18 describes the significant fields shown in the display.

Table 18 show cable modem docsis version summary Field Descriptions

Field
Description

Interface

The cable interface line card providing the upstream for this cable modem.

Online

Total number of cable modems currently online on this cable interface.

DOCSIS Registered

Total number of cable modems registered on this cable interface with the specified DOCSIS version (x.y) capabilities.

US QoS

Total number of cable modems whose upstreams are currently operating in a specified DOCSIS version (x.y) quality of service (QoS).

US Phy Mode

Total number of cable modems on this cable interface with upstreams currently operating in a particular wideband channel mode, where:

WB—Total number of upstreams on this cable interface operating in any wideband channel mode.

scdma—Total number of upstreams on this cable interface operating in DOCSIS 2.0 Synchronous Code Division Multiple Access (SCDMA) mode.

atdma—Total number of upstreams on this cable interface operating in DOCSIS 2.0 Advanced Time Division Multiple Access (A-TDMA) mode.

tdma—Total number of upstreams on this cable interface operating in DOCSIS 1.X, Time Division Multiple Access (TDMA) mode.

DS Mode

Total number of cable modems on this cable interface whose downstreams are operating in the following modes:

WB—Total number of downstreams on this cable interface operating in wideband channel mode.

NB—Total number of downstreams on this cable interface operating in narrowband channel mode.

DOCSIS Mode

UP—Total number of cable modems in upstream bonding partial service mode (p).

WB—Total number of cable modems in downstream bonding fully-operational mode (w-online).

WP—Total number of cable modems in downstream bonding partial service mode (p-online).

NB—Total number of cable modems in narrowband online mode (online).


Related Commands

Command
Description

show cable modem docsis device-class

Displays the DOCSIS device-class information for cable modems (CMs) on all or specified cable interfaces and upstreams.

show cable modem partial-mode

Displays information about the cable modems that are in upstream and downstream partial service mode.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.


show cable modem domain-name

To update the cable-specific Domain Name System (DNS) cache and display the domain name for specified cable modems (CMs) and customer premise equipment (CPE) behind a CM on a Cisco CMTS router, use the show cable modem domain-name command in privileged EXEC mode.

Cisco uBR7246VXR Router and Cisco uBR7225VXR Router

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] domain-name

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] domain-name

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCA

This command was introduced.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

Use the show cable modem domain-name command without any options to initiate an update to the cable-specific DNS cache on the CMTS router and to enable use of domain names in other CMTS router cable modem commands that support a name option.


Note In Cisco IOS Release 12.2(33)SCA, although the show cable modem domain-name command accepts an IPv4 address format for a CM, DNS for IPv4-managed cable devices is not supported.


Examples

The following example shows sample output for all CMs and CPE behind a CM for the show cable modem domain-name command, listing the devices by their MAC and IP addresses and displaying the associated domain name:

Router# show cable modem domain-name
MAC Address    IP Address                              Domain Name
0018.6835.27b3 10.3.37.76
0019.474a.c14a 2001:0DB8:3800:809:A896:1431:75EA:5EA1  cisco-test-cm1.cisco.com
0007.0e03.6851 10.3.37.36
0007.0e01.b085 10.3.37.34
0018.6835.27aa 2001:0DB8:3800:809:E97D:2986:9F37:FFE   cisco-test-cm2.cisco.com

Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem calls

Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem flap

Displays flap list statistics for one or more cable modems.

show cable modem maintenance

Displays station maintenance (SM) error statistics for one or more cable modems.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show cable modulation-profile

Displays modulation profile group information.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem errors

To display packet header error statistics for one or more CMs, use the show cable modem errors command in privileged EXEC mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] errors

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] errors

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using this specific upstream. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports on the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

errors

Displays packet header error statistics for one or more CMs.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.1(4)CX, 12.2(1)XF, and 12.2(4)BC1

This command was introduced for the Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 router.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

This command displays packet header error information for all CMs, for all CMs attached to a specific CMTS cable interface, or for a particular CM, as identified by its IP address or MAC address.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


Tip In Cisco IOS Release 12.2(15)BC1 and later releases, use the clear cable modem flap-counters command to clear these counters.



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.


Examples

The following example shows sample output for the show cable modem errors command for all CMs on a particular cable interface.

Router# show cable modem c8/1/0 errors 
MAC Address    I/F          CRC        HCS
0050.7366.1243 C8/1/0/U1    0          1 
0002.b970.0027 C8/1/0/U4    0          0 
0006.5314.858d C8/1/0/U4    8          3 
Router# 

Table 19 describes the fields shown in the show cable modem errors displays:

Table 19 Descriptions for the show cable modem errors Fields 

Field
Description

MAC Address

The MAC address for the CM.

I/F

The cable interface line card, including the upstream, for this CM.

CRC

Number of times the CMTS upstream receiver flagged a packet with a cyclic redundancy check (CRC) error from this CM. CRC errors usually indicate downstream signal interruption or interference noise on a plant. Occasional CRC errors can always be expected, but a high number of CRC errors could indicate plant problems such as intermittent upstream problems, laster clipping, common-path distortion, or impulsive noise or interference.

HCS

Number of times the CMTS upstream receiver flagged a packet with a header checksum (HCS) error from this CM. HCS errors could indicate the same sort of plant problems as CRC errors.


Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem flap

Displays flap list statistics for one or more cable modems.

show cable modem maintenance

Displays station maintenance (SM) error statistics for one or more cable modems.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.


show cable modem extended-power

To display the list of cable modems that are transmitting upstream data at extended power level, use the show cable modem extended-power command in privilege EXEC mode.

show cable modem extended-power

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCF2

This command was introduced.


Examples

The following is a sample output of the show cable modem extended-power command that displays all the cable modems that are transmitting upstream data at extended power level:

Router# show cable modem extended-power
MAC Address    IP Address      I/F           MAC           Prim  Report  ECN
                                             State         Sid   Power
001e.6bfb.3382 5.50.0.3        C7/0/0/UB     w-online      3     57.00   Y
0022.cea5.0214 5.50.1.102      C7/0/0/UB     w-online      5     54.00   Y
001e.6bfb.1378 5.50.6.83       C7/0/0/UB     w-online      6     54.00   Y

Table 1 describes significant fields shown in the display.

Table 20 show cable modem extended-power Field Descriptions 

Field
Description

MAC Address

MAC address of the cable modem.

IP Address

IP address that the DHCP server has assigned to the cable modem.

I/F

Cable interface line card providing the upstream for the cable modem.

MAC State

Current state of the MAC layer.

Prim Sid

Primary Service ID (SID) assigned to the cable modem.

Report Power

Power (in dB) at which cable modems are transmitting upstream data.

ECN

Extended high power at which the CM is operating.


Related Commands

Command
Description

cable upstream ext-power

Enables or disables the DOCSIS extended transmit power support on the Cisco CMTS.


show cable modem flap

To display flap list statistics for one or more cable modems, use the show cable modem flap command in privileged EXEC mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] flap

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] flap

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific cable modem to be displayed. If you specify the IP address for a CPE device behind a cable modem, information for that cable modem is displayed.

mac-address

(Optional) MAC address of a specific cable modem to be displayed. If you specify the MAC address for a CPE device behind a cable modem, information for that cable modem is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all cable modems using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

flap mtc

Displays aggregate data across all upstream channels for each flap detector for cable modems in MTC mode. Displays per channel flap information for a single cable modem in MTC mode.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.1(4)CX, 12.2(1)XF, and 12.2(4)BC1

This command was introduced for the Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 routers.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a cable modem or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a cable modem.

12.2(33)SCC

A new keyword, mtc, was added to provide multiple transmit channel (MTC) information for cable modems in the MTC mode.

The mtc keyword displays aggregate data across all upstream channels for each flap detector for cable modems in the MTC mode.

The show cable modem flap command remains unchanged for non-MTC mode cable modems.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

This command displays information about the flap list activity for one or more cable modems. Unlike the show cable flap-list command, the show cable modem flap command displays flap counters of a cable modem irrespective of the plant condition.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


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.


For cable modems in MTC mode, the show cable modem flap command will display aggregate data across all upstream channels for each flap detector. However, for a single MTC cable modem, the show cable modem flap command will display per channel flap information.


Note The output of the show cable modem flap command will remain unchanged for non-MTC mode cable modems.


Examples

The following example shows sample output for the show cable modem flap command on a Cisco CMTS router:

Router# show cable modem flap 
MAC Address    I/F           Ins   Hit   Miss  CRC   P-Adj   Flap  Time
0025.2e34.4386 C6/0/0/U0     0     46657 3974  0      0      0     (14212 msec)
0025.2e2f.d4b6 C6/0/0/U0     0     47868 1896  0      0      0     (18000 msec)
0025.2e2f.d4de C6/0/0/U0     0     47960 1883  0      0      0     (19552 msec)
0023.bee1.e96b C6/0/0/U0     0     46537 4333  0      0      0     (22432 msec)
0025.2e2f.d4d8 C6/0/0/U0     0     21891 780   0      0      0     ( -- )
0025.2e2f.d48c C6/0/0/U0     0     47918 1828  0      0      0     ( -- )
0025.2e2f.d490 C6/0/0/U0     0     47900 1812  0      0      0     ( -- )
0019.474e.e46a C8/0/0/U0     0     33424 0     0      0      0     (6372 msec)
0019.474e.e266 C8/0/0/U0     0     33418 0     0      0      0     (8352 msec)
0022.ce89.96f2 C8/0/0/U0     0     33427 0     0      0      0     (11112 msec)
0025.2e2f.d58a C8/0/0/U0     0     33423 0     0     !33420  33420 Oct 5  16:02:16(15252 
msec)
001a.c30c.7ef6 C8/0/0/U0     0     33424 2     0      0      0     (17592 msec)
0022.ce89.96b0 C8/0/0/U0     0     33414 0     0      0      0     ( -- )
0025.2e2f.d6de C8/0/0/U0     0     33414 0     0     !33411  33411 Oct 5  16:02:
21( -- )
0025.2e34.43c8 C8/0/0/U0     0     33411 0     0      0      0     ( -- )
0023.bee1.e974 C8/0/0/U0     0     33406 0     0      0      0     ( -- )
0019.474e.e3a7 C8/0/0/U0     0     33324 0     0      0      0     ( -- )

The following example shows sample output for the show cable modem flap command for all cable modems on a specific cable interface:

Router# show cable modem c6/0/0 flap 
MAC Address    I/F           Ins   Hit   Miss  CRC   P-Adj   Flap  Time
0025.2e34.4386 C6/0/0/U0     0     46778 3980  0      0      0     (14212 msec)
0025.2e2f.d4b6 C6/0/0/U0     0     48002 1899  0      0      0     (18000 msec)
0025.2e2f.d4de C6/0/0/U0     0     48098 1889  0      0      0     (19552 msec)
0023.bee1.e96b C6/0/0/U0     0     46658 4351  0      0      0     (22432 msec)
0025.2e2f.d4d8 C6/0/0/U0     0     21979 781   0      0      0     ( -- )
0025.2e2f.d48c C6/0/0/U0     0     48048 1835  0      0      0     ( -- )
0025.2e2f.d490 C6/0/0/U0     0     48029 1819  0      0      0     ( -- )

The following example shows sample output for the show cable modem flap command for a particular cable modem:

Router# show cable modem 0010.7bb3.fcd1 flap 
MAC Address    I/F       Ins   Hit   Miss  CRC   P-Adj   Flap  Time
0010.7bb3.fcd1 C5/0/U5   0     36278 92    0     369     372   Jun 1 13:05:23 (14212 msec)

The following example shows sample output of the show cable modem flap command for all cable modems in the MTC mode on a specific cable interface:

Router# show cable modem c5/0/0 flap 
MAC Address    I/F       Ins   Hit   Miss  CRC   P-Adj   Flap  Time
000e.5c44.d2f0 C5/0/0/U0 0     3040  0     0     0       0 	( -- )
0019.474a.d542 C5/0/0/U3 0     2930  214   0     0       1     May 27 05:21:26(19552 msec)
001a.c3ff.d578 C5/0/0/UB 0     12195 60    0     0       4     May 25 10:01:03(22432 msec)

Table 21 describes the significant fields shown in the display:

Table 21 show cable modem flap Field Descriptions   

Field
Description

MAC Address

The MAC address for the CM.

I/F

The cable interface line card, including upstream, for this cable modem.

Ins

The number of times the cable modem comes up and inserts itself into the network. It can indicate intermittent downstream sync loss or DHCP or modem registration problems.

Hit

The number of times the cable modem responds to MAC layer keepalive messages. (The minimum hit rate is once per 30 seconds. It can indicate intermittent upstream, laser clipping, or common-path distortion.

Miss

The number of times the cable modem misses the MAC layer keepalive message. An 8 percent miss rate is normal for the Cisco cable interface line cards. It can indicate intermittent upstream, laser clipping, or common-path distortion.

CRC

The number of cyclic redundancy check (CRC) errors from this cable modem. It can indicate intermittent upstream, laser clipping, or common-path distortion.

P-Adj

The number of times the headend instructed the cable modem to adjust transmit (TX) power more than 3 dB. It can indicate amplifier degradation, poor connections, or thermal sensitivity.

Flap

The sum of P-Adj and Ins values. cable modems with high flap counts have high SIDs and might not register.

Time

The most recent time that the cable modem dropped the connection. The value displayed in the brackets indicates the duration (milliseconds) between the cable interface to become active and the first ranging success after a line card switchover (cable modem recovery time).


Related Commands

Command
Description

cable flap-list aging

Specifies the number of days to keep a cable modem in the flap-list table before aging it out of the table.

cable flap-list insertion-time

Sets the insertion time interval that determines whether a cable modem is placed in the flap list.

cable flap-list miss-threshold

Configures the threshold for recording a flap-list event, in terms of missed Station Maintenance messages.

cable flap-list power-adjust threshold

Specifies the power-adjust threshold for recording a cable modem flap-list event.

cable flap-list size

Specifies the maximum number of cable modems that can be listed in the flap-list table.

clear cable flap-list

Clears all the entries in the flap-list table.

show cable flap-list

Displays the current contents of the flap list.

show cable modem

Displays information for the registered and unregistered cable modems.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show interface cable modem

Displays information about the cable modems connected to a particular cable interface.


show cable modem ipv6

To display IPv6 information for specified cable modems (CMs) and customer premise equipment (CPE) behind a CM on a Cisco CMTS router, use the show cable modem ipv6 command in privileged EXEC mode.

Cisco uBR7246VXR Router and Cisco uBR7225VXR Router

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] ipv6 [cpe | prefix | registered | unregistered]

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] ipv6 [cpe | prefix | registered | unregistered]

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

cpe

(Optional—Available only when used with an IP address of CM) Displays IPv6 information for the CPE devices behind the CM with the specified IPv4 or IPv6 address.

prefix

(Optional) Displays the IPv6 prefix of the network.

registered

(Optional) Displays IPv6 information for registered CMs.

unregistered

(Optional) Displays IPv6 information for unregistered CMs.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCA

This command was introduced.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

Use the show cable modem ipv6 command without any options to display IPv6 information for all CMs on the CMTS router.

Using the keyword options, you can display IPv6 information by IP address (IPv4 or IPv6) of a particular CM, for all CMs associated with a specified cable interface, by MAC address of a CM, or by domain name of a CM.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


Displaying CPE Information

To display the number of CPEs behind a CM, use the show cable modem ipv6 registered form of the command.

To display CPE information behind a particular CM, you must use the command with an IPv6 address of the CM and the cpe keyword option.

Examples

IPv6 Information for all CMs Example

The following example shows sample output for the show cable modem ipv6 command for all CMs on the CMTS routers, listing the devices by their MAC and IP addresses and displaying the associated domain name:

Router# show cable modem ipv6
MAC Address    Type Interface  Mac State    D/IP IP Address
0004.27a5.b761 B/D  C6/0/2/U1   online        N  ---
0007.0e01.d9a1 B/D  C6/0/2/U0   online        N  ---
0006.2854.7275 R/D  C6/0/2/U1   online        Y  2001:0DB8:3800:80B:7565:5B87:1D7D:5AD5

Table 22 describes the significant fields shown in the display.

Table 22 show cable modem ipv6 Field Descriptions 

Field
Description

MAC Address

MAC address of this CM.

Type

Type of device that this CM is functioning as, with the following possible values:

B/D—CM as bridge using DHCP address assignment.

G/D—CPE router using DHCP address assignment.

C/A—CPE using Stateless Address Auto-Configuration (SLAAC) address assignment.

Note In Cisco IOS Release 12.2(33)SCA, the Cisco CMTS router does not support SLAAC.

Interface

Cable line card interface and upstream associated with this CM.

Mac State

The current state of the MAC layer for this CM (See Table 23 for descriptions of the possible states).

D/IP

Dual IP flag. Identifies whether or not ("Y" or "N") the CM or CPE supports both IPv4 and IPv6 addressing.

IP Address

IP address acquired by the CM. Prior to acquisition of the IP address, or if the CM fails registration, the following output is shown:

IPv4 address not yet acquired—"0.0.0.0"

IPv6 address not yet acquired—"::"

CM fails IPv6 registration, but online with IPv4 address or CM fails IPv4 registration, but online with IPv6 address: "---"

IPv6 address of IPv4-only CM, or IPv4 address of an IPv6-only CM: "---"

Domain Name

Domain name for the CM.


Table 23 shows the possible values for the MAC state field:

Table 23 Descriptions for the MAC State Field 1

MAC State Value
Description
Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing

init(r1)

The CM sent initial ranging.

init(r2)

The CM is ranging. The CMTS received initial ranging from the Cm and has sent RF power, timing offset, and frequency adjustments to the CM.

init(rc)

Ranging has completed.

Note If a CM appears to be stuck in this state, it could be that the CM is able to communicate successfully on the cable network, but that the upstream is at capacity and does not have any additional bandwidth to allow the CM to finish registration and come online. Either manually move one or more CMs to other upstreams, or enable load balancing on the upstream using the cable load-balance group commands.

init(d)

The DHCP request was received, as DHCPDISCOVER. This also indicates that the first IP broadcast packet has been received from the CM.

init(dr)

The DHCP request has been sent to the cable modem.

init(i)

The cable modem has received the DHCPOFFER reply (DHCPACK) from the DHCP server that has assigned an IP address to the modem, but the modem has not yet replied with a DHCPREQUEST message requesting that particular IP address, nor has it sent an IP packet with that IP address.

Note If a CM appears to be stuck in this state, the CM has likely received the DHCPOFFER reply from the DHCP server, but this reply might have contained one or more invalid options for that particular CM.

init(io)

The Cisco CMTS has seen the DHCP offer as sent to the cable modem from the DHCP server that has assigned an IP address to the modem.

init(o)

The CM has begun to download the option file (DOCSIS configuration file) using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP response. If the CM remains in this state, it indicates that the download has failed.

init(t)

Time-of-day (TOD) exchange has started.

resetting

The CM is being reset and will shortly restart the registration process.

 

init6(s)

The Cisco CMTS router has seen the DHCPv6 SOLICIT message from the CM.

init6(a)

The Cisco CMTS router has seen the ADVERTISE message from the DHCPv6 server to the CM.

init6(r)

The Cisco CMTS router has seen the REQUEST response from the CM to the DHCPv6 server.

init6(i)

The Cisco CMTS router has seen the REPLY message from the DHCPv6 server to the CM.

init6(o)

The Cisco CMTS router has seen the REQEST message from the CM to the TFTP server.

init6(t)

The Cisco CMTS router has seen the REQUEST message from the CM to the TOD server.

Non-error Status Conditions

cc(r1)

The CM had registered and was online, but has received a Downstream Channel Change (DCC) or Upstream Channel Change (UCC) request message from the CMTS. The CM has begun moving to the new channel, and the CMTS has received the CM's initial ranging on the new downstream or upstream channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

cc(r2)

This state should normally follow cc(r1) and indicates that the CM has finished its initial ranging on the new channel, and is currently performing continuous ranging on the new channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

offline

The CM is considered offline (disconnected or powered down).

online

The CM has registered and is enabled to pass data on the network.

online(d)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. The CM does not forward traffic to or from the CPE devices, but the CMTS can continue to communicate with the CM using DOCSIS messages and IP traffic (such as SNMP commands).

Note If BPI was enabled in the DOCSIS configuration file sent to the CM, assume that the CM is using BPI encryption, unless other messages show that the BPI negotiation and key assignments have failed.

online(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and KEK is assigned.

Note This state is equivalent to the online(d) and online(pk) states.

online(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note This state is equivalent to the online(d) and online(pt) states.

online(pk)

The CM registered, BPI is enabled and KEK is assigned.

online(pt)

The CM registered, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note If network access was disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) instead of online(pt) even when BPI encryption is enabled and operational.

Note If an exclamation point (!) appears in front of one of the online states, it indicates that the cable dynamic-secret command has been used with either the mark or reject option, and that the cable modem has failed the dynamic secret authentication check.

expire(pk)

The CM registered, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

expire(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pk) states.

expire(pt)

The CM registered, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

expire(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pt) states.

Error Status Conditions

reject(m)

The CM attempted to register but registration was refused due to a bad Message Integrity Check (MIC) value. This also could indicate that the shared secret in the DOCSIS configuration file does not match the value configured on the CMTS with the cable shared-secret command.

In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases, this could also indicate that the cable tftp-enforce command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so.

reject(c)

The CM attempted to register, but registration was refused due to a a number of possible errors:

The CM attempted to register with a minimum guaranteed upstream bandwidth that would exceed the limits imposed by the cable upstream admission-control command.

The CM has been disabled because of a security violation.

A bad class of service (COS) value in the DOCSIS configuration file.

The CM attempted to create a new COS configuration but the CMTS is configured to not permit such changes.

The CM failed the timestamp check for its DOCSIS configuration file. (This could indicate a possible theft-of-service attempt, or a problem with the synchronization of the clocks on the CM and CMTS.)

reject(pk)

KEK key assignment is rejected, BPI encryption has not been established.

reject(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because KEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pk) states.

reject(pt)

TEK key assignment is rejected, BPI encryption has not been established.

reject(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because TEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pt) states.

Note In Cisco IOS Release 12.1(20)EC, Cisco IOS Release 12.2(15)BC1, and earlier releases, when network access is disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) even if BPI encryption fails. Use the show cable modem mac-address command to confirm whether BPI is enabled or disabled for a particular cable modem.

reject(ts)

The CM attempted to register, but registration failed because the TFTP server timestamp in the CM registration request did not match the timestamp maintained by the CMTS. This might indicate that the CM attempted to register by replaying an old DOCSIS configuration file used during a prior registration attempt.

reject(ip)

The CM attempted to register, but registration failed because the IP address in the CM request did not match the IP address that the TFTP server recorded when it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.

reject(na)

The CM attempted to register, but registration failed because the CM did not send a Registration-Acknowledgement (REG-ACK) message in reply to the Registration-Response (REG-RSP) message sent by the CMTS. A Registration-NonAcknowledgement (REG-NACK) is assumed.

1 The CM MAC state field can also be retrieved using SNMP by getting the value of the cdxCmtsCmStatusValue object in the CISCO-DOCS-EXT-MIB.


Example of the show cable modem ipv6 prefix Command for all CMs

The following example shows sample output for the show cable modem ipv6 prefix command for all CMs on the CMTS routers:

Router# show cable modem ipv6 prefix
Device Type: B - CM Bridge, R - CM Router
IP Assignment Method: D - DHCP
MAC Address    Type D/IP IPv6 prefix
0006.2854.7275 R/D  Y    2001:ODB8:3800:80C::/64

Example of the show cable modem ipv6 Command for all Registered CMs

The following example shows sample output for the show cable modem ipv6 registered command for all registered CMs on the CMTS routers:

Router# show cable modem ipv6 registered
Interface Prim Online     CPE IP Address                              MAC Address
          Sid  State
C4/0/U2   1    online     0   ---                                     0018.6835.27b3
C4/0/U2   2    online     0   2001:0DB8:3800:809:A896:1431:75EA:5EA1  0019.474a.c14a
C4/1/U1   2    online     0   ---                                     0007.0e03.6851
C4/1/U1   3    online     0   ---                                     0007.0e01.b085
C4/1/U1   4    online     0   2001:0DB8:3800:809:E97D:2986:9F37:FFE   0018.6835.27aa

Example of the show cable modem ipv6 cpe Command for all CMs

The following example shows sample output for the show cable modem ipv6 cpe command for all CMs on the CMTS routers:

Router# show cable modem 0019.474a.c14a ipv6 cpe
MAC Address    IP Address                              Domain Name

0005.0052.2c1d 2001:420:3800:809:48F7:3C33:B774:9185

Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.


show cable modem mac

To display MAC layer information for one or more CMs, use the show cable modem mac command in privileged EXEC mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable slot/port [upstream port] | name fqdn] mac[summary [total]]

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable slot/subslot/port [upstream port] | name fqdn] mac[summary [total]]

Syntax Description

ip-address

(Optional) Specifies the IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) Specifies the MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

cable slot/port

(Optional) Displays information for all CMs on the specified cable interface and downstream port, where:

slot—Specifies the chassis slot number of the cable interface line card.

port—Specifies the downstream port number.

Valid values for these arguments are dependent on your CMTS router and cable interface line card. Refer to the hardware documentation for your router chassis and cable interface line card for supported slot and port numbering.

cable slot/subslot/port

(Optional) Displays information for all CMs on the specified cable interface on a Cisco uBR10012 router, where:

slot—Specifies the chassis slot number of the cable interface line card. Valid slots are 5 to 8.

subslot—Specifies the secondary slot number of the cable interface line card. Valid subslots are 0 or 1.

port—Specifies the downstream port number. Valid ports are 0 to 4, depending on the cable interface line card.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

summary [total]

(Optional) Displays a summary of MAC layer information for each cable interface. If you add the optional total keyword, the display includes a total of CMs that are included in each of the displayed fields.


Defaults

Displays MAC layer information for all CMs.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.1(4)CX and 12.2(4)BC1

This command was introduced for the Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 routers.

12.2(8)BC2

This command was enhanced to show whether a CM is capable of operating in DOCSIS 1.0 or DOCSIS 1.1 mode, and the version for which it is currently provisioned.

12.2(11)BC1

The mac option was enhanced to support the summary and summary total options.

12.2(15)CX

This command was enhanced to support DOCSIS 2.0 CMs using Advanced Time Division Multiple Access (A-TDMA) modulation profiles.

12.3(17a)BC

Introduced revised information that is displayed for the following two versions of the show cable modem mac command:

show cable modem mac summary

Refer to "Usage Guidelines."

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

The following new initialization states were added to show initialization of CMs and CPEs supporting IPv6:

init6(s)—CMTS router has seen SOLICIT message.

init6(a)—CMTS router has seen ADVERTISE message.

init6(r)—CMTS router has seen REQUEST message.

init6(i)—CMTS router has seen REPLY message.

init6(o)—CMTS router has seen version 6 TFTP request.

init6(t)—CMTS router has seen version 6 TOD request.


Usage Guidelines


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


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.


Cisco IOS Release 12.3(17a)BC introduces changes for two versions of the show cable modem mac command.

show cable modem mac summary

The information displayed with this command is revised. The DOCSIS 2.0 column in the Quality of Service (QoS) Provision Mode field has been removed, as this field is not applicable to QoS provisioning in DOCSIS 2.0.

Command Output in Cisco IOS Release 12.3(17a)BC and Later Releases

Router# show cable modem mac summary 
                            Cable Modem Summary
                            -------------------
                         Mac Version                 QoS Provision Mode
Interface       Total   DOC2.0  DOC1.1  DOC1.0   Reg/Online   DOC1.1  DOC1.0
Cable5/1/0/U0   10      0       2       8        10           0       10

Command Output in Cisco IOS Release 12.3(13a)BC and Earlier Releases

Router# scm mac sum
                            Cable Modem Summary
                            -------------------
                         Mac Version                 QoS Provision Mode
Interface       Total   DOC2.0  DOC1.1  DOC1.0   Reg/Online   DOC2.0  DOC1.1  DOC1.0
Cable8/0/0/U0   8       0       5       3        5            0       5       0

Examples

This section contains examples for the different forms of the show cable modem mac command.

Default Displays

The following example shows typical output for the default form of the show cable modem mac command:

Router# show cable modem mac 
MAC Address    MAC         Prim  Ver    QoS     Frag Concat PHS Priv  DS    US
               State       Sid          Prov                          Saids Sids
0050.7366.1243 online      1     DOC1.0 DOC1.0  no   no     no  BPI   0     0   
0002.b970.0027 online      2     DOC1.1 DOC1.0  no   yes    yes BPI+  0     4   
0006.5314.858d online      3     DOC1.1 DOC1.1  yes  yes    yes BPI+  0     4   
0010.64ff.e4ad online      1     DOC1.1 DOC1.0  yes  yes    yes BPI+  0     4
0010.f025.1bd9 init(rc)    2     DOC1.0 DOC1.0  no   no     no  BPI   0     0
0010.9659.4447 online(pt)  3     DOC1.0 DOC1.0  no   yes    no  BPI   0     0
0010.9659.4461 online(pt)  4     DOC1.0 DOC1.0  no   yes    no  BPI   0     0
0010.64ff.e459 online      5     DOC1.0 DOC1.0  no   yes    no  BPI   0     0
0020.4089.7ed6 online      6     DOC1.0 DOC1.0  no   no     no  BPI   0     0
0090.9607.3831 online(pt)  7     DOC1.0 DOC1.0  no   no     no  BPI   0     0
0090.9607.3830 online(pt)  1     DOC1.0 DOC1.0  no   no     no  BPI   0     0
0050.7366.12fb init(i)     2     DOC1.0 DOC1.0  no   no     no  BPI   0     0
0010.fdfa.0a35 online(pt)  3     DOC1.1 DOC1.1  yes  yes    yes BPI+  0     4

The following example shows sample output for the show cable modem mac command for a particular cable interface:

Router# show cable modem c3/0 mac 
MAC Address    MAC         Prim  Ver    QoS     Frag Concat PHS Priv  DS    US
               State       Sid          Prov                          Saids Sids
0050.7366.1243 online      1     DOC1.0 DOC1.0  no   no     no  BPI   0     0   
0002.b970.0027 online      2     DOC1.1 DOC1.0  no   yes    yes BPI+  0     4   
0006.5314.858d online      3     DOC1.1 DOC1.1  yes  yes    yes BPI+  0     4   

The following example shows sample output for the show cable modem mac command for a particular CM, as identified by its MAC address:

Router# show cable modem 0010.7bb3.fcd1 mac 
MAC Address    MAC         Prim  Ver    QoS     Frag Concat PHS Priv  DS    US
               State       Sid          Prov                          Saids Sids
0010.7bb3.fcd1 online      91    DOC1.1 DOC1.1  yes  yes    yes BPI+  1     4 

The following example shows sample output for the show cable modem mac command for a particular CM, as identified by its IP address:

Router# show cable modem 10.1.1.10 mac 
MAC Address    MAC         Prim  Ver    QoS     Frag Concat PHS Priv  DS    US
               State       Sid          Prov                          Saids Sids
0002.b970.0027 online      2     DOC1.1 DOC1.0  no   yes    yes BPI+  0     4   

Table 24 describes the fields shown in the default forms of the show cable modem mac displays:

Table 24 Descriptions for the Default show cable modem mac Fields 

Field
Description

MAC Address

The MAC address for the CM.

MAC State

The current state of the MAC layer (see Table 23).

Prim SID

The primary SID assigned to this CM.

Ver

Displays the maximum supported version of DOCSIS that the CM supports (DOCSIS 1.0, DOCSIS 1.1, DOCSIS 2.0).

QoS Prov

Displays the version of DOCSIS that the CM currently is provisioned and registered for (DOCSIS 1.0, DOCSIS 1.1, DOCSIS 2.0).

Frag

Indicates whether DOCSIS 1.1 or 2.0 MAC-layer fragmentation is enabled for this CM.

Concat

Indicates whether DOCSIS 1.1 or 2.0 MAC-layer concatenation is enabled for this CM.

PHS

Indicates whether DOCSIS 1.1 or 2.0 packet header suppression (PHS) is enabled for this CM.

Priv

Indicates whether Baseline Privacy Interface (BPI) or BPI Plus (BPI+) encryption is enabled for the CM.

DS Saids

Number of downstream security association IDs (Saids) used by this CM.

US Sids

Number of upstream service IDs (SIDs) used by this CM.


Table 23 shows the possible values for the MAC state field:

Table 25 Descriptions for the MAC State Field 1

MAC State Value
Description
Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing

init(r1)

The CM sent initial ranging.

init(r2)

The CM is ranging. The CMTS received initial ranging from the Cm and has sent RF power, timing offset, and frequency adjustments to the CM.

init(rc)

Ranging has completed.

Note If a CM appears to be stuck in this state, it could be that the CM is able to communicate successfully on the cable network, but that the upstream is at capacity and does not have any additional bandwidth to allow the CM to finish registration and come online. Either manually move one or more CMs to other upstreams, or enable load balancing on the upstream using the cable load-balance group commands.

init(d)

The DHCP request was received, as DHCPDISCOVER. This also indicates that the first IP broadcast packet has been received from the CM.

init(dr)

The DHCP request has been sent to the cable modem.

init(i)

The cable modem has received the DHCPOFFER reply (DHCPACK) from the DHCP server that has assigned an IP address to the modem, but the modem has not yet replied with a DHCPREQUEST message requesting that particular IP address, nor has it sent an IP packet with that IP address.

Note If a CM appears to be stuck in this state, the CM has likely received the DHCPOFFER reply from the DHCP server, but this reply might have contained one or more invalid options for that particular CM.

init(io)

The Cisco CMTS has seen the DHCP offer as sent to the cable modem from the DHCP server that has assigned an IP address to the modem.

init(o)

The CM has begun to download the option file (DOCSIS configuration file) using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP response. If the CM remains in this state, it indicates that the download has failed.

init(t)

Time-of-day (TOD) exchange has started.

resetting

The CM is being reset and will shortly restart the registration process.

 

init6(s)

The Cisco CMTS router has seen the DHCPv6 SOLICIT message from the CM.

init6(a)

The Cisco CMTS router has seen the ADVERTISE message from the DHCPv6 server to the CM.

init6(r)

The Cisco CMTS router has seen the REQUEST response from the CM to the DHCPv6 server.

init6(i)

The Cisco CMTS router has seen the REPLY message from the DHCPv6 server to the CM.

init6(o)

The Cisco CMTS router has seen the REQEST message from the CM to the TFTP server.

init6(t)

The Cisco CMTS router has seen the REQUEST message from the CM to the TOD server.

Non-error Status Conditions

cc(r1)

The CM had registered and was online, but has received a Downstream Channel Change (DCC) or Upstream Channel Change (UCC) request message from the CMTS. The CM has begun moving to the new channel, and the CMTS has received the CM's initial ranging on the new downstream or upstream channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

cc(r2)

This state should normally follow cc(r1) and indicates that the CM has finished its initial ranging on the new channel, and is currently performing continuous ranging on the new channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

offline

The CM is considered offline (disconnected or powered down).

online

The CM has registered and is enabled to pass data on the network.

online(d)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. The CM does not forward traffic to or from the CPE devices, but the CMTS can continue to communicate with the CM using DOCSIS messages and IP traffic (such as SNMP commands).

Note If BPI was enabled in the DOCSIS configuration file sent to the CM, assume that the CM is using BPI encryption, unless other messages show that the BPI negotiation and key assignments have failed.

online(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and KEK is assigned.

Note This state is equivalent to the online(d) and online(pk) states.

online(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note This state is equivalent to the online(d) and online(pt) states.

online(pk)

The CM registered, BPI is enabled and KEK is assigned.

online(pt)

The CM registered, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note If network access was disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) instead of online(pt) even when BPI encryption is enabled and operational.

Note If an exclamation point (!) appears in front of one of the online states, it indicates that the cable dynamic-secret command has been used with either the mark or reject option, and that the cable modem has failed the dynamic secret authentication check.

expire(pk)

The CM registered, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

expire(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pk) states.

expire(pt)

The CM registered, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

expire(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pt) states.

Error Status Conditions

reject(m)

The CM attempted to register but registration was refused due to a bad Message Integrity Check (MIC) value. This also could indicate that the shared secret in the DOCSIS configuration file does not match the value configured on the CMTS with the cable shared-secret command.

In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases, this could also indicate that the cable tftp-enforce command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so.

reject(c)

The CM attempted to register, but registration was refused due to a a number of possible errors:

The CM attempted to register with a minimum guaranteed upstream bandwidth that would exceed the limits imposed by the cable upstream admission-control command.

The CM has been disabled because of a security violation.

A bad class of service (COS) value in the DOCSIS configuration file.

The CM attempted to create a new COS configuration but the CMTS is configured to not permit such changes.

The CM failed the timestamp check for its DOCSIS configuration file. (This could indicate a possible theft-of-service attempt, or a problem with the synchronization of the clocks on the CM and CMTS.)

reject(pk)

KEK key assignment is rejected, BPI encryption has not been established.

reject(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because KEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pk) states.

reject(pt)

TEK key assignment is rejected, BPI encryption has not been established.

reject(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because TEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pt) states.

Note In Cisco IOS Release 12.1(20)EC, Cisco IOS Release 12.2(15)BC1, and earlier releases, when network access is disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) even if BPI encryption fails. Use the show cable modem mac-address command to confirm whether BPI is enabled or disabled for a particular cable modem.

reject(ts)

The CM attempted to register, but registration failed because the TFTP server timestamp in the CM registration request did not match the timestamp maintained by the CMTS. This might indicate that the CM attempted to register by replaying an old DOCSIS configuration file used during a prior registration attempt.

reject(ip)

The CM attempted to register, but registration failed because the IP address in the CM request did not match the IP address that the TFTP server recorded when it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.

reject(na)

The CM attempted to register, but registration failed because the CM did not send a Registration-Acknowledgement (REG-ACK) message in reply to the Registration-Response (REG-RSP) message sent by the CMTS. A Registration-NonAcknowledgement (REG-NACK) is assumed.

1 The CM MAC state field can also be retrieved using SNMP by getting the value of the cdxCmtsCmStatusValue object in the CISCO-DOCS-EXT-MIB.


Summary and Total Options

The following example shows the same display for the show cable modem mac summary command:

Router# show cable modem mac summary 
                             Cable Modem Summary
                             -------------------
                             Mac Version                      QoS Provision Mode
Interface       Total   DOC2.0  DOC1.1  DOC1.0   Reg/Online   DOC2.0  DOC1.1  DOC1.0
Cable8/1/0/U1   1       1       0       0        1            0       0       1
Cable8/1/0/U4   2       2       0       2        2            1       1       0 
Router# 

The following example shows the summary display when the total option is added:

Router# show cable modem mac summary total 
                             Cable Modem Summary
                             -------------------
                             Mac Version                      QoS Provision Mode
Interface       Total   DOC2.0  DOC1.1  DOC1.0   Reg/Online   DOC2.0  DOC1.1  DOC1.0
Cable5/1/0/U5   1       0       0       1        1            0       0       1
Cable6/1/0/U0   11      0       0       11       8            0       0       8
Cable6/1/1/U2   17      0       1       16       15           0       0       15
Cable7/0/0/U0   2       0       0       2        1            0       0       1
Cable7/0/0/U5   1       0       0       1        0            0       0       0
Total:          32      0       1       31       25           0       0       25
Router# 

Table 26 describes the fields shown in the show cable modem mac summary displays:

Table 26 Descriptions for the show cable modem mac summary Fields 

Field
Description

I/F

The cable interface line card providing the upstream for this CM.

Total

Total number of CMs currently active on this cable interface.

MAC Version
DOC 2.0

Total number of CMs on this interface that reported in their registration request as having DOCSIS 2.0 capabilities.

MAC Version
DOC 1.1

Total number of CMs on this interface that reported in their registration request as having DOCSIS 1.1 capabilities.

MAC Version
DOC 1.0

Total number of CMs on this interface that reported in their registration request as having DOCSIS 1.0 capabilities.

Reg/Online

Total number of CMs on this interface that have completed registration and are currently online.

QoS Provisioned Mode
DOC 2.0

Total number of CMs on this interface that have been provisioned and registered for DOCSIS 2.0 operations.

QoS Provisioned Mode
DOC 1.1

Total number of CMs on this interface that have been provisioned and registered for DOCSIS 1.1 operations.

QoS Provisioned Mode
DOC 1.0

Total number of CMs on this interface that have been provisioned and registered for DOCSIS 1.0 operations.


Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem errors

Displays error statistics for one or more CMs.

show cable modem flap

Displays flap list statistics for one or more CMs.

show cable modem maintenance

Displays station maintenance (SM) error statistics for one or more CMs.

show cable modem phy

Displays the DOCSIS PHY layer information for one or more CMs.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem maintenance

To display station maintenance (SM) error statistics for one or more cable modems, use the show cable modem maintenance command in privileged EXEC mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] maintenance

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] maintenance

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

maintenance

Displays station maintenance (SM) error statistics for one or more cable modems.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

11.3XA

This command was introduced.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

This command displays information about the number of times that a CM has exhausted its maximum retry attempts to respond to a Station Maintenance (SM) request, as well as the number of times that the CMTS has aborted ranging with a CM during a Station Maintenance interval. This information can be used to determine whether a particular cable modem or interface is experiencing plant or network difficulties.

You can display this information for all online cable modems, all online cable modems for a specific cable interface, or for one particular cable modem.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


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.


Examples

The following example shows sample output for the show cable modem maintenance command for all online cable modems:

Router# show cable modem maintenance 
MAC Address    I/F         Prim  SM Exhausted          SM Aborted
                           Sid   Count Time            Count Time
0010.9507.01db C5/1/0/U5   1     0     --- -- 00:00:00 0     --- -- 00:00:00
0002.b96f.fdbb C6/1/0/U0   5     1     Jun 20 13:23:03 0     --- -- 00:00:00
0002.fdfa.129d C6/1/0/U0   6     0     --- -- 00:00:00 0     --- -- 00:00:00
0002.fdfa.137d C6/1/0/U0   7     0     --- -- 00:00:00 0     --- -- 00:00:00
0050.7302.3d73 C6/1/0/U0   8     0     --- -- 00:00:00 0     --- -- 00:00:00
0002.fdfa.12d5 C6/1/0/U0   9     0     --- -- 00:00:00 0     --- -- 00:00:00
0002.fdfa.1163 C6/1/0/U0   10    0     --- -- 00:00:00 0     --- -- 00:00:00
0006.28f9.8bbd C6/1/0/U0   11    0     --- -- 00:00:00 0     --- -- 00:00:00
00d0.bad3.c0cf C6/1/0/U0   12    0     --- -- 00:00:00 0     --- -- 00:00:00
0003.e38f.e85b C6/1/0/U0   14    149   Jun 21 14:24:03 0     --- -- 00:00:00
0001.9659.519f C6/1/0/U0   18    53    Jun 21 14:25:32 0     --- -- 00:00:00
0003.e3a6.8195 C6/1/0/U0   19    10    Jun 21 05:37:54 0     --- -- 00:00:00
0003.e3a6.8173 C6/1/1/U2   15    2     Jun 20 13:41:27 0     --- -- 00:00:00
0002.fdfa.12ef C6/1/1/U2   16    1     Jun 20 13:16:30 0     --- -- 00:00:00
0002.fdfa.12e9 C6/1/1/U2   17    1     Jun 20 13:16:30 0     --- -- 00:00:00
0003.e3a6.7f69 C6/1/1/U2   18    2     Jun 20 13:43:10 0     --- -- 00:00:00
0030.80bc.3095 C6/1/1/U2   19    2     Jun 20 13:45:00 0     --- -- 00:00:00
0003.e38f.e9ab C6/1/1/U2   20    1     Jun 20 13:43:47 0     --- -- 00:00:00
0006.28f9.9d19 C6/1/1/U2   22    0     --- -- 00:00:00 0     --- -- 00:00:00
0003.e3a6.7fe3 C6/1/1/U2   23    0     --- -- 00:00:00 0     --- -- 00:00:00
0020.4005.3f06 C6/1/1/U2   24    0     --- -- 00:00:00 0     --- -- 00:00:00
Router# 

The following example shows sample output for the show cable modem maintenance command for all cable modems on a specific cable interface:

Router# show cable modem c8/1/0 maintenance 
MAC Address    I/F         Prim  SM Exhausted          SM Aborted
                           Sid   Count Time            Count Time
0050.7366.1243 C8/1/0/U1   1     1     Apr 28 13:06:11 0     --- -- 00:00:00
0002.b970.0027 C8/1/0/U4   2     0     --- -- 00:00:00 0     --- -- 00:00:00
0006.5314.858d C8/1/0/U4   3     2     Apr 28 13:07:28 0     --- -- 00:00:00
Router# 

The following example shows sample output for the show cable modem maintenance command for a particular CM:

Router# show cable modem 0010.7bb3.fcd1 maintenance 
MAC Address    I/F         Prim  SM Exhausted          SM Aborted
                           Sid   Count Time            Count Time
0010.7bb3.fcd1 C5/0/U5     1     3     Jun 1  10:24:52 0     Jan 1  00:00:00
Router# 

Table 27 describes the fields shown in the show cable modem maintenance displays:

Table 27 Descriptions for the show cable modem maintenance Fields 

Field
Description

MAC Address

The MAC address for the CM.

I/F

The cable interface line card, including upstream, for this CM.

Prim SID

The primary SID assigned to this CM.

SM Exhausted
Count

Number of times this CM has repeatedly timed out and exhausted the maximum allowable retry attempts when it was sent a Station Maintenance request. The CMTS responds by taking the CM offline, forcing the CM to reinitialize and reregister.

SM Exhausted
Time

The last time that this CM repeatedly timed out and exhausted the maximum allowable retry attempts when it was sent a Station Maintenance request.

SM Aborted
Count

Number of times the CMTS has aborted ranging for a CM during a Station Maintenance period, typically because the CM has been reset.

SM Aborted
Time

The last time the CMTS aborted ranging for a CM during a Station Maintenance period, typically because the CM has been reset.


Related Commands

Command
Description

cable flap-list miss-threshold

Configures the threshold for recording a flap-list event, in terms of missed Station Maintenance messages.

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem calls

Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem domain-name

Updates the cable-specific DNS cache and display the domain name for specified CMs and CPE behind a CM on a Cisco CMTS router.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show cable modulation-profile

Displays modulation profile group information.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem offline

To display a list of the cable modems (CMs) that are marked as offline with the Cisco CMTS router, use the show cable modem offline command in privileged EXEC mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] offline

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] offline

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

offline

Displays a list of the cable modems that are marked as offline.


Defaults

Displays a list of all offline CMs known by the Cisco CMTS router.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.0(7)XR and 12.1(1a)T1

This command was introduced.

12.2(4)BC1

Support for the Cisco uBR10012 router was introduced.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

The following new initialization states were added to show initialization of CMs and CPEs supporting IPv6:

init6(s)—CMTS router has seen SOLICIT message.

init6(a)—CMTS router has seen ADVERTISE message.

init6(r)—CMTS router has seen REQUEST message.

init6(i)—CMTS router has seen REPLY message.

init6(o)—CMTS router has seen version 6 TFTP request.

init6(t)—CMTS router has seen version 6 TOD request.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

This command displays a list of CMs that had either been online previously or had attempted to register with the CMTS, but that are now considered offline. Offline cable modems remain in the CMTS databases for 24 hours and then are deleted.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


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.


Examples

The following example shows sample output for the default form of the show cable modem offline command.

Router# show cable modem offline 
Interface   MAC address    Prim Previous  Offline          Rx     Rx    SM
                           Sid  State     Time             Power  SNR   Exhaust
                                                                        Count
Cable5/0/U0 0030.946a.5d61 1    init(i)   Jun 14 21:31:57   0.00  31.86 162  
Cable5/0/U0 0030.946a.5d85 2    init(i)   Jun 14 22:47:39  -0.25  31.26 156  
Cable5/0/U0 0030.946a.5b6d 3    init(i)   Jun 14 14:20:11   1.00  30.56 166 

The following example shows sample output for the show cable modem offline command for a particular upstream on a cable interface:

Router# show cable modem c3/0 upstream 0 offline 
Interface MAC address    Prim Previous    Offline          Rx     Rx    SM
                         Sid  State       Time             Power  SNR   Exhaust
                                                                        Count
C3/0/U0   0050.7366.1c69 58   init(rc)    Jan 7  16:46:49   4.50  26.72 2    
C3/0/U0   0050.7366.1c53 59   init(rc)    Jan 7  16:47:09   5.25  25.10 1    
C3/0/U0   0050.7366.1ca7 60   init(rc)    Jan 7  16:47:11   5.00  25.57 1    
C3/0/U0   0050.7366.1c45 61   init(rc)    Jan 7  16:49:27   5.00  26.74 2    
C3/0/U0   0050.7366.1c95 62   init(rc)    Jan 7  16:51:29   5.50  31.82 1    
C3/0/U0   0050.7366.1c99 64   init(rc)    Jan 7  16:52:55   5.25  26.76 2 

The following example shows sample output for the show cable modem offline command for a single CM, as identified by its IP address:

Router# show cable modem 22.1.1.10 offline 
Interface   MAC address    Prim Previous  Offline          Rx     Rx    SM
                           Sid  State     Time             Power  SNR   Exhaust
                                                                        Count
Cable5/0/U0 0030.946a.5b6d 3    init(i)   Jun 14 14:20:11   1.00  30.56 166 

The following example shows sample output for the show cable modem offline command for a single CM, as identified by its MAC address:

Router# show cable modem 0030.946a.5d61 offline 
Interface   MAC address    Prim Previous  Offline          Rx     Rx    SM
                           Sid  State     Time             Power  SNR   Exhaust
                                                                        Count
Cable5/0/U0 0030.946a.5d61 1    init(i)   Jun 14 21:31:57   0.00  31.86 162  

Table 28 describes the major fields shown in the show cable modem offline displays:

Table 28 Descriptions for the show cable modem offline Fields 

Field
Description

Interface

The cable interface line card that this CM last used when it was online.

MAC address

Hardware MAC address for this CM.

Prim SID

The primary SID that had been last assigned to this CM before it went offline.

Previous State

The last known state of the MAC layer for this CM before it went offline (see Table 23).

Note A pound sign (#) in the Previous State column indicates that the cable tftp-enforce mark-only command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so (Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases).

Offline Time

The time and date that this CM last went offline.

Rx Power

The last known received power level (in dB) for the CM before it went offline.

Note An asterisk (*) in the Rx Power column indicates that a power adjustment was made for that CM. An exclamation point (!) indicates that the CM had reached its maximum power transmit level and could not increase its power level further.

Rx SNR

The last known signal-to-noise ratio (SNR) value for this CM before it went offline.

SM Exhaust Count

Number of times that this CM has exhausted the maximum allowable retries for not responding to the regular Station Maintenance (SM) messages sent to it by the CMTS.

Note Using the clear counters command to reset a cable interface's counters also resets the SM Exhaust Count field for all offline CMs to zero and resets the Offline Time field for all offline CMs to the current time.


Table 23 shows the possible values for the Previous State field:

Table 29 Descriptions for the Previous State Field 1

MAC State Value
Description
Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing

init(r1)

The CM sent initial ranging.

init(r2)

The CM is ranging. The CMTS received initial ranging from the Cm and has sent RF power, timing offset, and frequency adjustments to the CM.

init(rc)

Ranging has completed.

Note If a CM appears to be stuck in this state, it could be that the CM is able to communicate successfully on the cable network, but that the upstream is at capacity and does not have any additional bandwidth to allow the CM to finish registration and come online. Either manually move one or more CMs to other upstreams, or enable load balancing on the upstream using the cable load-balance group commands.

init(d)

The DHCP request was received, as DHCPDISCOVER. This also indicates that the first IP broadcast packet has been received from the CM.

init(dr)

The DHCP request has been sent to the cable modem.

init(i)

The cable modem has received the DHCPOFFER reply (DHCPACK) from the DHCP server that has assigned an IP address to the modem, but the modem has not yet replied with a DHCPREQUEST message requesting that particular IP address, nor has it sent an IP packet with that IP address.

Note If a CM appears to be stuck in this state, the CM has likely received the DHCPOFFER reply from the DHCP server, but this reply might have contained one or more invalid options for that particular CM.

init(io)

The Cisco CMTS has seen the DHCP offer as sent to the cable modem from the DHCP server that has assigned an IP address to the modem.

init(o)

The CM has begun to download the option file (DOCSIS configuration file) using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP response. If the CM remains in this state, it indicates that the download has failed.

init(t)

Time-of-day (TOD) exchange has started.

resetting

The CM is being reset and will shortly restart the registration process.

 

init6(s)

The Cisco CMTS router has seen the DHCPv6 SOLICIT message from the CM.

init6(a)

The Cisco CMTS router has seen the ADVERTISE message from the DHCPv6 server to the CM.

init6(r)

The Cisco CMTS router has seen the REQUEST response from the CM to the DHCPv6 server.

init6(i)

The Cisco CMTS router has seen the REPLY message from the DHCPv6 server to the CM.

init6(o)

The Cisco CMTS router has seen the REQEST message from the CM to the TFTP server.

init6(t)

The Cisco CMTS router has seen the REQUEST message from the CM to the TOD server.

Non-error Status Conditions

cc(r1)

The CM had registered and was online, but has received a Downstream Channel Change (DCC) or Upstream Channel Change (UCC) request message from the CMTS. The CM has begun moving to the new channel, and the CMTS has received the CM's initial ranging on the new downstream or upstream channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

cc(r2)

This state should normally follow cc(r1) and indicates that the CM has finished its initial ranging on the new channel, and is currently performing continuous ranging on the new channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

offline

The CM is considered offline (disconnected or powered down).

online

The CM has registered and is enabled to pass data on the network.

online(d)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. The CM does not forward traffic to or from the CPE devices, but the CMTS can continue to communicate with the CM using DOCSIS messages and IP traffic (such as SNMP commands).

Note If BPI was enabled in the DOCSIS configuration file sent to the CM, assume that the CM is using BPI encryption, unless other messages show that the BPI negotiation and key assignments have failed.

online(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and KEK is assigned.

Note This state is equivalent to the online(d) and online(pk) states.

online(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note This state is equivalent to the online(d) and online(pt) states.

online(pk)

The CM registered, BPI is enabled and KEK is assigned.

online(pt)

The CM registered, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note If network access was disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) instead of online(pt) even when BPI encryption is enabled and operational.

Note If an exclamation point (!) appears in front of one of the online states, it indicates that the cable dynamic-secret command has been used with either the mark or reject option, and that the cable modem has failed the dynamic secret authentication check.

expire(pk)

The CM registered, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

expire(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pk) states.

expire(pt)

The CM registered, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

expire(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pt) states.

Error Status Conditions

reject(m)

The CM attempted to register but registration was refused due to a bad Message Integrity Check (MIC) value. This also could indicate that the shared secret in the DOCSIS configuration file does not match the value configured on the CMTS with the cable shared-secret command.

In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases, this could also indicate that the cable tftp-enforce command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so.

reject(c)

The CM attempted to register, but registration was refused due to a a number of possible errors:

The CM attempted to register with a minimum guaranteed upstream bandwidth that would exceed the limits imposed by the cable upstream admission-control command.

The CM has been disabled because of a security violation.

A bad class of service (COS) value in the DOCSIS configuration file.

The CM attempted to create a new COS configuration but the CMTS is configured to not permit such changes.

The CM failed the timestamp check for its DOCSIS configuration file. (This could indicate a possible theft-of-service attempt, or a problem with the synchronization of the clocks on the CM and CMTS.)

reject(pk)

KEK key assignment is rejected, BPI encryption has not been established.

reject(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because KEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pk) states.

reject(pt)

TEK key assignment is rejected, BPI encryption has not been established.

reject(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because TEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pt) states.

Note In Cisco IOS Release 12.1(20)EC, Cisco IOS Release 12.2(15)BC1, and earlier releases, when network access is disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) even if BPI encryption fails. Use the show cable modem mac-address command to confirm whether BPI is enabled or disabled for a particular cable modem.

reject(ts)

The CM attempted to register, but registration failed because the TFTP server timestamp in the CM registration request did not match the timestamp maintained by the CMTS. This might indicate that the CM attempted to register by replaying an old DOCSIS configuration file used during a prior registration attempt.

reject(ip)

The CM attempted to register, but registration failed because the IP address in the CM request did not match the IP address that the TFTP server recorded when it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.

reject(na)

The CM attempted to register, but registration failed because the CM did not send a Registration-Acknowledgement (REG-ACK) message in reply to the Registration-Response (REG-RSP) message sent by the CMTS. A Registration-NonAcknowledgement (REG-NACK) is assumed.

1 The CM MAC state field can also be retrieved using SNMP by getting the value of the cdxCmtsCmStatusValue object in the CISCO-DOCS-EXT-MIB.


Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

clear counters

Clears counters for one or all interfaces.

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem access-group

Displays the access groups for the CMs on a particular cable interface.

show cable modem classifiers

Displays information about the classifiers for a particular CM.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem cpe

Displays the CPE devices accessing the cable interface through a particular CM.

show cable modem registered

Displays a list of the CMs that are marked as registered with the Cisco CMTS.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show cable modem unregistered

Displays a list of the CMs that are marked as unregistered with the Cisco CMTS.

show cable modem vendor

Displays the vendor name or Organizational Unique Identifier (OUI) for the CMs on each cable interface.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem partial-mode

To display information about cable modems that are in upstream and downstream partial service mode, use the show cable modem partial-mode command in privileged EXEC mode.

show cable modem partial-mode

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCD2

This command was introduced.


Usage Guidelines

If all cable modems are in full service mode (all downstream and upstream channels of the cable modems are online and operational), then the show cable modem partial-mode command does not provide any output. This command provides output only when the cable modems register in partial service mode (one or more downstream or upstream channels of the downstream or upstream bonded cable modems are not operational).

Examples

The following is a sample output of the show cable modem partial-mode command that displays all the cable modems in partial service mode:

Router# show cable modem partial-mode
MAC Address    IP Address      I/F         MAC           Prim  RCC  UP-reason/
                                           State         Sid   ID   Failed-tcs
001e.6bfb.33a0 2.99.81.14      C7/0/0/p    p-online(pt)  3     2     0x1 / 0x4
0022.cef4.3d9a 2.99.81.23      C7/0/0/p    p-online(pt)  4     2     0x1 / 0x4
001e.6bfb.194e 2.99.81.32      C7/0/0/p    p-online(pt)  6     2     0x1 / 0x4
001e.6bfb.1538 2.99.81.38      C7/0/0/p    p-online(pt)  8     2     0x1 / 0x4
001e.6bfb.0d22 2.99.81.29      C7/0/0/p    p-online(pt)  9     1     0x1 / 0x4
001e.6bfb.1a7e 2.99.81.30      C7/0/0/p    p-online(pt)  10    1     0x1 / 0x4
001e.6bfa.f58a 2.99.81.9       C7/0/0/p    p-online(pt)  12    1     0x1 / 0x4
0022.cef4.3fa2 2.99.81.24      C7/0/0/p    p-online(pt)  13    2     0x1 / 0x4
001e.6bfb.1b72 2.99.81.10      C7/0/0/p    p-online(pt)  14    2     0x1 / 0x4
0023.be50.e578 2.99.81.17      C7/0/0/UB   p-online(pt)  16    2     N/A
0025.2e2d.784a 2.99.81.28      C7/0/0/UB   p-online(pt)  17    2     N/A
0025.2e2d.748c 2.99.81.26      C7/0/0/UB   p-online(pt)  18    2     N/A

Table 30 describes the significant fields shown in the display.

Table 30 show cable modem partial-mode Field Descriptions 

Field
Description

MAC Address

MAC address of the cable modem.

IP Address

IP address that the DHCP server has assigned to the cable modem.

I/F

Cable interface line card providing the upstream for the cable modem.

MAC State

Current state of the MAC layer.

Prim Sid

Primary Service ID (SID) assigned to the cable modem.

RCC ID

Receive channel configuration (RCC) ID of the cable modem.

UP-reason/Failed-tcs

UP-reason—Upstream partial service reason. This is a bitmap defined in upstream resiliency.

Failed-tcs—Transmit channel set (TCS) bitmap of the cable modem, which is not available.


Related Commands

Command
Description

show cable modem

Displays information about the registered and unregistered cable modems.

show cable modem docsis-version

Displays information about the DOCSIS version of cable modems on one or more cable interfaces.


show cable modem phy

To display DOCSIS PHY layer information for one or more cable modems (CMs), use the show cable modem phy command in privileged EXEC mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] phy

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] phy

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

phy

Displays DOCSIS PHY layer information for one or more cable modems.


Defaults

Displays PHY information for all CMs.

Command Modes

Privileged EXEC (#)

Command History

This table includes the following release-specific history entries:

CX and BC Releases

SC Release

CX and BC Releases
Modification

12.1(4)CX and 12.2(4)BC1

This command was introduced for the Cisco uBR7100 series, Cisco uBR7200 series, and CIsco uBR10012 routers.

12.2(15)BC2

The service ID (SID) and Mode fields were added to the default display.

12.3(17a)BC

Enhanced the show cable modem phy command. The MicroReflec column (MicroReflections) has been removed, and the DOCSIS Prov (DOCSIS Provider) column has been added in its place. This new column contains DOCSIS version information. See updated examples.

SC Release
Modification

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

12.2(33)SCC

For DOCSIS 3.0-certified cable modems with multiple upstream channels, the command output was modified to display PHY layer details of each upstream channel. In this case, the output may contain multiple results for the same MAC address. The asterix (*) that appears beside the DOCSIS operating mode under the Mode column identifies that the CM is operating in the MTC mode.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

This command displays information about the DOCSIS PHY layer for one or more CMs. You can display information for all CMs, for all CMs on a particular cable interface, or for a particular CM, as identified by its IP or MAC address.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


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.


Examples

Example from Cisco IOS Release 12.3(17a)BC and Later Releases

Cisco IOS Release 12.3(17a)BC introduces revised output for the show cable modem phy command. The MicroReflec column (MicroReflections) has been removed, and the DOCSIS Prov (DOCSIS Provider) column has been added in its place. This new column contains DOCSIS version information.

Router# show cable modem phy 
MAC Address    I/F         Sid  USPwr  USSNR  Timing  DSPwr  DSSNR  Mode  DOCSIS
                                (dBmV) (dB)   Offset  (dBmV) (dB)         Prov 
0003.e350.9a3f C5/1/0/U0   1    0.00   30.23  2811    0.00   -----  tdma  1.0
0050.734e.c1a1 C5/1/0/U0   2    0.00   30.47  2811    0.00   -----  tdma  1.0
0007.0e01.1749 C5/1/0/U0   3    0.00   30.65  2808    0.00   -----  tdma  1.0
0007.0e00.90dd C5/1/0/U0   4    0.00   30.66  2806    0.00   -----  tdma  1.0
0003.e350.9ad3 C5/1/0/U0   5    0.00   30.47  2810    0.00   -----  tdma  1.0
0003.e38f.f4e5 C5/1/0/U0   6    0.00   30.36  2813    0.00   -----  tdma  1.0
0003.e350.9b97 C5/1/0/U0   7    0.00   30.44  2812    0.00   -----  tdma  1.0
0003.e350.9bed C5/1/0/U0   8    0.00   30.16  2814    0.00   -----  tdma  1.0
0003.e308.455d C5/1/0/U0   9    0.00   30.79  2811    0.00   -----  tdma  1.0
0003.6bd6.bfaf C5/1/0/U0   10   0.00   30.40  2813    0.00   -----  tdma  1.0

Examples from Cisco IOS Release 12.3(13a)BC and Earlier Releases

Router# show cable modem phy
MAC Address    I/F         Sid  USPwr  USSNR  Timing MicroReflec DSPwr  DSSNR  Mode
                                (dBmV)  (dB)   Offset (dBc)      (dBmV)   (dB)     
0008.0e06.7b14 C8/0/0/U0   1    0.00   30.36  1938   0            0.00  -----  tdma 
0050.f112.5977 C8/0/0/U0   2    0.00   30.36  1695   0            0.00  -----  tdma 
0090.837b.b0b9 C8/0/0/U0   3    0.00   30.64  1187   0            0.00  -----  tdma 
0007.0e03.6e99 C8/0/0/U0   5    0.00   30.36  2747   0            0.00  -----  tdma 
0007.0e04.5091 C8/0/0/U0   6    0.00   30.94  2746   0            0.00  -----  tdma 
0006.5314.81d9 C8/0/0/U0   7    0.00   30.36  2745   0            0.00  -----  tdma 
0003.6b1b.ee63 C8/0/0/U0   8    0.00   31.26  2745   0            0.00  -----  tdma 
0030.eb15.84e7 C8/0/0/U0   12   0.00   30.36  1157   0            0.00  -----  tdma 

The following example shows sample output for the show cable modem phy command for all CMs on the Cisco CMTS router:

Router# show cable modem phy 
MAC Address    I/F         Sid  USPwr  USSNR  Timing  MicroReflec DSPwr  DSSNR  Mode
                                (dBmV) (dBmV) Offset  (dBc)       (dBmV) (dBmV) 
0008.0e09.81f8 C3/0        1    50.00  28.40  1705     26          -3.4   36.02 tdma 
0003.6b3c.1aa7 C3/0        2     0.00  28.27  3643      0           0.00  ----- tdma 
0008.0e09.7fe2 C4/0        3    35.00  28.44  1760     27          12.00  35.03 tdma 

The following example shows sample output for the show cable modem phy command for all CMs on a particular cable interface:

Router# show cable modem cable 3/0 phy 
MAC Address    I/F         Sid  USPwr  USSNR  Timing  MicroReflec DSPwr  DSSNR  Mode
                                (dBmV) (dBmV) Offset  (dBc)       (dBmV) (dBmV) 
0008.0e09.81f8 C3/0        1    50.00  28.40  1705     26          -3.4   36.02 tdma
0003.6b3c.1aa7 C3/0        2     0.00  28.27  3643      0           0.00  ----- tdma 

The following example shows sample output for the show cable modem phy command for a particular CM:

Router# show cable modem 0050.7366.1243 phy 
MAC Address    I/F         Sid  USPwr  USSNR  Timing  MicroReflec DSPwr  DSSNR  Mode
                                (dBmV) (dBmV) Offset  (dBc)       (dBmV) (dBmV)  
0050.6736.4124 C3/0        14   38.00  24.58  1651     0           8.00  35.41  tdma

Example from Cisco IOS Release 12.2(33)SCD

The following example shows a sample output of the show cable modem phy command for all CMs on the Cisco CMTS router:

Router# show cable modem phy
MAC Address    I/F           Sid   USPwr  USMER Timing DSPwr  DSMER  Mode   DOCSIS
                                   (dBmV) (SNR) Offset (dBmV) (SNR)         Prov
                                          (dB)                (dB)
001c.ea37.9b5c C3/0/U2.0     27     0.00  36.12 5394    0.00  -----  tdma   1.1
001c.ea37.9b78 C3/0/U2.0     29     0.00  36.12 5396    0.00  -----  tdma   1.1
001c.ea37.9b5a C3/0/U3.0     31     0.00  36.12 5394    0.00  -----  tdma   1.1
001c.ea37.9ba4 C3/0/U2.0     32     0.00  36.12 5393    0.00  -----  tdma   1.1
001c.ea37.9aac C3/1/U2.1     28     0.00  36.12 5620    0.00  -----  tdma   1.1
001a.c3ff.d1a4 C3/1/U0.0     29    43.50  36.12 6020    0.00  -----  tdma*  1.1
001a.c3ff.d1a4 C3/1/U1.0     29    43.50  36.12 6020    0.00  -----  tdma*  1.1
001a.c3ff.d1a4 C3/1/U2.0     29    43.50  36.12 6019    0.00  -----  tdma*  1.1
001a.c3ff.d1a4 C3/1/U3.0     29    43.50  36.12 6021    0.00  -----  tdma*  1.1

Table 31 describes the fields shown in the show cable modem phy displays:

Table 31 Descriptions for the show cable modem phy Fields 

Field
Description

MAC Address

The MAC address for the CM.

I/F

The cable interface on the CMTS that is providing services for this CM.

SID

Service ID that this CM is using.

USPwr (dBmV)

Displays the CM transmit level in dBmV, as measured by the CMTS.

USSNR (dBmV)

Upstream signal-to-noise ratio (SNR) or carrier-to-noise ratio (CNR), in dB, as measured by the CMTS. This field shows the CNR value for cable interfaces that support onboard hardware-based spectrum management, such as the Cisco uBR-MC16S card, and shows the SNR value for other cable interfaces.

Note Although the field name shows the value as being given in dBmV, the actual value should be interpreted in dB.

Timing Offset

The timing offset for the CM, in ticks, as recognized on the CMTS. (A tick, as used here, is 6.25/64 microseconds.) This is the delay between when a particular cable modem is scheduled to make a transmission and when the CMTS actually receives it.

Note An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command.

Note The timing offset shown here is typically smaller than the TX Time Offset value shown by the show cable modem remote-query command, because the latter value is the offset as recognized on the CM (which will include any internal delay between when the CM software begins the transmission and when the bits actually appear on the local cable interface).

Microreflec (dBc)

The approximate value of microreflections on the downstream, measured in dBc below the signal level, as seen by the CM. Microreflections are a type of impairment that is caused by impedance mismatches between amplifiers, couples, cables, and other equipment in the cable plant. Microreflections create copies of a signal that arrive at the receiver with different amounts of delay and attenuation, generating intersymbol interference (ISI) that can cause the receiver to improperly detect the amplitude and phase of the incoming signal.

Note This value is not exact but provides an approximate indication of the microreflections that have been received.

DSPwr (dBmV)

Downstream receive power level, in dBmV, as reported by the CM.

DSSNR (dBmV)

Downstream signal-to-noise ratio (SNR), in dB, as reported by the CM.

Note This command displays values for the downstream power and SNR values only if you have configured the cable modem remote-query command on the CMTS, and if the CM supports providing those options.

Mode

DOCSIS operating mode for the CM:

tdma=DOCSIS 1.X, TDMA-only mode

atdma=DOCSIS 2.0 A-TDMA mode

A hyphen (-) indicates the mode is unknown or the CM has not yet registered.

For DOCSIS 3.0-certified cable modems with multiple upstream channels, the output may contain multiple results for the same MAC address. In Cisco IOS Release 12.2(33)SCC, the asterix (*) that appears beside the DOCSIS operating mode under the Mode column identifies that the CM is operating in the MTC mode.

Note This field is the same as that returned by the docsIfCmtsCmStatusModulationType object in the DOCS-IF-MIB.


Related Commands

Command
Description

cable modem remote-query

Enables and configures the remote-query feature to gather CM performance statistics on the CMTS.

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem cpe

Displays the CPE devices accessing the cable interface through a particular CM.

show cable modem errors

Displays error statistics for one or more CMs.

show cable modem flap

Displays flap list statistics for one or more cable modems.

show cable modem mac

Displays MAC layer information for one or more CMs.

show cable modem maintenance

Displays station maintenance (SM) error statistics for one or more cable modems.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem primary-channel

To display the primary-channel and host interface for all modems or for modems on a MAC domain host interface, use the show cable modem primary-channel command.

show cable modem [cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]]] primary-channel [non-bonding-capable [legacy-ranging]] [wideband [registered-traditional-docsis]]

Syntax Description

slot

Slot where the line card resides. The valid range is from 5 to 8.

subslot

Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number. The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using this specific upstream. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports on the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

non-bonding-capable

Displays the cable modems and primary downstreams of the cable modems that are not capable of bonding.

legacy-initial-ranging

Displays modems that access with legacy INIT-RNG-REQ.

wideband

Displays wideband online modems.

registered-traditional-docsis

Displays wideband cable modems registered in traditional pre-DOCSIS3.0 mode.


Command Default

No default behavior or values.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.3(23)BC

This command was introduced for the Cisco uBR10012 router.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

Use this command to display the primary downstream channel information of modems for different modem categories in terms of bonding capability, such as, non-bonding-capable modems accessed with legacy initial ranging or wideband cable modems registered via traditional DOCSIS.

Examples

The following show cable modem primary-channel non-bonding-capable command shows the individual cable modems displays and the primary downstream channel for each cable modem.

Router# show cable modem primary-channel non-bonding-capable

MAC Address IP Address Host MAC Prim Num Primary DS

Interface State Sid CPE Downstream RfId

000f.66f9.aa73 80.17.1.3 C6/0/0/U0 online(pt) 1 0 C6/0/0 255

0007.0e02.d7e9 80.17.1.7 C6/0/0/U0 online(pt) 5 0 Mo3/0/0:1 1

0013.10bb.22f9 80.17.1.2 C6/0/0/U0 online(pt) 2 0 Mo3/0/0:1 1

000f.66f9.b193 80.17.1.6 C6/0/0/U0 online(pt) 22 0 C6/0/0 255

0012.17ea.f3fb 80.17.1.4 C6/0/0/U0 online(pt) 23 0 C6/0/0 255

0013.10bb.23d1 80.17.1.5 C6/0/1/U1 online(pt) 5 0 C6/0/1 255

Related Commands

Command
Description

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem voice

Displays detected voice-enabled modems.

show cable service-voice downstream type

Shows the current enforced downstream type on the uBR10-MC5x20 line card.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.


show cable modem primary-channel summary total

To display the number of cable modems grouped by primary downstream channels information under a Channel Grouping Domain (CGD), use the show cable modem primary-channel summary total command in privileged EXEC mode.

show cable modem primary-channel [cable slot/subslot/port] summary total

Syntax Description

slot

The slot used for the cable interface line card. Valid values are 5 to 8.

subslot

The subslot used for the cable interface line card. Valid values are 0 to 1.

port

The downstream port used as a MAC domain host interface port. Valid values are 0 to 4.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(23)BC

This command was introduced for the Cisco uBR10012 router.


Usage Guidelines

Use the show cable modem primary-channel summary total command to display the number of cable modems grouped by primary downstream channels. You can also use this command to display information for narrowband and wideband modems and group the information based on a SPA or a uBR10-MC 5x20 primary downstream. You can also display information on modems based on a specific cable MAC domain.

Examples

The following example shows attributes of the primary channels to which the various modems are hosted under the CGD domain c6/0/0.

Router#show cable modem primary-channel
MAC Address    IP Address      Host      MAC          Prim  Num  Primary    DS
                               Interface State        Sid   CPE  Downstream RfId
000f.66f9.aa73 80.17.1.2       C6/0/0/U0 online       13    0    C6/0/0     255
000f.66f9.b193 80.17.1.3       C6/0/0/U0 online       14    0    C6/0/0     255
0012.17ea.f3fb 80.17.1.5       C6/0/0/U0 online       15    0    C6/0/0     255
0019.474a.d4f8 80.17.1.13      C6/0/0/U0 online       16    0    C6/0/0     255
0000.cab7.7f1c 80.17.1.8       C6/0/0/U0 online       17    1    C6/0/0     255
0019.474a.d3d4 80.17.1.11      C6/0/0/U0 online       18    0    C6/0/0     255
0007.0e02.d7e9 80.17.1.10      C6/0/0/U0 online       19    0    C6/0/0     255
0019.474a.cd82 80.17.1.20      C6/0/0/U0 online       20    0    C6/0/0     255
0019.474a.d3fa 80.17.1.7       C6/0/0/U0 online       22    0    C6/0/0     255
0018.6852.82ea 80.17.1.6       C6/0/0/U0 online       24    0    C6/0/0     255
0013.10bb.23d1 80.17.1.12      C6/0/0/U0 online       23    1    Mo3/0/0:0  0

The following example shows modems grouped according to their capability, indicating whether they are wideband or narrowband modems. The command also displays the local of the primary downstreams of the modem, indicating whether the primary downstream is a SPA downstream (Remote) or a uBR10-MC 5x20 downstream (Local). The Wideband column indicates if the status of the modem is online or wideband-online.

Router#show cable modem primary-channel summary total
                                Cable Modem
            Total Reg   Oper  Unreg Offline Wideband initRC initD initIO initO 0-Blaze
Local Primary Narrowband:
C6/0/0      5     5     5     0     0       0        0      0     0      0     0
C6/0/1      0     0     0     0     0       0        0      0     0      0     0
Subtotal:   5     5     5     0     0       0        0      0     0      0     0
Local Primary Wideband:
C6/0/0      5     5     5     0     0       0        0      0     0      0     0
C6/0/1      0     0     0     0     0       0        0      0     0      0     0
Subtotal:   5     5     5     0     0       0        0      0     0      0     0
Remote Primary Narrowband:
Mo3/0/0:0   1     1     1     0     0       0        0      0     0      0     0
Subtotal:   1     1     1     0     0       0        0      0     0      0     0
Remote Primary Wideband:
Subtotal:   0     0     0     0     0       0        0      0     0      0     0
Total:      11    11    11    0     0       0        0      0     0      0     0

The example below shows the modems grouped by primary downstream channels for the cable MAC domain c6/0/0.

Router#show cable modem primary-channel summary c6/0/0 total
                                Cable Modem
            Total Reg   Oper  Unreg Offline Wideband initRC initD initIO initO 0-Blaze
Local Primary Narrowband:
C6/0/0      5     5     5     0     0       0        0      0     0      0     0
Local Primary Wideband:
C6/0/0      5     5     5     0     0       0        0      0     0      0     0
Remote Primary Narrowband:
Mo3/0/0:0   1     1     1     0     0       0        0      0     0      0     0
Subtotal:   1     1     1     0     0       0        0      0     0      0     0
Remote Primary Wideband:
Subtotal:   0     0     0     0     0       0        0      0     0      0     0
Total:      11    11    11    0     0       0        0      0     0      0     0

Related Commands

Command
Description

show cable modem

Displays information for the registered and unregistered cable modems.


show cable modem privacy

To display the privacy information for the registered and unregistered CMs, use the show cable modem privacy command in privileged EXEC mode.

Cisco uBR7200 Series Routers

show cable modem {ip-address | mac-address} privacy [verbose]

Cisco uBR10012 Router

show cable modem {ip-address | mac-address} privacy [verbose]

Syntax Description

ip-address

IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

privacy

Displays the privacy information for the CMs.

verbose

Displays detailed information for the CMs.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCC

This command was introduced.


Usage Guidelines

This command displays privacy information of a particular CM, identified by its IP address or MAC address.

Examples

The following sample output from the show cable modem privacy command shows the privacy information for a particular CM using a specified MAC address.

Router# show cable modem 0018.6835.2987 privacy 
MAC Address             : 0018.6835.2987
Primary SID             : 10
BPI Mode                : BPI+
BPI State               : assign(tek)
Security Capabilities   :
 Encryption             : DES-56 
 EAE                    : Unsupported 
Latest Key Sequence     : 2
 Key Status             : Active
 Remaining Lifetime     : 294 sec
 Key Gracetime          : 60 sec
Current Key Sequence    : 2
CA Certificate Details   :
 Certificate Serial       : 57BF2DF60E9FFBECF8E69709DE34BC26
 Certificate Self-Signed  : False
 Certificate State        : Chained
CM Certificate Details   :
 CM Certificate Serial    : 010244AF1A135202
 CM Certificate State     : Chained
KEK Reject Code         : None
KEK Reject Reason       : No Information
KEK Invalid Code        : None
KEK Invalid Reason      : No Information
Primary SID Information   :
SID                     : 10   
Encryption Algorithm    : 56-bit DES
Latest Sequence Number  : 5
 Key Status             : Active
 Remaining Lifetime     : 144 sec
 Key Gracetime          : 60 sec
Current Sequence Number : 4
 Key Status             : Active
 Remaining Lifetime     : 54 sec
 Key Gracetime          : 60 sec
TEK Reject Code         : None
TEK Reject Reason       : No Information
TEK Invalid Code        : None
TEK Invalid Reason      : No Information

Example of show cable modem privacy verbose Command Output for a Specified MAC Address

The following example shows sample output for the verbose option for a particular CM:

Router# show cable modem 0018.6835.2987 privacy verbose 
MAC Address             : 0018.6835.2987
Primary SID             : 10
BPI Mode                : BPI+
BPI State               : assign(tek)
Security Capabilities   :
 Encryption             : DES-56 
 EAE                    : Unsupported 
Latest Key Sequence     : 2
 Key Status             : Active
 Remaining Lifetime     : 256 sec
 Key Gracetime          : 60 sec
 Authorization Key      : 2004065504831967119C16051FD722C5209E165F
 Key Encryption Key     : F14EFC15118B6B06
 Upstream HMAC Key      : 150E3F56451F6E033DEB79BCF819A9D8EAF6B95D
 Downstream HMAC Key    : 9AA3EC8869D64927560589692CCE4C21F3DA9029
Current Key Sequence    : 2
Authorization Counters  :
 Authorization Infos     : 4
 Authorization Requests  : 2
 Authorization Replies   : 2
 Authorization Rejects   : 0
 Authorization Invalids  : 0
Traffic Key Counters     :
 Traffic Key Requests    : 4
 Traffic Key Replies     : 4
 Traffic Key Rejects     : 0
 Traffic Key Invalids    : 0
Certificate Counters      :
 Untrusted Manufacturer   : 0
 Untrusted CM Certificate : 0
 Issuer Not Found         : 0
 Invalid Signature        : 0
 Expired Certificate      : 0
 Certificate Not Activated: 0
 Certificate in Hotlist   : 0
 Public Key Mismatch      : 0
 Invalid MAC              : 0
 Invalid CM Certificate   : 0
CA Certificate Details   :
 Certificate Serial       : 57BF2DF60E9FFBECF8E69709DE34BC26
 Certificate Self-Signed  : False
 Certificate State        : Chained
CM Certificate Details   :
 CM Certificate Serial    : 010244AF1A135202
 CM Certificate State     : Chained
KEK Reject Code         : None
KEK Reject Reason       : No Information
KEK Invalid Code        : None
KEK Invalid Reason      : No Information
Primary SID Information   :
SID                     : 10   
Encryption Algorithm    : 56-bit DES
Latest Sequence Number  : 5
 Key Status             : Active
 Remaining Lifetime     : 106 sec
 Key Gracetime          : 60 sec
 Hardware Keys Match    : True
 DES Key                : 156819BF016E139B
 DES IV                 : 07291CAE15AD0845
Current Sequence Number : 4
 Key Status             : Active
 Remaining Lifetime     : 16 sec
 Key Gracetime          : 60 sec
 Hardware Keys Match    : True
 DES Key                : 23EF1C9801F40EE3
 DES IV                 : 163D19831AFB25DC
TEK Requests            : 4
TEK Replies             : 4
TEK Rejects             : 0
TEK Invalids            : 0
TEK Receive Errors      : 0
TEK Reject Code         : None
TEK Reject Reason       : No Information
TEK Invalid Code        : None
TEK Invalid Reason      : No Information

Table 32 describes the major fields shown in the show cable modem privacy command display:

Table 32 show cable modem privacy Field Descriptions 

Field
Description

MAC Address

MAC address for the CM.

Prim SID

Primary SID assigned to the CM.

BPI Mode

Baseline Privacy Interface (BPI) mode used.

BPI State

Displays the BPI state.

Security Capabilities

Security capabilities of the modem like encryption algorithm and Early Authentication and Encryption (EAE).

Encryption

Encryption method used.

EAE

EAE support.

Latest Key Sequence

Latest key sequence number.

Key Status

Status of the key; whether active or not.

Remaining Lifetime

Remaining lifetime of the key in seconds.

Key Gracetime

Grace time available for the key in seconds.

Authorization Key

Authorization key code.

Key Encryption Key

Key used to encrypt the traffic key.

Upstream HMAC Key

Upstream Hashed Message Authentication Code (HMAC) key.

Downstream HMAC Key

Downstream Hashed Message Authentication Code (HMAC) key.

Current Key Sequence

Current key sequence number.

Authorization Counters

Authorization counter information.

Authorization Infos

Authorization information.

Authorization Requests

Number of authorized requests.

Authorization Replies

Number of authorized replies.

Authorization Rejects

Rejected authorization.

Authorization Invalids

Invalid authorization.

Traffic Key Counters

Traffic key counter informayion.

Traffic Key Requests

Number of traffic key requests.

Traffic Key Replies

Number of traffic key replies.

Traffic Key Rejects

Number of traffic key rejects.

Traffic Key Invalids

Number of invalid traffic keys.

Certificate Counters

Certificate counter information.

Untrusted Manufacturer

Count of untrusted manufacturers.

Untrusted CM Certificate

Count of untrusted CM certificates.

Issuer Not Found

Count of certificate issuers not found in the database.

Invalid Signature

Count of invalid signatures.

Expired Certificate

Number of expired certificates.

Certificate Not Activated

Count of certificates not activated.

Certificate in Hotlist

Number of certificates in hotlist.

Public Key Mismatch

Number of public key mismatch.

Invalid MAC

Number of invalid MACs.

Invalid CM Certificate

Number of invalid CM certificates.

CA Certificate Details

CA certificate information.

Certificate Serial

CA certificate serial number.

Certificate Self-Signed

Self-signed CA certificate.

Certificate State

Current state of the CA certificate.

CM Certificate Details

CM certificate information.

CM Certificate Serial

CM certificate serial number.

CM Certificate State

Current state of the CM certificate.

KEK Reject Code

Key Encryption Key (KEK) reject code.

KEK Reject Reason

KEK reject reason.

KEK Invalid Code

KEK invalid code.

KEK Invalid Reason

Reason for the invalid KEK.

Primary SID Information

Primary SID assigned to this CM.

SID

SID used by the CM.

Encryption Algorithm

Encryption algorithm used.

Latest Sequence Number

Latest sequence number.

Current Sequence Number

Current sequence number.

Hardware Keys Match

Hardware key match.

DES Key

Data Encryption Standard (DES) key number.

DES IV

Initialization vector. This can be AES or DES.

TEK Requests

Displays the number of Traffic Exchange Key (TEK) requests.

TEK Replies

Number of TEK requests.

TEK Rejects

Number of TEK rejects.

TEK Invalids

Number of invalid TEKs.

TEK Receive Errors

Number of TEK receive errors.

TEK Reject Code

TEK reject code.

TEK Reject Reason

TEK reject reason.

TEK Invalid Code

TEK invalid code.

TEK Invalid Reason

TEK invalid reason.


Related Commands

Command
Description

cable privacy

Enables and configures BPI+ encryption on a cable interface.

cable privacy kek

Sets KEK and timeout periods.

cable privacy tek

Sets TEK and timeout periods.

show cable privacy

Displays information about BPI status and operation.


show cable modem qos

To display the quality of service (QoS) and service flow information for a particular cable modem (CM), use the show cable modem qos command in privileged EXEC mode.

show cable modem {ip-address | mac-address | name fqdn} qos [service-class | verbose]

Syntax Description

ip-address

IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

service-class

(Optional) Displays the service class names associated with each service flow for a specific cable modem.

verbose

(Optional) Displays detailed information for each service flow ID (SFID) for the CM.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

11.3XA

This command was introduced.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

12.2(33)SCC

The command output was modified to display the traffic peak rate value for a specific service flow.

12.2(33)SCF

This command was modified. The service-class keyword was added to display the service class names for each service flow for a specific cable modem.


Usage Guidelines

This command displays the service flows currently in use by a CM. The default form of the display shows one service flow per line, while the verbose form displays complete information for each flow.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


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.


Examples

Example of the show cable modem qos Command for a Cable Modem Specified by MAC Address

The following example is a sample output of the show cable modem qos command for a specific CM identified by its MAC address:

Router# show cable modem 0010.7bb3.fcd1 qos 
Sfid  Dir Curr  Sid   Sched  Prio MaxSusRate  MaxBrst   MinRsvRate  Throughput 
          State       Type
3     US  act   1     BE     7    2000000     1522      100000      0          
4     DS  act   N/A   BE     0    4000000     1522      0           0          

Example of the show cable modem qos Command for a Cable Modem Specified by IP Address

The following example is a sample output of the show cable modem qos command for a specific CM identified by its IP address:

Router# show cable modem 22.1.1.10 qos 
Sfid  Dir Curr  Sid   Sched  Prio MaxSusRate  MaxBrst   MinRsvRate  Throughput 
          State       Type
7     US  act   3     BE     0    0           3044      0           0          
9     US  act   4     BE     0    1000000     65224     0           0          
10    US  act   5     BE     0    1000000     65224     0           0          
8     DS  act   N/A   BE     0    0           3044      0           0          

Example of the show cable modem qos verbose Command for a Cable Modem Specified by IP Address

The following example is a sample output for the verbose form of the show cable modem qos command for a specific CM identified by its IP address:

Router# show cable modem 22.1.1.10 qos verbose 
Sfid                                    : 7
Current State                           : Active
Sid                                     : 3
Traffic Priority                        : 0
Maximum Sustained rate                  : 0 bits/sec
Maximum Burst                           : 3044 bytes
Mimimum Reserved rate                   : 0 bits/sec
Minimum Packet Size                     : 64 bytes
Admitted QoS Timeout                    : 200 seconds
Active QoS Timeout                      : 0 seconds
Maximum Concatenated Burst              : 1522 bytes
Scheduling Type                         : Best Effort
Request/Transmission policy             : 0x0
IP ToS Overwrite[AND-mask, OR-mask]     : 0xFF, 0x0
Current Throughput                      : 0 bits/sec, 0 packets/sec
Sfid                                    : 9
Current State                           : Active
Sid                                     : 4
Traffic Priority                        : 0
Maximum Sustained rate                  : 1000000 bits/sec
Maximum Burst                           : 65224 bytes
Mimimum Reserved rate                   : 0 bits/sec
Minimum Packet Size                     : 64 bytes
Admitted QoS Timeout                    : 0 seconds
Active QoS Timeout                      : 0 seconds
Maximum Concatenated Burst              : 1522 bytes
Scheduling Type                         : Best Effort
Request/Transmission policy             : 0x0
IP ToS Overwrite[AND-mask, OR-mask]     : 0xFF, 0x0
Current Throughput                      : 0 bits/sec, 0 packets/sec
Sfid                                    : 10
Current State                           : Active
Sid                                     : 5
Traffic Priority                        : 0
Maximum Sustained rate                  : 1000000 bits/sec
Maximum Burst                           : 65224 bytes
Mimimum Reserved rate                   : 0 bits/sec
Minimum Packet Size                     : 64 bytes
Admitted QoS Timeout                    : 0 seconds
Active QoS Timeout                      : 0 seconds
Maximum Concatenated Burst              : 1522 bytes
Scheduling Type                         : Best Effort
Request/Transmission policy             : 0x0
IP ToS Overwrite[AND-mask, OR-mask]     : 0xFF, 0x0
Current Throughput                      : 0 bits/sec, 0 packets/sec
Sfid                                    : 8
Current State                           : Active
Sid                                     : N/A
Traffic Priority                        : 0
Maximum Sustained rate                  : 0 bits/sec
Maximum Burst                           : 3044 bytes
Mimimum Reserved rate                   : 0 bits/sec
Minimum Packet Size                     : 64 bytes
Admitted QoS Timeout                    : 200 seconds
Active QoS Timeout                      : 0 seconds
Maximum Latency                         : 0 usecs
Current Throughput                      : 0 bits/sec, 0 packets/sec

The following example is a sample output for the verbose form of the show cable modem qos command indicating the traffic peak rate value for a specific service flow.

Router# show cable modem 22.1.1.10 qos verbose 
Sfid                                    : 40
Current State                           : Active
Sid                                     : 35
Traffic Priority                        : 4
Maximum Sustained rate                  : 20000000 bits/sec
Maximum Burst                           : 20000000 bytes
Minimum Reserved rate                   : 0 bits/sec
Minimum Packet Size                     : 0 bytes
Admitted QoS Timeout                    : 200 seconds
Active QoS Timeout                      : 0 seconds
Maximum Concatenated Burst              : 65535 bytes
Scheduling Type                         : Best Effort
Request/Transmission policy             : 0x0
IP ToS Overwrite[AND-mask, OR-mask]     : 0xFF, 0x0
Peak Rate                               : 50000000 bits/sec
Current Throughput                      : 0 bits/sec, 0 packets/sec 

Example of the show cable modem qos service-class Command for a Cable Modem in Cisco IOS Release 12.2(33)SCF

The following example is a sample output of the service-class option of the show cable modem qos command for a specific CM identified by its IP address:

Router# show cable modem 22.1.1.10 qos service-class
Sfid  Dir Sched  MaxSusRate  MaxBrst     MinRsvRate  SrvClassName
          Type
33    US  BE     0           3044        0           us_srvclass_ts1
35    US  BE     0           3044        0           us_srvclass_ts2
34    DS  BE     0           3044        0           ds_srvclass_ts1
36    DS  BE     0           3044        0           ds_srvclass_ts2

Table 33 describes the major fields shown in the show cable modem qos displays:

Table 33 Descriptions for the show cable modem qos Fields 

Field
Description

Sfid

Identifies the Service Flow ID (SFID) for this service flow.

Dir

Identifies whether the service flow applies to the downstream (DS) or upstream (US) direction.

Curr State

Current State—Identifies the current state of the service flow: Active or Inactive.

Sid

Identifies the Service ID (SID) associated with this SFID.

Sched Type

Identifies this service flow's scheduling type:

BE—Best-Effort

NRTPS—Non-Real-Time Polling Service

RTPS—Real-Time Polling Service

RSVD—Reserved but not yet in use

UGS_AD—Unsolicited Grant Service with Activity Detection

UGS—Unsolicited Grant Service

UNDEF—Not yet defined.

Prio

Traffic priority (0 to 7) given to this service flow.

MaxSusRate

Maximum sustained rate value, in bits per second.

MaxBrst

Maximum burst value, in bytes.

MinRsvRate

Minimum reserved rate, in bits per second.

Throughput

Current Throughput for this service flow, in packets per second.

SrvClassName

Service class name associated with this service flow.

Minimum Packet Size

Assumed minimum reserved rate packet size on this service flow, in bytes.

Admitted QoS Timeout

Timeout for admitted QoS parameters, in seconds, which specifies the length of time that the CMTS must reserve resources for a service flow's admitted Qos parameter set, when they exceed the resources allowed by the active QoS parameter set.

Active QoS Timeout

Timeout for active Qos parameters, in seconds, which specifies the maximum amount of time that resources can remained unused on an active service flow.

Maximum Latency

Maximum downstream latency allowed for packets using this service flow, in microseconds.


Related Commands

Command
Description

cable qos permission

Specifies permission for updating the cable router QoS table.

cable qos profile

Configures a QoS profiles.

cable service-flow inactivity-timeout

Sets the amount of time a dynamic service-flow can be present in the system without any activity.

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem access-group

Displays the access groups for the CMs on a particular cable interface.

show cable modem calls

Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.

show cable modem classifiers

Displays information about the classifiers for a particular CM.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem registered

Displays a list of the CMs that are marked as registered with the Cisco CMTS router.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modem unregistered

Displays a list of the CMs that are marked as unregistered with the Cisco CMTS router.

show cable modulation-profile

Displays modulation profile group information.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable qos paramset

Displays the DOCSIS 1.1 QoS parameter sets.

show interface cable sid

Displays cable interface information.

show cable qos profile

Displays quality-of-service (QoS) profiles for a Cisco CMTS router.


show cable modem registered

To display a list of the cable modems (CMs) that have registered with the Cisco CMTS, use the show cable modem registered command in privileged EXEC mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] registered

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] registered

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

logical-channel-index

(Optional) Displays the logical channel index. Valid values are 0 and 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

registered

Displays a list of the cable modems that have registered with the Cisco CMTS.


Defaults

Displays a list of all registered CMs on the Cisco CMTS router.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

11.3 NA

This command was introduced.

12.2(4)BC1

Support for the Cisco uBR10012 router was introduced.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

The alignment of output fields has been changed.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


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.



Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


Examples

Example in Cisco IOS Release 12.2(33)SCA

The following example shows sample output for the default form of the show cable modem registered command in Cisco IOS Release 12.2(33)SCA:

Router# show cable modem registered
Interface Prim Online       Timing  Rec   QoS CPE IP address      MAC address
          Sid  State        Offset Power
C3/0/U0   1    online(pt)   2024    0.00  5  0   10.74.1.60      0000.cadb.0bae
C3/0/U0   2    online(pt)   2032    0.00  5  0   10.74.1.58      0000.cadb.0512
C3/0/U0   3    online(pt)   2024    0.50  5  0   10.74.1.61      0000.cadb.04b2
C3/0/U0   4    online(pt)   3079    0.00  5  0   10.74.1.48      0003.e3a6.7f71
C3/0/U0   5    online(pt)   2558    -1.00 5  0   10.74.1.50      0010.7b6b.77ed
C3/0/U0   6    online(pt)   3083    -0.50 5  0   10.74.1.42      0030.80bc.22b9

Examples in Cisco IOS Release 12.3BC

The following example shows sample output for the default form of the show cable modem registered command.

Router# show cable modem registered 
Interface   Prim Online    Timing Rec    QoS CPE IP address      MAC address
            Sid  State     Offset Power
Cable3/0/U0 1    online     2812   -0.25  5   1   10.18.1.5       0030.80bc.2303
Cable3/0/U0 2    online     2804    0.50  5   0   10.18.1.9       0006.2854.73f5

The following example shows sample output for the show cable modem registered command for a particular cable interface:

Router# show cable modem c8/1/0 registered 
Interface Prim Online      Timing Rec     QoS CPE IP address      MAC address
          Sid  State       Offset Power
C8/1/0/U1 1    online       1548   0.00   5   0   10.1.1.11       0050.7366.1243
C8/1/0/U4 2    online       1925   0.00   5   0   10.1.1.10       0002.b970.0027
C8/1/0/U4 3    online       1918   -0.50  2   0   10.1.1.10       0006.5314.858d

The following example shows sample output for the show cable modem registered command for a single CM, as identified by its IP address:

Router# show cable modem 22.1.1.10 registered 
Interface Prim Online      Timing Rec     QoS CPE IP address      MAC address
          Sid  State       Offset Power
C8/1/0/U4 3    online       1918   -0.75  2   0   10.1.1.10       0006.5314.858d

The following example shows sample output for the show cable modem registered command for a single CM, as identified by its MAC address:

Router# show cable modem 0006.5314.858d registered 
Interface Prim Online      Timing Rec     QoS CPE IP address      MAC address
          Sid  State       Offset Power
C8/1/0/U4 3    online       1918   -0.25  2   0   10.1.1.10       0006.5314.858d

Note An asterisk (*) in the Receive Power column indicates that a power adjustment has been made for that CM. An exclamation point (!) in the Receive Power column indicates that the CM has reached its maximum power transmit level and cannot increase its power level further. An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command.

A pound sign (#) in the MAC State column indicates that the cable tftp-enforce mark-only command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so (Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases).



Tip The show cable modem command displays the CM timing offset in DOCSIS ticks, while other commands, such as cable map-advance, display the offset in microseconds. Use the following method to convert microseconds to DOCSIS ticks: ticks = microseconds*64/6.25.


Table 34 describes the major fields shown in the show cable modem registered displays:

Table 34 Descriptions for the show cable modem registered Fields 

Field
Description

Interface

The cable interface line card providing the upstream for this CM.

Prim SID

The primary SID assigned to this CM.

Online State

The current state of the MAC layer. Should show "online" for registered CMs.

Timing Offset

The timing offset for the CM, in ticks, as recognized on the CMTS. (A tick, as used here, is 6.25/64 microseconds.) This is the delay between when a particular cable modem is scheduled to make a transmission and when the CMTS actually receives it.

Note An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command.

Note The timing offset shown here is typically smaller than the TX Time Offset value shown by the show cable modem remote-query command, because the latter value is the offset as recognized on the CM (which will include any internal delay between when the CM software begins the transmission and when the bits actually appear on the local cable interface).

Rec Power

The received power level (in dB) for the CM.

Note An asterisk (*) in the RxPwr column indicates that a power adjustment has been made for that CM. An exclamation point (!) indicates that the CM has reached its maximum power transmit level and cannot increase its power level further.

QoS

Displays the QoS profile assigned to the CM (DOCSIS 1.1 and DOCSIS 2.0 CMs only).

CPE

Indicates the number of CPE devices for which the CM is providing services.

IP Address

The IP address that the DHCP server has assigned to the CM.

MAC Address

The MAC address for the CM.


Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem access-group

Displays the access groups for the CMs on a particular cable interface.

show cable modem calls

Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.

show cable modem classifiers

Displays information about the classifiers for a particular CM.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem cpe

Displays the CPE devices accessing the cable interface through a particular CM.

show cable modem offline

Displays a list of the CMs that are marked as offline with the Cisco CMTS.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show cable modem unregistered

Displays a list of the CMs that are marked as unregistered with the Cisco CMTS.

show cable modem vendor

Displays the vendor name or Organizational Unique Identifier (OUI) for the CMs on each cable interface.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem remote-query

To display information collected by the remote-query feature, use the show cable modem remote-query command in privileged EXEC mode.

show cable modem remote-query

Syntax Description

This command has no keywords or arguments.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(7)XR, 12.1(2)T

This command was introduced.

12.1(2)EC1

Support for this command was added to the 12.1 EC train.

12.2(4)BC1b

Support for this command was added to the 12.2 BC train.

12.3(23)BC

Support was added for displaying status of modems during an SNMP request.


Usage Guidelines

This command shows the statistics collected when the remote-query feature has been enabled and configured by the cable modem remote-query command.

Note In Cisco IOS Release 12.1 CX, Cisco IOS Release 12.2 BC, and later, use the show cable modem phy command instead of the show cable modem remote-query command.


Tip The information shown by this command can also be displayed by querying the attributes in the CISCO-DOCS-REMOTE-QUERY-MIB.



Note Also see the information about this command's behavior in a Hot Standby Connection-to-Connection Protocol (HCCP) configuration, see the "Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration" section.


Examples

The following example shows typical output from the show cable modem remote-query command. In this example, the final CM (IP address of 10.200.71.2) has not been configured with an SNMP community string that allows access to the remote-query feature.

Router# show cable modem remote-query 
Remote Query Polling State : Active 
     IP address      MAC address     S/N    US     DS    Tx Time  Micro (dB) Modem 
                                    Ratio  Power  Power Offset   Reflection  State 
     10.200.71.8     0001.9659.47af  36.6   31.0    0.0  12352     17        online 
     10.200.71.4     0001.9659.47c7  36.6   37.0    0.0  12352     17        online 
     10.200.71.6     0001.9611.b9a3  36.6   37.0    0.0  12353     15        online 
     10.200.71.3     0001.9659.47a9  36.6   37.0    0.0  12351     16        online 
     10.200.71.2     0001.9659.47c1   0.0    0.0    0.0  0         0         online 

In the following example, the SNMP Request column shows cable modems being offline when an SNMP request using the cable modem remote query command is not received. The modems are either offline or are not responding to the SNMP request.

Router# show cable modem remote-query
Remote Query Polling State : Inactive
IP address      MAC address     S/N    US     DS    Tx Time SNMP
                                Ratio  Power  Power Offset  Request
80.51.1.4       0018.f826.3453   0.0    0.0    0.0  0        CM offline
80.51.1.2       000c.e5f6.0c40   0.0    0.0    0.0  0        CM offline
80.51.1.8       0019.474a.d4fe   0.0    0.0    0.0  0        CM offline
80.51.1.3       0018.6852.82fa   0.0    0.0    0.0  0        CM offline
80.51.1.5       0019.474a.c1ae   0.0    0.0    0.0  0        CM offline

Table 0-35 shows the fields displayed by the show cable modem remote-query command.

Table 0-35 Descriptions for the show cable modem remote-query Fields 

Field
Description

IP Address

The IP address that the DHCP server has assigned to the CM.

MAC Address

The MAC address for the CM.

S/N Ratio

The current signal-to-noise ratio (SNR) on the downstream, as seen by the CM.

US Power

The current operational transmit power level, in dBmV, as seen by the CM.

DS Power

The received power level, in dBmV, as seen by the CM. This field is set to zero if the CM does not support power level measurements.

TX Time Offset

The timing offset for the CM, in ticks, as recognized on the CM. (A tick, as used here, is 6.25/64 microseconds.) This is the delay between when a particular cable modem is scheduled to make a transmission and when the CMTS actually receives it. The CM value includes any internal delay between when the CM software begins the transmission and when the bits actually appear on the local cable interface.

Note The timing offset shown here is typically larger than the Time Offset value shown by the show cable modem command, because the latter value is the offset as recognized on the CMTS (which does not include the internal delay on the CM).

Micro (dB) Reflection

The approximate number of total microreflections (including in-channel responses) on the downstream, measured in dBc below the signal level, as seen by the CM. Microreflections are a type of impairment that is caused by impedance mismatches between amplifiers, couples, cables, and other equipment in the cable plant. Microreflections create copies of a signal that arrive at the receiver with different amounts of delay and attenuation, generating intersymbol interference (ISI) that can cause the receiver to improperly detect the amplitude and phase of the incoming signal.

Note This value is not exact but provides an approximate indication of the microreflections that have been received.

Modem State

The current state of the MAC layer for the CM (see Table 23).


The following example shows typical output from the show cable modem remote-query command.

Router# show cable modem remote-query 
IP address      MAC address     S/N    US     DS    Tx Time Micro (dB) Modem
                                Ratio  Power  Power Offset  Reflection State
10.118.4.194    0007.0e04.5ba9  33.4   42.3  - 1.0  8794    1         online
10.118.4.156    0003.6b1b.e8c9  34.0   44.0  - 1.0  8795    3         online(d)
Router#

The following example shows typical output from the show cable modem remote-query command when the remote-query feature has not been configured.

Router# show cable modem remote-query 
Remote Query Polling State : Inactive
IP address      MAC address     S/N    US     DS    Tx Time  Micro (dB) Modem 
                               Ratio  Power  Power Offset   Reflection  State 
10.200.71.8     0001.9659.47af   0.0    0.0    0.0  0         0         online
10.200.71.4     0001.9659.47c7   0.0    0.0    0.0  0         0         online
10.200.71.6     0001.9611.b9a3   0.0    0.0    0.0  0         0         online
10.200.71.3     0001.9659.47a9   0.0    0.0    0.0  0         0         online
10.200.71.2     0001.9659.47c1   0.0    0.0    0.0  0         0         online 
10.200.71.10    00d0.5904.5321   0.0    0.0    0.0  0         0         offline
10.200.71.11    0050.f112.5123   0.0    0.0    0.0  0         0         offline
Router#

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 modem remote-query

Enables and configures the remote-query feature to gather CM performance statistics on the CMTS.

debug cable remote-query

Turns on debugging to gather information from remote CMs.

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

snmp-server enable traps cable

Enables traps that are sent when the remote polling of CMs has been completed.


show cable modem rf-adapt

To display RF adaptation relocation history for cable modems, use the show cable modem rf-adapt command in privileged EXEC mode.

show cable modem [mac-address | cable {slot/cable-interface-index | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] ] rf-adapt [verbose]

Syntax Description

mac-address

(Optional) MAC address of a specific cable modem to be displayed. If you specify the MAC address for a CPE device behind a cable modem, information for that cable modem is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

rf-adapt

Displays RF adaptation information.

verbose

Displays detailed information for the cable modems.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCF

This command was introduced.


Examples

The following is a sample output of the show cable modem rf-adapt command:

Router# show cable modem rf-adapt

MAC Address     Downgrade Upgrade Primary      Last   Last Action       
                Count     Count   Upstream     Action Time         
0019.474a.d4cc  1         0       C8/0/1/U3.0  D      Jun 25 22:10:22
0019.474a.d554  1         1       C8/0/14/U0.0 U      Jun 25 22:10:22
0019.474a.d542  2         1       C8/0/0/U0.0  D      Jun 25 22:10:22
0019.474a.d508  1         1       C8/0/8/U0.0  U      Jun 25 22:10:23
0025.2e2d.7400  1         0       C8/0/0/U1.0  D      Jun 25 22:10:23
0022.cea4.f404  1         1       C8/0/2/U2.0  U      Jun 25 22:10:23
Router# show cable modem 001e.6bfb.2d3c rf-adapt
MAC Address     Downgrade  Upgrade  Primary         Last     Last Action
                Count      Count    Upstream        Action   Time 
001e.6bfb.2d3c  1          0        Ca6/1/0/U0.0    D        Mar 7  05:12:37
Router# show cable modem 0025.2e2d.7990 rf-adapt verbose
Action          Action  Source        Destination   Action
Time            Type    Upstream      Upstream      Reason
Mar 9 23:03:08  D       Ca7/0/0/U0.0  Ca7/0/0/U0.1  SNR 26<28 
Mar 9 21:50:05  U       Ca7/0/0/U0.1  Ca7/0/0/U0.0  SNR 31>=31 
Mar 9 21:37:02  D       Ca7/0/0/U0.0  Ca7/0/0/U0.1  SNR 26<28 
Mar 9 20:45:59  U       Ca7/0/0/U0.1  Ca7/0/0/U0.0  SNR 32>=31 
Mar 9 20:36:56  D       Ca7/0/0/U0.0  Ca7/0/0/U0.1  SNR 27<28 

Table 5 describes the significant fields shown in the display:

Table 36 show cable modem Field Descriptions 

Field
Description

MAC Address

MAC address of the cable modem.

Downgrade Count

Number of times the cable modem was relocated from the primary to the secondary logical upstream channel.

Upgrade Count

Number of times the cable modem was relocated from the secondary to the primary logical upstream channel.

Primary Upstream

The primary logical upstream at the time of the relocation event.

Last Action

Last action performed on the cable modem; indicates whether the cable modem was downgraded or upgraded.

Last Action Time

Date and time when the last action was performed on the cable modem.

Action Time

Date and time when the action was performed on the cable modem.

Action Type

Upgrade or downgrade.

Source Upstream

Upstream logical channel from where the cable modem is moved.

Destination Upstream

Upstream logical channel to where the cable modem is moved.

Action Reason

Reason for the relocation of the cable modem.


Related Commands

Command
Description

cable rf-adapt timer

Configures timers for RF adaptation.

cable upstream rf-adapt

Enables RF adaptation on the physical upstream channel.

cable upstream rf-adapt (logical channel)

Configures the primary upstream logical channel and secondary upstream logical channel.

cable upstream threshold

Configures the upstream for the signal-to-noise ratio (SNR) and forward error correction (FEC) threshold values to be used in determining the allowable noise levels.

cable upstream threshold hysteresis

Configures the hysteresis value to be used in conjunction with the dynamic modulation upgrade thresholds.

cable upstream threshold rf-adapt

Configures the upstream RF adaptation threshold value, which prevents excessive relocation of modems from the primary upstream channel to the secondary upstream channel.

show cable modem

Displays information for the registered and unregistered cable modems.

show cable modem phy

Displays the DOCSIS PHY layer information for one or more cable modems.

show cable modulation-profile

Displays modulation profile group information.

show cable rf-adapt

Displays the downgrade and upgrade candidate lists.

show interface cable modem

Displays information about the cable modems connected to a particular cable interface.


show cable modem rogue

To display a list of cable modems that have been marked, locked, or rejected because they failed the dynamic shared-secret authentication checks, use the show cable modem rogue command in privileged EXEC mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] rogue

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] rogue

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.

rogue

Displays a list of cable modems that have been marked, locked, or rejected.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(15)BC1

This command was introduced for Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 routers.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

This command displays a list of cable modems that attempted to register with a DOCSIS configuration file that does not pass the authentication required by the cable dynamic-secret command. After a cable modem is added to the rogue list, it remains in the rogue list until one of the following occurs:

The cable modem remains offline, without attempting to reregister, for 24 hours. It is then removed from all of the CMTS internal databases, including the rogue list.

An administrator manually deletes the cable modem from the CMTS internal databases, using the clear cable modem delete command.

An administrator unlocks the cable modem using the clear cable modem lock command.


Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


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.


Examples

The following sample output from the show cable modem rogue command.

Router# show cable modem rogue 
                                     Spoof TFTP
MAC Address    Vendor     Interface  Count Dnld Dynamic Secret
AAAA.7b43.aa7f Vendor1    C4/0/U5       2  Yes  45494DC933F8F47A398F69EE6361B017 
AAAA.7b43.aa7f Vendor1    C4/0/U5       2  Yes  D47BCBB5494E9936D51CB0EB66EF0B0A 
BBBB.7b43.aa7f Vendor2    C4/0/U5       2  No   8EB196423170B26684BF6730C099D271 
AAAA.7b43.aa7f Vendor1    C4/0/U5       2  No   DF8FE30203010001A326302430120603 
BBBB.7b43.aa7f Vendor2    C4/0/U5       2  No   300E0603551D0F0101FF040403020106 
AAAA.7b43.aa7f Vendor1    C4/0/U5       2  Yes  820101002D1A264CE212A1BB6C1728B3 
DDDD.7b43.aa7f Vendor4    C4/0/U5       2  Yes  7935B694DCA90BC624AC92A519C214B9 
AAAA.7b43.aa7f Vendor1    C4/0/U5       2  No   3AB096D00D56ECD07D9B7AB662451CFF 
Router# 

Table 0-37 describes the fields shown by the show cable modem rogue command.

Table 0-37 show cable modem Field Descriptions 

Field
Description

MAC Address

The MAC address for the CM.

Vendor

Vendor name for this cable modem, as configured using the cable modem vendor command.

Interface

The cable interface line card providing the upstream for this CM.

Spoof Count

Number of times that this cable modem has attempted to register with an invalid dynamic shared-secret value.

Note To account for possible network problems, such as loss of packets and congestion, the Cisco CMTS will allow a cable modem to attempt to register twice before marking it as having failed the dynamic shared-secret authentication checks.

TFTP Dnld

Whether TFT downloads are enforced, as configured by the cable tftp-enforce command.

Dynamic Secret

The dynamic shared-secret for this cable modem.


Related Commands

Command
Description

cable dynamic-secret

Enables the Dynamic Shared Secret feature, so that DOCSIS configuration files are verified with a Message Integrity Check (MIC) that has been created with a dynamically generated shared secret.

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

cable shared-secondary-secret

Configures one or more secondary shared secret keys that CMs can use to successfully process the DOCSIS configuration file and register with the CMTS.

cable shared-secret

Configures an authentication shared secret key that CMs must use to successfully process the DOCSIS configuration file and register with the CMTS.

cable tftp-enforce

Requires that all CMs on a cable interface attempt to download a DOCSIS configuration file using the Trivial File Transfer Protocol (TFTP) through the cable interface before being allowed to register and come online.

clear cable modem lock

Resets the lock on one or more CMs, and reinitializes them, so that they can reregister with a valid DOCSIS configuration file.

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays the SID information for a CM.


show cable modem service-type-id

To display the modems having the service type id, use the show cable modem service-type-id command in privileged EXEC mode.

show cable modem service-type-id [service-type-id]

Syntax Description

service-type-id

Specifies the name of the service type identifier.


Command Default

If no service type identifier is specified, this command will show all the CMs with their respective service-type-id.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCB

This command was introduced.


Usage Guidelines

This command shows CMs having specified service-type-id.

Examples

The following example shows sample output for the show cable modem service-type-id command:

Router# show cable modem service-type-id
                                                                             B D
MAC Address    IP Address      I/F       MAC         Prim Service-type-id    P I
                                         State       Sid                     I P
0018.6812.29ae 41.42.2.212    C6/1/4/U2 offline      3838 commercial         N N
0018.6811.f9f8 41.42.0.140    C6/1/4/U2 offline      3225 commercial         N N
0018.6811.fba6 41.42.5.169    C6/1/4/U2 offline      3439 commercial         N N
0018.6812.225a 41.42.3.210    C6/1/4/U2 offline      3355 commercial         N N
0018.6811.fa8c 41.42.1.133    C6/1/4/U2 offline      3091 commercial         N N
0018.6812.37e8 41.42.0.136    C6/1/4/U2 offline      7439 commercial         N N
0018.6811.fbca 41.42.2.255    C6/1/4/U2 offline      6263 commercial         N N
0018.6811.fb44 41.42.2.17     C6/1/4/U2 offline      2996 commercial         N N
0018.6812.2f20 41.42.0.100    C6/1/4/U2 offline      3544 commercial         N N

Table 38 describes the significant fields shown in the display.

Table 38 show cable modem service-type-id Field Descriptions 

Field
Description

MAC Address

Hardware (MAC-layer) address of the cable modem or CPE device.

IP Address

IP address of the cable modem or CPE device.

I/F

The cable interface line card providing the upstream for this CM.

MAC State

The current state of the MAC layer.

Prim Sid

Primary Service ID (SID) of the device.

Service Type Id

Service Type identifier.

BPI

Indicates whether or not Baseline Privacy Interface (BPI) or BPI Plus (BPI+) encryption is enabled for the CM.

DIP

Dual IP flag. Identifies whether or not ("Y" or "N") the CM or CPE supports both IPv4 and IPv6 addressing.


Related Commands

Command
Description

clear cable modem service-type-id

This command clears the cable modem service type id.


show cable modem service-flow

To display information about all service flows associated with a particular modem, use the show cable modem service-flow command in privileged EXEC mode.

show cable modem {ip-address | mac-address} service-flow [verbose | ds-hardware]

Syntax Description

ip-address

Specifies the IPv4 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

Identifies the MAC address of a specific CM to be displayed. You can also specify the MAC address for a CPE device behind a CM, and information for that CM will be displayed.

service-flow

Displays summary of relevant parameters and statistics for all service flows associated with a particular modem.

verbose

(Optional) Displays comprehensive details for all service flows associated with a particular modem.

ds-hardware

(Optional) Displays details of Baseline Privacy Interface (BPI), Payload Header Suppression (PHS), Downstream Service Identifier (DSID) and other statistical data.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCB1

This command was introduced for Cisco uBR7200 series and Cisco uBR10012 routers in Cisco IOS Release 12.2(33)SCB1.

12.3(23)BC7

This command was integrated into Cisco IOS Release 12.3(23)BC7.

12.2(33)SCE

This command was modified. The ds-hardware keyword was added.

12.2(33)SCF2

This command was modified. The command output was enhanced to display upstream buffer control parameters.


Usage Guidelines

The show cable modem service-flow command has a verbose and a non-verbose option. The non-verbose command supports live debugging and provides a summary of relevant parameters and statistics for all service flows of a particular modem. The verbose option of the command provides comprehensive details for all service flows associated with a particular modem.

The optional ds-hardware keyword is used to display per service flow BPI, PHS, DSID and stats data obtained directly from the hardware on the line card or SPA.


Note The output data for unconfigured or non applicable features are not always displayed.


Examples

The following is a sample output of the show cable modem service-flow command without the verbose option:

Router# show cable modem 40.30.0.5 service-flow
SUMMARY:
MAC Address    IP Address      Host      MAC          Prim  Num  Primary    DS
                               Interface State        Sid   CPE  Downstream RfId
001a.c30c.7eec 40.30.0.5       C7/0/0/U0 online       15    0    C7/0/0     Local
Sfid  Dir Curr  Sid   Sched  Prio MaxSusRate  MaxBrst   MinRsvRate  Throughput
          State       Type
31    US  act   15    BE     0    0           3044      0           0
32    DS  act   N/A   BE     0    0           3044      0           0
UPSTREAM SERVICE FLOW DETAIL:
SFID  SID   Requests   Polls      Grants     Delayed    Dropped    Packets
                                             Grants     Grants
31    15    0          0          0          0          0          0
DOWNSTREAM SERVICE FLOW DETAIL:
SFID  RP_SFID QID    Flg Policer               Scheduler             FrwdIF
                         Xmits      Drops      Xmits      Drops
32    32817   131124     0          0          0          0          Ca7/0/0
Flags Legend:
$: Low Latency Queue (aggregated)
~: CIR Queue
The following is a sample output of the show cable modem service-flow command with the verbose 
option, for Cisco IOS Release 12.2(33)SCF2:
Router# show cable modem 0022.cea5.02ba service-flow verbose
SUMMARY:
MAC Address    IP Address      Host          MAC           Prim  Num Primary
DS
                               Interface     State         Sid   CPE Downstrea
RfId
0022.cea5.02ba 5.60.122.132    C7/1/0/UB     w-online      10    0   In7/1/0:0
840
Sfid  Dir Curr  Sid   Sched  Prio MaxSusRate  MaxBrst     MinRsvRate  Throughp
          State       Type
29    US  act   10    BE     0    100000      3044        0           0
30    DS  act   N/A   BE     0    200000      3044        0           0
CfrId  SFID     CM Mac Address  Direction  State    Priority  Matches
Reg Info Requests Tx        : 2
Reg Info TLV len            : 152
UPSTREAM SERVICE FLOW DETAIL:
Sfid                                    : 29
Mac Address                             : 0022.cea5.02ba
Type                                    : Primary
Direction                               : Upstream
Current State                           : Active
Current QoS Indexes [Prov, Adm, Act]    : [3, 4, 4]
Active Time                             : 03:45
Required Attributes                     : 0x00000000
Forbidden Attributes                    : 0x00000000
Aggregate Attributes                    : 0x00000000
Sid                                     : 10
Service Class Name                      : REG-US
Traffic Priority                        : 0
Maximum Sustained rate                  : 100000 bits/sec
Maximum Burst                           : 3044 bytes
Minimum Reserved Rate                   : 0 bits/sec
Minimum Packet Size                     : 0 bytes
!Upstream Buffer Control Parameters
Minimum Buffer Size                     : 1000 bytes
Target Buffer Size                      : 1500 bytes
Maximum Buffer Size                     : 2000 bytes
Peak Rate                               : 0 bits/sec
Admitted QoS Timeout                    : 200 seconds
Active QoS Timeout                      : 0 seconds
Packets                                 : 3
Bytes                                   : 1020
Rate Limit Delayed Grants               : 0
Rate Limit Dropped Grants               : 0
Current Throughput                      : 0 bits/sec, 0 packets/sec
Application Priority                    : 0
US Bonded                               : YES
Upstream Bonding Group                  : UBG-1
Transmit Channel Set                    : 0x6
Sid Cluster                             : SC-0, Sid [ 10 10 ]
Segments Valid                          : 3
Segments Discarded                      : 0
Segments Lost                           : 0
SID Cluster Switching Information
Total Bytes Requested                   : 0
Total Time                              : 0
Outstanding Bytes                       : 0
Max Requests                            : 1
Classifiers: NONE
Sid                            : 10
Request polls issued           : 0
BWReqs {Cont,Pigg,RPoll,Other} : 4, 0, 0, 0
No grant buf BW request drops  : 0, where:0
Rate exceeded BW request drops : 0
Grants issued                  : 4
Packets received               : 4
Bytes received                 : 1488
rate-adapt                     : Disabled
rate-adapt {rcvd, Consec-PB}   : 0, 0
Fragment reassembly completed  : 0
Fragment reassembly incomplete : 0
Concatenated packets received  : 0
Queue-indicator bit statistics : 0 set, 0 granted
Good Codewords rx              : 8
Corrected Codewords rx         : 0
Uncorrectable Codewords rx     : 0
Concatenated headers received  : 0
Fragmentation headers received : 0
Fragmentation headers discarded: 0
ARP Requests Received          : 2

Examples of show cable modem service-flow ds-hardware Command Output for Various Types of Modems

The following is a sample output of the show cable modem service-flow ds-hardware command on the narrow band modem on a legacy interface:

Router# show cable modem 50.3.112.12 service-flow ds-hardware
LC SFID:15 RP SFID: 32999
KeyIndex: 6 PHSIndex: 0
TX Pkts: 9 TX Bytes: 636
BPI -
Said: 0x1 KeySeq:0x1
Even Key: 15DC474264C81500 Even Iv: 2619043723FB046B
Odd Key: 07A89421B4458B00 Odd Iv: 1FB0253D0D1C1643
PHS -
PHSM: 0000-0000-0000-0000
Ctrl: 0x0 PHSI: 0x0 PHSS: 0x0 Count: 0x0

The following is a sample output of the show cable modem service-flow ds-hardware command on the narrow band modem with a modena remote primary channel:

Router# show cable modem 50.3.112.6 service-flow ds-hardware
LC SFID:7 RP SFID: 33007 StatIndex: 13
KeyIndex: 7 PHSIndex: 0
TX Pkts: 8 TX Bytes: 592
BPI - 
KeyNum: 0x7 Control: 0xC001 KeySeq: 0x1
Even Key: 10F4-6BE1-D944-B0 Even Iv: 04B3-1CCD-25DA-163E
Odd Key: 0818-8A00-9D01-1E Odd Iv: 1C58-1967-16BC-0BD0
PHS -
PHSM: 0000-0000-0000-0000
Ctrl: 0x0 PHSI: 0x0 PHSS: 0x0 Count: 0x0

The following is a sample output of the show cable modem service-flow ds-hardware command on the wideband modem on a remote modena:

Router# show cable modem 50.3.112.28 service-flow ds-hardware
LC SFID:9 RP SFID: 33001 StatIndex: 7
KeyIndex: 4 PHSIndex: 0
TX Pkts: 13 TX Bytes: 962
DSID: 0x11E Priority: 0x0 SCC: 0 Seqnum: 0xD 
BPI - 
KeyNum: 0x4 Control: 0xC002 KeySeq: 0x1
Even Key: 01B8-5830-9246-66 Even Iv: 0BAB-1CA8-0145-1AB9
Odd Key: 0720-8C81-FD04-6F Odd Iv: 0D80-13F1-0E32-083B
PHS -
PHSM: 0000-0000-0000-0000
Ctrl: 0x0 PHSI: 0x0 PHSS: 0x0 Count: 0x0

The following is a sample output of the show cable modem service-flow ds-hardware command on the narrowband modem on an integrated interface:

Router# show cable modem 80.36.0.3 service-flow ds-hardware
LC SFID:50 RP SFID: 33150 StatIndex: 21
KeyIndex: 8 PHSIndex: 0
TX Pkts: 4 TX Bytes: 648
BPI (DES) - 
KeyNum: 0x3 Said: 0x16 KeySeq:0x1
Even Key: 0A3C-5BC0-C9C0-9F Even Iv: 0204-25F7-07A1-026E
Odd Key: 0448-0392-26C4-55 Odd Iv: 087F-0B13-237A-1F89
PHS -
PHSM: 0000-0000-0000-0000
Ctrl: 0x0 PHSI: 0x0 PHSS: 0x0 Count: 0x0

The following is a sample output of the show cable modem service-flow ds-hardware command on the wideband modem on a bonded local interface:

Router# show cable modem 80.36.0.122 service-flow ds-hardware
LC SFID:46 RP SFID: 33148 StatIndex: 19
KeyIndex: 7 PHSIndex: 0
TX Pkts: 200 TX Bytes: 23600
DSID: 0x152 Priority: 0x0 Seqnum: 0xC8 
Enabled: 0x1 DPV Enabled: 0x0 SeqNum Change Cnt: 0x0
BPI (DES) - 
KeyNum: 0x3 Said: 0x14 KeySeq:0x1
Even Key: 08E0-8C51-8AC2-A5 Even Iv: 0EA2-1FA8-1C32-2685
Odd Key: 12F4-3980-C984-53 Odd Iv: 0DA1-0BA2-0E4F-0864
PHS -
PHSM: 0000-0000-0000-0000
Ctrl: 0x0 PHSI: 0x0 PHSS: 0x0 Count: 0x0

Table 1 describes the significant fields shown in the output.

Table 39 show cable mode service-flow Field Descriptions 

Field
Description

MAC Address

Hardware (MAC-layer) address of the cable modem or CPE device.

IP Address

IP address of the cable modem or CPE device.

Host Interface

Host interface name.

MAC State

Current state of the MAC layer.

Prim Sid

Primary SID assigned to this CM.

Num CPE

Number of CPE devices for which the CM is providing services.

Primary Downstream

Primary downstream channel assigned to the CM.

DS RfId

Downstream RF identifier.

SFID

Service flow identifier.

SID

Service ID (SID) of the device.

Requests

Number of requests.

Polls

Number of polls.

Grants

Number of grants.

Delayed Grants

Number of delayed grants.

Dropped Grants

Number of dropped grants.

Packets

Number of packets.

RP_SFID

Route processor SFID.

QID

Link queue identification number.

Flg

Indicates whether the queue is low latency or CIR.

Policer Xmits

Packets transmitted out of the policer.

Drops

Packets dropped by the policer.

Scheduler Xmits

Packets transmitted out of the scheduler.

Drops

Packets dropped by the scheduler.

FrwdIF

Forwarding interface.

LC SFID

Line card SFID.

KeyIndex

Per flow index to BPI data.

PHSIndex

Per flow index to PHS data.

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.

BPI

Indicates whether or not Baseline Privacy Interface (BPI) encryption is enabled for the CM.

Said

Security association identifier.

KeySeq

Downstream traffic key sequence number.

Even Key

Even traffic encryption key (TEK) value.

Even Iv

Value of the even Initialization Vector (IV).

Odd Key

Odd TEK key value.

Odd Iv

Odd IV value.

PHS

Payload header suppression.

PHSM

PHS Mask. 5-bit PHS mask that defines the header bytes that should be suppressed.

Ctrl

Control block.

PHSI

PHS Index. Number that uniquely references the PHS rule.

PHSS

PHS Size. 8-bit value specifying the number of header bytes to be suppressed.

Count

PHS rule usage count.


Related Commands

Command
Description

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem access-group

Displays the access groups for the CMs on a particular cable interface.

show cable modem calls

Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.

show cable modem classifiers

Displays information about the classifiers for a particular CM.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem counters

Displays downstream and upstream traffic counters for one or more CMs.

show cable modem cpe

Displays the CPE devices accessing the cable interface through a particular CM.

show cable modem domain-name

Updates the cable-specific DNS cache and display the domain name for specified CMs and CPE behind a CM on a Cisco CMTS router.

show cable modem errors

Displays error statistics for one or more CMs.

show cable modem flap

Displays flap list statistics for one or more CMs.

show cable modem ipv6

Displays IPv6 information for specified CMs and CPE behind a CM on a Cisco CMTS router.

show cable modem mac

Displays MAC layer information for one or more CMs.

show cable modem maintenance

Displays station maintenance (SM) error statistics for one or more CMs.

show cable modem offline

Displays a list of the CMs that are marked as offline with the Cisco CMTS.

show cable modem phy

Displays the DOCSIS PHY layer information for one or more CMs.

show cable modem qos

Displays quality of service (QoS) and service flow information for a particular CM.

show cable modem registered

Displays a list of the CMs that are marked as registered with the Cisco CMTS.

show cable modem remote-query

Displays information collected by the remote-query feature.


show cable modem summary

To display a summary of CMs on one or more cable interfaces, use the show cable modem summary command in privileged EXEC mode.

show cable modem summary [total]

show cable modem summary interface1 [interface2] total

show cable modem summary interface1 [interface2] upstream port1 port2 total

show cable modem cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] summary

show cable modem cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] summary

Syntax Description

total

(Optional) Displays a footer line showing the totals for each column.

interface1

(Optional) Cable interface to be summarized. The interface1 parameter can take the following forms:

cable {slot/port | slot/cable-interface-index}

cable {slot/subslot/port | slot/subslot/cable-interface-index}

where,

slot—Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot—(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port—Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index—Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

interface2

(Optional) Second cable interface, specifying a range of cable interfaces to be summarized. The interface2 parameter has the same form as interface1.

Note When specifying a range of cable interfaces, interface1 must be the lower-numbered interface and interface2 must be the higher-numbered interface.

upstream port1 port2

(Optional) Specifies a range of upstream ports on the cable interfaces to be summarized. The port1 and port2 parameters can start at 0, and port2 must be a higher-numbered port than port1.

upstream port

(Optional) Specifies a specific upstream port to be summarized. This option can be specified only when summarizing a single cable interface.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

summary

Displays a summary of CMs on one or more cable interfaces.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

11.3XA

This command was introduced.

12.1(4)CX and 12.2(4)BC1

Support was added for the Cisco uBR10012 router.

12.1(6)EC

The total option was supported for the Cisco uBR7100 series and Cisco uBR7200 series routers.

12.1(11b)EC

The upstream Description field was added to the show cable modem summary display in Cisco IOS Release 12.1 EC.

12.2(8)BC1

The total option was supported for the Cisco uBR10012 universal broadband router.

12.2(15)BC2

The upstream Description field was added to the show cable modem summary display in Cisco IOS Release 12.2 BC.

12.3(21)BC

Support was added for wideband cable modem output.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

This command displays a summary of CMs for a single cable interface or upstream, or for a range of cable interfaces or upstreams. The following possible combinations are possible for this command:

show cable modem summary total—Displays a summary and a total for all CMs on the chassis.

show cable modem summary cable x/0 total—Displays a summary of CMs on a specified card.

show cable modem summary cable x/0 upstream port1 port2 total—Displays a summary of CMs on the specified card and specified range of ports. The port1 value must be less than the port2 value.

show cable modem summary cable x/0 cable y/0 total—Displays a summary of CMs on the specified range of cards.

show cable modem summary cable x/0 cable y/0 upstream port1 port2 total—Displays a summary of CMs on the specified range of ports on the specified range of cards.


Note Also see the information about this command's behavior in a Hot Standby Connection-to-Connection Protocol (HCCP) configuration, see the "Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration" in the Cisco Broadband Cable Command Reference Guide.


Examples

The following example shows typical output for the default form of the show cable modem summary command on a Cisco uBR7200 series router:

Router# show cable modem summary 
Interface     Total      Active      Registered   Description 
              Modems     Modems      Modems
Cable3/0/U0   165         141         141         Line 32/1
Cable3/0/U1   209         172         170         Line 32/2
Cable3/0/U2   262         207         203         Line 32/3
Cable3/0/U3   256         194         188         Line 32/4
Cable5/0/U0   746         714         711         Line 41/1
Cable6/0/U0   806         764         759         Line 42/2
Router# 

Note The Description field appears in Cisco IOS Release 12.1(11b)EC, 12.2(15)BC2, and later releases, and shows the string configured for the upstream using the cable upstream description command.


The following example shows typical output for the show cable modem summary command with the total option on a Cisco uBR7200 series router:

Router# show cable modem summary total 
Interface     Total      Active      Registered   Description 
              Modems     Modems      Modems
Cable5/0/U0     746        714         711        Node1 
Cable6/0/U1     806        764         759        Node3
Total:         1552       1478        1470
Router# 

The following example shows sample output for the show cable modem summary command with the total option for a Cisco uBR10012 router:

Router# show cable modem summary total
Interface                       Cable Modem                    Description
            Total Reg   Unreg Offline Wideband initRC initD initIO initO
C5/0/0/U0   84    84    0     0       84       0      0     0      0     
C5/0/0/U1   84    84    0     0       84       0      0     0      0     
C5/0/0/U2   83    83    0     0       83       0      0     0      0     
C5/0/0/U3   83    83    0     0       83       0      0     0      0     
<<output omitted>>
Total:      8020  8020  0     0       8016     0      0     0      0 
Router# 

The following example shows sample output for the show cable modem summary total command for a range of interfaces on the Cisco uBR10012 router:

Router# show cable modem summary c5/1/1 c5/1/2 total
Interface                       Cable Modem                    Description
            Total Reg   Unreg Offline Wideband initRC initD initIO initO
C5/1/1/U0   84    84    0     0       84       0      0     0      0     
C5/1/1/U1   84    84    0     0       83       0      0     0      0     
C5/1/1/U2   83    83    0     0       83       0      0     0      0     
C5/1/1/U3   83    83    0     0       83       0      0     0      0     
C5/1/2/U0   84    84    0     0       84       0      0     0      0     
C5/1/2/U1   84    84    0     0       84       0      0     0      0     
C5/1/2/U2   83    83    0     0       83       0      0     0      0     
C5/1/2/U3   83    83    0     0       83       0      0     0      0     
Total:      668   668   0     0       667      0      0     0      0     
Router# 

The following example shows sample output for the show cable modem summary total command for a range of interfaces and upstreams on the Cisco uBR10012 router:

Router# show cable modem summary c5/1/1 c5/1/2 upstream 0 1 total
Interface                       Cable Modem                    Description
            Total Reg   Unreg Offline Wideband initRC initD initIO initO
C5/1/1/U0   84    84    0     0       84       0      0     0      0     
C5/1/1/U1   84    84    0     0       83       0      0     0      0     
C5/1/2/U0   84    84    0     0       84       0      0     0      0     
C5/1/2/U1   84    84    0     0       84       0      0     0      0     
Total:      336   336   0     0       335      0      0     0      0     
Router# 

Note When displaying a summary for a range of ports or cable interfaces, the first port or cable interface (for example, u0 or c4/0) must be lower-numbered than the second port or interface (for example, u6 or c6/0). If you specify the higher-numbered port or interface first, the display shows no CMs connected.


Table 0-40 describes the fields shown in the show cable modem summary displays:

Table 0-40 Descriptions for the show cable modem summary Fields 

Field
Description

Interface

The cable interface line card providing the upstream for the CMs.

Total Modems or Total

Total number of CMs, registered, unregistered, and offline for this interface.

Registered Modems or Reg

Total number of CMs that have registered and are online on this interface. This number might be different from the Total Modems number if some modems are offline or not fully registered.

Unregistered Modems

Total number of CMs that are either offline and not currently communicating with the CMTS, or attempting to come online but are not yet registered.

Offline

Total number of CMs that were online or attempted to register but are no longer communicating with the CMTS.

Wideband

CM is registered as a wideband CM.

init(rc)

MAC state of CM is init(rc).

init(d)

MAC state of CM is init(d).

init(io)

MAC state of CM is init(io).

init(o)

MAC state of CM is init(o).

Description

Description entered for this upstream using the cable upstream description command.



Note For information on MAC states, see the show cable modem command.



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

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem access-group

Displays the access groups for the CMs on a particular cable interface.

show cable modem calls

Displays voice call information for a particular CM, identified either by its IP address or MAC address.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem counters

Displays downstream and upstream traffic counters for one or more CMs.

show cable modem cpe

Displays the CPE devices accessing the cable interface through a particular CM.

show cable modem offline

Displays a list of the CMs that are marked as offline with the Cisco CMTS.

show cable modem registered

Displays a list of the CMs that are marked as registered with the Cisco CMTS.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show cable modem unregistered

Displays a list of the CMs that are marked as unregistered with the Cisco CMTS.

show cable modem vendor

Displays the vendor name or Organizational Unique Identifier (OUI) for the CMs on each cable interface.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.

show cable modem wideband

Displays information for a wideband CMs.


show cable modem summary wb-rf

To display the number of RF channels that are down on a cable interface, use the show cable modem summary wb-rf command in privileged EXEC mode.

show cable modem [cable slot/subslot/port] summary wb-rf [modular-cable slot/bay/port:nb-channel-number]

Syntax Description

cable slot/subslot/port

(Optional) Specifies the cable interface. The following are the valid values:

slot—Specifies the chassis slot number of the cable interface line card. Valid values are 5to 8.

subslot—Specifies the secondary slot number of the cable interface line card. Valid subslots are 0 or 1.

port—Specifies the port number. Valid values are 0 to 4 (depending on the cable interface).

modular-cable slot/bay/port:nb-channel-number

(Optional) Specifies the modular cable interface. The following are the valid values:

slot—The slot where a SIP resides. On the Cisco uBR10012 router, slots 1 and 3 can be used for SIPs.

bay—The bay in a SIP where a SPA is located. Valid values are 0 (upper bay) and 1 (lower bay).

port—Specifies the interface number on the SPA.

nb-channel-number—Specifies the narrowband channel number.


Command Default

No default behavior or values.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCB

This command was introduced.


Examples

The following is a sample output of the show cable modem summary wb-rf command on the cable interface at slot/subslot/port 8/0/0:

Router# show cable modem cable 8/0/0 summary wb-rfs 
Total     Total    Percent
RF        w-online  RF down  RF down
--------  --------  -------  -------
1/0/0 0   4         0        0        
      1   6         0        0        
      2   7         0        0        

The following is a sample output of the show cable modem summary wb-rf command on the modular cable interface at slot/bay/port and narrowband channel 1/0/0 18:

Router# show cable modem c8/0/0 summary wb-rfs modular-cable 1/0/0 18
Total     Total    Percent
RF        w-online  RF down  RF down
--------  --------  -------  -------
1/0/0 18  0         0        0        

Related Commands

Command
Description

show cable modem summary

Displays a summary of CMs on one or more cable interfaces.


show cable modem type

To display cable modem (CM) provisioning information for all CMs, such as boot mode configuration and MAC and IP address information, use the show cable modem type command in privileged EXEC configuration mode.

Cisco uBR7246VXR Router and Cisco uBR7225VXR Router

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] type

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] type

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCA

This command was introduced.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.

Examples

The following example shows sample output for the show cable modem type command :

Router# show cable modem type
Boot Mode configuration:
P - Primary Boot mode (IPv6 or IPv4)
D - Dual Stack (Yes/No)
A - Alternative Provisioning Mode (Yes/No)
MAC Address    Interface P/D/A  IPv4 address    IPv6 Address
0004.27a5.b761 C6/0/2/U1 v6/N/N 10.7.0.161      ---
0007.0e01.d9a1 C6/0/2/U0 v6/N/N 10.7.0.162      ---
0006.2854.7275 C6/0/2/U1 v6/Y/N 10.7.0.3        2001:ODB8:3800:80B:7565:5B87:1D7D:5AD5
0018.6835.27dd C6/0/U0   v6/N/N ---             2001:0DB8:3800:803:41D7:DECC:F15D:133 

Table 41 describes the significant fields shown in the display.

Table 41 show cable modem type Field Descriptions 

Field
Description

MAC Address

MAC address of this CM.

Interface

Cable line card interface and upstream associated with this CM.

P/D/A

String of 3 values representing the boot mode configuration of the CM as follows:

P—Primary Boot Mode, where "v4" or "v6" indicates IPv4 or IPv6 as the primary addressing mode.

D—Dual Stack, where "Y" or "N" indicates whether or not both IPv4 and IPv6 addressing modes are supported.

A—Alternative Provisioning Mode (APM), where "Y" or "N" indicates whether or not APM is supported.

Note APM is not supported by the Cisco CMTS routers in Cisco IOS Release 12.2(33)SCA.

IPv4 address

IPv4 address acquired by the CM. Prior to acquisition of the IP address, or if the CM fails IPv4 registration, the following output is shown:

IPv4 address not yet acquired—"0.0.0.0"

CM fails IPv4 registration, but online with IPv6 address: "---"

IPv4 address of an IPv6-only CM: "---"

IPv6 Address

IPv6 address acquired by the CM. Prior to acquisition of the IP address, or if the CM fails IPv6 registration, the following output is shown:

IPv6 address not yet acquired—"::"

CM fails IPv6 registration, but online with IPv4 address "---"

IPv6 address of IPv4-only CM: "---"


Related Commands

Command
Description

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.


show cable modem unregistered

To display a list of the cable modems (CMs) that are marked as unregistered with the Cisco CMTS, use the show cable modem unregistered command in privileged EXEC mode.

Cisco uBR7100 Series and Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] unregistered

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] unregistered

Syntax Description

ip-address

(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.

Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

name fqdn

(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.


Defaults

Displays a list of all unregistered CMs on the Cisco CMTS router.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

11.3 NA

This command was introduced.

12.2(4)BC1

This command was introduced on the Cisco uBR10012 router.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:

Support for the Cisco uBR7225VXR router was added.

Support for specifying the IPv6 address of a CM or CPE device was added.

The name keyword option was added for specifying the fully-qualified domain name of a CM.

The following new initialization states were added to show initialization of CMs and CPEs supporting IPv6:

init6(s)—CMTS router has seen SOLICIT message.

init6(a)—CMTS router has seen ADVERTISE message.

init6(r)—CMTS router has seen REQUEST message.

init6(i)—CMTS router has seen REPLY message.

init6(o)—CMTS router has seen version 6 TFTP request.

init6(t)—CMTS router has seen version 6 TOD request.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration

If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.

In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:

%No response from slot 6/1. Command aborted

If this occurs, wait a minute or so and retry the command.


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.



Note In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.


Examples

The following example shows sample output for the default form of the show cable modem unregistered command.

Router# show cable modem unregistered 
Interface   Prim Online    Timing Rec    QoS CPE IP address      MAC address
            Sid  State     Offset Power
Cable3/0/U0 1    online     2812   -0.25  5   1   3.18.1.5        0030.80bc.2303
Cable3/0/U0 2    online     2804    0.50  5   0   3.18.1.9        0006.2854.73f5
C6/0/U0     6    init6(i)   1532   -0.50  2   0   0.0.0.0         0018.6835.27dd 

The following example shows sample output for the show cable modem unregistered command for a particular cable interface:

Router# show cable modem c8/1/0 unregistered 
Interface Prim Online      Timing Rec     QoS CPE IP address      MAC address
          Sid  State       Offset Power
C8/1/0/U1 1    online       1548   0.00   5   0   22.1.1.11       0050.7366.1243
C8/1/0/U4 2    online       1925   0.00   5   0   23.1.1.10       0002.b970.0027
C8/1/0/U4 3    online       1918   -0.50  2   0   22.1.1.10       0006.5314.858d

The following example shows sample output for the show cable modem unregistered command for a single CM, as identified by its IP address:

Router# show cable modem 22.1.1.10 unregistered 
Interface Prim Online      Timing Rec     QoS CPE IP address      MAC address
          Sid  State       Offset Power
C8/1/0/U4 3    online       1918   -0.75  2   0   22.1.1.10       0006.5314.858d

The following example shows sample output for the show cable modem unregistered command for a single CM, as identified by its MAC address:

Router# show cable modem 0006.5314.858d unregistered 
Interface Prim Online      Timing Rec     QoS CPE IP address      MAC address
          Sid  State       Offset Power
C8/1/0/U4 3    online       1918   -0.25  2   0   22.1.1.10       0006.5314.858d

Note An asterisk (*) in the Receive Power column indicates that a power adjustment has been made for that CM. An exclamation point (!) in the Receive Power column indicates that the CM has reached its maximum power transmit level and cannot increase its power level further. An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command.

A pound sign (#) in the MAC State column indicates that the cable tftp-enforce mark-only command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so (Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases).



Tip The show cable modem command displays the CM timing offset in DOCSIS ticks, while other commands, such as cable map-advance, display the offset in microseconds. Use the following method to convert microseconds to DOCSIS ticks: ticks = microseconds*64/6.25.


Table 42 describes the major fields shown in the show cable modem unregistered displays:

Table 42 Descriptions for the show cable modem unregistered Fields 

Field
Description

Interface

The cable interface line card providing the upstream for this CM.

Prim SID

The primary SID assigned to this CM.

Online State

The current state of the MAC layer (see Table 23).

Timing Offset

The timing offset for the CM, in ticks, as recognized on the CMTS. (A tick, as used here, is 6.25/64 microseconds.) This is the delay between when a particular cable modem is scheduled to make a transmission and when the CMTS actually receives it.

Note An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command.

Note The timing offset shown here is typically smaller than the TX Time Offset value shown by the show cable modem remote-query command, because the latter value is the offset as recognized on the CM (which will include any internal delay between when the CM software begins the transmission and when the bits actually appear on the local cable interface).

Rec Power

The received power level (in dB) for the CM.

Note An asterisk (*) in the RxPwr column indicates that a power adjustment has been made for that CM. An exclamation point (!) indicates that the CM has reached its maximum power transmit level and cannot increase its power level further.

QoS

Displays the QoS profile assigned to the CM (DOCSIS 1.1 and DOCSIS 2.0 CMs only).

CPE

Indicates the number of CPE devices for which the CM is providing services.

IP Address

The IP address that the DHCP server has assigned to the CM.

MAC Address

The MAC address for the CM.


Table 23 shows the possible values for the Online State field:

Table 43 Descriptions for the Online State Field 1

MAC State Value
Description
Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing

init(r1)

The CM sent initial ranging.

init(r2)

The CM is ranging. The CMTS received initial ranging from the Cm and has sent RF power, timing offset, and frequency adjustments to the CM.

init(rc)

Ranging has completed.

Note If a CM appears to be stuck in this state, it could be that the CM is able to communicate successfully on the cable network, but that the upstream is at capacity and does not have any additional bandwidth to allow the CM to finish registration and come online. Either manually move one or more CMs to other upstreams, or enable load balancing on the upstream using the cable load-balance group commands.

init(d)

The DHCP request was received, as DHCPDISCOVER. This also indicates that the first IP broadcast packet has been received from the CM.

init(dr)

The DHCP request has been sent to the cable modem.

init(i)

The cable modem has received the DHCPOFFER reply (DHCPACK) from the DHCP server that has assigned an IP address to the modem, but the modem has not yet replied with a DHCPREQUEST message requesting that particular IP address, nor has it sent an IP packet with that IP address.

Note If a CM appears to be stuck in this state, the CM has likely received the DHCPOFFER reply from the DHCP server, but this reply might have contained one or more invalid options for that particular CM.

init(io)

The Cisco CMTS has seen the DHCP offer as sent to the cable modem from the DHCP server that has assigned an IP address to the modem.

init(o)

The CM has begun to download the option file (DOCSIS configuration file) using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP response. If the CM remains in this state, it indicates that the download has failed.

init(t)

Time-of-day (TOD) exchange has started.

resetting

The CM is being reset and will shortly restart the registration process.

 

init6(s)

The Cisco CMTS router has seen the DHCPv6 SOLICIT message from the CM.

init6(a)

The Cisco CMTS router has seen the ADVERTISE message from the DHCPv6 server to the CM.

init6(r)

The Cisco CMTS router has seen the REQUEST response from the CM to the DHCPv6 server.

init6(i)

The Cisco CMTS router has seen the REPLY message from the DHCPv6 server to the CM.

init6(o)

The Cisco CMTS router has seen the REQEST message from the CM to the TFTP server.

init6(t)

The Cisco CMTS router has seen the REQUEST message from the CM to the TOD server.

Non-error Status Conditions

cc(r1)

The CM had registered and was online, but has received a Downstream Channel Change (DCC) or Upstream Channel Change (UCC) request message from the CMTS. The CM has begun moving to the new channel, and the CMTS has received the CM's initial ranging on the new downstream or upstream channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

cc(r2)

This state should normally follow cc(r1) and indicates that the CM has finished its initial ranging on the new channel, and is currently performing continuous ranging on the new channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

offline

The CM is considered offline (disconnected or powered down).

online

The CM has registered and is enabled to pass data on the network.

online(d)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. The CM does not forward traffic to or from the CPE devices, but the CMTS can continue to communicate with the CM using DOCSIS messages and IP traffic (such as SNMP commands).

Note If BPI was enabled in the DOCSIS configuration file sent to the CM, assume that the CM is using BPI encryption, unless other messages show that the BPI negotiation and key assignments have failed.

online(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and KEK is assigned.

Note This state is equivalent to the online(d) and online(pk) states.

online(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note This state is equivalent to the online(d) and online(pt) states.

online(pk)

The CM registered, BPI is enabled and KEK is assigned.

online(pt)

The CM registered, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note If network access was disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) instead of online(pt) even when BPI encryption is enabled and operational.

Note If an exclamation point (!) appears in front of one of the online states, it indicates that the cable dynamic-secret command has been used with either the mark or reject option, and that the cable modem has failed the dynamic secret authentication check.

expire(pk)

The CM registered, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

expire(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pk) states.

expire(pt)

The CM registered, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

expire(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pt) states.

Error Status Conditions

reject(m)

The CM attempted to register but registration was refused due to a bad Message Integrity Check (MIC) value. This also could indicate that the shared secret in the DOCSIS configuration file does not match the value configured on the CMTS with the cable shared-secret command.

In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases, this could also indicate that the cable tftp-enforce command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so.

reject(c)

The CM attempted to register, but registration was refused due to a a number of possible errors:

The CM attempted to register with a minimum guaranteed upstream bandwidth that would exceed the limits imposed by the cable upstream admission-control command.

The CM has been disabled because of a security violation.

A bad class of service (COS) value in the DOCSIS configuration file.

The CM attempted to create a new COS configuration but the CMTS is configured to not permit such changes.

The CM failed the timestamp check for its DOCSIS configuration file. (This could indicate a possible theft-of-service attempt, or a problem with the synchronization of the clocks on the CM and CMTS.)

reject(pk)

KEK key assignment is rejected, BPI encryption has not been established.

reject(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because KEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pk) states.

reject(pt)

TEK key assignment is rejected, BPI encryption has not been established.

reject(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because TEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pt) states.

Note In Cisco IOS Release 12.1(20)EC, Cisco IOS Release 12.2(15)BC1, and earlier releases, when network access is disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) even if BPI encryption fails. Use the show cable modem mac-address command to confirm whether BPI is enabled or disabled for a particular cable modem.

reject(ts)

The CM attempted to register, but registration failed because the TFTP server timestamp in the CM registration request did not match the timestamp maintained by the CMTS. This might indicate that the CM attempted to register by replaying an old DOCSIS configuration file used during a prior registration attempt.

reject(ip)

The CM attempted to register, but registration failed because the IP address in the CM request did not match the IP address that the TFTP server recorded when it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.

reject(na)

The CM attempted to register, but registration failed because the CM did not send a Registration-Acknowledgement (REG-ACK) message in reply to the Registration-Response (REG-RSP) message sent by the CMTS. A Registration-NonAcknowledgement (REG-NACK) is assumed.

1 The CM MAC state field can also be retrieved using SNMP by getting the value of the cdxCmtsCmStatusValue object in the CISCO-DOCS-EXT-MIB.


Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem access-group

Displays the access groups for the CMs on a particular cable interface.

show cable modem classifiers

Displays information about the classifiers for a particular CM.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem cpe

Displays the CPE devices accessing the cable interface through a particular CM.

show cable modem offline

Displays a list of the CMs that are marked as offline with the Cisco CMTS.

show cable modem registered

Displays a list of the CMs that are marked as registered with the Cisco CMTS.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show cable modem vendor

Displays the vendor name or Organizational Unique Identifier (OUI) for the CMs on each cable interface.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem vendor

To display the vendor name or Organizational Unique Identifier (OUI) for the CMs on each cable interface, use the show cable modem vendor command in privileged EXEC mode.

show cable modem [cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]]] vendor [summary]

Syntax Description

slot

Slot where the line card resides. The valid range is from 5 to 8.

subslot

Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number. The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using this specific upstream. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports on the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

summary

(Optional) Displays the total numbers for each vendor and OUI, along with the total numbers of those vendor's CMs that are currently registered with the CMTS, unregistered, or offline.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(8)BC2

This command was introduced for the Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 routers.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The logical-channel-index argument was added.


Usage Guidelines

This command displays the vendor name for each CM. If the vendor name has not been defined by the cable modem vendor command, the command displays the OUI value for the modem's vendor.


Note The Institute of Electrical and Electronics Engineers (IEEE) is the official issuer of OUI values. The IEEE OUI web site is at http://standards.ieee.org/regauth/oui/index.shtml.



Note Also see the information about this command's behavior in a Hot Standby Connection-to-Connection Protocol (HCCP) configuration.


Examples

The following example shows typical output for the show cable modem vendor command:

Router# show cable modem vendor 
Vendor     MAC Address    I/F       MAC         Prim  RxPwr  Timing  Num BPI
                                    State       Sid   (db)   Offset  CPE Enb
Cisco      0001.9659.519f C1/0/U0   init(rc)    16    0.75    2738  0    N 
Cisco      0002.b96f.fdbb C1/0/U0   online      20    1.00    2738  1    N 
Cisco      0002.b96f.fdf9 C1/0/U0   online      21    0.50    2737  1    N 
Cisco      0002.b96f.fff7 C1/0/U0   online      12    0.50    2737  1    N 
Cisco      0002.fdfa.1163 C1/0/U0   online      1     0.00    2734  1    N 
Cisco      0002.fdfa.12d5 C1/0/U0   online      14    0.00    2737  1    N 
Cisco      0002.fdfa.12db C1/0/U0   online      18    0.25    2736  1    N 
Cisco      0002.fdfa.12e9 C1/0/U0   online      13    0.25    2737  1    N 
Cisco      0006.28dc.37fd C1/0/U0   offline     7     0.25    2734  0    N 
Cisco      0006.28e9.81c9 C1/0/U0   online      2     0.75    2735  1    N 
Motorola   0020.28f9.9d19 C1/0/U0   online      28    -0.25   2733  1    N 
Motorola   0020.4006.b010 C1/0/U0   online      19    0.00    2728  1    N 
00.C0.FF   00c0.FF78.8bea C1/0/U0   offline     10    1.25    2732  0    N 
Cisco      00b0.6478.ae8d C1/0/U0   offline     10    1.50    2735  0    N 
Cisco      00d0.bad3.c0cd C1/0/U0   online      26    0.25    2214  1    N 
Cisco      00d0.bad3.c0d5 C1/0/U0   online      27    0.00    2215  1    N 
Router# 

The following example shows typical output for the show cable modem vendor command on the Cisco uBR10012 router:

Router# show cable modem vendor 
Vendor     MAC Address    I/F       MAC         Prim  RxPwr  Timing  Num BPI
                                    State       Sid   (db)   Offset  CPE Enb
Thomson    0010.9507.01db C5/1/0/U5 online      1     0.00    938   1    N 
Ericsson   0080.37b8.e99b C5/1/0/U5 online      2     -0.25   1268  0    N 
Cisco      0002.fdfa.12ef C6/1/0/U0 online      13    0.00    1920  1    N 
Cisco      0002.fdfa.137d C6/1/0/U0 online      16    -0.50   1920  1    N 
Cisco      0003.e38f.e9ab C6/1/0/U0 online      3     -0.25   1926  1    N 
Cisco      0003.e3a6.7f69 C6/1/0/U0 online      15    0.50    1927  1    N 
Cisco      0003.e3a6.816d C6/1/0/U0 online      4     0.00    1929  1    N 
Cisco      0006.28f9.8be5 C6/1/0/U0 online      12    0.75    1922  1    N 
Cisco      0001.9659.519f C6/1/1/U2 online      26    0.25    1930  1    N 
Cisco      0002.b96f.fdbb C6/1/1/U2 online      29    -0.75   1929  1    N 
Cisco      0002.b96f.fdf9 C6/1/1/U2 online      39    -0.50   1931  1    N 
Cisco      0002.b96f.fff7 C6/1/1/U2 online      38    0.00    1928  1    N 
Cisco      0002.fdfa.1163 C6/1/1/U2 online      15    0.00    1923  1    N 
Cisco      0002.fdfa.12d5 C6/1/1/U2 online      35    0.25    1923  1    N 
Cisco      0002.fdfa.12e9 C6/1/1/U2 online      5     -0.25   1925  1    N 
Cisco      0050.7302.3d73 C6/1/1/U2 online      58    0.25    1553  1    N 
Cisco      0002.fdfa.12db C7/0/0/U0 online      15    -0.75   1914  1    N 
Cisco      0002.fdfa.138d C7/0/0/U5 online      4     0.25    1917  1    N 
Cisco      0003.e38f.e85b C7/0/0/U5 online      17    0.25    1919  1    N 
Cisco      0003.e38f.f4cb C7/0/0/U5 online      16    0.00    1922  1    N 
Cisco      0003.e3a6.7fd9 C7/0/0/U5 online      1     0.25    1922  0    N 
Motorola   0020.4005.3f06 C7/0/0/U0 online      2     0.00    1901  1    N 
Motorola   0020.4006.b010 C7/0/0/U5 online      3     0.25    1901  1    N 
Cisco      0050.7302.3d83 C7/0/0/U0 online      18    -0.25   1543  1    N 
Cisco      00b0.6478.ae8d C7/0/0/U5 online      44    0.50    1920  21   N 
Cisco      00d0.bad3.c0cd C7/0/0/U5 online      19    0.00    1543  1    N 
Cisco      00d0.bad3.c0cf C7/0/0/U0 online      13    0.00    1546  1    N 
Cisco      00d0.bad3.c0d5 C7/0/0/U0 online      12    -0.50   1546  1    N 
Router# 

Tip The show cable modem vendor command displays the CM timing offset in DOCSIS ticks, while other commands, such as cable map-advance, display the offset in microseconds. Use the following method to convert microseconds to DOCSIS ticks: ticks = microseconds*64/6.25.


Table 0-44 describes the major fields shown in the show cable modem vendor displays:

Table 0-44 Descriptions for the show cable modem vendor Fields 

Field
Description

Vendor

The vendor name for the indicated CM, as specified by the cable modem vendor command. If no name for this vendor has been specified, displays the modem's OUI value.

MAC Address

The MAC address for the CM.

I/F

The cable interface line card providing the upstream for this CM.

MAC State

The current state of the MAC layer.

Prim SID

The primary SID assigned to this CM.

RxPwr

The received power level (in dB) for the CM.

Note An asterisk (*) in the RxPwr column indicates that a power adjustment has been made for that CM. An exclamation point (!) indicates that the CM has reached its maximum power transmit level and cannot increase its power level further.

Timing Offset

The timing offset for the CM, in ticks, as recognized on the CMTS. (A tick, as used here, is 6.25/64 microseconds.) This is the delay between when a particular cable modem is scheduled to make a transmission and when the CMTS actually receives it.

Note An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command.

Note The timing offset shown here is typically smaller than the TX Time Offset value shown by the show cable modem remote-query command, because the latter value is the offset as recognized on the CM (which will include any internal delay between when the CM software begins the transmission and when the bits actually appear on the local cable interface).

Num CPE

Indicates the number of CPE devices for which the CM is providing services.

BPI Enbld

Indicates whether Baseline Privacy Interface (BPI) or BPI Plus (BPI+) encryption is enabled for the CM.



Note An asterisk (*) in the RxPwr column indicates that a power adjustment has been made for that CM. An exclamation point (!) in the Receive Power column indicates that the CM has reached its maximum power transmit level and cannot increase its power level further. An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command.

A pound sign (#) in the MAC State column indicates that the cable tftp-enforce mark-only command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so (Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases).


The following example shows typical output for the show cable modem vendor summary command, displaying the total numbers for each vendor and OUI, along with the total numbers of those vendor's CMs that are currently registered with the CMTS, unregistered, or offline.

Router# show cable modem vendor summary 
  Vendor     OUI                   Cable Modem
                       Total Registered Unregistered Offline
  00.02.B2   00.02.B2  4288  3997       291          259
  00.0A.73   00.0A.73  4105  3938       167          108
  00.0B.06   00.0B.06  1060  1001       59           48
  00.40.7B   00.40.7B  216   211        5            2
  00.50.04   00.50.04  701   684        17           15
  00.50.DA   00.50.DA  737   706        31           26
  00.D0.DD   00.D0.DD  2     0          2            2
  3Com       00.01.03  669   645        24           21
  3Com       00.04.75  10    10         0            0
  Ambit      00.D0.59  1     1          0            0
  BestData   00.E0.CA  1     1          0            0
  Cisco      00.04.C1  1     1          0            0
  LinkSys    00.06.25  15    13         2            2
  Motorola   00.04.BD  705   676        29           21
  Motorola   00.08.0E  762   734        28           16
  Motorola   00.20.40  1504  1444       60           45
  Powercom   00.30.3B  3     2          1            1
  SMC        00.04.E2  1     1          0            0
  Terayon    00.E0.6F  652   612        40           25
  Thomson    00.10.95  127   121        6            5
  Toshiba    00.00.39  1     1          0            0
  Turbo      00.90.83  4     4          0            0
  Zoom       00.40.36  1     1          0            0
Router# 

Tip You can add a timestamp to this command using the exec prompt timestamp command in line configuration mode.


Related Commands

Command
Description

cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem cpe

Displays the CPE devices accessing the cable interface through a particular CM.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem voice

To show the detected voice-enabled modems, use the show cable modem voice command.

cable modem voice [pending|failed]

Syntax Description

pending

(Optional) Displays cable modems that are being moved to the target channel via Downstream Frequency Override (DFO).

failed

(Optional) Displays cable modems that have already reached the maximum Downstream Frequency Override retry limit without success.


Command Default

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(23)BC

This command was introduced for the Cisco uBR10012 router.


Usage Guidelines

Use this command to display the detected voice-enabled modems.

Examples

Router# show cable modem voice
MAC Address    IP Address      Host      MAC          Prim  Num  Primary    DS
                               Interface State        Sid   CPE  Downstream RfId
0013.10bb.22f9 80.17.1.2       C6/0/0/U0 online(pt)   2     0    Mo3/0/0:1  1
0013.10bb.23d1 80.17.1.5       C6/0/1/U1 online(pt)   5     0    C6/0/1     255

Related Commands

show cable service-voice downstream-type

Displays the downstream-types that are capable of providing voice services.


show cable modem wideband

To display information for registered and unregistered wideband CMs, use the show cable modem wideband command in privileged EXEC mode.

show cable modem wideband [registered-traditional-docsis | channel ]

show cable modem [ip-address | mac-address | cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port [logical-channel-index]]] wideband [channel]

Syntax Description

ip-address

(Optional) Identifies the IP address of a specific wideband CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.

mac-address

(Optional) Identifies the MAC address of a specific wideband CM to be displayed. If you specify the MAC address for a CPE device behind a wideband CM, information for that wideband CM is displayed.

slot

Slot where the line card resides. The valid range is from 5 to 8.

subslot

Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

port

Downstream port number. The valid range is from 0 to 4 (depending on the cable interface).

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upstream port

(Optional) Displays information for all CMs using this specific upstream. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports on the cable interface line card.

logical-channel-index

(Optional) Logical channel index. The valid values are 0 or 1.

registered-traditional-docsis

(Optional) Displays information for wideband CMs that are currently registered as traditional DOCSIS modems.

channel

(Optional) Displays the number of downstream (DS) and upstream (US) channels used by a cable modem.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.3(21)BC

This command was introduced for the Cisco uBR10012 universal broadband router.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA.

12.2(33)SCB

This command output no longer shows the downstream (DS) channel ID or the bonding group (BG) ID. A new column was added to display the Receive Channel Configuration (RCC) ID of the RCC assigned to the cable modem.

12.2(33)SCE

This command was modified. The port parameter was changed to cable-interface-index.

12.2(33)SCF

This command was modified. The channel keyword and logical-channel-index argument was added.


Usage Guidelines

This command displays information for a one or more wideband CMs. Optionally, the CMs for which to display information can be identified IP address, MAC address, or cable interface.

If a wideband-capable CM is not able to register as a wideband CM (for example, if no wideband channel is available), the CM attempts to register as a traditional DOCSIS modem. The registered-traditional-docsis keyword limits the set of wideband CMs for which to display information to wideband-capable CMs that are currently registered as DOCSIS 1.X or DOCSIS 2.0 modems.

Examples

Example of the show cable modem wideband Command in a Cisco IOS Release Prior to Cisco IOS Release 12.2(33)SCB

The following is a sample output for the default form of the show cable modem wideband command on a Cisco uBR10012 router running a Cisco IOS Release prior to Cisco IOS Release 12.2(33)SCB:

Router# show cable modem wideband  
MAC Address    IP Address      I/F       MAC          Prim BG	DSID MD-DS-SG
                                         State        Sid   ID 
0014.bfbe.3cc0 1.11.0.1        C5/0/1/U0 w-online(pt)  3    24     24   N/A     
0016.92f0.90d6 1.11.0.4        C5/0/1/U0 w-online(pt)  5    24     272  1       
0014.bfbe.3cb8 1.11.0.2        C6/0/1/U0 w-online(pt)  3    36     36   N/A     
0016.92f0.90d8 1.11.0.3        C6/0/1/U0 w-online(pt)  5    36     274  1

Example of the show cable modem wideband Command in Cisco IOS Release 12.2(33)SCB

The following is a sample output for the default form of the show cable modem wideband command on a Cisco uBR10012 router running Cisco IOS Release 12.2(33)SCB:

Router# show cable modem wideband 
MAC Address    IP Address I/F       	MAC           Prim   RCC  MD-DS-SG
                                     State          Sid    ID
0014.bfbe.4694 30.2.0.3 	C8/0/0/U0 	w-online(pt)    3      1     1     
0018.6852.84aa 30.2.0.5 	C8/0/0/U0 	w-online(pt)    4      2     1     

Note The RCC ID refers to the output of the show cable mac-domain rcc command.


Examples of the show cable modem wideband channel Command in Cisco IOS Release 12.2(33)SCF

The following is a sample output of the show cable modem wideband channel command for all cable modems:

Router# show cable modem wideband channel
MAC Address    IP Address      I/F           MAC           DSxUS Primary
                                             State               WB
0018.6852.7b76 80.62.0.5       C6/1/0/U0     w-online      2x1   Wi6/1/0:1
0019.474a.c182 80.62.0.2       C6/1/0/U0     w-online      2x1   Wi6/1/0:1

The following is a sample output of the show cable modem wideband channel command for a specific cable modem identified by its IP address:

Router# show cable modem 80.62.0.5 wideband channel
MAC Address    IP Address      I/F           MAC           DSxUS Primary
                                             State               WB
0018.6852.7b76 80.62.0.5       C6/1/0/U0     w-online      2x1   Wi6/1/0:1

The following is a sample output of the show cable modem wideband channel command for a specific cable modem identified by its MAC address:

Router# show cable modem 0018.6852.7b76 wideband channel
MAC Address    IP Address      I/F           MAC           DSxUS Primary
                                             State               WB
0018.6852.7b76 80.62.0.5       C6/1/0/U0     w-online      2x1   Wi6/1/0:1

The following is a sample output of the show cable modem wideband channel command for a specific cable interface:

Router# show cable modem Cable 6/1/0  wideband channel
MAC Address    IP Address      I/F           MAC           DSxUS Primary
                                             State               WB
0018.6852.7b76 80.62.0.5       C6/1/0/U0     w-online      2x1   Wi6/1/0:1
0019.474a.c182 80.62.0.2       C6/1/0/U0     w-online      2x1   Wi6/1/0:1

Table 45 describes the fields that are shown in the show cable modem wideband display:

Table 45 Descriptions for the show cable modem wideband Fields 

Field
Description

MAC Address

MAC address for the CM.

IP Address

IP address that the DHCP server has assigned to the CM.

I/F

Cable interface providing the upstream for this CM.

MAC State

The current state of the MAC layer (see Table 46).

Prim SID

Primary SID assigned to this CM.

Bonding group ID

Identifier of the primary wideband channel.

DSID

Downstream Service Identifier.

DSxUS

Number of DS and US channels used by the CM.

Primary WB

Primary wideband channel for the CM.

MD-DS-SG

MAC Domain Downstream Service Group, the downstream channels of a single MAC domain that reach the cable modem.


Table 46 shows the possible values for the MAC State field for a wideband CM modem that registers as a traditional DOCSIS modem:

Table 46 Descriptions for the MAC State Field (for Traditional DOCSIS Modems) 1

MAC State Value
Description
Registration and Provisioning Status Conditions

init(r1)

The CM sent initial ranging.

init(r2)

The CM is ranging. The CMTS received initial ranging from the CM and has sent RF power, timing offset, and frequency adjustments to the CM.

init(rc)

Ranging has completed.

Note If a CM appears to be stuck in this state, it could be that the CM is able to communicate successfully on the cable network, but that the upstream is at capacity and does not have any additional bandwidth to allow the CM to finish registration and come online. Either manually move one or more CMs to other upstreams, or enable load balancing on the upstream using the cable load-balance group commands.

init(d)

The DHCP request was received, as DHCPDISCOVER. This also indicates that the first IP broadcast packet has been received from the CM.

init(dr)

The DHCP request has been sent to the cable modem.

init(i)

The cable modem has received the DHCPOFFER reply (DHCPACK) from the DHCP server that has assigned an IP address to the modem, but the modem has not yet replied with a DHCPREQUEST message requesting that particular IP address, nor has it sent an IP packet with that IP address.

Note If a CM appears to be stuck in this state, the CM has likely received the DHCPOFFER reply from the DHCP server, but this reply might have contained one or more invalid options for that particular CM.

init(io)

The Cisco CMTS has seen the DHCP offer as sent to the cable modem from the DHCP server that has assigned an IP address to the modem.

init(o)

The CM has begun to download the option file (DOCSIS configuration file) using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP response. If the CM remains in this state, it indicates that the download has failed.

init(t)

Time-of-day (TOD) exchange has started.

resetting

The CM is being reset and will shortly restart the registration process.

Non-error Status Conditions

cc(r1)

The CM had registered and was online, but has received a Downstream Channel Change (DCC) or Upstream Channel Change (UCC) request message from the CMTS. The CM has begun moving to the new channel, and the CMTS has received the CM's initial ranging on the new downstream or upstream channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

cc(r2)

This state should normally follow cc(r1) and indicates that the CM has finished its initial ranging on the new channel, and is currently performing continuous ranging on the new channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.

offline

The CM is considered offline (disconnected or powered down).

online

The CM has registered and is enabled to pass data on the network.

online(d)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. The CM does not forward traffic to or from the CPE devices, but the CMTS can continue to communicate with the CM using DOCSIS messages and IP traffic (such as SNMP commands).

Note If BPI was enabled in the DOCSIS configuration file sent to the CM, assume that the CM is using BPI encryption, unless other messages show that the BPI negotiation and key assignments have failed.

online(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and KEK is assigned.

Note This state is equivalent to the online(d) and online(pk) states.

online(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note This state is equivalent to the online(d) and online(pt) states.

online(pk)

The CM registered, BPI is enabled and KEK is assigned.

online(pt)

The CM registered, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note If network access was disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) instead of online(pt) even when BPI encryption is enabled and operational.

Note If an exclamation point (!) appears in front of one of the online states, it indicates that the cable dynamic-secret command has been used with either the mark or reject option, and that the cable modem has failed the dynamic secret authentication check.

expire(pk)

The CM registered, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

expire(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pk) states.

expire(pt)

The CM registered, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

expire(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the online(d) and expire(pt) states.

Error Status Conditions

reject(m)

The CM attempted to register but registration was refused due to a bad Message Integrity Check (MIC) value. This also could indicate that the shared secret in the DOCSIS configuration file does not match the value configured on the CMTS with the cable shared-secret command.

In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases, this could also indicate that the cable tftp-enforce command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so.

reject(c)

The CM attempted to register, but registration was refused due to a a number of possible errors:

The CM attempted to register with a minimum guaranteed upstream bandwidth that would exceed the limits imposed by the cable upstream admission-control command.

The CM has been disabled because of a security violation.

A bad class of service (COS) value in the DOCSIS configuration file.

The CM attempted to create a new COS configuration but the CMTS is configured to not permit such changes.

The CM failed the timestamp check for its DOCSIS configuration file. (This could indicate a possible theft-of-service attempt, or a problem with the synchronization of the clocks on the CM and CMTS.)

reject(pk)

KEK key assignment is rejected, BPI encryption has not been established.

reject(pkd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because KEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pk) states.

reject(pt)

TEK key assignment is rejected, BPI encryption has not been established.

reject(ptd)

The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because TEK key assignment was rejected.

Note This state is equivalent to the online(d) and reject(pt) states.

reject(ts)

The CM attempted to register, but registration failed because the TFTP server timestamp in the CM registration request did not match the timestamp maintained by the CMTS. This might indicate that the CM attempted to register by replaying an old DOCSIS configuration file used during a prior registration attempt.

reject(ip)

The CM attempted to register, but registration failed because the IP address in the CM request did not match the IP address that the TFTP server recorded when it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.

reject(na)

The CM attempted to register, but registration failed because the CM did not send a Registration-Acknowledgement (REG-ACK) message in reply to the Registration-Response (REG-RSP) message sent by the CMTS. A Registration-NonAcknowledgement (REG-NACK) is assumed.

1 The CM MAC state field can also be retrieved using SNMP by getting the value of the cdxCmtsCmStatusValue object in the CISCO-DOCS-EXT-MIB.



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.


Table 47 shows the possible values for the MAC state field for a wideband-capable CM that registers as a wideband modem:

Table 47 Additional MAC States for a Wideband Cable Modem

MAC State Value
Description
Non-error Status Conditions

w-online

The WCM has registered and is enabled to pass data on the network.

w-online(d)

The WCM registered, but network access for CPE devices using this WCM has been disabled through the DOCSIS configuration file. The CM does not forward traffic to or from the CPE devices, but the WCMTS can continue to communicate with the WCM using DOCSIS messages and IP traffic (such as SNMP commands).

Note If BPI was enabled in the DOCSIS configuration file sent to the WCM, assume that the CM is using BPI encryption, unless other messages show that the BPI negotiation and key assignments have failed.

w-online(pkd)

The WCM registered, but network access for CPE devices using this WCM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and KEK is assigned.

Note This state is equivalent to the w-online(d) and w-online(pk) states.

w-online(pt)

The WCM registered, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note If network access was disabled in the DOCSIS configuration file sent to the WCM, the network disabled status takes precedence, and the MAC status field shows w-online(d) instead of w-online(pt) even when BPI encryption is enabled and operational.

w-online(ptd)

The WCM registered, but network access for CPE devices using this WCM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and TEK is assigned. BPI encryption is now being performed.

Note This state is equivalent to the w-online(d) and w-online(pt) states.

w-online(pk)

The WCM registered, BPI is enabled and KEK is assigned.

w-expire(pk)

The WCM registered, BPI is enabled, KEK was assigned, but the current KEK expired before the WCM could successfully renew a new KEK value.

w-expire(pkd)

The WCM registered, but network access for CPE devices using this WCM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.

Note This state is equivalent to the w-online(d) and w-expire(pk) states.

w-expire(pt)

The WCM registered, BPI is enabled, TEK was assigned, but the current TEK expired before the WCM could successfully renew a new KEK value.

w-expire(ptd)

The WCM registered, but network access for CPE devices using this WCM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, TEK was assigned, but the current TEK expired before the WCM could successfully renew a new KEK value.

Note This state is equivalent to the w-online(d) and w-expire(pt) states.

Error Status Conditions

w-reject(pk)

KEK key assignment is rejected, BPI encryption has not been established.

w-reject(pkd)

The WCM registered, but network access for CPE devices using this WCM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because KEK key assignment was rejected.

Note This state is equivalent to the w-online(d) and w-reject(pk) states.

w-reject(pt)

TEK key assignment is rejected, BPI encryption has not been established.

w-reject(ptd)

The WCM registered, but network access for CPE devices using this WCM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because TEK key assignment was rejected.

Note This state is equivalent to the w-online(d) and w-reject(pt) states.


Related Commands

Command
Description

show cable modem vendor

Associates the name of a vendor with its Organizational Unique Identifier (OUI).

show cable modem

Displays information for the registered and unregistered CMs.

show cable modem summary

Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.

show cable modem classifiers

Displays information about the classifiers for a particular CM.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.

show cable modem connectivity

Displays connectivity statistics for one or more CMs.

show cable modem errors

Displays error statistics for one or more CMs.

show cable modem flap

Displays flap list statistics for one or more cable modems.

show cable modem maintenance

Displays station maintenance (SM) error statistics for one or more cable modems.

show cable modem remote-query

Displays information collected by the remote-query feature.

show cable modem rf-adapt

Displays RF adaptation information for cable modems.

show cable modulation-profile

Displays modulation profile group information.

show interface cable modem

Displays information about the CMs connected to a particular cable interface.

show interface cable sid

Displays cable interface information.


show cable modem wideband primary-channel

To display primary-channel information for a wideband channel, use the show cable modem wideband primary-channel command in privileged EXEC mode.

show cable modem [ip-address | mac-address] wideband primary-channel

Syntax Description

ip-address

Identifies the IP address of a specific cable modem to be displayed. If you specify the IP address for a CPE device behind a cable modem, information for that cable modem is displayed.

mac-address

Identifies the MAC address of a specific cable modem to be displayed. You can also specify the MAC address for a CPE device behind a cable modem, and information for that cable modem will be displayed.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(23)BC

This command was introduced for the Cisco uBR10012 router.


Usage Guidelines

This command displays primary-channel information for a wideband channel that is associated with a specific MAC address or IP address of a cable modem or CPE device behing the cable modem.

Related Commands

Command
Description

show cable modem

Displays information for the registered and unregistered cable modems.

show cable modem primary-channel summary total

Displays information for the wideband and narrowband cable modems and location of the primary downstream channel.


show cable modem wideband rcs-status

To display details of events for each RF channel in the cable modem's receive channel configuration (RCC), use the show cable modem wideband rcs-status command in privileged EXEC mode.

show cable modem [mac-address | ip-address |cable slot/subslot/port] wideband rcs-status

Syntax Description

mac-address

(Optional) Specifies the MAC address of a wideband CM to be displayed.

ip-address

(Optional) Specifies the IP address of a wideband CM to be displayed.

cable slot/subslot/port

Optional) Identifies a cable interface on the Cisco uBR10012 router. The following are the valid values:

slot—Specifies the chassis slot number of the cable interface line card. Valid values are 5to 8.

subslot—Specifies the secondary slot number of the cable interface line card. Valid subslots are 0 or 1.

port—Specifies the port number. Valid values are 0 to 4 (depending on the cable interface).


Command Default

No default behavior or values.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCB

This command was introduced.


Examples

The following is a sample output of the show cable modem wideband rcs-status command on a wideband cable interface:

Router# show cable modem wideband rcs-status
CM  : 0019.474a.c0ba
RF  : 1/0/0 10
  Status                   : UP
  FEC/QAM Failure          : 0         
  Dup FEC/QAM Failure      : 0         
  FEC/QAM Recovery         : 0         
  Dup FEC/QAM Recovery     : 0         
  MDD Failure              : 0         
  Dup MDD Failure          : 0         
  MDD Recovery             : 0         
  Dup MDD Recovery         : 0         
  Flaps                    : 0         
  Flap Duration            : 00:00
RF  : 1/0/0 11
  Status                   : UP
  FEC/QAM Failure          : 0         
  Dup FEC/QAM Failure      : 0         
  FEC/QAM Recovery         : 0         
  Dup FEC/QAM Recovery     : 0         
  MDD Failure              : 0         
  Dup MDD Failure          : 0         
  MDD Recovery             : 0         
  Dup MDD Recovery         : 0         
  Flaps                    : 0         
  Flap Duration            : 00:00

Related Commands

Command
Description

show cable modem summary wb-rf

Displays the number of RFs that are down on a cable interface.


show cable modulation-profile

To display modulation profile group information for a Cisco CMTS, use the show cable modulation-profile command in privileged EXEC mode.

show cable modulation-profile [profile [verbose] ] [iuc-code]

show cable modulation-profile cable {slot/port | slot/subslot/port} [upstream port]

Syntax Description

profile

(Optional) Profile number. Valid values start with 1.

verbose

(Optional) Displays detailed information for an individual profile.

iuc-code

(Optional) Internal usage code (IUC). Valid options are:

a-long—Advanced Phy Long Grant Burst (IUC 10)
a-short—Advanced Phy Short Grant Burst (IUC 9)
a-ugs—Advanced Phy Unsolicited Grant Burst (IUC 11)
initial—Initial Ranging Burst (IUC 3)
long—Long Grant Burst (IUC 6)
reqdata—Request/Data Burst (IUC 2) 1
request—Request Burst (IUC 1)
short—Short Grant Burst (IUC 5)
station—Station Ranging Burst (IUC 4)

cable slot/port

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

cable slot/subslot/port

Identifies a 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)

upstream port

(Optional) Displays information for a particular upstream on the selected cable interface. The port value starts with 0 and continues up, depending on the type of cable interface card.

1 The Cisco CMTS recognizes the reqdata burst type but does not use it.


Command Modes

Privileged EXEC

Command History

Release
Modification

11.3 XA

This command was first introduced.

12.(0)5T1, 12.0(6)SC, 12.1(2)EC

This command was supported, replacing the show cable burst-profile command.

12.1(3a)EC

This reqdata type was added as a placeholder for scripts that might reference it, but the DOCSIS MAC scheduler on the Cisco CMTS does not use this type of burst.

12.2(15)CX

Support was added for the Cisco uBR-MC28U/X cable interface line card, including support for DOCSIS 2.0 A-TDMA and mixed modulation profiles. This includes adding additional information to the command's display, as well as adding the a-long, a-short, a-ugs, and verbose options.

12.2(15)CX1

Added the ability to display the modulation profiles being used by a particular cable interface and upstream.

12.2(15)BC2

This command displays all default modulation profiles 1, 21, 41, 101, 121, 201, 221, and 241), even when the cable interface card that is associated with those profiles is not installed. Previous releases displayed only the default modulation profiles that were in use.


Usage Guidelines

The show cable modulation-profile command displays modulation profile group information. A modulation profile is a collection of burst profiles that are sent out in a Upstream Channel Descriptor (UCD) message to configure a modem's transmit parameters for an upstream message burst type.

Table 0-48 shows the IUC codes for each burst type:

Table 0-48 Internal Usage Code Types 

IUC
Type
IUC
Type

IUC 1

Request Burst (req)

IUC 7

Not used

IUC 2

Request/Data Burst (reqdata)1

IUC 8

Not used

IUC 3

Initial Ranging Burst (initial)

IUC 9

Advanced Phy Short Grant Burst (a-short)

IUC 4

Station Ranging Burst (station)

IUC 10

Advanaced Phy Long Grant Burst (a-long)

IUC 5

Short Grant Burst (short)

IUC 11

Advanaced Phy Unsolicited Grant Burst (a-ugs)

IUC 6

Long Grant Burst (long)

IUC 12

Not used

1 The Cisco CMTS recognizes the reqdata burst type but does not use it.


Modulation Profile Ranges

The ranges for modulation profiles depends on the cable interface being used and the type of modulation profile being created. Table 0-49 lists the valid ranges according to cable interface and modulation type:

Table 0-49 Allowable Ranges for Modulation Profiles

Cable Interface
DOCSIS 1.X (TDMA)
Mixed DOCSIS 1.X/2.0
DOCSIS 2.0 (A-TDMA)

Cisco uBR7100 series

1 to 101 , default=1

N/A

N/A

Cisco uBR-MC16C

1 to 10, default=1

N/A

N/A

Cisco uBR-MC16S

1 to 10, default=1

N/A

N/A

Cisco uBR-MC28C

1 to 10, default=1

N/A

N/A

Cisco uBR10-MC5X20S, Cisco uBR10-MC5X20U, Cisco uBR10-MC5X20H

21 to 30, default=21

121 to 130, default=121

221 to 230, default=221

Cisco uBR-MC16U/X, Cisco uBR-MC28U/X

41 to 50, default=41

141 to 150, default=141

241 to 250, default=241

1 Only 8 modulation profiles are supported in Cisco IOS software releases before 12.2(15)BC1, so in these releases the valid range is 1 to 8.



Note Default modulation profiles are created for each type of card and operation mode. You cannot delete the default modulation profiles (1, 21, 41, 101, 121, 201, 221, and 241). In Cisco IOS Release 12.2(15)BC2 and later, all default modulation profiles are displayed, even when that particular cable interface is not installed. In previous versions, only the default modulation profiles that were in use were displayed.


Examples

The following is sample output from the show cable modulation-profile command in Cisco IOS Release 12.2(11)BC3 and earlier releases:

CMTS01# show cable modulation-profile 
Mo IUC     Type  Preamb Diff FEC     FEC   Scrambl Max  Guard Last Scrambl Preamb
                 length enco T       CW    seed    B    time  CW           offset
                             bytes   size          size size  short
1  request qpsk   64     no   0x0    0x10  0x152   1    8     no     yes     56
1  initial qpsk   128    no   0x5    0x22  0x152   0    48    no     yes     0
1  station qpsk   128    no   0x5    0x22  0x152   0    48    no     yes     0
1  short   qpsk   72     no   0x5    0x4B  0x152   0    8     no     yes     48

The following is sample output from the show cable modulation-profile command in Cisco IOS Release 12.2(15)CX and later releases:

Router# show cable modulation-profile 
Mod IUC     Type  Pre Diff FEC  FEC  Scrmb Max Guard Last Scrmb Pre   Pre   RS
                  len enco T    k    seed  B   time  CW         offst Type
                           BYTE BYTE       siz size  short
1   request qpsk  64  no   0x0  0x10 0x152 0   8     no   yes   184   qpsk  na 
1   initial qpsk  128 no   0x5  0x22 0x152 0   48    no   yes   128   qpsk  na 
1   station qpsk  128 no   0x5  0x22 0x152 0   48    no   yes   128   qpsk  na 
1   short   qpsk  72  no   0x4  0x4C 0x152 12  8     yes  yes   176   qpsk  na 
1   long    qpsk  80  no   0x9  0xEC 0x152 0   8     yes  yes   168   qpsk  na 
41  request qpsk  68  no   0x0  0x10 0x152 0   8     no   yes   0     qpsk  na 
41  initial qpsk  128 no   0x5  0x22 0x152 0   48    no   yes   0     qpsk  na 
41  station qpsk  128 no   0x5  0x22 0x152 0   48    no   yes   0     qpsk  na 
41  short   qpsk  80  no   0x4  0x4C 0x152 12  8     yes  yes   0     qpsk  na 
41  long    qpsk  80  no   0x8  0xEC 0x152 0   8     yes  yes   0     qpsk  na 
45  request qpsk  68  no   0x0  0x10 0x152 0   8     no   yes   0     qpsk  na 
45  initial qpsk  128 no   0x5  0x22 0x152 0   48    no   yes   0     qpsk  na 
45  station qpsk  128 no   0x5  0x22 0x152 0   48    no   yes   0     qpsk  na 
45  short   16qam 160 no   0x6  0x4C 0x152 7   8     yes  yes   0     16qam na 
45  long    16qam 160 no   0x8  0xE7 0x152 0   8     yes  yes   0     16qam na 
141 request qpsk  68  no   0x0  0x10 0x152 0   8     no   yes   0     qpsk  na 
141 initial qpsk  128 no   0x5  0x22 0x152 0   48    no   yes   0     qpsk  na 
141 station qpsk  128 no   0x5  0x22 0x152 0   48    no   yes   0     qpsk  na 
141 short   16qam 160 no   0x6  0x4C 0x152 7   8     yes  yes   0     16qam na 
141 long    16qam 160 no   0x8  0xE7 0x152 0   8     yes  yes   0     16qam na 
141 a-short 32qam 160 no   0x9  0x4C 0x152 6   8     yes  yes   0     qpsk1 no 
141 a-long  64qam 196 no   0xC  0xE7 0x152 0   8     yes  yes   0     qpsk1 no 
241 request qpsk  68  no   0x0  0x10 0x152 0   8     no   yes   0     qpsk0 no 
241 initial qpsk  128 no   0x5  0x22 0x152 0   48    no   yes   0     qpsk0 no 
241 station qpsk  128 no   0x5  0x22 0x152 0   48    no   yes   0     qpsk0 no 
241 a-short 32qam 160 no   0x9  0x4C 0x152 6   8     yes  yes   0     qpsk1 no 
241 a-long  64qam 196 no   0xC  0xE7 0x152 0   8     yes  yes   0     qpsk1 no 
241 a-ugs   16qam 80  no   0x3  0xE7 0x152 0   8     yes  yes   0     qpsk1 no 
242 request qpsk  68  no   0x0  0x10 0x152 0   8     no   yes   0     qpsk0 no 
242 initial qpsk  128 no   0x5  0x22 0x152 0   48    no   yes   0     qpsk0 no 
242 station qpsk  128 no   0x5  0x22 0x152 0   48    no   yes   0     qpsk0 no 
242 a-short qpsk  80  no   0x4  0x4C 0x152 12  8     yes  yes   0     qpsk0 no 
242 a-long  qpsk  68  no   0x8  0xEC 0x152 0   8     yes  yes   0     qpsk0 no 
242 a-ugs   qpsk  80  no   0x0  0xEC 0x152 0   8     yes  yes   0     qpsk0 no 
243 request 64qam 132 no   0x4  0x10 0x152 0   8     no   yes   0     qpsk1 no 
243 initial 64qam 128 no   0x5  0x22 0x152 0   48    no   yes   0     qpsk1 no 
243 station 64qam 128 no   0x5  0x22 0x152 0   48    no   yes   0     qpsk1 no 
243 a-short 64qam 160 no   0x9  0x4C 0x152 5   8     yes  yes   0     qpsk1 no 
243 a-long  64qam 196 no   0xC  0xE7 0x152 0   8     yes  yes   0     qpsk1 no 
243 a-ugs   64qam 100 no   0x7  0xE7 0x152 0   8     yes  yes   0     qpsk1 no 
244 request 64qam 132 no   0x4  0x10 0x152 0   8     no   yes   0     qpsk1 no 
244 initial 64qam 128 no   0x5  0x22 0x152 0   48    no   yes   0     qpsk1 no 
244 station 64qam 128 no   0x5  0x22 0x152 0   48    no   yes   0     qpsk1 no 
244 a-short 64qam 160 no   0x9  0x4C 0x152 5   8     yes  yes   0     qpsk1 no 
244 a-long  64qam 196 no   0xC  0xE7 0x152 0   8     yes  yes   0     qpsk1 no 
244 a-ugs   64qam 32  no   0xA  0xC8 0x152 255 32    yes  yes   0     qpsk1 yes
245 initial qpsk  32  no   0xA  0xC8 0x152 32  32    no   yes   0     qpsk1 yes
245 station qpsk  32  no   0xA  0xC8 0x152 32  32    yes  yes   0     qpsk1 yes
245 a-short 64qam 64  no   0xA  0xC8 0x152 32  32    yes  yes   0     qpsk1 yes
245 a-long  64qam 32  no   0xA  0xC8 0x152 252 32    yes  yes   0     qpsk1 yes
245 a-ugs   64qam 32  no   0xA  0xC8 0x152 32  32    yes  yes   0     qpsk1 yes
Router#

The following shows sample output from the show cable modulation-profile command for a mixed mode modulation profile (TDMA/A-TDMA) on the Cisco uBR10-MC5X20S cable interface line card:

Router# show cable modulation-profile 121 
Mod IUC     Type  Pre Diff FEC  FEC  Scrmb Max Guard Last Scrmb Pre   Pre   RS
                  len enco T    k    seed  B   time  CW         offst Type
                           BYTE BYTE       siz size  short
121 request qpsk  32  no   0x0  0x10 0x152 0   20    no   yes   0     qpsk  na 
121 initial qpsk  64  no   0x5  0x22 0x152 0   48    no   yes   64    qpsk  na 
121 station qpsk  64  no   0x5  0x22 0x152 0   48    no   yes   64    qpsk  na 
121 short   qpsk  64  no   0x5  0x4B 0x152 6   20    yes  yes   64    qpsk  na 
121 long    qpsk  64  no   0x8  0xDC 0x152 0   20    yes  yes   64    qpsk  na 
121 a-short 64qam 128 no   0x5  0x63 0x152 10  20    yes  yes   192   qpsk0 no 
121 a-long  64qam 128 no   0xF  0xC8 0x152 0   20    yes  yes   192   qpsk0 no 
Router# 

The following shows sample output from the show cable modulation-profile command for two DOCSIS 2.0 modulation profiles (A-TDMA) on the Cisco uBR10-MC5X20S cable interface line card:

Router# show cable modulation-profile 221 
Mod IUC     Type  Pre Diff FEC  FEC  Scrmb Max Guard Last Scrmb Pre   Pre   RS
                  len enco T    k    seed  B   time  CW         offst Type
                           BYTE BYTE       siz size  short
221 request qpsk  64  no   0x0  0x10 0x152 0   8     no   yes   184   qpsk0 na 
221 initial qpsk  128 no   0x5  0x22 0x152 0   48    no   yes   0     qpsk0 na 
221 station qpsk  128 no   0x5  0x22 0x152 0   48    no   yes   0     qpsk0 na 
221 short   qpsk  72  no   0x5  0x4B 0x152 6   8     yes  yes   176   qpsk0 na 
221 long    qpsk  80  no   0x8  0xDC 0x152 0   8     yes  yes   168   qpsk0 na 
221 a-short 64qam 128 no   0x5  0x63 0x152 10  20    yes  yes   192   qpsk0 no 
221 a-long  64qam 128 no   0xF  0xC8 0x152 0   20    yes  yes   192   qpsk0 no 
Router# show cable modulation-profile 241 
Mod IUC     Type  Pre Diff FEC  FEC  Scrmb Max Guard Last Scrmb Pre   Pre   RS
                  len enco T    k    seed  B   time  CW         offst Type
                           BYTE BYTE       siz size  short
241 request qpsk  68  no   0x0  0x10 0x152 0   8     no   yes   0     qpsk0 no 
241 initial qpsk  2   no   0x0  0x10 0x0   0   0     no   no    0     qpsk1 no 
241 station qpsk  128 no   0x5  0x22 0x152 0   48    no   yes   0     qpsk0 no 
241 a-short 32qam 160 no   0x9  0x4C 0x152 6   8     yes  yes   0     qpsk1 no 
241 a-long  64qam 132 no   0xC  0xE7 0x152 0   8     yes  yes   0     qpsk1 no 
241 a-ugs   16qam 80  no   0x3  0xE7 0x152 0   8     yes  yes   0     qpsk1 no 
Router# 

The following shows sample output for the upstream option, which displays the modulation profile currently being used by a particular upstream:

Router# show cable modulation-profile cable 4/1 upstream 1 
Mod  IUC     Type  Pre Diff FEC  FEC  Scrmb  Max Guard Last Scrmb Pre   Pre   RS
                   len enco T    k    seed   B   time  CW         offst Type
                            BYTE BYTE        siz size  short
41   request qpsk  64  no   0x0  0x10 0x152  0   8     no   yes   396  qpsk  na 
41   initial qpsk  128 no   0x5  0x22 0x152  0   48    no   yes   6    qpsk  na 
41   station qpsk  128 no   0x5  0x22 0x152  0   48    no   yes   6    qpsk  na 
41   short   qpsk  88  no   0x5  0x4C 0x152  35  42    yes  yes   396  qpsk  na 
41   long    qpsk  76  no   0x6  0xE8 0x152  135 143   yes  yes   396  qpsk  na 
Router# 

The following example shows typical detailed output for an individual modulation profile that is displayed when using the verbose option. Each IUC is described in detail.

Router# show cable modulation-profile 1 verbose 
Modulation Profile Number:      1
Burst:                          tdma
IUC:                            request (IUC 1)
Modulation:                     qpsk
Preamble length:                64
Differential Encoding:          off
FEC parity T bytes:             0x0
FEC codeword length K bytes:    0x10
Scrambler seed:                 0x152
Max short burst size B bytes:   0
Guard time size in symbols:     8
Shortened last codeword:        no
Scrambler:                      enabled
Preamble offset:                184
Preamble type:                  qpsk0
RS interleaver on:              na
RS interleaver depth:           0
RS interleaver block size:      0
Modulation Profile Number:      1
Burst:                          tdma
IUC:                            initial maintenance (IUC 3)
Modulation:                     qpsk
Preamble length:                128
Differential Encoding:          off
FEC parity T bytes:             0x5
FEC codeword length K bytes:    0x22
Scrambler seed:                 0x152
Max short burst size B bytes:   0
Guard time size in symbols:     48
Shortened last codeword:        no
Scrambler:                      enabled
Preamble offset:                0
Preamble type:                  qpsk0
RS interleaver on:              na
RS interleaver depth:           0
RS interleaver block size:      0
Modulation Profile Number:      1
Burst:                          tdma
IUC:                            station maintenance (IUC 4)
Modulation:                     qpsk
Preamble length:                128
Differential Encoding:          off
FEC parity T bytes:             0x5
FEC codeword length K bytes:    0x22
Scrambler seed:                 0x152
Max short burst size B bytes:   0
Guard time size in symbols:     48
Shortened last codeword:        no
Scrambler:                      enabled
Preamble offset:                0
Preamble type:                  qpsk0
RS interleaver on:              na
RS interleaver depth:           0
RS interleaver block size:      0
Modulation Profile Number:      1
Burst:                          tdma
IUC:                            short grant (IUC 5)
Modulation:                     qpsk
Preamble length:                72
Differential Encoding:          off
FEC parity T bytes:             0x5
FEC codeword length K bytes:    0x4B
Scrambler seed:                 0x152
Max short burst size B bytes:   6
Guard time size in symbols:     8
Shortened last codeword:        yes
Scrambler:                      enabled
Preamble offset:                176
Preamble type:                  qpsk0
RS interleaver on:              na
RS interleaver depth:           0
RS interleaver block size:      0
Modulation Profile Number:      1
Burst:                          tdma
IUC:                            long grant (IUC 6)
Modulation:                     qpsk
Preamble length:                80
Differential Encoding:          off
FEC parity T bytes:             0x8
FEC codeword length K bytes:    0xDC
Scrambler seed:                 0x152
Max short burst size B bytes:   0
Guard time size in symbols:     8
Shortened last codeword:        yes
Scrambler:                      enabled
Preamble offset:                168
Preamble type:                  qpsk0
RS interleaver on:              na
RS interleaver depth:           0
RS interleaver block size:      0
Router# 

Table 0-50 describes the significant fields displayed by the show cable modulation-profile command.

.

Table 0-50 show cable modulation-profile Field Descriptions 

Field
Description

Mo

Modulation profile group number. A modulation profile group is the set of burst profiles that defines upstream transmit characteristics for the various types of upstream transmission classes.

IUC

Interval usage code. Each upstream transmit burst belongs to a class that is given a number called the interval usage code (IUC). Bandwidth maps messages (MAP) by IUC codes used to allocate upstream time slots. The following types are currently defined:

Request—Bandwidth request slot

Request Data—Bandwidth request and short data burst slot

Initial Maintenance—Initial link registration contention slot

Station Maintenance—Link keepalive slot

Short Data Grant—Short data burst slot

Long Data Grant—Long data burst slot

Type

Modulation type.

Preamb length

Preamble length.

Diff enco

Differential encoding enabled (yes) or not enabled (no).

FEC T bytes

Number of bytes that can be corrected for each forward error correction (FEC) code word.

FEC CW size

Size, in bytes, of the FEC code word.

Scrambl seed

Scrambler seed value in hex format.

Max B size

Maximum burst size.

Guard time size

Time between successive bursts measured in symbols.

Last CW short

Handling of FEC for shortened last code word.

Scrambl

Scrambler enabled (yes) or not enabled (no).

Preamb offset

(DOCSIS 1.0 and DOCSIS 1.1 modulation profiles) The bits to be used for the preamble value.

Pre offst

(DOCSIS 2.0 modulation profiles) The bits to be used for the preamble value.

Pre Type

(DOCSIS 2.0 modulation profiles) The A-TDMA preamble type (qpsk0 or qpsk1).

RS

(DOCSIS 2.0 modulation profiles) The A-TDMA RS encoding type.



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 upstream modulation-profile

Configures a spectrum group to use a specified frequency.

show cable hop

Displays CM configuration settings.

show interface cable sid

Displays cable interface information.


show cable multicast authorization

To display the list of defined multicast authorization profiles and all CMs associated with corresponding profiles, use the show cable multicast authorization command in privileged EXEC mode.

show cable multicast authorization {profile-group {profile-group-number | all} profile-list {profile-number | all} }

Syntax Description

profile-group

Displays the profile group.

profile-group-number

Displays the profile number.

all

Displays all profile groups.

profile-list

Displays the profile list.

profile-number

Displays the profile number.

all

Displays all profiles.


Command Default

No default behavior or values.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCB

This command was introduced.

12.2(33)SCC

The command output was modified to display profile description for the specified profile.


Usage Guidelines

Use this command to display all the profile groups, profile descriptions, and CMs associated with the profiles.

Examples

The following command shows all the profile groups and rules associated with it:

Router# show cable multicast authorization profile-group all
Profile-Group Index: 1
   CMs using this group: 2
   ProfileId   CMs        Profile
   ------------------------------
     0         2         prof1
     1         2         prof2
     2         2         prof3
 Session-Rule List:
   Group / Source                                   Prio  Action
   -------------------------------------------------------------
   grp: FF15::1/64                                  1     permit
   src: 0::0/0
   grp: FF15::1/64                                  1     permit
   src: 1234::1/64
   grp: 224.1.1.1/16                                1     permit
   src: 0.0.0.0/0
   grp: FF16::1/64                                  1     permit
   src: 0::0/0
   grp: 224.1.1.1/16                                1     permit
   src: 1.1.1.1/16
   -------------------------------------------------------------

The following command shows a particular profile group and rules associated with it:

Router# show cable multicast authorization profile-group 1
Profile-Group Index: 1
   CMs using this group: 2
   ProfileId   CMs        Profile
   ------------------------------
     0         2         prof1
     1         2         prof2
     2         2         prof3
 Session-Rule List:
   Group / Source                                   Prio  Action
   -------------------------------------------------------------
   grp: FF15::1/64                                  1     permit
   src: 0::0/0
   grp: FF15::1/64                                  1     permit
   src: 1234::1/64
   grp: 224.1.1.1/16                                1     permit
   src: 0.0.0.0/0
   grp: FF16::1/64                                  1     permit
   src: 0::0/0
   grp: 224.1.1.1/16                                1     permit
   src: 1.1.1.1/16
   -------------------------------------------------------------

The following command shows all the profiles and their profile descriptions, and the session rules for each profile.

Router# show cable multicast authorization profile-list all
CMTS Authorization Profile List
-------------------------------
Profile-Index: 0    Name: prof1
   Number of CMs: 2
   Id         Group / Source                                   Prio  Action
   ------------------------------------------------------------------------
   1          grp: FF15::1/64                                  1     permit
              src: 0::0/0
   2          grp: FF15::1/64                                  1     permit
              src: 1234::1/64
   3          grp: 224.1.1.1/16                                1     permit
              src: 0.0.0.0/0
   4          grp: FF16::1/64                                  1     permit
              src: 0::0/0
   5          grp: 224.1.1.1/16                                1     permit
              src: 1.1.1.1/16
   ------------------------------------------------------------------------
Profile-Index: 1    Name: prof2
   Number of CMs: 2
   Id         Group / Source                                   Prio  Action
   ------------------------------------------------------------------------
   ------------------------------------------------------------------------
Profile-Index: 2    Name: prof3
   Number of CMs: 2
   Id         Group / Source                                   Prio  Action
   ------------------------------------------------------------------------
   ------------------------------------------------------------------------

The following command shows a particular profile and its description.

Router# show cable multicast authorization profile-list 3
CMTS Authorization Profile List
-------------------------------
Profile-Index: 3    Name: gold
   Number of CMs: 0
   Profile Description: gold profile for higher bandwidth
   Id         Group / Source                                   Prio  Action
   ------------------------------------------------------------------------
   ------------------------------------------------------------------------

Table 38 describes the significant fields shown in the display.

Table 51 show cable multicast authorization Field Descriptions 

Field
Description

Profile-Group Index

Displays the profile group index.

Name

Displays the name of the profile group.

Profile Description

Displays the description given to the profile.

ProfileId

Displays the QoS profile being used.

CMs

Displays the CMs belonging to the profile.

Profile

Displays the profile being used for multicast.

Session-Rule List

Displays the list of session rules being used for the multicast.

Source (src)

Displays the source IP address.

Group (grp)

Displays the group IP address.

Priority

Displays the rule priority value.

Action

Displays the action taken for multicast.


Related Commands

Command
Description

cable multicast auth enable default-action

Configures cable multicast authorization profile and sets the maximum sessions limit.

cable multicast auth profile-name

Configures cable multicast authorization profile.

profile description

Configures profile descriptions for each profile in the selected cable multicast authorization profile.

show cable multicast db

Displays the contents of multicast explicit tracking database.

show cable multicast dsid

Displays the entire DSID database content.

show cable multicast qos

Displays the configuration information for MQoS, (Group-Config, Group-QoS-Config, Group-Encryption-Config).


show cable multicast db

To display the contents of the multicast explicit tracking database, use the show cable multicast db command in privileged EXEC mode.

show cable multicast db [bundle bundle-interface [ipv4-address | ipv6-address | summary] | cm-mac [host-mac-add | hosts | proxy] | summary | client pcmm] | [detail]

Syntax Description

bundle bundle-interface

(Optional) Displays the bundle interface.

For example, Bundle 10.

ipv4-address

(Optional) IPv4 address.

ipv6-address

(Optional) IPv6 address of the group that should be matched using the format X:X:X:X:X.

cm-mac

(Optional) MAC address of the cable modem.

host-mac-add

(Optional) Host MAC address.

hosts

(Optional) Displays host details.

proxy

(Optional) Displays proxy details.

summary

(Optional) Displays the bundle interface summary or the multicast explicit tracking database summary.

client

(Optional) Displays entries by the client type.

pcmm

(Optional) Displays all PacketCable multimedia (PCMM) client entries.

detail

(Optional) Displays additional information related to the multicast explicit tracking database.


Command Default

None

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCB

This command was introduced.

12.2(33)SCE

This command was modified. The following two keywords were added to this command:

client

pcmm

12.2(33)SCF

This command was modified. A new keyword, detail, was added to provide additional information related to the multicast explicit tracking database.


Usage Guidelines

Starting with Cisco IOS Release 12.2(33)SCF:

There is an Explicit Tracking Database (ETDB) entry for each static multicast configuration.

The total number of replications supported on each chassis is restricted to a maximum of 5000 replications.

The total number of replications corresponding to static multicast is restricted to a maximum of 1500 replications.

The show cable multicast db detail command is not applicable for ETDB entries created by the static TLV.

Examples

The following is a sample output from the show cable multicast db command:

Router# show cable multicast db
Interface : Bundle1
Session (S,G) : (*,230.1.1.1)        
Fwd Intfc  Sub Intfc  Host Intfc  CM Mac          Hosts 
w1/0/0:0                          aaaa.bbbb.cccc      2
w1/0/0:0                          aaaa.bbbb.cccc      2
Session (S,G) : (255.255.255.255,255.255.255.255)
Fwd Intfc  Sub Intfc  Host Intfc  CM Mac          Hosts 
w1/0/0:0                          aabb.bbcc.ccdd      3
Interface : Bundle2
Session (S,G) : (*,230.1.1.1)        
Fwd Intfc  Sub Intfc  Host Intfc  CM Mac          Hosts 
w1/0/0:0                          aaaa.bbbb.cccc      2
w1/0/0:0                          aaaa.bbbb.cccc      2
Session (S,G) : (255.255.255.255,255.255.255.255)
Fwd Intfc  Sub Intfc  Host Intfc  CM Mac          Hosts 
w1/0/0:0                          aabb.bbcc.ccdd      3

The following is a sample output from the show cable multicast db summary command:

Router# show cable multicast db summary
Interface  Session Count  CM Count
Bundle1	          10         5
Bundle2               23        11

The following is a sample output from the show cable multicast db bundle bundle-interface command:

Router# show cable multicast db bundle 1
Interface : Bundle1
Session (S,G) : (*,230.1.2.3)
Fwd Intfc  Sub Intfc            Host Intfc   CM Mac           Hosts
Wi1/1/0:0  Bundle1              Ca5/0/0      ff01.0001.0000       1
Interface : Bundle1
Session (S,G) : (20.1.1.1,232.1.1.1)
Fwd Intfc  Sub Intfc            Host Intfc   CM Mac           Hosts
Wi1/1/0:0  Bundle1              Ca5/0/0      ff01.0001.0000       1

The following is a sample output from the show cable multicast db bundle bundle-interface summary command:

Router# show cable multicast db bundle 1 summary
Interface  Session Count  CM Count
Bundle1	          10	     5

The following is a sample output from the show cable multicast db bundle bundle-interface ipv4-address command:

Router# show cable multicast db bundle 1 225.0.0.1
Session (S,G) : (*,225.0.0.1)
Fwd Intfc  Sub Intfc            Host Intfc   CM Mac           Hosts
Wi5/1:0    Bundle1              Ca5/1        001e.6bfb.29a6       1

The following is a sample output from the show cable multicast db bundle bundle-interface ipv6-address command:

Router# show cable multicast db bundle1 ff15::1
Session (S,G) : (*,FF15::1)
Fwd Intfc  Sub Intfc            Host Intfc   CM Mac           Hosts
In5/1:0    Bundle1              Ca5/1        001e.6bfb.29a6       1

The following is a sample output from the show cable multicast db cm-mac command:

Router# show cable multicast db 000f.66f9.aa73
Session (S,G) : (*,230.1.1.1)        
Fwd Intfc  Sub Intfc  Host Intfc  Hosts  Proxy  Static
w1/0/0:0                              2      Y       N
Session (S,G) : (*,230.1.1.1)        
Fwd Intfc  Sub Intfc  Host Intfc  Hosts  Proxy  Static
w1/0/0:0                              

The following is a sample output from the show cable multicast db cm-mac host-mac-add command:

Router# show cable multicast db aaaa.bbbb.cccc 000f.66f9.aa73
Bundle Interface : Bundle1
CM mac           : 
Host mac         : aaaa.bbbb.cccc
Session (S,G)    : (*,230.1.1.1)
Fwd Interface    : 
Sub Interface    :	
Host Interface   :
IGMP/MLD Ver     :
TimeStamp Delta  :
Bundle Interface : Bundle1
CM mac           : 
Host mac         : aaaa.bbbb.cccc
Session  (S,G)   : (*,230.1.1.1)
Fwd Interface    : 
Sub Interface    :	
Host Interface   :
IGMP/MLD Ver     :
TimeStamp Delta  :

The following is a sample output from the show cable multicast db cm-mac hosts command:

Router# show cable multicast db aaaa.bbbb.cccc hosts
Session (S,G) : (*,230.1.1.1)        
Fwd Intfc  Sub Intfc  Host Intfc  Host Mac        Proxy 
w1/0/0:0                          aaaa.bbbb.cccc      Y
Session (S,G) : (255.255.255.255,255.255.255.255)
Fwd Intfc  Sub Intfc  Host Intfc  Host Mac         Proxy 
w1/0/0:0                          aabb.bbcc.ccdd       N

The following is a sample output from the show cable multicast db cm-mac proxy command:

Router# show cable multicast db aaaa.bbbb.cccc proxy
Bundle Interface : Bundle1
CM mac           :
Host mac         : aaaa.bbbb.cccc
Session  (S,G)   : (*,230.1.1.1)
Fwd Interface    :
Sub Interface    :
Host Interface   :
IGMP/MLD Ver     :
TimeStamp Delta  :
Bundle Interface : Bundle1
CM mac           :
Host mac         : aaaa.bbbb.cccc
Session (S,G)    : (*,230.1.1.1)
Fwd Interface    :
Sub Interface    :
Host Interface   :
IGMP/MLD Ver     :
TimeStamp Delta  :

The following is a sample output from the show cable multicast db command that displays all the available PCMM client entries on a Cisco CMTS router:

Router# show cable multicast db client pcmm
Interface : Bundle1
Session (S,G) : (*,229.2.2.12)
Fwd Intf     Bundle Intf  Host Intf    CM MAC         CPE IP           Gate-ID SFID
Wi1/1/0:0    Bundle1      Ca5/0/0      0018.6852.8056 60.1.1.202       134	4

The following is a sample output from the show cable multicast db command with the detail keyword in Cisco IOS Release 12.2(33)SCF:

Router# show cable multicast db detail
Interface  Fwd Intfc   group            source
Bundle1    Wi7/0/0:0   230.1.2.4        N/A            
ETDB received IGMP   ETDB processed IGMP
Nov 25 08:42:36.643   Nov 25 08:42:36.643
Sid      gc_id    Stat Index   DSID       Stat Index Allocated
DEFAULT  N/A      61330        0xCF25C    Nov 25 08:42:36.643
8201     1        61331        0xCF25C    Nov 25 08:42:36.643
Interface  Fwd Intfc   group            source
Bundle1    Wi7/0/0:0   230.1.2.3        N/A            
ETDB received IGMP   ETDB processed IGMP
Nov 25 08:42:22.339   Nov 25 08:42:22.339
Sid      gc_id    Stat Index   DSID       Stat Index Allocated
DEFAULT  N/A      61328        0xCF25B    Nov 25 08:42:22.339
8201     1        61329        0xCF25B    Nov 25 08:42:22.339

The following is a sample output from the show cable multicast db command with the detail keyword that provides multicast explicit tracking database information for a particular bundle interface in Cisco IOS Release 12.2(33)SCF:

Router# show cable multicast db bundle 1 detail
Interface  Fwd Intfc   group            source
Bundle1    Wi7/0/0:0   230.1.2.4        N/A            
ETDB received IGMP   ETDB processed IGMP
Nov 25 08:42:36.643   Nov 25 08:42:36.643
Sid      gc_id    Stat Index   DSID       Stat Index Allocated
DEFAULT  N/A      61330        0xCF25C    Nov 25 08:42:36.643
8201     1        61331        0xCF25C    Nov 25 08:42:36.643
Interface  Fwd Intfc   group            source
Bundle1    Wi7/0/0:0   230.1.2.3        N/A            
ETDB received IGMP   ETDB processed IGMP
Nov 25 08:42:22.339   Nov 25 08:42:22.339
Sid      gc_id    Stat Index   DSID       Stat Index Allocated
DEFAULT  N/A      61328        0xCF25B    Nov 25 08:42:22.339
8201     1        61329        0xCF25B    Nov 25 08:42:22.339

The following is a sample output from the show cable multicast db command with the detail keyword that provides multicast explicit tracking database information for a particular bundle interface based on its host MAC address in Cisco IOS Release 12.2(33)SCF:

Router# show cable multicast db bundle 1 230.1.2.4 detail
Interface  Fwd Intfc   group            source
Bundle1    Wi7/0/0:0   230.1.2.4        N/A            
ETDB received IGMP   ETDB processed IGMP
Nov 25 08:42:36.643   Nov 25 08:42:36.643
Sid      gc_id    Stat Index   DSID       Stat Index Allocated
DEFAULT  N/A      61330        0xCF25C    Nov 25 08:42:36.643
8201     1        61331        0xCF25C    Nov 25 08:42:36.643

The following is a sample output from the show cable multicast db command with the detail keyword that provides multicast explicit tracking database information based on its cable modem MAC address in Cisco IOS Release 12.2(33)SCF:

Router# show cable multicast db 0019.474a.d516 detail
Interface  Fwd Intfc   group            source
Bundle1    Wi7/0/0:0   230.1.2.3        N/A            
ETDB received IGMP   ETDB processed IGMP
Nov 25 08:42:22.339   Nov 25 08:42:22.339
Sid      gc_id    Stat Index   DSID       Stat Index Allocated
DEFAULT  N/A      61328        0xCF25B    Nov 25 08:42:22.339
8201     1        61329        0xCF25B    Nov 25 08:42:22.339
Interface  Fwd Intfc   group            source
Bundle1    Wi7/0/0:0   230.1.2.4        N/A            
ETDB received IGMP   ETDB processed IGMP
Nov 25 08:42:36.643   Nov 25 08:42:36.643
Sid      gc_id    Stat Index   DSID       Stat Index Allocated
DEFAULT  N/A      61330        0xCF25C    Nov 25 08:42:36.643
8201     1        61331        0xCF25C    Nov 25 08:42:36.643

Table 52 describes the significant fields shown in the show cable multicast db command display.

Table 52 show cable multicast db Field Descriptions 

Field
Description

Bundle Interface

Bundle interface number.

CM Mac

MAC address of the CM.

Host Mac

Host MAC address.

Fwd Intfc

Forwarding interface name.

Sub Intfc

Sub-interface name.

Host Intfc

Host interface name.

IGMP/MLD Ver

IPv4 or IPv6 multicast group signaling protocols.

IPv4: IGMPv1/v2/v3

IPv6: MLDv1/v2

TimeStamp Delta

Timestamp of the session.

Hosts

Hosts behind the CM.

CPE IP

IP address of the CPE.

Gate-ID

Unique number identifying the local PCMM multicast gate.

SFID

Service flow ID (SFID) for the downstream associated with this PCMM multicast gate.


Related Commands

Command
Description

show cable multicast authorization

Displays the list of defined multicast authorization profiles and all cable modems associated with the corresponding profiles.

show cable multicast dsid

Displays the entire multicast downstream service identifier (DSID) database content.

show cable multicast qos

Displays the configuration information of the MQoS (Group-Config, Group-QoS-Config, Group-Encryption-Config).

show packetcable gate multimedia

Displays the information about the total number of PCMM multicast gates.


show cable multicast debug

To display information about debug counters, use the show cable multicast debug command in privileged EXEC mode.

show cable multicast debug [etdb [multicast-group-address | mac-address]]

Syntax Description

etdb

(Optional) Displays information about multicast explicit tracking database debug counters.

multicast-group-address

(Optional) IP address of the multicast group.

mac-address

(Optional) MAC address of the cable modem.


Command Default

None

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCE

This command was introduced.


Usage Guidelines

The show cable multicast debug command provides information only about the explicit tracking database counter in Cisco IOS Release 12.2(33)SCE and later. This means that the command output does not include other debug counters such as multicast authorization and multicast quality of service (QoS).

If you want to verify multicast group specific or MAC specific debug counters, you must turn on debugging of multicast counters using the debug cable multicast counter start command before using the show cable multicast debug command.


Note The command output will be the same if you run the show cable multicast debug command with or without the keyword etdb in Cisco IOS Release 12.2(33)SCE, because this command does not support any other debug counters in Cisco IOS Release 12.2(33)SCE.


Examples

The following is a sample output of the show cable multicast debug command that displays information about multicast explicit tracking database debug counters on the Cisco uBR10012 router:

Router# show cable multicast debug
ETDB
counter                    value
et_ses_update              3
et_ses_delete              0
et_cm_delete               0
et_post_host_add           1
et_post_cm_add             1
et_post_ses_intfc_update   3
et_post_ses_intfc_delete   0
et_post_cm_delete          0
et_post_host_delete        0

The following is a sample output of the show cable multicast debug command that displays information about multicast explicit tracking database debug counters based on a particular multicast group:

Router# show cable multicast debug etdb 230.1.1.1
ETDB  GROUP:230.1.1.1
counter                    value
et_ses_update              3
et_ses_delete              0
et_post_host_add           1
et_post_cm_add             1
et_post_ses_intfc_update   3
et_post_ses_intfc_delete   0
et_post_cm_delete          0
et_post_host_delete        0

The following is a sample output of the show cable multicast debug command that displays information about multicast explicit tracking database debug counters based on a particular cable modem:

Router# show cable multicast debug etdb 001a.c3ff.d41a
ETDB  CM:001a.c3ff.d41a
counter                    value
et_ses_update              2
et_ses_delete              0
et_cm_delete               0
et_post_host_add           0
et_post_cm_add             0
et_post_ses_intfc_update   2
et_post_cm_delete          0
et_post_host_delete        0

Table 5 describes the major fields shown in the show depi command display:

Table 53 show cable multicast debug Field Descriptions 

Field
Description

ETDB

Multicast explicit tracking database

counter

Debug counters for the multicast operation.

value

Debug counter values.

ETDB GROUP

Identifies a particular multicast group for explicit tracking database debug counters.

ETDB CM

Identifies a particular cable modem for explicit tracking database debug counters.


Related Commands

Command
Description

debug cable multicast counter clear

Resets debugging of multicast counters.

debug cable multicast counter start

The Cisco CMTS router starts collecting multicast debug counters based on a particular multicast group or a cable modem.

debug cable multicast counter stop

The Cisco CMTS router stops collecting multicast debug counters.


show cable multicast dsid

To display the entire multicast downstream service identifier (DSID) database content, use the show cable multicast dsid command in privileged EXEC mode.

Cisco uBR7246VXR and Cisco uBR7225VXR Routers

show cable multicast dsid [dsid | ip-address [source-ip] | integrated-cable slot/port:integrated-channel {dynamic | static}| wideband-cable slot/port:wideband-channel {dynamic} | ipv6-address]

Cisco uBR10012 Router

show cable multicast dsid [dsid | ip-address [source-ip] | integrated-cable slot/sub-slot/port:integrated-channel {dynamic | static}| wideband-cable slot/bay/port:wideband-channel {dynamic | static} | ipv6-address]

Syntax Description

dsid

(Optional) Downstream service identifier.

ip-address

(Optional) IP address of the group.

source-ip

(Optional) IP address of the source.

integrated-cable slot/sub-slot/port:integrated-channel

(Optional) Identifies the cable interface on the router for which information should be displayed. The valid values are:

slot—0 to 8 on the Cisco uBR10012 router, 3 to 6 on the Cisco uBR7246VXR router, and 1 or 2 on the Cisco uBR7225VXR router.

sub-slot—0 or 1

port—0 to 4 on the Cisco uBR10012 router and 0 or 1 on the Cisco uBR7246VXR and Cisco uBR7225VXR routers.

integrated-channel—0 to 3

wideband-cable slot/bay/port:wideband-channel

(Optional) Identifies the wideband interface on the router for which information should be displayed. The valid values are:

slot—0 to 8 on the Cisco uBR10012 router, 3 to 6 on the Cisco uBR7246VXR router, and 1 or 2 on the Cisco uBR7225VXR router.

bay—0 or 1

port—0 to 4 on the Cisco uBR10012 router and 0 or 1 on the Cisco uBR7246VXR and Cisco uBR7225VXR routers.

wideband-channel—0 to 5

dynamic

Identifies the dynamic DSIDs.

static

Identifies the static DSIDs.

ipv6-address

IPv6 address of the group that should be matched using the format X:X:X:X::X.


Command Default

None

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCB

This command was introduced.

12.2(33)SCC

This command was modified to display all the SIP and SPA indexes assigned for a multicast session.

12.2(33)SCD

This command was modified. Support for Cisco uBR7246VXR and Cisco uBR7225VXR routers were added. Two new keywords, dynamic and static, were added to this command.


Usage Guidelines

Use this command to display the DSID database content and SIP and SPA indexes assigned for a multicast session.

Examples

The following example shows a sample output for the show cable multicast dsid command:

Router# show cable multicast dsid
Multicast Group    : 230.1.2.3
         Source    : *
         IDB       : Bu2         Interface: Mo1/1/0:0   Dsid: 0x1F078     
         StatIndex : 2           SAID: DEFAULT
Multicast Group    : 230.1.2.3
         Source    : *
         IDB       : Bu2         Interface: Mo1/1/0:0   Dsid: 0x1F078     
         StatIndex : 3           SAID: 8196      
Multicast Group    : 230.1.2.3
         Source    : *
         IDB       : Bu2         Interface: Mo1/1/0:0   Dsid: 0x1F078     
         StatIndex : 4           SAID: 8197 

Example of the show cable multicast dsid ip-address Command Output That Shows the DSID Entry With Matching Multicast Session for the Cisco uBR7246VXR and Cisco uBR7225VXR routers in Cisco IOS Release 12.2(33)SCD

The following example shows a sample output for the show cable multicast dsid ip-address [source-ip] command:

Router# show cable multicast dsid 225.0.0.1 
Multicast Group    : 225.0.0.1
         Source    : *
         IDB       : Bu1               Interface: Wi5/0:0     Dsid: 0x5F078     
         StatIndex : 7                 SAID     : DEFAULT
Multicast Group    : 225.0.0.1
         Source    : *
         IDB       : Bu1               Interface: Wi5/0:0     Dsid: 0x5F078     
         StatIndex : 8                 SAID     : 8195        GC  : 1

Example of the show cable multicast dsid wideband-Cable Command Output That Displays the Dynamic or Preallocated Static DSID Created on a Particular Interface for the Cisco uBR7246VXR and Cisco uBR7225VXR routers in Cisco IOS Release 12.2(33)SCD

The following example shows a sample output for the show cable multicast dsid wideband-Cable [dynamic | static] command:

Router# show cable multicast dsid wideband-Cable 5/0:0 dynamic
Multicast Group    : 225.0.0.1
         Source    : *
         IDB       : Bu1               Interface: Wi5/0:0     Dsid: 0x5F078     
         StatIndex : 7                 SAID     : DEFAULT
Multicast Group    : 225.0.0.1
         Source    : *
         IDB       : Bu1               Interface: Wi5/0:0     Dsid: 0x5F078     
         StatIndex : 8                 SAID     : 8195        GC  : 1
Multicast Group    : 225.0.0.2
         Source    : *
         IDB       : Bu1               Interface: Wi5/0:0     Dsid: 0x5F079     
         StatIndex : 9                 SAID     : DEFAULT
Multicast Group    : 225.0.0.2
         Source    : *
         IDB       : Bu1               Interface: Wi5/0:0     Dsid: 0x5F079     
         StatIndex : 10                SAID     : 8196        GC  : 1

Example of the show cable multicast dsid integrated-Cable Command Output That Displays the Dynamic DSID Created on a Particular Interface for the Cisco uBR7246VXR and Cisco uBR7225VXR routers in Cisco IOS Release 12.2(33)SCD

The following example shows a sample output for the show cable multicast dsid integrated-Cable static command:

Router# show cable multicast dsid integrated-Cable 5/0:0 static
Dsid   Stat Index   Type
0x5F000  65384      IGMPv1/v2      
0x5F001  65385      IGMPv3         
0x5F002  65386      MLDv1          
0x5F003  65387      MLDv2          
0x5F004  65388      PreReg 

Table 54 describes the significant fields shown in the show cable multicast dsid command display.

Table 54 show cable multicast dsid Field Descriptions 

Field
Description

Multicast Group

Multicast group.

Source

Source IP address.

IDB

Interface description block number.

Interface

Interface name.

Dsid

Downstream service identifier.

StatIndex

Blaze indexes assigned for a multicast session.

SAID

Security Association Identifier.


Related Commands

Command
Description

show cable multicast authorization

Displays the list of defined multicast authorization profiles and all CMs associated with corresponding profiles.

show cable multicast db

Displays the multicast explicit tracking database content.

show cable multicast qos

Displays the configuration information for MQoS (Group-Config, Group-QoS-Config, Group-Encryption-Config).


show cable multicast qos

To display the configuration information for multicast quality of service (MQoS), use the show cable multicast qos command in privileged EXEC mode.

show cable multicast qos {group-config [group-config-index] | group-encryption [group-encryption-index] | group-qos [group-qos-index]}

Syntax Description

group-config

Displays multicast group configuration information.

group-config-index

(Optional) Index for the multicast group. The valid range is from 1 to 2048.

group-encryption

Displays multicast group encryption information.

group-encryption-index

(Optional) Index for the multicast group encryption.

group-qos

Displays multicast group QoS information.

group-qos-index

(Optional) Index for the multicast group QoS.


Command Default

None

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCB

This command was introduced.

12.2(33)SCC

The command output was modified to display the application ID for default multicast group QoS configuration.

12.2(33)SCE

The command output was modified to list the PCMM application for multimedia multicast configuration.


Examples

Example of the show cable multicast qos Command Output for Multicast Group Configuration

The following example shows a sample output of the show cable multicast qos command that displays multicast group configuration information:

Router# show cable multicast qos group-config
Default Multicast Group-Qos Application ID 65535
Multiast Group Config 1 : Priority 1
Group QOS - 1
Group Encryption - 1
Application ID 65534
Session Range - Group Prefix 230.0.0.0 Mask 255.0.0.0 Source Prefix 0.0.0.0 Mask 0.0.0.0

Example of the show cable multicast qos Command Output for Multicast Group Encryption

The following example shows a sample output of the show cable multicast qos command that displays multicast group encryption information:

Router# show cable multicast qos group-encryption
Multicast Group Encryption 1 : Algorithm 56bit-des
Multicast Group Encryption 2 : Algorithm 128bit-aes

Example of the show cable multicast qos Command Output for Multicast Group QoS

The following example shows a sample output of the show cable multicast qos command that displays multicast group QoS information in Cisco IOS Release 12.2(33)SCC:

Router# show cable multicast qos group-qos
Group QOS Index 	Service Class 	Control 					 		Igmp Limit 								Override
DEFAULT 				 MQOS_DEFAULT 				Aggregate NO-LIMIT 1 MQOS Aggregate NO-LIMIT

The following example shows a sample output of the show cable multicast qos command that displays multicast group QoS information including the application (the App field) for multimedia multicast configuration in Cisco IOS Release 12.2(33)SCE:

Router# show cable multicast qos group-qos
Group QOS Index    Service Class    Control    Igmp Limit    Override  App
 DEFAULT           mcast_default     Aggregate  NO-LIMIT
 1                 SDV_SD            Single      ---          No        CLI
 512               SDV_HD            Single      ---          No        PCMM

Table 38 describes the significant fields shown in the display.

Table 55 show cable multicast qos Field Descriptions 

Field
Description

Group

Identifies the multicast group.

QOS

Identifies the QoS profile that is being enforced.

Index

Index number of the QoS group.

Service Class

Identifies the service class being used for the multicast.

Control

Identifies the type of control.

Igmp Limit

Displays the Internet Group Management Protocol (IGMP) session limit for aggregate service flows.

Override

Displays the additional IGMP session admitted and forwarded as best effort traffic.

App

Displays the application used for multimedia multicast.


Related Commands

Command
Description

show cable multicast authorization

Displays the list of defined multicast authorization profiles and all CMs associated with corresponding profiles.

show cable multicast db

Displays the contents of multicast explicit tracking database.

show cable multicast dsid

Displays the entire Downstream Service Identifier (DSID) database content.


show cable multicast statistics failure

To display the multicast statistics failure details, use the show cable multicast statistics command in global configuration mode.

show cable multicast statistics failure

Command Default

Information for all multicast statistics failure is displayed.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCF

This command was introduced.


Usage Guidelines

The show cable multicast statistics failure command displays information about admission control failure and PXF queue failure.

Examples

The following is a sample output from the show cable multicast statistics failure command:

Router# show cable multicast statistics failure
counter                    value
Admission Control Failure  0
PXF Queue Failure          0

Related Commands

Command
Description

show cable multicast db

Displays the contents of the multicast explicit tracking database.

clear cable multicast statistics counter

Clears all multicast statistics counters.


show cable noise

To display cable noise statistics on a Cisco CMTS, use the show cable noise command in EXEC mode.

show cable {slot/port | slot/subslot/port} noise

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)


Command Modes

EXEC

Command History

Release
Modification

12.0(4)XI

This command was introduced.

12.1(3a)EC1

This command was removed from the 12.1 EC release.


Usage Guidelines

This command is not supported on Cisco IOS Release 12.1(3a)EC1 or later releases.

Examples

The following example shows how to display CM noise statistics:

Router# show cable 6/0 noise 

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

show cable modem

Displays CM configuration settings.


show cable privacy

To display Baseline Privacy Interface Plus (BPI+) certificate information and the security or privacy information for the Cisco CMTS router, use the show cable privacy command in privileged EXEC mode.

show cable privacy {eae-exclude | hotlist {cm} | manufacturer-cert-list | root-cert-list}

Syntax Description

eae-exclude

Displays the early authentication and encryption (EAE) details.

hotlist {cm}

Displays a list of cable modems detected as clones.

manufacturer-cert-list

Displays the BPI manufacturer certificate verification list.

root-cert-list

Displays the BPI root certificate verification list.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

11.3 NA

This command was introduced in a different form and its functions moved to the show interface cable privacy command.

12.2(4)BC1

This command was introduced in its current form.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA.

12.2(33)SCC

This command was modified. The eae-exclude keyword was added.

12.2(33)SCE

This command was modified. The hotlist keyword was added.


Usage Guidelines

The show cable privacy command is available only in IOS images that support BPI and BPI+ encryption.

Examples

The following is a sample output of the show cable privacy command with the eae-exclude keyword that lists the cable modems excluded from the early authentication and encryption process:

Router# show cable privacy eae-exclude 
EAE Exclusion List:
  MAC: 1111.1111.1111 Mask: ffff.ffff.ffff
  MAC: 2222.2222.2222 Mask: ffff.ffff.ffff

The following is a sample output of the show cable privacy command with the hotlist keyword that lists the permanent and temporary hotlist entries:

Router# show cable privacy hotlist cm
MAC Address            Last Ranged           Type             Interface
0025.2eaf.6f16         Dec 13 21:03:56       Permanent        C8/1/0
0025.2eaf.6f26         Dec 13 21:03:56       Temporary        C5/1/0

Table 56 describes the significant fields shown in the show cable privacy command display:

Table 56 show cable privacy Command Field Description 

Field
Description

MAC Address

MAC address of the cable modem that is on the hotlist.

Last Ranged On

Displays the time stamp when the cable modem last attempted registration on that interface. This value helps gauge the frequency with which the MAC address is attempting to be cloned, and manage the hotlist accordingly.

Type

Permanent—The cable modem entry can be configured as a permanent clone from the CLI by executing the cable privacy hotlist cable modem command. A cable modem marked as a permanent clone can only be removed from the hotlist by executing the no form of the cable privacy hotlist cable modem command.

Temporary—The Cisco CMTS detects a duplicate cable modem MAC address. This duplicate MAC address is flagged as a clone and is prevented from coming online for 180 seconds.


Related Commands

Command
Description

cable privacy add-certificate

Configures certificates for BPI+ encryption.

cable privacy

Enables and configures BPI+ encryption on a cable interface.

show cable modem

Displays cable modem configuration settings.

show interface cable privacy

Displays baseline privacy information.


show cable qos enforce-rule

To display the quality of service (QoS) enforce-rules that are currently defined, use the show cable qos enforce-rule command in privileged EXEC mode.

show cable qos enforce-rule [name] [verbose]

Syntax Description

name

(Optional) Specifies the name of a particular enforce-rule to be displayed.

verbose

(Optional) Displays detailed information about the QoS enforce-rule options that are currently defined.


Command Default

All enforce-rules are displayed.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(15)BC1

This command was introduced.

12.3(9a)BC

This command was integrated into Cisco IOS Release 12.3(9a)BC.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.

12.3(23)BC2

The following new output fields were added for the verbose form of the command: Penalty End-time, Weekend First Peak Time, Weekend First Duration, Weekend First Average-rate, Weekend Second Peak Time, Weekend Second Duration, Weekend Second Average rate, Weekend Offpeak Duration, Weekend Offpeak Average-rate, and Weekend Auto-enforce.

12.3(23)SCD1

The following new output fields were added for the verbose form of the command: Monitoring after RelTime, Penalty-Period for week-days, Penalty-Period for week-ends.

The following output fields were modified for the verbose form of the command: Penalty End-time, First Peak Time, Second Peak Time, Weekend First Peak Time, Weekend Second Peak Time.

The output field Penalty End-time was renamed as Default Penalty Duration.


Examples

The following example shows typical output for the default version of the show cable qos enforce-rule command:

Router# show cable qos enforce-rule 
            Name              Dur  Dir byte-cnt Auto rate  penalty Reg Enf Ena Persist 
                             (min)     (kbytes) enf  (min) (min)   QoS QoS
 residential                  10   us  5        act  1     10080   5   10  Yes Yes 
 ef-q11d                      30   ds  150      act  1     20      11  99  Yes Yes 
 ef-q11u                      30   us  60       act  1     20      11  99  Yes Yes 
 ef-q21                       720  us  60       act  1     10      21  81  Yes Yes 
 ef-q21d                      300  ds  150      act  1     10      21  81  Yes Yes 
 ef-q22                       720  us  60       act  1     10      22  82  Yes Yes 
 ef-q22d                      300  ds  150      act  1     10      22  82  Yes No 
 ef-q23                       720  us  60       act  1     10      23  83  Yes Yes 
 ef-q23d                      300  ds  150      act  1     10      23  83  Yes Yes 
 ef-q24                       720  us  60       act  1     10      24  84  Yes Yes 
 ef-q24d                      300  ds  150      act  1     10      24  84  Yes Yes 
 ef-q25                       720  us  60       act  1     10      25  85  Yes Yes 
 ef-q25d                      300  ds  150      act  1     10      25  85  Yes Yes 
 ef-q26                       720  us  60       act  1     10      26  86  Yes Yes 
 ef-q26d                      300  ds  150      act  1     10      26  86  Yes Yes 
 ef-q27                       720  us  60       act  1     10      27  87  Yes Yes 
 ef-q27d                      300  ds  150      act  1     10      27  87  Yes Yes 
 ef-q28                       720  us  60       act  1     10      28  88  Yes Yes
 ef-q28d                      300  ds  150      act  1     10      28  88  Yes No 
 ef-q5d                       300  ds  150      act  1     10      5   99  Yes Yes 
 ef-q5u                       720  us  600      act  1     10      5   99  Yes Yes 

The following example shows sample output from the show cable qos enforce-rule command for a particular enforce-rule named "residential":

Router# show cable qos enforce-rule residential 
            Name              Dur  Dir byte-cnt Auto rate  penalty Reg Enf Ena Persist
                             (min)     (kbytes) enf  (min) (min)   QoS QoS
 residential                  10   us  5        act  1     10080   5   10  Yes Yes 

Table 57 describes the significant fields displayed by the show cable qos enforce-rule command.

.

Table 57 show cable qos enforce-rule Field Descriptions 

Field
Description

Name

Name of the enforce-rule.

Dur (min)

The monitoring duration period, in minutes.

Dir

Direction in which the byte-count is applied:

DS—Downstream direction

US—Upstream direction

byte-cnt (kbytes)

Maximum number of bytes, in kilobytes, that subscribers using this enforce-rule can transmit during the monitoring-duration window before being considered to be overconsuming.

Auto enf

Displays whether the enforce-rule QoS profile is automatically activated when a subscriber exceeds their allowed bandwidth.

rate (min)

Size of the sample-rate interval, in minutes.

penalty (min)

Size of the penalty period, in minutes.

Reg QoS

Profile ID for the registered QoS profile or the name of the service class.

Enf QoS

Profile ID for the enforced QoS profile or the name of the service class.

Ena

Displays whether this enforce-rule is currently enabled and active.

Persist

Displays whether this enforce-rule keeps the enforced QoS profile in force across cable modem reboots:

Yes—Enforced QoS profiles remain in effect across cable modem reboots.

No—Enforced QoS profiles do not remain in effect when a cable modem reboots. See the no-persistence option for the qos-profile enforced command.


The following example shows the sample output from the show cable qos enforce-rule verbose form of the command with the new output fields beginning in Cisco IOS Release 12.3(23)BC2:

Name                          : test
Version                       : docsis10
Monitoring Type               : peak-offpeak
Registered                    : 255
Enforced                      : 4
Monitoring Duration           : 120 (in minutes)
Sample-rate                   : 10 (in minutes)
Average-rate                  : 1 kbits/sec
Direction                     : upstream
Penalty Time                  : 10080 (in minutes)
Penalty End-time              : 23 (time of day in hrs)
Rule Enabled                  : Yes
Persistence                   : Yes
Week-end                      : Yes
First Peak Time               : 6
Duration                      : 180 (in minutes)
First Average-rate            : 2 kbits/sec
Second Peak Time              : 18
Duration                      : 240 (in minutes)
Second Averate-rate           : 3 kbits/sec
Offpeak Duration              : 120 (in minutes)
Offpeak Average-rate          : 1 kbits/sec
Auto-enforce                  : active
Weekend First Peak Time       : 8
Weekend First Duration        : 120 (in minutes)
Weekend First Average-rate    : 2 kbits/sec
Weekend Second Peak Time      : 18
Weekend Second Duration       : 180 (in minutes)
Weekend Second Average-rate   : 5 kbits/sec
Weekend Offpeak Duration      : 240 (in minutes)
Weekend Offpeak Average-rate  : 4 kbits/sec
Weekend Auto-enforce          : active

The following example shows the sample output from the show cable qos enforce-rule verbose form of the command with the new output fields in Cisco IOS Release 12.3(33)SCD2:

Router# show cable qos enforce-rule test verbose
Name                         : test
Version                      : docsis11
Monitoring Type              : peak-offpeak
Registered                   : REG-DS
Enforced                     : ENF-DS
Monitoring Duration          : 70 (in minutes)
Sample-rate                  : 10 (in minutes)
Average-rate                 : 3 kbits/sec
Direction                    : downstream
Auto Enforce                 : Yes
Current Penalty Duration     : 10 (in minutes)
Default Penalty Duration     : 10 (in minutes)
Penalty End-time             : 23:0 (time of day)
Rule Enabled                 : Yes
Persistence                  : Yes
Weekend                      : No
Penalty Off                  : No
Monitor Weekend              : Yes
Monitoring after RelTime     : Off
First Peak Time              : 10:0
Duration                     : 60 (in minutes)
First Average-rate           : 1 kbits/sec
Second Peak Time             : 19:0
Duration                     : 65 (in minutes)
Second Average-rate          : 2 kbits/sec
Offpeak Duration             : 70 (in minutes)
Offpeak Average-rate         : 3 kbits/sec
Auto Enforce                 : Yes
Sample Rate                  : 10
Penalty-Period for week-days : 0
Weekend First Peak Time      : 11:0
Weekend Duration             : 75 (in minutes)
Weekend First Average-rate   : 4 kbits/sec
Weekend Second Peak Time     : 20:0
Weekend Duration             : 80 (in minutes)
Weekend Second Average-rate  : 5 kbits/sec
Weekend Offpeak Duration     : 85 (in minutes)
Weekend Offpeak Average-rate : 6 kbits/sec
Weekend Auto Enforce         : Yes
Weekend Sample Rate          : 12
Penalty-Period for week-ends : 0

Related Commands

Command
Description

cable qos enforce-rule

Creates an enforce-rule to enforce a particular QoS profile for subscriber traffic management and enters enforce-rule configuration mode.

duration

Specifies the time period and sample rate to be used for monitoring subscribers.

enabled (enforce-rule)

Activates an enforce-rule and begins subscriber traffic management on a Cisco CMTS router.

penalty-period

Specifies the time period that an enforced QoS profile should be in effect for subscribers that violate their registered QoS profiles.

qos-profile enforced

Specifies a QoS profile that should be enforced when users violate their registered QoS profiles. This command is applicable for only DOCSIS 1.0 cable modems.

qos-profile registered

Specifies the registered QoS profile that should be used for this enforce-rule. This command is applicable for only DOCSIS 1.0 cable modems.

service-class (enforce-rule)

Specifies a service class (enforced or registered) that should be used for the cable modem monitoring in an enforce-rule. This command is applicable for DOCSIS 1.1 or later cable modems.

show cable subscriber-usage

Displays subscribers who are violating their registered QoS profiles.


show cable qos permission

To display the status of permissions for changing quality-of-service (QoS) tables on a Cisco CMTS, use the show cable qos permission command in privileged EXEC mode.

show cable qos permission

Syntax Description

This command has no keywords or arguments.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1 T

This command was introduced.

12.1(4)CX

This command was deprecated for DOCSIS 1.1 use, because DOCSIS 1.1 replaces the QoS profile model with a service flow model. The show interface cable qos paramset command is used for DOCSIS 1.1 operation.


Examples

The following example displays the output of the show cable qos permission command:

CMTS01# show cable qos permission 
Create by SNMP  Update by SNMP  Create by modems
yes             yes             yes

Table 0-58 describes the fields displayed by the show cable qos permission command.

Table 0-58 show cable qos permission Command Field Descriptions 

Field
Description

Create by SNMP

Indicates permission setting for creation of QoS table entries by the Simple Network Management Protocol (SNMP).

Update by SNMP

Indicates permission setting for creation of QoS table entries by modem registration requests.

Create by modems

Indicates permission setting for dynamic updating of QoS table entries by the SNMP.



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 qos permission

Specifies permission for updating the cable router QoS table.

cable qos profile

Configures a QoS profiles.

cable service-flow inactivity-timeout

Sets the amount of time a dynamic service-flow can be present in the system without any activity.

show controllers cable

Displays cable router QoS profiles.

show interface cable qos paramset

Displays the DOCSIS 1.1 QoS parameter sets.


show cable qos profile

To display quality-of-service (QoS) profiles for a Cisco CMTS, use the show cable qos profile command in privileged EXEC mode.

show cable qos profile profile-index [verbose]

Syntax Description

profile-index

Displays cable QoS table. Valid range is 1 to 255.

verbose

Displays detailed information about the QoS profiles.


Command Modes

Privileged EXEC

Command History

Release
Modification

11.3NA

This command was introduced.

12.0(3)T

The command was included in the mainline release.

12.0(7)XR

The verbose option was added.

12.1(1)T

The IP precedence rate enabling bits were added to the display.

12.1(4)CX

This command was deprecated for DOCSIS 1.1 use, because DOCSIS 1.1 replaces the QoS profile model with a service flow model. The show interface cable qos paramset command is used for DOCSIS 1.1 operation.


Examples

The following example shows how to display the existing QoS profiles on the CMTS:

Router# show cable qos profile 
ID  Prio Max       Guarantee Max        Max   TOS  TOS   Create  B     IP prec.
         upstream  upstream  downstream tx    mask value by      priv  rate
         bandwidth bandwidth bandwidth  burst                    enab  enab
1   0    0         0         0          0     0x0  0x0   cmts(r) no    no 
2   0    64000     0         1000000    0     0x0  0x0   cmts(r) no    no 
3   7    31200     31200     0          0     0x0  0x0   cmts    yes   no 
4   7    87200     87200     0          0     0x0  0x0   cmts    yes   no 
5   2    256000    0         128000     1503  0x0  0x0   cm      no    no 

Profiles 1 and 2 are always created by the CMTS at initial startup. The CMTS dynamically creates profiles 3 and 4, as shown above, to support Voice over IP (VoIP) codecs G.711 and G.729 when a CM configures phone lines and uses dynamic service requests to request VoIP service. The remaining profiles, such as profile 5 above, are typically created by a CM when it comes online.

Profile 3 creates a grant-size of 31.22 KiloBytes per second for G.729 service, and profile 4 creates a grant-size of 87.2 KiloBytes per second for G.711 service. Both profiles use a default grant-interval of 20 milliseconds. For more information on these profiles, see the TAC technical note at the following URL:
http://www.cisco.com/warp/public/109/uBR7200_QoSMAC.html

The following example displays detailed output for profile 1:

Router# show cable qos profile 1 verbose 
Profile Index                           1
Name                                    Default
Upstream Traffic Priority               0
Upstream Maximum Rate (bps)             0
Upstream Guaranteed Rate (bps)          0
Unsolicited Grant Size (bytes)          0
Unsolicited Grant Interval (usecs)      0
Upstream Maximum Transmit Burst (bytes) 0
IP Type of Service Overwrite Mask       0x0
IP Type of Service Overwrite Value      0x0
Downstream Maximum Rate (bps)           0
Created By                              cmts(r)
Baseline Privacy Enabled                no 

Table 0-59 describes the fields displayed by the show cable qos profile command.

Table 0-59 show cable qos profile Command Field Descriptions 

Field
Description

ID

Profile number.

Prio

Priority level.

Max upstream bandwidth

Maximum upstream bandwidth.

Guarantee upstream bandwidth

Guaranteed minimum upstream bandwidth.

Max downstream bandwidth

Maximum downstream bandwidth.

Max tx burst

Maximum transmit burst size in bytes.

Tos mask

Hex value of the mask bits.

Tos value

Value of the mask byte.

Create by

Identity of who created the profile:

cmts = Created by the CMTS with read-write properties. The profile can be modified but not deleted.

cmts(r) = Created by the CMTS with read-only properties. The profile cannot be modified or deleted.

cm = Created by the CM DOCSIS configuration file.

mgmt = Created by an operator using CLI commands.

B priv enab

Describes whether Baseline Privacy Interface (BPI) encryption is enabled (yes) or disabled (no) for this QoS profile.

IP prec. rate enab

Describes whether IP precedence rate limiting enabling is enabled (yes) or disabled (no) for this QoS profile. When a profile is created by a CM, this value is set by the Type Length Value (TLV) 11 fields in the DOCSIS configuration file, unless overwritten using the cable qos profile command.



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 qos permission

Specifies permission for updating the cable router QoS table.

cable qos profile

Configures a QoS profiles.

cable service-flow inactivity-timeout

Sets the amount of time a dynamic service-flow can be present in the system without any activity.

show cable modem qos

Displays quality of service (QoS) and service flow information for a particular CM.

show cable noise

Displays the status of permissions for changing QoS tables.

show interface cable qos paramset

Displays the DOCSIS 1.1 QoS parameter sets.


show cable rate-adapt

To display the global and local upstream utilization optimization configuration parameters, use the show cable rate-adapt command in privileged EXEC mode.

show cable rate-adapt

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.3(23)BC2

This command was introduced.

12.2(33)SCB

This command was integrated into Cisco IOS Release 12.2(33)SCB. Support for the Cisco uBR7225VXR router was added.


Usage Guidelines

This command displays the current global rate-adapt settings that govern all cable modem and the local rate-adapt settings that relate to a specific cable modem upstream.

Examples

The following example shows a typical display of the show cable rate-adapt command:

Router# show cable rate-adapt
Global:Enabled Local-Only:Enabled global:maps 500 priority 6, rate 12 bcs 10 fcms On

Note The output "maps 500" relates to duration. It indicates that the service flow is optimized for 500 MAPs.


Table 60 describes the fields shown in the show cable rate-adapt display.

Table 60 show cable rate-adapt Field Descriptions

Field
Description

Global

Indicates if upstream utilization optimization is enabled globally on all cable modems.

Local

Indicates if upstream utilization optimization is enabled locally on a specific upstream flow.

priority

Indicates the specified priority setting.

rate

Indicates the specified minimum max-rate.

bcs

Indicates the number of broadcast contention minislots (BCS).

fcms

Indicates if forced broadcast contention minislot (fcms) is turned on or off.

duration

Indicates the duration of a rate-adapt flow.


Related Commands

Command
Description

cable upstream rate-adapt (global)

Enables upstream utilization optimization globally on all cable modem upstream flows.

cable upstream rate-adapt (interface)

Enables upstream utilization optimization locally.


show cable rate-limit-ccf

To display information about rate limiting criteria for upstream bonded service flows on the Cisco uBR10-MC5X20H cable interface line card, use the show cable rate-limit-ccf command in privileged EXEC mode.

show cable rate-limit-ccf [start-index count | clear]

Syntax Description

start-index

(Optional) Starting index for the log entries. The valid range is from 0 to 2000. The default value is 0.

count

(Optional) Total number of log entries to be displayed. The valid range is from 0 to 2000.

clear

(Optional) Clears information about rate limiting.


Command Default

None

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCC

This command was introduced in Cisco IOS Release 12.2(33)SCC.


Examples

The following is a sample output of the show cable rate-limit-ccf command that displays information about rate limiting criteria for upstream bonded service flows on a Cisco uBR10-MC5X20H cable interface line card:

Router# show cable rate-limit-ccf
rate_limiting config: aggr_throughput: 215000000 aggr_burst: 240000
cpu_threshold: 50 cpu_burst: 10
5X20H rate limit: cpu-throttle 0 ccf-bw-drop 0 others 0
5X20H rate limit ccf info count: 0

Table 61 describes the fields shown in the show cable rate-limit-ccf command display.

Table 61 show cable rate-limit-ccf Field Descriptions

Field
Description

aggr_throughput

Aggregate throughput value.

aggr_burst

Aggregate burst rate value.

cpu_threshold

CPU threshold for Continuous Concatenation and Fragmentation (CCF) in percentage.

cpu_burst

CPU burst for CCF in percentage

cpu-throttle

Total number of bandwidth requests that stopped due to CPU throttle.

ccf-bw-drop

Total number of bandwidth requests that stopped due to CCF resource constraint.

5X20H rate limit ccf info count

Total number of log entries.


Related Commands

Command
Description

cable upstream rate-limit-ccf

Configures rate limiting criteria for upstream bonded service flows on a Cisco uBR10-MC5X20H cable interface line card.


show cable redundancy

To display the DDC redundancy partners and their relative states, and additional information about DDC states on the Cisco CMTS, use the show cable redundancy command in privileged EXEC mode.

show cable redundancy {hashfilter | class | calls}

Syntax Description

hashfilter

Displays the hash filter(s) being used in the scheme.

class

Displays the displays the number of cable modems in each DDC class of the same scheme.

calls

Displays the number of active and E911 calls currently being supported on the relative DDC nodes.


Command Default

This command has no default behaviors or values.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

Release 12.3(9a)BC

This command was introduced on the Cisco uBR7246 universal broadband router.


Examples

The following example of the show cable redundancy hashfilter command illustrates the same DDC Redundancy scheme (two Cisco uBR7246VXR routers). This command displays the configured hash filter parameters. You can either list all hash filters (as shown) or list one hash filter, if specified with the optional hash_id value at the end of the command.

Router# show cable redundancy hashfilter 
HashFilter 1
HashType        MacMask
default         ffff.ffff.ffff
MacAddr         OUI             Node
0000.39cc.b270                  1 
0000.39cc.ba70                  2 
0000.39cc.c070                  2 
HashFilter 2
HashType        MacMask
default         0000.00ff.ffff
MacAddr 	OUI 	Node
	00.00.39	1 
	00.08.0D	1 
	00.0C.E5	1 

The following example of the show cable redundancy class command displays the number of cable modems in each DDC class of the same scheme (two Cisco uBR7246VXR routers).

Router# show cable redundancy class
Number of modems in each DDC class:
Interface	Class0	Class1	Class2	Class3	Class4
Cable3/0 	32 	0	0	0	0
Cable3/1 	32	0	0	0	0
Cable4/0	32	0	0	0	0
Cable4/1	0	0	0	0	0
Cable5/0	31	0	0	0	0
Cable5/1	32	0	0	0	0
Cable6/0	0	0	0	0	0
Cable6/1	0	0	0	0	0

The following example of the show cable redundancy calls command displays the number of active 911 (E911) calls, voice calls, and the number of cable modems with service flows for each subinterface. If the subinterface is configured on a bundle, the number of calls is the total for all the members in the bundle.

Router# show cable redundancy calls
SubInterface  911Calls   VoiceCalls  ModemCount  ServiceFlow
Cable3/0.1    0          0           159         159
Cable3/0.2    0          0           0           0

Related Commands

Command
Description

cable redundancy hashfilter

Sets the MAC address and DDC node mappings of the DDC redundancy scheme.

cable redundancy myid

Sets the total number of Cisco DDC nodes (routers) in the DDC Redundancy scheme and sets the ID of the current DDC node.

cable redundancy node

Configures the DDC node with active or standby state.

cable redundancy node frequency

Sets the downstream frequencies for each node participating in the scheme other than the current DDC node (router).

cable redundancy target

Sets the target DDC node (router) to use in a DDC switchover event.

cable redundancy threshold

Sets the active voice call threshold on the current DDC node (router).


show cable rf-adapt

To display the downgrade and upgrade candidate modems, use the show cable rf-adapt command in user EXEC or privileged EXEC mode.

show cable rf-adapt [cable {slot/cable-interface-index | slot/subslot/cable-interface-index} [upgrade-candidates | downgrade-candidates | upstream upstream-channel-id [upgrade-candidates | downgrade-candidates]] | upgrade-candidates | downgrade-candidates]

Syntax Description

cable

Displays information about the cable modems in a specific cable interface.

slot

Slot where the line card resides.

Cisco uBR7225VXR router—The valid value is 1 or 2.

Cisco uBR7246VXR router—The valid range is from 3 to 6.

Cisco uBR10012 router—The valid range is from 5 to 8.

subslot

(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.

cable-interface-index

Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco uBR-MC20X20V and Cisco uBR-MC3GX60V line cards.

Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.

Cisco uBR10012 router—The valid range for the Cisco uBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.

upgrade-candidates

Displays information about the upgrade candidate cable modems.

downgrade-candidates

Displays information about the downgrade candidate cable modems.

upstream upstream-channel-id

(Optional) Displays candidates on a particular upstream channel. The valid range for upstream-channel-id is from 0 to 3.


Command Modes

User EXEC (>) or

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCF

This command was introduced.


Examples

The following is a sample output of the show cable rf-adapt downgrade-candidates command:

Router# show cable rf-adapt downgrade-candidates

MAC Address      IP Address      Source       Destination
                                 Upstream     Upstream
0019.474a.d4cc   10.10.1.9       C8/0/1/U3.0  C8/0/1/U3.1
0019.474a.d554   10.10.1.73      C8/0/14/U0.0 C8/0/14/U0.1
0019.474a.d542   10.10.1.79      C8/0/0/U0.0  C8/0/0/U0.1
0019.474a.d508   10.10.1.11      C8/0/8/U0.0  C8/0/8/U0.1
0025.2e2d.7400   10.10.1.66      C8/0/0/U1.0  C8/0/0/U1.1
0022.cea4.f404   10.10.1.53      C8/0/2/U2.0  C8/0/2/U2.1

The following is a sample output of the show cable rf-adapt upgrade-candidates command:

Router# show cable rf-adapt upgrade-candidates

MAC Address      IP Address      Source       Destination
                                 Upstream     Upstream
0019.474a.d554   10.10.1.73      C8/0/14/U0.1 C8/0/14/U0.0
0019.474a.d542   10.10.1.79      C8/0/0/U0.1  C8/0/0/U0.0
0025.2e2d.7400   10.10.1.66      C8/0/0/U1.1  C8/0/0/U1.0

The following is a sample output of the show cable rf-adapt cable upstream downgrade-candidates command:

Router# show cable rf-adapt cable 7/0/0 upstream 0 downgrade-candidates

MAC Address      IP Address      Source       Destination
                                 Upstream     Upstream
0019.474a.d4cc   10.10.1.9       C7/0/0/U3.0  C7/0/0/U3.1

The following is a sample output of the show cable rf-adapt cable upstream upgrade-candidates command:

Router# show cable rf-adapt cable 7/0/0 upstream 0 upgrade-candidates

MAC Address      IP Address      Source       Destination
                                 Upstream     Upstream
0019.474a.d554   10.10.1.73      C7/0/0/U0.1  C7/0/0/U0.0

The following is a sample output of the show cable rf-adapt cable downgrade-candidates command:

Router# show cable rf-adapt cable 7/0/0 downgrade-candidates

MAC Address      IP Address      Source       Destination
                                 Upstream     Upstream
0019.474a.d4cc   10.10.1.9       C7/0/0/U3.0  C7/0/0/U3.1

The following is a sample output of the show cable rf-adapt cable upgrade-candidates command:

Router# show cable rf-adapt cable 7/0/0 upgrade-candidates

MAC Address      IP Address      Source       Destination
                                 Upstream     Upstream
0019.474a.d554   10.10.1.73      C7/0/0/U0.1  C7/0/0/U0.0

Table 62 describes the significant fields shown in the display.

Table 62 show cable modem rf-adapt Field Descriptions 

Field
Description

MAC Address

MAC address of the cable modem.

IP Address

IP address of the cable modem.

Source Upstream

Source upstream port and logical channel index of the cable modem.

Destination Upstream

Destination upstream port and logical channel index to which the cable modem will be moved.


Related Commands

Command
Description

cable rf-adapt timer

Configures timers for RF adaptation.

cable upstream rf-adapt

Enables RF adaptation on the physical upstream channel.

cable upstream rf-adapt (logical channel)

Specifies the primary upstream logical channel and the secondary upstream logical channel.

cable upstream threshold rf-adapt

Configures the upstream RF adaptation threshold value, which prevents excessive relocation of modems from the primary upstream channel to the secondary upstream channel.

show cable modem

Displays information about the registered and unregistered cable modems.

show cable modem rf-adapt

Displays the RF adaptation history.


show cable rf-status

To display the logical up and down state of a channel number, or the logical state of all RF channels, use the show cable rf-status command in privileged EXEC mode.

show cable rf-status [modular-cable slot/bay/port:nb-channel-number]

Syntax Description

modular-cable

(Optional) Specifies the modular cable interface.

slot

(Optional) The slot where a SIP resides. On the Cisco uBR10012 router, slots 1 and 3 can be used for SIPs.

bay

(Optional) The bay in a SIP where a SPA is located. Valid values are 0 (upper bay) and 1 (lower bay).

port

(Optional) Specifies the interface number on the SPA.

nb-channel-number

(Optional) Specifies the channel number for the RF channel.


Command Default

No default behavior or values.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCB

This command was introduced.


Examples

The following is a sample output of the show cable rf-status command used to display the logical state of all RF channels on a modular cable interface:

Router# show cable rf-status

          Logical  Flap    Flap
RF        Status   Counts  Time
--------  -------  ------  ----
1/0/0 0   UP       0       
      1   UP       0       
      2   UP       0       
      3   UP       0       
      5   UP       0       
      6   UP       0       
      7   UP       0       
      8   UP       0       
      9   UP       0       
      10  UP       0       
      11  UP       0       
      12  UP       0       
      13  UP       0       
      14  UP       0       
      15  UP       0       
      16  UP       0       
      17  UP       0       
      18  UP       0       
      19  UP       0       
      20  UP       0       
      21  UP       0       
      22  UP       0       
      23  UP       0       

Table 63 describes the significant fields shown in the display.

Table 63 show cable rf-status Field Descriptions 

Field
Description

RF

Indicates the RF channel ID.

Logical Status

Indicates the logical up and down state of all RF channels.

Flap Counts

Indicates the number of times the RF channel has dropped and recovered.

Flap Time

Indicates the duration in seconds for each flap count.


The following is a sample output of the show cable rf-status command used to display the logical up and down state of a particular channel number on a modular cable interface:

Router# show cable rf-status modular-cable 1/0/0:1
Load for five secs: 6%/0%; one minute: 3%; five minutes: 2%
Time source is NTP, .14:47:27.751 EDT Thu Aug 7 2008
          Logical  Flap    Flap
RF        Status   Counts  Time
--------  -------  ------  ----
1/0/0 1   UP       0 

Related Commands

Command
Description

show interface rf-status

Displays the logical up and down state for each of the configured RF channels for a wideband interface.


show cable rsvp flow-db

To display contents of the Resource ReSerVation Protocol (RSVP) to DOCSIS service-flow mapping database, use the show cable rsvp flow-db command in user EXEC mode.

show cable rsvp flow-db [mac-addr]

Syntax Description

mac-addr

(Optional) The MAC address of the specific cable modem in hexadecimal format.


Command Default

No default behavior or values.

Command Modes

User EXEC mode

Command History

Release
Modification

12.2(33)SCB

This command was introduced.


Usage Guidelines

The show cable rsvp flow-db command displays contents of the RSVP to DOCSIS service-flow mapping database.

Examples

The following example shows the sample output for the show cable rsvp flow-db command.

Router# show cable rsvp flow-db 
CM Count   : 1
Flow Count : 1
Mac Address    Src IP          Src   Dest IP         Dest  Pr Sfid  Dir Handle  
                               Port                  Port  ot           (Hex)
0019.474a.c5f6 200.0.0.1       1000  40.1.1.62       1000  6  11    DS  7000406

Table 64 describes the significant fields shown in the display.

Table 64 cable rsvp flow-db Field Descriptions 

Field
Description

Mac Address

The MAC address of the specific cable modem.

Src IP

RSVP path source IP address.

Src Port

RSVP path source port number.

Dest IP

Destination IP address.

Dest port

Destination port number.

Proto

IP protocol type. Here 17 is the UDP's IP protocol number.

SFid

Service flow ID.

Dir

Direction of the DOCSIS service flow. Here DS indicates downstream flow.


Related Commands

Command
Description

cable rsvp default-scn

Specifies the default service class for the RSVP.


show cable service-class

To display the parameters for cable service class, use the show cable service class command in privileged EXEC mode.

show cable service-class [sclass-index] [verbose]

Syntax Description

sclass-index

Identifies the index for a service class that has already been defined (1 to 255).

verbose

Displays all of the defined attributes for the service class.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.1(4)CX

This command was introduced.

12.2(4)BC1

Support was added to the Release 12.2 BC train.

12.2(33)SCC

This command was integrated into Cisco IOS Release 12.2(33)SCC. The command output was modified to display the traffic peak rate value for a specific service flow.

12.2(33)SCF2

This command was modified. The command output was enhanced to display upstream buffer control parameters.


Usage Guidelines

You can display a summary of either one service class or all service classes. You can also display a complete listing of each service class and of all the defined service classes.

Examples

The following sample output shows the standard and verbose formats of the show cable service class command:

Router# show cable service-class 
Index Name             Dir   Sched  Prio MaxSusRate  MaxBurst    MinRsvRate
1     UP_UGS           US/DS UGS    0    0           1522        0
2     UP_UGSAD         US/DS UGS_AD 0    0           1522        0
3     UP_RTPS          US/DS RTPS   0    128000      2000        64000
4     UP_BE            US/DS BE     5    128000      2000        0
5     DOWN_BE          US/DS BE     5    1000000     3000        0
Router# show cable service-class 1 
Index Name             Dir   Sched  Prio MaxSusRate  MaxBurst    MinRsvRate
1     UP_UGS           US/DS UGS    0    0           1522        0     
Router# show cable service-class 1 verbose 
Index:                                  1
Name:                                   UP_UGS
Direction:                              Upstream/Downstream
Traffic Priority:                       0
Maximum Sustained Rate:                 0 bits/sec
Max Burst:                              1522 bytes
Minimum Reserved Rate:                  0 bits/sec
Minimum Packet Size                     100 bytes
Admitted QoS Timeout                    30 seconds
Active QoS Timeout                      30 seconds
Scheduling Type:                        Unsolicited Grant Service
Request/Transmission Policy:            0x1FF
Unsolicited Grant Size:                 100 bytes
Nominal Grant Interval:                 20000 usecs
Tolerated Grant Jitter:                 4000 usecs
Grants per Interval:                    1
IP ToS Overwrite [AND-mask,OR-mask]:    0xE0,0xA0
Max Latency:                            0 usecs
Parameter Presence Bitfield:            {0xE08, 0xBCC000}  
Router# show cable service-class verbose 
Index:                                  1
Name:                                   UP_UGS
Direction:                              Upstream/Downstream
Traffic Priority:                       0
Maximum Sustained Rate:                 0 bits/sec
Max Burst:                              1522 bytes
Minimum Reserved Rate:                  0 bits/sec
Minimum Packet Size                     100 bytes
Peak Rate                               0 bits/sec
Admitted QoS Timeout                    30 seconds
Active QoS Timeout                      30 seconds
Scheduling Type:                        Unsolicited Grant Service
Request/Transmission Policy:            0x1FF
Unsolicited Grant Size:                 100 bytes
Nominal Grant Interval:                 20000 usecs
Tolerated Grant Jitter:                 4000 usecs
Grants per Interval:                    1
IP ToS Overwrite [AND-mask,OR-mask]:    0xE0,0xA0
Max Latency:                            0 usecs
Parameter Presence Bitfield:            {0xE08, 0xBCC000}
Index:                                  2
Name:                                   UP_UGSAD
Direction:                              Upstream/Downstream
Traffic Priority:                       0
Maximum Sustained Rate:                 0 bits/sec
Max Burst:                              1522 bytes
Minimum Reserved Rate:                  0 bits/sec
Minimum Packet Size                     100 bytes
Peak Rate                               0 bits/sec
Admitted QoS Timeout                    30 seconds
Active QoS Timeout                      30 seconds
Scheduling Type:                        Unsolicited Grant Service(AD)
Request/Transmission Policy:            0x1FF
Nominal Polling Interval:               10000 usecs
Tolerated Poll Jitter:                  4000 usecs
Unsolicited Grant Size:                 100 bytes
Nominal Grant Interval:                 20000 usecs
Tolerated Grant Jitter:                 4000 usecs
Grants per Interval:                    1
IP ToS Overwrite [AND-mask,OR-mask]:    0xE0,0xA0
Max Latency:                            0 usecs
Parameter Presence Bitfield:            {0xE08, 0xBFC000}
Index:                                  3
Name:                                   UP_RTPS
Direction:                              Upstream/Downstream
Traffic Priority:                       0
Maximum Sustained Rate:                 128000 bits/sec
Max Burst:                              2000 bytes
Minimum Reserved Rate:                  64000 bits/sec
Minimum Packet Size                     64 bytes
Peak Rate                               0 bits/sec
Admitted QoS Timeout                    30 seconds
Active QoS Timeout                      30 seconds
Maximum Concatenated Burst:             1522 bytes
Scheduling Type:                        Realtime Polling Service
Request/Transmission Policy:            0x1FF
Nominal Polling Interval:               10000 usecs
Tolerated Poll Jitter:                  4000 usecs
IP ToS Overwrite [AND-mask,OR-mask]:    0xE0,0xA0
Max Latency:                            0 usecs
Parameter Presence Bitfield:            {0xDC8, 0x83E000}
Index:                                  4
Name:                                   UP_BE
Direction:                              Upstream/Downstream
Traffic Priority:                       5
Maximum Sustained Rate:                 128000 bits/sec
Max Burst:                              2000 bytes
Minimum Reserved Rate:                  0 bits/sec
Minimum Packet Size                     64 bytes
Peak Rate                               0 bits/sec
Admitted QoS Timeout                    30 seconds
Active QoS Timeout                      30 seconds
Maximum Concatenated Burst:             1522 bytes
Scheduling Type:                        Best Effort
Request/Transmission Policy:            0x0
IP ToS Overwrite [AND-mask,OR-mask]:    0xE0,0x0
Max Latency:                            0 usecs
Parameter Presence Bitfield:            {0xDE8, 0x80E000}
Index:                                  5
Name:                                   DOWN_BE
Direction:                              Upstream/Downstream
Traffic Priority:                       5
Maximum Sustained Rate:                 1000000 bits/sec
Max Burst:                              3000 bytes
Minimum Reserved Rate:                  0 bits/sec
Minimum Packet Size                     64 bytes
Peak Rate                               0 bits/sec
Admitted QoS Timeout                    30 seconds
Active QoS Timeout                      30 seconds
Maximum Concatenated Burst:             0 bytes
Scheduling Type:                        Best Effort
Request/Transmission Policy:            0x0
IP ToS Overwrite [AND-mask,OR-mask]:    0xFF,0x0
Max Latency:                            0 usecs
Parameter Presence Bitfield:            {0xDE8, 0x0}
The following is a sample output of the show cable service class command with verbose option, for 
Cisco IOS release 12.2(33)SCF2:
Router# show cable service-class 10 verbose
Index:                                  10
Name:                                   REG-US
Direction:                              Upstream
Traffic Priority:                       0
Maximum Sustained Rate:                 0 bits/sec
Max Burst:                              3044 bytes
Minimum Reserved Rate:                  0 bits/sec
Minimum Packet Size                     0 bytes
Peak Rate                               0 bits/sec
Admitted QoS Timeout                    200 seconds
Active QoS Timeout                      0 seconds
Maximum Concatenated Burst:             1522 bytes
Scheduling Type:                        Best Effort
Request/Transmission Policy:            0x0
IP ToS Overwrite [AND-mask,OR-mask]:    0xFF,0x0
Parameter Presence Bitfield:            {0x8, 0x0}
!Upstream Buffer Control Parameters
Minimum Buffer Size:                    1000 bytes
Target Buffer Size:                     1500 bytes
Maximum Buffer Size:                    2000 bytes

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

cable service class

Defines and modifies a service class.

show interface cable qos paramset

Displays the parameters in one or more service templates.


show cable service-voice downstream-type

To display the downstream-types that are capable of providing voice services, use the show cable service-voice downstream-type command.

show cable service-voice downstream-type

Syntax Description

This command has no keywords or arguments.

Command Default

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(23)BC

This command was introduced for the Cisco uBR10012 router.


Usage Guidelines

Use this command to display the downstream-types that are capable for providing voice services on each uBR10-MC 5x20 line card.

Examples

The example below shows that both HA-capable-DS and MDC-DS are enabled for downstream types on the uBR10-MC 5x20 line card in slot 5, subslot 1 and the line card in slot 6, subslot 0.

Router# show cable service-voice downstream-type
Slot 5/1 :    HA-capable-DS               MDC-DS
Slot 6/0 :    HA-capable-DS               MDC-DS

show cable signal-quality

To display information about the signal quality of an upstream port on a cable interface, use the show cable signal-quality command in privileged EXEC mode.

show cable signal-quality {cable {slot/port | slot/subslot/port} upstream number | cmts | mer}

Syntax Description

cable

Specifies the cable interface.

slot/subslot/port

Displays information about all CMs on the specified cable interface line card on a Cisco CMTS router:

slot—Chassis slot number of the cable interface line card. Valid slots are from 5 to 8.

subslot—Secondary slot number of the cable interface line card. Valid subslots are 0 or 1.

port—Port number. Valid ports are from 0 to 4, depending on the cable interface line card.

upstream number

Specifies the upstream channel ID. Valid values are from 0 to 3.

cmts

Displays the carrier-to-noise ratio (CNR) data and expected signal power received per cable interface.

mer

Displays the modulation error rate (MER) data per cable interface.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCC

This command was introduced in Cisco IOS Release 12.2(33)SCC.


Usage Guidelines

The show cable signal-quality command with the mer keyword displays the modulation error rate data per cable interface. Note that at least one cable modem (CM) must be online on the cable interface for this command to provide the modulation error rate data. This is identical to the modulation error rate data displayed by the show controllers command.

The CNR data is displayed only for the upstream channels that are assigned to a spectrum group. Upstream channels with fixed frequencies do not return any CNR data.

Examples

The following example shows the CNR data received on the upstream ports on the cable interface line card at slot/subslot/port 7/0/3 on a Cisco uBR10012 router:

Router# show cable signal-quality cable 7/0/3 cmts
I/F           CNiR            Expected Received
              (dB)            Signal Power (dBmV)
Cable7/0/3/U0 55.0            1.0          
Cable7/0/3/U1 44.0            0.0          
Cable7/0/3/U2 43.0            -1.0         
Cable7/0/3/U3 43.0            2.0 

The following example shows the MER data received on the cable upstream port 3 on the cable interface line card at slot/subslot/port 5/0/0 on a Cisco uBR10012 router:

Router# show cable signal-quality cable 5/0/0 upstream 3 mer
I/F           Received MER    Received MER
              (dB)            Samples
Cable5/0/0/U3 36.0            10

The following example shows the signal quality information for all cable interfaces on a Cisco uBR10012 router:

Router#show cable signal-quality mer
I/F           Received MER    Received MER
              (dB)            Samples
Cable6/1/0/U0 -----           -----
Cable6/1/0/U1 -----           -----
Cable6/1/0/U2 -----           -----
Cable6/1/0/U3 -----           -----
Cable6/1/1/U0 -----           -----
Cable6/1/1/U1 -----           -----
Cable6/1/1/U2 -----           -----
Cable6/1/1/U3 -----           -----
Cable6/1/2/U0 -----           -----
Cable6/1/2/U1 -----           -----
Cable6/1/2/U2 -----           -----
Cable6/1/2/U3 -----           -----
Cable6/1/3/U0 -----           -----
Cable6/1/3/U1 -----           -----
Cable6/1/3/U2 -----           -----
Cable6/1/3/U3 -----           -----
Cable6/1/4/U0 -----           -----
Cable6/1/4/U1 -----           -----
Cable6/1/4/U2 -----           -----
Cable6/1/4/U3 -----           -----
Cable7/1/0/U0 23.6            10
Cable7/1/0/U1 -----           -----
Cable7/1/0/U2 -----           -----
Cable7/1/0/U3 -----           -----
Cable7/1/1/U0 -----           -----
Cable7/1/1/U1 -----           -----
Cable7/1/1/U2 -----           -----
Cable7/1/1/U3 -----           -----
Cable7/1/2/U0 -----           -----
Cable7/1/2/U1 -----           -----
Cable7/1/2/U2 -----           -----
Cable7/1/2/U3 -----           -----
Cable7/1/3/U0 -----           -----
Cable7/1/3/U1 -----           -----
Cable7/1/3/U2 -----           -----
Cable7/1/3/U3 -----           -----
Cable7/1/4/U0 -----           -----
Cable7/1/4/U1 -----           -----
Cable7/1/4/U2 -----           -----
Cable7/1/4/U3 -----           -----
Cable8/0/0/U0 36.1            10
Cable8/0/0/U1 -----           -----

Table 65 describes the major fields displayed by the show cable signal-quality command.

Table 65 show cable signal-quality Command Field Descriptions 

Field
Description

I/F

Cable interface.

CNiR (db)

CNR value.

Expected Received Signal Power (dBmV)

Expected signal power received per upstream port.

Received MER (db)

Received MER signal-to-noise ratio (SNR) value.

Received MER (samples)

Samples used for calculating the SNR per upstream port.


Related Commands

Command
Description

show cable spectrum-analysis

Displays information about the spectrum measurements of an upstream port on a cable interface on a Cisco uBR10012 router.

show controllers

Displays information about the interface controllers for a cable interface on the Cisco CMTS router.

show cable modem cnr

Displays information about CNR or SNR data for a particular cable modem.

show cable modem

Displays information about the registered and unregistered CMs on a Cisco CMTS router.


show cable spectrum-analysis

To display information about the spectrum measurements of an upstream port on a cable interface line card, use the show cable spectrum-analysis command in privileged EXEC mode.

show cable spectrum-analysis slot/subslot/port upstream port

Syntax Description

slot/subslot/port

Displays information about all CMs on the specified cable interface line card on a Cisco CMTS router:

slot—Chassis slot number of the cable interface line card. Valid slots are from 5 to 8.

subslot—Secondary slot number of the cable interface line card. Valid subslots are 0 or 1.

port—Downstream port number. Valid ports are from 0 to 4, depending on the cable interface line card.

upstream port

Specifies the upstream port number.


Command Modes

Privileged EXEC(#)

Command History

Release
Modification

12.2(33)SCC

This command was introduced in Cisco IOS Release 12.2(33)SCC.


Examples

The following example shows the spectrum measurements on upstream port 1 on a Cisco uBR10012 router:

Router# show cable spectrum-analysis  c5/0/0 upstream 1
Spectrum Analysis Measurements for Cable5/0/0: Upstream 1
Channel Center Frequency: 17000000 Hz
Frequency Span: 6400000 Hz
Number of Bins: 321
Bin Spacing: 20000 Hz
Resolution Bandwidth: 34200 Hz
Amplitude Data:
    Bin   1: -60.00 dBmV
    Bin   2: -58.00 dBmV
    Bin   3: -58.00 dBmV
    Bin   4: -58.00 dBmV
    Bin   5: -55.00 dBmV
    Bin   6: -55.00 dBmV
    Bin   7: -58.00 dBmV
    Bin   8: -55.00 dBmV
    Bin   9: -49.00 dBmV
    Bin  10: -49.00 dBmV
    Bin  11: -49.00 dBmV
    Bin  12: -49.00 dBmV
    Bin  13: -49.00 dBmV
    Bin  14: -55.00 dBmV
    Bin  15: -58.00 dBmV
    Bin  16: -45.00 dBmV
    Bin  17: -38.00 dBmV
    Bin  18: -35.00 dBmV
    Bin  19: -33.00 dBmV
    Bin  20: -33.00 dBmV
    Bin  21: -34.00 dBmV
    Bin  22: -37.00 dBmV
    Bin  23: -37.00 dBmV
    Bin  24: -32.00 dBmV
    Bin  25: -28.00 dBmV
    Bin  26: -27.00 dBmV
    Bin  27: -26.00 dBmV
    Bin  28: -27.00 dBmV
    Bin  29: -31.00 dBmV
    Bin  30: -32.00 dBmV
    Bin  31: -29.00 dBmV
    Bin  32: -29.00 dBmV

Table 65 describes the significant fields shown in the display.

Table 66 show cable spectrum-analysis Field Descriptions 

Field
Description

Spectrum analysis measurements

Spectrum measurements.

Channel center frequency

Channel center frequency value.

Frequency span

Frequency span.

No of Bins

Total number of bins in the spectrum analysis data.

Bin spacing

Spacing between the center frequency of each bin.

Resolution Bandwidth

Spacing between bins after the spectral window is applied.

Amplitude Data

Spectral amplitudes for the received signal power of a bin.


Related Commands

Command
Description

show cable signal-quality

Displays information about the signal quality of an upstream port on a cable interface line card.

show controllers cable

Displays information about the interface controllers for a cable interface line card on a Cisco CMTS router.

show cable modem cnr

Displays information about the upstream carrier-to-noise ratio (CNR) or signal-to-noise ratio (SNR) for a particular cable modem.


show cable spectrum-group

To display information about spectrum groups on a Cisco CMTS, use the show cable spectrum-group command in user EXEC or privileged EXEC mode.

show cable spectrum-group [groupnum] [detail]

Syntax Description

groupnum

(Optional) Displays information about the specified group number (1-32). If no group number is specified, information for all spectrum groups is displayed.

detail

(Optional) Displays whether the groups are allocated, free, or in-use.


Command Modes

User EXEC, Privileged EXEC

Command History

Release
Modification

11.3 NA

This command was introduced.

12.0(5)SC, 12.0(5)T

The detail keyword was added.


Examples

The following is sample output from the show cable spectrum-group command for all upstream spectrum groups:

CMTS01# show cable spectrum-group 
 Group  Frequency      Upstream     Weekly Scheduled            Power   Shared
 No.    Band           Port         Availability                Level   Spectrum
        (Mhz)                       From Time:    To Time:      (dBmV)
 1       5.000-42.000                                           0       No 
 1      17.328 [1.60]  Cable3/0 U0                              0     
 1       5.808 [1.60]  Cable3/0 U1                              0     
 1       5.808 [1.60]  Cable3/0 U2                              0     
 1      15.792 [1.60]  Cable3/0 U3                              0     
 1       6.096 [1.60]  Cable3/0 U4                              0     
 1       5.808 [1.60]  Cable3/0 U5                              0     
 2       5.000-42.000                                           0       No 
 2       6.608 [3.20]  Cable6/0 U1                              0     
 2       5.808 [1.60]  Cable6/0 U2                              0     
 2       5.808 [1.60]  Cable6/0 U3                              0     
 2       5.808 [1.60]  Cable6/0 U4                              0     
 2       5.808 [1.60]  Cable6/0 U5                              0     
 3       5.000-42.000                                           0       No 
 3      17.488 [1.60]  Cable5/0 U1                              0     
 3       6.160 [1.60]  Cable5/0 U2                              0     
 3      36.912 [1.60]  Cable5/0 U3                              0     
 3      36.560 [1.60]  Cable5/0 U4                              0     
 3      16.240 [1.60]  Cable5/0 U5                              0     
 4       6.000- 8.600                                           0       No 
 4      16.000-18.000                                           0       No 
 4      17.168 [1.60]  Cable5/0 U0                              0     
 5       5.000-42.000                                           0       No 
 6       5.000-42.000                                           0       No 
 7       5.000-42.000                                           0       No 
 8       5.000-42.000                                           0       No 
 9       5.000-42.000                                           0       No 
 10      5.000-42.000                                           0       No 
 11      5.000-42.000                                           0       No 
 12     10.000-13.000                                           0       No
CMTS# 

The following is sample output from the show cable spectrum-group detail command:

CMTS# show cable spectrum-group detail 
Group  Frequency      Upstream     Weekly Scheduled            Power   Shared
No.    Band           Port         Availability                Level   Spectrum
       (Mhz)                       From Time:    To Time:      (dBmV)
1      10.000                                                  1       Yes
1      10.000                                                  2       Yes
1      11.000                                                  3       Yes
1      11.000                                                  4       Yes
1      15.000-20.000                                           0       Yes
  A     8.400-12.600
  A    15.000-20.000
1      11.008 [0.80]  Cable3/0 U2                              4
1      15.808 [1.60]  Cable3/0 U3                              0
1      Unassigned     Cable3/0 U4
1      17.408 [1.60]  Cable3/0 U5                              0
  I    10.600-11.400                                           4
  I    15.000-16.600                                           0
  I    16.600-18.200                                           0
  F     8.400-10.600
  F    11.400-12.600
  F    18.200-20.000
  C    Width  [3.20]
  C    Width  [1.60]
  C    Width  [0.80]
  O    19.000 [1.60]                                           0
  O    10.000 [0.80]                                           2
  O    18.600 [0.80]                                           0
  O    19.400 [0.80]                                           0
  O    10.000 [0.80]                                           1
CMTS# 

Table 0-67 describes the fields shown in the show cable spectrum-group displays.

Table 0-67 show cable spectrum-group Command Field Descriptions 

Field
Description

Group No.

Identifies the spectrum group. When using the detail keyword, the following also appear:

A = Signifies that the band is allocated.

F = Signifies that the band is free.

I = Signifies that the band is in-use.

C = Identifies the channel width.

O = Identifies the offered list bands (based on the current channel widths).

Frequency Band (MHz)

Identifies the upper and lower ranges of the frequency for this spectrum group.

Upstream Port

Identifies the upstream port number.

Weekly Scheduled Availability

Identifies the day and time of day when this group is available. If no values appear in the From and To Time fields, this group is available at all times.

Input PowerLevel

Identifies the assigned decibels per millivolt (dBmV) input level.

Shared Spectrum

Indicates if upstreams are physically combined (share the same combiner group). Y or yes values indicate that upstreams that are members of the spectrum group are combined and cannot be assigned overlapping frequency bands.

N or no values indicate that upstreams that are members of the spectrum group are not combined and can be assigned overlapping frequency bands.



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

show cable hop

Displays CM configuration settings.

show cable modulation-profile

Displays modulation profile group information.


show cable subscriber-usage

To display subscribers who are violating their registered quality of service (QoS) profiles, use the show cable subscriber-usage command in privileged EXEC mode.

show cable subscriber-usage [over-consume] [{cable slot/port | cable slot/subslot/port}[upstream port]] [sort-byte-count] [sort-avg-rate]

Syntax Description

over-consume

(Optional) Displays only those subscribers who have exceeded their maximum allowed bandwidth.

cable slot/port

(Optional) Displays information for all CMs on the specified cable interface and downstream port on a Cisco 7100 series or Cisco 7200 series router, where:

slot—Specifies the chassis slot number of the cable interface line card.

port—Specifies the downstream port number.

Valid values for these arguments are dependent on your CMTS router and cable interface line card. Refer to the hardware documentation for your router chassis and cable interface line card for supported slot and port numbering.

cable slot/subslot/port

(Optional) Displays information for all CMs on the specified cable interface on a Cisco uBR10012 router, where:

slot—Specifies the chassis slot number of the cable interface line card. Valid slots are 5 to 8.

subslot—Specifies the secondary slot number of the cable interface line card. Valid subslots are 0 or 1.

port—Specifies the downstream port number. Valid ports are 0 to 4, depending on the cable interface line card.

upstream port

(Optional) Displays information for a particular upstream on the selected cable interface. The port value starts with 0 and continues up, depending on the type of cable interface card.

sort-byte-count

(Optional) Sorts the list by the subscriber byte count, with the highest byte counts listed first. The default is to sort the list by Service Flow ID (SFID). (This option is replaced by the sort-avg-rate keyword in later releases.)

sort-avg-rate

(Optional) Sorts the list by the subscriber's average rate. The default is to sort the list by Service Flow ID (SFID).


Command Default

All subscribers are shown, with the display sorted by SFID.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(15)BC1

This command was introduced.

12.3(9a)BC

This command was integrated into Cisco IOS Release 12.3(9a)BC. The sort-byte-count keyword option is replaced by the sort-avg-rate keyword option.

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 show cable subscriber-usage command displays the current usage statistics for all subscribers on the Cisco CMTS router, all subscribers on a particular cable interface, or for only those subscribers that are marked as over-consuming bandwidth.

Effective with Cisco IOS Release 12.3(9a)BC, the sort-byte-count keyword option is replaced by the sort-avg-rate keyword option.

Examples

The following example shows typical output for the default version of the show cable subscriber-usage command:

Router# show cable subscriber-usage 
Sfid Mac Address   Enforce-rule Total-Kbyte  Last-detect    Last-penalty   Pen
                      Name        Count         time           time        Flag
3    0007.0e03.110d efrule-q5   121944817  Jan1  03:44:08  Jan1  03:54:08  Act
4    0007.0e03.110d efrule-q5d  1879076068 Jan1  03:35:05  Jan1  03:45:06  Act
5    0007.0e03.1431 efrule-q5   120052387  Jan1  03:44:18  Jan1  03:54:18  Act
6    0007.0e03.1431 efrule-q5d  1838493626 Jan1  03:34:55  Jan1  03:44:55  Act
7    0007.0e03.1445 efrule-q5   120919427  Jan1  03:44:08  Jan1  03:54:08  Act
8    0007.0e03.1445 efrule-q5d  1865955172 Jan1  03:35:06  Jan1  03:45:06  Act
9    0007.0e03.1225 efrule-q5   120200155  Jan1  03:44:18  Jan1  03:54:18  Act
10   0007.0e03.1225 efrule-q5d  1839681070 Jan1  03:34:55  Jan1  03:44:55   - 
11   0007.0e03.0cb1 efrule-q5   122941643  Jan1  03:43:58  Jan1  03:53:58  Act
12   0007.0e03.0cb1 efrule-q5d  1889107176 Jan1  03:35:06  Jan1  03:45:06  Act
13   0007.0e03.1435 efrule-q5   119504795  Jan1  03:44:18  Jan1  03:54:18  Act
14   0007.0e03.1435 efrule-q5d  1835164034 Jan1  03:34:55  Jan1  03:44:55   - 
15   0007.0e02.f80d efrule-q5   119250047  Jan1  03:44:18  Jan1  03:54:18  Act
16   0007.0e02.f80d efrule-q5d  1832034114 Jan1  03:34:55  Jan1  03:44:55   - 
17   0007.0e03.1469 efrule-q5   117562137  Jan1  03:44:18  Jan1  03:54:18  Act
18   0007.0e03.1469 efrule-q5d  1816957486 Jan1  03:34:55  Jan1  03:44:55   - 
19   0007.0e03.11f9 efrule-q5   124265775  Jan1  03:44:18  Jan1  03:54:18  Act
20   0007.0e03.11f9 efrule-q5d  1959957066 Jan1  03:35:46  Jan1  03:45:46  Act
21   0007.0e03.1461 efrule-q5   113314731  Jan1  03:34:55  Jan1  03:44:55   - 
22   0007.0e03.1461 efrule-q5d  1827583110 Jan1  03:35:46  Jan1  03:45:46  Act
23   0007.0e03.11d9 efrule-q5   104607787  Jan1  03:34:55  Jan1  03:44:55   - 
24   0007.0e03.11d9 efrule-q5d  1675444338 Jan1  03:34:55  Jan1  03:44:55   - 
25   0007.0e03.1475 efrule-q5   113751019  Jan1  03:34:55  Jan1  03:44:55   - 
26   0007.0e03.1475 efrule-q5d  1841060070 Jan1  03:35:56  Jan1  03:45:56  Act
27   0007.0e03.10d9 efrule-q5   113713981  Jan1  03:34:55  Jan1  03:44:55   - 
28   0007.0e03.10d9 efrule-q5d  1840272262 Jan1  03:35:56  Jan1  03:45:56  Act
29   0007.0e03.1065 efrule-q5   113443243  Jan1  03:34:55  Jan1  03:44:55   - 
30   0007.0e03.1065 efrule-q5d  1834855264 Jan1  03:35:56  Jan1  03:45:56  Act
31   0007.0e03.1081 efrule-q5   119843737  Jan1  03:44:18  Jan1  03:54:18  Act
32   0007.0e03.1081 efrule-q5d  1852632338 Jan1  03:35:56  Jan1  03:45:56  Act
33   0007.0e03.1179 efrule-q5   118522795  Jan1  03:44:18  Jan1  03:54:18  Act
34   0007.0e03.1179 efrule-q5d  1834693996 Jan1  03:35:56  Jan1  03:45:56  Act
35   0007.0e03.1471 efrule-q5   122182565  Jan1  03:43:58  Jan1  03:53:58  Act
36   0007.0e03.1471 efrule-q5d  1881390866 Jan1  03:34:55  Jan1  03:44:55   - 
37   0007.0e03.1341 efrule-q5   129557931  Jan1  03:43:48  Jan1  03:53:48  Act
38   0007.0e03.1341 efrule-q5d  2016792338 Jan1  03:35:56  Jan1  03:45:56  Act

The following example shows typical output for subscribers on a particular cable interface:

Router# show cable subscriber-usage c6/0/0 
Sfid Mac Address   Enforce-rule Total-Kbyte  Last-detect    Last-penalty   Pen
                      Name        Count       time             time        Flag
7    0007.0e03.2cad test1       0          Jan1  00:00:00  Jan1  00:00:00   - 
9    0007.0e03.2c45 test1       0          Jan1  00:00:00  Jan1  00:00:00   - 

The following example shows typical output for the show cable subscriber-usage command for one upstream on a particular cable interface:

Router# show cable subscriber-usage c6/0/1 upstream 0 
Sfid Mac Address   Enforce-rule Total-Kbyte  Last-detect    Last-penalty   Pen
                      Name        Count       time             time        Flag
5    0007.0e03.2c25 test1       0          Jan1  00:00:00  Jan1  00:00:00   - 

The following example shows typical output for the sort-byte-count option for the show cable subscriber-usage command:

Router# show cable subscriber-usage sort-byte-count 
Sfid Mac Address   Enforce-rule Total-Kbyte  Last-detect    Last-penalty   Pen
                      Name        Count       time             time        Flag
7    0007.0e03.2cad test1       65157114   Feb24 11:36:34  Mar3  11:36:34  Act
9    0007.0e03.2c45 test1       16381014                                    - 
5    0007.0e03.2c25 test1       13440960                                    - 

Table 68 describes the fields shown by the show cable subscriber-usage command.

Table 68 show cable subscriber-usage Field Descriptions 

Field
Description

SFID

Number of the Service Flow ID.

Mac Address

Hardware address (MAC address) of the subscriber's cable modem.

Enforce-rule Name

Name of the enforce-rule being applied to this subscriber.

Total-Kbyte

Total number of kilobytes consumed by the subscriber's cable modem during the last monitoring-duration window.

Note The total byte count is reset to 0 whenever an enforce-rule's configuration is changed.

Last-detect time

Last time period, if any, at which it was determined that the cable modem was using more bandwidth than allowed by their QoS profile. This value also shows the time at which the enforced QoS profile was automatically applied, if this option has been enabled.

Last-penalty time

If an enforced QoS profile is currently in effect, this field shows the time period at which the subscriber's current penalty time expires, at which point their original registered QoS profile is restored.

Pen Flag

Identifies whether a penalty enforce-rule has been applied to this cable modem.


Related Commands

Command
Description

activate-rule at-byte-count

Specifies the number of bytes that a subscriber can transmit during the monitoring period on a Cisco CMTS router.

cable qos enforce-rule

Creates an enforce-rule to enforce a particular QoS profile for subscriber traffic management and enters enforce-rule configuration mode.

duration

Specifies the time period and sample rate to be used for monitoring subscribers.

enabled (enforce-rule)

Activates an enforce-rule and begins subscriber traffic management on a Cisco CMTS Router.

penalty-period

Specifies the time period that an enforced QoS profile should be in effect for subscribers who violate their registered QoS profiles.

qos-profile enforced

Specifies a QoS profile that should be enforced when users violate their registered QoS profiles.

qos-profile registered

Specifies the registered QoS profile that should be used for this enforce-rule.

show cable qos enforce-rule

Displays the QoS enforce-rules that are currently defined.


show cable tech-support

To display general information about the router when reporting a problem, use the show cable tech-support command in privileged EXEC mode.

show cable tech-support {slot/port | slot/subslot/port}

Syntax Description

slot/port

(Optional) Cisco IOS Release 12.3(9a)BC allows you to display information about one specific cable interface.

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

(Optional) Cisco IOS Release 12.3(9a)BC allows you to display information about one specific cable interface.

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)


Command Default

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release
Modification

11.2

This command was introduced.

12.1(1a)T1

This command was modified to include information about the cable clock card.

12.2(15)BC2

This command added several show pxf commands to the display on the Cisco uBR10012 router.

12.3(9a)BC

The output of the command was significantly shortened by moving a number of show commands (the ones that display information about individual cable modems) to the show tech-support command. This release also adds support for an option to display information about only one specific cable interface.


Usage Guidelines

The show cable tech-support command displays a large amount of configuration, run-time status, and other information about the cable interfaces on the Cisco CMTS. The output of this command can be provided to technical support representatives when reporting a problem.


Note The show tech-support includes most of the information shown in the show cable tech-support command. Unless the problem is clearly cable-specific, TAC personnel will typically request the show tech-support output to troubleshoot any problems.


The show cable tech-support command displays the output of a number of different show commands. The exact output depends on the platform, configuration, and type of protocols being used. Typically,the output includes the output from the following commands:

show cable modem

show cable flap-list

show cable qos profile

show cable modulation-profile

show cable spectrum-group

show cable hop

show interface cable sid (for each cable interface)

show interface cable sid connectivity (for each cable interface)

show interface cable downstream

show interface cable upstream

show interface cable mac-scheduler

show interface cable modem Other commands could be included in the show cable tech-support output, depending on the CMTS platform, the Cisco IOS software being used, and the cards that are installed in the chassis.

On the Cisco uBR10012 router, the following commands also appear in Cisco IOS Release 12.2(15)BC2 and later releases:

show pxf cpu statistics

show pxf cpu subblocks

show pxf cpu buffer

show pxf dma

show pxf cpu cef memory

show pxf cpu queue

show pxf cpu statistics drop


Tip Depending on the platform and configuration, the output from the show cable tech-support command can easily exceed the buffers found in most communications programs. To capture this output so it can be sent to Cisco TAC, use a Telnet program that allows you to capture the output directly to disk.


Examples

The following abbreviated example illustrates the cable modem and interface information for the Cisco uBR10012 router on which Cisco IOS Release 12.3(9a)BC is installed.

Router# show cable tech-support
----------------------------------- Slot 8/1 -----------------------------------
------------------ show cable modem Cable8/1/0 ------------------
MAC Address    IP Address      I/F       MAC         Prim RxPwr  Timing  Num BPI
                                         State       Sid  (dB)   Offset  CPE Enb
------------------ show cable modem Cable8/1/0 connectivity ------------------
Prim  1st time    Times  %online     Online time            Offline time
Sid   online      Online          min     avg     max     min     avg     max
------------------ show interface Cable8/1/0 sid ------------------
Sid  Prim  MAC Address    IP Address      Type Age      Admin   Sched  Sfid
                                                        State   Type
------------------ show interface Cable8/1/0 sid counter ------------------
Sid  Req-polls  BW-reqs    Grants     Packets    Frag       Concatpkts
     issued     received   issued     received   complete   received
------------------ show interface Cable8/1/0 sid association ------------------
Sid  Prim Online     IP Address      MAC Address    Interface     VRF Name
------------------ show interface Cable8/1/0 modem 0 ------------------
SID   Priv bits  Type      State       IP address      method    MAC address
------------------ show cable modem Cable8/1/1 ------------------
MAC Address    IP Address      I/F       MAC         Prim RxPwr  Timing  Num BPI
                                         State       Sid  (dB)   Offset  CPE Enb
------------------ show cable modem Cable8/1/1 connectivity ------------------
Prim  1st time    Times  %online     Online time            Offline time
Sid   online      Online          min     avg     max     min     avg     max
------------------ show interface Cable8/1/1 sid ------------------
Sid  Prim  MAC Address    IP Address      Type Age      Admin   Sched  Sfid
                                                        State   Type
------------------ show interface Cable8/1/1 sid counter ------------------
Sid  Req-polls  BW-reqs    Grants     Packets    Frag       Concatpkts
     issued     received   issued     received   complete   received
------------------ show interface Cable8/1/1 sid association ------------------
Sid  Prim Online     IP Address      MAC Address    Interface     VRF Name
------------------ show interface Cable8/1/1 modem 0 ------------------
SID   Priv bits  Type      State       IP address      method    MAC address

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

show controllers cable

Displays information about a specific line card's interface controllers.

show interface cable downstream

Displays information about the cable interface.

show running-config

Displays the current run-time configuration.

show startup-config

Displays the configuration that was used to initially configure the CMTS at system startup.

show tech-support

Displays the output from show commands that display the router's configuration and run-time status.

show version

Displays the configuration of the system hardware, the software version, the names and sources of configuration files, and the boot images.


show cable urm

To view the connector group table information on a Cisco uBR-MC3GX60V cable interface line card, use the show cable urm command in the privileged EXEC mode. The connector group table provides information about the cable MAC domain upstream channel to connector mapping of a physical upstream channel.

show cable urm [slot/subslot]

Syntax Description

slot/subslot

Identifies the cable interface on the Cisco uBR10012 router.

slot—Slot where the line card resides. The valid range is from 5 to 8.

subslot—Subslot where the line card resides. Available slots are 0 or 1.


Command Default

Display information for all the slot/subslot values that has been configured.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCE

This command was introduced.


Examples

The following is a sample output indicating the connector group table information of the cable line card in slot 6/1:

Router# show cable urm 6/1 
===
connector group table
===
card  cnnrs  md:us=>cnnr
6/1    0-3    3:2=> 1 *empty*   *empty*   *empty*   *empty*   *empty*  
              *empty*   *empty*   *empty*   *empty*   *empty*   *empty*  
       4-7    *empty*   *empty*   *empty*   *empty*   *empty*   *empty*  
              *empty*   *empty*   *empty*   *empty*   *empty*   *empty*  
       8-11   *empty*   *empty*   *empty*   *empty*   *empty*   *empty*  
              *empty*   *empty*   *empty*   *empty*   *empty*   *empty*  
      12-15   *empty*   *empty*   *empty*   *empty*   *empty*   *empty*  
              *empty*   *empty*   *empty*   *empty*   *empty*   *empty*  
      16-19   *empty*   *empty*   *empty*   *empty*   *empty*   *empty*  
              *empty*   *empty*   *empty*   *empty*   *empty*   *empty*  

Table 69 describes the significant fields shown in the display.

Table 69 show cable urm Field Descriptions

Field
Description

card

The slot/subslot information of the card.

cnnrs

The connector index range of connectors in a connector group. The values for the Cisco uBR-MC3GX60V, Cisco UBR-MC20X20V, and the Cisco uBR10-MC5X20U line cards are 0-19.

md:us=>cnnr

The MAC domain upstream channel to connector mapping information of a physical upstream channel. The entry position corresponding to a physical upstream channel index in a connector group. For uBR-MC3GX60V line card, there are 12 physical upstream channels in each connector group. For the UBR-MC20X20V and uBR10-MC5X20U line cards, there are 2 channels in each group. In the example, C6/1/3:U2 is mapped to connector 1 in the running config by the user using connector command. Internally, CMTS software maps C6/1/3:U2 to physical upstream channel 0 (1st entry) in the 0-3 connector group.


Related Commands

Command
Description

show running-config interface cable

Shows the MD:US connector mapping configured by users.


show cable us-sg

To display the upstream service groups configured on all cable interfaces of a Cisco CMTS router, use the show cable us-sg command in privileged EXEC mode.

show cable us-sg

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCC

This command was introduced in Cisco IOS Release 12.2(33)SCC.


Examples

The following is a sample output of the show cable us-sg command.

Router# show cable us-sg 
Cable MD 5/0/0
  US-SG-ID  : 1         US-Chan : U0,1,2,3,4,5
  Primary-DS: 1/0/0:0   US-SG-ID: 1
    MDD US-List   : U0,1,2,3,4,5
    MDD Ambiguity : U0,1,2,3,4,5
Cable MD 6/0/0
  US-SG-ID  : 1         US-Chan : U0,1,2,3
  Primary-DS: 1/0/0:4   US-SG-ID: 1
    MDD US-List   : U0,1,2,3
    MDD Ambiguity : U0,1,2,3
Cable MD 7/0/0
  US-SG-ID  : 1         US-Chan : U0,1,2,3
  Primary-DS: 7/0/0:0   US-SG-ID: 1
    MDD US-List   : U0,1,2,3
    MDD Ambiguity : U0,1,2,3
  Primary-DS: 7/0/0:1   US-SG-ID: 1
    MDD US-List   : U0,1,2,3
    MDD Ambiguity : U0,1,2,3

Table 1 shows the significant fields shown in the display:

Table 70 show interface cable service-flow Field Descriptions 

Field
Description

US-SG-ID

Upstream service group ID.

US-Chan

Upstream channels on the cable interface line card.

Primary-DS

Primary downstream interafce.

MDD US-List

MAC management message: MDD TLV type 7 content, upstream active channel list.

MDD Ambiguity

MAC management message: MDD TLV type 8 content, upstream ambiguity resolution channel list.


Related Commands

Command
Description

show cable mac-domain upstream-service-group

Displays runtime statistics of the upstream service group on a cable interface line card.