Table Of Contents

Cable Commands: show cable m through show cable t

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

show cable modem ipv6

show cable modem mac

show cable modem maintenance

show cable modem offline

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

show cable multicast qos

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-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 us-sg

Cable Commands: show cable m through show cable t

---

Revised: November 13, 2009, OL-15510-10

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

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 multicast dsid	12.2(33)SCC

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

Command Default

No default behavior or values.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.3(23)BC	This command was introduced.

Examples

---

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

---

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 59 describes the significant fields shown in the display.

Table 59 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 associations for all cable MAC domains, use the show cable mac-domain cable cgd-associations command in privileged EXEC mode.

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

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 or 1.
port	The downstream port used as a primary downstream channel. Valid values are 0 to 4.

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)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 (Cisco uBR10-MC5x20 line card interface):

•The SPA downstream channels that have been added to this MAC domain.

•The list of upstream channels associated with each SPA downstream channel and Cisco uBR10-MC5x20 downstream channels.

If the All column in the command output indicates Y, then this indicates that all upstream channels associated with the Cisco uBR10-MC5X20 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 that represents the SPA downstream channel is administratively up and its line protocol is 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.

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

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 or 1.
port	The downstream port used as a primary downstream channel. Valid values are 0 to 4.

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.

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

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.

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

Syntax Description

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

Table 60 describes the significant fields shown in the display.

Table 60 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 in Cisco IOS Release 12.2(33)SCC.

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 113 describes the significant fields shown in the display.

Table 61 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 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

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

Table 62 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—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).

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.

Cisco uBR7200 Series Routers

show cable modem [ip-address | mac-address | cable slot/port [upstream port] | name fqdn] [verbose]

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable slot/subslot/port [upstream port] | 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. You can also specify the MAC address for a CPE device behind a CM, and information for that CM will be 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.
verbose	Displays detailed information for the CMs.
cm-status	Displays CM status events.

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

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

Spoof attempt                       : Dynamic secret check failed

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 Output 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 Output 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)

Table 63 describes the significant fields shown in the display:

Table 63 Descriptions for the show cable modem Fields 

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	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 command has been configured.
Upstream Power Downstream Power	The 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	Indicates whether the CM is Wideband-capable or not.
Multi-Transmit Channel Mode	Indicates whether the CM is in MTC mode or not.
Upstream SNR	Upstream signal-to-noise ratio (SNR) for a particular cable modem (CM), in decibels (dB).
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.
Corrected Codewords rx	Correctable code words for a particular upstream channel.
Uncorrectable Codewords rx	Uncorrectable code words for a particular upstream channel.
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 whether the CM is capable of DOCSIS 2.0 (ATDMA) operation, as determined by the presence and value of the Enable 2.0 Mode (TLV39) field in the CM's Registration Request message or in the DOCSIS configuration file. The valid values are: •Y = TLV 39 was set to 1, indicating that the CM has enabled DOCSIS 2.0 mode. The CM could still be registered for DOCSIS 1.1 operations, however, on DOCSIS 1.X interfaces. •N = Either the TLV 39 field was not present in the CM's Registration Request message, indicating that the CM is not capable of DOCSIS 2.0 operations, or the TLV 39 field was set to 0 in the DOCSIS configuration file, preventing the CM from using the DOCSIS 2.0 mode.
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.
Spoof attempt	Displays the status of the dynamic shared secret checks for this CM. If the •Dynamic secret check failed = The DOCSIS configuration file did not contain the proper shared secret, indicating a possible theft-of-service attempt. •Did not TFTP config file = The CM failed to download a DOCSIS configuration file from the TFTP server. 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.

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

Table 64 Descriptions for the MAC State Field ¹

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 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	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 [upstream port] | mac-address] access-group

Cisco uBR10012 routers:

show cable modem cable slot/subslot/port [upstream port] access-group

Syntax Description

ip-address	(Optional) Displays access-group information for the CM with the specified IP address. (Cisco uBR7100 series and Cisco uBR7200 series routers only.)
mac-address	(Optional) Displays access-group information for the CM with the specified MAC address. (Cisco uBR7100 series and Cisco uBR7200 series routers only.)
cable slot/port	(Optional) 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.
cable 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)
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.

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.

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, see the "Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration" section.

---

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-65 describes the fields that are shown in the show cable modem access-group display:

Table 0-65 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 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 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 [upstream port] | name fqdn] calls

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable slot/subslot/port [upstream port] | name fqdn] calls

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.

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.

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 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 66 describes the fields that are shown in the show cable modem classifiers display:

Table 66 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, 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 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	(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

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

Usage Guidelines

This command displays information on the current CNR value for cable modems that are using interfaces on the following cable line cards:

•Cisco uBR-MC16S

•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 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 cnr 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 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 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 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

Router# 

The following example shows the 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 shows the 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

Table 67 describes the significant fields shown in the display:

Table 67 show cable modem cnr Field Descriptions 

Field	Description
MAC Address	The MAC address for the CM.
IP Address	The IP address that the DHCP server has assigned to the CM.
I/F	The cable interface line card providing the upstream for this CM.
MAC State	The current state of the MAC layer (see Table 64).
Prim SID	The 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.
snr/cnr	The current upstream carrier-to-noise ratio (CNR) or signal-to-noise ratio (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 signal-to-noise ration (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 64 shows the possible values for the MAC state field:

Table 68 MAC State Field Descriptions  ¹

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 interface cable modem	Displays information about the CMs connected to a particular cable interface.
show cable modem remote-query	Displays information collected by the remote-query feature.
show cable modulation-profile	Displays modulation profile group information.
show controllers cable	Displays information about the interface controllers for a cable interface on the Cisco CMTS router.
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 [upstream port] | name fqdn] connectivity

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable slot/subslot/port [upstream port] | name fqdn] connectivity

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

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.

---

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.

---

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.

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 69 describes the information shown in the show cable modem connectivity displays:

Table 69 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 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 [upstream port] | name fqdn] counters

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable slot/subslot/port [upstream port] | name fqdn] counters

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.

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.

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.

---

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 70 describes the fields shown in the show cable modem counters displays:

Table 70 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 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 10.14.1.20 cpe 

IP address        MAC address

10.14.30.100      00b0.4a9b.bc8c

10.14.30.101      00b0.4a9b.bc8d

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: •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 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 71 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 72 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/subslot [cable slot/subslot] [upstream port1 port2]]] [total]

show cable modem cable slot/subslot docsis version summary

Cisco uBR10012 Router

show cable modem docsis version [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: •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 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 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.

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 73 describes the significant fields shown in the display.

Table 73 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

Table 74 describes the significant fields shown in the display.

Table 74 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: n	Total number (n) 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: n	Total number (n) of cable modems with upstreams currently operating in wideband channel mode.
Total mode US Phy operating CMs: n	Total number (n) 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: n	Total number (n) of cable modems with downstreams operating in wideband channel mode.
Total Narrow Band DS operating CMs: n	Total number (n) 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    

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

-----------------------------------------------------------------------------

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 75 describes the significant fields shown in the display.

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

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 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 [upstream port] | name fqdn] domain-name

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable slot/subslot/port [upstream port] | name fqdn] domain-name

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.

Command Modes

Privileged EXEC (#)

Command History

Release	Modification
12.2(33)SCA	This command was introduced.

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

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 [upstream port] | name fqdn] errors

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable slot/subslot/port [upstream port] | name fqdn] errors

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

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 76 describes the fields shown in the show cable modem errors displays:

Table 76 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 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 [upstream port] | name fqdn] flap

Cisco uBR10012 Router

show cable modem [ip-address | mac-address | cable slot/subslot/port [upstream port] | name fqdn] flap

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.
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.
flap mtc	Displays aggregate data across all upstream channels for each flap detector for CMs in MTC mode. Displays per channel flap information for a single CM 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 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	A new keyword, mtc, was added to provide multiple transmit channel (MTC) information for CMs in the MTC mode. •The mtc keyword displays aggregate data across all upstream channels for each flap detector for CMs in the MTC mode. •The show cable modem flap command remains unchanged for non-MTC mode CMs.

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.