Table Of Contents
Cable Commands: show cable m through show cable u
show cable mac-domain cable forwarding
show cable mac-domain cgd-associations
show cable mac-domain downstream-service-group
show cable mac-domain rcc
show cable mac-domain upstream-service-group
show cable metering-status
show cable modem
show cable modem access-group
show cable modem auth-profile
show cable modem calls
show cable modem classifiers
show cable modem cnr
show cable modem connectivity
show cable modem counters
show cable modem cpe
show cable modem docsis device-class
show cable modem docsis version
show cable modem domain-name
show cable modem errors
show cable modem extended-power
show cable modem flap
show cable modem ipv6
show cable modem mac
show cable modem maintenance
show cable modem offline
show cable modem partial-mode
show cable modem phy
show cable modem primary-channel
show cable modem primary-channel summary total
show cable modem privacy
show cable modem qos
show cable modem registered
show cable modem remote-query
show cable modem rf-adapt
show cable modem rogue
show cable modem service-type-id
show cable modem service-flow
show cable modem summary
show cable modem summary wb-rf
show cable modem type
show cable modem unregistered
show cable modem vendor
show cable modem voice
show cable modem wideband
show cable modem wideband primary-channel
show cable modem wideband rcs-status
show cable modulation-profile
show cable multicast authorization
show cable multicast db
show cable multicast debug
show cable multicast dsid
show cable multicast qos
show cable multicast statistics failure
show cable noise
show cable privacy
show cable qos enforce-rule
show cable qos permission
show cable qos profile
show cable rate-adapt
show cable rate-limit-ccf
show cable redundancy
show cable rf-adapt
show cable rf-status
show cable rsvp flow-db
show cable service-class
show cable service-voice downstream-type
show cable signal-quality
show cable spectrum-analysis
show cable spectrum-group
show cable subscriber-usage
show cable tech-support
show cable urm
show cable us-sg
Cable Commands: show cable m through show cable u
Revised: December 2011, OL-15510-14
New Commands
Command
|
Cisco IOS Software Release
|
show cable mac-domain cable forwarding
|
12.3(23)BC
|
show cable mac-domain cgd-associations
|
12.3(23)BC
|
show cable modem domain-name
|
12.2(33)SCA
|
show cable modem ipv6
|
12.2(33)SCA
|
show cable modem voice
|
12.3(23)BC
|
show cable modem primary-channel
|
12.3(23)BC
|
show cable modem type
|
12.2(33)SCA
|
show cable modem wideband primary-channel
|
12.3(23)BC
|
show cable rate-adapt
|
12.3(23)BC2
|
show cable service-voice downstream-type
|
12.3(23)BC
|
show cable mac-domain rcc
|
12.2(33)SCB
|
show cable rf-status
|
12.2(33)SCB
|
show cable rsvp flow-db
|
12.2(33)SCB
|
show cable modem auth-profile
|
12.2(33)SCB
|
show cable modem service-type-id
|
12.2(33)SCB
|
show cable modem summary wb-rf
|
12.2(33)SCB
|
show cable modem wideband rcs-status
|
12.2(33)SCB
|
show cable multicast authorization
|
12.2(33)SCB
|
show cable multicast db
|
12.2(33)SCB
|
show cable multicast dsid
|
12.2(33)SCB
|
show cable multicast qos
|
12.2(33)SCB
|
show cable modem service-flow
|
12.2(33)SCB1
|
show cable mac-domain upstream-service-group
|
12.2(33)SCC
|
show cable rate-limit-ccf
|
12.2(33)SCC
|
show cable signal-quality
|
12.2(33)SCC
|
show cable spectrum-analysis
|
12.2(33)SCC
|
show cable us-sg
|
12.2(33)SCC
|
show cable modem partial-mode
|
12.2(33)SCD2
|
show cable multicast debug
|
12.2(33)SCE
|
show cable urm
|
12.2(33)SCE
|
show cable modem rf-adapt
|
12.2(33)SCF
|
show cable multicast statistics failure
|
12.2(33)SCF
|
show cable rf-adapt
|
12.2(33)SCF
|
show cable modem extended-power
|
12.2(33)SCF2
|
Modified Commands
Command
|
Cisco IOS Software Release
|
show cable mac-domain downstream-service-group
|
12.3(23)BC
|
show cable modem
|
12.3(23)BC, 12.2(33)SCA
|
show cable modem calls
|
12.2(33)SCA
|
show cable modem classifiers
|
12.2(33)SCA
|
show cable modem cnr
|
12.2(33)SCA
|
show cable modem connectivity
|
12.2(33)SCA
|
show cable modem counters
|
12.2(33)SCA
|
show cable modem cpe
|
12.2(33)SCA
|
show cable modem docsis device-class
|
12.2(33)SCA
|
show cable modem errors
|
12.2(33)SCA
|
show cable modem flap
|
12.2(33)SCA
|
show cable modem mac
|
12.2(33)SCA
|
show cable modem maintenance
|
12.2(33)SCA
|
show cable modem offline
|
12.2(33)SCA
|
show cable modem phy
|
12.2(33)SCA
|
show cable modem qos
|
12.2(33)SCA
|
show cable modem registered
|
12.2(33)SCA
|
show cable modem rogue
|
12.2(33)SCA
|
show cable modem remote-query
|
12.3(23)BC
|
show cable modem phy
|
12.2(33)SCA
|
show cable modem
|
12.2(33)SCB
|
show cable mac-domain cgd-associations
|
12.2(33)SCB
|
show cable mac-domain downstream-service-group
|
12.2(33)SCB
|
show cable modem wideband
|
12.2(33)SCB
|
show cable modem wideband rcs-status
|
12.2(33)SCB
|
show cable qos enforce-rule
|
12.2(33)SCB
|
show cable rate-adapt
|
12.2(33)SCB
|
show cable modem service-flow
|
12.3(23)BC7
|
show cable modem
|
12.2(33)SCC
|
show cable modem cnr
|
12.2(33)SCC
|
show cable modem flap
|
12.2(33)SCC
|
show cable modem phy
|
12.2(33)SCC
|
show cable modem qos
|
12.2(33)SCC
|
show cable multicast dsid
|
12.2(33)SCC
|
show cable service-class
|
12.2(33)SCC
|
show cable mac-domain downstream-service-group
|
12.2(33)SCD
|
show cable mac-domain cgd-associations
|
12.2(33)SCD
|
show cable mac-domain rcc
|
12.2(33)SCD
|
show cable modem
|
12.2(33)SCD
|
show cable multicast dsid
|
12.2(33)SCD
|
show cable modem
|
12.2(33)SCD2
|
show cable modem docsis version
|
12.2(33)SCD2
|
show cable qos enforce-rule
|
12.2(33)SCD2
|
show cable modem service-flow
|
12.2(33)SCE
|
show cable multicast db
|
12.2(33)SCE
|
show cable multicast qos
|
12.2(33)SCE
|
show cable privacy
|
12.2(33)SCE
|
show cable mac-domain cable forwarding
|
12.2(33)SCF
|
show cable modem
|
12.2(33)SCF
|
show cable modem access-group
|
12.2(33)SCF
|
show cable modem calls
|
12.2(33)SCF
|
show cable modem cnr
|
12.2(33)SCF
|
show cable modem connectivity
|
12.2(33)SCF
|
show cable modem counters
|
12.2(33)SCF
|
show cable modem docsis version
|
12.2(33)SCF
|
show cable modem domain-name
|
12.2(33)SCF
|
show cable modem errors
|
12.2(33)SCF
|
show cable modem flap
|
12.2(33)SCF
|
show cable modem ipv6
|
12.2(33)SCF
|
show cable modem mac
|
12.2(33)SCF
|
show cable modem maintenance
|
12.2(33)SCF
|
show cable modem offline
|
12.2(33)SCF
|
show cable modem phy
|
12.2(33)SCF
|
show cable modem primary channel
|
12.2(33)SCF
|
show cable modem qos service-class
|
12.2(33)SCF
|
show cable modem registered
|
12.2(33)SCF
|
show cable modem rogue
|
12.2(33)SCF
|
show cable modem summary
|
12.2(33)SCF
|
show cable modem type
|
12.2(33)SCF
|
how cable modem unregistered
|
12.2(33)SCF
|
show cable modem vendor
|
12.2(33)SCF
|
show cable modem wideband
|
12.2(33)SCF
|
show cable multicast db
|
12.2(33)SCF
|
show cable modem
|
12.2(33)SCE4
|
show cable modem service-flow
|
12.2(33)SCF2
|
show cable service-class
|
12.2(33)SCF2
|
show cable mac-domain cable forwarding
To display all the interfaces (wideband and modular) and statistics belonging to the Mac domain, use the show cable mac-domain cable forwarding command in privileged EXEC mode.
show cable mac-domain cable slot/subslot/port forwarding
Syntax Description
slot
|
Specifies the chassis slot number of the cable interface line card. Valid values are 5 to 8.
|
subslot
|
Specifies the secondary slot number of the cable interface line card. Valid subslots are 0 or 1.
|
port
|
Specifies the port number. Valid values are 0 to 4 (depending on the cable interface).
|
forwarding
|
Displays the forwarding statistics for the cable line cards.
|
Command Default
No default behavior or values.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.3(23)BC
|
This command was introduced.
|
12.2(33)SCA
|
This command is integrated in Cisco IOS Release 12.2(33)SCA.
|
Usage Guidelines
The show cable mac-domain cable forwarding command does not support wideband and modular interfaces. However, if wideband and modular interfaces belong to the Mac domain, the interfaces are listed in the output with the interface state.
Starting with Cisco IOS Release 12.2(33)SCF, for a chassis loaded with the UBR-MC20X20V or uBR-MC3GX60V line cards, and legacy uBR-MC5X20 line cards, the show cable mac-domain cable forwarding command shall not display the legacy downstream information for the UBR-MC20X20V and the uBR-MC3GX60V line cards.
Examples
The following is sample output of the show cable mac-domain cable forwarding command on the cable interface at 8/0/0:
Router# show cable mac-domain cable 8/0/0 forwarding
Interface Output Interface Reserved/ Interface
Name Packets Rate Bandwidth Reservable State
(bytes) (bits/sec) (Kbps) Bandwidth
------------------------------------------------------------------------------
Ca8/0/0 201358 0 26000 6500/19500 UP
Mo1/0/0:0 344340 0 4160 1040/3120 UP
Mo1/0/0:1 252132 0 7800 1950/5850 UP
Mo1/0/0:2 252132 0 7800 1950/5850 UP
Wi1/0/0:0 198916 0 7803 1951/5852 UP
Wi1/0/0:1 1152 0 10404 2601/7803 UP
Table 63 describes the significant fields shown in the display.
Table 1 show cable mac-domain cable forwarding Field Descriptions
Field
|
Description
|
Interface Name
|
The name of the interface belonging to Mac domain.
|
Output Packets/Rate
|
The cumulative packets output and output rate.
|
Interface Bandwidth
|
The total interface bandwidth allocated.
|
Reserved/Reservable Bandwidth
|
The total reserved and available bandwidth.
|
Interface State
|
Indicates whether the interface is up or down.
|
show cable mac-domain cgd-associations
To display a summary of the Channel Grouping Domain (CGD) associations for all cable MAC domains, use the show cable mac-domain cgd-associations command in privileged EXEC mode.
Cisco uBR10012 Router
show cable mac-domain cable slot/subslot/port cgd-associations
Cisco uBR7225VXR and Cisco uBR7246VXR Routers
show cable mac-domain cable slot/port cgd-associations
Syntax Description
cable slot/subslot/port
|
Identifies the cable interface on the Cisco uBR10012 router.
• slot—Slot where the line card resides. The valid range is from 5 to 8.
• subslot—Subslot where the line card resides. Available slots are 0 or 1.
• port—Downstream controller number on the line card. Valid port values are from 0 to 4.
|
cable slot/port
|
Identifies the cable interface on the Cisco uBR7246VXR or Cisco uBR7225VXR router.
• slot—Slot where the line card resides.
– Cisco uBR7246VXR router: The valid range is from 3 to 6.
– Cisco uBR7225VXR router: The valid range is from 1 to 2.
• port—Downstream port number on the line card. The valid port value is 0 or 1.
|
Command Default
None
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.3(23)BC
|
This command was introduced for the Cisco uBR10012 router.
|
12.2(33)SCB
|
This command was integrated into Cisco IOS Release 12.2(33)SCB.
|
Usage Guidelines
The show cable mac-domain cgd-associations command displays the following information for each cable MAC domain:
•
Shared port adapter (SPA) downstream channels that have been added to each MAC domain.
•
Upstream channels associated with each SPA downstream channel and the downstream channels of the integrated cable interface line card.
If the All column in the command output indicates Y, then this indicates that all upstream channels associated with the line card downtream channels or SPA downstream channels are configured using the upstream cable connector command. If all upstream channels are not configured, then this column will not display.
•
The SPA downsteam channels that are currently active.
A SPA downstream channel is active when the corresponding modular cable interface, which represents the SPA downstream channel, and its line protocol are up. A SPA downstream channel that is considered active is an operational primary downstream channel in the cable MAC domain.
Note
For more information on Channel Grouping Domains, refer to the Cisco DOCSIS 3.0 Downstream Solution Design and Implementation Guide, Release 2.0.
Examples
Cisco IOS Release 12.3(23)BC
The following is a sample output of the show cable mac-domain cgd-associations command for the cable interface at slot 6, subslot 0, and port 0:
Router# show cable mac-domain c6/0/0 cgd-associations
CGD Host SPA DS Channels Upstreams (All) Active Remote DS
Cisco IOS Release 12.2(33)SCB
The following is a sample output of the show cable mac-domain cgd-associations command for the cable interface at slot 7, subslot 0, and port 0:
Router# show cable mac-domain Cable7/0/0 cgd-associations
CGD Host Resource DS Channels Upstreams (AllUS) Active Remote DS
Related Commands
Command
|
Description
|
show cable mac-domain downstream-service-group
|
Displays MAC Domain Downstream Service Group information for the primary downstream channel.
|
show cable mac-domain downstream-service-group
To display MAC Domain Downstream Service Group information for a primary downstream channel, use the show cable mac-domain downstream-service-group command in privileged EXEC mode.
Cisco uBR7225VXR and Cisco uBR7246VXR Universal Broadband Routers
show cable mac-domain cable slot/port downstream-service-group
Cisco uBR10012 Universal Broadband Router
show cable mac-domain cable slot/subslot/port downstream-service-group
Syntax Description
slot
|
Slot where the line card resides.
Cisco uBR7246VXR router—The valid range is from 3 to 6.
Cisco uBR7225VXR router—The valid range is from 1 to 2.
Cisco uBR10012 router—The valid range is from 5 to 8.
|
subslot
|
The subslot used for the cable interface line card. Valid values are 0 or 1.
|
port
|
The downstream port used as a primary downstream channel. Valid values are from 0 to 4 (depending on the cable interface).
|
Command Default
No default behavior or values
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.3(21)BC
|
This command was introduced for the Cisco uBR10012 router.
|
12.3(23)BC
|
This command displays the MAC Domain Downstream Service Group information for primary downstream channels from the SPA as well as the Cisco uBR10-MC5X20 line card.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA.
|
12.2(33)SCD
|
This command was modified. Support was added for Cisco uBR7225VXR and Cisco uBR7246VXR routers.
|
Usage Guidelines
Use the show cable mac-domain downstream-service-group command to display MAC Domain Downstream Service Group (MD-DS-SG) information for the specified primary downstream channel.
For each fiber node, a traditional DOCSIS downstream channel on a Cisco uBR10-MC5X20 cable interface line card is used to carry MAC management and signaling messages, and the associated traditional DOCSIS upstream channel is used for return data traffic and signaling. The traditional DOCSIS downstream channel used in this way for a MAC domain is called the primary downstream channel.
Note
Beginning in Cisco IOS Release 12.3(23)BC, either an RF channel from the SPA or a Cisc uBR10-MC5X20 downstream channel can serve as a primary channel in a fiber node. Changes in Cisco IOS Release 12.3(23)BC apply to Cisco IOS Release 12.2(33)SCB and do not apply to Cisco IOS Release 12.2(33)SCA.
Examples
The following two examples display show cable mac-domain downstream-service-group output for the primary downstream channel on the cable interface at slot/subslot/port 5/0/0:
Cisco IOS Release 12.3(21)BC
Router# show cable mac-domain cable5/0/0 downstream-service-group
Cisco IOS Release 12.3(23)BC
Router# show cable mac-domain cable5/0/0 downstream-service-group
Cable MD-DS-SG RF Local Remote
IF Id SPA Chan Primary Chan Primary Chan
In the preceding examples, the MD-DS-SG with ID 1 is used for RF channels 0 and 1 on the Wideband SPA located in slot/subslot/bay 1/0/0.
Cisco IOS Release 12.2(33)SCB
The following example shows a sample output of the show cable mac-domain downstream-service-group command for the primary downstream channel on the cable interface at slot/subslot/port 7/0/0:
Router# show cable mac-domain Cable7/0/0 downstream-service-group
IF Id Resource Chan Primary Chan
C7/0/0 1 3/1/0 00-02 0 1 2
Cisco IOS Release 12.2(33)SCD
The following example shows a sample output of the show cable mac-domain downstream-service-group command for the primary downstream channel on the cable interface at slot/port 5/0:
Router# show cable mac-domain cable 5/0 downstream-service-group
IF Id Resource Chan Primary Chan
Related Commands
Command
|
Description
|
show cable modem
|
Displays information for registered and unregistered cable modems (including wideband cable modems).
|
show cable modem wideband
|
Displays information for registered and unregistered wideband cable modems.
|
show cable mac-domain rcc
To display runtime receive channel configuration (RCC) on a cable line card interface, use the show cable mac-domain rcc command in privileged EXEC mode.
Cisco uBR7225VXR and Cisco uBR7246VXR Universal Broadband Routers
show cable mac-domain cable slot/port rcc
Cisco uBR10012 Universal Broadband Router
show cable mac-domain cable slot/subslot/port rcc
Syntax Description
slot
|
Slot where the line card resides.
Cisco uBR7246VXR router—The valid range is from 3 to 6.
Cisco uBR7225VXR router—The valid range is from 1 to 2.
Cisco uBR10012 router—The valid range is from 5 to 8.
|
subslot
|
Specifies the secondary slot number of the cable interface line card. Valid subslots are 0 or 1.
|
port
|
Specifies the port number. Valid values are 0 to 4 (depending on the cable interface).
|
Command Default
No default behavior or values.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCB
|
This command was introduced.
|
12.2(33)SCD
|
This command was modified. Support was added for Cisco uBR7225VXR and Cisco uBR7246VXR routers.
|
Examples
The following is a sample output of the show cable mac-domain rcc command on the cable interface at slot/subslot/port 8/0/0:
Router# show cable mac-domain cable 8/0/0 rcc
RCC-ID RCP RCs MD-DS-SG CMs WB/RCC-TMPL
1 00 00 00 00 00 2 0 0 WB (101)
2 00 10 00 00 03 3 2 0 RCC-TMPL (1)
The following is a sample output of the show cable mac-domain rcc command on the cable interface at slot/port 5/0:
Router# show cable mac-domain cable 5/0 rcc
RCC-ID RCP RCs MD-DS-SG CMs WB/RCC-TMPL
1 00 00 00 00 00 3 0 3 WB (25)
Table 2 describes the significant fields shown in the display.
Table 2 show cable mac-domain rcc Field Descriptions
Field
|
Description
|
RCC-ID
|
RCC index per MAC domain. The RCC ID refers to the RCC ID output from the show cable modem wideband command.
|
RCP
|
The receive channel profile associated with the RCC object.
|
RCs
|
Total number of DS channels.
|
MD-DS-SG
|
Indicates the MAC domain DS service group for which the RCC is generated.
|
CM
|
Total number of CMs associated with the RCC object.
|
WB/RCC-TMPL
|
Indicates the wideband interface or the RCC template.
|
Note
A zero value in the RCP or MD-DS-SG field indicates that the RCC is generated directly through a wideband interface configuration and not through any RCC templates.
Related Commands
Command
|
Description
|
show interface rf-status
|
Displays the logical up and down state for each of the configured RF channels for a wideband interface.
|
show cable mac-domain upstream-service-group
To display runtime statistics of the MAC domain upstream service group on a cable interface line card, use the show cable mac-domain upstream-service-group command in privileged EXEC mode.
show cable mac-domain cable slot/subslot/port upstream-service-group
Syntax Description
slot
|
Chassis slot number of the cable interface line card. The valid range is from 0 to 8.
|
subslot
|
Secondary slot number of the cable interface line card. Valid values are 0 or 1.
|
port
|
Port number. The valid range is from 0 to 4 (depending on the cable interface).
|
upstream-service-group
|
Specifies the upstream service group number.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCC
|
This command was introduced.
|
Usage Guidelines
This command displays privacy information of a particular CM, identified by its IP address or MAC address.
Examples
The following is a sample output of the show cable mac-domain upstream-service-group command on the cable interface line card at slot/subslot/port 7/1/0:
Router# show cable mac-domain cable 7/1/0 upstream-service-group
US-SG-ID : 1 US-Chan : U0,1,2,3,4
Primary-DS: 5/1/0:0 US-SG-ID: 1
Primary-DS: 3/0/0:0 US-SG-ID: 1
MDD Ambiguity : U0,1,2,3,4
Primary-DS: 3/0/0:1 US-SG-ID: 1
MDD Ambiguity : U0,1,2,3,4
Primary-DS: 3/0/0:2 US-SG-ID: 1
MDD Ambiguity : U0,1,2,3,4
Primary-DS: 3/0/0:3 US-SG-ID: 1
MDD Ambiguity : U0,1,2,3,4
Table 3 describes the significant fields shown in the display.
Table 3 show cable mac-domain upstream-service-group Field Descriptions
Field
|
Description
|
US-SG-ID
|
Upstream service group ID.
|
US-chan
|
Total number of upstream channels on the cable interface line card.
|
Primary-DS
|
The primary downstream interface.
|
MDD US-List
|
MAC management message: MDD TLV type 7 content, upstream active channel list.
|
MDD Ambiguity
|
MAC management message: MDD TLV type 8 content, upstream ambiguity resolution channel list.
|
Related Commands
Command
|
Description
|
show interface rf-status
|
Displays the logical up and down states for each of the configured RF channels on a wideband interface.
|
show cable metering-status
To display information about the most recent successful usage-based billing operation, use the show cable metering-status command in privileged EXEC mode.
show cable metering-status [verbose]
Syntax Description
verbose
|
(Optional) Displays the information in a more readable format.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.3(9a)BC
|
This command was introduced.
|
12.2(33)SCB
|
SAMIS over Internet Protocol Detail Record (IPDR) was introduced.
|
Usage Guidelines
The show cable metering-status command displays information about the most recent successful usage-based billing operation. If usage-based billing is configured for File mode, this command displays the device and file name for the record that was last written. If usage-based billing is configured for Streaming mode, this command displays the IP address and port number for the external server to which the billing record was sent.
Note
This command displays the status of the last successful billing record operation. If a failure occurred, the CMTS sends an SNMP trap to the SNMP manager with that information.
Examples
The following example shows a typical output for the show cable metering-status command when usage-based billing is configured to write the billing records to a local file system:
Router# show cable metering-status
destination complete-time flow cpe status
disk0:R7519-UBR7246-200308-004428 Jun 12 09:33:05 No No success
The following example shows a typical output for the show cable metering-status command when usage-based billing is configured to stream the billing records to an external server:
Router# show cable metering-status
destination complete-time flow cpe status
10.11.37.2 :1234 Jun 12 09:33:05 No No success
The following example shows a typical output for the verbose form of the show cable metering-status command:
Router# show cable metering-status verbose
Destination : disk0:R7519-UBR7246-20000308-004428
Complete Time : Jun 12 09:33:05
Cpe list suppression : Yes
Status of last export : success
The following example shows a typical output for the show cable metering-status command when usage-based billing is configured to use the Internet Protocol Detail Record (IPDR) Exporter to stream the billing records to an external server:
Router# show cable metering-status
destination complete-time flow cpe status
IPDR_Session1 Jun 12 09:33:05 N/A N/A success
The following example shows a typical output for the verbose form of the show cable metering-status command when usage-based billing is configured to use the IPDR Exporter to stream the billing records to an external server:
Router# show cable metering-status verbose
Destination : IPDR_Session1
Complete Time : Jun 12 09:36:05
Status of last export : success
The following example shows the error message that is displayed when you enter the show cable metering-status command but not have enabled usage-based billing:
Router# show cable metering-status
CMTS Metering collection not enabled
The following example shows if the SAMIS report failed, the output displays the details of the failure:
Router# show cable metering-status verbose
Load for five secs: 0%/0%; one minute: 1%; five minutes: 0%
Time source is NTP, .19:24:53.955 PDT Fri Jun 11 2010
Destination : 20.1.0.2:5959
Complete Time : Jun11 19:24:40
Cpe list suppression : No
Source interface : GigabitEthernet0/1
Status of last export : write-error (bulk-data)
Table 4 describes the fields displayed by the show cable metering-status command.
Table 4 show cable metering-status Field Descriptions
Field
|
Description
|
destination, Destination
|
Destination for the billing records. This is a file system device name and file name, if records are being written to a local file system, or an IP address and TCP port number, if records are being streamed to an external server.
|
complete_time, Complete Time
|
Date and time when the last billing record was written to a local file or streamed to an external server.
|
flow aggr, Flow Aggregate
|
Indicates whether traffic counters are aggregated in the billing records, so that one total is recorded for the upstream service flows and downstream service flows for each CM.
|
cpe suppress, CPE list suppression
|
Indicates whether CPE IP addresses are included or suppressed in the billing records:
• Yes = CPE addresses are suppressed and are not included in the billing records.
• No = CPE addresses are included in the billing records.
|
status, Status of last export
|
Indicates the status of the last billing operation:
• success—The billing records were successfully written to the filesystem (file mode) or transferred to the billing collection server (streaming mode).
• connect-failed—The CMTS was able to open the proper socket connection to the server but could not connect to the server.
• data-incomplete—A failure occurred during the file write or the streaming to the collection server, and the records that were written might be incomplete.
• disk-full—The billing records could not be written because the filesystem does not have sufficient free space.
• no-memory—The processor had insufficient memory to collect the billing records.
• open-failure—The transfer failed because the CMTS could not open a new file on the filesystem (file mode) or open a socket to the destination IP address and port (streaming mode).
• unknown—An unknown error occurred.
• write-error (data-type)—The operating system reported an error when attempting to write the billing records (file mode), or the send to the destination socket failed (streaming mode).
– The value of data-type could be file-header, file-end, bulk-data, sflog, bulk-data, ipdr-data, ipdr-sflog, or ipdr-file.
|
Related Commands
Command
|
Description
|
cable metering destination
|
Enables usage-based billing and streams the billing records to an external server.
|
cable metering filesystem
|
Enables usage-based billing and writes the billing records to a file on a local file system.
|
cable metering source-interface
|
Enables debugging of usage-based billing operations.
|
snmp-server enable traps cable
|
Enables the sending of Simple Network Management Protocol (SNMP) traps for cable-related events.
|
show cable modem
To display information for the registered and unregistered CMs, use the show cable modem command in privileged EXEC mode.
show cable modem [ip-address | mac-address | cable {slot/port | slot/subslot/port} [upstream port
[logical-channel-index]] | name fqdn] queue [verbose] [cm-status]
Cisco IOS Release 12.2(33)SCE and later releases
show cable modem [ip-address | mac-address | cable {slot/cable-interface-index |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn]
[verbose] [cm-status]
Syntax Description
ip-address
|
(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.
|
mac-address
|
(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.
|
slot
|
Slot where the line card resides.
• Cisco uBR7225VXR router—The valid value is 1 or 2.
• Cisco uBR7246VXR router—The valid range is from 3 to 6.
• Cisco uBR10012 router—The valid range is from 5 to 8.
|
subslot
|
(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
|
port
|
Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.
• Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).
|
cable-interface-index
|
Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.
• Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
upstream port
|
(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.
|
name fqdn
|
(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.
|
verbose
|
Displays detailed information for the CMs.
|
cm-status
|
Displays CM status events.
|
queue
|
Displays the downstream hierarchical queueing framework (HQF) queue information for a cable modem.
|
logical-channel-index
|
(Optional) Logical channel index. The valid values are 0 or 1.
|
Command Modes
Privileged EXEC (#)
Command History
This table includes the following release-specific history entries:
•
BC Release
•
C Release
•
E Release
•
N Release
•
SC Release
•
T Release
•
X Release
BC Release
|
Modification
|
12.2(15)BC1
|
Additional lines were added to the show cable modem verbose displays, for one or all cable modems, to show information about the dynamic shared-secret feature. Cable modems that fail the dynamic secret authentication checks and then come online are marked with an exclamation point (!), so that this situation can be investigated.
|
12.2(4)BC1
|
Support was added for the Cisco uBR10012 router.
|
12.2(8)BC2
|
The output for the Online State field was updated for the cable tftp-enforce command. A pound sign (#) appears next to the state value when a CM was allowed to come online without attempting to download a DOCSIS configuration file through the cable interface with the Cisco CMTS.
|
12.2(15)BC1c
|
The verbose option displays whether dynamic service change requests (DSX) are allowed from cable modems.
|
12.2(15)BC2
|
Two new states—cc(r1) and cc(r2)—have been added to the CM MAC state field (see Table 23) to indicate the CM status when it has been instructed to change channels and is ranging to obtain a new downstream or upstream channel.
Also, three new states—online(pkd), online(ptd), and expire(pkd)—were added to clarify the BPI state when network access has been disabled in the CM's DOCSIS configuration file.
In addition, the show cable modem verbose command now displays the total amount of time that a CM has been online since last registering.
|
12.3(13a)BC
|
New initialization states were added for the MAC State Field:
• init(d)—The Cisco CMTS has seen DHCPDISCOVER
• init(io)—The Cisco CMTS has seen DHCPOFFER
• init(dr)—The Cisco CMTS has seen DHCPREQUEST
• init(i)—The Cisco CMTS has seen DHCPACK
• init(o)—The Cisco CMTS has seen first TFTP packet for TFTP request for cable modem configuration file
• init(t)—The Cisco CMTS has seen the TOD request
See Table 23 for additional information.
|
12.3(21)BC
|
All cable bundles are now automatically converted and configured to be in a virtual bundle, and standalone cable interfaces must be manually configured to be in a virtual bundle to operate properly. Previously, new virtual interface bundles and bundle members required reconfiguration, and there could also be standalone interfaces not part of a bundle at all.
|
12.3(23)BC
|
The verbose option displays additional information about the cable modem. The following fields have been added to the output of this option:
• Host Interface
• Primary Downstream
• Wideband Capable
• Voice Enabled
• DS Change Times
|
C Release
|
Modification
|
12.1(4)CX
|
Support was added for the Cisco uBR10012 router.
|
12.2(15)CX
|
The verbose option displays the sysDescr field for each cable modem, when the cable modem remote-query command has been configured. Other fields have also been added to support DOCSIS 2.0 (ATDMA) operation.
|
E Release
|
Modification
|
12.1(10)EC1
|
Adds an exclamation point to CMs that have exceeded the maximum delay/timing offset specified by the cable map-advance command.
|
12.1(11b)EC1
|
The output for the Online State field was updated for the cable tftp-enforce command. A pound sign (#) appears next to the state value when a CM was allowed to come online without attempting to download a DOCSIS configuration file through the cable interface with the Cisco CMTS.
|
12.1(20)EC1
|
The three new states—online(pkd), online(ptd), and expire(pkd)—were added to the Cisco IOS Release 12.1 EC train.
|
N Release
|
Modification
|
11.3(5)NA
|
The output was reorganized and the Receive Power field was added.
|
SC Release
|
Modification
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was added.
• The name keyword option was added for specifying the fully-qualified domain name of a CM.
• The output column spacing and headings were changed, including some of the following changes:
– "BPI Enb" has been changed to "BPI"
– "DIP" output field was added to indicate support of dual IP for both IPv4 and IPv6 addressing.
• The following new initialization states were added to show initialization of CMs and CPEs supporting IPv6:
– init6(s)—CMTS router has seen SOLICIT message.
– init6(a)—CMTS router has seen ADVERTISE message.
– init6(r)—CMTS router has seen REQUEST message.
– init6(i)—CMTS router has seen REPLY message.
– init6(o)—CMTS router has seen version 6 TFTP request.
– init6(t)—CMTS router has seen version 6 TOD request.
|
12.2(33)SCB
|
A new keyword, cm-status, was added to display CM status events.
|
12.2(33)SCC
|
This command was modified with the following changes:
• The command output displays the CM attribute bitmasks.
• The command output provides basic receive-statistics for all event code types of the specified CM.
|
12.2(33)SCD
|
This command was modified. The cm-status keyword was added to display the CM status events and the queue keyword was added to display downstream HQF queue information on the Cisco uBR7225VXR and Cisco uBR7246VXR routers.
|
12.2(33)SCD2
|
This command was modified. The command output was modified to display the cable modems that are in upstream and downstream partial service mode.
|
12.2(33)SCE
|
This command was modified. The port parameter was changed to cable-interface-index.
|
12.2(33)SCE4
|
This command was modified. The command output displays online time of the modem since the last counter reset, along with the total time online.
|
12.2(33)SCF
|
This command was modified. The logical-channel-index argument was added. The show cable modem verbose command output was modified to display the downstream channel information for the cable modems.
|
T Release
|
Modification
|
2.1(1a)T1
|
The output of this command was enhanced to show that the Cisco CMTS has detected an unstable return path for a particular CM and has compensated with a power adjustment. An asterisk (*) appears in the power adjustment field for a modem when a power adjustment has been made; an exclamation point (!) appears when the CM has reached its maximum power transmit level and cannot increase its power level further.
|
12.0(7)T
|
The detail option was replaced with the verbose option.
|
X Release
|
Modification
|
11.3XA
|
This command was introduced.
|
12.0(4)XI
|
The output was expanded to show the primary service identifier (SID) and the customer premises equipment (CPE) count.
|
12.0(7)XR
|
The output of this command was enhanced to show that the Cisco CMTS has detected an unstable return path for a particular CM and has compensated with a power adjustment. An asterisk (*) appears in the power adjustment field for a modem when a power adjustment has been made; an exclamation point (!) appears when the CM has reached its maximum power transmit level and cannot increase its power level further.
|
Usage Guidelines
This command displays information for all CMs, for all CMs attached to a specific CMTS cable interface, or for a particular CM, identified by its IP address, MAC address, or its domain name. The output is sorted by the cable interface and the CM MAC address.
Note
In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.
Tip
Several options in the show cable modem command do not pause the screen to display the information page by page, even if the terminal length command has been used to set the page size of your terminal. Paging and pausing the display could result in outdated or stale information for CMs, and thus produce an incorrect snapshot of the current CM state of the system. To capture or review this information, use your terminal program's capture buffer to save the information to a file, and then review it offline.
Tip
You can also specify the MAC address or IP address for a CPE device, and the Cisco CMTS will display the information for the CM that is associated with that CPE device in its internal database.
Note
If the CPE IP address is no longer associated with a cable modem, the show cable modem command might not display information about the cable modem. To display the IP address of the CPE device for the cable modem, use the clear cable host ip-address command to clear the IP address of the modem from the router database, and then enter the ping docsis mac-address command, which resolves the MAC address by sending the DOCSIS ping to the CM.
Refer to the following document on Cisco.com for additional information about cable interface bundling and virtual interface bundling on the Cisco CMTS:
•
Cable Interface Bundling and Virtual Interface Bundling on the Cisco CMTS
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Operation of the show cable modem Commands with Different Cable Interface Line Cards
The show cable modem commands display the most current information for standard cable interface line cards. If the card itself is down, the show cable modem commands still show whatever information is appropriate (such as offline cable modems and flap list information).
The show cable modem commands function slightly different when used on routers that are using Broadband Processing Engine (BPE) cable interface line cards (such as the Cisco uBR-MC16U/X, Cisco uBR-MC28U/X, or Cisco uBR10-MC5X20S/U/H). When BPE cards are the only cable interface cards installed, the show cable modem commands do not display any output until at least one BPE card is up and communicating with the router processor. If the BPE cards are not yet up, the show cable modem command does not display any output.
Examples
Example of the show cable modem Command Output for all CMs
The following sample output from the show cable modem command shows the default CM displays for individual CMs.
MAC Address IP Address I/F MAC Prim RxPwr Timing Num BPI
State Sid (db) Offset CPEs Enbld
0010.7b6b.58c1 0.0.0.0 C4/0/U5 offline 5 -0.25 2285 0 yes
0010.7bed.9dc9 0.0.0.0 C4/0/U5 offline 6 -0.75 2290 0 yes
0010.7bed.9dbb 0.0.0.0 C4/0/U5 offline 7 0.50 2289 0 yes
0010.7b6b.58bb 0.0.0.0 C4/0/U5 offline 8 0.00 2290 0 yes
0010.7bb3.fcd1 10.20.113.2 C5/0/U5 online 1 0.00 1624 0 yes
0010.7bb3.fcdd 0.0.0.0 C5/0/U5 init(r1) 2 -20.00 1624 0 no
0010.7b43.aa7f 0.0.0.0 C5/0/U5 init(r2) 3 7.25 1623 0 no
Example of the show cable modem Command for a Specified MAC Address
Router# show cable modem 0010.7bb3.fcd1
MAC Address IP Address I/F MAC Prim RxPwr Timing Num BPI
State Sid (db) Offset CPEs Enbld
0010.7bb3.fcd1 10.20.113.2 C5/0/U5 online 1 0.00 1624 0 Y
Example of the show cable modem Command for all CMs on a Cisco uBR10012 Router
The following shows a typical display for a Cisco uBR10012 router:
Note
The asterisk(*) in the Primary SID (Prim Sid) field indicates that the modem has service flows with zero blaze index in Cisco IOS Release 12.3(23)BC.
In Cisco IOS Release 12.2(33)SCB and later, the asterisk that may appear in the Primary SID field does not signify anything.
MAC Address IP Address I/F MAC Prim RxPwr Timing Num BPI
State Sid (db) Offset CPE Enb
0010.9507.01db 144.205.151.130 C5/1/0/U5 online(pt) 1 0.25 938 1 N
0080.37b8.e99b 144.205.151.131 C5/1/0/U5 online 2 -0.25 1268 0 N
0002.fdfa.12ef 144.205.151.232 C6/1/0/U0 online(pt) 13 -0.25 1920 1 N
0002.fdfa.137d 144.205.151.160 C6/1/0/U0 online *16 -0.50 1920 1 N
0003.e38f.e9ab 144.205.151.237 C6/1/0/U0 online 3 -0.50 1926 1 N
0003.e3a6.8173 144.205.151.179 C6/1/1/U2 offline *4 0.50 1929 0 N
0003.e3a6.8195 144.205.151.219 C6/1/1/U2 online(pt) 22 -0.50 1929 1 N
0006.28dc.37fd 144.205.151.244 C6/1/1/U2 online(pt) 61 0.00 1925 2 N
0006.28e9.81c9 144.205.151.138 C6/1/1/U2 online(pt) 2 !0.75 1925 1 N
0006.28f9.8bbd 144.205.151.134 C6/1/1/U2 #online 25 -0.25 1924 1 N
0006.28f9.9d19 144.205.151.144 C6/1/1/U2 online(pt) 28 0.25 1924 1 N
0010.7bed.9b6d 144.205.151.228 C6/1/1/U2 online(pt) 59 0.25 1554 1 N
0002.fdfa.12db 144.205.151.234 C7/0/0/U0 online 15 -0.75 1914 1 N
0002.fdfa.138d 144.205.151.140 C7/0/0/U5 online 4 0.00 1917 1 N
0003.e38f.e85b 144.205.151.214 C7/0/0/U5 online 17 *0.25 1919 1 N
0003.e38f.f4cb 144.205.151.238 C7/0/0/U5 online(pt) 16 0.00 !2750 1 N
0003.e3a6.7fd9 144.205.151.151 C7/0/0/U5 online 1 0.25 1922 0 N
0020.4005.3f06 144.205.151.145 C7/0/0/U0 online(pt) 2 0.00 1901 1 N
0020.4006.b010 144.205.151.164 C7/0/0/U5 online(pt) 3 0.00 1901 1 N
0050.7302.3d83 144.205.151.240 C7/0/0/U0 online(pt) 18 -0.25 1543 1 N
00b0.6478.ae8d 144.205.151.254 C7/0/0/U5 online(pt) 44 0.25 1920 21 N
00d0.bad3.c0cd 144.205.151.149 C7/0/0/U5 online 19 0.25 1543 1 N
00d0.bad3.c0cf 144.205.151.194 C7/0/0/U0 online 13 0.00 1546 1 N
00d0.bad3.c0d5 144.205.151.133 C7/0/0/U0 online 12 *0.50 1546 1 N
Example of show cable modem Command When no CMs are Online
The following example shows sample output when the cable interface line cards are up, but no cable modems are yet online:
MAC Address IP Address I/F MAC Prim RxPwr Timing Num BPI
State Sid (db) Offset CPE Enb
Example of show cable modem Command When no Cable Interface Line Cards are Up
The following example shows sample output when the Cisco CMTS router contains only Broadband Processing Engine (BPE) cable interface line cards and none of the cable interface line cards are up:
Example of show cable modem verbose Command for a Specified MAC Address
The following example shows sample output for the verbose option for a particular CM:
Router# show cable modem 0010.7bb3.fcd1 verbose
MAC Address : 00C0.7bb3.fcd1
sysDescr : Vendor ABC DOCSIS 2.0 Cable Modem
Upstream Power : 0 dBmV (SNR = 33.25 dBmV)
Downstream Power : 0 dBmV (SNR = ----- dBmV)
Initial Timing Offset : 2812
Qos Provisioned Mode : DOC1.0
Enable DOCSIS2.0 Mode : Y
Phy Operating Mode : atdma
Capabilities : {Frag=N, Concat=N, PHS=N, Priv=BPI}
Sid/Said Limit : {Max Us Sids=0, Max Ds Saids=0}
Optional Filtering Support : {802.1P=N, 802.1Q=N}
Transmit Equalizer Support : {Taps/Symbol= 0, Num of Taps= 0}
Number of CPE IPs : 0(Max CPEs = 1)
Flaps : 373(Jun 1 13:11:01)
Stn Mtn Failures : 0 aborts, 3 exhausted
Total US Flows : 1(1 active)
Total DS Flows : 1(1 active)
Total US Data : 1452082 packets, 171344434 bytes
Total US Throughput : 0 bits/sec, 0 packets/sec
Total DS Data : 1452073 packets, 171343858 bytes
Total DS Throughput : 0 bits/sec, 0 packets/sec
Active Classifiers : 0 (Max = NO LIMIT)
DSA/DSX messages : reject all
Dynamic Secret : A3D1028F36EBD54FDCC2F74719664D3F
Total Time Online : 16:16
Note
The "Number of CPES" field shows the value set for the CM, not the value for the CMTS that is set by the cable modem max-cpe command. In Cisco IOS Release 12.2(15)BC1 and later releases, the verbose display also includes information about the dynamic shared-secret feature (see the cable dynamic-secret command).

Note
An asterisk (*) in the Receive Power column indicates that a power adjustment has been made for that CM. An exclamation point (!) in the Receive Power column indicates that the CM has reached its maximum power transmit level and cannot increase its power level further. An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command.
A pound sign (#) in the MAC State column indicates that the cable tftp-enforce mark-only command has been used for the CM to attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so (Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases).

Tip
The show cable modem command displays the CM timing offset in DOCSIS ticks, while other commands, such as cable map-advance, display the offset in microseconds. Use the following method to convert microseconds to DOCSIS ticks: ticks = microseconds*64/6.25.
Example of the Updated show cable modem verbose Command for a Specified MAC Address in Cisco IOS Release 12.3(23)BC
The following example shows sample output for the verbose option for a particular CM for the Cisco IOS Release 12.3(23)BC with new output fields:
Router# show cable modem 0000.39b9.ac51 verbose
MAC Address : 0000.39b9.ac51
Host Interface : C8/0/0/U5
Primary Downstream : Mo3/0/1:3 (RfId : 27)
sysDescr : Toshiba PacketCable 1.0 EMTA ; <<HW_REV: 13.0.0;
VENDOR: Toshiba Corporation; BOOTR: 2.2; SW_REV: 6.1.318; MODEL: PCX3000>>
Upstream Power : 29.00 dBmV (SNR = 16.07 dB)
Downstream Power : 14.90 dBmV (SNR = 34.30 dB)
Initial Timing Offset : 1774
Curr US Timing Adjust : 272
Prev US Timing Adjust : 0
Received Power : 0.00 dBmV
QoS Provisioned Mode : DOC1.0
Enable DOCSIS2.0 Mode : Y
Phy Operating Mode : tdma
Capabilities : {Frag=N, Concat=Y, PHS=N, Priv=}
Sid/Said Limit : {Max US Sids=0, Max DS Saids=0}
Optional Filtering Support : {802.1P=N, 802.1Q=N}
Transmit Equalizer Support : {Taps/Symbol= 0, Num of Taps= 0}
Number of CPE IPs : 0(Max CPE IPs = 17)
Flaps : 7(Sep 16 20:04:13)
Stn Mtn Failures : 0 aborts, 0 exhausted
Total US Flows : 1(1 active)
Total DS Flows : 1(1 active)
Total US Data : 3399 packets, 1956063 bytes
Total US Throughput : 0 bits/sec, 0 packets/sec
Total DS Data : 125 packets, 10704 bytes
Total DS Throughput : 0 bits/sec, 0 packets/sec
Active Classifiers : 0 (Max = NO LIMIT)
CM Upstream Filter Group : 10
DSA/DSX messages : permit all
Total Time Online : 7d22h
Note
In Cisco IOS Release 12.3(23)BC, the output for this command does not display information about dynamic shared secret.
Example of show cable modem Command for a CM or CPE With a Specified IPv6 Address
The following example shows sample output for the show cable modem command for a CM with the IPv6 address of 2001:ODBA:4321:600:980D:E743:174F:1E48.
Note
The IP Address field shows "---" because the IPv6 address is too long for the size of the output field. To view a complete IPv6 address for a device, use the verbose form of the command.
Router# show cable modem 2001:ODBA:4321:600:980D:E743:174F:1E48
MAC Address IP Address I/F MAC Prim RxPwr Timing Num P I
State Sid (dBmv) Offset CPE I P
0019.474a.ccd0 --- C5/0/1/U0 w-online 38 0.00 1580 0 N
Example of the show cable modem verbose Command Output That Shows CM Attribute Masks in Cisco IOS Release 12.2(33)SCC
The following example shows the sample output for the verbose option for a particular CM in Cisco IOS Release 12.2(33)SCC:
Router# show cable modem 001a.c3ff.ce9e verbose
MAC Address : 0019.474a.d396
Host Interface : C5/0/0/U2
MD-DS-SG / MD-US-SG : 1 / N/A
Primary Downstream : C5/0/0 (RfId : 240)
Multi-Transmit Channel Mode : N
Upstream Power (dBmV) : 0.00
Upstream SNR (dB) : 36.12
Received Power (dBmV) : 0.00
Timing Offset (97.6 ns): 1018
Initial Timing Offset : 1018
Rng Timing Adj Moving Avg(0.381 ns): 0
Rng Timing Adj Lt Moving Avg : 0
Rng Timing Adj Minimum : 0
Rng Timing Adj Maximum : 0
Good Codewords rx : 457865
Corrected Codewords rx : 0
Uncorrectable Codewords rx : 0
Phy Operating Mode : tdma
Downstream Power : 0.00 dBmV (SNR = ----- dB)
QoS Provisioned Mode : DOC1.1
Enable DOCSIS2.0 Mode : Y
Modem Status : {Modem= online(pt), Security=assign(tek)}
Capabilities : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities : {Priv=BPI+, EAE=N, Key_len=56}
L2VPN Capabilities : {L2VPN=N, eSAFE=N}
Sid/Said Limit : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs : 0(Max CPE IPs = 16)
Stn Mtn Failures : 0 aborts, 0 exhausted
Total US Flows : 1(1 active)
Total DS Flows : 1(1 active)
Total US Data : 12937 packets, 1079852 bytes
Total US Throughput : 0 bits/sec, 0 packets/sec
Total DS Data : 6226 packets, 459372 bytes
Total DS Throughput : 0 bits/sec, 0 packets/sec
LB group ID assigned (index) : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID in config file : 0
Required DS Attribute Mask : 0x0
Forbidden DS Attribute Mask : 0x0
Required US Attribute Mask : 0x0
Forbidden US Attribute Mask : 0x0
Service Type ID in config file :
Active Classifiers : 0 (Max = NO LIMIT)
CM Upstream Filter Group : 0
CM Downstream Filter Group : 0
CPE Upstream Filter Group : 0
CPE Downstream Filter Group : 0
DSA/DSX messages : permit all
Number of Multicast DSIDs Support : 16
IGMP/MLD Version : IGMPv2
FCType10 Forwarding Support : N
Total Time Online : 7d4h18m
CFG Max IPv6 CPE Prefix : 1024 (-1 used)
Example of the show cable modem Command Output for a Cable Modem Operating in the MTC Mode
The following example shows the sample output for the verbose option for a particular CM operating in the MTC mode in Cisco IOS Release 12.2(33)SCC:
Router# show cable modem 0014.f831.d596 verbose
MAC Address : 001e.6bfa.f02e
Host Interface : C5/1/0/UB
MD-DS-SG / MD-US-SG : 1 / 1
Primary Wideband Channel ID : 48
Primary Downstream : Mo3/0/0:0 (RfId : 120)
Multi-Transmit Channel Mode : Y
Upstream Channel : US1 US2 US3 US4
Ranging Status : sta sta sta sta
Upstream Power (dBmV) : 0.00 0.00 0.00 0.00
Upstream SNR (dB) : 36.12 36.12 36.12 33.1
Received Power (dBmV) : 0.00 1.00 0.00 -0.75
Reported Transmit Power (dBmV) : 45.00 45.00 45.00 54.75
Peak Transmit Power (dBmV) : 51.00 51.00 56.00 56.00
Minimum Transmit Power (dBmV) : 24.00 24.00 21.00 18.00
Timing Offset (97.6 ns): 2312 2281 2282 2282
Initial Timing Offset : 2314 2058 2058 2058
Rng Timing Adj Moving Avg(0.381 ns): 7 4 0 -94
Rng Timing Adj Lt Moving Avg : 63 30 11 -144
Rng Timing Adj Minimum : -512 -256 -256 -512
Rng Timing Adj Maximum : 256 57088 57344 57344
Pre-EQ Direct Loads : 0 0 0 0
Good Codewords rx : 5012 4996 4992 4990
Corrected Codewords rx : 0 0 0 0
Uncorrectable Codewords rx : 0 0 0 0
Phy Operating Mode : atdma* atdma* tdma* tdma*
Downstream Power : 0.00 dBmV (SNR = ----- dB)
QoS Provisioned Mode : DOC1.1
Enable DOCSIS2.0 Mode : Y
Modem Status : {Modem= w-online, Security=disabled}
Capabilities : {Frag=N, Concat=N, PHS=Y}
Security Capabilities : {Priv=, EAE=Y, Key_len=}
L2VPN Capabilities : {L2VPN=N, eSAFE=N}
Sid/Said Limit : {Max US Sids=8, Max DS Saids=24}
Optional Filtering Support : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs : 0(Max CPE IPs = 16)
Stn Mtn Failures : 0 aborts, 0 exhausted
Total US Flows : 2(2 active)
Total DS Flows : 1(1 active)
Total US Data : 6 packets, 1557 bytes
Total US Throughput : 0 bits/sec, 0 packets/sec
Total DS Data : 0 packets, 0 bytes
Total DS Throughput : 0 bits/sec, 0 packets/sec
LB group ID assigned (index) : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID in config file : 0
Required DS Attribute Mask : 0x0
Forbidden DS Attribute Mask : 0x0
Required US Attribute Mask : 0x0
Forbidden US Attribute Mask : 0x0
Service Type ID in config file :
Active Classifiers : 0 (Max = NO LIMIT)
CM Upstream Filter Group : 0
CM Downstream Filter Group : 0
CPE Upstream Filter Group : 0
CPE Downstream Filter Group : 0
DSA/DSX messages : permit all
Number of Multicast DSIDs Support : 24
IGMP/MLD Version : IGMPv3
FCType10 Forwarding Support : Y
Total Time Online : 1d16h
CM Initialization Reason : NO_PRIM_SF_USCHAN
CFG Max IPv6 CPE Prefix : 16 (-1 used)
Note
An asterisk (*) in the Phy Operating Mode row indicates the type of PHY-layer modulation that the CM (operating in the MTC mode) is using: tdma or atdma.
Example of the show cable modem verbose Command Output in Cisco IOS Release 12.2(33)SCE4
The following example shows the sample output for the verbose option for a particular CM in Cisco IOS Release 12.2(33)SCE4:
Router# show cable modem 001a.c3ff.ce9e verbose
MAC Address : 0014.e84f.1630
Host Interface : C6/1/0/U0
MD-DS-SG / MD-US-SG : N/A / N/A
Primary Downstream : C6/1/0 (RfId : 600)
Downstream Channel DCID RF Channel : 73 6/1/0
Multi-Transmit Channel Mode : N
Upstream Power (dBmV) : 0.00
Upstream SNR (dB) : 31.26
Received Power (dBmV) : 0.50
Timing Offset (97.6 ns): 1237
Initial Timing Offset : 1237
Rng Timing Adj Moving Avg(0.381 ns): 503
Rng Timing Adj Lt Moving Avg : 402
Rng Timing Adj Minimum : 0
Rng Timing Adj Maximum : 1024
Corrected Codewords rx : 0
Uncorrectable Codewords rx : 0
Phy Operating Mode : tdma
Downstream Power : 0.00 dBmV (SNR = ----- dB)
QoS Provisioned Mode : DOC1.1
Enable DOCSIS2.0 Mode : Y
Modem Status : {Modem= online, Security=disabled}
Capabilities : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities : {L2VPN=N, eSAFE=N}
Sid/Said Limit : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs : 0(Max CPE IPs = 16)
Stn Mtn Failures : 0 aborts, 0 exhausted
Total US Flows : 2(2 active)
Total DS Flows : 2(2 active)
Total US Data : 20 packets, 6786 bytes
Total US Throughput : 0 bits/sec, 0 packets/sec
Total DS Data : 11255 packets, 720320 bytes
Total DS Throughput : 5119 bits/sec, 9 packets/sec
LB group ID assigned (index) : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID in config file : 0
Required DS Attribute Mask : 0x0
Forbidden DS Attribute Mask : 0x0
Required US Attribute Mask : 0x0
Forbidden US Attribute Mask : 0x0
Service Type ID in config file :
Active Classifiers : 0 (Max = NO LIMIT)
CM Upstream Filter Group : 30
CM Downstream Filter Group : 29
CPE Upstream Filter Group : 1
CPE Downstream Filter Group : 1
DSA/DSX messages : permit all
Number of Multicast DSIDs Support : 0
IGMP/MLD Version : IGMPv2
FCType10 Forwarding Support : N
Total Time Online : 18:53 (18:53 since last counter reset)
!From Cisco IOS Release 12.2(33)SCE4 onwards, the command output shows online time of the
!modem since the last counter reset.
CFG Max IPv6 CPE Prefix : 16 (-1 used)
Example of the show cable modem verbose Command in Cisco IOS Release 12.2(33)SCF
The following is a sample output of the show cable modem verbose command in Cisco IOS Release 12.2(33)SCF:
Router# show cable modem 10.1.0.2 verbose
MAC Address : 001e.6bfb.0a60
Host Interface : C7/0/0/UB
MD-DS-SG / MD-US-SG : 1 / 1
Primary Wideband Channel ID : 897 (Wi7/0/0:0)
Primary Downstream : In7/0/0:0 (RfId : 720)
Multi-Transmit Channel Mode : Y
Upstream Channel : US0 US1 US2
Ranging Status : sta sta sta
Upstream SNR (dB) : 33.1 33.1 33.1
Upstream Data SNR (dB) : 22.78 22.78 22.78
Received Power (dBmV) : 0.50 0.00 0.00
Reported Transmit Power (dBmV) : 51.00 51.00 51.00
Peak Transmit Power (dBmV) : 51.00 51.00 51.00
Minimum Transmit Power (dBmV) : 24.00 24.00 24.00
Timing Offset (97.6 ns): 1302 1303 1303
The following example is a sample output of the show cable modem verbose command that displays the downstream channel information for a specific CM identified by its IP address:
Router# show cable modem 80.62.0.4 verbose
MAC Address : 0018.6832.0eb2
Host Interface : C6/1/0/U0
MD-DS-SG / MD-US-SG : 3 / N/A
Primary Downstream : In6/1/0:0 (RfId : 600)
Downstream Channel DCID RF Channel : 193 6/1/0:0
Multi-Transmit Channel Mode : N
Upstream Power (dBmV) : 0.00
Upstream SNR (dB) : 36.12
Upstream Data SNR (dB) : --
Received Power (dBmV) : 0.00
Timing Offset (97.6 ns): 1192
Initial Timing Offset : 1192
Rng Timing Adj Moving Avg(0.381 ns): -1
Rng Timing Adj Lt Moving Avg : -7
Rng Timing Adj Minimum : -256
Rng Timing Adj Maximum : 0
Corrected Codewords rx : 0
Uncorrectable Codewords rx : 0
Phy Operating Mode : tdma
Downstream Power : 0.00 dBmV (SNR = ----- dB)
QoS Provisioned Mode : DOC1.1
Enable DOCSIS2.0 Mode : Y
Modem Status : {Modem= online, Security=disabled}
Capabilities : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities : {L2VPN=N, eSAFE=N}
Sid/Said Limit : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs : 0(Max CPE IPs = 16)
Stn Mtn Failures : 0 aborts, 0 exhausted
Total US Flows : 2(2 active)
Total DS Flows : 2(2 active)
Total US Data : 9 packets, 4545 bytes
Total US Throughput : 0 bits/sec, 0 packets/sec
Total DS Data : 9 packets, 3114 bytes
Total DS Throughput : 0 bits/sec, 0 packets/sec
LB group ID assigned (index) : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID in config file : 0
Required DS Attribute Mask : 0x0
Forbidden DS Attribute Mask : 0x0
Required US Attribute Mask : 0x0
Forbidden US Attribute Mask : 0x0
Service Type ID in config file :
Active Classifiers : 0 (Max = NO LIMIT)
CM Upstream Filter Group : 0
CM Downstream Filter Group : 0
CPE Upstream Filter Group : 0
CPE Downstream Filter Group : 0
DSA/DSX messages : permit all
Number of Multicast DSIDs Support : 0
IGMP/MLD Version : IGMPv2
FCType10 Forwarding Support : N
Total Time Online : 4d14h
CFG Max IPv6 CPE Prefix : 16 (-1 used)
The following example is a sample output of the show cable modem verbose command that displays the downstream channel information for a specific cable interface:
Router# show cable modem Cable 6/1/0 verbose
MAC Address : 0018.6832.0eb2
Host Interface : C6/1/0/U0
MD-DS-SG / MD-US-SG : 3 / N/A
Primary Downstream : In6/1/0:0 (RfId : 600)
Downstream Channel DCID RF Channel : 193 6/1/0:0
Multi-Transmit Channel Mode : N
Upstream Power (dBmV) : 0.00
Upstream SNR (dB) : 36.12
Upstream Data SNR (dB) : --
Received Power (dBmV) : 0.00
Timing Offset (97.6 ns): 1192
Initial Timing Offset : 1192
Rng Timing Adj Moving Avg(0.381 ns): 0
Rng Timing Adj Lt Moving Avg : 0
Rng Timing Adj Minimum : 0
Rng Timing Adj Maximum : 256
Corrected Codewords rx : 0
Uncorrectable Codewords rx : 0
Phy Operating Mode : tdma
Downstream Power : 0.00 dBmV (SNR = ----- dB)
QoS Provisioned Mode : DOC1.1
Enable DOCSIS2.0 Mode : Y
Modem Status : {Modem= online, Security=disabled}
Capabilities : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities : {L2VPN=N, eSAFE=N}
Sid/Said Limit : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs : 0(Max CPE IPs = 16)
Flaps : 1(Mar 22 22:39:59)
Stn Mtn Failures : 0 aborts, 1 exhausted
Total US Flows : 2(2 active)
Total DS Flows : 2(2 active)
Total US Data : 2 packets, 1010 bytes
Total US Throughput : 0 bits/sec, 0 packets/sec
Total DS Data : 2 packets, 692 bytes
Total DS Throughput : 0 bits/sec, 0 packets/sec
LB group ID assigned (index) : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID in config file : 0
Required DS Attribute Mask : 0x0
Forbidden DS Attribute Mask : 0x0
Required US Attribute Mask : 0x0
Forbidden US Attribute Mask : 0x0
Service Type ID in config file :
Active Classifiers : 0 (Max = NO LIMIT)
CM Upstream Filter Group : 0
CM Downstream Filter Group : 0
CPE Upstream Filter Group : 0
CPE Downstream Filter Group : 0
DSA/DSX messages : permit all
Number of Multicast DSIDs Support : 0
IGMP/MLD Version : IGMPv2
FCType10 Forwarding Support : N
Total Time Online : 1d2h33m
CFG Max IPv6 CPE Prefix : 16 (-1 used)
MAC Address : 0018.6832.069e
Host Interface : C6/1/0/U0
MD-DS-SG / MD-US-SG : 3 / N/A
Primary Downstream : In6/1/0:0 (RfId : 600)
Downstream Channel DCID RF Channel : 193 6/1/0:0
Multi-Transmit Channel Mode : N
Upstream Power (dBmV) : 0.00
Upstream SNR (dB) : 36.12
Upstream Data SNR (dB) : --
Received Power (dBmV) : 0.50
Timing Offset (97.6 ns): 1196
Initial Timing Offset : 1196
Rng Timing Adj Moving Avg(0.381 ns): -39
Rng Timing Adj Lt Moving Avg : -92
Rng Timing Adj Minimum : -256
Rng Timing Adj Maximum : 0
Corrected Codewords rx : 0
Uncorrectable Codewords rx : 0
Phy Operating Mode : tdma
Downstream Power : 0.00 dBmV (SNR = ----- dB)
QoS Provisioned Mode : DOC1.1
Enable DOCSIS2.0 Mode : Y
Modem Status : {Modem= online, Security=disabled}
Capabilities : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities : {L2VPN=N, eSAFE=N}
Sid/Said Limit : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs : 0(Max CPE IPs = 16)
Flaps : 3(Mar 20 09:22:20)
Stn Mtn Failures : 0 aborts, 1 exhausted
Total US Flows : 2(2 active)
Total DS Flows : 2(2 active)
Total US Data : 13 packets, 6565 bytes
Total US Throughput : 0 bits/sec, 0 packets/sec
Total DS Data : 13 packets, 4498 bytes
Total DS Throughput : 0 bits/sec, 0 packets/sec
LB group ID assigned (index) : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID in config file : 0
Required DS Attribute Mask : 0x0
Forbidden DS Attribute Mask : 0x0
Required US Attribute Mask : 0x0
Forbidden US Attribute Mask : 0x0
Service Type ID in config file :
Active Classifiers : 0 (Max = NO LIMIT)
CM Upstream Filter Group : 0
CM Downstream Filter Group : 0
CPE Upstream Filter Group : 0
CPE Downstream Filter Group : 0
DSA/DSX messages : permit all
Number of Multicast DSIDs Support : 0
IGMP/MLD Version : IGMPv2
FCType10 Forwarding Support : N
Total Time Online : 6d12h
CFG Max IPv6 CPE Prefix : 16 (-1 used)
The following example is a sample output of the show cable modem verbose command that displays the downstream channel information for all CMs:
Router# show cable modem verbose
MAC Address : 0006.2854.740b
Host Interface : C6/1/0/U0
MD-DS-SG / MD-US-SG : 3 / N/A
Primary Downstream : In6/1/0:0 (RfId : 600)
Downstream Channel DCID RF Channel : 193 6/1/0:0
Multi-Transmit Channel Mode : N
Rng Timing Adj Moving Avg(0.381 ns):
Rng Timing Adj Lt Moving Avg :
Uncorrectable Codewords rx :
Downstream Power : 0.00 dBmV (SNR = ----- dB)
QoS Provisioned Mode : DOC1.0
Enable DOCSIS2.0 Mode : Y
Modem Status : {Modem= offline, Security=disabled}
Capabilities : {Frag=N, Concat=N, PHS=N}
Security Capabilities : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities : {L2VPN=N, eSAFE=N}
Sid/Said Limit : {Max US Sids=0, Max DS Saids=0}
Optional Filtering Support : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support : {Taps/Symbol= 0, Num of Taps= 0}
Number of CPE IPs : 0(Max CPE IPs = 16)
Flaps : 8218(Mar 22 03:17:15)
Stn Mtn Failures : 0 aborts, 222 exhausted
Total US Flows : 1(1 active)
Total DS Flows : 1(1 active)
Total US Data : 454 packets, 32291 bytes
Total US Throughput : 0 bits/sec, 0 packets/sec
Total DS Data : 0 packets, 0 bytes
Total DS Throughput : 0 bits/sec, 0 packets/sec
LB group ID assigned (index) : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID in config file : 0
Required DS Attribute Mask : 0x0
Forbidden DS Attribute Mask : 0x0
Required US Attribute Mask : 0x0
Forbidden US Attribute Mask : 0x0
Service Type ID in config file :
Active Classifiers : 0 (Max = NO LIMIT)
CM Upstream Filter Group : 0
CM Downstream Filter Group : 0
CPE Upstream Filter Group : 0
CPE Downstream Filter Group : 0
DSA/DSX messages : permit all
Number of Multicast DSIDs Support : 0
IGMP/MLD Version : IGMPv2
FCType10 Forwarding Support : N
Total Time Online : 00:00
CFG Max IPv6 CPE Prefix : 16 (-1 used)
MAC Address : 0018.6832.0eb2
Host Interface : C6/1/0/U0
MD-DS-SG / MD-US-SG : 3 / N/A
Primary Downstream : In6/1/0:0 (RfId : 600)
Downstream Channel DCID RF Channel : 193 6/1/0:0
Multi-Transmit Channel Mode : N
Upstream Power (dBmV) : 0.00
Upstream SNR (dB) : 36.12
Upstream Data SNR (dB) : --
Received Power (dBmV) : 0.00
Timing Offset (97.6 ns): 1192
Initial Timing Offset : 1192
Rng Timing Adj Moving Avg(0.381 ns): -1
Rng Timing Adj Lt Moving Avg : -7
Rng Timing Adj Minimum : -256
Rng Timing Adj Maximum : 0
Corrected Codewords rx : 0
Uncorrectable Codewords rx : 0
Phy Operating Mode : tdma
Downstream Power : 0.00 dBmV (SNR = ----- dB)
QoS Provisioned Mode : DOC1.1
Enable DOCSIS2.0 Mode : Y
Modem Status : {Modem= online, Security=disabled}
Capabilities : {Frag=Y, Concat=Y, PHS=Y}
Security Capabilities : {Priv=, EAE=N, Key_len=}
L2VPN Capabilities : {L2VPN=N, eSAFE=N}
Sid/Said Limit : {Max US Sids=16, Max DS Saids=15}
Optional Filtering Support : {802.1P=N, 802.1Q=N, DUT=N}
Transmit Equalizer Support : {Taps/Symbol= 1, Num of Taps= 24}
Number of CPE IPs : 0(Max CPE IPs = 16)
Stn Mtn Failures : 0 aborts, 0 exhausted
Total US Flows : 2(2 active)
Total DS Flows : 2(2 active)
Total US Data : 9 packets, 4545 bytes
Total US Throughput : 0 bits/sec, 0 packets/sec
Total DS Data : 9 packets, 3114 bytes
Total DS Throughput : 0 bits/sec, 0 packets/sec
LB group ID assigned (index) : N/A (N/A)
LB group ID in config file (index) : N/A (N/A)
LB policy ID in config file : 0
Required DS Attribute Mask : 0x0
Forbidden DS Attribute Mask : 0x0
Required US Attribute Mask : 0x0
Forbidden US Attribute Mask : 0x0
Service Type ID in config file :
Active Classifiers : 0 (Max = NO LIMIT)
CM Upstream Filter Group : 0
CM Downstream Filter Group : 0
CPE Upstream Filter Group : 0
CPE Downstream Filter Group : 0
DSA/DSX messages : permit all
Number of Multicast DSIDs Support : 0
IGMP/MLD Version : IGMPv2
FCType10 Forwarding Support : N
Total Time Online : 4d14h
CFG Max IPv6 CPE Prefix : 16 (-1 used)
Example of the show cable modem Command Output on the Cisco uBR7225VXR and Cisco uBR7246VXR Routers
The following example shows the sample output for the cm-status option in Cisco IOS Release 12.2(33)SCD on a Cisco uBR7246VXR router:
Router# show cable modem cm-status
I/F MAC Address Event TID Count Error Dups Time
C5/0 001e.6bfb.29a6 Seq out-of-range 1 1 0 1 Jan 18 09:00:19
C7/0 001c.ea2b.79b2 MDD timeout 0 0 1 0 Jan 11 11:29:22
QAM failure 0 0 1 0 Jan 11 11:29:02
MDD recovery 0 0 1 0 Jan 11 11:30:20
QAM recovery 0 0 1 0 Jan 11 11:30:13
C7/0 001c.ea2b.78b0 MDD timeout 0 0 1 0 Jan 11 11:29:16
QAM failure 0 0 1 0 Jan 11 11:28:53
MDD recovery 0 0 1 0 Jan 11 11:29:59
QAM recovery 0 0 1 0 Jan 11 11:29:46
The following example shows the sample output of the queue option for a particular CM in Cisco IOS Release 12.2(33)SCD:
Router# show cable modem 40.3.192.2 queue
* idx/gqid Len/Limit Deqs Drops CIR MIR/PR ForwInt SFID
3/43 0/128 103 0 0 0/0 In5/1:1 Ca5/1:22
Example of the show cable modem Command Output for Partial Service Mode
The following example shows the sample output of the show cable modem command that displays the cable modems that are in upstream (indicated by "p" under I/F) and downstream partial service mode (indicated by "p-online" under MAC State):
MAC Address IP Address I/F MAC Prim RxPwr Timing Num I
State Sid (dBmv) Offset CPE P
0016.9252.9ac0 2.99.81.4 C7/0/0/U0 online(pt) 1 0.00 1332 0 N
000f.2172.229d 2.99.81.36 C7/0/0/U3 online(pt) 2 0.50 1778 0 N
001e.6bfb.33a0 2.99.81.14 C7/0/0/p p-online(pt) 3 -0.50 1424 0 N
0022.cef4.3d9a 2.99.81.23 C7/0/0/p p-online(pt) 4 0.00 1438 0 N
0019.474a.c456 2.99.81.18 C7/0/0/U3 online(pt) 5 0.00 1336 0 N
001e.6bfb.194e 2.99.81.32 C7/0/0/p p-online(pt) 6 -0.50 1422 0 N
00e0.6f8b.a888 2.99.81.31 C7/0/0/U3 online(pt) 7 0.50 1427 0 N
001e.6bfb.1538 2.99.81.38 C7/0/0/p p-online(pt) 8 0.00 1423 0 N
001e.6bfb.0d22 2.99.81.29 C7/0/0/p p-online(pt) 9 0.00 1738 0 N
001e.6bfb.1a7e 2.99.81.30 C7/0/0/p p-online(pt) 10 0.00 1738 0 N
0019.474a.c418 2.99.81.75 C7/0/0/U1 online(pt) 11 0.00 1335 0 N
001e.6bfa.f58a 2.99.81.9 C7/0/0/p p-online(pt) 12 0.00 1737 0 N
0022.cef4.3fa2 2.99.81.24 C7/0/0/p p-online(pt) 13 0.00 1438 0 N
001e.6bfb.1b72 2.99.81.10 C7/0/0/p p-online(pt) 14 -0.50 1425 0 N
0019.474a.c330 2.99.81.34 C7/0/0/U0 online(pt) 15 0.00 1028 0 N
0023.be50.e578 2.99.81.17 C7/0/0/UB p-online(pt) 16 0.00 1805 0 N
0025.2e2d.784a 2.99.81.28 C7/0/0/UB p-online(pt) 17 0.50 1798 0 N
0025.2e2d.748c 2.99.81.26 C7/0/0/UB p-online(pt) 18 0.00 1798 0 N
001e.6bfa.f070 2.99.81.37 C7/0/0/U3 online(pt) 20 0.50 1735 0 N
0019.474a.c422 2.99.81.20 C8/0/0/U1 online(pt) 1 0.50 1340 0 N
0019.474a.c466 2.99.81.21 C8/0/0/U1 online(pt) 2 0.00 1334 0 N
001e.6bfb.2e96 2.99.81.33 C8/0/0/UB w-online(pt) 3 0.00 1738 0 N
Table 5 describes the significant fields shown in the display:
Table 5 show cable modem Field Descriptions
Field
|
Description
|
MAC Address
|
MAC address for the CM.
|
IP Address
|
IP address that the DHCP server has assigned to the CM.
|
IPv6 Address
|
IPv6 address that the DHCP server has assigned to the CM.
|
Dual IP
|
Support of dual IP for both IPv4 and IPv6 addressing.
|
I/F, Interface
|
Cable interface line card providing the upstream for this CM.
|
sysDescr
|
Vendor and model of the cable modem, as reported by the cable modem. This field displays a value only when the cable modem remote-query command is configured.
|
Upstream Power
Downstream Power
|
Upstream and Downstream Power fields are displayed only if the CM remote-query feature has been enabled using the cable modem remote-query command. Upstream Power displays the CM transmit level in dBmV, and Downstream Power displays the dBmV level received at the CM, as measured by the CMTS.
|
MAC State
|
Current state of the MAC layer.
|
Prim SID
|
Primary SID assigned to this CM.
|
Host Interface
|
Host interface name.
|
Primary Wideband Channel ID
|
Bonding group ID of the wideband interface assigned to the CM.
|
MD-DS-SG
|
MAC Domain Downstream Service Group, the downstream channels of a single MAC domain that reach the cable modem.
|
DSID
|
Downstream Service Identifier.
|
Primary Downstream
|
Primary downstream channel assigned to the CM.
|
Wideband Capable
|
Cable modem is wideband-capable or not.
|
Downstream Channel DCID RF Channel
|
Downstream channel and channel ID used by a CM.
|
Multi-Transmit Channel Mode
|
Cable modem is in MTC mode or not.
|
Upstream SNR
|
Upstream signal-to-noise ratio (SNR) for a particular cable modem (CM), in decibels (dB).
|
Upstream SM MER (dB)
|
Upstream station maintenance (SM) modulation error ratio (MER) for a particular cable modem, in decibels (dB).
|
Upstream Data MER (dB)
|
Upstream modulation error ratio (MER) for a particular cable modem, in decibels (dB). This field is displayed only when RF adaptation is enabled.
|
RxPwr, Received Power
|
Average power in dBmV for the upstream channel symbol rate for the CM. With default settings, 0 dBmV is considered optimal, but a range of -1 to 1 dBmV is allowable. When CMs exceed this range, older Cisco IOS releases supported a drop to as low as -2 dBmV. Recent Cisco IOS releases support a drop to as low as -4 dBmV.
This field supports a resolution of 0.25 dBmV, but the dB resolution level for CMs and for the Cisco CMTS are slightly higher—approximately 1.0 and 1.4 dB.
Note An asterisk (*) in the RxPwr column indicates that a power adjustment has been made for that CM. An exclamation point (!) indicates that the CM has reached its maximum power transmit level and cannot increase its power level further.
|
Timing Offset and Initial Timing Offset
|
Timing offset for the CM, in ticks, as recognized on the CMTS. (A tick, as used here, is 6.25/64 microseconds.) This is the delay between when a particular cable modem is scheduled to make a transmission and when the CMTS actually receives it.
Note An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command.
Note The timing offset shown here is typically smaller than the TX Time Offset value shown by the show cable modem remote-query command, because the latter value is the offset as recognized on the CM (which will include any internal delay between when the CM software begins the transmission and when the bits actually appear on the local cable interface).
|
Reported Transmit Power (dBmV)
|
Reported Transmit Power level by the cable modem for each upstream channel. This applies only to the cable modems operating in the MTC mode.
|
Peak Transmit Power (dBmV)
|
This is the maximum transmit power level that the cable modem in the MTC mode could transmit at for the upstream channel.
|
Minimum Transmit Power (dBmV)
|
This is the minimum transmit power level that the cable modem in the MTC mode could transmit at for the upstream channel.
|
Rng Timing Adj Moving Avg(0.381 ns): Rng Timing Adj Lt Moving Avg: Rng Timing Adj Minimum: Rng Timing Adj Maximum:
|
A Cisco CMTS router tracking variables to see relative timing offset adjustments.
|
Pre-EQ Good : Pre-EQ Scaled : Pre-EQ Impulse: Pre-EQ Direct Loads
|
Equalizer statistics counter.
|
Good Codewords rx
|
Good code words for a particular upstream channel. This counter is reset during interface reset.
|
Corrected Codewords rx
|
Correctable code words for a particular upstream channel. This counter is reset during interface reset.
|
Uncorrectable Codewords rx
|
Uncorrectable code words for a particular upstream channel. This counter is reset during interface reset.
|
sysDescr
|
Identifies the vendor and model of the cable modem, as reported by the cable modem. This field displays a value only when the cable modem remote-query.
|
Num CPEs, CFG Max-CPE
|
Indicates the number of CPE devices for which the CM is providing services.
|
Number of CPE IPs
|
Indicates the maximum number of IP addresses assigned to CPE devices behind this CM, as configured by the cable max-hosts command.
|
Ver, MAC Version
|
Displays the maximum supported version of DOCSIS that the CM supports (DOCSIS 1.0, DOCSIS 1.1, DOCSIS 2.0).
|
QoS Prov, QoS Provisioned Mode
|
Displays the version of DOCSIS that the CM currently is provisioned for (DOCSIS 1.0, DOCSIS 1.1, DOCSIS 2.0).
|
Enable DOCSIS 2.0 Mode
|
Indicates that the cable modems are allowed to come online when in mixed-mode environments such as DOCSIS 1.0 TDMA, DOCSIS 1.1 TDMA and DOCSIS 2.0 ATDMA. This value is set to Y by default, unless the TLV 39 has been set to disabled (0) in the CM's Registration Request message or in the DOCSIS configuration file.
|
Phy Operating Mode
|
Indicates the type of PHY-layer modulation that the CM is using: tdma or atdma. Also indicates the TDMA/ATDMA/SCDA mode that the cable modem is operating on a specific channel.
|
Modem Status
|
Indicates the overall modem state and the security state of the primary SID.
|
BPI Enbld, BPI
|
Indicates whether or not Baseline Privacy Interface (BPI) or BPI Plus (BPI+) encryption is enabled for the CM.
|
DIP
|
Dual IP flag. Identifies whether or not ("Y" or "N") the CM or CPE supports both IPv4 and IPv6 addressing.
|
Capabilities
|
Indicates what the CM reported as its capabilities in its Registration Request message: DOCSIS fragmentation, concatenation, packet header suppression (PHS), and BPI encryption.
|
Security Capabilities
|
Indicates the privacy mode used by the CM (BPI or BPI+), early authentication and encryption (EAE) support, and the Key Length.
|
Optional Filtering Support
|
Indicates whether 802.1P or 802.1Q packet filtering is enabled for this CM.
|
Transmit Equalizer Support
|
Number of taps being used for transmit equalization.
|
Flaps
|
Number of flaps reported by this CM, with the date and time of the last flap within the parentheses.
|
Errors
|
Number of frame CRC and HCS errors reported for this CM.
|
Stn Mtn Failures
|
Number of station maintenance (cable keepalive) messages that the CMTS sent to this CM but did not receive any reply.
|
Total US Flows
|
Total number of upstream service flows, with the number of active service flows within the parentheses.
|
Total DS Flows
|
Total number of downstream service flows, with the number of active service flows within the parentheses.
|
Total US Data
|
Total data this CM has transmitted on the upstream, in packets and bytes.
|
Total US Throughput
|
Calculated throughput for this CM on the upstream, if available.
|
Total DS Data
|
Total data this CM has received on the downstream, in packets and bytes.
|
Total DS Throughput
|
Calculated throughput for this CM on the downstream, if available.
|
Active Classifiers
|
Current number of active classifiers for this CM, with the maximum number of allowable classifiers for this CM within the parentheses.
|
CM Required Attribute
|
Indicates the current required attribute-mask value.
|
CM Forbidden Attribute
|
Indicates the current forbidden attribute-mask value.
|
DSA/DSX messages
|
Indicates whether dynamic service changes (DSX) from the cable modem are permitted (permit all) or disallowed (reject all).
|
Voice Enabled
|
Indicates whether the CM is voice-enabled.
|
Number of Multicast DSIDs Support
|
Indicates the total number of supported multicast DSIDs.
|
FCType10 Forwarding Support
|
Indicates FCType10 Forwarding Support.
|
Dynamic Secret
|
Dynamically-generated shared secret (a 16-byte hexadecimal value) that was used in the cable modem's previous registration cycle. If the cable modem is currently offline, this field shows all zeroes.
Note This field displays a value only when the cable dynamic-secret command has been used on the CMTS interface.
|
Total Time Online
|
Amount of time in days, hours, and minutes that this CM has been continuously online since it last registered with the CMTS. This field begins incrementing whenever the CM enters one of the online(x) MAC states, and is reset to 0 whenever the CM enters any other MAC state.
|
Event
|
Event type.
|
TID
|
Transaction identifier.
|
Count
|
Number of valid messages received.
|
Dups
|
Number of duplicate messages received.
|
Time
|
Time when last valid event was received.
|
Len/Limit Pkts
|
Queue length and limit in packets.
|
Deqs Pkts
|
Dequeue packets.
|
Drops Pkts
|
Dropped packets.
|
CIR Kbps
|
Committed information rate.
|
MIR/PR Kbps
|
Maximum information and peak rate.
|
Forwint
|
Forwarding interface.
|
SFID
|
Service flow identifier.
|
BE Queues
|
Best effort queues.
|
CIR Queues
|
Committed information rate queues.
|
Low Latency Queues
|
Low latency queues.
|
Table 23 shows the possible values for the MAC state field:
Table 6 Descriptions for the MAC State Field 1
MAC State Value
|
Description
|
Ranging Status Conditions for Devices Using IPv4 Addressing
|
init(r1)
|
The CM sent initial ranging.
|
init(r2)
|
The CM is ranging. The CMTS received initial ranging from the Cm and has sent RF power, timing offset, and frequency adjustments to the CM.
|
init(rc)
|
Ranging has completed.
Note If a CM appears to be stuck in this state, it could be that the CM is able to communicate successfully on the cable network, but that the upstream is at capacity and does not have any additional bandwidth to allow the CM to finish registration and come online. Either manually move one or more CMs to other upstreams, or enable load balancing on the upstream using the cable load-balance group commands.
|
Early Authentication and Encryption
|
assign(epk)
|
BPI is enabled and KEK is assigned.
|
assign(ept)
|
BPI is enabled and TEK is assigned. The registration messages will be encrypted.
|
Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing
If early authentication and encryption is used, the letter `s' is appended to these states to indicate secure registration.
|
init(d)
|
The DHCP request was received, as DHCPDISCOVER. This also indicates that the first IP broadcast packet has been received from the CM.
|
init(dr)
|
The DHCP request has been sent to the cable modem.
|
init(i)
|
The cable modem has received the DHCPOFFER reply (DHCPACK) from the DHCP server that has assigned an IP address to the modem, but the modem has not yet replied with a DHCPREQUEST message requesting that particular IP address, nor has it sent an IP packet with that IP address.
Note If a CM appears to be stuck in this state, the CM has likely received the DHCPOFFER reply from the DHCP server, but this reply might have contained one or more invalid options for that particular CM.
|
init(io)
|
The Cisco CMTS has seen the DHCP offer as sent to the cable modem from the DHCP server that has assigned an IP address to the modem.
|
init(o)
|
The CM has begun to download the option file (DOCSIS configuration file) using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP response. If the CM remains in this state, it indicates that the download has failed.
|
init(t)
|
Time-of-day (TOD) exchange has started.
|
Registration and Provisioning Status Conditions for Devices Using IPv6 Addressing
If early authentication and encryption is used, the letter `s' is appended to these states to indicate secure registration.
|
init6(s)
|
The Cisco CMTS router has seen the DHCPv6 SOLICIT message from the CM.
|
init6(a)
|
The Cisco CMTS router has seen the ADVERTISE message from the DHCPv6 server to the CM.
|
init6(r)
|
The Cisco CMTS router has seen the REQUEST response from the CM to the DHCPv6 server.
|
init6(i)
|
The Cisco CMTS router has seen the REPLY message from the DHCPv6 server to the CM.
|
init6(o)
|
The Cisco CMTS router has seen the REQEST message from the CM to the TFTP server.
|
init6(t)
|
The Cisco CMTS router has seen the REQUEST message from the CM to the TOD server.
|
Non-error Status Conditions
|
cc(r1)
|
The CM had registered and was online, but has received a Downstream Channel Change (DCC) or Upstream Channel Change (UCC) request message from the CMTS. The CM has begun moving to the new channel, and the CMTS has received the CM's initial ranging on the new downstream or upstream channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.
|
cc(r2)
|
This state should normally follow cc(r1) and indicates that the CM has finished its initial ranging on the new channel, and is currently performing continuous ranging on the new channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.
|
offline
|
The CM is considered offline (disconnected or powered down).
|
resetting
|
The CM is being reset and will shortly restart the ranging and registration process.
|
online
|
The CM has registered and is enabled to pass data on the network.
|
online(d)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. The CM does not forward traffic to or from the CPE devices, but the CMTS can continue to communicate with the CM using DOCSIS messages and IP traffic (such as SNMP commands).
Note If BPI was enabled in the DOCSIS configuration file sent to the CM, assume that the CM is using BPI encryption, unless other messages show that the BPI negotiation and key assignments have failed.
|
online(pkd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and KEK is assigned.
Note This state is equivalent to the online(d) and online(pk) states.
|
online(ptd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and TEK is assigned. BPI encryption is now being performed.
Note This state is equivalent to the online(d) and online(pt) states.
|
online(pk)
|
The CM registered, BPI is enabled and KEK is assigned.
|
online(pt)
|
The CM registered, BPI is enabled and TEK is assigned. BPI encryption is now being performed.
Note If network access was disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) instead of online(pt) even when BPI encryption is enabled and operational.
|
expire(epk)
|
Early authentication and encryption is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.
|
expire(pkd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pk) states.
|
expire(ept)
|
Early authentication and encryption is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.
|
expire(ptd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pt) states.
|
Error Status Conditions
|
reject(m)
|
The CM attempted to register but registration was refused due to a bad Message Integrity Check (MIC) value. This also could indicate that the shared secret in the DOCSIS configuration file does not match the value configured on the CMTS with the cable shared-secret command.
In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases, this could also indicate that the cable tftp-enforce command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so.
|
reject(c)
|
The CM attempted to register, but registration was refused due to a a number of possible errors:
• The CM attempted to register with a minimum guaranteed upstream bandwidth that would exceed the limits imposed by the cable upstream admission-control command.
• The CM has been disabled because of a security violation.
• A bad class of service (COS) value in the DOCSIS configuration file.
• The CM attempted to create a new COS configuration but the CMTS is configured to not permit such changes.
• The CM failed the timestamp check for its DOCSIS configuration file. (This could indicate a possible theft-of-service attempt, or a problem with the synchronization of the clocks on the CM and CMTS.)
|
reject(epk)
|
Early authentication and encryption is enabled, KEK key assignment is rejected, and the modem has not been authenticated.
|
reject(pk)
|
KEK key assignment is rejected, and the modem has not been authenticated.
|
reject(pkd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because KEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pk) states.
|
reject(ept)
|
Early authentication and encryption is enabled, TEK key assignment is rejected, and BPI encryption has not been established.
|
reject(ptd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because TEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pt) states.
|
reject(ts)
|
The CM attempted to register, but registration failed because the TFTP server timestamp in the CM registration request did not match the timestamp maintained by the CMTS. This might indicate that the CM attempted to register by replaying an old DOCSIS configuration file used during a prior registration attempt.
|
reject(ip)
|
The CM attempted to register, but registration failed because the IP address in the CM request did not match the IP address that the TFTP server recorded when it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.
|
reject(na)
|
The CM attempted to register, but registration failed because the CM did not send a Registration-Acknowledgement (REG-ACK) message in reply to the Registration-Response (REG-RSP) message sent by the CMTS. A Registration-NonAcknowledgement (REG-NACK) is assumed.
|
|
1 The following symbols appended to the modem state indicate a special condition:
• 1 An exclamation mark (!) indicates that the cable dynamic-secret command is used with either the mark or reject keyword and the cable modem has failed the dynamic secret authentication check.
• 1 An ampersand (&) indicates that the cable modem has registered using a self-signed certificate. This is inherently not secure and can be avoided by negating the cable privacy accept-self-signed-certificate command.
• 1 A hash sign (#) indicates that the cable modem is using an unknown configuration file. To solve this problem, use the cable dynamic-secret command with the reject keyword. This will reject registration for CMs with DOCSIS configuration files.
1 In Cisco IOS Releases 12.1(20)EC, 12.2(15)BC1, and earlier releases, when network access is disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) even if BPI encryption fails.
|

Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Related Commands
Command
|
Description
|
cable modem vendor
|
Associates the name of a vendor with its Organizational Unique Identifier (OUI).
|
show cable modem access-group
|
Displays the access groups for the CMs on a particular cable interface.
|
show cable modem calls
|
Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.
|
show cable modem classifiers
|
Displays information about the classifiers for a particular CM.
|
show cable modem cnr
|
Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.
|
show cable modem connectivity
|
Displays connectivity statistics for one or more CMs.
|
show cable modem counters
|
Displays downstream and upstream traffic counters for one or more CMs.
|
show cable modem cpe
|
Displays the CPE devices accessing the cable interface through a particular CM.
|
show cable modem domain-name
|
Updates the cable-specific DNS cache and display the domain name for specified CMs and CPE behind a CM on a Cisco CMTS router.
|
show cable modem errors
|
Displays error statistics for one or more CMs.
|
show cable modem flap
|
Displays flap list statistics for one or more CMs.
|
show cable modem ipv6
|
Displays IPv6 information for specified CMs and CPE behind a CM on a Cisco CMTS router.
|
show cable modem mac
|
Displays MAC layer information for one or more CMs.
|
show cable modem maintenance
|
Displays station maintenance (SM) error statistics for one or more CMs.
|
show cable modem offline
|
Displays a list of the CMs that are marked as offline with the Cisco CMTS.
|
show cable modem partial-mode
|
Displays information about the cable modems that are in upstream and downstream partial service mode.
|
show cable modem phy
|
Displays the DOCSIS PHY layer information for one or more CMs.
|
show cable modem qos
|
Displays quality of service (QoS) and service flow information for a particular CM.
|
show cable modem registered
|
Displays a list of the CMs that are marked as registered with the Cisco CMTS.
|
show cable modem remote-query
|
Displays information collected by the remote-query feature.
|
show cable modem rf-adapt
|
Displays RF adaptation information for cable modems.
|
show cable modem summary
|
Displays a summary of CMs on one or more cable interfaces.
|
show cable modem unregistered
|
Displays a list of the CMs that are marked as unregistered with the Cisco CMTS.
|
show cable modem vendor
|
Displays the vendor name or Organizational Unique Identifier (OUI) for the CMs on each cable interface.
|
show cable modulation-profile
|
Displays modulation profile group information.
|
show interface cable modem
|
Displays information about the CMs connected to a particular cable interface.
|
show interface cable sid
|
Displays cable interface information.
|
show cable modem access-group
To display the access groups for the CMs on a particular cable interface, use the show cable modem access-group command in privileged EXEC mode.
Cisco uBR7100 series and Cisco uBR7200 series routers:
show cable modem [ip-address | cable {slot/port | slot/cable-interface-index} [upstream port
[logical-channel-index]] | mac-address] access-group
Cisco uBR10012 routers:
show cable modem cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port
[logical-channel-index]] access-group
Syntax Description
ip-address
|
(Optional) Access-group information displayed for the CM with the specified IP address. (Cisco uBR7100 series and Cisco uBR7200 series routers only.)
|
mac-address
|
(Optional) Access-group information displayed for the CM with the specified MAC address. (Cisco uBR7100 series and Cisco uBR7200 series routers only.)
|
slot
|
Slot where the line card resides.
• Cisco uBR7225VXR router—The valid value is 1 or 2.
• Cisco uBR7246VXR router—The valid range is from 3 to 6.
• Cisco uBR10012 router—The valid range is from 5 to 8.
|
subslot
|
(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
|
port
|
Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.
• Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).
|
cable-interface-index
|
Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.
• Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
upstream port
|
(Optional) Displays information for all CMs using this specific upstream. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports on the cable interface line card.
|
logical-channel-index
|
(Optional) Logical channel index. The valid values are 0 or 1.
|
access-group
|
Displays the access groups for the CMs and their associated hosts and other customer premises equipment (CPE) devices.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
11.3XA
|
This command was introduced.
|
12.2(4)BC1
|
Support for this command was added for the Cisco uBR10012 router, but only to display access groups on a per-interface basis.
|
12.2(33)SCE
|
This command was modified. The port parameter was changed to cable-interface-index.
|
12.2(33)SCF
|
This command was modified. The logical-channel-index argument was added.
|
Usage Guidelines
This command displays information only for CMs. To display information for both CMs and their associated hosts and other customer premises equipment (CPE) devices, use the show cable device access-group command. To display information only for hosts, use the show cable host access-group command.
If an SNMP manager is requesting information about CM or CPE devices at the same time that this command is given, the command displays the following error message:
No information is available, please try later.
Wait until the SNMP retrieval is done and retry the CLI command.
Note
Also see the information about this command's behavior in a Hot Standby Connection-to-Connection Protocol (HCCP) configuration.
Examples
The following example shows sample output for the show cable modem access-group command on a Cisco uBR7200 series router for a particular CM:
Router# show cable modem 0010.7bb3.fcd1 access-group
MAC Address IP Address Access-group
0010.7bb3.fcd1 10.20.113.2 34
Upstream Power : 42 dBmV (SNR = 10 dBmV)
Downstream Power : 15 dBmV (SNR = 15 dBmV)
Note
The upstream and downstream power fields will be displayed only if the CM remote-query feature has been enabled using the cable modem remote-query command.
The following example shows sample output for the show cable modem access-group command for a particular cable interface on a Cisco uBR10012 router:
Router# show cable modem c8/1/0 access-group
MAC Address IP Address Access-group
0050.7366.1243 22.1.1.11 1
0002.b970.0027 23.1.1.10 1
0006.5314.858d 22.1.1.10 N/A
Table 0-7 describes the fields that are shown in the show cable modem access-group display:
Table 0-7 Descriptions for the show cable modem access-group Fields
Field
|
Description
|
MAC Address
|
The MAC address for the CM.
|
IP Address
|
The IP address that the DHCP server has assigned to the CM.
|
Access-group
|
Displays the access group name or number in use (if any) for this CM.
|
Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Related Commands
Command
|
Description
|
cable modem vendor
|
Associates the name of a vendor with its Organizational Unique Identifier (OUI).
|
show cable device access-group
|
Displays a list of CMs and their CPE devices, along with their access groups.
|
show cable host access-group
|
Displays a list of hosts and other CPE devices, along with their access groups.
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem calls
|
Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.
|
show cable modem classifiers
|
Displays information about the classifiers for a particular CM.
|
show cable modem cnr
|
Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.
|
show cable modem connectivity
|
Displays connectivity statistics for one or more CMs.
|
show cable modem cpe
|
Displays the CPE devices accessing the cable interface through a particular CM.
|
show cable modem errors
|
Displays error statistics for one or more CMs.
|
show cable modem flap
|
Displays flap list statistics for one or more cable modems.
|
show cable modem maintenance
|
Displays station maintenance (SM) error statistics for one or more cable modems.
|
show cable modem remote-query
|
Displays information collected by the remote-query feature.
|
show cable modem rf-adapt
|
Displays RF adaptation information for cable modems.
|
show cable modulation-profile
|
Displays modulation profile group information.
|
show interface cable modem
|
Displays information about the CMs connected to a particular cable interface.
|
show interface cable sid
|
Displays cable interface information.
|
show cable modem auth-profile
To display the multicast authorization profile, and profile group information for a particular IP address or MAC address, use the show cable modem auth-profile command in privileged EXEC mode.
show cable modem [ip-address | mac-address] [auth-profile]
Syntax Description
ip-address
|
(Optional) IPv4 or IPv6 address of a CM that is displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.
|
mac-address
|
(Optional) MAC address of a CM that is displayed. You can also specify the MAC address for a CPE device behind a CM, and information for that CM will be displayed.
|
auth-profile
|
(Optional) Displays the multicast authorization profile, and profile group information.
|
Command Default
None
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCB
|
This command was introduced.
|
Usage Guidelines
Use this command to display the multicast authorization profile, and the profile group information.
Examples
The following sample output of the show cable modem auth-profile command shows the multicast authorization profile and profile group display for a particular ip-address or mac-address.
Router# show cable modem 30.17.2.23 auth-profile
Multicast Profile Information for 0025.2e34.4377
Multicast Profile Group # : default
Related Commands
Command
|
Description
|
show cable multicast authorization
|
Displays the list of defined multicast authorization profiles and all CMs associated with corresponding profiles.
|
show cable multicast dsid
|
Displays the entire multicast downstream service identifier (DSID) database content.
|
show cable multicast qos
|
Displays the configuration information for MQoS (Group-Config, Group-QoS-Config, Group-Encryption-Config).
|
show cable modem calls
To display voice call information for a particular CM, use the show cable modem calls command in privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] calls
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] calls
Syntax Description
ip-address
|
(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.
|
mac-address
|
(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.
|
slot
|
Slot where the line card resides.
• Cisco uBR7225VXR router—The valid value is 1 or 2.
• Cisco uBR7246VXR router—The valid range is from 3 to 6.
• Cisco uBR10012 router—The valid range is from 5 to 8.
|
subslot
|
(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
|
port
|
Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.
• Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).
|
cable-interface-index
|
Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.
• Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
upstream port
|
(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.
|
logical-channel-index
|
(Optional) Logical channel index. The valid values are 0 or 1.
|
name fqdn
|
(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.
|
calls
|
Display voice call information for a CM.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.3(13a)BC1
|
Support for voice call information was added to the show cable modem command.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was added.
• The name keyword option was added for specifying the fully-qualified domain name of a CM.
|
12.2(33)SCE
|
This command was modified. The port parameter was changed to cable-interface-index.
|
12.2(33)SCF
|
This command was modified. The logical-channel-index argument was added.
|
Usage Guidelines
Using the keyword options, you can display IPv6 information by IP address (IPv4 or IPv6) of a particular CM, for all CMs associated with a specified cable interface, by MAC address of a CM, or by domain name of a CM.
Note
In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.
This command supports PacketCable and PacketCable MultiMedia (PCMM) information. Additional information for voice call support with PacketCable and PacketCable MultiMedia (PCMM) is available in the feature document PacketCable and PacketCable Multimedia for the Cisco CMTS available on Cisco.com:
Examples
The following example shows sample output for the default calls option for a particular CM:
Router# show cable modem calls
Cable Modem Call Status Flags:
H: Active high priority calls
R: Recent high priority calls
V: Active voice calls (including high priority)
MAC Address IP Address I/F Prim CMCallStatus LatestHiPriCall
000f.66f8.a121 10.8.130.63 C4/0/U0 175 HV -
Related Commands
Command
|
Description
|
cable modem vendor
|
Associates the name of a vendor with its Organizational Unique Identifier (OUI).
|
show cable calls
|
Displays voice call history information and status for the PacketCable Emergency 911 Services Listing and History feature.
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem classifiers
|
Displays information about the classifiers for a particular CM.
|
show cable modem cnr
|
Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.
|
show cable modem connectivity
|
Displays connectivity statistics for one or more CMs.
|
show cable modem errors
|
Displays error statistics for one or more CMs.
|
show cable modem flap
|
Displays flap list statistics for one or more cable modems.
|
show cable modem maintenance
|
Displays station maintenance (SM) error statistics for one or more cable modems.
|
show cable modem remote-query
|
Displays information collected by the remote-query feature.
|
show cable modem rf-adapt
|
Displays RF adaptation information for cable modems.
|
show cable modulation-profile
|
Displays modulation profile group information.
|
show interface cable modem
|
Displays information about the CMs connected to a particular cable interface.
|
show interface cable sid
|
Displays cable interface information.
|
show cable modem classifiers
To display information about the classifiers for a particular CM, use the show cable modem classifiers command in privileged EXEC mode.
show cable modem {ip-address | mac-address} [name fqdn] classifiers [cache | verbose]
Syntax Description
ip-address
|
Specifies the IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, classifier information for that CM is displayed.
|
mac-address
|
Displays classifier information for the CM with the specified MAC address. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.
|
name fqdn
|
(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.
|
cache
|
(Optional) Displays the classifiers in the cache maintained for each CM. (This cache is based on IP header field values and speeds up classifier lookups and reduces per-packet processing overhead.)
|
verbose
|
(Optional) Displays detailed information for the CM classifiers.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
11.3 NA
|
This command was introduced.
|
12.1(4)CX and 12.2(4)BC1
|
The number of matches field was added to this command, and the command was restricted to display information for a single CM at a time.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was added.
• The name keyword option was added for specifying the fully-qualified domain name of a CM.
|
Usage Guidelines
This command displays classifier information for a particular CM, identified either by its IP address, MAC address, or domain name.
Note
In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.
Note
For information about this command's behavior in a Hot Standby Connection-to-Connection Protocol (HCCP) configuration, see the "Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration" section of the show cable modem command.
Examples
The following example shows sample output for the default classifiers option for a particular CM:
Router# show cable modem 10.4.0.81 classifiers
CfrId SFID CM Mac Address Direction State Priority Matches
6431 26120 0000.399f.a44f upstream active 128 -
6429 26054 0000.399f.a44f upstream active 128 -
6432 26121 0000.399f.a44f downstream active 128 1182
6430 26055 0000.399f.a44f downstream active 128 3934
Table 8 describes the fields that are shown in the show cable modem classifiers display:
Table 8 Descriptions for the show cable modem classifiers Fields
Field
|
Description
|
CfrID
|
Classifier ID for the classifier that is being displayed.
|
SFID
|
Service flow ID (SFID) for this classifier.
|
CM MAC Address
|
MAC address for the CM.
|
Direction
|
Identifies whether this classifier applies to the downstream or the upstream direction.
|
State
|
Classifier activation state: active or inactive.
|
Priority
|
Classifier rule priority value for this classifier.
|
Matches
|
Number of packets that have been matched to this service flow.
|
Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Related Commands
Command
|
Description
|
cable modem vendor
|
Associates the name of a vendor with its Organizational Unique Identifier (OUI).
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem calls
|
Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.
|
show cable modem cnr
|
Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.
|
show cable modem connectivity
|
Displays connectivity statistics for one or more CMs.
|
show cable modem errors
|
Displays error statistics for one or more CMs.
|
show cable modem flap
|
Displays flap list statistics for one or more cable modems.
|
show cable modem maintenance
|
Displays station maintenance (SM) error statistics for one or more cable modems.
|
show cable modem remote-query
|
Displays information collected by the remote-query feature.
|
show cable modulation-profile
|
Displays modulation profile group information.
|
show interface cable modem
|
Displays information about the CMs connected to a particular cable interface.
|
show interface cable sid
|
Displays cable interface information.
|
show cable modem cnr
To display information about the upstream carrier-to-noise ratio (CNR) or signal-to-noise ratio (SNR) for a particular cable modem (CM), use the show cable modem command in privileged EXEC mode.
show cable modem {ip-address | mac-address | name fqdn} cnr
Syntax Description
ip-address
|
IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a customer premise equipment (CPE) device behind a CM, classifier information for that CM is displayed.
|
mac-address
|
Classifier information for the CM with the specified MAC address. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.
|
name fqdn
|
Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable domain name system (DNS) cache on the Cisco CMTS router.
|
Command Modes
Privileged EXEC (#)
Command History
This table includes the following release-specific history entries:
•
BC Release
•
CX Release
•
SC Release
BC Release
|
Modification
|
12.2(4)BC2
|
The command was changed to its current form of show cable modem cnr.
|
12.2(8)BC2
|
Support was added for the Cisco uBR-LCP2-MC16S cable interface line card on the Cisco uBR10012 router.
|
12.2(11)BC3
|
Support was added for the Cisco uBR10-MC5X20S cable interface line cards on the Cisco uBR10012 router.
|
12.2(15)BC1
|
If a cable modem is offline, its CNR value is now shown as "-----".
|
12.2(15)BC2
|
Support was added for the Cisco uBR-MC16U/X and Cisco uBR-MC5X20U cable interface line cards.
|
12.3(17a)BC2
|
Support was added for the Cisco uBR-MC5X20H cable interface line card.
|
CX Release
|
Modification
|
12.1(7)CX1
|
This command was introduced (in the form of show cable modem snr) for Cisco uBR7200 series routers using the Cisco uBR-MC16S cable interface line card.
|
12.2(15)CX
|
Support was added for the Cisco uBR-MC28U/X cable interface line cards on the Cisco uBR7246VXR router.
|
SC Release
|
Modification
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was added.
• The name keyword option was added for specifying the fully-qualified domain name of a CM.
• The following new initialization states were added to show initialization of CMs and CPEs supporting IPv6:
– init6(s)—Cisco CMTS router has seen SOLICIT message.
– init6(a)—Cisco CMTS router has seen ADVERTISE message.
– init6(r)—Cisco CMTS router has seen REQUEST message.
– init6(i)—Cisco CMTS router has seen REPLY message.
– init6(o)—Cisco CMTS router has seen version 6 TFTP request.
– init6(t)—Cisco CMTS router has seen version 6 TOD request.
|
12.2(33)SCC
|
The output of this command was modified to show the CNR and SNR information for multiple upstream connections providing service to a single CM.
|
12.2(33)SCF
|
The output of this command was modified to show expected power level, received carrier power level, and CNR information for all the upstream channels providing services to a CM. The SNR information is no longer displayed in the output of this command.
|
Usage Guidelines
The show cable modem cnr command displays information on the current CNR value for cable modems that are using interfaces on the following cable line cards:
•
Cisco uBR-MC16U/X
•
Cisco uBR-MC28U/X
•
Cisco uBR10-MC5X20S/U/H
•
Cisco uBR-E-28U
•
Cisco uBR-E-16U
For cable modems on all other interfaces, this command displays information about the current SNR value of the modem.
In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the Cisco CMTS router before any domain name can be used as part of a cable command.
Starting Cisco IOS Release 12.2(33)SCF, carrier-to-noise plus interference ratio (CNiR [CNR]) can be measured for all upstream channels irrespective of whether spectrum management is enabled or not for the upstream channels. Therefore, the output of the show cable modem cnr command displays only the CNR (CNiR) values for all the upstream channels for a specific cable modem.
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address cnr command might not show a particular cable modem until the Cisco CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address cnr command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.
In addition, when the HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond with a blank display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip
In Cisco IOS Release 12.1(12)EC, Cisco IOS Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Examples
The following example is a sample output of the show cable modem cnr command for a CM:
Router# show cable modem 10.20.114.34 cnr
MAC Address IP Address I/F MAC Prim snr/cnr
00d0.ba77.7595 10.20.114.34 Cable3/0/U5 online 1 45.00
The following example is a sample output of the show cable modem cnr command after an HCCP switchover. The CNR value is missing until traffic is sent to the cable modem (in this case using the ping command).
Router# show cable modem 10.10.10.46 cnr
MAC Address IP Address I/F MAC Prim snr/cnr
0002.fd22.aadf 10.10.10.46 C5/1/0/U5 online 1970 -----
Router# show cable modem 10.10.10.46 cnr
MAC Address IP Address I/F MAC Prim snr/cnr
0002.fd22.aadf 10.10.10.46 C5/1/0/U5 online 1970 42.00
The following example is a sample output of the show cable modem cnr command for all upstream ports providing service to a specified cable modem in Cisco IOS Release 12.2(33)SCC:
Router# show cable modem 0014.f8c1.fd1a cnr
MAC Address IP Address I/F MAC SID snr/cnr
0014.f8c1.fd1a 10.10.4.1 C5/0/1/U0 online 1 33
001e.6bfb.119a 9.9.9.2 C5/0/1/U1 online 2 33
001e.6bfb.0f9e 9.9.9.3 C5/0/1/U2 online 3 33
0019.474a.d4c4 9.9.9.4 C5/0/1/U3 online 4 33
The following example is a sample output of the show cable modem cnr command for an upstream port providing service to a specified cable modem in Cisco IOS Release 12.2(33)SCF:
Router# show cable modem 0022.cea4.f0fa cnr
MAC Address IP Address I/F MAC Prim ExPwr RxPwr cnr
State Sid (dBmv) (dBmv) (dB)
0022.cea4.f0fa 10.10.1.62 C8/1/14/U3 w-online 78 0.0 -0.50 23
Table 9 describes the significant fields shown in the display:
Table 9 show cable modem cnr Field Descriptions
Field
|
Description
|
MAC Address
|
MAC address of the CM.
|
IP Address
|
IP address that the DHCP server has assigned to the CM.
|
I/F
|
Cable interface line card providing the upstream for this CM.
|
MAC State
|
Current state of the MAC layer (see Table 23).
|
Prim Sid
|
Primary Sid assigned to this CM.
In Cisco IOS Release 12.2(33)SCC, this field is renamed to SID and represents multiple upstream connections with unique SIDs providing service to a single CM.
|
ExPwr (dBmv)
|
Expected carrier power level, in decibel millivolts (dBmv).
|
RxPwr (dBmv)
|
Received carrier power level, in decibel millivolts (dBmv).
|
snr/cnr (db)
|
The current upstream CNR or SNR for this particular CM, in decibels (dB). In Cisco IOS Release 12.2(15)BC1 and later releases, this field shows "-----" for offline cable modems.
Note You can also use the show controllers cable command to display the SNR or CNR for a cable interface line card, but this value is only an estimate because it uses a random sampling of modems to determine the average for the card at any particular time. The CNR value shown by the show controllers cable command can therefore appear to fluctuate compared to the individual values shown by the show cable modem cnr command.
|
Table 23 shows the possible values for the MAC state field.
Table 10 MAC State Field Descriptions 1
MAC State Value
|
Description
|
Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing
|
init(r1)
|
CM sent initial ranging.
|
init(r2)
|
CM is ranging. The Cisco CMTS received initial ranging from the CM and has sent RF power, timing offset, and frequency adjustments to the CM.
|
init(rc)
|
Ranging has completed.
Note If a CM appears to be stuck in this state, it could be that the CM is able to communicate successfully on the cable network, but that the upstream is at capacity and does not have any additional bandwidth to allow the CM to finish registration and come online. Either manually move one or more CMs to other upstreams, or enable load balancing on the upstream using the cable load-balance group commands.
|
init(d)
|
DHCP request was received, as DHCPDISCOVER. This also indicates that the first IP broadcast packet has been received from the CM.
|
init(dr)
|
Cable modem has broadcast a DHCP REQUEST packet back to the DHCP server.
|
init(i)
|
Cable modem has received the DHCPOFFER reply (DHCPACK) from the DHCP server that has assigned an IP address to the modem, but the modem has not yet replied with a DHCPREQUEST message requesting that particular IP address, nor has it sent an IP packet with that IP address.
Note If a CM appears to be stuck in this state, the CM has likely received the DHCPOFFER reply from the DHCP server, but this reply might have contained one or more invalid options for that particular CM.
|
init(io)
|
Cisco CMTS learns the DHCP offer that is sent to the cable modem from the DHCP server, which has assigned an IP address to the modem.
|
init(o)
|
CM has begun to download the option file (DOCSIS configuration file) using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP response. If the CM remains in this state, it indicates that the download has failed.
|
init(t)
|
Time-of-day (ToD) exchange has started.
|
resetting
|
CM is being reset and will shortly restart the registration process.
|
| |
init6(s)
|
Cisco CMTS router learns the DHCPv6 SOLICIT message from the CM.
|
init6(a)
|
Cisco CMTS router learns the ADVERTISE message from the DHCPv6 server to the CM.
|
init6(r)
|
Cisco CMTS router learns the REQUEST response from the CM to the DHCPv6 server.
|
init6(i)
|
Cisco CMTS router learns the REPLY message from the DHCPv6 server to the CM.
|
init6(o)
|
Cisco CMTS router learns the REQUEST message from the CM to the TFTP server.
|
init6(t)
|
Cisco CMTS router learns the REQUEST message from the CM to the ToD server.
|
Non-error Status Conditions
|
cc(r1)
|
CM had registered and was online, but has received a Downstream Channel Change (DCC) or Upstream Channel Change (UCC) request message from the Cisco CMTS. The CM has begun moving to the new channel, and the Cisco CMTS has received the initial ranging of the CM on the new downstream or upstream channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.
|
cc(r2)
|
This state should normally follow cc(r1) and indicates that the CM has finished its initial ranging on the new channel, and is currently performing continuous ranging on the new channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.
|
offline
|
CM is considered offline (disconnected or powered down).
|
online
|
CM has registered and is enabled to pass data on the network.
|
online(d)
|
CM is registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. The CM does not forward traffic to or from the CPE devices, but the Cisco CMTS can continue to communicate with the CM using DOCSIS messages and IP traffic (such as SNMP commands).
Note If BPI was enabled in the DOCSIS configuration file sent to the CM, assume that the CM is using BPI encryption unless other messages show that the BPI negotiation and key assignments have failed.
|
online(pkd)
|
CM is registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and KEK is assigned.
Note This state is equivalent to the online(d) and online(pk) states.
|
online(ptd)
|
CM is registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and TEK is assigned. BPI encryption is now being performed.
Note This state is equivalent to the online(d) and online(pt) states.
|
online(pk)
|
CM is registered, BPI is enabled and KEK is assigned.
|
online(pt)
|
CM is registered, BPI is enabled and TEK is assigned. BPI encryption is now being performed.
Note If network access was disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) instead of online(pt) even when BPI encryption is enabled and operational.
|
Note If an exclamation point (!) appears in front of one of the online states, it indicates that the cable dynamic-secret command has been used with either the mark or reject option, and that the cable modem has failed the dynamic secret authentication check.
|
expire(pk)
|
CM is registered, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.
|
expire(pkd)
|
CM is registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pk) states.
|
expire(pt)
|
CM is registered, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.
|
expire(ptd)
|
CM is registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pt) states.
|
Error Status Conditions
|
reject(m)
|
CM attempted to register but registration was refused due to a bad Message Integrity Check (MIC) value. This also could indicate that the shared secret in the DOCSIS configuration file does not match the value configured on the Cisco CMTS with the cable shared-secret command.
In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases, this could also indicate that the cable tftp-enforce command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so.
|
reject(c)
|
CM attempted to register, but registration was refused due to a a number of possible errors:
• CM attempted to register with a minimum guaranteed upstream bandwidth that would exceed the limits imposed by the cable upstream admission-control command.
• CM has been disabled because of a security violation.
• Bad class of service (CoS) value in the DOCSIS configuration file.
• CM attempted to create a new CoS configuration but the Cisco CMTS is configured to not permit such changes.
• CM failed the timestamp check for its DOCSIS configuration file. (This could indicate a possible theft-of-service attempt, or a problem with the synchronization of the clocks on the CM and Cisco CMTS.)
|
reject(pk)
|
KEK key assignment is rejected, BPI encryption has not been established.
|
reject(pkd)
|
CM is registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because KEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pk) states.
|
reject(pt)
|
TEK key assignment is rejected, BPI encryption has not been established.
|
reject(ptd)
|
CM is registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because TEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pt) states.
|
Note In Cisco IOS Release 12.1(20)EC, Cisco IOS Release 12.2(15)BC1, and earlier releases, when network access is disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) even if BPI encryption fails. Use the show cable modem mac-address command to confirm whether BPI is enabled or disabled for a particular cable modem.
|
reject(ts)
|
CM attempted to register, but registration failed because the TFTP server timestamp in the CM registration request did not match the timestamp maintained by the CMTS. This might indicate that the CM attempted to register by replaying an old DOCSIS configuration file used during a prior registration attempt.
|
reject(ip)
|
CM attempted to register, but registration failed because the IP address in the CM request did not match the IP address that the TFTP server recorded when it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.
|
reject(na)
|
CM attempted to register, but registration failed because the CM did not send a Registration-Acknowledgement (REG-ACK) message in reply to the Registration-Response (REG-RSP) message sent by the Cisco CMTS. A Registration-NonAcknowledgement (REG-NACK) is assumed.
|
Related Commands
Command
|
Description
|
cable modem vendor
|
Associates the name of a vendor with its Organizational Unique Identifier (OUI).
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modulation-profile
|
Displays modulation profile group information.
|
show cable modem remote-query
|
Displays information collected by the remote-query feature.
|
show controllers cable
|
Displays information about the interface controllers for a cable interface on the Cisco CMTS router.
|
show interface cable modem
|
Displays information about the CMs connected to a particular cable interface.
|
show interface cable sid
|
Displays cable interface information.
|
show cable modem connectivity
To display connectivity statistics for one or more CMs, use the show cable modem connectivity command in privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] connectivity
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn]
connectivity
Syntax Description
ip-address
|
(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.
|
mac-address
|
(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.
|
slot
|
Slot where the line card resides.
• Cisco uBR7225VXR router—The valid value is 1 or 2.
• Cisco uBR7246VXR router—The valid range is from 3 to 6.
• Cisco uBR10012 router—The valid range is from 5 to 8.
|
subslot
|
(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
|
port
|
Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.
• Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).
|
cable-interface-index
|
Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.
• Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
upstream port
|
(Optional) Displays information for all CMs using this specific upstream. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports on the cable interface line card.
|
logical-channel-index
|
(Optional) Logical channel index. The valid values are 0 or 1.
|
name fqdn
|
(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.1(4)CX and 12.2(4)BC1
|
This command was introduced (and the connectivity option was removed from the show interface cable sid command).
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was added.
• The name keyword option was added for specifying the fully-qualified domain name of a CM.
|
12.2(33)SCE
|
This command was modified. The port parameter was changed to cable-interface-index.
|
12.2(33)SCF
|
This command was modified. The logical-channel-index argument was added.
|
Usage Guidelines
This command displays connectivity information for all CMs, for all CMs attached to a specific CMTS cable interface, or for a particular CM, as identified by its IP address or MAC address.
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Note
In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.
Note
The show cable modem connectivity command replaces the connectivity option for the show interface cable sid command, because the connectivity statistics are better managed on a per-modem basis than on a per-SID basis.
Examples
The following example shows sample output for the show cable modem connectivity command for all online CMs:
Router# show cable modem connectivity
Prim 1st time Times %online Online time Offline time
Sid online Online min avg max min avg max
1 Apr 28 2003 1 99.67 00:00 1d1h9m 1d1h9m 05:38 04:58 05:38
2 Apr 28 2003 1 99.66 00:00 1d1h8m 1d1h8m 05:46 05:02 05:46
3 Apr 28 2003 1 99.69 00:00 1d1h7m 1d1h7m 05:18 04:34 05:18
The following example shows sample output for the show cable modem connectivity command for all online CMs for a particular cable interface:
Router# show cable modem c8/1/0 connectivity
Prim 1st time Times %online Online time Offline time
Sid online Online min avg max min avg max
1 Apr 28 2003 1 99.67 00:00 1d1h12m 1d1h12m 05:38 04:58 05:38
2 Apr 28 2003 1 99.66 00:00 1d1h11m 1d1h11m 05:46 05:02 05:46
3 Apr 28 2003 1 99.69 00:00 1d1h11m 1d1h11m 05:18 04:34 05:18
The following example shows sample output for the show cable modem connectivity command for a particular CM:
Router# show cable modem 0010.7bb3.fcd1 connectivity
Prim 1st time Times %online Online time Offline time
Sid online Online min avg max min avg max
1 May 30 2000 4 99.85 48:20 11h34m 1d2h23m 00:01 00:59 03:00
Table 11 describes the information shown in the show cable modem connectivity displays:
Table 11 Descriptions for the show cable modem connectivity Fields
Field
|
Description
|
Prim SID
|
The primary SID assigned to this CM.
|
1st time online
|
First time at which the modem with this SID connected.
|
Times online
|
Number of times the modem with this SID connected.
|
% online
|
Percentage of time the modem with this SID has been connected.
|
Online time
|
The minimum, average, and maximum number of days, hours, and minutes the modem with this SID has been connected.
Note A CM is considered online when it has completed the registration process and has communicated with the DHCP, TFTP, and TOD servers.
|
Offline time
|
The minimum, average, and maximum number of days, hours, and minutes the modem with this SID has been disconnected.
Note A CM is considered offline after it has missed 16 consecutive station maintenance messages.
|

Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Related Commands
Command
|
Description
|
cable modem vendor
|
Associates the name of a vendor with its Organizational Unique Identifier (OUI).
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem calls
|
Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.
|
show cable modem cnr
|
Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.
|
show cable modem flap
|
Displays flap list statistics for one or more cable modems.
|
show cable modem maintenance
|
Displays station maintenance (SM) error statistics for one or more cable modems.
|
show cable modem remote-query
|
Displays information collected by the remote-query feature.
|
show cable modem rf-adapt
|
Displays RF adaptation information for cable modems.
|
show cable modulation-profile
|
Displays modulation profile group information.
|
show interface cable modem
|
Displays information about the CMs connected to a particular cable interface.
|
show interface cable sid
|
Displays cable interface information.
|
show cable modem counters
To display downstream and upstream traffic counters for one or more cable modems (CMs), use the show cable modem counters command in privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] counters
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn]
counters
Syntax Description
ip-address
|
(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.
|
mac-address
|
(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.
|
slot
|
Slot where the line card resides.
• Cisco uBR7225VXR router—The valid value is 1 or 2.
• Cisco uBR7246VXR router—The valid range is from 3 to 6.
• Cisco uBR10012 router—The valid range is from 5 to 8.
|
subslot
|
(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
|
port
|
Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.
• Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).
|
cable-interface-index
|
Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.
• Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
upstream port
|
(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.
|
logical-channel-index
|
(Optional) Logical channel index. The valid values are 0 or 1.
|
name fqdn
|
(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.
|
counters
|
Displays downstream and upstream traffic counters for one or more cable modems.
|
Defaults
Displays counter information for all CMs.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.1(4)CX and 12.2(4)BC1
|
This command was introduced.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was added.
• The name keyword option was added for specifying the fully-qualified domain name of a CM.
|
12.2(33)SCE
|
This command was modified. The port parameter was changed to cable-interface-index.
|
12.2(33)SCF
|
This command was modified. The logical-channel-index argument was added.
|
Usage Guidelines
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Note
In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.
Examples
The following example shows sample output for the show cable modems counters command for all CMs:
Router# show cable modem counters
MAC Address US Packets US Bytes DS Packets DS Bytes
0050.7366.1243 29 2126 29 2126
0002.b970.0027 1811 116174 29 2126
0006.5314.858d 329154 21071059 134607 9961268
The following example shows sample output for the show cable modems counters command for all CMs on a particular cable interface:
Router# show cable modem c8/1/0 counters
MAC Address US Packets US Bytes DS Packets DS Bytes
0050.7366.1243 29 2126 29 2126
0002.b970.0027 1811 116174 29 2126
0006.5314.858d 329154 21071059 134607 9961268
The following example shows sample output for the show cable modems counters command for a particular CM, as identified by its MAC address:
Router# show cable modem 0010.7bb3.fcd1 counters
MAC Address US Packets US Bytes DS Packets DS Bytes
0010.7bb3.fcd1 1452082 171344434 1452073 171343858
The following example shows sample output for the show cable modems counters command for a particular CM, as identified by its IP address:
Router# show cable modem 23.1.1.10 counters
MAC Address US Packets US Bytes DS Packets DS Bytes
0002.b970.0027 1811 116174 29 2126
Table 12 describes the fields shown in the show cable modem counters displays:
Table 12 Descriptions for the show cable modem counters Fields
Field
|
Description
|
MAC Address
|
MAC address for the CM.
|
US Packets
|
Number of packets this CM has transmitted on the upstream.
|
US Bytes
|
Number of bytes this CM has transmitted on the upstream.
|
DS Packets
|
Number of packets this CM has received on the downstream.
|
DS Bytes
|
Number of byte this CM has received on the downstream.
|
Related Commands
Command
|
Description
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem access-group
|
Displays the access groups for the CMs on a particular cable interface.
|
show cable modem calls
|
Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.
|
show cable modem classifiers
|
Displays information about the classifiers for a particular CM.
|
show cable modem connectivity
|
Displays connectivity statistics for one or more CMs.
|
show cable modem cpe
|
Displays the CPE devices accessing the cable interface through a particular CM.
|
show cable modem qos
|
Displays quality of service (QoS) and service flow information for a particular CM.
|
show cable modem registered
|
Displays a list of the CMs that are marked as registered with the Cisco CMTS.
|
show cable modem remote-query
|
Displays information collected by the remote-query feature.
|
show cable modem rf-adapt
|
Displays RF adaptation information for cable modems.
|
show cable modem unregistered
|
Displays a list of the CMs that are marked as unregistered with the Cisco CMTS.
|
show interface cable modem
|
Displays information about the CMs connected to a particular cable interface.
|
show interface cable sid
|
Displays cable interface information.
|
show cable modem cpe
To display the customer premise equipment (CPE) devices accessing the cable interface through a particular cable modem (CM), use the show cable modem cpe command in privileged EXEC mode.
show cable modem {ip-address | mac-address | name fqdn} cpe
Syntax Description
ip-address
|
Displays the CPE devices for the CM with the specified IPv4 or IPv6 address.
|
mac-address
|
Displays the CPE devices for the CM with the specified MAC address.
|
name fqdn
|
(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
11.3XA
|
This command was introduced.
|
12.1(4)CX and 12.2(4)BC1
|
The command was simplified to display only the IP and MAC addresses for the CPE devices.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM device was added.
• The name keyword option was added for specifying the fully-qualified domain name of a CM.
|
Usage Guidelines
This command lists the CPE devices that are accessing the cable network through a particular CM. You can identify the CM either by its IP address or by its MAC address.
Note
In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Examples
The following example shows sample output for the show cable modem cpe command, listing the CPE devices by their MAC and IP addresses:
Router# show cable modem 0019.474a.c14a cpe
IP address MAC address Dual IP
50.3.37.3 0005.0052.2c1d Y
Table 22 describes the significant fields shown in the display.
Table 13 show cable modem cpe Field Descriptions
Field
|
Description
|
IP Address
|
IP address acquired by the CPE.
|
MAC Address
|
MAC address of the CPE.
|
Dual IP
|
Dual IP flag. Identifies whether or not ("Y" or "N") the CPE supports both IPv4 and IPv6 addressing.
|
Related Commands
Command
|
Description
|
cable modem vendor
|
Associates the name of a vendor with its Organizational Unique Identifier (OUI).
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem calls
|
Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.
|
show cable modem classifiers
|
Displays information about the classifiers for a particular CM.
|
show cable modem cnr
|
Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.
|
show cable modem connectivity
|
Displays connectivity statistics for one or more CMs.
|
show cable modem errors
|
Displays error statistics for one or more CMs.
|
show cable modem flap
|
Displays flap list statistics for one or more cable modems.
|
show cable modem maintenance
|
Displays station maintenance (SM) error statistics for one or more cable modems.
|
show cable modem remote-query
|
Displays information collected by the remote-query feature.
|
show cable modulation-profile
|
Displays modulation profile group information.
|
show interface cable modem
|
Displays information about the CMs connected to a particular cable interface.
|
show interface cable sid
|
Displays cable interface information.
|
show cable modem docsis device-class
To display the DOCSIS device-class information for cable modems (CMs) on all or specified cable interfaces and upstreams, use the show cable modem docsis device-class command in privileged EXEC configuration mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem docsis device-class [summary [cable slot/subslot [cable slot/subslot]
[upstream port1 port2]]] [total]
show cable modem cable slot/subslot docsis version summary
Cisco uBR10012 Router
show cable modem docsis device-class [summary [cable slot/subslot/port [cable
slot/subslot/port] [upstream port1 port2]]] [total]
show cable modem cable slot/subslot/port docsis version summary
Syntax Description
summary
|
(Optional) Displays a summary of DOCSIS device class information for CMs on all or specified cable interfaces on the CMTS router.
|
cable slot/subslot [cable slot/subslot]
|
(Optional) Specifies a single cable interface, or a range of cable interfaces on a Cisco uBR7100 or Cisco uBR7200 series router, whose CMs you want to display information about, where:
• slot—Specifies the chassis slot number of the cable interface line card.
• subslot—Specifies the downstream port number.
Valid values for these arguments are dependent on your CMTS router and cable interface line card. Refer to the hardware documentation for your router chassis and cable interface line card for supported slot and port numbering.
|
cable slot/subslot/port [cable slot/subslot/port]
|
(Optional) Specifies a single cable interface, or a range of cable interfaces on a Cisco uBR10012 router, whose CMs you want to display information about, where:
• slot—Specifies the chassis slot number of the cable interface line card. Valid slots are 5 to 8.
• subslot—Specifies the secondary slot number of the cable interface line card. Valid subslots are 0 or 1.
• port—Specifies the downstream port number. Valid ports are 0 to 4, depending on the cable interface line card.
|
upstream port1 port2
|
(Optional) Specifies a specific upstream port, or a range of upstream ports on the specified cable interface(s), whose CMs you want to display information about, where:
• port1—Specify only port1 if you want to display information about a single upstream. When used with the port2 argument, specifies the beginning of a range of upstream ports, and port1 must be a lower-numbered port than port2.
• port2—Specifies the end of a range of upstream ports, and port2 must be a higher-numbered port than port1.
|
total
|
(Optional) Displays a total of DOCSIS device-class information for the CMs connected to all interfaces, or to the specified cable interfaces.
|
Command Default
The default form of the command (show cable modem docsis device-class without any options) provides DOCSIS device class information for all CMs on the CMTS router.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.3(21)BC
|
This command was introduced.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.
|
Usage Guidelines
This command displays a summary of DOCSIS device-class information for all CMs for a single cable interface, or for a range of cable interfaces, and optionally specified upstreams on those cable interfaces.
Examples
The following example shows typical output for the default form of the show cable modem docsis device-class command on a Cisco uBR100012 router:
Router# show cable modem docsis device-class
MAC Address I/F MAC Prim Reg Device Class Reg
State Sid Ver -------------------- Priv
0030.80bc.22b9 C3/0/U0 online(pt) 1 1.0 CM BPI
0000.cadb.04b2 C3/0/U0 online(pt) 2 1.1 eCM eMTA BPI+
0000.cadb.0512 C3/0/U0 online(pt) 3 1.1 eCM eMTA eSTB BPI+
0003.e38f.f5c7 C3/0/U1 online(pt) 4 1.0 CM BPI
0000.cadb.0bae C3/0/U1 online(pt) 5 1.1 eCM ePS BPI+
0010.7b6b.77ed C3/0/U2 online 6 1.0 CM
0000.cadb.0356 C4/0/U0 online(pt) 1 1.1 eCM eMTA BPI+
0000.cadb.02a6 C4/0/U0 init(d) 2 n/a <unavailable>
0000.cadb.2f7a C4/0/U1 online(pt) 3 2.0 eCM eSTB BPI+
0000.cadb.2952 C4/0/U2 online(pt) 4 1.1 eCM eSTB ePS BPI+
0000.cadb.0236 C4/0/U2 init(d) 6 n/a <unavailable>
0003.e3a6.850d C4/0/U3 online(pt) 7 1.1 eCM eMTA ePS BPI+
0003.e3a6.85ad C4/0/U3 online(pt) 8 1.0 CM BPI
The following example shows sample output for the show cable modem docsis device-class command for a particular cable interface, in chassis slot 3 and subslot 0:
Router# show cable modem cable3/0 docsis device-class
MAC Address I/F MAC Prim Reg Device Class Reg
State Sid Ver -------------------- Priv
0030.80bc.22b9 C3/0/U0 online(pt) 1 1.0 CM BPI
0000.cadb.04b2 C3/0/U0 online(pt) 2 1.1 eCM eMTA BPI+
0000.cadb.0512 C3/0/U0 online(pt) 3 1.1 eCM eMTA eSTB BPI+
0003.e38f.f5c7 C3/0/U1 online(pt) 4 1.0 CM BPI
0000.cadb.0bae C3/0/U1 online(pt) 5 1.1 eCM ePS BPI+
0010.7b6b.77ed C3/0/U2 online 6 1.0 CM
Table 14 show cable modem docsis device-class Field Descriptions
Field
|
Description
|
MAC Address
|
The MAC address of the CM.
|
I/F
|
The cable interface line card providing the upstream for this CM.
|
MAC State
|
The current state of the MAC layer.
|
Prim Sid
|
The primary SID assigned to this CM.
|
Reg Ver
|
Displays the maximum supported version of DOCSIS that the CM supports. The possible values are: DOCSIS 1.0, DOCSIS 1.1, DOCSIS 2.0, and DOCSIS 3.0. Shows "n/a" if the modem is not online.
|
Device Class
|
Displays the device-class information for the PacketCable device. The modem can report its device-class type during registration. The possible values are:
• CM or eCM—A standalone cable modem or embedded CM.
• ePS—Embedded Portal Services
• eMTA—Embedded Multimedia Terminal Adapter
• eSTB—Embedded Set Top Box
• unavailable—The CM has not reported its device class.
|
Reg Priv
|
Indicates whether Baseline Privacy Interface (BPI) or BPI Plus (BPI+) encryption is enabled for the CM.
|
Examples for Summary and Total Options
The following example shows the corresponding display for the show cable modem docsis device-class total command:
Router# show cable modem docsis device-class total
Online unrep CM eCM eMTA eSTB ePS
The following example shows sample output for the show cable modem docsis device-class summary form of the command on a Cisco CMTS router:
Router# show cable modem docsis device-class summary
----------------------------
Interface Online unrep CM eCM eMTA eSTB ePS
Cable3/0/U0 3 0 1 2 2 1 0
Cable3/0/U1 2 0 1 1 0 0 1
Cable3/0/U2 1 0 1 0 0 0 0
Cable4/0/U0 2 1 0 1 1 0 0
Cable4/0/U1 1 0 0 1 0 1 0
Cable4/0/U2 2 1 0 1 0 1 1
Cable4/0/U3 2 0 1 1 1 0 1
The following example shows sample output for the show cable modem docsis device-class summary command with the total option on a Cisco CMTS router:
Router# show cable modem docsis device-class summary total
----------------------------
Interface Online unrep CM eCM eMTA eSTB ePS
Cable3/0/U0 3 0 1 2 2 1 0
Cable3/0/U1 2 0 1 1 0 0 1
Cable3/0/U2 1 0 1 0 0 0 0
Cable4/0/U0 2 1 0 1 1 0 0
Cable4/0/U1 1 0 0 1 0 1 0
Cable4/0/U2 2 1 0 1 0 1 1
Cable4/0/U3 2 0 1 1 1 0 1
The following example shows sample output for the show cable modem docsis device-class summary total command for all enabled upstreams on a specific cable interface line card on a Cisco CMTS router:
Router# show cable modem docsis device-class summary cable 3/0 total
----------------------------
Interface Online unrep CM eCM eMTA eSTB ePS
Cable3/0/U0 3 0 1 2 2 1 0
Cable3/0/U1 2 0 1 1 0 0 1
Cable3/0/U2 1 0 1 0 0 0 0
The following example shows sample output for the show cable modem docsis device-class summary total command for a range of interfaces on a Cisco CMTS router:
Router# show cable modem docsis device-class summary cable 3/0 cable 4/0 total
----------------------------
Interface Online unrep CM eCM eMTA eSTB ePS
Cable3/0/U0 3 0 1 2 2 1 0
Cable3/0/U1 2 0 1 1 0 0 1
Cable3/0/U2 1 0 1 0 0 0 0
Cable4/0/U0 2 1 0 1 1 0 0
Cable4/0/U1 1 0 0 1 0 1 0
Cable4/0/U2 2 1 0 1 0 1 1
Cable4/0/U3 2 0 1 1 1 0 1
The following example shows sample output for the show cable modem docsis device-class summary total command for a range of interfaces and upstreams on a CMTS router:
Router# show cable modem docsis device-class summary cable 3/0 cable 4/0 upstream 0 2
total
----------------------------
Interface Online unrep CM eCM eMTA eSTB ePS
Cable3/0/U0 3 0 1 2 2 1 0
Cable3/0/U1 2 0 1 1 0 0 1
Cable3/0/U2 1 0 1 0 0 0 0
Cable4/0/U0 2 1 0 1 1 0 0
Cable4/0/U1 1 0 0 1 0 1 0
Cable4/0/U2 2 1 0 1 0 1 1
The following example shows sample output for the show cable modem docsis device-class summary total command for a range of upstreams on an interface:
Router# show cable modem docsis device-class summary cable3/0 upstream 0 1 total
----------------------------
Interface Online unrep CM eCM eMTA eSTB ePS
Cable3/0/U0 3 0 1 2 2 1 0
Cable3/0/U1 2 0 1 1 0 0 1
The following example shows sample output for the show cable modem docsis device-class summary command for all enabled upstreams on a specific cable interface line card:
Router# show cable modem cable3/0 docsis device-class summary
----------------------------
Interface Online unrep CM eCM eMTA eSTB ePS
Cable3/0/U0 3 0 1 2 2 1 0
Cable3/0/U1 2 0 1 1 0 0 1
Cable3/0/U2 1 0 1 0 0 0 0
Table 15 show cable modem docsis device-class summary Field Descriptions
Field
|
Description
|
Interface
|
Name of the cable interface and associated upstreams on the Cisco CMTS router.
|
Online
|
Total number of CMs currently online on this cable interface.
|
unrep
|
Total number of CMs on this interface for which the device-class information is unreported or unavailable.
|
CM
|
Total number of CMs on this interface that have a reported device class as a standalone cable modem.
|
eCM
|
Total number of CMs on this interface that have reported the device class as an embedded cable modem.
|
eMTA
|
Total number of CMs on this interface that have reported the device class as an embedded multimedia terminal adapter.
|
eSTB
|
Total number of CMs on this interface that have reported the device class as an embedded set-top box.
|
ePS
|
Total number of CMs on this interface that have reported the device class as embedded portal services.
|
Total
|
The total number of all CMs reported online and for a given DOCSIS device class across all cable interfaces on the Cisco CMTS router.
|
Related Commands
Command
|
Description
|
show cable modem docsis version
|
Displays the DOCSIS version information for CMs on one or more cable interfaces and upstreams.
|
show cable modem docsis version
To display the DOCSIS version information for cable modems (CMs) on one or more cable interfaces and upstreams, use the show cable modem docsis version command in privileged EXEC configuration mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem docsis version [summary [cable {slot/port | slot/cable-interface-index} [cable
{slot/port | slot/cable-interface-index}] [upstream port1 port2 [logical-channel-index]]]]
[total]
show cable modem cable {slot/port | slot/cable-interface-index} docsis version summary
Cisco uBR10012 Router
show cable modem docsis version [summary [cable {slot/subslot/port |
slot/subslot/cable-interface-index} [cable {slot/subslot/port |
slot/subslot/cable-interface-index}] [upstream port1 port2 [logical-channel-index]]]] [total]
show cable modem cable {slot/subslot/port | slot/subslot/cable-interface-index} docsis version
summary
Syntax Description
summary
|
(Optional) Displays a summary of DOCSIS device class information for CMs on all or specified cable interfaces on the CMTS router.
|
slot
|
Slot where the line card resides.
• Cisco uBR7225VXR router—The valid value is 1 or 2.
• Cisco uBR7246VXR router—The valid range is from 3 to 6.
• Cisco uBR10012 router—The valid range is from 5 to 8.
|
subslot
|
(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
|
port
|
Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.
• Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).
|
cable-interface-index
|
Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.
• Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
upstream port1 port2
|
(Optional) Specifies a specific upstream port, or a range of upstream ports on the specified cable interface(s), whose cable modems you want to display information about, where:
• port1—Specify only port1 if you want to display information about a single upstream. When used with the port2 argument, specifies the beginning of a range of upstream ports, and port1 must be a lower-numbered port than port2.
• port2—Specifies the end of a range of upstream ports, and port2 must be a higher-numbered port than port1.
|
logical-channel-index
|
(Optional) Logical channel index. The valid values are 0 or 1.
|
total
|
(Optional) Displays a total of DOCSIS device-class information for the CMs connected to all interfaces, or to the specified cable interfaces.
|
docsis version summary
|
Displays the DOCSIS version information for cable modems on one or more cable interfaces and upstreams.
|
Command Default
The default form of the command (show cable modem docsis version without any options) provides DOCSIS version information for all CMs on the CMTS router.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.3(23)BC
|
This command was introduced.
|
12.2(33)SCB
|
This command was integrated into Cisco IOS Release 12.2(33)SCB.
|
12.3(23)BC7
|
The output for the show cable modem docsis version summary total forms of the command were modified.
|
12.2(33)SCD2
|
This command was modified. The command output was modified to display the cable modems that are in upstream and downstream partial service mode.
|
12.2(33)SCE
|
This command was modified. The port parameter was changed to cable-interface-index.
|
12.2(33)SCF
|
This command was modified. The logical-channel-index argument was added.
|
Usage Guidelines
This command displays a summary of DOCSIS version information for all CMs for a single cable interface or upstream, or for a range of cable interfaces or upstreams.
Examples
Examples: show cable modem docsis version Command
The following example shows typical output for the default form of the show cable modem docsis version command on a Cisco uBR10012 router:
Router# show cable modem docsis version
MAC Address I/F MAC Prim Reg QoS US Phy DS Chl
State Sid Ver Prov Mode Mode
0018.6852.800a C5/1/0/U3 w-online(pt) 166 2.0 1.1 tdma WB
0018.6852.7f92 C5/1/0/U1 w-online(pt) 167 2.0 1.1 tdma WB
0014.bfbe.3ea6 C5/1/0/U0 w-online(pt) 168 2.0 1.1 tdma WB
0018.6852.8022 C5/1/0/U2 w-online(pt) 169 2.0 1.1 tdma WB
0018.6852.7fa0 C5/1/0/U0 w-online(pt) 170 2.0 1.1 tdma WB
0018.6852.8016 C5/1/0/U3 w-online(pt) 171 2.0 1.1 tdma WB
0018.6852.8008 C5/1/0/U2 w-online(pt) 172 2.0 1.1 tdma WB
0018.6852.800e C5/1/0/U1 w-online(pt) 173 2.0 1.1 tdma WB
0018.6852.8000 C5/1/0/U1 w-online(pt) 174 2.0 1.1 tdma WB
0002.8a8c.ed06 C5/1/1/U0 online(pt) 79 2.0 1.1 tdma NB
0018.6852.801c C5/1/1/U0 w-online(pt) 80 2.0 1.1 tdma WB
0018.6852.8006 C5/1/1/U0 w-online(pt) 81 2.0 1.1 tdma WB
00e0.6f2c.6a4e C5/1/1/U0 online(pt) 82 1.1 1.1 tdma NB
0011.ae02.a63c C5/1/3/U0 online(pt) 37 2.0 1.1 tdma NB
0011.ae00.c514 C5/1/3/U0 online(pt) 38 2.0 1.1 tdma NB
The following example shows sample output for the show cable modem docsis version command for a particular cable interface on a Cisco uBR10012 router:
Router# show cable modem cable 5/1/0 docsis version
MAC Address I/F MAC Prim Reg QoS US Phy DS Chl
State Sid Ver Prov Mode Mode
0018.6852.800a C5/1/0/U3 w-online(pt) 166 2.0 1.1 tdma WB
0018.6852.7f92 C5/1/0/U1 w-online(pt) 167 2.0 1.1 tdma WB
0014.bfbe.3ea6 C5/1/0/U0 w-online(pt) 168 2.0 1.1 tdma WB
0018.6852.8022 C5/1/0/U2 w-online(pt) 169 2.0 1.1 tdma WB
0018.6852.7fa0 C5/1/0/U0 w-online(pt) 170 2.0 1.1 tdma WB
0018.6852.8016 C5/1/0/U3 w-online(pt) 171 2.0 1.1 tdma WB
0018.6852.8008 C5/1/0/U2 w-online(pt) 172 2.0 1.1 tdma WB
0018.6852.800e C5/1/0/U1 w-online(pt) 173 2.0 1.1 tdma WB
0018.6852.8000 C5/1/0/U1 w-online(pt) 174 2.0 1.1 tdma WB
Table 16 describes the significant fields shown in the display.
Table 16 show cable modem docsis version Field Descriptions
Field
|
Description
|
MAC Address
|
The MAC address of the CM.
|
I/F
|
The cable interface line card providing the upstream for this CM.
|
MAC State
|
The current state of the MAC layer.
|
Prim Sid
|
The primary SID assigned to this CM.
|
Reg Ver
|
Displays the maximum supported version of DOCSIS that the CM supports. The possible values are: 1.0, 1.1, 2.0, and 3.0. Shows "n/a" if the modem is not online.
|
QoS Prov
|
Displays the version of DOCSIS that the CM currently is provisioned and registered for. The possible values are: 1.0, 1.1, 2.0, and 3.0. Shows "n/a" if the modem is not online.
|
US Phy Mode
|
Displays the DOCSIS operating mode for the CM, with the following possible values:
• tdma—DOCSIS 1.X, Time Division Multiple Access (TDMA)-only mode
• atdma—DOCSIS 2.0 Advanced Time Division Multiple Access (A-TDMA) mode
• scdma—DOCSIS 2.0 Synchronous Code Division Multiple Access (SCDMA) mode
Note This field is the same as that returned by the docsIfCmtsCmStatusModulationType object in the DOCS-IF-MIB.
|
DS Chl Mode
|
Displays the downstream channel mode for the CM, with the following possible values:
• NB—Narrowband
• WB—Wideband
|
Examples: show cable modem version docsis version total Command
The following example shows the corresponding display for the show cable modem docsis version total command:
Router# show cable modem docsis version total
Total Unregistered CMs: 0
Total DOCSIS 3.0 Operating/Capable/Registered CMs: 0/0/0
Total DOCSIS 2.0 Operating/Capable/Registered CMs: 0/14/14
Total DOCSIS 1.1 Operating/Capable/Registered CMs: 15/15/1
Total DOCSIS 1.0 Operating/Capable/Registered CMs: 0/15/0
Total v1.1 US QoS operating CMs: 15
Total V1.0 US QoS operating CMs: 0
Total Wide Band US operating CMs: 0
Total scdma US Phy operating CMs: 0
Total atdma US Phy operating CMs: 0
Total tdma US Phy operating CMs: 15
Total Wide Band DS operating CMs: 11
Total Narrow Band DS operating CMs: 4
Beginning in Cisco IOS Release 12.2(33)SCD2, the output of the show cable modem docsis version total command was modified to display the cable modems that are in partial service mode as shown in the following example:
Router# show cable modem docsis version total
Total Unregistered CMs: 1
Total DOCSIS 3.0 Operating/Capable/Registered CMs: 21/22/22
Total DOCSIS 2.0 Operating/Capable/Registered CMs: 0/34/12
Total DOCSIS 1.1 Operating/Capable/Registered CMs: 35/35/1
Total DOCSIS 1.0 Operating/Capable/Registered CMs: 0/35/0
Total v1.1 US QoS operating CMs: 35
Total V1.0 US QoS operating CMs: 0
Total Wide Band US operating CMs: 21
Total Wide Band US partial-mode CMs: 9
Total scdma US Phy operating CMs: 0
Total atdma US Phy operating CMs: 0
Total tdma US Phy operating CMs: 14
Total Wide Band DS operating CMs: 22
Total Wide Band DS partial-mode CMs: 12
Total Narrow Band DS operating CMs: 13
Table 17 describes the fields shown in the show cable modem docsis version total command display.
Table 17 show cable modem docsis version total Field Descriptions
Field
|
Description
|
Total Registered CMs
|
Total number of cable modems currently online in a CMTS router.
|
Total Unregistered CMs
|
Total number of cable modems that are either offline and not currently communicating with the CMTS router, or that are attempting to come online but are not yet registered.
|
Total DOCSIS x.y Operating/Capable/Registered CMs: a/b/c
|
Total number of cable modems (in a/b/c format) for the specified DOCSIS version (x.y) that have the following status:
• Operating—Total number (a) of CMs currently operating in the specified DOCSIS version.
• Capable—Total number (b) of CMs that can operate in the specified DOCSIS version, but might not be operating in that version.
• Registered—Total number (c) of CMs that are currently registered in the specified DOCSIS version.
|
Total Vx.y US QoS operating CMs
|
Total number of cable modems whose upstreams are currently operating in a specified DOCSIS version (x.y) quality of service (QoS).
|
Total Wide Band US operating CMs
|
Total number of cable modems with upstreams currently operating in wideband channel mode.
|
Total Wide Band US partial-mode CMs
|
Total number of cable modems with upstreams currently operating in partial wideband channel mode.
|
Total mode US Phy operating CMs
|
Total number of cable modems with upstreams currently operating in a particular wideband channel mode, where mode is:
• scdma—DOCSIS 2.0 Synchronous Code Division Multiple Access (SCDMA) mode
• atdma—DOCSIS 2.0 Advanced Time Division Multiple Access (A-TDMA) mode
• tdma—DOCSIS 1.X, Time Division Multiple Access (TDMA) mode
|
Total Wide Band DS operating CMs
|
Total number of cable modems with downstreams operating in wideband channel mode.
|
Total Wide Band DS partial-mode CMs
|
Total number of cable modems with downstreams operating in partial wideband channel mode.
|
Total Narrow Band DS operating CMs
|
Total number of cable modems with downstreams operating in narrowband channel mode.
|
Examples: show cable modem docsis version summary Command
The following example shows typical output for the default form of the show cable modem docsis version summary command on a Cisco uBR10012 router:
Router# show cable modem docsis version summary
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C5/1/0/U0 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U1 3 0 3 0 0 3 0 0 0 0 3 3 0
C5/1/0/U2 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U3 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/1/U0 4 0 3 1 0 4 0 0 0 0 4 2 2
C5/1/3/U0 2 0 2 0 0 2 0 0 0 0 2 0 2
Beginning in Cisco IOS Release 12.2(33)SCD2, the output of the show cable modem docsis version summary command was modified to display the cable modems that are in full or partial service mode as shown in the following example:
Router# show cable modem docsis version summary
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DOCSIS Mode
------------------- --------- -------------- ----------------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 scdm atdm tdma UP WB WP NB
C7/0/0/UB 12 12 0 0 0 12 0 0 0 0 9 12 12 0
C7/0/0/U0 2 0 2 0 0 2 0 0 0 2 0 0 0 2
C7/0/0/U1 1 0 1 0 0 1 0 0 0 1 0 0 0 1
C7/0/0/U3 4 0 4 0 0 4 0 0 0 4 0 0 0 4
C8/0/0/UB 9 9 0 0 0 9 0 0 0 0 0 9 0 0
C8/0/0/U0 1 1 0 0 0 1 0 0 0 1 0 1 0 0
C8/0/0/U1 5 0 4 1 0 5 0 0 0 5 0 0 0 5
C8/0/0/U3 1 0 1 0 0 1 0 0 0 1 0 0 0 1
The following example shows typical output for the show cable modem docsis version summary command with the total option on a Cisco uBR10012 router:
Router# show cable modem docsis version summary total
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C5/1/0/U0 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U1 3 0 3 0 0 3 0 0 0 0 3 3 0
C5/1/0/U2 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U3 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/1/U0 4 0 3 1 0 4 0 0 0 0 4 2 2
C5/1/3/U0 2 0 2 0 0 2 0 0 0 0 2 0 2
Total: 15 0 14 1 0 15 0 0 0 0 15 11 4
Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem docsis version summary total command was modified as shown in the following example:
Router# show cable modem docsis version summary total
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C5/1/0/U0 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U1 3 0 3 0 0 3 0 0 0 0 3 3 0
C5/1/0/U2 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U3 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/1/U0 4 0 3 1 0 4 0 0 0 0 4 2 2
C5/1/3/U0 2 0 2 0 0 2 0 0 0 0 2 0 2
-----------------------------------------------------------------------------
Total: 15 v3.0: 0 v1.1: 15 WB : 0 WB: 11
v2.0: 14 v1.0: 0 scdm: 0 NB: 4
-----------------------------------------------------------------------------
Beginning in Cisco IOS Release 12.2(33)SCD2, the output of the show cable modem docsis version summary total command was modified to display the cable modems that are in full or partial service mode as shown in the following example:
Router# show cable modem docsis version summary total
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DOCSIS Mode
------------------- --------- -------------- ----------------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 scdm atdm tdma UP WB WP NB
C7/0/0/UB 12 12 0 0 0 12 0 0 0 0 9 12 12 0
C7/0/0/U0 2 0 2 0 0 2 0 0 0 2 0 0 0 2
C7/0/0/U1 1 0 1 0 0 1 0 0 0 1 0 0 0 1
C7/0/0/U3 4 0 4 0 0 4 0 0 0 4 0 0 0 4
C8/0/0/UB 9 9 0 0 0 9 0 0 0 0 0 9 0 0
C8/0/0/U0 1 1 0 0 0 1 0 0 0 1 0 1 0 0
C8/0/0/U1 5 0 4 1 0 5 0 0 0 5 0 0 0 5
C8/0/0/U3 1 0 1 0 0 1 0 0 0 1 0 0 0 1
-----------------------------------------------------------------------------
Total: 35 v3.0: 22 v1.1: 35 UB : 21 WB: 22
v2.0: 12 v1.0: 0 scdm: 0 NB: 13
-----------------------------------------------------------------------------
Examples: show cable modem docsis version summary cable total Command
The following example shows sample output for the show cable modem docsis version summary cable total command for all enabled upstreams on a specific cable interface line card on a Cisco uBR10012 router:
Router# show cable modem docsis version summary cable 5/1/0 total
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C5/1/0/U0 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U1 3 0 3 0 0 3 0 0 0 0 3 3 0
C5/1/0/U2 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U3 2 0 2 0 0 2 0 0 0 0 2 2 0
Total: 9 0 9 0 0 9 0 0 0 0 9 9 0
Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem docsis version summary cable total command was modified as shown in the following example:
Router# show cable modem docsis version summary cable 5/1/0 total
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C5/1/0/U0 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U1 3 0 3 0 0 3 0 0 0 0 3 3 0
C5/1/0/U2 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U3 2 0 2 0 0 2 0 0 0 0 2 2 0
-----------------------------------------------------------------------------
Total: 9 v3.0: 0 v1.1: 9 WB : 0 WB: 9
v2.0: 9 v1.0: 0 scdm: 0 NB: 0
-----------------------------------------------------------------------------
The following example shows sample output for the show cable modem docsis version summary cable total command for a range of interfaces on the Cisco uBR10012 router:
Router# show cable modem docsis version summary cable 5/1/0 cable 5/1/3 total
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C5/1/0/U0 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U1 3 0 3 0 0 3 0 0 0 0 3 3 0
C5/1/0/U2 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U3 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/1/U0 4 0 3 1 0 4 0 0 0 0 4 2 2
C5/1/3/U0 2 0 2 0 0 2 0 0 0 0 2 0 2
Total: 15 0 14 1 0 15 0 0 0 0 15 11 4
Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem docsis version summary cable total command for a range of interfaces was modified as shown in the following example:
Router# show cable modem docsis version summary cable 5/1/0 cable 5/1/3 total
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C5/1/0/U0 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U1 3 0 3 0 0 3 0 0 0 0 3 3 0
C5/1/0/U2 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U3 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/1/U0 4 0 3 1 0 4 0 0 0 0 4 2 2
C5/1/3/U0 2 0 2 0 0 2 0 0 0 0 2 0 2
-----------------------------------------------------------------------------
Total: 15 v3.0: 0 v1.1: 15 WB : 0 WB: 11
v2.0: 14 v1.0: 0 scdm: 0 NB: 4
-----------------------------------------------------------------------------
The following example shows sample output for the show cable modem docsis version summary cable upstream total command for a range of interfaces and upstreams on the Cisco uBR10012 router:
Router# show cable modem docsis version summary cable 5/1/0 cable 5/1/3 upstream 0 3 total
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C5/1/0/U0 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U1 3 0 3 0 0 3 0 0 0 0 3 3 0
C5/1/0/U2 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U3 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/1/U0 4 0 3 1 0 4 0 0 0 0 4 2 2
C5/1/3/U0 2 0 2 0 0 2 0 0 0 0 2 0 2
Total: 15 0 14 1 0 15 0 0 0 0 15 11 4
Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem docsis version summary cable upstream total command for a range of interfaces and upstreams was modified as shown in the following example:
Router# show cable modem docsis version summary cable 5/1/0 cable 5/1/3 upstream 0 3 total
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C5/1/0/U0 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U1 3 0 3 0 0 3 0 0 0 0 3 3 0
C5/1/0/U2 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U3 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/1/U0 4 0 3 1 0 4 0 0 0 0 4 2 2
C5/1/3/U0 2 0 2 0 0 2 0 0 0 0 2 0 2
-----------------------------------------------------------------------------
Total: 15 v3.0: 0 v1.1: 15 WB : 0 WB: 11
v2.0: 14 v1.0: 0 scdm: 0 NB: 4
-----------------------------------------------------------------------------
The following example shows sample output for the show cable modem docsis version summary cable upstream total command for a range of upstreams in an interface on the Cisco uBR10012 router:
Router# show cable modem docsis version summary cable 5/1/0 upstream 0 3 total
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C5/1/0/U0 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U1 3 0 3 0 0 3 0 0 0 0 3 3 0
C5/1/0/U2 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U3 2 0 2 0 0 2 0 0 0 0 2 2 0
Total: 9 0 9 0 0 9 0 0 0 0 9 9 0
Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem docsis version summary cable upstream total command for a range of upstreams was modified as shown in the following example:
Router# show cable modem docsis version summary cable 5/1/0 upstream 0 3 total
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C5/1/0/U0 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U1 3 0 3 0 0 3 0 0 0 0 3 3 0
C5/1/0/U2 2 0 2 0 0 2 0 0 0 0 2 2 0
C5/1/0/U3 2 0 2 0 0 2 0 0 0 0 2 2 0
-----------------------------------------------------------------------------
Total: 9 v3.0: 0 v1.1: 9 WB : 0 WB: 9
v2.0: 9 v1.0: 0 scdm: 0 NB: 0
-----------------------------------------------------------------------------
The following example shows sample output for the show cable modem cable docsis version summary command for all enabled upstreams on a specific cable interface line card on a Cisco uBR10012 router:
Router# show cable modem cable 8/0/1 docsis version summary
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C8/0/1/U0 4 0 2 1 1 0 4 0 0 0 4 0 4
Beginning in Cisco IOS Release 12.3(23)BC7, the output for the show cable modem cable docsis version summary command for a range of upstreams was modified as shown in the following example:
Router# show cable modem cable 8/0/1 docsis version summary
Cable Modem DOCSIS Version Summary
DOCSIS Registered US QoS US Phy Mode DS Mode
------------------- --------- ------------------- -------
Interface Online v3.0 v2.0 v1.1 v1.0 v1.1 v1.0 WB scdm atdm tdma WB NB
C8/0/1/U0 4 0 2 1 1 0 4 0 0 0 4 0 4
Table 18 describes the significant fields shown in the display.
Table 18 show cable modem docsis version summary Field Descriptions
Field
|
Description
|
Interface
|
The cable interface line card providing the upstream for this cable modem.
|
Online
|
Total number of cable modems currently online on this cable interface.
|
DOCSIS Registered
|
Total number of cable modems registered on this cable interface with the specified DOCSIS version (x.y) capabilities.
|
US QoS
|
Total number of cable modems whose upstreams are currently operating in a specified DOCSIS version (x.y) quality of service (QoS).
|
US Phy Mode
|
Total number of cable modems on this cable interface with upstreams currently operating in a particular wideband channel mode, where:
• WB—Total number of upstreams on this cable interface operating in any wideband channel mode.
• scdma—Total number of upstreams on this cable interface operating in DOCSIS 2.0 Synchronous Code Division Multiple Access (SCDMA) mode.
• atdma—Total number of upstreams on this cable interface operating in DOCSIS 2.0 Advanced Time Division Multiple Access (A-TDMA) mode.
• tdma—Total number of upstreams on this cable interface operating in DOCSIS 1.X, Time Division Multiple Access (TDMA) mode.
|
DS Mode
|
Total number of cable modems on this cable interface whose downstreams are operating in the following modes:
• WB—Total number of downstreams on this cable interface operating in wideband channel mode.
• NB—Total number of downstreams on this cable interface operating in narrowband channel mode.
|
DOCSIS Mode
|
• UP—Total number of cable modems in upstream bonding partial service mode (p).
• WB—Total number of cable modems in downstream bonding fully-operational mode (w-online).
• WP—Total number of cable modems in downstream bonding partial service mode (p-online).
• NB—Total number of cable modems in narrowband online mode (online).
|
Related Commands
Command
|
Description
|
show cable modem docsis device-class
|
Displays the DOCSIS device-class information for cable modems (CMs) on all or specified cable interfaces and upstreams.
|
show cable modem partial-mode
|
Displays information about the cable modems that are in upstream and downstream partial service mode.
|
show cable modem rf-adapt
|
Displays RF adaptation information for cable modems.
|
show cable modem domain-name
To update the cable-specific Domain Name System (DNS) cache and display the domain name for specified cable modems (CMs) and customer premise equipment (CPE) behind a CM on a Cisco CMTS router, use the show cable modem domain-name command in privileged EXEC mode.
Cisco uBR7246VXR Router and Cisco uBR7225VXR Router
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] domain-name
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn]
domain-name
Syntax Description
ip-address
|
(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.
|
mac-address
|
(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.
|
slot
|
Slot where the line card resides.
• Cisco uBR7225VXR router—The valid value is 1 or 2.
• Cisco uBR7246VXR router—The valid range is from 3 to 6.
• Cisco uBR10012 router—The valid range is from 5 to 8.
|
subslot
|
(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
|
port
|
Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.
• Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).
|
cable-interface-index
|
Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.
• Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
upstream port
|
(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.
|
logical-channel-index
|
(Optional) Logical channel index. The valid values are 0 or 1.
|
name fqdn
|
(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCA
|
This command was introduced.
|
12.2(33)SCE
|
This command was modified. The port parameter was changed to cable-interface-index.
|
12.2(33)SCF
|
This command was modified. The logical-channel-index argument was added.
|
Usage Guidelines
Use the show cable modem domain-name command without any options to initiate an update to the cable-specific DNS cache on the CMTS router and to enable use of domain names in other CMTS router cable modem commands that support a name option.
Note
In Cisco IOS Release 12.2(33)SCA, although the show cable modem domain-name command accepts an IPv4 address format for a CM, DNS for IPv4-managed cable devices is not supported.
Examples
The following example shows sample output for all CMs and CPE behind a CM for the show cable modem domain-name command, listing the devices by their MAC and IP addresses and displaying the associated domain name:
Router# show cable modem domain-name
MAC Address IP Address Domain Name
0018.6835.27b3 10.3.37.76
0019.474a.c14a 2001:0DB8:3800:809:A896:1431:75EA:5EA1 cisco-test-cm1.cisco.com
0007.0e03.6851 10.3.37.36
0007.0e01.b085 10.3.37.34
0018.6835.27aa 2001:0DB8:3800:809:E97D:2986:9F37:FFE cisco-test-cm2.cisco.com
Related Commands
Command
|
Description
|
cable modem vendor
|
Associates the name of a vendor with its Organizational Unique Identifier (OUI).
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem calls
|
Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.
|
show cable modem cnr
|
Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.
|
show cable modem flap
|
Displays flap list statistics for one or more cable modems.
|
show cable modem maintenance
|
Displays station maintenance (SM) error statistics for one or more cable modems.
|
show cable modem remote-query
|
Displays information collected by the remote-query feature.
|
show cable modem rf-adapt
|
Displays RF adaptation information for cable modems.
|
show cable modulation-profile
|
Displays modulation profile group information.
|
show interface cable modem
|
Displays information about the CMs connected to a particular cable interface.
|
show interface cable sid
|
Displays cable interface information.
|
show cable modem errors
To display packet header error statistics for one or more CMs, use the show cable modem errors command in privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] errors
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn]
errors
Syntax Description
ip-address
|
(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.
|
mac-address
|
(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.
|
slot
|
Slot where the line card resides.
• Cisco uBR7225VXR router—The valid value is 1 or 2.
• Cisco uBR7246VXR router—The valid range is from 3 to 6.
• Cisco uBR10012 router—The valid range is from 5 to 8.
|
subslot
|
(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
|
port
|
Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.
• Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).
|
cable-interface-index
|
Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.
• Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
upstream port
|
(Optional) Displays information for all CMs using this specific upstream. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports on the cable interface line card.
|
logical-channel-index
|
(Optional) Logical channel index. The valid values are 0 or 1.
|
name fqdn
|
(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.
|
errors
|
Displays packet header error statistics for one or more CMs.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.1(4)CX, 12.2(1)XF, and 12.2(4)BC1
|
This command was introduced for the Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 router.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was added.
• The name keyword option was added for specifying the fully-qualified domain name of a CM.
|
12.2(33)SCE
|
This command was modified. The port parameter was changed to cable-interface-index.
|
12.2(33)SCF
|
This command was modified. The logical-channel-index argument was added.
|
Usage Guidelines
This command displays packet header error information for all CMs, for all CMs attached to a specific CMTS cable interface, or for a particular CM, as identified by its IP address or MAC address.
Note
In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip
In Cisco IOS Release 12.2(15)BC1 and later releases, use the clear cable modem flap-counters command to clear these counters.
Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Examples
The following example shows sample output for the show cable modem errors command for all CMs on a particular cable interface.
Router# show cable modem c8/1/0 errors
0050.7366.1243 C8/1/0/U1 0 1
0002.b970.0027 C8/1/0/U4 0 0
0006.5314.858d C8/1/0/U4 8 3
Table 19 describes the fields shown in the show cable modem errors displays:
Table 19 Descriptions for the show cable modem errors Fields
Field
|
Description
|
MAC Address
|
The MAC address for the CM.
|
I/F
|
The cable interface line card, including the upstream, for this CM.
|
CRC
|
Number of times the CMTS upstream receiver flagged a packet with a cyclic redundancy check (CRC) error from this CM. CRC errors usually indicate downstream signal interruption or interference noise on a plant. Occasional CRC errors can always be expected, but a high number of CRC errors could indicate plant problems such as intermittent upstream problems, laster clipping, common-path distortion, or impulsive noise or interference.
|
HCS
|
Number of times the CMTS upstream receiver flagged a packet with a header checksum (HCS) error from this CM. HCS errors could indicate the same sort of plant problems as CRC errors.
|
Related Commands
Command
|
Description
|
cable modem vendor
|
Associates the name of a vendor with its Organizational Unique Identifier (OUI).
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem cnr
|
Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.
|
show cable modem connectivity
|
Displays connectivity statistics for one or more CMs.
|
show cable modem flap
|
Displays flap list statistics for one or more cable modems.
|
show cable modem maintenance
|
Displays station maintenance (SM) error statistics for one or more cable modems.
|
show interface cable modem
|
Displays information about the CMs connected to a particular cable interface.
|
show cable modem rf-adapt
|
Displays RF adaptation information for cable modems.
|
show cable modem extended-power
To display the list of cable modems that are transmitting upstream data at extended power level, use the show cable modem extended-power command in privilege EXEC mode.
show cable modem extended-power
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCF2
|
This command was introduced.
|
Examples
The following is a sample output of the show cable modem extended-power command that displays all the cable modems that are transmitting upstream data at extended power level:
Router# show cable modem extended-power
MAC Address IP Address I/F MAC Prim Report ECN
001e.6bfb.3382 5.50.0.3 C7/0/0/UB w-online 3 57.00 Y
0022.cea5.0214 5.50.1.102 C7/0/0/UB w-online 5 54.00 Y
001e.6bfb.1378 5.50.6.83 C7/0/0/UB w-online 6 54.00 Y
Table 1 describes significant fields shown in the display.
Table 20 show cable modem extended-power Field Descriptions
Field
|
Description
|
MAC Address
|
MAC address of the cable modem.
|
IP Address
|
IP address that the DHCP server has assigned to the cable modem.
|
I/F
|
Cable interface line card providing the upstream for the cable modem.
|
MAC State
|
Current state of the MAC layer.
|
Prim Sid
|
Primary Service ID (SID) assigned to the cable modem.
|
Report Power
|
Power (in dB) at which cable modems are transmitting upstream data.
|
ECN
|
Extended high power at which the CM is operating.
|
Related Commands
Command
|
Description
|
cable upstream ext-power
|
Enables or disables the DOCSIS extended transmit power support on the Cisco CMTS.
|
show cable modem flap
To display flap list statistics for one or more cable modems, use the show cable modem flap command in privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] flap
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] flap
Syntax Description
ip-address
|
(Optional) IPv4 or IPv6 address of a specific cable modem to be displayed. If you specify the IP address for a CPE device behind a cable modem, information for that cable modem is displayed.
|
mac-address
|
(Optional) MAC address of a specific cable modem to be displayed. If you specify the MAC address for a CPE device behind a cable modem, information for that cable modem is displayed.
|
slot
|
Slot where the line card resides.
• Cisco uBR7225VXR router—The valid value is 1 or 2.
• Cisco uBR7246VXR router—The valid range is from 3 to 6.
• Cisco uBR10012 router—The valid range is from 5 to 8.
|
subslot
|
(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
|
port
|
Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.
• Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).
|
cable-interface-index
|
Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.
• Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
upstream port
|
(Optional) Displays information for all cable modems using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.
|
logical-channel-index
|
(Optional) Logical channel index. The valid values are 0 or 1.
|
name fqdn
|
(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.
|
flap mtc
|
Displays aggregate data across all upstream channels for each flap detector for cable modems in MTC mode. Displays per channel flap information for a single cable modem in MTC mode.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.1(4)CX, 12.2(1)XF, and 12.2(4)BC1
|
This command was introduced for the Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 routers.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a cable modem or CPE device was added.
• The name keyword option was added for specifying the fully-qualified domain name of a cable modem.
|
12.2(33)SCC
|
A new keyword, mtc, was added to provide multiple transmit channel (MTC) information for cable modems in the MTC mode.
• The mtc keyword displays aggregate data across all upstream channels for each flap detector for cable modems in the MTC mode.
• The show cable modem flap command remains unchanged for non-MTC mode cable modems.
|
12.2(33)SCE
|
This command was modified. The port parameter was changed to cable-interface-index.
|
12.2(33)SCF
|
This command was modified. The logical-channel-index argument was added.
|
Usage Guidelines
This command displays information about the flap list activity for one or more cable modems. Unlike the show cable flap-list command, the show cable modem flap command displays flap counters of a cable modem irrespective of the plant condition.
Note
In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
For cable modems in MTC mode, the show cable modem flap command will display aggregate data across all upstream channels for each flap detector. However, for a single MTC cable modem, the show cable modem flap command will display per channel flap information.
Note
The output of the show cable modem flap command will remain unchanged for non-MTC mode cable modems.
Examples
The following example shows sample output for the show cable modem flap command on a Cisco CMTS router:
Router# show cable modem flap
MAC Address I/F Ins Hit Miss CRC P-Adj Flap Time
0025.2e34.4386 C6/0/0/U0 0 46657 3974 0 0 0 (14212 msec)
0025.2e2f.d4b6 C6/0/0/U0 0 47868 1896 0 0 0 (18000 msec)
0025.2e2f.d4de C6/0/0/U0 0 47960 1883 0 0 0 (19552 msec)
0023.bee1.e96b C6/0/0/U0 0 46537 4333 0 0 0 (22432 msec)
0025.2e2f.d4d8 C6/0/0/U0 0 21891 780 0 0 0 ( -- )
0025.2e2f.d48c C6/0/0/U0 0 47918 1828 0 0 0 ( -- )
0025.2e2f.d490 C6/0/0/U0 0 47900 1812 0 0 0 ( -- )
0019.474e.e46a C8/0/0/U0 0 33424 0 0 0 0 (6372 msec)
0019.474e.e266 C8/0/0/U0 0 33418 0 0 0 0 (8352 msec)
0022.ce89.96f2 C8/0/0/U0 0 33427 0 0 0 0 (11112 msec)
0025.2e2f.d58a C8/0/0/U0 0 33423 0 0 !33420 33420 Oct 5 16:02:16(15252
msec)
001a.c30c.7ef6 C8/0/0/U0 0 33424 2 0 0 0 (17592 msec)
0022.ce89.96b0 C8/0/0/U0 0 33414 0 0 0 0 ( -- )
0025.2e2f.d6de C8/0/0/U0 0 33414 0 0 !33411 33411 Oct 5 16:02:
0025.2e34.43c8 C8/0/0/U0 0 33411 0 0 0 0 ( -- )
0023.bee1.e974 C8/0/0/U0 0 33406 0 0 0 0 ( -- )
0019.474e.e3a7 C8/0/0/U0 0 33324 0 0 0 0 ( -- )
The following example shows sample output for the show cable modem flap command for all cable modems on a specific cable interface:
Router# show cable modem c6/0/0 flap
MAC Address I/F Ins Hit Miss CRC P-Adj Flap Time
0025.2e34.4386 C6/0/0/U0 0 46778 3980 0 0 0 (14212 msec)
0025.2e2f.d4b6 C6/0/0/U0 0 48002 1899 0 0 0 (18000 msec)
0025.2e2f.d4de C6/0/0/U0 0 48098 1889 0 0 0 (19552 msec)
0023.bee1.e96b C6/0/0/U0 0 46658 4351 0 0 0 (22432 msec)
0025.2e2f.d4d8 C6/0/0/U0 0 21979 781 0 0 0 ( -- )
0025.2e2f.d48c C6/0/0/U0 0 48048 1835 0 0 0 ( -- )
0025.2e2f.d490 C6/0/0/U0 0 48029 1819 0 0 0 ( -- )
The following example shows sample output for the show cable modem flap command for a particular cable modem:
Router# show cable modem 0010.7bb3.fcd1 flap
MAC Address I/F Ins Hit Miss CRC P-Adj Flap Time
0010.7bb3.fcd1 C5/0/U5 0 36278 92 0 369 372 Jun 1 13:05:23 (14212 msec)
The following example shows sample output of the show cable modem flap command for all cable modems in the MTC mode on a specific cable interface:
Router# show cable modem c5/0/0 flap
MAC Address I/F Ins Hit Miss CRC P-Adj Flap Time
000e.5c44.d2f0 C5/0/0/U0 0 3040 0 0 0 0 ( -- )
0019.474a.d542 C5/0/0/U3 0 2930 214 0 0 1 May 27 05:21:26(19552 msec)
001a.c3ff.d578 C5/0/0/UB 0 12195 60 0 0 4 May 25 10:01:03(22432 msec)
Table 21 describes the significant fields shown in the display:
Table 21 show cable modem flap Field Descriptions
Field
|
Description
|
MAC Address
|
The MAC address for the CM.
|
I/F
|
The cable interface line card, including upstream, for this cable modem.
|
Ins
|
The number of times the cable modem comes up and inserts itself into the network. It can indicate intermittent downstream sync loss or DHCP or modem registration problems.
|
Hit
|
The number of times the cable modem responds to MAC layer keepalive messages. (The minimum hit rate is once per 30 seconds. It can indicate intermittent upstream, laser clipping, or common-path distortion.
|
Miss
|
The number of times the cable modem misses the MAC layer keepalive message. An 8 percent miss rate is normal for the Cisco cable interface line cards. It can indicate intermittent upstream, laser clipping, or common-path distortion.
|
CRC
|
The number of cyclic redundancy check (CRC) errors from this cable modem. It can indicate intermittent upstream, laser clipping, or common-path distortion.
|
P-Adj
|
The number of times the headend instructed the cable modem to adjust transmit (TX) power more than 3 dB. It can indicate amplifier degradation, poor connections, or thermal sensitivity.
|
Flap
|
The sum of P-Adj and Ins values. cable modems with high flap counts have high SIDs and might not register.
|
Time
|
The most recent time that the cable modem dropped the connection. The value displayed in the brackets indicates the duration (milliseconds) between the cable interface to become active and the first ranging success after a line card switchover (cable modem recovery time).
|
Related Commands
Command
|
Description
|
cable flap-list aging
|
Specifies the number of days to keep a cable modem in the flap-list table before aging it out of the table.
|
cable flap-list insertion-time
|
Sets the insertion time interval that determines whether a cable modem is placed in the flap list.
|
cable flap-list miss-threshold
|
Configures the threshold for recording a flap-list event, in terms of missed Station Maintenance messages.
|
cable flap-list power-adjust threshold
|
Specifies the power-adjust threshold for recording a cable modem flap-list event.
|
cable flap-list size
|
Specifies the maximum number of cable modems that can be listed in the flap-list table.
|
clear cable flap-list
|
Clears all the entries in the flap-list table.
|
show cable flap-list
|
Displays the current contents of the flap list.
|
show cable modem
|
Displays information for the registered and unregistered cable modems.
|
show cable modem rf-adapt
|
Displays RF adaptation information for cable modems.
|
show interface cable modem
|
Displays information about the cable modems connected to a particular cable interface.
|
show cable modem ipv6
To display IPv6 information for specified cable modems (CMs) and customer premise equipment (CPE) behind a CM on a Cisco CMTS router, use the show cable modem ipv6 command in privileged EXEC mode.
Cisco uBR7246VXR Router and Cisco uBR7225VXR Router
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] ipv6 [cpe | prefix | registered |
unregistered]
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] ipv6
[cpe | prefix | registered | unregistered]
Syntax Description
ip-address
|
(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.
|
mac-address
|
(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.
|
slot
|
Slot where the line card resides.
• Cisco uBR7225VXR router—The valid value is 1 or 2.
• Cisco uBR7246VXR router—The valid range is from 3 to 6.
• Cisco uBR10012 router—The valid range is from 5 to 8.
|
subslot
|
(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
|
port
|
Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.
• Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).
|
cable-interface-index
|
Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.
• Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
upstream port
|
(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.
|
logical-channel-index
|
(Optional) Logical channel index. The valid values are 0 or 1.
|
name fqdn
|
(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.
|
cpe
|
(Optional—Available only when used with an IP address of CM) Displays IPv6 information for the CPE devices behind the CM with the specified IPv4 or IPv6 address.
|
prefix
|
(Optional) Displays the IPv6 prefix of the network.
|
registered
|
(Optional) Displays IPv6 information for registered CMs.
|
unregistered
|
(Optional) Displays IPv6 information for unregistered CMs.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCA
|
This command was introduced.
|
12.2(33)SCE
|
This command was modified. The port parameter was changed to cable-interface-index.
|
12.2(33)SCF
|
This command was modified. The logical-channel-index argument was added.
|
Usage Guidelines
Use the show cable modem ipv6 command without any options to display IPv6 information for all CMs on the CMTS router.
Using the keyword options, you can display IPv6 information by IP address (IPv4 or IPv6) of a particular CM, for all CMs associated with a specified cable interface, by MAC address of a CM, or by domain name of a CM.
Note
In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.
Displaying CPE Information
•
To display the number of CPEs behind a CM, use the show cable modem ipv6 registered form of the command.
•
To display CPE information behind a particular CM, you must use the command with an IPv6 address of the CM and the cpe keyword option.
Examples
IPv6 Information for all CMs Example
The following example shows sample output for the show cable modem ipv6 command for all CMs on the CMTS routers, listing the devices by their MAC and IP addresses and displaying the associated domain name:
Router# show cable modem ipv6
MAC Address Type Interface Mac State D/IP IP Address
0004.27a5.b761 B/D C6/0/2/U1 online N ---
0007.0e01.d9a1 B/D C6/0/2/U0 online N ---
0006.2854.7275 R/D C6/0/2/U1 online Y 2001:0DB8:3800:80B:7565:5B87:1D7D:5AD5
Table 22 describes the significant fields shown in the display.
Table 22 show cable modem ipv6 Field Descriptions
Field
|
Description
|
MAC Address
|
MAC address of this CM.
|
Type
|
Type of device that this CM is functioning as, with the following possible values:
• B/D—CM as bridge using DHCP address assignment.
• G/D—CPE router using DHCP address assignment.
• C/A—CPE using Stateless Address Auto-Configuration (SLAAC) address assignment.
Note In Cisco IOS Release 12.2(33)SCA, the Cisco CMTS router does not support SLAAC.
|
Interface
|
Cable line card interface and upstream associated with this CM.
|
Mac State
|
The current state of the MAC layer for this CM (See Table 23 for descriptions of the possible states).
|
D/IP
|
Dual IP flag. Identifies whether or not ("Y" or "N") the CM or CPE supports both IPv4 and IPv6 addressing.
|
IP Address
|
IP address acquired by the CM. Prior to acquisition of the IP address, or if the CM fails registration, the following output is shown:
• IPv4 address not yet acquired—"0.0.0.0"
• IPv6 address not yet acquired—"::"
• CM fails IPv6 registration, but online with IPv4 address or CM fails IPv4 registration, but online with IPv6 address: "---"
• IPv6 address of IPv4-only CM, or IPv4 address of an IPv6-only CM: "---"
|
Domain Name
|
Domain name for the CM.
|
Table 23 shows the possible values for the MAC state field:
Table 23 Descriptions for the MAC State Field 1
MAC State Value
|
Description
|
Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing
|
init(r1)
|
The CM sent initial ranging.
|
init(r2)
|
The CM is ranging. The CMTS received initial ranging from the Cm and has sent RF power, timing offset, and frequency adjustments to the CM.
|
init(rc)
|
Ranging has completed.
Note If a CM appears to be stuck in this state, it could be that the CM is able to communicate successfully on the cable network, but that the upstream is at capacity and does not have any additional bandwidth to allow the CM to finish registration and come online. Either manually move one or more CMs to other upstreams, or enable load balancing on the upstream using the cable load-balance group commands.
|
init(d)
|
The DHCP request was received, as DHCPDISCOVER. This also indicates that the first IP broadcast packet has been received from the CM.
|
init(dr)
|
The DHCP request has been sent to the cable modem.
|
init(i)
|
The cable modem has received the DHCPOFFER reply (DHCPACK) from the DHCP server that has assigned an IP address to the modem, but the modem has not yet replied with a DHCPREQUEST message requesting that particular IP address, nor has it sent an IP packet with that IP address.
Note If a CM appears to be stuck in this state, the CM has likely received the DHCPOFFER reply from the DHCP server, but this reply might have contained one or more invalid options for that particular CM.
|
init(io)
|
The Cisco CMTS has seen the DHCP offer as sent to the cable modem from the DHCP server that has assigned an IP address to the modem.
|
init(o)
|
The CM has begun to download the option file (DOCSIS configuration file) using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP response. If the CM remains in this state, it indicates that the download has failed.
|
init(t)
|
Time-of-day (TOD) exchange has started.
|
resetting
|
The CM is being reset and will shortly restart the registration process.
|
| |
init6(s)
|
The Cisco CMTS router has seen the DHCPv6 SOLICIT message from the CM.
|
init6(a)
|
The Cisco CMTS router has seen the ADVERTISE message from the DHCPv6 server to the CM.
|
init6(r)
|
The Cisco CMTS router has seen the REQUEST response from the CM to the DHCPv6 server.
|
init6(i)
|
The Cisco CMTS router has seen the REPLY message from the DHCPv6 server to the CM.
|
init6(o)
|
The Cisco CMTS router has seen the REQEST message from the CM to the TFTP server.
|
init6(t)
|
The Cisco CMTS router has seen the REQUEST message from the CM to the TOD server.
|
Non-error Status Conditions
|
cc(r1)
|
The CM had registered and was online, but has received a Downstream Channel Change (DCC) or Upstream Channel Change (UCC) request message from the CMTS. The CM has begun moving to the new channel, and the CMTS has received the CM's initial ranging on the new downstream or upstream channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.
|
cc(r2)
|
This state should normally follow cc(r1) and indicates that the CM has finished its initial ranging on the new channel, and is currently performing continuous ranging on the new channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.
|
offline
|
The CM is considered offline (disconnected or powered down).
|
online
|
The CM has registered and is enabled to pass data on the network.
|
online(d)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. The CM does not forward traffic to or from the CPE devices, but the CMTS can continue to communicate with the CM using DOCSIS messages and IP traffic (such as SNMP commands).
Note If BPI was enabled in the DOCSIS configuration file sent to the CM, assume that the CM is using BPI encryption, unless other messages show that the BPI negotiation and key assignments have failed.
|
online(pkd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and KEK is assigned.
Note This state is equivalent to the online(d) and online(pk) states.
|
online(ptd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and TEK is assigned. BPI encryption is now being performed.
Note This state is equivalent to the online(d) and online(pt) states.
|
online(pk)
|
The CM registered, BPI is enabled and KEK is assigned.
|
online(pt)
|
The CM registered, BPI is enabled and TEK is assigned. BPI encryption is now being performed.
Note If network access was disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) instead of online(pt) even when BPI encryption is enabled and operational.
|
Note If an exclamation point (!) appears in front of one of the online states, it indicates that the cable dynamic-secret command has been used with either the mark or reject option, and that the cable modem has failed the dynamic secret authentication check.
|
expire(pk)
|
The CM registered, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.
|
expire(pkd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pk) states.
|
expire(pt)
|
The CM registered, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.
|
expire(ptd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pt) states.
|
Error Status Conditions
|
reject(m)
|
The CM attempted to register but registration was refused due to a bad Message Integrity Check (MIC) value. This also could indicate that the shared secret in the DOCSIS configuration file does not match the value configured on the CMTS with the cable shared-secret command.
In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases, this could also indicate that the cable tftp-enforce command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so.
|
reject(c)
|
The CM attempted to register, but registration was refused due to a a number of possible errors:
• The CM attempted to register with a minimum guaranteed upstream bandwidth that would exceed the limits imposed by the cable upstream admission-control command.
• The CM has been disabled because of a security violation.
• A bad class of service (COS) value in the DOCSIS configuration file.
• The CM attempted to create a new COS configuration but the CMTS is configured to not permit such changes.
• The CM failed the timestamp check for its DOCSIS configuration file. (This could indicate a possible theft-of-service attempt, or a problem with the synchronization of the clocks on the CM and CMTS.)
|
reject(pk)
|
KEK key assignment is rejected, BPI encryption has not been established.
|
reject(pkd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because KEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pk) states.
|
reject(pt)
|
TEK key assignment is rejected, BPI encryption has not been established.
|
reject(ptd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because TEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pt) states.
|
Note In Cisco IOS Release 12.1(20)EC, Cisco IOS Release 12.2(15)BC1, and earlier releases, when network access is disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) even if BPI encryption fails. Use the show cable modem mac-address command to confirm whether BPI is enabled or disabled for a particular cable modem.
|
reject(ts)
|
The CM attempted to register, but registration failed because the TFTP server timestamp in the CM registration request did not match the timestamp maintained by the CMTS. This might indicate that the CM attempted to register by replaying an old DOCSIS configuration file used during a prior registration attempt.
|
reject(ip)
|
The CM attempted to register, but registration failed because the IP address in the CM request did not match the IP address that the TFTP server recorded when it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.
|
reject(na)
|
The CM attempted to register, but registration failed because the CM did not send a Registration-Acknowledgement (REG-ACK) message in reply to the Registration-Response (REG-RSP) message sent by the CMTS. A Registration-NonAcknowledgement (REG-NACK) is assumed.
|
Example of the show cable modem ipv6 prefix Command for all CMs
The following example shows sample output for the show cable modem ipv6 prefix command for all CMs on the CMTS routers:
Router# show cable modem ipv6 prefix
Device Type: B - CM Bridge, R - CM Router
IP Assignment Method: D - DHCP
MAC Address Type D/IP IPv6 prefix
0006.2854.7275 R/D Y 2001:ODB8:3800:80C::/64
Example of the show cable modem ipv6 Command for all Registered CMs
The following example shows sample output for the show cable modem ipv6 registered command for all registered CMs on the CMTS routers:
Router# show cable modem ipv6 registered
Interface Prim Online CPE IP Address MAC Address
C4/0/U2 1 online 0 --- 0018.6835.27b3
C4/0/U2 2 online 0 2001:0DB8:3800:809:A896:1431:75EA:5EA1 0019.474a.c14a
C4/1/U1 2 online 0 --- 0007.0e03.6851
C4/1/U1 3 online 0 --- 0007.0e01.b085
C4/1/U1 4 online 0 2001:0DB8:3800:809:E97D:2986:9F37:FFE 0018.6835.27aa
Example of the show cable modem ipv6 cpe Command for all CMs
The following example shows sample output for the show cable modem ipv6 cpe command for all CMs on the CMTS routers:
Router# show cable modem 0019.474a.c14a ipv6 cpe
MAC Address IP Address Domain Name
0005.0052.2c1d 2001:420:3800:809:48F7:3C33:B774:9185
Related Commands
Command
|
Description
|
cable modem vendor
|
Associates the name of a vendor with its Organizational Unique Identifier (OUI).
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem rf-adapt
|
Displays RF adaptation information for cable modems.
|
show interface cable modem
|
Displays information about the CMs connected to a particular cable interface.
|
show cable modem mac
To display MAC layer information for one or more CMs, use the show cable modem mac command in privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable slot/port [upstream port] | name fqdn]
mac[summary [total]]
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable slot/subslot/port [upstream port] | name
fqdn] mac[summary [total]]
Syntax Description
ip-address
|
(Optional) Specifies the IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.
|
mac-address
|
(Optional) Specifies the MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.
|
cable slot/port
|
(Optional) Displays information for all CMs on the specified cable interface and downstream port, where:
• slot—Specifies the chassis slot number of the cable interface line card.
• port—Specifies the downstream port number.
Valid values for these arguments are dependent on your CMTS router and cable interface line card. Refer to the hardware documentation for your router chassis and cable interface line card for supported slot and port numbering.
|
cable slot/subslot/port
|
(Optional) Displays information for all CMs on the specified cable interface on a Cisco uBR10012 router, where:
• slot—Specifies the chassis slot number of the cable interface line card. Valid slots are 5 to 8.
• subslot—Specifies the secondary slot number of the cable interface line card. Valid subslots are 0 or 1.
• port—Specifies the downstream port number. Valid ports are 0 to 4, depending on the cable interface line card.
|
upstream port
|
(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.
|
name fqdn
|
(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.
|
summary [total]
|
(Optional) Displays a summary of MAC layer information for each cable interface. If you add the optional total keyword, the display includes a total of CMs that are included in each of the displayed fields.
|
Defaults
Displays MAC layer information for all CMs.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.1(4)CX and 12.2(4)BC1
|
This command was introduced for the Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 routers.
|
12.2(8)BC2
|
This command was enhanced to show whether a CM is capable of operating in DOCSIS 1.0 or DOCSIS 1.1 mode, and the version for which it is currently provisioned.
|
12.2(11)BC1
|
The mac option was enhanced to support the summary and summary total options.
|
12.2(15)CX
|
This command was enhanced to support DOCSIS 2.0 CMs using Advanced Time Division Multiple Access (A-TDMA) modulation profiles.
|
12.3(17a)BC
|
Introduced revised information that is displayed for the following two versions of the show cable modem mac command:
• show cable modem mac summary
Refer to "Usage Guidelines."
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was added.
• The name keyword option was added for specifying the fully-qualified domain name of a CM.
• The following new initialization states were added to show initialization of CMs and CPEs supporting IPv6:
– init6(s)—CMTS router has seen SOLICIT message.
– init6(a)—CMTS router has seen ADVERTISE message.
– init6(r)—CMTS router has seen REQUEST message.
– init6(i)—CMTS router has seen REPLY message.
– init6(o)—CMTS router has seen version 6 TFTP request.
– init6(t)—CMTS router has seen version 6 TOD request.
|
Usage Guidelines
Note
In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Cisco IOS Release 12.3(17a)BC introduces changes for two versions of the show cable modem mac command.
•
show cable modem mac summary
The information displayed with this command is revised. The DOCSIS 2.0 column in the Quality of Service (QoS) Provision Mode field has been removed, as this field is not applicable to QoS provisioning in DOCSIS 2.0.
Command Output in Cisco IOS Release 12.3(17a)BC and Later Releases
Router# show cable modem mac summary
Mac Version QoS Provision Mode
Interface Total DOC2.0 DOC1.1 DOC1.0 Reg/Online DOC1.1 DOC1.0
Cable5/1/0/U0 10 0 2 8 10 0 10
Command Output in Cisco IOS Release 12.3(13a)BC and Earlier Releases
Mac Version QoS Provision Mode
Interface Total DOC2.0 DOC1.1 DOC1.0 Reg/Online DOC2.0 DOC1.1 DOC1.0
Cable8/0/0/U0 8 0 5 3 5 0 5 0
Examples
This section contains examples for the different forms of the show cable modem mac command.
Default Displays
The following example shows typical output for the default form of the show cable modem mac command:
Router# show cable modem mac
MAC Address MAC Prim Ver QoS Frag Concat PHS Priv DS US
State Sid Prov Saids Sids
0050.7366.1243 online 1 DOC1.0 DOC1.0 no no no BPI 0 0
0002.b970.0027 online 2 DOC1.1 DOC1.0 no yes yes BPI+ 0 4
0006.5314.858d online 3 DOC1.1 DOC1.1 yes yes yes BPI+ 0 4
0010.64ff.e4ad online 1 DOC1.1 DOC1.0 yes yes yes BPI+ 0 4
0010.f025.1bd9 init(rc) 2 DOC1.0 DOC1.0 no no no BPI 0 0
0010.9659.4447 online(pt) 3 DOC1.0 DOC1.0 no yes no BPI 0 0
0010.9659.4461 online(pt) 4 DOC1.0 DOC1.0 no yes no BPI 0 0
0010.64ff.e459 online 5 DOC1.0 DOC1.0 no yes no BPI 0 0
0020.4089.7ed6 online 6 DOC1.0 DOC1.0 no no no BPI 0 0
0090.9607.3831 online(pt) 7 DOC1.0 DOC1.0 no no no BPI 0 0
0090.9607.3830 online(pt) 1 DOC1.0 DOC1.0 no no no BPI 0 0
0050.7366.12fb init(i) 2 DOC1.0 DOC1.0 no no no BPI 0 0
0010.fdfa.0a35 online(pt) 3 DOC1.1 DOC1.1 yes yes yes BPI+ 0 4
The following example shows sample output for the show cable modem mac command for a particular cable interface:
Router# show cable modem c3/0 mac
MAC Address MAC Prim Ver QoS Frag Concat PHS Priv DS US
State Sid Prov Saids Sids
0050.7366.1243 online 1 DOC1.0 DOC1.0 no no no BPI 0 0
0002.b970.0027 online 2 DOC1.1 DOC1.0 no yes yes BPI+ 0 4
0006.5314.858d online 3 DOC1.1 DOC1.1 yes yes yes BPI+ 0 4
The following example shows sample output for the show cable modem mac command for a particular CM, as identified by its MAC address:
Router# show cable modem 0010.7bb3.fcd1 mac
MAC Address MAC Prim Ver QoS Frag Concat PHS Priv DS US
State Sid Prov Saids Sids
0010.7bb3.fcd1 online 91 DOC1.1 DOC1.1 yes yes yes BPI+ 1 4
The following example shows sample output for the show cable modem mac command for a particular CM, as identified by its IP address:
Router# show cable modem 10.1.1.10 mac
MAC Address MAC Prim Ver QoS Frag Concat PHS Priv DS US
State Sid Prov Saids Sids
0002.b970.0027 online 2 DOC1.1 DOC1.0 no yes yes BPI+ 0 4
Table 24 describes the fields shown in the default forms of the show cable modem mac displays:
Table 24 Descriptions for the Default show cable modem mac Fields
Field
|
Description
|
MAC Address
|
The MAC address for the CM.
|
MAC State
|
The current state of the MAC layer (see Table 23).
|
Prim SID
|
The primary SID assigned to this CM.
|
Ver
|
Displays the maximum supported version of DOCSIS that the CM supports (DOCSIS 1.0, DOCSIS 1.1, DOCSIS 2.0).
|
QoS Prov
|
Displays the version of DOCSIS that the CM currently is provisioned and registered for (DOCSIS 1.0, DOCSIS 1.1, DOCSIS 2.0).
|
Frag
|
Indicates whether DOCSIS 1.1 or 2.0 MAC-layer fragmentation is enabled for this CM.
|
Concat
|
Indicates whether DOCSIS 1.1 or 2.0 MAC-layer concatenation is enabled for this CM.
|
PHS
|
Indicates whether DOCSIS 1.1 or 2.0 packet header suppression (PHS) is enabled for this CM.
|
Priv
|
Indicates whether Baseline Privacy Interface (BPI) or BPI Plus (BPI+) encryption is enabled for the CM.
|
DS Saids
|
Number of downstream security association IDs (Saids) used by this CM.
|
US Sids
|
Number of upstream service IDs (SIDs) used by this CM.
|
Table 23 shows the possible values for the MAC state field:
Table 25 Descriptions for the MAC State Field 1
MAC State Value
|
Description
|
Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing
|
init(r1)
|
The CM sent initial ranging.
|
init(r2)
|
The CM is ranging. The CMTS received initial ranging from the Cm and has sent RF power, timing offset, and frequency adjustments to the CM.
|
init(rc)
|
Ranging has completed.
Note If a CM appears to be stuck in this state, it could be that the CM is able to communicate successfully on the cable network, but that the upstream is at capacity and does not have any additional bandwidth to allow the CM to finish registration and come online. Either manually move one or more CMs to other upstreams, or enable load balancing on the upstream using the cable load-balance group commands.
|
init(d)
|
The DHCP request was received, as DHCPDISCOVER. This also indicates that the first IP broadcast packet has been received from the CM.
|
init(dr)
|
The DHCP request has been sent to the cable modem.
|
init(i)
|
The cable modem has received the DHCPOFFER reply (DHCPACK) from the DHCP server that has assigned an IP address to the modem, but the modem has not yet replied with a DHCPREQUEST message requesting that particular IP address, nor has it sent an IP packet with that IP address.
Note If a CM appears to be stuck in this state, the CM has likely received the DHCPOFFER reply from the DHCP server, but this reply might have contained one or more invalid options for that particular CM.
|
init(io)
|
The Cisco CMTS has seen the DHCP offer as sent to the cable modem from the DHCP server that has assigned an IP address to the modem.
|
init(o)
|
The CM has begun to download the option file (DOCSIS configuration file) using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP response. If the CM remains in this state, it indicates that the download has failed.
|
init(t)
|
Time-of-day (TOD) exchange has started.
|
resetting
|
The CM is being reset and will shortly restart the registration process.
|
| |
init6(s)
|
The Cisco CMTS router has seen the DHCPv6 SOLICIT message from the CM.
|
init6(a)
|
The Cisco CMTS router has seen the ADVERTISE message from the DHCPv6 server to the CM.
|
init6(r)
|
The Cisco CMTS router has seen the REQUEST response from the CM to the DHCPv6 server.
|
init6(i)
|
The Cisco CMTS router has seen the REPLY message from the DHCPv6 server to the CM.
|
init6(o)
|
The Cisco CMTS router has seen the REQEST message from the CM to the TFTP server.
|
init6(t)
|
The Cisco CMTS router has seen the REQUEST message from the CM to the TOD server.
|
Non-error Status Conditions
|
cc(r1)
|
The CM had registered and was online, but has received a Downstream Channel Change (DCC) or Upstream Channel Change (UCC) request message from the CMTS. The CM has begun moving to the new channel, and the CMTS has received the CM's initial ranging on the new downstream or upstream channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.
|
cc(r2)
|
This state should normally follow cc(r1) and indicates that the CM has finished its initial ranging on the new channel, and is currently performing continuous ranging on the new channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.
|
offline
|
The CM is considered offline (disconnected or powered down).
|
online
|
The CM has registered and is enabled to pass data on the network.
|
online(d)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. The CM does not forward traffic to or from the CPE devices, but the CMTS can continue to communicate with the CM using DOCSIS messages and IP traffic (such as SNMP commands).
Note If BPI was enabled in the DOCSIS configuration file sent to the CM, assume that the CM is using BPI encryption, unless other messages show that the BPI negotiation and key assignments have failed.
|
online(pkd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and KEK is assigned.
Note This state is equivalent to the online(d) and online(pk) states.
|
online(ptd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and TEK is assigned. BPI encryption is now being performed.
Note This state is equivalent to the online(d) and online(pt) states.
|
online(pk)
|
The CM registered, BPI is enabled and KEK is assigned.
|
online(pt)
|
The CM registered, BPI is enabled and TEK is assigned. BPI encryption is now being performed.
Note If network access was disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) instead of online(pt) even when BPI encryption is enabled and operational.
|
Note If an exclamation point (!) appears in front of one of the online states, it indicates that the cable dynamic-secret command has been used with either the mark or reject option, and that the cable modem has failed the dynamic secret authentication check.
|
expire(pk)
|
The CM registered, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.
|
expire(pkd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pk) states.
|
expire(pt)
|
The CM registered, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.
|
expire(ptd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pt) states.
|
Error Status Conditions
|
reject(m)
|
The CM attempted to register but registration was refused due to a bad Message Integrity Check (MIC) value. This also could indicate that the shared secret in the DOCSIS configuration file does not match the value configured on the CMTS with the cable shared-secret command.
In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases, this could also indicate that the cable tftp-enforce command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so.
|
reject(c)
|
The CM attempted to register, but registration was refused due to a a number of possible errors:
• The CM attempted to register with a minimum guaranteed upstream bandwidth that would exceed the limits imposed by the cable upstream admission-control command.
• The CM has been disabled because of a security violation.
• A bad class of service (COS) value in the DOCSIS configuration file.
• The CM attempted to create a new COS configuration but the CMTS is configured to not permit such changes.
• The CM failed the timestamp check for its DOCSIS configuration file. (This could indicate a possible theft-of-service attempt, or a problem with the synchronization of the clocks on the CM and CMTS.)
|
reject(pk)
|
KEK key assignment is rejected, BPI encryption has not been established.
|
reject(pkd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because KEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pk) states.
|
reject(pt)
|
TEK key assignment is rejected, BPI encryption has not been established.
|
reject(ptd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because TEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pt) states.
|
Note In Cisco IOS Release 12.1(20)EC, Cisco IOS Release 12.2(15)BC1, and earlier releases, when network access is disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) even if BPI encryption fails. Use the show cable modem mac-address command to confirm whether BPI is enabled or disabled for a particular cable modem.
|
reject(ts)
|
The CM attempted to register, but registration failed because the TFTP server timestamp in the CM registration request did not match the timestamp maintained by the CMTS. This might indicate that the CM attempted to register by replaying an old DOCSIS configuration file used during a prior registration attempt.
|
reject(ip)
|
The CM attempted to register, but registration failed because the IP address in the CM request did not match the IP address that the TFTP server recorded when it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.
|
reject(na)
|
The CM attempted to register, but registration failed because the CM did not send a Registration-Acknowledgement (REG-ACK) message in reply to the Registration-Response (REG-RSP) message sent by the CMTS. A Registration-NonAcknowledgement (REG-NACK) is assumed.
|
Summary and Total Options
The following example shows the same display for the show cable modem mac summary command:
Router# show cable modem mac summary
Mac Version QoS Provision Mode
Interface Total DOC2.0 DOC1.1 DOC1.0 Reg/Online DOC2.0 DOC1.1 DOC1.0
Cable8/1/0/U1 1 1 0 0 1 0 0 1
Cable8/1/0/U4 2 2 0 2 2 1 1 0
The following example shows the summary display when the total option is added:
Router# show cable modem mac summary total
Mac Version QoS Provision Mode
Interface Total DOC2.0 DOC1.1 DOC1.0 Reg/Online DOC2.0 DOC1.1 DOC1.0
Cable5/1/0/U5 1 0 0 1 1 0 0 1
Cable6/1/0/U0 11 0 0 11 8 0 0 8
Cable6/1/1/U2 17 0 1 16 15 0 0 15
Cable7/0/0/U0 2 0 0 2 1 0 0 1
Cable7/0/0/U5 1 0 0 1 0 0 0 0
Total: 32 0 1 31 25 0 0 25
Table 26 describes the fields shown in the show cable modem mac summary displays:
Table 26 Descriptions for the show cable modem mac summary Fields
Field
|
Description
|
I/F
|
The cable interface line card providing the upstream for this CM.
|
Total
|
Total number of CMs currently active on this cable interface.
|
MAC Version DOC 2.0
|
Total number of CMs on this interface that reported in their registration request as having DOCSIS 2.0 capabilities.
|
MAC Version DOC 1.1
|
Total number of CMs on this interface that reported in their registration request as having DOCSIS 1.1 capabilities.
|
MAC Version DOC 1.0
|
Total number of CMs on this interface that reported in their registration request as having DOCSIS 1.0 capabilities.
|
Reg/Online
|
Total number of CMs on this interface that have completed registration and are currently online.
|
QoS Provisioned Mode DOC 2.0
|
Total number of CMs on this interface that have been provisioned and registered for DOCSIS 2.0 operations.
|
QoS Provisioned Mode DOC 1.1
|
Total number of CMs on this interface that have been provisioned and registered for DOCSIS 1.1 operations.
|
QoS Provisioned Mode DOC 1.0
|
Total number of CMs on this interface that have been provisioned and registered for DOCSIS 1.0 operations.
|
Related Commands
Command
|
Description
|
cable modem vendor
|
Associates the name of a vendor with its Organizational Unique Identifier (OUI).
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem cnr
|
Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.
|
show cable modem connectivity
|
Displays connectivity statistics for one or more CMs.
|
show cable modem errors
|
Displays error statistics for one or more CMs.
|
show cable modem flap
|
Displays flap list statistics for one or more CMs.
|
show cable modem maintenance
|
Displays station maintenance (SM) error statistics for one or more CMs.
|
show cable modem phy
|
Displays the DOCSIS PHY layer information for one or more CMs.
|
show interface cable modem
|
Displays information about the CMs connected to a particular cable interface.
|
show interface cable sid
|
Displays cable interface information.
|
show cable modem maintenance
To display station maintenance (SM) error statistics for one or more cable modems, use the show cable modem maintenance command in privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] maintenance
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn]
maintenance
Syntax Description
ip-address
|
(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.
|
mac-address
|
(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.
|
slot
|
Slot where the line card resides.
• Cisco uBR7225VXR router—The valid value is 1 or 2.
• Cisco uBR7246VXR router—The valid range is from 3 to 6.
• Cisco uBR10012 router—The valid range is from 5 to 8.
|
subslot
|
(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
|
port
|
Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.
• Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).
|
cable-interface-index
|
Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.
• Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
upstream port
|
(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.
|
logical-channel-index
|
(Optional) Logical channel index. The valid values are 0 or 1.
|
name fqdn
|
(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.
|
maintenance
|
Displays station maintenance (SM) error statistics for one or more cable modems.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
11.3XA
|
This command was introduced.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was added.
• The name keyword option was added for specifying the fully-qualified domain name of a CM.
|
12.2(33)SCE
|
This command was modified. The port parameter was changed to cable-interface-index.
|
12.2(33)SCF
|
This command was modified. The logical-channel-index argument was added.
|
Usage Guidelines
This command displays information about the number of times that a CM has exhausted its maximum retry attempts to respond to a Station Maintenance (SM) request, as well as the number of times that the CMTS has aborted ranging with a CM during a Station Maintenance interval. This information can be used to determine whether a particular cable modem or interface is experiencing plant or network difficulties.
You can display this information for all online cable modems, all online cable modems for a specific cable interface, or for one particular cable modem.
Note
In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Examples
The following example shows sample output for the show cable modem maintenance command for all online cable modems:
Router# show cable modem maintenance
MAC Address I/F Prim SM Exhausted SM Aborted
Sid Count Time Count Time
0010.9507.01db C5/1/0/U5 1 0 --- -- 00:00:00 0 --- -- 00:00:00
0002.b96f.fdbb C6/1/0/U0 5 1 Jun 20 13:23:03 0 --- -- 00:00:00
0002.fdfa.129d C6/1/0/U0 6 0 --- -- 00:00:00 0 --- -- 00:00:00
0002.fdfa.137d C6/1/0/U0 7 0 --- -- 00:00:00 0 --- -- 00:00:00
0050.7302.3d73 C6/1/0/U0 8 0 --- -- 00:00:00 0 --- -- 00:00:00
0002.fdfa.12d5 C6/1/0/U0 9 0 --- -- 00:00:00 0 --- -- 00:00:00
0002.fdfa.1163 C6/1/0/U0 10 0 --- -- 00:00:00 0 --- -- 00:00:00
0006.28f9.8bbd C6/1/0/U0 11 0 --- -- 00:00:00 0 --- -- 00:00:00
00d0.bad3.c0cf C6/1/0/U0 12 0 --- -- 00:00:00 0 --- -- 00:00:00
0003.e38f.e85b C6/1/0/U0 14 149 Jun 21 14:24:03 0 --- -- 00:00:00
0001.9659.519f C6/1/0/U0 18 53 Jun 21 14:25:32 0 --- -- 00:00:00
0003.e3a6.8195 C6/1/0/U0 19 10 Jun 21 05:37:54 0 --- -- 00:00:00
0003.e3a6.8173 C6/1/1/U2 15 2 Jun 20 13:41:27 0 --- -- 00:00:00
0002.fdfa.12ef C6/1/1/U2 16 1 Jun 20 13:16:30 0 --- -- 00:00:00
0002.fdfa.12e9 C6/1/1/U2 17 1 Jun 20 13:16:30 0 --- -- 00:00:00
0003.e3a6.7f69 C6/1/1/U2 18 2 Jun 20 13:43:10 0 --- -- 00:00:00
0030.80bc.3095 C6/1/1/U2 19 2 Jun 20 13:45:00 0 --- -- 00:00:00
0003.e38f.e9ab C6/1/1/U2 20 1 Jun 20 13:43:47 0 --- -- 00:00:00
0006.28f9.9d19 C6/1/1/U2 22 0 --- -- 00:00:00 0 --- -- 00:00:00
0003.e3a6.7fe3 C6/1/1/U2 23 0 --- -- 00:00:00 0 --- -- 00:00:00
0020.4005.3f06 C6/1/1/U2 24 0 --- -- 00:00:00 0 --- -- 00:00:00
The following example shows sample output for the show cable modem maintenance command for all cable modems on a specific cable interface:
Router# show cable modem c8/1/0 maintenance
MAC Address I/F Prim SM Exhausted SM Aborted
Sid Count Time Count Time
0050.7366.1243 C8/1/0/U1 1 1 Apr 28 13:06:11 0 --- -- 00:00:00
0002.b970.0027 C8/1/0/U4 2 0 --- -- 00:00:00 0 --- -- 00:00:00
0006.5314.858d C8/1/0/U4 3 2 Apr 28 13:07:28 0 --- -- 00:00:00
The following example shows sample output for the show cable modem maintenance command for a particular CM:
Router# show cable modem 0010.7bb3.fcd1 maintenance
MAC Address I/F Prim SM Exhausted SM Aborted
Sid Count Time Count Time
0010.7bb3.fcd1 C5/0/U5 1 3 Jun 1 10:24:52 0 Jan 1 00:00:00
Table 27 describes the fields shown in the show cable modem maintenance displays:
Table 27 Descriptions for the show cable modem maintenance Fields
Field
|
Description
|
MAC Address
|
The MAC address for the CM.
|
I/F
|
The cable interface line card, including upstream, for this CM.
|
Prim SID
|
The primary SID assigned to this CM.
|
SM Exhausted Count
|
Number of times this CM has repeatedly timed out and exhausted the maximum allowable retry attempts when it was sent a Station Maintenance request. The CMTS responds by taking the CM offline, forcing the CM to reinitialize and reregister.
|
SM Exhausted Time
|
The last time that this CM repeatedly timed out and exhausted the maximum allowable retry attempts when it was sent a Station Maintenance request.
|
SM Aborted Count
|
Number of times the CMTS has aborted ranging for a CM during a Station Maintenance period, typically because the CM has been reset.
|
SM Aborted Time
|
The last time the CMTS aborted ranging for a CM during a Station Maintenance period, typically because the CM has been reset.
|
Related Commands
Command
|
Description
|
cable flap-list miss-threshold
|
Configures the threshold for recording a flap-list event, in terms of missed Station Maintenance messages.
|
cable modem vendor
|
Associates the name of a vendor with its Organizational Unique Identifier (OUI).
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem calls
|
Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.
|
show cable modem cnr
|
Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.
|
show cable modem domain-name
|
Updates the cable-specific DNS cache and display the domain name for specified CMs and CPE behind a CM on a Cisco CMTS router.
|
show cable modem remote-query
|
Displays information collected by the remote-query feature.
|
show cable modem rf-adapt
|
Displays RF adaptation information for cable modems.
|
show cable modulation-profile
|
Displays modulation profile group information.
|
show interface cable modem
|
Displays information about the CMs connected to a particular cable interface.
|
show interface cable sid
|
Displays cable interface information.
|
show cable modem offline
To display a list of the cable modems (CMs) that are marked as offline with the Cisco CMTS router, use the show cable modem offline command in privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] offline
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn]
offline
Syntax Description
ip-address
|
(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.
|
mac-address
|
(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.
|
slot
|
Slot where the line card resides.
• Cisco uBR7225VXR router—The valid value is 1 or 2.
• Cisco uBR7246VXR router—The valid range is from 3 to 6.
• Cisco uBR10012 router—The valid range is from 5 to 8.
|
subslot
|
(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
|
port
|
Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.
• Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).
|
cable-interface-index
|
Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.
• Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
upstream port
|
(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.
|
logical-channel-index
|
(Optional) Logical channel index. The valid values are 0 or 1.
|
name fqdn
|
(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.
|
offline
|
Displays a list of the cable modems that are marked as offline.
|
Defaults
Displays a list of all offline CMs known by the Cisco CMTS router.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.0(7)XR and 12.1(1a)T1
|
This command was introduced.
|
12.2(4)BC1
|
Support for the Cisco uBR10012 router was introduced.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was added.
• The name keyword option was added for specifying the fully-qualified domain name of a CM.
• The following new initialization states were added to show initialization of CMs and CPEs supporting IPv6:
– init6(s)—CMTS router has seen SOLICIT message.
– init6(a)—CMTS router has seen ADVERTISE message.
– init6(r)—CMTS router has seen REQUEST message.
– init6(i)—CMTS router has seen REPLY message.
– init6(o)—CMTS router has seen version 6 TFTP request.
– init6(t)—CMTS router has seen version 6 TOD request.
|
12.2(33)SCE
|
This command was modified. The port parameter was changed to cable-interface-index.
|
12.2(33)SCF
|
This command was modified. The logical-channel-index argument was added.
|
Usage Guidelines
This command displays a list of CMs that had either been online previously or had attempted to register with the CMTS, but that are now considered offline. Offline cable modems remain in the CMTS databases for 24 hours and then are deleted.
Note
In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Examples
The following example shows sample output for the default form of the show cable modem offline command.
Router# show cable modem offline
Interface MAC address Prim Previous Offline Rx Rx SM
Sid State Time Power SNR Exhaust
Cable5/0/U0 0030.946a.5d61 1 init(i) Jun 14 21:31:57 0.00 31.86 162
Cable5/0/U0 0030.946a.5d85 2 init(i) Jun 14 22:47:39 -0.25 31.26 156
Cable5/0/U0 0030.946a.5b6d 3 init(i) Jun 14 14:20:11 1.00 30.56 166
The following example shows sample output for the show cable modem offline command for a particular upstream on a cable interface:
Router# show cable modem c3/0 upstream 0 offline
Interface MAC address Prim Previous Offline Rx Rx SM
Sid State Time Power SNR Exhaust
C3/0/U0 0050.7366.1c69 58 init(rc) Jan 7 16:46:49 4.50 26.72 2
C3/0/U0 0050.7366.1c53 59 init(rc) Jan 7 16:47:09 5.25 25.10 1
C3/0/U0 0050.7366.1ca7 60 init(rc) Jan 7 16:47:11 5.00 25.57 1
C3/0/U0 0050.7366.1c45 61 init(rc) Jan 7 16:49:27 5.00 26.74 2
C3/0/U0 0050.7366.1c95 62 init(rc) Jan 7 16:51:29 5.50 31.82 1
C3/0/U0 0050.7366.1c99 64 init(rc) Jan 7 16:52:55 5.25 26.76 2
The following example shows sample output for the show cable modem offline command for a single CM, as identified by its IP address:
Router# show cable modem 22.1.1.10 offline
Interface MAC address Prim Previous Offline Rx Rx SM
Sid State Time Power SNR Exhaust
Cable5/0/U0 0030.946a.5b6d 3 init(i) Jun 14 14:20:11 1.00 30.56 166
The following example shows sample output for the show cable modem offline command for a single CM, as identified by its MAC address:
Router# show cable modem 0030.946a.5d61 offline
Interface MAC address Prim Previous Offline Rx Rx SM
Sid State Time Power SNR Exhaust
Cable5/0/U0 0030.946a.5d61 1 init(i) Jun 14 21:31:57 0.00 31.86 162
Table 28 describes the major fields shown in the show cable modem offline displays:
Table 28 Descriptions for the show cable modem offline Fields
Field
|
Description
|
Interface
|
The cable interface line card that this CM last used when it was online.
|
MAC address
|
Hardware MAC address for this CM.
|
Prim SID
|
The primary SID that had been last assigned to this CM before it went offline.
|
Previous State
|
The last known state of the MAC layer for this CM before it went offline (see Table 23).
Note A pound sign (#) in the Previous State column indicates that the cable tftp-enforce mark-only command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so (Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases).
|
Offline Time
|
The time and date that this CM last went offline.
|
Rx Power
|
The last known received power level (in dB) for the CM before it went offline.
Note An asterisk (*) in the Rx Power column indicates that a power adjustment was made for that CM. An exclamation point (!) indicates that the CM had reached its maximum power transmit level and could not increase its power level further.
|
Rx SNR
|
The last known signal-to-noise ratio (SNR) value for this CM before it went offline.
|
SM Exhaust Count
|
Number of times that this CM has exhausted the maximum allowable retries for not responding to the regular Station Maintenance (SM) messages sent to it by the CMTS.
|
Note Using the clear counters command to reset a cable interface's counters also resets the SM Exhaust Count field for all offline CMs to zero and resets the Offline Time field for all offline CMs to the current time.
|
Table 23 shows the possible values for the Previous State field:
Table 29 Descriptions for the Previous State Field 1
MAC State Value
|
Description
|
Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing
|
init(r1)
|
The CM sent initial ranging.
|
init(r2)
|
The CM is ranging. The CMTS received initial ranging from the Cm and has sent RF power, timing offset, and frequency adjustments to the CM.
|
init(rc)
|
Ranging has completed.
Note If a CM appears to be stuck in this state, it could be that the CM is able to communicate successfully on the cable network, but that the upstream is at capacity and does not have any additional bandwidth to allow the CM to finish registration and come online. Either manually move one or more CMs to other upstreams, or enable load balancing on the upstream using the cable load-balance group commands.
|
init(d)
|
The DHCP request was received, as DHCPDISCOVER. This also indicates that the first IP broadcast packet has been received from the CM.
|
init(dr)
|
The DHCP request has been sent to the cable modem.
|
init(i)
|
The cable modem has received the DHCPOFFER reply (DHCPACK) from the DHCP server that has assigned an IP address to the modem, but the modem has not yet replied with a DHCPREQUEST message requesting that particular IP address, nor has it sent an IP packet with that IP address.
Note If a CM appears to be stuck in this state, the CM has likely received the DHCPOFFER reply from the DHCP server, but this reply might have contained one or more invalid options for that particular CM.
|
init(io)
|
The Cisco CMTS has seen the DHCP offer as sent to the cable modem from the DHCP server that has assigned an IP address to the modem.
|
init(o)
|
The CM has begun to download the option file (DOCSIS configuration file) using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP response. If the CM remains in this state, it indicates that the download has failed.
|
init(t)
|
Time-of-day (TOD) exchange has started.
|
resetting
|
The CM is being reset and will shortly restart the registration process.
|
| |
init6(s)
|
The Cisco CMTS router has seen the DHCPv6 SOLICIT message from the CM.
|
init6(a)
|
The Cisco CMTS router has seen the ADVERTISE message from the DHCPv6 server to the CM.
|
init6(r)
|
The Cisco CMTS router has seen the REQUEST response from the CM to the DHCPv6 server.
|
init6(i)
|
The Cisco CMTS router has seen the REPLY message from the DHCPv6 server to the CM.
|
init6(o)
|
The Cisco CMTS router has seen the REQEST message from the CM to the TFTP server.
|
init6(t)
|
The Cisco CMTS router has seen the REQUEST message from the CM to the TOD server.
|
Non-error Status Conditions
|
cc(r1)
|
The CM had registered and was online, but has received a Downstream Channel Change (DCC) or Upstream Channel Change (UCC) request message from the CMTS. The CM has begun moving to the new channel, and the CMTS has received the CM's initial ranging on the new downstream or upstream channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.
|
cc(r2)
|
This state should normally follow cc(r1) and indicates that the CM has finished its initial ranging on the new channel, and is currently performing continuous ranging on the new channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.
|
offline
|
The CM is considered offline (disconnected or powered down).
|
online
|
The CM has registered and is enabled to pass data on the network.
|
online(d)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. The CM does not forward traffic to or from the CPE devices, but the CMTS can continue to communicate with the CM using DOCSIS messages and IP traffic (such as SNMP commands).
Note If BPI was enabled in the DOCSIS configuration file sent to the CM, assume that the CM is using BPI encryption, unless other messages show that the BPI negotiation and key assignments have failed.
|
online(pkd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and KEK is assigned.
Note This state is equivalent to the online(d) and online(pk) states.
|
online(ptd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and TEK is assigned. BPI encryption is now being performed.
Note This state is equivalent to the online(d) and online(pt) states.
|
online(pk)
|
The CM registered, BPI is enabled and KEK is assigned.
|
online(pt)
|
The CM registered, BPI is enabled and TEK is assigned. BPI encryption is now being performed.
Note If network access was disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) instead of online(pt) even when BPI encryption is enabled and operational.
|
Note If an exclamation point (!) appears in front of one of the online states, it indicates that the cable dynamic-secret command has been used with either the mark or reject option, and that the cable modem has failed the dynamic secret authentication check.
|
expire(pk)
|
The CM registered, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.
|
expire(pkd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pk) states.
|
expire(pt)
|
The CM registered, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.
|
expire(ptd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pt) states.
|
Error Status Conditions
|
reject(m)
|
The CM attempted to register but registration was refused due to a bad Message Integrity Check (MIC) value. This also could indicate that the shared secret in the DOCSIS configuration file does not match the value configured on the CMTS with the cable shared-secret command.
In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases, this could also indicate that the cable tftp-enforce command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so.
|
reject(c)
|
The CM attempted to register, but registration was refused due to a a number of possible errors:
• The CM attempted to register with a minimum guaranteed upstream bandwidth that would exceed the limits imposed by the cable upstream admission-control command.
• The CM has been disabled because of a security violation.
• A bad class of service (COS) value in the DOCSIS configuration file.
• The CM attempted to create a new COS configuration but the CMTS is configured to not permit such changes.
• The CM failed the timestamp check for its DOCSIS configuration file. (This could indicate a possible theft-of-service attempt, or a problem with the synchronization of the clocks on the CM and CMTS.)
|
reject(pk)
|
KEK key assignment is rejected, BPI encryption has not been established.
|
reject(pkd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because KEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pk) states.
|
reject(pt)
|
TEK key assignment is rejected, BPI encryption has not been established.
|
reject(ptd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because TEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pt) states.
|
Note In Cisco IOS Release 12.1(20)EC, Cisco IOS Release 12.2(15)BC1, and earlier releases, when network access is disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) even if BPI encryption fails. Use the show cable modem mac-address command to confirm whether BPI is enabled or disabled for a particular cable modem.
|
reject(ts)
|
The CM attempted to register, but registration failed because the TFTP server timestamp in the CM registration request did not match the timestamp maintained by the CMTS. This might indicate that the CM attempted to register by replaying an old DOCSIS configuration file used during a prior registration attempt.
|
reject(ip)
|
The CM attempted to register, but registration failed because the IP address in the CM request did not match the IP address that the TFTP server recorded when it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.
|
reject(na)
|
The CM attempted to register, but registration failed because the CM did not send a Registration-Acknowledgement (REG-ACK) message in reply to the Registration-Response (REG-RSP) message sent by the CMTS. A Registration-NonAcknowledgement (REG-NACK) is assumed.
|
Related Commands
Command
|
Description
|
cable modem vendor
|
Associates the name of a vendor with its Organizational Unique Identifier (OUI).
|
clear counters
|
Clears counters for one or all interfaces.
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem access-group
|
Displays the access groups for the CMs on a particular cable interface.
|
show cable modem classifiers
|
Displays information about the classifiers for a particular CM.
|
show cable modem connectivity
|
Displays connectivity statistics for one or more CMs.
|
show cable modem cpe
|
Displays the CPE devices accessing the cable interface through a particular CM.
|
show cable modem registered
|
Displays a list of the CMs that are marked as registered with the Cisco CMTS.
|
show cable modem rf-adapt
|
Displays RF adaptation information for cable modems.
|
show cable modem unregistered
|
Displays a list of the CMs that are marked as unregistered with the Cisco CMTS.
|
show cable modem vendor
|
Displays the vendor name or Organizational Unique Identifier (OUI) for the CMs on each cable interface.
|
show interface cable modem
|
Displays information about the CMs connected to a particular cable interface.
|
show interface cable sid
|
Displays cable interface information.
|
show cable modem partial-mode
To display information about cable modems that are in upstream and downstream partial service mode, use the show cable modem partial-mode command in privileged EXEC mode.
show cable modem partial-mode
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCD2
|
This command was introduced.
|
Usage Guidelines
If all cable modems are in full service mode (all downstream and upstream channels of the cable modems are online and operational), then the show cable modem partial-mode command does not provide any output. This command provides output only when the cable modems register in partial service mode (one or more downstream or upstream channels of the downstream or upstream bonded cable modems are not operational).
Examples
The following is a sample output of the show cable modem partial-mode command that displays all the cable modems in partial service mode:
Router# show cable modem partial-mode
MAC Address IP Address I/F MAC Prim RCC UP-reason/
001e.6bfb.33a0 2.99.81.14 C7/0/0/p p-online(pt) 3 2 0x1 / 0x4
0022.cef4.3d9a 2.99.81.23 C7/0/0/p p-online(pt) 4 2 0x1 / 0x4
001e.6bfb.194e 2.99.81.32 C7/0/0/p p-online(pt) 6 2 0x1 / 0x4
001e.6bfb.1538 2.99.81.38 C7/0/0/p p-online(pt) 8 2 0x1 / 0x4
001e.6bfb.0d22 2.99.81.29 C7/0/0/p p-online(pt) 9 1 0x1 / 0x4
001e.6bfb.1a7e 2.99.81.30 C7/0/0/p p-online(pt) 10 1 0x1 / 0x4
001e.6bfa.f58a 2.99.81.9 C7/0/0/p p-online(pt) 12 1 0x1 / 0x4
0022.cef4.3fa2 2.99.81.24 C7/0/0/p p-online(pt) 13 2 0x1 / 0x4
001e.6bfb.1b72 2.99.81.10 C7/0/0/p p-online(pt) 14 2 0x1 / 0x4
0023.be50.e578 2.99.81.17 C7/0/0/UB p-online(pt) 16 2 N/A
0025.2e2d.784a 2.99.81.28 C7/0/0/UB p-online(pt) 17 2 N/A
0025.2e2d.748c 2.99.81.26 C7/0/0/UB p-online(pt) 18 2 N/A
Table 30 describes the significant fields shown in the display.
Table 30 show cable modem partial-mode Field Descriptions
Field
|
Description
|
MAC Address
|
MAC address of the cable modem.
|
IP Address
|
IP address that the DHCP server has assigned to the cable modem.
|
I/F
|
Cable interface line card providing the upstream for the cable modem.
|
MAC State
|
Current state of the MAC layer.
|
Prim Sid
|
Primary Service ID (SID) assigned to the cable modem.
|
RCC ID
|
Receive channel configuration (RCC) ID of the cable modem.
|
UP-reason/Failed-tcs
|
• UP-reason—Upstream partial service reason. This is a bitmap defined in upstream resiliency.
• Failed-tcs—Transmit channel set (TCS) bitmap of the cable modem, which is not available.
|
Related Commands
Command
|
Description
|
show cable modem
|
Displays information about the registered and unregistered cable modems.
|
show cable modem docsis-version
|
Displays information about the DOCSIS version of cable modems on one or more cable interfaces.
|
show cable modem phy
To display DOCSIS PHY layer information for one or more cable modems (CMs), use the show cable modem phy command in privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] phy
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] phy
Syntax Description
ip-address
|
(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.
|
mac-address
|
(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.
|
slot
|
Slot where the line card resides.
• Cisco uBR7225VXR router—The valid value is 1 or 2.
• Cisco uBR7246VXR router—The valid range is from 3 to 6.
• Cisco uBR10012 router—The valid range is from 5 to 8.
|
subslot
|
(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
|
port
|
Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.
• Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).
|
cable-interface-index
|
Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.
• Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
upstream port
|
(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.
|
logical-channel-index
|
(Optional) Logical channel index. The valid values are 0 or 1.
|
name fqdn
|
(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.
|
phy
|
Displays DOCSIS PHY layer information for one or more cable modems.
|
Defaults
Displays PHY information for all CMs.
Command Modes
Privileged EXEC (#)
Command History
This table includes the following release-specific history entries:
•
CX and BC Releases
•
SC Release
CX and BC Releases
|
Modification
|
12.1(4)CX and 12.2(4)BC1
|
This command was introduced for the Cisco uBR7100 series, Cisco uBR7200 series, and CIsco uBR10012 routers.
|
12.2(15)BC2
|
The service ID (SID) and Mode fields were added to the default display.
|
12.3(17a)BC
|
Enhanced the show cable modem phy command. The MicroReflec column (MicroReflections) has been removed, and the DOCSIS Prov (DOCSIS Provider) column has been added in its place. This new column contains DOCSIS version information. See updated examples.
|
SC Release
|
Modification
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was added.
• The name keyword option was added for specifying the fully-qualified domain name of a CM.
|
12.2(33)SCC
|
For DOCSIS 3.0-certified cable modems with multiple upstream channels, the command output was modified to display PHY layer details of each upstream channel. In this case, the output may contain multiple results for the same MAC address. The asterix (*) that appears beside the DOCSIS operating mode under the Mode column identifies that the CM is operating in the MTC mode.
|
12.2(33)SCE
|
This command was modified. The port parameter was changed to cable-interface-index.
|
12.2(33)SCF
|
This command was modified. The logical-channel-index argument was added.
|
Usage Guidelines
This command displays information about the DOCSIS PHY layer for one or more CMs. You can display information for all CMs, for all CMs on a particular cable interface, or for a particular CM, as identified by its IP or MAC address.
Note
In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Examples
Example from Cisco IOS Release 12.3(17a)BC and Later Releases
Cisco IOS Release 12.3(17a)BC introduces revised output for the show cable modem phy command. The MicroReflec column (MicroReflections) has been removed, and the DOCSIS Prov (DOCSIS Provider) column has been added in its place. This new column contains DOCSIS version information.
Router# show cable modem phy
MAC Address I/F Sid USPwr USSNR Timing DSPwr DSSNR Mode DOCSIS
(dBmV) (dB) Offset (dBmV) (dB) Prov
0003.e350.9a3f C5/1/0/U0 1 0.00 30.23 2811 0.00 ----- tdma 1.0
0050.734e.c1a1 C5/1/0/U0 2 0.00 30.47 2811 0.00 ----- tdma 1.0
0007.0e01.1749 C5/1/0/U0 3 0.00 30.65 2808 0.00 ----- tdma 1.0
0007.0e00.90dd C5/1/0/U0 4 0.00 30.66 2806 0.00 ----- tdma 1.0
0003.e350.9ad3 C5/1/0/U0 5 0.00 30.47 2810 0.00 ----- tdma 1.0
0003.e38f.f4e5 C5/1/0/U0 6 0.00 30.36 2813 0.00 ----- tdma 1.0
0003.e350.9b97 C5/1/0/U0 7 0.00 30.44 2812 0.00 ----- tdma 1.0
0003.e350.9bed C5/1/0/U0 8 0.00 30.16 2814 0.00 ----- tdma 1.0
0003.e308.455d C5/1/0/U0 9 0.00 30.79 2811 0.00 ----- tdma 1.0
0003.6bd6.bfaf C5/1/0/U0 10 0.00 30.40 2813 0.00 ----- tdma 1.0
Examples from Cisco IOS Release 12.3(13a)BC and Earlier Releases
Router# show cable modem phy
MAC Address I/F Sid USPwr USSNR Timing MicroReflec DSPwr DSSNR Mode
(dBmV) (dB) Offset (dBc) (dBmV) (dB)
0008.0e06.7b14 C8/0/0/U0 1 0.00 30.36 1938 0 0.00 ----- tdma
0050.f112.5977 C8/0/0/U0 2 0.00 30.36 1695 0 0.00 ----- tdma
0090.837b.b0b9 C8/0/0/U0 3 0.00 30.64 1187 0 0.00 ----- tdma
0007.0e03.6e99 C8/0/0/U0 5 0.00 30.36 2747 0 0.00 ----- tdma
0007.0e04.5091 C8/0/0/U0 6 0.00 30.94 2746 0 0.00 ----- tdma
0006.5314.81d9 C8/0/0/U0 7 0.00 30.36 2745 0 0.00 ----- tdma
0003.6b1b.ee63 C8/0/0/U0 8 0.00 31.26 2745 0 0.00 ----- tdma
0030.eb15.84e7 C8/0/0/U0 12 0.00 30.36 1157 0 0.00 ----- tdma
The following example shows sample output for the show cable modem phy command for all CMs on the Cisco CMTS router:
Router# show cable modem phy
MAC Address I/F Sid USPwr USSNR Timing MicroReflec DSPwr DSSNR Mode
(dBmV) (dBmV) Offset (dBc) (dBmV) (dBmV)
0008.0e09.81f8 C3/0 1 50.00 28.40 1705 26 -3.4 36.02 tdma
0003.6b3c.1aa7 C3/0 2 0.00 28.27 3643 0 0.00 ----- tdma
0008.0e09.7fe2 C4/0 3 35.00 28.44 1760 27 12.00 35.03 tdma
The following example shows sample output for the show cable modem phy command for all CMs on a particular cable interface:
Router# show cable modem cable 3/0 phy
MAC Address I/F Sid USPwr USSNR Timing MicroReflec DSPwr DSSNR Mode
(dBmV) (dBmV) Offset (dBc) (dBmV) (dBmV)
0008.0e09.81f8 C3/0 1 50.00 28.40 1705 26 -3.4 36.02 tdma
0003.6b3c.1aa7 C3/0 2 0.00 28.27 3643 0 0.00 ----- tdma
The following example shows sample output for the show cable modem phy command for a particular CM:
Router# show cable modem 0050.7366.1243 phy
MAC Address I/F Sid USPwr USSNR Timing MicroReflec DSPwr DSSNR Mode
(dBmV) (dBmV) Offset (dBc) (dBmV) (dBmV)
0050.6736.4124 C3/0 14 38.00 24.58 1651 0 8.00 35.41 tdma
Example from Cisco IOS Release 12.2(33)SCD
The following example shows a sample output of the show cable modem phy command for all CMs on the Cisco CMTS router:
Router# show cable modem phy
MAC Address I/F Sid USPwr USMER Timing DSPwr DSMER Mode DOCSIS
(dBmV) (SNR) Offset (dBmV) (SNR) Prov
001c.ea37.9b5c C3/0/U2.0 27 0.00 36.12 5394 0.00 ----- tdma 1.1
001c.ea37.9b78 C3/0/U2.0 29 0.00 36.12 5396 0.00 ----- tdma 1.1
001c.ea37.9b5a C3/0/U3.0 31 0.00 36.12 5394 0.00 ----- tdma 1.1
001c.ea37.9ba4 C3/0/U2.0 32 0.00 36.12 5393 0.00 ----- tdma 1.1
001c.ea37.9aac C3/1/U2.1 28 0.00 36.12 5620 0.00 ----- tdma 1.1
001a.c3ff.d1a4 C3/1/U0.0 29 43.50 36.12 6020 0.00 ----- tdma* 1.1
001a.c3ff.d1a4 C3/1/U1.0 29 43.50 36.12 6020 0.00 ----- tdma* 1.1
001a.c3ff.d1a4 C3/1/U2.0 29 43.50 36.12 6019 0.00 ----- tdma* 1.1
001a.c3ff.d1a4 C3/1/U3.0 29 43.50 36.12 6021 0.00 ----- tdma* 1.1
Table 31 describes the fields shown in the show cable modem phy displays:
Table 31 Descriptions for the show cable modem phy Fields
Field
|
Description
|
MAC Address
|
The MAC address for the CM.
|
I/F
|
The cable interface on the CMTS that is providing services for this CM.
|
SID
|
Service ID that this CM is using.
|
USPwr (dBmV)
|
Displays the CM transmit level in dBmV, as measured by the CMTS.
|
USSNR (dBmV)
|
Upstream signal-to-noise ratio (SNR) or carrier-to-noise ratio (CNR), in dB, as measured by the CMTS. This field shows the CNR value for cable interfaces that support onboard hardware-based spectrum management, such as the Cisco uBR-MC16S card, and shows the SNR value for other cable interfaces.
Note Although the field name shows the value as being given in dBmV, the actual value should be interpreted in dB.
|
Timing Offset
|
The timing offset for the CM, in ticks, as recognized on the CMTS. (A tick, as used here, is 6.25/64 microseconds.) This is the delay between when a particular cable modem is scheduled to make a transmission and when the CMTS actually receives it.
Note An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command.
Note The timing offset shown here is typically smaller than the TX Time Offset value shown by the show cable modem remote-query command, because the latter value is the offset as recognized on the CM (which will include any internal delay between when the CM software begins the transmission and when the bits actually appear on the local cable interface).
|
Microreflec (dBc)
|
The approximate value of microreflections on the downstream, measured in dBc below the signal level, as seen by the CM. Microreflections are a type of impairment that is caused by impedance mismatches between amplifiers, couples, cables, and other equipment in the cable plant. Microreflections create copies of a signal that arrive at the receiver with different amounts of delay and attenuation, generating intersymbol interference (ISI) that can cause the receiver to improperly detect the amplitude and phase of the incoming signal.
Note This value is not exact but provides an approximate indication of the microreflections that have been received.
|
DSPwr (dBmV)
|
Downstream receive power level, in dBmV, as reported by the CM.
|
DSSNR (dBmV)
|
Downstream signal-to-noise ratio (SNR), in dB, as reported by the CM.
|
Note This command displays values for the downstream power and SNR values only if you have configured the cable modem remote-query command on the CMTS, and if the CM supports providing those options.
|
Mode
|
DOCSIS operating mode for the CM:
• tdma=DOCSIS 1.X, TDMA-only mode
• atdma=DOCSIS 2.0 A-TDMA mode
A hyphen (-) indicates the mode is unknown or the CM has not yet registered.
For DOCSIS 3.0-certified cable modems with multiple upstream channels, the output may contain multiple results for the same MAC address. In Cisco IOS Release 12.2(33)SCC, the asterix (*) that appears beside the DOCSIS operating mode under the Mode column identifies that the CM is operating in the MTC mode.
Note This field is the same as that returned by the docsIfCmtsCmStatusModulationType object in the DOCS-IF-MIB.
|
Related Commands
Command
|
Description
|
cable modem remote-query
|
Enables and configures the remote-query feature to gather CM performance statistics on the CMTS.
|
cable modem vendor
|
Associates the name of a vendor with its Organizational Unique Identifier (OUI).
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem cnr
|
Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.
|
show cable modem connectivity
|
Displays connectivity statistics for one or more CMs.
|
show cable modem cpe
|
Displays the CPE devices accessing the cable interface through a particular CM.
|
show cable modem errors
|
Displays error statistics for one or more CMs.
|
show cable modem flap
|
Displays flap list statistics for one or more cable modems.
|
show cable modem mac
|
Displays MAC layer information for one or more CMs.
|
show cable modem maintenance
|
Displays station maintenance (SM) error statistics for one or more cable modems.
|
show cable modem remote-query
|
Displays information collected by the remote-query feature.
|
show cable modem rf-adapt
|
Displays RF adaptation information for cable modems.
|
show interface cable modem
|
Displays information about the CMs connected to a particular cable interface.
|
show interface cable sid
|
Displays cable interface information.
|
show cable modem primary-channel
To display the primary-channel and host interface for all modems or for modems on a MAC domain host interface, use the show cable modem primary-channel command.
show cable modem [cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port
[logical-channel-index]]] primary-channel [non-bonding-capable [legacy-ranging]]
[wideband [registered-traditional-docsis]]
Syntax Description
slot
|
Slot where the line card resides. The valid range is from 5 to 8.
|
subslot
|
Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
|
port
|
Downstream port number. The valid range is from 0 to 4 (depending on the cable interface).
|
cable-interface-index
|
Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
• Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
upstream port
|
(Optional) Displays information for all CMs using this specific upstream. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports on the cable interface line card.
|
logical-channel-index
|
(Optional) Logical channel index. The valid values are 0 or 1.
|
non-bonding-capable
|
Displays the cable modems and primary downstreams of the cable modems that are not capable of bonding.
|
legacy-initial-ranging
|
Displays modems that access with legacy INIT-RNG-REQ.
|
wideband
|
Displays wideband online modems.
|
registered-traditional-docsis
|
Displays wideband cable modems registered in traditional pre-DOCSIS3.0 mode.
|
Command Default
No default behavior or values.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.3(23)BC
|
This command was introduced for the Cisco uBR10012 router.
|
12.2(33)SCE
|
This command was modified. The port parameter was changed to cable-interface-index.
|
12.2(33)SCF
|
This command was modified. The logical-channel-index argument was added.
|
Usage Guidelines
Use this command to display the primary downstream channel information of modems for different modem categories in terms of bonding capability, such as, non-bonding-capable modems accessed with legacy initial ranging or wideband cable modems registered via traditional DOCSIS.
Examples
The following show cable modem primary-channel non-bonding-capable command shows the individual cable modems displays and the primary downstream channel for each cable modem.
Router# show cable modem primary-channel non-bonding-capable
MAC Address IP Address Host MAC Prim Num Primary DS
Interface State Sid CPE Downstream RfId
000f.66f9.aa73 80.17.1.3 C6/0/0/U0 online(pt) 1 0 C6/0/0 255
0007.0e02.d7e9 80.17.1.7 C6/0/0/U0 online(pt) 5 0 Mo3/0/0:1 1
0013.10bb.22f9 80.17.1.2 C6/0/0/U0 online(pt) 2 0 Mo3/0/0:1 1
000f.66f9.b193 80.17.1.6 C6/0/0/U0 online(pt) 22 0 C6/0/0 255
0012.17ea.f3fb 80.17.1.4 C6/0/0/U0 online(pt) 23 0 C6/0/0 255
0013.10bb.23d1 80.17.1.5 C6/0/1/U1 online(pt) 5 0 C6/0/1 255
Related Commands
Command
|
Description
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem voice
|
Displays detected voice-enabled modems.
|
show cable service-voice downstream type
|
Shows the current enforced downstream type on the uBR10-MC5x20 line card.
|
show cable modem rf-adapt
|
Displays RF adaptation information for cable modems.
|
show cable modem primary-channel summary total
To display the number of cable modems grouped by primary downstream channels information under a Channel Grouping Domain (CGD), use the show cable modem primary-channel summary total command in privileged EXEC mode.
show cable modem primary-channel [cable slot/subslot/port] summary total
Syntax Description
slot
|
The slot used for the cable interface line card. Valid values are 5 to 8.
|
subslot
|
The subslot used for the cable interface line card. Valid values are 0 to 1.
|
port
|
The downstream port used as a MAC domain host interface port. Valid values are 0 to 4.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.3(23)BC
|
This command was introduced for the Cisco uBR10012 router.
|
Usage Guidelines
Use the show cable modem primary-channel summary total command to display the number of cable modems grouped by primary downstream channels. You can also use this command to display information for narrowband and wideband modems and group the information based on a SPA or a uBR10-MC 5x20 primary downstream. You can also display information on modems based on a specific cable MAC domain.
Examples
The following example shows attributes of the primary channels to which the various modems are hosted under the CGD domain c6/0/0.
Router#show cable modem primary-channel
MAC Address IP Address Host MAC Prim Num Primary DS
Interface State Sid CPE Downstream RfId
000f.66f9.aa73 80.17.1.2 C6/0/0/U0 online 13 0 C6/0/0 255
000f.66f9.b193 80.17.1.3 C6/0/0/U0 online 14 0 C6/0/0 255
0012.17ea.f3fb 80.17.1.5 C6/0/0/U0 online 15 0 C6/0/0 255
0019.474a.d4f8 80.17.1.13 C6/0/0/U0 online 16 0 C6/0/0 255
0000.cab7.7f1c 80.17.1.8 C6/0/0/U0 online 17 1 C6/0/0 255
0019.474a.d3d4 80.17.1.11 C6/0/0/U0 online 18 0 C6/0/0 255
0007.0e02.d7e9 80.17.1.10 C6/0/0/U0 online 19 0 C6/0/0 255
0019.474a.cd82 80.17.1.20 C6/0/0/U0 online 20 0 C6/0/0 255
0019.474a.d3fa 80.17.1.7 C6/0/0/U0 online 22 0 C6/0/0 255
0018.6852.82ea 80.17.1.6 C6/0/0/U0 online 24 0 C6/0/0 255
0013.10bb.23d1 80.17.1.12 C6/0/0/U0 online 23 1 Mo3/0/0:0 0
The following example shows modems grouped according to their capability, indicating whether they are wideband or narrowband modems. The command also displays the local of the primary downstreams of the modem, indicating whether the primary downstream is a SPA downstream (Remote) or a uBR10-MC 5x20 downstream (Local). The Wideband column indicates if the status of the modem is online or wideband-online.
Router#show cable modem primary-channel summary total
Total Reg Oper Unreg Offline Wideband initRC initD initIO initO 0-Blaze
Local Primary Narrowband:
C6/0/0 5 5 5 0 0 0 0 0 0 0 0
C6/0/1 0 0 0 0 0 0 0 0 0 0 0
Subtotal: 5 5 5 0 0 0 0 0 0 0 0
C6/0/0 5 5 5 0 0 0 0 0 0 0 0
C6/0/1 0 0 0 0 0 0 0 0 0 0 0
Subtotal: 5 5 5 0 0 0 0 0 0 0 0
Remote Primary Narrowband:
Mo3/0/0:0 1 1 1 0 0 0 0 0 0 0 0
Subtotal: 1 1 1 0 0 0 0 0 0 0 0
Subtotal: 0 0 0 0 0 0 0 0 0 0 0
Total: 11 11 11 0 0 0 0 0 0 0 0
The example below shows the modems grouped by primary downstream channels for the cable MAC domain c6/0/0.
Router#show cable modem primary-channel summary c6/0/0 total
Total Reg Oper Unreg Offline Wideband initRC initD initIO initO 0-Blaze
Local Primary Narrowband:
C6/0/0 5 5 5 0 0 0 0 0 0 0 0
C6/0/0 5 5 5 0 0 0 0 0 0 0 0
Remote Primary Narrowband:
Mo3/0/0:0 1 1 1 0 0 0 0 0 0 0 0
Subtotal: 1 1 1 0 0 0 0 0 0 0 0
Subtotal: 0 0 0 0 0 0 0 0 0 0 0
Total: 11 11 11 0 0 0 0 0 0 0 0
Related Commands
Command
|
Description
|
show cable modem
|
Displays information for the registered and unregistered cable modems.
|
show cable modem privacy
To display the privacy information for the registered and unregistered CMs, use the show cable modem privacy command in privileged EXEC mode.
Cisco uBR7200 Series Routers
show cable modem {ip-address | mac-address} privacy [verbose]
Cisco uBR10012 Router
show cable modem {ip-address | mac-address} privacy [verbose]
Syntax Description
ip-address
|
IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.
|
mac-address
|
MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.
|
privacy
|
Displays the privacy information for the CMs.
|
verbose
|
Displays detailed information for the CMs.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCC
|
This command was introduced.
|
Usage Guidelines
This command displays privacy information of a particular CM, identified by its IP address or MAC address.
Examples
The following sample output from the show cable modem privacy command shows the privacy information for a particular CM using a specified MAC address.
Router# show cable modem 0018.6835.2987 privacy
MAC Address : 0018.6835.2987
Remaining Lifetime : 294 sec
Certificate Serial : 57BF2DF60E9FFBECF8E69709DE34BC26
Certificate Self-Signed : False
Certificate State : Chained
CM Certificate Serial : 010244AF1A135202
CM Certificate State : Chained
KEK Reject Reason : No Information
KEK Invalid Reason : No Information
Primary SID Information :
Encryption Algorithm : 56-bit DES
Latest Sequence Number : 5
Remaining Lifetime : 144 sec
Current Sequence Number : 4
Remaining Lifetime : 54 sec
TEK Reject Reason : No Information
TEK Invalid Reason : No Information
Example of show cable modem privacy verbose Command Output for a Specified MAC Address
The following example shows sample output for the verbose option for a particular CM:
Router# show cable modem 0018.6835.2987 privacy verbose
MAC Address : 0018.6835.2987
Remaining Lifetime : 256 sec
Authorization Key : 2004065504831967119C16051FD722C5209E165F
Key Encryption Key : F14EFC15118B6B06
Upstream HMAC Key : 150E3F56451F6E033DEB79BCF819A9D8EAF6B95D
Downstream HMAC Key : 9AA3EC8869D64927560589692CCE4C21F3DA9029
Authorization Requests : 2
Authorization Replies : 2
Authorization Rejects : 0
Authorization Invalids : 0
Untrusted Manufacturer : 0
Untrusted CM Certificate : 0
Certificate Not Activated: 0
Certificate in Hotlist : 0
Invalid CM Certificate : 0
Certificate Serial : 57BF2DF60E9FFBECF8E69709DE34BC26
Certificate Self-Signed : False
Certificate State : Chained
CM Certificate Serial : 010244AF1A135202
CM Certificate State : Chained
KEK Reject Reason : No Information
KEK Invalid Reason : No Information
Primary SID Information :
Encryption Algorithm : 56-bit DES
Latest Sequence Number : 5
Remaining Lifetime : 106 sec
Hardware Keys Match : True
DES Key : 156819BF016E139B
DES IV : 07291CAE15AD0845
Current Sequence Number : 4
Remaining Lifetime : 16 sec
Hardware Keys Match : True
DES Key : 23EF1C9801F40EE3
DES IV : 163D19831AFB25DC
TEK Reject Reason : No Information
TEK Invalid Reason : No Information
Table 32 describes the major fields shown in the show cable modem privacy command display:
Table 32 show cable modem privacy Field Descriptions
Field
|
Description
|
MAC Address
|
MAC address for the CM.
|
Prim SID
|
Primary SID assigned to the CM.
|
BPI Mode
|
Baseline Privacy Interface (BPI) mode used.
|
BPI State
|
Displays the BPI state.
|
Security Capabilities
|
Security capabilities of the modem like encryption algorithm and Early Authentication and Encryption (EAE).
|
Encryption
|
Encryption method used.
|
EAE
|
EAE support.
|
Latest Key Sequence
|
Latest key sequence number.
|
Key Status
|
Status of the key; whether active or not.
|
Remaining Lifetime
|
Remaining lifetime of the key in seconds.
|
Key Gracetime
|
Grace time available for the key in seconds.
|
Authorization Key
|
Authorization key code.
|
Key Encryption Key
|
Key used to encrypt the traffic key.
|
Upstream HMAC Key
|
Upstream Hashed Message Authentication Code (HMAC) key.
|
Downstream HMAC Key
|
Downstream Hashed Message Authentication Code (HMAC) key.
|
Current Key Sequence
|
Current key sequence number.
|
Authorization Counters
|
Authorization counter information.
|
Authorization Infos
|
Authorization information.
|
Authorization Requests
|
Number of authorized requests.
|
Authorization Replies
|
Number of authorized replies.
|
Authorization Rejects
|
Rejected authorization.
|
Authorization Invalids
|
Invalid authorization.
|
Traffic Key Counters
|
Traffic key counter informayion.
|
Traffic Key Requests
|
Number of traffic key requests.
|
Traffic Key Replies
|
Number of traffic key replies.
|
Traffic Key Rejects
|
Number of traffic key rejects.
|
Traffic Key Invalids
|
Number of invalid traffic keys.
|
Certificate Counters
|
Certificate counter information.
|
Untrusted Manufacturer
|
Count of untrusted manufacturers.
|
Untrusted CM Certificate
|
Count of untrusted CM certificates.
|
Issuer Not Found
|
Count of certificate issuers not found in the database.
|
Invalid Signature
|
Count of invalid signatures.
|
Expired Certificate
|
Number of expired certificates.
|
Certificate Not Activated
|
Count of certificates not activated.
|
Certificate in Hotlist
|
Number of certificates in hotlist.
|
Public Key Mismatch
|
Number of public key mismatch.
|
Invalid MAC
|
Number of invalid MACs.
|
Invalid CM Certificate
|
Number of invalid CM certificates.
|
CA Certificate Details
|
CA certificate information.
|
Certificate Serial
|
CA certificate serial number.
|
Certificate Self-Signed
|
Self-signed CA certificate.
|
Certificate State
|
Current state of the CA certificate.
|
CM Certificate Details
|
CM certificate information.
|
CM Certificate Serial
|
CM certificate serial number.
|
CM Certificate State
|
Current state of the CM certificate.
|
KEK Reject Code
|
Key Encryption Key (KEK) reject code.
|
KEK Reject Reason
|
KEK reject reason.
|
KEK Invalid Code
|
KEK invalid code.
|
KEK Invalid Reason
|
Reason for the invalid KEK.
|
Primary SID Information
|
Primary SID assigned to this CM.
|
SID
|
SID used by the CM.
|
Encryption Algorithm
|
Encryption algorithm used.
|
Latest Sequence Number
|
Latest sequence number.
|
Current Sequence Number
|
Current sequence number.
|
Hardware Keys Match
|
Hardware key match.
|
DES Key
|
Data Encryption Standard (DES) key number.
|
DES IV
|
Initialization vector. This can be AES or DES.
|
TEK Requests
|
Displays the number of Traffic Exchange Key (TEK) requests.
|
TEK Replies
|
Number of TEK requests.
|
TEK Rejects
|
Number of TEK rejects.
|
TEK Invalids
|
Number of invalid TEKs.
|
TEK Receive Errors
|
Number of TEK receive errors.
|
TEK Reject Code
|
TEK reject code.
|
TEK Reject Reason
|
TEK reject reason.
|
TEK Invalid Code
|
TEK invalid code.
|
TEK Invalid Reason
|
TEK invalid reason.
|
Related Commands
Command
|
Description
|
cable privacy
|
Enables and configures BPI+ encryption on a cable interface.
|
cable privacy kek
|
Sets KEK and timeout periods.
|
cable privacy tek
|
Sets TEK and timeout periods.
|
show cable privacy
|
Displays information about BPI status and operation.
|
show cable modem qos
To display the quality of service (QoS) and service flow information for a particular cable modem (CM), use the show cable modem qos command in privileged EXEC mode.
show cable modem {ip-address | mac-address | name fqdn} qos [service-class | verbose]
Syntax Description
ip-address
|
IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.
|
mac-address
|
MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.
|
name fqdn
|
(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.
|
service-class
|
(Optional) Displays the service class names associated with each service flow for a specific cable modem.
|
verbose
|
(Optional) Displays detailed information for each service flow ID (SFID) for the CM.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
11.3XA
|
This command was introduced.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was added.
• The name keyword option was added for specifying the fully-qualified domain name of a CM.
|
12.2(33)SCC
|
The command output was modified to display the traffic peak rate value for a specific service flow.
|
12.2(33)SCF
|
This command was modified. The service-class keyword was added to display the service class names for each service flow for a specific cable modem.
|
Usage Guidelines
This command displays the service flows currently in use by a CM. The default form of the display shows one service flow per line, while the verbose form displays complete information for each flow.
Note
In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Examples
Example of the show cable modem qos Command for a Cable Modem Specified by MAC Address
The following example is a sample output of the show cable modem qos command for a specific CM identified by its MAC address:
Router# show cable modem 0010.7bb3.fcd1 qos
Sfid Dir Curr Sid Sched Prio MaxSusRate MaxBrst MinRsvRate Throughput
3 US act 1 BE 7 2000000 1522 100000 0
4 DS act N/A BE 0 4000000 1522 0 0
Example of the show cable modem qos Command for a Cable Modem Specified by IP Address
The following example is a sample output of the show cable modem qos command for a specific CM identified by its IP address:
Router# show cable modem 22.1.1.10 qos
Sfid Dir Curr Sid Sched Prio MaxSusRate MaxBrst MinRsvRate Throughput
7 US act 3 BE 0 0 3044 0 0
9 US act 4 BE 0 1000000 65224 0 0
10 US act 5 BE 0 1000000 65224 0 0
8 DS act N/A BE 0 0 3044 0 0
Example of the show cable modem qos verbose Command for a Cable Modem Specified by IP Address
The following example is a sample output for the verbose form of the show cable modem qos command for a specific CM identified by its IP address:
Router# show cable modem 22.1.1.10 qos verbose
Maximum Sustained rate : 0 bits/sec
Maximum Burst : 3044 bytes
Mimimum Reserved rate : 0 bits/sec
Minimum Packet Size : 64 bytes
Admitted QoS Timeout : 200 seconds
Active QoS Timeout : 0 seconds
Maximum Concatenated Burst : 1522 bytes
Scheduling Type : Best Effort
Request/Transmission policy : 0x0
IP ToS Overwrite[AND-mask, OR-mask] : 0xFF, 0x0
Current Throughput : 0 bits/sec, 0 packets/sec
Maximum Sustained rate : 1000000 bits/sec
Maximum Burst : 65224 bytes
Mimimum Reserved rate : 0 bits/sec
Minimum Packet Size : 64 bytes
Admitted QoS Timeout : 0 seconds
Active QoS Timeout : 0 seconds
Maximum Concatenated Burst : 1522 bytes
Scheduling Type : Best Effort
Request/Transmission policy : 0x0
IP ToS Overwrite[AND-mask, OR-mask] : 0xFF, 0x0
Current Throughput : 0 bits/sec, 0 packets/sec
Maximum Sustained rate : 1000000 bits/sec
Maximum Burst : 65224 bytes
Mimimum Reserved rate : 0 bits/sec
Minimum Packet Size : 64 bytes
Admitted QoS Timeout : 0 seconds
Active QoS Timeout : 0 seconds
Maximum Concatenated Burst : 1522 bytes
Scheduling Type : Best Effort
Request/Transmission policy : 0x0
IP ToS Overwrite[AND-mask, OR-mask] : 0xFF, 0x0
Current Throughput : 0 bits/sec, 0 packets/sec
Maximum Sustained rate : 0 bits/sec
Maximum Burst : 3044 bytes
Mimimum Reserved rate : 0 bits/sec
Minimum Packet Size : 64 bytes
Admitted QoS Timeout : 200 seconds
Active QoS Timeout : 0 seconds
Maximum Latency : 0 usecs
Current Throughput : 0 bits/sec, 0 packets/sec
The following example is a sample output for the verbose form of the show cable modem qos command indicating the traffic peak rate value for a specific service flow.
Router# show cable modem 22.1.1.10 qos verbose
Maximum Sustained rate : 20000000 bits/sec
Maximum Burst : 20000000 bytes
Minimum Reserved rate : 0 bits/sec
Minimum Packet Size : 0 bytes
Admitted QoS Timeout : 200 seconds
Active QoS Timeout : 0 seconds
Maximum Concatenated Burst : 65535 bytes
Scheduling Type : Best Effort
Request/Transmission policy : 0x0
IP ToS Overwrite[AND-mask, OR-mask] : 0xFF, 0x0
Peak Rate : 50000000 bits/sec
Current Throughput : 0 bits/sec, 0 packets/sec
Example of the show cable modem qos service-class Command for a Cable Modem in Cisco IOS Release 12.2(33)SCF
The following example is a sample output of the service-class option of the show cable modem qos command for a specific CM identified by its IP address:
Router# show cable modem 22.1.1.10 qos service-class
Sfid Dir Sched MaxSusRate MaxBrst MinRsvRate SrvClassName
33 US BE 0 3044 0 us_srvclass_ts1
35 US BE 0 3044 0 us_srvclass_ts2
34 DS BE 0 3044 0 ds_srvclass_ts1
36 DS BE 0 3044 0 ds_srvclass_ts2
Table 33 describes the major fields shown in the show cable modem qos displays:
Table 33 Descriptions for the show cable modem qos Fields
Field
|
Description
|
Sfid
|
Identifies the Service Flow ID (SFID) for this service flow.
|
Dir
|
Identifies whether the service flow applies to the downstream (DS) or upstream (US) direction.
|
Curr State
|
Current State—Identifies the current state of the service flow: Active or Inactive.
|
Sid
|
Identifies the Service ID (SID) associated with this SFID.
|
Sched Type
|
Identifies this service flow's scheduling type:
• BE—Best-Effort
• NRTPS—Non-Real-Time Polling Service
• RTPS—Real-Time Polling Service
• RSVD—Reserved but not yet in use
• UGS_AD—Unsolicited Grant Service with Activity Detection
• UGS—Unsolicited Grant Service
• UNDEF—Not yet defined.
|
Prio
|
Traffic priority (0 to 7) given to this service flow.
|
MaxSusRate
|
Maximum sustained rate value, in bits per second.
|
MaxBrst
|
Maximum burst value, in bytes.
|
MinRsvRate
|
Minimum reserved rate, in bits per second.
|
Throughput
|
Current Throughput for this service flow, in packets per second.
|
SrvClassName
|
Service class name associated with this service flow.
|
Minimum Packet Size
|
Assumed minimum reserved rate packet size on this service flow, in bytes.
|
Admitted QoS Timeout
|
Timeout for admitted QoS parameters, in seconds, which specifies the length of time that the CMTS must reserve resources for a service flow's admitted Qos parameter set, when they exceed the resources allowed by the active QoS parameter set.
|
Active QoS Timeout
|
Timeout for active Qos parameters, in seconds, which specifies the maximum amount of time that resources can remained unused on an active service flow.
|
Maximum Latency
|
Maximum downstream latency allowed for packets using this service flow, in microseconds.
|
Related Commands
Command
|
Description
|
cable qos permission
|
Specifies permission for updating the cable router QoS table.
|
cable qos profile
|
Configures a QoS profiles.
|
cable service-flow inactivity-timeout
|
Sets the amount of time a dynamic service-flow can be present in the system without any activity.
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem access-group
|
Displays the access groups for the CMs on a particular cable interface.
|
show cable modem calls
|
Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.
|
show cable modem classifiers
|
Displays information about the classifiers for a particular CM.
|
show cable modem connectivity
|
Displays connectivity statistics for one or more CMs.
|
show cable modem registered
|
Displays a list of the CMs that are marked as registered with the Cisco CMTS router.
|
show cable modem remote-query
|
Displays information collected by the remote-query feature.
|
show cable modem unregistered
|
Displays a list of the CMs that are marked as unregistered with the Cisco CMTS router.
|
show cable modulation-profile
|
Displays modulation profile group information.
|
show interface cable modem
|
Displays information about the CMs connected to a particular cable interface.
|
show interface cable qos paramset
|
Displays the DOCSIS 1.1 QoS parameter sets.
|
show interface cable sid
|
Displays cable interface information.
|
show cable qos profile
|
Displays quality-of-service (QoS) profiles for a Cisco CMTS router.
|
show cable modem registered
To display a list of the cable modems (CMs) that have registered with the Cisco CMTS, use the show cable modem registered command in privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] registered
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn]
registered
Syntax Description
ip-address
|
(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.
|
mac-address
|
(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.
|
slot
|
Slot where the line card resides.
• Cisco uBR7225VXR router—The valid value is 1 or 2.
• Cisco uBR7246VXR router—The valid range is from 3 to 6.
• Cisco uBR10012 router—The valid range is from 5 to 8.
|
subslot
|
(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
|
port
|
Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.
• Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).
|
cable-interface-index
|
Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.
• Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
upstream port
|
(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.
|
logical-channel-index
|
(Optional) Displays the logical channel index. Valid values are 0 and 1.
|
name fqdn
|
(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.
|
registered
|
Displays a list of the cable modems that have registered with the Cisco CMTS.
|
Defaults
Displays a list of all registered CMs on the Cisco CMTS router.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
11.3 NA
|
This command was introduced.
|
12.2(4)BC1
|
Support for the Cisco uBR10012 router was introduced.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was added.
• The name keyword option was added for specifying the fully-qualified domain name of a CM.
• The alignment of output fields has been changed.
|
12.2(33)SCE
|
This command was modified. The port parameter was changed to cable-interface-index.
|
12.2(33)SCF
|
This command was modified. The logical-channel-index argument was added.
|
Usage Guidelines
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Note
In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.
Examples
Example in Cisco IOS Release 12.2(33)SCA
The following example shows sample output for the default form of the show cable modem registered command in Cisco IOS Release 12.2(33)SCA:
Router# show cable modem registered
Interface Prim Online Timing Rec QoS CPE IP address MAC address
C3/0/U0 1 online(pt) 2024 0.00 5 0 10.74.1.60 0000.cadb.0bae
C3/0/U0 2 online(pt) 2032 0.00 5 0 10.74.1.58 0000.cadb.0512
C3/0/U0 3 online(pt) 2024 0.50 5 0 10.74.1.61 0000.cadb.04b2
C3/0/U0 4 online(pt) 3079 0.00 5 0 10.74.1.48 0003.e3a6.7f71
C3/0/U0 5 online(pt) 2558 -1.00 5 0 10.74.1.50 0010.7b6b.77ed
C3/0/U0 6 online(pt) 3083 -0.50 5 0 10.74.1.42 0030.80bc.22b9
Examples in Cisco IOS Release 12.3BC
The following example shows sample output for the default form of the show cable modem registered command.
Router# show cable modem registered
Interface Prim Online Timing Rec QoS CPE IP address MAC address
Cable3/0/U0 1 online 2812 -0.25 5 1 10.18.1.5 0030.80bc.2303
Cable3/0/U0 2 online 2804 0.50 5 0 10.18.1.9 0006.2854.73f5
The following example shows sample output for the show cable modem registered command for a particular cable interface:
Router# show cable modem c8/1/0 registered
Interface Prim Online Timing Rec QoS CPE IP address MAC address
C8/1/0/U1 1 online 1548 0.00 5 0 10.1.1.11 0050.7366.1243
C8/1/0/U4 2 online 1925 0.00 5 0 10.1.1.10 0002.b970.0027
C8/1/0/U4 3 online 1918 -0.50 2 0 10.1.1.10 0006.5314.858d
The following example shows sample output for the show cable modem registered command for a single CM, as identified by its IP address:
Router# show cable modem 22.1.1.10 registered
Interface Prim Online Timing Rec QoS CPE IP address MAC address
C8/1/0/U4 3 online 1918 -0.75 2 0 10.1.1.10 0006.5314.858d
The following example shows sample output for the show cable modem registered command for a single CM, as identified by its MAC address:
Router# show cable modem 0006.5314.858d registered
Interface Prim Online Timing Rec QoS CPE IP address MAC address
C8/1/0/U4 3 online 1918 -0.25 2 0 10.1.1.10 0006.5314.858d
Note
An asterisk (*) in the Receive Power column indicates that a power adjustment has been made for that CM. An exclamation point (!) in the Receive Power column indicates that the CM has reached its maximum power transmit level and cannot increase its power level further. An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command.
A pound sign (#) in the MAC State column indicates that the cable tftp-enforce mark-only command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so (Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases).

Tip
The show cable modem command displays the CM timing offset in DOCSIS ticks, while other commands, such as cable map-advance, display the offset in microseconds. Use the following method to convert microseconds to DOCSIS ticks: ticks = microseconds*64/6.25.
Table 34 describes the major fields shown in the show cable modem registered displays:
Table 34 Descriptions for the show cable modem registered Fields
Field
|
Description
|
Interface
|
The cable interface line card providing the upstream for this CM.
|
Prim SID
|
The primary SID assigned to this CM.
|
Online State
|
The current state of the MAC layer. Should show "online" for registered CMs.
|
Timing Offset
|
The timing offset for the CM, in ticks, as recognized on the CMTS. (A tick, as used here, is 6.25/64 microseconds.) This is the delay between when a particular cable modem is scheduled to make a transmission and when the CMTS actually receives it.
Note An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command.
Note The timing offset shown here is typically smaller than the TX Time Offset value shown by the show cable modem remote-query command, because the latter value is the offset as recognized on the CM (which will include any internal delay between when the CM software begins the transmission and when the bits actually appear on the local cable interface).
|
Rec Power
|
The received power level (in dB) for the CM.
Note An asterisk (*) in the RxPwr column indicates that a power adjustment has been made for that CM. An exclamation point (!) indicates that the CM has reached its maximum power transmit level and cannot increase its power level further.
|
QoS
|
Displays the QoS profile assigned to the CM (DOCSIS 1.1 and DOCSIS 2.0 CMs only).
|
CPE
|
Indicates the number of CPE devices for which the CM is providing services.
|
IP Address
|
The IP address that the DHCP server has assigned to the CM.
|
MAC Address
|
The MAC address for the CM.
|
Related Commands
Command
|
Description
|
cable modem vendor
|
Associates the name of a vendor with its Organizational Unique Identifier (OUI).
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem access-group
|
Displays the access groups for the CMs on a particular cable interface.
|
show cable modem calls
|
Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.
|
show cable modem classifiers
|
Displays information about the classifiers for a particular CM.
|
show cable modem connectivity
|
Displays connectivity statistics for one or more CMs.
|
show cable modem cpe
|
Displays the CPE devices accessing the cable interface through a particular CM.
|
show cable modem offline
|
Displays a list of the CMs that are marked as offline with the Cisco CMTS.
|
show cable modem rf-adapt
|
Displays RF adaptation information for cable modems.
|
show cable modem unregistered
|
Displays a list of the CMs that are marked as unregistered with the Cisco CMTS.
|
show cable modem vendor
|
Displays the vendor name or Organizational Unique Identifier (OUI) for the CMs on each cable interface.
|
show interface cable modem
|
Displays information about the CMs connected to a particular cable interface.
|
show interface cable sid
|
Displays cable interface information.
|
show cable modem remote-query
To display information collected by the remote-query feature, use the show cable modem remote-query command in privileged EXEC mode.
show cable modem remote-query
Syntax Description
This command has no keywords or arguments.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.0(7)XR, 12.1(2)T
|
This command was introduced.
|
12.1(2)EC1
|
Support for this command was added to the 12.1 EC train.
|
12.2(4)BC1b
|
Support for this command was added to the 12.2 BC train.
|
12.3(23)BC
|
Support was added for displaying status of modems during an SNMP request.
|
Usage Guidelines
This command shows the statistics collected when the remote-query feature has been enabled and configured by the cable modem remote-query command.
Note
In Cisco IOS Release 12.1 CX, Cisco IOS Release 12.2 BC, and later, use the show cable modem phy command instead of the show cable modem remote-query command.
Tip
The information shown by this command can also be displayed by querying the attributes in the CISCO-DOCS-REMOTE-QUERY-MIB.
Note
Also see the information about this command's behavior in a Hot Standby Connection-to-Connection Protocol (HCCP) configuration, see the "Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration" section.
Examples
The following example shows typical output from the show cable modem remote-query command. In this example, the final CM (IP address of 10.200.71.2) has not been configured with an SNMP community string that allows access to the remote-query feature.
Router# show cable modem remote-query
Remote Query Polling State : Active
IP address MAC address S/N US DS Tx Time Micro (dB) Modem
Ratio Power Power Offset Reflection State
10.200.71.8 0001.9659.47af 36.6 31.0 0.0 12352 17 online
10.200.71.4 0001.9659.47c7 36.6 37.0 0.0 12352 17 online
10.200.71.6 0001.9611.b9a3 36.6 37.0 0.0 12353 15 online
10.200.71.3 0001.9659.47a9 36.6 37.0 0.0 12351 16 online
10.200.71.2 0001.9659.47c1 0.0 0.0 0.0 0 0 online
In the following example, the SNMP Request column shows cable modems being offline when an SNMP request using the cable modem remote query command is not received. The modems are either offline or are not responding to the SNMP request.
Router# show cable modem remote-query
Remote Query Polling State : Inactive
IP address MAC address S/N US DS Tx Time SNMP
Ratio Power Power Offset Request
80.51.1.4 0018.f826.3453 0.0 0.0 0.0 0 CM offline
80.51.1.2 000c.e5f6.0c40 0.0 0.0 0.0 0 CM offline
80.51.1.8 0019.474a.d4fe 0.0 0.0 0.0 0 CM offline
80.51.1.3 0018.6852.82fa 0.0 0.0 0.0 0 CM offline
80.51.1.5 0019.474a.c1ae 0.0 0.0 0.0 0 CM offline
Table 0-35 shows the fields displayed by the show cable modem remote-query command.
Table 0-35 Descriptions for the show cable modem remote-query Fields
Field
|
Description
|
IP Address
|
The IP address that the DHCP server has assigned to the CM.
|
MAC Address
|
The MAC address for the CM.
|
S/N Ratio
|
The current signal-to-noise ratio (SNR) on the downstream, as seen by the CM.
|
US Power
|
The current operational transmit power level, in dBmV, as seen by the CM.
|
DS Power
|
The received power level, in dBmV, as seen by the CM. This field is set to zero if the CM does not support power level measurements.
|
TX Time Offset
|
The timing offset for the CM, in ticks, as recognized on the CM. (A tick, as used here, is 6.25/64 microseconds.) This is the delay between when a particular cable modem is scheduled to make a transmission and when the CMTS actually receives it. The CM value includes any internal delay between when the CM software begins the transmission and when the bits actually appear on the local cable interface.
Note The timing offset shown here is typically larger than the Time Offset value shown by the show cable modem command, because the latter value is the offset as recognized on the CMTS (which does not include the internal delay on the CM).
|
Micro (dB) Reflection
|
The approximate number of total microreflections (including in-channel responses) on the downstream, measured in dBc below the signal level, as seen by the CM. Microreflections are a type of impairment that is caused by impedance mismatches between amplifiers, couples, cables, and other equipment in the cable plant. Microreflections create copies of a signal that arrive at the receiver with different amounts of delay and attenuation, generating intersymbol interference (ISI) that can cause the receiver to improperly detect the amplitude and phase of the incoming signal.
Note This value is not exact but provides an approximate indication of the microreflections that have been received.
|
Modem State
|
The current state of the MAC layer for the CM (see Table 23).
|
The following example shows typical output from the show cable modem remote-query command.
Router# show cable modem remote-query
IP address MAC address S/N US DS Tx Time Micro (dB) Modem
Ratio Power Power Offset Reflection State
10.118.4.194 0007.0e04.5ba9 33.4 42.3 - 1.0 8794 1 online
10.118.4.156 0003.6b1b.e8c9 34.0 44.0 - 1.0 8795 3 online(d)
The following example shows typical output from the show cable modem remote-query command when the remote-query feature has not been configured.
Router# show cable modem remote-query
Remote Query Polling State : Inactive
IP address MAC address S/N US DS Tx Time Micro (dB) Modem
Ratio Power Power Offset Reflection State
10.200.71.8 0001.9659.47af 0.0 0.0 0.0 0 0 online
10.200.71.4 0001.9659.47c7 0.0 0.0 0.0 0 0 online
10.200.71.6 0001.9611.b9a3 0.0 0.0 0.0 0 0 online
10.200.71.3 0001.9659.47a9 0.0 0.0 0.0 0 0 online
10.200.71.2 0001.9659.47c1 0.0 0.0 0.0 0 0 online
10.200.71.10 00d0.5904.5321 0.0 0.0 0.0 0 0 offline
10.200.71.11 0050.f112.5123 0.0 0.0 0.0 0 0 offline
Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Related Commands
Command
|
Description
|
cable modem remote-query
|
Enables and configures the remote-query feature to gather CM performance statistics on the CMTS.
|
debug cable remote-query
|
Turns on debugging to gather information from remote CMs.
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem cnr
|
Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.
|
snmp-server enable traps cable
|
Enables traps that are sent when the remote polling of CMs has been completed.
|
show cable modem rf-adapt
To display RF adaptation relocation history for cable modems, use the show cable modem rf-adapt command in privileged EXEC mode.
show cable modem [mac-address | cable {slot/cable-interface-index |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] ] rf-adapt
[verbose]
Syntax Description
mac-address
|
(Optional) MAC address of a specific cable modem to be displayed. If you specify the MAC address for a CPE device behind a cable modem, information for that cable modem is displayed.
|
slot
|
Slot where the line card resides.
• Cisco uBR7225VXR router—The valid value is 1 or 2.
• Cisco uBR7246VXR router—The valid range is from 3 to 6.
• Cisco uBR10012 router—The valid range is from 5 to 8.
|
subslot
|
(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
|
cable-interface-index
|
Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.
• Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
upstream port
|
(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.
|
logical-channel-index
|
(Optional) Logical channel index. The valid values are 0 or 1.
|
rf-adapt
|
Displays RF adaptation information.
|
verbose
|
Displays detailed information for the cable modems.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCF
|
This command was introduced.
|
Examples
The following is a sample output of the show cable modem rf-adapt command:
Router# show cable modem rf-adapt
MAC Address Downgrade Upgrade Primary Last Last Action
Count Count Upstream Action Time
0019.474a.d4cc 1 0 C8/0/1/U3.0 D Jun 25 22:10:22
0019.474a.d554 1 1 C8/0/14/U0.0 U Jun 25 22:10:22
0019.474a.d542 2 1 C8/0/0/U0.0 D Jun 25 22:10:22
0019.474a.d508 1 1 C8/0/8/U0.0 U Jun 25 22:10:23
0025.2e2d.7400 1 0 C8/0/0/U1.0 D Jun 25 22:10:23
0022.cea4.f404 1 1 C8/0/2/U2.0 U Jun 25 22:10:23
Router# show cable modem 001e.6bfb.2d3c rf-adapt
MAC Address Downgrade Upgrade Primary Last Last Action
Count Count Upstream Action Time
001e.6bfb.2d3c 1 0 Ca6/1/0/U0.0 D Mar 7 05:12:37
Router# show cable modem 0025.2e2d.7990 rf-adapt verbose
Action Action Source Destination Action
Time Type Upstream Upstream Reason
Mar 9 23:03:08 D Ca7/0/0/U0.0 Ca7/0/0/U0.1 SNR 26<28
Mar 9 21:50:05 U Ca7/0/0/U0.1 Ca7/0/0/U0.0 SNR 31>=31
Mar 9 21:37:02 D Ca7/0/0/U0.0 Ca7/0/0/U0.1 SNR 26<28
Mar 9 20:45:59 U Ca7/0/0/U0.1 Ca7/0/0/U0.0 SNR 32>=31
Mar 9 20:36:56 D Ca7/0/0/U0.0 Ca7/0/0/U0.1 SNR 27<28
Table 5 describes the significant fields shown in the display:
Table 36 show cable modem Field Descriptions
Field
|
Description
|
MAC Address
|
MAC address of the cable modem.
|
Downgrade Count
|
Number of times the cable modem was relocated from the primary to the secondary logical upstream channel.
|
Upgrade Count
|
Number of times the cable modem was relocated from the secondary to the primary logical upstream channel.
|
Primary Upstream
|
The primary logical upstream at the time of the relocation event.
|
Last Action
|
Last action performed on the cable modem; indicates whether the cable modem was downgraded or upgraded.
|
Last Action Time
|
Date and time when the last action was performed on the cable modem.
|
Action Time
|
Date and time when the action was performed on the cable modem.
|
Action Type
|
Upgrade or downgrade.
|
Source Upstream
|
Upstream logical channel from where the cable modem is moved.
|
Destination Upstream
|
Upstream logical channel to where the cable modem is moved.
|
Action Reason
|
Reason for the relocation of the cable modem.
|
Related Commands
Command
|
Description
|
cable rf-adapt timer
|
Configures timers for RF adaptation.
|
cable upstream rf-adapt
|
Enables RF adaptation on the physical upstream channel.
|
cable upstream rf-adapt (logical channel)
|
Configures the primary upstream logical channel and secondary upstream logical channel.
|
cable upstream threshold
|
Configures the upstream for the signal-to-noise ratio (SNR) and forward error correction (FEC) threshold values to be used in determining the allowable noise levels.
|
cable upstream threshold hysteresis
|
Configures the hysteresis value to be used in conjunction with the dynamic modulation upgrade thresholds.
|
cable upstream threshold rf-adapt
|
Configures the upstream RF adaptation threshold value, which prevents excessive relocation of modems from the primary upstream channel to the secondary upstream channel.
|
show cable modem
|
Displays information for the registered and unregistered cable modems.
|
show cable modem phy
|
Displays the DOCSIS PHY layer information for one or more cable modems.
|
show cable modulation-profile
|
Displays modulation profile group information.
|
show cable rf-adapt
|
Displays the downgrade and upgrade candidate lists.
|
show interface cable modem
|
Displays information about the cable modems connected to a particular cable interface.
|
show cable modem rogue
To display a list of cable modems that have been marked, locked, or rejected because they failed the dynamic shared-secret authentication checks, use the show cable modem rogue command in privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] rogue
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn]
rogue
Syntax Description
ip-address
|
(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.
|
mac-address
|
(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.
|
slot
|
Slot where the line card resides.
• Cisco uBR7225VXR router—The valid value is 1 or 2.
• Cisco uBR7246VXR router—The valid range is from 3 to 6.
• Cisco uBR10012 router—The valid range is from 5 to 8.
|
subslot
|
(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
|
port
|
Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.
• Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).
|
cable-interface-index
|
Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.
• Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
upstream port
|
(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.
|
logical-channel-index
|
(Optional) Logical channel index. The valid values are 0 or 1.
|
name fqdn
|
(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.
|
rogue
|
Displays a list of cable modems that have been marked, locked, or rejected.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(15)BC1
|
This command was introduced for Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 routers.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was added.
• The name keyword option was added for specifying the fully-qualified domain name of a CM.
|
12.2(33)SCE
|
This command was modified. The port parameter was changed to cable-interface-index.
|
12.2(33)SCF
|
This command was modified. The logical-channel-index argument was added.
|
Usage Guidelines
This command displays a list of cable modems that attempted to register with a DOCSIS configuration file that does not pass the authentication required by the cable dynamic-secret command. After a cable modem is added to the rogue list, it remains in the rogue list until one of the following occurs:
•
The cable modem remains offline, without attempting to reregister, for 24 hours. It is then removed from all of the CMTS internal databases, including the rogue list.
•
An administrator manually deletes the cable modem from the CMTS internal databases, using the clear cable modem delete command.
•
An administrator unlocks the cable modem using the clear cable modem lock command.
Note
In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Examples
The following sample output from the show cable modem rogue command.
Router# show cable modem rogue
MAC Address Vendor Interface Count Dnld Dynamic Secret
AAAA.7b43.aa7f Vendor1 C4/0/U5 2 Yes 45494DC933F8F47A398F69EE6361B017
AAAA.7b43.aa7f Vendor1 C4/0/U5 2 Yes D47BCBB5494E9936D51CB0EB66EF0B0A
BBBB.7b43.aa7f Vendor2 C4/0/U5 2 No 8EB196423170B26684BF6730C099D271
AAAA.7b43.aa7f Vendor1 C4/0/U5 2 No DF8FE30203010001A326302430120603
BBBB.7b43.aa7f Vendor2 C4/0/U5 2 No 300E0603551D0F0101FF040403020106
AAAA.7b43.aa7f Vendor1 C4/0/U5 2 Yes 820101002D1A264CE212A1BB6C1728B3
DDDD.7b43.aa7f Vendor4 C4/0/U5 2 Yes 7935B694DCA90BC624AC92A519C214B9
AAAA.7b43.aa7f Vendor1 C4/0/U5 2 No 3AB096D00D56ECD07D9B7AB662451CFF
Table 0-37 describes the fields shown by the show cable modem rogue command.
Table 0-37 show cable modem Field Descriptions
Field
|
Description
|
MAC Address
|
The MAC address for the CM.
|
Vendor
|
Vendor name for this cable modem, as configured using the cable modem vendor command.
|
Interface
|
The cable interface line card providing the upstream for this CM.
|
Spoof Count
|
Number of times that this cable modem has attempted to register with an invalid dynamic shared-secret value.
Note To account for possible network problems, such as loss of packets and congestion, the Cisco CMTS will allow a cable modem to attempt to register twice before marking it as having failed the dynamic shared-secret authentication checks.
|
TFTP Dnld
|
Whether TFT downloads are enforced, as configured by the cable tftp-enforce command.
|
Dynamic Secret
|
The dynamic shared-secret for this cable modem.
|
Related Commands
Command
|
Description
|
cable dynamic-secret
|
Enables the Dynamic Shared Secret feature, so that DOCSIS configuration files are verified with a Message Integrity Check (MIC) that has been created with a dynamically generated shared secret.
|
cable modem vendor
|
Associates the name of a vendor with its Organizational Unique Identifier (OUI).
|
cable shared-secondary-secret
|
Configures one or more secondary shared secret keys that CMs can use to successfully process the DOCSIS configuration file and register with the CMTS.
|
cable shared-secret
|
Configures an authentication shared secret key that CMs must use to successfully process the DOCSIS configuration file and register with the CMTS.
|
cable tftp-enforce
|
Requires that all CMs on a cable interface attempt to download a DOCSIS configuration file using the Trivial File Transfer Protocol (TFTP) through the cable interface before being allowed to register and come online.
|
clear cable modem lock
|
Resets the lock on one or more CMs, and reinitializes them, so that they can reregister with a valid DOCSIS configuration file.
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem rf-adapt
|
Displays RF adaptation information for cable modems.
|
show interface cable modem
|
Displays information about the CMs connected to a particular cable interface.
|
show interface cable sid
|
Displays the SID information for a CM.
|
show cable modem service-type-id
To display the modems having the service type id, use the show cable modem service-type-id command in privileged EXEC mode.
show cable modem service-type-id [service-type-id]
Syntax Description
service-type-id
|
Specifies the name of the service type identifier.
|
Command Default
If no service type identifier is specified, this command will show all the CMs with their respective service-type-id.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCB
|
This command was introduced.
|
Usage Guidelines
This command shows CMs having specified service-type-id.
Examples
The following example shows sample output for the show cable modem service-type-id command:
Router# show cable modem service-type-id
MAC Address IP Address I/F MAC Prim Service-type-id P I
0018.6812.29ae 41.42.2.212 C6/1/4/U2 offline 3838 commercial N N
0018.6811.f9f8 41.42.0.140 C6/1/4/U2 offline 3225 commercial N N
0018.6811.fba6 41.42.5.169 C6/1/4/U2 offline 3439 commercial N N
0018.6812.225a 41.42.3.210 C6/1/4/U2 offline 3355 commercial N N
0018.6811.fa8c 41.42.1.133 C6/1/4/U2 offline 3091 commercial N N
0018.6812.37e8 41.42.0.136 C6/1/4/U2 offline 7439 commercial N N
0018.6811.fbca 41.42.2.255 C6/1/4/U2 offline 6263 commercial N N
0018.6811.fb44 41.42.2.17 C6/1/4/U2 offline 2996 commercial N N
0018.6812.2f20 41.42.0.100 C6/1/4/U2 offline 3544 commercial N N
Table 38 describes the significant fields shown in the display.
Table 38 show cable modem service-type-id Field Descriptions
Field
|
Description
|
MAC Address
|
Hardware (MAC-layer) address of the cable modem or CPE device.
|
IP Address
|
IP address of the cable modem or CPE device.
|
I/F
|
The cable interface line card providing the upstream for this CM.
|
MAC State
|
The current state of the MAC layer.
|
Prim Sid
|
Primary Service ID (SID) of the device.
|
Service Type Id
|
Service Type identifier.
|
BPI
|
Indicates whether or not Baseline Privacy Interface (BPI) or BPI Plus (BPI+) encryption is enabled for the CM.
|
DIP
|
Dual IP flag. Identifies whether or not ("Y" or "N") the CM or CPE supports both IPv4 and IPv6 addressing.
|
Related Commands
Command
|
Description
|
clear cable modem service-type-id
|
This command clears the cable modem service type id.
|
show cable modem service-flow
To display information about all service flows associated with a particular modem, use the show cable modem service-flow command in privileged EXEC mode.
show cable modem {ip-address | mac-address} service-flow [verbose | ds-hardware]
Syntax Description
ip-address
|
Specifies the IPv4 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.
|
mac-address
|
Identifies the MAC address of a specific CM to be displayed. You can also specify the MAC address for a CPE device behind a CM, and information for that CM will be displayed.
|
service-flow
|
Displays summary of relevant parameters and statistics for all service flows associated with a particular modem.
|
verbose
|
(Optional) Displays comprehensive details for all service flows associated with a particular modem.
|
ds-hardware
|
(Optional) Displays details of Baseline Privacy Interface (BPI), Payload Header Suppression (PHS), Downstream Service Identifier (DSID) and other statistical data.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCB1
|
This command was introduced for Cisco uBR7200 series and Cisco uBR10012 routers in Cisco IOS Release 12.2(33)SCB1.
|
12.3(23)BC7
|
This command was integrated into Cisco IOS Release 12.3(23)BC7.
|
12.2(33)SCE
|
This command was modified. The ds-hardware keyword was added.
|
12.2(33)SCF2
|
This command was modified. The command output was enhanced to display upstream buffer control parameters.
|
Usage Guidelines
The show cable modem service-flow command has a verbose and a non-verbose option. The non-verbose command supports live debugging and provides a summary of relevant parameters and statistics for all service flows of a particular modem. The verbose option of the command provides comprehensive details for all service flows associated with a particular modem.
The optional ds-hardware keyword is used to display per service flow BPI, PHS, DSID and stats data obtained directly from the hardware on the line card or SPA.
Note
The output data for unconfigured or non applicable features are not always displayed.
Examples
The following is a sample output of the show cable modem service-flow command without the verbose option:
Router# show cable modem 40.30.0.5 service-flow
MAC Address IP Address Host MAC Prim Num Primary DS
Interface State Sid CPE Downstream RfId
001a.c30c.7eec 40.30.0.5 C7/0/0/U0 online 15 0 C7/0/0 Local
Sfid Dir Curr Sid Sched Prio MaxSusRate MaxBrst MinRsvRate Throughput
31 US act 15 BE 0 0 3044 0 0
32 DS act N/A BE 0 0 3044 0 0
UPSTREAM SERVICE FLOW DETAIL:
SFID SID Requests Polls Grants Delayed Dropped Packets
DOWNSTREAM SERVICE FLOW DETAIL:
SFID RP_SFID QID Flg Policer Scheduler FrwdIF
32 32817 131124 0 0 0 0 Ca7/0/0
$: Low Latency Queue (aggregated)
The following is a sample output of the show cable modem service-flow command with the verbose
option, for Cisco IOS Release 12.2(33)SCF2:
Router# show cable modem 0022.cea5.02ba service-flow verbose
MAC Address IP Address Host MAC Prim Num Primary
Interface State Sid CPE Downstrea
0022.cea5.02ba 5.60.122.132 C7/1/0/UB w-online 10 0 In7/1/0:0
Sfid Dir Curr Sid Sched Prio MaxSusRate MaxBrst MinRsvRate Throughp
29 US act 10 BE 0 100000 3044 0 0
30 DS act N/A BE 0 200000 3044 0 0
CfrId SFID CM Mac Address Direction State Priority Matches
UPSTREAM SERVICE FLOW DETAIL:
Mac Address : 0022.cea5.02ba
Current QoS Indexes [Prov, Adm, Act] : [3, 4, 4]
Required Attributes : 0x00000000
Forbidden Attributes : 0x00000000
Aggregate Attributes : 0x00000000
Service Class Name : REG-US
Maximum Sustained rate : 100000 bits/sec
Maximum Burst : 3044 bytes
Minimum Reserved Rate : 0 bits/sec
Minimum Packet Size : 0 bytes
!Upstream Buffer Control Parameters
Minimum Buffer Size : 1000 bytes
Target Buffer Size : 1500 bytes
Maximum Buffer Size : 2000 bytes
Admitted QoS Timeout : 200 seconds
Active QoS Timeout : 0 seconds
Rate Limit Delayed Grants : 0
Rate Limit Dropped Grants : 0
Current Throughput : 0 bits/sec, 0 packets/sec
Upstream Bonding Group : UBG-1
Transmit Channel Set : 0x6
Sid Cluster : SC-0, Sid [ 10 10 ]
SID Cluster Switching Information
Total Bytes Requested : 0
BWReqs {Cont,Pigg,RPoll,Other} : 4, 0, 0, 0
No grant buf BW request drops : 0, where:0
Rate exceeded BW request drops : 0
rate-adapt {rcvd, Consec-PB} : 0, 0
Fragment reassembly completed : 0
Fragment reassembly incomplete : 0
Concatenated packets received : 0
Queue-indicator bit statistics : 0 set, 0 granted
Corrected Codewords rx : 0
Uncorrectable Codewords rx : 0
Concatenated headers received : 0
Fragmentation headers received : 0
Fragmentation headers discarded: 0
ARP Requests Received : 2
Examples of show cable modem service-flow ds-hardware Command Output for Various Types of Modems
The following is a sample output of the show cable modem service-flow ds-hardware command on the narrow band modem on a legacy interface:
Router# show cable modem 50.3.112.12 service-flow ds-hardware
LC SFID:15 RP SFID: 32999
Even Key: 15DC474264C81500 Even Iv: 2619043723FB046B
Odd Key: 07A89421B4458B00 Odd Iv: 1FB0253D0D1C1643
PHSM: 0000-0000-0000-0000
Ctrl: 0x0 PHSI: 0x0 PHSS: 0x0 Count: 0x0
The following is a sample output of the show cable modem service-flow ds-hardware command on the narrow band modem with a modena remote primary channel:
Router# show cable modem 50.3.112.6 service-flow ds-hardware
LC SFID:7 RP SFID: 33007 StatIndex: 13
KeyNum: 0x7 Control: 0xC001 KeySeq: 0x1
Even Key: 10F4-6BE1-D944-B0 Even Iv: 04B3-1CCD-25DA-163E
Odd Key: 0818-8A00-9D01-1E Odd Iv: 1C58-1967-16BC-0BD0
PHSM: 0000-0000-0000-0000
Ctrl: 0x0 PHSI: 0x0 PHSS: 0x0 Count: 0x0
The following is a sample output of the show cable modem service-flow ds-hardware command on the wideband modem on a remote modena:
Router# show cable modem 50.3.112.28 service-flow ds-hardware
LC SFID:9 RP SFID: 33001 StatIndex: 7
TX Pkts: 13 TX Bytes: 962
DSID: 0x11E Priority: 0x0 SCC: 0 Seqnum: 0xD
KeyNum: 0x4 Control: 0xC002 KeySeq: 0x1
Even Key: 01B8-5830-9246-66 Even Iv: 0BAB-1CA8-0145-1AB9
Odd Key: 0720-8C81-FD04-6F Odd Iv: 0D80-13F1-0E32-083B
PHSM: 0000-0000-0000-0000
Ctrl: 0x0 PHSI: 0x0 PHSS: 0x0 Count: 0x0
The following is a sample output of the show cable modem service-flow ds-hardware command on the narrowband modem on an integrated interface:
Router# show cable modem 80.36.0.3 service-flow ds-hardware
LC SFID:50 RP SFID: 33150 StatIndex: 21
KeyNum: 0x3 Said: 0x16 KeySeq:0x1
Even Key: 0A3C-5BC0-C9C0-9F Even Iv: 0204-25F7-07A1-026E
Odd Key: 0448-0392-26C4-55 Odd Iv: 087F-0B13-237A-1F89
PHSM: 0000-0000-0000-0000
Ctrl: 0x0 PHSI: 0x0 PHSS: 0x0 Count: 0x0
The following is a sample output of the show cable modem service-flow ds-hardware command on the wideband modem on a bonded local interface:
Router# show cable modem 80.36.0.122 service-flow ds-hardware
LC SFID:46 RP SFID: 33148 StatIndex: 19
TX Pkts: 200 TX Bytes: 23600
DSID: 0x152 Priority: 0x0 Seqnum: 0xC8
Enabled: 0x1 DPV Enabled: 0x0 SeqNum Change Cnt: 0x0
KeyNum: 0x3 Said: 0x14 KeySeq:0x1
Even Key: 08E0-8C51-8AC2-A5 Even Iv: 0EA2-1FA8-1C32-2685
Odd Key: 12F4-3980-C984-53 Odd Iv: 0DA1-0BA2-0E4F-0864
PHSM: 0000-0000-0000-0000
Ctrl: 0x0 PHSI: 0x0 PHSS: 0x0 Count: 0x0
Table 1 describes the significant fields shown in the output.
Table 39 show cable mode service-flow Field Descriptions
Field
|
Description
|
MAC Address
|
Hardware (MAC-layer) address of the cable modem or CPE device.
|
IP Address
|
IP address of the cable modem or CPE device.
|
Host Interface
|
Host interface name.
|
MAC State
|
Current state of the MAC layer.
|
Prim Sid
|
Primary SID assigned to this CM.
|
Num CPE
|
Number of CPE devices for which the CM is providing services.
|
Primary Downstream
|
Primary downstream channel assigned to the CM.
|
DS RfId
|
Downstream RF identifier.
|
SFID
|
Service flow identifier.
|
SID
|
Service ID (SID) of the device.
|
Requests
|
Number of requests.
|
Polls
|
Number of polls.
|
Grants
|
Number of grants.
|
Delayed Grants
|
Number of delayed grants.
|
Dropped Grants
|
Number of dropped grants.
|
Packets
|
Number of packets.
|
RP_SFID
|
Route processor SFID.
|
QID
|
Link queue identification number.
|
Flg
|
Indicates whether the queue is low latency or CIR.
|
Policer Xmits
|
Packets transmitted out of the policer.
|
Drops
|
Packets dropped by the policer.
|
Scheduler Xmits
|
Packets transmitted out of the scheduler.
|
Drops
|
Packets dropped by the scheduler.
|
FrwdIF
|
Forwarding interface.
|
LC SFID
|
Line card SFID.
|
KeyIndex
|
Per flow index to BPI data.
|
PHSIndex
|
Per flow index to PHS data.
|
TX Pkts
|
Number of packets the router has transmitted on this service flow.
|
TX Bytes
|
Number of bytes the router has transmitted on this service flow.
|
BPI
|
Indicates whether or not Baseline Privacy Interface (BPI) encryption is enabled for the CM.
|
Said
|
Security association identifier.
|
KeySeq
|
Downstream traffic key sequence number.
|
Even Key
|
Even traffic encryption key (TEK) value.
|
Even Iv
|
Value of the even Initialization Vector (IV).
|
Odd Key
|
Odd TEK key value.
|
Odd Iv
|
Odd IV value.
|
PHS
|
Payload header suppression.
|
PHSM
|
PHS Mask. 5-bit PHS mask that defines the header bytes that should be suppressed.
|
Ctrl
|
Control block.
|
PHSI
|
PHS Index. Number that uniquely references the PHS rule.
|
PHSS
|
PHS Size. 8-bit value specifying the number of header bytes to be suppressed.
|
Count
|
PHS rule usage count.
|
Related Commands
Command
|
Description
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem access-group
|
Displays the access groups for the CMs on a particular cable interface.
|
show cable modem calls
|
Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.
|
show cable modem classifiers
|
Displays information about the classifiers for a particular CM.
|
show cable modem cnr
|
Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.
|
show cable modem connectivity
|
Displays connectivity statistics for one or more CMs.
|
show cable modem counters
|
Displays downstream and upstream traffic counters for one or more CMs.
|
show cable modem cpe
|
Displays the CPE devices accessing the cable interface through a particular CM.
|
show cable modem domain-name
|
Updates the cable-specific DNS cache and display the domain name for specified CMs and CPE behind a CM on a Cisco CMTS router.
|
show cable modem errors
|
Displays error statistics for one or more CMs.
|
show cable modem flap
|
Displays flap list statistics for one or more CMs.
|
show cable modem ipv6
|
Displays IPv6 information for specified CMs and CPE behind a CM on a Cisco CMTS router.
|
show cable modem mac
|
Displays MAC layer information for one or more CMs.
|
show cable modem maintenance
|
Displays station maintenance (SM) error statistics for one or more CMs.
|
show cable modem offline
|
Displays a list of the CMs that are marked as offline with the Cisco CMTS.
|
show cable modem phy
|
Displays the DOCSIS PHY layer information for one or more CMs.
|
show cable modem qos
|
Displays quality of service (QoS) and service flow information for a particular CM.
|
show cable modem registered
|
Displays a list of the CMs that are marked as registered with the Cisco CMTS.
|
show cable modem remote-query
|
Displays information collected by the remote-query feature.
|
show cable modem summary
To display a summary of CMs on one or more cable interfaces, use the show cable modem summary command in privileged EXEC mode.
show cable modem summary [total]
show cable modem summary interface1 [interface2] total
show cable modem summary interface1 [interface2] upstream port1 port2 total
show cable modem cable {slot/port | slot/cable-interface-index} [upstream port
[logical-channel-index]] summary
show cable modem cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port
[logical-channel-index]] summary
Syntax Description
total
|
(Optional) Displays a footer line showing the totals for each column.
|
interface1
|
(Optional) Cable interface to be summarized. The interface1 parameter can take the following forms:
• cable {slot/port | slot/cable-interface-index}
• cable {slot/subslot/port | slot/subslot/cable-interface-index}
where,
• slot—Slot where the line card resides.
– Cisco uBR7225VXR router—The valid value is 1 or 2.
– Cisco uBR7246VXR router—The valid range is from 3 to 6.
– Cisco uBR10012 router—The valid range is from 5 to 8.
• subslot—(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
• port—Downstream port number.
– Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.
– Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).
• cable-interface-index—Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
– Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.
– Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
interface2
|
(Optional) Second cable interface, specifying a range of cable interfaces to be summarized. The interface2 parameter has the same form as interface1.
Note When specifying a range of cable interfaces, interface1 must be the lower-numbered interface and interface2 must be the higher-numbered interface.
|
upstream port1 port2
|
(Optional) Specifies a range of upstream ports on the cable interfaces to be summarized. The port1 and port2 parameters can start at 0, and port2 must be a higher-numbered port than port1.
|
upstream port
|
(Optional) Specifies a specific upstream port to be summarized. This option can be specified only when summarizing a single cable interface.
|
logical-channel-index
|
(Optional) Logical channel index. The valid values are 0 or 1.
|
summary
|
Displays a summary of CMs on one or more cable interfaces.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
11.3XA
|
This command was introduced.
|
12.1(4)CX and 12.2(4)BC1
|
Support was added for the Cisco uBR10012 router.
|
12.1(6)EC
|
The total option was supported for the Cisco uBR7100 series and Cisco uBR7200 series routers.
|
12.1(11b)EC
|
The upstream Description field was added to the show cable modem summary display in Cisco IOS Release 12.1 EC.
|
12.2(8)BC1
|
The total option was supported for the Cisco uBR10012 universal broadband router.
|
12.2(15)BC2
|
The upstream Description field was added to the show cable modem summary display in Cisco IOS Release 12.2 BC.
|
12.3(21)BC
|
Support was added for wideband cable modem output.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.
|
12.2(33)SCE
|
This command was modified. The port parameter was changed to cable-interface-index.
|
12.2(33)SCF
|
This command was modified. The logical-channel-index argument was added.
|
Usage Guidelines
This command displays a summary of CMs for a single cable interface or upstream, or for a range of cable interfaces or upstreams. The following possible combinations are possible for this command:
•
show cable modem summary total—Displays a summary and a total for all CMs on the chassis.
•
show cable modem summary cable x/0 total—Displays a summary of CMs on a specified card.
•
show cable modem summary cable x/0 upstream port1 port2 total—Displays a summary of CMs on the specified card and specified range of ports. The port1 value must be less than the port2 value.
•
show cable modem summary cable x/0 cable y/0 total—Displays a summary of CMs on the specified range of cards.
•
show cable modem summary cable x/0 cable y/0 upstream port1 port2 total—Displays a summary of CMs on the specified range of ports on the specified range of cards.
Note
Also see the information about this command's behavior in a Hot Standby Connection-to-Connection Protocol (HCCP) configuration, see the "Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration" in the Cisco Broadband Cable Command Reference Guide.
Examples
The following example shows typical output for the default form of the show cable modem summary command on a Cisco uBR7200 series router:
Router# show cable modem summary
Interface Total Active Registered Description
Cable3/0/U0 165 141 141 Line 32/1
Cable3/0/U1 209 172 170 Line 32/2
Cable3/0/U2 262 207 203 Line 32/3
Cable3/0/U3 256 194 188 Line 32/4
Cable5/0/U0 746 714 711 Line 41/1
Cable6/0/U0 806 764 759 Line 42/2
Note
The Description field appears in Cisco IOS Release 12.1(11b)EC, 12.2(15)BC2, and later releases, and shows the string configured for the upstream using the cable upstream description command.
The following example shows typical output for the show cable modem summary command with the total option on a Cisco uBR7200 series router:
Router# show cable modem summary total
Interface Total Active Registered Description
Cable5/0/U0 746 714 711 Node1
Cable6/0/U1 806 764 759 Node3
The following example shows sample output for the show cable modem summary command with the total option for a Cisco uBR10012 router:
Router# show cable modem summary total
Interface Cable Modem Description
Total Reg Unreg Offline Wideband initRC initD initIO initO
C5/0/0/U0 84 84 0 0 84 0 0 0 0
C5/0/0/U1 84 84 0 0 84 0 0 0 0
C5/0/0/U2 83 83 0 0 83 0 0 0 0
C5/0/0/U3 83 83 0 0 83 0 0 0 0
Total: 8020 8020 0 0 8016 0 0 0 0
The following example shows sample output for the show cable modem summary total command for a range of interfaces on the Cisco uBR10012 router:
Router# show cable modem summary c5/1/1 c5/1/2 total
Interface Cable Modem Description
Total Reg Unreg Offline Wideband initRC initD initIO initO
C5/1/1/U0 84 84 0 0 84 0 0 0 0
C5/1/1/U1 84 84 0 0 83 0 0 0 0
C5/1/1/U2 83 83 0 0 83 0 0 0 0
C5/1/1/U3 83 83 0 0 83 0 0 0 0
C5/1/2/U0 84 84 0 0 84 0 0 0 0
C5/1/2/U1 84 84 0 0 84 0 0 0 0
C5/1/2/U2 83 83 0 0 83 0 0 0 0
C5/1/2/U3 83 83 0 0 83 0 0 0 0
Total: 668 668 0 0 667 0 0 0 0
The following example shows sample output for the show cable modem summary total command for a range of interfaces and upstreams on the Cisco uBR10012 router:
Router# show cable modem summary c5/1/1 c5/1/2 upstream 0 1 total
Interface Cable Modem Description
Total Reg Unreg Offline Wideband initRC initD initIO initO
C5/1/1/U0 84 84 0 0 84 0 0 0 0
C5/1/1/U1 84 84 0 0 83 0 0 0 0
C5/1/2/U0 84 84 0 0 84 0 0 0 0
C5/1/2/U1 84 84 0 0 84 0 0 0 0
Total: 336 336 0 0 335 0 0 0 0
Note
When displaying a summary for a range of ports or cable interfaces, the first port or cable interface (for example, u0 or c4/0) must be lower-numbered than the second port or interface (for example, u6 or c6/0). If you specify the higher-numbered port or interface first, the display shows no CMs connected.
Table 0-40 describes the fields shown in the show cable modem summary displays:
Table 0-40 Descriptions for the show cable modem summary Fields
Field
|
Description
|
Interface
|
The cable interface line card providing the upstream for the CMs.
|
Total Modems or Total
|
Total number of CMs, registered, unregistered, and offline for this interface.
|
Registered Modems or Reg
|
Total number of CMs that have registered and are online on this interface. This number might be different from the Total Modems number if some modems are offline or not fully registered.
|
Unregistered Modems
|
Total number of CMs that are either offline and not currently communicating with the CMTS, or attempting to come online but are not yet registered.
|
Offline
|
Total number of CMs that were online or attempted to register but are no longer communicating with the CMTS.
|
Wideband
|
CM is registered as a wideband CM.
|
init(rc)
|
MAC state of CM is init(rc).
|
init(d)
|
MAC state of CM is init(d).
|
init(io)
|
MAC state of CM is init(io).
|
init(o)
|
MAC state of CM is init(o).
|
Description
|
Description entered for this upstream using the cable upstream description command.
|

Note
For information on MAC states, see the show cable modem command.
Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Related Commands
Command
|
Description
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem access-group
|
Displays the access groups for the CMs on a particular cable interface.
|
show cable modem calls
|
Displays voice call information for a particular CM, identified either by its IP address or MAC address.
|
show cable modem connectivity
|
Displays connectivity statistics for one or more CMs.
|
show cable modem counters
|
Displays downstream and upstream traffic counters for one or more CMs.
|
show cable modem cpe
|
Displays the CPE devices accessing the cable interface through a particular CM.
|
show cable modem offline
|
Displays a list of the CMs that are marked as offline with the Cisco CMTS.
|
show cable modem registered
|
Displays a list of the CMs that are marked as registered with the Cisco CMTS.
|
show cable modem remote-query
|
Displays information collected by the remote-query feature.
|
show cable modem rf-adapt
|
Displays RF adaptation information for cable modems.
|
show cable modem unregistered
|
Displays a list of the CMs that are marked as unregistered with the Cisco CMTS.
|
show cable modem vendor
|
Displays the vendor name or Organizational Unique Identifier (OUI) for the CMs on each cable interface.
|
show interface cable modem
|
Displays information about the CMs connected to a particular cable interface.
|
show interface cable sid
|
Displays cable interface information.
|
show cable modem wideband
|
Displays information for a wideband CMs.
|
show cable modem summary wb-rf
To display the number of RF channels that are down on a cable interface, use the show cable modem summary wb-rf command in privileged EXEC mode.
show cable modem [cable slot/subslot/port] summary wb-rf [modular-cable
slot/bay/port:nb-channel-number]
Syntax Description
cable slot/subslot/port
|
(Optional) Specifies the cable interface. The following are the valid values:
• slot—Specifies the chassis slot number of the cable interface line card. Valid values are 5to 8.
• subslot—Specifies the secondary slot number of the cable interface line card. Valid subslots are 0 or 1.
• port—Specifies the port number. Valid values are 0 to 4 (depending on the cable interface).
|
modular-cable slot/bay/port:nb-channel-number
|
(Optional) Specifies the modular cable interface. The following are the valid values:
• slot—The slot where a SIP resides. On the Cisco uBR10012 router, slots 1 and 3 can be used for SIPs.
• bay—The bay in a SIP where a SPA is located. Valid values are 0 (upper bay) and 1 (lower bay).
• port—Specifies the interface number on the SPA.
• nb-channel-number—Specifies the narrowband channel number.
|
Command Default
No default behavior or values.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCB
|
This command was introduced.
|
Examples
The following is a sample output of the show cable modem summary wb-rf command on the cable interface at slot/subslot/port 8/0/0:
Router# show cable modem cable 8/0/0 summary wb-rfs
RF w-online RF down RF down
-------- -------- ------- -------
The following is a sample output of the show cable modem summary wb-rf command on the modular cable interface at slot/bay/port and narrowband channel 1/0/0 18:
Router# show cable modem c8/0/0 summary wb-rfs modular-cable 1/0/0 18
RF w-online RF down RF down
-------- -------- ------- -------
Related Commands
Command
|
Description
|
show cable modem summary
|
Displays a summary of CMs on one or more cable interfaces.
|
show cable modem type
To display cable modem (CM) provisioning information for all CMs, such as boot mode configuration and MAC and IP address information, use the show cable modem type command in privileged EXEC configuration mode.
Cisco uBR7246VXR Router and Cisco uBR7225VXR Router
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] type
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn] type
Syntax Description
ip-address
|
(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.
|
mac-address
|
(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.
|
slot
|
Slot where the line card resides.
• Cisco uBR7225VXR router—The valid value is 1 or 2.
• Cisco uBR7246VXR router—The valid range is from 3 to 6.
• Cisco uBR10012 router—The valid range is from 5 to 8.
|
subslot
|
(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
|
port
|
Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.
• Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).
|
cable-interface-index
|
Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.
• Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
logical-channel-index
|
(Optional) Logical channel index. The valid values are 0 or 1.
|
name fqdn
|
(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCA
|
This command was introduced.
|
12.2(33)SCE
|
This command was modified. The port parameter was changed to cable-interface-index.
|
12.2(33)SCF
|
This command was modified. The logical-channel-index argument was added.
|
Usage Guidelines
In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.
Examples
The following example shows sample output for the show cable modem type command :
Router# show cable modem type
P - Primary Boot mode (IPv6 or IPv4)
A - Alternative Provisioning Mode (Yes/No)
MAC Address Interface P/D/A IPv4 address IPv6 Address
0004.27a5.b761 C6/0/2/U1 v6/N/N 10.7.0.161 ---
0007.0e01.d9a1 C6/0/2/U0 v6/N/N 10.7.0.162 ---
0006.2854.7275 C6/0/2/U1 v6/Y/N 10.7.0.3 2001:ODB8:3800:80B:7565:5B87:1D7D:5AD5
0018.6835.27dd C6/0/U0 v6/N/N --- 2001:0DB8:3800:803:41D7:DECC:F15D:133
Table 41 describes the significant fields shown in the display.
Table 41 show cable modem type Field Descriptions
Field
|
Description
|
MAC Address
|
MAC address of this CM.
|
Interface
|
Cable line card interface and upstream associated with this CM.
|
P/D/A
|
String of 3 values representing the boot mode configuration of the CM as follows:
• P—Primary Boot Mode, where "v4" or "v6" indicates IPv4 or IPv6 as the primary addressing mode.
• D—Dual Stack, where "Y" or "N" indicates whether or not both IPv4 and IPv6 addressing modes are supported.
• A—Alternative Provisioning Mode (APM), where "Y" or "N" indicates whether or not APM is supported.
Note APM is not supported by the Cisco CMTS routers in Cisco IOS Release 12.2(33)SCA.
|
IPv4 address
|
IPv4 address acquired by the CM. Prior to acquisition of the IP address, or if the CM fails IPv4 registration, the following output is shown:
• IPv4 address not yet acquired—"0.0.0.0"
• CM fails IPv4 registration, but online with IPv6 address: "---"
• IPv4 address of an IPv6-only CM: "---"
|
IPv6 Address
|
IPv6 address acquired by the CM. Prior to acquisition of the IP address, or if the CM fails IPv6 registration, the following output is shown:
• IPv6 address not yet acquired—"::"
• CM fails IPv6 registration, but online with IPv4 address "---"
• IPv6 address of IPv4-only CM: "---"
|
Related Commands
Command
|
Description
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem rf-adapt
|
Displays RF adaptation information for cable modems.
|
show cable modem unregistered
To display a list of the cable modems (CMs) that are marked as unregistered with the Cisco CMTS, use the show cable modem unregistered command in privileged EXEC mode.
Cisco uBR7100 Series and Cisco uBR7200 Series Routers
show cable modem [ip-address | mac-address | cable {slot/port | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] unregistered
Cisco uBR10012 Router
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]] | name fqdn]
unregistered
Syntax Description
ip-address
|
(Optional) IPv4 or IPv6 address of a specific CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.
|
mac-address
|
(Optional) MAC address of a specific CM to be displayed. If you specify the MAC address for a CPE device behind a CM, information for that CM is displayed.
|
slot
|
Slot where the line card resides.
• Cisco uBR7225VXR router—The valid value is 1 or 2.
• Cisco uBR7246VXR router—The valid range is from 3 to 6.
• Cisco uBR10012 router—The valid range is from 5 to 8.
|
subslot
|
(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
|
port
|
Downstream port number.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid value is 0 or 1.
• Cisco uBR10012 router—The valid range is from 0 to 4 (depending on the cable interface).
|
cable-interface-index
|
Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.
• Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
upstream port
|
(Optional) Displays information for all CMs using the specified upstream port. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports supported by the cable interface line card.
|
logical-channel-index
|
(Optional) Logical channel index. The valid values are 0 or 1.
|
name fqdn
|
(Optional) Specifies the fully qualified domain name (FQDN) of the cable device to be displayed. This option is only available if the show cable modem domain-name command has been run for the first time to update the cable DNS cache on the CMTS router.
|
Defaults
Displays a list of all unregistered CMs on the Cisco CMTS router.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
11.3 NA
|
This command was introduced.
|
12.2(4)BC1
|
This command was introduced on the Cisco uBR10012 router.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA, with the following changes:
• Support for the Cisco uBR7225VXR router was added.
• Support for specifying the IPv6 address of a CM or CPE device was added.
• The name keyword option was added for specifying the fully-qualified domain name of a CM.
• The following new initialization states were added to show initialization of CMs and CPEs supporting IPv6:
– init6(s)—CMTS router has seen SOLICIT message.
– init6(a)—CMTS router has seen ADVERTISE message.
– init6(r)—CMTS router has seen REQUEST message.
– init6(i)—CMTS router has seen REPLY message.
– init6(o)—CMTS router has seen version 6 TFTP request.
– init6(t)—CMTS router has seen version 6 TOD request.
|
12.2(33)SCE
|
This command was modified. The port parameter was changed to cable-interface-index.
|
12.2(33)SCF
|
This command was modified. The logical-channel-index argument was added.
|
Usage Guidelines
Operation with Hot Standby Connection-to-Connection Protocol (HCCP) Configuration
If you are using Hot Standby Connection-to-Connection Protocol (HCCP) 1+1 or 1:n (N+1) redundancy, the new primary processor after a switchover automatically creates a new database of the online cable modems. This means that the show cable modem ip-address command might not show a particular cable modem until the CMTS receives IP traffic from that cable modem. You can force IP traffic by using the ping ip-address command, and then the show cable modem ip-address command will show the cable modem. You can also display any particular cable modem by using the show cable modem | include ip-address command.
In addition, when HCCP redundancy has been configured, the Cisco IOS software automatically synchronizes the secondary, backup cards whenever the configuration is changed. The cards can also be synchronized manually, using the hccp resync command. When a SYNC event command is occurring, CLI commands might be very slow to respond. In particular, if you enter the show cable modem command at the same time a SYNC event is occurring, the command might respond produce a blank display, or it might display an error message similar to the following:
%No response from slot 6/1. Command aborted
If this occurs, wait a minute or so and retry the command.
Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Note
In Cisco IOS Release 12.2(33)SCA, the show cable modem domain-name command must be run first on the route processor (RP) of the CMTS router before any domain name can be used as part of a cable command.
Examples
The following example shows sample output for the default form of the show cable modem unregistered command.
Router# show cable modem unregistered
Interface Prim Online Timing Rec QoS CPE IP address MAC address
Cable3/0/U0 1 online 2812 -0.25 5 1 3.18.1.5 0030.80bc.2303
Cable3/0/U0 2 online 2804 0.50 5 0 3.18.1.9 0006.2854.73f5
C6/0/U0 6 init6(i) 1532 -0.50 2 0 0.0.0.0 0018.6835.27dd
The following example shows sample output for the show cable modem unregistered command for a particular cable interface:
Router# show cable modem c8/1/0 unregistered
Interface Prim Online Timing Rec QoS CPE IP address MAC address
C8/1/0/U1 1 online 1548 0.00 5 0 22.1.1.11 0050.7366.1243
C8/1/0/U4 2 online 1925 0.00 5 0 23.1.1.10 0002.b970.0027
C8/1/0/U4 3 online 1918 -0.50 2 0 22.1.1.10 0006.5314.858d
The following example shows sample output for the show cable modem unregistered command for a single CM, as identified by its IP address:
Router# show cable modem 22.1.1.10 unregistered
Interface Prim Online Timing Rec QoS CPE IP address MAC address
C8/1/0/U4 3 online 1918 -0.75 2 0 22.1.1.10 0006.5314.858d
The following example shows sample output for the show cable modem unregistered command for a single CM, as identified by its MAC address:
Router# show cable modem 0006.5314.858d unregistered
Interface Prim Online Timing Rec QoS CPE IP address MAC address
C8/1/0/U4 3 online 1918 -0.25 2 0 22.1.1.10 0006.5314.858d
Note
An asterisk (*) in the Receive Power column indicates that a power adjustment has been made for that CM. An exclamation point (!) in the Receive Power column indicates that the CM has reached its maximum power transmit level and cannot increase its power level further. An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command.
A pound sign (#) in the MAC State column indicates that the cable tftp-enforce mark-only command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so (Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases).

Tip
The show cable modem command displays the CM timing offset in DOCSIS ticks, while other commands, such as cable map-advance, display the offset in microseconds. Use the following method to convert microseconds to DOCSIS ticks: ticks = microseconds*64/6.25.
Table 42 describes the major fields shown in the show cable modem unregistered displays:
Table 42 Descriptions for the show cable modem unregistered Fields
Field
|
Description
|
Interface
|
The cable interface line card providing the upstream for this CM.
|
Prim SID
|
The primary SID assigned to this CM.
|
Online State
|
The current state of the MAC layer (see Table 23).
|
Timing Offset
|
The timing offset for the CM, in ticks, as recognized on the CMTS. (A tick, as used here, is 6.25/64 microseconds.) This is the delay between when a particular cable modem is scheduled to make a transmission and when the CMTS actually receives it.
Note An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command.
Note The timing offset shown here is typically smaller than the TX Time Offset value shown by the show cable modem remote-query command, because the latter value is the offset as recognized on the CM (which will include any internal delay between when the CM software begins the transmission and when the bits actually appear on the local cable interface).
|
Rec Power
|
The received power level (in dB) for the CM.
Note An asterisk (*) in the RxPwr column indicates that a power adjustment has been made for that CM. An exclamation point (!) indicates that the CM has reached its maximum power transmit level and cannot increase its power level further.
|
QoS
|
Displays the QoS profile assigned to the CM (DOCSIS 1.1 and DOCSIS 2.0 CMs only).
|
CPE
|
Indicates the number of CPE devices for which the CM is providing services.
|
IP Address
|
The IP address that the DHCP server has assigned to the CM.
|
MAC Address
|
The MAC address for the CM.
|
Table 23 shows the possible values for the Online State field:
Table 43 Descriptions for the Online State Field 1
MAC State Value
|
Description
|
Registration and Provisioning Status Conditions for Devices Using IPv4 Addressing
|
init(r1)
|
The CM sent initial ranging.
|
init(r2)
|
The CM is ranging. The CMTS received initial ranging from the Cm and has sent RF power, timing offset, and frequency adjustments to the CM.
|
init(rc)
|
Ranging has completed.
Note If a CM appears to be stuck in this state, it could be that the CM is able to communicate successfully on the cable network, but that the upstream is at capacity and does not have any additional bandwidth to allow the CM to finish registration and come online. Either manually move one or more CMs to other upstreams, or enable load balancing on the upstream using the cable load-balance group commands.
|
init(d)
|
The DHCP request was received, as DHCPDISCOVER. This also indicates that the first IP broadcast packet has been received from the CM.
|
init(dr)
|
The DHCP request has been sent to the cable modem.
|
init(i)
|
The cable modem has received the DHCPOFFER reply (DHCPACK) from the DHCP server that has assigned an IP address to the modem, but the modem has not yet replied with a DHCPREQUEST message requesting that particular IP address, nor has it sent an IP packet with that IP address.
Note If a CM appears to be stuck in this state, the CM has likely received the DHCPOFFER reply from the DHCP server, but this reply might have contained one or more invalid options for that particular CM.
|
init(io)
|
The Cisco CMTS has seen the DHCP offer as sent to the cable modem from the DHCP server that has assigned an IP address to the modem.
|
init(o)
|
The CM has begun to download the option file (DOCSIS configuration file) using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP response. If the CM remains in this state, it indicates that the download has failed.
|
init(t)
|
Time-of-day (TOD) exchange has started.
|
resetting
|
The CM is being reset and will shortly restart the registration process.
|
| |
init6(s)
|
The Cisco CMTS router has seen the DHCPv6 SOLICIT message from the CM.
|
init6(a)
|
The Cisco CMTS router has seen the ADVERTISE message from the DHCPv6 server to the CM.
|
init6(r)
|
The Cisco CMTS router has seen the REQUEST response from the CM to the DHCPv6 server.
|
init6(i)
|
The Cisco CMTS router has seen the REPLY message from the DHCPv6 server to the CM.
|
init6(o)
|
The Cisco CMTS router has seen the REQEST message from the CM to the TFTP server.
|
init6(t)
|
The Cisco CMTS router has seen the REQUEST message from the CM to the TOD server.
|
Non-error Status Conditions
|
cc(r1)
|
The CM had registered and was online, but has received a Downstream Channel Change (DCC) or Upstream Channel Change (UCC) request message from the CMTS. The CM has begun moving to the new channel, and the CMTS has received the CM's initial ranging on the new downstream or upstream channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.
|
cc(r2)
|
This state should normally follow cc(r1) and indicates that the CM has finished its initial ranging on the new channel, and is currently performing continuous ranging on the new channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.
|
offline
|
The CM is considered offline (disconnected or powered down).
|
online
|
The CM has registered and is enabled to pass data on the network.
|
online(d)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. The CM does not forward traffic to or from the CPE devices, but the CMTS can continue to communicate with the CM using DOCSIS messages and IP traffic (such as SNMP commands).
Note If BPI was enabled in the DOCSIS configuration file sent to the CM, assume that the CM is using BPI encryption, unless other messages show that the BPI negotiation and key assignments have failed.
|
online(pkd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and KEK is assigned.
Note This state is equivalent to the online(d) and online(pk) states.
|
online(ptd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and TEK is assigned. BPI encryption is now being performed.
Note This state is equivalent to the online(d) and online(pt) states.
|
online(pk)
|
The CM registered, BPI is enabled and KEK is assigned.
|
online(pt)
|
The CM registered, BPI is enabled and TEK is assigned. BPI encryption is now being performed.
Note If network access was disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) instead of online(pt) even when BPI encryption is enabled and operational.
|
Note If an exclamation point (!) appears in front of one of the online states, it indicates that the cable dynamic-secret command has been used with either the mark or reject option, and that the cable modem has failed the dynamic secret authentication check.
|
expire(pk)
|
The CM registered, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.
|
expire(pkd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pk) states.
|
expire(pt)
|
The CM registered, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.
|
expire(ptd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pt) states.
|
Error Status Conditions
|
reject(m)
|
The CM attempted to register but registration was refused due to a bad Message Integrity Check (MIC) value. This also could indicate that the shared secret in the DOCSIS configuration file does not match the value configured on the CMTS with the cable shared-secret command.
In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases, this could also indicate that the cable tftp-enforce command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so.
|
reject(c)
|
The CM attempted to register, but registration was refused due to a a number of possible errors:
• The CM attempted to register with a minimum guaranteed upstream bandwidth that would exceed the limits imposed by the cable upstream admission-control command.
• The CM has been disabled because of a security violation.
• A bad class of service (COS) value in the DOCSIS configuration file.
• The CM attempted to create a new COS configuration but the CMTS is configured to not permit such changes.
• The CM failed the timestamp check for its DOCSIS configuration file. (This could indicate a possible theft-of-service attempt, or a problem with the synchronization of the clocks on the CM and CMTS.)
|
reject(pk)
|
KEK key assignment is rejected, BPI encryption has not been established.
|
reject(pkd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because KEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pk) states.
|
reject(pt)
|
TEK key assignment is rejected, BPI encryption has not been established.
|
reject(ptd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because TEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pt) states.
|
Note In Cisco IOS Release 12.1(20)EC, Cisco IOS Release 12.2(15)BC1, and earlier releases, when network access is disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) even if BPI encryption fails. Use the show cable modem mac-address command to confirm whether BPI is enabled or disabled for a particular cable modem.
|
reject(ts)
|
The CM attempted to register, but registration failed because the TFTP server timestamp in the CM registration request did not match the timestamp maintained by the CMTS. This might indicate that the CM attempted to register by replaying an old DOCSIS configuration file used during a prior registration attempt.
|
reject(ip)
|
The CM attempted to register, but registration failed because the IP address in the CM request did not match the IP address that the TFTP server recorded when it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.
|
reject(na)
|
The CM attempted to register, but registration failed because the CM did not send a Registration-Acknowledgement (REG-ACK) message in reply to the Registration-Response (REG-RSP) message sent by the CMTS. A Registration-NonAcknowledgement (REG-NACK) is assumed.
|
Related Commands
Command
|
Description
|
cable modem vendor
|
Associates the name of a vendor with its Organizational Unique Identifier (OUI).
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem access-group
|
Displays the access groups for the CMs on a particular cable interface.
|
show cable modem classifiers
|
Displays information about the classifiers for a particular CM.
|
show cable modem connectivity
|
Displays connectivity statistics for one or more CMs.
|
show cable modem cpe
|
Displays the CPE devices accessing the cable interface through a particular CM.
|
show cable modem offline
|
Displays a list of the CMs that are marked as offline with the Cisco CMTS.
|
show cable modem registered
|
Displays a list of the CMs that are marked as registered with the Cisco CMTS.
|
show cable modem rf-adapt
|
Displays RF adaptation information for cable modems.
|
show cable modem vendor
|
Displays the vendor name or Organizational Unique Identifier (OUI) for the CMs on each cable interface.
|
show interface cable modem
|
Displays information about the CMs connected to a particular cable interface.
|
show interface cable sid
|
Displays cable interface information.
|
show cable modem vendor
To display the vendor name or Organizational Unique Identifier (OUI) for the CMs on each cable interface, use the show cable modem vendor command in privileged EXEC mode.
show cable modem [cable {slot/subslot/port | slot/subslot/cable-interface-index} [upstream port
[logical-channel-index]]] vendor [summary]
Syntax Description
slot
|
Slot where the line card resides. The valid range is from 5 to 8.
|
subslot
|
Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
|
port
|
Downstream port number. The valid range is from 0 to 4 (depending on the cable interface).
|
cable-interface-index
|
Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
• Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
upstream port
|
(Optional) Displays information for all CMs using this specific upstream. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports on the cable interface line card.
|
logical-channel-index
|
(Optional) Logical channel index. The valid values are 0 or 1.
|
summary
|
(Optional) Displays the total numbers for each vendor and OUI, along with the total numbers of those vendor's CMs that are currently registered with the CMTS, unregistered, or offline.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(8)BC2
|
This command was introduced for the Cisco uBR7100 series, Cisco uBR7200 series, and Cisco uBR10012 routers.
|
12.2(33)SCE
|
This command was modified. The port parameter was changed to cable-interface-index.
|
12.2(33)SCF
|
This command was modified. The logical-channel-index argument was added.
|
Usage Guidelines
This command displays the vendor name for each CM. If the vendor name has not been defined by the cable modem vendor command, the command displays the OUI value for the modem's vendor.
Note
The Institute of Electrical and Electronics Engineers (IEEE) is the official issuer of OUI values. The IEEE OUI web site is at http://standards.ieee.org/regauth/oui/index.shtml.
Note
Also see the information about this command's behavior in a Hot Standby Connection-to-Connection Protocol (HCCP) configuration.
Examples
The following example shows typical output for the show cable modem vendor command:
Router# show cable modem vendor
Vendor MAC Address I/F MAC Prim RxPwr Timing Num BPI
State Sid (db) Offset CPE Enb
Cisco 0001.9659.519f C1/0/U0 init(rc) 16 0.75 2738 0 N
Cisco 0002.b96f.fdbb C1/0/U0 online 20 1.00 2738 1 N
Cisco 0002.b96f.fdf9 C1/0/U0 online 21 0.50 2737 1 N
Cisco 0002.b96f.fff7 C1/0/U0 online 12 0.50 2737 1 N
Cisco 0002.fdfa.1163 C1/0/U0 online 1 0.00 2734 1 N
Cisco 0002.fdfa.12d5 C1/0/U0 online 14 0.00 2737 1 N
Cisco 0002.fdfa.12db C1/0/U0 online 18 0.25 2736 1 N
Cisco 0002.fdfa.12e9 C1/0/U0 online 13 0.25 2737 1 N
Cisco 0006.28dc.37fd C1/0/U0 offline 7 0.25 2734 0 N
Cisco 0006.28e9.81c9 C1/0/U0 online 2 0.75 2735 1 N
Motorola 0020.28f9.9d19 C1/0/U0 online 28 -0.25 2733 1 N
Motorola 0020.4006.b010 C1/0/U0 online 19 0.00 2728 1 N
00.C0.FF 00c0.FF78.8bea C1/0/U0 offline 10 1.25 2732 0 N
Cisco 00b0.6478.ae8d C1/0/U0 offline 10 1.50 2735 0 N
Cisco 00d0.bad3.c0cd C1/0/U0 online 26 0.25 2214 1 N
Cisco 00d0.bad3.c0d5 C1/0/U0 online 27 0.00 2215 1 N
The following example shows typical output for the show cable modem vendor command on the Cisco uBR10012 router:
Router# show cable modem vendor
Vendor MAC Address I/F MAC Prim RxPwr Timing Num BPI
State Sid (db) Offset CPE Enb
Thomson 0010.9507.01db C5/1/0/U5 online 1 0.00 938 1 N
Ericsson 0080.37b8.e99b C5/1/0/U5 online 2 -0.25 1268 0 N
Cisco 0002.fdfa.12ef C6/1/0/U0 online 13 0.00 1920 1 N
Cisco 0002.fdfa.137d C6/1/0/U0 online 16 -0.50 1920 1 N
Cisco 0003.e38f.e9ab C6/1/0/U0 online 3 -0.25 1926 1 N
Cisco 0003.e3a6.7f69 C6/1/0/U0 online 15 0.50 1927 1 N
Cisco 0003.e3a6.816d C6/1/0/U0 online 4 0.00 1929 1 N
Cisco 0006.28f9.8be5 C6/1/0/U0 online 12 0.75 1922 1 N
Cisco 0001.9659.519f C6/1/1/U2 online 26 0.25 1930 1 N
Cisco 0002.b96f.fdbb C6/1/1/U2 online 29 -0.75 1929 1 N
Cisco 0002.b96f.fdf9 C6/1/1/U2 online 39 -0.50 1931 1 N
Cisco 0002.b96f.fff7 C6/1/1/U2 online 38 0.00 1928 1 N
Cisco 0002.fdfa.1163 C6/1/1/U2 online 15 0.00 1923 1 N
Cisco 0002.fdfa.12d5 C6/1/1/U2 online 35 0.25 1923 1 N
Cisco 0002.fdfa.12e9 C6/1/1/U2 online 5 -0.25 1925 1 N
Cisco 0050.7302.3d73 C6/1/1/U2 online 58 0.25 1553 1 N
Cisco 0002.fdfa.12db C7/0/0/U0 online 15 -0.75 1914 1 N
Cisco 0002.fdfa.138d C7/0/0/U5 online 4 0.25 1917 1 N
Cisco 0003.e38f.e85b C7/0/0/U5 online 17 0.25 1919 1 N
Cisco 0003.e38f.f4cb C7/0/0/U5 online 16 0.00 1922 1 N
Cisco 0003.e3a6.7fd9 C7/0/0/U5 online 1 0.25 1922 0 N
Motorola 0020.4005.3f06 C7/0/0/U0 online 2 0.00 1901 1 N
Motorola 0020.4006.b010 C7/0/0/U5 online 3 0.25 1901 1 N
Cisco 0050.7302.3d83 C7/0/0/U0 online 18 -0.25 1543 1 N
Cisco 00b0.6478.ae8d C7/0/0/U5 online 44 0.50 1920 21 N
Cisco 00d0.bad3.c0cd C7/0/0/U5 online 19 0.00 1543 1 N
Cisco 00d0.bad3.c0cf C7/0/0/U0 online 13 0.00 1546 1 N
Cisco 00d0.bad3.c0d5 C7/0/0/U0 online 12 -0.50 1546 1 N
Tip
The show cable modem vendor command displays the CM timing offset in DOCSIS ticks, while other commands, such as cable map-advance, display the offset in microseconds. Use the following method to convert microseconds to DOCSIS ticks: ticks = microseconds*64/6.25.
Table 0-44 describes the major fields shown in the show cable modem vendor displays:
Table 0-44 Descriptions for the show cable modem vendor Fields
Field
|
Description
|
Vendor
|
The vendor name for the indicated CM, as specified by the cable modem vendor command. If no name for this vendor has been specified, displays the modem's OUI value.
|
MAC Address
|
The MAC address for the CM.
|
I/F
|
The cable interface line card providing the upstream for this CM.
|
MAC State
|
The current state of the MAC layer.
|
Prim SID
|
The primary SID assigned to this CM.
|
RxPwr
|
The received power level (in dB) for the CM.
Note An asterisk (*) in the RxPwr column indicates that a power adjustment has been made for that CM. An exclamation point (!) indicates that the CM has reached its maximum power transmit level and cannot increase its power level further.
|
Timing Offset
|
The timing offset for the CM, in ticks, as recognized on the CMTS. (A tick, as used here, is 6.25/64 microseconds.) This is the delay between when a particular cable modem is scheduled to make a transmission and when the CMTS actually receives it.
Note An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command.
Note The timing offset shown here is typically smaller than the TX Time Offset value shown by the show cable modem remote-query command, because the latter value is the offset as recognized on the CM (which will include any internal delay between when the CM software begins the transmission and when the bits actually appear on the local cable interface).
|
Num CPE
|
Indicates the number of CPE devices for which the CM is providing services.
|
BPI Enbld
|
Indicates whether Baseline Privacy Interface (BPI) or BPI Plus (BPI+) encryption is enabled for the CM.
|

Note
An asterisk (*) in the RxPwr column indicates that a power adjustment has been made for that CM. An exclamation point (!) in the Receive Power column indicates that the CM has reached its maximum power transmit level and cannot increase its power level further. An exclamation point (!) in the Timing Offset column indicates that the CM has exceeded the maximum delay and timing offset specified by the cable map-advance command.
A pound sign (#) in the MAC State column indicates that the cable tftp-enforce mark-only command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so (Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases).
The following example shows typical output for the show cable modem vendor summary command, displaying the total numbers for each vendor and OUI, along with the total numbers of those vendor's CMs that are currently registered with the CMTS, unregistered, or offline.
Router# show cable modem vendor summary
Total Registered Unregistered Offline
00.02.B2 00.02.B2 4288 3997 291 259
00.0A.73 00.0A.73 4105 3938 167 108
00.0B.06 00.0B.06 1060 1001 59 48
00.40.7B 00.40.7B 216 211 5 2
00.50.04 00.50.04 701 684 17 15
00.50.DA 00.50.DA 737 706 31 26
00.D0.DD 00.D0.DD 2 0 2 2
3Com 00.01.03 669 645 24 21
BestData 00.E0.CA 1 1 0 0
LinkSys 00.06.25 15 13 2 2
Motorola 00.04.BD 705 676 29 21
Motorola 00.08.0E 762 734 28 16
Motorola 00.20.40 1504 1444 60 45
Powercom 00.30.3B 3 2 1 1
Terayon 00.E0.6F 652 612 40 25
Thomson 00.10.95 127 121 6 5
Tip
You can add a timestamp to this command using the exec prompt timestamp command in line configuration mode.
Related Commands
Command
|
Description
|
cable modem vendor
|
Associates the name of a vendor with its Organizational Unique Identifier (OUI).
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem connectivity
|
Displays connectivity statistics for one or more CMs.
|
show cable modem cpe
|
Displays the CPE devices accessing the cable interface through a particular CM.
|
show cable modem remote-query
|
Displays information collected by the remote-query feature.
|
show cable modem rf-adapt
|
Displays RF adaptation information for cable modems.
|
show interface cable modem
|
Displays information about the CMs connected to a particular cable interface.
|
show interface cable sid
|
Displays cable interface information.
|
show cable modem voice
To show the detected voice-enabled modems, use the show cable modem voice command.
cable modem voice [pending|failed]
Syntax Description
pending
|
(Optional) Displays cable modems that are being moved to the target channel via Downstream Frequency Override (DFO).
|
failed
|
(Optional) Displays cable modems that have already reached the maximum Downstream Frequency Override retry limit without success.
|
Command Default
No default behavior or values
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.3(23)BC
|
This command was introduced for the Cisco uBR10012 router.
|
Usage Guidelines
Use this command to display the detected voice-enabled modems.
Examples
Router# show cable modem voice
MAC Address IP Address Host MAC Prim Num Primary DS
Interface State Sid CPE Downstream RfId
0013.10bb.22f9 80.17.1.2 C6/0/0/U0 online(pt) 2 0 Mo3/0/0:1 1
0013.10bb.23d1 80.17.1.5 C6/0/1/U1 online(pt) 5 0 C6/0/1 255
Related Commands
show cable service-voice downstream-type
|
Displays the downstream-types that are capable of providing voice services.
|
show cable modem wideband
To display information for registered and unregistered wideband CMs, use the show cable modem wideband command in privileged EXEC mode.
show cable modem wideband [registered-traditional-docsis | channel ]
show cable modem [ip-address | mac-address | cable {slot/subslot/port |
slot/subslot/cable-interface-index} [upstream port [logical-channel-index]]] wideband
[channel]
Syntax Description
ip-address
|
(Optional) Identifies the IP address of a specific wideband CM to be displayed. If you specify the IP address for a CPE device behind a CM, information for that CM is displayed.
|
mac-address
|
(Optional) Identifies the MAC address of a specific wideband CM to be displayed. If you specify the MAC address for a CPE device behind a wideband CM, information for that wideband CM is displayed.
|
slot
|
Slot where the line card resides. The valid range is from 5 to 8.
|
subslot
|
Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
|
port
|
Downstream port number. The valid range is from 0 to 4 (depending on the cable interface).
|
cable-interface-index
|
Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco UBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
• Cisco uBR10012 router—The valid range for the Cisco UBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
upstream port
|
(Optional) Displays information for all CMs using this specific upstream. You can specify this option only when displaying information for a cable interface. The valid range for port begins with 0 and ends with a value that depends on the number of upstream ports on the cable interface line card.
|
logical-channel-index
|
(Optional) Logical channel index. The valid values are 0 or 1.
|
registered-traditional-docsis
|
(Optional) Displays information for wideband CMs that are currently registered as traditional DOCSIS modems.
|
channel
|
(Optional) Displays the number of downstream (DS) and upstream (US) channels used by a cable modem.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.3(21)BC
|
This command was introduced for the Cisco uBR10012 universal broadband router.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA.
|
12.2(33)SCB
|
This command output no longer shows the downstream (DS) channel ID or the bonding group (BG) ID. A new column was added to display the Receive Channel Configuration (RCC) ID of the RCC assigned to the cable modem.
|
12.2(33)SCE
|
This command was modified. The port parameter was changed to cable-interface-index.
|
12.2(33)SCF
|
This command was modified. The channel keyword and logical-channel-index argument was added.
|
Usage Guidelines
This command displays information for a one or more wideband CMs. Optionally, the CMs for which to display information can be identified IP address, MAC address, or cable interface.
If a wideband-capable CM is not able to register as a wideband CM (for example, if no wideband channel is available), the CM attempts to register as a traditional DOCSIS modem. The registered-traditional-docsis keyword limits the set of wideband CMs for which to display information to wideband-capable CMs that are currently registered as DOCSIS 1.X or DOCSIS 2.0 modems.
Examples
Example of the show cable modem wideband Command in a Cisco IOS Release Prior to Cisco IOS Release 12.2(33)SCB
The following is a sample output for the default form of the show cable modem wideband command on a Cisco uBR10012 router running a Cisco IOS Release prior to Cisco IOS Release 12.2(33)SCB:
Router# show cable modem wideband
MAC Address IP Address I/F MAC Prim BG DSID MD-DS-SG
0014.bfbe.3cc0 1.11.0.1 C5/0/1/U0 w-online(pt) 3 24 24 N/A
0016.92f0.90d6 1.11.0.4 C5/0/1/U0 w-online(pt) 5 24 272 1
0014.bfbe.3cb8 1.11.0.2 C6/0/1/U0 w-online(pt) 3 36 36 N/A
0016.92f0.90d8 1.11.0.3 C6/0/1/U0 w-online(pt) 5 36 274 1
Example of the show cable modem wideband Command in Cisco IOS Release 12.2(33)SCB
The following is a sample output for the default form of the show cable modem wideband command on a Cisco uBR10012 router running Cisco IOS Release 12.2(33)SCB:
Router# show cable modem wideband
MAC Address IP Address I/F MAC Prim RCC MD-DS-SG
0014.bfbe.4694 30.2.0.3 C8/0/0/U0 w-online(pt) 3 1 1
0018.6852.84aa 30.2.0.5 C8/0/0/U0 w-online(pt) 4 2 1
Note
The RCC ID refers to the output of the show cable mac-domain rcc command.
Examples of the show cable modem wideband channel Command in Cisco IOS Release 12.2(33)SCF
The following is a sample output of the show cable modem wideband channel command for all cable modems:
Router# show cable modem wideband channel
MAC Address IP Address I/F MAC DSxUS Primary
0018.6852.7b76 80.62.0.5 C6/1/0/U0 w-online 2x1 Wi6/1/0:1
0019.474a.c182 80.62.0.2 C6/1/0/U0 w-online 2x1 Wi6/1/0:1
The following is a sample output of the show cable modem wideband channel command for a specific cable modem identified by its IP address:
Router# show cable modem 80.62.0.5 wideband channel
MAC Address IP Address I/F MAC DSxUS Primary
0018.6852.7b76 80.62.0.5 C6/1/0/U0 w-online 2x1 Wi6/1/0:1
The following is a sample output of the show cable modem wideband channel command for a specific cable modem identified by its MAC address:
Router# show cable modem 0018.6852.7b76 wideband channel
MAC Address IP Address I/F MAC DSxUS Primary
0018.6852.7b76 80.62.0.5 C6/1/0/U0 w-online 2x1 Wi6/1/0:1
The following is a sample output of the show cable modem wideband channel command for a specific cable interface:
Router# show cable modem Cable 6/1/0 wideband channel
MAC Address IP Address I/F MAC DSxUS Primary
0018.6852.7b76 80.62.0.5 C6/1/0/U0 w-online 2x1 Wi6/1/0:1
0019.474a.c182 80.62.0.2 C6/1/0/U0 w-online 2x1 Wi6/1/0:1
Table 45 describes the fields that are shown in the show cable modem wideband display:
Table 45 Descriptions for the show cable modem wideband Fields
Field
|
Description
|
MAC Address
|
MAC address for the CM.
|
IP Address
|
IP address that the DHCP server has assigned to the CM.
|
I/F
|
Cable interface providing the upstream for this CM.
|
MAC State
|
The current state of the MAC layer (see Table 46).
|
Prim SID
|
Primary SID assigned to this CM.
|
Bonding group ID
|
Identifier of the primary wideband channel.
|
DSID
|
Downstream Service Identifier.
|
DSxUS
|
Number of DS and US channels used by the CM.
|
Primary WB
|
Primary wideband channel for the CM.
|
MD-DS-SG
|
MAC Domain Downstream Service Group, the downstream channels of a single MAC domain that reach the cable modem.
|
Table 46 shows the possible values for the MAC State field for a wideband CM modem that registers as a traditional DOCSIS modem:
Table 46 Descriptions for the MAC State Field (for Traditional DOCSIS Modems) 1
MAC State Value
|
Description
|
Registration and Provisioning Status Conditions
|
init(r1)
|
The CM sent initial ranging.
|
init(r2)
|
The CM is ranging. The CMTS received initial ranging from the CM and has sent RF power, timing offset, and frequency adjustments to the CM.
|
init(rc)
|
Ranging has completed.
Note If a CM appears to be stuck in this state, it could be that the CM is able to communicate successfully on the cable network, but that the upstream is at capacity and does not have any additional bandwidth to allow the CM to finish registration and come online. Either manually move one or more CMs to other upstreams, or enable load balancing on the upstream using the cable load-balance group commands.
|
init(d)
|
The DHCP request was received, as DHCPDISCOVER. This also indicates that the first IP broadcast packet has been received from the CM.
|
init(dr)
|
The DHCP request has been sent to the cable modem.
|
init(i)
|
The cable modem has received the DHCPOFFER reply (DHCPACK) from the DHCP server that has assigned an IP address to the modem, but the modem has not yet replied with a DHCPREQUEST message requesting that particular IP address, nor has it sent an IP packet with that IP address.
Note If a CM appears to be stuck in this state, the CM has likely received the DHCPOFFER reply from the DHCP server, but this reply might have contained one or more invalid options for that particular CM.
|
init(io)
|
The Cisco CMTS has seen the DHCP offer as sent to the cable modem from the DHCP server that has assigned an IP address to the modem.
|
init(o)
|
The CM has begun to download the option file (DOCSIS configuration file) using the Trivial File Transfer Protocol (TFTP), as specified in the DHCP response. If the CM remains in this state, it indicates that the download has failed.
|
init(t)
|
Time-of-day (TOD) exchange has started.
|
resetting
|
The CM is being reset and will shortly restart the registration process.
|
Non-error Status Conditions
|
cc(r1)
|
The CM had registered and was online, but has received a Downstream Channel Change (DCC) or Upstream Channel Change (UCC) request message from the CMTS. The CM has begun moving to the new channel, and the CMTS has received the CM's initial ranging on the new downstream or upstream channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.
|
cc(r2)
|
This state should normally follow cc(r1) and indicates that the CM has finished its initial ranging on the new channel, and is currently performing continuous ranging on the new channel. At the MAC layer, the CM is considered offline because it is not yet passing traffic on the new channel, but this state does not trigger the flap-list counters.
|
offline
|
The CM is considered offline (disconnected or powered down).
|
online
|
The CM has registered and is enabled to pass data on the network.
|
online(d)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. The CM does not forward traffic to or from the CPE devices, but the CMTS can continue to communicate with the CM using DOCSIS messages and IP traffic (such as SNMP commands).
Note If BPI was enabled in the DOCSIS configuration file sent to the CM, assume that the CM is using BPI encryption, unless other messages show that the BPI negotiation and key assignments have failed.
|
online(pkd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and KEK is assigned.
Note This state is equivalent to the online(d) and online(pk) states.
|
online(ptd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and TEK is assigned. BPI encryption is now being performed.
Note This state is equivalent to the online(d) and online(pt) states.
|
online(pk)
|
The CM registered, BPI is enabled and KEK is assigned.
|
online(pt)
|
The CM registered, BPI is enabled and TEK is assigned. BPI encryption is now being performed.
Note If network access was disabled in the DOCSIS configuration file sent to the CM, the network disabled status takes precedence, and the MAC status field shows online(d) instead of online(pt) even when BPI encryption is enabled and operational.
|
Note If an exclamation point (!) appears in front of one of the online states, it indicates that the cable dynamic-secret command has been used with either the mark or reject option, and that the cable modem has failed the dynamic secret authentication check.
|
expire(pk)
|
The CM registered, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.
|
expire(pkd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pk) states.
|
expire(pt)
|
The CM registered, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.
|
expire(ptd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, TEK was assigned, but the current TEK expired before the CM could successfully renew a new KEK value.
Note This state is equivalent to the online(d) and expire(pt) states.
|
Error Status Conditions
|
reject(m)
|
The CM attempted to register but registration was refused due to a bad Message Integrity Check (MIC) value. This also could indicate that the shared secret in the DOCSIS configuration file does not match the value configured on the CMTS with the cable shared-secret command.
In Cisco IOS Release 12.1(11b)EC1 and Cisco IOS Release 12.2(8)BC2 or later releases, this could also indicate that the cable tftp-enforce command has been used to require that a CM attempt a TFTP download of the DOCSIS configuration file before registering, but the CM did not do so.
|
reject(c)
|
The CM attempted to register, but registration was refused due to a a number of possible errors:
• The CM attempted to register with a minimum guaranteed upstream bandwidth that would exceed the limits imposed by the cable upstream admission-control command.
• The CM has been disabled because of a security violation.
• A bad class of service (COS) value in the DOCSIS configuration file.
• The CM attempted to create a new COS configuration but the CMTS is configured to not permit such changes.
• The CM failed the timestamp check for its DOCSIS configuration file. (This could indicate a possible theft-of-service attempt, or a problem with the synchronization of the clocks on the CM and CMTS.)
|
reject(pk)
|
KEK key assignment is rejected, BPI encryption has not been established.
|
reject(pkd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because KEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pk) states.
|
reject(pt)
|
TEK key assignment is rejected, BPI encryption has not been established.
|
reject(ptd)
|
The CM registered, but network access for CPE devices using this CM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because TEK key assignment was rejected.
Note This state is equivalent to the online(d) and reject(pt) states.
|
reject(ts)
|
The CM attempted to register, but registration failed because the TFTP server timestamp in the CM registration request did not match the timestamp maintained by the CMTS. This might indicate that the CM attempted to register by replaying an old DOCSIS configuration file used during a prior registration attempt.
|
reject(ip)
|
The CM attempted to register, but registration failed because the IP address in the CM request did not match the IP address that the TFTP server recorded when it sent the DOCSIS configuration file to the CM. IP spoofing could be occurring.
|
reject(na)
|
The CM attempted to register, but registration failed because the CM did not send a Registration-Acknowledgement (REG-ACK) message in reply to the Registration-Response (REG-RSP) message sent by the CMTS. A Registration-NonAcknowledgement (REG-NACK) is assumed.
|

Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Table 47 shows the possible values for the MAC state field for a wideband-capable CM that registers as a wideband modem:
Table 47 Additional MAC States for a Wideband Cable Modem
MAC State Value
|
Description
|
Non-error Status Conditions
|
w-online
|
The WCM has registered and is enabled to pass data on the network.
|
w-online(d)
|
The WCM registered, but network access for CPE devices using this WCM has been disabled through the DOCSIS configuration file. The CM does not forward traffic to or from the CPE devices, but the WCMTS can continue to communicate with the WCM using DOCSIS messages and IP traffic (such as SNMP commands).
Note If BPI was enabled in the DOCSIS configuration file sent to the WCM, assume that the CM is using BPI encryption, unless other messages show that the BPI negotiation and key assignments have failed.
|
w-online(pkd)
|
The WCM registered, but network access for CPE devices using this WCM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and KEK is assigned.
Note This state is equivalent to the w-online(d) and w-online(pk) states.
|
w-online(pt)
|
The WCM registered, BPI is enabled and TEK is assigned. BPI encryption is now being performed.
Note If network access was disabled in the DOCSIS configuration file sent to the WCM, the network disabled status takes precedence, and the MAC status field shows w-online(d) instead of w-online(pt) even when BPI encryption is enabled and operational.
|
w-online(ptd)
|
The WCM registered, but network access for CPE devices using this WCM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled and TEK is assigned. BPI encryption is now being performed.
Note This state is equivalent to the w-online(d) and w-online(pt) states.
|
w-online(pk)
|
The WCM registered, BPI is enabled and KEK is assigned.
|
w-expire(pk)
|
The WCM registered, BPI is enabled, KEK was assigned, but the current KEK expired before the WCM could successfully renew a new KEK value.
|
w-expire(pkd)
|
The WCM registered, but network access for CPE devices using this WCM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, KEK was assigned, but the current KEK expired before the CM could successfully renew a new KEK value.
Note This state is equivalent to the w-online(d) and w-expire(pk) states.
|
w-expire(pt)
|
The WCM registered, BPI is enabled, TEK was assigned, but the current TEK expired before the WCM could successfully renew a new KEK value.
|
w-expire(ptd)
|
The WCM registered, but network access for CPE devices using this WCM has been disabled through the DOCSIS configuration file. In addition, BPI is enabled, TEK was assigned, but the current TEK expired before the WCM could successfully renew a new KEK value.
Note This state is equivalent to the w-online(d) and w-expire(pt) states.
|
Error Status Conditions
|
w-reject(pk)
|
KEK key assignment is rejected, BPI encryption has not been established.
|
w-reject(pkd)
|
The WCM registered, but network access for CPE devices using this WCM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because KEK key assignment was rejected.
Note This state is equivalent to the w-online(d) and w-reject(pk) states.
|
w-reject(pt)
|
TEK key assignment is rejected, BPI encryption has not been established.
|
w-reject(ptd)
|
The WCM registered, but network access for CPE devices using this WCM has been disabled through the DOCSIS configuration file. In addition, BPI encryption was not established because TEK key assignment was rejected.
Note This state is equivalent to the w-online(d) and w-reject(pt) states.
|
Related Commands
Command
|
Description
|
show cable modem vendor
|
Associates the name of a vendor with its Organizational Unique Identifier (OUI).
|
show cable modem
|
Displays information for the registered and unregistered CMs.
|
show cable modem summary
|
Displays displays voice call information for a particular CM, identified either by its IP address or MAC address.
|
show cable modem classifiers
|
Displays information about the classifiers for a particular CM.
|
show cable modem cnr
|
Displays information about the upstream carrier-to-noise ratio (CNR) for a particular cable modem.
|
show cable modem connectivity
|
Displays connectivity statistics for one or more CMs.
|
show cable modem errors
|
Displays error statistics for one or more CMs.
|
show cable modem flap
|
Displays flap list statistics for one or more cable modems.
|
show cable modem maintenance
|
Displays station maintenance (SM) error statistics for one or more cable modems.
|
show cable modem remote-query
|
Displays information collected by the remote-query feature.
|
show cable modem rf-adapt
|
Displays RF adaptation information for cable modems.
|
show cable modulation-profile
|
Displays modulation profile group information.
|
show interface cable modem
|
Displays information about the CMs connected to a particular cable interface.
|
show interface cable sid
|
Displays cable interface information.
|
show cable modem wideband primary-channel
To display primary-channel information for a wideband channel, use the show cable modem wideband primary-channel command in privileged EXEC mode.
show cable modem [ip-address | mac-address] wideband primary-channel
Syntax Description
ip-address
|
Identifies the IP address of a specific cable modem to be displayed. If you specify the IP address for a CPE device behind a cable modem, information for that cable modem is displayed.
|
mac-address
|
Identifies the MAC address of a specific cable modem to be displayed. You can also specify the MAC address for a CPE device behind a cable modem, and information for that cable modem will be displayed.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.3(23)BC
|
This command was introduced for the Cisco uBR10012 router.
|
Usage Guidelines
This command displays primary-channel information for a wideband channel that is associated with a specific MAC address or IP address of a cable modem or CPE device behing the cable modem.
Related Commands
Command
|
Description
|
show cable modem
|
Displays information for the registered and unregistered cable modems.
|
show cable modem primary-channel summary total
|
Displays information for the wideband and narrowband cable modems and location of the primary downstream channel.
|
show cable modem wideband rcs-status
To display details of events for each RF channel in the cable modem's receive channel configuration (RCC), use the show cable modem wideband rcs-status command in privileged EXEC mode.
show cable modem [mac-address | ip-address |cable slot/subslot/port] wideband rcs-status
Syntax Description
mac-address
|
(Optional) Specifies the MAC address of a wideband CM to be displayed.
|
ip-address
|
(Optional) Specifies the IP address of a wideband CM to be displayed.
|
cable slot/subslot/port
|
Optional) Identifies a cable interface on the Cisco uBR10012 router. The following are the valid values:
• slot—Specifies the chassis slot number of the cable interface line card. Valid values are 5to 8.
• subslot—Specifies the secondary slot number of the cable interface line card. Valid subslots are 0 or 1.
• port—Specifies the port number. Valid values are 0 to 4 (depending on the cable interface).
|
Command Default
No default behavior or values.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCB
|
This command was introduced.
|
Examples
The following is a sample output of the show cable modem wideband rcs-status command on a wideband cable interface:
Router# show cable modem wideband rcs-status
Related Commands
Command
|
Description
|
show cable modem summary wb-rf
|
Displays the number of RFs that are down on a cable interface.
|
show cable modulation-profile
To display modulation profile group information for a Cisco CMTS, use the show cable modulation-profile command in privileged EXEC mode.
show cable modulation-profile [profile [verbose] ] [iuc-code]
show cable modulation-profile cable {slot/port | slot/subslot/port} [upstream port]
Syntax Description
profile
|
(Optional) Profile number. Valid values start with 1.
|
verbose
|
(Optional) Displays detailed information for an individual profile.
|
iuc-code
|
(Optional) Internal usage code (IUC). Valid options are:
a-long—Advanced Phy Long Grant Burst (IUC 10) a-short—Advanced Phy Short Grant Burst (IUC 9) a-ugs—Advanced Phy Unsolicited Grant Burst (IUC 11) initial—Initial Ranging Burst (IUC 3) long—Long Grant Burst (IUC 6) reqdata—Request/Data Burst (IUC 2) 1 request—Request Burst (IUC 1) short—Short Grant Burst (IUC 5) station—Station Ranging Burst (IUC 4)
|
cable slot/port
|
Identifies a cable interface and downstream port on the Cisco uBR7100 series and Cisco uBR7200 series routers.
On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
|
cable slot/subslot/port
|
Identifies a cable interface on the Cisco uBR10012 router. The following are the valid values:
• slot = 5 to 8
• subslot = 0 or 1
• port = 0 to 4 (depending on the cable interface)
|
upstream port
|
(Optional) Displays information for a particular upstream on the selected cable interface. The port value starts with 0 and continues up, depending on the type of cable interface card.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.3 XA
|
This command was first introduced.
|
12.(0)5T1, 12.0(6)SC, 12.1(2)EC
|
This command was supported, replacing the show cable burst-profile command.
|
12.1(3a)EC
|
This reqdata type was added as a placeholder for scripts that might reference it, but the DOCSIS MAC scheduler on the Cisco CMTS does not use this type of burst.
|
12.2(15)CX
|
Support was added for the Cisco uBR-MC28U/X cable interface line card, including support for DOCSIS 2.0 A-TDMA and mixed modulation profiles. This includes adding additional information to the command's display, as well as adding the a-long, a-short, a-ugs, and verbose options.
|
12.2(15)CX1
|
Added the ability to display the modulation profiles being used by a particular cable interface and upstream.
|
12.2(15)BC2
|
This command displays all default modulation profiles 1, 21, 41, 101, 121, 201, 221, and 241), even when the cable interface card that is associated with those profiles is not installed. Previous releases displayed only the default modulation profiles that were in use.
|
Usage Guidelines
The show cable modulation-profile command displays modulation profile group information. A modulation profile is a collection of burst profiles that are sent out in a Upstream Channel Descriptor (UCD) message to configure a modem's transmit parameters for an upstream message burst type.
Table 0-48 shows the IUC codes for each burst type:
Table 0-48 Internal Usage Code Types
IUC
|
Type
|
IUC
|
Type
|
IUC 1
|
Request Burst (req)
|
IUC 7
|
Not used
|
IUC 2
|
Request/Data Burst (reqdata)1
|
IUC 8
|
Not used
|
IUC 3
|
Initial Ranging Burst (initial)
|
IUC 9
|
Advanced Phy Short Grant Burst (a-short)
|
IUC 4
|
Station Ranging Burst (station)
|
IUC 10
|
Advanaced Phy Long Grant Burst (a-long)
|
IUC 5
|
Short Grant Burst (short)
|
IUC 11
|
Advanaced Phy Unsolicited Grant Burst (a-ugs)
|
IUC 6
|
Long Grant Burst (long)
|
IUC 12
|
Not used
|
Modulation Profile Ranges
The ranges for modulation profiles depends on the cable interface being used and the type of modulation profile being created. Table 0-49 lists the valid ranges according to cable interface and modulation type:
Table 0-49 Allowable Ranges for Modulation Profiles
Cable Interface
|
DOCSIS 1.X (TDMA)
|
Mixed DOCSIS 1.X/2.0
|
DOCSIS 2.0 (A-TDMA)
|
Cisco uBR7100 series
|
1 to 101 , default=1
|
N/A
|
N/A
|
Cisco uBR-MC16C
|
1 to 10, default=1
|
N/A
|
N/A
|
Cisco uBR-MC16S
|
1 to 10, default=1
|
N/A
|
N/A
|
Cisco uBR-MC28C
|
1 to 10, default=1
|
N/A
|
N/A
|
Cisco uBR10-MC5X20S, Cisco uBR10-MC5X20U, Cisco uBR10-MC5X20H
|
21 to 30, default=21
|
121 to 130, default=121
|
221 to 230, default=221
|
Cisco uBR-MC16U/X, Cisco uBR-MC28U/X
|
41 to 50, default=41
|
141 to 150, default=141
|
241 to 250, default=241
|
Note
Default modulation profiles are created for each type of card and operation mode. You cannot delete the default modulation profiles (1, 21, 41, 101, 121, 201, 221, and 241). In Cisco IOS Release 12.2(15)BC2 and later, all default modulation profiles are displayed, even when that particular cable interface is not installed. In previous versions, only the default modulation profiles that were in use were displayed.
Examples
The following is sample output from the show cable modulation-profile command in Cisco IOS Release 12.2(11)BC3 and earlier releases:
CMTS01# show cable modulation-profile
Mo IUC Type Preamb Diff FEC FEC Scrambl Max Guard Last Scrambl Preamb
length enco T CW seed B time CW offset
bytes size size size short
1 request qpsk 64 no 0x0 0x10 0x152 1 8 no yes 56
1 initial qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0
1 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0
1 short qpsk 72 no 0x5 0x4B 0x152 0 8 no yes 48
The following is sample output from the show cable modulation-profile command in Cisco IOS Release 12.2(15)CX and later releases:
Router# show cable modulation-profile
Mod IUC Type Pre Diff FEC FEC Scrmb Max Guard Last Scrmb Pre Pre RS
len enco T k seed B time CW offst Type
1 request qpsk 64 no 0x0 0x10 0x152 0 8 no yes 184 qpsk na
1 initial qpsk 128 no 0x5 0x22 0x152 0 48 no yes 128 qpsk na
1 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 128 qpsk na
1 short qpsk 72 no 0x4 0x4C 0x152 12 8 yes yes 176 qpsk na
1 long qpsk 80 no 0x9 0xEC 0x152 0 8 yes yes 168 qpsk na
41 request qpsk 68 no 0x0 0x10 0x152 0 8 no yes 0 qpsk na
41 initial qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk na
41 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk na
41 short qpsk 80 no 0x4 0x4C 0x152 12 8 yes yes 0 qpsk na
41 long qpsk 80 no 0x8 0xEC 0x152 0 8 yes yes 0 qpsk na
45 request qpsk 68 no 0x0 0x10 0x152 0 8 no yes 0 qpsk na
45 initial qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk na
45 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk na
45 short 16qam 160 no 0x6 0x4C 0x152 7 8 yes yes 0 16qam na
45 long 16qam 160 no 0x8 0xE7 0x152 0 8 yes yes 0 16qam na
141 request qpsk 68 no 0x0 0x10 0x152 0 8 no yes 0 qpsk na
141 initial qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk na
141 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk na
141 short 16qam 160 no 0x6 0x4C 0x152 7 8 yes yes 0 16qam na
141 long 16qam 160 no 0x8 0xE7 0x152 0 8 yes yes 0 16qam na
141 a-short 32qam 160 no 0x9 0x4C 0x152 6 8 yes yes 0 qpsk1 no
141 a-long 64qam 196 no 0xC 0xE7 0x152 0 8 yes yes 0 qpsk1 no
241 request qpsk 68 no 0x0 0x10 0x152 0 8 no yes 0 qpsk0 no
241 initial qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk0 no
241 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk0 no
241 a-short 32qam 160 no 0x9 0x4C 0x152 6 8 yes yes 0 qpsk1 no
241 a-long 64qam 196 no 0xC 0xE7 0x152 0 8 yes yes 0 qpsk1 no
241 a-ugs 16qam 80 no 0x3 0xE7 0x152 0 8 yes yes 0 qpsk1 no
242 request qpsk 68 no 0x0 0x10 0x152 0 8 no yes 0 qpsk0 no
242 initial qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk0 no
242 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk0 no
242 a-short qpsk 80 no 0x4 0x4C 0x152 12 8 yes yes 0 qpsk0 no
242 a-long qpsk 68 no 0x8 0xEC 0x152 0 8 yes yes 0 qpsk0 no
242 a-ugs qpsk 80 no 0x0 0xEC 0x152 0 8 yes yes 0 qpsk0 no
243 request 64qam 132 no 0x4 0x10 0x152 0 8 no yes 0 qpsk1 no
243 initial 64qam 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk1 no
243 station 64qam 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk1 no
243 a-short 64qam 160 no 0x9 0x4C 0x152 5 8 yes yes 0 qpsk1 no
243 a-long 64qam 196 no 0xC 0xE7 0x152 0 8 yes yes 0 qpsk1 no
243 a-ugs 64qam 100 no 0x7 0xE7 0x152 0 8 yes yes 0 qpsk1 no
244 request 64qam 132 no 0x4 0x10 0x152 0 8 no yes 0 qpsk1 no
244 initial 64qam 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk1 no
244 station 64qam 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk1 no
244 a-short 64qam 160 no 0x9 0x4C 0x152 5 8 yes yes 0 qpsk1 no
244 a-long 64qam 196 no 0xC 0xE7 0x152 0 8 yes yes 0 qpsk1 no
244 a-ugs 64qam 32 no 0xA 0xC8 0x152 255 32 yes yes 0 qpsk1 yes
245 initial qpsk 32 no 0xA 0xC8 0x152 32 32 no yes 0 qpsk1 yes
245 station qpsk 32 no 0xA 0xC8 0x152 32 32 yes yes 0 qpsk1 yes
245 a-short 64qam 64 no 0xA 0xC8 0x152 32 32 yes yes 0 qpsk1 yes
245 a-long 64qam 32 no 0xA 0xC8 0x152 252 32 yes yes 0 qpsk1 yes
245 a-ugs 64qam 32 no 0xA 0xC8 0x152 32 32 yes yes 0 qpsk1 yes
The following shows sample output from the show cable modulation-profile command for a mixed mode modulation profile (TDMA/A-TDMA) on the Cisco uBR10-MC5X20S cable interface line card:
Router# show cable modulation-profile 121
Mod IUC Type Pre Diff FEC FEC Scrmb Max Guard Last Scrmb Pre Pre RS
len enco T k seed B time CW offst Type
121 request qpsk 32 no 0x0 0x10 0x152 0 20 no yes 0 qpsk na
121 initial qpsk 64 no 0x5 0x22 0x152 0 48 no yes 64 qpsk na
121 station qpsk 64 no 0x5 0x22 0x152 0 48 no yes 64 qpsk na
121 short qpsk 64 no 0x5 0x4B 0x152 6 20 yes yes 64 qpsk na
121 long qpsk 64 no 0x8 0xDC 0x152 0 20 yes yes 64 qpsk na
121 a-short 64qam 128 no 0x5 0x63 0x152 10 20 yes yes 192 qpsk0 no
121 a-long 64qam 128 no 0xF 0xC8 0x152 0 20 yes yes 192 qpsk0 no
The following shows sample output from the show cable modulation-profile command for two DOCSIS 2.0 modulation profiles (A-TDMA) on the Cisco uBR10-MC5X20S cable interface line card:
Router# show cable modulation-profile 221
Mod IUC Type Pre Diff FEC FEC Scrmb Max Guard Last Scrmb Pre Pre RS
len enco T k seed B time CW offst Type
221 request qpsk 64 no 0x0 0x10 0x152 0 8 no yes 184 qpsk0 na
221 initial qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk0 na
221 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk0 na
221 short qpsk 72 no 0x5 0x4B 0x152 6 8 yes yes 176 qpsk0 na
221 long qpsk 80 no 0x8 0xDC 0x152 0 8 yes yes 168 qpsk0 na
221 a-short 64qam 128 no 0x5 0x63 0x152 10 20 yes yes 192 qpsk0 no
221 a-long 64qam 128 no 0xF 0xC8 0x152 0 20 yes yes 192 qpsk0 no
Router# show cable modulation-profile 241
Mod IUC Type Pre Diff FEC FEC Scrmb Max Guard Last Scrmb Pre Pre RS
len enco T k seed B time CW offst Type
241 request qpsk 68 no 0x0 0x10 0x152 0 8 no yes 0 qpsk0 no
241 initial qpsk 2 no 0x0 0x10 0x0 0 0 no no 0 qpsk1 no
241 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 0 qpsk0 no
241 a-short 32qam 160 no 0x9 0x4C 0x152 6 8 yes yes 0 qpsk1 no
241 a-long 64qam 132 no 0xC 0xE7 0x152 0 8 yes yes 0 qpsk1 no
241 a-ugs 16qam 80 no 0x3 0xE7 0x152 0 8 yes yes 0 qpsk1 no
The following shows sample output for the upstream option, which displays the modulation profile currently being used by a particular upstream:
Router# show cable modulation-profile cable 4/1 upstream 1
Mod IUC Type Pre Diff FEC FEC Scrmb Max Guard Last Scrmb Pre Pre RS
len enco T k seed B time CW offst Type
41 request qpsk 64 no 0x0 0x10 0x152 0 8 no yes 396 qpsk na
41 initial qpsk 128 no 0x5 0x22 0x152 0 48 no yes 6 qpsk na
41 station qpsk 128 no 0x5 0x22 0x152 0 48 no yes 6 qpsk na
41 short qpsk 88 no 0x5 0x4C 0x152 35 42 yes yes 396 qpsk na
41 long qpsk 76 no 0x6 0xE8 0x152 135 143 yes yes 396 qpsk na
The following example shows typical detailed output for an individual modulation profile that is displayed when using the verbose option. Each IUC is described in detail.
Router# show cable modulation-profile 1 verbose
Modulation Profile Number: 1
Differential Encoding: off
FEC codeword length K bytes: 0x10
Max short burst size B bytes: 0
Guard time size in symbols: 8
Shortened last codeword: no
RS interleaver block size: 0
Modulation Profile Number: 1
IUC: initial maintenance (IUC 3)
Differential Encoding: off
FEC codeword length K bytes: 0x22
Max short burst size B bytes: 0
Guard time size in symbols: 48
Shortened last codeword: no
RS interleaver block size: 0
Modulation Profile Number: 1
IUC: station maintenance (IUC 4)
Differential Encoding: off
FEC codeword length K bytes: 0x22
Max short burst size B bytes: 0
Guard time size in symbols: 48
Shortened last codeword: no
RS interleaver block size: 0
Modulation Profile Number: 1
Differential Encoding: off
FEC codeword length K bytes: 0x4B
Max short burst size B bytes: 6
Guard time size in symbols: 8
Shortened last codeword: yes
RS interleaver block size: 0
Modulation Profile Number: 1
Differential Encoding: off
FEC codeword length K bytes: 0xDC
Max short burst size B bytes: 0
Guard time size in symbols: 8
Shortened last codeword: yes
RS interleaver block size: 0
Table 0-50 describes the significant fields displayed by the show cable modulation-profile command.
.
Table 0-50 show cable modulation-profile Field Descriptions
Field
|
Description
|
Mo
|
Modulation profile group number. A modulation profile group is the set of burst profiles that defines upstream transmit characteristics for the various types of upstream transmission classes.
|
IUC
|
Interval usage code. Each upstream transmit burst belongs to a class that is given a number called the interval usage code (IUC). Bandwidth maps messages (MAP) by IUC codes used to allocate upstream time slots. The following types are currently defined:
• Request—Bandwidth request slot
• Request Data—Bandwidth request and short data burst slot
• Initial Maintenance—Initial link registration contention slot
• Station Maintenance—Link keepalive slot
• Short Data Grant—Short data burst slot
• Long Data Grant—Long data burst slot
|
Type
|
Modulation type.
|
Preamb length
|
Preamble length.
|
Diff enco
|
Differential encoding enabled (yes) or not enabled (no).
|
FEC T bytes
|
Number of bytes that can be corrected for each forward error correction (FEC) code word.
|
FEC CW size
|
Size, in bytes, of the FEC code word.
|
Scrambl seed
|
Scrambler seed value in hex format.
|
Max B size
|
Maximum burst size.
|
Guard time size
|
Time between successive bursts measured in symbols.
|
Last CW short
|
Handling of FEC for shortened last code word.
|
Scrambl
|
Scrambler enabled (yes) or not enabled (no).
|
Preamb offset
|
(DOCSIS 1.0 and DOCSIS 1.1 modulation profiles) The bits to be used for the preamble value.
|
Pre offst
|
(DOCSIS 2.0 modulation profiles) The bits to be used for the preamble value.
|
Pre Type
|
(DOCSIS 2.0 modulation profiles) The A-TDMA preamble type (qpsk0 or qpsk1).
|
RS
|
(DOCSIS 2.0 modulation profiles) The A-TDMA RS encoding type.
|

Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Related Commands
Command
|
Description
|
cable upstream modulation-profile
|
Configures a spectrum group to use a specified frequency.
|
show cable hop
|
Displays CM configuration settings.
|
show interface cable sid
|
Displays cable interface information.
|
show cable multicast authorization
To display the list of defined multicast authorization profiles and all CMs associated with corresponding profiles, use the show cable multicast authorization command in privileged EXEC mode.
show cable multicast authorization {profile-group {profile-group-number | all} profile-list
{profile-number | all} }
Syntax Description
profile-group
|
Displays the profile group.
|
profile-group-number
|
Displays the profile number.
|
all
|
Displays all profile groups.
|
profile-list
|
Displays the profile list.
|
profile-number
|
Displays the profile number.
|
all
|
Displays all profiles.
|
Command Default
No default behavior or values.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCB
|
This command was introduced.
|
12.2(33)SCC
|
The command output was modified to display profile description for the specified profile.
|
Usage Guidelines
Use this command to display all the profile groups, profile descriptions, and CMs associated with the profiles.
Examples
The following command shows all the profile groups and rules associated with it:
Router# show cable multicast authorization profile-group all
------------------------------
Group / Source Prio Action
-------------------------------------------------------------
grp: 224.1.1.1/16 1 permit
grp: 224.1.1.1/16 1 permit
-------------------------------------------------------------
The following command shows a particular profile group and rules associated with it:
Router# show cable multicast authorization profile-group 1
------------------------------
Group / Source Prio Action
-------------------------------------------------------------
grp: 224.1.1.1/16 1 permit
grp: 224.1.1.1/16 1 permit
-------------------------------------------------------------
The following command shows all the profiles and their profile descriptions, and the session rules for each profile.
Router# show cable multicast authorization profile-list all
CMTS Authorization Profile List
-------------------------------
Profile-Index: 0 Name: prof1
Id Group / Source Prio Action
------------------------------------------------------------------------
1 grp: FF15::1/64 1 permit
2 grp: FF15::1/64 1 permit
3 grp: 224.1.1.1/16 1 permit
4 grp: FF16::1/64 1 permit
5 grp: 224.1.1.1/16 1 permit
------------------------------------------------------------------------
Profile-Index: 1 Name: prof2
Id Group / Source Prio Action
------------------------------------------------------------------------
------------------------------------------------------------------------
Profile-Index: 2 Name: prof3
Id Group / Source Prio Action
------------------------------------------------------------------------
------------------------------------------------------------------------
The following command shows a particular profile and its description.
Router# show cable multicast authorization profile-list 3
CMTS Authorization Profile List
-------------------------------
Profile-Index: 3 Name: gold
Profile Description: gold profile for higher bandwidth
Id Group / Source Prio Action
------------------------------------------------------------------------
------------------------------------------------------------------------
Table 38 describes the significant fields shown in the display.
Table 51 show cable multicast authorization Field Descriptions
Field
|
Description
|
Profile-Group Index
|
Displays the profile group index.
|
Name
|
Displays the name of the profile group.
|
Profile Description
|
Displays the description given to the profile.
|
ProfileId
|
Displays the QoS profile being used.
|
CMs
|
Displays the CMs belonging to the profile.
|
Profile
|
Displays the profile being used for multicast.
|
Session-Rule List
|
Displays the list of session rules being used for the multicast.
|
Source (src)
|
Displays the source IP address.
|
Group (grp)
|
Displays the group IP address.
|
Priority
|
Displays the rule priority value.
|
Action
|
Displays the action taken for multicast.
|
Related Commands
Command
|
Description
|
cable multicast auth enable default-action
|
Configures cable multicast authorization profile and sets the maximum sessions limit.
|
cable multicast auth profile-name
|
Configures cable multicast authorization profile.
|
profile description
|
Configures profile descriptions for each profile in the selected cable multicast authorization profile.
|
show cable multicast db
|
Displays the contents of multicast explicit tracking database.
|
show cable multicast dsid
|
Displays the entire DSID database content.
|
show cable multicast qos
|
Displays the configuration information for MQoS, (Group-Config, Group-QoS-Config, Group-Encryption-Config).
|
show cable multicast db
To display the contents of the multicast explicit tracking database, use the show cable multicast db command in privileged EXEC mode.
show cable multicast db [bundle bundle-interface [ipv4-address | ipv6-address | summary] |
cm-mac [host-mac-add | hosts | proxy] | summary | client pcmm] | [detail]
Syntax Description
bundle bundle-interface
|
(Optional) Displays the bundle interface.
For example, Bundle 10.
|
ipv4-address
|
(Optional) IPv4 address.
|
ipv6-address
|
(Optional) IPv6 address of the group that should be matched using the format X:X:X:X:X.
|
cm-mac
|
(Optional) MAC address of the cable modem.
|
host-mac-add
|
(Optional) Host MAC address.
|
hosts
|
(Optional) Displays host details.
|
proxy
|
(Optional) Displays proxy details.
|
summary
|
(Optional) Displays the bundle interface summary or the multicast explicit tracking database summary.
|
client
|
(Optional) Displays entries by the client type.
|
pcmm
|
(Optional) Displays all PacketCable multimedia (PCMM) client entries.
|
detail
|
(Optional) Displays additional information related to the multicast explicit tracking database.
|
Command Default
None
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCB
|
This command was introduced.
|
12.2(33)SCE
|
This command was modified. The following two keywords were added to this command:
• client
• pcmm
|
12.2(33)SCF
|
This command was modified. A new keyword, detail, was added to provide additional information related to the multicast explicit tracking database.
|
Usage Guidelines
Starting with Cisco IOS Release 12.2(33)SCF:
•
There is an Explicit Tracking Database (ETDB) entry for each static multicast configuration.
•
The total number of replications supported on each chassis is restricted to a maximum of 5000 replications.
•
The total number of replications corresponding to static multicast is restricted to a maximum of 1500 replications.
•
The show cable multicast db detail command is not applicable for ETDB entries created by the static TLV.
Examples
The following is a sample output from the show cable multicast db command:
Router# show cable multicast db
Session (S,G) : (*,230.1.1.1)
Fwd Intfc Sub Intfc Host Intfc CM Mac Hosts
w1/0/0:0 aaaa.bbbb.cccc 2
w1/0/0:0 aaaa.bbbb.cccc 2
Session (S,G) : (255.255.255.255,255.255.255.255)
Fwd Intfc Sub Intfc Host Intfc CM Mac Hosts
w1/0/0:0 aabb.bbcc.ccdd 3
Session (S,G) : (*,230.1.1.1)
Fwd Intfc Sub Intfc Host Intfc CM Mac Hosts
w1/0/0:0 aaaa.bbbb.cccc 2
w1/0/0:0 aaaa.bbbb.cccc 2
Session (S,G) : (255.255.255.255,255.255.255.255)
Fwd Intfc Sub Intfc Host Intfc CM Mac Hosts
w1/0/0:0 aabb.bbcc.ccdd 3
The following is a sample output from the show cable multicast db summary command:
Router# show cable multicast db summary
Interface Session Count CM Count
The following is a sample output from the show cable multicast db bundle bundle-interface command:
Router# show cable multicast db bundle 1
Session (S,G) : (*,230.1.2.3)
Fwd Intfc Sub Intfc Host Intfc CM Mac Hosts
Wi1/1/0:0 Bundle1 Ca5/0/0 ff01.0001.0000 1
Session (S,G) : (20.1.1.1,232.1.1.1)
Fwd Intfc Sub Intfc Host Intfc CM Mac Hosts
Wi1/1/0:0 Bundle1 Ca5/0/0 ff01.0001.0000 1
The following is a sample output from the show cable multicast db bundle bundle-interface summary command:
Router# show cable multicast db bundle 1 summary
Interface Session Count CM Count
The following is a sample output from the show cable multicast db bundle bundle-interface ipv4-address command:
Router# show cable multicast db bundle 1 225.0.0.1
Session (S,G) : (*,225.0.0.1)
Fwd Intfc Sub Intfc Host Intfc CM Mac Hosts
Wi5/1:0 Bundle1 Ca5/1 001e.6bfb.29a6 1
The following is a sample output from the show cable multicast db bundle bundle-interface ipv6-address command:
Router# show cable multicast db bundle1 ff15::1
Session (S,G) : (*,FF15::1)
Fwd Intfc Sub Intfc Host Intfc CM Mac Hosts
In5/1:0 Bundle1 Ca5/1 001e.6bfb.29a6 1
The following is a sample output from the show cable multicast db cm-mac command:
Router# show cable multicast db 000f.66f9.aa73
Session (S,G) : (*,230.1.1.1)
Fwd Intfc Sub Intfc Host Intfc Hosts Proxy Static
Session (S,G) : (*,230.1.1.1)
Fwd Intfc Sub Intfc Host Intfc Hosts Proxy Static
The following is a sample output from the show cable multicast db cm-mac host-mac-add command:
Router# show cable multicast db aaaa.bbbb.cccc 000f.66f9.aa73
Bundle Interface : Bundle1
Host mac : aaaa.bbbb.cccc
Session (S,G) : (*,230.1.1.1)
Bundle Interface : Bundle1
Host mac : aaaa.bbbb.cccc
Session (S,G) : (*,230.1.1.1)
The following is a sample output from the show cable multicast db cm-mac hosts command:
Router# show cable multicast db aaaa.bbbb.cccc hosts
Session (S,G) : (*,230.1.1.1)
Fwd Intfc Sub Intfc Host Intfc Host Mac Proxy
w1/0/0:0 aaaa.bbbb.cccc Y
Session (S,G) : (255.255.255.255,255.255.255.255)
Fwd Intfc Sub Intfc Host Intfc Host Mac Proxy
w1/0/0:0 aabb.bbcc.ccdd N
The following is a sample output from the show cable multicast db cm-mac proxy command:
Router# show cable multicast db aaaa.bbbb.cccc proxy
Bundle Interface : Bundle1
Host mac : aaaa.bbbb.cccc
Session (S,G) : (*,230.1.1.1)
Bundle Interface : Bundle1
Host mac : aaaa.bbbb.cccc
Session (S,G) : (*,230.1.1.1)
The following is a sample output from the show cable multicast db command that displays all the available PCMM client entries on a Cisco CMTS router:
Router# show cable multicast db client pcmm
Session (S,G) : (*,229.2.2.12)
Fwd Intf Bundle Intf Host Intf CM MAC CPE IP Gate-ID SFID
Wi1/1/0:0 Bundle1 Ca5/0/0 0018.6852.8056 60.1.1.202 134 4
The following is a sample output from the show cable multicast db command with the detail keyword in Cisco IOS Release 12.2(33)SCF:
Router# show cable multicast db detail
Interface Fwd Intfc group source
Bundle1 Wi7/0/0:0 230.1.2.4 N/A
ETDB received IGMP ETDB processed IGMP
Nov 25 08:42:36.643 Nov 25 08:42:36.643
Sid gc_id Stat Index DSID Stat Index Allocated
DEFAULT N/A 61330 0xCF25C Nov 25 08:42:36.643
8201 1 61331 0xCF25C Nov 25 08:42:36.643
Interface Fwd Intfc group source
Bundle1 Wi7/0/0:0 230.1.2.3 N/A
ETDB received IGMP ETDB processed IGMP
Nov 25 08:42:22.339 Nov 25 08:42:22.339
Sid gc_id Stat Index DSID Stat Index Allocated
DEFAULT N/A 61328 0xCF25B Nov 25 08:42:22.339
8201 1 61329 0xCF25B Nov 25 08:42:22.339
The following is a sample output from the show cable multicast db command with the detail keyword that provides multicast explicit tracking database information for a particular bundle interface in Cisco IOS Release 12.2(33)SCF:
Router# show cable multicast db bundle 1 detail
Interface Fwd Intfc group source
Bundle1 Wi7/0/0:0 230.1.2.4 N/A
ETDB received IGMP ETDB processed IGMP
Nov 25 08:42:36.643 Nov 25 08:42:36.643
Sid gc_id Stat Index DSID Stat Index Allocated
DEFAULT N/A 61330 0xCF25C Nov 25 08:42:36.643
8201 1 61331 0xCF25C Nov 25 08:42:36.643
Interface Fwd Intfc group source
Bundle1 Wi7/0/0:0 230.1.2.3 N/A
ETDB received IGMP ETDB processed IGMP
Nov 25 08:42:22.339 Nov 25 08:42:22.339
Sid gc_id Stat Index DSID Stat Index Allocated
DEFAULT N/A 61328 0xCF25B Nov 25 08:42:22.339
8201 1 61329 0xCF25B Nov 25 08:42:22.339
The following is a sample output from the show cable multicast db command with the detail keyword that provides multicast explicit tracking database information for a particular bundle interface based on its host MAC address in Cisco IOS Release 12.2(33)SCF:
Router# show cable multicast db bundle 1 230.1.2.4 detail
Interface Fwd Intfc group source
Bundle1 Wi7/0/0:0 230.1.2.4 N/A
ETDB received IGMP ETDB processed IGMP
Nov 25 08:42:36.643 Nov 25 08:42:36.643
Sid gc_id Stat Index DSID Stat Index Allocated
DEFAULT N/A 61330 0xCF25C Nov 25 08:42:36.643
8201 1 61331 0xCF25C Nov 25 08:42:36.643
The following is a sample output from the show cable multicast db command with the detail keyword that provides multicast explicit tracking database information based on its cable modem MAC address in Cisco IOS Release 12.2(33)SCF:
Router# show cable multicast db 0019.474a.d516 detail
Interface Fwd Intfc group source
Bundle1 Wi7/0/0:0 230.1.2.3 N/A
ETDB received IGMP ETDB processed IGMP
Nov 25 08:42:22.339 Nov 25 08:42:22.339
Sid gc_id Stat Index DSID Stat Index Allocated
DEFAULT N/A 61328 0xCF25B Nov 25 08:42:22.339
8201 1 61329 0xCF25B Nov 25 08:42:22.339
Interface Fwd Intfc group source
Bundle1 Wi7/0/0:0 230.1.2.4 N/A
ETDB received IGMP ETDB processed IGMP
Nov 25 08:42:36.643 Nov 25 08:42:36.643
Sid gc_id Stat Index DSID Stat Index Allocated
DEFAULT N/A 61330 0xCF25C Nov 25 08:42:36.643
8201 1 61331 0xCF25C Nov 25 08:42:36.643
Table 52 describes the significant fields shown in the show cable multicast db command display.
Table 52 show cable multicast db Field Descriptions
Field
|
Description
|
Bundle Interface
|
Bundle interface number.
|
CM Mac
|
MAC address of the CM.
|
Host Mac
|
Host MAC address.
|
Fwd Intfc
|
Forwarding interface name.
|
Sub Intfc
|
Sub-interface name.
|
Host Intfc
|
Host interface name.
|
IGMP/MLD Ver
|
IPv4 or IPv6 multicast group signaling protocols.
IPv4: IGMPv1/v2/v3
IPv6: MLDv1/v2
|
TimeStamp Delta
|
Timestamp of the session.
|
Hosts
|
Hosts behind the CM.
|
CPE IP
|
IP address of the CPE.
|
Gate-ID
|
Unique number identifying the local PCMM multicast gate.
|
SFID
|
Service flow ID (SFID) for the downstream associated with this PCMM multicast gate.
|
Related Commands
Command
|
Description
|
show cable multicast authorization
|
Displays the list of defined multicast authorization profiles and all cable modems associated with the corresponding profiles.
|
show cable multicast dsid
|
Displays the entire multicast downstream service identifier (DSID) database content.
|
show cable multicast qos
|
Displays the configuration information of the MQoS (Group-Config, Group-QoS-Config, Group-Encryption-Config).
|
show packetcable gate multimedia
|
Displays the information about the total number of PCMM multicast gates.
|
show cable multicast debug
To display information about debug counters, use the show cable multicast debug command in privileged EXEC mode.
show cable multicast debug [etdb [multicast-group-address | mac-address]]
Syntax Description
etdb
|
(Optional) Displays information about multicast explicit tracking database debug counters.
|
multicast-group-address
|
(Optional) IP address of the multicast group.
|
mac-address
|
(Optional) MAC address of the cable modem.
|
Command Default
None
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCE
|
This command was introduced.
|
Usage Guidelines
The show cable multicast debug command provides information only about the explicit tracking database counter in Cisco IOS Release 12.2(33)SCE and later. This means that the command output does not include other debug counters such as multicast authorization and multicast quality of service (QoS).
If you want to verify multicast group specific or MAC specific debug counters, you must turn on debugging of multicast counters using the debug cable multicast counter start command before using the show cable multicast debug command.
Note
The command output will be the same if you run the show cable multicast debug command with or without the keyword etdb in Cisco IOS Release 12.2(33)SCE, because this command does not support any other debug counters in Cisco IOS Release 12.2(33)SCE.
Examples
The following is a sample output of the show cable multicast debug command that displays information about multicast explicit tracking database debug counters on the Cisco uBR10012 router:
Router# show cable multicast debug
et_post_ses_intfc_update 3
et_post_ses_intfc_delete 0
The following is a sample output of the show cable multicast debug command that displays information about multicast explicit tracking database debug counters based on a particular multicast group:
Router# show cable multicast debug etdb 230.1.1.1
et_post_ses_intfc_update 3
et_post_ses_intfc_delete 0
The following is a sample output of the show cable multicast debug command that displays information about multicast explicit tracking database debug counters based on a particular cable modem:
Router# show cable multicast debug etdb 001a.c3ff.d41a
et_post_ses_intfc_update 2
Table 5 describes the major fields shown in the show depi command display:
Table 53 show cable multicast debug Field Descriptions
Field
|
Description
|
ETDB
|
Multicast explicit tracking database
|
counter
|
Debug counters for the multicast operation.
|
value
|
Debug counter values.
|
ETDB GROUP
|
Identifies a particular multicast group for explicit tracking database debug counters.
|
ETDB CM
|
Identifies a particular cable modem for explicit tracking database debug counters.
|
Related Commands
Command
|
Description
|
debug cable multicast counter clear
|
Resets debugging of multicast counters.
|
debug cable multicast counter start
|
The Cisco CMTS router starts collecting multicast debug counters based on a particular multicast group or a cable modem.
|
debug cable multicast counter stop
|
The Cisco CMTS router stops collecting multicast debug counters.
|
show cable multicast dsid
To display the entire multicast downstream service identifier (DSID) database content, use the show cable multicast dsid command in privileged EXEC mode.
Cisco uBR7246VXR and Cisco uBR7225VXR Routers
show cable multicast dsid [dsid | ip-address [source-ip] | integrated-cable
slot/port:integrated-channel {dynamic | static}| wideband-cable slot/port:wideband-channel
{dynamic} | ipv6-address]
Cisco uBR10012 Router
show cable multicast dsid [dsid | ip-address [source-ip] | integrated-cable
slot/sub-slot/port:integrated-channel {dynamic | static}| wideband-cable
slot/bay/port:wideband-channel {dynamic | static} | ipv6-address]
Syntax Description
dsid
|
(Optional) Downstream service identifier.
|
ip-address
|
(Optional) IP address of the group.
|
source-ip
|
(Optional) IP address of the source.
|
integrated-cable slot/sub-slot/port:integrated-channel
|
(Optional) Identifies the cable interface on the router for which information should be displayed. The valid values are:
• slot—0 to 8 on the Cisco uBR10012 router, 3 to 6 on the Cisco uBR7246VXR router, and 1 or 2 on the Cisco uBR7225VXR router.
• sub-slot—0 or 1
• port—0 to 4 on the Cisco uBR10012 router and 0 or 1 on the Cisco uBR7246VXR and Cisco uBR7225VXR routers.
• integrated-channel—0 to 3
|
wideband-cable slot/bay/port:wideband-channel
|
(Optional) Identifies the wideband interface on the router for which information should be displayed. The valid values are:
• slot—0 to 8 on the Cisco uBR10012 router, 3 to 6 on the Cisco uBR7246VXR router, and 1 or 2 on the Cisco uBR7225VXR router.
• bay—0 or 1
• port—0 to 4 on the Cisco uBR10012 router and 0 or 1 on the Cisco uBR7246VXR and Cisco uBR7225VXR routers.
• wideband-channel—0 to 5
|
dynamic
|
Identifies the dynamic DSIDs.
|
static
|
Identifies the static DSIDs.
|
ipv6-address
|
IPv6 address of the group that should be matched using the format X:X:X:X::X.
|
Command Default
None
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCB
|
This command was introduced.
|
12.2(33)SCC
|
This command was modified to display all the SIP and SPA indexes assigned for a multicast session.
|
12.2(33)SCD
|
This command was modified. Support for Cisco uBR7246VXR and Cisco uBR7225VXR routers were added. Two new keywords, dynamic and static, were added to this command.
|
Usage Guidelines
Use this command to display the DSID database content and SIP and SPA indexes assigned for a multicast session.
Examples
The following example shows a sample output for the show cable multicast dsid command:
Router# show cable multicast dsid
Multicast Group : 230.1.2.3
IDB : Bu2 Interface: Mo1/1/0:0 Dsid: 0x1F078
StatIndex : 2 SAID: DEFAULT
Multicast Group : 230.1.2.3
IDB : Bu2 Interface: Mo1/1/0:0 Dsid: 0x1F078
Multicast Group : 230.1.2.3
IDB : Bu2 Interface: Mo1/1/0:0 Dsid: 0x1F078
Example of the show cable multicast dsid ip-address Command Output That Shows the DSID Entry With Matching Multicast Session for the Cisco uBR7246VXR and Cisco uBR7225VXR routers in Cisco IOS Release 12.2(33)SCD
The following example shows a sample output for the show cable multicast dsid ip-address [source-ip] command:
Router# show cable multicast dsid 225.0.0.1
Multicast Group : 225.0.0.1
IDB : Bu1 Interface: Wi5/0:0 Dsid: 0x5F078
StatIndex : 7 SAID : DEFAULT
Multicast Group : 225.0.0.1
IDB : Bu1 Interface: Wi5/0:0 Dsid: 0x5F078
StatIndex : 8 SAID : 8195 GC : 1
Example of the show cable multicast dsid wideband-Cable Command Output That Displays the Dynamic or Preallocated Static DSID Created on a Particular Interface for the Cisco uBR7246VXR and Cisco uBR7225VXR routers in Cisco IOS Release 12.2(33)SCD
The following example shows a sample output for the show cable multicast dsid wideband-Cable [dynamic | static] command:
Router# show cable multicast dsid wideband-Cable 5/0:0 dynamic
Multicast Group : 225.0.0.1
IDB : Bu1 Interface: Wi5/0:0 Dsid: 0x5F078
StatIndex : 7 SAID : DEFAULT
Multicast Group : 225.0.0.1
IDB : Bu1 Interface: Wi5/0:0 Dsid: 0x5F078
StatIndex : 8 SAID : 8195 GC : 1
Multicast Group : 225.0.0.2
IDB : Bu1 Interface: Wi5/0:0 Dsid: 0x5F079
StatIndex : 9 SAID : DEFAULT
Multicast Group : 225.0.0.2
IDB : Bu1 Interface: Wi5/0:0 Dsid: 0x5F079
StatIndex : 10 SAID : 8196 GC : 1
Example of the show cable multicast dsid integrated-Cable Command Output That Displays the Dynamic DSID Created on a Particular Interface for the Cisco uBR7246VXR and Cisco uBR7225VXR routers in Cisco IOS Release 12.2(33)SCD
The following example shows a sample output for the show cable multicast dsid integrated-Cable static command:
Router# show cable multicast dsid integrated-Cable 5/0:0 static
Table 54 describes the significant fields shown in the show cable multicast dsid command display.
Table 54 show cable multicast dsid Field Descriptions
Field
|
Description
|
Multicast Group
|
Multicast group.
|
Source
|
Source IP address.
|
IDB
|
Interface description block number.
|
Interface
|
Interface name.
|
Dsid
|
Downstream service identifier.
|
StatIndex
|
Blaze indexes assigned for a multicast session.
|
SAID
|
Security Association Identifier.
|
Related Commands
Command
|
Description
|
show cable multicast authorization
|
Displays the list of defined multicast authorization profiles and all CMs associated with corresponding profiles.
|
show cable multicast db
|
Displays the multicast explicit tracking database content.
|
show cable multicast qos
|
Displays the configuration information for MQoS (Group-Config, Group-QoS-Config, Group-Encryption-Config).
|
show cable multicast qos
To display the configuration information for multicast quality of service (MQoS), use the show cable multicast qos command in privileged EXEC mode.
show cable multicast qos {group-config [group-config-index] | group-encryption
[group-encryption-index] | group-qos [group-qos-index]}
Syntax Description
group-config
|
Displays multicast group configuration information.
|
group-config-index
|
(Optional) Index for the multicast group. The valid range is from 1 to 2048.
|
group-encryption
|
Displays multicast group encryption information.
|
group-encryption-index
|
(Optional) Index for the multicast group encryption.
|
group-qos
|
Displays multicast group QoS information.
|
group-qos-index
|
(Optional) Index for the multicast group QoS.
|
Command Default
None
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCB
|
This command was introduced.
|
12.2(33)SCC
|
The command output was modified to display the application ID for default multicast group QoS configuration.
|
12.2(33)SCE
|
The command output was modified to list the PCMM application for multimedia multicast configuration.
|
Examples
Example of the show cable multicast qos Command Output for Multicast Group Configuration
The following example shows a sample output of the show cable multicast qos command that displays multicast group configuration information:
Router# show cable multicast qos group-config
Default Multicast Group-Qos Application ID 65535
Multiast Group Config 1 : Priority 1
Session Range - Group Prefix 230.0.0.0 Mask 255.0.0.0 Source Prefix 0.0.0.0 Mask 0.0.0.0
Example of the show cable multicast qos Command Output for Multicast Group Encryption
The following example shows a sample output of the show cable multicast qos command that displays multicast group encryption information:
Router# show cable multicast qos group-encryption
Multicast Group Encryption 1 : Algorithm 56bit-des
Multicast Group Encryption 2 : Algorithm 128bit-aes
Example of the show cable multicast qos Command Output for Multicast Group QoS
The following example shows a sample output of the show cable multicast qos command that displays multicast group QoS information in Cisco IOS Release 12.2(33)SCC:
Router# show cable multicast qos group-qos
Group QOS Index Service Class Control Igmp Limit Override
DEFAULT MQOS_DEFAULT Aggregate NO-LIMIT 1 MQOS Aggregate NO-LIMIT
The following example shows a sample output of the show cable multicast qos command that displays multicast group QoS information including the application (the App field) for multimedia multicast configuration in Cisco IOS Release 12.2(33)SCE:
Router# show cable multicast qos group-qos
Group QOS Index Service Class Control Igmp Limit Override App
DEFAULT mcast_default Aggregate NO-LIMIT
1 SDV_SD Single --- No CLI
512 SDV_HD Single --- No PCMM
Table 38 describes the significant fields shown in the display.
Table 55 show cable multicast qos Field Descriptions
Field
|
Description
|
Group
|
Identifies the multicast group.
|
QOS
|
Identifies the QoS profile that is being enforced.
|
Index
|
Index number of the QoS group.
|
Service Class
|
Identifies the service class being used for the multicast.
|
Control
|
Identifies the type of control.
|
Igmp Limit
|
Displays the Internet Group Management Protocol (IGMP) session limit for aggregate service flows.
|
Override
|
Displays the additional IGMP session admitted and forwarded as best effort traffic.
|
App
|
Displays the application used for multimedia multicast.
|
Related Commands
Command
|
Description
|
show cable multicast authorization
|
Displays the list of defined multicast authorization profiles and all CMs associated with corresponding profiles.
|
show cable multicast db
|
Displays the contents of multicast explicit tracking database.
|
show cable multicast dsid
|
Displays the entire Downstream Service Identifier (DSID) database content.
|
show cable multicast statistics failure
To display the multicast statistics failure details, use the show cable multicast statistics command in global configuration mode.
show cable multicast statistics failure
Command Default
Information for all multicast statistics failure is displayed.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCF
|
This command was introduced.
|
Usage Guidelines
The show cable multicast statistics failure command displays information about admission control failure and PXF queue failure.
Examples
The following is a sample output from the show cable multicast statistics failure command:
Router# show cable multicast statistics failure
Admission Control Failure 0
Related Commands
Command
|
Description
|
show cable multicast db
|
Displays the contents of the multicast explicit tracking database.
|
clear cable multicast statistics counter
|
Clears all multicast statistics counters.
|
show cable noise
To display cable noise statistics on a Cisco CMTS, use the show cable noise command in EXEC mode.
show cable {slot/port | slot/subslot/port} noise
Syntax Description
slot/port
|
Identifies the cable interface and downstream port on the Cisco uBR7100 series and Cisco uBR7200 series routers.
On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
|
slot/subslot/port
|
Identifies the cable interface on the Cisco uBR10012 router. The following are the valid values:
• slot = 5 to 8
• subslot = 0 or 1
• port = 0 to 4 (depending on the cable interface)
|
Command Modes
EXEC
Command History
Release
|
Modification
|
12.0(4)XI
|
This command was introduced.
|
12.1(3a)EC1
|
This command was removed from the 12.1 EC release.
|
Usage Guidelines
This command is not supported on Cisco IOS Release 12.1(3a)EC1 or later releases.
Examples
The following example shows how to display CM noise statistics:
Router# show cable 6/0 noise
Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Related Commands
Command
|
Description
|
show cable modem
|
Displays CM configuration settings.
|
show cable privacy
To display Baseline Privacy Interface Plus (BPI+) certificate information and the security or privacy information for the Cisco CMTS router, use the show cable privacy command in privileged EXEC mode.
show cable privacy {eae-exclude | hotlist {cm} | manufacturer-cert-list | root-cert-list}
Syntax Description
eae-exclude
|
Displays the early authentication and encryption (EAE) details.
|
hotlist {cm}
|
Displays a list of cable modems detected as clones.
|
manufacturer-cert-list
|
Displays the BPI manufacturer certificate verification list.
|
root-cert-list
|
Displays the BPI root certificate verification list.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
11.3 NA
|
This command was introduced in a different form and its functions moved to the show interface cable privacy command.
|
12.2(4)BC1
|
This command was introduced in its current form.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA.
|
12.2(33)SCC
|
This command was modified. The eae-exclude keyword was added.
|
12.2(33)SCE
|
This command was modified. The hotlist keyword was added.
|
Usage Guidelines
The show cable privacy command is available only in IOS images that support BPI and BPI+ encryption.
Examples
The following is a sample output of the show cable privacy command with the eae-exclude keyword that lists the cable modems excluded from the early authentication and encryption process:
Router# show cable privacy eae-exclude
MAC: 1111.1111.1111 Mask: ffff.ffff.ffff
MAC: 2222.2222.2222 Mask: ffff.ffff.ffff
The following is a sample output of the show cable privacy command with the hotlist keyword that lists the permanent and temporary hotlist entries:
Router# show cable privacy hotlist cm
MAC Address Last Ranged Type Interface
0025.2eaf.6f16 Dec 13 21:03:56 Permanent C8/1/0
0025.2eaf.6f26 Dec 13 21:03:56 Temporary C5/1/0
Table 56 describes the significant fields shown in the show cable privacy command display:
Table 56 show cable privacy Command Field Description
Field
|
Description
|
MAC Address
|
MAC address of the cable modem that is on the hotlist.
|
Last Ranged On
|
Displays the time stamp when the cable modem last attempted registration on that interface. This value helps gauge the frequency with which the MAC address is attempting to be cloned, and manage the hotlist accordingly.
|
Type
|
• Permanent—The cable modem entry can be configured as a permanent clone from the CLI by executing the cable privacy hotlist cable modem command. A cable modem marked as a permanent clone can only be removed from the hotlist by executing the no form of the cable privacy hotlist cable modem command.
• Temporary—The Cisco CMTS detects a duplicate cable modem MAC address. This duplicate MAC address is flagged as a clone and is prevented from coming online for 180 seconds.
|
Related Commands
Command
|
Description
|
cable privacy add-certificate
|
Configures certificates for BPI+ encryption.
|
cable privacy
|
Enables and configures BPI+ encryption on a cable interface.
|
show cable modem
|
Displays cable modem configuration settings.
|
show interface cable privacy
|
Displays baseline privacy information.
|
show cable qos enforce-rule
To display the quality of service (QoS) enforce-rules that are currently defined, use the show cable qos enforce-rule command in privileged EXEC mode.
show cable qos enforce-rule [name] [verbose]
Syntax Description
name
|
(Optional) Specifies the name of a particular enforce-rule to be displayed.
|
verbose
|
(Optional) Displays detailed information about the QoS enforce-rule options that are currently defined.
|
Command Default
All enforce-rules are displayed.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(15)BC1
|
This command was introduced.
|
12.3(9a)BC
|
This command was integrated into Cisco IOS Release 12.3(9a)BC.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.
|
12.3(23)BC2
|
The following new output fields were added for the verbose form of the command: Penalty End-time, Weekend First Peak Time, Weekend First Duration, Weekend First Average-rate, Weekend Second Peak Time, Weekend Second Duration, Weekend Second Average rate, Weekend Offpeak Duration, Weekend Offpeak Average-rate, and Weekend Auto-enforce.
|
12.3(23)SCD1
|
The following new output fields were added for the verbose form of the command: Monitoring after RelTime, Penalty-Period for week-days, Penalty-Period for week-ends.
The following output fields were modified for the verbose form of the command: Penalty End-time, First Peak Time, Second Peak Time, Weekend First Peak Time, Weekend Second Peak Time.
The output field Penalty End-time was renamed as Default Penalty Duration.
|
Examples
The following example shows typical output for the default version of the show cable qos enforce-rule command:
Router# show cable qos enforce-rule
Name Dur Dir byte-cnt Auto rate penalty Reg Enf Ena Persist
(min) (kbytes) enf (min) (min) QoS QoS
residential 10 us 5 act 1 10080 5 10 Yes Yes
ef-q11d 30 ds 150 act 1 20 11 99 Yes Yes
ef-q11u 30 us 60 act 1 20 11 99 Yes Yes
ef-q21 720 us 60 act 1 10 21 81 Yes Yes
ef-q21d 300 ds 150 act 1 10 21 81 Yes Yes
ef-q22 720 us 60 act 1 10 22 82 Yes Yes
ef-q22d 300 ds 150 act 1 10 22 82 Yes No
ef-q23 720 us 60 act 1 10 23 83 Yes Yes
ef-q23d 300 ds 150 act 1 10 23 83 Yes Yes
ef-q24 720 us 60 act 1 10 24 84 Yes Yes
ef-q24d 300 ds 150 act 1 10 24 84 Yes Yes
ef-q25 720 us 60 act 1 10 25 85 Yes Yes
ef-q25d 300 ds 150 act 1 10 25 85 Yes Yes
ef-q26 720 us 60 act 1 10 26 86 Yes Yes
ef-q26d 300 ds 150 act 1 10 26 86 Yes Yes
ef-q27 720 us 60 act 1 10 27 87 Yes Yes
ef-q27d 300 ds 150 act 1 10 27 87 Yes Yes
ef-q28 720 us 60 act 1 10 28 88 Yes Yes
ef-q28d 300 ds 150 act 1 10 28 88 Yes No
ef-q5d 300 ds 150 act 1 10 5 99 Yes Yes
ef-q5u 720 us 600 act 1 10 5 99 Yes Yes
The following example shows sample output from the show cable qos enforce-rule command for a particular enforce-rule named "residential":
Router# show cable qos enforce-rule residential
Name Dur Dir byte-cnt Auto rate penalty Reg Enf Ena Persist
(min) (kbytes) enf (min) (min) QoS QoS
residential 10 us 5 act 1 10080 5 10 Yes Yes
Table 57 describes the significant fields displayed by the show cable qos enforce-rule command.
.
Table 57 show cable qos enforce-rule Field Descriptions
Field
|
Description
|
Name
|
Name of the enforce-rule.
|
Dur (min)
|
The monitoring duration period, in minutes.
|
Dir
|
Direction in which the byte-count is applied:
• DS—Downstream direction
• US—Upstream direction
|
byte-cnt (kbytes)
|
Maximum number of bytes, in kilobytes, that subscribers using this enforce-rule can transmit during the monitoring-duration window before being considered to be overconsuming.
|
Auto enf
|
Displays whether the enforce-rule QoS profile is automatically activated when a subscriber exceeds their allowed bandwidth.
|
rate (min)
|
Size of the sample-rate interval, in minutes.
|
penalty (min)
|
Size of the penalty period, in minutes.
|
Reg QoS
|
Profile ID for the registered QoS profile or the name of the service class.
|
Enf QoS
|
Profile ID for the enforced QoS profile or the name of the service class.
|
Ena
|
Displays whether this enforce-rule is currently enabled and active.
|
Persist
|
Displays whether this enforce-rule keeps the enforced QoS profile in force across cable modem reboots:
• Yes—Enforced QoS profiles remain in effect across cable modem reboots.
• No—Enforced QoS profiles do not remain in effect when a cable modem reboots. See the no-persistence option for the qos-profile enforced command.
|
The following example shows the sample output from the show cable qos enforce-rule verbose form of the command with the new output fields beginning in Cisco IOS Release 12.3(23)BC2:
Monitoring Type : peak-offpeak
Monitoring Duration : 120 (in minutes)
Sample-rate : 10 (in minutes)
Average-rate : 1 kbits/sec
Penalty Time : 10080 (in minutes)
Penalty End-time : 23 (time of day in hrs)
Duration : 180 (in minutes)
First Average-rate : 2 kbits/sec
Duration : 240 (in minutes)
Second Averate-rate : 3 kbits/sec
Offpeak Duration : 120 (in minutes)
Offpeak Average-rate : 1 kbits/sec
Weekend First Peak Time : 8
Weekend First Duration : 120 (in minutes)
Weekend First Average-rate : 2 kbits/sec
Weekend Second Peak Time : 18
Weekend Second Duration : 180 (in minutes)
Weekend Second Average-rate : 5 kbits/sec
Weekend Offpeak Duration : 240 (in minutes)
Weekend Offpeak Average-rate : 4 kbits/sec
Weekend Auto-enforce : active
The following example shows the sample output from the show cable qos enforce-rule verbose form of the command with the new output fields in Cisco IOS Release 12.3(33)SCD2:
Router# show cable qos enforce-rule test verbose
Monitoring Type : peak-offpeak
Monitoring Duration : 70 (in minutes)
Sample-rate : 10 (in minutes)
Average-rate : 3 kbits/sec
Current Penalty Duration : 10 (in minutes)
Default Penalty Duration : 10 (in minutes)
Penalty End-time : 23:0 (time of day)
Monitoring after RelTime : Off
Duration : 60 (in minutes)
First Average-rate : 1 kbits/sec
Duration : 65 (in minutes)
Second Average-rate : 2 kbits/sec
Offpeak Duration : 70 (in minutes)
Offpeak Average-rate : 3 kbits/sec
Penalty-Period for week-days : 0
Weekend First Peak Time : 11:0
Weekend Duration : 75 (in minutes)
Weekend First Average-rate : 4 kbits/sec
Weekend Second Peak Time : 20:0
Weekend Duration : 80 (in minutes)
Weekend Second Average-rate : 5 kbits/sec
Weekend Offpeak Duration : 85 (in minutes)
Weekend Offpeak Average-rate : 6 kbits/sec
Weekend Auto Enforce : Yes
Penalty-Period for week-ends : 0
Related Commands
Command
|
Description
|
cable qos enforce-rule
|
Creates an enforce-rule to enforce a particular QoS profile for subscriber traffic management and enters enforce-rule configuration mode.
|
duration
|
Specifies the time period and sample rate to be used for monitoring subscribers.
|
enabled (enforce-rule)
|
Activates an enforce-rule and begins subscriber traffic management on a Cisco CMTS router.
|
penalty-period
|
Specifies the time period that an enforced QoS profile should be in effect for subscribers that violate their registered QoS profiles.
|
qos-profile enforced
|
Specifies a QoS profile that should be enforced when users violate their registered QoS profiles. This command is applicable for only DOCSIS 1.0 cable modems.
|
qos-profile registered
|
Specifies the registered QoS profile that should be used for this enforce-rule. This command is applicable for only DOCSIS 1.0 cable modems.
|
service-class (enforce-rule)
|
Specifies a service class (enforced or registered) that should be used for the cable modem monitoring in an enforce-rule. This command is applicable for DOCSIS 1.1 or later cable modems.
|
show cable subscriber-usage
|
Displays subscribers who are violating their registered QoS profiles.
|
show cable qos permission
To display the status of permissions for changing quality-of-service (QoS) tables on a Cisco CMTS, use the show cable qos permission command in privileged EXEC mode.
show cable qos permission
Syntax Description
This command has no keywords or arguments.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.1 T
|
This command was introduced.
|
12.1(4)CX
|
This command was deprecated for DOCSIS 1.1 use, because DOCSIS 1.1 replaces the QoS profile model with a service flow model. The show interface cable qos paramset command is used for DOCSIS 1.1 operation.
|
Examples
The following example displays the output of the show cable qos permission command:
CMTS01# show cable qos permission
Create by SNMP Update by SNMP Create by modems
Table 0-58 describes the fields displayed by the show cable qos permission command.
Table 0-58 show cable qos permission Command Field Descriptions
Field
|
Description
|
Create by SNMP
|
Indicates permission setting for creation of QoS table entries by the Simple Network Management Protocol (SNMP).
|
Update by SNMP
|
Indicates permission setting for creation of QoS table entries by modem registration requests.
|
Create by modems
|
Indicates permission setting for dynamic updating of QoS table entries by the SNMP.
|
Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Related Commands
Command
|
Description
|
cable qos permission
|
Specifies permission for updating the cable router QoS table.
|
cable qos profile
|
Configures a QoS profiles.
|
cable service-flow inactivity-timeout
|
Sets the amount of time a dynamic service-flow can be present in the system without any activity.
|
show controllers cable
|
Displays cable router QoS profiles.
|
show interface cable qos paramset
|
Displays the DOCSIS 1.1 QoS parameter sets.
|
show cable qos profile
To display quality-of-service (QoS) profiles for a Cisco CMTS, use the show cable qos profile command in privileged EXEC mode.
show cable qos profile profile-index [verbose]
Syntax Description
profile-index
|
Displays cable QoS table. Valid range is 1 to 255.
|
verbose
|
Displays detailed information about the QoS profiles.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.3NA
|
This command was introduced.
|
12.0(3)T
|
The command was included in the mainline release.
|
12.0(7)XR
|
The verbose option was added.
|
12.1(1)T
|
The IP precedence rate enabling bits were added to the display.
|
12.1(4)CX
|
This command was deprecated for DOCSIS 1.1 use, because DOCSIS 1.1 replaces the QoS profile model with a service flow model. The show interface cable qos paramset command is used for DOCSIS 1.1 operation.
|
Examples
The following example shows how to display the existing QoS profiles on the CMTS:
Router# show cable qos profile
ID Prio Max Guarantee Max Max TOS TOS Create B IP prec.
upstream upstream downstream tx mask value by priv rate
bandwidth bandwidth bandwidth burst enab enab
1 0 0 0 0 0 0x0 0x0 cmts(r) no no
2 0 64000 0 1000000 0 0x0 0x0 cmts(r) no no
3 7 31200 31200 0 0 0x0 0x0 cmts yes no
4 7 87200 87200 0 0 0x0 0x0 cmts yes no
5 2 256000 0 128000 1503 0x0 0x0 cm no no
Profiles 1 and 2 are always created by the CMTS at initial startup. The CMTS dynamically creates profiles 3 and 4, as shown above, to support Voice over IP (VoIP) codecs G.711 and G.729 when a CM configures phone lines and uses dynamic service requests to request VoIP service. The remaining profiles, such as profile 5 above, are typically created by a CM when it comes online.
Profile 3 creates a grant-size of 31.22 KiloBytes per second for G.729 service, and profile 4 creates a grant-size of 87.2 KiloBytes per second for G.711 service. Both profiles use a default grant-interval of 20 milliseconds. For more information on these profiles, see the TAC technical note at the following URL:
http://www.cisco.com/warp/public/109/uBR7200_QoSMAC.html
The following example displays detailed output for profile 1:
Router# show cable qos profile 1 verbose
Upstream Traffic Priority 0
Upstream Maximum Rate (bps) 0
Upstream Guaranteed Rate (bps) 0
Unsolicited Grant Size (bytes) 0
Unsolicited Grant Interval (usecs) 0
Upstream Maximum Transmit Burst (bytes) 0
IP Type of Service Overwrite Mask 0x0
IP Type of Service Overwrite Value 0x0
Downstream Maximum Rate (bps) 0
Baseline Privacy Enabled no
Table 0-59 describes the fields displayed by the show cable qos profile command.
Table 0-59 show cable qos profile Command Field Descriptions
Field
|
Description
|
ID
|
Profile number.
|
Prio
|
Priority level.
|
Max upstream bandwidth
|
Maximum upstream bandwidth.
|
Guarantee upstream bandwidth
|
Guaranteed minimum upstream bandwidth.
|
Max downstream bandwidth
|
Maximum downstream bandwidth.
|
Max tx burst
|
Maximum transmit burst size in bytes.
|
Tos mask
|
Hex value of the mask bits.
|
Tos value
|
Value of the mask byte.
|
Create by
|
Identity of who created the profile:
• cmts = Created by the CMTS with read-write properties. The profile can be modified but not deleted.
• cmts(r) = Created by the CMTS with read-only properties. The profile cannot be modified or deleted.
• cm = Created by the CM DOCSIS configuration file.
• mgmt = Created by an operator using CLI commands.
|
B priv enab
|
Describes whether Baseline Privacy Interface (BPI) encryption is enabled (yes) or disabled (no) for this QoS profile.
|
IP prec. rate enab
|
Describes whether IP precedence rate limiting enabling is enabled (yes) or disabled (no) for this QoS profile. When a profile is created by a CM, this value is set by the Type Length Value (TLV) 11 fields in the DOCSIS configuration file, unless overwritten using the cable qos profile command.
|

Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Related Commands
Command
|
Description
|
cable qos permission
|
Specifies permission for updating the cable router QoS table.
|
cable qos profile
|
Configures a QoS profiles.
|
cable service-flow inactivity-timeout
|
Sets the amount of time a dynamic service-flow can be present in the system without any activity.
|
show cable modem qos
|
Displays quality of service (QoS) and service flow information for a particular CM.
|
show cable noise
|
Displays the status of permissions for changing QoS tables.
|
show interface cable qos paramset
|
Displays the DOCSIS 1.1 QoS parameter sets.
|
show cable rate-adapt
To display the global and local upstream utilization optimization configuration parameters, use the show cable rate-adapt command in privileged EXEC mode.
show cable rate-adapt
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.3(23)BC2
|
This command was introduced.
|
12.2(33)SCB
|
This command was integrated into Cisco IOS Release 12.2(33)SCB. Support for the Cisco uBR7225VXR router was added.
|
Usage Guidelines
This command displays the current global rate-adapt settings that govern all cable modem and the local rate-adapt settings that relate to a specific cable modem upstream.
Examples
The following example shows a typical display of the show cable rate-adapt command:
Router# show cable rate-adapt
Global:Enabled Local-Only:Enabled global:maps 500 priority 6, rate 12 bcs 10 fcms On
Note
The output "maps 500" relates to duration. It indicates that the service flow is optimized for 500 MAPs.
Table 60 describes the fields shown in the show cable rate-adapt display.
Table 60 show cable rate-adapt Field Descriptions
Field
|
Description
|
Global
|
Indicates if upstream utilization optimization is enabled globally on all cable modems.
|
Local
|
Indicates if upstream utilization optimization is enabled locally on a specific upstream flow.
|
priority
|
Indicates the specified priority setting.
|
rate
|
Indicates the specified minimum max-rate.
|
bcs
|
Indicates the number of broadcast contention minislots (BCS).
|
fcms
|
Indicates if forced broadcast contention minislot (fcms) is turned on or off.
|
duration
|
Indicates the duration of a rate-adapt flow.
|
Related Commands
Command
|
Description
|
cable upstream rate-adapt (global)
|
Enables upstream utilization optimization globally on all cable modem upstream flows.
|
cable upstream rate-adapt (interface)
|
Enables upstream utilization optimization locally.
|
show cable rate-limit-ccf
To display information about rate limiting criteria for upstream bonded service flows on the Cisco uBR10-MC5X20H cable interface line card, use the show cable rate-limit-ccf command in privileged EXEC mode.
show cable rate-limit-ccf [start-index count | clear]
Syntax Description
start-index
|
(Optional) Starting index for the log entries. The valid range is from 0 to 2000. The default value is 0.
|
count
|
(Optional) Total number of log entries to be displayed. The valid range is from 0 to 2000.
|
clear
|
(Optional) Clears information about rate limiting.
|
Command Default
None
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCC
|
This command was introduced in Cisco IOS Release 12.2(33)SCC.
|
Examples
The following is a sample output of the show cable rate-limit-ccf command that displays information about rate limiting criteria for upstream bonded service flows on a Cisco uBR10-MC5X20H cable interface line card:
Router# show cable rate-limit-ccf
rate_limiting config: aggr_throughput: 215000000 aggr_burst: 240000
cpu_threshold: 50 cpu_burst: 10
5X20H rate limit: cpu-throttle 0 ccf-bw-drop 0 others 0
5X20H rate limit ccf info count: 0
Table 61 describes the fields shown in the show cable rate-limit-ccf command display.
Table 61 show cable rate-limit-ccf Field Descriptions
Field
|
Description
|
aggr_throughput
|
Aggregate throughput value.
|
aggr_burst
|
Aggregate burst rate value.
|
cpu_threshold
|
CPU threshold for Continuous Concatenation and Fragmentation (CCF) in percentage.
|
cpu_burst
|
CPU burst for CCF in percentage
|
cpu-throttle
|
Total number of bandwidth requests that stopped due to CPU throttle.
|
ccf-bw-drop
|
Total number of bandwidth requests that stopped due to CCF resource constraint.
|
5X20H rate limit ccf info count
|
Total number of log entries.
|
Related Commands
Command
|
Description
|
cable upstream rate-limit-ccf
|
Configures rate limiting criteria for upstream bonded service flows on a Cisco uBR10-MC5X20H cable interface line card.
|
show cable redundancy
To display the DDC redundancy partners and their relative states, and additional information about DDC states on the Cisco CMTS, use the show cable redundancy command in privileged EXEC mode.
show cable redundancy {hashfilter | class | calls}
Syntax Description
hashfilter
|
Displays the hash filter(s) being used in the scheme.
|
class
|
Displays the displays the number of cable modems in each DDC class of the same scheme.
|
calls
|
Displays the number of active and E911 calls currently being supported on the relative DDC nodes.
|
Command Default
This command has no default behaviors or values.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
Release 12.3(9a)BC
|
This command was introduced on the Cisco uBR7246 universal broadband router.
|
Examples
The following example of the show cable redundancy hashfilter command illustrates the same DDC Redundancy scheme (two Cisco uBR7246VXR routers). This command displays the configured hash filter parameters. You can either list all hash filters (as shown) or list one hash filter, if specified with the optional hash_id value at the end of the command.
Router# show cable redundancy hashfilter
The following example of the show cable redundancy class command displays the number of cable modems in each DDC class of the same scheme (two Cisco uBR7246VXR routers).
Router# show cable redundancy class
Number of modems in each DDC class:
Interface Class0 Class1 Class2 Class3 Class4
The following example of the show cable redundancy calls command displays the number of active 911 (E911) calls, voice calls, and the number of cable modems with service flows for each subinterface. If the subinterface is configured on a bundle, the number of calls is the total for all the members in the bundle.
Router# show cable redundancy calls
SubInterface 911Calls VoiceCalls ModemCount ServiceFlow
Related Commands
Command
|
Description
|
cable redundancy hashfilter
|
Sets the MAC address and DDC node mappings of the DDC redundancy scheme.
|
cable redundancy myid
|
Sets the total number of Cisco DDC nodes (routers) in the DDC Redundancy scheme and sets the ID of the current DDC node.
|
cable redundancy node
|
Configures the DDC node with active or standby state.
|
cable redundancy node frequency
|
Sets the downstream frequencies for each node participating in the scheme other than the current DDC node (router).
|
cable redundancy target
|
Sets the target DDC node (router) to use in a DDC switchover event.
|
cable redundancy threshold
|
Sets the active voice call threshold on the current DDC node (router).
|
show cable rf-adapt
To display the downgrade and upgrade candidate modems, use the show cable rf-adapt command in user EXEC or privileged EXEC mode.
show cable rf-adapt [cable {slot/cable-interface-index | slot/subslot/cable-interface-index}
[upgrade-candidates | downgrade-candidates | upstream upstream-channel-id
[upgrade-candidates | downgrade-candidates]] | upgrade-candidates |
downgrade-candidates]
Syntax Description
cable
|
Displays information about the cable modems in a specific cable interface.
|
slot
|
Slot where the line card resides.
• Cisco uBR7225VXR router—The valid value is 1 or 2.
• Cisco uBR7246VXR router—The valid range is from 3 to 6.
• Cisco uBR10012 router—The valid range is from 5 to 8.
|
subslot
|
(Cisco uBR10012 only) Secondary slot number of the cable interface line card. The valid subslots are 0 or 1.
|
cable-interface-index
|
Downstream port of the Cisco uBR10-MC5X20 and Cisco uBR-MC28 line cards, or MAC domain index of the Cisco uBR-MC20X20V and Cisco uBR-MC3GX60V line cards.
• Cisco uBR7225VXR and Cisco uBR7246VXR routers—The valid port value is 0 or 1.
• Cisco uBR10012 router—The valid range for the Cisco uBR-MC20X20V and Cisco uBR-MC5X20 line cards is from 0 to 4. The valid range for the Cisco uBR-MC3GX60V line card is from 0 to 14.
|
upgrade-candidates
|
Displays information about the upgrade candidate cable modems.
|
downgrade-candidates
|
Displays information about the downgrade candidate cable modems.
|
upstream upstream-channel-id
|
(Optional) Displays candidates on a particular upstream channel. The valid range for upstream-channel-id is from 0 to 3.
|
Command Modes
User EXEC (>) or
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCF
|
This command was introduced.
|
Examples
The following is a sample output of the show cable rf-adapt downgrade-candidates command:
Router# show cable rf-adapt downgrade-candidates
MAC Address IP Address Source Destination
0019.474a.d4cc 10.10.1.9 C8/0/1/U3.0 C8/0/1/U3.1
0019.474a.d554 10.10.1.73 C8/0/14/U0.0 C8/0/14/U0.1
0019.474a.d542 10.10.1.79 C8/0/0/U0.0 C8/0/0/U0.1
0019.474a.d508 10.10.1.11 C8/0/8/U0.0 C8/0/8/U0.1
0025.2e2d.7400 10.10.1.66 C8/0/0/U1.0 C8/0/0/U1.1
0022.cea4.f404 10.10.1.53 C8/0/2/U2.0 C8/0/2/U2.1
The following is a sample output of the show cable rf-adapt upgrade-candidates command:
Router# show cable rf-adapt upgrade-candidates
MAC Address IP Address Source Destination
0019.474a.d554 10.10.1.73 C8/0/14/U0.1 C8/0/14/U0.0
0019.474a.d542 10.10.1.79 C8/0/0/U0.1 C8/0/0/U0.0
0025.2e2d.7400 10.10.1.66 C8/0/0/U1.1 C8/0/0/U1.0
The following is a sample output of the show cable rf-adapt cable upstream downgrade-candidates command:
Router# show cable rf-adapt cable 7/0/0 upstream 0 downgrade-candidates
MAC Address IP Address Source Destination
0019.474a.d4cc 10.10.1.9 C7/0/0/U3.0 C7/0/0/U3.1
The following is a sample output of the show cable rf-adapt cable upstream upgrade-candidates command:
Router# show cable rf-adapt cable 7/0/0 upstream 0 upgrade-candidates
MAC Address IP Address Source Destination
0019.474a.d554 10.10.1.73 C7/0/0/U0.1 C7/0/0/U0.0
The following is a sample output of the show cable rf-adapt cable downgrade-candidates command:
Router# show cable rf-adapt cable 7/0/0 downgrade-candidates
MAC Address IP Address Source Destination
0019.474a.d4cc 10.10.1.9 C7/0/0/U3.0 C7/0/0/U3.1
The following is a sample output of the show cable rf-adapt cable upgrade-candidates command:
Router# show cable rf-adapt cable 7/0/0 upgrade-candidates
MAC Address IP Address Source Destination
0019.474a.d554 10.10.1.73 C7/0/0/U0.1 C7/0/0/U0.0
Table 62 describes the significant fields shown in the display.
Table 62 show cable modem rf-adapt Field Descriptions
Field
|
Description
|
MAC Address
|
MAC address of the cable modem.
|
IP Address
|
IP address of the cable modem.
|
Source Upstream
|
Source upstream port and logical channel index of the cable modem.
|
Destination Upstream
|
Destination upstream port and logical channel index to which the cable modem will be moved.
|
Related Commands
Command
|
Description
|
cable rf-adapt timer
|
Configures timers for RF adaptation.
|
cable upstream rf-adapt
|
Enables RF adaptation on the physical upstream channel.
|
cable upstream rf-adapt (logical channel)
|
Specifies the primary upstream logical channel and the secondary upstream logical channel.
|
cable upstream threshold rf-adapt
|
Configures the upstream RF adaptation threshold value, which prevents excessive relocation of modems from the primary upstream channel to the secondary upstream channel.
|
show cable modem
|
Displays information about the registered and unregistered cable modems.
|
show cable modem rf-adapt
|
Displays the RF adaptation history.
|
show cable rf-status
To display the logical up and down state of a channel number, or the logical state of all RF channels, use the show cable rf-status command in privileged EXEC mode.
show cable rf-status [modular-cable slot/bay/port:nb-channel-number]
Syntax Description
modular-cable
|
(Optional) Specifies the modular cable interface.
|
slot
|
(Optional) The slot where a SIP resides. On the Cisco uBR10012 router, slots 1 and 3 can be used for SIPs.
|
bay
|
(Optional) The bay in a SIP where a SPA is located. Valid values are 0 (upper bay) and 1 (lower bay).
|
port
|
(Optional) Specifies the interface number on the SPA.
|
nb-channel-number
|
(Optional) Specifies the channel number for the RF channel.
|
Command Default
No default behavior or values.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCB
|
This command was introduced.
|
Examples
The following is a sample output of the show cable rf-status command used to display the logical state of all RF channels on a modular cable interface:
Router# show cable rf-status
-------- ------- ------ ----
Table 63 describes the significant fields shown in the display.
Table 63 show cable rf-status Field Descriptions
Field
|
Description
|
RF
|
Indicates the RF channel ID.
|
Logical Status
|
Indicates the logical up and down state of all RF channels.
|
Flap Counts
|
Indicates the number of times the RF channel has dropped and recovered.
|
Flap Time
|
Indicates the duration in seconds for each flap count.
|
The following is a sample output of the show cable rf-status command used to display the logical up and down state of a particular channel number on a modular cable interface:
Router# show cable rf-status modular-cable 1/0/0:1
Load for five secs: 6%/0%; one minute: 3%; five minutes: 2%
Time source is NTP, .14:47:27.751 EDT Thu Aug 7 2008
-------- ------- ------ ----
Related Commands
Command
|
Description
|
show interface rf-status
|
Displays the logical up and down state for each of the configured RF channels for a wideband interface.
|
show cable rsvp flow-db
To display contents of the Resource ReSerVation Protocol (RSVP) to DOCSIS service-flow mapping database, use the show cable rsvp flow-db command in user EXEC mode.
show cable rsvp flow-db [mac-addr]
Syntax Description
mac-addr
|
(Optional) The MAC address of the specific cable modem in hexadecimal format.
|
Command Default
No default behavior or values.
Command Modes
User EXEC mode
Command History
Release
|
Modification
|
12.2(33)SCB
|
This command was introduced.
|
Usage Guidelines
The show cable rsvp flow-db command displays contents of the RSVP to DOCSIS service-flow mapping database.
Examples
The following example shows the sample output for the show cable rsvp flow-db command.
Router# show cable rsvp flow-db
Mac Address Src IP Src Dest IP Dest Pr Sfid Dir Handle
0019.474a.c5f6 200.0.0.1 1000 40.1.1.62 1000 6 11 DS 7000406
Table 64 describes the significant fields shown in the display.
Table 64 cable rsvp flow-db Field Descriptions
Field
|
Description
|
Mac Address
|
The MAC address of the specific cable modem.
|
Src IP
|
RSVP path source IP address.
|
Src Port
|
RSVP path source port number.
|
Dest IP
|
Destination IP address.
|
Dest port
|
Destination port number.
|
Proto
|
IP protocol type. Here 17 is the UDP's IP protocol number.
|
SFid
|
Service flow ID.
|
Dir
|
Direction of the DOCSIS service flow. Here DS indicates downstream flow.
|
Related Commands
Command
|
Description
|
cable rsvp default-scn
|
Specifies the default service class for the RSVP.
|
show cable service-class
To display the parameters for cable service class, use the show cable service class command in privileged EXEC mode.
show cable service-class [sclass-index] [verbose]
Syntax Description
sclass-index
|
Identifies the index for a service class that has already been defined (1 to 255).
|
verbose
|
Displays all of the defined attributes for the service class.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.1(4)CX
|
This command was introduced.
|
12.2(4)BC1
|
Support was added to the Release 12.2 BC train.
|
12.2(33)SCC
|
This command was integrated into Cisco IOS Release 12.2(33)SCC. The command output was modified to display the traffic peak rate value for a specific service flow.
|
12.2(33)SCF2
|
This command was modified. The command output was enhanced to display upstream buffer control parameters.
|
Usage Guidelines
You can display a summary of either one service class or all service classes. You can also display a complete listing of each service class and of all the defined service classes.
Examples
The following sample output shows the standard and verbose formats of the show cable service class command:
Router# show cable service-class
Index Name Dir Sched Prio MaxSusRate MaxBurst MinRsvRate
1 UP_UGS US/DS UGS 0 0 1522 0
2 UP_UGSAD US/DS UGS_AD 0 0 1522 0
3 UP_RTPS US/DS RTPS 0 128000 2000 64000
4 UP_BE US/DS BE 5 128000 2000 0
5 DOWN_BE US/DS BE 5 1000000 3000 0
Router# show cable service-class 1
Index Name Dir Sched Prio MaxSusRate MaxBurst MinRsvRate
1 UP_UGS US/DS UGS 0 0 1522 0
Router# show cable service-class 1 verbose
Direction: Upstream/Downstream
Maximum Sustained Rate: 0 bits/sec
Minimum Reserved Rate: 0 bits/sec
Minimum Packet Size 100 bytes
Admitted QoS Timeout 30 seconds
Active QoS Timeout 30 seconds
Scheduling Type: Unsolicited Grant Service
Request/Transmission Policy: 0x1FF
Unsolicited Grant Size: 100 bytes
Nominal Grant Interval: 20000 usecs
Tolerated Grant Jitter: 4000 usecs
IP ToS Overwrite [AND-mask,OR-mask]: 0xE0,0xA0
Parameter Presence Bitfield: {0xE08, 0xBCC000}
Router# show cable service-class verbose
Direction: Upstream/Downstream
Maximum Sustained Rate: 0 bits/sec
Minimum Reserved Rate: 0 bits/sec
Minimum Packet Size 100 bytes
Admitted QoS Timeout 30 seconds
Active QoS Timeout 30 seconds
Scheduling Type: Unsolicited Grant Service
Request/Transmission Policy: 0x1FF
Unsolicited Grant Size: 100 bytes
Nominal Grant Interval: 20000 usecs
Tolerated Grant Jitter: 4000 usecs
IP ToS Overwrite [AND-mask,OR-mask]: 0xE0,0xA0
Parameter Presence Bitfield: {0xE08, 0xBCC000}
Direction: Upstream/Downstream
Maximum Sustained Rate: 0 bits/sec
Minimum Reserved Rate: 0 bits/sec
Minimum Packet Size 100 bytes
Admitted QoS Timeout 30 seconds
Active QoS Timeout 30 seconds
Scheduling Type: Unsolicited Grant Service(AD)
Request/Transmission Policy: 0x1FF
Nominal Polling Interval: 10000 usecs
Tolerated Poll Jitter: 4000 usecs
Unsolicited Grant Size: 100 bytes
Nominal Grant Interval: 20000 usecs
Tolerated Grant Jitter: 4000 usecs
IP ToS Overwrite [AND-mask,OR-mask]: 0xE0,0xA0
Parameter Presence Bitfield: {0xE08, 0xBFC000}
Direction: Upstream/Downstream
Maximum Sustained Rate: 128000 bits/sec
Minimum Reserved Rate: 64000 bits/sec
Minimum Packet Size 64 bytes
Admitted QoS Timeout 30 seconds
Active QoS Timeout 30 seconds
Maximum Concatenated Burst: 1522 bytes
Scheduling Type: Realtime Polling Service
Request/Transmission Policy: 0x1FF
Nominal Polling Interval: 10000 usecs
Tolerated Poll Jitter: 4000 usecs
IP ToS Overwrite [AND-mask,OR-mask]: 0xE0,0xA0
Parameter Presence Bitfield: {0xDC8, 0x83E000}
Direction: Upstream/Downstream
Maximum Sustained Rate: 128000 bits/sec
Minimum Reserved Rate: 0 bits/sec
Minimum Packet Size 64 bytes
Admitted QoS Timeout 30 seconds
Active QoS Timeout 30 seconds
Maximum Concatenated Burst: 1522 bytes
Scheduling Type: Best Effort
Request/Transmission Policy: 0x0
IP ToS Overwrite [AND-mask,OR-mask]: 0xE0,0x0
Parameter Presence Bitfield: {0xDE8, 0x80E000}
Direction: Upstream/Downstream
Maximum Sustained Rate: 1000000 bits/sec
Minimum Reserved Rate: 0 bits/sec
Minimum Packet Size 64 bytes
Admitted QoS Timeout 30 seconds
Active QoS Timeout 30 seconds
Maximum Concatenated Burst: 0 bytes
Scheduling Type: Best Effort
Request/Transmission Policy: 0x0
IP ToS Overwrite [AND-mask,OR-mask]: 0xFF,0x0
Parameter Presence Bitfield: {0xDE8, 0x0}
The following is a sample output of the show cable service class command with verbose option, for
Cisco IOS release 12.2(33)SCF2:
Router# show cable service-class 10 verbose
Maximum Sustained Rate: 0 bits/sec
Minimum Reserved Rate: 0 bits/sec
Minimum Packet Size 0 bytes
Admitted QoS Timeout 200 seconds
Active QoS Timeout 0 seconds
Maximum Concatenated Burst: 1522 bytes
Scheduling Type: Best Effort
Request/Transmission Policy: 0x0
IP ToS Overwrite [AND-mask,OR-mask]: 0xFF,0x0
Parameter Presence Bitfield: {0x8, 0x0}
!Upstream Buffer Control Parameters
Minimum Buffer Size: 1000 bytes
Target Buffer Size: 1500 bytes
Maximum Buffer Size: 2000 bytes
Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Related Commands
cable service class
|
Defines and modifies a service class.
|
show interface cable qos paramset
|
Displays the parameters in one or more service templates.
|
show cable service-voice downstream-type
To display the downstream-types that are capable of providing voice services, use the show cable service-voice downstream-type command.
show cable service-voice downstream-type
Syntax Description
This command has no keywords or arguments.
Command Default
No default behavior or values
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.3(23)BC
|
This command was introduced for the Cisco uBR10012 router.
|
Usage Guidelines
Use this command to display the downstream-types that are capable for providing voice services on each uBR10-MC 5x20 line card.
Examples
The example below shows that both HA-capable-DS and MDC-DS are enabled for downstream types on the uBR10-MC 5x20 line card in slot 5, subslot 1 and the line card in slot 6, subslot 0.
Router# show cable service-voice downstream-type
Slot 5/1 : HA-capable-DS MDC-DS
Slot 6/0 : HA-capable-DS MDC-DS
show cable signal-quality
To display information about the signal quality of an upstream port on a cable interface, use the show cable signal-quality command in privileged EXEC mode.
show cable signal-quality {cable {slot/port | slot/subslot/port} upstream number | cmts | mer}
Syntax Description
cable
|
Specifies the cable interface.
|
slot/subslot/port
|
Displays information about all CMs on the specified cable interface line card on a Cisco CMTS router:
• slot—Chassis slot number of the cable interface line card. Valid slots are from 5 to 8.
• subslot—Secondary slot number of the cable interface line card. Valid subslots are 0 or 1.
• port—Port number. Valid ports are from 0 to 4, depending on the cable interface line card.
|
upstream number
|
Specifies the upstream channel ID. Valid values are from 0 to 3.
|
cmts
|
Displays the carrier-to-noise ratio (CNR) data and expected signal power received per cable interface.
|
mer
|
Displays the modulation error rate (MER) data per cable interface.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCC
|
This command was introduced in Cisco IOS Release 12.2(33)SCC.
|
Usage Guidelines
The show cable signal-quality command with the mer keyword displays the modulation error rate data per cable interface. Note that at least one cable modem (CM) must be online on the cable interface for this command to provide the modulation error rate data. This is identical to the modulation error rate data displayed by the show controllers command.
The CNR data is displayed only for the upstream channels that are assigned to a spectrum group. Upstream channels with fixed frequencies do not return any CNR data.
Examples
The following example shows the CNR data received on the upstream ports on the cable interface line card at slot/subslot/port 7/0/3 on a Cisco uBR10012 router:
Router# show cable signal-quality cable 7/0/3 cmts
I/F CNiR Expected Received
The following example shows the MER data received on the cable upstream port 3 on the cable interface line card at slot/subslot/port 5/0/0 on a Cisco uBR10012 router:
Router# show cable signal-quality cable 5/0/0 upstream 3 mer
I/F Received MER Received MER
The following example shows the signal quality information for all cable interfaces on a Cisco uBR10012 router:
Router#show cable signal-quality mer
I/F Received MER Received MER
Cable6/1/0/U0 ----- -----
Cable6/1/0/U1 ----- -----
Cable6/1/0/U2 ----- -----
Cable6/1/0/U3 ----- -----
Cable6/1/1/U0 ----- -----
Cable6/1/1/U1 ----- -----
Cable6/1/1/U2 ----- -----
Cable6/1/1/U3 ----- -----
Cable6/1/2/U0 ----- -----
Cable6/1/2/U1 ----- -----
Cable6/1/2/U2 ----- -----
Cable6/1/2/U3 ----- -----
Cable6/1/3/U0 ----- -----
Cable6/1/3/U1 ----- -----
Cable6/1/3/U2 ----- -----
Cable6/1/3/U3 ----- -----
Cable6/1/4/U0 ----- -----
Cable6/1/4/U1 ----- -----
Cable6/1/4/U2 ----- -----
Cable6/1/4/U3 ----- -----
Cable7/1/0/U1 ----- -----
Cable7/1/0/U2 ----- -----
Cable7/1/0/U3 ----- -----
Cable7/1/1/U0 ----- -----
Cable7/1/1/U1 ----- -----
Cable7/1/1/U2 ----- -----
Cable7/1/1/U3 ----- -----
Cable7/1/2/U0 ----- -----
Cable7/1/2/U1 ----- -----
Cable7/1/2/U2 ----- -----
Cable7/1/2/U3 ----- -----
Cable7/1/3/U0 ----- -----
Cable7/1/3/U1 ----- -----
Cable7/1/3/U2 ----- -----
Cable7/1/3/U3 ----- -----
Cable7/1/4/U0 ----- -----
Cable7/1/4/U1 ----- -----
Cable7/1/4/U2 ----- -----
Cable7/1/4/U3 ----- -----
Cable8/0/0/U1 ----- -----
Table 65 describes the major fields displayed by the show cable signal-quality command.
Table 65 show cable signal-quality Command Field Descriptions
Field
|
Description
|
I/F
|
Cable interface.
|
CNiR (db)
|
CNR value.
|
Expected Received Signal Power (dBmV)
|
Expected signal power received per upstream port.
|
Received MER (db)
|
Received MER signal-to-noise ratio (SNR) value.
|
Received MER (samples)
|
Samples used for calculating the SNR per upstream port.
|
Related Commands
Command
|
Description
|
show cable spectrum-analysis
|
Displays information about the spectrum measurements of an upstream port on a cable interface on a Cisco uBR10012 router.
|
show controllers
|
Displays information about the interface controllers for a cable interface on the Cisco CMTS router.
|
show cable modem cnr
|
Displays information about CNR or SNR data for a particular cable modem.
|
show cable modem
|
Displays information about the registered and unregistered CMs on a Cisco CMTS router.
|
show cable spectrum-analysis
To display information about the spectrum measurements of an upstream port on a cable interface line card, use the show cable spectrum-analysis command in privileged EXEC mode.
show cable spectrum-analysis slot/subslot/port upstream port
Syntax Description
slot/subslot/port
|
Displays information about all CMs on the specified cable interface line card on a Cisco CMTS router:
• slot—Chassis slot number of the cable interface line card. Valid slots are from 5 to 8.
• subslot—Secondary slot number of the cable interface line card. Valid subslots are 0 or 1.
• port—Downstream port number. Valid ports are from 0 to 4, depending on the cable interface line card.
|
upstream port
|
Specifies the upstream port number.
|
Command Modes
Privileged EXEC(#)
Command History
Release
|
Modification
|
12.2(33)SCC
|
This command was introduced in Cisco IOS Release 12.2(33)SCC.
|
Examples
The following example shows the spectrum measurements on upstream port 1 on a Cisco uBR10012 router:
Router# show cable spectrum-analysis c5/0/0 upstream 1
Spectrum Analysis Measurements for Cable5/0/0: Upstream 1
Channel Center Frequency: 17000000 Hz
Frequency Span: 6400000 Hz
Resolution Bandwidth: 34200 Hz
Table 65 describes the significant fields shown in the display.
Table 66 show cable spectrum-analysis Field Descriptions
Field
|
Description
|
Spectrum analysis measurements
|
Spectrum measurements.
|
Channel center frequency
|
Channel center frequency value.
|
Frequency span
|
Frequency span.
|
No of Bins
|
Total number of bins in the spectrum analysis data.
|
Bin spacing
|
Spacing between the center frequency of each bin.
|
Resolution Bandwidth
|
Spacing between bins after the spectral window is applied.
|
Amplitude Data
|
Spectral amplitudes for the received signal power of a bin.
|
Related Commands
Command
|
Description
|
show cable signal-quality
|
Displays information about the signal quality of an upstream port on a cable interface line card.
|
show controllers cable
|
Displays information about the interface controllers for a cable interface line card on a Cisco CMTS router.
|
show cable modem cnr
|
Displays information about the upstream carrier-to-noise ratio (CNR) or signal-to-noise ratio (SNR) for a particular cable modem.
|
show cable spectrum-group
To display information about spectrum groups on a Cisco CMTS, use the show cable spectrum-group command in user EXEC or privileged EXEC mode.
show cable spectrum-group [groupnum] [detail]
Syntax Description
groupnum
|
(Optional) Displays information about the specified group number (1-32). If no group number is specified, information for all spectrum groups is displayed.
|
detail
|
(Optional) Displays whether the groups are allocated, free, or in-use.
|
Command Modes
User EXEC, Privileged EXEC
Command History
Release
|
Modification
|
11.3 NA
|
This command was introduced.
|
12.0(5)SC, 12.0(5)T
|
The detail keyword was added.
|
Examples
The following is sample output from the show cable spectrum-group command for all upstream spectrum groups:
CMTS01# show cable spectrum-group
Group Frequency Upstream Weekly Scheduled Power Shared
No. Band Port Availability Level Spectrum
(Mhz) From Time: To Time: (dBmV)
1 17.328 [1.60] Cable3/0 U0 0
1 5.808 [1.60] Cable3/0 U1 0
1 5.808 [1.60] Cable3/0 U2 0
1 15.792 [1.60] Cable3/0 U3 0
1 6.096 [1.60] Cable3/0 U4 0
1 5.808 [1.60] Cable3/0 U5 0
2 6.608 [3.20] Cable6/0 U1 0
2 5.808 [1.60] Cable6/0 U2 0
2 5.808 [1.60] Cable6/0 U3 0
2 5.808 [1.60] Cable6/0 U4 0
2 5.808 [1.60] Cable6/0 U5 0
3 17.488 [1.60] Cable5/0 U1 0
3 6.160 [1.60] Cable5/0 U2 0
3 36.912 [1.60] Cable5/0 U3 0
3 36.560 [1.60] Cable5/0 U4 0
3 16.240 [1.60] Cable5/0 U5 0
4 17.168 [1.60] Cable5/0 U0 0
The following is sample output from the show cable spectrum-group detail command:
CMTS# show cable spectrum-group detail
Group Frequency Upstream Weekly Scheduled Power Shared
No. Band Port Availability Level Spectrum
(Mhz) From Time: To Time: (dBmV)
1 11.008 [0.80] Cable3/0 U2 4
1 15.808 [1.60] Cable3/0 U3 0
1 17.408 [1.60] Cable3/0 U5 0
Table 0-67 describes the fields shown in the show cable spectrum-group displays.
Table 0-67 show cable spectrum-group Command Field Descriptions
Field
|
Description
|
Group No.
|
Identifies the spectrum group. When using the detail keyword, the following also appear:
• A = Signifies that the band is allocated.
• F = Signifies that the band is free.
• I = Signifies that the band is in-use.
• C = Identifies the channel width.
• O = Identifies the offered list bands (based on the current channel widths).
|
Frequency Band (MHz)
|
Identifies the upper and lower ranges of the frequency for this spectrum group.
|
Upstream Port
|
Identifies the upstream port number.
|
Weekly Scheduled Availability
|
Identifies the day and time of day when this group is available. If no values appear in the From and To Time fields, this group is available at all times.
|
Input PowerLevel
|
Identifies the assigned decibels per millivolt (dBmV) input level.
|
Shared Spectrum
|
Indicates if upstreams are physically combined (share the same combiner group). Y or yes values indicate that upstreams that are members of the spectrum group are combined and cannot be assigned overlapping frequency bands.
N or no values indicate that upstreams that are members of the spectrum group are not combined and can be assigned overlapping frequency bands.
|

Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Related Commands
Command
|
Description
|
show cable hop
|
Displays CM configuration settings.
|
show cable modulation-profile
|
Displays modulation profile group information.
|
show cable subscriber-usage
To display subscribers who are violating their registered quality of service (QoS) profiles, use the show cable subscriber-usage command in privileged EXEC mode.
show cable subscriber-usage [over-consume] [{cable slot/port | cable
slot/subslot/port}[upstream port]] [sort-byte-count] [sort-avg-rate]
Syntax Description
over-consume
|
(Optional) Displays only those subscribers who have exceeded their maximum allowed bandwidth.
|
cable slot/port
|
(Optional) Displays information for all CMs on the specified cable interface and downstream port on a Cisco 7100 series or Cisco 7200 series router, where:
• slot—Specifies the chassis slot number of the cable interface line card.
• port—Specifies the downstream port number.
Valid values for these arguments are dependent on your CMTS router and cable interface line card. Refer to the hardware documentation for your router chassis and cable interface line card for supported slot and port numbering.
|
cable slot/subslot/port
|
(Optional) Displays information for all CMs on the specified cable interface on a Cisco uBR10012 router, where:
• slot—Specifies the chassis slot number of the cable interface line card. Valid slots are 5 to 8.
• subslot—Specifies the secondary slot number of the cable interface line card. Valid subslots are 0 or 1.
• port—Specifies the downstream port number. Valid ports are 0 to 4, depending on the cable interface line card.
|
upstream port
|
(Optional) Displays information for a particular upstream on the selected cable interface. The port value starts with 0 and continues up, depending on the type of cable interface card.
|
sort-byte-count
|
(Optional) Sorts the list by the subscriber byte count, with the highest byte counts listed first. The default is to sort the list by Service Flow ID (SFID). (This option is replaced by the sort-avg-rate keyword in later releases.)
|
sort-avg-rate
|
(Optional) Sorts the list by the subscriber's average rate. The default is to sort the list by Service Flow ID (SFID).
|
Command Default
All subscribers are shown, with the display sorted by SFID.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(15)BC1
|
This command was introduced.
|
12.3(9a)BC
|
This command was integrated into Cisco IOS Release 12.3(9a)BC. The sort-byte-count keyword option is replaced by the sort-avg-rate keyword option.
|
12.2(33)SCA
|
This command was integrated into Cisco IOS Release 12.2(33)SCA. Support for the Cisco uBR7225VXR router was added.
|
Usage Guidelines
The show cable subscriber-usage command displays the current usage statistics for all subscribers on the Cisco CMTS router, all subscribers on a particular cable interface, or for only those subscribers that are marked as over-consuming bandwidth.
Effective with Cisco IOS Release 12.3(9a)BC, the sort-byte-count keyword option is replaced by the sort-avg-rate keyword option.
Examples
The following example shows typical output for the default version of the show cable subscriber-usage command:
Router# show cable subscriber-usage
Sfid Mac Address Enforce-rule Total-Kbyte Last-detect Last-penalty Pen
Name Count time time Flag
3 0007.0e03.110d efrule-q5 121944817 Jan1 03:44:08 Jan1 03:54:08 Act
4 0007.0e03.110d efrule-q5d 1879076068 Jan1 03:35:05 Jan1 03:45:06 Act
5 0007.0e03.1431 efrule-q5 120052387 Jan1 03:44:18 Jan1 03:54:18 Act
6 0007.0e03.1431 efrule-q5d 1838493626 Jan1 03:34:55 Jan1 03:44:55 Act
7 0007.0e03.1445 efrule-q5 120919427 Jan1 03:44:08 Jan1 03:54:08 Act
8 0007.0e03.1445 efrule-q5d 1865955172 Jan1 03:35:06 Jan1 03:45:06 Act
9 0007.0e03.1225 efrule-q5 120200155 Jan1 03:44:18 Jan1 03:54:18 Act
10 0007.0e03.1225 efrule-q5d 1839681070 Jan1 03:34:55 Jan1 03:44:55 -
11 0007.0e03.0cb1 efrule-q5 122941643 Jan1 03:43:58 Jan1 03:53:58 Act
12 0007.0e03.0cb1 efrule-q5d 1889107176 Jan1 03:35:06 Jan1 03:45:06 Act
13 0007.0e03.1435 efrule-q5 119504795 Jan1 03:44:18 Jan1 03:54:18 Act
14 0007.0e03.1435 efrule-q5d 1835164034 Jan1 03:34:55 Jan1 03:44:55 -
15 0007.0e02.f80d efrule-q5 119250047 Jan1 03:44:18 Jan1 03:54:18 Act
16 0007.0e02.f80d efrule-q5d 1832034114 Jan1 03:34:55 Jan1 03:44:55 -
17 0007.0e03.1469 efrule-q5 117562137 Jan1 03:44:18 Jan1 03:54:18 Act
18 0007.0e03.1469 efrule-q5d 1816957486 Jan1 03:34:55 Jan1 03:44:55 -
19 0007.0e03.11f9 efrule-q5 124265775 Jan1 03:44:18 Jan1 03:54:18 Act
20 0007.0e03.11f9 efrule-q5d 1959957066 Jan1 03:35:46 Jan1 03:45:46 Act
21 0007.0e03.1461 efrule-q5 113314731 Jan1 03:34:55 Jan1 03:44:55 -
22 0007.0e03.1461 efrule-q5d 1827583110 Jan1 03:35:46 Jan1 03:45:46 Act
23 0007.0e03.11d9 efrule-q5 104607787 Jan1 03:34:55 Jan1 03:44:55 -
24 0007.0e03.11d9 efrule-q5d 1675444338 Jan1 03:34:55 Jan1 03:44:55 -
25 0007.0e03.1475 efrule-q5 113751019 Jan1 03:34:55 Jan1 03:44:55 -
26 0007.0e03.1475 efrule-q5d 1841060070 Jan1 03:35:56 Jan1 03:45:56 Act
27 0007.0e03.10d9 efrule-q5 113713981 Jan1 03:34:55 Jan1 03:44:55 -
28 0007.0e03.10d9 efrule-q5d 1840272262 Jan1 03:35:56 Jan1 03:45:56 Act
29 0007.0e03.1065 efrule-q5 113443243 Jan1 03:34:55 Jan1 03:44:55 -
30 0007.0e03.1065 efrule-q5d 1834855264 Jan1 03:35:56 Jan1 03:45:56 Act
31 0007.0e03.1081 efrule-q5 119843737 Jan1 03:44:18 Jan1 03:54:18 Act
32 0007.0e03.1081 efrule-q5d 1852632338 Jan1 03:35:56 Jan1 03:45:56 Act
33 0007.0e03.1179 efrule-q5 118522795 Jan1 03:44:18 Jan1 03:54:18 Act
34 0007.0e03.1179 efrule-q5d 1834693996 Jan1 03:35:56 Jan1 03:45:56 Act
35 0007.0e03.1471 efrule-q5 122182565 Jan1 03:43:58 Jan1 03:53:58 Act
36 0007.0e03.1471 efrule-q5d 1881390866 Jan1 03:34:55 Jan1 03:44:55 -
37 0007.0e03.1341 efrule-q5 129557931 Jan1 03:43:48 Jan1 03:53:48 Act
38 0007.0e03.1341 efrule-q5d 2016792338 Jan1 03:35:56 Jan1 03:45:56 Act
The following example shows typical output for subscribers on a particular cable interface:
Router# show cable subscriber-usage c6/0/0
Sfid Mac Address Enforce-rule Total-Kbyte Last-detect Last-penalty Pen
Name Count time time Flag
7 0007.0e03.2cad test1 0 Jan1 00:00:00 Jan1 00:00:00 -
9 0007.0e03.2c45 test1 0 Jan1 00:00:00 Jan1 00:00:00 -
The following example shows typical output for the show cable subscriber-usage command for one upstream on a particular cable interface:
Router# show cable subscriber-usage c6/0/1 upstream 0
Sfid Mac Address Enforce-rule Total-Kbyte Last-detect Last-penalty Pen
Name Count time time Flag
5 0007.0e03.2c25 test1 0 Jan1 00:00:00 Jan1 00:00:00 -
The following example shows typical output for the sort-byte-count option for the show cable subscriber-usage command:
Router# show cable subscriber-usage sort-byte-count
Sfid Mac Address Enforce-rule Total-Kbyte Last-detect Last-penalty Pen
Name Count time time Flag
7 0007.0e03.2cad test1 65157114 Feb24 11:36:34 Mar3 11:36:34 Act
9 0007.0e03.2c45 test1 16381014 -
5 0007.0e03.2c25 test1 13440960 -
Table 68 describes the fields shown by the show cable subscriber-usage command.
Table 68 show cable subscriber-usage Field Descriptions
Field
|
Description
|
SFID
|
Number of the Service Flow ID.
|
Mac Address
|
Hardware address (MAC address) of the subscriber's cable modem.
|
Enforce-rule Name
|
Name of the enforce-rule being applied to this subscriber.
|
Total-Kbyte
|
Total number of kilobytes consumed by the subscriber's cable modem during the last monitoring-duration window.
Note The total byte count is reset to 0 whenever an enforce-rule's configuration is changed.
|
Last-detect time
|
Last time period, if any, at which it was determined that the cable modem was using more bandwidth than allowed by their QoS profile. This value also shows the time at which the enforced QoS profile was automatically applied, if this option has been enabled.
|
Last-penalty time
|
If an enforced QoS profile is currently in effect, this field shows the time period at which the subscriber's current penalty time expires, at which point their original registered QoS profile is restored.
|
Pen Flag
|
Identifies whether a penalty enforce-rule has been applied to this cable modem.
|
Related Commands
Command
|
Description
|
activate-rule at-byte-count
|
Specifies the number of bytes that a subscriber can transmit during the monitoring period on a Cisco CMTS router.
|
cable qos enforce-rule
|
Creates an enforce-rule to enforce a particular QoS profile for subscriber traffic management and enters enforce-rule configuration mode.
|
duration
|
Specifies the time period and sample rate to be used for monitoring subscribers.
|
enabled (enforce-rule)
|
Activates an enforce-rule and begins subscriber traffic management on a Cisco CMTS Router.
|
penalty-period
|
Specifies the time period that an enforced QoS profile should be in effect for subscribers who violate their registered QoS profiles.
|
qos-profile enforced
|
Specifies a QoS profile that should be enforced when users violate their registered QoS profiles.
|
qos-profile registered
|
Specifies the registered QoS profile that should be used for this enforce-rule.
|
show cable qos enforce-rule
|
Displays the QoS enforce-rules that are currently defined.
|
show cable tech-support
To display general information about the router when reporting a problem, use the show cable tech-support command in privileged EXEC mode.
show cable tech-support {slot/port | slot/subslot/port}
Syntax Description
slot/port
|
(Optional) Cisco IOS Release 12.3(9a)BC allows you to display information about one specific cable interface.
Identifies the cable interface and downstream port on the Cisco uBR7100 series and Cisco uBR7200 series routers.
On the Cisco uBR7100 series router, the only valid value is 1/0. On the Cisco uBR7200 series router, slot can range from 3 to 6, and port can be 0 or 1, depending on the cable interface.
|
slot/subslot/port
|
(Optional) Cisco IOS Release 12.3(9a)BC allows you to display information about one specific cable interface.
Identifies the cable interface on the Cisco uBR10012 router. The following are the valid values:
• slot = 5 to 8
• subslot = 0 or 1
• port = 0 to 4 (depending on the cable interface)
|
Command Default
No default behavior or values
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
12.1(1a)T1
|
This command was modified to include information about the cable clock card.
|
12.2(15)BC2
|
This command added several show pxf commands to the display on the Cisco uBR10012 router.
|
12.3(9a)BC
|
The output of the command was significantly shortened by moving a number of show commands (the ones that display information about individual cable modems) to the show tech-support command. This release also adds support for an option to display information about only one specific cable interface.
|
Usage Guidelines
The show cable tech-support command displays a large amount of configuration, run-time status, and other information about the cable interfaces on the Cisco CMTS. The output of this command can be provided to technical support representatives when reporting a problem.
Note
The show tech-support includes most of the information shown in the show cable tech-support command. Unless the problem is clearly cable-specific, TAC personnel will typically request the show tech-support output to troubleshoot any problems.
The show cable tech-support command displays the output of a number of different show commands. The exact output depends on the platform, configuration, and type of protocols being used. Typically,the output includes the output from the following commands:
•
show cable modem
•
show cable flap-list
•
show cable qos profile
•
show cable modulation-profile
•
show cable spectrum-group
•
show cable hop
•
show interface cable sid (for each cable interface)
•
show interface cable sid connectivity (for each cable interface)
•
show interface cable downstream
•
show interface cable upstream
•
show interface cable mac-scheduler
show interface cable modem Other commands could be included in the show cable tech-support output, depending on the CMTS platform, the Cisco IOS software being used, and the cards that are installed in the chassis.
On the Cisco uBR10012 router, the following commands also appear in Cisco IOS Release 12.2(15)BC2 and later releases:
•
show pxf cpu statistics
•
show pxf cpu subblocks
•
show pxf cpu buffer
•
show pxf dma
•
show pxf cpu cef memory
•
show pxf cpu queue
•
show pxf cpu statistics drop
Tip
Depending on the platform and configuration, the output from the show cable tech-support command can easily exceed the buffers found in most communications programs. To capture this output so it can be sent to Cisco TAC, use a Telnet program that allows you to capture the output directly to disk.
Examples
The following abbreviated example illustrates the cable modem and interface information for the Cisco uBR10012 router on which Cisco IOS Release 12.3(9a)BC is installed.
Router# show cable tech-support
----------------------------------- Slot 8/1 -----------------------------------
------------------ show cable modem Cable8/1/0 ------------------
MAC Address IP Address I/F MAC Prim RxPwr Timing Num BPI
State Sid (dB) Offset CPE Enb
------------------ show cable modem Cable8/1/0 connectivity ------------------
Prim 1st time Times %online Online time Offline time
Sid online Online min avg max min avg max
------------------ show interface Cable8/1/0 sid ------------------
Sid Prim MAC Address IP Address Type Age Admin Sched Sfid
------------------ show interface Cable8/1/0 sid counter ------------------
Sid Req-polls BW-reqs Grants Packets Frag Concatpkts
issued received issued received complete received
------------------ show interface Cable8/1/0 sid association ------------------
Sid Prim Online IP Address MAC Address Interface VRF Name
------------------ show interface Cable8/1/0 modem 0 ------------------
SID Priv bits Type State IP address method MAC address
------------------ show cable modem Cable8/1/1 ------------------
MAC Address IP Address I/F MAC Prim RxPwr Timing Num BPI
State Sid (dB) Offset CPE Enb
------------------ show cable modem Cable8/1/1 connectivity ------------------
Prim 1st time Times %online Online time Offline time
Sid online Online min avg max min avg max
------------------ show interface Cable8/1/1 sid ------------------
Sid Prim MAC Address IP Address Type Age Admin Sched Sfid
------------------ show interface Cable8/1/1 sid counter ------------------
Sid Req-polls BW-reqs Grants Packets Frag Concatpkts
issued received issued received complete received
------------------ show interface Cable8/1/1 sid association ------------------
Sid Prim Online IP Address MAC Address Interface VRF Name
------------------ show interface Cable8/1/1 modem 0 ------------------
SID Priv bits Type State IP address method MAC address
Tip
In Cisco IOS Release 12.1(12)EC, Release 12.2(8)BC1, and later releases, you can add a timestamp to show commands using the exec prompt timestamp command in line configuration mode.
Related Commands
Command
|
Description
|
show controllers cable
|
Displays information about a specific line card's interface controllers.
|
show interface cable downstream
|
Displays information about the cable interface.
|
show running-config
|
Displays the current run-time configuration.
|
show startup-config
|
Displays the configuration that was used to initially configure the CMTS at system startup.
|
show tech-support
|
Displays the output from show commands that display the router's configuration and run-time status.
|
show version
|
Displays the configuration of the system hardware, the software version, the names and sources of configuration files, and the boot images.
|
show cable urm
To view the connector group table information on a Cisco uBR-MC3GX60V cable interface line card, use the show cable urm command in the privileged EXEC mode. The connector group table provides information about the cable MAC domain upstream channel to connector mapping of a physical upstream channel.
show cable urm [slot/subslot]
Syntax Description
slot/subslot
|
Identifies the cable interface on the Cisco uBR10012 router.
• slot—Slot where the line card resides. The valid range is from 5 to 8.
• subslot—Subslot where the line card resides. Available slots are 0 or 1.
|
Command Default
Display information for all the slot/subslot values that has been configured.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCE
|
This command was introduced.
|
Examples
The following is a sample output indicating the connector group table information of the cable line card in slot 6/1:
Router# show cable urm 6/1
6/1 0-3 3:2=> 1 *empty* *empty* *empty* *empty* *empty*
*empty* *empty* *empty* *empty* *empty* *empty*
4-7 *empty* *empty* *empty* *empty* *empty* *empty*
*empty* *empty* *empty* *empty* *empty* *empty*
8-11 *empty* *empty* *empty* *empty* *empty* *empty*
*empty* *empty* *empty* *empty* *empty* *empty*
12-15 *empty* *empty* *empty* *empty* *empty* *empty*
*empty* *empty* *empty* *empty* *empty* *empty*
16-19 *empty* *empty* *empty* *empty* *empty* *empty*
*empty* *empty* *empty* *empty* *empty* *empty*
Table 69 describes the significant fields shown in the display.
Table 69 show cable urm Field Descriptions
Field
|
Description
|
card
|
The slot/subslot information of the card.
|
cnnrs
|
The connector index range of connectors in a connector group. The values for the Cisco uBR-MC3GX60V, Cisco UBR-MC20X20V, and the Cisco uBR10-MC5X20U line cards are 0-19.
|
md:us=>cnnr
|
The MAC domain upstream channel to connector mapping information of a physical upstream channel. The entry position corresponding to a physical upstream channel index in a connector group. For uBR-MC3GX60V line card, there are 12 physical upstream channels in each connector group. For the UBR-MC20X20V and uBR10-MC5X20U line cards, there are 2 channels in each group. In the example, C6/1/3:U2 is mapped to connector 1 in the running config by the user using connector command. Internally, CMTS software maps C6/1/3:U2 to physical upstream channel 0 (1st entry) in the 0-3 connector group.
|
Related Commands
Command
|
Description
|
show running-config interface cable
|
Shows the MD:US connector mapping configured by users.
|
show cable us-sg
To display the upstream service groups configured on all cable interfaces of a Cisco CMTS router, use the show cable us-sg command in privileged EXEC mode.
show cable us-sg
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCC
|
This command was introduced in Cisco IOS Release 12.2(33)SCC.
|
Examples
The following is a sample output of the show cable us-sg command.
US-SG-ID : 1 US-Chan : U0,1,2,3,4,5
Primary-DS: 1/0/0:0 US-SG-ID: 1
MDD US-List : U0,1,2,3,4,5
MDD Ambiguity : U0,1,2,3,4,5
US-SG-ID : 1 US-Chan : U0,1,2,3
Primary-DS: 1/0/0:4 US-SG-ID: 1
US-SG-ID : 1 US-Chan : U0,1,2,3
Primary-DS: 7/0/0:0 US-SG-ID: 1
Primary-DS: 7/0/0:1 US-SG-ID: 1
Table 1 shows the significant fields shown in the display:
Table 70 show interface cable service-flow Field Descriptions
Field
|
Description
|
US-SG-ID
|
Upstream service group ID.
|
US-Chan
|
Upstream channels on the cable interface line card.
|
Primary-DS
|
Primary downstream interafce.
|
MDD US-List
|
MAC management message: MDD TLV type 7 content, upstream active channel list.
|
MDD Ambiguity
|
MAC management message: MDD TLV type 8 content, upstream ambiguity resolution channel list.
|
Related Commands
Command
|
Description
|
show cable mac-domain upstream-service-group
|
Displays runtime statistics of the upstream service group on a cable interface line card.
|