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 partial-service
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 resiliency
show cable modem rf-adapt
show cable modem rogue
show cable modem service-type-id
show cable modem service-flow
show cable modem sysDescr
show cable modem summary
show cable modem summary wb-rf
show cable modem tcs summary
show cable modem type
show cable modem unregistered
show cable modem vendor
show cable modem voice
show cable modem wideband
show cable modem wideband phy
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 resiliency
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 throttle-modem
show cable upstream service-flow summary
show cable urm
show cable us-sg
Cable Commands: show cable m through show cable u
Revised: July 2012, OL-15510-15
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
|
show cable throttle-modem
|
12.2(33)SCF3
|
show cable modem partial-service
|
12.2(33)SCG
|
show cable modem resiliency
|
12.2(33)SCG
|
show cable modem tcs summary
|
12.2(33)SCG
|
show cable modem wideband phy
|
12.2(33)SCG
|
show cable resiliency
|
12.2(33)SCG
|
show cable upstream service-flow summary
|
12.2(33)SCG
|
show cable modem sysDescr
|
12.2(33)SCG2
|
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 cgd-associations
|
12.2(33)SCG
|
show cable mac-domain downstream-service-group
|
12.2(33)SCG
|
show cable modem qos
|
12.2(33)SCG
|
show cable modem wideband
|
12.2(33)SCG
|
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 147 describes the significant fields shown in the display.
Table 77 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. Added support for Cisco uBR7246VXR and Cisco uBR7225VXR routers.
|
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 downstream 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 be displayed.
•
The SPA downstream 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 line card at slot 6, subslot 0, and port 0:
Router# show cable mac-domain cable 6/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 line card 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
Cisco IOS Release 12.2(33)SCG
The following example is a sample output of the show cable mac-domain cgd-associations command
for the Cisco uBR-MC3GX60V cable interface line card sharing downstreams with the Cisco
Wideband SPA, in Cisco IOS Release 12.2(33)SCG:
Router# show cable mac-domain cable 8/0/0 cgd-associations
CGD Host Resource DS Channels Upstreams (AllUS) Active Remote DS
Table 78 describes the fields shown in the show cable mac-domain cgd-associations command display.
Table 78 show cable cgd-associations Field Descriptions
Field
|
Description
|
CGD Host
|
MAC domain interface for CGD.
|
Resource
|
Downstream cable interface line card.
|
DS Channels
|
Downstream RF channels.
|
Upstreams (AllUS)
|
Upstream channels in the MAC domain.
|
Active Remote DS
|
Active downstream channels.
|
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 Cisco 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 but 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
Cisco IOS Release 12.2(33)SCG
The following example shows a sample output of the show cable mac-domain
downstream-service-group command for the Cisco uBR-MC3GX60V cable interface line card with
primary downstream channel hosted on the Cisco Wideband SPA, in Cisco IOS Release 12.2(33)SCG:
Router# show cable mac-domain cable 8/0/0 downstream-service-group
IF Id Resource Chan Primary Chan
Table 79 describes the fields shown in the show cable mac-domain downstream-service-group command display.
Table 79 show cable mac-domain downstream-service-group Field Descriptions
Field
|
Description
|
Cable IF
|
Cable interface.
|
MD-DS-SG
|
MAC Domain Downstream Service Group.
|
Resource
|
Downstream cable interface line card.
|
RF Chan
|
Downstream RF channel.
|
Primary Chan
|
Primary downstream channel.
|
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 80 describes the significant fields shown in the display.
Table 80 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 81 describes the significant fields shown in the display.
Table 81 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 82 describes the fields displayed by the show cable metering-status command.
Table 82 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 101) 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 101 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.
Note
When an IPv4 CPE is moved from one bundle interface to another bundle interface, the show cable modem command displays duplicate CPE device under the original modem and new modem. CPE ping may also fail. To prevent duplication, use the clear cable host command to manually remove the old CPE device entry before moving the IPv4 CPE from one bundle interface to another. Reload the CPE after moving it to another bundle interface.
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 83 describes the significant fields shown in the display:
Table 83 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 101 shows the possible values for the MAC state field:
Table 84 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 The asterisk (*) indicates that the cable modem does not satisfy the BPI+ policy and the data traffic is blocked. The cable privacy bpi-plus-policy command enforces this requirement.
• 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-85 describes the fields that are shown in the show cable modem access-group display:
Table 0-85 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 86 describes the fields that are shown in the show cable modem classifiers display:
Table 86 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 87 describes the significant fields shown in the display:
Table 87 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 101).
|
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 101 shows the possible values for the MAC state field.
Table 88 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 89 describes the information shown in the show cable modem connectivity displays:
Table 89 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 90 describes the fields shown in the show cable modem counters displays:
Table 90 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 100 describes the significant fields shown in the display.
Table 91 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 92 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 93 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 94 describes the significant fields shown in the display.
Table 94 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 or 1.1. 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 95 describes the fields shown in the show cable modem docsis version total command display.
Table 95 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 96 describes the significant fields shown in the display.
Table 96 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 97 describes the fields shown in the show cable modem errors displays:
Table 97 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 98 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 99 describes the significant fields shown in the display:
Table 99 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.
|
cable
|
Identifies the cable interface on the Cisco 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 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) 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.
|
12.2(33)SCG1
|
The output for the show cable modem mac-address ipv6 cpe has been modified.
|
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 Cisco CMTS router before any domain name can be used as part of a cable command.
To display the number of CPEs behind a CM, use the show cable modem ipv6 registered command.
To display CPE information behind a specific CM, use the show cable modem mac-address ipv6 cpe command.
Examples
IPv6 Information for all CMs
The following example shows sample output for the show cable modem ipv6 command for all CMs on the Cisco 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
IPv6 prefix information for all CMs
The following example shows sample output for the show cable modem ipv6 prefix command for all CMs on the Cisco 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
Starting with Cisco IOS Release12.2(33)SCG1, the output for the show cable modem ipv6 prefix command displays multiple IPv6 prefix assigned. The D/IP field is not supported. The following example shows the sample output for the show cable modem ipv6 prefix command for all CMs on the Cisco CMTS router:
Router# show cable modem ipv6 prefix
Load for five secs: 1%/0%; one minute: 1%; five minutes: 1%
Time source is hardware calendar, *06:36:53.075 UTC Thu Aug 2 2012
Device Type: B - CM Bridge, R - CM Router
IP Assignment Method: D - DHCP
MAC Address Type IPv6 prefix
0023.bed9.4c91 R/D 2001:40:1012::/64
0000.002e.074c R/D 2001:40:1012:8::/64
0000.002e.074b R/D 2001:40:1012:23::/64
0000.002e.074a R/D 2001:40:1012:22::/64
Starting with Cisco IOS Release12.2(33)SCG1, the following example shows sample output for the show cable modem mac-address ipv6 prefix command for multiple IPv6 prefixes assigned to CPEs behind a CM with a specific MAC address on the Cisco CMTS router:
Router# show cable modem 0023.bed9.4c8e ipv6 prefix
Load for five secs: 0%/0%; one minute: 1%; five minutes: 1%
Time source is hardware calendar, *06:37:22.335 UTC Thu Aug 2 2012
Device Type: B - CM Bridge, R - CM Router
IP Assignment Method: D - DHCP
MAC Address Type IPv6 prefix
0023.bed9.4c91 R/D 2001:40:1012::/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 Cisco CMTS router:
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 Cisco CMTS router:
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
Starting with Cisco IOS Release12.2(33)SCG1, the following example shows sample output for the show cable modem mac-address ipv6 cpe command for registered CMs on the Cisco CMTS router:
Router# show cable modem 0023.bed9.4c8e ipv6 cpe
Load for five secs: 0%/0%; one minute: 1%; five minutes: 1%
Time source is hardware calendar, *06:37:20.439 UTC Thu Aug 2 2012
0023.bed9.4c91 2001:40:3:4:200:5EB7:BB6:C759
2001:40:3:4:210:D73B:7A50:2D05
Table 100 describes the significant fields shown in the display.
Table 100 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 101 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.
Starting from Cisco IOS Release 12.2(33)SCG1, D/IP field is not supported.
|
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 101 shows the possible values for the MAC state field:
Table 101 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.
|
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 | slot/cable-interface-index}
[upstream port [logical-channel-index]] | name fqdn] mac[summary [total]]
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]
mac[summary [total]]
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.
|
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.
|
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.
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
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
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 a sample output for the show cable modem mac command for a CM, as identified by its MAC address:
Router# show cable modem xxxx.xxxx.xxxx mac
MAC Address IP Address I/F MAC Prim RxPwr Timing Num I
State Sid (dBmv) Offset CPE P
xxxx.xxxx.xxxx x.x.x.x C6/0/2/U0 *online 3087 0.50 1037 0 N
Note
The * in front of the MAC state indicates that the CM did not satisfy the bpi-plus-policy and the data traffic is blocked. The cable privacy bpi-plus-policy command enforces this requirement.
Note
The ! in front of the MAC state indicates that the CM has attempted to register with a modified cm configuration file. This is possibly a non-compliant CM trying to modify the service it is receiving.
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 102 describes the fields shown in the default forms of the show cable modem mac displays:
Table 102 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 101).
|
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 and DOCSIS 1.1).
|
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 101 shows the possible values for the MAC state field:
Table 103 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 104 describes the fields shown in the show cable modem mac summary displays:
Table 104 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 105 describes the fields shown in the show cable modem maintenance displays:
Table 105 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 106 describes the major fields shown in the show cable modem offline displays:
Table 106 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 101).
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 101 shows the possible values for the Previous State field:
Table 107 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 108 describes the significant fields shown in the display.
Table 108 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 partial-service
To display the impaired state of the cable modems on the Cisco CMTS router, use the show cable modem partial-service command in privileged EXEC mode.
show cable modem partial-service
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(33)SCG
|
This command was introduced.
|
Examples
The following is a sample output of the show cable modem partial-service command:
Router# show cable modem partial-service
MAC Address IP Address I/F MAC DSxUS Impaired Impaired
State State DS US
54d4.6ffb.2f6b 40.4.58.16 C7/0/0/p w-online(pt) 3x3 1
54d4.6ffb.30fd 40.4.58.14 C7/0/0/p w-online(pt) 3x3 1
4458.2945.2ade 40.4.58.18 C7/0/0/p w-online(pt) 3x3 1
001e.6bfc.d1ea 40.4.58.26 C7/0/0/p w-online 3x3 1
54d4.6ffb.2e21 40.4.58.5 C7/0/0/p w-online(pt) 3x3 1
54d4.6ffb.2e1b 40.4.58.23 C7/0/0/p w-online(pt) 3x3 1
4458.2945.2a78 40.4.58.21 C7/0/0/p w-online(pt) 3x3 1
4458.2945.4604 40.4.58.19 C7/0/0/p w-online(pt) 3x3 1
54d4.6ffb.2e66 --- C8/0/0/p w-online(pt) 3x3 1
Table 83 describes the significant fields shown in the display:
Table 109 show cable modem partial-service Field Descriptions
Field
|
Description
|
MAC Address
|
MAC address of the cable modem.
|
IP Address
|
IP address of the cable modem.
|
I/F
|
Interface on the cable modem.
|
MAC State
|
State of the cable modem.
|
DSxUS State
|
State of the downstream and upstream channels on the cable modem.
|
Impaired DS
|
Name of the impaired downstream RF channel.
|
Impaired US
|
Port number of the impaired upstream RF channel.
|
Related Commands
Command
|
Description
|
show cable modem
|
Displays information for the registered and unregistered cable modems.
|
show interface cable modem
|
Displays information about the cable modems connected to a particular cable interface.
|
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 110 describes the fields shown in the show cable modem phy displays:
Table 110 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 111 describes the major fields shown in the show cable modem privacy command display:
Table 111 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.
|
12.2(33)SCG
|
The command output was modified to display the scheduling type as "N/A" for all downstream service flows.
|
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.
Note
Starting with Cisco IOS Release 12.2(33)SCG, the output of the show cable modem qos command displays the scheduling type of all downstream service flows (DS-SF) as "N/A" to indicate that the DS-SFs do not have any scheduling type.
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 112 describes the major fields shown in the show cable modem qos displays:
Table 112 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
• N/A—Scheduling type is not applicable to a service flow.
• 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 co