Cisco IOS CMTS Cable Command Reference
Appendix A: Cable Debug Commands

Table Of Contents

Appendix A: Cable Debug Commands

debug c10k-jacket

debug cable

debug cable admission-control

debug cable admission-control flow-categorization

debug cable arp

debug cable arp filter

debug cable bpiatp

debug cable bundle

debug cable classifiers

debug cable config-file

debug cable dcc

debug cable dci

debug cable dhcp

debug cable dsg

debug cable dynamic-secret

debug cable dynsrv

debug cable encap

debug cable envm

debug cable error

debug cable flap

debug cable fn

debug cable freqhop

debug cable hw-spectrum

debug cable interface

debug cable ipv6

debug cable keyman

debug cable l2-vpn

debug cable load-balance

debug cable mac-address

debug cable mac-protocol

debug cable mac-scheduler

debug cable map

debug cable metering

debug cable phs

debug cable phy

debug cable privacy

debug cable qos

debug cable range

debug cable receive

debug cable registration

debug cable remote-query

debug cable reset

debug cable rfmib

debug cable service-ds-selection

debug cable specmgmt

debug cable startalloc

debug cable subscriber-monitoring

debug cable telco-return

debug cable telco-return msg

debug cable tlvs

debug cable tod

debug cable transmit

debug cable ucc

debug cable ucd

debug cable upconverter

debug cable us-adm-ctrl

debug cable wbcmts

debug cable wbcmts resiliency

debug cable-modem bpkm

debug cable-modem bridge

debug cable-modem error

debug cable-modem interrupts

debug cable-modem mac log

debug cable-modem mac messages

debug cable-modem mac messages dynsrv

debug cable-modem map

debug cable-modem up-dis

debug checkpoint

debug cpd

debug cr10k-rp

debug cr10k-rp dbs-queue

debug crypto ipsec client ezvpn

debug docsis ssd

debug ehsa

debug hccp authentication

debug hccp channel-switch

debug hccp docsis-recovery

debug hccp events

debug hccp fast-failure-detection

debug hccp inter-db

debug hccp plane

debug hccp sync

debug hccp timing

debug hw-module all upgrade

debug hw-module bay

debug hw-module subslot

debug nls

debug packetcable all

debug packetcable cops

debug packetcable gate

debug packetcable hccp

debug packetcable ipc

debug packetcable subscriber

debug pxf

debug redundancy

debug usb


Appendix A: Cable Debug Commands


Revised: March 30, 2009, OL-15510-09

Additional debug commands are documented in the Cisco IOS Debug Command Reference, available on Cisco.com and the Documentation CD-ROM.


Caution The debug commands are primarily intended for use in controlled test and troubleshooting situations with a limited volume of traffic. You should use caution when enabling debug messages because sending these messages to the console consumes system resources. Turning on too many types of debug messages can adversely affect the router's network performance, depending on what messages are being displayed and the type of traffic that is occurring.

New Commands

Command
Cisco IOS Software Release

debug cable ipv6

12.2(33)SCA

debug cable service-ds-selection

12.3(23)BC

debug cr10k-rp dbs-queue

12.3(23)BC1

debug ehsa

12.2(33)SCA

debug cable wbcmts resiliency

12.2(33)SCB


Modified Commands

Command
Cisco IOS Software Release

debug cable wbcmts

12.2(33)SCB

debug cr10k-rp dbs-queue

12.2(33)SCB

debug hw-module all upgrade

12.2(33)SCB

debug hw-module bay

12.2(33)SCB

debug hw-module subslot

12.2(33)SCB


debug c10k-jacket

To enable debugging information for the Wideband SIP, use the debug c10k-jacket command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug c10k-jacket [events | plugin | spa-audits | spa-events | spa-vft]

no debug c10k-jacket

Syntax Description

events

Displays event information for the Wideband SIP.

plugin

Displays plugging processing information for the Wideband SIP.

spa-audits

Displays audit information for the Wideband SIP.

spa-events

Displays event information for the Wideband SIP.

spa-vft

Displays vft information for the Wideband SIP.


Command Default

No Wideband SIP debug messages are enabled.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.3(21)BC

This command was introduced for the Cisco uBR10012 router.


Usage Guidelines

The debug c10k-jacket command is intended for use by Cisco technical support personnel.


Caution Because debugging output is assigned high priority in the CPU process, it can render the system unusable. For this reason, use debug commands only to troubleshoot specific problems or during troubleshooting sessions with Cisco Systems technical support personnel. Moreover, it is best to use debug commands during periods of lower network traffic and fewer users. Debugging during these periods decreases the likelihood that increased debug command processing overhead will affect system use.

Examples

The following example shows how to enable the debug c10k-jacket spa-vft debug messages for the Wideband SIP.

Router# debug c10k-jacket spa-vft 
c10k jacket SPA VFT calls debugging is on
Router#
Sep  6 17:10:47.410: cr10k_wbcmts_rcv_spa_event: wbcmts spa event recv of type 3
Sep  6 17:10:47.410: NB chan stats: 1 entries.
Sep  6 17:10:47.414: cr10k_wbcmts_rcv_spa_event: wbcmts spa event recv of type 2
Sep  6 17:10:47.414: WB chan stats: 1 entries.

Related Commands

Command
Description

debug cable fn

Enables debugging information for cable fiber nodes.

debug cable wbcmts

Enables debugging information for the wideband CMTS.

debug hw-module bay

Enables debugging information for a Wideband SPA.


debug cable

To enable debugging of the cable interface, use the debug cable command in privileged EXEC mode. To disable debugging output, use the no form of the command.

debug cable

no debug cable

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

11.3 XA

This command was introduced.


Usage Guidelines

This command enables debugging of the cable interfaces. To avoid excessive output that could interfere with router performance, you should limit debugging to a particular cable interface, using the debug cable interface command, before giving the debug cable command.

Examples

The following shows sample output from the debug cable bpiatp command:

Router# debug cable 
Router# debug cable interface c3/0 
CMTS interface debugging is on

Router#
Jun 25 08:36:37.339: cmts_helper_forward 00e0.a3b6.f0af no match

Jun 25 08:36:37.339: cmts_dhcp_glean: type=2 sid 0 IP=221.222.151.182 dhcp mac=0
Jun 25 08:36:40.339: cmts_helper_forward 00e0.a3b6.f0af no match

Jun 25 08:39:13.419: Failed to find CM with mac address 0006.28dc.37fd
Jun 25 08:39:13.419: Failed to find CM with mac address 00d0.bad3.c0cd
Jun 25 08:39:13.419: Failed to find CM with mac address 0003.e350.9cdb

Jun 25 08:39:40.527: Lookup failed - unable to find CM with SID 0

Jun 25 08:38:53.583: Lookup failed - unable to find CM with SID 0

Note The last message displayed above, "unable to find CM with SID 0," is typically generated by the show cable commands and can be ignored.


Related Commands

Command
Description

debug cable interface

Enables debugging on a specific cable interface.


debug cable admission-control

To enable automatic Admission Control troubleshooting processes on the Cisco CMTS, use the debug cable admission-control command in privileged EXEC mode. To disable debugging mode, use the no form of this command.

debug cable admission-control {cpu | memory | us-bandwidth | ds-bandwidth}

no debug cable admission-control

Syntax Description

cpu

Keyword displays CPU debugging information and processes.

memory

Keyword displays physical memory debugging information and processes.

us-bandwidth

Keyword displays upstream debugging information and processes.

ds-bandwidth

Keyword displays downstream debugging information and processes.


Command Default

Admission Control and Service Flow Admission Control debugging is disabled by default.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(13a)BC

This command was introduced on the Cisco uBR10012 and the Cisco uBR7246VXR router.

12.3(21)BC

This command continues on the Cisco uBR10012 router and the Cisco uBR7246VXR router to support the Service Flow Admission Control feature.


Usage Guidelines

Admission Control debugging processes have some impact to resources on the Cisco CMTS. Any one of the command options can be used for selective debugging and to minimize impact.

For additional Admission Control feature information, refer to the following document on Cisco.com:

Admission Control for the Cisco Cable Modem Termination System

For additional information for Service Flow Admission Control, commencing in Cisco IOS Release 12.3(21)BC, refer to the following document on Cisco.com:

Service Flow Admission Control for the Cisco Cable Modem Termination System

Examples

The following example illustrates CPU debugging with Admission Control:

Router# debug cable admission control cpu
*Sep 12 23:08:53.255: CPU admission control check succeeded 
*Sep 12 23:08:53.255: System admission control check succeeded
*Sep 12 23:08:53.255: CPU admission control check succeeded 
*Sep 12 23:08:53.255: System admission control check succeeded

The following example illustrates memory debugging with Admission Control:

Router# debug cable admission control memory
*Sep 12 23:08:53.255: CPU admission control check succeeded 
*Sep 12 23:08:53.255: System admission control check succeeded
*Sep 12 23:08:53.255: CPU admission control check succeeded 
*Sep 12 23:08:53.255: System admission control check succeeded

The following example illustrates event debugging with Admission Control:

Router# debug cable admission control event
*Sep 12 23:15:22.867: Entering admission control check on PRE and it's a cm-registration
*Sep 12 23:15:22.867: Admission control event check is TRUE 

The following example illustrates upstream throughput debugging with Admission Control:

Router# debug cable admission control us-bandwidth
Oct  8 23:29:11: Failed to allocate US bandwidth for CM 0007.0e01.9b45 in adding a new 
service entry

The following example illustrates downstream throughput debugging with Admission Control:

Router# debug cable admission control ds-bandwidth
Oct  8 23:29:11: Failed to allocate DS bandwidth for CM 0007.0e01.1db5 in adding a new 
service entry

Related Commands

Command
Description

cable admission-control

Configures the CPU and memory thresholds for the Cisco CMTS and supporting broadband processing engines (BPEs)

cable admission-control event

Configures and enables Admission Control event types on the Cisco CMTS.

cable admission-control ds-bandwidth

Configures Admission Control downstream bandwidth thresholds on the Cisco CMTS.

cable admission-control us-bandwidth

Configures Admission Control upstream bandwidth thresholds on the Cisco CMTS.

clear cable admission control counters

Clears all Admission Control resource counters on the Cisco CMTS.

show cable admission-control

Displays status information for running configuration, traffic metrics, and Admission Control events on the Cisco CMTS.


debug cable admission-control flow-categorization

To display service flow categorization results, enabled when a service flow is classified, use the debug cable admission-control flow categorization command in Privileged EXEC mode. This command displays the application by which it was categorized, along with which rule is matched. Use the no form of this command to disable this debugging.

debug cable admission-control flow-categorization

no debug cable admission-control flow-categorization

Command Default

Debugging for Service Flow Admission Control is disabled by default on the Cisco CMTS, through Cisco IOS Release 12.3(21a) enables this feature by default, with associated default functions.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(21)BC

This command was introduced for the Cisco uBR10012 router and the Cisco uBR7246VXR router.


Usage Guidelines

For additional information for Service Flow Admission Control, commencing in Cisco IOS Release 12.3(21)BC, refer to the following document on Cisco.com:

Service Flow Admission Control for the Cisco Cable Modem Termination System

Examples

Below is a shortened example of the information displayed when the debug cable admission-control flow-categorization command is enabled on the Cisco CMTS. This command displays interface-level information.

Router# debug cable admission-control flow-categorization

int ca 5/1/1 sfid 55 identified as video pcmm priority 6 matched.

Related Commands

Command
Description

cable admission-control ds-bandwidth

Sets minor, major and exclusive thresholds for downstream voice or data bandwidth for each or all interfaces on the Cisco CMTS

cable admission-control preempt priority-voice

Changes the default PacketCable Emergency 911 call preemption functions on the Cisco CMTS, supporting throughput and bandwidth requirements for Emergency 911 calls above all other buckets on the Cisco CMTS.

cable admission-control us-bandwidth

Configures global or interface-level upstream bandwidth thresholds and exclusive or non-exclusive resources on the Cisco CMTS.

cable application-type include

Associates an application type with a specific and prioritized bucket on the Cisco CMTS.

cable application-type name

Assigns an alpha-numeric name for the specified bucket.

cable admission-control us-bandwidth

Configures per-upstream bandwidth thresholds and exclusive or non-exclusive resources on the Cisco CMTS.

debug cable admission-control flow-categorization

Displays service flow categorization results, enabled when a service flow is classified.

show application-buckets

Displays rules for any or all buckets supporting Service Flow Admission Control on the Cisco CMTS.

show interface cable admission-control reservation

Displays service flows, categorizations, and bandwidth consumption on the Cisco CMTS, for the specified interface, and the specified service flow direction.


debug cable arp

To enable debugging of the Address Resolution Protocol (ARP) when it is used on the cable interface, use the debug cable arp command in privileged EXEC mode. To disable debugging output, use the no form of the command.

debug cable arp

no debug cable arp

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(11)BC3

This command was introduced.


Usage Guidelines

The debug commands are primarily intended for use in controlled test and troubleshooting situations with a limited volume of traffic. In particular, avoid using the debug cable arp command on an interface with a significant number of CMs, because the resulting volume of debug output could impact system performance. Cisco recommends that when you use the debug cable arp command, you limit its output to a particular interface or CM, using the debug cable interface or debug cable mac-address commands.

Examples

The following shows typical output for a particular cable modem using the debug cable arp command:

Router# debug cable arp 
CMTS arp debugging is on 

Router# debug cable mac-address 0020.4072.7418 

ARPGLEAN cmts glean idb Cable3/0 MAC 0020.4072.7418 SID 2 ipaddr 31.0.0.2 

Related Commands

Command
Description

debug cable dhcp

Enables debugging of the Dynamic Host Configuration Protocol on the cable interface.

debug cable encap

Enables debugging of encapsulated packets that are transmitted over the cable interface.

debug cable interface

Enables debugging on a specific cable interface.

debug cable mac-address

Enables debugging for a particular CM.


debug cable arp filter

To display debugging messages about the filtering of Address Resolution Protocol (ARP) broadcasts, use the debug cable arp filter command in privileged EXEC mode. To the debugging messages, use the no form of this command.

debug cable arp filter

no debug cable arp filter

Syntax Description

This command has no arguments or keywords.

Command Default

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(15)BC2

This command was introduced for the Cisco uBR7246VXR and Cisco uBR10012 universal broadband routers.


Usage Guidelines

If you suspect a particular CM is generating a large volume of ARP traffic, you can enable debugging for that particular CM using the debug cable arp command. If the ARP traffic is excessive, you can enable ARP filtering on the associated cable interface using the cable arp filter command. To show the results of that ARP filtering, use the debug cable arp filter command.


Tip Because this command can produce a large volume of debug information, it does not produce any output until you first limit debugging output to a particular Service ID (SID) or one or more particular CM MAC addresses, using the debug cable interface sid or debug cable mac-address commands, respectively.


Examples

The following example shows how to enable debugging messages for ARP filtering for a particular MAC address, and samples of the typical messages that can be displayed:

Router# debug cable mac-address 000C.0102.0304 
Router# debug cable arp filter 

CMTS arp filter debugging is ON 

Router# 

ARP Req Filter = T shdw 000C.0102.0304 sip 10.11.13.1 dhdw 00C0.0809.0A0B dip 
192.168.100.14 cnt 2
ARP Req Filter = T src_ip 10.11.13.1 dst_ip 192.168.100.14 

The following example shows how to enable debugging messages for ARP filtering for a particular SID on a cable interface:

Router# debug cable interface cable c5/0 sid 31 
Router# debug cable arp filter 

CMTS arp filter debugging is ON 

Router# 

Related Commands

Command
Description

cable arp

Activates cable Address Resolution Protocol (ARP).

cable arp filter

Controls the number of ARP packets that are allowable for each Service ID (SID) on a cable interface.

cable proxy-arp

Activates cable proxy ARP on the cable interface.

cable arp

Clears the ARP table on the router.

clear counters

Clears the packet counters on all interfaces or on a specific interface.

debug cable arp

Enables debugging of ARP traffic on a cable interface.

debug cable interface

Enables debugging for a particular Service ID (SID) on a specific cable interface.

debug cable mac-address

Enables debugging for a particular CM.

show cable arp-filter

Displays the total number of ARP replies and requests that have been sent and received, including the number of requests that have been filtered.


debug cable bpiatp

To enable debugging of the Baseline Privacy Interface (BPI) handler, use the debug cable bpiatp command in privileged EXEC mode. To disable debugging output, use the no form of the command.

debug cable bpiatp

no debug cable bpiatp

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

11.3 XA

This command was introduced.


Usage Guidelines

This command activates debugging of the BPI feature. When this command is activated, the Cisco CMTS displays debugging information for any BPI-related messages that the CMTS sends or receives.


Note This command is supported only on images that support BPI or BPI+ encryption.



Tip Debugging must be enabled for one or more cable interfaces, using the debug cable interface command, before the debug cable bpiatp command displays any output.


Examples

The following shows sample output from the debug cable bpiatp command:

Router# debug cable interface c3/0 
Router# debug cable bpiatp 

CMTS bpi_atp debugging is on
Router# 
 SID : 1         Latest : 2      Current : 1 
  Status[0] : 1  DES Key[0] : DBF08460BF8073B    DES IV[0]  : D8F26C81A2F01BC
  Key Life[0]: 392 sec
  Status[1] : 1  DES Key[1] : BEC1CAE02022349    DES IV[1]  : 198C1AB9255113DC
  Key Life[1]: 87 sec
  Req : 1        Rply : 1        Rej : 0 Inv : 0
  Upstream Pri SID : 1
   SID : 1  Even Key : D7C2230BF019D02   Even IV : D8F26C81A2F01BC
   SID : 1  Odd  Key : BD875702048A401   Odd IV : 198C1AB9255113DC
 SID : 2002      Latest : 2      Current : 1 
  Status[0] : 1  DES Key[0] : 237C029E0879190B   DES IV[0]  : 166B0B6207580457
  Key Life[0]: 219 sec
  Status[1] : 1  DES Key[1] : B8020021FDF1AB5    DES IV[1]  : 7A10B6E235E196E
  Key Life[1]: 69 sec
 CM List:
   0050.f112.3414
 IP List:
   224.0.1.3
  Req : 0        Rply : 0        Rej : 0 Inv : 0
  Upstream QoS SID : 0
   SID : 0  Even Key : FFFF0000FFFF0000  Even IV : FFFF0000FFFF0000
   SID : 0  Odd  Key : FFFF0000FFFF0000  Odd IV : FFFF0000FFFF0000

Related Commands

Command
Description

debug cable interface

Enables debugging on a specific cable interface.

debug cable keyman

Displays debugging information about BPI key management.

debug cable privacy

Displays debugging information whenever the BPI state changes or a BPI event occurs.


debug cable bundle

To enable debugging of the bundling of cable interfaces, use the debug cable bundle command in privileged EXEC mode. To disable debugging output, use the no form of the command.

debug cable bundle [pkt]

no debug cable bundle [pkt]

Syntax Description

pkt

(Optional) Displays detailed information about packets that are transmitted over the cable bundle.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(7)XR, 12.1(0)6SC, 12.1(2)EC1

This command was introduced.

12.1(3a)EC

Subinterface support was added.


Usage Guidelines

This command activates debugging for cable interfaces that are bundled together into a master/slave relationship, using the cable bundle command.


Note The debug cable bundle pkt command does not display information about multicast packets on the Cisco uBR10012 router. Use the show ip mroute count and show hardware pxf cpu mroute commands to display this information on the Cisco uBR10012 router.



Tip This command can generate a significant amount of output. To limit the debug output to a specific cable interface, use the debug cable interface command, before using the debug cable bundle command.


Examples

The following shows typical output from the debug cable bundle command for a particular cable interface:

Router# debug cable interface c3/0 
Router# debug cable bundle 

00:53:23: Sending multicast packet to bundle int Cable3/0
00:53:23: Unicast packet sent out bundle int Cable3/0 to 0003.e3fa.5e21
00:53:24: Sending multicast packet to bundle int Cable3/0
00:53:25: Sending multicast packet to bundle int Cable3/0
00:53:26: Sending multicast packet to bundle int Cable3/0

Router#

Related Commands

Command
Description

debug cable interface

Enables debugging on a specific cable interface.


debug cable classifiers

To display debugging messages for DOCSIS packet classifiers, use the debug cable classifiers command in privileged EXEC mode. To stop the display of debugging messages, use the no form of this command.

debug cable classifiers

no debug cable classifiers

Syntax Description

No additional keywords or syntax components are required.

Command Modes

Privileged EXEC mode

Command Default

DOCSIS packet classifier debugging is disabled by default.

Usage Guidelines

The debug cable classifiers command provides detailed information about the allocation, removal, activation and deactivation of packet classifiers. Generally, classifiers are used to identify IP packets by source port, destination port, or type of service. Classifiers are associated with service flows. For example, packet classifiers are dynamically created in most VOIP deployments and this debug command can be used to troubleshoot issues related to these classifiers as VOIP calls are created and torn down.

Because this command can produce a large volume of debug information, use this command only when you have also enabled debugging for a particular MAC address, set of MAC addresses, or a MAC address mask, using the debug cable mac-address command.

Examples

The following example enables classifier debugging for a single MAC address:

Router# debug cable mac-address 000a.73fa.dbaa
Router# debug cable classifiers
CMTS Packet Classifiers debugging is on

The following enables classifier debugging for all MAC addresses with Organizational Unique Identifier (OUI) OUI 0013.11:

Router# debug cable mac-addr 0013.1100.0000 ffff.ff00.0000
Routerv# debug cable classifiers                           
CMTS Packet Classifiers debugging is on

The following example illustrates sample output of the debug cable classifiers command for the given MAC addresses:

Feb  7 18:43:50.181: CFR cmts_deactivate_us_srv_flow_act_cfrs 000a.73fa.dbaa sid 1 sfid 3 st 2 dir 0 prov 1 adm 1 act 
1
Feb  7 18:43:50.181: CFR cmts_remove_cm_srv_flow_cfrs 000a.73fa.dbaa sid 1 sfid 3 st 2 dir 0 prov 1 adm 0 act 0
Feb  7 18:43:50.181: CFR cmts_deactivate_ds_srv_flow_act_cfrs 000a.73fa.dbaa sid 0 sfid 4 st 2 dir 1 prov 2 adm 2 act 
2
Feb  7 18:43:50.181: CFR cmts_remove_cm_srv_flow_cfrs 000a.73fa.dbaa sid 0 sfid 4 st 2 dir 1 prov 2 adm 0 act 0
Feb  7 18:43:50.181: CFR cmts_deactivate_us_srv_flow_act_cfrs 000a.73fa.dbaa sid 1 sfid 3 st 2 dir 0 prov 3 adm 0 act 
0
Feb  7 18:43:50.181: CFR cmts_deactivate_us_srv_flow_act_cfrs 000a.73fa.dbaa sid 1 sfid 3 st 1 dir 0 prov 3 adm 3 act 
0
Feb  7 18:43:50.181: CFR cmts_activate_us_srv_flow_act_cfrs 000a.73fa.dbaa sid 1 sfid 3 st 2 dir 0 prov 3 adm 3 act 3
Feb  7 18:43:50.181: CFR cmts_deactivate_ds_srv_flow_act_cfrs 000a.73fa.dbaa sid 0 sfid 4 st 2 dir 1 prov 4 adm 0 act 
0
Feb  7 18:43:50.181: CFR cmts_deactivate_ds_srv_flow_act_cfrs 000a.73fa.dbaa sid 0 sfid 4 st 1 dir 1 prov 4 adm 4 act 
0
Feb  7 18:43:50.181: CFR cmts_activate_ds_srv_flow_act_cfrs 000a.73fa.dbaa sid 0 sfid 4 st 2 dir 1 prov 4 adm 4 act 4
Feb  7 18:43:50.181: CFR cmts_set_cfr_params 000a.73fa.dbaa cfrid 1 pri 0 ord 0 dir 0 st 2 phsi 0
Feb  7 18:43:50.181: CFR cmts_activate_cfr 000a.73fa.dbaa cfrid 1 pri 1 ord 0 dir 0 st 2
Feb  7 18:43:50.181: CFR cmts_add_pkt_cfr 000a.73fa.dbaa cfrid 1 pri 1 ord 0 dir 0 st 1 phsi 0
Feb  7 18:43:50.181: CFR cmts_handle_cfr_parsed_data CFR_ADD 000a.73fa.dbaa sfid 0 action 0 dir 0 type 0 cfrid 0 pri 1 
ord 0 dir 0 st 1 phsi 0
Feb  7 18:43:50.181: CFR cmts_set_cfr_params 000a.73fa.dbaa cfrid 2 pri 0 ord 0 dir 1 st 2 phsi 0
Feb  7 18:43:50.181: CFR cmts_activate_cfr 000a.73fa.dbaa cfrid 2 pri 1 ord 0 dir 1 st 2
Feb  7 18:43:50.181: CFR cmts_add_pkt_cfr 000a.73fa.dbaa cfrid 2 pri 1 ord 1 dir 1 st 1 phsi 0
Feb  7 18:43:50.181: CFR cmts_handle_cfr_parsed_data CFR_ADD 000a.73fa.dbaa sfid 0 action 0 dir 1 typ

Related Commands

Command
Description

debug cable dynsrv

Displays information about DOCSIS 1.1 dynamic service flow messages.

debug cable qos

Activates quality-of-service (QoS) debugging.


debug cable config-file

To display information about the DOCSIS configuration files that CMTS generates internally, use the debug cable config-file command in the Privileged EXEC mode. To disable the debugging output, use the no form of this command.


Note This command applies to configuration files created using the internal DOCSIS configuration file editor and the "cable dynamic-secret" functionality.


debug cable config-file

no debug cable config-file

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.1(2)EC

This command was introduced for Cisco uBR7200 series routers.

12.1(5)EC

Support for this command was added for the Cisco uBR7100 series routers.

12.2(4)BC1

Support was added to the Release 12.2 BC.

12.2(11)BC2

Support for this command was added to the Release 12.2 BC.


Usage Guidelines

This command shows the DOCSIS configuration files debug messages that the Cisco CMTS generated internally. These configuration files may be generated with the internal configuration file editor using the cable config-file command and its subcommands, or through the "dynamic shared secret" functionality using the cable dynamic-secret command.


Caution The debug commands are primarily intended for use in controlled test and troubleshooting situations with a limited volume of traffic.

Examples

The following example enables debugging for the internally generated configuration files using the conditional and config-file debug command.

Enable conditional debugs using one of the following commands:

Router# debug cable mac-address 0000.aaaa.bbbb 

or

Router# debug cable interface cable 6/1/0 verbose

Enable the config-file debug using the following commands:

Router# debug cable config-file 

CMTS config file debugging is on

Router# show debug 
CMTS:
  CMTS config file debugging is on
CMTS specific:
  Debugging is on for Address 0000.aaaa.bbbb, Mask ffff.ffff.ffff
Router# 

When debugging is turned on and the Cisco CMTS internally generates a DOCSIS configuration file for transmission to a CM that matches the conditional debug, the CMTS displays the following message:

Server instance created for modem 001a.c3ff.e3f0. Local 3.0.0.1 Read request from CM 
001a.c3ff.e3f0 (3.0.0.119) File successfully downloaded to CM 001a.c3ff.e3f0

When debugging is turned on and a verbose keyword is used in the conditional debugs, the Cisco CMTS displays the following message:

Server instance created for modem 001a.c3ff.e3f0. Local 3.0.0.1
config: Searching download image for 001a.c3ff.e3f0: not found Generated tftp config file:
0x0000: 03 01 01 04 1F 01 01 01 02 04 05 F5 E1 00 03 04
0x0010: 05 F5 E1 00 04 01 00 05 04 00 00 00 00 06 02 07
0x0020: D0 07 01 01 11 2A 01 04 00 00 00 0A 02 04 00 00
0x0030: 00 0A 03 04 00 00 02 58 04 04 00 00 00 01 05 04
0x0040: 00 00 00 01 06 04 00 00 02 58 07 04 00 00 00 3C
0x0050: 12 01 0A 06 10 D8 CB DD 33 6A 2D 49 AE E1 EE DE
0x0060: 1D E5 90 4A 35 07 10 69 7B F1 67 8A 82 F0 74 F0
0x0070: 0D A1 89 B3 8D 9C F7 FF
Config file for 001a.c3ff.e3f0, Size 120 Read request from CM 001a.c3ff.e3f0 (3.0.0.119) 
TFTP Server: Sent OACK to CM 001a.c3ff.e3f0 TFTP Server: ACK from CM 001a.c3ff.e3f0 for 
block 0 Sending block 1, Size 120 to CM 001a.c3ff.e3f0 TFTP Server: ACK from CM 
001a.c3ff.e3f0 for block 1 File successfully downloaded to CM 001a.c3ff.e3f0


Note See the DOCSIS 1.1 specification (revision SP-RFIv1.1-I05-000714 and above) for a description of the fields that can appear in a DOCSIS configuration file.


Related Commands

cable config-file

Creates a DOCSIS configuration file and enters configuration file mode.

access-denied

Disables access to the network.

channel-id

Specifies upstream channel ID.

cpe max

Specifies the maximum number of CPE devices allowed access.

debug cable interface

Displays debug messages for a specific cable interface, or for traffic related to a specific MAC address or Service ID (SID) on that interface.

debug cable mac-address

Displays debug information for a specific CM.

download

Specifies the filename and server IP address for downloading a new software image.

frequency

Specifies the downstream frequency.

option

Specifies options for the configuration file that are not provided for by the other commands.

privacy

Specifies privacy options for baseline privacy images.

service-class

Specifies service class definitions for the configuration file.

snmp manager

Specifies Simple Network Management Protocol (SNMP) options.

time-stamp

Enables time-stamp generation.

show running-config

Displays the current run-time configuration, which includes defined configuration files.

show startup-config

Displays the current saved configuration, which includes defined and saved configuration files.


debug cable dcc

To display information about DOCSIS 1.1 Dynamic Channel Change (DCC) messages, use the debug cable dcc command in Privileged EXEC mode. To disable debugging output for DCC messages, use the no form of this command.

debug cable dcc

no debug cable dcc

Syntax Description

This command has no arguments or keywords.

Command Default

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(7)CX

This command was introduced for DOCSIS 1.1 operation.

12.2(4)BC1

Support was added to the Release 12.2 BC train.


Usage Guidelines

This command shows debugging messages about the DCC Request (DCC-REQ) message that the CMTS sends to the CM, and about the DCC Response (DCC-RSP) message that the CM sends in reply.


Caution The debug commands are primarily intended for use in controlled test and troubleshooting situations with a limited volume of traffic. In particular, avoid using the debug cable dcc command on an interface with a significant number of CMs, because the resulting volume of debug output could impact system performance. Cisco recommends that when you use the debug cable dcc command, you limit its output to a particular interface or CM, using the debug cable interface command.


Tip To display the contents of the DCC messages, enable TLV debugging with the debug cable tlvs command.



Note See the DOCSIS 1.1 specification (revision SP-RFIv1.1-I05-000714 and above) for information on the content and format of the DCC-REQ and DCC-RSP messages.


Examples

The following examples show typical output for the debug cable dcc command. The following example shows the debug output from a DCC-REQ message that instructs the CM to change its upstream channel to channel 1, using the default initialization technique (option 0, the CM is to reinitialize its MAC layer, requiring a complete reregistration):

Router# debug cable int c3/0 
Router# debug cable dcc 
CMTS DCC encodings debugging is on
Router# 
00:02:57: Found DCC TLV
00:02:57:       US Channel ID 1
00:02:57: received a DCC_RSP.  upstream = 1.

The following example shows the debug output from a DCC-REQ message that instructs the CM to change its upstream channel to channel 1, using initialization technique 4 (the CM is to continue its normal operations after synchronizing to the new channel).

0:04:29: Found DCC TLV
00:04:29:       US Channel ID 1
00:04:29: Found DCC TLV
00:04:29:       Init Tech 4
00:04:29: received a DCC_RSP.  upstream = 1.
00:04:29: CM new state = 15
00:04:30: DCC-RSP-NEW-TIMEOUT: CmMac->00ac.0000.0070 OrgId->32770
00:04:30: DCC-RSP-ARRIVE is lost.
00:04:30: received a DCC_RSP.  upstream = 0.
00:04:30: ERROR: Received DCC-RSP-ARRIVE w/o DCC-REQ.
00:04:30: DCC-ACK Message Contents:
00:04:30: 0x0000: C2 00 00 1A 00 00 00 30 EB 15 2E 97 00 AC 00 00 
00:04:30: 0x0010: 00 70 00 08 00 00 03 02 19 00 80 02 
00:04:30: DCC-ACK-SENT: CM->0030.eb15.2e97 TranscId->32770

The following example shows the debug output from a DCC-REQ message that instructs the CM to change its upstream channel to channel 2, using initialization technique 4, and substituting a new service flow ID (SFID) of 160 for the current SFID of 14.

00:05:19: Found DCC TLV
 00:05:19:       US Channel ID 2
 00:05:19: Found DCC TLV
 00:05:19:       Init Tech 4
 00:05:19: Found DCC TLV
 00:05:19:       SFID Substitute old 14 new 160
 00:05:19: received a DCC_RSP.  upstream = 0.
 00:05:19: CM new state = 15
 00:05:20: DCC-RSP-NEW-TIMEOUT: CmMac->00ac.0000.0070 OrgId->32771
 00:05:20: DCC-RSP-ARRIVE is lost.
 00:05:20: received a DCC_RSP.  upstream = 1.
 00:05:20: ERROR: Received DCC-RSP-ARRIVE w/o DCC-REQ.
 00:05:20: DCC-ACK Message Contents:
 00:05:20: 0x0000: C2 00 00 1A 00 00 00 30 EB 15 2E 97 00 AC 00 00 
 00:05:20: 0x0010: 00 70 00 08 00 00 03 02 19 00 80 03 
 00:05:20: DCC-ACK-SENT: CM->0030.eb15.2e97 TranscId->32771

The following example shows the debug output from a DCC-REQ message that specifies an upstream channel with a frequency that is not a multiple of 62,500 Hz, which is required by the DOCSIS specification:

00:07:28: Found DCC TLV
 00:07:28:       US Channel ID 2
 00:07:28: Found DCC TLV
 00:07:28:       Init Tech 4
 00:07:28: Found DCC TLV
 00:07:28:       ERROR: DS frequency not a multiple of 62500Hz. 
 00:07:28: Not able to parse the TLVs.

Related Commands

debug cable tlvs

Displays debugging messages about the TLV values used for service flow encodings, classifier encodings, and PHS rules.


debug cable dci

To display information about DOCSIS 1.1 Device Class Identification (DCI) messages, use the debug cable dci command in privileged EXEC mode. To disable debugging output for DCI messages, use the no form of this command.

debug cable dci

no debug cable dci

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(4)CX

This command was introduced for DOCSIS 1.1 operation.

12.2(4)BC1

Support was added to the Release 12.2 BC train.


Usage Guidelines

This command shows debugging messages about the DCI-REQ messages that the Cisco CMTS receives from CMs.


Note See the DOCSIS 1.1 specification (revision SP-RFIv1.1-I05-000714 and above) for additional information on the DCI-REQ, DCI-RSP, and Upstream Transmitter Disable (UP-DIS) messages.


Examples

The following example shows typical output displayed by the debug cable dci command:

Router# debug cable interface c3/0 
Router# debug cable dci 
CMTS dci debugging is on
Router# 
DCI-REQ: CM->1234.5678.abcd SID->1 
Device Class 1st half->0000000000000000 Device Class 2nd half->0000000000000001

Related Commands

cable dci-response

Configures how a cable interface responds to DCI-REQ messages coming from CMs on that interface.

cable dci-upstream-disable

Configures the cable interface so that it sends an Upstream Transmitter Disable (UP-DIS) message in response to a DCI-REQ message from a particular CM.


debug cable dhcp

To enable debugging of the Dynamic Host Configuration Protocol (DHCP) when it is used on the cable interface, use the debug cable dhcp command in privileged EXEC mode. To disable debugging output, use the no form of the command.

debug cable dhcp

no debug cable dhcp

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(11)BC3

This command was introduced.


Usage Guidelines

The debug commands are primarily intended for use in controlled test and troubleshooting situations with a limited volume of traffic. In particular, avoid using the debug cable dhcp command on an interface with a significant number of CMs, because the resulting volume of debug output could impact system performance. Cisco recommends that when you use the debug cable dhcp command, you limit its output to a particular interface or CM, using the debug cable interface or debug cable mac-address commands.

Examples

The following shows typical debugging messages for the debug cable dhcp command for a particular cable modem that is acquiring a DHCP address:

Router# debug cable dhcp 
CMTS dhcp debugging is on 

Router# debug cable mac-address 0020.4072.7418 
Router# clear cable modem 0020.4072.7418 reset 
Router# 
DHCPINFO hwidb Cable3/1 MAC 0020.4072.7418 SID 2 dhcp_op 1
DHCPINFO wan info circuit 80010006 remote_system_id 0020.4072.7418 remote_device_class 0
DHCP cmts_helper_forward idb Cable3/1.1 client 0020.4072.7418 31.1.1.1
DHCPGLEAN input idb Cable3/1.1 MAC 0020.4072.7418 type 1
DHCPGLEAN hwidb Cable3/1 found for MAC 0020.4072.7418
DHCPGLEAN cmts glean hwidb Cable3/0 mac 0020.4072.7418 sid 2 ipaddr 0.0.0.0
DHCPGLEAN input idb Cable3/1.1 MAC 0020.4072.7418 type 2
DHCPGLEAN hwidb Cable3/1 found for MAC 0020.4072.7418
DHCPGLEAN SID 2 MAC 0020.4072.7418 on Cable3/0 mapped to swidb Cable3/1.1 ipaddr 31.0.0.2
DHCPINFO hwidb Cable3/1 MAC 0020.4072.7418 SID 2 dhcp_op 1
DHCPINFO wan info circuit 80010006 remote_system_id 0020.4072.7418 remote_device_class 0
DHCP cmts_helper_forward idb Cable3/1.1 client 0020.4072.7418 31.1.1.1 Host
DHCPGLEAN input idb Cable3/1.1 MAC 0020.4072.7418 type 3
DHCPGLEAN hwidb Cable3/1 found for MAC 0020.4072.7418
DHCPGLEAN cmts glean hwidb Cable3/0 mac 0020.4072.7418 sid 2 ipaddr 0.0.0.0
DHCPGLEAN input idb Cable3/1.1 MAC 0020.4072.7418 type 5
DHCPGLEAN hwidb Cable3/1 found for MAC 0020.4072.7418
DHCPGLEAN cmts glean hwidb Cable3/0 mac 0020.4072.7418 sid 0 ipaddr 31.0.0.2
DHCPGLEAN SID 2 MAC 0020.4072.7418 on Cable3/0 mapped to swidb Cable3/1.1 ipaddr 31.0.0.2 

Related Commands

Command
Description

debug cable arp

Enables debugging of the Address Resolution Protocol on the cable interface.

debug cable encap

Enables debugging of encapsulated PPPoE packets that are transmitted over the cable interface.

debug cable interface

Enables debugging on a specific cable interface.

debug cable mac-address

Enables debugging for a particular CM.


debug cable dsg

To enable general, Downstream Channel Descriptor (DCD), or packet-related debugging for Advanced-mode DOCSIS Set-Top Gateway (A-DSG) on a Cisco CMTS router, use the debug cable dsg command in privileged EXEC mode. To disable A-DSG debugging, us the no form of this command.

debug cable dsg [dcd | pkt]

no debug cable dsg

Syntax Description

dcd

(Optional) Enables DCD-related debugging. Can be combined with pkt.

pkt

(Optional) Enables packet-related debugging. Can be combined with dcd.


Command Default

A-DSG debugging is disabled by default.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(15)BC2

This command was introduced for the Cisco uBR7100 series and Cisco uBR7246VXR routers.

12.3(9a)BC

This command was introduced for the Cisco uBR10012 router.

12.3(13a)BC

This command was modified to begin support of A-DSG on the Cisco uBR10012 router and Cisco uBR7200 series routers. The dcd and pkt keyword options were added.


Usage Guidelines

Because this command can produce a large volume of information, use this command only when you have also enabled debugging for a particular interface or MAC address, using the debug cable interface and debug cable mac-address commands, respectively.

Examples

When you use the debug cable dsg dcd command, it shows DCD counters. If the configuration is changed, the whole DCD message content is displayed, including the MAC header. This display is derived from running information. The following sample illustrates one example:

Router# debug cable dsg dcd
23:30:45: Constructing DCD for Cable4/1
23:30:45: Cable4/1 DCD change_count 9
23:30:45: Cable4/1 DCD datagram size 626, msg len 624, ehdr type_or_len 606, 
tlv size 597
23:30:45: Cable4/1 84485 DCD msg sent, 9 change count increased, 0 fails

23:30:46: Constructing DCD for Cable4/1
23:30:46: Cable4/1 DCD change_count 9
23:30:46: Cable4/1 DCD datagramsize 626, msg len 624, ehdr type_or_len 606, 
tlv size 597
23:30:46: Cable4/1 84486 DCD msg sent, 9 change count increased, 0 fails

23:31:27: DSG VSIF group id 1, vendor index 1, sense 1

23:31:27: vendor 1 value len 1

23:31:27: Cable4/1 DCD is config dirty.

23:30:47: DSG VSIF group id 1, vendor index 1, sense 1

23:30:47: vendor 1 value len 1

23:30:47: Cable4/1 DCD is config dirty.

23:30:47: Constructing DCD for Cable4/1
23:30:47: client list 1 tlv length 2, clnts_tlv_size 4
23:30:47: Rule 1 all cfr IDs tlv size 4
23:30:47: Rule 1 VSIF tlv size = 36
23:30:47: Encode Cable4/1 rule 1 with tunnel 1,tlv size 60
23:30:47: client list 2 tlv length 4, clnts_tlv_size 6
23:30:47: Rule 2 all cfr IDs tlv size 4
23:30:47: Encode Cable4/1 rule 2 with tunnel 2,tlv size 26
23:30:47: client list 3 tlv length 4, clnts_tlv_size 6
23:30:47: Rule 3 all cfr IDs tlv size 4
23:30:47: Encode Cable4/1 rule 3 with tunnel 3,tlv size 26
23:30:47: client list 4 tlv length 4, clnts_tlv_size 6
23:30:47: Rule 4 all cfr IDs tlv size 4
23:30:47: Encode Cable4/1 rule 4 with tunnel 4,tlv size 26
23:30:47: client list 5 tlv length 4, clnts_tlv_size 6
23:30:47: Rule 5 all cfr IDs tlv size 4
23:30:47: Encode Cable4/1 rule 5 with tunnel 5,tlv size 26
23:30:47: client list 6 tlv length 4, clnts_tlv_size 6
23:30:47: Rule 6 all cfr IDs tlv size 4
23:30:47: Encode Cable4/1 rule 6 with tunnel 6,tlv size 26
23:30:47: client list 7 tlv length 4, clnts_tlv_size 6
23:30:47: Rule 7 all cfr IDs tlv size 4
23:30:47: Encode Cable4/1 rule 7 with tunnel 7,tlv size 26
23:30:47: client list 8 tlv length 4, clnts_tlv_size 6
23:30:47: Rule 8 all cfr IDs tlv size 4
23:30:47: Encode Cable4/1 rule 8 with tunnel 8,tlv size 26
23:30:47: client list 9 tlv length 4, clnts_tlv_size 6
23:30:47: Rule 9 all cfr IDs tlv size 4
23:30:47: Encode Cable4/1 rule 9 with tunnel 9,tlv size 26
23:30:47: client list 10 tlv length 4, clnts_tlv_size 6
23:30:47: Rule 10 all cfr IDs tlv size 4
23:30:47: Encode Cable4/1 rule 10 with tunnel 10,tlv size 26
23:30:47: client list 11 tlv length 8, clnts_tlv_size 10
23:30:47: Rule 11 all cfr IDs tlv size 4
23:30:47: Encode Cable4/1 rule 11 with tunnel 11,tlv size 30
23:30:47: Cable4/1 TLV size for all rules 324
23:30:47: Encode Cable4/1 cfr 1, tlv size 17
23:30:47: Encode Cable4/1 cfr 2, tlv size 17
23:30:47: Encode Cable4/1 cfr 3, tlv size 17
23:30:47: Encode Cable4/1 cfr 4, tlv size 17
23:30:47: Encode Cable4/1 cfr 5, tlv size 17
23:30:47: Encode Cable4/1 cfr 6, tlv size 17
23:30:47: Encode Cable4/1 cfr 7, tlv size 25
23:30:47: Encode Cable4/1 cfr 8, tlv size 17
23:30:47: Encode Cable4/1 cfr 9, tlv size 17
23:30:47: Encode Cable4/1 cfr 10, tlv size 17
23:30:47: Encode Cable4/1 cfr 11, tlv size 17
23:30:47: Cable4/1 DSG Addr Table tlv size = 519
23:30:47: Cable4/1 downstream VSIF tlv size = 36
23:30:47: Cable4/1 clnt cfg tlv size = 38
23:30:47: Cable4/1 DCD change_count 10
23:30:47: Cable4/1 DCD datagramsize 586, msg len 584, ehdr type_or_len 566, 
tlv size 557
23:30:47: Cable4/1 DCD msg 0x62463F8C, size=586
C2000248 000001E0 2F000001 000C31F6 F4710236 00000303 20000A01 01323A01
01010201 01040201 00050601 005E0101 14060200 012B0608 03ABCABC AB2B1A08
03000DF9 0A043030 30310B0D 45363031 30313238 3A303532 32321801 01020201
01040403 02095105 0601005E 01011E06 02000232 18010103 02010104 04040200
01050601 005E0101 28060200 03321801 01040201 01040403 02070105 0601005E
01013206 02000432 18010105 02010104 04040200 02050601 005E0101 3C060200
05321801 01060201 01040403 02000605 0601005E 01014606 02000632 18010107
02010104 04040200 03050601 005E0101 50060200 07321801 01080201 01040404
02000405 0601005E 01011906 02000832 18010109 02010104 04040200 05050601
005E0101 33060200 09321801 010A0201 01040404 02000605 0601005E 01014706
02000A32 1C01010B 02010104 08020600 504D0000 01050600 504D0000 01060200
0B170F02 02000105 01010906 0504E601 0114170F 02020002 05010109 060504E6
01011E17 0F020200 03050101 09060504 E6010128 170F0202 00040501 01090605
04E60101 32170F02 02000505 01010906 0504E601 013C170F 02020006 05010109
060504E6 01014617 17020200 07050101 090E0504 E6010150 090203E8 0A021388
170F0202 00080501 01090605 04E60101 19170F02 02000905 01010906 0504E601

23:30:45: DSG VSIF group id 1, vendor index 1, sense 1

23:30:45: vendor 1 value len 1
0133170F 0202000A 05010109 060504E6 01014717 0F020200 0B050101 09060504
E0191986 33242B06 0803ABCA BCAB2B1A 0803000D F90A0430 3030310B 0D453630
31303132 383A3035 3232

23:30:47: Cable4/1 84487 DCD msg sent, 10 change count increased, 0 fails

23:30:48: Constructing DCD for Cable4/1
23:30:48: Cable4/1 DCD change_count 10
23:30:48: Cable4/1 DCD datagramsize 586, msg len 584, ehdr type_or_len 566, 
tlv size 557
23:30:48: Cable4/1 84488 DCD msg sent, 10

Related Commands

Command
Description

show cable dsg tunnel

Displays information about A-DSG tunnel configuration on a Cisco CMTS router.

show interface

Displays general interface information for the specified or all interfaces.

show interface cable dsg downstream

Displays interface configuration and status information for A-DSG downstreams on a Cisco CMTS router.


debug cable dynamic-secret

To display debugging messages for the Dynamic Shared Secret feature, use the debug cable dynamic-secret command in privileged EXEC mode. To stop the display of debugging messages, use the no form of this command.

debug cable dynamic-secret

no debug cable dynamic-secret

Syntax Description

This command has no arguments or keywords.

Command Default

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(15)BC1

This command was introduced for Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 routers.


Usage Guidelines


Tip Because this command can produce a large volume of debug information, use this command only when you have also enabled debugging for a particular interface or MAC address, using the debug cable interface and debug cable mac-address commands, respectively.


Examples

The following example shows how to enable debugging output using the debug cable dynamic-secret command:

Router# debug cable dynamic-secret 

CMTS dynamic-secret debugging is on 

Router# 

The following example shows typical output for a cable modem that is reset and reregisters while the Dynamic Shared Secret feature is enabled:

02:15:59: Closing file for modem 00c0.2345.6789: New modem state from resetting to offline
02:16:10: Found file name in BOOT_FILE option
02:16:10: Parsing IP address from 10.10.35.200, len 10..  Got 10.10.35.200
Setting 10 bytes to PAD

02:16:10: Config file for 00c0.2345.6789 set to 10.8.35.200:/cm/UBsgvca698. Was 
10.10.35.200:/cm/config.cm
02:16:10: Discarding contents of /cm/config.cm @ 10.10.35.200
02:16:10: FIle /cm/config.cm from 10.10.35.200 read successfully
02:16:10: Found file name in BOOT_FILE option
02:16:10: Parsing IP address from 10.10.35.200, len 10..  Got 10.10.35.200
Setting 10 bytes to PAD

02:16:10: Config file for 00c0.2345.6789 set to 10.10.35.200:/cm/wrkldJKDHS. Was 
10.10.35.200:/cm/config.cm
02:16:15: Registration request from 00c0.2345.6789, SID 1 on Cable3/0/U0
02:16:15: TLV-Block Bytes:
02:16:15: 0x0000: 03 01 01 04 1F 01 01 01 02 04 00 3D 09 00 03 04 
02:16:15: 0x0010: 00 01 F4 00 04 01 07 05 04 00 01 86 A0 06 02 00 
02:16:15: 0x0020: 00 07 01 00 12 01 0A 06 10 97 C2 BA 04 6A 76 BD 
02:16:15: 0x0030: AC 40 FA E6 EB CD 49 E9 54 07 10 89 86 20 E2 73 
02:16:15: 0x0040: 16 EE 01 0B 24 4A 65 F8 55 93 90 0C 04 03 12 01 
02:16:15: 0x0050: 09 08 03 00 06 28 05 1E 02 01 01 03 01 01 04 01 
02:16:15: 0x0060: 01 06 01 01 07 01 00 08 01 04 0A 01 01 0B 01 08 
02:16:15: 0x0070: 0C 01 01 01 01 01 
02:16:15: Found Network Access TLV
02:16:15: Ntw Access Control : 1
02:16:15: Found Class Of Service TLV Block
02:16:15:       Class Id : 1
02:16:15:       Maximum Downstream Rate : 4000000
02:16:15:       Maximum Upstream Rate : 128000
02:16:15:       Upstream Traffic Priority : 7
02:16:15:       Guaranteed Minimum Upstream Rate : 100000
02:16:15:       Maximum Upstream Transmit Burst : 0
02:16:15:       Privacy Enable : 0
02:16:15: Found Max CPEs TLV
02:16:15: Maximum Number Of CPEs : 10
02:16:15: Found CM-MIC TLV
02:16:15: CM MIC:
02:16:15: 0x0000: 97 C2 BA 04 6A 76 BD AC 40 FA E6 EB CD 49 E9 54 
02:16:15: Found CMTS-MIC TLV
02:16:15: CMTS MIC:
02:16:15: 0x0000: 89 86 20 E2 73 16 EE 01 0B 24 4A 65 F8 55 93 90 
02:16:15: Found CM IP Address TLV
02:16:15: Modem IP Address : 10.18.1.9
02:16:15: Vendor Id:
02:16:15: 0x0000: 00 06 28 
02:16:15: Found Modem Capabilities TLV
02:16:15:       DOCSIS Version : 1
02:16:15:       Fragmentation Support : 1
02:16:15:       Payload Header Suppresion Support : 1
02:16:15:       Privacy Support : 1
02:16:15:       Downstream SAID Support : 0
02:16:15:       Upstream SID Support : 4
02:16:15:       Tx Equalizer Taps Per Symbol : 1
02:16:15:       Tx Equalizer Taps Support : 8
02:16:15:       DCC Support : 1
02:16:15:       Concatenation Support : 1
02:16:15: Computing CMTS-MIC using Dynamic Secret to validate REG-REQ data.
02:16:15: CMTS_MIC(rfc2104) failed text + key
02:16:15: CMTS_MIC(rfc2104) passed
02:16:15: Performing admission control check
02:16:15: Mapping Primary DOCSIS 1.0 CoS block into service flows
02:16:15: Added Modem Capabilities TLV:
02:16:15: 0x0000: 05 1E 02 01 01 03 01 01 04 01 01 06 01 01 07 01 
02:16:15: 0x0010: 00 08 01 04 0A 01 01 0B 01 08 0C 01 01 01 01 01 
02:16:15: ClassId:1 assigned SID:1
02:16:15: Added Service Class Data TLV:
02:16:15: 0x0000: 01 07 01 01 01 02 02 00 01 
02:16:15: REG-RSP Status : ok (0)
02:16:15: Closing file for modem 00c0.2345.6789: New modem state from init(o) to online
02:16:15: Registration Response Transmitted

Router#

The following example shows the typical messages that are shown when you use the clear cable modem lock command to clear the lock on one or more cable modems that have failed the Dynamic Shared Secret checks and were locked into restrictive quality of service (QoS) configurations:

Router# clear cable modem all lock 

01:46:37: Closing file for modem 00c0.2854.73f5: New modem state from online to offline
01:46:37: Closing file for modem 00c0.734e.b4aa: New modem state from online(pt) to 
offline
01:46:37: Closing file for modem 00c0.7366.17cb: New modem state from init(d) to offline
01:46:37: Closing file for modem 00c0.80bc.22b5: New modem state from online to offline

Router#

The following debug message is displayed when the CMTS has verified the CMTS MIC in a Data-over-Cable Service Interface Specifications (DOCSIS) configuration file against the shared secret that is configured on a cable interface:

Validated against Shared secret

The CMTS displays the following debug message when the CMTS has verified the CMTS MIC in a DOCSIS configuration file against one of the 16 possible secondary shared secrets that are configured on a cable interface:

Validated against secondary secret 11

The CMTS displays the following debug message when the CMTS obtains a new DOCSIS configuration file from the TFTP server. The CMTS keeps this file in its internal cache for 30 seconds, so that it can be used for other cable modems that might request it.

Creating new cache for config-file.cm @ 10.10.10.21 

The CMTS displays the following debug messages when it receives a registration request or TFTP request for a DOCSIS configuration file from a device that is not a cable modem. This can indicate that a user is trying to manually download a DOCSIS configuration file so that it can be decoded and modified.

MAC address 0102.0304.0506 not of a CM 
MAC Address 0102.0304.0506, IP address 10.10.10.13 is not a modem 

The CMTS displays the following debug message when it receives a TFTP request for an unknown TFTP server. This can indicate that a user is trying to download a DOCSIS configuration file from a local TFTP server.

TFTP server unknown for CM 0102.0304.0506

The CMTS displays the following debug message when it receives a TFTP request for a non-cable interface. This can indicate that a user is trying to spoof an IP or Ethernet MAC address, and is trying to access a TFTP server through the Internet or a local network.

TFTP request from a non-cable interface GE1/0/0 ignored

The CMTS displays the following debug messages when it receives a TFTP request for a DOCSIS configuration file that is not available on the TFTP server:

16:11:33: Could not locate bootfile name for 0102.0304.0506 
16:11:33: Cannot locate config-file.cm requested by CM 0102.0304.0506
16:11:33: Closing file for modem 0102.0304.0506: New modem state from init(rc) to offline 

Related Commands

Command
Description

cable dynamic-secret

Enables the Dynamic Shared Secret feature, so that DOCSIS configuration files are verified with a Message Integrity Check (MIC) that has been created with a dynamically generated shared secret.

cable shared-secondary-secret

Configures one or more secondary shared secret keys that CMs can use to successfully process the DOCSIS configuration file and register with the CMTS.

cable shared-secret

Configures an authentication shared secret key that CMs must use to successfully process the DOCSIS configuration file and register with the CMTS.

cable tftp-enforce

Requires that all CMs on a cable interface attempt to download a DOCSIS configuration file using the Trivial File Transfer Protocol (TFTP) through the cable interface before being allowed to register and come online.

show cable modem rogue

Displays a list of cable modems that have been marked, locked, or rejected because they failed the dynamic shared-secret authentication checks.

debug cable interface

Enables debugging output for a specific cable interface.

debug cable mac-address

Enables debugging output for the cable modems that match the specified hardware (MAC) address or range of addresses.


debug cable dynsrv

To display information about DOCSIS 1.1 dynamic service flow messages, use the debug cable dynsrv command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug cable dynsrv

no debug cable dynsrv

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(7)XR and 12.1(1a)T1

This command was introduced for DOCSIS 1.0+ operation.

12.1(4)CX

This command was enhanced for DOCSIS 1.1 operation.

12.2(4)BC1

Support was added to the Release 12.2 BC train.


Usage Guidelines

This command activates dynamic service flow debugging, which displays a debugging message whenever one of the following DOCSIS 1.1 dynamic service messages is processed:

Dynamic Service Add (DSA)—This message is used to create a new service flow.

Dynamic Service Change (DSC)—This message is used to change the attributes of an existing service flow.

Dynamic Service Deletion (DSD)—This message is used to delete an existing service flow.

Each type of dynamic service message includes a request (DSA-REQ, DSC-REQ, DSD-REQ) and a response (DSA-RSP, DSC-RSP, DSD-RSP).

Do not use this command when you have a large number of active CMs on your network, because it could generate a huge amount of output to the console port.


Note Debugging must be enabled for one or more cable interfaces, using the debug cable interface command, before the debug cable dynsrv command will display any output.



Tip If using the debug cable dynsrv command, also use the debug cable mac-address and the debug cable tlvs command to enable full DOCSIS MAC-layer debugging.


Examples

The following example shows typical output displayed by the debug cable dynsrv command:

Router# debug cable interface c3/0 
Router# debug cable dynsrv 
CMTS dynsrv debugging is on
Router# 
     *May 5 05:15:36.531: DSA-REQ-RECD: OrgMac->0050.734e.b5b1 OrgId->52 
     *May 5 05:15:36.531: DSx-STATE-CREATED: OrgMac->0050.734e.b5b1 OrgId->52 
     *May 5 05:15:36.531: DSA-REQ TLV Information: 
     *May 5 05:15:36.531: Type Subtype Subtype Length Value 
     *May 5 05:15:36.531: 24 10 
     *May 5 05:15:36.531: 19 2 89 
     *May 5 05:15:36.531: 20 4 20000 
     *May 5 05:15:36.531: 80 69 
     *May 5 05:15:36.531: DSA-REQ: Requested QoS Parameter Information: 
     *May 5 05:15:36.531: Srv Flow Ref: 0 Grant Size: 89 Grant Intvl: 20000 
     *May 5 05:15:36.531: Requested QoS parameters match QoS Profile:3 (G729) 
     *May 5 05:15:36.531: DSA-REQ-SID-ASSIGNED: CM 0050.734e.b5b1 SID 11 
     *May 5 05:15:36.531: DSA-RSP-SEND: OrgMac->0050.734e.b5b1 OrgId->52 
     *May 5 05:15:36.531: DSA-RSP msg TLVs 
     *May 5 05:15:36.531: Type:Length:Value 
     *May 5 05:15:36.531: US QoS Encodings 24:8 
     *May 5 05:15:36.531: SID 3:2:11 
     *May 5 05:15:36.531: Service Flow Reference 1:2:0 
     *May 5 05:15:36.531: DSA-RSP hex dump: 
     *May 5 05:15:36.531: 0x0000: C2 00 00 26 00 00 00 50 73 4E B5 B1 00 10 0B AF    
     *May 5 05:15:36.531: 0x0010: BC 54 00 14 00 00 03 01 10 00 00 34 00 18 08 03    
     *May 5 05:15:36.531: 0x0020: 02 00 0B 01 02 00 00 00 

Related Commands

Command
Description

debug cable interface

Enables debugging on a specific cable interface.

debug cable mac-address

Enables debugging for MAC-layer information for a specific CM.

debug cable tlvs

Enables debugging for the Type/Length/Value encodings (TLVs) parsed by the DOCSIS 1.1 TLV parser/encoder.


debug cable encap

To enable debugging of encapsulated packets that are transmitted over the cable interface, use the debug cable encap command in privileged EXEC mode. To disable debugging output, use the no form of the command.

debug cable encap

no debug cable encap

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(11)BC3

This command was introduced.


Usage Guidelines

The debug cable encap command displays debugging messages about the following types of encapsulated packets:

Debug messages prefixed with ENCAPSTR display information about CEF adjacency operations.

Debug messages prefixed with VENCAP display information about MAC-layer encapsulation for switched packets (such as PPPoE and IP packets).

The debug commands are primarily intended for use in controlled test and troubleshooting situations with a limited volume of traffic. In particular, avoid using the debug cable encap command on an interface with a significant number of CMs, because the resulting volume of debug output could impact system performance. Cisco recommends that when you use the debug cable encap command, you limit its output to a particular interface or CM, using the debug cable interface or debug cable mac-address commands.

Examples

The following shows typical output for the debug cable encap command. Messages are shown for both CEF adjacency and MAC-layer encapsulation events:

Router# debug cable encap 
CMTS encap debugging is on 

Router# clear adjacency 

ENCAPSTR hwidb Cable3/1 idb Cable3/1.1 mac 0020.4072.7418 ipaddr 31.0.0.2 linktype 7
ENCAPSTR 0020.4072.7418 SID 2 STR 00000000800200204072741800D0582770540800

Router# ping 31.0.0.2 

Type escape sequence to abort.
Sending 5, 100-byte ICMP Echos to 31.0.0.2, timeout is 2 seconds:
!!!!!
Success rate is 100 percent (5/5), round-trip min/avg/max = 4/5/8 ms

Router# 

VENCAP hwidb Cable3/0 idb Cable3/1.1 mac 0020.4072.7418 ip 31.0.0.2 linktype 7
VENCAP  0020.4072.7418 SID 2 STR 00000076800200204072741800D0582770540800

VENCAP hwidb Cable3/0 idb Cable3/1.1 mac 0020.4072.7418 ip 31.0.0.2 linktype 7
VENCAP  0020.4072.7418 SID 2 STR 00000076800200204072741800D0582770540800

VENCAP hwidb Cable3/0 idb Cable3/1.1 mac 0020.4072.7418 ip 31.0.0.2 linktype 7
VENCAP  0020.4072.7418 SID 2 STR 00000076800200204072741800D0582770540800

VENCAP hwidb Cable3/0 idb Cable3/1.1 mac 0020.4072.7418 ip 31.0.0.2 linktype 7
VENCAP  0020.4072.7418 SID 2 STR 00000076800200204072741800D0582770540800

VENCAP hwidb Cable3/0 idb Cable3/1.1 mac 0020.4072.7418 ip 31.0.0.2 linktype 7
VENCAP  0020.4072.7418 SID 2 STR 00000076800200204072741800D0582770540800

Related Commands

Command
Description

debug cable arp

Enables debugging of the Address Resolution Protocol on the cable interface.

debug cable dhcp

Enables debugging of the Dynamic Host Configuration Protocol on the cable interface.

debug cable interface

Enables debugging on a specific cable interface.

debug cable mac-address

Enables debugging for a particular CM.


debug cable envm

To display information about the Cisco CMTS physical environment, including internal temperature, midplane voltages, fan performance, and power supply voltages, use the debug cable env command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug cable envm

no debug cable envm

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

11.3NA

This command was introduced.


Usage Guidelines

This command is used to debug the sensor circuitry used to measure internal temperature, midplane voltages, fan performance, and power supply voltages on the Cisco CMTS console.

Examples

The following example shows sample output displayed by the debug cable envm command

Router# debug cable envm 
ENVM: ps id=0xFF0, v=0x2050, r=0xC0AB, pstype=1
ENVM: ps id=0x2FD0, v=0x2050, r=0x24201, pstype=27
NVM: Sensor 0: a2dref=131, a2dact=31, vref=12219, vact=1552 Alpha=8990, temp=27

Table 190 provides description for the output.

Table 190 Sample Output for the debug cable envm Command 

Field
Description

ps id

Power supply raw voltage reading.

pstype

Power supply type determined from ps ID, v, and r. If the Cisco CMTS contains dual power supplies, the ID information for two types is usually printed.

Sensor

Sensor number.

a2dref

Analog-to-digital converter reference reading.

a2dact

Analog-to-digital converter actual (measured reading).

vref

Reference voltage.

vact

Actual voltage.

Alpha

Raw temperature reading.

temp

Temperature corresponding to Alpha.


Related Commands

Command
Description

show environment

Displays the temperature and voltage information for the chassis.


debug cable error

To display errors that occur in the cable MAC protocols, use the debug cable err command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug cable error

no debug cable error

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

11.3NA

This command was introduced.


Usage Guidelines

This command displays unexpected DOCSIS MAC protocol messages. When the Cisco CMTS does not to expect to receive a specific MAC message, or if a packet contains errors in size or content, an error message and a hex dump of the packet are printed. Other miscellaneous error conditions may also show up in output.

Examples

The following shows typical output displayed by the debug cable error command.

Router# debug cable error 
Router#
 00:19:22: Receive data error, status=0x0D04
 00:19:22: Receive data error:
 00:19:22: Prepended data:
        5C 1E 00 02 00 5F 58 5F 01 12 36 FF F2 00 00 00 
 00:19:22: Packet data (size=36):
 00:19:22: 0x000: C2 00 00 1E 8E 07 00 E0 1E D7 CC 94 00 50 73 18 
 00:19:22: 0x010: E9 F1 00 0C 
 00:19:22: 

debug cable flap

To display information about the operation of the CM flap list that is maintained for the cable interfaces, use the debug cable flap command in the Privileged EXEC mode. To disable debugging output, use the no form of this command.

debug cable flap

no debug cable flap

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

11.3(8)NA, 12.0(4)T

This command was introduced for Cisco uBR7200 series routers.

12.0(6)SC

Support for this command was added to the Release 12.0 SC.

12.1(5)EC

Support for this command was added for the Cisco uBR7100 series routers.

12.2(4)BC1

Support was added to the Release 12.2 BC.

12.2(11)BC2

Support for this command was added to the Release 12.2 BC.


Usage Guidelines

This command shows debugging messages about the operation of the CM flap list that is maintained for the cable interfaces.


Caution The debug commands are primarily intended for use in controlled test and troubleshooting situations with a limited volume of traffic.

Examples

The following example enables debugging for the CM flap list:

Router# debug cable flap 

CMTS flap debugging is on

Router# show debug 
CMTS:
  CMTS flap debugging is on
Router# 

When debugging is turned on and a CM is added to the flap list the Cisco CMTS displays the following message:

Cable modem <<mac address>> added to flap-list

When debugging is turned on and a CM is removed from the flap list, the Cisco CMTS displays the following message:

Cable modem <<mac address>> removed from flap-list (<<number>> seconds after last flap)

When debugging is turned on and the Cisco CMTS checks the flap list for aged out CMs that need to be removed from the list, the CMTS displays the following message:

CMTS flap list aging check (interval = 120 min)

Related Commands

cable flap-list aging

Specifies the number of days to keep a CM in the flap-list table before aging it out of the table.

cable flap-list insertion-time

Sets the insertion time interval that determines whether a CM is placed in the flap list.

cable flap-list miss-threshold

Specifies miss threshold for recording a flap-list event.

cable flap-list power-adjust threshold

Specifies the power-adjust threshold for recording a CM flap-list event.

cable flap-list size

Specifies the maximum number of CMs that can be listed in the flap-list table.

clear cable flap-list

Clears all the entries in the flap-list table.

ping docsis

Sends a DOCSIS ping to a CM and increments the flap-list counters as appropriate.

show cable flap-list

Displays the current contents of the flap list.


debug cable fn

To enable debugging information for cable fiber nodes, use the debug cable fn command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug cable fn

no debug cable fn

Syntax Description

This command has no keywords or arguments.

Command Default

No cable fiber node debug messages are enabled.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.3(21)BC

This command was introduced for the Cisco uBR10012 router.


Usage Guidelines

The debug cable fn command is intended for use by Cisco technical support personnel.


Caution Because debugging output is assigned high priority in the CPU process, it can render the system unusable. For this reason, use debug commands only to troubleshoot specific problems or during troubleshooting sessions with Cisco technical support personnel. Moreover, it is best to use debug commands during periods of lower network traffic and fewer users. Debugging during these periods decreases the likelihood that increased debug command processing overhead will affect system use.

For general (non-wideband) information on CMTS debugging commands, see the Cisco Broadband Cable Command Reference Guide.

Examples

The following example shows how to enable debug messages for cable fiber nodes:

Router# debug cable fn 

CMTS fiber node debugging is on

...

The following sample messages are displayed when RF channels 0 and 1 are removed from fiber node 1:

Router(config)# cable fiber 1  
Router(config-fiber-node)# no downstream modular-cable 3/0/0 rf-channel 0 - 1  
...
*Nov 7 17:42:27.903: fn_get_cdb: cdb slot 3(3) subslot 0(0)appl_no 0(0)
*Nov 7 17:42:27.903: cfg_cable_fn_cmd: fiber-node 1 status 0x01 cmd 3 sense 0
*Nov 7 17:42:27.903: no downstream FN 1, 3/0/0 port range 0 - 1 
*Nov 7 17:42:27.903: no downstream FN 1, 3/0/0 bg_rfch 0000000000000004 
*Nov 7 17:42:27.903: set FN 1 status old 0x01 to new 0x01 
*Nov 7 17:42:27.903: fn_freq_unique: FN 1 
*Nov 7 17:42:27.903: prim_rfch 35 slot 8 subslot 1 unit 0 
*Nov 7 17:42:27.903: prim_rfch 35 freq 555000000 channel_id 203 
*Nov 7 17:42:27.903: bg_rfch 2 slot 3 subslot 0 unit 2 
*Nov 7 17:42:27.903: fn_get_cdb: cdb slot 3(3) subslot 0(0)appl_no 0(2) 
*Nov 7 17:42:27.903: bg_rfch 2 freq 711000000 channel_id 26 
*Nov 7 17:42:27.903: clr FN 1 status old 0x01 to new 0x01 
*Nov 7 17:42:27.903: fn_channel_id_unique: FN 1 
*Nov 7 17:42:27.903: prim_rfch 35 slot 8 subslot 1 unit 0 
*Nov 7 17:42:27.903: prim_rfch 35 freq 203 channel_id 203 
*Nov 7 17:42:27.903: bg_rfch 2 slot 3 subslot 0 unit 2 
*Nov 7 17:42:27.903: fn_get_cdb: cdb slot 3(3) subslot 0(0)appl_no 0(2) 
*Nov 7 17:42:27.903: bg_rfch 2 freq 711000000 channel_id 26 
*Nov 7 17:42:27.903: clr FN 1 status old 0x01 to new 0x01 
*Nov 7 17:42:27.903: fn_bundle_same: FN 1 
*Nov 7 17:42:27.903: prim_rfch 35 slot 8 subslot 1 unit 0 
*Nov 7 17:42:27.903: prim_rfch 35 nb_hwidb Cable8/1/0 bundle 1 
*Nov 7 17:42:27.903: bg_rfch 2 slot 3 subslot 0 unit 2 
*Nov 7 17:42:27.903: fn_get_cdb: cdb slot 3(3) subslot 0(0)appl_no 0(2) 
*Nov 7 17:42:27.903: clr FN 1 status old 0x01 to new 0x01 
*Nov 7 17:42:27.903: cfg_cable_fn_cmd: fiber-node 1 status 0x01 
*Nov 7 17:42:35.267: FN 1 save context status 0x01(0x01) 
*Nov 7 17:42:35.267: FN 1 status 0x01 saved status 0x01) 
*Nov 7 17:42:35.267: fiber-node 1 update SG status = 0x01 
*Nov 7 17:42:35.267: DS-SG: Updating Association Table from DS-SG. Current: 0x1 New: 0x0 
*Nov 7 17:42:35.267: DS-SG: Updating the Wideband Channel Mask: 0x0 

Related Commands

Command
Description

debug c10k-jacket

Enables debugging information for the Wideband SIP.

debug cable wbcmts

Enables debugging information for the wideband CMTS.

debug hw-module bay

Enables debugging information for a Wideband SPA.


debug cable freqhop

To display debug messages for frequency hopping, use the debug cable freqhop command in privileged EXEC mode. Use the no form of this command to disable debugging output.

debug cable freqhop

no debug cable freqhop

Syntax Description

This command has no arguments or keywords.

Command History

Release
Modification

12.0(4)XI

This command was introduced.


Examples

The following example shows how to display debug messages for frequency hopping:

router# debug cable interface c6/0 
router# debug cable freqhop
CMTS freqhop debugging is on
router# 
Sep 27 10:36:41.202: Cable5/0 U0: last hop delta: 1
Sep 27 10:36:42.202: Cable5/0 U0: last hop delta: 2

debug cable hw-spectrum

To display debug messages for spectrum management (frequency agility), use the debug cable hw-spectrum command in privileged EXEC mode. To disable debugging output, use the no form of the command.

debug cable hw-spectrum

no debug cable hw-spectrum

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

11.3 NA

This command was introduced as debug cable specmgmt.

12.0(4)XI

This command was enhanced and renamed to debug cable hw-spectrum.


Examples

The following shows how to enable debug cable hw-spectrum debugging.

Router# debug cable hw-spectrum 
CMTS spectrum analyzer debugging is on 
Router# 

Related Commands

Command
Description

debug cable specmgmt

Displays debugging output for the CMTS spectrum analyzer process.


debug cable interface

To display debug messages for a specific cable interface, or for traffic related to a specific MAC address or Service ID (SID) on that interface, use the debug cable interface command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug cable interface cable {slot/port | slot/subslot/port} [mac-address address [mask] | sid number] [verbose]

no debug cable interface cable {slot/port | slot/subslot/port} [mac-address address [mask] | sid number] [verbose]

Syntax Description

slot/port

Identifies the cable interface and downstream port on the Cisco uBR7100 series and Cisco uBR7200 series routers.

On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.

slot/subslot/port

Identifies the cable interface on the Cisco uBR10012 router. The following are the valid values:

slot = 5 to 8

subslot = 0 or 1

port = 0 to 4 (depending on the cable interface)

mac-address address mask

(Optional) Specifies that debugging is to be done only on traffic related to the specified MAC address. An optional mask can be specified to indicate a range of MAC addresses. The mask is ANDed with the address to determine which bits of the address must match to be included in the debugging display.

sid number

(Optional) Specifies that debugging is to be done only on traffic related to the specified SID. The valid range is 1 to 8191.

verbose

(Optional) Displays detailed debug information.


Command Default

Debugging for the cable interfaces is not enabled, which means most of the other debug cable commands will not display any output, even when debugging is enabled.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(6)T

This command was introduced.


Usage Guidelines

The debug cable interface command must be used to enable debugging on a cable interface before other debug commands can be used on that interface. The mac-address and sid options can be used to restrict the debug output to only those messages that are related to a specific MAC address or SID, so that the volume of debug messages does not affect system performance.

Examples

The following example shows how to enable debugging on the cable interface in slot 6:

Router# debug cable interface c6/0 
Router# show debug 
CMTS specific:
  Debugging is on for Cable6/0 
Router# 

The following shows how to enable verbose debugging on the cable interface in slot 6:

Router# debug cable interface c6/0 verbose 
Router# show debug 
CMTS specific:
  Debugging is on for Cable6/0 (verbose) 
Router# 

The following example shows how to enable debugging on the cable interface in slot 6 for all traffic coming from CMs and other devices with MAC addresses that match the address range 0010.0000.0000 through 0010.00FF.FFFF (0010.00xx.xxxx):

Router# debug cable interface c6/0 mac-address 0010.0000.0000 FFFF.FF00.0000 
Router# show debug 
CMTS specific:
  Debugging is on for Cable6/0, Address 0010.0000.0000, Mask ffff.ff00.0000
Router# 

Related Commands

Command
Description

debug cable dynsrv

Displays debugging information about DOCSIS 1.1 dynamic service flow messages.

debug cable mac-address

Enables debugging on traffic from CMs with the specific MAC address or within the specific MAC address range.


debug cable ipv6

To enable debugging of IPv6 transactions on a cable interface on a Cisco CMTS router, use the debug cable ipv6 command in privileged EXEC mode. To disable debugging output, use the no form of the command.

debug cable ipv6 [db | dhcp | nd | source-verify]

no debug cable ipv6 [db | dhcp | nd | source-verify]

Syntax Description

db

Displays messages associated with host database transactions.

dhcp

Displays messages associated with Dynamic Host Control Protocol for IPv6 (DHCPv6) transactions.

nd

Displays messages associated with Neighbor Discovery (ND) transactions.

source-verify

Displays messages associated with source verification transactions.


Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCA

This command was introduced.


Usage Guidelines

The debug commands are primarily intended for use in controlled test and troubleshooting situations with a limited volume of traffic. In particular, avoid using the debug cable ipv6 command on an interface with a significant number of CMs, because the resulting volume of debug output could impact system performance. Cisco recommends that when you use the debug cable ipv6 command, you limit its output to a particular interface or CM, using the debug cable interface or debug cable mac-address commands.

Related Commands

Command
Description

debug cable arp

Enables debugging of the Address Resolution Protocol on the cable interface.

debug cable encap

Enables debugging of encapsulated PPPoE packets that are transmitted over the cable interface.

debug cable interface

Enables debugging on a specific cable interface.

debug cable mac-address

Enables debugging for a particular CM.


debug cable keyman

To activate debugging of TEK and KEK BPI key management, use the debug cable keyman command in privileged EXEC mode. To disable debugging output, use the no form of the command.

debug cable keyman

no debug cable keyman

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

11.3NA

This command was introduced.


Usage Guidelines

This command activates debugging of the TEK and KEK baseline privacy key activity. When this command is activated, all activity related to KEK and TEK keys is displayed on the Cisco CMTS console. This command is used to display encryption key management debugging output.


Note This command is supported only on images that support BPI or BPI+ encryption.


Examples

The following shows typical output from the debug cable keyman command.

Router# debug cable keyman 
Router# 

 Dec 11 23:16:19.139: CMTS Received AUTH REQ.
 Dec 11 23:16:19.139: Created a new CM key for 0010.7b43.aa2f.
 Dec 11 23:16:19.139: CMTS generated AUTH_KEY.
 Dec 11 23:16:19.139: Input : 23FD16A701FD2091
 Public Key : 
 Dec 11 23:16:19.139: 30 68 02 61 00 C1 26 6F 53 3E CE 17 AB 18 84 C5 
 Dec 11 23:16:19.139: 63 B3 A2 DA 66 29 96 13 23 B8 A3 C8 AF B7 CF C8 
 Dec 11 23:16:19.139: 54 6B 16 14 E2 9B 12 0B 34 79 51 DA 18 AB DE 8C 
 Dec 11 23:16:19.139: 65 8F 0B 8A AB 25 3B 88 F1 6D 53 5F 64 C3 3E 50 
 Dec 11 23:16:19.139: 81 57 AA C5 8F CE 4F 3C A8 96 2F 60 0F F6 30 E6 
 Dec 11 23:16:19.139: 91 61 29 42 E1 C2 96 0F CB 10 EF F9 0D 6F 45 76 
 Dec 11 23:16:19.139: 1D 17 FD 26 6D 02 03 01 00 01 
 Dec 11 23:16:19.139: 
 Dec 11 23:16:19.139: RSA publlic Key subject:
 Dec 11 23:16:19.143: 30 7C 30 0D 06 09 2A 86 48 86 F7 0D 01 01 01 05 
 Dec 11 23:16:19.143: 00 03 6B 00 30 68 02 61 00 C1 26 6F 53 3E CE 17 
 Dec 11 23:16:19.143: AB 18 84 C5 63 B3 A2 DA 66 29 96 13 23 B8 A3 C8 
 Dec 11 23:16:19.143: AF B7 CF C8 54 6B 16 14 E2 9B 12 0B 34 79 51 DA 
 Dec 11 23:16:19.143: 18 AB DE 8C 65 8F 0B 8A AB 25 3B 88 F1 6D 53 5F 
 Dec 11 23:16:19.143: 64 C3 3E 50 81 57 AA C5 8F CE 4F 3C A8 96 2F 60 
 Dec 11 23:16:19.143: 0F F6 30 E6 91 61 29 42 E1 C2 96 0F CB 10 EF F9 
 Dec 11 23:16:19.143: 0D 6F 45 76 1D 17 FD 26 6D 02 03 01 00 01 
 Dec 11 23:16:19.155: RSA encryption result = 0
 Dec 11 23:16:19.155: Output : 
 Dec 11 23:16:19.155: 88 5F 67 22 86 68 2B 1D A6 F4 E9 62 43 58 1A C8 
 Dec 11 23:16:19.155: 49 97 7E 81 EE EF B0 DD C4 42 30 FD 24 B0 54 2E 
 Dec 11 23:16:19.155: 01 CC 84 53 BD 71 50 9D B3 82 4D 7B 49 42 E1 F0 
 Dec 11 23:16:19.155: 2D 67 3D 46 CB 27 4D 60 16 00 4D EE E1 F3 FD 1D 
 Dec 11 23:16:19.155: 9C E6 03 3C 77 C8 3A 44 B9 FA 34 2E 44 1B 69 F4 
 Dec 11 23:16:19.155: AA 68 BF BB A5 43 9B F7 85 82 ED 39 45 02 92 56 
 Dec 11 23:16:19.155: CMTS sent AUTH response.
 Dec 11 23:16:24.267: CMTS Received TEK REQ.
 Dec 11 23:16:24.267: Message Digest Verification Failed.
 Dec 11 23:16:24.267: Sending KEK INVALID.
 Dec 11 23:16:24.323: CMTS Received AUTH REQ.
 Dec 11 23:16:24.323: Find a match CM key for abcd.0123.4455

Related Commands

Command
Description

debug cable bpiatp

Displays debugging information for BPI-related messages that the CMTS sends or receives.

debug cable privacy

Displays debugging information whenever the BPI state changes or a BPI event occurs.


debug cable l2-vpn

To display debugging messages for the Layer 2 mapping of cable modems to particular permanent virtual connections (PVC) or to a virtual local area network (VLAN), use the debug cable l2-vpn command in privileged EXEC mode. To stop the display of debugging messages, use the no form of this command.

debug cable l2-vpn [conditional]

no debug cable l2-vpn [conditional]


Note This command is not supported for the Cisco uBR10012 router, through release 12.3(13a)BC.


Syntax Description

conditional

(Optional) Displays the packets that are sent or received for a particular cable modem or cable interface.

Note The conditional option does not display any output until you have also enabled debugging for a particular interface, using the debug cable interface command, or for a particular MAC address, using the debug cable mac-address command.


Command Default

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(11)BC3

This command was introduced for Cisco uBR7100 series and Cisco uBR7246VXR universal broadband routers to debug the Layer 2 mapping of cable modems to a PVC on an Asynchronous Transfer Mode (ATM) interface.

12.2(15)BC2

Support was added for the debugging of the Layer 2 mapping of cable modems to a virtual local area network (VLAN) on an outbound Ethernet interface.


Usage Guidelines

The debug cable l2-vpn command displays status information for the mapping of cable modems to PVCs on an ATM interface (see the cable vc-map command) or to a VLAN on an Ethernet, Fast Ethernet, or Gigabit Ethernet interface (see the cable dot1q-vc-map command). The debug messages show when a cable modem is mapped to a PVC or VLAN, when the mapping is changed or removed, and when packets are sent and received over the mapping.

The conditional option displays information for each packet that is sent and received over an ATM PVC or VLAN mapping. Because this can produce a large volume of debug information, the conditional option can be used only when you have also enabled debugging for a particular interface or MAC address, using the debug cable interface and debug cable mac-address commands, respectively.

Examples

The following example shows typical output for the debug cable l2-vpn command when a cable modem is mapped to an ATM PVC:

Router# debug cable l2-vpn 

CMTS L2 VPN debugging is on 

Router# configure terminal 
Router(config)# cable l2-vpn-service atm-vc 
Router(config)# cable vc-map 0007.0e03.69f9 ATM2/0 1/1 

6d00h: Associating vc ATM2/0.1 1/1 to CM 0007.0e03.69f9 sid 0x1
6d00h: Writing vc-map info to sid 0x1

Router(config)# 

The following example shows typical output for the debug cable l2-vpn command when a cable modem is mapped to an IEEE 802.1Q VLAN:


Router# debug cable l2-vpn 

CMTS L2 VPN debugging is on 

Router# configure terminal 
Router(config)# cable l2-vpn-service dot1q 
Router(config)# cable dot1q-vc-map 0007.0e03.69f9 FastEthernet0/0 5 
Router(config)# 

Set promiscuous mode for FastEthernet0/0
Mapped DS srv flow 13 on Cable5/0 to FastEthernet0/0 VLAN 5 
Mapped US srv flow 11 sid 31 on Cable5/0 to FastEthernet0/0 VLAN 5 

The following example shows typical output for the debug cable l2-vpn command when a mapping is deleted:

Router# debug cable l2-vpn 

CMTS L2 VPN debugging is on 

Router# configure terminal 
Router(config)# no cable vc-map 0007.0e03.69f9 ATM2/0 1/1 

6d00h: Disassociating vc ATM2/0.1 1/1 from CM 0007.0e03.69f9 sid 0x1
6d00h: Erasing vc-map info to sid 0x1

Router(config)# 

The following example shows typical output for the conditional option. This example shows output for traffic to and from one particular cable modem. Each debug message shows the size of the packet, the source and destination MAC addresses, the cable interface and SID being used, and the ATM interface and PVC/PVI being used.

Router# debug cable mac-address 000C.0807.06.05 
Router# debug cable l2-vpn conditional 

CMTS L2 VPN conditional debugging is on 

6d00h: Fwd pkt size 74 from 000C.0807.0605 on Cable4/0:0x1 to 0900.2b00.000f on ATM2/0:1/1
6d00h: Fwd pkt size 74 from 000C.0807.0605 on Cable4/0:0x1 to 0900.07ff.ffff on ATM2/0:1/1
6d00h: Fwd pkt size 1028 from 000C.0807.0605 on Cable4/0:0x1 to 0002.4a1d.dc1d on 
ATM2/0:1/1
6d00h: Send pkt size 1020 encsize 6 from 0002.4a1d.dc1d on ATM2/0:1/1 to 000C.0807.0605 on 
Cable4/0:0x1
6d00h: Fwd pkt size 74 from 000C.0807.0605 on Cable4/0:0x1 to 0900.07ff.ffff on ATM2/0:1/1

Router# 

Related Commands

Command
Description

cable dot1q-vc-map

Maps a cable modem to a particular Virtual Local Area Network (VLAN) on a local outbound Ethernet interface.

cable l2-vpn-service atm-vc

Enables the use of Layer 2 tunnels for the Customer Premises Equipment (CPE) traffic that is behind cable modems, so that individual CPE traffic can be routed to a particular PVC on an ATM interface.

cable l2-vpn-service dot1q

Enables the use of Layer 2 tunnels so that traffic for individual cable modems can be routed over a particular Virtual Local Area Network (VLAN).

cable vc-map

Maps a cable modem to a particular PVC on an ATM interface.

debug cable interface

Enables debugging output for a specific cable interface.

debug cable mac-address

Enables debugging output for the cable modems that match the specified hardware (MAC) address or range of addresses.

show cable l2-vpn dot1q-vc-map

Displays the mapping of one or all cable modems to IEEE 802.1Q Virtual Local Area Networks (VLANs) on the router's Ethernet interfaces.

show cable l2-vpn vc-map

Displays the mapping of one or all cable modems to PVCs on the ATM interfaces.


debug cable load-balance

To display debugging messages for load-balancing operations on the router, use the debug cable load-balance command in privileged EXEC mode. To stop the display of debugging messages, use the no form of this command.

debug cable load-balance [error]

no debug cable load-balance [error]

Syntax Description

error

(Optional) Displays debugging messages about errors that might occur during load-balancing operations about the actual number of CMs that are active on a channel.


Command Default

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(15)BC1

This command was introduced for the Cisco uBR7246VXR and Cisco uBR10012 routers.


Usage Guidelines

The debug cable load-balance command displays debugging output for when cable modems come online those cable interfaces that are part of a load balance group. It also displays debugging messages when cable modems are moved to achieve balanced loads on those cable interfaces.


Tip Because this command can produce a large volume of debug information, Cisco recommends that you limit debugging output to a particular interface or MAC address, using the debug cable interface and debug cable mac-address commands, respectively.


Examples

The following example shows typical output for the debug cable load-balance command for a particular cable interface:

Router# debug cable interface c3/0 
Router# debug cable load-balance 

CMTS load balancing debugging is on

*Feb 13 13:39:21.594 PDT: lb: Removing Modem entry 0050.7318.e615: at target (upstream)

*Feb 13 13:39:50.754 PDT: lb: US request from Cable3/0/U0[0050.7366.1f7b]: target U3 
[enforce], 0 retries

*Feb 13 12:53.010 PDT: lb: Moving Modem 0050.7366.218b from Cable3/0/U0 to U2
*Feb 13 13:40:03.034 PDT: lb: Moving Modem 0050.7366.1c7f from Cable3/0/U1 to U2
*Feb 13 13:40:04.790 PDT: lb: US request from Cable3/0/U1[0050.7318.e615]: target U2 
[enforce], 0 retries
*Feb 13 13:40:11.150 PDT: lb: Removing Modem entry 0050.7318.e615: at target (upstream)
*Feb 13 13:40:23.042 PDT: lb: Moving Modem 0050.7366.21c7 from Cable3/0/U0 to U3
*Feb 13 13:40:23.042 PDT: lb: Moving Modem 0050.7366.2197 from Cable3/0/U0 to U3
*Feb 13 13:40:23.042 PDT: lb: Moving Modem 0050.7366.1f75 from Cable3/0/U0 to U3

Router# 

The following example shows typical output for the debug cable load-balance command when the error option is used to display messages about possible errors in the number of CMs that are active on the interface.

Router# debug cable interface c5/1/0 
Router# debug cable load-balance error 

Router# 
CMTS load balancing error debugging is on

lb: c5/1/0/U4: Total modems: 126 active modems: 123 
c5/1/0: delete_sid_state on modem 0001.0203.0405 in state offline 

Related Commands

Command
Description

cable load-balance exclude

Excludes a particular cable modem, or all cable modems from a particular vendor, from one or more types of load-balancing operations.

cable load-balance group (global configuration)

Creates and configures a load-balance group.

cable load-balance group (interface configuration)

Assigns a downstream to a load-balance group.

cable load-balance group interval

Configures the frequency of the load-balancing policy updates.

cable load-balance group policy ugs

Configures how the Cisco CMTS should load balance cable modems with active unsolicited grant service (USG) service flows.

cable load-balance group threshold

Configures the threshold values that a load-balance group should use for load-balancing operations.

cable upstream load-balance group

Assigns an upstream to a load-balance group.

clear cable load-balance

Clears the counters or state machine used to track load-balancing operations.

debug cable interface

Enables debugging output for a specific cable interface.

debug cable l2-vpn

Displays debugging messages for load-balancing operations on the router.

debug cable mac-address

Enables debugging output for the cable modems that match the specified hardware (MAC) address or range of addresses.

show cable load-balance

Displays real-time statistical and operational information for load-balancing operations.


debug cable mac-address

To display debug information for a specific CM, use the debug cable mac command in privileged EXEC mode. The no form of this command disables debugging output.

debug cable mac-address address [address-mask] [verbose]

no debug cable mac-address address [address-mask] [verbose]

Syntax Description

address

Specifies the particular MAC address to debug.

address-mask

Specifies an address mask to indicate a range of addresses to debug. This mask is bit-ANDed with the given address, and debug messages are displayed for any CM that matches the resulting non-zero bits.

verbose

Specifies detailed output for the particular MAC address.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.1 T

This command was introduced.


Usage Guidelines

You can repeat this command for other MAC addresses. Each time you specify a different MAC address, debugging is turned on for that particular MAC address.

If you enter two commands with the same MAC address, but with different values for the mask or verbose keywords, the router treats both commands as the same. In this case, the latest debugging information supersedes the previous debugging information.


Note Do not use this command if you have a large number of CMs on your network. The Cisco CMTS will become flooded with console printouts.


Examples

The following example demonstrates how to enable debugging for all traffic coming from cable interface 3/0 of CMs with the MAC address 00E0.1Exx.xxxx:


Router# debug cable interface c3/0 
Router# debug cable mac-address 00E0.1E00.0000 ffff.ff00.0000 
Router# 
004042: Jul  2 08:47:13.656: Ranging Modem 00E0.1E23.4567, SID 73 on Interface Cable3/U0
004043: Jul  2 08:47:13.656: Ranging request from 00E0.1E23.4567, SID 73 [73] on Interface 
Cable3/U0
004044: Jul  2 08:47:13.656: Timing error 0, power error 0.25dB, freq error 4 (adjust 0)
004045: Jul  2 08:47:13.656: Ranging successful

Tip To monitor a specific CM when it comes online, use the debug cable mac-address, debug cable mac-protocol, and debug cable registration commands.


Table 0-191 debug cable mac Command Field Descriptions 

Field
Description

SID value is....

Reports the service ID of the modem. The range is from 1 through 891. The information on this line should agree with the first line of the return (that is, Ranging Modem with Sid...).

CM mac address....

The MAC address of the specified CM.

Timing offset is....

The time by which to offset the frame transmission upstream so that the frame arrives at the expected minislot time at the CMTS.

Power value is FE0, or 0 dB

The raw value derived from the 3137 Broadcom chip. Alternatively, the dB value specifies the relative change in the transmission power level that the CM needs to make sure that transmissions arrive at the CMTS at the desired power level.

Freq Error = ....

The raw value derived from the 3137 Broadcom chip.

Freq offset is ....

Specifies the relative change in the transmission frequency that the CM will make to match the CMTS.


Related Commands

Command
Description

debug cable dynsrv

Displays debugging information about DOCSIS 1.1 dynamic service flow messages.

debug cable interface

Enables debugging output for a specific cable interface.

debug cable mac-protocol

Displays debugging output for the MAC layer protocol.

debug cable mac-scheduler

Displays debugging output for the MAC layer scheduler and admission control activities.

debug cable registration

Displays debugging output for the registration messages sent when a CM comes online with the CMTS.

debug cable tlvs

Enables debugging for the Type/Length/Value encodings (TLVs) parsed by the DOCSIS 1.1 TLV parser/encoder.

show controllers cable

Displays interface controller information for the specified slot.


debug cable mac-protocol

To display MAC-layer information for a specific CM, use the debug cable mac command in privileged EXEC mode. The no form of this command disables debugging output.

debug cable mac-protocol

no debug cable mac-protocol

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1 T

This command was introduced.


Usage Guidelines

Do not use this command if you have a large number of CMs on your network. The Cisco CMTS will become flooded with console printouts.

Examples

The following example shows the return for the MAC layer:

router# debug cable mac-protocol

CMTS mac debugging is on 
19:46:27: Ranging Modem with Sid 1 on i/f : Cable6/0/U0

19:46:27: Got a ranging request
19:46:27: SID value is 1 on Interface Cable6/0/U0
19:46:27: CM mac address 00:E0:1E:B2:BB:07 
19:46:27: Timing offset is 0
19:46:27: Power value is FE0, or 0 dB
19:46:27: Freq Error = 0, Freq offset is 0
19:46:27: Ranging has been successful for SID 1 on Interface Cable6/0/U0

19:46:29: Ranging Modem with Sid 2 on i/f : Cable6/0/U0
19:46:29: Got a ranging request
19:46:29: SID value is 2 on Interface Cable6/0/U0
19:46:29: CM mac address 00:E0:1E:B2:BB:8F 
19:46:29: Timing offset is 1
19:46:29: Power value is 1350, or 0 dB
19:46:29: Freq Error = 0, Freq offset is 0
19:46:29: Ranging has been successful for SID 2 on Interface Cable6/0/U0

19:46:32: Ranging Modem with Sid 3 on i/f : Cable6/0/U0

19:46:32: Got a ranging request
19:46:32: SID value is 3 on Interface Cable6/0/U0
19:46:32: CM mac address 00:E0:1E:B2:BB:B1 
19:46:32: Timing offset is FFFFFFFF
19:46:32: Power value is 1890, or -1 dB
19:46:32: Freq Error = 0, Freq offset is 0
19:46:32: Ranging has been successful for SID 3 on Interface Cable6/0/U0

19:46:34: Ranging Modem with Sid 5 on i/f : Cable6/0/U0



Tip To monitor a specific CM when it comes online, use the debug cable mac-address, debug cable mac-protocol, and debug cable registration commands.


Table 0-192 debug cable mac-protocol Command Field Descriptions

Field
Description

SID value is....

Reports the service ID of the modem. The range is from 1 through 8191. The information on this line should agree with the first line of the return (that is, Ranging Modem with Sid...).

CM mac address....

The MAC address of the specified CM.

Timing offset is....

The time by which to offset the frame transmission upstream so that the frame arrives at the expected minislot time at the CMTS.

Power value is FE0, or 0 dB

The raw value derived from the Broadcom chip. Alternately, the dB value specifies the relative change in the transmission power level that the CM needs to make so that transmissions arrive at the CMTS at the desired power level.

Freq Error = ....

The raw value derived from the Broadcom chip.

Freq offset is ....

Specifies the relative change in the transmission frequency that the CM will make to match the CMTS.


Related Commands

Command
Description

debug cable interface

Enables debugging output for a specific cable interface.

debug cable mac-address

Displays debugging output for the CMs that match the specified address or range of addresses.

debug cable mac-scheduler

Displays debugging output for the MAC layer scheduler and admission control activities.

debug cable registration

Displays debugging output for the registration messages sent when a CM comes online with the CMTS.

show controllers cable

Displays interface controller information for the specified slot.


debug cable mac-scheduler

To display information for the MAC layer's scheduler and admission control activities, use the debug cable mac-scheduler command in privileged EXEC mode. The no form of this command disables debugging output.

debug cable mac-scheduler [admission control]

no debug cable mac-scheduler [admission control]

Syntax Description

admission-control

(Optional) Displays debugging output for the MAC scheduler's admission control activities, which controls the percentage of overbooking allowed on the upstream channel.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(4)CX

This command was introduced for the Cisco uBR10012 router.

12.2(4)BC1

Support for this command was added to the Release 12.2 BC train for the Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 routers.


Usage Guidelines

Do not use this command if you have a large number of CMs on your network. The Cisco CMTS will become flooded with console printouts.


Caution The debug commands are primarily intended for use in controlled test and troubleshooting situations with a limited volume of traffic. In particular, avoid using the debug cable mac-scheduler command on an interface with a significant number of CMs, because the resulting volume of debug output could impact system performance. Cisco recommends that when you use the debug cable mac-scheduler command, you limit its output to a particular interface or CM, using the debug cable mac-address or debug cable interface commands.

Examples

The following example shows debugging being turned on for the MAC scheduler:

Router# debug cable mac-scheduler 
CMTS scheduler debugging is on 

Router# 

The following examples shows admission-control debugging being turned on for a particular CM with the MAC address of 000C.1234.5678, and the typical messages that appear if the CM cannot register because the channel is oversubscribed.

Router# debug cable mac-address 000C.1234.5678 verbose 
Router# debug cable mac-scheduler admission-control 
CMTS scheduler debugging is on 

Router# 

Oct 23 09:38:56.701: MSCHED_CAC: Admit req for US service flow.
Oct 23 09:38:56.701:    SFID=3 SID=1 AdmQoS=5
Oct 23 09:38:56.701:    Admission check for BE service
Oct 23 09:38:56.701:            Min rsvd rate : 1800000 bps
Oct 23 09:38:56.701:            Failed to allocate bandwidth
Oct 23 09:38:56.701:    Admit req rejected. 

Related Commands

cable upstream admission-control

Determines the percentage of overbooking allowed on the upstream channel.

debug cable mac-address

Displays debugging output for the CMs that match the specified address or range of addresses.

debug cable mac-protocol

Displays debug messages for the MAC-layer protocol.

debug cable us-adm-ctrl

Displays debug messages for upstream admission control activity.


debug cable map

To display debugging messages for DOCSIS MAC-layer MAP messages, use the debug cable map command in privileged EXEC mode. The no form of this command disables debugging output.

debug cable map [error | sid [sid-num] ]

no debug cable map [error | sid [sid-num] ]

Syntax Description

error

Displays debugging messages about DOCSIS MAP messages that were received with errors.

sid [sid-num]

Specifies the specific service ID (SID) to be debugged in DOCSIS MAP messages. The valid range for the optional sid-num value is 1 to 8191. If sid-num is not specified, debugging messages are shown for all SIDs.


Command Modes

Privileged EXEC

Command History

Release
Modification

12.1 T

This command was introduced.

12.2(15)BC1

The error option was added.


Examples

The following example shows how to display all MAP messages, with and without data grants:

Router# debug cable map 

19:41:53: On interface Cable6/0, sent 5000 MAPs, 1321 MAPs had grant(s)Long Grants 
13256993, Total Short Grants 223

------------------ MAP MSG  --------------------
us_ch_id: 1   ucd_count: 5  num_elems: 9  reserved: 0
Alloc Start Time: 33792        Ack Time: 33618
Rng_bkoff_start: 0    Rng_bkoff_end: 2
Data_bkoff_start: 1   Data_bkoff_end: 3:
sid:16383   iuc:1   mslot_offset:0
sid:0   iuc:7   mslot_offset:40

------------------ MAP MSG  ---------------------
us_ch_id: 1   ucd_count: 5  num_elems: 7  reserved: 0
Alloc Start Time: 33712        Ack Time: 33578
Rng_bkoff_start: 0    Rng_bkoff_end: 2
Data_bkoff_start: 1   Data_bkoff_end: 3
sid:2   iuc:6   mslot_offset:0
sid:16383   iuc:1   mslot_offset:16
sid:0   iuc:7   mslot_offset:40

Table 0-193 describes the fields displayed by the debug cable map command.

Table 0-193 debug cable map Field Descriptions 

Field
Description

sent 5000 MAPs

Total number of maps transmitted.

MAPs had grant(s) Long Grants

Total number of grants considered long-sized by CMTS.

Total Short Grants

Total number of grants considered short-sized by CMTS.

us_ch_id

Identifies the upstream channel ID for this message.

ucd_count

Number of upstream channel descriptors (UCDs).

num_elems

Number of information elements in the map.

reserved

Reserved for alignment.

Alloc Start Time

Start time from CMTS initialization (in minislots) for assignments in this map.

Ack Time

Latest time from CMTS initialization (in minislots) processed in upstream. The CMs use this time for collision detection.

Rng_bkoff_start

Initial backoff window for initial ranging contention, expressed as a power of 2. Valid values are from 0 to 15.

Rng_bkoff_end

Final backoff window for initial ranging contention, expressed as a power of 2. Valid values are from 0 to 15.

Data_bkoff_start

Initial backoff window for contention data and requests, expressed as a power of 2. Valid values are from 0 to 15.

Data_bkoff_end

Final backoff window for contention data and requests, expressed as a power of 2. Valid values are from 0 to 15.

sid

Service ID.

iuc

Interval usage code (IUC) value.

mslot_offset

Minislot offset.


The following shows typical output for the debug cable map error command:

Router# debug cable int cable 4/0 
Router# debug cable map error 
CMTS map errors debugging is ON 

Router# 

00:11:21: ##### Bad IE-offset for prenull IE[1] 
#####----------------------  MAP MSG  ---------------------
us_ch_id: 1   ucd_count: 11  num_elems: 4  reserved: 0
Alloc Start Time: 20007713        Ack Time: 20007291
Rng_bkoff_start: 0    Rng_bkoff_end: 3
Data_bkoff_start: 0   Data_bkoff_end: 4
sid:16383   iuc:1   mslot_offset:0
sid:16383   iuc:1   mslot_offset:0 
sid:16383   iuc:1   mslot_offset:158
sid:0   iuc:7   mslot_offset:160 

Related Commands

Command
Description

show controllers cable

Displays interface controller information for the specified slot.


debug cable metering

To enable debugging of usage-based billing operations, use the debug cable metering command in privileged EXEC mode. To turn off debugging messages, use the no form of this command.

debug cable metering

no debug cable metering

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(9a)BC

This command was introduced.


Examples

The following example shows how to enable debugging for usage-based billing on the Cisco CMTS, and then shows examples of the debugging messages that can be displayed.

Router# debug cable metering 
CMTS metering debug is ON 

Router# 


Cannot get Metering CMTS IP/MAC Addresses. 
CMTS Billing ip address interface name c6/0 
CMTS SFLOG File BBCMTS_20000708-120931 open failed (23)
CMTS Metering open file CMTS0120000708-120931 successfully. 
CMTS Metering LOCAL data to write 5600, wrote 4800 to file local file 
CMTS Metering data to write 6400, wrote 6400 to file B_20000708-120931
CMTS Metering invalid FD for metering file 
CMTS Metering Produce Metering - END Time= 2002-05-25T14:41:29Z 
CMTS Metering closed file
CMTS Metering: xml end queue data malloc failed.
CMTS Metering file header len=480 
CMTS Metering: xml header enqueue failed. 
CMTS Metering: xml header enqueue OK. 
CMTS Metering: xml end queue data malloc failed. 
CMTS Metering xml_ending len 128 
CMTS Metering: xml end enqueue OK.
CMTS Metering element header length 440 
CMTS Metering sflog read buf = 4800 
CMTS Metering: malloc failed. 
CMTS Metering: SFLOG file 4800 size tx failed.
CMTS Metering: SFLOG tx OK 4800 size. 
Cmts Metering: SFLOG file doesn't exist
CMTS Metering abort producing billing due to file open failure.
CMTS Metering: enqueue failed
CMTS Metering get invalid CM. 
CMTS Metering valid cm 192.168.100.101, prim sid 13
CMTS Metering interval 30 
Invalid Metering Timer Expired...Stop Timer.

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.

show cable metering-status

Displays information about the most recent usage-based billing operation.

snmp-server enable traps cable

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


debug cable phs

To display the activities of the payload header suppression and restoration (PHS) driver, use the debug cable phs command in privileged EXEC mode. The no form of this command disables debugging output.

debug cable phs

no debug cable phs

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(4)CX

This command was introduced.

12.2(4)BC1

Support was added to the Release 12.2 BC train.


Usage Guidelines

Do not use this command when you have a large number of active CMs on your network, because it could generate a huge amount of output to the console port.

This command displays the output for both the upstream and downstream drivers. The upstream receive driver restores headers that have been suppressed by CMs, and the downstream driver suppresses specific fields in packet header before forwarding a frame to the CM.

Examples

The following example shows typical output from PHS debugging:

Router# debug cable phs 
CMTS payload header suppression debugging is on

00:02:55: New PHS rule: 1 (SFID: 9)
   size : 34
   mask : 00 00 00 03 FC 00 00 00  field: 00 00 00 00 00 00 00 00
 Add PHS rule 1 to CFR ID 1

 00:02:57: New PHS rule: 1 (SFID: 11)
   size : 34
   mask : 00 00 00 03 FC 00 00 00  field: 00 00 00 00 00 00 00 00
 Add PHS rule 1 to CFR ID 1
Router# 

debug cable phy

To activate debugging of messages generated in the cable physical layer, use the debug cable phy command in privileged EXEC mode. To disable debugging output, use the no form of the command.

debug cable phy

no debug cable phy

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

11.3NA

This command was introduced.


Usage Guidelines

This command activates debugging of messages generated in the PHY system, which is the physical layer where upstream and downstream activity between the Cisco CMTS and the HFC network is controlled. When this command is activated, any messages generated in the PHY system are displayed on the Cisco CMTS console.

Examples

The following is typical output from the debug cable phy command.

cmts_phy_init: mac_version == BCM3210_FPGA
bcm3033_set_tx_sym_rate(5056941)
stintctl = 0x54484800
bcm3033_set_tx_if_freq(44000000)
stfreqctl = 0x5BAAAAAA
cmts_phy_init_us: U0 part_id = 0x3136, revid = 0x05, rev_id2 = 0x64
cmts_phy_init: mac_version == BCM3210_FPGA
Media access controller chip version.
bcm3033_set_tx_sym_rate(5056941)
stintctl = 0x54484800
Physical layer symbol rate register value.
00:51:49: bcm3033_set_tx_if_freq(44000000)
00:51:49:  stfreqctl = 0x5BAAAAAA
Physical layer intermediate frequency (IF) register value.
00:51:49: cmts_phy_init_us: U0 part_id = 0x3136, revid = 0x05, rev_id2 = 0x64
Physical layer receiver chip part version.

debug cable privacy

To activate debugging of baseline privacy, use the debug cable privacy command in privileged EXEC mode. To disable debugging output, use the no form of the command.

debug cable privacy

no debug cable privacy

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

11.3 XA

This command was introduced.


Usage Guidelines

This command activates debugging of the Baseline Privacy Interface (BPI) feature. When this command is activated, the BPI handler generates a debugging message whenever the BPI state changes or a BPI-related event occurs.


Tip Debugging must be enabled for one or more cable interfaces, using the debug cable interface command, before the debug cable privacy command displays any output. BPI debugging can be done only on a per-interface basis, not on the basis of a CM's MAC address.



Note This command is supported only on images that support BPI or BPI+ encryption.


Examples

The following is typical output from the debug cable privacy command:

02:32:08: CMTS Received AUTH REQ.
02:32:08: Created a new CM key for 0030.96f9.65d9.
02:32:08: CMTS generated AUTH_KEY.
02:32:08: Input : 70D158F106B0B75
02:32:08: Public Key:
02:32:08: 0x0000: 30 68 02 61 00 DA BA 93 3C E5 41 7C 20 2C D1 87 
02:32:08: 0x0010: 3B 93 56 E1 35 7A FC 5E B7 E1 72 BA E6 A7 71 91 
02:32:08: 0x0020: F4 68 CB 86 A8 18 FB A9 B4 DD 5F 21 B3 6A BE CE 
02:32:08: 0x0030: 6A BE E1 32 A8 67 9A 34 E2 33 4A A4 0F 8C DB BD 
02:32:08: 0x0040: D0 BB DE 54 39 05 B0 E0 F7 19 29 20 8C F9 3A 69 
02:32:08: 0x0050: E4 51 C6 89 FB 8A 8E C6 01 22 02 34 C5 1F 87 F6 
02:32:08: 0x0060: A3 1C 7E 67 9B 02 03 01 00 01 
02:32:08: RSA public Key subject:
02:32:08: 0x0000: 30 7C 30 0D 06 09 2A 86 48 86 F7 0D 01 01 01 05 
02:32:08: 0x0010: 00 03 6B 00 30 68 02 61 00 DA BA 93 3C E5 41 7C 
02:32:08: 0x0020: 20 2C D1 87 3B 93 56 E1 35 7A FC 5E B7 E1 72 BA 
02:32:08: 0x0030: E6 A7 71 91 F4 68 CB 86 A8 18 FB A9 B4 DD 5F 21 
02:32:08: 0x0040: B3 6A BE CE 6A BE E1 32 A8 67 9A 34 E2 33 4A A4 
02:32:08: 0x0050: 0F 8C DB BD D0 BB DE 54 39 05 B0 E0 F7 19 29 20 
02:32:08: 0x0060: 8C F9 3A 69 E4 51 C6 89 FB 8A 8E C6 01 22 02 34 
02:32:08: 0x0070: C5 1F 87 F6 A3 1C 7E 67 9B 02 03 01 00 01 
02:32:08: RSA encryption result = 0
02:32:08: RSA encrypted output:
02:32:08: 0x0000: B6 CA 09 93 BF 2C 05 66 9D C5 AF 67 0F 64 2E 31 
02:32:08: 0x0010: 67 E4 2A EA 82 3E F7 63 8F 01 73 10 14 4A 24 ED 
02:32:08: 0x0020: 65 8F 59 D8 23 BC F3 A8 48 7D 1A 08 09 BF A3 A8 
02:32:08: 0x0030: D6 D2 5B C4 A7 36 C4 A9 28 F0 6C 5D A1 3B 92 A2 
02:32:08: 0x0040: BC 99 CC 1F C9 74 F9 FA 76 83 ED D5 26 B4 92 EE 
02:32:08: 0x0050: DD EA 50 81 C6 29 43 4F 73 DA 56 C2 29 AF 05 53 
02:32:08: CMTS sent AUTH response.
02:32:08: CMTS Received TEK REQ.
02:32:08: Created a new key for SID 2.
02:32:08: CMTS sent KEY response.

Related Commands

Command
Description

debug cable bpiatp

Displays debugging information about the BPI-related messages that the CMTS sends or receives.

debug cable interface

Enables debugging output for a specific cable interface.

debug cable keyman

Displays debugging information about BPI key management.


debug cable qos

To activate quality-of-service (QoS) debugging, use the debug cable qos command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug cable qos

no debug cable qos

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

11.3NA

This command was introduced.


Usage Guidelines

This command activates debugging of QoS. When this command is activated, any messages related to QoS parameters are displayed on the Cisco CMTS console.

Examples

The following is typical output from the debug cable qos command:

CMTS_QOS_LOG_NO_MORE_QOS_INDEX
Modems cannot add more entries to the class of service table.
CMTS_QOS_LOG_NOMORE_QOSPRF_MEM
Memory allocation error when creating class of service table entry.
CMTS_QOS_LOG_NO_CREATION_ALLOWED
Class of service entry cannot be created by modem.  Use CLI or SNMP
interface instead of the modem's TFTP configuration file.
CMTS_QOS_LOG_CANNOT_REGISTER_COS_SID
A service identifier (SID) could not be assigned to the registering modem.
CMTS_QOS_LOG_CANNOT_DEREGISTER_COS_SID
The modem's service identifier (SID) was already removed.
CMTS_QOS_LOG_MSLOT_TIMEBASE_WRAPPED
The 160 KHz timebase clock drives a 26-bit counter which wraps around
approximately every 7 minutes.  This message is generated every time it
wraps around.

debug cable range

To display ranging messages from CMs on the HFC network, use the debug cable range command in privileged EXEC mode. To disable debugging output, the no form of the command.

debug cable range

no debug cable range

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

11.3NA

This command was introduced.


Usage Guidelines

This command activates debugging of ranging messages from CMs on the HFC network. When this command is activated, any ranging messages generated when CMs request or change their upstream frequencies are displayed on the Cisco CMTS console. Use this command to display the details of the initial and station maintenance procedures. The initial maintenance procedure is used for link establishment. The station maintenance procedure is used for link keepalive monitoring.

Examples

The following shows typical output from the debug cable range command.

Got a ranging request
SID value is 0 on Interface Cable3/0/U0
CM mac address 00:10:7B:43:AA:21 Timing offset is 3312
3E 1E 3F FF 00 00 59 BF 01 15 F8 01 A7 00 0C F0

The following output shows typical output when a CM first seeks to establish a link to the Cisco CMTS. The service identifier (SID) value of 0 indicates that the modem has no assigned SID. The CM mac address is the MAC address of the modem's radio frequency (RF) interface, not its Ethernet interface. The Timing offset is a measure of the distance between the modem and the Cisco CMTS, expressed in 10.24 MHz clocks. This value is adjusted down to zero by the maintenance procedures. The first 16 bytes of the prepended header of the message are dumped in hexadecimal.

CM mac address 0010.7b43.aa21
found..Assigned SID #2 on Interface Cable3/0/U0
Timing offset is CF0
Power value is 15F8, or -1 dB
Freq Error = 423, Freq offset is 1692
Ranging Modem with Sid 2 on i/f : Cable3/0/U0

The following is typical output when the CM is first assigned a SID during initial maintenance:

Initial Range Message Received on Interface Cable3/0/U0
CMTS reusing old sid : 2 for modem : 0010.7b43.aa21
Timing offset is CF0
Power value is 15F8, or -1 dB
Freq Error = 423, Freq offset is 1692
Ranging Modem with Sid 2 on i/f : Cable3/0/U0

The following is typical output when the modem is reassigned the same SID during initial maintenance.

Ranging Modem with Sid 2 on i/f : Cable3/0/U0

Got a ranging request
SID value is 2 on Interface Cable3/0/U0
CM mac address 00:10:7B:43:AA:21
Timing offset is 0
Power value is 1823, or -1 dB
Freq Error = 13, Freq offset is 0
Ranging has been successful for SID 2 on Interface Cable3/0/U0

Output occurs when the modem is polled by the CMTS during station maintenance. Polling happens at a minimum rate of once every 10 seconds.

debug cable receive

To display debug messages for messages received on the upstream from a CM, use the debug cable receive command in privileged EXEC mode. To stop displaying debug messages, use the no form of this command.

debug cable receive

no debug cable receive

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(7)XR

This command was introduced.

12.1(1)T, 12.1(2)EC1

This command was disabled.

12.1(11b)EC

This command was removed.


Examples

The following command enables debugging of upstream messages:

router# debug cable receive 
CMTS debug Rx debugging is on

The debug cable receive command was disabled in Cisco IOS Release 12.1 T, 12.1 EC, and later releases, although it still appears in the CLI until Cisco IOS Release 12.1(11b)EC. To monitor the packets received from the CMs, use the debug ip packet command instead.

Because the debug ip packet command produces a large volume of messages, you must use it together with an access list to restrict the messages to a particular CM or CPE device to avoid affecting system performance. For example, the following commands would set up an access list that monitors all traffic being sent between the hosts with the two specified IP addresses:

router# configure terminal 
router(config)# access-list 150 permit ip host ip-address-1 host ip-address-2 
router(config)# access-list 150 permit ip host ip-address-2 host ip-address-1 
router(config)# exit 
router# debug ip packet 150 detail 

Related Commands

Command
Description

debug cable transmit

Enables debugging for transmitted packets.

debug ip packet

Enables debugging of IP packets received and transmitted by the router.


debug cable registration

To display debug messages for the CM registration process, use the debug cable registration command in privileged EXEC mode. To stop displaying debug messages, use the no form of this command.

debug cable registration

no debug cable registration

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(7)XR

This command was introduced.


Usage Guidelines

The debug cable registration command displays messages about the registration request and response messages sent and received by the CMTS when a CM initiates the DOCSIS registration process. To see the relevant messages, you must also enable debugging for a particular interface or CM using the debug cable interface or debug cable mac-address commands.

Examples

The following shows typical debugging output from a registration process:

router# debug cable interface c3/0 verbose 
router# debug cable registration 
CMTS registration debugging is on

Jul 4 14:31:37.471: Registration request from 0001.9659.3ef7, SID 3 on Cable3/0/U2
Jul 4 14:31:37.471: Found a network access control parameter
Jul 4 14:31:37.471: The Ntw Access Control is 1
Jul 4 14:31:37.475: This TLV is GOOD
Jul 4 14:31:37.475: Found a class of service block
Jul 4 14:31:37.475: The CLASS ID : 5
Jul 4 14:31:37.475: The MAX DS RATE : 3000000
Jul 4 14:31:37.475: The MAX US RATE : 2000000
Jul 4 14:31:37.475: This TLV is GOOD
Jul 4 14:31:37.475: Found vendor extensions
Jul 4 14:31:37.475: Cisco Vendor ID Field found(ok)
Jul 4 14:31:37.475: No. of requested phone lines is 2
Jul 4 14:31:37.475: This TLV is GOOD
Jul 4 14:31:37.475: Found vendor extensions
Jul 4 14:31:37.475: Cisco Vendor ID Field found(ok)
Jul 4 14:31:37.475: IP precedence specific subtype found
Jul 4 14:31:37.475: IP Precedence value: 0 Rate Limit: 10000
Jul 4 14:31:37.475: This TLV is GOOD
Jul 4 14:31:37.475: Found Max CPE
Jul 4 14:31:37.475: The Max CPE is 10
Jul 4 14:31:37.475: This TLV is GOOD
Jul 4 14:31:37.475: Found CM MIC
Jul 4 14:31:37.475: CM Mic: 5A D5 58 DC E8 2B 5B 24 6E 4E 69 84 17 B9 AB 36
Jul 4 14:31:37.475: This TLV is GOOD
Jul 4 14:31:37.475: Found CMTS MIC
Jul 4 14:31:37.475: CMTS Mic: A7 E4 15 6 F9 2F BA 81 FE 22 E4 92 5F 81 D4 BB
Jul 4 14:31:37.475: This TLV is GOOD
Jul 4 14:31:37.475: Found modem ip
Jul 4 14:31:37.475: The modem ip value is 10.200.69.90
Jul 4 14:31:37.475: This TLV is GOOD
Jul 4 14:31:37.475: Found modem capabilities
Jul 4 14:31:37.475: Modem Caps Length is 18
Jul 4 14:31:37.475: Modem Caps values:
Jul 4 14:31:37.475: 0x0000: 01 01 01 02 01 00 03 01 00 04 01 00 05 01 00 06
Jul 4 14:31:37.475: 0x0010: 01 00
Jul 4 14:31:37.475: Concatenation is on for this CM
Jul 4 14:31:37.475: Unknown capability type 2: Ignored
Jul 4 14:31:37.475: Unknown capability type 3: Ignored
Jul 4 14:31:37.475: Unknown capability type 4: Ignored
Jul 4 14:31:37.475: Unknown capability type 5: Ignored
Jul 4 14:31:37.475: Unknown capability type 6: Ignored
Jul 4 14:31:37.475: This TLV is GOOD
Jul 4 14:31:37.475: Finished parsing REG Request
Jul 4 14:31:37.475: Sec sids obtained for all requested classes of service
Jul 4 14:31:37.475: Performing connection admission control (CAC) for each Sid
Jul 4 14:31:37.475: CAC Status for ClassID:5 is CAC_SUCCESS
Jul 4 14:31:37.475: Building a GOOD REG-RSP
Jul 4 14:31:37.475: Adding Modem Caps to the Response to REG RSP
Jul 4 14:31:37.475: Registration Status: ok (0)
Jul 4 14:31:37.475: ClassId:5 assigned QoS Sid:3
Jul 4 14:31:37.475: Adding Service Class Data TLV:
Jul 4 14:31:37.475: 0x0000: 01 07 01 01 05 02 02 00 03
Jul 4 14:31:37.475: Adding Modem Caps to Response:
Jul 4 14:31:37.475: 0x0000: 05 03 01 01 01
Jul 4 14:31:37.475: Registration Response:
Jul 4 14:31:37.475: 0x0000: C2 00 00 29 00 00 00 01 96 59 3E F7 00 30 7B F9
Jul 4 14:31:37.475: 0x0010: 40 54 00 17 00 00 03 01 07 00 00 03 00 01 07 01
Jul 4 14:31:37.479: 0x0020: 01 05 02 02 00 03 05 03 01 01 01
Jul 4 14:31:37.479: Registration Response Transmitted 

The following example shows what can occasionally occur when a shared secret has been implemented. Some CMs calculate the MD5 Message Integrity Check (MIC) over the length of the registration TLV parameters as well as the length of the shared secret itself, while other CMS calculate the MIC value only over the length of the registration TLV parameters. The Cisco CMTS attempts to verify the MIC and shared secret values using the first technique, and if that fails, the CMTS then uses the second technique to verify the CM.

Jun 28 12:17:36.171: Registration request from 00c0.abcd.ef01, SID 58 on Cable5/0/U0
Jun 28 12:17:36.171: Found Network Access TLV
Jun 28 12:17:36.171: Found Class Of Service TLV Block
Jun 28 12:17:36.171: Found Max CPEs TLV
Jun 28 12:17:36.171: Found TFTP Server Provisioned CM Address TLV
Jun 28 12:17:36.171: Found CM-MIC TLV
Jun 28 12:17:36.171: Found CMTS-MIC TLV
Jun 28 12:17:36.171: Found Modem Capabilities TLV
Jun 28 12:17:36.171: Found CM IP Address TLV
Jun 28 12:17:36.171: Computing CMTS-MIC to validate REG-REQ data.
Jun 28 12:17:36.171: CMTS_MIC(rfc2104) failed text + key
Jun 28 12:17:36.171: CMTS_MIC(rfc2104) passed
Jun 28 12:17:36.171: REG-RSP Status : ok (0)
Jun 28 12:17:36.171: Registration Response Transmitted

The following example shows typical output when a CM attempts to come online without downloading a DOCSIS configuration file from a TFTP server through the Cisco CMTS cable interface, when the cable tftp-enforce command has been used.

Router# debug cable interface c3/0 verbose 
Router# debug cable registration 
CMTS registration debugging is on

May 14 22:33:21.474: Registration request from 5555.7366.12fb, SID 2 on Cable3/0/U0
May 14 22:33:21.474: Cable Modem sent Registration Request without attempting TFTP

SLOT 3/0: May 14 22:33:21.474: %UBR7200-4-REGISTRATION_BEFORE_TFTP: 
<133>CMTS[Cisco]:<????????> Registration request unexpected: Cable Modem did not attempt 
TFTP. CM Mac Addr <5555.7366.12fb>
Registration failed for Cable Modem 5555.7366.12fb on interface Cable3/0/U0:
               CoS/Sflow/Cfr/PHS failed in REG-REQ
May 14 22:33:21.474: REG-RSP Status : failure (2)
May 14 22:33:21.474: Registration Response:
May 14 22:33:21.474: 0x0000: C2 00 00 1B 00 00 00 50 73 4E B4 19 00 05 00 E0
May 14 22:33:21.474: 0x0010: 56 AC 00 09 00 00 03 01 07 00 00 02 02
May 14 22:33:21.474: Registration Response Transmitted

Tip To monitor a specific CM when it comes online, use the debug cable mac-address, debug cable mac-protocol, and debug cable registration commands.


Related Commands

Command
Description

debug cable interface

Enables debugging output for a specific cable interface.

debug cable mac-protocol

Displays debugging output for the MAC layer protocol.

debug cable mac-scheduler

Displays debugging output for the MAC layer scheduler and admission control activities.

show controllers cable

Displays interface controller information for the specified slot.


debug cable remote-query

To display debug messages for remote modem queries, use the debug cable remote-query command in privileged EXEC mode. To stop displaying debug messages, use the no form of this command.

debug cable remote-query

no debug cable remote-query

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(7)XR, 12.1(2)T

This command was introduced.

12.1(2)EC1

Support for this command was added to the 12.1 EC train.

12.2(4)BC1b

Support for this command was added to the 12.2 BC train.


Examples

The following example shows typical debugging output for a successful poll of the CMs:

router# debug cable remote-query
remote-query debugging is on
.
For IP address 209.165.200.223
Nov 10 15:56:50.241: docsIfSignalQualityEntry.5.4 = 380
Nov 10 15:56:50.241: docsIfMibObjects.2.2.1.3.2 = 360
Nov 10 15:56:50.245: docsIfDownstreamChannelEntry.6.4 = -30
Nov 10 15:56:50.245: docsIfUpstreamChannelEntry.6.3 = 12422
Nov 10 15:56:50.249: docsIfSignalQualityEntry.6.4 = 0
Nov 10 15:56:50.477:

The following example shows typical debugging output when the waiting queue at the CMTS is empty:

SNMP proxy exec got event, but queue is empty

The following example shows typical debugging output when you try to modify the polling interval or community string while the polling in is progress:

Community string if modified will not be reflected 

Note The polling interval will be changed but to change the community string, you must unconfigure the snmp-server community command and reconfigure it with the new community string.


Related Commands

Command
Description

cable modem remote-query

Enables and configures the remote-query feature to gather CM performance statistics on the CMTS.

show cable modem remote-query

Displays the statistics accumulated by the remote-query feature.

snmp-server enable traps cable

Enables traps that are sent when the remote polling of CMs has been completed.


debug cable reset

To display debugging messages when cable interfaces are reset due to the complete loss of received packets, use the debug cable reset command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug cable reset

no debug cable reset

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

11.3NA

This command was introduced.


Usage Guidelines

This command activates display of reset messages from cable interfaces.

Examples

The following shows typical output from the debug cable reset command:

Router# debug cable reset 
CMTS reset debugging is on
Router# 

Resetting CMTS interface.  Num SIDs = 32 Ranging count = 10
    Elapsed time: 21 seconds 

debug cable rfmib

To display debugging messages about when the DOCSIS-IF-MIB MIB is updated, use the debug cable rfmib command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug cable rfmib

no debug cable rfmib

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.2(15)BC1

This command was introduced.


Usage Guidelines

This command displays debugging messages when the counters in the DOCSIS-IF-MIB are updated.


Note For more information about the information displayed by this command, see RFC 2670 and the DOCS-IF-MIB MIB at the following URL:

http://www.cisco.com/go/mibs


Examples

The following shows typical output from the debug cable rfmib command:

Router# debug cable rfmib 
CMTS RFMIB debugging is on
Router# 

CMTS is calculating utilization.

Calculating all utilization data.

Polling and calculating all channels utilization data.

Polling and calculating all channels utilization data.

Cable7/0/0 DS
cur_snmp_ifOutOctets 29282580
cur_snmp_total_bytes 3348841605
last_snmp_ifOutOctets 27327636
last_snmp_total_bytes 3126121018
Cable7/0/0 DS, delta_outoctets 1954944, delta_total_bytes 222720587, chan_utilization 1

Cable7/0/0 US 2
cur_snmp_total_ms 36065552
cur_snmp_ucast_grnt_ms 11287
cur_snmp_used_cntn_ms 1238
last_snmp_total_ms 33665428
last_snmp_ucast_grnt_ms 10807
last_snmp_used_cntn_ms 1238
Cable7/0/0 US 2 delta_total_ms 2400124, delta_ucast_grnt_ms 480, delta_used_cntn_ms 0, 
chan_utilization 0 

debug cable service-ds-selection

To enable the debugging for downstream selection, use the debug cable service command in privileged EXEC mode. To disable debugging for downstream-selection, use the no form of the command.

debug cable service-ds-selection {event|timer}

no debug cable service {event|timer}

Syntax Description

event

Enables debug messages for Cable downstream selection events.

timer

Enables debug messages for Cable downstream selection timer.


Command Default

No debug messages for downstream selection are enabled.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.3(23)BC

This command was introduced for the Cisco uBR10012 router.


Usage Guidelines

The debug cable service command is intended for use by Cisco Systems technical support personnel.

Examples

The following example shows how to enable debugging for downstream selection events:

Router debug cable service-ds-selection event

Related Commands

Command

Description

test cable voice

Manually set voice tag of a cable modem to test downstream channel selection for a voice-enabled modem.


debug cable specmgmt

To debug spectrum management (frequency agility) on the HFC network, use the debug cable specmgmt command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug cable specmgmt

no debug cable specmgmt

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

11.3NA

This command was introduced.

12.0(4)XI

This command was removed and replaced by the debug cable hw-spectrum command.


Usage Guidelines

This command activates debugging of spectrum management (frequency agility) on the HFC network. When this command is activated, any messages generated due to spectrum group activity will be displayed on the Cisco CMTS console. Spectrum group activity can be additions or changes to spectrum groups, or frequency and power lever changes controlled by spectrum groups.

Examples

The following shows sample output from the debug cable specmgmt command:

Router# debug cable specmgmt  
 CMTS specmgmt debugging is on
Router# 
reassign-blind: U0 not present or shutdown 

debug cable startalloc

To debug channel allocations on the HFC network, use the debug cable startalloc command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug cable startalloc

no debug cable startalloc

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

11.3NA

This command was introduced.


Usage Guidelines

This command activates debugging of the channel allocations on the HFC network. When this command is activated, any messages generated when channels are allocated to CMs on the HFC network are displayed on the Cisco CMTS console.


Caution This command should be used for development testing only, not in production setting.

Examples

The following shows sample output from the debug cable startalloc command:

Router# debug cable startalloc 
Router# 
 00:53:27: Cable3/U0 MAP startalloc adjusted by 1 mslots
 00:53:27: Cable4/U0 MAP startalloc adjusted by 3 mslots
 00:53:27: Cable3/U0 MAP startalloc adjusted by 5 mslots
 00:53:27: Cable4/U0 MAP startalloc adjusted by 4 mslots
 00:53:28: Cable3/U0 MAP startalloc adjusted by 4 mslots
 00:53:28: Cable4/U0 MAP startalloc adjusted by 5 mslots


debug cable subscriber-monitoring

To display enforce-rule debug messages for subscriber traffic management on the Cisco CMTS routers, use the debug cable subscriber-monitoring command in privileged EXEC mode. To stop the display of debug messages, use the no form of this command.

debug cable subscriber-monitoring

no debug cable subscriber-monitoring

Syntax Description

This command has no arguments or keywords.

Command Default

No default behavior or values

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(15)BC1

This command was introduced.

12.3(9a)BC

This command was integrated into Cisco IOS Release 12.3(9a)BC.

12.2(33)SCA

This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.


Usage Guidelines

Because this command can produce a large volume of debug information, use this command only when you have also enabled debugging for a particular interface or MAC address, using the debug cable interface and debug cable mac-address commands, respectively.

Examples

The following example shows how to enable debugging output using the debug cable subscriber-monitoring command:

Router# debug cable subscriber-monitoring 

subscriber monitoring debugging is on 

cmts_enf_map_sm_to_qos: enforced=9, penalty_life_time=10080 
cmts_enf_map_sm_to_qos: Found rule #=9, rule_name=name, dir=US 
cmts_enf_map_sm_to_registered_qos1: us smp=0x00, ds smp=0x1F

Related Commands

Command
Description

cable qos enforce-rule

Creates an enforce-rule to enforce a particular QoS profile for subscriber traffic management and enters enforce-rule configuration mode.

debug cable interface

Enables debugging output for a specific cable interface.

debug cable mac-address

Enables debugging output for the cable modems that match the specified hardware MAC address or range of addresses.

show cable qos enforce-rule

Displays the QoS enforce-rules that are currently defined.


debug cable telco-return

To display debug messages for telco-return events, use the debug cable telco-return command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug cable telco-return

no debug cable telco-return

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(4)XI

This command was introduced.


Usage Guidelines

This command is supported only in images that support telco-return operation (-t-).

Examples

The following is sample output from the debug cable telco-return and debug cable telco-return msg commands:

Router# debug cable telco-return 
Router# debug cable telco-return msg 
01:17:31:Sending TCD message:
  TLV type = 1
  TLV len = 56
   Factory default flag: 1
   Phone number 1:       5551212 
   Service provider name:uBR7246 
   Connection threshold: 10
   Username:             guest 
   Password:             password 
   DHCP authenticate:    1
   DHCP server:          10.10.255.255
   PPP authentication:   2
   Manual dial:          1
Sending TSI message:
   DS channel IP address:  10.10.10.10
   Registration IP address:10.10.10.10
   CMTS boot time:         3080626752
   DS channel ID:          0
   Epoch:                  1

Related Commands

Command
Description

debug cable telco-return msg

Displays the Telephony Channel Descriptor (TCD) and Termination System Information (TSI) messages.


debug cable telco-return msg

To display the Telephony Channel Descriptor (TCD) and Termination System Information (TSI) messages that are sent downstream to the telco-return CMs, use the debug cable telco-return msg command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug cable telco-return msg

no debug cable telco-return msg

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(4)XI

This command was introduced.


Usage Guidelines

This command is supported only in images that support telco-return operation (-t-).

Examples

The following is sample output from the debug cable telco-return msg command:

Router# debug cable telco-return 
Router# debug cable telco-return msg 
01:17:31:Sending TCD message:
  TLV type = 1
  TLV len = 56
   Factory default flag: 1
   Phone number 1:       5551212 
   Service provider name:uBR7246 
   Connection threshold: 10
   Username:             guest 
   Password:             password 
   DHCP authenticate:    1
   DHCP server:          10.10.255.255
   PPP authentication:   2
   Manual dial:          1
Sending TSI message:
   DS channel IP address:  10.10.10.10
   Registration IP address:10.10.10.10
   CMTS boot time:         3080626752
   DS channel ID:          0
   Epoch:                  1

Related Commands

Command
Description

debug cable telco-return

Displays debug messages for telco-return events.


debug cable tlvs

To display the Type/Length/Value encodings (TLVs) parsed by the DOCSIS 1.1 TLV parser/encoder, use the debug cable tlvs command in privileged EXEC mode. The no form of this command disables debugging output.

debug cable tlvs

no debug cable tlvs

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(4)CX

This command was introduced.

12.2(4)BC1

This command was supported on the Cisco uBR7100 series and Cisco uBR10012 universal broadband routers.


Usage Guidelines

This command displays the TLVs for service flow encodings, classifier encodings, and PHS rules. Do not use this command when you have a large number of active CMs on your network because it could generate a huge amount of output to the console port.

Examples

The following example shows typical output for the debug cable tlvs command:

Router# debug cable tlvs 
CMTS TLV encodings debugging is on

 00:02:06: Registration request from 0003.e350.9b8d, SID 3 on Cable3/0/U0
 00:02:06: TLV-Block Bytes:
 00:02:06: 0x0000: 03 01 01 12 01 10 1D 01 00 16 0F 01 01 01 03 02 
 00:02:06: 0x0010: 00 04 09 06 03 04 0A 0A 00 02 18 07 01 02 00 01 
 00:02:06: 0x0020: 06 01 07 18 07 01 02 00 02 06 01 07 18 07 01 02 
 00:02:06: 0x0030: 00 03 06 01 01 18 07 01 02 00 04 06 01 01 19 07 
 00:02:06: 0x0040: 01 02 00 09 06 01 07 19 07 01 02 00 0A 06 01 01 
 00:02:06: 0x0050: 19 07 01 02 00 0B 06 01 01 19 07 01 02 00 0C 06 
 00:02:06: 0x0060: 01 01 06 10 33 E0 BA 7A DA 81 1B 9B 8E 37 F5 33 
 00:02:06: 0x0070: 1C 84 E7 4D 07 10 01 0C C8 DB F9 26 B7 D2 DD 0A 
 00:02:06: 0x0080: 00 58 1E 14 15 FD 0C 04 0A 0A 00 02 08 03 00 03 
 00:02:06: 0x0090: E3 05 21 02 01 01 03 01 01 04 01 01 05 01 00 06 
 00:02:06: 0x00A0: 01 01 07 01 00 08 01 04 09 01 00 0A 01 01 0B 01 
 00:02:06: 0x00B0: 08 01 01 01 
 00:02:06: Found Network Access TLV
 00:02:06: Ntw Access Control : 1
 00:02:06: Found Max CPEs TLV
 00:02:06: Maximum Number Of CPEs : 16
 00:02:06: Found Privacy Enable TLV
 00:02:06: Privacy Enable : 0
 00:02:06: Found Upstream Packet Classifier TLV
 00:02:06:       Classifier Reference : 1
 00:02:06:       Service-Flow Reference : 4
 00:02:06:       Found IP Packet Classifier Sub-TLV
 00:02:06:               Source Address : 10.10.0.2
 00:02:06: Found Upstream Service Flow TLV
 00:02:06:       Service Flow Reference : 1
 00:02:06:       QoS Parameter Set Type : 0x7
 00:02:06: Found Upstream Service Flow TLV
 00:02:06:       Service Flow Reference : 2
 00:02:06:       QoS Parameter Set Type : 0x7
 00:02:06: Found Upstream Service Flow TLV
 00:02:06:       Service Flow Reference : 3
 00:02:06:       QoS Parameter Set Type : 0x1
 00:02:06: Found Upstream Service Flow TLV
 00:02:06:       Service Flow Reference : 4
 00:02:06:       QoS Parameter Set Type : 0x1
 00:02:06: Found Downstream Service Flow TLV
 00:02:06:       Service Flow Reference : 9
 00:02:06:       QoS Parameter Set Type : 0x7
 00:02:06: Found Downstream Service Flow TLV
 00:02:06:       Service Flow Reference : 10
 00:02:06:       QoS Parameter Set Type : 0x1
 00:02:06: Found Downstream Service Flow TLV
 00:02:06:       Service Flow Reference : 11
 00:02:06:       QoS Parameter Set Type : 0x1
 00:02:06: Found Downstream Service Flow TLV
 00:02:06:       Service Flow Reference : 12
 00:02:06:       QoS Parameter Set Type : 0x1
 00:02:06: Found CM-MIC TLV
 00:02:06: CM MIC:
 00:02:06: 0x0000: 33 E0 BA 7A DA 81 1B 9B 8E 37 F5 33 1C 84 E7 4D 
 00:02:06: Found CMTS-MIC TLV
 00:02:06: CMTS MIC:
 00:02:06: 0x0000: 01 0C C8 DB F9 26 B7 D2 DD 0A 00 58 1E 14 15 FD 
 00:02:06: Found CM IP Address TLV
 00:02:06: Modem IP Address : 10.10.0.2
 00:02:06: Vendor Id:
 00:02:06: 0x0000: 00 03 E3 
 00:02:06: Found Modem Capabilities TLV
 00:02:06:       DOCSIS Version : 1
 00:02:06:       Fragmentation Support : 1
 00:02:06:       Payload Header Suppresion Support : 1
 00:02:06:       IGMP Support : 0
 00:02:06:       Privacy Support : 1
 00:02:06:       Downstream SAID Support : 0
 00:02:06:       Upstream SID Support : 4
 00:02:06:       Optional Filtering Support : 0
 00:02:06:       Tx Equalizer Taps Per Symbol : 1
 00:02:06:       Tx Equalizer Taps Support : 8
 00:02:06:       Concatenation Support : 1
 00:02:06: Performing admission control check
 00:02:06: Added Modem Capabilities TLV:
 00:02:06: 0x0000: 05 21 02 01 01 03 01 01 04 01 01 05 01 00 06 01 
 00:02:06: 0x0010: 01 07 01 00 08 01 04 09 01 00 0A 01 01 0B 01 08 
 00:02:06: 0x0020: 01 01 01 
 00:02:06: Sfref = 1, SFID = 7
 00:02:06: Added Service Flow Parameters TLV:
 00:02:06: 0x0000: 18 11 01 02 00 01 02 04 00 00 00 07 03 02 00 03 
 00:02:06: 0x0010: 06 01 07 
 00:02:06: Sfref = 2, SFID = 43
 00:02:06: Added Service Flow Parameters TLV:
 00:02:06: 0x0000: 18 11 01 02 00 02 02 04 00 00 00 2B 03 02 00 0B 
 00:02:06: 0x0010: 06 01 07 
 00:02:06: Sfref = 3, SFID = 44
 00:02:06: Added Service Flow Parameters TLV:
 00:02:06: 0x0000: 18 0D 01 02 00 03 02 04 00 00 00 2C 06 01 01 
 00:02:06: Sfref = 4, SFID = 45
 00:02:06: Added Service Flow Parameters TLV:
 00:02:06: 0x0000: 18 0D 01 02 00 04 02 04 00 00 00 2D 06 01 01 
 00:02:06: Sfref = 9, SFID = 8
 00:02:06: Added Service Flow Parameters TLV:
 00:02:06: 0x0000: 19 0D 01 02 00 09 02 04 00 00 00 08 06 01 07 
 00:02:06: Sfref = 10, SFID = 46
 00:02:06: Added Service Flow Parameters TLV:
 00:02:06: 0x0000: 19 0D 01 02 00 0A 02 04 00 00 00 2E 06 01 01 
 00:02:06: Sfref = 11, SFID = 47
 00:02:06: Added Service Flow Parameters TLV:
 00:02:06: 0x0000: 19 0D 01 02 00 0B 02 04 00 00 00 2F 06 01 01 
 00:02:06: Sfref = 12, SFID = 48
 00:02:06: Added Service Flow Parameters TLV:
 00:02:06: 0x0000: 19 0D 01 02 00 0C 02 04 00 00 00 30 06 01 01 
 00:02:06: Cfr-ref = 1, CFID = 1, SF-ref 4, SFID 45
 00:02:06: Added Classifier Parameters TLV:
 00:02:06: 0x0000: 16 19 01 01 01 03 02 00 04 02 02 00 01 04 04 00 
 00:02:06: 0x0010: 00 00 2D 09 06 03 04 0A 0A 00 02 
 00:02:06: REG-RSP Status : ok (0), REG-ACK required from CM (0)
 00:02:06: Reg-Ack wait state successfully created
 00:02:06: Registration Response:
 00:02:06: 0x0000: C2 00 00 D9 00 00 00 03 E3 50 9B 8D 00 00 00 00 
 00:02:06: 0x0010: 30 30 00 C7 00 00 03 01 07 00 00 03 00 05 21 02 
 00:02:06: 0x0020: 01 01 03 01 01 04 01 01 05 01 00 06 01 01 07 01 
 00:02:06: 0x0030: 00 08 01 04 09 01 00 0A 01 01 0B 01 08 01 01 01 
 00:02:06: 0x0040: 18 11 01 02 00 01 02 04 00 00 00 07 03 02 00 03 
 00:02:06: 0x0050: 06 01 07 18 11 01 02 00 02 02 04 00 00 00 2B 03 
 00:02:06: 0x0060: 02 00 0B 06 01 07 18 0D 01 02 00 03 02 04 00 00 
 00:02:06: 0x0070: 00 2C 06 01 01 18 0D 01 02 00 04 02 04 00 00 00 
 00:02:06: 0x0080: 2D 06 01 01 19 0D 01 02 00 09 02 04 00 00 00 08 
 00:02:06: 0x0090: 06 01 07 19 0D 01 02 00 0A 02 04 00 00 00 2E 06 
 00:02:06: 0x00A0: 01 01 19 0D 01 02 00 0B 02 04 00 00 00 2F 06 01 
 00:02:06: 0x00B0: 01 19 0D 01 02 00 0C 02 04 00 00 00 30 06 01 01 
 00:02:06: 0x00C0: 16 19 01 01 01 03 02 00 04 02 02 00 01 04 04 00 
 00:02:06: 0x00D0: 00 00 2D 09 06 03 04 0A 0A 00 02 
 00:02:06: Registration Response Transmitted
 00:02:06: Registration acknowledgement from 0003.e350.9b8d, SID 3 on Cable3/0/U0
 00:02:06: REG-ACK confirmation code : 0 

Related Commands

debug cable dynsrv

Displays debugging information about DOCSIS 1.1 dynamic service flow messages.

debug cable interface

Enables debugging on a specific cable interface.

debug cable mac-address

Enables debugging for MAC-layer information for a specific CM.


debug cable tod

To display debugging for the local time-of-day (ToD) server on the Cisco CMTS, use the debug cable tod command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug cable tod

no debug cable tod

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

11.3 NA

This command was introduced.

12.2(11)BC2

Support for this command was added to the Release 12.2 BC train.


Usage Guidelines

This command displays information about the operation of the ToD server that is onboard the Cisco CMTS. Before this command will display any output, you must also use the debug cable interface command to enable debugging operations on each interface that has CMs you wish to monitor.

Examples

The following example shows typical output for the debug cable tod command:

Router# debug cable interface c3/0 
Router# debug cable tod 
TOD server debugging is on
Router# 

000104: Jun  8 05:48:08.783: tod: Received request from 10.1.1.27 (0001.9659.4411) on 
Cable3/0
000105: Jun  8 05:48:15.015: tod: Received request from 10.1.1.32 (0030.96f9.65d9) on 
Cable3/0
000106: Jun  8 05:48:16.363: tod: Received request from 10.3.3.10 (0001.9659.43fd) on 
Cable3/0
000107: Jun  8 05:48:17.335: tod: Received request from 10.2.2.43 (0002.fdfa.0a35) on 
Cable3/0

For telco-return CMs, the ToD server verifies that the IP address for the CM making the ToD request is on the correct cable interface, so as to prevent IP spoofing. If the IP address and interface do not match, the following message is printed:

000104: Jun  8 05:48:08.783: tod: Cant match output i/f for telco return 

Related Commands

debug cable interface

Enables debugging on a specific cable interface.

debug cable mac-address

Enables debugging for MAC-layer information for a specific CM.


debug cable transmit

To display debug messages for messages that the CMTS transmits on the cable interface, use the debug cable transmit command in privileged EXEC mode. To stop displaying debug messages, use the no form of this command.

debug cable transmit

no debug cable transmit

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.0(7)XR

This command was introduced.

12.1(1)T, 12.1(2)EC1

This command was disabled.

12.1(11b)EC

This command was removed.


Examples

The following command enables debugging of messages that the CMTS transmits on the cable interface:

Router# debug cable transmit 
CMTS debug transmit debugging is on 
Router# 

The debug cable transmit command was disabled in Cisco IOS Release 12.1 T, 12.1 EC, and later releases, although it still appears in the CLI until Cisco IOS Release 12.1(11b)EC. To monitor the packets transmitted by the CMs, use the debug ip packet command instead.

Because the debug ip packet command produces a large volume of messages, you must use it together with an access list to restrict the messages to a particular CM or CPE device to avoid affecting system performance. For example, the following commands would set up an access list that monitors all traffic being sent between the hosts with the two specified IP addresses:

router# configure terminal 
router(config)# access-list 150 permit ip host ip-address-1 host ip-address-2 
router(config)# access-list 150 permit ip host ip-address-2 host ip-address-1 
router(config)# exit 
router# debug ip packet 150 detail 

Related Commands

Command
Description

debug cable receive

Enables debugging for received packets.

debug ip packet

Enables debugging of IP packets received and transmitted by the router.


debug cable ucc

To debug upstream channel change (UCC) messages generated when CMs request or are assigned a new channel, use the debug cable ucc command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug cable ucc

no debug cable ucc

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

11.3NA

This command was introduced.


Usage Guidelines

This command activates debugging of any upstream channel change (UCC) messages generated when CMs request or are assigned a new channel. When this command is activated, any messages related to upstream channel changes are displayed on the Cisco CMTS console.

Examples

The following is typical output from the debug cable ucc command:

Router# debug cable ucc 
Router# 
SID 2 has been registered
Mac Address of CM for UCC 
  00:0E:1D:D8:52:16
UCC Message Sent to CM 
Changing SID 2 from upstream channel 1 to upstream channel 2 

Related Commands

Command
Description

debug cable ucd

Enables debugging for UCD messages.


debug cable ucd

To debug upstream channel descriptor (UCD) messages, use the debug cable ucd command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug cable ucd

no debug cable ucd

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

11.3NA

This command was introduced.


Usage Guidelines

This command activates debugging of any upstream channel descriptor (UCD) messages. UCD messages contain information about upstream channel characteristics and are sent to the CMs on the HFC network. Cable modems that are configured to use enhanced upstream channels use these UCD messages to identify and select an enhanced upstream channel to use. When this command is activated, any messages related to upstream channel descriptors are displayed on the Cisco CMTS console.

Examples

The following is typical output from the debug cable ucd command:

UCD MESSAGE
-----------
  FRAME HEADER
    FC                        - 0xC2 ==
    MAC_PARM                  - 0x00
    LEN                       - 0xD3
  MAC MANAGEMENT MESSAGE HEADER
    DA                        - 01E0.2F00.0001
    SA                        - 0009.0CEF.3730
    msg LEN                   - C1
    DSAP                      - 0
    SSAP       t               - 0
    control                   - 03
    version                   - 01
    type                      - 02 ==
  US Channel ID               - 1
  Configuration Change Count  - 5
  Mini-Slot Size              - 4
  DS Channel ID               - 1
  Symbol Rate                 - 8
  Frequency                   - 10000000
  Preamble Pattern            - CC CC CC CC CC CC CC CC CC CC CC CC CC
 CC 0D 0D
  Burst Descriptor 0
    Interval Usage Code       - 1
    Modulation Type           - 1 == QPSK
    Differential Encoding     - 2 == OFF
    Preamble Length           - 64
    Preamble Value Offset     - 56
    FEC Error Correction      - 0
    FEC Codeword Length       - 16
    Scrambler Seed            - 0x0152
    Maximum Burst Size        - 2
    Guard Time Size           - 8
    Last Codeword Length      - 1 == FIXED
    Scrambler on/off          - 1 == ON
  Burst Descriptor 1
    Interval Usage Code       - 3
    Modulation Type           - 1 == QPSK
    Differential Encoding     - 2 == OFF
    Preamble Length           - 128
    Preamble Value Offset     - 0
    FEC Error Correction      - 5
    FEC Codeword Length       - 34
    Scrambler Seed            - 0x0152
    Maximum Burst Size        - 0
    Guard Time Size           - 48
    Last Codeword Length      - 1 == FIXED
    Scrambler on/off          - 1 == ON
  Burst Descriptor 2
    Interval Usage Code       - 4
    Modulation Type           - 1 == QPSK
    Differential Encoding     - 2 == OFF
    Preamble Length           - 128
    Preamble Value Offset     - 0
    FEC Error Correction      - 5
    FEC Codeword Length       - 34
    Scrambler Seed            - 0x0152
    Maximum Burst Size        - 0
    Guard Time Size           - 48
    Last Codeword Length      - 1 == FIXED
    Scrambler on/off          - 1 == ON
  Burst Descriptor 3
    Interval Usage Code       - 5
    Modulation Type           - 1 == QPSK
    Differential Encoding     - 2 == OFF
    Preamble Length           - 72
    Preamble Value Offset     - 48
    FEC Error Correction      - 5
    FEC Codeword Length       - 75
    Scrambler Seed            - 0x0152
    Maximum Burst Size        - 0
    Guard Time Size           - 8
    Last Codeword Length      - 1 == FIXED
    Scrambler on/off          - 1 == ON
The UCD MESSAGE is :
0xC2 0x00 0x00 0xD3 0x00 0x00 0x01 0xE0
0x2F 0x00 0x00 0x01 0x00 0x09 0x0C 0xEF
0x37 0x30 0x00 0xC1 0x00 0x00 0x03 0x01
0x02 0x00 0x01 0x05 0x04 0x01 0x01 0x01
0x08 0x02 0x04 0x00 0x98 0x96 0x80 0x03
0x10 0xCC 0xCC 0xCC 0xCC 0xCC 0xCC 0xCC
0xCC 0xCC 0xCC 0xCC 0xCC 0xCC 0xCC 0x0D
0x0D 0x04 0x25 0x01 0x01 0x01 0x01 0x02
0x01 0x02 0x03 0x02 0x00 0x40 0x04 0x02
0x00 0x38 0x05 0x01 0x00 0x06 0x01 0x10
0x07 0x02 0x01 0x52 0x08 0x01 0x02 0x09
0x01 0x08 0x0A 0x01 0x01 0x0B 0x01 0x01
0x04 0x25 0x03 0x01 0x01 0x01 0x02 0x01
0x02 0x03 0x02 0x00 0x80 0x04 0x02 0x00
0x00 0x05 0x01 0x05 0x06 0x01 0x22 0x07
0x02 0x01 0x52 0x08 0x01 0x00 0x09 0x01
0x30 0x0A 0x01 0x01 0x0B 0x01 0x01 0x04
0x25 0x04 0x01 0x01 0x01 0x02 0x01 0x02
0x03 0x02 0x00 0x80 0x04 0x02 0x00 0x00
0x05 0x01 0x05 0x06 0x01 0x22 0x07 0x02
0x01 0x52 0x08 0x01 0x00 0x09 0x01 0x30
0x0A 0x01 0x01 0x0B 0x01 0x01 0x04 0x25
0x05 0x01 0x01 0x01 0x02 0x01 0x02 0x03
0x02 0x00 0x48 0x04 0x02 0x00 0x30 0x05
0x01 0x05 0x06 0x01 0x4B 0x07 0x02 0x01
0x52 0x08 0x01 0x00 0x09 0x01 0x08 0x0A
0x01 0x01 0x0B 0x01 0x01

Related Commands

Command
Description

debug cable ucc

Enables debugging for UCC messages.



debug cable upconverter

To enable hardware debugging of an internal upconverter, use the debug cable upconverter command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug cable upconverter

no debug cable upconverter

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(5)EC

This command was introduced for the Cisco uBR7100 series routers.

12.2(11)CY

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


Usage Guidelines

This command activates hardware debugging of the internal upconverter that is onboard the Cisco uBR7100 series or the Cisco uBR10-MC5X20S cable interface line card on the Cisco uBR10012 router.

Examples

The following command shows how to enable the debug cable upconverter output:

Router# debug cable upconverter 
Upconverter programming debugging is on
Router# config t 
Router(config)# int c1/0 
Router(config-if)# no cable downstream rf-shutdown 
Ack failed from upconverter 
Card does not have upconverter? 
Error in upconverter!
Router(config-if)# 

Related Commands

Command
Description

cable downstream rf-power

Configures the desired RF output power on the integrated upconverter.

cable downstream rf-shutdown

Enables or disables the RF output from the integrated upconverter.

show controllers cable

Displays status and configuration information for the cable interface. On Cisco uBR7100 series routers, this includes information about the integrated upconverter.


debug cable us-adm-ctrl

To enable debugging of upstream admission control activity, use the debug cable us-adm-ctrl command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug cable us-adm-ctrl

no debug cable us-adm-ctrl

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(4)CX

This command was introduced for the Cisco uBR10012 router.

12.2(4)BC1

Support for this command was added to the Release 12.2 BC train for the Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 routers.

12.2(11)CY

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


Examples

The following command shows how to enable debugging output for upstream admission control:

Router# debug cable us-adm-ctrl 
CMTS upstream admission control debugging is on

Router# show debug 
CMTS:
   CMTS upstream admission control debugging is on
Router# 

The following are the debug messages that are displayed when the CMTS does not have an admission policy, scheduling instance, or service class for a registering CM:

Null service class
Null admission policy
Null scheduler instance

The CMTS displays the following debug message when a CM requests a scheduling type that is either not defined, not recognized, or not supported:

Undefined scheduling Type 

Related Commands

Command
Description

cable upstream admission-control

Determines the percentage of overbooking allowed on the upstream channel.

debug cable mac-scheduler

Displays information for the MAC layer's scheduler and admission control activities.


debug cable wbcmts

To enable debugging information for the wideband CMTS, use the debug cable wbcmts command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug cable wbcmts [association | bpi | cli | guardian | statistics | wbka | wcd]

no debug cable wbcmts [association | bpi | cli | guardian | statistics | wbka | wcd]

Syntax Description

association

(Optional) Enables debug messages for RF to fiber-node associations.

bpi

(Optional) Enables debug messages for Baseline Privacy Interface (BPI).

cli

(Optional) Enables debug messages for wideband-related Cisco IOS CLI activity.

guardian

(Optional) Enables debug messages for DOCSIS 3.0 Downstream Channel Bonding operations performed by the modular-host line card.

ha

(Optional) Enables debug messages for wideband high availability (HA).

statistics

(Optional) Enables debug messages for wideband-related statistics.

wbka

(Optional) Enables debug messages for wideband keepalive (WBKA) operations.

wcd

(Optional) Enables debug messages with wideband channel information as conveyed in the Bonded Downstream Channel Descriptor (BDCD).


Command Default

No wideband-related debug messages are enabled.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.3(21)BC

This command was introduced for the Cisco uBR10012 router.

12.2(33)SCA

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


Usage Guidelines

The debug cable wbcmts command is intended for use by Cisco technical support personnel.


Caution Because debugging output is assigned high priority in the CPU process, it can render the system unusable. For this reason, use debug commands only to troubleshoot specific problems or during troubleshooting sessions with Cisco technical support personnel. Moreover, it is best to use debug commands during periods of lower network traffic and fewer users. Debugging during these periods decreases the likelihood that increased debug command processing overhead will affect system use.

If you specify debug cable wbcmts with no argument, generic wideband debugging messages are enabled.

Before issuing the debug cable wbcmts wcd command to display BDCD information, you must issue the debug cable interface command to enable debugging on the cable interface line card configured for DOCSIS 3.0 protocol operations. For example:

Router# debug cable interface Cable slot/subslot/port
Router# debug cable wbcmts wcd 

In the preceding example, slot/subslot/port specifies a port on a cable interface line card that has been configured for DOCSIS 3.0 protocol operations with the modular-host subslot command. The line card cable interface for which you enable debug messages with debug cable interface is the first cable interface that is up. For example, if the line card configured for DOCSIS 3.0 protocol operations is located in slot 7/0, specify interface 7/0/1 if 7/0/0 is down and 7/0/1 is up.

For information on configuring a cable interface line card for DOCSIS 3.0 protocol operations, see the modular-host subslot command.

Examples

The following example shows how to enable debug messages for RF to fiber-node associations, and shows sample output:

Router# debug cable wbcmts association 

WBCMTS Association debugging is on 
...
Router(config-fiber-node)# downstream modular-cable 3/0/0 rf-channel 0-1
Router(config-fiber-node)# end
...
Router#
*Nov 7 17:16:08.835: Remove Wideband-Cable3/0/0:0 nb_info 8/1 index 0,chanID 203 bundle 1, 
Index 203
*Nov 7 17:16:08.835: Remove Cable8/1/0 wb_info 8/1 wb_index 0, chanID 72, Index 72
*Nov 7 17:16:08.835: %SYS-5-CONFIG_I: Configured from console by console 

Router# 

The following example shows how to enable debug messages for wideband CMTS statistics, and shows sample output.

Router# debug cable wbcmts statistics

WBCMTS statistics debugging is on

Router# 
Router# show interface cable 8/1/0 service-flow 19 counters
Sfid Packets Bytes PacketDrop Bits/Sec Packet/Sec
19   0       0     0          0        0 
Router#
*Nov 7 17:28:09.815: LC SFID=19, SFID=19, Blaze_Index=23 Reading stats for SFID 1 @ index 
23 on 3/0/0 

Related Commands

Command
Description

debug c10k-jacket

Enables debugging information for the Wideband SIP.

debug cable fn

Enables debugging information for cable fiber nodes.

debug hw-module bay

Enables debugging information for a Wideband SPA.


debug cable wbcmts resiliency

To enable debugging of the resiliency operation, use the debug cable wbcmts resiliency command in privileged EXEC mode. To disable debugging output, use the no form of this command.

debug cable wbcmts resiliency

no debug cable wbcmts resiliency

Syntax Description

This command has no arguments or keywords.


Command Default

No wideband-related debug messages are enabled.

Command Modes

Privileged EXEC (#)

Command History

Release
Modification

12.2(33)SCB

This command was introduced.


Usage Guidelines

The debug cable wbcmts command is intended for use by Cisco technical support personnel.


Caution Because debugging output is assigned high priority in the CPU process, it can render the system unusable. For this reason, use debug commands only to troubleshoot specific problems or during troubleshooting sessions with Cisco technical support personnel. Moreover, it is best to use debug commands during periods of lower network traffic and fewer users. Debugging during these periods decreases the likelihood that increased debug command processing overhead will affect system use.

Related Commands

Command
Description

debug c10k-jacket

Enables debugging information for the Wideband SIP.

debug cable fn

Enables debugging information for cable fiber nodes.

debug hw-module bay

Enables debugging information for a Wideband SPA.

debug cable wbcmts

Enables debugging information for the wideband CMTS.


debug cable-modem bpkm

To display information about Baseline Privacy Interface (BPI) key management, use the debug cable-modem bpkm command in privileged EXEC mode. To disable BPI debugging, use the no form of this command.

Cisco uBR904, uBR905, uBR924, uBR925 cable access routers, Cisco CVA122 Cable Voice Adapter

debug cable-modem bpkm {errors | events | packets}

no debug cable-modem bpkm {errors | events | packets}

Syntax Description:

errors

Debugs CM privacy errors.

events

Debugs events related to cable baseline privacy.

packets

Debugs baseline privacy packets.


Command Modes

Privileged EXEC

Command History

Release
Modification

11.3(4)NA

This command was introduced for the Cisco uBR904 cable access router.

12.0(4)XI1

Support was added for the Cisco uBR924 cable access router.

12.0(5), 12.0(5)T

This command was removed from normal access.


Usage Guidelines

Baseline privacy key management exchanges take place only when both the router and the CMTS are running code images that support baseline privacy, and the privacy class of service is enabled via the configuration file that is downloaded to the cable access router. Baseline privacy code images for the router contain k1, k8, or k9 in the code image name.

In Cisco IOS Release 12.0(5) and later releases, this command is available only under the direction of TAC or field service, and should be used only while debugging CM operation. Displaying debugging messages consumes system resources, and turning on too many messages could negatively affect system performance.

Examples

The following example shows typical debug output when the CMTS does not have privacy enabled:

Router# debug cable-modem bpkm errors 

cm_bpkm_fsm(): machine: KEK, event/state: EVENT_4_TIMEOUT/STATE_B_AUTH_WAIT, new state: 
STATE_B_AUTH_WAIT

cm_bpkm_fsm(): machine: KEK, event/state: EVENT_4_TIMEOUT/STATE_B_AUTH_WAIT, new state: 
STATE_B_AUTH_WAIT

%LINEPROTO-5-UPDOWN: Line protocol on Interface cable-modem0, changed state to down
cm_bpkm_fsm(): machine: KEK, event/state: EVENT_1_PROVISIONED/STATE_A_START, new state: 
STATE_B_AUTH_WAIT

%LINEPROTO-5-UPDOWN: Line protocol on Interface cable-modem0, changed state to up
Router# 

Related Commands

Command
Description

debug cable-modem bridge

Displays bridge filter processing information.

debug cable-modem error

Displays debugging messages for the cable interface driver.

debug cable-modem interrupts

Displays information about CM interrupts.

debug cable-modem mac log

Displays comprehensive debugging messages for the cable interface MAC layer.

debug cable-modem map

Displays the timing of MAP and sync messages.



debug cable-modem bridge

To display bridge filter processing information, use the debug cable-modem bridge command in Privileged EXEC mode. To disable bridge filter debugging, use the no form of this command.

Cisco uBR904, uBR905, uBR924, uBR925 cable access routers, Cisco CVA122 Cable Voice Adapter

debug cable-modem bridge

no debug cable-modem bridge

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

11.3(4)NA

This command was introduced for the Cisco uBR904 cable access router.

12.0(4)XI1

Support was added for the Cisco uBR924 cable access router.

12.0(5), 12.0(5)T

This command was removed from normal access.


Usage Guidelines

When the interface is down, all bridge table entries learned on the Ethernet interface are set to discard because traffic is not bridged until the cable interface has completed initialization. After the interface (the line protocol) is completely up, bridge table entries learned on the Ethernet interface program the cable's MAC data filters. The cable MAC hardware filters out any received packets whose addresses are not in the filters. In this way, the cable interface only receives packets addressed to its own MAC address or an address it has learned on the Ethernet interface.

In Cisco IOS Release 12.0(5) and later releases, this command is available only under the direction of TAC or field service, and should be used only while debugging CM operation. Displaying debugging messages consumes system resources, and turning on too many messages could negatively affect system performance.

Examples

The following shows typical output for the debug cable-modem bridge command:

Router# debug cable-modem bridge 
Router# 
%LINEPROTO-5-UPDOWN: Line protocol on Interface cable-modem0, changed state to downshut
cm_tbridge_add_entry(): MAC not initialized, discarding entry: 00e0.fe7a.186fno shut
cm_tbridge_add_entry(): MAC not initialized, discarding entry: 00e0.fe7a.186f
%LINEPROTO-5-UPDOWN: Line protocol on Interface cable-modem0, changed state to up
cm_tbridge_add_entry(): Adding entry 00e0.fe7a.186f to filter 2

Related Commands

Command